@relkit/runtime-hono 0.5.4 → 0.5.5

package/dist/middleware-limits.js.map

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

package/dist/middleware-utils.d.ts

@@ -1,67 +1,76 @@
-import type { MaybePromise, RequestId, SpanContext, TraceId } from "@relkit/contracts";
-import type { RequestRecordBuilder, RequestRecordSink } from "@relkit/observability";
+import type { RequestId, TraceId } from "@relkit/contracts";
 import type { Context } from "hono";
-import type { RelkitSpan, SpanRuntime } from "@relkit/invocation";
+import type { HttpMiddlewareOptions, HttpRequestState, RequestLifecycleEvent, RequestLifecycleHooks, RequestLifecycleType } from "./middleware-utils.types.js";
+export type { HttpMiddlewareOptions, HttpRequestState, RequestLifecycleEvent, RequestLifecycleHooks, RequestLifecycleType, } from "./middleware-utils.types.js";
 export declare const REQUEST_ID_HEADER: "x-request-id";
 export declare const TRACE_ID_HEADER: "x-trace-id";
 export declare const REQUEST_CONTEXT_KEY: "relkit.request";
-export interface HttpRequestState {
-    readonly requestId: RequestId;
-    readonly traceId: TraceId;
-    readonly remoteParent?: SpanContext;
-    readonly serverSpan?: RelkitSpan;
-    readonly signal: AbortSignal;
-    readonly startedAt: number;
-    readonly deadlineMs?: number;
-    readonly requestRecord?: RequestRecordBuilder;
-    readonly lifecycleStarted?: true;
-    readonly runtimeSignal?: {
-        current: AbortSignal;
-        terminalLifecycle?: boolean;
-    };
-}
-export type RequestLifecycleType = "request.started" | "request.completed" | "request.failed" | "request.cancelled";
-export interface RequestLifecycleEvent {
-    readonly type: RequestLifecycleType;
-    readonly requestId: RequestId;
-    readonly traceId: TraceId;
-    readonly method: string;
-    readonly path: string;
-    readonly startedAt: string;
-    readonly completedAt?: string;
-    readonly durationMs?: number;
-    readonly status?: number;
-    readonly errorName?: string;
-}
-export interface RequestLifecycleHooks {
-    readonly emit?: (event: RequestLifecycleEvent) => MaybePromise<void>;
-    readonly onStart?: (event: RequestLifecycleEvent) => MaybePromise<void>;
-    readonly onComplete?: (event: RequestLifecycleEvent) => MaybePromise<void>;
-    readonly onError?: (event: RequestLifecycleEvent) => MaybePromise<void>;
-    readonly onCancel?: (event: RequestLifecycleEvent) => MaybePromise<void>;
-}
-export interface HttpMiddlewareOptions {
-    readonly requestIdHeader?: string;
-    readonly traceIdHeader?: string;
-    readonly requestId?: () => string;
-    readonly traceId?: () => string;
-    readonly maxBodyBytes?: number;
-    readonly timeoutMs?: number;
-    readonly generationId?: string;
-    readonly graphHash?: string;
-    readonly now?: () => number;
-    readonly observability?: RequestRecordSink;
-    readonly lifecycle?: RequestLifecycleHooks;
-    readonly onLifecycleEvent?: (event: RequestLifecycleEvent) => MaybePromise<void>;
-    readonly spanRuntime?: SpanRuntime;
-}
+/** Reads the framework-owned state attached to the Hono request.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @returns Valid framework request state, or undefined when no supported state is attached.
+ */
 export declare function getRequestState(context: Context): HttpRequestState | undefined;
+/** Stores immutable request state for subsequent middleware and route handling.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param state - State owned by the current request or operation.
+ * @returns Nothing; updates the framework state and public request-ID, trace-ID and signal bindings.
+ */
 export declare function setRequestState(context: Context, state: HttpRequestState): void;
+/** Sets a response header without replacing the response body.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param name - Declared field, header, stream or configuration key.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns Nothing; replaces response headers while retaining the same body and status.
+ */
 export declare function setResponseHeader(context: Context, name: string, value: string): void;
