@heojeongbo/wirestage 0.0.0-stage → 0.1.0

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

@@ -0,0 +1,44 @@
+import { WirestageError } from "../../lib/errors/index.js";
+/**
+ * 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 async function listen(server, options) {
+    const host = options.host ?? "127.0.0.1";
+    const sockets = new Set();
+    server.on("connection", (socket) => {
+        sockets.add(socket);
+        socket.once("close", () => sockets.delete(socket));
+    });
+    await new Promise((resolve, reject) => {
+        const onListening = () => {
+            server.off("error", onError);
+            resolve();
+        };
+        const onError = (error) => {
+            server.off("listening", onListening);
+            reject(error.code === "EADDRINUSE"
+                ? new WirestageError("INVALID_STATE", `${options.name}: ${host}:${options.port} is already in use`, { cause: error, details: { host, port: options.port } })
+                : error);
+        };
+        server.once("listening", onListening);
+        server.once("error", onError);
+        server.listen(options.port ?? 0, host);
+    });
+    const port = server.address().port;
+    return {
+        // An IPv6 literal goes in brackets, or the port reads as part of it.
+        url: `${options.protocol}://${host.includes(":") ? `[${host}]` : host}:${port}`,
+        port,
+        close: () => new Promise((resolve) => {
+            for (const socket of sockets)
+                socket.destroy();
+            server.close(() => resolve());
+        }),
+    };
+}
+//# sourceMappingURL=listen.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"listen.js","sourceRoot":"","sources":["../../../../src/shared/api/http-server/listen.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAkB3D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC3B,MAAc,EACd,OAAsB;IAEtB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,MAAc,EAAE,EAAE;QAC1C,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IACH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,WAAW,GAAG,GAAG,EAAE;YACxB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7B,OAAO,EAAE,CAAC;QACX,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,CAAC,KAA4B,EAAE,EAAE;YAChD,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;YACrC,MAAM,CACL,KAAK,CAAC,IAAI,KAAK,YAAY;gBAC1B,CAAC,CAAC,IAAI,cAAc,CAClB,eAAe,EACf,GAAG,OAAO,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,CAAC,IAAI,oBAAoB,EAC5D,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CACvD;gBACF,CAAC,CAAC,KAAK,CACR,CAAC;QACH,CAAC,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IACH,MAAM,IAAI,GAAI,MAAM,CAAC,OAAO,EAAkB,CAAC,IAAI,CAAC;IACpD,OAAO;QACN,qEAAqE;QACrE,GAAG,EAAE,GAAG,OAAO,CAAC,QAAQ,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,EAAE;QAC/E,IAAI;QACJ,KAAK,EAAE,GAAG,EAAE,CACX,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC7B,KAAK,MAAM,MAAM,IAAI,OAAO;gBAAE,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/C,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/B,CAAC,CAAC;KACH,CAAC;AACH,CAAC"}

package/dist/shared/api/playwright/index.d.ts

@@ -0,0 +1,2 @@
+export type { BindingSourcePort, ContextPort, ContinueOptions, CookieJarPort, CookiePort, FramePort, FulfillOptions, HeaderMap, PagePort, RequestPort, ResponsePort, RouteHandler, RoutePort, UrlPredicate, WebSocketRoutePort, } from "./ports.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/api/playwright/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/api/playwright/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,aAAa,EACb,UAAU,EACV,SAAS,EACT,cAAc,EACd,SAAS,EACT,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,kBAAkB,GAClB,MAAM,YAAY,CAAC"}

package/dist/shared/api/playwright/index.js

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

package/dist/shared/api/playwright/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared/api/playwright/index.ts"],"names":[],"mappings":""}

package/dist/shared/api/playwright/ports.d.ts

@@ -0,0 +1,117 @@
+/**
+ * The slice of Playwright the library drives, as structural types.
+ *
+ * Real Playwright objects satisfy these as they are — `tests/types` proves it
+ * against the pinned version — so the public API takes a `BrowserContext` and
+ * hands it inward unchanged. Inside, everything depends on the ports, never on
+ * Playwright, which is what lets the unit suite cover every branch with
+ * hand-written fakes instead of a browser.
+ */
+import type { CookieInit } from "../../lib/cookies/index.js";
+export type HeaderMap = Readonly<Record<string, string>>;
+export interface FramePort {
+    evaluate<R>(pageFunction: (arg: any) => R | Promise<R>, arg?: unknown): Promise<R>;
+}
+export interface PagePort {
+    /** The main frame and every iframe: page hooks run in each of them. */
+    frames(): FramePort[];
+    isClosed(): boolean;
+}
+export interface ResponsePort {
+    status(): number;
+    headers(): HeaderMap;
+    body(): Promise<Buffer>;
+}
+export interface RequestPort {
+    url(): string;
+    method(): string;
+    /** Playwright already lower-cases these names. */
+    headers(): HeaderMap;
+    /**
+     * Every header, including the ones `headers()` leaves out (cookies, and
+     * headers the network stack adds such as `last-event-id`).
+     */
+    allHeaders(): Promise<HeaderMap>;
+    postDataBuffer(): Buffer | null;
+    resourceType(): string;
+    /** Throws for requests a service worker makes; callers must guard it. */
+    frame(): {
+        page(): PagePort;
+    };
+    response(): Promise<ResponsePort | null>;
+    failure(): {
+        errorText: string;
+    } | null;
+}
+export interface FulfillOptions {
+    readonly status?: number;
+    readonly headers?: Record<string, string>;
+    readonly body?: string | Buffer;
+}
+export interface ContinueOptions {
+    readonly url?: string;
+    readonly method?: string;
+    readonly headers?: Record<string, string>;
+    readonly postData?: string | Buffer;
+}
+export interface RoutePort {
+    request(): RequestPort;
+    fulfill(options: FulfillOptions): Promise<void>;
+    continue(options?: ContinueOptions): Promise<void>;
+    fallback(): Promise<void>;
+    abort(errorCode?: string): Promise<void>;
+}
+export type RouteHandler = (route: RoutePort, request: RequestPort) => Promise<void>;
+export type UrlPredicate = (url: URL) => boolean;
+export interface WebSocketRoutePort {
+    url(): string;
+    onMessage(handler: (message: string | Buffer) => unknown): void;
+    onClose(handler: (code: number | undefined, reason: string | undefined) => unknown): void;
+    send(message: string | Buffer): void;
+    close(options?: {
+        code?: number;
+        reason?: string;
+    }): Promise<void>;
+    connectToServer(): WebSocketRoutePort;
+}
+export interface BindingSourcePort {
+    readonly page: PagePort;
+}
+export interface CookiePort {
+    readonly name: string;
+    readonly value: string;
+}
+/**
+ * The cookie jar of a browser context: all a drive client needs of one, so
+ * that is all it is given.
+ */
+export interface CookieJarPort {
+    cookies(urls?: string | string[]): Promise<CookiePort[]>;
+    /**
+     * Optional so a fake may omit it; every real BrowserContext has it. Drive
+     * clients keep the cookies a response sets here, the way Playwright's own
+     * request context does.
+     */
+    addCookies?(cookies: CookieInit[]): Promise<void>;
+}
+export interface ContextPort extends CookieJarPort {
+    /** Required here: a context always has it, and a plugin's jar calls it. */
+    addCookies(cookies: CookieInit[]): Promise<void>;
+    route(url: UrlPredicate, handler: RouteHandler): Promise<unknown>;
+    unroute(url: UrlPredicate, handler?: RouteHandler): Promise<void>;
+    routeWebSocket(url: UrlPredicate, handler: (route: WebSocketRoutePort) => unknown): Promise<void>;
+    addInitScript(script: {
+        content: string;
+    }): Promise<unknown>;
+    exposeBinding(name: string, binding: (source: BindingSourcePort, message: unknown) => unknown): Promise<unknown>;
+    pages(): PagePort[];
+    /** Optional so a fake may omit it; every real BrowserContext has it. */
+    grantPermissions?(permissions: string[], options?: {
+        origin?: string;
+    }): Promise<void>;
+    on(event: "close", listener: () => void): unknown;
+    on(event: "requestfinished" | "requestfailed", listener: (request: RequestPort) => void): unknown;
+    off(event: "close", listener: () => void): unknown;
+    off(event: "requestfinished" | "requestfailed", listener: (request: RequestPort) => void): unknown;
+}
+//# sourceMappingURL=ports.d.ts.map

