@heojeongbo/wirestage 0.0.0-stage → 0.1.1

package/dist/features/websocket/lib/mock.js

@@ -0,0 +1,96 @@
+import { createArrivals, createDeferred, } from "../../../shared/lib/async/index.js";
+import { closedError, createSocketLog, encodeOutgoing, toMessage, } from "./wire.js";
+/** A fake server: every matching socket becomes a connection the test drives. */
+export async function createMock(context, protocol, url, options) {
+    const connections = createArrivals({
+        clock: context.clock,
+        label: "WebSocket connection",
+    });
+    /** Each connection, with whether it is over: `broadcast` skips those. */
+    const ended = new Map();
+    const rule = await context.sockets.add({
+        protocol,
+        label: `mock ${String(url)}`,
+        url,
+        ...(options.times === undefined ? {} : { times: options.times }),
+        async open(socket) {
+            const log = createSocketLog(context, protocol, socket);
+            const messages = createArrivals({
+                clock: context.clock,
+                label: `message on ${socket.url.pathname}`,
+            });
+            const closed = createDeferred();
+            // The page hears of a close the stub starts through the same event
+            // as its own; whoever asked first is who closed.
+            let closedBy = "page";
+            log("lifecycle", "none", "page", { event: "open", url: socket.url.href });
+            socket.page.onMessage((raw) => {
+                messages.push(toMessage("out", raw, context.clock.now()));
+                log("message", "out", "page", {}, raw);
+            });
+            socket.page.onClose((code, reason) => {
+                // Once per connection: a close is reported again when the route
+                // completes it, which the close below does.
+                if (closed.settled)
+                    return;
+                closed.resolve({ code, reason });
+                log("lifecycle", "none", closedBy, { event: "close", code, reason });
+                // A handler here turns off Playwright's own answer to the page's
+                // close, and without one the page's socket would hang in CLOSING.
+                if (closedBy === "page")
+                    void socket.page.close({
+                        ...(code === undefined ? {} : { code }),
+                        ...(reason === undefined ? {} : { reason }),
+                    });
+            });
+            // Over from the moment the stub closes it, before the page hears.
+            const over = () => closed.settled || closedBy === "stub";
+            const connection = {
+                url: socket.url.href,
+                get messages() {
+                    return messages.items;
+                },
+                nextMessage: (waitOptions) => messages.next(waitOptions),
+                send(data) {
+                    if (over())
+                        throw closedError(socket);
+                    const encoded = encodeOutgoing(data);
+                    socket.page.send(encoded);
+                    log("message", "in", "stub", {}, encoded);
+                },
+                async close(closeOptions) {
+                    closedBy = "stub";
+                    await socket.page.close(closeOptions);
+                },
+                closed: closed.promise,
+            };
+            connections.push(connection);
+            ended.set(connection, over);
+            try {
+                await options.onConnect?.(connection);
+            }
+            catch (error) {
+                // The stage closes the socket of a rule that throws: the close
+                // the page then hears of is the stub's doing.
+                closedBy = "stub";
+                throw error;
+            }
+        },
+    });
+    return {
+        get hits() {
+            return rule.hits;
+        },
+        get connections() {
+            return connections.items;
+        },
+        next: (waitOptions) => connections.next(waitOptions),
+        broadcast(data) {
+            for (const [connection, isOver] of ended)
+                if (!isOver())
+                    connection.send(data);
+        },
+        remove: () => rule.remove(),
+    };
+}
+//# sourceMappingURL=mock.js.map

package/dist/features/websocket/lib/mock.js.map

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

package/dist/features/websocket/lib/proxy.d.ts

