@supabase/storage-js 2.84.0 → 2.84.1-canary.1

package/dist/module/lib/vectors/VectorDataApi.d.ts

@@ -1,13 +1,9 @@
 import { Fetch } from './fetch';
 import { ApiResponse, PutVectorsOptions, GetVectorsOptions, GetVectorsResponse, DeleteVectorsOptions, ListVectorsOptions, ListVectorsResponse, QueryVectorsOptions, QueryVectorsResponse } from './types';
 /**
- *
- * @alpha
- *
- * API class for managing Vector Data within Vector Indexes
- * Provides methods for inserting, querying, listing, and deleting vector embeddings
- *
- * **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
+ * @hidden
+ * Base implementation for vector data operations.
+ * Use {@link VectorIndexScope} via `supabase.storage.vectors.from('bucket').index('idx')` instead.
  */
 export default class VectorDataApi {
     protected url: string;
@@ -16,265 +12,21 @@ export default class VectorDataApi {
     };
     protected fetch: Fetch;
     protected shouldThrowOnError: boolean;
-    /**
-     *
-     * @alpha
-     *
-     * Creates a VectorDataApi bound to a Storage Vectors deployment.
-     *
-     * **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
-     *
-     * @category Vector Buckets
-     * @param url - Base URL for the Storage Vectors API.
-     * @param headers - Default headers (for example authentication tokens).
-     * @param fetch - Optional custom `fetch` implementation for non-browser runtimes.
-     *
-     * @example
-     * ```typescript
-     * const client = new VectorDataApi(url, headers)
-     * ```
-     */
+    /** Creates a new VectorDataApi instance */
     constructor(url: string, headers?: {
         [key: string]: string;
     }, fetch?: Fetch);
-    /**
-     *
-     * @alpha
-     *
-     * Enable throwing errors instead of returning them in the response
-     * When enabled, failed operations will throw instead of returning { data: null, error }
-     *
-     * **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
-     *
-     * @category Vector Buckets
-     * @returns This instance for method chaining
-     * @example
-     * ```typescript
-     * const client = new VectorDataApi(url, headers)
-     * client.throwOnError()
-     * const { data } = await client.putVectors(options) // throws on error
-     * ```
-     */
+    /** Enable throwing errors instead of returning them in the response */
     throwOnError(): this;
-    /**
-     *
-     * @alpha
-     *
-     * Inserts or updates vectors in batch (upsert operation)
-     * Accepts 1-500 vectors per request. Larger batches should be split
-     *
-     * **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
-     *
-     * @category Vector Buckets
-     * @param options - Vector insertion options
-     * @param options.vectorBucketName - Name of the parent vector bucket
-     * @param options.indexName - Name of the target index
-     * @param options.vectors - Array of vectors to insert/update (1-500 items)
-     * @returns Promise with empty response on success or error
-     *
-     * @throws {StorageVectorsApiError} With code:
-     * - `S3VectorConflictException` if duplicate key conflict occurs (HTTP 409)
-     * - `S3VectorNotFoundException` if bucket or index doesn't exist (HTTP 404)
-     * - `InternalError` for server errors (HTTP 500)
-     *
-     * @example
-     * ```typescript
-     * const { data, error } = await client.putVectors({
-     *   vectorBucketName: 'embeddings-prod',
-     *   indexName: 'documents-openai-small',
-     *   vectors: [
-     *     {
-     *       key: 'doc-1',
-     *       data: { float32: [0.1, 0.2, 0.3, ...] }, // 1536 dimensions
-     *       metadata: { title: 'Introduction', page: 1 }
-     *     },
-     *     {
-     *       key: 'doc-2',
-     *       data: { float32: [0.4, 0.5, 0.6, ...] },
-     *       metadata: { title: 'Conclusion', page: 42 }
-     *     }
-     *   ]
-     * })
-     * ```
-     */
+    /** Inserts or updates vectors in batch (1-500 per request) */
     putVectors(options: PutVectorsOptions): Promise<ApiResponse<undefined>>;
-    /**
-     *
-     * @alpha
-     *
-     * Retrieves vectors by their keys in batch
-     * Optionally includes vector data and/or metadata in response
-     * Additional permissions required when returning data or metadata
-     *
-     * **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
-     *
-     * @category Vector Buckets
-     * @param options - Vector retrieval options
-     * @param options.vectorBucketName - Name of the parent vector bucket
-     * @param options.indexName - Name of the index
-     * @param options.keys - Array of vector keys to retrieve
-     * @param options.returnData - Whether to include vector embeddings (requires permission)
-     * @param options.returnMetadata - Whether to include metadata (requires permission)
-     * @returns Promise with array of vectors or error
-     *
-     * @throws {StorageVectorsApiError} With code:
-     * - `S3VectorNotFoundException` if bucket or index doesn't exist (HTTP 404)
-     * - `InternalError` for server errors (HTTP 500)
-     *
-     * @example
-     * ```typescript
-     * const { data, error } = await client.getVectors({
-     *   vectorBucketName: 'embeddings-prod',
-     *   indexName: 'documents-openai-small',
-     *   keys: ['doc-1', 'doc-2', 'doc-3'],
-     *   returnData: false,     // Don't return embeddings
-     *   returnMetadata: true   // Return metadata only
-     * })
-     * if (data) {
-     *   data.vectors.forEach(v => console.log(v.key, v.metadata))
-     * }
-     * ```
-     */
+    /** Retrieves vectors by their keys in batch */
     getVectors(options: GetVectorsOptions): Promise<ApiResponse<GetVectorsResponse>>;
-    /**
-     *
-     * @alpha
-     *
-     * Lists/scans vectors in an index with pagination
-     * Supports parallel scanning via segment configuration for high-throughput scenarios
-     * Additional permissions required when returning data or metadata
-     *
-     * **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
-     *
-     * @category Vector Buckets
-     * @param options - Vector listing options
-     * @param options.vectorBucketName - Name of the parent vector bucket
-     * @param options.indexName - Name of the index
-     * @param options.maxResults - Maximum results per page (default: 500, max: 1000)
-     * @param options.nextToken - Pagination token from previous response
-     * @param options.returnData - Whether to include vector embeddings (requires permission)
-     * @param options.returnMetadata - Whether to include metadata (requires permission)
-     * @param options.segmentCount - Total parallel segments (1-16) for distributed scanning
-     * @param options.segmentIndex - Zero-based segment index (0 to segmentCount-1)
-     * @returns Promise with array of vectors, pagination token, or error
-     *
-     * @throws {StorageVectorsApiError} With code:
-     * - `S3VectorNotFoundException` if bucket or index doesn't exist (HTTP 404)
-     * - `InternalError` for server errors (HTTP 500)
-     *
-     * @example
-     * ```typescript
-     * // Simple pagination
-     * let nextToken: string | undefined
-     * do {
-     *   const { data, error } = await client.listVectors({
-     *     vectorBucketName: 'embeddings-prod',
-     *     indexName: 'documents-openai-small',
-     *     maxResults: 500,
-     *     nextToken,
-     *     returnMetadata: true
-     *   })
-     *   if (error) break
-     *   console.log('Batch:', data.vectors.length)
-     *   nextToken = data.nextToken
-     * } while (nextToken)
-     *
-     * // Parallel scanning (4 concurrent workers)
-     * const workers = [0, 1, 2, 3].map(async (segmentIndex) => {
-     *   const { data } = await client.listVectors({
-     *     vectorBucketName: 'embeddings-prod',
-     *     indexName: 'documents-openai-small',
-     *     segmentCount: 4,
-     *     segmentIndex,
-     *     returnMetadata: true
-     *   })
-     *   return data?.vectors || []
-     * })
-     * const results = await Promise.all(workers)
-     * ```
-     */
+    /** Lists vectors in an index with pagination */
     listVectors(options: ListVectorsOptions): Promise<ApiResponse<ListVectorsResponse>>;
-    /**
-     *
-     * @alpha
-     *
-     * Queries for similar vectors using approximate nearest neighbor (ANN) search
-     * Returns top-K most similar vectors based on the configured distance metric
-     * Supports optional metadata filtering (requires GetVectors permission)
-     *
-     * **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
-     *
-     * @category Vector Buckets
-     * @param options - Query options
-     * @param options.vectorBucketName - Name of the parent vector bucket
-     * @param options.indexName - Name of the index
-     * @param options.queryVector - Query embedding to find similar vectors
-     * @param options.topK - Number of nearest neighbors to return (default: 10)
-     * @param options.filter - Optional JSON filter for metadata (requires GetVectors permission)
-     * @param options.returnDistance - Whether to include similarity distances
-     * @param options.returnMetadata - Whether to include metadata (requires GetVectors permission)
-     * @returns Promise with array of similar vectors ordered by distance
-     *
-     * @throws {StorageVectorsApiError} With code:
-     * - `S3VectorNotFoundException` if bucket or index doesn't exist (HTTP 404)
-     * - `InternalError` for server errors (HTTP 500)
-     *
-     * @example
-     * ```typescript
-     * // Semantic search with filtering
-     * const { data, error } = await client.queryVectors({
-     *   vectorBucketName: 'embeddings-prod',
-     *   indexName: 'documents-openai-small',
-     *   queryVector: { float32: [0.1, 0.2, 0.3, ...] }, // 1536 dimensions
-     *   topK: 5,
-     *   filter: {
-     *     category: 'technical',
-     *     published: true
-     *   },
-     *   returnDistance: true,
-     *   returnMetadata: true
-     * })
-     * if (data) {
-     *   data.matches.forEach(match => {
-     *     console.log(`${match.key}: distance=${match.distance}`)
-     *     console.log('Metadata:', match.metadata)
-     *   })
-     * }
-     * ```
-     */
+    /** Queries for similar vectors using approximate nearest neighbor search */
     queryVectors(options: QueryVectorsOptions): Promise<ApiResponse<QueryVectorsResponse>>;
-    /**
-     *
-     * @alpha
-     *
-     * Deletes vectors by their keys in batch
-     * Accepts 1-500 keys per request
-     *
-     * **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
-     *
-     * @category Vector Buckets
-     * @param options - Vector deletion options
-     * @param options.vectorBucketName - Name of the parent vector bucket
-     * @param options.indexName - Name of the index
-     * @param options.keys - Array of vector keys to delete (1-500 items)
-     * @returns Promise with empty response on success or error
-     *
-     * @throws {StorageVectorsApiError} With code:
-     * - `S3VectorNotFoundException` if bucket or index doesn't exist (HTTP 404)
-     * - `InternalError` for server errors (HTTP 500)
-     *
-     * @example
-     * ```typescript
-     * const { error } = await client.deleteVectors({
-     *   vectorBucketName: 'embeddings-prod',
-     *   indexName: 'documents-openai-small',
-     *   keys: ['doc-1', 'doc-2', 'doc-3']
-     * })
-     * if (!error) {
-     *   console.log('Vectors deleted successfully')
-     * }
-     * ```
-     */
+    /** Deletes vectors by their keys in batch (1-500 per request) */
     deleteVectors(options: DeleteVectorsOptions): Promise<ApiResponse<undefined>>;
 }
 //# sourceMappingURL=VectorDataApi.d.ts.map

