@heojeongbo/wirestage 0.0.0-stage → 0.1.1

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

@@ -0,0 +1,33 @@
+import type { DescService } from "@bufbuild/protobuf";
+import { type Client, type Transport } from "@connectrpc/connect";
+import { Http2SessionManager } from "@connectrpc/connect-node";
+import type { CookieJarPort } from "../../../shared/api/playwright/index.js";
+import type { StandaloneClientOptions } from "../model/types.js";
+import { type Recorder } from "./recorder.js";
+export interface ClientDeps {
+    /** Resolved per call, so a context attached after the client exists still counts. */
+    readonly session: () => CookieJarPort | undefined;
+    /** The time cookies are stamped against; the stage's clock in a stage. */
+    readonly now?: () => number;
+    readonly recorder?: Recorder;
+    readonly correlation?: () => string;
+    /**
+     * Handed the HTTP/2 connection a gRPC client opens, so its owner can close
+     * it. connect-node keeps an idle one for 15 minutes, and a server in the
+     * same process cannot finish closing while it is open (Node 22 waits).
+     */
+    readonly onConnection?: (connection: Http2SessionManager) => void;
+}
+export declare function createTransport(options: StandaloneClientOptions, deps: ClientDeps): Transport;
+/**
+ * A typed client for a real backend, outside any stage: the `rpc` helper an
+ * e2e suite otherwise writes by hand — framing, status parsing and all — per
+ * protocol. Errors arrive as `ConnectError` with the server's code.
+ *
+ * Over gRPC it holds an HTTP/2 connection, which connect-node keeps for 15
+ * minutes once idle. It does not keep the process alive, but a server in the
+ * same process waits for it before it finishes closing. A stage's client is
+ * closed with the stage.
+ */
+export declare function createRpcClient<S extends DescService>(service: S, options: StandaloneClientOptions): Client<S>;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/features/connect/lib/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EACN,KAAK,MAAM,EAIX,KAAK,SAAS,EACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAIN,mBAAmB,EACnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAE7E,OAAO,KAAK,EAAe,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAiB,KAAK,QAAQ,EAAe,MAAM,eAAe,CAAC;AAE1E,MAAM,WAAW,UAAU;IAC1B,qFAAqF;IACrF,QAAQ,CAAC,OAAO,EAAE,MAAM,aAAa,GAAG,SAAS,CAAC;IAClD,0EAA0E;IAC1E,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC;IACpC;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAClE;AAgHD,wBAAgB,eAAe,CAC9B,OAAO,EAAE,uBAAuB,EAChC,IAAI,EAAE,UAAU,GACd,SAAS,CAkCX;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,WAAW,EACpD,OAAO,EAAE,CAAC,EACV,OAAO,EAAE,uBAAuB,GAC9B,MAAM,CAAC,CAAC,CAAC,CAKX"}

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