@@ -0,0 +1,9 @@
+import type { PluginContext } from "../../../entities/plugin/index.js";
+import type { UrlMatcher } from "../../../shared/lib/match/index.js";
+import type { WsProxy, WsProxyOptions } from "../model/types.js";
+/**
+ * A pass-through to the real server that records both directions and can
+ * drop or inject messages on the way.
+ */
+export declare function createProxy(context: PluginContext, protocol: string, url: UrlMatcher, options: WsProxyOptions): Promise<WsProxy>;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/features/websocket/lib/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../../../src/features/websocket/lib/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,aAAa,EAEb,MAAM,mCAAmC,CAAC;AAK3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,KAAK,EAGX,OAAO,EAEP,cAAc,EACd,MAAM,mBAAmB,CAAC;AAQ3B;;;GAGG;AACH,wBAAsB,WAAW,CAChC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,cAAc,GACrB,OAAO,CAAC,OAAO,CAAC,CAwHlB"}

package/dist/features/websocket/lib/proxy.js

@@ -0,0 +1,120 @@
+import { createArrivals, createDeferred, } from "../../../shared/lib/async/index.js";
+import { closedError, createSocketLog, encodeOutgoing, toMessage, } from "./wire.js";
+/**
+ * A pass-through to the real server that records both directions and can
+ * drop or inject messages on the way.
+ */
+export async function createProxy(context, protocol, url, options) {
+    const connections = createArrivals({
+        clock: context.clock,
+        label: "WebSocket connection",
+    });
+    const rule = await context.sockets.add({
+        protocol,
+        label: `proxy ${String(url)}`,
+        url,
+        ...(options.times === undefined ? {} : { times: options.times }),
+        open(socket) {
+            const log = createSocketLog(context, protocol, socket);
+            const page = socket.page;
+            const server = socket.connectToServer();
+            const messages = createArrivals({
+                clock: context.clock,
+                label: `message on ${socket.url.pathname}`,
+            });
+            const closed = createDeferred();
+            // Who closed, when neither end did: the test, or the stub — the
+            // stage closes the socket of a rule that throws.
+            let closedBy;
+            log("lifecycle", "none", "page", { event: "open", url: socket.url.href });
+            const forward = (direction, raw, to) => {
+                const passing = toMessage(direction, raw, context.clock.now());
+                messages.push(passing);
+                let dropped;
+                try {
+                    dropped = options.drop?.(passing);
+                }
+                catch (error) {
+                    // The stage fails a rule that throws and closes both ends: the
+                    // closes they report are the stub's, not the page's or server's.
+                    closedBy ??= "stub";
+                    throw error;
+                }
+                if (dropped) {
+                    log("fault", direction, "stub", { reason: "dropped" }, raw);
+                    return;
+                }
+                log("message", direction, direction === "out" ? "page" : "network", {}, raw);
+                to.send(raw);
+            };
+            page.onMessage((raw) => forward("out", raw, server));
+            server.onMessage((raw) => forward("in", raw, page));
+            // A close handler turns off Playwright's own forwarding of the close,
+            // so whichever end closes first, both are closed by hand: the other
+            // end to pass the close on, and the end that started it to complete
+            // it — the page's socket hangs in CLOSING until its end is closed.
+            // Once: each of those closes is reported back through a handler.
+            const relay = (from) => (code, reason) => {
+                if (closed.settled)
+                    return;
+                closed.resolve({ code, reason });
+                log("lifecycle", "none", closedBy ?? from, {
+                    event: "close",
+                    code,
+                    reason,
+                });
+                const passed = {
+                    ...(code === undefined ? {} : { code }),
+                    ...(reason === undefined ? {} : { reason }),
+                };
+                void page.close(passed);
+                void server.close(passed);
+            };
+            page.onClose(relay("page"));
+            server.onClose(relay("network"));
+            // Over from the moment the test closes it or the rule fails, before
+            // either end hears.
+            const over = () => closed.settled || closedBy !== undefined;
+            connections.push({
+                url: socket.url.href,
+                get messages() {
+                    return messages.items;
+                },
+                nextMessage: (waitOptions) => messages.next(waitOptions),
+                toPage(data) {
+                    if (over())
+                        throw closedError(socket);
+                    const encoded = encodeOutgoing(data);
+                    page.send(encoded);
+                    log("message", "in", "test", { injected: true }, encoded);
+                },
+                toServer(data) {
+                    if (over())
+                        throw closedError(socket);
+                    const encoded = encodeOutgoing(data);
+                    server.send(encoded);
+                    log("message", "out", "test", { injected: true }, encoded);
+                },
+                async close(closeOptions) {
+                    closedBy = "test";
+                    await Promise.all([
+                        page.close(closeOptions),
+                        server.close(closeOptions),
+                    ]);
+                },
+                closed: closed.promise,
+            });
+        },
+    });
+    return {
+        get hits() {
+            return rule.hits;
+        },
+        get connections() {
+            return connections.items;
+        },
+        next: (waitOptions) => connections.next(waitOptions),
+        remove: () => rule.remove(),
+    };
+}
+//# sourceMappingURL=proxy.js.map

