@letterstory/cli 0.148.4 → 0.149.0

package/lib/cli.mjs

@@ -66,7 +66,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.148.4";
+export const VERSION = "0.149.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
@@ -971,6 +971,8 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
           | 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 "…"] | cancel <org-id> --why "…" --yes
+          | move <org-id> --plan starter|growth|scale [--ratio N [--why "…"]] [--reason "…"] [--stripe-subscription sub_…] [--dry]
+          | changes [--org <org-id>] | changes cancel <org-id>
                                                        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

package/lib/commands/admin.mjs

@@ -5215,7 +5215,11 @@ const LAGO_USAGE = `Usage: admin billing lago <command>
   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)
-  cancel <org-id> --why "…" --yes          end an account's Lago plan now and refund its first invoice`;
+  cancel <org-id> --why "…" --yes          end an account's Lago plan now and refund its first invoice
+  move <org-id> --plan starter [--ratio 4] [--why "…" above 4x] [--reason "…"] [--complimentary 20000] [--review 2027-05-01] [--stripe-subscription sub_…] [--dry]
+                                         move an existing customer from Stripe to Lago at their renewal
+  changes [--org <org-id>]               term changes waiting to take effect (moves, cheaper plans, new ratios)
+  changes cancel <org-id>                take back an org's scheduled change before it takes effect`;
 
 /** admin billing lago … — staff operations on Lago (docs/billing/lago-integration.md). */
 async function cmdAdminBilling(ctx) {
@@ -5259,7 +5263,9 @@ async function cmdAdminBilling(ctx) {
 			);
 			ok(
 				ctx,
-				`${result.action === "created" ? "On Lago" : "Already on Lago"}: ${result.subscriptionId}, ${result.includedTokens} tokens included, overage $${result.overageUsdPerToken} a token, from ${result.startsAt}.`
+				result.action === "scheduled"
+					? `Scheduled: from ${result.effectiveAt}, ${result.includedTokens} tokens included, overage $${result.overageUsdPerToken} a token (Lago bills today's terms until then).`
+					: `${result.action === "created" ? "On Lago" : "Already on Lago"}: ${result.subscriptionId}, ${result.includedTokens} tokens included, overage $${result.overageUsdPerToken} a token, from ${result.startsAt}.`
 			);
 			printResult(io, flags, result);
 			return 0;
@@ -5360,6 +5366,55 @@ async function cmdAdminBilling(ctx) {
 			);
 			return 0;
 		}
+		case "move": {
+			const orgId = requirePositional(positionals, 2, "org-id");
+			const plan = flagStr(flags.plan);
+			if (!plan) throw new CliError(LAGO_USAGE);
+			const result = await staffPost(
+				ctx,
+				`${LAGO}/move`,
+				compact({
+					orgId,
+					planCode: plan,
+					ratio: flagNum(flags.ratio),
+					exceptionReason: flagStr(flags.why),
+					reason: flagStr(flags.reason),
+					complimentaryTokens: flagNum(flags.complimentary),
+					reviewAt: flagStr(flags.review),
+					stripeSubscriptionId: flagStr(flags["stripe-subscription"]),
+					dryRun: flags.dry ? true : undefined,
+				})
+			);
+			const p = result.plan;
+			ok(
+				ctx,
+				`${result.dryRun ? "Would move" : "Moving"} ${p.orgId} from Stripe ${p.from.stripeSubscriptionId} (${p.from.product ?? "subscription"}) to Lago ${p.to.plan} at its renewal ${p.from.renewsAt}: Stripe stops then, Lago charges $${(p.to.amountCents / 100).toFixed(2)} then (${p.to.includedTokens} tokens included, overage $${p.to.overageUsdPerToken} a token).`
+			);
+			printResult(io, flags, result);
+			return 0;
+		}
+		case "changes": {
+			if (positionals[2] === "cancel") {
+				const orgId = requirePositional(positionals, 3, "org-id");
+				const result = await staffRequest(ctx, "DELETE", `${LAGO}/changes`, { orgId });
+				ok(ctx, `Taken back: the ${result.canceled.kind} scheduled for ${result.canceled.effective_at}.`);
+				printResult(io, flags, result);
+				return 0;
+			}
+			const params = new URLSearchParams(compact({ orgId: flagStr(flags.org) }));
+			const result = await staffRequest(ctx, "GET", `${LAGO}/changes${params.size ? `?${params}` : ""}`);
+			printResult(io, flags, result, (r) =>
+				r.changes.length
+					? r.changes
+							.map(
+								(c) =>
+									`${c.effective_at}  ${c.kind.padEnd(9)} ${c.organizations?.name ?? c.org_id} → ${c.plan_code} ${c.ratio}x (by ${c.requested_by}${c.last_error ? `; waiting: ${c.last_error}` : ""})`
+							)
+							.join("\n")
+					: "Nothing scheduled."
+			);
+			return 0;
+		}
 		case "cap": {
 			const orgId = positionals[2];
 			const value = positionals[3];

package/package.json

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