ueberdb2 6.0.3 → 6.1.2

package/README.md

@@ -86,6 +86,57 @@ const ueberdb = require('ueberdb2');
 })();
 ```
 
+### findKeysPaged (memory-bounded iteration)
+
+`findKeys()` materialises every matching key into a single array. On very
+large keyspaces that loads the whole result set into memory at once — see
+[ether/etherpad#7830][7830] where a multi-million-row `sessionstorage:*`
+sweep OOMed the host. `findKeysPaged()` walks the same keyspace in
+fixed-size pages using an exclusive `after` cursor:
+
+```javascript
+const ueberdb = require('ueberdb2');
+
+(async () => {
+  const db = new ueberdb.Database('mysql', settings);
+  await db.init();
+  try {
+    let after;
+    let total = 0;
+    while (true) {
+      const page = await db.findKeysPaged('sessionstorage:*', null, {
+        limit: 500,
+        ...(after != null ? {after} : {}),
+      });
+      if (page.length === 0) break;
+      total += page.length;
+      for (const key of page) {
+        // ...process key...
+      }
+      after = page[page.length - 1];
+    }
+    console.log(`processed ${total} keys`);
+  } finally {
+    await db.close();
+  }
+})();
+```
+
+Semantics:
+
+- Keys are returned in ascending byte-order, up to `limit` per call.
+- `after` is **exclusive** — pass the last returned key as the next
+  `after` value. Final page is when the returned array is empty.
+- `limit` must be a positive integer; non-positive or non-integer values
+  throw.
+- Native implementations: **mysql** (ranged `BINARY \`key\` > ?`),
+  **postgres** (`key > $n`). All other backends fall back to
+  `findKeys() + JS-side slicing` via the cache layer — correct, but
+  defeats the OOM-mitigation purpose. PRs for native paged paths on
+  other backends welcome.
+
+[7830]: https://github.com/ether/etherpad/issues/7830
+
 ### Getting and setting subkeys
 
 ueberDB can store complex JSON objects. Sometimes you only want to get or set a
@@ -210,21 +261,21 @@ const ueberdb = require('ueberdb2');
 
 ## Feature support
 
-|               | Get | Set | findKeys | Remove | getSub | setSub | doBulk | CI Coverage |
-|---------------|-----|-----|----------|--------|--------|--------|--------|-------------|
-| cassandra     | ✓   | ✓   | *        | ✓      | ✓      | ✓      | ✓      | ✓           |
-| couchdb       | ✓   | ✓   | ✓        | ✓      | ✓      | ✓      | ✓      | ✓           |
-| dirty         | ✓   | ✓   | ✓        | ✓      | ✓      | ✓      |        | ✓           |
-| dirty_git     | ✓   | ✓   | ✓        | ✓      | ✓      | ✓      |        | ✓           |
-| elasticsearch | ✓   | ✓   | *        | ✓      | ✓      | ✓      | ✓      | ✓           |
-| maria         | ✓   | ✓   | ✓        | ✓      | ✓      | ✓      | ✓      | ✓           |
-| mysql         | ✓   | ✓   | ✓        | ✓      | ✓      | ✓      | ✓      | ✓           |
-| postgres      | ✓   | ✓   | ✓        | ✓      | ✓      | ✓      | ✓      | ✓           |
-| redis         | ✓   | ✓   | *        | ✓      | ✓      | ✓      | ✓      | ✓           |
-| rethinkdb     | ✓   | ✓   | *        | ✓      | ✓      | ✓      | ✓      | 
-| rustydb       | ✓   | ✓   | ✓        | ✓      | ✓      | ✓      | ✓      | ✓           |
-| sqlite        | ✓   | ✓   | ✓        | ✓      | ✓      | ✓      | ✓      | ✓           |
-| surrealdb     | ✓   | ✓   | ✓        | ✓      | ✓      | ✓      | ✓      | ✓           |
+|               | Get | Set | findKeys | findKeysPaged | Remove | getSub | setSub | doBulk | CI Coverage |
+|---------------|-----|-----|----------|---------------|--------|--------|--------|--------|-------------|
+| cassandra     | ✓   | ✓   | *        | ✓             | ✓      | ✓      | ✓      | ✓      | ✓           |
+| couchdb       | ✓   | ✓   | ✓        | ✓             | ✓      | ✓      | ✓      | ✓      | ✓           |
+| dirty         | ✓   | ✓   | ✓        | ✓             | ✓      | ✓      | ✓      |        | ✓           |
+| dirty_git     | ✓   | ✓   | ✓        | ✓             | ✓      | ✓      | ✓      |        | ✓           |
+| elasticsearch | ✓   | ✓   | *        | ✓             | ✓      | ✓      | ✓      | ✓      | ✓           |
+| maria         | ✓   | ✓   | ✓        | ✓             | ✓      | ✓      | ✓      | ✓      | ✓           |
+| mysql         | ✓   | ✓   | ✓        | ✓             | ✓      | ✓      | ✓      | ✓      | ✓           |
+| postgres      | ✓   | ✓   | ✓        | ✓             | ✓      | ✓      | ✓      | ✓      | ✓           |
+| redis         | ✓   | ✓   | *        | ✓             | ✓      | ✓      | ✓      | ✓      | ✓           |
+| rethinkdb     | ✓   | ✓   | *        | ✓             | ✓      | ✓      | ✓      | ✓      | 
+| rustydb       | ✓   | ✓   | ✓        | ✓             | ✓      | ✓      | ✓      | ✓      | ✓           |
+| sqlite        | ✓   | ✓   | ✓        | ✓             | ✓      | ✓      | ✓      | ✓      | ✓           |
+| surrealdb     | ✓   | ✓   | ✓        | ✓             | ✓      | ✓      | ✓      | ✓      | ✓           |
 
 ## Limitations
 
