@letterstory/cli 0.146.1 → 0.147.0

package/lib/cli.mjs

@@ -65,7 +65,7 @@ import {
 
 // Matches cli/package.json; publish-cli.yml rewrites both to the published version.
 // Matches cli/package.json; publish-cli.yml rewrites both to the published version.
-export const VERSION = "0.146.1";
+export const VERSION = "0.147.0";
 
 // Flags that never take a value. Listing them explicitly means `deploy get --json <id>`
 // can't accidentally swallow the id as --json's value. Every `type: "bool"` flag (and its
@@ -945,7 +945,7 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
           | reconcile [--org <org-id>] | forward
           | payments [--org <org-id>] [--open] | payments retry <lago-invoice-id> | payments run [--dry]
           | signups [--status open|card_saved|provisioned|paid|abandoned]
-          | cap <org-id> <dollars|off> [--why "…"]
+          | cap <org-id> <dollars|off> [--why "…"] | cancel <org-id> --why "…" --yes
                                                        Usage billing on Lago: the plan catalog, an org's
                                                        plan and gifted ratio, Lago's tokens against ours,
                                                        forwarding usage now, failed payments and the
@@ -1103,7 +1103,7 @@ Seers (event-driven signals -> drafts):
   org export --split <dir>                             …as one file per record (for keeping config in git)
   org join <dir> [--file <path>]                       Rebuild the bundle from a --split directory
   org integrations                                     Every integration and whether it's connected
-  org billing [cap <dollars|off> [--why "…"] | request [--note "…"]]
+  org billing [cap <dollars|off> [--why "…"] | request [--note "…"] | cancel [--why "…"] --yes]
                                                        Usage billing: plan, this period against the
                                                        allowance and spend cap, failed payments; set
                                                        the cap (admins) or ask the admins for more

package/lib/commands/admin.mjs

@@ -5213,7 +5213,8 @@ const LAGO_USAGE = `Usage: admin billing lago <command>
   payments retry <lago-invoice-id>       charge one failed invoice again now
   payments run [--dry]                   one pass of the failed-payment loop now (--dry: report only)
   signups [--status open|card_saved|provisioned|paid|abandoned]   new paying orgs on their way onto Lago
-  cap <org-id> <dollars|off> [--why "…"]  set an account's monthly spend cap on overage (off: no cap)`;
+  cap <org-id> <dollars|off> [--why "…"]  set an account's monthly spend cap on overage (off: no cap)
+  cancel <org-id> --why "…" --yes          end an account's Lago plan now and refund its first invoice`;
 
 /** admin billing lago … — staff operations on Lago (docs/billing/lago-integration.md). */
 async function cmdAdminBilling(ctx) {
@@ -5336,6 +5337,23 @@ async function cmdAdminBilling(ctx) {
 			);
 			return 0;
 		}
+		case "cancel": {
+			const orgId = positionals[2];
+			if (!orgId || !flagStr(flags.why)) throw new CliError(LAGO_USAGE);
+			if (!flagBool(flags.yes))
+				throw new CliError(
+					"This ends the plan now and refunds its first invoice. Run again with --yes to do it."
+				);
+			const result = await staffRequest(ctx, "POST", `${LAGO}/cancel`, { orgId, reason: flagStr(flags.why) });
+			printResult(
+				io,
+				flags,
+				result,
+				(r) =>
+					`Cancelled ${orgId}: first invoice ${r.firstInvoice}${r.refundedCents ? `, $${(r.refundedCents / 100).toFixed(2)} refunded` : ""}.`
+			);
+			return 0;
+		}
 		case "cap": {
 			const orgId = positionals[2];
 			const value = positionals[3];

package/lib/commands/org.mjs

@@ -33,6 +33,7 @@ export const ARGS = {
 		reason: { flag: "why" },
 	},
 	request_billing_tokens: { note: { flag: "note" } },
+	cancel_billing_plan: { reason: { flag: "why" } },
 	list_integrations: {},
 	get_linear_connection: {},
 	list_linear_targets: { team_id: { flag: "team" } },
@@ -125,6 +126,20 @@ async function orgBilling(ctx) {
 		);
 		return 0;
 	}
+	if (positionals[0] === "cancel") {
+		refuseUnknownFlags(ctx, ARGS.cancel_billing_plan, ["yes"]);
+		if (!flagBool(flags.yes))
+			throw new CliError("This ends the plan now and refunds its first invoice. Run again with --yes to do it.");
+		const result = await client.callTool("cancel_billing_plan", argsFromFlags(ARGS.cancel_billing_plan, flags, []));
+		printResult(io, flags, result, (r) =>
+			r.firstInvoice === "refunded"
+				? `Plan cancelled; $${(r.refundedCents / 100).toFixed(2)} refunded to the card.`
+				: r.firstInvoice === "voided"
+					? "Plan cancelled; its unpaid first invoice is voided."
+					: "Plan cancelled."
+		);
+		return 0;
+	}
 	if (positionals[0] === "request") {
 		refuseUnknownFlags(ctx, ARGS.request_billing_tokens, []);
 		const result = await client.callTool(

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@letterstory/cli",
-	"version": "0.146.1",
+	"version": "0.147.0",
 	"description": "Spin up and manage Letterstory phantom blogs from your terminal.",
 	"type": "module",
 	"license": "UNLICENSED",