@matter/thread-br-client 0.0.1

package/dist/esm/otbr-rest/translation.js

@@ -0,0 +1,281 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Bytes } from "@matter/general";
+import { NetworkData } from "../tlv/diag/NetworkData.js";
+import { OtbrRestError } from "./OtbrRestError.js";
+const TIMEOUT_EXP_MIN = 4;
+const IPV6_BYTES = 16;
+const IPV6_GROUPS = 8;
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function asNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function asString(value) {
+  return typeof value === "string" ? value : void 0;
+}
+function asRecord(value) {
+  return isRecord(value) ? value : void 0;
+}
+function asArray(value) {
+  return Array.isArray(value) ? value : void 0;
+}
+function requireNumber(record, key, where) {
+  const v = asNumber(record[key]);
+  if (v === void 0) throw new OtbrRestError("rest_protocol", `${where}: missing numeric ${key}`);
+  return v;
+}
+function parseHexBytes(hex, where, expectedLen) {
+  if (!/^[0-9a-fA-F]*$/.test(hex)) {
+    throw new OtbrRestError("rest_protocol", `${where}: not hex`);
+  }
+  if (hex.length % 2 !== 0) {
+    throw new OtbrRestError("rest_protocol", `${where}: odd hex length`);
+  }
+  if (expectedLen !== void 0 && hex.length !== expectedLen * 2) {
+    throw new OtbrRestError("rest_protocol", `${where}: expected ${expectedLen} bytes, got ${hex.length / 2}`);
+  }
+  return Bytes.of(Bytes.fromHex(hex));
+}
+function translateMode(input) {
+  return {
+    rxOnWhenIdle: requireNumber(input, "rxOnWhenIdle", "mode") !== 0,
+    fullThreadDevice: requireNumber(input, "deviceType", "mode") !== 0,
+    fullNetworkData: requireNumber(input, "networkData", "mode") !== 0
+  };
+}
+function parentPriorityFromInt(raw) {
+  if (raw > 0) return 1;
+  if (raw < 0) return -1;
+  return 0;
+}
+function translateConnectivity(input) {
+  return {
+    parentPriority: parentPriorityFromInt(requireNumber(input, "parentPriority", "connectivity")),
+    linkQuality3: requireNumber(input, "linkQuality3", "connectivity"),
+    linkQuality2: requireNumber(input, "linkQuality2", "connectivity"),
+    linkQuality1: requireNumber(input, "linkQuality1", "connectivity"),
+    leaderCost: requireNumber(input, "leaderCost", "connectivity"),
+    idSequence: requireNumber(input, "idSequence", "connectivity"),
+    activeRouters: requireNumber(input, "activeRouters", "connectivity"),
+    sedBufferSize: requireNumber(input, "sedBufferSize", "connectivity"),
+    sedDatagramCount: requireNumber(input, "sedDatagramCount", "connectivity")
+  };
+}
+function translateRoute(input) {
+  const idSequence = requireNumber(input, "idSequence", "route");
+  const routeData = asArray(input["routeData"]);
+  if (routeData === void 0) {
+    throw new OtbrRestError("rest_protocol", "route: missing routeData array");
+  }
+  const entries = new Array();
+  for (const raw of routeData) {
+    const r = asRecord(raw);
+    if (r === void 0) {
+      throw new OtbrRestError("rest_protocol", "route.routeData: entry is not an object");
+    }
+    entries.push({
+      routerId: requireNumber(r, "routeId", "route.routeData"),
+      linkQualityOut: requireNumber(r, "linkQualityOut", "route.routeData"),
+      linkQualityIn: requireNumber(r, "linkQualityIn", "route.routeData"),
+      routeCost: requireNumber(r, "routeCost", "route.routeData")
+    });
+  }
+  return { idSequence, entries };
+}
+function translateLeaderData(input) {
+  return {
+    partitionId: requireNumber(input, "partitionId", "leaderData"),
+    weighting: requireNumber(input, "weighting", "leaderData"),
+    dataVersion: requireNumber(input, "dataVersion", "leaderData"),
+    stableDataVersion: requireNumber(input, "stableDataVersion", "leaderData"),
+    leaderRouterId: requireNumber(input, "leaderRouterId", "leaderData")
+  };
+}
+function translateMacCounters(input) {
+  return {
+    ifInUnknownProtos: requireNumber(input, "ifInUnknownProtos", "macCounters"),
+    ifInErrors: requireNumber(input, "ifInErrors", "macCounters"),
+    ifOutErrors: requireNumber(input, "ifOutErrors", "macCounters"),
+    ifInUcastPkts: requireNumber(input, "ifInUcastPkts", "macCounters"),
+    ifInBroadcastPkts: requireNumber(input, "ifInBroadcastPkts", "macCounters"),
+    ifInDiscards: requireNumber(input, "ifInDiscards", "macCounters"),
+    ifOutUcastPkts: requireNumber(input, "ifOutUcastPkts", "macCounters"),
+    ifOutBroadcastPkts: requireNumber(input, "ifOutBroadcastPkts", "macCounters"),
+    ifOutDiscards: requireNumber(input, "ifOutDiscards", "macCounters")
+  };
+}
+function requireBigInt(record, key, where) {
+  const v = record[key];
+  if (typeof v === "bigint") return v;
+  const n = asNumber(v);
+  if (n === void 0) throw new OtbrRestError("rest_protocol", `${where}: missing numeric ${key}`);
+  return BigInt(Math.trunc(n));
+}
+function translateMleCounters(input) {
+  return {
+    disabledRole: requireNumber(input, "disabledRole", "mleCounters"),
+    detachedRole: requireNumber(input, "detachedRole", "mleCounters"),
+    childRole: requireNumber(input, "childRole", "mleCounters"),
+    routerRole: requireNumber(input, "routerRole", "mleCounters"),
+    leaderRole: requireNumber(input, "leaderRole", "mleCounters"),
+    attachAttempts: requireNumber(input, "attachAttempts", "mleCounters"),
+    partitionIdChanges: requireNumber(input, "partitionIdChanges", "mleCounters"),
+    betterPartitionAttachAttempts: requireNumber(input, "betterPartitionAttachAttempts", "mleCounters"),
+    parentChanges: requireNumber(input, "parentChanges", "mleCounters"),
+    trackedTime: requireBigInt(input, "trackedTime", "mleCounters"),
+    disabledTime: requireBigInt(input, "disabledTime", "mleCounters"),
+    detachedTime: requireBigInt(input, "detachedTime", "mleCounters"),
+    childTime: requireBigInt(input, "childTime", "mleCounters"),
+    routerTime: requireBigInt(input, "routerTime", "mleCounters"),
+    leaderTime: requireBigInt(input, "leaderTime", "mleCounters")
+  };
+}
+function translateChildTable(input) {
+  const out = new Array();
+  for (const raw of input) {
+    const r = asRecord(raw);
+    if (r === void 0) {
+      throw new OtbrRestError("rest_protocol", "childTable: entry is not an object");
+    }
+    const modeRecord = asRecord(r["mode"]);
+    if (modeRecord === void 0) {
+      throw new OtbrRestError("rest_protocol", "childTable: entry missing mode");
+    }
+    const exp = requireNumber(r, "timeout", "childTable.timeout");
+    const clampedExp = exp < TIMEOUT_EXP_MIN ? TIMEOUT_EXP_MIN : exp;
+    out.push({
+      timeoutExponent: exp,
+      timeoutSeconds: 1 << clampedExp - TIMEOUT_EXP_MIN,
+      // OTBR /diagnostics omits the wire-form 2-bit incoming-link-quality field
+      // for child entries; mirror OpenThread's default of 0.
+      incomingLinkQuality: 0,
+      childId: requireNumber(r, "childId", "childTable"),
+      mode: translateMode(modeRecord)
+    });
+  }
+  return out;
+}
+function parseIpv6(text) {
+  if (text.includes("%")) {
+    throw new OtbrRestError("rest_protocol", `ipv6: zone ID not supported in ${text}`);
+  }
+  const doubleColonIdx = text.indexOf("::");
+  let leftPart;
+  let rightPart;
+  if (doubleColonIdx === -1) {
+    leftPart = text;
+    rightPart = "";
+  } else {
+    if (text.indexOf("::", doubleColonIdx + 2) !== -1) {
+      throw new OtbrRestError("rest_protocol", `ipv6: multiple "::" in ${text}`);
+    }
+    leftPart = text.slice(0, doubleColonIdx);
+    rightPart = text.slice(doubleColonIdx + 2);
+  }
+  const leftGroups = leftPart === "" ? [] : leftPart.split(":");
+  const rightGroups = rightPart === "" ? [] : rightPart.split(":");
+  if (doubleColonIdx === -1 && leftGroups.length !== IPV6_GROUPS) {
+    throw new OtbrRestError("rest_protocol", `ipv6: expected ${IPV6_GROUPS} groups in ${text}`);
+  }
+  const fillCount = IPV6_GROUPS - leftGroups.length - rightGroups.length;
+  if (fillCount < 0 || doubleColonIdx !== -1 && fillCount === 0) {
+    throw new OtbrRestError("rest_protocol", `ipv6: too many groups in ${text}`);
+  }
+  const groups = new Array();
+  for (const g of leftGroups) groups.push(parseGroup(g, text));
+  for (let i = 0; i < fillCount; i++) groups.push(0);
+  for (const g of rightGroups) groups.push(parseGroup(g, text));
+  const out = new Uint8Array(IPV6_BYTES);
+  for (let i = 0; i < IPV6_GROUPS; i++) {
+    out[i * 2] = groups[i] >>> 8 & 255;
+    out[i * 2 + 1] = groups[i] & 255;
+  }
+  return out;
+}
+function parseGroup(g, text) {
+  if (g.length === 0 || g.length > 4 || !/^[0-9a-fA-F]+$/.test(g)) {
+    throw new OtbrRestError("rest_protocol", `ipv6: bad group "${g}" in ${text}`);
+  }
+  return parseInt(g, 16);
+}
+function translateNodeJson(json) {
+  if (!isRecord(json)) {
+    throw new OtbrRestError("rest_protocol", "translateNodeJson: input is not an object");
+  }
+  const result = { unknown: new Array() };
+  const extAddress = asString(json["extAddress"]);
+  if (extAddress !== void 0) {
+    result.extMacAddress = parseHexBytes(extAddress, "extAddress", 8);
+  }
+  const rloc16 = asNumber(json["rloc16"]);
+  if (rloc16 !== void 0) result.rloc16 = rloc16;
+  const mode = asRecord(json["mode"]);
+  if (mode !== void 0) result.mode = translateMode(mode);
+  const timeout = asNumber(json["timeout"]);
+  if (timeout !== void 0) result.timeout = timeout;
+  const connectivity = asRecord(json["connectivity"]);
+  if (connectivity !== void 0) result.connectivity = translateConnectivity(connectivity);
+  const route = asRecord(json["route"]);
+  if (route !== void 0) result.route64 = translateRoute(route);
+  const leaderData = asRecord(json["leaderData"]);
+  if (leaderData !== void 0) result.leaderData = translateLeaderData(leaderData);
+  const networkData = asString(json["networkData"]);
+  if (networkData !== void 0) {
+    result.networkData = NetworkData.decode(parseHexBytes(networkData, "networkData"));
+  }
+  const ip6Addresses = asArray(json["ip6AddressList"]);
+  if (ip6Addresses !== void 0) {
+    const list = new Array();
+    for (const entry of ip6Addresses) {
+      const text = asString(entry);
+      if (text === void 0) {
+        throw new OtbrRestError("rest_protocol", "ip6AddressList: entry is not a string");
+      }
+      list.push(parseIpv6(text));
+    }
+    result.ipv6Addresses = list;
+  }
+  const macCounters = asRecord(json["macCounters"]);
+  if (macCounters !== void 0) result.macCounters = translateMacCounters(macCounters);
+  const mleCounters = asRecord(json["mleCounters"]);
+  if (mleCounters !== void 0) result.mleCounters = translateMleCounters(mleCounters);
+  const childTable = asArray(json["childTable"]);
+  if (childTable !== void 0) result.childTable = translateChildTable(childTable);
+  const channelPages = asString(json["channelPages"]);
+  if (channelPages !== void 0) {
+    const bytes = parseHexBytes(channelPages, "channelPages");
+    result.channelPages = Array.from(bytes);
+  }
+  const maxChildTimeout = asNumber(json["maxChildTimeout"]);
+  if (maxChildTimeout !== void 0) result.maxChildTimeout = maxChildTimeout;
+  const eui64 = asString(json["eui64"]);
+  if (eui64 !== void 0) result.eui64 = parseHexBytes(eui64, "eui64", 8);
+  const version = asNumber(json["version"]);
+  if (version !== void 0) result.version = version;
+  const vendorName = asString(json["vendorName"]);
+  if (vendorName !== void 0) result.vendorName = vendorName;
+  const vendorModel = asString(json["vendorModel"]);
+  if (vendorModel !== void 0) result.vendorModel = vendorModel;
+  const vendorSwVersion = asString(json["vendorSwVersion"]);
+  if (vendorSwVersion !== void 0) result.vendorSwVersion = vendorSwVersion;
+  const threadStackVersion = asString(json["threadStackVersion"]);
+  if (threadStackVersion !== void 0) result.threadStackVersion = threadStackVersion;
+  const vendorAppUrl = asString(json["vendorAppUrl"]);
+  if (vendorAppUrl !== void 0) result.vendorAppUrl = vendorAppUrl;
+  const batteryLevel = asNumber(json["batteryLevel"]);
+  if (batteryLevel !== void 0) result.batteryLevel = batteryLevel;
+  const supplyVoltage = asNumber(json["supplyVoltage"]);
+  if (supplyVoltage !== void 0) result.supplyVoltage = supplyVoltage;
+  return result;
+}
+const __testables = { parseIpv6 };
+export {
+  __testables,
+  translateNodeJson
+};
+//# sourceMappingURL=translation.js.map