@@ -0,0 +1,147 @@
+import { ConnectError, createClient, } from "@connectrpc/connect";
+import { createConnectTransport, createGrpcTransport, createGrpcWebTransport, Http2SessionManager, } from "@connectrpc/connect-node";
+import { parseSetCookie } from "../../../shared/lib/cookies/index.js";
+import { tapIterable } from "./recorder.js";
+/** Sent with every call that did not set the header itself. */
+function headersInterceptor(headers) {
+    return (next) => (request) => {
+        for (const [name, value] of Object.entries(headers))
+            if (!request.header.has(name))
+                request.header.set(name, value);
+        return next(request);
+    };
+}
+/**
+ * Shares a context's cookie jar both ways, as Playwright's own request
+ * context does — the reason hand-rolled gRPC-web helpers go through it. The
+ * jar's cookies go out on the call, read per call: a sign-in during the test
+ * is picked up, and a cookie scoped to another host or path is not sent. The
+ * cookies a response sets come back into the jar — an error response's too,
+ * which is how a sign-out or a refused sign-in clears a session.
+ *
+ * Cookies are scoped to the host the request names: its `host` header when
+ * one was set, since that is the site the server takes it for.
+ */
+function sessionInterceptor(session, now) {
+    return (next) => async (request) => {
+        const jar = session();
+        if (jar === undefined)
+            return next(request);
+        const named = request.header.get("host");
+        const site = new URL(request.url);
+        if (named !== null)
+            site.host = named;
+        const cookies = await jar.cookies(site.href);
+        if (cookies.length > 0 && !request.header.has("cookie"))
+            request.header.set("cookie", cookies.map((c) => `${c.name}=${c.value}`).join("; "));
+        const keep = async (headers) => {
+            const set = headers
+                .getSetCookie()
+                .flatMap((line) => parseSetCookie(line, site.href, now()) ?? []);
+            if (set.length > 0)
+                await jar.addCookies?.(set);
+        };
+        try {
+            const response = await next(request);
+            await keep(response.header);
+            return response;
+        }
+        catch (error) {
+            // A failed call's headers ride on its error; one that never reached
+            // the server has none.
+            await keep(ConnectError.from(error).metadata);
+            throw error;
+        }
+    };
+}
+/** Records drive calls on the timeline: the test's requests, the backend's answers. */
+function recordingInterceptor(recorder, correlation, protocol) {
+    return (next) => async (request) => {
+        const call = {
+            correlation: correlation(),
+            from: "test",
+            answeredBy: "network",
+            rpcProtocol: protocol,
+        };
+        const method = request.method;
+        try {
+            if (!request.stream)
+                recorder.out(call, method, request.message, true);
+            const response = await next(request.stream
+                ? {
+                    ...request,
+                    message: tapIterable(request.message, (m, i) => recorder.out(call, method, m, i === 0)),
+                }
+                : request);
+            if (!response.stream) {
+                recorder.in(call, method, response.message);
+                recorder.status(call, method);
+                return response;
+            }
+            return {
+                ...response,
+                message: (async function* () {
+                    try {
+                        for await (const message of response.message) {
+                            recorder.in(call, method, message);
+                            yield message;
+                        }
+                        recorder.status(call, method);
+                    }
+                    catch (error) {
+                        recorder.status(call, method, ConnectError.from(error));
+                        throw error;
+                    }
+                })(),
+            };
+        }
+        catch (error) {
+            recorder.status(call, method, ConnectError.from(error));
+            throw error;
+        }
+    };
+}
+export function createTransport(options, deps) {
+    const protocol = options.protocol ?? "connect";
+    // Outermost first: the defaults, then the session (which reads the `host`
+    // the defaults may have named), then the recorder, closest to the wire.
+    const interceptors = [];
+    if (options.headers !== undefined)
+        interceptors.push(headersInterceptor(options.headers));
+    interceptors.push(sessionInterceptor(deps.session, deps.now ?? Date.now));
+    if (deps.recorder !== undefined && deps.correlation !== undefined)
+        interceptors.push(recordingInterceptor(deps.recorder, deps.correlation, protocol));
+    const nodeOptions = options.ignoreHttpsErrors
+        ? { rejectUnauthorized: false }
+        : undefined;
+    const common = {
+        baseUrl: options.baseURL,
+        interceptors,
+        useBinaryFormat: options.binary ?? true,
+    };
+    if (protocol === "grpc") {
+        // The transport's own session manager would be out of reach; this one
+        // is handed to whoever has to close it.
+        const sessionManager = new Http2SessionManager(options.baseURL, undefined, nodeOptions);
+        deps.onConnection?.(sessionManager);
+        return createGrpcTransport({ ...common, sessionManager });
+    }
+    const http1 = { ...common, httpVersion: "1.1", nodeOptions };
+    if (protocol === "grpc-web")
+        return createGrpcWebTransport(http1);
+    return createConnectTransport(http1);
+}
+/**
+ * A typed client for a real backend, outside any stage: the `rpc` helper an
+ * e2e suite otherwise writes by hand — framing, status parsing and all — per
+ * protocol. Errors arrive as `ConnectError` with the server's code.
+ *
+ * Over gRPC it holds an HTTP/2 connection, which connect-node keeps for 15
+ * minutes once idle. It does not keep the process alive, but a server in the
+ * same process waits for it before it finishes closing. A stage's client is
+ * closed with the stage.
+ */
+export function createRpcClient(service, options) {
+    return createClient(service, createTransport(options, { session: () => options.session }));
+}
+//# sourceMappingURL=client.js.map

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

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

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

@@ -0,0 +1,14 @@
+import { type WirePlugin } from "../../../entities/plugin/index.js";
+import type { ConnectApi, ConnectOptions } from "../model/types.js";
+/**
+ * Connect, gRPC-web and gRPC: stubs answered by connect-es's own protocol
+ * handlers, recording of real traffic, drive clients, and out-of-process
+ * servers.
+ *
+ * The stubs never encode a frame by hand. Each one is a one-method Connect
+ * router whose handler runs the real server-side protocol, so the bytes the
+ * page receives are exactly what a Connect server would send — errors,
+ * trailers, JSON and binary alike.
+ */
+export declare function connect(options?: ConnectOptions): WirePlugin<"connect", ConnectApi>;
+//# sourceMappingURL=create-connect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-connect.d.ts","sourceRoot":"","sources":["../../../../src/features/connect/lib/create-connect.ts"],"names":[],"mappings":"AAIA,OAAO,EAGN,KAAK,UAAU,EACf,MAAM,mCAAmC,CAAC;AAG3C,OAAO,KAAK,EAEX,UAAU,EACV,cAAc,EAEd,MAAM,mBAAmB,CAAC;AAU3B;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CACtB,OAAO,GAAE,cAAmB,GAC1B,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,CAMnC"}

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