package/dist/module/lib/vectors/VectorDataApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VectorDataApi.d.ts","sourceRoot":"","sources":["../../../../src/lib/vectors/VectorDataApi.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAQ,MAAM,SAAS,CAAA;AAErC,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,SAAS,CAAA;AAEhB;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;IAChC,SAAS,CAAC,GAAG,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,OAAO,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAA;IAC5C,SAAS,CAAC,KAAK,EAAE,KAAK,CAAA;IACtB,SAAS,CAAC,kBAAkB,UAAQ;IAEpC;;;;;;;;;;;;;;;;;OAiBG;gBACS,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAO,EAAE,KAAK,CAAC,EAAE,KAAK;IAM/E;;;;;;;;;;;;;;;;;OAiBG;IACI,YAAY,IAAI,IAAI;IAK3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;IACG,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAsB7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACG,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;IAiBtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwDG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IA6BzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+CG;IACG,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC;IAiB5F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;CAqBpF"}
+{"version":3,"file":"VectorDataApi.d.ts","sourceRoot":"","sources":["../../../../src/lib/vectors/VectorDataApi.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAQ,MAAM,SAAS,CAAA;AAErC,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,SAAS,CAAA;AAEhB;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;IAChC,SAAS,CAAC,GAAG,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,OAAO,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAA;IAC5C,SAAS,CAAC,KAAK,EAAE,KAAK,CAAA;IACtB,SAAS,CAAC,kBAAkB,UAAQ;IAEpC,2CAA2C;gBAC/B,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAO,EAAE,KAAK,CAAC,EAAE,KAAK;IAM/E,uEAAuE;IAChE,YAAY,IAAI,IAAI;IAK3B,8DAA8D;IACxD,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAsB7E,+CAA+C;IACzC,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;IAiBtF,gDAAgD;IAC1C,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IA6BzF,4EAA4E;IACtE,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC;IAiB5F,iEAAiE;IAC3D,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;CAqBpF"}

package/dist/module/lib/vectors/VectorDataApi.js

@@ -4,102 +4,24 @@ import { isStorageVectorsError } from './errors';
 import { post } from './fetch';
 import { resolveFetch } from './helpers';
 /**
- *
- * @alpha
- *
- * API class for managing Vector Data within Vector Indexes
- * Provides methods for inserting, querying, listing, and deleting vector embeddings
- *
- * **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
+ * @hidden
+ * Base implementation for vector data operations.
+ * Use {@link VectorIndexScope} via `supabase.storage.vectors.from('bucket').index('idx')` instead.
  */
 export default class VectorDataApi {
-    /**
-     *
-     * @alpha
-     *
-     * Creates a VectorDataApi bound to a Storage Vectors deployment.
-     *
-     * **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
-     *
-     * @category Vector Buckets
-     * @param url - Base URL for the Storage Vectors API.
-     * @param headers - Default headers (for example authentication tokens).
-     * @param fetch - Optional custom `fetch` implementation for non-browser runtimes.
-     *
-     * @example
-     * ```typescript
-     * const client = new VectorDataApi(url, headers)
-     * ```
-     */
+    /** Creates a new VectorDataApi instance */
     constructor(url, headers = {}, fetch) {
         this.shouldThrowOnError = false;
         this.url = url.replace(/\/$/, '');
         this.headers = Object.assign(Object.assign({}, DEFAULT_HEADERS), headers);
         this.fetch = resolveFetch(fetch);
     }
-    /**
-     *
-     * @alpha
-     *
-     * Enable throwing errors instead of returning them in the response
-     * When enabled, failed operations will throw instead of returning { data: null, error }
-     *
-     * **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
-     *
-     * @category Vector Buckets
-     * @returns This instance for method chaining
-     * @example
-     * ```typescript
-     * const client = new VectorDataApi(url, headers)
-     * client.throwOnError()
-     * const { data } = await client.putVectors(options) // throws on error
-     * ```
-     */
+    /** Enable throwing errors instead of returning them in the response */
     throwOnError() {
         this.shouldThrowOnError = true;
         return this;
     }
-    /**
-     *
-     * @alpha
-     *
-     * Inserts or updates vectors in batch (upsert operation)
-     * Accepts 1-500 vectors per request. Larger batches should be split
-     *
-     * **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
-     *
-     * @category Vector Buckets
-     * @param options - Vector insertion options
-     * @param options.vectorBucketName - Name of the parent vector bucket
-     * @param options.indexName - Name of the target index
-     * @param options.vectors - Array of vectors to insert/update (1-500 items)
-     * @returns Promise with empty response on success or error
-     *
-     * @throws {StorageVectorsApiError} With code:
-     * - `S3VectorConflictException` if duplicate key conflict occurs (HTTP 409)
-     * - `S3VectorNotFoundException` if bucket or index doesn't exist (HTTP 404)
-     * - `InternalError` for server errors (HTTP 500)
-     *
-     * @example
-     * ```typescript
-     * const { data, error } = await client.putVectors({
-     *   vectorBucketName: 'embeddings-prod',
-     *   indexName: 'documents-openai-small',
-     *   vectors: [
-     *     {
-     *       key: 'doc-1',
-     *       data: { float32: [0.1, 0.2, 0.3, ...] }, // 1536 dimensions
-     *       metadata: { title: 'Introduction', page: 1 }
-     *     },
-     *     {
-     *       key: 'doc-2',
-     *       data: { float32: [0.4, 0.5, 0.6, ...] },
-     *       metadata: { title: 'Conclusion', page: 42 }
-     *     }
-     *   ]
-     * })
-     * ```
-     */
+    /** Inserts or updates vectors in batch (1-500 per request) */
     putVectors(options) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
@@ -123,43 +45,7 @@ export default class VectorDataApi {
             }
         });
     }
