@matter/testing 0.17.9 → 0.18.0-alpha.0-20260812-4d7f2790e

package/dist/cjs/chip/cert/chip-app-subject.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/chip/cert/chip-app-subject.ts"],
+  "mappings": "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",
+  "names": ["hostPlatform"]
+}

package/dist/cjs/chip/cert/controller-adapter.d.ts

@@ -0,0 +1,119 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { LogSource } from "./cert-context.js";
+import type { LogFollower } from "./log-follower.js";
+export type { LogSource };
+/**
+ * Opaque reference to a node commissioned through a {@link ControllerAdapter}.
+ *
+ * Adapters mint and interpret their own refs; a step never constructs or parses one, it only passes
+ * back what {@link ControllerAdapter.commission} returned.
+ */
+export type CertNodeRef = string;
+/**
+ * Commissioning parameters a {@link ControllerAdapter} needs to pair a node.
+ *
+ * Structurally compatible with {@link Subject.CommissioningParameters} so a step can pass
+ * `subject.commissioning` directly for a device's original setup code.
+ *
+ * Either `manualPairingCode` or both `passcode`/`discriminator` must be present. An enhanced
+ * commissioning window (`CertNodeApi.openCommissioningWindow({enhanced: true})`) generates a fresh
+ * random discriminator/passcode pair that only the returned `manualPairingCode` carries — a step
+ * commissioning through that window has no other way to obtain them.
+ */
+export interface CommissioningTarget {
+    passcode?: number;
+    discriminator?: number;
+    qrPairingCode?: string;
+    manualPairingCode?: string;
+}
+/**
+ * An attribute (or, for {@link CertNodeApi.readAttribute}, wildcard attribute path).
+ *
+ * An absent field is a wildcard for that path segment. `readAttribute` supports wildcards
+ * (TC-IDM-2.1); other operations require a concrete path.
+ */
+export interface AttributePathSpec {
+    endpoint?: number;
+    cluster?: number;
+    attribute?: number;
+}
+export interface SubscribeOptions {
+    minIntervalFloorSeconds: number;
+    maxIntervalCeilingSeconds: number;
+    onUpdate?: (value: unknown) => void;
+}
+export interface ReadAttributeOptions {
+    /**
+     * Whether the read is fabric-filtered (Matter Core § 8.9.2's `FabricFiltered` flag; default
+     * true, the interaction-model default). Set false to read across all fabrics — a
+     * fabric-scoped attribute like OperationalCredentials.fabrics otherwise returns only the
+     * reading controller's own entry, useless for a multi-controller TC that must see fabrics it
+     * didn't itself create.
+     */
+    fabricFiltered?: boolean;
+}
+/**
+ * Controller-side view of a single commissioned node.
+ */
+export interface CertNodeApi {
+    invoke(cluster: string | number, command: string, args?: object, endpoint?: number): Promise<unknown>;
+    readAttribute(path: AttributePathSpec, options?: ReadAttributeOptions): Promise<unknown>;
+    writeAttribute(path: AttributePathSpec, value: unknown): Promise<void>;
+    subscribe(path: AttributePathSpec, opts: SubscribeOptions): Promise<unknown>;
+    openCommissioningWindow(opts: {
+        timeout: number;
+        enhanced: boolean;
+    }): Promise<{
+        manualPairingCode?: string;
+        qrPairingCode?: string;
+    }>;
+    decommission(): Promise<void>;
+    /**
+     * The operational mDNS instance name (`<compressed-fabric-id>-<node-id>._matter._tcp.local`) this node
+     * advertises on the fabric it was commissioned onto — the same value matter.js's own advertiser computes
+     * via `getOperationalDeviceQname` (`@matter/protocol`). A network check (see
+     * `support/chip-testing/src/cert/mdns-check.ts`) uses this to attribute an operational SRV record to this
+     * specific node rather than to whatever else is advertising `_matter._tcp` on the network.
+     */
+    operationalMdnsInstanceName(): Promise<string>;
+}
+/**
+ * A controller identity participating in a cert test (e.g. "dut", "th_cr2").
+ *
+ * Pure interface: no matter.js type ever crosses this boundary, only plain string/number addressing
+ * and plain data. Implementations wrap a real controller stack (see
+ * `support/chip-testing/src/cert/InProcessControllerAdapter.ts`) but this package must stay free of
+ * that dependency.
+ */
+export interface ControllerAdapter {
+    id: string;
+    start(): Promise<void>;
+    close(): Promise<void>;
+    commission(target: CommissioningTarget): Promise<CertNodeRef>;
+    node(ref: CertNodeRef): CertNodeApi;
+    log: LogFollower;
+}
+/**
+ * Builds a {@link ControllerAdapter} for the given id (e.g. "dut", "th_cr2").
+ */
+export type ControllerAdapterFactory = (id: string) => ControllerAdapter;
+/**
+ * Registers the {@link ControllerAdapterFactory} cert-test wiring uses to construct controllers.
+ *
+ * `packages/testing` cannot construct a real controller itself (that needs matter.js, which this
+ * package must stay free of — see the repo's dependency invariant); `support/chip-testing/src/cert`
+ * registers its `InProcessControllerAdapter` here at load time instead. There is exactly one slot:
+ * re-registration throws, since a silent overwrite would swap controller implementations under any
+ * cert test already declared.
+ */
+export declare function registerControllerAdapterFactory(factory: ControllerAdapterFactory): void;
+/**
+ * Constructs a {@link ControllerAdapter} via the factory registered with
+ * {@link registerControllerAdapterFactory}.
+ */
+export declare function createControllerAdapter(id: string): ControllerAdapter;
+//# sourceMappingURL=controller-adapter.d.ts.map

