@aexhq/cli 0.42.3 → 0.44.0

package/README.md

@@ -4,7 +4,7 @@ Node.js 22 or newer. The CLI uses `@aexhq/sdk` and the same public Aex HTTP API
 the dashboard. No dashboard cookies, site credentials or operator credentials are needed.
 
 ```sh
-npm install -g @aexhq/cli@0.41.0
+npm install -g @aexhq/cli@0.44.0
 aex login
 aex keys create "My application"
 aex keys list
@@ -25,7 +25,11 @@ credentials expire after seven days; run `login` again. `logout` revokes this se
 
 Results are JSON on stdout; errors and login progress go to stderr. A created key's
 token is returned once. Existing keys expose only their metadata and prefix.
-Billing currently reports free preview hosting with customer-paid model usage.
+`billing` reports preview or prepaid status, available and reserved credits, prices and the monthly
+spend limit. `billing ledger`, `billing topups` and `billing refunds` show account history.
+`billing set PRICEBOOK MICRO_USD` accepts the offered prices and sets the monthly limit.
+`billing topup CENTS KEY` returns a Stripe Checkout URL; `billing refund TOPUP CENTS KEY`
+requests return of unused credits. Reuse the operation key for the same payment intent.
 
 The credential file is `~/.aex/account.json` on Unix or `%LOCALAPPDATA%/.aex/account.json`
 on Windows, restricted to the current user (and Windows SYSTEM). `AEX_CONFIG_DIR`

package/package.json

@@ -1,14 +1,32 @@
 {
   "name": "@aexhq/cli",
-  "version": "0.42.3",
+  "version": "0.44.0",
   "description": "Aex account and API key management from the terminal",
   "license": "MIT",
   "type": "module",
-  "engines": { "node": ">=22" },
-  "bin": { "aex": "src/index.mjs" },
-  "files": ["src", "README.md"],
-  "repository": { "type": "git", "url": "git+https://github.com/aexhq/aex.git", "directory": "packages/cli" },
-  "publishConfig": { "access": "public", "tag": "next" },
-  "dependencies": { "@aexhq/sdk": "0.75.3" },
-  "scripts": { "test": "node --test test/*.test.mjs" }
+  "engines": {
+    "node": ">=22"
+  },
+  "bin": {
+    "aex": "src/index.mjs"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aexhq/aex.git",
+    "directory": "packages/cli"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "next"
+  },
+  "dependencies": {
+    "@aexhq/sdk": "0.77.0"
+  },
+  "scripts": {
+    "test": "node --test test/*.test.mjs"
+  }
 }

package/src/index.mjs

@@ -13,7 +13,13 @@ const help = `Usage: aex <command>
   keys rename <id> <name>   Rename a key
   keys revoke <id>          Revoke a key
   account                  Show account, limits and billing status
-  billing                  Show billing status
+  billing                  Show credits, holds, prices and spend limit
+  billing ledger           Show recent credit transactions
+  billing set <pricebook> <micro-usd>  Accept prices and set a monthly spend limit
+  billing topup <cents> <key>         Create an idempotent Stripe Checkout
+  billing refund <topup> <cents> <key> Request a refund of unused credits
+  billing topups           Show payments and receipt links
+  billing refunds          Show refund status
   usage                    Show current usage
   docs                     Open the documentation
 
@@ -26,8 +32,8 @@ async function main() {
   const { values, positionals } = parseArgs({ allowPositionals: true, options: { help: { type: "boolean", short: "h" }, "no-browser": { type: "boolean" }, "api-url": { type: "string" }, "site-url": { type: "string" } } });
   if (values.help || !positionals.length) { process.stdout.write(help); return; }
   const [command, operation, ...args] = positionals;
-  const expected = { "keys list": 0, "keys create": 1, "keys rename": 2, "keys revoke": 1 };
-  if (command === "keys" ? expected[`keys ${operation}`] !== args.length : !["login", "logout", "account", "billing", "usage", "docs"].includes(command) || positionals.length !== 1) throw new Error("Unknown command or incorrect arguments. Run aex --help.");
+  const expected = { "keys list": 0, "keys create": 1, "keys rename": 2, "keys revoke": 1, "billing ledger":0, "billing set":2, "billing topup":2, "billing refund":3, "billing topups":0, "billing refunds":0 };
+  if (command === "keys" || (command === "billing" && operation) ? expected[`${command} ${operation}`] !== args.length : !["login", "logout", "account", "billing", "usage", "docs"].includes(command) || positionals.length !== 1) throw new Error("Unknown command or incorrect arguments. Run aex --help.");
   const explicitApi = values["api-url"] ?? process.env.AEX_API_URL;
   const siteUrl = origin(values["site-url"] ?? "https://aex.dev");
   if (command === "docs") {
@@ -61,7 +67,15 @@ async function main() {
     if (!process.env.AEX_ACCOUNT_TOKEN) await removeSession();
     result = { signed_out: true };
   } else if (command === "account") result = await client.account.get();
-  else if (command === "billing") result = { billing: (await client.account.get()).billing };
+  else if (command === "billing") {
+    const integer = value => { const n = Number(value); if (!/^\d+$/.test(value) || !Number.isSafeInteger(n)) throw new Error("Amounts must be nonnegative integers"); return n; };
+    if (!operation) result = await client.billing.get();
+    else if (operation === "ledger") result = await client.billing.ledger();
+    else if (operation === "set") result = await client.billing.update({ pricebook: args[0], spend_limit_micro_usd: integer(args[1]) });
+    else if (operation === "topup") result = await client.billing.topup({amount_cents:integer(args[0])},args[1]);
+    else if (operation === "refund") result = await client.billing.refund({topup:args[0],amount_cents:integer(args[1])},args[2]);
+    else result = await client.billing[operation]();
+  }
   else if (command === "usage") result = await client.account.usage();
   else if (operation === "list") result = await client.keys.list();
   else if (operation === "create") result = await client.keys.create({ name: args[0] });