@usesocial/cli 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @usesocial/cli
 
+## 0.5.0
+
+### Minor Changes
+
+- [#29](https://github.com/usesocial/monorepo/pull/29) [`f99f1b3`](https://github.com/usesocial/monorepo/commit/f99f1b3da1215c74a1044aac3aed210604562fcc) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Add `social account billing` and `social account billing portal` for CLI billing status and hosted portal handoff.
+
 ## 0.4.0
 
 ### Minor Changes

package/README.md

@@ -90,7 +90,7 @@ stdin; if stdin parses as JSON but is not an object, the command rejects it.
 
 | Command | Description |
 |---|---|
-| `social account` | Show auth state and connected accounts; login, logout, connect accounts, inspect usage/logs, and configure local CLI settings. |
+| `social account` | Show auth state and connected accounts; login, logout, connect accounts, inspect billing/usage/logs, and configure local CLI settings. |
 | `social schema` | Print the compact command tree, inspect one command with `social schema "<command path>"`, or emit agent command contracts with `social schema --leaves`. |
 | `social x <…>` | X operations (below). |
 | `social linkedin <…>` | LinkedIn operations (below). |
@@ -108,6 +108,8 @@ stdin; if stdin parses as JSON but is not an object, the command rejects it.
 | `reconnect x <account>` | Re-auth an existing X account by opening or printing an OAuth URL. | ✎ write |
 | `disconnect linkedin <account>` | Disconnect a LinkedIn account. | ✎ write |
 | `disconnect x <account>` | Disconnect an X account. | ✎ write |
+| `billing` | Show seats, subscription, and current usage billing. | |
+| `billing portal` | Open the hosted billing portal and print its URL. | |
 | `usage` | Aggregate proxy usage and billing stats. | |
 | `logs` | Recent proxy calls. | |
 | `config cache mode` | Read or set the cache mode preset. | |
@@ -227,6 +229,11 @@ namespace, verified session when available, and connected accounts.
 `social account login` requires an interactive terminal and is not supported from CI,
 background jobs, or agent-mediated setup flows.
 
+`social account billing` prints the current seat/subscription snapshot plus
+aggregate usage billing. `social account billing portal` opens the hosted billing
+portal when possible and always prints the portal URL as JSON; use the portal for
+payment methods, invoices, plan changes, seat changes, and cancellation.
+
 ## Cache config
 
 Allowlisted GET requests use a local proxy cache. Cacheable commands send
@@ -266,8 +273,9 @@ social linkedin messages --limit 20 | jq '{cost: .meta.cost, cursor: .meta.curso
 social x bookmarks --limit 20 | jq '{cost: .meta.cost, cursor: .meta.cursor}'
 ```
 
-Agents should watch `.meta.cost` during high-fanout loops and use `social account usage`
-or `social account logs` after a run to summarize actual spend.
+Agents should watch `.meta.cost` during high-fanout loops, use `social account billing`
+for the current plan snapshot, and use `social account usage` or `social account logs`
+after a run to summarize actual spend.
 
 ## Account safety
 
@@ -300,6 +308,8 @@ echo "gm" | social x post
 social linkedin post < draft.md
 
 # Usage / billing
+social account billing
+social account billing portal
 social account usage
 social account logs --limit 20 --from 2026-05-01T00:00:00Z
 

package/dist/index.d.mts

@@ -1377,16 +1377,14 @@ declare const createSocialCommand: (deps?: {
       disconnect: any;
     };
     billing: {
-      status: () => Promise<{
-        canConnect: any;
-        seats: any;
-      }>;
+      status: () => Promise<any>;
       prepareAccountConnect: () => Promise<{
         canConnect: any;
         paymentURL: any;
         requiredAction: any;
         seats: any;
       }>;
+      portalURL: any;
     };
     usage: {
       summary: any;

package/dist/index.mjs

@@ -21110,7 +21110,7 @@ const createInstance = (defaults) => {
 const ky = createInstance();
 //#endregion
 //#region package.json
-var version$1 = "0.4.0";
+var version$1 = "0.5.0";
 //#endregion
 //#region src/lib/env.ts
 const URLWithTrailingSlash = url().transform(ensureTrailingSlash);
@@ -22038,6 +22038,102 @@ const configCommand = defineCommand({
 	}) }
 });
 //#endregion
+//#region src/billing/index.ts
+const readAuthContract$1 = {
+	required: true,
+	scope: "read"
+};
+const BillingOutput = object({
+	seats: object({
+		total: number().int().nonnegative(),
+		used: number().int().nonnegative(),
+		available: number().int().nonnegative()
+	}),
+	subscription: object({
+		active: boolean$1(),
+		quantity: number().int().nonnegative(),
+		currentPeriodEnd: string().nullable()
+	}).nullable(),
+	usage: object({
+		calls: object({ total: number().int().nonnegative() }),
+		credits: object({
+			available: number().nonnegative(),
+			used: number().nonnegative(),
+			additional: number().nonnegative()
+		}),
+		billing: object({
+			seats: number().nonnegative(),
+			usage: number().nonnegative()
+		})
+	})
+});
+const BillingPortalOutput = object({
+	url: string(),
+	opened: boolean$1()
+});
+const writeOutput$2 = async (deps, value) => {
+	if (deps.writeOutput) {
+		await deps.writeOutput(value);
+		return;
+	}
+	printData(value);
+};
+const clientFrom = (deps) => deps.client ?? createORPCAPIClient();
+const createBillingCommand = (deps = {}) => {
+	const portal = defineCommand({
+		meta: commandMeta({
+			name: "portal",
+			description: "Open the hosted billing portal.",
+			capability: "read",
+			contract: {
+				capability: "read",
+				auth: readAuthContract$1,
+				mutates: false,
+				outputSchema: BillingPortalOutput,
+				confirmation: {
+					required: true,
+					reason: "Opens a hosted billing portal where payment methods, seats, plan, and cancellation can be managed."
+				},
+				hazards: [{
+					code: "billing_portal_handoff",
+					message: "Hosted billing portal handoff; billing changes happen outside the CLI after the URL opens."
+				}]
+			}
+		}),
+		run: async () => {
+			const { url } = await clientFrom(deps).billing.portalURL();
+			const result = deps.isInteractiveTerminal?.() === true && deps.openURL !== void 0 ? await deps.openURL?.(url) : void 0;
+			await writeOutput$2(deps, {
+				url: result?.url ?? url,
+				opened: result?.opened === true
+			});
+		}
+	});
+	return defineCommand({
+		meta: commandMeta({
+			name: "billing",
+			description: "Show billing status and manage the hosted billing portal.",
+			capability: "read",
+			contract: {
+				capability: "read",
+				auth: readAuthContract$1,
+				mutates: false,
+				outputSchema: BillingOutput
+			}
+		}),
+		subCommands: { portal },
+		run: async () => {
+			const client = clientFrom(deps);
+			const [status, usage] = await Promise.all([client.billing.status(), client.usage.summary({})]);
+			await writeOutput$2(deps, {
+				seats: status.seats,
+				subscription: status.subscription,
+				usage
+			});
+		}
+	});
+};
+//#endregion
 //#region ../../node_modules/.bun/posthog-node@5.35.6+63120419cc93e79b/node_modules/posthog-node/dist/extensions/error-tracking/modifiers/module.node.mjs
 function createModulerModifier() {
 	const getModuleFromFileName = createGetModuleFromFilename();
@@ -28469,6 +28565,7 @@ const createAccountCommand = (deps) => {
 				})
 			}
 		}),
+		billing: createBillingCommand(deps),
 		usage: createUsageCommand(deps),
 		logs: createUsageLogsCommand(deps),
 		config: configCommand
@@ -28700,11 +28797,7 @@ const createCLIDeps = () => {
 			},
 			billing: {
 				status: async () => {
-					const status = await client.billing.status();
-					return {
-						canConnect: status.canConnect,
-						seats: status.seats
-					};
+					return await client.billing.status();
 				},
 				prepareAccountConnect: async () => {
 					const status = await client.billing.prepareAccountConnect();
@@ -28714,7 +28807,8 @@ const createCLIDeps = () => {
 						requiredAction: status.requiredAction,
 						seats: status.seats
 					};
-				}
+				},
+				portalURL: client.billing.portalURL
 			},
 			usage: {
 				summary: client.usage.summary,