@matter/nodejs 0.16.6-alpha.0-20260121-06f1d9611 → 0.16.6-alpha.0-20260122-b5154bcb4

package/dist/cjs/storage/sqlite/SqliteTypes.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Stores various utility types used by sqlite disk.
+ */
+export type SafeUint8Array = Uint8Array<ArrayBuffer>;
+export type SqliteDataType = null | number | bigint | string | SafeUint8Array;
+export type SqliteResultType = Record<string, SqliteDataType>;
+/**
+ * DatabaseLike
+ *
+ * compatible with `node:sqlite`(type mismatch), `bun:sqlite`
+ */
+export interface DatabaseLike {
+    prepare<O extends SqliteResultType | void>(query: string): SqlRunnableSimple<O> & SqlRunnableParam<any, O>;
+    exec(sql: string): void;
+    close(): void;
+}
+export type DatabaseCreator = (path: string) => DatabaseLike;
+/**
+ * Defines `I` -> `O` Runnable
+ *
+ * `I` type is treated as Input.
+ *
+ * `O` type is treated as Output.
+ *
+ * `void` type is used for no input/output.
+ */
+export type SqlRunnable<I extends SqliteResultType | void, O extends SqliteResultType | void> = I extends SqliteResultType ? SqlRunnableParam<I, O> : SqlRunnableSimple<O>;
+/**
+ * Database method with no parameter.
+ *
+ * (`I` must be void)
+ */
+interface SqlRunnableSimple<O extends SqliteResultType | void> {
+    run(): {
+        changes: number | bigint;
+    };
+    get(): O | null | undefined;
+    all(): Array<O | undefined>;
+}
+/**
+ * Database method with parameter.
+ */
+interface SqlRunnableParam<I extends SqliteResultType, O extends SqliteResultType | void> {
+    run(arg: I): {
+        changes: number | bigint;
+    };
+    get(arg: I): O | null | undefined;
+    all(arg: I): Array<O | undefined>;
+}
+/**
+ * SQLite Transaction mode
+ *
+ * TODO: Move transaction control to higher level (matter.js Transaction API)
+ * and remove this
+ */
+export declare enum SqliteTransaction {
+    BEGIN = 0,
+    COMMIT = 1,
+    ROLLBACK = 2
+}
+export {};
+//# sourceMappingURL=SqliteTypes.d.ts.map

package/dist/cjs/storage/sqlite/SqliteTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteTypes.d.ts","sourceRoot":"","sources":["../../../../src/storage/sqlite/SqliteTypes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AAGH,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;AAErD,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,cAAc,CAAC;AAE9E,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAE9D;;;;GAIG;AACH,MAAM,WAAW,YAAY;IACzB,OAAO,CAAC,CAAC,SAAS,gBAAgB,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC3G,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,YAAY,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,CACnB,CAAC,SAAS,gBAAgB,GAAG,IAAI,EACjC,CAAC,SAAS,gBAAgB,GAAG,IAAI,IACjC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;AAE/E;;;;GAIG;AACH,UAAU,iBAAiB,CAAC,CAAC,SAAS,gBAAgB,GAAG,IAAI;IACzD,GAAG,IAAI;QAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACpC,GAAG,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IAC5B,GAAG,IAAI,KAAK,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,UAAU,gBAAgB,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,SAAS,gBAAgB,GAAG,IAAI;IACpF,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG;QAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAC1C,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;CACrC;AAED;;;;;GAKG;AACH,oBAAY,iBAAiB;IACzB,KAAK,IAAA;IACL,MAAM,IAAA;IACN,QAAQ,IAAA;CACX"}

package/dist/cjs/storage/sqlite/SqliteTypes.js

@@ -0,0 +1,35 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var SqliteTypes_exports = {};
+__export(SqliteTypes_exports, {
+  SqliteTransaction: () => SqliteTransaction
+});
+module.exports = __toCommonJS(SqliteTypes_exports);
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var SqliteTransaction = /* @__PURE__ */ ((SqliteTransaction2) => {
+  SqliteTransaction2[SqliteTransaction2["BEGIN"] = 0] = "BEGIN";
+  SqliteTransaction2[SqliteTransaction2["COMMIT"] = 1] = "COMMIT";
+  SqliteTransaction2[SqliteTransaction2["ROLLBACK"] = 2] = "ROLLBACK";
+  return SqliteTransaction2;
+})(SqliteTransaction || {});
+//# sourceMappingURL=SqliteTypes.js.map

