@matter/examples 0.11.0-alpha.0-20241005-e3e4e4a7a

package/dist/esm/examples/ComposedDeviceNode.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Endpoint, EndpointServer, Environment, ServerNode, StorageService, Time } from "@matter/main";
+import { OnOffLightDevice } from "@matter/main/devices/on-off-light";
+import { OnOffPlugInUnitDevice } from "@matter/main/devices/on-off-plug-in-unit";
+import { logEndpoint } from "@matter/protocol";
+import { DeviceTypeId, VendorId } from "@matter/types";
+import { execSync } from "child_process";
+const { isSocket, deviceName, vendorName, passcode, discriminator, vendorId, productName, productId, port, uniqueId } = await getConfiguration();
+const server = await ServerNode.create({
+  // Required: Give the Node a unique ID which is used to store the state of this node
+  id: uniqueId,
+  // Provide Network relevant configuration like the port
+  // Optional when operating only one device on a host, Default port is 5540
+  network: {
+    port
+  },
+  // Provide Commissioning relevant settings
+  // Optional for development/testing purposes
+  commissioning: {
+    passcode,
+    discriminator
+  },
+  // Provide Node announcement settings
+  // Optional: If Ommitted some development defaults are used
+  productDescription: {
+    name: deviceName,
+    deviceType: DeviceTypeId(isSocket[0] ? OnOffPlugInUnitDevice.deviceType : OnOffLightDevice.deviceType)
+  },
+  // Provide defaults for the BasicInformation cluster on the Root endpoint
+  // Optional: If Omitted some development defaults are used
+  basicInformation: {
+    vendorName,
+    vendorId: VendorId(vendorId),
+    nodeLabel: productName,
+    productName,
+    productLabel: productName,
+    productId,
+    serialNumber: `matterjs-${uniqueId}`,
+    uniqueId
+  }
+});
+for (let idx = 0; idx < isSocket.length; idx++) {
+  const i = idx + 1;
+  const isASocket = isSocket[idx];
+  const endpoint = new Endpoint(isASocket ? OnOffPlugInUnitDevice : OnOffLightDevice, { id: `onoff-${i}` });
+  await server.add(endpoint);
+  endpoint.events.identify.startIdentifying.on(() => {
+    console.log(`Run identify logic for sub device ${i}, ideally blink a light every 0.5s ...`);
+  });
+  endpoint.events.identify.stopIdentifying.on(() => {
+    console.log(`Stop identify logic for sub device ${i}...`);
+  });
+  endpoint.events.onOff.onOff$Changed.on((value) => {
+    executeCommand(value ? `on${i}` : `off${i}`);
+    console.log(`OnOff ${i} is now ${value ? "ON" : "OFF"}`);
+  });
+}
+logEndpoint(EndpointServer.forEndpoint(server));
+await server.run();
+function executeCommand(scriptParamName) {
+  const script = Environment.default.vars.string(scriptParamName);
+  if (script === void 0) return void 0;
+  console.log(`${scriptParamName}: ${execSync(script).toString().slice(0, -1)}`);
+}
+async function getConfiguration() {
+  const environment = Environment.default;
+  const storageService = environment.get(StorageService);
+  console.log(`Storage location: ${storageService.location} (Directory)`);
+  console.log(
+    '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.'
+  );
+  const deviceStorage = (await storageService.open("device")).createContext("data");
+  const isSocket2 = Array();
+  const numDevices = environment.vars.number("num") || 2;
+  if (await deviceStorage.has("isSocket")) {
+    console.log(`Device types found in storage. --type parameter is ignored.`);
+    (await deviceStorage.get("isSocket")).forEach((type) => isSocket2.push(type));
+  }
+  for (let i = 1; i < numDevices; i++) {
+    if (isSocket2[i - 1] !== void 0) continue;
+    isSocket2.push(environment.vars.string(`type${i}`) === "socket");
+  }
+  const deviceName2 = "Matter test device";
+  const vendorName2 = "matter-node.js";
+  const passcode2 = environment.vars.number("passcode") ?? await deviceStorage.get("passcode", 20202021);
+  const discriminator2 = environment.vars.number("discriminator") ?? await deviceStorage.get("discriminator", 3840);
+  const vendorId2 = environment.vars.number("vendorid") ?? await deviceStorage.get("vendorid", 65521);
+  const productName2 = `node-matter OnOff ${isSocket2 ? "Socket" : "Light"}`;
+  const productId2 = environment.vars.number("productid") ?? await deviceStorage.get("productid", 32768);
+  const port2 = environment.vars.number("port") ?? 5540;
+  const uniqueId2 = environment.vars.string("uniqueid") ?? await deviceStorage.get("uniqueid", Time.nowMs().toString());
+  await deviceStorage.set({
+    passcode: passcode2,
+    discriminator: discriminator2,
+    vendorid: vendorId2,
+    productid: productId2,
+    isSocket: isSocket2,
+    uniqueid: uniqueId2
+  });
+  return {
+    isSocket: isSocket2,
+    deviceName: deviceName2,
+    vendorName: vendorName2,
+    passcode: passcode2,
+    discriminator: discriminator2,
+    vendorId: vendorId2,
+    productName: productName2,
+    productId: productId2,
+    port: port2,
+    uniqueId: uniqueId2
+  };
+}
+//# sourceMappingURL=ComposedDeviceNode.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/examples/ComposedDeviceNode.ts"],
+  "mappings": "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",
+  "names": ["isSocket", "deviceName", "vendorName", "passcode", "discriminator", "vendorId", "productName", "productId", "port", "uniqueId"]
+}

