@gloocan/cat-inspector 0.1.1

package/dist/functional.js

@@ -0,0 +1,165 @@
+import { ActiveContext, ApiContext, ErrorCapture, Registry, broadcastErrorThrown, broadcastMiddlewareNext, } from './registry-state.js';
+import { extractApiReturnLabels, extractParamNames, extractReturnLabels, extractThrowLabels, getFunctionBody, } from './source-utils.js';
+function detectModeForFunction(paramNames, options) {
+    const looksLikeExpress = paramNames.includes('req') && paramNames.includes('res');
+    const hasRoute = options?.route !== undefined;
+    if (!looksLikeExpress && !hasRoute)
+        return 'service';
+    return hasRoute ? 'api' : 'api_candidate';
+}
+function registerFunction(fnKey, fn, mode, params, declaredReturn, paramsJsonSchema) {
+    if (Registry.has(fnKey)) {
+        throw new Error(`cat: duplicate fnKey "${fnKey}". Each instrumented function must use a unique key.`);
+    }
+    const body = getFunctionBody(fn);
+    Registry.set(fnKey, {
+        mode,
+        className: fnKey.split('.')[0] ?? fnKey,
+        method: fnKey.split('.')[1] ?? fnKey,
+        style: 'function',
+        body,
+        params,
+        declaredReturn,
+        returns: extractReturnLabels(body).map((label) => ({
+            label,
+            type: null,
+            status: 'pending',
+        })),
+        errors: extractThrowLabels(body).map((label) => ({
+            label,
+            type: null,
+            message: null,
+            status: 'pending',
+        })),
+        children: [],
+        parents: [],
+        route: null,
+        httpMethod: null,
+        apiResponses: extractApiReturnLabels(body).map((label) => ({
+            label,
+            statusCode: null,
+            bodyShape: null,
+            status: 'pending',
+        })),
+        serviceLinks: [],
+        pipelineId: null,
+        pipelineIndex: null,
+        ...(paramsJsonSchema !== undefined && paramsJsonSchema !== null
+            ? { paramsJsonSchema }
+            : {}),
+        originalFn: fn,
+    });
+}
+function isThenable(v) {
+    return Boolean(v && typeof v.then === 'function');
+}
+function buildWrapper(fnKey, original) {
+    return function (...args) {
+        const entry = Registry.get(fnKey);
+        const isApi = entry?.mode === 'api';
+        const isMiddleware = entry?.mode === 'api_candidate';
+        const clearContext = () => {
+            if (isApi)
+                ApiContext.clear();
+            else
+                ActiveContext.pop();
+        };
+        // Express middleware: wrap next() so successful middleware steps emit an inspector event.
+        // This avoids leaving expected middleware nodes stuck at "pending" when they only call next().
+        if (isMiddleware && typeof args[2] === 'function') {
+            const realNext = args[2];
+            let emitted = false;
+            args[2] = (...nextArgs) => {
+                if (!emitted) {
+                    emitted = true;
+                    const err = nextArgs[0];
+                    if (err) {
+                        const message = err instanceof Error ? err.message : typeof err === 'string' ? err : 'next(err)';
+                        broadcastErrorThrown({
+                            event: 'ERROR_THROWN',
+                            fnKey,
+                            label: 'NEXT_ERROR',
+                            layer: 'expected',
+                            message,
+                            stack: err instanceof Error ? err.stack ?? null : null,
+                        });
+                    }
+                    else {
+                        broadcastMiddlewareNext({
+                            event: 'MIDDLEWARE_NEXT',
+                            fnKey,
+                            label: 'NEXT',
+                        });
+                    }
+                }
+                return realNext(...nextArgs);
+            };
+        }
+        if (isApi)
+            ApiContext.set(fnKey);
+        else
+            ActiveContext.push(fnKey);
+        let out;
+        try {
+            out = original.apply(this, args);
+        }
+        catch (err) {
+            if (err instanceof Error && !ErrorCapture.hasCurrent()) {
+                ErrorCapture.capture('UNEXPECTED_ERROR', err);
+                broadcastErrorThrown({
+                    event: 'ERROR_THROWN',
+                    fnKey,
+                    label: 'UNEXPECTED_ERROR',
+                    layer: 'unexpected',
+                    message: err.message,
+                    stack: err.stack ?? null,
+                });
+            }
+            clearContext();
+            throw err;
+        }
+        if (isThenable(out)) {
+            return Promise.resolve(out).finally(clearContext);
+        }
+        clearContext();
+        return out;
+    };
+}
+export function cat(fnKey, fn, options) {
+    const paramNames = extractParamNames(fn);
+    const mode = detectModeForFunction(paramNames, options);
+    const hintedParams = options?.params ??
+        paramNames.map((name) => ({ name, type: 'unknown' }));
+    const hintedReturn = options?.declaredReturn ?? 'unknown';
+    registerFunction(fnKey, fn, mode, hintedParams, hintedReturn, options?.paramsJsonSchema ?? null);
+    if (options?.route) {
+        const entry = Registry.get(fnKey);
+        entry.route = options.route;
+        entry.httpMethod = options.method ?? 'GET';
+        entry.mode = 'api';
+    }
+    const wrapped = buildWrapper(fnKey, fn);
+    const entry = Registry.get(fnKey);
+    if (entry)
+        entry.originalFn = wrapped;
+    return wrapped;
+}
+export function catModule(moduleName, fns, options) {
+    const wrapped = {};
+    for (const [methodName, fn] of Object.entries(fns)) {
+        const fnKey = `${moduleName}.${methodName}`;
+        const paramNames = extractParamNames(fn);
+        const mode = detectModeForFunction(paramNames);
+        const hintedParams = options?.[methodName]?.params ??
+            paramNames.map((name) => ({ name, type: 'unknown' }));
+        const hintedReturn = options?.[methodName]?.declaredReturn ?? 'unknown';
+        registerFunction(fnKey, fn, mode, hintedParams, hintedReturn, options?.[methodName]?.paramsJsonSchema ?? null);
+        const wrappedFn = buildWrapper(fnKey, fn);
+        const entry = Registry.get(fnKey);
+        if (entry)
+            entry.originalFn = wrappedFn;
+        wrapped[methodName] = wrappedFn;
+    }
+    return wrapped;
+}
+//# sourceMappingURL=functional.js.map

