@heojeongbo/wirestage 0.0.0-stage → 0.1.1

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

@@ -0,0 +1,228 @@
+import { gunzipSync } from "node:zlib";
+import { fromBinary, fromJsonString, } from "@bufbuild/protobuf";
+import { Code } from "@connectrpc/connect";
+import { codeFromString, codeFromHttpStatus as connectCodeFromHttpStatus, } from "@connectrpc/connect/protocol-connect";
+import { codeFromHttpStatus as grpcCodeFromHttpStatus } from "@connectrpc/connect/protocol-grpc";
+import { concatBytes, fromBase64, utf8, } from "../../../shared/lib/bytes/index.js";
+import { decodeEnvelopes, EnvelopeFlag, parseTrailerBlock, } from "../../../shared/lib/envelope/index.js";
+/**
+ * Read the format off a request, the way a Connect server negotiates it.
+ * Undefined means "not an RPC this plugin understands" — a rule then falls
+ * through instead of mangling, say, a REST call that shares the path prefix.
+ */
+export function detectFormat(request) {
+    const contentType = (request.headers["content-type"] ?? "")
+        .split(";")[0]
+        ?.trim()
+        .toLowerCase();
+    if (contentType?.startsWith("application/grpc-web-text"))
+        return {
+            protocol: "grpc-web",
+            binary: !contentType.endsWith("+json"),
+            base64: true,
+            enveloped: true,
+        };
+    if (contentType?.startsWith("application/grpc-web"))
+        return {
+            protocol: "grpc-web",
+            binary: !contentType.endsWith("+json"),
+            base64: false,
+            enveloped: true,
+        };
+    if (contentType?.startsWith("application/grpc"))
+        return {
+            protocol: "grpc",
+            binary: !contentType.endsWith("+json"),
+            base64: false,
+            enveloped: true,
+        };
+    if (contentType?.startsWith("application/connect+"))
+        return {
+            protocol: "connect",
+            binary: contentType === "application/connect+proto",
+            base64: false,
+            enveloped: true,
+        };
+    if (contentType === "application/proto" || contentType === "application/json")
+        return {
+            protocol: "connect",
+            binary: contentType === "application/proto",
+            base64: false,
+            enveloped: false,
+        };
+    // Connect's GET form for side-effect-free methods carries the message in
+    // the query string and sends no content type at all.
+    if (request.method === "GET" &&
+        request.url.searchParams.get("connect") === "v1")
+        return {
+            protocol: "connect",
+            binary: request.url.searchParams.get("encoding") !== "json",
+            base64: false,
+            enveloped: false,
+        };
+    return undefined;
+}
+const OK = { code: 0, message: "" };
+/** The request's messages, from its body or (Connect GET) its query. */
+export function decodeRequestBody(format, request) {
+    if (!format.enveloped) {
+        const query = request.url.searchParams;
+        if (query.get("connect") === "v1") {
+            const message = query.get("message") ?? "";
+            return [
+                query.get("base64") === "1"
+                    ? fromBase64(message.replaceAll("-", "+").replaceAll("_", "/"))
+                    : new TextEncoder().encode(message),
+            ];
+        }
+        return [request.body()];
+    }
+    const body = format.base64
+        ? fromBase64Stream(request.body())
+        : request.body();
+    return dataEnvelopes(body, request.headers[format.protocol === "connect"
+        ? "connect-content-encoding"
+        : "grpc-encoding"]);
+}
+/** Messages and status from a response the real backend sent. */
+export function decodeResponseBody(format, response) {
+    const headers = response.headers;
+    const raw = response.body ?? new Uint8Array(0);
+    if (!format.enveloped) {
+        if (response.status !== 200)
+            return { messages: [], status: connectError(raw, response.status) };
+        // A 200 that is not a message is something on the way — a proxy's
+        // sign-in page, say — and a Connect client reports it as an error.
+        const contentType = headers["content-type"] ?? "";
+        if (!/^application\/(proto|json)\b/i.test(contentType))
+            return {
+                messages: [],
+                status: {
+                    code: Code.Unknown,
+                    message: `unexpected content type "${contentType}"`,
+                },
+            };
+        return { messages: [raw], status: OK };
+    }
+    const body = format.base64 ? fromBase64Stream(raw) : raw;
+    const { envelopes } = decodeEnvelopes(body);
+    const encoding = headers[format.protocol === "connect"
+        ? "connect-content-encoding"
+        : "grpc-encoding"];
+    const messages = [];
+    let status;
+    for (const envelope of envelopes) {
+        if (format.protocol === "connect" &&
+            envelope.flags & EnvelopeFlag.endStream)
+            status = endStream(inflate(envelope.flags, envelope.data, encoding));
+        else if (envelope.flags & EnvelopeFlag.trailer)
+            status = grpcStatus(parseTrailerBlock(envelope.data));
+        else
+            messages.push(inflate(envelope.flags, envelope.data, encoding));
+    }
+    // A trailers-only response carries the status in the headers instead.
+    if (status === undefined && headers["grpc-status"] !== undefined)
+        status = grpcStatus(headers);
+    // No status anywhere and not a 200: a gateway answered, not the server.
+    // The client maps the HTTP status to a code, and so does the record.
+    if (status === undefined && response.status !== 200)
+        status = {
+            code: format.protocol === "connect"
+                ? connectCodeFromHttpStatus(response.status)
+                : grpcCodeFromHttpStatus(response.status),
+            message: `HTTP ${response.status}`,
+        };
+    return { messages, status };
+}
+/** Parse a message payload with the request's format. */
+export function parseMessage(schema, bytes, binary, jsonOptions) {
+    return binary
+        ? fromBinary(schema, bytes)
+        : fromJsonString(schema, utf8(bytes), {
+            ignoreUnknownFields: true,
+            ...jsonOptions,
+        });
+}
+/**
+ * Connect's `{ "code": "not_found", "message": "..." }` error body. A body
+ * that is not one came from something on the way, and the HTTP status is all
+ * there is to go by — which is how a Connect client reads it too.
+ */
+export function connectError(body, httpStatus) {
+    try {
+        const status = errorStatus(JSON.parse(utf8(body)));
+        if (status !== undefined)
+            return status;
+    }
+    catch {
+        // Not JSON at all.
+    }
+    return {
+        code: connectCodeFromHttpStatus(httpStatus),
+        message: `HTTP ${httpStatus}`,
+    };
+}
+/** The status in a Connect error object; undefined when it names no code. */
+function errorStatus(value) {
+    const error = (typeof value === "object" && value !== null ? value : {});
+    const code = typeof error.code === "string" ? codeFromString(error.code) : undefined;
+    if (code === undefined)
+        return undefined;
+    return {
+        code,
+        message: typeof error.message === "string" ? error.message : "",
+    };
+}
+function grpcStatus(fields) {
+    const code = Number(fields["grpc-status"]);
+    return {
+        code: Number.isInteger(code) ? code : Code.Unknown,
+        message: safeDecodeURIComponent(fields["grpc-message"] ?? ""),
+    };
+}
+/** Connect's end-of-stream JSON: `{}` for OK, `{ "error": {...} }` otherwise. */
+function endStream(data) {
+    try {
+        const parsed = JSON.parse(utf8(data));
+        if (parsed.error === undefined)
+            return OK;
+        return (errorStatus(parsed.error) ?? {
+            code: Code.Unknown,
+            message: "end-of-stream error with no code",
+        });
+    }
+    catch {
+        return { code: Code.Unknown, message: "malformed end-of-stream message" };
+    }
+}
+/**
+ * gRPC-web-text: base64, but not one base64 string. A server encodes each
+ * chunk it flushes on its own, padding included, so a stream is several
+ * encodings end to end, and decoding it as one stops at the first padding.
+ */
+function fromBase64Stream(body) {
+    const parts = utf8(body).match(/[^=]+=*/g) ?? [];
+    return concatBytes(parts.map((part) => fromBase64(part)));
+}
+function dataEnvelopes(body, encoding) {
+    return decodeEnvelopes(body)
+        .envelopes.filter((e) => !(e.flags & EnvelopeFlag.trailer) &&
+        !(e.flags & EnvelopeFlag.endStream))
+        .map((e) => inflate(e.flags, e.data, encoding));
+}
+/** Decompress a compressed envelope when the encoding is gzip; otherwise as is. */
+function inflate(flags, data, encoding) {
+    if (!(flags & EnvelopeFlag.compressed) || encoding !== "gzip")
+        return data;
+    return new Uint8Array(gunzipSync(data));
+}
+/** gRPC percent-encodes `grpc-message`; a malformed escape must not throw. */
+function safeDecodeURIComponent(value) {
+    try {
+        return decodeURIComponent(value);
+    }
+    catch {
+        return value;
+    }
+}
+//# sourceMappingURL=protocol.js.map

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

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

