@matter/examples 0.15.1 → 0.15.2-alpha.0-20250704-2715344f0

package/dist/esm/control-onoff/OnOffController.js

@@ -0,0 +1,56 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ServerNode } from "@matter/main";
+import { OnOffClient } from "@matter/main/behaviors/on-off";
+const controller = await ServerNode.create();
+const [, , command, ...args] = process.argv.slice(2);
+switch (command) {
+  case "commission":
+    if (controller.nodes.get("device")) {
+      die("There is already a device commissioned");
+    }
+    if (args.length !== 1) {
+      die(`Usage: ${process.argv[0]} commission <pairingcode>`);
+    }
+    const [pairingCode] = args;
+    await controller.nodes.commission({ id: "device", pairingCode });
+    break;
+  case "toggle":
+    {
+      const endpointNo = Number.parseInt(args[0]);
+      if (args.length !== 1 || Number.isNaN(endpointNo)) {
+        die(`Usage: ${process.argv[0]} toggle <endpoint number>`);
+      }
+      const node = controller.nodes.get("device");
+      if (node === void 0) {
+        die("Cannot toggle because there is no commissioned device");
+      }
+      const endpoint = node.parts.get(endpointNo);
+      if (endpoint === void 0) {
+        die(`Cannot toggle because endpoint ${endpointNo} does not exist`);
+      }
+      await endpoint.commandsOf(OnOffClient).toggle();
+    }
+    break;
+  case "decommission":
+    {
+      const node = controller.nodes.get("device");
+      if (node === void 0) {
+        die("Cannot decommission because there is no commissioned device");
+      }
+      await node.delete();
+    }
+    break;
+  default:
+    die(
+      `Unsupported command ${process.argv[1] ?? "(none)"}.  Supported commands: commission, toggle, decommission`
+    );
+}
+function die(message) {
+  console.log(message);
+  process.exit(1);
+}
+//# sourceMappingURL=OnOffController.js.map