package/dist/esm/otbr-rest/translation.js.map

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

package/dist/esm/package.json

@@ -0,0 +1,6 @@
+{
+    "type": "module",
+    "imports": {
+        "#*": "./*"
+    }
+}

package/dist/esm/selection/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export { decodeStateBitmap, rankBrs, selectBr } from "./selectBr.js";
+export type { DecodedStateBitmap } from "./selectBr.js";
+export { selectSource } from "./selectSource.js";
+export type { SelectSourceOpts } from "./selectSource.js";
+export { ExtPanIdLockManager } from "./withExtPanIdLock.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/selection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/selection/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACrE,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/esm/selection/index.js

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { decodeStateBitmap, rankBrs, selectBr } from "./selectBr.js";
+import { selectSource } from "./selectSource.js";
+import { ExtPanIdLockManager } from "./withExtPanIdLock.js";
+export {
+  ExtPanIdLockManager,
+  decodeStateBitmap,
+  rankBrs,
+  selectBr,
+  selectSource
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/selection/index.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/selection/index.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,mBAAmB,SAAS,gBAAgB;AAErD,SAAS,oBAAoB;AAE7B,SAAS,2BAA2B;",
+  "names": []
+}

package/dist/esm/selection/selectBr.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { BorderRouterEntry } from "../discovery/BorderRouterEntry.js";
+/**
+ * Decoded subset of the MeshCoP `_meshcop` TXT `sb` (state bitmap) field that
+ * matters for BR selection. Layout per OpenThread's `border_agent_txt_data.hpp`:
+ *   bit 7  BBR Active
+ *   bit 8  BBR Is Primary (only meaningful when BBR Active)
+ */
+export interface DecodedStateBitmap {
+    bbrActive: boolean;
+    bbrPrimary: boolean;
+}
+/**
+ * Decode the BBR-relevant bits from a 4-byte state bitmap hex string.
+ *
+ * Returns `{ bbrActive: false, bbrPrimary: false }` for missing or malformed
+ * input — selection treats absence and "no BBR role" as equivalent.
+ */
+export declare function decodeStateBitmap(hex: string | undefined): DecodedStateBitmap;
+/**
+ * Pick the best BR per spec FR-12 priority:
+ *   1. State bitmap "BBR Active + Primary" (bits 7 and 8) wins.
+ *   2. Then BBR Active but not Primary.
+ *   3. Among equals: BR with at least one IPv6 link-local (`fe80:`) address wins.
+ *   4. Among equals: alphabetical `extAddressHex` ascending (deterministic tie-break).
+ */
+export declare function selectBr(brs: ReadonlyArray<BorderRouterEntry>): BorderRouterEntry | undefined;
+/**
+ * Rank all candidate BRs best-first using the same priority as {@link selectBr}.
+ * Callers fall back to later entries when the preferred BR is unreachable.
+ */
+export declare function rankBrs(brs: ReadonlyArray<BorderRouterEntry>): BorderRouterEntry[];
+//# sourceMappingURL=selectBr.d.ts.map

