@matter-server/ws-controller 0.2.0-alpha.0-00000000-000000000

package/dist/esm/controller/Nodes.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @license
+ * Copyright 2025-2026 Open Home Foundation
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { NodeId } from "@matter/main";
+import { ClusterClientObj } from "@matter/main/protocol";
+import { ClusterId, ClusterType, EndpointNumber } from "@matter/main/types";
+import { InteractionClient } from "@project-chip/matter.js/cluster";
+import { PairedNode } from "@project-chip/matter.js/device";
+import { AttributeDataCache } from "./AttributeDataCache.js";
+/**
+ * Manages node storage and provides access to nodes and their clients.
+ *
+ * This class handles:
+ * - Storage of PairedNode instances
+ * - Node retrieval and existence checking
+ * - Access to interaction clients and cluster clients
+ * - Attribute data caching
+ */
+export declare class Nodes {
+    #private;
+    /**
+     * Get the attribute cache instance.
+     */
+    get attributeCache(): AttributeDataCache;
+    /**
+     * Get all node IDs.
+     */
+    getIds(): NodeId[];
+    /**
+     * Get a node by ID.
+     * @throws ServerError if node not found
+     */
+    get(nodeId: NodeId): PairedNode;
+    /**
+     * Check if a node exists.
+     */
+    has(nodeId: NodeId): boolean;
+    /**
+     * Add or update a node in storage.
+     */
+    set(nodeId: NodeId, node: PairedNode): void;
+    /**
+     * Remove a node from storage and clear its attribute cache.
+     */
+    delete(nodeId: NodeId): void;
+    /**
+     * Get the interaction client for a node.
+     */
+    interactionClientFor(nodeId: NodeId): Promise<InteractionClient>;
+    /**
+     * Get a cluster client by cluster ID for a specific endpoint on a node.
+     * @throws Error if endpoint or cluster not found
+     */
+    clusterClientByIdFor(nodeId: NodeId, endpointId: EndpointNumber, clusterId: ClusterId): ClusterClientObj<any>;
+    /**
+     * Get a typed cluster client for a specific endpoint on a node.
+     */
+    clusterClientFor<const T extends ClusterType>(nodeId: NodeId, endpointId: EndpointNumber, cluster: T): ClusterClientObj<T>;
+}
+//# sourceMappingURL=Nodes.d.ts.map

package/dist/esm/controller/Nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Nodes.d.ts","sourceRoot":"","sources":["../../../src/controller/Nodes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAE5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;;;;;GAQG;AACH,qBAAa,KAAK;;IAId;;OAEG;IACH,IAAI,cAAc,IAAI,kBAAkB,CAEvC;IAED;;OAEG;IACH,MAAM,IAAI,MAAM,EAAE;IAIlB;;;OAGG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU;IAQ/B;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI;IAI3C;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK5B;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIhE;;;OAGG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC;IAkB7G;;OAEG;IACH,gBAAgB,CAAC,KAAK,CAAC,CAAC,SAAS,WAAW,EACxC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,CAAC,GACX,gBAAgB,CAAC,CAAC,CAAC;CAGzB"}

package/dist/esm/controller/Nodes.js

