@ductape/sdk 0.0.4-v9 → 0.0.4-v91

package/dist/vector/adapters/base.adapter.js

@@ -0,0 +1,218 @@
+"use strict";
+/**
+ * Base Vector Adapter
+ *
+ * Abstract base class for vector database adapters.
+ * All adapters (Pinecone, Qdrant, Weaviate, etc.) extend this class.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseVectorAdapter = void 0;
+const types_1 = require("../types");
+/**
+ * Abstract base adapter for vector databases
+ */
+class BaseVectorAdapter {
+    constructor() {
+        /** Whether connected */
+        this._connected = false;
+        /** Connection options */
+        this.connectionOptions = null;
+        /** Maximum retry attempts for auto-reconnection */
+        this.maxRetries = 2;
+        /** Flag to indicate if a reconnection is in progress */
+        this.reconnecting = false;
+    }
+    /**
+     * Get connected status
+     */
+    get connected() {
+        return this._connected;
+    }
+    // ==================== AUTO-RECONNECTION ====================
+    /**
+     * Execute an operation with automatic retry on connection errors.
+     * This handles transient connection timeouts and disconnects silently.
+     */
+    async executeWithRetry(operation, retries = this.maxRetries) {
+        let lastError = null;
+        for (let attempt = 0; attempt <= retries; attempt++) {
+            try {
+                return await operation();
+            }
+            catch (error) {
+                lastError = error;
+                if (!this.isConnectionError(error) || attempt === retries) {
+                    throw error;
+                }
+                // Try to reconnect silently
+                try {
+                    await this.attemptReconnect();
+                }
+                catch (_a) {
+                    throw lastError;
+                }
+                // Small delay before retry (exponential backoff)
+                await new Promise(resolve => setTimeout(resolve, 500 * (attempt + 1)));
+            }
+        }
+        throw lastError || new Error('Operation failed after retries');
+    }
+    /**
+     * Check if an error is a connection-related error
+     */
+    isConnectionError(error) {
+        var _a, _b;
+        const errorCode = ((_a = error.code) === null || _a === void 0 ? void 0 : _a.toString()) || '';
+        const errorMessage = ((_b = error.message) === null || _b === void 0 ? void 0 : _b.toLowerCase()) || '';
+        return (errorCode === 'ECONNRESET' ||
+            errorCode === 'ETIMEDOUT' ||
+            errorCode === 'ENOTFOUND' ||
+            errorCode === 'ECONNREFUSED' ||
+            errorCode === 'EPIPE' ||
+            errorMessage.includes('connection terminated') ||
+            errorMessage.includes('connection timeout') ||
+            errorMessage.includes('connection refused') ||
+            errorMessage.includes('connection lost') ||
+            errorMessage.includes('socket hang up') ||
+            errorMessage.includes('econnreset') ||
+            errorMessage.includes('network error') ||
+            errorMessage.includes('fetch failed'));
+    }
+    /**
+     * Attempt to reconnect to the vector database
+     */
+    async attemptReconnect() {
+        if (this.reconnecting) {
+            await new Promise(resolve => setTimeout(resolve, 1000));
+            if (this._connected)
+                return;
+            throw new Error('Reconnection already in progress');
+        }
+        if (!this.connectionOptions) {
+            throw new Error('Cannot reconnect: no connection options available');
+        }
+        this.reconnecting = true;
+        try {
+            try {
+                await this.disconnect();
+            }
+            catch (_a) {
+                // Ignore disconnect errors
+            }
+            await this.connect(this.connectionOptions);
+        }
+        finally {
+            this.reconnecting = false;
+        }
+    }
+    /**
+     * Get current namespace
+     */
+    get namespace() {
+        var _a;
+        return (_a = this.connectionOptions) === null || _a === void 0 ? void 0 : _a.namespace;
+    }
+    /**
+     * Get configured dimensions
+     */
+    get dimensions() {
+        var _a;
+        return ((_a = this.connectionOptions) === null || _a === void 0 ? void 0 : _a.dimensions) || 0;
+    }
+    /**
+     * Get configured metric
+     */
+    get metric() {
+        var _a;
+        return ((_a = this.connectionOptions) === null || _a === void 0 ? void 0 : _a.metric) || types_1.DistanceMetric.COSINE;
+    }
+    // ==================== UTILITY METHODS ====================
+    /**
+     * Validate vector dimensions
+     */
+    validateDimensions(vectors) {
+        const expectedDim = this.dimensions;
+        for (const vector of vectors) {
+            if (vector.values.length !== expectedDim) {
+                throw new Error(`Dimension mismatch: expected ${expectedDim}, got ${vector.values.length} for vector ${vector.id}`);
+            }
+        }
+    }
+    /**
+     * Normalize a vector to unit length (for cosine similarity)
+     */
+    normalizeVector(vector) {
+        const magnitude = Math.sqrt(vector.reduce((sum, v) => sum + v * v, 0));
+        if (magnitude === 0)
+            return vector;
+        return vector.map((v) => v / magnitude);
+    }
+    /**
+     * Calculate cosine similarity between two vectors
+     */
+    cosineSimilarity(a, b) {
+        if (a.length !== b.length)
+            return 0;
+        let dotProduct = 0;
+        let normA = 0;
+        let normB = 0;
+        for (let i = 0; i < a.length; i++) {
+            dotProduct += a[i] * b[i];
+            normA += a[i] * a[i];
+            normB += b[i] * b[i];
+        }
+        const magnitude = Math.sqrt(normA) * Math.sqrt(normB);
+        return magnitude === 0 ? 0 : dotProduct / magnitude;
+    }
+    /**
+     * Calculate Euclidean distance between two vectors
+     */
+    euclideanDistance(a, b) {
+        if (a.length !== b.length)
+            return Infinity;
+        let sum = 0;
+        for (let i = 0; i < a.length; i++) {
+            const diff = a[i] - b[i];
+            sum += diff * diff;
+        }
+        return Math.sqrt(sum);
+    }
+    /**
+     * Calculate dot product between two vectors
+     */
+    dotProduct(a, b) {
+        if (a.length !== b.length)
+            return 0;
+        let sum = 0;
+        for (let i = 0; i < a.length; i++) {
+            sum += a[i] * b[i];
+        }
+        return sum;
+    }
+    /**
+     * Calculate similarity based on configured metric
+     */
+    calculateSimilarity(a, b) {
+        switch (this.metric) {
+            case types_1.DistanceMetric.COSINE:
+                return this.cosineSimilarity(a, b);
+            case types_1.DistanceMetric.EUCLIDEAN:
+                // Convert distance to similarity (inverse, bounded 0-1)
+                const dist = this.euclideanDistance(a, b);
+                return 1 / (1 + dist);
+            case types_1.DistanceMetric.DOT_PRODUCT:
+                return this.dotProduct(a, b);
+            default:
+                return this.cosineSimilarity(a, b);
+        }
+    }
+    /**
+     * Generate a unique ID
+     */
+    generateId() {
+        return `vec_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+    }
+}
+exports.BaseVectorAdapter = BaseVectorAdapter;
+exports.default = BaseVectorAdapter;
+//# sourceMappingURL=base.adapter.js.map

package/dist/vector/adapters/base.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.adapter.js","sourceRoot":"","sources":["../../../src/vector/adapters/base.adapter.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,oCAyBkB;AAwBlB;;GAEG;AACH,MAAsB,iBAAiB;IAAvC;QAIE,wBAAwB;QACd,eAAU,GAAY,KAAK,CAAC;QAEtC,yBAAyB;QACf,sBAAiB,GAAqC,IAAI,CAAC;QAErE,mDAAmD;QACzC,eAAU,GAAW,CAAC,CAAC;QAEjC,wDAAwD;QAChD,iBAAY,GAAY,KAAK,CAAC;IAyTxC,CAAC;IAvTC;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,8DAA8D;IAE9D;;;OAGG;IACO,KAAK,CAAC,gBAAgB,CAC9B,SAA2B,EAC3B,UAAkB,IAAI,CAAC,UAAU;QAEjC,IAAI,SAAS,GAAiB,IAAI,CAAC;QAEnC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;YACpD,IAAI,CAAC;gBACH,OAAO,MAAM,SAAS,EAAE,CAAC;YAC3B,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,SAAS,GAAG,KAAK,CAAC;gBAElB,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;oBAC1D,MAAM,KAAK,CAAC;gBACd,CAAC;gBAED,4BAA4B;gBAC5B,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBAChC,CAAC;gBAAC,WAAM,CAAC;oBACP,MAAM,SAAS,CAAC;gBAClB,CAAC;gBAED,iDAAiD;gBACjD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;QAED,MAAM,SAAS,IAAI,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACO,iBAAiB,CAAC,KAAU;;QACpC,MAAM,SAAS,GAAG,CAAA,MAAA,KAAK,CAAC,IAAI,0CAAE,QAAQ,EAAE,KAAI,EAAE,CAAC;QAC/C,MAAM,YAAY,GAAG,CAAA,MAAA,KAAK,CAAC,OAAO,0CAAE,WAAW,EAAE,KAAI,EAAE,CAAC;QAExD,OAAO,CACL,SAAS,KAAK,YAAY;YAC1B,SAAS,KAAK,WAAW;YACzB,SAAS,KAAK,WAAW;YACzB,SAAS,KAAK,cAAc;YAC5B,SAAS,KAAK,OAAO;YACrB,YAAY,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YAC9C,YAAY,CAAC,QAAQ,CAAC,oBAAoB,CAAC;YAC3C,YAAY,CAAC,QAAQ,CAAC,oBAAoB,CAAC;YAC3C,YAAY,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YACxC,YAAY,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YACvC,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC;YACnC,YAAY,CAAC,QAAQ,CAAC,eAAe,CAAC;YACtC,YAAY,CAAC,QAAQ,CAAC,cAAc,CAAC,CACtC,CAAC;IACJ,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,gBAAgB;QAC9B,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;YACxD,IAAI,IAAI,CAAC,UAAU;gBAAE,OAAO;YAC5B,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAEzB,IAAI,CAAC;YACH,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;YAC1B,CAAC;YAAC,WAAM,CAAC;gBACP,2BAA2B;YAC7B,CAAC;YAED,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC7C,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC5B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;;QACX,OAAO,MAAA,IAAI,CAAC,iBAAiB,0CAAE,SAAS,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;;QACZ,OAAO,CAAA,MAAA,IAAI,CAAC,iBAAiB,0CAAE,UAAU,KAAI,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;;QACR,OAAO,CAAA,MAAA,IAAI,CAAC,iBAAiB,0CAAE,MAAM,KAAI,sBAAc,CAAC,MAAM,CAAC;IACjE,CAAC;IAiGD,4DAA4D;IAE5D;;OAEG;IACO,kBAAkB,CAAC,OAAkB;QAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC;QACpC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBACzC,MAAM,IAAI,KAAK,CACb,gCAAgC,WAAW,SAAS,MAAM,CAAC,MAAM,CAAC,MAAM,eAAe,MAAM,CAAC,EAAE,EAAE,CACnG,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACO,eAAe,CAAC,MAAgB;QACxC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvE,IAAI,SAAS,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC;QACnC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACO,gBAAgB,CAAC,CAAW,EAAE,CAAW;QACjD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;YAAE,OAAO,CAAC,CAAC;QAEpC,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAClC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1B,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtD,OAAO,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,SAAS,CAAC;IACtD,CAAC;IAED;;OAEG;IACO,iBAAiB,CAAC,CAAW,EAAE,CAAW;QAClD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;YAAE,OAAO,QAAQ,CAAC;QAE3C,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACzB,GAAG,IAAI,IAAI,GAAG,IAAI,CAAC;QACrB,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAED;;OAEG;IACO,UAAU,CAAC,CAAW,EAAE,CAAW;QAC3C,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;YAAE,OAAO,CAAC,CAAC;QAEpC,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAClC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;OAEG;IACO,mBAAmB,CAAC,CAAW,EAAE,CAAW;QACpD,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;YACpB,KAAK,sBAAc,CAAC,MAAM;gBACxB,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACrC,KAAK,sBAAc,CAAC,SAAS;gBAC3B,wDAAwD;gBACxD,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC1C,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YACxB,KAAK,sBAAc,CAAC,WAAW;gBAC7B,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/B;gBACE,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED;;OAEG;IACO,UAAU;QAClB,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAC3E,CAAC;CACF;AAvUD,8CAuUC;AAED,kBAAe,iBAAiB,CAAC"}

package/dist/vector/adapters/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Vector Database Adapters Index
+ *
+ * Export all vector database adapters.
+ */
+export { BaseVectorAdapter, type IAdapterConnectionOptions } from './base.adapter';
+export { PineconeAdapter } from './pinecone.adapter';
+export { QdrantAdapter } from './qdrant.adapter';
+export { WeaviateAdapter } from './weaviate.adapter';
+export { MemoryAdapter } from './memory.adapter';

package/dist/vector/adapters/index.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Vector Database Adapters Index
+ *
+ * Export all vector database adapters.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryAdapter = exports.WeaviateAdapter = exports.QdrantAdapter = exports.PineconeAdapter = exports.BaseVectorAdapter = void 0;
+var base_adapter_1 = require("./base.adapter");
+Object.defineProperty(exports, "BaseVectorAdapter", { enumerable: true, get: function () { return base_adapter_1.BaseVectorAdapter; } });
+var pinecone_adapter_1 = require("./pinecone.adapter");
+Object.defineProperty(exports, "PineconeAdapter", { enumerable: true, get: function () { return pinecone_adapter_1.PineconeAdapter; } });
+var qdrant_adapter_1 = require("./qdrant.adapter");
+Object.defineProperty(exports, "QdrantAdapter", { enumerable: true, get: function () { return qdrant_adapter_1.QdrantAdapter; } });
+var weaviate_adapter_1 = require("./weaviate.adapter");
+Object.defineProperty(exports, "WeaviateAdapter", { enumerable: true, get: function () { return weaviate_adapter_1.WeaviateAdapter; } });
+var memory_adapter_1 = require("./memory.adapter");
+Object.defineProperty(exports, "MemoryAdapter", { enumerable: true, get: function () { return memory_adapter_1.MemoryAdapter; } });
+//# sourceMappingURL=index.js.map

package/dist/vector/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/vector/adapters/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,+CAAmF;AAA1E,iHAAA,iBAAiB,OAAA;AAC1B,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AACxB,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AACxB,mDAAiD;AAAxC,+GAAA,aAAa,OAAA"}

package/dist/vector/adapters/memory.adapter.d.ts

@@ -0,0 +1,85 @@
+/**
+ * In-Memory Vector Adapter
+ *
+ * A local, in-memory vector database implementation.
+ * Perfect for development, testing, and small-scale applications.
+ */
+import { VectorDBType, DistanceMetric, VectorFeature, IVectorConnectionResult, IUpsertVectorsOptions, IUpsertVectorsResult, IQueryVectorsOptions, IQueryVectorsResult, IFetchVectorsOptions, IFetchVectorsResult, IUpdateVectorOptions, IUpdateVectorResult, IDeleteVectorsOptions, IDeleteVectorsResult, IListVectorsOptions, IListVectorsResult, IListNamespacesResult, IVectorIndexInfo, ICreateIndexOptions, ICreateIndexResult, IDeleteIndexOptions, IDeleteIndexResult, IVectorIndexStats } from '../types';
+import { BaseVectorAdapter, IAdapterConnectionOptions } from './base.adapter';
+/**
+ * Stored vector with additional metadata
+ */
+interface IStoredVector {
+    id: string;
+    values: number[];
+    metadata: Record<string, unknown>;
+    createdAt: number;
+    updatedAt: number;
+}
+/**
+ * Index configuration
+ */
+interface IIndexConfig {
+    name: string;
+    dimensions: number;
+    metric: DistanceMetric;
+    createdAt: number;
+}
+/**
+ * In-memory vector adapter implementation
+ */
+export declare class MemoryAdapter extends BaseVectorAdapter {
+    readonly type = VectorDBType.MEMORY;
+    /** Storage: indexName -> namespace -> vectorId -> vector */
+    private storage;
+    /** Index configurations */
+    private indexes;
+    /** Current index name */
+    private currentIndex;
+    /** Default namespace */
+    private defaultNamespace;
+    connect(options: IAdapterConnectionOptions): Promise<IVectorConnectionResult>;
+    disconnect(): Promise<void>;
+    testConnection(): Promise<boolean>;
+    upsert(options: IUpsertVectorsOptions): Promise<IUpsertVectorsResult>;
+    query(options: IQueryVectorsOptions): Promise<IQueryVectorsResult>;
+    fetch(options: IFetchVectorsOptions): Promise<IFetchVectorsResult>;
+    update(options: IUpdateVectorOptions): Promise<IUpdateVectorResult>;
+    delete(options: IDeleteVectorsOptions): Promise<IDeleteVectorsResult>;
+    list(options: IListVectorsOptions): Promise<IListVectorsResult>;
+    listNamespaces(): Promise<IListNamespacesResult>;
+    deleteNamespace(namespace: string): Promise<void>;
+    describeIndex(): Promise<IVectorIndexInfo>;
+    getIndexStats(): Promise<IVectorIndexStats>;
+    createIndex(options: ICreateIndexOptions): Promise<ICreateIndexResult>;
+    deleteIndex(options: IDeleteIndexOptions): Promise<IDeleteIndexResult>;
+    listIndexes(): Promise<IVectorIndexInfo[]>;
+    supportsFeature(feature: VectorFeature): boolean;
+    /**
+     * Clear all data (useful for testing)
+     */
+    clear(): void;
+    /**
+     * Export all data as JSON (for persistence)
+     */
+    export(): {
+        indexes: Array<IIndexConfig>;
+        data: Record<string, Record<string, IStoredVector[]>>;
+    };
+    /**
+     * Import data from JSON (for persistence)
+     */
+    import(data: {
+        indexes: Array<IIndexConfig>;
+        data: Record<string, Record<string, IStoredVector[]>>;
+    }): void;
+    /**
+     * Get total memory usage estimate (bytes)
+     */
+    getMemoryUsage(): number;
+    /**
+     * Check if metadata matches a filter
+     */
+    private matchesFilter;
+}
+export default MemoryAdapter;