@letterstory/cli 0.177.38 → 0.177.39

package/lib/cli.mjs

@@ -88,7 +88,7 @@ import {
 import { fetchParkedSections, withoutParked } from "./parked.mjs";
 
 // Matches cli/package.json; publish-cli.yml rewrites both to the published version.
-export const VERSION = "0.177.38";
+export const VERSION = "0.177.39";
 
 /** The exit code for a gate refusal (CARD_REQUIRED, PAYMENT_FAILED, OUT_OF_TOKENS): 1 is a plain error. */
 export const EXIT_PAYMENT_REQUIRED = 3;

package/lib/commands/admin.mjs

@@ -6355,7 +6355,9 @@ const FREE_USAGE = `Usage: admin billing free exposure [--json]               wh
        admin billing free grant <org-id|name> <tokens> --why "…" [--key k]   give an org free tokens (a Lago org: a one-off wallet); the same key is one grant
        admin billing free grants [--org <org-id>] [--limit n]   staff grants, newest first, live and revoked
        admin billing free revoke <org-id> <ref> --why "…"   take a staff grant back (ref from the list: grant:<id> or wallet:staff_…)
-       admin billing free preflight [--json]               who the paywall stops the moment it is enforced, and whether it is ready`;
+       admin billing free preflight [--json]               who the paywall stops the moment it is enforced, and whether it is ready
+       admin billing free pool <org-id|name>... --why "…"   link orgs on free tokens so they spend from one balance
+       admin billing free unpool <org-id|name> --why "…"    take an org out of its shared balance`;
 
 const EXPOSURE_WORDS = {
 	needs_legacy: "pay today: need a legacy mark (admin billing legacy mark --all)",
@@ -6457,6 +6459,28 @@ async function cmdAdminBillingFree(ctx) {
 		});
 		return 0;
 	}
+	if (positionals[1] === "pool" || positionals[1] === "unpool") {
+		const pool = positionals[1] === "pool";
+		const args = positionals.slice(2);
+		if (pool ? args.length < 2 : args.length !== 1) throw new CliError(FREE_USAGE);
+		const why = flagStr(flags.why);
+		if (!why) throw new CliError(`Say why (--why "…"): it is kept with the change.\n${FREE_USAGE}`);
+		const orgIds = [];
+		for (const a of args) orgIds.push((await resolveBillingOrg(ctx, a)).orgId);
+		const r = pool
+			? await staffPost(ctx, "/api/superadmin/billing/token-pools", { orgIds, why })
+			: await staffRequest(ctx, "DELETE", "/api/superadmin/billing/token-pools", { orgId: orgIds[0], why });
+		printResult(io, flags, r, (x) =>
+			pool
+				? `Sharing one token balance (${x.poolId}):\n${x.orgs.map((o) => `  ${o.name}  ${o.orgId}`).join("\n")}`
+				: !x.changed
+					? `${orgIds[0]} is in no pool; nothing changed.`
+					: x.left.length
+						? `Taken out. Still sharing: ${x.left.map((o) => o.name).join(", ")}.`
+						: "Taken out. The pool had one org left, so it ended."
+		);
+		return 0;
+	}
 	if (positionals[1] === "grant") {
 		const [orgArg, tokensArg] = [positionals[2], positionals[3]];
 		const tokens = Number(String(tokensArg ?? "").replace(/[,_]/g, ""));

package/package.json

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