@alzulejos/laranja-scanner 0.2.4

package/dist/ast-utils.d.ts

@@ -0,0 +1,34 @@
+import { Node } from "ts-morph";
+import type { ObjectLiteralExpression } from "ts-morph";
+import { type Schedule } from "@alzulejos/laranja-core";
+/** Resolve a literal AST node to a plain JS value, or undefined if not a literal. */
+export declare function literalValue(node: Node | undefined): string | number | boolean | undefined;
+/** Flatten an object literal's simple property assignments into a record. */
+export declare function objectToRecord(obj: ObjectLiteralExpression): Record<string, string | number | boolean | undefined>;
+/**
+ * Constant-fold a call to laranja's own `rate(...)`/`every(...)` helpers using
+ * literal arguments. Returns the neutral structured Schedule, or undefined if
+ * the call isn't a recognized helper or its args aren't literals.
+ */
+export declare function foldScheduleCall(node: Node | undefined): Schedule | undefined;
+/**
+ * Resolve a node used as a schedule into the neutral structured Schedule. Accepts,
+ * in order: a `rate(...)`/`every(...)` helper call; a `CronExpression.MEMBER`
+ * reference; a raw AWS `rate(...)`/`cron(...)` string; or a bare node-cron string
+ * (the `@nestjs/schedule` form, translated to the AWS dialect — which THROWS a
+ * located error for anything EventBridge can't honor). Returns undefined only for
+ * non-static input (e.g. a variable), so callers can raise a "not static" error.
+ */
+export declare function resolveScheduleNode(node: Node | undefined, where: string): Schedule | undefined;
+/** Return the initializer node of a named property on an object literal. */
+export declare function getPropertyInitializer(obj: ObjectLiteralExpression, name: string): Node | undefined;
+/** Read a decorator's first argument as either a string or a flattened object. */
+export declare function readDecoratorArg(node: Node | undefined): {
+    kind: "string";
+    value: string;
+} | {
+    kind: "object";
+    value: Record<string, string | number | boolean | undefined>;
+} | {
+    kind: "unknown";
+};

package/dist/ast-utils.js