package/dist/features/connect/lib/record.d.ts

@@ -0,0 +1,14 @@
+import type { DescService } from "@bufbuild/protobuf";
+import type { StubHandle } from "../model/types.js";
+import type { RpcRules } from "./rules.js";
+/**
+ * Record and decode a service's calls without answering them: the request
+ * as it leaves, the real backend's messages and status as they come back,
+ * or the fault when the connection fails.
+ *
+ * A call a stub answers is recorded by that stub. Where this rule sits among
+ * the stubs does not matter: a request is one exchange however many rules
+ * see it, so it lands once either way.
+ */
+export declare function recordService(rules: RpcRules, service: DescService): Promise<StubHandle>;
+//# sourceMappingURL=record.d.ts.map

package/dist/features/connect/lib/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../../src/features/connect/lib/record.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAClC,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,CAAC,CA4BrB"}

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

@@ -0,0 +1,36 @@
+import { endpointOf } from "./recorder.js";
+/**
+ * Record and decode a service's calls without answering them: the request
+ * as it leaves, the real backend's messages and status as they come back,
+ * or the fault when the connection fails.
+ *
+ * A call a stub answers is recorded by that stub. Where this rule sits among
+ * the stubs does not matter: a request is one exchange however many rules
+ * see it, so it lands once either way.
+ */
+export async function recordService(rules, service) {
+    const added = [];
+    for (const method of service.methods) {
+        // A page cannot call the others; there is nothing of theirs to record.
+        if (method.methodKind !== "unary" &&
+            method.methodKind !== "server_streaming")
+            continue;
+        added.push(await rules.add({
+            method,
+            label: `record ${endpointOf(method)}`,
+            options: {},
+            anyProtocol: true,
+            observe: true,
+            respond: () => ({ type: "fallback" }),
+        }));
+    }
+    return {
+        get hits() {
+            return added.reduce((sum, rule) => sum + rule.hits, 0);
+        },
+        async remove() {
+            await Promise.all(added.map((rule) => rule.remove()));
+        },
+    };
+}
+//# sourceMappingURL=record.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../../../src/features/connect/lib/record.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,KAAe,EACf,OAAoB;IAEpB,MAAM,KAAK,GAAqB,EAAE,CAAC;IACnC,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACtC,uEAAuE;QACvE,IACC,MAAM,CAAC,UAAU,KAAK,OAAO;YAC7B,MAAM,CAAC,UAAU,KAAK,kBAAkB;YAExC,SAAS;QACV,KAAK,CAAC,IAAI,CACT,MAAM,KAAK,CAAC,GAAG,CAAC;YACf,MAAM;YACN,KAAK,EAAE,UAAU,UAAU,CAAC,MAAM,CAAC,EAAE;YACrC,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,IAAI;YACjB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;SACrC,CAAC,CACF,CAAC;IACH,CAAC;IACD,OAAO;QACN,IAAI,IAAI;YACP,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACxD,CAAC;QACD,KAAK,CAAC,MAAM;YACX,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACvD,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/features/connect/lib/recorder.d.ts

