ruvector 0.2.25 → 0.2.27

package/dist/core/onnx-embedder.d.ts

@@ -43,7 +43,13 @@ export interface SimilarityResult {
     timeMs: number;
 }
 /**
- * Check if ONNX embedder is available (bundled files exist)
+ * Check if the ONNX embedder is *available* — i.e. the bundled WASM files are
+ * present and the embedder can be initialized.
+ *
+ * NOTE: This is a capability check, NOT a readiness check. It returns `true`
+ * before `initOnnxEmbedder()` has run (so callers can decide whether to init).
+ * To check whether the model has actually been loaded, use `isOnnxInitialized()`
+ * or `isReady()`. See https://github.com/ruvnet/RuVector/issues/523.
  */
 export declare function isOnnxAvailable(): boolean;
 /**
@@ -72,9 +78,22 @@ export declare function cosineSimilarity(a: number[], b: number[]): number;
  */
 export declare function getDimension(): number;
 /**
- * Check if embedder is ready
+ * Check if the embedder has been initialized (model loaded) and is ready to
+ * embed. Returns `false` until `initOnnxEmbedder()` (or the first `embed()`,
+ * which auto-initializes) has completed successfully.
  */
 export declare function isReady(): boolean;
+/**
+ * Whether the ONNX embedder has been initialized (model loaded).
+ *
+ * Post-init counterpart to `isOnnxAvailable()` (which only checks that the
+ * bundled files exist). Named distinctly from the WASM-core `isInitialized()`
+ * export to avoid a barrel name collision. Equivalent to `isReady()`; provided
+ * as a self-documenting gate so callers can distinguish "bundled" (available)
+ * from "loaded" (initialized). See
+ * https://github.com/ruvnet/RuVector/issues/523.
+ */
+export declare function isOnnxInitialized(): boolean;
 /**
  * Get embedder stats including SIMD and parallel capabilities
  */