@@ -245,6 +296,19 @@ The following have limitations on findKeys
 For details on how it works please refer to the wiki:
 https://github.com/ether/UeberDB/wiki/findKeys-functionality
 
+### findKeysPaged database support
+
+`findKeysPaged` is supported on every backend, but only the SQL backends
+(mysql, mariadb, postgres) iterate the keyspace with a server-side ranged
+query — that's the variant that actually bounds memory for the OOM case it
+was added for ([ether/etherpad#7830][7830]). Other backends share the same
+API surface via a wrapper that falls back to `findKeys()` plus in-JS
+slicing; correct, but the underlying `findKeys()` still materialises every
+matching key, so the OOM-mitigation benefit only applies to the SQL
+backends. PRs adding native paged paths for the rest are welcome.
+
+[7830]: https://github.com/ether/etherpad/issues/7830
+
 ### Scaling, High availability and disaster recovery.
 
 To scale UeberDB you should use sharding especially for real time applications.

package/dist/{AbstractDatabase-DfQ39Ry6.js → AbstractDatabase-WBFqc8ye.js}

@@ -1,4 +1,4 @@
-import { t as normalizeLogger } from "./logging-DOvFhjsQ.js";
+import { t as normalizeLogger } from "./logging-CLbyQV5A.js";
 //#region lib/AbstractDatabase.ts
 const nullLogger = normalizeLogger(null);
 const simpleGlobToRegExp = (s) => s.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");

package/dist/{cassandra_db-B_5ANRzM.js → cassandra_db-B96_l9V7.js}

@@ -1,4 +1,4 @@
-import { t as AbstractDatabase } from "./AbstractDatabase-DfQ39Ry6.js";
+import { t as AbstractDatabase } from "./AbstractDatabase-WBFqc8ye.js";
 import { Client } from "cassandra-driver";
 //#region databases/cassandra_db.ts
 /**

package/dist/{couch_db-BXyzauwJ.js → couch_db-DZ6MLt5j.js}

@@ -1,4 +1,4 @@
-import { t as AbstractDatabase } from "./AbstractDatabase-DfQ39Ry6.js";
+import { t as AbstractDatabase } from "./AbstractDatabase-WBFqc8ye.js";
 import nano from "nano";
 //#region databases/couch_db.ts
 /**

package/dist/databases/mysql_db.d.ts

@@ -25,6 +25,10 @@ export default class extends AbstractDatabase {
     init(): Promise<void>;
     get(key: string): Promise<any>;
     findKeys(key: string, notKey: string): Promise<any>;
+    findKeysPaged(key: string, notKey: string | null | undefined, options: {
+        limit: number;
+        after?: string;
+    }): Promise<any>;
     set(key: string, value: string): Promise<void>;
     remove(key: string): Promise<void>;
     doBulk(bulk: BulkObject[]): Promise<void>;

package/dist/databases/mysql_db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mysql_db.d.ts","sourceRoot":"","sources":["../../databases/mysql_db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,gBAAgB,EAAE,EAAC,KAAK,QAAQ,EAAC,MAAM,yBAAyB,CAAC;AAExE,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,gBAAgB,CAAC;AAE/C,OAAO,KAAK,EAAmB,IAAI,EAAa,MAAM,QAAQ,CAAC;AAE/D,MAAM,CAAC,OAAO,MAAO,SAAQ,gBAAgB;IAC3C,SAAgB,cAAc,EAAE,QAAQ,CAAC;IAClC,KAAK,EAAE,IAAI,GAAC,IAAI,CAAC;gBACZ,QAAQ,EAAC,QAAQ;IAiB7B,IAAI,OAAO,YAAmB;IAExB,MAAM,CAAC,OAAO,EAAE,GAAG,GAAE,OAAO,CAAC,GAAG,CAAC;IAkBjC,IAAI;IAqEJ,GAAG,CAAC,GAAG,EAAC,MAAM;IAQd,QAAQ,CAAC,GAAG,EAAC,MAAM,EAAE,MAAM,EAAC,MAAM;IAkBlC,GAAG,CAAC,GAAG,EAAC,MAAM,EAAE,KAAK,EAAC,MAAM;IAK5B,MAAM,CAAC,GAAG,EAAC,MAAM;IAOjB,MAAM,CAAC,IAAI,EAAC,UAAU,EAAE;IAsBxB,KAAK;CAGZ"}
+{"version":3,"file":"mysql_db.d.ts","sourceRoot":"","sources":["../../databases/mysql_db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,gBAAgB,EAAE,EAAC,KAAK,QAAQ,EAAC,MAAM,yBAAyB,CAAC;AAExE,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,gBAAgB,CAAC;AAE/C,OAAO,KAAK,EAAmB,IAAI,EAAa,MAAM,QAAQ,CAAC;AAE/D,MAAM,CAAC,OAAO,MAAO,SAAQ,gBAAgB;IAC3C,SAAgB,cAAc,EAAE,QAAQ,CAAC;IAClC,KAAK,EAAE,IAAI,GAAC,IAAI,CAAC;gBACZ,QAAQ,EAAC,QAAQ;IAiB7B,IAAI,OAAO,YAAmB;IAExB,MAAM,CAAC,OAAO,EAAE,GAAG,GAAE,OAAO,CAAC,GAAG,CAAC;IAkBjC,IAAI;IAqEJ,GAAG,CAAC,GAAG,EAAC,MAAM;IAQd,QAAQ,CAAC,GAAG,EAAC,MAAM,EAAE,MAAM,EAAC,MAAM;IAkBlC,aAAa,CACjB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,OAAO,EAAE;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAC;IAuBpC,GAAG,CAAC,GAAG,EAAC,MAAM,EAAE,KAAK,EAAC,MAAM;IAK5B,MAAM,CAAC,GAAG,EAAC,MAAM;IAOjB,MAAM,CAAC,IAAI,EAAC,UAAU,EAAE;IAsBxB,KAAK;CAGZ"}

package/dist/databases/postgres_db.d.ts

@@ -23,6 +23,10 @@ export default class extends AbstractDatabase {
     init(callback: (err: Error) => {}): void;
     get(key: string, callback: (err: Error | null, value: any) => {}): void;
     findKeys(key: string, notKey: string, callback: (err: Error | null, value: any) => {}): void;
+    findKeysPaged(key: string, notKey: string | null | undefined, options: {
+        limit: number;
+        after?: string;
+    }, callback: (err: Error | null, value: string[]) => void): void;
     set(key: string, value: string, callback: (err: Error, result: pg.QueryResult) => void): void;
     remove(key: string, callback: () => {}): void;
     doBulk(bulk: BulkObject[], callback: () => {}): void;

package/dist/databases/postgres_db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postgres_db.d.ts","sourceRoot":"","sources":["../../databases/postgres_db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,gBAAgB,EAAE,EAAC,KAAK,QAAQ,EAAC,MAAM,yBAAyB,CAAC;AAExE,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,gBAAgB,CAAC;AAE/C,MAAM,CAAC,OAAO,MAAO,SAAQ,gBAAgB;IACpC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC;IACZ,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;gBACtC,QAAQ,EAAC,QAAQ,GAAG,MAAM;IAgBtC,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,KAAG,EAAE;IA2E/B,GAAG,CAAC,GAAG,EAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,KAAG,EAAE;IAY7D,QAAQ,CAAC,GAAG,EAAC,MAAM,EAAE,MAAM,EAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,KAAG,EAAE;IA0BjF,GAAG,CAAC,GAAG,EAAC,MAAM,EAAE,KAAK,EAAC,MAAM,EAAE,QAAQ,EAAC,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,WAAW,KAAK,IAAI;IASnF,MAAM,CAAC,GAAG,EAAC,MAAM,EAAE,QAAQ,EAAC,MAAI,EAAE;IAIlC,MAAM,CAAC,IAAI,EAAC,UAAU,EAAE,EAAE,QAAQ,EAAC,MAAI,EAAE;IAsCzC,KAAK,CAAC,QAAQ,EAAC,MAAI,EAAE;CAGtB"}
+{"version":3,"file":"postgres_db.d.ts","sourceRoot":"","sources":["../../databases/postgres_db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,gBAAgB,EAAE,EAAC,KAAK,QAAQ,EAAC,MAAM,yBAAyB,CAAC;AAExE,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,gBAAgB,CAAC;AAE/C,MAAM,CAAC,OAAO,MAAO,SAAQ,gBAAgB;IACpC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC;IACZ,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;gBACtC,QAAQ,EAAC,QAAQ,GAAG,MAAM;IAgBtC,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,KAAG,EAAE;IA2E/B,GAAG,CAAC,GAAG,EAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,KAAG,EAAE;IAY7D,QAAQ,CAAC,GAAG,EAAC,MAAM,EAAE,MAAM,EAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,KAAG,EAAE;IA0BjF,aAAa,CACX,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,OAAO,EAAE;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAC,EACxC,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI;IA2BxD,GAAG,CAAC,GAAG,EAAC,MAAM,EAAE,KAAK,EAAC,MAAM,EAAE,QAAQ,EAAC,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,WAAW,KAAK,IAAI;IASnF,MAAM,CAAC,GAAG,EAAC,MAAM,EAAE,QAAQ,EAAC,MAAI,EAAE;IAIlC,MAAM,CAAC,IAAI,EAAC,UAAU,EAAE,EAAE,QAAQ,EAAC,MAAI,EAAE;IAsCzC,KAAK,CAAC,QAAQ,EAAC,MAAI,EAAE;CAGtB"}

package/dist/{dirty_db-C1KQTMCv.js → dirty_db-BGvHB8ud.js}

@@ -1,4 +1,4 @@
-import { t as AbstractDatabase } from "./AbstractDatabase-DfQ39Ry6.js";
+import { t as AbstractDatabase } from "./AbstractDatabase-WBFqc8ye.js";
 import DirtyImport from "dirty-ts";
 //#region databases/dirty_db.ts
 /**

package/dist/{dirty_git_db-7tkfx6PK.js → dirty_git_db-LJWW2YT6.js}

@@ -1,4 +1,4 @@
-import { t as AbstractDatabase } from "./AbstractDatabase-DfQ39Ry6.js";
+import { t as AbstractDatabase } from "./AbstractDatabase-WBFqc8ye.js";
 import DirtyImport from "dirty-ts";
 import { dirname } from "node:path";
 import { simpleGit } from "simple-git";

package/dist/{elasticsearch_db-C6G-Wnou.js → elasticsearch_db-D2XR08mV.js}

@@ -1,4 +1,4 @@
-import { t as AbstractDatabase } from "./AbstractDatabase-DfQ39Ry6.js";
+import { t as AbstractDatabase } from "./AbstractDatabase-WBFqc8ye.js";
 import assert, { equal } from "assert";
 import { Buffer } from "buffer";
 import { createHash } from "crypto";

package/dist/index.d.ts

@@ -42,6 +42,16 @@ export declare class Database {
     doShutdown(): Promise<void>;
     get(key: string): Promise<unknown>;
     findKeys(key: string, notKey?: string): Promise<string[]>;
+    /**
+     * Returns up to `options.limit` keys matching `key` (excluding `notKey`),
+     * sorted ascending. Page by passing the last returned key as `options.after`
+     * on the next call; the final page returns fewer than `options.limit` keys.
+     * Designed for memory-bounded iteration over large keyspaces.
+     */
+    findKeysPaged(key: string, notKey: string | null | undefined, options: {
+        limit: number;
+        after?: string;
+    }): Promise<string[]>;
     remove(key: string): Promise<void>;
     set(key: string, value: unknown): Promise<void>;
     getSub(key: string, sub: string[]): Promise<unknown>;

package/dist/index.js

@@ -1,4 +1,4 @@
-import { t as normalizeLogger } from "./logging-DOvFhjsQ.js";
+import { t as normalizeLogger } from "./logging-CLbyQV5A.js";
 import { promisify } from "node:util";
 //#region lib/CacheAndBufferLayer.ts
 /**
@@ -92,6 +92,7 @@ var Database$1 = class {
 				"close",
 				"doBulk",
 				"findKeys",
+				"findKeysPaged",
 				"get",
 				"init",
 				"remove",
@@ -225,6 +226,27 @@ var Database$1 = class {
 		if (this.logger.isDebugEnabled()) this.logger.debug(`GET    - ${key}-${notKey} - ${JSON.stringify(keyValues)} - from database `);
 		return clone(keyValues);
 	}
+	async findKeysPaged(key, notKey, options) {
+		if (!options || !Number.isInteger(options.limit) || options.limit <= 0) throw new Error("findKeysPaged requires a positive integer limit");
+		await this.flush();
+		if (typeof this.wrappedDB.findKeysPaged !== "function") {
+			const all = await this.wrappedDB.findKeys(key, notKey ?? void 0) || [];
+			all.sort();
+			const start = options.after == null ? 0 : (() => {
+				let lo = 0, hi = all.length;
+				while (lo < hi) {
+					const mid = lo + hi >>> 1;
+					if (all[mid] <= options.after) lo = mid + 1;
+					else hi = mid;
+				}
+				return lo;
+			})();
+			return clone(all.slice(start, start + options.limit));
+		}
+		const keys = await this.wrappedDB.findKeysPaged(key, notKey, options);
+		if (this.logger.isDebugEnabled()) this.logger.debug(`GET    - ${key}-${notKey} (paged limit=${options.limit} after=${options.after ?? ""}) - ${JSON.stringify(keys)} - from database `);
+		return clone(keys);
+	}
 	async remove(key) {
 		if (this.logger.isDebugEnabled()) this.logger.debug(`DELETE - ${key} - from database `);
 		await this.set(key, null);
@@ -466,23 +488,23 @@ var Database = class {
 	}
 	async initDB() {
 		switch (this.type) {
-			case "mysql": return new (await (import("./mysql_db-48mMBbKZ.js"))).default(this.dbSettings);
-			case "postgres": return new (await (import("./postgres_db-7Hiezhpi.js"))).default(this.dbSettings);
-			case "sqlite": return new (await (import("./sqlite_db-Cy8OT62U.js"))).default(this.dbSettings);
-			case "rustydb": return new (await (import("./rusty_db-Msjxckfm.js"))).default(this.dbSettings);
-			case "mongodb": return new (await (import("./mongodb_db-DgkIuEMZ.js"))).default(this.dbSettings);
-			case "redis": return new (await (import("./redis_db-DKRC8sR9.js"))).default(this.dbSettings);
-			case "cassandra": return new (await (import("./cassandra_db-B_5ANRzM.js"))).default(this.dbSettings);
-			case "dirty": return new (await (import("./dirty_db-C1KQTMCv.js"))).default(this.dbSettings);
-			case "dirtygit": return new (await (import("./dirty_git_db-7tkfx6PK.js"))).default(this.dbSettings);
-			case "elasticsearch": return new (await (import("./elasticsearch_db-C6G-Wnou.js"))).default(this.dbSettings);
-			case "memory": return new (await (import("./memory_db-CGTi0Ck-.js"))).default(this.dbSettings);
-			case "mock": return new (await (import("./mock_db-DCUmGtUq.js"))).default(this.dbSettings);
-			case "mssql": return new (await (import("./mssql_db-LiEvv4Sm.js"))).default(this.dbSettings);
-			case "postgrespool": return new (await (import("./postgrespool_db-CdF-1S34.js"))).default(this.dbSettings);
-			case "rethink": return new (await (import("./rethink_db-BGxY_SA3.js"))).default(this.dbSettings);
-			case "couch": return new (await (import("./couch_db-BXyzauwJ.js"))).default(this.dbSettings);
-			case "surrealdb": return new (await (import("./surrealdb_db-XnhMQEwL.js"))).default(this.dbSettings);
+			case "mysql": return new (await (import("./mysql_db-DIXEbML4.js"))).default(this.dbSettings);
+			case "postgres": return new (await (import("./postgres_db-BzDKMRC5.js"))).default(this.dbSettings);
+			case "sqlite": return new (await (import("./sqlite_db-Bp4nZn-c.js"))).default(this.dbSettings);
+			case "rustydb": return new (await (import("./rusty_db-90_S-z-w.js"))).default(this.dbSettings);
+			case "mongodb": return new (await (import("./mongodb_db-DJVvvNTo.js"))).default(this.dbSettings);
+			case "redis": return new (await (import("./redis_db-C8LRkRGe.js"))).default(this.dbSettings);
+			case "cassandra": return new (await (import("./cassandra_db-B96_l9V7.js"))).default(this.dbSettings);
+			case "dirty": return new (await (import("./dirty_db-BGvHB8ud.js"))).default(this.dbSettings);
+			case "dirtygit": return new (await (import("./dirty_git_db-LJWW2YT6.js"))).default(this.dbSettings);
+			case "elasticsearch": return new (await (import("./elasticsearch_db-D2XR08mV.js"))).default(this.dbSettings);
+			case "memory": return new (await (import("./memory_db-BQaHRpkv.js"))).default(this.dbSettings);
+			case "mock": return new (await (import("./mock_db-CgEDPTpF.js"))).default(this.dbSettings);
+			case "mssql": return new (await (import("./mssql_db-BqtTYXk9.js"))).default(this.dbSettings);
+			case "postgrespool": return new (await (import("./postgrespool_db-B6FOhTY3.js"))).default(this.dbSettings);
+			case "rethink": return new (await (import("./rethink_db-qv884MUM.js"))).default(this.dbSettings);
+			case "couch": return new (await (import("./couch_db-DZ6MLt5j.js"))).default(this.dbSettings);
+			case "surrealdb": return new (await (import("./surrealdb_db-K8QAySpG.js"))).default(this.dbSettings);
 			default: throw new Error(`Invalid database type: ${this.type}`);
 		}
 	}
@@ -499,6 +521,15 @@ var Database = class {
 	async findKeys(key, notKey) {
 		return this.db.findKeys(key, notKey);
 	}
+	/**
+	* Returns up to `options.limit` keys matching `key` (excluding `notKey`),
+	* sorted ascending. Page by passing the last returned key as `options.after`
+	* on the next call; the final page returns fewer than `options.limit` keys.
+	* Designed for memory-bounded iteration over large keyspaces.
+	*/
+	async findKeysPaged(key, notKey, options) {
+		return this.db.findKeysPaged(key, notKey, options);
+	}
 	async remove(key) {
 		return this.db.remove(key);
 	}

package/dist/lib/AbstractDatabase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AbstractDatabase.d.ts","sourceRoot":"","sources":["../../lib/AbstractDatabase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,MAAM,EAAC,MAAM,WAAW,CAAC;AAOvD,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,cAAM,gBAAgB;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;gBAEd,QAAQ,EAAE,QAAQ;IAa9B,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAOrD,MAAM,CAAC,GAAG,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,IAAI,OAAO,IAAI,OAAO,CAAkB;CACzC;AAED,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"AbstractDatabase.d.ts","sourceRoot":"","sources":["../../lib/AbstractDatabase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,MAAM,EAAC,MAAM,WAAW,CAAC;AAOvD,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,cAAM,gBAAgB;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;gBAEd,QAAQ,EAAE,QAAQ;IAa9B,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAarD,MAAM,CAAC,GAAG,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,IAAI,OAAO,IAAI,OAAO,CAAkB;CACzC;AAED,eAAe,gBAAgB,CAAC"}

package/dist/lib/CacheAndBufferLayer.d.ts

@@ -92,6 +92,10 @@ export declare class Database {
     get(key: string): Promise<unknown>;
     private _getLocked;
     findKeys(key: string, notKey?: string): Promise<string[]>;
+    findKeysPaged(key: string, notKey: string | null | undefined, options: {
+        limit: number;
+        after?: string;
+    }): Promise<string[]>;
     remove(key: string): Promise<void>;
     set(key: string, value: unknown): Promise<void>;
     private _setLocked;

package/dist/lib/CacheAndBufferLayer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CacheAndBufferLayer.d.ts","sourceRoot":"","sources":["../../lib/CacheAndBufferLayer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CacheAndBufferLayer.d.ts","sourceRoot":"","sources":["../../lib/CacheAndBufferLayer.ts"],"names":[],"mappings":"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"}

package/dist/{memory_db-CGTi0Ck-.js → memory_db-BQaHRpkv.js}

@@ -1,4 +1,4 @@
-import { t as AbstractDatabase } from "./AbstractDatabase-DfQ39Ry6.js";
+import { t as AbstractDatabase } from "./AbstractDatabase-WBFqc8ye.js";
 //#region databases/memory_db.ts
 var MemoryDB = class extends AbstractDatabase {
 	_data;

package/dist/{mongodb_db-DgkIuEMZ.js → mongodb_db-DJVvvNTo.js}

@@ -1,4 +1,4 @@
-import { t as AbstractDatabase } from "./AbstractDatabase-DfQ39Ry6.js";
+import { t as AbstractDatabase } from "./AbstractDatabase-WBFqc8ye.js";
 import { MongoClient } from "mongodb";
 //#region databases/mongodb_db.ts
 /**

package/dist/{mssql_db-LiEvv4Sm.js → mssql_db-BqtTYXk9.js}

@@ -1,4 +1,4 @@
-import { t as AbstractDatabase } from "./AbstractDatabase-DfQ39Ry6.js";
+import { t as AbstractDatabase } from "./AbstractDatabase-WBFqc8ye.js";
 import async from "async";
 import mssql from "mssql";
 //#region databases/mssql_db.ts

package/dist/{mysql_db-48mMBbKZ.js → mysql_db-DIXEbML4.js}

@@ -1,4 +1,4 @@
-import { t as AbstractDatabase } from "./AbstractDatabase-DfQ39Ry6.js";
+import { t as AbstractDatabase } from "./AbstractDatabase-WBFqc8ye.js";
 import util from "util";
 import { createPool } from "mysql2";
 //#region databases/mysql_db.ts
@@ -105,6 +105,26 @@ var mysql_db_default = class extends AbstractDatabase {
 		});
 		return results.map((val) => val.key);
 	}
+	async findKeysPaged(key, notKey, options) {
+		if (!options || !Number.isInteger(options.limit) || options.limit <= 0) throw new Error("findKeysPaged requires a positive integer limit");
+		let query = "SELECT `key` FROM `store` WHERE `key` LIKE ?";
+		const params = [key.replace(/\*/g, "%")];
+		if (notKey != null) {
+			query += " AND `key` NOT LIKE ?";
+			params.push(notKey.replace(/\*/g, "%"));
+		}
+		if (options.after != null) {
+			query += " AND BINARY `key` > ?";
+			params.push(options.after);
+		}
+		query += " ORDER BY BINARY `key` ASC LIMIT ?";
+		params.push(options.limit);
+		const [results] = await this._query({
+			sql: query,
+			values: params
+		});
+		return results.map((val) => val.key);
+	}
 	async set(key, value) {
 		if (key.length > 100) throw new Error("Your Key can only be 100 chars");
 		await this._query({

package/dist/{postgres_db-7Hiezhpi.js → postgres_db-BzDKMRC5.js}

@@ -1,4 +1,4 @@
-import { t as AbstractDatabase } from "./AbstractDatabase-DfQ39Ry6.js";
+import { t as AbstractDatabase } from "./AbstractDatabase-WBFqc8ye.js";
 import async from "async";
 import * as pg from "pg";
 //#region databases/postgres_db.ts
@@ -85,6 +85,27 @@ var postgres_db_default = class extends AbstractDatabase {
 			callback(err, value);
 		});
 	}
+	findKeysPaged(key, notKey, options, callback) {
+		if (!options || !Number.isInteger(options.limit) || options.limit <= 0) return callback(/* @__PURE__ */ new Error("findKeysPaged requires a positive integer limit"), []);
+		let query = "SELECT key FROM store WHERE key LIKE $1";
+		const params = [key.replace(/\*/g, "%")];
+		let n = 2;
+		if (notKey != null) {
+			query += ` AND key NOT LIKE $${n++}`;
+			params.push(notKey.replace(/\*/g, "%"));
+		}
+		if (options.after != null) {
+			query += ` AND key > $${n++}`;
+			params.push(options.after);
+		}
+		query += ` ORDER BY key ASC LIMIT $${n}`;
+		params.push(options.limit);
+		this.db.query(query, params, (err, results) => {
+			const value = [];
+			if (!err && results.rows.length > 0) for (const row of results.rows) value.push(row.key);
+			callback(err, value);
+		});
+	}
 	set(key, value, callback) {
 		if (key.length > 100) callback(Error("Your Key can only be 100 chars"), "");
 		else if (this.upsertStatement != null) this.db.query(this.upsertStatement, [key, value], callback);

package/dist/{postgrespool_db-CdF-1S34.js → postgrespool_db-B6FOhTY3.js}

@@ -1,4 +1,4 @@
-import postgres_db_default from "./postgres_db-7Hiezhpi.js";
+import postgres_db_default from "./postgres_db-BzDKMRC5.js";
 //#region databases/postgrespool_db.ts
 var PostgresDB = class extends postgres_db_default {
 	constructor(settings) {

package/dist/{redis_db-DKRC8sR9.js → redis_db-C8LRkRGe.js}

@@ -1,4 +1,4 @@
-import { t as AbstractDatabase } from "./AbstractDatabase-DfQ39Ry6.js";
+import { t as AbstractDatabase } from "./AbstractDatabase-WBFqc8ye.js";
 import { createClient } from "redis";
 //#region databases/redis_db.ts
 /**

package/dist/{rethink_db-BGxY_SA3.js → rethink_db-qv884MUM.js}

@@ -1,4 +1,4 @@
-import { t as AbstractDatabase } from "./AbstractDatabase-DfQ39Ry6.js";
+import { t as AbstractDatabase } from "./AbstractDatabase-WBFqc8ye.js";
 import async from "async";
 import r from "rethinkdb";
 //#region databases/rethink_db.ts

package/dist/{rusty_db-Msjxckfm.js → rusty_db-90_S-z-w.js}

@@ -1,4 +1,4 @@
-import { t as AbstractDatabase } from "./AbstractDatabase-DfQ39Ry6.js";
+import { t as AbstractDatabase } from "./AbstractDatabase-WBFqc8ye.js";
 import { KeyValueDB } from "rusty-store-kv";
 //#region databases/rusty_db.ts
 var Rusty_db = class extends AbstractDatabase {

package/dist/{sqlite_db-Cy8OT62U.js → sqlite_db-Bp4nZn-c.js}

@@ -1,4 +1,4 @@
-import { t as AbstractDatabase } from "./AbstractDatabase-DfQ39Ry6.js";
+import { t as AbstractDatabase } from "./AbstractDatabase-WBFqc8ye.js";
 import { SQLite } from "rusty-store-kv";
 //#region databases/sqlite_db.ts
 /**

package/dist/{surrealdb_db-XnhMQEwL.js → surrealdb_db-K8QAySpG.js}

@@ -1,4 +1,4 @@
-import { t as AbstractDatabase } from "./AbstractDatabase-DfQ39Ry6.js";
+import { t as AbstractDatabase } from "./AbstractDatabase-WBFqc8ye.js";
 import { Surreal } from "surrealdb";
 //#region databases/surrealdb_db.ts
 /**

package/package.json

@@ -3,7 +3,7 @@
   "description": "Transform every database into a object key value store",
   "url": "https://github.com/ether/ueberDB",
   "type": "module",
-  "version": "6.0.3",
+  "version": "6.1.2",
   "keywords": [
     "database",
     "keyvalue"
@@ -100,28 +100,28 @@
     "@elastic/elasticsearch": "^9.4.0",
     "@types/async": "^3.2.25",
     "@types/mssql": "^12.3.0",
-    "@types/node": "^25.7.0",
+    "@types/node": "^25.9.1",
     "@types/pg": "^8.20.0",
     "@types/rethinkdb": "^2.3.21",
     "@types/wtfnode": "^0.10.0",
     "cassandra-driver": "^4.9.0",
     "cli-table3": "^0.6.5",
     "mongodb": "^7.2.0",
-    "mssql": "^12.5.2",
+    "mssql": "^12.5.4",
     "mysql2": "^3.22.3",
     "nano": "^11.0.5",
-    "oxfmt": "^0.49.0",
-    "oxlint": "^1.64.0",
-    "pg": "^8.20.0",
+    "oxfmt": "^0.51.0",
+    "oxlint": "^1.66.0",
+    "pg": "^8.21.0",
     "randexp-ts": "^1.0.5",
     "redis": "^5.12.1",
     "rethinkdb": "^2.4.2",
-    "rolldown": "^1.0.0",
+    "rolldown": "^1.0.2",
     "semver": "^7.8.0",
     "surrealdb": "^2.0.3",
     "testcontainers": "^11.14.0",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.6",
+    "vitest": "^4.1.7",
     "wtfnode": "^0.10.1"
   },
   "repository": {
@@ -143,7 +143,7 @@
     }
   ],
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=24.0.0"
   },
   "scripts": {
     "lint": "oxlint",