package/dist/esm/selection/selectBr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectBr.d.ts","sourceRoot":"","sources":["../../../src/selection/selectBr.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAE3E;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,kBAAkB,CAY7E;AAkBD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,GAAG,SAAS,CAE7F;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,EAAE,CAMlF"}

package/dist/esm/selection/selectBr.js

@@ -0,0 +1,46 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function decodeStateBitmap(hex) {
+  if (hex === void 0 || !/^[0-9a-fA-F]{1,8}$/.test(hex)) {
+    return { bbrActive: false, bbrPrimary: false };
+  }
+  const value = parseInt(hex, 16);
+  if (!Number.isFinite(value)) {
+    return { bbrActive: false, bbrPrimary: false };
+  }
+  return {
+    bbrActive: (value >> 7 & 1) === 1,
+    bbrPrimary: (value >> 8 & 1) === 1
+  };
+}
+function hasLinkLocal(addresses) {
+  for (const addr of addresses) {
+    if (addr.toLowerCase().startsWith("fe80:")) return true;
+  }
+  return false;
+}
+function scoreOf(br) {
+  const { bbrActive, bbrPrimary } = decodeStateBitmap(br.stateBitmapHex);
+  const stateScore = bbrActive ? bbrPrimary ? 4 : 2 : 0;
+  const llScore = hasLinkLocal(br.addresses) ? 1 : 0;
+  return stateScore + llScore;
+}
+function selectBr(brs) {
+  return rankBrs(brs)[0];
+}
+function rankBrs(brs) {
+  return [...brs].sort((a, b) => {
+    const byScore = scoreOf(b) - scoreOf(a);
+    if (byScore !== 0) return byScore;
+    return a.extAddressHex < b.extAddressHex ? -1 : a.extAddressHex > b.extAddressHex ? 1 : 0;
+  });
+}
+export {
+  decodeStateBitmap,
+  rankBrs,
+  selectBr
+};
+//# sourceMappingURL=selectBr.js.map