package/dist/shared/api/playwright/ports.d.ts.map

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

package/dist/shared/api/playwright/ports.js

@@ -0,0 +1,11 @@
+/**
+ * The slice of Playwright the library drives, as structural types.
+ *
+ * Real Playwright objects satisfy these as they are — `tests/types` proves it
+ * against the pinned version — so the public API takes a `BrowserContext` and
+ * hands it inward unchanged. Inside, everything depends on the ports, never on
+ * Playwright, which is what lets the unit suite cover every branch with
+ * hand-written fakes instead of a browser.
+ */
+export {};
+//# sourceMappingURL=ports.js.map

package/dist/shared/api/playwright/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../../../src/shared/api/playwright/ports.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

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

@@ -0,0 +1,3 @@
+export type { NodeHandler, StreamServer, StreamServerOptions, StreamSession, } from "./stream-server.js";
+export { createStreamServer } from "./stream-server.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/api/stream-server/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,aAAa,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

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

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

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

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

package/dist/shared/api/stream-server/stream-server.d.ts

@@ -0,0 +1,43 @@
+import { type IncomingMessage, type ServerResponse } from "node:http";
+import type { ScopedLogger } from "../../lib/logger/index.js";
+export type NodeHandler = (request: IncomingMessage, response: ServerResponse) => void | Promise<void>;
+export interface StreamSession {
+    readonly id: string;
+    /** Where the browser's request is redirected to. Single use. */
+    readonly url: string;
+    /** Forget the session if the redirect never arrives. */
+    dispose(): void;
+}
+export interface StreamServerOptions {
+    /** Key and certificate for pages served over https. */
+    readonly tls?: {
+        readonly key: string | Buffer;
+        readonly cert: string | Buffer;
+    };
+    readonly host?: string;
+    readonly log?: ScopedLogger;
+}
+export interface StreamServer {
+    /**
+     * Register a handler and return the URL to redirect one request to.
+     * `secure` is whether the page's request was https: Playwright only lets
+     * `route.continue` change the URL within the same scheme.
+     */
+    open(handler: NodeHandler, options: {
+        readonly secure: boolean;
+    }): Promise<StreamSession>;
+    /** Stop every listener and refuse further sessions. */
+    close(): Promise<void>;
+    readonly sessions: number;
+}
+/**
+ * A local server for responses that must stay open — server streams, SSE —
+ * which `route.fulfill` cannot express because it takes the whole body at
+ * once. A stub answers by redirecting the browser's request here, and the
+ * handler then writes to a real socket at whatever pace the test drives.
+ *
+ * It starts lazily on the first session, so a suite that never streams never
+ * opens a port, and adds a port whenever the ones it has are full.
+ */
+export declare function createStreamServer(options?: StreamServerOptions): StreamServer;
+//# sourceMappingURL=stream-server.d.ts.map

