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

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

@@ -0,0 +1,218 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const constants_1 = require("./constants");
+const errors_1 = require("./errors");
+const fetch_1 = require("./fetch");
+const helpers_1 = require("./helpers");
+/**
+ * API class for managing Vector Indexes within Vector Buckets
+ * Provides methods for creating, reading, listing, and deleting vector indexes
+ */
+class VectorIndexApi {
+    constructor(url, headers = {}, fetch) {
+        this.shouldThrowOnError = false;
+        this.url = url.replace(/\/$/, '');
+        this.headers = Object.assign(Object.assign({}, constants_1.DEFAULT_HEADERS), headers);
+        this.fetch = (0, helpers_1.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 tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                const data = yield (0, fetch_1.post)(this.fetch, `${this.url}/CreateIndex`, options, {
+                    headers: this.headers,
+                });
+                return { data: data || {}, error: null };
+            }
+            catch (error) {
+                if (this.shouldThrowOnError) {
+                    throw error;
+                }
+                if ((0, errors_1.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 tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                const data = yield (0, fetch_1.post)(this.fetch, `${this.url}/GetIndex`, { vectorBucketName, indexName }, { headers: this.headers });
+                return { data, error: null };
+            }
+            catch (error) {
+                if (this.shouldThrowOnError) {
+                    throw error;
+                }
+                if ((0, errors_1.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 tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                const data = yield (0, fetch_1.post)(this.fetch, `${this.url}/ListIndexes`, options, {
+                    headers: this.headers,
+                });
+                return { data, error: null };
+            }
+            catch (error) {
+                if (this.shouldThrowOnError) {
+                    throw error;
+                }
+                if ((0, errors_1.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 tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                const data = yield (0, fetch_1.post)(this.fetch, `${this.url}/DeleteIndex`, { vectorBucketName, indexName }, { headers: this.headers });
+                return { data: data || {}, error: null };
+            }
+            catch (error) {
+                if (this.shouldThrowOnError) {
+                    throw error;
+                }
+                if ((0, errors_1.isStorageVectorsError)(error)) {
+                    return { data: null, error };
+                }
+                throw error;
+            }
+        });
+    }
+}
+exports.default = VectorIndexApi;
+//# sourceMappingURL=VectorIndexApi.js.map

package/dist/main/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/main/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/main/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/main/lib/vectors/constants.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_HEADERS = void 0;
+const version_1 = require("../version");
+exports.DEFAULT_HEADERS = {
+    'X-Client-Info': `storage-js/${version_1.version}`,
+    'Content-Type': 'application/json',
+};
+//# sourceMappingURL=constants.js.map

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

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

package/dist/main/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/main/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/main/lib/vectors/errors.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageVectorsErrorCode = exports.StorageVectorsUnknownError = exports.StorageVectorsApiError = exports.StorageVectorsError = void 0;
+exports.isStorageVectorsError = isStorageVectorsError;
+/**
+ * Base error class for all Storage Vectors errors
+ */
+class StorageVectorsError extends Error {
+    constructor(message) {
+        super(message);
+        this.__isStorageVectorsError = true;
+        this.name = 'StorageVectorsError';
+    }
+}
+exports.StorageVectorsError = 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
+ */
+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
+ */
+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,
+        };
+    }
+}
+exports.StorageVectorsApiError = StorageVectorsApiError;
+/**
+ * Unknown error that doesn't match expected error patterns
+ * Wraps the original error for debugging
+ */
+class StorageVectorsUnknownError extends StorageVectorsError {
+    constructor(message, originalError) {
+        super(message);
+        this.name = 'StorageVectorsUnknownError';
+        this.originalError = originalError;
+    }
+}
+exports.StorageVectorsUnknownError = StorageVectorsUnknownError;
+/**
+ * Error codes specific to S3 Vectors API
+ * Maps AWS service errors to application-friendly error codes
+ */
+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 || (exports.StorageVectorsErrorCode = StorageVectorsErrorCode = {}));
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/lib/vectors/errors.ts"],"names":[],"mappings":";;;AAiBA,sDAEC;AAnBD;;GAEG;AACH,MAAa,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;AAPD,kDAOC;AAED;;;;GAIG;AACH,SAAgB,qBAAqB,CAAC,KAAc;IAClD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,yBAAyB,IAAI,KAAK,CAAA;AAC1F,CAAC;AAED;;;GAGG;AACH,MAAa,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;AAnBD,wDAmBC;AAED;;;GAGG;AACH,MAAa,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;AARD,gEAQC;AAED;;;GAGG;AACH,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,uCAAvB,uBAAuB,QAalC"}

package/dist/main/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/main/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"}

