@procedures/client 0.37.0 → 0.39.0

package/dist/testing/transport-contract.js

@@ -0,0 +1,387 @@
+/**
+ * The transport contract (roadmap CLI-85, invariant I4 of ARCHITECTURE.md): one suite of wire
+ * cases that each face of the procedures server runs. `WIRE-PROTOCOL.md` is the contract.
+ *
+ * A face gives a factory (`ContractFace`): it starts a server of the face with the procedures of
+ * the suite, and it connects callers. The suite then runs the same cases over each face:
+ *
+ * - a call and its value, on paths of 1, 2 and 4 segments, and segments with "." and "%" (D36, CLI-75)
+ * - `NOT_FOUND` for an unknown path and for an empty segment, and `VALIDATION_ERROR`
+ * - the code, the message and the retryable flag of a handler error, for a value and for a stream (CLI-58, CLI-68)
+ * - the error policy `expose: "coded"` of the server (CLI-80)
+ * - `VERSION_CONFLICT` and its conflicts (CLI-16)
+ * - the items of a stream and its end, the abort of a call and the cancel of a stream
+ * - the deadline of the caller
+ * - the token, and the principal of the request hook in the handler (CLI-1, R18)
+ * - a subscription to the change topic of a collection: the hint arrives (CLI-15, CLI-75)
+ * - the refusal of a request above the size limit of the face
+ *
+ * A face that does not have a feature by design declares it in its capabilities, and the suite
+ * skips the cases of that feature. Each skip thus is data in the test file of the face.
+ *
+ * The suite is the entry point `@procedures/client/testing`, so a face in another package (and
+ * a server of an app, for example Graph) runs the same cases with the client that it uses. The
+ * suite imports no test runner: the caller gives `describe`, `it`, `afterEach` and `expect`
+ * (`ContractRunner`). Those of Vitest fit.
+ */
+import { z } from "zod";
+import { Client, VersionConflictError, collectionChangeTopic, collectionTopicRule, createCollectionProcedures, createProcedure, createRegistry, ms, pathToMethod, subscribeRemote, versionConflictsOf, } from "../index.js";
+import { createOverallTimeoutMiddleware } from "../client/index.js";
+import { LogStorage } from "./log-storage.js";
+/** The token of the server of a face with `auth`. */
+export const CONTRACT_TOKEN = "contract-token-0123456789";
+/** The principal that the request hook gives for the token. */
+export const CONTRACT_PRINCIPAL = "contract-user";
+/** The collection of the suite. Its name has a dot and a `%`, so the codec must keep it one segment (D36). */
+export const CONTRACT_COLLECTION = "contract.tabs%";
+/** The paths of the path case: 1, 2 and 4 segments, and segments with "." and "%" (CLI-28, CLI-75). */
+export const CONTRACT_PATHS = [
+    ["morning"],
+    ["contract", "path"],
+    ["contract", "a", "b", "path"],
+    ["contract", "dot.ted", "path"],
+    ["contract", "100%", "path"],
+    ["contract", "%2E", "path"],
+];
+/** The description of a procedure of the suite: a face can find its tool by it. */
+export function contractDescription(path) {
+    return `contract ${JSON.stringify(path)}`;
+}
+/** The size of the request of the size case, and the limit that the face gets. */
+const SIZE_LIMIT = 16 * 1024;
+const CONFLICTS = [
+    { id: "a", expected: "1", found: true, value: { n: 2 }, version: "2" },
+    { id: "b", expected: null, found: false, version: null },
+];
+/** The procedures of the suite. */
+function registryOf(seen) {
+    const read = { reads: [], writes: [] };
+    const procedure = (path) => createProcedure().path([...path]).meta({ effects: read, description: contractDescription(path) });
+    const failure = (input) => Object.assign(new Error("it failed"), input.code === undefined ? {} : { code: input.code }, input.retryable === undefined ? {} : { retryable: input.retryable });
+    return createRegistry({
+        name: "transport-contract",
+        procedures: [
+            procedure(["contract", "echo"])
+                .input(z.object({ text: z.string() }))
+                .output(z.object({ text: z.string() }))
+                .handler(async (input, ctx) => {
+                seen.echoes++;
+                const deadline = ctx.capability?.deadline;
+                if (deadline !== undefined)
+                    seen.deadlineLeft.push(deadline - Date.now());
+                seen.headers.push(ctx.metadata?.["headers"]);
+                return { text: input.text };
+            })
+                .build(),
+            procedure(["contract", "whoami"])
+                .input(z.object({}))
+                .output(z.object({ principal: z.string().nullable() }))
+                .handler(async (_input, ctx) => ({ principal: ctx.principal?.id ?? null }))
+                .build(),
+            ...CONTRACT_PATHS.map((path) => procedure(path)
+                .input(z.object({}).passthrough())
+                .output(z.object({ path: z.array(z.string()) }))
+                .handler(async (_input, ctx) => ({ path: [...ctx.path] }))
+                .build()),
+            procedure(["contract", "count"])
+                .input(z.object({ to: z.number() }))
+                .output(z.number())
+                .handler(async function* (input) {
+                for (let n = 1; n <= input.to; n++)
+                    yield n;
+            })
+                .build(),
+            procedure(["contract", "endless"])
+                .input(z.object({}))
+                .output(z.number())
+                .handler(async function* () {
+                try {
+                    for (let n = 1;; n++) {
+                        yield n;
+                        await new Promise((resolve) => setTimeout(resolve, 5));
+                    }
+                }
+                finally {
+                    seen.streamClosed++;
+                }
+            })
+                .build(),
+            procedure(["contract", "wait"])
+                .input(z.object({}))
+                .output(z.string())
+                .handler(async (_input, ctx) => {
+                seen.waiting++;
+                await new Promise((resolve) => {
+                    const timer = setTimeout(resolve, 5000);
+                    ctx.signal?.addEventListener("abort", () => {
+                        clearTimeout(timer);
+                        seen.aborted++;
+                        resolve();
+                    }, { once: true });
+                });
+                return "ended";
+            })
+                .build(),
+            procedure(["contract", "fail"])
+                .input(z.object({ code: z.string().optional(), retryable: z.boolean().optional() }))
+                .output(z.string())
+                .handler(async (input) => {
+                throw failure(input);
+            })
+                .build(),
+            // A stream that fails after its items: one item, or the count of the input
+            procedure(["contract", "failStream"])
+                .input(z.object({ code: z.string().optional(), retryable: z.boolean().optional(), items: z.number().optional() }))
+                .output(z.number())
+                .handler(async function* (input) {
+                for (let n = 1; n <= (input.items ?? 1); n++)
+                    yield n;
+                throw failure(input);
+            })
+                .build(),
+            procedure(["contract", "conflict"])
+                .input(z.object({}))
+                .output(z.string())
+                .handler(async () => {
+                throw new VersionConflictError(CONFLICTS);
+            })
+                .build(),
+            ...createCollectionProcedures(CONTRACT_COLLECTION),
+        ],
+    });
+}
+/** The error of a promise, or a failure when it resolves. */
+async function errorOf(promise) {
+    try {
+        await promise;
+    }
+    catch (error) {
+        return error;
+    }
+    throw new Error("The call did not fail");
+}
+/** The items of a stream. */
+async function itemsOf(stream) {
+    const items = [];
+    for await (const item of stream)
+        items.push(item);
+    return items;
+}
+async function waitFor(check, what, limit = 3000) {
+    const end = Date.now() + limit;
+    while (!check()) {
+        if (Date.now() > end)
+            throw new Error(`waitFor: ${what}`);
+        await new Promise((resolve) => setTimeout(resolve, 5));
+    }
+}
+/**
+ * A caller of a `Client` over a transport of the client: HTTP, WebSocket, a message port or the
+ * local transport. Each face of the client uses it.
+ */
+export function clientCaller(transport, close) {
+    const clientOf = (options) => {
+        const client = new Client({ transport, throwOnError: true });
+        return options?.deadlineMs === undefined ? client : client.use(createOverallTimeoutMiddleware({ overall: ms(options.deadlineMs) }));
+    };
+    const callOptions = (options) => (options?.signal ? { signal: options.signal } : {});
+    return {
+        call: (path, input, options) => clientOf(options).call(pathToMethod([...path]), input, callOptions(options)),
+        stream: (path, input, options) => clientOf(options).stream(pathToMethod([...path]), input, callOptions(options)),
+        events: transport,
+        ...(close ? { close } : {}),
+    };
+}
+/**
+ * This function declares the cases of the transport contract for one face. Call it at the top
+ * level of the test file of the face, with the functions of the test runner:
+ * `describeTransportContract(face, { describe, it, afterEach, expect })`.
+ */
+export function describeTransportContract(face, runner) {
+    const caps = face.capabilities;
+    const { describe, it, afterEach, expect } = runner;
+    let open = [];
+    afterEach(async () => {
+        for (const close of open.reverse())
+            await close().catch(() => undefined);
+        open = [];
+    });
+    const fresh = () => ({ deadlineLeft: [], waiting: 0, aborted: 0, streamClosed: 0, echoes: 0, headers: [] });
+    /** A server of the face, with the procedures of the suite. */
+    async function serve(seen, more = {}) {
+        const storage = new LogStorage();
+        const principalOf = (credentials) => credentials.bearer === CONTRACT_TOKEN ? { principal: { id: CONTRACT_PRINCIPAL, via: "contract" } } : undefined;
+        const spec = {
+            registry: registryOf(seen),
+            collections: { [CONTRACT_COLLECTION]: storage },
+            events: { topics: collectionTopicRule(CONTRACT_COLLECTION) },
+            ...(caps.auth ? { token: CONTRACT_TOKEN, principalOf } : {}),
+            ...more,
+        };
+        const server = await face.start(spec);
+        open.push(() => server.stop());
+        return { server, storage };
+    }
+    /** A caller of the face, with the token when the face has `auth`. */
+    async function connect(server, bearer = caps.auth ? CONTRACT_TOKEN : null) {
+        const caller = await server.connect(bearer ?? undefined);
+        if (caller.close)
+            open.push(() => caller.close());
+        return caller;
+    }
+    async function start(seen = fresh(), more = {}) {
+        return connect((await serve(seen, more)).server);
+    }
+    describe(`the transport contract over ${face.name} (CLI-85)`, () => {
+        it("gives the value of a call", async () => {
+            const caller = await start();
+            expect(await caller.call(["contract", "echo"], { text: "hi" })).toEqual({ text: "hi" });
+        });
+        it("calls a path of 1, 2 and 4 segments, and keeps a segment with a dot or a % as one segment (CLI-28, CLI-75)", async () => {
+            const caller = await start();
+            for (const path of CONTRACT_PATHS)
+                expect(await caller.call(path, {}), JSON.stringify(path)).toEqual({ path });
+        });
+        it("gives NOT_FOUND for an unknown path and for a path with an empty segment", async () => {
+            const caller = await start();
+            expect(await errorOf(caller.call(["contract", "missing"], {}))).toMatchObject({ code: "NOT_FOUND", retryable: false });
+            expect(await errorOf(caller.call(["contract", "dot", "path"], {}))).toMatchObject({ code: "NOT_FOUND" });
+            expect(await errorOf(caller.call(["contract", ""], {}))).toMatchObject({ code: "NOT_FOUND" });
+        });
+        it("gives VALIDATION_ERROR for an input that is not valid, and the handler does not run", async () => {
+            const seen = fresh();
+            const caller = await start(seen);
+            expect(await errorOf(caller.call(["contract", "echo"], { text: 5 }))).toMatchObject({ code: "VALIDATION_ERROR", retryable: false });
+            expect(seen.echoes).toBe(0);
+        });
+        it("keeps the code, the message and the flag of a handler error, for a value and for a stream (CLI-58, CLI-68)", async () => {
+            const caller = await start();
+            // The flag, on a face that carries it
+            const flag = (retryable) => (caps.retryable ? { retryable } : {});
+            expect(await errorOf(caller.call(["contract", "fail"], { code: "E_CUSTOM" }))).toMatchObject({ code: "E_CUSTOM", message: "it failed", retryable: false });
+            expect(await errorOf(caller.call(["contract", "fail"], { code: "E_CUSTOM", retryable: true }))).toMatchObject({ code: "E_CUSTOM", ...flag(true) });
+            expect(await errorOf(caller.call(["contract", "fail"], {}))).toMatchObject({ code: "HANDLER_ERROR", message: "it failed" });
+            // Without a flag, an error before the first item gets the flag of its code
+            expect(await errorOf(caller.call(["contract", "fail"], { code: "UNAVAILABLE" }))).toMatchObject({ code: "UNAVAILABLE", ...flag(true) });
+            expect(await errorOf(caller.call(["contract", "fail"], { code: "UNAVAILABLE", retryable: false }))).toMatchObject({ code: "UNAVAILABLE", retryable: false });
+            expect(await errorOf(itemsOf(caller.stream(["contract", "failStream"], { code: "E_CUSTOM" })))).toMatchObject({ code: "E_CUSTOM", message: "it failed" });
+            expect(await errorOf(itemsOf(caller.stream(["contract", "failStream"], {})))).toMatchObject({ code: "HANDLER_ERROR" });
+            // After an item, an end without a flag is not retryable: a retry can send the items again
+            expect(await errorOf(itemsOf(caller.stream(["contract", "failStream"], { code: "UNAVAILABLE" })))).toMatchObject({ code: "UNAVAILABLE", retryable: false });
+            expect(await errorOf(itemsOf(caller.stream(["contract", "failStream"], { code: "UNAVAILABLE", retryable: true })))).toMatchObject({ code: "UNAVAILABLE", ...flag(true) });
+            // An end in the stream before its first item gets the flag of its code, as an error before the stream (CLI-68)
+            expect(await errorOf(itemsOf(caller.stream(["contract", "failStream"], { code: "UNAVAILABLE", items: 0 })))).toMatchObject({ code: "UNAVAILABLE", ...flag(true) });
+            expect(await errorOf(itemsOf(caller.stream(["contract", "failStream"], { code: "UNAVAILABLE", retryable: false, items: 0 })))).toMatchObject({ code: "UNAVAILABLE", retryable: false });
+            // The reader gets the items before the end
+            if (caps.streams === "items") {
+                const items = [];
+                await errorOf((async () => {
+                    for await (const item of caller.stream(["contract", "failStream"], { code: "UNAVAILABLE", items: 2 }))
+                        items.push(item);
+                })());
+                expect(items).toEqual([1, 2]);
+            }
+        });
+        it.skipIf(!caps.server)('applies the error policy of the server: under "coded", only a known code goes out (CLI-80)', async () => {
+            const logged = [];
+            const caller = await start(fresh(), { errors: { expose: "coded", codes: ["E_APP"] }, onError: (error) => void logged.push(error) });
+            expect(await errorOf(caller.call(["contract", "fail"], { code: "E_APP" }))).toMatchObject({ code: "E_APP", message: "it failed" });
+            expect(await errorOf(caller.call(["contract", "fail"], { code: "CONFLICT", retryable: true }))).toMatchObject({ code: "CONFLICT", message: "it failed", retryable: true });
+            // Each other error is INTERNAL_ERROR with the message "internal error", and it keeps its flag
+            expect(await errorOf(caller.call(["contract", "fail"], {}))).toMatchObject({ code: "INTERNAL_ERROR", message: "internal error", retryable: false });
+            expect(await errorOf(caller.call(["contract", "fail"], { code: "ECONNREFUSED", retryable: true }))).toMatchObject({ code: "INTERNAL_ERROR", message: "internal error", retryable: true });
+            expect(await errorOf(itemsOf(caller.stream(["contract", "failStream"], { code: "ECONNREFUSED" })))).toMatchObject({ code: "INTERNAL_ERROR", message: "internal error" });
+            // The server gives each hidden error to its logger
+            expect(logged.length).toBeGreaterThanOrEqual(3);
+        });
+        it("gives VERSION_CONFLICT, and the conflicts when the caller gets the metadata of an error (CLI-16)", async () => {
+            const caller = await start();
+            const error = await errorOf(caller.call(["contract", "conflict"], {}));
+            expect(error).toMatchObject({ code: "VERSION_CONFLICT", retryable: false });
+            if (caps.errorMetadata)
+                expect(versionConflictsOf(error)).toEqual(CONFLICTS);
+        });
+        it("gives the items of a stream in order, and then the end", async () => {
+            const caller = await start();
+            expect(await itemsOf(caller.stream(["contract", "count"], { to: 3 }))).toEqual([1, 2, 3]);
+            expect(await itemsOf(caller.stream(["contract", "count"], { to: 0 }))).toEqual([]);
+        });
+        it("aborts the handler when the caller aborts the call", async () => {
+            const seen = fresh();
+            const caller = await start(seen);
+            const controller = new AbortController();
+            const call = caller.call(["contract", "wait"], {}, { signal: controller.signal });
+            // The abort comes when the handler runs: on a slow runner, a call can take more than 50 ms to arrive
+            await waitFor(() => seen.waiting === 1, "the start of the handler");
+            controller.abort();
+            await errorOf(call);
+            await waitFor(() => seen.aborted === 1, "the abort of the handler");
+        });
+        it.skipIf(caps.streams !== "items")("ends the stream of the handler when the reader stops", async () => {
+            const seen = fresh();
+            const caller = await start(seen);
+            const items = [];
+            for await (const item of caller.stream(["contract", "endless"], {})) {
+                items.push(item);
+                if (items.length === 2)
+                    break;
+            }
+            expect(items).toEqual([1, 2]);
+            await waitFor(() => seen.streamClosed === 1, "the end of the stream of the handler");
+        });
+        it.skipIf(!caps.deadline)("gives the deadline of the caller to the handler", async () => {
+            const seen = fresh();
+            const caller = await start(seen);
+            await caller.call(["contract", "echo"], { text: "x" }, { deadlineMs: 3000 });
+            expect(seen.deadlineLeft[0]).toBeGreaterThan(2000);
+            expect(seen.deadlineLeft[0]).toBeLessThanOrEqual(3000);
+        });
+        it.skipIf(!caps.auth)("refuses a request without the token, and gives the principal of the request hook to the handler (CLI-1, R18)", async () => {
+            const seen = fresh();
+            const { server } = await serve(seen);
+            const refusal = caps.authRefusal === "connect" ? {} : { code: "UNAUTHORIZED" };
+            expect(await errorOf((await connect(server, null)).call(["contract", "echo"], { text: "x" }))).toMatchObject(refusal);
+            expect(await errorOf((await connect(server, "a-wrong-token-0123456789")).call(["contract", "echo"], { text: "x" }))).toMatchObject(refusal);
+            expect(seen.echoes).toBe(0);
+            const caller = await connect(server, CONTRACT_TOKEN);
+            expect(await caller.call(["contract", "whoami"], {})).toEqual({ principal: CONTRACT_PRINCIPAL });
+            expect(await caller.call(["contract", "echo"], { text: "x" })).toEqual({ text: "x" });
+            // The secret does not reach the handler
+            expect(JSON.stringify(seen.headers)).not.toContain(CONTRACT_TOKEN);
+        });
+        it.skipIf(!caps.subscriptions)("gives the change hint of a write to a subscriber of the topic of the collection (CLI-15, CLI-75)", async () => {
+            const caller = await start();
+            const topic = collectionChangeTopic(CONTRACT_COLLECTION);
+            const hints = [];
+            const topics = [];
+            const subscription = subscribeRemote(caller.events, topic, (data, event) => {
+                hints.push(data);
+                topics.push(event.topic);
+            });
+            open.push(async () => subscription());
+            await subscription.ready;
+            const collection = (operation) => ["collections", CONTRACT_COLLECTION, operation];
+            // A pull starts the chain of the events
+            await caller.call(collection("changes"), {});
+            await caller.call(collection("set"), { id: "t1", value: { title: "one" } });
+            await waitFor(() => hints.length >= 1, "the change hint");
+            expect(hints[0]).toMatchObject({ changed: ["t1"], deleted: [] });
+            expect(topics[0]).toBe(topic);
+            expect(await caller.call(collection("get"), { id: "t1" })).toEqual({ title: "one" });
+            expect(await caller.call(collection("find"), {})).toEqual([{ id: "t1", value: { title: "one" } }]);
+            await caller.call(collection("delete"), { id: "t1" });
+            await waitFor(() => hints.length >= 2, "the hint of the delete");
+            expect(hints[1]).toMatchObject({ changed: [], deleted: ["t1"] });
+        });
+        it.skipIf(!caps.sizeLimit)("refuses a request above the size limit of the face, and the handler does not run", async () => {
+            const seen = fresh();
+            const caller = await start(seen, { sizeLimit: SIZE_LIMIT });
+            const error = await errorOf(caller.call(["contract", "echo"], { text: "x".repeat(4 * SIZE_LIMIT) }));
+            expect(error).toMatchObject({ code: caps.sizeLimit.code, retryable: false });
+            expect(seen.echoes).toBe(0);
+            // A request below the limit passes
+            expect(await (await start(seen, { sizeLimit: SIZE_LIMIT })).call(["contract", "echo"], { text: "small" })).toEqual({ text: "small" });
+        });
+    });
+}
+//# sourceMappingURL=transport-contract.js.map