package/dist/cjs/chip/cert/controller-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-adapter.d.ts","sourceRoot":"","sources":["../../../../src/chip/cert/controller-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC7B,uBAAuB,EAAE,MAAM,CAAC;IAChC,yBAAyB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,oBAAoB;IACjC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtG,aAAa,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzF,cAAc,CAAC,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,SAAS,CAAC,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7E,uBAAuB,CAAC,IAAI,EAAE;QAC1B,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,OAAO,CAAC;KACrB,GAAG,OAAO,CAAC;QAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B;;;;;;OAMG;IACH,2BAA2B,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAClD;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9D,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW,CAAC;IACpC,GAAG,EAAE,WAAW,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,EAAE,EAAE,MAAM,KAAK,iBAAiB,CAAC;AAIzE;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAKxF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,CAQrE"}

package/dist/cjs/chip/cert/controller-adapter.js

@@ -0,0 +1,45 @@
+"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 controller_adapter_exports = {};
+__export(controller_adapter_exports, {
+  createControllerAdapter: () => createControllerAdapter,
+  registerControllerAdapterFactory: () => registerControllerAdapterFactory
+});
+module.exports = __toCommonJS(controller_adapter_exports);
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+let activeFactory;
+function registerControllerAdapterFactory(factory) {
+  if (activeFactory) {
+    throw new Error("A ControllerAdapter factory is already registered; only one is supported per process");
+  }
+  activeFactory = factory;
+}
+function createControllerAdapter(id) {
+  if (!activeFactory) {
+    throw new Error(
+      "No ControllerAdapter factory registered; a consumer (e.g. support/chip-testing/src/cert/index.ts) must call registerControllerAdapterFactory() before running a cert test"
+    );
+  }
+  return activeFactory(id);
+}
+//# sourceMappingURL=controller-adapter.js.map

package/dist/cjs/chip/cert/controller-adapter.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/chip/cert/controller-adapter.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA+GA,IAAI;AAWG,SAAS,iCAAiC,SAAyC;AACtF,MAAI,eAAe;AACf,UAAM,IAAI,MAAM,sFAAsF;AAAA,EAC1G;AACA,kBAAgB;AACpB;AAMO,SAAS,wBAAwB,IAA+B;AACnE,MAAI,CAAC,eAAe;AAChB,UAAM,IAAI;AAAA,MACN;AAAA,IAEJ;AAAA,EACJ;AACA,SAAO,cAAc,EAAE;AAC3B;",
+  "names": []
+}

package/dist/cjs/chip/cert/device-config.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { DeviceFlavor } from "./cert-context.js";
+/**
+ * Resolve which device implementation cert tests run against, from `MATTER_CERT_DEVICE`.
+ *
+ * Unset defaults to `matterjs`, the only flavor that works with no configuration at all:
+ * `chip-local` needs `MATTER_CERT_APP_DIR`/`MATTER_CHIP_BINS_SOURCE`, and `chip-docker` has no
+ * published per-app images yet, so either would guarantee a failing default run.
+ */
+export declare function resolveDeviceFlavor(): DeviceFlavor;
+//# sourceMappingURL=device-config.d.ts.map

package/dist/cjs/chip/cert/device-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-config.d.ts","sourceRoot":"","sources":["../../../../src/chip/cert/device-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMtD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,YAAY,CAYlD"}

package/dist/cjs/chip/cert/device-config.js

