@relkit/runtime-hono 0.5.3 → 0.5.5

package/dist/http-stream-observation.js

@@ -0,0 +1,15 @@
+import { observeExecutionStream } from "@relkit/runtime-effect";
+/** Observes one stream from its first pull through EOF, failure or early return.
+ * @typeParam A - Public stream element.
+ * @typeParam E - Recoverable stream failure.
+ * @typeParam R - Services needed by the stream.
+ * @param operation - Bounded domain operation name.
+ * @param stream - Lazy stream retaining its original element and failure contract.
+ * @returns A stream with one shared lifetime observation and joined observer finalization.
+ * @remarks A scoped waiter lets the shared operation instrumentation span all pulls.
+ * Early return is interruption, while a naturally drained stream reports success.
+ */
+export function observeHttpStream(operation, stream) {
+    return observeExecutionStream("http", operation, stream);
+}
+//# sourceMappingURL=http-stream-observation.js.map

package/dist/http-stream-observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-stream-observation.js","sourceRoot":"","sources":["../src/http-stream-observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAGhE;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAAiB,EACjB,MAA8B;IAE9B,OAAO,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC"}

package/dist/http-validation.d.ts

@@ -0,0 +1,12 @@
+import { Effect } from "effect";
+import { HttpBoundaryError } from "./http-effect.js";
+/** Adapts an existing public input validator into the typed HTTP failure channel.
+ * @typeParam A - Validated value returned by the existing validator.
+ * @param operation - Bounded validation operation name.
+ * @param validate - Public input validator whose documented exceptions are expected failures.
+ * @returns A lazy validation effect retaining the original public exception as its cause.
+ * @remarks Use only for known boundary validators. Internal calculations use Effect.sync so
+ * programmer exceptions remain defects.
+ */
+export declare function httpValidation<A>(operation: string, validate: () => A): Effect.Effect<A, HttpBoundaryError, never>;
+//# sourceMappingURL=http-validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http-validation.d.ts","sourceRoot":"","sources":["../src/http-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,8CAKrE"}

package/dist/http-validation.js

@@ -0,0 +1,17 @@
+import { Effect } from "effect";
+import { HttpBoundaryError } from "./http-effect.js";
+/** Adapts an existing public input validator into the typed HTTP failure channel.
+ * @typeParam A - Validated value returned by the existing validator.
+ * @param operation - Bounded validation operation name.
+ * @param validate - Public input validator whose documented exceptions are expected failures.
+ * @returns A lazy validation effect retaining the original public exception as its cause.
+ * @remarks Use only for known boundary validators. Internal calculations use Effect.sync so
+ * programmer exceptions remain defects.
+ */
+export function httpValidation(operation, validate) {
+    return Effect.try({
+        try: validate,
+        catch: (cause) => new HttpBoundaryError({ operation, cause }),
+    });
+}
+//# sourceMappingURL=http-validation.js.map

package/dist/http-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-validation.js","sourceRoot":"","sources":["../src/http-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAI,SAAiB,EAAE,QAAiB;IACpE,OAAO,MAAM,CAAC,GAAG,CAAC;QAChB,GAAG,EAAE,QAAQ;QACb,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,iBAAiB,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;KAC9D,CAAC,CAAC;AACL,CAAC"}

package/dist/internal-endpoint-paths.d.ts

@@ -1,4 +1,7 @@
+/** Protocol discriminator included in inspector responses and SSE events. */
 export declare const INTERNAL_ENDPOINT_PROTOCOL: "relkit.inspector";
+/** Inspector response version shared with the contracts package. */
 export declare const INTERNAL_ENDPOINT_VERSION: 1;
+/** Reserved inspector routes installed by the runtime. */
 export declare const INTERNAL_ENDPOINT_PATHS: readonly ["/_relkit/v1/health/live", "/_relkit/v1/health/ready", "/_relkit/v1/graph", "/_relkit/v1/requests", "/_relkit/v1/logs", "/_relkit/v1/traces", "/_relkit/v1/stream", "/_relkit/v1/diagnostics", "/_relkit/v1/agents/:agentId/workflow", "/_relkit/v1/runtime/agents/:agentId/executions"];
 //# sourceMappingURL=internal-endpoint-paths.d.ts.map