package/dist/shared/api/stream-server/stream-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-server.d.ts","sourceRoot":"","sources":["../../../../src/shared/api/stream-server/stream-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,MAAM,WAAW,CAAC;AAKnB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,MAAM,MAAM,WAAW,GAAG,CACzB,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,cAAc,KACpB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,OAAO,IAAI,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IACnC,uDAAuD;IACvD,QAAQ,CAAC,GAAG,CAAC,EAAE;QACd,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;QAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;KAC/B,CAAC;IACF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC5B;;;;OAIG;IACH,IAAI,CACH,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;KAAE,GACnC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B,uDAAuD;IACvD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAuCD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CACjC,OAAO,GAAE,mBAAwB,GAC/B,YAAY,CA8Hd"}

package/dist/shared/api/stream-server/stream-server.js

@@ -0,0 +1,160 @@
+import { createServer as createHttpServer, } from "node:http";
+import { createServer as createHttpsServer } from "node:https";
+import { WirestageError } from "../../lib/errors/index.js";
+import { randomToken } from "../../lib/id/index.js";
+import { listen } from "../http-server/index.js";
+const PATH = "/__wirestage/";
+/**
+ * Headers a browser script may read on a response from another origin. The
+ * redirect makes the stream server a different origin from the page as far
+ * as CORS is concerned in some engines, and connect-web reads these.
+ */
+const EXPOSED_HEADERS = [
+    "grpc-status",
+    "grpc-message",
+    "grpc-status-details-bin",
+    "grpc-encoding",
+    "connect-protocol-version",
+    "content-encoding",
+    "content-type",
+].join(", ");
+/**
+ * Open responses one listener carries. A browser keeps at most six
+ * connections to one host and port, and an open stream holds its connection
+ * for as long as it lives: the seventh would wait for one of the six to end,
+ * which in a test is never. Four leaves room for the preflights the browser
+ * sends on the same connection pool.
+ */
+const STREAMS_PER_LISTENER = 4;
+/**
+ * A local server for responses that must stay open — server streams, SSE —
+ * which `route.fulfill` cannot express because it takes the whole body at
+ * once. A stub answers by redirecting the browser's request here, and the
+ * handler then writes to a real socket at whatever pace the test drives.
+ *
+ * It starts lazily on the first session, so a suite that never streams never
+ * opens a port, and adds a port whenever the ones it has are full.
+ */
+export function createStreamServer(options = {}) {
+    const secure = options.tls !== undefined;
+    const sessions = new Map();
+    const listeners = new Set();
+    let closed = false;
+    const release = (id, session) => {
+        if (sessions.delete(id))
+            session.listener.open -= 1;
+    };
+    const onRequest = (request, response) => {
+        allowCors(request, response);
+        if (request.method === "OPTIONS") {
+            response.writeHead(204);
+            response.end();
+            return;
+        }
+        const id = request.url?.startsWith(PATH)
+            ? request.url.slice(PATH.length)
+            : "";
+        const session = sessions.get(id);
+        if (session === undefined) {
+            response.writeHead(404);
+            response.end();
+            return;
+        }
+        // One request per session: a client that reconnects goes through the
+        // page's route again and gets a session of its own. The session keeps
+        // its place on the listener until the response is over.
+        sessions.delete(id);
+        response.once("close", () => {
+            session.listener.open -= 1;
+        });
+        Promise.resolve()
+            .then(() => session.handler(request, response))
+            .catch((error) => {
+            // A write into a connection the client closed, or a test cut, is
+            // the expected end of a stream, not a failure worth an error line.
+            if (response.destroyed) {
+                options.log?.debug("stream ended by a closed connection", { session: id }, error);
+                return;
+            }
+            options.log?.error("stream handler failed", { session: id }, error);
+            if (!response.headersSent)
+                response.writeHead(500);
+            response.end();
+        });
+    };
+    /** A listener with room, starting another when the rest are full. */
+    const listenerWithRoom = () => {
+        for (const listener of listeners)
+            if (listener.open < STREAMS_PER_LISTENER)
+                return listener;
+        const listener = {
+            listening: listen(options.tls === undefined
+                ? createHttpServer(onRequest)
+                : createHttpsServer(options.tls, onRequest), {
+                name: "wirestage stream server",
+                protocol: secure ? "https" : "http",
+                host: options.host,
+            }),
+            open: 0,
+        };
+        listeners.add(listener);
+        // A listener that could not start must not be offered again.
+        listener.listening.catch(() => listeners.delete(listener));
+        return listener;
+    };
+    return {
+        async open(handler, { secure: pageIsSecure }) {
+            if (closed)
+                throw new WirestageError("CLOSED", "the stream server is closed: the stage was disposed while a stream was being opened");
+            if (pageIsSecure !== secure)
+                throw new WirestageError("UNSUPPORTED", pageIsSecure
+                    ? "a live stream on an https page needs `streamServer.tls`: Playwright only redirects a request to a URL with the same scheme"
+                    : "the stream server was given TLS but the page is http; drop `streamServer.tls` for http pages", { details: { pageIsSecure, serverIsSecure: secure } });
+            const listener = listenerWithRoom();
+            const session = { handler, listener };
+            const id = randomToken();
+            listener.open += 1;
+            sessions.set(id, session);
+            try {
+                const { url } = await listener.listening;
+                return {
+                    id,
+                    url: `${url}${PATH}${id}`,
+                    dispose: () => release(id, session),
+                };
+            }
+            catch (error) {
+                release(id, session);
+                throw error;
+            }
+        },
+        async close() {
+            closed = true;
+            sessions.clear();
+            const stopping = [...listeners];
+            listeners.clear();
+            await Promise.all(stopping.map((listener) => listener.listening.then((listening) => listening.close(), 
+            // It never started; there is nothing to stop.
+            () => undefined)));
+        },
+        get sessions() {
+            return sessions.size;
+        },
+    };
+}
+function allowCors(request, response) {
+    const origin = request.headers.origin;
+    if (origin === undefined)
+        return;
+    response.setHeader("access-control-allow-origin", origin);
+    response.setHeader("vary", "origin");
+    response.setHeader("access-control-allow-credentials", "true");
+    response.setHeader("access-control-allow-methods", "GET, POST, PUT, PATCH, DELETE, OPTIONS");
+    response.setHeader("access-control-allow-headers", request.headers["access-control-request-headers"] ?? "*");
+    response.setHeader("access-control-expose-headers", EXPOSED_HEADERS);
+    // Private Network Access: a page on a public origin must be told the
+    // loopback stream server agrees to be reached, or Chromium refuses.
+    if (request.headers["access-control-request-private-network"] === "true")
+        response.setHeader("access-control-allow-private-network", "true");
+}
+//# sourceMappingURL=stream-server.js.map

