@riddix/hamh 2.1.0-alpha.714 → 2.1.0-alpha.716

package/dist/backend/cli.js

@@ -127638,6 +127638,10 @@ function isLinkLocal(family, address) {
   if (family === "IPv4") return address.startsWith("169.254.");
   return address.toLowerCase().startsWith("fe80");
 }
+function isLinkLocalOrUla(address) {
+  const a = address.toLowerCase();
+  return /^fe[89ab]/.test(a) || /^f[cd]/.test(a);
+}
 function selectMdnsInterface(raw) {
   const external = [];
   const dockerLike = [];
@@ -129322,26 +129326,51 @@ var BetterLogger = class _BetterLogger extends Logger {
 
 // src/core/app/mdns.ts
 init_esm();
+init_esm7();
 import * as os5 from "node:os";
 
 // ../../node_modules/.pnpm/@matter+main@0.17.0/node_modules/@matter/main/dist/esm/protocol.js
 init_nodejs();
 init_esm4();
 
+// src/core/app/filtered-network.ts
+init_esm6();
+function filterAdvertisedIpv6(ipV6) {
+  const local = ipV6.filter(isLinkLocalOrUla);
+  return local.length > 0 ? local : [...ipV6];
+}
+var FilteredNetwork = class extends NodeJsNetwork {
+  getIpMac(netInterface) {
+    const details = super.getIpMac(netInterface);
+    if (!details) return details;
+    return { ...details, ipV6: filterAdvertisedIpv6(details.ipV6) };
+  }
+};
+
 // src/core/app/mdns.ts
 var logger168 = Logger.get("Mdns");
 function mdns(env, options) {
-  if (!options.networkInterface) {
-    warnIfMisadvertising();
+  if (options.stripGlobalIpv6) {
+    env.set(Network, new FilteredNetwork());
+  } else {
+    warnAboutAdvertising(options);
   }
   new MdnsService(env, {
     ipv4: options.ipv4,
     networkInterface: options.networkInterface
   });
 }
-function warnIfMisadvertising() {
+function warnAboutAdvertising(options) {
   const choice = selectMdnsInterface(os5.networkInterfaces());
-  if (!choice.suspicious) {
+  const hasGlobalIpv6 = choice.external.some(
+    (i) => i.ipv6.some((a) => !isLinkLocalOrUla(a))
+  );
+  if (hasGlobalIpv6) {
+    logger168.warn(
+      "Matter mDNS is advertising a global IPv6 address that controllers may not reach on the LAN, so devices can show No Response (#361). Set mdns-strip-global-ipv6 if devices stay unreachable."
+    );
+  }
+  if (options.networkInterface || !choice.suspicious) {
     return;
   }
   const suggestion = choice.selected ? ` Likely LAN interface: ${choice.selected}.` : "";
@@ -129433,7 +129462,8 @@ var Options = class {
   get mdns() {
     return {
       ipv4: true,
-      networkInterface: notEmpty(this.startOptions.mdnsNetworkInterface)
+      networkInterface: notEmpty(this.startOptions.mdnsNetworkInterface),
+      stripGlobalIpv6: this.startOptions.mdnsStripGlobalIpv6 ?? false
     };
   }
   get logging() {
@@ -164003,6 +164033,10 @@ function startOptionsBuilder(yargs2) {
   }).option("mdns-network-interface", {
     type: "string",
     description: "Limit mDNS to this network interface"
+  }).option("mdns-strip-global-ipv6", {
+    type: "boolean",
+    default: false,
+    description: "Drop global IPv6 (GUA) from mDNS so controllers use a locally reachable address (#361)"
   }).option("home-assistant-url", {
     type: "string",
     description: "The HTTP-URL of your Home Assistant URL"