ruvector 0.2.20 → 0.2.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ruvector",
-  "version": "0.2.20",
+  "version": "0.2.21",
   "description": "Self-learning vector database for Node.js — hybrid search, Graph RAG, FlashAttention-3, DiskANN, 50+ attention mechanisms",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -90,6 +90,7 @@
     "bin/",
     "dist/",
     "src/decompiler/",
+    "wasm/",
     "README.md",
     "LICENSE"
   ],

package/src/decompiler/index.js

@@ -27,6 +27,55 @@ const { computeMetrics, computeModuleMetrics } = require('./metrics');
 const { reconstructCode, reconstructRunnable } = require('./reconstructor');
 const { validateReconstruction } = require('./validator');
 
+/**
+ * Try the WASM Louvain decompiler (full graph-partitioning pipeline).
+ * Returns null if WASM module is not available or fails.
+ *
+ * @param {string} source - raw JavaScript source
+ * @param {object} [options]
+ * @returns {{modules: object[], metrics: object, witness: object|null}|null}
+ */
+function tryWasmDecompiler(source, options = {}) {
+  try {
+    const wasm = require('../../wasm/ruvector_decompiler_wasm');
+    const configJson = JSON.stringify({
+      target_modules: null,
+      min_confidence: options.minConfidence || 0.3,
+      generate_source_maps: false,
+      generate_witness: options.witness !== false,
+      output_filename: 'bundle.js',
+      model_path: null,
+      hierarchical_output: true,
+      max_depth: 3,
+      min_folder_size: 3,
+    });
+    const resultJson = wasm.decompile(source, configJson);
+    const result = JSON.parse(resultJson);
+    if (result.error) return null;
+
+    // Convert Rust DecompileResult to Node.js format
+    return {
+      modules: (result.modules || []).map((m) => ({
+        name: m.name,
+        content: m.source || '',
+        declarations: (m.declarations && m.declarations.length) || 0,
+        fragments: (m.declarations && m.declarations.length) || 0,
+        confidence: 0.8,
+      })),
+      metrics: {
+        source: { sizeBytes: source.length },
+        modules: (result.modules || []).length,
+        engine: 'wasm-louvain',
+      },
+      witness: result.witness || null,
+      moduleTree: result.module_tree || null,
+      beautifiedSource: source,
+    };
+  } catch {
+    return null; // WASM not available, fall back
+  }
+}
+
 /**
  * Try to beautify source code using js-beautify (optional dep).
  * Falls back to returning the source unchanged if not installed.
@@ -118,7 +167,13 @@ function decompileSource(source, options = {}) {
     filePath,
   } = options;
 
-  // Try Rust Louvain pipeline first (878+ modules, 100% parse rate)
+  // Priority 1: WASM Louvain (full pipeline, works everywhere, no binary needed)
+  if (useRust !== false && source.length > 1000) {
+    const wasmResult = tryWasmDecompiler(source, options);
+    if (wasmResult) return wasmResult;
+  }
+
+  // Priority 2: Rust binary (full pipeline, requires cargo build)
   if (useRust && filePath && source.length > 100000) {
     const tmpDir = path.join(require('os').tmpdir(), 'ruvector-decompile-' + Date.now());
     const rustResult = tryRustDecompiler(filePath, tmpDir);
@@ -404,4 +459,5 @@ module.exports = {
   reconstructCode,
   reconstructRunnable,
   validateReconstruction,
+  tryWasmDecompiler,
 };

package/wasm/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "ruvector-decompiler-wasm",
+  "collaborators": [
+    "Ruvector Team"
+  ],
+  "description": "WASM bindings for the RuVector JavaScript bundle decompiler (Louvain pipeline)",
+  "version": "2.1.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ruvnet/ruvector"
+  },
+  "files": [
+    "ruvector_decompiler_wasm_bg.wasm",
+    "ruvector_decompiler_wasm.js",
+    "ruvector_decompiler_wasm.d.ts"
+  ],
+  "main": "ruvector_decompiler_wasm.js",
+  "types": "ruvector_decompiler_wasm.d.ts",
+  "keywords": [
+    "decompiler",
+    "javascript",
+    "wasm",
+    "mincut",
+    "louvain"
+  ]
+}

package/wasm/ruvector_decompiler_wasm.d.ts

@@ -0,0 +1,27 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/**
+ * Decompile a minified JavaScript bundle using the full Louvain pipeline.
+ *
+ * # Arguments
+ *
+ * * `source` - The minified JavaScript source code.
+ * * `config_json` - JSON string of `DecompileConfig` fields. Pass `"{}"` for defaults.
+ *
+ * # Returns
+ *
+ * A JSON string containing the `DecompileResult` (modules, witness, inferred names, etc.)
+ * or a JSON object with an `"error"` field on failure.
+ */
+export function decompile(source: string, config_json: string): string;
+
+/**
+ * Initialize the WASM module (sets up panic hook for better error messages).
+ */
+export function init(): void;
+
+/**
+ * Return the version of the decompiler WASM module.
+ */
+export function version(): string;

