spectre.db 1.0.0

package/index.js

@@ -0,0 +1,79 @@
+'use strict';
+
+const path = require('path');
+const { Engine, Table } = require('./src/engine');
+
+function normalizePath(filePath) {
+  return path.resolve(filePath)
+    .replace(/\.json\.gz$/i, '')
+    .replace(/\.json$/i,    '')
+    .replace(/\.gz$/i,      '');
+}
+
+function mapLegacyOptions(opts) {
+  const mapped = {};
+
+  if (opts.maxCacheSize !== undefined) mapped.maxCacheSize     = opts.maxCacheSize;
+  if (opts.cacheTTL     !== undefined) mapped.cacheTTL         = opts.cacheTTL;
+  if (opts.compress     !== undefined) mapped.compress         = opts.compress;
+  if (opts.encryptionKey !== undefined) mapped.encryptionKey   = opts.encryptionKey;
+  if (opts.backupCount  !== undefined) mapped.backupCount      = opts.backupCount;
+
+  if (opts.autoSave !== undefined) {
+    mapped.compactInterval  = opts.autoSave > 0 ? opts.autoSave : 0;
+    mapped.compactThreshold = opts.autoSave > 0 ? 50 : Infinity;
+  }
+
+  if (opts.backup === false) mapped.backupCount = 0;
+  if (opts.cache  === false) mapped.maxCacheSize = 0;
+
+  if (opts.compactThreshold !== undefined) mapped.compactThreshold = opts.compactThreshold;
+  if (opts.compactInterval  !== undefined) mapped.compactInterval  = opts.compactInterval;
+
+  return mapped;
+}
+
+class Database extends Engine {
+  constructor(filePath = './database.json', options = {}) {
+    const cleanPath = normalizePath(filePath);
+    const opts      = mapLegacyOptions(options);
+
+    super(cleanPath, opts);
+
+    this._legacyWarmKeys = Array.isArray(options.warmKeys) ? options.warmKeys : [];
+
+    this.ready = this.ready.then(() => {
+      for (const key of this._legacyWarmKeys) {
+        try { this.get(key); } catch {}
+      }
+    });
+  }
+
+  transaction(arg) {
+    if (typeof arg === 'function') {
+      return super.transaction(arg);
+    }
+
+    if (Array.isArray(arg)) {
+      return super.transaction(tx => {
+        const results = [];
+        for (const op of arg) {
+          switch (op.type) {
+            case 'set':    results.push(tx.set(op.key, op.value));    break;
+            case 'delete': results.push(tx.delete(op.key));           break;
+            case 'add':    results.push(tx.add(op.key, op.value));    break;
+            case 'sub':    results.push(tx.sub(op.key, op.value));    break;
+            case 'push':   results.push(tx.push(op.key, op.value));   break;
+            case 'pull':   results.push(tx.pull(op.key, op.value));   break;
+            default: throw new Error(`[spectre.db] Unknown operation type: "${op.type}"`);
+          }
+        }
+        return results;
+      });
+    }
+
+    throw new TypeError('[spectre.db] transaction() expects an array of operations or an async function');
+  }
+}
+
+module.exports = { Database, Table };

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "spectre.db",
+  "version": "1.0.0",
+  "description": "A lightweight, production-grade file-based JSON database for Node.js. Zero dependencies, WAL-based persistence, LRU cache, atomic writes, and optional AES-256 encryption.",
+  "main": "index.js",
+  "files": [
+    "index.js",
+    "src/",
+    "examples/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "start": "node examples/basic.js"
+  },
+  "keywords": [
+    "database",
+    "json",
+    "storage",
+    "discord",
+    "discord-bot",
+    "key-value",
+    "wal",
+    "lru",
+    "cache",
+    "lightweight",
+    "file-based",
+    "no-dependencies",
+    "nodejs"
+  ],
+  "author": "scarysmonsters",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/scarysmonsters/spectre.db.git"
+  },
+  "bugs": {
+    "url": "https://github.com/scarysmonsters/spectre.db/issues"
+  },
+  "homepage": "https://github.com/scarysmonsters/spectre.db#readme"
+}