@matter/nodejs-shell 0.11.0-alpha.0-20241007-547af42a8

package/dist/cjs/shell/cmd_tlv.js

@@ -0,0 +1,175 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var cmd_tlv_exports = {};
+__export(cmd_tlv_exports, {
+  default: () => commands
+});
+module.exports = __toCommonJS(cmd_tlv_exports);
+var import_general = require("#general");
+var import_types = require("#types");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const logger = import_general.Logger.get("tlv");
+const TlvTypeNames = {
+  [import_types.TlvType.Null]: "(Null)",
+  [import_types.TlvType.Boolean]: "Boolean(",
+  [import_types.TlvType.UnsignedInt]: "UnsignedInt(",
+  [import_types.TlvType.SignedInt]: "SignedInt(",
+  [import_types.TlvType.Float]: "Float(",
+  [import_types.TlvType.Utf8String]: "Utf8String(",
+  [import_types.TlvType.ByteString]: "ByteString(",
+  [import_types.TlvType.Array]: "Array {",
+  [import_types.TlvType.List]: "List {",
+  [import_types.TlvType.Structure]: "Structure {",
+  [import_types.TlvType.EndOfContainer]: "}"
+};
+function logAnyTlvStream(encoded) {
+  if (encoded.length === 0) {
+    return void 0;
+  }
+  const reader = new import_types.TlvArrayReader(encoded);
+  logGenericElement(reader);
+  const nextElement = reader.readTagType();
+  if (nextElement !== void 0) {
+    throw new import_general.UnexpectedDataError(`Unexpected data left after parsing all data: ${import_general.Logger.toJSON(nextElement)}`);
+  }
+}
+function logGenericElement(reader, preReadElement, allowTag = false) {
+  const element = preReadElement ?? reader.readTagType();
+  const {
+    tag,
+    typeLength: { type }
+  } = element;
+  switch (type) {
+    case import_types.TlvType.Null:
+    case import_types.TlvType.Boolean:
+    case import_types.TlvType.UnsignedInt:
+    case import_types.TlvType.SignedInt:
+    case import_types.TlvType.Float:
+    case import_types.TlvType.Utf8String:
+    case import_types.TlvType.ByteString:
+      if (tag !== void 0 && !allowTag) {
+        throw new import_general.UnexpectedDataError(`Tag detected for a native type: ${import_general.Logger.toJSON(element)}`);
+      }
+      const value = reader.readPrimitive(element.typeLength);
+      const logValue = value instanceof Uint8Array ? import_general.Bytes.toHex(value) : value;
+      const logNumberHex = typeof value === "number" || typeof value === "bigint" ? value.toString(16) : void 0;
+      logger.info(
+        tag?.id !== void 0 ? `${tag.id}/0x${tag?.id?.toString(16)} => ` : "",
+        TlvTypeNames[type],
+        `${logValue}${logNumberHex !== void 0 ? `/0x${logNumberHex}` : ""}`,
+        ")"
+      );
+      break;
+    case import_types.TlvType.Array:
+    case import_types.TlvType.List:
+      tag?.id !== void 0 ? logger.info(`${tag.id}/0x${tag.id.toString(16)} => `, TlvTypeNames[type]) : logger.info(TlvTypeNames[type]);
+      import_general.Logger.nest(() => logGenericArrayOrList(reader, type === import_types.TlvType.List));
+      logger.info(TlvTypeNames[import_types.TlvType.EndOfContainer]);
+      break;
+    case import_types.TlvType.Structure:
+      tag?.id !== void 0 ? logger.info(`${tag.id}/0x${tag.id.toString(16)} => `, TlvTypeNames[type]) : logger.info(TlvTypeNames[type]);
+      import_general.Logger.nest(() => logGenericStructure(reader));
+      logger.info(TlvTypeNames[import_types.TlvType.EndOfContainer]);
+      break;
+    default:
+      throw new import_general.UnexpectedDataError(`Unknown type: ${type}`);
+  }
+}
+function logGenericArrayOrList(reader, allowTag = false) {
+  const result = new Array();
+  while (true) {
+    const element = reader.readTagType();
+    const {
+      tag,
+      typeLength: { type }
+    } = element;
+    if (type === import_types.TlvType.EndOfContainer) break;
+    if (tag !== void 0 && !allowTag) {
+      throw new import_general.UnexpectedDataError(`Tag detected : ${import_general.Logger.toJSON(element)}`);
+    }
+    logGenericElement(reader, element, allowTag);
+  }
+  return result;
+}
+function logGenericStructure(reader) {
+  const result = {};
+  while (true) {
+    const element = reader.readTagType();
+    const {
+      tag,
+      typeLength: { type }
+    } = element;
+    if (type === import_types.TlvType.EndOfContainer) break;
+    if (tag === void 0 || tag.id === void 0) {
+      throw new import_general.UnexpectedDataError(`Tag missing for a structure: ${import_general.Logger.toJSON(element)}`);
+    }
+    logGenericElement(reader, element, true);
+  }
+  return result;
+}
+function commands() {
+  return {
+    command: "tlv",
+    describe: "TLV decoding tools",
+    builder: (yargs) => {
+      return yargs.command(
+        "decode [value]",
+        "Decodes a TLV string (hex) into matter.js JavaScript object",
+        (yargs2) => {
+          return yargs2.positional("value", {
+            describe: "The TLV value as hex string",
+            type: "string",
+            demandOption: true
+          });
+        },
+        async (argv) => {
+          const { value } = argv;
+          const bytes = import_general.Bytes.fromHex(value);
+          const tlvEncoded = import_types.TlvAny.decode(bytes);
+          const decoded = import_types.TlvAny.decodeAnyTlvStream(tlvEncoded);
+          console.log("Decoded:", (0, import_general.serialize)(decoded));
+        }
+      ).command(
+        "log [value]",
+        "Decodes a TLV string (hex string) and logs it's structure",
+        (yargs2) => {
+          return yargs2.positional("value", {
+            describe: "The TLV value as hex string",
+            type: "string",
+            demandOption: true
+          });
+        },
+        async (argv) => {
+          const { value } = argv;
+          const bytes = import_general.Bytes.fromHex(value);
+          const tlvEncoded = import_types.TlvAny.decode(bytes);
+          logAnyTlvStream(tlvEncoded);
+        }
+      );
+    },
+    handler: async (argv) => {
+      argv.unhandled = true;
+    }
+  };
+}
+//# sourceMappingURL=cmd_tlv.js.map

