@synteq/cli 0.1.0

package/dist/commands/vps/activity.js

@@ -0,0 +1,50 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../base/command.js";
+import { resolveVpsId } from "../../ui/vps-resolve.js";
+import { renderTable } from "../../ui/table.js";
+import { dim } from "../../ui/glyphs.js";
+export default class VpsActivity extends BaseCommand {
+    static description = "Show recent activity for a VPS.";
+    static examples = [
+        "<%= config.bin %> vps activity 019e...",
+        "<%= config.bin %> vps activity 019e... --limit 50",
+        "<%= config.bin %> vps activity 019e... --limit 25 --offset 25",
+        "<%= config.bin %> vps activity 019e... -o json",
+    ];
+    static args = {
+        id: Args.string({
+            description: "VPS id (full or the short id from `vps list`), hostname, or IP.",
+            required: true,
+        }),
+    };
+    static flags = {
+        limit: Flags.integer({ default: 25, description: "Max rows (1..100)." }),
+        offset: Flags.integer({ default: 0, description: "Pagination offset." }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(this.ctor);
+        try {
+            const vpsId = await resolveVpsId(this.clients.api, args.id);
+            const log = await this.clients.api.vpsControl.activity(vpsId, flags.limit, flags.offset);
+            this.emit(log, () => {
+                if (log.items.length === 0) {
+                    this.log("No activity entries.");
+                    return;
+                }
+                this.log(renderTable(["WHEN", "ACTOR", "ACTION", "DETAIL"], log.items.map((e) => [
+                    e.created_at.slice(0, 19).replace("T", " "),
+                    e.actor?.email ?? "system",
+                    e.action,
+                    e.detail ?? "",
+                ])));
+                this.log("");
+                this.log(dim(`Showing ${log.items.length} of ${log.total} entries.`));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=activity.js.map

package/dist/commands/vps/activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../../src/commands/vps/activity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAEzC,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;IAClD,MAAM,CAAC,WAAW,GAAG,iCAAiC,CAAC;IACvD,MAAM,CAAC,QAAQ,GAAG;QAChB,wCAAwC;QACxC,mDAAmD;QACnD,+DAA+D;QAC/D,gDAAgD;KACjD,CAAC;IACF,MAAM,CAAC,IAAI,GAAG;QACZ,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC;YACd,WAAW,EAAE,iEAAiE;YAC9E,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAC;IACF,MAAM,CAAC,KAAK,GAAG;QACb,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC;QACxE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC;KACzE,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAA0B,CAAC,CAAC;QAC1E,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YAC5D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CACpD,KAAK,EACL,KAAK,CAAC,KAAK,EACX,KAAK,CAAC,MAAM,CACb,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE;gBAClB,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC3B,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;oBACjC,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC,GAAG,CACN,WAAW,CACT,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,EACrC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;oBACnB,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC;oBAC3C,CAAC,CAAC,KAAK,EAAE,KAAK,IAAI,QAAQ;oBAC1B,CAAC,CAAC,MAAM;oBACR,CAAC,CAAC,MAAM,IAAI,EAAE;iBACf,CAAC,CACH,CACF,CAAC;gBACF,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACb,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,KAAK,CAAC,MAAM,OAAO,GAAG,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC;YACxE,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/vps/bandwidth.d.ts

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

package/dist/commands/vps/bandwidth.js

@@ -0,0 +1,91 @@
+import { Args } from "@oclif/core";
+import { BaseCommand } from "../../base/command.js";
+import { resolveVpsId } from "../../ui/vps-resolve.js";
+import { panel } from "../../ui/wizard.js";
+import { renderTable } from "../../ui/table.js";
+import { statusColor } from "../../ui/glyphs.js";
+export default class VpsBandwidth extends BaseCommand {
+    static description = [
+        "Show a VPS's bandwidth usage: current month-to-date, plan allowance, and overage.",
+        "",
+        "Read-only. Includes up to 12 months of history. `-o json` returns",
+        "the full summary (current period + history + rates).",
+    ].join("\n");
+    static examples = [
+        "<%= config.bin %> vps bandwidth 019e...",
+        "<%= config.bin %> vps bandwidth 019e... -o json    # full summary for scripting",
+    ];
+    static args = {
+        id: Args.string({
+            description: "VPS id (full or the short id from `vps list`), hostname, or IP.",
+            required: true,
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { args } = await this.parse(this.ctor);
+        try {
+            const vpsId = await resolveVpsId(this.clients.api, args.id);
+            const summary = await this.clients.api.vps.bandwidth(vpsId);
+            this.emit(summary, () => {
+                const includedTb = summary.included_tb != null ? `${summary.included_tb} TB` : "unmetered";
+                const overage = summary.overage_per_tb != null
+                    ? `$${summary.overage_per_tb.toFixed(2)}/TB`
+                    : "—";
+                const cur = summary.current;
+                const usedTb = cur ? cur.used_tb : 0;
+                const overTb = summary.included_tb != null ? Math.max(0, usedTb - summary.included_tb) : 0;
+                const overageCost = summary.overage_per_tb != null && overTb > 0
+                    ? `$${(overTb * summary.overage_per_tb).toFixed(2)}`
+                    : null;
+                this.log(panel(`Bandwidth — VPS ${vpsId}`, [
+                    ["Period", cur ? `${cur.period_start.slice(0, 10)} → ${cur.period_end.slice(0, 10)}` : "no open period"],
+                    ["Used", `${usedTb.toFixed(4)} TB`],
+                    ["Included", includedTb],
+                    ["Overage rate", overage],
+                    [
+                        "Est. overage",
+                        summary.included_tb != null
+                            ? overTb > 0
+                                ? `${overTb.toFixed(4)} TB${overageCost ? ` (${overageCost})` : ""}`
+                                : "none"
+                            : "",
+                    ],
+                    [
+                        "Last polled",
+                        cur?.last_polled_at ? cur.last_polled_at.slice(0, 19).replace("T", " ") : "",
+                    ],
+                    [
+                        "Overage invoiced",
+                        cur?.overage_invoiced_at
+                            ? statusColor("invoiced")
+                            : cur
+                                ? "not yet"
+                                : "",
+                    ],
+                ]));
+                if (summary.history.length > 0) {
+                    this.log("");
+                    this.log("History:");
+                    this.log(renderTable(["PERIOD", "USED (TB)", "IN", "OUT", "OVERAGE"], summary.history.map((p) => [
+                        p.period_start.slice(0, 7),
+                        p.used_tb.toFixed(4),
+                        fmtGB(p.bytes_in),
+                        fmtGB(p.bytes_out),
+                        p.overage_invoiced_at ? "invoiced" : "",
+                    ])));
+                }
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+function fmtGB(bytes) {
+    const gb = bytes / 1e9;
+    if (gb >= 1000)
+        return `${(gb / 1000).toFixed(2)} TB`;
+    return `${gb.toFixed(2)} GB`;
+}
+//# sourceMappingURL=bandwidth.js.map

package/dist/commands/vps/bandwidth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bandwidth.js","sourceRoot":"","sources":["../../../src/commands/vps/bandwidth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,WAAW;IACnD,MAAM,CAAC,WAAW,GAAG;QACnB,mFAAmF;QACnF,EAAE;QACF,mEAAmE;QACnE,sDAAsD;KACvD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,MAAM,CAAC,QAAQ,GAAG;QAChB,yCAAyC;QACzC,iFAAiF;KAClF,CAAC;IACF,MAAM,CAAC,IAAI,GAAG;QACZ,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC;YACd,WAAW,EAAE,iEAAiE;YAC9E,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAA2B,CAAC,CAAC;QACpE,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YAC5D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAE5D,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;gBACtB,MAAM,UAAU,GACd,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC;gBAC1E,MAAM,OAAO,GACX,OAAO,CAAC,cAAc,IAAI,IAAI;oBAC5B,CAAC,CAAC,IAAI,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;oBAC5C,CAAC,CAAC,GAAG,CAAC;gBAEV,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;gBAC5B,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrC,MAAM,MAAM,GACV,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC9E,MAAM,WAAW,GACf,OAAO,CAAC,cAAc,IAAI,IAAI,IAAI,MAAM,GAAG,CAAC;oBAC1C,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;oBACpD,CAAC,CAAC,IAAI,CAAC;gBAEX,IAAI,CAAC,GAAG,CACN,KAAK,CAAC,mBAAmB,KAAK,EAAE,EAAE;oBAChC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC;oBACxG,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;oBACnC,CAAC,UAAU,EAAE,UAAU,CAAC;oBACxB,CAAC,cAAc,EAAE,OAAO,CAAC;oBACzB;wBACE,cAAc;wBACd,OAAO,CAAC,WAAW,IAAI,IAAI;4BACzB,CAAC,CAAC,MAAM,GAAG,CAAC;gCACV,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,CAAC,CAAC,KAAK,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gCACpE,CAAC,CAAC,MAAM;4BACV,CAAC,CAAC,EAAE;qBACP;oBACD;wBACE,aAAa;wBACb,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;qBAC7E;oBACD;wBACE,kBAAkB;wBAClB,GAAG,EAAE,mBAAmB;4BACtB,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC;4BACzB,CAAC,CAAC,GAAG;gCACH,CAAC,CAAC,SAAS;gCACX,CAAC,CAAC,EAAE;qBACT;iBACF,CAAC,CACH,CAAC;gBAEF,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC/B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBACb,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;oBACrB,IAAI,CAAC,GAAG,CACN,WAAW,CACT,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,EAC/C,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;wBACzB,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;wBAC1B,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;wBACpB,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;wBACjB,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;wBAClB,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE;qBACxC,CAAC,CACH,CACF,CAAC;gBACJ,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;;AAGH,SAAS,KAAK,CAAC,KAAa;IAC1B,MAAM,EAAE,GAAG,KAAK,GAAG,GAAG,CAAC;IACvB,IAAI,EAAE,IAAI,IAAI;QAAE,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IACtD,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AAC/B,CAAC"}

package/dist/commands/vps/boot-order.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from "../../base/command.js";
+export default class VpsBootOrder extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        order: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/vps/boot-order.js

@@ -0,0 +1,51 @@
+import { Args } from "@oclif/core";
+import { BaseCommand } from "../../base/command.js";
+import { resolveVpsId } from "../../ui/vps-resolve.js";
+import { panel } from "../../ui/wizard.js";
+const VALID = new Set(["disk_first", "cdrom_first"]);
+export default class VpsBootOrder extends BaseCommand {
+    static description = "View or set a VPS's boot order.";
+    static examples = [
+        "<%= config.bin %> vps boot-order 019e...                               # read current",
+        "<%= config.bin %> vps boot-order 019e... disk_first",
+        "<%= config.bin %> vps boot-order 019e... cdrom_first",
+    ];
+    static args = {
+        id: Args.string({
+            description: "VPS id (full or the short id from `vps list`), hostname, or IP.",
+            required: true,
+        }),
+        order: Args.string({
+            description: "New boot order: disk_first | cdrom_first (omit to read current).",
+            required: false,
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { args } = await this.parse(this.ctor);
+        try {
+            const vpsId = await resolveVpsId(this.clients.api, args.id);
+            let result;
+            if (args.order) {
+                if (!VALID.has(args.order)) {
+                    this.error(`Invalid boot order "${args.order}". Use disk_first or cdrom_first.`, { exit: 1 });
+                }
+                result = await this.clients.api.vpsControl.bootSet(vpsId, args.order);
+            }
+            else {
+                result = await this.clients.api.vpsControl.bootGet(vpsId);
+            }
+            this.emit(result, () => {
+                this.log(panel("Boot order", [
+                    ["Boot order", result.boot_order],
+                    ["Requires reboot", result.requires_reboot ? "yes" : "no"],
+                    ["Pending keys", result.pending_keys?.join(", ")],
+                ]));
+            });
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+}
+//# sourceMappingURL=boot-order.js.map

package/dist/commands/vps/boot-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot-order.js","sourceRoot":"","sources":["../../../src/commands/vps/boot-order.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC;AAErD,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,WAAW;IACnD,MAAM,CAAC,WAAW,GAAG,iCAAiC,CAAC;IACvD,MAAM,CAAC,QAAQ,GAAG;QAChB,uFAAuF;QACvF,qDAAqD;QACrD,sDAAsD;KACvD,CAAC;IACF,MAAM,CAAC,IAAI,GAAG;QACZ,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC;YACd,WAAW,EAAE,iEAAiE;YAC9E,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC;YACjB,WAAW,EAAE,kEAAkE;YAC/E,QAAQ,EAAE,KAAK;SAChB,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAA2B,CAAC,CAAC;QAEpE,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YAC5D,IAAI,MAAM,CAAC;YACX,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC3B,IAAI,CAAC,KAAK,CACR,uBAAuB,IAAI,CAAC,KAAK,mCAAmC,EACpE,EAAE,IAAI,EAAE,CAAC,EAAE,CACZ,CAAC;gBACJ,CAAC;gBACD,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAChD,KAAK,EACL,IAAI,CAAC,KAAqC,CAC3C,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5D,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;gBACrB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE;oBAC3B,CAAC,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC;oBACjC,CAAC,iBAAiB,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;oBAC1D,CAAC,cAAc,EAAE,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;iBAClD,CAAC,CAAC,CAAC;YACN,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/vps/console.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from "../../base/command.js";
+export default class VpsConsole extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        "print-url": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private attachSerial;
+    private wsUrl;
+    private resolveInsecure;
+}

package/dist/commands/vps/console.js

@@ -0,0 +1,198 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../base/command.js";
+import { panel } from "../../ui/wizard.js";
+import { portalUrl } from "../../ui/portal.js";
+import { resolveVpsId } from "../../ui/vps-resolve.js";
+import { ok, dim } from "../../ui/glyphs.js";
+export default class VpsConsole extends BaseCommand {
+    static description = [
+        "Open a VPS console (interactive serial, or a browser URL for graphical).",
+        "",
+        "On a serial-console VM at an interactive terminal, attaches a live",
+        "serial console over WebSocket (Ctrl-] to disconnect). For graphical",
+        "(VNC) consoles, with --print-url, or when stdout is piped, prints the",
+        "portal console URL to open in a browser instead of attaching.",
+        "Reuses your signed-in session — no separate login.",
+    ].join("\n");
+    static examples = [
+        "<%= config.bin %> vps console 019e...                                 # attach serial (TTY) or print URL",
+        "<%= config.bin %> vps console 019e... --print-url                     # always print the browser URL",
+        "<%= config.bin %> vps console 019e... --print-url -o json             # {url, token, console_type} for scripting",
+    ];
+    static args = {
+        id: Args.string({
+            description: "VPS id (full or the short id from `vps list`), hostname, or IP.",
+            required: true,
+        }),
+    };
+    static flags = {
+        "print-url": Flags.boolean({
+            description: "Print the portal console URL + token instead of attaching a serial session. Implied when stdout is not a TTY or the console is graphical (VNC).",
+        }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(this.ctor);
+        const insecure = await this.resolveInsecure();
+        try {
+            const vpsId = await resolveVpsId(this.clients.api, args.id);
+            const vend = await this.clients.api.vpsControl.console(vpsId);
+            if (vend.preview) {
+                this.emit({ preview: true, console_type: vend.console_type }, () => {
+                    this.log("This is a dev seed-node VM — no console is available for it.");
+                });
+                return;
+            }
+            const apiBase = this.clients.config.get().api_base_url;
+            const browserUrl = portalUrl(apiBase, `/console/vps/${vpsId}`);
+            const wantAttach = vend.console_type === "serial" &&
+                !flags["print-url"] &&
+                Boolean(process.stdin.isTTY) &&
+                Boolean(process.stdout.isTTY) &&
+                this.outputFormat === "table";
+            if (!wantAttach) {
+                this.emit({ url: browserUrl, token: vend.token, console_type: vend.console_type }, () => {
+                    this.log(panel("Open this VPS console in a browser", [
+                        ["Type", vend.console_type === "vnc" ? "graphical (VNC)" : "serial"],
+                        ["URL", browserUrl],
+                    ]));
+                    if (vend.console_type === "vnc") {
+                        this.log(dim("Graphical consoles run through a browser (noVNC) — the CLI can't attach a terminal to them."));
+                    }
+                    else {
+                        this.log(dim("Re-run on an interactive terminal (without --print-url) to attach a serial console here."));
+                    }
+                });
+                return;
+            }
+            await this.attachSerial(vpsId, vend.token, apiBase, insecure);
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+    async attachSerial(vpsId, token, apiBase, insecure) {
+        const wsUrl = this.wsUrl(apiBase, `/vps/${vpsId}/term-ws`, token);
+        const prevReject = process.env.NODE_TLS_REJECT_UNAUTHORIZED;
+        if (insecure)
+            process.env.NODE_TLS_REJECT_UNAUTHORIZED = "0";
+        const WS = globalThis.WebSocket;
+        if (!WS) {
+            if (insecure)
+                restoreEnv("NODE_TLS_REJECT_UNAUTHORIZED", prevReject);
+            this.error("This Node build has no global WebSocket. Upgrade to Node 22+ or re-run with --print-url.", { exit: 1 });
+        }
+        const ws = new WS(wsUrl);
+        ws.binaryType = "arraybuffer";
+        if (insecure) {
+            restoreEnv("NODE_TLS_REJECT_UNAUTHORIZED", prevReject);
+        }
+        const stdin = process.stdin;
+        const stdout = process.stdout;
+        let connected = false;
+        let cleanedUp = false;
+        const wasRaw = Boolean(stdin.isRaw);
+        process.stderr.write(dim("Connecting to serial console… (Ctrl-] to disconnect)\n"));
+        const cleanup = () => {
+            if (cleanedUp)
+                return;
+            cleanedUp = true;
+            clearInterval(pingTimer);
+            stdin.removeListener("data", onStdin);
+            stdin.setRawMode?.(wasRaw);
+            stdin.pause();
+            stdout.removeListener("resize", onResize);
+            try {
+                ws.close();
+            }
+            catch { }
+        };
+        const sendResize = () => {
+            if (ws.readyState === WS.OPEN && connected) {
+                const cols = stdout.columns ?? 80;
+                const rows = stdout.rows ?? 24;
+                ws.send(`1:${cols}:${rows}:`);
+            }
+        };
+        const onStdin = (chunk) => {
+            if (chunk.includes(0x1d)) {
+                process.stderr.write("\n" + dim("Disconnected.") + "\n");
+                cleanup();
+                return;
+            }
+            if (ws.readyState === WS.OPEN && connected) {
+                const data = chunk.toString("binary");
+                ws.send(`0:${data.length}:${data}`);
+            }
+        };
+        const onResize = () => sendResize();
+        const pingTimer = setInterval(() => {
+            if (ws.readyState === WS.OPEN && connected)
+                ws.send("2");
+        }, 30_000);
+        await new Promise((resolve) => {
+            ws.onopen = () => {
+                stdin.setRawMode?.(true);
+                stdin.resume();
+                stdin.on("data", onStdin);
+                stdout.on("resize", onResize);
+            };
+            ws.onmessage = (ev) => {
+                const raw = ev.data;
+                if (!connected) {
+                    const bytes = raw instanceof ArrayBuffer
+                        ? new Uint8Array(raw)
+                        : typeof raw === "string"
+                            ? new TextEncoder().encode(raw)
+                            : new Uint8Array(0);
+                    if (bytes.length >= 2 && bytes[0] === 79 && bytes[1] === 75) {
+                        connected = true;
+                        sendResize();
+                    }
+                    return;
+                }
+                if (raw instanceof ArrayBuffer) {
+                    stdout.write(Buffer.from(raw));
+                }
+                else if (typeof raw === "string") {
+                    stdout.write(raw);
+                }
+            };
+            ws.onerror = () => {
+                process.stderr.write("\n" +
+                    dim("Console connection error. The VM may be stopped, or the token expired — try again.") +
+                    "\n");
+                cleanup();
+                resolve();
+            };
+            ws.onclose = () => {
+                if (!cleanedUp) {
+                    process.stderr.write("\n" + dim("Console closed by server.") + "\n");
+                }
+                cleanup();
+                resolve();
+            };
+        });
+        this.log(ok("Serial console session ended."));
+    }
+    wsUrl(apiBase, path, token) {
+        const u = new URL(apiBase);
+        u.protocol = u.protocol === "https:" ? "wss:" : "ws:";
+        u.pathname = path;
+        u.search = "";
+        u.searchParams.set("token", token);
+        return u.toString();
+    }
+    async resolveInsecure() {
+        const { flags } = await this.parse(this.ctor);
+        const envInsecure = ["1", "true", "yes"].includes((process.env.SYNTEQ_INSECURE_TLS ?? "").toLowerCase());
+        return Boolean(flags.insecure || envInsecure);
+    }
+}
+function restoreEnv(key, prev) {
+    if (prev === undefined)
+        delete process.env[key];
+    else
+        process.env[key] = prev;
+}
+//# sourceMappingURL=console.js.map

package/dist/commands/vps/console.js.map

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

package/dist/commands/vps/details.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from "../../base/command.js";
+export default class VpsDetails extends BaseCommand {
+    static aliases: string[];
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        refresh: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private pickFrom;
+}

package/dist/commands/vps/details.js

@@ -0,0 +1,78 @@
+import { Args, Flags } from "@oclif/core";
+import select from "@inquirer/select";
+import { BaseCommand } from "../../base/command.js";
+import { formatVpsDetail, resolveVps } from "../../ui/vps-detail.js";
+import { shortId } from "../../ui/table.js";
+import { statusColor } from "../../ui/glyphs.js";
+export default class VpsDetails extends BaseCommand {
+    static aliases = ["vps:show"];
+    static description = "Show full details for one VPS. With no id, pick from a list.";
+    static examples = [
+        "<%= config.bin %> vps details                                          # pick from a list (TTY)",
+        "<%= config.bin %> vps details web-01                                   # by hostname",
+        "<%= config.bin %> vps details 019f155b                                 # by short id",
+        "<%= config.bin %> vps details 192.0.2.45 -o json                       # by IP, as JSON",
+    ];
+    static args = {
+        id: Args.string({
+            description: "VPS — short id, full UUID, hostname, or IP. Omit on a TTY to pick from a list.",
+        }),
+    };
+    static flags = {
+        project: Flags.string({ description: "Scope to a project id when searching." }),
+        refresh: Flags.boolean({ description: "Re-fetch the matched VPS via GET /vps/{id}." }),
+    };
+    async run() {
+        await this.initClients();
+        const { args, flags } = await this.parse(this.ctor);
+        const isTty = process.stdout.isTTY && process.stdin.isTTY;
+        try {
+            const all = await this.clients.api.vps.list(flags.project);
+            if (all.length === 0) {
+                this.error("No VPS resources on this team.", { exit: 1 });
+            }
+            let chosen;
+            if (!args.id) {
+                if (!isTty || this.outputFormat === "json") {
+                    this.error("Provide a VPS id / hostname / IP (a picker only runs on an interactive terminal).", { exit: 1 });
+                }
+                chosen = await this.pickFrom(all, "Pick a VPS");
+            }
+            else {
+                const matches = resolveVps(all, args.id);
+                if (matches.length === 0) {
+                    this.error(`No VPS matches "${args.id}". Run \`synteq vps list\`.`, { exit: 1 });
+                }
+                if (matches.length === 1) {
+                    chosen = matches[0];
+                }
+                else if (!isTty || this.outputFormat === "json") {
+                    this.error(`"${args.id}" matched ${matches.length} VPSes. Refine the query or use a full id.`, { exit: 1 });
+                }
+                else {
+                    chosen = await this.pickFrom(matches, `"${args.id}" matched ${matches.length} — pick one`);
+                }
+            }
+            if (flags.refresh) {
+                chosen = await this.clients.api.vps.get(chosen.id);
+            }
+            this.emit(chosen, () => this.log(formatVpsDetail(chosen)));
+        }
+        catch (err) {
+            this.fail(err);
+        }
+    }
+    async pickFrom(list, message) {
+        const id = await select({
+            message,
+            pageSize: Math.min(12, list.length),
+            choices: list.map((v) => ({
+                name: `${shortId(v.id)}  ${v.hostname.padEnd(24)} ${statusColor(v.status)}`,
+                value: v.id,
+                description: (v.ip_addresses?.map((ip) => ip.address).join(", ") ?? "") || undefined,
+            })),
+        });
+        return list.find((v) => v.id === id);
+    }
+}
+//# sourceMappingURL=details.js.map

package/dist/commands/vps/details.js.map

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

package/dist/commands/vps/ip/add.d.ts

@@ -0,0 +1,17 @@
+import { BaseCommand } from "../../../base/command.js";
+export default class VpsIpAdd extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        quantity: import("@oclif/core/interfaces").OptionFlag<number, 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>;
+        "billing-mode": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private resolveBillingMode;
+}