@relkit/inspector-api 0.0.0

package/dist/graph-utils.js

@@ -0,0 +1,60 @@
+import { deepFreeze } from "@relkit/contracts";
+import { isRecord, pick, safeJson, safeSource } from "./shared.js";
+const GRAPH_FIELDS = `
+environment providerBindings observability defaults name type requiredIn hasDefault sensitive
+description input output errors dependencies timeoutMs concurrency generated triggerType
+targetFunctionId config method path request responses middleware transforms selector expansion
+delivery profile retry schedule idempotency version payload sensitiveFields visibility maxObjectBytes
+allowedContentTypes key value defaultTtlMs maxTtlMs sideEffect approval model toolIds limits
+generatedFunction capabilities capability adapter ownership configuration
+title tags members order ownerId ownerKind phase
+`
+    .trim()
+    .split(/\s+/);
+export function projectNode(value) {
+    if (!isRecord(value) || typeof value.kind !== "string" || typeof value.id !== "string")
+        return undefined;
+    const result = { kind: value.kind, id: value.id };
+    const source = safeSource(value.source);
+    if (source !== undefined)
+        result.source = source;
+    for (const key of GRAPH_FIELDS) {
+        if (value[key] === undefined)
+            continue;
+        const field = safeJson({ value: value[key] });
+        if (isRecord(field) && field.value !== undefined)
+            result[key] = field.value;
+    }
+    const projected = safeJson(result);
+    if (!isRecord(projected) || !isRecord(value.config))
+        return projected;
+    const request = safeConfigRequest(value.config.request);
+    if (request === undefined || !isRecord(projected.config))
+        return projected;
+    return deepFreeze({ ...projected, config: { ...projected.config, request } });
+}
+function safeConfigRequest(value) {
+    const field = safeJson({ value });
+    return isRecord(field) && field.value !== undefined ? field.value : undefined;
+}
+export function projectDescriptors(value) {
+    return toItems(value).flatMap((item) => {
+        const projected = projectNode(item);
+        return projected === undefined ? [] : [projected];
+    });
+}
+export function projectObservedEdges(value) {
+    return toItems(value).flatMap((edge) => {
+        if (!isRecord(edge) || typeof edge.from !== "string" || typeof edge.to !== "string")
+            return [];
+        return [safeJson(pick(edge, ["relationship", "kind", "from", "to"]))];
+    });
+}
+export function toItems(value) {
+    if (Array.isArray(value))
+        return value;
+    if (isRecord(value) && Array.isArray(value.items))
+        return value.items;
+    return value === undefined || value === null ? [] : [value];
+}
+//# sourceMappingURL=graph-utils.js.map

package/dist/graph-utils.js.map

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

package/dist/graph.d.ts

@@ -0,0 +1,14 @@
+import { type JsonValue } from "@relkit/contracts";
+import { type ResolvedActiveGeneration } from "./shared.js";
+export declare const GRAPH_COLLECTIONS: readonly ["descriptors", "routes", "middlewares", "functions", "jobs", "events", "buckets", "cache", "tools", "agents", "services", "providers"];
+export type GraphCollection = (typeof GRAPH_COLLECTIONS)[number];
+export declare class InspectorGraphError extends Error {
+    readonly code: "RELKIT_INSPECTOR_GRAPH_UNAVAILABLE" | "RELKIT_INSPECTOR_NOT_FOUND";
+    readonly status: 404 | 503;
+    constructor(code: "RELKIT_INSPECTOR_GRAPH_UNAVAILABLE" | "RELKIT_INSPECTOR_NOT_FOUND", status: 404 | 503);
+}
+export declare function graphSnapshot(generation: ResolvedActiveGeneration): Promise<JsonValue>;
+export declare function graphList(generation: ResolvedActiveGeneration, collection: GraphCollection, request: Request): Promise<JsonValue>;
+export declare function graphDetail(generation: ResolvedActiveGeneration, collection: GraphCollection, id: string): JsonValue;
+export declare function sourceDetail(generation: ResolvedActiveGeneration, id: string): JsonValue;
+//# sourceMappingURL=graph.d.ts.map

