@synteq/cli 0.1.6 → 1.1.1

package/dist/commands/app/plan/change.js

@@ -0,0 +1,79 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../../base/command.js";
+import { withSpinner } from "../../../ui/spinner.js";
+import { panel, isInteractive, confirmAction } from "../../../ui/wizard.js";
+import { ok, dim, yellow } from "../../../ui/glyphs.js";
+/** `synteq app plan change <tier>` — move an app to another plan (previews the
+ *  proration first, then confirms). */
+export default class PlanChange extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "Change an app's plan; previews the prorated charge and downgrade warnings before applying.";
+    static examples = [
+        "<%= config.bin %> app plan change pro                       # upgrade linked app",
+        "<%= config.bin %> app plan change hobby --app my-api --at cycle_end",
+        "<%= config.bin %> app plan change pro --app my-api --yes -o json",
+    ];
+    static args = {
+        target: Args.string({ required: false, description: "App slug or id (optional; default: the directory's linked app or --app)." }),
+        tier: Args.string({ required: false, description: "Target plan tier (free | hobby | starter | pro)." }),
+    };
+    static flags = {
+        app: Flags.string({ description: "App slug (or uuid) (default: the directory's linked app)." }),
+        at: Flags.string({
+            options: ["now", "cycle_end"],
+            default: "now",
+            description: "When to apply the change (now: prorated immediately; cycle_end: at the next renewal). Default now.",
+        }),
+        yes: Flags.boolean({ char: "y", description: "Skip the confirmation prompt." }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(PlanChange);
+        const [target, tier] = this.positional(args.target, args.tier, "tier");
+        try {
+            const app = await this.resolveLinkedApp(flags, target);
+            const preview = await withSpinner("Previewing change", () => this.clients.api.apps.planPreview(app.id, tier, flags.at));
+            const interactive = isInteractive() && this.outputFormat === "table";
+            if (interactive || !flags.yes) {
+                this.log(panel(`Change ${app.slug} → ${tier}`, [
+                    ["Action", preview.action],
+                    ["Prorated now", `$${preview.proratedCharge}`],
+                    ["Tax", `$${preview.tax}`],
+                    ["New monthly", `$${preview.newMonthly}`],
+                ]));
+                if (preview.belowUsage) {
+                    this.log(yellow(`\n⚠ This plan is below recent p95 usage` +
+                        `${preview.p95Cpu != null ? ` (cpu ${preview.p95Cpu})` : ""}` +
+                        `${preview.p95Mem != null ? ` (mem ${preview.p95Mem})` : ""}` +
+                        ` — the app may be throttled or restarted.`));
+                }
+            }
+            if (!flags.yes) {
+                if (!interactive) {
+                    this.error("Refusing to change plan without --yes in non-interactive mode.", { exit: 1 });
+                }
+                const go = await confirmAction(`Apply this plan change?`, false);
+                if (!go) {
+                    this.log("Aborted.");
+                    return;
+                }
+            }
+            const result = await withSpinner("Changing plan", () => this.clients.api.apps.changePlan(app.id, { planTier: tier, schedule: flags.at }));
+            this.emit(result, () => {
+                if (result.pendingPlanTier) {
+                    this.log(ok(`Scheduled: ${app.slug} → ${result.pendingPlanTier} at ${result.pendingPlanTierAt ?? "next renewal"}.`));
+                }
+                else {
+                    this.log(ok(`${app.slug} is now on ${result.planTier} ($${result.newMonthly}/mo).`));
+                    if (result.proratedCharge && result.proratedCharge !== "0.00") {
+                        this.log(dim(`Charged $${result.proratedCharge} (+ $${result.tax} tax) prorated now.`));
+                    }
+                }
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=change.js.map

package/dist/commands/app/plan/change.js.map

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

package/dist/commands/app/plan/show.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from "../../../base/command.js";
+/** `synteq app plan show` — the app's current plan + the plans it can move to. */
+export default class PlanShow 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: {
+        app: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/app/plan/show.js

@@ -0,0 +1,40 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand, appTargetArg } from "../../../base/command.js";
+import { withSpinner } from "../../../ui/spinner.js";
+import { panel } from "../../../ui/wizard.js";
+import { dim } from "../../../ui/glyphs.js";
+/** `synteq app plan show` — the app's current plan + the plans it can move to. */
+export default class PlanShow extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "Show an app's current plan and the plans available to switch to.";
+    static examples = [
+        "<%= config.bin %> app plan show                # bare: linked app",
+        "<%= config.bin %> app plan show --app my-api -o json",
+    ];
+    static args = { ...appTargetArg };
+    static flags = {
+        app: Flags.string({ description: "App slug (or uuid) (default: the directory's linked app)." }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(PlanShow);
+        try {
+            const app = await this.resolveLinkedApp(flags, args.target);
+            const [detail, plans] = await withSpinner("Loading plan", () => Promise.all([this.clients.api.apps.get(app.id), this.clients.api.apps.plans()]));
+            this.emit({ current: detail.planTier, plans }, () => {
+                this.log(panel(app.slug, [["Current plan", detail.planTier ?? dim("—")]]));
+                this.log(dim("\nAvailable plans:"));
+                for (const p of plans) {
+                    const mark = p.name === detail.planTier ? "•" : " ";
+                    const price = p.isFree ? "free" : `$${p.monthlyAnchorUsd ?? "?"}/mo`;
+                    this.log(`  ${mark} ${p.name.padEnd(10)} ${(p.displayName ?? "").padEnd(18)} ${dim(price)}`);
+                }
+                this.log(dim("\nChange with: synteq app plan change <tier> --app " + app.slug));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=show.js.map

package/dist/commands/app/plan/show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.js","sourceRoot":"","sources":["../../../../src/commands/app/plan/show.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAE5C,kFAAkF;AAClF,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAAW;IAC/C,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,WAAW,GAAG,kEAAkE,CAAC;IACxF,MAAM,CAAC,QAAQ,GAAG;QAChB,mEAAmE;QACnE,sDAAsD;KACvD,CAAC;IACF,MAAM,CAAC,IAAI,GAAG,EAAE,GAAG,YAAY,EAAE,CAAC;IAClC,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,2DAA2D,EAAE,CAAC;KAChG,CAAC;IACF,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACnD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAC5D,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,MAAM,WAAW,CAAC,cAAc,EAAE,GAAG,EAAE,CAC7D,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAChF,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE;gBAClD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC,QAAQ,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC3E,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC;gBACpC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;oBACtB,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;oBACpD,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,gBAAgB,IAAI,GAAG,KAAK,CAAC;oBACrE,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAC/F,CAAC;gBACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,qDAAqD,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;YAClF,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/app/settings/set.d.ts

@@ -0,0 +1,25 @@
+import { BaseCommand } from "../../../base/command.js";
+/** `synteq app settings set` — patch one or more build/deploy settings. Only
+ *  the flags you pass are changed; the rest are left as they are. */
+export default class SettingsSet 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: {
+        app: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "root-directory": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "dockerfile-path": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "build-context": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "docker-command": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "pre-deploy-command": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "auto-deploy": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "health-check-path": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "build-filter-included": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "build-filter-ignored": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        port: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/app/settings/set.js

@@ -0,0 +1,96 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand, appTargetArg } from "../../../base/command.js";
+import { withSpinner } from "../../../ui/spinner.js";
+import { ok, dim } from "../../../ui/glyphs.js";
+/** A build filter is a list of globs; the flag takes them comma-separated, the
+ *  way the portal's field does — a repeatable flag would swallow a positional
+ *  app name that follows it. `''` is the "clear it" value, mirroring
+ *  `--port 0 → null` below: `[]` is what the API takes to mean "no filter". */
+const globs = (v) => v
+    .split(",")
+    .map((g) => g.trim())
+    .filter(Boolean);
+/** `synteq app settings set` — patch one or more build/deploy settings. Only
+ *  the flags you pass are changed; the rest are left as they are. */
+export default class SettingsSet extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "Change an app's build/deploy settings. Only the flags you pass are updated; omit a flag to leave it unchanged.";
+    static examples = [
+        "<%= config.bin %> app settings set --auto-deploy off",
+        "<%= config.bin %> app settings set --root-directory backend --dockerfile-path backend/Dockerfile --app my-api",
+        "<%= config.bin %> app settings set --health-check-path /healthz --app my-api -o json",
+        "<%= config.bin %> app settings set --port 5230 --app my-memos",
+        "<%= config.bin %> app settings set --port 0 --app my-memos",
+        "<%= config.bin %> app settings set my-api --build-filter-included 'backend/**,shared/**' --build-filter-ignored '**/*.md'",
+        "<%= config.bin %> app settings set --build-filter-included '' --app my-api   # clear the included filter",
+    ];
+    static args = { ...appTargetArg };
+    static flags = {
+        app: Flags.string({ description: "App slug (or uuid) (default: the directory's linked app)." }),
+        "root-directory": Flags.string({ description: "Subdirectory to build from (default: repo root)." }),
+        "dockerfile-path": Flags.string({ description: "Path to the Dockerfile, relative to the build context." }),
+        "build-context": Flags.string({ description: "Docker build context directory." }),
+        "docker-command": Flags.string({ description: "Override the container start command." }),
+        "pre-deploy-command": Flags.string({ description: "Command run once before each deploy (migrations etc.)." }),
+        "auto-deploy": Flags.string({
+            options: ["on_commit", "off"],
+            description: "Deploy automatically on every push (on_commit) or only manually (off).",
+        }),
+        "health-check-path": Flags.string({ description: "HTTP path polled to gate a deploy healthy (e.g. /healthz)." }),
+        "build-filter-included": Flags.string({
+            description: "Comma-separated path globs whose changes trigger a build. A push touching none of them is skipped; with no filter any change builds. Pass '' to clear.",
+        }),
+        "build-filter-ignored": Flags.string({
+            description: "Comma-separated path globs to ignore when deciding to build. A push touching only these won't build. Pass '' to clear.",
+        }),
+        port: Flags.integer({
+            description: "Port the app listens on (1-65535). The health check and traffic both go here. Pass 0 to clear it and let the runtime detect the port.",
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(SettingsSet);
+        try {
+            const patch = {};
+            if (flags["root-directory"] !== undefined)
+                patch.rootDirectory = flags["root-directory"];
+            if (flags["dockerfile-path"] !== undefined)
+                patch.dockerfilePath = flags["dockerfile-path"];
+            if (flags["build-context"] !== undefined)
+                patch.buildContext = flags["build-context"];
+            if (flags["docker-command"] !== undefined)
+                patch.dockerCommand = flags["docker-command"];
+            if (flags["pre-deploy-command"] !== undefined)
+                patch.preDeployCommand = flags["pre-deploy-command"];
+            if (flags["auto-deploy"] !== undefined)
+                patch.autoDeploy = flags["auto-deploy"];
+            if (flags["health-check-path"] !== undefined)
+                patch.healthCheckPath = flags["health-check-path"];
+            if (flags["build-filter-included"] !== undefined)
+                patch.buildFilterIncluded = globs(flags["build-filter-included"]);
+            if (flags["build-filter-ignored"] !== undefined)
+                patch.buildFilterIgnored = globs(flags["build-filter-ignored"]);
+            if (flags.port !== undefined) {
+                // 0 is the CLI's "clear it" sentinel: the API takes `null` to mean
+                // "no override, detect the port", but a flag cannot carry null, and 0
+                // is not a port anything can listen on so it is free to repurpose.
+                // Every other out-of-range value is left to the API's own 422 rather
+                // than duplicating the bounds here.
+                patch.port = flags.port === 0 ? null : flags.port;
+            }
+            if (Object.keys(patch).length === 0) {
+                this.error("Nothing to change — pass at least one setting flag (see --help).", { exit: 1 });
+            }
+            const app = await this.resolveLinkedApp(flags, args.target);
+            const s = await withSpinner("Saving settings", () => this.clients.api.apps.patchSettings(app.id, patch));
+            this.emit(s, () => {
+                this.log(ok(`Updated ${Object.keys(patch).length} setting(s) on ${app.slug}.`));
+                this.log(dim("Run `synteq app settings show` to see the full config."));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=set.js.map

package/dist/commands/app/settings/set.js.map

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

package/dist/commands/app/settings/show.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from "../../../base/command.js";
+/** `synteq app settings show` — build/deploy settings for an app. */
+export default class SettingsShow 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: {
+        app: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/app/settings/show.js

@@ -0,0 +1,48 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand, appTargetArg } from "../../../base/command.js";
+import { withSpinner } from "../../../ui/spinner.js";
+import { panel } from "../../../ui/wizard.js";
+import { dim } from "../../../ui/glyphs.js";
+/** `synteq app settings show` — build/deploy settings for an app. */
+export default class SettingsShow extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "Show an app's build and deploy settings (root dir, Dockerfile path, commands, auto-deploy, health check).";
+    static examples = [
+        "<%= config.bin %> app settings show                # bare: linked app",
+        "<%= config.bin %> app settings show --app my-api -o json",
+    ];
+    static args = { ...appTargetArg };
+    static flags = {
+        app: Flags.string({ description: "App slug (or uuid) (default: the directory's linked app)." }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(SettingsShow);
+        try {
+            const app = await this.resolveLinkedApp(flags, args.target);
+            const s = await withSpinner("Loading settings", () => this.clients.api.apps.settings(app.id));
+            this.emit(s, () => {
+                this.log(panel(`${app.slug} settings`, [
+                    ["Root directory", s.rootDirectory ?? dim("(repo root)")],
+                    ["Dockerfile path", s.dockerfilePath ?? dim("(auto)")],
+                    ["Build context", s.buildContext ?? dim("(auto)")],
+                    ["Docker command", s.dockerCommand ?? dim("(image default)")],
+                    ["Pre-deploy command", s.preDeployCommand ?? dim("(none)")],
+                    ["Auto-deploy", s.autoDeploy],
+                    ["Health check path", s.healthCheckPath ?? dim("(none)")],
+                    // An unset port is not "(none)" — the app IS being probed on
+                    // something, so show what, and say it was not chosen by hand.
+                    ["Port", s.port != null ? String(s.port) : dim(`${s.effectivePort} (detected)`)],
+                ]));
+                if (s.buildFilterIncluded?.length)
+                    this.log(dim(`\nBuild filter — included: ${s.buildFilterIncluded.join(", ")}`));
+                if (s.buildFilterIgnored?.length)
+                    this.log(dim(`Build filter — ignored: ${s.buildFilterIgnored.join(", ")}`));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=show.js.map

package/dist/commands/app/settings/show.js.map

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

package/dist/commands/app/unlink.d.ts

@@ -0,0 +1,8 @@
+import { BaseCommand } from "../../base/command.js";
+/** `synteq app unlink` — forget this directory's `synteq link`. */
+export default class AppUnlink extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/app/unlink.js

@@ -0,0 +1,25 @@
+import { BaseCommand } from "../../base/command.js";
+import { ok } from "../../ui/glyphs.js";
+/** `synteq app unlink` — forget this directory's `synteq link`. */
+export default class AppUnlink extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "Unlink the current directory from its app (forgets the saved `synteq link`).";
+    static examples = [
+        "<%= config.bin %> app unlink",
+        "<%= config.bin %> app unlink -o json",
+    ];
+    async run() {
+        await this.initClients();
+        try {
+            const cwd = process.cwd();
+            const removed = this.clients.config.removeLink(cwd);
+            this.emit({ directory: cwd, removed }, () => {
+                this.log(removed ? ok(`Unlinked ${cwd}.`) : `No link stored for ${cwd}.`);
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=unlink.js.map

package/dist/commands/app/unlink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unlink.js","sourceRoot":"","sources":["../../../src/commands/app/unlink.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AAExC,mEAAmE;AACnE,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,WAAW;IAChD,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,WAAW,GAAG,8EAA8E,CAAC;IACpG,MAAM,CAAC,QAAQ,GAAG;QAChB,8BAA8B;QAC9B,sCAAsC;KACvC,CAAC;IACF,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACpD,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE;gBAC1C,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,sBAAsB,GAAG,GAAG,CAAC,CAAC;YAC5E,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/apps/create.d.ts

@@ -0,0 +1,26 @@
+import { BaseCommand } from "../../base/command.js";
+/**
+ * `synteq apps create` — create a managed-container app in the active project.
+ *
+ * Goes through the SAME `createApp` seam `synteq deploy --create` and the link
+ * walkthrough use: a free tier is a bare `POST /apps` behind the saved-card
+ * gate; a paid tier is an ORDER (first-month quote → card → confirm → charge →
+ * the app is provisioned off the settled order). Calling `POST /apps` directly
+ * for a paid tier only ever earned the backend's 402 ("Paid plans are created
+ * through an order"), which is what this command did until 2026-09-25.
+ */
+export default class AppsCreate extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static flags: {
+        slug: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        plan: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        region: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "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/apps/create.js

@@ -0,0 +1,91 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand } from "../../base/command.js";
+import { statusColor } from "../../ui/glyphs.js";
+import { isInteractive, panel } from "../../ui/wizard.js";
+import { PaymentMethodRequired } from "../../ui/payment-gate.js";
+import { createApp, resolveAppRegion } from "../link.js";
+/**
+ * `synteq apps create` — create a managed-container app in the active project.
+ *
+ * Goes through the SAME `createApp` seam `synteq deploy --create` and the link
+ * walkthrough use: a free tier is a bare `POST /apps` behind the saved-card
+ * gate; a paid tier is an ORDER (first-month quote → card → confirm → charge →
+ * the app is provisioned off the settled order). Calling `POST /apps` directly
+ * for a paid tier only ever earned the backend's 402 ("Paid plans are created
+ * through an order"), which is what this command did until 2026-09-25.
+ */
+export default class AppsCreate extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "Create a managed-container app in the active project.";
+    static examples = [
+        "<%= config.bin %> apps create --slug my-api",
+        "<%= config.bin %> apps create --slug my-api --plan hobby --region dfw-primary --yes",
+        "<%= config.bin %> apps create --slug my-api -o json   # scriptable: prints the App row",
+    ];
+    static flags = {
+        slug: Flags.string({
+            required: true,
+            description: "App name/slug — unique within the project (1..63 chars).",
+        }),
+        plan: Flags.string({
+            description: "Plan tier slug, e.g. free or starter (default: free, same as `deploy --create`). A paid tier charges the first month now.",
+        }),
+        region: Flags.string({
+            description: "Region to deploy in (default: the only placeable location, else asks).",
+        }),
+        project: Flags.string({
+            description: "Project id to create in (defaults to the active project).",
+        }),
+        "payment-method": Flags.string({
+            description: "For a paid --plan: saved payment method id to charge (default: the team's default, or asks).",
+        }),
+        "apply-credits": Flags.boolean({
+            description: "For a paid --plan: apply the team's credit balance to the first month first.",
+            default: false,
+        }),
+        yes: Flags.boolean({
+            char: "y",
+            description: "Confirm the first-month charge of a paid --plan without asking (scripts must pass this).",
+            default: false,
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { flags } = await this.parse(AppsCreate);
+        const interactive = isInteractive() && this.outputFormat === "table";
+        try {
+            const region = await resolveAppRegion(this.clients, flags.region, async (locations) => {
+                if (!interactive) {
+                    throw new Error(`Several locations can place this app — pass --region (${locations.map((l) => l.code).join(", ")}).`);
+                }
+                const { pickFromCatalog } = await import("../../ui/wizard.js");
+                return pickFromCatalog("Location", locations.map((l) => ({ value: l.region, name: l.city, description: l.code })));
+            });
+            const app = await createApp(this.clients, { slug: flags.slug, planTier: flags.plan ?? "free", region, projectId: flags.project }, {
+                interactive,
+                log: (line) => this.info(line),
+                paymentMethodId: flags["payment-method"],
+                applyCredits: flags["apply-credits"],
+                yes: flags.yes,
+            });
+            this.emit(app, () => {
+                this.log(panel("App created", [
+                    ["Slug", app.slug],
+                    ["ID", app.id],
+                    ["Status", statusColor(app.status)],
+                    ["Plan", app.planTier],
+                    ["Region", app.region],
+                    ["Hostname", app.hostname],
+                ]));
+                this.log("");
+                this.log(`Deploy it: synteq deploy --app ${app.slug}   (from the app's directory, or --image <ref>)`);
+            });
+        }
+        catch (err) {
+            if (err instanceof PaymentMethodRequired)
+                this.error(err.message, { exit: 1 });
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=create.js.map

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

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

package/dist/commands/apps/list.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from "../../base/command.js";
+/**
+ * `synteq apps list` — managed-container apps in the active project.
+ *
+ * Backend: GET /apps. Scoping matches `vps list` — the server resolves the
+ * active project from the `X-Project-Id` header, so `--project` overrides it.
+ */
+export default class AppsList extends BaseCommand {
+    static apiKeyScope: string;
+    static description: string;
+    static examples: string[];
+    static flags: {
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/apps/list.js

@@ -0,0 +1,54 @@
+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 apps list` — managed-container apps in the active project.
+ *
+ * Backend: GET /apps. Scoping matches `vps list` — the server resolves the
+ * active project from the `X-Project-Id` header, so `--project` overrides it.
+ */
+export default class AppsList extends BaseCommand {
+    static apiKeyScope = "none";
+    static description = "List managed-container apps in the active project.";
+    static examples = [
+        "<%= config.bin %> apps list",
+        "<%= config.bin %> apps list --project 019e...   # scope to a specific project",
+        "<%= config.bin %> apps 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(AppsList);
+        try {
+            const page = await this.clients.api.apps.listPage(flags.project);
+            const apps = page.items;
+            const note = truncationNote(apps.length, page.total, "--project");
+            this.emit(apps, () => {
+                if (apps.length === 0) {
+                    this.log("No apps. Create one with `synteq apps create --slug <name>`.");
+                    return;
+                }
+                this.log(renderTable(["ID", "SLUG", "STATUS", "PLAN", "REGION", "REL", "HOSTNAME"], apps.map((a) => [
+                    shortId(a.id),
+                    a.slug,
+                    statusColor(a.status),
+                    a.planTier,
+                    a.region,
+                    String(a.activeRelease),
+                    a.hostname,
+                ])));
+            });
+            if (note)
+                this.info(note);
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=list.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/apps/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,QAAS,SAAQ,WAAW;IAC/C,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,WAAW,GAAG,oDAAoD,CAAC;IAC1E,MAAM,CAAC,QAAQ,GAAG;QAChB,6BAA6B;QAC7B,+EAA+E;QAC/E,qCAAqC;KACtC,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,QAAQ,CAAC,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACjE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;YACxB,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;YAClE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE;gBACnB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACtB,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,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,EAC7D,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;oBACd,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;oBACb,CAAC,CAAC,IAAI;oBACN,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC;oBACrB,CAAC,CAAC,QAAQ;oBACV,CAAC,CAAC,MAAM;oBACR,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC;oBACvB,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/baremetal/activity.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from "../../base/command.js";
+export default class BaremetalActivity extends BaseCommand {
+    static description: string;
+    static apiKeyScope: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        offset: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}