@riddix/hamh 2.1.0-alpha.866 → 2.1.0-alpha.868

package/dist/backend/cli.js

@@ -132397,6 +132397,18 @@ var init_bridge_config_schema = __esm({
           type: "boolean",
           default: false
         },
+        supportTermsAndConditions: {
+          title: "Accept Terms and Conditions commands (Alexa pairing diagnostic)",
+          description: "Advertise the Matter 1.4 TermsAndConditions feature and accept the SetTcAcknowledgements command instead of rejecting it as unsupported. No terms are enforced, the bridge accepts any acknowledgement. Alexa sends this command during pairing and some Echo firmwares may stall when it fails (#449). Restart the bridge and re-pair after changing it. Default off.",
+          type: "boolean",
+          default: false
+        },
+        enableMatterTcp: {
+          title: "Matter over TCP (Alexa pairing diagnostic)",
+          description: "Open a Matter TCP listener and advertise TCP support alongside UDP. Some controllers support Matter over TCP and may attempt it, the Echo Dot advertises it (#449). Camera bridges enable this automatically already. Restart the bridge and re-pair after enabling it. Disabling needs a matterhub restart. Default off.",
+          type: "boolean",
+          default: false
+        },
         fastSessionRecovery: {
           title: "Fast Session Recovery (Google offline workaround)",
           description: "When a controller drops all subscriptions, clean up the dead session and re-announce after 5 seconds instead of 60. Opt-in for Google Home users whose devices go offline after a cancelled subscription (#386). It shortens the offline window but cannot stop the controller from rejecting the subscription. Default off.",
@@ -155230,6 +155242,32 @@ init_esm5();
 // src/matter/endpoints/server-mode-server-node.ts
 init_types2();
 
+// src/plugins/builtin/camera/camera-tcp-requirement.ts
+import { readFileSync as readFileSync6 } from "node:fs";
+var CAMERA_TCP_CONFIG = { incoming: true, outgoing: false };
+async function applyTcpFlagBeforeStart(server, flags2) {
+  if (!flags2?.enableMatterTcp || server.state.network.tcp) {
+    return;
+  }
+  await server.set({ network: { tcp: CAMERA_TCP_CONFIG } });
+}
+function parseCameraList(cameras) {
+  if (typeof cameras !== "string") return [];
+  return cameras.split(",").map((s) => s.trim()).filter(Boolean);
+}
+function bridgeNeedsTcpForCameras(storageDir, bridgeId) {
+  try {
+    const raw = readFileSync6(
+      pluginStorageFilePath(storageDir, bridgeId, "camera"),
+      "utf-8"
+    );
+    const json = JSON.parse(raw);
+    return parseCameraList(json.config?.cameras).length > 0;
+  } catch {
+    return false;
+  }
+}
+
 // src/utils/sanitize-matter-string.ts
 function sanitizeMatterString(value) {
   return value.replace(/[*!~\x00-\x1f\x7f]/g, "").trim();
@@ -155281,165 +155319,6 @@ function matterSubscriptionOptions() {
   };
 }
 
-// src/matter/endpoints/server-mode-server-node.ts
-var logger196 = Logger.get("ServerModeServerNode");
-var ServerModeServerNode = class extends ServerNode {
-  deviceEndpoints = /* @__PURE__ */ new Map();
-  featureFlags;
-  serialNumberSuffix;
-  constructor(env, bridgeData) {
-    super({
-      id: bridgeData.id,
-      environment: env,
-      network: {
-        port: bridgeData.port,
-        // Shared zero-jitter window, see matterSubscriptionOptions: 60s max so
-        // iOS does not show a stale "Updating" tile (#287), no jitter so the
-        // keepalive stays inside a controller's ceiling (#386).
-        subscriptionOptions: matterSubscriptionOptions()
-      },
-      productDescription: {
-        name: bridgeData.name,
-        deviceType: DeviceTypeId(RoboticVacuumCleanerDevice.deviceType)
-      },
-      basicInformation: {
-        ...legacySpecBasicInformation(bridgeData.featureFlags),
-        uniqueId: bridgeData.id,
-        nodeLabel: trimToLength(bridgeData.name, 32, "..."),
-        vendorId: VendorId(bridgeData.basicInformation.vendorId),
-        vendorName: bridgeData.basicInformation.vendorName,
-        productId: bridgeData.basicInformation.productId,
-        productName: bridgeData.basicInformation.productName,
-        productLabel: bridgeData.basicInformation.productLabel,
-        serialNumber: `server-${bridgeData.id}`.substring(0, 32),
-        hardwareVersion: bridgeData.basicInformation.hardwareVersion,
-        softwareVersion: bridgeData.basicInformation.softwareVersion,
-        hardwareVersionString: bridgeData.basicInformation.hardwareVersionString,
-        softwareVersionString: bridgeData.basicInformation.softwareVersionString ?? String(bridgeData.basicInformation.softwareVersion),
-        ...bridgeData.countryCode ? { location: bridgeData.countryCode } : {}
-      },
-      subscriptions: {
-        persistenceEnabled: false
-      }
-    });
-    this.featureFlags = bridgeData.featureFlags;
-    this.serialNumberSuffix = bridgeData.serialNumberSuffix;
-  }
-  /** Number of device endpoints currently attached. */
-  get deviceCount() {
-    return this.deviceEndpoints.size;
-  }
-  /**
-   * Add a device endpoint to this server node. Several endpoints per node are
-   * supported (#301); the call is idempotent per endpoint id.
-   */
-  async addDevice(endpoint) {
-    if (this.deviceEndpoints.has(endpoint.id)) {
-      return;
-    }
-    this.deviceEndpoints.set(endpoint.id, endpoint);
-    await this.add(endpoint);
-  }
-  /**
-   * Drop one device reference after the endpoint has been deleted externally.
-   * Must be called before re-adding an endpoint with the same id.
-   */
-  forgetDevice(endpoint) {
-    this.deviceEndpoints.delete(endpoint.id);
-  }
-  /** Drop all device references after the endpoints were deleted externally. */
-  clearDevices() {
-    this.deviceEndpoints.clear();
-  }
-  /**
-   * Update root-level BasicInformation with entity-specific data.
-   * In server mode, controllers (Apple Home, Alexa) read the root node's
-   * BasicInformation, not the device endpoint's BridgedDeviceBasicInformation.
-   * Without this, server-mode devices show bridge defaults (e.g. "riddix" / "MatterHub").
-   */
-  async updateDeviceIdentity(entityId, device, mapping, friendlyName) {
-    const nodeLabel = trimToLength(mapping?.customName, 32, "...") ?? trimToLength(friendlyName, 32, "...") ?? trimToLength(entityId, 32, "...");
-    const productNameFromNodeLabel = this.featureFlags?.productNameFromNodeLabel === true ? trimToLength(sanitizeMatterString(nodeLabel ?? ""), 32, "...") ?? void 0 : void 0;
-    const maxRawLen = 32 - (this.serialNumberSuffix?.length ?? 0);
-    const registrySerial = this.featureFlags?.useHaRegistrySerial ? trimToLength(device?.serial_number, maxRawLen, "...") : void 0;
-    const rawSerial = trimToLength(mapping?.customSerialNumber, maxRawLen, "...") ?? registrySerial;
-    const serialNumber = rawSerial && this.serialNumberSuffix ? `${rawSerial}${this.serialNumberSuffix}` : rawSerial;
-    const basicInformation = dropUndefined({
-      vendorName: trimToLength(mapping?.customVendorName, 32, "...") ?? trimToLength(device?.manufacturer, 32, "..."),
-      productName: trimToLength(mapping?.customProductName, 32, "...") ?? productNameFromNodeLabel ?? trimToLength(device?.model_id, 32, "...") ?? trimToLength(device?.model, 32, "..."),
-      productLabel: trimToLength(device?.model, 64, "..."),
-      nodeLabel,
-      serialNumber,
-      hardwareVersionString: trimToLength(device?.hw_version, 64, "..."),
-      softwareVersionString: trimToLength(device?.sw_version, 64, "...")
-    });
-    if (Object.keys(basicInformation).length === 0) {
-      return;
-    }
-    try {
-      await this.set({ basicInformation });
-    } catch (e) {
-      const msg = e instanceof Error ? e.message : String(e);
-      logger196.warn(
-        `Failed to apply server-mode identity for ${entityId}: ${msg}`
-      );
-    }
-  }
-  // align the pairing device-type hint with the real device (default is vacuum)
-  async updateAdvertisedDeviceType(deviceType) {
-    try {
-      await this.set({ productDescription: { deviceType } });
-    } catch (e) {
-      const msg = e instanceof Error ? e.message : String(e);
-      logger196.warn(`Failed to set server-mode device type: ${msg}`);
-    }
-  }
-  async factoryReset() {
-    await this.cancel();
-    await this.erase();
-  }
-};
-function dropUndefined(obj) {
-  const result = {};
-  for (const key in obj) {
-    if (obj[key] !== void 0) {
-      result[key] = obj[key];
-    }
-  }
-  return result;
-}
-
-// src/plugins/builtin/camera/camera-tcp-requirement.ts
-import { readFileSync as readFileSync6 } from "node:fs";
-var CAMERA_TCP_CONFIG = { incoming: true, outgoing: false };
-function parseCameraList(cameras) {
-  if (typeof cameras !== "string") return [];
-  return cameras.split(",").map((s) => s.trim()).filter(Boolean);
-}
-function bridgeNeedsTcpForCameras(storageDir, bridgeId) {
-  try {
-    const raw = readFileSync6(
-      pluginStorageFilePath(storageDir, bridgeId, "camera"),
-      "utf-8"
-    );
-    const json = JSON.parse(raw);
-    return parseCameraList(json.config?.cameras).length > 0;
-  } catch {
-    return false;
-  }
-}
-
-// src/plugins/plugin-manager.ts
-init_esm();
-import * as fs10 from "node:fs";
-import * as path12 from "node:path";
-
-// src/plugins/plugin-device-factory.ts
-init_esm();
-
-// src/matter/behaviors/identify-server.ts
-init_esm();
-
 // ../../node_modules/.pnpm/@matter+main@0.17.9/node_modules/@matter/main/dist/esm/behaviors.js
 init_nodejs();
 
@@ -155733,7 +155612,7 @@ init_esm4();
 init_esm3();
 init_access_control();
 init_groupcast();
-var logger197 = Logger.get("GroupcastServer");
+var logger196 = Logger.get("GroupcastServer");
 var UNMAPPED_KEYSET_ID = 65535;
 var GROUPCAST_IS_PROVISIONAL = true;
 var GroupcastServer = class extends GroupcastBehavior {
@@ -156150,7 +156029,7 @@ var GroupcastServer = class extends GroupcastBehavior {
       if (hasMembership) continue;
       const fabricGroups = gkmState.groupTable.filter((g) => g.fabricIndex === fi);
       if (fabricGroups.length === 0) continue;
-      logger197.info(`Migrating ${fabricGroups.length} legacy group(s) for fabric ${fi} to Groupcast`);
+      logger196.info(`Migrating ${fabricGroups.length} legacy group(s) for fabric ${fi} to Groupcast`);
       const newEntries = fabricGroups.map((group) => {
         const keyMapping = gkmState.groupKeyMap.find((m) => m.fabricIndex === fi && m.groupId === group.groupId);
         const mcastAddrPolicy = this.features.perGroup ? Groupcast3.MulticastAddrPolicy.PerGroup : Groupcast3.MulticastAddrPolicy.IanaAddr;
@@ -156172,7 +156051,7 @@ var GroupcastServer = class extends GroupcastBehavior {
     }
     if (migrated) {
       this.#updateUsedMcastAddrCount();
-      logger197.info("Groupcast migration complete");
+      logger196.info("Groupcast migration complete");
     }
   }
   async [Symbol.asyncDispose]() {
@@ -156706,7 +156585,174 @@ var WebRtcTransportDefinitions3 = ClusterType(WebRtcTransportDefinitions2);
 // ../../node_modules/.pnpm/@matter+types@0.17.9/node_modules/@matter/types/dist/esm/clusters/index.js
 init_wi_fi_network_diagnostics();
 
+// src/matter/tc-general-commissioning.ts
+var TcBase = GeneralCommissioningServer.with(
+  GeneralCommissioning3.Feature.TermsAndConditions
+);
+var TcGeneralCommissioningServer = class extends TcBase {
+  setTcAcknowledgements({
+    tcVersion
+  }) {
+    this.state.tcAcceptedVersion = tcVersion;
+    return { errorCode: GeneralCommissioning3.CommissioningError.Ok };
+  }
+};
+((TcGeneralCommissioningServer2) => {
+  class State extends TcBase.State {
+    tcAcceptedVersion = 0;
+    tcMinRequiredVersion = 0;
+    // typed number upstream, managed as a bitmap object at runtime
+    tcAcknowledgements = {};
+    // model default is true, but nothing is enforced here
+    tcAcknowledgementsRequired = false;
+    tcUpdateDeadline = null;
+  }
+  TcGeneralCommissioningServer2.State = State;
+})(TcGeneralCommissioningServer || (TcGeneralCommissioningServer = {}));
+function rootEndpointType(flags2) {
+  return flags2?.supportTermsAndConditions ? ServerNode.RootEndpoint.with(TcGeneralCommissioningServer) : ServerNode.RootEndpoint;
+}
+
+// src/matter/endpoints/server-mode-server-node.ts
+var logger197 = Logger.get("ServerModeServerNode");
+var ServerModeServerNode = class extends ServerNode {
+  deviceEndpoints = /* @__PURE__ */ new Map();
+  featureFlags;
+  serialNumberSuffix;
+  constructor(env, bridgeData) {
+    super({
+      type: rootEndpointType(bridgeData.featureFlags),
+      id: bridgeData.id,
+      environment: env,
+      network: {
+        port: bridgeData.port,
+        // Shared zero-jitter window, see matterSubscriptionOptions: 60s max so
+        // iOS does not show a stale "Updating" tile (#287), no jitter so the
+        // keepalive stays inside a controller's ceiling (#386).
+        subscriptionOptions: matterSubscriptionOptions(),
+        ...bridgeData.featureFlags?.enableMatterTcp ? { tcp: CAMERA_TCP_CONFIG } : {}
+      },
+      productDescription: {
+        name: bridgeData.name,
+        deviceType: DeviceTypeId(RoboticVacuumCleanerDevice.deviceType)
+      },
+      basicInformation: {
+        ...legacySpecBasicInformation(bridgeData.featureFlags),
+        uniqueId: bridgeData.id,
+        nodeLabel: trimToLength(bridgeData.name, 32, "..."),
+        vendorId: VendorId(bridgeData.basicInformation.vendorId),
+        vendorName: bridgeData.basicInformation.vendorName,
+        productId: bridgeData.basicInformation.productId,
+        productName: bridgeData.basicInformation.productName,
+        productLabel: bridgeData.basicInformation.productLabel,
+        serialNumber: `server-${bridgeData.id}`.substring(0, 32),
+        hardwareVersion: bridgeData.basicInformation.hardwareVersion,
+        softwareVersion: bridgeData.basicInformation.softwareVersion,
+        hardwareVersionString: bridgeData.basicInformation.hardwareVersionString,
+        softwareVersionString: bridgeData.basicInformation.softwareVersionString ?? String(bridgeData.basicInformation.softwareVersion),
+        ...bridgeData.countryCode ? { location: bridgeData.countryCode } : {}
+      },
+      subscriptions: {
+        persistenceEnabled: false
+      }
+    });
+    this.featureFlags = bridgeData.featureFlags;
+    this.serialNumberSuffix = bridgeData.serialNumberSuffix;
+  }
+  /** Number of device endpoints currently attached. */
+  get deviceCount() {
+    return this.deviceEndpoints.size;
+  }
+  /**
+   * Add a device endpoint to this server node. Several endpoints per node are
+   * supported (#301); the call is idempotent per endpoint id.
+   */
+  async addDevice(endpoint) {
+    if (this.deviceEndpoints.has(endpoint.id)) {
+      return;
+    }
+    this.deviceEndpoints.set(endpoint.id, endpoint);
+    await this.add(endpoint);
+  }
+  /**
+   * Drop one device reference after the endpoint has been deleted externally.
+   * Must be called before re-adding an endpoint with the same id.
+   */
+  forgetDevice(endpoint) {
+    this.deviceEndpoints.delete(endpoint.id);
+  }
+  /** Drop all device references after the endpoints were deleted externally. */
+  clearDevices() {
+    this.deviceEndpoints.clear();
+  }
+  /**
+   * Update root-level BasicInformation with entity-specific data.
+   * In server mode, controllers (Apple Home, Alexa) read the root node's
+   * BasicInformation, not the device endpoint's BridgedDeviceBasicInformation.
+   * Without this, server-mode devices show bridge defaults (e.g. "riddix" / "MatterHub").
+   */
+  async updateDeviceIdentity(entityId, device, mapping, friendlyName) {
+    const nodeLabel = trimToLength(mapping?.customName, 32, "...") ?? trimToLength(friendlyName, 32, "...") ?? trimToLength(entityId, 32, "...");
+    const productNameFromNodeLabel = this.featureFlags?.productNameFromNodeLabel === true ? trimToLength(sanitizeMatterString(nodeLabel ?? ""), 32, "...") ?? void 0 : void 0;
+    const maxRawLen = 32 - (this.serialNumberSuffix?.length ?? 0);
+    const registrySerial = this.featureFlags?.useHaRegistrySerial ? trimToLength(device?.serial_number, maxRawLen, "...") : void 0;
+    const rawSerial = trimToLength(mapping?.customSerialNumber, maxRawLen, "...") ?? registrySerial;
+    const serialNumber = rawSerial && this.serialNumberSuffix ? `${rawSerial}${this.serialNumberSuffix}` : rawSerial;
+    const basicInformation = dropUndefined({
+      vendorName: trimToLength(mapping?.customVendorName, 32, "...") ?? trimToLength(device?.manufacturer, 32, "..."),
+      productName: trimToLength(mapping?.customProductName, 32, "...") ?? productNameFromNodeLabel ?? trimToLength(device?.model_id, 32, "...") ?? trimToLength(device?.model, 32, "..."),
+      productLabel: trimToLength(device?.model, 64, "..."),
+      nodeLabel,
+      serialNumber,
+      hardwareVersionString: trimToLength(device?.hw_version, 64, "..."),
+      softwareVersionString: trimToLength(device?.sw_version, 64, "...")
+    });
+    if (Object.keys(basicInformation).length === 0) {
+      return;
+    }
+    try {
+      await this.set({ basicInformation });
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      logger197.warn(
+        `Failed to apply server-mode identity for ${entityId}: ${msg}`
+      );
+    }
+  }
+  // align the pairing device-type hint with the real device (default is vacuum)
+  async updateAdvertisedDeviceType(deviceType) {
+    try {
+      await this.set({ productDescription: { deviceType } });
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      logger197.warn(`Failed to set server-mode device type: ${msg}`);
+    }
+  }
+  async factoryReset() {
+    await this.cancel();
+    await this.erase();
+  }
+};
+function dropUndefined(obj) {
+  const result = {};
+  for (const key in obj) {
+    if (obj[key] !== void 0) {
+      result[key] = obj[key];
+    }
+  }
+  return result;
+}
+
+// src/plugins/plugin-manager.ts
+init_esm();
+import * as fs10 from "node:fs";
+import * as path12 from "node:path";
+
+// src/plugins/plugin-device-factory.ts
+init_esm();
+
 // src/matter/behaviors/identify-server.ts
+init_esm();
 init_home_assistant_entity_behavior();
 var logger198 = Logger.get("IdentifyServer");
 var IDENTIFY_BUTTON_SUFFIXES = ["_identify", "_locate", "_find_me"];
@@ -158079,12 +158125,13 @@ Object.freeze(SecondaryNetworkInterfaceEndpointDefinition);
 init_types2();
 function createBridgeServerConfig(data, options) {
   return {
-    type: ServerNode.RootEndpoint,
+    type: rootEndpointType(data.featureFlags),
     id: data.id,
     network: {
       port: data.port,
       subscriptionOptions: matterSubscriptionOptions(),
-      ...options?.tcp ? { tcp: options.tcp } : {}
+      // camera serverOptions win, the flag reuses the same listener config
+      ...options?.tcp ? { tcp: options.tcp } : data.featureFlags?.enableMatterTcp ? { tcp: CAMERA_TCP_CONFIG } : {}
     },
     productDescription: {
       name: data.name,
@@ -158596,7 +158643,7 @@ var Bridge = class {
   // message size. Match the bridge listener to the saved camera list. Changing
   // network config takes effect on (re)start, so bounce the bridge if running.
   async applyCameraTcp(config8) {
-    const want = parseCameraList(config8.cameras).length > 0;
+    const want = parseCameraList(config8.cameras).length > 0 || !!this.dataProvider.featureFlags?.enableMatterTcp;
     const have = !!this.server.state.network.tcp;
     if (want === have) {
       return;
@@ -158680,6 +158727,10 @@ var Bridge = class {
         BasicInformationServer,
         specVersionValues(this.dataProvider.featureFlags)
       );
+      await applyTcpFlagBeforeStart(
+        this.server,
+        this.dataProvider.featureFlags
+      );
       await this.server.start();
       await this.endpointManager.startPlugins();
       this.setStatus({ code: BridgeStatus.Running });
@@ -179318,6 +179369,10 @@ var ServerModeBridge = class {
         BasicInformationServer,
         specVersionValues(this.dataProvider.featureFlags)
       );
+      await applyTcpFlagBeforeStart(
+        this.server,
+        this.dataProvider.featureFlags
+      );
       await this.server.start();
       this.setStatus({ code: BridgeStatus.Running });
       this.startAutoForceSyncIfEnabled();