package/dist/esm/examples/ControllerNode.js

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Environment, Logger, singleton, StorageService, Time } from "@matter/main";
+import { NodeJsBle } from "@matter/nodejs-ble";
+import { NodeId } from "@matter/types";
+import { CommissioningController } from "@project-chip/matter.js";
+import { Ble } from "@project-chip/matter.js/ble";
+import {
+  BasicInformationCluster,
+  DescriptorCluster,
+  GeneralCommissioning,
+  OnOff
+} from "@project-chip/matter.js/cluster";
+import { ManualPairingCodeCodec } from "@project-chip/matter.js/schema";
+import { NodeStateInformation } from "../../../matter.js/dist/esm/device/PairedNode.js";
+const logger = Logger.get("Controller");
+const environment = Environment.default;
+if (environment.vars.get("ble")) {
+  Ble.get = singleton(
+    () => new NodeJsBle({
+      hciId: environment.vars.number("ble-hci-id")
+    })
+  );
+}
+const storageService = environment.get(StorageService);
+console.log(`Storage location: ${storageService.location} (Directory)`);
+logger.info(
+  '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 controllerStorage = (await storageService.open("controller")).createContext("data");
+    const ip = await controllerStorage.has("ip") ? await controllerStorage.get("ip") : environment.vars.string("ip");
+    const port = await controllerStorage.has("port") ? await controllerStorage.get("port") : environment.vars.number("port");
+    const uniqueId = await controllerStorage.has("uniqueid") ? await controllerStorage.get("uniqueid") : environment.vars.string("uniqueid") ?? Time.nowMs().toString();
+    await controllerStorage.set("uniqueid", uniqueId);
+    const pairingCode = environment.vars.string("pairingcode");
+    let longDiscriminator, setupPin, shortDiscriminator;
+    if (pairingCode !== void 0) {
+      const pairingCodeCodec = ManualPairingCodeCodec.decode(pairingCode);
+      shortDiscriminator = pairingCodeCodec.shortDiscriminator;
+      longDiscriminator = void 0;
+      setupPin = pairingCodeCodec.passcode;
+      logger.debug(`Data extracted from pairing code: ${Logger.toJSON(pairingCodeCodec)}`);
+    } else {
+      longDiscriminator = environment.vars.number("longDiscriminator") ?? await controllerStorage.get("longDiscriminator", 3840);
+      if (longDiscriminator > 4095) throw new Error("Discriminator value must be less than 4096");
+      setupPin = environment.vars.number("pin") ?? await controllerStorage.get("pin", 20202021);
+    }
+    if (shortDiscriminator === void 0 && longDiscriminator === void 0 || setupPin === void 0) {
+      throw new Error(
+        "Please specify the longDiscriminator of the device to commission with -longDiscriminator or provide a valid passcode with -passcode"
+      );
+    }
+    const commissioningOptions = {
+      regulatoryLocation: GeneralCommissioning.RegulatoryLocationType.IndoorOutdoor,
+      regulatoryCountryCode: "XX"
+    };
+    let ble = false;
+    if (environment.vars.get("ble")) {
+      ble = true;
+      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 = {
+          wifiSsid,
+          wifiCredentials
+        };
+      }
+      if (threadNetworkName !== void 0 && threadOperationalDataset !== void 0) {
+        logger.info(`Registering Commissioning over BLE with Thread: ${threadNetworkName}`);
+        commissioningOptions.threadNetwork = {
+          networkName: threadNetworkName,
+          operationalDataset: threadOperationalDataset
+        };
+      }
+    }
+    const commissioningController = new CommissioningController({
+      environment: {
+        environment,
+        id: uniqueId
+      },
+      autoConnect: false
+    });
+    await commissioningController.start();
+    if (!commissioningController.isCommissioned()) {
+      const options = {
+        commissioning: commissioningOptions,
+        discovery: {
+          knownAddress: ip !== void 0 && port !== void 0 ? { ip, port, type: "udp" } : void 0,
+          identifierData: longDiscriminator !== void 0 ? { longDiscriminator } : shortDiscriminator !== void 0 ? { shortDiscriminator } : {},
+          discoveryCapabilities: {
+            ble
+          }
+        },
+        passcode: setupPin
+      };
+      logger.info(`Commissioning ... ${Logger.toJSON(options)}`);
+      const nodeId = await commissioningController.commissionNode(options);
+      console.log(`Commissioning successfully done with nodeId ${nodeId}`);
+    }
+    try {
+      const nodes = commissioningController.getCommissionedNodes();
+      console.log("Found commissioned nodes:", Logger.toJSON(nodes));
+      const nodeId = NodeId(environment.vars.number("nodeid") ?? nodes[0]);
+      if (!nodes.includes(nodeId)) {
+        throw new Error(`Node ${nodeId} not found in commissioned nodes`);
+      }
+      const node = await commissioningController.connectNode(nodeId, {
+        attributeChangedCallback: (peerNodeId, { path: { nodeId: nodeId2, clusterId, endpointId, attributeName }, value }) => console.log(
+          `attributeChangedCallback ${peerNodeId}: Attribute ${nodeId2}/${endpointId}/${clusterId}/${attributeName} changed to ${Logger.toJSON(
+            value
+          )}`
+        ),
+        eventTriggeredCallback: (peerNodeId, { path: { nodeId: nodeId2, clusterId, endpointId, eventName }, events }) => console.log(
+          `eventTriggeredCallback ${peerNodeId}: Event ${nodeId2}/${endpointId}/${clusterId}/${eventName} triggered with ${Logger.toJSON(
+            events
+          )}`
+        ),
+        stateInformationCallback: (peerNodeId, info2) => {
+          switch (info2) {
+            case NodeStateInformation.Connected:
+              console.log(`stateInformationCallback ${peerNodeId}: Node ${nodeId} connected`);
+              break;
+            case NodeStateInformation.Disconnected:
+              console.log(`stateInformationCallback ${peerNodeId}: Node ${nodeId} disconnected`);
+              break;
+            case NodeStateInformation.Reconnecting:
+              console.log(`stateInformationCallback ${peerNodeId}: Node ${nodeId} reconnecting`);
+              break;
+            case NodeStateInformation.WaitingForDeviceDiscovery:
+              console.log(
+                `stateInformationCallback ${peerNodeId}: Node ${nodeId} waiting for device discovery`
+              );
+              break;
+            case NodeStateInformation.StructureChanged:
+              console.log(`stateInformationCallback ${peerNodeId}: Node ${nodeId} structure changed`);
+              break;
+            case NodeStateInformation.Decommissioned:
+              console.log(`stateInformationCallback ${peerNodeId}: Node ${nodeId} decommissioned`);
+              break;
+          }
+        }
+      });
+      node.logStructure();
+      const descriptor = node.getRootClusterClient(DescriptorCluster);
+      if (descriptor !== void 0) {
+        console.log(await descriptor.attributes.deviceTypeList.get());
+        console.log(await descriptor.getServerListAttribute());
+      } else {
+        console.log("No Descriptor Cluster found. This should never happen!");
+      }
+      const info = node.getRootClusterClient(BasicInformationCluster);
+      if (info !== void 0) {
+        console.log(await info.getProductNameAttribute());
+      } else {
+        console.log("No BasicInformation Cluster found. This should never happen!");
+      }
+      const devices = node.getDevices();
+      if (devices[0] && devices[0].number === 1) {
+        const onOff = devices[0].getClusterClient(OnOff.Complete);
+        if (onOff !== void 0) {
+          let onOffStatus = await onOff.getOnOffAttribute();
+          console.log("initial onOffStatus", onOffStatus);
+          onOff.addOnOffAttributeListener((value) => {
+            console.log("subscription onOffStatus", value);
+            onOffStatus = value;
+          });
+          setInterval(() => {
+            onOff.toggle().then(() => {
+              onOffStatus = !onOffStatus;
+              console.log("onOffStatus", onOffStatus);
+            }).catch((error) => logger.error(error));
+          }, 6e4);
+        }
+      }
+    } finally {
+      setTimeout(() => process.exit(0), 1e6);
+    }
+  }
+}
+new ControllerNode().start().catch((error) => logger.error(error));
+//# sourceMappingURL=ControllerNode.js.map

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

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

