dubnium

library0.0.0jsnpmunverified

Dubnium is a powerful local database for Node.js (v4.2.0, latest stable). It provides a simple API to create, read, update, and delete records stored as files on disk. Designed for small to medium projects where a full database server is unnecessary. Supports both CommonJS and ECMAScript modules. Active development on GitHub with regular releases. Key differentiator: lightweight zero-dependency solution with synchronous and async operations.

database

npm install dubnium

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · DUBNIUM

dubnium

databasejavascriptv0.0.0

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

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

Dubnium

✓ import Dubnium from 'dubnium'

✗ const { Dubnium } = require('dubnium')

Default export; named import will fail.

Dubnium (CommonJS)

✓ const Dubnium = require('dubnium')

✗ const dubnium = require('dubnium')

CommonJS requires default export via require; variable name matters only locally.

db.create / db.read / db.get

✓ import Dubnium from 'dubnium'; const db = new Dubnium('data', '.json'); await db.create('user', { name: 'Alice' })

✗ const db = new dubnium.Dubnium('data', '.json')

Instance methods are async.

Initialize a local database, create a record, read it, modify, and delete.

import Dubnium from 'dubnium'; const db = new Dubnium('./data', '.json'); async function main() { // Create a record await db.create('user', { name: 'Alice', age: 30 }); // Read the same record const record = await db.read('user'); console.log('Record:', record); // Modify data await db.get('user').write({ name: 'Alice', age: 31 }); // Delete the record await db.get('user').delete(); } main().catch(console.error);

Debug

Known issues

gotchaFile extension must include dot (e.g., '.json') — omitting dot may cause files without extension.

fix

Always start with '.': new Dubnium('dir', '.json')

affects: >=1.0.0

deprecatedThe `delete` method on a record instance is deprecated in v4; use `await db.delete('tag')` instead.

fix

Use db.delete('tag') directly.

affects: >=4.0.0

gotchaReading a non-existent tag throws an error — no null/undefined return.

fix

Wrap in try/catch or check existence first with db.has('tag') if available.

affects: >=1.0.0

gotchaDirectory is created automatically but may fail if parent directory doesn't exist or permissions are wrong.

fix

Ensure parent directory exists and is writable.

affects: >=1.0.0

Errors

Common errors & fixes

TypeError: Dubnium is not a constructor

ESM import using named import instead of default import.

fix

Use `import Dubnium from 'dubnium'` (no curly braces).

Error: ENOENT: no such file or directory, open './data/...'

Database directory does not exist or is not writable.

fix

Create directory manually or ensure write permissions.

TypeError: Cannot read properties of undefined (reading 'delete')

Calling `.delete()` on a record that does not exist (read returned undefined).

fix

Check if record exists before calling delete, or use `db.delete('tag')` directly.

Upgrade

Version history

0.0.0latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

12 hits · last 30 days

node

Resources

githubhttps://github.com/coolstone-tech/dubnium ↗

packagehttps://www.npmjs.com/package/dubnium ↗

homepagehttps://db.coolstone.dev ↗