@relkit/runtime-hono 0.5.4 → 0.5.5

package/dist/response-mapping-provider.js

@@ -0,0 +1,15 @@
+import { toFailureTelemetry } from "@relkit/runtime-effect";
+/** Exposes a sanitized provider message only in development mode.
+ * @param failure - Normalized invocation failure whose private cause may contain provider diagnostics.
+ * @param mode - Configured runtime exposure or response-validation mode.
+ * @returns The sanitized provider cause message in development, otherwise undefined.
+ */
+export function developmentProviderMessage(failure, mode) {
+    if (failure.kind !== "provider" || mode !== "development")
+        return undefined;
+    const cause = toFailureTelemetry(failure, { mode: "development" }).internal?.cause;
+    if (cause === null || typeof cause !== "object" || !("message" in cause))
+        return undefined;
+    return typeof cause.message === "string" ? cause.message : undefined;
+}
+//# sourceMappingURL=response-mapping-provider.js.map

package/dist/response-mapping-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-mapping-provider.js","sourceRoot":"","sources":["../src/response-mapping-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAA0B,MAAM,wBAAwB,CAAC;AAGpF;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAA0B,EAC1B,IAA8B;IAE9B,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,aAAa;QAAE,OAAO,SAAS,CAAC;IAC5E,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC;IACnF,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3F,OAAO,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC"}

package/dist/response-mapping-utils.d.ts

@@ -1,16 +1,60 @@
 import type { HttpTriggerRegistration } from "@relkit/graph";
 import type { StandardIssue, StandardSchemaV1 } from "@relkit/schema";
 import type { RequestMappingIssue } from "./request-mapping.js";
-export type ResponseSchemaEntries = Readonly<Record<string, unknown>> | ReadonlyMap<string, unknown>;
-export type ResponseDeclaration = Record<string, unknown>;
+import type { ResponseDeclaration, ResponseSchemaEntries } from "./response-mapping-utils.types.js";
+export type { ResponseDeclaration, ResponseSchemaEntries } from "./response-mapping-utils.types.js";
+/** Select an explicit response ID or the route's default success declaration.
+ * @param trigger - Compiled HTTP trigger registration.
+ * @param id - Optional event or declaration identifier.
+ * @returns The matching success/response declaration when available.
+ */
 export declare function findSuccess(trigger: HttpTriggerRegistration, id: string | undefined): ResponseDeclaration | undefined;
+/** Find a declared route error by its public error or response ID.
+ * @param trigger - Compiled HTTP trigger registration.
+ * @param id - Optional event or declaration identifier.
+ * @returns The matching error declaration, or undefined.
+ */
 export declare function findError(trigger: HttpTriggerRegistration, id: string): ResponseDeclaration | undefined;
+/** Find the route's validation-error response declaration.
+ * @param trigger - Compiled HTTP trigger registration.
+ * @returns The declaration, or undefined when the route uses the fallback.
+ */
 export declare function findValidation(trigger: HttpTriggerRegistration): ResponseDeclaration | undefined;
+/** Find the first response whose response or error ID is requested.
+ * @param trigger - Compiled HTTP trigger registration.
+ * @param ids - Candidate public response or error IDs.
+ * @returns The matching declaration, or undefined.
+ */
 export declare function findResponse(trigger: HttpTriggerRegistration, ids: readonly string[]): ResponseDeclaration | undefined;
+/** Resolve a declaration-local schema before scoped and unscoped manifest entries.
+ * @param trigger - Compiled HTTP trigger registration.
+ * @param declaration - Selected response declaration.
+ * @param entries - Manifest schema entries keyed by response identity.
+ * @returns The first supported Standard Schema descriptor.
+ */
 export declare function findSchema(trigger: HttpTriggerRegistration, declaration: ResponseDeclaration | undefined, entries: ResponseSchemaEntries | undefined): StandardSchemaV1 | undefined;
+/** Use a declaration status when it falls in the HTTP status range.
+ * @param declaration - Selected response declaration.
+ * @param fallback - Status used when no supported declaration status exists.
+ * @returns The declared status or the supplied fallback.
+ */
 export declare function responseStatus(declaration: ResponseDeclaration | undefined, fallback: number): number;
