Skip to content

@ruvector/wasm 0.1.31 — corrected WASM adapter

Choose a tag to compare

View all tags
@ruvnet ruvnet released this 15 Jun 02:16
· 588 commits to main since this release
ruvector-wasm-v0.1.31
054d815

@ruvector/wasm 0.1.31

Ships the RuvectorWasmAdapter (@ruvector/wasm/adapter) from #568 and restores a functional published package — 0.1.30 had shipped with only package.json (empty pkg/); 0.1.31 includes the built web pkg/ (WASM + JS bindings) plus the adapter.

The adapter corrects three behaviours of the raw WASM build

  1. HNSW not active — the wasm32 target compiles without the hnsw feature and falls back to a flat (brute-force) index. The adapter surfaces this via indexType / WASM_HNSW_AVAILABLE instead of letting callers assume O(log n).
  2. score was a cosine distance (lower is better), contradicting the .d.ts. The adapter exposes a real similarity = 1 - distance (per-metric) so "higher is better" holds, with the raw distance preserved.
  3. Metadata did not round-trip — search/get returned {}. The adapter keeps an in-process metadata sidecar keyed by id and re-attaches it on the way out.

Usage

import { RuvectorWasmAdapter } from '@ruvector/wasm/adapter';
const index = await RuvectorWasmAdapter.create({ dimensions: 384, metric: 'cosine' });
index.insert({ id: 'doc_1', vector: embedding, metadata: { title: 'My Document' } });
const results = index.search({ vector: query, k: 10 });
// results[i].similarity (higher better), .distance (raw), .metadata (round-trips), index.indexType ('flat')
Assets 2
Loading