package/dist/shared/api/stream-server/stream-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-server.js","sourceRoot":"","sources":["../../../../src/shared/api/stream-server/stream-server.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,YAAY,IAAI,gBAAgB,GAGhC,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,IAAI,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EAAkB,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAwCjE,MAAM,IAAI,GAAG,eAAe,CAAC;AAE7B;;;;GAIG;AACH,MAAM,eAAe,GAAG;IACvB,aAAa;IACb,cAAc;IACd,yBAAyB;IACzB,eAAe;IACf,0BAA0B;IAC1B,kBAAkB;IAClB,cAAc;CACd,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb;;;;;;GAMG;AACH,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAa/B;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CACjC,UAA+B,EAAE;IAEjC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC;IACzC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAY,CAAC;IACtC,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,MAAM,OAAO,GAAG,CAAC,EAAU,EAAE,OAAgB,EAAE,EAAE;QAChD,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC;IACrD,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,OAAwB,EAAE,QAAwB,EAAE,EAAE;QACxE,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAClC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACxB,QAAQ,CAAC,GAAG,EAAE,CAAC;YACf,OAAO;QACR,CAAC;QACD,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC;YACvC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;YAChC,CAAC,CAAC,EAAE,CAAC;QACN,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC3B,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACxB,QAAQ,CAAC,GAAG,EAAE,CAAC;YACf,OAAO;QACR,CAAC;QACD,qEAAqE;QACrE,sEAAsE;QACtE,wDAAwD;QACxD,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;YAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,OAAO,EAAE;aACf,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;aAC9C,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACzB,iEAAiE;YACjE,mEAAmE;YACnE,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;gBACxB,OAAO,CAAC,GAAG,EAAE,KAAK,CACjB,qCAAqC,EACrC,EAAE,OAAO,EAAE,EAAE,EAAE,EACf,KAAK,CACL,CAAC;gBACF,OAAO;YACR,CAAC;YACD,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,uBAAuB,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;YACpE,IAAI,CAAC,QAAQ,CAAC,WAAW;gBAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACnD,QAAQ,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,qEAAqE;IACrE,MAAM,gBAAgB,GAAG,GAAa,EAAE;QACvC,KAAK,MAAM,QAAQ,IAAI,SAAS;YAC/B,IAAI,QAAQ,CAAC,IAAI,GAAG,oBAAoB;gBAAE,OAAO,QAAQ,CAAC;QAC3D,MAAM,QAAQ,GAAa;YAC1B,SAAS,EAAE,MAAM,CAChB,OAAO,CAAC,GAAG,KAAK,SAAS;gBACxB,CAAC,CAAC,gBAAgB,CAAC,SAAS,CAAC;gBAC7B,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,EAC5C;gBACC,IAAI,EAAE,yBAAyB;gBAC/B,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;gBACnC,IAAI,EAAE,OAAO,CAAC,IAAI;aAClB,CACD;YACD,IAAI,EAAE,CAAC;SACP,CAAC;QACF,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxB,6DAA6D;QAC7D,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3D,OAAO,QAAQ,CAAC;IACjB,CAAC,CAAC;IAEF,OAAO;QACN,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE;YAC3C,IAAI,MAAM;gBACT,MAAM,IAAI,cAAc,CACvB,QAAQ,EACR,qFAAqF,CACrF,CAAC;YACH,IAAI,YAAY,KAAK,MAAM;gBAC1B,MAAM,IAAI,cAAc,CACvB,aAAa,EACb,YAAY;oBACX,CAAC,CAAC,4HAA4H;oBAC9H,CAAC,CAAC,8FAA8F,EACjG,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,CACrD,CAAC;YACH,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;YACpC,MAAM,OAAO,GAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;YAC/C,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;YACzB,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC;YACnB,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YAC1B,IAAI,CAAC;gBACJ,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC;gBACzC,OAAO;oBACN,EAAE;oBACF,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,GAAG,EAAE,EAAE;oBACzB,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC;iBACnC,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;gBACrB,MAAM,KAAK,CAAC;YACb,CAAC;QACF,CAAC;QACD,KAAK,CAAC,KAAK;YACV,MAAM,GAAG,IAAI,CAAC;YACd,QAAQ,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,QAAQ,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;YAChC,SAAS,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,OAAO,CAAC,GAAG,CAChB,QAAQ,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CACzB,QAAQ,CAAC,SAAS,CAAC,IAAI,CACtB,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE;YAChC,8CAA8C;YAC9C,GAAG,EAAE,CAAC,SAAS,CACf,CACD,CACD,CAAC;QACH,CAAC;QACD,IAAI,QAAQ;YACX,OAAO,QAAQ,CAAC,IAAI,CAAC;QACtB,CAAC;KACD,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,OAAwB,EAAE,QAAwB;IACpE,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;IACtC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO;IACjC,QAAQ,CAAC,SAAS,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;IAC1D,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,kCAAkC,EAAE,MAAM,CAAC,CAAC;IAC/D,QAAQ,CAAC,SAAS,CACjB,8BAA8B,EAC9B,wCAAwC,CACxC,CAAC;IACF,QAAQ,CAAC,SAAS,CACjB,8BAA8B,EAC9B,OAAO,CAAC,OAAO,CAAC,gCAAgC,CAAC,IAAI,GAAG,CACxD,CAAC;IACF,QAAQ,CAAC,SAAS,CAAC,+BAA+B,EAAE,eAAe,CAAC,CAAC;IACrE,qEAAqE;IACrE,oEAAoE;IACpE,IAAI,OAAO,CAAC,OAAO,CAAC,wCAAwC,CAAC,KAAK,MAAM;QACvE,QAAQ,CAAC,SAAS,CAAC,sCAAsC,EAAE,MAAM,CAAC,CAAC;AACrE,CAAC"}

