@heojeongbo/wirestage 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 heojeongbo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/LICENSES.md

@@ -0,0 +1,21 @@
+# License and distribution
+
+wirestage is distributed under the MIT license in [LICENSE](LICENSE), with
+copyright attributed to heojeongbo. Package metadata declares `MIT`.
+
+The npm tarball contains the compiled modules, the TypeScript source (for
+source maps, tests excluded), README, LICENSE and this inventory. It bundles
+no third-party code. Dependencies are installed separately and keep their own
+licenses:
+
+| Package | Kind | License |
+| --- | --- | --- |
+| @heojeongbo/log-palette | dependency | MIT |
+| @playwright/test | required peer | Apache-2.0 |
+| @connectrpc/connect | optional peer (`/connect`) | Apache-2.0 |
+| @connectrpc/connect-node | optional peer (`/connect`) | Apache-2.0 |
+| @bufbuild/protobuf | optional peer (`/connect`) | Apache-2.0 AND BSD-3-Clause |
+
+The core and the `/rest`, `/sse`, `/websocket` and `/webrtc` entries use only
+Playwright and the platform. Connect and protobuf are imported by `/connect`
+alone, so they may be absent otherwise (`pnpm package:check` proves it).

package/README.md

@@ -1,3 +1,151 @@
-# Temporary Holding Version
+# wirestage
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Record, fake and fault-inject browser wire traffic in Playwright — REST,
+Connect, gRPC-web, gRPC, SSE, WebSocket and WebRTC data channels — on one
+timeline.
+
+```sh
+pnpm add -D @heojeongbo/wirestage
+```
+
+Playwright can route HTTP and WebSockets, but a modern app talks more than
+that: server-streaming RPCs, event streams, WebRTC data channels. Tests end up
+hand-rolling gRPC-web frames, patching `RTCDataChannel` in init scripts and
+running ad-hoc local servers for streams. wirestage is those pieces, done once,
+behind one API:
+
+- **Fake** any protocol, including responses that stay open: a test-driven
+  gRPC-web stream or event stream, message by message.
+- **Record** what the page actually sent and received, decoded, on a single
+  timeline you can drain, mark and wait on.
+- **Fault-inject**: abort, delay, hold, cut a stream mid-flight, drop messages
+  on one data channel while it stays open.
+- **Drive** the real backend from the test, signed in as the page.
+
+## Quick start
+
+```ts
+import { test as base, expect } from "@playwright/test";
+import { withStage } from "@heojeongbo/wirestage/playwright";
+import { json, rest } from "@heojeongbo/wirestage/rest";
+import { webrtc } from "@heojeongbo/wirestage/webrtc";
+
+export const test = withStage(base, {
+	plugins: [rest({ baseURL: "/api" }), webrtc({ labels: ["room/cursor"] })],
+});
+
+test("the room card shows its state", async ({ page, stage }) => {
+	await stage.rest.get("/rooms/:id", (request) =>
+		json({ id: request.params["id"], state: "idle" }),
+	);
+	await page.goto("/rooms/r1");
+	await expect(page.getByText("idle")).toBeVisible();
+
+	await stage.mark("before move");
+	await page.getByRole("button", { name: "Share cursor" }).click();
+	const sent = await stage.since("before move", {
+		protocol: "webrtc",
+		endpoint: "room/cursor",
+		direction: "out",
+	});
+	expect(sent.length).toBeGreaterThan(0);
+});
+```
+
+A failing test gets the timeline attached to its report, as text and JSON,
+whenever anything is on it.
+
+## Protocols
+
+Each protocol is a plugin in its own subpath. Install only the peers of the
+ones you use.
+
+| Subpath | Plugin | Fakes | Records | Faults | Extra peers |
+| --- | --- | --- | --- | --- | --- |
+| `/rest` | `rest()` | routes with `:params`, `json`/`text`/`bytes` replies | requests and real responses | abort, delay, status | — |
+| `/connect` | `connect()` | Connect, gRPC-web: unary, server streams, whole services | decoded messages and status | fail, abort, hold, cut | `@connectrpc/connect`, `@connectrpc/connect-node`, `@bufbuild/protobuf` |
+| `/sse` | `sse()` | event streams driven from the test | events sent | end, cut | — |
+| `/websocket` | `websocket()` | a fake server, or a proxy in front of the real one | both directions | drop, close | — |
+| `/webrtc` | `webrtc()` | inject messages as the peer | every data channel message | suppress either direction | — |
+
+The `connect` plugin also builds typed clients for the real backend
+(`stage.connect.client(Service)`, cookies included) and serves stubs on a port
+of their own for clients outside the browser — native gRPC over HTTP/2
+included (`stage.connect.serve(...)`).
+
+A protocol the library does not ship is a plugin you write against the same
+contract the built-in ones use: [docs/plugins.md](docs/plugins.md).
+
+## The timeline
+
+Every plugin writes `Frame`s to the stage's timeline: protocol, direction
+(`out` left the page, `in` reached it), endpoint, payload, who produced it,
+and an id that ties the frames of one exchange together. Reads bring the
+timeline up to date first: they flush what the pages have buffered.
+
+```ts
+import type { Stage } from "@heojeongbo/wirestage";
+
+export async function lastCommand(stage: Stage) {
+	const frames = await stage.drain({ protocol: "webrtc", direction: "out" });
+	return frames.at(-1)?.payload.bytes();
+}
+```
+
+`frames`, `drain`, `mark`, `since`, `between`, `waitFor` and `report` are
+described in [docs/timeline.md](docs/timeline.md).
+
+## Without the fixture
+
+Contexts made with `browser.newContext()` attach the same way:
+
+```ts
+import type { Browser } from "@playwright/test";
+import { createStage } from "@heojeongbo/wirestage";
+import { webrtc } from "@heojeongbo/wirestage/webrtc";
+
+export async function openSession(browser: Browser) {
+	const context = await browser.newContext({ baseURL: "http://localhost:3000" });
+	const stage = createStage({ plugins: [webrtc()] });
+	// Before the first navigation, so the page hooks are in place.
+	await stage.attach(context, { baseURL: "http://localhost:3000" });
+	return { context, stage, page: await context.newPage() };
+}
+```
+
+## Documentation
+
+- [Getting started](docs/getting-started.md)
+- [The timeline](docs/timeline.md)
+- Protocols: [Connect / gRPC-web / gRPC](docs/protocols/connect.md),
+  [REST](docs/protocols/rest.md), [SSE](docs/protocols/sse.md),
+  [WebSocket](docs/protocols/websocket.md), [WebRTC](docs/protocols/webrtc.md)
+- [Writing a protocol plugin](docs/plugins.md)
+- [Architecture](docs/architecture.md) and [design patterns](docs/design-patterns.md)
+- [Testing](docs/testing.md), [performance](docs/performance.md),
+  [logging](docs/logging.md), [troubleshooting](docs/troubleshooting.md)
+
+## Compatibility
+
+- **Node 22.12 or later.** The package is ES modules. A CommonJS project loads
+  it with `require()`, which Node supports from that version; that is how
+  Playwright runs the tests of a project without `"type": "module"`.
+- **Playwright 1.50 or later** — the one required peer. The suite runs
+  against 1.60 in Chromium.
+- **TypeScript 5.0 or later**, with `moduleResolution` set to `node16`,
+  `nodenext` or `bundler` (the entry points are published through `exports`),
+  and `@types/node`, as in any Playwright project.
+- Live streams (server streams, SSE) redirect the page's request to a local
+  server; see [troubleshooting](docs/troubleshooting.md) for https pages.
+
+## Developing
+
+Everything runs in the devcontainer, which is the Playwright image for the
+pinned version: `pnpm check` and `pnpm check:browser`
+([docs/testing.md](docs/testing.md)). Its `node_modules` is a volume, so the
+host has none: run `pnpm install` on the host as well if you want editor
+type-checking and the git hooks there.
+
+## License
+
+MIT

