@matter/thread-br-client 0.0.1

package/dist/cjs/otbr-rest/OtbrRestClient.js

@@ -0,0 +1,544 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var OtbrRestClient_exports = {};
+__export(OtbrRestClient_exports, {
+  OtbrRestClient: () => OtbrRestClient
+});
+module.exports = __toCommonJS(OtbrRestClient_exports);
+var import_general = require("@matter/general");
+var import_OperationalDataset = require("../dataset/OperationalDataset.js");
+var import_caseNormalizer = require("./caseNormalizer.js");
+var import_OtbrRestError = require("./OtbrRestError.js");
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const DEFAULT_PORT = 8081;
+const DEFAULT_TIMEOUT = (0, import_general.Seconds)(5);
+const HTTP_NO_CONTENT = 204;
+function errorCodeForStatus(status) {
+  switch (status) {
+    case 404:
+      return "rest_unsupported";
+    case 405:
+      return "rest_not_allowed";
+    case 409:
+      return "rest_conflict";
+    default:
+      return "rest_protocol";
+  }
+}
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function expectString(record, key, where) {
+  const value = record[key];
+  if (typeof value !== "string") {
+    throw new import_OtbrRestError.OtbrRestError("rest_protocol", `${where}: missing or non-string field ${key}`);
+  }
+  return value;
+}
+function expectNumber(record, key, where) {
+  const value = record[key];
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    throw new import_OtbrRestError.OtbrRestError("rest_protocol", `${where}: missing or non-numeric field ${key}`);
+  }
+  return value;
+}
+function expectRecord(record, key, where) {
+  const value = record[key];
+  if (!isRecord(value)) {
+    throw new import_OtbrRestError.OtbrRestError("rest_protocol", `${where}: missing or non-object field ${key}`);
+  }
+  return value;
+}
+function parseHexBytes(hex, expectedLen, where) {
+  if (!/^[0-9a-fA-F]*$/.test(hex)) {
+    throw new import_OtbrRestError.OtbrRestError("rest_protocol", `${where}: not hex`);
+  }
+  if (hex.length !== expectedLen * 2) {
+    throw new import_OtbrRestError.OtbrRestError("rest_protocol", `${where}: expected ${expectedLen} bytes, got ${hex.length / 2}`);
+  }
+  return import_general.Bytes.of(import_general.Bytes.fromHex(hex));
+}
+class OtbrRestClient {
+  #baseUrl;
+  #timeout;
+  /**
+   * @param opts - Connection parameters; `host` is required.
+   */
+  constructor(opts) {
+    const port = opts.port ?? DEFAULT_PORT;
+    const host = opts.host.includes(":") && !opts.host.startsWith("[") ? `[${opts.host}]` : opts.host;
+    this.#baseUrl = `http://${host}:${port}`;
+    this.#timeout = opts.timeoutMs !== void 0 ? (0, import_general.Millis)(opts.timeoutMs) : DEFAULT_TIMEOUT;
+  }
+  get baseUrl() {
+    return this.#baseUrl;
+  }
+  /**
+   * Fetch the current node summary from the OTBR `/node` endpoint.
+   *
+   * @returns Parsed node info with typed fields (binary fields as `Uint8Array`).
+   * @throws {@link OtbrRestError} with code `"rest_unreachable"` on network error or timeout.
+   * @throws {@link OtbrRestError} with code `"rest_protocol"` when the response is
+   *   not a valid JSON object or a required field is missing or has the wrong type.
+   */
+  async getNode() {
+    const { body } = await this.#fetchJson("/node");
+    if (!isRecord(body)) {
+      throw new import_OtbrRestError.OtbrRestError("rest_protocol", "/node did not return a JSON object");
+    }
+    const where = "/node";
+    const leaderRaw = expectRecord(body, "leaderData", where);
+    const leaderData = {
+      partitionId: expectNumber(leaderRaw, "partitionId", `${where}.leaderData`),
+      weighting: expectNumber(leaderRaw, "weighting", `${where}.leaderData`),
+      dataVersion: expectNumber(leaderRaw, "dataVersion", `${where}.leaderData`),
+      stableDataVersion: expectNumber(leaderRaw, "stableDataVersion", `${where}.leaderData`),
+      leaderRouterId: expectNumber(leaderRaw, "leaderRouterId", `${where}.leaderData`)
+    };
+    return {
+      baId: parseHexBytes(expectString(body, "baId", where), 16, `${where}.baId`),
+      state: expectString(body, "state", where),
+      numOfRouter: expectNumber(body, "numOfRouter", where),
+      rlocAddress: expectString(body, "rlocAddress", where),
+      extAddress: parseHexBytes(expectString(body, "extAddress", where), 8, `${where}.extAddress`),
+      networkName: expectString(body, "networkName", where),
+      rloc16: expectNumber(body, "rloc16", where),
+      leaderData,
+      extPanId: parseHexBytes(expectString(body, "extPanId", where), 8, `${where}.extPanId`)
+    };
+  }
+  /**
+   * Fetch the raw diagnostics array from the OTBR `/diagnostics` endpoint.
+   *
+   * The response is returned as-is — callers are responsible for interpreting
+   * the per-node objects. Use `OtbrRestDiagnosticSource` for a typed interface
+   * that translates this payload into `DiagnosticResponse` values.
+   *
+   * @returns Array of raw node diagnostic objects as returned by the BR.
+   * @throws {@link OtbrRestError} with code `"rest_unreachable"` on network error or timeout.
+   * @throws {@link OtbrRestError} with code `"rest_protocol"` when the response is not a JSON array.
+   */
+  async getDiagnostics() {
+    const { body } = await this.#fetchJson("/diagnostics");
+    if (!Array.isArray(body)) {
+      throw new import_OtbrRestError.OtbrRestError("rest_protocol", "/diagnostics did not return a JSON array");
+    }
+    return body;
+  }
+  /**
+   * Fetch the active and pending dataset hex strings from the OTBR REST API.
+   *
+   * Each dataset is fetched independently from `/node/dataset/active` and
+   * `/node/dataset/pending`. A `204 No Content` response means the dataset is
+   * absent, in which case the corresponding field is omitted from the result.
+   *
+   * @returns Object with `activeHex` and/or `pendingHex` hex strings; fields
+   *   are absent when the BR has no dataset of that type.
+   * @throws {@link OtbrRestError} with code `"rest_unreachable"` on network error or timeout.
+   * @throws {@link OtbrRestError} with code `"rest_protocol"` on a non-2xx HTTP status.
+   */
+  async getDataset() {
+    const active = await this.#fetchText("/node/dataset/active");
+    const pending = await this.#fetchText("/node/dataset/pending");
+    const out = {};
+    if (active !== void 0) out.activeHex = active;
+    if (pending !== void 0) out.pendingHex = pending;
+    return out;
+  }
+  /**
+   * Fetch the node role from `/node/state` (e.g. `"router"`, `"leader"`, `"child"`, `"disabled"`).
+   *
+   * @throws {@link OtbrRestError} `"rest_unreachable"` on network error, `"rest_protocol"` on a
+   *   non-string body.
+   */
+  async getState() {
+    return this.#getJsonString("/node/state");
+  }
+  /**
+   * Fetch the Thread network name from `/node/network-name`.
+   */
+  async getNetworkName() {
+    return this.#getJsonString("/node/network-name");
+  }
+  /**
+   * Fetch the node's Routing Locator (RLOC) IPv6 address from `/node/rloc`.
+   */
+  async getRloc() {
+    return this.#getJsonString("/node/rloc");
+  }
+  /**
+   * Fetch the 16-bit RLOC from `/node/rloc16`.
+   */
+  async getRloc16() {
+    return this.#getJsonNumber("/node/rloc16");
+  }
+  /**
+   * Fetch the number of routers in the Thread network from `/node/num-of-router`.
+   */
+  async getNumOfRouter() {
+    return this.#getJsonNumber("/node/num-of-router");
+  }
+  /**
+   * Fetch the 8-byte IEEE EUI-64 extended address from `/node/ext-address`.
+   */
+  async getExtAddress() {
+    return parseHexBytes(await this.#getJsonString("/node/ext-address"), 8, "/node/ext-address");
+  }
+  /**
+   * Fetch the 8-byte Extended PAN ID from `/node/ext-panid`.
+   */
+  async getExtPanId() {
+    return parseHexBytes(await this.#getJsonString("/node/ext-panid"), 8, "/node/ext-panid");
+  }
+  /**
+   * Fetch the 16-byte Border Agent ID from `/node/ba-id`.
+   *
+   * @throws {@link OtbrRestError} `"rest_unsupported"` on older firmware that lacks this endpoint (404).
+   */
+  async getBorderAgentId() {
+    return parseHexBytes(await this.#getJsonString("/node/ba-id"), 16, "/node/ba-id");
+  }
+  /**
+   * Fetch the leader data record from `/node/leader-data`.
+   */
+  async getLeaderData() {
+    const { body } = await this.#fetchJson("/node/leader-data");
+    if (!isRecord(body)) {
+      throw new import_OtbrRestError.OtbrRestError("rest_protocol", "/node/leader-data did not return a JSON object");
+    }
+    const where = "/node/leader-data";
+    return {
+      partitionId: expectNumber(body, "partitionId", where),
+      weighting: expectNumber(body, "weighting", where),
+      dataVersion: expectNumber(body, "dataVersion", where),
+      stableDataVersion: expectNumber(body, "stableDataVersion", where),
+      leaderRouterId: expectNumber(body, "leaderRouterId", where)
+    };
+  }
+  /**
+   * Fetch and decode the active Operational Dataset from `/node/dataset/active`.
+   *
+   * @returns The decoded dataset, or `undefined` when the BR has no active dataset (204).
+   */
+  async getActiveDataset() {
+    return this.#getDataset("/node/dataset/active");
+  }
+  /**
+   * Fetch and decode the pending Operational Dataset from `/node/dataset/pending`.
+   *
+   * @returns The decoded dataset, or `undefined` when the BR has no pending dataset (204).
+   */
+  async getPendingDataset() {
+    return this.#getDataset("/node/dataset/pending");
+  }
+  /**
+   * Fetch the RCP/co-processor version string from `/node/coprocessor/version`.
+   *
+   * @throws {@link OtbrRestError} `"rest_unsupported"` on older firmware that lacks this endpoint (404).
+   */
+  async getCoprocessorVersion() {
+    return this.#getJsonString("/node/coprocessor/version");
+  }
+  /**
+   * Fetch the on-BR commissioner state from `/node/commissioner/state`.
+   *
+   * @throws {@link OtbrRestError} `"rest_unsupported"` on firmware without a built-in commissioner (404).
+   */
+  async getCommissionerState() {
+    return this.#getJsonString("/node/commissioner/state");
+  }
+  /**
+   * Fetch the list of pending joiners from `/node/commissioner/joiner`.
+   *
+   * The entries are returned as-is (keys normalized to camelCase); callers
+   * interpret the per-joiner objects.
+   *
+   * @throws {@link OtbrRestError} `"rest_unsupported"` on firmware without a built-in commissioner (404).
+   */
+  async getJoiners() {
+    const { body } = await this.#fetchJson("/node/commissioner/joiner");
+    if (!Array.isArray(body)) {
+      throw new import_OtbrRestError.OtbrRestError("rest_protocol", "/node/commissioner/joiner did not return a JSON array");
+    }
+    return body;
+  }
+  /**
+   * Enable or disable the Thread interface via `PUT /node/state`.
+   *
+   * @throws {@link OtbrRestError} `"rest_conflict"` when the BR rejects the transition (409).
+   */
+  async setState(enable) {
+    await this.#mutate("PUT", "/node/state", {
+      contentType: "application/json",
+      body: JSON.stringify(enable ? "enable" : "disable")
+    });
+  }
+  /**
+   * Set the active Operational Dataset via `PUT /node/dataset/active`.
+   *
+   * @param dataset - An {@link OperationalDataset} (encoded to TLV hex) or a raw TLV hex string.
+   * @throws {@link OtbrRestError} `"rest_conflict"` when Thread is active and the active
+   *   dataset cannot be replaced in place (409) — use {@link setPendingDataset} instead.
+   */
+  async setActiveDataset(dataset) {
+    await this.#putDataset("/node/dataset/active", dataset);
+  }
+  /**
+   * Clear the active Operational Dataset via `DELETE /node/dataset/active`.
+   */
+  async deleteActiveDataset() {
+    await this.#mutate("DELETE", "/node/dataset/active");
+  }
+  /**
+   * Set the pending Operational Dataset via `PUT /node/dataset/pending`.
+   *
+   * @param dataset - An {@link OperationalDataset} (encoded to TLV hex) or a raw TLV hex string.
+   */
+  async setPendingDataset(dataset) {
+    await this.#putDataset("/node/dataset/pending", dataset);
+  }
+  /**
+   * Clear the pending Operational Dataset via `DELETE /node/dataset/pending`.
+   */
+  async deletePendingDataset() {
+    await this.#mutate("DELETE", "/node/dataset/pending");
+  }
+  /**
+   * Factory-reset the Thread node via `DELETE /node`.
+   *
+   * @throws {@link OtbrRestError} `"rest_not_allowed"` when the firmware disallows factory reset (405);
+   *   `"rest_conflict"` when the interface is in a state that forbids it (409).
+   */
+  async factoryReset() {
+    await this.#mutate("DELETE", "/node");
+  }
+  /**
+   * Enable or disable the on-BR commissioner via `PUT /node/commissioner/state`.
+   *
+   * @throws {@link OtbrRestError} `"rest_conflict"` when the BR is not active (409);
+   *   `"rest_unsupported"` on firmware without a built-in commissioner (404).
+   */
+  async setCommissionerState(enable) {
+    await this.#mutate("PUT", "/node/commissioner/state", {
+      contentType: "application/json",
+      body: JSON.stringify(enable ? "enable" : "disable")
+    });
+  }
+  /**
+   * Add a joiner to the on-BR commissioner via `POST /node/commissioner/joiner`.
+   *
+   * Provide at most one of `eui64` or `discerner`; omit both to match any device.
+   *
+   * @throws {@link ImplementationError} when both `eui64` and `discerner` are provided.
+   * @throws {@link OtbrRestError} `"rest_conflict"` when the commissioner is not active (409).
+   */
+  async addJoiner(joiner) {
+    if (joiner.eui64 !== void 0 && joiner.discerner !== void 0) {
+      throw new import_general.ImplementationError("addJoiner: provide at most one of eui64 or discerner");
+    }
+    const payload = { pskd: joiner.pskd };
+    if (joiner.eui64 !== void 0) payload.eui64 = joiner.eui64;
+    if (joiner.discerner !== void 0) payload.discerner = joiner.discerner;
+    if (joiner.timeoutSeconds !== void 0) payload.timeout = joiner.timeoutSeconds;
+    await this.#mutate("POST", "/node/commissioner/joiner", {
+      contentType: "application/json",
+      body: JSON.stringify(payload)
+    });
+  }
+  /**
+   * Remove a joiner from the on-BR commissioner via `DELETE /node/commissioner/joiner`.
+   *
+   * @param joinerId - EUI-64 hex, a discerner (`"0x…/len"`), or `"*"` to remove all joiners.
+   * @throws {@link OtbrRestError} `"rest_conflict"` when the commissioner is not active (409).
+   */
+  async removeJoiner(joinerId) {
+    await this.#mutate("DELETE", "/node/commissioner/joiner", {
+      contentType: "application/json",
+      body: JSON.stringify(joinerId)
+    });
+  }
+  async #getDataset(path) {
+    const hex = await this.#fetchText(path);
+    if (hex === void 0 || hex.length === 0) return void 0;
+    try {
+      return import_OperationalDataset.OperationalDataset.decode(hex);
+    } catch (err) {
+      throw new import_OtbrRestError.OtbrRestError("rest_protocol", `GET ${path} returned an undecodable dataset`, {
+        cause: err instanceof Error ? err : void 0
+      });
+    }
+  }
+  async #putDataset(path, dataset) {
+    const hex = typeof dataset === "string" ? dataset : import_general.Bytes.toHex(import_OperationalDataset.OperationalDataset.encode(dataset));
+    await this.#mutate("PUT", path, { contentType: "text/plain", body: hex });
+  }
+  async #getJsonString(path) {
+    const { body } = await this.#fetchJson(path);
+    if (typeof body !== "string") {
+      throw new import_OtbrRestError.OtbrRestError("rest_protocol", `GET ${path} did not return a string`);
+    }
+    return body;
+  }
+  async #getJsonNumber(path) {
+    const { body } = await this.#fetchJson(path);
+    if (typeof body !== "number" || !Number.isFinite(body)) {
+      throw new import_OtbrRestError.OtbrRestError("rest_protocol", `GET ${path} did not return a number`);
+    }
+    return body;
+  }
+  /**
+   * POST an action body to the OTBR `/api/actions` endpoint.
+   *
+   * Only available on camelCase (post-2024) OTBR builds — callers must guard
+   * on `OtbrRestCapability.keyFormat === "camel"` before calling this method.
+   *
+   * @param body - The action payload (e.g. `{ action: "resetNetworkDiagCounterTask" }`).
+   * @throws {@link OtbrRestError} with code `"rest_unreachable"` on network error.
+   * @throws {@link OtbrRestError} with code `"rest_protocol"` on a non-2xx response.
+   */
+  async resetDiagnosticCounters(body) {
+    await this.#postActions(body);
+  }
+  /**
+   * POST a `getEnergyScanTask` action to the OTBR `/api/actions` endpoint.
+   *
+   * Only available on camelCase (post-2024) OTBR builds — callers must guard
+   * on `OtbrRestCapability.keyFormat === "camel"` before calling this method.
+   *
+   * @param body - The action payload (e.g. `{ action: "getEnergyScanTask" }`).
+   * @throws {@link OtbrRestError} with code `"rest_unreachable"` on network error.
+   * @throws {@link OtbrRestError} with code `"rest_protocol"` on a non-2xx response.
+   */
+  async getEnergyScanTask(body) {
+    await this.#postActions(body);
+  }
+  async #postActions(body) {
+    const url = `${this.#baseUrl}/api/actions`;
+    const controller = new AbortController();
+    const timer = import_general.Time.getTimer(
+      "otbr-post-actions-timeout",
+      this.#timeout,
+      () => controller.abort()
+    ).start();
+    let response;
+    try {
+      response = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+        signal: controller.signal
+      });
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      throw new import_OtbrRestError.OtbrRestError("rest_unreachable", `POST /api/actions failed: ${message}`, {
+        cause: err instanceof Error ? err : void 0
+      });
+    } finally {
+      timer.stop();
+    }
+    if (!response.ok) {
+      throw new import_OtbrRestError.OtbrRestError("rest_protocol", `POST /api/actions returned ${response.status}`, {
+        httpStatus: response.status
+      });
+    }
+  }
+  async #fetchJson(path) {
+    const response = await this.#doFetch(path, "application/json");
+    if (response.status === HTTP_NO_CONTENT) {
+      return { status: response.status, body: null };
+    }
+    if (!response.ok) {
+      throw new import_OtbrRestError.OtbrRestError(errorCodeForStatus(response.status), `GET ${path} returned ${response.status}`, {
+        httpStatus: response.status
+      });
+    }
+    let parsed;
+    try {
+      parsed = JSON.parse(response.text);
+    } catch (err) {
+      throw new import_OtbrRestError.OtbrRestError("rest_protocol", `GET ${path} returned non-JSON body`, {
+        cause: err instanceof Error ? err : void 0
+      });
+    }
+    return { status: response.status, body: (0, import_caseNormalizer.normalizeKeys)(parsed) };
+  }
+  async #fetchText(path) {
+    const response = await this.#doFetch(path, "text/plain");
+    if (response.status === HTTP_NO_CONTENT) return void 0;
+    if (!response.ok) {
+      throw new import_OtbrRestError.OtbrRestError(errorCodeForStatus(response.status), `GET ${path} returned ${response.status}`, {
+        httpStatus: response.status
+      });
+    }
+    return response.text;
+  }
+  async #doFetch(path, accept) {
+    const url = `${this.#baseUrl}${path}`;
+    const controller = new AbortController();
+    const timer = import_general.Time.getTimer("otbr-fetch-timeout", this.#timeout, () => controller.abort()).start();
+    try {
+      const response = await fetch(url, {
+        method: "GET",
+        headers: { Accept: accept },
+        signal: controller.signal
+      });
+      const text = await response.text();
+      return { status: response.status, ok: response.ok, text };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      throw new import_OtbrRestError.OtbrRestError("rest_unreachable", `GET ${path} failed: ${message}`, {
+        cause: err instanceof Error ? err : void 0
+      });
+    } finally {
+      timer.stop();
+    }
+  }
+  async #mutate(method, path, opts) {
+    const url = `${this.#baseUrl}${path}`;
+    const controller = new AbortController();
+    const timer = import_general.Time.getTimer("otbr-mutate-timeout", this.#timeout, () => controller.abort()).start();
+    const headers = {};
+    if (opts?.contentType !== void 0) headers["Content-Type"] = opts.contentType;
+    let status;
+    let ok;
+    try {
+      const response = await fetch(url, { method, headers, body: opts?.body, signal: controller.signal });
+      await response.text();
+      status = response.status;
+      ok = response.ok;
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      throw new import_OtbrRestError.OtbrRestError("rest_unreachable", `${method} ${path} failed: ${message}`, {
+        cause: err instanceof Error ? err : void 0
+      });
+    } finally {
+      timer.stop();
+    }
+    if (!ok) {
+      throw new import_OtbrRestError.OtbrRestError(errorCodeForStatus(status), `${method} ${path} returned ${status}`, {
+        httpStatus: status
+      });
+    }
+  }
+}
+//# sourceMappingURL=OtbrRestClient.js.map

