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

package/dist/esm/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/esm/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/esm/storage/sqlite/index.js

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

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/storage/sqlite/index.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,sBAAsB;AAC/B,SAAS,qBAAqB;AAC9B,SAAS,0BAA0B;",
+  "names": []
+}

package/dist/esm/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/esm/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/esm/storage/sqlite/platform/BunSqlite.js

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { SqliteStorage } from "../SqliteStorage.js";
+import { Database } from "bun:sqlite";
+import Bun from "bun";
+class BunSqlite extends SqliteStorage {
+  constructor(path, clear = false) {
+    super({
+      databaseCreator: (path2) => new Database(path2, {
+        strict: true,
+        create: true
+      }),
+      path,
+      clear
+    });
+  }
+  async clear(completely) {
+    await super.clear();
+    if (completely ?? false) {
+      this.close();
+      await Bun.file(this.dbPath).delete();
+      this.isInitialized = false;
+    }
+  }
+}
+export {
+  BunSqlite
+};
+//# sourceMappingURL=BunSqlite.js.map

package/dist/esm/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,SAAS,qBAAqB;AAE9B,SAAS,gBAAgB;AAEzB,OAAO,SAAS;AAQT,MAAM,kBAAkB,cAAc;AAAA,EACzC,YAAY,MAAqB,QAAQ,OAAO;AAC5C,UAAM;AAAA,MACF,iBAAiB,CAAAA,UACb,IAAI,SAASA,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,IAAI,KAAK,KAAK,MAAM,EAAE,OAAO;AACnC,WAAK,gBAAgB;AAAA,IACzB;AAAA,EACJ;AACJ;",
+  "names": ["path"]
+}

package/dist/esm/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/esm/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/esm/storage/sqlite/platform/NodeJsSqlite.js

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { rm } from "node:fs/promises";
+import { DatabaseSync } from "node:sqlite";
+import { SqliteStorage } from "../SqliteStorage.js";
+class NodeJsSqlite extends SqliteStorage {
+  constructor(path, clear = false) {
+    super({
+      databaseCreator: (path2) => new DatabaseSync(path2),
+      path,
+      clear
+    });
+  }
+  async clear(completely) {
+    await super.clear();
+    if (completely ?? false) {
+      this.close();
+      await rm(this.dbPath, { force: true });
+      this.isInitialized = false;
+    }
+  }
+}
+export {
+  NodeJsSqlite
+};
+//# sourceMappingURL=NodeJsSqlite.js.map

package/dist/esm/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,SAAS,UAAU;AACnB,SAAS,oBAAoB;AAE7B,SAAS,qBAAqB;AASvB,MAAM,qBAAqB,cAAc;AAAA,EAC5C,YAAY,MAAqB,QAAQ,OAAO;AAC5C,UAAM;AAAA,MACF,iBAAiB,CAAAA,UAAQ,IAAI,aAAaA,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,YAAM,GAAG,KAAK,QAAQ,EAAE,OAAO,KAAK,CAAC;AACrC,WAAK,gBAAgB;AAAA,IACzB;AAAA,EACJ;AACJ;",
+  "names": ["path"]
+}

package/dist/esm/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/esm/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/esm/storage/sqlite/platform/PlatformSqlite.js

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { isBunjs } from "#util/runtimeChecks.js";
+async function PlatformSqlite(path, clear = false) {
+  const isBun = isBunjs();
+  if (!isBun) {
+    const module2 = await import("./NodeJsSqlite.js");
+    const NodeJsSqlite = findDefaultExport(module2, "NodeJsSqlite");
+    return new NodeJsSqlite(path, clear);
+  }
+  const module = await import("./BunSqlite.js");
+  const BunSqlite = findDefaultExport(module, "BunSqlite");
+  return new BunSqlite(path, clear);
+}
+function findDefaultExport(moduleLike, name) {
+  return moduleLike[name] || moduleLike.default?.[name] || moduleLike.default;
+}
+export {
+  PlatformSqlite
+};
+//# sourceMappingURL=PlatformSqlite.js.map