package/dist/esm/selection/selectBr.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/selection/selectBr.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAyBO,SAAS,kBAAkB,KAA6C;AAC3E,MAAI,QAAQ,UAAa,CAAC,qBAAqB,KAAK,GAAG,GAAG;AACtD,WAAO,EAAE,WAAW,OAAO,YAAY,MAAM;AAAA,EACjD;AACA,QAAM,QAAQ,SAAS,KAAK,EAAE;AAC9B,MAAI,CAAC,OAAO,SAAS,KAAK,GAAG;AACzB,WAAO,EAAE,WAAW,OAAO,YAAY,MAAM;AAAA,EACjD;AACA,SAAO;AAAA,IACH,YAAa,SAAS,IAAK,OAAS;AAAA,IACpC,aAAc,SAAS,IAAK,OAAS;AAAA,EACzC;AACJ;AAEA,SAAS,aAAa,WAA2C;AAC7D,aAAW,QAAQ,WAAW;AAC1B,QAAI,KAAK,YAAY,EAAE,WAAW,OAAO,EAAG,QAAO;AAAA,EACvD;AACA,SAAO;AACX;AAEA,SAAS,QAAQ,IAA+B;AAC5C,QAAM,EAAE,WAAW,WAAW,IAAI,kBAAkB,GAAG,cAAc;AAGrE,QAAM,aAAa,YAAa,aAAa,IAAI,IAAK;AACtD,QAAM,UAAU,aAAa,GAAG,SAAS,IAAI,IAAI;AACjD,SAAO,aAAa;AACxB;AASO,SAAS,SAAS,KAAsE;AAC3F,SAAO,QAAQ,GAAG,EAAE,CAAC;AACzB;AAMO,SAAS,QAAQ,KAA4D;AAChF,SAAO,CAAC,GAAG,GAAG,EAAE,KAAK,CAAC,GAAG,MAAM;AAC3B,UAAM,UAAU,QAAQ,CAAC,IAAI,QAAQ,CAAC;AACtC,QAAI,YAAY,EAAG,QAAO;AAC1B,WAAO,EAAE,gBAAgB,EAAE,gBAAgB,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,IAAI;AAAA,EAC5F,CAAC;AACL;",
+  "names": []
+}