package/dist/functional.js.map

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

package/dist/graph/relationships.d.ts

@@ -0,0 +1,9 @@
+export declare function resolveRelationships(): void;
+export declare function analyzeRelationships(): {
+    roots: string[];
+    leaves: string[];
+    middle: string[];
+};
+export declare function buildTree(fnKey: string, visited?: Set<string>): object;
+export declare function groupApiPipelines(): Record<string, string[]>;
+//# sourceMappingURL=relationships.d.ts.map

package/dist/graph/relationships.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../src/graph/relationships.ts"],"names":[],"mappings":"AAMA,wBAAgB,oBAAoB,IAAI,IAAI,CAuB3C;AAED,wBAAgB,oBAAoB,IAAI;IACvC,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,MAAM,EAAE,MAAM,EAAE,CAAA;CAChB,CAeA;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,cAAoB,GAAG,MAAM,CA0B5E;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAgB5D"}

package/dist/graph/relationships.js

@@ -0,0 +1,92 @@
+import { Registry } from '../registry-state.js';
+function dedupePush(arr, key) {
+    if (!arr.includes(key))
+        arr.push(key);
+}
+export function resolveRelationships() {
+    const allKeys = [...Registry.keys()];
+    Registry.forEach((meta, fnKey) => {
+        for (const otherKey of allKeys) {
+            if (otherKey === fnKey)
+                continue;
+            const methodName = otherKey.split('.')[1];
+            if (!methodName)
+                continue;
+            if (meta.body.includes(methodName)) {
+                const other = Registry.get(otherKey);
+                if (!other)
+                    continue;
+                if (meta.mode === 'service' && other.mode === 'service') {
+                    dedupePush(meta.children, otherKey);
+                    dedupePush(other.parents, fnKey);
+                }
+                if (meta.mode === 'api' && other.mode === 'service') {
+                    dedupePush(meta.serviceLinks, otherKey);
+                }
+            }
+        }
+    });
+}
+export function analyzeRelationships() {
+    const roots = [];
+    const leaves = [];
+    const middle = [];
+    Registry.forEach((meta, key) => {
+        const hasParents = meta.parents.length > 0;
+        const hasChildren = meta.children.length > 0;
+        if (!hasParents && hasChildren)
+            roots.push(key);
+        if (hasParents && !hasChildren)
+            leaves.push(key);
+        if (hasParents && hasChildren)
+            middle.push(key);
+    });
+    return { roots, leaves, middle };
+}
+export function buildTree(fnKey, visited = new Set()) {
+    if (visited.has(fnKey))
+        return { key: fnKey, circular: true };
+    visited.add(fnKey);
+    const meta = Registry.get(fnKey);
+    if (!meta)
+        return { key: fnKey, error: 'not found' };
+    return {
+        key: fnKey,
+        mode: meta.mode,
+        className: meta.className,
+        method: meta.method,
+        params: meta.params,
+        declaredReturn: meta.declaredReturn,
+        returns: meta.returns,
+        errors: meta.errors,
+        apiResponses: meta.apiResponses,
+        route: meta.route,
+        httpMethod: meta.httpMethod,
+        pipelineId: meta.pipelineId,
+        pipelineIndex: meta.pipelineIndex,
+        serviceLinks: meta.serviceLinks,
+        isRoot: meta.parents.length === 0,
+        isLeaf: meta.children.length === 0,
+        children: meta.children.map((child) => buildTree(child, visited)),
+    };
+}
+export function groupApiPipelines() {
+    const grouped = {};
+    Registry.forEach((meta, fnKey) => {
+        if (meta.pipelineId === null || meta.pipelineIndex === null)
+            return;
+        if (!grouped[meta.pipelineId])
+            grouped[meta.pipelineId] = [];
+        grouped[meta.pipelineId].push(fnKey);
+    });
+    for (const [pid, keys] of Object.entries(grouped)) {
+        keys.sort((a, b) => {
+            const ai = Registry.get(a)?.pipelineIndex ?? 0;
+            const bi = Registry.get(b)?.pipelineIndex ?? 0;
+            return ai - bi;
+        });
+        grouped[pid] = keys;
+    }
+    return grouped;
+}
+//# sourceMappingURL=relationships.js.map

