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

package/dist/esm/examples/DeviceNodeFull.js

@@ -0,0 +1,259 @@
+#!/usr/bin/env node
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import {
+  DeviceTypeId,
+  Endpoint,
+  EndpointServer,
+  Environment,
+  LogLevel,
+  Logger,
+  ServerNode,
+  StorageService,
+  Time,
+  VendorId,
+  logLevelFromString,
+  singleton
+} from "@matter/main";
+import { NetworkCommissioningServer } from "@matter/main/behaviors/network-commissioning";
+import { OnOffServer } from "@matter/main/behaviors/on-off";
+import { NetworkCommissioning } from "@matter/main/clusters";
+import { OnOffLightDevice } from "@matter/main/devices/on-off-light";
+import { OnOffPlugInUnitDevice } from "@matter/main/devices/on-off-plug-in-unit";
+import { RootRequirements } from "@matter/main/endpoints/root";
+import { Ble, FabricAction, logEndpoint } from "@matter/main/protocol";
+import { QrCode } from "@matter/main/types";
+import { createFileLogger } from "@matter/nodejs";
+import { NodeJsBle } from "@matter/nodejs-ble";
+import { execSync } from "child_process";
+import { DummyThreadNetworkCommissioningServer } from "./cluster/DummyThreadNetworkCommissioningServer.js";
+import { DummyWifiNetworkCommissioningServer } from "./cluster/DummyWifiNetworkCommissioningServer.js";
+import {
+  MyFancyOwnFunctionalityBehavior
+} from "./cluster/MyFancyOwnFunctionality.js";
+const environment = Environment.default;
+if (environment.vars.get("ble.enable")) {
+  Ble.get = singleton(
+    () => new NodeJsBle({
+      hciId: environment.vars.number("ble.hciId")
+    })
+  );
+}
+function executeCommand(scriptParamName) {
+  const script = environment.vars.string(scriptParamName);
+  if (script === void 0) return void 0;
+  console.log(`${scriptParamName}: ${execSync(script).toString().slice(0, -1)}`);
+}
+const logFile = environment.vars.string("logfile.filename");
+if (logFile !== void 0) {
+  Logger.addLogger("filelogger", await createFileLogger(logFile), {
+    defaultLogLevel: logLevelFromString(environment.vars.string("logfile.loglevel")) ?? LogLevel.DEBUG
+  });
+}
+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");
+if (await deviceStorage.has("isSocket")) {
+  console.log("Device type found in storage. --type parameter is ignored.");
+}
+const isSocket = await deviceStorage.get("isSocket", environment.vars.string("type") === "socket");
+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
+});
+class OnOffShellExecServer extends OnOffServer {
+  // Intercept the "on" command to the Matter On/Off cluster to print a log message.
+  async on() {
+    executeCommand("on");
+    await super.on();
+  }
+  // This is the functional inverse of on() above.
+  //
+  // For demonstration purposes we update state ourselves rather than deferring to matter.js's default "off" handler
+  // via super.off().
+  async off() {
+    executeCommand("off");
+    this.state.onOff = false;
+  }
+  // Use event handlers to log on/off state reactively, after it changes.
+  initialize() {
+    this.events.onOff$Changed.on((value) => {
+      console.log(`Light is now ${value ? "ON" : "OFF"}`);
+    });
+  }
+}
+class TestGeneralDiagnosticsServer extends RootRequirements.GeneralDiagnosticsServer {
+  initialize() {
+    this.state.testEventTriggersEnabled = true;
+    super.initialize();
+  }
+  testEventTrigger({ enableKey, eventTrigger }) {
+    console.log(`testEventTrigger called on GeneralDiagnostic cluster: ${enableKey} ${eventTrigger}`);
+  }
+}
+class MyFancyOwnFunctionalityServer extends MyFancyOwnFunctionalityBehavior {
+  /** We return the incoming value and store the length of the string in our attribute and send it out as event */
+  myFancyCommand(request) {
+    const { value } = request;
+    this.state.myFancyValue = value.length;
+    this.events.myFancyEvent.emit({ eventValue: value }, this.context);
+    return { response: value };
+  }
+  initialize() {
+    this.state.myFancyValue = -1;
+  }
+}
+const OnOffDevice = isSocket ? vendorId === 65524 ? OnOffPlugInUnitDevice.with(OnOffShellExecServer, MyFancyOwnFunctionalityServer) : OnOffPlugInUnitDevice.with(OnOffShellExecServer) : vendorId === 65524 ? OnOffLightDevice.with(OnOffShellExecServer, MyFancyOwnFunctionalityServer) : OnOffLightDevice.with(OnOffShellExecServer);
+let RootEndpoint = ServerNode.RootEndpoint.with(TestGeneralDiagnosticsServer);
+let wifiOrThreadAdded = false;
+let threadAdded = false;
+if (Ble.enabled) {
+  if (environment.vars.has("ble.wifi.fake")) {
+    RootEndpoint = RootEndpoint.with(DummyWifiNetworkCommissioningServer);
+    wifiOrThreadAdded = true;
+  } else if (environment.vars.has("ble.thread.fake")) {
+    RootEndpoint = RootEndpoint.with(DummyThreadNetworkCommissioningServer);
+    wifiOrThreadAdded = true;
+    threadAdded = true;
+  }
+} else {
+  RootEndpoint = RootEndpoint.with(
+    NetworkCommissioningServer.with(NetworkCommissioning.Feature.EthernetNetworkInterface)
+  );
+}
+const networkId = new Uint8Array(32);
+const server = await ServerNode.create(RootEndpoint, {
+  id: uniqueId,
+  network: {
+    port,
+    discoveryCapabilities: {
+      onIpNetwork: !environment.vars.has("ble.enable"),
+      ble: environment.vars.has("ble.enable")
+    },
+    ble: environment.vars.has("ble.enable")
+    // TODO remove when state init is fixed
+  },
+  commissioning: {
+    passcode,
+    discriminator
+  },
+  productDescription: {
+    name: deviceName,
+    deviceType: DeviceTypeId(OnOffDevice.deviceType)
+  },
+  basicInformation: {
+    vendorName,
+    vendorId: VendorId(vendorId),
+    nodeLabel: productName,
+    productName,
+    productLabel: productName,
+    productId,
+    serialNumber: `node-matter-${uniqueId}`,
+    uniqueId
+  },
+  // @ts-expect-error ... TS do not see the types because both next clusters was added conditionally
+  networkCommissioning: {
+    maxNetworks: 1,
+    interfaceEnabled: true,
+    lastConnectErrorValue: 0,
+    lastNetworkId: wifiOrThreadAdded ? null : networkId,
+    lastNetworkingStatus: wifiOrThreadAdded ? null : NetworkCommissioning.NetworkCommissioningStatus.Success,
+    networks: [{ networkId, connected: !wifiOrThreadAdded }],
+    scanMaxTimeSeconds: wifiOrThreadAdded ? 3 : void 0,
+    connectMaxTimeSeconds: wifiOrThreadAdded ? 3 : void 0,
+    supportedWifiBands: wifiOrThreadAdded && !threadAdded ? [NetworkCommissioning.WiFiBand["2G4"]] : void 0,
+    supportedThreadFeatures: wifiOrThreadAdded && threadAdded ? { isFullThreadDevice: true } : void 0,
+    threadVersion: wifiOrThreadAdded && threadAdded ? 4 : void 0
+    // means: Thread 1.3
+  },
+  myFancyFunctionality: {
+    myFancyValue: 0
+  }
+});
+const endpoint = new Endpoint(OnOffDevice, { id: "onoff" });
+await server.add(endpoint);
+server.lifecycle.commissioned.on(() => console.log("Server was initially commissioned successfully!"));
+server.lifecycle.decommissioned.on(() => console.log("Server was fully decommissioned successfully!"));
+server.lifecycle.online.on(() => console.log("Server is online"));
+server.lifecycle.offline.on(() => console.log("Server is offline"));
+server.events.commissioning.fabricsChanged.on((fabricIndex, fabricAction) => {
+  let action = "";
+  switch (fabricAction) {
+    case FabricAction.Added:
+      action = "added";
+      break;
+    case FabricAction.Removed:
+      action = "removed";
+      break;
+    case FabricAction.Updated:
+      action = "updated";
+      break;
+  }
+  console.log(`Commissioned Fabrics changed event (${action}) for ${fabricIndex} triggered`);
+  console.log(server.state.commissioning.fabrics[fabricIndex]);
+});
+server.events.sessions.opened.on((session) => console.log(`Session opened`, session));
+server.events.sessions.closed.on((session) => console.log(`Session closed`, session));
+server.events.sessions.subscriptionsChanged.on((session) => {
+  console.log(`Session subscriptions changed`, session);
+  console.log(`Status of all sessions`, server.state.sessions.sessions);
+});
+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 ...`);
+});
+logEndpoint(EndpointServer.forEndpoint(server));
+await server.start();
+console.log("Initial Fabrics", server.state.operationalCredentials.fabrics);
+if (!server.lifecycle.isCommissioned) {
+  const { qrPairingCode, manualPairingCode } = server.state.commissioning.pairingCodes;
+  console.log(QrCode.get(qrPairingCode));
+  console.log(`QR Code URL: https://project-chip.github.io/connectedhomeip/qrcode.html?data=${qrPairingCode}`);
+  console.log(`Manual pairing code: ${manualPairingCode}`);
+} else {
+  console.log("Device is already commissioned. Waiting for controllers to connect ...");
+  const onOffValue = endpoint.state.onOff.onOff;
+  console.log(`current OnOff attribute: ${onOffValue}`);
+  if (vendorId === 65524) {
+    await endpoint.set({
+      onOff: {
+        onOff: !onOffValue
+      },
+      // @ts-expect-error Needed because the Fancy cluster is added conditionally, so TS do not get that it's there.
+      myFancyOwnFunctionality: {
+        myFancyValue: 36
+      }
+    });
+  } else {
+    await endpoint.set({
+      onOff: {
+        onOff: !onOffValue
+      }
+    });
+  }
+}
+process.on("SIGINT", () => {
+  server.close().then(() => process.exit(0)).catch((err) => console.error(err));
+});
+//# sourceMappingURL=DeviceNodeFull.js.map

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

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