@@ -0,0 +1,77 @@
+import { type DescMethod } from "@bufbuild/protobuf";
+import { type HandlerContext } from "@connectrpc/connect";
+import type { FrameSource, Timeline } from "../../../entities/frame/index.js";
+import type { RpcProtocol } from "../model/types.js";
+import type { RpcStatus } from "./protocol.js";
+/** What is known about one call, by whoever records its frames. */
+export interface CallInfo {
+    readonly correlation: string;
+    /** Who makes the call: the page, the test's drive client, an outside client. */
+    readonly from: FrameSource;
+    /** Who answers it: a stub, the real network, a served fake. */
+    readonly answeredBy: FrameSource;
+    readonly rpcProtocol: RpcProtocol | undefined;
+    readonly page?: string | undefined;
+    readonly context?: string | undefined;
+    /**
+     * The request side is already on the timeline: the rule that took the
+     * request recorded it before deciding how to answer.
+     */
+    readonly requestRecorded?: boolean;
+    /** Set on live streams: resets the underlying connection. */
+    cut?: () => void;
+    /** Set on live streams: settles once the response is over. */
+    over?: Promise<unknown>;
+}
+/**
+ * How a call's identity reaches the implementation. Connect threads context
+ * values from the server adapter into `HandlerContext.values`, which keeps the
+ * recording wrapper free of globals and safe under concurrent calls.
+ */
+export declare const kCall: import("@connectrpc/connect").ContextKey<CallInfo>;
+export declare const endpointOf: (method: DescMethod) => string;
+export interface Recorder {
+    /** A request-side message: the first is the `request` frame. */
+    out(call: CallInfo, method: DescMethod, message: unknown, first: boolean): void;
+    /** A response-side message. */
+    in(call: CallInfo, method: DescMethod, message: unknown): void;
+    /** The call ended: OK when `error` is undefined. */
+    status(call: CallInfo, method: DescMethod, error?: unknown): void;
+    /** A status read off the wire (passthrough). */
+    statusOf(call: CallInfo, method: DescMethod, status: RpcStatus): void;
+    /**
+     * The call ended without a status: an abort, a cut, a dropped connection.
+     * `by` is who caused it, when that is not who was answering.
+     */
+    fault(call: CallInfo, method: DescMethod, reason: string, detail?: {
+        readonly error?: string | undefined;
+        readonly by?: FrameSource;
+    }): void;
+}
+/**
+ * Writes RPC frames. Every RPC, however it was answered, lands as the same
+ * shape: a `request` frame from whoever called, `message` frames each way,
+ * and one closing frame — a `response` with the status, or a `fault` when
+ * there was none — so `calls()` reassembles stubbed, passed-through and
+ * served calls the same way.
+ *
+ * A call ends once. A stream the test cut is over at the cut, whatever the
+ * implementation goes on to return; the first ending is the one recorded.
+ */
+export declare function createRecorder(timeline: Timeline, protocol: string): Recorder;
+/**
+ * The call a handler is serving. An unidentified one is recorded as
+ * anonymous — each as a call of its own, so one ending does not end the next.
+ */
+export declare function callOf(context: HandlerContext): CallInfo;
+/** Wrap an iterable so `tap` sees every value as the consumer takes it. */
+export declare function tapIterable<T>(source: AsyncIterable<T>, tap: (value: T, index: number) => void): AsyncGenerator<T>;
+type AnyImpl = (input: never, context: HandlerContext) => unknown;
+/**
+ * Wrap an implementation of any of the four method kinds so every message
+ * and the final status are recorded. The implementation itself is untouched:
+ * it sees the same requests, and the client sees the same responses.
+ */
+export declare function recordingImpl(method: DescMethod, impl: AnyImpl, recorder: Recorder): AnyImpl;
+export {};
+//# sourceMappingURL=recorder.d.ts.map