package/dist/graph/relationships.js.map

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

package/dist/http-bridge-registry.d.ts

@@ -0,0 +1,26 @@
+import type { Express } from 'express';
+import type { HttpMethod } from './express.js';
+export type HttpBridgeSpec = {
+    app: Express;
+    method: HttpMethod;
+    path: string;
+    mapArgsToBody: (args: unknown[]) => unknown;
+};
+/**
+ * Map a catalogued `fnKey` to an in-process HTTP call (Pattern B). Requires an existing `Registry` entry.
+ * Side effect: sets `entry.invokeKind = 'http_synthetic'`.
+ */
+export declare function registerHttpBridgeRoute(app: Express, spec: {
+    fnKey: string;
+    method: HttpMethod;
+    path: string;
+    mapArgsToBody: (args: unknown[]) => unknown;
+}): void;
+export declare function getHttpBridgeSpec(fnKey: string): HttpBridgeSpec | undefined;
+export declare function clearHttpBridgeRegistry(): void;
+export declare function runHttpBridgeInvoke(spec: HttpBridgeSpec, args: unknown[]): Promise<{
+    statusCode: number;
+    headers: Record<string, string>;
+    body: unknown;
+}>;
+//# sourceMappingURL=http-bridge-registry.d.ts.map

package/dist/http-bridge-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-bridge-registry.d.ts","sourceRoot":"","sources":["../src/http-bridge-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAI9C,MAAM,MAAM,cAAc,GAAG;IAC5B,GAAG,EAAE,OAAO,CAAA;IACZ,MAAM,EAAE,UAAU,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAA;CAC3C,CAAA;AAID;;;GAGG;AACH,wBAAgB,uBAAuB,CACtC,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAA;CAAE,GACpG,IAAI,CAeN;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE3E;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED,wBAAsB,mBAAmB,CACxC,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,OAAO,EAAE,GACb,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAQjF"}

