@fluid-app/fluid-cli-billing 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,90 @@
-# Temporary Holding Version
+# @fluid-app/fluid-cli-billing
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Fluid CLI plugin for company billing: invoices, payments, credits and spend
+limits.
+
+```bash
+npm install -g @fluid-app/fluid-cli @fluid-app/fluid-cli-billing
+fluid login
+fluid billing show                              # invoices, upcoming charge, payment method
+fluid billing update --email ap@example.com --yes
+fluid billing standing
+fluid billing payments --limit 20
+fluid billing payments invoice 512 --open       # fresh Stripe link; they expire
+fluid billing documents
+fluid billing documents link 409 --open
+fluid billing credits                           # balance, plan, prices
+fluid billing credits quote 1000                # whole dollars
+fluid billing credits buy 1000 --yes            # spends real money
+fluid billing credits purchases
+fluid billing credits movements --limit 50
+fluid billing credits pay-now --yes             # spends real money
+fluid billing credits plan growth --interval annual --yes
+fluid billing limits
+fluid billing limits set --limits on --ai-monthly 1500 --ai-daily 100 --yes
+fluid billing usage record --sku sms_send --quantity 42 --dedup-key batch-7 --yes
+```
+
+Every command prints JSON; amounts are the API's integer cents, as it sent
+them. Failures print a JSON `error` (and the API's `code`, such as
+`quote_changed`) on stderr and exit non-zero. Anything that changes billing or
+charges the saved payment method asks for confirmation, or needs `--yes` when
+there is no terminal. `buy` and `pay-now` show the quoted total, card fee
+included, in that question; `buy` sends the quote back so the server refuses
+it if the price, terms or payment method changed. `credits plan` asks with
+the monthly total the plan will charge from the 1st, priced as Fluid prices
+it (the catalog or chosen price, the annual discount and the card fee), and
+changes nothing when it can't price the choice. It sends the monthly charge
+and total it showed, so if another admin changes the plan, or the saved
+payment method becomes a card, meanwhile, the server refuses the choice
+(`code: "plan_charge_changed"`) and nothing is saved. While the saved card's type is still being checked, no plan can be
+chosen (`code: "card_funding_pending"`); try again in a few minutes. If a `buy` fails without a
+clear answer, retry with the `--purchase-key` it printed rather than buying
+again.
+
+`buy` and `pay-now` print the purchase the API returned. The API answers
+the same way whatever the charge's outcome, so the CLI reads its `status`.
+Any other outcome than success or pending prints the purchase, then a JSON
+error on stderr with `charge_status` and a `code`, and exits non-zero:
+`charge_declined` for `failed` (with the decline `reason` when Stripe gave
+one), `charge_refunded` for `refunded`, `charge_reversed` for `reversed`, and
+`charge_<status>` for any other status (`charge_unknown` when there is none). A `pending` or
+`processing` charge (a bank debit takes about 4 business days) exits 0 with
+`pending: true` and a note; `fluid billing credits purchases` shows the
+outcome later.
+
+`--open` opens only Stripe https links (the hosted invoice page and the
+invoice and credit note PDFs). `opened` is `true` once the system opener
+finished cleanly, `"attempted"` if it was still running after a few seconds,
+and `false` with an `open_error` when there is no opener (a headless box
+without `xdg-open`, say) or it failed; the link is printed either way.
+
+## Commands that need `fluid login`
+
+Changes that record who made them need a signed-in user. A company (`C-`)
+or partner token is refused with a 403 for these, even when its role holds
+`billing.update`:
+
+- `fluid billing credits buy`
+- `fluid billing credits pay-now`
+- `fluid billing credits plan`
+- `fluid billing limits set`
+
+Run `fluid login` as a company admin for them. Reading billing, credits,
+limits, payments and documents works with a company token whose role holds
+`billing.view`.
+
+Amount arguments and flags are dollars (`1000`, `19.99`). Purchases and the
+auto-reload threshold and amount must be whole dollars.
+
+Spend limits: AI limits stop new AI work once reached; orders and hosting
+limits only notify; Studios limits are recorded and notified but not enforced.
+Turning `--auto-reload on` accepts the reload authorization it prints.
+
+`usage record` needs `billing.create_usage` and a company admin's or the
+company's own token; Droplet tokens are refused, and Mist AI usage is reported
+through Mist instead.
+
+Setting up a new card or bank account needs the browser flow in the admin;
+`fluid billing instrument <bank-account-id>` only switches back to a bank
+account whose ACH authorization was already given.

package/dist/index.d.mts

@@ -0,0 +1,21 @@
+import { CommandContext, FluidPlugin } from "@fluid-app/fluid-cli";
+import { Command } from "commander";
+
+//#region src/index.d.ts
+/**
+ * Changes to billing need an explicit yes. Scripts and agents pass `--yes`;
+ * an interactive terminal is asked. With neither, nothing runs.
+ */
+declare function confirmChange(question: string, yes: boolean, interactive?: boolean): Promise<void>;
+/**
+ * Print what a buy or pay-now returned. The API answers 201 whatever the
+ * charge's outcome, so a declined card is read from the purchase's status:
+ * the result is printed, then a JSON error on stderr and a non-zero exit.
+ * A pending or processing charge exits 0 with a note saying so.
+ */
+declare function reportCharge(ctx: CommandContext, result: Record<string, unknown>, what: string): void;
+declare function registerBillingCommands(parent: Command, ctx: CommandContext): void;
+declare const plugin: FluidPlugin;
+//#endregion
+export { confirmChange, plugin as default, registerBillingCommands, reportCharge };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;AAmDA;;iBAAsB,aAAA,CACpB,QAAA,UACA,GAAA,WACA,WAAA,aACC,OAAA;;;;;;;iBA6Ga,YAAA,CACd,GAAA,EAAK,cAAA,EACL,MAAA,EAAQ,MAAA,mBACR,IAAA;AAAA,iBA8Bc,uBAAA,CACd,MAAA,EAAQ,OAAA,EACR,GAAA,EAAK,cAAA;AAAA,cAwZD,MAAA,EAAQ,WAAA"}

package/dist/index.mjs

