@gloocan/cat-inspector 0.1.1

package/dist/return.js

@@ -0,0 +1,107 @@
+import { ActiveContext, ApiContext, ErrorCapture, Registry, broadcastApiResponse, broadcastErrorThrown, broadcastReturnResolved, LabelCapture, recordExpressApiInvokeCapture, } from './registry-state.js';
+export function getType(value) {
+    if (value === null)
+        return 'null';
+    if (value === undefined)
+        return 'undefined';
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return 'Array<unknown>';
+        const types = [...new Set(value.map(getType))];
+        return `Array<${types.join(' | ')}>`;
+    }
+    const t = typeof value;
+    if (t === 'number')
+        return Number.isInteger(value) ? 'int' : 'float';
+    if (t !== 'object')
+        return t;
+    if (value instanceof Date)
+        return 'Date';
+    const name = value.constructor?.name;
+    if (name && name !== 'Object')
+        return name;
+    return 'object';
+}
+export function getShape(value, depth = 0) {
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return 'Array<unknown>';
+        // Prefer showing element *shape* (not just element type).
+        // If there are multiple different element shapes, show a union.
+        const shapes = [...new Set(value.map((v) => getShape(v, depth)))];
+        return `Array<${shapes.join(' | ')}>`;
+    }
+    const type = getType(value);
+    if (type !== 'object')
+        return type;
+    const indent = '  '.repeat(depth);
+    const entries = Object.entries(value);
+    const fields = entries
+        .map(([k, v]) => `${indent}  ${k}: ${getShape(v, depth + 1)}`)
+        .join('\n');
+    return `{\n${fields}\n${indent}}`;
+}
+/** Runtime behavior unchanged; inferred return type is `T` so catalog `declaredReturn` matches `getType`. */
+export function Return(label, value) {
+    const parentFn = ActiveContext.get();
+    if (parentFn && Registry.has(parentFn)) {
+        const meta = Registry.get(parentFn);
+        const entry = meta.returns.find((r) => r.label === label);
+        if (entry) {
+            entry.status = 'resolved';
+            entry.type = getShape(value);
+            LabelCapture.capture(label);
+            broadcastReturnResolved({
+                event: 'RETURN_RESOLVED',
+                fnKey: parentFn,
+                label,
+                type: entry.type,
+            });
+        }
+    }
+    return value;
+}
+export function Throw(label, error) {
+    const parentFn = ActiveContext.get();
+    if (parentFn && Registry.has(parentFn)) {
+        const meta = Registry.get(parentFn);
+        const entry = meta.errors.find((e) => e.label === label);
+        if (entry) {
+            entry.status = 'resolved';
+            entry.message = error.message;
+        }
+        ErrorCapture.capture(label, error);
+        broadcastErrorThrown({
+            event: 'ERROR_THROWN',
+            fnKey: parentFn,
+            label,
+            layer: 'expected',
+            message: error.message,
+            stack: error.stack ?? null,
+        });
+    }
+    throw error;
+}
+export function ApiReturn(label, statusCode, body) {
+    const endpointKey = ApiContext.get();
+    if (endpointKey && Registry.has(endpointKey)) {
+        const meta = Registry.get(endpointKey);
+        const entry = meta.apiResponses.find((r) => r.label === label);
+        if (entry) {
+            entry.status = 'resolved';
+            entry.statusCode = statusCode;
+            entry.bodyShape = getShape(body);
+        }
+        broadcastApiResponse({
+            event: 'API_RESPONSE',
+            endpointKey,
+            label,
+            statusCode,
+            bodyShape: getShape(body),
+            body,
+        });
+        recordExpressApiInvokeCapture(endpointKey, { label, statusCode, body });
+    }
+    return { statusCode, body };
+}
+//# sourceMappingURL=return.js.map

package/dist/return.js.map

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

package/dist/rpc.d.ts

@@ -0,0 +1,7 @@
+import type { RpcResponse } from './types.js';
+export declare function executeRPC(request: {
+    requestId: string;
+    fnKey: string;
+    args: unknown[];
+}): Promise<RpcResponse>;
+//# sourceMappingURL=rpc.d.ts.map

package/dist/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAiC,WAAW,EAAE,MAAM,YAAY,CAAA;AA+O5E,wBAAsB,UAAU,CAAC,OAAO,EAAE;IACzC,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,OAAO,EAAE,CAAA;CACf,GAAG,OAAO,CAAC,WAAW,CAAC,CAyLvB"}

