@gloocan/cat-inspector 0.1.1

package/dist/jobs/in-memory-job-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-job-registry.d.ts","sourceRoot":"","sources":["../../src/jobs/in-memory-job-registry.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAA;AAEhE,KAAK,MAAM,GAAG;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvF;;GAEG;AACH,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;IAEjD,SAAS,IAAI,MAAM;IAOnB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAOjD,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;IAQ/C,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAO1C,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAItC,OAAO,CAAC,OAAO;CAKf"}

package/dist/jobs/in-memory-job-registry.js

@@ -0,0 +1,44 @@
+import { randomUUID } from 'node:crypto';
+import { broadcastJobProgress } from '../registry-state.js';
+/**
+ * Minimal in-memory job registry for QA demos: creates ids, updates status, fans out `JOB_PROGRESS` on the inspector broadcast path.
+ */
+export class InMemoryJobRegistry {
+    jobs = new Map();
+    createJob() {
+        const jobId = randomUUID();
+        this.jobs.set(jobId, { status: 'queued', percent: 0 });
+        broadcastJobProgress({ jobId, status: 'queued', percent: 0 });
+        return jobId;
+    }
+    setRunning(jobId, percent) {
+        const j = this.require(jobId);
+        j.status = 'running';
+        if (percent !== undefined)
+            j.percent = percent;
+        broadcastJobProgress({ jobId, status: 'running', percent: j.percent, detail: j.detail });
+    }
+    complete(jobId, result) {
+        const j = this.require(jobId);
+        j.status = 'done';
+        j.percent = 100;
+        j.result = result;
+        broadcastJobProgress({ jobId, status: 'done', percent: 100, detail: j.detail });
+    }
+    fail(jobId, detail) {
+        const j = this.require(jobId);
+        j.status = 'failed';
+        j.detail = detail;
+        broadcastJobProgress({ jobId, status: 'failed', percent: j.percent, detail });
+    }
+    get(jobId) {
+        return this.jobs.get(jobId);
+    }
+    require(jobId) {
+        const j = this.jobs.get(jobId);
+        if (!j)
+            throw new Error(`unknown jobId ${jobId}`);
+        return j;
+    }
+}
+//# sourceMappingURL=in-memory-job-registry.js.map

package/dist/jobs/in-memory-job-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-job-registry.js","sourceRoot":"","sources":["../../src/jobs/in-memory-job-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAM3D;;GAEG;AACH,MAAM,OAAO,mBAAmB;IACd,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAA;IAEjD,SAAS;QACR,MAAM,KAAK,GAAG,UAAU,EAAE,CAAA;QAC1B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAA;QACtD,oBAAoB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAA;QAC7D,OAAO,KAAK,CAAA;IACb,CAAC;IAED,UAAU,CAAC,KAAa,EAAE,OAAgB;QACzC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAC7B,CAAC,CAAC,MAAM,GAAG,SAAS,CAAA;QACpB,IAAI,OAAO,KAAK,SAAS;YAAE,CAAC,CAAC,OAAO,GAAG,OAAO,CAAA;QAC9C,oBAAoB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAA;IACzF,CAAC;IAED,QAAQ,CAAC,KAAa,EAAE,MAAgB;QACvC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAC7B,CAAC,CAAC,MAAM,GAAG,MAAM,CAAA;QACjB,CAAC,CAAC,OAAO,GAAG,GAAG,CAAA;QACf,CAAC,CAAC,MAAM,GAAG,MAAM,CAAA;QACjB,oBAAoB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAA;IAChF,CAAC;IAED,IAAI,CAAC,KAAa,EAAE,MAAe;QAClC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAC7B,CAAC,CAAC,MAAM,GAAG,QAAQ,CAAA;QACnB,CAAC,CAAC,MAAM,GAAG,MAAM,CAAA;QACjB,oBAAoB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;IAC9E,CAAC;IAED,GAAG,CAAC,KAAa;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAC5B,CAAC;IAEO,OAAO,CAAC,KAAa;QAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAC9B,IAAI,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,EAAE,CAAC,CAAA;QACjD,OAAO,CAAC,CAAA;IACT,CAAC;CACD"}