@@ -0,0 +1,785 @@
+import { randomUUID } from "node:crypto";
+import prompts from "prompts";
+import { createDomainCommand } from "@fluid-app/fluid-cli";
+import { spawn } from "node:child_process";
+//#region src/money.ts
+var AmountError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "AmountError";
+	}
+};
+const DOLLARS = /^\$?(\d+)(?:\.(\d{1,2}))?$/;
+/**
+* Parse a dollar amount ("250", "$250", "19.99") into integer cents.
+* Rejects anything else — signs, commas, exponents, a third decimal — rather
+* than guessing. `wholeDollars` refuses cents, as purchases and reload
+* figures require.
+*/
+function parseDollars(input, opts = {}) {
+	const label = opts.label ?? "Amount";
+	const match = DOLLARS.exec(input.trim());
+	if (!match) throw new AmountError(`${label} "${input}" isn't a dollar amount. Expected something like 250 or 19.99.`);
+	const whole = match[1] ?? "0";
+	const fraction = (match[2] ?? "").padEnd(2, "0");
+	const cents = BigInt(whole) * 100n + BigInt(fraction || "0");
+	if (cents <= 0n) throw new AmountError(`${label} must be more than $0.`);
+	if (opts.wholeDollars && cents % 100n !== 0n) throw new AmountError(`${label} must be whole dollars, not "${input}".`);
+	if (cents > BigInt(Number.MAX_SAFE_INTEGER)) throw new AmountError(`${label} "${input}" is too large.`);
+	return Number(cents);
+}
+/** A dollar flag that also takes "none" to clear the value (sent as null). */
+function parseDollarsOrNone(input, opts = {}) {
+	return input.trim().toLowerCase() === "none" ? null : parseDollars(input, opts);
+}
+/** Phrase integer cents as US dollars ("$1,029.00") without float math. */
+function formatCents(cents) {
+	if (!Number.isSafeInteger(cents)) throw new AmountError(`Expected whole cents from the API, got ${cents}.`);
+	const sign = cents < 0 ? "-" : "";
+	const digits = String(Math.abs(cents)).padStart(3, "0");
+	return `${sign}$${digits.slice(0, -2).replace(/\B(?=(\d{3})+(?!\d))/g, ",")}.${digits.slice(-2)}`;
+}
+//#endregion
+//#region src/api.ts
+var BillingError = class extends Error {
+	/** A machine-readable reason, printed as `code` like the API's. */
+	code;
+	constructor(message, code) {
+		super(message);
+		this.name = "BillingError";
+		this.code = code;
+	}
+};
+/** Why a plan can't be chosen while the saved card's funding is unknown. */
+const CARD_FUNDING_PENDING_MESSAGE = "The saved card's type is still being checked, so whether it carries the credit card fee isn't known yet. Nothing was changed; try again in a few minutes.";
+const BASE = "/api/settings/billing";
+const USAGE_EVENTS = "/api/v202604/billing/usage_events";
+function id(value) {
+	const trimmed = value.trim();
+	if (!/^\d+$/.test(trimmed)) throw new BillingError(`Expected a numeric id, got "${value}".`);
+	return encodeURIComponent(trimmed);
+}
+function field(data, key, what) {
+	const value = data?.[key];
+	if (value === void 0) throw new BillingError(`The ${what} response didn't include "${key}".`);
+	return value;
+}
+async function showBilling(client) {
+	return field(await client.get(BASE), "billing", "billing");
+}
+/** Set where invoices and billing emails go. null clears it, and Fluid then
+*  sends no billing email until one is set. The server validates the
+*  address. */
+async function setBillingEmail(client, email) {
+	const address = email?.trim() || null;
+	return field(await client.patch(BASE, { billing_email: address }), "billing", "billing update");
+}
+async function showStanding(client) {
+	return field(await client.get(`${BASE}/standing`), "standing", "standing");
+}
+/** Move collections onto a saved bank account whose ACH authorization the
+*  merchant already gave through instrument setup in the admin. */
+async function useBankAccount(client, bankAccountId) {
+	return field(await client.patch(`${BASE}/instrument`, { instrument: { bank_account_id: Number(id(bankAccountId)) } }), "billing", "instrument switch");
+}
+/** The list endpoints cap a page at 100 and default to 25, newest first. */
+const PAGE_SIZE = 100;
+const MAX_PAGES = 25;
+/**
+* Read every page of a list, newest first. `limit` stops after that many
+* items; without it the whole list is read, and one longer than
+* MAX_PAGES * PAGE_SIZE is refused rather than returned partially.
+*/
+async function listAll(client, path, key, limit) {
+	if (limit !== void 0 && (!Number.isSafeInteger(limit) || limit < 1)) throw new BillingError("--limit must be a whole number of at least 1.");
+	const all = [];
+	let cursor;
+	for (let page = 1; page <= MAX_PAGES; page += 1) {
+		const want = limit === void 0 ? PAGE_SIZE : limit - all.length;
+		const data = await client.get(path, { page: {
+			limit: Math.min(PAGE_SIZE, want),
+			cursor
+		} });
+		const items = data[key] ?? [];
+		all.push(...items);
+		const next = data.meta?.pagination?.next_cursor;
+		if (limit !== void 0 && all.length >= limit) return all.slice(0, limit);
+		if (!next || items.length === 0) return all;
+		cursor = next;
+	}
+	throw new BillingError(`There are more than ${MAX_PAGES * PAGE_SIZE} ${key.replace(/_/g, " ")}; pass --limit to read the newest ones.`);
+}
+const listPayments = (client, limit) => listAll(client, `${BASE}/payments`, "payments", limit);
+const listDocuments = (client, limit) => listAll(client, `${BASE}/documents`, "documents", limit);
+const listCreditMovements = (client, limit) => listAll(client, `${BASE}/credits/movements`, "credit_movements", limit);
+const listCreditPurchases = (client, limit) => listAll(client, `${BASE}/credits/purchases`, "credit_purchases", limit);
+async function link(client, path, key) {
+	return field(await client.get(path), key, "link");
+}
+const paymentInvoice = async (client, paymentId) => link(client, `${BASE}/payments/${id(paymentId)}/invoice`, "invoice");
+const documentLink = async (client, documentId) => link(client, `${BASE}/documents/${id(documentId)}/link`, "document");
+const purchaseInvoice = async (client, purchaseId) => link(client, `${BASE}/credits/purchases/${id(purchaseId)}/invoice`, "invoice");
+async function showCredits(client) {
+	return field(await client.get(`${BASE}/credits`), "credits", "credits");
+}
+/** The PATCH body for a plan choice. A first plan needs a key or a price;
+*  the server checks the key against its catalog. */
+function planChoiceBody(choice) {
+	if ("keepCurrentPlan" in choice) return { keep_current_plan: true };
+	const body = {};
+	if (choice.planKey !== void 0) {
+		const key = choice.planKey.trim().toLowerCase();
+		if (!key) throw new BillingError("The plan key is empty.");
+		body.plan_key = key;
+	}
+	if (choice.billingInterval !== void 0) {
+		if (!["monthly", "annual"].includes(choice.billingInterval)) throw new BillingError(`--interval is monthly or annual, not "${choice.billingInterval}".`);
+		body.billing_interval = choice.billingInterval;
+	}
+	if (choice.monthlyPriceCents !== void 0) body.monthly_price_cents = choice.monthlyPriceCents;
+	if (Object.keys(body).length === 0) throw new BillingError("Name a plan, a --monthly-price or --interval, or pass --keep-current.");
+	return body;
+}
+/** The card networks' cap on a card fee, in basis points (Billing::CardSurcharge). */
+const CARD_NETWORK_CAP_BASIS_POINTS = 300;
+function num(value) {
+	return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+/**
+* Price a plan choice the way the server prices it (Billing::CreditTermsManager
+* and Billing::CreditTermsResolver): the choice is laid over the plan already
+* waiting for next month, or the plan in force; a key alone costs its catalog
+* price; an annual plan's monthly charge takes the annual discount; and a
+* credit card adds its fee (Billing::CardSurcharge). Throws when the price
+* can't be told, so nothing is changed on a figure nobody saw.
+*/
+function planCharge(credits, choice) {
+	if ("keepCurrentPlan" in choice) throw new BillingError("Keeping the current plan prices nothing new.");
+	const base = credits.next_plan ?? credits.plan;
+	const offered = Array.isArray(credits.catalog_plans) ? credits.catalog_plans : [];
+	const key = choice.planKey?.trim().toLowerCase();
+	const catalog = key ? offered.find((plan) => plan.key === key) : void 0;
+	if (key && !catalog) {
+		const keys = offered.map((plan) => plan.key).filter(Boolean);
+		throw new BillingError(`Plan "${key}" isn't offered to this company${keys.length ? `; choose one of ${keys.join(", ")}` : ""}. Nothing was changed.`);
+	}
+	const price = choice.monthlyPriceCents ?? num(catalog?.monthly_price_cents) ?? num(base?.monthly_price_cents);
+	if (price === void 0) throw new BillingError("Can't tell what this plan would cost each month: name a plan or a --monthly-price. Nothing was changed.");
+	const interval = choice.billingInterval ?? (typeof base?.billing_interval === "string" ? base.billing_interval : "monthly");
+	const discount = num(credits.annual_discount_percent) ?? 0;
+	const charge = interval === "annual" ? Math.round(price * (100 - discount) / 100) : price;
+	const surcharge = credits.card_surcharge;
+	let fee = 0;
+	if (catalog && interval === "monthly" && choice.monthlyPriceCents === void 0 && num(catalog.monthly_surcharge_cents) !== void 0) fee = catalog.monthly_surcharge_cents;
+	else if (surcharge?.applies === true) {
+		const rate = num(surcharge.rate_basis_points);
+		if (rate === void 0) throw new BillingError("The credits response didn't include the credit card fee rate. Nothing was changed.");
+		const caps = [Math.floor((charge * rate + 5e3) / 1e4)];
+		const cap = num(surcharge.cap_cents);
+		if (cap !== void 0) caps.push(cap);
+		if (surcharge.kind !== "ach") caps.push(Math.floor(charge * CARD_NETWORK_CAP_BASIS_POINTS / 1e4));
+		fee = Math.min(...caps);
+	}
+	return {
+		planKey: key ?? (typeof base?.key === "string" ? base.key : null),
+		billingInterval: interval,
+		monthlyPriceCents: price,
+		monthlyChargeCents: charge,
+		surchargeCents: fee,
+		totalCents: charge + fee
+	};
+}
+function planChoiceQuestion(choice, charge, current) {
+	if ("keepCurrentPlan" in choice) {
+		const total = num(current?.monthly_total_cents);
+		return `Keep the current plan${total !== void 0 ? ` (${formatCents(total)} a month)` : ""} and drop the plan chosen for next month?`;
+	}
+	if (!charge) throw new BillingError("A plan change needs its monthly charge priced.");
+	const name = charge.planKey ? `plan ${charge.planKey}` : "a plan";
+	const discount = charge.monthlyChargeCents !== charge.monthlyPriceCents ? `, ${formatCents(charge.monthlyPriceCents)} less the annual discount` : "";
+	const fee = charge.surchargeCents > 0 ? ` (${formatCents(charge.monthlyChargeCents)} plus a ${formatCents(charge.surchargeCents)} credit card fee)` : "";
+	return `Change to ${name}, billed ${charge.billingInterval}${discount}, from the 1st of next month? It charges ${formatCents(charge.totalCents)}${fee} to the saved payment method each month.`;
+}
+/** Read the credits and price a plan choice before asking about it. */
+async function preparePlanChoice(client, choice) {
+	planChoiceBody(choice);
+	const credits = await showCredits(client);
+	if ("keepCurrentPlan" in choice) return { question: planChoiceQuestion(choice, void 0, credits.plan) };
+	if (credits.card_surcharge?.funding_pending === true) throw new BillingError(CARD_FUNDING_PENDING_MESSAGE, "card_funding_pending");
+	const charge = planCharge(credits, choice);
+	return {
+		question: planChoiceQuestion(choice, charge),
+		charge
+	};
+}
+/** Make a plan choice. With the monthly charge and total that were shown,
+*  the server refuses (409 plan_charge_changed) a choice that would now
+*  charge or total anything else, as when another admin chose a plan or
+*  switched the saved payment method to a card meanwhile. */
+async function choosePlan(client, choice, shown) {
+	const body = planChoiceBody(choice);
+	if (shown && !("keepCurrentPlan" in choice)) {
+		body.expected_monthly_charge_cents = shown.monthlyChargeCents;
+		body.expected_monthly_total_cents = shown.totalCents;
+	}
+	return field(await client.patch(`${BASE}/credits`, body), "credits", "plan change");
+}
+/** Price a purchase as the purchase itself would be priced. */
+async function quoteCredits(client, amountCents) {
+	return field(await client.get(`${BASE}/credits/quote`, { amount_cents: amountCents }), "quote", "quote");
+}
+function purchaseQuestion(quote, paymentMethod) {
+	const fee = quote.surcharge_cents > 0 ? ` (${formatCents(quote.amount_cents)} plus a ${formatCents(quote.surcharge_cents)} credit card fee)` : "";
+	return `Charge ${formatCents(quote.total_cents)}${fee} to ${paymentMethod} for ${formatCents(quote.credit_cents)} of credits (${quote.bonus_percent}% bonus)? This spends real money.`;
+}
+function describePaymentMethod(method) {
+	const display = method?.display;
+	const last4 = display?.last4;
+	const name = display?.brand ?? display?.bank_name;
+	if (typeof last4 === "string") return `${typeof name === "string" ? name : "the saved method"} ending ${last4}`;
+	return "the saved payment method";
+}
+/** Read the terms, the payment method and a fresh quote before a purchase. */
+async function prepareCreditPurchase(client, amountCents) {
+	const credits = await showCredits(client);
+	if (credits.purchasable === false) throw new BillingError("This company can't buy credits now: there is no usable card or bank account on file.");
+	const terms = credits.purchase_terms;
+	if (typeof terms?.version !== "string") throw new BillingError("The credits response didn't include the purchase terms.");
+	const [billing, quote] = await Promise.all([showBilling(client), quoteCredits(client, amountCents)]);
+	const method = billing.payment_method;
+	const termsText = typeof terms.text === "string" ? `\n\nPurchase terms ${terms.version}:\n${terms.text}` : "";
+	return {
+		quote,
+		termsVersion: terms.version,
+		paymentMethodKey: typeof method?.key === "string" ? method.key : null,
+		question: purchaseQuestion(quote, describePaymentMethod(method)) + termsText
+	};
+}
+/**
+* The question for a retry under an earlier purchase key. Fluid answers a
+* known key with the purchase it already holds: it returns it, or resubmits
+* it as first made, with its own amount and its originally reserved payment
+* method. Only an unknown key makes the purchase described now.
+*/
+function purchaseRetryQuestion(purchaseKey, newPurchaseQuestion) {
+	return `Retry purchase ${purchaseKey}? If Fluid already has a purchase under this key, it returns it, or resubmits it as first made: its original amount, to the payment method it reserved then, which may not be the one saved now. Only if Fluid has no purchase under this key does this make a new one: ${newPurchaseQuestion}`;
+}
+/** Buy what was prepared. The purchase key makes a retry charge once. */
+async function buyCredits(client, prepared, purchaseKey) {
+	const body = {
+		amount_cents: prepared.quote.amount_cents,
+		expected_credit_cents: prepared.quote.credit_cents,
+		expected_surcharge_cents: prepared.quote.surcharge_cents,
+		purchase_key: purchaseKey,
+		terms_version: prepared.termsVersion
+	};
+	if (prepared.paymentMethodKey) body.expected_payment_method_key = prepared.paymentMethodKey;
+	const data = await client.post(`${BASE}/credits/purchases`, body);
+	return {
+		purchase_key: purchaseKey,
+		credit_purchase: field(data, "credit_purchase", "purchase"),
+		balance_cents: data.balance_cents,
+		duplicate: data.duplicate
+	};
+}
+/** Read a charge's outcome from the `credit_purchase` a buy or pay-now
+*  returned. A status this CLI doesn't know is treated as not succeeded. */
+function chargeOutcome(purchase, what) {
+	const status = typeof purchase?.status === "string" ? purchase.status : "";
+	const reason = typeof purchase?.failure_message === "string" && purchase.failure_message ? purchase.failure_message : null;
+	switch (status) {
+		case "succeeded": return { kind: "succeeded" };
+		case "pending":
+		case "processing": return {
+			kind: "pending",
+			status,
+			note: `The ${what} is ${status}: nothing is final yet. A bank debit takes about 4 business days to settle; check \`fluid billing credits purchases\` for the outcome.`
+		};
+		case "failed": return {
+			kind: "declined",
+			status,
+			reason,
+			message: `The ${what} was declined${reason ? `: ${reason.replace(/\.+$/, "")}` : ""}. Nothing was charged.`
+		};
+		case "refunded":
+		case "reversed": return {
+			kind: "declined",
+			status,
+			reason,
+			message: `The ${what} was ${status}; its money went back and it grants no credits.`
+		};
+		default: return {
+			kind: "declined",
+			status,
+			reason,
+			message: `The ${what} came back with status "${status || "unknown"}", not succeeded. Check \`fluid billing credits purchases\`.`
+		};
+	}
+}
+function payNowQuestion(payNow) {
+	const fee = payNow.surcharge_cents > 0 ? ` (the ${formatCents(payNow.amount_cents)} owed plus a ${formatCents(payNow.surcharge_cents)} credit card fee)` : "";
+	return `Charge ${formatCents(payNow.total_cents)}${fee} to the saved payment method now for what the credits are overdrawn by? This spends real money.`;
+}
+/** Read what Pay now would charge, refusing early when it can't run. */
+async function preparePayNow(client) {
+	const creditBilling = (await showCredits(client)).credit_billing;
+	if (!creditBilling) throw new BillingError("This company's billing is not paid from credits.");
+	const payNow = creditBilling.pay_now;
+	if (!payNow) throw new BillingError("The credits response didn't include pay_now.");
+	if (!payNow.available) throw new BillingError(`Pay now can't run: ${payNow.reason ?? "unavailable"}. Nothing was charged.`);
+	return {
+		payNow,
+		question: payNowQuestion(payNow)
+	};
+}
+/** Charge the total that was shown; the server refuses any other. */
+async function payNow(client, expectedTotalCents) {
+	return client.post(`${BASE}/credits/pay-now`, { expected_total_cents: expectedTotalCents });
+}
+async function showLimits(client) {
+	return field(await client.get(`${BASE}/usage-controls`), "usage_controls", "usage controls");
+}
+const LIMIT_FIELDS = [
+	[
+		"limitsEnabled",
+		"limits_enabled",
+		"spend limits"
+	],
+	[
+		"ordersMonthly",
+		"orders_limit_cents",
+		"orders monthly limit"
+	],
+	[
+		"aiMonthly",
+		"ai_limit_cents",
+		"AI monthly limit"
+	],
+	[
+		"aiDaily",
+		"ai_daily_limit_cents",
+		"AI daily limit"
+	],
+	[
+		"hostingMonthly",
+		"hosting_limit_cents",
+		"hosting monthly limit"
+	],
+	[
+		"studiosMonthly",
+		"studios_limit_cents",
+		"Studios monthly limit"
+	],
+	[
+		"studiosDaily",
+		"studios_daily_limit_cents",
+		"Studios daily limit"
+	],
+	[
+		"autoReload",
+		"auto_reload",
+		"auto-reload"
+	],
+	[
+		"reloadThreshold",
+		"auto_reload_threshold_cents",
+		"reload threshold"
+	],
+	[
+		"reloadAmount",
+		"auto_reload_amount_cents",
+		"reload amount"
+	],
+	[
+		"reloadDailyCap",
+		"auto_reload_daily_cap_cents",
+		"reload daily cap"
+	],
+	[
+		"reloadMonthlyCap",
+		"auto_reload_monthly_cap_cents",
+		"reload monthly cap"
+	]
+];
+function describe(value) {
+	if (typeof value === "boolean") return value ? "on" : "off";
+	if (value === null) return "none (default)";
+	return formatCents(value);
+}
+/**
+* The PATCH body and confirmation question for a change to the limits.
+*
+* Turning auto-reload on is consent to buy credits with the saved card
+* whenever the balance runs low, so it accepts the authorization in force
+* and names the four reload figures the question showed; the server
+* refuses the save (409) if they are no longer the figures it would store.
+*/
+function limitsUpdate(current, changes) {
+	const body = {};
+	const lines = [];
+	for (const [key, wire, label] of LIMIT_FIELDS) {
+		const value = changes[key];
+		if (value === void 0) continue;
+		body[wire] = value;
+		lines.push(`${label}: ${describe(value)}`);
+	}
+	if (lines.length === 0) throw new BillingError("Nothing to change; pass at least one option.");
+	let question = `Set ${lines.join("; ")}?`;
+	if (changes.autoReload === true) {
+		const auth = current.reload_authorization;
+		if (typeof auth?.version !== "string") throw new BillingError("The usage controls didn't include the auto-reload authorization.");
+		const caps = current.reload_caps ?? {};
+		const shown = {
+			shown_reload_threshold_cents: pick(changes.reloadThreshold, current.reload_threshold_cents, "--reload-threshold"),
+			shown_reload_amount_cents: pick(changes.reloadAmount, current.reload_amount_cents, "--reload-amount"),
+			shown_reload_daily_cap_cents: pick(changes.reloadDailyCap, caps.daily_cents, "--reload-daily-cap"),
+			shown_reload_monthly_cap_cents: pick(changes.reloadMonthlyCap, caps.monthly_cents, "--reload-monthly-cap")
+		};
+		body.reload_authorization_version = auth.version;
+		Object.assign(body, shown);
+		question = `${question}\nAuto-reload buys ${formatCents(shown.shown_reload_amount_cents)} of credits with the saved card whenever the spendable balance falls below ${formatCents(shown.shown_reload_threshold_cents)}, at most ${formatCents(shown.shown_reload_daily_cap_cents)} a day and ${formatCents(shown.shown_reload_monthly_cap_cents)} a month.` + (typeof auth.text === "string" ? `\n\nAuthorization ${auth.version}:\n${auth.text}\n\nAccept it?` : "");
+	}
+	return {
+		body,
+		question
+	};
+}
+/** A reload figure the consent names: the one being set, else the one in
+*  force. "none" falls back to a default this CLI cannot see, so consent
+*  with it is refused rather than given to an unseen figure. */
+function pick(changed, current, flag) {
+	if (changed === null) throw new BillingError(`Turning auto-reload on names the figures it consents to; give ${flag} a dollar amount instead of none.`);
+	const value = changed ?? current;
+	if (typeof value !== "number") throw new BillingError(`The usage controls didn't include ${flag}.`);
+	return value;
+}
+async function setLimits(client, body) {
+	return field(await client.patch(`${BASE}/usage-controls`, body), "usage_controls", "usage controls update");
+}
+/** What the server's Time.iso8601 reads, with the zone required so a
+*  timestamp never means the caller's local time by accident. */
+const ISO8601 = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}(:?\d{2})?)$/;
+/** The request body for one usage event, validated as the server would. */
+function usageEventBody(input, now = () => /* @__PURE__ */ new Date()) {
+	const sku = input.sku.trim();
+	if (!sku || sku.length > 255) throw new BillingError("--sku must be 1 to 255 characters.");
+	const dedupKey = input.dedupKey.trim();
+	if (!dedupKey || dedupKey.length > 255) throw new BillingError("--dedup-key must be 1 to 255 characters.");
+	const raw = input.quantity.trim();
+	if (!/^\d+$/.test(raw) || !Number.isSafeInteger(Number(raw))) throw new BillingError(`--quantity must be a whole number from 0 to ${Number.MAX_SAFE_INTEGER}, not "${input.quantity}".`);
+	const occurredAt = input.occurredAt?.trim() || now().toISOString();
+	if (!ISO8601.test(occurredAt) || Number.isNaN(Date.parse(occurredAt))) throw new BillingError(`--occurred-at must be an ISO 8601 timestamp such as 2026-10-03T14:00:00Z, not "${input.occurredAt}".`);
+	const event = {
+		sku,
+		quantity: Number(raw),
+		occurred_at: occurredAt,
+		dedup_key: dedupKey
+	};
+	if (input.evidence !== void 0) {
+		let evidence;
+		try {
+			evidence = JSON.parse(input.evidence);
+		} catch {
+			throw new BillingError("--evidence must be a JSON object.");
+		}
+		if (!evidence || typeof evidence !== "object" || Array.isArray(evidence)) throw new BillingError("--evidence must be a JSON object.");
+		event.evidence = evidence;
+	}
+	return { usage_event: event };
+}
+/** Record one usage event. A repeat of its SKU and dedup key returns the
+*  first event with duplicate: true and records nothing. */
+async function recordUsage(client, input) {
+	const data = await client.post(USAGE_EVENTS, usageEventBody(input));
+	return {
+		usage_event: field(data, "usage_event", "usage event"),
+		duplicate: data.duplicate
+	};
+}
+//#endregion
+//#region src/browser.ts
+/** How long to wait for the opener to finish before reporting "attempted". */
+const OPENER_WAIT_MS = 3e3;
+/**
+* Every link the billing API hands out is Stripe's: the hosted invoice page
+* (invoice.stripe.com) and the invoice and credit note PDFs
+* (pay.stripe.com). Anything else is refused rather than opened.
+*/
+function isAllowedBillingUrl(raw) {
+	let url;
+	try {
+		url = new URL(raw);
+	} catch {
+		return false;
+	}
+	if (url.protocol !== "https:") return false;
+	if (url.username || url.password || url.port) return false;
+	const host = url.hostname.toLowerCase();
+	return host === "stripe.com" || host.endsWith(".stripe.com");
+}
+/** Open a Stripe billing link in the default browser and report whether the
+*  opener ran. Never rejects. */
+function openInBrowser(url, waitMs = OPENER_WAIT_MS) {
+	if (!isAllowedBillingUrl(url)) return Promise.resolve({
+		opened: false,
+		reason: "Not a Stripe https link; it was not opened."
+	});
+	const [command, args] = process.platform === "darwin" ? ["open", [url]] : process.platform === "win32" ? ["rundll32", ["url.dll,FileProtocolHandler", url]] : ["xdg-open", [url]];
+	return new Promise((resolve) => {
+		let settled = false;
+		let timer;
+		const settle = (result) => {
+			if (settled) return;
+			settled = true;
+			if (timer) clearTimeout(timer);
+			resolve(result);
+		};
+		let child;
+		try {
+			child = spawn(command, args, {
+				detached: true,
+				stdio: "ignore"
+			});
+		} catch (err) {
+			settle({
+				opened: false,
+				reason: openerFailure(command, err)
+			});
+			return;
+		}
+		child.on("error", (err) => settle({
+			opened: false,
+			reason: openerFailure(command, err)
+		}));
+		child.on("exit", (code) => settle(code === 0 ? { opened: true } : {
+			opened: false,
+			reason: `${command} exited with code ${code ?? "unknown"}.`
+		}));
+		child.on("spawn", () => {
+			timer = setTimeout(() => {
+				child.unref();
+				settle({ opened: "attempted" });
+			}, waitMs);
+		});
+	});
+}
+function openerFailure(command, err) {
+	return err.code === "ENOENT" ? `No browser opener (${command}) was found.` : `${command} failed: ${err instanceof Error ? err.message : String(err)}`;
+}
+//#endregion
+//#region src/index.ts
+async function client(ctx) {
+	return await ctx.getClient();
+}
+/**
+* Changes to billing need an explicit yes. Scripts and agents pass `--yes`;
+* an interactive terminal is asked. With neither, nothing runs.
+*/
+async function confirmChange(question, yes, interactive = Boolean(process.stdin.isTTY)) {
+	if (yes) return;
+	if (!interactive) throw new BillingError(`${question} Pass --yes to confirm.`);
+	if (!(await prompts({
+		type: "confirm",
+		name: "ok",
+		message: question,
+		initial: false
+	})).ok) throw new BillingError("Cancelled.");
+}
+/** Print a failure as JSON on stderr and exit non-zero, so scripts and
+*  agents can read it the same way as a success. The billing API names
+*  why it refused in `error.details.error` (`details.type` for usage
+*  intake); that comes through as `code`. */
+function fail(err) {
+	const status = typeof err.status === "number" ? err.status : void 0;
+	const body = err.body;
+	const message = typeof body?.error_message === "string" ? body.error_message : err instanceof Error ? err.message : String(err);
+	const details = (body?.error)?.details;
+	const code = details?.error ?? details?.type ?? err.code;
+	const readable = typeof code === "string" && status === 409 ? CONFLICT_MESSAGES[code] : void 0;
+	process.stderr.write(JSON.stringify({
+		error: readable ?? message,
+		...status ? { status } : {},
+		...typeof code === "string" ? { code } : {}
+	}) + "\n");
+	process.exitCode = 1;
+}
+/** What a plan change's 409 means for whoever ran it. */
+const CONFLICT_MESSAGES = {
+	card_funding_pending: CARD_FUNDING_PENDING_MESSAGE,
+	plan_charge_changed: "The plan's monthly total changed since it was shown (another change was made meanwhile). Nothing was changed; run the command again to see the new total.",
+	payment_method_changed: "The saved payment method changed while the plan was checked. Nothing was changed; run the command again."
+};
+function run(action) {
+	return action().catch(fail);
+}
+function limitOf(raw) {
+	if (raw === void 0) return void 0;
+	if (!/^\d+$/.test(raw.trim())) throw new BillingError(`--limit must be a whole number, not "${raw}".`);
+	return Number(raw.trim());
+}
+function onOff(raw, flag) {
+	if (raw === void 0) return void 0;
+	const value = raw.trim().toLowerCase();
+	if (value === "on") return true;
+	if (value === "off") return false;
+	throw new BillingError(`${flag} is on or off, not "${raw}".`);
+}
+/** Print a fresh Stripe link and, with --open, open it. A credit note has
+*  only a PDF. `opened` is true only when the opener finished cleanly,
+*  "attempted" when it was still running, and false otherwise. */
+async function showLink(ctx, id, link, open) {
+	const target = link.url || link.pdf_url;
+	let result = { opened: false };
+	if (open) result = target ? await openInBrowser(target) : {
+		opened: false,
+		reason: "The response had no link to open."
+	};
+	ctx.output({
+		id: Number(id),
+		url: link.url,
+		pdf_url: link.pdf_url,
+		opened: result.opened,
+		...result.reason ? { open_error: result.reason } : {},
+		note: "Stripe links expire; run this again for a fresh one."
+	});
+}
+/**
+* Print what a buy or pay-now returned. The API answers 201 whatever the
+* charge's outcome, so a declined card is read from the purchase's status:
+* the result is printed, then a JSON error on stderr and a non-zero exit.
+* A pending or processing charge exits 0 with a note saying so.
+*/
+function reportCharge(ctx, result, what) {
+	const outcome = chargeOutcome(result.credit_purchase, what);
+	if (outcome.kind === "pending") {
+		ctx.output({
+			...result,
+			pending: true,
+			note: outcome.note
+		});
+		return;
+	}
+	ctx.output(result);
+	if (outcome.kind === "declined") {
+		process.stderr.write(JSON.stringify({
+			error: outcome.message,
+			code: outcome.status === "failed" ? "charge_declined" : `charge_${outcome.status || "unknown"}`,
+			charge_status: outcome.status || null,
+			...outcome.reason ? { reason: outcome.reason } : {}
+		}) + "\n");
+		process.exitCode = 1;
+	}
+}
+const LIMITS_NOTE = "AI limits stop new AI work once reached; orders and hosting limits only notify and never stop anything; Studios limits are recorded and notified, not enforced.";
+function registerBillingCommands(parent, ctx) {
+	parent.command("show").description("Show the billing page: invoices, upcoming charge, payment method and terms").action(() => run(async () => ctx.output(await showBilling(await client(ctx)))));
+	parent.command("update").description("Set where invoices and billing emails go (the only billing field a merchant sets)").requiredOption("--email <address>", "Billing email address, or \"none\" to stop billing emails").option("--yes", "Confirm without a prompt", false).action((opts) => run(async () => {
+		const email = opts.email.trim().toLowerCase() === "none" ? null : opts.email.trim();
+		await confirmChange(email ? `Send this company's invoices and billing emails to ${email}?` : "Clear the billing email? Fluid then sends no billing email until one is set.", opts.yes);
+		ctx.output(await setBillingEmail(await client(ctx), email));
+	}));
+	parent.command("standing").description("Show the company's billing standing (invoiced companies only)").action(() => run(async () => ctx.output(await showStanding(await client(ctx)))));
+	parent.command("instrument <bank-account-id>").description("Collect from a saved bank account whose ACH authorization was already given in the admin; a new account or card is set up in the admin").option("--yes", "Confirm without a prompt", false).action((bankAccountId, opts) => run(async () => {
+		await confirmChange(`Collect this company's billing from bank account ${bankAccountId}?`, opts.yes);
+		ctx.output(await useBankAccount(await client(ctx), bankAccountId));
+	}));
+	parent.command("payments").description("List pulls from the company's bank account or card, newest first").option("--limit <n>", "Only the newest n").action((opts) => run(async () => ctx.output(await listPayments(await client(ctx), limitOf(opts.limit))))).command("invoice <id>").description("Get a fresh Stripe invoice link for one payment").option("--open", "Open the link in the default browser", false).action((id, opts) => run(async () => showLink(ctx, id, await paymentInvoice(await client(ctx), id), opts.open)));
+	parent.command("documents").description("List Stripe documents (paid invoices and credit notes), newest first").option("--limit <n>", "Only the newest n").action((opts) => run(async () => ctx.output(await listDocuments(await client(ctx), limitOf(opts.limit))))).command("link <id>").description("Get a fresh Stripe link for one document").option("--open", "Open the link in the default browser", false).action((id, opts) => run(async () => showLink(ctx, id, await documentLink(await client(ctx), id), opts.open)));
+	registerCreditCommands(parent, ctx);
+	registerLimitCommands(parent, ctx);
+	parent.command("usage").description("Report billable usage").command("record").description("Record one usage event (needs billing.create_usage, with a company admin's or the company's own token; Droplet tokens are refused, and Mist AI usage goes through Mist)").requiredOption("--sku <sku>", "Active billing product code").requiredOption("--quantity <n>", "Whole number of units").requiredOption("--dedup-key <key>", "Your id for this event; a repeat with the same SKU and key records nothing").option("--occurred-at <iso8601>", "When it happened, with a zone (default: now)").option("--evidence <json>", "JSON object stored with the event").option("--yes", "Confirm without a prompt", false).action((opts) => run(async () => {
+		await confirmChange(`Record ${opts.quantity} of ${opts.sku} as billable usage?`, opts.yes);
+		ctx.output(await recordUsage(await client(ctx), opts));
+	}));
+}
+function registerCreditCommands(parent, ctx) {
+	const credits = parent.command("credits").description("Show the credit balance, the plan and what more credits cost").action(() => run(async () => ctx.output(await showCredits(await client(ctx)))));
+	credits.command("plan [plan-key]").description("Choose the plan from the 1st of next month (invoiced companies only)").option("--interval <interval>", "monthly or annual").option("--monthly-price <dollars>", "Size the plan to a monthly price between the catalog's").option("--keep-current", "Drop the plan chosen for next month", false).option("--yes", "Confirm without a prompt", false).action((planKey, opts) => run(async () => {
+		let choice;
+		if (opts.keepCurrent) {
+			if (planKey || opts.interval || opts.monthlyPrice) throw new BillingError("--keep-current takes no plan, --interval or --monthly-price.");
+			choice = { keepCurrentPlan: true };
+		} else choice = {
+			planKey,
+			billingInterval: opts.interval,
+			monthlyPriceCents: opts.monthlyPrice === void 0 ? void 0 : parseDollars(opts.monthlyPrice, { label: "--monthly-price" })
+		};
+		const api = await client(ctx);
+		const { question, charge } = await preparePlanChoice(api, choice);
+		await confirmChange(question, opts.yes);
+		ctx.output(await choosePlan(api, choice, charge));
+	}));
+	credits.command("movements").description("List every change to the credit balance, newest first").option("--limit <n>", "Only the newest n").action((opts) => run(async () => ctx.output(await listCreditMovements(await client(ctx), limitOf(opts.limit)))));
+	credits.command("quote <dollars>").description("Price a purchase of credits: bonus, credits granted, card fee and total (whole dollars)").action((dollars) => run(async () => ctx.output(await quoteCredits(await client(ctx), parseDollars(dollars, { wholeDollars: true })))));
+	credits.command("buy <dollars>").description("Buy credits with the saved payment method (whole dollars; spends real money and accepts the purchase terms)").option("--purchase-key <uuid>", "Retry an earlier buy without charging twice (printed by that buy)").option("--yes", "Confirm without a prompt", false).action((dollars, opts) => run(async () => {
+		const amountCents = parseDollars(dollars, { wholeDollars: true });
+		const retrying = opts.purchaseKey !== void 0;
+		const purchaseKey = retrying ? opts.purchaseKey.trim() : randomUUID();
+		if (retrying && !purchaseKey) throw new BillingError("--purchase-key is empty. Pass the key printed by the earlier buy, or leave the flag out for a new purchase.");
+		if (!/^[0-9a-f-]{36}$/i.test(purchaseKey)) throw new BillingError("--purchase-key must be a UUID.");
+		const api = await client(ctx);
+		const prepared = await prepareCreditPurchase(api, amountCents);
+		await confirmChange(retrying ? purchaseRetryQuestion(purchaseKey, prepared.question) : prepared.question, opts.yes);
+		let bought;
+		try {
+			bought = await buyCredits(api, prepared, purchaseKey);
+		} catch (err) {
+			if (err instanceof Error) {
+				err.message = `${err.message} (purchase key ${purchaseKey}; check \`fluid billing credits purchases\`, and retry with --purchase-key ${purchaseKey} rather than a new buy)`;
+				const body = err.body;
+				if (body && typeof body.error_message === "string") body.error_message = err.message;
+			}
+			throw err;
+		}
+		reportCharge(ctx, bought, "purchase");
+	}));
+	credits.command("purchases").description("List credit purchases, newest first").option("--limit <n>", "Only the newest n").action((opts) => run(async () => ctx.output(await listCreditPurchases(await client(ctx), limitOf(opts.limit))))).command("invoice <id>").description("Get a fresh Stripe invoice link for one purchase").option("--open", "Open the link in the default browser", false).action((id, opts) => run(async () => showLink(ctx, id, await purchaseInvoice(await client(ctx), id), opts.open)));
+	credits.command("pay-now").description("Charge the saved payment method now for what the credits are overdrawn by (spends real money)").option("--yes", "Confirm without a prompt", false).action((opts) => run(async () => {
+		const api = await client(ctx);
+		const prepared = await preparePayNow(api);
+		await confirmChange(prepared.question, opts.yes);
+		reportCharge(ctx, await payNow(api, prepared.payNow.total_cents), "payment");
+	}));
+}
+function registerLimitCommands(parent, ctx) {
+	const limits = parent.command("limits").description(`Show spend limits and auto-reload. ${LIMITS_NOTE}`).action(() => run(async () => ctx.output(await showLimits(await client(ctx)))));
+	const dollars = "<dollars|none>";
+	limits.command("set").description(`Change spend limits and auto-reload; options left out keep their value. Amounts are dollars; "none" clears a limit or restores Fluid's default reload figure. ${LIMITS_NOTE}`).option("--limits <on|off>", "Turn the spend limits on or off").option(`--ai-monthly ${dollars}`, "Monthly AI limit").option(`--ai-daily ${dollars}`, "Daily AI limit").option(`--studios-monthly ${dollars}`, "Monthly Fluid Studios limit").option(`--studios-daily ${dollars}`, "Daily Fluid Studios limit").option(`--orders-monthly ${dollars}`, "Monthly orders limit (notifies)").option(`--hosting-monthly ${dollars}`, "Monthly hosting limit (notifies)").option("--auto-reload <on|off>", "Buy credits with the saved card when the balance runs low; on accepts the reload authorization").option(`--reload-threshold ${dollars}`, "Reload below this balance").option(`--reload-amount ${dollars}`, "What one reload buys").option(`--reload-daily-cap ${dollars}`, "Most reloaded in a day").option(`--reload-monthly-cap ${dollars}`, "Most reloaded in a month").option("--yes", "Confirm without a prompt", false).action((opts) => run(async () => {
+		const money = (key, whole = false) => {
+			const raw = opts[key];
+			return typeof raw === "string" ? parseDollarsOrNone(raw, {
+				wholeDollars: whole,
+				label: `--${key.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`)}`
+			}) : void 0;
+		};
+		const changes = {
+			limitsEnabled: onOff(opts.limits, "--limits"),
+			aiMonthly: money("aiMonthly"),
+			aiDaily: money("aiDaily"),
+			studiosMonthly: money("studiosMonthly"),
+			studiosDaily: money("studiosDaily"),
+			ordersMonthly: money("ordersMonthly"),
+			hostingMonthly: money("hostingMonthly"),
+			autoReload: onOff(opts.autoReload, "--auto-reload"),
+			reloadThreshold: money("reloadThreshold", true),
+			reloadAmount: money("reloadAmount", true),
+			reloadDailyCap: money("reloadDailyCap"),
+			reloadMonthlyCap: money("reloadMonthlyCap")
+		};
+		const api = await client(ctx);
+		const { body, question } = limitsUpdate(changes.autoReload === true ? await showLimits(api) : {}, changes);
+		await confirmChange(question, opts.yes === true);
+		ctx.output(await setLimits(api, body));
+	}));
+}
+const plugin = {
+	name: "@fluid-app/fluid-cli-billing",
+	version: "0.1.0",
+	register(ctx) {
+		ctx.program.addCommand(createDomainCommand("billing", "Read the company's billing and manage its credits and spend limits", registerBillingCommands));
+	}
+};
+//#endregion
+export { confirmChange, plugin as default, registerBillingCommands, reportCharge };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/money.ts","../src/api.ts","../src/browser.ts","../src/index.ts"],"sourcesContent":["// Amounts as the billing API speaks them: integer cents, never floats.\n//\n// The CLI takes amounts in dollars, the unit a merchant reads on the billing\n// page, and turns them into cents with string arithmetic so \"19.99\" is\n// exactly 1999. What the API returns is printed as it came; these helpers\n// only phrase a figure inside a confirmation question.\n\nexport class AmountError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"AmountError\";\n  }\n}\n\nconst DOLLARS = /^\\$?(\\d+)(?:\\.(\\d{1,2}))?$/;\n\n/**\n * Parse a dollar amount (\"250\", \"$250\", \"19.99\") into integer cents.\n * Rejects anything else — signs, commas, exponents, a third decimal — rather\n * than guessing. `wholeDollars` refuses cents, as purchases and reload\n * figures require.\n */\nexport function parseDollars(\n  input: string,\n  opts: { wholeDollars?: boolean; label?: string } = {},\n): number {\n  const label = opts.label ?? \"Amount\";\n  const match = DOLLARS.exec(input.trim());\n  if (!match) {\n    throw new AmountError(\n      `${label} \"${input}\" isn't a dollar amount. Expected something like 250 or 19.99.`,\n    );\n  }\n  const whole = match[1] ?? \"0\";\n  const fraction = (match[2] ?? \"\").padEnd(2, \"0\");\n  const cents = BigInt(whole) * 100n + BigInt(fraction || \"0\");\n  if (cents <= 0n) {\n    throw new AmountError(`${label} must be more than $0.`);\n  }\n  if (opts.wholeDollars && cents % 100n !== 0n) {\n    throw new AmountError(`${label} must be whole dollars, not \"${input}\".`);\n  }\n  if (cents > BigInt(Number.MAX_SAFE_INTEGER)) {\n    throw new AmountError(`${label} \"${input}\" is too large.`);\n  }\n  return Number(cents);\n}\n\n/** A dollar flag that also takes \"none\" to clear the value (sent as null). */\nexport function parseDollarsOrNone(\n  input: string,\n  opts: { wholeDollars?: boolean; label?: string } = {},\n): number | null {\n  return input.trim().toLowerCase() === \"none\"\n    ? null\n    : parseDollars(input, opts);\n}\n\n/** Phrase integer cents as US dollars (\"$1,029.00\") without float math. */\nexport function formatCents(cents: number): string {\n  if (!Number.isSafeInteger(cents)) {\n    throw new AmountError(`Expected whole cents from the API, got ${cents}.`);\n  }\n  const sign = cents < 0 ? \"-\" : \"\";\n  const digits = String(Math.abs(cents)).padStart(3, \"0\");\n  const dollars = digits.slice(0, -2).replace(/\\B(?=(\\d{3})+(?!\\d))/g, \",\");\n  return `${sign}$${dollars}.${digits.slice(-2)}`;\n}\n","// Calls to the merchant billing API (`/api/settings/billing`, settings-v0)\n// and to usage intake (`/api/v202604/billing/usage_events`).\n//\n// Every amount stays in the API's integer cents. Responses are returned as\n// the API sent them; only confirmation questions phrase figures in dollars.\n\nimport { formatCents } from \"./money.js\";\n\n/** The slice of the CLI's API client these calls use. */\nexport interface BillingClient {\n  get<T>(endpoint: string, params?: Record<string, unknown>): Promise<T>;\n  post<T>(endpoint: string, body?: unknown): Promise<T>;\n  patch<T>(endpoint: string, body?: unknown): Promise<T>;\n}\n\nexport class BillingError extends Error {\n  /** A machine-readable reason, printed as `code` like the API's. */\n  readonly code?: string;\n\n  constructor(message: string, code?: string) {\n    super(message);\n    this.name = \"BillingError\";\n    this.code = code;\n  }\n}\n\n/** Why a plan can't be chosen while the saved card's funding is unknown. */\nexport const CARD_FUNDING_PENDING_MESSAGE =\n  \"The saved card's type is still being checked, so whether it carries the credit card fee isn't known yet. Nothing was changed; try again in a few minutes.\";\n\nconst BASE = \"/api/settings/billing\";\nconst USAGE_EVENTS = \"/api/v202604/billing/usage_events\";\n\ntype Json = Record<string, unknown>;\n\nfunction id(value: string): string {\n  const trimmed = value.trim();\n  if (!/^\\d+$/.test(trimmed)) {\n    throw new BillingError(`Expected a numeric id, got \"${value}\".`);\n  }\n  return encodeURIComponent(trimmed);\n}\n\nfunction field<T>(data: Json | null | undefined, key: string, what: string): T {\n  const value = data?.[key];\n  if (value === undefined) {\n    throw new BillingError(`The ${what} response didn't include \"${key}\".`);\n  }\n  return value as T;\n}\n\n// ---------------------------------------------------------------------------\n// The billing page\n\nexport async function showBilling(client: BillingClient): Promise<Json> {\n  return field<Json>(await client.get<Json>(BASE), \"billing\", \"billing\");\n}\n\n/** Set where invoices and billing emails go. null clears it, and Fluid then\n *  sends no billing email until one is set. The server validates the\n *  address. */\nexport async function setBillingEmail(\n  client: BillingClient,\n  email: string | null,\n): Promise<Json> {\n  const address = email?.trim() || null;\n  const data = await client.patch<Json>(BASE, { billing_email: address });\n  return field<Json>(data, \"billing\", \"billing update\");\n}\n\nexport async function showStanding(client: BillingClient): Promise<Json> {\n  const data = await client.get<Json>(`${BASE}/standing`);\n  return field<Json>(data, \"standing\", \"standing\");\n}\n\n/** Move collections onto a saved bank account whose ACH authorization the\n *  merchant already gave through instrument setup in the admin. */\nexport async function useBankAccount(\n  client: BillingClient,\n  bankAccountId: string,\n): Promise<Json> {\n  const data = await client.patch<Json>(`${BASE}/instrument`, {\n    instrument: { bank_account_id: Number(id(bankAccountId)) },\n  });\n  return field<Json>(data, \"billing\", \"instrument switch\");\n}\n\n// ---------------------------------------------------------------------------\n// Cursor-paged lists\n\ninterface CursorPage {\n  meta?: { pagination?: { next_cursor?: string | null } };\n}\n\n/** The list endpoints cap a page at 100 and default to 25, newest first. */\nconst PAGE_SIZE = 100;\nconst MAX_PAGES = 25;\n\n/**\n * Read every page of a list, newest first. `limit` stops after that many\n * items; without it the whole list is read, and one longer than\n * MAX_PAGES * PAGE_SIZE is refused rather than returned partially.\n */\nexport async function listAll(\n  client: BillingClient,\n  path: string,\n  key: string,\n  limit?: number,\n): Promise<Json[]> {\n  if (limit !== undefined && (!Number.isSafeInteger(limit) || limit < 1)) {\n    throw new BillingError(\"--limit must be a whole number of at least 1.\");\n  }\n  const all: Json[] = [];\n  let cursor: string | undefined;\n  for (let page = 1; page <= MAX_PAGES; page += 1) {\n    const want = limit === undefined ? PAGE_SIZE : limit - all.length;\n    const data = await client.get<CursorPage & Json>(path, {\n      page: { limit: Math.min(PAGE_SIZE, want), cursor },\n    });\n    const items = (data[key] as Json[] | null | undefined) ?? [];\n    all.push(...items);\n    const next = data.meta?.pagination?.next_cursor;\n    if (limit !== undefined && all.length >= limit) {\n      return all.slice(0, limit);\n    }\n    if (!next || items.length === 0) return all;\n    cursor = next;\n  }\n  throw new BillingError(\n    `There are more than ${MAX_PAGES * PAGE_SIZE} ${key.replace(/_/g, \" \")}; pass --limit to read the newest ones.`,\n  );\n}\n\nexport const listPayments = (client: BillingClient, limit?: number) =>\n  listAll(client, `${BASE}/payments`, \"payments\", limit);\n\nexport const listDocuments = (client: BillingClient, limit?: number) =>\n  listAll(client, `${BASE}/documents`, \"documents\", limit);\n\nexport const listCreditMovements = (client: BillingClient, limit?: number) =>\n  listAll(client, `${BASE}/credits/movements`, \"credit_movements\", limit);\n\nexport const listCreditPurchases = (client: BillingClient, limit?: number) =>\n  listAll(client, `${BASE}/credits/purchases`, \"credit_purchases\", limit);\n\n// ---------------------------------------------------------------------------\n// Stripe links. Stripe's links expire, so each is fetched when asked for.\n\nexport interface StripeLink {\n  url: string;\n  pdf_url: string | null;\n}\n\nasync function link(\n  client: BillingClient,\n  path: string,\n  key: \"invoice\" | \"document\",\n): Promise<StripeLink> {\n  return field<StripeLink>(await client.get<Json>(path), key, \"link\");\n}\n\nexport const paymentInvoice = async (\n  client: BillingClient,\n  paymentId: string,\n) => link(client, `${BASE}/payments/${id(paymentId)}/invoice`, \"invoice\");\n\nexport const documentLink = async (client: BillingClient, documentId: string) =>\n  link(client, `${BASE}/documents/${id(documentId)}/link`, \"document\");\n\nexport const purchaseInvoice = async (\n  client: BillingClient,\n  purchaseId: string,\n) =>\n  link(\n    client,\n    `${BASE}/credits/purchases/${id(purchaseId)}/invoice`,\n    \"invoice\",\n  );\n\n// ---------------------------------------------------------------------------\n// Credits and the plan\n\nexport async function showCredits(client: BillingClient): Promise<Json> {\n  return field<Json>(\n    await client.get<Json>(`${BASE}/credits`),\n    \"credits\",\n    \"credits\",\n  );\n}\n\nexport type PlanChoice =\n  | { keepCurrentPlan: true }\n  | {\n      planKey?: string;\n      billingInterval?: \"monthly\" | \"annual\";\n      monthlyPriceCents?: number;\n    };\n\n/** The PATCH body for a plan choice. A first plan needs a key or a price;\n *  the server checks the key against its catalog. */\nexport function planChoiceBody(choice: PlanChoice): Json {\n  if (\"keepCurrentPlan\" in choice) return { keep_current_plan: true };\n  const body: Json = {};\n  if (choice.planKey !== undefined) {\n    const key = choice.planKey.trim().toLowerCase();\n    if (!key) throw new BillingError(\"The plan key is empty.\");\n    body.plan_key = key;\n  }\n  if (choice.billingInterval !== undefined) {\n    if (![\"monthly\", \"annual\"].includes(choice.billingInterval)) {\n      throw new BillingError(\n        `--interval is monthly or annual, not \"${choice.billingInterval}\".`,\n      );\n    }\n    body.billing_interval = choice.billingInterval;\n  }\n  if (choice.monthlyPriceCents !== undefined) {\n    body.monthly_price_cents = choice.monthlyPriceCents;\n  }\n  if (Object.keys(body).length === 0) {\n    throw new BillingError(\n      \"Name a plan, a --monthly-price or --interval, or pass --keep-current.\",\n    );\n  }\n  return body;\n}\n\n/** What a plan choice charges each month, as the server will price it. */\nexport interface PlanCharge {\n  planKey: string | null;\n  billingInterval: string;\n  monthlyPriceCents: number;\n  monthlyChargeCents: number;\n  surchargeCents: number;\n  totalCents: number;\n}\n\n/** The card networks' cap on a card fee, in basis points (Billing::CardSurcharge). */\nconst CARD_NETWORK_CAP_BASIS_POINTS = 300;\n\nfunction num(value: unknown): number | undefined {\n  return typeof value === \"number\" && Number.isFinite(value)\n    ? value\n    : undefined;\n}\n\n/**\n * Price a plan choice the way the server prices it (Billing::CreditTermsManager\n * and Billing::CreditTermsResolver): the choice is laid over the plan already\n * waiting for next month, or the plan in force; a key alone costs its catalog\n * price; an annual plan's monthly charge takes the annual discount; and a\n * credit card adds its fee (Billing::CardSurcharge). Throws when the price\n * can't be told, so nothing is changed on a figure nobody saw.\n */\nexport function planCharge(credits: Json, choice: PlanChoice): PlanCharge {\n  if (\"keepCurrentPlan\" in choice) {\n    throw new BillingError(\"Keeping the current plan prices nothing new.\");\n  }\n  const base = (credits.next_plan ?? credits.plan) as Json | null | undefined;\n  // The catalog at the price each key alone gives it, as the server sends it.\n  const offered = Array.isArray(credits.catalog_plans)\n    ? (credits.catalog_plans as Json[])\n    : [];\n  const key = choice.planKey?.trim().toLowerCase();\n  const catalog = key ? offered.find((plan) => plan.key === key) : undefined;\n  if (key && !catalog) {\n    const keys = offered.map((plan) => plan.key).filter(Boolean);\n    throw new BillingError(\n      `Plan \"${key}\" isn't offered to this company${keys.length ? `; choose one of ${keys.join(\", \")}` : \"\"}. Nothing was changed.`,\n    );\n  }\n  const price =\n    choice.monthlyPriceCents ??\n    num(catalog?.monthly_price_cents) ??\n    num(base?.monthly_price_cents);\n  if (price === undefined) {\n    throw new BillingError(\n      \"Can't tell what this plan would cost each month: name a plan or a --monthly-price. Nothing was changed.\",\n    );\n  }\n  const interval =\n    choice.billingInterval ??\n    (typeof base?.billing_interval === \"string\"\n      ? base.billing_interval\n      : \"monthly\");\n  const discount = num(credits.annual_discount_percent) ?? 0;\n  const charge =\n    interval === \"annual\"\n      ? Math.round((price * (100 - discount)) / 100)\n      : price;\n\n  const surcharge = credits.card_surcharge as Json | null | undefined;\n  let fee = 0;\n  if (\n    catalog &&\n    interval === \"monthly\" &&\n    choice.monthlyPriceCents === undefined &&\n    num(catalog.monthly_surcharge_cents) !== undefined\n  ) {\n    // The server priced this one already.\n    fee = catalog.monthly_surcharge_cents as number;\n  } else if (surcharge?.applies === true) {\n    const rate = num(surcharge.rate_basis_points);\n    if (rate === undefined) {\n      throw new BillingError(\n        \"The credits response didn't include the credit card fee rate. Nothing was changed.\",\n      );\n    }\n    // Billing::CardSurcharge.cents_for: the rate rounded half up, held to\n    // the fee's own cap and, on a card, to the networks' 3% rounded down.\n    const caps = [Math.floor((charge * rate + 5000) / 10000)];\n    const cap = num(surcharge.cap_cents);\n    if (cap !== undefined) caps.push(cap);\n    if (surcharge.kind !== \"ach\") {\n      caps.push(Math.floor((charge * CARD_NETWORK_CAP_BASIS_POINTS) / 10000));\n    }\n    fee = Math.min(...caps);\n  }\n  return {\n    planKey: key ?? (typeof base?.key === \"string\" ? base.key : null),\n    billingInterval: interval,\n    monthlyPriceCents: price,\n    monthlyChargeCents: charge,\n    surchargeCents: fee,\n    totalCents: charge + fee,\n  };\n}\n\nexport function planChoiceQuestion(\n  choice: PlanChoice,\n  charge?: PlanCharge,\n  current?: Json | null,\n): string {\n  if (\"keepCurrentPlan\" in choice) {\n    const total = num(current?.monthly_total_cents);\n    return `Keep the current plan${total !== undefined ? ` (${formatCents(total)} a month)` : \"\"} and drop the plan chosen for next month?`;\n  }\n  if (!charge) {\n    throw new BillingError(\"A plan change needs its monthly charge priced.\");\n  }\n  const name = charge.planKey ? `plan ${charge.planKey}` : \"a plan\";\n  const discount =\n    charge.monthlyChargeCents !== charge.monthlyPriceCents\n      ? `, ${formatCents(charge.monthlyPriceCents)} less the annual discount`\n      : \"\";\n  const fee =\n    charge.surchargeCents > 0\n      ? ` (${formatCents(charge.monthlyChargeCents)} plus a ${formatCents(charge.surchargeCents)} credit card fee)`\n      : \"\";\n  return `Change to ${name}, billed ${charge.billingInterval}${discount}, from the 1st of next month? It charges ${formatCents(charge.totalCents)}${fee} to the saved payment method each month.`;\n}\n\n/** Read the credits and price a plan choice before asking about it. */\nexport async function preparePlanChoice(\n  client: BillingClient,\n  choice: PlanChoice,\n): Promise<{ question: string; charge?: PlanCharge }> {\n  planChoiceBody(choice); // refuse a malformed choice before reading\n  const credits = await showCredits(client);\n  if (\"keepCurrentPlan\" in choice) {\n    return {\n      question: planChoiceQuestion(\n        choice,\n        undefined,\n        credits.plan as Json | null,\n      ),\n    };\n  }\n  // The server refuses a plan until the card's fee is known (409\n  // card_funding_pending); say so before asking about a total.\n  const surcharge = credits.card_surcharge as Json | null | undefined;\n  if (surcharge?.funding_pending === true) {\n    throw new BillingError(\n      CARD_FUNDING_PENDING_MESSAGE,\n      \"card_funding_pending\",\n    );\n  }\n  const charge = planCharge(credits, choice);\n  return { question: planChoiceQuestion(choice, charge), charge };\n}\n\n/** Make a plan choice. With the monthly charge and total that were shown,\n *  the server refuses (409 plan_charge_changed) a choice that would now\n *  charge or total anything else, as when another admin chose a plan or\n *  switched the saved payment method to a card meanwhile. */\nexport async function choosePlan(\n  client: BillingClient,\n  choice: PlanChoice,\n  shown?: Pick<PlanCharge, \"monthlyChargeCents\" | \"totalCents\">,\n): Promise<Json> {\n  const body = planChoiceBody(choice);\n  if (shown && !(\"keepCurrentPlan\" in choice)) {\n    body.expected_monthly_charge_cents = shown.monthlyChargeCents;\n    body.expected_monthly_total_cents = shown.totalCents;\n  }\n  const data = await client.patch<Json>(`${BASE}/credits`, body);\n  return field<Json>(data, \"credits\", \"plan change\");\n}\n\nexport interface CreditQuote {\n  amount_cents: number;\n  bonus_percent: number;\n  bonus_cents: number;\n  credit_cents: number;\n  surcharge_cents: number;\n  total_cents: number;\n}\n\n/** Price a purchase as the purchase itself would be priced. */\nexport async function quoteCredits(\n  client: BillingClient,\n  amountCents: number,\n): Promise<CreditQuote> {\n  const data = await client.get<Json>(`${BASE}/credits/quote`, {\n    amount_cents: amountCents,\n  });\n  return field<CreditQuote>(data, \"quote\", \"quote\");\n}\n\n/** Everything a purchase sends back so the server can refuse it if the\n *  price, the terms or the payment method changed since it was shown. */\nexport interface PreparedPurchase {\n  quote: CreditQuote;\n  termsVersion: string;\n  paymentMethodKey: string | null;\n  question: string;\n}\n\nexport function purchaseQuestion(\n  quote: CreditQuote,\n  paymentMethod: string,\n): string {\n  const fee =\n    quote.surcharge_cents > 0\n      ? ` (${formatCents(quote.amount_cents)} plus a ${formatCents(quote.surcharge_cents)} credit card fee)`\n      : \"\";\n  return `Charge ${formatCents(quote.total_cents)}${fee} to ${paymentMethod} for ${formatCents(quote.credit_cents)} of credits (${quote.bonus_percent}% bonus)? This spends real money.`;\n}\n\nfunction describePaymentMethod(method: Json | null | undefined): string {\n  const display = method?.display as Json | null | undefined;\n  const last4 = display?.last4;\n  const name = display?.brand ?? display?.bank_name;\n  if (typeof last4 === \"string\") {\n    return `${typeof name === \"string\" ? name : \"the saved method\"} ending ${last4}`;\n  }\n  return \"the saved payment method\";\n}\n\n/** Read the terms, the payment method and a fresh quote before a purchase. */\nexport async function prepareCreditPurchase(\n  client: BillingClient,\n  amountCents: number,\n): Promise<PreparedPurchase> {\n  const credits = await showCredits(client);\n  if (credits.purchasable === false) {\n    throw new BillingError(\n      \"This company can't buy credits now: there is no usable card or bank account on file.\",\n    );\n  }\n  const terms = credits.purchase_terms as\n    | { version?: unknown; text?: unknown }\n    | undefined;\n  if (typeof terms?.version !== \"string\") {\n    throw new BillingError(\n      \"The credits response didn't include the purchase terms.\",\n    );\n  }\n  const [billing, quote] = await Promise.all([\n    showBilling(client),\n    quoteCredits(client, amountCents),\n  ]);\n  const method = billing.payment_method as Json | null | undefined;\n  // A purchase names the terms version it agreed to, so the terms are part\n  // of what is confirmed.\n  const termsText =\n    typeof terms.text === \"string\"\n      ? `\\n\\nPurchase terms ${terms.version}:\\n${terms.text}`\n      : \"\";\n  return {\n    quote,\n    termsVersion: terms.version,\n    paymentMethodKey: typeof method?.key === \"string\" ? method.key : null,\n    question:\n      purchaseQuestion(quote, describePaymentMethod(method)) + termsText,\n  };\n}\n\n/**\n * The question for a retry under an earlier purchase key. Fluid answers a\n * known key with the purchase it already holds: it returns it, or resubmits\n * it as first made, with its own amount and its originally reserved payment\n * method. Only an unknown key makes the purchase described now.\n */\nexport function purchaseRetryQuestion(\n  purchaseKey: string,\n  newPurchaseQuestion: string,\n): string {\n  return (\n    `Retry purchase ${purchaseKey}? If Fluid already has a purchase under this key, it returns it, or resubmits it as first made: its original amount, to the payment method it reserved then, which may not be the one saved now. ` +\n    `Only if Fluid has no purchase under this key does this make a new one: ${newPurchaseQuestion}`\n  );\n}\n\n/** Buy what was prepared. The purchase key makes a retry charge once. */\nexport async function buyCredits(\n  client: BillingClient,\n  prepared: PreparedPurchase,\n  purchaseKey: string,\n): Promise<Json> {\n  const body: Json = {\n    amount_cents: prepared.quote.amount_cents,\n    expected_credit_cents: prepared.quote.credit_cents,\n    expected_surcharge_cents: prepared.quote.surcharge_cents,\n    purchase_key: purchaseKey,\n    terms_version: prepared.termsVersion,\n  };\n  if (prepared.paymentMethodKey) {\n    body.expected_payment_method_key = prepared.paymentMethodKey;\n  }\n  const data = await client.post<Json>(`${BASE}/credits/purchases`, body);\n  return {\n    purchase_key: purchaseKey,\n    credit_purchase: field<Json>(data, \"credit_purchase\", \"purchase\"),\n    balance_cents: data.balance_cents,\n    duplicate: data.duplicate,\n  };\n}\n\n/** What a charge's status means for whoever ran it. A purchase is pending\n *  while it is reserved and processing while a bank debit settles (about 4\n *  business days); failed, refunded and reversed charged nothing that\n *  stands. */\nexport type ChargeOutcome =\n  | { kind: \"succeeded\" }\n  | { kind: \"pending\"; status: string; note: string }\n  | {\n      kind: \"declined\";\n      status: string;\n      message: string;\n      reason: string | null;\n    };\n\n/** Read a charge's outcome from the `credit_purchase` a buy or pay-now\n *  returned. A status this CLI doesn't know is treated as not succeeded. */\nexport function chargeOutcome(\n  purchase: Json | null | undefined,\n  what: string,\n): ChargeOutcome {\n  const status = typeof purchase?.status === \"string\" ? purchase.status : \"\";\n  const reason =\n    typeof purchase?.failure_message === \"string\" && purchase.failure_message\n      ? purchase.failure_message\n      : null;\n  switch (status) {\n    case \"succeeded\":\n      return { kind: \"succeeded\" };\n    case \"pending\":\n    case \"processing\":\n      return {\n        kind: \"pending\",\n        status,\n        note: `The ${what} is ${status}: nothing is final yet. A bank debit takes about 4 business days to settle; check \\`fluid billing credits purchases\\` for the outcome.`,\n      };\n    case \"failed\":\n      return {\n        kind: \"declined\",\n        status,\n        reason,\n        message: `The ${what} was declined${reason ? `: ${reason.replace(/\\.+$/, \"\")}` : \"\"}. Nothing was charged.`,\n      };\n    case \"refunded\":\n    case \"reversed\":\n      return {\n        kind: \"declined\",\n        status,\n        reason,\n        message: `The ${what} was ${status}; its money went back and it grants no credits.`,\n      };\n    default:\n      return {\n        kind: \"declined\",\n        status,\n        reason,\n        message: `The ${what} came back with status \"${status || \"unknown\"}\", not succeeded. Check \\`fluid billing credits purchases\\`.`,\n      };\n  }\n}\n\nexport interface PayNowFigures {\n  amount_cents: number;\n  surcharge_cents: number;\n  total_cents: number;\n  available: boolean;\n  reason: string | null;\n}\n\nexport function payNowQuestion(payNow: PayNowFigures): string {\n  const fee =\n    payNow.surcharge_cents > 0\n      ? ` (the ${formatCents(payNow.amount_cents)} owed plus a ${formatCents(payNow.surcharge_cents)} credit card fee)`\n      : \"\";\n  return `Charge ${formatCents(payNow.total_cents)}${fee} to the saved payment method now for what the credits are overdrawn by? This spends real money.`;\n}\n\n/** Read what Pay now would charge, refusing early when it can't run. */\nexport async function preparePayNow(\n  client: BillingClient,\n): Promise<{ payNow: PayNowFigures; question: string }> {\n  const credits = await showCredits(client);\n  const creditBilling = credits.credit_billing as\n    | { pay_now?: PayNowFigures }\n    | null\n    | undefined;\n  if (!creditBilling) {\n    throw new BillingError(\"This company's billing is not paid from credits.\");\n  }\n  const payNow = creditBilling.pay_now;\n  if (!payNow) {\n    throw new BillingError(\"The credits response didn't include pay_now.\");\n  }\n  if (!payNow.available) {\n    throw new BillingError(\n      `Pay now can't run: ${payNow.reason ?? \"unavailable\"}. Nothing was charged.`,\n    );\n  }\n  return { payNow, question: payNowQuestion(payNow) };\n}\n\n/** Charge the total that was shown; the server refuses any other. */\nexport async function payNow(\n  client: BillingClient,\n  expectedTotalCents: number,\n): Promise<Json> {\n  return client.post<Json>(`${BASE}/credits/pay-now`, {\n    expected_total_cents: expectedTotalCents,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Spend limits and auto-reload\n\nexport async function showLimits(client: BillingClient): Promise<Json> {\n  const data = await client.get<Json>(`${BASE}/usage-controls`);\n  return field<Json>(data, \"usage_controls\", \"usage controls\");\n}\n\n/** Limits and reload figures in cents; null clears a value back to none or\n *  Fluid's default. Left out keeps the current value. */\nexport interface LimitChanges {\n  limitsEnabled?: boolean;\n  autoReload?: boolean;\n  ordersMonthly?: number | null;\n  aiMonthly?: number | null;\n  aiDaily?: number | null;\n  hostingMonthly?: number | null;\n  studiosMonthly?: number | null;\n  studiosDaily?: number | null;\n  reloadThreshold?: number | null;\n  reloadAmount?: number | null;\n  reloadDailyCap?: number | null;\n  reloadMonthlyCap?: number | null;\n}\n\nconst LIMIT_FIELDS: Array<[keyof LimitChanges, string, string]> = [\n  [\"limitsEnabled\", \"limits_enabled\", \"spend limits\"],\n  [\"ordersMonthly\", \"orders_limit_cents\", \"orders monthly limit\"],\n  [\"aiMonthly\", \"ai_limit_cents\", \"AI monthly limit\"],\n  [\"aiDaily\", \"ai_daily_limit_cents\", \"AI daily limit\"],\n  [\"hostingMonthly\", \"hosting_limit_cents\", \"hosting monthly limit\"],\n  [\"studiosMonthly\", \"studios_limit_cents\", \"Studios monthly limit\"],\n  [\"studiosDaily\", \"studios_daily_limit_cents\", \"Studios daily limit\"],\n  [\"autoReload\", \"auto_reload\", \"auto-reload\"],\n  [\"reloadThreshold\", \"auto_reload_threshold_cents\", \"reload threshold\"],\n  [\"reloadAmount\", \"auto_reload_amount_cents\", \"reload amount\"],\n  [\"reloadDailyCap\", \"auto_reload_daily_cap_cents\", \"reload daily cap\"],\n  [\"reloadMonthlyCap\", \"auto_reload_monthly_cap_cents\", \"reload monthly cap\"],\n];\n\nfunction describe(value: unknown): string {\n  if (typeof value === \"boolean\") return value ? \"on\" : \"off\";\n  if (value === null) return \"none (default)\";\n  return formatCents(value as number);\n}\n\n/**\n * The PATCH body and confirmation question for a change to the limits.\n *\n * Turning auto-reload on is consent to buy credits with the saved card\n * whenever the balance runs low, so it accepts the authorization in force\n * and names the four reload figures the question showed; the server\n * refuses the save (409) if they are no longer the figures it would store.\n */\nexport function limitsUpdate(\n  current: Json,\n  changes: LimitChanges,\n): { body: Json; question: string } {\n  const body: Json = {};\n  const lines: string[] = [];\n  for (const [key, wire, label] of LIMIT_FIELDS) {\n    const value = changes[key];\n    if (value === undefined) continue;\n    body[wire] = value;\n    lines.push(`${label}: ${describe(value)}`);\n  }\n  if (lines.length === 0) {\n    throw new BillingError(\"Nothing to change; pass at least one option.\");\n  }\n  let question = `Set ${lines.join(\"; \")}?`;\n\n  if (changes.autoReload === true) {\n    const auth = current.reload_authorization as\n      | { version?: unknown; text?: unknown }\n      | undefined;\n    if (typeof auth?.version !== \"string\") {\n      throw new BillingError(\n        \"The usage controls didn't include the auto-reload authorization.\",\n      );\n    }\n    const caps = (current.reload_caps ?? {}) as Json;\n    const shown = {\n      shown_reload_threshold_cents: pick(\n        changes.reloadThreshold,\n        current.reload_threshold_cents,\n        \"--reload-threshold\",\n      ),\n      shown_reload_amount_cents: pick(\n        changes.reloadAmount,\n        current.reload_amount_cents,\n        \"--reload-amount\",\n      ),\n      shown_reload_daily_cap_cents: pick(\n        changes.reloadDailyCap,\n        caps.daily_cents,\n        \"--reload-daily-cap\",\n      ),\n      shown_reload_monthly_cap_cents: pick(\n        changes.reloadMonthlyCap,\n        caps.monthly_cents,\n        \"--reload-monthly-cap\",\n      ),\n    };\n    body.reload_authorization_version = auth.version;\n    Object.assign(body, shown);\n    question =\n      `${question}\\nAuto-reload buys ${formatCents(shown.shown_reload_amount_cents)} of credits with the saved card ` +\n      `whenever the spendable balance falls below ${formatCents(shown.shown_reload_threshold_cents)}, ` +\n      `at most ${formatCents(shown.shown_reload_daily_cap_cents)} a day and ${formatCents(shown.shown_reload_monthly_cap_cents)} a month.` +\n      (typeof auth.text === \"string\"\n        ? `\\n\\nAuthorization ${auth.version}:\\n${auth.text}\\n\\nAccept it?`\n        : \"\");\n  }\n  return { body, question };\n}\n\n/** A reload figure the consent names: the one being set, else the one in\n *  force. \"none\" falls back to a default this CLI cannot see, so consent\n *  with it is refused rather than given to an unseen figure. */\nfunction pick(\n  changed: number | null | undefined,\n  current: unknown,\n  flag: string,\n): number {\n  if (changed === null) {\n    throw new BillingError(\n      `Turning auto-reload on names the figures it consents to; give ${flag} a dollar amount instead of none.`,\n    );\n  }\n  const value = changed ?? current;\n  if (typeof value !== \"number\") {\n    throw new BillingError(`The usage controls didn't include ${flag}.`);\n  }\n  return value;\n}\n\nexport async function setLimits(\n  client: BillingClient,\n  body: Json,\n): Promise<Json> {\n  const data = await client.patch<Json>(`${BASE}/usage-controls`, body);\n  return field<Json>(data, \"usage_controls\", \"usage controls update\");\n}\n\n// ---------------------------------------------------------------------------\n// Usage intake\n\nexport interface UsageEventInput {\n  sku: string;\n  quantity: string;\n  occurredAt?: string;\n  dedupKey: string;\n  evidence?: string;\n}\n\n/** What the server's Time.iso8601 reads, with the zone required so a\n *  timestamp never means the caller's local time by accident. */\nconst ISO8601 =\n  /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?(Z|[+-]\\d{2}(:?\\d{2})?)$/;\n\n/** The request body for one usage event, validated as the server would. */\nexport function usageEventBody(\n  input: UsageEventInput,\n  now: () => Date = () => new Date(),\n): Json {\n  const sku = input.sku.trim();\n  if (!sku || sku.length > 255) {\n    throw new BillingError(\"--sku must be 1 to 255 characters.\");\n  }\n  const dedupKey = input.dedupKey.trim();\n  if (!dedupKey || dedupKey.length > 255) {\n    throw new BillingError(\"--dedup-key must be 1 to 255 characters.\");\n  }\n  const raw = input.quantity.trim();\n  // Integers past 2^53 would be rounded on their way into JSON.\n  if (!/^\\d+$/.test(raw) || !Number.isSafeInteger(Number(raw))) {\n    throw new BillingError(\n      `--quantity must be a whole number from 0 to ${Number.MAX_SAFE_INTEGER}, not \"${input.quantity}\".`,\n    );\n  }\n  const occurredAt = input.occurredAt?.trim() || now().toISOString();\n  if (!ISO8601.test(occurredAt) || Number.isNaN(Date.parse(occurredAt))) {\n    throw new BillingError(\n      `--occurred-at must be an ISO 8601 timestamp such as 2026-10-03T14:00:00Z, not \"${input.occurredAt}\".`,\n    );\n  }\n  const event: Json = {\n    sku,\n    quantity: Number(raw),\n    occurred_at: occurredAt,\n    dedup_key: dedupKey,\n  };\n  if (input.evidence !== undefined) {\n    let evidence: unknown;\n    try {\n      evidence = JSON.parse(input.evidence);\n    } catch {\n      throw new BillingError(\"--evidence must be a JSON object.\");\n    }\n    if (!evidence || typeof evidence !== \"object\" || Array.isArray(evidence)) {\n      throw new BillingError(\"--evidence must be a JSON object.\");\n    }\n    event.evidence = evidence;\n  }\n  return { usage_event: event };\n}\n\n/** Record one usage event. A repeat of its SKU and dedup key returns the\n *  first event with duplicate: true and records nothing. */\nexport async function recordUsage(\n  client: BillingClient,\n  input: UsageEventInput,\n): Promise<Json> {\n  const data = await client.post<Json>(USAGE_EVENTS, usageEventBody(input));\n  return {\n    usage_event: field<Json>(data, \"usage_event\", \"usage event\"),\n    duplicate: data.duplicate,\n  };\n}\n","import { spawn } from \"node:child_process\";\n\n// The same opener the channels plugin uses for `--open`, checked harder:\n// these links come from the API and are handed to the OS opener.\n\n/** Whether the opener ran: true when it finished cleanly, false when it\n *  couldn't start or failed, \"attempted\" when it was still running after\n *  the wait, so nothing is known either way. */\nexport type Opened = true | false | \"attempted\";\n\nexport interface OpenResult {\n  opened: Opened;\n  /** Why nothing was opened, when `opened` is false. */\n  reason?: string;\n}\n\n/** How long to wait for the opener to finish before reporting \"attempted\". */\nconst OPENER_WAIT_MS = 3000;\n\n/**\n * Every link the billing API hands out is Stripe's: the hosted invoice page\n * (invoice.stripe.com) and the invoice and credit note PDFs\n * (pay.stripe.com). Anything else is refused rather than opened.\n */\nexport function isAllowedBillingUrl(raw: string): boolean {\n  let url: URL;\n  try {\n    url = new URL(raw);\n  } catch {\n    return false;\n  }\n  if (url.protocol !== \"https:\") return false;\n  if (url.username || url.password || url.port) return false;\n  const host = url.hostname.toLowerCase();\n  return host === \"stripe.com\" || host.endsWith(\".stripe.com\");\n}\n\n/** Open a Stripe billing link in the default browser and report whether the\n *  opener ran. Never rejects. */\nexport function openInBrowser(\n  url: string,\n  waitMs: number = OPENER_WAIT_MS,\n): Promise<OpenResult> {\n  if (!isAllowedBillingUrl(url)) {\n    return Promise.resolve({\n      opened: false,\n      reason: \"Not a Stripe https link; it was not opened.\",\n    });\n  }\n  const [command, args] =\n    process.platform === \"darwin\"\n      ? [\"open\", [url]]\n      : process.platform === \"win32\"\n        ? // Not `cmd /c start`: cmd reads the `&` between query\n          // parameters as a command separator and truncates the link.\n          [\"rundll32\", [\"url.dll,FileProtocolHandler\", url]]\n        : [\"xdg-open\", [url]];\n\n  return new Promise<OpenResult>((resolve) => {\n    let settled = false;\n    let timer: ReturnType<typeof setTimeout> | undefined;\n    const settle = (result: OpenResult) => {\n      if (settled) return;\n      settled = true;\n      if (timer) clearTimeout(timer);\n      resolve(result);\n    };\n\n    let child: ReturnType<typeof spawn>;\n    try {\n      child = spawn(command as string, args as string[], {\n        detached: true,\n        stdio: \"ignore\",\n      });\n    } catch (err) {\n      settle({ opened: false, reason: openerFailure(command as string, err) });\n      return;\n    }\n\n    // ENOENT (no opener installed, as on a headless box) arrives here.\n    child.on(\"error\", (err) =>\n      settle({ opened: false, reason: openerFailure(command as string, err) }),\n    );\n    // xdg-open with no display, or no browser, exits non-zero.\n    child.on(\"exit\", (code) =>\n      settle(\n        code === 0\n          ? { opened: true }\n          : {\n              opened: false,\n              reason: `${command as string} exited with code ${code ?? \"unknown\"}.`,\n            },\n      ),\n    );\n    // Started but still running: don't hold the CLI open for it.\n    child.on(\"spawn\", () => {\n      timer = setTimeout(() => {\n        child.unref();\n        settle({ opened: \"attempted\" });\n      }, waitMs);\n    });\n  });\n}\n\nfunction openerFailure(command: string, err: unknown): string {\n  const code = (err as { code?: unknown }).code;\n  return code === \"ENOENT\"\n    ? `No browser opener (${command}) was found.`\n    : `${command} failed: ${err instanceof Error ? err.message : String(err)}`;\n}\n","import { randomUUID } from \"node:crypto\";\n\nimport type { Command } from \"commander\";\nimport prompts from \"prompts\";\nimport type { CommandContext, FluidPlugin } from \"@fluid-app/fluid-cli\";\nimport { createDomainCommand } from \"@fluid-app/fluid-cli\";\n\nimport {\n  BillingError,\n  CARD_FUNDING_PENDING_MESSAGE,\n  buyCredits,\n  chargeOutcome,\n  choosePlan,\n  documentLink,\n  limitsUpdate,\n  listCreditMovements,\n  listCreditPurchases,\n  listDocuments,\n  listPayments,\n  payNow,\n  paymentInvoice,\n  purchaseRetryQuestion,\n  prepareCreditPurchase,\n  preparePlanChoice,\n  preparePayNow,\n  purchaseInvoice,\n  quoteCredits,\n  recordUsage,\n  setBillingEmail,\n  setLimits,\n  showBilling,\n  showCredits,\n  showLimits,\n  showStanding,\n  useBankAccount,\n  type BillingClient,\n  type LimitChanges,\n  type PlanChoice,\n  type StripeLink,\n} from \"./api.js\";\nimport { openInBrowser, type OpenResult } from \"./browser.js\";\nimport { parseDollars, parseDollarsOrNone } from \"./money.js\";\n\nasync function client(ctx: CommandContext): Promise<BillingClient> {\n  return (await ctx.getClient()) as unknown as BillingClient;\n}\n\n/**\n * Changes to billing need an explicit yes. Scripts and agents pass `--yes`;\n * an interactive terminal is asked. With neither, nothing runs.\n */\nexport async function confirmChange(\n  question: string,\n  yes: boolean,\n  interactive: boolean = Boolean(process.stdin.isTTY),\n): Promise<void> {\n  if (yes) return;\n  if (!interactive) {\n    throw new BillingError(`${question} Pass --yes to confirm.`);\n  }\n  const answer = await prompts({\n    type: \"confirm\",\n    name: \"ok\",\n    message: question,\n    initial: false,\n  });\n  if (!answer.ok) throw new BillingError(\"Cancelled.\");\n}\n\n/** Print a failure as JSON on stderr and exit non-zero, so scripts and\n *  agents can read it the same way as a success. The billing API names\n *  why it refused in `error.details.error` (`details.type` for usage\n *  intake); that comes through as `code`. */\nfunction fail(err: unknown): void {\n  const status =\n    typeof (err as { status?: unknown }).status === \"number\"\n      ? (err as { status: number }).status\n      : undefined;\n  const body = (err as { body?: Record<string, unknown> | null }).body;\n  const message =\n    typeof body?.error_message === \"string\"\n      ? body.error_message\n      : err instanceof Error\n        ? err.message\n        : String(err);\n  const details = (body?.error as { details?: Record<string, unknown> } | null)\n    ?.details;\n  const code =\n    details?.error ?? details?.type ?? (err as { code?: unknown }).code;\n  const readable =\n    typeof code === \"string\" && status === 409\n      ? CONFLICT_MESSAGES[code]\n      : undefined;\n  process.stderr.write(\n    JSON.stringify({\n      error: readable ?? message,\n      ...(status ? { status } : {}),\n      ...(typeof code === \"string\" ? { code } : {}),\n    }) + \"\\n\",\n  );\n  process.exitCode = 1;\n}\n\n/** What a plan change's 409 means for whoever ran it. */\nconst CONFLICT_MESSAGES: Record<string, string> = {\n  card_funding_pending: CARD_FUNDING_PENDING_MESSAGE,\n  plan_charge_changed:\n    \"The plan's monthly total changed since it was shown (another change was made meanwhile). Nothing was changed; run the command again to see the new total.\",\n  payment_method_changed:\n    \"The saved payment method changed while the plan was checked. Nothing was changed; run the command again.\",\n};\n\nfunction run(action: () => Promise<void>): Promise<void> {\n  return action().catch(fail);\n}\n\nfunction limitOf(raw: string | undefined): number | undefined {\n  if (raw === undefined) return undefined;\n  if (!/^\\d+$/.test(raw.trim())) {\n    throw new BillingError(`--limit must be a whole number, not \"${raw}\".`);\n  }\n  return Number(raw.trim());\n}\n\nfunction onOff(raw: string | undefined, flag: string): boolean | undefined {\n  if (raw === undefined) return undefined;\n  const value = raw.trim().toLowerCase();\n  if (value === \"on\") return true;\n  if (value === \"off\") return false;\n  throw new BillingError(`${flag} is on or off, not \"${raw}\".`);\n}\n\n/** Print a fresh Stripe link and, with --open, open it. A credit note has\n *  only a PDF. `opened` is true only when the opener finished cleanly,\n *  \"attempted\" when it was still running, and false otherwise. */\nasync function showLink(\n  ctx: CommandContext,\n  id: string,\n  link: StripeLink,\n  open: boolean,\n): Promise<void> {\n  const target = link.url || link.pdf_url;\n  let result: OpenResult = { opened: false };\n  if (open) {\n    result = target\n      ? await openInBrowser(target)\n      : { opened: false, reason: \"The response had no link to open.\" };\n  }\n  ctx.output({\n    id: Number(id),\n    url: link.url,\n    pdf_url: link.pdf_url,\n    opened: result.opened,\n    ...(result.reason ? { open_error: result.reason } : {}),\n    note: \"Stripe links expire; run this again for a fresh one.\",\n  });\n}\n\n/**\n * Print what a buy or pay-now returned. The API answers 201 whatever the\n * charge's outcome, so a declined card is read from the purchase's status:\n * the result is printed, then a JSON error on stderr and a non-zero exit.\n * A pending or processing charge exits 0 with a note saying so.\n */\nexport function reportCharge(\n  ctx: CommandContext,\n  result: Record<string, unknown>,\n  what: string,\n): void {\n  const outcome = chargeOutcome(\n    result.credit_purchase as Record<string, unknown> | null | undefined,\n    what,\n  );\n  if (outcome.kind === \"pending\") {\n    ctx.output({ ...result, pending: true, note: outcome.note });\n    return;\n  }\n  ctx.output(result);\n  if (outcome.kind === \"declined\") {\n    process.stderr.write(\n      JSON.stringify({\n        error: outcome.message,\n        code:\n          outcome.status === \"failed\"\n            ? \"charge_declined\"\n            : `charge_${outcome.status || \"unknown\"}`,\n        charge_status: outcome.status || null,\n        ...(outcome.reason ? { reason: outcome.reason } : {}),\n      }) + \"\\n\",\n    );\n    process.exitCode = 1;\n  }\n}\n\nconst LIMITS_NOTE =\n  \"AI limits stop new AI work once reached; orders and hosting limits only notify and never stop anything; Studios limits are recorded and notified, not enforced.\";\n\nexport function registerBillingCommands(\n  parent: Command,\n  ctx: CommandContext,\n): void {\n  parent\n    .command(\"show\")\n    .description(\n      \"Show the billing page: invoices, upcoming charge, payment method and terms\",\n    )\n    .action(() =>\n      run(async () => ctx.output(await showBilling(await client(ctx)))),\n    );\n\n  parent\n    .command(\"update\")\n    .description(\n      \"Set where invoices and billing emails go (the only billing field a merchant sets)\",\n    )\n    .requiredOption(\n      \"--email <address>\",\n      'Billing email address, or \"none\" to stop billing emails',\n    )\n    .option(\"--yes\", \"Confirm without a prompt\", false)\n    .action((opts: { email: string; yes: boolean }) =>\n      run(async () => {\n        const email =\n          opts.email.trim().toLowerCase() === \"none\" ? null : opts.email.trim();\n        await confirmChange(\n          email\n            ? `Send this company's invoices and billing emails to ${email}?`\n            : \"Clear the billing email? Fluid then sends no billing email until one is set.\",\n          opts.yes,\n        );\n        ctx.output(await setBillingEmail(await client(ctx), email));\n      }),\n    );\n\n  parent\n    .command(\"standing\")\n    .description(\n      \"Show the company's billing standing (invoiced companies only)\",\n    )\n    .action(() =>\n      run(async () => ctx.output(await showStanding(await client(ctx)))),\n    );\n\n  parent\n    .command(\"instrument <bank-account-id>\")\n    .description(\n      \"Collect from a saved bank account whose ACH authorization was already given in the admin; a new account or card is set up in the admin\",\n    )\n    .option(\"--yes\", \"Confirm without a prompt\", false)\n    .action((bankAccountId: string, opts: { yes: boolean }) =>\n      run(async () => {\n        await confirmChange(\n          `Collect this company's billing from bank account ${bankAccountId}?`,\n          opts.yes,\n        );\n        ctx.output(await useBankAccount(await client(ctx), bankAccountId));\n      }),\n    );\n\n  const payments = parent\n    .command(\"payments\")\n    .description(\n      \"List pulls from the company's bank account or card, newest first\",\n    )\n    .option(\"--limit <n>\", \"Only the newest n\")\n    .action((opts: { limit?: string }) =>\n      run(async () =>\n        ctx.output(await listPayments(await client(ctx), limitOf(opts.limit))),\n      ),\n    );\n\n  payments\n    .command(\"invoice <id>\")\n    .description(\"Get a fresh Stripe invoice link for one payment\")\n    .option(\"--open\", \"Open the link in the default browser\", false)\n    .action((id: string, opts: { open: boolean }) =>\n      run(async () =>\n        showLink(\n          ctx,\n          id,\n          await paymentInvoice(await client(ctx), id),\n          opts.open,\n        ),\n      ),\n    );\n\n  const documents = parent\n    .command(\"documents\")\n    .description(\n      \"List Stripe documents (paid invoices and credit notes), newest first\",\n    )\n    .option(\"--limit <n>\", \"Only the newest n\")\n    .action((opts: { limit?: string }) =>\n      run(async () =>\n        ctx.output(await listDocuments(await client(ctx), limitOf(opts.limit))),\n      ),\n    );\n\n  documents\n    .command(\"link <id>\")\n    .description(\"Get a fresh Stripe link for one document\")\n    .option(\"--open\", \"Open the link in the default browser\", false)\n    .action((id: string, opts: { open: boolean }) =>\n      run(async () =>\n        showLink(ctx, id, await documentLink(await client(ctx), id), opts.open),\n      ),\n    );\n\n  registerCreditCommands(parent, ctx);\n  registerLimitCommands(parent, ctx);\n\n  const usage = parent.command(\"usage\").description(\"Report billable usage\");\n\n  usage\n    .command(\"record\")\n    .description(\n      \"Record one usage event (needs billing.create_usage, with a company admin's or the company's own token; Droplet tokens are refused, and Mist AI usage goes through Mist)\",\n    )\n    .requiredOption(\"--sku <sku>\", \"Active billing product code\")\n    .requiredOption(\"--quantity <n>\", \"Whole number of units\")\n    .requiredOption(\n      \"--dedup-key <key>\",\n      \"Your id for this event; a repeat with the same SKU and key records nothing\",\n    )\n    .option(\n      \"--occurred-at <iso8601>\",\n      \"When it happened, with a zone (default: now)\",\n    )\n    .option(\"--evidence <json>\", \"JSON object stored with the event\")\n    .option(\"--yes\", \"Confirm without a prompt\", false)\n    .action(\n      (opts: {\n        sku: string;\n        quantity: string;\n        dedupKey: string;\n        occurredAt?: string;\n        evidence?: string;\n        yes: boolean;\n      }) =>\n        run(async () => {\n          await confirmChange(\n            `Record ${opts.quantity} of ${opts.sku} as billable usage?`,\n            opts.yes,\n          );\n          ctx.output(await recordUsage(await client(ctx), opts));\n        }),\n    );\n}\n\nfunction registerCreditCommands(parent: Command, ctx: CommandContext): void {\n  const credits = parent\n    .command(\"credits\")\n    .description(\"Show the credit balance, the plan and what more credits cost\")\n    .action(() =>\n      run(async () => ctx.output(await showCredits(await client(ctx)))),\n    );\n\n  credits\n    .command(\"plan [plan-key]\")\n    .description(\n      \"Choose the plan from the 1st of next month (invoiced companies only)\",\n    )\n    .option(\"--interval <interval>\", \"monthly or annual\")\n    .option(\n      \"--monthly-price <dollars>\",\n      \"Size the plan to a monthly price between the catalog's\",\n    )\n    .option(\"--keep-current\", \"Drop the plan chosen for next month\", false)\n    .option(\"--yes\", \"Confirm without a prompt\", false)\n    .action(\n      (\n        planKey: string | undefined,\n        opts: {\n          interval?: \"monthly\" | \"annual\";\n          monthlyPrice?: string;\n          keepCurrent: boolean;\n          yes: boolean;\n        },\n      ) =>\n        run(async () => {\n          let choice: PlanChoice;\n          if (opts.keepCurrent) {\n            if (planKey || opts.interval || opts.monthlyPrice) {\n              throw new BillingError(\n                \"--keep-current takes no plan, --interval or --monthly-price.\",\n              );\n            }\n            choice = { keepCurrentPlan: true };\n          } else {\n            choice = {\n              planKey,\n              billingInterval: opts.interval,\n              monthlyPriceCents:\n                opts.monthlyPrice === undefined\n                  ? undefined\n                  : parseDollars(opts.monthlyPrice, {\n                      label: \"--monthly-price\",\n                    }),\n            };\n          }\n          const api = await client(ctx);\n          const { question, charge } = await preparePlanChoice(api, choice);\n          await confirmChange(question, opts.yes);\n          ctx.output(await choosePlan(api, choice, charge));\n        }),\n    );\n\n  credits\n    .command(\"movements\")\n    .description(\"List every change to the credit balance, newest first\")\n    .option(\"--limit <n>\", \"Only the newest n\")\n    .action((opts: { limit?: string }) =>\n      run(async () =>\n        ctx.output(\n          await listCreditMovements(await client(ctx), limitOf(opts.limit)),\n        ),\n      ),\n    );\n\n  credits\n    .command(\"quote <dollars>\")\n    .description(\n      \"Price a purchase of credits: bonus, credits granted, card fee and total (whole dollars)\",\n    )\n    .action((dollars: string) =>\n      run(async () =>\n        ctx.output(\n          await quoteCredits(\n            await client(ctx),\n            parseDollars(dollars, { wholeDollars: true }),\n          ),\n        ),\n      ),\n    );\n\n  credits\n    .command(\"buy <dollars>\")\n    .description(\n      \"Buy credits with the saved payment method (whole dollars; spends real money and accepts the purchase terms)\",\n    )\n    .option(\n      \"--purchase-key <uuid>\",\n      \"Retry an earlier buy without charging twice (printed by that buy)\",\n    )\n    .option(\"--yes\", \"Confirm without a prompt\", false)\n    .action((dollars: string, opts: { purchaseKey?: string; yes: boolean }) =>\n      run(async () => {\n        const amountCents = parseDollars(dollars, { wholeDollars: true });\n        // A key is generated only when none was given. A blank one (an unset\n        // variable in a retry script) is refused: replacing it with a fresh\n        // key would turn a retry into a second charge.\n        const retrying = opts.purchaseKey !== undefined;\n        const purchaseKey = retrying\n          ? (opts.purchaseKey as string).trim()\n          : randomUUID();\n        if (retrying && !purchaseKey) {\n          throw new BillingError(\n            \"--purchase-key is empty. Pass the key printed by the earlier buy, or leave the flag out for a new purchase.\",\n          );\n        }\n        if (!/^[0-9a-f-]{36}$/i.test(purchaseKey)) {\n          throw new BillingError(\"--purchase-key must be a UUID.\");\n        }\n        const api = await client(ctx);\n        const prepared = await prepareCreditPurchase(api, amountCents);\n        await confirmChange(\n          retrying\n            ? purchaseRetryQuestion(purchaseKey, prepared.question)\n            : prepared.question,\n          opts.yes,\n        );\n        let bought: Record<string, unknown>;\n        try {\n          bought = await buyCredits(api, prepared, purchaseKey);\n        } catch (err) {\n          // Whether the charge went through can be unknown, so the key that\n          // makes a retry charge once goes with the error.\n          if (err instanceof Error) {\n            err.message = `${err.message} (purchase key ${purchaseKey}; check \\`fluid billing credits purchases\\`, and retry with --purchase-key ${purchaseKey} rather than a new buy)`;\n            const body = (err as { body?: { error_message?: unknown } | null })\n              .body;\n            if (body && typeof body.error_message === \"string\") {\n              body.error_message = err.message;\n            }\n          }\n          throw err;\n        }\n        reportCharge(ctx, bought, \"purchase\");\n      }),\n    );\n\n  const purchases = credits\n    .command(\"purchases\")\n    .description(\"List credit purchases, newest first\")\n    .option(\"--limit <n>\", \"Only the newest n\")\n    .action((opts: { limit?: string }) =>\n      run(async () =>\n        ctx.output(\n          await listCreditPurchases(await client(ctx), limitOf(opts.limit)),\n        ),\n      ),\n    );\n\n  purchases\n    .command(\"invoice <id>\")\n    .description(\"Get a fresh Stripe invoice link for one purchase\")\n    .option(\"--open\", \"Open the link in the default browser\", false)\n    .action((id: string, opts: { open: boolean }) =>\n      run(async () =>\n        showLink(\n          ctx,\n          id,\n          await purchaseInvoice(await client(ctx), id),\n          opts.open,\n        ),\n      ),\n    );\n\n  credits\n    .command(\"pay-now\")\n    .description(\n      \"Charge the saved payment method now for what the credits are overdrawn by (spends real money)\",\n    )\n    .option(\"--yes\", \"Confirm without a prompt\", false)\n    .action((opts: { yes: boolean }) =>\n      run(async () => {\n        const api = await client(ctx);\n        const prepared = await preparePayNow(api);\n        await confirmChange(prepared.question, opts.yes);\n        reportCharge(\n          ctx,\n          await payNow(api, prepared.payNow.total_cents),\n          \"payment\",\n        );\n      }),\n    );\n}\n\nfunction registerLimitCommands(parent: Command, ctx: CommandContext): void {\n  const limits = parent\n    .command(\"limits\")\n    .description(`Show spend limits and auto-reload. ${LIMITS_NOTE}`)\n    .action(() =>\n      run(async () => ctx.output(await showLimits(await client(ctx)))),\n    );\n\n  const dollars = \"<dollars|none>\";\n  limits\n    .command(\"set\")\n    .description(\n      `Change spend limits and auto-reload; options left out keep their value. Amounts are dollars; \"none\" clears a limit or restores Fluid's default reload figure. ${LIMITS_NOTE}`,\n    )\n    .option(\"--limits <on|off>\", \"Turn the spend limits on or off\")\n    .option(`--ai-monthly ${dollars}`, \"Monthly AI limit\")\n    .option(`--ai-daily ${dollars}`, \"Daily AI limit\")\n    .option(`--studios-monthly ${dollars}`, \"Monthly Fluid Studios limit\")\n    .option(`--studios-daily ${dollars}`, \"Daily Fluid Studios limit\")\n    .option(`--orders-monthly ${dollars}`, \"Monthly orders limit (notifies)\")\n    .option(`--hosting-monthly ${dollars}`, \"Monthly hosting limit (notifies)\")\n    .option(\n      \"--auto-reload <on|off>\",\n      \"Buy credits with the saved card when the balance runs low; on accepts the reload authorization\",\n    )\n    .option(`--reload-threshold ${dollars}`, \"Reload below this balance\")\n    .option(`--reload-amount ${dollars}`, \"What one reload buys\")\n    .option(`--reload-daily-cap ${dollars}`, \"Most reloaded in a day\")\n    .option(`--reload-monthly-cap ${dollars}`, \"Most reloaded in a month\")\n    .option(\"--yes\", \"Confirm without a prompt\", false)\n    .action((opts: Record<string, string | boolean | undefined>) =>\n      run(async () => {\n        const money = (key: string, whole = false) => {\n          const raw = opts[key];\n          return typeof raw === \"string\"\n            ? parseDollarsOrNone(raw, {\n                wholeDollars: whole,\n                label: `--${key.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`)}`,\n              })\n            : undefined;\n        };\n        const changes: LimitChanges = {\n          limitsEnabled: onOff(opts.limits as string | undefined, \"--limits\"),\n          aiMonthly: money(\"aiMonthly\"),\n          aiDaily: money(\"aiDaily\"),\n          studiosMonthly: money(\"studiosMonthly\"),\n          studiosDaily: money(\"studiosDaily\"),\n          ordersMonthly: money(\"ordersMonthly\"),\n          hostingMonthly: money(\"hostingMonthly\"),\n          autoReload: onOff(\n            opts.autoReload as string | undefined,\n            \"--auto-reload\",\n          ),\n          reloadThreshold: money(\"reloadThreshold\", true),\n          reloadAmount: money(\"reloadAmount\", true),\n          reloadDailyCap: money(\"reloadDailyCap\"),\n          reloadMonthlyCap: money(\"reloadMonthlyCap\"),\n        };\n        const api = await client(ctx);\n        // Only turning auto-reload on reads the controls in force.\n        const current =\n          changes.autoReload === true ? await showLimits(api) : {};\n        const { body, question } = limitsUpdate(current, changes);\n        await confirmChange(question, opts.yes === true);\n        ctx.output(await setLimits(api, body));\n      }),\n    );\n}\n\nconst plugin: FluidPlugin = {\n  name: \"@fluid-app/fluid-cli-billing\",\n  version: \"0.1.0\",\n  register(ctx) {\n    ctx.program.addCommand(\n      createDomainCommand(\n        \"billing\",\n        \"Read the company's billing and manage its credits and spend limits\",\n        registerBillingCommands,\n      ),\n    );\n  },\n};\n\nexport default plugin;\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,84 @@
 {
   "name": "@fluid-app/fluid-cli-billing",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Fluid CLI plugin for company billing — invoices, payments, credits and spend limits",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      }
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@fluid-app/fluid-cli": "0.1.50",
+    "commander": "^12.0.0",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@fluid-app/typescript-config": "0.0.0",
+    "@swc/core": "^1.15.18",
+    "@swc/jest": "^0.2.39",
+    "@types/jest": "^29.5.14",
+    "@types/node": "24.10.12",
+    "@types/prompts": "^2.4.9",
+    "jest": "^29.7.0",
+    "tsdown": "^0.21.0",
+    "typescript": "^5"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "nx": {
+    "targets": {
+      "typecheck": {
+        "dependsOn": [
+          {
+            "target": "build",
+            "projects": [
+              "@fluid-app/fluid-cli"
+            ]
+          }
+        ]
+      },
+      "test": {
+        "dependsOn": [
+          {
+            "target": "build",
+            "projects": [
+              "@fluid-app/fluid-cli"
+            ]
+          }
+        ]
+      },
+      "build": {
+        "dependsOn": [
+          "typecheck",
+          {
+            "target": "build",
+            "projects": [
+              "@fluid-app/fluid-cli"
+            ]
+          }
+        ]
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsgo --noEmit",
+    "lint": "oxlint",
+    "test": "jest"
+  }
 }