sammy-sdk 0.1.0

package/dist/discovery/ast/call-route-finder.js

@@ -0,0 +1,106 @@
+import { SyntaxKind } from "ts-morph";
+import { functionLikeFromExpression, resolveDefinitions, getFunctionBody } from "./resolve.js";
+const HTTP_VERBS = new Set(["get", "post", "put", "delete", "patch", "options", "head", "all"]);
+// Find `obj.<verb>('/path', ...handlers)` route registrations. Precision guard:
+// a route is only emitted when one of the args after the path resolves to a
+// function body — this filters non-route calls like `map.get('key')`.
+export function findCallRoutes(sourceFile) {
+    const out = [];
+    for (const call of sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression)) {
+        const prop = call.getExpression().asKind(SyntaxKind.PropertyAccessExpression);
+        if (!prop)
+            continue;
+        const verb = prop.getName().toLowerCase();
+        if (!HTTP_VERBS.has(verb))
+            continue;
+        const args = call.getArguments();
+        if (args.length < 2)
+            continue; // need at least a path + a handler
+        const path = literalText(args[0]);
+        if (path === undefined)
+            continue;
+        const handlerBody = resolveHandlerBody(args.slice(1));
+        if (!handlerBody)
+            continue;
+        out.push({ method: verb.toUpperCase(), path, handlerBody, args });
+    }
+    return out;
+}
+export function findRouteObjects(sourceFile) {
+    const out = [];
+    for (const call of sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression)) {
+        const prop = call.getExpression().asKind(SyntaxKind.PropertyAccessExpression);
+        if (!prop || prop.getName() !== "route")
+            continue;
+        const obj = call.getArguments()[0]?.asKind(SyntaxKind.ObjectLiteralExpression);
+        if (!obj)
+            continue;
+        const methods = readMethods(initializerOf(obj, "method"));
+        const path = literalText(initializerOf(obj, "url"));
+        if (methods.length === 0 || path === undefined)
+            continue;
+        const handlerInit = initializerOf(obj, "handler");
+        const handlerBody = handlerInit ? toFunctionBody(handlerInit) : undefined;
+        const schemaObj = initializerOf(obj, "schema")?.asKind(SyntaxKind.ObjectLiteralExpression);
+        const schemaBody = schemaObj ? initializerOf(schemaObj, "body") : undefined;
+        out.push({ methods, path, handlerBody, schemaBody });
+    }
+    return out;
+}
+function initializerOf(obj, name) {
+    const objLit = obj.asKind(SyntaxKind.ObjectLiteralExpression);
+    const prop = objLit?.getProperty(name)?.asKind(SyntaxKind.PropertyAssignment);
+    return prop?.getInitializer();
+}
+function readMethods(init) {
+    if (!init)
+        return [];
+    const single = literalText(init);
+    if (single !== undefined)
+        return [single.toUpperCase()];
+    const arr = init.asKind(SyntaxKind.ArrayLiteralExpression);
+    if (arr) {
+        return arr
+            .getElements()
+            .map((e) => literalText(e))
+            .filter((v) => v !== undefined)
+            .map((v) => v.toUpperCase());
+    }
+    return [];
+}
+// First arg (scanning right-to-left) that resolves to a function body — the
+// real handler, skipping any preceding middleware.
+function resolveHandlerBody(args) {
+    for (let i = args.length - 1; i >= 0; i--) {
+        const body = toFunctionBody(args[i]);
+        if (body)
+            return body;
+    }
+    return undefined;
+}
+function toFunctionBody(arg) {
+    const direct = functionLikeFromExpression(arg);
+    if (direct)
+        return direct;
+    // Named handler reference: `app.get('/x', getUser)`.
+    if (arg.getKind() === SyntaxKind.Identifier) {
+        for (const def of resolveDefinitions(arg)) {
+            const body = getFunctionBody(def);
+            if (body)
+                return body;
+        }
+    }
+    return undefined;
+}
+function literalText(node) {
+    if (!node)
+        return undefined;
+    const str = node.asKind(SyntaxKind.StringLiteral);
+    if (str)
+        return str.getLiteralText();
+    const tpl = node.asKind(SyntaxKind.NoSubstitutionTemplateLiteral);
+    if (tpl)
+        return tpl.getLiteralText();
+    return undefined;
+}
+//# sourceMappingURL=call-route-finder.js.map