package/dist/app/playwright/index.d.ts

@@ -0,0 +1,3 @@
+export type { ReportMode, StageFixtureArgs, StageFixtureOptions, StageTestInfo, } from "./lib/fixture.js";
+export { createStageFixture, withStage } from "./lib/fixture.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/app/playwright/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/app/playwright/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,GACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/app/playwright/index.js

@@ -0,0 +1,2 @@
+export { createStageFixture, withStage } from "./lib/fixture.js";
+//# sourceMappingURL=index.js.map

package/dist/app/playwright/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/app/playwright/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/app/playwright/lib/fixture.d.ts

@@ -0,0 +1,61 @@
+import type { TestType } from "@playwright/test";
+import type { AnyWirePlugin } from "../../../entities/plugin/index.js";
+import type { ContextPort } from "../../../shared/api/playwright/index.js";
+import { type LogThreshold } from "../../../shared/lib/logger/index.js";
+import { type Stage, type StageOptions } from "../../../widgets/stage/index.js";
+/** When the timeline is attached to the test report. */
+export type ReportMode = "on-failure" | "always" | "never";
+export interface StageFixtureOptions<Plugins extends readonly AnyWirePlugin[]> extends Omit<StageOptions<Plugins>, "baseURL" | "clock"> {
+    /**
+     * Default `on-failure`. `WIRESTAGE_REPORT` overrides it. An empty timeline
+     * is never attached.
+     */
+    readonly report?: ReportMode;
+    /**
+     * Frames a report holds, counting back from the newest. Default 1,000: a
+     * report is read from its end, and one that grows with the test would
+     * attach tens of megabytes to a long run.
+     */
+    readonly reportLimit?: number;
+    /** Default `warn`. `WIRESTAGE_LOG` overrides it. */
+    readonly log?: LogThreshold;
+    /**
+     * Attach the test's `context` before the body runs. Default true. Turn it
+     * off when tests open their own contexts (`browser.newContext()`, two users
+     * at once): the fixture then never asks Playwright for `context`, so no
+     * unused one is created, and the test attaches what it opens.
+     */
+    readonly attach?: boolean;
+}
+export interface StageFixtureArgs {
+    /** Absent when the fixture does not attach (`attach: false`). */
+    readonly context?: ContextPort;
+    readonly baseURL: string | undefined;
+}
+/** The part of Playwright's TestInfo the fixture uses. */
+export interface StageTestInfo {
+    readonly status?: string;
+    readonly expectedStatus: string;
+    attach(name: string, options: {
+        readonly body: string;
+        readonly contentType: string;
+    }): Promise<void>;
+}
+type Environment = Readonly<Record<string, string | undefined>>;
+/**
+ * The `stage` fixture as a plain function, so it can be tested without the
+ * Playwright runner: one stage per test, attached to the test's context
+ * before the test body runs, reported on failure, disposed afterwards.
+ */
+export declare function createStageFixture<const Plugins extends readonly AnyWirePlugin[]>(options: StageFixtureOptions<Plugins>, env?: Environment): (args: StageFixtureArgs, use: (stage: Stage<Plugins>) => Promise<void>, testInfo: StageTestInfo) => Promise<void>;
+/**
+ * Extend a Playwright `test` with a `stage` fixture:
+ *
+ *     export const test = withStage(base, { plugins: [webrtc(), connect()] });
+ *     test("...", async ({ page, stage }) => { ... });
+ */
+export declare function withStage<Args extends object, Workers extends object, const Plugins extends readonly AnyWirePlugin[]>(test: TestType<Args, Workers>, options: StageFixtureOptions<Plugins>): TestType<Args & {
+    stage: Stage<Plugins>;
+}, Workers>;
+export {};
+//# sourceMappingURL=fixture.d.ts.map