package/dist/rpc.js

@@ -0,0 +1,287 @@
+import { performance } from 'node:perf_hooks';
+import { ActiveContext, ApiContext, ErrorCapture, LabelCapture, Registry, broadcast, resolveInstanceForClassName, } from './registry-state.js';
+import { getHttpBridgeSpec, runHttpBridgeInvoke } from './http-bridge-registry.js';
+import { getShape, getType } from './return.js';
+import { getInvokeTimeoutMs } from './invoke-runtime-config.js';
+import { getRpcSerializationConfig, maybeSerializeRpcResult } from './serialize-rpc-result.js';
+import { extractArtifactsFromResult } from './artifact-helpers.js';
+import { validateArgsAgainstParamsJsonSchema } from './validate-params-json-schema.js';
+import { validateResultAgainstReturnJsonSchema } from './validate-return-json-schema.js';
+function errResp(requestId, fnKey, label, message, start, layer, stack = null, code) {
+    const errCode = code ?? label;
+    return {
+        type: 'RPC_RESPONSE',
+        requestId,
+        fnKey,
+        status: 'error',
+        result: null,
+        returnType: 'error',
+        returnShape: null,
+        label,
+        duration: `${(performance.now() - start).toFixed(2)}ms`,
+        error: { message, stack, layer, code: errCode },
+    };
+}
+async function withInvokeTimeout(promise, ms) {
+    let timer;
+    const timeoutPromise = new Promise((_, reject) => {
+        timer = setTimeout(() => {
+            reject(new Error('RPC invoke exceeded invokeTimeoutMs'));
+        }, ms);
+    });
+    try {
+        return await Promise.race([promise, timeoutPromise]);
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+    }
+}
+function validateParamsSchemaIfConfigured(requestId, fnKey, entry, args, start) {
+    const ser = getRpcSerializationConfig();
+    if (!ser.validateParamsJsonSchema || !entry.paramsJsonSchema)
+        return null;
+    const v = validateArgsAgainstParamsJsonSchema(fnKey, entry.paramsJsonSchema, args);
+    if (v.ok)
+        return null;
+    return errResp(requestId, fnKey, 'INPUT_SCHEMA_INVALID', v.message, start, 'validation', null, 'INPUT_SCHEMA_INVALID');
+}
+function validateReturnSchemaIfConfigured(requestId, fnKey, entry, result, start) {
+    const ser = getRpcSerializationConfig();
+    if (!ser.enabled || !ser.validateReturnJsonSchema || !entry.returnJsonSchema)
+        return null;
+    const v = validateResultAgainstReturnJsonSchema(fnKey, entry.returnJsonSchema, result);
+    if (v.ok)
+        return null;
+    return errResp(requestId, fnKey, 'RETURN_SCHEMA_INVALID', v.message, start, 'validation', null, 'RETURN_SCHEMA_INVALID');
+}
+async function executeHttpBridgeRequest(request, entry, start) {
+    const { requestId, fnKey, args } = request;
+    const spec = getHttpBridgeSpec(fnKey);
+    if (!spec) {
+        return errResp(requestId, fnKey, 'HTTP_BRIDGE_NOT_CONFIGURED', `call registerHttpBridgeRoute for ${fnKey}`, start, 'validation', null, 'HTTP_BRIDGE_NOT_CONFIGURED');
+    }
+    LabelCapture.clear();
+    ErrorCapture.clear();
+    try {
+        const isApi = entry.mode === 'api';
+        if (isApi)
+            ApiContext.set(fnKey);
+        else
+            ActiveContext.push(fnKey);
+        const invokeMs = getInvokeTimeoutMs();
+        const httpP = runHttpBridgeInvoke(spec, args);
+        let httpOut;
+        try {
+            httpOut =
+                invokeMs !== undefined ? await withInvokeTimeout(httpP, invokeMs) : await httpP;
+        }
+        catch (timeoutErr) {
+            const msg = timeoutErr instanceof Error ? timeoutErr.message : 'timeout';
+            if (msg.includes('invokeTimeoutMs') || msg.includes('exceeded')) {
+                broadcast({
+                    event: 'RPC_EXECUTED',
+                    requestId,
+                    fnKey,
+                    label: 'INVOKE_TIMEOUT',
+                    status: 'error',
+                    duration: `${(performance.now() - start).toFixed(2)}ms`,
+                });
+                return errResp(requestId, fnKey, 'INVOKE_TIMEOUT', `handler exceeded invokeTimeoutMs (${invokeMs}ms)`, start, 'validation', null, 'INVOKE_TIMEOUT');
+            }
+            throw timeoutErr;
+        }
+        const rawResult = {
+            http: {
+                statusCode: httpOut.statusCode,
+                headers: httpOut.headers,
+                body: httpOut.body,
+            },
+        };
+        const serialized = maybeSerializeRpcResult(rawResult);
+        if (!serialized.ok) {
+            const duration = `${(performance.now() - start).toFixed(2)}ms`;
+            broadcast({
+                event: 'RPC_EXECUTED',
+                requestId,
+                fnKey,
+                label: 'RESULT_NOT_SERIALIZABLE',
+                status: 'error',
+                duration,
+            });
+            return errResp(requestId, fnKey, 'RESULT_NOT_SERIALIZABLE', serialized.message, start, 'validation', null, 'RESULT_NOT_SERIALIZABLE');
+        }
+        const result = serialized.value;
+        const schemaHit = validateReturnSchemaIfConfigured(requestId, fnKey, entry, result, start);
+        if (schemaHit)
+            return schemaHit;
+        const duration = `${(performance.now() - start).toFixed(2)}ms`;
+        broadcast({
+            event: 'RPC_EXECUTED',
+            requestId,
+            fnKey,
+            label: LabelCapture.read(),
+            status: 'ok',
+            duration,
+        });
+        return buildOkRpcResponse(requestId, fnKey, result, start);
+    }
+    catch (err) {
+        const duration = `${(performance.now() - start).toFixed(2)}ms`;
+        const captured = ErrorCapture.read();
+        const label = captured?.label ?? 'UNEXPECTED_ERROR';
+        const layer = captured ? 'expected' : 'unexpected';
+        broadcast({
+            event: 'RPC_EXECUTED',
+            requestId,
+            fnKey,
+            label,
+            status: 'error',
+            duration,
+        });
+        const message = err instanceof Error ? err.message : 'error';
+        const stack = err instanceof Error ? err.stack ?? null : null;
+        const errCode = layer === 'unexpected' ? 'UNEXPECTED_ERROR' : label;
+        return errResp(requestId, fnKey, label, message, start, layer, stack, errCode);
+    }
+    finally {
+        ApiContext.clear();
+        ActiveContext.pop();
+    }
+}
+function buildOkRpcResponse(requestId, fnKey, result, start) {
+    const artifacts = extractArtifactsFromResult(result);
+    const duration = `${(performance.now() - start).toFixed(2)}ms`;
+    const base = {
+        type: 'RPC_RESPONSE',
+        requestId,
+        fnKey,
+        status: 'ok',
+        result,
+        returnType: getType(result),
+        returnShape: getShape(result),
+        label: LabelCapture.read(),
+        duration,
+        error: null,
+    };
+    if (artifacts)
+        base.artifacts = artifacts;
+    return base;
+}
+export async function executeRPC(request) {
+    const { requestId, fnKey, args } = request;
+    const start = performance.now();
+    if (!fnKey.includes('.')) {
+        return errResp(requestId, fnKey, 'INVALID_FN_KEY', 'must be ClassName.methodName', start, 'validation');
+    }
+    if (!Registry.has(fnKey)) {
+        return errResp(requestId, fnKey, 'FN_NOT_FOUND', `Not found. Available: ${[...Registry.keys()].join(', ')}`, start, 'validation');
+    }
+    const entry = Registry.get(fnKey);
+    const expected = entry.params.length;
+    if (args.length !== expected) {
+        return errResp(requestId, fnKey, 'WRONG_ARG_COUNT', `Expected ${expected} args, got ${args.length}`, start, 'validation');
+    }
+    const paramsSchemaHit = validateParamsSchemaIfConfigured(requestId, fnKey, entry, args, start);
+    if (paramsSchemaHit)
+        return paramsSchemaHit;
+    if (entry.invokeKind === 'http_synthetic') {
+        return await executeHttpBridgeRequest({ requestId, fnKey, args }, entry, start);
+    }
+    const [className, methodName] = fnKey.split('.');
+    const maybeFn = entry.style === 'function'
+        ? entry.originalFn
+        : // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            resolveInstanceForClassName(className)?.[methodName];
+    if (typeof maybeFn !== 'function') {
+        if (entry.style === 'function') {
+            return errResp(requestId, fnKey, 'NOT_A_FUNCTION', `${fnKey} not callable`, start, 'validation');
+        }
+        if (!resolveInstanceForClassName(className)) {
+            return errResp(requestId, fnKey, 'NO_INSTANCE', `No instance for ${className}. Ensure the class method is decorated with @Cat (constructor auto-registered) or call registerInstance().`, start, 'validation');
+        }
+        return errResp(requestId, fnKey, 'NOT_A_FUNCTION', `${methodName} not callable on ${className}`, start, 'validation');
+    }
+    LabelCapture.clear();
+    ErrorCapture.clear();
+    try {
+        const isApi = entry.mode === 'api';
+        if (isApi)
+            ApiContext.set(fnKey);
+        else
+            ActiveContext.push(fnKey);
+        const invokeMs = getInvokeTimeoutMs();
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+        const invokePromise = maybeFn(...args);
+        let rawResult;
+        try {
+            rawResult =
+                invokeMs !== undefined ? await withInvokeTimeout(invokePromise, invokeMs) : await invokePromise;
+        }
+        catch (timeoutErr) {
+            const msg = timeoutErr instanceof Error ? timeoutErr.message : 'timeout';
+            if (msg.includes('invokeTimeoutMs') || msg.includes('exceeded')) {
+                broadcast({
+                    event: 'RPC_EXECUTED',
+                    requestId,
+                    fnKey,
+                    label: 'INVOKE_TIMEOUT',
+                    status: 'error',
+                    duration: `${(performance.now() - start).toFixed(2)}ms`,
+                });
+                return errResp(requestId, fnKey, 'INVOKE_TIMEOUT', `handler exceeded invokeTimeoutMs (${invokeMs}ms)`, start, 'validation', null, 'INVOKE_TIMEOUT');
+            }
+            throw timeoutErr;
+        }
+        const serialized = maybeSerializeRpcResult(rawResult);
+        if (!serialized.ok) {
+            const duration = `${(performance.now() - start).toFixed(2)}ms`;
+            broadcast({
+                event: 'RPC_EXECUTED',
+                requestId,
+                fnKey,
+                label: 'RESULT_NOT_SERIALIZABLE',
+                status: 'error',
+                duration,
+            });
+            return errResp(requestId, fnKey, 'RESULT_NOT_SERIALIZABLE', serialized.message, start, 'validation', null, 'RESULT_NOT_SERIALIZABLE');
+        }
+        const result = serialized.value;
+        const schemaHit = validateReturnSchemaIfConfigured(requestId, fnKey, entry, result, start);
+        if (schemaHit)
+            return schemaHit;
+        const duration = `${(performance.now() - start).toFixed(2)}ms`;
+        broadcast({
+            event: 'RPC_EXECUTED',
+            requestId,
+            fnKey,
+            label: LabelCapture.read(),
+            status: 'ok',
+            duration,
+        });
+        return buildOkRpcResponse(requestId, fnKey, result, start);
+    }
+    catch (err) {
+        const duration = `${(performance.now() - start).toFixed(2)}ms`;
+        const captured = ErrorCapture.read();
+        const label = captured?.label ?? 'UNEXPECTED_ERROR';
+        const layer = captured ? 'expected' : 'unexpected';
+        broadcast({
+            event: 'RPC_EXECUTED',
+            requestId,
+            fnKey,
+            label,
+            status: 'error',
+            duration,
+        });
+        const message = err instanceof Error ? err.message : 'error';
+        const stack = err instanceof Error ? err.stack ?? null : null;
+        const errCode = layer === 'unexpected' ? 'UNEXPECTED_ERROR' : label;
+        return errResp(requestId, fnKey, label, message, start, layer, stack, errCode);
+    }
+    finally {
+        ApiContext.clear();
+        ActiveContext.pop();
+    }
+}
+//# sourceMappingURL=rpc.js.map