-    /**
-     *
-     * @alpha
-     *
-     * Retrieves vectors by their keys in batch
-     * Optionally includes vector data and/or metadata in response
-     * Additional permissions required when returning data or metadata
-     *
-     * **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
-     *
-     * @category Vector Buckets
-     * @param options - Vector retrieval options
-     * @param options.vectorBucketName - Name of the parent vector bucket
-     * @param options.indexName - Name of the index
-     * @param options.keys - Array of vector keys to retrieve
-     * @param options.returnData - Whether to include vector embeddings (requires permission)
-     * @param options.returnMetadata - Whether to include metadata (requires permission)
-     * @returns Promise with array of vectors or error
-     *
-     * @throws {StorageVectorsApiError} With code:
-     * - `S3VectorNotFoundException` if bucket or index doesn't exist (HTTP 404)
-     * - `InternalError` for server errors (HTTP 500)
-     *
-     * @example
-     * ```typescript
-     * const { data, error } = await client.getVectors({
-     *   vectorBucketName: 'embeddings-prod',
-     *   indexName: 'documents-openai-small',
-     *   keys: ['doc-1', 'doc-2', 'doc-3'],
-     *   returnData: false,     // Don't return embeddings
-     *   returnMetadata: true   // Return metadata only
-     * })
-     * if (data) {
-     *   data.vectors.forEach(v => console.log(v.key, v.metadata))
-     * }
-     * ```
-     */
+    /** Retrieves vectors by their keys in batch */
     getVectors(options) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