package/dist/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAML,KAAK,wBAAwB,EAC9B,MAAM,aAAa,CAAC;AAGrB,eAAO,MAAM,iBAAiB,kJAanB,CAAC;AACZ,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,qBAAa,mBAAoB,SAAQ,KAAK;IAE1C,QAAQ,CAAC,IAAI,EAAE,oCAAoC,GAAG,4BAA4B;IAClF,QAAQ,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG;gBADjB,IAAI,EAAE,oCAAoC,GAAG,4BAA4B,EACzE,MAAM,EAAE,GAAG,GAAG,GAAG;CAK7B;AAED,wBAAsB,aAAa,CAAC,UAAU,EAAE,wBAAwB,GAAG,OAAO,CAAC,SAAS,CAAC,CAU5F;AAED,wBAAsB,SAAS,CAC7B,UAAU,EAAE,wBAAwB,EACpC,UAAU,EAAE,eAAe,EAC3B,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,SAAS,CAAC,CAOpB;AAED,wBAAgB,WAAW,CACzB,UAAU,EAAE,wBAAwB,EACpC,UAAU,EAAE,eAAe,EAC3B,EAAE,EAAE,MAAM,GACT,SAAS,CAmBX;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,wBAAwB,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAOxF"}

package/dist/graph.js

@@ -0,0 +1,120 @@
+import { GRAPH_VERSION } from "@relkit/contracts";
+import { identity, isRecord, page, pick, safeJson, } from "./shared.js";
+import { projectDescriptors, projectNode, projectObservedEdges } from "./graph-utils.js";
+export const GRAPH_COLLECTIONS = Object.freeze([
+    "descriptors",
+    "routes",
+    "middlewares",
+    "functions",
+    "jobs",
+    "events",
+    "buckets",
+    "cache",
+    "tools",
+    "agents",
+    "services",
+    "providers",
+]);
+export class InspectorGraphError extends Error {
+    code;
+    status;
+    constructor(code, status) {
+        super(code);
+        this.code = code;
+        this.status = status;
+        this.name = "InspectorGraphError";
+    }
+}
+export async function graphSnapshot(generation) {
+    const data = graphData(generation.graph);
+    if (data === undefined)
+        throw new InspectorGraphError("RELKIT_INSPECTOR_GRAPH_UNAVAILABLE", 503);
+    const observedEdges = projectObservedEdges(generation.observedEdges);
+    return {
+        ...identity(generation),
+        graph: { ...data, ...(observedEdges.length === 0 ? {} : { observedEdges }) },
+        ...data,
+        ...(observedEdges.length === 0 ? {} : { observedEdges }),
+    };
+}
+export async function graphList(generation, collection, request) {
+    const items = collection === "descriptors" && generation.descriptors !== undefined
+        ? projectDescriptors(generation.descriptors)
+        : graphItems(generation.graph, collection);
+    if (items === undefined)
+        throw new InspectorGraphError("RELKIT_INSPECTOR_GRAPH_UNAVAILABLE", 503);
+    return { ...identity(generation), ...page(items, request) };
+}
+export function graphDetail(generation, collection, id) {
+    const items = collection === "descriptors" && generation.descriptors !== undefined
+        ? projectDescriptors(generation.descriptors)
+        : graphItems(generation.graph, collection);
+    const item = items?.find((value) => isRecord(value) && value.id === id);
+    if (item === undefined)
+        throw new InspectorGraphError("RELKIT_INSPECTOR_NOT_FOUND", 404);
+    const data = graphData(generation.graph);
+    const declaredEdges = data?.edges.filter((edge) => edgeTouches(edge, id));
+    const observedEdges = projectObservedEdges(generation.observedEdges).filter((edge) => edgeTouches(edge, id));
+    return {
+        ...identity(generation),
+        descriptor: item,
+        node: item,
+        ...(declaredEdges === undefined ? {} : { declaredEdges }),
+        ...(observedEdges.length === 0 ? {} : { observedEdges }),
+    };
+}
+export function sourceDetail(generation, id) {
+    const node = graphItems(generation.graph, "descriptors")?.find((value) => isRecord(value) && value.id === id);
+    if (!isRecord(node) || node.source === undefined)
+        throw new InspectorGraphError("RELKIT_INSPECTOR_NOT_FOUND", 404);
+    return { ...identity(generation), id, source: node.source };
+}
+function graphData(value) {
+    if (!isRecord(value) || !Array.isArray(value.nodes) || !Array.isArray(value.edges))
+        return undefined;
+    const nodes = value.nodes.flatMap((node) => {
+        const projected = projectNode(node);
+        return projected === undefined ? [] : [projected];
+    });
+    const edges = value.edges.flatMap((edge) => {
+        if (!isRecord(edge) ||
+            typeof edge.kind !== "string" ||
+            typeof edge.from !== "string" ||
+            typeof edge.to !== "string")
+            return [];
+        return [
+            safeJson(pick(edge, ["kind", "from", "to", "role", "member", "order", "match", "phase"])),
+        ];
+    });
+    return {
+        contractVersion: typeof value.contractVersion === "number" && Number.isSafeInteger(value.contractVersion)
+            ? value.contractVersion
+            : GRAPH_VERSION,
+        ...(typeof value.appId === "string" ? { appId: value.appId } : {}),
+        nodes,
+        edges,
+    };
+}
+function graphItems(value, collection) {
+    const data = graphData(value);
+    if (data === undefined)
+        return undefined;
+    if (collection === "descriptors")
+        return data.nodes;
+    return data.nodes.filter((node) => belongs(node, collection));
+}
+function belongs(node, collection) {
+    if (!isRecord(node))
+        return false;
+    if (collection === "routes")
+        return node.kind === "trigger" && isRecord(node.config) && node.config.method !== undefined;
+    if (collection === "env")
+        return node.kind === "env";
+    if (collection === "providers")
+        return node.kind === "provider";
+    return node.kind === (collection === "cache" ? "cache" : collection.slice(0, -1));
+}
+function edgeTouches(edge, id) {
+    return isRecord(edge) && (edge.from === id || edge.to === id);
+}
+//# sourceMappingURL=graph.js.map

