@relkit/runtime-hono 0.5.3 → 0.5.5

package/dist/realtime-rpc.js

@@ -1,134 +1,19 @@
-import { createHash } from "node:crypto";
 import { os } from "@orpc/server";
-import { REALTIME_RUNTIME_LIMITS } from "@relkit/contracts";
-import { assertExpectedIdentity } from "./rpc-identity.js";
-import { channelContext, validatePublicValue, } from "./realtime-rpc-support.js";
+import { observeRealtime, readRealtimePresence } from "./realtime-observation.js";
+/** Materializes channel procedures over the scoped realtime service.
+ * @param options - Channel providers and client identity configuration.
+ * @returns The existing subscribe and presence procedures, or none when disabled.
+ */
 export function realtimeProcedures(options) {
     if (options.realtime === undefined || options.clientIdentity === undefined)
         return {};
     return {
         "relkit.realtime.subscribe": os
             .$context()
-            .handler(({ input, context, signal }) => observe(input, context, options, signal)),
-        "relkit.realtime.presence": os.$context().handler(async ({ input, context }) => {
-            await assertExpectedIdentity(context, options.clientIdentity);
-            const resolved = await channelContext(input, context, options);
-            if (resolved.descriptor.presence === undefined)
-                throw new Error("Presence is not enabled.");
-            return resolved.provider.readPresence({
-                ...resolved.scope,
-                maxMembers: memberLimit(resolved.descriptor.presence),
-            });
-        }),
+            .handler(({ input, context, signal }) => observeRealtime(input, context, options, signal)),
+        "relkit.realtime.presence": os
+            .$context()
+            .handler(({ input, context }) => readRealtimePresence(input, context, options)),
     };
 }
-async function* observe(input, context, options, signal) {
-    await assertExpectedIdentity(context, options.clientIdentity, input.expectedIdentity);
-    let resolved = await channelContext(input, context, options);
-    const presenceOwner = resolved;
-    let after = resolved.descriptor.replay === undefined ? undefined : input.after;
-    let presenceRenewedAt = 0;
-    if (input.after !== undefined && resolved.descriptor.replay === undefined) {
-        const fence = await resolved.provider.readAfter({
-            ...resolved.scope,
-            limit: 1,
-            maxEncodedBytes: 64 * 1024,
-        });
-        yield { kind: "gap", reason: "replay-disabled", checkpoint: fence.checkpoint };
-        after = fence.checkpoint;
-    }
-    const controller = signal ?? new AbortController().signal;
-    const leaseId = crypto.randomUUID();
-    try {
-        if (resolved.descriptor.presence !== undefined) {
-            yield { kind: "presence", presence: await acquirePresence(resolved, leaseId) };
-            presenceRenewedAt = Date.now();
-        }
-        while (!controller.aborted) {
-            await assertExpectedIdentity(context, options.clientIdentity, input.expectedIdentity);
-            resolved = await channelContext(after === undefined
-                ? { channel: input.channel, params: input.params }
-                : { ...input, after }, context, options);
-            const page = await resolved.provider.readAfter({
-                ...resolved.scope,
-                ...(after === undefined ? {} : { after }),
-                limit: 100,
-                maxEncodedBytes: 1024 * 1024,
-            });
-            if (page.gap !== undefined)
-                yield { kind: "gap", reason: page.gap, checkpoint: page.checkpoint };
-            for (const record of page.events) {
-                await assertExpectedIdentity(context, options.clientIdentity, input.expectedIdentity);
-                resolved = await channelContext({ ...input, after: record.checkpoint }, context, options);
-                const schema = resolved.descriptor.events[record.event];
-                if (schema === undefined)
-                    continue;
-                const payload = await validatePublicValue(schema, record.payload);
-                yield { kind: "event", event: record.event, payload, checkpoint: record.checkpoint };
-            }
-            after = page.checkpoint;
-            if (resolved.descriptor.presence !== undefined && Date.now() - presenceRenewedAt >= 15_000) {
-                yield { kind: "presence", presence: await renewPresence(resolved, leaseId) };
-                presenceRenewedAt = Date.now();
-            }
-            if (!page.hasMore) {
-                yield { kind: "caught-up", checkpoint: after };
-                await resolved.provider.waitAfter({
-                    ...resolved.scope,
-                    after,
-                    deadlineMs: Date.now() + 15_000,
-                    signal: controller,
-                });
-            }
-        }
-    }
-    finally {
-        if (presenceOwner.descriptor.presence !== undefined) {
-            await presenceOwner.provider
-                .releasePresence({
-                ...presenceOwner.scope,
-                leaseId,
-                connectionId: leaseId,
-                maxMembers: memberLimit(presenceOwner.descriptor.presence),
-                maxConnections: REALTIME_RUNTIME_LIMITS.liveConnections,
-            })
-                .catch(() => undefined);
-        }
-    }
-}
-async function acquirePresence(resolved, leaseId) {
-    const presence = resolved.descriptor.presence;
-    const member = typeof presence === "object"
-        ? await validatePublicValue(presence.member, await presence.resolve(resolved.params, resolved.trusted))
-        : undefined;
-    return resolved.provider.acquirePresence({
-        ...resolved.scope,
-        leaseId,
-        connectionId: leaseId,
-        expiresAt: new Date(Date.now() + 45_000).toISOString(),
-        maxMembers: memberLimit(presence),
-        maxConnections: REALTIME_RUNTIME_LIMITS.liveConnections,
-        ...(member === undefined
-            ? {}
-            : { opaqueMemberId: memberId(resolved.scope), memberInfo: member }),
-    });
-}
-async function renewPresence(resolved, leaseId) {
-    return resolved.provider.renewPresence({
-        ...resolved.scope,
-        leaseId,
-        connectionId: leaseId,
-        expiresAt: new Date(Date.now() + 45_000).toISOString(),
-        maxMembers: memberLimit(resolved.descriptor.presence),
-        maxConnections: REALTIME_RUNTIME_LIMITS.liveConnections,
-    });
-}
-function memberId(scope) {
-    return createHash("sha256")
-        .update(`${scope.channelId}:${scope.partition}:${scope.identityScope}`)
-        .digest("hex");
-}
-function memberLimit(presence) {
-    return typeof presence === "object" ? presence.maxMembers : 1_000;
-}
 //# sourceMappingURL=realtime-rpc.js.map

