@matter/nodejs-shell 0.14.0-alpha.0-20250524-51a7e1721 → 0.14.0-alpha.0-20250525-d6ada0d45

package/README.md

@@ -203,7 +203,13 @@ $ ls .matter-shell-1
 $ more .matter-shell-1/Node.ip
 "fe80::148d:9bd8:5006:243%en0"
 ```
+# Running over websockets
 
+If the matter shell is started with the parameter --webSocketInterface all interaction with the shell will be done over a websocket instead of the local terminal. The parameter --webSocketPort NNNN can be used to change from the default port of 3000 to a user-specified port. If the parameter --webServer is added, the matter shell will also start an http server that will serve files from the same directory as the application itself utilizying the same port as the websocket. The functionality of the shell will be identical to the above description with the exception that the "exit" command will only close the websocket and not exit the matter shell application.
+
+An example application that shows interaction from a web browser is included. The example shows how commands can be sent from html and javascript in the browser to the shell and how the results of the commands can be parsed to create a user interface. 
+
+![Web Interface](src/shell/webassets/WebShell.png "Example Application")
 ```
           █
           █

package/dist/cjs/app.js

@@ -40,13 +40,16 @@ var import_protocol = require("#protocol");
 var import_yargs = __toESM(require("yargs/yargs"));
 var import_MatterNode = require("./MatterNode.js");
 var import_Shell = require("./shell/Shell");
+var import_web_plumbing = require("./web_plumbing.js");
 /**
  * @license
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
 const PROMPT = "matter> ";
+const DEFAULT_WEBSOCKET_PORT = 3e3;
 const logger = import_general.Logger.get("Shell");
+let theShell;
 if (process.stdin?.isTTY) import_general.Logger.format = import_general.LogFormat.ANSI;
 let theNode;
 function setLogLevel(identifier, level) {
@@ -105,12 +108,38 @@ async function main() {
           description: "Logfile to use to log to. By Default debug loglevel is logged to the file. The provided value will be persisted for future runs.",
           type: "string",
           default: void 0
+        },
+        webSocketInterface: {
+          description: "Enable WebSocket interface",
+          type: "boolean",
+          default: false
+        },
+        webSocketPort: {
+          description: "WebSocket and HTTP server port",
+          type: "number",
+          default: DEFAULT_WEBSOCKET_PORT
+        },
+        webServer: {
+          description: "Enable Web server when using WebSocket interface",
+          type: "boolean",
+          default: false
         }
       });
     },
     async (argv) => {
       if (argv.help) return;
-      const { nodeNum, ble, bleHciId, nodeType, factoryReset, netInterface, logfile } = argv;
+      const {
+        nodeNum,
+        ble,
+        bleHciId,
+        nodeType,
+        factoryReset,
+        netInterface,
+        logfile,
+        webSocketInterface,
+        webSocketPort,
+        webServer
+      } = argv;
       theNode = new import_MatterNode.MatterNode(nodeNum, netInterface);
       await theNode.initialize(factoryReset);
       if (logfile !== void 0) {
@@ -127,7 +156,12 @@ async function main() {
         }
       }
       setLogLevel("default", await theNode.Store.get("LogLevel", "info"));
-      const theShell = new import_Shell.Shell(theNode, nodeNum, PROMPT);
+      if (webSocketInterface) {
+        import_general.Logger.format = import_general.LogFormat.PLAIN;
+        (0, import_web_plumbing.initializeWebPlumbing)(theNode, nodeNum, webSocketPort, webServer);
+      } else {
+        theShell = new import_Shell.Shell(theNode, nodeNum, PROMPT, process.stdin, process.stdout);
+      }
       if (bleHciId !== void 0) {
         await theNode.Store.set("BleHciId", bleHciId);
       }
@@ -141,9 +175,11 @@ async function main() {
         );
       }
       console.log(`Started Node #${nodeNum} (Type: ${nodeType}) ${ble ? "with" : "without"} BLE`);
-      theShell.start(theNode.storageLocation);
+      if (!webSocketInterface) {
+        theShell.start(theNode.storageLocation);
+      }
     }
-  ).version(false).scriptName("shell");
+  ).version(false).scriptName("shell").strict();
   await yargsInstance.wrap(yargsInstance.terminalWidth()).parseAsync();
 }
 process.on("message", function(message) {

package/dist/cjs/app.js.map

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

package/dist/cjs/shell/Shell.js

@@ -69,10 +69,12 @@ class Shell {
   /**
    * Construct a new Shell object.
    */