package/dist/features/websocket/lib/proxy.js.map

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

package/dist/features/websocket/lib/wire.d.ts

@@ -0,0 +1,16 @@
+import type { Direction, FrameKind, FrameSource } from "../../../entities/frame/index.js";
+import type { PluginContext, SocketView } from "../../../entities/plugin/index.js";
+import { WirestageError } from "../../../shared/lib/errors/index.js";
+import type { WsData, WsMessage } from "../model/types.js";
+/**
+ * What a send to a connection that is over throws. Playwright would drop
+ * the message without a word, and the timeline would show it delivered.
+ */
+export declare function closedError(socket: SocketView): WirestageError;
+/** What a test passes to `send`, as the wire carries it. */
+export declare function encodeOutgoing(data: WsData): string | Uint8Array;
+export declare function toMessage(direction: "in" | "out", raw: string | Uint8Array, at: number): WsMessage;
+/** Writes one connection's frames: same endpoint, correlation and context. */
+export type SocketLog = (kind: FrameKind, direction: Direction, source: FrameSource, meta: Readonly<Record<string, unknown>>, data?: string | Uint8Array) => void;
+export declare function createSocketLog(context: Pick<PluginContext, "timeline">, protocol: string, socket: SocketView): SocketLog;
+//# sourceMappingURL=wire.d.ts.map

package/dist/features/websocket/lib/wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../../../src/features/websocket/lib/wire.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,SAAS,EACT,SAAS,EACT,WAAW,EACX,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EACX,aAAa,EACb,UAAU,EACV,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,cAAc,CAK9D;AAED,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAMhE;AAED,wBAAgB,SAAS,CACxB,SAAS,EAAE,IAAI,GAAG,KAAK,EACvB,GAAG,EAAE,MAAM,GAAG,UAAU,EACxB,EAAE,EAAE,MAAM,GACR,SAAS,CASX;AAED,8EAA8E;AAC9E,MAAM,MAAM,SAAS,GAAG,CACvB,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACvC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,KACtB,IAAI,CAAC;AAEV,wBAAgB,eAAe,CAC9B,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,EACxC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,GAChB,SAAS,CAgBX"}

package/dist/features/websocket/lib/wire.js

@@ -0,0 +1,46 @@
+import { toBytes, utf8 } from "../../../shared/lib/bytes/index.js";
+import { WirestageError } from "../../../shared/lib/errors/index.js";
+/**
+ * What a send to a connection that is over throws. Playwright would drop
+ * the message without a word, and the timeline would show it delivered.
+ */
+export function closedError(socket) {
+    return new WirestageError("CLOSED", `the WebSocket connection to ${socket.url.href} is closed`);
+}
+/** What a test passes to `send`, as the wire carries it. */
+export function encodeOutgoing(data) {
+    if (typeof data === "string")
+        return data;
+    // Any binary form goes out as bytes; only what is left is a value.
+    if (data instanceof ArrayBuffer || ArrayBuffer.isView(data))
+        return toBytes(data);
+    return JSON.stringify(data);
+}
+export function toMessage(direction, raw, at) {
+    const text = () => (typeof raw === "string" ? raw : utf8(raw));
+    return {
+        direction,
+        data: raw,
+        at,
+        text,
+        json: () => JSON.parse(text()),
+    };
+}
+export function createSocketLog(context, protocol, socket) {
+    return (kind, direction, source, meta, data) => {
+        context.timeline.append({
+            protocol,
+            kind,
+            direction,
+            // The path, like every HTTP frame: it reads the same on the dev
+            // server, the preview build and CI, whose origins all differ.
+            endpoint: socket.url.pathname,
+            source,
+            correlation: socket.correlation,
+            context: socket.context,
+            meta,
+            ...(data === undefined ? {} : { data }),
+        });
+    };
+}
+//# sourceMappingURL=wire.js.map

