@heojeongbo/wirestage 0.1.1 → 0.3.0

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

@@ -0,0 +1,54 @@
+import { createServer, } from "node:http";
+import { listen } from "./listen.js";
+const headersOf = (message) => Object.fromEntries(Object.entries(message.headersDistinct).map(([name, values]) => [name, values.join(", ")]));
+const readBody = (message) => new Promise((resolve, reject) => {
+    const chunks = [];
+    message.on("data", (chunk) => chunks.push(chunk));
+    message.once("end", () => resolve(new Uint8Array(Buffer.concat(chunks))));
+    message.once("error", reject);
+});
+function responderOf(response) {
+    return {
+        send(status, headers, body) {
+            for (const [name, value] of Object.entries(headers))
+                response.setHeader(name, value.includes("\n") ? value.split("\n") : value);
+            response.statusCode = status;
+            return new Promise((resolve) => {
+                // `close` too: a client that went away never sees `finish`.
+                response.once("close", () => resolve());
+                response.end(body);
+            });
+        },
+        reset() {
+            response.destroy();
+        },
+    };
+}
+/**
+ * An HTTP/1.1 server for clients outside the browser, handing each request,
+ * body read, to `handle`. The handler is the caller's to make safe; one that
+ * throws anyway gets a 500 rather than a client left waiting, and closing the
+ * server drops open connections at once (`listen`).
+ */
+export async function serveHttp(options, handle) {
+    const server = createServer((message, response) => {
+        const responder = responderOf(response);
+        readBody(message)
+            .then((body) => handle({
+            // Always set on a request an http.Server received.
+            method: message.method,
+            url: new URL(message.url, listening.url),
+            headers: headersOf(message),
+            body,
+        }, responder))
+            .catch((error) => {
+            if (response.headersSent)
+                response.destroy();
+            else
+                void responder.send(500, { "content-type": "text/plain; charset=utf-8" }, `wirestage: ${options.name} failed: ${error instanceof Error ? error.message : String(error)}`);
+        });
+    });
+    const listening = await listen(server, { ...options, protocol: "http" });
+    return listening;
+}
+//# sourceMappingURL=serve.js.map

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

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

package/dist/widgets/stage/index.d.ts

@@ -1,3 +1,3 @@
 export { createStage } from "./lib/create-stage.js";
-export type { AttachOptions, ReportOptions, Stage, StageCore, StageOptions, StageReport, } from "./model/stage.js";
+export type { AttachOptions, MarkOptions, ReportOptions, Stage, StageCore, StageCursor, StageOptions, StageReport, } from "./model/stage.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/widgets/stage/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/widgets/stage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,YAAY,EACX,aAAa,EACb,aAAa,EACb,KAAK,EACL,SAAS,EACT,YAAY,EACZ,WAAW,GACX,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/widgets/stage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,YAAY,EACX,aAAa,EACb,WAAW,EACX,aAAa,EACb,KAAK,EACL,SAAS,EACT,WAAW,EACX,YAAY,EACZ,WAAW,GACX,MAAM,kBAAkB,CAAC"}

