@matter/nodejs-shell 0.16.0-alpha.0-20251216-71c21f901 → 0.16.0-alpha.0-20251220-0bb8d9f89

package/dist/esm/MatterNode.js

@@ -3,7 +3,13 @@
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Environment, Logger, StorageService } from "#general";
+import {
+  Environment,
+  Logger,
+  ObserverGroup,
+  StorageService
+} from "#general";
+import { SoftwareUpdateManager } from "#node";
 import { DclCertificateService, DclOtaUpdateService, DclVendorInfoService } from "#protocol";
 import { NodeId } from "#types";
 import { CommissioningController } from "@project-chip/matter.js";
@@ -19,6 +25,7 @@ class MatterNode {
   #netInterface;
   #dclFetchTestCertificates = false;
   #services;
+  #observers;
   constructor(nodeNum, netInterface) {
     this.#environment = Environment.default;
     this.#environment.runtime.add(this);
@@ -73,7 +80,8 @@ class MatterNode {
           id
         },
         autoConnect: false,
-        adminFabricLabel: "matter.js Shell"
+        adminFabricLabel: "matter.js Shell",
+        enableOtaProvider: true
       });
       const storageService = this.commissioningController.env.get(StorageService);
       const baseLocation = storageService.location;
@@ -101,6 +109,7 @@ class MatterNode {
   async close() {
     await this.commissioningController?.close();
     await this.#services?.close();
+    this.#observers?.close();
   }
   async start() {
     if (this.#started) {
@@ -117,6 +126,14 @@ class MatterNode {
     } else {
       throw new Error("No controller initialized");
     }
+    this.#observers = this.#observers ?? new ObserverGroup(this.#environment.runtime);
+    const updateManagerEvents = this.commissioningController.otaProvider.eventsOf(SoftwareUpdateManager);
+    this.#observers.on(updateManagerEvents.updateAvailable, (peer, details) => {
+      logger.info(`Update available for peer `, peer, `:`, details);
+    });
+    this.#observers.on(updateManagerEvents.updateDone, (peer) => {
+      logger.info(`Update done for peer `, peer);
+    });
     this.#started = true;
   }
   async connectAndGetNodes(nodeIdStr, connectOptions) {

package/dist/esm/MatterNode.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/MatterNode.ts"],
-  "mappings": "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",
+  "mappings": "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",
   "names": []
 }

package/dist/esm/shell/cmd_nodes.js