package/dist/features/websocket/lib/wire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.js","sourceRoot":"","sources":["../../../../src/features/websocket/lib/wire.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAGrE;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAAkB;IAC7C,OAAO,IAAI,cAAc,CACxB,QAAQ,EACR,+BAA+B,MAAM,CAAC,GAAG,CAAC,IAAI,YAAY,CAC1D,CAAC;AACH,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,cAAc,CAAC,IAAY;IAC1C,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,mEAAmE;IACnE,IAAI,IAAI,YAAY,WAAW,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC;QAC1D,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,SAAS,CACxB,SAAuB,EACvB,GAAwB,EACxB,EAAU;IAEV,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,OAAO;QACN,SAAS;QACT,IAAI,EAAE,GAAG;QACT,EAAE;QACF,IAAI;QACJ,IAAI,EAAE,GAAM,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAM;KACtC,CAAC;AACH,CAAC;AAWD,MAAM,UAAU,eAAe,CAC9B,OAAwC,EACxC,QAAgB,EAChB,MAAkB;IAElB,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;YACvB,QAAQ;YACR,IAAI;YACJ,SAAS;YACT,gEAAgE;YAChE,8DAA8D;YAC9D,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ;YAC7B,MAAM;YACN,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,IAAI;YACJ,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;SACvC,CAAC,CAAC;IACJ,CAAC,CAAC;AACH,CAAC"}

package/dist/features/websocket/model/types.d.ts

