@supabase/storage-js 2.79.1-canary.1 → 2.80.0

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

@@ -0,0 +1,157 @@
+import { Fetch } from './fetch';
+import { ApiResponse, VectorIndex, ListIndexesOptions, ListIndexesResponse, VectorDataType, DistanceMetric, MetadataConfiguration } from './types';
+/**
+ * Options for creating a vector index
+ */
+export interface CreateIndexOptions {
+    vectorBucketName: string;
+    indexName: string;
+    dataType: VectorDataType;
+    dimension: number;
+    distanceMetric: DistanceMetric;
+    metadataConfiguration?: MetadataConfiguration;
+}
+/**
+ * API class for managing Vector Indexes within Vector Buckets
+ * Provides methods for creating, reading, listing, and deleting vector indexes
+ */
+export default class VectorIndexApi {
+    protected url: string;
+    protected headers: {
+        [key: string]: string;
+    };
+    protected fetch: Fetch;
+    protected shouldThrowOnError: boolean;
+    constructor(url: string, headers?: {
+        [key: string]: string;
+    }, fetch?: Fetch);
+    /**
+     * Enable throwing errors instead of returning them in the response
+     * When enabled, failed operations will throw instead of returning { data: null, error }
+     *
+     * @returns This instance for method chaining
+     * @example
+     * ```typescript
+     * const client = new VectorIndexApi(url, headers)
+     * client.throwOnError()
+     * const { data } = await client.createIndex(options) // throws on error
+     * ```
+     */
+    throwOnError(): this;
+    /**
+     * Creates a new vector index within a bucket
+     * Defines the schema for vectors including dimensionality, distance metric, and metadata config
+     *
+     * @param options - Index configuration
+     * @param options.vectorBucketName - Name of the parent vector bucket
+     * @param options.indexName - Unique name for the index within the bucket
+     * @param options.dataType - Data type for vector components (currently only 'float32')
+     * @param options.dimension - Dimensionality of vectors (e.g., 384, 768, 1536)
+     * @param options.distanceMetric - Similarity metric ('cosine', 'euclidean', 'dotproduct')
+     * @param options.metadataConfiguration - Optional config for non-filterable metadata keys
+     * @returns Promise with empty response on success or error
+     *
+     * @throws {StorageVectorsApiError} With code:
+     * - `S3VectorConflictException` if index already exists (HTTP 409)
+     * - `S3VectorMaxIndexesExceeded` if quota exceeded (HTTP 400)
+     * - `S3VectorNotFoundException` if bucket doesn't exist (HTTP 404)
+     * - `InternalError` for server errors (HTTP 500)
+     *
+     * @example
+     * ```typescript
+     * const { data, error } = await client.createIndex({
+     *   vectorBucketName: 'embeddings-prod',
+     *   indexName: 'documents-openai-small',
+     *   dataType: 'float32',
+     *   dimension: 1536,
+     *   distanceMetric: 'cosine',
+     *   metadataConfiguration: {
+     *     nonFilterableMetadataKeys: ['raw_text', 'internal_id']
+     *   }
+     * })
+     * ```
+     */
+    createIndex(options: CreateIndexOptions): Promise<ApiResponse<undefined>>;
+    /**
+     * Retrieves metadata for a specific vector index
+     * Returns index configuration including dimension, distance metric, and metadata settings
+     *
+     * @param vectorBucketName - Name of the parent vector bucket
+     * @param indexName - Name of the index to retrieve
+     * @returns Promise with index metadata or error
+     *
+     * @throws {StorageVectorsApiError} With code:
+     * - `S3VectorNotFoundException` if index or bucket doesn't exist (HTTP 404)
+     * - `InternalError` for server errors (HTTP 500)
+     *
+     * @example
+     * ```typescript
+     * const { data, error } = await client.getIndex('embeddings-prod', 'documents-openai-small')
+     * if (data) {
+     *   console.log('Index dimension:', data.index.dimension)
+     *   console.log('Distance metric:', data.index.distanceMetric)
+     * }
+     * ```
+     */
+    getIndex(vectorBucketName: string, indexName: string): Promise<ApiResponse<{
+        index: VectorIndex;
+    }>>;
+    /**
+     * Lists vector indexes within a bucket with optional filtering and pagination
+     * Supports prefix-based filtering and paginated results
+     *
+     * @param options - Listing options
+     * @param options.vectorBucketName - Name of the parent vector bucket
+     * @param options.prefix - Filter indexes by name prefix
+     * @param options.maxResults - Maximum results per page (default: 100)
+     * @param options.nextToken - Pagination token from previous response
+     * @returns Promise with list of indexes and pagination token
+     *
+     * @throws {StorageVectorsApiError} With code:
+     * - `S3VectorNotFoundException` if bucket doesn't exist (HTTP 404)
+     * - `InternalError` for server errors (HTTP 500)
+     *
+     * @example
+     * ```typescript
+     * // List all indexes in a bucket
+     * const { data, error } = await client.listIndexes({
+     *   vectorBucketName: 'embeddings-prod',
+     *   prefix: 'documents-'
+     * })
+     * if (data) {
+     *   console.log('Found indexes:', data.indexes.map(i => i.indexName))
+     *   // Fetch next page if available
+     *   if (data.nextToken) {
+     *     const next = await client.listIndexes({
+     *       vectorBucketName: 'embeddings-prod',
+     *       nextToken: data.nextToken
+     *     })
+     *   }
+     * }
+     * ```
+     */
+    listIndexes(options: ListIndexesOptions): Promise<ApiResponse<ListIndexesResponse>>;
+    /**
+     * Deletes a vector index and all its data
+     * This operation removes the index schema and all vectors stored in the index
+     *
+     * @param vectorBucketName - Name of the parent vector bucket
+     * @param indexName - Name of the index to delete
+     * @returns Promise with empty response on success or error
+     *
+     * @throws {StorageVectorsApiError} With code:
+     * - `S3VectorNotFoundException` if index or bucket doesn't exist (HTTP 404)
+     * - `InternalError` for server errors (HTTP 500)
+     *
+     * @example
+     * ```typescript
+     * // Delete an index and all its vectors
+     * const { error } = await client.deleteIndex('embeddings-prod', 'old-index')
+     * if (!error) {
+     *   console.log('Index deleted successfully')
+     * }
+     * ```
+     */
+    deleteIndex(vectorBucketName: string, indexName: string): Promise<ApiResponse<undefined>>;
+}
+//# sourceMappingURL=VectorIndexApi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VectorIndexApi.d.ts","sourceRoot":"","sources":["../../../../src/lib/vectors/VectorIndexApi.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAQ,MAAM,SAAS,CAAA;AAErC,OAAO,EACL,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,qBAAqB,EACtB,MAAM,SAAS,CAAA;AAEhB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,cAAc,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,cAAc,CAAA;IAC9B,qBAAqB,CAAC,EAAE,qBAAqB,CAAA;CAC9C;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,cAAc;IACjC,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;gBAExB,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAO,EAAE,KAAK,CAAC,EAAE,KAAK;IAM/E;;;;;;;;;;;OAWG;IACI,YAAY,IAAI,IAAI;IAK3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAiB/E;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,QAAQ,CACZ,gBAAgB,EAAE,MAAM,EACxB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,CAAC;QAAE,KAAK,EAAE,WAAW,CAAA;KAAE,CAAC,CAAC;IAoB/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAiBzF;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,WAAW,CAAC,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;CAmBhG"}

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