@@ -0,0 +1,85 @@
+/**
+ * @license
+ * Copyright 2025-2026 Open Home Foundation
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ServerError } from "../types/WebSocketMessageTypes.js";
+import { AttributeDataCache } from "./AttributeDataCache.js";
+class Nodes {
+  #nodes = /* @__PURE__ */ new Map();
+  #attributeCache = new AttributeDataCache();
+  /**
+   * Get the attribute cache instance.
+   */
+  get attributeCache() {
+    return this.#attributeCache;
+  }
+  /**
+   * Get all node IDs.
+   */
+  getIds() {
+    return Array.from(this.#nodes.keys());
+  }
+  /**
+   * Get a node by ID.
+   * @throws ServerError if node not found
+   */
+  get(nodeId) {
+    const node = this.#nodes.get(nodeId);
+    if (node === void 0) {
+      throw ServerError.nodeNotExists(nodeId);
+    }
+    return node;
+  }
+  /**
+   * Check if a node exists.
+   */
+  has(nodeId) {
+    return this.#nodes.has(nodeId);
+  }
+  /**
+   * Add or update a node in storage.
+   */
+  set(nodeId, node) {
+    this.#nodes.set(nodeId, node);
+  }
+  /**
+   * Remove a node from storage and clear its attribute cache.
+   */
+  delete(nodeId) {
+    this.#nodes.delete(nodeId);
+    this.#attributeCache.delete(nodeId);
+  }
+  /**
+   * Get the interaction client for a node.
+   */
+  interactionClientFor(nodeId) {
+    return this.get(nodeId).getInteractionClient();
+  }
+  /**
+   * Get a cluster client by cluster ID for a specific endpoint on a node.
+   * @throws Error if endpoint or cluster not found
+   */
+  clusterClientByIdFor(nodeId, endpointId, clusterId) {
+    const node = this.get(nodeId);
+    const endpoint = endpointId === 0 ? node.getRootEndpoint() : node.getDeviceById(endpointId);
+    if (endpoint === void 0) {
+      throw new Error(`Endpoint ${endpointId} on node ${nodeId} not found`);
+    }
+    const client = endpoint.getClusterClientById(clusterId);
+    if (client === void 0) {
+      throw new Error(`Cluster ${clusterId} on endpoint ${endpointId} on node ${nodeId} not found`);
+    }
+    return client;
+  }
+  /**
+   * Get a typed cluster client for a specific endpoint on a node.
+   */
+  clusterClientFor(nodeId, endpointId, cluster) {
+    return this.clusterClientByIdFor(nodeId, endpointId, cluster.id);
+  }
+}
+export {
+  Nodes
+};
+//# sourceMappingURL=Nodes.js.map

package/dist/esm/controller/Nodes.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/controller/Nodes.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAWA,SAAS,mBAAmB;AAC5B,SAAS,0BAA0B;AAW5B,MAAM,MAAM;AAAA,EACf,SAAS,oBAAI,IAAwB;AAAA,EACrC,kBAAkB,IAAI,mBAAmB;AAAA;AAAA;AAAA;AAAA,EAKzC,IAAI,iBAAqC;AACrC,WAAO,KAAK;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKA,SAAmB;AACf,WAAO,MAAM,KAAK,KAAK,OAAO,KAAK,CAAC;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,IAAI,QAA4B;AAC5B,UAAM,OAAO,KAAK,OAAO,IAAI,MAAM;AACnC,QAAI,SAAS,QAAW;AACpB,YAAM,YAAY,cAAc,MAAM;AAAA,IAC1C;AACA,WAAO;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,QAAyB;AACzB,WAAO,KAAK,OAAO,IAAI,MAAM;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,QAAgB,MAAwB;AACxC,SAAK,OAAO,IAAI,QAAQ,IAAI;AAAA,EAChC;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,QAAsB;AACzB,SAAK,OAAO,OAAO,MAAM;AACzB,SAAK,gBAAgB,OAAO,MAAM;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA,EAKA,qBAAqB,QAA4C;AAC7D,WAAO,KAAK,IAAI,MAAM,EAAE,qBAAqB;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,qBAAqB,QAAgB,YAA4B,WAA6C;AAC1G,UAAM,OAAO,KAAK,IAAI,MAAM;AAE5B,UAAM,WAAW,eAAe,IAAI,KAAK,gBAAgB,IAAI,KAAK,cAAc,UAAU;AAE1F,QAAI,aAAa,QAAW;AACxB,YAAM,IAAI,MAAM,YAAY,UAAU,YAAY,MAAM,YAAY;AAAA,IACxE;AAEA,UAAM,SAAS,SAAS,qBAAqB,SAAS;AAEtD,QAAI,WAAW,QAAW;AACtB,YAAM,IAAI,MAAM,WAAW,SAAS,gBAAgB,UAAU,YAAY,MAAM,YAAY;AAAA,IAChG;AAEA,WAAO;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAKA,iBACI,QACA,YACA,SACmB;AACnB,WAAO,KAAK,qBAAqB,QAAQ,YAAY,QAAQ,EAAE;AAAA,EACnE;AACJ;",
+  "names": []
+}

package/dist/esm/controller/TestNodeCommandHandler.d.ts