+/** Creates request state when no outer native boundary supplied one.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns A frozen request state using the native signal and validated or generated identifiers.
+ */
 export declare function createFallbackState(context: Context, options: HttpMiddlewareOptions): HttpRequestState;
+/** Accepts a valid incoming identifier or generates and normalizes a replacement.
+ * @param incoming - Untrusted incoming identifier to validate before reuse.
+ * @param generate - Optional application identifier generator.
+ * @param prefix - Identifier kind used by the fallback generator.
+ * @param normalize - Identifier normalizer enforcing the public identifier contract.
+ * @typeParam T - Value type retained by this operation.
+ * @returns A normalized identifier, falling back to a generated value when supplied input is invalid.
+ */
 export declare function readId<T extends RequestId | TraceId>(incoming: string | undefined, generate: (() => string) | undefined, prefix: string, normalize: (value: unknown) => T): T;
+/** Builds a lifecycle event from the current Hono request and trace state.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param state - State owned by the current request or operation.
+ * @param type - Lifecycle event kind describing the current request boundary.
+ * @param error - Failure metadata recorded or projected at this boundary.
+ * @param status - HTTP status associated with the observed response or lifecycle event.
+ * @returns An immutable event with request identifiers and terminal duration/status when applicable.
+ */
 export declare function lifecycleEvent(context: Context, state: HttpRequestState, type: RequestLifecycleType, error?: unknown, status?: number): RequestLifecycleEvent;
+/** Invokes lifecycle hooks without allowing observer failure to alter the request.
+ * @param options - Application dependencies and configuration for this domain.
+ * @param event - Event or record being projected into the target protocol.
+ * @param hook - Optional lifecycle hook selected for this event.
+ * @returns A Promise settling after advisory hooks run in order, with hook failures isolated.
+ */
 export declare function emitLifecycle(options: HttpMiddlewareOptions, event: RequestLifecycleEvent, hook: keyof RequestLifecycleHooks): Promise<void>;
+/** Emits a terminal lifecycle event once for the owning request state.
+ * @param options - Application dependencies and configuration for this domain.
+ * @param state - State owned by the current request or operation.
+ * @param event - Event or record being projected into the target protocol.
+ * @param hook - Optional lifecycle hook selected for this event.
+ * @returns A Promise settling after the first terminal event; repeated terminal calls are ignored.
+ */
 export declare function emitTerminalLifecycle(options: HttpMiddlewareOptions, state: HttpRequestState, event: RequestLifecycleEvent, hook: keyof RequestLifecycleHooks): Promise<void>;
+/** Rejects invalid configured body or timeout limits during setup.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @param name - Declared field, header, stream or configuration key.
+ * @returns Nothing for an absent or positive integer limit; invalid values throw TypeError.
+ */
 export declare function validateLimit(value: number | undefined, name: string): void;
+/** Projects a safe exception name for lifecycle telemetry.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns The nonempty native error name, defaulting to Error for unsupported values.
+ */
+export declare function errorName(value: unknown): string;
 //# sourceMappingURL=middleware-utils.d.ts.map

package/dist/middleware-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware-utils.d.ts","sourceRoot":"","sources":["../src/middleware-utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"middleware-utils.d.ts","sourceRoot":"","sources":["../src/middleware-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,SAAS,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EACV,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AAErC,eAAO,MAAM,iBAAiB,EAAG,cAAuB,CAAC;AACzD,eAAO,MAAM,eAAe,EAAG,YAAqB,CAAC;AACrD,eAAO,MAAM,mBAAmB,EAAG,gBAAyB,CAAC;AAI7D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAG9E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAO/E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CASrF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,qBAAqB,GAC7B,gBAAgB,CAUlB;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,SAAS,GAAG,OAAO,EAClD,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,EACpC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,GAC/B,CAAC,CAWH;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,oBAAoB,EAC1B,KAAK,CAAC,EAAE,OAAO,EACf,MAAM,CAAC,EAAE,MAAM,GACd,qBAAqB,CAkBvB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EAAE,qBAAqB,EAC5B,IAAI,EAAE,MAAM,qBAAqB,GAChC,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EAAE,gBAAgB,EACvB,KAAK,EAAE,qBAAqB,EAC5B,IAAI,EAAE,MAAM,qBAAqB,GAChC,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAG3E;AAmBD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEhD"}