@@ -0,0 +1,215 @@
+import { __awaiter } from "tslib";
+import { DEFAULT_HEADERS } from './constants';
+import { isStorageVectorsError } from './errors';
+import { post } from './fetch';
+import { resolveFetch } from './helpers';
+/**
+ * API class for managing Vector Indexes within Vector Buckets
+ * Provides methods for creating, reading, listing, and deleting vector indexes
+ */
+export default class VectorIndexApi {
+    constructor(url, headers = {}, fetch) {
+        this.shouldThrowOnError = false;
+        this.url = url.replace(/\/$/, '');
+        this.headers = Object.assign(Object.assign({}, DEFAULT_HEADERS), headers);
+        this.fetch = resolveFetch(fetch);
+    }
+    /**
+     * Enable throwing errors instead of returning them in the response
+     * When enabled, failed operations will throw instead of returning { data: null, error }
+     *
+     * @returns This instance for method chaining
+     * @example
+     * ```typescript
+     * const client = new VectorIndexApi(url, headers)
+     * client.throwOnError()
+     * const { data } = await client.createIndex(options) // throws on error
+     * ```
+     */
+    throwOnError() {
+        this.shouldThrowOnError = true;
+        return this;
+    }
+    /**
+     * Creates a new vector index within a bucket
+     * Defines the schema for vectors including dimensionality, distance metric, and metadata config
+     *
+     * @param options - Index configuration
+     * @param options.vectorBucketName - Name of the parent vector bucket
+     * @param options.indexName - Unique name for the index within the bucket
+     * @param options.dataType - Data type for vector components (currently only 'float32')
+     * @param options.dimension - Dimensionality of vectors (e.g., 384, 768, 1536)
+     * @param options.distanceMetric - Similarity metric ('cosine', 'euclidean', 'dotproduct')
+     * @param options.metadataConfiguration - Optional config for non-filterable metadata keys
+     * @returns Promise with empty response on success or error
+     *
+     * @throws {StorageVectorsApiError} With code:
+     * - `S3VectorConflictException` if index already exists (HTTP 409)
+     * - `S3VectorMaxIndexesExceeded` if quota exceeded (HTTP 400)
+     * - `S3VectorNotFoundException` if bucket doesn't exist (HTTP 404)
+     * - `InternalError` for server errors (HTTP 500)
+     *
+     * @example
+     * ```typescript
+     * const { data, error } = await client.createIndex({
+     *   vectorBucketName: 'embeddings-prod',
+     *   indexName: 'documents-openai-small',
+     *   dataType: 'float32',
+     *   dimension: 1536,
+     *   distanceMetric: 'cosine',
+     *   metadataConfiguration: {
+     *     nonFilterableMetadataKeys: ['raw_text', 'internal_id']
+     *   }
+     * })
+     * ```
+     */
+    createIndex(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const data = yield post(this.fetch, `${this.url}/CreateIndex`, options, {
+                    headers: this.headers,
+                });
+                return { data: data || {}, error: null };
+            }
+            catch (error) {
+                if (this.shouldThrowOnError) {
+                    throw error;
+                }
+                if (isStorageVectorsError(error)) {
+                    return { data: null, error };
+                }
+                throw error;
+            }
+        });
+    }
+    /**
+     * Retrieves metadata for a specific vector index
+     * Returns index configuration including dimension, distance metric, and metadata settings
+     *
+     * @param vectorBucketName - Name of the parent vector bucket
+     * @param indexName - Name of the index to retrieve
+     * @returns Promise with index metadata or error
+     *
+     * @throws {StorageVectorsApiError} With code:
+     * - `S3VectorNotFoundException` if index or bucket doesn't exist (HTTP 404)
+     * - `InternalError` for server errors (HTTP 500)
+     *
+     * @example
+     * ```typescript
+     * const { data, error } = await client.getIndex('embeddings-prod', 'documents-openai-small')
+     * if (data) {
+     *   console.log('Index dimension:', data.index.dimension)
+     *   console.log('Distance metric:', data.index.distanceMetric)
+     * }
+     * ```
+     */
+    getIndex(vectorBucketName, indexName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const data = yield post(this.fetch, `${this.url}/GetIndex`, { vectorBucketName, indexName }, { headers: this.headers });
+                return { data, error: null };
+            }
+            catch (error) {
+                if (this.shouldThrowOnError) {
+                    throw error;
+                }
+                if (isStorageVectorsError(error)) {
+                    return { data: null, error };
+                }
+                throw error;
+            }
+        });
+    }
+    /**
+     * Lists vector indexes within a bucket with optional filtering and pagination
+     * Supports prefix-based filtering and paginated results
+     *
+     * @param options - Listing options
+     * @param options.vectorBucketName - Name of the parent vector bucket
+     * @param options.prefix - Filter indexes by name prefix
+     * @param options.maxResults - Maximum results per page (default: 100)
+     * @param options.nextToken - Pagination token from previous response
+     * @returns Promise with list of indexes and pagination token
+     *
+     * @throws {StorageVectorsApiError} With code:
+     * - `S3VectorNotFoundException` if bucket doesn't exist (HTTP 404)
+     * - `InternalError` for server errors (HTTP 500)
+     *
+     * @example
+     * ```typescript
+     * // List all indexes in a bucket
+     * const { data, error } = await client.listIndexes({
+     *   vectorBucketName: 'embeddings-prod',
+     *   prefix: 'documents-'
+     * })
+     * if (data) {
+     *   console.log('Found indexes:', data.indexes.map(i => i.indexName))
+     *   // Fetch next page if available
+     *   if (data.nextToken) {
+     *     const next = await client.listIndexes({
+     *       vectorBucketName: 'embeddings-prod',
+     *       nextToken: data.nextToken
+     *     })
+     *   }
+     * }
+     * ```
+     */
+    listIndexes(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const data = yield post(this.fetch, `${this.url}/ListIndexes`, options, {
+                    headers: this.headers,
+                });
+                return { data, error: null };
+            }
+            catch (error) {
+                if (this.shouldThrowOnError) {
+                    throw error;
+                }
+                if (isStorageVectorsError(error)) {
+                    return { data: null, error };
+                }
+                throw error;
+            }
+        });
+    }
+    /**
+     * Deletes a vector index and all its data
+     * This operation removes the index schema and all vectors stored in the index
+     *
+     * @param vectorBucketName - Name of the parent vector bucket
+     * @param indexName - Name of the index to delete
+     * @returns Promise with empty response on success or error
+     *
+     * @throws {StorageVectorsApiError} With code:
+     * - `S3VectorNotFoundException` if index or bucket doesn't exist (HTTP 404)
+     * - `InternalError` for server errors (HTTP 500)
+     *
+     * @example
+     * ```typescript
+     * // Delete an index and all its vectors
+     * const { error } = await client.deleteIndex('embeddings-prod', 'old-index')
+     * if (!error) {
+     *   console.log('Index deleted successfully')
+     * }
+     * ```
+     */
+    deleteIndex(vectorBucketName, indexName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const data = yield post(this.fetch, `${this.url}/DeleteIndex`, { vectorBucketName, indexName }, { headers: this.headers });
+                return { data: data || {}, error: null };
+            }
+            catch (error) {
+                if (this.shouldThrowOnError) {
+                    throw error;
+                }
+                if (isStorageVectorsError(error)) {
+                    return { data: null, error };
+                }
+                throw error;
+            }
+        });
+    }
+}
+//# sourceMappingURL=VectorIndexApi.js.map

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

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

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