package/dist/esm/examples/DeviceNode.js

@@ -0,0 +1,130 @@
+#!/usr/bin/env node
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import {
+  DeviceTypeId,
+  Endpoint,
+  EndpointServer,
+  Environment,
+  ServerNode,
+  StorageService,
+  Time,
+  VendorId
+} from "@matter/main";
+import { OnOffLightDevice } from "@matter/main/devices/on-off-light";
+import { OnOffPlugInUnitDevice } from "@matter/main/devices/on-off-plug-in-unit";
+import { logEndpoint } from "@matter/main/protocol";
+import { execSync } from "child_process";
+async function main() {
+  const {
+    isSocket,
+    deviceName,
+    vendorName,
+    passcode,
+    discriminator,
+    vendorId,
+    productName,
+    productId,
+    port,
+    uniqueId
+  } = await getConfiguration();
+  const server = await ServerNode.create({
+    // Required: Give the Node a unique ID which is used to store the state of this node
+    id: uniqueId,
+    // Provide Network relevant configuration like the port
+    // Optional when operating only one device on a host, Default port is 5540
+    network: {
+      port
+    },
+    // Provide Commissioning relevant settings
+    // Optional for development/testing purposes
+    commissioning: {
+      passcode,
+      discriminator
+    },
+    // Provide Node announcement settings
+    // Optional: If Ommitted some development defaults are used
+    productDescription: {
+      name: deviceName,
+      deviceType: DeviceTypeId(isSocket ? OnOffPlugInUnitDevice.deviceType : OnOffLightDevice.deviceType)
+    },
+    // Provide defaults for the BasicInformation cluster on the Root endpoint
+    // Optional: If Omitted some development defaults are used
+    basicInformation: {
+      vendorName,
+      vendorId: VendorId(vendorId),
+      nodeLabel: productName,
+      productName,
+      productLabel: productName,
+      productId,
+      serialNumber: `matterjs-${uniqueId}`,
+      uniqueId
+    }
+  });
+  const endpoint = new Endpoint(isSocket ? OnOffPlugInUnitDevice : OnOffLightDevice, { id: "onoff" });
+  await server.add(endpoint);
+  endpoint.events.identify.startIdentifying.on(() => {
+    console.log(`Run identify logic, ideally blink a light every 0.5s ...`);
+  });
+  endpoint.events.identify.stopIdentifying.on(() => {
+    console.log(`Stop identify logic ...`);
+  });
+  endpoint.events.onOff.onOff$Changed.on((value) => {
+    executeCommand(value ? "on" : "off");
+    console.log(`OnOff is now ${value ? "ON" : "OFF"}`);
+  });
+  logEndpoint(EndpointServer.forEndpoint(server));
+  await server.run();
+}
+main().catch((error) => console.error(error));
+function executeCommand(scriptParamName) {
+  const script = Environment.default.vars.string(scriptParamName);
+  if (script === void 0) return void 0;
+  console.log(`${scriptParamName}: ${execSync(script).toString().slice(0, -1)}`);
+}
+async function getConfiguration() {
+  const environment = Environment.default;
+  const storageService = environment.get(StorageService);
+  console.log(`Storage location: ${storageService.location} (Directory)`);
+  console.log(
+    '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.'
+  );
+  const deviceStorage = (await storageService.open("device")).createContext("data");
+  const isSocket = await deviceStorage.get("isSocket", environment.vars.get("type") === "socket");
+  if (await deviceStorage.has("isSocket")) {
+    console.log(`Device type ${isSocket ? "socket" : "light"} found in storage. --type parameter is ignored.`);
+  }
+  const deviceName = "Matter test device";
+  const vendorName = "matter-node.js";
+  const passcode = environment.vars.number("passcode") ?? await deviceStorage.get("passcode", 20202021);
+  const discriminator = environment.vars.number("discriminator") ?? await deviceStorage.get("discriminator", 3840);
+  const vendorId = environment.vars.number("vendorid") ?? await deviceStorage.get("vendorid", 65521);
+  const productName = `node-matter OnOff ${isSocket ? "Socket" : "Light"}`;
+  const productId = environment.vars.number("productid") ?? await deviceStorage.get("productid", 32768);
+  const port = environment.vars.number("port") ?? 5540;
+  const uniqueId = environment.vars.string("uniqueid") ?? (await deviceStorage.get("uniqueid", Time.nowMs())).toString();
+  await deviceStorage.set({
+    passcode,
+    discriminator,
+    vendorid: vendorId,
+    productid: productId,
+    isSocket,
+    uniqueid: uniqueId
+  });
+  return {
+    isSocket,
+    deviceName,
+    vendorName,
+    passcode,
+    discriminator,
+    vendorId,
+    productName,
+    productId,
+    port,
+    uniqueId
+  };
+}
+//# sourceMappingURL=DeviceNode.js.map

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

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