@heojeongbo/wirestage 0.0.0-stage → 0.1.1

package/dist/entities/plugin/model/http.d.ts

@@ -0,0 +1,135 @@
+import type { UrlMatcher } from "../../../shared/lib/match/index.js";
+import type { ResponseStream } from "./stream.js";
+/**
+ * A request a rule is deciding about, read-only and decoded on demand.
+ *
+ * One per request: every rule the request reaches is given this same object,
+ * so a plugin may key what it knows about a request on it (a `WeakMap`), and
+ * the frames different rules record for one request share one `correlation`.
+ */
+export interface HttpRequestView {
+    /** Links every frame of this exchange. */
+    readonly correlation: string;
+    readonly method: string;
+    readonly url: URL;
+    /** Lower-cased names. */
+    readonly headers: Readonly<Record<string, string>>;
+    /** The page that sent it; undefined for service-worker requests. */
+    readonly page: string | undefined;
+    readonly context: string;
+    readonly resourceType: string;
+    body(): Uint8Array;
+    text(): string;
+    json<T = unknown>(): T;
+}
+/** Playwright's `route.abort` error codes. */
+export type AbortErrorCode = "aborted" | "accessdenied" | "addressunreachable" | "blockedbyclient" | "blockedbyresponse" | "connectionaborted" | "connectionclosed" | "connectionfailed" | "connectionrefused" | "connectionreset" | "internetdisconnected" | "namenotresolved" | "timedout" | "failed";
+/**
+ * What a rule decided. A closed union: the router carries each member out
+ * through a table keyed by `type`, so a new outcome does not compile until
+ * the router knows what to do with it.
+ */
+export type HttpOutcome = 
+/**
+ * Answer with a complete response. A header may carry several values
+ * separated by a newline: `set-cookie` is sent as a header line each,
+ * any other header as one value, `, `-separated. A header Chromium
+ * would refuse — a name that is not a token, a CR or NUL in a value — is
+ * the rule's error.
+ */
+{
+    readonly type: "fulfill";
+    readonly status?: number;
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly body?: Uint8Array | string;
+}
+/**
+ * Answer with a response that stays open (server streams, SSE): `open`
+ * gets the stream to write. The request is redirected to the stage's
+ * local stream server, which `route.fulfill` cannot stand in for because
+ * it takes the whole body at once. An `open` that throws is the rule's
+ * error, as a throwing `handle` is: the page gets the 500 while nothing
+ * has gone out, and a cut connection after.
+ */
+ | {
+    readonly type: "stream";
+    open(stream: ResponseStream): void | Promise<void>;
+}
+/**
+ * Send to the network, optionally rewritten. Lower rules are skipped.
+ * `url` may be relative to the request's, and keeps its scheme:
+ * Playwright rewrites a URL within its scheme only.
+ */
+ | {
+    readonly type: "continue";
+    readonly url?: string;
+    readonly method?: string;
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly body?: Uint8Array | string;
+}
+/** Let the next matching rule (or the network) decide. */
+ | {
+    readonly type: "fallback";
+}
+/** Fail the request at the network level. */
+ | {
+    readonly type: "abort";
+    readonly error?: AbortErrorCode;
+};
+/** The network's answer to a request a rule passed through. */
+export interface PassthroughResponse {
+    readonly status: number;
+    readonly headers: Readonly<Record<string, string>>;
+    /** Undefined when the browser did not keep the body (redirects, some errors). */
+    readonly body: Uint8Array | undefined;
+}
+export interface HttpRule {
+    /** The `protocol` of the frames this rule records. */
+    readonly protocol: string;
+    /** Names the rule in logs and diagnostics. */
+    readonly label: string;
+    readonly url: UrlMatcher;
+    /** Upper-case HTTP methods. Any method when omitted. */
+    readonly method?: string | readonly string[];
+    /** Stop matching after this many handled requests. */
+    readonly times?: number;
+    /** A last, request-aware condition; false falls back to the next rule. */
+    readonly match?: (request: HttpRequestView) => boolean;
+    /**
+     * Record the raw request and how it ended as frames. Default true. A plugin
+     * that records decoded frames of its own (Connect) turns this off. A
+     * request several recording rules of one protocol see is recorded once.
+     */
+    readonly record?: boolean;
+    /** The frame endpoint for a request. Defaults to the URL path. */
+    readonly endpoint?: (request: HttpRequestView) => string;
+    handle(request: HttpRequestView): HttpOutcome | Promise<HttpOutcome>;
+    /**
+     * Called with the network's response to a request this rule passed on
+     * (`continue` or `fallback`). Not called when another rule answered it:
+     * that response is a stub's, not the network's.
+     */
+    readonly onPassthroughResponse?: (response: PassthroughResponse, request: HttpRequestView) => void;
+    /**
+     * Called when a request this rule passed on failed at the network level,
+     * with the browser's error text (`net::ERR_CONNECTION_RESET`, ...).
+     */
+    readonly onPassthroughFailure?: (error: string | undefined, request: HttpRequestView) => void;
+}
+export interface HttpRuleHandle {
+    /** Requests this rule handled (matched and decided), not merely saw. */
+    readonly hits: number;
+    readonly active: boolean;
+    /** Stop matching, in every attached context. */
+    remove(): Promise<void>;
+}
+/**
+ * Where plugins put HTTP rules. Rules apply to every attached context, present
+ * and future. Later rules win, like Playwright routes and MSW's `use()`, so a
+ * test can override a suite-wide stub for one case; a rule that answers
+ * `fallback` hands the request to the next one down.
+ */
+export interface HttpRouter {
+    add(rule: HttpRule): Promise<HttpRuleHandle>;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/entities/plugin/model/http.d.ts.map

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

package/dist/entities/plugin/model/http.js

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

package/dist/entities/plugin/model/http.js.map

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

package/dist/entities/plugin/model/page.d.ts

@@ -0,0 +1,100 @@
+import type { PagePort } from "../../../shared/api/playwright/index.js";
+/** One thing an in-page module observed, on its way to the timeline. */
+export interface PageEntry {
+    /** The module's own discriminator: `out`, `in`, `open`, ... */
+    readonly type: string;
+    /** Epoch milliseconds, by the page's clock. */
+    readonly at: number;
+    /** A binary payload, base64. */
+    readonly data?: string;
+    /** A text payload. */
+    readonly text?: string;
+    readonly meta?: Readonly<Record<string, unknown>>;
+}
+/** What the page runtime hands an installer, inside the page. */
+export interface PageModuleEnv<State = unknown, Config = unknown> {
+    readonly window: Window & typeof globalThis;
+    readonly config: Config;
+    /**
+     * Queue an entry. Entries are batched and flushed to Node: a document
+     * that navigates sends what it holds on `beforeunload`, one that closes
+     * (or an iframe removed) on `pagehide`. What it emits after that, on its
+     * way out, can be lost.
+     */
+    emit(entry: PageEntry): void;
+    /** The page's epoch-millisecond clock. */
+    now(): number;
+    /** Bytes to base64. */
+    encode(bytes: Uint8Array): string;
+    /** Base64 to bytes, in a fresh ArrayBuffer of exactly that size. */
+    decode(text: string): Uint8Array;
+    /** Answer a command the test sends with `PageHost.command`. */
+    onCommand(op: string, handler: (args: never) => unknown): void;
+    /**
+     * Receive the module's state: shortly after load (it comes from Node, so
+     * the document's first script may run before it), and on every change.
+     * One that throws does not keep the state from the others: it is logged
+     * in Node, or fails the `refresh()` that sent the state.
+     */
+    onState(handler: (state: State) => void): void;
+    /**
+     * Undo what `install` did to the page: put back what was wrapped. Runs
+     * when the stage detaches, so a document that outlives the stage is left
+     * as the stage found it — and in a document the detach did not reach, as
+     * soon as the runtime finds the binding gone. One that throws does not
+     * stop the others, and is logged in Node while the binding lasts.
+     */
+    onDetach(handler: () => void): void;
+}
+/**
+ * Runs INSIDE the page, so it is serialized with `Function.prototype.toString`.
+ * It must be self-contained — no imports, no closure over module scope — and
+ * declared with `function`, since an object-method body does not serialize to
+ * a valid expression. `register` refuses one whose source is not a function
+ * expression: a method, a bound or a native function.
+ */
+export type PageInstaller<State = unknown, Config = unknown> = (env: PageModuleEnv<State, Config>) => void;
+export interface PageSource {
+    readonly page: string;
+    readonly context: string;
+}
+export interface PageModule<State = unknown, Config = unknown> {
+    /** Unique per stage; the key commands and entries are routed by. */
+    readonly id: string;
+    readonly install: PageInstaller<State, Config>;
+    /** JSON-serializable; fixed for the life of the attachment. */
+    readonly config: Config;
+    /** The state a freshly loaded page should start with. JSON-serializable. */
+    state(): State;
+    /** Entries flushed from a page, in emission order. */
+    receive(entries: readonly PageEntry[], source: PageSource): void;
+}
+/**
+ * Where plugins put code that runs in every page. Modules register at setup;
+ * the host injects them all as one init script per attached context, with one
+ * binding back to Node.
+ */
+export interface PageHost {
+    /**
+     * Add a module to the init script. Throws `INVALID_ARGUMENT` for an id
+     * already taken or an installer that does not serialize to a function
+     * expression, and `INVALID_STATE` once the stage has been attached.
+     */
+    register<State, Config>(module: PageModule<State, Config>): void;
+    /**
+     * Run a module's command handler in every frame of every open page (or of
+     * one page, by id) and return each frame's answer. Frames that are going
+     * away are skipped; a handler that throws rejects the call.
+     */
+    command(module: string, op: string, args?: unknown, options?: {
+        readonly page?: string;
+    }): Promise<unknown[]>;
+    /**
+     * Send the module's current `state()` to every frame of every open page.
+     * Documents loaded later ask for it when their runtime starts.
+     */
+    refresh(module: string): Promise<void>;
+    /** The id frames use for `page`. */
+    pageId(page: PagePort): string;
+}
+//# sourceMappingURL=page.d.ts.map

package/dist/entities/plugin/model/page.d.ts.map

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

package/dist/entities/plugin/model/page.js

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

package/dist/entities/plugin/model/page.js.map

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

package/dist/entities/plugin/model/plugin.d.ts

@@ -0,0 +1,83 @@
+import type { Clock } from "../../../shared/lib/clock/index.js";
+import type { LogScope, ScopedLogger } from "../../../shared/lib/logger/index.js";
+import type { Frame, FrameFilter, Timeline } from "../../frame/@x/plugin.js";
+import type { Attachment } from "./attachment.js";
+import type { HttpRouter } from "./http.js";
+import type { PageHost } from "./page.js";
+import type { SocketRouter } from "./socket.js";
+export interface WaitForOptions {
+    /** Frames to wait for. Default 1. */
+    readonly count?: number;
+    /** Milliseconds. Default 5000. */
+    readonly timeout?: number;
+    /** Milliseconds between polls of the page buffers. Default 25. */
+    readonly interval?: number;
+}
+/**
+ * Everything a plugin may use. A plugin never drives the browser itself:
+ * routing and page hooks go through these services, built and owned by the
+ * stage, and that is the seam that lets each plugin be unit-tested against
+ * fakes and lets several plugins share one browser context without stepping
+ * on each other.
+ */
+export interface PluginContext {
+    /**
+     * The name the plugin is set up under: its own, or the one `named()` gave
+     * it. A plugin records its frames with this as their `protocol` (and
+     * names its page modules by it), so two instances keep their traffic
+     * apart.
+     */
+    readonly name: string;
+    readonly timeline: Timeline;
+    readonly clock: Clock;
+    /** Scoped to the plugin's declared scope. */
+    readonly log: ScopedLogger;
+    /** HTTP: fetch, XHR, EventSource, and anything else a route can see. */
+    readonly http: HttpRouter;
+    /** WebSockets. */
+    readonly sockets: SocketRouter;
+    /** Code that runs inside every page, for what no route can see. */
+    readonly pages: PageHost;
+    readonly baseURL: string | undefined;
+    attachments(): readonly Attachment[];
+    /** Flush every page buffer into the timeline. Call before reading frames. */
+    sync(): Promise<void>;
+    waitFor(filter: FrameFilter, options?: WaitForOptions): Promise<Frame[]>;
+    /**
+     * Build on another plugin: set it up inside this one and get its API. A
+     * protocol layered on others (GraphQL over HTTP and WebSocket, say) is
+     * written in terms of theirs instead of re-deriving them. The stage runs
+     * the inner plugin's hooks with the outer's; it is not mounted on the
+     * stage. Wrap it in `named()` to keep its frames apart from another
+     * instance's.
+     */
+    use<Api>(plugin: WirePlugin<string, Api>): Api;
+}
+export interface PluginRuntime<Api> {
+    /** Mounted on the stage under the plugin's name. */
+    readonly api: Api;
+    /** A context was attached. Page modules and HTTP rules are already in place. */
+    attach?(attachment: Attachment): void | Promise<void>;
+    /** A context is being detached. */
+    detach?(attachment: Attachment): void | Promise<void>;
+    /** The stage is being disposed; release servers and timers. */
+    dispose?(): void | Promise<void>;
+}
+/**
+ * A protocol, as the stage sees it. The stage knows nothing about any
+ * protocol in particular: REST, Connect, WebRTC and the rest are all plugins,
+ * and a new protocol is a new plugin, not a change to the stage.
+ */
+export interface WirePlugin<Name extends string = string, Api = unknown> {
+    /** The key its API is mounted under: `stage.<name>`. */
+    readonly name: Name;
+    /** The badge on the plugin's log lines; eight characters fit the column. */
+    readonly scope?: LogScope;
+    setup(context: PluginContext): PluginRuntime<Api>;
+}
+export type AnyWirePlugin = WirePlugin<string, unknown>;
+/** `{ webrtc: WebRtcApi, connect: ConnectApi }` from `[webrtc(), connect()]`. */
+export type PluginApis<Plugins extends readonly AnyWirePlugin[]> = {
+    readonly [Plugin in Plugins[number] as Plugin["name"]]: Plugin extends WirePlugin<string, infer Api> ? Api : never;
+};
+//# sourceMappingURL=plugin.d.ts.map

package/dist/entities/plugin/model/plugin.d.ts.map

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

package/dist/entities/plugin/model/plugin.js

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

package/dist/entities/plugin/model/plugin.js.map

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

package/dist/entities/plugin/model/socket.d.ts

@@ -0,0 +1,107 @@
+import type { UrlMatcher } from "../../../shared/lib/match/index.js";
+/** One end of a routed WebSocket: the page's, or the real server's. */
+export interface SocketPeer {
+    /** Deliver a message to this end. */
+    send(data: string | Uint8Array): void;
+    /**
+     * Close this end. The page's end takes any code and reason, as a server
+     * may close with any code. The server's end is closed by the browser,
+     * which sends only 1000 and 3000-4999, no reason without a code, and no
+     * reason over 123 bytes of UTF-8: another code goes out as a normal
+     * closure, 1000, and the reason is cut to 123 bytes, so the close still
+     * happens.
+     */
+    close(options?: {
+        readonly code?: number;
+        readonly reason?: string;
+    }): Promise<void>;
+    /**
+     * Messages this end sends. One handler; a later call replaces it. Until
+     * one is set, what this end sends is dropped, not passed on to the other.
+     * A handler that throws, or rejects, fails the rule (see
+     * `SocketRule.open`).
+     */
+    onMessage(handler: (data: string | Uint8Array) => void): void;
+    /**
+     * This end closed, by its own doing or through `close()` — and a close
+     * the page starts is reported again once `close()` completes it, so a
+     * handler must expect to run twice. Setting one turns off the automatic
+     * forwarding of a close to the other end: the page's socket then hangs in
+     * CLOSING until the handler closes the page's end itself. A handler that
+     * throws, or rejects, fails the rule.
+     */
+    onClose(handler: (code: number | undefined, reason: string | undefined) => void): void;
+}
+/** A WebSocket a page opened, as the rule that takes it sees it. */
+export interface SocketView {
+    /** Links every frame of this connection. */
+    readonly correlation: string;
+    readonly url: URL;
+    readonly context: string;
+    /** The page's end. */
+    readonly page: SocketPeer;
+    /**
+     * Open the real server's end and return it. No message is forwarded for
+     * you: a rule that wants a proxy wires the two ends together itself, and
+     * a direction it does not wire is dropped — a rule that sets only the
+     * page's `onMessage` never lets the server's messages reach the page. A
+     * close is passed on to the other end unless the end that closed has an
+     * `onClose` handler.
+     */
+    connectToServer(): SocketPeer;
+}
+export interface SocketRule {
+    /**
+     * The `protocol` of this rule's frames: those it records, and the fault
+     * the stage records when `open` throws.
+     */
+    readonly protocol: string;
+    /** Names the rule in logs, diagnostics and the fault of a rule that throws. */
+    readonly label: string;
+    readonly url: UrlMatcher;
+    /** Stop taking connections after this many. */
+    readonly times?: number;
+    /**
+     * Take a connection: called once per matching socket. The page's socket
+     * opens when this settles — or, for a rule that connects the server,
+     * when the server's end opens — and sooner if the rule sends to it. Set
+     * the handlers before awaiting anything: an end drops what it sends
+     * until it has one.
+     *
+     * A rule that throws, or rejects — here, or in a handler it set on
+     * either end — is a bug in the test: the stage logs it, records a
+     * `fault` frame (`meta.reason` `rule-error`, `meta.rule` the label,
+     * `meta.error` the message) and closes the page's end with 1011 and a
+     * reason naming the rule — and the server's end too, if the rule
+     * connected it. Once per socket: what fails after that is not reported
+     * again. The ends' `onClose` handlers hear those closes as they hear any
+     * other.
+     */
+    open(socket: SocketView): void | Promise<void>;
+}
+export interface SocketRuleHandle {
+    /** Connections this rule took. */
+    readonly hits: number;
+    readonly active: boolean;
+    /** Stop taking connections. Open ones stay as they are. */
+    remove(): Promise<void>;
+}
+/**
+ * Where plugins put WebSocket rules. Rules apply to every attached context,
+ * present and future, and the newest rule that matches a socket takes it; a
+ * socket no rule takes goes to the real server.
+ *
+ * Routing replaces `WebSocket` in every document of the context, so it
+ * starts with the first rule and a stage with none leaves the page alone.
+ * The replacement reaches a document as it loads: a rule added later applies
+ * to the documents loaded after it, unless the plugin called `prepare()`.
+ */
+export interface SocketRouter {
+    add(rule: SocketRule): Promise<SocketRuleHandle>;
+    /**
+     * Start routing as soon as a context is attached, before any rule exists,
+     * so a rule added mid-test reaches the pages already open. Call in `setup`.
+     */
+    prepare(): void;
+}
+//# sourceMappingURL=socket.d.ts.map

package/dist/entities/plugin/model/socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../../../src/entities/plugin/model/socket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAErE,uEAAuE;AACvE,MAAM,WAAW,UAAU;IAC1B,qCAAqC;IACrC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACtC;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE;QACf,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IAC9D;;;;;;;OAOG;IACH,OAAO,CACN,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,GACrE,IAAI,CAAC;CACR;AAED,oEAAoE;AACpE,MAAM,WAAW,UAAU;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B;;;;;;;OAOG;IACH,eAAe,IAAI,UAAU,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IAC1B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;;;;;;;;;OAeG;IACH,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,gBAAgB;IAChC,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,2DAA2D;IAC3D,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC5B,GAAG,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACjD;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAC;CAChB"}

package/dist/entities/plugin/model/socket.js

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

package/dist/entities/plugin/model/socket.js.map

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

package/dist/entities/plugin/model/stream.d.ts

@@ -0,0 +1,46 @@
+/** How an open response ended. */
+export type StreamEnd = 
+/** The rule ended it cleanly. */
+"ended"
+/** The rule reset the connection. */
+ | "cut"
+/** The page went away: it closed the stream, navigated, or was closed. */
+ | "cancelled";
+/**
+ * A response that stays open, written at the test's pace: what a server
+ * stream, an event stream or a long poll is made of. A rule gets one by
+ * answering `{ type: "stream" }`.
+ */
+export interface ResponseStream {
+    /**
+     * The request's headers as the server received them, names lower-cased.
+     * They include what the browser's network stack adds after Playwright's
+     * route has seen the request, such as `last-event-id`.
+     */
+    readonly requestHeaders: Readonly<Record<string, string>>;
+    /**
+     * Set the status and headers. They go out with the first `write`, or at
+     * once on `flush`, and a later call replaces them until then. Without a
+     * call the response is a bare 200. A header may carry several values
+     * separated by a newline (`set-cookie`). `connection` is the stream
+     * server's: it closes every connection after one response.
+     */
+    head(status: number, headers?: Readonly<Record<string, string>>): void;
+    /** Send the head now, before any body: an EventSource opens on it. */
+    flush(): void;
+    /**
+     * Write a chunk. Resolves once it is handed to the socket; rejects with
+     * `CLOSED` when the response is over, the page letting go included.
+     */
+    write(chunk: Uint8Array | string): Promise<void>;
+    /** End the response cleanly. Resolves once it is closed, as `closed` does. */
+    end(): Promise<void>;
+    /**
+     * Reset the connection mid-response: no terminator, no trailer — what a
+     * network drop looks like to the page.
+     */
+    cut(): void;
+    /** Resolves when the response is over, with how, once that is on the timeline. */
+    readonly closed: Promise<StreamEnd>;
+}
+//# sourceMappingURL=stream.d.ts.map

package/dist/entities/plugin/model/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../../src/entities/plugin/model/stream.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,MAAM,MAAM,SAAS;AACpB,iCAAiC;AAC/B,OAAO;AACT,qCAAqC;GACnC,KAAK;AACP,0EAA0E;GACxE,WAAW,CAAC;AAEf;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1D;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC;IACvE,sEAAsE;IACtE,KAAK,IAAI,IAAI,CAAC;IACd;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,8EAA8E;IAC9E,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB;;;OAGG;IACH,GAAG,IAAI,IAAI,CAAC;IACZ,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CACpC"}

package/dist/entities/plugin/model/stream.js

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

package/dist/entities/plugin/model/stream.js.map

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

package/dist/features/connect/index.d.ts

@@ -0,0 +1,5 @@
+export { createRpcClient } from "./lib/client.js";
+export { connect } from "./lib/create-connect.js";
+export { statusOf } from "./lib/status-of.js";
+export type { ClientOptions, ConnectApi, ConnectOptions, HeldCall, HoldOptions, HoldStub, RpcCall, RpcProtocol, RpcServer, ServeOptions, StandaloneClientOptions, StreamCall, StreamEnd, StreamStub, StubHandle, StubOptions, UnaryReply, UnaryStub, } from "./model/types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/features/connect/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/connect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,YAAY,EACX,aAAa,EACb,UAAU,EACV,cAAc,EACd,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,OAAO,EACP,WAAW,EACX,SAAS,EACT,YAAY,EACZ,uBAAuB,EACvB,UAAU,EACV,SAAS,EACT,UAAU,EACV,UAAU,EACV,WAAW,EACX,UAAU,EACV,SAAS,GACT,MAAM,kBAAkB,CAAC"}