package/dist/app/playwright/lib/fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.d.ts","sourceRoot":"","sources":["../../../../src/app/playwright/lib/fixture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAEN,KAAK,YAAY,EAGjB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAEN,KAAK,KAAK,EACV,KAAK,YAAY,EACjB,MAAM,iCAAiC,CAAC;AAEzC,wDAAwD;AACxD,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,mBAAmB,CAAC,OAAO,SAAS,SAAS,aAAa,EAAE,CAC5E,SAAQ,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;IACxD;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,oDAAoD;IACpD,QAAQ,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAChC,iEAAiE;IACjE,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,MAAM,CACL,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAC9D,OAAO,CAAC,IAAI,CAAC,CAAC;CACjB;AAED,KAAK,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAqChE;;;;GAIG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,CAAC,OAAO,SAAS,SAAS,aAAa,EAAE,EAE9C,OAAO,EAAE,mBAAmB,CAAC,OAAO,CAAC,EACrC,GAAG,GAAE,WAAyB,GAC5B,CACF,IAAI,EAAE,gBAAgB,EACtB,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAC7C,QAAQ,EAAE,aAAa,KACnB,OAAO,CAAC,IAAI,CAAC,CAiEjB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACxB,IAAI,SAAS,MAAM,EACnB,OAAO,SAAS,MAAM,EACtB,KAAK,CAAC,OAAO,SAAS,SAAS,aAAa,EAAE,EAE9C,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,mBAAmB,CAAC,OAAO,CAAC,GACnC,QAAQ,CAAC,IAAI,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;CAAE,EAAE,OAAO,CAAC,CAUrD"}