package/dist/realtime-rpc.js.map

@@ -1 +1 @@
-{"version":3,"file":"realtime-rpc.js","sourceRoot":"","sources":["../src/realtime-rpc.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"realtime-rpc.js","sourceRoot":"","sources":["../src/realtime-rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAqB,MAAM,cAAc,CAAC;AAIrD,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAElF;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAoC;IAEpC,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACtF,OAAO;QACL,2BAA2B,EAAE,EAAE;aAC5B,QAAQ,EAAc;aACtB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CACtC,eAAe,CAAC,KAAuB,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CACnE;QACH,0BAA0B,EAAE,EAAE;aAC3B,QAAQ,EAAc;aACtB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAC9B,oBAAoB,CAAC,KAAuB,EAAE,OAAO,EAAE,OAAO,CAAC,CAChE;KACJ,CAAC;AACJ,CAAC"}

package/dist/realtime-runtime.d.ts

@@ -1,13 +1,2 @@
-import type { MaybePromise } from "@relkit/contracts";
-import type { RealtimeProvider } from "@relkit/realtime";
-import type { HttpAuthInvocation } from "./auth.js";
-export interface RealtimeRuntime {
-    readonly applicationId: string;
-    readonly environment: string;
-    readonly provider: (profile: string) => MaybePromise<RealtimeProvider>;
-    readonly trustedContext?: (input: {
-        readonly request: Request;
-        readonly auth?: HttpAuthInvocation;
-    }) => MaybePromise<unknown>;
-}
+export type { RealtimeRuntime } from "./realtime-runtime.types.js";
 //# sourceMappingURL=realtime-runtime.d.ts.map

package/dist/realtime-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"realtime-runtime.d.ts","sourceRoot":"","sources":["../src/realtime-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,YAAY,CAAC,gBAAgB,CAAC,CAAC;IACvE,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,kBAAkB,CAAC;KACpC,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC;CAC7B"}
+{"version":3,"file":"realtime-runtime.d.ts","sourceRoot":"","sources":["../src/realtime-runtime.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/realtime-runtime.types.d.ts

@@ -0,0 +1,14 @@
+import type { MaybePromise } from "@relkit/contracts";
+import type { RealtimeProvider } from "@relkit/realtime";
+import type { HttpAuthInvocation } from "./auth.js";
+/** Contract for realtime runtime used by realtime runtime. */
+export interface RealtimeRuntime {
+    readonly applicationId: string;
+    readonly environment: string;
+    readonly provider: (profile: string) => MaybePromise<RealtimeProvider>;
+    readonly trustedContext?: (input: {
+        readonly request: Request;
+        readonly auth?: HttpAuthInvocation;
+    }) => MaybePromise<unknown>;
+}
+//# sourceMappingURL=realtime-runtime.types.d.ts.map

package/dist/realtime-runtime.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-runtime.types.d.ts","sourceRoot":"","sources":["../src/realtime-runtime.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEpD,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,YAAY,CAAC,gBAAgB,CAAC,CAAC;IACvE,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,kBAAkB,CAAC;KACpC,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC;CAC7B"}

package/dist/realtime-runtime.types.js

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

package/dist/realtime-runtime.types.js.map

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

package/dist/request-body-service.d.ts

@@ -0,0 +1,23 @@
+import { Context, Effect, Layer } from "effect";
+import { HttpBoundaryError } from "./http-effect.js";
+import type { RequestBodyBytes } from "./request-body-service.types.js";
+export type { RequestBodyBytes } from "./request-body-service.types.js";
+declare const RequestBodyReader_base: Context.ServiceClass<RequestBodyReader, "@relkit/runtime-hono/RequestBodyReader", {
+    readonly read: (request: Request, maxBytes: number) => Effect.Effect<RequestBodyBytes, HttpBoundaryError>;
+}>;
+/** Owns the native reader until EOF, overflow, failure, or interruption.
+ * @example
+ * ```ts
+ * const read = Effect.flatMap(RequestBodyReader, (reader) =>
+ *   reader.read(new Request("http://example/body"), 2),
+ * ).pipe(Effect.provide(Layer.succeed(RequestBodyReader, {
+ *   read: () => Effect.succeed({ bytes: new Uint8Array([7]) }),
+ * })));
+ * ```
+ * @see tests/request-services.test.ts for checked service substitution and reader cleanup.
+ */
+export declare class RequestBodyReader extends RequestBodyReader_base {
+}
+/** Native implementation; replace this layer to supply deterministic body reads. */
+export declare const RequestBodyReaderLive: Layer.Layer<RequestBodyReader, never, never>;
+//# sourceMappingURL=request-body-service.d.ts.map

package/dist/request-body-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-body-service.d.ts","sourceRoot":"","sources":["../src/request-body-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAgB,iBAAiB,EAAe,MAAM,kBAAkB,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;;mBAgBrD,CACb,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,KACb,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;;AAjB3D;;;;;;;;;;GAUG;AACH,qBAAa,iBAAkB,SAAQ,sBAQM;CAAG;AAkEhD,oFAAoF;AACpF,eAAO,MAAM,qBAAqB,8CAEhC,CAAC"}

package/dist/request-body-service.js

@@ -0,0 +1,80 @@
+import { Context, Effect, Layer } from "effect";
+import { httpBoundary, HttpBoundaryError, observeHttp } from "./http-effect.js";
+/** Owns the native reader until EOF, overflow, failure, or interruption.
+ * @example
+ * ```ts
+ * const read = Effect.flatMap(RequestBodyReader, (reader) =>
+ *   reader.read(new Request("http://example/body"), 2),
+ * ).pipe(Effect.provide(Layer.succeed(RequestBodyReader, {
+ *   read: () => Effect.succeed({ bytes: new Uint8Array([7]) }),
+ * })));
+ * ```
+ * @see tests/request-services.test.ts for checked service substitution and reader cleanup.
+ */
+export class RequestBodyReader extends Context.Service()("@relkit/runtime-hono/RequestBodyReader") {
+}
+/** Read a bounded request body while retaining the reader until cleanup.
+ * @param request - Fetch request or clone whose body this operation owns.
+ * @param maxBytes - Positive maximum bytes accepted from headers or streamed chunks.
+ * @returns An effect yielding body bytes or an overflow issue, with native failures preserved.
+ */
+const read = Effect.fn("RequestBodyReader.read")(function* (request, maxBytes) {
+    if (!Number.isSafeInteger(maxBytes) || maxBytes < 1) {
+        return yield* Effect.fail(new HttpBoundaryError({
+            operation: "request.body",
+            cause: new RangeError("maxBodyBytes must be a positive integer"),
+        }));
+    }
+    /** Build the shared overflow result for header and streamed-byte limit checks.
+     * @returns A body-too-large issue naming the configured byte limit.
+     */
+    const oversized = () => ({
+        issue: {
+            code: "body-too-large",
+            message: `Request body exceeds ${maxBytes} bytes`,
+        },
+    });
+    const length = Number(request.headers.get("content-length"));
+    if (Number.isSafeInteger(length) && length > maxBytes)
+        return oversized();
+    if (request.body === null)
+        return { bytes: new Uint8Array() };
+    const body = request.body;
+    return yield* Effect.acquireUseRelease(Effect.sync(() => ({ reader: body.getReader(), complete: false })), (owned) => Effect.gen(function* () {
+        const chunks = [];
+        let total = 0;
+        while (true) {
+            const part = yield* httpBoundary("request.body.read", () => owned.reader.read());
+            if (part.done) {
+                owned.complete = true;
+                break;
+            }
+            total += part.value.byteLength;
+            if (total > maxBytes)
+                return oversized();
+            chunks.push(part.value);
+        }
+        const bytes = new Uint8Array(total);
+        let offset = 0;
+        for (const chunk of chunks) {
+            bytes.set(chunk, offset);
+            offset += chunk.byteLength;
+        }
+        return { bytes };
+    }), (owned) => Effect.sync(() => {
+        // Request.clone() tees the source. Its cancellation Promise also waits for
+        // the caller-owned branch, which must remain readable after mapping.
+        try {
+            if (!owned.complete)
+                void owned.reader.cancel().catch(() => undefined);
+        }
+        finally {
+            owned.reader.releaseLock();
+        }
+    }));
+});
+/** Native implementation; replace this layer to supply deterministic body reads. */
+export const RequestBodyReaderLive = Layer.succeed(RequestBodyReader, {
+    read: (request, maxBytes) => observeHttp("request.body", read(request, maxBytes)),
+});
+//# sourceMappingURL=request-body-service.js.map

package/dist/request-body-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-body-service.js","sourceRoot":"","sources":["../src/request-body-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAIhF;;;;;;;;;;GAUG;AACH,MAAM,OAAO,iBAAkB,SAAQ,OAAO,CAAC,OAAO,EAQnD,CAAC,wCAAwC,CAAC;CAAG;AAEhD;;;;GAIG;AACH,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,wBAAwB,CAAC,CAAC,QAAQ,CAAC,EAAE,OAAgB,EAAE,QAAgB;IAC5F,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACpD,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,IAAI,iBAAiB,CAAC;YACpB,SAAS,EAAE,cAAc;YACzB,KAAK,EAAE,IAAI,UAAU,CAAC,yCAAyC,CAAC;SACjE,CAAC,CACH,CAAC;IACJ,CAAC;IACD;;OAEG;IACH,MAAM,SAAS,GAAG,GAAqB,EAAE,CAAC,CAAC;QACzC,KAAK,EAAE;YACL,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,wBAAwB,QAAQ,QAAQ;SAClD;KACF,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC7D,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,QAAQ;QAAE,OAAO,SAAS,EAAE,CAAC;IAC1E,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,UAAU,EAAE,EAAE,CAAC;IAC9D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,iBAAiB,CACpC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,EAClE,CAAC,KAAK,EAAE,EAAE,CACR,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,MAAM,GAAiB,EAAE,CAAC;QAChC,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC,mBAAmB,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YACjF,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;gBACtB,MAAM;YACR,CAAC;YACD,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;YAC/B,IAAI,KAAK,GAAG,QAAQ;gBAAE,OAAO,SAAS,EAAE,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC;QAC7B,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC,CAAC,EACJ,CAAC,KAAK,EAAE,EAAE,CACR,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,2EAA2E;QAC3E,qEAAqE;QACrE,IAAI,CAAC;YACH,IAAI,CAAC,KAAK,CAAC,QAAQ;gBAAE,KAAK,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACzE,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC,CACL,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,oFAAoF;AACpF,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC,OAAO,CAAC,iBAAiB,EAAE;IACpE,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAC,WAAW,CAAC,cAAc,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;CAClF,CAAC,CAAC"}

package/dist/request-body-service.types.d.ts

@@ -0,0 +1,7 @@
+import type { BodyIssue } from "./request-mapping-body.js";
+/** A bounded body read, preserving the existing materialization issue envelope. */
+export interface RequestBodyBytes {
+    readonly bytes?: Uint8Array;
+    readonly issue?: BodyIssue;
+}
+//# sourceMappingURL=request-body-service.types.d.ts.map

package/dist/request-body-service.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-body-service.types.d.ts","sourceRoot":"","sources":["../src/request-body-service.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D,mFAAmF;AACnF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;CAC5B"}

package/dist/request-body-service.types.js

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

package/dist/request-body-service.types.js.map

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

package/dist/request-context.d.ts

@@ -1,4 +1,9 @@
 import type { Context } from "hono";
 import type { HttpRouteRequest } from "./materialize-routes.js";
+/** Materializes validated request values and routing parameters from Hono.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param pathPattern - Registered route path used to resolve catch-all parameters.
+ * @returns A frozen route request with raw request, parameters, repeated values and validated data.
+ */
 export declare function requestFromContext(context: Context, pathPattern?: string): HttpRouteRequest;
 //# sourceMappingURL=request-context.d.ts.map

package/dist/request-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../src/request-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAuB3F"}
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../src/request-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAuB3F"}

package/dist/request-context.js

@@ -1,3 +1,8 @@
+/** Materializes validated request values and routing parameters from Hono.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param pathPattern - Registered route path used to resolve catch-all parameters.
+ * @returns A frozen route request with raw request, parameters, repeated values and validated data.
+ */
 export function requestFromContext(context, pathPattern) {
     const query = {};
     const headers = {};
@@ -22,6 +27,11 @@ export function requestFromContext(context, pathPattern) {
         validated: validatedData(context),
     });
 }
+/** Combines Hono route parameters with declared catch-all path captures.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param pathPattern - Registered route path used to resolve catch-all parameters.
+ * @returns Frozen named parameters with catch-all captures represented as ordered arrays.
+ */
 function materializeParams(context, pathPattern) {
     const params = {};
     for (const [name, value] of Object.entries(context.req.param())) {
@@ -30,6 +40,10 @@ function materializeParams(context, pathPattern) {
     }
     return Object.freeze(params);
 }
+/** Reads validated Hono request data for supported mapping sources.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @returns A frozen map containing the validation targets Hono has populated.
+ */
 function validatedData(context) {
     const request = context.req;
     return Object.freeze(Object.fromEntries(["param", "query", "header", "cookie", "json", "form"].flatMap((target) => {
@@ -37,16 +51,30 @@ function validatedData(context) {
         return value === undefined ? [] : [[target, value]];
     })));
 }
+/** Locates the catch-all segment corresponding to a declared parameter.
+ * @param pathPattern - Registered route path used to resolve catch-all parameters.
+ * @param name - Declared field, header, stream or configuration key.
+ * @returns The catch-all segment index, or undefined when the named token is absent.
+ */
 function catchAllToken(pathPattern, name) {
     const token = pathPattern?.split("/").findIndex((segment) => {
         return segment === `*${name}` || segment === `*${name}?`;
     });
     return token === undefined || token < 0 ? undefined : token;
 }
+/** Decodes the URL path segments captured by a catch-all token.
+ * @param url - Request URL supplying decoded path segments.
+ * @param token - Declared catch-all token or CSRF value checked by policy.
+ * @returns Frozen decoded nonempty path segments captured from the token onward.
+ */
 function catchAllValues(url, token) {
     const segments = new URL(url).pathname.split("/").slice(token);
     return Object.freeze(segments.filter((segment) => segment !== "").map(decode));
 }
+/** Decodes a URL component while preserving malformed input for later validation.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns The decoded component, or its original text when percent encoding is malformed.
+ */
 function decode(value) {
     try {
         return decodeURIComponent(value);
@@ -55,6 +83,12 @@ function decode(value) {
         return value;
     }
 }
+/** Appends repeated request values without dropping previously observed values.
+ * @param target - Output object accumulating normalized request values.
+ * @param key - Declared property or field key.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns Nothing; the requested update is applied to the owned state.
+ */
 function append(target, key, value) {
     const previous = target[key];
     target[key] =

package/dist/request-context.js.map

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

package/dist/request-inference.d.ts

@@ -1,2 +1,13 @@
+/** Decode inferred request strings using the target input's JSON Schema.
+ * @param value - Value to validate or project.
+ * @param route - Route descriptor controlling request mapping.
+ * @param target - Target descriptor or validated request source.
+ * @returns Converted numbers/booleans, while explicit request mappings remain unchanged.
+ * @example
+ * import { z } from "@relkit/schema";
+ * const target = { input: z.object({ page: z.number(), active: z.boolean() }) };
+ * const input = decodeInferredInput({ page: "2", active: "true" }, {}, target);
+ * // input is { page: 2, active: true }.
+ */
 export declare function decodeInferredInput(value: unknown, route: unknown, target: unknown): unknown;
 //# sourceMappingURL=request-inference.d.ts.map

package/dist/request-inference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-inference.d.ts","sourceRoot":"","sources":["../src/request-inference.ts"],"names":[],"mappings":"AAKA,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAK5F"}
+{"version":3,"file":"request-inference.d.ts","sourceRoot":"","sources":["../src/request-inference.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAK5F"}

package/dist/request-inference.js

@@ -1,6 +1,17 @@
 import { getJsonSchema } from "@relkit/schema";
 const schemaCache = new WeakMap();
 const JSON_NUMBER = /^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/;
+/** Decode inferred request strings using the target input's JSON Schema.
+ * @param value - Value to validate or project.
+ * @param route - Route descriptor controlling request mapping.
+ * @param target - Target descriptor or validated request source.
+ * @returns Converted numbers/booleans, while explicit request mappings remain unchanged.
+ * @example
+ * import { z } from "@relkit/schema";
+ * const target = { input: z.object({ page: z.number(), active: z.boolean() }) };
+ * const input = decodeInferredInput({ page: "2", active: "true" }, {}, target);
+ * // input is { page: 2, active: true }.
+ */
 export function decodeInferredInput(value, route, target) {
     if (!isRecord(route) || route.request !== undefined)
         return value;
@@ -9,6 +20,10 @@ export function decodeInferredInput(value, route, target) {
     const schema = projectedSchema(target.input);
     return schema === undefined ? value : decodeValue(value, schema);
 }
+/** Cache a schema's JSON Schema projection by schema identity.
+ * @param schema - Schema used to validate or infer the value.
+ * @returns The supported projection, or undefined when projection is unavailable.
+ */
 function projectedSchema(schema) {
     const cached = schemaCache.get(schema);
     if (cached !== undefined)
@@ -18,6 +33,11 @@ function projectedSchema(schema) {
     schemaCache.set(schema, projected);
     return projected ?? undefined;
 }
+/** Recursively decode strict number and boolean strings for a JSON Schema.
+ * @param value - Value to validate or project.
+ * @param schema - Schema used to validate or infer the value.
+ * @returns The decoded value, retaining strings not accepted by the target type.
+ */
 function decodeValue(value, schema) {
     if (!isRecord(schema))
         return value;
@@ -55,6 +75,11 @@ function decodeValue(value, schema) {
         return value === "true";
     return value;
 }
+/** Check whether a value already satisfies a JSON Schema primitive type.
+ * @param value - Value to validate or project.
+ * @param schema - Schema used to validate or infer the value.
+ * @returns Whether the value needs no coercion for this variant.
+ */
 function acceptsType(value, schema) {
     if (!isRecord(schema))
         return false;
@@ -68,12 +93,20 @@ function acceptsType(value, schema) {
         return isRecord(value);
     return typeof schema.type === "string" && typeof value === schema.type;
 }
+/** Recognize a Standard Schema v1 descriptor at the RPC boundary.
+ * @param value - Value to validate or project.
+ * @returns Whether the value exposes the supported Standard Schema marker.
+ */
 function isSchema(value) {
     return (isRecord(value) &&
         isRecord(value["~standard"]) &&
         value["~standard"].version === 1 &&
         typeof value["~standard"].validate === "function");
 }
+/** Check whether a value is a non-null object suitable for field inspection.
+ * @param value - Value to validate or project.
+ * @returns Whether object fields can be inspected.
+ */
 function isRecord(value) {
     return value !== null && typeof value === "object" && !Array.isArray(value);
 }

package/dist/request-inference.js.map

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

package/dist/request-mapping-body.d.ts

@@ -1,27 +1,14 @@
+import type { BodyState, BodyValue, FormDataLike } from "./request-mapping-body.types.js";
+export type { BodyIssue, BodyIssueCode, BodyState, BodyValue, FormDataLike, Missing, } from "./request-mapping-body.types.js";
 export declare const MISSING: unique symbol;
-export type Missing = typeof MISSING;
-export type BodyIssueCode = "content-type" | "body-too-large" | "malformed-json" | "malformed-multipart";
-export interface BodyIssue {
-    readonly code: BodyIssueCode;
-    readonly message: string;
-}
-export interface FormDataLike {
-    readonly getAll: (name: string) => readonly unknown[];
-}
-export interface BodyValue<T> {
-    readonly value: T | Missing;
-    readonly issue?: BodyIssue;
-}
-export interface BodyState {
-    readonly request: Request;
-    readonly maxBodyBytes: number;
-    body?: Promise<{
-        readonly bytes?: Uint8Array;
-        readonly issue?: BodyIssue;
-    }>;
-    json?: Promise<BodyValue<unknown>>;
-    form?: Promise<BodyValue<FormDataLike>>;
-}
+/** Shares the request body's first JSON parse among all mapping fields.
+ * @param state - State owned by the current request or operation.
+ * @returns The memoized JSON value, or MISSING with any body or parsing issue.
+ */
 export declare function parseJson(state: BodyState): Promise<BodyValue<unknown>>;
+/** Shares the request body's first multipart parse among all mapping fields.
+ * @param state - State owned by the current request or operation.
+ * @returns The memoized form data, or MISSING with any body or parsing issue.
+ */
 export declare function parseForm(state: BodyState): Promise<BodyValue<FormDataLike>>;
 //# sourceMappingURL=request-mapping-body.d.ts.map

package/dist/request-mapping-body.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-mapping-body.d.ts","sourceRoot":"","sources":["../src/request-mapping-body.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,eAAmC,CAAC;AACxD,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC;AACrC,MAAM,MAAM,aAAa,GACvB,cAAc,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,qBAAqB,CAAC;AAC/E,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AACD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,OAAO,EAAE,CAAC;CACvD;AACD,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;CAC5B;AACD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IAC5E,IAAI,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC;CACzC;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAG7E;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAGlF"}
+{"version":3,"file":"request-mapping-body.d.ts","sourceRoot":"","sources":["../src/request-mapping-body.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,SAAS,EACT,SAAS,EACT,YAAY,EACb,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,SAAS,EACT,aAAa,EACb,SAAS,EACT,SAAS,EACT,YAAY,EACZ,OAAO,GACR,MAAM,iCAAiC,CAAC;AAEzC,eAAO,MAAM,OAAO,eAAmC,CAAC;AAExD;;;GAGG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAG7E;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAGlF"}