package/dist/features/connect/index.js

@@ -0,0 +1,4 @@
+export { createRpcClient } from "./lib/client.js";
+export { connect } from "./lib/create-connect.js";
+export { statusOf } from "./lib/status-of.js";
+//# sourceMappingURL=index.js.map

package/dist/features/connect/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/connect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/features/connect/lib/calls.d.ts

@@ -0,0 +1,9 @@
+import type { DescMessage } from "@bufbuild/protobuf";
+import type { Frame } from "../../../entities/frame/index.js";
+import type { RpcCall } from "../model/types.js";
+/**
+ * One method's frames as calls: one per correlation, oldest first. A frame
+ * another writer left without a correlation is a call of its own.
+ */
+export declare function assembleCalls<I extends DescMessage, O extends DescMessage>(frames: readonly Frame[]): RpcCall<I, O>[];
+//# sourceMappingURL=calls.d.ts.map

package/dist/features/connect/lib/calls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calls.d.ts","sourceRoot":"","sources":["../../../../src/features/connect/lib/calls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,oBAAoB,CAAC;AAEpE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,mBAAmB,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,WAAW,EACzE,MAAM,EAAE,SAAS,KAAK,EAAE,GACtB,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CA8CjB"}

package/dist/features/connect/lib/calls.js

@@ -0,0 +1,46 @@
+/**
+ * One method's frames as calls: one per correlation, oldest first. A frame
+ * another writer left without a correlation is a call of its own.
+ */
+export function assembleCalls(frames) {
+    const byCall = new Map();
+    for (const frame of frames) {
+        const key = frame.correlation ?? `#${frame.seq}`;
+        const list = byCall.get(key) ?? [];
+        list.push(frame);
+        byCall.set(key, list);
+    }
+    return [...byCall].map(([correlation, own]) => {
+        const first = own[0];
+        const requests = own.filter((frame) => frame.direction === "out" && frame.value !== undefined);
+        // Everything that is not the caller's is the answer: messages, the
+        // status, or the fault that stood in for one.
+        const answer = own.findLast((frame) => frame.direction !== "out");
+        const status = own.findLast((frame) => frame.kind === "response");
+        const fault = own.findLast((frame) => frame.kind === "fault");
+        return {
+            correlation,
+            caller: requests[0]?.source,
+            answeredBy: answer?.source,
+            page: first.page,
+            context: first.context,
+            protocol: first.meta["rpcProtocol"],
+            request: requests[0]?.value,
+            requests: requests.map((frame) => frame.value),
+            responses: own
+                .filter((frame) => frame.direction === "in" &&
+                frame.kind === "message" &&
+                frame.value !== undefined)
+                .map((frame) => frame.value),
+            status: status === undefined
+                ? undefined
+                : {
+                    code: Number(status.meta["code"]),
+                    message: String(status.meta["message"] ?? ""),
+                },
+            fault: fault === undefined ? undefined : String(fault.meta["reason"]),
+            frames: own,
+        };
+    });
+}
+//# sourceMappingURL=calls.js.map

