@alzulejos/laranja-runtime 0.2.4

package/dist/codegen.d.ts

@@ -0,0 +1,39 @@
+import type { InfraIR } from "@alzulejos/laranja-core";
+/**
+ * A generated Lambda entry file. These tiny shims are what the bundler points at:
+ * each imports the user's code + the matching runtime factory and re-exports a
+ * `handler`. Generating them (rather than asking users to write them) is what
+ * makes the decorator-driven model work.
+ */
+export interface GeneratedEntry {
+    /** Logical id of the resulting Lambda (matches the IR id). */
+    id: string;
+    /** "worker" = a consolidated Nest module Lambda hosting several crons/queues. */
+    kind: "http" | "cron" | "queue" | "worker";
+    /** File name to write under the entry dir. */
+    fileName: string;
+    /** Exported handler symbol (always "handler" for now). */
+    handlerExport: string;
+    contents: string;
+}
+export interface GenerateEntriesOptions {
+    /** Absolute path to the user's project root. */
+    projectDir: string;
+    /** Absolute path to the dir the entry files will be written to. */
+    entryDir: string;
+    /**
+     * Absolute path the HTTP shim should import instead of `<projectDir>/<http.handlerEntry>`.
+     * Used for Nest: the shim imports the user's COMPILED bootstrap (e.g.
+     * `dist/main.js`, which carries the DI metadata their build emitted) rather than
+     * the `.ts` source. Ignored for the worker shims.
+     */
+    httpEntry?: string;
+    /**
+     * Map a source file to its COMPILED path. Nest class-based workers must import the
+     * compiled provider AND their compiled `workers(...)` module (DI metadata intact),
+     * not the `.ts` source. Absent for Express, where shims bundle straight from source.
+     */
+    resolveCompiled?: (file: string) => string;
+}
+/** Generate all Lambda entry shims for an Infra IR. */
+export declare function generateEntries(ir: InfraIR, opts: GenerateEntriesOptions): GeneratedEntry[];

package/dist/codegen.js

