@ruvector/rvf-node 0.2.0 → 0.2.1

package/README.md

@@ -18,56 +18,6 @@ npm install @ruvector/rvf-node
 - **Kernel & eBPF embedding** — embed compute alongside vector data
 - **Segment inspection** — enumerate all segments in the file
 - **Cross-platform** — Linux (x86_64, aarch64), macOS (x86_64, Apple Silicon), Windows (x86_64)
-- **AGI methods** — HNSW index stats, witness chain verification, state freeze, metric introspection
-
-## AGI Methods
-
-Four introspection and integrity methods for advanced use cases.
-
-### `db.indexStats()` → `RvfIndexStats`
-
-Returns HNSW index statistics.
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `indexedVectors` | `number` | Number of indexed vectors |
-| `layers` | `number` | Number of HNSW layers |
-| `m` | `number` | M parameter (max edges per node per layer) |
-| `efConstruction` | `number` | ef_construction parameter |
-| `needsRebuild` | `boolean` | Whether index needs rebuilding (dead_space_ratio > 0.3) |
-
-### `db.verifyWitness()` → `RvfWitnessResult`
-
-Verifies SHAKE-256 witness chain integrity.
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `valid` | `boolean` | Whether the chain is valid |
-| `entries` | `number` | Number of entries in the chain |
-| `error` | `string?` | Error message if invalid |
-
-### `db.freeze()` → `number`
-
-Snapshot-freeze current state. Returns the epoch number.
-
-### `db.metric()` → `string`
-
-Returns the distance metric name (`"l2"`, `"cosine"`, or `"inner_product"`).
-
-### Usage Example
-
-```javascript
-const stats = db.indexStats();
-console.log(`Indexed: ${stats.indexedVectors}, HNSW layers: ${stats.layers}`);
-
-const witness = db.verifyWitness();
-console.log(`Witness chain: ${witness.entries} entries, valid: ${witness.valid}`);
-
-console.log(`Distance metric: ${db.metric()}`);
-
-const epoch = db.freeze();
-console.log(`State frozen at epoch ${epoch}`);
-```
 
 ## Quick Start
 
@@ -305,31 +255,6 @@ const segments = db.segments();
 db.dimension(); // 384
 ```
 
-## Self-Booting RVF
-
-An `.rvf` file can embed a Linux kernel, eBPF programs, and SSH keys alongside vector data — producing a single file that boots as a microservice.
-
-The Claude Code Appliance example builds a complete AI dev environment:
-
-```bash
-cd examples/rvf
-cargo run --example claude_code_appliance
-```
-
-```
-claude_code_appliance.rvf
-  ├── KERNEL_SEG    Linux 6.8.12 bzImage (5.2 MB, x86_64)
-  ├── EBPF_SEG      Socket filter — ports 2222, 8080 only
-  ├── VEC_SEG       20 package embeddings (128-dim)
-  ├── INDEX_SEG     HNSW graph for package search
-  ├── WITNESS_SEG   6-entry tamper-evident audit trail
-  └── CRYPTO_SEG    3 Ed25519 SSH user keys
-```
-
-Final file: **5.1 MB single `.rvf`** — boots Linux, serves queries, runs Claude Code.
-
-See the [full RVF documentation](https://github.com/ruvnet/ruvector/tree/main/crates/rvf) for details.
-
 ## Build from Source
 
 ```bash

package/index.d.ts

@@ -1,95 +1,281 @@
-/* auto-generated: TypeScript declarations for @ruvector/rvf-node */
+/* tslint:disable */
+/* eslint-disable */
 