package/dist/testing/transport-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-contract.js","sourceRoot":"","sources":["../../src/testing/transport-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,MAAM,EACN,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,0BAA0B,EAC1B,eAAe,EACf,cAAc,EACd,EAAE,EACF,YAAY,EACZ,eAAe,EACf,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAQpE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAuH9C,qDAAqD;AACrD,MAAM,CAAC,MAAM,cAAc,GAAG,2BAA2B,CAAC;AAE1D,+DAA+D;AAC/D,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAElD,8GAA8G;AAC9G,MAAM,CAAC,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AAEpD,uGAAuG;AACvG,MAAM,CAAC,MAAM,cAAc,GAAmC;IAC5D,CAAC,SAAS,CAAC;IACX,CAAC,UAAU,EAAE,MAAM,CAAC;IACpB,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC;IAC9B,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC;IAC/B,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC;IAC5B,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,mFAAmF;AACnF,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,OAAO,YAAY,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;AAC5C,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,GAAG,EAAE,GAAG,IAAI,CAAC;AAa7B,MAAM,SAAS,GAAG;IAChB,EAAE,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE;IACtE,EAAE,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;CACzD,CAAC;AAEF,mCAAmC;AACnC,SAAS,UAAU,CAAC,IAAU;IAC5B,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACvC,MAAM,SAAS,GAAG,CAAC,IAAuB,EAAE,EAAE,CAAC,eAAe,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjJ,MAAM,OAAO,GAAG,CAAC,KAAqE,EAAE,EAAE,CACxF,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IACnK,OAAO,cAAc,CAAC;QACpB,IAAI,EAAE,oBAAoB;QAC1B,UAAU,EAAE;YACV,SAAS,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;iBAC5B,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;iBACrC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;iBACtC,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;gBACd,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC;gBAC1C,IAAI,QAAQ,KAAK,SAAS;oBAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;gBAC1E,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;gBAC7C,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;YAC9B,CAAC,CAAC;iBACD,KAAK,EAAE;YACV,SAAS,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;iBAC9B,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;iBACnB,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;iBACtD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;iBAC1E,KAAK,EAAE;YACV,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC7B,SAAS,CAAC,IAAI,CAAC;iBACZ,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;iBACjC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;iBAC/C,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;iBACzD,KAAK,EAAE,CACX;YACD,SAAS,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;iBAC7B,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;iBACnC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBAClB,OAAO,CAAC,KAAK,SAAS,CAAC,EAAE,KAAqB;gBAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC,EAAE;oBAAE,MAAM,CAAC,CAAC;YAC9C,CAAU,CAAC;iBACV,KAAK,EAAE;YACV,SAAS,CAAC,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;iBAC/B,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;iBACnB,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBAClB,OAAO,CAAC,KAAK,SAAS,CAAC;gBACtB,IAAI,CAAC;oBACH,KAAK,IAAI,CAAC,GAAG,CAAC,GAAI,CAAC,EAAE,EAAE,CAAC;wBACtB,MAAM,CAAC,CAAC;wBACR,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;oBACzD,CAAC;gBACH,CAAC;wBAAS,CAAC;oBACT,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtB,CAAC;YACH,CAAU,CAAC;iBACV,KAAK,EAAE;YACV,SAAS,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;iBAC5B,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;iBACnB,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBAClB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;gBAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACf,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;oBAClC,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;oBACxC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAC1B,OAAO,EACP,GAAG,EAAE;wBACH,YAAY,CAAC,KAAK,CAAC,CAAC;wBACpB,IAAI,CAAC,OAAO,EAAE,CAAC;wBACf,OAAO,EAAE,CAAC;oBACZ,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAC;gBACJ,CAAC,CAAC,CAAC;gBACH,OAAO,OAAO,CAAC;YACjB,CAAC,CAAC;iBACD,KAAK,EAAE;YACV,SAAS,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;iBAC5B,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;iBACnF,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBAClB,OAAO,CAAC,KAAK,EAAE,KAAqE,EAAE,EAAE;gBACvF,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC,CAAC;iBACD,KAAK,EAAE;YACV,2EAA2E;YAC3E,SAAS,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;iBAClC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;iBACjH,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBAClB,OAAO,CAAC,KAAK,SAAS,CAAC,EAAE,KAAiG;gBACzH,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE;oBAAE,MAAM,CAAC,CAAC;gBACtD,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;YACvB,CAAU,CAAC;iBACV,KAAK,EAAE;YACV,SAAS,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;iBAChC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;iBACnB,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBAClB,OAAO,CAAC,KAAK,IAAI,EAAE;gBAClB,MAAM,IAAI,oBAAoB,CAAC,SAAS,CAAC,CAAC;YAC5C,CAAC,CAAC;iBACD,KAAK,EAAE;YACV,GAAG,0BAA0B,CAAC,mBAAmB,CAAC;SACnD;KACF,CAAC,CAAC;AACL,CAAC;AAED,6DAA6D;AAC7D,KAAK,UAAU,OAAO,CAAC,OAAyB;IAC9C,IAAI,CAAC;QACH,MAAM,OAAO,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,KAAiE,CAAC;IAC3E,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;AAC3C,CAAC;AAED,6BAA6B;AAC7B,KAAK,UAAU,OAAO,CAAC,MAA8B;IACnD,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,KAAoB,EAAE,IAAY,EAAE,KAAK,GAAG,IAAI;IACrE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;IAC/B,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QAChB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;QAC1D,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,SAAoB,EAAE,KAA2B;IAC5E,MAAM,QAAQ,GAAG,CAAC,OAA6B,EAAE,EAAE;QACjD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,OAAO,OAAO,EAAE,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,8BAA8B,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;IACtI,CAAC,CAAC;IACF,MAAM,WAAW,GAAG,CAAC,OAA6B,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3G,OAAO;QACL,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;QAC5G,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;QAChH,MAAM,EAAE,SAAS;QACjB,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5B,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAkB,EAAE,MAAsB;IAClF,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC;IAC/B,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IACnD,IAAI,IAAI,GAA+B,EAAE,CAAC;IAC1C,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE;YAAE,MAAM,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACzE,IAAI,GAAG,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,GAAS,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IAElH,8DAA8D;IAC9D,KAAK,UAAU,KAAK,CAAC,IAAU,EAAE,IAAI,GAA0B,EAAE;QAC/D,MAAM,OAAO,GAAG,IAAI,UAAU,EAAE,CAAC;QACjC,MAAM,WAAW,GAAgB,CAAC,WAAW,EAAE,EAAE,CAC/C,WAAW,CAAC,MAAM,KAAK,cAAc,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,kBAAkB,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACjH,MAAM,IAAI,GAAiB;YACzB,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC;YAC1B,WAAW,EAAE,EAAE,CAAC,mBAAmB,CAAC,EAAE,OAAO,EAAE;YAC/C,MAAM,EAAE,EAAE,MAAM,EAAE,mBAAmB,CAAC,mBAAmB,CAAC,EAAE;YAC5D,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,GAAG,IAAI;SACR,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED,qEAAqE;IACrE,KAAK,UAAU,OAAO,CAAC,MAAsB,EAAE,MAAM,GAAkB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI;QACtG,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC;QACzD,IAAI,MAAM,CAAC,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAM,EAAE,CAAC,CAAC;QACnD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,UAAU,KAAK,CAAC,IAAI,GAAS,KAAK,EAAE,EAAE,IAAI,GAA0B,EAAE;QACzE,OAAO,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;IAED,QAAQ,CAAC,+BAA+B,IAAI,CAAC,IAAI,WAAW,EAAE,GAAG,EAAE;QACjE,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;YACzC,MAAM,MAAM,GAAG,MAAM,KAAK,EAAE,CAAC;YAC7B,MAAM,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1F,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4GAA4G,EAAE,KAAK,IAAI,EAAE;YAC1H,MAAM,MAAM,GAAG,MAAM,KAAK,EAAE,CAAC;YAC7B,KAAK,MAAM,IAAI,IAAI,cAAc;gBAAE,MAAM,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACjH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;YACxF,MAAM,MAAM,GAAG,MAAM,KAAK,EAAE,CAAC;YAC7B,MAAM,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YACvH,MAAM,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;YACzG,MAAM,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QAChG,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qFAAqF,EAAE,KAAK,IAAI,EAAE;YACnG,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YACpI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4GAA4G,EAAE,KAAK,IAAI,EAAE;YAC1H,MAAM,MAAM,GAAG,MAAM,KAAK,EAAE,CAAC;YAC7B,sCAAsC;YACtC,MAAM,IAAI,GAAG,CAAC,SAAkB,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC3E,MAAM,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3J,MAAM,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnJ,MAAM,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YAC5H,2EAA2E;YAC3E,MAAM,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACxI,MAAM,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YAC7J,MAAM,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YAC1J,MAAM,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;YACvH,0FAA0F;YAC1F,MAAM,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5J,MAAM,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC1K,+GAA+G;YAC/G,MAAM,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnK,MAAM,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YACxL,2CAA2C;YAC3C,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;gBAC7B,MAAM,KAAK,GAAc,EAAE,CAAC;gBAC5B,MAAM,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE;oBACxB,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;wBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC1H,CAAC,CAAC,EAAE,CAAC,CAAC;gBACN,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAChC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,4FAA4F,EAAE,KAAK,IAAI,EAAE;YAC/H,MAAM,MAAM,GAAY,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACpI,MAAM,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YACnI,MAAM,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3K,8FAA8F;YAC9F,MAAM,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YACpJ,MAAM,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1L,MAAM,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC;YACzK,mDAAmD;YACnD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kGAAkG,EAAE,KAAK,IAAI,EAAE;YAChH,MAAM,MAAM,GAAG,MAAM,KAAK,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACvE,MAAM,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5E,IAAI,IAAI,CAAC,aAAa;gBAAE,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC/E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;YACtE,MAAM,MAAM,GAAG,MAAM,KAAK,EAAE,CAAC;YAC7B,MAAM,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC1F,MAAM,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACrF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;YAClE,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YAClF,qGAAqG;YACrG,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,EAAE,0BAA0B,CAAC,CAAC;YACpE,UAAU,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;YACpB,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,EAAE,0BAA0B,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;YACrG,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,KAAK,GAAc,EAAE,CAAC;YAC5B,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;gBACpE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;oBAAE,MAAM;YAChC,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC9B,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,EAAE,sCAAsC,CAAC,CAAC;QACvF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;YACtF,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7E,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACnD,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,8GAA8G,EAAE,KAAK,IAAI,EAAE;YAC/I,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC;YACrB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;YACrC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;YAC/E,MAAM,CAAC,MAAM,OAAO,CAAC,CAAC,MAAM,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YACtH,MAAM,CAAC,MAAM,OAAO,CAAC,CAAC,MAAM,OAAO,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAC5I,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC5B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;YACrD,MAAM,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,CAAC;YACjG,MAAM,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;YACtF,wCAAwC;YACxC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,kGAAkG,EAAE,KAAK,IAAI,EAAE;YAC5I,MAAM,MAAM,GAAG,MAAM,KAAK,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,qBAAqB,CAAC,mBAAmB,CAAC,CAAC;YACzD,MAAM,KAAK,GAAoD,EAAE,CAAC;YAClE,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,MAAM,YAAY,GAAG,eAAe,CAA2C,MAAM,CAAC,MAAO,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;gBACpH,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC;YACtC,MAAM,YAAY,CAAC,KAAK,CAAC;YACzB,MAAM,UAAU,GAAG,CAAC,SAAiB,EAAE,EAAE,CAAC,CAAC,aAAa,EAAE,mBAAmB,EAAE,SAAS,CAAC,CAAC;YAC1F,wCAAwC;YACxC,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7C,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YAC5E,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,iBAAiB,CAAC,CAAC;YAC1D,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;YACjE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC9B,MAAM,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YACrF,MAAM,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;YACnG,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,wBAAwB,CAAC,CAAC;YACjE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,kFAAkF,EAAE,KAAK,IAAI,EAAE;YACxH,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;YAC5D,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;YACrG,MAAM,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAU,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YAC9E,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC5B,mCAAmC;YACnC,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACxI,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package",
   "name": "@procedures/client",