package/dist/features/connect/lib/calls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calls.js","sourceRoot":"","sources":["../../../../src/features/connect/lib/calls.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC5B,MAAwB;IAExB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,IAAI,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;QACjD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,EAAE;QAC7C,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAU,CAAC;QAC9B,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAC1B,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,CACjE,CAAC;QACF,mEAAmE;QACnE,8CAA8C;QAC9C,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;QAClE,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;QAC9D,OAAO;YACN,WAAW;YACX,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM;YAC3B,UAAU,EAAE,MAAM,EAAE,MAAM;YAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAA4B;YAC9D,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAoC;YAC1D,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAwB,CAAC;YACjE,SAAS,EAAE,GAAG;iBACZ,MAAM,CACN,CAAC,KAAK,EAAE,EAAE,CACT,KAAK,CAAC,SAAS,KAAK,IAAI;gBACxB,KAAK,CAAC,IAAI,KAAK,SAAS;gBACxB,KAAK,CAAC,KAAK,KAAK,SAAS,CAC1B;iBACA,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAwB,CAAC;YAChD,MAAM,EACL,MAAM,KAAK,SAAS;gBACnB,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC;oBACA,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBACjC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;iBAC7C;YACJ,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACrE,MAAM,EAAE,GAAG;SACX,CAAC;IACH,CAAC,CAAC,CAAC;AACJ,CAAC"}