package/dist/shared/lib/async/arrivals.d.ts

@@ -0,0 +1,31 @@
+import type { Clock } from "../clock/index.js";
+export interface ArrivalWaitOptions {
+    /** Milliseconds to wait. Defaults to the value given at creation. */
+    readonly timeout?: number;
+}
+export interface Arrivals<T> {
+    push(item: T): void;
+    /**
+     * The next item `next` has not returned yet, waiting for one if needed.
+     * Items that arrived before the call count: a test that asks for the stream
+     * the page opened during `goto` must not miss it by asking too late.
+     */
+    next(options?: ArrivalWaitOptions): Promise<T>;
+    readonly items: readonly T[];
+    readonly latest: T | undefined;
+}
+export interface ArrivalsOptions {
+    readonly clock: Clock;
+    /** Names the thing being waited for in the TIMEOUT message. */
+    readonly label: string;
+    readonly timeout?: number;
+    /**
+     * What the waiter knows about why nothing arrived, added to the TIMEOUT
+     * message: "the page never asked" and "it asked, and the answer got
+     * lost" call for different fixes.
+     */
+    readonly hint?: () => string | undefined;
+}
+/** Things that show up over time — connections, calls, messages — and a way to await the next. */
+export declare function createArrivals<T>(options: ArrivalsOptions): Arrivals<T>;
+//# sourceMappingURL=arrivals.d.ts.map

