@matter/thread-br-client 0.0.1

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

@@ -0,0 +1,136 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Bytes, Logger, Observable } from "@matter/general";
+import { DEFAULT_RESET_TLV_TYPES } from "../diagnostic/DiagnosticSource.js";
+import { OtbrRestError } from "./OtbrRestError.js";
+import { translateNodeJson } from "./translation.js";
+const logger = Logger.get("OtbrRestDiagnosticSource");
+class OtbrRestDiagnosticSource {
+  kind = "otbr-rest";
+  #client;
+  #capability;
+  /**
+   * @param client - REST client (or compatible duck type) for the target BR.
+   * @param capability - Probed metadata identifying the network this source covers.
+   */
+  constructor(client, capability) {
+    this.#client = client;
+    this.#capability = capability;
+  }
+  /**
+   * Returns `true` when `extPanId` matches the network this source was probed for.
+   *
+   * @param extPanId - 8-byte Extended PAN ID of the network to query.
+   */
+  canQuery(extPanId) {
+    return Bytes.areEqual(extPanId, this.#capability.extPanId);
+  }
+  /**
+   * Query diagnostics for a single mesh node by RLOC16.
+   *
+   * Fetches the full `/diagnostics` snapshot from the BR and returns the entry
+   * matching `target.rloc16`. IP-only targets are not supported via REST — the
+   * OTBR per-RLOC16 endpoint is not universally available.
+   *
+   * @param target - Must include `rloc16`; `ip` without `rloc16` is rejected.
+   * @param _tlvTypes - Ignored; REST returns the BR's full snapshot unconditionally.
+   * @throws {@link OtbrRestError} with code `"rest_protocol"` when `rloc16` is
+   *   missing, when an ip-only target is supplied, or when no entry matches `rloc16`.
+   * @throws {@link OtbrRestError} when the underlying REST fetch fails.
+   */
+  async queryUnicast(target, _tlvTypes) {
+    if (target.ip !== void 0 && target.rloc16 === void 0) {
+      throw new OtbrRestError(
+        "rest_protocol",
+        "OtbrRestDiagnosticSource: ip-routed unicast is not supported in REST mode \u2014 supply rloc16"
+      );
+    }
+    if (target.rloc16 === void 0) {
+      throw new OtbrRestError("rest_protocol", "OtbrRestDiagnosticSource: rloc16 required for unicast query");
+    }
+    const list = await this.#client.getDiagnostics();
+    for (const entry of list) {
+      const decoded = translateNodeJson(entry);
+      if (decoded.rloc16 === target.rloc16) return decoded;
+    }
+    throw new OtbrRestError("rest_protocol", `rloc16 0x${target.rloc16.toString(16)} not found in /diagnostics`);
+  }
+  /**
+   * Stream all mesh-node diagnostics from the OTBR `/diagnostics` endpoint.
+   *
+   * Because the REST surface returns a pre-collected snapshot in a single HTTP
+   * response, multicast scope and `opts.windowMs` have no effect — all nodes are
+   * emitted in one burst and `done` resolves immediately after. The returned
+   * handle is still conformant to {@link QueryMulticastHandle}; callers may
+   * call `close()` before `done` resolves with no ill effect.
+   *
+   * @param _scope - Ignored; REST has no per-scope filtering.
+   * @param _opts - Ignored; see above.
+   * @returns Handle with `onNode`, `onError`, `done`, and `close`.
+   */
+  queryMulticast(_scope, _opts) {
+    const onNode = new Observable();
+    const onError = new Observable();
+    let resolveDone;
+    let rejectDone;
+    const done = new Promise((resolve, reject) => {
+      resolveDone = resolve;
+      rejectDone = reject;
+    });
+    const start = Date.now();
+    logger.debug(`[ThreadDiag] REST GET /diagnostics ${this.#capability.baseUrl}`);
+    void (async () => {
+      try {
+        const list = await this.#client.getDiagnostics();
+        for (const entry of list) {
+          onNode.emit(translateNodeJson(entry));
+        }
+        logger.debug(`[ThreadDiag] REST /diagnostics OK nodes=${list.length} duration=${Date.now() - start}ms`);
+        resolveDone();
+      } catch (err) {
+        const e = err instanceof Error ? err : new Error(String(err));
+        onError.emit(e);
+        rejectDone(e);
+      }
+    })();
+    return {
+      onNode,
+      onError,
+      done,
+      close: async () => {
+        await done.catch(() => {
+        });
+      }
+    };
+  }
+  /**
+   * Zero MAC and MLE counters on a single mesh node via the OTBR REST API.
+   *
+   * Posts a `resetNetworkDiagCounterTask` action to `/api/actions`. Only
+   * available on camelCase OTBR backends (post-2024 builds detected as
+   * `keyFormat === "camel"` during probing). Throws {@link OtbrRestError}
+   * with code `"rest_disabled"` when the backend does not support this
+   * endpoint. Mutating but low-risk — counters only, no network state altered.
+   *
+   * @param _target - Accepted for interface compatibility; REST resets all
+   *   nodes atomically, so target is not forwarded on the wire.
+   * @param _tlvTypes - Accepted for interface compatibility; the REST action
+   *   always resets all diagnostic counters regardless of tlvTypes.
+   */
+  async resetCounters(_target, _tlvTypes = DEFAULT_RESET_TLV_TYPES) {
+    if (this.#capability.keyFormat !== "camel") {
+      throw new OtbrRestError(
+        "rest_disabled",
+        "OtbrRestDiagnosticSource: resetCounters requires the camelCase (/api/actions) OTBR backend"
+      );
+    }
+    await this.#client.resetDiagnosticCounters({ action: "resetNetworkDiagCounterTask" });
+  }
+}
+export {
+  OtbrRestDiagnosticSource
+};
+//# sourceMappingURL=OtbrRestDiagnosticSource.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/otbr-rest/OtbrRestDiagnosticSource.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,OAAO,QAAQ,kBAAkB;AAG1C,SAAS,+BAA+B;AAGxC,SAAS,qBAAqB;AAC9B,SAAS,yBAAyB;AAElC,MAAM,SAAS,OAAO,IAAI,0BAA0B;AAgB7C,MAAM,yBAAqD;AAAA,EACrD,OAAO;AAAA,EAEP;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMT,YAAY,QAAoB,YAAgC;AAC5D,SAAK,UAAU;AACf,SAAK,cAAc;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,SAAS,UAA+B;AACpC,WAAO,MAAM,SAAS,UAAU,KAAK,YAAY,QAAQ;AAAA,EAC7D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,MAAM,aAAa,QAA0C,WAAkD;AAC3G,QAAI,OAAO,OAAO,UAAa,OAAO,WAAW,QAAW;AACxD,YAAM,IAAI;AAAA,QACN;AAAA,QACA;AAAA,MACJ;AAAA,IACJ;AACA,QAAI,OAAO,WAAW,QAAW;AAC7B,YAAM,IAAI,cAAc,iBAAiB,6DAA6D;AAAA,IAC1G;AAKA,UAAM,OAAO,MAAM,KAAK,QAAQ,eAAe;AAC/C,eAAW,SAAS,MAAM;AACtB,YAAM,UAAU,kBAAkB,KAAK;AACvC,UAAI,QAAQ,WAAW,OAAO,OAAQ,QAAO;AAAA,IACjD;AACA,UAAM,IAAI,cAAc,iBAAiB,YAAY,OAAO,OAAO,SAAS,EAAE,CAAC,4BAA4B;AAAA,EAC/G;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,eAAe,QAA+B,OAAoD;AAK9F,UAAM,SAAS,IAAI,WAAiC;AACpD,UAAM,UAAU,IAAI,WAAoB;AACxC,QAAI;AACJ,QAAI;AACJ,UAAM,OAAO,IAAI,QAAc,CAAC,SAAS,WAAW;AAChD,oBAAc;AACd,mBAAa;AAAA,IACjB,CAAC;AAED,UAAM,QAAQ,KAAK,IAAI;AACvB,WAAO,MAAM,sCAAsC,KAAK,YAAY,OAAO,EAAE;AAC7E,UAAM,YAAY;AACd,UAAI;AACA,cAAM,OAAO,MAAM,KAAK,QAAQ,eAAe;AAC/C,mBAAW,SAAS,MAAM;AACtB,iBAAO,KAAK,kBAAkB,KAAK,CAAC;AAAA,QACxC;AACA,eAAO,MAAM,2CAA2C,KAAK,MAAM,aAAa,KAAK,IAAI,IAAI,KAAK,IAAI;AACtG,oBAAY;AAAA,MAChB,SAAS,KAAK;AACV,cAAM,IAAI,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC;AAC5D,gBAAQ,KAAK,CAAC;AACd,mBAAW,CAAC;AAAA,MAChB;AAAA,IACJ,GAAG;AAEH,WAAO;AAAA,MACH;AAAA,MACA;AAAA,MACA;AAAA,MACA,OAAO,YAAY;AAEf,cAAM,KAAK,MAAM,MAAM;AAAA,QAAC,CAAC;AAAA,MAC7B;AAAA,IACJ;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,MAAM,cACF,SACA,YAAmC,yBACtB;AACb,QAAI,KAAK,YAAY,cAAc,SAAS;AACxC,YAAM,IAAI;AAAA,QACN;AAAA,QACA;AAAA,MACJ;AAAA,IACJ;AACA,UAAM,KAAK,QAAQ,wBAAwB,EAAE,QAAQ,8BAA8B,CAAC;AAAA,EACxF;AACJ;",
+  "names": []
+}