package/dist/cjs/storage/sqlite/SqliteTypes.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/storage/sqlite/SqliteTypes.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAsEO,IAAK,oBAAL,kBAAKA,uBAAL;AACH,EAAAA,sCAAA;AACA,EAAAA,sCAAA;AACA,EAAAA,sCAAA;AAHQ,SAAAA;AAAA,GAAA;",
+  "names": ["SqliteTransaction"]
+}

package/dist/cjs/storage/sqlite/SqliteUtil.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Build string context path from contexts[]
+ * @param contexts Contexts
+ * @returns `.` joined context path
+ */
+export declare function buildContextPath(contexts: string[]): string;
+/**
+ * Build Context & Key pair
+ * @param contexts Contexts
+ * @param key Key
+ */
+export declare function buildContextKeyPair(contexts: string[], key: string): {
+    context: string;
+    key: string;
+};
+/**
+ * Build Context & Key *log* path
+ */
+export declare function buildContextKeyLog(contexts: string[], key: string): string;
+/**
+ * Build key (just verification)
+ */
+export declare function buildKey(key: string): string;
+/**
+ * Escape string for Glob
+ */
+export declare function escapeGlob(value: string): string;
+//# sourceMappingURL=SqliteUtil.d.ts.map

package/dist/cjs/storage/sqlite/SqliteUtil.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteUtil.d.ts","sourceRoot":"","sources":["../../../../src/storage/sqlite/SqliteUtil.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAWlD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM;;;EAKlE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,UAEjE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,UAKnC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,UAEvC"}

package/dist/cjs/storage/sqlite/SqliteUtil.js

@@ -0,0 +1,64 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var SqliteUtil_exports = {};
+__export(SqliteUtil_exports, {
+  buildContextKeyLog: () => buildContextKeyLog,
+  buildContextKeyPair: () => buildContextKeyPair,
+  buildContextPath: () => buildContextPath,
+  buildKey: () => buildKey,
+  escapeGlob: () => escapeGlob
+});
+module.exports = __toCommonJS(SqliteUtil_exports);
+var import_SqliteStorageError = require("./SqliteStorageError.js");
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function buildContextPath(contexts) {
+  for (const ctx of contexts) {
+    if (ctx.trim().length <= 0 || ctx.includes(".")) {
+      throw new import_SqliteStorageError.SqliteStorageError(
+        "build",
+        `{${contexts.join(",")}}`,
+        "Context must not be an empty and not contain dots."
+      );
+    }
+  }
+  return contexts.join(".");
+}
+function buildContextKeyPair(contexts, key) {
+  return {
+    context: buildContextPath(contexts),
+    key: buildKey(key)
+  };
+}
+function buildContextKeyLog(contexts, key) {
+  return `${buildContextPath(contexts)}$${key}`;
+}
+function buildKey(key) {
+  if (key.trim().length <= 0) {
+    throw new import_SqliteStorageError.SqliteStorageError("build", key, "Key must not be an empty string.");
+  }
+  return key;
+}
+function escapeGlob(value) {
+  return value.replace(/[*[?]/g, "[$&]");
+}
+//# sourceMappingURL=SqliteUtil.js.map

package/dist/cjs/storage/sqlite/SqliteUtil.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/storage/sqlite/SqliteUtil.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,gCAAmC;AANnC;AAAA;AAAA;AAAA;AAAA;AAaO,SAAS,iBAAiB,UAAoB;AACjD,aAAW,OAAO,UAAU;AACxB,QAAI,IAAI,KAAK,EAAE,UAAU,KAAK,IAAI,SAAS,GAAG,GAAG;AAC7C,YAAM,IAAI;AAAA,QACN;AAAA,QACA,IAAI,SAAS,KAAK,GAAG,CAAC;AAAA,QACtB;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AACA,SAAO,SAAS,KAAK,GAAG;AAC5B;AAOO,SAAS,oBAAoB,UAAoB,KAAa;AACjE,SAAO;AAAA,IACH,SAAS,iBAAiB,QAAQ;AAAA,IAClC,KAAK,SAAS,GAAG;AAAA,EACrB;AACJ;AAKO,SAAS,mBAAmB,UAAoB,KAAa;AAChE,SAAO,GAAG,iBAAiB,QAAQ,CAAC,IAAI,GAAG;AAC/C;AAKO,SAAS,SAAS,KAAa;AAClC,MAAI,IAAI,KAAK,EAAE,UAAU,GAAG;AACxB,UAAM,IAAI,6CAAmB,SAAS,KAAK,kCAAkC;AAAA,EACjF;AACA,SAAO;AACX;AAKO,SAAS,WAAW,OAAe;AACtC,SAAO,MAAM,QAAQ,UAAU,MAAM;AACzC;",
+  "names": []
+}