package/wasm/ruvector_decompiler_wasm.js

@@ -0,0 +1,220 @@
+/* @ts-self-types="./ruvector_decompiler_wasm.d.ts" */
+
+/**
+ * Decompile a minified JavaScript bundle using the full Louvain pipeline.
+ *
+ * # Arguments
+ *
+ * * `source` - The minified JavaScript source code.
+ * * `config_json` - JSON string of `DecompileConfig` fields. Pass `"{}"` for defaults.
+ *
+ * # Returns
+ *
+ * A JSON string containing the `DecompileResult` (modules, witness, inferred names, etc.)
+ * or a JSON object with an `"error"` field on failure.
+ * @param {string} source
+ * @param {string} config_json
+ * @returns {string}
+ */
+function decompile(source, config_json) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_export2, wasm.__wbindgen_export3);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(config_json, wasm.__wbindgen_export2, wasm.__wbindgen_export3);
+        const len1 = WASM_VECTOR_LEN;
+        wasm.decompile(retptr, ptr0, len0, ptr1, len1);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        deferred3_0 = r0;
+        deferred3_1 = r1;
+        return getStringFromWasm0(r0, r1);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+        wasm.__wbindgen_export(deferred3_0, deferred3_1, 1);
+    }
+}
+exports.decompile = decompile;
+
+/**
+ * Initialize the WASM module (sets up panic hook for better error messages).
+ */
+function init() {
+    wasm.init();
+}
+exports.init = init;
+
+/**
+ * Return the version of the decompiler WASM module.
+ * @returns {string}
+ */
+function version() {
+    let deferred1_0;
+    let deferred1_1;
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        wasm.version(retptr);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        deferred1_0 = r0;
+        deferred1_1 = r1;
+        return getStringFromWasm0(r0, r1);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+        wasm.__wbindgen_export(deferred1_0, deferred1_1, 1);
+    }
+}
+exports.version = version;
+
+function __wbg_get_imports() {
+    const import0 = {
+        __proto__: null,
+        __wbg___wbindgen_throw_39bc967c0e5a9b58: function(arg0, arg1) {
+            throw new Error(getStringFromWasm0(arg0, arg1));
+        },
+        __wbg_error_a6fa202b58aa1cd3: function(arg0, arg1) {
+            let deferred0_0;
+            let deferred0_1;
+            try {
+                deferred0_0 = arg0;
+                deferred0_1 = arg1;
+                console.error(getStringFromWasm0(arg0, arg1));
+            } finally {
+                wasm.__wbindgen_export(deferred0_0, deferred0_1, 1);
+            }
+        },
+        __wbg_new_227d7c05414eb861: function() {
+            const ret = new Error();
+            return addHeapObject(ret);
+        },
+        __wbg_stack_3b0d974bbf31e44f: function(arg0, arg1) {
+            const ret = getObject(arg1).stack;
+            const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_export2, wasm.__wbindgen_export3);
+            const len1 = WASM_VECTOR_LEN;
+            getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+            getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+        },
+        __wbindgen_object_drop_ref: function(arg0) {
+            takeObject(arg0);
+        },
+    };
+    return {
+        __proto__: null,
+        "./ruvector_decompiler_wasm_bg.js": import0,
+    };
+}
+
+function addHeapObject(obj) {
+    if (heap_next === heap.length) heap.push(heap.length + 1);
+    const idx = heap_next;
+    heap_next = heap[idx];
+
+    heap[idx] = obj;
+    return idx;
+}
+
+function dropObject(idx) {
+    if (idx < 1028) return;
+    heap[idx] = heap_next;
+    heap_next = idx;
+}
+
+let cachedDataViewMemory0 = null;
+function getDataViewMemory0() {
+    if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || (cachedDataViewMemory0.buffer.detached === undefined && cachedDataViewMemory0.buffer !== wasm.memory.buffer)) {
+        cachedDataViewMemory0 = new DataView(wasm.memory.buffer);
+    }
+    return cachedDataViewMemory0;
+}
+
+function getStringFromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return decodeText(ptr, len);
+}
+
+let cachedUint8ArrayMemory0 = null;
+function getUint8ArrayMemory0() {
+    if (cachedUint8ArrayMemory0 === null || cachedUint8ArrayMemory0.byteLength === 0) {
+        cachedUint8ArrayMemory0 = new Uint8Array(wasm.memory.buffer);
+    }
+    return cachedUint8ArrayMemory0;
+}
+
+function getObject(idx) { return heap[idx]; }
+
+let heap = new Array(1024).fill(undefined);
+heap.push(undefined, null, true, false);
+
+let heap_next = heap.length;
+
+function passStringToWasm0(arg, malloc, realloc) {
+    if (realloc === undefined) {
+        const buf = cachedTextEncoder.encode(arg);
+        const ptr = malloc(buf.length, 1) >>> 0;
+        getUint8ArrayMemory0().subarray(ptr, ptr + buf.length).set(buf);
+        WASM_VECTOR_LEN = buf.length;
+        return ptr;
+    }
+
+    let len = arg.length;
+    let ptr = malloc(len, 1) >>> 0;
+
+    const mem = getUint8ArrayMemory0();
+
+    let offset = 0;
+
+    for (; offset < len; offset++) {
+        const code = arg.charCodeAt(offset);
+        if (code > 0x7F) break;
+        mem[ptr + offset] = code;
+    }
+    if (offset !== len) {
+        if (offset !== 0) {
+            arg = arg.slice(offset);
+        }
+        ptr = realloc(ptr, len, len = offset + arg.length * 3, 1) >>> 0;
+        const view = getUint8ArrayMemory0().subarray(ptr + offset, ptr + len);
+        const ret = cachedTextEncoder.encodeInto(arg, view);
+
+        offset += ret.written;
+        ptr = realloc(ptr, len, offset, 1) >>> 0;
+    }
+
+    WASM_VECTOR_LEN = offset;
+    return ptr;
+}
+
+function takeObject(idx) {
+    const ret = getObject(idx);
+    dropObject(idx);
+    return ret;
+}
+
+let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
+cachedTextDecoder.decode();
+function decodeText(ptr, len) {
+    return cachedTextDecoder.decode(getUint8ArrayMemory0().subarray(ptr, ptr + len));
+}
+
+const cachedTextEncoder = new TextEncoder();
+
+if (!('encodeInto' in cachedTextEncoder)) {
+    cachedTextEncoder.encodeInto = function (arg, view) {
+        const buf = cachedTextEncoder.encode(arg);
+        view.set(buf);
+        return {
+            read: arg.length,
+            written: buf.length
+        };
+    };
+}
+
+let WASM_VECTOR_LEN = 0;
+
+const wasmPath = `${__dirname}/ruvector_decompiler_wasm_bg.wasm`;
+const wasmBytes = require('fs').readFileSync(wasmPath);
+const wasmModule = new WebAssembly.Module(wasmBytes);
+let wasm = new WebAssembly.Instance(wasmModule, __wbg_get_imports()).exports;
+wasm.__wbindgen_start();

package/wasm/ruvector_decompiler_wasm_bg.wasm.d.ts

@@ -0,0 +1,16 @@
+/* tslint:disable */
+/* eslint-disable */
+export const memory: WebAssembly.Memory;
+export const decompile: (a: number, b: number, c: number, d: number, e: number) => void;
+export const version: (a: number) => void;
+export const init: () => void;
+export const mincut_add_result: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+export const mincut_get_coordinator: () => number;
+export const mincut_get_result: () => number;
+export const mincut_init: (a: number, b: number, c: number) => void;
+export const mincut_is_complete: () => number;
+export const __wbindgen_export: (a: number, b: number, c: number) => void;
+export const __wbindgen_export2: (a: number, b: number) => number;
+export const __wbindgen_export3: (a: number, b: number, c: number, d: number) => number;
+export const __wbindgen_add_to_stack_pointer: (a: number) => number;
+export const __wbindgen_start: () => void;