@@ -0,0 +1,112 @@
+import { Node, SyntaxKind } from "ts-morph";
+import { rate, every, parseScheduleString, nestCronToSchedule, CRON_EXPRESSION_VALUES, } from "@alzulejos/laranja-core";
+/** Resolve a literal AST node to a plain JS value, or undefined if not a literal. */
+export function literalValue(node) {
+    if (!node)
+        return undefined;
+    if (Node.isStringLiteral(node) || Node.isNoSubstitutionTemplateLiteral(node)) {
+        return node.getLiteralText();
+    }
+    if (Node.isNumericLiteral(node))
+        return Number(node.getLiteralText());
+    if (node.getKind() === SyntaxKind.TrueKeyword)
+        return true;
+    if (node.getKind() === SyntaxKind.FalseKeyword)
+        return false;
+    return undefined;
+}
+/** Flatten an object literal's simple property assignments into a record. */
+export function objectToRecord(obj) {
+    const out = {};
+    for (const prop of obj.getProperties()) {
+        if (Node.isPropertyAssignment(prop)) {
+            out[prop.getName()] = literalValue(prop.getInitializer());
+        }
+    }
+    return out;
+}
+const RATE_UNITS = new Set(["minute", "minutes", "hour", "hours", "day", "days"]);
+/**
+ * Constant-fold a call to laranja's own `rate(...)`/`every(...)` helpers using
+ * literal arguments. Returns the neutral structured Schedule, or undefined if
+ * the call isn't a recognized helper or its args aren't literals.
+ */
+export function foldScheduleCall(node) {
+    if (!node || !Node.isCallExpression(node))
+        return undefined;
+    const callee = node.getExpression();
+    if (!Node.isIdentifier(callee))
+        return undefined;
+    const name = callee.getText();
+    const args = node.getArguments().map((a) => literalValue(a));
+    if (name === "rate" && typeof args[0] === "number" && typeof args[1] === "string" && RATE_UNITS.has(args[1])) {
+        try {
+            return rate(args[0], args[1]);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    if (name === "every" && (args[0] === "minute" || args[0] === "hour" || args[0] === "day")) {
+        return every(args[0]);
+    }
+    return undefined;
+}
+/**
+ * Resolve a `CronExpression.MEMBER` reference to its node-cron string, matching on
+ * the object identifier name (`CronExpression`) and a known member. Alias-agnostic:
+ * whether the enum is imported from laranja or `@nestjs/schedule`, the member names
+ * and values are identical, so we fold through our own mirror.
+ */
+function resolveCronExpressionMember(node) {
+    if (!Node.isPropertyAccessExpression(node))
+        return undefined;
+    const obj = node.getExpression();
+    if (!Node.isIdentifier(obj) || obj.getText() !== "CronExpression")
+        return undefined;
+    return CRON_EXPRESSION_VALUES[node.getName()];
+}
+/**
+ * Resolve a node used as a schedule into the neutral structured Schedule. Accepts,
+ * in order: a `rate(...)`/`every(...)` helper call; a `CronExpression.MEMBER`
+ * reference; a raw AWS `rate(...)`/`cron(...)` string; or a bare node-cron string
+ * (the `@nestjs/schedule` form, translated to the AWS dialect — which THROWS a
+ * located error for anything EventBridge can't honor). Returns undefined only for
+ * non-static input (e.g. a variable), so callers can raise a "not static" error.
+ */
+export function resolveScheduleNode(node, where) {
+    if (!node)
+        return undefined;
+    const folded = foldScheduleCall(node);
+    if (folded)
+        return folded;
+    const enumExpr = resolveCronExpressionMember(node);
+    if (enumExpr !== undefined)
+        return nestCronToSchedule(enumExpr, where);
+    const lit = literalValue(node);
+    if (typeof lit === "string") {
+        // A wrapped AWS string (`rate(...)`/`cron(...)`) is the native form; anything
+        // else that's a string is treated as a node-cron expression and translated.
+        return parseScheduleString(lit) ?? nestCronToSchedule(lit, where);
+    }
+    return undefined;
+}
+/** Return the initializer node of a named property on an object literal. */
+export function getPropertyInitializer(obj, name) {
+    const prop = obj.getProperty(name);
+    if (prop && Node.isPropertyAssignment(prop))
+        return prop.getInitializer();
+    return undefined;
+}
+/** Read a decorator's first argument as either a string or a flattened object. */
+export function readDecoratorArg(node) {
+    if (!node)
+        return { kind: "unknown" };
+    const lit = literalValue(node);
+    if (typeof lit === "string")
+        return { kind: "string", value: lit };
+    if (Node.isObjectLiteralExpression(node))
+        return { kind: "object", value: objectToRecord(node) };
+    return { kind: "unknown" };
+}
+//# sourceMappingURL=ast-utils.js.map

package/dist/ast-utils.js.map

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

package/dist/detect.d.ts

@@ -0,0 +1,3 @@
+import type { Framework } from "@alzulejos/laranja-core";
+/** Detect the framework from the project's package.json dependencies. */
+export declare function detectFramework(projectDir: string): Framework;

package/dist/detect.js

@@ -0,0 +1,14 @@
+import path from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+/** Detect the framework from the project's package.json dependencies. */
+export function detectFramework(projectDir) {
+    const pkgPath = path.join(projectDir, "package.json");
+    if (!existsSync(pkgPath))
+        return "express";
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+    const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+    if (deps["@nestjs/core"])
+        return "nest";
+    return "express";
+}
+//# sourceMappingURL=detect.js.map

package/dist/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGnD,yEAAyE;AACzE,MAAM,UAAU,eAAe,CAAC,UAAkB;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IACtD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAGnD,CAAC;IACF,MAAM,IAAI,GAAG,EAAE,GAAG,GAAG,CAAC,YAAY,EAAE,GAAG,GAAG,CAAC,eAAe,EAAE,CAAC;IAC7D,IAAI,IAAI,CAAC,cAAc,CAAC;QAAE,OAAO,MAAM,CAAC;IACxC,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/dev-scan.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/dev-scan.js

@@ -0,0 +1,19 @@
+/**
+ * Dev helper: scan a project and print its Infra IR.
+ *   npm run scan:express
+ *   tsx packages/scanner/src/dev-scan.ts <project-dir>
+ */
+import path from "node:path";
+import { loadConfig } from "@alzulejos/laranja-core";
+import { scan } from "./scan.js";
+async function main() {
+    const dir = path.resolve(process.argv[2] ?? ".");
+    const config = await loadConfig(dir);
+    const ir = scan({ projectDir: dir, config });
+    console.log(JSON.stringify(ir, null, 2));
+}
+main().catch((err) => {
+    console.error(err instanceof Error ? err.message : err);
+    process.exit(1);
+});
+//# sourceMappingURL=dev-scan.js.map

package/dist/dev-scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-scan.js","sourceRoot":"","sources":["../src/dev-scan.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,KAAK,UAAU,IAAI;IACjB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { scan } from "./scan.js";
+export type { ScanInput } from "./scan.js";
+export { detectFramework } from "./detect.js";
+export { generateResourceTypes, generateResourceTypesStub, resourceIds } from "./resource-types.js";

package/dist/index.js

@@ -0,0 +1,4 @@
+export { scan } from "./scan.js";
+export { detectFramework } from "./detect.js";
+export { generateResourceTypes, generateResourceTypesStub, resourceIds } from "./resource-types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/nest-routes.d.ts

@@ -0,0 +1,9 @@
+import type { SourceFile } from "ts-morph";
+import type { HttpRoute } from "@alzulejos/laranja-core";
+/**
+ * Discover HTTP routes from Nest controllers for visibility/validation — the same
+ * role `collectExpressRoutes` plays for Express. Reads `@Controller("prefix")` +
+ * method decorators (`@Get`/`@Post`/…) and composes the full route path. Matching
+ * is by decorator NAME, which is safe because this only runs for Nest projects.
+ */
+export declare function collectNestRoutes(rel: string, sf: SourceFile, routes: HttpRoute[]): void;

package/dist/nest-routes.js

@@ -0,0 +1,67 @@
+import { Node } from "ts-morph";
+import { getPropertyInitializer } from "./ast-utils.js";
+/** Nest HTTP-method decorators -> the HTTP verb they map to. */
+const NEST_HTTP_METHODS = new Map([
+    ["Get", "GET"],
+    ["Post", "POST"],
+    ["Put", "PUT"],
+    ["Patch", "PATCH"],
+    ["Delete", "DELETE"],
+    ["Options", "OPTIONS"],
+    ["Head", "HEAD"],
+    ["All", "ALL"],
+]);
+/** Read a path string from a decorator arg: string, `["a","b"]` (first), or object `{ path }`. */
+function pathArg(arg) {
+    if (!arg)
+        return "";
+    if (Node.isStringLiteral(arg) || Node.isNoSubstitutionTemplateLiteral(arg)) {
+        return arg.getLiteralText();
+    }
+    if (Node.isArrayLiteralExpression(arg)) {
+        const first = arg.getElements()[0];
+        if (first && (Node.isStringLiteral(first) || Node.isNoSubstitutionTemplateLiteral(first))) {
+            return first.getLiteralText();
+        }
+    }
+    if (Node.isObjectLiteralExpression(arg)) {
+        return pathArg(getPropertyInitializer(arg, "path"));
+    }
+    return "";
+}
+/** The prefix declared by `@Controller(...)` — string, array, or `{ path }` form. */
+function controllerPrefix(dec) {
+    return pathArg(dec.getArguments()[0]);
+}
+/** Join a controller prefix and a method sub-path into one normalized `/path`. */
+function joinPath(prefix, sub) {
+    const segments = `${prefix}/${sub}`.split("/").filter(Boolean);
+    return "/" + segments.join("/");
+}
+/**
+ * Discover HTTP routes from Nest controllers for visibility/validation — the same
+ * role `collectExpressRoutes` plays for Express. Reads `@Controller("prefix")` +
+ * method decorators (`@Get`/`@Post`/…) and composes the full route path. Matching
+ * is by decorator NAME, which is safe because this only runs for Nest projects.
+ */
+export function collectNestRoutes(rel, sf, routes) {
+    for (const cls of sf.getClasses()) {
+        const controller = cls.getDecorator("Controller");
+        if (!controller)
+            continue;
+        const prefix = controllerPrefix(controller);
+        for (const method of cls.getMethods()) {
+            for (const dec of method.getDecorators()) {
+                const httpMethod = NEST_HTTP_METHODS.get(dec.getName());
+                if (!httpMethod)
+                    continue;
+                routes.push({
+                    method: httpMethod,
+                    path: joinPath(prefix, pathArg(dec.getArguments()[0])),
+                    source: `${rel}:${dec.getStartLineNumber()}`,
+                });
+            }
+        }
+    }
+}
+//# sourceMappingURL=nest-routes.js.map

package/dist/nest-routes.js.map

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

package/dist/resource-types.d.ts

@@ -0,0 +1,24 @@
+import type { InfraIR } from "@alzulejos/laranja-core";
+/**
+ * The resource-key ids in a project: "http" (when there's an HTTP app), each
+ * cron's id, and each queue's name. This is the one namespace that `resources`
+ * overrides and DLQ references address — sorted + de-duplicated.
+ */
+export declare function resourceIds(ir: InfraIR): string[];
+/**
+ * Generate the contents of the project's `laranja.types.ts` — the resource‑id
+ * unions plus a `TypedLaranjaConfig` alias that maps each key to the right override
+ * shape. Post‑consolidation a Nest module is one Lambda, so compute lives on a
+ * `WorkerId` (module) key while a grouped cron/queue key only takes its trigger
+ * knobs; a standalone handler (Express / function‑style) is its own Lambda and
+ * keeps compute + trigger. Opting in (typing the config with `TypedLaranjaConfig`)
+ * turns a mistyped id, a compute knob on a grouped handler, or a queue DLQ missing
+ * `maxReceiveCount` into a compile‑time error with autocomplete.
+ */
+export declare function generateResourceTypes(ir: InfraIR): string;
+/**
+ * The stub written by `init`, before any scan has discovered resources. `string`
+ * keeps `resources` permissive (any key, compute + trigger) until the first
+ * deploy/synth narrows it.
+ */
+export declare function generateResourceTypesStub(): string;

package/dist/resource-types.js

@@ -0,0 +1,105 @@
+/**
+ * The resource-key ids in a project: "http" (when there's an HTTP app), each
+ * cron's id, and each queue's name. This is the one namespace that `resources`
+ * overrides and DLQ references address — sorted + de-duplicated.
+ */
+export function resourceIds(ir) {
+    return dedupeSort([
+        ...(ir.http ? ["http"] : []),
+        ...ir.crons.map((c) => c.id),
+        ...ir.queues.map((q) => q.name),
+    ]);
+}
+/** `"a" | "b"` from ids, or `never` when there are none. */
+function unionOf(ids) {
+    return ids.length > 0 ? ids.map((id) => JSON.stringify(id)).join(" | ") : "never";
+}
+function dedupeSort(ids) {
+    return [...new Set(ids)].sort();
+}
+/**
+ * Generate the contents of the project's `laranja.types.ts` — the resource‑id
+ * unions plus a `TypedLaranjaConfig` alias that maps each key to the right override
+ * shape. Post‑consolidation a Nest module is one Lambda, so compute lives on a
+ * `WorkerId` (module) key while a grouped cron/queue key only takes its trigger
+ * knobs; a standalone handler (Express / function‑style) is its own Lambda and
+ * keeps compute + trigger. Opting in (typing the config with `TypedLaranjaConfig`)
+ * turns a mistyped id, a compute knob on a grouped handler, or a queue DLQ missing
+ * `maxReceiveCount` into a compile‑time error with autocomplete.
+ */
+export function generateResourceTypes(ir) {
+    const grouped = (xs, on) => xs.filter((x) => Boolean(x.workersId) === on);
+    return render({
+        http: unionOf(ir.http ? ["http"] : []),
+        worker: unionOf(dedupeSort((ir.workers ?? []).map((w) => w.id))),
+        groupedCron: unionOf(dedupeSort(grouped(ir.crons, true).map((c) => c.id))),
+        standaloneCron: unionOf(dedupeSort(grouped(ir.crons, false).map((c) => c.id))),
+        groupedQueue: unionOf(dedupeSort(grouped(ir.queues, true).map((q) => q.name))),
+        standaloneQueue: unionOf(dedupeSort(grouped(ir.queues, false).map((q) => q.name))),
+    });
+}
+/**
+ * The stub written by `init`, before any scan has discovered resources. `string`
+ * keeps `resources` permissive (any key, compute + trigger) until the first
+ * deploy/synth narrows it.
+ */
+export function generateResourceTypesStub() {
+    return render({
+        http: "string",
+        worker: "never",
+        groupedCron: "never",
+        standaloneCron: "string",
+        groupedQueue: "never",
+        standaloneQueue: "string",
+    });
+}
+function render(ids) {
+    return `// AUTO-GENERATED by laranja — do not edit. Regenerated on deploy/synth/diff.
+import type {
+  LaranjaConfig,
+  HttpResourceConfig,
+  WorkerResourceConfig,
+  CronResourceConfig,
+  CronTriggerConfig,
+  QueueResourceConfig,
+  QueueTriggerConfig,
+} from "@alzulejos/laranja-core";
+
+/** The HTTP app id, if this project serves one. */
+export type HttpResourceId = ${ids.http};
+/** Worker module ids — each is ONE Lambda; set compute (memory/timeout/…) here. */
+export type WorkerId = ${ids.worker};
+/** Cron ids that share a worker module's Lambda (trigger knobs only). */
+type GroupedCronId = ${ids.groupedCron};
+/** Cron ids that are their own Lambda (Express / function-style): compute + trigger. */
+type StandaloneCronId = ${ids.standaloneCron};
+/** Queue names that share a worker module's Lambda (trigger knobs only). */
+type GroupedQueueId = ${ids.groupedQueue};
+/** Queue names that are their own Lambda (Express / function-style): compute + trigger. */
+type StandaloneQueueId = ${ids.standaloneQueue};
+
+/** Cron ids in this project. */
+export type CronResourceId = GroupedCronId | StandaloneCronId;
+/** Queue names in this project (also the valid DLQ targets). */
+export type QueueResourceId = GroupedQueueId | StandaloneQueueId;
+
+/** Every resource id: the http id, worker ids, cron ids, and queue names. */
+export type ResourceId = HttpResourceId | WorkerId | CronResourceId | QueueResourceId;
+
+/**
+ * LaranjaConfig with \`resources\` keys checked against your real resources. Compute
+ * lives on a worker module key; a grouped cron/queue takes only its trigger knobs
+ * (compute there is a compile error pointing at the module); a standalone handler
+ * takes compute + trigger. A queue DLQ requires \`maxReceiveCount\`.
+ */
+export type TypedLaranjaConfig = Omit<LaranjaConfig, "resources"> & {
+  resources?: Partial<Record<HttpResourceId, HttpResourceConfig>> &
+    Partial<Record<WorkerId, WorkerResourceConfig>> &
+    Partial<Record<GroupedCronId, CronTriggerConfig<QueueResourceId>>> &
+    Partial<Record<StandaloneCronId, CronResourceConfig<QueueResourceId>>> &
+    Partial<Record<GroupedQueueId, QueueTriggerConfig<QueueResourceId>>> &
+    Partial<Record<StandaloneQueueId, QueueResourceConfig<QueueResourceId>>>;
+};
+`;
+}
+//# sourceMappingURL=resource-types.js.map

package/dist/resource-types.js.map

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

package/dist/scan.d.ts

@@ -0,0 +1,12 @@
+import { type InfraIR, type LaranjaConfig } from "@alzulejos/laranja-core";
+export interface ScanInput {
+    projectDir: string;
+    config: LaranjaConfig & {
+        env: Record<string, string>;
+    };
+}
+/**
+ * Statically scans the user's project and produces the Infra IR.
+ * No user code is executed — this is pure AST analysis.
+ */
+export declare function scan({ projectDir, config }: ScanInput): InfraIR;