@relkit/runtime-hono 0.5.3 → 0.5.5

package/dist/request-mapping-body.js

@@ -1,14 +1,29 @@
+import { Effect } from "effect";
+import { runHttp } from "./http-effect.js";
+import { RequestBodyReader, RequestBodyReaderLive } from "./request-body-service.js";
 export const MISSING = Symbol("relkit.mapping.missing");
+/** 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 async function parseJson(state) {
     if (state.json === undefined)
         state.json = parseJsonBody(state);
     return state.json;
 }
+/** 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 async function parseForm(state) {
     if (state.form === undefined)
         state.form = parseFormBody(state);
     return state.form;
 }
+/** Decodes bounded JSON bytes and reports malformed or incompatible input as mapping issues.
+ * @param state - State owned by the current request or operation.
+ * @returns The parsed JSON value, or MISSING with a bounded content-type or decoding issue.
+ */
 async function parseJsonBody(state) {
     const body = await readBody(state);
     if (body.issue !== undefined || body.bytes === undefined)
@@ -31,6 +46,10 @@ async function parseJsonBody(state) {
         };
     }
 }
+/** Decodes bounded multipart bytes while retaining uploaded field values.
+ * @param state - State owned by the current request or operation.
+ * @returns Parsed multipart fields, or MISSING with a bounded content-type or decoding issue.
+ */
 async function parseFormBody(state) {
     const body = await readBody(state);
     if (body.issue !== undefined || body.bytes === undefined)
@@ -57,44 +76,31 @@ async function parseFormBody(state) {
         };
     }
 }
+/** Shares one bounded body read across JSON and multipart mapping branches.
+ * @param state - State owned by the current request or operation.
+ * @returns The shared byte buffer or the body-reading issue.
+ */
 async function readBody(state) {
     if (state.body !== undefined)
         return state.body;
     state.body = readBodyBytes(state.request, state.maxBodyBytes);
     return state.body;
 }
+/** Reads native request bytes through the scoped body-reader service.
+ * @param request - Native request whose headers, body and cancellation signal define this operation.
+ * @param maxBytes - Positive maximum number of body bytes permitted for materialization.
+ * @returns The bounded bytes or reading issue produced by RequestBodyReader.
+ */
 async function readBodyBytes(request, maxBytes) {
-    if (!Number.isSafeInteger(maxBytes) || maxBytes < 1)
-        throw new RangeError("maxBodyBytes must be a positive integer");
-    const length = Number(request.headers.get("content-length"));
-    if (Number.isSafeInteger(length) && length > maxBytes)
-        return { issue: { code: "body-too-large", message: `Request body exceeds ${maxBytes} bytes` } };
-    if (request.body === null)
-        return { bytes: new Uint8Array() };
-    const reader = request.body.getReader();
-    const chunks = [];
-    let total = 0;
-    while (true) {
-        const part = await reader.read();
-        if (part.done)
-            break;
-        total += part.value.byteLength;
-        if (total > maxBytes) {
-            await reader.cancel();
-            return {
-                issue: { code: "body-too-large", message: `Request body exceeds ${maxBytes} bytes` },
-            };
-        }
-        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 };
+    return runHttp(Effect.gen(function* () {
+        const body = yield* RequestBodyReader;
+        return yield* body.read(request, maxBytes);
+    }).pipe(Effect.provide(RequestBodyReaderLive)), request.signal);
 }
+/** Normalizes the media type without parameters for body decoder selection.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns The lowercase media type without parameters, or an empty string when absent.
+ */
 function mediaType(value) {
     return value?.split(";", 1)[0]?.trim().toLowerCase() ?? "";
 }

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

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

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

@@ -0,0 +1,9 @@
+import { Schema } from "effect";
+/** Stable public body-decoding issue categories. */
+export declare const BodyIssueCode: Schema.Literals<readonly ["content-type", "body-too-large", "malformed-json", "malformed-multipart"]>;
+/** Public validation issue returned instead of throwing for malformed request bodies. */
+export declare const BodyIssue: Schema.Struct<{
+    readonly code: Schema.Literals<readonly ["content-type", "body-too-large", "malformed-json", "malformed-multipart"]>;
+    readonly message: Schema.String;
+}>;
+//# sourceMappingURL=request-mapping-body.schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"request-mapping-body.schemas.d.ts","sourceRoot":"","sources":["../src/request-mapping-body.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,oDAAoD;AACpD,eAAO,MAAM,aAAa,uGAKxB,CAAC;AAEH,yFAAyF;AACzF,eAAO,MAAM,SAAS;;;EAAiE,CAAC"}

