feature #463 [Store] Add VectorizerInterface for better abstraction and testability (OskarStark)

This PR was merged into the main branch.

Discussion
----------

[Store] Add `VectorizerInterface` for better abstraction and testability

| Q             | A
| ------------- | ---
| Bug fix?      | no
| New feature?  | yes
| Docs?         | no
| Issues        | --
| License       | MIT

Commits
-------

cc82b0c Add VectorizerInterface and implement in existing Vectorizer

Author: OskarStark

src/store/src/Document/Vectorizer.php

@@ -19,7 +19,7 @@
  * The Vectorizer encapsulates the logic to convert a collection of TextDocuments into VectorDocuments. It checks for
  * the model's capabilities to handle batch processing or handles it with HttpClient's concurrency feature.
  */
-final readonly class Vectorizer
+final readonly class Vectorizer implements VectorizerInterface
 {
     public function __construct(
         private PlatformInterface $platform,

src/store/src/Document/VectorizerInterface.php

@@ -0,0 +1,27 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\AI\Store\Document;
+
+/**
+ * Interface for converting TextDocuments into VectorDocuments.
+ *
+ * @author Oskar Stark <[email protected]>
+ */
+interface VectorizerInterface
+{
+    /**
+     * @param TextDocument[] $documents
+     *
+     * @return VectorDocument[]
+     */
+    public function vectorizeDocuments(array $documents): array;
+}

src/store/src/Indexer.php

@@ -14,7 +14,7 @@
 use Psr\Log\LoggerInterface;
 use Psr\Log\NullLogger;
 use Symfony\AI\Store\Document\TextDocument;
-use Symfony\AI\Store\Document\Vectorizer;
+use Symfony\AI\Store\Document\VectorizerInterface;
 
 /**
  * Converts a collection of TextDocuments into VectorDocuments and pushes them to a store implementation.
@@ -24,7 +24,7 @@
 final readonly class Indexer
 {
     public function __construct(
-        private Vectorizer $vectorizer,
+        private VectorizerInterface $vectorizer,
         private StoreInterface $store,
         private LoggerInterface $logger = new NullLogger(),
     ) {