@@ -0,0 +1,43 @@
+"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 device_config_exports = {};
+__export(device_config_exports, {
+  resolveDeviceFlavor: () => resolveDeviceFlavor
+});
+module.exports = __toCommonJS(device_config_exports);
+var import_node_process = require("node:process");
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function isDeviceFlavor(value) {
+  return value === "chip-docker" || value === "chip-local" || value === "matterjs";
+}
+function resolveDeviceFlavor() {
+  const value = import_node_process.env.MATTER_CERT_DEVICE;
+  if (value === void 0 || value === "") {
+    return "matterjs";
+  }
+  if (isDeviceFlavor(value)) {
+    return value;
+  }
+  throw new Error(`Unknown MATTER_CERT_DEVICE "${value}" (expected "chip-docker", "chip-local", or "matterjs")`);
+}
+//# sourceMappingURL=device-config.js.map

package/dist/cjs/chip/cert/device-config.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/chip/cert/device-config.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,0BAAoB;AANpB;AAAA;AAAA;AAAA;AAAA;AASA,SAAS,eAAe,OAAsC;AAC1D,SAAO,UAAU,iBAAiB,UAAU,gBAAgB,UAAU;AAC1E;AASO,SAAS,sBAAoC;AAChD,QAAM,QAAQ,wBAAI;AAElB,MAAI,UAAU,UAAa,UAAU,IAAI;AACrC,WAAO;AAAA,EACX;AAEA,MAAI,eAAe,KAAK,GAAG;AACvB,WAAO;AAAA,EACX;AAEA,QAAM,IAAI,MAAM,+BAA+B,KAAK,yDAAyD;AACjH;",
+  "names": []
+}

package/dist/cjs/chip/cert/evidence.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { CertStepDefinition, CheckRecord, DeviceExitInfo, StepRecorder, StepVerdict } from "./cert-context.js";
+import type { LogLine } from "./log-follower.js";
+export type { CheckRecord };
+/**
+ * A single cert-test step's recorded outcome and evidence.
+ */
+export interface StepRecord {
+    step: number | string;
+    text: string;
+    expected?: string;
+    checks: CheckRecord[];
+    verdict: StepVerdict;
+    skipReason?: string;
+}
+/**
+ * The evidence bundle for one cert-test run, written to `result.json` by {@link EvidenceRecorder.flush}.
+ */
+export interface RunRecord {
+    tc: string;
+    plan: string;
+    run: {
+        timestamp: string;
+        controller: string;
+        device: string;
+        matterJsCommit: string;
+        chipRef?: string;
+    };
+    steps: StepRecord[];
+    verdict: "pass" | "fail" | "skipped";
+    deviceExit?: {
+        code: number | null;
+        signal?: string;
+    };
+}
+/**
+ * Collects a {@link CertTest} run's per-step evidence and writes it to disk as `result.json` plus one
+ * `<name>.log` per {@link attachLog} call.
+ *
+ * `endStep` always receives the full {@link CertStepDefinition}, not just a verdict — that's what
+ * lets a step the engine never reached (PICS-skipped, or trailing a prior abort, so `beginStep` was
+ * never called for it) still become a complete {@link StepRecord}: its `text`/`expected` come from
+ * the definition `endStep` was given, and its `checks` default to empty.
+ */
+export declare class EvidenceRecorder implements StepRecorder {
+    #private;
+    constructor(outDir: string, meta: RunRecord["run"] & {
+        tc: string;
+        plan: string;
+    });
+    beginStep(step: CertStepDefinition): void;
+    check(record: CheckRecord): void;
+    endStep(step: CertStepDefinition, verdict: StepVerdict, skipReason?: string): CheckRecord[];
+    /**
+     * Records that a device's backing process/container exited during the run. A device crash fails
+     * the run regardless of how far its steps got (see {@link RunRecord.deviceExit}).
+     */
+    deviceExited(info: DeviceExitInfo): void;
+    /**
+     * Attaches a raw log dump under `<name>.log`, e.g. `attachLog("controller", ...)` or
+     * `attachLog("device-app1", ...)`.
+     */
+    attachLog(name: string, lines: LogLine[]): void;
+    flush(): Promise<string>;
+}
+//# sourceMappingURL=evidence.d.ts.map

package/dist/cjs/chip/cert/evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../../../../src/chip/cert/evidence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAIjD,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE;QACD,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,cAAc,EAAE,MAAM,CAAC;QACvB,OAAO,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACrC,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD;AAQD;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,YAAW,YAAY;;IAQjD,YAAY,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAGhF;IAED,SAAS,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAExC;IAED,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAK/B;IAED,OAAO,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CAqB1F;IAED;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAEvC;IAED;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAE9C;IAEK,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CA2B7B;CAmBJ"}