package/dist/app/playwright/lib/fixture.js

@@ -0,0 +1,110 @@
+import { createScopedLogger, parseLogThreshold, setLogThreshold, } from "../../../shared/lib/logger/index.js";
+import { createStage, } from "../../../widgets/stage/index.js";
+const REPORT_MODES = ["on-failure", "always", "never"];
+/**
+ * The environment's say, read once when the fixture is made. A value it
+ * cannot use is ignored with one warning: a typo in CI config must neither
+ * turn reports off silently nor fail every test, and saying so once is
+ * enough.
+ */
+function readEnvironment(env) {
+    const warn = (name, value, allowed) => createScopedLogger("Fixture").warn(`ignoring an unknown ${name}`, {
+        value,
+        allowed,
+    });
+    const wantedReport = env["WIRESTAGE_REPORT"]?.trim().toLowerCase();
+    const report = REPORT_MODES.find((mode) => mode === wantedReport);
+    if (wantedReport !== undefined && report === undefined)
+        warn("WIRESTAGE_REPORT", wantedReport, REPORT_MODES);
+    const wantedLog = env["WIRESTAGE_LOG"];
+    const log = parseLogThreshold(wantedLog);
+    if (wantedLog !== undefined && log === undefined)
+        warn("WIRESTAGE_LOG", wantedLog, [
+            "debug",
+            "log",
+            "info",
+            "warn",
+            "error",
+            "silent",
+        ]);
+    return { report, log };
+}
+/**
+ * The `stage` fixture as a plain function, so it can be tested without the
+ * Playwright runner: one stage per test, attached to the test's context
+ * before the test body runs, reported on failure, disposed afterwards.
+ */
+export function createStageFixture(options, env = process.env) {
+    const { report, reportLimit, log, attach = true, ...stageOptions } = options;
+    const fromEnv = readEnvironment(env);
+    const threshold = fromEnv.log ?? log;
+    if (threshold !== undefined)
+        setLogThreshold(threshold);
+    const mode = fromEnv.report ?? report ?? "on-failure";
+    const fixtureLog = createScopedLogger("Fixture");
+    /** Attach the timeline to the test's report, when there is one to read. */
+    const attachReport = async (stage, testInfo) => {
+        const failed = testInfo.status !== testInfo.expectedStatus;
+        if (mode === "never" || (mode === "on-failure" && !failed))
+            return;
+        // What the pages still hold is often the frame the failure is about.
+        await stage.sync();
+        // Nothing on the timeline is nothing to read: no empty attachment.
+        if (stage.timeline.size === 0 && stage.timeline.evicted === 0)
+            return;
+        const { snapshot, text } = stage.report(undefined, reportLimit === undefined ? {} : { limit: reportLimit });
+        await testInfo.attach("wirestage-timeline.txt", {
+            body: text,
+            contentType: "text/plain",
+        });
+        await testInfo.attach("wirestage-timeline.json", {
+            body: JSON.stringify(snapshot, null, 2),
+            contentType: "application/json",
+        });
+    };
+    const run = async (context, baseURL, use, testInfo) => {
+        const stage = createStage({
+            ...stageOptions,
+            ...(baseURL === undefined ? {} : { baseURL }),
+        });
+        try {
+            if (context !== undefined)
+                await stage.attach(context);
+            await use(stage);
+        }
+        finally {
+            try {
+                await attachReport(stage, testInfo);
+            }
+            catch (error) {
+                // The report is a courtesy; failing to write one must not hide
+                // the test's own result, nor keep the stage from being disposed.
+                fixtureLog.warn("could not attach the timeline", {}, error);
+            }
+            finally {
+                await stage.dispose();
+            }
+        }
+    };
+    // Playwright reads a fixture's dependencies off its SOURCE, so each mode
+    // is its own literal: naming `context` is what makes Playwright create one.
+    return attach
+        ? async ({ context, baseURL }, use, testInfo) => run(context, baseURL, use, testInfo)
+        : async ({ baseURL }, use, testInfo) => run(undefined, baseURL, use, testInfo);
+}
+/**
+ * Extend a Playwright `test` with a `stage` fixture:
+ *
+ *     export const test = withStage(base, { plugins: [webrtc(), connect()] });
+ *     test("...", async ({ page, stage }) => { ... });
+ */
+export function withStage(test, options) {
+    // Playwright reads a fixture's dependencies off the SOURCE of its first
+    // parameter, so the fixture must be passed as written — with its
+    // `({ context, baseURL }, use, testInfo)` destructuring — not wrapped. The
+    // cast is only for the generic `extend` signature, which TypeScript cannot
+    // resolve against an arbitrary `Args`.
+    const extend = test.extend.bind(test);
+    return extend({ stage: createStageFixture(options) });
+}
+//# sourceMappingURL=fixture.js.map