@@ -0,0 +1,174 @@
+import path from "node:path";
+/** Build an import specifier from `fromDir` to a source file, posix-style, no extension. */
+function importSpecifier(fromDir, toFile) {
+    let rel = path.relative(fromDir, toFile.replace(/\.(ts|tsx|mts|cts|js|jsx|mjs|cjs)$/, ""));
+    rel = rel.split(path.sep).join("/");
+    if (!rel.startsWith("."))
+        rel = `./${rel}`;
+    return rel;
+}
+/** Make an id safe to use as a file name. */
+function safe(id) {
+    return id.replace(/[^A-Za-z0-9_-]/g, "_");
+}
+/** An `import` line binding a (possibly-default, possibly-aliased) export to a local name. */
+function importBinding(local, exportName, spec) {
+    if (exportName === "default")
+        return `import ${local} from "${spec}";`;
+    if (exportName === local)
+        return `import { ${local} } from "${spec}";`;
+    return `import { ${exportName} as ${local} } from "${spec}";`;
+}
+/**
+ * The consolidated Nest worker shim: ONE Lambda for a whole `workers()` module.
+ * Imports the compiled module once + each hosted provider once, then wires a
+ * `createNestWorkerDispatcher` with two routing tables — crons keyed by id (the
+ * EventBridge input), queues keyed by name (the SQS source). `NestFactory` is
+ * imported from the user's own `@nestjs/core`, keeping the runtime package
+ * framework-agnostic.
+ */
+function workerDispatcherShim(worker, crons, queues, opts) {
+    if (!opts.resolveCompiled) {
+        throw new Error(`Cannot generate the worker shim for "${worker.id}": missing the compiled module. ` +
+            `Add \`export default workers(${worker.id})\` and build first.`);
+    }
+    const resolve = opts.resolveCompiled;
+    const workersSpec = importSpecifier(opts.entryDir, resolve(worker.handlerEntry));
+    const workersImport = importBinding("workersModule", worker.appExport, workersSpec);
+    // Import each provider class once, even if it hosts several methods.
+    const providerImports = new Map();
+    const cronRows = [];
+    const queueRows = [];
+    for (const c of crons) {
+        if (c.style !== "method")
+            continue;
+        providerImports.set(c.className, importSpecifier(opts.entryDir, resolve(c.file)));
+        cronRows.push(`      "${c.id}": [${c.className}, "${c.method}"],`);
+    }
+    for (const q of queues) {
+        if (q.style !== "method")
+            continue;
+        providerImports.set(q.className, importSpecifier(opts.entryDir, resolve(q.file)));
+        queueRows.push(`      "${q.name}": [${q.className}, "${q.method}"],`);
+    }
+    const imports = [...providerImports].map(([cls, spec]) => `import { ${cls} } from "${spec}";`).join("\n");
+    return `import { NestFactory } from "@nestjs/core";
+${workersImport}
+${imports}
+import { createNestWorkerDispatcher } from "@alzulejos/laranja-runtime";
+
+export const handler = createNestWorkerDispatcher(
+  () => NestFactory.createApplicationContext(workersModule),
+  {
+    crons: {
+${cronRows.join("\n")}
+    },
+    queues: {
+${queueRows.join("\n")}
+    },
+  },
+);
+`;
+}
+/**
+ * The import line + runtime-factory arguments for a handler, branching on whether
+ * it's a class method (`Ctor, "method"`) or a standalone function (`fn`).
+ */
+function handlerWiring(ref, spec) {
+    if (ref.style === "function") {
+        return {
+            importLine: `import { ${ref.exportName} } from "${spec}";`,
+            factoryArgs: ref.exportName,
+        };
+    }
+    return {
+        importLine: `import { ${ref.className} } from "${spec}";`,
+        factoryArgs: `${ref.className}, "${ref.method}"`,
+    };
+}
+/** Generate all Lambda entry shims for an Infra IR. */
+export function generateEntries(ir, opts) {
+    const entries = [];
+    const isNest = ir.app.framework === "nest";
+    const workers = ir.workers ?? [];
+    // A method-style Nest handler is GROUPED into its module's one worker Lambda.
+    const isGrouped = (h) => isNest && h.style === "method" && h.workersId !== undefined;
+    // HTTP proxy: one Lambda wrapping the whole app. Absent for workers-only apps.
+    // Express exports a ready app instance (createHttpHandler(app)); Nest exports an
+    // async bootstrap factory that returns the app (createNestHttpHandler(bootstrap)),
+    // and its shim imports the COMPILED bootstrap via `opts.httpEntry`.
+    if (ir.http) {
+        const local = isNest ? "bootstrap" : "app";
+        const factory = isNest ? "createNestHttpHandler" : "createHttpHandler";
+        const httpTarget = opts.httpEntry ?? path.join(opts.projectDir, ir.http.handlerEntry);
+        const httpSpec = importSpecifier(opts.entryDir, httpTarget);
+        const appImport = importBinding(local, ir.http.appExport, httpSpec);
+        entries.push({
+            id: "http",
+            kind: "http",
+            fileName: "http.ts",
+            handlerExport: "handler",
+            contents: `${appImport}
+import { ${factory} } from "@alzulejos/laranja-runtime";
+
+export const handler = ${factory}(${local});
+`,
+        });
+    }
+    // Worker Lambdas: one per `workers()` module, hosting all its grouped (method-
+    // style) crons + queues behind a single dispatcher. This is where bundle
+    // duplication disappears — the module's DI graph is bundled once, not per handler.
+    for (const w of workers) {
+        const crons = ir.crons.filter((c) => c.workersId === w.id && c.style === "method");
+        const queues = ir.queues.filter((q) => q.workersId === w.id && q.style === "method");
+        if (crons.length === 0 && queues.length === 0)
+            continue;
+        entries.push({
+            id: w.id,
+            kind: "worker",
+            fileName: `worker-${safe(w.id)}.ts`,
+            handlerExport: "handler",
+            contents: workerDispatcherShim(w, crons, queues, opts),
+        });
+    }
+    // Cron: one Lambda per STANDALONE @Cron / cron() (Express classes, or function-
+    // style). Grouped Nest crons are hosted by their worker Lambda above.
+    for (const cron of ir.crons) {
+        if (isGrouped(cron))
+            continue;
+        const spec = importSpecifier(opts.entryDir, path.join(opts.projectDir, cron.file));
+        const { importLine, factoryArgs } = handlerWiring(cron, spec);
+        entries.push({
+            id: cron.id,
+            kind: "cron",
+            fileName: `cron-${safe(cron.id)}.ts`,
+            handlerExport: "handler",
+            contents: `${importLine}
+import { createScheduledHandler } from "@alzulejos/laranja-runtime";
+
+export const handler = createScheduledHandler(${factoryArgs});
+`,
+        });
+    }
+    // Queue: one consumer Lambda per STANDALONE @Queue / queue(). Grouped Nest
+    // queues are hosted by their worker Lambda above.
+    for (const queue of ir.queues) {
+        if (isGrouped(queue))
+            continue;
+        const spec = importSpecifier(opts.entryDir, path.join(opts.projectDir, queue.file));
+        const { importLine, factoryArgs } = handlerWiring(queue, spec);
+        entries.push({
+            id: queue.id,
+            kind: "queue",
+            fileName: `queue-${safe(queue.id)}.ts`,
+            handlerExport: "handler",
+            contents: `${importLine}
+import { createQueueHandler } from "@alzulejos/laranja-runtime";
+
+export const handler = createQueueHandler(${factoryArgs});
+`,
+        });
+    }
+    return entries;
+}
+//# sourceMappingURL=codegen.js.map