package/dist/esm/selection/selectSource.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ThreadCredentialsRegistry } from "../credentials/ThreadCredentialsRegistry.js";
+import type { ThreadNetworkCredentials } from "../credentials/ThreadNetworkCredentials.js";
+import type { DiagnosticSource } from "../diagnostic/DiagnosticSource.js";
+import type { BorderRouterEntry } from "../discovery/BorderRouterEntry.js";
+import type { OtbrRestCapability } from "../otbr-rest/OtbrRestCapability.js";
+export interface SelectSourceOpts {
+    br: BorderRouterEntry;
+    credentials: Pick<ThreadCredentialsRegistry, "getCredentials">;
+    /** Keyed by `Bytes.toHex(extPanId)` (lowercase). */
+    restCapabilities: ReadonlyMap<string, OtbrRestCapability>;
+    otbrRestEnabled: boolean;
+    /** Factory for the REST source (caller injects to avoid cyclic deps). */
+    makeRestSource: (cap: OtbrRestCapability) => DiagnosticSource;
+    /** Factory for the MeshCoP source (caller injects). */
+    makeMeshcopSource: (creds: ThreadNetworkCredentials, br: BorderRouterEntry) => DiagnosticSource;
+}
+/**
+ * Pick the diagnostic source per spec §4.10 priority:
+ *   1. `otbrRestEnabled` AND `restCapabilities` has an entry for this BR's extPanId → REST.
+ *   2. Credentials registered for this BR's extPanId → MeshCoP.
+ *   3. Neither → undefined (Mode B observation only).
+ *
+ * Returns undefined when the BR carries no `extendedPanIdHex`, since both lookups
+ * key on it.
+ */
+export declare function selectSource(opts: SelectSourceOpts): DiagnosticSource | undefined;
+//# sourceMappingURL=selectSource.d.ts.map

