@2kw/ai 6.3.0-dev.128 → 6.3.0-dev.131

package/dist/commands/billing.js

@@ -1,6 +1,7 @@
 import { Command } from "commander";
 import { getClient, runAction } from "../lib/client.js";
 import { isJsonOutput } from "../lib/config.js";
+import { CliUsageError } from "../lib/errors.js";
 import { formatDetail, formatList } from "../lib/output.js";
 import chalk from "chalk";
 export function makeBillingCommand() {
@@ -133,6 +134,107 @@ export function makeBillingCommand() {
             }
         });
     });
+    cmd.addCommand(makeOverageCommand());
+    cmd.addCommand(makeTopUpsCommand());
+    return cmd;
+}
+/** Whole euros from cents, e.g. 1234 → "€12.34". Amounts are net of VAT (#973 D-O). */
+function euros(cents) {
+    return `€${((cents ?? 0) / 100).toFixed(2)}`;
+}
+function parseWhole(value, name, min, max) {
+    const n = /^\d+$/.test(value) ? Number(value) : NaN;
+    if (!Number.isInteger(n) || n < min || n > max) {
+        throw new CliUsageError(`${name} must be a whole number between ${min} and ${max}, not '${value}'`);
+    }
+    return n;
+}
+/** `bb billing overage get|set` — the opt-in overage cap (#973, plan D-O). Reads need a member login. */
+function makeOverageCommand() {
+    const cmd = new Command("overage").description("Show or set the opt-in overage cap (euros, net of VAT)");
+    cmd
+        .command("get")
+        .description("Show the overage setting and this period's overage (needs `bb auth login`)")
+        .action(async (_opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/billing/overage");
+            if (isJsonOutput(command)) {
+                console.log(JSON.stringify(data, null, 2));
+                return;
+            }
+            console.log(`Overage:   ${data?.enabled ? chalk.green("on") : chalk.dim("off")}`);
+            console.log(`Cap:       €${data?.capEuros ?? 0} (max €${data?.maxCapEuros ?? 0})`);
+            console.log(`Available: ${data?.available ? chalk.green("yes") : chalk.yellow(`no (${data?.unavailableReason ?? "unknown"})`)}`);
+            console.log(`Spent:     ${euros(data?.spentCents)}`);
+            console.log(`Reserved:  ${euros(data?.reservedCents)}`);
+            if (data?.periodStart || data?.periodEnd) {
+                console.log(chalk.dim(`Period: ${data?.periodStart?.slice(0, 10) ?? "?"} → ${data?.periodEnd?.slice(0, 10) ?? "?"}`));
+            }
+        });
+    });
+    cmd
+        .command("set")
+        .description("Turn overage on with a cap, or off (admin)")
+        .option("--cap <euros>", "Monthly cap in whole euros, 1-100; turns overage on")
+        .option("--off", "Turn overage off, keeping the stored cap")
+        .action(async (opts, command) => {
+        await runAction(command, async () => {
+            if (opts.off === Boolean(opts.cap)) {
+                throw new CliUsageError("Pass exactly one of --cap <euros> or --off");
+            }
+            // --off sends no cap: the backend keeps the stored one, and no read is needed (the read
+            // refuses API keys, the write admits an admin's).
+            const body = opts.off
+                ? { enabled: false }
+                : { enabled: true, capEuros: parseWhole(String(opts.cap), "cap", 1, 100) };
+            const client = getClient(command);
+            const { data } = await client.PUT("/v1/billing/overage", { body });
+            formatDetail(data, command);
+        });
+    });
+    return cmd;
+}
+/** `bb billing top-ups list|buy` — prepaid credit packs (#973, plan D-E). Never opens a browser. */
+function makeTopUpsCommand() {
+    const cmd = new Command("top-ups").description("List or buy prepaid credit (packs of 1,000 credits at €15)");
+    cmd
+        .command("list")
+        .description("List unexpired prepaid credit (needs `bb auth login`)")
+        .action(async (_opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/billing/top-ups");
+            if (isJsonOutput(command)) {
+                console.log(JSON.stringify(data, null, 2));
+                return;
+            }
+            const rows = (data ?? []).map((lot) => ({
+                kind: lot.kind,
+                purchased: euros(lot.purchasedCents),
+                remaining: euros(lot.remainingCents),
+                expires: lot.expiresAt?.slice(0, 10),
+            }));
+            formatList(rows, command, ["kind", "purchased", "remaining", "expires"]);
+        });
+    });
+    cmd
+        .command("buy")
+        .description("Start a Stripe Checkout for top-up packs and print its URL (admin)")
+        .requiredOption("--packs <n>", "Number of packs, 1-20")
+        .action(async (opts, command) => {
+        await runAction(command, async () => {
+            const packs = parseWhole(String(opts.packs), "packs", 1, 20);
+            const client = getClient(command);
+            const { data } = await client.POST("/v1/billing/top-ups", { body: { packs } });
+            if (isJsonOutput(command)) {
+                console.log(JSON.stringify(data, null, 2));
+                return;
+            }
+            console.log(`Open this page to pay: ${data?.checkoutUrl}`);
+            console.log(chalk.dim(`Expires: ${data?.expiresAt ?? "?"}`));
+        });
+    });
     return cmd;
 }
 //# sourceMappingURL=billing.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2kw/ai",
-  "version": "6.3.0-dev.128",
+  "version": "6.3.0-dev.131",
   "description": "CLI for 2kw.ai — schema-driven document extraction, an OpenAI-compatible EU LLM gateway, transcription, prompts, datasets, and experiments from your terminal or agentic workflows. Ships as 2kw, backbone, and bb.",
   "keywords": [
     "cli",