package/dist/features/connect/lib/recorder.d.ts.map

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

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

@@ -0,0 +1,209 @@
+import { create, isMessage, toBinary, } from "@bufbuild/protobuf";
+import { Code, ConnectError, createContextKey, } from "@connectrpc/connect";
+/** A call nobody identified; the key's default, so a lookup never misses. */
+const ANONYMOUS = Object.freeze({
+    correlation: "anonymous",
+    from: "page",
+    answeredBy: "stub",
+    rpcProtocol: undefined,
+});
+/**
+ * How a call's identity reaches the implementation. Connect threads context
+ * values from the server adapter into `HandlerContext.values`, which keeps the
+ * recording wrapper free of globals and safe under concurrent calls.
+ */
+export const kCall = createContextKey(ANONYMOUS, {
+    description: "wirestage call",
+});
+export const endpointOf = (method) => `${method.parent.typeName}/${method.name}`;
+/**
+ * Writes RPC frames. Every RPC, however it was answered, lands as the same
+ * shape: a `request` frame from whoever called, `message` frames each way,
+ * and one closing frame — a `response` with the status, or a `fault` when
+ * there was none — so `calls()` reassembles stubbed, passed-through and
+ * served calls the same way.
+ *
+ * A call ends once. A stream the test cut is over at the cut, whatever the
+ * implementation goes on to return; the first ending is the one recorded.
+ */
+export function createRecorder(timeline, protocol) {
+    const ended = new WeakSet();
+    const base = (call, method) => ({
+        protocol,
+        endpoint: endpointOf(method),
+        correlation: call.correlation,
+        ...(call.page === undefined ? {} : { page: call.page }),
+        ...(call.context === undefined ? {} : { context: call.context }),
+    });
+    const asMessage = (schema, value) => (isMessage(value, schema)
+        ? value
+        : create(schema, value));
+    const close = (call, method, status, extra = {}) => {
+        if (ended.has(call))
+            return;
+        ended.add(call);
+        timeline.append({
+            ...base(call, method),
+            kind: "response",
+            direction: "in",
+            source: call.answeredBy,
+            meta: {
+                rpcProtocol: call.rpcProtocol,
+                code: status.code,
+                message: status.message,
+                ...extra,
+            },
+        });
+    };
+    return {
+        out(call, method, message, first) {
+            const value = asMessage(method.input, message);
+            timeline.append({
+                ...base(call, method),
+                kind: first ? "request" : "message",
+                direction: "out",
+                source: call.from,
+                value,
+                data: () => toBinary(method.input, value),
+                meta: { rpcProtocol: call.rpcProtocol },
+            });
+        },
+        in(call, method, message) {
+            if (ended.has(call))
+                return;
+            const value = asMessage(method.output, message);
+            timeline.append({
+                ...base(call, method),
+                kind: "message",
+                direction: "in",
+                source: call.answeredBy,
+                value,
+                data: () => toBinary(method.output, value),
+                meta: { rpcProtocol: call.rpcProtocol },
+            });
+        },
+        status(call, method, error) {
+            if (error === undefined) {
+                close(call, method, { code: 0, message: "" });
+                return;
+            }
+            if (error instanceof ConnectError) {
+                close(call, method, { code: error.code, message: error.rawMessage });
+                return;
+            }
+            // Anything else reaches the page as Connect's own "internal error".
+            // The frame records that, and keeps what was really thrown where
+            // the test can read it and the page cannot.
+            close(call, method, { code: Code.Internal, message: "internal error" }, { thrown: String(error) });
+        },
+        statusOf: (call, method, status) => close(call, method, status),
+        fault(call, method, reason, detail = {}) {
+            if (ended.has(call))
+                return;
+            ended.add(call);
+            timeline.append({
+                ...base(call, method),
+                kind: "fault",
+                direction: "none",
+                source: detail.by ?? call.answeredBy,
+                meta: {
+                    rpcProtocol: call.rpcProtocol,
+                    reason,
+                    ...(detail.error === undefined ? {} : { error: detail.error }),
+                },
+            });
+        },
+    };
+}
+/**
+ * The call a handler is serving. An unidentified one is recorded as
+ * anonymous — each as a call of its own, so one ending does not end the next.
+ */
+export function callOf(context) {
+    const call = context.values.get(kCall);
+    return call === ANONYMOUS ? { ...ANONYMOUS } : call;
+}
+/** Wrap an iterable so `tap` sees every value as the consumer takes it. */
+export async function* tapIterable(source, tap) {
+    let index = 0;
+    for await (const value of source) {
+        tap(value, index++);
+        yield value;
+    }
+}
+/**
+ * Wrap an implementation of any of the four method kinds so every message
+ * and the final status are recorded. The implementation itself is untouched:
+ * it sees the same requests, and the client sees the same responses.
+ */
+export function recordingImpl(method, impl, recorder) {
+    const run = impl;
+    /** The request side, unless the rule that took the request recorded it. */
+    const request = (call, message, first) => {
+        if (!call.requestRecorded)
+            recorder.out(call, method, message, first);
+    };
+    switch (method.methodKind) {
+        case "unary":
+            return async (input, context) => {
+                const call = callOf(context);
+                request(call, input, true);
+                try {
+                    const response = await run(input, context);
+                    recorder.in(call, method, response);
+                    recorder.status(call, method);
+                    return response;
+                }
+                catch (error) {
+                    recorder.status(call, method, error);
+                    throw error;
+                }
+            };
+        case "server_streaming":
+            return async function* (input, context) {
+                const call = callOf(context);
+                request(call, input, true);
+                try {
+                    for await (const response of run(input, context)) {
+                        recorder.in(call, method, response);
+                        yield response;
+                    }
+                    recorder.status(call, method);
+                }
+                catch (error) {
+                    recorder.status(call, method, error);
+                    throw error;
+                }
+            };
+        case "client_streaming":
+            return async (requests, context) => {
+                const call = callOf(context);
+                try {
+                    const response = await run(tapIterable(requests, (m, i) => request(call, m, i === 0)), context);
+                    recorder.in(call, method, response);
+                    recorder.status(call, method);
+                    return response;
+                }
+                catch (error) {
+                    recorder.status(call, method, error);
+                    throw error;
+                }
+            };
+        case "bidi_streaming":
+            return async function* (requests, context) {
+                const call = callOf(context);
+                try {
+                    for await (const response of run(tapIterable(requests, (m, i) => request(call, m, i === 0)), context)) {
+                        recorder.in(call, method, response);
+                        yield response;
+                    }
+                    recorder.status(call, method);
+                }
+                catch (error) {
+                    recorder.status(call, method, error);
+                    throw error;
+                }
+            };
+    }
+}
+//# sourceMappingURL=recorder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.js","sourceRoot":"","sources":["../../../../src/features/connect/lib/recorder.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,MAAM,EAGN,SAAS,EAET,QAAQ,GACR,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACN,IAAI,EACJ,YAAY,EACZ,gBAAgB,GAEhB,MAAM,qBAAqB,CAAC;AA2B7B,6EAA6E;AAC7E,MAAM,SAAS,GAAa,MAAM,CAAC,MAAM,CAAC;IACzC,WAAW,EAAE,WAAW;IACxB,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,MAAM;IAClB,WAAW,EAAE,SAAS;CACtB,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,gBAAgB,CAAW,SAAS,EAAE;IAC1D,WAAW,EAAE,gBAAgB;CAC7B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAkB,EAAU,EAAE,CACxD,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;AA4B5C;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,QAAkB,EAAE,QAAgB;IAClE,MAAM,KAAK,GAAG,IAAI,OAAO,EAAY,CAAC;IACtC,MAAM,IAAI,GAAG,CAAC,IAAc,EAAE,MAAkB,EAAE,EAAE,CAAC,CAAC;QACrD,QAAQ;QACR,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC;QAC5B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACvD,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;KAChE,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,CAAwB,MAAS,EAAE,KAAc,EAAE,EAAE,CACtE,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC;QACxB,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,KAAc,CAAC,CAAoB,CAAC;IACvD,MAAM,KAAK,GAAG,CACb,IAAc,EACd,MAAkB,EAClB,MAAiB,EACjB,QAA2C,EAAE,EAC5C,EAAE;QACH,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QAC5B,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChB,QAAQ,CAAC,MAAM,CAAC;YACf,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;YACrB,IAAI,EAAE,UAAU;YAChB,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,UAAU;YACvB,IAAI,EAAE;gBACL,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,GAAG,KAAK;aACR;SACD,CAAC,CAAC;IACJ,CAAC,CAAC;IACF,OAAO;QACN,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK;YAC/B,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC/C,QAAQ,CAAC,MAAM,CAAC;gBACf,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;gBACrB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;gBACnC,SAAS,EAAE,KAAK;gBAChB,MAAM,EAAE,IAAI,CAAC,IAAI;gBACjB,KAAK;gBACL,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC;gBACzC,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE;aACvC,CAAC,CAAC;QACJ,CAAC;QACD,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO;YACvB,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO;YAC5B,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAChD,QAAQ,CAAC,MAAM,CAAC;gBACf,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;gBACrB,IAAI,EAAE,SAAS;gBACf,SAAS,EAAE,IAAI;gBACf,MAAM,EAAE,IAAI,CAAC,UAAU;gBACvB,KAAK;gBACL,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;gBAC1C,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE;aACvC,CAAC,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK;YACzB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACzB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC9C,OAAO;YACR,CAAC;YACD,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;gBACnC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;gBACrE,OAAO;YACR,CAAC;YACD,oEAAoE;YACpE,iEAAiE;YACjE,4CAA4C;YAC5C,KAAK,CACJ,IAAI,EACJ,MAAM,EACN,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAClD,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CACzB,CAAC;QACH,CAAC;QACD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC;QAC/D,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,EAAE;YACtC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO;YAC5B,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAChB,QAAQ,CAAC,MAAM,CAAC;gBACf,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;gBACrB,IAAI,EAAE,OAAO;gBACb,SAAS,EAAE,MAAM;gBACjB,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC,UAAU;gBACpC,IAAI,EAAE;oBACL,WAAW,EAAE,IAAI,CAAC,WAAW;oBAC7B,MAAM;oBACN,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;iBAC9D;aACD,CAAC,CAAC;QACJ,CAAC;KACD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,OAAuB;IAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACvC,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACrD,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,WAAW,CACjC,MAAwB,EACxB,GAAsC;IAEtC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAClC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACpB,MAAM,KAAK,CAAC;IACb,CAAC;AACF,CAAC;AAID;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC5B,MAAkB,EAClB,IAAa,EACb,QAAkB;IAElB,MAAM,GAAG,GAAG,IAA4D,CAAC;IACzE,2EAA2E;IAC3E,MAAM,OAAO,GAAG,CAAC,IAAc,EAAE,OAAgB,EAAE,KAAc,EAAE,EAAE;QACpE,IAAI,CAAC,IAAI,CAAC,eAAe;YAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACvE,CAAC,CAAC;IACF,QAAQ,MAAM,CAAC,UAAU,EAAE,CAAC;QAC3B,KAAK,OAAO;YACX,OAAO,KAAK,EAAE,KAAc,EAAE,OAAuB,EAAE,EAAE;gBACxD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC7B,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;gBAC3B,IAAI,CAAC;oBACJ,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;oBAC3C,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;oBACpC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;oBAC9B,OAAO,QAAQ,CAAC;gBACjB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBAChB,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;oBACrC,MAAM,KAAK,CAAC;gBACb,CAAC;YACF,CAAC,CAAC;QACH,KAAK,kBAAkB;YACtB,OAAO,KAAK,SAAS,CAAC,EAAE,KAAc,EAAE,OAAuB;gBAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC7B,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;gBAC3B,IAAI,CAAC;oBACJ,IAAI,KAAK,EAAE,MAAM,QAAQ,IAAI,GAAG,CAC/B,KAAK,EACL,OAAO,CACmB,EAAE,CAAC;wBAC7B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;wBACpC,MAAM,QAAQ,CAAC;oBAChB,CAAC;oBACD,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBAC/B,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBAChB,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;oBACrC,MAAM,KAAK,CAAC;gBACb,CAAC;YACF,CAAC,CAAC;QACH,KAAK,kBAAkB;YACtB,OAAO,KAAK,EACX,QAAgC,EAChC,OAAuB,EACtB,EAAE;gBACH,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC7B,IAAI,CAAC;oBACJ,MAAM,QAAQ,GAAG,MAAM,GAAG,CACzB,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAC1D,OAAO,CACP,CAAC;oBACF,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;oBACpC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;oBAC9B,OAAO,QAAQ,CAAC;gBACjB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBAChB,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;oBACrC,MAAM,KAAK,CAAC;gBACb,CAAC;YACF,CAAC,CAAC;QACH,KAAK,gBAAgB;YACpB,OAAO,KAAK,SAAS,CAAC,EACrB,QAAgC,EAChC,OAAuB;gBAEvB,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC7B,IAAI,CAAC;oBACJ,IAAI,KAAK,EAAE,MAAM,QAAQ,IAAI,GAAG,CAC/B,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAC1D,OAAO,CACmB,EAAE,CAAC;wBAC7B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;wBACpC,MAAM,QAAQ,CAAC;oBAChB,CAAC;oBACD,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBAC/B,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBAChB,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;oBACrC,MAAM,KAAK,CAAC;gBACb,CAAC;YACF,CAAC,CAAC;IACJ,CAAC;AACF,CAAC"}