package/dist/http-bridge-registry.js

@@ -0,0 +1,39 @@
+import { invokeExpressSynthetic } from './express.js';
+import { Registry } from './registry-state.js';
+const bridges = new Map();
+/**
+ * Map a catalogued `fnKey` to an in-process HTTP call (Pattern B). Requires an existing `Registry` entry.
+ * Side effect: sets `entry.invokeKind = 'http_synthetic'`.
+ */
+export function registerHttpBridgeRoute(app, spec) {
+    const e = Registry.get(spec.fnKey);
+    if (!e) {
+        throw new Error(`registerHttpBridgeRoute: unknown fnKey "${spec.fnKey}"`);
+    }
+    if (bridges.has(spec.fnKey)) {
+        throw new Error(`registerHttpBridgeRoute: duplicate registration for "${spec.fnKey}"`);
+    }
+    e.invokeKind = 'http_synthetic';
+    bridges.set(spec.fnKey, {
+        app,
+        method: spec.method,
+        path: spec.path,
+        mapArgsToBody: spec.mapArgsToBody,
+    });
+}
+export function getHttpBridgeSpec(fnKey) {
+    return bridges.get(fnKey);
+}
+export function clearHttpBridgeRegistry() {
+    bridges.clear();
+}
+export async function runHttpBridgeInvoke(spec, args) {
+    const body = spec.mapArgsToBody(args);
+    const out = await invokeExpressSynthetic(spec.app, {
+        method: spec.method,
+        path: spec.path,
+        body,
+    });
+    return { statusCode: out.statusCode, headers: out.headers, body: out.bodyJson };
+}
+//# sourceMappingURL=http-bridge-registry.js.map