package/dist/graph.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./observability.js";
+export * from "./shared.js";
+export * from "./generation-types.js";
+export * from "./router.js";
+export * from "./graph.js";
+export * from "./runtime.js";
+export * from "./events-runtime.js";
+export * from "./actions.js";
+export * from "./resource-explorer.js";
+export { installInspectorEndpoints as installInspectorApi, installInspectorEndpoints as installInspectorRouter, } from "./router.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,OAAO,EACL,yBAAyB,IAAI,mBAAmB,EAChD,yBAAyB,IAAI,sBAAsB,GACpD,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export * from "./observability.js";
+export * from "./shared.js";
+export * from "./generation-types.js";
+export * from "./router.js";
+export * from "./graph.js";
+export * from "./runtime.js";
+export * from "./events-runtime.js";
+export * from "./actions.js";
+export * from "./resource-explorer.js";
+export { installInspectorEndpoints as installInspectorApi, installInspectorEndpoints as installInspectorRouter, } from "./router.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,OAAO,EACL,yBAAyB,IAAI,mBAAmB,EAChD,yBAAyB,IAAI,sBAAsB,GACpD,MAAM,aAAa,CAAC"}

package/dist/observability-utils.d.ts

@@ -0,0 +1,4 @@
+import { type ObservabilityQueryRequest, type ObservabilityStream } from "@relkit/observability";
+export declare function readObservabilityQuery(request: Request): ObservabilityQueryRequest;
+export declare function streamResponse(stream: ObservabilityStream, request: Request, apiVersion: number): Response;
+//# sourceMappingURL=observability-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observability-utils.d.ts","sourceRoot":"","sources":["../src/observability-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EAKzB,MAAM,uBAAuB,CAAC;AAE/B,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,yBAAyB,CAgClF;AA2CD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,GACjB,QAAQ,CAwDV"}

package/dist/observability-utils.js