package/dist/codegen.js.map

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

package/dist/dev-build.d.ts

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

package/dist/dev-build.js

@@ -0,0 +1,54 @@
+/**
+ * Dev helper: scan a project, generate Lambda entry shims, and smoke-bundle them
+ * with esbuild to prove the decorator -> shim -> bundle path resolves end to end.
+ *
+ *   npm run build:express
+ *   tsx packages/runtime/src/dev-build.ts <project-dir>
+ */
+import path from "node:path";
+import { mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { build } from "esbuild";
+import { loadConfig } from "@alzulejos/laranja-core";
+import { scan } from "@alzulejos/laranja-scanner";
+import { generateEntries } from "./codegen.js";
+async function main() {
+    const projectDir = path.resolve(process.argv[2] ?? ".");
+    const outRoot = path.join(projectDir, ".laranja");
+    const entryDir = path.join(outRoot, "entries");
+    const buildDir = path.join(outRoot, "build");
+    rmSync(outRoot, { recursive: true, force: true });
+    mkdirSync(entryDir, { recursive: true });
+    const config = await loadConfig(projectDir);
+    const ir = scan({ projectDir, config });
+    const entries = generateEntries(ir, { projectDir, entryDir });
+    for (const e of entries) {
+        writeFileSync(path.join(entryDir, e.fileName), e.contents);
+    }
+    console.log(`Generated ${entries.length} entry shims:`);
+    for (const e of entries) {
+        console.log(`  [${e.kind.padEnd(5)}] ${e.fileName}  ->  ${e.id}`);
+    }
+    const result = await build({
+        entryPoints: entries.map((e) => path.join(entryDir, e.fileName)),
+        outdir: buildDir,
+        bundle: true,
+        platform: "node",
+        target: "node20",
+        format: "cjs",
+        outExtension: { ".js": ".cjs" },
+        external: ["@aws-sdk/*", "aws-sdk"],
+        logLevel: "warning",
+        metafile: true,
+    });
+    console.log("\nBundled (handler = <file>.handler):");
+    for (const [file, out] of Object.entries(result.metafile.outputs)) {
+        if (file.endsWith(".cjs")) {
+            console.log(`  ${path.relative(projectDir, file)}  (${(out.bytes / 1024).toFixed(1)} KB)`);
+        }
+    }
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=dev-build.js.map

package/dist/dev-build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-build.js","sourceRoot":"","sources":["../src/dev-build.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,KAAK,UAAU,IAAI;IACjB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAE7C,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEzC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE9D,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,aAAa,OAAO,CAAC,MAAM,eAAe,CAAC,CAAC;IACxD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC;QACzB,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;QAChE,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,IAAI;QACZ,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,KAAK;QACb,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;QAC/B,QAAQ,EAAE,CAAC,YAAY,EAAE,SAAS,CAAC;QACnC,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;IACrD,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAClE,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC7F,CAAC;IACH,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/http.d.ts

@@ -0,0 +1,13 @@
+import { configure } from "@codegenie/serverless-express";
+import type { Handler } from "aws-lambda";
+/**
+ * The user's framework app (Express in v1). Typed via the adapter's own param so
+ * we don't take a hard dependency on express's types here.
+ */
+export type FrameworkApp = Parameters<typeof configure>[0]["app"];
+/**
+ * Wraps the user's exported app in an API Gateway proxy handler. This is the
+ * single Lambda that serves ALL HTTP routes (the proxy model). The adapter caches
+ * its server across warm invocations internally.
+ */
+export declare function createHttpHandler(app: FrameworkApp): Handler;

package/dist/http.js

@@ -0,0 +1,10 @@
+import { configure } from "@codegenie/serverless-express";
+/**
+ * Wraps the user's exported app in an API Gateway proxy handler. This is the
+ * single Lambda that serves ALL HTTP routes (the proxy model). The adapter caches
+ * its server across warm invocations internally.
+ */
+export function createHttpHandler(app) {
+    return configure({ app });
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAS1D;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAiB;IACjD,OAAO,SAAS,CAAC,EAAE,GAAG,EAAE,CAAY,CAAC;AACvC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { createHttpHandler } from "./http.js";
+export type { FrameworkApp } from "./http.js";
+export { createNestHttpHandler } from "./nest-http.js";
+export type { NestAppLike, NestBootstrap } from "./nest-http.js";
+export { createScheduledHandler } from "./scheduled.js";
+export { createQueueHandler } from "./queue.js";
+export type { QueueConsumer } from "./queue.js";
+export { createNestScheduledHandler, createNestQueueHandler, createNestWorkerDispatcher } from "./nest-worker.js";
+export type { NestContextLike, NestContextFactory, DispatchEntry } from "./nest-worker.js";
+export { generateEntries } from "./codegen.js";
+export type { GeneratedEntry, GenerateEntriesOptions } from "./codegen.js";

package/dist/index.js

@@ -0,0 +1,9 @@
+export { createHttpHandler } from "./http.js";
+export { createNestHttpHandler } from "./nest-http.js";
+export { createScheduledHandler } from "./scheduled.js";
+export { createQueueHandler } from "./queue.js";
+export { createNestScheduledHandler, createNestQueueHandler, createNestWorkerDispatcher } from "./nest-worker.js";
+// Build-time codegen (not used inside the Lambda, but co-located because it
+// generates code that imports the factories above).
+export { generateEntries } from "./codegen.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,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAGlH,4EAA4E;AAC5E,oDAAoD;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/nest-http.d.ts

@@ -0,0 +1,34 @@
+import type { Handler } from "aws-lambda";
+import { type FrameworkApp } from "./http.js";
+/**
+ * The slice of a NestJS `INestApplication` we actually touch. Kept structural —
+ * no `@nestjs` import — so the runtime package stays framework-agnostic, exactly
+ * like `http.ts` avoids a hard express dependency. The user's app supplies the
+ * real instance at runtime.
+ */
+export interface NestAppLike {
+    /** Idempotent in Nest: safe to call even if `bootstrap()` already listened. */
+    init(): Promise<unknown>;
+    /** Yields the underlying Express app (requires `@nestjs/platform-express`). */
+    getHttpAdapter(): {
+        getInstance(): FrameworkApp;
+    };
+}
+/**
+ * The user's exported bootstrap: creates + configures a Nest app and RETURNS it
+ * (`export default http(bootstrap)`). Unlike Express — a ready synchronous app —
+ * a Nest app only exists after an async `NestFactory.create`, so laranja wraps the
+ * factory rather than an instance.
+ */
+export type NestBootstrap = () => Promise<NestAppLike>;
+/**
+ * The Nest counterpart to `createHttpHandler`: wraps the user's bootstrap factory
+ * in an API Gateway proxy handler (the single Lambda serving ALL routes).
+ *
+ * We run the user's `bootstrap()` verbatim — so every pipe/guard/middleware they
+ * configured is preserved — then `init()` it (idempotent even if their bootstrap
+ * also called `listen`), extract the underlying Express instance, and hand it to
+ * the shared serverless-express adapter. The app + adapter are built once and
+ * cached across warm invocations.
+ */
+export declare function createNestHttpHandler(bootstrap: NestBootstrap): Handler;

package/dist/nest-http.js

@@ -0,0 +1,23 @@
+import { createHttpHandler } from "./http.js";
+/**
+ * The Nest counterpart to `createHttpHandler`: wraps the user's bootstrap factory
+ * in an API Gateway proxy handler (the single Lambda serving ALL routes).
+ *
+ * We run the user's `bootstrap()` verbatim — so every pipe/guard/middleware they
+ * configured is preserved — then `init()` it (idempotent even if their bootstrap
+ * also called `listen`), extract the underlying Express instance, and hand it to
+ * the shared serverless-express adapter. The app + adapter are built once and
+ * cached across warm invocations.
+ */
+export function createNestHttpHandler(bootstrap) {
+    let cached;
+    return (async (event, context, callback) => {
+        if (!cached) {
+            const app = await bootstrap();
+            await app.init();
+            cached = createHttpHandler(app.getHttpAdapter().getInstance());
+        }
+        return cached(event, context, callback);
+    });
+}
+//# sourceMappingURL=nest-http.js.map

package/dist/nest-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nest-http.js","sourceRoot":"","sources":["../src/nest-http.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAqB,MAAM,WAAW,CAAC;AAuBjE;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAwB;IAC5D,IAAI,MAA2B,CAAC;IAChC,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;QACzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,MAAM,SAAS,EAAE,CAAC;YAC9B,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC,CAAY,CAAC;AAChB,CAAC"}

package/dist/nest-worker.d.ts

@@ -0,0 +1,43 @@
+import type { Context, Handler, SQSBatchResponse, SQSEvent } from "aws-lambda";
+/** A DI‑resolvable provider + the method to invoke on it. */
+export type DispatchEntry = [Ctor<object>, string];
+/**
+ * Nest-backed worker handlers. Unlike the Express path — where a `@Cron`/`@Queue`
+ * class is `new`'d directly — a Nest provider's method depends on injected
+ * services, so we must resolve the instance through the DI container. The
+ * generated shim hands us a factory that builds a standalone Nest context
+ * (`NestFactory.createApplicationContext(WorkersModule)`); we build it once, cache
+ * it across warm invocations, and pull the provider out with `context.get()`.
+ *
+ * Kept structural (no `@nestjs/*` import) so the runtime package stays
+ * framework-agnostic — the shim, generated inside the user's Nest project, is what
+ * imports `NestFactory`.
+ */
+/** The slice of a Nest `INestApplicationContext` we use: DI resolution by class. */
+export interface NestContextLike {
+    get<T>(type: new (...args: any[]) => T): T;
+}
+/** Builds the standalone Nest context. Async in Nest (`createApplicationContext`). */
+export type NestContextFactory = () => NestContextLike | Promise<NestContextLike>;
+type Ctor<T> = new (...args: any[]) => T;
+/** The Nest counterpart to `createScheduledHandler` — resolves the provider via DI. */
+export declare function createNestScheduledHandler<T extends object>(contextFactory: NestContextFactory, Ctor: Ctor<T>, method: keyof T & string): Handler;
+/** The Nest counterpart to `createQueueHandler` — resolves the consumer via DI. */
+export declare function createNestQueueHandler<T extends object>(contextFactory: NestContextFactory, Ctor: Ctor<T>, method: keyof T & string): (event: SQSEvent, context: Context) => Promise<SQSBatchResponse>;
+/**
+ * The consolidated worker handler: ONE Lambda for a whole `workers()` module,
+ * hosting all its `@Cron` and `@Queue` methods. It builds the module's DI context
+ * once (cached across warm invocations) and routes by event shape —
+ *
+ *  - **SQS** (`Records` present): each record → the consumer for its source queue,
+ *    looked up by `eventSourceARN`, through the partial‑batch‑failure contract.
+ *  - **EventBridge**: our schedules pass `{ handler: "<cronId>" }` → the cron method.
+ *
+ * The routing tables map an id to `[Provider, method]`; the provider resolves
+ * through DI so injected dependencies work exactly as in the app.
+ */
+export declare function createNestWorkerDispatcher(contextFactory: NestContextFactory, tables: {
+    crons: Record<string, DispatchEntry>;
+    queues: Record<string, DispatchEntry>;
+}): Handler;
+export {};

package/dist/nest-worker.js

@@ -0,0 +1,73 @@
+import { runSqsBatch } from "./queue.js";
+/** Build (once) the context, resolve the provider, and pull the target method off it.
+ *  `method` is a plain string (the dispatch tables carry `[Provider, "name"]`), so
+ *  there's no compile-time `keyof` guard here — the runtime check below catches a
+ *  bad name. */
+function resolveMethod(ctx, Ctor, method, kind) {
+    const instance = ctx.get(Ctor);
+    const fn = instance[method];
+    if (typeof fn !== "function") {
+        throw new Error(`${kind} target ${Ctor.name}.${method} is not a method`);
+    }
+    return fn.bind(instance);
+}
+/** The Nest counterpart to `createScheduledHandler` — resolves the provider via DI. */
+export function createNestScheduledHandler(contextFactory, Ctor, method) {
+    let call;
+    return (async (event, context) => {
+        call ??= resolveMethod(await contextFactory(), Ctor, method, "@Cron");
+        return await call(event, context);
+    });
+}
+/** The Nest counterpart to `createQueueHandler` — resolves the consumer via DI. */
+export function createNestQueueHandler(contextFactory, Ctor, method) {
+    let consumer;
+    return async (event, context) => {
+        consumer ??= resolveMethod(await contextFactory(), Ctor, method, "@Queue");
+        return runSqsBatch(consumer, event, context);
+    };
+}
+/** The declared queue name is the last `:`‑segment of an SQS `eventSourceARN`
+ *  (`arn:aws:sqs:<region>:<acct>:<name>`); laranja names the queue = its declared
+ *  name, so this maps a record straight back to the routing table key. */
+function queueNameFromArn(arn) {
+    return arn.slice(arn.lastIndexOf(":") + 1);
+}
+function isSqsEvent(event) {
+    return !!event && typeof event === "object" && Array.isArray(event.Records);
+}
+/**
+ * The consolidated worker handler: ONE Lambda for a whole `workers()` module,
+ * hosting all its `@Cron` and `@Queue` methods. It builds the module's DI context
+ * once (cached across warm invocations) and routes by event shape —
+ *
+ *  - **SQS** (`Records` present): each record → the consumer for its source queue,
+ *    looked up by `eventSourceARN`, through the partial‑batch‑failure contract.
+ *  - **EventBridge**: our schedules pass `{ handler: "<cronId>" }` → the cron method.
+ *
+ * The routing tables map an id to `[Provider, method]`; the provider resolves
+ * through DI so injected dependencies work exactly as in the app.
+ */
+export function createNestWorkerDispatcher(contextFactory, tables) {
+    let ctx;
+    const getCtx = async () => (ctx ??= await contextFactory());
+    return (async (event, context) => {
+        if (isSqsEvent(event)) {
+            const c = await getCtx();
+            const consumer = (body, record, ctx2) => {
+                const name = queueNameFromArn(record.eventSourceARN);
+                const entry = tables.queues[name];
+                if (!entry)
+                    throw new Error(`worker: no @Queue consumer for "${name}"`);
+                return resolveMethod(c, entry[0], entry[1], "@Queue")(body, record, ctx2);
+            };
+            return runSqsBatch(consumer, event, context);
+        }
+        const handlerId = event?.handler;
+        const entry = handlerId ? tables.crons[handlerId] : undefined;
+        if (!entry)
+            throw new Error(`worker: no @Cron handler for "${String(handlerId)}"`);
+        return await resolveMethod(await getCtx(), entry[0], entry[1], "@Cron")(event, context);
+    });
+}
+//# sourceMappingURL=nest-worker.js.map

package/dist/nest-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nest-worker.js","sourceRoot":"","sources":["../src/nest-worker.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAsB,MAAM,YAAY,CAAC;AA4B7D;;;gBAGgB;AAChB,SAAS,aAAa,CACpB,GAAoB,EACpB,IAAa,EACb,MAAc,EACd,IAAwB;IAExB,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,EAAE,GAAI,QAAoC,CAAC,MAAM,CAAC,CAAC;IACzD,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,WAAW,IAAI,CAAC,IAAI,IAAI,MAAM,kBAAkB,CAAC,CAAC;IAC3E,CAAC;IACD,OAAQ,EAAsC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAChE,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,0BAA0B,CACxC,cAAkC,EAClC,IAAa,EACb,MAAwB;IAExB,IAAI,IAAmD,CAAC;IACxD,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC/B,IAAI,KAAK,aAAa,CAAC,MAAM,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACtE,OAAO,MAAM,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC,CAAY,CAAC;AAChB,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,sBAAsB,CACpC,cAAkC,EAClC,IAAa,EACb,MAAwB;IAExB,IAAI,QAAmC,CAAC;IACxC,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC9B,QAAQ,KAAK,aAAa,CAAC,MAAM,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAkB,CAAC;QAC5F,OAAO,WAAW,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC,CAAC;AACJ,CAAC;AAED;;0EAE0E;AAC1E,SAAS,gBAAgB,CAAC,GAAW;IACnC,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAE,KAA+B,CAAC,OAAO,CAAC,CAAC;AACzG,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,0BAA0B,CACxC,cAAkC,EAClC,MAAuF;IAEvF,IAAI,GAAgC,CAAC;IACrC,MAAM,MAAM,GAAG,KAAK,IAA8B,EAAE,CAAC,CAAC,GAAG,KAAK,MAAM,cAAc,EAAE,CAAC,CAAC;IAEtF,OAAO,CAAC,KAAK,EAAE,KAAc,EAAE,OAAgB,EAAE,EAAE;QACjD,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,MAAM,MAAM,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;gBACrD,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;gBACrD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAClC,IAAI,CAAC,KAAK;oBAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,IAAI,GAAG,CAAC,CAAC;gBACxE,OAAO,aAAa,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;YAC5E,CAAC,CAAC;YACF,OAAO,WAAW,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,SAAS,GAAI,KAAqC,EAAE,OAAO,CAAC;QAClE,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9D,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACnF,OAAO,MAAM,aAAa,CAAC,MAAM,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC1F,CAAC,CAAY,CAAC;AAChB,CAAC"}

package/dist/queue.d.ts

@@ -0,0 +1,23 @@
+import type { Context, SQSBatchResponse, SQSEvent, SQSRecord } from "aws-lambda";
+type Ctor<T> = new () => T;
+/** The signature an `@Queue` consumer method receives: parsed body + raw record. */
+export type QueueConsumer = (body: unknown, record: SQSRecord, context: Context) => unknown | Promise<unknown>;
+/**
+ * Drive an SQS batch through a consumer, one message at a time, collecting the
+ * IDs that threw into the partial-batch-failure response. Shared by the plain and
+ * the Nest/DI-backed consumer handlers so the retry contract lives in one place.
+ */
+export declare function runSqsBatch(consumer: QueueConsumer, event: SQSEvent, context: Context): Promise<SQSBatchResponse>;
+/**
+ * Builds the Lambda handler for a `@Queue` method or `queue()` function. Calls the
+ * consumer once per message with the JSON-parsed body. Failed messages are
+ * reported back via the partial-batch-failure contract, so the CDK event source
+ * must enable `reportBatchItemFailures`.
+ *
+ * - Function form (`createQueueHandler(fn)`): calls the function per message.
+ * - Method form (`createQueueHandler(Ctor, "method")`): instantiates the class
+ *   once (cached) and calls the decorated method.
+ */
+export declare function createQueueHandler(consumer: QueueConsumer): (event: SQSEvent, context: Context) => Promise<SQSBatchResponse>;
+export declare function createQueueHandler<T extends object>(Ctor: Ctor<T>, method: keyof T & string): (event: SQSEvent, context: Context) => Promise<SQSBatchResponse>;
+export {};

package/dist/queue.js

@@ -0,0 +1,41 @@
+function parseBody(body) {
+    try {
+        return JSON.parse(body);
+    }
+    catch {
+        return body;
+    }
+}
+/**
+ * Drive an SQS batch through a consumer, one message at a time, collecting the
+ * IDs that threw into the partial-batch-failure response. Shared by the plain and
+ * the Nest/DI-backed consumer handlers so the retry contract lives in one place.
+ */
+export async function runSqsBatch(consumer, event, context) {
+    const batchItemFailures = [];
+    for (const record of event.Records) {
+        try {
+            await consumer(parseBody(record.body), record, context);
+        }
+        catch {
+            batchItemFailures.push({ itemIdentifier: record.messageId });
+        }
+    }
+    return { batchItemFailures };
+}
+export function createQueueHandler(target, method) {
+    let instance;
+    const resolveConsumer = () => {
+        if (method === undefined)
+            return target;
+        const Ctor = target;
+        instance ??= new Ctor();
+        const fn = instance[method];
+        if (typeof fn !== "function") {
+            throw new Error(`@Queue target ${Ctor.name}.${String(method)} is not a method`);
+        }
+        return fn.bind(instance);
+    };
+    return async (event, context) => runSqsBatch(resolveConsumer(), event, context);
+}
+//# sourceMappingURL=queue.js.map

package/dist/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"AAOA,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAuB,EACvB,KAAe,EACf,OAAgB;IAEhB,MAAM,iBAAiB,GAAiC,EAAE,CAAC;IAC3D,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB,CAAC,IAAI,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IACD,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAC/B,CAAC;AAmBD,MAAM,UAAU,kBAAkB,CAChC,MAA+B,EAC/B,MAAyB;IAEzB,IAAI,QAAuB,CAAC;IAC5B,MAAM,eAAe,GAAG,GAAkB,EAAE;QAC1C,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAuB,CAAC;QACzD,MAAM,IAAI,GAAG,MAAiB,CAAC;QAC/B,QAAQ,KAAK,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAY,CAAC;QACvC,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAClF,CAAC;QACD,OAAQ,EAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC,CAAC;IAEF,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAClF,CAAC"}

package/dist/scheduled.d.ts

@@ -0,0 +1,16 @@
+import type { Context, Handler } from "aws-lambda";
+type Ctor<T> = new () => T;
+/** A standalone scheduled function registered via `cron(...)`. */
+export type ScheduledFn = (event: unknown, context: Context) => unknown | Promise<unknown>;
+/**
+ * Builds the Lambda handler for a `@Cron` method or `cron()` function. EventBridge
+ * invokes this on a schedule.
+ *
+ * - Function form (`createScheduledHandler(fn)`): just calls the function.
+ * - Method form (`createScheduledHandler(Ctor, "method")`): instantiates the class
+ *   once (cached across warm invocations — v1 assumes a no-arg constructor) and
+ *   calls the decorated method.
+ */
+export declare function createScheduledHandler(handler: ScheduledFn): Handler;
+export declare function createScheduledHandler<T extends object>(Ctor: Ctor<T>, method: keyof T & string): Handler;
+export {};

package/dist/scheduled.js

@@ -0,0 +1,17 @@
+export function createScheduledHandler(target, method) {
+    if (method === undefined) {
+        const fn = target;
+        return async (event, context) => await fn(event, context);
+    }
+    const Ctor = target;
+    let instance;
+    return async (event, context) => {
+        instance ??= new Ctor();
+        const fn = instance[method];
+        if (typeof fn !== "function") {
+            throw new Error(`@Cron target ${Ctor.name}.${String(method)} is not a method`);
+        }
+        return await fn.call(instance, event, context);
+    };
+}
+//# sourceMappingURL=scheduled.js.map

package/dist/scheduled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled.js","sourceRoot":"","sources":["../src/scheduled.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,sBAAsB,CACpC,MAA6B,EAC7B,MAAyB;IAEzB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,MAAqB,CAAC;QACjC,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,IAAI,GAAG,MAAiB,CAAC;IAC/B,IAAI,QAAuB,CAAC;IAC5B,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC9B,QAAQ,KAAK,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAY,CAAC;QACvC,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACjF,CAAC;QACD,OAAO,MAAO,EAAsC,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACtF,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@alzulejos/laranja-runtime",
+  "version": "0.2.4",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@codegenie/serverless-express": "^4.1.6",
+    "@alzulejos/laranja-core": "0.2.4"
+  },
+  "devDependencies": {
+    "@alzulejos/laranja-scanner": "0.2.4",
+    "@types/aws-lambda": "^8.10.145",
+    "esbuild": "^0.28.1"
+  }
+}