@heojeongbo/wirestage 0.1.1 → 0.3.0

package/README.md

@@ -62,7 +62,7 @@ ones you use.
 
 | Subpath | Plugin | Fakes | Records | Faults | Extra peers |
 | --- | --- | --- | --- | --- | --- |
-| `/rest` | `rest()` | routes with `:params`, `json`/`text`/`bytes` replies | requests and real responses | abort, delay, status | — |
+| `/rest` | `rest()` | routes with `:params`, `json`/`text`/`bytes` replies; servers for clients outside the browser | requests and real responses | abort, delay, status | — |
 | `/connect` | `connect()` | Connect, gRPC-web: unary, server streams, whole services | decoded messages and status | fail, abort, hold, cut | `@connectrpc/connect`, `@connectrpc/connect-node`, `@bufbuild/protobuf` |
 | `/sse` | `sse()` | event streams driven from the test | events sent | end, cut | — |
 | `/websocket` | `websocket()` | a fake server, or a proxy in front of the real one | both directions | drop, close | — |

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

@@ -1,5 +1,5 @@
 export { rest } from "./lib/create-rest.js";
 export type { ReplyInit } from "./lib/reply.js";
 export { abort, bytes, delay, empty, json, passthrough, text, } from "./lib/reply.js";
-export type { RestApi, RestCall, RestMethod, RestOptions, RestPath, RestReply, RestRequest, RestResolver, RestRoute, RestRouteOptions, } from "./model/types.js";
+export type { RestApi, RestCall, RestMethod, RestOptions, RestPath, RestReply, RestRequest, RestResolver, RestRoute, RestRouteOptions, RestServeOptions, RestServer, } from "./model/types.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/rest/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EACN,KAAK,EACL,KAAK,EACL,KAAK,EACL,KAAK,EACL,IAAI,EACJ,WAAW,EACX,IAAI,GACJ,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACX,OAAO,EACP,QAAQ,EACR,UAAU,EACV,WAAW,EACX,QAAQ,EACR,SAAS,EACT,WAAW,EACX,YAAY,EACZ,SAAS,EACT,gBAAgB,GAChB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/rest/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EACN,KAAK,EACL,KAAK,EACL,KAAK,EACL,KAAK,EACL,IAAI,EACJ,WAAW,EACX,IAAI,GACJ,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACX,OAAO,EACP,QAAQ,EACR,UAAU,EACV,WAAW,EACX,QAAQ,EACR,SAAS,EACT,WAAW,EACX,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,GACV,MAAM,kBAAkB,CAAC"}

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

@@ -1,5 +1,11 @@
 import type { Frame } from "../../../entities/frame/index.js";
