@lingxia/test 0.17.0 → 0.19.0

package/dist/mock.d.ts

@@ -0,0 +1,43 @@
+import type { LxAppDriver, Scenario, ScenarioCall, ScenarioInput } from "@lingxia/types/automation";
+import { type NetworkHost } from "./network.js";
+import type { TestScenario } from "./types.js";
+import type { ScenarioReport } from "./report-types.js";
+/**
+ * The scenario one spec installed with `t.scenario.use()`. Installing
+ * another replaces it (the host does the same for its run), and the runner
+ * removes it when the spec ends.
+ */
+export declare class ScenarioScope {
+    current: {
+        raw: Scenario;
+        label: string;
+    } | undefined;
+    failure: unknown;
+    track(raw: Scenario, label: string): void;
+    /** Remove the scenario; one already removed counts as removed. */
+    reclaim(): Promise<void>;
+    /**
+     * What a failed spec reports about its scenario: each rule's hits and the
+     * Function calls the companion saw. Never throws.
+     */
+    report(budgetMs: number): Promise<{
+        scenario: ScenarioReport;
+        functionCalls: ScenarioCall[];
+    } | undefined>;
+}
+/** `name:variant`, `scenario` standing in for a missing name. */
+export declare function scenarioLabel(definition: ScenarioInput, variant: string | undefined): string;
+/**
+ * `t.scenario.use(file, variant?)`: the host installs the scenario for the
+ * run, on top of the mock selection; the fixture removes it when the spec
+ * ends and traces every call.
+ */
+export declare function installScenario(resolve: () => LxAppDriver, host: NetworkHost, scope: ScenarioScope, definition: ScenarioInput, variant?: string): Promise<TestScenario>;
+/**
+ * Each spec starts with fresh mock handler state: the app evaluates
+ * `mocks/index.ts` again on its next call. Returns why a companion could
+ * not do the same for the run's Functions, once per run (`reasons` holds
+ * what was already said).
+ */
+export declare function resetMocks(driver: LxAppDriver, reasons: Set<string>): Promise<string | undefined>;
+//# sourceMappingURL=mock.d.ts.map

package/dist/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../src/mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EACR,YAAY,EAEZ,aAAa,EAEd,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAA6D,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3G,OAAO,KAAK,EAAsB,YAAY,EAAsB,MAAM,YAAY,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,EAAE;QAAE,GAAG,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACtD,OAAO,EAAE,OAAO,CAAC;IAEjB,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIzC,kEAAkE;IAC5D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAa9B;;;OAGG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,cAAc,CAAC;QAAC,aAAa,EAAE,YAAY,EAAE,CAAA;KAAE,GAAG,SAAS,CAAC;CA6BjH;AAED,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI5F;AAsBD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,WAAW,EAC1B,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,aAAa,EACzB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC,CA2CvB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAWvG"}

package/dist/mock.js

