@gloocan/cat-inspector 0.1.1

package/dist/artifact-helpers.d.ts

@@ -0,0 +1,4 @@
+import type { RpcArtifactRef } from './types.js';
+/** Normalize artifact-like objects nested under `result` into `RpcResponse.artifacts` (optional UX helper). */
+export declare function extractArtifactsFromResult(result: unknown): RpcArtifactRef[] | undefined;
+//# sourceMappingURL=artifact-helpers.d.ts.map

package/dist/artifact-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-helpers.d.ts","sourceRoot":"","sources":["../src/artifact-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,+GAA+G;AAC/G,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,OAAO,GAAG,cAAc,EAAE,GAAG,SAAS,CAgBxF"}

package/dist/artifact-helpers.js

@@ -0,0 +1,21 @@
+/** Normalize artifact-like objects nested under `result` into `RpcResponse.artifacts` (optional UX helper). */
+export function extractArtifactsFromResult(result) {
+    if (!result || typeof result !== 'object')
+        return undefined;
+    const r = result;
+    const ex = r.express;
+    if (ex && typeof ex === 'object' && 'handlerReturn' in ex) {
+        return extractArtifactsFromResult(ex.handlerReturn);
+    }
+    const raw = r.artifacts;
+    if (!Array.isArray(raw))
+        return undefined;
+    const out = [];
+    for (const item of raw) {
+        if (item && typeof item === 'object' && typeof item.kind === 'string') {
+            out.push(item);
+        }
+    }
+    return out.length > 0 ? out : undefined;
+}
+//# sourceMappingURL=artifact-helpers.js.map

package/dist/artifact-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-helpers.js","sourceRoot":"","sources":["../src/artifact-helpers.ts"],"names":[],"mappings":"AAEA,+GAA+G;AAC/G,MAAM,UAAU,0BAA0B,CAAC,MAAe;IACzD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IAC3D,MAAM,CAAC,GAAG,MAAiC,CAAA;IAC3C,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAA;IACpB,IAAI,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,eAAe,IAAI,EAAE,EAAE,CAAC;QAC3D,OAAO,0BAA0B,CAAE,EAAkC,CAAC,aAAa,CAAC,CAAA;IACrF,CAAC;IACD,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,CAAA;IACvB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAA;IACzC,MAAM,GAAG,GAAqB,EAAE,CAAA;IAChC,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;QACxB,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAQ,IAAuB,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3F,GAAG,CAAC,IAAI,CAAC,IAAsB,CAAC,CAAA;QACjC,CAAC;IACF,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAA;AACxC,CAAC"}

package/dist/ast/get-all-ts-files.d.ts

@@ -0,0 +1,5 @@
+export interface GetAllTsFilesOptions {
+    skipDirNames?: Set<string>;
+}
+export declare function getAllTsFiles(dir: string, options?: GetAllTsFilesOptions): string[];
+//# sourceMappingURL=get-all-ts-files.d.ts.map

package/dist/ast/get-all-ts-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-all-ts-files.d.ts","sourceRoot":"","sources":["../../src/ast/get-all-ts-files.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,oBAAoB;IACpC,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAC1B;AAED,wBAAgB,aAAa,CAC5B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,oBAAyB,GAChC,MAAM,EAAE,CAwBV"}

package/dist/ast/get-all-ts-files.js