@@ -0,0 +1,5 @@
+export declare const DEFAULT_HEADERS: {
+    'X-Client-Info': string;
+    'Content-Type': string;
+};
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/lib/vectors/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,eAAe;;;CAG3B,CAAA"}

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

@@ -0,0 +1,6 @@
+import { version } from '../version';
+export const DEFAULT_HEADERS = {
+    'X-Client-Info': `storage-js/${version}`,
+    'Content-Type': 'application/json',
+};
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/lib/vectors/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,eAAe,EAAE,cAAc,OAAO,EAAE;IACxC,cAAc,EAAE,kBAAkB;CACnC,CAAA"}

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

@@ -0,0 +1,55 @@
+/**
+ * Base error class for all Storage Vectors errors
+ */
+export declare class StorageVectorsError extends Error {
+    protected __isStorageVectorsError: boolean;
+    constructor(message: string);
+}
+/**
+ * Type guard to check if an error is a StorageVectorsError
+ * @param error - The error to check
+ * @returns True if the error is a StorageVectorsError
+ */
+export declare function isStorageVectorsError(error: unknown): error is StorageVectorsError;
+/**
+ * API error returned from S3 Vectors service
+ * Includes HTTP status code and service-specific error code
+ */
+export declare class StorageVectorsApiError extends StorageVectorsError {
+    status: number;
+    statusCode: string;
+    constructor(message: string, status: number, statusCode: string);
+    toJSON(): {
+        name: string;
+        message: string;
+        status: number;
+        statusCode: string;
+    };
+}
+/**
+ * Unknown error that doesn't match expected error patterns
+ * Wraps the original error for debugging
+ */
+export declare class StorageVectorsUnknownError extends StorageVectorsError {
+    originalError: unknown;
+    constructor(message: string, originalError: unknown);
+}
+/**
+ * Error codes specific to S3 Vectors API
+ * Maps AWS service errors to application-friendly error codes
+ */
+export declare enum StorageVectorsErrorCode {
+    /** Internal server fault (HTTP 500) */
+    InternalError = "InternalError",
+    /** Resource already exists / conflict (HTTP 409) */
+    S3VectorConflictException = "S3VectorConflictException",
+    /** Resource not found (HTTP 404) */
+    S3VectorNotFoundException = "S3VectorNotFoundException",
+    /** Delete bucket while not empty (HTTP 400) */
+    S3VectorBucketNotEmpty = "S3VectorBucketNotEmpty",
+    /** Exceeds bucket quota/limit (HTTP 400) */
+    S3VectorMaxBucketsExceeded = "S3VectorMaxBucketsExceeded",
+    /** Exceeds index quota/limit (HTTP 400) */
+    S3VectorMaxIndexesExceeded = "S3VectorMaxIndexesExceeded"
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/lib/vectors/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAS,CAAC,uBAAuB,UAAO;gBAE5B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAElF;AAED;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,mBAAmB;IAC7D,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;gBAEN,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAO/D,MAAM;;;;;;CAQP;AAED;;;GAGG;AACH,qBAAa,0BAA2B,SAAQ,mBAAmB;IACjE,aAAa,EAAE,OAAO,CAAA;gBAEV,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO;CAKpD;AAED;;;GAGG;AACH,oBAAY,uBAAuB;IACjC,uCAAuC;IACvC,aAAa,kBAAkB;IAC/B,oDAAoD;IACpD,yBAAyB,8BAA8B;IACvD,oCAAoC;IACpC,yBAAyB,8BAA8B;IACvD,+CAA+C;IAC/C,sBAAsB,2BAA2B;IACjD,4CAA4C;IAC5C,0BAA0B,+BAA+B;IACzD,2CAA2C;IAC3C,0BAA0B,+BAA+B;CAC1D"}

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

@@ -0,0 +1,69 @@
+/**
+ * Base error class for all Storage Vectors errors
+ */
+export class StorageVectorsError extends Error {
+    constructor(message) {
+        super(message);
+        this.__isStorageVectorsError = true;
+        this.name = 'StorageVectorsError';
+    }
+}
+/**
+ * Type guard to check if an error is a StorageVectorsError
+ * @param error - The error to check
+ * @returns True if the error is a StorageVectorsError
+ */
+export function isStorageVectorsError(error) {
+    return typeof error === 'object' && error !== null && '__isStorageVectorsError' in error;
+}
+/**
+ * API error returned from S3 Vectors service
+ * Includes HTTP status code and service-specific error code
+ */
+export class StorageVectorsApiError extends StorageVectorsError {
+    constructor(message, status, statusCode) {
+        super(message);
+        this.name = 'StorageVectorsApiError';
+        this.status = status;
+        this.statusCode = statusCode;
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            status: this.status,
+            statusCode: this.statusCode,
+        };
+    }
+}
+/**
+ * Unknown error that doesn't match expected error patterns
+ * Wraps the original error for debugging
+ */
+export class StorageVectorsUnknownError extends StorageVectorsError {
+    constructor(message, originalError) {
+        super(message);
+        this.name = 'StorageVectorsUnknownError';
+        this.originalError = originalError;
+    }
+}
+/**
+ * Error codes specific to S3 Vectors API
+ * Maps AWS service errors to application-friendly error codes
+ */
+export var StorageVectorsErrorCode;
+(function (StorageVectorsErrorCode) {
+    /** Internal server fault (HTTP 500) */
+    StorageVectorsErrorCode["InternalError"] = "InternalError";
+    /** Resource already exists / conflict (HTTP 409) */
+    StorageVectorsErrorCode["S3VectorConflictException"] = "S3VectorConflictException";
+    /** Resource not found (HTTP 404) */
+    StorageVectorsErrorCode["S3VectorNotFoundException"] = "S3VectorNotFoundException";
+    /** Delete bucket while not empty (HTTP 400) */
+    StorageVectorsErrorCode["S3VectorBucketNotEmpty"] = "S3VectorBucketNotEmpty";
+    /** Exceeds bucket quota/limit (HTTP 400) */
+    StorageVectorsErrorCode["S3VectorMaxBucketsExceeded"] = "S3VectorMaxBucketsExceeded";
+    /** Exceeds index quota/limit (HTTP 400) */
+    StorageVectorsErrorCode["S3VectorMaxIndexesExceeded"] = "S3VectorMaxIndexesExceeded";
+})(StorageVectorsErrorCode || (StorageVectorsErrorCode = {}));
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/lib/vectors/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAG5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QAHN,4BAAuB,GAAG,IAAI,CAAA;QAItC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,yBAAyB,IAAI,KAAK,CAAA;AAC1F,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,sBAAuB,SAAQ,mBAAmB;IAI7D,YAAY,OAAe,EAAE,MAAc,EAAE,UAAkB;QAC7D,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAA;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAA;IACH,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,0BAA2B,SAAQ,mBAAmB;IAGjE,YAAY,OAAe,EAAE,aAAsB;QACjD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAA;QACxC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAA;IACpC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,uBAaX;AAbD,WAAY,uBAAuB;IACjC,uCAAuC;IACvC,0DAA+B,CAAA;IAC/B,oDAAoD;IACpD,kFAAuD,CAAA;IACvD,oCAAoC;IACpC,kFAAuD,CAAA;IACvD,+CAA+C;IAC/C,4EAAiD,CAAA;IACjD,4CAA4C;IAC5C,oFAAyD,CAAA;IACzD,2CAA2C;IAC3C,oFAAyD,CAAA;AAC3D,CAAC,EAbW,uBAAuB,KAAvB,uBAAuB,QAalC"}

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

