@orion-js/vectors 4.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Orionjs Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,120 @@
+# @orion-js/vectors
+
+The `@orion-js/vectors` module provides a provider-agnostic interface for vector storage and similarity search, with built-in support for local file-system storage and AWS S3 Vectors.
+
+## Features
+
+- **Provider-agnostic Interface**: `VectorStorageProvider` defines a standard interface for all vector storage operations.
+- **Local Provider**: A file-system-based `LocalVectorProvider` for development, testing, and small-scale deployments.
+- **AWS S3 Provider**: An `S3VectorProvider` that integrates with AWS S3 Vectors, a new feature for storing and querying vector embeddings in S3.
+- **Type Safety**: Full TypeScript support with comprehensive type definitions for vector stores, indexes, and operations.
+- **Core Functionality**:
+    - `defineVectorStore`: Idempotently create stores (buckets) and indexes.
+    - `insertVectors`, `queryVectors`, `deleteVectors`: Full CRUD and search capabilities.
+    - `cosine` and `euclidean` distance metrics.
+    - Metadata filtering in queries.
+
+## Installation
+
+```bash
+pnpm add @orion-js/vectors
+pnpm add @aws-sdk/client-s3vectors # If using S3VectorProvider
+```
+
+## Usage
+
+### 1. Define a Vector Store
+
+First, define your vector store configuration. This is where your vectors will be stored.
+
+```typescript
+import { VectorStoreConfig } from '@orion-js/vectors'
+
+const storeConfig: VectorStoreConfig = {
+  storeName: 'media-embeddings',
+  indexes: [
+    {
+      name: 'movies',
+      dimension: 1024, // Dimension of your vectors
+      distanceMetric: 'cosine', // 'cosine' or 'euclidean'
+      nonFilterableMetadataKeys: ['source_text'] // Optional
+    }
+  ]
+}
+```
+
+### 2. Choose a Provider
+
+#### LocalVectorProvider (for development/testing)
+
+This provider stores data on the local file system, which is great for getting started without needing cloud resources.
+
+```typescript
+import { LocalVectorProvider } from '@orion-js/vectors'
+
+const provider = new LocalVectorProvider({ basePath: './vector-data' })
+
+// This will create the necessary directories and files
+await provider.defineVectorStore(storeConfig)
+```
+
+#### S3VectorProvider (for production)
+
+This provider uses AWS S3 Vectors.
+
+> **Note**: S3 Vectors is currently in preview.
+
+```typescript
+import { S3VectorProvider } from '@orion-js/vectors'
+
+const provider = new S3VectorProvider({
+  region: 'us-east-1',
+  // Credentials can be omitted if using IAM roles
+})
+
+// This will create an S3 Vector Bucket and Index
+await provider.defineVectorStore(storeConfig)
+```
+
+### 3. Perform Vector Operations
+
+The API is the same for all providers.
+
+```typescript
+// Insert vectors
+await provider.insertVectors('media-embeddings', 'movies', [
+  {
+    key: 'Star Wars',
+    data: { float32: embedding1 },
+    metadata: { genre: 'scifi', source_text: 'A long time ago...' }
+  },
+  {
+    key: 'Jurassic Park',
+    data: { float32: embedding2 },
+    metadata: { genre: 'scifi', source_text: 'An adventure 65 million years in the making.' }
+  }
+])
+
+// Query for similar vectors
+const results = await provider.queryVectors('media-embeddings', 'movies', {
+  queryVector: { float32: queryEmbedding },
+  topK: 3,
+  filter: { genre: 'scifi' }, // Filter by metadata
+  returnDistance: true,
+  returnMetadata: true
+})
+
+console.log(results)
+```
+
+## Testing
+
+The package includes a comprehensive test suite. The `LocalVectorProvider` is fully tested.
+
+To run the tests:
+
+```bash
+pnpm --filter @orion-js/vectors test
+```
+
+To run integration tests for `S3VectorProvider`, you need to have AWS credentials configured in your environment. 

package/dist/index.cjs

