@heojeongbo/wirestage 0.0.0-stage → 0.1.0

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

@@ -0,0 +1,71 @@
+import { concatBytes } from "../../../shared/lib/bytes/index.js";
+import { WirestageError } from "../../../shared/lib/errors/index.js";
+/** A Playwright request, as the request Connect's handlers expect. */
+export function toUniversalRequest(view, contextValues, signal = new AbortController().signal) {
+    const body = view.body();
+    return {
+        httpVersion: "1.1",
+        url: view.url.href,
+        method: view.method,
+        header: new Headers(view.headers),
+        body: (async function* () {
+            if (body.byteLength > 0)
+                yield body;
+        })(),
+        signal,
+        contextValues,
+    };
+}
+/**
+ * A response's headers as a plain record. `set-cookie` keeps every value,
+ * one per line, which is how a route and a Node response take several.
+ */
+function headersOf(response) {
+    const headers = {};
+    response.header?.forEach((value, name) => {
+        headers[name] = value;
+    });
+    const cookies = response.header?.getSetCookie() ?? [];
+    if (cookies.length > 1)
+        headers["set-cookie"] = cookies.join("\n");
+    return headers;
+}
+/**
+ * Connect and gRPC-web carry their trailers in the headers or the body; only
+ * native gRPC needs HTTP trailers, which neither a route nor the stream
+ * server sends — and which a browser could not have asked for anyway.
+ */
+function refuseTrailers(response) {
+    let trailers = 0;
+    response.trailer?.forEach(() => {
+        trailers += 1;
+    });
+    if (trailers > 0)
+        throw new WirestageError("UNSUPPORTED", "this response needs HTTP trailers (native gRPC), which a browser route cannot send; use serve() for gRPC clients");
+}
+/** Read a handler's whole response, for `route.fulfill`. */
+export async function collectResponse(response) {
+    const chunks = [];
+    for await (const chunk of response.body ?? [])
+        chunks.push(chunk);
+    refuseTrailers(response);
+    return {
+        status: response.status,
+        headers: headersOf(response),
+        body: concatBytes(chunks),
+    };
+}
+/**
+ * Write a handler's response to an open stream as the handler produces it:
+ * the head with the first chunk, as a real Connect server sends it, and each
+ * message as soon as the implementation yields it.
+ */
+export async function pipeResponse(response, stream) {
+    stream.head(response.status, headersOf(response));
+    // A streaming handler always answers with a body, error trailers included.
+    for await (const chunk of response.body)
+        await stream.write(chunk);
+    refuseTrailers(response);
+    await stream.end();
+}
+//# sourceMappingURL=universal.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"universal.js","sourceRoot":"","sources":["../../../../src/features/connect/lib/universal.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAErE,sEAAsE;AACtE,MAAM,UAAU,kBAAkB,CACjC,IAAqB,EACrB,aAA4B,EAC5B,SAAsB,IAAI,eAAe,EAAE,CAAC,MAAM;IAElD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACzB,OAAO;QACN,WAAW,EAAE,KAAK;QAClB,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI;QAClB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QACjC,IAAI,EAAE,CAAC,KAAK,SAAS,CAAC;YACrB,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC;gBAAE,MAAM,IAAI,CAAC;QACrC,CAAC,CAAC,EAAE;QACJ,MAAM;QACN,aAAa;KACb,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,SAAS,CAAC,QAAiC;IACnD,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACxC,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACvB,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IACtD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnE,OAAO,OAAO,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,QAAiC;IACxD,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE;QAC9B,QAAQ,IAAI,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;IACH,IAAI,QAAQ,GAAG,CAAC;QACf,MAAM,IAAI,cAAc,CACvB,aAAa,EACb,kHAAkH,CAClH,CAAC;AACJ,CAAC;AAQD,4DAA4D;AAC5D,MAAM,CAAC,KAAK,UAAU,eAAe,CACpC,QAAiC;IAEjC,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,QAAQ,CAAC,IAAI,IAAI,EAAE;QAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACzB,OAAO;QACN,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,OAAO,EAAE,SAAS,CAAC,QAAQ,CAAC;QAC5B,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC;KACzB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CACjC,QAAiC,EACjC,MAAsB;IAEtB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClD,2EAA2E;IAC3E,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,QAAQ,CAAC,IAAiC;QACnE,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3B,cAAc,CAAC,QAAQ,CAAC,CAAC;IACzB,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;AACpB,CAAC"}

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