package/dist/middleware-utils.js

@@ -3,10 +3,19 @@ export const REQUEST_ID_HEADER = "x-request-id";
 export const TRACE_ID_HEADER = "x-trace-id";
 export const REQUEST_CONTEXT_KEY = "relkit.request";
 const terminalLifecycleStates = new WeakSet();
+/** Reads the framework-owned state attached to the Hono request.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @returns Valid framework request state, or undefined when no supported state is attached.
+ */
 export function getRequestState(context) {
     const value = context.get(REQUEST_CONTEXT_KEY);
     return isRequestState(value) ? value : undefined;
 }
+/** Stores immutable request state for subsequent middleware and route handling.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param state - State owned by the current request or operation.
+ * @returns Nothing; updates the framework state and public request-ID, trace-ID and signal bindings.
+ */
 export function setRequestState(context, state) {
     const target = context;
     target.set(REQUEST_CONTEXT_KEY, state);
@@ -16,6 +25,12 @@ export function setRequestState(context, state) {
     if (state.runtimeSignal !== undefined)
         state.runtimeSignal.current = state.signal;
 }
+/** Sets a response header without replacing the response body.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param name - Declared field, header, stream or configuration key.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns Nothing; replaces response headers while retaining the same body and status.
+ */
 export function setResponseHeader(context, name, value) {
     const response = context.res;
     const headers = new Headers(response.headers);
@@ -26,6 +41,11 @@ export function setResponseHeader(context, name, value) {
         headers,
     });
 }