@@ -0,0 +1,259 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  S3VectorProvider: () => S3VectorProvider
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/providers/S3VectorProvider.ts
+var import_client_s3vectors2 = require("@aws-sdk/client-s3vectors");
+
+// src/providers/S3VectorStore.ts
+var import_client_s3vectors = require("@aws-sdk/client-s3vectors");
+var S3VectorStore = class {
+  config;
+  client;
+  constructor(client, config) {
+    this.client = client;
+    this.config = config;
+  }
+  async wrapOperationWithIndexCreation(namespace, operation) {
+    try {
+      return await operation();
+    } catch (error) {
+      if (error instanceof import_client_s3vectors.NotFoundException) {
+        if (error.message === "The specified index could not be found") {
+          await this.createVectorIndex(namespace, this.config, this.config.index);
+          return this.wrapOperationWithIndexCreation(namespace, operation);
+        }
+      }
+      throw error;
+    }
+  }
+  async insertVectors(namespace, vectors) {
+    return await this.wrapOperationWithIndexCreation(namespace, async () => {
+      const result = await this.client.send(
+        new import_client_s3vectors.PutVectorsCommand({
+          vectorBucketName: this.config.storeName,
+          indexName: namespace,
+          vectors: vectors.map((vector) => ({
+            key: vector.key,
+            data: {
+              float32: vector.vector
+            },
+            metadata: vector.metadata
+          }))
+        })
+      );
+      return result;
+    });
+  }
+  async queryVectors(namespace, options) {
+    return await this.wrapOperationWithIndexCreation(namespace, async () => {
+      var _a;
+      const result = await this.client.send(
+        new import_client_s3vectors.QueryVectorsCommand({
+          ...options,
+          vectorBucketName: this.config.storeName,
+          indexName: namespace,
+          queryVector: {
+            float32: options.queryVector
+          }
+        })
+      );
+      const vectors = ((_a = result.vectors) == null ? void 0 : _a.map(
+        (vector) => {
+          var _a2;
+          return {
+            key: vector.key,
+            vector: (_a2 = vector.data) == null ? void 0 : _a2.float32,
+            metadata: vector.metadata
+          };
+        }
+      )) ?? [];
+      return {
+        vectors
+      };
+    });
+  }
+  async deleteVectors(namespace, keys) {
+    return await this.client.send(
+      new import_client_s3vectors.DeleteVectorsCommand({
+        vectorBucketName: this.config.storeName,
+        indexName: namespace,
+        keys
+      })
+    );
+  }
+  async listVectors(namespace, options) {
+    return await this.wrapOperationWithIndexCreation(namespace, async () => {
+      var _a;
+      const result = await this.client.send(
+        new import_client_s3vectors.ListVectorsCommand({
+          vectorBucketName: this.config.storeName,
+          indexName: namespace,
+          ...options
+        })
+      );
+      return ((_a = result.vectors) == null ? void 0 : _a.map((vector) => {
+        var _a2;
+        return {
+          key: vector.key,
+          vector: (_a2 = vector.data) == null ? void 0 : _a2.float32,
+          metadata: vector.metadata
+        };
+      })) ?? [];
+    });
+  }
+  async listVectorKeys(namespace, options) {
+    const result = await this.listVectors(namespace, {
+      ...options,
+      returnData: false,
+      returnMetadata: false
+    });
+    return result.map((vector) => vector.key);
+  }
+  /**
+   * Create a new vector index
+   */
+  async createVectorIndex(namespace, config, indexConfig) {
+    await this.client.send(
+      new import_client_s3vectors.CreateIndexCommand({
+        indexName: namespace,
+        dataType: "float32",
+        dimension: indexConfig.dimension,
+        distanceMetric: indexConfig.distanceMetric,
+        vectorBucketName: config.storeName,
+        metadataConfiguration: indexConfig.metadataConfiguration
+      })
+    );
+  }
+  async deleteNamespace(namespace) {
+    return await this.client.send(
+      new import_client_s3vectors.DeleteIndexCommand({
+        vectorBucketName: this.config.storeName,
+        indexName: namespace
+      })
+    );
+  }
+};
+
+// src/providers/S3VectorProvider.ts
+var S3VectorProvider = class {
+  config;
+  client;
+  constructor(config) {
+    this.config = config;
+    this.validateConfig();
+    this.client = new import_client_s3vectors2.S3VectorsClient(this.config.s3Options);
+  }
+  /**
+   * Validate the provider configuration
+   */
+  validateConfig() {
+    if (!this.config.s3Options) {
+      throw new Error("S3Options are required for S3VectorProvider");
+    }
+  }
+  createVectorStore(config) {
+    this.validateVectorStoreConfig(config);
+    this.setupVectorStore(config);
+    return new S3VectorStore(this.client, config);
+  }
+  async setupVectorStore(config) {
+    await this.ensureVectorBucketExists(config);
+  }
+  async storeExists(storeName) {
+    try {
+      await this.client.send(
+        new import_client_s3vectors2.GetVectorBucketCommand({
+          vectorBucketName: storeName
+        })
+      );
+      return true;
+    } catch (error) {
+      if (this.isNotFoundError(error)) {
+        return false;
+      }
+      throw error;
+    }
+  }
+  /**
+   * Ensure a vector bucket exists, create if it doesn't
+   */
+  async ensureVectorBucketExists(config) {
+    const exists = await this.storeExists(config.storeName);
+    if (!exists) {
+      await this.createVectorBucket(config);
+    }
+  }
+  /**
+   * Create a new vector bucket
+   */
+  async createVectorBucket(config) {
+    await this.client.send(
+      new import_client_s3vectors2.CreateVectorBucketCommand({
+        vectorBucketName: config.storeName,
+        encryptionConfiguration: config.encryptionConfiguration
+      })
+    );
+  }
+  /**
+   * Validate vector store configuration
+   */
+  validateVectorStoreConfig(config) {
+    if (!config.storeName || config.storeName.length < 3 || config.storeName.length > 63) {
+      throw new Error("Store name must be between 3 and 63 characters");
+    }
+    if (!/^[a-z0-9-]+$/.test(config.storeName)) {
+      throw new Error("Store name must contain only lowercase letters, numbers, and hyphens");
+    }
+    if (!config.index) {
+      throw new Error("Index must be specified");
+    }
+    this.validateIndexConfig(config.index);
+  }
+  /**
+   * Validate vector index configuration
+   */
+  validateIndexConfig(indexConfig) {
+    if (indexConfig.dimension < 1 || indexConfig.dimension > 4096) {
+      throw new Error("Vector dimension must be between 1 and 4096");
+    }
+    if (!["cosine", "euclidean"].includes(indexConfig.distanceMetric)) {
+      throw new Error('Distance metric must be either "cosine" or "euclidean"');
+    }
+  }
+  /**
+   * Check if an error indicates a resource was not found
+   */
+  isNotFoundError(error) {
+    if (error instanceof import_client_s3vectors2.NotFoundException) {
+      return true;
+    }
+    return false;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  S3VectorProvider
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/providers/S3VectorProvider.ts","../src/providers/S3VectorStore.ts"],"sourcesContent":["/**\n * @orion-js/vectors\n *\n * A package for working with vector operations.\n * Provides interfaces and implementations for vector storage providers.\n */\n\n// Core types and interfaces\nexport type {\n  DistanceMetric,\n  VectorDataType,\n  VectorIndexConfig,\n  VectorStoreConfig,\n  VectorData,\n  VectorQueryParams,\n  VectorQueryResult,\n} from './types'\n\n// VectorStore interface and related types\nexport type {VectorStore} from './VectorStore'\n\n// Provider interfaces\nexport type {\n  VectorStorageProvider,\n  VectorStorageProviderConfig,\n} from './VectorStorageProvider'\n\n// AWS S3 provider\nexport type {S3VectorProviderConfig} from './providers/S3VectorProvider'\nexport {S3VectorProvider} from './providers/S3VectorProvider'\n","import type {VectorStorageProvider, VectorStorageProviderConfig} from '../VectorStorageProvider'\nimport type {VectorStoreConfig, VectorIndexConfig} from '../types'\nimport {\n  CreateVectorBucketCommand,\n  GetVectorBucketCommand,\n  NotFoundException,\n  S3VectorsClient,\n  S3VectorsClientConfig,\n} from '@aws-sdk/client-s3vectors'\nimport {S3VectorStore} from './S3VectorStore'\n\n/**\n * Configuration for AWS S3 Vector provider\n */\nexport interface S3VectorProviderConfig extends VectorStorageProviderConfig {\n  s3Options: S3VectorsClientConfig\n}\n\n/**\n * AWS S3 Vector storage provider implementation\n *\n * This provider implements vector storage using AWS S3's native vector capabilities.\n * It manages vector buckets and indexes according to the S3 Vector API.\n */\nexport class S3VectorProvider implements VectorStorageProvider {\n  private config: S3VectorProviderConfig\n  private client: S3VectorsClient\n\n  constructor(config: S3VectorProviderConfig) {\n    this.config = config\n    this.validateConfig()\n    this.client = new S3VectorsClient(this.config.s3Options)\n  }\n\n  /**\n   * Validate the provider configuration\n   */\n  private validateConfig(): void {\n    if (!this.config.s3Options) {\n      throw new Error('S3Options are required for S3VectorProvider')\n    }\n  }\n\n  createVectorStore(config: VectorStoreConfig) {\n    this.validateVectorStoreConfig(config)\n\n    this.setupVectorStore(config)\n\n    // Return a VectorStore instance\n    return new S3VectorStore(this.client, config)\n  }\n\n  private async setupVectorStore(config: VectorStoreConfig): Promise<void> {\n    // Ensure the vector bucket exists\n    await this.ensureVectorBucketExists(config)\n  }\n\n  private async storeExists(storeName: string): Promise<boolean> {\n    try {\n      await this.client.send(\n        new GetVectorBucketCommand({\n          vectorBucketName: storeName,\n        }),\n      )\n\n      return true\n    } catch (error) {\n      if (this.isNotFoundError(error)) {\n        return false\n      }\n      throw error\n    }\n  }\n\n  /**\n   * Ensure a vector bucket exists, create if it doesn't\n   */\n  private async ensureVectorBucketExists(config: VectorStoreConfig): Promise<void> {\n    const exists = await this.storeExists(config.storeName)\n    if (!exists) {\n      await this.createVectorBucket(config)\n    }\n  }\n\n  /**\n   * Create a new vector bucket\n   */\n  private async createVectorBucket(config: VectorStoreConfig): Promise<void> {\n    await this.client.send(\n      new CreateVectorBucketCommand({\n        vectorBucketName: config.storeName,\n        encryptionConfiguration: config.encryptionConfiguration,\n      }),\n    )\n  }\n\n  /**\n   * Validate vector store configuration\n   */\n  private validateVectorStoreConfig(config: VectorStoreConfig): void {\n    if (!config.storeName || config.storeName.length < 3 || config.storeName.length > 63) {\n      throw new Error('Store name must be between 3 and 63 characters')\n    }\n\n    if (!/^[a-z0-9-]+$/.test(config.storeName)) {\n      throw new Error('Store name must contain only lowercase letters, numbers, and hyphens')\n    }\n\n    if (!config.index) {\n      throw new Error('Index must be specified')\n    }\n\n    this.validateIndexConfig(config.index)\n  }\n\n  /**\n   * Validate vector index configuration\n   */\n  private validateIndexConfig(indexConfig: VectorIndexConfig): void {\n    if (indexConfig.dimension < 1 || indexConfig.dimension > 4096) {\n      throw new Error('Vector dimension must be between 1 and 4096')\n    }\n\n    if (!['cosine', 'euclidean'].includes(indexConfig.distanceMetric)) {\n      throw new Error('Distance metric must be either \"cosine\" or \"euclidean\"')\n    }\n  }\n\n  /**\n   * Check if an error indicates a resource was not found\n   */\n  private isNotFoundError(error: unknown): boolean {\n    if (error instanceof NotFoundException) {\n      return true\n    }\n    return false\n  }\n}\n","import {\n  CreateIndexCommand,\n  DeleteIndexCommand,\n  DeleteVectorsCommand,\n  ListVectorsCommand,\n  ListVectorsCommandInput,\n  NotFoundException,\n  PutVectorsCommand,\n  QueryVectorsCommand,\n  QueryVectorsCommandInput,\n  S3VectorsClient,\n} from '@aws-sdk/client-s3vectors'\nimport {VectorData, VectorIndexConfig, VectorStoreConfig} from '../types'\nimport {VectorStore} from '../VectorStore'\n\n/**\n * S3 Vector Store implementation that provides CRUD operations for a specific vector store\n */\nexport class S3VectorStore<TVectorData extends VectorData = VectorData>\n  implements VectorStore<TVectorData>\n{\n  private config: VectorStoreConfig\n  private client: S3VectorsClient\n\n  constructor(client: S3VectorsClient, config: VectorStoreConfig) {\n    this.client = client\n    this.config = config\n  }\n\n  private async wrapOperationWithIndexCreation<TOperation extends () => Promise<any>>(\n    namespace: string,\n    operation: TOperation,\n  ): Promise<Awaited<ReturnType<TOperation>>> {\n    try {\n      return await operation()\n    } catch (error) {\n      if (error instanceof NotFoundException) {\n        if (error.message === 'The specified index could not be found') {\n          await this.createVectorIndex(namespace, this.config, this.config.index)\n          return this.wrapOperationWithIndexCreation(namespace, operation)\n        }\n      }\n      throw error\n    }\n  }\n\n  async insertVectors(namespace: string, vectors: TVectorData[]) {\n    return await this.wrapOperationWithIndexCreation(namespace, async () => {\n      const result = await this.client.send(\n        new PutVectorsCommand({\n          vectorBucketName: this.config.storeName,\n          indexName: namespace,\n          vectors: vectors.map(vector => ({\n            key: vector.key,\n            data: {\n              float32: vector.vector,\n            },\n            metadata: vector.metadata,\n          })),\n        }),\n      )\n\n      return result\n    })\n  }\n\n  async queryVectors(\n    namespace: string,\n    options?: Omit<QueryVectorsCommandInput, 'vectorBucketName' | 'indexName' | 'queryVector'> & {\n      queryVector: number[]\n    },\n  ) {\n    return await this.wrapOperationWithIndexCreation(namespace, async () => {\n      const result = await this.client.send(\n        new QueryVectorsCommand({\n          ...options,\n          vectorBucketName: this.config.storeName,\n          indexName: namespace,\n          queryVector: {\n            float32: options.queryVector,\n          },\n        }),\n      )\n\n      const vectors: TVectorData[] =\n        result.vectors?.map(\n          vector =>\n            ({\n              key: vector.key,\n              vector: vector.data?.float32,\n              metadata: vector.metadata,\n            }) as TVectorData,\n        ) ?? []\n\n      return {\n        vectors,\n      }\n    })\n  }\n\n  async deleteVectors(namespace: string, keys: string[]) {\n    return await this.client.send(\n      new DeleteVectorsCommand({\n        vectorBucketName: this.config.storeName,\n        indexName: namespace,\n        keys,\n      }),\n    )\n  }\n\n  async listVectors(\n    namespace: string,\n    options?: Omit<ListVectorsCommandInput, 'vectorBucketName' | 'indexName'>,\n  ) {\n    return await this.wrapOperationWithIndexCreation(namespace, async () => {\n      const result = await this.client.send(\n        new ListVectorsCommand({\n          vectorBucketName: this.config.storeName,\n          indexName: namespace,\n          ...options,\n        }),\n      )\n\n      return (result.vectors?.map(vector => ({\n        key: vector.key,\n        vector: vector.data?.float32,\n        metadata: vector.metadata as TVectorData['metadata'],\n      })) ?? []) as Partial<TVectorData>[]\n    })\n  }\n\n  async listVectorKeys(\n    namespace: string,\n    options?: Omit<\n      ListVectorsCommandInput,\n      'vectorBucketName' | 'indexName' | 'returnData' | 'returnMetadata'\n    >,\n  ) {\n    const result = await this.listVectors(namespace, {\n      ...options,\n      returnData: false,\n      returnMetadata: false,\n    })\n    return result.map(vector => vector.key)\n  }\n\n  /**\n   * Create a new vector index\n   */\n  private async createVectorIndex(\n    namespace: string,\n    config: VectorStoreConfig,\n    indexConfig: VectorIndexConfig,\n  ): Promise<void> {\n    await this.client.send(\n      new CreateIndexCommand({\n        indexName: namespace,\n        dataType: 'float32',\n        dimension: indexConfig.dimension,\n        distanceMetric: indexConfig.distanceMetric,\n        vectorBucketName: config.storeName,\n        metadataConfiguration: indexConfig.metadataConfiguration,\n      }),\n    )\n  }\n\n  async deleteNamespace(namespace: string) {\n    return await this.client.send(\n      new DeleteIndexCommand({\n        vectorBucketName: this.config.storeName,\n        indexName: namespace,\n      }),\n    )\n  }\n}\n"],"mappings":"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","names":["import_client_s3vectors","_a"]}

package/dist/index.d.cts

@@ -0,0 +1,205 @@
+import * as _aws_sdk_client_s3vectors from '@aws-sdk/client-s3vectors';
+import { MetadataConfiguration, EncryptionConfiguration, S3VectorsClient, QueryVectorsCommandInput, ListVectorsCommandInput, S3VectorsClientConfig } from '@aws-sdk/client-s3vectors';
+
+/**
+ * Distance metrics for vector similarity calculations
+ */
+type DistanceMetric = 'cosine' | 'euclidean';
+/**
+ * Vector data types supported
+ */
+type VectorDataType = 'float32';
+/**
+ * Configuration for a vector index
+ */
+interface VectorIndexConfig {
+    /**
+     * Number of dimensions in each vector (1-4096)
+     */
+    dimension: number;
+    /**
+     * Distance metric for similarity calculations
+     */
+    distanceMetric: DistanceMetric;
+    /**
+     * Metadata configuration for the index
+     */
+    metadataConfiguration?: MetadataConfiguration;
+}
+/**
+ * Configuration for defining a vector store
+ */
+interface VectorStoreConfig {
+    /**
+     * Name of the vector store/bucket (3-63 characters, lowercase letters, numbers, hyphens)
+     */
+    storeName: string;
+    /**
+     * Array of vector indexes to create in this store
+     */
+    index: VectorIndexConfig;
+    /**
+     * Optional encryption configuration
+     */
+    encryptionConfiguration?: EncryptionConfiguration;
+}
+/**
+ * Vector data for insertion
+ */
+interface VectorData<TMetadata extends Record<string, string | number | boolean> = Record<string, string | number | boolean>> {
+    /** Unique identifier for the vector */
+    key: string;
+    /**
+     * The vector data of the vector.
+     * Vector dimensions must match the dimension count that's configured for the vector index.
+     * For the cosine distance metric, zero vectors (vectors containing all zeros) aren't allowed.
+     * For both cosine and euclidean distance metrics, vector data must contain only valid floating-point values. Invalid values such as NaN (Not a Number) or Infinity aren't allowed.
+     */
+    vector: number[];
+    /** Filterable metadata attached to the vector */
+    metadata?: TMetadata;
+}
+/**
+ * Query parameters for vector similarity search
+ */
+interface VectorQueryParams {
+    /** The query vector to search for similar vectors */
+    queryVector: {
+        [K in VectorDataType]: number[];
+    };
+    /** Number of top similar vectors to return */
+    topK: number;
+    /** Optional metadata filters to narrow search results */
+    filter?: Record<string, string | number | boolean>;
+    /** Whether to return distance scores */
+    returnDistance?: boolean;
+    /** Whether to return metadata */
+    returnMetadata?: boolean;
+}
+/**
+ * Result from a vector query
+ */
+interface VectorQueryResult {
+    /** The vector key */
+    key: string;
+    /** Distance score (if requested) */
+    distance?: number;
+    /** Vector metadata (if requested) */
+    metadata?: Record<string, string | number | boolean>;
+}
+
+/**
+ * Interface for vector store operations providing CRUD functionality
+ *
+ * This interface defines the contract for vector storage implementations,
+ * providing methods for creating, reading, updating, and deleting vectors
+ * within a vector store.
+ */
+interface VectorStore<TVectorData extends VectorData = VectorData> {
+    insertVectors(namespace: string, vectors: TVectorData[], options?: any): Promise<any>;
+    deleteVectors(namespace: string, keys: string[], options?: any): Promise<any>;
+    listVectors(namespace: string, options?: any): Promise<Partial<TVectorData>[]>;
+    listVectorKeys(namespace: string, options?: any): Promise<string[]>;
+    deleteNamespace(namespace: string): Promise<any>;
+    queryVectors(namespace: string, options?: any): Promise<{
+        vectors: TVectorData[];
+    } & Record<string, any>>;
+}
+
+/**
+ * Abstract interface for vector storage providers
+ *
+ * This interface defines the contract that all vector storage implementations must follow.
+ * It provides methods for managing vector stores, indexes, and performing vector operations.
+ */
+interface VectorStorageProvider {
+    /**
+     * Create and ensure a vector store exists with the specified configuration.
+     * This method will:
+     * 1. Create the vector store/bucket if it doesn't exist
+     * 2. Create all specified indexes if they don't exist
+     * 3. Validate the configuration
+     *
+     * @param config - Configuration for the vector store and its indexes
+     * @returns Promise that resolves to a VectorStore instance when setup is complete
+     */
+    createVectorStore(config: VectorStoreConfig): VectorStore;
+}
+/**
+ * Base configuration for vector storage providers
+ */
+interface VectorStorageProviderConfig {
+    /** Provider-specific configuration */
+    [key: string]: unknown;
+}
+
+/**
+ * S3 Vector Store implementation that provides CRUD operations for a specific vector store
+ */
+declare class S3VectorStore<TVectorData extends VectorData = VectorData> implements VectorStore<TVectorData> {
+    private config;
+    private client;
+    constructor(client: S3VectorsClient, config: VectorStoreConfig);
+    private wrapOperationWithIndexCreation;
+    insertVectors(namespace: string, vectors: TVectorData[]): Promise<_aws_sdk_client_s3vectors.PutVectorsCommandOutput>;
+    queryVectors(namespace: string, options?: Omit<QueryVectorsCommandInput, 'vectorBucketName' | 'indexName' | 'queryVector'> & {
+        queryVector: number[];
+    }): Promise<{
+        vectors: TVectorData[];
+    }>;
+    deleteVectors(namespace: string, keys: string[]): Promise<_aws_sdk_client_s3vectors.DeleteVectorsCommandOutput>;
+    listVectors(namespace: string, options?: Omit<ListVectorsCommandInput, 'vectorBucketName' | 'indexName'>): Promise<Partial<TVectorData>[]>;
+    listVectorKeys(namespace: string, options?: Omit<ListVectorsCommandInput, 'vectorBucketName' | 'indexName' | 'returnData' | 'returnMetadata'>): Promise<TVectorData["key"][]>;
+    /**
+     * Create a new vector index
+     */
+    private createVectorIndex;
+    deleteNamespace(namespace: string): Promise<_aws_sdk_client_s3vectors.DeleteIndexCommandOutput>;
+}
+
+/**
+ * Configuration for AWS S3 Vector provider
+ */
+interface S3VectorProviderConfig extends VectorStorageProviderConfig {
+    s3Options: S3VectorsClientConfig;
+}
+/**
+ * AWS S3 Vector storage provider implementation
+ *
+ * This provider implements vector storage using AWS S3's native vector capabilities.
+ * It manages vector buckets and indexes according to the S3 Vector API.
+ */
+declare class S3VectorProvider implements VectorStorageProvider {
+    private config;
+    private client;
+    constructor(config: S3VectorProviderConfig);
+    /**
+     * Validate the provider configuration
+     */
+    private validateConfig;
+    createVectorStore(config: VectorStoreConfig): S3VectorStore<VectorData<Record<string, string | number | boolean>>>;
+    private setupVectorStore;
+    private storeExists;
+    /**
+     * Ensure a vector bucket exists, create if it doesn't
+     */
+    private ensureVectorBucketExists;
+    /**
+     * Create a new vector bucket
+     */
+    private createVectorBucket;
+    /**
+     * Validate vector store configuration
+     */
+    private validateVectorStoreConfig;
+    /**
+     * Validate vector index configuration
+     */
+    private validateIndexConfig;
+    /**
+     * Check if an error indicates a resource was not found
+     */
+    private isNotFoundError;
+}
+
+export { type DistanceMetric, S3VectorProvider, type S3VectorProviderConfig, type VectorData, type VectorDataType, type VectorIndexConfig, type VectorQueryParams, type VectorQueryResult, type VectorStorageProvider, type VectorStorageProviderConfig, type VectorStore, type VectorStoreConfig };

package/dist/index.d.ts

@@ -0,0 +1,205 @@
+import * as _aws_sdk_client_s3vectors from '@aws-sdk/client-s3vectors';
+import { MetadataConfiguration, EncryptionConfiguration, S3VectorsClient, QueryVectorsCommandInput, ListVectorsCommandInput, S3VectorsClientConfig } from '@aws-sdk/client-s3vectors';
+
+/**
+ * Distance metrics for vector similarity calculations
+ */
+type DistanceMetric = 'cosine' | 'euclidean';
+/**
+ * Vector data types supported
+ */
+type VectorDataType = 'float32';
+/**
+ * Configuration for a vector index
+ */
+interface VectorIndexConfig {
+    /**
+     * Number of dimensions in each vector (1-4096)
+     */
+    dimension: number;
+    /**
+     * Distance metric for similarity calculations
+     */
+    distanceMetric: DistanceMetric;
+    /**
+     * Metadata configuration for the index
+     */
+    metadataConfiguration?: MetadataConfiguration;
+}
+/**
+ * Configuration for defining a vector store
+ */
+interface VectorStoreConfig {
+    /**
+     * Name of the vector store/bucket (3-63 characters, lowercase letters, numbers, hyphens)
+     */
+    storeName: string;
+    /**
+     * Array of vector indexes to create in this store
+     */
+    index: VectorIndexConfig;
+    /**
+     * Optional encryption configuration
+     */
+    encryptionConfiguration?: EncryptionConfiguration;
+}
+/**
+ * Vector data for insertion
+ */
+interface VectorData<TMetadata extends Record<string, string | number | boolean> = Record<string, string | number | boolean>> {
+    /** Unique identifier for the vector */
+    key: string;
+    /**
+     * The vector data of the vector.
+     * Vector dimensions must match the dimension count that's configured for the vector index.
+     * For the cosine distance metric, zero vectors (vectors containing all zeros) aren't allowed.
+     * For both cosine and euclidean distance metrics, vector data must contain only valid floating-point values. Invalid values such as NaN (Not a Number) or Infinity aren't allowed.
+     */
+    vector: number[];
+    /** Filterable metadata attached to the vector */
+    metadata?: TMetadata;
+}
+/**
+ * Query parameters for vector similarity search
+ */
+interface VectorQueryParams {
+    /** The query vector to search for similar vectors */
+    queryVector: {
+        [K in VectorDataType]: number[];
+    };
+    /** Number of top similar vectors to return */
+    topK: number;
+    /** Optional metadata filters to narrow search results */
+    filter?: Record<string, string | number | boolean>;
+    /** Whether to return distance scores */
+    returnDistance?: boolean;
+    /** Whether to return metadata */
+    returnMetadata?: boolean;
+}
+/**
+ * Result from a vector query
+ */
+interface VectorQueryResult {
+    /** The vector key */
+    key: string;
+    /** Distance score (if requested) */
+    distance?: number;
+    /** Vector metadata (if requested) */
+    metadata?: Record<string, string | number | boolean>;
+}
+
+/**
+ * Interface for vector store operations providing CRUD functionality
+ *
+ * This interface defines the contract for vector storage implementations,
+ * providing methods for creating, reading, updating, and deleting vectors
+ * within a vector store.
+ */
+interface VectorStore<TVectorData extends VectorData = VectorData> {
+    insertVectors(namespace: string, vectors: TVectorData[], options?: any): Promise<any>;
+    deleteVectors(namespace: string, keys: string[], options?: any): Promise<any>;
+    listVectors(namespace: string, options?: any): Promise<Partial<TVectorData>[]>;
+    listVectorKeys(namespace: string, options?: any): Promise<string[]>;
+    deleteNamespace(namespace: string): Promise<any>;
+    queryVectors(namespace: string, options?: any): Promise<{
+        vectors: TVectorData[];
+    } & Record<string, any>>;
+}
+
+/**
+ * Abstract interface for vector storage providers
+ *
+ * This interface defines the contract that all vector storage implementations must follow.
+ * It provides methods for managing vector stores, indexes, and performing vector operations.
+ */
+interface VectorStorageProvider {
+    /**
+     * Create and ensure a vector store exists with the specified configuration.
+     * This method will:
+     * 1. Create the vector store/bucket if it doesn't exist
+     * 2. Create all specified indexes if they don't exist
+     * 3. Validate the configuration
+     *
+     * @param config - Configuration for the vector store and its indexes
+     * @returns Promise that resolves to a VectorStore instance when setup is complete
+     */
+    createVectorStore(config: VectorStoreConfig): VectorStore;
+}
+/**
+ * Base configuration for vector storage providers
+ */
+interface VectorStorageProviderConfig {
+    /** Provider-specific configuration */
+    [key: string]: unknown;
+}
+
+/**
+ * S3 Vector Store implementation that provides CRUD operations for a specific vector store
+ */
+declare class S3VectorStore<TVectorData extends VectorData = VectorData> implements VectorStore<TVectorData> {
+    private config;
+    private client;
+    constructor(client: S3VectorsClient, config: VectorStoreConfig);
+    private wrapOperationWithIndexCreation;
+    insertVectors(namespace: string, vectors: TVectorData[]): Promise<_aws_sdk_client_s3vectors.PutVectorsCommandOutput>;
+    queryVectors(namespace: string, options?: Omit<QueryVectorsCommandInput, 'vectorBucketName' | 'indexName' | 'queryVector'> & {
+        queryVector: number[];
+    }): Promise<{
+        vectors: TVectorData[];
+    }>;
+    deleteVectors(namespace: string, keys: string[]): Promise<_aws_sdk_client_s3vectors.DeleteVectorsCommandOutput>;
+    listVectors(namespace: string, options?: Omit<ListVectorsCommandInput, 'vectorBucketName' | 'indexName'>): Promise<Partial<TVectorData>[]>;
+    listVectorKeys(namespace: string, options?: Omit<ListVectorsCommandInput, 'vectorBucketName' | 'indexName' | 'returnData' | 'returnMetadata'>): Promise<TVectorData["key"][]>;
+    /**
+     * Create a new vector index
+     */
+    private createVectorIndex;
+    deleteNamespace(namespace: string): Promise<_aws_sdk_client_s3vectors.DeleteIndexCommandOutput>;
+}
+
+/**
+ * Configuration for AWS S3 Vector provider
+ */
+interface S3VectorProviderConfig extends VectorStorageProviderConfig {
+    s3Options: S3VectorsClientConfig;
+}
+/**
+ * AWS S3 Vector storage provider implementation
+ *
+ * This provider implements vector storage using AWS S3's native vector capabilities.
+ * It manages vector buckets and indexes according to the S3 Vector API.
+ */
+declare class S3VectorProvider implements VectorStorageProvider {
+    private config;
+    private client;
+    constructor(config: S3VectorProviderConfig);
+    /**
+     * Validate the provider configuration
+     */
+    private validateConfig;
+    createVectorStore(config: VectorStoreConfig): S3VectorStore<VectorData<Record<string, string | number | boolean>>>;
+    private setupVectorStore;
+    private storeExists;
+    /**
+     * Ensure a vector bucket exists, create if it doesn't
+     */
+    private ensureVectorBucketExists;
+    /**
+     * Create a new vector bucket
+     */
+    private createVectorBucket;
+    /**
+     * Validate vector store configuration
+     */
+    private validateVectorStoreConfig;
+    /**
+     * Validate vector index configuration
+     */
+    private validateIndexConfig;
+    /**
+     * Check if an error indicates a resource was not found
+     */
+    private isNotFoundError;
+}
+
+export { type DistanceMetric, S3VectorProvider, type S3VectorProviderConfig, type VectorData, type VectorDataType, type VectorIndexConfig, type VectorQueryParams, type VectorQueryResult, type VectorStorageProvider, type VectorStorageProviderConfig, type VectorStore, type VectorStoreConfig };

package/dist/index.js

@@ -0,0 +1,246 @@
+// src/providers/S3VectorProvider.ts
+import {
+  CreateVectorBucketCommand,
+  GetVectorBucketCommand,
+  NotFoundException as NotFoundException2,
+  S3VectorsClient as S3VectorsClient2
+} from "@aws-sdk/client-s3vectors";
+
+// src/providers/S3VectorStore.ts
+import {
+  CreateIndexCommand,
+  DeleteIndexCommand,
+  DeleteVectorsCommand,
+  ListVectorsCommand,
+  NotFoundException,
+  PutVectorsCommand,
+  QueryVectorsCommand
+} from "@aws-sdk/client-s3vectors";
+var S3VectorStore = class {
+  config;
+  client;
+  constructor(client, config) {
+    this.client = client;
+    this.config = config;
+  }
+  async wrapOperationWithIndexCreation(namespace, operation) {
+    try {
+      return await operation();
+    } catch (error) {
+      if (error instanceof NotFoundException) {
+        if (error.message === "The specified index could not be found") {
+          await this.createVectorIndex(namespace, this.config, this.config.index);
+          return this.wrapOperationWithIndexCreation(namespace, operation);
+        }
+      }
+      throw error;
+    }
+  }
+  async insertVectors(namespace, vectors) {
+    return await this.wrapOperationWithIndexCreation(namespace, async () => {
+      const result = await this.client.send(
+        new PutVectorsCommand({
+          vectorBucketName: this.config.storeName,
+          indexName: namespace,
+          vectors: vectors.map((vector) => ({
+            key: vector.key,
+            data: {
+              float32: vector.vector
+            },
+            metadata: vector.metadata
+          }))
+        })
+      );
+      return result;
+    });
+  }
+  async queryVectors(namespace, options) {
+    return await this.wrapOperationWithIndexCreation(namespace, async () => {
+      var _a;
+      const result = await this.client.send(
+        new QueryVectorsCommand({
+          ...options,
+          vectorBucketName: this.config.storeName,
+          indexName: namespace,
+          queryVector: {
+            float32: options.queryVector
+          }
+        })
+      );
+      const vectors = ((_a = result.vectors) == null ? void 0 : _a.map(
+        (vector) => {
+          var _a2;
+          return {
+            key: vector.key,
+            vector: (_a2 = vector.data) == null ? void 0 : _a2.float32,
+            metadata: vector.metadata
+          };
+        }
+      )) ?? [];
+      return {
+        vectors
+      };
+    });
+  }
+  async deleteVectors(namespace, keys) {
+    return await this.client.send(
+      new DeleteVectorsCommand({
+        vectorBucketName: this.config.storeName,
+        indexName: namespace,
+        keys
+      })
+    );
+  }
+  async listVectors(namespace, options) {
+    return await this.wrapOperationWithIndexCreation(namespace, async () => {
+      var _a;
+      const result = await this.client.send(
+        new ListVectorsCommand({
+          vectorBucketName: this.config.storeName,
+          indexName: namespace,
+          ...options
+        })
+      );
+      return ((_a = result.vectors) == null ? void 0 : _a.map((vector) => {
+        var _a2;
+        return {
+          key: vector.key,
+          vector: (_a2 = vector.data) == null ? void 0 : _a2.float32,
+          metadata: vector.metadata
+        };
+      })) ?? [];
+    });
+  }
+  async listVectorKeys(namespace, options) {
+    const result = await this.listVectors(namespace, {
+      ...options,
+      returnData: false,
+      returnMetadata: false
+    });
+    return result.map((vector) => vector.key);
+  }
+  /**
+   * Create a new vector index
+   */
+  async createVectorIndex(namespace, config, indexConfig) {
+    await this.client.send(
+      new CreateIndexCommand({
+        indexName: namespace,
+        dataType: "float32",
+        dimension: indexConfig.dimension,
+        distanceMetric: indexConfig.distanceMetric,
+        vectorBucketName: config.storeName,
+        metadataConfiguration: indexConfig.metadataConfiguration
+      })
+    );
+  }
+  async deleteNamespace(namespace) {
+    return await this.client.send(
+      new DeleteIndexCommand({
+        vectorBucketName: this.config.storeName,
+        indexName: namespace
+      })
+    );
+  }
+};
+
+// src/providers/S3VectorProvider.ts
+var S3VectorProvider = class {
+  config;
+  client;
+  constructor(config) {
+    this.config = config;
+    this.validateConfig();
+    this.client = new S3VectorsClient2(this.config.s3Options);
+  }
+  /**
+   * Validate the provider configuration
+   */
+  validateConfig() {
+    if (!this.config.s3Options) {
+      throw new Error("S3Options are required for S3VectorProvider");
+    }
+  }
+  createVectorStore(config) {
+    this.validateVectorStoreConfig(config);
+    this.setupVectorStore(config);
+    return new S3VectorStore(this.client, config);
+  }
+  async setupVectorStore(config) {
+    await this.ensureVectorBucketExists(config);
+  }
+  async storeExists(storeName) {
+    try {
+      await this.client.send(
+        new GetVectorBucketCommand({
+          vectorBucketName: storeName
+        })
+      );
+      return true;
+    } catch (error) {
+      if (this.isNotFoundError(error)) {
+        return false;
+      }
+      throw error;
+    }
+  }
+  /**
+   * Ensure a vector bucket exists, create if it doesn't
+   */
+  async ensureVectorBucketExists(config) {
+    const exists = await this.storeExists(config.storeName);
+    if (!exists) {
+      await this.createVectorBucket(config);
+    }
+  }
+  /**
+   * Create a new vector bucket
+   */
+  async createVectorBucket(config) {
+    await this.client.send(
+      new CreateVectorBucketCommand({
+        vectorBucketName: config.storeName,
+        encryptionConfiguration: config.encryptionConfiguration
+      })
+    );
+  }
+  /**
+   * Validate vector store configuration
+   */
+  validateVectorStoreConfig(config) {
+    if (!config.storeName || config.storeName.length < 3 || config.storeName.length > 63) {
+      throw new Error("Store name must be between 3 and 63 characters");
+    }
+    if (!/^[a-z0-9-]+$/.test(config.storeName)) {
+      throw new Error("Store name must contain only lowercase letters, numbers, and hyphens");
+    }
+    if (!config.index) {
+      throw new Error("Index must be specified");
+    }
+    this.validateIndexConfig(config.index);
+  }
+  /**
+   * Validate vector index configuration
+   */
+  validateIndexConfig(indexConfig) {
+    if (indexConfig.dimension < 1 || indexConfig.dimension > 4096) {
+      throw new Error("Vector dimension must be between 1 and 4096");
+    }
+    if (!["cosine", "euclidean"].includes(indexConfig.distanceMetric)) {
+      throw new Error('Distance metric must be either "cosine" or "euclidean"');
+    }
+  }
+  /**
+   * Check if an error indicates a resource was not found
+   */
+  isNotFoundError(error) {
+    if (error instanceof NotFoundException2) {
+      return true;
+    }
+    return false;
+  }
+};
+export {
+  S3VectorProvider
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/providers/S3VectorProvider.ts","../src/providers/S3VectorStore.ts"],"sourcesContent":["import type {VectorStorageProvider, VectorStorageProviderConfig} from '../VectorStorageProvider'\nimport type {VectorStoreConfig, VectorIndexConfig} from '../types'\nimport {\n  CreateVectorBucketCommand,\n  GetVectorBucketCommand,\n  NotFoundException,\n  S3VectorsClient,\n  S3VectorsClientConfig,\n} from '@aws-sdk/client-s3vectors'\nimport {S3VectorStore} from './S3VectorStore'\n\n/**\n * Configuration for AWS S3 Vector provider\n */\nexport interface S3VectorProviderConfig extends VectorStorageProviderConfig {\n  s3Options: S3VectorsClientConfig\n}\n\n/**\n * AWS S3 Vector storage provider implementation\n *\n * This provider implements vector storage using AWS S3's native vector capabilities.\n * It manages vector buckets and indexes according to the S3 Vector API.\n */\nexport class S3VectorProvider implements VectorStorageProvider {\n  private config: S3VectorProviderConfig\n  private client: S3VectorsClient\n\n  constructor(config: S3VectorProviderConfig) {\n    this.config = config\n    this.validateConfig()\n    this.client = new S3VectorsClient(this.config.s3Options)\n  }\n\n  /**\n   * Validate the provider configuration\n   */\n  private validateConfig(): void {\n    if (!this.config.s3Options) {\n      throw new Error('S3Options are required for S3VectorProvider')\n    }\n  }\n\n  createVectorStore(config: VectorStoreConfig) {\n    this.validateVectorStoreConfig(config)\n\n    this.setupVectorStore(config)\n\n    // Return a VectorStore instance\n    return new S3VectorStore(this.client, config)\n  }\n\n  private async setupVectorStore(config: VectorStoreConfig): Promise<void> {\n    // Ensure the vector bucket exists\n    await this.ensureVectorBucketExists(config)\n  }\n\n  private async storeExists(storeName: string): Promise<boolean> {\n    try {\n      await this.client.send(\n        new GetVectorBucketCommand({\n          vectorBucketName: storeName,\n        }),\n      )\n\n      return true\n    } catch (error) {\n      if (this.isNotFoundError(error)) {\n        return false\n      }\n      throw error\n    }\n  }\n\n  /**\n   * Ensure a vector bucket exists, create if it doesn't\n   */\n  private async ensureVectorBucketExists(config: VectorStoreConfig): Promise<void> {\n    const exists = await this.storeExists(config.storeName)\n    if (!exists) {\n      await this.createVectorBucket(config)\n    }\n  }\n\n  /**\n   * Create a new vector bucket\n   */\n  private async createVectorBucket(config: VectorStoreConfig): Promise<void> {\n    await this.client.send(\n      new CreateVectorBucketCommand({\n        vectorBucketName: config.storeName,\n        encryptionConfiguration: config.encryptionConfiguration,\n      }),\n    )\n  }\n\n  /**\n   * Validate vector store configuration\n   */\n  private validateVectorStoreConfig(config: VectorStoreConfig): void {\n    if (!config.storeName || config.storeName.length < 3 || config.storeName.length > 63) {\n      throw new Error('Store name must be between 3 and 63 characters')\n    }\n\n    if (!/^[a-z0-9-]+$/.test(config.storeName)) {\n      throw new Error('Store name must contain only lowercase letters, numbers, and hyphens')\n    }\n\n    if (!config.index) {\n      throw new Error('Index must be specified')\n    }\n\n    this.validateIndexConfig(config.index)\n  }\n\n  /**\n   * Validate vector index configuration\n   */\n  private validateIndexConfig(indexConfig: VectorIndexConfig): void {\n    if (indexConfig.dimension < 1 || indexConfig.dimension > 4096) {\n      throw new Error('Vector dimension must be between 1 and 4096')\n    }\n\n    if (!['cosine', 'euclidean'].includes(indexConfig.distanceMetric)) {\n      throw new Error('Distance metric must be either \"cosine\" or \"euclidean\"')\n    }\n  }\n\n  /**\n   * Check if an error indicates a resource was not found\n   */\n  private isNotFoundError(error: unknown): boolean {\n    if (error instanceof NotFoundException) {\n      return true\n    }\n    return false\n  }\n}\n","import {\n  CreateIndexCommand,\n  DeleteIndexCommand,\n  DeleteVectorsCommand,\n  ListVectorsCommand,\n  ListVectorsCommandInput,\n  NotFoundException,\n  PutVectorsCommand,\n  QueryVectorsCommand,\n  QueryVectorsCommandInput,\n  S3VectorsClient,\n} from '@aws-sdk/client-s3vectors'\nimport {VectorData, VectorIndexConfig, VectorStoreConfig} from '../types'\nimport {VectorStore} from '../VectorStore'\n\n/**\n * S3 Vector Store implementation that provides CRUD operations for a specific vector store\n */\nexport class S3VectorStore<TVectorData extends VectorData = VectorData>\n  implements VectorStore<TVectorData>\n{\n  private config: VectorStoreConfig\n  private client: S3VectorsClient\n\n  constructor(client: S3VectorsClient, config: VectorStoreConfig) {\n    this.client = client\n    this.config = config\n  }\n\n  private async wrapOperationWithIndexCreation<TOperation extends () => Promise<any>>(\n    namespace: string,\n    operation: TOperation,\n  ): Promise<Awaited<ReturnType<TOperation>>> {\n    try {\n      return await operation()\n    } catch (error) {\n      if (error instanceof NotFoundException) {\n        if (error.message === 'The specified index could not be found') {\n          await this.createVectorIndex(namespace, this.config, this.config.index)\n          return this.wrapOperationWithIndexCreation(namespace, operation)\n        }\n      }\n      throw error\n    }\n  }\n\n  async insertVectors(namespace: string, vectors: TVectorData[]) {\n    return await this.wrapOperationWithIndexCreation(namespace, async () => {\n      const result = await this.client.send(\n        new PutVectorsCommand({\n          vectorBucketName: this.config.storeName,\n          indexName: namespace,\n          vectors: vectors.map(vector => ({\n            key: vector.key,\n            data: {\n              float32: vector.vector,\n            },\n            metadata: vector.metadata,\n          })),\n        }),\n      )\n\n      return result\n    })\n  }\n\n  async queryVectors(\n    namespace: string,\n    options?: Omit<QueryVectorsCommandInput, 'vectorBucketName' | 'indexName' | 'queryVector'> & {\n      queryVector: number[]\n    },\n  ) {\n    return await this.wrapOperationWithIndexCreation(namespace, async () => {\n      const result = await this.client.send(\n        new QueryVectorsCommand({\n          ...options,\n          vectorBucketName: this.config.storeName,\n          indexName: namespace,\n          queryVector: {\n            float32: options.queryVector,\n          },\n        }),\n      )\n\n      const vectors: TVectorData[] =\n        result.vectors?.map(\n          vector =>\n            ({\n              key: vector.key,\n              vector: vector.data?.float32,\n              metadata: vector.metadata,\n            }) as TVectorData,\n        ) ?? []\n\n      return {\n        vectors,\n      }\n    })\n  }\n\n  async deleteVectors(namespace: string, keys: string[]) {\n    return await this.client.send(\n      new DeleteVectorsCommand({\n        vectorBucketName: this.config.storeName,\n        indexName: namespace,\n        keys,\n      }),\n    )\n  }\n\n  async listVectors(\n    namespace: string,\n    options?: Omit<ListVectorsCommandInput, 'vectorBucketName' | 'indexName'>,\n  ) {\n    return await this.wrapOperationWithIndexCreation(namespace, async () => {\n      const result = await this.client.send(\n        new ListVectorsCommand({\n          vectorBucketName: this.config.storeName,\n          indexName: namespace,\n          ...options,\n        }),\n      )\n\n      return (result.vectors?.map(vector => ({\n        key: vector.key,\n        vector: vector.data?.float32,\n        metadata: vector.metadata as TVectorData['metadata'],\n      })) ?? []) as Partial<TVectorData>[]\n    })\n  }\n\n  async listVectorKeys(\n    namespace: string,\n    options?: Omit<\n      ListVectorsCommandInput,\n      'vectorBucketName' | 'indexName' | 'returnData' | 'returnMetadata'\n    >,\n  ) {\n    const result = await this.listVectors(namespace, {\n      ...options,\n      returnData: false,\n      returnMetadata: false,\n    })\n    return result.map(vector => vector.key)\n  }\n\n  /**\n   * Create a new vector index\n   */\n  private async createVectorIndex(\n    namespace: string,\n    config: VectorStoreConfig,\n    indexConfig: VectorIndexConfig,\n  ): Promise<void> {\n    await this.client.send(\n      new CreateIndexCommand({\n        indexName: namespace,\n        dataType: 'float32',\n        dimension: indexConfig.dimension,\n        distanceMetric: indexConfig.distanceMetric,\n        vectorBucketName: config.storeName,\n        metadataConfiguration: indexConfig.metadataConfiguration,\n      }),\n    )\n  }\n\n  async deleteNamespace(namespace: string) {\n    return await this.client.send(\n      new DeleteIndexCommand({\n        vectorBucketName: this.config.storeName,\n        indexName: namespace,\n      }),\n    )\n  }\n}\n"],"mappings":"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","names":["NotFoundException","S3VectorsClient","_a","S3VectorsClient","NotFoundException"]}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@orion-js/vectors",
+  "version": "4.0.1",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "types": "./dist/index.d.ts",
+    "import": "./dist/index.js",
+    "require": "./dist/index.cjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "author": "nicolaslopezj",
+  "license": "MIT",
+  "devDependencies": {
+    "@aws-sdk/client-s3vectors": "^3.848.0",
+    "@types/node": "^18.19.86",
+    "tsup": "^8.0.1",
+    "typescript": "^5.4.5",
+    "vitest": "^3.1.1"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-s3vectors": "*"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "vitest --config vitest.config.ts run",
+    "clean": "rm -rf ./dist",
+    "build": "tsup",
+    "upgrade-interactive": "pnpm upgrade --interactive",
+    "dev": "tsup --watch"
+  }
+}