package/dist/esm/otbr-rest/OtbrRestError.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MatterError } from "@matter/general";
+export type OtbrRestErrorCode = "rest_unreachable" | "rest_protocol" | "rest_disabled" | "rest_unsupported" | "rest_conflict" | "rest_not_allowed";
+export interface OtbrRestErrorOptions {
+    cause?: Error;
+    httpStatus?: number;
+}
+export declare class OtbrRestError extends MatterError {
+    readonly code: OtbrRestErrorCode;
+    readonly cause?: Error;
+    readonly httpStatus?: number;
+    constructor(code: OtbrRestErrorCode, message: string, opts?: OtbrRestErrorOptions);
+}
+//# sourceMappingURL=OtbrRestError.d.ts.map

package/dist/esm/otbr-rest/OtbrRestError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OtbrRestError.d.ts","sourceRoot":"","sources":["../../../src/otbr-rest/OtbrRestError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,MAAM,iBAAiB,GACzB,kBAAkB,GAAG,eAAe,GAAG,eAAe,GAAG,kBAAkB,GAAG,eAAe,GAAG,kBAAkB,CAAC;AAEvH,MAAM,WAAW,oBAAoB;IACjC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,aAAc,SAAQ,WAAW;IAC1C,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,SAAkB,KAAK,CAAC,EAAE,KAAK,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,YAAY,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,oBAAoB,EAMhF;CACJ"}

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

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MatterError } from "@matter/general";
+class OtbrRestError extends MatterError {
+  code;
+  cause;
+  httpStatus;
+  constructor(code, message, opts) {
+    super(message);
+    this.name = "OtbrRestError";
+    this.code = code;
+    this.cause = opts?.cause;
+    this.httpStatus = opts?.httpStatus;
+  }
+}
+export {
+  OtbrRestError
+};
+//# sourceMappingURL=OtbrRestError.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/otbr-rest/OtbrRestError.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,mBAAmB;AAUrB,MAAM,sBAAsB,YAAY;AAAA,EAClC;AAAA,EACS;AAAA,EACT;AAAA,EAET,YAAY,MAAyB,SAAiB,MAA6B;AAC/E,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,OAAO;AACZ,SAAK,QAAQ,MAAM;AACnB,SAAK,aAAa,MAAM;AAAA,EAC5B;AACJ;",
+  "names": []
+}