package/dist/request-mapping-body.schemas.js

@@ -0,0 +1,11 @@
+import { Schema } from "effect";
+/** Stable public body-decoding issue categories. */
+export const BodyIssueCode = Schema.Literals([
+    "content-type",
+    "body-too-large",
+    "malformed-json",
+    "malformed-multipart",
+]);
+/** Public validation issue returned instead of throwing for malformed request bodies. */
+export const BodyIssue = Schema.Struct({ code: BodyIssueCode, message: Schema.String });
+//# sourceMappingURL=request-mapping-body.schemas.js.map

package/dist/request-mapping-body.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-mapping-body.schemas.js","sourceRoot":"","sources":["../src/request-mapping-body.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,oDAAoD;AACpD,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC3C,cAAc;IACd,gBAAgB;IAChB,gBAAgB;IAChB,qBAAqB;CACtB,CAAC,CAAC;AAEH,yFAAyF;AACzF,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC"}

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

@@ -0,0 +1,31 @@
+import type { MISSING } from "./request-mapping-body.js";
+import type * as Schemas from "./request-mapping-body.schemas.js";
+/** Contract for missing used by request mapping body. */
+export type Missing = typeof MISSING;
+/** Contract for body issue code used by request mapping body. */
+export type BodyIssueCode = typeof Schemas.BodyIssueCode.Type;
+/** Contract for body issue used by request mapping body. */
+export type BodyIssue = typeof Schemas.BodyIssue.Type;
+/** Contract for form data like used by request mapping body. */
+export interface FormDataLike {
+    readonly getAll: (name: string) => readonly unknown[];
+}
+/** Contract for body value used by request mapping body.
+ * @typeParam T - Value type retained by this operation.
+ */
+export interface BodyValue<T> {
+    readonly value: T | Missing;
+    readonly issue?: BodyIssue;
+}
+/** State owned by request mapping body. */
+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>>;
+}
+//# sourceMappingURL=request-mapping-body.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"request-mapping-body.types.d.ts","sourceRoot":"","sources":["../src/request-mapping-body.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,KAAK,KAAK,OAAO,MAAM,mCAAmC,CAAC;AAElE,yDAAyD;AACzD,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC;AAErC,iEAAiE;AACjE,MAAM,MAAM,aAAa,GAAG,OAAO,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC;AAE9D,4DAA4D;AAC5D,MAAM,MAAM,SAAS,GAAG,OAAO,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC;AAEtD,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,OAAO,EAAE,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;CAC5B;AAED,2CAA2C;AAC3C,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"}

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

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

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

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

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

@@ -1,8 +1,25 @@
 import { type Missing } from "./request-mapping-body.js";
 import type { MappingState } from "./request-mapping-object.js";
 import type { RequestIssueCode, RequestMappingFailure } from "./request-mapping.js";
+/** Read one JSON field, preferring middleware-validated input.
+ * @param name - Field, job or stream name.
+ * @param state - Shared body parsing, validation and issue state.
+ * @param path - Request path or issue location.
+ * @returns The own field value or the missing-value sentinel.
+ */
 export declare function bodyField(name: string, state: MappingState, path: readonly (string | number)[]): Promise<unknown | Missing>;
+/** Read validated JSON or parse the request body once and record errors.
+ * @param state - Shared body parsing, validation and issue state.
+ * @param path - Request path or issue location.
+ * @returns The parsed value or the missing-value sentinel.
+ */
 export declare function jsonValue(state: MappingState, path: readonly (string | number)[]): Promise<unknown | Missing>;