@@ -0,0 +1,36 @@
+import fs from 'node:fs';
+import path from 'node:path';
+const DEFAULT_SKIP = new Set([
+    'node_modules',
+    'dist',
+    '.git',
+    'coverage',
+    '.vite',
+]);
+export function getAllTsFiles(dir, options = {}) {
+    const skip = options.skipDirNames ?? DEFAULT_SKIP;
+    const results = [];
+    function walk(current) {
+        let entries;
+        try {
+            entries = fs.readdirSync(current, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const ent of entries) {
+            const full = path.join(current, ent.name);
+            if (ent.isDirectory()) {
+                if (skip.has(ent.name))
+                    continue;
+                walk(full);
+            }
+            else if (ent.isFile() && ent.name.endsWith('.ts') && !ent.name.endsWith('.d.ts')) {
+                results.push(full);
+            }
+        }
+    }
+    walk(dir);
+    return results;
+}
+//# sourceMappingURL=get-all-ts-files.js.map

package/dist/ast/get-all-ts-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-all-ts-files.js","sourceRoot":"","sources":["../../src/ast/get-all-ts-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAC5B,cAAc;IACd,MAAM;IACN,MAAM;IACN,UAAU;IACV,OAAO;CACP,CAAC,CAAA;AAMF,MAAM,UAAU,aAAa,CAC5B,GAAW,EACX,UAAgC,EAAE;IAElC,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,IAAI,YAAY,CAAA;IACjD,MAAM,OAAO,GAAa,EAAE,CAAA;IAE5B,SAAS,IAAI,CAAC,OAAe;QAC5B,IAAI,OAAoB,CAAA;QACxB,IAAI,CAAC;YACJ,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;QAC3D,CAAC;QAAC,MAAM,CAAC;YACR,OAAM;QACP,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,CAAA;YACzC,IAAI,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;gBACvB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;oBAAE,SAAQ;gBAChC,IAAI,CAAC,IAAI,CAAC,CAAA;YACX,CAAC;iBAAM,IAAI,GAAG,CAAC,MAAM,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACpF,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACnB,CAAC;QACF,CAAC;IACF,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,CAAA;IACT,OAAO,OAAO,CAAA;AACf,CAAC"}

package/dist/ast/merge-ast.d.ts

@@ -0,0 +1,3 @@
+import type { AstMethodResult } from './visit-node.js';
+export declare function mergeASTIntoRegistry(astResults: AstMethodResult[]): void;
+//# sourceMappingURL=merge-ast.d.ts.map

package/dist/ast/merge-ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-ast.d.ts","sourceRoot":"","sources":["../../src/ast/merge-ast.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAGtD,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,IAAI,CAuCxE"}

package/dist/ast/merge-ast.js

@@ -0,0 +1,40 @@
+import { Registry } from '../registry-state.js';
+export function mergeASTIntoRegistry(astResults) {
+    for (const row of astResults) {
+        const { fnName, className, returns, throws, apiReturns } = row;
+        const fnKey = `${className}.${fnName}`;
+        if (!Registry.has(fnKey))
+            continue;
+        const meta = Registry.get(fnKey);
+        if (row.paramsFromAst && row.paramsFromAst.length > 0) {
+            meta.params = row.paramsFromAst;
+        }
+        if (row.declaredReturnFromAst !== undefined) {
+            meta.declaredReturn = row.declaredReturnFromAst;
+        }
+        for (const { label, type } of returns) {
+            const entry = meta.returns.find((r) => r.label === label);
+            if (entry) {
+                entry.type = type;
+                entry.status = 'resolved';
+            }
+        }
+        for (const { label, type } of throws) {
+            const entry = meta.errors.find((e) => e.label === label);
+            if (entry) {
+                entry.type = type;
+                entry.status = 'resolved';
+            }
+        }
+        for (const { label, statusCode, bodyType } of apiReturns) {
+            const entry = meta.apiResponses.find((r) => r.label === label);
+            if (entry) {
+                if (statusCode !== null)
+                    entry.statusCode = statusCode;
+                entry.bodyShape = bodyType;
+                entry.status = 'resolved';
+            }
+        }
+    }
+}
+//# sourceMappingURL=merge-ast.js.map

package/dist/ast/merge-ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-ast.js","sourceRoot":"","sources":["../../src/ast/merge-ast.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAE/C,MAAM,UAAU,oBAAoB,CAAC,UAA6B;IACjE,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,GAAG,CAAA;QAC9D,MAAM,KAAK,GAAG,GAAG,SAAS,IAAI,MAAM,EAAE,CAAA;QACtC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAQ;QAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAE,CAAA;QAEjC,IAAI,GAAG,CAAC,aAAa,IAAI,GAAG,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvD,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,aAAa,CAAA;QAChC,CAAC;QACD,IAAI,GAAG,CAAC,qBAAqB,KAAK,SAAS,EAAE,CAAC;YAC7C,IAAI,CAAC,cAAc,GAAG,GAAG,CAAC,qBAAqB,CAAA;QAChD,CAAC;QAED,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,OAAO,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAA;YACzD,IAAI,KAAK,EAAE,CAAC;gBACX,KAAK,CAAC,IAAI,GAAG,IAAI,CAAA;gBACjB,KAAK,CAAC,MAAM,GAAG,UAAU,CAAA;YAC1B,CAAC;QACF,CAAC;QAED,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAA;YACxD,IAAI,KAAK,EAAE,CAAC;gBACX,KAAK,CAAC,IAAI,GAAG,IAAI,CAAA;gBACjB,KAAK,CAAC,MAAM,GAAG,UAAU,CAAA;YAC1B,CAAC;QACF,CAAC;QAED,KAAK,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,UAAU,EAAE,CAAC;YAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAA;YAC9D,IAAI,KAAK,EAAE,CAAC;gBACX,IAAI,UAAU,KAAK,IAAI;oBAAE,KAAK,CAAC,UAAU,GAAG,UAAU,CAAA;gBACtD,KAAK,CAAC,SAAS,GAAG,QAAQ,CAAA;gBAC1B,KAAK,CAAC,MAAM,GAAG,UAAU,CAAA;YAC1B,CAAC;QACF,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/ast/run-ast-scanner.d.ts

@@ -0,0 +1,15 @@
+import ts from 'typescript';
+import { type GetAllTsFilesOptions } from './get-all-ts-files.js';
+import type { ExpandTypeOptions } from './type-expand.js';
+import type { AstMethodResult } from './visit-node.js';
+export interface RunAstScannerOptions {
+    getAllTsFilesOptions?: GetAllTsFilesOptions;
+    /** Extra compiler options merged over parsed config */
+    compilerOptions?: ts.CompilerOptions;
+    /** If set, only these files are in the program (for tests / narrow scans) */
+    files?: string[];
+    expandParamTypes?: boolean;
+    expandParamTypesOptions?: ExpandTypeOptions;
+}
+export declare function runASTScanner(rootDir: string, options?: RunAstScannerOptions): AstMethodResult[];
+//# sourceMappingURL=run-ast-scanner.d.ts.map

package/dist/ast/run-ast-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-ast-scanner.d.ts","sourceRoot":"","sources":["../../src/ast/run-ast-scanner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,YAAY,CAAA;AAE3B,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAGtD,MAAM,WAAW,oBAAoB;IACpC,oBAAoB,CAAC,EAAE,oBAAoB,CAAA;IAC3C,uDAAuD;IACvD,eAAe,CAAC,EAAE,EAAE,CAAC,eAAe,CAAA;IACpC,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,uBAAuB,CAAC,EAAE,iBAAiB,CAAA;CAC3C;AAgCD,wBAAgB,aAAa,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,oBAAyB,GAChC,eAAe,EAAE,CAsBnB"}

package/dist/ast/run-ast-scanner.js

@@ -0,0 +1,44 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import ts from 'typescript';
+import { getAllTsFiles } from './get-all-ts-files.js';
+import { visitNode } from './visit-node.js';
+function loadCompilerOptions(rootDir, extra) {
+    const configPath = ts.findConfigFile(rootDir, ts.sys.fileExists, 'tsconfig.json');
+    if (!configPath) {
+        return {
+            ...(extra ?? {}),
+            target: ts.ScriptTarget.ES2022,
+            module: ts.ModuleKind.NodeNext,
+            moduleResolution: ts.ModuleResolutionKind.NodeNext,
+            experimentalDecorators: true,
+            emitDecoratorMetadata: true,
+            strict: true,
+        };
+    }
+    const read = ts.readConfigFile(configPath, (p) => fs.readFileSync(p, 'utf8'));
+    if (read.error) {
+        throw new Error(ts.formatDiagnostic(read.error, ts.createCompilerHost({})));
+    }
+    const parsed = ts.parseJsonConfigFileContent(read.config, ts.sys, path.dirname(configPath), undefined, configPath);
+    return { ...parsed.options, ...extra };
+}
+export function runASTScanner(rootDir, options = {}) {
+    const files = options.files ?? getAllTsFiles(rootDir, options.getAllTsFilesOptions);
+    const results = [];
+    const compilerOptions = loadCompilerOptions(rootDir, options.compilerOptions);
+    const program = ts.createProgram(files, compilerOptions);
+    const checker = program.getTypeChecker();
+    for (const filePath of files) {
+        const source = program.getSourceFile(filePath);
+        if (!source)
+            continue;
+        ts.forEachChild(source, (node) => visitNode(node, source, checker, results, {
+            expandParamTypes: options.expandParamTypes ?? true,
+            expandParamTypesOptions: options.expandParamTypesOptions,
+            program,
+        }));
+    }
+    return results;
+}
+//# sourceMappingURL=run-ast-scanner.js.map

package/dist/ast/run-ast-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-ast-scanner.js","sourceRoot":"","sources":["../../src/ast/run-ast-scanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,MAAM,YAAY,CAAA;AAE3B,OAAO,EAAE,aAAa,EAA6B,MAAM,uBAAuB,CAAA;AAGhF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAY3C,SAAS,mBAAmB,CAC3B,OAAe,EACf,KAA0B;IAE1B,MAAM,UAAU,GAAG,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,eAAe,CAAC,CAAA;IACjF,IAAI,CAAC,UAAU,EAAE,CAAC;QACjB,OAAO;YACN,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;YAChB,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM;YAC9B,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ;YAC9B,gBAAgB,EAAE,EAAE,CAAC,oBAAoB,CAAC,QAAQ;YAClD,sBAAsB,EAAE,IAAI;YAC5B,qBAAqB,EAAE,IAAI;YAC3B,MAAM,EAAE,IAAI;SACZ,CAAA;IACF,CAAC;IACD,MAAM,IAAI,GAAG,EAAE,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;IAC7E,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAC5E,CAAC;IACD,MAAM,MAAM,GAAG,EAAE,CAAC,0BAA0B,CAC3C,IAAI,CAAC,MAAM,EACX,EAAE,CAAC,GAAG,EACN,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EACxB,SAAS,EACT,UAAU,CACV,CAAA;IACD,OAAO,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,KAAK,EAAE,CAAA;AACvC,CAAC;AAED,MAAM,UAAU,aAAa,CAC5B,OAAe,EACf,UAAgC,EAAE;IAElC,MAAM,KAAK,GACV,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAA;IACtE,MAAM,OAAO,GAAsB,EAAE,CAAA;IACrC,MAAM,eAAe,GAAG,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,CAAA;IAE7E,MAAM,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,eAAe,CAAC,CAAA;IACxD,MAAM,OAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAA;IAExC,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;QAC9C,IAAI,CAAC,MAAM;YAAE,SAAQ;QACrB,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAChC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE;YACzC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,IAAI;YAClD,uBAAuB,EAAE,OAAO,CAAC,uBAAuB;YACxD,OAAO;SACP,CAAC,CACF,CAAA;IACF,CAAC;IAED,OAAO,OAAO,CAAA;AACf,CAAC"}

package/dist/ast/scan-for-labels.d.ts

@@ -0,0 +1,20 @@
+import ts from 'typescript';
+export declare function parseThrowCall(node: ts.CallExpression): {
+    label: string;
+    errorExpr: ts.Expression;
+} | null;
+export declare function parseApiReturnCall(node: ts.CallExpression): {
+    label: string;
+    statusCodeExpr: ts.Expression;
+    bodyExpr: ts.Expression;
+} | null;
+export declare function scanForThrows(node: ts.Node, checker: ts.TypeChecker, results: {
+    label: string;
+    type: string;
+}[]): void;
+export declare function scanForApiReturns(node: ts.Node, checker: ts.TypeChecker, results: {
+    label: string;
+    statusCode: number | null;
+    bodyType: string;
+}[]): void;
+//# sourceMappingURL=scan-for-labels.d.ts.map

package/dist/ast/scan-for-labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-for-labels.d.ts","sourceRoot":"","sources":["../../src/ast/scan-for-labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAA;AAkB3B,wBAAgB,cAAc,CAC7B,IAAI,EAAE,EAAE,CAAC,cAAc,GACrB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,EAAE,CAAC,UAAU,CAAA;CAAE,GAAG,IAAI,CAmBpD;AAED,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,EAAE,CAAC,cAAc,GACrB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,EAAE,CAAC,UAAU,CAAC;IAAC,QAAQ,EAAE,EAAE,CAAC,UAAU,CAAA;CAAE,GAAG,IAAI,CAmBlF;AAED,wBAAgB,aAAa,CAC5B,IAAI,EAAE,EAAE,CAAC,IAAI,EACb,OAAO,EAAE,EAAE,CAAC,WAAW,EACvB,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GACxC,IAAI,CAYN;AAED,wBAAgB,iBAAiB,CAChC,IAAI,EAAE,EAAE,CAAC,IAAI,EACb,OAAO,EAAE,EAAE,CAAC,WAAW,EACvB,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAAE,GACvE,IAAI,CAiBN"}

package/dist/ast/scan-for-labels.js

@@ -0,0 +1,88 @@
+import ts from 'typescript';
+function stringLiteralText(n) {
+    if (ts.isStringLiteral(n) || ts.isNoSubstitutionTemplateLiteral(n))
+        return n.text;
+    return null;
+}
+function unwrapCallee(expr) {
+    if (ts.isParenthesizedExpression(expr))
+        return unwrapCallee(expr.expression);
+    return expr;
+}
+function isCommaCallee(expr, name) {
+    if (!ts.isBinaryExpression(expr))
+        return false;
+    if (expr.operatorToken.kind !== ts.SyntaxKind.CommaToken)
+        return false;
+    return ts.isIdentifier(expr.right) && expr.right.text === name;
+}
+export function parseThrowCall(node) {
+    const args = node.arguments;
+    if (args.length < 2)
+        return null;
+    const cal = unwrapCallee(node.expression);
+    if (ts.isIdentifier(cal) && cal.text === 'Throw') {
+        const label = stringLiteralText(args[0]);
+        if (label === null)
+            return null;
+        return { label, errorExpr: args[1] };
+    }
+    if (isCommaCallee(cal, 'Throw')) {
+        const label = stringLiteralText(args[0]);
+        if (label === null)
+            return null;
+        return { label, errorExpr: args[1] };
+    }
+    return null;
+}
+export function parseApiReturnCall(node) {
+    const args = node.arguments;
+    if (args.length < 3)
+        return null;
+    const cal = unwrapCallee(node.expression);
+    if (ts.isIdentifier(cal) && cal.text === 'ApiReturn') {
+        const label = stringLiteralText(args[0]);
+        if (label === null)
+            return null;
+        return { label, statusCodeExpr: args[1], bodyExpr: args[2] };
+    }
+    if (isCommaCallee(cal, 'ApiReturn')) {
+        const label = stringLiteralText(args[0]);
+        if (label === null)
+            return null;
+        return { label, statusCodeExpr: args[1], bodyExpr: args[2] };
+    }
+    return null;
+}
+export function scanForThrows(node, checker, results) {
+    if (ts.isCallExpression(node)) {
+        const parsed = parseThrowCall(node);
+        if (parsed) {
+            const type = checker.getTypeAtLocation(parsed.errorExpr);
+            results.push({
+                label: parsed.label,
+                type: checker.typeToString(type),
+            });
+        }
+    }
+    ts.forEachChild(node, (child) => scanForThrows(child, checker, results));
+}
+export function scanForApiReturns(node, checker, results) {
+    if (ts.isCallExpression(node)) {
+        const parsed = parseApiReturnCall(node);
+        if (parsed) {
+            let statusCode = null;
+            if (ts.isNumericLiteral(parsed.statusCodeExpr)) {
+                statusCode = Number(parsed.statusCodeExpr.text);
+            }
+            const body = checker.getTypeAtLocation(parsed.bodyExpr);
+            results.push({
+                label: parsed.label,
+                statusCode,
+                bodyType: checker.typeToString(body),
+            });
+        }
+    }
+    ts.forEachChild(node, (child) => scanForApiReturns(child, checker, results));
+}
+//# sourceMappingURL=scan-for-labels.js.map

package/dist/ast/scan-for-labels.js.map

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

package/dist/ast/scan-for-returns.d.ts

@@ -0,0 +1,13 @@
+import ts from 'typescript';
+/**
+ * Recognizes `Return("L", v)` and `(0,Return)("L", v)`-style calls.
+ */
+export declare function parseReturnCall(node: ts.CallExpression): {
+    label: string;
+    valueExpr: ts.Expression;
+} | null;
+export declare function scanForReturns(node: ts.Node, checker: ts.TypeChecker, results: {
+    label: string;
+    type: string;
+}[]): void;
+//# sourceMappingURL=scan-for-returns.d.ts.map

package/dist/ast/scan-for-returns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-for-returns.d.ts","sourceRoot":"","sources":["../../src/ast/scan-for-returns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAA;AAO3B;;GAEG;AACH,wBAAgB,eAAe,CAC9B,IAAI,EAAE,EAAE,CAAC,cAAc,GACrB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,EAAE,CAAC,UAAU,CAAA;CAAE,GAAG,IAAI,CAyBpD;AAED,wBAAgB,cAAc,CAC7B,IAAI,EAAE,EAAE,CAAC,IAAI,EACb,OAAO,EAAE,EAAE,CAAC,WAAW,EACvB,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GACxC,IAAI,CAYN"}

package/dist/ast/scan-for-returns.js

@@ -0,0 +1,48 @@
+import ts from 'typescript';
+function stringLiteralText(n) {
+    if (ts.isStringLiteral(n) || ts.isNoSubstitutionTemplateLiteral(n))
+        return n.text;
+    return null;
+}
+/**
+ * Recognizes `Return("L", v)` and `(0,Return)("L", v)`-style calls.
+ */
+export function parseReturnCall(node) {
+    const args = node.arguments;
+    if (args.length < 2)
+        return null;
+    let cal = node.expression;
+    if (ts.isParenthesizedExpression(cal)) {
+        cal = cal.expression;
+    }
+    if (ts.isIdentifier(cal) && cal.text === 'Return') {
+        const label = stringLiteralText(args[0]);
+        if (label === null)
+            return null;
+        return { label, valueExpr: args[1] };
+    }
+    if (ts.isBinaryExpression(cal) && cal.operatorToken.kind === ts.SyntaxKind.CommaToken) {
+        const right = cal.right;
+        if (ts.isIdentifier(right) && right.text === 'Return') {
+            const label = stringLiteralText(args[0]);
+            if (label === null)
+                return null;
+            return { label, valueExpr: args[1] };
+        }
+    }
+    return null;
+}
+export function scanForReturns(node, checker, results) {
+    if (ts.isCallExpression(node)) {
+        const parsed = parseReturnCall(node);
+        if (parsed) {
+            const type = checker.getTypeAtLocation(parsed.valueExpr);
+            results.push({
+                label: parsed.label,
+                type: checker.typeToString(type),
+            });
+        }
+    }
+    ts.forEachChild(node, (child) => scanForReturns(child, checker, results));
+}
+//# sourceMappingURL=scan-for-returns.js.map

package/dist/ast/scan-for-returns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-for-returns.js","sourceRoot":"","sources":["../../src/ast/scan-for-returns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAA;AAE3B,SAAS,iBAAiB,CAAC,CAAgB;IAC1C,IAAI,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,+BAA+B,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC,IAAI,CAAA;IACjF,OAAO,IAAI,CAAA;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC9B,IAAuB;IAEvB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAA;IAC3B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IAEhC,IAAI,GAAG,GAAkB,IAAI,CAAC,UAAU,CAAA;IACxC,IAAI,EAAE,CAAC,yBAAyB,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,GAAG,GAAG,GAAG,CAAC,UAAU,CAAA;IACrB,CAAC;IAED,IAAI,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAA;QACzC,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QAC/B,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAE,EAAE,CAAA;IACtC,CAAC;IAED,IAAI,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,aAAa,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;QACvF,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAA;QACvB,IAAI,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAA;YACzC,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAA;YAC/B,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAE,EAAE,CAAA;QACtC,CAAC;IACF,CAAC;IAED,OAAO,IAAI,CAAA;AACZ,CAAC;AAED,MAAM,UAAU,cAAc,CAC7B,IAAa,EACb,OAAuB,EACvB,OAA0C;IAE1C,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA;QACpC,IAAI,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;YACxD,OAAO,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC;aAChC,CAAC,CAAA;QACH,CAAC;IACF,CAAC;IACD,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;AAC1E,CAAC"}

package/dist/ast/type-expand.d.ts

@@ -0,0 +1,16 @@
+import ts from 'typescript';
+export interface ExpandTypeOptions {
+    maxDepth?: number;
+    maxProps?: number;
+    maxUnion?: number;
+    maxLen?: number;
+    /** When set (e.g. from runASTScanner), lib/external object types collapse to `typeToString` (e.g. `File`). */
+    program?: ts.Program;
+    /**
+     * When true, object/interface types declared only in default or external library sources use short names.
+     * Default: `true` when `program` is set, otherwise `false`.
+     */
+    collapseLibOrExternalObjectShapes?: boolean;
+}
+export declare function expandTypeToShapeString(type: ts.Type, checker: ts.TypeChecker, contextNode: ts.Node, opts?: ExpandTypeOptions): string;
+//# sourceMappingURL=type-expand.d.ts.map

package/dist/ast/type-expand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-expand.d.ts","sourceRoot":"","sources":["../../src/ast/type-expand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAA;AAE3B,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8GAA8G;IAC9G,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAA;IACpB;;;OAGG;IACH,iCAAiC,CAAC,EAAE,OAAO,CAAA;CAC3C;AAyKD,wBAAgB,uBAAuB,CACtC,IAAI,EAAE,EAAE,CAAC,IAAI,EACb,OAAO,EAAE,EAAE,CAAC,WAAW,EACvB,WAAW,EAAE,EAAE,CAAC,IAAI,EACpB,IAAI,GAAE,iBAAsB,GAC1B,MAAM,CAQR"}

package/dist/ast/type-expand.js

@@ -0,0 +1,118 @@
+import ts from 'typescript';
+const DEFAULT_EXPAND_TYPE_OPTIONS = {
+    maxDepth: 3,
+    maxProps: 30,
+    maxUnion: 5,
+    maxLen: 2000,
+};
+function resolveExpandOptions(opts = {}) {
+    const collapseLibOrExternalObjectShapes = opts.collapseLibOrExternalObjectShapes ?? Boolean(opts.program);
+    return {
+        maxDepth: opts.maxDepth ?? DEFAULT_EXPAND_TYPE_OPTIONS.maxDepth,
+        maxProps: opts.maxProps ?? DEFAULT_EXPAND_TYPE_OPTIONS.maxProps,
+        maxUnion: opts.maxUnion ?? DEFAULT_EXPAND_TYPE_OPTIONS.maxUnion,
+        maxLen: opts.maxLen ?? DEFAULT_EXPAND_TYPE_OPTIONS.maxLen,
+        program: opts.program,
+        collapseLibOrExternalObjectShapes,
+    };
+}
+function resolveNonAliasSymbol(type, checker) {
+    let sym = type.aliasSymbol ?? type.getSymbol();
+    if (!sym)
+        return undefined;
+    while (sym.flags & ts.SymbolFlags.Alias) {
+        sym = checker.getAliasedSymbol(sym);
+    }
+    return sym;
+}
+/** True when every declaration lives in TS default libs or node_modules / external typings. */
+function shouldCollapseObjectTypeToName(program, collapse, checker, type) {
+    if (!collapse || !program)
+        return false;
+    const sym = resolveNonAliasSymbol(type, checker);
+    if (!sym?.declarations?.length)
+        return false;
+    return sym.declarations.every((decl) => {
+        const sf = decl.getSourceFile();
+        return program.isSourceFileDefaultLibrary(sf) || program.isSourceFileFromExternalLibrary(sf);
+    });
+}
+function withFallback(type, checker, value, options) {
+    if (value.length > options.maxLen)
+        return checker.typeToString(type);
+    return value;
+}
+function isOptionalProperty(symbol) {
+    if ((symbol.flags & ts.SymbolFlags.Optional) !== 0)
+        return true;
+    return symbol.declarations?.some((decl) => {
+        return ((ts.isPropertySignature(decl) || ts.isPropertyDeclaration(decl) || ts.isParameter(decl)) &&
+            decl.questionToken !== undefined);
+    }) ?? false;
+}
+function expandTypeInternal(type, checker, contextNode, options, depth, state) {
+    if (depth >= options.maxDepth)
+        return checker.typeToString(type);
+    if (state.seen.has(type))
+        return checker.typeToString(type);
+    if (checker.isArrayType(type)) {
+        const [elementType] = checker.getTypeArguments(type);
+        if (!elementType)
+            return checker.typeToString(type);
+        const expanded = expandTypeInternal(elementType, checker, contextNode, options, depth + 1, state);
+        return withFallback(type, checker, `Array<${expanded}>`, options);
+    }
+    if (checker.isTupleType(type)) {
+        const tupleArgs = checker
+            .getTypeArguments(type)
+            .map((arg) => expandTypeInternal(arg, checker, contextNode, options, depth + 1, state));
+        return withFallback(type, checker, `[${tupleArgs.join(', ')}]`, options);
+    }
+    if (type.isUnion()) {
+        const booleanLike = new Set(type.types.map((part) => checker.typeToString(part)));
+        if (booleanLike.size === 2 && booleanLike.has('false') && booleanLike.has('true')) {
+            return 'boolean';
+        }
+        if (type.types.length > options.maxUnion)
+            return checker.typeToString(type);
+        const parts = type.types.map((part) => expandTypeInternal(part, checker, contextNode, options, depth + 1, state));
+        return withFallback(type, checker, parts.join(' | '), options);
+    }
+    if (type.isIntersection()) {
+        if (type.types.length > options.maxUnion)
+            return checker.typeToString(type);
+        const parts = type.types.map((part) => expandTypeInternal(part, checker, contextNode, options, depth + 1, state));
+        return withFallback(type, checker, parts.join(' & '), options);
+    }
+    const primitiveString = checker.typeToString(type);
+    if ((type.flags & ts.TypeFlags.Object) === 0)
+        return primitiveString;
+    const properties = checker.getPropertiesOfType(type);
+    if (properties.length === 0)
+        return primitiveString;
+    if (properties.length > options.maxProps)
+        return primitiveString;
+    if (shouldCollapseObjectTypeToName(options.program, options.collapseLibOrExternalObjectShapes, checker, type)) {
+        return primitiveString;
+    }
+    state.seen.add(type);
+    try {
+        const fields = properties.map((symbol) => {
+            const propertyType = checker.getTypeOfSymbolAtLocation(symbol, contextNode);
+            const propText = expandTypeInternal(propertyType, checker, contextNode, options, depth + 1, state);
+            return `${symbol.getName()}${isOptionalProperty(symbol) ? '?' : ''}: ${propText}`;
+        });
+        return withFallback(type, checker, `{ ${fields.join('; ')} }`, options);
+    }
+    finally {
+        state.seen.delete(type);
+    }
+}
+export function expandTypeToShapeString(type, checker, contextNode, opts = {}) {
+    const options = resolveExpandOptions(opts);
+    if (options.maxDepth <= 0 || options.maxProps <= 0 || options.maxUnion <= 0 || options.maxLen <= 0) {
+        return checker.typeToString(type);
+    }
+    return expandTypeInternal(type, checker, contextNode, options, 0, { seen: new Set() });
+}
+//# sourceMappingURL=type-expand.js.map

package/dist/ast/type-expand.js.map

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

package/dist/ast/visit-node.d.ts

@@ -0,0 +1,31 @@
+import ts from 'typescript';
+import { type ExpandTypeOptions } from './type-expand.js';
+import type { RegistryParam } from '../types.js';
+export interface AstMethodResult {
+    fnName: string;
+    className: string;
+    returns: {
+        label: string;
+        type: string;
+    }[];
+    throws: {
+        label: string;
+        type: string;
+    }[];
+    apiReturns: {
+        label: string;
+        statusCode: number | null;
+        bodyType: string;
+    }[];
+    /** From TypeChecker — fills registry when reflect-metadata is missing (e.g. Vitest/esbuild) */
+    paramsFromAst?: RegistryParam[];
+    declaredReturnFromAst?: string;
+}
+export interface VisitNodeOptions {
+    expandParamTypes: boolean;
+    expandParamTypesOptions?: ExpandTypeOptions;
+    /** Passed from runASTScanner into param type expansion (lib/external collapse). */
+    program?: ts.Program;
+}
+export declare function visitNode(node: ts.Node, _source: ts.SourceFile, checker: ts.TypeChecker, results: AstMethodResult[], options: VisitNodeOptions): void;
+//# sourceMappingURL=visit-node.d.ts.map

package/dist/ast/visit-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visit-node.d.ts","sourceRoot":"","sources":["../../src/ast/visit-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAA;AAI3B,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAClF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC1C,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACzC,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC5E,+FAA+F;IAC/F,aAAa,CAAC,EAAE,aAAa,EAAE,CAAA;IAC/B,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAChC,gBAAgB,EAAE,OAAO,CAAA;IACzB,uBAAuB,CAAC,EAAE,iBAAiB,CAAA;IAC3C,mFAAmF;IACnF,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAA;CACpB;AAmSD,wBAAgB,SAAS,CACxB,IAAI,EAAE,EAAE,CAAC,IAAI,EACb,OAAO,EAAE,EAAE,CAAC,UAAU,EACtB,OAAO,EAAE,EAAE,CAAC,WAAW,EACvB,OAAO,EAAE,eAAe,EAAE,EAC1B,OAAO,EAAE,gBAAgB,GACvB,IAAI,CA+BN"}