-  "version": "0.37.0",
+  "version": "0.39.0",
   "description": "Procedures as data for TypeScript: define typed procedures once and call them in process, over HTTP, WebSocket, the CLI or MCP. Streaming, middleware, retries, caching and a JSON program format.",
   "keywords": [
     "rpc",
@@ -74,6 +74,10 @@
     "./query": {
       "types": "./dist/procedures/collection/query.d.ts",
       "import": "./dist/procedures/collection/query.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.js"
     }
   },
   "files": [

package/src/adapters/http/server/handler.ts

@@ -23,7 +23,7 @@ import { lastResortError } from "../../../server/last-resort.js";
 import { decodeMetadataHeader, METADATA_HEADER_LIMIT } from "../shared/index.js";
 import { ERROR_REGISTRY } from "../../../client/errors/index.js";
 import { assertNamedOrigins, checkBrowserRequest, needsNamedOrigin, type BrowserGuardOptions } from "../../../server/browser-guard.js";
-import { isUnboundedStream } from "../../../server/procedure-server.js";
+import { isUnboundedStream } from "../../../server/stream-metadata.js";
 import { headerNames, isSecretHeader, queryRecord, requestCredentials, urlParts, withoutSecretHeaders } from "../../../server/request-auth.js";
 import { PROTOCOL_HEADER, PROTOCOL_VERSION, httpStatusOf, protocolVersionOf } from "../../../protocol.js";
 import { realClock, type Cancel, type Clock } from "../../../clock.js";
@@ -561,7 +561,8 @@ export function createProcedureHandler(server: RequestHandler, options: Procedur
         serverRequest = toServerRequest(req, await readBody(req));
       } catch (error) {
         const status = error instanceof BodyError ? error.httpStatus : 400;
-        sendError(res, status, (error as Error).message, "INVALID_REQUEST");
+        // A body above the limit is PAYLOAD_TOO_LARGE, as on the MCP face and the WebSocket face (CLI-85)
+        sendError(res, status, (error as Error).message, status === 413 ? "PAYLOAD_TOO_LARGE" : "INVALID_REQUEST");
         return;
       }
       if (!serverRequest) {

package/src/adapters/websocket/client/transport.ts

@@ -5,7 +5,7 @@
  * Supports automatic reconnection, heartbeats, and streaming.
  */
 
-import type { Transport, Message, ResponseItem } from "../../../client/types.js";
+import { ClientError, type Transport, type Message, type ResponseItem } from "../../../client/types.js";
 import type { WebSocketTransportOptions, WebSocketMessage, ServerRequestHandler, EventHandler, WebSocketClass } from "./types.js";
 import { WebSocketState } from "./types.js";
 import { withoutInternalKeys } from "../../metadata.js";
@@ -133,6 +133,19 @@ function detach(ws: WebSocket): void {
   ws.onerror = ignoreError;
 }
 
+/** The close code of a message above the limit of the other side (RFC 6455, 1009). */
+const MESSAGE_TOO_BIG = 1009;
+
+/**
+ * The error of a pending call when the server closes the connection with 1009: a message was
+ * above the limit of the server (`maxPayload`). The close drops each pending call of the
+ * connection, so each gets this error (CLI-85). Before, each got an error without a code.
+ */
+function tooLarge(id: string): ClientError {
+  const message = "The server closed the connection: a message was larger than its limit (1009)";
+  return new ClientError({ type: "error", code: "PAYLOAD_TOO_LARGE", message, retryable: false }, id);
+}
+
 function errorItem<TRes>(id: string, code: string, message: string, retryable: boolean): ResponseItem<TRes> {
   return { id, status: { type: "error", code, message, retryable }, payload: null as TRes, metadata: {} };
 }
@@ -375,7 +388,7 @@ export class WebSocketTransport implements Transport {
       ws.onclose = (event) => {
         if (this.ws !== ws) return;
         this.ws = null;
-        this.handleClose(event.reason);
+        this.handleClose(event.reason, event.code);
       };
 
       // Connection error
@@ -422,9 +435,9 @@ export class WebSocketTransport implements Transport {
   }
 
   /** Fail every request in progress (a stream ends with the error too). */
-  private failPending(reason: string): void {
-    for (const pending of this.pendingRequests.values()) {
-      pending.queue.fail(new Error(reason));
+  private failPending(reason: string, closeCode?: number): void {
+    for (const [id, pending] of this.pendingRequests) {
+      pending.queue.fail(closeCode === MESSAGE_TOO_BIG ? tooLarge(id) : new Error(reason));
       pending.timeout?.();
     }
     this.pendingRequests.clear();
@@ -433,7 +446,7 @@ export class WebSocketTransport implements Transport {
   /**
    * Handle WebSocket close.
    */
-  private handleClose(reason?: string): void {
+  private handleClose(reason?: string, closeCode?: number): void {
     this.stopHeartbeat();
     this.incoming?.abortAll();
     this.incoming = undefined;
@@ -450,7 +463,7 @@ export class WebSocketTransport implements Transport {
       this.options.onDisconnect(reason);
     }
 
-    this.failPending("WebSocket connection closed");
+    this.failPending("WebSocket connection closed", closeCode);
 
     if (willReconnect) {
       this.scheduleReconnect();

package/src/browser.ts

@@ -80,7 +80,8 @@ export type { ServerOptions } from "./server/server.js";
 // The error policy of a server: what an error tells the caller (roadmap CLI-80)
 export type { ServerErrorPolicy, ExposedError, ErrorCall } from "./server/error-policy.js";
 export { exposeError, lastResortError, HIDDEN_ERROR_MESSAGE, DEFAULT_KEPT_METADATA } from "./server/error-policy.js";
-export { ProcedureServer, createProcedureServer, STREAM_METADATA_KEY, isUnboundedStream, tokenMatches } from "./server/procedure-server.js";
+export { ProcedureServer, createProcedureServer, tokenMatches } from "./server/procedure-server.js";
+export { STREAM_METADATA_KEY, isUnboundedStream } from "./server/stream-metadata.js";
 // The credentials of a network request (roadmap R18), and the parts that a request hook reads (CLI-2a)
 export { credentialsOf, bearerOf, withoutSecretHeaders, cookiesOf, requestCredentials, LOCAL_CREDENTIALS, isLocalCredentials } from "./server/request-auth.js";
 export type { RequestCredentialsOptions } from "./server/request-auth.js";

package/src/client/validation/types.ts

@@ -77,6 +77,7 @@ export function methodToKey(method: Method): MethodKey {
  * Parse a method key back to a Method object.
  */
 export function keyToMethod(key: MethodKey): Method {
+  // path-check: the key of the validation middleware (service, operation and version), a public API of its own.
   const parts = key.split(".");
   if (parts.length === 3 && parts[2]) {
     return { service: parts[0]!, operation: parts[1]!, version: parts[2] };

package/src/procedures/collection/schemas.ts

@@ -93,6 +93,7 @@ const EXPECTED_VERSION_MESSAGE = `expectedVersion must be a string of at most ${
  */
 function expectedVersionError(data: Record<string, unknown>, path: (string | number)[] = []): ZodErrorLike | undefined {
   if (!("expectedVersion" in data) || data["expectedVersion"] === undefined || isExpectedVersion(data["expectedVersion"])) return undefined;
+  // path-check: the field path of the input in an error message.
   const message = path.length === 0 ? EXPECTED_VERSION_MESSAGE : `${path.join(".")}.${EXPECTED_VERSION_MESSAGE}`;
   return { message, errors: [{ path: [...path, "expectedVersion"], message }] };
 }

package/src/procedures/envelope.ts

@@ -324,6 +324,7 @@ function fromRef(ref: EnvelopeShape): { $ref: string } {
     throw new Error(`A ref to the root "names" needs a name: ["names", name, ...fields]. Got ${preview(refPath)}`);
   }
   const [name, ...fields] = steps.map((key) => keyText(key, refPath));
+  // path-check: the `$ref` text of a program: a name and its fields (PROGRAM-FORMAT.md).
   return { $ref: [name === LAST_NAME ? NATIVE_LAST : name, ...fields].join(".") };
 }
 
@@ -450,6 +451,7 @@ function toRef(ref: OutputRef): EnvelopeRef {
       `The $ref object ${preview(ref)} has other keys. The envelope form keeps only the path: keep this program in the $proc form`
     );
   }
+  // path-check: the `$ref` text of a program: a name and its fields (PROGRAM-FORMAT.md).
   const [name, ...fields] = refText.split(".");
   if (name === LAST_NAME) {
     throw new Error(

package/src/procedures/policy.ts

@@ -21,7 +21,7 @@
  */
 
 import type { AnyProcedure, ProcedurePath } from "./types.js";
-import { pathToKey } from "./types.js";
+import { keyToPath, pathToKey } from "./types.js";
 import { isDataDriven } from "./ref.js";
 
 /** The call policy of a host. */
@@ -79,7 +79,7 @@ export function validateCalls(calls: unknown, path: ProcedurePath): readonly str
       );
     }
     const body = entry.endsWith(".*") ? entry.slice(0, -2) : entry;
-    if (body.length === 0 || body.includes("*") || body.split(".").some((segment) => segment.length === 0)) {
+    if (body.length === 0 || body.includes("*") || keyToPath(body).some((segment) => segment.length === 0)) {
       throw new TypeError(`metadata.calls of ${where} has an invalid entry: "${entry}". Use "ns.name" or "ns.*".`);
     }
   }

package/src/procedures/program.ts

@@ -509,6 +509,7 @@ function combine(original: object, keys: readonly string[] | undefined, walk: Wa
 
 /** This function makes the document of a `$ref` in a scope. */
 function refDoc(value: OutputRef, walk: Walk): ProgramDocument {
+  // path-check: the `$ref` text of a program: a name and its fields (PROGRAM-FORMAT.md).
   const [first = "", ...fields] = value.$ref.split(".");
   const name = first === "$last" ? LAST : nameKey(first);
   // A run reads the origin only in the input of a deferred call. A check reads its pointer.
@@ -1157,7 +1158,9 @@ function unknownName(source: unknown, path: readonly unknown[]): Error {
     : path
         .slice(1)
         .map((key, index) => (index === 0 ? (key === LAST ? "$last" : nameOfKey(String(key))) : String(key)))
+        // path-check: the `$ref` text of a program: a name and its fields (PROGRAM-FORMAT.md).
         .join(".");
+  // path-check: the `$ref` text of a program: a name and its fields (PROGRAM-FORMAT.md).
   const name = text.split(".")[0];
   return new Error(
     `Unknown $ref name "${name}" in "${text}": no step, item or input has this name here. ` +

package/src/procedures/ref.ts

@@ -219,6 +219,7 @@ export function getPath(obj: unknown, path: string[]): unknown {
  * `found` is false when no scope has the name. A missing field is `found` with the value undefined.
  */
 export function lookupOutputRef(refPath: string, scope: RefScope | undefined): { found: boolean; value?: unknown } {
+  // path-check: the `$ref` text of a program: a name and its fields (PROGRAM-FORMAT.md).
   const [first, ...rest] = refPath.split(".");
   for (let current = scope; current; current = current.parent) {
     if (first === "$last") {