deepbase-sqlite 3.5.1 → 3.6.0

package/README.md

@@ -77,6 +77,8 @@ Efficiently stores nested objects using a key-value schema:
 - Values are stored as JSON
 - Fast lookups for both exact keys and partial paths
 
+Each row also stores a monotonic `seq` so reads that rebuild objects use `ORDER BY seq, key`. That matches JavaScript insertion order for sibling keys and keeps `shift()` / `pop()` (via `DeepBase.keys()`) aligned with `JsonDriver`. Existing databases pick up `seq` via `ALTER TABLE` on connect (legacy rows default to `0`, then tie-break by `key`).
+
 ### ACID Compliance
 
 SQLite provides:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepbase-sqlite",
-  "version": "3.5.1",
+  "version": "3.6.0",
   "description": "⚡ DeepBase SQLite - SQLite database driver",
   "type": "module",
   "main": "src/index.cjs",
@@ -17,7 +17,7 @@
     "better-sqlite3": "^11.8.1"
   },
   "peerDependencies": {
-    "deepbase": "^3.5.1"
+    "deepbase": "^3.6.0"
   },
   "scripts": {
     "test": "mocha test/test.js"

package/src/SqliteDriver.js

@@ -52,7 +52,7 @@ export class SqliteDriver extends DeepBaseDriver {
     SqliteDriver._instances[this.fileName] = this;
   }
 
-  async connect() {
+  _connectSync() {
     if (this._connected) return;
 
     if (!fs.existsSync(this.path)) {
@@ -75,15 +75,27 @@ export class SqliteDriver extends DeepBaseDriver {
     this.db.exec(`
       CREATE TABLE IF NOT EXISTS deepbase (
         key TEXT PRIMARY KEY,
-        value TEXT NOT NULL
+        value TEXT NOT NULL,
+        seq INTEGER NOT NULL DEFAULT 0
       )${withoutRowid}
     `);
 
+    const tableCols = this.db.prepare('PRAGMA table_info(deepbase)').all();
+    if (!tableCols.some((c) => c.name === 'seq')) {
+      this.db.exec('ALTER TABLE deepbase ADD COLUMN seq INTEGER NOT NULL DEFAULT 0');
+    }
+
     this.getStmt = this.db.prepare('SELECT value FROM deepbase WHERE key = ?');
-    this.setStmt = this.db.prepare('INSERT OR REPLACE INTO deepbase (key, value) VALUES (?, ?)');
+    this.setStmt = this.db.prepare(`
+      INSERT INTO deepbase (key, value, seq)
+      VALUES (?, ?, (SELECT IFNULL(MAX(seq), 0) + 1 FROM deepbase))
+      ON CONFLICT(key) DO UPDATE SET value = excluded.value
+    `);
     this.delStmt = this.db.prepare('DELETE FROM deepbase WHERE key = ?');
-    this.getAllStmt = this.db.prepare('SELECT key, value FROM deepbase');
-    this.getKeysLikeStmt = this.db.prepare("SELECT key, value FROM deepbase WHERE key LIKE ? ESCAPE '!'");
+    this.getAllStmt = this.db.prepare('SELECT key, value FROM deepbase ORDER BY seq, key');
+    this.getKeysLikeStmt = this.db.prepare(
+      "SELECT key, value FROM deepbase WHERE key LIKE ? ESCAPE '!' ORDER BY seq, key",
+    );
     this.delChildrenStmt = this.db.prepare("DELETE FROM deepbase WHERE key LIKE ? ESCAPE '!'");
     this.hasChildrenStmt = this.db.prepare("SELECT 1 FROM deepbase WHERE key LIKE ? ESCAPE '!' LIMIT 1");
 
@@ -116,6 +128,10 @@ export class SqliteDriver extends DeepBaseDriver {
     this._connected = true;
   }
 
+  async connect() {
+    this._connectSync();
+  }
+
   async disconnect() {
     if (this.db) {
       this.db.close();
@@ -128,6 +144,11 @@ export class SqliteDriver extends DeepBaseDriver {
     return this._getSync(args);
   }
 
+  getSync(...args) {
+    this._connectSync();
+    return this._getSync(args);
+  }
+
   _getSync(args) {
     if (args.length === 0) {
       return this._getRootObject();

package/test/test.js

@@ -85,6 +85,21 @@ for (const pragma of PRAGMA_MODES) {
         await db.set('complex', complexObj);
         assert.deepStrictEqual(await db.get('complex'), complexObj);
       });
+
+      it('getSync returns same value as get (sync API)', async function () {
+        await db.set('syncKey', 'syncValue');
+        await db.set('syncNested', 'a', 1);
+        const driver = db.getDriver(0);
+        assert.strictEqual(driver.getSync('syncKey'), 'syncValue');
+        assert.strictEqual(driver.getSync('syncNested', 'a'), 1);
+        assert.strictEqual(driver.getSync('nonexistent'), null);
+      });
+
+      it('getSync lazy-connects when not connected', function () {
+        const driver = new SqliteDriver({ name: 'getSync-lazy', path: testDataPath });
+        assert.strictEqual(driver.getSync('key'), null);
+        assert.ok(driver._connected);
+      });
     });
 
     describe('Keys with Dots', function () {