ruvector 0.1.96 → 0.1.98

package/dist/core/rvf-wrapper.d.ts

@@ -0,0 +1,86 @@
+/**
+ * RVF Wrapper - Persistent vector store via @ruvector/rvf
+ *
+ * Wraps @ruvector/rvf RvfDatabase through thin convenience functions.
+ * Falls back to clear error messages when the package is not installed.
+ */
+export declare function isRvfAvailable(): boolean;
+export interface RvfStoreOptions {
+    dimensions: number;
+    metric?: 'l2' | 'cosine' | 'dotproduct';
+    compression?: 'none' | 'scalar' | 'product';
+    m?: number;
+    efConstruction?: number;
+}
+export interface RvfEntry {
+    id: string;
+    vector: Float32Array | number[];
+    metadata?: Record<string, any>;
+}
+export interface RvfResult {
+    id: string;
+    distance: number;
+}
+export interface RvfStoreStatus {
+    totalVectors: number;
+    totalSegments: number;
+    fileSizeBytes: number;
+    epoch: number;
+    compactionState: string;
+    deadSpaceRatio: number;
+    readOnly: boolean;
+}
+export interface RvfQueryOpts {
+    efSearch?: number;
+    filter?: any;
+    timeoutMs?: number;
+}
+export type RvfStore = any;
+/**
+ * Create a new RVF store at the given path.
+ */
+export declare function createRvfStore(path: string, options: RvfStoreOptions): Promise<RvfStore>;
+/**
+ * Open an existing RVF store for read-write access.
+ */
+export declare function openRvfStore(path: string): Promise<RvfStore>;
+/**
+ * Ingest a batch of vectors into an open store.
+ */
+export declare function rvfIngest(store: RvfStore, entries: RvfEntry[]): Promise<{
+    accepted: number;
+    rejected: number;
+    epoch: number;
+}>;
+/**
+ * Query for the k nearest neighbors.
+ */
+export declare function rvfQuery(store: RvfStore, vector: Float32Array | number[], k: number, options?: RvfQueryOpts): Promise<RvfResult[]>;
+/**
+ * Soft-delete vectors by their IDs.
+ */
+export declare function rvfDelete(store: RvfStore, ids: string[]): Promise<{
+    deleted: number;
+    epoch: number;
+}>;
+/**
+ * Get the current store status.
+ */
+export declare function rvfStatus(store: RvfStore): Promise<RvfStoreStatus>;
+/**
+ * Run compaction to reclaim dead space.
+ */
+export declare function rvfCompact(store: RvfStore): Promise<{
+    segmentsCompacted: number;
+    bytesReclaimed: number;
+    epoch: number;
+}>;
+/**
+ * Derive a child store from a parent for lineage tracking.
+ */
+export declare function rvfDerive(store: RvfStore, childPath: string): Promise<RvfStore>;
+/**
+ * Close the store, releasing the writer lock and flushing data.
+ */
+export declare function rvfClose(store: RvfStore): Promise<void>;
+//# sourceMappingURL=rvf-wrapper.d.ts.map

package/dist/core/rvf-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rvf-wrapper.d.ts","sourceRoot":"","sources":["../../src/core/rvf-wrapper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH,wBAAgB,cAAc,IAAI,OAAO,CAOxC;AAMD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,IAAI,GAAG,QAAQ,GAAG,YAAY,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5C,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,MAAM,MAAM,QAAQ,GAAG,GAAG,CAAC;AAM3B;;GAEG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,QAAQ,CAAC,CAGnB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAGlE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,QAAQ,EAAE,GAClB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAEhE;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,EAC/B,CAAC,EAAE,MAAM,EACT,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,SAAS,EAAE,CAAC,CAEtB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,QAAQ,EACf,GAAG,EAAE,MAAM,EAAE,GACZ,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAE7C;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,CAExE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,QAAQ,GACd,OAAO,CAAC;IAAE,iBAAiB,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAE/E;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,QAAQ,CAAC,CAEnB;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7D"}

