@ductape/sdk 0.0.4-v6 → 0.0.4-v60

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

@@ -0,0 +1,137 @@
+"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;
+    }
+    /**
+     * Get connected status
+     */
+    get connected() {
+        return this._connected;
+    }
+    /**
+     * 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":"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"}

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;