package/dist/esm/otbr-rest/OtbrRestProbe.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { OtbrRestCapability } from "./OtbrRestCapability.js";
+export declare class OtbrRestProbe {
+    /**
+     * Probe a host:port for OTBR REST. Returns the detected capability or
+     * `null` if the endpoint is not OTBR or not reachable within
+     * `timeoutMs`. Detection mirrors python-otbr-api: a 200 on
+     * `/api/actions` indicates the modern camelCase backend, a 404 the
+     * legacy pascalCase backend; everything else is "not OTBR".
+     */
+    static probe(host: string, port?: number, timeoutMs?: number): Promise<OtbrRestCapability | null>;
+}
+//# sourceMappingURL=OtbrRestProbe.d.ts.map

package/dist/esm/otbr-rest/OtbrRestProbe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OtbrRestProbe.d.ts","sourceRoot":"","sources":["../../../src/otbr-rest/OtbrRestProbe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAYlE,qBAAa,aAAa;IACtB;;;;;;OAMG;IACH,OAAa,KAAK,CACd,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAA2B,EACjC,SAAS,GAAE,MAA8B,GAC1C,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CA8BpC;CACJ"}

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

@@ -0,0 +1,76 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Bytes, Logger, Millis, Seconds, Time } from "@matter/general";
+import { OtbrRestClient } from "./OtbrRestClient.js";
+import { OtbrRestError } from "./OtbrRestError.js";
+const logger = Logger.get("OtbrRestProbe");
+const DEFAULT_PROBE_PORT = 8081;
+const DEFAULT_PROBE_TIMEOUT = Seconds(1);
+const HTTP_OK = 200;
+const HTTP_NOT_FOUND = 404;
+class OtbrRestProbe {
+  /**
+   * Probe a host:port for OTBR REST. Returns the detected capability or
+   * `null` if the endpoint is not OTBR or not reachable within
+   * `timeoutMs`. Detection mirrors python-otbr-api: a 200 on
+   * `/api/actions` indicates the modern camelCase backend, a 404 the
+   * legacy pascalCase backend; everything else is "not OTBR".
+   */
+  static async probe(host, port = DEFAULT_PROBE_PORT, timeoutMs = DEFAULT_PROBE_TIMEOUT) {
+    const client = new OtbrRestClient({ host, port, timeoutMs });
+    const baseUrl = client.baseUrl;
+    logger.debug(`[ThreadDiag] probe START ${baseUrl} timeout=${timeoutMs}ms`);
+    const keyFormat = await detectCase(baseUrl, timeoutMs);
+    if (keyFormat === null) {
+      logger.debug(`[ThreadDiag] probe MISS ${baseUrl} (case detect failed)`);
+      return null;
+    }
+    try {
+      const node = await client.getNode();
+      logger.debug(
+        `[ThreadDiag] probe OK ${baseUrl} keyFormat=${keyFormat} xp=${Bytes.toHex(node.extPanId).toUpperCase()} network="${node.networkName}"`
+      );
+      return {
+        baseUrl,
+        keyFormat,
+        probedAt: Date.now(),
+        networkName: node.networkName,
+        extPanId: node.extPanId
+      };
+    } catch (err) {
+      if (err instanceof OtbrRestError) {
+        logger.debug(`[ThreadDiag] probe MISS ${baseUrl} /node ${err.code} (${err.message})`);
+        return null;
+      }
+      throw err;
+    }
+  }
+}
+async function detectCase(baseUrl, timeoutMs) {
+  const controller = new AbortController();
+  const timer = Time.getTimer("otbr-probe-timeout", Millis(timeoutMs), () => controller.abort()).start();
+  try {
+    const response = await fetch(`${baseUrl}/api/actions`, {
+      method: "GET",
+      headers: { Accept: "application/json" },
+      signal: controller.signal
+    });
+    if (response.status === HTTP_OK) return "camel";
+    if (response.status === HTTP_NOT_FOUND) return "pascal";
+    logger.debug(`probe of ${baseUrl} rejected: /api/actions returned ${response.status}`);
+    return null;
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    logger.debug(`probe of ${baseUrl} rejected: /api/actions ${message}`);
+    return null;
+  } finally {
+    timer.stop();
+  }
+}
+export {
+  OtbrRestProbe
+};
+//# sourceMappingURL=OtbrRestProbe.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/otbr-rest/OtbrRestProbe.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,OAAO,QAAQ,QAAQ,SAAS,YAAmB;AAE5D,SAAS,sBAAsB;AAC/B,SAAS,qBAAqB;AAE9B,MAAM,SAAS,OAAO,IAAI,eAAe;AAEzC,MAAM,qBAAqB;AAC3B,MAAM,wBAAwB,QAAQ,CAAC;AAEvC,MAAM,UAAU;AAChB,MAAM,iBAAiB;AAEhB,MAAM,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQvB,aAAa,MACT,MACA,OAAe,oBACf,YAAoB,uBACc;AAClC,UAAM,SAAS,IAAI,eAAe,EAAE,MAAM,MAAM,UAAU,CAAC;AAC3D,UAAM,UAAU,OAAO;AACvB,WAAO,MAAM,4BAA4B,OAAO,YAAY,SAAS,IAAI;AAEzE,UAAM,YAAY,MAAM,WAAW,SAAS,SAAS;AACrD,QAAI,cAAc,MAAM;AACpB,aAAO,MAAM,2BAA2B,OAAO,uBAAuB;AACtE,aAAO;AAAA,IACX;AAEA,QAAI;AACA,YAAM,OAAO,MAAM,OAAO,QAAQ;AAClC,aAAO;AAAA,QACH,yBAAyB,OAAO,cAAc,SAAS,OAAO,MAAM,MAAM,KAAK,QAAQ,EAAE,YAAY,CAAC,aAAa,KAAK,WAAW;AAAA,MACvI;AACA,aAAO;AAAA,QACH;AAAA,QACA;AAAA,QACA,UAAU,KAAK,IAAI;AAAA,QACnB,aAAa,KAAK;AAAA,QAClB,UAAU,KAAK;AAAA,MACnB;AAAA,IACJ,SAAS,KAAK;AACV,UAAI,eAAe,eAAe;AAC9B,eAAO,MAAM,2BAA2B,OAAO,UAAU,IAAI,IAAI,KAAK,IAAI,OAAO,GAAG;AACpF,eAAO;AAAA,MACX;AACA,YAAM;AAAA,IACV;AAAA,EACJ;AACJ;AAEA,eAAe,WAAW,SAAiB,WAAuD;AAC9F,QAAM,aAAa,IAAI,gBAAgB;AACvC,QAAM,QAAe,KAAK,SAAS,sBAAsB,OAAO,SAAS,GAAG,MAAM,WAAW,MAAM,CAAC,EAAE,MAAM;AAC5G,MAAI;AACA,UAAM,WAAW,MAAM,MAAM,GAAG,OAAO,gBAAgB;AAAA,MACnD,QAAQ;AAAA,MACR,SAAS,EAAE,QAAQ,mBAAmB;AAAA,MACtC,QAAQ,WAAW;AAAA,IACvB,CAAC;AACD,QAAI,SAAS,WAAW,QAAS,QAAO;AACxC,QAAI,SAAS,WAAW,eAAgB,QAAO;AAC/C,WAAO,MAAM,YAAY,OAAO,oCAAoC,SAAS,MAAM,EAAE;AACrF,WAAO;AAAA,EACX,SAAS,KAAK;AACV,UAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC/D,WAAO,MAAM,YAAY,OAAO,2BAA2B,OAAO,EAAE;AACpE,WAAO;AAAA,EACX,UAAE;AACE,UAAM,KAAK;AAAA,EACf;AACJ;",
+  "names": []
+}