package/dist/cjs/storage/sqlite/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export { PlatformSqlite } from "./platform/PlatformSqlite.js";
+export { SqliteStorage } from "./SqliteStorage.js";
+export { SqliteStorageError } from "./SqliteStorageError.js";
+export type { DatabaseCreator, DatabaseLike } from "./SqliteTypes.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/storage/sqlite/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/sqlite/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/cjs/storage/sqlite/index.js

@@ -0,0 +1,34 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var sqlite_exports = {};
+__export(sqlite_exports, {
+  PlatformSqlite: () => import_PlatformSqlite.PlatformSqlite,
+  SqliteStorage: () => import_SqliteStorage.SqliteStorage,
+  SqliteStorageError: () => import_SqliteStorageError.SqliteStorageError
+});
+module.exports = __toCommonJS(sqlite_exports);
+var import_PlatformSqlite = require("./platform/PlatformSqlite.js");
+var import_SqliteStorage = require("./SqliteStorage.js");
+var import_SqliteStorageError = require("./SqliteStorageError.js");
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=index.js.map

package/dist/cjs/storage/sqlite/index.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/storage/sqlite/index.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,4BAA+B;AAC/B,2BAA8B;AAC9B,gCAAmC;AARnC;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/storage/sqlite/platform/BunSqlite.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { SqliteStorage } from "../SqliteStorage.js";
+/**
+ * `StorageSqliteDisk` for Bun
+ *
+ * DO NOT IMPORT DIRECTLY
+ * (should import `PlatformSqlite.js`)
+ */
+export declare class BunSqlite extends SqliteStorage {
+    constructor(path: string | null, clear?: boolean);
+    clear(completely?: boolean): Promise<void>;
+}
+//# sourceMappingURL=BunSqlite.d.ts.map

package/dist/cjs/storage/sqlite/platform/BunSqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BunSqlite.d.ts","sourceRoot":"","sources":["../../../../../src/storage/sqlite/platform/BunSqlite.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMpD;;;;;GAKG;AACH,qBAAa,SAAU,SAAQ,aAAa;gBAC5B,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,UAAQ;IAY/B,KAAK,CAAC,UAAU,CAAC,EAAE,OAAO;CAQ5C"}

package/dist/cjs/storage/sqlite/platform/BunSqlite.js

@@ -0,0 +1,62 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var BunSqlite_exports = {};
+__export(BunSqlite_exports, {
+  BunSqlite: () => BunSqlite
+});
+module.exports = __toCommonJS(BunSqlite_exports);
+var import_SqliteStorage = require("../SqliteStorage.js");
+var import_bun_sqlite = require("bun:sqlite");
+var import_bun = __toESM(require("bun"), 1);
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class BunSqlite extends import_SqliteStorage.SqliteStorage {
+  constructor(path, clear = false) {
+    super({
+      databaseCreator: (path2) => new import_bun_sqlite.Database(path2, {
+        strict: true,
+        create: true
+      }),
+      path,
+      clear
+    });
+  }
+  async clear(completely) {
+    await super.clear();
+    if (completely ?? false) {
+      this.close();
+      await import_bun.default.file(this.dbPath).delete();
+      this.isInitialized = false;
+    }
+  }
+}
+//# sourceMappingURL=BunSqlite.js.map

