reddb-cli

library0.1.5jsnpmunverified

RedDB is a unified multi-model database SDK for JavaScript/TypeScript that supports document store, key-value, graph, and vector search within a single embedded Rust runtime. Current stable version is 0.1.5 (pre-release). Release cadence is rapid with nightly pre-release builds. Key differentiators: single binary deployment, no external dependencies, multi-model queries across paradigms, and a CLI tool for direct database management. Ships TypeScript definitions. Requires Node.js >=20.

database

npm install reddb-cli

INSTALL

IMPORT

SIG · REDDB-CLI

reddb-cli

databasejavascriptv0.1.5

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

createClient

✓ import { createClient } from 'reddb'

✗ const { createClient } = require('reddb')

ESM-only in Node >=20. CommonJS require will fail.

RedDB

✓ import { RedDB } from 'reddb'

Default import is not available. Always use named import.

Query

✓ import type { Query } from 'reddb'

✗ import { Query } from 'reddb'

Query is a type only, use type import to avoid runtime errors.

Connects to local RedDB server, inserts a document, retrieves it, and closes connection.

import { createClient } from 'reddb'; const client = createClient({ url: process.env.REDDB_URL ?? 'http://localhost:8080' }); await client.connect(); const db = client.db('mydb'); await db.collection('users').insertOne({ name: 'Alice', age: 30 }); const user = await db.collection('users').findOne({ name: 'Alice' }); console.log(user); await client.close();

reddb --version

Debug

Known issues

breakingAPI not stable under v1.0.0 — methods and signatures may change without major version bump.

fix

Pin to exact version and test upgrades thoroughly.

affects: <1.0.0

breakingNode.js <20 is not supported; engine requirement is >=20. Installing on older Node will silently fail at runtime.

fix

Upgrade Node.js to 20+.

affects: >=0.1.0

deprecatedThe default export `RedDB` (as class) is deprecated since v0.1.5-next. Use `createClient` factory function instead.

fix

Replace `new RedDB(config)` with `createClient(config)`.

affects: >=0.1.5-next

gotchaVector search queries require explicit index creation before use; otherwise they return empty results silently.

fix

Call `db.collection('vectors').createIndex({ field: 'embedding', type: 'vector' })` first.

affects: >=0.1.0

Errors

Common errors & fixes

ERR_MODULE_NOT_FOUND: Cannot find package 'reddb'

Package not installed or missing from package.json.

fix

Run `npm install reddb` or `pnpm add reddb`.

TypeError: reddb.createClient is not a function

Using CommonJS `require` instead of ESM `import`.

fix

Change `const { createClient } = require('reddb')` to `import { createClient } from 'reddb'`.

Upgrade

Version history

0.1.5latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

7 hits · last 30 days

node