package/dist/esm/otbr-rest/caseNormalizer.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Recursively rewrites object keys from PascalCase (or already-camelCase) to
+ * camelCase. Idempotent — running it twice yields identical output. Arrays,
+ * primitives and `null` pass through unchanged.
+ */
+export declare function normalizeKeys(value: unknown): unknown;
+//# sourceMappingURL=caseNormalizer.d.ts.map

package/dist/esm/otbr-rest/caseNormalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caseNormalizer.d.ts","sourceRoot":"","sources":["../../../src/otbr-rest/caseNormalizer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA2BH;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAYrD"}

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

@@ -0,0 +1,39 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const IRREGULAR = {
+  BaId: "baId",
+  IP6AddressList: "ip6AddressList",
+  MACCounters: "macCounters",
+  PSKc: "pskc"
+};
+function normalizeKey(key) {
+  const mapped = IRREGULAR[key];
+  if (mapped !== void 0) return mapped;
+  if (key.length === 0) return key;
+  return key.charAt(0).toLowerCase() + key.slice(1);
+}
+function isPlainObject(value) {
+  if (value === null || typeof value !== "object") return false;
+  const proto = Object.getPrototypeOf(value);
+  return proto === Object.prototype || proto === null;
+}
+function normalizeKeys(value) {
+  if (Array.isArray(value)) {
+    return value.map((item) => normalizeKeys(item));
+  }
+  if (isPlainObject(value)) {
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+      out[normalizeKey(k)] = normalizeKeys(v);
+    }
+    return out;
+  }
+  return value;
+}
+export {
+  normalizeKeys
+};
+//# sourceMappingURL=caseNormalizer.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/otbr-rest/caseNormalizer.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAWA,MAAM,YAA8C;AAAA,EAChD,MAAM;AAAA,EACN,gBAAgB;AAAA,EAChB,aAAa;AAAA,EACb,MAAM;AACV;AAEA,SAAS,aAAa,KAAqB;AACvC,QAAM,SAAS,UAAU,GAAG;AAC5B,MAAI,WAAW,OAAW,QAAO;AACjC,MAAI,IAAI,WAAW,EAAG,QAAO;AAC7B,SAAO,IAAI,OAAO,CAAC,EAAE,YAAY,IAAI,IAAI,MAAM,CAAC;AACpD;AAEA,SAAS,cAAc,OAAkD;AACrE,MAAI,UAAU,QAAQ,OAAO,UAAU,SAAU,QAAO;AACxD,QAAM,QAAQ,OAAO,eAAe,KAAK;AACzC,SAAO,UAAU,OAAO,aAAa,UAAU;AACnD;AAOO,SAAS,cAAc,OAAyB;AACnD,MAAI,MAAM,QAAQ,KAAK,GAAG;AACtB,WAAO,MAAM,IAAI,UAAQ,cAAc,IAAI,CAAC;AAAA,EAChD;AACA,MAAI,cAAc,KAAK,GAAG;AACtB,UAAM,MAA+B,CAAC;AACtC,eAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,KAAK,GAAG;AACxC,UAAI,aAAa,CAAC,CAAC,IAAI,cAAc,CAAC;AAAA,IAC1C;AACA,WAAO;AAAA,EACX;AACA,SAAO;AACX;",
+  "names": []
+}

