merd.db

A lightweight file database module for Node.js, created by merd.

merd.db gives you three drivers with one API style:

• JsonDatabase
• YamlDatabase
• BsonDatabase

Installation

npm i merd.db

Quick Start

const { JsonDatabase, YamlDatabase, BsonDatabase } = require("merd.db");

const jsonDb = new JsonDatabase({ filePath: "./data/merd.json" });
const yamlDb = new YamlDatabase({ filePath: "./data/merd.yaml" });
const bsonDb = new BsonDatabase({ filePath: "./data/merd.bson" });

jsonDb.set("user.name", "merd");
jsonDb.add("user.coins", 5);
jsonDb.push("user.roles", "owner");

console.log(jsonDb.get("user.name"));
console.log(jsonDb.get("user.coins"));
console.log(jsonDb.get("user.roles"));

API

All drivers support the same methods:

• get(key, fallback)
• fetch(key, fallback)
• set(key, value)
• has(key)
• delete(key)
• ensure(key, defaultValue)
• add(key, amount)
• subtract(key, amount)
• inc(key, amount)
• dec(key, amount)
• push(key, value)
• pull(key, value)
• all()
• object()
• type(key)
• save()
• reload()
• clear()

Driver Factory

const { createDatabase } = require("merd.db");

const db = createDatabase("yaml", {
  filePath: "./data/app.yaml"
});

Branding and Attribution

This package is authored and branded by merd.

• package author: merd
• copyright: Copyright (c) 2026 merd
• notice file included: NOTICE
• exposed signature: AUTHOR_SIGNATURE

Publish to npm

1. Log in:

npm login

2. Verify package name availability:

npm view merd.db

3. Run tests:

npm test

4. Publish:

npm publish --access public

If npm says the name is already taken, publish under a scope:

npm publish --access public

with a scoped name like @merd/merd.db in package.json.

License

MIT License, copyright belongs to merd.