package/dist/shared/lib/async/arrivals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrivals.d.ts","sourceRoot":"","sources":["../../../../src/shared/lib/async/arrivals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG/C,MAAM,WAAW,kBAAkB;IAClC,qEAAqE;IACrE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC;IAC1B,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACpB;;;;OAIG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CACzC;AAED,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,GAAG,QAAQ,CAAC,CAAC,CAAC,CAwDvE"}

package/dist/shared/lib/async/arrivals.js

@@ -0,0 +1,57 @@
+import { WirestageError } from "../errors/index.js";
+/** Things that show up over time — connections, calls, messages — and a way to await the next. */
+export function createArrivals(options) {
+    const items = [];
+    let cursor = 0;
+    const waiters = new Set();
+    const defaultTimeout = options.timeout ?? 5_000;
+    /** Resolves true on the next push, false when `ms` pass first. */
+    const pushedWithin = async (ms) => {
+        const abort = new AbortController();
+        let resolvePushed;
+        const pushed = new Promise((resolve) => {
+            resolvePushed = resolve;
+        });
+        const wake = () => resolvePushed(true);
+        waiters.add(wake);
+        const expired = options.clock
+            .sleep(ms, abort.signal)
+            .then(() => false)
+            .catch(() => true);
+        const result = await Promise.race([pushed, expired]);
+        waiters.delete(wake);
+        abort.abort();
+        return result;
+    };
+    return {
+        push(item) {
+            items.push(item);
+            for (const wake of [...waiters])
+                wake();
+        },
+        async next(waitOptions = {}) {
+            const timeout = waitOptions.timeout ?? defaultTimeout;
+            const deadline = options.clock.now() + timeout;
+            // A loop, not a single wait: two callers woken by one push race for
+            // one item, and the loser has to go back to waiting.
+            for (;;) {
+                if (cursor < items.length)
+                    return items[cursor++];
+                const remaining = deadline - options.clock.now();
+                if (remaining <= 0 || !(await pushedWithin(remaining))) {
+                    if (cursor < items.length)
+                        return items[cursor++];
+                    const hint = options.hint?.();
+                    throw new WirestageError("TIMEOUT", `no ${options.label} arrived within ${timeout} ms (${items.length} seen so far)${hint === undefined ? "" : `; ${hint}`}`, { details: { label: options.label, timeout, seen: items.length } });
+                }
+            }
+        },
+        get items() {
+            return items;
+        },
+        get latest() {
+            return items.at(-1);
+        },
+    };
+}
+//# sourceMappingURL=arrivals.js.map