@@ -0,0 +1,150 @@
+import { canonicalJson } from "@relkit/contracts";
+import { MAX_OBSERVABILITY_QUERY_LIMIT, ObservabilityQueryError, OBSERVABILITY_STREAM_EVENT_TYPES, ObservabilityStreamError, } from "@relkit/observability";
+export function readObservabilityQuery(request) {
+    const params = new URL(request.url).searchParams;
+    const value = {};
+    for (const name of [
+        "from",
+        "to",
+        "severity",
+        "routeId",
+        "functionId",
+        "outcome",
+        "requestId",
+        "traceId",
+        "serviceId",
+        "generationId",
+        "graphHash",
+    ]) {
+        const item = params.get(name);
+        if (item !== null) {
+            if (item.length === 0)
+                throw queryError(`${name} is invalid`);
+            value[name] = item;
+        }
+    }
+    const cursor = params.get("cursor");
+    if (cursor !== null)
+        value.cursor = String(integer(cursor, "cursor"));
+    const limit = params.get("limit");
+    if (limit !== null)
+        value.limit = Math.min(integer(limit, "limit"), MAX_OBSERVABILITY_QUERY_LIMIT);
+    const protocol = params.get("protocol");
+    if (protocol !== null)
+        value.protocol = protocol;
+    const version = params.get("version");
+    if (version !== null)
+        value.version = integer(version, "version");
+    return value;
+}
+function readStreamOptions(request) {
+    const params = new URL(request.url).searchParams;
+    const cursor = params.get("cursor");
+    const afterCursor = params.get("afterCursor");
+    const lastEventId = request.headers.get("last-event-id") || undefined;
+    const effectiveCursor = cursor ?? lastEventId;
+    if (cursor !== null && lastEventId !== undefined && cursor !== lastEventId)
+        throw streamError("cursor and Last-Event-ID disagree");
+    if (effectiveCursor !== undefined)
+        integer(effectiveCursor, "cursor");
+    if (afterCursor !== null)
+        integer(afterCursor, "afterCursor");
+    const type = params.get("type");
+    if (type !== null && !OBSERVABILITY_STREAM_EVENT_TYPES.includes(type))
+        throw streamError("stream event type is invalid");
+    const overflow = params.get("overflow");
+    const backpressure = params.get("backpressure");
+    if (overflow !== null && backpressure !== null && overflow !== backpressure)
+        throw streamError("overflow and backpressure disagree");
+    const queueSize = params.get("queueSize");
+    const result = {};
+    if (effectiveCursor !== undefined)
+        result.cursor = effectiveCursor;
+    if (afterCursor !== null)
+        result.afterCursor = afterCursor;
+    if (queueSize !== null)
+        result.queueSize = integer(queueSize, "queueSize");
+    if (overflow !== null)
+        result.overflow = overflow;
+    if (backpressure !== null)
+        result.backpressure = backpressure;
+    if (type !== null)
+        result.type = type;
+    return result;
+}
+export function streamResponse(stream, request, apiVersion) {
+    const input = readStreamOptions(request);
+    const type = input.type;
+    const subscriptionOptions = {
+        ...(input.cursor === undefined ? {} : { cursor: input.cursor }),
+        ...(input.afterCursor === undefined ? {} : { afterCursor: input.afterCursor }),
+        ...(input.queueSize === undefined ? {} : { queueSize: input.queueSize }),
+        ...(input.overflow === undefined ? {} : { overflow: input.overflow }),
+        ...(input.backpressure === undefined ? {} : { backpressure: input.backpressure }),
+    };
+    const subscription = stream.subscribe(subscriptionOptions);
+    let closed = false;
+    let connected = false;
+    const encoder = new TextEncoder();
+    const close = () => {
+        if (closed)
+            return;
+        closed = true;
+        subscription.close();
+        request.signal.removeEventListener("abort", close);
+    };
+    request.signal.addEventListener("abort", close, { once: true });
+    const body = new ReadableStream({
+        async pull(controller) {
+            try {
+                if (!connected) {
+                    connected = true;
+                    controller.enqueue(encoder.encode(": connected\n\n"));
+                    return;
+                }
+                while (!closed) {
+                    const result = await subscription.next();
+                    if (closed)
+                        return;
+                    if (result.done) {
+                        close();
+                        controller.close();
+                        return;
+                    }
+                    if (type !== undefined && result.value.type !== type)
+                        continue;
+                    controller.enqueue(encoder.encode(eventFrame(result.value)));
+                    return;
+                }
+            }
+            catch {
+                close();
+                controller.close();
+            }
+        },
+        cancel: close,
+    });
+    return new Response(body, {
+        headers: {
+            "cache-control": "no-cache, no-store",
+            connection: "keep-alive",
+            "content-type": "text/event-stream; charset=utf-8",
+            "x-relkit-api-version": String(apiVersion),
+        },
+    });
+}
+function eventFrame(event) {
+    return `id: ${event.cursor}\nevent: ${event.type}\ndata: ${canonicalJson(event)}\n\n`;
+}
+function integer(value, name) {
+    if (!/^\d+$/.test(value) || !Number.isSafeInteger(Number(value)))
+        throw queryError(`${name} is invalid`);
+    return Number(value);
+}
+function queryError(message) {
+    return new ObservabilityQueryError("RELKIT_OBSERVABILITY_QUERY_INVALID", `Observability query ${message}`);
+}
+function streamError(message) {
+    return new ObservabilityStreamError("RELKIT_OBSERVABILITY_STREAM_INVALID", message);
+}
+//# sourceMappingURL=observability-utils.js.map