@@ -0,0 +1,162 @@
+import { truncate } from "./format.js";
+import { errorText, scenarioCall, waitForNextCall } from "./network.js";
+import { runnerSetTimeout } from "./pending.js";
+/**
+ * The scenario one spec installed with `t.scenario.use()`. Installing
+ * another replaces it (the host does the same for its run), and the runner
+ * removes it when the spec ends.
+ */
+export class ScenarioScope {
+    track(raw, label) {
+        this.current = { raw, label };
+    }
+    /** Remove the scenario; one already removed counts as removed. */
+    async reclaim() {
+        if (this.failure !== undefined)
+            throw this.failure;
+        const current = this.current;
+        if (!current)
+            return;
+        // Raw handle: the fixture is closed by now.
+        try {
+            await current.raw.unroute();
+        }
+        catch (error) {
+            throw new Error(`mock scenario ${current.label} was not removed: ${errorText(error)}`);
+        }
+        if (this.current === current)
+            this.current = undefined;
+    }
+    /**
+     * What a failed spec reports about its scenario: each rule's hits and the
+     * Function calls the companion saw. Never throws.
+     */
+    async report(budgetMs) {
+        const current = this.current;
+        if (!current)
+            return undefined;
+        let rules = [];
+        let calls = [];
+        try {
+            rules = [...current.raw.rules];
+            calls = await Promise.race([
+                current.raw.calls(),
+                new Promise((resolve) => { runnerSetTimeout(() => resolve([]), budgetMs); }),
+            ]);
+        }
+        catch {
+            // Evidence never replaces the failure.
+        }
+        return {
+            scenario: {
+                label: current.label,
+                name: current.raw.name,
+                variant: current.raw.variant,
+                rules: rules.map((rule) => ({
+                    index: rule.index,
+                    target: rule.target,
+                    kind: rule.kind,
+                    hits: rule.hits ?? calls.filter((call) => call.rule === rule.index).length,
+                })),
+            },
+            functionCalls: calls.filter((call) => call.kind === "function"),
+        };
+    }
+}
+/** `name:variant`, `scenario` standing in for a missing name. */
+export function scenarioLabel(definition, variant) {
+    const record = definition;
+    const name = typeof record.name === "string" ? record.name : "scenario";
+    return variant ? `${name}:${variant}` : name;
+}
+function describeScenario(definition, variant) {
+    const record = definition;
+    const shared = Array.isArray(record.rules) ? record.rules.length : 0;
+    const own = variant && Array.isArray(record.variants?.[variant]?.rules) ? record.variants[variant].rules.length : 0;
+    const count = shared + own;
+    return truncate(`${scenarioLabel(definition, variant)} (${count} rule${count === 1 ? "" : "s"})`, 80);
+}
+function describeTarget(target) {
+    if ("http" in target)
+        return target.http;
+    if ("function" in target)
+        return `function ${target.function}`;
+    return `rule ${target.rule}`;
+}
+function validTarget(target) {
+    if (!target || typeof target !== "object")
+        return false;
+    const record = target;
+    return typeof record.http === "string" || typeof record.function === "string" || typeof record.rule === "number";
+}
+/**
+ * `t.scenario.use(file, variant?)`: the host installs the scenario for the
+ * run, on top of the mock selection; the fixture removes it when the spec
+ * ends and traces every call.
+ */
+export function installScenario(resolve, host, scope, definition, variant) {
+    return host.act("mock.use", describeScenario(definition, variant), async () => {
+        let raw;
+        try {
+            raw = variant === undefined
+                ? await resolve().mock.use(definition)
+                : await resolve().mock.use(definition, variant);
+        }
+        catch (error) {
+            if (error?.code === "E_SCENARIO_STATE_UNKNOWN")
+                scope.failure = error;
+            throw error;
+        }
+        const label = scenarioLabel(definition, variant);
+        scope.track(raw, label);
+        const read = async (filter) => (await raw.calls(filter)).map(scenarioCall);
+        const cursors = new Map();
+        const wrapped = {
+            get name() { return raw.name; },
+            get variant() { return raw.variant; },
+            get rules() { return raw.rules; },
+            calls: (filter) => host.act("scenario.calls", filter ? JSON.stringify(filter) : label, () => read(filter)),
+            waitForCall: (target, options) => {
+                if (!validTarget(target)) {
+                    throw new TypeError("scenario.waitForCall needs { http: 'METHOD url' }, { function: 'name' } or { rule: n }");
+                }
+                const key = JSON.stringify(target);
+                let cursor = cursors.get(key);
+                if (!cursor)
+                    cursors.set(key, cursor = { after: 0, taken: 0 });
+                const after = async (seq) => {
+                    const window = await raw.callsAfter(target, seq);
+                    return { calls: window.calls.map(scenarioCall), droppedThrough: window.droppedThrough };
+                };
+                return waitForNextCall(host, "scenario.waitForCall", `scenario ${label}: ${describeTarget(target)}`, after, () => read(), cursor, options);
+            },
+            remove: () => host.act("scenario.remove", label, async () => {
+                await raw.unroute();
+                if (scope.current?.raw === raw)
+                    scope.current = undefined;
+            }),
+        };
+        return wrapped;
+    });
+}
+/**
+ * Each spec starts with fresh mock handler state: the app evaluates
+ * `mocks/index.ts` again on its next call. Returns why a companion could
+ * not do the same for the run's Functions, once per run (`reasons` holds
+ * what was already said).
+ */
+export async function resetMocks(driver, reasons) {
+    const mock = driver.mock;
+    // A host that predates mocks has nothing to reset.
+    if (!mock || typeof mock.reset !== "function")
+        return undefined;
+    const result = await mock.reset();
+    const reason = result.function && result.function.reset === false
+        ? result.function.reason ?? "the companion cannot start its handler state over"
+        : undefined;
+    if (reason === undefined || reasons.has(reason))
+        return undefined;
+    reasons.add(reason);
+    return `mock handler state of the Functions is not reset per spec: ${reason}`;
+}
+//# sourceMappingURL=mock.js.map