@@ -0,0 +1,84 @@
+/**
+ * @license
+ * Copyright 2025-2026 Open Home Foundation
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { NodeId, Observable } from "@matter/main";
+import { AttributeResponseStatus, AttributesData, InvokeRequest, MatterNodeData, NodeCommandHandler, ReadAttributeRequest, ReadAttributeResponse, WriteAttributeRequest } from "../types/CommandHandler.js";
+import { MatterNode } from "../types/WebSocketMessageTypes.js";
+/**
+ * Command handler for test nodes (imported diagnostic dumps).
+ * Test nodes are stored in memory and provide mock responses for commands.
+ */
+export declare class TestNodeCommandHandler implements NodeCommandHandler {
+    #private;
+    /** Observable for node added events */
+    readonly nodeAdded: Observable<[nodeId: NodeId, node: MatterNode], void>;
+    /** Observable for node removed events */
+    readonly nodeRemoved: Observable<[nodeId: NodeId], void>;
+    /**
+     * Check if a node ID is in the test node range (>= TEST_NODE_START).
+     */
+    static isTestNodeId(nodeId: number | bigint): boolean;
+    /**
+     * Check if this handler manages the given node ID.
+     */
+    hasNode(nodeId: NodeId): boolean;
+    /**
+     * Get all test node IDs.
+     */
+    getNodeIds(): NodeId[];
+    /**
+     * Get all test nodes.
+     */
+    getNodes(): MatterNode[];
+    /**
+     * Get a test node by ID.
+     */
+    getNode(nodeId: NodeId): MatterNode | undefined;
+    /**
+     * Get full node details in WebSocket API format.
+     */
+    getNodeDetails(nodeId: NodeId): Promise<MatterNodeData>;
+    /**
+     * Read multiple attributes from a test node by path strings.
+     * Handles wildcards in paths.
+     */
+    handleReadAttributes(nodeId: NodeId, attributePaths: string[], _fabricFiltered?: boolean): Promise<AttributesData>;
+    /**
+     * Import test nodes from a diagnostic dump.
+     * @param dump JSON string containing the diagnostic dump
+     * @returns Array of imported node IDs
+     */
+    importTestNodes(dump: string): NodeId[];
+    /**
+     * Read attributes from a test node.
+     * Returns values from the stored attributes map.
+     */
+    handleReadAttribute(data: ReadAttributeRequest): Promise<ReadAttributeResponse>;
+    /**
+     * Write an attribute to a test node.
+     * Logs the write and returns success (no actual write occurs).
+     */
+    handleWriteAttribute(data: WriteAttributeRequest): Promise<AttributeResponseStatus>;
+    /**
+     * Invoke a command on a test node.
+     * Logs the command and returns null (no actual command execution).
+     */
+    handleInvoke(data: InvokeRequest): Promise<unknown>;
+    /**
+     * Get IP addresses for a test node.
+     * Returns mock IP addresses.
+     */
+    getNodeIpAddresses(_nodeId: NodeId, _preferCache?: boolean): Promise<string[]>;
+    /**
+     * Ping a test node.
+     * Returns mock success results.
+     */
+    pingNode(_nodeId: NodeId, _attempts?: number): Promise<Record<string, boolean>>;
+    /**
+     * Remove a test node.
+     */
+    removeNode(nodeId: NodeId): Promise<void>;
+}
+//# sourceMappingURL=TestNodeCommandHandler.d.ts.map

package/dist/esm/controller/TestNodeCommandHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestNodeCommandHandler.d.ts","sourceRoot":"","sources":["../../../src/controller/TestNodeCommandHandler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAU,MAAM,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,EACH,uBAAuB,EACvB,cAAc,EACd,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,UAAU,EAAmB,MAAM,mCAAmC,CAAC;AAIhF;;;GAGG;AACH,qBAAa,sBAAuB,YAAW,kBAAkB;;IAG7D,uCAAuC;IACvC,QAAQ,CAAC,SAAS,uDAAwD;IAE1E,yCAAyC;IACzC,QAAQ,CAAC,WAAW,qCAAsC;IAE1D;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;IAKrD;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;IAItB;;OAEG;IACH,QAAQ,IAAI,UAAU,EAAE;IAIxB;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI/C;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAQ7D;;;OAGG;IACG,oBAAoB,CACtB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EAAE,EACxB,eAAe,CAAC,EAAE,OAAO,GAC1B,OAAO,CAAC,cAAc,CAAC;IA6B1B;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IA6DvC;;;OAGG;IACG,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAkDrF;;;OAGG;IACG,oBAAoB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAezF;;;OAGG;IACG,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAWzD;;;OAGG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIpF;;;OAGG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIrF;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAYlD"}

package/dist/esm/controller/TestNodeCommandHandler.js

