ruvector 0.1.34 → 0.1.35

package/.claude-flow/metrics/performance.json

@@ -1,7 +1,7 @@
 {
-  "startTime": 1765249648027,
-  "sessionId": "session-1765249648027",
-  "lastActivity": 1765249648027,
+  "startTime": 1765639811138,
+  "sessionId": "session-1765639811138",
+  "lastActivity": 1765639811138,
   "sessionDuration": 0,
   "totalTasks": 1,
   "successfulTasks": 1,

package/.claude-flow/metrics/task-metrics.json

@@ -1,10 +1,10 @@
 [
   {
-    "id": "cmd-hooks-1765249648131",
+    "id": "cmd-hooks-1765639811246",
     "type": "hooks",
     "success": true,
-    "duration": 7.553539000000001,
-    "timestamp": 1765249648139,
+    "duration": 7.567385000000002,
+    "timestamp": 1765639811254,
     "metadata": {}
   }
 ]

package/dist/index.d.ts

@@ -31,7 +31,70 @@ export declare function getVersion(): {
     version: string;
     implementation: string;
 };
-export declare const VectorDb: any;
-export declare const VectorDB: any;
+/**
+ * Wrapper class that automatically handles metadata JSON conversion
+ */
+declare class VectorDBWrapper {
+    private db;
+    constructor(options: {
+        dimensions: number;
+        storagePath?: string;
+        distanceMetric?: string;
+        hnswConfig?: any;
+    });
+    /**
+     * Insert a vector with optional metadata (objects are auto-converted to JSON)
+     */
+    insert(entry: {
+        id?: string;
+        vector: Float32Array | number[];
+        metadata?: Record<string, any>;
+    }): Promise<string>;
+    /**
+     * Insert multiple vectors in batch
+     */
+    insertBatch(entries: Array<{
+        id?: string;
+        vector: Float32Array | number[];
+        metadata?: Record<string, any>;
+    }>): Promise<string[]>;
+    /**
+     * Search for similar vectors (metadata is auto-parsed from JSON)
+     */
+    search(query: {
+        vector: Float32Array | number[];
+        k: number;
+        filter?: Record<string, any>;
+        efSearch?: number;
+    }): Promise<Array<{
+        id: string;
+        score: number;
+        vector?: Float32Array;
+        metadata?: Record<string, any>;
+    }>>;
+    /**
+     * Get a vector by ID (metadata is auto-parsed from JSON)
+     */
+    get(id: string): Promise<{
+        id?: string;
+        vector: Float32Array;
+        metadata?: Record<string, any>;
+    } | null>;
+    /**
+     * Delete a vector by ID
+     */
+    delete(id: string): Promise<boolean>;
+    /**
+     * Get the number of vectors in the database
+     */
+    len(): Promise<number>;
+    /**
+     * Check if the database is empty
+     */
+    isEmpty(): Promise<boolean>;
+}
+export declare const VectorDb: typeof VectorDBWrapper;
+export declare const VectorDB: typeof VectorDBWrapper;
+export declare const NativeVectorDb: any;
 export default implementation;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,SAAS,CAAC;AAGxB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAE3B,QAAA,IAAI,cAAc,EAAE,GAAG,CAAC;AA0BxB;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,QAAQ,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAElC;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,OAAO,CAEhC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAMxE;AAGD,eAAO,MAAM,QAAQ,KAA0B,CAAC;AAChD,eAAO,MAAM,QAAQ,KAA0B,CAAC;AAGhD,eAAe,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,SAAS,CAAC;AAGxB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAE3B,QAAA,IAAI,cAAc,EAAE,GAAG,CAAC;AA0BxB;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,QAAQ,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAElC;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,OAAO,CAEhC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAMxE;AAED;;GAEG;AACH,cAAM,eAAe;IACnB,OAAO,CAAC,EAAE,CAAM;gBAEJ,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,GAAG,CAAA;KAAE;IAI5G;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IActH;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAUtI;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAC,CAAC;IAuB1N;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAW5G;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1C;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;CAGlC;AAGD,eAAO,MAAM,QAAQ,wBAAkB,CAAC;AACxC,eAAO,MAAM,QAAQ,wBAAkB,CAAC;AAGxC,eAAO,MAAM,cAAc,KAA0B,CAAC;AAGtD,eAAe,cAAc,CAAC"}

package/dist/index.js

@@ -24,7 +24,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VectorDB = exports.VectorDb = void 0;
+exports.NativeVectorDb = exports.VectorDB = exports.VectorDb = void 0;
 exports.getImplementationType = getImplementationType;
 exports.isNative = isNative;
 exports.isWasm = isWasm;
@@ -83,8 +83,96 @@ function getVersion() {
         implementation: implementationType
     };
 }
