@ruvector/rvf-node 0.3.1 → 0.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,3 +1,5 @@
1
+ <p align="center"><img src="https://raw.githubusercontent.com/ruvnet/RuVector/main/assets/ruvector/packages/rvf-node.svg" alt="@ruvector/rvf-node: Native Node.js bindings for the RuVector Format (RVF) vector database, built with Rust via N-API." width="100%"></p>
2
+
1
3
  # @ruvector/rvf-node
2
4
 
3
5
  Native Node.js bindings for the [RuVector Format](https://github.com/ruvnet/ruvector/tree/main/crates/rvf) (RVF) vector database. Built with Rust via N-API for native speed with zero serialization overhead.
@@ -119,6 +121,7 @@ db.close();
119
121
  | `dimension` | `number` | required | Vector dimensionality |
120
122
  | `metric` | `string` | `"l2"` | `"l2"`, `"cosine"`, or `"inner_product"` |
121
123
  | `profile` | `number` | `0` | Hardware profile: 0=Generic, 1=Core, 2=Hot, 3=Full |
124
+ | `compression` | `string` | `"None"` | `"None"`, `"Scalar"`, or `"Product"` |
122
125
  | `signing` | `boolean` | `false` | Enable segment signing |
123
126
  | `m` | `number` | `16` | HNSW M parameter (neighbor count) |
124
127
  | `efConstruction` | `number` | `200` | HNSW index build quality |
@@ -253,6 +256,9 @@ db.lineageDepth(); // 0 for root files
253
256
  const child = db.derive('/tmp/child.rvf');
254
257
  child.lineageDepth(); // 1
255
258
  child.parentId(); // matches parent's fileId()
259
+
260
+ // Copy-on-write branch: reads inherited vectors, persists only child edits
261
+ const branch = db.branch('/tmp/branch.rvf');
256
262
  ```
257
263
 
258
264
  ### Kernel & eBPF Embedding
@@ -339,15 +345,15 @@ npm install
339
345
  npm run build
340
346
  ```
341
347
 
342
- ## Related Packages
348
+ ## Related packages
349
+
350
+ - [`@ruvector/rvf`](https://www.npmjs.com/package/@ruvector/rvf) — async TypeScript SDK that uses this addon as its `'node'` backend (string IDs, typed filters).
351
+ - [`@ruvector/rvf-wasm`](https://www.npmjs.com/package/@ruvector/rvf-wasm) — WASM build of RVF for browsers and edge runtimes.
352
+ - [`@ruvector/rvf-mcp-server`](https://www.npmjs.com/package/@ruvector/rvf-mcp-server) — MCP server exposing RVF stores to AI agents.
353
+ - [`ruvector`](https://www.npmjs.com/package/ruvector) — umbrella package and CLI (`npx ruvector`).
343
354
 
344
- | Package | Description |
345
- |---------|-------------|
346
- | [`@ruvector/rvf`](https://www.npmjs.com/package/@ruvector/rvf) | Unified TypeScript SDK |
347
- | [`@ruvector/rvf-wasm`](https://www.npmjs.com/package/@ruvector/rvf-wasm) | Browser WASM package |
348
- | [`@ruvector/rvf-mcp-server`](https://www.npmjs.com/package/@ruvector/rvf-mcp-server) | MCP server for AI agents |
349
- | [`rvf-runtime`](https://crates.io/crates/rvf-runtime) | Rust runtime (powers this package) |
355
+ The Rust crate powering this package is [`rvf-runtime`](https://crates.io/crates/rvf-runtime).
350
356
 
351
357
  ## License
352
358
 
353
- MIT OR Apache-2.0
359
+ MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ruvector/rvf-node",
3
- "version": "0.3.1",
3
+ "version": "0.3.2",
4
4
  "description": "RuVector Format Node.js native bindings",
5
5
  "main": "index.js",
6
6
  "types": "index.d.ts",
@@ -22,10 +22,26 @@
22
22
  "scripts": {
23
23
  "build": "napi build --platform --release"
24
24
  },
25
+ "keywords": [
26
+ "ruvector",
27
+ "rvf",
28
+ "vector-database",
29
+ "vector-search",
30
+ "hnsw",
31
+ "napi",
32
+ "napi-rs",
33
+ "nodejs",
34
+ "rust"
35
+ ],
25
36
  "license": "MIT",
26
37
  "repository": {
27
38
  "type": "git",
28
- "url": "https://github.com/ruvnet/ruvector"
39
+ "url": "git+https://github.com/ruvnet/ruvector.git",
40
+ "directory": "npm/packages/rvf-node"
41
+ },
42
+ "homepage": "https://github.com/ruvnet/ruvector/tree/main/npm/packages/rvf-node#readme",
43
+ "bugs": {
44
+ "url": "https://github.com/ruvnet/ruvector/issues"
29
45
  },
30
46
  "engines": {
31
47
  "node": ">= 16"
Binary file