JSON Database ST

A high-performance, lightweight, and secure JSON-based database engine for Node.js. Designed for applications that need reliable data persistence, atomic operations, and encryption without the overhead of a full SQL server.

🚀 Key Features

• 🔒 AES-256-GCM Encryption: Military-grade security for your data at rest.
• ⚡ O(1) Indexing: Instant lookups, no matter how big the database gets.
• 🛡️ Atomic Writes: Zero corruption risk. Uses lockfiles and temp-write-swap strategy.
• 🔢 Math Helpers: Atomic add and subtract for financial/gaming logic.
• 📄 Pagination: Built-in support for handling large lists efficiently.
• 📸 Snapshots: One-line command to backup your entire database.

📦 Installation

npm install json-database-st lodash proper-lockfile

⚡ Quick Start

const JSONDatabase = require('json-database-st');

const db = new JSONDatabase('data.json');

async function run() {
    // 1. Set Data
    await db.set('user.name', 'Sethun');
    
    // 2. Atomic Math (New!)
    await db.set('user.balance', 1000);
    await db.add('user.balance', 500); // Balance is now 1500
    
    // 3. Arrays with Uniqueness
    await db.push('inventory', { id: 1, item: 'Laptop' });
    
    console.log(await db.get('user'));
}

run();

📖 Documentation

Full documentation, API references, and benchmarks are available on the Home Page.

🤝 Contributing

Built by SethunThunder.

🚀 Performance (v2.0)

| Operation | 10k Records | 1M Records | | :--- | :--- | :--- | | Indexed Read | 0.15 ms | 0.07 ms | | Write (Ingest) | 42,450 ops/sec | 57,845 ops/sec | | Single Update | 100 ms | 6.3 s |

Fastest in Class: Indexed reads are O(1). Updates are 1.5x faster than v1.0. View Full Benchmarks