package/dist/widgets/stage/lib/create-stage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-stage.d.ts","sourceRoot":"","sources":["../../../../src/widgets/stage/lib/create-stage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,aAAa,EAIb,MAAM,mCAAmC,CAAC;AAiB3C,OAAO,KAAK,EAAE,KAAK,EAAa,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAsCxE;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,OAAO,SAAS,SAAS,aAAa,EAAE,EACzE,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,GAC5B,KAAK,CAAC,OAAO,CAAC,CA2OhB"}
+{"version":3,"file":"create-stage.d.ts","sourceRoot":"","sources":["../../../../src/widgets/stage/lib/create-stage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,aAAa,EAIb,MAAM,mCAAmC,CAAC;AAiB3C,OAAO,KAAK,EAAE,KAAK,EAAa,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAuCxE;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,OAAO,SAAS,SAAS,aAAa,EAAE,EACzE,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,GAC5B,KAAK,CAAC,OAAO,CAAC,CA4OhB"}

package/dist/widgets/stage/lib/create-stage.js

@@ -22,6 +22,7 @@ const RESERVED = new Set([
     "frames",
     "drain",
     "mark",
+    "cursor",
     "since",
     "between",
     "waitFor",
@@ -88,6 +89,7 @@ export function createStage(options) {
         timeline,
         clock,
         sync,
+        pageId,
         wait: {
             timeout: options.wait?.timeout ?? 5_000,
             interval: options.wait?.interval ?? 25,

package/dist/widgets/stage/lib/create-stage.js.map

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

package/dist/widgets/stage/lib/reads.d.ts

@@ -1,4 +1,5 @@
 import type { Timeline } from "../../../entities/frame/index.js";
+import type { PagePort } from "../../../shared/api/playwright/index.js";
 import type { Clock } from "../../../shared/lib/clock/index.js";
 import type { StageCore } from "../model/stage.js";
 export interface ReadsDeps {
@@ -6,13 +7,15 @@ export interface ReadsDeps {
     readonly clock: Clock;
     /** Flush every page buffer into the timeline. */
     readonly sync: () => Promise<void>;
+    /** The id frames use for a page. */
+    readonly pageId: (page: PagePort) => string;
     /** Defaults for `waitFor`, in milliseconds. */
     readonly wait: {
         readonly timeout: number;
         readonly interval: number;
     };
 }
-export type StageReads = Pick<StageCore, "frames" | "drain" | "mark" | "since" | "between" | "waitFor" | "report">;
+export type StageReads = Pick<StageCore, "frames" | "drain" | "mark" | "cursor" | "since" | "between" | "waitFor" | "report">;
 /**
  * The stage's reads of its timeline. Every one flushes the page buffers
  * first: that flush is what makes arrival order the order things happened in.

package/dist/widgets/stage/lib/reads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reads.d.ts","sourceRoot":"","sources":["../../../../src/widgets/stage/lib/reads.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGX,QAAQ,EACR,MAAM,kCAAkC,CAAC;AAE1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oCAAoC,CAAC;AAEhE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACvE;AASD,MAAM,MAAM,UAAU,GAAG,IAAI,CAC5B,SAAS,EACT,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CACxE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,CAmFvD"}
+{"version":3,"file":"reads.d.ts","sourceRoot":"","sources":["../../../../src/widgets/stage/lib/reads.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGX,QAAQ,EACR,MAAM,kCAAkC,CAAC;AAE1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAC;AACxE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oCAAoC,CAAC;AAEhE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,oCAAoC;IACpC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,MAAM,CAAC;IAC5C,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACvE;AASD,MAAM,MAAM,UAAU,GAAG,IAAI,CAC5B,SAAS,EACP,QAAQ,GACR,OAAO,GACP,MAAM,GACN,QAAQ,GACR,OAAO,GACP,SAAS,GACT,SAAS,GACT,QAAQ,CACV,CAAC;AAEF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,CAmHvD"}

package/dist/widgets/stage/lib/reads.js

@@ -29,17 +29,48 @@ export function createReads(deps) {
             await sync();
             return drainCursor.take(filter);
         },
-        async mark(name, meta) {
+        async mark(name, options = {}) {
             await sync();
+            const { page, meta } = options;
             return timeline.append({
                 protocol: "wirestage",
                 kind: "marker",
                 direction: "none",
                 endpoint: name,
                 source: "test",
+                ...(page === undefined
+                    ? {}
+                    : { page: typeof page === "string" ? page : deps.pageId(page) }),
                 ...(meta === undefined ? {} : { meta }),
             });
         },
+        cursor(base = {}) {
+            let position = 0;
+            const read = async (filter) => {
+                await sync();
+                const where = filter.where;
+                return timeline.frames({
+                    ...base,
+                    ...filter,
+                    after: Math.max(position, base.after ?? 0, filter.after ?? 0),
+                    where: (frame) => (base.where === undefined || base.where(frame)) &&
+                        (where === undefined || where(frame)),
+                });
+            };
+            return {
+                async take(filter = {}) {
+                    const frames = await read(filter);
+                    // Past everything that arrived, not just what matched: the next
+                    // take starts where this one looked.
+                    position = Math.max(position, timeline.last()?.seq ?? 0);
+                    return frames;
+                },
+                peek: (filter = {}) => read(filter),
+                get position() {
+                    return position;
+                },
+            };
+        },
         async since(marker, filter) {
             await sync();
             const after = requireMarker(marker).seq;

package/dist/widgets/stage/lib/reads.js.map

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

package/dist/widgets/stage/model/stage.d.ts

@@ -38,6 +38,32 @@ export interface StageReport {
     readonly snapshot: TimelineSnapshot;
     readonly text: string;
 }
+export interface MarkOptions {
+    /**
+     * The page the marker is about. The marker carries its id, so a read
+     * narrowed to that page (`{ page }`) includes it.
+     */
+    readonly page?: PagePort | string;
+    /** Anything else worth keeping on the marker. */
+    readonly meta?: Readonly<Record<string, unknown>>;
+}
+/**
+ * A reading position of its own on the timeline: what a helper that keeps a
+ * log per page, per channel or per check reads from, without moving the
+ * stage's `drain` or another cursor.
+ */
+export interface StageCursor {
+    /**
+     * Bring the timeline up to date, then take what reached it since this
+     * cursor last took — narrowed by the cursor's filter and `filter` — and
+     * move past all of it, matching or not.
+     */
+    take(filter?: FrameFilter): Promise<Frame[]>;
+    /** The same frames as `take`, without moving. */
+    peek(filter?: FrameFilter): Promise<Frame[]>;
+    /** The `seq` the cursor has read up to; 0 before its first take. */
+    readonly position: number;
+}
 export interface ReportOptions {
     /** Frames kept, counting back from the newest. Default 1,000. */
     readonly limit?: number;
@@ -69,7 +95,12 @@ export interface StageCore {
     /** Frames since the previous `drain` (any filter), narrowed by `filter`. */
     drain(filter?: FrameFilter): Promise<Frame[]>;
     /** Put a named marker on the timeline, after everything that happened so far. */
-    mark(name: string, meta?: Readonly<Record<string, unknown>>): Promise<Frame>;
+    mark(name: string, options?: MarkOptions): Promise<Frame>;
+    /**
+     * A cursor of its own, from the start of the timeline: every `take`
+     * returns what is new since the previous one.
+     */
+    cursor(filter?: FrameFilter): StageCursor;
     /** Frames after the most recent marker called `marker`. */
     since(marker: string, filter?: FrameFilter): Promise<Frame[]>;
     /** Frames between two markers, exclusive. */

package/dist/widgets/stage/model/stage.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@heojeongbo/wirestage",
-	"version": "0.1.1",
+	"version": "0.3.0",
 	"description": "Record, fake and fault-inject browser wire traffic in Playwright: REST, Connect, gRPC-web, gRPC, SSE, WebSocket and WebRTC data channels on one timeline.",
 	"type": "module",
 	"license": "MIT",

package/src/features/rest/index.ts

@@ -20,4 +20,6 @@ export type {
 	RestResolver,
 	RestRoute,
 	RestRouteOptions,
+	RestServeOptions,
+	RestServer,
 } from "./model/types.js";

package/src/features/rest/lib/calls.ts

@@ -1,5 +1,27 @@
 import type { Frame } from "../../../entities/frame/index.js";
-import type { RestCall } from "../model/types.js";
+import type { RestCall, RestPath } from "../model/types.js";
+import { compilePath } from "./path.js";
+
+export interface CallFilter {
+	readonly method?: string;
+	readonly path?: RestPath;
+}
+
+/** The calls of `frames` a `calls()` filter asks for. */
+export function filterCalls(
+	frames: readonly Frame[],
+	filter: CallFilter,
+	baseURL: string | undefined,
+): RestCall[] {
+	const matcher =
+		filter.path === undefined ? undefined : compilePath(filter.path, baseURL);
+	const wanted = filter.method?.toUpperCase();
+	return assembleCalls(frames).filter(
+		(call) =>
+			(wanted === undefined || wanted === call.method) &&
+			(matcher === undefined || matcher.match(new URL(call.url)) !== undefined),
+	);
+}
 
 /**
  * Pair each recorded request with how it ended. One call per exchange,
@@ -25,6 +47,10 @@ export function assembleCalls(frames: readonly Frame[]): RestCall[] {
 			request,
 			response: end?.kind === "response" ? end : undefined,
 			status: typeof status === "number" ? status : undefined,
+			server:
+				typeof request.meta["server"] === "string"
+					? request.meta["server"]
+					: undefined,
 		});
 	}
 	return calls;

package/src/features/rest/lib/create-rest.ts

@@ -5,15 +5,18 @@ import {
 	type WirePlugin,
 } from "../../../entities/plugin/index.js";
 import { createArrivals } from "../../../shared/lib/async/index.js";
+import { createSequence } from "../../../shared/lib/id/index.js";
 import type {
 	RestApi,
 	RestMethod,
 	RestOptions,
 	RestReply,
 	RestRequest,
+	RestServer,
 } from "../model/types.js";
-import { assembleCalls } from "./calls.js";
+import { filterCalls } from "./calls.js";
 import { compilePath } from "./path.js";
+import { serveRest } from "./serve.js";
 
 /**
  * REST and other plain HTTP: routes by method and path with `:params`, replies
@@ -27,6 +30,9 @@ export function rest(options: RestOptions = {}): WirePlugin<"rest", RestApi> {
 			const { name } = context;
 			/** The record rule being added, once: every context gets it. */
 			let recording: Promise<unknown> | undefined;
+			const servers = new Set<RestServer>();
+			// Under the plugin's own name: two instances never share an id.
+			const servedCorrelation = createSequence(`${name}-`);
 
 			const toOutcome = async (reply: RestReply): Promise<HttpOutcome> => {
 				switch (reply.kind) {
@@ -125,24 +131,34 @@ export function rest(options: RestOptions = {}): WirePlugin<"rest", RestApi> {
 				delete: verb("DELETE"),
 				async calls(filter = {}) {
 					await context.sync();
-					const matcher =
-						filter.path === undefined
-							? undefined
-							: compilePath(filter.path, options.baseURL);
-					const wanted = filter.method?.toUpperCase();
-					return assembleCalls(
+					return filterCalls(
 						context.timeline.frames({ protocol: name }),
-					).filter(
-						(call) =>
-							(wanted === undefined || wanted === call.method) &&
-							(matcher === undefined ||
-								matcher.match(new URL(call.url)) !== undefined),
+						filter,
+						options.baseURL,
 					);
 				},
+				async serve(serveOptions = {}) {
+					const server = await serveRest(
+						{
+							protocol: name,
+							timeline: context.timeline,
+							clock: context.clock,
+							log: context.log,
+							correlation: servedCorrelation,
+							onClose: (closed) => servers.delete(closed),
+						},
+						serveOptions,
+					);
+					servers.add(server);
+					return server;
+				},
 			};
 
 			return {
 				api,
+				async dispose() {
+					await Promise.all([...servers].map((server) => server.close()));
+				},
 				async attach() {
 					if (options.record === undefined || options.record === false) return;
 					const base = compilePath(`${options.baseURL ?? ""}/**`, undefined);