package/dist/rpc.js.map

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

package/dist/serialize-rpc-result.d.ts

@@ -0,0 +1,38 @@
+export declare class SerializeRpcResultError extends Error {
+    readonly code: "RESULT_NOT_SERIALIZABLE";
+    constructor(message: string);
+}
+export interface RpcSerializationOptions {
+    /** When true, `serializeRpcResult` runs; when false, callers should skip and pass raw values. */
+    enabled: boolean;
+    /** Max UTF-8 size of `JSON.stringify(serialized)`; default 4 MiB when enabled. */
+    maxUtf8Bytes?: number;
+    /**
+     * When true (and `enabled`), after serialization validate `result` against `RegistryEntry.returnJsonSchema` if present.
+     */
+    validateReturnJsonSchema?: boolean;
+    /**
+     * When true, before invoke validate `args` against `RegistryEntry.paramsJsonSchema` if present (does not require `enabled`).
+     */
+    validateParamsJsonSchema?: boolean;
+}
+export declare function getRpcSerializationConfig(): Readonly<RpcSerializationOptions>;
+export declare function setRpcSerializationConfig(next: Partial<RpcSerializationOptions>): void;
+export declare function resetRpcSerializationConfig(): void;
+/**
+ * Deep-clone a value into JSON-safe plain data: `null`, number, string, boolean,
+ * arrays of the same, and plain objects with string keys.
+ * - `bigint` → decimal string
+ * - `Date` → ISO string
+ * - `undefined` (nested) omitted in objects; root `undefined` → `null`
+ * Rejects: functions, symbols, `Map`/`Set`/class instances, cycles.
+ */
+export declare function maybeSerializeRpcResult(raw: unknown): {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    message: string;
+};
+export declare function serializeRpcResult(value: unknown): unknown;
+//# sourceMappingURL=serialize-rpc-result.d.ts.map