package/dist/features/connect/lib/rules.d.ts

@@ -0,0 +1,51 @@
+import type { DescMessage, DescMethod } from "@bufbuild/protobuf";
+import { type HandlerContext } from "@connectrpc/connect";
+import type { UniversalHandler } from "@connectrpc/connect/protocol";
+import type { HttpOutcome, HttpRequestView, HttpRuleHandle, PluginContext } from "../../../entities/plugin/index.js";
+import type { ConnectOptions, HoldOptions } from "../model/types.js";
+import { type CallInfo, type Recorder } from "./recorder.js";
+export type AnyImpl = (input: never, context: HandlerContext) => unknown;
+/** One method's rule, as each kind of stub describes it. */
+export interface RuleSpec<I extends DescMessage> {
+    readonly method: DescMethod;
+    readonly label: string;
+    readonly options: HoldOptions<I> & {
+        readonly delayMs?: number | undefined;
+    };
+    /**
+     * Take calls in any RPC format, not only the protocols stubs answer: for
+     * a rule that watches and answers nothing.
+     */
+    readonly anyProtocol?: boolean;
+    /** Hear how a call this rule let through ended, and record it. */
+    readonly observe?: boolean;
+    /**
+     * Decide the call. Its request is already recorded, and `messages` are
+     * the request's messages decoded (none when they would not decode).
+     */
+    respond(view: HttpRequestView, messages: readonly unknown[]): HttpOutcome | Promise<HttpOutcome>;
+}
+export interface RpcRules {
+    /**
+     * Add one method's rule. Every stub goes through here, so every stub
+     * means the same by "a call to this method": the path, the protocols the
+     * plugin answers, the content type, `match` on the decoded request,
+     * `times`, the request on the timeline before the decision, `delayMs`.
+     */
+    add<I extends DescMessage>(spec: RuleSpec<I>): Promise<HttpRuleHandle>;
+    /**
+     * Connect's own server-side handler for one method: what makes a stub's
+     * bytes exactly a Connect server's. Built once per stub, not per call.
+     */
+    handler(method: DescMethod, impl: AnyImpl): UniversalHandler;
+    /** Answer a call through a handler. */
+    answer(handler: UniversalHandler, method: DescMethod, view: HttpRequestView): Promise<HttpOutcome>;
+    /** The call a request is, as a stub answers it. */
+    callOf(view: HttpRequestView): CallInfo;
+}
+/**
+ * How an RPC method becomes an HTTP rule, and how its traffic is recorded.
+ * The one place that knows both, shared by every stub of the plugin.
+ */
+export declare function createRpcRules(context: PluginContext, options: ConnectOptions, recorder: Recorder, protocol: string): RpcRules;
+//# sourceMappingURL=rules.d.ts.map