package/dist/esm/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,SAAS,eAAe;AAQxB,eAAsB,eAAe,MAAqB,QAAQ,OAA+B;AAC7F,QAAM,QAAQ,QAAQ;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,QAAM,SAAS,MAAM,OAAO,gBAAgB;AAC5C,QAAM,YAAY,kBAAkB,QAAQ,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/esm/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/esm/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/esm/util/runtimeChecks.js

@@ -0,0 +1,25 @@
+/**
+ * @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;
+}
+export {
+  isBunjs,
+  supportsSqlite
+};
+//# sourceMappingURL=runtimeChecks.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/runtimeChecks.ts"],
+  "mappings": "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/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@matter/nodejs",
-    "version": "0.16.6-alpha.0-20260121-06f1d9611",
+    "version": "0.16.6-alpha.0-20260122-b5154bcb4",
     "description": "Node.js platform support for matter.js",
     "keywords": [
         "iot",
@@ -44,17 +44,17 @@
         "#*": "./src/*"
     },
     "dependencies": {
-        "@matter/general": "0.16.6-alpha.0-20260121-06f1d9611",
-        "@matter/node": "0.16.6-alpha.0-20260121-06f1d9611",
-        "@matter/protocol": "0.16.6-alpha.0-20260121-06f1d9611",
-        "@matter/types": "0.16.6-alpha.0-20260121-06f1d9611"
+        "@matter/general": "0.16.6-alpha.0-20260122-b5154bcb4",
+        "@matter/node": "0.16.6-alpha.0-20260122-b5154bcb4",
+        "@matter/protocol": "0.16.6-alpha.0-20260122-b5154bcb4",
+        "@matter/types": "0.16.6-alpha.0-20260122-b5154bcb4"
     },
     "devDependencies": {
-        "@matter/model": "0.16.6-alpha.0-20260121-06f1d9611",
-        "@matter/protocol": "0.16.6-alpha.0-20260121-06f1d9611",
-        "@matter/testing": "0.16.6-alpha.0-20260121-06f1d9611",
-        "@matter/tools": "0.16.6-alpha.0-20260121-06f1d9611",
-        "@project-chip/matter.js": "0.16.6-alpha.0-20260121-06f1d9611",
+        "@matter/model": "0.16.6-alpha.0-20260122-b5154bcb4",
+        "@matter/protocol": "0.16.6-alpha.0-20260122-b5154bcb4",
+        "@matter/testing": "0.16.6-alpha.0-20260122-b5154bcb4",
+        "@matter/tools": "0.16.6-alpha.0-20260122-b5154bcb4",
+        "@project-chip/matter.js": "0.16.6-alpha.0-20260122-b5154bcb4",
         "@types/bytebuffer": "^5.0.49"
     },
     "files": [

package/src/config.ts

@@ -16,10 +16,10 @@ let trapProcessSignals = true;
 let trapUnhandledErrors = true;
 let setProcessExitCodeOnError = true;
 let installNetwork = true;
-
-// TODO - until we have proper feature detection, disable by default Node.js version of crypto in environments where
-// Node.js crypto emulation is insufficient
-let installCrypto = !process.versions.bun;
+// Automatic replace to `StandardCrypto` in bun.js
+let installCrypto = true;
+// Storage driver
+let storageDriver = "file";
 
 export class NodeJsAlreadyInitializedError extends Error {}
 
@@ -163,6 +163,20 @@ export const config = {
         initializeStorage = value;
     },
 
+    /**
+     * Set storage driver to use (default: 'file').
+     *
+     * Currently, 'file' and 'sqlite' (Node.js v22+) is supported.
+     */
+    get storageDriver() {
+        return storageDriver as "file" | "sqlite";
+    },
+
+    set storageDriver(value: "file" | "sqlite") {
+        assertUninitialized("initializeStorage");
+        storageDriver = value;
+    },
+
     /**
      * Enables handling of SIGINT, SIGTERM, SIGUSR2 and SIGABRT (depending on platform; default: true).
      */

package/src/environment/NodeJsEnvironment.ts

@@ -18,15 +18,20 @@ import {
     Logger,
     Network,
     ServiceBundle,
+    StandardCrypto,
     StorageService,
     VariableService,
 } from "#general";
 import { NodeJsHttpEndpoint } from "#net/NodeJsHttpEndpoint.js";