package/dist/http-bridge-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-bridge-registry.js","sourceRoot":"","sources":["../src/http-bridge-registry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAS9C,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAA;AAEjD;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACtC,GAAY,EACZ,IAAsG;IAEtG,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAClC,IAAI,CAAC,CAAC,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,2CAA2C,IAAI,CAAC,KAAK,GAAG,CAAC,CAAA;IAC1E,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,wDAAwD,IAAI,CAAC,KAAK,GAAG,CAAC,CAAA;IACvF,CAAC;IACD,CAAC,CAAC,UAAU,GAAG,gBAAgB,CAAA;IAC/B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE;QACvB,GAAG;QACH,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,aAAa,EAAE,IAAI,CAAC,aAAa;KACjC,CAAC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC9C,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;AAC1B,CAAC;AAED,MAAM,UAAU,uBAAuB;IACtC,OAAO,CAAC,KAAK,EAAE,CAAA;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,IAAoB,EACpB,IAAe;IAEf,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;IACrC,MAAM,GAAG,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,GAAG,EAAE;QAClD,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI;KACJ,CAAC,CAAA;IACF,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAA;AAChF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+export { runASTScanner, type RunAstScannerOptions } from './ast/run-ast-scanner.js';
+export { mergeASTIntoRegistry } from './ast/merge-ast.js';
+export { getAllTsFiles, type GetAllTsFilesOptions } from './ast/get-all-ts-files.js';
+export { bootstrap, validateBootstrapFileWire, validateBootstrapStorage, type BootstrapOptions, type BootstrapResult, type BootstrapStorageOptions, type HostMinioOptions, type StorageAdapter, } from './bootstrap.js';
+export { Cat } from './decorators/cat.js';
+export { CatClass, CatService } from './decorators/cat-class.js';
+export { cat, catModule, type CatFunctionOptions } from './functional.js';
+export { createCorrelationMiddleware, invokeExpressSynthetic, pipelineIdForRoute, registerCatPipeline, type HttpMethod, } from './express.js';
+export { registerHttpBridgeRoute, clearHttpBridgeRegistry, type HttpBridgeSpec, } from './http-bridge-registry.js';
+export { extractArtifactsFromResult } from './artifact-helpers.js';
+export { exportRegistryOpenApi } from './openapi/registry-to-openapi.js';
+export { getInvokeTimeoutMs, setInvokeTimeoutMs, resetInvokeTimeoutMs, } from './invoke-runtime-config.js';
+export { resetReturnJsonSchemaValidators } from './validate-return-json-schema.js';
+export { parseHostMinioEndpoint, putBufferAndPresignGetUrl, type ParsedHostMinioClientConfig, type PutBufferAndPresignGetInput, } from './upload/host-minio-client.js';
+export { resetParamsJsonSchemaValidators, validateArgsAgainstParamsJsonSchema, } from './validate-params-json-schema.js';
+export { analyzeRelationships, buildTree, groupApiPipelines, resolveRelationships, } from './graph/relationships.js';
+export { createLogger, type Logger, type LogLevel } from './logger.js';
+export { Registry, ActiveContext, ApiContext, InstanceRegistry, LabelCapture, ErrorCapture, wsClients, broadcast, broadcastReturnResolved, broadcastErrorThrown, broadcastApiResponse, broadcastJobProgress, registerInstance, AutoInstanceRegistry, ClassConstructorRegistry, registerClassConstructor, registerReturnJsonSchema, registerParamsJsonSchema, resetInspectorState, clearExpressApiInvokeCapture, recordExpressApiInvokeCapture, readExpressApiInvokeCapture, setBroadcastSink, clearBroadcastSink, getInspectorBroadcastStore, runWithInspectorBroadcastTarget, readInspectorSocketIdFromHeaders, INSPECTOR_SOCKET_ID_HEADER, type InspectorBroadcastSource, type InspectorBroadcastStore, } from './registry-state.js';
+export { Return, Throw, ApiReturn, getShape, getType, type ApiPayload, type Labeled } from './return.js';
+export { normalizeReturnTypeForRpcCompare, typesMatchForRpc, peelOuterLabeled, splitTopLevelUnion, } from './type-string-normalize.js';
+export { extractParamNames, extractReturnLabels, extractThrowLabels, extractApiReturnLabels, getFunctionBody } from './source-utils.js';
+export { scanExpressCandidates, type ScanExpressCandidatesOptions } from './coverage/scan-express-candidates.js';
+export { scanReachableServices, type ScanReachableServicesOptions } from './coverage/scan-reachable-services.js';
+export { computeCoverageReport, type ComputeCoverageOptions, type CoverageReport } from './coverage/compute-coverage.js';
+export type { CandidateKind, CandidateRef, CoverageCandidates } from './coverage/types.js';
+export { startInspectorWebSocket, type InspectorWebSocketOptions, type InspectorWebSocketHandle } from './transport/ws-server.js';
+export { startRemoteInspectorBridge, type RemoteInspectorBridgeHandle, type RemoteInspectorBridgeOptions, } from './transport/remote-inspector-bridge.js';
+export { executeRPC } from './rpc.js';
+export { maybeSerializeRpcResult, resetRpcSerializationConfig, SerializeRpcResultError, serializeRpcResult, setRpcSerializationConfig, type RpcSerializationOptions, } from './serialize-rpc-result.js';
+export { configureInvokeRateLimit, registerInvokeAudit, registerPreInvoke, resetInvokePolicy, type InvokeAuditEvent, type InvokeTransport, type PreInvokeContext, type PreInvokeHook, } from './invoke-policy.js';
+export { InMemoryJobRegistry } from './jobs/in-memory-job-registry.js';
+export { resetSessionStore, sessionCreate, sessionStep } from './session-store.js';
+export { fetchFileUrl, isHostnameAllowed, type FetchFileUrlOptions, } from './upload/fetch-file-url.js';
+export { buildCatalogWireExtras, enrichRegistryParamsWithWireHints, normalizeExpressPayloadFilesForPlayground, publicFileUrlCatalogSlice, type CatalogWireExtras, type MaterializeServiceWireOptions, } from './upload/materialize.js';
+export { PROTOCOL_VERSION, type ApiResponseEntry, type BootstrapEvent, type CatMode, type JobProgressWireEvent, type ErrorEntry, type InspectorWireEvent, type QaFileWireMode, type QaMediaUploadTarget, type RegistryEntry, type RpcErrorDetail, type RpcExecutedEvent, type RpcArtifactRef, type RpcResponse, type SessionStateWireMessage, type ReturnEntry, type ReturnResolvedEvent, } from './types.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":"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"}