@@ -0,0 +1,225 @@
+/**
+ * @license
+ * Copyright 2025-2026 Open Home Foundation
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Logger, NodeId, Observable } from "@matter/main";
+import { parseBigIntAwareJson, splitAttributePath } from "../server/Converters.js";
+import { TEST_NODE_START } from "../types/WebSocketMessageTypes.js";
+const logger = Logger.get("TestNodeCommandHandler");
+class TestNodeCommandHandler {
+  #testNodes = /* @__PURE__ */ new Map();
+  /** Observable for node added events */
+  nodeAdded = new Observable();
+  /** Observable for node removed events */
+  nodeRemoved = new Observable();
+  /**
+   * Check if a node ID is in the test node range (>= TEST_NODE_START).
+   */
+  static isTestNodeId(nodeId) {
+    const bigId = typeof nodeId === "bigint" ? nodeId : BigInt(nodeId);
+    return bigId >= TEST_NODE_START;
+  }
+  /**
+   * Check if this handler manages the given node ID.
+   */
+  hasNode(nodeId) {
+    return this.#testNodes.has(BigInt(nodeId));
+  }
+  /**
+   * Get all test node IDs.
+   */
+  getNodeIds() {
+    return Array.from(this.#testNodes.keys()).map((id) => NodeId(id));
+  }
+  /**
+   * Get all test nodes.
+   */
+  getNodes() {
+    return Array.from(this.#testNodes.values());
+  }
+  /**
+   * Get a test node by ID.
+   */
+  getNode(nodeId) {
+    return this.#testNodes.get(BigInt(nodeId));
+  }
+  /**
+   * Get full node details in WebSocket API format.
+   */
+  async getNodeDetails(nodeId) {
+    const testNode = this.#testNodes.get(BigInt(nodeId));
+    if (testNode === void 0) {
+      throw new Error(`Test node ${nodeId} not found`);
+    }
+    return testNode;
+  }
+  /**
+   * Read multiple attributes from a test node by path strings.
+   * Handles wildcards in paths.
+   */
+  async handleReadAttributes(nodeId, attributePaths, _fabricFiltered) {
+    const testNode = this.#testNodes.get(BigInt(nodeId));
+    if (testNode === void 0) {
+      throw new Error(`Test node ${nodeId} not found`);
+    }
+    const result = {};
+    for (const path of attributePaths) {
+      const { endpointId, clusterId, attributeId } = splitAttributePath(path);
+      if (path.includes("*")) {
+        for (const [attrPath, value] of Object.entries(testNode.attributes)) {
+          const parts = attrPath.split("/").map(Number);
+          if ((endpointId === void 0 || parts[0] === endpointId) && (clusterId === void 0 || parts[1] === clusterId) && (attributeId === void 0 || parts[2] === attributeId)) {
+            result[attrPath] = value;
+          }
+        }
+      } else {
+        result[path] = testNode.attributes[path];
+      }
+    }
+    return result;
+  }
+  /**
+   * Import test nodes from a diagnostic dump.
+   * @param dump JSON string containing the diagnostic dump
+   * @returns Array of imported node IDs
+   */
+  importTestNodes(dump) {
+    const dumpData = parseBigIntAwareJson(dump);
+    let dumpNodes;
+    if (dumpData?.data?.node) {
+      dumpNodes = [dumpData.data.node];
+    } else if (dumpData?.data?.server?.nodes) {
+      dumpNodes = Object.values(dumpData.data.server.nodes);
+    } else if (dumpData?.data?.nodes) {
+      dumpNodes = Object.values(dumpData.data.nodes);
+    } else {
+      throw new Error("Invalid dump format: cannot find node data");
+    }
+    let nextTestNodeId = TEST_NODE_START;
+    for (const existingId of this.#testNodes.keys()) {
+      if (existingId >= nextTestNodeId) {
+        nextTestNodeId = existingId + 1n;
+      }
+    }
+    const importedNodeIds = [];
+    for (const nodeDict of dumpNodes) {
+      const testNodeId = nextTestNodeId++;
+      const nodeId = NodeId(testNodeId);
+      const testNode = {
+        node_id: testNodeId,
+        date_commissioned: nodeDict.date_commissioned,
+        last_interview: nodeDict.last_interview,
+        interview_version: nodeDict.interview_version,
+        available: nodeDict.available,
+        is_bridge: nodeDict.is_bridge,
+        attributes: nodeDict.attributes,
+        attribute_subscriptions: []
+      };
+      this.#testNodes.set(testNodeId, testNode);
+      importedNodeIds.push(nodeId);
+      logger.info(`Imported test node ${testNodeId} with ${Object.keys(testNode.attributes).length} attributes`);
+      this.nodeAdded.emit(nodeId, testNode);
+    }
+    return importedNodeIds;
+  }
+  /**
+   * Read attributes from a test node.
+   * Returns values from the stored attributes map.
+   */
+  async handleReadAttribute(data) {
+    const { nodeId, endpointId, clusterId, attributeId } = data;
+    const testNode = this.#testNodes.get(BigInt(nodeId));
+    if (testNode === void 0) {
+      throw new Error(`Test node ${nodeId} not found`);
+    }
+    const values = [];
+    const hasWildcards = endpointId === void 0 || clusterId === void 0 || attributeId === void 0;
+    if (hasWildcards) {
+      for (const [attrPath, value] of Object.entries(testNode.attributes)) {
+        const parts = attrPath.split("/").map(Number);
+        if ((endpointId === void 0 || parts[0] === endpointId) && (clusterId === void 0 || parts[1] === clusterId) && (attributeId === void 0 || parts[2] === attributeId)) {
+          values.push({
+            endpointId: parts[0],
+            clusterId: parts[1],
+            attributeId: parts[2],
+            dataVersion: 0,
+            value
+          });
+        }
+      }
+    } else {
+      const path = `${endpointId}/${clusterId}/${attributeId}`;
+      const value = testNode.attributes[path];
+      if (value !== void 0) {
+        values.push({
+          endpointId,
+          clusterId,
+          attributeId,
+          dataVersion: 0,
+          value
+        });
+      }
+    }
+    logger.debug(`read_attribute for test node ${nodeId}: ${values.length} values`);
+    return { values };
+  }
+  /**
+   * Write an attribute to a test node.
+   * Logs the write and returns success (no actual write occurs).
+   */
+  async handleWriteAttribute(data) {
+    const { nodeId, endpointId, clusterId, attributeId, value } = data;
+    logger.debug(
+      `write_attribute for test node ${nodeId} on ${endpointId}/${clusterId}/${attributeId} - value: ${JSON.stringify(value)}`
+    );
+    return {
+      endpointId,
+      clusterId,
+      attributeId,
+      status: 0
+      // Success
+    };
+  }
+  /**
+   * Invoke a command on a test node.
+   * Logs the command and returns null (no actual command execution).
+   */
+  async handleInvoke(data) {
+    const { nodeId, endpointId, clusterId, commandName, data: payload } = data;
+    logger.debug(
+      `device_command for test node ${nodeId} on endpoint ${endpointId} - cluster ${clusterId} - command ${commandName} - payload: ${JSON.stringify(payload)}`
+    );
+    return null;
+  }
+  /**
+   * Get IP addresses for a test node.
+   * Returns mock IP addresses.
+   */
+  async getNodeIpAddresses(_nodeId, _preferCache) {
+    return ["0.0.0.0", "0000:1111:2222:3333:4444"];
+  }
+  /**
+   * Ping a test node.
+   * Returns mock success results.
+   */
+  async pingNode(_nodeId, _attempts) {
+    return { "0.0.0.0": true, "0000:1111:2222:3333:4444": true };
+  }
+  /**
+   * Remove a test node.
+   */
+  async removeNode(nodeId) {
+    const bigId = BigInt(nodeId);
+    if (!this.#testNodes.has(bigId)) {
+      throw new Error(`Test node ${nodeId} not found`);
+    }
+    logger.info(`Removing test node ${nodeId}`);
+    this.#testNodes.delete(bigId);
+    this.nodeRemoved.emit(nodeId);
+  }
+}
+export {
+  TestNodeCommandHandler
+};
+//# sourceMappingURL=TestNodeCommandHandler.js.map

package/dist/esm/controller/TestNodeCommandHandler.js.map

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

package/dist/esm/data/VendorIDs.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025-2026 Open Home Foundation
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const VendorIds: Record<string, string>;
+//# sourceMappingURL=VendorIDs.d.ts.map

package/dist/esm/data/VendorIDs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VendorIDs.d.ts","sourceRoot":"","sources":["../../../src/data/VendorIDs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA2sC5C,CAAC"}