ruvnet / ruvnet/RuVector

Browser docs advertise unshipped RVF APIs; WasmBackend has no persistence export/import

Open
#705 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Rust
Stars
4.5k
Forks
603
Avg merge
23h 32m
Merged PRs (30d)
59

Description

Versions

  • @ruvector/rvf@0.2.3
  • @ruvector/rvf-wasm@0.1.7
  • agentdb@3.0.0-alpha.17

Observed published surfaces

  • @ruvector/rvf@0.2.3 exports a working WasmBackend; create, ingest, query, and status work in memory.
  • The advertised WasmRvfStore symbol is absent from @ruvector/rvf-wasm.
  • The high-level RvfDatabase exposes no byte export/open API, so the working WASM database cannot be durably saved through the public SDK.
  • agentdb/browser is documented but is not exported.
  • None of these packages declares a React Native entry point.

Exact-name repository searches found WasmRvfStore and createBrowserDb in documentation/examples, not in the shipped implementation.

Impact

A browser integration can work during one page lifetime but cannot implement supported IndexedDB/OPFS persistence through the high-level API. Consumers following the examples receive missing-export errors. React Native/Expo users may also mistake a mobile C FFI design for a published JavaScript integration.

Requested fix

  1. Correct the READMEs/examples to describe the currently shipped in-memory WasmBackend.
  2. Expose a supported exportBytes() / openBytes() or equivalent API through WasmBackend/RvfDatabase.
  3. Provide or document an IndexedDB/OPFS persistence adapter.
  4. Document React Native/Expo as unsupported unless and until a native module/package is published.

This is primarily a feature/design-gap report; the documentation mismatch can be fixed independently and immediately.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the READMEs and examples that mention WasmRvfStore, createBrowserDb, agentdb/browser, and React Native, then compare them with the shipped WasmBackend and RvfDatabase surfaces. Verify the documented exports and persistence behavior against the published package versions. Done means the documentation matches supported behavior, unsupported React Native usage is explicit, and any new persistence surface and adapter are documented.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript, react-native, rust, wasm
Domain
backend, databases, documentation
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.