package/dist/cjs/storage/sqlite/platform/BunSqlite.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/storage/sqlite/platform/BunSqlite.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,2BAA8B;AAE9B,wBAAyB;AAEzB,iBAAgB;AAVhB;AAAA;AAAA;AAAA;AAAA;AAkBO,MAAM,kBAAkB,mCAAc;AAAA,EACzC,YAAY,MAAqB,QAAQ,OAAO;AAC5C,UAAM;AAAA,MACF,iBAAiB,CAAAA,UACb,IAAI,2BAASA,OAAM;AAAA,QACf,QAAQ;AAAA,QACR,QAAQ;AAAA,MACZ,CAAC;AAAA,MACL;AAAA,MACA;AAAA,IACJ,CAAC;AAAA,EACL;AAAA,EAEA,MAAe,MAAM,YAAsB;AACvC,UAAM,MAAM,MAAM;AAClB,QAAI,cAAc,OAAO;AACrB,WAAK,MAAM;AACX,YAAM,WAAAC,QAAI,KAAK,KAAK,MAAM,EAAE,OAAO;AACnC,WAAK,gBAAgB;AAAA,IACzB;AAAA,EACJ;AACJ;",
+  "names": ["path", "Bun"]
+}

package/dist/cjs/storage/sqlite/platform/NodeJsSqlite.d.ts

@@ -0,0 +1,12 @@
+import { SqliteStorage } from "../SqliteStorage.js";
+/**
+ * `StorageSqliteDisk` for Node.js
+ *
+ * DO NOT IMPORT DIRECTLY
+ * (should import `PlatformSqlite.js`)
+ */
+export declare class NodeJsSqlite extends SqliteStorage {
+    constructor(path: string | null, clear?: boolean);
+    clear(completely?: boolean): Promise<void>;
+}
+//# sourceMappingURL=NodeJsSqlite.d.ts.map

package/dist/cjs/storage/sqlite/platform/NodeJsSqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeJsSqlite.d.ts","sourceRoot":"","sources":["../../../../../src/storage/sqlite/platform/NodeJsSqlite.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,aAAa;gBAC/B,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,UAAQ;IAQ/B,KAAK,CAAC,UAAU,CAAC,EAAE,OAAO;CAQ5C"}

package/dist/cjs/storage/sqlite/platform/NodeJsSqlite.js

@@ -0,0 +1,49 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var NodeJsSqlite_exports = {};
+__export(NodeJsSqlite_exports, {
+  NodeJsSqlite: () => NodeJsSqlite
+});
+module.exports = __toCommonJS(NodeJsSqlite_exports);
+var import_promises = require("node:fs/promises");
+var import_node_sqlite = require("node:sqlite");
+var import_SqliteStorage = require("../SqliteStorage.js");
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class NodeJsSqlite extends import_SqliteStorage.SqliteStorage {
+  constructor(path, clear = false) {
+    super({
+      databaseCreator: (path2) => new import_node_sqlite.DatabaseSync(path2),
+      path,
+      clear
+    });
+  }
+  async clear(completely) {
+    await super.clear();
+    if (completely ?? false) {
+      this.close();
+      await (0, import_promises.rm)(this.dbPath, { force: true });
+      this.isInitialized = false;
+    }
+  }
+}
+//# sourceMappingURL=NodeJsSqlite.js.map

package/dist/cjs/storage/sqlite/platform/NodeJsSqlite.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/storage/sqlite/platform/NodeJsSqlite.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,sBAAmB;AACnB,yBAA6B;AAE7B,2BAA8B;AAR9B;AAAA;AAAA;AAAA;AAAA;AAiBO,MAAM,qBAAqB,mCAAc;AAAA,EAC5C,YAAY,MAAqB,QAAQ,OAAO;AAC5C,UAAM;AAAA,MACF,iBAAiB,CAAAA,UAAQ,IAAI,gCAAaA,KAAI;AAAA,MAC9C;AAAA,MACA;AAAA,IACJ,CAAC;AAAA,EACL;AAAA,EAEA,MAAe,MAAM,YAAsB;AACvC,UAAM,MAAM,MAAM;AAClB,QAAI,cAAc,OAAO;AACrB,WAAK,MAAM;AACX,gBAAM,oBAAG,KAAK,QAAQ,EAAE,OAAO,KAAK,CAAC;AACrC,WAAK,gBAAgB;AAAA,IACzB;AAAA,EACJ;AACJ;",
+  "names": ["path"]
+}

package/dist/cjs/storage/sqlite/platform/PlatformSqlite.d.ts

@@ -0,0 +1,8 @@
+import type { SqliteStorage } from "../SqliteStorage.js";
+/**
+ * Create platform-specific SQLite storage
+ *
+ * Automatically detects runtime (Bun or Node.js) and returns appropriate implementation.
+ */
+export declare function PlatformSqlite(path: string | null, clear?: boolean): Promise<SqliteStorage>;
+//# sourceMappingURL=PlatformSqlite.d.ts.map

