@batadata/cli 0.1.14 → 0.1.16

package/dist/commands/claim.d.ts

@@ -0,0 +1,17 @@
+/**
+ * bata claim <token> — redeem a legacy claim token into your team.
+ *
+ * LEGACY: the anonymous, no-signup flow that issued claim tokens is gone —
+ * `bata new` now creates a database directly in your team. This command remains
+ * only to redeem a token from that retired flow. Authed. Resolves the team
+ * (like `bata create`), calls POST /v1/claim/redeem { claim_token, team_id },
+ * and on success the project becomes a permanent member of your team (its TTL
+ * is cleared). Typed errors for unknown / expired / already-claimed tokens.
+ */
+export interface ClaimArgs {
+    token?: string;
+    help: boolean;
+}
+/** Parse `bata claim <token>` args. Exported for tests. */
+export declare function parseClaimArgs(args: string[]): ClaimArgs;
+export declare function claim(args: string[]): Promise<void>;

package/dist/commands/claim.js

@@ -0,0 +1,84 @@
+/**
+ * bata claim <token> — redeem a legacy claim token into your team.
+ *
+ * LEGACY: the anonymous, no-signup flow that issued claim tokens is gone —
+ * `bata new` now creates a database directly in your team. This command remains
+ * only to redeem a token from that retired flow. Authed. Resolves the team
+ * (like `bata create`), calls POST /v1/claim/redeem { claim_token, team_id },
+ * and on success the project becomes a permanent member of your team (its TTL
+ * is cleared). Typed errors for unknown / expired / already-claimed tokens.
+ */
+import { api, apiError, resolveTeamId } from "../api.js";
+import { requireToken, saveConfig, isJsonMode } from "../config.js";
+import { colors, log, json, success, kvList } from "../utils/logger.js";
+import { emitError } from "../utils/errors.js";
+/** Parse `bata claim <token>` args. Exported for tests. */
+export function parseClaimArgs(args) {
+    let token;
+    for (const arg of args) {
+        if (arg === "--help" || arg === "-h")
+            return { help: true };
+        if (!arg.startsWith("-") && !token)
+            token = arg;
+    }
+    return { token, help: false };
+}
+function printHelp() {
+    log();
+    log(`  ${colors.bold("bata claim")} ${colors.dim("<token>")}`);
+    log();
+    log(`  ${colors.yellow("Legacy:")} redeem a claim token from the retired anonymous flow.`);
+    log(`  ${colors.cyan("bata new")} now creates a database directly in your team — no token to claim.`);
+    log(`  Requires login — pass ${colors.cyan("--api-key")}, set ${colors.cyan("BATA_API_KEY")}, or run ${colors.cyan("bata login")}.`);
+    log();
+    log(`  ${colors.bold("Examples")}`);
+    log(`    ${colors.cyan("bata claim claim_EXAMPLE_TOKEN")}`);
+    log(`    ${colors.cyan("bata claim claim_EXAMPLE_TOKEN --json")}`);
+    log();
+}
+export async function claim(args) {
+    const parsed = parseClaimArgs(args);
+    if (parsed.help) {
+        printHelp();
+        return;
+    }
+    if (!parsed.token) {
+        emitError("MISSING_ARG", "A claim token is required. Usage: bata claim <token>", "Get one from `bata new`.");
+    }
+    const token = requireToken();
+    const teamId = await resolveTeamId(token);
+    if (!teamId) {
+        emitError("NO_TEAM", "No team found for this credential.", "Run `bata login` or check your API key.");
+    }
+    const res = await api.post("/v1/claim/redeem", { claim_token: parsed.token, team_id: teamId }, token);
+    if (!res.ok) {
+        const data = res.data;
+        const code = data?.code;
+        if (code === "CLAIM_TOKEN_UNKNOWN") {
+            emitError("NOT_FOUND", "Unknown or invalid claim token.", "Double-check the token from `bata new`.");
+        }
+        if (code === "CLAIM_EXPIRED") {
+            emitError("NOT_FOUND", "This database has expired and been deleted.", "Create a fresh one with `bata new`.");
+        }
+        if (code === "CLAIM_ALREADY_CLAIMED") {
+            emitError("NOT_FOUND", "This database has already been claimed.", "");
+        }
+        emitError("CLI_ERROR", apiError(res, "Failed to claim database"));
+    }
+    const claimed = res.data;
+    saveConfig({ defaultProject: claimed.project_id });
+    if (isJsonMode()) {
+        json(claimed);
+        return;
+    }
+    log();
+    success(`Claimed ${colors.cyan(claimed.name)} into your team.`);
+    log();
+    kvList([
+        ["Project ID", colors.dim(claimed.project_id)],
+        ["Team", colors.dim(claimed.team_id)],
+    ]);
+    log();
+    log(`  ${colors.dim("Connect:")} ${colors.cyan("bata db url")}`);
+    log();
+}

package/dist/commands/new.d.ts

@@ -0,0 +1,21 @@
+/**
+ * bata new — instant Postgres in your team (one call, zero config).
+ *
+ * Authed (like every other command): requires a credential. Calls
+ * POST /v1/claim/new, which creates a REAL project directly in your team —
+ * owned, billed, and quota'd like any other — and prints the connection string.
+ * No name or region to pick; the compute is the smallest box and scales to zero.
+ *
+ * `--team <id>` targets a specific team (else your resolved/default team).
+ * `--json` emits the full payload for agents.
+ *
+ * (The old anonymous, no-signup flow with claim tokens is gone.)
+ */
+export interface NewArgs {
+    team?: string;
+    help: boolean;
+}
+/** Parse `bata new` args: optional `--team <id>` and `--help` (global flags
+ *  like --json are stripped upstream in index.ts). Exported for tests. */
+export declare function parseNewArgs(args: string[]): NewArgs;
+export declare function newDb(args: string[]): Promise<void>;