package/dist/mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.js","sourceRoot":"","sources":["../src/mock.ts"],"names":[],"mappings":"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"}

package/dist/network.d.ts

@@ -0,0 +1,68 @@
+import type { NetworkDriver, NetworkRoute, NetworkRouteRequest, ScenarioCall } from "@lingxia/types/automation";
+import type { NetworkCall, TestNetwork, WaitForCallOptions } from "./types.js";
+/** The fixture surface the network, scenario and clock wrappers need. */
+export interface NetworkHost {
+    act<T>(name: string, detail: string, op: () => T | Promise<T>): Promise<T>;
+    /** Milliseconds left in the spec (or cleanup) budget. */
+    budgetRoom(): number;
+    /** Stop recording actions while a wait polls; `resumeActions` undoes it. */
+    silenceActions(): void;
+    resumeActions(): void;
+    /** A note for the run's diagnostics, beside the trace. */
+    diagnostic(phase: string, message: string): void | Promise<void>;
+}
+/**
+ * Routes one spec installed, across every `t.app` / `t.automation.lxapp()`
+ * wrapper it created. The runner removes them when the spec ends — whether
+ * or not its body settled, apart from the spec's own cleanup — so a route
+ * never bleeds into the next spec of the same run.
+ */
+export declare class NetworkScope {
+    readonly routes: Map<number, NetworkRoute>;
+    track(route: NetworkRoute): void;
+    /**
+     * Remove every tracked route; a route already gone (expired through
+     * `times`, removed by the spec) counts as removed. Rejects naming the
+     * routes whose removal failed.
+     */
+    reclaim(): Promise<void>;
+}
+export declare function errorText(error: unknown): string;
+/** One request a route handled, as a `NetworkCall`. */
+export declare function routeCall(request: NetworkRouteRequest): NetworkCall;
+/** One call that reached a scenario, as a `NetworkCall`. */
+export declare function scenarioCall(call: ScenarioCall): NetworkCall;
+/** `GET https://h/x → 200 (rule 2)`, for failure messages. */
+export declare function describeCall(call: NetworkCall): string;
+/** Calls after a cursor, and how far the log they come from was trimmed. */
+export interface CallWindowRead {
+    calls: NetworkCall[];
+    /** The highest `seq` the log dropped (0 when none). */
+    droppedThrough: number;
+}
+/** Where one handle's (or scenario target's) `waitForCall` stands. */
+export interface CallCursor {
+    /** `seq` of the last call handed out; 0 before the first. */
+    after: number;
+    /** Calls handed out so far. */
+    taken: number;
+}
+/**
+ * Poll `read(cursor.after)` until it lists a call and hand out the oldest.
+ * Each handle (and scenario target) keeps its own cursor, so successive
+ * waits return successive calls, including ones made before the wait
+ * started. The host logs are bounded; when they dropped calls past the
+ * cursor, the next call cannot be told and the wait says so instead of
+ * handing out a later one.
+ *
+ * Every read and pause shares one deadline: a read that never returns
+ * fails the wait on time, and one that returns after the deadline does not
+ * count. The recent calls a timeout lists get a small slice of their own.
+ */
+export declare function waitForNextCall(host: NetworkHost, verb: string, what: string, read: (after: number) => Promise<CallWindowRead>, recent: () => Promise<NetworkCall[]>, cursor: CallCursor, options?: WaitForCallOptions): Promise<NetworkCall>;
+/**
+ * `resolve` reads the raw driver lazily, inside each traced call, so an app
+ * that closed since `t.app` was read fails that call, not the read.
+ */
+export declare function wrapNetwork(resolve: () => NetworkDriver, host: NetworkHost, scope: NetworkScope): TestNetwork;
+//# sourceMappingURL=network.d.ts.map