package/dist/observability-utils.js.map

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

package/dist/observability.d.ts

@@ -0,0 +1,23 @@
+import { type MaybePromise } from "@relkit/contracts";
+import { type ObservabilityQuery, type ObservabilityStream } from "@relkit/observability";
+import type { Hono } from "hono";
+export { readObservabilityQuery } from "./observability-utils.js";
+export declare const INSPECTOR_API_PROTOCOL: "relkit.inspector";
+export declare const INSPECTOR_API_VERSION: 1;
+export declare const OBSERVABILITY_ENDPOINT_PATHS: readonly ["/_relkit/v1/requests", "/_relkit/v1/requests/:requestId", "/_relkit/v1/logs", "/_relkit/v1/traces", "/_relkit/v1/traces/:traceId", "/_relkit/v1/stream"];
+export type ObservabilityEndpointMode = "development" | "test" | "production";
+export interface ObservabilityEndpointOptions {
+    readonly query: ObservabilityQuery;
+    readonly stream: ObservabilityStream;
+    readonly mode?: ObservabilityEndpointMode;
+    readonly environment?: ObservabilityEndpointMode;
+    readonly enabled?: boolean;
+    readonly bearerToken?: string;
+    readonly authorize?: (request: Request) => MaybePromise<boolean>;
+}
+export declare class ObservabilityEndpointConfigurationError extends TypeError {
+    constructor(message: string);
+}
+/** Installs the bounded, versioned observability query and SSE endpoints. */
+export declare function installObservabilityEndpoints(app: Hono, options: ObservabilityEndpointOptions): void;
+//# sourceMappingURL=observability.d.ts.map

package/dist/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../src/observability.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,MAAM,CAAC;AAI1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,eAAO,MAAM,sBAAsB,EAAG,kBAA2B,CAAC;AAClE,eAAO,MAAM,qBAAqB,GAAc,CAAC;AACjD,eAAO,MAAM,4BAA4B,qKAO9B,CAAC;AAEZ,MAAM,MAAM,yBAAyB,GAAG,aAAa,GAAG,MAAM,GAAG,YAAY,CAAC;AAE9E,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,yBAAyB,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,yBAAyB,CAAC;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC;CAClE;AAED,qBAAa,uCAAwC,SAAQ,SAAS;gBACxD,OAAO,EAAE,MAAM;CAI5B;AAED,6EAA6E;AAC7E,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,IAAI,EACT,OAAO,EAAE,4BAA4B,GACpC,IAAI,CAiEN"}

package/dist/observability.js

