@batadata/cli 0.2.8 → 0.2.9

package/dist/commands/powdb.js

@@ -3,6 +3,7 @@ import * as path from "node:path";
 import { api, apiError } from "../api.js";
 import { requireToken, isJsonMode, loadConfig } from "../config.js";
 import { colors, log, json, spinner, heading, table } from "../utils/logger.js";
+import { confirmDestructive } from "../utils/prompts.js";
 import { emitError, isRetryable } from "../utils/errors.js";
 import { resolveProjectId, resolveBranchId } from "../link.js";
 // PowQL reserved words a column/table name must not collide with. Mirrors the
@@ -860,7 +861,57 @@ async function powdbLifecycle(action, args) {
         return;
     }
     log();
-    log(`  ${colors.green(">")} ${colors.cyan(projectId)} ${colors.dim("engine=powdb state=")}${res.data.state}`);
+    const ver = res.data.server_version;
+    log(`  ${colors.green(">")} ${colors.cyan(projectId)} ${colors.dim("engine=powdb state=")}${res.data.state}${ver ? colors.dim(" server=") + ver : ""}`);
+    log();
+}
+/**
+ * `bata powdb upgrade --to <version>` — pin the project's server to a new
+ * engine version. Server-side this is park→backup→flip→wake→verify with
+ * automatic rollback to the pre-upgrade backup on failure. Storage-format
+ * releases (0.11+) make a verified upgrade a ONE-WAY door once new-format
+ * data is written, so this always confirms unless --yes/--json.
+ */
+async function powdbUpgrade(args) {
+    const token = requireToken();
+    const jsonMode = isJsonMode();
+    let toVersion;
+    const rest = [];
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === "--to")
+            toVersion = args[++i];
+        else if (a.startsWith("--to="))
+            toVersion = a.slice("--to=".length);
+        else
+            rest.push(a);
+    }
+    const positional = rest.find((a) => !a.startsWith("-"));
+    const projectId = powdbProjectFlag(rest) ?? positional ?? resolvePowdbProject(rest);
+    if (!toVersion || !/^\d+\.\d+\.\d+$/.test(toVersion)) {
+        emitError("MISSING_ARG", "A target version is required.", "Usage: bata powdb upgrade --to <x.y.z> [--project <id>]");
+    }
+    const ok = await confirmDestructive(`Upgrade ${colors.cyan(projectId)} to powdb-server ${colors.cyan(toVersion)}? A format-changing release cannot be downgraded once new data is written.`);
+    if (!ok) {
+        log("  Aborted.");
+        return;
+    }
+    const s = jsonMode ? null : spinner(`Upgrading ${projectId} to ${toVersion} (park -> backup -> flip -> wake -> verify)`);
+    const res = await api.post(`/v1/powdb/${encodeURIComponent(projectId)}/upgrade`, { to_version: toVersion }, token);
+    s?.stop();
+    if (!res.ok) {
+        emitError(res.status === 404 ? "NOT_FOUND"
+            : res.status === 401 || res.status === 403 ? "INVALID_KEY"
+                : res.status >= 500 || res.status === 0 ? "API_UNAVAILABLE"
+                    : "CLI_ERROR", apiError(res, "PowDB upgrade failed (instance rolled back to its pre-upgrade state)"), "");
+        return;
+    }
+    if (jsonMode) {
+        json({ project_id: projectId, ...res.data });
+        return;
+    }
+    log();
+    log(`  ${colors.green(">")} ${colors.cyan(projectId)} upgraded to powdb-server ${colors.cyan(res.data.server_version)} ${colors.dim("(verified)")}`);
     log();
 }
 // ─── Help + dispatch ──────────────────────────────────────────────────────────
@@ -883,6 +934,8 @@ function powdbHelp() {
     log(`    ${colors.cyan("status")}  Show the server state (running | parked)  [--project <id>]`);
     log(`    ${colors.cyan("park")}    Scale the server to zero (WAL is durable)  [--project <id>]`);
     log(`    ${colors.cyan("wake")}    Start a parked server (~tens of ms)  [--project <id>]`);
+    log(`    ${colors.cyan("upgrade")} Pin the server to a new engine version  --to <x.y.z> [--project <id>]`);
+    log(`    ${colors.dim("            park -> backup -> flip -> wake -> verify, auto-rollback on failure")}`);
     log();
     log(`  ${colors.dim("Options (pull):")}`);
     log(`    ${colors.dim("--project <id>       override the linked/default project")}`);
@@ -918,10 +971,12 @@ export async function handlePowdb(args) {
             return powdbLifecycle("park", args.slice(1));
         case "wake":
             return powdbLifecycle("wake", args.slice(1));
+        case "upgrade":
+            return powdbUpgrade(args.slice(1));
         case undefined:
             powdbHelp();
             return;
         default:
-            emitError("INVALID_FLAG", `Unknown subcommand: powdb ${sub}`, "Available: pull, query, exec, status, park, wake. Run `bata powdb --help`.");
+            emitError("INVALID_FLAG", `Unknown subcommand: powdb ${sub}`, "Available: pull, query, exec, status, park, wake, upgrade. Run `bata powdb --help`.");
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@batadata/cli",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "description": "CLI for BataDB — serverless Postgres platform",
   "bin": {
     "bata": "./dist/index.js"