@project-chip/matter-node.js-examples 0.8.0-alpha.0-20240311-6a811d05 → 0.8.0-alpha.0-20240317-b07eaba6

package/README.md

@@ -15,6 +15,11 @@ For BLE usage please also see the [matter-node-ble.js README.md](../matter-node-
 ## Examples Overview
 The examples provided by this repository show different use cases demonstrating how to build different device types and show various ways to implement and interact with the matter.js structures. This section gives an overview regarding what the different examples demonstrate.
 
+> [!IMPORTANT]
+> With matter.js 0.8 we introduced a new API that is not compatible with the old API. The new API is more flexible and allows for more complex use cases. The old API is still supported but will be removed in a future release. The examples are provided for both APIs. The new API examples are named without "Legacy" in the filename and the npm run script is named without "-legacy". The old API examples are named with "Legacy" in the filename and the npm run script is named with "-legacy".
+> If you used the old Example scripts and want to just switch to use the new scripts you need to convert the device storage once. Please see below in the section about the ["Legacy Storage Converter"](#legacy-storage-converter).
+
+
 ### Legacy Device Examples
 These examples use the matter.js API up to 0.7, which is considered "Legacy" now because it will be replaced by a new API starting with 0.8. The functionality is still working, but should be considered deprecated and will be removed with a later release!
 The filenames of these examples were adjusted in 0.8 and a "Legacy" was added to the end of the filename and "-legacy" to the npm run script name (exception: DeviceNode is now called DeviceNodeFullLegacy). Other than that they are fully compatible with the pre-0.7 versions also regarding storage location and structure and can be directly used as before.
@@ -55,6 +60,18 @@ Additionally, these two examples are not directly configurable by CLI and mainly
 ## Controller example
 * **ControllerNode**: This example shows basically how a controller could be implemented by showing pairing and connections to a paired device. When there is an OnOff Endpoint with ID 1 then this is controlled and toggled.
 
+## Legacy Storage Converter
+The Legacy storage converter can convert the Device and Controller storages from the legacy examples. It will convert all relevant storage keys, but not the persisted cluster specific data (which should be acceptable because near to irrelevant for the device types we had examples for).
+
+To use the converter, you need to run the following command:
+```bash
+npm run matter-legacystorageconverter -- --legacy-storage-path=<Path-to-Legcy-Storage-Dir> --storage-path=<Path-to-New-Storage-Dir>
+```
+
+> [!NOTICE]
+> The Conbverter might tell you to make sure to use the full parameters when starting the new example after conversion. This is needed in some cases because some data were not stored in the storage prior the new versions and are so missing in the storage.
+
+After this you can use the new Device example script to start it.
 
 ## Installation
 

package/dist/esm/examples/ControllerNode.js

@@ -6,8 +6,7 @@
  */
 import "@project-chip/matter-node.js";
 import { BleNode } from "@project-chip/matter-node-ble.js/ble";
-import { StorageBackendDisk } from "@project-chip/matter-node.js/storage";
-import { getIntParameter, getParameter, hasParameter, requireMinNodeVersion } from "@project-chip/matter-node.js/util";
+import { requireMinNodeVersion } from "@project-chip/matter-node.js/util";
 import { CommissioningController } from "@project-chip/matter.js";
 import { Ble } from "@project-chip/matter.js/ble";
 import {
@@ -18,63 +17,35 @@ import {
 } from "@project-chip/matter.js/cluster";
 import { NodeId } from "@project-chip/matter.js/datatype";
 import { NodeStateInformation } from "@project-chip/matter.js/device";
-import { Environment } from "@project-chip/matter.js/environment";
-import { Format, Level, Logger } from "@project-chip/matter.js/log";
+import { Environment, StorageService } from "@project-chip/matter.js/environment";
+import { Logger } from "@project-chip/matter.js/log";
 import { ManualPairingCodeCodec } from "@project-chip/matter.js/schema";
-import { StorageManager } from "@project-chip/matter.js/storage";
 import { Time } from "@project-chip/matter.js/time";
 import { singleton } from "@project-chip/matter.js/util";
 const logger = Logger.get("Controller");
 requireMinNodeVersion(16);
-switch (getParameter("loglevel")) {
-  case "fatal":
-    Logger.defaultLogLevel = Level.FATAL;
-    break;
-  case "error":
-    Logger.defaultLogLevel = Level.ERROR;
-    break;
-  case "warn":
-    Logger.defaultLogLevel = Level.WARN;
-    break;
-  case "info":
-    Logger.defaultLogLevel = Level.INFO;
-    break;
-}
-switch (getParameter("logformat")) {
-  case "plain":
-    Logger.format = Format.PLAIN;
-    break;
-  case "html":
-    Logger.format = Format.HTML;
-    break;
-  default:
-    if (process.stdin?.isTTY)
-      Logger.format = Format.ANSI;
-}
-if (hasParameter("ble")) {
+const environment = Environment.default;
+if (environment.vars.get("ble")) {
   Ble.get = singleton(
     () => new BleNode({
-      hciId: getIntParameter("ble-hci-id")
+      hciId: environment.vars.number("ble-hci-id")
     })
   );
 }
-const storageLocation = getParameter("store") ?? ".controller-node";
-const storage = new StorageBackendDisk(storageLocation, hasParameter("clearstorage"));
-logger.info(`Storage location: ${storageLocation} (Directory)`);
+const storageService = environment.get(StorageService);
+console.log(`Storage location: ${storageService.location} (Directory)`);
 logger.info(
-  'Use the parameter "-store NAME" to specify a different storage location, use -clearstorage to start with an empty storage.'
+  'Use the parameter "--storage-path=NAME-OR-PATH" to specify a different storage location in this directory, use --storage-clear to start with an empty storage.'
 );
 class ControllerNode {
   async start() {
     logger.info(`node-matter Controller started`);
-    const storageManager = new StorageManager(storage);
-    await storageManager.initialize();
-    const controllerStorage = storageManager.createContext("Controller");
-    const ip = controllerStorage.has("ip") ? controllerStorage.get("ip") : getParameter("ip");
-    const port = controllerStorage.has("port") ? controllerStorage.get("port") : getIntParameter("port");
-    const uniqueId = controllerStorage.has("uniqueid") ? controllerStorage.get("uniqueid") : getParameter("uniqueid") ?? Time.nowMs().toString();
+    const controllerStorage = (await storageService.open("controller")).createContext("data");
+    const ip = controllerStorage.has("ip") ? controllerStorage.get("ip") : environment.vars.string("ip");
+    const port = controllerStorage.has("port") ? controllerStorage.get("port") : environment.vars.number("port");
+    const uniqueId = controllerStorage.has("uniqueid") ? controllerStorage.get("uniqueid") : environment.vars.string("uniqueid") ?? Time.nowMs().toString();
     controllerStorage.set("uniqueid", uniqueId);
-    const pairingCode = getParameter("pairingcode");
+    const pairingCode = environment.vars.string("pairingcode");
     let longDiscriminator, setupPin, shortDiscriminator;
     if (pairingCode !== void 0) {
       const pairingCodeCodec = ManualPairingCodeCodec.decode(pairingCode);
@@ -83,10 +54,10 @@ class ControllerNode {
       setupPin = pairingCodeCodec.passcode;
       logger.debug(`Data extracted from pairing code: ${Logger.toJSON(pairingCodeCodec)}`);
     } else {
-      longDiscriminator = getIntParameter("longDiscriminator") ?? controllerStorage.get("longDiscriminator", 3840);
+      longDiscriminator = environment.vars.number("longDiscriminator") ?? controllerStorage.get("longDiscriminator", 3840);
       if (longDiscriminator > 4095)
         throw new Error("Discriminator value must be less than 4096");
-      setupPin = getIntParameter("pin") ?? controllerStorage.get("pin", 20202021);
+      setupPin = environment.vars.number("pin") ?? controllerStorage.get("pin", 20202021);
     }
     if (shortDiscriminator === void 0 && longDiscriminator === void 0 || setupPin === void 0) {
       throw new Error(
@@ -98,12 +69,12 @@ class ControllerNode {
       regulatoryCountryCode: "XX"
     };
     let ble = false;
-    if (hasParameter("ble")) {
+    if (environment.vars.get("ble")) {
       ble = true;
-      const wifiSsid = getParameter("ble-wifi-ssid");
-      const wifiCredentials = getParameter("ble-wifi-credentials");
-      const threadNetworkName = getParameter("ble-thread-networkname");
-      const threadOperationalDataset = getParameter("ble-thread-operationaldataset");
+      const wifiSsid = environment.vars.string("ble-wifi-ssid");
+      const wifiCredentials = environment.vars.string("ble-wifi-credentials");
+      const threadNetworkName = environment.vars.string("ble-thread-networkname");
+      const threadOperationalDataset = environment.vars.string("ble-thread-operationaldataset");
       if (wifiSsid !== void 0 && wifiCredentials !== void 0) {
         logger.info(`Registering Commissioning over BLE with WiFi: ${wifiSsid}`);
         commissioningOptions.wifiNetwork = {
@@ -119,7 +90,6 @@ class ControllerNode {
         };
       }
     }
-    const environment = Environment.default;
     const commissioningController = new CommissioningController({
       environment: {
         environment,
@@ -147,7 +117,7 @@ class ControllerNode {
     try {
       const nodes = commissioningController.getCommissionedNodes();
       console.log("Found commissioned nodes:", Logger.toJSON(nodes));
-      const nodeId = NodeId(getIntParameter("nodeid") ?? nodes[0]);
+      const nodeId = NodeId(environment.vars.number("nodeid") ?? nodes[0]);
       if (!nodes.includes(nodeId)) {
         throw new Error(`Node ${nodeId} not found in commissioned nodes`);
       }
@@ -225,7 +195,4 @@ class ControllerNode {
   }
 }
 new ControllerNode().start().catch((error) => logger.error(error));
-process.on("SIGINT", () => {
-  storage.close().then(() => process.exit(0)).catch(() => process.exit(1));
-});
 //# sourceMappingURL=ControllerNode.js.map

package/dist/esm/examples/ControllerNode.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/examples/ControllerNode.ts"],
-  "sourcesContent": ["#!/usr/bin/env node\n\n/**\n * @license\n * Copyright 2022-2024 Matter.js Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\n/**\n * This example shows how to create a Matter controller to pair with a device and interfact with it.\n * It can be used as CLI script, but is more thought as a starting point for your own controller implementation\n * because you need to adjust the code in any way depending on your use case.\n */\n\n/**\n * Import needed modules from @project-chip/matter-node.js\n */\n// Include this first to auto-register Crypto, Network and Time Node.js implementations\n// Include this first to auto-register Crypto, Network and Time Node.js implementations\nimport \"@project-chip/matter-node.js\";\n\nimport { BleNode } from \"@project-chip/matter-node-ble.js/ble\";\nimport { StorageBackendDisk } from \"@project-chip/matter-node.js/storage\";\nimport { getIntParameter, getParameter, hasParameter, requireMinNodeVersion } from \"@project-chip/matter-node.js/util\";\nimport { CommissioningController, NodeCommissioningOptions } from \"@project-chip/matter.js\";\nimport { Ble } from \"@project-chip/matter.js/ble\";\nimport {\n    BasicInformationCluster,\n    DescriptorCluster,\n    GeneralCommissioning,\n    OnOffCluster,\n} from \"@project-chip/matter.js/cluster\";\nimport { NodeId } from \"@project-chip/matter.js/datatype\";\nimport { NodeStateInformation } from \"@project-chip/matter.js/device\";\nimport { Environment } from \"@project-chip/matter.js/environment\";\nimport { Format, Level, Logger } from \"@project-chip/matter.js/log\";\nimport { CommissioningOptions } from \"@project-chip/matter.js/protocol\";\nimport { ManualPairingCodeCodec } from \"@project-chip/matter.js/schema\";\nimport { StorageManager } from \"@project-chip/matter.js/storage\";\nimport { Time } from \"@project-chip/matter.js/time\";\nimport { singleton } from \"@project-chip/matter.js/util\";\n\nconst logger = Logger.get(\"Controller\");\n\nrequireMinNodeVersion(16);\n\n/** Configure logging */\nswitch (getParameter(\"loglevel\")) {\n    case \"fatal\":\n        Logger.defaultLogLevel = Level.FATAL;\n        break;\n    case \"error\":\n        Logger.defaultLogLevel = Level.ERROR;\n        break;\n    case \"warn\":\n        Logger.defaultLogLevel = Level.WARN;\n        break;\n    case \"info\":\n        Logger.defaultLogLevel = Level.INFO;\n        break;\n}\n\nswitch (getParameter(\"logformat\")) {\n    case \"plain\":\n        Logger.format = Format.PLAIN;\n        break;\n    case \"html\":\n        Logger.format = Format.HTML;\n        break;\n    default:\n        if (process.stdin?.isTTY) Logger.format = Format.ANSI;\n}\n\nif (hasParameter(\"ble\")) {\n    // Initialize Ble\n    Ble.get = singleton(\n        () =>\n            new BleNode({\n                hciId: getIntParameter(\"ble-hci-id\"),\n            }),\n    );\n}\n\nconst storageLocation = getParameter(\"store\") ?? \".controller-node\";\nconst storage = new StorageBackendDisk(storageLocation, hasParameter(\"clearstorage\"));\nlogger.info(`Storage location: ${storageLocation} (Directory)`);\nlogger.info(\n    'Use the parameter \"-store NAME\" to specify a different storage location, use -clearstorage to start with an empty storage.',\n);\n\nclass ControllerNode {\n    async start() {\n        logger.info(`node-matter Controller started`);\n\n        /**\n         * Initialize the storage system.\n         *\n         * The storage manager is then also used by the Matter server, so this code block in general is required,\n         * but you can choose a different storage backend as long as it implements the required API.\n         */\n\n        const storageManager = new StorageManager(storage);\n        await storageManager.initialize();\n\n        /**\n         * Collect all needed data\n         *\n         * This block makes sure to collect all needed data from cli or storage. Replace this with where ever your data\n         * come from.\n         *\n         * Note: This example also uses the initialized storage system to store the device parameter data for convenience\n         * and easy reuse. When you also do that be careful to not overlap with Matter-Server own contexts\n         * (so maybe better not ;-)).\n         */\n\n        const controllerStorage = storageManager.createContext(\"Controller\");\n        const ip = controllerStorage.has(\"ip\") ? controllerStorage.get<string>(\"ip\") : getParameter(\"ip\");\n        const port = controllerStorage.has(\"port\") ? controllerStorage.get<number>(\"port\") : getIntParameter(\"port\");\n        const uniqueId = controllerStorage.has(\"uniqueid\")\n            ? controllerStorage.get<string>(\"uniqueid\")\n            : getParameter(\"uniqueid\") ?? Time.nowMs().toString();\n        controllerStorage.set(\"uniqueid\", uniqueId);\n\n        const pairingCode = getParameter(\"pairingcode\");\n        let longDiscriminator, setupPin, shortDiscriminator;\n        if (pairingCode !== undefined) {\n            const pairingCodeCodec = ManualPairingCodeCodec.decode(pairingCode);\n            shortDiscriminator = pairingCodeCodec.shortDiscriminator;\n            longDiscriminator = undefined;\n            setupPin = pairingCodeCodec.passcode;\n            logger.debug(`Data extracted from pairing code: ${Logger.toJSON(pairingCodeCodec)}`);\n        } else {\n            longDiscriminator =\n                getIntParameter(\"longDiscriminator\") ?? controllerStorage.get(\"longDiscriminator\", 3840);\n            if (longDiscriminator > 4095) throw new Error(\"Discriminator value must be less than 4096\");\n            setupPin = getIntParameter(\"pin\") ?? controllerStorage.get(\"pin\", 20202021);\n        }\n        if ((shortDiscriminator === undefined && longDiscriminator === undefined) || setupPin === undefined) {\n            throw new Error(\n                \"Please specify the longDiscriminator of the device to commission with -longDiscriminator or provide a valid passcode with -passcode\",\n            );\n        }\n\n        // Collect commissioning options from commandline parameters\n        const commissioningOptions: CommissioningOptions = {\n            regulatoryLocation: GeneralCommissioning.RegulatoryLocationType.IndoorOutdoor,\n            regulatoryCountryCode: \"XX\",\n        };\n\n        let ble = false;\n        if (hasParameter(\"ble\")) {\n            ble = true;\n            const wifiSsid = getParameter(\"ble-wifi-ssid\");\n            const wifiCredentials = getParameter(\"ble-wifi-credentials\");\n            const threadNetworkName = getParameter(\"ble-thread-networkname\");\n            const threadOperationalDataset = getParameter(\"ble-thread-operationaldataset\");\n            if (wifiSsid !== undefined && wifiCredentials !== undefined) {\n                logger.info(`Registering Commissioning over BLE with WiFi: ${wifiSsid}`);\n                commissioningOptions.wifiNetwork = {\n                    wifiSsid: wifiSsid,\n                    wifiCredentials: wifiCredentials,\n                };\n            }\n            if (threadNetworkName !== undefined && threadOperationalDataset !== undefined) {\n                logger.info(`Registering Commissioning over BLE with Thread: ${threadNetworkName}`);\n                commissioningOptions.threadNetwork = {\n                    networkName: threadNetworkName,\n                    operationalDataset: threadOperationalDataset,\n                };\n            }\n        }\n\n        /**\n         * Create Matter Server and Controller Node\n         *\n         * To allow the device to be announced, found, paired and operated we need a MatterServer instance and add a\n         * CommissioningController to it and add the just created device instance to it.\n         * The Controller node defines the port where the server listens for the UDP packages of the Matter protocol\n         * and initializes deice specific certificates and such.\n         *\n         * The below logic also adds command handlers for commands of clusters that normally are handled internally\n         * like testEventTrigger (General Diagnostic Cluster) that can be implemented with the logic when these commands\n         * are called.\n         */\n\n        const environment = Environment.default;\n        const commissioningController = new CommissioningController({\n            environment: {\n                environment,\n                id: uniqueId,\n            },\n            autoConnect: false,\n        });\n\n        /**\n         * Start the Matter Server\n         *\n         * After everything was plugged together we can start the server. When not delayed announcement is set for the\n         * CommissioningServer node then this command also starts the announcement of the device into the network.\n         */\n        await commissioningController.start();\n\n        if (!commissioningController.isCommissioned()) {\n            const options = {\n                commissioning: commissioningOptions,\n                discovery: {\n                    knownAddress: ip !== undefined && port !== undefined ? { ip, port, type: \"udp\" } : undefined,\n                    identifierData:\n                        longDiscriminator !== undefined\n                            ? { longDiscriminator }\n                            : shortDiscriminator !== undefined\n                              ? { shortDiscriminator }\n                              : {},\n                    discoveryCapabilities: {\n                        ble,\n                    },\n                },\n                passcode: setupPin,\n            } as NodeCommissioningOptions;\n            logger.info(`Commissioning ... ${JSON.stringify(options)}`);\n            const nodeId = await commissioningController.commissionNode(options);\n\n            console.log(`Commissioning successfully done with nodeId ${nodeId}`);\n        }\n\n        /**\n         * TBD\n         */\n        try {\n            const nodes = commissioningController.getCommissionedNodes();\n            console.log(\"Found commissioned nodes:\", Logger.toJSON(nodes));\n\n            const nodeId = NodeId(getIntParameter(\"nodeid\") ?? nodes[0]);\n            if (!nodes.includes(nodeId)) {\n                throw new Error(`Node ${nodeId} not found in commissioned nodes`);\n            }\n\n            const node = await commissioningController.connectNode(nodeId, {\n                attributeChangedCallback: (\n                    peerNodeId,\n                    { path: { nodeId, clusterId, endpointId, attributeName }, value },\n                ) =>\n                    console.log(\n                        `attributeChangedCallback ${peerNodeId}: Attribute ${nodeId}/${endpointId}/${clusterId}/${attributeName} changed to ${Logger.toJSON(\n                            value,\n                        )}`,\n                    ),\n                eventTriggeredCallback: (peerNodeId, { path: { nodeId, clusterId, endpointId, eventName }, events }) =>\n                    console.log(\n                        `eventTriggeredCallback ${peerNodeId}: Event ${nodeId}/${endpointId}/${clusterId}/${eventName} triggered with ${Logger.toJSON(\n                            events,\n                        )}`,\n                    ),\n                stateInformationCallback: (peerNodeId, info) => {\n                    switch (info) {\n                        case NodeStateInformation.Connected:\n                            console.log(`stateInformationCallback ${peerNodeId}: Node ${nodeId} connected`);\n                            break;\n                        case NodeStateInformation.Disconnected:\n                            console.log(`stateInformationCallback ${peerNodeId}: Node ${nodeId} disconnected`);\n                            break;\n                        case NodeStateInformation.Reconnecting:\n                            console.log(`stateInformationCallback ${peerNodeId}: Node ${nodeId} reconnecting`);\n                            break;\n                        case NodeStateInformation.WaitingForDeviceDiscovery:\n                            console.log(\n                                `stateInformationCallback ${peerNodeId}: Node ${nodeId} waiting for device discovery`,\n                            );\n                            break;\n                        case NodeStateInformation.StructureChanged:\n                            console.log(`stateInformationCallback ${peerNodeId}: Node ${nodeId} structure changed`);\n                            break;\n                        case NodeStateInformation.Decommissioned:\n                            console.log(`stateInformationCallback ${peerNodeId}: Node ${nodeId} decommissioned`);\n                            break;\n                    }\n                },\n            });\n\n            // Important: This is a temporary API to proof the methods working and this will change soon and is NOT stable!\n            // It is provided to proof the concept\n\n            node.logStructure();\n\n            // Example to initialize a ClusterClient and access concrete fields as API methods\n            const descriptor = node.getRootClusterClient(DescriptorCluster);\n            if (descriptor !== undefined) {\n                console.log(await descriptor.attributes.deviceTypeList.get()); // you can call that way\n                console.log(await descriptor.getServerListAttribute()); // or more convenient that way\n            } else {\n                console.log(\"No Descriptor Cluster found. This should never happen!\");\n            }\n\n            // Example to subscribe to a field and get the value\n            const info = node.getRootClusterClient(BasicInformationCluster);\n            if (info !== undefined) {\n                console.log(await info.getProductNameAttribute()); // This call is executed remotely\n                //console.log(await info.subscribeProductNameAttribute(value => console.log(\"productName\", value), 5, 30));\n                //console.log(await info.getProductNameAttribute()); // This call is resolved locally because we have subscribed to the value!\n            } else {\n                console.log(\"No BasicInformation Cluster found. This should never happen!\");\n            }\n\n            // Example to get all Attributes of the commissioned node: */*/*\n            //const attributesAll = await interactionClient.getAllAttributes();\n            //console.log(\"Attributes-All:\", Logger.toJSON(attributesAll));\n\n            // Example to get all Attributes of all Descriptor Clusters of the commissioned node: */DescriptorCluster/*\n            //const attributesAllDescriptor = await interactionClient.getMultipleAttributes([{ clusterId: DescriptorCluster.id} ]);\n            //console.log(\"Attributes-Descriptor:\", JSON.stringify(attributesAllDescriptor, null, 2));\n\n            // Example to get all Attributes of the Basic Information Cluster of endpoint 0 of the commissioned node: 0/BasicInformationCluster/*\n            //const attributesBasicInformation = await interactionClient.getMultipleAttributes([{ endpointId: 0, clusterId: BasicInformationCluster.id} ]);\n            //console.log(\"Attributes-BasicInformation:\", JSON.stringify(attributesBasicInformation, null, 2));\n\n            const devices = node.getDevices();\n            if (devices[0] && devices[0].number === 1) {\n                // Example to subscribe to all Attributes of endpoint 1 of the commissioned node: */*/*\n                //await interactionClient.subscribeMultipleAttributes([{ endpointId: 1, /* subscribe anything from endpoint 1 */ }], 0, 180, data => {\n                //    console.log(\"Subscribe-All Data:\", Logger.toJSON(data));\n                //});\n\n                const onOff = devices[0].getClusterClient(OnOffCluster);\n                if (onOff !== undefined) {\n                    let onOffStatus = await onOff.getOnOffAttribute();\n                    console.log(\"initial onOffStatus\", onOffStatus);\n\n                    onOff.addOnOffAttributeListener(value => {\n                        console.log(\"subscription onOffStatus\", value);\n                        onOffStatus = value;\n                    });\n                    // read data every minute to keep up the connection to show the subscription is working\n                    setInterval(() => {\n                        onOff\n                            .toggle()\n                            .then(() => {\n                                onOffStatus = !onOffStatus;\n                                console.log(\"onOffStatus\", onOffStatus);\n                            })\n                            .catch(error => logger.error(error));\n                    }, 60000);\n                }\n            }\n        } finally {\n            //await matterServer.close(); // Comment out when subscribes are used, else the connection will be closed\n            setTimeout(() => process.exit(0), 1000000);\n        }\n    }\n}\n\nnew ControllerNode().start().catch(error => logger.error(error));\n\nprocess.on(\"SIGINT\", () => {\n    // Clean up on CTRL-C\n    // Pragmatic way to make sure the storage is correctly closed before the process ends.\n    storage\n        .close()\n        .then(() => process.exit(0))\n        .catch(() => process.exit(1));\n});\n"],
-  "mappings": "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",
+  "sourcesContent": ["#!/usr/bin/env node\n\n/**\n * @license\n * Copyright 2022-2024 Matter.js Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\n/**\n * This example shows how to create a Matter controller to pair with a device and interfact with it.\n * It can be used as CLI script, but is more thought as a starting point for your own controller implementation\n * because you need to adjust the code in any way depending on your use case.\n */\n\n/**\n * Import needed modules from @project-chip/matter-node.js\n */\n// Include this first to auto-register Crypto, Network and Time Node.js implementations\n// Include this first to auto-register Crypto, Network and Time Node.js implementations\nimport \"@project-chip/matter-node.js\";\n\nimport { BleNode } from \"@project-chip/matter-node-ble.js/ble\";\nimport { requireMinNodeVersion } from \"@project-chip/matter-node.js/util\";\nimport { CommissioningController, NodeCommissioningOptions } from \"@project-chip/matter.js\";\nimport { Ble } from \"@project-chip/matter.js/ble\";\nimport {\n    BasicInformationCluster,\n    DescriptorCluster,\n    GeneralCommissioning,\n    OnOffCluster,\n} from \"@project-chip/matter.js/cluster\";\nimport { NodeId } from \"@project-chip/matter.js/datatype\";\nimport { NodeStateInformation } from \"@project-chip/matter.js/device\";\nimport { Environment, StorageService } from \"@project-chip/matter.js/environment\";\nimport { Logger } from \"@project-chip/matter.js/log\";\nimport { CommissioningOptions } from \"@project-chip/matter.js/protocol\";\nimport { ManualPairingCodeCodec } from \"@project-chip/matter.js/schema\";\nimport { Time } from \"@project-chip/matter.js/time\";\nimport { singleton } from \"@project-chip/matter.js/util\";\n\nconst logger = Logger.get(\"Controller\");\n\nrequireMinNodeVersion(16);\n\nconst environment = Environment.default;\n\nif (environment.vars.get(\"ble\")) {\n    // Initialize Ble\n    Ble.get = singleton(\n        () =>\n            new BleNode({\n                hciId: environment.vars.number(\"ble-hci-id\"),\n            }),\n    );\n}\n\nconst storageService = environment.get(StorageService);\n\nconsole.log(`Storage location: ${storageService.location} (Directory)`);\nlogger.info(\n    'Use the parameter \"--storage-path=NAME-OR-PATH\" to specify a different storage location in this directory, use --storage-clear to start with an empty storage.',\n);\n\nclass ControllerNode {\n    async start() {\n        logger.info(`node-matter Controller started`);\n\n        /**\n         * Collect all needed data\n         *\n         * This block makes sure to collect all needed data from cli or storage. Replace this with where ever your data\n         * come from.\n         *\n         * Note: This example also uses the initialized storage system to store the device parameter data for convenience\n         * and easy reuse. When you also do that be careful to not overlap with Matter-Server own contexts\n         * (so maybe better not ;-)).\n         */\n\n        const controllerStorage = (await storageService.open(\"controller\")).createContext(\"data\");\n        const ip = controllerStorage.has(\"ip\") ? controllerStorage.get<string>(\"ip\") : environment.vars.string(\"ip\");\n        const port = controllerStorage.has(\"port\")\n            ? controllerStorage.get<number>(\"port\")\n            : environment.vars.number(\"port\");\n        const uniqueId = controllerStorage.has(\"uniqueid\")\n            ? controllerStorage.get<string>(\"uniqueid\")\n            : environment.vars.string(\"uniqueid\") ?? Time.nowMs().toString();\n        controllerStorage.set(\"uniqueid\", uniqueId);\n\n        const pairingCode = environment.vars.string(\"pairingcode\");\n        let longDiscriminator, setupPin, shortDiscriminator;\n        if (pairingCode !== undefined) {\n            const pairingCodeCodec = ManualPairingCodeCodec.decode(pairingCode);\n            shortDiscriminator = pairingCodeCodec.shortDiscriminator;\n            longDiscriminator = undefined;\n            setupPin = pairingCodeCodec.passcode;\n            logger.debug(`Data extracted from pairing code: ${Logger.toJSON(pairingCodeCodec)}`);\n        } else {\n            longDiscriminator =\n                environment.vars.number(\"longDiscriminator\") ?? controllerStorage.get(\"longDiscriminator\", 3840);\n            if (longDiscriminator > 4095) throw new Error(\"Discriminator value must be less than 4096\");\n            setupPin = environment.vars.number(\"pin\") ?? controllerStorage.get(\"pin\", 20202021);\n        }\n        if ((shortDiscriminator === undefined && longDiscriminator === undefined) || setupPin === undefined) {\n            throw new Error(\n                \"Please specify the longDiscriminator of the device to commission with -longDiscriminator or provide a valid passcode with -passcode\",\n            );\n        }\n\n        // Collect commissioning options from commandline parameters\n        const commissioningOptions: CommissioningOptions = {\n            regulatoryLocation: GeneralCommissioning.RegulatoryLocationType.IndoorOutdoor,\n            regulatoryCountryCode: \"XX\",\n        };\n\n        let ble = false;\n        if (environment.vars.get(\"ble\")) {\n            ble = true;\n            const wifiSsid = environment.vars.string(\"ble-wifi-ssid\");\n            const wifiCredentials = environment.vars.string(\"ble-wifi-credentials\");\n            const threadNetworkName = environment.vars.string(\"ble-thread-networkname\");\n            const threadOperationalDataset = environment.vars.string(\"ble-thread-operationaldataset\");\n            if (wifiSsid !== undefined && wifiCredentials !== undefined) {\n                logger.info(`Registering Commissioning over BLE with WiFi: ${wifiSsid}`);\n                commissioningOptions.wifiNetwork = {\n                    wifiSsid: wifiSsid,\n                    wifiCredentials: wifiCredentials,\n                };\n            }\n            if (threadNetworkName !== undefined && threadOperationalDataset !== undefined) {\n                logger.info(`Registering Commissioning over BLE with Thread: ${threadNetworkName}`);\n                commissioningOptions.threadNetwork = {\n                    networkName: threadNetworkName,\n                    operationalDataset: threadOperationalDataset,\n                };\n            }\n        }\n\n        /**\n         * Create Matter Server and Controller Node\n         *\n         * To allow the device to be announced, found, paired and operated we need a MatterServer instance and add a\n         * CommissioningController to it and add the just created device instance to it.\n         * The Controller node defines the port where the server listens for the UDP packages of the Matter protocol\n         * and initializes deice specific certificates and such.\n         *\n         * The below logic also adds command handlers for commands of clusters that normally are handled internally\n         * like testEventTrigger (General Diagnostic Cluster) that can be implemented with the logic when these commands\n         * are called.\n         */\n\n        const commissioningController = new CommissioningController({\n            environment: {\n                environment,\n                id: uniqueId,\n            },\n            autoConnect: false,\n        });\n\n        /**\n         * Start the Matter Server\n         *\n         * After everything was plugged together we can start the server. When not delayed announcement is set for the\n         * CommissioningServer node then this command also starts the announcement of the device into the network.\n         */\n        await commissioningController.start();\n\n        if (!commissioningController.isCommissioned()) {\n            const options = {\n                commissioning: commissioningOptions,\n                discovery: {\n                    knownAddress: ip !== undefined && port !== undefined ? { ip, port, type: \"udp\" } : undefined,\n                    identifierData:\n                        longDiscriminator !== undefined\n                            ? { longDiscriminator }\n                            : shortDiscriminator !== undefined\n                              ? { shortDiscriminator }\n                              : {},\n                    discoveryCapabilities: {\n                        ble,\n                    },\n                },\n                passcode: setupPin,\n            } as NodeCommissioningOptions;\n            logger.info(`Commissioning ... ${JSON.stringify(options)}`);\n            const nodeId = await commissioningController.commissionNode(options);\n\n            console.log(`Commissioning successfully done with nodeId ${nodeId}`);\n        }\n\n        /**\n         * TBD\n         */\n        try {\n            const nodes = commissioningController.getCommissionedNodes();\n            console.log(\"Found commissioned nodes:\", Logger.toJSON(nodes));\n\n            const nodeId = NodeId(environment.vars.number(\"nodeid\") ?? nodes[0]);\n            if (!nodes.includes(nodeId)) {\n                throw new Error(`Node ${nodeId} not found in commissioned nodes`);\n            }\n\n            const node = await commissioningController.connectNode(nodeId, {\n                attributeChangedCallback: (\n                    peerNodeId,\n                    { path: { nodeId, clusterId, endpointId, attributeName }, value },\n                ) =>\n                    console.log(\n                        `attributeChangedCallback ${peerNodeId}: Attribute ${nodeId}/${endpointId}/${clusterId}/${attributeName} changed to ${Logger.toJSON(\n                            value,\n                        )}`,\n                    ),\n                eventTriggeredCallback: (peerNodeId, { path: { nodeId, clusterId, endpointId, eventName }, events }) =>\n                    console.log(\n                        `eventTriggeredCallback ${peerNodeId}: Event ${nodeId}/${endpointId}/${clusterId}/${eventName} triggered with ${Logger.toJSON(\n                            events,\n                        )}`,\n                    ),\n                stateInformationCallback: (peerNodeId, info) => {\n                    switch (info) {\n                        case NodeStateInformation.Connected:\n                            console.log(`stateInformationCallback ${peerNodeId}: Node ${nodeId} connected`);\n                            break;\n                        case NodeStateInformation.Disconnected:\n                            console.log(`stateInformationCallback ${peerNodeId}: Node ${nodeId} disconnected`);\n                            break;\n                        case NodeStateInformation.Reconnecting:\n                            console.log(`stateInformationCallback ${peerNodeId}: Node ${nodeId} reconnecting`);\n                            break;\n                        case NodeStateInformation.WaitingForDeviceDiscovery:\n                            console.log(\n                                `stateInformationCallback ${peerNodeId}: Node ${nodeId} waiting for device discovery`,\n                            );\n                            break;\n                        case NodeStateInformation.StructureChanged:\n                            console.log(`stateInformationCallback ${peerNodeId}: Node ${nodeId} structure changed`);\n                            break;\n                        case NodeStateInformation.Decommissioned:\n                            console.log(`stateInformationCallback ${peerNodeId}: Node ${nodeId} decommissioned`);\n                            break;\n                    }\n                },\n            });\n\n            // Important: This is a temporary API to proof the methods working and this will change soon and is NOT stable!\n            // It is provided to proof the concept\n\n            node.logStructure();\n\n            // Example to initialize a ClusterClient and access concrete fields as API methods\n            const descriptor = node.getRootClusterClient(DescriptorCluster);\n            if (descriptor !== undefined) {\n                console.log(await descriptor.attributes.deviceTypeList.get()); // you can call that way\n                console.log(await descriptor.getServerListAttribute()); // or more convenient that way\n            } else {\n                console.log(\"No Descriptor Cluster found. This should never happen!\");\n            }\n\n            // Example to subscribe to a field and get the value\n            const info = node.getRootClusterClient(BasicInformationCluster);\n            if (info !== undefined) {\n                console.log(await info.getProductNameAttribute()); // This call is executed remotely\n                //console.log(await info.subscribeProductNameAttribute(value => console.log(\"productName\", value), 5, 30));\n                //console.log(await info.getProductNameAttribute()); // This call is resolved locally because we have subscribed to the value!\n            } else {\n                console.log(\"No BasicInformation Cluster found. This should never happen!\");\n            }\n\n            // Example to get all Attributes of the commissioned node: */*/*\n            //const attributesAll = await interactionClient.getAllAttributes();\n            //console.log(\"Attributes-All:\", Logger.toJSON(attributesAll));\n\n            // Example to get all Attributes of all Descriptor Clusters of the commissioned node: */DescriptorCluster/*\n            //const attributesAllDescriptor = await interactionClient.getMultipleAttributes([{ clusterId: DescriptorCluster.id} ]);\n            //console.log(\"Attributes-Descriptor:\", JSON.stringify(attributesAllDescriptor, null, 2));\n\n            // Example to get all Attributes of the Basic Information Cluster of endpoint 0 of the commissioned node: 0/BasicInformationCluster/*\n            //const attributesBasicInformation = await interactionClient.getMultipleAttributes([{ endpointId: 0, clusterId: BasicInformationCluster.id} ]);\n            //console.log(\"Attributes-BasicInformation:\", JSON.stringify(attributesBasicInformation, null, 2));\n\n            const devices = node.getDevices();\n            if (devices[0] && devices[0].number === 1) {\n                // Example to subscribe to all Attributes of endpoint 1 of the commissioned node: */*/*\n                //await interactionClient.subscribeMultipleAttributes([{ endpointId: 1, /* subscribe anything from endpoint 1 */ }], 0, 180, data => {\n                //    console.log(\"Subscribe-All Data:\", Logger.toJSON(data));\n                //});\n\n                const onOff = devices[0].getClusterClient(OnOffCluster);\n                if (onOff !== undefined) {\n                    let onOffStatus = await onOff.getOnOffAttribute();\n                    console.log(\"initial onOffStatus\", onOffStatus);\n\n                    onOff.addOnOffAttributeListener(value => {\n                        console.log(\"subscription onOffStatus\", value);\n                        onOffStatus = value;\n                    });\n                    // read data every minute to keep up the connection to show the subscription is working\n                    setInterval(() => {\n                        onOff\n                            .toggle()\n                            .then(() => {\n                                onOffStatus = !onOffStatus;\n                                console.log(\"onOffStatus\", onOffStatus);\n                            })\n                            .catch(error => logger.error(error));\n                    }, 60000);\n                }\n            }\n        } finally {\n            //await matterServer.close(); // Comment out when subscribes are used, else the connection will be closed\n            setTimeout(() => process.exit(0), 1000000);\n        }\n    }\n}\n\nnew ControllerNode().start().catch(error => logger.error(error));\n"],
+  "mappings": "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",
   "names": ["nodeId", "info"]
 }

package/dist/esm/examples/DeviceNode.js

@@ -107,7 +107,7 @@ async function getConfiguration() {
   const productName = `node-matter OnOff ${isSocket ? "Socket" : "Light"}`;
   const productId = environment.vars.number("productid") ?? deviceStorage.get("productid", 32768);
   const port = environment.vars.number("port") ?? 5540;
-  const uniqueId = environment.vars.string("uniqueid") ?? deviceStorage.get("uniqueid", Time.nowMs().toString());
+  const uniqueId = environment.vars.string("uniqueid") ?? deviceStorage.get("uniqueid", Time.nowMs()).toString();
   deviceStorage.set("passcode", passcode);
   deviceStorage.set("discriminator", discriminator);
   deviceStorage.set("vendorid", vendorId);

package/dist/esm/examples/DeviceNode.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/examples/DeviceNode.ts"],
-  "sourcesContent": ["/**\n * @license\n * Copyright 2022-2024 Matter.js Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\n/**\n * This example shows how to create a simple on-off Matter device as a light or as a socket.\n * It can be used as CLI script and starting point for your own device node implementation.\n * This example is CJS conform and do not use top level await's.\n */\n\n/**\n * Import needed modules from @project-chip/matter-node.js\n */\n// Include this first to auto-register Crypto, Network and Time Node.js implementations\nimport \"@project-chip/matter-node.js\";\n\nimport { requireMinNodeVersion } from \"@project-chip/matter-node.js/util\";\nimport { DeviceTypeId, VendorId } from \"@project-chip/matter.js/datatype\";\nimport { logEndpoint } from \"@project-chip/matter.js/device\";\nimport { OnOffLightDevice } from \"@project-chip/matter.js/devices/OnOffLightDevice\";\nimport { OnOffPlugInUnitDevice } from \"@project-chip/matter.js/devices/OnOffPlugInUnitDevice\";\nimport { Endpoint, EndpointServer } from \"@project-chip/matter.js/endpoint\";\nimport { Environment, StorageService } from \"@project-chip/matter.js/environment\";\nimport { ServerNode } from \"@project-chip/matter.js/node\";\nimport { Time } from \"@project-chip/matter.js/time\";\nimport { execSync } from \"child_process\";\n\nrequireMinNodeVersion(16);\n\nasync function main() {\n    /** Initialize configuration values */\n    const {\n        isSocket,\n        deviceName,\n        vendorName,\n        passcode,\n        discriminator,\n        vendorId,\n        productName,\n        productId,\n        port,\n        uniqueId,\n    } = await getConfiguration();\n\n    /**\n     * Create a Matter ServerNode, which contains the Root Endpoint and all relevant data and configuration\n     */\n    const server = await ServerNode.create({\n        // Required: Give the Node a unique ID which is used to store the state of this node\n        id: uniqueId,\n\n        // Provide Network relevant configuration like the port\n        // Optional when operating only one device on a host, Default port is 5540\n        network: {\n            port,\n        },\n\n        // Provide Commissioning relevant settings\n        // Optional for development/testing purposes\n        commissioning: {\n            passcode,\n            discriminator,\n        },\n\n        // Provide Node announcement settings\n        // Optional: If Ommitted some development defaults are used\n        productDescription: {\n            name: deviceName,\n            deviceType: DeviceTypeId(isSocket ? OnOffPlugInUnitDevice.deviceType : OnOffLightDevice.deviceType),\n        },\n\n        // Provide defaults for the BasicInformation cluster on the Root endpoint\n        // Optional: If Omitted some development defaults are used\n        basicInformation: {\n            vendorName,\n            vendorId: VendorId(vendorId),\n            nodeLabel: productName,\n            productName,\n            productLabel: productName,\n            productId,\n            serialNumber: `matterjs-${uniqueId}`,\n            uniqueId,\n        },\n    });\n\n    /**\n     * Matter Nodes are a composition of endpoints. Create and add a single endpoint to the node. This example uses the\n     * OnOffLightDevice or OnOffPlugInUnitDevice depending on the value of the type parameter. It also assigns this Part a\n     * unique ID to store the endpoint number for it in the storage to restore the device on restart.\n     * In this case we directly use the default command implementation from matter.js. Check out the DeviceNodeFull example\n     * to see how to customize the command handlers.\n     */\n    const endpoint = new Endpoint(isSocket ? OnOffPlugInUnitDevice : OnOffLightDevice, { id: \"onoff\" });\n    await server.add(endpoint);\n\n    /**\n     * Register state change handlers of the node for identify and onoff states to react to the commands.\n     * If the code in these change handlers fail then the change is also rolled back and not executed and an error is\n     * reported back to the controller.\n     */\n    let isIdentifying = false;\n    endpoint.events.identify.identifyTime$Change.on(value => {\n        // identifyTime is set when an identify command is called and then decreased every second while indentify logic runs.\n        if (value > 0 && !isIdentifying) {\n            isIdentifying = true;\n            console.log(`Run identify logic, ideally blink a light every 0.5s ...`);\n        } else if (value === 0) {\n            isIdentifying = false;\n            console.log(`Stop identify logic ...`);\n        }\n    });\n\n    endpoint.events.onOff.onOff$Change.on(value => {\n        executeCommand(value ? \"on\" : \"off\");\n        console.log(`OnOff is now ${value ? \"ON\" : \"OFF\"}`);\n    });\n\n    /**\n     * Log the endpoint structure for debugging reasons and to allow to verify anything is correct\n     */\n    logEndpoint(EndpointServer.forEndpoint(server));\n\n    /**\n     * In order to start the node and announce it into the network we use the run method which resolves when the node goes\n     * offline again because we do not need anything more here. See the Full example for other starting options.\n     * The QR Code is printed automatically.\n     */\n    await server.run();\n}\n\nmain().catch(error => console.error(error));\n\n/*********************************************************************************************************\n * Convenience Methods\n *********************************************************************************************************/\n\n/** Defined a shell command from an environment variable and execute it and log the response. */\nfunction executeCommand(scriptParamName: string) {\n    const script = Environment.default.vars.string(scriptParamName);\n    if (script === undefined) return undefined;\n    console.log(`${scriptParamName}: ${execSync(script).toString().slice(0, -1)}`);\n}\n\nasync function getConfiguration() {\n    /**\n     * Collect all needed data\n     *\n     * This block collects all needed data from cli, environment or storage. Replace this with where ever your data come from.\n     *\n     * Note: This example uses the matter.js process storage system to store the device parameter data for convenience\n     * and easy reuse. When you also do that be careful to not overlap with Matter-Server own storage contexts\n     * (so maybe better not do it ;-)).\n     */\n    const environment = Environment.default;\n\n    const storageService = environment.get(StorageService);\n    console.log(`Storage location: ${storageService.location} (Directory)`);\n    console.log(\n        'Use the parameter \"--storage-path=NAME-OR-PATH\" to specify a different storage location in this directory, use --storage-clear to start with an empty storage.',\n    );\n    const deviceStorage = (await storageService.open(\"device\")).createContext(\"data\");\n\n    const isSocket = deviceStorage.get(\"isSocket\", environment.vars.get(\"type\") === \"socket\");\n    if (deviceStorage.has(\"isSocket\")) {\n        console.log(`Device type ${isSocket ? \"socket\" : \"light\"} found in storage. --type parameter is ignored.`);\n    }\n    const deviceName = \"Matter test device\";\n    const vendorName = \"matter-node.js\";\n    const passcode = environment.vars.number(\"passcode\") ?? deviceStorage.get(\"passcode\", 20202021);\n    const discriminator = environment.vars.number(\"discriminator\") ?? deviceStorage.get(\"discriminator\", 3840);\n    // product name / id and vendor id should match what is in the device certificate\n    const vendorId = environment.vars.number(\"vendorid\") ?? deviceStorage.get(\"vendorid\", 0xfff1);\n    const productName = `node-matter OnOff ${isSocket ? \"Socket\" : \"Light\"}`;\n    const productId = environment.vars.number(\"productid\") ?? deviceStorage.get(\"productid\", 0x8000);\n\n    const port = environment.vars.number(\"port\") ?? 5540;\n\n    const uniqueId = environment.vars.string(\"uniqueid\") ?? deviceStorage.get(\"uniqueid\", Time.nowMs().toString());\n\n    // Persist basic data to keep them also on restart\n    deviceStorage.set(\"passcode\", passcode);\n    deviceStorage.set(\"discriminator\", discriminator);\n    deviceStorage.set(\"vendorid\", vendorId);\n    deviceStorage.set(\"productid\", productId);\n    deviceStorage.set(\"isSocket\", isSocket);\n    deviceStorage.set(\"uniqueid\", uniqueId);\n\n    return {\n        isSocket,\n        deviceName,\n        vendorName,\n        passcode,\n        discriminator,\n        vendorId,\n        productName,\n        productId,\n        port,\n        uniqueId,\n    };\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * @license\n * Copyright 2022-2024 Matter.js Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\n/**\n * This example shows how to create a simple on-off Matter device as a light or as a socket.\n * It can be used as CLI script and starting point for your own device node implementation.\n * This example is CJS conform and do not use top level await's.\n */\n\n/**\n * Import needed modules from @project-chip/matter-node.js\n */\n// Include this first to auto-register Crypto, Network and Time Node.js implementations\nimport \"@project-chip/matter-node.js\";\n\nimport { requireMinNodeVersion } from \"@project-chip/matter-node.js/util\";\nimport { DeviceTypeId, VendorId } from \"@project-chip/matter.js/datatype\";\nimport { logEndpoint } from \"@project-chip/matter.js/device\";\nimport { OnOffLightDevice } from \"@project-chip/matter.js/devices/OnOffLightDevice\";\nimport { OnOffPlugInUnitDevice } from \"@project-chip/matter.js/devices/OnOffPlugInUnitDevice\";\nimport { Endpoint, EndpointServer } from \"@project-chip/matter.js/endpoint\";\nimport { Environment, StorageService } from \"@project-chip/matter.js/environment\";\nimport { ServerNode } from \"@project-chip/matter.js/node\";\nimport { Time } from \"@project-chip/matter.js/time\";\nimport { execSync } from \"child_process\";\n\nrequireMinNodeVersion(16);\n\nasync function main() {\n    /** Initialize configuration values */\n    const {\n        isSocket,\n        deviceName,\n        vendorName,\n        passcode,\n        discriminator,\n        vendorId,\n        productName,\n        productId,\n        port,\n        uniqueId,\n    } = await getConfiguration();\n\n    /**\n     * Create a Matter ServerNode, which contains the Root Endpoint and all relevant data and configuration\n     */\n    const server = await ServerNode.create({\n        // Required: Give the Node a unique ID which is used to store the state of this node\n        id: uniqueId,\n\n        // Provide Network relevant configuration like the port\n        // Optional when operating only one device on a host, Default port is 5540\n        network: {\n            port,\n        },\n\n        // Provide Commissioning relevant settings\n        // Optional for development/testing purposes\n        commissioning: {\n            passcode,\n            discriminator,\n        },\n\n        // Provide Node announcement settings\n        // Optional: If Ommitted some development defaults are used\n        productDescription: {\n            name: deviceName,\n            deviceType: DeviceTypeId(isSocket ? OnOffPlugInUnitDevice.deviceType : OnOffLightDevice.deviceType),\n        },\n\n        // Provide defaults for the BasicInformation cluster on the Root endpoint\n        // Optional: If Omitted some development defaults are used\n        basicInformation: {\n            vendorName,\n            vendorId: VendorId(vendorId),\n            nodeLabel: productName,\n            productName,\n            productLabel: productName,\n            productId,\n            serialNumber: `matterjs-${uniqueId}`,\n            uniqueId,\n        },\n    });\n\n    /**\n     * Matter Nodes are a composition of endpoints. Create and add a single endpoint to the node. This example uses the\n     * OnOffLightDevice or OnOffPlugInUnitDevice depending on the value of the type parameter. It also assigns this Part a\n     * unique ID to store the endpoint number for it in the storage to restore the device on restart.\n     * In this case we directly use the default command implementation from matter.js. Check out the DeviceNodeFull example\n     * to see how to customize the command handlers.\n     */\n    const endpoint = new Endpoint(isSocket ? OnOffPlugInUnitDevice : OnOffLightDevice, { id: \"onoff\" });\n    await server.add(endpoint);\n\n    /**\n     * Register state change handlers of the node for identify and onoff states to react to the commands.\n     * If the code in these change handlers fail then the change is also rolled back and not executed and an error is\n     * reported back to the controller.\n     */\n    let isIdentifying = false;\n    endpoint.events.identify.identifyTime$Change.on(value => {\n        // identifyTime is set when an identify command is called and then decreased every second while indentify logic runs.\n        if (value > 0 && !isIdentifying) {\n            isIdentifying = true;\n            console.log(`Run identify logic, ideally blink a light every 0.5s ...`);\n        } else if (value === 0) {\n            isIdentifying = false;\n            console.log(`Stop identify logic ...`);\n        }\n    });\n\n    endpoint.events.onOff.onOff$Change.on(value => {\n        executeCommand(value ? \"on\" : \"off\");\n        console.log(`OnOff is now ${value ? \"ON\" : \"OFF\"}`);\n    });\n\n    /**\n     * Log the endpoint structure for debugging reasons and to allow to verify anything is correct\n     */\n    logEndpoint(EndpointServer.forEndpoint(server));\n\n    /**\n     * In order to start the node and announce it into the network we use the run method which resolves when the node goes\n     * offline again because we do not need anything more here. See the Full example for other starting options.\n     * The QR Code is printed automatically.\n     */\n    await server.run();\n}\n\nmain().catch(error => console.error(error));\n\n/*********************************************************************************************************\n * Convenience Methods\n *********************************************************************************************************/\n\n/** Defined a shell command from an environment variable and execute it and log the response. */\nfunction executeCommand(scriptParamName: string) {\n    const script = Environment.default.vars.string(scriptParamName);\n    if (script === undefined) return undefined;\n    console.log(`${scriptParamName}: ${execSync(script).toString().slice(0, -1)}`);\n}\n\nasync function getConfiguration() {\n    /**\n     * Collect all needed data\n     *\n     * This block collects all needed data from cli, environment or storage. Replace this with where ever your data come from.\n     *\n     * Note: This example uses the matter.js process storage system to store the device parameter data for convenience\n     * and easy reuse. When you also do that be careful to not overlap with Matter-Server own storage contexts\n     * (so maybe better not do it ;-)).\n     */\n    const environment = Environment.default;\n\n    const storageService = environment.get(StorageService);\n    console.log(`Storage location: ${storageService.location} (Directory)`);\n    console.log(\n        'Use the parameter \"--storage-path=NAME-OR-PATH\" to specify a different storage location in this directory, use --storage-clear to start with an empty storage.',\n    );\n    const deviceStorage = (await storageService.open(\"device\")).createContext(\"data\");\n\n    const isSocket = deviceStorage.get(\"isSocket\", environment.vars.get(\"type\") === \"socket\");\n    if (deviceStorage.has(\"isSocket\")) {\n        console.log(`Device type ${isSocket ? \"socket\" : \"light\"} found in storage. --type parameter is ignored.`);\n    }\n    const deviceName = \"Matter test device\";\n    const vendorName = \"matter-node.js\";\n    const passcode = environment.vars.number(\"passcode\") ?? deviceStorage.get(\"passcode\", 20202021);\n    const discriminator = environment.vars.number(\"discriminator\") ?? deviceStorage.get(\"discriminator\", 3840);\n    // product name / id and vendor id should match what is in the device certificate\n    const vendorId = environment.vars.number(\"vendorid\") ?? deviceStorage.get(\"vendorid\", 0xfff1);\n    const productName = `node-matter OnOff ${isSocket ? \"Socket\" : \"Light\"}`;\n    const productId = environment.vars.number(\"productid\") ?? deviceStorage.get(\"productid\", 0x8000);\n\n    const port = environment.vars.number(\"port\") ?? 5540;\n\n    const uniqueId = environment.vars.string(\"uniqueid\") ?? deviceStorage.get(\"uniqueid\", Time.nowMs()).toString();\n\n    // Persist basic data to keep them also on restart\n    deviceStorage.set(\"passcode\", passcode);\n    deviceStorage.set(\"discriminator\", discriminator);\n    deviceStorage.set(\"vendorid\", vendorId);\n    deviceStorage.set(\"productid\", productId);\n    deviceStorage.set(\"isSocket\", isSocket);\n    deviceStorage.set(\"uniqueid\", uniqueId);\n\n    return {\n        isSocket,\n        deviceName,\n        vendorName,\n        passcode,\n        discriminator,\n        vendorId,\n        productName,\n        productId,\n        port,\n        uniqueId,\n    };\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/esm/examples/LegacyStorageConverter.js

@@ -0,0 +1,114 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import "@project-chip/matter-node.js";
+import { StorageBackendDisk } from "@project-chip/matter-node.js/storage";
+import { Environment, StorageService } from "@project-chip/matter.js/environment";
+import { Time } from "@project-chip/matter.js/time";
+import { LocalStorage } from "node-localstorage";
+const environment = Environment.default;
+const legacyStoragePath = environment.vars.string("legacy.storage.path");
+const newStoragePath = environment.vars.string("storage.path");
+if (!legacyStoragePath || !newStoragePath) {
+  console.error("Usage: node LegacyStorageConverter.js --legacy-storage-path=<path> --storage-path=<path>");
+  process.exit(1);
+}
+const legacyLocalStorage = new LocalStorage(legacyStoragePath);
+const legacyNodes = new Array();
+Object.keys(legacyLocalStorage).forEach((key) => {
+  const firstLevel = key.split(".")[0];
+  if (!legacyNodes.includes(firstLevel)) {
+    legacyNodes.push(firstLevel);
+  }
+});
+const storageService = environment.get(StorageService);
+const legacyStorage = new StorageBackendDisk(legacyStoragePath);
+await legacyStorage.initialize();
+const uniqueIds = {};
+if (legacyNodes.includes("Device")) {
+  console.log("Example Device found ...");
+  legacyNodes.splice(legacyNodes.indexOf("Device"), 1);
+  const newDeviceStorage = (await storageService.open("device")).createContext("data");
+  legacyStorage.keys(["Device"]).forEach((key) => {
+    console.log("Migrate Device.", key);
+    const value = legacyStorage.get(["Device"], key);
+    newDeviceStorage.set(key, value);
+    if (key === "uniqueid") {
+      uniqueIds["0"] = String(value);
+      newDeviceStorage.set(key, String(value));
+    } else if (key.startsWith("uniqueid")) {
+      const id = parseInt(key.substring(8));
+      uniqueIds[id - 1] = String(value);
+      newDeviceStorage.set(key, String(value));
+    }
+  });
+}
+if (legacyNodes.includes("Controller")) {
+  console.log("Example Controller found ...");
+  legacyNodes.splice(legacyNodes.indexOf("Controller"), 1);
+  const newControllerStorage = (await storageService.open("controller")).createContext("data");
+  legacyStorage.keys(["Controller"]).forEach((key) => {
+    console.log("Migrate Controller.", key);
+    const value = legacyStorage.get(["Controller"], key);
+    newControllerStorage.set(key, value);
+    if (key === "uniqueid") {
+      uniqueIds["0"] = String(value);
+      newControllerStorage.set(key, String(value));
+    }
+  });
+}
+console.log(uniqueIds);
+if (!Object.keys(uniqueIds).length) {
+  console.error("No uniqueId(s) found in legacy storage. Can not convert the node storage.");
+  process.exit(1);
+}
+for (const nodeId of legacyNodes) {
+  if (!uniqueIds[nodeId]) {
+    const rootCertId = legacyStorage.get(["0", "RootCertificateManager"], "rootCertId");
+    if (nodeId !== "0" || rootCertId === void 0) {
+      console.error(`No uniqueId found for node ${nodeId}. Can not convert the node storage.`);
+      continue;
+    }
+    const newControllerStorage = (await storageService.open("controller")).createContext("data");
+    const uniqueId = Time.nowMs().toString();
+    newControllerStorage.set("uniqueid", uniqueId);
+    const newNodeStorage = await storageService.open(uniqueId);
+    const credentialsStorage = newNodeStorage.createContext("credentials");
+    credentialsStorage.set("rootCertId", rootCertId);
+    credentialsStorage.set(
+      "nextCertificateId",
+      legacyStorage.get(["0", "RootCertificateManager"], "nextCertificateId")
+    );
+    credentialsStorage.set("rootCertBytes", legacyStorage.get(["0", "RootCertificateManager"], "rootCertBytes"));
+    credentialsStorage.set(
+      "rootKeyIdentifier",
+      legacyStorage.get(["0", "RootCertificateManager"], "rootKeyIdentifier")
+    );
+    credentialsStorage.set("rootKeyPair", legacyStorage.get(["0", "RootCertificateManager"], "rootKeyPair"));
+    credentialsStorage.set("fabric", legacyStorage.get(["0", "MatterController"], "fabric"));
+    const sessionsStorage = newNodeStorage.createContext("sessions");
+    sessionsStorage.set("resumptionRecords", legacyStorage.get([nodeId, "SessionManager"], "resumptionRecords"));
+    const nodesStorage = newNodeStorage.createContext("nodes");
+    nodesStorage.set("resumptionRecords", legacyStorage.get([nodeId, "MatterController"], "commissionedNodes"));
+    console.log(`Controller Node ${nodeId} with new unique id ${uniqueId} migrated successfully.`);
+  } else {
+    const newNodeStorage = await storageService.open(uniqueIds[nodeId]);
+    const nextEndpointNumber = legacyStorage.get([nodeId, "EndpointStructure"], "nextEndpointId");
+    if (nextEndpointNumber !== void 0 && nextEndpointNumber > 2) {
+      console.log(
+        "It seems you used a bridged or composed example before, please make sure to use all details (type, ids,...) in the parameters when starting the new example. When using a bridge and you had changed devices after pairing it could happen that the new example introduces new devices to the controller. If you are unsure unpair the old example and start fresh."
+      );
+    }
+    const eventsStorage = newNodeStorage.createContext("events");
+    eventsStorage.set("lastEventNumber", legacyStorage.get([nodeId, "EventHandler"], "lastEventNumber"));
+    const fabricsStorage = newNodeStorage.createContext("fabrics");
+    fabricsStorage.set("fabrics", legacyStorage.get([nodeId, "FabricManager"], "fabrics"));
+    fabricsStorage.set("nextFabricIndex", legacyStorage.get([nodeId, "FabricManager"], "nextFabricIndex"));
+    const sessionsStorage = newNodeStorage.createContext("sessions");
+    sessionsStorage.set("resumptionRecords", legacyStorage.get([nodeId, "SessionManager"], "resumptionRecords"));
+    console.log(`Device Node ${nodeId} with unique id ${uniqueIds[nodeId]} migrated successfully.`);
+  }
+}
+//# sourceMappingURL=LegacyStorageConverter.js.map

package/dist/esm/examples/LegacyStorageConverter.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/examples/LegacyStorageConverter.ts"],
+  "sourcesContent": ["/**\n * @license\n * Copyright 2022-2024 Matter.js Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport \"@project-chip/matter-node.js\";\nimport { StorageBackendDisk } from \"@project-chip/matter-node.js/storage\";\nimport { Environment, StorageService } from \"@project-chip/matter.js/environment\";\nimport { Time } from \"@project-chip/matter.js/time\";\nimport { LocalStorage } from \"node-localstorage\";\n\nconst environment = Environment.default;\n\nconst legacyStoragePath = environment.vars.string(\"legacy.storage.path\");\nconst newStoragePath = environment.vars.string(\"storage.path\");\n\nif (!legacyStoragePath || !newStoragePath) {\n    console.error(\"Usage: node LegacyStorageConverter.js --legacy-storage-path=<path> --storage-path=<path>\");\n    process.exit(1);\n}\n\nconst legacyLocalStorage = new LocalStorage(legacyStoragePath);\n\nconst legacyNodes = new Array<string>();\nObject.keys(legacyLocalStorage).forEach(key => {\n    const firstLevel = key.split(\".\")[0];\n    if (!legacyNodes.includes(firstLevel)) {\n        legacyNodes.push(firstLevel);\n    }\n});\n\nconst storageService = environment.get(StorageService);\n\nconst legacyStorage = new StorageBackendDisk(legacyStoragePath);\nawait legacyStorage.initialize();\n\nconst uniqueIds: Record<string, string> = {};\nif (legacyNodes.includes(\"Device\")) {\n    console.log(\"Example Device found ...\");\n    legacyNodes.splice(legacyNodes.indexOf(\"Device\"), 1);\n\n    const newDeviceStorage = (await storageService.open(\"device\")).createContext(\"data\");\n\n    legacyStorage.keys([\"Device\"]).forEach(key => {\n        console.log(\"Migrate Device.\", key);\n        const value = legacyStorage.get([\"Device\"], key);\n        newDeviceStorage.set(key, value);\n        if (key === \"uniqueid\") {\n            uniqueIds[\"0\"] = String(value);\n            newDeviceStorage.set(key, String(value));\n        } else if (key.startsWith(\"uniqueid\")) {\n            const id = parseInt(key.substring(8));\n            uniqueIds[id - 1] = String(value);\n            newDeviceStorage.set(key, String(value));\n        }\n    });\n}\n\nif (legacyNodes.includes(\"Controller\")) {\n    console.log(\"Example Controller found ...\");\n    legacyNodes.splice(legacyNodes.indexOf(\"Controller\"), 1);\n\n    const newControllerStorage = (await storageService.open(\"controller\")).createContext(\"data\");\n\n    legacyStorage.keys([\"Controller\"]).forEach(key => {\n        console.log(\"Migrate Controller.\", key);\n        const value = legacyStorage.get([\"Controller\"], key);\n        newControllerStorage.set(key, value);\n        if (key === \"uniqueid\") {\n            uniqueIds[\"0\"] = String(value);\n            newControllerStorage.set(key, String(value));\n        }\n    });\n}\n\nconsole.log(uniqueIds);\n\nif (!Object.keys(uniqueIds).length) {\n    console.error(\"No uniqueId(s) found in legacy storage. Can not convert the node storage.\");\n    process.exit(1);\n}\n\nfor (const nodeId of legacyNodes) {\n    if (!uniqueIds[nodeId]) {\n        const rootCertId = legacyStorage.get([\"0\", \"RootCertificateManager\"], \"rootCertId\");\n\n        if (nodeId !== \"0\" || rootCertId === undefined) {\n            console.error(`No uniqueId found for node ${nodeId}. Can not convert the node storage.`);\n            continue;\n        }\n\n        // Migrate the controller storage\n        const newControllerStorage = (await storageService.open(\"controller\")).createContext(\"data\");\n        const uniqueId = Time.nowMs().toString();\n        newControllerStorage.set(\"uniqueid\", uniqueId);\n\n        const newNodeStorage = await storageService.open(uniqueId);\n\n        const credentialsStorage = newNodeStorage.createContext(\"credentials\");\n        credentialsStorage.set(\"rootCertId\", rootCertId);\n        credentialsStorage.set(\n            \"nextCertificateId\",\n            legacyStorage.get([\"0\", \"RootCertificateManager\"], \"nextCertificateId\"),\n        );\n        credentialsStorage.set(\"rootCertBytes\", legacyStorage.get([\"0\", \"RootCertificateManager\"], \"rootCertBytes\"));\n        credentialsStorage.set(\n            \"rootKeyIdentifier\",\n            legacyStorage.get([\"0\", \"RootCertificateManager\"], \"rootKeyIdentifier\"),\n        );\n        credentialsStorage.set(\"rootKeyPair\", legacyStorage.get([\"0\", \"RootCertificateManager\"], \"rootKeyPair\"));\n        credentialsStorage.set(\"fabric\", legacyStorage.get([\"0\", \"MatterController\"], \"fabric\"));\n\n        const sessionsStorage = newNodeStorage.createContext(\"sessions\");\n        sessionsStorage.set(\"resumptionRecords\", legacyStorage.get([nodeId, \"SessionManager\"], \"resumptionRecords\"));\n\n        const nodesStorage = newNodeStorage.createContext(\"nodes\");\n        nodesStorage.set(\"resumptionRecords\", legacyStorage.get([nodeId, \"MatterController\"], \"commissionedNodes\"));\n\n        console.log(`Controller Node ${nodeId} with new unique id ${uniqueId} migrated successfully.`);\n    } else {\n        // Migrate the device storage\n        const newNodeStorage = await storageService.open(uniqueIds[nodeId]);\n\n        const nextEndpointNumber = legacyStorage.get<number>([nodeId, \"EndpointStructure\"], \"nextEndpointId\");\n        if (nextEndpointNumber !== undefined && nextEndpointNumber > 2) {\n            console.log(\n                \"It seems you used a bridged or composed example before, please make sure to use all details (type, ids,...) in the parameters when starting the new example. When using a bridge and you had changed devices after pairing it could happen that the new example introduces new devices to the controller. If you are unsure unpair the old example and start fresh.\",\n            );\n        }\n\n        const eventsStorage = newNodeStorage.createContext(\"events\");\n        eventsStorage.set(\"lastEventNumber\", legacyStorage.get([nodeId, \"EventHandler\"], \"lastEventNumber\"));\n\n        const fabricsStorage = newNodeStorage.createContext(\"fabrics\");\n        fabricsStorage.set(\"fabrics\", legacyStorage.get([nodeId, \"FabricManager\"], \"fabrics\"));\n        fabricsStorage.set(\"nextFabricIndex\", legacyStorage.get([nodeId, \"FabricManager\"], \"nextFabricIndex\"));\n\n        const sessionsStorage = newNodeStorage.createContext(\"sessions\");\n        sessionsStorage.set(\"resumptionRecords\", legacyStorage.get([nodeId, \"SessionManager\"], \"resumptionRecords\"));\n\n        console.log(`Device Node ${nodeId} with unique id ${uniqueIds[nodeId]} migrated successfully.`);\n    }\n}\n"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,OAAO;AACP,SAAS,0BAA0B;AACnC,SAAS,aAAa,sBAAsB;AAC5C,SAAS,YAAY;AACrB,SAAS,oBAAoB;AAE7B,MAAM,cAAc,YAAY;AAEhC,MAAM,oBAAoB,YAAY,KAAK,OAAO,qBAAqB;AACvE,MAAM,iBAAiB,YAAY,KAAK,OAAO,cAAc;AAE7D,IAAI,CAAC,qBAAqB,CAAC,gBAAgB;AACvC,UAAQ,MAAM,0FAA0F;AACxG,UAAQ,KAAK,CAAC;AAClB;AAEA,MAAM,qBAAqB,IAAI,aAAa,iBAAiB;AAE7D,MAAM,cAAc,IAAI,MAAc;AACtC,OAAO,KAAK,kBAAkB,EAAE,QAAQ,SAAO;AAC3C,QAAM,aAAa,IAAI,MAAM,GAAG,EAAE,CAAC;AACnC,MAAI,CAAC,YAAY,SAAS,UAAU,GAAG;AACnC,gBAAY,KAAK,UAAU;AAAA,EAC/B;AACJ,CAAC;AAED,MAAM,iBAAiB,YAAY,IAAI,cAAc;AAErD,MAAM,gBAAgB,IAAI,mBAAmB,iBAAiB;AAC9D,MAAM,cAAc,WAAW;AAE/B,MAAM,YAAoC,CAAC;AAC3C,IAAI,YAAY,SAAS,QAAQ,GAAG;AAChC,UAAQ,IAAI,0BAA0B;AACtC,cAAY,OAAO,YAAY,QAAQ,QAAQ,GAAG,CAAC;AAEnD,QAAM,oBAAoB,MAAM,eAAe,KAAK,QAAQ,GAAG,cAAc,MAAM;AAEnF,gBAAc,KAAK,CAAC,QAAQ,CAAC,EAAE,QAAQ,SAAO;AAC1C,YAAQ,IAAI,mBAAmB,GAAG;AAClC,UAAM,QAAQ,cAAc,IAAI,CAAC,QAAQ,GAAG,GAAG;AAC/C,qBAAiB,IAAI,KAAK,KAAK;AAC/B,QAAI,QAAQ,YAAY;AACpB,gBAAU,GAAG,IAAI,OAAO,KAAK;AAC7B,uBAAiB,IAAI,KAAK,OAAO,KAAK,CAAC;AAAA,IAC3C,WAAW,IAAI,WAAW,UAAU,GAAG;AACnC,YAAM,KAAK,SAAS,IAAI,UAAU,CAAC,CAAC;AACpC,gBAAU,KAAK,CAAC,IAAI,OAAO,KAAK;AAChC,uBAAiB,IAAI,KAAK,OAAO,KAAK,CAAC;AAAA,IAC3C;AAAA,EACJ,CAAC;AACL;AAEA,IAAI,YAAY,SAAS,YAAY,GAAG;AACpC,UAAQ,IAAI,8BAA8B;AAC1C,cAAY,OAAO,YAAY,QAAQ,YAAY,GAAG,CAAC;AAEvD,QAAM,wBAAwB,MAAM,eAAe,KAAK,YAAY,GAAG,cAAc,MAAM;AAE3F,gBAAc,KAAK,CAAC,YAAY,CAAC,EAAE,QAAQ,SAAO;AAC9C,YAAQ,IAAI,uBAAuB,GAAG;AACtC,UAAM,QAAQ,cAAc,IAAI,CAAC,YAAY,GAAG,GAAG;AACnD,yBAAqB,IAAI,KAAK,KAAK;AACnC,QAAI,QAAQ,YAAY;AACpB,gBAAU,GAAG,IAAI,OAAO,KAAK;AAC7B,2BAAqB,IAAI,KAAK,OAAO,KAAK,CAAC;AAAA,IAC/C;AAAA,EACJ,CAAC;AACL;AAEA,QAAQ,IAAI,SAAS;AAErB,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,QAAQ;AAChC,UAAQ,MAAM,2EAA2E;AACzF,UAAQ,KAAK,CAAC;AAClB;AAEA,WAAW,UAAU,aAAa;AAC9B,MAAI,CAAC,UAAU,MAAM,GAAG;AACpB,UAAM,aAAa,cAAc,IAAI,CAAC,KAAK,wBAAwB,GAAG,YAAY;AAElF,QAAI,WAAW,OAAO,eAAe,QAAW;AAC5C,cAAQ,MAAM,8BAA8B,MAAM,qCAAqC;AACvF;AAAA,IACJ;AAGA,UAAM,wBAAwB,MAAM,eAAe,KAAK,YAAY,GAAG,cAAc,MAAM;AAC3F,UAAM,WAAW,KAAK,MAAM,EAAE,SAAS;AACvC,yBAAqB,IAAI,YAAY,QAAQ;AAE7C,UAAM,iBAAiB,MAAM,eAAe,KAAK,QAAQ;AAEzD,UAAM,qBAAqB,eAAe,cAAc,aAAa;AACrE,uBAAmB,IAAI,cAAc,UAAU;AAC/C,uBAAmB;AAAA,MACf;AAAA,MACA,cAAc,IAAI,CAAC,KAAK,wBAAwB,GAAG,mBAAmB;AAAA,IAC1E;AACA,uBAAmB,IAAI,iBAAiB,cAAc,IAAI,CAAC,KAAK,wBAAwB,GAAG,eAAe,CAAC;AAC3G,uBAAmB;AAAA,MACf;AAAA,MACA,cAAc,IAAI,CAAC,KAAK,wBAAwB,GAAG,mBAAmB;AAAA,IAC1E;AACA,uBAAmB,IAAI,eAAe,cAAc,IAAI,CAAC,KAAK,wBAAwB,GAAG,aAAa,CAAC;AACvG,uBAAmB,IAAI,UAAU,cAAc,IAAI,CAAC,KAAK,kBAAkB,GAAG,QAAQ,CAAC;AAEvF,UAAM,kBAAkB,eAAe,cAAc,UAAU;AAC/D,oBAAgB,IAAI,qBAAqB,cAAc,IAAI,CAAC,QAAQ,gBAAgB,GAAG,mBAAmB,CAAC;AAE3G,UAAM,eAAe,eAAe,cAAc,OAAO;AACzD,iBAAa,IAAI,qBAAqB,cAAc,IAAI,CAAC,QAAQ,kBAAkB,GAAG,mBAAmB,CAAC;AAE1G,YAAQ,IAAI,mBAAmB,MAAM,uBAAuB,QAAQ,yBAAyB;AAAA,EACjG,OAAO;AAEH,UAAM,iBAAiB,MAAM,eAAe,KAAK,UAAU,MAAM,CAAC;AAElE,UAAM,qBAAqB,cAAc,IAAY,CAAC,QAAQ,mBAAmB,GAAG,gBAAgB;AACpG,QAAI,uBAAuB,UAAa,qBAAqB,GAAG;AAC5D,cAAQ;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ;AAEA,UAAM,gBAAgB,eAAe,cAAc,QAAQ;AAC3D,kBAAc,IAAI,mBAAmB,cAAc,IAAI,CAAC,QAAQ,cAAc,GAAG,iBAAiB,CAAC;AAEnG,UAAM,iBAAiB,eAAe,cAAc,SAAS;AAC7D,mBAAe,IAAI,WAAW,cAAc,IAAI,CAAC,QAAQ,eAAe,GAAG,SAAS,CAAC;AACrF,mBAAe,IAAI,mBAAmB,cAAc,IAAI,CAAC,QAAQ,eAAe,GAAG,iBAAiB,CAAC;AAErG,UAAM,kBAAkB,eAAe,cAAc,UAAU;AAC/D,oBAAgB,IAAI,qBAAqB,cAAc,IAAI,CAAC,QAAQ,gBAAgB,GAAG,mBAAmB,CAAC;AAE3G,YAAQ,IAAI,eAAe,MAAM,mBAAmB,UAAU,MAAM,CAAC,yBAAyB;AAAA,EAClG;AACJ;",
+  "names": []
+}

package/dist/esm/examples/cluster/DummyThreadNetworkCommissioningServer.js

@@ -44,7 +44,7 @@ class DummyThreadNetworkCommissioningServer extends NetworkCommissioningBehavior
   }
   addOrUpdateThreadNetwork({ operationalDataset, breadcrumb }) {
     console.log(
-      `---> addOrUpdateWiFiNetwork called on NetworkCommissioning cluster: ${operationalDataset.toHex()} ${breadcrumb}`
+      `---> addOrUpdateThreadNetwork called on NetworkCommissioning cluster: ${operationalDataset.toHex()} ${breadcrumb}`
     );
     this.session.context.assertFailSafeArmed("Failsafe timer needs to be armed to add or update networks.");
     if (breadcrumb !== void 0) {

package/dist/esm/examples/cluster/DummyThreadNetworkCommissioningServer.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/examples/cluster/DummyThreadNetworkCommissioningServer.ts"],
-  "sourcesContent": ["/**\n * @license\n * Copyright 2022-2024 Matter.js Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { GeneralCommissioningBehavior } from \"@project-chip/matter.js/behavior/definitions/general-commissioning\";\nimport {\n    AddOrUpdateThreadNetworkRequest,\n    ConnectNetworkRequest,\n    NetworkCommissioningBehavior,\n    RemoveNetworkRequest,\n    ReorderNetworkRequest,\n    ScanNetworksRequest,\n    ScanNetworksResponse,\n} from \"@project-chip/matter.js/behavior/definitions/network-commissioning\";\nimport { NetworkCommissioning } from \"@project-chip/matter.js/cluster\";\nimport { Logger } from \"@project-chip/matter.js/log\";\nimport { ByteArray } from \"@project-chip/matter.js/util\";\n\nconst firstNetworkId = new ByteArray(32);\n\n/**\n * This represents a Dummy version of a Wifi Network Commissioning Cluster Server without real Wifi related logic, beside\n * returning some values provided as CLI parameters. This dummy implementation is only there for tests/as showcase for BLE\n * commissioning of a device.\n */\nexport class DummyThreadNetworkCommissioningServer extends NetworkCommissioningBehavior.with(\n    NetworkCommissioning.Feature.ThreadNetworkInterface,\n) {\n    override scanNetworks({ breadcrumb }: ScanNetworksRequest): ScanNetworksResponse {\n        console.log(`---> scanNetworks called on NetworkCommissioning cluster: ${breadcrumb}`);\n\n        // Simulate successful scan\n        if (breadcrumb !== undefined) {\n            const generalCommissioningCluster = this.agent.get(GeneralCommissioningBehavior);\n            generalCommissioningCluster.state.breadcrumb = breadcrumb;\n        }\n\n        const networkingStatus = NetworkCommissioning.NetworkCommissioningStatus.Success;\n        this.state.lastNetworkingStatus = networkingStatus;\n\n        const threadScanResults = [\n            {\n                panId: this.endpoint.env.vars.number(\"ble.thread.panId\"),\n                extendedPanId: BigInt(this.endpoint.env.vars.string(\"ble.thread.extendedPanId\")),\n                networkName: this.endpoint.env.vars.string(\"ble.thread.networkName\"),\n                channel: this.endpoint.env.vars.number(\"ble.thread.channel\"),\n                version: 130,\n                extendedAddress: ByteArray.fromString(\n                    (this.endpoint.env.vars.string(\"ble.thread.address\") ?? \"000000000000\").toLowerCase(),\n                ),\n                rssi: -50,\n                lqi: 50,\n            },\n        ];\n        console.log(Logger.toJSON(threadScanResults));\n\n        return {\n            networkingStatus,\n            threadScanResults,\n        };\n    }\n\n    override addOrUpdateThreadNetwork({ operationalDataset, breadcrumb }: AddOrUpdateThreadNetworkRequest) {\n        console.log(\n            `---> addOrUpdateWiFiNetwork called on NetworkCommissioning cluster: ${operationalDataset.toHex()} ${breadcrumb}`,\n        );\n\n        this.session.context.assertFailSafeArmed(\"Failsafe timer needs to be armed to add or update networks.\");\n\n        // Simulate successful add or update\n        if (breadcrumb !== undefined) {\n            const generalCommissioningCluster = this.agent.get(GeneralCommissioningBehavior);\n            generalCommissioningCluster.state.breadcrumb = breadcrumb;\n        }\n\n        const networkingStatus = NetworkCommissioning.NetworkCommissioningStatus.Success;\n        this.state.lastNetworkingStatus = networkingStatus;\n        this.state.lastNetworkId = firstNetworkId;\n\n        return {\n            networkingStatus,\n            networkIndex: 0,\n        };\n    }\n\n    override removeNetwork({ networkId, breadcrumb }: RemoveNetworkRequest) {\n        console.log(`---> removeNetwork called on NetworkCommissioning cluster: ${networkId.toHex()} ${breadcrumb}`);\n\n        this.session.context.assertFailSafeArmed(\"Failsafe timer needs to be armed to add or update networks.\");\n\n        // Simulate successful add or update\n        if (breadcrumb !== undefined) {\n            const generalCommissioningCluster = this.agent.get(GeneralCommissioningBehavior);\n            generalCommissioningCluster.state.breadcrumb = breadcrumb;\n        }\n\n        const networkingStatus = NetworkCommissioning.NetworkCommissioningStatus.Success;\n        this.state.lastNetworkingStatus = networkingStatus;\n        this.state.lastNetworkId = firstNetworkId;\n\n        return {\n            networkingStatus,\n            networkIndex: 0,\n        };\n    }\n\n    override async connectNetwork({ networkId, breadcrumb }: ConnectNetworkRequest) {\n        console.log(`---> connectNetwork called on NetworkCommissioning cluster: ${networkId.toHex()} ${breadcrumb}`);\n\n        this.session.context.assertFailSafeArmed(\"Failsafe timer needs to be armed to add or update networks.\");\n\n        // Simulate successful connection\n        if (breadcrumb !== undefined) {\n            const generalCommissioningCluster = this.agent.get(GeneralCommissioningBehavior);\n            generalCommissioningCluster.state.breadcrumb = breadcrumb;\n        }\n\n        this.state.networks[0].connected = true;\n\n        const networkingStatus = NetworkCommissioning.NetworkCommissioningStatus.Success;\n        this.state.lastNetworkingStatus = networkingStatus;\n        this.state.lastNetworkId = firstNetworkId;\n        this.state.lastConnectErrorValue = null;\n\n        // Announce operational in IP network\n        const device = this.session.context;\n        await device.startAnnouncement();\n\n        return {\n            networkingStatus,\n            errorValue: null,\n        };\n    }\n\n    override reorderNetwork({ networkId, networkIndex, breadcrumb }: ReorderNetworkRequest) {\n        console.log(\n            `---> reorderNetwork called on NetworkCommissioning cluster: ${networkId.toHex()} ${networkIndex} ${breadcrumb}`,\n        );\n\n        // Simulate successful connection\n        if (breadcrumb !== undefined) {\n            const generalCommissioningCluster = this.agent.get(GeneralCommissioningBehavior);\n            generalCommissioningCluster.state.breadcrumb = breadcrumb;\n        }\n\n        const networkingStatus = NetworkCommissioning.NetworkCommissioningStatus.Success;\n        this.state.lastNetworkingStatus = networkingStatus;\n\n        return {\n            networkingStatus,\n            networkIndex: 0,\n        };\n    }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * @license\n * Copyright 2022-2024 Matter.js Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { GeneralCommissioningBehavior } from \"@project-chip/matter.js/behavior/definitions/general-commissioning\";\nimport {\n    AddOrUpdateThreadNetworkRequest,\n    ConnectNetworkRequest,\n    NetworkCommissioningBehavior,\n    RemoveNetworkRequest,\n    ReorderNetworkRequest,\n    ScanNetworksRequest,\n    ScanNetworksResponse,\n} from \"@project-chip/matter.js/behavior/definitions/network-commissioning\";\nimport { NetworkCommissioning } from \"@project-chip/matter.js/cluster\";\nimport { Logger } from \"@project-chip/matter.js/log\";\nimport { ByteArray } from \"@project-chip/matter.js/util\";\n\nconst firstNetworkId = new ByteArray(32);\n\n/**\n * This represents a Dummy version of a Thread Network Commissioning Cluster Server without real thread related logic, beside\n * returning some values provided as CLI parameters. This dummy implementation is only there for tests/as showcase for BLE\n * commissioning of a device.\n */\nexport class DummyThreadNetworkCommissioningServer extends NetworkCommissioningBehavior.with(\n    NetworkCommissioning.Feature.ThreadNetworkInterface,\n) {\n    override scanNetworks({ breadcrumb }: ScanNetworksRequest): ScanNetworksResponse {\n        console.log(`---> scanNetworks called on NetworkCommissioning cluster: ${breadcrumb}`);\n\n        // Simulate successful scan\n        if (breadcrumb !== undefined) {\n            const generalCommissioningCluster = this.agent.get(GeneralCommissioningBehavior);\n            generalCommissioningCluster.state.breadcrumb = breadcrumb;\n        }\n\n        const networkingStatus = NetworkCommissioning.NetworkCommissioningStatus.Success;\n        this.state.lastNetworkingStatus = networkingStatus;\n\n        const threadScanResults = [\n            {\n                panId: this.endpoint.env.vars.number(\"ble.thread.panId\"),\n                extendedPanId: BigInt(this.endpoint.env.vars.string(\"ble.thread.extendedPanId\")),\n                networkName: this.endpoint.env.vars.string(\"ble.thread.networkName\"),\n                channel: this.endpoint.env.vars.number(\"ble.thread.channel\"),\n                version: 130,\n                extendedAddress: ByteArray.fromString(\n                    (this.endpoint.env.vars.string(\"ble.thread.address\") ?? \"000000000000\").toLowerCase(),\n                ),\n                rssi: -50,\n                lqi: 50,\n            },\n        ];\n        console.log(Logger.toJSON(threadScanResults));\n\n        return {\n            networkingStatus,\n            threadScanResults,\n        };\n    }\n\n    override addOrUpdateThreadNetwork({ operationalDataset, breadcrumb }: AddOrUpdateThreadNetworkRequest) {\n        console.log(\n            `---> addOrUpdateThreadNetwork called on NetworkCommissioning cluster: ${operationalDataset.toHex()} ${breadcrumb}`,\n        );\n\n        this.session.context.assertFailSafeArmed(\"Failsafe timer needs to be armed to add or update networks.\");\n\n        // Simulate successful add or update\n        if (breadcrumb !== undefined) {\n            const generalCommissioningCluster = this.agent.get(GeneralCommissioningBehavior);\n            generalCommissioningCluster.state.breadcrumb = breadcrumb;\n        }\n\n        const networkingStatus = NetworkCommissioning.NetworkCommissioningStatus.Success;\n        this.state.lastNetworkingStatus = networkingStatus;\n        this.state.lastNetworkId = firstNetworkId;\n\n        return {\n            networkingStatus,\n            networkIndex: 0,\n        };\n    }\n\n    override removeNetwork({ networkId, breadcrumb }: RemoveNetworkRequest) {\n        console.log(`---> removeNetwork called on NetworkCommissioning cluster: ${networkId.toHex()} ${breadcrumb}`);\n\n        this.session.context.assertFailSafeArmed(\"Failsafe timer needs to be armed to add or update networks.\");\n\n        // Simulate successful add or update\n        if (breadcrumb !== undefined) {\n            const generalCommissioningCluster = this.agent.get(GeneralCommissioningBehavior);\n            generalCommissioningCluster.state.breadcrumb = breadcrumb;\n        }\n\n        const networkingStatus = NetworkCommissioning.NetworkCommissioningStatus.Success;\n        this.state.lastNetworkingStatus = networkingStatus;\n        this.state.lastNetworkId = firstNetworkId;\n\n        return {\n            networkingStatus,\n            networkIndex: 0,\n        };\n    }\n\n    override async connectNetwork({ networkId, breadcrumb }: ConnectNetworkRequest) {\n        console.log(`---> connectNetwork called on NetworkCommissioning cluster: ${networkId.toHex()} ${breadcrumb}`);\n\n        this.session.context.assertFailSafeArmed(\"Failsafe timer needs to be armed to add or update networks.\");\n\n        // Simulate successful connection\n        if (breadcrumb !== undefined) {\n            const generalCommissioningCluster = this.agent.get(GeneralCommissioningBehavior);\n            generalCommissioningCluster.state.breadcrumb = breadcrumb;\n        }\n\n        this.state.networks[0].connected = true;\n\n        const networkingStatus = NetworkCommissioning.NetworkCommissioningStatus.Success;\n        this.state.lastNetworkingStatus = networkingStatus;\n        this.state.lastNetworkId = firstNetworkId;\n        this.state.lastConnectErrorValue = null;\n\n        // Announce operational in IP network\n        const device = this.session.context;\n        await device.startAnnouncement();\n\n        return {\n            networkingStatus,\n            errorValue: null,\n        };\n    }\n\n    override reorderNetwork({ networkId, networkIndex, breadcrumb }: ReorderNetworkRequest) {\n        console.log(\n            `---> reorderNetwork called on NetworkCommissioning cluster: ${networkId.toHex()} ${networkIndex} ${breadcrumb}`,\n        );\n\n        // Simulate successful connection\n        if (breadcrumb !== undefined) {\n            const generalCommissioningCluster = this.agent.get(GeneralCommissioningBehavior);\n            generalCommissioningCluster.state.breadcrumb = breadcrumb;\n        }\n\n        const networkingStatus = NetworkCommissioning.NetworkCommissioningStatus.Success;\n        this.state.lastNetworkingStatus = networkingStatus;\n\n        return {\n            networkingStatus,\n            networkIndex: 0,\n        };\n    }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@project-chip/matter-node.js-examples",
-    "version": "0.8.0-alpha.0-20240311-6a811d05",
+    "version": "0.8.0-alpha.0-20240317-b07eaba6",
     "description": "CLI/Reference implementation scripts for Matter protocol for node.js",
     "keywords": [
         "iot",
@@ -27,31 +27,47 @@
         "clean": "matter-build clean",
         "build": "matter-build",
         "build-clean": "matter-build --clean",
-        "light": "matter-run src/examples/LightDevice.ts",
-        "excelsior1000": "matter-run src/examples/IlluminatedRollerShade.ts",
+        "matter-light": "matter-run src/examples/LightDevice.ts",
+        "matter-sensor": "matter-run src/examples/SensorDeviceNode.ts",
+        "matter-excelsior1000": "matter-run src/examples/IlluminatedRollerShade.ts",
         "matter-device": "matter-run src/examples/DeviceNode.ts",
         "matter-bridge": "matter-run src/examples/BridgedDevicesNode.ts",
         "matter-composeddevice": "matter-run src/examples/ComposedDeviceNode.ts",
         "matter-multidevice": "matter-run src/examples/MultiDeviceNode.ts",
         "matter-controller": "matter-run src/examples/ControllerNode.ts",
+        "matter-device-legacy": "matter-run src/examples/DeviceNodeLegacy.ts",
+        "matter-bridge-legacy": "matter-run src/examples/BridgedDevicesNodeLegacy.ts",
+        "matter-composeddevice-legacy": "matter-run src/examples/ComposedDeviceNodeLegacy.ts",
+        "matter-multidevice-legacy": "matter-run src/examples/MultiDeviceNodeLegacy.ts",
+        "matter-controller-legacy": "matter-run src/examples/ControllerNodeLegacy.ts",
+        "matter-legacystorageconverter": "matter-run src/examples/LegacyStorageConverter.ts",
         "bundle-device": "esbuild src/examples/DeviceNode.ts --bundle --platform=node --conditions=esbuild --external:@stoprocent/bleno --external:@stoprocent/bluetooth-hci-socket --sourcemap --minify --outfile=build/bundle/DeviceNode.cjs",
         "matter-device-bundled": "node --enable-source-maps build/bundle/DeviceNode.cjs"
     },
     "bin": {
+        "matter-light": "./dist/esm/examples/LightDevice.ts",
+        "matter-excelsior1000": "./dist/esm/examples/IlluminatedRollerShade.ts",
+        "matter-sensor": "./dist/esm/examples/SensorDeviceNode.js",
         "matter-device": "./dist/esm/examples/DeviceNode.js",
         "matter-bridge": "./dist/esm/examples/BridgedDevicesNode.js",
         "matter-composeddevice": "./dist/esm/examples/ComposedDeviceNode.js",
         "matter-multidevice": "./dist/esm/examples/MultiDeviceNode.js",
-        "matter-controller": "./dist/esm/examples/ControllerNode.js"
+        "matter-controller": "./dist/esm/examples/ControllerNode.js",
+        "matter-device-legacy": "./dist/esm/examples/DeviceNodeLegacy.js",
+        "matter-bridge-legacy": "./dist/esm/examples/BridgedDevicesNodeLegacy.js",
+        "matter-composeddevice-legacy": "./dist/esm/examples/ComposedDeviceNodeLegacy.js",
+        "matter-multidevice-legacy": "./dist/esm/examples/MultiDeviceNodeLegacy.js",
+        "matter-controller-legacy": "./dist/esm/examples/ControllerNodeLegacy.js",
+        "matter-legacystorageconverter": "./dist/esm/examples/LegacyStorageConverter.js"
     },
     "devDependencies": {
-        "typescript": "^5.3.3"
+        "typescript": "^5.4.2"
     },
     "dependencies": {
-        "@project-chip/matter-node-ble.js": "0.8.0-alpha.0-20240311-6a811d05",
-        "@project-chip/matter-node.js": "0.8.0-alpha.0-20240311-6a811d05",
-        "@project-chip/matter.js": "0.8.0-alpha.0-20240311-6a811d05",
-        "@project-chip/matter.js-tools": "0.8.0-alpha.0-20240311-6a811d05"
+        "@project-chip/matter-node-ble.js": "0.8.0-alpha.0-20240317-b07eaba6",
+        "@project-chip/matter-node.js": "0.8.0-alpha.0-20240317-b07eaba6",
+        "@project-chip/matter.js": "0.8.0-alpha.0-20240317-b07eaba6",
+        "@project-chip/matter.js-tools": "0.8.0-alpha.0-20240317-b07eaba6"
     },
     "engines": {
         "_comment": "For Crypto.hkdf support",
@@ -67,5 +83,5 @@
     "publishConfig": {
         "access": "public"
     },
-    "gitHead": "5ca7b0c18929e547af13f20560acbfaa775861f9"
+    "gitHead": "305be42a8427187c577d668071124357491b0abd"
 }

package/src/examples/ControllerNode.ts

@@ -20,8 +20,7 @@
 import "@project-chip/matter-node.js";
 
 import { BleNode } from "@project-chip/matter-node-ble.js/ble";
-import { StorageBackendDisk } from "@project-chip/matter-node.js/storage";
-import { getIntParameter, getParameter, hasParameter, requireMinNodeVersion } from "@project-chip/matter-node.js/util";
+import { requireMinNodeVersion } from "@project-chip/matter-node.js/util";
 import { CommissioningController, NodeCommissioningOptions } from "@project-chip/matter.js";
 import { Ble } from "@project-chip/matter.js/ble";
 import {
@@ -32,11 +31,10 @@ import {
 } from "@project-chip/matter.js/cluster";
 import { NodeId } from "@project-chip/matter.js/datatype";
 import { NodeStateInformation } from "@project-chip/matter.js/device";
-import { Environment } from "@project-chip/matter.js/environment";
-import { Format, Level, Logger } from "@project-chip/matter.js/log";
+import { Environment, StorageService } from "@project-chip/matter.js/environment";
+import { Logger } from "@project-chip/matter.js/log";
 import { CommissioningOptions } from "@project-chip/matter.js/protocol";
 import { ManualPairingCodeCodec } from "@project-chip/matter.js/schema";
-import { StorageManager } from "@project-chip/matter.js/storage";
 import { Time } from "@project-chip/matter.js/time";
 import { singleton } from "@project-chip/matter.js/util";
 
@@ -44,64 +42,29 @@ const logger = Logger.get("Controller");
 
 requireMinNodeVersion(16);
 
-/** Configure logging */
-switch (getParameter("loglevel")) {
-    case "fatal":
-        Logger.defaultLogLevel = Level.FATAL;
-        break;
-    case "error":
-        Logger.defaultLogLevel = Level.ERROR;
-        break;
-    case "warn":
-        Logger.defaultLogLevel = Level.WARN;
-        break;
-    case "info":
-        Logger.defaultLogLevel = Level.INFO;
-        break;
-}
-
-switch (getParameter("logformat")) {
-    case "plain":
-        Logger.format = Format.PLAIN;
-        break;
-    case "html":
-        Logger.format = Format.HTML;
-        break;
-    default:
-        if (process.stdin?.isTTY) Logger.format = Format.ANSI;
-}
+const environment = Environment.default;
 
-if (hasParameter("ble")) {
+if (environment.vars.get("ble")) {
     // Initialize Ble
     Ble.get = singleton(
         () =>
             new BleNode({
-                hciId: getIntParameter("ble-hci-id"),
+                hciId: environment.vars.number("ble-hci-id"),
             }),
     );
 }
 
-const storageLocation = getParameter("store") ?? ".controller-node";
-const storage = new StorageBackendDisk(storageLocation, hasParameter("clearstorage"));
-logger.info(`Storage location: ${storageLocation} (Directory)`);
+const storageService = environment.get(StorageService);
+
+console.log(`Storage location: ${storageService.location} (Directory)`);
 logger.info(
-    'Use the parameter "-store NAME" to specify a different storage location, use -clearstorage to start with an empty storage.',
+    'Use the parameter "--storage-path=NAME-OR-PATH" to specify a different storage location in this directory, use --storage-clear to start with an empty storage.',
 );
 
 class ControllerNode {
     async start() {
         logger.info(`node-matter Controller started`);
 
-        /**
-         * Initialize the storage system.
-         *
-         * The storage manager is then also used by the Matter server, so this code block in general is required,
-         * but you can choose a different storage backend as long as it implements the required API.
-         */
-
-        const storageManager = new StorageManager(storage);
-        await storageManager.initialize();
-
         /**
          * Collect all needed data
          *
@@ -113,15 +76,17 @@ class ControllerNode {
          * (so maybe better not ;-)).
          */
 
-        const controllerStorage = storageManager.createContext("Controller");
-        const ip = controllerStorage.has("ip") ? controllerStorage.get<string>("ip") : getParameter("ip");
-        const port = controllerStorage.has("port") ? controllerStorage.get<number>("port") : getIntParameter("port");
+        const controllerStorage = (await storageService.open("controller")).createContext("data");
+        const ip = controllerStorage.has("ip") ? controllerStorage.get<string>("ip") : environment.vars.string("ip");
+        const port = controllerStorage.has("port")
+            ? controllerStorage.get<number>("port")
+            : environment.vars.number("port");
         const uniqueId = controllerStorage.has("uniqueid")
             ? controllerStorage.get<string>("uniqueid")
-            : getParameter("uniqueid") ?? Time.nowMs().toString();
+            : environment.vars.string("uniqueid") ?? Time.nowMs().toString();
         controllerStorage.set("uniqueid", uniqueId);
 
-        const pairingCode = getParameter("pairingcode");
+        const pairingCode = environment.vars.string("pairingcode");
         let longDiscriminator, setupPin, shortDiscriminator;
         if (pairingCode !== undefined) {
             const pairingCodeCodec = ManualPairingCodeCodec.decode(pairingCode);
@@ -131,9 +96,9 @@ class ControllerNode {
             logger.debug(`Data extracted from pairing code: ${Logger.toJSON(pairingCodeCodec)}`);
         } else {
             longDiscriminator =
-                getIntParameter("longDiscriminator") ?? controllerStorage.get("longDiscriminator", 3840);
+                environment.vars.number("longDiscriminator") ?? controllerStorage.get("longDiscriminator", 3840);
             if (longDiscriminator > 4095) throw new Error("Discriminator value must be less than 4096");
-            setupPin = getIntParameter("pin") ?? controllerStorage.get("pin", 20202021);
+            setupPin = environment.vars.number("pin") ?? controllerStorage.get("pin", 20202021);
         }
         if ((shortDiscriminator === undefined && longDiscriminator === undefined) || setupPin === undefined) {
             throw new Error(
@@ -148,12 +113,12 @@ class ControllerNode {
         };
 
         let ble = false;
-        if (hasParameter("ble")) {
+        if (environment.vars.get("ble")) {
             ble = true;
-            const wifiSsid = getParameter("ble-wifi-ssid");
-            const wifiCredentials = getParameter("ble-wifi-credentials");
-            const threadNetworkName = getParameter("ble-thread-networkname");
-            const threadOperationalDataset = getParameter("ble-thread-operationaldataset");
+            const wifiSsid = environment.vars.string("ble-wifi-ssid");
+            const wifiCredentials = environment.vars.string("ble-wifi-credentials");
+            const threadNetworkName = environment.vars.string("ble-thread-networkname");
+            const threadOperationalDataset = environment.vars.string("ble-thread-operationaldataset");
             if (wifiSsid !== undefined && wifiCredentials !== undefined) {
                 logger.info(`Registering Commissioning over BLE with WiFi: ${wifiSsid}`);
                 commissioningOptions.wifiNetwork = {
@@ -183,7 +148,6 @@ class ControllerNode {
          * are called.
          */
 
-        const environment = Environment.default;
         const commissioningController = new CommissioningController({
             environment: {
                 environment,
@@ -230,7 +194,7 @@ class ControllerNode {
             const nodes = commissioningController.getCommissionedNodes();
             console.log("Found commissioned nodes:", Logger.toJSON(nodes));
 
-            const nodeId = NodeId(getIntParameter("nodeid") ?? nodes[0]);
+            const nodeId = NodeId(environment.vars.number("nodeid") ?? nodes[0]);
             if (!nodes.includes(nodeId)) {
                 throw new Error(`Node ${nodeId} not found in commissioned nodes`);
             }
@@ -349,12 +313,3 @@ class ControllerNode {
 }
 
 new ControllerNode().start().catch(error => logger.error(error));
-
-process.on("SIGINT", () => {
-    // Clean up on CTRL-C
-    // Pragmatic way to make sure the storage is correctly closed before the process ends.
-    storage
-        .close()
-        .then(() => process.exit(0))
-        .catch(() => process.exit(1));
-});

package/src/examples/DeviceNode.ts

@@ -177,7 +177,7 @@ async function getConfiguration() {
 
     const port = environment.vars.number("port") ?? 5540;
 
-    const uniqueId = environment.vars.string("uniqueid") ?? deviceStorage.get("uniqueid", Time.nowMs().toString());
+    const uniqueId = environment.vars.string("uniqueid") ?? deviceStorage.get("uniqueid", Time.nowMs()).toString();
 
     // Persist basic data to keep them also on restart
     deviceStorage.set("passcode", passcode);

package/src/examples/LegacyStorageConverter.ts

@@ -0,0 +1,144 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import "@project-chip/matter-node.js";
+import { StorageBackendDisk } from "@project-chip/matter-node.js/storage";
+import { Environment, StorageService } from "@project-chip/matter.js/environment";
+import { Time } from "@project-chip/matter.js/time";
+import { LocalStorage } from "node-localstorage";
+
+const environment = Environment.default;
+
+const legacyStoragePath = environment.vars.string("legacy.storage.path");
+const newStoragePath = environment.vars.string("storage.path");
+
+if (!legacyStoragePath || !newStoragePath) {
+    console.error("Usage: node LegacyStorageConverter.js --legacy-storage-path=<path> --storage-path=<path>");
+    process.exit(1);
+}
+
+const legacyLocalStorage = new LocalStorage(legacyStoragePath);
+
+const legacyNodes = new Array<string>();
+Object.keys(legacyLocalStorage).forEach(key => {
+    const firstLevel = key.split(".")[0];
+    if (!legacyNodes.includes(firstLevel)) {
+        legacyNodes.push(firstLevel);
+    }
+});
+
+const storageService = environment.get(StorageService);
+
+const legacyStorage = new StorageBackendDisk(legacyStoragePath);
+await legacyStorage.initialize();
+
+const uniqueIds: Record<string, string> = {};
+if (legacyNodes.includes("Device")) {
+    console.log("Example Device found ...");
+    legacyNodes.splice(legacyNodes.indexOf("Device"), 1);
+
+    const newDeviceStorage = (await storageService.open("device")).createContext("data");
+
+    legacyStorage.keys(["Device"]).forEach(key => {
+        console.log("Migrate Device.", key);
+        const value = legacyStorage.get(["Device"], key);
+        newDeviceStorage.set(key, value);
+        if (key === "uniqueid") {
+            uniqueIds["0"] = String(value);
+            newDeviceStorage.set(key, String(value));
+        } else if (key.startsWith("uniqueid")) {
+            const id = parseInt(key.substring(8));
+            uniqueIds[id - 1] = String(value);
+            newDeviceStorage.set(key, String(value));
+        }
+    });
+}
+
+if (legacyNodes.includes("Controller")) {
+    console.log("Example Controller found ...");
+    legacyNodes.splice(legacyNodes.indexOf("Controller"), 1);
+
+    const newControllerStorage = (await storageService.open("controller")).createContext("data");
+
+    legacyStorage.keys(["Controller"]).forEach(key => {
+        console.log("Migrate Controller.", key);
+        const value = legacyStorage.get(["Controller"], key);
+        newControllerStorage.set(key, value);
+        if (key === "uniqueid") {
+            uniqueIds["0"] = String(value);
+            newControllerStorage.set(key, String(value));
+        }
+    });
+}
+
+console.log(uniqueIds);
+
+if (!Object.keys(uniqueIds).length) {
+    console.error("No uniqueId(s) found in legacy storage. Can not convert the node storage.");
+    process.exit(1);
+}
+
+for (const nodeId of legacyNodes) {
+    if (!uniqueIds[nodeId]) {
+        const rootCertId = legacyStorage.get(["0", "RootCertificateManager"], "rootCertId");
+
+        if (nodeId !== "0" || rootCertId === undefined) {
+            console.error(`No uniqueId found for node ${nodeId}. Can not convert the node storage.`);
+            continue;
+        }
+
+        // Migrate the controller storage
+        const newControllerStorage = (await storageService.open("controller")).createContext("data");
+        const uniqueId = Time.nowMs().toString();
+        newControllerStorage.set("uniqueid", uniqueId);
+
+        const newNodeStorage = await storageService.open(uniqueId);
+
+        const credentialsStorage = newNodeStorage.createContext("credentials");
+        credentialsStorage.set("rootCertId", rootCertId);
+        credentialsStorage.set(
+            "nextCertificateId",
+            legacyStorage.get(["0", "RootCertificateManager"], "nextCertificateId"),
+        );
+        credentialsStorage.set("rootCertBytes", legacyStorage.get(["0", "RootCertificateManager"], "rootCertBytes"));
+        credentialsStorage.set(
+            "rootKeyIdentifier",
+            legacyStorage.get(["0", "RootCertificateManager"], "rootKeyIdentifier"),
+        );
+        credentialsStorage.set("rootKeyPair", legacyStorage.get(["0", "RootCertificateManager"], "rootKeyPair"));
+        credentialsStorage.set("fabric", legacyStorage.get(["0", "MatterController"], "fabric"));
+
+        const sessionsStorage = newNodeStorage.createContext("sessions");
+        sessionsStorage.set("resumptionRecords", legacyStorage.get([nodeId, "SessionManager"], "resumptionRecords"));
+
+        const nodesStorage = newNodeStorage.createContext("nodes");
+        nodesStorage.set("resumptionRecords", legacyStorage.get([nodeId, "MatterController"], "commissionedNodes"));
+
+        console.log(`Controller Node ${nodeId} with new unique id ${uniqueId} migrated successfully.`);
+    } else {
+        // Migrate the device storage
+        const newNodeStorage = await storageService.open(uniqueIds[nodeId]);
+
+        const nextEndpointNumber = legacyStorage.get<number>([nodeId, "EndpointStructure"], "nextEndpointId");
+        if (nextEndpointNumber !== undefined && nextEndpointNumber > 2) {
+            console.log(
+                "It seems you used a bridged or composed example before, please make sure to use all details (type, ids,...) in the parameters when starting the new example. When using a bridge and you had changed devices after pairing it could happen that the new example introduces new devices to the controller. If you are unsure unpair the old example and start fresh.",
+            );
+        }
+
+        const eventsStorage = newNodeStorage.createContext("events");
+        eventsStorage.set("lastEventNumber", legacyStorage.get([nodeId, "EventHandler"], "lastEventNumber"));
+
+        const fabricsStorage = newNodeStorage.createContext("fabrics");
+        fabricsStorage.set("fabrics", legacyStorage.get([nodeId, "FabricManager"], "fabrics"));
+        fabricsStorage.set("nextFabricIndex", legacyStorage.get([nodeId, "FabricManager"], "nextFabricIndex"));
+
+        const sessionsStorage = newNodeStorage.createContext("sessions");
+        sessionsStorage.set("resumptionRecords", legacyStorage.get([nodeId, "SessionManager"], "resumptionRecords"));
+
+        console.log(`Device Node ${nodeId} with unique id ${uniqueIds[nodeId]} migrated successfully.`);
+    }
+}

package/src/examples/cluster/DummyThreadNetworkCommissioningServer.ts

@@ -21,7 +21,7 @@ import { ByteArray } from "@project-chip/matter.js/util";
 const firstNetworkId = new ByteArray(32);
 
 /**
- * This represents a Dummy version of a Wifi Network Commissioning Cluster Server without real Wifi related logic, beside
+ * This represents a Dummy version of a Thread Network Commissioning Cluster Server without real thread related logic, beside
  * returning some values provided as CLI parameters. This dummy implementation is only there for tests/as showcase for BLE
  * commissioning of a device.
  */
@@ -64,7 +64,7 @@ export class DummyThreadNetworkCommissioningServer extends NetworkCommissioningB
 
     override addOrUpdateThreadNetwork({ operationalDataset, breadcrumb }: AddOrUpdateThreadNetworkRequest) {
         console.log(
-            `---> addOrUpdateWiFiNetwork called on NetworkCommissioning cluster: ${operationalDataset.toHex()} ${breadcrumb}`,
+            `---> addOrUpdateThreadNetwork called on NetworkCommissioning cluster: ${operationalDataset.toHex()} ${breadcrumb}`,
         );
 
         this.session.context.assertFailSafeArmed("Failsafe timer needs to be armed to add or update networks.");