package/dist/esm/examples/IlluminatedRollerShade.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ServerNode } from "@matter/main";
+import { MovementDirection, WindowCoveringServer } from "@matter/main/behaviors/window-covering";
+import { OnOffLightDevice, OnOffLightRequirements } from "@matter/main/devices/on-off-light";
+import { WindowCoveringDevice } from "@matter/main/devices/window-covering";
+const LiftingWindowCoveringServer = WindowCoveringServer.with("Lift", "AbsolutePosition", "PositionAwareLift");
+class RollerShade extends LiftingWindowCoveringServer {
+  async handleMovement(type, reversed, direction, targetPercent100ths) {
+    console.log(
+      "Move window shade",
+      direction === MovementDirection.Open ? "Open" : "Close",
+      targetPercent100ths !== void 0 ? `${targetPercent100ths / 100}%` : ""
+    );
+    await super.handleMovement(type, reversed, direction, targetPercent100ths);
+  }
+}
+class ValanceLight extends OnOffLightRequirements.OnOffServer {
+  initialize() {
+    this.reactTo(this.events.onOff$Changed, this.#stateChanged);
+  }
+  #stateChanged(value) {
+    console.log(`Valance is now ${value ? "illuminated" : "dark"}`);
+  }
+}
+const node = new ServerNode({
+  id: "excelsior1000",
+  productDescription: {},
+  commissioning: {
+    passcode: 20202021,
+    discriminator: 3840
+  },
+  basicInformation: {
+    vendorName: "Acme Corporation",
+    productName: "Excelsior 1000 EZ-Nite\u2122",
+    vendorId: 65521,
+    productId: 32768,
+    serialNumber: "1234-12345-123"
+  },
+  parts: [
+    {
+      type: WindowCoveringDevice.with(RollerShade),
+      id: "shade"
+    },
+    {
+      type: OnOffLightDevice.with(ValanceLight),
+      id: "valance"
+    }
+  ]
+});
+await node.run();
+//# sourceMappingURL=IlluminatedRollerShade.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/examples/IlluminatedRollerShade.ts"],
+  "mappings": ";AACA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,kBAAkB;AAC3B,SAAS,mBAAiC,4BAA4B;AACtE,SAAS,kBAAkB,8BAA8B;AACzD,SAAS,4BAA4B;AAQrC,MAAM,8BAA8B,qBAAqB,KAAK,QAAQ,oBAAoB,mBAAmB;AAK7G,MAAM,oBAAoB,4BAA4B;AAAA,EAClD,MAAe,eACX,MACA,UACA,WACA,qBACF;AACE,YAAQ;AAAA,MACJ;AAAA,MACA,cAAc,kBAAkB,OAAO,SAAS;AAAA,MAChD,wBAAwB,SAAY,GAAG,sBAAsB,GAAG,MAAM;AAAA,IAC1E;AAGA,UAAM,MAAM,eAAe,MAAM,UAAU,WAAW,mBAAmB;AAAA,EAC7E;AACJ;AAKA,MAAM,qBAAqB,uBAAuB,YAAY;AAAA,EACjD,aAAa;AAClB,SAAK,QAAQ,KAAK,OAAO,eAAe,KAAK,aAAa;AAAA,EAC9D;AAAA,EAEA,cAAc,OAAgB;AAC1B,YAAQ,IAAI,kBAAkB,QAAQ,gBAAgB,MAAM,EAAE;AAAA,EAClE;AACJ;AAKA,MAAM,OAAO,IAAI,WAAW;AAAA,EACxB,IAAI;AAAA,EAEJ,oBAAoB,CAAC;AAAA,EAErB,eAAe;AAAA,IACX,UAAU;AAAA,IACV,eAAe;AAAA,EACnB;AAAA,EAEA,kBAAkB;AAAA,IACd,YAAY;AAAA,IACZ,aAAa;AAAA,IACb,UAAU;AAAA,IACV,WAAW;AAAA,IACX,cAAc;AAAA,EAClB;AAAA,EAEA,OAAO;AAAA,IACH;AAAA,MACI,MAAM,qBAAqB,KAAK,WAAW;AAAA,MAC3C,IAAI;AAAA,IACR;AAAA,IAEA;AAAA,MACI,MAAM,iBAAiB,KAAK,YAAY;AAAA,MACxC,IAAI;AAAA,IACR;AAAA,EACJ;AACJ,CAAC;AAED,MAAM,KAAK,IAAI;",
+  "names": []
+}