+/** Look up an own field in a middleware-validated request source.
+ * @param state - Shared body parsing, validation and issue state.
+ * @param target - Target descriptor or validated request source.
+ * @param name - Field, job or stream name.
+ * @returns A found flag and the validated value when present.
+ */
 export declare function validatedSource(state: MappingState, target: string, name: string): {
     found: boolean;
     value: unknown;
@@ -10,7 +27,25 @@ export declare function validatedSource(state: MappingState, target: string, nam
     found: boolean;
     value?: never;
 };
+/** Read validated or parsed multipart values and report duplicate scalars.
+ * @param name - Multipart field name to read.
+ * @param state - Shared body parsing, validation and issue state.
+ * @param path - Request path or issue location.
+ * @param all - Whether repeated multipart values are accepted.
+ * @returns One field, all field values, or the missing-value sentinel.
+ */
 export declare function formField(name: string, state: MappingState, path: readonly (string | number)[], all: boolean): Promise<unknown | Missing>;
+/** Freeze accumulated request mapping issues for the public failure result.
+ * @param state - Shared body parsing, validation and issue state.
+ * @returns An immutable failed mapping result.
+ */
 export declare function mappingFailure(state: MappingState): RequestMappingFailure;
+/** Record one mapping issue, deduplicating by code, path and message.
+ * @param state - Shared body parsing, validation and issue state.
+ * @param code - Stable public error or mapping issue code.
+ * @param message - Public diagnostic message or browser message.
+ * @param path - Request path or issue location.
+ * @returns Nothing; appends a frozen issue only once.
+ */
 export declare function addMappingIssue(state: MappingState, code: RequestIssueCode, message: string, path: readonly (string | number)[]): void;
 //# sourceMappingURL=request-mapping-fields.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"request-mapping-fields.d.ts","sourceRoot":"","sources":["../src/request-mapping-fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAEpF,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GACjC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,CAK5B;AAED,wBAAsB,SAAS,CAC7B,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GACjC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,CAO5B;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;;;;;;EAKhF;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAClC,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,CAgB5B;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,qBAAqB,CAEzE;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GACjC,IAAI,CAKN"}
+{"version":3,"file":"request-mapping-fields.d.ts","sourceRoot":"","sources":["../src/request-mapping-fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAEpF;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GACjC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,CAK5B;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GACjC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,CAO5B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;;;;;;EAKhF;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAClC,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,CAgB5B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,qBAAqB,CAEzE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GACjC,IAAI,CAKN"}

package/dist/request-mapping-fields.js

@@ -1,4 +1,10 @@
 import { MISSING, parseForm, parseJson } from "./request-mapping-body.js";
+/** Read one JSON field, preferring middleware-validated input.
+ * @param name - Field, job or stream name.
+ * @param state - Shared body parsing, validation and issue state.
+ * @param path - Request path or issue location.
+ * @returns The own field value or the missing-value sentinel.
+ */
 export async function bodyField(name, state, path) {
     const validated = validatedTarget(state, "json");
     if (isRecord(validated) && Object.hasOwn(validated, name))
@@ -6,6 +12,11 @@ export async function bodyField(name, state, path) {
     const value = await jsonValue(state, path);
     return value !== MISSING && isRecord(value) && Object.hasOwn(value, name) ? value[name] : MISSING;
 }
+/** Read validated JSON or parse the request body once and record errors.
+ * @param state - Shared body parsing, validation and issue state.
+ * @param path - Request path or issue location.
+ * @returns The parsed value or the missing-value sentinel.
+ */
 export async function jsonValue(state, path) {
     const validated = validatedTarget(state, "json");
     if (validated !== undefined)
@@ -15,12 +26,25 @@ export async function jsonValue(state, path) {
         addMappingIssue(state, result.issue.code, result.issue.message, path);
     return result.value;
 }
+/** Look up an own field in a middleware-validated request source.
+ * @param state - Shared body parsing, validation and issue state.
+ * @param target - Target descriptor or validated request source.
+ * @param name - Field, job or stream name.
+ * @returns A found flag and the validated value when present.
+ */
 export function validatedSource(state, target, name) {
     const validated = validatedTarget(state, target);
     return isRecord(validated) && Object.hasOwn(validated, name)
         ? { found: true, value: validated[name] }
         : { found: false };
 }
+/** Read validated or parsed multipart values and report duplicate scalars.
+ * @param name - Multipart field name to read.
+ * @param state - Shared body parsing, validation and issue state.
+ * @param path - Request path or issue location.
+ * @param all - Whether repeated multipart values are accepted.
+ * @returns One field, all field values, or the missing-value sentinel.
+ */
 export async function formField(name, state, path, all) {
     const validated = validatedTarget(state, "form");
     if (isRecord(validated) && Object.hasOwn(validated, name))
@@ -41,9 +65,20 @@ export async function formField(name, state, path, all) {
         addMappingIssue(state, "duplicate", `Duplicate multipart field "${name}"`, path);
     return values.length === 1 ? values[0] : MISSING;
 }
+/** Freeze accumulated request mapping issues for the public failure result.
+ * @param state - Shared body parsing, validation and issue state.
+ * @returns An immutable failed mapping result.
+ */
 export function mappingFailure(state) {
     return { ok: false, issues: Object.freeze(state.issues.map((item) => Object.freeze(item))) };
 }
+/** Record one mapping issue, deduplicating by code, path and message.
+ * @param state - Shared body parsing, validation and issue state.
+ * @param code - Stable public error or mapping issue code.
+ * @param message - Public diagnostic message or browser message.
+ * @param path - Request path or issue location.
+ * @returns Nothing; appends a frozen issue only once.
+ */
 export function addMappingIssue(state, code, message, path) {
     const key = `${code}:${path.join(".")}:${message}`;
     if (state.reported.has(key))
@@ -51,12 +86,25 @@ export function addMappingIssue(state, code, message, path) {
     state.reported.add(key);
     state.issues.push(Object.freeze({ code, message, path: Object.freeze([...path]) }));
 }
+/** Retrieve the middleware-validated value for a request source.
+ * @param state - Shared body parsing, validation and issue state.
+ * @param target - Target descriptor or validated request source.
+ * @returns The source value, or undefined if no validation result exists.
+ */
 function validatedTarget(state, target) {
     return state.request.validated?.[target];
 }
+/** 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);
 }
+/** Recognize a validated form source supporting getAll.
+ * @param value - Value to validate or project.
+ * @returns Whether all values for a field can be read.
+ */
 function isFormDataLike(value) {
     return isRecord(value) && typeof value.getAll === "function";
 }

package/dist/request-mapping-fields.js.map

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

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

@@ -1,14 +1,24 @@
-import { type BodyState, type Missing } from "./request-mapping-body.js";
-import type { MappingRequest, RequestIssueCode, RequestMappingIssue, RequestMappingOptions } from "./request-mapping.js";
-export interface MappingState {
-    readonly request: MappingRequest;
-    readonly body: BodyState;
-    readonly options: RequestMappingOptions;
-    readonly issues: RequestMappingIssue[];
-    readonly reported: Set<string>;
-}
-type Path = readonly (string | number)[];
-type Visit = (node: unknown, state: MappingState, path: Path) => Promise<unknown | Missing>;
+import { Effect } from "effect";
+import { MISSING } from "./request-mapping-body.js";
+import type { EffectVisit, MappingState, Path, Visit } from "./request-mapping-object.types.js";
+import type { RequestIssueCode } from "./request-mapping.js";
+export type { MappingState } from "./request-mapping-object.types.js";
+/** Maps object fields sequentially and preserves accumulated validation issues.
+ * @param fields - Serialized object-mapping fields evaluated in declaration order.
+ * @param state - State owned by the current request or operation.
+ * @param path - Ordered validation path or confined resource path.
+ * @param visit - Recursive visitor used to evaluate each mapping node.
+ * @param report - Issue callback retaining validation paths and public messages.
+ * @returns An Effect yielding mapped fields, or MISSING when the field declaration is invalid.
+ */
+export declare const mapObjectEffect: (fields: unknown, state: MappingState, path: Path, visit: EffectVisit, report: (code: RequestIssueCode, message: string, path: Path) => void) => Effect.Effect<Record<string, unknown> | typeof MISSING, import("./http-effect.js").HttpBoundaryError, never>;
+/** Promise compatibility edge for custom mapping visitors.
+ * @param fields - Serialized object-mapping fields evaluated in declaration order.
+ * @param state - State owned by the current request or operation.
+ * @param path - Ordered validation path or confined resource path.
+ * @param visit - Recursive visitor used to evaluate each mapping node.
+ * @param report - Issue callback retaining validation paths and public messages.
+ * @returns The mapped object or MISSING, with validation issues retained in the supplied state.
+ */
 export declare function mapObject(fields: unknown, state: MappingState, path: Path, visit: Visit, report: (code: RequestIssueCode, message: string, path: Path) => void): Promise<unknown>;
-export {};
 //# sourceMappingURL=request-mapping-object.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"request-mapping-object.d.ts","sourceRoot":"","sources":["../src/request-mapping-object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,SAAS,EAAE,KAAK,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAChC;AACD,KAAK,IAAI,GAAG,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;AACzC,KAAK,KAAK,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,CAAC;AAE5F,wBAAsB,SAAS,CAC7B,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,GACpE,OAAO,CAAC,OAAO,CAAC,CAelB"}
+{"version":3,"file":"request-mapping-object.d.ts","sourceRoot":"","sources":["../src/request-mapping-object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAChG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,YAAY,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEtE;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,wFAKX,gBAAgB,WAAW,MAAM,QAAQ,IAAI,KAAK,IAAI,iHAqBrE,CAAC;AAEH;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,GACpE,OAAO,CAAC,OAAO,CAAC,CAUlB"}

package/dist/request-mapping-object.js

@@ -1,25 +1,55 @@
+import { Effect } from "effect";
+import { httpBoundary, runHttp } from "./http-effect.js";
 import { MISSING } from "./request-mapping-body.js";
-export async function mapObject(fields, state, path, visit, report) {
+/** Maps object fields sequentially and preserves accumulated validation issues.
+ * @param fields - Serialized object-mapping fields evaluated in declaration order.
+ * @param state - State owned by the current request or operation.
+ * @param path - Ordered validation path or confined resource path.
+ * @param visit - Recursive visitor used to evaluate each mapping node.
+ * @param report - Issue callback retaining validation paths and public messages.
+ * @returns An Effect yielding mapped fields, or MISSING when the field declaration is invalid.
+ */
+export const mapObjectEffect = Effect.fn("RequestMapping.object")(function* (fields, state, path, visit, report) {
     if (!isRecord(fields)) {
         report("mapping", "Mapping fields must be an object", path);
         return MISSING;
     }
     const result = {};
-    for (const [name, node] of Object.entries(fields)) {
+    yield* Effect.forEach(Object.entries(fields), ([name, node]) => Effect.gen(function* () {
         const valuePath = [...path, name];
-        const value = await visit(node, state, valuePath);
+        const value = yield* visit(node, state, valuePath);
         if (value === MISSING) {
             if (!state.issues.some((issue) => samePath(issue.path, valuePath)))
                 report("missing", `Missing request value "${name}"`, valuePath);
         }
         else
             result[name] = value;
-    }
+    }), { discard: true });
     return result;
+});
+/** Promise compatibility edge for custom mapping visitors.
+ * @param fields - Serialized object-mapping fields evaluated in declaration order.
+ * @param state - State owned by the current request or operation.
+ * @param path - Ordered validation path or confined resource path.
+ * @param visit - Recursive visitor used to evaluate each mapping node.
+ * @param report - Issue callback retaining validation paths and public messages.
+ * @returns The mapped object or MISSING, with validation issues retained in the supplied state.
+ */
+export function mapObject(fields, state, path, visit, report) {
+    return runHttp(mapObjectEffect(fields, state, path, (...args) => httpBoundary("request.mapping.visit", () => visit(...args)), report));
 }
+/** Compares validation issue paths by their ordered segments.
+ * @param left - First value or path participating in the comparison.
+ * @param right - Second value or path participating in the comparison.
+ * @returns Whether the value satisfies the required public contract.
+ */
 function samePath(left, right) {
     return left.length === right.length && left.every((value, index) => value === right[index]);
 }
+/** Recognizes a non-null object before reading its named properties.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns Whether the inspected value satisfies the declared type guard.
+ */
 function isRecord(value) {
     return value !== null && typeof value === "object" && !Array.isArray(value);
 }

package/dist/request-mapping-object.js.map

@@ -1 +1 @@
-{"version":3,"file":"request-mapping-object.js","sourceRoot":"","sources":["../src/request-mapping-object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAgC,MAAM,2BAA2B,CAAC;AAkBlF,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAe,EACf,KAAmB,EACnB,IAAU,EACV,KAAY,EACZ,MAAqE;IAErE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,MAAM,CAAC,SAAS,EAAE,kCAAkC,EAAE,IAAI,CAAC,CAAC;QAC5D,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QAClD,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YACtB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBAChE,MAAM,CAAC,SAAS,EAAE,0BAA0B,IAAI,GAAG,EAAE,SAAS,CAAC,CAAC;QACpE,CAAC;;YAAM,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IAC9B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,QAAQ,CAAC,IAAU,EAAE,KAAW;IACvC,OAAO,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9F,CAAC;AACD,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}
+{"version":3,"file":"request-mapping-object.js","sourceRoot":"","sources":["../src/request-mapping-object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAKpD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,EAAE,CAAC,uBAAuB,CAAC,CAAC,QAAQ,CAAC,EACzE,MAAe,EACf,KAAmB,EACnB,IAAU,EACV,KAAkB,EAClB,MAAqE;IAErE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,MAAM,CAAC,SAAS,EAAE,kCAAkC,EAAE,IAAI,CAAC,CAAC;QAC5D,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CACnB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EACtB,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CACf,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QACnD,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YACtB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBAChE,MAAM,CAAC,SAAS,EAAE,0BAA0B,IAAI,GAAG,EAAE,SAAS,CAAC,CAAC;QACpE,CAAC;;YAAM,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IAC9B,CAAC,CAAC,EACJ,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CACvB,MAAe,EACf,KAAmB,EACnB,IAAU,EACV,KAAY,EACZ,MAAqE;IAErE,OAAO,OAAO,CACZ,eAAe,CACb,MAAM,EACN,KAAK,EACL,IAAI,EACJ,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,uBAAuB,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,EACxE,MAAM,CACP,CACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,QAAQ,CAAC,IAAU,EAAE,KAAW;IACvC,OAAO,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9F,CAAC;AACD;;;GAGG;AACH,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/request-mapping-object.types.d.ts

@@ -0,0 +1,19 @@
+import type { BodyState, Missing } from "./request-mapping-body.js";
+import type { MappingRequest, RequestMappingIssue, RequestMappingOptions } from "./request-mapping.js";
+import type { Effect } from "effect";
+import type { HttpBoundaryError } from "./http-effect.js";
+/** State owned by request mapping object. */
+export interface MappingState {
+    readonly request: MappingRequest;
+    readonly body: BodyState;
+    readonly options: RequestMappingOptions;
+    readonly issues: RequestMappingIssue[];
+    readonly reported: Set<string>;
+}
+/** Contract for path used by request mapping object. */
+export type Path = readonly (string | number)[];
+/** Contract for visit used by request mapping object. */
+export type Visit = (node: unknown, state: MappingState, path: Path) => Promise<unknown | Missing>;
+/** Lazy recursive mapping visitor; fields are evaluated sequentially against shared issues. */
+export type EffectVisit = (node: unknown, state: MappingState, path: Path) => Effect.Effect<unknown | Missing, HttpBoundaryError>;
+//# sourceMappingURL=request-mapping-object.types.d.ts.map

package/dist/request-mapping-object.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-mapping-object.types.d.ts","sourceRoot":"","sources":["../src/request-mapping-object.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAChC;AAED,wDAAwD;AACxD,MAAM,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;AAEhD,yDAAyD;AACzD,MAAM,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,CAAC;AAEnG,+FAA+F;AAC/F,MAAM,MAAM,WAAW,GAAG,CACxB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,IAAI,KACP,MAAM,CAAC,MAAM,CAAC,OAAO,GAAG,OAAO,EAAE,iBAAiB,CAAC,CAAC"}

package/dist/request-mapping-object.types.js

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

package/dist/request-mapping-object.types.js.map

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

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

@@ -1,7 +1,34 @@
-import type { MappingValue, RequestIssueCode } from "./request-mapping.js";
 import { type Missing } from "./request-mapping-body.js";
+import type { MappingValue, RequestIssueCode } from "./request-mapping.js";
+/** Read a request header using case-insensitive field names.
+ * @param headers - Response or request header values.
+ * @param name - Field, job or stream name.
+ * @returns The first matching header value, or undefined.
+ */
 export declare function readHeader(headers: Readonly<Record<string, MappingValue>>, name: string): MappingValue | undefined;
+/** Read a single request value and reject repeated values.
+ * @param value - Value to validate or project.
+ * @param source - Fixed data or a callback producing the data.
+ * @param path - Request path or issue location.
+ * @param report - Callback recording a request mapping issue.
+ * @returns The scalar value or the missing-value sentinel.
+ */
 export declare function readScalar(value: MappingValue | undefined, source: string, path: readonly (string | number)[], report: (code: RequestIssueCode, message: string, path: readonly (string | number)[]) => void): unknown | Missing;
+/** Decode the route's named catch-all path segments.
+ * @param url - Absolute request URL.
+ * @param pattern - Declared route path pattern.
+ * @param name - Field, job or stream name.
+ * @param path - Request path or issue location.
+ * @param report - Callback recording a request mapping issue.
+ * @returns Frozen decoded segments, or the missing-value sentinel on absence/error.
+ */
 export declare function readPathSegments(url: string, pattern: string | undefined, name: string, path: readonly (string | number)[], report: (code: RequestIssueCode, message: string, path: readonly (string | number)[]) => void): readonly string[] | Missing;
+/** Read one URI-decoded cookie and report duplicates or invalid escapes.
+ * @param name - Field, job or stream name.
+ * @param headers - Response or request header values.
+ * @param path - Request path or issue location.
+ * @param report - Callback recording a request mapping issue.
+ * @returns The cookie value or the missing-value sentinel.
+ */
 export declare function readCookie(name: string, headers: Readonly<Record<string, MappingValue>>, path: readonly (string | number)[], report: (code: RequestIssueCode, message: string, path: readonly (string | number)[]) => void): unknown | Missing;
 //# sourceMappingURL=request-mapping-sources.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"request-mapping-sources.d.ts","sourceRoot":"","sources":["../src/request-mapping-sources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAW,KAAK,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAElE,wBAAgB,UAAU,CACxB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,EAC/C,IAAI,EAAE,MAAM,GACX,YAAY,GAAG,SAAS,CAK1B;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,YAAY,GAAG,SAAS,EAC/B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAClC,MAAM,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,IAAI,GAC5F,OAAO,GAAG,OAAO,CAOnB;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAClC,MAAM,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,IAAI,GAC5F,SAAS,MAAM,EAAE,GAAG,OAAO,CAgB7B;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,EAC/C,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAClC,MAAM,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,IAAI,GAC5F,OAAO,GAAG,OAAO,CAuBnB"}
+{"version":3,"file":"request-mapping-sources.d.ts","sourceRoot":"","sources":["../src/request-mapping-sources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE3E;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,EAC/C,IAAI,EAAE,MAAM,GACX,YAAY,GAAG,SAAS,CAK1B;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,YAAY,GAAG,SAAS,EAC/B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAClC,MAAM,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,IAAI,GAC5F,OAAO,GAAG,OAAO,CAOnB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAClC,MAAM,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,IAAI,GAC5F,SAAS,MAAM,EAAE,GAAG,OAAO,CAgB7B;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,EAC/C,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAClC,MAAM,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,IAAI,GAC5F,OAAO,GAAG,OAAO,CAuBnB"}

package/dist/request-mapping-sources.js

@@ -1,8 +1,20 @@
 import { MISSING } from "./request-mapping-body.js";
+/** Read a request header using case-insensitive field names.
+ * @param headers - Response or request header values.
+ * @param name - Field, job or stream name.
+ * @returns The first matching header value, or undefined.
+ */
 export function readHeader(headers, name) {
     const key = Object.keys(headers).find((candidate) => candidate.toLowerCase() === name.toLowerCase());
     return key === undefined ? undefined : headers[key];
 }
+/** Read a single request value and reject repeated values.
+ * @param value - Value to validate or project.
+ * @param source - Fixed data or a callback producing the data.
+ * @param path - Request path or issue location.
+ * @param report - Callback recording a request mapping issue.
+ * @returns The scalar value or the missing-value sentinel.
+ */
 export function readScalar(value, source, path, report) {
     if (value === undefined)
         return MISSING;
@@ -13,6 +25,14 @@ export function readScalar(value, source, path, report) {
     }
     return value;
 }
+/** Decode the route's named catch-all path segments.
+ * @param url - Absolute request URL.
+ * @param pattern - Declared route path pattern.
+ * @param name - Field, job or stream name.
+ * @param path - Request path or issue location.
+ * @param report - Callback recording a request mapping issue.
+ * @returns Frozen decoded segments, or the missing-value sentinel on absence/error.
+ */
 export function readPathSegments(url, pattern, name, path, report) {
     const token = pattern?.split("/").findIndex((segment) => {
         return segment === `*${name}` || segment === `*${name}?`;
@@ -32,6 +52,13 @@ export function readPathSegments(url, pattern, name, path, report) {
         return MISSING;
     }
 }
+/** Read one URI-decoded cookie and report duplicates or invalid escapes.
+ * @param name - Field, job or stream name.
+ * @param headers - Response or request header values.
+ * @param path - Request path or issue location.
+ * @param report - Callback recording a request mapping issue.
+ * @returns The cookie value or the missing-value sentinel.
+ */
 export function readCookie(name, headers, path, report) {
     const raw = readHeader(headers, "cookie");
     if (raw === undefined)