package/dist/discovery/ast/call-route-finder.js.map

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

package/dist/discovery/ast/handler-detector.d.ts

@@ -0,0 +1,8 @@
+import { Node, SourceFile } from "ts-morph";
+export interface DetectedHandler {
+    method: string;
+    fnNode: Node | undefined;
+    fnDecl: Node;
+}
+export declare function detectHandlers(sourceFile: SourceFile): DetectedHandler[];
+//# sourceMappingURL=handler-detector.d.ts.map

package/dist/discovery/ast/handler-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-detector.d.ts","sourceRoot":"","sources":["../../../src/discovery/ast/handler-detector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAc,MAAM,UAAU,CAAC;AAKxD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,IAAI,GAAG,SAAS,CAAC;IACzB,MAAM,EAAE,IAAI,CAAC;CACd;AAKD,wBAAgB,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe,EAAE,CA4BxE"}

package/dist/discovery/ast/handler-detector.js

@@ -0,0 +1,56 @@
+import { SyntaxKind } from "ts-morph";
+import { getFunctionBody, functionLikeFromExpression } from "./resolve.js";
+const HTTP_METHODS = ["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"];
+// Find exported route handlers named after HTTP methods, in all declaration
+// forms: `export async function GET`, `export const GET = async () =>`,
+// HOF-wrapped `export const POST = withAuth(fn)`, and re-exports.
+export function detectHandlers(sourceFile) {
+    const handlers = [];
+    for (const method of HTTP_METHODS) {
+        // export async function GET() {}
+        const fn = sourceFile.getFunction(method);
+        if (fn && fn.isExported()) {
+            handlers.push({ method, fnNode: fn.getBody(), fnDecl: fn });
+            continue;
+        }
+        // export const GET = ... (arrow, function expr, or HOF call)
+        const varDecl = sourceFile.getVariableDeclaration(method);
+        if (varDecl && varDecl.isExported()) {
+            const init = varDecl.getInitializer();
+            const body = init ? functionLikeFromExpression(init) : undefined;
+            handlers.push({ method, fnNode: body, fnDecl: varDecl });
+            continue;
+        }
+        // export { GET } from "./handlers"  OR  export { GET }
+        const exported = resolveExportedDeclaration(sourceFile, method);
+        if (exported) {
+            handlers.push({ method, fnNode: getFunctionBody(exported), fnDecl: exported });
+        }
+    }
+    return handlers;
+}
+function resolveExportedDeclaration(sourceFile, name) {
+    try {
+        for (const exportDecl of sourceFile.getExportDeclarations()) {
+            for (const spec of exportDecl.getNamedExports()) {
+                if (spec.getName() === name || spec.getAliasNode()?.getText() === name) {
+                    const nameNode = spec.getNameNode().asKind(SyntaxKind.Identifier);
+                    if (!nameNode)
+                        continue;
+                    const defs = nameNode.getDefinitionNodes();
+                    const local = defs.find((d) => {
+                        const fp = d.getSourceFile().getFilePath();
+                        return !fp.includes("node_modules") && !fp.endsWith(".d.ts");
+                    });
+                    if (local)
+                        return local;
+                }
+            }
+        }
+    }
+    catch {
+        // best-effort
+    }
+    return undefined;
+}
+//# sourceMappingURL=handler-detector.js.map

package/dist/discovery/ast/handler-detector.js.map

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

package/dist/discovery/ast/named-export-finder.d.ts

