@ruvector/rvf-wasm 0.1.3 → 0.1.4

package/package.json

@@ -1,14 +1,19 @@
 {
   "name": "@ruvector/rvf-wasm",
-  "version": "0.1.3",
-  "description": "RuVector Format WASM build for browsers",
-  "main": "pkg/rvf_runtime.js",
-  "types": "pkg/rvf_runtime.d.ts",
+  "version": "0.1.4",
+  "description": "RuVector Format WASM microkernel for browser and edge vector operations",
+  "type": "module",
+  "main": "pkg/rvf_wasm.js",
+  "types": "pkg/rvf_wasm.d.ts",
   "files": [
     "pkg/"
   ],
   "scripts": {
-    "build": "wasm-pack build ../../crates/rvf/rvf-runtime --target web --out-dir ../../npm/packages/rvf-wasm/pkg --features wasm"
+    "build": "cargo build --release --target wasm32-unknown-unknown --manifest-path ../../crates/rvf/rvf-wasm/Cargo.toml && wasm-opt -Oz ../../crates/rvf/target/wasm32-unknown-unknown/release/rvf_wasm.wasm -o pkg/rvf_wasm_bg.wasm"
   },
-  "license": "MIT"
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ruvnet/ruvector"
+  }
 }

package/pkg/rvf_wasm.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Type declarations for the RVF WASM microkernel exports.
+ */
+
+export interface RvfWasmExports {
+  memory: WebAssembly.Memory;
+
+  // Memory management
+  rvf_alloc(size: number): number;
+  rvf_free(ptr: number, size: number): void;
+
+  // Core query path
+  rvf_init(config_ptr: number): number;
+  rvf_load_query(query_ptr: number, dim: number): number;
+  rvf_load_block(block_ptr: number, count: number, dtype: number): number;
+  rvf_distances(metric: number, result_ptr: number): number;
+  rvf_topk_merge(dist_ptr: number, id_ptr: number, count: number, k: number): number;
+  rvf_topk_read(out_ptr: number): number;
+
+  // Quantization
+  rvf_load_sq_params(params_ptr: number, dim: number): number;
+  rvf_dequant_i8(src_ptr: number, dst_ptr: number, count: number): number;
+  rvf_load_pq_codebook(codebook_ptr: number, m: number, k: number): number;
+  rvf_pq_distances(codes_ptr: number, count: number, result_ptr: number): number;
+
+  // HNSW navigation
+  rvf_load_neighbors(node_id: bigint, layer: number, out_ptr: number): number;
+  rvf_greedy_step(current_id: bigint, layer: number): bigint;
+
+  // Segment verification
+  rvf_verify_header(header_ptr: number): number;
+  rvf_crc32c(data_ptr: number, len: number): number;
+  rvf_verify_checksum(buf_ptr: number, buf_len: number): number;
+
+  // In-memory store
+  rvf_store_create(dim: number, metric: number): number;
+  rvf_store_open(buf_ptr: number, buf_len: number): number;
+  rvf_store_ingest(handle: number, vecs_ptr: number, ids_ptr: number, count: number): number;
+  rvf_store_query(handle: number, query_ptr: number, k: number, metric: number, out_ptr: number): number;
+  rvf_store_delete(handle: number, ids_ptr: number, count: number): number;
+  rvf_store_count(handle: number): number;
+  rvf_store_dimension(handle: number): number;
+  rvf_store_status(handle: number, out_ptr: number): number;
+  rvf_store_export(handle: number, out_ptr: number, out_len: number): number;
+  rvf_store_close(handle: number): number;
+
+  // Segment parsing
+  rvf_parse_header(buf_ptr: number, buf_len: number, out_ptr: number): number;
+  rvf_segment_count(buf_ptr: number, buf_len: number): number;
+  rvf_segment_info(buf_ptr: number, buf_len: number, idx: number, out_ptr: number): number;
+
+  // Witness chain
+  rvf_witness_verify(chain_ptr: number, chain_len: number): number;
+  rvf_witness_count(chain_len: number): number;
+}
+
+export default function init(input?: ArrayBuffer | Uint8Array | WebAssembly.Module): Promise<RvfWasmExports>;

package/pkg/rvf_wasm.js

@@ -0,0 +1,48 @@
+/**
+ * @ruvector/rvf-wasm — JS glue for the RVF WASM microkernel.
+ *
+ * Loads the .wasm binary and re-exports all C-ABI functions plus the
+ * WASM linear memory object.
+ */
+
+let wasmInstance = null;
+
+/**
+ * Initialize the WASM module.
+ * Returns the exports object with all rvf_* functions and `memory`.
+ */
+export default async function init(input) {
+  if (wasmInstance) return wasmInstance;
+
+  let wasmBytes;
+
+  if (input instanceof ArrayBuffer || ArrayBuffer.isView(input)) {
+    wasmBytes = input;
+  } else if (input instanceof WebAssembly.Module) {
+    const instance = await WebAssembly.instantiate(input, {});
+    wasmInstance = instance.exports;
+    return wasmInstance;
+  } else {
+    // Default: load from adjacent .wasm file
+    const url = new URL('rvf_wasm_bg.wasm', import.meta.url);
+    if (typeof fetch === 'function') {
+      const resp = await fetch(url);
+      if (typeof WebAssembly.instantiateStreaming === 'function') {
+        const { instance } = await WebAssembly.instantiateStreaming(resp, {});
+        wasmInstance = instance.exports;
+        return wasmInstance;
+      }
+      wasmBytes = await resp.arrayBuffer();
+    } else {
+      // Node.js fallback
+      const { readFile } = await import('node:fs/promises');
+      const { fileURLToPath } = await import('node:url');
+      const path = fileURLToPath(url);
+      wasmBytes = await readFile(path);
+    }
+  }
+
+  const { instance } = await WebAssembly.instantiate(wasmBytes, {});
+  wasmInstance = instance.exports;
+  return wasmInstance;
+}