package/dist/logger.d.ts

@@ -0,0 +1,9 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface Logger {
+    debug: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+}
+export declare function createLogger(level?: LogLevel): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAE1D,MAAM,WAAW,MAAM;IACtB,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IACnC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IAClC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IAClC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CACnC;AAID,wBAAgB,YAAY,CAAC,KAAK,GAAE,QAAiB,GAAG,MAAM,CAmB7D"}

package/dist/logger.js

@@ -0,0 +1,17 @@
+const PREFIX = '[cat-inspector]';
+export function createLogger(level = 'info') {
+    const order = ['debug', 'info', 'warn', 'error'];
+    const min = order.indexOf(level);
+    function emit(lv, fn, args) {
+        if (order.indexOf(lv) < min)
+            return;
+        fn(PREFIX, ...args);
+    }
+    return {
+        debug: (...args) => emit('debug', console.log, args),
+        info: (...args) => emit('info', console.log, args),
+        warn: (...args) => emit('warn', console.warn, args),
+        error: (...args) => emit('error', console.error, args),
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,GAAG,iBAAiB,CAAA;AAEhC,MAAM,UAAU,YAAY,CAAC,QAAkB,MAAM;IACpD,MAAM,KAAK,GAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;IAC5D,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAEhC,SAAS,IAAI,CACZ,EAAY,EACZ,EAAsB,EACtB,IAAe;QAEf,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,GAAG;YAAE,OAAM;QACnC,EAAE,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAA;IACpB,CAAC;IAED,OAAO;QACN,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC;QAC/D,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC;QAC7D,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;QAC9D,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;KACjE,CAAA;AACF,CAAC"}

package/dist/openapi/registry-to-openapi.d.ts

@@ -0,0 +1,11 @@
+import type { RegistryEntry } from '../types.js';
+/**
+ * Build a minimal OpenAPI 3.1 document from a registry snapshot.
+ * - Express-backed entries (`route` + `httpMethod`) become real paths.
+ * - Every `fnKey` also gets a documented `POST /qa/rpc/{fnKey}` placeholder (not mounted by the SDK).
+ */
+export declare function exportRegistryOpenApi(registry: Record<string, RegistryEntry>, opts?: {
+    title?: string;
+    version?: string;
+}): Record<string, unknown>;
+//# sourceMappingURL=registry-to-openapi.d.ts.map

package/dist/openapi/registry-to-openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-to-openapi.d.ts","sourceRoot":"","sources":["../../src/openapi/registry-to-openapi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EACvC,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACzC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuDzB"}

package/dist/openapi/registry-to-openapi.js

@@ -0,0 +1,61 @@
+/**
+ * Build a minimal OpenAPI 3.1 document from a registry snapshot.
+ * - Express-backed entries (`route` + `httpMethod`) become real paths.
+ * - Every `fnKey` also gets a documented `POST /qa/rpc/{fnKey}` placeholder (not mounted by the SDK).
+ */
+export function exportRegistryOpenApi(registry, opts) {
+    const paths = {};
+    for (const [fnKey, e] of Object.entries(registry)) {
+        if (e.route && e.httpMethod) {
+            const route = e.route.startsWith('/') ? e.route : `/${e.route}`;
+            const method = e.httpMethod.toLowerCase();
+            if (!paths[route])
+                paths[route] = {};
+            paths[route][method] = {
+                summary: fnKey,
+                operationId: fnKey.replace(/[^a-zA-Z0-9_]/g, '_'),
+                responses: {
+                    '200': { description: 'Handler response (shape varies)' },
+                },
+            };
+        }
+        const rpcPath = `/qa/rpc/${encodeURIComponent(fnKey)}`;
+        if (!paths[rpcPath]) {
+            paths[rpcPath] = {
+                post: {
+                    summary: `RPC invoke ${fnKey}`,
+                    operationId: `rpc_${fnKey.replace(/[^a-zA-Z0-9_]/g, '_')}`,
+                    requestBody: {
+                        required: true,
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    type: 'object',
+                                    required: ['type', 'requestId', 'fnKey', 'args'],
+                                    properties: {
+                                        type: { const: 'RPC_CALL' },
+                                        requestId: { type: 'string' },
+                                        fnKey: { const: fnKey },
+                                        args: { type: 'array' },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                    responses: {
+                        '200': { description: 'RPC_RESPONSE JSON' },
+                    },
+                },
+            };
+        }
+    }
+    return {
+        openapi: '3.1.0',
+        info: {
+            title: opts?.title ?? 'Cat inspector registry',
+            version: opts?.version ?? '1.0.0',
+        },
+        paths,
+    };
+}
+//# sourceMappingURL=registry-to-openapi.js.map

package/dist/openapi/registry-to-openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-to-openapi.js","sourceRoot":"","sources":["../../src/openapi/registry-to-openapi.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACpC,QAAuC,EACvC,IAA2C;IAE3C,MAAM,KAAK,GAA4C,EAAE,CAAA;IAEzD,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAA;YAC/D,MAAM,MAAM,GAAG,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,CAAA;YACzC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;gBAAE,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;YACpC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG;gBACtB,OAAO,EAAE,KAAK;gBACd,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;gBACjD,SAAS,EAAE;oBACV,KAAK,EAAE,EAAE,WAAW,EAAE,iCAAiC,EAAE;iBACzD;aACD,CAAA;QACF,CAAC;QACD,MAAM,OAAO,GAAG,WAAW,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAA;QACtD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACrB,KAAK,CAAC,OAAO,CAAC,GAAG;gBAChB,IAAI,EAAE;oBACL,OAAO,EAAE,cAAc,KAAK,EAAE;oBAC9B,WAAW,EAAE,OAAO,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,EAAE;oBAC1D,WAAW,EAAE;wBACZ,QAAQ,EAAE,IAAI;wBACd,OAAO,EAAE;4BACR,kBAAkB,EAAE;gCACnB,MAAM,EAAE;oCACP,IAAI,EAAE,QAAQ;oCACd,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC;oCAChD,UAAU,EAAE;wCACX,IAAI,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE;wCAC3B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wCAC7B,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;wCACvB,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;qCACvB;iCACD;6BACD;yBACD;qBACD;oBACD,SAAS,EAAE;wBACV,KAAK,EAAE,EAAE,WAAW,EAAE,mBAAmB,EAAE;qBAC3C;iBACD;aACD,CAAA;QACF,CAAC;IACF,CAAC;IAED,OAAO;QACN,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE;YACL,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,wBAAwB;YAC9C,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,OAAO;SACjC;QACD,KAAK;KACL,CAAA;AACF,CAAC"}

package/dist/registry-state.d.ts

@@ -0,0 +1,107 @@
+import type { IncomingHttpHeaders } from 'node:http';
+import WebSocket from 'ws';
+import type { ApiResponseEvent, ErrorThrownEvent, JobProgressWireEvent, MiddlewareNextEvent, ReturnResolvedEvent } from './types.js';
+export declare const Registry: Map<string, import("./types.js").RegistryEntry>;
+/** Live instances for RPC calls */
+export declare const InstanceRegistry: Map<string, unknown>;
+/**
+ * Instances resolved implicitly (via resolver or constructor fallback).
+ * Kept separate from `InstanceRegistry` so explicit registrations remain visible/distinct.
+ */
+export declare const AutoInstanceRegistry: Map<string, unknown>;
+export declare const ClassConstructorRegistry: Map<string, new (...args: any[]) => any>;
+export declare function registerClassConstructor(className: string, ctor: new (...args: any[]) => any): void;
+export declare function resolveInstanceForClassName(className: string): unknown | null;
+export declare const ActiveContext: {
+    stack: string[];
+    push(key: string): void;
+    pop(): string | null;
+    set(key: string): void;
+    get(): string | null;
+    clear(): void;
+};
+export declare const ApiContext: {
+    currentEndpoint: string | null;
+    set(key: string): void;
+    get(): string | null;
+    clear(): void;
+};
+export declare const LabelCapture: {
+    current: string | null;
+    capture(label: string): void;
+    read(): string | null;
+    clear(): void;
+};
+export declare const ErrorCapture: {
+    current: {
+        label: string;
+        error: Error;
+    } | null;
+    capture(label: string, error: Error): void;
+    read(): {
+        label: string;
+        error: Error;
+    } | null;
+    hasCurrent(): boolean;
+    clear(): void;
+};
+export declare function clearExpressApiInvokeCapture(): void;
+export declare function recordExpressApiInvokeCapture(endpointKey: string, payload: {
+    label: string;
+    statusCode: number;
+    body: unknown;
+}): void;
+export declare function readExpressApiInvokeCapture(endpointKey: string): {
+    label: string;
+    statusCode: number;
+    body: unknown;
+} | undefined;
+export declare const wsClients: Set<WebSocket>;
+export type InspectorBroadcastSource = 'rpc' | 'http';
+export type InspectorBroadcastStore = {
+    socketId: string;
+    source: InspectorBroadcastSource;
+    /**
+     * Optional per-request correlation id.
+     * Used by HTTP inspector to group events belonging to a single inbound request.
+     */
+    correlationId?: string;
+    /**
+     * Optional: which pipeline handler is currently executing (middleware or endpoint).
+     * Used to tag API responses so the UI can attribute early responses to the correct middleware.
+     */
+    producerFnKey?: string | null;
+};
+export declare function setBroadcastSink(fn: ((data: object) => void) | null): void;
+export declare function clearBroadcastSink(): void;
+export declare function getInspectorBroadcastStore(): InspectorBroadcastStore | undefined;
+/**
+ * Correlate subsequent `broadcast()` calls with a Socket.IO tab (or other sink).
+ * Default source `rpc` (not gated by HTTP inspector toggle). Use `http` from REST middleware.
+ */
+export declare function runWithInspectorBroadcastTarget<T>(socketId: string, fn: () => T, options?: {
+    source?: InspectorBroadcastSource;
+    correlationId?: string;
+}): T;
+/**
+ * Run within the current inspector broadcast store but with an updated producer fnKey.
+ * No-op if there is no active inspector store (i.e. no X-Socket-Id correlation).
+ */
+export declare function runWithProducerFnKey<T>(producerFnKey: string | null, fn: () => T): T;
+export declare const INSPECTOR_SOCKET_ID_HEADER = "x-socket-id";
+/** Read Socket.IO correlation id from Express / Node request headers */
+export declare function readInspectorSocketIdFromHeaders(headers: IncomingHttpHeaders): string | undefined;
+export declare function broadcast(data: object): void;
+export declare function broadcastReturnResolved(payload: Omit<ReturnResolvedEvent, 'protocolVersion' | 'timestamp'>): void;
+export declare function broadcastErrorThrown(payload: Omit<ErrorThrownEvent, 'protocolVersion' | 'timestamp'>): void;
+export declare function broadcastApiResponse(payload: Omit<ApiResponseEvent, 'protocolVersion' | 'timestamp'>): void;
+export declare function broadcastMiddlewareNext(payload: Omit<MiddlewareNextEvent, 'protocolVersion' | 'timestamp'>): void;
+export declare function broadcastJobProgress(payload: Omit<JobProgressWireEvent, 'event' | 'protocolVersion' | 'timestamp'>): void;
+/** Attach or clear a JSON Schema used by QA to validate RPC `result` for this `fnKey`. */
+export declare function registerReturnJsonSchema(fnKey: string, schema: Record<string, unknown> | null): void;
+/** Attach or clear a JSON Schema used to validate RPC `args` (whole tuple) for this `fnKey`. */
+export declare function registerParamsJsonSchema(fnKey: string, schema: Record<string, unknown> | null): void;
+export declare function registerInstance(instance: unknown): void;
+/** Test-only: reset in-memory state */
+export declare function resetInspectorState(): void;
+//# sourceMappingURL=registry-state.d.ts.map

package/dist/registry-state.d.ts.map

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

package/dist/registry-state.js

@@ -0,0 +1,302 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import WebSocket from 'ws';
+import { resetInvokePolicy } from './invoke-policy.js';
+import { resetInvokeTimeoutMs } from './invoke-runtime-config.js';
+import { clearHttpBridgeRegistry } from './http-bridge-registry.js';
+import { resetParamsJsonSchemaValidators } from './validate-params-json-schema.js';
+import { resetReturnJsonSchemaValidators } from './validate-return-json-schema.js';
+import { resetRpcSerializationConfig } from './serialize-rpc-result.js';
+import { resetSessionStore } from './session-store.js';
+import { PROTOCOL_VERSION } from './types.js';
+export const Registry = new Map();
+/** Live instances for RPC calls */
+export const InstanceRegistry = new Map();
+/**
+ * Instances resolved implicitly (via resolver or constructor fallback).
+ * Kept separate from `InstanceRegistry` so explicit registrations remain visible/distinct.
+ */
+export const AutoInstanceRegistry = new Map();
+export const ClassConstructorRegistry = new Map();
+export function registerClassConstructor(className, ctor) {
+    if (!className)
+        return;
+    const existing = ClassConstructorRegistry.get(className);
+    if (existing) {
+        // Idempotent: allow repeated registration of the same constructor.
+        if (existing === ctor)
+            return;
+        throw new Error(`registerClassConstructor: duplicate className "${className}"`);
+    }
+    ClassConstructorRegistry.set(className, ctor);
+}
+export function resolveInstanceForClassName(className) {
+    const explicit = InstanceRegistry.get(className);
+    if (explicit)
+        return explicit;
+    const cached = AutoInstanceRegistry.get(className);
+    if (cached)
+        return cached;
+    const ctor = ClassConstructorRegistry.get(className);
+    if (ctor) {
+        const created = new ctor();
+        AutoInstanceRegistry.set(className, created);
+        return created;
+    }
+    return null;
+}
+export const ActiveContext = {
+    stack: [],
+    push(key) {
+        this.stack.push(key);
+    },
+    pop() {
+        const v = this.stack.pop();
+        return v ?? null;
+    },
+    set(key) {
+        // Back-compat alias (prefer push/pop).
+        this.push(key);
+    },
+    get() {
+        const v = this.stack[this.stack.length - 1];
+        return v ?? null;
+    },
+    clear() {
+        // Back-compat: clear entire stack (reset state).
+        this.stack = [];
+    },
+};
+export const ApiContext = {
+    currentEndpoint: null,
+    set(key) {
+        this.currentEndpoint = key;
+    },
+    get() {
+        return this.currentEndpoint;
+    },
+    clear() {
+        this.currentEndpoint = null;
+    },
+};
+export const LabelCapture = {
+    current: null,
+    capture(label) {
+        this.current = label;
+    },
+    read() {
+        return this.current;
+    },
+    clear() {
+        this.current = null;
+    },
+};
+export const ErrorCapture = {
+    current: null,
+    capture(label, error) {
+        this.current = { label, error };
+    },
+    read() {
+        return this.current;
+    },
+    hasCurrent() {
+        return this.current !== null;
+    },
+    clear() {
+        this.current = null;
+    },
+};
+/**
+ * Last `ApiReturn` payload per endpoint `fnKey`, for correlating express playground RPC
+ * with controller-level API semantics. Cleared per express invoke and on inspector reset.
+ */
+const expressApiInvokeCaptureByEndpoint = new Map();
+export function clearExpressApiInvokeCapture() {
+    expressApiInvokeCaptureByEndpoint.clear();
+}
+export function recordExpressApiInvokeCapture(endpointKey, payload) {
+    expressApiInvokeCaptureByEndpoint.set(endpointKey, payload);
+}
+export function readExpressApiInvokeCapture(endpointKey) {
+    return expressApiInvokeCaptureByEndpoint.get(endpointKey);
+}
+export const wsClients = new Set();
+const inspectorBroadcastAls = new AsyncLocalStorage();
+/** Optional second fan-out (e.g. Socket.IO); receives same object as native ws broadcast */
+let broadcastSink = null;
+export function setBroadcastSink(fn) {
+    broadcastSink = fn;
+}
+export function clearBroadcastSink() {
+    broadcastSink = null;
+}
+export function getInspectorBroadcastStore() {
+    return inspectorBroadcastAls.getStore();
+}
+/**
+ * Correlate subsequent `broadcast()` calls with a Socket.IO tab (or other sink).
+ * Default source `rpc` (not gated by HTTP inspector toggle). Use `http` from REST middleware.
+ */
+export function runWithInspectorBroadcastTarget(socketId, fn, options) {
+    const source = options?.source ?? 'rpc';
+    return inspectorBroadcastAls.run({ socketId, source, correlationId: options?.correlationId }, fn);
+}
+/**
+ * Run within the current inspector broadcast store but with an updated producer fnKey.
+ * No-op if there is no active inspector store (i.e. no X-Socket-Id correlation).
+ */
+export function runWithProducerFnKey(producerFnKey, fn) {
+    const store = getInspectorBroadcastStore();
+    if (!store)
+        return fn();
+    return inspectorBroadcastAls.run({ ...store, producerFnKey }, fn);
+}
+export const INSPECTOR_SOCKET_ID_HEADER = 'x-socket-id';
+function firstHeaderValue(value) {
+    if (value === undefined)
+        return undefined;
+    const s = Array.isArray(value) ? value[0] : value;
+    const t = typeof s === 'string' ? s.trim() : '';
+    return t.length > 0 ? t : undefined;
+}
+/** Read Socket.IO correlation id from Express / Node request headers */
+export function readInspectorSocketIdFromHeaders(headers) {
+    return firstHeaderValue(headers[INSPECTOR_SOCKET_ID_HEADER]);
+}
+export function broadcast(data) {
+    const msg = JSON.stringify(data);
+    for (const client of wsClients) {
+        if (client.readyState === WebSocket.OPEN) {
+            client.send(msg);
+        }
+    }
+    if (broadcastSink) {
+        try {
+            broadcastSink(data);
+        }
+        catch {
+            /* sink errors must not break native ws path */
+        }
+    }
+}
+export function broadcastReturnResolved(payload) {
+    const store = getInspectorBroadcastStore();
+    const correlationId = payload.correlationId ?? store?.correlationId;
+    broadcast({
+        ...payload,
+        ...(correlationId ? { correlationId } : {}),
+        protocolVersion: PROTOCOL_VERSION,
+        timestamp: new Date().toISOString(),
+    });
+}
+export function broadcastErrorThrown(payload) {
+    const store = getInspectorBroadcastStore();
+    const correlationId = payload.correlationId ?? store?.correlationId;
+    broadcast({
+        ...payload,
+        ...(correlationId ? { correlationId } : {}),
+        protocolVersion: PROTOCOL_VERSION,
+        timestamp: new Date().toISOString(),
+    });
+}
+export function broadcastApiResponse(payload) {
+    const store = getInspectorBroadcastStore();
+    const correlationId = payload.correlationId ?? store?.correlationId;
+    const producerFnKey = 'producerFnKey' in payload
+        ? payload.producerFnKey
+        : (store?.producerFnKey ?? undefined);
+    let safeBody = undefined;
+    if ('body' in payload) {
+        // Best-effort, size-limited JSON clone for inspector display.
+        // Prevents huge payloads from spamming the live inspector feed.
+        try {
+            const asJson = JSON.stringify(payload.body);
+            if (asJson.length <= 10_000) {
+                safeBody = JSON.parse(asJson);
+            }
+            else {
+                safeBody = { __omitted: 'body_too_large', bytes: asJson.length };
+            }
+        }
+        catch {
+            safeBody = { __omitted: 'body_unserializable' };
+        }
+    }
+    const out = {
+        ...payload,
+        ...(correlationId ? { correlationId } : {}),
+        ...(producerFnKey !== undefined ? { producerFnKey } : {}),
+        ...(safeBody !== undefined ? { body: safeBody } : {}),
+        protocolVersion: PROTOCOL_VERSION,
+        timestamp: new Date().toISOString(),
+    };
+    broadcast(out);
+}
+export function broadcastMiddlewareNext(payload) {
+    const store = getInspectorBroadcastStore();
+    const correlationId = payload.correlationId ?? store?.correlationId;
+    broadcast({
+        ...payload,
+        ...(correlationId ? { correlationId } : {}),
+        protocolVersion: PROTOCOL_VERSION,
+        timestamp: new Date().toISOString(),
+    });
+}
+export function broadcastJobProgress(payload) {
+    broadcast({
+        event: 'JOB_PROGRESS',
+        protocolVersion: PROTOCOL_VERSION,
+        timestamp: new Date().toISOString(),
+        ...payload,
+    });
+}
+/** Attach or clear a JSON Schema used by QA to validate RPC `result` for this `fnKey`. */
+export function registerReturnJsonSchema(fnKey, schema) {
+    const entry = Registry.get(fnKey);
+    if (!entry) {
+        throw new Error(`registerReturnJsonSchema: unknown fnKey "${fnKey}"`);
+    }
+    entry.returnJsonSchema = schema;
+}
+/** Attach or clear a JSON Schema used to validate RPC `args` (whole tuple) for this `fnKey`. */
+export function registerParamsJsonSchema(fnKey, schema) {
+    const entry = Registry.get(fnKey);
+    if (!entry) {
+        throw new Error(`registerParamsJsonSchema: unknown fnKey "${fnKey}"`);
+    }
+    entry.paramsJsonSchema = schema;
+}
+export function registerInstance(instance) {
+    if (typeof instance !== 'object' && typeof instance !== 'function')
+        return;
+    const name = typeof instance === 'object'
+        ? instance.constructor?.name
+        : instance.name;
+    if (!name)
+        return;
+    if (InstanceRegistry.has(name)) {
+        throw new Error(`registerInstance: duplicate instance name "${name}" (already registered). Use unique class names or register only once.`);
+    }
+    InstanceRegistry.set(name, instance);
+}
+/** Test-only: reset in-memory state */
+export function resetInspectorState() {
+    clearHttpBridgeRegistry();
+    resetReturnJsonSchemaValidators();
+    resetParamsJsonSchemaValidators();
+    Registry.clear();
+    InstanceRegistry.clear();
+    AutoInstanceRegistry.clear();
+    ClassConstructorRegistry.clear();
+    ActiveContext.clear();
+    ApiContext.clear();
+    LabelCapture.clear();
+    ErrorCapture.clear();
+    clearExpressApiInvokeCapture();
+    wsClients.clear();
+    clearBroadcastSink();
+    resetRpcSerializationConfig();
+    resetInvokePolicy();
+    resetInvokeTimeoutMs();
+    resetSessionStore();
+}
+//# sourceMappingURL=registry-state.js.map

package/dist/registry-state.js.map

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

package/dist/return.d.ts

@@ -0,0 +1,14 @@
+export declare function getType(value: unknown): string;
+export declare function getShape(value: unknown, depth?: number): string;
+export type Labeled<L extends string, T> = T & {
+    readonly __brand?: L;
+};
+/** Runtime behavior unchanged; inferred return type is `T` so catalog `declaredReturn` matches `getType`. */
+export declare function Return<L extends string, T>(label: L, value: T): T;
+export declare function Throw<L extends string>(label: L, error: Error): never;
+export interface ApiPayload<T> {
+    statusCode: number;
+    body: T;
+}
+export declare function ApiReturn<L extends string, T>(label: L, statusCode: number, body: T): ApiPayload<T>;
+//# sourceMappingURL=return.d.ts.map

package/dist/return.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"return.d.ts","sourceRoot":"","sources":["../src/return.ts"],"names":[],"mappings":"AAYA,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAe9C;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,MAAM,CAkB1D;AAED,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;CAAE,CAAA;AAEvE,6GAA6G;AAC7G,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAsBjE;AAED,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAoBrE;AAED,MAAM,WAAW,UAAU,CAAC,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,CAAC,CAAA;CACP;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAC5C,KAAK,EAAE,CAAC,EACR,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,CAAC,GACL,UAAU,CAAC,CAAC,CAAC,CAqBf"}