deepbase-json 3.6.5 → 3.6.6

package/README.md

@@ -233,6 +233,8 @@ new DeepBase(drivers, options)
 - `await db.add(...path, value)` - Add item with auto-generated ID
 - `await db.upd(...path, fn)` - Update value with function
 - `await db.keys(...path)` - Get keys at path
+- `await db.first(...path)` - Get first key at path (same order as `keys()`)
+- `await db.last(...path)` - Get last key at path (same order as `keys()`)
 - `await db.values(...path)` - Get values at path
 - `await db.entries(...path)` - Get entries at path
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepbase-json",
-  "version": "3.6.5",
+  "version": "3.6.6",
   "description": "⚡ DeepBase JSON - filesystem driver",
   "type": "module",
   "main": "src/index.cjs",
@@ -18,7 +18,7 @@
     "steno": "^0.4.4"
   },
   "peerDependencies": {
-    "deepbase": "^3.6.5"
+    "deepbase": "^3.6.6"
   },
   "scripts": {
     "test": "mocha test/test.js"

package/src/JsonDriver.js

@@ -148,6 +148,45 @@ export class JsonDriver extends DeepBaseDriver {
       return args;
     });
   }
+
+  async first(...args) {
+    if (this.multiProcess) {
+      this._refreshFromDisk();
+    }
+
+    const value = this._getRecursive(this.obj, args.slice());
+    if (value === null || typeof value !== 'object') {
+      return undefined;
+    }
+
+    for (const key in value) {
+      if (Object.prototype.hasOwnProperty.call(value, key)) {
+        return key;
+      }
+    }
+
+    return undefined;
+  }
+
+  async last(...args) {
+    if (this.multiProcess) {
+      this._refreshFromDisk();
+    }
+
+    const value = this._getRecursive(this.obj, args.slice());
+    if (value === null || typeof value !== 'object') {
+      return undefined;
+    }
+
+    let last;
+    for (const key in value) {
+      if (Object.prototype.hasOwnProperty.call(value, key)) {
+        last = key;
+      }
+    }
+
+    return last;
+  }
   
   // Internal set without queuing (for use within queued operations)
   async _setInternal(...args) {

package/test/test.js

@@ -248,6 +248,19 @@ describe('JsonDriver', function() {
       assert.ok(entries.some(([k, v]) => k === 'alice' && v.age === 30));
       assert.ok(entries.some(([k, v]) => k === 'bob' && v.age === 25));
     });
+
+    it('first/last should match keys() boundaries', async function() {
+      const keys = await db.keys('users');
+      const driver = db.getDriver(0);
+      assert.strictEqual(await driver.first('users'), keys[0]);
+      assert.strictEqual(await driver.last('users'), keys[keys.length - 1]);
+    });
+
+    it('first/last should return undefined for missing path', async function() {
+      const driver = db.getDriver(0);
+      assert.strictEqual(await driver.first('missing'), undefined);
+      assert.strictEqual(await driver.last('missing'), undefined);
+    });
   });
 
   describe('Persistence', function() {