@@ -0,0 +1,124 @@
+import { createClient } from "@connectrpc/connect";
+import { definePlugin, } from "../../../entities/plugin/index.js";
+import { WirestageError } from "../../../shared/lib/errors/index.js";
+import { createSequence } from "../../../shared/lib/id/index.js";
+import { assembleCalls } from "./calls.js";
+import { createTransport } from "./client.js";
+import { stubAbort, stubHold } from "./faults.js";
+import { recordService } from "./record.js";
+import { createRecorder, endpointOf } from "./recorder.js";
+import { createRpcRules } from "./rules.js";
+import { serveRoutes } from "./serve.js";
+import { stubFailure, stubService, stubStream, stubUnary } from "./stubs.js";
+/**
+ * Connect, gRPC-web and gRPC: stubs answered by connect-es's own protocol
+ * handlers, recording of real traffic, drive clients, and out-of-process
+ * servers.
+ *
+ * The stubs never encode a frame by hand. Each one is a one-method Connect
+ * router whose handler runs the real server-side protocol, so the bytes the
+ * page receives are exactly what a Connect server would send — errors,
+ * trailers, JSON and binary alike.
+ */
+export function connect(options = {}) {
+    return definePlugin({
+        name: "connect",
+        scope: "Connect",
+        setup: (context) => createConnect(context, options),
+    });
+}
+function createConnect(context, options) {
+    const protocol = context.name;
+    const live = (options.streaming ?? "live") === "live";
+    const recorder = createRecorder(context.timeline, protocol);
+    const rules = createRpcRules(context, options, recorder, protocol);
+    const testCorrelation = createSequence("t");
+    const serverCorrelation = createSequence("s");
+    const servers = new Set();
+    /** Lets go of each call a hold still has, when the stage goes away. */
+    const heldCalls = new Set();
+    /** The drive clients' HTTP/2 connections, closed with the stage. */
+    const connections = new Set();
+    /** The record rules being added, once: every context gets them. */
+    let recording;
+    const api = {
+        service: (service, impl, stubOptions = {}) => stubService(rules, service, impl, stubOptions),
+        unary: (method, reply, stubOptions = {}) => stubUnary(context, rules, method, reply, stubOptions),
+        stream: (method, stubOptions = {}) => stubStream(context, rules, recorder, method, stubOptions, live),
+        fail: (method, code, message, stubOptions = {}) => stubFailure(rules, method, code, message, stubOptions),
+        abort: (method, abortOptions = {}) => stubAbort(rules, recorder, method, abortOptions),
+        hold: (method, holdOptions = {}) => stubHold(context, rules, recorder, method, holdOptions, heldCalls),
+        record: (service) => recordService(rules, service),
+        async calls(method) {
+            await context.sync();
+            return assembleCalls(context.timeline.frames({ protocol, endpoint: endpointOf(method) }));
+        },
+        client(service, clientOptions = {}) {
+            const { session, baseURL: requested, ...transportOptions } = clientOptions;
+            const base = requested ?? options.baseURL ?? "/";
+            const origin = context.attachments()[0]?.baseURL ?? context.baseURL;
+            if (!/^https?:\/\//.test(base) && origin === undefined)
+                throw new WirestageError("INVALID_ARGUMENT", `client(${service.typeName}): "${base}" is relative and the stage has no baseURL; pass an absolute baseURL or give the stage one`);
+            return createClient(service, createTransport({
+                ...transportOptions,
+                baseURL: new URL(base, origin).href.replace(/\/+$/, ""),
+                protocol: transportOptions.protocol ?? options.clientProtocol ?? "connect",
+            }, {
+                // Resolved per call: a context attached after the client was made
+                // still lends it its session.
+                session: () => session === null
+                    ? undefined
+                    : (session ?? context.attachments()[0]?.cookies),
+                now: () => context.clock.now(),
+                recorder,
+                correlation: testCorrelation,
+                onConnection: (connection) => connections.add(connection),
+            }));
+        },
+        async serve(routes, serveOptions = {}) {
+            const server = await serveRoutes(routes, serveOptions, {
+                recorder,
+                correlation: serverCorrelation,
+            });
+            const tracked = {
+                url: server.url,
+                port: server.port,
+                close: async () => {
+                    servers.delete(tracked);
+                    await server.close();
+                },
+            };
+            servers.add(tracked);
+            return tracked;
+        },
+    };
+    return {
+        api,
+        async attach() {
+            const services = options.record;
+            if (services === undefined)
+                return;
+            recording ??= (async () => {
+                for (const service of services)
+                    await api.record(service);
+            })().catch((error) => {
+                // Only the first rule can fail, installing the context's route, and
+                // the router takes it back: the next attach starts over.
+                recording = undefined;
+                throw error;
+            });
+            await recording;
+        },
+        async dispose() {
+            for (const letGo of [...heldCalls])
+                letGo();
+            // A drive client's connection outlives its calls; left open, a
+            // server in the test's own process would wait for it on close.
+            for (const connection of connections)
+                connection.abort();
+            connections.clear();
+            await Promise.all([...servers].map((server) => server.close()));
+        },
+    };
+}
+//# sourceMappingURL=create-connect.js.map

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

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

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

@@ -0,0 +1,18 @@
+import type { DescMessage, DescMethod, DescMethodServerStreaming, DescMethodUnary } from "@bufbuild/protobuf";
+import type { AbortErrorCode, PluginContext } from "../../../entities/plugin/index.js";
+import type { HoldOptions, HoldStub, StubHandle, StubOptions } from "../model/types.js";
+import { type Recorder } from "./recorder.js";
+import type { RpcRules } from "./rules.js";
+/** Fail every call to a method at the network level. */
+export declare function stubAbort<I extends DescMessage>(rules: RpcRules, recorder: Recorder, method: DescMethod & {
+    readonly input: I;
+}, options: StubOptions<I> & {
+    readonly error?: AbortErrorCode;
+}): Promise<StubHandle>;
+/**
+ * Hold calls at the network boundary until the test decides each one. The
+ * returned `abandon` lets go of whatever is still held, for the stage's
+ * disposal: a route left undecided would keep its request open for good.
+ */
+export declare function stubHold<I extends DescMessage, O extends DescMessage>(context: PluginContext, rules: RpcRules, recorder: Recorder, method: DescMethodUnary<I, O> | DescMethodServerStreaming<I, O>, options: HoldOptions<I>, pending: Set<() => void>): Promise<HoldStub<I, O>>;
+//# sourceMappingURL=faults.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"faults.d.ts","sourceRoot":"","sources":["../../../../src/features/connect/lib/faults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,WAAW,EACX,UAAU,EACV,yBAAyB,EACzB,eAAe,EAGf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EACX,cAAc,EAEd,aAAa,EACb,MAAM,mCAAmC,CAAC;AAK3C,OAAO,KAAK,EAEX,WAAW,EACX,QAAQ,EACR,UAAU,EACV,WAAW,EACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAW,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGpD,wDAAwD;AACxD,wBAAsB,SAAS,CAAC,CAAC,SAAS,WAAW,EACpD,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,UAAU,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,EAC1C,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAA;CAAE,GAC3D,OAAO,CAAC,UAAU,CAAC,CAarB;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,WAAW,EAC1E,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,yBAAyB,CAAC,CAAC,EAAE,CAAC,CAAC,EAC/D,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EACvB,OAAO,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,GACtB,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAqEzB"}

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

@@ -0,0 +1,85 @@
+import { createArrivals, createDeferred, } from "../../../shared/lib/async/index.js";
+import { endpointOf } from "./recorder.js";
+import { failingImpl, handleOf } from "./stubs.js";
+/** Fail every call to a method at the network level. */
+export async function stubAbort(rules, recorder, method, options) {
+    const error = options.error ?? "failed";
+    return handleOf(await rules.add({
+        method,
+        label: `abort ${endpointOf(method)}`,
+        options,
+        respond(view) {
+            recorder.fault(rules.callOf(view), method, "abort", { error });
+            return { type: "abort", error };
+        },
+    }));
+}
+/**
+ * Hold calls at the network boundary until the test decides each one. The
+ * returned `abandon` lets go of whatever is still held, for the stage's
+ * disposal: a route left undecided would keep its request open for good.
+ */
+export async function stubHold(context, rules, recorder, method, options, pending) {
+    const calls = createArrivals({
+        clock: context.clock,
+        label: `${endpointOf(method)} held call`,
+    });
+    const rule = await rules.add({
+        method,
+        label: `hold ${endpointOf(method)}`,
+        options,
+        observe: true,
+        async respond(view, [request]) {
+            const decision = createDeferred();
+            const carried = createDeferred();
+            /** The first decision stands; each resolves once it is carried out. */
+            const decide = (make) => {
+                decision.resolve(make);
+                return carried.promise;
+            };
+            const aborted = (error) => () => {
+                recorder.fault(rules.callOf(view), method, "abort", { error });
+                return { type: "abort", error };
+            };
+            const answered = (impl) => () => rules.answer(rules.handler(method, impl), method, view);
+            const abandon = () => void decide(aborted("aborted"));
+            pending.add(abandon);
+            calls.push({
+                request: request,
+                view,
+                release: () => decide(() => ({ type: "fallback" })),
+                reply: (message) => decide(answered((method.methodKind === "server_streaming"
+                    ? async function* () {
+                        yield message;
+                    }
+                    : async () => message))),
+                fail: (code, message) => decide(answered(failingImpl(method, code, message))),
+                abort: (error) => decide(aborted(error ?? "failed")),
+            });
+            try {
+                return await (await decision.promise)();
+            }
+            finally {
+                pending.delete(abandon);
+                carried.resolve();
+            }
+        },
+    });
+    return {
+        ...handleOf(rule),
+        get hits() {
+            return rule.hits;
+        },
+        next: (waitOptions) => calls.next(waitOptions),
+        get calls() {
+            return calls.items;
+        },
+        async releaseAll() {
+            // Removed first: a call on its way in as this runs is not the
+            // rule's any more, and goes straight on instead of being held.
+            await rule.remove();
+            await Promise.all(calls.items.map((call) => call.release()));
+        },
+    };
+}
+//# sourceMappingURL=faults.js.map

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

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

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

@@ -0,0 +1,42 @@
+import { type DescMessage, type JsonReadOptions, type MessageShape } from "@bufbuild/protobuf";
+import type { HttpRequestView, PassthroughResponse } from "../../../entities/plugin/index.js";
+import type { RpcProtocol } from "../model/types.js";
+/** How one request (and so its response) is encoded on the wire. */
+export interface WireFormat {
+    readonly protocol: RpcProtocol;
+    /** Protobuf binary, or JSON. */
+    readonly binary: boolean;
+    /** gRPC-web-text: the whole body is base64. */
+    readonly base64: boolean;
+    /** Length-prefixed envelopes (every protocol's streaming form). */
+    readonly enveloped: boolean;
+}
+/**
+ * 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 declare function detectFormat(request: Pick<HttpRequestView, "method" | "url" | "headers">): WireFormat | undefined;
+export interface RpcStatus {
+    /** 0 is OK; otherwise the gRPC / Connect code number. */
+    readonly code: number;
+    readonly message: string;
+}
+export interface DecodedBody {
+    /** Message payloads, decompressed when the encoding is gzip. */
+    readonly messages: readonly Uint8Array[];
+    readonly status: RpcStatus | undefined;
+}
+/** The request's messages, from its body or (Connect GET) its query. */
+export declare function decodeRequestBody(format: WireFormat, request: Pick<HttpRequestView, "url" | "headers" | "body">): Uint8Array[];
+/** Messages and status from a response the real backend sent. */
+export declare function decodeResponseBody(format: WireFormat, response: PassthroughResponse): DecodedBody;
+/** Parse a message payload with the request's format. */
+export declare function parseMessage<Desc extends DescMessage>(schema: Desc, bytes: Uint8Array, binary: boolean, jsonOptions?: Partial<JsonReadOptions>): MessageShape<Desc>;
+/**
+ * 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 declare function connectError(body: Uint8Array, httpStatus: number): RpcStatus;
+//# sourceMappingURL=protocol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../../src/features/connect/lib/protocol.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,KAAK,WAAW,EAGhB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,KAAK,EACX,eAAe,EACf,mBAAmB,EACnB,MAAM,mCAAmC,CAAC;AAW3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,oEAAoE;AACpE,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,mEAAmE;IACnE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC3B,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC,GAC1D,UAAU,GAAG,SAAS,CAqDxB;AAED,MAAM,WAAW,SAAS;IACzB,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;CACvC;AAID,wEAAwE;AACxE,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC,GACxD,UAAU,EAAE,CAwBd;AAED,iEAAiE;AACjE,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,mBAAmB,GAC3B,WAAW,CAqDb;AAED,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,IAAI,SAAS,WAAW,EACpD,MAAM,EAAE,IAAI,EACZ,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,OAAO,EACf,WAAW,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GACpC,YAAY,CAAC,IAAI,CAAC,CAOpB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,CAW5E"}