@alzulejos/laranja 0.2.4

package/dist/commands/destroy.js

@@ -0,0 +1,60 @@
+import { loadConfig, stackName, resolveApiKey, postDestroy, patchDeployment } from "@alzulejos/laranja-core";
+import { getAccountId, deleteStack } from "../aws.js";
+import { reportSafely } from "../lifecycle.js";
+import { step, note } from "../diagnostics.js";
+import { applyAwsEnv, confirm, requireRegion } from "../io.js";
+import * as ui from "../ui.js";
+export async function destroy(projectDir, opts = {}) {
+    step("load config");
+    const config = await loadConfig(projectDir, { stage: opts.stage });
+    const region = requireRegion(config.region);
+    applyAwsEnv({ region, profile: config.profile });
+    // Destroy talks to the dashboard to open a teardown row, and that call is the
+    // permission gate. Require credentials up front (and fail-closed on the gate
+    // below) so nothing gets deleted unless the API authenticates and authorizes
+    // us first — a missing/revoked key or an unreachable API must stop here.
+    const apiKey = resolveApiKey();
+    if (!apiKey) {
+        throw new Error("Set LARANJA_API_KEY (or run `laranja init`) to destroy.");
+    }
+    const projectId = config.projectId;
+    if (!projectId) {
+        throw new Error("This project isn't linked to laranja — run `laranja init` before destroy.");
+    }
+    step("resolve account");
+    const account = await getAccountId(region);
+    const name = stackName(config.name, config.stage);
+    note({ project: config.name, stage: config.stage, region, account, stackName: name });
+    ui.header(`destroy ${config.name} ${ui.dim(config.stage)} ${ui.dim("→")} ${region}`);
+    ui.step("🔑", "account", account);
+    ui.note(`this will DELETE the "${config.name}" (${config.stage}) stack and its resources.`);
+    if (!(await confirm("     are you sure? (y/N)"))) {
+        console.log("\n  aborted.\n");
+        return;
+    }
+    // Open the teardown row. This is the permission gate: it authenticates the API
+    // key and authorizes the destroy against the project. Fail-closed — a bad or
+    // revoked key, a forbidden project, or an unreachable API throws here and
+    // aborts before we touch CloudFormation. The BE owns the REMOVED resource
+    // inventory, so the client only sends the stack identity — no IR, no synth.
+    step("open teardown");
+    const deploymentId = await postDestroy({ stackName: name, artifact: "cloudformation", provider: "AWS", region }, apiKey, projectId);
+    note({ deploymentId });
+    await reportSafely("report start", () => patchDeployment(deploymentId, { status: "STARTED", region }, apiKey, projectId));
+    // No synth, local or remote — CloudFormation deletes the stack by name.
+    step("delete stack");
+    const sp = ui.spinner("tearing down stack");
+    let existed;
+    try {
+        existed = await deleteStack(region, name);
+        sp.succeed(existed ? "destroyed" : "nothing to destroy (no such stack)");
+    }
+    catch (err) {
+        sp.fail("destroy failed");
+        await reportSafely("report failure", () => patchDeployment(deploymentId, { status: "FAILED" }, apiKey, projectId));
+        throw err;
+    }
+    await reportSafely("report success", () => patchDeployment(deploymentId, { status: "SUCCESS" }, apiKey, projectId));
+    console.log(`\n  ${ui.orange("🧹 gone")}\n`);
+}
+//# sourceMappingURL=destroy.js.map

package/dist/commands/destroy.js.map

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