package/dist/cjs/storage/sqlite/platform/PlatformSqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlatformSqlite.d.ts","sourceRoot":"","sources":["../../../../../src/storage/sqlite/platform/PlatformSqlite.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,CAc/F"}

package/dist/cjs/storage/sqlite/platform/PlatformSqlite.js

@@ -0,0 +1,54 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var PlatformSqlite_exports = {};
+__export(PlatformSqlite_exports, {
+  PlatformSqlite: () => PlatformSqlite
+});
+module.exports = __toCommonJS(PlatformSqlite_exports);
+var import_runtimeChecks = require("#util/runtimeChecks.js");
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+async function PlatformSqlite(path, clear = false) {
+  const isBun = (0, import_runtimeChecks.isBunjs)();
+  if (!isBun) {
+    const module3 = await import("./NodeJsSqlite.js");
+    const NodeJsSqlite = findDefaultExport(module3, "NodeJsSqlite");
+    return new NodeJsSqlite(path, clear);
+  }
+  const module2 = await import("./BunSqlite.js");
+  const BunSqlite = findDefaultExport(module2, "BunSqlite");
+  return new BunSqlite(path, clear);
+}
+function findDefaultExport(moduleLike, name) {
+  return moduleLike[name] || moduleLike.default?.[name] || moduleLike.default;
+}
+//# sourceMappingURL=PlatformSqlite.js.map

package/dist/cjs/storage/sqlite/platform/PlatformSqlite.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/storage/sqlite/platform/PlatformSqlite.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,2BAAwB;AALxB;AAAA;AAAA;AAAA;AAAA;AAaA,eAAsB,eAAe,MAAqB,QAAQ,OAA+B;AAC7F,QAAM,YAAQ,8BAAQ;AAGtB,MAAI,CAAC,OAAO;AACR,UAAMA,UAAS,MAAM,OAAO,mBAAmB;AAC/C,UAAM,eAAe,kBAAkBA,SAAQ,cAAc;AAC7D,WAAO,IAAI,aAAa,MAAM,KAAK;AAAA,EACvC;AAGA,QAAMA,UAAS,MAAM,OAAO,gBAAgB;AAC5C,QAAM,YAAY,kBAAkBA,SAAQ,WAAW;AACvD,SAAO,IAAI,UAAU,MAAM,KAAK;AACpC;AAsBA,SAAS,kBAAwC,YAAe,MAAe;AAC3E,SAAO,WAAW,IAAI,KAAM,WAAmB,UAAU,IAAI,KAAM,WAAmB;AAC1F;",
+  "names": ["module"]
+}

package/dist/cjs/util/runtimeChecks.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Check runtime is bun.js
+ */
+export declare function isBunjs(): boolean;
+/**
+ * Check Node.js's runtime supports sqlite.
+ */
+export declare function supportsSqlite(): boolean;
+//# sourceMappingURL=runtimeChecks.d.ts.map

package/dist/cjs/util/runtimeChecks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeChecks.d.ts","sourceRoot":"","sources":["../../../src/util/runtimeChecks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH;;GAEG;AACH,wBAAgB,OAAO,YAEtB;AAED;;GAEG;AACH,wBAAgB,cAAc,YAa7B"}

package/dist/cjs/util/runtimeChecks.js

@@ -0,0 +1,45 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var runtimeChecks_exports = {};
+__export(runtimeChecks_exports, {
+  isBunjs: () => isBunjs,
+  supportsSqlite: () => supportsSqlite
+});
+module.exports = __toCommonJS(runtimeChecks_exports);
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function isBunjs() {
+  return process.versions.bun != null;
+}
+function supportsSqlite() {
+  const nodeVersion = process.versions.node;
+  if (!nodeVersion.includes(".")) {
+    return false;
+  }
+  const prefixPart = nodeVersion.substring(0, nodeVersion.indexOf("."));
+  const majorNum = Number(prefixPart);
+  if (Number.isNaN(majorNum)) {
+    return false;
+  }
+  return majorNum >= 22;
+}
+//# sourceMappingURL=runtimeChecks.js.map