package/dist/index.js

@@ -0,0 +1,35 @@
+export { runASTScanner } from './ast/run-ast-scanner.js';
+export { mergeASTIntoRegistry } from './ast/merge-ast.js';
+export { getAllTsFiles } from './ast/get-all-ts-files.js';
+export { bootstrap, validateBootstrapFileWire, validateBootstrapStorage, } from './bootstrap.js';
+export { Cat } from './decorators/cat.js';
+export { CatClass, CatService } from './decorators/cat-class.js';
+export { cat, catModule } from './functional.js';
+export { createCorrelationMiddleware, invokeExpressSynthetic, pipelineIdForRoute, registerCatPipeline, } from './express.js';
+export { registerHttpBridgeRoute, clearHttpBridgeRegistry, } from './http-bridge-registry.js';
+export { extractArtifactsFromResult } from './artifact-helpers.js';
+export { exportRegistryOpenApi } from './openapi/registry-to-openapi.js';
+export { getInvokeTimeoutMs, setInvokeTimeoutMs, resetInvokeTimeoutMs, } from './invoke-runtime-config.js';
+export { resetReturnJsonSchemaValidators } from './validate-return-json-schema.js';
+export { parseHostMinioEndpoint, putBufferAndPresignGetUrl, } from './upload/host-minio-client.js';
+export { resetParamsJsonSchemaValidators, validateArgsAgainstParamsJsonSchema, } from './validate-params-json-schema.js';
+export { analyzeRelationships, buildTree, groupApiPipelines, resolveRelationships, } from './graph/relationships.js';
+export { createLogger } from './logger.js';
+export { Registry, ActiveContext, ApiContext, InstanceRegistry, LabelCapture, ErrorCapture, wsClients, broadcast, broadcastReturnResolved, broadcastErrorThrown, broadcastApiResponse, broadcastJobProgress, registerInstance, AutoInstanceRegistry, ClassConstructorRegistry, registerClassConstructor, registerReturnJsonSchema, registerParamsJsonSchema, resetInspectorState, clearExpressApiInvokeCapture, recordExpressApiInvokeCapture, readExpressApiInvokeCapture, setBroadcastSink, clearBroadcastSink, getInspectorBroadcastStore, runWithInspectorBroadcastTarget, readInspectorSocketIdFromHeaders, INSPECTOR_SOCKET_ID_HEADER, } from './registry-state.js';
+export { Return, Throw, ApiReturn, getShape, getType } from './return.js';
+export { normalizeReturnTypeForRpcCompare, typesMatchForRpc, peelOuterLabeled, splitTopLevelUnion, } from './type-string-normalize.js';
+export { extractParamNames, extractReturnLabels, extractThrowLabels, extractApiReturnLabels, getFunctionBody } from './source-utils.js';
+export { scanExpressCandidates } from './coverage/scan-express-candidates.js';
+export { scanReachableServices } from './coverage/scan-reachable-services.js';
+export { computeCoverageReport } from './coverage/compute-coverage.js';
+export { startInspectorWebSocket } from './transport/ws-server.js';
+export { startRemoteInspectorBridge, } from './transport/remote-inspector-bridge.js';
+export { executeRPC } from './rpc.js';
+export { maybeSerializeRpcResult, resetRpcSerializationConfig, SerializeRpcResultError, serializeRpcResult, setRpcSerializationConfig, } from './serialize-rpc-result.js';
+export { configureInvokeRateLimit, registerInvokeAudit, registerPreInvoke, resetInvokePolicy, } from './invoke-policy.js';
+export { InMemoryJobRegistry } from './jobs/in-memory-job-registry.js';
+export { resetSessionStore, sessionCreate, sessionStep } from './session-store.js';
+export { fetchFileUrl, isHostnameAllowed, } from './upload/fetch-file-url.js';
+export { buildCatalogWireExtras, enrichRegistryParamsWithWireHints, normalizeExpressPayloadFilesForPlayground, publicFileUrlCatalogSlice, } from './upload/materialize.js';
+export { PROTOCOL_VERSION, } from './types.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":"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"}