package/dist/app/playwright/lib/fixture.js.map

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

package/dist/connect.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @heojeongbo/wirestage/connect — Connect, gRPC-web and gRPC.
+ * Needs the optional peers @connectrpc/connect, @connectrpc/connect-node and
+ * @bufbuild/protobuf.
+ */
+export * from "./features/connect/index.js";
+//# sourceMappingURL=connect.d.ts.map

package/dist/connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../src/connect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,6BAA6B,CAAC"}

package/dist/connect.js

@@ -0,0 +1,7 @@
+/**
+ * @heojeongbo/wirestage/connect — Connect, gRPC-web and gRPC.
+ * Needs the optional peers @connectrpc/connect, @connectrpc/connect-node and
+ * @bufbuild/protobuf.
+ */
+export * from "./features/connect/index.js";
+//# sourceMappingURL=connect.js.map

package/dist/connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../src/connect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,6BAA6B,CAAC"}

package/dist/entities/frame/@x/plugin.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The frame types the plugin contract is written in terms of.
+ *
+ * FSD's cross-import notation: `entities/plugin` may import this file and
+ * nothing else from `entities/frame`. It keeps the dependency between the two
+ * entities explicit and one-way — the frame model knows nothing of plugins.
+ */
+export type { Frame, FrameFilter, Timeline } from "../model/frame.js";
+//# sourceMappingURL=plugin.d.ts.map

package/dist/entities/frame/@x/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/entities/frame/@x/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/entities/frame/@x/plugin.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin.js.map

package/dist/entities/frame/@x/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../../src/entities/frame/@x/plugin.ts"],"names":[],"mappings":""}

package/dist/entities/frame/index.d.ts

@@ -0,0 +1,6 @@
+export { compileFilter } from "./lib/filter.js";
+export { createPayload } from "./lib/payload.js";
+export type { TimelineOptions } from "./lib/timeline.js";
+export { createTimeline } from "./lib/timeline.js";
+export type { Direction, Frame, FrameFilter, FrameInit, FrameKind, FrameSource, Payload, PayloadInput, SnapshotFrame, SnapshotOptions, Timeline, TimelineCursor, TimelineSnapshot, } from "./model/frame.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/entities/frame/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/entities/frame/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EACX,SAAS,EACT,KAAK,EACL,WAAW,EACX,SAAS,EACT,SAAS,EACT,WAAW,EACX,OAAO,EACP,YAAY,EACZ,aAAa,EACb,eAAe,EACf,QAAQ,EACR,cAAc,EACd,gBAAgB,GAChB,MAAM,kBAAkB,CAAC"}

package/dist/entities/frame/index.js

@@ -0,0 +1,4 @@
+export { compileFilter } from "./lib/filter.js";
+export { createPayload } from "./lib/payload.js";
+export { createTimeline } from "./lib/timeline.js";
+//# sourceMappingURL=index.js.map

package/dist/entities/frame/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/entities/frame/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/entities/frame/lib/filter.d.ts