@@ -0,0 +1,57 @@
+import { VectorFetchParameters } from './types';
+export type Fetch = typeof fetch;
+/**
+ * Options for fetch requests
+ * @property headers - Custom HTTP headers
+ * @property noResolveJson - If true, return raw Response instead of parsing JSON
+ */
+export interface FetchOptions {
+    headers?: {
+        [key: string]: string;
+    };
+    noResolveJson?: boolean;
+}
+/**
+ * HTTP methods supported by the API
+ */
+export type RequestMethodType = 'GET' | 'POST' | 'PUT' | 'DELETE';
+/**
+ * Performs a GET request
+ * @param fetcher - Fetch function to use
+ * @param url - Request URL
+ * @param options - Custom fetch options
+ * @param parameters - Additional fetch parameters
+ * @returns Promise with parsed response
+ */
+export declare function get(fetcher: Fetch, url: string, options?: FetchOptions, parameters?: VectorFetchParameters): Promise<any>;
+/**
+ * Performs a POST request
+ * @param fetcher - Fetch function to use
+ * @param url - Request URL
+ * @param body - Request body to be JSON stringified
+ * @param options - Custom fetch options
+ * @param parameters - Additional fetch parameters
+ * @returns Promise with parsed response
+ */
+export declare function post(fetcher: Fetch, url: string, body: object, options?: FetchOptions, parameters?: VectorFetchParameters): Promise<any>;
+/**
+ * Performs a PUT request
+ * @param fetcher - Fetch function to use
+ * @param url - Request URL
+ * @param body - Request body to be JSON stringified
+ * @param options - Custom fetch options
+ * @param parameters - Additional fetch parameters
+ * @returns Promise with parsed response
+ */
+export declare function put(fetcher: Fetch, url: string, body: object, options?: FetchOptions, parameters?: VectorFetchParameters): Promise<any>;
+/**
+ * Performs a DELETE request
+ * @param fetcher - Fetch function to use
+ * @param url - Request URL
+ * @param body - Request body to be JSON stringified
+ * @param options - Custom fetch options
+ * @param parameters - Additional fetch parameters
+ * @returns Promise with parsed response
+ */
+export declare function remove(fetcher: Fetch, url: string, body: object, options?: FetchOptions, parameters?: VectorFetchParameters): Promise<any>;
+//# sourceMappingURL=fetch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../../src/lib/vectors/fetch.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAE/C,MAAM,MAAM,KAAK,GAAG,OAAO,KAAK,CAAA;AAEhC;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE;QACR,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KACtB,CAAA;IACD,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAA;AA4HjE;;;;;;;GAOG;AACH,wBAAsB,GAAG,CACvB,OAAO,EAAE,KAAK,EACd,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,YAAY,EACtB,UAAU,CAAC,EAAE,qBAAqB,GACjC,OAAO,CAAC,GAAG,CAAC,CAEd;AAED;;;;;;;;GAQG;AACH,wBAAsB,IAAI,CACxB,OAAO,EAAE,KAAK,EACd,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,YAAY,EACtB,UAAU,CAAC,EAAE,qBAAqB,GACjC,OAAO,CAAC,GAAG,CAAC,CAEd;AAED;;;;;;;;GAQG;AACH,wBAAsB,GAAG,CACvB,OAAO,EAAE,KAAK,EACd,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,YAAY,EACtB,UAAU,CAAC,EAAE,qBAAqB,GACjC,OAAO,CAAC,GAAG,CAAC,CAEd;AAED;;;;;;;;GAQG;AACH,wBAAsB,MAAM,CAC1B,OAAO,EAAE,KAAK,EACd,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,YAAY,EACtB,UAAU,CAAC,EAAE,qBAAqB,GACjC,OAAO,CAAC,GAAG,CAAC,CAEd"}