package/dist/invoke-policy.d.ts

@@ -0,0 +1,34 @@
+import type { RpcResponse } from './types.js';
+export type InvokeTransport = 'socket.io' | 'websocket';
+export type PreInvokeContext = {
+    fnKey: string;
+    args: unknown[];
+    socketId: string | undefined;
+    transport: InvokeTransport;
+    /** Present for Socket.IO `rpc:call` and embedded ws `RPC_CALL` when the client supplied a token. */
+    requestId?: string;
+    /** Socket.IO: `handshake.auth.token`. WebSocket: `?token=` query when present. */
+    authToken?: string | undefined;
+};
+export type PreInvokeHook = (ctx: PreInvokeContext) => void | RpcResponse | Promise<void | RpcResponse>;
+export type InvokeAuditEvent = {
+    fnKey: string;
+    requestId: string;
+    status: 'ok' | 'error';
+    transport: InvokeTransport;
+    socketId: string | undefined;
+    durationMs: number;
+};
+export type InvokeAuditHook = (evt: InvokeAuditEvent) => void | Promise<void>;
+export declare function registerPreInvoke(hook: PreInvokeHook): () => void;
+export declare function registerInvokeAudit(hook: InvokeAuditHook): () => void;
+export declare function configureInvokeRateLimit(opts: {
+    maxInvokesPerWindow: number;
+    windowMs: number;
+} | null): void;
+export declare function resetInvokePolicy(): void;
+export declare function runPreInvokes(ctx: PreInvokeContext): Promise<RpcResponse | undefined>;
+export declare function invokeRateLimitAllow(key: string): boolean;
+export declare function invokeRateLimitRetryAfterMs(key: string): number;
+export declare function invokeAudit(evt: InvokeAuditEvent): Promise<void>;
+//# sourceMappingURL=invoke-policy.d.ts.map

package/dist/invoke-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke-policy.d.ts","sourceRoot":"","sources":["../src/invoke-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,WAAW,CAAA;AAEvD,MAAM,MAAM,gBAAgB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,OAAO,EAAE,CAAA;IACf,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,SAAS,EAAE,eAAe,CAAA;IAC1B,oGAAoG;IACpG,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC9B,CAAA;AAED,MAAM,MAAM,aAAa,GAAG,CAC3B,GAAG,EAAE,gBAAgB,KACjB,IAAI,GAAG,WAAW,GAAG,OAAO,CAAC,IAAI,GAAG,WAAW,CAAC,CAAA;AAErD,MAAM,MAAM,gBAAgB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,IAAI,GAAG,OAAO,CAAA;IACtB,SAAS,EAAE,eAAe,CAAA;IAC1B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,UAAU,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAS7E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,IAAI,CAMjE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,IAAI,CAMrE;AAED,wBAAgB,wBAAwB,CACvC,IAAI,EAAE;IAAE,mBAAmB,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAC5D,IAAI,CAGN;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAQ3F;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAWzD;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK/D;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQtE"}

package/dist/invoke-policy.js