package/dist/esm/examples/LightDevice.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ServerNode } from "@matter/main";
+import { OnOffLightDevice, OnOffLightRequirements } from "@matter/main/devices/on-off-light";
+class ReportingOnOffServer extends OnOffLightRequirements.OnOffServer {
+  // Intercept the "on" command to the Matter On/Off cluster to print a log message.
+  async on() {
+    console.log("Turning light ON");
+    await super.on();
+  }
+  // This is the functional inverse of on() above.
+  //
+  // For demonstration purposes we update state ourselves rather than deferring to matter.js's default "off" handler
+  // via super.off().
+  off() {
+    console.log("Turning light OFF");
+    this.state.onOff = false;
+  }
+  // Use event handlers to log on/off state reactively, after it changes.
+  initialize() {
+    this.events.onOff$Changed.on((value) => {
+      console.log(`Light is now ${value ? "ON" : "OFF"}`);
+    });
+  }
+}
+const ExampleLight = OnOffLightDevice.with(ReportingOnOffServer);
+const node = await ServerNode.create();
+await node.add(ExampleLight);
+await node.run();
+//# sourceMappingURL=LightDevice.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/examples/LightDevice.ts"],
+  "mappings": ";AACA;AAAA;AAAA;AAAA;AAAA;AAQA,SAAS,kBAAkB;AAC3B,SAAS,kBAAkB,8BAA8B;AAIzD,MAAM,6BAA6B,uBAAuB,YAAY;AAAA;AAAA,EAElE,MAAe,KAAK;AAChB,YAAQ,IAAI,kBAAkB;AAC9B,UAAM,MAAM,GAAG;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMS,MAAM;AACX,YAAQ,IAAI,mBAAmB;AAC/B,SAAK,MAAM,QAAQ;AAAA,EACvB;AAAA;AAAA,EAGS,aAAa;AAClB,SAAK,OAAO,cAAc,GAAG,WAAS;AAClC,cAAQ,IAAI,gBAAgB,QAAQ,OAAO,KAAK,EAAE;AAAA,IACtD,CAAC;AAAA,EACL;AACJ;AAKA,MAAM,eAAe,iBAAiB,KAAK,oBAAoB;AAO/D,MAAM,OAAO,MAAM,WAAW,OAAO;AAGrC,MAAM,KAAK,IAAI,YAAY;AAM3B,MAAM,KAAK,IAAI;",
+  "names": []
+}