-// Export the VectorDb class (aliased as VectorDB for backwards compatibility)
-exports.VectorDb = implementation.VectorDb;
-exports.VectorDB = implementation.VectorDb;
+/**
+ * Wrapper class that automatically handles metadata JSON conversion
+ */
+class VectorDBWrapper {
+    constructor(options) {
+        this.db = new implementation.VectorDb(options);
+    }
+    /**
+     * Insert a vector with optional metadata (objects are auto-converted to JSON)
+     */
+    async insert(entry) {
+        const nativeEntry = {
+            id: entry.id,
+            vector: entry.vector instanceof Float32Array ? entry.vector : new Float32Array(entry.vector),
+        };
+        // Auto-convert metadata object to JSON string
+        if (entry.metadata) {
+            nativeEntry.metadata = JSON.stringify(entry.metadata);
+        }
+        return this.db.insert(nativeEntry);
+    }
+    /**
+     * Insert multiple vectors in batch
+     */
+    async insertBatch(entries) {
+        const nativeEntries = entries.map(entry => ({
+            id: entry.id,
+            vector: entry.vector instanceof Float32Array ? entry.vector : new Float32Array(entry.vector),
+            metadata: entry.metadata ? JSON.stringify(entry.metadata) : undefined,
+        }));
+        return this.db.insertBatch(nativeEntries);
+    }
+    /**
+     * Search for similar vectors (metadata is auto-parsed from JSON)
+     */
+    async search(query) {
+        const nativeQuery = {
+            vector: query.vector instanceof Float32Array ? query.vector : new Float32Array(query.vector),
+            k: query.k,
+            efSearch: query.efSearch,
+        };
+        // Auto-convert filter object to JSON string
+        if (query.filter) {
+            nativeQuery.filter = JSON.stringify(query.filter);
+        }
+        const results = await this.db.search(nativeQuery);
+        // Auto-parse metadata JSON strings back to objects
+        return results.map((r) => ({
+            id: r.id,
+            score: r.score,
+            vector: r.vector,
+            metadata: r.metadata ? JSON.parse(r.metadata) : undefined,
+        }));
+    }
+    /**
+     * Get a vector by ID (metadata is auto-parsed from JSON)
+     */
+    async get(id) {
+        const entry = await this.db.get(id);
+        if (!entry)
+            return null;
+        return {
+            id: entry.id,
+            vector: entry.vector,
+            metadata: entry.metadata ? JSON.parse(entry.metadata) : undefined,
+        };
+    }
+    /**
+     * Delete a vector by ID
+     */
+    async delete(id) {
+        return this.db.delete(id);
+    }
+    /**
+     * Get the number of vectors in the database
+     */
+    async len() {
+        return this.db.len();
+    }
+    /**
+     * Check if the database is empty
+     */
+    async isEmpty() {
+        return this.db.isEmpty();
+    }
+}
+// Export the wrapper class (aliased as VectorDB for backwards compatibility)
+exports.VectorDb = VectorDBWrapper;
+exports.VectorDB = VectorDBWrapper;
+// Also export the raw native implementation for advanced users
+exports.NativeVectorDb = implementation.VectorDb;
 // Export everything from the implementation
 exports.default = implementation;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ruvector",
-  "version": "0.1.34",
+  "version": "0.1.35",
   "description": "High-performance vector database for Node.js with automatic native/WASM fallback",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",