package/dist/serialize-rpc-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize-rpc-result.d.ts","sourceRoot":"","sources":["../src/serialize-rpc-result.ts"],"names":[],"mappings":"AAEA,qBAAa,uBAAwB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,EAAG,yBAAyB,CAAS;gBACtC,OAAO,EAAE,MAAM;CAI3B;AAED,MAAM,WAAW,uBAAuB;IACvC,iGAAiG;IACjG,OAAO,EAAE,OAAO,CAAA;IAChB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAA;IAClC;;OAEG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAA;CAClC;AAID,wBAAgB,yBAAyB,IAAI,QAAQ,CAAC,uBAAuB,CAAC,CAE7E;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAAG,IAAI,CAYtF;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAOlD;AAQD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACtC,GAAG,EAAE,OAAO,GACV;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAU/D;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAoB1D"}

package/dist/serialize-rpc-result.js

@@ -0,0 +1,132 @@
+const textEncoder = new TextEncoder();
+export class SerializeRpcResultError extends Error {
+    code = 'RESULT_NOT_SERIALIZABLE';
+    constructor(message) {
+        super(message);
+        this.name = 'SerializeRpcResultError';
+    }
+}
+let globalSerialization = { enabled: false };
+export function getRpcSerializationConfig() {
+    return { ...globalSerialization };
+}
+export function setRpcSerializationConfig(next) {
+    globalSerialization = {
+        ...globalSerialization,
+        ...next,
+    };
+    if (globalSerialization.enabled) {
+        if (globalSerialization.maxUtf8Bytes === undefined) {
+            globalSerialization.maxUtf8Bytes = 4 * 1024 * 1024;
+        }
+    }
+    else {
+        globalSerialization.maxUtf8Bytes = undefined;
+    }
+}
+export function resetRpcSerializationConfig() {
+    globalSerialization = {
+        enabled: false,
+        maxUtf8Bytes: undefined,
+        validateReturnJsonSchema: false,
+        validateParamsJsonSchema: false,
+    };
+}
+function isPlainObject(value) {
+    if (Array.isArray(value))
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === null || proto === Object.prototype;
+}
+/**
+ * Deep-clone a value into JSON-safe plain data: `null`, number, string, boolean,
+ * arrays of the same, and plain objects with string keys.
+ * - `bigint` → decimal string
+ * - `Date` → ISO string
+ * - `undefined` (nested) omitted in objects; root `undefined` → `null`
+ * Rejects: functions, symbols, `Map`/`Set`/class instances, cycles.
+ */
+export function maybeSerializeRpcResult(raw) {
+    if (!globalSerialization.enabled)
+        return { ok: true, value: raw };
+    try {
+        return { ok: true, value: serializeRpcResult(raw) };
+    }
+    catch (e) {
+        return {
+            ok: false,
+            message: e instanceof SerializeRpcResultError ? e.message : String(e),
+        };
+    }
+}
+export function serializeRpcResult(value) {
+    if (value === undefined)
+        return null;
+    const seen = new WeakSet();
+    const out = walk(value, seen);
+    const max = globalSerialization.maxUtf8Bytes ?? 4 * 1024 * 1024;
+    let encoded;
+    try {
+        encoded = JSON.stringify(out);
+    }
+    catch (e) {
+        throw new SerializeRpcResultError(e instanceof Error ? e.message : 'JSON.stringify failed after normalization');
+    }
+    const bytes = textEncoder.encode(encoded).length;
+    if (bytes > max) {
+        throw new SerializeRpcResultError(`serialized RPC result exceeds maxUtf8Bytes (${bytes} > ${max})`);
+    }
+    return out;
+}
+function walk(value, seen) {
+    if (value === null)
+        return null;
+    if (value === undefined)
+        return null;
+    const t = typeof value;
+    if (t === 'bigint')
+        return String(value);
+    if (t === 'number' || t === 'boolean' || t === 'string')
+        return value;
+    if (t === 'function' || t === 'symbol') {
+        throw new SerializeRpcResultError(`unsupported type for JSON RPC result: ${t}`);
+    }
+    if (value instanceof Date)
+        return value.toISOString();
+    if (Array.isArray(value)) {
+        if (seen.has(value))
+            throw new SerializeRpcResultError('circular reference in RPC result');
+        seen.add(value);
+        try {
+            return value.map((item) => walk(item, seen));
+        }
+        finally {
+            seen.delete(value);
+        }
+    }
+    if (typeof value === 'object') {
+        if (!isPlainObject(value)) {
+            const ctor = value.constructor?.name;
+            throw new SerializeRpcResultError(`non-plain object in RPC result${ctor ? ` (${ctor})` : ''}; return a DTO or plain object`);
+        }
+        if (seen.has(value))
+            throw new SerializeRpcResultError('circular reference in RPC result');
+        seen.add(value);
+        try {
+            const obj = value;
+            const out = {};
+            for (const k of Object.keys(obj)) {
+                const v = obj[k];
+                if (v === undefined)
+                    continue;
+                out[k] = walk(v, seen);
+            }
+            return out;
+        }
+        finally {
+            seen.delete(value);
+        }
+    }
+    throw new SerializeRpcResultError(`unsupported value for JSON RPC result: ${t}`);
+}
+//# sourceMappingURL=serialize-rpc-result.js.map