@@ -4,7 +4,9 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { capitalize, decamelize, Diagnostic } from "#general";
-import { NodeId } from "#types";
+import { SoftwareUpdateManager } from "#node";
+import { PeerAddress } from "#protocol";
+import { FabricIndex, NodeId } from "#types";
 import { NodeStateInformation } from "@project-chip/matter.js/device";
 function createDiagnosticCallbacks() {
   return {
@@ -198,10 +200,14 @@ function commands(theNode) {
             throw new Error(`Node ${nodeIdStr} not commissioned`);
           }
         }
+        const nodeDetails = theNode.commissioningController.getCommissionedNodesDetails();
         for (const nodeIdToProcess of nodeIds) {
           const node = theNode.commissioningController.getPairedNode(nodeIdToProcess);
           if (node === void 0) {
-            console.log(`Node ${nodeIdToProcess}: Not initialized`);
+            const details = nodeDetails.find((nd) => nd.nodeId === nodeIdToProcess);
+            console.log(
+              `Node ${nodeIdToProcess}: Not initialized${details?.deviceData?.basicInformation !== void 0 ? ` (${details.deviceData.basicInformation.vendorName} ${details.deviceData.basicInformation.productName})` : ""}`
+            );
           } else {
             const basicInfo = node.basicInformation;
             console.log(
@@ -210,10 +216,91 @@ function commands(theNode) {
           }
         }
       }
+    ).command(
+      "add [node-id]",
+      "Adds a node without commissioning and connects to it (means need to exist in the fabric and commissioned otherwise)",
+      (yargs2) => {
+        return yargs2.positional("node-id", {
+          describe: "node id to connect.",
+          default: "all",
+          type: "string",
+          demandOption: true
+        }).positional("min-subscription-interval", {
+          describe: "Minimum subscription interval in seconds. If set then the node is subscribed to all attributes and events.",
+          type: "number"
+        }).positional("max-subscription-interval", {
+          describe: "Maximum subscription interval in seconds. If minimum interval is set and this not it will be determined automatically.",
+          type: "number"
+        });
+      },
+      async (argv) => {
+        const { nodeId: nodeIdStr, maxSubscriptionInterval, minSubscriptionInterval } = argv;
+        await theNode.start();
+        if (theNode.commissioningController === void 0) {
+          throw new Error("CommissioningController not initialized");
+        }
+        let nodeIds = theNode.commissioningController.getCommissionedNodes();
+        const cmdNodeId = NodeId(BigInt(nodeIdStr));
+        nodeIds = nodeIds.filter((nodeId) => nodeId === cmdNodeId);
+        if (nodeIds.length) {
+          throw new Error(`Node ${nodeIdStr} already known`);
+        }
+        await theNode.commissioningController.node.peers.forAddress(
+          theNode.commissioningController.fabric.addressOf(cmdNodeId)
+        );
+        const autoSubscribe = minSubscriptionInterval !== void 0;
+        const node = await theNode.commissioningController.getNode(cmdNodeId);
+        node.connect({
+          autoSubscribe,
+          subscribeMinIntervalFloorSeconds: autoSubscribe ? minSubscriptionInterval : void 0,
+          subscribeMaxIntervalCeilingSeconds: autoSubscribe ? maxSubscriptionInterval : void 0,
+          ...createDiagnosticCallbacks()
+        });
+      }
     ).command(
       "ota",
       "OTA update operations for nodes",
       (yargs2) => yargs2.command(
+        "known [node-id]",
+        "List which OTA updates are known to be available for commissioned nodes. A first query by the provider must have happened for this to be filled.",
+        (yargs3) => {
+          return yargs3.positional("node-id", {
+            describe: "Node ID to check for updates",
+            type: "string",
+            default: void 0
+          }).option("local", {
+            describe: "include local update files",
+            type: "boolean",
+            default: false
+          });
+        },
+        async (argv) => {
+          const { nodeId: nodeIdStr, local } = argv;
+          await theNode.start();
+          if (theNode.commissioningController === void 0) {
+            throw new Error("CommissioningController not initialized");
+          }
+          let peerToCheck = void 0;
+          if (nodeIdStr !== void 0) {
+            const nodeId = NodeId(BigInt(nodeIdStr));
+            peerToCheck = (await theNode.commissioningController.getNode(nodeId))?.node;
+          }
+          const updatesAvailable = await theNode.commissioningController.otaProvider.act(
+            (agent) => agent.get(SoftwareUpdateManager).queryUpdates({ peerToCheck, includeStoredUpdates: local })
+          );
+          if (updatesAvailable.length) {
+            console.log(`OTA updates available for ${updatesAvailable.length} nodes:`);
+            for (const { peerAddress, info } of updatesAvailable) {
+              console.log(
+                peerAddress,
+                `: new Version: ${info.softwareVersion} (${info.softwareVersionString})`
+              );
+            }
+          } else {
+            console.log("No OTA updates available.");
+          }
+        }
+      ).command(
         "check <node-id>",
         "Check for OTA updates for a commissioned node",
         (yargs3) => {
@@ -226,10 +313,14 @@ function commands(theNode) {
             type: "string",
             choices: ["prod", "test"],
             default: "prod"
+          }).option("local", {
+            describe: "include local update files",
+            type: "boolean",
+            default: false
           });
         },
         async (argv) => {
-          const { nodeId: nodeIdStr, mode } = argv;
+          const { nodeId: nodeIdStr, mode, local } = argv;
           const isProduction = mode === "prod";
           await theNode.start();
           if (theNode.commissioningController === void 0) {
@@ -258,12 +349,13 @@ function commands(theNode) {
           );
           console.log(`  DCL Mode: ${isProduction ? "production" : "test"}
 `);
-          const updateInfo = await theNode.otaService.checkForUpdate(
-            basicInfo.vendorId,
-            basicInfo.productId,
-            basicInfo.softwareVersion,
+          const updateInfo = await theNode.otaService.checkForUpdate({
+            vendorId: basicInfo.vendorId,
+            productId: basicInfo.productId,
+            currentSoftwareVersion: basicInfo.softwareVersion,
+            includeStoredUpdates: local,
             isProduction
-          );
+          });
           if (updateInfo) {
             console.log("\u2713 Update available!");
             console.log(
@@ -302,10 +394,14 @@ Run "nodes ota download ${nodeIdStr}${mode === "test" ? " --mode test" : ""}" to
             describe: "Force download even if update is already stored locally",
             type: "boolean",
             default: false
+          }).option("local", {
+            describe: "include local update files",
+            type: "boolean",
+            default: false
           });
         },
         async (argv) => {
-          const { nodeId: nodeIdStr, mode, force } = argv;
+          const { nodeId: nodeIdStr, mode, force, local } = argv;
           const isProduction = mode === "prod";
           const forceDownload = force === true;
           await theNode.start();
@@ -335,12 +431,13 @@ Run "nodes ota download ${nodeIdStr}${mode === "test" ? " --mode test" : ""}" to
           );
           console.log(`  DCL Mode: ${isProduction ? "production" : "test"}
 `);
-          const updateInfo = await theNode.otaService.checkForUpdate(
-            basicInfo.vendorId,
-            basicInfo.productId,
-            basicInfo.softwareVersion,
+          const updateInfo = await theNode.otaService.checkForUpdate({
+            vendorId: basicInfo.vendorId,
+            productId: basicInfo.productId,
+            currentSoftwareVersion: basicInfo.softwareVersion,
+            includeStoredUpdates: local,
             isProduction
-          );
+          });
           if (!updateInfo) {
             console.log("No updates available. Device is up to date.");
             return;
@@ -366,6 +463,119 @@ Run "nodes ota download ${nodeIdStr}${mode === "test" ? " --mode test" : ""}" to
 You can now apply this update to the device using your device's OTA mechanism.`
           );
         }
+      ).command(
+        "apply <node-id>",
+        "Apply OTA update for a commissioned node",
+        (yargs3) => {
+          return yargs3.positional("node-id", {
+            describe: "Node ID to download update for",
+            type: "string",
+            demandOption: true
+          }).option("mode", {
+            describe: "DCL mode (prod or test)",
+            type: "string",
+            choices: ["prod", "test"],
+            default: "prod"
+          }).option("force", {
+            describe: "Force download even if update is already stored locally",
+            type: "boolean",
+            default: false
+          }).option("local", {
+            describe: "Apply update from local file",
+            type: "boolean",
+            default: false
+          });
+        },
+        async (argv) => {
+          const { nodeId: nodeIdStr, mode, force, local } = argv;
+          const isProduction = mode === "prod";
+          const forceDownload = force === true;
+          await theNode.start();
+          if (theNode.commissioningController === void 0) {
+            throw new Error("CommissioningController not initialized");
+          }
+          const nodeId = NodeId(BigInt(nodeIdStr));
+          const nodeDetails = theNode.commissioningController.getCommissionedNodesDetails().find((nd) => nd.nodeId === nodeId);
+          const basicInfo = nodeDetails?.deviceData?.basicInformation;
+          if (!basicInfo) {
+            throw new Error(`Node ${nodeIdStr} has no basic information available`);
+          }
+          if (basicInfo.vendorId === void 0 || basicInfo.productId === void 0 || basicInfo.softwareVersion === void 0) {
+            throw new Error(
+              `Node ${nodeIdStr} is missing required basic information for OTA check`
+            );
+          }
+          console.log(`Checking for OTA updates for node ${nodeIdStr}...`);
+          console.log(
+            `  Vendor ID: ${Diagnostic.hex(basicInfo.vendorId, 4).toUpperCase()}`
+          );
+          console.log(
+            `  Product ID: ${Diagnostic.hex(basicInfo.productId, 4).toUpperCase()}`
+          );
+          console.log(
+            `  Current Software Version: ${basicInfo.softwareVersion} (${basicInfo.softwareVersionString})`
+          );
+          console.log(`  DCL Mode: ${isProduction ? "production" : "test"}
+`);
+          const localUpdates = await theNode.otaService.find({
+            vendorId: basicInfo.vendorId,
+            productId: basicInfo.productId,
+            currentVersion: basicInfo.softwareVersion
+          });
+          if (local && !localUpdates.length) {
+            console.log("No applicable updates available in local storage.");
+            return;
+          }
+          const updateInfo = await theNode.otaService.checkForUpdate({
+            vendorId: basicInfo.vendorId,
+            productId: basicInfo.productId,
+            currentSoftwareVersion: basicInfo.softwareVersion,
+            includeStoredUpdates: local,
+            isProduction
+          });
+          let updateVersion;
+          if (!updateInfo && !local) {
+            console.log("No updates available in DCL. Device is up to date.");
+            return;
+          } else if (updateInfo) {
+            console.log("Update found:");
+            console.log(
+              `  New Version: ${updateInfo.softwareVersion} (${updateInfo.softwareVersionString})`
+            );
+            console.log(`  OTA URL: ${updateInfo.otaUrl}`);
+            if (updateInfo.otaFileSize) {
+              const sizeKB = Number(updateInfo.otaFileSize) / 1024;
+              console.log(`  File Size: ${sizeKB.toFixed(2)} KB`);
+            }
+            console.log("\nDownloading update...");
+            const fd = await theNode.otaService.downloadUpdate(
+              updateInfo,
+              isProduction,
+              forceDownload
+            );
+            updateVersion = updateInfo.softwareVersion;
+            console.log(
+              `\u2713 Update to version ${updateVersion} (${updateInfo.softwareVersionString}) downloaded and stored successfully: ${fd.text}`
+            );
+          } else {
+            updateVersion = localUpdates[0].softwareVersion;
+            console.log(
+              `Update to version ${updateVersion} (${localUpdates[0].softwareVersionString}) found in local storage: ${localUpdates[0].filename}`
+            );
+          }
+          const node = theNode.commissioningController.getPairedNode(nodeId);
+          if (node === void 0) {
+            throw new Error(`Node ${nodeIdStr} not connected`);
+          }
+          await theNode.commissioningController.otaProvider.act((agent) => {
+            return agent.get(SoftwareUpdateManager).forceUpdate(
+              PeerAddress({ nodeId, fabricIndex: FabricIndex(1) }),
+              basicInfo.vendorId,
+              basicInfo.productId,
+              updateVersion
+            );
+          });
+        }
       ).demandCommand(1, "Please specify an OTA subcommand"),
       async (argv) => {
         argv.unhandled = true;

package/dist/esm/shell/cmd_nodes.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/shell/cmd_nodes.ts"],
-  "mappings": "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",
+  "mappings": "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",
   "names": ["yargs"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@matter/nodejs-shell",
-    "version": "0.16.0-alpha.0-20251216-71c21f901",
+    "version": "0.16.0-alpha.0-20251220-0bb8d9f89",
     "description": "Shell app for Matter controller",
     "keywords": [
         "iot",
@@ -43,15 +43,15 @@
         "#types": "@matter/types"
     },
     "dependencies": {
-        "@matter/general": "0.16.0-alpha.0-20251216-71c21f901",
-        "@matter/model": "0.16.0-alpha.0-20251216-71c21f901",
-        "@matter/node": "0.16.0-alpha.0-20251216-71c21f901",
-        "@matter/nodejs": "0.16.0-alpha.0-20251216-71c21f901",
-        "@matter/nodejs-ble": "0.16.0-alpha.0-20251216-71c21f901",
-        "@matter/protocol": "0.16.0-alpha.0-20251216-71c21f901",
-        "@matter/tools": "0.16.0-alpha.0-20251216-71c21f901",
-        "@matter/types": "0.16.0-alpha.0-20251216-71c21f901",
-        "@project-chip/matter.js": "0.16.0-alpha.0-20251216-71c21f901",
+        "@matter/general": "0.16.0-alpha.0-20251220-0bb8d9f89",
+        "@matter/model": "0.16.0-alpha.0-20251220-0bb8d9f89",
+        "@matter/node": "0.16.0-alpha.0-20251220-0bb8d9f89",
+        "@matter/nodejs": "0.16.0-alpha.0-20251220-0bb8d9f89",
+        "@matter/nodejs-ble": "0.16.0-alpha.0-20251220-0bb8d9f89",
+        "@matter/protocol": "0.16.0-alpha.0-20251220-0bb8d9f89",
+        "@matter/tools": "0.16.0-alpha.0-20251220-0bb8d9f89",
+        "@matter/types": "0.16.0-alpha.0-20251220-0bb8d9f89",
+        "@project-chip/matter.js": "0.16.0-alpha.0-20251220-0bb8d9f89",
         "ws": "^8.18.3",
         "yargs": "^18.0.0"
     },

package/src/MatterNode.ts

@@ -5,7 +5,15 @@
  */
 
 // Include this first to auto-register Crypto, Network and Time Node.js implementations
-import { Environment, Logger, SharedEnvironmentServices, StorageContext, StorageService } from "#general";
+import {
+    Environment,
+    Logger,
+    ObserverGroup,
+    SharedEnvironmentServices,
+    StorageContext,
+    StorageService,
+} from "#general";
+import { ServerNode, SoftwareUpdateManager } from "#node";
 import { DclCertificateService, DclOtaUpdateService, DclVendorInfoService } from "#protocol";
 import { NodeId } from "#types";
 import { CommissioningController } from "@project-chip/matter.js";
@@ -24,6 +32,7 @@ export class MatterNode {
     readonly #netInterface?: string;
     #dclFetchTestCertificates = false;
     #services?: SharedEnvironmentServices;
+    #observers?: ObserverGroup;
 
     constructor(nodeNum: number, netInterface?: string) {
         this.#environment = Environment.default;
@@ -47,7 +56,7 @@ export class MatterNode {
         return this.#services;
     }
 
-    get node() {
+    get node(): ServerNode {
         if (this.commissioningController === undefined) {
             throw new Error("CommissioningController not initialized. Start first");
         }
@@ -79,7 +88,7 @@ export class MatterNode {
         /**
          * Initialize the storage system.
          *
-         * The storage manager is then also used by the Matter server, so this code block in general is required,
+         * The Matter server then also uses the storage manager, so this code block in general is required,
          * but you can choose a different storage backend as long as it implements the required API.
          */
 
@@ -87,6 +96,7 @@ export class MatterNode {
             if (this.#netInterface !== undefined) {
                 this.#environment.vars.set("mdns.networkinterface", this.#netInterface);
             }
+
             // Build up the "Not-so-legacy" Controller
             const id = `shell-${this.#nodeNum.toString()}`;
             this.commissioningController = new CommissioningController({
@@ -96,6 +106,7 @@ export class MatterNode {
                 },
                 autoConnect: false,
                 adminFabricLabel: "matter.js Shell",
+                enableOtaProvider: true,
             });
 
             const storageService = this.commissioningController.env.get(StorageService);
@@ -129,6 +140,7 @@ export class MatterNode {
     async close() {
         await this.commissioningController?.close();
         await this.#services?.close();
+        this.#observers?.close();
     }
 
     async start() {
@@ -148,6 +160,16 @@ export class MatterNode {
         } else {
             throw new Error("No controller initialized");
         }
+
+        this.#observers = this.#observers ?? new ObserverGroup(this.#environment.runtime);
+        const updateManagerEvents = this.commissioningController.otaProvider.eventsOf(SoftwareUpdateManager);
+        this.#observers.on(updateManagerEvents.updateAvailable, (peer, details) => {
+            logger.info(`Update available for peer `, peer, `:`, details);
+        });
+        this.#observers.on(updateManagerEvents.updateDone, peer => {
+            logger.info(`Update done for peer `, peer);
+        });
+
         this.#started = true;
     }
 

package/src/shell/cmd_nodes.ts

@@ -5,7 +5,9 @@
  */
 
 import { capitalize, decamelize, Diagnostic } from "#general";
-import { NodeId, VendorId } from "#types";
+import { ClientNode, SoftwareUpdateManager } from "#node";
+import { PeerAddress } from "#protocol";
+import { FabricIndex, NodeId, VendorId } from "#types";
 import { CommissioningControllerNodeOptions, NodeStateInformation } from "@project-chip/matter.js/device";
 import type { Argv } from "yargs";
 import { MatterNode } from "../MatterNode.js";
@@ -228,10 +230,15 @@ export default function commands(theNode: MatterNode) {
                             }
                         }
 
+                        const nodeDetails = theNode.commissioningController.getCommissionedNodesDetails();
+
                         for (const nodeIdToProcess of nodeIds) {
                             const node = theNode.commissioningController.getPairedNode(nodeIdToProcess);
                             if (node === undefined) {
-                                console.log(`Node ${nodeIdToProcess}: Not initialized`);
+                                const details = nodeDetails.find(nd => nd.nodeId === nodeIdToProcess);
+                                console.log(
+                                    `Node ${nodeIdToProcess}: Not initialized${details?.deviceData?.basicInformation !== undefined ? ` (${details.deviceData.basicInformation.vendorName} ${details.deviceData.basicInformation.productName})` : ""}`,
+                                );
                             } else {
                                 const basicInfo = node.basicInformation;
                                 console.log(
@@ -241,11 +248,112 @@ export default function commands(theNode: MatterNode) {
                         }
                     },
                 )
+                .command(
+                    "add [node-id]",
+                    "Adds a node without commissioning and connects to it (means need to exist in the fabric and commissioned otherwise)",
+                    yargs => {
+                        return yargs
+                            .positional("node-id", {
+                                describe: "node id to connect.",
+                                default: "all",
+                                type: "string",
+                                demandOption: true,
+                            })
+                            .positional("min-subscription-interval", {
+                                describe:
+                                    "Minimum subscription interval in seconds. If set then the node is subscribed to all attributes and events.",
+                                type: "number",
+                            })
+                            .positional("max-subscription-interval", {
+                                describe:
+                                    "Maximum subscription interval in seconds. If minimum interval is set and this not it will be determined automatically.",
+                                type: "number",
+                            });
+                    },
+                    async argv => {
+                        const { nodeId: nodeIdStr, maxSubscriptionInterval, minSubscriptionInterval } = argv;
+                        await theNode.start();
+                        if (theNode.commissioningController === undefined) {
+                            throw new Error("CommissioningController not initialized");
+                        }
+                        let nodeIds = theNode.commissioningController.getCommissionedNodes();
+
+                        const cmdNodeId = NodeId(BigInt(nodeIdStr));
+                        nodeIds = nodeIds.filter(nodeId => nodeId === cmdNodeId);
+                        if (nodeIds.length) {
+                            throw new Error(`Node ${nodeIdStr} already known`);
+                        }
+
+                        await theNode.commissioningController.node.peers.forAddress(
+                            theNode.commissioningController.fabric.addressOf(cmdNodeId),
+                        );
+
+                        const autoSubscribe = minSubscriptionInterval !== undefined;
+
+                        const node = await theNode.commissioningController.getNode(cmdNodeId);
+                        node.connect({
+                            autoSubscribe,
+                            subscribeMinIntervalFloorSeconds: autoSubscribe ? minSubscriptionInterval : undefined,
+                            subscribeMaxIntervalCeilingSeconds: autoSubscribe ? maxSubscriptionInterval : undefined,
+                            ...createDiagnosticCallbacks(),
+                        });
+                    },
+                )
                 .command(
                     "ota",
                     "OTA update operations for nodes",
                     yargs =>
                         yargs
+                            .command(
+                                "known [node-id]",
+                                "List which OTA updates are known to be available for commissioned nodes. A first query by the provider must have happened for this to be filled.",
+                                yargs => {
+                                    return yargs
+                                        .positional("node-id", {
+                                            describe: "Node ID to check for updates",
+                                            type: "string",
+                                            default: undefined,
+                                        })
+                                        .option("local", {
+                                            describe: "include local update files",
+                                            type: "boolean",
+                                            default: false,
+                                        });
+                                },
+                                async argv => {
+                                    const { nodeId: nodeIdStr, local } = argv;
+
+                                    await theNode.start();
+                                    if (theNode.commissioningController === undefined) {
+                                        throw new Error("CommissioningController not initialized");
+                                    }
+
+                                    let peerToCheck: ClientNode | undefined = undefined;
+                                    if (nodeIdStr !== undefined) {
+                                        const nodeId = NodeId(BigInt(nodeIdStr));
+                                        peerToCheck = (await theNode.commissioningController.getNode(nodeId))?.node;
+                                    }
+
+                                    const updatesAvailable = await theNode.commissioningController.otaProvider.act(
+                                        agent =>
+                                            agent
+                                                .get(SoftwareUpdateManager)
+                                                .queryUpdates({ peerToCheck, includeStoredUpdates: local }),
+                                    );
+
+                                    if (updatesAvailable.length) {
+                                        console.log(`OTA updates available for ${updatesAvailable.length} nodes:`);
+                                        for (const { peerAddress, info } of updatesAvailable) {
+                                            console.log(
+                                                peerAddress,
+                                                `: new Version: ${info.softwareVersion} (${info.softwareVersionString})`,
+                                            );
+                                        }
+                                    } else {
+                                        console.log("No OTA updates available.");
+                                    }
+                                },
+                            )
                             .command(
                                 "check <node-id>",
                                 "Check for OTA updates for a commissioned node",
@@ -261,10 +369,15 @@ export default function commands(theNode: MatterNode) {
                                             type: "string",
                                             choices: ["prod", "test"],
                                             default: "prod",
+                                        })
+                                        .option("local", {
+                                            describe: "include local update files",
+                                            type: "boolean",
+                                            default: false,
                                         });
                                 },
                                 async argv => {
-                                    const { nodeId: nodeIdStr, mode } = argv;
+                                    const { nodeId: nodeIdStr, mode, local } = argv;
                                     const isProduction = mode === "prod";
 
                                     await theNode.start();
@@ -302,12 +415,13 @@ export default function commands(theNode: MatterNode) {
                                     );
                                     console.log(`  DCL Mode: ${isProduction ? "production" : "test"}\n`);
 
-                                    const updateInfo = await theNode.otaService.checkForUpdate(
-                                        basicInfo.vendorId as VendorId,
-                                        basicInfo.productId as number,
-                                        basicInfo.softwareVersion as number,
+                                    const updateInfo = await theNode.otaService.checkForUpdate({
+                                        vendorId: basicInfo.vendorId as VendorId,
+                                        productId: basicInfo.productId as number,
+                                        currentSoftwareVersion: basicInfo.softwareVersion as number,
+                                        includeStoredUpdates: local,
                                         isProduction,
-                                    );
+                                    });
 
                                     if (updateInfo) {
                                         console.log("✓ Update available!");
@@ -350,10 +464,15 @@ export default function commands(theNode: MatterNode) {
                                             describe: "Force download even if update is already stored locally",
                                             type: "boolean",
                                             default: false,
+                                        })
+                                        .option("local", {
+                                            describe: "include local update files",
+                                            type: "boolean",
+                                            default: false,
                                         });
                                 },
                                 async argv => {
-                                    const { nodeId: nodeIdStr, mode, force } = argv;
+                                    const { nodeId: nodeIdStr, mode, force, local } = argv;
                                     const isProduction = mode === "prod";
                                     const forceDownload = force === true;
 
@@ -392,12 +511,13 @@ export default function commands(theNode: MatterNode) {
                                     );
                                     console.log(`  DCL Mode: ${isProduction ? "production" : "test"}\n`);
 
-                                    const updateInfo = await theNode.otaService.checkForUpdate(
-                                        basicInfo.vendorId as VendorId,
-                                        basicInfo.productId as number,
-                                        basicInfo.softwareVersion as number,
+                                    const updateInfo = await theNode.otaService.checkForUpdate({
+                                        vendorId: basicInfo.vendorId as VendorId,
+                                        productId: basicInfo.productId as number,
+                                        currentSoftwareVersion: basicInfo.softwareVersion as number,
+                                        includeStoredUpdates: local,
                                         isProduction,
-                                    );
+                                    });
 
                                     if (!updateInfo) {
                                         console.log("No updates available. Device is up to date.");
@@ -427,6 +547,144 @@ export default function commands(theNode: MatterNode) {
                                     );
                                 },
                             )
+                            .command(
+                                "apply <node-id>",
+                                "Apply OTA update for a commissioned node",
+                                yargs => {
+                                    return yargs
+                                        .positional("node-id", {
+                                            describe: "Node ID to download update for",
+                                            type: "string",
+                                            demandOption: true,
+                                        })
+                                        .option("mode", {
+                                            describe: "DCL mode (prod or test)",
+                                            type: "string",
+                                            choices: ["prod", "test"],
+                                            default: "prod",
+                                        })
+                                        .option("force", {
+                                            describe: "Force download even if update is already stored locally",
+                                            type: "boolean",
+                                            default: false,
+                                        })
+                                        .option("local", {
+                                            describe: "Apply update from local file",
+                                            type: "boolean",
+                                            default: false,
+                                        });
+                                },
+                                async argv => {
+                                    const { nodeId: nodeIdStr, mode, force, local } = argv;
+                                    const isProduction = mode === "prod";
+                                    const forceDownload = force === true;
+
+                                    await theNode.start();
+
+                                    if (theNode.commissioningController === undefined) {
+                                        throw new Error("CommissioningController not initialized");
+                                    }
+
+                                    const nodeId = NodeId(BigInt(nodeIdStr));
+                                    const nodeDetails = theNode.commissioningController
+                                        .getCommissionedNodesDetails()
+                                        .find(nd => nd.nodeId === nodeId);
+                                    const basicInfo = nodeDetails?.deviceData?.basicInformation;
+                                    if (!basicInfo) {
+                                        throw new Error(`Node ${nodeIdStr} has no basic information available`);
+                                    }
+                                    if (
+                                        basicInfo.vendorId === undefined ||
+                                        basicInfo.productId === undefined ||
+                                        basicInfo.softwareVersion === undefined
+                                    ) {
+                                        throw new Error(
+                                            `Node ${nodeIdStr} is missing required basic information for OTA check`,
+                                        );
+                                    }
+
+                                    console.log(`Checking for OTA updates for node ${nodeIdStr}...`);
+                                    console.log(
+                                        `  Vendor ID: ${Diagnostic.hex(basicInfo.vendorId as VendorId, 4).toUpperCase()}`,
+                                    );
+                                    console.log(
+                                        `  Product ID: ${Diagnostic.hex(basicInfo.productId as number, 4).toUpperCase()}`,
+                                    );
+                                    console.log(
+                                        `  Current Software Version: ${basicInfo.softwareVersion} (${basicInfo.softwareVersionString})`,
+                                    );
+                                    console.log(`  DCL Mode: ${isProduction ? "production" : "test"}\n`);
+
+                                    const localUpdates = await theNode.otaService.find({
+                                        vendorId: basicInfo.vendorId as VendorId,
+                                        productId: basicInfo.productId as number,
+                                        currentVersion: basicInfo.softwareVersion as number,
+                                    });
+
+                                    if (local && !localUpdates.length) {
+                                        console.log("No applicable updates available in local storage.");
+                                        return;
+                                    }
+
+                                    const updateInfo = await theNode.otaService.checkForUpdate({
+                                        vendorId: basicInfo.vendorId as VendorId,
+                                        productId: basicInfo.productId as number,
+                                        currentSoftwareVersion: basicInfo.softwareVersion as number,
+                                        includeStoredUpdates: local,
+                                        isProduction,
+                                    });
+
+                                    let updateVersion: number;
+                                    if (!updateInfo && !local) {
+                                        console.log("No updates available in DCL. Device is up to date.");
+                                        return;
+                                    } else if (updateInfo) {
+                                        console.log("Update found:");
+                                        console.log(
+                                            `  New Version: ${updateInfo.softwareVersion} (${updateInfo.softwareVersionString})`,
+                                        );
+                                        console.log(`  OTA URL: ${updateInfo.otaUrl}`);
+                                        if (updateInfo.otaFileSize) {
+                                            const sizeKB = Number(updateInfo.otaFileSize) / 1024;
+                                            console.log(`  File Size: ${sizeKB.toFixed(2)} KB`);
+                                        }
+
+                                        console.log("\nDownloading update...");
+                                        const fd = await theNode.otaService.downloadUpdate(
+                                            updateInfo,
+                                            isProduction,
+                                            forceDownload,
+                                        );
+
+                                        updateVersion = updateInfo.softwareVersion;
+
+                                        console.log(
+                                            `✓ Update to version ${updateVersion} (${updateInfo.softwareVersionString}) downloaded and stored successfully: ${fd.text}`,
+                                        );
+                                    } else {
+                                        updateVersion = localUpdates[0].softwareVersion;
+                                        console.log(
+                                            `Update to version ${updateVersion} (${localUpdates[0].softwareVersionString}) found in local storage: ${localUpdates[0].filename}`,
+                                        );
+                                    }
+
+                                    const node = theNode.commissioningController.getPairedNode(nodeId);
+                                    if (node === undefined) {
+                                        throw new Error(`Node ${nodeIdStr} not connected`);
+                                    }
+
+                                    await theNode.commissioningController.otaProvider.act(agent => {
+                                        return agent
+                                            .get(SoftwareUpdateManager)
+                                            .forceUpdate(
+                                                PeerAddress({ nodeId, fabricIndex: FabricIndex(1) }),
+                                                basicInfo.vendorId as VendorId,
+                                                basicInfo.productId as number,
+                                                updateVersion,
+                                            );
+                                    });
+                                },
+                            )
                             .demandCommand(1, "Please specify an OTA subcommand"),
                     async (argv: any) => {
                         argv.unhandled = true;

package/dist/esm/util/String.js

@@ -1,12 +0,0 @@
-/**
- * @license
- * Copyright 2022-2025 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-function camelize(str) {
-  return str.charAt(0).toLowerCase() + str.slice(1);
-}
-export {
-  camelize
-};
-//# sourceMappingURL=String.js.map

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

@@ -1,6 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/util/String.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMO,SAAS,SAAS,KAAa;AAClC,SAAO,IAAI,OAAO,CAAC,EAAE,YAAY,IAAI,IAAI,MAAM,CAAC;AACpD;",
-  "names": []
-}

package/src/util/String.ts

@@ -1,9 +0,0 @@
-/**
- * @license
- * Copyright 2022-2025 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-
-export function camelize(str: string) {
-    return str.charAt(0).toLowerCase() + str.slice(1);
-}