-  constructor(theNode, nodeNum, prompt) {
+  constructor(theNode, nodeNum, prompt, input, output) {
     this.theNode = theNode;
     this.nodeNum = nodeNum;
     this.prompt = prompt;
+    this.input = input;
+    this.output = output;
   }
   readline;
   writeStream;
@@ -103,9 +105,9 @@ class Shell {
       }
     }
     this.readline = import_node_readline.default.createInterface({
-      input: process.stdin,
-      output: process.stdout,
-      terminal: true,
+      input: this.input,
+      output: this.output,
+      terminal: this.input === process.stdin && this.output === process.stdout,
       prompt: this.prompt,
       history: history.reverse(),
       historySize: MAX_HISTORY_SIZE
@@ -125,11 +127,13 @@ class Shell {
         process.stderr.write(`Error happened during history file write: ${e}
 `);
       }
-      (0, import_app.exit)().then(() => process.exit(0)).catch((e) => {
-        process.stderr.write(`Close error: ${e}
+      if (this.input === process.stdin && this.output === process.stdout) {
+        (0, import_app.exit)().then(() => process.exit(0)).catch((e) => {
+          process.stderr.write(`Close error: ${e}
 `);
-        process.exit(1);
-      });
+          process.exit(1);
+        });
+      }
     });
     this.readline.prompt();
   }

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

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/shell/Shell.ts"],
-  "mappings": "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",
+  "mappings": "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",
   "names": ["readline", "yargs", "cmdCommission", "cmdConfig", "cmdSession", "cmdNodes", "cmdSubscribe", "cmdIdentify", "cmdDiscover", "cmdAttributes", "cmdEvents", "cmdCommands", "cmdTlv"]
 }

package/dist/cjs/shell/cmd_subscribe.js

@@ -39,16 +39,16 @@ function commands(theNode) {
       });
     },
     handler: async (argv) => {
-      const { nodeId } = argv;
-      const node = (await theNode.connectAndGetNodes(nodeId))[0];
+      const { nodeId: subscribeNodeId } = argv;
+      const node = (await theNode.connectAndGetNodes(subscribeNodeId))[0];
       await node.subscribeAllAttributesAndEvents({
-        attributeChangedCallback: ({ path: { nodeId: nodeId2, clusterId, endpointId, attributeName }, value }) => console.log(
-          `${nodeId2}: Attribute ${nodeId2}/${endpointId}/${clusterId}/${attributeName} changed to ${import_general.Diagnostic.json(
+        attributeChangedCallback: ({ path: { nodeId, clusterId, endpointId, attributeName }, value }) => console.log(
+          `${subscribeNodeId}: Attribute ${nodeId}/${endpointId}/${clusterId}/${attributeName} changed to ${import_general.Diagnostic.json(
             value
           )}`
         ),
-        eventTriggeredCallback: ({ path: { nodeId: nodeId2, clusterId, endpointId, eventName }, events }) => console.log(
-          `${nodeId2} Event ${nodeId2}/${endpointId}/${clusterId}/${eventName} triggered with ${import_general.Diagnostic.json(
+        eventTriggeredCallback: ({ path: { nodeId, clusterId, endpointId, eventName }, events }) => console.log(
+          `${subscribeNodeId} Event ${nodeId}/${endpointId}/${clusterId}/${eventName} triggered with ${import_general.Diagnostic.json(
             events
           )}`
         )

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

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/shell/cmd_subscribe.ts"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,qBAA2B;AAN3B;AAAA;AAAA;AAAA;AAAA;AAUe,SAAR,SAA0B,SAAqB;AAClD,SAAO;AAAA,IACH,SAAS;AAAA,IACT,UAAU;AAAA,IACV,SAAS,CAAC,UAAgB;AACtB,aAAO,MAAM,WAAW,WAAW;AAAA,QAC/B,UAAU;AAAA,QACV,SAAS;AAAA,QACT,MAAM;AAAA,MACV,CAAC;AAAA,IACL;AAAA,IAEA,SAAS,OAAO,SAAc;AAC1B,YAAM,EAAE,OAAO,IAAI;AACnB,YAAM,QAAQ,MAAM,QAAQ,mBAAmB,MAAM,GAAG,CAAC;AAEzD,YAAM,KAAK,gCAAgC;AAAA,QACvC,0BAA0B,CAAC,EAAE,MAAM,EAAE,QAAAA,SAAQ,WAAW,YAAY,cAAc,GAAG,MAAM,MACvF,QAAQ;AAAA,UACJ,GAAGA,OAAM,eAAeA,OAAM,IAAI,UAAU,IAAI,SAAS,IAAI,aAAa,eAAe,0BAAW;AAAA,YAChG;AAAA,UACJ,CAAC;AAAA,QACL;AAAA,QACJ,wBAAwB,CAAC,EAAE,MAAM,EAAE,QAAAA,SAAQ,WAAW,YAAY,UAAU,GAAG,OAAO,MAClF,QAAQ;AAAA,UACJ,GAAGA,OAAM,UAAUA,OAAM,IAAI,UAAU,IAAI,SAAS,IAAI,SAAS,mBAAmB,0BAAW;AAAA,YAC3F;AAAA,UACJ,CAAC;AAAA,QACL;AAAA,MACR,CAAC;AAAA,IACL;AAAA,EACJ;AACJ;",
-  "names": ["nodeId"]
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,qBAA2B;AAN3B;AAAA;AAAA;AAAA;AAAA;AAUe,SAAR,SAA0B,SAAqB;AAClD,SAAO;AAAA,IACH,SAAS;AAAA,IACT,UAAU;AAAA,IACV,SAAS,CAAC,UAAgB;AACtB,aAAO,MAAM,WAAW,WAAW;AAAA,QAC/B,UAAU;AAAA,QACV,SAAS;AAAA,QACT,MAAM;AAAA,MACV,CAAC;AAAA,IACL;AAAA,IAEA,SAAS,OAAO,SAAc;AAC1B,YAAM,EAAE,QAAQ,gBAAgB,IAAI;AACpC,YAAM,QAAQ,MAAM,QAAQ,mBAAmB,eAAe,GAAG,CAAC;AAElE,YAAM,KAAK,gCAAgC;AAAA,QACvC,0BAA0B,CAAC,EAAE,MAAM,EAAE,QAAQ,WAAW,YAAY,cAAc,GAAG,MAAM,MACvF,QAAQ;AAAA,UACJ,GAAG,eAAe,eAAe,MAAM,IAAI,UAAU,IAAI,SAAS,IAAI,aAAa,eAAe,0BAAW;AAAA,YACzG;AAAA,UACJ,CAAC;AAAA,QACL;AAAA,QACJ,wBAAwB,CAAC,EAAE,MAAM,EAAE,QAAQ,WAAW,YAAY,UAAU,GAAG,OAAO,MAClF,QAAQ;AAAA,UACJ,GAAG,eAAe,UAAU,MAAM,IAAI,UAAU,IAAI,SAAS,IAAI,SAAS,mBAAmB,0BAAW;AAAA,YACpG;AAAA,UACJ,CAAC;AAAA,QACL;AAAA,MACR,CAAC;AAAA,IACL;AAAA,EACJ;AACJ;",
+  "names": []
 }

package/dist/cjs/web_plumbing.js

@@ -0,0 +1,170 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var web_plumbing_exports = {};
+__export(web_plumbing_exports, {
+  initializeWebPlumbing: () => initializeWebPlumbing
+});
+module.exports = __toCommonJS(web_plumbing_exports);
+var import_general = require("@matter/general");
+var import_node_stream = require("node:stream");
+var import_ws = __toESM(require("ws"));
+var import_Shell = require("./shell/Shell");
+var import_fs = __toESM(require("fs"));
+var import_node_http = __toESM(require("node:http"));
+var import_path = __toESM(require("path"));
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+let client;
+let server;
+let wss;
+const socketLogger = "websocket";
+function initializeWebPlumbing(theNode, nodeNum, webSocketPort, webServer) {
+  if (webServer) {
+    const root = import_path.default.resolve(__dirname) ?? "./";
+    server = import_node_http.default.createServer((req, res) => {
+      const url = req.url ?? "/";
+      const safePath = import_path.default.normalize(
+        import_path.default.join(root, decodeURIComponent(url === "/" ? "/index.html" : url))
+      );
+      if (!safePath.startsWith(root)) {
+        res.writeHead(403).end("Forbidden");
+        return;
+      }
+      import_fs.default.readFile(safePath, (err, data) => {
+        if (err) return res.writeHead(404).end("Not Found");
+        res.writeHead(200).end(data);
+      });
+    }).listen(webSocketPort);
+    wss = new import_ws.WebSocketServer({ server });
+  } else wss = new import_ws.WebSocketServer({ port: webSocketPort });
+  console.info(`WebSocket server running on ws://localhost:${webSocketPort}`);
+  console.log = // console.debug = // too much traffic - kills the websocket
+  console.info = console.warn = console.error = (...args) => {
+    if (client && client.readyState === import_ws.default.OPEN) {
+      client.send(args.map((arg) => typeof arg === "object" ? JSON.stringify(arg) : arg).join(" "));
+    } else
+      process.stdout.write(
+        args.map((arg) => typeof arg === "object" ? JSON.stringify(arg) : arg).join(" ") + "\n"
+      );
+  };
+  wss.on("connection", (ws) => {
+    if (client && client.readyState === import_ws.default.OPEN) {
+      ws.send("ERROR: Shell in use by another client");
+      ws.close();
+      return;
+    }
+    client = ws;
+    createWebSocketLogger(ws).then((logger) => {
+      import_general.Logger.removeLogger("Shell");
+      import_general.Logger.addLogger(socketLogger, logger);
+    }).catch((err) => {
+      if (!(err instanceof import_general.NotImplementedError)) {
+        console.error("Failed to add WebSocket logger: " + err);
+      }
+    });
+    const shell = new import_Shell.Shell(theNode, nodeNum, "", createReadableStream(ws), createWritableStream(ws));
+    shell.start(theNode.storageLocation);
+    ws.on("close", () => {
+      process.stdout.write("Client disconnected\n");
+      try {
+        if (import_general.Logger.getLoggerForIdentifier(socketLogger) !== void 0) {
+          import_general.Logger.removeLogger(socketLogger);
+        }
+      } catch (err) {
+      }
+      client = ws;
+    });
+    ws.on("error", (err) => {
+      process.stderr.write(`WebSocket error: ${err.message}
+`);
+      try {
+        if (import_general.Logger.getLoggerForIdentifier(socketLogger) !== void 0) {
+          import_general.Logger.removeLogger(socketLogger);
+        }
+      } catch (err2) {
+      }
+    });
+  });
+  async function createWebSocketLogger(socket) {
+    if (socket.readyState === import_ws.default.CONNECTING) {
+      await new Promise((resolve, reject) => {
+        socket.onopen = () => resolve();
+        socket.onerror = (err) => reject(new Error(`WebSocket error: ${err.type}`));
+      });
+    }
+    return (__level, formattedLog) => {
+      if (socket.readyState === import_ws.default.OPEN) {
+        socket.send(formattedLog);
+      } else {
+        process.stderr.write(`WebSocket logger not open, log dropped: ${formattedLog}
+`);
+      }
+    };
+  }
+}
+function createReadableStream(ws) {
+  const readable = new import_node_stream.Readable({ read() {
+  } });
+  ws.on("message", (data) => {
+    const chunk = Buffer.isBuffer(data) ? data : Buffer.from(data.toString());
+    readable.push(chunk);
+  });
+  ws.on("close", () => {
+    readable.push(null);
+  });
+  ws.on("error", (err) => {
+    readable.emit("error", err);
+    readable.push(null);
+  });
+  return readable;
+}
+function createWritableStream(ws) {
+  const writable = new import_node_stream.Writable({
+    write(chunk, _encoding, callback) {
+      if (ws.readyState === import_ws.default.OPEN) {
+        ws.send(chunk, callback);
+      } else {
+        if (chunk.length > 0) process.stderr.write(`ERROR: WebSocket is not open. Failed to send "${chunk}"
+`);
+      }
+    },
+    final(callback) {
+      if (ws.readyState === import_ws.default.OPEN) {
+        ws.close();
+      }
+      callback();
+    }
+  });
+  ws.on("error", (err) => writable.emit("WebSocket Write Error: ", err));
+  return writable;
+}
+//# sourceMappingURL=web_plumbing.js.map

package/dist/cjs/web_plumbing.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/web_plumbing.ts"],
+  "mappings": "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",
+  "names": ["path", "http", "fs", "WebSocket", "err"]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@matter/nodejs-shell",
-    "version": "0.14.0-alpha.0-20250524-51a7e1721",
+    "version": "0.14.0-alpha.0-20250525-d6ada0d45",
     "description": "Shell app for Matter controller",
     "keywords": [
         "iot",
@@ -26,7 +26,8 @@
         "clean": "matter-build clean",
         "build": "matter-build",
         "build-clean": "matter-build --clean",
-        "shell": "matter-run src/app.ts"
+        "shell": "matter-run src/app.ts",
+        "bundle-shell": "esbuild src/app.ts --bundle --platform=node --conditions=esbuild --external:@stoprocent/noble --external:@stoprocent/bluetooth-hci-socket --sourcemap --minify --keep-names --outfile=build/bundle/app.cjs"
     },
     "bin": {
         "matter-shell": "dist/cjs/app.js"
@@ -41,15 +42,16 @@
         "#types": "@matter/types"
     },
     "dependencies": {
-        "@matter/general": "0.14.0-alpha.0-20250524-51a7e1721",
-        "@matter/model": "0.14.0-alpha.0-20250524-51a7e1721",
-        "@matter/node": "0.14.0-alpha.0-20250524-51a7e1721",
-        "@matter/nodejs": "0.14.0-alpha.0-20250524-51a7e1721",
-        "@matter/nodejs-ble": "0.14.0-alpha.0-20250524-51a7e1721",
-        "@matter/protocol": "0.14.0-alpha.0-20250524-51a7e1721",
-        "@matter/tools": "0.14.0-alpha.0-20250524-51a7e1721",
-        "@matter/types": "0.14.0-alpha.0-20250524-51a7e1721",
-        "@project-chip/matter.js": "0.14.0-alpha.0-20250524-51a7e1721",
+        "@matter/general": "0.14.0-alpha.0-20250525-d6ada0d45",
+        "@matter/model": "0.14.0-alpha.0-20250525-d6ada0d45",
+        "@matter/node": "0.14.0-alpha.0-20250525-d6ada0d45",
+        "@matter/nodejs": "0.14.0-alpha.0-20250525-d6ada0d45",
+        "@matter/nodejs-ble": "0.14.0-alpha.0-20250525-d6ada0d45",
+        "@matter/protocol": "0.14.0-alpha.0-20250525-d6ada0d45",
+        "@matter/tools": "0.14.0-alpha.0-20250525-d6ada0d45",
+        "@matter/types": "0.14.0-alpha.0-20250525-d6ada0d45",
+        "@project-chip/matter.js": "0.14.0-alpha.0-20250525-d6ada0d45",
+        "ws": "^8.18.2",
         "yargs": "^17.7.2"
     },
     "engines": {

package/src/app.ts

@@ -12,9 +12,13 @@ import { Ble } from "#protocol";
 import yargs from "yargs/yargs";
 import { MatterNode } from "./MatterNode.js";
 import { Shell } from "./shell/Shell";
+import { initializeWebPlumbing } from "./web_plumbing.js";
 
 const PROMPT = "matter> ";
+const DEFAULT_WEBSOCKET_PORT = 3000;
 const logger = Logger.get("Shell");
+let theShell: Shell;
+
 if (process.stdin?.isTTY) Logger.format = LogFormat.ANSI;
 
 let theNode: MatterNode;
@@ -86,12 +90,38 @@ async function main() {
                             type: "string",
                             default: undefined,
                         },
+                        webSocketInterface: {
+                            description: "Enable WebSocket interface",
+                            type: "boolean",
+                            default: false,
+                        },
+                        webSocketPort: {
+                            description: "WebSocket and HTTP server port",
+                            type: "number",
+                            default: DEFAULT_WEBSOCKET_PORT,
+                        },
+                        webServer: {
+                            description: "Enable Web server when using WebSocket interface",
+                            type: "boolean",
+                            default: false,
+                        },
                     });
             },
             async argv => {
                 if (argv.help) return;
 
-                const { nodeNum, ble, bleHciId, nodeType, factoryReset, netInterface, logfile } = argv;
+                const {
+                    nodeNum,
+                    ble,
+                    bleHciId,
+                    nodeType,
+                    factoryReset,
+                    netInterface,
+                    logfile,
+                    webSocketInterface,
+                    webSocketPort,
+                    webServer,
+                } = argv;
 
                 theNode = new MatterNode(nodeNum, netInterface);
                 await theNode.initialize(factoryReset);
@@ -111,8 +141,12 @@ async function main() {
                 }
                 setLogLevel("default", await theNode.Store.get<string>("LogLevel", "info"));
 
-                const theShell = new Shell(theNode, nodeNum, PROMPT);
-
+                if (webSocketInterface) {
+                    Logger.format = LogFormat.PLAIN;
+                    initializeWebPlumbing(theNode, nodeNum, webSocketPort, webServer); // set up but wait for connect to create Shell
+                } else {
+                    theShell = new Shell(theNode, nodeNum, PROMPT, process.stdin, process.stdout);
+                }
                 if (bleHciId !== undefined) {
                     await theNode.Store.set("BleHciId", bleHciId);
                 }
@@ -130,11 +164,14 @@ async function main() {
                 }
 
                 console.log(`Started Node #${nodeNum} (Type: ${nodeType}) ${ble ? "with" : "without"} BLE`);
-                theShell.start(theNode.storageLocation);
+                if (!webSocketInterface) {
+                    theShell.start(theNode.storageLocation);
+                }
             },
         )
         .version(false)
-        .scriptName("shell");
+        .scriptName("shell")
+        .strict();
     await yargsInstance.wrap(yargsInstance.terminalWidth()).parseAsync();
 }
 

package/src/shell/Shell.ts

@@ -7,6 +7,7 @@
 import { MatterError } from "#general";
 import { createWriteStream, readFileSync } from "node:fs";
 import readline from "node:readline";
+import { Readable, Writable } from "node:stream";
 import yargs from "yargs/yargs";
 import { MatterNode } from "../MatterNode.js";
 import { exit } from "../app";
@@ -51,6 +52,8 @@ export class Shell {
         public theNode: MatterNode,
         public nodeNum: number,
         public prompt: string,
+        public input: Readable,
+        public output: Writable,
     ) {}
 
     start(storageBase?: string) {
@@ -80,9 +83,9 @@ export class Shell {
             }
         }
         this.readline = readline.createInterface({
-            input: process.stdin,
-            output: process.stdout,
-            terminal: true,
+            input: this.input,
+            output: this.output,
+            terminal: this.input === process.stdin && this.output === process.stdout,
             prompt: this.prompt,
             history: history.reverse(),
             historySize: MAX_HISTORY_SIZE,
@@ -103,12 +106,15 @@ export class Shell {
                 } catch (e) {
                     process.stderr.write(`Error happened during history file write: ${e}\n`);
                 }
-                exit()
-                    .then(() => process.exit(0))
-                    .catch(e => {
-                        process.stderr.write(`Close error: ${e}\n`);
-                        process.exit(1);
-                    });
+                // only exit if we are running in a terminal
+                if (this.input === process.stdin && this.output === process.stdout) {
+                    exit()
+                        .then(() => process.exit(0))
+                        .catch(e => {
+                            process.stderr.write(`Close error: ${e}\n`);
+                            process.exit(1);
+                        });
+                }
             });
 
         this.readline.prompt();

package/src/shell/cmd_subscribe.ts

@@ -21,19 +21,19 @@ export default function commands(theNode: MatterNode) {
         },
 
         handler: async (argv: any) => {
-            const { nodeId } = argv;
-            const node = (await theNode.connectAndGetNodes(nodeId))[0];
+            const { nodeId: subscribeNodeId } = argv;
+            const node = (await theNode.connectAndGetNodes(subscribeNodeId))[0];
 
             await node.subscribeAllAttributesAndEvents({
                 attributeChangedCallback: ({ path: { nodeId, clusterId, endpointId, attributeName }, value }) =>
                     console.log(
-                        `${nodeId}: Attribute ${nodeId}/${endpointId}/${clusterId}/${attributeName} changed to ${Diagnostic.json(
+                        `${subscribeNodeId}: Attribute ${nodeId}/${endpointId}/${clusterId}/${attributeName} changed to ${Diagnostic.json(
                             value,
                         )}`,
                     ),
                 eventTriggeredCallback: ({ path: { nodeId, clusterId, endpointId, eventName }, events }) =>
                     console.log(
-                        `${nodeId} Event ${nodeId}/${endpointId}/${clusterId}/${eventName} triggered with ${Diagnostic.json(
+                        `${subscribeNodeId} Event ${nodeId}/${endpointId}/${clusterId}/${eventName} triggered with ${Diagnostic.json(
                             events,
                         )}`,
                     ),

package/src/shell/webassets/index.html

@@ -0,0 +1,428 @@
+<!DOCTYPE html>
+<!--
+* @license
+* Copyright 2022-2025 Matter.js Authors
+* SPDX-License-Identifier: Apache-2.0
+
+-->
+<html lang="en">
+
+<head>
+    <meta charset="UTF-8">
+    <link rel="icon" href="/favicon.png" type="image/png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Matter Web Shell</title>
+    <style>
+        body {
+            font-family: Arial, sans-serif;
+            background-color: #f0f2f5;
+            margin: 0;
+            padding: 20px;
+            display: flex;
+            flex-direction: column;
+            gap: 20px;
+        }
+
+        .container {
+            max-width: 1200px;
+            margin: 0 auto;
+            display: grid;
+            grid-template-columns: 1fr 3fr;
+            gap: 20px;
+        }
+
+        .container>div {
+            background-color: #afa8a879;
+            border-radius: 8px;
+            padding: 5px;
+            box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
+            box-sizing: border-box;
+        }
+
+        .node-container {
+            background-color: #aba8af79;
+            border-radius: 8px;
+            padding: 2px;
+        }
+
+        .sidebar {
+            display: flex;
+            flex-direction: column;
+            gap: 20px;
+        }
+
+        .tiles {
+            display: grid;
+            grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
+            gap: 15px;
+        }
+
+        .tile {
+            background-color: white;
+            border-radius: 8px;
+            padding: 15px;
+            box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
+            cursor: default;
+            transition: transform 0.2s;
+        }
+
+        .input-section {
+            background-color: white;
+            border-radius: 8px;
+            padding: 15px;
+            box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
+        }
+
+        .console {
+            background-color: #4e4e4e;
+            color: #fff;
+            border-radius: 8px;
+            padding: 15px;
+            height: 200px;
+            overflow-y: auto;
+            overflow-x: hidden !important;
+            font-family: 'Courier New', monospace;
+            font-size: 14px;
+            box-sizing: border-box;
+            width: 100%;
+            max-width: 100%;
+        }
+
+        .console div {
+            overflow-wrap: break-word !important;
+            white-space: normal !important;
+            word-break: break-all;
+            max-width: 100%;
+        }
+
+        .console .sent {
+            color: #0f0;
+        }
+
+        .console .received {
+            color: #fff;
+        }
+
+        .console .status {
+            color: #ff0;
+        }
+
+        .console .error {
+            color: #f00;
+        }
+
+        .connecting-node-status {
+            color: rgb(245, 54, 54);
+        }
+
+        .connected-node-status {
+            color: rgb(31, 218, 62);
+        }
+
+        .on {
+            background-color: lightgoldenrodyellow;
+        }
+
+        .off {
+            background-color: darkgrey;
+        }
+
+        input {
+            width: 100%;
+            padding: 8px;
+            margin-top: 5px;
+            border: 1px solid #ccc;
+            border-radius: 4px;
+            box-sizing: border-box;
+            width: calc(100% - 10px);
+            margin-left: 5px;
+        }
+
+        h2 {
+            margin: 0 0 10px 0;
+            font-size: 18px;
+        }
+
+        button {
+            padding: 8px 12px;
+            border: 1px solid #ccc;
+            border-radius: 4px;
+            background-color: #ffffff;
+            color: #333;
+            font-family: Arial, sans-serif;
+            font-size: 14px;
+            cursor: pointer;
+            box-shadow: 0 1px 2px rgba(0, 0, 0, 0.1);
+            transition: background-color 0.2s, transform 0.2s;
+        }
+
+        button:hover {
+            background-color: #e0e0e0;
+            transform: scale(1.02);
+        }
+
+        button:active {
+            background-color: #d0d0d0;
+            transform: scale(0.98);
+        }
+
+        .button-container {
+            display: flex;
+            gap: 10px;
+            align-items: center;
+        }
+    </style>
+</head>
+
+<body>
+    <div class="container">
+        <div class="sidebar">
+            <div class="input-section">
+                <h2>Execute Shell Command</h2>
+                <input type="text" id="matterCommand" placeholder="Enter matter.js command">
+            </div>
+            <div class="input-section">
+                <h2>Pair Device</h2>
+                <input type="text" id="pairingCode" placeholder="Enter pairing code">
+            </div>
+            <div class="input-section">
+                <h2>Console</h2>
+                <div class="button-container">
+                    <input type="button" id="toggleconsole" value="Toggle"
+                        onclick="document.getElementById('console').style.display = document.getElementById('console').style.display === 'none' ? 'block' : 'none';">
+                    <input type="button" id="clearconsole" value="Clear" onclick="initConsole(true);">
+                </div>
+            </div>
+        </div>
+        <div>
+            <h2>matter.js Web Shell Example</h2>
+            <div class="tiles" id="tiles"></div>
+            <br>
+            <div class="console" id="console"></div>
+        </div>
+    </div>
+
+    <script>
+        const DEFAULT_PORT = 3000; // Default port for WebSocket connection
+        const tiles = document.getElementById('tiles');
+        const consoleDiv = document.getElementById('console');
+        const matterCommand = document.getElementById('matterCommand');
+        const pairingCode = document.getElementById('pairingCode');
+        const protocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
+        const host = window.location.hostname || 'localhost';
+        const defaultPort = window.location.port || DEFAULT_PORT;
+        const wsUrl = `${protocol}//${host}:${defaultPort}`;
+
+        let ws = null;
+        let reconnectAttempts = 0;
+
+        const ON_OFF = 6;
+        const ILLUMINANCE = 1024;
+        const TEMPERATURE = 1026;
+        const PRESSURE = 1027;
+        const HUMIDITY = 1029;
+        const VOLTAGE = 144; // etc.
+
+        const valueFormat = {
+            [VOLTAGE]: (value, units = 'v') => { return (value / 1000).toFixed(1) + units; },
+            [ILLUMINANCE]: (value, units = 'lux') => { return (value / 100).toFixed(1) + units; },
+            [TEMPERATURE]: (value, units = 'F') => { return (units === "F" ? (value / 100 * 9 / 5 + 32) : (value / 100)).toFixed(1) + '°' + units; },
+            [PRESSURE]: (value, units = 'mb') => { return (value / 10000).toFixed(1) + units; },
+            [HUMIDITY]: (value, units = '%') => { return (value / 100).toFixed(1) + units; },
+        }
+        function initConsole(clear) {
+            if (clear) consoleDiv.innerHTML = ''; // Clear the console
+            const dummy = document.createElement('div'); // Inject invisible wide line to reserve width
+            dummy.style.visibility = 'hidden';
+            dummy.style.height = '0';
+            dummy.textContent = 'X'.repeat(120);
+            consoleDiv.appendChild(dummy);
+        }
+        function logMessage(message, type) {
+            const MAX_MESSAGES = 1000; // Maximum number of messages to keep in the console
+            const fragment = document.createDocumentFragment();
+            const lines = message.split('\n');
+
+            lines.forEach(line => {
+                const msg = document.createElement('div');
+                msg.textContent = line;
+                msg.className = type;
+                fragment.appendChild(msg);
+            });
+
+            consoleDiv.appendChild(fragment);
+
+            while (consoleDiv.children.length > MAX_MESSAGES) consoleDiv.removeChild(consoleDiv.firstChild);
+
+            // Only scroll if the user was already at the bottom
+            const shouldScroll = consoleDiv.scrollTop + consoleDiv.clientHeight >= consoleDiv.scrollHeight - consoleDiv.lastChild.offsetHeight - 5; // Adjusted for new content
+            if (shouldScroll) consoleDiv.scrollTop = consoleDiv.scrollHeight;
+        }
+        function setupWebSocket() {
+            ws = new WebSocket(wsUrl);
+            initConsole(false);
+
+            ws.onopen = () => {
+                sendCommand('config loglevel set info'); // info level required for some msgs to be passed
+                sendCommand('nodes connect');
+                reconnectAttempts = 0;
+            }
+            ws.onclose = () => {
+                logMessage('WebSocket connection closed. Attempting to reconnect...', 'error');
+                scheduleReconnect();
+            };
+            ws.onerror = () => {
+                logMessage('WebSocket error...', 'error');
+            };
+            ws.onmessage = (event) => {
+                if (typeof event.data === 'string') {
+                    const message = event.data;
+                    let trimmed = message.slice(0, 5000); // don't let message to log get too long
+                    if (trimmed.length != message.length) trimmed += ' ...';
+                    logMessage(`Received: "${trimmed}"`, trimmed.toLowerCase().includes('error') ? 'error' : 'received');
+
+                    // result of nodes log command
+                    let matches = message.match(/INFO\s+PairedNode [^0-9]*(\d+)\D*/);
+                    if (matches) { // could save this message of extensive node data for later use
+                        let currentNode = matches[1];
+                        let currentEndpoint = null;
+                        let currentEndpointType = "";
+                        const lines = message.split('\n');
+                        lines.forEach(line => {
+                            let matches = line.match(/ MA-[\w*]+ endpoint#: (\d+) type: MA-([\w*]+) \(([^)]+)\)/);
+                            if (matches) { // could start collecting upcoming messages that define this endpoint
+                                currentEndpoint = matches[1];
+                                currentEndpointType = matches[2];
+                            }
+
+                            // device type list for the this node and endpoint
+                            matches = line.match(/deviceTypeList id: 0x0 val: ((\{.*?\})(?:\s*\{.*?\})*)/);
+                            if (matches) logMessage(`Device Type List: ${currentNode}/${currentEndpoint} ${matches[1]}`, 'status');
+
+                            // could also check and handle others, "moveToLevel", "movetohueandsaturation", etc.
+                            matches = line.match(/ (toggle$|on$|off$|measuredValue |voltage )/);
+                            if (matches) {
+                                if (!document.getElementById(`attr-${currentNode}/${currentEndpoint}/${matches[1]}`)) {
+                                    let element;
+                                    if (["on", "off", "toggle"].includes(matches[1])) {
+                                        element = document.createElement('button');
+                                        element.textContent = matches[1];
+                                        const cmd = `commands onoff ${matches[1]} ${currentNode} ${currentEndpoint}`;
+                                        element.onclick = () => sendCommand(cmd);
+                                        if (matches[1] === "on") sendCommand(`attributes onoff read onoff ${currentNode} ${currentEndpoint}`); // get initial state
+                                    } else element = document.createElement('span');
+
+                                    element.id = `attr-${currentNode}/${currentEndpoint}/${matches[1].trim()}`;
+                                    if (!document.getElementById(`${currentEndpoint}-container-${currentNode}`)) {
+                                        let endpointContainer = document.createElement('div');
+                                        endpointContainer.id = `${currentEndpoint}-container-${currentNode}`;
+                                        endpointContainer.className = 'node-container';
+                                        const small = document.createElement('small');
+                                        small.textContent = currentEndpointType.replace('MA-', '');
+                                        const br = document.createElement('br');
+                                        endpointContainer.innerHTML = '';
+                                        endpointContainer.appendChild(small);
+                                        endpointContainer.appendChild(br);
+                                        document.getElementById(`container-${currentNode}`).appendChild(endpointContainer);
+                                    }
+                                    document.getElementById(`container-${currentNode}`)?.appendChild(element);
+                                }
+                            }
+                        });
+                    }
+
+                    matches = message.match(/stateInformationCallback Node (\d+) (\S+)/);
+                    if (matches) {
+                        updateTile(matches[1], matches[2]);
+                        if (matches[2] === "connected") {
+                            sendCommand(`subscribe ${matches[1]}`);
+                            sendCommand(`nodes log ${matches[1]}`);
+                        }
+                    }
+
+                    matches = message.match(/(\d+): Attribute (\w+|\d+)\/(\d+)\/(\d+)\/(\w+) changed to (.+)/); // attribute changed
+                    if (matches) {
+                        if (matches[4] == ON_OFF) styleContainer(matches[1], matches[3], matches[6]);
+                        else if ([ILLUMINANCE, TEMPERATURE, PRESSURE, HUMIDITY, VOLTAGE].includes(Number(matches[4]))) {
+                            const formatter = valueFormat[matches[4]];
+                            const value = typeof formatter === 'function' ? formatter(matches[6]) : matches[6];
+                            const element = document.getElementById(`attr-${matches[1]}/${matches[3]}/${matches[5]}`);
+                            if (element) {
+                                const small = document.createElement("small");
+                                small.textContent = value;
+                                element.innerHTML = "";
+                                element.appendChild(small);
+                            }
+                        }
+                    }
+
+                    matches = message.match(/Attribute value for (\w+) (\d+)\/(\d+)\/(\d+)\/(\w+): (.+)/); // from "read attribute"
+                    if (matches)
+                        if (matches[1] === "onOff") styleContainer(matches[2], matches[3], matches[6]);
+                    // else if (matches[1] === etc. process as needed
+                }
+            }
+        }
+        function styleContainer(nodeId, endpoint, state) {
+            const element = document.getElementById(`${endpoint}-container-${nodeId}`);
+            element.classList.remove("on", "off");
+            element.classList.add(state === "true" ? "on" : "off");
+        }
+        function updateTile(nodeId, status) {
+            let tile = document.getElementById(`tile-${nodeId}`);
+            if (!tile) {
+                let container = document.createElement('div');
+                container.id = `container-${nodeId}`;
+                container.className = 'node-container';
+                tile = document.createElement('div');
+                tile.className = 'tile';
+                tile.id = `tile-${nodeId}`;
+                container.appendChild(tile);
+                tiles.appendChild(container);
+            }
+            const small = document.createElement("small");
+            small.appendChild(document.createTextNode("Node " + nodeId));
+            small.appendChild(document.createElement("br"));
+            const span = document.createElement("span");
+            span.className = status === "connected" ? "connected-node-status" : "connecting-node-status";
+            span.textContent = status;
+            small.appendChild(span);
+            tile.innerHTML = "";
+            tile.appendChild(small);
+        }
+        matterCommand.onkeypress = (e) => {
+            if (e.key === 'Enter') {
+                if (matterCommand.value === 'clear') initConsole(true);
+                else sendCommand(matterCommand.value ? matterCommand.value : "help");
+                matterCommand.value = '';
+            }
+        };
+        pairingCode.onkeypress = (e) => {
+            if (e.key === 'Enter') {
+                sendCommand(pairingCode.value ? `commission pair --pairing-code ${pairingCode.value}` : "help");
+                pairingCode.value = '';
+            }
+        };
+        function scheduleReconnect() {
+            const RECONNECT_DELAY = 1000; // Initial delay in ms
+            const MAX_RECONNECT_DELAY = 30000; // Max delay in ms
+            if (ws && ws.readyState !== WebSocket.CLOSED) return;
+            const delay = Math.min(RECONNECT_DELAY * Math.pow(2, reconnectAttempts), MAX_RECONNECT_DELAY);
+            logMessage(`Attempting to reconnect in ${delay / 1000} seconds...\n`, 'error');
+            setTimeout(() => {
+                reconnectAttempts++;
+                setupWebSocket();
+            }, delay);
+        }
+        function sendCommand(cmd, outputType = 'sent') {
+            if (ws && ws.readyState === WebSocket.OPEN) {
+                ws.send(cmd + '\n');
+                logMessage(`Sent: ${cmd}`, 'sent');
+            } else logMessage(`WebSocket not connected. Command "${cmd}" skipped.\n`, 'error');
+        }
+
+        document.addEventListener('DOMContentLoaded', () => { setupWebSocket(); });
+    </script>
+</body>
+
+</html>

package/src/web_plumbing.ts

@@ -0,0 +1,173 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { Logger, LogLevel, NotImplementedError } from "@matter/general";
+import { Readable, Writable } from "node:stream";
+import WebSocket, { Data, WebSocketServer } from "ws";
+import { MatterNode } from "./MatterNode.js";
+import { Shell } from "./shell/Shell";
+
+import fs from "fs";
+import http, { Server } from "node:http";
+import path from "path";
+
+// Store active WebSocket
+let client: WebSocket;
+let server: Server;
+let wss: WebSocketServer;
+const socketLogger = "websocket";
+
+export function initializeWebPlumbing(
+    theNode: MatterNode,
+    nodeNum: number,
+    webSocketPort: number,
+    webServer: boolean,
+): void {
+    if (webServer) {
+        const root: string = path.resolve(__dirname) ?? "./";
+
+        server = http
+            .createServer((req, res) => {
+                const url = req.url ?? "/";
+                const safePath: string = path.normalize(
+                    path.join(root, decodeURIComponent(url === "/" ? "/index.html" : url)),
+                );
+
+                // Check that the resolved path is within the root directory
+                if (!safePath.startsWith(root)) {
+                    res.writeHead(403).end("Forbidden");
+                    return;
+                }
+
+                fs.readFile(safePath, (err, data) => {
+                    if (err) return res.writeHead(404).end("Not Found");
+                    res.writeHead(200).end(data);
+                });
+            })
+            .listen(webSocketPort);
+        wss = new WebSocketServer({ server });
+    } else wss = new WebSocketServer({ port: webSocketPort });
+
+    console.info(`WebSocket server running on ws://localhost:${webSocketPort}`);
+
+    console.log =
+        // console.debug = // too much traffic - kills the websocket
+        console.info =
+        console.warn =
+        console.error =
+            (...args: any[]) => {
+                if (client && client.readyState === WebSocket.OPEN) {
+                    client.send(args.map(arg => (typeof arg === "object" ? JSON.stringify(arg) : arg)).join(" "));
+                } else
+                    process.stdout.write(
+                        args.map(arg => (typeof arg === "object" ? JSON.stringify(arg) : arg)).join(" ") + "\n",
+                    );
+            };
+
+    wss.on("connection", (ws: WebSocket) => {
+        if (client && client.readyState === WebSocket.OPEN) {
+            ws.send("ERROR: Shell in use by another client");
+            ws.close();
+            return;
+        }
+
+        client = ws; // Track the client
+
+        createWebSocketLogger(ws)
+            .then(logger => {
+                Logger.removeLogger("Shell");
+                Logger.addLogger(socketLogger, logger);
+            })
+            .catch(err => {
+                if (!(err instanceof NotImplementedError)) {
+                    console.error("Failed to add WebSocket logger: " + err);
+                }
+            });
+
+        const shell = new Shell(theNode, nodeNum, "", createReadableStream(ws), createWritableStream(ws));
+        shell.start(theNode.storageLocation);
+
+        ws.on("close", () => {
+            process.stdout.write("Client disconnected\n");
+            try {
+                if (Logger.getLoggerForIdentifier(socketLogger) !== undefined) {
+                    Logger.removeLogger(socketLogger);
+                }
+            } catch (err) {
+                // Intentionally left empty
+            }
+
+            client = ws;
+        });
+        ws.on("error", err => {
+            process.stderr.write(`WebSocket error: ${err.message}\n`);
+            try {
+                if (Logger.getLoggerForIdentifier(socketLogger) !== undefined) {
+                    Logger.removeLogger(socketLogger);
+                }
+            } catch (err) {
+                // Intentionally left empty
+            }
+        });
+    });
+
+    async function createWebSocketLogger(socket: WebSocket): Promise<(level: LogLevel, formattedLog: string) => void> {
+        if (socket.readyState === WebSocket.CONNECTING) {
+            await new Promise<void>((resolve, reject) => {
+                socket.onopen = () => resolve();
+                socket.onerror = err => reject(new Error(`WebSocket error: ${err.type}`));
+            });
+        }
+
+        return (__level: LogLevel, formattedLog: string) => {
+            if (socket.readyState === WebSocket.OPEN) {
+                socket.send(formattedLog);
+            } else {
+                process.stderr.write(`WebSocket logger not open, log dropped: ${formattedLog}\n`);
+            }
+        };
+    }
+}
+function createReadableStream(ws: WebSocket): Readable {
+    const readable = new Readable({ read() {} });
+
+    ws.on("message", (data: Data) => {
+        const chunk = Buffer.isBuffer(data) ? data : Buffer.from(data.toString());
+
+        // add the data to our readable stream that the readLine instance is reading from
+        readable.push(chunk);
+    });
+
+    ws.on("close", () => {
+        readable.push(null);
+    });
+    ws.on("error", err => {
+        readable.emit("error", err);
+        readable.push(null);
+    });
+
+    return readable;
+}
+function createWritableStream(ws: WebSocket): Writable {
+    const writable = new Writable({
+        write(chunk: Buffer, _encoding: string, callback: (error?: Error | null) => void) {
+            if (ws.readyState === WebSocket.OPEN) {
+                ws.send(chunk, callback);
+            } else {
+                if (chunk.length > 0) process.stderr.write(`ERROR: WebSocket is not open. Failed to send "${chunk}"\n`);
+            }
+        },
+        final(callback: (error?: Error | null) => void) {
+            if (ws.readyState === WebSocket.OPEN) {
+                ws.close();
+            }
+            callback();
+        },
+    });
+
+    ws.on("error", err => writable.emit("WebSocket Write Error: ", err));
+    return writable;
+}