package/dist/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../src/network.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EAGZ,mBAAmB,EACnB,YAAY,EACb,MAAM,2BAA2B,CAAC;AAInC,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAa,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAI1F,yEAAyE;AACzE,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3E,yDAAyD;IACzD,UAAU,IAAI,MAAM,CAAC;IACrB,4EAA4E;IAC5E,cAAc,IAAI,IAAI,CAAC;IACvB,aAAa,IAAI,IAAI,CAAC;IACtB,0DAA0D;IAC1D,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,QAAQ,CAAC,MAAM,4BAAmC;IAElD,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAIhC;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAa/B;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEhD;AAYD,uDAAuD;AACvD,wBAAgB,SAAS,CAAC,OAAO,EAAE,mBAAmB,GAAG,WAAW,CAanE;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,WAAW,CA0B5D;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAMtD;AAUD,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,sEAAsE;AACtE,MAAM,WAAW,UAAU;IACzB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,EAChD,MAAM,EAAE,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,EACpC,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,WAAW,CAAC,CAkEtB;AAyBD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,GAAG,WAAW,CAgC7G"}

package/dist/network.js

@@ -0,0 +1,287 @@
+import { ActionDeadline, TimeoutError } from "./deadline.js";
+import { truncate } from "./format.js";
+import { callerLocation, displayLocation } from "./ids.js";
+import { DEFAULT_ACTION_TIMEOUT_MS, DEFAULT_POLL_INTERVAL_MS } from "./version.js";
+import { runnerClearTimeout, runnerSetTimeout } from "./pending.js";
+/**
+ * Routes one spec installed, across every `t.app` / `t.automation.lxapp()`
+ * wrapper it created. The runner removes them when the spec ends — whether
+ * or not its body settled, apart from the spec's own cleanup — so a route
+ * never bleeds into the next spec of the same run.
+ */
+export class NetworkScope {
+    constructor() {
+        this.routes = new Map();
+    }
+    track(route) {
+        this.routes.set(route.id, route);
+    }
+    /**
+     * Remove every tracked route; a route already gone (expired through
+     * `times`, removed by the spec) counts as removed. Rejects naming the
+     * routes whose removal failed.
+     */
+    async reclaim() {
+        const failed = [];
+        for (const [id, route] of [...this.routes]) {
+            // Raw handle: the fixture is closed by now.
+            try {
+                await route.unroute();
+                this.routes.delete(id);
+            }
+            catch (error) {
+                failed.push(`${route.pattern}: ${errorText(error)}`);
+            }
+        }
+        if (failed.length > 0)
+            throw new Error(`network routes were not removed (${failed.join("; ")})`);
+    }
+}
+export function errorText(error) {
+    return String(error?.message ?? error);
+}
+/** A request body as the spec reads it: parsed when it is JSON. */
+function parsedBody(body) {
+    if (body === null)
+        return null;
+    try {
+        return JSON.parse(body);
+    }
+    catch {
+        return body;
+    }
+}
+/** One request a route handled, as a `NetworkCall`. */
+export function routeCall(request) {
+    return {
+        seq: request.seq,
+        time: request.timestamp,
+        kind: "http",
+        method: request.method,
+        url: request.url,
+        status: request.status,
+        body: parsedBody(request.body),
+        headers: request.headers,
+        // A plain `continue` let the real backend answer.
+        answeredBy: request.action === "continue" ? "real" : "route",
+    };
+}
+/** One call that reached a scenario, as a `NetworkCall`. */
+export function scenarioCall(call) {
+    const answeredBy = call.rule !== null
+        ? "rule"
+        : call.answeredBy.startsWith("route")
+            ? "route"
+            : call.answeredBy.startsWith("mock") || call.answeredBy === "function mock"
+                ? "mock"
+                : call.answeredBy === "function real"
+                    ? "real"
+                    : call.kind === "function"
+                        ? "companion"
+                        : "real";
+    const out = { seq: call.seq, time: call.time, kind: call.kind, answeredBy };
+    if (call.kind === "function") {
+        out.function = call.function;
+        if (call.args !== undefined)
+            out.body = call.args;
+        if (call.outcome !== undefined)
+            out.outcome = call.outcome;
+    }
+    else {
+        out.method = call.method;
+        out.url = call.url;
+        out.status = call.status ?? null;
+        if (call.body !== undefined)
+            out.body = call.body;
+    }
+    if (call.rule !== null)
+        out.rule = call.rule;
+    if (call.noMatch)
+        out.noMatch = call.noMatch;
+    return out;
+}
+/** `GET https://h/x → 200 (rule 2)`, for failure messages. */
+export function describeCall(call) {
+    const by = call.answeredBy === "rule" && call.rule !== undefined ? `rule ${call.rule}` : call.answeredBy;
+    const head = call.kind === "function"
+        ? `function ${call.function ?? "?"} → ${call.outcome ?? "no answer"}`
+        : `${call.method ?? "?"} ${call.url ?? "?"} → ${call.status ?? "no answer"}`;
+    return `${head} (${by})${call.noMatch ? `; ${call.noMatch}` : ""}`;
+}
+/** How many recent calls a `waitForCall` timeout lists. */
+const LISTED_CALLS = 10;
+/**
+ * The most a `waitForCall` timeout spends reading recent calls for its
+ * message, past its own timeout and never past the spec's budget.
+ */
+const EVIDENCE_MS = 100;
+/**
+ * Poll `read(cursor.after)` until it lists a call and hand out the oldest.
+ * Each handle (and scenario target) keeps its own cursor, so successive
+ * waits return successive calls, including ones made before the wait
+ * started. The host logs are bounded; when they dropped calls past the
+ * cursor, the next call cannot be told and the wait says so instead of
+ * handing out a later one.
+ *
+ * Every read and pause shares one deadline: a read that never returns
+ * fails the wait on time, and one that returns after the deadline does not
+ * count. The recent calls a timeout lists get a small slice of their own.
+ */
+export function waitForNextCall(host, verb, what, read, recent, cursor, options = {}) {
+    const location = callerLocation();
+    const at = `at ${displayLocation(location.file, location.line, location.column)}`;
+    const requested = options.timeout ?? DEFAULT_ACTION_TIMEOUT_MS;
+    const interval = options.interval ?? DEFAULT_POLL_INTERVAL_MS;
+    if (!Number.isFinite(requested) || requested <= 0 || !Number.isFinite(interval) || interval <= 0) {
+        throw new TypeError("waitForCall timeout and interval must be positive finite numbers");
+    }
+    return host.act(verb, what, async () => {
+        const deadline = new ActionDeadline(requested, host.budgetRoom());
+        let stalled = false;
+        host.silenceActions();
+        try {
+            for (;;) {
+                if (deadline.expired())
+                    break;
+                let window;
+                try {
+                    window = await deadline.call(`${verb} reading calls`, () => read(cursor.after), () => at);
+                }
+                catch (error) {
+                    if (!(error instanceof TimeoutError) || !deadline.expired())
+                        throw error;
+                    stalled = true;
+                    break;
+                }
+                // A read that came back after the deadline does not count.
+                if (deadline.expired())
+                    break;
+                if (window.droppedThrough > cursor.after) {
+                    const lost = window.droppedThrough - cursor.after;
+                    const skippedFrom = cursor.after;
+                    const range = lost === 1 ? `seq ${window.droppedThrough}` : `seq ${skippedFrom + 1}–${window.droppedThrough}`;
+                    cursor.after = window.droppedThrough;
+                    throw new Error([
+                        `${what}: calls after ${skippedFrom === 0 ? "the start" : `the last one waitForCall returned (seq ${skippedFrom})`} ` +
+                            `were dropped from a bounded call log before they were read (${range}, ` +
+                            `${lost} ${lost === 1 ? "entry" : "entries"} of that log), so the next call cannot be told.`,
+                        "Wait for calls as they happen, or make fewer calls between waits; the next waitForCall resumes after the gap.",
+                        at,
+                    ].join("\n"));
+                }
+                const next = window.calls.find((call) => call.seq > cursor.after);
+                if (next) {
+                    cursor.after = next.seq;
+                    cursor.taken += 1;
+                    return next;
+                }
+                const pause = Math.min(interval, deadline.remaining());
+                if (pause <= 0)
+                    break;
+                await new Promise((resolve) => { runnerSetTimeout(resolve, pause); });
+            }
+        }
+        finally {
+            host.resumeActions();
+        }
+        const elapsed = deadline.elapsed();
+        // A read that stalled says the driver is not answering; asking it for
+        // recent calls would only spend more time.
+        const evidence = stalled
+            ? "The last read of its calls had not returned when the time ran out, so recent calls were not read."
+            : await recentCalls(recent, Math.min(EVIDENCE_MS, Math.floor(host.budgetRoom())));
+        const seen = cursor.taken;
+        throw new TimeoutError([
+            `${what}: no new call within ${elapsed}ms` +
+                (seen > 0 ? ` (${seen} earlier ${seen === 1 ? "call was" : "calls were"} already returned by waitForCall).` : "."),
+            evidence,
+            deadline.clampNote(),
+            at,
+        ].filter(Boolean).join("\n"));
+    });
+}
+/** The lines listing recent calls for a timeout, read within `ms`. */
+async function recentCalls(recent, ms) {
+    if (ms < 1)
+        return "Recent calls were not read: the spec's budget is spent.";
+    let handle;
+    const late = new Promise((resolve) => { handle = runnerSetTimeout(() => resolve("late"), ms); });
+    let listed;
+    try {
+        const task = Promise.resolve().then(recent);
+        task.catch(() => { });
+        listed = await Promise.race([task, late]);
+    }
+    catch {
+        // The listing explains the timeout; it never replaces it.
+        return "Recent calls could not be read.";
+    }
+    finally {
+        runnerClearTimeout(handle);
+    }
+    if (listed === "late")
+        return `Recent calls were not read: the read took longer than ${ms}ms.`;
+    const tail = listed.slice(-LISTED_CALLS);
+    return tail.length > 0
+        ? `Recent calls:\n${tail.map((call) => `  ${describeCall(call)}`).join("\n")}`
+        : "No call reached it.";
+}
+/**
+ * `resolve` reads the raw driver lazily, inside each traced call, so an app
+ * that closed since `t.app` was read fails that call, not the read.
+ */
+export function wrapNetwork(resolve, host, scope) {
+    const driver = resolve;
+    const wrapRoute = (route) => {
+        const cursor = { after: 0, taken: 0 };
+        const calls = async () => (await route.requests()).map(routeCall);
+        const after = async (seq) => {
+            const window = await route.requestsAfter(seq);
+            return { calls: window.requests.map(routeCall), droppedThrough: window.droppedThrough };
+        };
+        return {
+            get id() { return route.id; },
+            get pattern() { return route.pattern; },
+            remove: () => host.act("network.remove", route.pattern, async () => { await route.unroute(); }),
+            calls: () => host.act("network.calls", route.pattern, calls),
+            waitForCall: (options) => waitForNextCall(host, "network.waitForCall", `route ${route.pattern}`, after, calls, cursor, options),
+        };
+    };
+    return {
+        route: (pattern, handler) => host.act("network.route", describeRoute(pattern, handler), async () => {
+            const route = await driver().route(pattern, handler);
+            scope.track(route);
+            return wrapRoute(route);
+        }),
+        // Spec-scoped: the host log spans the whole run.
+        calls: () => host.act("network.calls", "", async () => (await driver().requests())
+            .filter((entry) => scope.routes.has(entry.routeId))
+            .map(routeCall)),
+    };
+}
+function describePattern(pattern) {
+    if (typeof pattern === "string")
+        return pattern;
+    if (pattern instanceof RegExp)
+        return String(pattern);
+    const url = pattern.url instanceof RegExp ? String(pattern.url) : pattern.url;
+    return pattern.method ? `${pattern.method.toUpperCase()} ${url}` : url;
+}
+function describeHandler(handler) {
+    if (handler.sequence !== undefined)
+        return `sequence of ${handler.sequence.length}`;
+    if (handler.sse !== undefined)
+        return `sse (${handler.sse.length} items)`;
+    if (handler.abort !== undefined)
+        return `abort ${String(handler.abort)}`;
+    if (handler.hang !== undefined)
+        return "hang";
+    if (handler.continue !== undefined)
+        return handler.patchJson !== undefined ? "continue + patchJson" : "continue";
+    const status = String(handler.status ?? 200);
+    return handler.delay ? `${status} after ${handler.delay}ms` : status;
+}
+function describeRoute(pattern, handler) {
+    return truncate(`${describePattern(pattern)} → ${describeHandler(handler)}`, 80);
+}
+//# sourceMappingURL=network.js.map

package/dist/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../src/network.ts"],"names":[],"mappings":"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"}