package/dist/cjs/util/runtimeChecks.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/runtimeChecks.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAUO,SAAS,UAAU;AACtB,SAAO,QAAQ,SAAS,OAAO;AACnC;AAKO,SAAS,iBAAiB;AAC7B,QAAM,cAAc,QAAQ,SAAS;AACrC,MAAI,CAAC,YAAY,SAAS,GAAG,GAAG;AAC5B,WAAO;AAAA,EACX;AACA,QAAM,aAAa,YAAY,UAAU,GAAG,YAAY,QAAQ,GAAG,CAAC;AAEpE,QAAM,WAAW,OAAO,UAAU;AAClC,MAAI,OAAO,MAAM,QAAQ,GAAG;AACxB,WAAO;AAAA,EACX;AAEA,SAAO,YAAY;AACvB;",
+  "names": []
+}

package/dist/esm/config.d.ts

@@ -68,6 +68,12 @@ export declare const config: {
      * If you disable this you must initialize environmental storage manually for components that rely on it.
      */
     initializeStorage: boolean;
+    /**
+     * Set storage driver to use (default: 'file').
+     *
+     * Currently, 'file' and 'sqlite' (Node.js v22+) is supported.
+     */
+    storageDriver: "file" | "sqlite";
     /**
      * Enables handling of SIGINT, SIGTERM, SIGUSR2 and SIGABRT (depending on platform; default: true).
      */

package/dist/esm/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmBH,qBAAa,6BAA8B,SAAQ,KAAK;CAAG;AAE3D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,MAAM;mBACU,OAAO;IAMhC;;OAEG;4BAK+B,MAAM;IAKxC;;OAEG;wBAK2B,MAAM,GAAG,SAAS;IAKhD;;;OAGG;2BAK8B,MAAM;IAKvC;;OAEG;qBAKwB,OAAO;IAKlC;;OAEG;oBAKuB,OAAO;IAKjC;;OAEG;oBAKuB,OAAO;IAKjC;;OAEG;mBAKsB,OAAO;IAKhC;;OAEG;oBAKuB,OAAO;IAKjC;;;;OAIG;uBAK0B,OAAO;IAKpC;;OAEG;wBAK2B,OAAO;IAKrC;;;;;OAKG;yBAK4B,OAAO;IAKtC;;;OAGG;+BAKkC,OAAO;CAI/C,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmBH,qBAAa,6BAA8B,SAAQ,KAAK;CAAG;AAE3D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,MAAM;mBACU,OAAO;IAMhC;;OAEG;4BAK+B,MAAM;IAKxC;;OAEG;wBAK2B,MAAM,GAAG,SAAS;IAKhD;;;OAGG;2BAK8B,MAAM;IAKvC;;OAEG;qBAKwB,OAAO;IAKlC;;OAEG;oBAKuB,OAAO;IAKjC;;OAEG;oBAKuB,OAAO;IAKjC;;OAEG;mBAKsB,OAAO;IAKhC;;OAEG;oBAKuB,OAAO;IAKjC;;;;OAIG;uBAK0B,OAAO;IAKpC;;;;OAIG;mBAKsB,MAAM,GAAG,QAAQ;IAK1C;;OAEG;wBAK2B,OAAO;IAKrC;;;;;OAKG;yBAK4B,OAAO;IAKtC;;;OAGG;+BAKkC,OAAO;CAI/C,CAAC"}

package/dist/esm/config.js

@@ -15,7 +15,8 @@ let trapProcessSignals = true;
 let trapUnhandledErrors = true;
 let setProcessExitCodeOnError = true;
 let installNetwork = true;
-let installCrypto = !process.versions.bun;
+let installCrypto = true;
+let storageDriver = "file";
 class NodeJsAlreadyInitializedError extends Error {
 }
 const config = {
@@ -117,6 +118,18 @@ const config = {
     assertUninitialized("initializeStorage");
     initializeStorage = value;
   },
+  /**
+   * Set storage driver to use (default: 'file').
+   *
+   * Currently, 'file' and 'sqlite' (Node.js v22+) is supported.
+   */
+  get storageDriver() {
+    return storageDriver;
+  },
+  set storageDriver(value) {
+    assertUninitialized("initializeStorage");
+    storageDriver = value;
+  },
   /**
    * Enables handling of SIGINT, SIGTERM, SIGUSR2 and SIGABRT (depending on platform; default: true).
    */