package/dist/esm/otbr-rest/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export { normalizeKeys } from "./caseNormalizer.js";
+export type { OtbrRestCapability } from "./OtbrRestCapability.js";
+export { OtbrRestClient } from "./OtbrRestClient.js";
+export type { OtbrDatasetHex, OtbrJoiner, OtbrLeaderData, OtbrNodeInfo, OtbrRestClientOptions, } from "./OtbrRestClient.js";
+export { OtbrRestDiagnosticSource } from "./OtbrRestDiagnosticSource.js";
+export { OtbrRestError } from "./OtbrRestError.js";
+export type { OtbrRestErrorCode, OtbrRestErrorOptions } from "./OtbrRestError.js";
+export { OtbrRestProbe } from "./OtbrRestProbe.js";
+export { translateNodeJson } from "./translation.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/otbr-rest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/otbr-rest/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EACR,cAAc,EACd,UAAU,EACV,cAAc,EACd,YAAY,EACZ,qBAAqB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

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

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { normalizeKeys } from "./caseNormalizer.js";
+import { OtbrRestClient } from "./OtbrRestClient.js";
+import { OtbrRestDiagnosticSource } from "./OtbrRestDiagnosticSource.js";
+import { OtbrRestError } from "./OtbrRestError.js";
+import { OtbrRestProbe } from "./OtbrRestProbe.js";
+import { translateNodeJson } from "./translation.js";
+export {
+  OtbrRestClient,
+  OtbrRestDiagnosticSource,
+  OtbrRestError,
+  OtbrRestProbe,
+  normalizeKeys,
+  translateNodeJson
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/otbr-rest/index.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,qBAAqB;AAE9B,SAAS,sBAAsB;AAQ/B,SAAS,gCAAgC;AACzC,SAAS,qBAAqB;AAE9B,SAAS,qBAAqB;AAC9B,SAAS,yBAAyB;",
+  "names": []
+}