package/dist/shared/lib/async/arrivals.js.map

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

package/dist/shared/lib/async/async-queue.d.ts

@@ -0,0 +1,23 @@
+export interface AsyncQueue<T> extends AsyncIterable<T> {
+    /**
+     * Queue a value. Resolves once the consumer has taken it and come back
+     * for the next — for a stream being written, once the value is on the
+     * wire. Rejects with `CLOSED` when the queue was closed first, or when
+     * the consumer went away before getting through the value.
+     */
+    push(value: T): Promise<void>;
+    /** End iteration once the queued values are consumed. */
+    close(): void;
+    /** End iteration with `reason` once the queued values are consumed. */
+    fail(reason: unknown): void;
+    readonly closed: boolean;
+    /** Values pushed but not consumed yet. */
+    readonly size: number;
+}
+/**
+ * A single-consumer queue that a test pushes into and a stream implementation
+ * iterates. Values pushed before the consumer starts are kept, so a test may
+ * queue the first messages before the page has even opened the stream.
+ */
+export declare function createAsyncQueue<T>(): AsyncQueue<T>;
+//# sourceMappingURL=async-queue.d.ts.map

package/dist/shared/lib/async/async-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-queue.d.ts","sourceRoot":"","sources":["../../../../src/shared/lib/async/async-queue.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU,CAAC,CAAC,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;IACtD;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,yDAAyD;IACzD,KAAK,IAAI,IAAI,CAAC;IACd,uEAAuE;IACvE,IAAI,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAOD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAsEnD"}