package/dist/esm/selection/selectSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectSource.d.ts","sourceRoot":"","sources":["../../../src/selection/selectSource.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AAC7F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AAC3F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAE7E,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,iBAAiB,CAAC;IACtB,WAAW,EAAE,IAAI,CAAC,yBAAyB,EAAE,gBAAgB,CAAC,CAAC;IAC/D,oDAAoD;IACpD,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC1D,eAAe,EAAE,OAAO,CAAC;IACzB,yEAAyE;IACzE,cAAc,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,gBAAgB,CAAC;IAC9D,uDAAuD;IACvD,iBAAiB,EAAE,CAAC,KAAK,EAAE,wBAAwB,EAAE,EAAE,EAAE,iBAAiB,KAAK,gBAAgB,CAAC;CACnG;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,GAAG,SAAS,CAgBjF"}

package/dist/esm/selection/selectSource.js

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Bytes } from "@matter/general";
+function selectSource(opts) {
+  const { br, credentials, restCapabilities, otbrRestEnabled, makeRestSource, makeMeshcopSource } = opts;
+  if (br.extendedPanIdHex === void 0) return void 0;
+  const extPanId = Bytes.of(Bytes.fromHex(br.extendedPanIdHex));
+  const lookupKey = Bytes.toHex(extPanId);
+  if (otbrRestEnabled) {
+    const cap = restCapabilities.get(lookupKey);
+    if (cap !== void 0) return makeRestSource(cap);
+  }
+  const creds = credentials.getCredentials(extPanId);
+  if (creds !== void 0) return makeMeshcopSource(creds, br);
+  return void 0;
+}
+export {
+  selectSource
+};
+//# sourceMappingURL=selectSource.js.map

package/dist/esm/selection/selectSource.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/selection/selectSource.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,aAAa;AA4Bf,SAAS,aAAa,MAAsD;AAC/E,QAAM,EAAE,IAAI,aAAa,kBAAkB,iBAAiB,gBAAgB,kBAAkB,IAAI;AAClG,MAAI,GAAG,qBAAqB,OAAW,QAAO;AAE9C,QAAM,WAAW,MAAM,GAAG,MAAM,QAAQ,GAAG,gBAAgB,CAAC;AAC5D,QAAM,YAAY,MAAM,MAAM,QAAQ;AAEtC,MAAI,iBAAiB;AACjB,UAAM,MAAM,iBAAiB,IAAI,SAAS;AAC1C,QAAI,QAAQ,OAAW,QAAO,eAAe,GAAG;AAAA,EACpD;AAEA,QAAM,QAAQ,YAAY,eAAe,QAAQ;AACjD,MAAI,UAAU,OAAW,QAAO,kBAAkB,OAAO,EAAE;AAE3D,SAAO;AACX;",
+  "names": []
+}

