@usesocial/cli 0.3.6 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @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
+
+- [#25](https://github.com/usesocial/monorepo/pull/25) [`1121b7c`](https://github.com/usesocial/monorepo/commit/1121b7c938bfb213606722247d50a5eafca138c4) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Add `social feedback bug|feature` — submit a bug report or feature request by piping text via stdin (`echo "..." | social feedback bug`). Each submission is captured server-side and acknowledged with a reference id.
+
 ## 0.3.6
 
 ### Patch 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,21 +1377,22 @@ 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;
       list: any;
     };
+    feedback: {
+      submit: any;
+    };
   };
   api: KyInstance;
   parseResourceId: (name: string, value: unknown) => string;

package/dist/index.mjs

@@ -9740,6 +9740,14 @@ pgTable("profiles", {
 	index$1("profiles_platform_handle_idx").on(table.platform, table.handle),
 	check("profiles_platform_check", sql`${table.platform} in ('linkedin', 'x')`)
 ]);
+pgTable("feedback_submissions", {
+	id: text$1("id").primaryKey().$defaultFn(() => crypto.randomUUID()),
+	userId: text$1("user_id").notNull().references(() => user.id, { onDelete: "cascade" }),
+	type: text$1("type", { enum: ["bug", "feature"] }).notNull(),
+	text: text$1("text").notNull(),
+	issueNumber: integer$1("issue_number"),
+	createdAt: timestamptz("created_at").notNull().defaultNow()
+}, (table) => [index$1("feedback_submissions_user_created_idx").on(table.userId, table.createdAt.desc()), check("feedback_submissions_type_check", sql`${table.type} in ('bug', 'feature')`)]);
 pgTable("cli_session_grants", {
 	sessionId: text$1("session_id").primaryKey().references(() => session.id, { onDelete: "cascade" }),
 	userId: text$1("user_id").notNull().references(() => user.id, { onDelete: "cascade" }),
@@ -13333,8 +13341,8 @@ const dataWithAuditableWriteTarget = (op, data, body) => {
 		post_id: postId
 	};
 };
-const trimTrailingNewline$1 = (value) => value.endsWith("\r\n") ? value.slice(0, -2) : value.endsWith("\n") ? value.slice(0, -1) : value;
-const noBodyTextError$1 = (commandLabel) => new UsageError(`No body text. Pipe it via stdin: \`echo "..." | ${commandLabel}\`.`);
+const trimTrailingNewline$2 = (value) => value.endsWith("\r\n") ? value.slice(0, -2) : value.endsWith("\n") ? value.slice(0, -1) : value;
+const noBodyTextError$2 = (commandLabel) => new UsageError(`No body text. Pipe it via stdin: \`echo "..." | ${commandLabel}\`.`);
 const parseStdinBody$1 = (deps, bodyTextName, bodyTextKey, value) => {
 	try {
 		JSON.parse(value);
@@ -13350,12 +13358,12 @@ const resolveBodyTextFromStdin$1 = async (op, deps, args, commandLabel) => {
 	const displayTextArg = bodyTextDisplayKeyFor$1(op) ?? bodyTextArg;
 	const required = stdinBodyTextRequired$1(op);
 	if (deps.isStdinTTY()) {
-		if (required) throw noBodyTextError$1(commandLabel);
+		if (required) throw noBodyTextError$2(commandLabel);
 		return;
 	}
-	const piped = trimTrailingNewline$1(await deps.readStdin());
+	const piped = trimTrailingNewline$2(await deps.readStdin());
 	if (piped.length > 0) args.body = JSON.stringify(parseStdinBody$1(deps, displayTextArg, bodyTextArg, piped));
-	else if (required) throw noBodyTextError$1(commandLabel);
+	else if (required) throw noBodyTextError$2(commandLabel);
 };
 const runOperation$1 = async (op, contract, deps, args, rawArgs = []) => {
 	rejectUnsupportedArgs(commandPathFor(op), args, Object.keys(buildArgs$1(op)));
@@ -14002,11 +14010,11 @@ const buildMessageEdit = (deps) => {
 			const account = typeof args.account === "string" ? args.account : void 0;
 			const message_id = messageIdFrom(deps, args.message_id ?? positionals[1]);
 			let textInput;
-			if (deps.isStdinTTY()) throw noBodyTextError$1("social linkedin message <target> edit message_id:<id>");
-			const piped = trimTrailingNewline$1(await deps.readStdin());
+			if (deps.isStdinTTY()) throw noBodyTextError$2("social linkedin message <target> edit message_id:<id>");
+			const piped = trimTrailingNewline$2(await deps.readStdin());
 			if (piped.length > 0) textInput = piped;
 			const text = textInput === void 0 ? void 0 : deps.parseBodyText("<text>", textInput);
-			if (text === void 0) throw noBodyTextError$1("social linkedin message <target> edit message_id:<id>");
+			if (text === void 0) throw noBodyTextError$2("social linkedin message <target> edit message_id:<id>");
 			const resolved = [];
 			const chatIdResolved = await deps.resolveTarget("target", args.target ?? positionals[0], {
 				platform: "linkedin",
@@ -14085,10 +14093,10 @@ const buildMessage$1 = (deps, sendCommand) => {
 			}
 			const target = args.target ?? (Array.isArray(args._) && args._.length > 0 ? args._[0] : void 0);
 			let body;
-			if (deps.isStdinTTY()) throw noBodyTextError$1("social linkedin message <target>");
-			const piped = trimTrailingNewline$1(await deps.readStdin());
+			if (deps.isStdinTTY()) throw noBodyTextError$2("social linkedin message <target>");
+			const piped = trimTrailingNewline$2(await deps.readStdin());
 			if (piped.length > 0) body = parseStdinBody$1(deps, "text", "text", piped);
-			else throw noBodyTextError$1("social linkedin message <target>");
+			else throw noBodyTextError$2("social linkedin message <target>");
 			if (target === void 0) throw new UsageError("Pass a conversation or person target.");
 			if (body === void 0 || typeof body.text !== "string") throw new UsageError("Pass body text via stdin.");
 			const account = typeof args.account === "string" ? args.account : void 0;
@@ -17423,8 +17431,8 @@ const withEchoedTargetId = (op, data, body) => {
 		}
 	};
 };
-const trimTrailingNewline = (value) => value.endsWith("\r\n") ? value.slice(0, -2) : value.endsWith("\n") ? value.slice(0, -1) : value;
-const noBodyTextError = (commandLabel) => new UsageError(`No body text. Pipe it via stdin: \`echo "..." | ${commandLabel}\`.`);
+const trimTrailingNewline$1 = (value) => value.endsWith("\r\n") ? value.slice(0, -2) : value.endsWith("\n") ? value.slice(0, -1) : value;
+const noBodyTextError$1 = (commandLabel) => new UsageError(`No body text. Pipe it via stdin: \`echo "..." | ${commandLabel}\`.`);
 const parseStdinBody = (deps, bodyTextName, bodyTextKey, value) => {
 	try {
 		JSON.parse(value);
@@ -17440,12 +17448,12 @@ const resolveBodyTextFromStdin = async (op, deps, args, commandLabel) => {
 	const displayTextArg = bodyTextDisplayKeyFor(op) ?? bodyTextArg;
 	const required = stdinBodyTextRequired(op);
 	if (deps.isStdinTTY()) {
-		if (required) throw noBodyTextError(commandLabel);
+		if (required) throw noBodyTextError$1(commandLabel);
 		return;
 	}
-	const piped = trimTrailingNewline(await deps.readStdin());
+	const piped = trimTrailingNewline$1(await deps.readStdin());
 	if (piped.length > 0) args.body = JSON.stringify(parseStdinBody(deps, displayTextArg, bodyTextArg, piped));
-	else if (required) throw noBodyTextError(commandLabel);
+	else if (required) throw noBodyTextError$1(commandLabel);
 };
 const runOperation = async (op, contract, deps, args, rawArgs = []) => {
 	rejectUnknownArgs(op, args);
@@ -18019,14 +18027,14 @@ const buildMessage = (deps) => {
 			if (typeof args.body === "string") throw new UsageError("Unsupported option --body for x message.");
 			const recipientsInput = args.recipients ?? args.target ?? (Array.isArray(args._) && args._.length > 0 ? args._[0] : void 0);
 			let body;
-			if (deps.isStdinTTY()) throw noBodyTextError("social x message <recipients>");
-			const piped = trimTrailingNewline(await deps.readStdin());
+			if (deps.isStdinTTY()) throw noBodyTextError$1("social x message <recipients>");
+			const piped = trimTrailingNewline$1(await deps.readStdin());
 			if (piped.length > 0) body = parseStdinBody(deps, "text", "text", piped);
-			else throw noBodyTextError("social x message <recipients>");
+			else throw noBodyTextError$1("social x message <recipients>");
 			if (recipientsInput === void 0) throw new UsageError("Pass a conversation or user target.");
 			const recipients = String(recipientsInput).split(",").map((recipient) => recipient.trim()).filter((recipient) => recipient.length > 0);
 			if (recipients.length === 0) throw new UsageError("Pass at least one recipient.");
-			if (body === void 0) throw noBodyTextError("social x message <recipients>");
+			if (body === void 0) throw noBodyTextError$1("social x message <recipients>");
 			const resolved = [];
 			const account = typeof args.account === "string" ? args.account : void 0;
 			const selectedAccount = await deps.resolveAccount({
@@ -21102,7 +21110,7 @@ const createInstance = (defaults) => {
 const ky = createInstance();
 //#endregion
 //#region package.json
-var version$1 = "0.3.6";
+var version$1 = "0.5.0";
 //#endregion
 //#region src/lib/env.ts
 const URLWithTrailingSlash = url().transform(ensureTrailingSlash);
@@ -22030,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();
@@ -28461,6 +28565,7 @@ const createAccountCommand = (deps) => {
 				})
 			}
 		}),
+		billing: createBillingCommand(deps),
 		usage: createUsageCommand(deps),
 		logs: createUsageLogsCommand(deps),
 		config: configCommand
@@ -28493,6 +28598,66 @@ const createAccountCommand = (deps) => {
 	});
 };
 //#endregion
+//#region src/lib/stdin.ts
+const trimTrailingNewline = (value) => value.endsWith("\r\n") ? value.slice(0, -2) : value.endsWith("\n") ? value.slice(0, -1) : value;
+const noBodyTextError = (commandLabel) => new UsageError(`No body text. Pipe it via stdin: \`echo "..." | ${commandLabel}\`.`);
+const readPipedText = async (deps, commandLabel) => {
+	if (deps.isStdinTTY()) throw noBodyTextError(commandLabel);
+	const text = trimTrailingNewline(await deps.readStdin());
+	if (text.length === 0) throw noBodyTextError(commandLabel);
+	return text;
+};
+//#endregion
+//#region src/feedback/index.ts
+const submitContract = {
+	capability: "write",
+	auth: {
+		required: true,
+		scope: "read,write"
+	},
+	mutates: true,
+	outputSchema: object({
+		id: string(),
+		type: _enum(["bug", "feature"]),
+		issueNumber: number().int().nullable(),
+		createdAt: string()
+	}),
+	confirmation: false,
+	hazards: [{
+		code: "feedback_submit",
+		message: "Sends your text to the maintainers as a tracked report."
+	}]
+};
+const createSubmitCommand = (deps, type) => {
+	const noun = type === "bug" ? "bug report" : "feature request";
+	const label = `social feedback ${type}`;
+	return defineCommand({
+		meta: commandMeta({
+			name: type,
+			description: `Submit a ${noun} [write] | usage: \`echo "..." | ${label}\``,
+			capability: "write",
+			contract: submitContract
+		}),
+		run: async () => {
+			const text = await readPipedText(deps, label);
+			deps.printData(await deps.client.feedback.submit({
+				type,
+				text
+			}));
+		}
+	});
+};
+const createFeedbackCommand = (deps) => defineCommand({
+	meta: {
+		name: "feedback",
+		description: "Report a bug or request a feature."
+	},
+	subCommands: {
+		bug: createSubmitCommand(deps, "bug"),
+		feature: createSubmitCommand(deps, "feature")
+	}
+});
+//#endregion
 //#region src/lib/account.ts
 const LEADING_AT_PATTERN = /^@+/;
 const normalizeAccountIdentifier = (value) => value.trim().replace(LEADING_AT_PATTERN, "").toLowerCase();
@@ -28632,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();
@@ -28646,12 +28807,14 @@ const createCLIDeps = () => {
 						requiredAction: status.requiredAction,
 						seats: status.seats
 					};
-				}
+				},
+				portalURL: client.billing.portalURL
 			},
 			usage: {
 				summary: client.usage.summary,
 				list: client.usage.list
-			}
+			},
+			feedback: { submit: client.feedback.submit }
 		},
 		api,
 		parseResourceId,
@@ -29199,6 +29362,7 @@ const createSocialCommand = (deps = createCLIDeps()) => {
 	const accountCommand = createAccountCommand(deps);
 	const linkedinCommand = createLinkedinCommands(deps);
 	const xCommand = createXCommands(deps);
+	const feedbackCommand = createFeedbackCommand(deps);
 	const socialCommand = defineCommand({
 		meta: {
 			name: "social",
@@ -29209,7 +29373,8 @@ const createSocialCommand = (deps = createCLIDeps()) => {
 			account: accountCommand,
 			schema: schemaCommand,
 			x: xCommand,
-			linkedin: linkedinCommand
+			linkedin: linkedinCommand,
+			feedback: feedbackCommand
 		}
 	});
 	setSchemaRootCommand(socialCommand);