@usesocial/cli 0.7.0 → 0.7.1

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @usesocial/cli
 
+## 0.7.1
+
+### Patch Changes
+
+- [#32](https://github.com/usesocial/monorepo/pull/32) [`b2ca106`](https://github.com/usesocial/monorepo/commit/b2ca106f970bfe73d776f3f10225df7c6c7a1b80) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Use cursor pagination for `social linkedin posts` so the CLI matches the LinkedIn
+  posts provider contract.
+
 ## 0.7.0
 
 ### Minor Changes

package/README.md

@@ -115,7 +115,7 @@ profile lookup is needed.
 | `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. | |
+| `usage` | Aggregate proxy calls and credits. | |
 | `logs` | Recent proxy calls. | |
 | `config cache mode` | Read or set the live-read proxy cache mode. | |
 | `config cache ttl` | Set a live-read proxy cache TTL in seconds. | |
@@ -125,7 +125,7 @@ profile lookup is needed.
 | Command | Description | |
 | --- | --- | --- |
 | `profile [target]` | Fetch a profile; omit target for your own account. | |
-| `posts <target>` | Live posts for a person or company; target required. | |
+| `posts <target>` | Live posts for a person or company; target required. Supports `--limit` and `--cursor` from `.meta.cursor`. | |
 | `comments <target>` | List a post's comments; supports `--limit` and `--offset`. | |
 | `reactions <target>` | List a post's reactions; supports `--limit` and `--offset`. | |
 | `connections [target]` | Live connection graph read; omit target for your own account. Supports `--limit` and `--cursor` from `.meta.cursor`. Costs credits. | |
@@ -175,8 +175,9 @@ profile lookup is needed.
 ## Built for agents
 
 - Everything speaks JSON: success on stdout, structured errors on stderr.
-- One envelope: lists use `.items[]`, single resources use `.data`, metadata
-  lives under `.meta`.
+- Platform reads return one envelope: lists use `.items[]`, single resources use
+  `.data`, metadata lives under `.meta`. `social account` service commands return
+  bare JSON; `account logs` returns `{ items, meta: { cursor } }`.
 - Schema-backed planning: `social schema --list` is the compact runnable index.
 - Local SQL is the free surface for your own synced data.
 
@@ -187,7 +188,7 @@ social linkedin sql "SELECT c.user_display_name, c.user_public_identifier, c.use
   | jq '.items[]'
 
 # Live fan-out: review recent posts, fan out to reactions, rank warm contacts.
-social linkedin posts profile_id:<profile-id> --limit 25 --offset 0 > /tmp/recent-posts.json
+social linkedin posts profile_id:<profile-id> --limit 25 > /tmp/recent-posts.json
 jq -r '.items[].id' /tmp/recent-posts.json \
   | xargs -I{} social linkedin reactions post_id:{} --limit 100 --offset 0 \
   | jq -s '[ .[] | .items[] ]
@@ -267,7 +268,9 @@ social linkedin sql "SELECT user_display_name, user_public_identifier FROM li_re
 
 # LinkedIn live reads.
 social linkedin profile
-social linkedin posts profile_id:<profile-id> --limit 25 --offset 0
+PAGE1=$(social linkedin posts profile_id:<profile-id> --limit 25)
+NEXT=$(echo "$PAGE1" | jq -r '.meta.cursor // empty')
+[ -n "$NEXT" ] && social linkedin posts profile_id:<profile-id> --limit 25 --cursor "$NEXT"
 social linkedin reactions post_id:<post-id> --limit 100 --offset 0
 
 # X local mirror.
@@ -290,7 +293,8 @@ echo "Loved your launch notes." | social linkedin requests send profile_id:<prof
 social account billing
 social account billing portal
 social account usage
-social account logs --limit 20 --from 2026-05-01T00:00:00Z
+social account logs --limit 20 --from 2026-05-01T00:00:00Z \
+  | jq -r '.items[] | [.createdAt, .platform, .method, .path, .responseStatus, .cacheStatus, .credits] | @tsv'
 
 # Command schema.
 social schema

package/dist/index.mjs

@@ -307,14 +307,67 @@ const referencedTablesForRead = (sql, platform) => {
 };
 const collectionForReadTable = (table) => table === "x_raw_messages" ? "x_messages" : table;
 const collectionShortName = (collection) => collection.replace(/^(x|li)_/, "");
+const tableFreshnessPolicies = {
+	x_raw_messages: {
+		kind: "collection",
+		collection: "x_messages"
+	},
+	li_conversations: {
+		kind: "collection",
+		collection: "li_conversations",
+		commandCollection: "li_messages"
+	},
+	li_profiles: {
+		kind: "platform",
+		platform: "linkedin"
+	},
+	x_profiles: {
+		kind: "platform",
+		platform: "x"
+	}
+};
+const freshnessPolicyForTable = (table) => tableFreshnessPolicies[table] ?? {
+	kind: "collection",
+	collection: collectionForReadTable(table)
+};
+const platformCollectionPrefix = (platform) => platform === "linkedin" ? "li_" : "x_";
+const syncCommandForPolicy = (platform, policy) => {
+	if (policy.kind === "platform") return `social ${policy.platform} sync`;
+	return `social ${platform} sync ${collectionShortName(policy.commandCollection ?? policy.collection)}`;
+};
+const missingNameForPolicy = (table, policy) => policy.kind === "platform" ? table : policy.collection;
 const formatList = (items) => {
 	if (items.length <= 1) return items[0] ?? "";
 	if (items.length === 2) return `${items[0]} and ${items[1]}`;
 	return `${items.slice(0, -1).join(", ")}, and ${items.at(-1)}`;
 };
-const neverSyncedMessage = (platform, collections) => {
-	const commands = collections.map((collection) => `\`social ${platform} sync ${collectionShortName(collection)}\``);
-	return `No synced ${formatList(collections)} yet — run ${formatList(commands)} first.`;
+const collectionLastSynced = (db, collection) => {
+	return numberOrNull(db.prepare("SELECT last_synced FROM sync_state WHERE collection = :collection").get({ collection })?.last_synced);
+};
+const platformLastSynced = (db, platform) => {
+	return numberOrNull(db.prepare("SELECT MAX(last_synced) AS last_synced FROM sync_state WHERE collection GLOB :glob").get({ glob: `${platformCollectionPrefix(platform)}*` })?.last_synced);
+};
+const lastSyncedForPolicy = (db, policy) => policy.kind === "platform" ? platformLastSynced(db, policy.platform) : collectionLastSynced(db, policy.collection);
+const missingFreshnessForTables = (tables) => {
+	const missing = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const table of tables) {
+		if (table.lastSynced != null) continue;
+		const key = `${table.missingName}\0${table.command}`;
+		if (!seen.has(key)) {
+			seen.add(key);
+			missing.push({
+				name: table.missingName,
+				command: table.command
+			});
+		}
+	}
+	return missing;
+};
+const neverSyncedMessage = (missing) => {
+	const names = missing.map((item) => item.name);
+	const commands = missing.map((item) => `\`${item.command}\``);
+	return `No synced ${formatList(names)} yet — run ${formatList(commands)} first.`;
 };
 const assertKnownProfileTable = (table) => {
 	assertKnownTable(table);
@@ -432,15 +485,16 @@ const createCache = (path, db) => ({
 	read: (sql, opts) => {
 		assertPlatformQuery(sql, opts.platform);
 		const tables = referencedTablesForRead(sql, opts.platform).map((name) => {
-			const collection = collectionForReadTable(name);
+			const policy = freshnessPolicyForTable(name);
 			return {
 				name,
-				collection,
-				lastSynced: numberOrNull(db.prepare("SELECT last_synced FROM sync_state WHERE collection = :collection").get({ collection })?.last_synced)
+				missingName: missingNameForPolicy(name, policy),
+				command: syncCommandForPolicy(opts.platform, policy),
+				lastSynced: lastSyncedForPolicy(db, policy)
 			};
 		});
-		const missingCollections = [...new Set(tables.filter((table) => table.lastSynced == null).map((table) => table.collection))];
-		if (missingCollections.length > 0) throw new NeverSyncedError(missingCollections, neverSyncedMessage(opts.platform, missingCollections));
+		const missingFreshness = missingFreshnessForTables(tables);
+		if (missingFreshness.length > 0) throw new NeverSyncedError(missingFreshness.map((item) => item.name), neverSyncedMessage(missingFreshness));
 		return {
 			rows: db.prepare(sql).all(),
 			tables: tables.map(({ name, lastSynced }) => ({
@@ -451,20 +505,23 @@ const createCache = (path, db) => ({
 	},
 	describe: (opts) => {
 		const allowedTables = opts?.platform ? tablesForPlatform(opts.platform) : void 0;
+		const tables = db.prepare("SELECT name, type, sql FROM sqlite_master WHERE type IN ('table', 'view') AND name NOT LIKE 'sqlite_%' ORDER BY name").all().filter((table) => String(table.name) !== "x_raw_messages").filter((table) => allowedTables === void 0 || allowedTables.has(String(table.name)));
+		const lastSyncedForTable = (name) => {
+			if (name === "sync_state") return null;
+			return lastSyncedForPolicy(db, freshnessPolicyForTable(name));
+		};
 		return {
 			path,
-			tables: db.prepare("SELECT name, type, sql FROM sqlite_master WHERE type IN ('table', 'view') AND name NOT LIKE 'sqlite_%' ORDER BY name").all().filter((table) => String(table.name) !== "x_raw_messages").filter((table) => allowedTables === void 0 || allowedTables.has(String(table.name))).map((table) => {
+			tables: tables.map((table) => {
 				const name = String(table.name);
 				const type = table.type === "view" ? "view" : "table";
 				const rowCount = db.prepare(`SELECT count(*) AS rows FROM ${quoteIdentifier(name)}`).get();
-				const collection = collectionForReadTable(name);
-				const syncState = name === "sync_state" ? void 0 : db.prepare("SELECT last_synced FROM sync_state WHERE collection = :collection").get({ collection });
 				return {
 					name,
 					type,
 					sql: String(table.sql),
 					rows: Number(rowCount?.rows ?? 0),
-					last_synced: numberOrNull(syncState?.last_synced)
+					last_synced: lastSyncedForTable(name)
 				};
 			})
 		};
@@ -490,13 +547,6 @@ const linkedinRelationsCursorPagination = {
 	cursorPath: "next_cursor",
 	itemsPath: "data"
 };
-const linkedinOffsetPagination = {
-	style: "offset",
-	limitParam: "limit",
-	offsetParam: "offset",
-	totalCountPath: "total_count",
-	itemsPath: "data"
-};
 const asRecord$1 = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
 const read$1 = (value) => value === null || value === void 0 ? null : value;
 const readReaction = (value) => typeof value === "string" ? value : null;
@@ -723,7 +773,7 @@ const LINKEDIN_COLLECTIONS = [
 		platform: "linkedin",
 		requests: [{ path: "/users/:identifier/posts" }],
 		ownIdToken: ":identifier",
-		pagination: linkedinOffsetPagination,
+		pagination: linkedinCursorPagination,
 		pageSize: 50,
 		sinceField: "created_at",
 		lift: liftPost
@@ -8756,6 +8806,7 @@ const stepPage = (state, page, opts) => {
 	const newestId = state.firstPage && page.items[0] ? String(page.items[0].id) : state.newestId;
 	const rows = [];
 	const ids = [];
+	let crossedSince = false;
 	for (const item of page.items) {
 		const id = String(item.id);
 		if (state.checkpoint !== null && id === state.checkpoint) return {
@@ -8771,17 +8822,7 @@ const stepPage = (state, page, opts) => {
 		};
 		if (opts.since != null && opts.collection.sinceField) {
 			const timestamp = liftedTimestamp(opts.collection, item);
-			if (timestamp != null && timestamp < opts.since) return {
-				rows,
-				ids,
-				nextState: {
-					...state,
-					newestId,
-					firstPage: false
-				},
-				stoppedReason: "since",
-				done: true
-			};
+			if (timestamp != null && timestamp < opts.since) crossedSince = true;
 		}
 		const row = opts.collection.lift(item);
 		applyBakedQueryOverlay(row, opts.request.bakedQuery);
@@ -8789,6 +8830,17 @@ const stepPage = (state, page, opts) => {
 		rows.push(row);
 		if (opts.collectIds) ids.push(id);
 	}
+	if (crossedSince) return {
+		rows,
+		ids,
+		nextState: {
+			...state,
+			newestId,
+			firstPage: false
+		},
+		stoppedReason: "since",
+		done: true
+	};
 	if (opts.collection.pagination.style === "offset") {
 		const nextOffset = state.offset + opts.collection.pageSize;
 		const done = page.items.length === 0 || page.totalCount != null && nextOffset >= page.totalCount || page.totalCount == null && page.items.length < opts.collection.pageSize;
@@ -8942,11 +8994,15 @@ const runSync = async (deps, opts) => {
 		upserted += result.upserted;
 		stoppedReason = mergeStoppedReason(stoppedReason, result.stoppedReason);
 	};
+	const writePendingCursor = (pending) => {
+		deps.cache.setCursor(pending.collection, pending.cursor, pending.objectCount, pending.lastSynced);
+	};
 	if (collection.parentCollection) {
 		const parentCollection = collectionByKey(collection.parentCollection);
 		if (!parentCollection) throw new Error(`Missing parent collection ${collection.parentCollection}`);
 		const parentIds = [];
 		const parentPersistsCheckpoint = parentCollection.requests.length === 1;
+		let parentCheckpoint;
 		for (const request of parentCollection.requests) {
 			const result = await walkRequest({
 				deps,
@@ -8962,17 +9018,18 @@ const runSync = async (deps, opts) => {
 			});
 			addResult(result);
 			parentIds.push(...result.ids);
-			if (parentPersistsCheckpoint) pendingCursors.push(singleRequestCheckpoint({
+			if (parentPersistsCheckpoint) parentCheckpoint = singleRequestCheckpoint({
 				collection: parentCollection,
 				result
-			}));
+			});
 		}
-		if (!parentPersistsCheckpoint) pendingCursors.push({
+		if (!parentPersistsCheckpoint) parentCheckpoint = {
 			collection: parentCollection.key,
 			cursor: null,
 			objectCount: upserted,
 			lastSynced: Date.now()
-		});
+		};
+		if (parentCheckpoint) writePendingCursor(parentCheckpoint);
 		for (const parentId of parentIds) for (const request of collection.requests) addResult(await walkRequest({
 			deps,
 			collection,
@@ -9019,7 +9076,7 @@ const runSync = async (deps, opts) => {
 			lastSynced: Date.now()
 		});
 	}
-	for (const pending of pendingCursors) deps.cache.setCursor(pending.collection, pending.cursor, pending.objectCount, pending.lastSynced);
+	for (const pending of pendingCursors) writePendingCursor(pending);
 	return {
 		collection: collection.key,
 		objectsUpserted: upserted,
@@ -10676,10 +10733,10 @@ const LINKEDIN_OPERATIONS = [
 			capability: "read",
 			mutates: false,
 			pagination: {
-				style: "offset",
+				style: "cursor",
 				limitParam: "limit",
-				offsetParam: "offset",
-				totalCountPath: "total_count",
+				cursorParam: "cursor",
+				cursorPath: "next_cursor",
 				itemsPath: "data"
 			},
 			costBPS: 50,
@@ -10688,18 +10745,18 @@ const LINKEDIN_OPERATIONS = [
 		},
 		parameters: [
 			{
-				name: "offset",
+				name: "limit",
 				in: "query",
 				required: false,
 				kind: "integer",
-				description: "Pagination offset"
+				description: "Rows to return (1-100)"
 			},
 			{
-				name: "limit",
+				name: "cursor",
 				in: "query",
 				required: false,
-				kind: "integer",
-				description: "The limit of items to be returned."
+				kind: "string",
+				description: "Pagination cursor"
 			},
 			{
 				name: "identifier",
@@ -13669,8 +13726,8 @@ const UserProfileInput = object$1({
 });
 const UserProfileOutput = record$1(string$1(), unknown$1());
 const UserPostsInput = object$1({
-	offset: union$1([string$1(), number$1()]).optional(),
 	limit: union$1([string$1(), number$1()]).optional(),
+	cursor: string$1().optional(),
 	identifier: string$1()
 });
 const UserPostsOutput = object$1({
@@ -21572,7 +21629,7 @@ const createInstance = (defaults) => {
 const ky = createInstance();
 //#endregion
 //#region package.json
-var version$1 = "0.7.0";
+var version$1 = "0.7.1";
 //#endregion
 //#region src/lib/env.ts
 const URLWithTrailingSlash = url().transform(ensureTrailingSlash);