package/dist/cjs/shell/cmd_tlv.js.map

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

package/dist/cjs/util/CommandlineParser.js

@@ -0,0 +1,106 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var CommandlineParser_exports = {};
+__export(CommandlineParser_exports, {
+  commandlineParser: () => commandlineParser
+});
+module.exports = __toCommonJS(CommandlineParser_exports);
+/**
+ * Quote aware Command line parser
+ *
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class StringReader {
+  constructor(str) {
+    this.str = str;
+    this.pos = -1;
+  }
+  pos;
+  current;
+  next() {
+    if (this.pos < this.str.length) {
+      this.current = this.str[++this.pos];
+    }
+    return this.current;
+  }
+}
+function isWhitespace(c) {
+  return c === " ";
+}
+function consumeWhitespace(r) {
+  while (r.current !== void 0 && isWhitespace(r.current)) {
+    r.next();
+  }
+}
+function escaped(r) {
+  const n = r.next();
+  if (n === void 0) {
+    throw new Error("Unterminated escape sequence");
+  }
+  return n;
+}
+function quoted(r) {
+  let s = "";
+  const q = r.current;
+  const e = q === '"';
+  for (let c = r.next(); c !== q; c = r.next()) {
+    if (c === void 0) {
+      throw new Error(`Unterminated quote: ${q}`);
+    }
+    if (e && c === "\\") {
+      s += escaped(r);
+    } else {
+      s += c;
+    }
+  }
+  return s;
+}
+function commandlineParser(line) {
+  const args = [];
+  let s = "";
+  const r = new StringReader(line);
+  r.next();
+  consumeWhitespace(r);
+  let sawQuote = false;
+  while (r.current !== void 0) {
+    if (isWhitespace(r.current)) {
+      args.push(s);
+      sawQuote = false;
+      s = "";
+      consumeWhitespace(r);
+    } else if (r.current == "\\") {
+      s += escaped(r);
+      r.next();
+    } else if (r.current === "'" || r.current === '"') {
+      s += quoted(r);
+      sawQuote = true;
+      r.next();
+    } else {
+      s += r.current;
+      r.next();
+    }
+  }
+  if (sawQuote || s.length) {
+    args.push(s);
+  }
+  return args;
+}
+//# sourceMappingURL=CommandlineParser.js.map

package/dist/cjs/util/CommandlineParser.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/CommandlineParser.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA2BA,MAAM,aAAa;AAAA,EAIf,YAA6B,KAAa;AAAb;AACzB,SAAK,MAAM;AAAA,EACf;AAAA,EALQ;AAAA,EACD;AAAA,EAMP,OAAO;AACH,QAAI,KAAK,MAAM,KAAK,IAAI,QAAQ;AAC5B,WAAK,UAAU,KAAK,IAAI,EAAE,KAAK,GAAG;AAAA,IACtC;AAEA,WAAO,KAAK;AAAA,EAChB;AACJ;AAEA,SAAS,aAAa,GAAW;AAC7B,SAAO,MAAM;AACjB;AAEA,SAAS,kBAAkB,GAAiB;AACxC,SAAO,EAAE,YAAY,UAAa,aAAa,EAAE,OAAO,GAAG;AACvD,MAAE,KAAK;AAAA,EACX;AACJ;AAEA,SAAS,QAAQ,GAAiB;AAC9B,QAAM,IAAI,EAAE,KAAK;AACjB,MAAI,MAAM,QAAW;AACjB,UAAM,IAAI,MAAM,8BAA8B;AAAA,EAClD;AAEA,SAAO;AACX;AAEA,SAAS,OAAO,GAAiB;AAC7B,MAAI,IAAI;AAER,QAAM,IAAI,EAAE;AACZ,QAAM,IAAI,MAAM;AAEhB,WAAS,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,EAAE,KAAK,GAAG;AAC1C,QAAI,MAAM,QAAW;AACjB,YAAM,IAAI,MAAM,uBAAuB,CAAC,EAAE;AAAA,IAC9C;AAEA,QAAI,KAAK,MAAM,MAAM;AACjB,WAAK,QAAQ,CAAC;AAAA,IAClB,OAAO;AACH,WAAK;AAAA,IACT;AAAA,EACJ;AAEA,SAAO;AACX;AAEO,SAAS,kBAAkB,MAAc;AAC5C,QAAM,OAAO,CAAC;AACd,MAAI,IAAI;AAER,QAAM,IAAI,IAAI,aAAa,IAAI;AAC/B,IAAE,KAAK;AACP,oBAAkB,CAAC;AAKnB,MAAI,WAAW;AAEf,SAAO,EAAE,YAAY,QAAW;AAC5B,QAAI,aAAa,EAAE,OAAO,GAAG;AACzB,WAAK,KAAK,CAAC;AACX,iBAAW;AACX,UAAI;AAEJ,wBAAkB,CAAC;AAAA,IACvB,WAAW,EAAE,WAAW,MAAM;AAC1B,WAAK,QAAQ,CAAC;AACd,QAAE,KAAK;AAAA,IACX,WAAW,EAAE,YAAY,OAAO,EAAE,YAAY,KAAK;AAC/C,WAAK,OAAO,CAAC;AACb,iBAAW;AACX,QAAE,KAAK;AAAA,IACX,OAAO;AACH,WAAK,EAAE;AACP,QAAE,KAAK;AAAA,IACX;AAAA,EACJ;AAEA,MAAI,YAAY,EAAE,QAAQ;AACtB,SAAK,KAAK,CAAC;AAAA,EACf;AAEA,SAAO;AACX;",
+  "names": []
+}

package/dist/cjs/util/Json.js

@@ -0,0 +1,66 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var Json_exports = {};
+__export(Json_exports, {
+  convertJsonDataWithModel: () => convertJsonDataWithModel
+});
+module.exports = __toCommonJS(Json_exports);
+var import_general = require("@matter/general");
+var import_common = require("@project-chip/matter.js/common");
+var import_String = require("./String");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function convertJsonDataWithModel(model, data) {
+  const definingModel = model.definingModel ?? model;
+  switch (definingModel.effectiveMetatype) {
+    case "array":
+      if (!Array.isArray(data)) {
+        throw new import_common.ValidationDatatypeMismatchError(`Expected array, got ${typeof data}`);
+      }
+      return data.map((item) => convertJsonDataWithModel(definingModel.children[0], item));
+    case "object":
+      if (typeof data !== "object") {
+        throw new import_common.ValidationDatatypeMismatchError(`Expected object, got ${typeof data}`);
+      }
+      for (const child of definingModel.children) {
+        const childKeyName = (0, import_String.camelize)(child.name);
+        data[childKeyName] = convertJsonDataWithModel(child, data[childKeyName]);
+      }
+      return data;
+    case "integer":
+      if (typeof data === "string") {
+        if (definingModel.metabase?.byteSize !== void 0 && definingModel.metabase.byteSize > 6) {
+          return BigInt(data);
+        } else if (data.startsWith("0x")) {
+          return parseInt(data.substring(2), 16);
+        }
+      }
+      break;
+    case "bytes":
+      if (typeof data === "string") {
+        return import_general.Bytes.fromHex(data);
+      }
+      break;
+  }
+  return data;
+}
+//# sourceMappingURL=Json.js.map

package/dist/cjs/util/Json.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/Json.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,qBAAsB;AAEtB,oBAAgD;AAChD,oBAAyB;AATzB;AAAA;AAAA;AAAA;AAAA;AAWO,SAAS,yBAAyB,OAAmB,MAAgB;AACxE,QAAM,gBAAgB,MAAM,iBAAiB;AAC7C,UAAQ,cAAc,mBAAmB;AAAA,IACrC,KAAK;AACD,UAAI,CAAC,MAAM,QAAQ,IAAI,GAAG;AACtB,cAAM,IAAI,8CAAgC,uBAAuB,OAAO,IAAI,EAAE;AAAA,MAClF;AACA,aAAO,KAAK,IAAI,UAAQ,yBAAyB,cAAc,SAAS,CAAC,GAAG,IAAI,CAAC;AAAA,IACrF,KAAK;AACD,UAAI,OAAO,SAAS,UAAU;AAC1B,cAAM,IAAI,8CAAgC,wBAAwB,OAAO,IAAI,EAAE;AAAA,MACnF;AACA,iBAAW,SAAS,cAAc,UAAU;AACxC,cAAM,mBAAe,wBAAS,MAAM,IAAI;AACxC,aAAK,YAAY,IAAI,yBAAyB,OAAO,KAAK,YAAY,CAAC;AAAA,MAC3E;AACA,aAAO;AAAA,IACX,KAAK;AACD,UAAI,OAAO,SAAS,UAAU;AAC1B,YAAI,cAAc,UAAU,aAAa,UAAa,cAAc,SAAS,WAAW,GAAG;AAGvF,iBAAO,OAAO,IAAI;AAAA,QACtB,WAAW,KAAK,WAAW,IAAI,GAAG;AAE9B,iBAAO,SAAS,KAAK,UAAU,CAAC,GAAG,EAAE;AAAA,QACzC;AAAA,MACJ;AACA;AAAA,IACJ,KAAK;AACD,UAAI,OAAO,SAAS,UAAU;AAE1B,eAAO,qBAAM,QAAQ,IAAI;AAAA,MAC7B;AACA;AAAA,EACR;AAEA,SAAO;AACX;",
+  "names": []
+}

package/dist/cjs/util/String.js

@@ -0,0 +1,32 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var String_exports = {};
+__export(String_exports, {
+  camelize: () => camelize
+});
+module.exports = __toCommonJS(String_exports);
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function camelize(str) {
+  return str.charAt(0).toLowerCase() + str.slice(1);
+}
+//# sourceMappingURL=String.js.map

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

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

package/package.json

@@ -0,0 +1,58 @@
+{
+    "name": "@matter/nodejs-shell",
+    "version": "0.11.0-alpha.0-20241007-547af42a8",
+    "description": "Shell app for Matter controller",
+    "keywords": [
+        "iot",
+        "home automation",
+        "matter",
+        "smart device"
+    ],
+    "license": "Apache-2.0",
+    "author": "matter.js authors",
+    "contributors": [
+        "Martin Turon <mturon@google.com>",
+        "Ingo Fischer <github@fischer-ka.de>"
+    ],
+    "bugs": {
+        "url": "https://github.com/project-chip/matter.js/issues"
+    },
+    "homepage": "https://github.com/project-chip/matter.js",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/project-chip/matter.js.git"
+    },
+    "scripts": {
+        "clean": "matter-build clean",
+        "build": "matter-build",
+        "build-clean": "matter-build --clean",
+        "shell": "matter-run src/app.ts"
+    },
+    "bin": {
+        "matter-shell": "dist/cjs/app.js"
+    },
+    "imports": {
+        "#general": "@matter/general",
+        "#types": "@matter/types"
+    },
+    "dependencies": {
+        "@matter/nodejs-ble": "0.11.0-alpha.0-20241007-547af42a8",
+        "@matter/nodejs": "0.11.0-alpha.0-20241007-547af42a8",
+        "@matter/general": "0.11.0-alpha.0-20241007-547af42a8",
+        "@matter/tools": "0.11.0-alpha.0-20241007-547af42a8",
+        "@project-chip/matter.js": "0.11.0-alpha.0-20241007-547af42a8",
+        "yargs": "^17.7.2"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "files": [
+        "dist/**/*",
+        "src/**/*",
+        "LICENSE",
+        "README.md"
+    ],
+    "publishConfig": {
+        "access": "public"
+    }
+}