package/dist/main/lib/vectors/fetch.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.get = get;
+exports.post = post;
+exports.put = put;
+exports.remove = remove;
+const tslib_1 = require("tslib");
+const errors_1 = require("./errors");
+const helpers_1 = require("./helpers");
+/**
+ * Extracts error message from various error response formats
+ * @param err - Error object from API
+ * @returns Human-readable error message
+ */
+const _getErrorMessage = (err) => err.msg || err.message || err.error_description || err.error || JSON.stringify(err);
+/**
+ * Handles fetch errors and converts them to StorageVectors error types
+ * @param error - The error caught from fetch
+ * @param reject - Promise rejection function
+ * @param options - Fetch options that may affect error handling
+ */
+const handleError = (error, reject, options) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    // Check if error is a Response-like object (has status and ok properties)
+    // This is more reliable than instanceof which can fail across realms
+    const isResponseLike = error &&
+        typeof error === 'object' &&
+        'status' in error &&
+        'ok' in error &&
+        typeof error.status === 'number';
+    if (isResponseLike && !(options === null || options === void 0 ? void 0 : options.noResolveJson)) {
+        const status = error.status || 500;
+        const responseError = error;
+        // Try to parse JSON body if available
+        if (typeof responseError.json === 'function') {
+            responseError
+                .json()
+                .then((err) => {
+                const statusCode = (err === null || err === void 0 ? void 0 : err.statusCode) || (err === null || err === void 0 ? void 0 : err.code) || status + '';
+                reject(new errors_1.StorageVectorsApiError(_getErrorMessage(err), status, statusCode));
+            })
+                .catch(() => {
+                // If JSON parsing fails, create an ApiError with the HTTP status code
+                const statusCode = status + '';
+                const message = responseError.statusText || `HTTP ${status} error`;
+                reject(new errors_1.StorageVectorsApiError(message, status, statusCode));
+            });
+        }
+        else {
+            // No json() method available, create error from status
+            const statusCode = status + '';
+            const message = responseError.statusText || `HTTP ${status} error`;
+            reject(new errors_1.StorageVectorsApiError(message, status, statusCode));
+        }
+    }
+    else {
+        reject(new errors_1.StorageVectorsUnknownError(_getErrorMessage(error), error));
+    }
+});
+/**
+ * Builds request parameters for fetch calls
+ * @param method - HTTP method
+ * @param options - Custom fetch options
+ * @param parameters - Additional fetch parameters like AbortSignal
+ * @param body - Request body (will be JSON stringified if plain object)
+ * @returns Complete fetch request parameters
+ */
+const _getRequestParams = (method, options, parameters, body) => {
+    const params = { method, headers: (options === null || options === void 0 ? void 0 : options.headers) || {} };
+    if (method === 'GET' || !body) {
+        return params;
+    }
+    if ((0, helpers_1.isPlainObject)(body)) {
+        params.headers = Object.assign({ 'Content-Type': 'application/json' }, options === null || options === void 0 ? void 0 : options.headers);
+        params.body = JSON.stringify(body);
+    }
+    else {
+        params.body = body;
+    }
+    return Object.assign(Object.assign({}, params), parameters);
+};
+/**
+ * Internal request handler that wraps fetch with error handling
+ * @param fetcher - Fetch function to use
+ * @param method - HTTP method
+ * @param url - Request URL
+ * @param options - Custom fetch options
+ * @param parameters - Additional fetch parameters
+ * @param body - Request body
+ * @returns Promise with parsed response or error
+ */
+function _handleRequest(fetcher, method, url, options, parameters, body) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        return new Promise((resolve, reject) => {
+            fetcher(url, _getRequestParams(method, options, parameters, body))
+                .then((result) => {
+                if (!result.ok)
+                    throw result;
+                if (options === null || options === void 0 ? void 0 : options.noResolveJson)
+                    return result;
+                // Handle empty responses (204, empty body)
+                const contentType = result.headers.get('content-type');
+                if (!contentType || !contentType.includes('application/json')) {
+                    return {};
+                }
+                return result.json();
+            })
+                .then((data) => resolve(data))
+                .catch((error) => handleError(error, reject, options));
+        });
+    });
+}
+/**
+ * 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
+ */
+function get(fetcher, url, options, parameters) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        return _handleRequest(fetcher, 'GET', url, options, parameters);
+    });
+}
+/**
+ * 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
+ */
+function post(fetcher, url, body, options, parameters) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        return _handleRequest(fetcher, 'POST', url, options, parameters, body);
+    });
+}
+/**
+ * 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
+ */
+function put(fetcher, url, body, options, parameters) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        return _handleRequest(fetcher, 'PUT', url, options, parameters, body);
+    });
+}
+/**
+ * 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
+ */
+function remove(fetcher, url, body, options, parameters) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        return _handleRequest(fetcher, 'DELETE', url, options, parameters, body);
+    });
+}
+//# sourceMappingURL=fetch.js.map

package/dist/main/lib/vectors/fetch.js.map

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