@usesocial/cli 0.4.0 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @usesocial/cli
 
+## 0.6.0
+
+### Minor Changes
+
+- [#30](https://github.com/usesocial/monorepo/pull/30) [`7aefe83`](https://github.com/usesocial/monorepo/commit/7aefe83f716321d7fa10d52be67cb6f96b5474f0) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Per-collection sync with a confirm-by-credits gate, a local profiles mirror, and cache-first enriched reads.
+
+  - `social x|linkedin sync <collection>` gates spend with a single `--credits {N}` flag that is both the consent and the hard cap; bare invocations auto-run cheap syncs (≤ $5) or print a credit estimate and stop. Replaces `--billing-limit`/`--yes`/the TTY prompt, and `sync` is now a visible command.
+  - New `x_messages` DM collection (flat `/dm_events`) and a DM `includes.users` profile extractor. Syncs mirror participant profiles into the local cache (`x_profiles`/`li_profiles`) with a COALESCE merge so thin sources never clobber richer rows; the server `profiles` corpus merges the same way.
+  - `x followers|following|messages` and `linkedin connections|messages|requests` now read from the local cache, enriched with the profiles mirror. They require a first sync; `followers`/`following`/`connections` then auto-refresh only when older than 15 minutes, while `messages` and `requests sent|received` refresh on every read so they always return the latest.
+
+### Patch Changes
+
+- [#30](https://github.com/usesocial/monorepo/pull/30) [`e58d6c7`](https://github.com/usesocial/monorepo/commit/e58d6c7d44dfe7cd569ac0ce6e93bd2f25765993) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Retry LinkedIn 429 responses automatically with `Retry-After` support, exponential fallback, and sync progress on stderr/spinner without changing JSON summaries.
+
+## 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. | |
@@ -202,7 +204,7 @@ jq -r '.items[].id' /tmp/recent-posts.json \
 | `3` | Not found | Check the resource ID or pick a different item. |
 | `4` | Auth or scope error | Run `social account login`, or log out and choose the needed scope. |
 | `5` | API or unexpected error | Retry later or surface the server error. |
-| `7` | Rate limited | Back off; JSON errors may include `retryAfterSeconds`. |
+| `7` | Rate limited | LinkedIn retries automatically; otherwise back off, using `retryAfterSeconds` when present. |
 
 ## Auth
 
@@ -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

@@ -1199,6 +1199,7 @@ type PrintResultArgs = {
   data: unknown;
   resolved?: ResourceResolutionRecord[];
   responseHeaders?: Headers;
+  usage?: unknown;
 };
 //#endregion
 //#region src/lib/ui.d.ts
@@ -1377,16 +1378,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;
@@ -1437,7 +1436,7 @@ declare const createSocialCommand: (deps?: {
     [k: string]: string;
   }>;
   printData: (value: unknown) => void;
-  printResult: (args: PrintResultArgs) => void;
+  printResult: (args: PrintResultArgs) => Promise<void>;
   resolveAccount: ({
     account,
     platform