package/dist/core/rvf-wrapper.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * RVF Wrapper - Persistent vector store via @ruvector/rvf
+ *
+ * Wraps @ruvector/rvf RvfDatabase through thin convenience functions.
+ * Falls back to clear error messages when the package is not installed.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRvfAvailable = isRvfAvailable;
+exports.createRvfStore = createRvfStore;
+exports.openRvfStore = openRvfStore;
+exports.rvfIngest = rvfIngest;
+exports.rvfQuery = rvfQuery;
+exports.rvfDelete = rvfDelete;
+exports.rvfStatus = rvfStatus;
+exports.rvfCompact = rvfCompact;
+exports.rvfDerive = rvfDerive;
+exports.rvfClose = rvfClose;
+let rvfModule = null;
+let loadError = null;
+function getRvfModule() {
+    if (rvfModule)
+        return rvfModule;
+    if (loadError)
+        throw loadError;
+    try {
+        rvfModule = require('@ruvector/rvf');
+        return rvfModule;
+    }
+    catch (e) {
+        loadError = new Error('@ruvector/rvf is not installed. Run: npm install @ruvector/rvf');
+        throw loadError;
+    }
+}
+function isRvfAvailable() {
+    try {
+        getRvfModule();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Wrapper functions
+// ---------------------------------------------------------------------------
+/**
+ * Create a new RVF store at the given path.
+ */
+async function createRvfStore(path, options) {
+    const mod = getRvfModule();
+    return mod.RvfDatabase.create(path, options);
+}
+/**
+ * Open an existing RVF store for read-write access.
+ */
+async function openRvfStore(path) {
+    const mod = getRvfModule();
+    return mod.RvfDatabase.open(path);
+}
+/**
+ * Ingest a batch of vectors into an open store.
+ */
+async function rvfIngest(store, entries) {
+    return store.ingestBatch(entries);
+}
+/**
+ * Query for the k nearest neighbors.
+ */
+async function rvfQuery(store, vector, k, options) {
+    return store.query(vector, k, options);
+}
+/**
+ * Soft-delete vectors by their IDs.
+ */
+async function rvfDelete(store, ids) {
+    return store.delete(ids);
+}
+/**
+ * Get the current store status.
+ */
+async function rvfStatus(store) {
+    return store.status();
+}
+/**
+ * Run compaction to reclaim dead space.
+ */
+async function rvfCompact(store) {
+    return store.compact();
+}
+/**
+ * Derive a child store from a parent for lineage tracking.
+ */
+async function rvfDerive(store, childPath) {
+    return store.derive(childPath);
+}
+/**
+ * Close the store, releasing the writer lock and flushing data.
+ */
+async function rvfClose(store) {
+    return store.close();
+}

package/dist/index.d.ts

@@ -3,7 +3,8 @@
  *
  * This package automatically detects and uses the best available implementation:
  * 1. Native (Rust-based, fastest) - if available for your platform
- * 2. WASM (WebAssembly, universal fallback) - works everywhere
+ * 2. RVF (persistent store) - if @ruvector/rvf is installed
+ * 3. Stub (testing fallback) - limited functionality
  *
  * Also provides safe wrappers for GNN and Attention modules that handle
  * array type conversions automatically.
@@ -15,13 +16,17 @@ declare let implementation: any;
 /**
  * Get the current implementation type
  */
-export declare function getImplementationType(): 'native' | 'wasm';
+export declare function getImplementationType(): 'native' | 'rvf' | 'wasm';
 /**
  * Check if native implementation is being used
  */
 export declare function isNative(): boolean;
 /**
- * Check if WASM implementation is being used
+ * Check if RVF implementation is being used
+ */
+export declare function isRvf(): boolean;
+/**
+ * Check if stub/fallback implementation is being used
  */
 export declare function isWasm(): boolean;
 /**

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;AAmCxB;;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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,SAAS,CAAC;AAGxB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAE3B,QAAA,IAAI,cAAc,EAAE,GAAG,CAAC;AA4DxB;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,QAAQ,GAAG,KAAK,GAAG,MAAM,CAEjE;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAElC;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,OAAO,CAE/B;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

@@ -4,7 +4,8 @@
  *
  * This package automatically detects and uses the best available implementation:
  * 1. Native (Rust-based, fastest) - if available for your platform
- * 2. WASM (WebAssembly, universal fallback) - works everywhere
+ * 2. RVF (persistent store) - if @ruvector/rvf is installed
+ * 3. Stub (testing fallback) - limited functionality
  *
  * Also provides safe wrappers for GNN and Attention modules that handle
  * array type conversions automatically.
@@ -27,6 +28,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.NativeVectorDb = exports.VectorDB = exports.VectorDb = void 0;
 exports.getImplementationType = getImplementationType;
 exports.isNative = isNative;
+exports.isRvf = isRvf;
 exports.isWasm = isWasm;
 exports.getVersion = getVersion;
 __exportStar(require("./types"), exports);
@@ -35,35 +37,60 @@ __exportStar(require("./core"), exports);
 __exportStar(require("./services"), exports);
 let implementation;
 let implementationType = 'wasm';
-try {
-    // Try to load native module first
-    implementation = require('@ruvector/core');
-    implementationType = 'native';
-    // Verify it's actually working (native module exports VectorDb, not VectorDB)
-    if (typeof implementation.VectorDb !== 'function') {
-        throw new Error('Native module loaded but VectorDb class not found');
+// Check for explicit --backend rvf flag or RUVECTOR_BACKEND env var
+const rvfRequested = process.env.RUVECTOR_BACKEND === 'rvf' ||
+    process.argv.includes('--backend') && process.argv[process.argv.indexOf('--backend') + 1] === 'rvf';
+if (rvfRequested) {
+    // Explicit rvf backend requested - fail hard if not available
+    try {
+        implementation = require('@ruvector/rvf');
+        implementationType = 'rvf';
+    }
+    catch (e) {
+        throw new Error('@ruvector/rvf is not installed.\n' +
+            '  Run: npm install @ruvector/rvf\n' +
+            '  The --backend rvf flag requires this package.');
     }
 }
-catch (e) {
-    // Graceful fallback - don't crash, just warn
-    console.warn('[RuVector] Native module not available:', e.message);
-    console.warn('[RuVector] Vector operations will be limited. Install @ruvector/core for full functionality.');
-    // Create a stub implementation that provides basic functionality
-    implementation = {
-        VectorDb: class StubVectorDb {
-            constructor() {
-                console.warn('[RuVector] Using stub VectorDb - install @ruvector/core for native performance');
-            }
-            async insert() { return 'stub-id-' + Date.now(); }
-            async insertBatch(entries) { return entries.map(() => 'stub-id-' + Date.now()); }
-            async search() { return []; }
-            async delete() { return true; }
-            async get() { return null; }
-            async len() { return 0; }
-            async isEmpty() { return true; }
+else {
+    try {
+        // Try to load native module first
+        implementation = require('@ruvector/core');
+        implementationType = 'native';
+        // Verify it's actually working (native module exports VectorDb, not VectorDB)
+        if (typeof implementation.VectorDb !== 'function') {
+            throw new Error('Native module loaded but VectorDb class not found');
         }
-    };
-    implementationType = 'wasm'; // Mark as fallback mode
+    }
+    catch (e) {
+        // Try rvf (persistent store) as second fallback
+        try {
+            implementation = require('@ruvector/rvf');
+            implementationType = 'rvf';
+        }
+        catch (rvfErr) {
+            // Graceful fallback - don't crash, just warn
+            console.warn('[RuVector] Native module not available:', e.message);
+            console.warn('[RuVector] RVF module not available:', rvfErr.message);
+            console.warn('[RuVector] Vector operations will be limited. Install @ruvector/core or @ruvector/rvf for full functionality.');
+            // Create a stub implementation that provides basic functionality
+            implementation = {
+                VectorDb: class StubVectorDb {
+                    constructor() {
+                        console.warn('[RuVector] Using stub VectorDb - install @ruvector/core for native performance');
+                    }
+                    async insert() { return 'stub-id-' + Date.now(); }
+                    async insertBatch(entries) { return entries.map(() => 'stub-id-' + Date.now()); }
+                    async search() { return []; }
+                    async delete() { return true; }
+                    async get() { return null; }
+                    async len() { return 0; }
+                    async isEmpty() { return true; }
+                }
+            };
+            implementationType = 'wasm'; // Mark as fallback mode
+        }
+    }
 }
 /**
  * Get the current implementation type
@@ -78,7 +105,13 @@ function isNative() {
     return implementationType === 'native';
 }
 /**
- * Check if WASM implementation is being used
+ * Check if RVF implementation is being used
+ */
+function isRvf() {
+    return implementationType === 'rvf';
+}
+/**
+ * Check if stub/fallback implementation is being used
  */
 function isWasm() {
     return implementationType === 'wasm';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ruvector",
-  "version": "0.1.96",
+  "version": "0.1.98",
   "description": "High-performance vector database for Node.js with automatic native/WASM fallback",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -64,6 +64,9 @@
     "commander": "^11.1.0",
     "ora": "^5.4.1"
   },
+  "optionalDependencies": {
+    "@ruvector/rvf": "^0.1.0"
+  },
   "devDependencies": {
     "@types/node": "^20.10.5",
     "typescript": "^5.3.3"