@@ -0,0 +1,8 @@
+import type { Frame, FrameFilter } from "../model/frame.js";
+/**
+ * Compile a filter into one predicate. Queries run over every frame of a long
+ * test, often in a polling loop, so the per-frame work is a handful of
+ * comparisons and the `where` callback runs only after the cheap fields pass.
+ */
+export declare function compileFilter(filter: FrameFilter | undefined): (frame: Frame) => boolean;
+//# sourceMappingURL=filter.d.ts.map

package/dist/entities/frame/lib/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../../src/entities/frame/lib/filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAI5D;;;;GAIG;AACH,wBAAgB,aAAa,CAC5B,MAAM,EAAE,WAAW,GAAG,SAAS,GAC7B,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CA8C3B"}

package/dist/entities/frame/lib/filter.js

@@ -0,0 +1,62 @@
+const ALWAYS = () => true;
+/**
+ * Compile a filter into one predicate. Queries run over every frame of a long
+ * test, often in a polling loop, so the per-frame work is a handful of
+ * comparisons and the `where` callback runs only after the cheap fields pass.
+ */
+export function compileFilter(filter) {
+    if (filter === undefined)
+        return ALWAYS;
+    const checks = [];
+    const { protocol, kind, endpoint, where } = filter;
+    if (protocol !== undefined) {
+        if (typeof protocol === "string")
+            checks.push((f) => f.protocol === protocol);
+        else {
+            const set = new Set(protocol);
+            checks.push((f) => set.has(f.protocol));
+        }
+    }
+    if (kind !== undefined) {
+        if (typeof kind === "string")
+            checks.push((f) => f.kind === kind);
+        else {
+            const set = new Set(kind);
+            checks.push((f) => set.has(f.kind));
+        }
+    }
+    for (const key of [
+        "direction",
+        "source",
+        "page",
+        "context",
+        "correlation",
+    ]) {
+        const expected = filter[key];
+        if (expected !== undefined)
+            checks.push((f) => f[key] === expected);
+    }
+    if (endpoint !== undefined) {
+        if (typeof endpoint === "string")
+            checks.push((f) => f.endpoint === endpoint);
+        else
+            checks.push((f) => {
+                endpoint.lastIndex = 0;
+                return endpoint.test(f.endpoint);
+            });
+    }
+    const after = filter.after;
+    if (after !== undefined)
+        checks.push((f) => f.seq > after);
+    if (where !== undefined)
+        checks.push(where);
+    if (checks.length === 0)
+        return ALWAYS;
+    return (frame) => {
+        for (const check of checks)
+            if (!check(frame))
+                return false;
+        return true;
+    };
+}
+//# sourceMappingURL=filter.js.map

package/dist/entities/frame/lib/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../../src/entities/frame/lib/filter.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC;AAE1B;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC5B,MAA+B;IAE/B,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACxC,MAAM,MAAM,GAAkC,EAAE,CAAC;IACjD,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IACnD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC5B,IAAI,OAAO,QAAQ,KAAK,QAAQ;YAC/B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;aACxC,CAAC;YACL,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzC,CAAC;IACF,CAAC;IACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACxB,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;aAC7D,CAAC;YACL,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACrC,CAAC;IACF,CAAC;IACD,KAAK,MAAM,GAAG,IAAI;QACjB,WAAW;QACX,QAAQ;QACR,MAAM;QACN,SAAS;QACT,aAAa;KACJ,EAAE,CAAC;QACZ,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,QAAQ,KAAK,SAAS;YAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC5B,IAAI,OAAO,QAAQ,KAAK,QAAQ;YAC/B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;;YAE5C,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;gBACjB,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC;gBACvB,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YAClC,CAAC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC;IAC3D,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IACvC,OAAO,CAAC,KAAK,EAAE,EAAE;QAChB,KAAK,MAAM,KAAK,IAAI,MAAM;YAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAC;QAC5D,OAAO,IAAI,CAAC;IACb,CAAC,CAAC;AACH,CAAC"}

package/dist/entities/frame/lib/payload.d.ts

@@ -0,0 +1,8 @@
+import type { Payload, PayloadInput } from "../model/frame.js";
+/**
+ * A payload that converts lazily and remembers every conversion. Frames are
+ * written far more often than read, so nothing is encoded or decoded until a
+ * test asks, and asking twice costs once.
+ */
+export declare function createPayload(input: PayloadInput | undefined): Payload;
+//# sourceMappingURL=payload.d.ts.map