@@ -0,0 +1,72 @@
+const preHooks = [];
+const auditHooks = [];
+const rateBuckets = new Map();
+let rateOpts = null;
+export function registerPreInvoke(hook) {
+    preHooks.push(hook);
+    return () => {
+        const i = preHooks.indexOf(hook);
+        if (i >= 0)
+            preHooks.splice(i, 1);
+    };
+}
+export function registerInvokeAudit(hook) {
+    auditHooks.push(hook);
+    return () => {
+        const i = auditHooks.indexOf(hook);
+        if (i >= 0)
+            auditHooks.splice(i, 1);
+    };
+}
+export function configureInvokeRateLimit(opts) {
+    rateOpts = opts;
+    rateBuckets.clear();
+}
+export function resetInvokePolicy() {
+    preHooks.length = 0;
+    auditHooks.length = 0;
+    rateOpts = null;
+    rateBuckets.clear();
+}
+export async function runPreInvokes(ctx) {
+    for (const h of preHooks) {
+        const r = await h(ctx);
+        if (r && typeof r === 'object' && r.type === 'RPC_RESPONSE') {
+            return r;
+        }
+    }
+    return undefined;
+}
+export function invokeRateLimitAllow(key) {
+    if (!rateOpts)
+        return true;
+    const now = Date.now();
+    let b = rateBuckets.get(key);
+    if (!b || now >= b.resetAt) {
+        b = { count: 0, resetAt: now + rateOpts.windowMs };
+        rateBuckets.set(key, b);
+    }
+    if (b.count >= rateOpts.maxInvokesPerWindow)
+        return false;
+    b.count++;
+    return true;
+}
+export function invokeRateLimitRetryAfterMs(key) {
+    if (!rateOpts)
+        return 0;
+    const b = rateBuckets.get(key);
+    if (!b)
+        return 0;
+    return Math.max(0, b.resetAt - Date.now());
+}
+export async function invokeAudit(evt) {
+    for (const h of auditHooks) {
+        try {
+            await h(evt);
+        }
+        catch {
+            /* audit must not break invoke */
+        }
+    }
+}
+//# sourceMappingURL=invoke-policy.js.map

package/dist/invoke-policy.js.map

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

package/dist/invoke-runtime-config.d.ts

@@ -0,0 +1,4 @@
+export declare function getInvokeTimeoutMs(): number | undefined;
+export declare function setInvokeTimeoutMs(ms: number | undefined): void;
+export declare function resetInvokeTimeoutMs(): void;
+//# sourceMappingURL=invoke-runtime-config.d.ts.map

package/dist/invoke-runtime-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke-runtime-config.d.ts","sourceRoot":"","sources":["../src/invoke-runtime-config.ts"],"names":[],"mappings":"AAGA,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAEvD;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAK/D;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/dist/invoke-runtime-config.js

@@ -0,0 +1,15 @@
+/** Optional max duration for a single RPC handler `await` (host-wide). */
+let invokeTimeoutMs;
+export function getInvokeTimeoutMs() {
+    return invokeTimeoutMs;
+}
+export function setInvokeTimeoutMs(ms) {
+    if (ms !== undefined && (!Number.isFinite(ms) || ms <= 0)) {
+        throw new Error('invokeTimeoutMs must be a positive finite number when set');
+    }
+    invokeTimeoutMs = ms;
+}
+export function resetInvokeTimeoutMs() {
+    invokeTimeoutMs = undefined;
+}
+//# sourceMappingURL=invoke-runtime-config.js.map

package/dist/invoke-runtime-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke-runtime-config.js","sourceRoot":"","sources":["../src/invoke-runtime-config.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,IAAI,eAAmC,CAAA;AAEvC,MAAM,UAAU,kBAAkB;IACjC,OAAO,eAAe,CAAA;AACvB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EAAsB;IACxD,IAAI,EAAE,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAA;IAC7E,CAAC;IACD,eAAe,GAAG,EAAE,CAAA;AACrB,CAAC;AAED,MAAM,UAAU,oBAAoB;IACnC,eAAe,GAAG,SAAS,CAAA;AAC5B,CAAC"}

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

@@ -0,0 +1,21 @@
+export type JobStatus = 'queued' | 'running' | 'done' | 'failed';
+type JobRow = {
+    status: JobStatus;
+    percent: number;
+    result?: unknown;
+    detail?: string;
+};
+/**
+ * Minimal in-memory job registry for QA demos: creates ids, updates status, fans out `JOB_PROGRESS` on the inspector broadcast path.
+ */
+export declare class InMemoryJobRegistry {
+    private readonly jobs;
+    createJob(): string;
+    setRunning(jobId: string, percent?: number): void;
+    complete(jobId: string, result?: unknown): void;
+    fail(jobId: string, detail?: string): void;
+    get(jobId: string): JobRow | undefined;
+    private require;
+}
+export {};
+//# sourceMappingURL=in-memory-job-registry.d.ts.map