@relkit/runtime-hono 0.5.3 → 0.5.5

package/dist/client-contract.d.ts

@@ -1,8 +1,12 @@
 import type { Hono } from "hono";
+import type { ClientContractEndpointOptions } from "./client-contract.types.js";
+export type { ClientContractEndpointOptions } from "./client-contract.types.js";
+/** Stable location of the runtime's generated public client contract. */
 export declare const CLIENT_CONTRACT_PATH = "/_relkit/v1/client-contract.json";
-export interface ClientContractEndpointOptions {
-    readonly enabled?: boolean;
-    readonly document?: unknown;
-}
+/** Install the no-store client contract document endpoint when enabled.
+ * @param app - Hono application receiving the route.
+ * @param options - Runtime configuration and dependencies for this operation.
+ * @returns Nothing; registers the endpoint on the supplied app.
+ */
 export declare function installClientContractEndpoint(app: Hono, options?: ClientContractEndpointOptions): void;
 //# sourceMappingURL=client-contract.d.ts.map

package/dist/client-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client-contract.d.ts","sourceRoot":"","sources":["../src/client-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,eAAO,MAAM,oBAAoB,qCAAqC,CAAC;AAEvE,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,IAAI,EACT,OAAO,GAAE,6BAAkC,GAC1C,IAAI,CAQN"}
+{"version":3,"file":"client-contract.d.ts","sourceRoot":"","sources":["../src/client-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAChF,YAAY,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAEhF,yEAAyE;AACzE,eAAO,MAAM,oBAAoB,qCAAqC,CAAC;AAEvE;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,IAAI,EACT,OAAO,GAAE,6BAAkC,GAC1C,IAAI,CAQN"}

package/dist/client-contract.js

@@ -1,4 +1,10 @@
+/** Stable location of the runtime's generated public client contract. */
 export const CLIENT_CONTRACT_PATH = "/_relkit/v1/client-contract.json";
+/** Install the no-store client contract document endpoint when enabled.
+ * @param app - Hono application receiving the route.
+ * @param options - Runtime configuration and dependencies for this operation.
+ * @returns Nothing; registers the endpoint on the supplied app.
+ */
 export function installClientContractEndpoint(app, options = {}) {
     if (options.enabled === false)
         return;

package/dist/client-contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"client-contract.js","sourceRoot":"","sources":["../src/client-contract.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,oBAAoB,GAAG,kCAAkC,CAAC;AAOvE,MAAM,UAAU,6BAA6B,CAC3C,GAAS,EACT,UAAyC,EAAE;IAE3C,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK;QAAE,OAAO;IACtC,GAAG,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC,OAAO,EAAE,EAAE,CACxC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,EAAE,GAAG,EAAE;QACxC,eAAe,EAAE,UAAU;QAC3B,wBAAwB,EAAE,SAAS;KACpC,CAAC,CACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"client-contract.js","sourceRoot":"","sources":["../src/client-contract.ts"],"names":[],"mappings":"AAIA,yEAAyE;AACzE,MAAM,CAAC,MAAM,oBAAoB,GAAG,kCAAkC,CAAC;AAEvE;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAC3C,GAAS,EACT,UAAyC,EAAE;IAE3C,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK;QAAE,OAAO;IACtC,GAAG,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC,OAAO,EAAE,EAAE,CACxC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,EAAE,GAAG,EAAE;QACxC,eAAe,EAAE,UAAU;QAC3B,wBAAwB,EAAE,SAAS;KACpC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/client-contract.types.d.ts

@@ -0,0 +1,8 @@
+/** Client contract publication options; enabled by default when installed. */
+export interface ClientContractEndpointOptions {
+    /** Set false to omit the document route. */
+    readonly enabled?: boolean;
+    /** Generated client contract; an empty object is served when absent. */
+    readonly document?: unknown;
+}
+//# sourceMappingURL=client-contract.types.d.ts.map

package/dist/client-contract.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-contract.types.d.ts","sourceRoot":"","sources":["../src/client-contract.types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,WAAW,6BAA6B;IAC5C,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B"}

package/dist/client-contract.types.js

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

package/dist/client-contract.types.js.map

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

package/dist/client-identity.d.ts

@@ -1,24 +1,48 @@
-import type { MaybePromise } from "@relkit/contracts";
-import { type ExpectedClientIdentity, type JobsClientProtocol } from "@relkit/contracts";
+import type { ClientIdentityHeaders, ClientIdentityRuntime, ResolvedClientIdentity } from "./client-identity.types.js";
+export type { ClientIdentityHeaders, ClientIdentityRuntime, ResolvedClientIdentity, } from "./client-identity.types.js";
+import { type ExpectedClientIdentity } from "@relkit/contracts";
+import { Context, Effect, Layer } from "effect";
 import type { Hono } from "hono";
 import type { HttpAuthInvocation } from "./auth.js";
+import { HttpBoundaryError } from "./http-effect.js";
 export declare const CLIENT_IDENTITY_PATH = "/_relkit/v1/client/identity";
-export interface ResolvedClientIdentity extends ExpectedClientIdentity {
-    readonly setCookies?: readonly string[];
-}
-export type ClientIdentityHeaders = Readonly<Record<string, string | string[] | undefined>>;
-export interface ClientIdentityRuntime {
-    readonly applicationId: string;
-    readonly publicFingerprint: string;
-    readonly jobs?: JobsClientProtocol;
-    readonly resolve: (input: {
-        readonly request: Request;
-        readonly session: unknown | null;
-    }) => MaybePromise<ResolvedClientIdentity>;
-}
+/** Registers the identity document endpoint and forwards resolver-set cookies.
+ * @param app - Hono application receiving the configured endpoints or middleware.
+ * @param runtime - Configured runtime and provider dependencies.
+ * @param auth - Optional request authentication context or middleware configuration.
+ * @returns Nothing; registers the identity document endpoint with no-store response headers.
+ */
 export declare function installClientIdentityEndpoint(app: Hono, runtime: ClientIdentityRuntime, auth: {
     readonly contextFor: (request: Request) => HttpAuthInvocation;
 } | undefined): void;
+/** Resolve the current session and require nonempty public identity metadata.
+ * @param runtime - Application identity resolver and public contract configuration.
+ * @param request - Request supplied to the trusted identity callback.
+ * @param auth - Optional session authority for the current request.
+ * @param fresh - Whether to bypass cached session state for this observation.
+ * @returns A lazy effect yielding the resolved identity and any response cookies.
+ */
+declare const resolveIdentity: (runtime: ClientIdentityRuntime, request: Request, auth: HttpAuthInvocation | undefined, fresh?: any) => Effect.Effect<ResolvedClientIdentity, HttpBoundaryError, never>;
+declare const ClientIdentity_base: Context.ServiceClass<ClientIdentity, "@relkit/runtime-hono/ClientIdentity", {
+    readonly resolve: typeof resolveIdentity;
+}>;
+/** Resolves trusted identity using the current request session and configured callback. */
+export declare class ClientIdentity extends ClientIdentity_base {
+}
+/** Live identity workflow preserves explicit fresh-session observations. */
+export declare const ClientIdentityLive: Layer.Layer<ClientIdentity, never, never>;
+/** Resolves identity at the native request boundary.
+ * @param runtime - Configured runtime and provider dependencies.
+ * @param request - Native request whose headers, body and cancellation signal define this operation.
+ * @param auth - Optional request authentication context or middleware configuration.
+ * @param fresh - Whether the session cache must be refreshed for this observation.
+ * @returns A Promise for validated identity metadata and optional resolver-produced cookies.
+ */
 export declare function resolveClientIdentity(runtime: ClientIdentityRuntime, request: Request, auth: HttpAuthInvocation | undefined, fresh?: boolean): Promise<ResolvedClientIdentity>;
+/** Reads the client's expected identity from HTTP or oRPC headers.
+ * @param request - Native request whose headers, body and cancellation signal define this operation.
+ * @param rpcHeaders - Additional oRPC headers used when native request headers are absent.
+ * @returns Both expected identity values, or undefined if either header is absent.
+ */
 export declare function expectedClientIdentity(request: Request, rpcHeaders?: ClientIdentityHeaders): ExpectedClientIdentity | undefined;
 //# sourceMappingURL=client-identity.d.ts.map

package/dist/client-identity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client-identity.d.ts","sourceRoot":"","sources":["../src/client-identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEpD,eAAO,MAAM,oBAAoB,gCAAgC,CAAC;AAElE,MAAM,WAAW,sBAAuB,SAAQ,sBAAsB;IACpE,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;AAE5F,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE;QACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;KAClC,KAAK,YAAY,CAAC,sBAAsB,CAAC,CAAC;CAC5C;AAED,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,IAAI,EACT,OAAO,EAAE,qBAAqB,EAC9B,IAAI,EAAE;IAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,kBAAkB,CAAA;CAAE,GAAG,SAAS,GAClF,IAAI,CAmBN;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,kBAAkB,GAAG,SAAS,EACpC,KAAK,UAAQ,GACZ,OAAO,CAAC,sBAAsB,CAAC,CAOjC;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,UAAU,CAAC,EAAE,qBAAqB,GACjC,sBAAsB,GAAG,SAAS,CAQpC"}
+{"version":3,"file":"client-identity.d.ts","sourceRoot":"","sources":["../src/client-identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAgB,iBAAiB,EAAwB,MAAM,kBAAkB,CAAC;AAEzF,eAAO,MAAM,oBAAoB,gCAAgC,CAAC;AAElE;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,IAAI,EACT,OAAO,EAAE,qBAAqB,EAC9B,IAAI,EAAE;IAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,kBAAkB,CAAA;CAAE,GAAG,SAAS,GAClF,IAAI,CAmBN;AAED;;;;;;GAMG;AACH,QAAA,MAAM,eAAe,0KAqBnB,CAAC;;sBAKmB,OAAO,eAAe;;AAH5C,2FAA2F;AAC3F,qBAAa,cAAe,SAAQ,mBAGM;CAAG;AAE7C,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,2CAE7B,CAAC;AAEH;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,kBAAkB,GAAG,SAAS,EACpC,KAAK,UAAQ,GACZ,OAAO,CAAC,sBAAsB,CAAC,CAMjC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,UAAU,CAAC,EAAE,qBAAqB,GACjC,sBAAsB,GAAG,SAAS,CAQpC"}

package/dist/client-identity.js

@@ -1,5 +1,13 @@
 import { CLIENT_IDENTITY_HEADERS, } from "@relkit/contracts";
+import { Context, Effect, Layer } from "effect";
+import { httpBoundary, HttpBoundaryError, observeHttp, runHttp } from "./http-effect.js";
 export const CLIENT_IDENTITY_PATH = "/_relkit/v1/client/identity";
+/** Registers the identity document endpoint and forwards resolver-set cookies.
+ * @param app - Hono application receiving the configured endpoints or middleware.
+ * @param runtime - Configured runtime and provider dependencies.
+ * @param auth - Optional request authentication context or middleware configuration.
+ * @returns Nothing; registers the identity document endpoint with no-store response headers.
+ */
 export function installClientIdentityEndpoint(app, runtime, auth) {
     app.get(CLIENT_IDENTITY_PATH, async (context) => {
         const request = context.req.raw;
@@ -20,14 +28,47 @@ export function installClientIdentityEndpoint(app, runtime, auth) {
         return context.json(document, 200, CLIENT_IDENTITY_HEADERS);
     });
 }
-export async function resolveClientIdentity(runtime, request, auth, fresh = false) {
-    const session = (await auth?.getSession({ fresh })) ?? null;
-    const identity = await runtime.resolve({ request, session });
+/** Resolve the current session and require nonempty public identity metadata.
+ * @param runtime - Application identity resolver and public contract configuration.
+ * @param request - Request supplied to the trusted identity callback.
+ * @param auth - Optional session authority for the current request.
+ * @param fresh - Whether to bypass cached session state for this observation.
+ * @returns A lazy effect yielding the resolved identity and any response cookies.
+ */
+const resolveIdentity = Effect.fn("ClientIdentity.resolve")(function* (runtime, request, auth, fresh = false) {
+    const session = (yield* httpBoundary("identity.session", () => Promise.resolve(auth?.getSession({ fresh })))) ??
+        null;
+    const identity = yield* httpBoundary("identity.resolve", () => Promise.resolve(runtime.resolve({ request, session })));
     if (identity.identityScope === "" || identity.sessionEpoch === "") {
-        throw new TypeError("Client identity scope and session epoch must be non-empty.");
+        return yield* Effect.fail(new HttpBoundaryError({
+            operation: "identity.resolve",
+            cause: new TypeError("Client identity scope and session epoch must be non-empty."),
+        }));
     }
     return identity;
+});
+/** Resolves trusted identity using the current request session and configured callback. */
+export class ClientIdentity extends Context.Service()("@relkit/runtime-hono/ClientIdentity") {
 }
+/** Live identity workflow preserves explicit fresh-session observations. */
+export const ClientIdentityLive = Layer.succeed(ClientIdentity, {
+    resolve: (...args) => observeHttp("identity.resolve", resolveIdentity(...args)),
+});
+/** Resolves identity at the native request boundary.
+ * @param runtime - Configured runtime and provider dependencies.
+ * @param request - Native request whose headers, body and cancellation signal define this operation.
+ * @param auth - Optional request authentication context or middleware configuration.
+ * @param fresh - Whether the session cache must be refreshed for this observation.
+ * @returns A Promise for validated identity metadata and optional resolver-produced cookies.
+ */
+export function resolveClientIdentity(runtime, request, auth, fresh = false) {
+    return runHttp(Effect.flatMap(ClientIdentity, (identity) => identity.resolve(runtime, request, auth, fresh)).pipe(Effect.provide(ClientIdentityLive)));
+}
+/** Reads the client's expected identity from HTTP or oRPC headers.
+ * @param request - Native request whose headers, body and cancellation signal define this operation.
+ * @param rpcHeaders - Additional oRPC headers used when native request headers are absent.
+ * @returns Both expected identity values, or undefined if either header is absent.
+ */
 export function expectedClientIdentity(request, rpcHeaders) {
     const identityScope = request.headers.get("x-relkit-identity-scope") ?? header(rpcHeaders, "x-relkit-identity-scope");
     const sessionEpoch = request.headers.get("x-relkit-session-epoch") ?? header(rpcHeaders, "x-relkit-session-epoch");
@@ -35,6 +76,11 @@ export function expectedClientIdentity(request, rpcHeaders) {
         ? undefined
         : { identityScope, sessionEpoch };
 }
+/** Looks up a case-insensitive header and selects its first public value.
+ * @param headers - Native or protocol headers available to this request.
+ * @param name - Declared field, header, stream or configuration key.
+ * @returns The first matching header value, or null when no supported value exists.
+ */
 function header(headers, name) {
     if (headers === undefined)
         return null;

package/dist/client-identity.js.map

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

package/dist/client-identity.types.d.ts

@@ -0,0 +1,19 @@
+import type { MaybePromise } from "@relkit/contracts";
+import type { ExpectedClientIdentity, JobsClientProtocol } from "@relkit/contracts";
+/** Contract for resolved client identity used by client identity. */
+export interface ResolvedClientIdentity extends ExpectedClientIdentity {
+    readonly setCookies?: readonly string[];
+}
+/** Contract for client identity headers used by client identity. */
+export type ClientIdentityHeaders = Readonly<Record<string, string | string[] | undefined>>;
+/** Contract for client identity runtime used by client identity. */
+export interface ClientIdentityRuntime {
+    readonly applicationId: string;
+    readonly publicFingerprint: string;
+    readonly jobs?: JobsClientProtocol;
+    readonly resolve: (input: {
+        readonly request: Request;
+        readonly session: unknown | null;
+    }) => MaybePromise<ResolvedClientIdentity>;
+}
+//# sourceMappingURL=client-identity.types.d.ts.map

package/dist/client-identity.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-identity.types.d.ts","sourceRoot":"","sources":["../src/client-identity.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEpF,qEAAqE;AACrE,MAAM,WAAW,sBAAuB,SAAQ,sBAAsB;IACpE,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED,oEAAoE;AACpE,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;AAE5F,oEAAoE;AACpE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE;QACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;KAClC,KAAK,YAAY,CAAC,sBAAsB,CAAC,CAAC;CAC5C"}

package/dist/client-identity.types.js

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

package/dist/client-identity.types.js.map

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

package/dist/control-plane.d.ts

@@ -1,2 +1,6 @@
+/** Match the reserved RELKIT control-plane path and its descendants.
+ * @param path - Request path or issue location.
+ * @returns Whether the path equals /_relkit or begins with /_relkit/.
+ */
 export declare function isRelkitControlPlanePath(path: string): boolean;
 //# sourceMappingURL=control-plane.d.ts.map

package/dist/control-plane.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"control-plane.d.ts","sourceRoot":"","sources":["../src/control-plane.ts"],"names":[],"mappings":"AAAA,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D"}
+{"version":3,"file":"control-plane.d.ts","sourceRoot":"","sources":["../src/control-plane.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D"}

package/dist/control-plane.js

@@ -1,3 +1,7 @@
+/** Match the reserved RELKIT control-plane path and its descendants.
+ * @param path - Request path or issue location.
+ * @returns Whether the path equals /_relkit or begins with /_relkit/.
+ */
 export function isRelkitControlPlanePath(path) {
     return path === "/_relkit" || path.startsWith("/_relkit/");
 }

package/dist/control-plane.js.map

@@ -1 +1 @@
-{"version":3,"file":"control-plane.js","sourceRoot":"","sources":["../src/control-plane.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAO,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"control-plane.js","sourceRoot":"","sources":["../src/control-plane.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAO,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAC7D,CAAC"}

package/dist/create-app.d.ts

@@ -1,24 +1,15 @@
 import { Hono } from "hono";
-import type { MiddlewareHandler } from "hono";
-import { type RouteMaterializationOptions } from "./materialize-routes.js";
-import { FRAMEWORK_MIDDLEWARE_ORDER, type FrameworkMiddleware, type HttpMiddlewareOptions } from "./middleware.js";
-import { type InternalEndpointOptions } from "./internal-endpoints.js";
-import { type ApiDocsOptions } from "./api-docs.js";
-import { type ClientContractEndpointOptions } from "./client-contract.js";
-import type { McpOptions } from "./mcp.js";
-import { type ClientIdentityRuntime } from "./client-identity.js";
-export type FrameworkMiddlewareInput = Partial<Record<(typeof FRAMEWORK_MIDDLEWARE_ORDER)[number], MiddlewareHandler>> | readonly FrameworkMiddleware[];
-export interface CreateAppOptions extends RouteMaterializationOptions {
-    readonly frameworkMiddleware?: FrameworkMiddlewareInput;
-    readonly middleware?: HttpMiddlewareOptions;
-    readonly internalEndpoints?: InternalEndpointOptions;
-    readonly apiDocs?: ApiDocsOptions;
-    readonly clientContract?: ClientContractEndpointOptions;
-    readonly clientIdentity?: ClientIdentityRuntime;
-    readonly mcp?: McpOptions;
-}
-/** Creates the HTTP application from the already verified registration plan. */
+import type { CreateAppOptions, FrameworkMiddlewareInput } from "./create-app.types.js";
+export type { CreateAppOptions, FrameworkMiddlewareInput } from "./create-app.types.js";
+/** Creates the HTTP application from the already verified registration plan.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns The synchronously constructed Hono application; request work remains lazy.
+ */
 export declare function createApp(options: CreateAppOptions): Hono;
-/** Installs supplied framework middleware in the fixed v3 order. */
+/** Installs supplied framework middleware in the fixed v3 order.
+ * @param app - Hono application receiving the configured endpoints or middleware.
+ * @param input - Submitted operation input; validation and authorization occur before effects are admitted.
+ * @returns Nothing; the requested update is applied to the owned state.
+ */
 export declare function installFrameworkMiddleware(app: Hono, input: FrameworkMiddlewareInput | undefined): void;
 //# sourceMappingURL=create-app.d.ts.map

package/dist/create-app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-app.d.ts","sourceRoot":"","sources":["../src/create-app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,EAGL,KAAK,2BAA2B,EACjC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,0BAA0B,EAC1B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAiC,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAKjG,MAAM,MAAM,wBAAwB,GAChC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC,CAAC,GAC/E,SAAS,mBAAmB,EAAE,CAAC;AAEnC,MAAM,WAAW,gBAAiB,SAAQ,2BAA2B;IACnE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,wBAAwB,CAAC;IACxD,QAAQ,CAAC,UAAU,CAAC,EAAE,qBAAqB,CAAC;IAC5C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,6BAA6B,CAAC;IACxD,QAAQ,CAAC,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAChD,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC;CAC3B;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAkCzD;AAqBD,oEAAoE;AACpE,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,IAAI,EACT,KAAK,EAAE,wBAAwB,GAAG,SAAS,GAC1C,IAAI,CAON"}
+{"version":3,"file":"create-app.d.ts","sourceRoot":"","sources":["../src/create-app.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAM5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAMxF,YAAY,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAExF;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAmCzD;AAyBD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,IAAI,EACT,KAAK,EAAE,wBAAwB,GAAG,SAAS,GAC1C,IAAI,CAON"}

package/dist/create-app.js

@@ -1,17 +1,22 @@
 import { Hono } from "hono";
-import { assertHttpManifest, materializeRoutes, } from "./materialize-routes.js";
-import { createFrameworkMiddleware, FRAMEWORK_MIDDLEWARE_ORDER, } from "./middleware.js";
-import { graphSnapshot, installInternalEndpoints, } from "./internal-endpoints.js";
+import { installAgentInspectorEndpoints } from "./agent-inspector.js";
+import { installAgentProtocolEndpoints } from "./agent-protocol.js";
 import { installApiDocs } from "./api-docs.js";
-import { installClientContractEndpoint, } from "./client-contract.js";
+import { installClientContractEndpoint } from "./client-contract.js";
 import { installClientIdentityEndpoint } from "./client-identity.js";
+import { installHttpLogging } from "./http-logging.js";
+import { graphSnapshot, installInternalEndpoints } from "./internal-endpoints.js";
+import { assertHttpManifest, materializeRoutes } from "./materialize-routes.js";
+import { createFrameworkMiddleware, FRAMEWORK_MIDDLEWARE_ORDER } from "./middleware.js";
 import { installTransportSecurity } from "./transport-security.js";
-import { installAgentProtocolEndpoints } from "./agent-protocol.js";
-import { installAgentInspectorEndpoints } from "./agent-inspector.js";
-/** Creates the HTTP application from the already verified registration plan. */
+/** Creates the HTTP application from the already verified registration plan.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns The synchronously constructed Hono application; request work remains lazy.
+ */
 export function createApp(options) {
     assertHttpManifest(options);
     const app = new Hono();
+    installHttpLogging(app, options);
     const middlewareOptions = {
         ...(options.middleware ?? {}),
         graphHash: options.plan.graphHash,
@@ -40,6 +45,10 @@ export function createApp(options) {
     });
     return app;
 }
+/** Resolves API-document options from the application configuration.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns API-doc settings with explicit options overriding internal-endpoint defaults.
+ */
 function apiDocsOptions(options) {
     const docs = options.apiDocs ?? {};
     const internal = options.internalEndpoints ?? {};
@@ -58,7 +67,11 @@ function apiDocsOptions(options) {
                 : { authorize: internal.authorize }),
     };
 }
-/** Installs supplied framework middleware in the fixed v3 order. */
+/** Installs supplied framework middleware in the fixed v3 order.
+ * @param app - Hono application receiving the configured endpoints or middleware.
+ * @param input - Submitted operation input; validation and authorization occur before effects are admitted.
+ * @returns Nothing; the requested update is applied to the owned state.
+ */
 export function installFrameworkMiddleware(app, input) {
     if (input === undefined)
         return;
@@ -69,6 +82,10 @@ export function installFrameworkMiddleware(app, input) {
             app.use("*", handler);
     }
 }
+/** Normalizes optional middleware configuration into an ordered list.
+ * @param input - Submitted operation input; validation and authorization occur before effects are admitted.
+ * @returns A map of unique, recognized framework middleware names to their handlers.
+ */
 function normalizeFrameworkMiddleware(input) {
     const result = new Map();
     const entries = Array.isArray(input)

package/dist/create-app.js.map

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

package/dist/create-app.types.d.ts

@@ -0,0 +1,21 @@
+import type { MiddlewareHandler } from "hono";
+import type { RouteMaterializationOptions } from "./materialize-routes.js";
+import type { FRAMEWORK_MIDDLEWARE_ORDER, FrameworkMiddleware, HttpMiddlewareOptions } from "./middleware.js";
+import type { InternalEndpointOptions } from "./internal-endpoints.js";
+import type { ApiDocsOptions } from "./api-docs.js";
+import type { ClientContractEndpointOptions } from "./client-contract.js";
+import type { McpOptions } from "./mcp.js";
+import type { ClientIdentityRuntime } from "./client-identity.js";
+/** Public framework middleware input validated before domain admission. */
+export type FrameworkMiddlewareInput = Partial<Record<(typeof FRAMEWORK_MIDDLEWARE_ORDER)[number], MiddlewareHandler>> | readonly FrameworkMiddleware[];
+/** create app options configuring dependencies, callbacks and runtime policy. */
+export interface CreateAppOptions extends RouteMaterializationOptions {
+    readonly frameworkMiddleware?: FrameworkMiddlewareInput;
+    readonly middleware?: HttpMiddlewareOptions;
+    readonly internalEndpoints?: InternalEndpointOptions;
+    readonly apiDocs?: ApiDocsOptions;
+    readonly clientContract?: ClientContractEndpointOptions;
+    readonly clientIdentity?: ClientIdentityRuntime;
+    readonly mcp?: McpOptions;
+}
+//# sourceMappingURL=create-app.types.d.ts.map

package/dist/create-app.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-app.types.d.ts","sourceRoot":"","sources":["../src/create-app.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EACV,0BAA0B,EAC1B,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAElE,2EAA2E;AAC3E,MAAM,MAAM,wBAAwB,GAChC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC,CAAC,GAC/E,SAAS,mBAAmB,EAAE,CAAC;AAEnC,iFAAiF;AACjF,MAAM,WAAW,gBAAiB,SAAQ,2BAA2B;IACnE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,wBAAwB,CAAC;IACxD,QAAQ,CAAC,UAAU,CAAC,EAAE,qBAAqB,CAAC;IAC5C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,6BAA6B,CAAC;IACxD,QAAQ,CAAC,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAChD,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC;CAC3B"}

package/dist/create-app.types.js

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

package/dist/create-app.types.js.map

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

package/dist/http-effect.d.ts

@@ -0,0 +1,43 @@
+import { Cause, Effect, Schema, Stream } from "effect";
+declare const HttpBoundaryError_base: Schema.Class<HttpBoundaryError, Schema.TaggedStruct<"HttpBoundaryError", {
+    readonly operation: Schema.String;
+    readonly cause: Schema.Unknown;
+}>, Cause.YieldableError>;
+/** A recoverable failure at a native HTTP integration boundary. */
+export declare class HttpBoundaryError extends HttpBoundaryError_base {
+}
+/** Suspend a native integration until its owning Effect executes.
+ * @typeParam A - Native integration success value.
+ * @param operation - Bounded declaration-owned operation name.
+ * @param execute - Native integration; receives the owning fiber's abort signal.
+ * @returns A lazy effect retaining the original failure for compatibility adapters.
+ */
+export declare function httpBoundary<A>(operation: string, execute: (signal: AbortSignal) => PromiseLike<A>): Effect.Effect<A, HttpBoundaryError>;
+/** Observe a complete HTTP domain operation independently of its transport adapter.
+ * @typeParam A - Operation success value.
+ * @typeParam E - Recoverable operation failure.
+ * @typeParam R - Services required by the operation.
+ * @param operation - Bounded declaration-owned operation name.
+ * @param effect - Lazy domain workflow.
+ * @returns The workflow with shared execution instrumentation.
+ */
+export declare function observeHttp<A, E, R>(operation: string, effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R>;
+/** Execute an HTTP compatibility boundary while retaining existing thrown errors.
+ * @typeParam A - Successful public result.
+ * @typeParam E - Internal recoverable failure.
+ * @param effect - Fully provided operation.
+ * @param signal - Optional request cancellation authority.
+ * @returns A promise resolving the operation result or rejecting with the native cause.
+ * @remarks Only transport/compatibility adapters call this function; services compose Effects.
+ */
+export declare function runHttp<A, E>(effect: Effect.Effect<A, E>, signal?: AbortSignal): Promise<A>;
+/** Adapts an Effect stream at the framework boundary and captures the request's services.
+ * @typeParam A - Stream element delivered to the transport.
+ * @typeParam E - Recoverable stream failure.
+ * @param stream - Lazy stream whose resources remain owned until return, failure or EOF.
+ * @returns An async iterable preserving native public errors and request logger context.
+ * @remarks Each iterator acquires its own scope; returning closes owned upstream resources.
+ */
+export declare function httpIterable<A, E>(stream: Stream.Stream<A, E>): AsyncIterableIterator<A>;
+export {};
+//# sourceMappingURL=http-effect.d.ts.map

package/dist/http-effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-effect.d.ts","sourceRoot":"","sources":["../src/http-effect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAQ,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;AAI7D,mEAAmE;AACnE,qBAAa,iBAAkB,SAAQ,sBAGtC;CAAG;AAEJ;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,WAAW,CAAC,CAAC,CAAC,GAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAOrC;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,0BAErF;AAED;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CASjG;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAkBxF"}

package/dist/http-effect.js

@@ -0,0 +1,67 @@
+import { Cause, Effect, Exit, Schema, Stream } from "effect";
+import { observeExecution, withNativeEffectContext } from "@relkit/runtime-effect";
+import { currentHttpContext } from "./http-logging.js";
+/** A recoverable failure at a native HTTP integration boundary. */
+export class HttpBoundaryError extends Schema.TaggedError()("HttpBoundaryError", { operation: Schema.String, cause: Schema.Unknown }) {
+}
+/** Suspend a native integration until its owning Effect executes.
+ * @typeParam A - Native integration success value.
+ * @param operation - Bounded declaration-owned operation name.
+ * @param execute - Native integration; receives the owning fiber's abort signal.
+ * @returns A lazy effect retaining the original failure for compatibility adapters.
+ */
+export function httpBoundary(operation, execute) {
+    return Effect.withFiber((fiber) => Effect.tryPromise({
+        try: (signal) => withNativeEffectContext(fiber.context, () => execute(signal)),
+        catch: (cause) => new HttpBoundaryError({ operation, cause }),
+    }));
+}
+/** Observe a complete HTTP domain operation independently of its transport adapter.
+ * @typeParam A - Operation success value.
+ * @typeParam E - Recoverable operation failure.
+ * @typeParam R - Services required by the operation.
+ * @param operation - Bounded declaration-owned operation name.
+ * @param effect - Lazy domain workflow.
+ * @returns The workflow with shared execution instrumentation.
+ */
+export function observeHttp(operation, effect) {
+    return observeExecution("http", operation, effect);
+}
+/** Execute an HTTP compatibility boundary while retaining existing thrown errors.
+ * @typeParam A - Successful public result.
+ * @typeParam E - Internal recoverable failure.
+ * @param effect - Fully provided operation.
+ * @param signal - Optional request cancellation authority.
+ * @returns A promise resolving the operation result or rejecting with the native cause.
+ * @remarks Only transport/compatibility adapters call this function; services compose Effects.
+ */
+export async function runHttp(effect, signal) {
+    const configured = Effect.provide(effect, currentHttpContext());
+    const exit = await Effect.runPromiseExit(configured, signal === undefined ? undefined : { signal });
+    if (Exit.isSuccess(exit))
+        return exit.value;
+    const cause = Cause.squash(exit.cause);
+    throw cause instanceof HttpBoundaryError ? cause.cause : cause;
+}
+/** Adapts an Effect stream at the framework boundary and captures the request's services.
+ * @typeParam A - Stream element delivered to the transport.
+ * @typeParam E - Recoverable stream failure.
+ * @param stream - Lazy stream whose resources remain owned until return, failure or EOF.
+ * @returns An async iterable preserving native public errors and request logger context.
+ * @remarks Each iterator acquires its own scope; returning closes owned upstream resources.
+ */
+export function httpIterable(stream) {
+    const iterable = Stream.toAsyncIterable(stream.pipe(Stream.mapError((error) => (error instanceof HttpBoundaryError ? error.cause : error)), Stream.provide(currentHttpContext())));
+    // oRPC detects next/return as well as the symbol. Delegate return immediately:
+    // async-generator delegation would queue it behind a blocked native next call.
+    const iterator = iterable[Symbol.asyncIterator]();
+    return {
+        next: (value) => iterator.next(value),
+        return: (value) => iterator.return?.(value) ?? Promise.resolve({ done: true, value }),
+        throw: (error) => iterator.throw?.(error) ?? Promise.reject(error),
+        [Symbol.asyncIterator]() {
+            return this;
+        },
+    };
+}
+//# sourceMappingURL=http-effect.js.map

package/dist/http-effect.js.map

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