+import { StorageFactory } from "#storage/index.js";
+
+import { isBunjs } from "#util/runtimeChecks.js";
+
 import { existsSync, readFileSync } from "node:fs";
 import { writeFile } from "node:fs/promises";
 import { resolve } from "node:path";
+
 import { NodeJsNetwork } from "../net/NodeJsNetwork.js";
-import { StorageBackendDisk } from "../storage/StorageBackendDisk.js";
 import { ProcessManager } from "./ProcessManager.js";
 
 /**
@@ -62,9 +67,10 @@ import { ProcessManager } from "./ProcessManager.js";
  * * `trace.enable` - Enable writing a trace file
  * * `storage.path` - Where to store storage files, Default: "path.root"
  * * `storage.clear` - Clear storage on start? Default: false
+ * * `storage.driver` - Storage driver to use: "file" (default) or "sqlite" (requires Node.js v22+). Automatically migrates data when switching drivers.
  * * `nodejs.crypto` - Enables crypto implementation in this package.  Default: true
  * * `nodejs.network` - Enables network implementation in this package.  Default: true
- * * `nodejs.storage` - Enables file-based storage implementation in this package.  Default: true
+ * * `nodejs.storage` - Enables storage implementation in this package.  Default: true
  * * `runtime.signals` - By default register SIGINT and SIGUSR2 (diag) handlers, set to false if not wanted
  * * `runtime.exitcode` - By default we set the process.exitcode to 0 (ok) or 1 (crash); set to false to disable
  * * `runtime.unhandlederrors` - By default we log unhandled errors to matter.js log; set to false to disable
@@ -140,16 +146,24 @@ function rootDirOf(env: Environment) {
 function configureCrypto(env: Environment) {
     Boot.init(() => {
         if (config.installCrypto || (env.vars.boolean("nodejs.crypto") ?? true)) {
-            const crypto = new NodeJsCrypto();
+            let crypto: Crypto;
+            if (!isBunjs()) {
+                // Platform implemented crypto
+                crypto = new NodeJsCrypto();
+            } else {
+                // Unsupported environment fallback
+                crypto = new StandardCrypto(global.crypto);
+            }
             env.set(Entropy, crypto);
             env.set(Crypto, crypto);
-        } else {
-            if (Environment.default.has(Entropy)) {
-                env.set(Entropy, Environment.default.get(Entropy));
-            }
-            if (Environment.default.has(Crypto)) {
-                env.set(Crypto, Environment.default.get(Crypto));
-            }
+            return;
+        }
+        // Extends default crypto
+        if (Environment.default.has(Entropy)) {
+            env.set(Entropy, Environment.default.get(Entropy));
+        }
+        if (Environment.default.has(Crypto)) {
+            env.set(Crypto, Environment.default.get(Crypto));
         }
     });
 }
@@ -191,8 +205,23 @@ function configureStorage(env: Environment) {
         service.location = env.vars.get("storage.path", rootDirOf(env));
     });
 
-    service.factory = namespace =>
-        new StorageBackendDisk(resolve(service.location ?? ".", namespace), env.vars.get("storage.clear", false));
+    const shouldClear = env.vars.get("storage.clear", false);
+    let storageDriver = config.storageDriver ?? env.vars.string("storage.driver") ?? "file";
+
+    // fallback 'file' when storageDriver is blank
+    if (storageDriver.length === 0) {
+        storageDriver = "file";
+    }
+
+    // code is moved to StorageFactory
+    service.factory = async namespace => {
+        return await StorageFactory.create({
+            driver: storageDriver,
+            rootDir: service.location ?? ".",
+            namespace,
+            clear: shouldClear,
+        });
+    };
 
     service.resolve = (...paths) => resolve(rootDirOf(env), ...paths);
 }

package/src/net/NodeJsHttpEndpoint.ts

@@ -310,7 +310,7 @@ class NodeJsHttpRequest extends Request {
         } as RequestInit;
 
         if (method !== "GET" && method !== "HEAD") {
-            init.body = IncomingMessage.toWeb(message) as ReadableStream;
+            init.body = IncomingMessage.toWeb(message) as unknown as ReadableStream;
         }
 
         super(url, init);