@@ -0,0 +1,133 @@
+import type { Frame } from "../../../entities/frame/index.js";
+import type { UrlMatcher } from "../../../shared/lib/match/index.js";
+export interface WebSocketOptions {
+    /**
+     * Leave `WebSocket` alone until the first `mock()` or `proxy()`.
+     *
+     * By default the plugin routes WebSockets from the moment a context is
+     * attached, so a mock added mid-test reaches the pages that are already
+     * open. Playwright routes by replacing `WebSocket` in every document as it
+     * loads, and a socket no rule takes is passed through to the real server.
+     * With `lazy`, nothing is replaced until the first rule exists — and that
+     * rule then applies only to the documents loaded after it.
+     */
+    readonly lazy?: boolean;
+}
+/** What a test may send: text, bytes in any binary form, or a value sent as JSON. */
+export type WsData = string | ArrayBuffer | ArrayBufferView | object;
+export interface WsMessage {
+    /** `out` came from the page, `in` went to it. */
+    readonly direction: "in" | "out";
+    readonly data: string | Uint8Array;
+    readonly at: number;
+    text(): string;
+    json<T = unknown>(): T;
+}
+export interface WsCloseInfo {
+    readonly code: number | undefined;
+    readonly reason: string | undefined;
+}
+export interface WsCloseOptions {
+    /**
+     * The code the page's socket closes with: any a server may send. A proxy
+     * also closes the real server's end, through the browser, which sends
+     * only 1000 and 3000-4999 — another code reaches the page as given and
+     * the server as a normal closure, 1000.
+     */
+    readonly code?: number;
+    /**
+     * The page gets it whole. A proxy's real server gets at most 123 bytes
+     * of it, cut on a character: all a close frame carries, and all the
+     * browser will send.
+     */
+    readonly reason?: string;
+}
+export interface WsConnection {
+    readonly url: string;
+    /** Messages the page sent, oldest first. */
+    readonly messages: readonly WsMessage[];
+    /** The next message the page sends (or sent and nobody took). */
+    nextMessage(options?: {
+        readonly timeout?: number;
+    }): Promise<WsMessage>;
+    /**
+     * Send to the page. Throws `CLOSED` once the connection is over — from
+     * the moment `close()` is called — since the page would never get it.
+     */
+    send(data: WsData): void;
+    close(options?: WsCloseOptions): Promise<void>;
+    /** Resolves when the connection is over, whoever closed it. */
+    readonly closed: Promise<WsCloseInfo>;
+}
+export interface WsMockOptions {
+    /** Answer this many connections, then leave the rest to the next rule. */
+    readonly times?: number;
+    /**
+     * Called for each new connection, e.g. to send a greeting. The page's
+     * socket opens once it settles. If it throws, the stage closes the
+     * page's socket with 1011 and records a `rule-error` fault.
+     */
+    readonly onConnect?: (connection: WsConnection) => void | Promise<void>;
+}
+export interface WsMock {
+    /** Connections this mock took. */
+    readonly hits: number;
+    readonly connections: readonly WsConnection[];
+    /** The next connection the page opens (or opened and nobody took). */
+    next(options?: {
+        readonly timeout?: number;
+    }): Promise<WsConnection>;
+    /** Send to every connection that is not over yet. */
+    broadcast(data: WsData): void;
+    /** New connections go to the real server again. */
+    remove(): Promise<void>;
+}
+export interface WsProxyOptions {
+    /** Proxy this many connections, then leave the rest to the next rule. */
+    readonly times?: number;
+    /**
+     * Drop a message instead of forwarding it. Dropped messages are recorded
+     * as faults. If it throws, the stage closes both ends, the page's with
+     * 1011, and records a `rule-error` fault.
+     */
+    readonly drop?: (message: WsMessage) => boolean;
+}
+export interface WsProxyConnection {
+    readonly url: string;
+    /** Messages in both directions, oldest first. */
+    readonly messages: readonly WsMessage[];
+    nextMessage(options?: {
+        readonly timeout?: number;
+    }): Promise<WsMessage>;
+    /**
+     * Inject a message to the page, as if the server sent it. Throws
+     * `CLOSED` once the connection is over, as `toServer` does.
+     */
+    toPage(data: WsData): void;
+    /** Inject a message to the server, as if the page sent it. */
+    toServer(data: WsData): void;
+    /** Close both sides. */
+    close(options?: WsCloseOptions): Promise<void>;
+    /** Resolves when the connection is over, whoever closed it. */
+    readonly closed: Promise<WsCloseInfo>;
+}
+export interface WsProxy {
+    /** Connections this proxy took. */
+    readonly hits: number;
+    readonly connections: readonly WsProxyConnection[];
+    next(options?: {
+        readonly timeout?: number;
+    }): Promise<WsProxyConnection>;
+    remove(): Promise<void>;
+}
+export interface WebSocketApi {
+    /** Answer matching WebSockets with a fake server the test drives. */
+    mock(url: UrlMatcher, options?: WsMockOptions): Promise<WsMock>;
+    /** Pass matching WebSockets through to the real server, recording and optionally dropping messages. */
+    proxy(url: UrlMatcher, options?: WsProxyOptions): Promise<WsProxy>;
+    /** Every recorded frame: opens, messages, drops, closes. */
+    frames(filter?: {
+        readonly endpoint?: string | RegExp;
+    }): Promise<Frame[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/features/websocket/model/types.d.ts.map

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

package/dist/features/websocket/model/types.js

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

package/dist/features/websocket/model/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @heojeongbo/wirestage — the core: the stage, its timeline, and the plugin
+ * contract every protocol is written against. Protocols live in subpaths:
+ * `/connect`, `/rest`, `/sse`, `/websocket`, `/webrtc`; the Playwright
+ * fixture in `/playwright`.
+ */
+export type { Direction, Frame, FrameFilter, FrameInit, FrameKind, FrameSource, Payload, PayloadInput, SnapshotFrame, SnapshotOptions, Timeline, TimelineCursor, TimelineOptions, TimelineSnapshot, } from "./entities/frame/index.js";
+export { createTimeline } from "./entities/frame/index.js";
+export type { AbortErrorCode, AnyWirePlugin, Attachment, HttpOutcome, HttpRequestView, HttpRouter, HttpRule, HttpRuleHandle, PageEntry, PageHost, PageInstaller, PageModule, PageModuleEnv, PageSource, PassthroughResponse, PluginApis, PluginContext, PluginRuntime, ResponseStream, SocketPeer, SocketRouter, SocketRule, SocketRuleHandle, SocketView, StreamEnd, WaitForOptions, WirePlugin, } from "./entities/plugin/index.js";
+export { definePlugin, named } from "./entities/plugin/index.js";
+export type { ContextPort, CookieJarPort, FramePort, PagePort, } from "./shared/api/playwright/index.js";
+export type { Arrivals, ArrivalsOptions, AsyncQueue, Deferred, } from "./shared/lib/async/index.js";
+export { createArrivals, createAsyncQueue, createDeferred, } from "./shared/lib/async/index.js";
+export type { Clock, ManualClock } from "./shared/lib/clock/index.js";
+export { createManualClock, createSystemClock, } from "./shared/lib/clock/index.js";
+export type { CookieInit } from "./shared/lib/cookies/index.js";
+export type { Envelope } from "./shared/lib/envelope/index.js";
+export { createEnvelopeReader, decodeEnvelopes, EnvelopeFlag, encodeEnvelope, encodeEnvelopes, parseTrailerBlock, } from "./shared/lib/envelope/index.js";
+export type { WirestageErrorCode } from "./shared/lib/errors/index.js";
+export { isWirestageError, WirestageError } from "./shared/lib/errors/index.js";
+export type { LogScope, LogThreshold, ScopedLogger, } from "./shared/lib/logger/index.js";
+export { getLogThreshold, setLogThreshold } from "./shared/lib/logger/index.js";
+export type { UrlMatcher } from "./shared/lib/match/index.js";
+export { compileUrlMatcher } from "./shared/lib/match/index.js";
+export type { AttachOptions, ReportOptions, Stage, StageCore, StageOptions, StageReport, } from "./widgets/stage/index.js";
+export { createStage } from "./widgets/stage/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,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,eAAe,EACf,gBAAgB,GAChB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,YAAY,EACX,cAAc,EACd,aAAa,EACb,UAAU,EACV,WAAW,EACX,eAAe,EACf,UAAU,EACV,QAAQ,EACR,cAAc,EACd,SAAS,EACT,QAAQ,EACR,aAAa,EACb,UAAU,EACV,aAAa,EACb,UAAU,EACV,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,aAAa,EACb,cAAc,EACd,UAAU,EACV,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,SAAS,EACT,cAAc,EACd,UAAU,GACV,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAEjE,YAAY,EACX,WAAW,EACX,aAAa,EACb,SAAS,EACT,QAAQ,GACR,MAAM,kCAAkC,CAAC;AAE1C,YAAY,EACX,QAAQ,EACR,eAAe,EACf,UAAU,EACV,QAAQ,GACR,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACN,cAAc,EACd,gBAAgB,EAChB,cAAc,GACd,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EACN,iBAAiB,EACjB,iBAAiB,GACjB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAGhE,YAAY,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EACN,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,eAAe,EACf,iBAAiB,GACjB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAChF,YAAY,EACX,QAAQ,EACR,YAAY,EACZ,YAAY,GACZ,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAChF,YAAY,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,YAAY,EACX,aAAa,EACb,aAAa,EACb,KAAK,EACL,SAAS,EACT,YAAY,EACZ,WAAW,GACX,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+/**
+ * @heojeongbo/wirestage — the core: the stage, its timeline, and the plugin
+ * contract every protocol is written against. Protocols live in subpaths:
+ * `/connect`, `/rest`, `/sse`, `/websocket`, `/webrtc`; the Playwright
+ * fixture in `/playwright`.
+ */
+export { createTimeline } from "./entities/frame/index.js";
+export { definePlugin, named } from "./entities/plugin/index.js";
+export { createArrivals, createAsyncQueue, createDeferred, } from "./shared/lib/async/index.js";
+export { createManualClock, createSystemClock, } from "./shared/lib/clock/index.js";
+export { createEnvelopeReader, decodeEnvelopes, EnvelopeFlag, encodeEnvelope, encodeEnvelopes, parseTrailerBlock, } from "./shared/lib/envelope/index.js";
+export { isWirestageError, WirestageError } from "./shared/lib/errors/index.js";
+export { getLogThreshold, setLogThreshold } from "./shared/lib/logger/index.js";
+export { compileUrlMatcher } from "./shared/lib/match/index.js";
+export { createStage } from "./widgets/stage/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmBH,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AA+B3D,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAejE,OAAO,EACN,cAAc,EACd,gBAAgB,EAChB,cAAc,GACd,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACN,iBAAiB,EACjB,iBAAiB,GACjB,MAAM,6BAA6B,CAAC;AAKrC,OAAO,EACN,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,eAAe,EACf,iBAAiB,GACjB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAMhF,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEhF,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAShE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/playwright.d.ts

@@ -0,0 +1,4 @@
+/** @heojeongbo/wirestage/playwright — the `stage` fixture for @playwright/test. */
+export type { ReportMode, StageFixtureArgs, StageFixtureOptions, StageTestInfo, } from "./app/playwright/index.js";
+export { createStageFixture, withStage } from "./app/playwright/index.js";
+//# sourceMappingURL=playwright.d.ts.map

package/dist/playwright.d.ts.map

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

package/dist/playwright.js

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

package/dist/playwright.js.map

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

package/dist/rest.d.ts

@@ -0,0 +1,3 @@
+/** @heojeongbo/wirestage/rest — REST and other plain HTTP. */
+export * from "./features/rest/index.js";
+//# sourceMappingURL=rest.d.ts.map

package/dist/rest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest.d.ts","sourceRoot":"","sources":["../src/rest.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,cAAc,0BAA0B,CAAC"}

package/dist/rest.js

@@ -0,0 +1,3 @@
+/** @heojeongbo/wirestage/rest — REST and other plain HTTP. */
+export * from "./features/rest/index.js";
+//# sourceMappingURL=rest.js.map

package/dist/rest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest.js","sourceRoot":"","sources":["../src/rest.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,cAAc,0BAA0B,CAAC"}

package/dist/shared/api/http-server/index.d.ts

@@ -0,0 +1,3 @@
+export type { Listening, ListenOptions } from "./listen.js";
+export { listen } from "./listen.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/api/http-server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/api/http-server/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/shared/api/http-server/index.js

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

package/dist/shared/api/http-server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared/api/http-server/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/shared/api/http-server/listen.d.ts

@@ -0,0 +1,25 @@
+import type { Server } from "node:net";
+export interface ListenOptions {
+    /** Names the server in the "port in use" error. */
+    readonly name: string;
+    readonly protocol: "http" | "https";
+    readonly host?: string;
+    /** 0, the default, picks a free port. */
+    readonly port?: number;
+}
+export interface Listening {
+    readonly url: string;
+    readonly port: number;
+    /** Stop accepting and drop open connections at once. */
+    close(): Promise<void>;
+}
+/**
+ * Start listening and return a handle whose `close` really is immediate.
+ * `server.close()` alone waits for every keep-alive and streaming connection to
+ * end on its own — a held-open stream would stall test teardown until the
+ * runner's timeout.
+ *
+ * Takes a `net.Server`, which http, https and http2 servers all are.
+ */
+export declare function listen(server: Server, options: ListenOptions): Promise<Listening>;
+//# sourceMappingURL=listen.d.ts.map

package/dist/shared/api/http-server/listen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listen.d.ts","sourceRoot":"","sources":["../../../../src/shared/api/http-server/listen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,MAAM,EAAU,MAAM,UAAU,CAAC;AAI5D,MAAM,WAAW,aAAa;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAsB,MAAM,CAC3B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,GACpB,OAAO,CAAC,SAAS,CAAC,CAuCpB"}