@@ -0,0 +1,126 @@
+import { API_BASE_PATH, API_VERSION, canonicalJson, } from "@relkit/contracts";
+import { ObservabilityQueryError, ObservabilityStreamError, } from "@relkit/observability";
+import { readObservabilityQuery, streamResponse } from "./observability-utils.js";
+import { InspectorEndpointError, negotiateHeaders } from "./router-utils.js";
+export { readObservabilityQuery } from "./observability-utils.js";
+export const INSPECTOR_API_PROTOCOL = "relkit.inspector";
+export const INSPECTOR_API_VERSION = API_VERSION;
+export const OBSERVABILITY_ENDPOINT_PATHS = Object.freeze([
+    `${API_BASE_PATH}/requests`,
+    `${API_BASE_PATH}/requests/:requestId`,
+    `${API_BASE_PATH}/logs`,
+    `${API_BASE_PATH}/traces`,
+    `${API_BASE_PATH}/traces/:traceId`,
+    `${API_BASE_PATH}/stream`,
+]);
+export class ObservabilityEndpointConfigurationError extends TypeError {
+    constructor(message) {
+        super(message);
+        this.name = "ObservabilityEndpointConfigurationError";
+    }
+}
+/** Installs the bounded, versioned observability query and SSE endpoints. */
+export function installObservabilityEndpoints(app, options) {
+    const mode = options.environment ?? options.mode ?? "development";
+    const enabled = options.enabled ?? mode !== "production";
+    validateConfiguration(mode, enabled, options);
+    if (!enabled)
+        return;
+    const guard = (handler) => async (context) => {
+        if (!(await authorized(context.req.raw, options)))
+            return errorResponse("RELKIT_OBSERVABILITY_UNAUTHORIZED", 401, {
+                "www-authenticate": "Bearer",
+            });
+        try {
+            negotiateHeaders(context.req.raw);
+            return await handler(context);
+        }
+        catch (error) {
+            return safeErrorResponse(error);
+        }
+    };
+    app.get(`${API_BASE_PATH}/requests`, guard(async (context) => jsonResponse(await options.query.requests(readObservabilityQuery(context.req.raw)))));
+    app.get(`${API_BASE_PATH}/requests/:requestId`, guard(async (context) => {
+        const requestId = context.req.param("requestId");
+        if (requestId === undefined)
+            throw new EndpointError("RELKIT_OBSERVABILITY_NOT_FOUND", 404);
+        const request = await options.query.request(requestId);
+        if (request === undefined)
+            throw new EndpointError("RELKIT_OBSERVABILITY_NOT_FOUND", 404);
+        return jsonResponse(request);
+    }));
+    app.get(`${API_BASE_PATH}/logs`, guard(async (context) => jsonResponse(await options.query.logs(readObservabilityQuery(context.req.raw)))));
+    app.get(`${API_BASE_PATH}/traces`, guard(async (context) => jsonResponse(await options.query.traces(readObservabilityQuery(context.req.raw)))));
+    app.get(`${API_BASE_PATH}/traces/:traceId`, guard(async (context) => {
+        const traceId = context.req.param("traceId");
+        if (traceId === undefined)
+            throw new EndpointError("RELKIT_OBSERVABILITY_NOT_FOUND", 404);
+        const trace = await options.query.trace(traceId);
+        if (trace === undefined)
+            throw new EndpointError("RELKIT_OBSERVABILITY_NOT_FOUND", 404);
+        return jsonResponse(trace);
+    }));
+    app.get(`${API_BASE_PATH}/stream`, guard(async (context) => streamResponse(options.stream, context.req.raw, INSPECTOR_API_VERSION)));
+}
+function validateConfiguration(mode, enabled, options) {
+    if (!(mode === "development" || mode === "test" || mode === "production"))
+        throw new ObservabilityEndpointConfigurationError("mode is invalid");
+    if (mode === "production" &&
+        enabled &&
+        options.bearerToken === undefined &&
+        options.authorize === undefined)
+        throw new ObservabilityEndpointConfigurationError("Production observability endpoints require bearerToken or authorize protection.");
+    if (options.bearerToken !== undefined && options.bearerToken.trim().length === 0)
+        throw new ObservabilityEndpointConfigurationError("bearerToken must not be empty");
+}
+async function authorized(request, options) {
+    if (options.authorize !== undefined) {
+        try {
+            if (await options.authorize(request))
+                return true;
+        }
+        catch {
+            return false;
+        }
+        if (options.bearerToken === undefined)
+            return false;
+    }
+    return options.bearerToken === undefined
+        ? true
+        : request.headers.get("authorization") === `Bearer ${options.bearerToken}`;
+}
+function jsonResponse(value, status = 200, headers = {}) {
+    return new Response(canonicalJson(value), {
+        status,
+        headers: {
+            "cache-control": "no-store",
+            "content-type": "application/json; charset=utf-8",
+            "x-relkit-api-version": String(INSPECTOR_API_VERSION),
+            ...headers,
+        },
+    });
+}
+function errorResponse(code, status, headers = {}) {
+    return jsonResponse({ protocol: INSPECTOR_API_PROTOCOL, version: INSPECTOR_API_VERSION, error: code }, status, headers);
+}
+function safeErrorResponse(error) {
+    if (error instanceof EndpointError)
+        return errorResponse(error.code, error.status);
+    if (error instanceof InspectorEndpointError)
+        return errorResponse(error.code, error.status);
+    if (error instanceof ObservabilityQueryError)
+        return errorResponse(error.code, 400);
+    if (error instanceof ObservabilityStreamError)
+        return errorResponse(error.code, 400);
+    return errorResponse("RELKIT_OBSERVABILITY_INTERNAL", 500);
+}
+class EndpointError extends Error {
+    code;
+    status;
+    constructor(code, status) {
+        super(code);
+        this.code = code;
+        this.status = status;
+    }
+}
+//# sourceMappingURL=observability.js.map