+/** Encode JSON output while omitting bodies for HTTP 204 and 304.
+ * @param value - Value to validate or project.
+ * @param status - HTTP response status.
+ * @returns A JSON response, or a bodyless response when required by the status.
+ */
 export declare function jsonResponse(value: unknown, status: number): Response;
+/** Encode a stable error ID as a JSON HTTP response.
+ * @param error - Native failure or public error identifier.
+ * @param status - HTTP response status.
+ * @returns A response containing the error field and requested status.
+ */
 export declare function genericResponse(error: string, status: number): Response;
+/** Bound issue messages and normalize field paths for public validation errors.
+ * @param issue - Validation or mapping issue to sanitize.
+ * @returns A safe code, message and frozen string/number path.
+ */
 export declare function safeIssue(issue: StandardIssue | RequestMappingIssue): {
     readonly code: string;
     readonly message: string;

package/dist/response-mapping-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response-mapping-utils.d.ts","sourceRoot":"","sources":["../src/response-mapping-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,MAAM,MAAM,qBAAqB,GAC/B,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACnE,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1D,wBAAgB,WAAW,CACzB,OAAO,EAAE,uBAAuB,EAChC,EAAE,EAAE,MAAM,GAAG,SAAS,GACrB,mBAAmB,GAAG,SAAS,CAMjC;AACD,wBAAgB,SAAS,CACvB,OAAO,EAAE,uBAAuB,EAChC,EAAE,EAAE,MAAM,GACT,mBAAmB,GAAG,SAAS,CAIjC;AACD,wBAAgB,cAAc,CAAC,OAAO,EAAE,uBAAuB,GAAG,mBAAmB,GAAG,SAAS,CAEhG;AACD,wBAAgB,YAAY,CAC1B,OAAO,EAAE,uBAAuB,EAChC,GAAG,EAAE,SAAS,MAAM,EAAE,GACrB,mBAAmB,GAAG,SAAS,CAMjC;AACD,wBAAgB,UAAU,CACxB,OAAO,EAAE,uBAAuB,EAChC,WAAW,EAAE,mBAAmB,GAAG,SAAS,EAC5C,OAAO,EAAE,qBAAqB,GAAG,SAAS,GACzC,gBAAgB,GAAG,SAAS,CAY9B;AACD,wBAAgB,cAAc,CAC5B,WAAW,EAAE,mBAAmB,GAAG,SAAS,EAC5C,QAAQ,EAAE,MAAM,GACf,MAAM,CAMR;AACD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAMrE;AACD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAEvE;AACD,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,mBAAmB,GAAG;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CAC7C,CAWA"}
+{"version":3,"file":"response-mapping-utils.d.ts","sourceRoot":"","sources":["../src/response-mapping-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AACpG,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAEpG;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,uBAAuB,EAChC,EAAE,EAAE,MAAM,GAAG,SAAS,GACrB,mBAAmB,GAAG,SAAS,CAMjC;AACD;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,uBAAuB,EAChC,EAAE,EAAE,MAAM,GACT,mBAAmB,GAAG,SAAS,CAIjC;AACD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,uBAAuB,GAAG,mBAAmB,GAAG,SAAS,CAEhG;AACD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,uBAAuB,EAChC,GAAG,EAAE,SAAS,MAAM,EAAE,GACrB,mBAAmB,GAAG,SAAS,CAMjC;AACD;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,uBAAuB,EAChC,WAAW,EAAE,mBAAmB,GAAG,SAAS,EAC5C,OAAO,EAAE,qBAAqB,GAAG,SAAS,GACzC,gBAAgB,GAAG,SAAS,CAY9B;AACD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,mBAAmB,GAAG,SAAS,EAC5C,QAAQ,EAAE,MAAM,GACf,MAAM,CAMR;AACD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAMrE;AACD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAEvE;AACD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,mBAAmB,GAAG;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CAC7C,CAWA"}

package/dist/response-mapping-utils.js

@@ -1,3 +1,8 @@
+/** Select an explicit response ID or the route's default success declaration.
+ * @param trigger - Compiled HTTP trigger registration.
+ * @param id - Optional event or declaration identifier.
+ * @returns The matching success/response declaration when available.
+ */
 export function findSuccess(trigger, id) {
     const values = responses(trigger);
     return id === undefined
@@ -5,16 +10,36 @@ export function findSuccess(trigger, id) {
             values.find((entry) => entry.kind === "response"))
         : findResponse(trigger, [id]);
 }
+/** Find a declared route error by its public error or response ID.
+ * @param trigger - Compiled HTTP trigger registration.
+ * @param id - Optional event or declaration identifier.
+ * @returns The matching error declaration, or undefined.
+ */
 export function findError(trigger, id) {
     return responses(trigger).find((entry) => entry.kind === "error" && (entry.errorId === id || entry.id === id));
 }
+/** Find the route's validation-error response declaration.
+ * @param trigger - Compiled HTTP trigger registration.
+ * @returns The declaration, or undefined when the route uses the fallback.
+ */
 export function findValidation(trigger) {
     return responses(trigger).find((entry) => entry.kind === "validation-error");
 }
+/** Find the first response whose response or error ID is requested.
+ * @param trigger - Compiled HTTP trigger registration.
+ * @param ids - Candidate public response or error IDs.
+ * @returns The matching declaration, or undefined.
+ */
 export function findResponse(trigger, ids) {
     return responses(trigger).find((entry) => (typeof entry.id === "string" && ids.includes(entry.id)) ||
         (typeof entry.errorId === "string" && ids.includes(entry.errorId)));
 }
+/** Resolve a declaration-local schema before scoped and unscoped manifest entries.
+ * @param trigger - Compiled HTTP trigger registration.
+ * @param declaration - Selected response declaration.
+ * @param entries - Manifest schema entries keyed by response identity.
+ * @returns The first supported Standard Schema descriptor.
+ */
 export function findSchema(trigger, declaration, entries) {
     const local = standardSchema(declaration?.schema);
     if (local !== undefined || entries === undefined || declaration === undefined)
@@ -28,6 +53,11 @@ export function findSchema(trigger, declaration, entries) {
     }
     return undefined;
 }
+/** Use a declaration status when it falls in the HTTP status range.
+ * @param declaration - Selected response declaration.
+ * @param fallback - Status used when no supported declaration status exists.
+ * @returns The declared status or the supplied fallback.
+ */
 export function responseStatus(declaration, fallback) {
     return typeof declaration?.status === "number" &&
         declaration.status >= 100 &&
@@ -35,6 +65,11 @@ export function responseStatus(declaration, fallback) {
         ? declaration.status
         : fallback;
 }
+/** Encode JSON output while omitting bodies for HTTP 204 and 304.
+ * @param value - Value to validate or project.
+ * @param status - HTTP response status.
+ * @returns A JSON response, or a bodyless response when required by the status.
+ */
 export function jsonResponse(value, status) {
     if (status === 204 || status === 304)
         return new Response(null, { status });
@@ -43,9 +78,18 @@ export function jsonResponse(value, status) {
         headers: { "content-type": "application/json" },
     });
 }
+/** Encode a stable error ID as a JSON HTTP response.
+ * @param error - Native failure or public error identifier.
+ * @param status - HTTP response status.
+ * @returns A response containing the error field and requested status.
+ */
 export function genericResponse(error, status) {
     return jsonResponse({ error }, status);
 }
+/** Bound issue messages and normalize field paths for public validation errors.
+ * @param issue - Validation or mapping issue to sanitize.
+ * @returns A safe code, message and frozen string/number path.
+ */
 export function safeIssue(issue) {
     return {
         code: "code" in issue ? String(issue.code) : "validation",
@@ -56,9 +100,17 @@ export function safeIssue(issue) {
         })),
     };
 }
