Browser docs advertise unshipped RVF APIs; WasmBackend has no persistence export/import
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.7agentdb@3.0.0-alpha.17
Observed published surfaces
@ruvector/rvf@0.2.3exports a workingWasmBackend; create, ingest, query, and status work in memory.- The advertised
WasmRvfStoresymbol is absent from@ruvector/rvf-wasm. - The high-level
RvfDatabaseexposes no byte export/open API, so the working WASM database cannot be durably saved through the public SDK. agentdb/browseris 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
- Correct the READMEs/examples to describe the currently shipped in-memory
WasmBackend. - Expose a supported
exportBytes()/openBytes()or equivalent API throughWasmBackend/RvfDatabase. - Provide or document an IndexedDB/OPFS persistence adapter.
- 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
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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