package/dist/esm/examples/MultiDeviceNode.js

@@ -0,0 +1,143 @@
+#!/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";
+const devices = await getConfiguration();
+for (let idx = 1; idx < devices.length; idx++) {
+  const {
+    isSocket,
+    deviceName,
+    vendorName,
+    passcode,
+    discriminator,
+    vendorId,
+    productName,
+    productId,
+    port,
+    uniqueId
+  } = devices[idx];
+  const i = idx + 1;
+  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
+    }
+  });
+  console.log(
+    `Added device ${i} on port ${port} and unique id ${uniqueId}: Passcode: ${passcode}, Discriminator: ${discriminator}`
+  );
+  const endpoint = new Endpoint(isSocket ? OnOffPlugInUnitDevice : OnOffLightDevice, { id: "onoff" });
+  await server.add(endpoint);
+  endpoint.events.identify.startIdentifying.on(() => {
+    console.log(`Run identify logic for device ${i}, ideally blink a light every 0.5s ...`);
+  });
+  endpoint.events.identify.stopIdentifying.on(() => {
+    console.log(`Stop identify logic for 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));
+  console.log("----------------------------");
+  console.log(`QR Code for Device ${i} on port ${port}:`);
+  console.log("----------------------------");
+  await server.start();
+}
+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");
+  let defaultPasscode = 20202021;
+  let defaultDiscriminator = 3840;
+  let defaultPort = 5550;
+  const devices2 = [];
+  const numDevices = environment.vars.number("num") ?? 2;
+  for (let i = 1; i <= numDevices; i++) {
+    const isSocket = await deviceStorage.get(`isSocket${i}`, environment.vars.string(`type${i}`) === "socket");
+    if (await deviceStorage.has(`isSocket${i}`)) {
+      console.log(`Device type ${isSocket ? "socket" : "light"} found in storage. --type parameter is ignored.`);
+    }
+    const deviceName = `Matter ${environment.vars.string(`type${i}`) ?? "light"} device ${i}`;
+    const vendorName = "matter-node.js";
+    const passcode = environment.vars.number(`passcode${i}`) ?? await deviceStorage.get(`passcode${i}`, defaultPasscode++);
+    const discriminator = environment.vars.number(`discriminator${i}`) ?? await deviceStorage.get(`discriminator${i}`, defaultDiscriminator++);
+    const vendorId = environment.vars.number(`vendorid${i}`) ?? await deviceStorage.get(`vendorid${i}`, 65521);
+    const productName = `node-matter OnOff-Device ${i}`;
+    const productId = environment.vars.number(`productid${i}`) ?? await deviceStorage.get(`productid${i}`, 32768);
+    const port = environment.vars.number(`port${i}`) ?? defaultPort++;
+    const uniqueId = environment.vars.string(`uniqueid${i}`) ?? await deviceStorage.get(`uniqueid${i}`, `${i}-${Time.nowMs()}`);
+    await deviceStorage.set(`passcode${i}`, passcode);
+    await deviceStorage.set(`discriminator${i}`, discriminator);
+    await deviceStorage.set(`vendorid${i}`, vendorId);
+    await deviceStorage.set(`productid${i}`, productId);
+    await deviceStorage.set(`isSocket${i}`, isSocket);
+    await deviceStorage.set(`uniqueid${i}`, uniqueId);
+    devices2.push({
+      isSocket,
+      deviceName,
+      vendorName,
+      passcode,
+      discriminator,
+      vendorId,
+      productName,
+      productId,
+      port,
+      uniqueId
+    });
+  }
+  return devices2;
+}
+//# sourceMappingURL=MultiDeviceNode.js.map

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

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