+/** Creates request state when no outer native boundary supplied one.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns A frozen request state using the native signal and validated or generated identifiers.
+ */
 export function createFallbackState(context, options) {
     return Object.freeze({
         requestId: readId(undefined, options.requestId, "request", toRequestId),
@@ -36,7 +56,18 @@ export function createFallbackState(context, options) {
         startedAt: Date.now(),
     });
 }
+/** Accepts a valid incoming identifier or generates and normalizes a replacement.
+ * @param incoming - Untrusted incoming identifier to validate before reuse.
+ * @param generate - Optional application identifier generator.
+ * @param prefix - Identifier kind used by the fallback generator.
+ * @param normalize - Identifier normalizer enforcing the public identifier contract.
+ * @typeParam T - Value type retained by this operation.
+ * @returns A normalized identifier, falling back to a generated value when supplied input is invalid.
+ */
 export function readId(incoming, generate, prefix, normalize) {
+    /** Generate a trace ID or a UUID-based identifier for this identifier kind.
+     * @returns Fresh fallback text passed through the same public normalizer.
+     */
     const fallback = () => prefix === "trace" ? createTraceId() : `${prefix}-${crypto.randomUUID()}`;
     try {
         return normalize(incoming ?? generate?.() ?? fallback());
@@ -45,6 +76,14 @@ export function readId(incoming, generate, prefix, normalize) {
         return normalize(fallback());
     }
 }
+/** Builds a lifecycle event from the current Hono request and trace state.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param state - State owned by the current request or operation.
+ * @param type - Lifecycle event kind describing the current request boundary.
+ * @param error - Failure metadata recorded or projected at this boundary.
+ * @param status - HTTP status associated with the observed response or lifecycle event.
+ * @returns An immutable event with request identifiers and terminal duration/status when applicable.
+ */
 export function lifecycleEvent(context, state, type, error, status) {
     const now = Date.now();
     return Object.freeze({
@@ -64,11 +103,24 @@ export function lifecycleEvent(context, state, type, error, status) {
         ...(error === undefined ? {} : { errorName: errorName(error) }),
     });
 }
+/** Invokes lifecycle hooks without allowing observer failure to alter the request.
+ * @param options - Application dependencies and configuration for this domain.
+ * @param event - Event or record being projected into the target protocol.
+ * @param hook - Optional lifecycle hook selected for this event.
+ * @returns A Promise settling after advisory hooks run in order, with hook failures isolated.
+ */
 export async function emitLifecycle(options, event, hook) {
     await call(options.onLifecycleEvent, event);
     await call(options.lifecycle?.emit, event);
     await call(options.lifecycle?.[hook], event);
 }
+/** Emits a terminal lifecycle event once for the owning request state.
+ * @param options - Application dependencies and configuration for this domain.
+ * @param state - State owned by the current request or operation.
+ * @param event - Event or record being projected into the target protocol.
+ * @param hook - Optional lifecycle hook selected for this event.
+ * @returns A Promise settling after the first terminal event; repeated terminal calls are ignored.
+ */
 export async function emitTerminalLifecycle(options, state, event, hook) {
     if (state.runtimeSignal?.terminalLifecycle === true || terminalLifecycleStates.has(state))
         return;
@@ -77,10 +129,21 @@ export async function emitTerminalLifecycle(options, state, event, hook) {
     terminalLifecycleStates.add(state);
     await emitLifecycle(options, event, hook);
 }
+/** Rejects invalid configured body or timeout limits during setup.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @param name - Declared field, header, stream or configuration key.
+ * @returns Nothing for an absent or positive integer limit; invalid values throw TypeError.
+ */
 export function validateLimit(value, name) {
     if (value !== undefined && (!Number.isSafeInteger(value) || value < 1))
         throw new TypeError(`${name} must be a positive integer`);
 }
+/** Invoke one optional advisory hook and isolate its rejection.
+ * @param hook - Optional lifecycle hook selected for this event.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @typeParam T - Value type retained by this operation.
+ * @returns A Promise that succeeds after the optional advisory hook settles, including when it rejects.
+ */
 async function call(hook, value) {
     try {
         await hook?.(value);
@@ -89,9 +152,17 @@ async function call(hook, value) {
         // Lifecycle observers are advisory and cannot alter the response.
     }
 }
-function errorName(value) {
+/** Projects a safe exception name for lifecycle telemetry.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns The nonempty native error name, defaulting to Error for unsupported values.
+ */
+export function errorName(value) {
     return value instanceof Error && value.name.length > 0 ? value.name : "Error";
 }
+/** Recognizes valid framework request state before using its identifiers and signal.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns Whether the inspected value satisfies the declared type guard.
+ */
 function isRequestState(value) {
     if (value === null || typeof value !== "object")
         return false;

package/dist/middleware-utils.js.map

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

package/dist/middleware-utils.types.d.ts

@@ -0,0 +1,59 @@
+import type { MaybePromise, RequestId, SpanContext, TraceId } from "@relkit/contracts";
+import type { RequestRecordBuilder, RequestRecordSink } from "@relkit/observability";
+import type { RelkitSpan, SpanRuntime } from "@relkit/invocation";
+/** State owned by middleware utils. */
+export interface HttpRequestState {
+    readonly requestId: RequestId;
+    readonly traceId: TraceId;
+    readonly remoteParent?: SpanContext;
+    readonly serverSpan?: RelkitSpan;
+    readonly signal: AbortSignal;
+    readonly startedAt: number;
+    readonly deadlineMs?: number;
+    readonly requestRecord?: RequestRecordBuilder;
+    readonly lifecycleStarted?: true;
+    readonly runtimeSignal?: {
+        current: AbortSignal;
+        terminalLifecycle?: boolean;
+    };
+}
+/** Contract for request lifecycle type used by middleware utils. */
+export type RequestLifecycleType = "request.started" | "request.completed" | "request.failed" | "request.cancelled";
+/** Contract for request lifecycle event used by middleware utils. */
+export interface RequestLifecycleEvent {
+    readonly type: RequestLifecycleType;
+    readonly requestId: RequestId;
+    readonly traceId: TraceId;
+    readonly method: string;
+    readonly path: string;
+    readonly startedAt: string;
+    readonly completedAt?: string;
+    readonly durationMs?: number;
+    readonly status?: number;
+    readonly errorName?: string;
+}
+/** Contract for request lifecycle hooks used by middleware utils. */
+export interface RequestLifecycleHooks {
+    readonly emit?: (event: RequestLifecycleEvent) => MaybePromise<void>;
+    readonly onStart?: (event: RequestLifecycleEvent) => MaybePromise<void>;
+    readonly onComplete?: (event: RequestLifecycleEvent) => MaybePromise<void>;
+    readonly onError?: (event: RequestLifecycleEvent) => MaybePromise<void>;
+    readonly onCancel?: (event: RequestLifecycleEvent) => MaybePromise<void>;
+}
+/** http middleware options configuring dependencies, callbacks and runtime policy. */
+export interface HttpMiddlewareOptions {
+    readonly requestIdHeader?: string;
+    readonly traceIdHeader?: string;
+    readonly requestId?: () => string;
+    readonly traceId?: () => string;
+    readonly maxBodyBytes?: number;
+    readonly timeoutMs?: number;
+    readonly generationId?: string;
+    readonly graphHash?: string;
+    readonly now?: () => number;
+    readonly observability?: RequestRecordSink;
+    readonly lifecycle?: RequestLifecycleHooks;
+    readonly onLifecycleEvent?: (event: RequestLifecycleEvent) => MaybePromise<void>;
+    readonly spanRuntime?: SpanRuntime;
+}
+//# sourceMappingURL=middleware-utils.types.d.ts.map

package/dist/middleware-utils.types.d.ts.map

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

package/dist/middleware-utils.types.js

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

package/dist/middleware-utils.types.js.map

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

package/dist/middleware.d.ts

@@ -1,17 +1,29 @@
 import type { MiddlewareHandler } from "hono";
 import { type HttpMiddlewareOptions } from "./middleware-utils.js";
-export { REQUEST_CONTEXT_KEY, REQUEST_ID_HEADER, TRACE_ID_HEADER, getRequestState, type HttpMiddlewareOptions, type HttpRequestState, type RequestLifecycleEvent, type RequestLifecycleHooks, type RequestLifecycleType, } from "./middleware-utils.js";
+import type { FrameworkMiddleware } from "./middleware.types.js";
+export type { FrameworkMiddleware, FrameworkMiddlewareName } from "./middleware.types.js";
+export { getRequestState, REQUEST_CONTEXT_KEY, REQUEST_ID_HEADER, TRACE_ID_HEADER, type HttpMiddlewareOptions, type HttpRequestState, type RequestLifecycleEvent, type RequestLifecycleHooks, type RequestLifecycleType, } from "./middleware-utils.js";
 export declare const FRAMEWORK_MIDDLEWARE_ORDER: readonly ["request-id", "trace", "limits", "request-record"];
-export type FrameworkMiddlewareName = (typeof FRAMEWORK_MIDDLEWARE_ORDER)[number];
-export interface FrameworkMiddleware {
-    readonly name: FrameworkMiddlewareName;
-    readonly handler: MiddlewareHandler;
-}
-/** Installs the four framework-owned HTTP middleware layers in v3 order. */
+/** Installs the four framework-owned HTTP middleware layers in v3 order.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns The ordered immutable request-ID, trace, limits and request-record middleware list.
+ */
 export declare function createFrameworkMiddleware(options?: HttpMiddlewareOptions): readonly FrameworkMiddleware[];
 export declare const createHttpMiddleware: typeof createFrameworkMiddleware;
 export { limitsMiddleware } from "./middleware-limits.js";
+/** Establishes one request identity for downstream middleware and response headers.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns A handler retaining the request identity through downstream execution and response headers.
+ */
 export declare function requestIdMiddleware(options?: HttpMiddlewareOptions): MiddlewareHandler;
+/** Resolves incoming trace context for the request and downstream invocation.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns The HTTP span middleware configured for incoming trace propagation.
+ */
 export declare function traceMiddleware(options?: HttpMiddlewareOptions): MiddlewareHandler;
+/** Emits request lifecycle events while preserving the downstream result and failure.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns A handler emitting lifecycle observations while preserving downstream failures.
+ */
 export declare function requestLifecycleMiddleware(options?: HttpMiddlewareOptions): MiddlewareHandler;
 //# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,EAWL,KAAK,qBAAqB,EAK3B,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,uBAAuB,CAAC;AAE/B,eAAO,MAAM,0BAA0B,8DAK5B,CAAC;AACZ,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAElF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;CACrC;AAED,4EAA4E;AAC5E,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,qBAA0B,GAClC,SAAS,mBAAmB,EAAE,CAQhC;AAED,eAAO,MAAM,oBAAoB,kCAA4B,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,qBAA0B,GAAG,iBAAiB,CAkC1F;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,qBAA0B,GAAG,iBAAiB,CAEtF;AAED,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,qBAA0B,GAAG,iBAAiB,CAqCjG"}
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAI9C,OAAO,EAUL,KAAK,qBAAqB,EAE3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAGjE,YAAY,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAE1F,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,uBAAuB,CAAC;AAE/B,eAAO,MAAM,0BAA0B,8DAK5B,CAAC;AAEZ;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,qBAA0B,GAClC,SAAS,mBAAmB,EAAE,CAQhC;AAED,eAAO,MAAM,oBAAoB,kCAA4B,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,qBAA0B,GAAG,iBAAiB,CAkC1F;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,qBAA0B,GAAG,iBAAiB,CAEtF;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,qBAA0B,GAAG,iBAAiB,CAwCjG"}

package/dist/middleware.js

@@ -1,18 +1,21 @@
 import { parseTraceParent, toRequestId } from "@relkit/contracts";
-import { createFallbackState, emitLifecycle, emitTerminalLifecycle, getRequestState, lifecycleEvent, readId, REQUEST_ID_HEADER, setResponseHeader, setRequestState, TRACE_ID_HEADER, } from "./middleware-utils.js";
-import { ensureRequestRecord } from "./request-record-middleware.js";
+import { isRelkitControlPlanePath } from "./control-plane.js";
+import { createHttpSpanRuntime, httpSpanMiddleware, outerHttpState } from "./http-span.js";
 import { limitsMiddleware } from "./middleware-limits.js";
+import { createFallbackState, emitLifecycle, emitTerminalLifecycle, getRequestState, lifecycleEvent, readId, REQUEST_ID_HEADER, setRequestState, setResponseHeader, } from "./middleware-utils.js";
+import { ensureRequestRecord } from "./request-record-middleware.js";
 import { failureOutcome } from "./request-record-utils.js";
-import { createHttpSpanRuntime, httpSpanMiddleware, outerHttpState } from "./http-span.js";
-import { isRelkitControlPlanePath } from "./control-plane.js";
-export { REQUEST_CONTEXT_KEY, REQUEST_ID_HEADER, TRACE_ID_HEADER, getRequestState, } from "./middleware-utils.js";
+export { getRequestState, REQUEST_CONTEXT_KEY, REQUEST_ID_HEADER, TRACE_ID_HEADER, } from "./middleware-utils.js";
 export const FRAMEWORK_MIDDLEWARE_ORDER = Object.freeze([
     "request-id",
     "trace",
     "limits",
     "request-record",
 ]);
-/** Installs the four framework-owned HTTP middleware layers in v3 order. */
+/** Installs the four framework-owned HTTP middleware layers in v3 order.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns The ordered immutable request-ID, trace, limits and request-record middleware list.
+ */
 export function createFrameworkMiddleware(options = {}) {
     options = { ...options, spanRuntime: createHttpSpanRuntime(options) };
     return Object.freeze([
@@ -24,6 +27,10 @@ export function createFrameworkMiddleware(options = {}) {
 }
 export const createHttpMiddleware = createFrameworkMiddleware;
 export { limitsMiddleware } from "./middleware-limits.js";
+/** Establishes one request identity for downstream middleware and response headers.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns A handler retaining the request identity through downstream execution and response headers.
+ */
 export function requestIdMiddleware(options = {}) {
     return async (context, next) => {
         const outer = outerHttpState(context.req.raw);
@@ -57,9 +64,17 @@ export function requestIdMiddleware(options = {}) {
         }
     };
 }
+/** Resolves incoming trace context for the request and downstream invocation.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns The HTTP span middleware configured for incoming trace propagation.
+ */
 export function traceMiddleware(options = {}) {
     return httpSpanMiddleware(options);
 }
+/** Emits request lifecycle events while preserving the downstream result and failure.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns A handler emitting lifecycle observations while preserving downstream failures.
+ */
 export function requestLifecycleMiddleware(options = {}) {
     return async (context, next) => {
         const state = ensureRequestRecord(context, getRequestState(context) ?? createFallbackState(context, options), options);
@@ -68,6 +83,9 @@ export function requestLifecycleMiddleware(options = {}) {
             await emitLifecycle(options, started, "onStart");
         }
         const signal = state.runtimeSignal?.current ?? state.signal;
+        /** Publish the request's terminal cancellation event without delaying signal dispatch.
+         * @returns Nothing; advisory lifecycle delivery runs through the terminal-event guard.
+         */
         const cancelled = () => {
             void emitTerminalLifecycle(options, state, lifecycleEvent(context, state, "request.cancelled"), "onCancel");
         };
@@ -92,6 +110,10 @@ export function requestLifecycleMiddleware(options = {}) {
         }
     };
 }
+/** Skips application middleware on reserved control-plane endpoints.
+ * @param handler - Native handler executed within the configured boundary.
+ * @returns A handler bypassing the supplied middleware for reserved control-plane paths.
+ */
 function applicationOnly(handler) {
     return async (context, next) => {
         if (isRelkitControlPlanePath(context.req.path))

package/dist/middleware.js.map

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

package/dist/middleware.types.d.ts

@@ -0,0 +1,10 @@
+import type { MiddlewareHandler } from "hono";
+import type { FRAMEWORK_MIDDLEWARE_ORDER } from "./middleware.js";
+/** Contract for framework middleware name used by middleware. */
+export type FrameworkMiddlewareName = (typeof FRAMEWORK_MIDDLEWARE_ORDER)[number];
+/** Contract for framework middleware used by middleware. */
+export interface FrameworkMiddleware {
+    readonly name: FrameworkMiddlewareName;
+    readonly handler: MiddlewareHandler;
+}
+//# sourceMappingURL=middleware.types.d.ts.map

package/dist/middleware.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.types.d.ts","sourceRoot":"","sources":["../src/middleware.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAElE,iEAAiE;AACjE,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAElF,4DAA4D;AAC5D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;CACrC"}

package/dist/middleware.types.js

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

package/dist/middleware.types.js.map

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

package/dist/native-stream.d.ts

@@ -1,3 +1,20 @@
-export type NativeStreamFormat = "sse" | "text" | "bytes";
+import { Context, Layer, Stream } from "effect";
+import type { NativeStreamFormat } from "./native-stream.types.js";
+export type { NativeStreamFormat } from "./native-stream.types.js";
+declare const NativeStreams_base: Context.ServiceClass<NativeStreams, "@relkit/runtime-hono/NativeStreams", {
+    readonly encode: (source: AsyncIterable<unknown>, format: NativeStreamFormat) => Stream.Stream<Uint8Array, unknown>;
+}>;
+/** Converts native application output into a scoped, backpressured byte stream.
+ * @see tests/request-services.test.ts for checked early-return iterator cleanup.
+ */
+export declare class NativeStreams extends NativeStreams_base {
+}
+/** Scope closure returns the underlying application iterator exactly once. */
+export declare const NativeStreamsLive: Layer.Layer<NativeStreams, never, never>;
+/** Encodes native iterator output with backpressure and the established response headers.
+ * @param source - Native iterable or declared request-key source.
+ * @param format - Declared SSE, text or byte representation.
+ * @returns A Response whose body owns backpressure and source-iterator cleanup.
+ */
 export declare function nativeStreamResponse(source: AsyncIterable<unknown>, format: NativeStreamFormat): Promise<Response>;
 //# sourceMappingURL=native-stream.d.ts.map

package/dist/native-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native-stream.d.ts","sourceRoot":"","sources":["../src/native-stream.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAE1D,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAC9B,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,QAAQ,CAAC,CAmCnB"}
+{"version":3,"file":"native-stream.d.ts","sourceRoot":"","sources":["../src/native-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,KAAK,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;;qBAQ9C,CACf,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAC9B,MAAM,EAAE,kBAAkB,KACvB,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC;;AAT3C;;GAEG;AACH,qBAAa,aAAc,SAAQ,kBAQM;CAAG;AAE5C,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,0CAa5B,CAAC;AAEH;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAC9B,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,QAAQ,CAAC,CAoDnB"}