package/dist/serialize-rpc-result.js.map

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

package/dist/session-store.d.ts

@@ -0,0 +1,9 @@
+export declare function resetSessionStore(): void;
+export declare function sessionCreate(sessionKey?: string): {
+    sessionId: string;
+};
+export declare function sessionStep(sessionId: string, step: string, payload: unknown): {
+    sessionId: string;
+    data: Record<string, unknown>;
+};
+//# sourceMappingURL=session-store.d.ts.map

package/dist/session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../src/session-store.ts"],"names":[],"mappings":"AAMA,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED,wBAAgB,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAIxE;AAED,wBAAgB,WAAW,CAC1B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,GACd;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAOtD"}

package/dist/session-store.js

@@ -0,0 +1,19 @@
+import { randomUUID } from 'node:crypto';
+const sessions = new Map();
+export function resetSessionStore() {
+    sessions.clear();
+}
+export function sessionCreate(sessionKey) {
+    const sessionId = randomUUID();
+    sessions.set(sessionId, { sessionKey, data: {} });
+    return { sessionId };
+}
+export function sessionStep(sessionId, step, payload) {
+    const row = sessions.get(sessionId);
+    if (!row) {
+        throw new Error(`SESSION_NOT_FOUND: ${sessionId}`);
+    }
+    row.data[step] = payload === undefined ? true : payload;
+    return { sessionId, data: { ...row.data } };
+}
+//# sourceMappingURL=session-store.js.map

package/dist/session-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../src/session-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAIxC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAsB,CAAA;AAE9C,MAAM,UAAU,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,UAAmB;IAChD,MAAM,SAAS,GAAG,UAAU,EAAE,CAAA;IAC9B,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAA;IACjD,OAAO,EAAE,SAAS,EAAE,CAAA;AACrB,CAAC;AAED,MAAM,UAAU,WAAW,CAC1B,SAAiB,EACjB,IAAY,EACZ,OAAgB;IAEhB,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IACnC,IAAI,CAAC,GAAG,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAA;IACnD,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAA;IACvD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,EAAE,CAAA;AAC5C,CAAC"}