@synteq/cli 0.2.0 → 1.1.2

package/dist/commands/function/cron/add.d.ts

@@ -0,0 +1,19 @@
+import { BaseCommand } from "../../../base/command.js";
+/** `synteq function cron add "<schedule>"` — create a cron trigger.
+ *  Backend: POST /functions/{id}/triggers/cron. */
+export default class FunctionCronAdd extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        target: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+        schedule: 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>;
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        retries: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        disabled: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/function/cron/add.js

@@ -0,0 +1,74 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../../base/command.js";
+import { resolveLinkedFunction } from "../../../functions-support/link.js";
+import { normalizeSchedule, shortTriggerId } from "../../../functions-support/cron.js";
+import { withSpinner } from "../../../ui/spinner.js";
+import { ok, dim } from "../../../ui/glyphs.js";
+/** `synteq function cron add "<schedule>"` — create a cron trigger.
+ *  Backend: POST /functions/{id}/triggers/cron. */
+export default class FunctionCronAdd extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "Add a cron trigger to a function. The schedule is a 5-field cron expression in UTC; each firing is an ordinary invocation (metered and logged like any other).";
+    static examples = [
+        '<%= config.bin %> function cron add "*/15 * * * *"                       # bare: linked function',
+        '<%= config.bin %> function cron add "0 9 * * 1-5" --description "weekday report" --name my-fn',
+        '<%= config.bin %> function cron add "0 * * * *" --retries 2 --disabled --name my-fn -o json',
+    ];
+    static args = {
+        target: Args.string({ required: false, description: "Function slug or id (optional; default: the directory's linked function or --name)." }),
+        schedule: Args.string({
+            required: false,
+            description: 'Cron expression, quoted: "minute hour day-of-month month day-of-week" (UTC).',
+        }),
+    };
+    static flags = {
+        name: Flags.string({
+            description: "Function slug (or uuid) (default: this directory's linked function).",
+        }),
+        description: Flags.string({ char: "d", description: "What this trigger is for." }),
+        retries: Flags.integer({
+            description: "Re-fire a failed run this many times (0-2).",
+            min: 0,
+            max: 2,
+            default: 0,
+        }),
+        disabled: Flags.boolean({ description: "Create the trigger switched off." }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags: rawFlags } = await this.parse(FunctionCronAdd);
+        const [target, scheduleArg] = this.positional(args.target, args.schedule, "schedule");
+        const flags = { ...rawFlags, name: target ?? rawFlags.name };
+        try {
+            let schedule;
+            try {
+                schedule = normalizeSchedule(scheduleArg);
+            }
+            catch (e) {
+                this.error(e.message, { exit: 1 });
+            }
+            const { fn, clients } = await resolveLinkedFunction(this.clients, flags).catch((e) => {
+                if (e instanceof Error && !("status" in e))
+                    this.error(e.message, { exit: 1 });
+                throw e;
+            });
+            this.clients = clients;
+            const trigger = await withSpinner("Adding cron trigger", () => this.clients.api.functions.createCronTrigger(fn.id, {
+                schedule,
+                enabled: !flags.disabled,
+                retries: flags.retries,
+                description: flags.description ?? null,
+            }));
+            this.emit(trigger, () => {
+                this.log(ok(`Added cron trigger ${shortTriggerId(trigger.id)} to ${fn.slug}: ${trigger.schedule} (UTC).`));
+                if (!trigger.enabled) {
+                    this.log(dim(`  Created disabled. Enable it: synteq function cron update ${shortTriggerId(trigger.id)} --enable`));
+                }
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=add.js.map

package/dist/commands/function/cron/add.js.map

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

package/dist/commands/function/cron/list.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from "../../../base/command.js";
+/** `synteq function cron list` — a function's cron triggers.
+ *  Backend: GET /functions/{id}/triggers/cron. */
+export default class FunctionCronList extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,55 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand } from "../../../base/command.js";
+import { resolveLinkedFunction } from "../../../functions-support/link.js";
+import { shortTriggerId } from "../../../functions-support/cron.js";
+import { withSpinner } from "../../../ui/spinner.js";
+import { renderTable } from "../../../ui/table.js";
+import { dim } from "../../../ui/glyphs.js";
+/** `synteq function cron list` — a function's cron triggers.
+ *  Backend: GET /functions/{id}/triggers/cron. */
+export default class FunctionCronList extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "List a function's cron triggers (schedules are UTC).";
+    static examples = [
+        "<%= config.bin %> function cron list                   # bare: this directory's linked function",
+        "<%= config.bin %> function cron list --name my-fn",
+        "<%= config.bin %> function cron list --name my-fn -o json",
+    ];
+    static flags = {
+        name: Flags.string({
+            description: "Function slug (or uuid) (default: this directory's linked function).",
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { flags } = await this.parse(FunctionCronList);
+        try {
+            const { fn, clients } = await resolveLinkedFunction(this.clients, flags).catch((e) => {
+                if (e instanceof Error && !("status" in e))
+                    this.error(e.message, { exit: 1 });
+                throw e;
+            });
+            this.clients = clients;
+            const triggers = await withSpinner("Loading cron triggers", () => this.clients.api.functions.cronTriggers(fn.id));
+            this.emit(triggers, () => {
+                if (triggers.length === 0) {
+                    this.log(`No cron triggers. Add one: synteq function cron add "*/15 * * * *" --name ${fn.slug}`);
+                    return;
+                }
+                this.log(renderTable(["ID", "SCHEDULE (UTC)", "ENABLED", "RETRIES", "LAST RUN", "LAST STATUS", "DESCRIPTION"], triggers.map((t) => [
+                    shortTriggerId(t.id),
+                    t.schedule,
+                    t.enabled ? "yes" : dim("no"),
+                    String(t.retries),
+                    t.lastRunAt ? dim(t.lastRunAt) : dim("never"),
+                    t.lastStatus ?? "",
+                    t.description ?? "",
+                ])));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=list.js.map

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

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

package/dist/commands/function/cron/rm.d.ts

@@ -0,0 +1,17 @@
+import { BaseCommand } from "../../../base/command.js";
+/** `synteq function cron rm <trigger>` — delete a cron trigger.
+ *  Backend: DELETE /functions/{id}/triggers/cron/{triggerId}. */
+export default class FunctionCronRm extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        target: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+        trigger: 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>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/function/cron/rm.js

@@ -0,0 +1,73 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../../base/command.js";
+import { resolveLinkedFunction } from "../../../functions-support/link.js";
+import { resolveTrigger, shortTriggerId } from "../../../functions-support/cron.js";
+import { isInteractive, confirmAction } from "../../../ui/wizard.js";
+import { ok } from "../../../ui/glyphs.js";
+/** `synteq function cron rm <trigger>` — delete a cron trigger.
+ *  Backend: DELETE /functions/{id}/triggers/cron/{triggerId}. */
+export default class FunctionCronRm extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "Delete a cron trigger. To pause one instead, use `function cron update <id> --disable`.";
+    static examples = [
+        "<%= config.bin %> function cron rm 3f9a1c2e                     # bare: linked function",
+        "<%= config.bin %> function cron rm 3f9a1c2e --name my-fn --yes",
+        "<%= config.bin %> function cron rm 3f9a1c2e --name my-fn --yes -o json",
+    ];
+    static args = {
+        target: Args.string({ required: false, description: "Function slug or id (optional; default: the directory's linked function or --name)." }),
+        trigger: Args.string({
+            required: false,
+            description: "Trigger id — the short id from `function cron list`, or the full uuid.",
+        }),
+    };
+    static flags = {
+        name: Flags.string({
+            description: "Function slug (or uuid) (default: this directory's linked function).",
+        }),
+        yes: Flags.boolean({
+            char: "y",
+            description: "Skip the confirmation prompt (required for non-interactive use).",
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags: rawFlags } = await this.parse(FunctionCronRm);
+        const [target, trigger] = this.positional(args.target, args.trigger, "trigger");
+        const flags = { ...rawFlags, name: target ?? rawFlags.name };
+        try {
+            const { fn, clients } = await resolveLinkedFunction(this.clients, flags).catch((e) => {
+                if (e instanceof Error && !("status" in e))
+                    this.error(e.message, { exit: 1 });
+                throw e;
+            });
+            this.clients = clients;
+            const triggers = await this.clients.api.functions.cronTriggers(fn.id);
+            let target;
+            try {
+                target = resolveTrigger(triggers, trigger);
+            }
+            catch (e) {
+                this.error(e.message, { exit: 1 });
+            }
+            if (!flags.yes) {
+                if (!(isInteractive() && this.outputFormat === "table")) {
+                    this.error("Refusing to delete without --yes in a non-interactive session.", { exit: 1 });
+                }
+                const go = await confirmAction(`Delete cron trigger "${target.schedule}" from ${fn.slug}?`, false);
+                if (!go) {
+                    this.log("Aborted.");
+                    return;
+                }
+            }
+            await this.clients.api.functions.deleteCronTrigger(fn.id, target.id);
+            this.emit({ functionId: fn.id, triggerId: target.id, removed: true }, () => {
+                this.log(ok(`Deleted cron trigger ${shortTriggerId(target.id)} (${target.schedule}) from ${fn.slug}.`));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=rm.js.map

package/dist/commands/function/cron/rm.js.map

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

package/dist/commands/function/cron/run.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from "../../../base/command.js";
+/** `synteq function cron run <trigger>` — fire a cron trigger now.
+ *  Backend: POST /functions/{id}/triggers/cron/{triggerId}/run. */
+export default class FunctionCronRun extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        target: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+        trigger: 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/cron/run.js

@@ -0,0 +1,59 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../../base/command.js";
+import { resolveLinkedFunction } from "../../../functions-support/link.js";
+import { resolveTrigger, shortTriggerId } from "../../../functions-support/cron.js";
+import { withSpinner } from "../../../ui/spinner.js";
+import { ok, dim } from "../../../ui/glyphs.js";
+/** `synteq function cron run <trigger>` — fire a cron trigger now.
+ *  Backend: POST /functions/{id}/triggers/cron/{triggerId}/run. */
+export default class FunctionCronRun extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "Fire a cron trigger now, outside its schedule. It is a real invocation: metered, logged, and it updates the trigger's last-run status.";
+    static examples = [
+        "<%= config.bin %> function cron run 3f9a1c2e                   # bare: linked function",
+        "<%= config.bin %> function cron run 3f9a1c2e --name my-fn -o json",
+    ];
+    static args = {
+        target: Args.string({ required: false, description: "Function slug or id (optional; default: the directory's linked function or --name)." }),
+        trigger: Args.string({
+            required: false,
+            description: "Trigger id — the short id from `function cron list`, or the full uuid.",
+        }),
+    };
+    static flags = {
+        name: Flags.string({
+            description: "Function slug (or uuid) (default: this directory's linked function).",
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags: rawFlags } = await this.parse(FunctionCronRun);
+        const [target, trigger] = this.positional(args.target, args.trigger, "trigger");
+        const flags = { ...rawFlags, name: target ?? rawFlags.name };
+        try {
+            const { fn, clients } = await resolveLinkedFunction(this.clients, flags).catch((e) => {
+                if (e instanceof Error && !("status" in e))
+                    this.error(e.message, { exit: 1 });
+                throw e;
+            });
+            this.clients = clients;
+            const triggers = await this.clients.api.functions.cronTriggers(fn.id);
+            let target;
+            try {
+                target = resolveTrigger(triggers, trigger);
+            }
+            catch (e) {
+                this.error(e.message, { exit: 1 });
+            }
+            const result = await withSpinner("Running cron trigger", () => this.clients.api.functions.runCronTrigger(fn.id, target.id));
+            this.emit(result, () => {
+                this.log(ok(`Fired cron trigger ${shortTriggerId(result.id)} on ${fn.slug}: ${result.lastStatus ?? "sent"}.`));
+                this.log(dim(`  See the run: synteq function logs --name ${fn.slug}`));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/function/cron/run.js.map

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

package/dist/commands/function/cron/update.d.ts

@@ -0,0 +1,21 @@
+import { BaseCommand } from "../../../base/command.js";
+/** `synteq function cron update <trigger>` — edit a cron trigger.
+ *  Backend: PATCH /functions/{id}/triggers/cron/{triggerId}. */
+export default class FunctionCronUpdate extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        target: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+        trigger: 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>;
+        schedule: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        retries: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        enable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        disable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/function/cron/update.js

@@ -0,0 +1,87 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../../base/command.js";
+import { resolveLinkedFunction } from "../../../functions-support/link.js";
+import { normalizeSchedule, resolveTrigger, shortTriggerId } from "../../../functions-support/cron.js";
+import { withSpinner } from "../../../ui/spinner.js";
+import { ok } from "../../../ui/glyphs.js";
+/** `synteq function cron update <trigger>` — edit a cron trigger.
+ *  Backend: PATCH /functions/{id}/triggers/cron/{triggerId}. */
+export default class FunctionCronUpdate extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "Edit a cron trigger: schedule, description, retries, or switch it on/off. Only the flags you pass change.";
+    static examples = [
+        "<%= config.bin %> function cron update 3f9a1c2e --disable                 # bare: linked function",
+        '<%= config.bin %> function cron update 3f9a1c2e --schedule "0 */6 * * *" --name my-fn',
+        '<%= config.bin %> function cron update 3f9a1c2e --description "nightly sync" --retries 1 --name my-fn -o json',
+    ];
+    static args = {
+        target: Args.string({ required: false, description: "Function slug or id (optional; default: the directory's linked function or --name)." }),
+        trigger: Args.string({
+            required: false,
+            description: "Trigger id — the short id from `function cron list`, or the full uuid.",
+        }),
+    };
+    static flags = {
+        name: Flags.string({
+            description: "Function slug (or uuid) (default: this directory's linked function).",
+        }),
+        schedule: Flags.string({ char: "s", description: "New cron expression, quoted (UTC)." }),
+        description: Flags.string({ char: "d", description: "New description." }),
+        retries: Flags.integer({ description: "Re-fire a failed run this many times (0-2).", min: 0, max: 2 }),
+        enable: Flags.boolean({ description: "Switch the trigger on.", exclusive: ["disable"] }),
+        disable: Flags.boolean({ description: "Switch the trigger off (it stays listed).", exclusive: ["enable"] }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags: rawFlags } = await this.parse(FunctionCronUpdate);
+        const [target, trigger] = this.positional(args.target, args.trigger, "trigger");
+        const flags = { ...rawFlags, name: target ?? rawFlags.name };
+        try {
+            const body = {};
+            if (flags.schedule !== undefined) {
+                try {
+                    body.schedule = normalizeSchedule(flags.schedule);
+                }
+                catch (e) {
+                    this.error(e.message, { exit: 1 });
+                }
+            }
+            if (flags.description !== undefined)
+                body.description = flags.description;
+            if (flags.retries !== undefined)
+                body.retries = flags.retries;
+            if (flags.enable)
+                body.enabled = true;
+            if (flags.disable)
+                body.enabled = false;
+            if (Object.keys(body).length === 0) {
+                this.error("Nothing to change — pass --schedule, --description, --retries, --enable or --disable.", {
+                    exit: 1,
+                });
+            }
+            const { fn, clients } = await resolveLinkedFunction(this.clients, flags).catch((e) => {
+                if (e instanceof Error && !("status" in e))
+                    this.error(e.message, { exit: 1 });
+                throw e;
+            });
+            this.clients = clients;
+            const triggers = await this.clients.api.functions.cronTriggers(fn.id);
+            let target;
+            try {
+                target = resolveTrigger(triggers, trigger);
+            }
+            catch (e) {
+                this.error(e.message, { exit: 1 });
+            }
+            const updated = await withSpinner("Updating cron trigger", () => this.clients.api.functions.updateCronTrigger(fn.id, target.id, body));
+            this.emit(updated, () => {
+                this.log(ok(`Updated cron trigger ${shortTriggerId(updated.id)} on ${fn.slug}: ${updated.schedule} (UTC), ` +
+                    `${updated.enabled ? "enabled" : "disabled"}, retries ${updated.retries}.`));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/function/cron/update.js.map

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

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

@@ -0,0 +1,23 @@
+import { BaseCommand } from "../../base/command.js";
+/** `synteq function delete` — destroy a function. Backend: DELETE /functions/{id},
+ *  which the API allows only once the function has been PAUSED for 14 days
+ *  (start the clock with `synteq function pause`; before that the API answers
+ *  409 naming the date, and this command surfaces that as-is).
+ *  Irreversible, so a TTY has to retype the slug; --yes skips that retype,
+ *  but the password step-up below still needs a terminal — there is no fully
+ *  scripted path.
+ *  Any directory link pointing at the function is dropped too, so a later
+ *  `synteq function deploy` in that tree doesn't 404 against a dead id. */
+export default class FunctionDelete 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>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/function/delete.js

@@ -0,0 +1,90 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../base/command.js";
+import { resolveLinkedFunction } from "../../functions-support/link.js";
+import { linkKind } from "../../config/store.js";
+import { withSpinner } from "../../ui/spinner.js";
+import { isInteractive, promptSecret, promptString } from "../../ui/wizard.js";
+import { ok, dim } from "../../ui/glyphs.js";
+/** `synteq function delete` — destroy a function. Backend: DELETE /functions/{id},
+ *  which the API allows only once the function has been PAUSED for 14 days
+ *  (start the clock with `synteq function pause`; before that the API answers
+ *  409 naming the date, and this command surfaces that as-is).
+ *  Irreversible, so a TTY has to retype the slug; --yes skips that retype,
+ *  but the password step-up below still needs a terminal — there is no fully
+ *  scripted path.
+ *  Any directory link pointing at the function is dropped too, so a later
+ *  `synteq function deploy` in that tree doesn't 404 against a dead id. */
+export default class FunctionDelete extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "Delete a function (paused for 14 days first) and forget any directory linked to it.";
+    static examples = [
+        "<%= config.bin %> function delete my-fn",
+        "<%= config.bin %> function delete my-fn --yes   # skip the retype-the-slug step; the password is still asked for",
+        "<%= config.bin %> function delete my-fn --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.",
+        }),
+        yes: Flags.boolean({
+            char: "y",
+            description: "Skip the type-the-slug confirmation. The account password is still prompted for, so a terminal is required either way.",
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(FunctionDelete);
+        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 delete without a confirmation. Re-run with --yes.", { exit: 1 });
+                }
+                this.log(`This permanently deletes ${fn.slug} (${fn.hostname}) and its releases.`);
+                const typed = await promptString(`Type "${fn.slug}" to confirm`, { allowEmpty: true });
+                if (typed.trim() !== fn.slug) {
+                    this.log("Aborted.");
+                    return;
+                }
+            }
+            // The API verifies the account password on a delete (step-up); a
+            // password never rides in argv or a flag, so this needs a terminal.
+            if (!isInteractive()) {
+                this.error("Deleting a function needs your password, which can only be typed at a terminal.", { exit: 1 });
+            }
+            const password = await promptSecret("Your account password");
+            await withSpinner(`Deleting ${fn.slug}`, () => this.clients.api.functions.delete(fn.id, password));
+            // Drop every directory link that pointed at this function.
+            const links = this.clients.config.get().links ?? {};
+            const unlinked = [];
+            for (const [dir, link] of Object.entries(links)) {
+                if (linkKind(link) === "function" && link.app_id === fn.id) {
+                    this.clients.config.removeLink(dir);
+                    unlinked.push(dir);
+                }
+            }
+            this.emit({ id: fn.id, slug: fn.slug, deleted: true, unlinked }, () => {
+                this.log(ok(`Deleted ${fn.slug}.`));
+                for (const dir of unlinked)
+                    this.log(dim(`  Unlinked ${dir}.`));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=delete.js.map

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

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