@batadata/cli 0.1.14 → 0.1.15

package/dist/commands/claim.d.ts

@@ -0,0 +1,15 @@
+/**
+ * bata claim <token> — redeem a claimable database into your team.
+ *
+ * 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,
+ * agent-friendly 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,81 @@
+/**
+ * bata claim <token> — redeem a claimable database into your team.
+ *
+ * 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,
+ * agent-friendly 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(`  Claim an instant database (from ${colors.cyan("bata new")}) into your team.`);
+    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,17 @@
+/**
+ * bata new — instant, no-signup Postgres (bata.new / claimable databases).
+ *
+ * Calls the PUBLIC POST /v1/claim/new (no credentials needed), prints the
+ * connection string, the expiry, and how to claim the database into a real
+ * team later. `--json` emits the full payload (including the one-time claim
+ * token) for agents.
+ *
+ * Honest wording: an UNCLAIMED database is permanently DELETED at its expiry.
+ */
+export interface NewArgs {
+    help: boolean;
+}
+/** Parse `bata new` args. No positional/flags today beyond --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,90 @@
+/**
+ * bata new — instant, no-signup Postgres (bata.new / claimable databases).
+ *
+ * Calls the PUBLIC POST /v1/claim/new (no credentials needed), prints the
+ * connection string, the expiry, and how to claim the database into a real
+ * team later. `--json` emits the full payload (including the one-time claim
+ * token) for agents.
+ *
+ * Honest wording: an UNCLAIMED database is permanently DELETED at its expiry.
+ */
+import { api, apiError } from "../api.js";
+import { isJsonMode } from "../config.js";
+import { colors, log, json, success, kvList } from "../utils/logger.js";
+import { emitError } from "../utils/errors.js";
+/** Parse `bata new` args. No positional/flags today beyond --help (global
+ *  flags like --json are stripped upstream in index.ts). Exported for tests. */
+export function parseNewArgs(args) {
+    for (const arg of args) {
+        if (arg === "--help" || arg === "-h")
+            return { help: true };
+    }
+    return { help: false };
+}
+function printHelp() {
+    log();
+    log(`  ${colors.bold("bata new")}`);
+    log();
+    log(`  Create an instant, no-signup Postgres database and print how to connect.`);
+    log(`  You get a connection string immediately plus a one-time claim token.`);
+    log();
+    log(`  ${colors.bold("Claim it later")}`);
+    log(`    ${colors.cyan("bata claim <token>")}   Move the database into your team (clears the expiry)`);
+    log();
+    log(`  ${colors.yellow("Unclaimed databases are permanently DELETED at their expiry.")}`);
+    log();
+    log(`  ${colors.bold("Options")}`);
+    log(`    ${colors.dim("--json")}       Machine-readable output (includes the claim token)`);
+    log(`    ${colors.dim("--help, -h")}   Show this help`);
+    log();
+}
+export async function newDb(args) {
+    const parsed = parseNewArgs(args);
+    if (parsed.help) {
+        printHelp();
+        return;
+    }
+    // No credentials: this hits the PUBLIC endpoint.
+    const res = await api.post("/v1/claim/new", {});
+    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.", "Contact the operator, or create a project with `bata create` after `bata login`.");
+        }
+        if (res.status === 503 || code === "CLAIM_POOL_EXHAUSTED") {
+            emitError("API_UNAVAILABLE", "The free database pool is full right now. Try again shortly.", "This is transient — retry in a minute.");
+        }
+        if (res.status === 429) {
+            emitError("API_UNAVAILABLE", "Rate limit reached for instant databases from this network.", "Wait a bit before creating another, or claim one you already made.");
+        }
+        emitError("CLI_ERROR", apiError(res, "Failed to create instant database"));
+    }
+    const db = res.data;
+    if (isJsonMode()) {
+        json(db);
+        return;
+    }
+    log();
+    success("Your instant database is ready to claim!");
+    log();
+    kvList([
+        ["Project ID", colors.dim(db.project_id)],
+        ["Expires", db.expires_at],
+    ]);
+    log();
+    log(`  ${colors.bold("Connection")}`);
+    log();
+    kvList([
+        ["Direct", colors.dim(db.connection.direct)],
+        ["Pooled", colors.dim(db.connection.pooled)],
+    ]);
+    log();
+    log(`  ${colors.bold("Claim token")} ${colors.dim("(shown once)")}`);
+    log(`    ${colors.cyan(db.claim_token)}`);
+    log();
+    log(`  ${colors.dim("Claim it into your team:")} ${colors.cyan(`bata claim ${db.claim_token}`)}`);
+    log(`  ${colors.yellow("Unclaimed databases are permanently DELETED at expiry.")}`);
+    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 no-signup database ${colors.dim("(no login) — claim it later")}`);
+    log(`    ${colors.cyan("claim <token>")}     Claim a ` + "`bata new`" + ` database into your team`);
     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.15",
   "description": "CLI for BataDB — serverless Postgres platform",
   "bin": {
     "bata": "./dist/index.js"