package/dist/esm/selection/withExtPanIdLock.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Per-extPanId FIFO mutex for diagnostic flows.
+ *
+ * Two callers targeting the same Thread network (same extPanId) run sequentially;
+ * callers targeting different networks run concurrently. The MeshCoP commissioner
+ * petition is single-session per BR, so serialising same-network access prevents
+ * petition collisions when the controller fans out queries.
+ */
+export declare class ExtPanIdLockManager {
+    #private;
+    /**
+     * Run `fn` with mutual exclusion against any other invocation for the same `extPanId`.
+     * Errors thrown by `fn` propagate to the caller but never poison the queue —
+     * the next caller for the same key still runs.
+     */
+    withLock<T>(extPanId: Uint8Array, fn: () => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=withExtPanIdLock.d.ts.map

package/dist/esm/selection/withExtPanIdLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withExtPanIdLock.d.ts","sourceRoot":"","sources":["../../../src/selection/withExtPanIdLock.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;GAOG;AACH,qBAAa,mBAAmB;;IAG5B;;;;OAIG;IACH,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAclE;CACJ"}

package/dist/esm/selection/withExtPanIdLock.js

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Bytes } from "@matter/general";
+class ExtPanIdLockManager {
+  #queues = /* @__PURE__ */ new Map();
+  /**
+   * Run `fn` with mutual exclusion against any other invocation for the same `extPanId`.
+   * Errors thrown by `fn` propagate to the caller but never poison the queue —
+   * the next caller for the same key still runs.
+   */
+  withLock(extPanId, fn) {
+    const key = Bytes.toHex(extPanId);
+    const previous = this.#queues.get(key) ?? Promise.resolve();
+    const result = previous.then(() => fn());
+    const chained = result.catch(() => void 0).finally(() => {
+      if (this.#queues.get(key) === chained) {
+        this.#queues.delete(key);
+      }
+    });
+    this.#queues.set(key, chained);
+    return result;
+  }
+}
+export {
+  ExtPanIdLockManager
+};
+//# sourceMappingURL=withExtPanIdLock.js.map

package/dist/esm/selection/withExtPanIdLock.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/selection/withExtPanIdLock.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,aAAa;AAUf,MAAM,oBAAoB;AAAA,EACpB,UAAU,oBAAI,IAA8B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOrD,SAAY,UAAsB,IAAkC;AAChE,UAAM,MAAM,MAAM,MAAM,QAAQ;AAChC,UAAM,WAAW,KAAK,QAAQ,IAAI,GAAG,KAAK,QAAQ,QAAQ;AAC1D,UAAM,SAAS,SAAS,KAAK,MAAM,GAAG,CAAC;AACvC,UAAM,UAA4B,OAC7B,MAAM,MAAM,MAAS,EACrB,QAAQ,MAAM;AAEX,UAAI,KAAK,QAAQ,IAAI,GAAG,MAAM,SAAS;AACnC,aAAK,QAAQ,OAAO,GAAG;AAAA,MAC3B;AAAA,IACJ,CAAC;AACL,SAAK,QAAQ,IAAI,KAAK,OAAO;AAC7B,WAAO;AAAA,EACX;AACJ;",
+  "names": []
+}

package/dist/esm/tlv/BasicTlvCodec.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MatterError } from "@matter/general";
+/** Low-level MeshCoP/base TLV codec parse failure (truncated stream, bad length, ...). */
+export declare class ThreadTlvError extends MatterError {
+}
+/**
+ * MeshCoP TLV stream (Thread spec §8.10) is a sequence of [type:1][length:1][value:length] frames.
+ * Length 0xFF escapes to a 2-byte big-endian extended length following the type byte.
+ */
+export interface BasicTlvEntry {
+    type: number;
+    value: Uint8Array;
+}
+export declare namespace BasicTlv {
+    function walk(blob: Uint8Array): BasicTlvEntry[];
+    function encode(entries: ReadonlyArray<BasicTlvEntry>): Uint8Array;
+}
+//# sourceMappingURL=BasicTlvCodec.d.ts.map

package/dist/esm/tlv/BasicTlvCodec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasicTlvCodec.d.ts","sourceRoot":"","sources":["../../../src/tlv/BasicTlvCodec.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAiB,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE7D,0FAA0F;AAC1F,qBAAa,cAAe,SAAQ,WAAW;CAAG;AAElD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;CACrB;AAED,yBAAiB,QAAQ,CAAC,CAAC;IACvB,SAAgB,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa,EAAE,CA6BtD;IAED,SAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,UAAU,CA6BxE;CACJ"}