package/dist/cjs/chip/cert/evidence.js

@@ -0,0 +1,128 @@
+"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 evidence_exports = {};
+__export(evidence_exports, {
+  EvidenceRecorder: () => EvidenceRecorder
+});
+module.exports = __toCommonJS(evidence_exports);
+var import_promises = require("node:fs/promises");
+var import_node_path = require("node:path");
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function sanitizeTimestampForPath(timestamp) {
+  return timestamp.replace(/:/g, "-");
+}
+class EvidenceRecorder {
+  #outDir;
+  #meta;
+  #steps = new Array();
+  #logs = /* @__PURE__ */ new Map();
+  #current;
+  #deviceExit;
+  constructor(outDir, meta) {
+    this.#outDir = outDir;
+    this.#meta = meta;
+  }
+  beginStep(step) {
+    this.#current = { def: step, checks: new Array() };
+  }
+  check(record) {
+    if (!this.#current) {
+      throw new Error("EvidenceRecorder.check() called without an active step; call beginStep() first");
+    }
+    this.#current.checks.push(record);
+  }
+  endStep(step, verdict, skipReason) {
+    if (this.#current !== void 0 && this.#current.def !== step) {
+      throw new Error(
+        `EvidenceRecorder.endStep(${step.number}) called while step ${this.#current.def.number} is active`
+      );
+    }
+    const checks = this.#current?.checks ?? new Array();
+    this.#current = void 0;
+    this.#steps.push({
+      step: step.number,
+      text: step.text,
+      expected: step.expected,
+      checks,
+      verdict,
+      skipReason
+    });
+    return checks;
+  }
+  /**
+   * Records that a device's backing process/container exited during the run. A device crash fails
+   * the run regardless of how far its steps got (see {@link RunRecord.deviceExit}).
+   */
+  deviceExited(info) {
+    this.#deviceExit = { code: info.code, signal: info.signal ?? void 0 };
+  }
+  /**
+   * Attaches a raw log dump under `<name>.log`, e.g. `attachLog("controller", ...)` or
+   * `attachLog("device-app1", ...)`.
+   */
+  attachLog(name, lines) {
+    this.#logs.set(name, lines);
+  }
+  async flush() {
+    const dirName = `${sanitizeTimestampForPath(this.#meta.timestamp)}-${this.#meta.tc}`;
+    const dir = (0, import_node_path.join)(this.#outDir, dirName);
+    await (0, import_promises.mkdir)(dir, { recursive: true });
+    const record = {
+      tc: this.#meta.tc,
+      plan: this.#meta.plan,
+      run: {
+        timestamp: this.#meta.timestamp,
+        controller: this.#meta.controller,
+        device: this.#meta.device,
+        matterJsCommit: this.#meta.matterJsCommit,
+        chipRef: this.#meta.chipRef
+      },
+      steps: this.#steps,
+      verdict: this.#verdict(),
+      deviceExit: this.#deviceExit
+    };
+    await (0, import_promises.writeFile)((0, import_node_path.join)(dir, "result.json"), JSON.stringify(record, null, 4));
+    for (const [name, lines] of this.#logs) {
+      await (0, import_promises.writeFile)((0, import_node_path.join)(dir, `${name}.log`), lines.map((line) => line.text).join("\n"));
+    }
+    return dir;
+  }
+  /**
+   * A run where every step was skipped (or that had no steps at all — a malformed definition) is
+   * neither a pass nor a fail: nothing was actually exercised, so reporting `"pass"` would overstate
+   * what the run proved. Only a run with at least one non-skipped step can pass.
+   */
+  #verdict() {
+    if (this.#deviceExit) {
+      return "fail";
+    }
+    if (this.#steps.some((step) => step.verdict === "fail" || step.verdict === "aborted")) {
+      return "fail";
+    }
+    if (this.#steps.some((step) => step.verdict === "pass")) {
+      return "pass";
+    }
+    return "skipped";
+  }
+}
+//# sourceMappingURL=evidence.js.map

package/dist/cjs/chip/cert/evidence.js.map

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

package/dist/cjs/chip/cert/log-follower.d.ts