package/dist/internal-endpoint-paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal-endpoint-paths.d.ts","sourceRoot":"","sources":["../src/internal-endpoint-paths.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,0BAA0B,EAAG,kBAA2B,CAAC;AACtE,eAAO,MAAM,yBAAyB,GAAc,CAAC;AACrD,eAAO,MAAM,uBAAuB,oSAWzB,CAAC"}
+{"version":3,"file":"internal-endpoint-paths.d.ts","sourceRoot":"","sources":["../src/internal-endpoint-paths.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,eAAO,MAAM,0BAA0B,EAAG,kBAA2B,CAAC;AACtE,oEAAoE;AACpE,eAAO,MAAM,yBAAyB,GAAc,CAAC;AACrD,0DAA0D;AAC1D,eAAO,MAAM,uBAAuB,oSAWzB,CAAC"}

package/dist/internal-endpoint-paths.js

@@ -1,6 +1,9 @@
 import { API_BASE_PATH, API_VERSION } from "@relkit/contracts";
+/** Protocol discriminator included in inspector responses and SSE events. */
 export const INTERNAL_ENDPOINT_PROTOCOL = "relkit.inspector";
+/** Inspector response version shared with the contracts package. */
 export const INTERNAL_ENDPOINT_VERSION = API_VERSION;
+/** Reserved inspector routes installed by the runtime. */
 export const INTERNAL_ENDPOINT_PATHS = Object.freeze([
     `${API_BASE_PATH}/health/live`,
     `${API_BASE_PATH}/health/ready`,

package/dist/internal-endpoint-paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal-endpoint-paths.js","sourceRoot":"","sources":["../src/internal-endpoint-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE/D,MAAM,CAAC,MAAM,0BAA0B,GAAG,kBAA2B,CAAC;AACtE,MAAM,CAAC,MAAM,yBAAyB,GAAG,WAAW,CAAC;AACrD,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC;IACnD,GAAG,aAAa,cAAc;IAC9B,GAAG,aAAa,eAAe;IAC/B,GAAG,aAAa,QAAQ;IACxB,GAAG,aAAa,WAAW;IAC3B,GAAG,aAAa,OAAO;IACvB,GAAG,aAAa,SAAS;IACzB,GAAG,aAAa,SAAS;IACzB,GAAG,aAAa,cAAc;IAC9B,GAAG,aAAa,2BAA2B;IAC3C,GAAG,aAAa,qCAAqC;CAC7C,CAAC,CAAC"}
+{"version":3,"file":"internal-endpoint-paths.js","sourceRoot":"","sources":["../src/internal-endpoint-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE/D,6EAA6E;AAC7E,MAAM,CAAC,MAAM,0BAA0B,GAAG,kBAA2B,CAAC;AACtE,oEAAoE;AACpE,MAAM,CAAC,MAAM,yBAAyB,GAAG,WAAW,CAAC;AACrD,0DAA0D;AAC1D,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC;IACnD,GAAG,aAAa,cAAc;IAC9B,GAAG,aAAa,eAAe;IAC/B,GAAG,aAAa,QAAQ;IACxB,GAAG,aAAa,WAAW;IAC3B,GAAG,aAAa,OAAO;IACvB,GAAG,aAAa,SAAS;IACzB,GAAG,aAAa,SAAS;IACzB,GAAG,aAAa,cAAc;IAC9B,GAAG,aAAa,2BAA2B;IAC3C,GAAG,aAAa,qCAAqC;CAC7C,CAAC,CAAC"}

package/dist/internal-endpoint-query.d.ts

@@ -0,0 +1,18 @@
+import type { InternalPage, InternalQuery } from "./internal-endpoints.js";
+/** Invalid inspector pagination or time-filter input. */
+export declare class InternalQueryError extends TypeError {
+    /** Create the stable public invalid-query error. */
+    constructor();
+}
+/** Recognize the internal endpoint's public invalid-query error.
+ * @param value - Value to validate or project.
+ * @returns Whether the value is an InternalQueryError.
+ */
+export declare function isInvalidQueryError(value: unknown): value is InternalQueryError;
+/** Filter inspector rows by fields and time range before pagination.
+ * @param page - Provider page to validate or project.
+ * @param query - Validated inspector query.
+ * @returns The sliced page with a local or provider continuation cursor.
+ */
+export declare function queryPage(page: InternalPage, query: InternalQuery): InternalPage;
+//# sourceMappingURL=internal-endpoint-query.d.ts.map

package/dist/internal-endpoint-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-endpoint-query.d.ts","sourceRoot":"","sources":["../src/internal-endpoint-query.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE3E,yDAAyD;AACzD,qBAAa,kBAAmB,SAAQ,SAAS;IAC/C,oDAAoD;;CAKrD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAE/E;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,GAAG,YAAY,CAYhF"}

package/dist/internal-endpoint-query.js

@@ -0,0 +1,88 @@
+/** Invalid inspector pagination or time-filter input. */
+export class InternalQueryError extends TypeError {
+    /** Create the stable public invalid-query error. */
+    constructor() {
+        super("Invalid internal endpoint query.");
+        this.name = "InternalQueryError";
+    }
+}
+/** Recognize the internal endpoint's public invalid-query error.
+ * @param value - Value to validate or project.
+ * @returns Whether the value is an InternalQueryError.
+ */
+export function isInvalidQueryError(value) {
+    return value instanceof InternalQueryError;
+}
+/** Filter inspector rows by fields and time range before pagination.
+ * @param page - Provider page to validate or project.
+ * @param query - Validated inspector query.
+ * @returns The sliced page with a local or provider continuation cursor.
+ */
+export function queryPage(page, query) {
+    const from = query.from === undefined ? undefined : Date.parse(query.from);
+    const to = query.to === undefined ? undefined : Date.parse(query.to);
+    if ((from !== undefined && !Number.isFinite(from)) || (to !== undefined && !Number.isFinite(to)))
+        throw new InternalQueryError();
+    if (from !== undefined && to !== undefined && from > to)
+        throw new InternalQueryError();
+    const filtered = page.items.filter((item) => matchesQuery(item, query, from, to));
+    const start = page.nextCursor === undefined ? cursorOffset(query.cursor) : 0;
+    const items = filtered.slice(start, start + query.limit);
+    const next = start + items.length < filtered.length ? String(start + items.length) : undefined;
+    const nextCursor = next ?? page.nextCursor;
+    return { items, ...(nextCursor === undefined ? {} : { nextCursor }) };
+}
+/** Apply exact field, severity, request and inclusive time filters.
+ * @param item - Candidate JSON row.
+ * @param query - Validated inspector query.
+ * @param from - Inclusive lower timestamp bound.
+ * @param to - Inclusive upper timestamp bound.
+ * @returns Whether the row satisfies every requested filter.
+ */
+function matchesQuery(item, query, from, to) {
+    if (!isRecord(item))
+        return Object.keys(query).every((key) => key === "limit" || key === "cursor");
+    const timestamp = [item.timestamp, item.startedAt, item.occurredAt, item.completedAt].find((value) => typeof value === "string");
+    const time = typeof timestamp === "string" ? Date.parse(timestamp) : Number.NaN;
+    return (exact(item, query.routeId, "routeId") &&
+        exact(item, query.functionId, "functionId") &&
+        exact(item, query.outcome, "outcome") &&
+        exact(item, query.traceId, "traceId") &&
+        (query.requestId === undefined ||
+            item.requestId === query.requestId ||
+            item.correlationId === query.requestId) &&
+        (query.severity === undefined ||
+            item.level === query.severity ||
+            item.severity === query.severity) &&
+        (from === undefined || (Number.isFinite(time) && time >= from)) &&
+        (to === undefined || (Number.isFinite(time) && time <= to)));
+}
+/** Apply an optional exact-match constraint to a JSON field.
+ * @param item - Candidate JSON row.
+ * @param value - Value to validate or project.
+ * @param key - Property or profile key to inspect.
+ * @returns True when no constraint is set or the field equals it.
+ */
+function exact(item, value, key) {
+    return value === undefined || item[key] === value;
+}
+/** Parse a nonnegative integer offset for local inspector pagination.
+ * @param value - Value to validate or project.
+ * @returns The offset, defaulting to zero; invalid values throw.
+ */
+function cursorOffset(value) {
+    if (value === undefined)
+        return 0;
+    const offset = Number(value);
+    if (!Number.isSafeInteger(offset) || offset < 0)
+        throw new InternalQueryError();
+    return offset;
+}
+/** Check whether a JSON value contains named fields.
+ * @param value - JSON value inspected by query matching.
+ * @returns Whether the value is a non-array object.
+ */
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=internal-endpoint-query.js.map

package/dist/internal-endpoint-query.js.map

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

package/dist/internal-endpoints-utils.d.ts

@@ -1,16 +1,51 @@
 import { type JsonValue } from "@relkit/contracts";
 import type { Context } from "hono";
 import { type InternalEndpointOptions, type InternalPage, type InternalQuery, type QuerySource, type ValueSource } from "./internal-endpoints.js";
-export declare class InternalQueryError extends TypeError {
-    constructor();
-}
-export declare function isInvalidQueryError(value: unknown): value is InternalQueryError;
+export { InternalQueryError, isInvalidQueryError } from "./internal-endpoint-query.js";
+/** Authorize an inspector request using the callback or bearer-token fallback.
+ * @param request - Incoming HTTP request.
+ * @param options - Runtime configuration and dependencies for this operation.
+ * @returns Whether the configured authorization rule accepts the request.
+ */
 export declare function isAuthorized(request: Request, options: InternalEndpointOptions): Promise<boolean>;
+/** Resolve inspector rows, apply query filters and encode a versioned page.
+ * @param source - Fixed data or a callback producing the data.
+ * @param context - Current Hono or RPC request context.
+ * @returns A JSON response containing items and any continuation cursor.
+ */
 export declare function listResponse(source: QuerySource | undefined, context: Context): Promise<Response>;
+/** Parse supported inspector filters and clamp valid page sizes to 100.
+ * @param request - Incoming HTTP request.
+ * @returns A query with a default limit of 50; invalid limits throw.
+ */
 export declare function readQuery(request: Request): InternalQuery;
+/** Resolve a fixed inspector value or a lazy value callback.
+ * @typeParam T - Value produced by the source or selected by the predicate.
+ * @param source - Fixed data or a callback producing the data.
+ * @returns The resolved value after any callback Promise settles.
+ */
 export declare function resolveValue<T>(source: ValueSource<T>): Promise<T>;
+/** Resolve a fixed inspector source or call it with a parsed query.
+ * @param source - Fixed data or a callback producing the data.
+ * @param query - Validated inspector query.
+ * @returns The source result after any callback Promise settles.
+ */
 export declare function resolveQuery(source: QuerySource | NonNullable<InternalEndpointOptions["stream"]>, query: InternalQuery): Promise<unknown>;
+/** Normalize an inspector array, page or scalar into a page shape.
+ * @param value - Value to validate or project.
+ * @returns Items and any supplied string continuation cursor.
+ */
 export declare function toPage(value: JsonValue | InternalPage): InternalPage;
+/** Encode supported inspector events as versioned SSE blocks.
+ * @param value - Value to validate or project.
+ * @returns Serialized events, or an empty string for a non-array input.
+ */
 export declare function streamBody(value: unknown): string;
+/** Encode a JSON value with the transport's required response metadata.
+ * @param value - Value to validate or project.
+ * @param status - HTTP response status.
+ * @param headers - Response or request header values.
+ * @returns The HTTP response with the supplied status and JSON content type.
+ */
 export declare function jsonResponse(value: JsonValue, status?: number, headers?: Record<string, string>): Response;
 //# sourceMappingURL=internal-endpoints-utils.d.ts.map

package/dist/internal-endpoints-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal-endpoints-utils.d.ts","sourceRoot":"","sources":["../src/internal-endpoints-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,SAAS,EAAqB,MAAM,mBAAmB,CAAC;AAClG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,EAGL,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EACjB,KAAK,aAAa,EAElB,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAEjC,qBAAa,kBAAmB,SAAQ,SAAS;;CAKhD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAE/E;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,QAAQ,CAAC,CAQnB;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAqBzD;AAED,wBAAsB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAExE;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,WAAW,GAAG,WAAW,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,EACpE,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,YAAY,GAAG,YAAY,CASpE;AAkDD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASjD;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,EAChB,MAAM,SAAM,EACZ,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACnC,QAAQ,CAaV"}
+{"version":3,"file":"internal-endpoints-utils.d.ts","sourceRoot":"","sources":["../src/internal-endpoints-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,SAAS,EAAqB,MAAM,mBAAmB,CAAC;AAClG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,OAAO,EAGL,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EACjB,KAAK,aAAa,EAElB,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEvF;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,QAAQ,CAAC,CAQnB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAqBzD;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAExE;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,WAAW,GAAG,WAAW,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,EACpE,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,YAAY,GAAG,YAAY,CASpE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASjD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,EAChB,MAAM,SAAM,EACZ,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACnC,QAAQ,CAaV"}

package/dist/internal-endpoints-utils.js

@@ -1,14 +1,12 @@
 import { canonicalJson, isJsonValue } from "@relkit/contracts";
+import { InternalQueryError, queryPage } from "./internal-endpoint-query.js";
 import { INTERNAL_ENDPOINT_PROTOCOL, INTERNAL_ENDPOINT_VERSION, } from "./internal-endpoints.js";
-export class InternalQueryError extends TypeError {
-    constructor() {
-        super("Invalid internal endpoint query.");
-        this.name = "InternalQueryError";
-    }
-}
-export function isInvalidQueryError(value) {
-    return value instanceof InternalQueryError;
-}
+export { InternalQueryError, isInvalidQueryError } from "./internal-endpoint-query.js";
+/** Authorize an inspector request using the callback or bearer-token fallback.
+ * @param request - Incoming HTTP request.
+ * @param options - Runtime configuration and dependencies for this operation.
+ * @returns Whether the configured authorization rule accepts the request.
+ */
 export async function isAuthorized(request, options) {
     if (options.authorize !== undefined) {
         try {
@@ -25,6 +23,11 @@ export async function isAuthorized(request, options) {
         ? true
         : request.headers.get("authorization") === `Bearer ${options.bearerToken}`;
 }
+/** Resolve inspector rows, apply query filters and encode a versioned page.
+ * @param source - Fixed data or a callback producing the data.
+ * @param context - Current Hono or RPC request context.
+ * @returns A JSON response containing items and any continuation cursor.
+ */
 export async function listResponse(source, context) {
     const query = readQuery(context.req.raw);
     const value = source === undefined ? [] : await resolveQuery(source, query);
@@ -34,6 +37,10 @@ export async function listResponse(source, context) {
         ...(page.nextCursor === undefined ? {} : { nextCursor: page.nextCursor }),
     });
 }
+/** Parse supported inspector filters and clamp valid page sizes to 100.
+ * @param request - Incoming HTTP request.
+ * @returns A query with a default limit of 50; invalid limits throw.
+ */
 export function readQuery(request) {
     const url = new URL(request.url);
     const rawLimit = url.searchParams.get("limit");
@@ -58,14 +65,28 @@ export function readQuery(request) {
     }
     return query;
 }
+/** Resolve a fixed inspector value or a lazy value callback.
+ * @typeParam T - Value produced by the source or selected by the predicate.
+ * @param source - Fixed data or a callback producing the data.
+ * @returns The resolved value after any callback Promise settles.
+ */
 export async function resolveValue(source) {
     return typeof source === "function" ? await source() : source;
 }
+/** Resolve a fixed inspector source or call it with a parsed query.
+ * @param source - Fixed data or a callback producing the data.
+ * @param query - Validated inspector query.
+ * @returns The source result after any callback Promise settles.
+ */
 export async function resolveQuery(source, query) {
     return typeof source === "function"
         ? await source(query)
         : source;
 }
+/** Normalize an inspector array, page or scalar into a page shape.
+ * @param value - Value to validate or project.
+ * @returns Items and any supplied string continuation cursor.
+ */
 export function toPage(value) {
     if (Array.isArray(value))
         return { items: value };
@@ -77,49 +98,10 @@ export function toPage(value) {
     }
     return { items: [value] };
 }
-function queryPage(page, query) {
-    const from = query.from === undefined ? undefined : Date.parse(query.from);
-    const to = query.to === undefined ? undefined : Date.parse(query.to);
-    if ((from !== undefined && !Number.isFinite(from)) || (to !== undefined && !Number.isFinite(to)))
-        throw new InternalQueryError();
-    if (from !== undefined && to !== undefined && from > to)
-        throw new InternalQueryError();
-    const filtered = page.items.filter((item) => matchesQuery(item, query, from, to));
-    const start = page.nextCursor === undefined ? cursorOffset(query.cursor) : 0;
-    const items = filtered.slice(start, start + query.limit);
-    const next = start + items.length < filtered.length ? String(start + items.length) : undefined;
-    const nextCursor = next ?? page.nextCursor;
-    return { items, ...(nextCursor === undefined ? {} : { nextCursor }) };
-}
-function matchesQuery(item, query, from, to) {
-    if (!isRecord(item))
-        return Object.keys(query).every((key) => key === "limit" || key === "cursor");
-    const timestamp = [item.timestamp, item.startedAt, item.occurredAt, item.completedAt].find((value) => typeof value === "string");
-    const time = typeof timestamp === "string" ? Date.parse(timestamp) : Number.NaN;
-    return (exact(item, query.routeId, "routeId") &&
-        exact(item, query.functionId, "functionId") &&
-        exact(item, query.outcome, "outcome") &&
-        exact(item, query.traceId, "traceId") &&
-        (query.requestId === undefined ||
-            item.requestId === query.requestId ||
-            item.correlationId === query.requestId) &&
-        (query.severity === undefined ||
-            item.level === query.severity ||
-            item.severity === query.severity) &&
-        (from === undefined || (Number.isFinite(time) && time >= from)) &&
-        (to === undefined || (Number.isFinite(time) && time <= to)));
-}
-function exact(item, value, key) {
-    return value === undefined || item[key] === value;
-}
-function cursorOffset(value) {
-    if (value === undefined)
-        return 0;
-    const offset = Number(value);
-    if (!Number.isSafeInteger(offset) || offset < 0)
-        throw new InternalQueryError();
-    return offset;
-}
+/** Encode supported inspector events as versioned SSE blocks.
+ * @param value - Value to validate or project.
+ * @returns Serialized events, or an empty string for a non-array input.
+ */
 export function streamBody(value) {
     if (!Array.isArray(value))
         return "";
@@ -128,6 +110,12 @@ export function streamBody(value) {
         .map((event) => `id: ${event.cursor}\nevent: ${event.type}\ndata: ${canonicalJson({ protocol: INTERNAL_ENDPOINT_PROTOCOL, version: INTERNAL_ENDPOINT_VERSION, ...event })}\n\n`)
         .join("");
 }
+/** Encode a JSON value with the transport's required response metadata.
+ * @param value - Value to validate or project.
+ * @param status - HTTP response status.
+ * @param headers - Response or request header values.
+ * @returns The HTTP response with the supplied status and JSON content type.
+ */
 export function jsonResponse(value, status = 200, headers = {}) {
     const payload = isRecord(value)
         ? { ...value, protocol: INTERNAL_ENDPOINT_PROTOCOL, version: INTERNAL_ENDPOINT_VERSION }
@@ -142,12 +130,20 @@ export function jsonResponse(value, status = 200, headers = {}) {
         },
     });
 }
+/** Recognize inspector events with a string cursor, type and JSON payload.
+ * @param value - Value to validate or project.
+ * @returns Whether the value can be serialized as an inspector stream event.
+ */
 function isStreamEvent(value) {
     return (isRecord(value) &&
         typeof value.cursor === "string" &&
         typeof value.type === "string" &&
         isJsonValue(value.data));
 }
+/** 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/internal-endpoints-utils.js.map

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

package/dist/internal-endpoints.d.ts

@@ -1,56 +1,21 @@
 import * as contracts from "@relkit/contracts";
 import type { RegistrationPlan } from "@relkit/graph";
 import type { Hono } from "hono";
+import type { InternalEndpointOptions } from "./internal-endpoints.types.js";
+export type { InternalEndpointMode, InternalEndpointOptions, InternalPage, InternalQuery, InternalReadiness, InternalStreamEvent, QuerySource, ValueSource, } from "./internal-endpoints.types.js";
 export { INTERNAL_ENDPOINT_PATHS, INTERNAL_ENDPOINT_PROTOCOL, INTERNAL_ENDPOINT_VERSION, } from "./internal-endpoint-paths.js";
-export type InternalEndpointMode = "development" | "test" | "production";
-export interface InternalQuery {
-    readonly cursor?: string;
-    readonly limit: number;
-    readonly from?: string;
-    readonly to?: string;
-    readonly severity?: string;
-    readonly routeId?: string;
-    readonly functionId?: string;
-    readonly outcome?: string;
-    readonly requestId?: string;
-    readonly traceId?: string;
-}
-export interface InternalPage {
-    readonly [key: string]: contracts.JsonValue;
-    readonly items: readonly contracts.JsonValue[];
-    readonly nextCursor?: string;
-}
-export interface InternalReadiness {
-    readonly ready: boolean;
-    readonly reason?: string;
-}
-export interface InternalStreamEvent {
-    readonly [key: string]: contracts.JsonValue;
-    readonly cursor: string;
-    readonly type: string;
-    readonly data: contracts.JsonValue;
-}
-export type QuerySource = contracts.JsonValue | InternalPage | ((query: InternalQuery) => contracts.MaybePromise<contracts.JsonValue | InternalPage>);
-export type ValueSource<T> = T | (() => contracts.MaybePromise<T>);
-export interface InternalEndpointOptions {
-    readonly mode?: InternalEndpointMode;
-    readonly environment?: InternalEndpointMode;
-    readonly enabled?: boolean;
-    readonly bearerToken?: string;
-    readonly authorize?: (request: Request) => contracts.MaybePromise<boolean>;
-    readonly graph?: ValueSource<contracts.JsonValue>;
-    readonly readiness?: ValueSource<InternalReadiness>;
-    readonly ready?: ValueSource<InternalReadiness>;
-    readonly requests?: QuerySource;
-    readonly logs?: QuerySource;
-    readonly traces?: QuerySource;
-    readonly diagnostics?: QuerySource;
-    readonly stream?: ValueSource<readonly InternalStreamEvent[]> | ((query: InternalQuery) => contracts.MaybePromise<readonly InternalStreamEvent[]>);
-}
 export declare class InternalEndpointConfigurationError extends TypeError {
     constructor(message: string);
 }
-/** Installs the versioned inspector stubs used before the full API package exists. */
+/** Install the versioned inspector endpoints backed by configured runtime sources.
+ * @param app - Hono application receiving the configured endpoints or middleware.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns Nothing; installs enabled, authorized inspector health, graph, query and stream endpoints.
+ */
 export declare function installInternalEndpoints(app: Hono, options?: InternalEndpointOptions): void;
+/** Builds the structural graph snapshot exposed by internal inspection.
+ * @param plan - Validated application registration plan.
+ * @returns Versioned structural graph metadata for the active registration plan.
+ */
 export declare function graphSnapshot(plan: RegistrationPlan): contracts.JsonValue;
 //# sourceMappingURL=internal-endpoints.d.ts.map

package/dist/internal-endpoints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal-endpoints.d.ts","sourceRoot":"","sources":["../src/internal-endpoints.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"internal-endpoints.d.ts","sourceRoot":"","sources":["../src/internal-endpoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,MAAM,CAAC;AAe1C,OAAO,KAAK,EAAwB,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACnG,YAAY,EACV,oBAAoB,EACpB,uBAAuB,EACvB,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,WAAW,GACZ,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,8BAA8B,CAAC;AAEtC,qBAAa,kCAAmC,SAAQ,SAAS;gBACnD,OAAO,EAAE,MAAM;CAI5B;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,GAAE,uBAA4B,GAAG,IAAI,CA8D/F;AACD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,SAAS,CAAC,SAAS,CAsBzE"}

package/dist/internal-endpoints.js

@@ -1,6 +1,6 @@
 import * as contracts from "@relkit/contracts";
-import { isAuthorized, isInvalidQueryError, jsonResponse, listResponse, readQuery, resolveQuery, resolveValue, streamBody, } from "./internal-endpoints-utils.js";
 import { INTERNAL_ENDPOINT_PROTOCOL, INTERNAL_ENDPOINT_VERSION, } from "./internal-endpoint-paths.js";
+import { isAuthorized, isInvalidQueryError, jsonResponse, listResponse, readQuery, resolveQuery, resolveValue, streamBody, } from "./internal-endpoints-utils.js";
 export { INTERNAL_ENDPOINT_PATHS, INTERNAL_ENDPOINT_PROTOCOL, INTERNAL_ENDPOINT_VERSION, } from "./internal-endpoint-paths.js";
 export class InternalEndpointConfigurationError extends TypeError {
     constructor(message) {
@@ -8,13 +8,21 @@ export class InternalEndpointConfigurationError extends TypeError {
         this.name = "InternalEndpointConfigurationError";
     }
 }
-/** Installs the versioned inspector stubs used before the full API package exists. */
+/** Install the versioned inspector endpoints backed by configured runtime sources.
+ * @param app - Hono application receiving the configured endpoints or middleware.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns Nothing; installs enabled, authorized inspector health, graph, query and stream endpoints.
+ */
 export function installInternalEndpoints(app, options = {}) {
     const mode = options.environment ?? options.mode ?? "development";
     const enabled = options.enabled ?? mode !== "production";
     validateConfiguration(mode, enabled, options);
     if (!enabled)
         return;
+    /** Protect inspector handlers and map query/native failures to stable JSON errors.
+     * @param handler - Inspector endpoint callback invoked only after authorization.
+     * @returns A handler yielding the endpoint response or a sanitized 4xx/5xx response.
+     */
     const handle = (handler) => async (context) => {
         if (!(await isAuthorized(context.req.raw, options)))
             return jsonResponse({ error: "internal-endpoint-protected" }, 401, {
@@ -50,6 +58,10 @@ export function installInternalEndpoints(app, options = {}) {
     if (options.stream !== undefined)
         app.get(`${contracts.API_BASE_PATH}/stream`, handle(async (context) => streamResponse(options.stream, context)));
 }
+/** Builds the structural graph snapshot exposed by internal inspection.
+ * @param plan - Validated application registration plan.
+ * @returns Versioned structural graph metadata for the active registration plan.
+ */
 export function graphSnapshot(plan) {
     return {
         protocol: INTERNAL_ENDPOINT_PROTOCOL,
@@ -73,6 +85,12 @@ export function graphSnapshot(plan) {
         services: plan.services ?? [],
     };
 }
+/** Checks internal endpoint exposure policy before route registration.
+ * @param mode - Configured runtime exposure or response-validation mode.
+ * @param enabled - Whether the feature is enabled by application configuration.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns Nothing for a valid exposure policy; otherwise throws the existing configuration error.
+ */
 function validateConfiguration(mode, enabled, options) {
     if (!("development" === mode || "test" === mode || "production" === mode))
         throw new InternalEndpointConfigurationError("mode must be development, test, or production.");
@@ -84,6 +102,11 @@ function validateConfiguration(mode, enabled, options) {
     if (options.bearerToken !== undefined && options.bearerToken.trim().length === 0)
         throw new InternalEndpointConfigurationError("bearerToken must not be empty.");
 }
+/** Encode the resolved inspector event batch as an SSE response.
+ * @param source - Native iterable or declared request-key source.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @returns An SSE response containing the resolved inspector event batch.
+ */
 async function streamResponse(source, context) {
     const events = source === undefined ? [] : await resolveQuery(source, readQuery(context.req.raw));
     return new Response(streamBody(events), {