package/dist/esm/otbr-rest/translation.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { DiagnosticResponse } from "../diagnostic/DiagnosticResponse.js";
+/**
+ * Parse an IPv6 textual address into 16 bytes. Supports full forms and `::`
+ * compression. Does not handle IPv4-mapped (`::ffff:1.2.3.4`) or zone IDs
+ * (`%`); OTBR `IP6AddressList` never returns either.
+ */
+declare function parseIpv6(text: string): Uint8Array;
+/**
+ * Translate a single OTBR `/diagnostics` entry (already key-normalized to
+ * camelCase) into a {@link DiagnosticResponse}. Skips fields the entry does
+ * not include — REST returns whatever the BR last collected, which differs
+ * per node and per OpenThread build.
+ */
+export declare function translateNodeJson(json: unknown): DiagnosticResponse;
+export declare const __testables: {
+    parseIpv6: typeof parseIpv6;
+};
+export {};
+//# sourceMappingURL=translation.d.ts.map

package/dist/esm/otbr-rest/translation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation.d.ts","sourceRoot":"","sources":["../../../src/otbr-rest/translation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAsL9E;;;;GAIG;AACH,iBAAS,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAuC3C;AASD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,CA6FnE;AAED,eAAO,MAAM,WAAW;;CAAgB,CAAC"}