package/dist/cjs/otbr-rest/OtbrRestClient.js.map

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

package/dist/cjs/otbr-rest/OtbrRestDiagnosticSource.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { DiagnosticResponse } from "../diagnostic/DiagnosticResponse.js";
+import type { DiagnosticSource, QueryMulticastHandle, QueryMulticastOptions } from "../diagnostic/DiagnosticSource.js";
+import type { OtbrRestCapability } from "./OtbrRestCapability.js";
+import type { OtbrRestClient } from "./OtbrRestClient.js";
+type ClientLike = Pick<OtbrRestClient, "getDiagnostics" | "getNode" | "resetDiagnosticCounters">;
+/**
+ * {@link DiagnosticSource} implementation that wraps the OTBR REST `/diagnostics`
+ * endpoint.
+ *
+ * Unlike the MeshCoP path (DTLS + CoAP), this source requires no DTLS handshake;
+ * the BR exposes a pre-collected mesh-wide diagnostic snapshot over plain HTTP.
+ * TLV type filtering and multicast scoping are not supported on the wire — the
+ * full snapshot is always fetched and filtered client-side.
+ *
+ * Bind one instance per discovered OTBR REST endpoint. The `capability` object
+ * from {@link OtbrRestProbe} records which network this source covers.
+ */
+export declare class OtbrRestDiagnosticSource implements DiagnosticSource {
+    #private;
+    readonly kind: "otbr-rest";
+    /**
+     * @param client - REST client (or compatible duck type) for the target BR.
+     * @param capability - Probed metadata identifying the network this source covers.
+     */
+    constructor(client: ClientLike, capability: OtbrRestCapability);
+    /**
+     * 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: Uint8Array): boolean;
+    /**
+     * 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.
+     */
+    queryUnicast(target: {
+        rloc16?: number;
+        ip?: string;
+    }, _tlvTypes: number[]): Promise<DiagnosticResponse>;
+    /**
+     * 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: "ff03::1" | "ff03::2", _opts: QueryMulticastOptions): QueryMulticastHandle;
+    /**
+     * 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.
+     */
+    resetCounters(_target: {
+        rloc16?: number;
+        ip?: string;
+    }, _tlvTypes?: ReadonlyArray<number>): Promise<void>;
+}
+export {};
+//# sourceMappingURL=OtbrRestDiagnosticSource.d.ts.map

package/dist/cjs/otbr-rest/OtbrRestDiagnosticSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OtbrRestDiagnosticSource.d.ts","sourceRoot":"","sources":["../../../src/otbr-rest/OtbrRestDiagnosticSource.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAEvH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAM1D,KAAK,UAAU,GAAG,IAAI,CAAC,cAAc,EAAE,gBAAgB,GAAG,SAAS,GAAG,yBAAyB,CAAC,CAAC;AAEjG;;;;;;;;;;;GAWG;AACH,qBAAa,wBAAyB,YAAW,gBAAgB;;IAC7D,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAU;IAKrC;;;OAGG;IACH,YAAY,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,kBAAkB,EAG7D;IAED;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAEtC;IAED;;;;;;;;;;;;OAYG;IACG,YAAY,CAAC,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoB7G;IAED;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,EAAE,KAAK,EAAE,qBAAqB,GAAG,oBAAoB,CAwChG;IAED;;;;;;;;;;;;;OAaG;IACG,aAAa,CACf,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,EACzC,SAAS,GAAE,aAAa,CAAC,MAAM,CAA2B,GAC3D,OAAO,CAAC,IAAI,CAAC,CAQf;CACJ"}