package/dist/entities/frame/lib/payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../../../src/entities/frame/lib/payload.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAI/D;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,OAAO,CA+BtE"}

package/dist/entities/frame/lib/payload.js

@@ -0,0 +1,42 @@
+import { toBytes, utf8 } from "../../../shared/lib/bytes/index.js";
+const EMPTY = new Uint8Array(0);
+/**
+ * A payload that converts lazily and remembers every conversion. Frames are
+ * written far more often than read, so nothing is encoded or decoded until a
+ * test asks, and asking twice costs once.
+ */
+export function createPayload(input) {
+    let bytes = input instanceof Uint8Array ? input : undefined;
+    let text = typeof input === "string" ? input : undefined;
+    let decoded;
+    const getBytes = () => {
+        if (bytes !== undefined)
+            return bytes;
+        if (typeof input === "function")
+            bytes = input();
+        else if (text !== undefined)
+            bytes = toBytes(text);
+        else
+            bytes = EMPTY;
+        return bytes;
+    };
+    const getText = () => {
+        text ??= utf8(getBytes());
+        return text;
+    };
+    return {
+        empty: input === undefined,
+        bytes: getBytes,
+        text: getText,
+        json: () => JSON.parse(getText()),
+        decode(decoder) {
+            decoded ??= new WeakMap();
+            if (decoded.has(decoder))
+                return decoded.get(decoder);
+            const value = decoder(getBytes());
+            decoded.set(decoder, value);
+            return value;
+        },
+    };
+}
+//# sourceMappingURL=payload.js.map

package/dist/entities/frame/lib/payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../../../src/entities/frame/lib/payload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAGnE,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;AAEhC;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAA+B;IAC5D,IAAI,KAAK,GACR,KAAK,YAAY,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACjD,IAAI,IAAI,GAAuB,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,IAAI,OAAqE,CAAC;IAE1E,MAAM,QAAQ,GAAG,GAAe,EAAE;QACjC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACtC,IAAI,OAAO,KAAK,KAAK,UAAU;YAAE,KAAK,GAAG,KAAK,EAAE,CAAC;aAC5C,IAAI,IAAI,KAAK,SAAS;YAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;;YAC9C,KAAK,GAAG,KAAK,CAAC;QACnB,OAAO,KAAK,CAAC;IACd,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,GAAW,EAAE;QAC5B,IAAI,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACb,CAAC,CAAC;IAEF,OAAO;QACN,KAAK,EAAE,KAAK,KAAK,SAAS;QAC1B,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,GAAM,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAM;QACzC,MAAM,CAAI,OAAiC;YAC1C,OAAO,KAAK,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;gBAAE,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAM,CAAC;YAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC5B,OAAO,KAAK,CAAC;QACd,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/entities/frame/lib/snapshot.d.ts

@@ -0,0 +1,15 @@
+import type { Frame, SnapshotOptions, TimelineSnapshot } from "../model/frame.js";
+/**
+ * A JSON-safe copy of `frames`, with payloads cut at `maxBytes` and, given a
+ * `limit`, only the newest frames kept: a report is read from its end.
+ */
+export declare function snapshotFrames(frames: readonly Frame[], evicted: number, options?: SnapshotOptions): TimelineSnapshot;
+/**
+ * One line per frame: `#12  +3.2ms  connect  out request  pkg.Svc/Method  42B`.
+ * Times are relative to the first frame listed, which is what a reader of a
+ * failure report compares.
+ */
+export declare function formatFrames(frames: readonly Frame[], options?: {
+    readonly limit?: number;
+}): string;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/entities/frame/lib/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../../src/entities/frame/lib/snapshot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,KAAK,EAEL,eAAe,EACf,gBAAgB,EAChB,MAAM,mBAAmB,CAAC;AAE3B;;;GAGG;AACH,wBAAgB,cAAc,CAC7B,MAAM,EAAE,SAAS,KAAK,EAAE,EACxB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,eAAoB,GAC3B,gBAAgB,CAqClB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC3B,MAAM,EAAE,SAAS,KAAK,EAAE,EACxB,OAAO,GAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,MAAM,CAgBR"}