Secure, indexed JSON database for Node.js

Quickstart

// CommonJS
const JSONDatabase = require('json-database-st')
const path = require('path')

// Pro-tip: generate a 32-byte key once and keep it in env
// const ENCRYPTION_KEY = require('crypto').randomBytes(32).toString('hex')

const db = new JSONDatabase(path.join(__dirname, 'data.json'), {
  encryptionKey: process.env.DB_KEY,                // 64-char hex
  indices: [ { name: 'user-email', path: 'users', field: 'email', unique: true } ]
})

await db.set('users.alice', { email: 'alice@example.com', name: 'Alice' })
const alice = await db.findByIndex('user-email', 'alice@example.com')
console.log(alice)

await db.transaction(data => { data.users.alice.lastLogin = Date.now(); return data })
await db.close()

Works with ESM too. Ship in CLIs, Electron/Tauri apps, tiny services, or scripts.

Why devs pick json-database-st