@@ -0,0 +1,247 @@
+import type { DescMessage, DescMethod, DescMethodServerStreaming, DescMethodUnary, DescService, JsonReadOptions, JsonWriteOptions, MessageInitShape, MessageShape } from "@bufbuild/protobuf";
+import type { Client, Code, ConnectRouter, HandlerContext, ServiceImpl } from "@connectrpc/connect";
+import type { Frame, FrameSource } from "../../../entities/frame/index.js";
+import type { AbortErrorCode, HttpRequestView, StreamEnd as ResponseEnd } from "../../../entities/plugin/index.js";
+import type { CookieJarPort } from "../../../shared/api/playwright/index.js";
+/** The three wire protocols connect-es speaks. Browsers use the first two. */
+export type RpcProtocol = "connect" | "grpc-web" | "grpc";
+export interface ConnectOptions {
+    /**
+     * What the app's transport puts in front of `/<package>.<Service>/<Method>`:
+     * a path prefix (`/api`) on any origin, or an origin with one
+     * (`https://api.example.test/rpc`). Without it a stub matches that suffix
+     * under any prefix. It is also where `client()` calls by default.
+     */
+    readonly baseURL?: string;
+    /**
+     * Protocols stubs answer. Default: connect and grpc-web — the two a browser
+     * can speak. A call in another protocol passes every stub by. Native gRPC
+     * is for `serve()`.
+     */
+    readonly protocols?: readonly RpcProtocol[];
+    /**
+     * Services whose traffic is recorded and decoded even when nothing stubs
+     * it, so `calls()` sees the real backend's answers too.
+     */
+    readonly record?: readonly DescService[];
+    /**
+     * `live` (default) answers server streams from a local server, message by
+     * message, as the stub produces them. `buffered` collects the whole stream
+     * and fulfills it at once — the only choice on an https page without
+     * `streamServer.tls`, and only useful for streams that end.
+     */
+    readonly streaming?: "live" | "buffered";
+    /** The protocol `client()` uses by default. Default `connect`. */
+    readonly clientProtocol?: RpcProtocol;
+    readonly jsonOptions?: Partial<JsonReadOptions & JsonWriteOptions>;
+}
+export interface HoldOptions<I extends DescMessage = DescMessage> {
+    /** Take this many calls, then leave the rest to the next rule. */
+    readonly times?: number;
+    /**
+     * Take only the calls this accepts; the rest go on to the next rule, or to
+     * the real backend. Gets the decoded request message, and the raw request
+     * for its headers. A request that does not decode never matches.
+     */
+    readonly match?: (request: MessageShape<I>, view: HttpRequestView) => boolean;
+}
+export interface StubOptions<I extends DescMessage = DescMessage> extends HoldOptions<I> {
+    /** Wait this long before answering. */
+    readonly delayMs?: number;
+}
+export interface StubHandle {
+    /** Calls this stub took. */
+    readonly hits: number;
+    remove(): Promise<void>;
+}
+export type UnaryReply<I extends DescMessage, O extends DescMessage> = MessageInitShape<O> | ((request: MessageShape<I>, context: HandlerContext) => MessageInitShape<O> | Promise<MessageInitShape<O>>);
+export interface UnaryStub<I extends DescMessage> extends StubHandle {
+    /** Requests received so far, decoded. */
+    readonly requests: readonly MessageShape<I>[];
+    /** The next request this stub receives (or already received and nobody took). */
+    next(options?: {
+        readonly timeout?: number;
+    }): Promise<MessageShape<I>>;
+}
+/**
+ * How a test-driven stream ended: cleanly, with an error status (`failed`),
+ * reset by the test (`cut`), or let go of by the page (`cancelled`).
+ */
+export type StreamEnd = ResponseEnd | "failed";
+export interface StreamCall<I extends DescMessage, O extends DescMessage> {
+    readonly request: MessageShape<I>;
+    readonly requestHeaders: Headers;
+    /** The protocol the page called with; undefined for an unidentified call. */
+    readonly protocol: RpcProtocol | undefined;
+    /**
+     * Send a message. Messages go out in order; this resolves once the
+     * message is written, and rejects with `CLOSED` when the stream ended
+     * before it was.
+     */
+    send(message: MessageInitShape<O>): Promise<void>;
+    /** End with OK. Resolves once the stream is over. */
+    end(): Promise<void>;
+    /** End with an error status. Resolves once the stream is over. */
+    fail(code: Code, message?: string): Promise<void>;
+    /**
+     * Reset the connection mid-stream: no status, no trailer — what a network
+     * drop looks like to the client. Recorded as a `cut` fault, not a status.
+     */
+    cut(): Promise<void>;
+    readonly closed: Promise<StreamEnd>;
+}
+export interface StreamStub<I extends DescMessage, O extends DescMessage> extends StubHandle {
+    /** The next call the page opens (or already opened and nobody took). */
+    next(options?: {
+        readonly timeout?: number;
+    }): Promise<StreamCall<I, O>>;
+    readonly calls: readonly StreamCall<I, O>[];
+    /** Send to every open call. */
+    broadcast(message: MessageInitShape<O>): Promise<void>;
+}
+/**
+ * A call held at the network boundary until the test decides. Each decision
+ * resolves once it is carried out, so `calls()` right after one sees it; the
+ * first decision stands and later ones do nothing.
+ */
+export interface HeldCall<I extends DescMessage, O extends DescMessage> {
+    readonly request: MessageShape<I> | undefined;
+    readonly view: HttpRequestView;
+    /**
+     * Let it go on: to the next rule that matches it, and to the real backend
+     * when there is none.
+     */
+    release(): Promise<void>;
+    /** Answer it with this message. */
+    reply(message: MessageInitShape<O>): Promise<void>;
+    /** Answer it with an error status. */
+    fail(code: Code, message?: string): Promise<void>;
+    /** Fail it at the network level. */
+    abort(error?: AbortErrorCode): Promise<void>;
+}
+export interface HoldStub<I extends DescMessage, O extends DescMessage> extends StubHandle {
+    next(options?: {
+        readonly timeout?: number;
+    }): Promise<HeldCall<I, O>>;
+    readonly calls: readonly HeldCall<I, O>[];
+    /**
+     * Stop holding: every call held so far goes on, and so does every later
+     * one. A call already decided stays decided.
+     */
+    releaseAll(): Promise<void>;
+}
+/** One recorded RPC, reassembled from its frames. */
+export interface RpcCall<I extends DescMessage, O extends DescMessage> {
+    readonly correlation: string;
+    /**
+     * Who made the call: `page`, `test` for a drive client, `network` for a
+     * client outside the browser calling a served fake. Undefined when the
+     * request never read as an RPC.
+     */
+    readonly caller: FrameSource | undefined;
+    /**
+     * Who answered: `stub`, `network` for the real backend, `server` for a
+     * served fake. Undefined while nobody has.
+     */
+    readonly answeredBy: FrameSource | undefined;
+    /** The page that made the call (`p1`, ...); undefined for a drive client's. */
+    readonly page: string | undefined;
+    /** Its browser context (`c1`, ...); undefined for a drive client's. */
+    readonly context: string | undefined;
+    readonly protocol: RpcProtocol | undefined;
+    /** The first request message. */
+    readonly request: MessageShape<I> | undefined;
+    readonly requests: readonly MessageShape<I>[];
+    readonly responses: readonly MessageShape<O>[];
+    /** Undefined while the call is open, and when it ended in a fault. Code 0 is OK. */
+    readonly status: {
+        readonly code: number;
+        readonly message: string;
+    } | undefined;
+    /**
+     * Why the call ended without a status: `abort` (a stub failed it), `cut`
+     * (the test reset the stream), `cancelled` (the page let go), `network`
+     * (the connection to the real backend failed).
+     */
+    readonly fault: string | undefined;
+    readonly frames: readonly Frame[];
+}
+export interface ClientOptions {
+    /** Absolute, or a path resolved against the stage's base URL. */
+    readonly baseURL?: string;
+    readonly protocol?: RpcProtocol;
+    /** Protobuf binary (default) or JSON on the wire. */
+    readonly binary?: boolean;
+    /** Sent with every call that does not set the header itself. */
+    readonly headers?: Readonly<Record<string, string>>;
+    /**
+     * Share a browser context's cookie jar: its cookies go out on the call, so
+     * the call is made as the signed-in page, and the cookies a response sets
+     * — an error response included — are kept in it. Pass the context.
+     * Defaults to the first attached context; `null` uses none.
+     */
+    readonly session?: CookieJarPort | null;
+    /** Accept self-signed certificates (dev servers). */
+    readonly ignoreHttpsErrors?: boolean;
+}
+export interface StandaloneClientOptions extends Omit<ClientOptions, "baseURL" | "session"> {
+    readonly baseURL: string;
+    readonly session?: CookieJarPort;
+}
+export interface ServeOptions {
+    /** 0, the default, picks a free port. A fixed port fails loudly when taken. */
+    readonly port?: number;
+    readonly host?: string;
+    /** Protocols served. Default all three. */
+    readonly protocols?: readonly RpcProtocol[];
+    /**
+     * HTTP/2 (h2c). Required by native gRPC clients; an HTTP/1.1-only client
+     * (grpc-web, Connect over 1.1) needs it off. Default: on when `protocols`
+     * includes grpc.
+     */
+    readonly http2?: boolean;
+}
+export interface RpcServer {
+    readonly url: string;
+    readonly port: number;
+    close(): Promise<void>;
+}
+export interface ConnectApi {
+    /**
+     * Stub a whole service, or the methods of it that `impl` defines. A
+     * method a browser cannot call (client or bidirectional streaming) is
+     * refused: `serve()` is where those are faked.
+     */
+    service<S extends DescService>(service: S, impl: Partial<ServiceImpl<S>>, options?: StubOptions): Promise<StubHandle>;
+    /** Stub one unary method with a message or a function of the request. */
+    unary<I extends DescMessage, O extends DescMessage>(method: DescMethodUnary<I, O>, reply: UnaryReply<I, O>, options?: StubOptions<I>): Promise<UnaryStub<I>>;
+    /** Stub one server-streaming method and drive it from the test. */
+    stream<I extends DescMessage, O extends DescMessage>(method: DescMethodServerStreaming<I, O>, options?: StubOptions<I>): Promise<StreamStub<I, O>>;
+    /** Answer every call to `method` with an error status. */
+    fail<I extends DescMessage>(method: DescMethod & {
+        readonly input: I;
+    }, code: Code, message?: string, options?: StubOptions<I>): Promise<StubHandle>;
+    /** Fail every call to `method` at the network level. */
+    abort<I extends DescMessage>(method: DescMethod & {
+        readonly input: I;
+    }, options?: StubOptions<I> & {
+        readonly error?: AbortErrorCode;
+    }): Promise<StubHandle>;
+    /** Hold calls until the test releases, answers or aborts each one. */
+    hold<I extends DescMessage, O extends DescMessage>(method: DescMethodUnary<I, O> | DescMethodServerStreaming<I, O>, options?: HoldOptions<I>): Promise<HoldStub<I, O>>;
+    /** Record and decode calls to this service without answering them. */
+    record(service: DescService): Promise<StubHandle>;
+    /** Every recorded call to `method`, oldest first. */
+    calls<I extends DescMessage, O extends DescMessage>(method: DescMethod & {
+        readonly input: I;
+        readonly output: O;
+    }): Promise<RpcCall<I, O>[]>;
+    /** A typed client for the real backend, signed in as the page. */
+    client<S extends DescService>(service: S, options?: ClientOptions): Client<S>;
+    /**
+     * Serve stubs on a port of their own, for clients outside the browser — a
+     * native gRPC client, a backend service under test. Calls are recorded.
+     */
+    serve(routes: (router: ConnectRouter) => void, options?: ServeOptions): Promise<RpcServer>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

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

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

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

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

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

@@ -0,0 +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";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/features/rest/index.js

@@ -0,0 +1,3 @@
+export { rest } from "./lib/create-rest.js";
+export { abort, bytes, delay, empty, json, passthrough, text, } from "./lib/reply.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/rest/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAE5C,OAAO,EACN,KAAK,EACL,KAAK,EACL,KAAK,EACL,KAAK,EACL,IAAI,EACJ,WAAW,EACX,IAAI,GACJ,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { Frame } from "../../../entities/frame/index.js";
+import type { RestCall } from "../model/types.js";
+/**
+ * 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.
+ */
+export declare function assembleCalls(frames: readonly Frame[]): RestCall[];
+//# sourceMappingURL=calls.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,32 @@
+/**
+ * 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.
+ */
+export function assembleCalls(frames) {
+    const byCall = new Map();
+    for (const frame of frames) {
+        const key = frame.correlation ?? `#${frame.seq}`;
+        const entry = byCall.get(key) ?? {};
+        if (frame.kind === "request")
+            entry.request = frame;
+        else
+            entry.end = frame;
+        byCall.set(key, entry);
+    }
+    const calls = [];
+    for (const [correlation, { request, end }] of byCall) {
+        if (request === undefined)
+            continue;
+        const status = end?.meta["status"];
+        calls.push({
+            correlation,
+            method: String(request.meta["method"]),
+            url: String(request.meta["url"]),
+            request,
+            response: end?.kind === "response" ? end : undefined,
+            status: typeof status === "number" ? status : undefined,
+        });
+    }
+    return calls;
+}
+//# sourceMappingURL=calls.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,8 @@
+import { type WirePlugin } from "../../../entities/plugin/index.js";
+import type { RestApi, RestOptions } from "../model/types.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.
+ */
+export declare function rest(options?: RestOptions): WirePlugin<"rest", RestApi>;
+//# sourceMappingURL=create-rest.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,136 @@
+import { definePlugin, } from "../../../entities/plugin/index.js";
+import { createArrivals } from "../../../shared/lib/async/index.js";
+import { assembleCalls } from "./calls.js";
+import { compilePath } from "./path.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.
+ */
+export function rest(options = {}) {
+    return definePlugin({
+        name: "rest",
+        scope: "Rest",
+        setup(context) {
+            const { name } = context;
+            /** The record rule being added, once: every context gets it. */
+            let recording;
+            const toOutcome = async (reply) => {
+                switch (reply.kind) {
+                    case "response":
+                        return {
+                            type: "fulfill",
+                            status: reply.status,
+                            headers: reply.headers,
+                            ...(reply.body === undefined ? {} : { body: reply.body }),
+                        };
+                    case "passthrough":
+                        return { type: "fallback" };
+                    case "abort":
+                        return { type: "abort", error: reply.error };
+                    case "delay":
+                        await context.clock.sleep(reply.ms);
+                        return toOutcome(reply.reply);
+                }
+            };
+            const on = async (method, path, resolver, routeOptions = {}) => {
+                const matcher = compilePath(path, options.baseURL);
+                // Own, enumerable fields: a request spreads and prints whole.
+                const toRequest = (view) => ({
+                    get correlation() {
+                        return view.correlation;
+                    },
+                    method: view.method,
+                    url: view.url,
+                    headers: view.headers,
+                    page: view.page,
+                    context: view.context,
+                    resourceType: view.resourceType,
+                    body: view.body,
+                    text: view.text,
+                    json: view.json,
+                    // The rule's URL predicate is this matcher, so it matched.
+                    params: matcher.match(view.url),
+                    query: view.url.searchParams,
+                });
+                const label = `${method} ${String(path)}`;
+                const requests = createArrivals({
+                    clock: context.clock,
+                    label: `${label} request`,
+                });
+                const { match } = routeOptions;
+                const rule = await context.http.add({
+                    protocol: name,
+                    label,
+                    url: (url) => matcher.match(url) !== undefined,
+                    ...(method === "*" ? {} : { method }),
+                    ...(routeOptions.times === undefined
+                        ? {}
+                        : { times: routeOptions.times }),
+                    ...(match === undefined
+                        ? {}
+                        : { match: (view) => match(toRequest(view)) }),
+                    handle: async (view) => {
+                        const request = toRequest(view);
+                        requests.push(request);
+                        return toOutcome(typeof resolver === "function"
+                            ? await resolver(request)
+                            : resolver);
+                    },
+                });
+                return {
+                    get hits() {
+                        return rule.hits;
+                    },
+                    get requests() {
+                        return requests.items;
+                    },
+                    next: (waitOptions) => requests.next(waitOptions),
+                    remove: () => rule.remove(),
+                };
+            };
+            const verb = (method) => (path, resolver, routeOptions) => on(method, path, resolver, routeOptions);
+            const api = {
+                on,
+                get: verb("GET"),
+                post: verb("POST"),
+                put: verb("PUT"),
+                patch: verb("PATCH"),
+                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 {
+                api,
+                async attach() {
+                    if (options.record === undefined || options.record === false)
+                        return;
+                    const base = compilePath(`${options.baseURL ?? ""}/**`, undefined);
+                    recording ??= context.http
+                        .add({
+                        protocol: name,
+                        label: "record",
+                        url: options.record === true
+                            ? (url) => base.match(url) !== undefined
+                            : options.record,
+                        handle: () => ({ type: "fallback" }),
+                    })
+                        .catch((error) => {
+                        // The router took the rule back: the next attach adds it again.
+                        recording = undefined;
+                        throw error;
+                    });
+                    await recording;
+                },
+            };
+        },
+    });
+}
+//# sourceMappingURL=create-rest.js.map

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

@@ -0,0 +1 @@
+{"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/path.d.ts

@@ -0,0 +1,14 @@
+import type { RestPath } from "../model/types.js";
+export interface PathMatcher {
+    /** The `:name` params when `url` matches, undefined when it does not. */
+    match(url: URL): Record<string, string> | undefined;
+}
+/**
+ * `/rooms/:id/files/*` against a URL's path, or — for a pattern that starts
+ * with a scheme — against origin plus path. The glob is the one every other
+ * pattern of the library takes (`*` one segment, `**` any number, none
+ * included, `{a,b}` either), plus `:name` params. The query never takes
+ * part: a route for `/search` should answer `/search?q=x`.
+ */
+export declare function compilePath(path: RestPath, baseURL: string | undefined): PathMatcher;
+//# sourceMappingURL=path.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../../src/features/rest/lib/path.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,WAAW,WAAW;IAC3B,yEAAyE;IACzE,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CACpD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAC1B,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,MAAM,GAAG,SAAS,GACzB,WAAW,CA+Bb"}