+/* auto-generated by NAPI-RS */
+
+/** Options for creating a new RVF store. */
 export interface RvfOptions {
-  dimension: number;
-  metric?: string;
-  profile?: number;
-  signing?: boolean;
-  m?: number;
-  efConstruction?: number;
+  /** Vector dimensionality (required). */
+  dimension: number
+  /** Distance metric: "l2" | "inner_product" | "cosine". Defaults to "l2". */
+  metric?: string
+  /** Hardware profile: 0=Generic, 1=Core, 2=Hot, 3=Full. Defaults to 0. */
+  profile?: number
+  /** Compression profile: "None" | "Scalar" | "Product". Defaults to "None". */
+  compression?: string
+  /** Whether segment signing is enabled. Defaults to false. */
+  signing?: boolean
+  /** HNSW M parameter. Defaults to 16. */
+  m?: number
+  /** HNSW ef_construction parameter. Defaults to 200. */
+  efConstruction?: number
 }
-
+/**
+ * Options for a query operation.
+ *
+ * The `filter` field accepts a JSON string encoding a recursive filter tree.
+ * See `RvfDatabase.query()` for the filter expression format.
+ */
 export interface RvfQueryOptions {
-  efSearch?: number;
-  filter?: string;
-  timeoutMs?: number;
+  /** HNSW ef_search parameter. Defaults to 100. */
+  efSearch?: number
+  /**
+   * Optional filter expression as a JSON string.
+   *
+   * Format examples:
+   *   `{"op":"eq","fieldId":0,"valueType":"string","value":"cat_a"}`
+   *   `{"op":"and","children":[...]}`
+   *   `{"op":"not","child":{...}}`
+   */
+  filter?: string
+  /** Query timeout in milliseconds. 0 = no timeout. */
+  timeoutMs?: number
 }
-
+/** A single search result returned from a query. */
 export interface RvfSearchResult {
-  id: number;
-  distance: number;
+  /** The vector's unique identifier. */
+  id: number
+  /** Distance from the query vector (lower = more similar). */
+  distance: number
 }
-
+/** Result of a batch ingest operation. */
 export interface RvfIngestResult {
-  accepted: number;
-  rejected: number;
-  epoch: number;
+  /** Number of vectors successfully ingested. */
+  accepted: number
+  /** Number of vectors rejected (dimension mismatch, etc.). */
+  rejected: number
+  /** Manifest epoch after commit. */
+  epoch: number
 }
-
+/** Result of a delete operation. */
 export interface RvfDeleteResult {
-  deleted: number;
-  epoch: number;
+  /** Number of vectors deleted. */
+  deleted: number
+  /** Manifest epoch after commit. */
+  epoch: number
 }
-
-export interface RvfCompactionResult {
-  segmentsCompacted: number;
-  bytesReclaimed: number;
-  epoch: number;
-}
-
+/** Current store status snapshot. */
 export interface RvfStatus {
-  totalVectors: number;
-  totalSegments: number;
-  fileSize: number;
-  currentEpoch: number;
-  profileId: number;
-  compactionState: string;
-  deadSpaceRatio: number;
-  readOnly: boolean;
+  /** Total number of live (non-deleted) vectors. */
+  totalVectors: number
+  /** Total number of segments in the file. */
+  totalSegments: number
+  /** Total file size in bytes. */
+  fileSize: number
+  /** Current manifest epoch. */
+  currentEpoch: number
+  /** Hardware profile identifier. */
+  profileId: number
+  /** Current compaction state: "idle" | "running" | "emergency". */
+  compactionState: string
+  /** Ratio of dead (deleted) space to total (0.0 - 1.0). */
+  deadSpaceRatio: number
+  /** Whether the store is open in read-only mode. */
+  readOnly: boolean
 }
-
+/** Result of a compaction operation. */
+export interface RvfCompactionResult {
+  /** Number of segments compacted. */
+  segmentsCompacted: number
+  /** Bytes of dead space reclaimed. */
+  bytesReclaimed: number
+  /** Manifest epoch after compaction. */
+  epoch: number
+}
+/** A metadata entry for ingest: { fieldId, valueType, value }. */
 export interface RvfMetadataEntry {
-  fieldId: number;
-  valueType: string;
-  value: string;
+  /** Metadata field identifier. */
+  fieldId: number
+  /** Value type: "u64" | "i64" | "f64" | "string". */
+  valueType: string
+  /** The value as a string representation (parsed based on value_type). */
+  value: string
 }