@@ -0,0 +1,96 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { LogSource } from "./cert-context.js";
+/**
+ * A single buffered log line, with the cursor position it occupies in the follower's buffer.
+ */
+export interface LogLine {
+    index: number;
+    at: Date;
+    text: string;
+    /** Set on a line added via {@link LogFollower.annotate} — never matched by {@link LogFollower.expect}. */
+    synthetic?: true;
+}
+export type LogExpectResult = {
+    verdict: "pass";
+    matched: LogLine;
+    pattern: string;
+} | {
+    verdict: "unverified";
+    reason: "no-pattern-for-flavor";
+};
+/**
+ * Per-implementation-family patterns for a {@link LogFollower.expect} call. A step supplies
+ * whichever of these it has evidence for; the active device or controller's flavor selects one.
+ */
+export interface LogExpectPatterns {
+    chip?: RegExp;
+    matterjs?: RegExp;
+}
+export interface LogExpectOptions {
+    flavor: string;
+    timeoutMs?: number;
+    from?: number;
+}
+/**
+ * Thrown by {@link LogFollower.expect} when no buffered or newly-arrived line matches before the
+ * deadline.
+ */
+export declare class CertLogTimeoutError extends Error {
+    readonly pattern: string;
+    readonly from: number;
+    readonly tail: LogLine[];
+    constructor(pattern: string, from: number, tail: LogLine[]);
+}
+/**
+ * Thrown by {@link LogFollower.expect} when the follower closes (or its source runs out) while the
+ * expectation is still pending and unmatched.
+ */
+export declare class CertLogClosedError extends Error {
+    constructor(name: string);
+}
+/**
+ * Buffers every line from an `AsyncIterable<string>` log source and lets cert-test steps assert
+ * that a matching line appears within a cursor window, without depending on any particular
+ * implementation's log format directly (a step supplies a chip-flavored and/or matterjs-flavored
+ * pattern; {@link expect} picks the one for the device or controller actually under test).
+ *
+ * Also implements {@link LogSource} so a follower can itself be consumed by another follower or
+ * assigned to a {@link CertDevice}/{@link ControllerAdapter}'s `log` field.
+ */
+export declare class LogFollower implements LogSource {
+    #private;
+    readonly name: string;
+    constructor(source: AsyncIterable<string>, name: string);
+    /**
+     * Appends a synthetic line (e.g. a step-boundary banner) to the buffer at the current position,
+     * indexed like a real line but flagged so {@link expect} skips it. Lets a caller mark the
+     * chronologically right position in the evidence `.log` output without that marker ever
+     * satisfying a step's own pattern.
+     */
+    annotate(text: string): void;
+    /**
+     * Sets the default cursor a subsequent {@link expect} call scans from when it doesn't specify
+     * `from` itself. Typically called once at the start of a step.
+     */
+    mark(): number;
+    /**
+     * Every line seen so far, in arrival order. A fresh copy on each access — callers cannot
+     * mutate the follower's own buffer through it.
+     */
+    get lines(): LogLine[];
+    /**
+     * Waits for a line at or after the cursor (`options.from`, default: the last {@link mark})
+     * matching the pattern for `options.flavor`. Resolves `unverified` immediately if `patterns`
+     * has no entry for that flavor. Throws {@link CertLogTimeoutError} if the deadline passes
+     * first, or {@link CertLogClosedError} (or the source's own error) if the follower closes
+     * first.
+     */
+    expect(patterns: LogExpectPatterns, options: LogExpectOptions): Promise<LogExpectResult>;
+    follow(): AsyncIterable<string>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=log-follower.d.ts.map

package/dist/cjs/chip/cert/log-follower.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-follower.d.ts","sourceRoot":"","sources":["../../../../src/chip/cert/log-follower.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAInD;;GAEG;AACH,MAAM,WAAW,OAAO;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,0GAA0G;IAC1G,SAAS,CAAC,EAAE,IAAI,CAAC;CACpB;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,uBAAuB,CAAA;CAAE,CAAC;AAExH;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAEtC,QAAQ,CAAC,OAAO,EAAE,MAAM;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE;IAH5B,YACa,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EAAE,EAS3B;CACJ;AAED;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IACzC,YAAY,IAAI,EAAE,MAAM,EAEvB;CACJ;AAsBD;;;;;;;;GAQG;AACH,qBAAa,WAAY,YAAW,SAAS;;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAWtB,YAAY,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAMtD;IAED;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAG3B;IAED;;;OAGG;IACH,IAAI,IAAI,MAAM,CAGb;IAED;;;OAGG;IACH,IAAI,KAAK,IAAI,OAAO,EAAE,CAErB;IAED;;;;;;OAMG;IACG,MAAM,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAgC7F;IAED,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC,CAE9B;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAG3B;CAqEJ"}