@@ -91,6 +110,24 @@ export declare function getStats(): {
  * Shutdown parallel workers (call on exit)
  */
 export declare function shutdown(): Promise<void>;
+/**
+ * Initialize the bundled-WASM worker pool for high-throughput batch embedding
+ * (issue #523 SOTA). Self-contained — uses Node worker_threads + the bundled
+ * WASM over SharedArrayBuffer model bytes, no external dependency. Vectors are
+ * identical to the single-thread path (cosine-equivalent).
+ *
+ * @param numWorkers number of worker threads (default: min(cpus-2, 16))
+ */
+export declare function initParallelEmbedder(numWorkers?: number): Promise<boolean>;
+/**
+ * Batch-embed via the bundled worker pool, sharded across CPU cores. Lazily
+ * starts the pool on first use. Returns embeddings in input order.
+ */
+export declare function embedBatchParallel(texts: string[]): Promise<number[][]>;
+/** Number of active pool workers (0 if the pool isn't started). */
+export declare function getParallelWorkerCount(): number;
+/** Shut down the bundled worker pool and release its threads. */
+export declare function shutdownParallelEmbedder(): Promise<void>;
 export declare class OnnxEmbedder {
     private config;
     constructor(config?: OnnxEmbedderConfig);

package/dist/core/onnx-embedder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"onnx-embedder.d.ts","sourceRoot":"","sources":["../../src/core/onnx-embedder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,kBAAkB,EAAE,WAAW,GAAG,SAAS,CAAC;CACjD;AAuBD,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAClC,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAMD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAeD;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAOzC;AA6DD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,CA+FxF;AAED;;GAEG;AACH,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAiBlE;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAwC5E;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAaxF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAiBjE;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAUA;AAED;;GAEG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAM9C;AAGD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,GAAE,kBAAuB;IAIrC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAIxB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKtC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAKhD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK/D,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,KAAK,IAAI,OAAO,CAEnB;CACF;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"onnx-embedder.d.ts","sourceRoot":"","sources":["../../src/core/onnx-embedder.ts"],"names":[],"mappings":"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"}

package/dist/core/onnx-embedder.js

@@ -57,8 +57,13 @@ exports.similarity = similarity;
 exports.cosineSimilarity = cosineSimilarity;
 exports.getDimension = getDimension;
 exports.isReady = isReady;
+exports.isOnnxInitialized = isOnnxInitialized;
 exports.getStats = getStats;
 exports.shutdown = shutdown;
+exports.initParallelEmbedder = initParallelEmbedder;
+exports.embedBatchParallel = embedBatchParallel;
+exports.getParallelWorkerCount = getParallelWorkerCount;
+exports.shutdownParallelEmbedder = shutdownParallelEmbedder;
 const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
 const url_1 = require("url");
@@ -95,10 +100,22 @@ let loadPromise = null;
 let isInitialized = false;
 let parallelEnabled = false;
 let parallelThreshold = 4;
+// Captured at init so the bundled worker pool can reuse the loaded model bytes
+// (shared to workers via SharedArrayBuffer) instead of re-downloading per worker.
+let loadedModelBytes = null;
+let loadedTokenizerJson = null;
+let loadedMaxLength = 256;
+let bundledPool = null;
 // Default model
 const DEFAULT_MODEL = 'all-MiniLM-L6-v2';
 /**
- * Check if ONNX embedder is available (bundled files exist)
+ * Check if the ONNX embedder is *available* — i.e. the bundled WASM files are
+ * present and the embedder can be initialized.
+ *
+ * NOTE: This is a capability check, NOT a readiness check. It returns `true`
+ * before `initOnnxEmbedder()` has run (so callers can decide whether to init).
+ * To check whether the model has actually been loaded, use `isOnnxInitialized()`
+ * or `isReady()`. See https://github.com/ruvnet/RuVector/issues/523.
  */
 function isOnnxAvailable() {
     try {
@@ -143,7 +160,7 @@ async function tryInitParallel(config) {
     // Skip if explicitly disabled
     if (config.enableParallel === false)
         return false;
-    // For 'auto' or true, try to initialize
+    // 1) Optional external package (back-compat). Absent by default.
     try {
         const parallelModule = await dynamicImport('ruvector-onnx-embeddings-wasm/parallel');
         const { ParallelEmbedder } = parallelModule;
@@ -154,15 +171,44 @@ async function tryInitParallel(config) {
         parallelThreshold = config.parallelThreshold || 4;
         parallelEnabled = true;
         parallelAvailable = true;
-        console.error(`Parallel embedder ready: ${parallelEmbedder.numWorkers} workers, SIMD: ${simdAvailable}`);
+        console.error(`Parallel embedder ready (external): ${parallelEmbedder.numWorkers} workers, SIMD: ${simdAvailable}`);
         return true;
     }
-    catch (e) {
+    catch {
+        // External package not installed — fall through to the bundled pool.
+    }
+    // 2) Bundled, zero-dependency worker pool over the already-loaded model bytes.
+    // Opt-in only (enableParallel === true) so the default/'auto' path does not
+    // silently spawn worker threads for existing callers. Vectors are identical
+    // to the single-thread path (issue #523).
+    if (config.enableParallel !== true) {
         parallelAvailable = false;
-        if (config.enableParallel === true) {
-            // Only warn if explicitly requested
-            console.error(`Parallel embedder not available: ${e.message}`);
+        return false;
+    }
+    try {
+        if (!loadedModelBytes || !loadedTokenizerJson) {
+            throw new Error('model bytes unavailable for bundled pool');
         }
+        const poolUrl = (0, url_1.pathToFileURL)(path.join(__dirname, 'onnx', 'bundled-parallel.mjs')).href;
+        const { ParallelEmbedder } = await dynamicImport(poolUrl);
+        const pool = new ParallelEmbedder({
+            modelBytes: loadedModelBytes,
+            tokenizerJson: loadedTokenizerJson,
+            maxLength: loadedMaxLength,
+            dimension: embedder ? embedder.dimension() : 384,
+            numWorkers: config.numWorkers,
+        });
+        await pool.init();
+        parallelEmbedder = pool;
+        parallelThreshold = config.parallelThreshold || 4;
+        parallelEnabled = true;
+        parallelAvailable = true;
+        console.error(`Parallel embedder ready (bundled): ${pool.numWorkers} workers, SIMD: ${simdAvailable}`);
+        return true;
+    }
+    catch (e) {
+        parallelAvailable = false;
+        console.error(`Parallel embedder not available: ${e.message}`);
         return false;
     }
 }
@@ -181,22 +227,26 @@ async function initOnnxEmbedder(config = {}) {
     loadPromise = (async () => {
         try {
             // Paths to bundled ONNX files
-            const pkgPath = path.join(__dirname, 'onnx', 'pkg', 'ruvector_onnx_embeddings_wasm.js');
+            const bgJsPath = path.join(__dirname, 'onnx', 'pkg', 'ruvector_onnx_embeddings_wasm_bg.js');
+            const wasmPath = path.join(__dirname, 'onnx', 'pkg', 'ruvector_onnx_embeddings_wasm_bg.wasm');
             const loaderPath = path.join(__dirname, 'onnx', 'loader.js');
-            if (!fs.existsSync(pkgPath)) {
+            if (!fs.existsSync(bgJsPath) || !fs.existsSync(wasmPath)) {
                 throw new Error('ONNX WASM files not bundled. The onnx/ directory is missing.');
             }
-            // Convert paths to file:// URLs for cross-platform ESM compatibility (Windows fix)
-            const pkgUrl = (0, url_1.pathToFileURL)(pkgPath).href;
+            // Load the bg.js module directly (avoids the ESM `import * as wasm from "*.wasm"`
+            // in the main .js shim which requires --experimental-wasm-modules on Node 18-24).
+            const bgUrl = (0, url_1.pathToFileURL)(bgJsPath).href;
             const loaderUrl = (0, url_1.pathToFileURL)(loaderPath).href;
-            // Dynamic import of bundled modules using file:// URLs
-            wasmModule = await dynamicImport(pkgUrl);
-            // Initialize WASM module (loads the .wasm file)
-            const wasmPath = path.join(__dirname, 'onnx', 'pkg', 'ruvector_onnx_embeddings_wasm_bg.wasm');
-            if (wasmModule.default && typeof wasmModule.default === 'function') {
-                // For bundler-style initialization, pass the wasm buffer
-                const wasmBytes = fs.readFileSync(wasmPath);
-                await wasmModule.default(wasmBytes);
+            wasmModule = await dynamicImport(bgUrl);
+            // Instantiate the .wasm bytes via WebAssembly API (no --experimental-wasm-modules needed).
+            const wasmBytes = fs.readFileSync(wasmPath);
+            const wasmResult = await WebAssembly.instantiate(wasmBytes, { './ruvector_onnx_embeddings_wasm_bg.js': wasmModule });
+            const wasmExports = wasmResult.instance.exports;
+            if (typeof wasmModule.__wbg_set_wasm === 'function') {
+                wasmModule.__wbg_set_wasm(wasmExports);
+            }
+            if (typeof wasmExports.__wbindgen_start === 'function') {
+                wasmExports.__wbindgen_start();
             }
             const loaderModule = await dynamicImport(loaderUrl);
             const { ModelLoader } = loaderModule;
@@ -209,6 +259,10 @@ async function initOnnxEmbedder(config = {}) {
             const modelId = config.modelId || DEFAULT_MODEL;
             console.error(`Loading ONNX model: ${modelId}...`);
             const { modelBytes, tokenizerJson, config: modelConfig } = await modelLoader.loadModel(modelId);
+            // Retain for the bundled parallel worker pool (see initParallelEmbedder).
+            loadedModelBytes = modelBytes;
+            loadedTokenizerJson = tokenizerJson;
+            loadedMaxLength = config.maxLength || modelConfig.maxLength || 256;
             // Create embedder with config
             const embedderConfig = new wasmModule.WasmEmbedderConfig()
                 .setMaxLength(config.maxLength || modelConfig.maxLength || 256)
@@ -350,11 +404,26 @@ function getDimension() {
     return embedder ? embedder.dimension() : 384;
 }
 /**
- * Check if embedder is ready
+ * Check if the embedder has been initialized (model loaded) and is ready to
+ * embed. Returns `false` until `initOnnxEmbedder()` (or the first `embed()`,
+ * which auto-initializes) has completed successfully.
  */
 function isReady() {
     return isInitialized;
 }
+/**
+ * Whether the ONNX embedder has been initialized (model loaded).
+ *
+ * Post-init counterpart to `isOnnxAvailable()` (which only checks that the
+ * bundled files exist). Named distinctly from the WASM-core `isInitialized()`
+ * export to avoid a barrel name collision. Equivalent to `isReady()`; provided
+ * as a self-documenting gate so callers can distinguish "bundled" (available)
+ * from "loaded" (initialized). See
+ * https://github.com/ruvnet/RuVector/issues/523.
+ */
+function isOnnxInitialized() {
+    return isInitialized;
+}
 /**
  * Get embedder stats including SIMD and parallel capabilities
  */
@@ -378,6 +447,56 @@ async function shutdown() {
         parallelEmbedder = null;
         parallelEnabled = false;
     }
+    await shutdownParallelEmbedder();
+}
+/**
+ * Initialize the bundled-WASM worker pool for high-throughput batch embedding
+ * (issue #523 SOTA). Self-contained — uses Node worker_threads + the bundled
+ * WASM over SharedArrayBuffer model bytes, no external dependency. Vectors are
+ * identical to the single-thread path (cosine-equivalent).
+ *
+ * @param numWorkers number of worker threads (default: min(cpus-2, 16))
+ */
+async function initParallelEmbedder(numWorkers) {
+    if (bundledPool)
+        return true;
+    if (!isInitialized)
+        await initOnnxEmbedder();
+    if (!loadedModelBytes || !loadedTokenizerJson) {
+        throw new Error('Model bytes unavailable; cannot start parallel embedder.');
+    }
+    const poolUrl = (0, url_1.pathToFileURL)(path.join(__dirname, 'onnx', 'bundled-parallel.mjs')).href;
+    const { ParallelEmbedder } = await dynamicImport(poolUrl);
+    const pool = new ParallelEmbedder({
+        modelBytes: loadedModelBytes,
+        tokenizerJson: loadedTokenizerJson,
+        maxLength: loadedMaxLength,
+        dimension: getDimension(),
+        numWorkers,
+    });
+    await pool.init();
+    bundledPool = pool;
+    return true;
+}
+/**
+ * Batch-embed via the bundled worker pool, sharded across CPU cores. Lazily
+ * starts the pool on first use. Returns embeddings in input order.
+ */
+async function embedBatchParallel(texts) {
+    if (!bundledPool)
+        await initParallelEmbedder();
+    return bundledPool.embedBatch(texts);
+}
+/** Number of active pool workers (0 if the pool isn't started). */
+function getParallelWorkerCount() {
+    return bundledPool ? bundledPool.numWorkers : 0;
+}
+/** Shut down the bundled worker pool and release its threads. */
+async function shutdownParallelEmbedder() {
+    if (bundledPool) {
+        await bundledPool.shutdown();
+        bundledPool = null;
+    }
 }
 // Export class wrapper for compatibility
 class OnnxEmbedder {

package/dist/core/onnx-optimized.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"onnx-optimized.d.ts","sourceRoot":"","sources":["../../src/core/onnx-optimized.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAcH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IACpD,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA0HD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAA8B;IAGjD,OAAO,CAAC,cAAc,CAAiC;IACvD,OAAO,CAAC,cAAc,CAAwB;IAG9C,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,SAAS,CAAO;gBAEZ,MAAM,GAAE,mBAAwB;IAiB5C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAWb,MAAM;IA8EpB;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAiChD;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAmD1D;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK/D;;OAEG;IACH,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM;IAmB1D;;OAEG;IACH,aAAa,IAAI;QACf,SAAS,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3E,SAAS,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3E,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;KACrB;IASD;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,mBAAmB,CAAC;CAG3C;AAQD,wBAAgB,wBAAwB,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,qBAAqB,CAK5F;AAED,wBAAsB,iBAAiB,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAIpG;AAED,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"onnx-optimized.d.ts","sourceRoot":"","sources":["../../src/core/onnx-optimized.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAcH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IACpD,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA0HD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAA8B;IAGjD,OAAO,CAAC,cAAc,CAAiC;IACvD,OAAO,CAAC,cAAc,CAAwB;IAG9C,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,SAAS,CAAO;gBAEZ,MAAM,GAAE,mBAAwB;IAiB5C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAWb,MAAM;IA+DpB;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAiChD;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAmD1D;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK/D;;OAEG;IACH,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM;IAmB1D;;OAEG;IACH,aAAa,IAAI;QACf,SAAS,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3E,SAAS,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3E,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;KACrB;IASD;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,mBAAmB,CAAC;CAG3C;AAQD,wBAAgB,wBAAwB,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,qBAAqB,CAK5F;AAED,wBAAsB,iBAAiB,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAIpG;AAED,eAAe,qBAAqB,CAAC"}

package/dist/core/onnx-optimized.js

@@ -213,34 +213,16 @@ class OptimizedOnnxEmbedder {
             }
             const loaderModule = await dynamicImport(loaderUrl);
             const { ModelLoader } = loaderModule;
-            // Select model URL based on quantization preference
+            // NOTE (issue #523): ModelLoader.loadModel() resolves the model by modelId
+            // from its own registry (currently FP32 all-MiniLM-L6-v2). The per-variant
+            // URLs in QUANTIZED_MODELS are not wired into the loader yet, so we must not
+            // log a quantization (FP16/INT8) that is not actually applied. When the
+            // loader gains variant support, thread the selected variant through to
+            // loadModel() here instead of computing an unused URL.
             const modelInfo = QUANTIZED_MODELS[this.config.modelId];
-            let modelUrl;
             if (modelInfo) {
-                if (this.config.useQuantized && this.config.quantization !== 'none') {
-                    // Try quantized version first
-                    if (this.config.quantization === 'int8' && modelInfo.int8) {
-                        modelUrl = modelInfo.int8;
-                        console.error(`Using INT8 quantized model: ${this.config.modelId}`);
-                    }
-                    else if (modelInfo.fp16) {
-                        modelUrl = modelInfo.fp16;
-                        console.error(`Using FP16 quantized model: ${this.config.modelId}`);
-                    }
-                    else {
-                        modelUrl = modelInfo.onnx;
-                        console.error(`Using FP32 model (no quantized version): ${this.config.modelId}`);
-                    }
-                }
-                else {
-                    modelUrl = modelInfo.onnx;
-                }
                 this.dimension = modelInfo.dimension;
             }
-            else {
-                // Fallback to default loader
-                modelUrl = '';
-            }
             const modelLoader = new ModelLoader({
                 cache: true,
                 cacheDir: path.join(process.env.HOME || '/tmp', '.ruvector', 'models'),

package/dist/index.d.ts

@@ -102,5 +102,59 @@ declare class VectorDBWrapper {
 export declare const VectorDb: typeof VectorDBWrapper;
 export declare const VectorDB: typeof VectorDBWrapper;
 export declare const NativeVectorDb: any;
+/** High-level index class compatible with the test-suite API. */
+export declare class VectorIndex {
+    private db;
+    private _dimension;
+    private _storagePath;
+    constructor(opts: {
+        dimension: number;
+        metric?: string;
+        indexType?: string;
+    });
+    insert(entry: {
+        id?: string;
+        values: number[];
+    }): Promise<string>;
+    insertBatch(entries: Array<{
+        id?: string;
+        values: number[];
+    }>, _opts?: {
+        batchSize?: number;
+        progressCallback?: (p: number) => void;
+    }): Promise<string[]>;
+    search(query: number[], opts: {
+        k: number;
+    }): Promise<Array<{
+        id: string;
+        score: number;
+    }>>;
+    get(id: string): Promise<{
+        id: string;
+        values: number[];
+    } | null>;
+    delete(id: string): Promise<boolean>;
+    stats(): Promise<{
+        vectorCount: number;
+        dimension: number;
+    }>;
+    clear(): Promise<void>;
+    optimize(): Promise<void>;
+}
+/** Get backend info (compat with old getBackendInfo() call). */
+export declare function getBackendInfo(): {
+    type: 'native' | 'wasm';
+    version: string;
+    features: string[];
+};
+/** Check native availability (compat alias for isNative()). */
+export declare function isNativeAvailable(): boolean;
+/** Vector utility functions used by tests and downstream packages. */
+export declare const Utils: {
+    cosineSimilarity(a: number[], b: number[]): number;
+    euclideanDistance(a: number[], b: number[]): number;
+    normalize(v: number[]): number[];
+    randomVector(dimension: number): number[];
+};
 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;;;;;;;;;;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;AA4BD;;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,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,GAAG,CAAA;KAAE;IAe7H;;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":"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"}

package/dist/index.js

@@ -25,12 +25,14 @@ 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.NativeVectorDb = exports.VectorDB = exports.VectorDb = void 0;
+exports.Utils = exports.VectorIndex = exports.NativeVectorDb = exports.VectorDB = exports.VectorDb = void 0;
 exports.getImplementationType = getImplementationType;
 exports.isNative = isNative;
 exports.isRvf = isRvf;
 exports.isWasm = isWasm;
 exports.getVersion = getVersion;
+exports.getBackendInfo = getBackendInfo;
+exports.isNativeAvailable = isNativeAvailable;
 __exportStar(require("./types"), exports);
 // Export core wrappers (safe interfaces with automatic type conversion)
 __exportStar(require("./core"), exports);
@@ -254,5 +256,104 @@ exports.VectorDb = VectorDBWrapper;
 exports.VectorDB = VectorDBWrapper;
 // Also export the raw native implementation for advanced users
 exports.NativeVectorDb = implementation.VectorDb;
+// ────────────────────────────────────────────────────────────────────────────
+// Backwards-compat surface used by tests and older integrations
+// ────────────────────────────────────────────────────────────────────────────
+/** High-level index class compatible with the test-suite API. */
+class VectorIndex {
+    constructor(opts) {
+        if (opts.dimension <= 0) {
+            throw new Error(`Invalid dimensions: must be positive, got ${opts.dimension}`);
+        }
+        this._dimension = opts.dimension;
+        // Use a unique temp path per instance to avoid cross-instance dimension conflicts
+        this._storagePath = require('os').tmpdir() + `/ruvector-idx-${Date.now()}-${Math.random().toString(36).slice(2)}.db`;
+        this.db = new VectorDBWrapper({ dimensions: opts.dimension, distanceMetric: opts.metric, storagePath: this._storagePath });
+    }
+    async insert(entry) {
+        return this.db.insert({ id: entry.id, vector: new Float32Array(entry.values) });
+    }
+    async insertBatch(entries, _opts) {
+        const ids = [];
+        const batchSize = _opts?.batchSize ?? entries.length;
+        for (let i = 0; i < entries.length; i += batchSize) {
+            const slice = entries.slice(i, i + batchSize);
+            const batch = slice.map(e => ({ id: e.id, vector: new Float32Array(e.values) }));
+            const batchIds = await this.db.insertBatch(batch);
+            ids.push(...batchIds);
+            _opts?.progressCallback?.(Math.min((i + batchSize) / entries.length, 1));
+        }
+        return ids;
+    }
+    async search(query, opts) {
+        return this.db.search({ vector: new Float32Array(query), k: opts.k });
+    }
+    async get(id) {
+        const r = await this.db.get(id);
+        if (!r)
+            return null;
+        return { id: r.id ?? id, values: Array.from(r.vector) };
+    }
+    async delete(id) {
+        return this.db.delete(id);
+    }
+    async stats() {
+        const count = await this.db.len();
+        return { vectorCount: count, dimension: this._dimension };
+    }
+    async clear() {
+        // Create a fresh db at a new temp path to reset state
+        const newPath = require('os').tmpdir() + `/ruvector-idx-${Date.now()}-${Math.random().toString(36).slice(2)}.db`;
+        this._storagePath = newPath;
+        this.db = new VectorDBWrapper({ dimensions: this._dimension, storagePath: newPath });
+    }
+    async optimize() {
+        // No-op: native HNSW self-optimises on insert
+    }
+}
+exports.VectorIndex = VectorIndex;
+/** Get backend info (compat with old getBackendInfo() call). */
+function getBackendInfo() {
+    const type = implementationType === 'native' ? 'native' : 'wasm';
+    const { version } = getVersion();
+    const features = type === 'native'
+        ? ['SIMD', 'Multi-threading', 'Rust-native']
+        : ['Browser-compatible', 'Cross-platform'];
+    return { type, version, features };
+}
+/** Check native availability (compat alias for isNative()). */
+function isNativeAvailable() {
+    return implementationType === 'native';
+}
+/** Vector utility functions used by tests and downstream packages. */
+exports.Utils = {
+    cosineSimilarity(a, b) {
+        if (a.length !== b.length)
+            throw new Error('Vectors must have same dimension');
+        let dot = 0, na = 0, nb = 0;
+        for (let i = 0; i < a.length; i++) {
+            dot += a[i] * b[i];
+            na += a[i] ** 2;
+            nb += b[i] ** 2;
+        }
+        const denom = Math.sqrt(na) * Math.sqrt(nb);
+        return denom === 0 ? 0 : dot / denom;
+    },
+    euclideanDistance(a, b) {
+        if (a.length !== b.length)
+            throw new Error('Vectors must have same dimension');
+        return Math.sqrt(a.reduce((sum, v, i) => sum + (v - b[i]) ** 2, 0));
+    },
+    normalize(v) {
+        const mag = Math.sqrt(v.reduce((s, x) => s + x * x, 0));
+        if (mag === 0)
+            return v.slice();
+        return v.map(x => x / mag);
+    },
+    randomVector(dimension) {
+        const v = Array.from({ length: dimension }, () => Math.random() * 2 - 1);
+        return exports.Utils.normalize(v);
+    },
+};
 // Export everything from the implementation
 exports.default = implementation;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ruvector",
-  "version": "0.2.25",
+  "version": "0.2.27",
   "description": "Self-learning vector database for Node.js — hybrid search, Graph RAG, FlashAttention-3, HNSW, 50+ attention mechanisms",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -8,10 +8,11 @@
     "ruvector": "./bin/cli.js"
   },
   "scripts": {
-    "build": "tsc && cp src/core/onnx/pkg/package.json dist/core/onnx/pkg/",
+    "build": "tsc && mkdir -p dist/core/onnx && cp -r src/core/onnx/. dist/core/onnx/",
     "verify-dist": "node scripts/verify-dist.js",
+    "prepack": "npm run build && npm run verify-dist",
     "prepublishOnly": "npm run build && npm run verify-dist",
-    "test": "node test/integration.js && node test/cli-commands.js"
+    "test": "node test/integration.js && node test/cli-commands.js && node test/sigterm-cleanup.js"
   },
   "keywords": [
     "vector",