package/src/MatterNode.ts

@@ -0,0 +1,141 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Include this first to auto-register Crypto, Network and Time Node.js implementations
+import { Logger, StorageContext, StorageManager } from "@matter/general";
+import { StorageBackendDisk } from "@matter/nodejs";
+import { CommissioningController, MatterServer } from "@project-chip/matter.js";
+import { NodeId } from "@project-chip/matter.js/datatype";
+import { CommissioningControllerNodeOptions, PairedNode } from "@project-chip/matter.js/device";
+import { EndpointInterface } from "@project-chip/matter.js/endpoint";
+
+const logger = Logger.get("Node");
+
+export class MatterNode {
+    private storageLocation?: string;
+    private storage?: StorageBackendDisk;
+    private storageManager?: StorageManager;
+    private storageContext?: StorageContext;
+
+    commissioningController?: CommissioningController;
+    private matterController?: MatterServer;
+
+    constructor(
+        private readonly nodeNum: number,
+        private readonly netInterface?: string,
+    ) {}
+
+    async initialize(resetStorage: boolean) {
+        /**
+         * Initialize the storage system.
+         *
+         * The storage manager is then also used by the Matter server, so this code block in general is required,
+         * but you can choose a different storage backend as long as it implements the required API.
+         */
+
+        this.storageLocation = `.matter-shell-${this.nodeNum}`;
+        this.storage = new StorageBackendDisk(this.storageLocation, false);
+        logger.info(`Storage location: ${this.storageLocation} (Directory)`);
+        this.storageManager = new StorageManager(this.storage);
+        await this.storageManager.initialize();
+        this.storageContext = this.storageManager.createContext("Node");
+        if (resetStorage) {
+            this.storage.clearAll([]);
+        }
+    }
+
+    get Store() {
+        if (!this.storageContext) {
+            throw new Error("Storage uninitialized");
+        }
+        return this.storageContext;
+    }
+
+    async close() {
+        await this.matterController?.close();
+        this.closeStorage();
+    }
+
+    closeStorage() {
+        try {
+            this.storage?.close();
+            process.exit(0);
+        } catch {
+            process.exit(1);
+        }
+    }
+
+    async start() {
+        if (this.storageManager === undefined) {
+            throw new Error("StorageManager not initialized"); // Should never happen
+        }
+        if (this.matterController !== undefined) {
+            return;
+        }
+        logger.info(`matter.js shell controller started for node ${this.nodeNum}`);
+
+        /**
+         * Create Matter Server and Controller Node
+         *
+         * To allow the device to be announced, found, paired and operated we need a MatterServer instance and add a
+         * CommissioningController to it and add the just created device instance to it.
+         * The Controller node defines the port where the server listens for the UDP packages of the Matter protocol
+         * and initializes deice specific certificates and such.
+         *
+         * The below logic also adds command handlers for commands of clusters that normally are handled internally
+         * like testEventTrigger (General Diagnostic Cluster) that can be implemented with the logic when these commands
+         * are called.
+         */
+
+        this.matterController = new MatterServer(this.storageManager, { mdnsInterface: this.netInterface });
+        this.commissioningController = new CommissioningController({
+            autoConnect: false,
+        });
+        await this.matterController.addCommissioningController(this.commissioningController);
+
+        /**
+         * Start the Matter Server
+         *
+         * After everything was plugged together we can start the server. When not delayed announcement is set for the
+         * CommissioningServer node then this command also starts the announcement of the device into the network.
+         */
+
+        await this.matterController.start();
+    }
+
+    async connectAndGetNodes(nodeIdStr?: string, connectOptions?: CommissioningControllerNodeOptions) {
+        await this.start();
+        const nodeId = nodeIdStr !== undefined ? NodeId(BigInt(nodeIdStr)) : undefined;
+
+        if (this.commissioningController === undefined) {
+            throw new Error("CommissioningController not initialized");
+        }
+        let nodes: PairedNode[];
+        if (nodeId === undefined) {
+            nodes = await this.commissioningController.connect(connectOptions);
+        } else {
+            nodes = [await this.commissioningController.connectNode(NodeId(nodeId), connectOptions)];
+        }
+        return nodes;
+    }
+
+    async iterateNodeDevices(
+        nodes: PairedNode[],
+        callback: (device: EndpointInterface, node: PairedNode) => Promise<void>,
+        endpointId?: number,
+    ) {
+        for (const node of nodes) {
+            let devices = node.getDevices();
+            if (endpointId !== undefined) {
+                devices = devices.filter(device => device.number === endpointId);
+            }
+
+            for (const device of devices) {
+                await callback(device, node);
+            }
+        }
+    }
+}