+/** Read object response declarations from route configuration.
+ * @param trigger - Compiled HTTP trigger registration.
+ * @returns Supported response records, or an empty array.
+ */
 function responses(trigger) {
     return Array.isArray(trigger.config.responses) ? trigger.config.responses.filter(isRecord) : [];
 }
+/** Recognize a Standard Schema v1 descriptor with a callable validator.
+ * @param value - Value to validate or project.
+ * @returns The descriptor when valid, otherwise undefined.
+ */
 function standardSchema(value) {
     if (!isRecord(value) || !isRecord(value["~standard"]))
         return undefined;
@@ -66,6 +118,10 @@ function standardSchema(value) {
         ? value
         : undefined;
 }
+/** 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/response-mapping-utils.js.map

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

package/dist/response-mapping-utils.types.d.ts

@@ -0,0 +1,5 @@
+/** Runtime schemas indexed by response ID or route-ID/response-ID pair. */
+export type ResponseSchemaEntries = Readonly<Record<string, unknown>> | ReadonlyMap<string, unknown>;
+/** Compiled response metadata inspected defensively at the transport boundary. */
+export type ResponseDeclaration = Record<string, unknown>;
+//# sourceMappingURL=response-mapping-utils.types.d.ts.map

package/dist/response-mapping-utils.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-mapping-utils.types.d.ts","sourceRoot":"","sources":["../src/response-mapping-utils.types.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,MAAM,qBAAqB,GAC/B,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnE,kFAAkF;AAClF,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/response-mapping-utils.types.js

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

package/dist/response-mapping-utils.types.js.map

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

package/dist/response-mapping-validation.d.ts

@@ -0,0 +1,13 @@
+import type { HttpTriggerRegistration } from "@relkit/graph";
+import { Effect } from "effect";
+import { type ResponseDeclaration } from "./response-mapping-utils.js";
+import type { ResponseMappingOptions } from "./response-mapping.types.js";
+/** Validates foreign Standard Schema implementations only outside production mode.
+ * @param trigger - Registered route declaration with its target and transport contract.
+ * @param declaration - Selected response declaration used to locate its output schema.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns An Effect yielding whether the schema accepts the value, or true when checking is disabled.
+ */
+export declare const responseIsValid: (trigger: HttpTriggerRegistration, declaration: ResponseDeclaration | undefined, value: unknown, options: ResponseMappingOptions) => Effect.Effect<boolean, never, never>;
+//# sourceMappingURL=response-mapping-validation.d.ts.map

package/dist/response-mapping-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-mapping-validation.d.ts","sourceRoot":"","sources":["../src/response-mapping-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAE7D,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAc,KAAK,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACnF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAE1E;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,2KAe1B,CAAC"}

package/dist/response-mapping-validation.js

@@ -0,0 +1,20 @@
+import { validate } from "@relkit/schema";
+import { Effect } from "effect";
+import { httpBoundary } from "./http-effect.js";
+import { findSchema } from "./response-mapping-utils.js";
+/** Validates foreign Standard Schema implementations only outside production mode.
+ * @param trigger - Registered route declaration with its target and transport contract.
+ * @param declaration - Selected response declaration used to locate its output schema.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns An Effect yielding whether the schema accepts the value, or true when checking is disabled.
+ */
+export const responseIsValid = Effect.fn("ResponseMapping.validate")(function* (trigger, declaration, value, options) {
+    if (options.mode === "production")
+        return true;
+    const schema = findSchema(trigger, declaration, options.responseSchemas);
+    if (schema === undefined)
+        return true;
+    return yield* httpBoundary("response.validate", () => Promise.resolve(validate(schema, value))).pipe(Effect.map((result) => "value" in result), Effect.catch(() => Effect.succeed(false)));
+});
+//# sourceMappingURL=response-mapping-validation.js.map

package/dist/response-mapping-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-mapping-validation.js","sourceRoot":"","sources":["../src/response-mapping-validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAA4B,MAAM,6BAA6B,CAAC;AAGnF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,EAAE,CAAC,0BAA0B,CAAC,CAAC,QAAQ,CAAC,EAC5E,OAAgC,EAChC,WAA4C,EAC5C,KAAc,EACd,OAA+B;IAE/B,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC;IAC/C,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACzE,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,KAAK,CAAC,CAAC,YAAY,CAAC,mBAAmB,EAAE,GAAG,EAAE,CACnD,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAc,CAAC,CAAC,CAClD,CAAC,IAAI,CACJ,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,IAAI,MAAM,CAAC,EACzC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAC1C,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/response-mapping.d.ts

@@ -1,18 +1,67 @@
 import type { HttpTriggerRegistration } from "@relkit/graph";
 import { type StandardIssue } from "@relkit/schema";
+import { Context, Effect, Layer } from "effect";
 import type { RequestMappingIssue } from "./request-mapping.js";
-export type ResponseMode = "development" | "test" | "production";
+import type { ResponseMappingOptions } from "./response-mapping.types.js";
 export type { ResponseSchemaEntries } from "./response-mapping-utils.js";
-import type { ResponseSchemaEntries } from "./response-mapping-utils.js";
-export interface ResponseMappingOptions {
-    readonly mode?: ResponseMode;
-    readonly responseSchemas?: ResponseSchemaEntries;
-    readonly signal?: AbortSignal;
-    readonly responseId?: string;
+export type { ResponseMappingOptions, ResponseMode } from "./response-mapping.types.js";
+/** Serializes the declared success response after optional output-schema validation.
+ * @param trigger - Registered route declaration with its target and transport contract.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns An effect yielding the declared success response or a safe output-validation failure.
+ */
+declare const success: (trigger: HttpTriggerRegistration, value: unknown, options?: ResponseMappingOptions | undefined) => Effect.Effect<Response, never, never>;
+/** Maps declared failures to their public envelope without exposing native causes.
+ * @param trigger - Registered route declaration with its target and transport contract.
+ * @param cause - Native failure projected without exposing private exception details.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns An effect yielding the declared public error response or a sanitized transport fallback.
+ */
+declare const failure: (trigger: HttpTriggerRegistration, cause: unknown, options?: ResponseMappingOptions | undefined) => Effect.Effect<Response, never, never>;
+/** Sanitizes validation issue paths before producing the declared validation response.
+ * @param trigger - Registered route declaration with its target and transport contract.
+ * @param issues - issues supplied by the caller.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns An effect yielding sanitized issues at the declared validation status, normally HTTP 422.
+ */
+declare const validation: (trigger: HttpTriggerRegistration, issues: readonly (RequestMappingIssue | StandardIssue)[], options?: ResponseMappingOptions | undefined) => Effect.Effect<Response, never, never>;
+declare const ResponseMapping_base: Context.ServiceClass<ResponseMapping, "@relkit/runtime-hono/ResponseMapping", {
+    readonly success: typeof success;
+    readonly failure: typeof failure;
+    readonly validation: typeof validation;
+}>;
+/** Response construction and validation share one replaceable domain contract. */
+export declare class ResponseMapping extends ResponseMapping_base {
 }
-/** Converts one successful engine result or normalized engine failure to HTTP. */
+/** Live response policy, including safe public failure projection and configured schemas. */
+export declare const ResponseMappingLive: Layer.Layer<ResponseMapping, never, never>;
+/** Converts one successful engine result or normalized engine failure to HTTP.
+ * @param trigger - Registered route declaration with its target and transport contract.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns A Promise for the mapped success or public failure HTTP response.
+ */
 export declare function mapResponse(trigger: HttpTriggerRegistration, value: unknown, options?: ResponseMappingOptions): Promise<Response>;
+/** Executes successful response mapping at the native framework edge.
+ * @param trigger - Registered route declaration with its target and transport contract.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns A Promise resolving the validated public HTTP response.
+ */
 export declare function mapSuccessResponse(trigger: HttpTriggerRegistration, value: unknown, options?: ResponseMappingOptions): Promise<Response>;
+/** Executes public failure mapping at the native framework edge.
+ * @param trigger - Registered route declaration with its target and transport contract.
+ * @param cause - Native failure projected without exposing private exception details.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns A Promise resolving a safe declared failure response.
+ */
 export declare function mapFailureResponse(trigger: HttpTriggerRegistration, cause: unknown, options?: ResponseMappingOptions): Promise<Response>;
+/** Executes request-validation mapping at the native framework edge.
+ * @param trigger - Registered route declaration with its target and transport contract.
+ * @param issues - issues supplied by the caller.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns A Promise resolving the sanitized validation response.
+ */
 export declare function mapInputValidationResponse(trigger: HttpTriggerRegistration, issues: readonly (StandardIssue | RequestMappingIssue)[], options?: ResponseMappingOptions): Promise<Response>;
 //# sourceMappingURL=response-mapping.d.ts.map

package/dist/response-mapping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response-mapping.d.ts","sourceRoot":"","sources":["../src/response-mapping.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAQ7D,OAAO,EAAY,KAAK,aAAa,EAAyB,MAAM,gBAAgB,CAAC;AACrF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAchE,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,MAAM,GAAG,YAAY,CAAC;AACjE,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEzE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,kFAAkF;AAClF,wBAAgB,WAAW,CACzB,OAAO,EAAE,uBAAuB,EAChC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,QAAQ,CAAC,CAInB;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,uBAAuB,EAChC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,QAAQ,CAAC,CAWnB;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,uBAAuB,EAChC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,QAAQ,CAAC,CAyBnB;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,uBAAuB,EAChC,MAAM,EAAE,SAAS,CAAC,aAAa,GAAG,mBAAmB,CAAC,EAAE,EACxD,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,QAAQ,CAAC,CAMnB"}
+{"version":3,"file":"response-mapping.d.ts","sourceRoot":"","sources":["../src/response-mapping.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAO7D,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAU,MAAM,QAAQ,CAAC;AAExD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAahE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,YAAY,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAExF;;;;;GAKG;AACH,QAAA,MAAM,OAAO,2IAUX,CAAC;AAEH;;;;;GAKG;AACH,QAAA,MAAM,OAAO,2IA8BX,CAAC;AAEH;;;;;GAKG;AACH,QAAA,MAAM,UAAU,qLAUd,CAAC;;sBAMmB,OAAO,OAAO;sBACd,OAAO,OAAO;yBACX,OAAO,UAAU;;AAN1C,kFAAkF;AAClF,qBAAa,eAAgB,SAAQ,oBAOM;CAAG;AAE9C,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,4CAI9B,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,uBAAuB,EAChC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,QAAQ,CAAC,CAInB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,uBAAuB,EAChC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,QAAQ,CAAC,CAMnB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,uBAAuB,EAChC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,QAAQ,CAAC,CAMnB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,uBAAuB,EAChC,MAAM,EAAE,SAAS,CAAC,aAAa,GAAG,mBAAmB,CAAC,EAAE,EACxD,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,QAAQ,CAAC,CAMnB"}

package/dist/response-mapping.js

@@ -1,60 +1,127 @@
 import { InvocationValidationError } from "@relkit/engine";
-import { isInvocationFailure, normalizeFailure, toFailureTelemetry, toPublicEnvelope, } from "@relkit/runtime-effect";
-import { validate } from "@relkit/schema";
-import { findError, findResponse, findSchema, findSuccess, findValidation, genericResponse, jsonResponse, responseStatus, safeIssue, } from "./response-mapping-utils.js";
-/** Converts one successful engine result or normalized engine failure to HTTP. */
-export function mapResponse(trigger, value, options = {}) {
-    return isFailure(value)
-        ? mapFailureResponse(trigger, value, options)
-        : mapSuccessResponse(trigger, value, options);
-}
-export async function mapSuccessResponse(trigger, value, options = {}) {
+import { isInvocationFailure, normalizeFailure, toPublicEnvelope, } from "@relkit/runtime-effect";
+import {} from "@relkit/schema";
+import { Context, Effect, Layer, Result } from "effect";
+import { observeHttp, runHttp } from "./http-effect.js";
+import { developmentProviderMessage } from "./response-mapping-provider.js";
+import { findError, findResponse, findSuccess, findValidation, genericResponse, jsonResponse, responseStatus, safeIssue, } from "./response-mapping-utils.js";
+import { responseIsValid } from "./response-mapping-validation.js";
+/** Serializes the declared success response after optional output-schema validation.
+ * @param trigger - Registered route declaration with its target and transport contract.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns An effect yielding the declared success response or a safe output-validation failure.
+ */
+const success = Effect.fn("ResponseMapping.success")(function* (trigger, value, options = {}) {
     const declaration = findSuccess(trigger, options.responseId);
     if (value instanceof Response)
         return value;
-    if (await responseIsValid(trigger, declaration, value, options)) {
-        try {
-            return jsonResponse(value, responseStatus(declaration, 200));
-        }
-        catch {
-            return genericResponse("internal-error", 500);
-        }
-    }
-    return genericResponse("internal-error", 500);
-}
-export async function mapFailureResponse(trigger, cause, options = {}) {
+    if (!(yield* responseIsValid(trigger, declaration, value, options)))
+        return genericResponse("internal-error", 500);
+    return yield* encodeJson(value, responseStatus(declaration, 200));
+});
+/** Maps declared failures to their public envelope without exposing native causes.
+ * @param trigger - Registered route declaration with its target and transport contract.
+ * @param cause - Native failure projected without exposing private exception details.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns An effect yielding the declared public error response or a sanitized transport fallback.
+ */
+const failure = Effect.fn("ResponseMapping.failure")(function* (trigger, cause, options = {}) {
     if (cause instanceof InvocationValidationError && cause.phase === "input")
-        return mapInputValidationResponse(trigger, cause.issues, options);
+        return yield* validation(trigger, cause.issues, options);
     if (cause instanceof InvocationValidationError && cause.phase === "output")
         return genericResponse("internal-error", 500);
-    try {
-        const failure = normalizeFailure(cause, options.signal === undefined ? {} : { signal: options.signal });
-        if (failure.kind === "application") {
-            const declaration = findError(trigger, failure.id);
-            if (declaration === undefined)
-                return genericResponse("internal-error", 500);
-            const body = toPublicEnvelope(failure);
-            if (!(await responseIsValid(trigger, declaration, failure.data, options)))
-                return genericResponse("internal-error", 500);
-            const response = jsonResponse(body, responseStatus(declaration, 500));
-            if (failure.retry === "later" && failure.afterMs !== undefined)
-                response.headers.set("Retry-After", String(Math.ceil(failure.afterMs / 1000)));
-            return response;
-        }
-        return genericFailureResponse(trigger, failure, options);
-    }
-    catch {
+    const normalized = yield* Effect.result(Effect.try({
+        try: () => normalizeFailure(cause, options.signal === undefined ? {} : { signal: options.signal }),
+        catch: (error) => error,
+    }));
+    if (Result.isFailure(normalized))
         return genericResponse("internal-error", 500);
-    }
-}
-export async function mapInputValidationResponse(trigger, issues, options = {}) {
+    const failure = normalized.success;
+    if (failure.kind !== "application")
+        return yield* genericFailureResponse(trigger, failure, options);
+    const declaration = findError(trigger, failure.id);
+    if (declaration === undefined ||
+        !(yield* responseIsValid(trigger, declaration, failure.data, options)))
+        return genericResponse("internal-error", 500);
+    const response = yield* encodeJson(toPublicEnvelope(failure), responseStatus(declaration, 500));
+    if (failure.retry === "later" && failure.afterMs !== undefined)
+        response.headers.set("Retry-After", String(Math.ceil(failure.afterMs / 1000)));
+    return response;
+});
+/** Sanitizes validation issue paths before producing the declared validation response.
+ * @param trigger - Registered route declaration with its target and transport contract.
+ * @param issues - issues supplied by the caller.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns An effect yielding sanitized issues at the declared validation status, normally HTTP 422.
+ */
+const validation = Effect.fn("ResponseMapping.validation")(function* (trigger, issues, options = {}) {
     const body = { error: "validation", issues: issues.map(safeIssue) };
     const declaration = findValidation(trigger);
-    return (await responseIsValid(trigger, declaration, body, options))
+    return (yield* responseIsValid(trigger, declaration, body, options))
         ? jsonResponse(body, responseStatus(declaration, 422))
         : genericResponse("internal-error", 500);
+});
+/** Response construction and validation share one replaceable domain contract. */
+export class ResponseMapping extends Context.Service()("@relkit/runtime-hono/ResponseMapping") {
 }
-async function genericFailureResponse(trigger, failure, options) {
+/** Live response policy, including safe public failure projection and configured schemas. */
+export const ResponseMappingLive = Layer.succeed(ResponseMapping, {
+    success: (...args) => observeHttp("response.success", success(...args)),
+    failure: (...args) => observeHttp("response.failure", failure(...args)),
+    validation: (...args) => observeHttp("response.validation", validation(...args)),
+});
+/** Converts one successful engine result or normalized engine failure to HTTP.
+ * @param trigger - Registered route declaration with its target and transport contract.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns A Promise for the mapped success or public failure HTTP response.
+ */
+export function mapResponse(trigger, value, options = {}) {
+    return value instanceof Error || isInvocationFailure(value)
+        ? mapFailureResponse(trigger, value, options)
+        : mapSuccessResponse(trigger, value, options);
+}
+/** Executes successful response mapping at the native framework edge.
+ * @param trigger - Registered route declaration with its target and transport contract.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns A Promise resolving the validated public HTTP response.
+ */
+export function mapSuccessResponse(trigger, value, options = {}) {
+    return runHttp(Effect.flatMap(ResponseMapping, (service) => service.success(trigger, value, options)).pipe(Effect.provide(ResponseMappingLive)));
+}
+/** Executes public failure mapping at the native framework edge.
+ * @param trigger - Registered route declaration with its target and transport contract.
+ * @param cause - Native failure projected without exposing private exception details.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns A Promise resolving a safe declared failure response.
+ */
+export function mapFailureResponse(trigger, cause, options = {}) {
+    return runHttp(Effect.flatMap(ResponseMapping, (service) => service.failure(trigger, cause, options)).pipe(Effect.provide(ResponseMappingLive)));
+}
+/** Executes request-validation mapping at the native framework edge.
+ * @param trigger - Registered route declaration with its target and transport contract.
+ * @param issues - issues supplied by the caller.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns A Promise resolving the sanitized validation response.
+ */
+export function mapInputValidationResponse(trigger, issues, options = {}) {
+    return runHttp(Effect.flatMap(ResponseMapping, (service) => service.validation(trigger, issues, options)).pipe(Effect.provide(ResponseMappingLive)));
+}
+/** Converts a serializable application value; invalid JSON values become safe HTTP failures.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @param status - HTTP status associated with the observed response or lifecycle event.
+ * @returns An effect yielding serialized JSON or a safe HTTP 500 response when serialization fails.
+ */
+const encodeJson = Effect.fn("ResponseMapping.encodeJson")((value, status) => Effect.try({ try: () => jsonResponse(value, status), catch: (cause) => cause }).pipe(Effect.catch(() => Effect.succeed(genericResponse("internal-error", 500)))));
+/** Map a non-application failure to its declared response or bounded transport fallback.
+ * @param trigger - Route declarations used to select an outcome-specific response.
+ * @param failure - Normalized provider, cancellation, timeout or defect failure.
+ * @param options - Runtime exposure mode and optional response schemas.
+ * @returns An effect yielding a validated public failure response without native cause details.
+ */
+const genericFailureResponse = Effect.fn("ResponseMapping.genericFailure")(function* (trigger, failure, options) {
     const { kind, outcome } = failure;
     const declaration = findResponse(trigger, [outcome, kind]);
     const details = {
@@ -68,33 +135,8 @@ async function genericFailureResponse(trigger, failure, options) {
     const detail = details[outcome] ?? details[kind] ?? { status: 500, error: "internal-error" };
     const message = developmentProviderMessage(failure, options.mode);
     const body = { error: detail.error, ...(message === undefined ? {} : { message }) };
-    return (await responseIsValid(trigger, declaration, body, options))
-        ? jsonResponse(body, responseStatus(declaration, detail.status))
+    return (yield* responseIsValid(trigger, declaration, body, options))
+        ? yield* encodeJson(body, responseStatus(declaration, detail.status))
         : genericResponse("internal-error", 500);
-}
-function developmentProviderMessage(failure, mode) {
-    if (failure.kind !== "provider" || mode !== "development")
-        return undefined;
-    const cause = toFailureTelemetry(failure, { mode: "development" }).internal?.cause;
-    if (cause === null || typeof cause !== "object" || !("message" in cause))
-        return undefined;
-    return typeof cause.message === "string" ? cause.message : undefined;
-}
-async function responseIsValid(trigger, declaration, value, options) {
-    if (options.mode === "production")
-        return true;
-    const schema = findSchema(trigger, declaration, options.responseSchemas);
-    if (schema === undefined)
-        return true;
-    try {
-        const result = await validate(schema, value);
-        return "value" in result;
-    }
-    catch {
-        return false;
-    }
-}
-function isFailure(value) {
-    return value instanceof Error || isInvocationFailure(value);
-}
+});
 //# sourceMappingURL=response-mapping.js.map