package/dist/observability.js.map

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

package/dist/resource-explorer.d.ts

@@ -0,0 +1,54 @@
+import type { JsonValue, MaybePromise } from "@relkit/contracts";
+import { type ResolvedActiveGeneration } from "./shared.js";
+export interface InspectorBucketExplorer {
+    readonly supports: (bucketId: string) => MaybePromise<boolean>;
+    readonly list: (request: {
+        readonly bucketId: string;
+        readonly prefix?: string;
+        readonly cursor?: string;
+        readonly limit: number;
+        readonly signal: AbortSignal;
+    }) => MaybePromise<{
+        readonly items: readonly unknown[];
+        readonly nextCursor?: string;
+    }>;
+    readonly preview: (request: {
+        readonly bucketId: string;
+        readonly key: string;
+        readonly offset: number;
+        readonly limit: number;
+        readonly signal: AbortSignal;
+    }) => MaybePromise<{
+        readonly bytes: Uint8Array;
+        readonly metadata?: unknown;
+        readonly totalBytes?: number;
+    } | undefined>;
+}
+export interface InspectorCacheExplorer {
+    readonly supports: (cacheId: string) => MaybePromise<boolean>;
+    readonly scan: (request: {
+        readonly cacheId: string;
+        readonly search?: string;
+        readonly cursor?: string;
+        readonly limit: number;
+        readonly signal: AbortSignal;
+    }) => MaybePromise<{
+        readonly items: readonly unknown[];
+        readonly nextCursor?: string;
+    }>;
+    readonly value: (request: {
+        readonly cacheId: string;
+        readonly key: string;
+        readonly limit: number;
+        readonly signal: AbortSignal;
+    }) => MaybePromise<unknown | undefined>;
+}
+export interface InspectorResourceExplorers {
+    readonly buckets?: InspectorBucketExplorer;
+    readonly cache?: InspectorCacheExplorer;
+}
+export declare function bucketObjects(generation: ResolvedActiveGeneration, bucketId: string, request: Request): Promise<JsonValue>;
+export declare function bucketPreview(generation: ResolvedActiveGeneration, bucketId: string, request: Request, maximumBytes: number): Promise<JsonValue>;
+export declare function cacheKeys(generation: ResolvedActiveGeneration, cacheId: string, request: Request): Promise<JsonValue>;
+export declare function cacheValue(generation: ResolvedActiveGeneration, cacheId: string, request: Request, maximumBytes: number): Promise<JsonValue>;
+//# sourceMappingURL=resource-explorer.d.ts.map