-import type { RestCall } from "../model/types.js";
+import type { RestCall, RestPath } from "../model/types.js";
+export interface CallFilter {
+    readonly method?: string;
+    readonly path?: RestPath;
+}
+/** The calls of `frames` a `calls()` filter asks for. */
+export declare function filterCalls(frames: readonly Frame[], filter: CallFilter, baseURL: string | undefined): RestCall[];
 /**
  * Pair each recorded request with how it ended. One call per exchange,
  * oldest first; a frame with no correlation is an exchange of its own.

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

@@ -1 +1 @@
-{"version":3,"file":"calls.d.ts","sourceRoot":"","sources":["../../../../src/features/rest/lib/calls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,QAAQ,EAAE,CAuBlE"}
+{"version":3,"file":"calls.d.ts","sourceRoot":"","sources":["../../../../src/features/rest/lib/calls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG5D,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;CACzB;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAC1B,MAAM,EAAE,SAAS,KAAK,EAAE,EACxB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,MAAM,GAAG,SAAS,GACzB,QAAQ,EAAE,CASZ;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,QAAQ,EAAE,CA2BlE"}

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

@@ -1,3 +1,11 @@
+import { compilePath } from "./path.js";
+/** The calls of `frames` a `calls()` filter asks for. */
+export function filterCalls(frames, filter, baseURL) {
+    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,
  * oldest first; a frame with no correlation is an exchange of its own.
@@ -25,6 +33,9 @@ export function assembleCalls(frames) {
             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/dist/features/rest/lib/calls.js.map

@@ -1 +1 @@
-{"version":3,"file":"calls.js","sourceRoot":"","sources":["../../../../src/features/rest/lib/calls.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAAwB;IACrD,MAAM,MAAM,GAAG,IAAI,GAAG,EAA4C,CAAC;IACnE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,IAAI,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACpC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC;;YAC/C,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC;QACvB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACxB,CAAC;IACD,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC;QACtD,IAAI,OAAO,KAAK,SAAS;YAAE,SAAS;QACpC,MAAM,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC;YACV,WAAW;YACX,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChC,OAAO;YACP,QAAQ,EAAE,GAAG,EAAE,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;YACpD,MAAM,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;SACvD,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC"}
+{"version":3,"file":"calls.js","sourceRoot":"","sources":["../../../../src/features/rest/lib/calls.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAOxC,yDAAyD;AACzD,MAAM,UAAU,WAAW,CAC1B,MAAwB,EACxB,MAAkB,EAClB,OAA2B;IAE3B,MAAM,OAAO,GACZ,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;IAC5C,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,MAAM,CAClC,CAAC,IAAI,EAAE,EAAE,CACR,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC;QAChD,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,SAAS,CAAC,CAC1E,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAAwB;IACrD,MAAM,MAAM,GAAG,IAAI,GAAG,EAA4C,CAAC;IACnE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,IAAI,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACpC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC;;YAC/C,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC;QACvB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACxB,CAAC;IACD,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC;QACtD,IAAI,OAAO,KAAK,SAAS;YAAE,SAAS;QACpC,MAAM,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC;YACV,WAAW;YACX,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChC,OAAO;YACP,QAAQ,EAAE,GAAG,EAAE,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;YACpD,MAAM,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;YACvD,MAAM,EACL,OAAO,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,QAAQ;gBACzC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;gBACxB,CAAC,CAAC,SAAS;SACb,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/features/rest/lib/create-rest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-rest.d.ts","sourceRoot":"","sources":["../../../../src/features/rest/lib/create-rest.ts"],"names":[],"mappings":"AAAA,OAAO,EAIN,KAAK,UAAU,EACf,MAAM,mCAAmC,CAAC;AAE3C,OAAO,KAAK,EACX,OAAO,EAEP,WAAW,EAGX,MAAM,mBAAmB,CAAC;AAI3B;;;GAGG;AACH,wBAAgB,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAmJ3E"}
+{"version":3,"file":"create-rest.d.ts","sourceRoot":"","sources":["../../../../src/features/rest/lib/create-rest.ts"],"names":[],"mappings":"AAAA,OAAO,EAIN,KAAK,UAAU,EACf,MAAM,mCAAmC,CAAC;AAG3C,OAAO,KAAK,EACX,OAAO,EAEP,WAAW,EAIX,MAAM,mBAAmB,CAAC;AAK3B;;;GAGG;AACH,wBAAgB,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAgK3E"}

package/dist/features/rest/lib/create-rest.js

@@ -1,7 +1,9 @@
 import { definePlugin, } from "../../../entities/plugin/index.js";
 import { createArrivals } from "../../../shared/lib/async/index.js";
-import { assembleCalls } from "./calls.js";
+import { createSequence } from "../../../shared/lib/id/index.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
  * built from small helpers, faults, and recording of the real responses.
@@ -14,6 +16,9 @@ export function rest(options = {}) {
             const { name } = context;
             /** The record rule being added, once: every context gets it. */
             let recording;
+            const servers = new Set();
+            // Under the plugin's own name: two instances never share an id.
+            const servedCorrelation = createSequence(`${name}-`);
             const toOutcome = async (reply) => {
                 switch (reply.kind) {
                     case "response":
@@ -98,17 +103,26 @@ export function rest(options = {}) {
                 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(context.timeline.frames({ protocol: name })).filter((call) => (wanted === undefined || wanted === call.method) &&
-                        (matcher === undefined ||
-                            matcher.match(new URL(call.url)) !== undefined));
+                    return filterCalls(context.timeline.frames({ protocol: name }), 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;

package/dist/features/rest/lib/create-rest.js.map

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

package/dist/features/rest/lib/serve.d.ts

@@ -0,0 +1,21 @@
+import type { Timeline } from "../../../entities/frame/index.js";
+import type { Clock } from "../../../shared/lib/clock/index.js";
+import type { ScopedLogger } from "../../../shared/lib/logger/index.js";
+import type { RestServeOptions, RestServer } from "../model/types.js";
+export interface ServeDeps {
+    /** The protocol the server's frames are recorded under. */
+    readonly protocol: string;
+    readonly timeline: Timeline;
+    readonly clock: Clock;
+    readonly log: ScopedLogger;
+    readonly correlation: () => string;
+    /** Told when the server closes, so the plugin can forget it. */
+    readonly onClose: (server: RestServer) => void;
+}
+/**
+ * A served fake: routes, newest first, as the browser's are; every exchange
+ * on the timeline, the client's request as `network` and the answer as
+ * `server`.
+ */
+export declare function serveRest(deps: ServeDeps, options: RestServeOptions): Promise<RestServer>;
+//# sourceMappingURL=serve.d.ts.map

package/dist/features/rest/lib/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../../../src/features/rest/lib/serve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAU5E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oCAAoC,CAAC;AAEhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,KAAK,EAMX,gBAAgB,EAChB,UAAU,EACV,MAAM,mBAAmB,CAAC;AAI3B,MAAM,WAAW,SAAS;IACzB,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC;IACnC,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;CAC/C;AA0CD;;;;GAIG;AACH,wBAAsB,SAAS,CAC9B,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,gBAAgB,GACvB,OAAO,CAAC,UAAU,CAAC,CA6PrB"}

package/dist/features/rest/lib/serve.js

@@ -0,0 +1,223 @@
+import { serveHttp, } from "../../../shared/api/http-server/index.js";
+import { createArrivals, } from "../../../shared/lib/async/index.js";
+import { WirestageError } from "../../../shared/lib/errors/index.js";
+import { filterCalls } from "./calls.js";
+import { compilePath } from "./path.js";
+const TEXT = { "content-type": "text/plain; charset=utf-8" };
+const failureOf = (error) => error instanceof Error ? error.message : String(error);
+/** A served request as a route sees it, with that route's params. */
+function restRequest(request, correlation, params) {
+    const text = () => new TextDecoder().decode(request.body);
+    return {
+        correlation,
+        method: request.method,
+        url: request.url,
+        headers: request.headers,
+        page: undefined,
+        context: "",
+        resourceType: "other",
+        body: () => request.body,
+        text,
+        json: () => JSON.parse(text()),
+        params,
+        query: request.url.searchParams,
+    };
+}
+/**
+ * A served fake: routes, newest first, as the browser's are; every exchange
+ * on the timeline, the client's request as `network` and the answer as
+ * `server`.
+ */
+export async function serveRest(deps, options) {
+    const name = options.name ?? `${deps.protocol} server`;
+    /** Routes, oldest first. */
+    const routes = [];
+    let url = "";
+    const record = (init, path) => deps.timeline.append({
+        protocol: deps.protocol,
+        endpoint: path,
+        ...init,
+        meta: { ...init.meta, server: url },
+    });
+    const retire = (route) => {
+        if (!route.active)
+            return;
+        route.active = false;
+        routes.splice(routes.indexOf(route), 1);
+    };
+    /** Carry a reply out; `undefined` when it passes the request on. */
+    const answer = async (reply, response, path, correlation) => {
+        switch (reply.kind) {
+            case "response": {
+                const body = reply.body ?? "";
+                // Recorded before it is sent: a client that reads its answer and
+                // asks for `calls()` at once must find it there.
+                record({
+                    kind: "response",
+                    direction: "in",
+                    source: "server",
+                    data: body,
+                    meta: { status: reply.status, headers: reply.headers },
+                    correlation,
+                }, path);
+                await response.send(reply.status, reply.headers, body);
+                return "answered";
+            }
+            case "passthrough":
+                return undefined;
+            case "abort":
+                record({
+                    kind: "fault",
+                    direction: "none",
+                    source: "server",
+                    meta: { reason: "abort", error: reply.error },
+                    correlation,
+                }, path);
+                response.reset();
+                return "answered";
+            case "delay":
+                await deps.clock.sleep(reply.ms);
+                return answer(reply.reply, response, path, correlation);
+        }
+    };
+    /** A route's bug: logged, on the timeline, and the client gets a 500 saying so. */
+    const fail = async (route, error, response, path, correlation) => {
+        deps.log.error("rule failed", { rule: route.label, server: name }, error);
+        record({
+            kind: "fault",
+            direction: "none",
+            source: "server",
+            meta: {
+                reason: "rule-error",
+                rule: route.label,
+                error: failureOf(error),
+            },
+            correlation,
+        }, path);
+        await response.send(500, TEXT, `wirestage: rule "${route.label}" failed: ${failureOf(error)}`);
+    };
+    const handle = async (request, response) => {
+        const correlation = deps.correlation();
+        const path = request.url.pathname;
+        record({
+            kind: "request",
+            direction: "out",
+            source: "network",
+            data: request.body,
+            meta: {
+                method: request.method,
+                url: request.url.href,
+                headers: request.headers,
+            },
+            correlation,
+        }, path);
+        // The chain as it stands now: a route added while this one waits on a
+        // resolver takes the next request, not this one.
+        for (const route of [...routes].reverse()) {
+            if (!route.active)
+                continue;
+            if (route.method !== undefined && route.method !== request.method)
+                continue;
+            const params = route.matcher.match(request.url);
+            if (params === undefined)
+                continue;
+            const view = restRequest(request, correlation, params);
+            try {
+                if (route.match !== undefined && !route.match(view))
+                    continue;
+                // Claimed before the resolver runs, which may wait: two requests
+                // at once cannot both take a route's last turn.
+                route.hits += 1;
+                if (route.remaining !== undefined && --route.remaining === 0)
+                    retire(route);
+                route.requests.push(view);
+                const reply = typeof route.resolver === "function"
+                    ? await route.resolver(view)
+                    : route.resolver;
+                if ((await answer(reply, response, path, correlation)) !== undefined)
+                    return;
+            }
+            catch (error) {
+                await fail(route, error, response, path, correlation);
+                return;
+            }
+        }
+        record({
+            kind: "response",
+            direction: "in",
+            source: "server",
+            data: "",
+            meta: { status: 404, headers: TEXT, unmatched: true },
+            correlation,
+        }, path);
+        await response.send(404, TEXT, `wirestage: ${name} has no route for ${request.method} ${path}`);
+    };
+    const listening = await serveHttp({
+        name,
+        ...(options.host === undefined ? {} : { host: options.host }),
+        ...(options.port === undefined ? {} : { port: options.port }),
+    }, handle);
+    url = listening.url;
+    const on = async (method, path, resolver, routeOptions = {}) => {
+        if (routeOptions.times !== undefined &&
+            (!Number.isInteger(routeOptions.times) || routeOptions.times < 1))
+            throw new WirestageError("INVALID_ARGUMENT", `route "${method} ${String(path)}": times must be a positive integer, got ${routeOptions.times}`);
+        const label = `${method} ${String(path)}`;
+        const route = {
+            label,
+            method: method === "*" ? undefined : method,
+            matcher: compilePath(path, options.baseURL),
+            resolver,
+            match: routeOptions.match,
+            requests: createArrivals({
+                clock: deps.clock,
+                label: `${label} request to ${name}`,
+            }),
+            remaining: routeOptions.times,
+            hits: 0,
+            active: true,
+        };
+        routes.push(route);
+        return {
+            get hits() {
+                return route.hits;
+            },
+            get requests() {
+                return route.requests.items;
+            },
+            next: (waitOptions) => route.requests.next(waitOptions),
+            async remove() {
+                retire(route);
+            },
+        };
+    };
+    const verb = (method) => (path, resolver, routeOptions) => on(method, path, resolver, routeOptions);
+    let closing;
+    const server = {
+        url,
+        port: listening.port,
+        on,
+        get: verb("GET"),
+        post: verb("POST"),
+        put: verb("PUT"),
+        patch: verb("PATCH"),
+        delete: verb("DELETE"),
+        async calls(filter = {}) {
+            return filterCalls(deps.timeline.frames({
+                protocol: deps.protocol,
+                where: (frame) => frame.meta["server"] === url,
+            }), filter, options.baseURL);
+        },
+        close() {
+            closing ??= (async () => {
+                for (const route of [...routes])
+                    retire(route);
+                deps.onClose(server);
+                await listening.close();
+            })();
+            return closing;
+        },
+    };
+    return server;
+}
+//# sourceMappingURL=serve.js.map

package/dist/features/rest/lib/serve.js.map

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

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

@@ -12,6 +12,11 @@ export interface RestOptions {
      */
     readonly record?: boolean | UrlMatcher;
 }
+/**
+ * A request a route is deciding about. For a request a served fake received
+ * (`serve()`), `page` is undefined, `context` is empty and `resourceType` is
+ * `other`.
+ */
 export interface RestRequest extends HttpRequestView {
     /** `:name` segments of the matched path. */
     readonly params: Readonly<Record<string, string>>;
@@ -56,6 +61,35 @@ export interface RestCall {
     readonly response: Frame | undefined;
     /** The HTTP status; undefined for an aborted or unfinished request. */
     readonly status: number | undefined;
+    /** The served fake that received it (its URL); undefined for a page's. */
+    readonly server: string | undefined;
+}
+export interface RestServeOptions {
+    /** 0, the default, picks a free port. A fixed port that is taken fails, naming the server. */
+    readonly port?: number;
+    /** Default 127.0.0.1. */
+    readonly host?: string;
+    /** Names the server in errors, 404s and logs. Default `<plugin> server`. */
+    readonly name?: string;
+    /** A path prefix the server's routes are relative to. */
+    readonly baseURL?: string;
+}
+/**
+ * A fake HTTP backend for clients outside the browser — a service under
+ * test, an agent — routed and recorded like the page's own requests. A route
+ * that passes a request through hands it to the next older route; with none
+ * left, the server answers 404.
+ */
+export interface RestServer extends Pick<RestApi, "on" | "get" | "post" | "put" | "patch" | "delete"> {
+    readonly url: string;
+    readonly port: number;
+    /** This server's calls, oldest first. */
+    calls(filter?: {
+        readonly method?: string;
+        readonly path?: RestPath;
+    }): Promise<RestCall[]>;
+    /** Stop accepting and drop open connections. The stage closes it too. */
+    close(): Promise<void>;
 }
 export type RestPath = string | RegExp;
 export interface RestApi {
@@ -65,10 +99,12 @@ export interface RestApi {
     put(path: RestPath, resolver: RestResolver, options?: RestRouteOptions): Promise<RestRoute>;
     patch(path: RestPath, resolver: RestResolver, options?: RestRouteOptions): Promise<RestRoute>;
     delete(path: RestPath, resolver: RestResolver, options?: RestRouteOptions): Promise<RestRoute>;
-    /** Recorded REST exchanges, oldest first. */
+    /** Recorded REST exchanges, oldest first: the pages' and served fakes'. */
     calls(filter?: {
         readonly method?: string;
         readonly path?: RestPath;
     }): Promise<RestCall[]>;
+    /** Serve routes on a port of their own, for clients outside the browser. */
+    serve(options?: RestServeOptions): Promise<RestServer>;
 }
 //# sourceMappingURL=types.d.ts.map

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

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

package/dist/index.d.ts

@@ -22,6 +22,6 @@ export type { LogScope, LogThreshold, ScopedLogger, } from "./shared/lib/logger/
 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 type { AttachOptions, MarkOptions, ReportOptions, Stage, StageCore, StageCursor, 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

@@ -1 +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"}
+{"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,WAAW,EACX,aAAa,EACb,KAAK,EACL,SAAS,EACT,WAAW,EACX,YAAY,EACZ,WAAW,GACX,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js.map

@@ -1 +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"}
+{"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;AAWhE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC"}

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

@@ -1,3 +1,5 @@
 export type { Listening, ListenOptions } from "./listen.js";
 export { listen } from "./listen.js";
+export type { RequestHandler, ServedRequest, ServedResponse, } from "./serve.js";
+export { serveHttp } from "./serve.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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;AACrC,YAAY,EACX,cAAc,EACd,aAAa,EACb,cAAc,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

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

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

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

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared/api/http-server/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAMrC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,29 @@
+import { type Listening, type ListenOptions } from "./listen.js";
+/** A request a served fake received, read in full before it is handed on. */
+export interface ServedRequest {
+    readonly method: string;
+    /** Absolute: the server's origin, then the path and query the client sent. */
+    readonly url: URL;
+    /** Lower-cased names; a repeated header's values joined with `, `. */
+    readonly headers: Readonly<Record<string, string>>;
+    readonly body: Uint8Array;
+}
+/** The answer to a {@link ServedRequest}: one of the two, once. */
+export interface ServedResponse {
+    /**
+     * Send a complete response. A header may carry several values separated
+     * by a newline (`set-cookie`). Resolves once it is written.
+     */
+    send(status: number, headers: Readonly<Record<string, string>>, body: Uint8Array | string): Promise<void>;
+    /** Drop the connection: no status, no body — a network failure. */
+    reset(): void;
+}
+export type RequestHandler = (request: ServedRequest, response: ServedResponse) => void | Promise<void>;
+/**
+ * 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 declare function serveHttp(options: Omit<ListenOptions, "protocol">, handle: RequestHandler): Promise<Listening>;
+//# sourceMappingURL=serve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../../../src/shared/api/http-server/serve.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAU,MAAM,aAAa,CAAC;AAEzE,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC1B;AAED,mEAAmE;AACnE,MAAM,WAAW,cAAc;IAC9B;;;OAGG;IACH,IAAI,CACH,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACzC,IAAI,EAAE,UAAU,GAAG,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,mEAAmE;IACnE,KAAK,IAAI,IAAI,CAAC;CACd;AAED,MAAM,MAAM,cAAc,GAAG,CAC5B,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,cAAc,KACpB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAsC1B;;;;;GAKG;AACH,wBAAsB,SAAS,CAC9B,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,EACxC,MAAM,EAAE,cAAc,GACpB,OAAO,CAAC,SAAS,CAAC,CA4BpB"}