@@ -179,63 +65,7 @@ export default class VectorDataApi {
             }
         });
     }
-    /**
-     *
-     * @alpha
-     *
-     * Lists/scans vectors in an index with pagination
-     * Supports parallel scanning via segment configuration for high-throughput scenarios
-     * Additional permissions required when returning data or metadata
-     *
-     * **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
-     *
-     * @category Vector Buckets
-     * @param options - Vector listing options
-     * @param options.vectorBucketName - Name of the parent vector bucket
-     * @param options.indexName - Name of the index
-     * @param options.maxResults - Maximum results per page (default: 500, max: 1000)
-     * @param options.nextToken - Pagination token from previous response
-     * @param options.returnData - Whether to include vector embeddings (requires permission)
-     * @param options.returnMetadata - Whether to include metadata (requires permission)
-     * @param options.segmentCount - Total parallel segments (1-16) for distributed scanning
-     * @param options.segmentIndex - Zero-based segment index (0 to segmentCount-1)
-     * @returns Promise with array of vectors, pagination token, or error
-     *
-     * @throws {StorageVectorsApiError} With code:
-     * - `S3VectorNotFoundException` if bucket or index doesn't exist (HTTP 404)
-     * - `InternalError` for server errors (HTTP 500)
-     *
-     * @example
-     * ```typescript
-     * // Simple pagination
-     * let nextToken: string | undefined
-     * do {
-     *   const { data, error } = await client.listVectors({
-     *     vectorBucketName: 'embeddings-prod',
-     *     indexName: 'documents-openai-small',
-     *     maxResults: 500,
-     *     nextToken,
-     *     returnMetadata: true
-     *   })
-     *   if (error) break
-     *   console.log('Batch:', data.vectors.length)
-     *   nextToken = data.nextToken
-     * } while (nextToken)
-     *
-     * // Parallel scanning (4 concurrent workers)
-     * const workers = [0, 1, 2, 3].map(async (segmentIndex) => {
-     *   const { data } = await client.listVectors({
-     *     vectorBucketName: 'embeddings-prod',
-     *     indexName: 'documents-openai-small',
-     *     segmentCount: 4,
-     *     segmentIndex,
-     *     returnMetadata: true
-     *   })
-     *   return data?.vectors || []
-     * })
-     * const results = await Promise.all(workers)
-     * ```
-     */
+    /** Lists vectors in an index with pagination */
     listVectors(options) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