package/dist/commands/eject.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generate a standalone, owned CDK project. The project is synthesized on the
+ * laranja server (paid; the server gates entitlement and returns 403 if the
+ * caller can't eject) — we just write the returned files to `infra/`.
+ */
+export declare function eject(projectDir: string, opts: {
+    force?: boolean;
+    stage?: string;
+}): Promise<void>;

package/dist/commands/eject.js

@@ -0,0 +1,45 @@
+import path from "node:path";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { loadConfig, resolveApiKey, postEject, ApiRequestError, apiErrorMessage } from "@alzulejos/laranja-core";
+import { scan } from "@alzulejos/laranja-scanner";
+import { writeResourceTypes } from "../resource-types.js";
+/**
+ * Generate a standalone, owned CDK project. The project is synthesized on the
+ * laranja server (paid; the server gates entitlement and returns 403 if the
+ * caller can't eject) — we just write the returned files to `infra/`.
+ */
+export async function eject(projectDir, opts) {
+    const config = await loadConfig(projectDir, { stage: opts.stage });
+    if (!config.projectId) {
+        throw new Error('Set "projectId" in laranja.config.ts (from your dashboard) to eject.');
+    }
+    const apiKey = resolveApiKey();
+    if (!apiKey)
+        throw new Error("Set LARANJA_API_KEY (or run `laranja init`) to eject.");
+    const ejectDir = path.join(projectDir, "infra");
+    if (existsSync(ejectDir) && !opts.force) {
+        throw new Error(`${path.relative(projectDir, ejectDir)}/ already exists. Re-run with --force to overwrite.`);
+    }
+    const ir = scan({ projectDir, config });
+    writeResourceTypes(projectDir, ir);
+    let res;
+    try {
+        res = await postEject({ project: ir.app.name, stage: ir.app.stage, artifact: "cdk", ir, assets: {} }, apiKey, config.projectId);
+    }
+    catch (err) {
+        if (err instanceof ApiRequestError)
+            throw new Error(apiErrorMessage("Eject failed", err));
+        throw err;
+    }
+    for (const file of res.files) {
+        const abs = path.join(ejectDir, file.path);
+        mkdirSync(path.dirname(abs), { recursive: true });
+        writeFileSync(abs, file.contents);
+    }
+    console.log(`Ejected ${res.files.length} files to ${path.relative(projectDir, ejectDir)}/`);
+    console.log("\nNext:");
+    console.log("  cd infra");
+    console.log("  npm install");
+    console.log("  npm run deploy");
+}
+//# sourceMappingURL=eject.js.map

package/dist/commands/eject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eject.js","sourceRoot":"","sources":["../../src/commands/eject.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACjH,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,UAAkB,EAAE,IAAyC;IACvF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACnE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;IAC1F,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAEtF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAChD,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,qDAAqD,CAAC,CAAC;IAC/G,CAAC;IAED,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,kBAAkB,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAEnC,IAAI,GAAG,CAAC;IACR,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,SAAS,CACnB,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAC9E,MAAM,EACN,MAAM,CAAC,SAAS,CACjB,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,eAAe;YAAE,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC,CAAC;QAC1F,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,KAAK,CAAC,MAAM,aAAa,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC5F,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACvB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC7B,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;AAClC,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1 @@
+export declare function init(projectDir: string): Promise<void>;

package/dist/commands/init.js

@@ -0,0 +1,103 @@
+import path from "node:path";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { CONFIG_FILENAME, getMe, resolveApiKey, resolveApiUrl, loadStoredApiKey, storeAuth, ApiRequestError, apiErrorMessage, } from "@alzulejos/laranja-core";
+import { generateResourceTypesStub } from "@alzulejos/laranja-scanner";
+import * as ui from "../ui.js";
+import { RESOURCE_TYPES_FILE } from "../resource-types.js";
+import { resolveProjectId, writeProjectId, writeName } from "../project-link.js";
+const TEMPLATE = `import type { TypedLaranjaConfig } from "./laranja.types.js";
+
+const config: TypedLaranjaConfig = {
+  // Both filled in from the dashboard project you pick during \`laranja init\`.
+  name: "",
+  // From your laranja dashboard — identifies this project on the server.
+  projectId: "",
+  region: "eu-central-1",
+  env: {},
+  // Emit a CloudWatch dashboard (\`<name>-<stage>\`) with per-function metrics —
+  // invocations, errors, throttles, duration. Set false to skip it. Defaults to true.
+  monitoring: true,
+  // Default compute for every function (the HTTP proxy + each cron/queue).
+  compute: { memory: 256, timeout: 30 },
+  // Per-resource overrides, keyed by resource id ("http", or a cron/queue id).
+  // Filled in once you have resources, e.g.:
+  // resources: { cleanup: { memory: 512, timeout: 60 } },
+};
+
+export default config;
+`;
+export async function init(projectDir) {
+    // Handshake first: validate the API key against the server BEFORE scaffolding
+    // any files, so a bad/expired token never leaves a stray laranja.config.ts.
+    // Precedence: env var / already-stored key, else prompt for it interactively.
+    let apiKey = resolveApiKey();
+    if (!apiKey) {
+        console.log(`\n  ${ui.orange("🍊 Welcome to laranja")} ${ui.dim("·")} ${ui.bold("let's get you set up")}`);
+        console.log(`  ${ui.dim("Connect this directory to your account and ship in one command.")}\n`);
+        console.log(`  ${ui.dim("Find your API key in the dashboard under")} ${ui.bold("Account → API keys")}${ui.dim(".")}\n`);
+        apiKey = await ui.promptSecret("Paste your laranja API key:");
+        if (!apiKey) {
+            console.log(`\n  ${ui.dim("No API key provided. Set LARANJA_API_KEY (or re-run `laranja init`) to connect your account.")}`);
+            return;
+        }
+    }
+    let me;
+    try {
+        me = await getMe(apiKey);
+    }
+    catch (err) {
+        if (err instanceof ApiRequestError) {
+            throw new Error(apiErrorMessage("Handshake failed", err));
+        }
+        throw err;
+    }
+    console.log(`\n  ${ui.green("✓")} Hi ${ui.bold(me.displayName)}, let's ship something great! 🍊`);
+    // Persist the validated key so future commands don't need it re-exported.
+    // Skip the write if it's already what's on disk (e.g. supplied via env).
+    if (apiKey !== loadStoredApiKey()) {
+        const stored = storeAuth({ apiKey, apiUrl: resolveApiUrl() });
+        console.log(`  ${ui.dim(`Saved your API key to ${stored} — no need to re-export it.`)}`);
+    }
+    const file = path.join(projectDir, CONFIG_FILENAME);
+    const typesFile = path.join(projectDir, RESOURCE_TYPES_FILE);
+    const configExists = existsSync(file);
+    // Pick the dashboard project BEFORE scaffolding anything, so cancelling the
+    // picker never leaves a stray config/types file behind. An existing config is
+    // only re-linked when its `projectId` is still empty (never clobber a value).
+    const needsLink = !configExists || /projectId:\s*""/.test(readFileSync(file, "utf8"));
+    let resolved;
+    if (needsLink) {
+        resolved = await resolveProjectId(apiKey, me.projects);
+        if (!resolved && !configExists) {
+            console.log(`  ${ui.dim("No project selected — nothing was created. Re-run `laranja init` when you're ready.")}`);
+            return;
+        }
+    }
+    // Key is valid and a project is chosen — now it's safe to scaffold the files.
+    if (configExists) {
+        console.log(`${CONFIG_FILENAME} already exists — nothing to do.`);
+    }
+    else {
+        writeFileSync(file, TEMPLATE);
+        console.log(`Created ${CONFIG_FILENAME}.`);
+    }
+    // The config imports `TypedLaranjaConfig` from here; seed a permissive stub so
+    // the import resolves before the first deploy/plan regenerates it with real ids.
+    if (!existsSync(typesFile)) {
+        writeFileSync(typesFile, generateResourceTypesStub());
+        console.log(`Created ${RESOURCE_TYPES_FILE}.`);
+    }
+    if (resolved) {
+        writeProjectId(file, resolved.id);
+        writeName(file, resolved.name);
+        if (resolved.created) {
+            console.log(`  ${ui.green("✓")} Created project ${ui.bold(resolved.name)} — it's now on your dashboard.`);
+        }
+        console.log(`  ${ui.dim(`Linked ${CONFIG_FILENAME} to project ${resolved.id}.`)}`);
+    }
+    else if (needsLink) {
+        console.log(`  ${ui.dim(`No project selected — set "projectId" in ${CONFIG_FILENAME} before deploying.`)}`);
+    }
+    console.log("  Next: wrap your app with `export default http(app)`, then run `laranja deploy`.");
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/logout.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Remove the stored API key (~/.laranja/auth.json). Lets you switch accounts —
+ * after logging out, the next `laranja init` prompts for a key again.
+ */
+export declare function logout(): Promise<void>;

package/dist/commands/logout.js

@@ -0,0 +1,15 @@
+import { authFilePath, clearAuth } from "@alzulejos/laranja-core";
+import * as ui from "../ui.js";
+/**
+ * Remove the stored API key (~/.laranja/auth.json). Lets you switch accounts —
+ * after logging out, the next `laranja init` prompts for a key again.
+ */
+export async function logout() {
+    if (clearAuth()) {
+        console.log(`\n  ${ui.green("✓")} Logged out — removed ${ui.dim(authFilePath())}.`);
+    }
+    else {
+        console.log(`\n  ${ui.dim("You're not logged in — nothing to remove.")}`);
+    }
+}
+//# sourceMappingURL=logout.js.map

package/dist/commands/logout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logout.js","sourceRoot":"","sources":["../../src/commands/logout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,MAAM,UAAU,CAAC;AAE/B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM;IAC1B,IAAI,SAAS,EAAE,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,yBAAyB,EAAE,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC;IACtF,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,2CAA2C,CAAC,EAAE,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC"}

package/dist/commands/logs.d.ts

@@ -0,0 +1,25 @@
+import { type DeployedLambda } from "../aws.js";
+export interface LogsOptions {
+    /** Function to tail (matched against short label / function name). */
+    name?: string;
+    /** Tail every function in the stack, multiplexed. */
+    all?: boolean;
+    /** Live-follow new events. Default true; `--no-follow` dumps history and exits. */
+    follow?: boolean;
+    /** Look-back window for the historical dump, e.g. "1h", "30m", "10s". */
+    since?: string;
+    /** Deployment stage — selects which stack's functions to tail. */
+    stage?: string;
+}
+export declare function logs(projectDir: string, opts?: LogsOptions): Promise<void>;
+/** Friendly short label for a function: strip the "<app>-" prefix and "-<stage>" suffix. */
+export declare function shortLabel(functionName: string, appName: string, stage: string): string;
+/**
+ * Functions matching a user-typed query. Exact matches (full function name or
+ * short label) win; only if there are none do we fall back to a substring match
+ * — otherwise typing "app" would match every function whose app name contains
+ * it. Pure — the impure picker lives separately.
+ */
+export declare function matchByName(fns: DeployedLambda[], query: string, label: (f: DeployedLambda) => string): DeployedLambda[];
+/** Parse a duration like "1h" / "30m" / "10s" / "2d" into milliseconds. */
+export declare function parseSince(s: string): number;

package/dist/commands/logs.js

@@ -0,0 +1,135 @@
+import { CloudWatchLogsClient, StartLiveTailCommand, FilterLogEventsCommand, } from "@aws-sdk/client-cloudwatch-logs";
+import { loadConfig, stackName } from "@alzulejos/laranja-core";
+import { getAccountId, listStackLambdas } from "../aws.js";
+import { applyAwsEnv, requireRegion } from "../io.js";
+import * as ui from "../ui.js";
+const EMOJI = { http: "🌐", cron: "⏰", queue: "📨", lambda: "λ" };
+export async function logs(projectDir, opts = {}) {
+    const config = await loadConfig(projectDir, { stage: opts.stage });
+    const region = requireRegion(config.region);
+    applyAwsEnv({ region, profile: config.profile });
+    const stack = stackName(config.name, config.stage);
+    ui.header(`logs ${config.name} ${ui.dim(config.stage)} ${ui.dim("→")} ${region}`);
+    // The live CloudFormation stack is the source of truth — no local state needed.
+    const sp = ui.spinner("finding functions");
+    let fns;
+    try {
+        fns = await listStackLambdas(region, stack);
+    }
+    finally {
+        sp.stop(); // always clear the spinner, even when discovery throws
+    }
+    if (fns.length === 0)
+        throw new Error(`Stack "${stack}" has no Lambda functions.`);
+    const label = (f) => shortLabel(f.functionName, config.name, config.stage);
+    const targets = await chooseTargets(fns, label, opts);
+    if (!targets) {
+        console.log(`  ${ui.dim("cancelled.")}\n`);
+        return;
+    }
+    const labelOf = new Map(targets.map((t) => [t.logGroupName, label(t)]));
+    const client = new CloudWatchLogsClient({ region });
+    // `--since` (or `--no-follow`) prints a historical window first.
+    if (opts.since || opts.follow === false) {
+        await dumpHistory(client, targets, labelOf, parseSince(opts.since ?? "1h"));
+        if (opts.follow === false)
+            return;
+    }
+    const account = await getAccountId(region);
+    await liveTail(client, region, account, targets, labelOf);
+}
+/** Friendly short label for a function: strip the "<app>-" prefix and "-<stage>" suffix. */
+export function shortLabel(functionName, appName, stage) {
+    return functionName
+        .replace(new RegExp(`^${appName}-`), "")
+        .replace(new RegExp(`-${stage}$`), "");
+}
+/**
+ * Functions matching a user-typed query. Exact matches (full function name or
+ * short label) win; only if there are none do we fall back to a substring match
+ * — otherwise typing "app" would match every function whose app name contains
+ * it. Pure — the impure picker lives separately.
+ */
+export function matchByName(fns, query, label) {
+    const exact = fns.filter((f) => f.functionName === query || label(f) === query);
+    return exact.length > 0 ? exact : fns.filter((f) => f.functionName.includes(query));
+}
+/** Resolve which functions to tail: --all, a name match, or an interactive pick. */
+async function chooseTargets(fns, label, opts) {
+    if (opts.all)
+        return fns;
+    if (opts.name) {
+        const match = matchByName(fns, opts.name, label);
+        if (match.length === 0) {
+            throw new Error(`No function matching "${opts.name}". Available: ${fns.map((f) => label(f)).join(", ")}`);
+        }
+        return match;
+    }
+    // No name given: interactive picker (requires a TTY).
+    if (!process.stdin.isTTY) {
+        throw new Error(`Specify a function (e.g. \`laranja logs ${label(fns[0])}\`) or --all. ` +
+            `Available: ${fns.map((f) => label(f)).join(", ")}`);
+    }
+    const choices = [
+        ...fns.map((f) => ({ label: `${EMOJI[f.kind]}  ${label(f).padEnd(20)} ${ui.dim(f.functionName)}`, value: [f] })),
+        { label: `📚  ${"all functions".padEnd(20)} ${ui.dim(`${fns.length} log groups`)}`, value: fns },
+    ];
+    return ui.select("select a function to tail", choices);
+}
+/** Print recent events from the given window, oldest-first, then return. */
+async function dumpHistory(client, targets, labelOf, sinceMs) {
+    const startTime = Date.now() - sinceMs;
+    const multi = targets.length > 1;
+    const rows = [];
+    for (const t of targets) {
+        let nextToken;
+        do {
+            const res = await client.send(new FilterLogEventsCommand({ logGroupName: t.logGroupName, startTime, nextToken }));
+            for (const e of res.events ?? []) {
+                rows.push({ timestamp: e.timestamp ?? 0, message: e.message, group: t.logGroupName });
+            }
+            nextToken = res.nextToken;
+        } while (nextToken);
+    }
+    rows.sort((a, b) => a.timestamp - b.timestamp);
+    for (const r of rows)
+        printEvent(r.timestamp, r.message, multi ? labelOf.get(r.group) : undefined);
+    if (rows.length === 0)
+        console.log(`  ${ui.dim("(no events in window)")}`);
+}
+/** Stream new events live until the process is interrupted (Ctrl-C). */
+async function liveTail(client, region, account, targets, labelOf) {
+    const multi = targets.length > 1;
+    const identifiers = targets.map((t) => `arn:aws:logs:${region}:${account}:log-group:${t.logGroupName}`);
+    // Map back from the ARN identifier the API echoes to our short label.
+    const labelByArn = new Map(targets.map((t) => [`arn:aws:logs:${region}:${account}:log-group:${t.logGroupName}`, labelOf.get(t.logGroupName)]));
+    const res = await client.send(new StartLiveTailCommand({ logGroupIdentifiers: identifiers }));
+    console.log(`  ${ui.green("●")} ${ui.dim(`tailing ${targets.length === 1 ? labelOf.get(targets[0].logGroupName) : `${targets.length} functions`} — Ctrl-C to stop`)}\n`);
+    const stream = res.responseStream;
+    if (!stream)
+        return;
+    for await (const event of stream) {
+        for (const e of event.sessionUpdate?.sessionResults ?? []) {
+            printEvent(e.timestamp ?? 0, e.message, multi ? labelByArn.get(e.logGroupIdentifier ?? "") : undefined);
+        }
+    }
+}
+/** Print one log line: dim timestamp, optional function tag, message. */
+function printEvent(timestamp, message, tag) {
+    const msg = (message ?? "").replace(/\n$/, "");
+    if (!msg)
+        return;
+    const ts = ui.dim(new Date(timestamp).toISOString().slice(11, 23));
+    const prefix = tag ? `${ui.cyan(tag)} ` : "";
+    console.log(`  ${ts} ${prefix}${msg}`);
+}
+/** Parse a duration like "1h" / "30m" / "10s" / "2d" into milliseconds. */
+export function parseSince(s) {
+    const m = /^(\d+)(s|m|h|d)$/.exec(s.trim());
+    if (!m)
+        throw new Error(`Invalid --since "${s}". Use e.g. 30s, 15m, 1h, 2d.`);
+    const n = Number(m[1]);
+    const unit = { s: 1e3, m: 6e4, h: 36e5, d: 864e5 }[m[2]];
+    return n * unit;
+}
+//# sourceMappingURL=logs.js.map

package/dist/commands/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../src/commands/logs.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAwC,MAAM,WAAW,CAAC;AACjG,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,UAAU,CAAC;AAE/B,MAAM,KAAK,GAA+B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AAe9F,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,UAAkB,EAAE,OAAoB,EAAE;IACnE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAEjD,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACnD,EAAE,CAAC,MAAM,CAAC,QAAQ,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;IAElF,gFAAgF;IAChF,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC3C,IAAI,GAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,uDAAuD;IACpE,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,4BAA4B,CAAC,CAAC;IAEnF,MAAM,KAAK,GAAG,CAAC,CAAiB,EAAU,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACnG,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IACtD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,IAAI,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAEpD,iEAAiE;IACjE,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QACxC,MAAM,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC;QAC5E,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK;YAAE,OAAO;IACpC,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,UAAU,CAAC,YAAoB,EAAE,OAAe,EAAE,KAAa;IAC7E,OAAO,YAAY;SAChB,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE,EAAE,CAAC;SACvC,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,GAAqB,EACrB,KAAa,EACb,KAAoC;IAEpC,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC;IAChF,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AACtF,CAAC;AAED,oFAAoF;AACpF,KAAK,UAAU,aAAa,CAC1B,GAAqB,EACrB,KAAoC,EACpC,IAAiB;IAEjB,IAAI,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC;IAEzB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACjD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,yBAAyB,IAAI,CAAC,IAAI,iBAAiB,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACzF,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,sDAAsD;IACtD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,2CAA2C,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB;YACtE,cAAc,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtD,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG;QACd,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAChH,EAAE,KAAK,EAAE,OAAO,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE;KACjG,CAAC;IACF,OAAO,EAAE,CAAC,MAAM,CAAC,2BAA2B,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC;AAED,4EAA4E;AAC5E,KAAK,UAAU,WAAW,CACxB,MAA4B,EAC5B,OAAyB,EACzB,OAA4B,EAC5B,OAAe;IAEf,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAEjC,MAAM,IAAI,GAAU,EAAE,CAAC;IAEvB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,SAA6B,CAAC;QAClC,GAAG,CAAC;YACF,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAC3B,IAAI,sBAAsB,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CACnF,CAAC;YACF,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;gBACjC,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;YACxF,CAAC;YACD,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;QAC5B,CAAC,QAAQ,SAAS,EAAE;IACtB,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,IAAI;QAAE,UAAU,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACnG,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,uBAAuB,CAAC,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,wEAAwE;AACxE,KAAK,UAAU,QAAQ,CACrB,MAA4B,EAC5B,MAAc,EACd,OAAe,EACf,OAAyB,EACzB,OAA4B;IAE5B,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IACjC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,MAAM,IAAI,OAAO,cAAc,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;IACxG,sEAAsE;IACtE,MAAM,UAAU,GAAG,IAAI,GAAG,CACxB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,gBAAgB,MAAM,IAAI,OAAO,cAAc,CAAC,CAAC,YAAY,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CACnH,CAAC;IAEF,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC,EAAE,mBAAmB,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;IAC9F,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,WAAW,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,YAAY,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAEzK,MAAM,MAAM,GAAG,GAAG,CAAC,cAAc,CAAC;IAClC,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,aAAa,EAAE,cAAc,IAAI,EAAE,EAAE,CAAC;YAC1D,UAAU,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC1G,CAAC;IACH,CAAC;AACH,CAAC;AAED,yEAAyE;AACzE,SAAS,UAAU,CAAC,SAAiB,EAAE,OAA2B,EAAE,GAAY;IAC9E,MAAM,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/C,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,MAAM,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,+BAA+B,CAAC,CAAC;IAC9E,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,MAAM,IAAI,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAA0B,CAAC,CAAC;IAClF,OAAO,CAAC,GAAG,IAAI,CAAC;AAClB,CAAC"}

package/dist/commands/plan.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Show what a deploy would do: synthesize the template on the laranja server
+ * (read-only — no deployment row, no quota), diff it against the stack currently
+ * deployed in your AWS account, and print the laranja table with each resource
+ * tagged created / changed / unchanged. Needs `LARANJA_API_KEY` (for the synth)
+ * and AWS credentials (to read the live stack). Nothing is applied.
+ */
+export declare function plan(projectDir: string, opts?: {
+    stage?: string;
+}): Promise<void>;

package/dist/commands/plan.js

@@ -0,0 +1,47 @@
+import { Toolkit, StackSelectionStrategy } from "@aws-cdk/toolkit-lib";
+import { loadConfig, resolveApiKey } from "@alzulejos/laranja-core";
+import { buildPlanAssembly } from "../pipeline.js";
+import { getAccountId } from "../aws.js";
+import { applyAwsEnv, requireRegion } from "../io.js";
+import { summarizePlan } from "../plan-summary.js";
+import * as ui from "../ui.js";
+/** Swallows the toolkit's own diff output — we render our own summary instead. */
+const silentIoHost = {
+    async notify() { },
+    async requestResponse(msg) {
+        return msg.defaultResponse;
+    },
+};
+/**
+ * Show what a deploy would do: synthesize the template on the laranja server
+ * (read-only — no deployment row, no quota), diff it against the stack currently
+ * deployed in your AWS account, and print the laranja table with each resource
+ * tagged created / changed / unchanged. Needs `LARANJA_API_KEY` (for the synth)
+ * and AWS credentials (to read the live stack). Nothing is applied.
+ */
+export async function plan(projectDir, opts = {}) {
+    const apiKey = resolveApiKey();
+    if (!apiKey)
+        throw new Error("Set LARANJA_API_KEY (or run `laranja init`) to plan.");
+    // loadConfig raises a clear "run `laranja init`" error if this directory isn't
+    // linked yet (empty name/projectId); pipeline enforces projectId before synth.
+    const config = await loadConfig(projectDir, { stage: opts.stage });
+    const region = requireRegion(config.region);
+    applyAwsEnv({ region, profile: config.profile });
+    const sp = ui.spinner("diffing against your deployed stack");
+    try {
+        const account = await getAccountId(region);
+        const { ir, stackName, cdkOutDir, template } = await buildPlanAssembly(projectDir, { region, account, stage: opts.stage }, apiKey);
+        const toolkit = new Toolkit({ ioHost: silentIoHost });
+        const cx = await toolkit.fromAssemblyDirectory(cdkOutDir);
+        const diffs = await toolkit.diff(cx, { stacks: { strategy: StackSelectionStrategy.ALL_STACKS } });
+        const diff = (diffs[stackName] ?? Object.values(diffs)[0]);
+        sp.stop();
+        summarizePlan(ir, template ?? {}, diff ?? { resources: { changes: {} } });
+    }
+    catch (err) {
+        sp.fail("plan failed");
+        throw err;
+    }
+}
+//# sourceMappingURL=plan.js.map

package/dist/commands/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/commands/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,aAAa,EAAsB,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,MAAM,UAAU,CAAC;AAE/B,kFAAkF;AAClF,MAAM,YAAY,GAAG;IACnB,KAAK,CAAC,MAAM,KAAmB,CAAC;IAChC,KAAK,CAAC,eAAe,CAAI,GAA2B;QAClD,OAAO,GAAG,CAAC,eAAe,CAAC;IAC7B,CAAC;CACF,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,UAAkB,EAAE,OAA2B,EAAE;IAC1E,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAErF,+EAA+E;IAC/E,+EAA+E;IAC/E,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAEjD,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC;IAC7D,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,iBAAiB,CACpE,UAAU,EACV,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EACtC,MAAM,CACP,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;QACtD,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,sBAAsB,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAClG,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAA8B,CAAC;QAExF,EAAE,CAAC,IAAI,EAAE,CAAC;QACV,aAAa,CAAC,EAAE,EAAE,QAAQ,IAAI,EAAE,EAAE,IAAI,IAAI,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC5E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACvB,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/diagnostics.d.ts

@@ -0,0 +1,31 @@
+/** Begin tracking a command run (called by the dispatcher before the command). */
+export declare function beginRun(command: string, projectDir?: string): void;
+/** Mark the current step; it's surfaced in the failure report if something throws. */
+export declare function step(name: string): void;
+/** Attach context to the run (project, stage, region, deploymentId, …). */
+export declare function note(fields: Record<string, unknown>): void;
+export interface FailureReport {
+    command: string;
+    step: string;
+    reason: string;
+    errorName?: string;
+    stack?: string;
+    durationMs: number;
+    at: string;
+    fields: Record<string, unknown>;
+}
+/** Build the structured report for a thrown error against the current run. */
+export declare function buildFailureReport(err: unknown): FailureReport;
+/**
+ * Append the report as one JSON line to `~/.laranja/errors.jsonl`. Best-effort:
+ * returns the path written, or undefined if the log couldn't be written (logging
+ * a failure must never itself crash the CLI).
+ */
+export declare function writeFailureReport(report: FailureReport): string | undefined;
+/**
+ * POST the report to the dashboard (`/report`), scoped to the user (api key) +
+ * project (project id from the run's config). Best-effort: returns whether it was
+ * sent. Skipped silently when not logged in or the project has no id — and never
+ * throws, so a failed send can't compound the original failure.
+ */
+export declare function sendFailureReport(report: FailureReport): Promise<boolean>;

package/dist/diagnostics.js

@@ -0,0 +1,85 @@
+/**
+ * Lightweight failure diagnostics. The CLI runs one command per process, so a
+ * single module-level "current run" tracks which command is executing, which
+ * step it's on, and any context worth attaching (project, region, deployment id).
+ *
+ * When a command throws, the top-level handler builds a structured report and
+ * appends it to `~/.laranja/errors.jsonl` — so a half-way failure leaves a record
+ * of WHAT failed, in WHICH step, and WHY. Shaped so we can also POST it to the
+ * dashboard later; for now it's logged locally.
+ */
+import path from "node:path";
+import { appendFileSync, mkdirSync } from "node:fs";
+import { authDir, loadConfig, resolveApiKey, postReport } from "@alzulejos/laranja-core";
+let run = { command: "", step: "starting", startedAt: Date.now(), fields: {} };
+/** Begin tracking a command run (called by the dispatcher before the command). */
+export function beginRun(command, projectDir) {
+    run = { command, projectDir, step: "starting", startedAt: Date.now(), fields: {} };
+}
+/** Mark the current step; it's surfaced in the failure report if something throws. */
+export function step(name) {
+    run.step = name;
+}
+/** Attach context to the run (project, stage, region, deploymentId, …). */
+export function note(fields) {
+    Object.assign(run.fields, fields);
+}
+/** Build the structured report for a thrown error against the current run. */
+export function buildFailureReport(err) {
+    const e = err instanceof Error ? err : undefined;
+    return {
+        command: run.command,
+        step: run.step,
+        reason: e?.message ?? String(err),
+        errorName: e?.name,
+        stack: e?.stack,
+        durationMs: Date.now() - run.startedAt,
+        at: new Date().toISOString(),
+        fields: run.fields,
+    };
+}
+/**
+ * Append the report as one JSON line to `~/.laranja/errors.jsonl`. Best-effort:
+ * returns the path written, or undefined if the log couldn't be written (logging
+ * a failure must never itself crash the CLI).
+ */
+export function writeFailureReport(report) {
+    try {
+        const dir = authDir();
+        mkdirSync(dir, { recursive: true });
+        const file = path.join(dir, "errors.jsonl");
+        appendFileSync(file, JSON.stringify(report) + "\n");
+        return file;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * POST the report to the dashboard (`/report`), scoped to the user (api key) +
+ * project (project id from the run's config). Best-effort: returns whether it was
+ * sent. Skipped silently when not logged in or the project has no id — and never
+ * throws, so a failed send can't compound the original failure.
+ */
+export async function sendFailureReport(report) {
+    const apiKey = resolveApiKey();
+    if (!apiKey || !run.projectDir)
+        return false;
+    let projectId;
+    try {
+        projectId = (await loadConfig(run.projectDir)).projectId;
+    }
+    catch {
+        return false; // no/unreadable config — nothing to scope the report to
+    }
+    if (!projectId)
+        return false;
+    try {
+        await postReport(report, apiKey, projectId);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=diagnostics.js.map