@@ -0,0 +1,7 @@
+import { Node, SourceFile } from "ts-morph";
+export interface NamedExport {
+    name: string;
+    body: Node | undefined;
+}
+export declare function findNamedExports(sourceFile: SourceFile, names: string[]): NamedExport[];
+//# sourceMappingURL=named-export-finder.d.ts.map

package/dist/discovery/ast/named-export-finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"named-export-finder.d.ts","sourceRoot":"","sources":["../../../src/discovery/ast/named-export-finder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG5C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;CACxB;AAKD,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAkBvF"}

package/dist/discovery/ast/named-export-finder.js

@@ -0,0 +1,21 @@
+import { functionLikeFromExpression } from "./resolve.js";
+// Find exported declarations by exact name (e.g. Remix `loader`/`action`,
+// SvelteKit `+server.ts` verb handlers / `load`). Handles both the function
+// declaration and `export const name = async () => {}` forms.
+export function findNamedExports(sourceFile, names) {
+    const out = [];
+    for (const name of names) {
+        const fn = sourceFile.getFunction(name);
+        if (fn && fn.isExported()) {
+            out.push({ name, body: fn.getBody() });
+            continue;
+        }
+        const varDecl = sourceFile.getVariableDeclaration(name);
+        if (varDecl && varDecl.isExported()) {
+            const init = varDecl.getInitializer();
+            out.push({ name, body: init ? functionLikeFromExpression(init) : undefined });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=named-export-finder.js.map

package/dist/discovery/ast/named-export-finder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"named-export-finder.js","sourceRoot":"","sources":["../../../src/discovery/ast/named-export-finder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAO1D,0EAA0E;AAC1E,4EAA4E;AAC5E,8DAA8D;AAC9D,MAAM,UAAU,gBAAgB,CAAC,UAAsB,EAAE,KAAe;IACtE,MAAM,GAAG,GAAkB,EAAE,CAAC;IAE9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,EAAE,IAAI,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC;YAC1B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACvC,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,UAAU,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;QACxD,IAAI,OAAO,IAAI,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;YACpC,MAAM,IAAI,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;YACtC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/discovery/ast/param-extractor.d.ts

@@ -0,0 +1,7 @@
+import { Node } from "ts-morph";
+import type { ParameterDef } from "../types.js";
+export declare function extractRouteParams(fnBody: Node | undefined): ParameterDef[];
+export declare function extractParamsFromZodSchemaExpr(expr: Node | undefined): ParameterDef[];
+export declare function enumerateClassProperties(decl: Node): ParameterDef[];
+export declare function extractDeclaredParams(fnDecl: Node): ParameterDef[];
+//# sourceMappingURL=param-extractor.d.ts.map

package/dist/discovery/ast/param-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"param-extractor.d.ts","sourceRoot":"","sources":["../../../src/discovery/ast/param-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAwB,MAAM,UAAU,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAOhD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,YAAY,EAAE,CAkB3E;AAKD,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,GAAG,YAAY,EAAE,CAQrF;AAID,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,IAAI,GAAG,YAAY,EAAE,CAiBnE;AAmKD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,IAAI,GAAG,YAAY,EAAE,CA+BlE"}

package/dist/discovery/ast/param-extractor.js

@@ -0,0 +1,236 @@
+import { SyntaxKind, ts } from "ts-morph";
+import { resolveDefinitions } from "./resolve.js";
+// Extract parameters for a route handler. Strategy A: resolve the Zod schema
+// passed to .parse()/.safeParse() (following imports across files) and walk its
+// z.object({...}). Strategy B: fall back to the TS type of `await req.json()`
+// when it's annotated (`const body: T = ...`) or cast (`... as T`).
+export function extractRouteParams(fnBody) {
+    if (!fnBody)
+        return [];
+    try {
+        const zodParams = extractFromZodValidation(fnBody);
+        if (zodParams.length > 0)
+            return zodParams;
+    }
+    catch {
+        // fall through
+    }
+    try {
+        const typeParams = extractFromJsonType(fnBody);
+        if (typeParams.length > 0)
+            return typeParams;
+    }
+    catch {
+        // fall through
+    }
+    return [];
+}
+// Resolve a Zod schema expression directly to ParameterDef[]. Used where the
+// schema is passed as an argument rather than reached via `.parse()` — e.g.
+// tRPC `.input(schema)`, Hono `zValidator("json", schema)`, Fastify schema.body.
+export function extractParamsFromZodSchemaExpr(expr) {
+    if (!expr)
+        return [];
+    try {
+        const objectLiteral = resolveZodObject(expr);
+        return objectLiteral ? parseZodObject(objectLiteral) : [];
+    }
+    catch {
+        return [];
+    }
+}
+// Enumerate the declared properties of a class or interface (e.g. a NestJS DTO).
+// Syntactic (no type-checker), so it works even on partially-typed projects.
+export function enumerateClassProperties(decl) {
+    const cls = decl.asKind(SyntaxKind.ClassDeclaration);
+    const iface = decl.asKind(SyntaxKind.InterfaceDeclaration);
+    const members = cls ? cls.getProperties() : iface ? iface.getProperties() : [];
+    const params = [];
+    for (const member of members) {
+        const name = member.getName();
+        if (!name)
+            continue;
+        const typeNode = member.getTypeNode();
+        params.push({
+            name,
+            type: typeNode ? typeNode.getText() : "unknown",
+            required: !member.hasQuestionToken(),
+        });
+    }
+    return params;
+}
+function extractFromZodValidation(fnBody) {
+    const calls = fnBody.getDescendantsOfKind(SyntaxKind.CallExpression);
+    for (const call of calls) {
+        const callee = call.getExpression();
+        if (callee.getKind() !== SyntaxKind.PropertyAccessExpression)
+            continue;
+        const prop = callee.asKind(SyntaxKind.PropertyAccessExpression);
+        const methodName = prop.getName();
+        if (methodName !== "parse" && methodName !== "safeParse")
+            continue;
+        // The object before .parse — e.g. InvoiceSchema
+        const schemaExpr = prop.getExpression();
+        const objectLiteral = resolveZodObject(schemaExpr);
+        if (objectLiteral) {
+            return parseZodObject(objectLiteral);
+        }
+    }
+    return [];
+}
+// Resolve an expression to the z.object({...}) ObjectLiteralExpression it
+// ultimately references, following an imported/local schema identifier.
+function resolveZodObject(expr) {
+    // Inline: z.object({...}).parse(...)
+    const inline = findZodObjectArg(expr);
+    if (inline)
+        return inline;
+    // Identifier referencing a schema declared (possibly in another file)
+    if (expr.getKind() === SyntaxKind.Identifier) {
+        for (const def of resolveDefinitions(expr)) {
+            const varDecl = def.asKind(SyntaxKind.VariableDeclaration);
+            const init = varDecl?.getInitializer();
+            if (init) {
+                const obj = findZodObjectArg(init);
+                if (obj)
+                    return obj;
+            }
+        }
+    }
+    return undefined;
+}
+// Given an expression like z.object({...}) (possibly chained .strict() etc.),
+// return the first ObjectLiteralExpression argument of a z.object(...) call.
+function findZodObjectArg(expr) {
+    const calls = [
+        ...(expr.getKind() === SyntaxKind.CallExpression ? [expr] : []),
+        ...expr.getDescendantsOfKind(SyntaxKind.CallExpression),
+    ];
+    for (const node of calls) {
+        const call = node.asKind(SyntaxKind.CallExpression);
+        if (!call)
+            continue;
+        const callee = call.getExpression();
+        if (callee.getKind() === SyntaxKind.PropertyAccessExpression) {
+            const prop = callee.asKind(SyntaxKind.PropertyAccessExpression);
+            if (prop.getName() === "object") {
+                const arg = call.getArguments()[0];
+                const obj = arg?.asKind(SyntaxKind.ObjectLiteralExpression);
+                if (obj)
+                    return obj;
+            }
+        }
+    }
+    return undefined;
+}
+function parseZodObject(objectLiteral) {
+    const obj = objectLiteral.asKind(SyntaxKind.ObjectLiteralExpression);
+    if (!obj)
+        return [];
+    const params = [];
+    for (const prop of obj.getProperties()) {
+        const assignment = prop.asKind(SyntaxKind.PropertyAssignment);
+        if (!assignment)
+            continue;
+        const name = assignment.getName().replace(/['"]/g, "");
+        const valueText = assignment.getInitializer()?.getText() ?? "";
+        const type = zodBaseType(valueText);
+        const required = !valueText.includes(".optional()") && !valueText.includes(".default(");
+        params.push({ name, type, required });
+    }
+    return params;
+}
+function zodBaseType(text) {
+    // z.string() -> string, z.coerce.number() -> number
+    const m = text.match(/z\.(?:coerce\.)?(\w+)\(/);
+    return m ? m[1] : "unknown";
+}
+// Strategy B: when a route reads `await req.json()` and the result is typed via
+// annotation or `as` cast, enumerate that type's properties through the checker.
+function extractFromJsonType(fnBody) {
+    const calls = fnBody.getDescendantsOfKind(SyntaxKind.CallExpression);
+    for (const call of calls) {
+        const prop = call.getExpression().asKind(SyntaxKind.PropertyAccessExpression);
+        if (!prop || prop.getName() !== "json")
+            continue;
+        const bodyType = resolveJsonBodyType(call);
+        if (bodyType) {
+            const params = enumerateTypeProperties(bodyType);
+            if (params.length > 0)
+                return params;
+        }
+    }
+    return [];
+}
+// Climb out of `req.json()` through await/parens to the type annotation or cast.
+function resolveJsonBodyType(call) {
+    let node = call;
+    let parent = node.getParent();
+    while (parent &&
+        (parent.getKind() === SyntaxKind.AwaitExpression ||
+            parent.getKind() === SyntaxKind.ParenthesizedExpression)) {
+        node = parent;
+        parent = parent.getParent();
+    }
+    if (!parent)
+        return undefined;
+    // const body = (await req.json()) as CreateUser
+    const asExpr = parent.asKind(SyntaxKind.AsExpression);
+    if (asExpr)
+        return asExpr.getTypeNode()?.getType();
+    // const body: CreateUser = await req.json()
+    const varDecl = parent.asKind(SyntaxKind.VariableDeclaration);
+    if (varDecl)
+        return varDecl.getTypeNode()?.getType();
+    return undefined;
+}
+function enumerateTypeProperties(type) {
+    const params = [];
+    for (const symbol of type.getProperties()) {
+        const name = symbol.getName();
+        const optional = (symbol.getFlags() & ts.SymbolFlags.Optional) !== 0;
+        let typeText = "unknown";
+        const decl = symbol.getDeclarations()[0];
+        if (decl) {
+            try {
+                typeText = symbol.getTypeAtLocation(decl).getText().replace(/ \| undefined$/, "");
+            }
+            catch {
+                typeText = "unknown";
+            }
+        }
+        params.push({ name, type: typeText, required: !optional });
+    }
+    return params;
+}
+// Build ParameterDef[] from a function's declared parameters (server actions).
+export function extractDeclaredParams(fnDecl) {
+    const params = [];
+    const fn = fnDecl.asKind(SyntaxKind.FunctionDeclaration) ||
+        fnDecl.asKind(SyntaxKind.ArrowFunction) ||
+        fnDecl.asKind(SyntaxKind.FunctionExpression);
+    if (!fn)
+        return [];
+    for (const param of fn.getParameters()) {
+        const nameNode = param.getNameNode();
+        let name;
+        if (nameNode.getKind() === SyntaxKind.ObjectBindingPattern || nameNode.getKind() === SyntaxKind.ArrayBindingPattern) {
+            name = nameNode.getText();
+        }
+        else {
+            name = param.getName();
+        }
+        let type = "unknown";
+        try {
+            const typeNode = param.getTypeNode();
+            type = typeNode ? typeNode.getText() : param.getType().getText();
+        }
+        catch {
+            type = "unknown";
+        }
+        const required = !param.isOptional() && !param.hasInitializer();
+        params.push({ name, type, required });
+    }
+    return params;
+}
+//# sourceMappingURL=param-extractor.js.map

package/dist/discovery/ast/param-extractor.js.map

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

package/dist/discovery/ast/project.d.ts

@@ -0,0 +1,8 @@
+import { Project } from "ts-morph";
+export interface AstContext {
+    project: Project;
+    projectRoot: string;
+}
+export declare function createAstContext(projectRoot: string): AstContext;
+export declare function addFile(ast: AstContext, filePath: string): import("ts-morph").SourceFile | undefined;
+//# sourceMappingURL=project.d.ts.map

package/dist/discovery/ast/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../src/discovery/ast/project.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAM,MAAM,UAAU,CAAC;AAEvC,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAQD,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAqBhE;AAwBD,wBAAgB,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,6CASxD"}

package/dist/discovery/ast/project.js

@@ -0,0 +1,66 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { Project, ts } from "ts-morph";
+// Build a ts-morph Project for the target codebase. Loads the target's tsconfig
+// for compiler options + path aliases when present (without loading the whole
+// repo), else falls back to sane in-memory defaults. Dependency resolution is
+// left ON so cross-file symbol resolution (getDefinitionNodes) works when we
+// add an entry file — the graph is bounded because we only add route/action
+// files explicitly, never the whole tsconfig.
+export function createAstContext(projectRoot) {
+    const tsconfigPath = [
+        path.join(projectRoot, "tsconfig.json"),
+        path.join(projectRoot, "src", "tsconfig.json"),
+    ].find((p) => fs.existsSync(p));
+    let project;
+    try {
+        if (tsconfigPath) {
+            project = new Project({
+                tsConfigFilePath: tsconfigPath,
+                skipAddingFilesFromTsConfig: true,
+            });
+        }
+        else {
+            project = makeInMemoryProject(projectRoot);
+        }
+    }
+    catch {
+        project = makeInMemoryProject(projectRoot);
+    }
+    return { project, projectRoot };
+}
+function makeInMemoryProject(projectRoot) {
+    return new Project({
+        skipAddingFilesFromTsConfig: true,
+        compilerOptions: {
+            target: ts.ScriptTarget.ES2022,
+            module: ts.ModuleKind.NodeNext,
+            moduleResolution: ts.ModuleResolutionKind.NodeNext,
+            jsx: ts.JsxEmit.Preserve,
+            allowJs: true,
+            // NestJS and other decorator-based frameworks need these to parse cleanly.
+            experimentalDecorators: true,
+            emitDecoratorMetadata: true,
+            baseUrl: projectRoot,
+            // Common Next.js alias default so resolution works even without a tsconfig.
+            paths: { "@/*": ["./src/*", "./*"] },
+            noEmit: true,
+            strict: false,
+        },
+    });
+}
+// Add a single file to the project on demand. Skips node_modules and .d.ts.
+export function addFile(ast, filePath) {
+    if (filePath.includes("node_modules") || filePath.endsWith(".d.ts"))
+        return undefined;
+    const existing = ast.project.getSourceFile(filePath);
+    if (existing)
+        return existing;
+    try {
+        return ast.project.addSourceFileAtPathIfExists(filePath);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=project.js.map

package/dist/discovery/ast/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../../src/discovery/ast/project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAOvC,gFAAgF;AAChF,8EAA8E;AAC9E,8EAA8E;AAC9E,6EAA6E;AAC7E,4EAA4E;AAC5E,8CAA8C;AAC9C,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,MAAM,YAAY,GAAG;QACnB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,eAAe,CAAC;KAC/C,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhC,IAAI,OAAgB,CAAC;IACrB,IAAI,CAAC;QACH,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,GAAG,IAAI,OAAO,CAAC;gBACpB,gBAAgB,EAAE,YAAY;gBAC9B,2BAA2B,EAAE,IAAI;aAClC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,mBAAmB,CAAC,WAAmB;IAC9C,OAAO,IAAI,OAAO,CAAC;QACjB,2BAA2B,EAAE,IAAI;QACjC,eAAe,EAAE;YACf,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM;YAC9B,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ;YAC9B,gBAAgB,EAAE,EAAE,CAAC,oBAAoB,CAAC,QAAQ;YAClD,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ;YACxB,OAAO,EAAE,IAAI;YACb,2EAA2E;YAC3E,sBAAsB,EAAE,IAAI;YAC5B,qBAAqB,EAAE,IAAI;YAC3B,OAAO,EAAE,WAAW;YACpB,4EAA4E;YAC5E,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE;YACpC,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,KAAK;SACd;KACF,CAAC,CAAC;AACL,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,OAAO,CAAC,GAAe,EAAE,QAAgB;IACvD,IAAI,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IACtF,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IACrD,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,IAAI,CAAC;QACH,OAAO,GAAG,CAAC,OAAO,CAAC,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/discovery/ast/resolve.d.ts

@@ -0,0 +1,5 @@
+import { Node } from "ts-morph";
+export declare function resolveDefinitions(node: Node): Node[];
+export declare function getFunctionBody(decl: Node): Node | undefined;
+export declare function functionLikeFromExpression(expr: Node): Node | undefined;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/discovery/ast/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/discovery/ast/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAc,MAAM,UAAU,CAAC;AAK5C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,CAYrD;AAKD,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAkB5D;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAiBvE"}

package/dist/discovery/ast/resolve.js

@@ -0,0 +1,60 @@
+import { SyntaxKind } from "ts-morph";
+// Resolve an identifier node to its definition declarations, following imports
+// across files. Project-local only (skips node_modules and .d.ts). Best-effort:
+// returns [] on any resolution failure.
+export function resolveDefinitions(node) {
+    try {
+        const id = node.asKind(SyntaxKind.Identifier);
+        if (!id)
+            return [];
+        const defs = id.getDefinitionNodes();
+        return defs.filter((d) => {
+            const fp = d.getSourceFile().getFilePath();
+            return !fp.includes("node_modules") && !fp.endsWith(".d.ts");
+        });
+    }
+    catch {
+        return [];
+    }
+}
+// Given a declaration node, return the function-like body node to recurse into,
+// handling: function declarations, arrow/function-expression initializers on
+// variable declarations, and HOF-wrapped function arguments.
+export function getFunctionBody(decl) {
+    // function foo() {}
+    const fn = decl.asKind(SyntaxKind.FunctionDeclaration);
+    if (fn)
+        return fn.getBody();
+    // class method foo() {} — e.g. a NestJS service method reached via this.svc.foo()
+    const method = decl.asKind(SyntaxKind.MethodDeclaration);
+    if (method)
+        return method.getBody();
+    // const foo = () => {} | function () {}
+    const varDecl = decl.asKind(SyntaxKind.VariableDeclaration);
+    if (varDecl) {
+        const init = varDecl.getInitializer();
+        if (init)
+            return functionLikeFromExpression(init);
+    }
+    // Already a function-like node
+    return functionLikeFromExpression(decl);
+}
+export function functionLikeFromExpression(expr) {
+    const arrow = expr.asKind(SyntaxKind.ArrowFunction);
+    if (arrow)
+        return arrow.getBody();
+    const fnExpr = expr.asKind(SyntaxKind.FunctionExpression);
+    if (fnExpr)
+        return fnExpr.getBody();
+    // HOF-wrapped: withAuth(async () => {...}) — unwrap first function-like arg
+    const call = expr.asKind(SyntaxKind.CallExpression);
+    if (call) {
+        for (const arg of call.getArguments()) {
+            const body = functionLikeFromExpression(arg);
+            if (body)
+                return body;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=resolve.js.map