-
+/** Data returned from kernel extraction. */
 export interface RvfKernelData {
-  header: Buffer;
-  image: Buffer;
+  /** Serialized 128-byte KernelHeader. */
+  header: Buffer
+  /** Raw kernel image bytes. */
+  image: Buffer
 }
-
+/** Data returned from eBPF extraction. */
 export interface RvfEbpfData {
-  header: Buffer;
-  payload: Buffer;
+  /** Serialized 64-byte EbpfHeader. */
+  header: Buffer
+  /** Program bytecode + optional BTF. */
+  payload: Buffer
 }
-
+/** Information about a segment in the store. */
 export interface RvfSegmentInfo {
-  id: number;
-  offset: number;
-  payloadLength: number;
-  segType: string;
+  /** Segment ID. */
+  id: number
+  /** File offset of the segment. */
+  offset: number
+  /** Payload length in bytes. */
+  payloadLength: number
+  /** Segment type as a string (e.g. "vec", "manifest", "kernel"). */
+  segType: string
 }
-
-export class RvfDatabase {
-  static create(path: string, options: RvfOptions): RvfDatabase;
-  static open(path: string): RvfDatabase;
-  static openReadonly(path: string): RvfDatabase;
-  ingestBatch(vectors: Float32Array, ids: number[], metadata?: RvfMetadataEntry[]): RvfIngestResult;
-  query(vector: Float32Array, k: number, options?: RvfQueryOptions): RvfSearchResult[];
-  delete(ids: number[]): RvfDeleteResult;
-  deleteByFilter(filterJson: string): RvfDeleteResult;
-  compact(): RvfCompactionResult;
-  status(): RvfStatus;
-  close(): void;
-  fileId(): string;
-  parentId(): string;
-  lineageDepth(): number;
-  derive(childPath: string, options?: RvfOptions): RvfDatabase;
-  embedKernel(arch: number, kernelType: number, flags: number, image: Buffer, apiPort: number, cmdline?: string): number;
-  extractKernel(): RvfKernelData | null;
-  embedEbpf(programType: number, attachType: number, maxDimension: number, bytecode: Buffer, btf?: Buffer): number;
-  extractEbpf(): RvfEbpfData | null;
-  segments(): RvfSegmentInfo[];
-  dimension(): number;
+/** HNSW index statistics. */
+export interface RvfIndexStats {
+  /** Number of indexed vectors. */
+  indexedVectors: number
+  /** Number of HNSW layers. */
+  layers: number
+  /** M parameter (max edges per node per layer). */
+  m: number
+  /** ef_construction parameter. */
+  efConstruction: number
+  /** Whether the index needs rebuilding. */
+  needsRebuild: boolean
+}
+/** Result of witness chain verification. */
+export interface RvfWitnessResult {
+  /** Whether the witness chain is valid. */
+  valid: boolean
+  /** Number of entries in the chain. */
+  entries: number
+  /** Error message if invalid. */
+  error?: string
+}
+/** Quantization configuration. */
+export interface RvfQuantConfig {
+  /** Quantization mode: "none" | "scalar" | "product" | "binary". */
+  mode: string
+  /** Number of subquantizers (for product quantization). */
+  numSubquantizers?: number
+  /** Number of centroids per subquantizer. */
+  numCentroids?: number
+}
+/**
+ * The main RVF database handle exposed to Node.js.
+ *
+ * All mutating methods acquire an internal mutex so the handle is safe
+ * to share across async operations (though RVF itself is single-writer).
+ */
+export declare class RvfDatabase {
+  /** Create a new RVF store at the given file path. */
+  static create(path: string, options: RvfOptions): RvfDatabase
+  /** Open an existing RVF store for read-write access. */
+  static open(path: string): RvfDatabase
+  /** Open an existing RVF store for read-only access (no lock required). */
+  static openReadonly(path: string): RvfDatabase
+  /**
+   * Ingest a batch of vectors.
+   *
+   * `vectors` is a flat Float32Array of length `n * dimension`.
+   * `ids` is a number[] of vector IDs.
+   * `metadata` is an optional array of metadata entries.
+   */
+  ingestBatch(vectors: Float32Array, ids: Array<number>, metadata?: Array<RvfMetadataEntry> | undefined | null): RvfIngestResult
+  /**
+   * Query for the k nearest neighbors of the given vector.
+   *
+   * `vector` is a Float32Array of length `dimension`.
+   * `k` is the number of neighbors to return.
+   * `options` provides optional filter (as JSON string) and search parameters.
+   *
+   * Filter expression JSON format:
+   * - Leaf: `{"op":"eq","fieldId":0,"valueType":"string","value":"cat_a"}`
+   * - Boolean: `{"op":"and","children":[...]}`
+   * - Not: `{"op":"not","child":{...}}`
+   * - In: `{"op":"in","fieldId":0,"valueType":"u64","values":["1","2"]}`
+   * - Range: `{"op":"range","fieldId":1,"valueType":"u64","low":"10","high":"50"}`
+   */
+  query(vector: Float32Array, k: number, options?: RvfQueryOptions | undefined | null): Array<RvfSearchResult>
+  /** Soft-delete vectors by ID. */
+  delete(ids: Array<number>): RvfDeleteResult
+  /**
+   * Soft-delete vectors matching a filter expression (passed as JSON string).
+   *
+   * See `query()` for the filter expression JSON format.
+   */
+  deleteByFilter(filterJson: string): RvfDeleteResult
+  /** Run compaction to reclaim dead space from deleted vectors. */
+  compact(): RvfCompactionResult
+  /** Get a snapshot of the current store status. */
+  status(): RvfStatus
+  /**
+   * Close the store, releasing the writer lock and flushing data.
+   *
+   * After calling close(), all other methods will return an error.
+   */
+  close(): void
+  /** Get this file's unique identifier as a hex string. */
+  fileId(): string
+  /** Get the parent file's identifier as a hex string (all zeros if root). */
+  parentId(): string
+  /** Get the lineage depth (0 for root files). */
+  lineageDepth(): number
+  /** Derive a child store from this parent. */
+  derive(childPath: string, options?: RvfOptions | undefined | null): RvfDatabase
+  /**
+   * Create a **queryable** copy-on-write branch of this store.
+   *
+   * Unlike [`derive`](Self::derive) — which records lineage only and
+   * produces a child that can see just its own edits — `branch` wires a
+   * real COW engine and membership filter so the child inherits the
+   * parent's vectors. Querying the child returns `parent ∪ child-edits`:
+   * the child's re-ingested vectors override the parent on an id
+   * collision, and deletes in the child hide inherited vectors. The
+   * branch stores only its own edits on disk, so it stays small
+   * regardless of the parent's size.
+   *
+   * The parent should be frozen (see [`freeze`](Self::freeze)) before
+   * branching to guarantee immutability of the inherited data.
+   */
+  branch(childPath: string): RvfDatabase
+  /**
+   * Embed a kernel image into this RVF file.
+   * Returns the segment ID of the new kernel segment.
+   */
+  embedKernel(arch: number, kernelType: number, flags: number, image: Buffer, apiPort: number, cmdline?: string | undefined | null): number
+  /**
+   * Extract the kernel image from this RVF file.
+   * Returns null if no kernel segment is present.
+   */
+  extractKernel(): RvfKernelData | null
+  /**
+   * Embed an eBPF program into this RVF file.
+   * Returns the segment ID of the new eBPF segment.
+   */
+  embedEbpf(programType: number, attachType: number, maxDimension: number, bytecode: Buffer, btf?: Buffer | undefined | null): number
+  /**
+   * Extract the eBPF program from this RVF file.
+   * Returns null if no eBPF segment is present.
+   */
+  extractEbpf(): RvfEbpfData | null
+  /** Get the list of segments in the store. */
+  segments(): Array<RvfSegmentInfo>
+  /** Get the vector dimensionality of this store. */
+  dimension(): number
+  /** Get HNSW index statistics for this store. */
+  indexStats(): RvfIndexStats
+  /**
+   * Verify the tamper-evident witness chain in this store.
+   *
+   * Counts the witness segments present in the segment directory and
+   * checks whether the chain has been initialised (non-zero terminal
+   * hash).  Returns the number of witness entries and validity status.
+   */
+  verifyWitness(): RvfWitnessResult
+  /**
+   * Snapshot-freeze the current state of the store.
+   *
+   * Sets the store to read-only mode, preventing further writes.
+   * Returns the manifest epoch at freeze time.
+   */
+  freeze(): number
+  /** Get the distance metric used by this store. */
+  metric(): string
 }

package/index.js

@@ -1,150 +1,315 @@
+/* tslint:disable */
 /* eslint-disable */
-/* auto-generated: NAPI-RS platform loader for @ruvector/rvf-node */
+/* prettier-ignore */
 
-const { existsSync, readFileSync } = require('fs');
-const { join } = require('path');
+/* auto-generated by NAPI-RS */
 
-const { platform, arch } = process;
+const { existsSync, readFileSync } = require('fs')
+const { join } = require('path')
 
-let nativeBinding = null;
-let localFileExisted = false;
-let loadError = null;
+const { platform, arch } = process
+
+let nativeBinding = null
+let localFileExisted = false
+let loadError = null
 
 function isMusl() {
-  // For Node 12+, check report.header.glibcVersionRuntime
+  // For Node 10
   if (!process.report || typeof process.report.getReport !== 'function') {
     try {
-      const lddPath = require('child_process')
-        .execSync('which ldd')
-        .toString()
-        .trim();
-      return readFileSync(lddPath, 'utf8').includes('musl');
-    } catch {
-      return true;
+      const lddPath = require('child_process').execSync('which ldd').toString().trim()
+      return readFileSync(lddPath, 'utf8').includes('musl')
+    } catch (e) {
+      return true
     }
   } else {
-    const report = process.report.getReport();
-    const rep = typeof report === 'string' ? JSON.parse(report) : report;
-    return !rep.header.glibcVersionRuntime;
+    const { glibcVersionRuntime } = process.report.getReport().header
+    return !glibcVersionRuntime
   }
 }
 
 switch (platform) {
-  case 'darwin':
+  case 'android':
+    switch (arch) {
+      case 'arm64':
+        localFileExisted = existsSync(join(__dirname, 'index.android-arm64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.android-arm64.node')
+          } else {
+            nativeBinding = require('@ruvector/rvf-node-android-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm':
+        localFileExisted = existsSync(join(__dirname, 'index.android-arm-eabi.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.android-arm-eabi.node')
+          } else {
+            nativeBinding = require('@ruvector/rvf-node-android-arm-eabi')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Android ${arch}`)
+    }
+    break
+  case 'win32':
     switch (arch) {
       case 'x64':
-        localFileExisted = existsSync(join(__dirname, 'rvf-node.darwin-x64.node'));
+        localFileExisted = existsSync(
+          join(__dirname, 'index.win32-x64-msvc.node')
+        )
         try {
           if (localFileExisted) {
-            nativeBinding = require('./rvf-node.darwin-x64.node');
+            nativeBinding = require('./index.win32-x64-msvc.node')
           } else {
-            nativeBinding = require('@ruvector/rvf-node-darwin-x64');
+            nativeBinding = require('@ruvector/rvf-node-win32-x64-msvc')
           }
         } catch (e) {
-          loadError = e;
+          loadError = e
         }
-        break;
+        break
+      case 'ia32':
+        localFileExisted = existsSync(
+          join(__dirname, 'index.win32-ia32-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.win32-ia32-msvc.node')
+          } else {
+            nativeBinding = require('@ruvector/rvf-node-win32-ia32-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
       case 'arm64':
-        localFileExisted = existsSync(join(__dirname, 'rvf-node.darwin-arm64.node'));
+        localFileExisted = existsSync(
+          join(__dirname, 'index.win32-arm64-msvc.node')
+        )
         try {
           if (localFileExisted) {
-            nativeBinding = require('./rvf-node.darwin-arm64.node');
+            nativeBinding = require('./index.win32-arm64-msvc.node')
           } else {
-            nativeBinding = require('@ruvector/rvf-node-darwin-arm64');
+            nativeBinding = require('@ruvector/rvf-node-win32-arm64-msvc')
           }
         } catch (e) {
-          loadError = e;
+          loadError = e
         }
-        break;
+        break
       default:
-        throw new Error(`Unsupported architecture on macOS: ${arch}`);
+        throw new Error(`Unsupported architecture on Windows: ${arch}`)
     }
-    break;
-  case 'win32':
+    break
+  case 'darwin':
+    localFileExisted = existsSync(join(__dirname, 'index.darwin-universal.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./index.darwin-universal.node')
+      } else {
+        nativeBinding = require('@ruvector/rvf-node-darwin-universal')
+      }
+      break
+    } catch {}
     switch (arch) {
       case 'x64':
-        localFileExisted = existsSync(join(__dirname, 'rvf-node.win32-x64-msvc.node'));
+        localFileExisted = existsSync(join(__dirname, 'index.darwin-x64.node'))
         try {
           if (localFileExisted) {
-            nativeBinding = require('./rvf-node.win32-x64-msvc.node');
+            nativeBinding = require('./index.darwin-x64.node')
           } else {
-            nativeBinding = require('@ruvector/rvf-node-win32-x64-msvc');
+            nativeBinding = require('@ruvector/rvf-node-darwin-x64')
           }
         } catch (e) {
-          loadError = e;
+          loadError = e
         }
-        break;
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'index.darwin-arm64.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.darwin-arm64.node')
+          } else {
+            nativeBinding = require('@ruvector/rvf-node-darwin-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
       default:
-        throw new Error(`Unsupported architecture on Windows: ${arch}`);
+        throw new Error(`Unsupported architecture on macOS: ${arch}`)
+    }
+    break
+  case 'freebsd':
+    if (arch !== 'x64') {
+      throw new Error(`Unsupported architecture on FreeBSD: ${arch}`)
+    }
+    localFileExisted = existsSync(join(__dirname, 'index.freebsd-x64.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./index.freebsd-x64.node')
+      } else {
+        nativeBinding = require('@ruvector/rvf-node-freebsd-x64')
+      }
+    } catch (e) {
+      loadError = e
     }
-    break;
+    break
   case 'linux':
     switch (arch) {
       case 'x64':
         if (isMusl()) {
-          localFileExisted = existsSync(join(__dirname, 'rvf-node.linux-x64-musl.node'));
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-x64-musl.node')
+          )
           try {
             if (localFileExisted) {
-              nativeBinding = require('./rvf-node.linux-x64-musl.node');
+              nativeBinding = require('./index.linux-x64-musl.node')
             } else {
-              nativeBinding = require('@ruvector/rvf-node-linux-x64-musl');
+              nativeBinding = require('@ruvector/rvf-node-linux-x64-musl')
             }
           } catch (e) {
-            loadError = e;
+            loadError = e
           }
         } else {
-          localFileExisted = existsSync(join(__dirname, 'rvf-node.linux-x64-gnu.node'));
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-x64-gnu.node')
+          )
           try {
             if (localFileExisted) {
-              nativeBinding = require('./rvf-node.linux-x64-gnu.node');
+              nativeBinding = require('./index.linux-x64-gnu.node')
             } else {
-              nativeBinding = require('@ruvector/rvf-node-linux-x64-gnu');
+              nativeBinding = require('@ruvector/rvf-node-linux-x64-gnu')
             }
           } catch (e) {
-            loadError = e;
+            loadError = e
           }
         }
-        break;
+        break
       case 'arm64':
         if (isMusl()) {
-          localFileExisted = existsSync(join(__dirname, 'rvf-node.linux-arm64-musl.node'));
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-arm64-musl.node')
+          )
           try {
             if (localFileExisted) {
-              nativeBinding = require('./rvf-node.linux-arm64-musl.node');
+              nativeBinding = require('./index.linux-arm64-musl.node')
             } else {
-              nativeBinding = require('@ruvector/rvf-node-linux-arm64-musl');
+              nativeBinding = require('@ruvector/rvf-node-linux-arm64-musl')
             }
           } catch (e) {
-            loadError = e;
+            loadError = e
           }
         } else {
-          localFileExisted = existsSync(join(__dirname, 'rvf-node.linux-arm64-gnu.node'));
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-arm64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./index.linux-arm64-gnu.node')
+            } else {
+              nativeBinding = require('@ruvector/rvf-node-linux-arm64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-arm-musleabihf.node')
+          )
           try {
             if (localFileExisted) {
-              nativeBinding = require('./rvf-node.linux-arm64-gnu.node');
+              nativeBinding = require('./index.linux-arm-musleabihf.node')
             } else {
-              nativeBinding = require('@ruvector/rvf-node-linux-arm64-gnu');
+              nativeBinding = require('@ruvector/rvf-node-linux-arm-musleabihf')
             }
           } catch (e) {
-            loadError = e;
+            loadError = e
           }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-arm-gnueabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./index.linux-arm-gnueabihf.node')
+            } else {
+              nativeBinding = require('@ruvector/rvf-node-linux-arm-gnueabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'riscv64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-riscv64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./index.linux-riscv64-musl.node')
+            } else {
+              nativeBinding = require('@ruvector/rvf-node-linux-riscv64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-riscv64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./index.linux-riscv64-gnu.node')
+            } else {
+              nativeBinding = require('@ruvector/rvf-node-linux-riscv64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 's390x':
+        localFileExisted = existsSync(
+          join(__dirname, 'index.linux-s390x-gnu.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.linux-s390x-gnu.node')
+          } else {
+            nativeBinding = require('@ruvector/rvf-node-linux-s390x-gnu')
+          }
+        } catch (e) {
+          loadError = e
         }
-        break;
+        break
       default:
-        throw new Error(`Unsupported architecture on Linux: ${arch}`);
+        throw new Error(`Unsupported architecture on Linux: ${arch}`)
     }
-    break;
+    break
   default:
-    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`);
+    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`)
 }
 
 if (!nativeBinding) {
   if (loadError) {
-    throw loadError;
+    throw loadError
   }
-  throw new Error('Failed to load native binding');
+  throw new Error(`Failed to load native binding`)
 }
 
-const { RvfDatabase } = nativeBinding;
+const { RvfDatabase } = nativeBinding
 
-module.exports.RvfDatabase = RvfDatabase;
+module.exports.RvfDatabase = RvfDatabase

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@ruvector/rvf-node",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "RuVector Format Node.js native bindings",
   "main": "index.js",
   "types": "index.d.ts",
   "files": [
     "index.js",
     "index.d.ts",
-    "*.node"
+    "README.md",
+    "package.json"
   ],
   "napi": {
     "binaryName": "rvf-node",
@@ -20,25 +21,16 @@
     ]
   },
   "scripts": {
-    "build": "napi build --platform --release"
+    "build": "napi build --platform --release",
+    "prepublishOnly": "napi prepublish -t npm"
   },
   "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/ruvnet/ruvector"
-  },
-  "engines": {
-    "node": ">= 16"
-  },
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org/",
-    "access": "public"
+  "devDependencies": {
+    "@napi-rs/cli": "^2.18.0"
   },
   "optionalDependencies": {
-    "@ruvector/rvf-node-linux-x64-gnu": "0.2.0",
-    "@ruvector/rvf-node-darwin-x64": "0.1.7",
-    "@ruvector/rvf-node-darwin-arm64": "0.1.7",
-    "@ruvector/rvf-node-win32-x64-msvc": "0.1.7",
-    "@ruvector/rvf-node-linux-arm64-gnu": "0.1.7"
+    "@ruvector/rvf-node-win32-x64-msvc": "0.2.1",
+    "@ruvector/rvf-node-darwin-x64": "0.2.1",
+    "@ruvector/rvf-node-linux-x64-gnu": "0.2.1"
   }
-}
+}