@synteq/cli 0.2.0 → 1.1.2

package/dist/commands/function/list.js

@@ -0,0 +1,55 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand } from "../../base/command.js";
+import { renderTable, shortId, truncationNote } from "../../ui/table.js";
+import { statusColor } from "../../ui/glyphs.js";
+/**
+ * `synteq function list` — serverless functions in the active project.
+ *
+ * Backend: GET /functions. Scoping matches `apps list` — the server resolves
+ * the active project from the `X-Project-Id` header, so `--project` overrides it.
+ */
+export default class FunctionList extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "List serverless functions in the active project.";
+    static examples = [
+        "<%= config.bin %> function list",
+        "<%= config.bin %> function list --project 019e...   # scope to a specific project",
+        "<%= config.bin %> function list -o json",
+    ];
+    static flags = {
+        project: Flags.string({
+            description: "Project id to scope to (defaults to the active project).",
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { flags } = await this.parse(FunctionList);
+        try {
+            const page = await this.clients.api.functions.listPage(flags.project);
+            const fns = page.items;
+            const note = truncationNote(fns.length, page.total, "--project");
+            this.emit(fns, () => {
+                if (fns.length === 0) {
+                    this.log("No functions. Create one with `synteq function init <name>`.");
+                    return;
+                }
+                this.log(renderTable(["ID", "SLUG", "STATUS", "RUNTIME", "PLAN", "REGION", "REL", "HOSTNAME"], fns.map((f) => [
+                    shortId(f.id),
+                    f.slug,
+                    statusColor(f.status),
+                    f.runtime,
+                    f.planTier,
+                    f.region,
+                    f.currentReleaseNumber != null ? String(f.currentReleaseNumber) : "—",
+                    f.hostname,
+                ])));
+            });
+            if (note)
+                this.info(note);
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/function/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/function/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,WAAW;IACnD,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,WAAW,GAAG,kDAAkD,CAAC;IACxE,MAAM,CAAC,QAAQ,GAAG;QAChB,iCAAiC;QACjC,mFAAmF;QACnF,yCAAyC;KAC1C,CAAC;IACF,MAAM,CAAC,KAAK,GAAG;QACb,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;YACpB,WAAW,EAAE,0DAA0D;SACxE,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACjD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACtE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC;YACvB,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;YACjE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE;gBAClB,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACrB,IAAI,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;oBACzE,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC,GAAG,CACN,WAAW,CACT,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,EACxE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;oBACb,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;oBACb,CAAC,CAAC,IAAI;oBACN,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC;oBACrB,CAAC,CAAC,OAAO;oBACT,CAAC,CAAC,QAAQ;oBACV,CAAC,CAAC,MAAM;oBACR,CAAC,CAAC,oBAAoB,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,GAAG;oBACrE,CAAC,CAAC,QAAQ;iBACX,CAAC,CACH,CACF,CAAC;YACJ,CAAC,CAAC,CAAC;YACH,IAAI,IAAI;gBAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;IACH,CAAC"}

package/dist/commands/function/logs.d.ts

@@ -0,0 +1,29 @@
+import { BaseCommand } from "../../base/command.js";
+/**
+ * `synteq function logs` — one line per invocation, newest first.
+ *
+ * Backend: GET /functions/{id}/runs. A run row is the unit here, not a log
+ * line: the runtime captures a function's stdout per invocation, so `--lines`
+ * indents the captured output under the run it belongs to (and `--follow`
+ * turns the same view into a tail).
+ */
+export default class FunctionLogs extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        status: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        release: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        search: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        lines: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        follow: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    /** One run as a single line, plus its captured output when --lines is on. */
+    private printRun;
+}

package/dist/commands/function/logs.js

@@ -0,0 +1,171 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../base/command.js";
+import { resolveLinkedFunction } from "../../functions-support/link.js";
+import { withSpinner } from "../../ui/spinner.js";
+import { statusColor, dim, red, G } from "../../ui/glyphs.js";
+/** Seconds between polls in --follow mode. */
+const FOLLOW_INTERVAL_MS = 3000;
+const MAX_LIMIT = 100;
+/**
+ * `synteq function logs` — one line per invocation, newest first.
+ *
+ * Backend: GET /functions/{id}/runs. A run row is the unit here, not a log
+ * line: the runtime captures a function's stdout per invocation, so `--lines`
+ * indents the captured output under the run it belongs to (and `--follow`
+ * turns the same view into a tail).
+ */
+export default class FunctionLogs extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = [
+        "Show a function's recent invocations, newest first.",
+        "",
+        "Each row is one run: when it started, how it ended, how long it took. Add",
+        "`--lines` to print the output each run captured (and the HTTP calls it",
+        "made), or `--follow` to tail new runs as they arrive.",
+    ].join("\n");
+    static examples = [
+        "<%= config.bin %> function logs                      # bare: this directory's linked function",
+        "<%= config.bin %> function logs my-fn --lines        # include each run's captured output",
+        "<%= config.bin %> function logs my-fn --status error --limit 50",
+        "<%= config.bin %> function logs my-fn --follow       # tail new runs (Ctrl-C to stop)",
+        "<%= config.bin %> function logs my-fn -o json",
+    ];
+    static args = {
+        name: Args.string({
+            description: "Function slug (or uuid). Omit to use this directory's linked function.",
+        }),
+    };
+    static flags = {
+        name: Flags.string({
+            description: "Function slug (or uuid) — the flag form of the positional arg.",
+        }),
+        limit: Flags.integer({
+            default: 20,
+            description: `How many runs to fetch (default: 20, max: ${MAX_LIMIT}).`,
+        }),
+        status: Flags.string({
+            description: "Only runs with this status, e.g. success or error.",
+        }),
+        release: Flags.integer({
+            description: "Only runs served by this release number.",
+        }),
+        search: Flags.string({
+            description: "Substring filter the server applies over the run's path and captured output.",
+        }),
+        lines: Flags.boolean({
+            description: "Print each run's captured output (and outbound HTTP calls) indented under it.",
+        }),
+        follow: Flags.boolean({
+            char: "f",
+            description: `Poll every ${FOLLOW_INTERVAL_MS / 1000}s and print runs newer than the newest seen (Ctrl-C to stop).`,
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(FunctionLogs);
+        try {
+            const { fn, clients } = await resolveLinkedFunction(this.clients, {
+                ...flags,
+                name: args.name ?? flags.name,
+            }).catch((e) => {
+                if (e instanceof Error && !("status" in e))
+                    this.error(e.message, { exit: 1 });
+                throw e;
+            });
+            this.clients = clients;
+            if (flags.limit < 1 || flags.limit > MAX_LIMIT) {
+                this.error(`--limit must be between 1 and ${MAX_LIMIT}.`, { exit: 1 });
+            }
+            const query = {
+                limit: flags.limit,
+                status: flags.status,
+                release: flags.release,
+                q: flags.search,
+            };
+            const page = await withSpinner("Loading runs", () => this.clients.api.functions.runs(fn.id, query));
+            if (!flags.follow) {
+                this.emit(page, () => {
+                    if (page.items.length === 0) {
+                        this.log(dim("No invocations recorded."));
+                        return;
+                    }
+                    // The API returns newest first; print oldest first so a terminal
+                    // reads top-to-bottom like a log.
+                    for (const run of [...page.items].reverse())
+                        this.printRun(run, flags.lines);
+                });
+                return;
+            }
+            // --follow: print the first page, then poll for anything newer. Run ids
+            // are UUIDv7 strings — lexicographically ordered by creation — so
+            // "newer than" is a plain string comparison, no clock involved.
+            for (const run of [...page.items].reverse())
+                this.printRun(run, flags.lines);
+            let newest = page.items.reduce((m, r) => (r.id > m ? r.id : m), "");
+            this.log(dim(`${G.dot} Following ${fn.slug}. Ctrl-C to stop.`));
+            let stop = false;
+            const onSigint = () => {
+                stop = true;
+            };
+            process.on("SIGINT", onSigint);
+            try {
+                for (;;) {
+                    await sleep(FOLLOW_INTERVAL_MS);
+                    if (stop)
+                        break;
+                    let next;
+                    try {
+                        next = await this.clients.api.functions.runs(fn.id, query);
+                    }
+                    catch {
+                        continue; // transient — keep tailing
+                    }
+                    const fresh = next.items.filter((r) => r.id > newest).sort((a, b) => (a.id < b.id ? -1 : 1));
+                    for (const run of fresh)
+                        this.printRun(run, flags.lines);
+                    if (fresh.length > 0)
+                        newest = fresh[fresh.length - 1].id;
+                    if (stop)
+                        break;
+                }
+            }
+            finally {
+                process.removeListener("SIGINT", onSigint);
+            }
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+    /** One run as a single line, plus its captured output when --lines is on. */
+    printRun(run, withLines) {
+        const status = run.statusCode != null ? `${run.status}/${run.statusCode}` : run.status;
+        const parts = [
+            dim(run.startedAt),
+            statusColor(status),
+            run.durationMs != null ? `${run.durationMs}ms` : dim("—"),
+            run.releaseNumber != null ? dim(`#${run.releaseNumber}`) : "",
+            run.error ? red(run.error) : "",
+        ].filter(Boolean);
+        this.log(parts.join(` ${dim(G.bullet)} `));
+        if (!withLines)
+            return;
+        for (const line of run.logLines ?? [])
+            this.log(`    ${line}`);
+        if (run.logTruncated)
+            this.log(dim("    … output truncated"));
+        for (const call of run.outbound ?? []) {
+            const method = call.method ?? "GET";
+            const outcome = call.error
+                ? red(call.error)
+                : `responded ${statusColor(String(call.status ?? "—"))}${call.durationMs != null ? ` in ${call.durationMs}ms` : ""}`;
+            this.log(dim(`    ${G.arrow} ${method} ${call.url} `) + outcome);
+        }
+        if (run.outboundTruncated)
+            this.log(dim("    … outbound calls truncated"));
+    }
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=logs.js.map

package/dist/commands/function/logs.js.map

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

package/dist/commands/function/pause.d.ts

@@ -0,0 +1,19 @@
+import { BaseCommand } from "../../base/command.js";
+/** `synteq function pause` — stop a function serving traffic. Backend:
+ *  PATCH /functions/{id} with `paused: true`. A pause is also the first step
+ *  of a delete: the API only allows DELETE once a function has been paused
+ *  for 14 days (see `function delete`), and until now the CLI had no scripted
+ *  way to start that clock. The TUI toggles `paused` without a confirm, so
+ *  neither does this. */
+export default class FunctionPause extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/function/pause.js

@@ -0,0 +1,50 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../base/command.js";
+import { resolveLinkedFunction } from "../../functions-support/link.js";
+import { withSpinner } from "../../ui/spinner.js";
+import { ok, dim } from "../../ui/glyphs.js";
+/** `synteq function pause` — stop a function serving traffic. Backend:
+ *  PATCH /functions/{id} with `paused: true`. A pause is also the first step
+ *  of a delete: the API only allows DELETE once a function has been paused
+ *  for 14 days (see `function delete`), and until now the CLI had no scripted
+ *  way to start that clock. The TUI toggles `paused` without a confirm, so
+ *  neither does this. */
+export default class FunctionPause extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "Pause a function so it stops serving traffic. Also starts the 14-day pause the API requires before a function can be deleted.";
+    static examples = [
+        "<%= config.bin %> function pause                # bare: this directory's linked function",
+        "<%= config.bin %> function pause my-fn",
+        "<%= config.bin %> function pause my-fn -o json",
+    ];
+    static args = {
+        name: Args.string({
+            description: "Function slug (or uuid). Omit to use this directory's linked function.",
+        }),
+    };
+    static flags = {
+        name: Flags.string({
+            description: "Function slug (or uuid) — the flag form of the positional arg.",
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(FunctionPause);
+        try {
+            const { fn, clients } = await resolveLinkedFunction(this.clients, {
+                ...flags,
+                name: args.name ?? flags.name,
+            });
+            this.clients = clients;
+            const updated = await withSpinner(`Pausing ${fn.slug}`, () => this.clients.api.functions.update(fn.id, { paused: true }));
+            this.emit(updated, () => {
+                this.log(ok(`Paused ${fn.slug} — it is no longer serving traffic.`));
+                this.log(dim("Resume it with `synteq function resume`."));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=pause.js.map

package/dist/commands/function/pause.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pause.js","sourceRoot":"","sources":["../../../src/commands/function/pause.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAE7C;;;;;yBAKyB;AACzB,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAW;IACpD,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,WAAW,GAChB,+HAA+H,CAAC;IAClI,MAAM,CAAC,QAAQ,GAAG;QAChB,0FAA0F;QAC1F,wCAAwC;QACxC,gDAAgD;KACjD,CAAC;IACF,MAAM,CAAC,IAAI,GAAG;QACZ,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;YAChB,WAAW,EAAE,wEAAwE;SACtF,CAAC;KACH,CAAC;IACF,MAAM,CAAC,KAAK,GAAG;QACb,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YACjB,WAAW,EAAE,gEAAgE;SAC9E,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACxD,IAAI,CAAC;YACH,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,OAAO,EAAE;gBAChE,GAAG,KAAK;gBACR,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI;aAC9B,CAAC,CAAC;YACH,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YAEvB,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,CAC3D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAC3D,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;gBACtB,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,IAAI,qCAAqC,CAAC,CAAC,CAAC;gBACrE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC,CAAC;YAC5D,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;IACH,CAAC"}

package/dist/commands/function/releases.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from "../../base/command.js";
+/** `synteq function releases` — a function's release history, newest first.
+ *  Backend: GET /functions/{id}/releases. Roll back with `function rollback`. */
+export default class FunctionReleases extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/function/releases.js

@@ -0,0 +1,62 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../base/command.js";
+import { resolveLinkedFunction } from "../../functions-support/link.js";
+import { withSpinner } from "../../ui/spinner.js";
+import { renderTable, shortId } from "../../ui/table.js";
+import { statusColor, dim, G } from "../../ui/glyphs.js";
+/** `synteq function releases` — a function's release history, newest first.
+ *  Backend: GET /functions/{id}/releases. Roll back with `function rollback`. */
+export default class FunctionReleases extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "List a function's releases, newest first, marking the current one.";
+    static examples = [
+        "<%= config.bin %> function releases                # bare: this directory's linked function",
+        "<%= config.bin %> function releases my-fn",
+        "<%= config.bin %> function releases my-fn -o json",
+    ];
+    static args = {
+        name: Args.string({
+            description: "Function slug (or uuid). Omit to use this directory's linked function.",
+        }),
+    };
+    static flags = {
+        name: Flags.string({
+            description: "Function slug (or uuid) — the flag form of the positional arg.",
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(FunctionReleases);
+        try {
+            const { fn, clients } = await resolveLinkedFunction(this.clients, {
+                ...flags,
+                name: args.name ?? flags.name,
+            }).catch((e) => {
+                if (e instanceof Error && !("status" in e))
+                    this.error(e.message, { exit: 1 });
+                throw e;
+            });
+            this.clients = clients;
+            const releases = await withSpinner("Loading releases", () => this.clients.api.functions.releases(fn.id));
+            const sorted = [...releases].sort((a, b) => b.number - a.number);
+            this.emit(sorted, () => {
+                if (sorted.length === 0) {
+                    this.log(`No releases yet. Deploy one: synteq function deploy --name ${fn.slug}`);
+                    return;
+                }
+                this.log(renderTable(["NUMBER", "STATUS", "CURRENT", "DEPLOYED_AT", "BUILD", "DIGEST"], sorted.map((r) => [
+                    `#${r.number}`,
+                    statusColor(r.status),
+                    r.isCurrent ? G.check : dim("—"),
+                    r.deployedAt,
+                    r.buildId ? shortId(r.buildId) : dim("—"),
+                    r.imageDigest ? r.imageDigest.replace(/^sha256:/, "").slice(0, 12) : dim("—"),
+                ])));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=releases.js.map

package/dist/commands/function/releases.js.map

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

package/dist/commands/function/resume.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from "../../base/command.js";
+/** `synteq function resume` — put a paused function back into service.
+ *  Backend: PATCH /functions/{id} with `paused: false`. The inverse of
+ *  `function pause`; like the TUI toggle it takes no confirmation. */
+export default class FunctionResume extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/function/resume.js

@@ -0,0 +1,47 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../base/command.js";
+import { resolveLinkedFunction } from "../../functions-support/link.js";
+import { withSpinner } from "../../ui/spinner.js";
+import { ok, dim } from "../../ui/glyphs.js";
+/** `synteq function resume` — put a paused function back into service.
+ *  Backend: PATCH /functions/{id} with `paused: false`. The inverse of
+ *  `function pause`; like the TUI toggle it takes no confirmation. */
+export default class FunctionResume extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "Resume a paused function so it starts serving traffic again.";
+    static examples = [
+        "<%= config.bin %> function resume                # bare: this directory's linked function",
+        "<%= config.bin %> function resume my-fn",
+        "<%= config.bin %> function resume my-fn -o json",
+    ];
+    static args = {
+        name: Args.string({
+            description: "Function slug (or uuid). Omit to use this directory's linked function.",
+        }),
+    };
+    static flags = {
+        name: Flags.string({
+            description: "Function slug (or uuid) — the flag form of the positional arg.",
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(FunctionResume);
+        try {
+            const { fn, clients } = await resolveLinkedFunction(this.clients, {
+                ...flags,
+                name: args.name ?? flags.name,
+            });
+            this.clients = clients;
+            const updated = await withSpinner(`Resuming ${fn.slug}`, () => this.clients.api.functions.update(fn.id, { paused: false }));
+            this.emit(updated, () => {
+                this.log(ok(`Resumed ${fn.slug} — it is serving traffic again.`));
+                this.log(dim("Pause it again with `synteq function pause`."));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=resume.js.map

package/dist/commands/function/resume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.js","sourceRoot":"","sources":["../../../src/commands/function/resume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAE7C;;sEAEsE;AACtE,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,WAAW;IACrD,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,WAAW,GAAG,8DAA8D,CAAC;IACpF,MAAM,CAAC,QAAQ,GAAG;QAChB,2FAA2F;QAC3F,yCAAyC;QACzC,iDAAiD;KAClD,CAAC;IACF,MAAM,CAAC,IAAI,GAAG;QACZ,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;YAChB,WAAW,EAAE,wEAAwE;SACtF,CAAC;KACH,CAAC;IACF,MAAM,CAAC,KAAK,GAAG;QACb,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YACjB,WAAW,EAAE,gEAAgE;SAC9E,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,OAAO,EAAE;gBAChE,GAAG,KAAK;gBACR,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI;aAC9B,CAAC,CAAC;YACH,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YAEvB,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,CAC5D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAC5D,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;gBACtB,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,iCAAiC,CAAC,CAAC,CAAC;gBAClE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC,CAAC;YAChE,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;IACH,CAAC"}

package/dist/commands/function/rollback.d.ts

@@ -0,0 +1,18 @@
+import { BaseCommand } from "../../base/command.js";
+/** `synteq function rollback --to N` — re-point a function at an earlier
+ *  release. Backend: POST /functions/{id}/rollback; the server mints a NEW
+ *  release carrying the old image, so history stays append-only. */
+export default class FunctionRollback extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        to: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/function/rollback.js

@@ -0,0 +1,69 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../base/command.js";
+import { resolveLinkedFunction } from "../../functions-support/link.js";
+import { withSpinner } from "../../ui/spinner.js";
+import { isInteractive, confirmAction } from "../../ui/wizard.js";
+import { ok, dim } from "../../ui/glyphs.js";
+/** `synteq function rollback --to N` — re-point a function at an earlier
+ *  release. Backend: POST /functions/{id}/rollback; the server mints a NEW
+ *  release carrying the old image, so history stays append-only. */
+export default class FunctionRollback extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "Roll a function back to an earlier release (mints a new release with that image).";
+    static examples = [
+        "<%= config.bin %> function rollback --to 3                # bare: this directory's linked function",
+        "<%= config.bin %> function rollback my-fn --to 3 --yes    # no prompt (required when piped)",
+        "<%= config.bin %> function rollback my-fn --to 3 --yes -o json",
+    ];
+    static args = {
+        name: Args.string({
+            description: "Function slug (or uuid). Omit to use this directory's linked function.",
+        }),
+    };
+    static flags = {
+        name: Flags.string({
+            description: "Function slug (or uuid) — the flag form of the positional arg.",
+        }),
+        to: Flags.integer({
+            required: true,
+            description: "Release number to roll back to — see `synteq function releases`.",
+        }),
+        yes: Flags.boolean({
+            char: "y",
+            description: "Skip the confirmation prompt (required for non-interactive use).",
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(FunctionRollback);
+        try {
+            const { fn, clients } = await resolveLinkedFunction(this.clients, {
+                ...flags,
+                name: args.name ?? flags.name,
+            }).catch((e) => {
+                if (e instanceof Error && !("status" in e))
+                    this.error(e.message, { exit: 1 });
+                throw e;
+            });
+            this.clients = clients;
+            if (!flags.yes) {
+                if (!(isInteractive() && this.outputFormat === "table")) {
+                    this.error("Refusing to roll back without --yes in a non-interactive session.", { exit: 1 });
+                }
+                const go = await confirmAction(`Roll ${fn.slug} back to release #${flags.to}?`, false);
+                if (!go) {
+                    this.log("Aborted.");
+                    return;
+                }
+            }
+            const result = await withSpinner(`Rolling back to #${flags.to}`, () => this.clients.api.functions.rollback(fn.id, flags.to));
+            this.emit(result, () => {
+                this.log(ok(`${fn.slug} is now serving release #${result.release} ${dim(`(rolled back to #${result.rolledBackTo})`)}`));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=rollback.js.map

package/dist/commands/function/rollback.js.map

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

package/dist/commands/function/settings/set.d.ts

@@ -0,0 +1,23 @@
+import { BaseCommand } from "../../../base/command.js";
+/** `synteq function settings set` — patch one or more of a function's
+ *  runtime/scaling settings. Only the flags you pass are changed; the rest
+ *  are left as they are. Backend: PATCH /functions/{id}. The bounds enforced
+ *  here mirror the portal's Function detail editor so a change made from the
+ *  terminal is accepted on exactly the same terms as one made in the TUI. */
+export default class FunctionSettingsSet extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        runtime: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        concurrency: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        timeout: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "min-instances": import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "max-instances": import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}