@gloocan/cat-inspector 0.1.1

package/dist/source-utils.d.ts

@@ -0,0 +1,19 @@
+/** Parameter names from Function#toString — no execution */
+export declare function extractParamNames(fn: Function): string[];
+export declare function getFunctionBody(fn: Function): string;
+/**
+ * Regex scan for Return("LABEL", ...) — no execution.
+ * Supports direct `Return("L", v)` and bundler comma form `(0,Return)("L", v)`.
+ */
+export declare function extractReturnLabels(body: string): string[];
+/**
+ * Regex scan for Throw("LABEL", ...) — no execution.
+ * Supports direct `Throw("L", err)` and bundler comma form `(0,Throw)("L", err)`.
+ */
+export declare function extractThrowLabels(body: string): string[];
+/**
+ * Regex scan for ApiReturn("LABEL", ...) — no execution.
+ * Supports direct `ApiReturn("L", ...)` and bundler comma form `(0,ApiReturn)("L", ...)`.
+ */
+export declare function extractApiReturnLabels(body: string): string[];
+//# sourceMappingURL=source-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-utils.d.ts","sourceRoot":"","sources":["../src/source-utils.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,EAAE,CASxD;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAMpD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ1D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAQzD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ7D"}

package/dist/source-utils.js

@@ -0,0 +1,65 @@
+/** Parameter names from Function#toString — no execution */
+export function extractParamNames(fn) {
+    const src = fn.toString();
+    const match = /\(([^)]*)\)/.exec(src);
+    if (!match || !match[1].trim())
+        return [];
+    return match[1]
+        .split(',')
+        .map((p) => p.trim().split(':')[0]?.replace(/=.+/, '').trim())
+        .filter((p) => Boolean(p));
+}
+export function getFunctionBody(fn) {
+    const src = fn.toString();
+    const start = src.indexOf('{');
+    const end = src.lastIndexOf('}');
+    if (start === -1 || end === -1)
+        return '';
+    return src.slice(start + 1, end).trim();
+}
+/**
+ * Regex scan for Return("LABEL", ...) — no execution.
+ * Supports direct `Return("L", v)` and bundler comma form `(0,Return)("L", v)`.
+ */
+export function extractReturnLabels(body) {
+    const labels = [];
+    const direct = /Return\w*\(\s*["'`](\w+)["'`]/g;
+    const commaCallee = /Return\w*\)\s*\(\s*["'`](\w+)["'`]/g;
+    let match;
+    while ((match = direct.exec(body)) !== null)
+        labels.push(match[1]);
+    while ((match = commaCallee.exec(body)) !== null)
+        labels.push(match[1]);
+    return labels;
+}
+/**
+ * Regex scan for Throw("LABEL", ...) — no execution.
+ * Supports direct `Throw("L", err)` and bundler comma form `(0,Throw)("L", err)`.
+ */
+export function extractThrowLabels(body) {
+    const labels = [];
+    const direct = /Throw\w*\(\s*["'`](\w+)["'`]/g;
+    const commaCallee = /Throw\w*\)\s*\(\s*["'`](\w+)["'`]/g;
+    let match;
+    while ((match = direct.exec(body)) !== null)
+        labels.push(match[1]);
+    while ((match = commaCallee.exec(body)) !== null)
+        labels.push(match[1]);
+    return labels;
+}
+/**
+ * Regex scan for ApiReturn("LABEL", ...) — no execution.
+ * Supports direct `ApiReturn("L", ...)` and bundler comma form `(0,ApiReturn)("L", ...)`.
+ */
+export function extractApiReturnLabels(body) {
+    const labels = [];
+    const direct = /ApiReturn\w*\(\s*["'`](\w+)["'`]/g;
+    const commaCallee = /ApiReturn\w*\)\s*\(\s*["'`](\w+)["'`]/g;
+    let match;
+    while ((match = direct.exec(body)) !== null)
+        labels.push(match[1]);
+    while ((match = commaCallee.exec(body)) !== null)
+        labels.push(match[1]);
+    return labels;
+}
+//# sourceMappingURL=source-utils.js.map

package/dist/source-utils.js.map

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

package/dist/transport/remote-bridge-cli.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=remote-bridge-cli.d.ts.map

package/dist/transport/remote-bridge-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-bridge-cli.d.ts","sourceRoot":"","sources":["../../src/transport/remote-bridge-cli.ts"],"names":[],"mappings":""}

package/dist/transport/remote-bridge-cli.js

@@ -0,0 +1,12 @@
+/**
+ * Standalone bridge: `TARGET_WS_URL` → listen on `BRIDGE_PORT` (default 9339).
+ * Run after `npm run build` from package root:
+ * `node dist/transport/remote-bridge-cli.js`
+ */
+import { startRemoteInspectorBridge } from './remote-inspector-bridge.js';
+const listenPort = Number(process.env.BRIDGE_PORT ?? '9339');
+const targetWsUrl = process.env.TARGET_WS_URL ?? 'ws://127.0.0.1:9234';
+const handle = await startRemoteInspectorBridge({ listenPort, targetWsUrl });
+// eslint-disable-next-line no-console
+console.log(`cat-inspector remote bridge listening ws://127.0.0.1:${handle.port} → ${targetWsUrl}`);
+//# sourceMappingURL=remote-bridge-cli.js.map

package/dist/transport/remote-bridge-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-bridge-cli.js","sourceRoot":"","sources":["../../src/transport/remote-bridge-cli.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAA;AAEzE,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,MAAM,CAAC,CAAA;AAC5D,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,qBAAqB,CAAA;AAEtE,MAAM,MAAM,GAAG,MAAM,0BAA0B,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAA;AAC5E,sCAAsC;AACtC,OAAO,CAAC,GAAG,CACV,wDAAwD,MAAM,CAAC,IAAI,MAAM,WAAW,EAAE,CACtF,CAAA"}

package/dist/transport/remote-inspector-bridge.d.ts

@@ -0,0 +1,18 @@
+export interface RemoteInspectorBridgeOptions {
+    /** Local port QA WebSocket clients connect to. */
+    listenPort: number;
+    listenHost?: string;
+    /** Target embedded inspector, e.g. `ws://127.0.0.1:9234?token=secret` */
+    targetWsUrl: string;
+}
+export interface RemoteInspectorBridgeHandle {
+    readonly port: number;
+    close(): Promise<void>;
+}
+/**
+ * Minimal WebSocket **duplex proxy** between a QA client and an existing
+ * `startInspectorWebSocket` endpoint. Forwards JSON frames as-is (`BOOTSTRAP`,
+ * `RPC_CALL` / `RPC_RESPONSE`, `QA_UPLOAD_*`, sessions, coverage, etc.).
+ */
+export declare function startRemoteInspectorBridge(options: RemoteInspectorBridgeOptions): Promise<RemoteInspectorBridgeHandle>;
+//# sourceMappingURL=remote-inspector-bridge.d.ts.map

package/dist/transport/remote-inspector-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-inspector-bridge.d.ts","sourceRoot":"","sources":["../../src/transport/remote-inspector-bridge.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,4BAA4B;IAC5C,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACzC,OAAO,EAAE,4BAA4B,GACnC,OAAO,CAAC,2BAA2B,CAAC,CA+DtC"}

package/dist/transport/remote-inspector-bridge.js

@@ -0,0 +1,71 @@
+import WebSocket, { WebSocketServer } from 'ws';
+/**
+ * Minimal WebSocket **duplex proxy** between a QA client and an existing
+ * `startInspectorWebSocket` endpoint. Forwards JSON frames as-is (`BOOTSTRAP`,
+ * `RPC_CALL` / `RPC_RESPONSE`, `QA_UPLOAD_*`, sessions, coverage, etc.).
+ */
+export function startRemoteInspectorBridge(options) {
+    const host = options.listenHost ?? '127.0.0.1';
+    return new Promise((resolve, reject) => {
+        const wss = new WebSocketServer({ host, port: options.listenPort });
+        wss.on('connection', (client) => {
+            const upstream = new WebSocket(options.targetWsUrl);
+            const pending = [];
+            const flushPending = () => {
+                if (upstream.readyState !== WebSocket.OPEN)
+                    return;
+                for (const chunk of pending)
+                    upstream.send(chunk);
+                pending.length = 0;
+            };
+            client.on('message', (data) => {
+                const buf = Buffer.isBuffer(data) ? data : Buffer.from(data);
+                if (upstream.readyState === WebSocket.OPEN)
+                    upstream.send(buf);
+                else
+                    pending.push(buf);
+            });
+            upstream.on('open', () => {
+                flushPending();
+                upstream.on('message', (data) => {
+                    if (client.readyState === WebSocket.OPEN)
+                        client.send(data);
+                });
+            });
+            const shutdownPair = () => {
+                try {
+                    client.close();
+                }
+                catch {
+                    /* ignore */
+                }
+                try {
+                    upstream.close();
+                }
+                catch {
+                    /* ignore */
+                }
+            };
+            client.on('close', shutdownPair);
+            client.on('error', shutdownPair);
+            upstream.on('close', shutdownPair);
+            upstream.on('error', shutdownPair);
+        });
+        wss.on('listening', () => {
+            const addr = wss.address();
+            resolve({
+                port: addr.port,
+                close: () => new Promise((res, rej) => {
+                    wss.close((err) => {
+                        if (err)
+                            rej(err);
+                        else
+                            res();
+                    });
+                }),
+            });
+        });
+        wss.on('error', reject);
+    });
+}
+//# sourceMappingURL=remote-inspector-bridge.js.map

package/dist/transport/remote-inspector-bridge.js.map

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

package/dist/transport/socket-io-playground.d.ts

@@ -0,0 +1,78 @@
+import type { Server, Socket } from 'socket.io';
+import { type BootstrapOptions } from '../bootstrap.js';
+import { createExpressPlaygroundMocks, type ExpressPlaygroundPayload } from '../express-playground-mocks.js';
+import { type BootstrapStorageOptions } from '../bootstrap.js';
+import type { RpcSerializationOptions } from '../serialize-rpc-result.js';
+import { type QaFileWireMode, type QaMediaUploadTarget, type RegistryEntry, type RpcResponse } from '../types.js';
+import type { FetchFileUrlOptions } from '../upload/fetch-file-url.js';
+export declare const INSPECTOR_BROADCAST_EVENT = "inspector:broadcast";
+export { INSPECTOR_SOCKET_ID_HEADER } from '../registry-state.js';
+export type AttachCatRPCOptions = {
+    scanRoots: string[];
+    bootstrap?: Partial<Pick<BootstrapOptions, 'importEntryUrls' | 'getAllTsFilesOptions' | 'compilerOptions' | 'logLevel' | 'redactBodies' | 'expandParamTypes' | 'expandParamTypesOptions' | 'rpcSerialization' | 'storage' | 'invokeTimeoutMs' | 'qaFileWire' | 'qaMediaUpload' | 'fileUrl' | 'qaMediaUploadHostUploadUrl' | 'hostMinio' | 'upload'>>;
+    /** Merged into `bootstrap({ ... })` for catalog build; validated with `artifactThresholdBytes`. */
+    storage?: BootstrapStorageOptions;
+    /** Token bucket per Socket.IO `socket.id`. */
+    invokeRateLimit?: {
+        maxInvokesPerWindow: number;
+        windowMs: number;
+    };
+    /** Applied with catalog `bootstrap()` merge (same as `bootstrap.rpcSerialization`). */
+    rpcSerialization?: RpcSerializationOptions;
+    /** Same as `bootstrap.invokeTimeoutMs` when using embedded catalog bootstrap. */
+    invokeTimeoutMs?: number;
+    serverId?: string;
+    /** When false, HTTP-sourced inspector never reaches Socket.IO */
+    isDevelopment?: boolean;
+    forwardBroadcast?: boolean;
+    emitUnscopedBroadcasts?: boolean;
+    createExpressMocks?: typeof createExpressPlaygroundMocks;
+    hooks?: AttachCatRPCHooks;
+    upload?: {
+        enabled?: boolean;
+        maxSizeBytes?: number;
+        idleTimeoutMs?: number;
+    };
+    /**
+     * When set and `isDevelopment` is false, RPC invokes require Socket.IO
+     * `auth.token` to match this string (see protocol-client / cat-demo web profiles).
+     */
+    rpcAuth?: {
+        token: string;
+    };
+    /**
+     * When set, merged into each emitted `catalog:bootstrap` (not part of AST fingerprint cache).
+     * Host should pass from env; never read env inside the SDK.
+     */
+    secretApiKey?: string;
+    /** Overrides / supplements `bootstrap` for catalog + RPC materialize (same semantics as embedded WS). */
+    qaFileWire?: {
+        mode?: QaFileWireMode;
+    };
+    qaMediaUpload?: {
+        target: QaMediaUploadTarget;
+    };
+    fileUrl?: FetchFileUrlOptions;
+    qaMediaUploadHostUploadUrl?: string;
+};
+export type AttachCatRPCHooks = {
+    onConnection?: (socket: Socket) => void | Promise<void>;
+    onBeforeRpc?: (socket: Socket, raw: unknown) => Promise<RpcResponse | undefined>;
+    onAfterRpc?: (socket: Socket, requestId: string, response: RpcResponse) => void;
+    onCatalogError?: (socket: Socket, error: unknown) => void;
+};
+export type AttachCatRPCHandle = {
+    detach: () => void;
+};
+export declare function invokeExpressPlayground(requestId: string, fnKey: string, expressPayload: ExpressPlaygroundPayload, createMocks: typeof createExpressPlaygroundMocks): Promise<RpcResponse>;
+export declare function resolveExpressCallableForInvoke(requestId: string, fnKey: string, entry: RegistryEntry, start: number): {
+    callable: (...args: unknown[]) => unknown;
+    callThis: unknown;
+} | {
+    error: RpcResponse;
+};
+/**
+ * Register Socket.IO catalog + RPC playground handlers and optional broadcast bridge.
+ */
+export declare function attachCatRPC(io: Server, options: AttachCatRPCOptions): AttachCatRPCHandle;
+//# sourceMappingURL=socket-io-playground.d.ts.map

package/dist/transport/socket-io-playground.d.ts.map

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