@synteq/cli 0.2.0 → 1.1.2

package/dist/commands/function/create.js

@@ -0,0 +1,113 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../base/command.js";
+import { statusColor, dim } from "../../ui/glyphs.js";
+import { panel } from "../../ui/wizard.js";
+import { withSpinner } from "../../ui/spinner.js";
+import { RUNTIMES } from "../../functions-support/runtime.js";
+/**
+ * `synteq function create` — create a serverless function in the active project.
+ *
+ * Backend: POST /functions. Placement takes exactly one of `region` or
+ * `locationId`, so `--region` and `--location` are mutually exclusive; with
+ * neither, the first row of GET /functions-locations is used. The plan
+ * defaults to the first tier GET /functions-plans returns.
+ */
+export default class FunctionCreate extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "Create a serverless function in the active project.";
+    static examples = [
+        "<%= config.bin %> function create my-fn",
+        "<%= config.bin %> function create my-fn --runtime python312 --location dfw",
+        "<%= config.bin %> function create my-fn --plan starter --region us-central",
+        "<%= config.bin %> function create my-fn -o json   # scriptable: prints the Fn row",
+    ];
+    static args = {
+        name: Args.string({
+            required: true,
+            description: "Function name — slugified into <name>.fn.synteq.app; unique within the project.",
+        }),
+    };
+    static flags = {
+        plan: Flags.string({
+            description: "Plan tier slug (default: the first tier `synteq function create` finds server-side).",
+        }),
+        region: Flags.string({
+            exclusive: ["location"],
+            description: "Region to run in, e.g. us-central (mutually exclusive with --location).",
+        }),
+        location: Flags.string({
+            exclusive: ["region"],
+            description: "Location code, e.g. dfw — resolved against the locations catalog (mutually exclusive with --region). Default: the first location.",
+        }),
+        runtime: Flags.string({
+            options: [...RUNTIMES],
+            default: "node22",
+            description: `Handler runtime: ${RUNTIMES.join(" or ")} (default: node22).`,
+        }),
+        project: Flags.string({
+            description: "Project id to create in (defaults to the active project).",
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(FunctionCreate);
+        try {
+            const body = {
+                name: args.name,
+                planTier: flags.plan ?? (await this.defaultPlan()),
+                runtime: flags.runtime,
+            };
+            if (flags.region) {
+                body.region = flags.region;
+            }
+            else {
+                const loc = await this.resolveLocation(flags.location);
+                if (loc)
+                    body.locationId = loc;
+            }
+            const fn = await withSpinner(`Creating ${args.name}`, () => this.clients.api.functions.create(body, flags.project));
+            this.emit(fn, () => {
+                this.log(panel("Function created", [
+                    ["Slug", fn.slug],
+                    ["ID", fn.id],
+                    ["Status", statusColor(fn.status)],
+                    ["Runtime", fn.runtime],
+                    ["Plan", fn.planTier],
+                    ["Region", fn.region],
+                    ["Hostname", fn.hostname],
+                ]));
+                this.log("");
+                this.log(`Deploy it: synteq function deploy --name ${fn.slug}`);
+                this.log(dim(`  Or scaffold a handler here first: synteq function init ${fn.slug}`));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+    /** The first plan the catalog offers — the backend has no "default" flag. */
+    async defaultPlan() {
+        const plans = await this.clients.api.functions.plans();
+        if (plans.length === 0) {
+            this.error("No function plans are available on this account.", { exit: 1 });
+        }
+        return plans[0].name;
+    }
+    /** A location code → its id, or the first location's id when none is given. */
+    async resolveLocation(code) {
+        const locations = await this.clients.api.functions.locations();
+        if (locations.length === 0) {
+            if (code)
+                this.error(`Unknown location "${code}" — no locations are available.`, { exit: 1 });
+            return undefined;
+        }
+        if (!code)
+            return locations[0].locationId;
+        const hit = locations.find((l) => l.code.toLowerCase() === code.toLowerCase());
+        if (!hit) {
+            this.error(`Unknown location "${code}". Available: ${locations.map((l) => l.code).join(", ")}.`, { exit: 1 });
+        }
+        return hit.locationId;
+    }
+}
+//# sourceMappingURL=create.js.map

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

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

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

@@ -0,0 +1,29 @@
+import { BaseCommand } from "../../../base/command.js";
+/**
+ * `synteq function credits add` — buy run credits: price → confirm → charge,
+ * the `orderPaidApp` shape. The team pool has a quote route (tax included);
+ * a function's own pool does not, so its confirm line is the billing view's
+ * credit rate × runs, labelled an estimate with tax added at checkout.
+ *
+ * Backend: POST /functions/{id}/credits/purchase, or
+ * POST /functions-team-credits/quote + /functions-team-credits/purchase.
+ * The purchase mints a due-on-receipt invoice; the credits land when it
+ * settles (instantly for a card).
+ */
+export default class FunctionCreditsAdd extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        target: 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>;
+        runs: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        pool: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "payment-method": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "apply-credits": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,209 @@
+import { Args, Flags } from "@oclif/core";
+import open from "open";
+import { BaseCommand } from "../../../base/command.js";
+import { ApiError } from "../../../api/errors.js";
+import { CreditsPaymentError, creditsChargeLine, money, num, pickCreditsMethod, resolveCreditsFunction, runs as runsText, poolByDefault } from "../../../functions-support/credits.js";
+import { withSpinner } from "../../../ui/spinner.js";
+import { confirmAction, isInteractive, panel, promptNumber, readBalance } from "../../../ui/wizard.js";
+import { yesRequiredMessage } from "../../../ui/confirm.js";
+import { dim, ok, statusColor } from "../../../ui/glyphs.js";
+/**
+ * `synteq function credits add` — buy run credits: price → confirm → charge,
+ * the `orderPaidApp` shape. The team pool has a quote route (tax included);
+ * a function's own pool does not, so its confirm line is the billing view's
+ * credit rate × runs, labelled an estimate with tax added at checkout.
+ *
+ * Backend: POST /functions/{id}/credits/purchase, or
+ * POST /functions-team-credits/quote + /functions-team-credits/purchase.
+ * The purchase mints a due-on-receipt invoice; the credits land when it
+ * settles (instantly for a card).
+ */
+export default class FunctionCreditsAdd extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = [
+        "Buy run credits for a function (or the team pool) with a saved payment method.",
+        "",
+        "Prices the purchase, asks you to confirm the charge, then charges it. The",
+        "team pool's price is a quote with tax; a function's own pool is priced from",
+        "its credit rate (tax is added at checkout). Piped runs require --yes.",
+    ].join("\n");
+    static examples = [
+        "<%= config.bin %> function credits add --runs 100000                       # linked function; pick a card, confirm",
+        "<%= config.bin %> function credits add --name my-fn --runs 100000 --payment-method 019e... --yes",
+        "<%= config.bin %> function credits add --pool --runs 1000000 --apply-credits",
+        "<%= config.bin %> function credits add --name my-fn --runs 100000 --yes -o json",
+    ];
+    static args = {
+        target: Args.string({ required: false, description: "Function slug or id (optional; default: the directory's linked function or --name)." }),
+    };
+    static flags = {
+        name: Flags.string({
+            description: "Function slug (or uuid) (default: this directory's linked function).",
+            exclusive: ["pool"],
+        }),
+        runs: Flags.integer({
+            min: 1,
+            description: "How many run credits to buy (a whole number; the plan may set a min, max and step — see `function credits`). Prompted on a TTY when omitted.",
+        }),
+        pool: Flags.boolean({
+            description: "Buy into the team pool instead of one function's credits.",
+        }),
+        "payment-method": Flags.string({
+            description: "Saved payment method id (full or a unique prefix, see `synteq payments methods list`) (default: the team's default method).",
+        }),
+        "apply-credits": Flags.boolean({
+            description: "Use the team's account credit balance first; the payment method pays the rest.",
+        }),
+        yes: Flags.boolean({
+            char: "y",
+            description: "Charge without confirming. Required when stdout is not a TTY.",
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags: rawFlags } = await this.parse(FunctionCreditsAdd);
+        const flags = { ...rawFlags, name: args.target ?? rawFlags.name };
+        try {
+            const interactive = isInteractive() && this.outputFormat === "table" && !flags.yes;
+            let runs = flags.runs;
+            if (runs === undefined) {
+                if (!interactive)
+                    this.error("Provide --runs <N>: how many run credits to buy.", { exit: 1 });
+                runs = await promptNumber("How many run credits?", { min: 1 });
+                if (!Number.isInteger(runs))
+                    this.error("Run credits come in whole runs.", { exit: 1 });
+            }
+            // 1. The price. A refused quote (off the purchase grid, no credits on
+            //    this plan) is the answer, not a degraded estimate: say it and stop.
+            let fnId;
+            let target = "in the team pool";
+            let total;
+            let taxTotal = 0;
+            let taxLabel = "tax";
+            let currency = "USD";
+            let estimate = false;
+            const quotePool = async () => {
+                const q = await withSpinner("Pricing", () => this.clients.api.functions.quoteTeamCredits({ runs: runs })).catch((e) => {
+                    if (e instanceof ApiError && e.status >= 400 && e.status < 500 && e.status !== 429) {
+                        this.error(`Can't buy ${runs.toLocaleString("en-US")} run credits: ${e.detail}`, { exit: 1 });
+                    }
+                    throw e;
+                });
+                total = Number(q.total);
+                taxTotal = Number(q.tax ?? 0);
+                taxLabel = q.taxLabel ?? "tax";
+                currency = q.currency ?? "USD";
+            };
+            if (poolByDefault(this.clients, flags)) {
+                const team = await withSpinner("Loading the team pool", () => this.clients.api.functions.teamBilling());
+                if (!team.hasTeamPlan) {
+                    this.error("This team has no team-level function plan — each function bills on its own. Pass --name <slug> instead of --pool.", { exit: 1 });
+                }
+                await quotePool();
+            }
+            else {
+                const { fn, clients } = await resolveCreditsFunction(this.clients, flags).catch((e) => {
+                    if (e instanceof Error && !("status" in e))
+                        this.error(e.message, { exit: 1 });
+                    throw e;
+                });
+                this.clients = clients;
+                fnId = fn.id;
+                const billing = await withSpinner("Loading credits", () => this.clients.api.functions.billing(fn.id));
+                const rate = num(billing.creditRateUsd);
+                if (rate === null) {
+                    this.error(`${fn.slug}'s plan doesn't sell run credits.`, { exit: 1 });
+                }
+                if (billing.source === "team") {
+                    // A team-plan function's credits land in the team pool, priced at
+                    // the pool's rate — exactly what the pool's quote route prices.
+                    target = `on ${fn.slug} (they land in the team pool)`;
+                    await quotePool();
+                }
+                else {
+                    // No per-function quote route: rate × runs, tax at checkout.
+                    target = `on ${fn.slug}`;
+                    total = Math.round(rate * runs * 100) / 100;
+                    estimate = true;
+                }
+            }
+            // 2. Account credit first, when the team has some and asked (or is asked).
+            const balance = await this.clients.api.billing.balance().catch(() => ({}));
+            const credit = readBalance(balance.credit);
+            let applyCredits = Boolean(flags["apply-credits"]);
+            if (!applyCredits && credit > 0 && interactive) {
+                applyCredits = await confirmAction(`Apply your credit balance (${money(credit)}) first?`, true);
+            }
+            const creditsApplied = applyCredits ? Math.min(credit, total) : 0;
+            // An estimate leaves tax out, so credit "covering" it can't be trusted:
+            // a card still backs the residual.
+            const coveredByCredit = applyCredits && !estimate && total > 0 && credit >= total;
+            // 3. A card the function_credits touchpoint may charge.
+            let method;
+            if (!coveredByCredit) {
+                method = await pickCreditsMethod(this.clients, {
+                    paymentMethodId: flags["payment-method"],
+                    interactive,
+                }).catch((e) => {
+                    if (e instanceof CreditsPaymentError)
+                        this.error(e.message, { exit: 1 });
+                    throw e;
+                });
+            }
+            // 4. Confirm. A script passes --yes; a run nobody can answer must not
+            //    charge silently.
+            const line = creditsChargeLine({
+                total: total, taxTotal, taxLabel, currency, estimate, runs, target, method, creditsApplied,
+            });
+            if (!flags.yes) {
+                if (!interactive) {
+                    this.error(`${line.replace(/\?$/, ".")}\n${yesRequiredMessage("`function credits add`")}`, { exit: 1 });
+                }
+                if (!(await confirmAction(line, true))) {
+                    this.log("Not charged.");
+                    return;
+                }
+            }
+            else if (this.outputFormat === "table") {
+                this.log(dim(line.replace(/\?$/, ".")));
+            }
+            // 5. Charge.
+            const body = { runs };
+            if (method)
+                body.payment_method_id = method.id;
+            body.apply_credits = applyCredits;
+            const result = await withSpinner("Charging", () => fnId
+                ? this.clients.api.functions.purchaseCredits(fnId, body)
+                : this.clients.api.functions.purchaseTeamCredits(body));
+            this.emit(result, () => {
+                const amount = num(result.amountUsd);
+                this.log(panel("Run credits purchase", [
+                    ["Status", statusColor(result.status)],
+                    ["Runs", runsText(result.runs)],
+                    ["Amount", amount !== null ? money(amount) : null],
+                    ["Balance", result.creditBalance != null ? runsText(result.creditBalance) : null],
+                    ["Invoice id", result.invoiceId],
+                    ["Charge id", result.chargeId],
+                    ["Provider", result.provider],
+                    ["Checkout URL", result.checkoutUrl],
+                ]));
+                if (result.checkoutUrl) {
+                    this.log(dim("  The credits land once the checkout is paid."));
+                }
+                else if (["paid", "succeeded", "success", "complete"].includes((result.status ?? "").toLowerCase())) {
+                    this.log(ok(`Added ${runsText(result.runs)}.`));
+                }
+            });
+            if (result.checkoutUrl && process.stdout.isTTY) {
+                try {
+                    await open(result.checkoutUrl);
+                }
+                catch { }
+            }
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=add.js.map

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

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

package/dist/commands/function/credits/auto-reload.d.ts

@@ -0,0 +1,27 @@
+import { BaseCommand } from "../../../base/command.js";
+/**
+ * `synteq function credits auto-reload` — arm, re-tune or disarm the credit
+ * standing order: when the balance drops below the threshold, buy `--runs`
+ * more on the team's default payment method.
+ *
+ * Backend: PUT /functions/{id}/credits/auto-reload (or the team pool's
+ * /functions-team-credits/auto-reload), then the billing view is re-read so
+ * what prints is the state the server now holds.
+ */
+export default class FunctionCreditsAutoReload extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        target: 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>;
+        pool: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        on: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        off: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        runs: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        threshold: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/function/credits/auto-reload.js

@@ -0,0 +1,107 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../../base/command.js";
+import { functionCreditRows, resolveCreditsFunction, teamCreditRows, poolByDefault } from "../../../functions-support/credits.js";
+import { withSpinner } from "../../../ui/spinner.js";
+import { panel } from "../../../ui/wizard.js";
+import { ok } from "../../../ui/glyphs.js";
+/**
+ * `synteq function credits auto-reload` — arm, re-tune or disarm the credit
+ * standing order: when the balance drops below the threshold, buy `--runs`
+ * more on the team's default payment method.
+ *
+ * Backend: PUT /functions/{id}/credits/auto-reload (or the team pool's
+ * /functions-team-credits/auto-reload), then the billing view is re-read so
+ * what prints is the state the server now holds.
+ */
+export default class FunctionCreditsAutoReload extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = [
+        "Turn run-credit auto-reload on or off for a function (or the team pool).",
+        "",
+        "--on --runs N buys N run credits whenever the balance drops below",
+        "--threshold (default: below one reload's worth). --off disarms it and",
+        "clears both numbers. A function on a team plan reloads the team pool.",
+    ].join("\n");
+    static examples = [
+        "<%= config.bin %> function credits auto-reload --on --runs 100000                      # linked function",
+        "<%= config.bin %> function credits auto-reload --name my-fn --on --runs 100000 --threshold 20000",
+        "<%= config.bin %> function credits auto-reload --pool --off",
+        "<%= config.bin %> function credits auto-reload --name my-fn --off -o json",
+    ];
+    static args = {
+        target: Args.string({ required: false, description: "Function slug or id (optional; default: the directory's linked function or --name)." }),
+    };
+    static flags = {
+        name: Flags.string({
+            description: "Function slug (or uuid) (default: this directory's linked function).",
+            exclusive: ["pool"],
+        }),
+        pool: Flags.boolean({
+            description: "Set the team pool's auto-reload instead of one function's.",
+        }),
+        on: Flags.boolean({
+            description: "Arm auto-reload. Needs --runs.",
+            exclusive: ["off"],
+        }),
+        off: Flags.boolean({
+            description: "Disarm auto-reload (clears the reload size and threshold).",
+            exclusive: ["on", "runs", "threshold"],
+        }),
+        runs: Flags.integer({
+            min: 1,
+            description: "Run credits each reload buys (with --on; required to arm).",
+        }),
+        threshold: Flags.integer({
+            min: 1,
+            description: "Reload when the balance drops below this many runs (with --on; default: one reload's worth).",
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags: rawFlags } = await this.parse(FunctionCreditsAutoReload);
+        const flags = { ...rawFlags, name: args.target ?? rawFlags.name };
+        try {
+            if (!flags.on && !flags.off) {
+                this.error("Pass --on --runs <N> [--threshold <N>] to arm auto-reload, or --off to disarm it.", { exit: 1 });
+            }
+            if (flags.on && flags.runs === undefined) {
+                this.error("--on needs --runs <N>: how many run credits each reload buys.", { exit: 1 });
+            }
+            const body = flags.on
+                ? {
+                    enabled: true,
+                    runs: flags.runs,
+                    ...(flags.threshold !== undefined ? { threshold_runs: flags.threshold } : {}),
+                }
+                : { enabled: false };
+            const verb = flags.on ? "Arming auto-reload" : "Turning auto-reload off";
+            if (poolByDefault(this.clients, flags)) {
+                await withSpinner(verb, () => this.clients.api.functions.setTeamCreditAutoReload(body));
+                const team = await this.clients.api.functions.teamBilling();
+                this.emit(team, () => {
+                    this.log(ok(`Auto-reload ${flags.on ? "on" : "off"} for the team pool.`));
+                    if (team.hasTeamPlan && team.plan)
+                        this.log(panel("Team run credits", teamCreditRows(team)));
+                });
+                return;
+            }
+            const { fn, clients } = await resolveCreditsFunction(this.clients, flags).catch((e) => {
+                if (e instanceof Error && !("status" in e))
+                    this.error(e.message, { exit: 1 });
+                throw e;
+            });
+            this.clients = clients;
+            await withSpinner(verb, () => this.clients.api.functions.setCreditAutoReload(fn.id, body));
+            const billing = await this.clients.api.functions.billing(fn.id);
+            this.emit(billing, () => {
+                const where = billing.source === "team" ? `${fn.slug}'s pool (the team pool)` : fn.slug;
+                this.log(ok(`Auto-reload ${flags.on ? "on" : "off"} for ${where}.`));
+                this.log(panel("Run credits", functionCreditRows(fn.slug, billing)));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=auto-reload.js.map

package/dist/commands/function/credits/auto-reload.js.map

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

package/dist/commands/function/credits/index.d.ts

@@ -0,0 +1,22 @@
+import { BaseCommand } from "../../../base/command.js";
+/**
+ * `synteq function credits` — a function's run credits: balance, plan,
+ * monthly grant, credit rate and the auto-reload standing order. `--pool`
+ * shows the team pool instead (every function without its own plan spends
+ * from it).
+ *
+ * Backend: GET /functions/{id}/billing, or GET /functions-team-billing.
+ */
+export default class FunctionCredits extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        target: 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>;
+        pool: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/function/credits/index.js

@@ -0,0 +1,80 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../../base/command.js";
+import { functionCreditRows, resolveCreditsFunction, teamCreditRows, poolByDefault } from "../../../functions-support/credits.js";
+import { withSpinner } from "../../../ui/spinner.js";
+import { panel } from "../../../ui/wizard.js";
+import { dim } from "../../../ui/glyphs.js";
+/**
+ * `synteq function credits` — a function's run credits: balance, plan,
+ * monthly grant, credit rate and the auto-reload standing order. `--pool`
+ * shows the team pool instead (every function without its own plan spends
+ * from it).
+ *
+ * Backend: GET /functions/{id}/billing, or GET /functions-team-billing.
+ */
+export default class FunctionCredits extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = [
+        "Show a function's run credits: balance, plan, monthly grant, credit rate and auto-reload.",
+        "",
+        "Run credits pay for invocations on a credits plan. --pool shows the team",
+        "pool that every function without its own plan draws from. Buy more with",
+        "`function credits add`; keep the balance topped up with",
+        "`function credits auto-reload`.",
+    ].join("\n");
+    static examples = [
+        "<%= config.bin %> function credits                  # bare: this directory's linked function",
+        "<%= config.bin %> function credits --name my-fn",
+        "<%= config.bin %> function credits --pool           # the team pool",
+        "<%= config.bin %> function credits --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)." }),
+    };
+    static flags = {
+        name: Flags.string({
+            description: "Function slug (or uuid) (default: this directory's linked function).",
+            exclusive: ["pool"],
+        }),
+        pool: Flags.boolean({
+            description: "Show the team pool instead of one function's credits.",
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags: rawFlags } = await this.parse(FunctionCredits);
+        const flags = { ...rawFlags, name: args.target ?? rawFlags.name };
+        try {
+            if (poolByDefault(this.clients, flags)) {
+                const team = await withSpinner("Loading the team pool", () => this.clients.api.functions.teamBilling());
+                this.emit(team, () => {
+                    if (!team.hasTeamPlan || !team.plan) {
+                        this.log("This team has no team-level function plan — each function bills on its own.");
+                        this.log(dim("  See one: synteq function credits --name <slug>"));
+                        return;
+                    }
+                    this.log(panel("Team run credits", teamCreditRows(team)));
+                });
+                return;
+            }
+            const { fn, clients } = await resolveCreditsFunction(this.clients, flags).catch((e) => {
+                if (e instanceof Error && !("status" in e))
+                    this.error(e.message, { exit: 1 });
+                throw e;
+            });
+            this.clients = clients;
+            const billing = await withSpinner("Loading credits", () => this.clients.api.functions.billing(fn.id));
+            this.emit(billing, () => {
+                this.log(panel("Run credits", functionCreditRows(fn.slug, billing)));
+                if (billing.creditRateUsd == null) {
+                    this.log("");
+                    this.log(dim("  This function's plan doesn't sell run credits."));
+                }
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/function/credits/index.js.map

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