package/dist/commands/new.js

@@ -0,0 +1,95 @@
+/**
+ * bata new — instant Postgres in your team (one call, zero config).
+ *
+ * Authed (like every other command): requires a credential. Calls
+ * POST /v1/claim/new, which creates a REAL project directly in your team —
+ * owned, billed, and quota'd like any other — and prints the connection string.
+ * No name or region to pick; the compute is the smallest box and scales to zero.
+ *
+ * `--team <id>` targets a specific team (else your resolved/default team).
+ * `--json` emits the full payload for agents.
+ *
+ * (The old anonymous, no-signup flow with claim tokens is gone.)
+ */
+import { api, apiError, resolveTeamId } from "../api.js";
+import { requireToken, isJsonMode, saveConfig } from "../config.js";
+import { colors, log, json, success, kvList } from "../utils/logger.js";
+import { emitError } from "../utils/errors.js";
+/** Parse `bata new` args: optional `--team <id>` and `--help` (global flags
+ *  like --json are stripped upstream in index.ts). Exported for tests. */
+export function parseNewArgs(args) {
+    let team;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--help" || arg === "-h")
+            return { team, help: true };
+        if (arg === "--team" && args[i + 1])
+            team = args[++i];
+    }
+    return { team, help: false };
+}
+function printHelp() {
+    log();
+    log(`  ${colors.bold("bata new")}`);
+    log();
+    log(`  Create an instant Postgres database in your team and print how to connect.`);
+    log(`  One call, zero config — you get a connection string immediately.`);
+    log(`  Requires login — pass ${colors.cyan("--api-key")}, set ${colors.cyan("BATA_API_KEY")}, or run ${colors.cyan("bata login")}.`);
+    log();
+    log(`  ${colors.bold("Options")}`);
+    log(`    ${colors.dim("--team <id>")}   Team to create the database in (default: your team)`);
+    log(`    ${colors.dim("--json")}        Machine-readable output`);
+    log(`    ${colors.dim("--help, -h")}    Show this help`);
+    log();
+}
+export async function newDb(args) {
+    const parsed = parseNewArgs(args);
+    if (parsed.help) {
+        printHelp();
+        return;
+    }
+    // Authed like every other command. Exits 4 NO_CREDENTIALS when absent.
+    const token = requireToken();
+    // Resolve the team unless one was passed explicitly. The server verifies
+    // membership either way.
+    const teamId = parsed.team ?? (await resolveTeamId(token));
+    const body = {};
+    if (teamId)
+        body.team_id = teamId;
+    const res = await api.post("/v1/claim/new", body, token);
+    if (!res.ok) {
+        const data = res.data;
+        const code = data?.code;
+        if (res.status === 404 && code === "CLAIMABLE_DISABLED") {
+            emitError("NOT_FOUND", "Instant databases (bata new) are not enabled on this server.", "Create a project with `bata create <name>` instead.");
+        }
+        if (res.status === 429) {
+            emitError("API_UNAVAILABLE", "Rate limit reached for instant databases from this network.", "Wait a bit before creating another.");
+        }
+        emitError("CLI_ERROR", apiError(res, "Failed to create instant database"));
+    }
+    const db = res.data;
+    saveConfig({ defaultProject: db.project_id });
+    if (isJsonMode()) {
+        json(db);
+        return;
+    }
+    log();
+    success("Your instant database is ready!");
+    log();
+    kvList([
+        ["Project ID", colors.dim(db.project_id)],
+        ["Team", colors.dim(db.team_id)],
+    ]);
+    log();
+    log(`  ${colors.bold("Connection")}`);
+    log();
+    kvList([
+        ["Direct", colors.dim(db.connection.direct)],
+        ["Pooled", colors.dim(db.connection.pooled)],
+    ]);
+    log();
+    log(`  ${colors.dim("Connect:")} ${colors.cyan("bata db url")}`);
+    log(`  ${colors.dim("First connection may take a few seconds while the compute wakes.")}`);
+    log();
+}

package/dist/index.js

@@ -8,6 +8,8 @@ import { handleMigrate } from "./commands/migrate.js";
 import { handleApiKeys } from "./commands/api-keys.js";
 import { dev } from "./commands/dev.js";
 import { create } from "./commands/create.js";
+import { newDb } from "./commands/new.js";
+import { claim } from "./commands/claim.js";
 import { status } from "./commands/status.js";
 import { connect } from "./commands/connect.js";
 import { usage } from "./commands/usage.js";
@@ -25,6 +27,8 @@ function help() {
     log(`    ${colors.cyan("bata")} ${colors.dim("<command>")} ${colors.dim("[options]")}`);
     log();
     log(`  ${colors.bold("Quick Start")}`);
+    log(`    ${colors.cyan("new")}                Instant database in your team ${colors.dim("(one call, zero config)")}`);
+    log(`    ${colors.cyan("claim <token>")}     ${colors.dim("Legacy: redeem a claim token from the retired anonymous flow")}`);
     log(`    ${colors.cyan("create <name>")}     Create a project and wait for it to be ready`);
     log(`    ${colors.cyan("connect <name>")}    Open psql to a project (auto-wakes if suspended)`);
     log(`    ${colors.cyan("status")}             Show all projects and their status`);
@@ -126,6 +130,12 @@ async function main() {
             case "create":
                 await create(rest);
                 break;
+            case "new":
+                await newDb(rest);
+                break;
+            case "claim":
+                await claim(rest);
+                break;
             case "status":
                 await status();
                 break;

package/package.json

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