@@ -266,54 +96,7 @@ export default class VectorDataApi {
             }
         });
     }
-    /**
-     *
-     * @alpha
-     *
-     * Queries for similar vectors using approximate nearest neighbor (ANN) search
-     * Returns top-K most similar vectors based on the configured distance metric
-     * Supports optional metadata filtering (requires GetVectors permission)
-     *
-     * **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
-     *
-     * @category Vector Buckets
-     * @param options - Query options
-     * @param options.vectorBucketName - Name of the parent vector bucket
-     * @param options.indexName - Name of the index
-     * @param options.queryVector - Query embedding to find similar vectors
-     * @param options.topK - Number of nearest neighbors to return (default: 10)
-     * @param options.filter - Optional JSON filter for metadata (requires GetVectors permission)
-     * @param options.returnDistance - Whether to include similarity distances
-     * @param options.returnMetadata - Whether to include metadata (requires GetVectors permission)
-     * @returns Promise with array of similar vectors ordered by distance
-     *
-     * @throws {StorageVectorsApiError} With code:
-     * - `S3VectorNotFoundException` if bucket or index doesn't exist (HTTP 404)
-     * - `InternalError` for server errors (HTTP 500)
-     *
-     * @example
-     * ```typescript
-     * // Semantic search with filtering
-     * const { data, error } = await client.queryVectors({
-     *   vectorBucketName: 'embeddings-prod',
-     *   indexName: 'documents-openai-small',
-     *   queryVector: { float32: [0.1, 0.2, 0.3, ...] }, // 1536 dimensions
-     *   topK: 5,
-     *   filter: {
-     *     category: 'technical',
-     *     published: true
-     *   },
-     *   returnDistance: true,
-     *   returnMetadata: true
-     * })
-     * if (data) {
-     *   data.matches.forEach(match => {
-     *     console.log(`${match.key}: distance=${match.distance}`)
-     *     console.log('Metadata:', match.metadata)
-     *   })
-     * }
-     * ```
-     */
+    /** Queries for similar vectors using approximate nearest neighbor search */
     queryVectors(options) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