package/dist/esm/control-onoff/OnOffController.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/control-onoff/OnOffController.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAYA,SAAS,kBAAkB;AAC3B,SAAS,mBAAmB;AAG5B,MAAM,aAAa,MAAM,WAAW,OAAO;AAE3C,MAAM,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,IAAI,QAAQ,KAAK,MAAM,CAAC;AAEnD,QAAQ,SAAS;AAAA,EACb,KAAK;AAED,QAAI,WAAW,MAAM,IAAI,QAAQ,GAAG;AAChC,UAAI,wCAAwC;AAAA,IAChD;AACA,QAAI,KAAK,WAAW,GAAG;AACnB,UAAI,UAAU,QAAQ,KAAK,CAAC,CAAC,2BAA2B;AAAA,IAC5D;AACA,UAAM,CAAC,WAAW,IAAI;AAGtB,UAAM,WAAW,MAAM,WAAW,EAAE,IAAI,UAAU,YAAY,CAAC;AAE/D;AAAA,EAEJ,KAAK;AACD;AAEI,YAAM,aAAa,OAAO,SAAS,KAAK,CAAC,CAAC;AAC1C,UAAI,KAAK,WAAW,KAAK,OAAO,MAAM,UAAU,GAAG;AAC/C,YAAI,UAAU,QAAQ,KAAK,CAAC,CAAC,2BAA2B;AAAA,MAC5D;AACA,YAAM,OAAO,WAAW,MAAM,IAAI,QAAQ;AAC1C,UAAI,SAAS,QAAW;AACpB,YAAI,uDAAuD;AAAA,MAC/D;AACA,YAAM,WAAW,KAAK,MAAM,IAAI,UAAU;AAC1C,UAAI,aAAa,QAAW;AACxB,YAAI,kCAAkC,UAAU,iBAAiB;AAAA,MACrE;AAGA,YAAM,SAAS,WAAW,WAAW,EAAE,OAAO;AAAA,IAClD;AAEA;AAAA,EAEJ,KAAK;AACD;AAEI,YAAM,OAAO,WAAW,MAAM,IAAI,QAAQ;AAC1C,UAAI,SAAS,QAAW;AACpB,YAAI,6DAA6D;AAAA,MACrE;AAGA,YAAM,KAAK,OAAO;AAAA,IACtB;AACA;AAAA,EAEJ;AACI;AAAA,MACI,uBAAuB,QAAQ,KAAK,CAAC,KAAK,QAAQ;AAAA,IACtD;AACR;AAKA,SAAS,IAAI,SAAwB;AACjC,UAAQ,IAAI,OAAO;AACnB,UAAQ,KAAK,CAAC;AAClB;",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@matter/examples",
-    "version": "0.15.1",
+    "version": "0.15.2-alpha.0-20250704-2715344f0",
     "description": "Matter.js examples and reference implementations",
     "keywords": [
         "iot",
@@ -55,14 +55,14 @@
         "matter-controller": "dist/esm/controller/ControllerNode.js"
     },
     "dependencies": {
-        "@matter/main": "0.15.1",
-        "@matter/nodejs": "0.15.1",
-        "@matter/tools": "0.15.1",
-        "@project-chip/matter.js": "0.15.1",
+        "@matter/main": "0.15.2-alpha.0-20250704-2715344f0",
+        "@matter/nodejs": "0.15.2-alpha.0-20250704-2715344f0",
+        "@matter/tools": "0.15.2-alpha.0-20250704-2715344f0",
+        "@project-chip/matter.js": "0.15.2-alpha.0-20250704-2715344f0",
         "esbuild": "^0.25.2"
     },
     "optionalDependencies": {
-        "@matter/nodejs-ble": "0.15.1"
+        "@matter/nodejs-ble": "0.15.2-alpha.0-20250704-2715344f0"
     },
     "engines": {
         "node": ">=18.0.0"

package/src/control-onoff/OnOffController.ts

@@ -0,0 +1,84 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * This is simple command line application that demonstrates device control using the @matter/node API.
+ *
+ * This API is a work in progress and is not yet fully implemented.
+ */
+
+import { ServerNode } from "@matter/main";
+import { OnOffClient } from "@matter/main/behaviors/on-off";
+
+// Create the controller
+const controller = await ServerNode.create();
+
+const [, , command, ...args] = process.argv.slice(2);
+
+switch (command) {
+    case "commission":
+        // Validation
+        if (controller.nodes.get("device")) {
+            die("There is already a device commissioned");
+        }
+        if (args.length !== 1) {
+            die(`Usage: ${process.argv[0]} commission <pairingcode>`);
+        }
+        const [pairingCode] = args;
+
+        // This is the actual commissioning
+        await controller.nodes.commission({ id: "device", pairingCode });
+
+        break;
+
+    case "toggle":
+        {
+            // Validation
+            const endpointNo = Number.parseInt(args[0]);
+            if (args.length !== 1 || Number.isNaN(endpointNo)) {
+                die(`Usage: ${process.argv[0]} toggle <endpoint number>`);
+            }
+            const node = controller.nodes.get("device");
+            if (node === undefined) {
+                die("Cannot toggle because there is no commissioned device");
+            }
+            const endpoint = node.parts.get(endpointNo);
+            if (endpoint === undefined) {
+                die(`Cannot toggle because endpoint ${endpointNo} does not exist`);
+            }
+
+            // Invocation
+            await endpoint.commandsOf(OnOffClient).toggle();
+        }
+
+        break;
+
+    case "decommission":
+        {
+            // Validation
+            const node = controller.nodes.get("device");
+            if (node === undefined) {
+                die("Cannot decommission because there is no commissioned device");
+            }
+
+            // Decommission
+            await node.delete();
+        }
+        break;
+
+    default:
+        die(
+            `Unsupported command ${process.argv[1] ?? "(none)"}.  Supported commands: commission, toggle, decommission`,
+        );
+}
+
+/**
+ * Report command line error and exit.
+ */
+function die(message: string): never {
+    console.log(message);
+    process.exit(1);
+}

package/src/control-onoff/README.md

@@ -0,0 +1,6 @@
+# Simple light controller
+
+This is an example of a simple Matter controller.  A "controller" is a device that can add another device to a Matter
+network.  This process is called "commissioning".
+
+In this case the device can add another device that supports the "on/off" cluster and toggle it on or off.