@@ -333,38 +116,7 @@ export default class VectorDataApi {
             }
         });
     }
-    /**
-     *
-     * @alpha
-     *
-     * Deletes vectors by their keys in batch
-     * Accepts 1-500 keys per request
-     *
-     * **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
-     *
-     * @category Vector Buckets
-     * @param options - Vector deletion options
-     * @param options.vectorBucketName - Name of the parent vector bucket
-     * @param options.indexName - Name of the index
-     * @param options.keys - Array of vector keys to delete (1-500 items)
-     * @returns Promise with empty response on success or error
-     *
-     * @throws {StorageVectorsApiError} With code:
-     * - `S3VectorNotFoundException` if bucket or index doesn't exist (HTTP 404)
-     * - `InternalError` for server errors (HTTP 500)
-     *
-     * @example
-     * ```typescript
-     * const { error } = await client.deleteVectors({
-     *   vectorBucketName: 'embeddings-prod',
-     *   indexName: 'documents-openai-small',
-     *   keys: ['doc-1', 'doc-2', 'doc-3']
-     * })
-     * if (!error) {
-     *   console.log('Vectors deleted successfully')
-     * }
-     * ```
-     */
+    /** Deletes vectors by their keys in batch (1-500 per request) */
     deleteVectors(options) {
         return __awaiter(this, void 0, void 0, function* () {
             try {

package/dist/module/lib/vectors/VectorDataApi.js.map

@@ -1 +1 @@
-{"version":3,"file":"VectorDataApi.js","sourceRoot":"","sources":["../../../../src/lib/vectors/VectorDataApi.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"VectorDataApi.js","sourceRoot":"","sources":["../../../../src/lib/vectors/VectorDataApi.ts"],"names":[],"mappings":"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"}