@usesocial/cli 0.7.0 → 0.8.0

package/dist/index.mjs

@@ -129,805 +129,1014 @@ var CancelledError = class extends Error {
 	}
 };
 //#endregion
-//#region ../../packages/sync-engine/src/migrations.generated.ts
-const MIGRATIONS = [
-	{
-		"tag": "0000_modern_stephen_strange",
-		"sql": "CREATE TABLE `li_connections` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`object` text,\n	`url` text,\n	`user_id` text,\n	`user_object` text,\n	`user_type` text,\n	`user_display_name` text,\n	`user_public_identifier` text,\n	`user_profile_url` text,\n	`user_public_picture_url` text,\n	`user_description` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `li_connections_created_at_idx` ON `li_connections` (`created_at`);--> statement-breakpoint\nCREATE TABLE `li_conversations` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`last_message_timestamp` integer,\n	`muted_until` integer,\n	`creator_id` text,\n	`headline` text,\n	`image_url` text,\n	`name` text,\n	`object` text,\n	`provider` text,\n	`type` text,\n	`user_id` text,\n	`is_1to1` integer,\n	`is_archived` integer,\n	`is_channel` integer,\n	`is_group` integer,\n	`is_pinned` integer,\n	`is_readonly` integer,\n	`unread_count` integer,\n	`user_object` text,\n	`user_type` text,\n	`user_display_name` text,\n	`user_public_identifier` text,\n	`user_profile_url` text,\n	`user_public_picture_url` text,\n	`user_description` text,\n	`user_specifics_network_distance` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `li_conversations_created_at_idx` ON `li_conversations` (`created_at`);--> statement-breakpoint\nCREATE INDEX `li_conversations_last_message_timestamp_idx` ON `li_conversations` (`last_message_timestamp`);--> statement-breakpoint\nCREATE TABLE `li_messages` (\n	`id` text PRIMARY KEY NOT NULL,\n	`timestamp` integer,\n	`chat_id` text,\n	`object` text,\n	`provider` text,\n	`text` text,\n	`sender_id` text,\n	`is_deleted` integer,\n	`is_delivered` integer,\n	`is_edited` integer,\n	`is_event` integer,\n	`is_hidden` integer,\n	`is_mentionned` integer,\n	`is_pinned` integer,\n	`is_seen` integer,\n	`is_sender` integer,\n	`sender_object` text,\n	`sender_type` text,\n	`sender_display_name` text,\n	`sender_public_identifier` text,\n	`sender_profile_url` text,\n	`sender_public_picture_url` text,\n	`sender_description` text,\n	`sender_specifics_network_distance` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `li_messages_timestamp_idx` ON `li_messages` (`timestamp`);--> statement-breakpoint\nCREATE INDEX `li_messages_chat_id_idx` ON `li_messages` (`chat_id`);--> statement-breakpoint\nCREATE TABLE `li_posts` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`object` text,\n	`share_url` text,\n	`text` text,\n	`url` text,\n	`is_repost` integer,\n	`user_reacted` text,\n	`comments_counter` integer,\n	`reposts_counter` integer,\n	`analytics_impressions_counter` integer,\n	`author_id` text,\n	`author_object` text,\n	`author_type` text,\n	`author_display_name` text,\n	`author_public_identifier` text,\n	`author_profile_url` text,\n	`author_public_picture_url` text,\n	`author_description` text,\n	`author_specifics_network_distance` text,\n	`permissions_can_post_comments` integer,\n	`permissions_can_react` integer,\n	`permissions_can_share` integer,\n	`poll_id` text,\n	`poll_question` text,\n	`poll_is_open` integer,\n	`poll_total_votes_count` integer,\n	`quoted_post_id` text,\n	`quoted_post_object` text,\n	`quoted_post_created_at` integer,\n	`quoted_post_text` text,\n	`quoted_post_share_url` text,\n	`quoted_post_user_reacted` text,\n	`quoted_post_comments_counter` integer,\n	`quoted_post_reposts_counter` integer,\n	`quoted_post_permissions_can_post_comments` integer,\n	`quoted_post_permissions_can_react` integer,\n	`quoted_post_permissions_can_share` integer,\n	`quoted_post_author_id` text,\n	`quoted_post_author_object` text,\n	`quoted_post_author_type` text,\n	`quoted_post_author_display_name` text,\n	`quoted_post_author_public_identifier` text,\n	`quoted_post_author_profile_url` text,\n	`quoted_post_author_public_picture_url` text,\n	`quoted_post_author_description` text,\n	`quoted_post_author_specifics_network_distance` text,\n	`reposted_by_id` text,\n	`reposted_by_object` text,\n	`reposted_by_type` text,\n	`reposted_by_display_name` text,\n	`reposted_by_public_identifier` text,\n	`reposted_by_profile_url` text,\n	`reposted_by_public_picture_url` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `li_posts_created_at_idx` ON `li_posts` (`created_at`);--> statement-breakpoint\nCREATE TABLE `li_requests` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`object` text,\n	`type` text,\n	`user_id` text,\n	`user_object` text,\n	`user_type` text,\n	`user_display_name` text,\n	`user_public_identifier` text,\n	`user_profile_url` text,\n	`user_public_picture_url` text,\n	`user_description` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `li_requests_created_at_idx` ON `li_requests` (`created_at`);--> statement-breakpoint\nCREATE TABLE `sync_state` (\n	`collection` text PRIMARY KEY NOT NULL,\n	`cursor` text,\n	`last_synced` integer,\n	`object_count` integer\n);\n--> statement-breakpoint\nCREATE TABLE `x_bookmarks` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`author_id` text,\n	`conversation_id` text,\n	`in_reply_to_user_id` text,\n	`lang` text,\n	`reply_settings` text,\n	`text` text,\n	`url` text,\n	`paid_partnership` integer,\n	`possibly_sensitive` integer,\n	`edit_controls_editable_until` integer,\n	`edit_controls_edits_remaining` integer,\n	`edit_controls_is_edit_eligible` integer,\n	`like_count` integer,\n	`retweet_count` integer,\n	`reply_count` integer,\n	`quote_count` integer,\n	`bookmark_count` integer,\n	`impression_count` integer,\n	`article_cover_media` text,\n	`article_plain_text` text,\n	`article_preview_text` text,\n	`article_title` text,\n	`note_tweet_text` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `x_bookmarks_created_at_idx` ON `x_bookmarks` (`created_at`);--> statement-breakpoint\nCREATE TABLE `x_followers` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`username` text,\n	`name` text,\n	`description` text,\n	`location` text,\n	`url` text,\n	`is_identity_verified` integer,\n	`protected` integer,\n	`verified` integer,\n	`verified_type` text,\n	`subscription_type` text,\n	`parody` integer,\n	`most_recent_tweet_id` text,\n	`pinned_tweet_id` text,\n	`profile_banner_url` text,\n	`profile_image_url` text,\n	`affiliation_badge_url` text,\n	`affiliation_description` text,\n	`affiliation_url` text,\n	`subscription_subscribes_to_you` integer,\n	`followers_count` integer,\n	`following_count` integer,\n	`tweet_count` integer,\n	`listed_count` integer,\n	`like_count` integer,\n	`media_count` integer,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `x_followers_created_at_idx` ON `x_followers` (`created_at`);--> statement-breakpoint\nCREATE TABLE `x_following` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`username` text,\n	`name` text,\n	`description` text,\n	`location` text,\n	`url` text,\n	`is_identity_verified` integer,\n	`protected` integer,\n	`verified` integer,\n	`verified_type` text,\n	`subscription_type` text,\n	`parody` integer,\n	`most_recent_tweet_id` text,\n	`pinned_tweet_id` text,\n	`profile_banner_url` text,\n	`profile_image_url` text,\n	`affiliation_badge_url` text,\n	`affiliation_description` text,\n	`affiliation_url` text,\n	`subscription_subscribes_to_you` integer,\n	`followers_count` integer,\n	`following_count` integer,\n	`tweet_count` integer,\n	`listed_count` integer,\n	`like_count` integer,\n	`media_count` integer,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `x_following_created_at_idx` ON `x_following` (`created_at`);--> statement-breakpoint\nCREATE TABLE `x_tweets` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`author_id` text,\n	`conversation_id` text,\n	`in_reply_to_user_id` text,\n	`lang` text,\n	`reply_settings` text,\n	`text` text,\n	`url` text,\n	`paid_partnership` integer,\n	`possibly_sensitive` integer,\n	`edit_controls_editable_until` integer,\n	`edit_controls_edits_remaining` integer,\n	`edit_controls_is_edit_eligible` integer,\n	`like_count` integer,\n	`retweet_count` integer,\n	`reply_count` integer,\n	`quote_count` integer,\n	`bookmark_count` integer,\n	`impression_count` integer,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `x_tweets_created_at_idx` ON `x_tweets` (`created_at`);"
-	},
-	{
-		"tag": "0001_far_beast",
-		"sql": "CREATE TABLE `li_profiles` (\n	`provider_id` text PRIMARY KEY NOT NULL,\n	`handle` text,\n	`display_name` text NOT NULL,\n	`avatar_url` text,\n	`headline` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `li_profiles_handle_idx` ON `li_profiles` (`handle`);--> statement-breakpoint\nCREATE TABLE `x_messages` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`dm_conversation_id` text,\n	`event_type` text,\n	`sender_id` text,\n	`text` text,\n	`participant_ids` text,\n	`attachments` text,\n	`entities` text,\n	`referenced_tweets` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `x_messages_created_at_idx` ON `x_messages` (`created_at`);--> statement-breakpoint\nCREATE INDEX `x_messages_dm_conversation_id_idx` ON `x_messages` (`dm_conversation_id`);--> statement-breakpoint\nCREATE TABLE `x_profiles` (\n	`provider_id` text PRIMARY KEY NOT NULL,\n	`handle` text,\n	`display_name` text NOT NULL,\n	`avatar_url` text,\n	`headline` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `x_profiles_handle_idx` ON `x_profiles` (`handle`);"
-	},
-	{
-		"tag": "0002_previous_spitfire",
-		"sql": "ALTER TABLE `li_connections` ADD `user_headline` text;--> statement-breakpoint\nALTER TABLE `li_requests` ADD `user_headline` text;--> statement-breakpoint\nALTER TABLE `x_bookmarks` DROP COLUMN `edit_controls_editable_until`;--> statement-breakpoint\nALTER TABLE `x_bookmarks` DROP COLUMN `edit_controls_edits_remaining`;--> statement-breakpoint\nALTER TABLE `x_bookmarks` DROP COLUMN `edit_controls_is_edit_eligible`;--> statement-breakpoint\nALTER TABLE `x_tweets` DROP COLUMN `edit_controls_editable_until`;--> statement-breakpoint\nALTER TABLE `x_tweets` DROP COLUMN `edit_controls_edits_remaining`;--> statement-breakpoint\nALTER TABLE `x_tweets` DROP COLUMN `edit_controls_is_edit_eligible`;"
-	},
-	{
-		"tag": "0003_wonderful_makkari",
-		"sql": "ALTER TABLE `li_conversations` RENAME COLUMN \"headline\" TO \"user_headline\";--> statement-breakpoint\nCREATE INDEX `li_conversations_user_id_last_message_timestamp_idx` ON `li_conversations` (`user_id`,`last_message_timestamp`);--> statement-breakpoint\nCREATE INDEX `li_conversations_user_public_identifier_last_message_timestamp_idx` ON `li_conversations` (`user_public_identifier`,`last_message_timestamp`);--> statement-breakpoint\nCREATE INDEX `li_conversations_user_display_name_idx` ON `li_conversations` (`user_display_name`);--> statement-breakpoint\nCREATE INDEX `li_conversations_is_archived_last_message_timestamp_idx` ON `li_conversations` (`is_archived`,`last_message_timestamp`);--> statement-breakpoint\nDROP INDEX `li_messages_chat_id_idx`;--> statement-breakpoint\nCREATE INDEX `li_messages_chat_id_timestamp_idx` ON `li_messages` (`chat_id`,`timestamp`);--> statement-breakpoint\nCREATE INDEX `li_messages_sender_id_timestamp_idx` ON `li_messages` (`sender_id`,`timestamp`);--> statement-breakpoint\nDROP INDEX `x_messages_dm_conversation_id_idx`;--> statement-breakpoint\nCREATE INDEX `x_messages_dm_conversation_id_created_at_idx` ON `x_messages` (`dm_conversation_id`,`created_at`);--> statement-breakpoint\nCREATE INDEX `x_messages_sender_id_created_at_idx` ON `x_messages` (`sender_id`,`created_at`);--> statement-breakpoint\nCREATE INDEX `li_connections_synced_at_idx` ON `li_connections` (`synced_at`);--> statement-breakpoint\nCREATE INDEX `li_connections_user_id_idx` ON `li_connections` (`user_id`);--> statement-breakpoint\nCREATE INDEX `li_connections_user_public_identifier_idx` ON `li_connections` (`user_public_identifier`);--> statement-breakpoint\nCREATE INDEX `li_connections_user_display_name_idx` ON `li_connections` (`user_display_name`);--> statement-breakpoint\nCREATE INDEX `li_posts_author_id_created_at_idx` ON `li_posts` (`author_id`,`created_at`);--> statement-breakpoint\nCREATE INDEX `li_posts_author_public_identifier_created_at_idx` ON `li_posts` (`author_public_identifier`,`created_at`);--> statement-breakpoint\nCREATE INDEX `li_requests_type_synced_at_idx` ON `li_requests` (`type`,`synced_at`);--> statement-breakpoint\nCREATE INDEX `li_requests_user_id_idx` ON `li_requests` (`user_id`);--> statement-breakpoint\nCREATE INDEX `li_requests_user_public_identifier_idx` ON `li_requests` (`user_public_identifier`);--> statement-breakpoint\nCREATE INDEX `li_requests_user_display_name_idx` ON `li_requests` (`user_display_name`);--> statement-breakpoint\nCREATE INDEX `x_bookmarks_author_id_created_at_idx` ON `x_bookmarks` (`author_id`,`created_at`);--> statement-breakpoint\nCREATE INDEX `x_bookmarks_conversation_id_created_at_idx` ON `x_bookmarks` (`conversation_id`,`created_at`);--> statement-breakpoint\nCREATE INDEX `x_followers_synced_at_idx` ON `x_followers` (`synced_at`);--> statement-breakpoint\nCREATE INDEX `x_followers_username_idx` ON `x_followers` (`username`);--> statement-breakpoint\nCREATE INDEX `x_followers_verified_idx` ON `x_followers` (`verified`);--> statement-breakpoint\nCREATE INDEX `x_followers_verified_type_idx` ON `x_followers` (`verified_type`);--> statement-breakpoint\nCREATE INDEX `x_following_synced_at_idx` ON `x_following` (`synced_at`);--> statement-breakpoint\nCREATE INDEX `x_following_username_idx` ON `x_following` (`username`);--> statement-breakpoint\nCREATE INDEX `x_following_verified_idx` ON `x_following` (`verified`);--> statement-breakpoint\nCREATE INDEX `x_following_verified_type_idx` ON `x_following` (`verified_type`);--> statement-breakpoint\nCREATE INDEX `x_tweets_author_id_created_at_idx` ON `x_tweets` (`author_id`,`created_at`);--> statement-breakpoint\nCREATE INDEX `x_tweets_conversation_id_created_at_idx` ON `x_tweets` (`conversation_id`,`created_at`);"
-	},
-	{
-		"tag": "0004_quiet_prism",
-		"sql": "ALTER TABLE `x_messages` RENAME TO `x_raw_messages`;--> statement-breakpoint\nCREATE VIEW `x_messages` AS\nSELECT m.*, p.handle AS sender_handle, p.display_name AS sender_name,\n       p.avatar_url AS sender_avatar_url, p.headline AS sender_headline\nFROM `x_raw_messages` m LEFT JOIN `x_profiles` p ON m.sender_id = p.provider_id;\n"
-	}
-];
-//#endregion
-//#region ../../packages/sync-engine/src/migrate.ts
-const readUserVersion = (db) => {
-	const version = db.prepare("PRAGMA user_version").get()?.user_version;
-	return typeof version === "number" ? version : Number(version ?? 0);
-};
-const setUserVersion = (db, version) => {
-	db.exec(`PRAGMA user_version = ${version}`);
-};
-const migrate = (db) => {
-	const currentVersion = readUserVersion(db);
-	if (currentVersion >= MIGRATIONS.length) return {
-		fromVersion: currentVersion,
-		toVersion: currentVersion,
-		applied: 0
-	};
-	for (let index = currentVersion; index < MIGRATIONS.length; index += 1) {
-		const migration = MIGRATIONS[index];
-		if (!migration) throw new Error(`Missing migration at index ${index}`);
-		db.transaction(() => {
-			db.exec(migration.sql);
-			setUserVersion(db, index + 1);
-		});
-	}
-	return {
-		fromVersion: currentVersion,
-		toVersion: MIGRATIONS.length,
-		applied: MIGRATIONS.length - currentVersion
-	};
-};
-const assertAtLatest = (db) => {
-	const currentVersion = readUserVersion(db);
-	if (currentVersion < MIGRATIONS.length) throw new Error(`Local SQLite cache schema is at version ${currentVersion}; expected ${MIGRATIONS.length}`);
+//#region ../../packages/sync-engine/src/collections/linkedin.ts
+const linkedinCursorPagination = {
+	style: "cursor",
+	limitParam: "limit",
+	cursorParam: "cursor",
+	cursorPath: "next_cursor",
+	totalCountPath: "total_count",
+	itemsPath: "data"
 };
-//#endregion
-//#region ../../packages/sync-engine/src/sqlite.ts
-const loadModule = createRequire(import.meta.url);
-const isBunRuntime = () => typeof Bun !== "undefined";
-const normalizeValue = (value) => {
-	if (value === null || value === void 0) return null;
-	if (typeof value === "boolean") return value ? 1 : 0;
-	return value;
+const linkedinRelationsCursorPagination = {
+	style: "cursor",
+	limitParam: "limit",
+	cursorParam: "cursor",
+	cursorPath: "next_cursor",
+	itemsPath: "data"
 };
-const normalizeParams$1 = (params) => {
-	if (!params) return;
-	return Object.fromEntries(Object.entries(params).map(([key, value]) => [key, normalizeValue(value)]));
+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;
+const trimmed$1 = (value) => typeof value === "string" ? value.trim() || void 0 : void 0;
+const userHeadline = (user) => {
+	const specifics = asRecord$1(user.specifics);
+	return trimmed$1(user.description) ?? trimmed$1(user.headline) ?? trimmed$1(specifics.description) ?? trimmed$1(specifics.headline) ?? trimmed$1(specifics.occupation) ?? null;
 };
-const invokeWithParams = (fn, params) => {
-	const normalizedParams = normalizeParams$1(params);
-	return normalizedParams ? fn(normalizedParams) : fn();
+const isoToEpochMs$1 = (value) => {
+	if (typeof value === "number") return Number.isFinite(value) ? value : null;
+	if (typeof value !== "string") return null;
+	const epochMs = Date.parse(value);
+	return Number.isNaN(epochMs) ? null : epochMs;
 };
-const wrapStatement = (statement) => ({
-	run: (params) => invokeWithParams(statement.run.bind(statement), params),
-	get: (params) => invokeWithParams(statement.get.bind(statement), params),
-	all: (params) => invokeWithParams(statement.all.bind(statement), params)
-});
-const openRuntimeDatabase = (path, opts) => {
-	if (isBunRuntime()) {
-		const { Database } = loadModule("bun:sqlite");
-		return new Database(path, {
-			readonly: opts?.readonly,
-			strict: true
-		});
-	}
-	const { DatabaseSync } = loadModule("node:sqlite");
-	return opts?.readonly ? new DatabaseSync(path, { readOnly: true }) : new DatabaseSync(path);
+const toBool$1 = (value) => {
+	if (typeof value !== "boolean") return null;
+	return value ? 1 : 0;
 };
-const openDatabase = (path, opts) => {
-	const database = openRuntimeDatabase(path, opts);
-	const exec = (sql) => {
-		database.exec(sql);
-	};
+const liftConnection = (item) => {
+	const user = asRecord$1(item.user);
 	return {
-		exec,
-		prepare: (sql) => wrapStatement(database.prepare(sql)),
-		transaction: (fn) => {
-			exec("BEGIN");
-			try {
-				fn();
-				exec("COMMIT");
-			} catch (error) {
-				exec("ROLLBACK");
-				throw error;
-			}
-		},
-		close: () => {
-			database.close();
-		}
+		id: read$1(item.id),
+		created_at: isoToEpochMs$1(item.created_at),
+		object: read$1(item.object),
+		url: read$1(item.url),
+		user_id: read$1(user.id),
+		user_object: read$1(user.object),
+		user_type: read$1(user.type),
+		user_display_name: read$1(user.display_name),
+		user_public_identifier: read$1(user.public_identifier),
+		user_profile_url: read$1(user.profile_url),
+		user_public_picture_url: read$1(user.public_picture_url),
+		user_description: read$1(user.description),
+		user_headline: userHeadline(user),
+		raw: JSON.stringify(item)
 	};
 };
-//#endregion
-//#region ../../packages/sync-engine/src/cache.ts
-var NeverSyncedError = class extends Error {
-	name = "NeverSyncedError";
-	tables;
-	constructor(tables, message) {
-		super(message);
-		this.tables = tables;
-	}
-};
-const cacheTables = new Set([
-	"x_tweets",
-	"x_followers",
-	"x_following",
-	"x_bookmarks",
-	"x_profiles",
-	"x_messages",
-	"x_raw_messages",
-	"li_conversations",
-	"li_messages",
-	"li_connections",
-	"li_posts",
-	"li_profiles",
-	"li_requests",
-	"sync_state"
-]);
-const profileTables = new Set(["x_profiles", "li_profiles"]);
-const sharedTables = new Set(["sync_state"]);
-const platformTables = {
-	linkedin: new Set([...cacheTables].filter((table) => table.startsWith("li_"))),
-	x: new Set([...cacheTables].filter((table) => table.startsWith("x_")))
+const liftConversation = (item) => {
+	const user = asRecord$1(item.user);
+	const userSpecifics = asRecord$1(user.specifics);
+	return {
+		id: read$1(item.id),
+		created_at: isoToEpochMs$1(item.created_at),
+		last_message_timestamp: isoToEpochMs$1(item.last_message_timestamp),
+		muted_until: isoToEpochMs$1(item.muted_until),
+		creator_id: read$1(item.creator_id),
+		user_headline: userHeadline(user),
+		image_url: read$1(item.image_url),
+		name: read$1(item.name),
+		object: read$1(item.object),
+		provider: read$1(item.provider),
+		type: read$1(item.type),
+		user_id: read$1(item.user_id ?? user.id),
+		is_1to1: toBool$1(item.is_1to1),
+		is_archived: toBool$1(item.is_archived),
+		is_channel: toBool$1(item.is_channel),
+		is_group: toBool$1(item.is_group),
+		is_pinned: toBool$1(item.is_pinned),
+		is_readonly: toBool$1(item.is_readonly),
+		unread_count: read$1(item.unread_count),
+		user_object: read$1(user.object),
+		user_type: read$1(user.type),
+		user_display_name: read$1(user.display_name),
+		user_public_identifier: read$1(user.public_identifier),
+		user_profile_url: read$1(user.profile_url),
+		user_public_picture_url: read$1(user.public_picture_url),
+		user_description: read$1(user.description),
+		user_specifics_network_distance: read$1(userSpecifics.network_distance),
+		raw: JSON.stringify(item)
+	};
 };
-const sanitizeAccountId = (accountId) => accountId.replaceAll(/[^A-Za-z0-9._-]/g, "_");
-const quoteIdentifier = (identifier) => `\`${identifier.replaceAll("`", "``")}\``;
-const resolveCachePath = (path) => path === ":memory:" ? path : resolve(path);
-const stringOrNull = (value) => typeof value === "string" ? value : null;
-const numberOrNull = (value) => typeof value === "number" ? value : null;
-const assertKnownTable = (table) => {
-	if (!cacheTables.has(table)) throw new Error(`Unknown cache table: ${table}`);
+const liftMessage = (item) => {
+	const sender = asRecord$1(item.sender);
+	const senderSpecifics = asRecord$1(sender.specifics);
+	return {
+		id: read$1(item.id),
+		timestamp: isoToEpochMs$1(item.timestamp),
+		chat_id: read$1(item.chat_id ?? null),
+		object: read$1(item.object),
+		provider: read$1(item.provider),
+		text: read$1(item.text),
+		sender_id: read$1(item.sender_id),
+		is_deleted: toBool$1(item.is_deleted),
+		is_delivered: toBool$1(item.is_delivered),
+		is_edited: toBool$1(item.is_edited),
+		is_event: toBool$1(item.is_event),
+		is_hidden: toBool$1(item.is_hidden),
+		is_mentionned: toBool$1(item.is_mentionned),
+		is_pinned: toBool$1(item.is_pinned),
+		is_seen: toBool$1(item.is_seen),
+		is_sender: toBool$1(item.is_sender),
+		sender_object: read$1(sender.object),
+		sender_type: read$1(sender.type),
+		sender_display_name: read$1(sender.display_name),
+		sender_public_identifier: read$1(sender.public_identifier),
+		sender_profile_url: read$1(sender.profile_url),
+		sender_public_picture_url: read$1(sender.public_picture_url),
+		sender_description: read$1(sender.description),
+		sender_specifics_network_distance: read$1(senderSpecifics.network_distance),
+		raw: JSON.stringify(item)
+	};
 };
-const tablesForPlatform = (platform) => new Set([...platformTables[platform], ...sharedTables]);
-const knownTableTokens = (sql) => {
-	const tokens = sql.match(/\b[A-Za-z_][A-Za-z0-9_]*\b/g) ?? [];
-	const tables = [];
-	const seen = /* @__PURE__ */ new Set();
-	for (const token of tokens) {
-		const table = token.toLowerCase();
-		if (cacheTables.has(table) && !seen.has(table)) {
-			seen.add(table);
-			tables.push(table);
-		}
+const liftPost = (item) => {
+	const analytics = asRecord$1(item.analytics);
+	const author = asRecord$1(item.author);
+	const authorSpecifics = asRecord$1(author.specifics);
+	const permissions = asRecord$1(item.permissions);
+	const poll = asRecord$1(item.poll);
+	const quotedPost = asRecord$1(item.quoted_post);
+	const quotedPostPermissions = asRecord$1(quotedPost.permissions);
+	const quotedPostAuthor = asRecord$1(quotedPost.author);
+	const quotedPostAuthorSpecifics = asRecord$1(quotedPostAuthor.specifics);
+	const repostedBy = asRecord$1(item.reposted_by);
+	return {
+		id: read$1(item.id),
+		created_at: isoToEpochMs$1(item.created_at),
+		object: read$1(item.object),
+		share_url: read$1(item.share_url),
+		text: read$1(item.text),
+		url: read$1(item.url),
+		is_repost: toBool$1(item.is_repost),
+		user_reacted: readReaction(item.user_reacted),
+		comments_counter: read$1(item.comments_counter),
+		reposts_counter: read$1(item.reposts_counter),
+		analytics_impressions_counter: read$1(analytics.impressions_counter),
+		author_id: read$1(author.id),
+		author_object: read$1(author.object),
+		author_type: read$1(author.type),
+		author_display_name: read$1(author.display_name),
+		author_public_identifier: read$1(author.public_identifier),
+		author_profile_url: read$1(author.profile_url),
+		author_public_picture_url: read$1(author.public_picture_url),
+		author_description: read$1(author.description),
+		author_specifics_network_distance: read$1(authorSpecifics.network_distance),
+		permissions_can_post_comments: toBool$1(permissions.can_post_comments),
+		permissions_can_react: toBool$1(permissions.can_react),
+		permissions_can_share: toBool$1(permissions.can_share),
+		poll_id: read$1(poll.id),
+		poll_question: read$1(poll.question),
+		poll_is_open: toBool$1(poll.is_open),
+		poll_total_votes_count: read$1(poll.total_votes_count),
+		quoted_post_id: read$1(quotedPost.id),
+		quoted_post_object: read$1(quotedPost.object),
+		quoted_post_created_at: isoToEpochMs$1(quotedPost.created_at),
+		quoted_post_text: read$1(quotedPost.text),
+		quoted_post_share_url: read$1(quotedPost.share_url),
+		quoted_post_user_reacted: readReaction(quotedPost.user_reacted),
+		quoted_post_comments_counter: read$1(quotedPost.comments_counter),
+		quoted_post_reposts_counter: read$1(quotedPost.reposts_counter),
+		quoted_post_permissions_can_post_comments: toBool$1(quotedPostPermissions.can_post_comments),
+		quoted_post_permissions_can_react: toBool$1(quotedPostPermissions.can_react),
+		quoted_post_permissions_can_share: toBool$1(quotedPostPermissions.can_share),
+		quoted_post_author_id: read$1(quotedPostAuthor.id),
+		quoted_post_author_object: read$1(quotedPostAuthor.object),
+		quoted_post_author_type: read$1(quotedPostAuthor.type),
+		quoted_post_author_display_name: read$1(quotedPostAuthor.display_name),
+		quoted_post_author_public_identifier: read$1(quotedPostAuthor.public_identifier),
+		quoted_post_author_profile_url: read$1(quotedPostAuthor.profile_url),
+		quoted_post_author_public_picture_url: read$1(quotedPostAuthor.public_picture_url),
+		quoted_post_author_description: read$1(quotedPostAuthor.description),
+		quoted_post_author_specifics_network_distance: read$1(quotedPostAuthorSpecifics.network_distance),
+		reposted_by_id: read$1(repostedBy.id),
+		reposted_by_object: read$1(repostedBy.object),
+		reposted_by_type: read$1(repostedBy.type),
+		reposted_by_display_name: read$1(repostedBy.display_name),
+		reposted_by_public_identifier: read$1(repostedBy.public_identifier),
+		reposted_by_profile_url: read$1(repostedBy.profile_url),
+		reposted_by_public_picture_url: read$1(repostedBy.public_picture_url),
+		raw: JSON.stringify(item)
+	};
+};
+const liftRequest = (item) => {
+	const user = asRecord$1(item.user);
+	return {
+		id: read$1(item.id),
+		created_at: isoToEpochMs$1(item.created_at),
+		object: read$1(item.object),
+		type: read$1(item.type ?? null),
+		user_id: read$1(user.id),
+		user_object: read$1(user.object),
+		user_type: read$1(user.type),
+		user_display_name: read$1(user.display_name),
+		user_public_identifier: read$1(user.public_identifier),
+		user_profile_url: read$1(user.profile_url),
+		user_public_picture_url: read$1(user.public_picture_url),
+		user_description: read$1(user.description),
+		user_headline: userHeadline(user),
+		raw: JSON.stringify(item)
+	};
+};
+const LINKEDIN_COLLECTIONS = [
+	{
+		key: "li_conversations",
+		table: "li_conversations_raw",
+		platform: "linkedin",
+		requests: [{ path: "/chats" }],
+		pagination: linkedinCursorPagination,
+		pageSize: 20,
+		sinceField: "last_message_timestamp",
+		lift: liftConversation
+	},
+	{
+		key: "li_messages",
+		table: "li_messages_raw",
+		platform: "linkedin",
+		requests: [{ path: "/chats/:chat_id/messages" }],
+		parentCollection: "li_conversations",
+		parentIdToken: ":chat_id",
+		pagination: linkedinCursorPagination,
+		pageSize: 250,
+		sinceField: "timestamp",
+		lift: liftMessage
+	},
+	{
+		key: "li_connections",
+		table: "li_connections_raw",
+		platform: "linkedin",
+		requests: [{ path: "/users/connections" }],
+		requiresFullInitialSync: true,
+		pagination: linkedinRelationsCursorPagination,
+		pageSize: 100,
+		sinceField: "created_at",
+		lift: liftConnection
+	},
+	{
+		key: "li_posts",
+		table: "li_posts_raw",
+		platform: "linkedin",
+		requests: [{ path: "/users/:identifier/posts" }],
+		ownIdToken: ":identifier",
+		pagination: linkedinCursorPagination,
+		pageSize: 50,
+		sinceField: "created_at",
+		lift: liftPost
+	},
+	{
+		key: "li_requests",
+		table: "li_requests_raw",
+		platform: "linkedin",
+		requests: [{
+			path: "/users/me/relation-requests/received",
+			bakedQuery: { type: "received" }
+		}, {
+			path: "/users/me/relation-requests/sent",
+			bakedQuery: { type: "sent" }
+		}],
+		pagination: linkedinRelationsCursorPagination,
+		pageSize: 100,
+		lift: liftRequest
+	}
+];
+const userTypeValues = ["individual", "organization"];
+const LINKEDIN_CACHE_METADATA = {
+	joins: [
+		"li_*.user_id = li_profiles.provider_id",
+		"li_messages.conversation_id = li_conversations.id",
+		"li_messages.sender_id = li_profiles.provider_id",
+		"li_posts.author_id = li_profiles.provider_id"
+	],
+	enums: {
+		"li_connections.user_type": userTypeValues,
+		"li_conversations.type": ["1to1", "group"],
+		"li_conversations.user_type": userTypeValues,
+		"li_messages.sender_type": userTypeValues,
+		"li_posts.author_type": userTypeValues,
+		"li_requests.type": ["received", "sent"],
+		"li_requests.user_type": userTypeValues
+	},
+	indexed: {
+		li_connections: [
+			"created_at",
+			"user_id",
+			"user_username",
+			"user_name"
+		],
+		li_conversations: [
+			"created_at",
+			"last_message_at",
+			"user_id",
+			"user_username",
+			"user_name",
+			"is_archived"
+		],
+		li_messages: [
+			"created_at",
+			"conversation_id",
+			"sender_id"
+		],
+		li_posts: [
+			"created_at",
+			"author_id",
+			"author_username"
+		],
+		li_profiles: ["username"],
+		li_requests: [
+			"created_at",
+			"type",
+			"user_id",
+			"user_username",
+			"user_name"
+		]
+	}
+};
+//#endregion
+//#region ../../packages/sync-engine/src/collections/x.ts
+const xPagination = {
+	style: "cursor",
+	limitParam: "max_results",
+	cursorParam: "pagination_token",
+	cursorPath: "meta.next_token",
+	itemsPath: "data"
+};
+const defaultDMEventFields = "attachments,created_at,dm_conversation_id,entities,event_type,id,participant_ids,referenced_tweets,sender_id,text";
+const defaultDMExpansions = "attachments.media_keys,participant_ids,referenced_tweets.id,sender_id";
+const defaultDMUserFields = "affiliation,connection_status,created_at,description,entities,id,location,most_recent_tweet_id,name,pinned_tweet_id,profile_banner_url,profile_image_url,protected,public_metrics,receives_your_dm,subscription_type,url,username,verified,verified_type,withheld";
+const asRecord = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
+const read = (value) => value === null || value === void 0 ? null : value;
+const isoToEpochMs = (value) => {
+	if (typeof value === "number") return Number.isFinite(value) ? value : null;
+	if (typeof value !== "string") return null;
+	const epochMs = Date.parse(value);
+	return Number.isNaN(epochMs) ? null : epochMs;
+};
+const toBool = (value) => {
+	if (typeof value !== "boolean") return null;
+	return value ? 1 : 0;
+};
+const stringifyJSON$1 = (value) => value === null || value === void 0 ? null : JSON.stringify(value);
+const liftTweetColumns = (item) => {
+	const publicMetrics = asRecord(item.public_metrics);
+	return {
+		id: read(item.id),
+		created_at: isoToEpochMs(item.created_at),
+		author_id: read(item.author_id),
+		conversation_id: read(item.conversation_id),
+		in_reply_to_user_id: read(item.in_reply_to_user_id),
+		lang: read(item.lang),
+		reply_settings: read(item.reply_settings),
+		text: read(item.text),
+		url: read(item.url),
+		paid_partnership: toBool(item.paid_partnership),
+		possibly_sensitive: toBool(item.possibly_sensitive),
+		like_count: read(publicMetrics.like_count),
+		retweet_count: read(publicMetrics.retweet_count),
+		reply_count: read(publicMetrics.reply_count),
+		quote_count: read(publicMetrics.quote_count),
+		bookmark_count: read(publicMetrics.bookmark_count),
+		impression_count: read(publicMetrics.impression_count)
+	};
+};
+const liftTweet = (item) => ({
+	...liftTweetColumns(item),
+	raw: JSON.stringify(item)
+});
+const liftBookmark = (item) => {
+	const article = asRecord(item.article);
+	const noteTweet = asRecord(item.note_tweet);
+	return {
+		...liftTweetColumns(item),
+		article_cover_media: read(article.cover_media),
+		article_plain_text: read(article.plain_text),
+		article_preview_text: read(article.preview_text),
+		article_title: read(article.title),
+		note_tweet_text: read(noteTweet.text),
+		raw: JSON.stringify(item)
+	};
+};
+const liftDMEvent = (item) => ({
+	id: read(item.id),
+	created_at: isoToEpochMs(item.created_at),
+	dm_conversation_id: read(item.dm_conversation_id),
+	event_type: read(item.event_type),
+	sender_id: read(item.sender_id),
+	text: read(item.text),
+	participant_ids: stringifyJSON$1(item.participant_ids),
+	attachments: stringifyJSON$1(item.attachments),
+	entities: stringifyJSON$1(item.entities),
+	referenced_tweets: stringifyJSON$1(item.referenced_tweets),
+	raw: JSON.stringify(item)
+});
+const liftXUser = (item) => {
+	const affiliation = asRecord(item.affiliation);
+	const publicMetrics = asRecord(item.public_metrics);
+	const subscription = asRecord(item.subscription);
+	return {
+		id: read(item.id),
+		created_at: isoToEpochMs(item.created_at),
+		username: read(item.username),
+		name: read(item.name),
+		description: read(item.description),
+		location: read(item.location),
+		url: read(item.url),
+		is_identity_verified: toBool(item.is_identity_verified),
+		protected: toBool(item.protected),
+		verified: toBool(item.verified),
+		verified_type: read(item.verified_type),
+		subscription_type: read(item.subscription_type),
+		parody: toBool(item.parody),
+		most_recent_tweet_id: read(item.most_recent_tweet_id),
+		pinned_tweet_id: read(item.pinned_tweet_id),
+		profile_banner_url: read(item.profile_banner_url),
+		profile_image_url: read(item.profile_image_url),
+		affiliation_badge_url: read(affiliation.badge_url),
+		affiliation_description: read(affiliation.description),
+		affiliation_url: read(affiliation.url),
+		subscription_subscribes_to_you: toBool(subscription.subscribes_to_you),
+		followers_count: read(publicMetrics.followers_count),
+		following_count: read(publicMetrics.following_count),
+		tweet_count: read(publicMetrics.tweet_count),
+		listed_count: read(publicMetrics.listed_count),
+		like_count: read(publicMetrics.like_count),
+		media_count: read(publicMetrics.media_count),
+		raw: JSON.stringify(item)
+	};
+};
+const X_COLLECTIONS = [
+	{
+		key: "x_tweets",
+		table: "x_tweets_raw",
+		platform: "x",
+		requests: [{ path: "/users/:id/tweets" }],
+		ownIdToken: ":id",
+		pagination: xPagination,
+		pageSize: 100,
+		sinceField: "created_at",
+		lift: liftTweet
+	},
+	{
+		key: "x_followers",
+		table: "x_followers_raw",
+		platform: "x",
+		requests: [{ path: "/users/:id/followers" }],
+		ownIdToken: ":id",
+		requiresFullInitialSync: true,
+		pagination: xPagination,
+		pageSize: 1e3,
+		lift: liftXUser
+	},
+	{
+		key: "x_following",
+		table: "x_following_raw",
+		platform: "x",
+		requests: [{ path: "/users/:id/following" }],
+		ownIdToken: ":id",
+		requiresFullInitialSync: true,
+		pagination: xPagination,
+		pageSize: 1e3,
+		lift: liftXUser
+	},
+	{
+		key: "x_bookmarks",
+		table: "x_bookmarks_raw",
+		platform: "x",
+		requests: [{ path: "/users/:id/bookmarks" }],
+		ownIdToken: ":id",
+		pagination: xPagination,
+		pageSize: 100,
+		lift: liftBookmark
+	},
+	{
+		key: "x_messages",
+		table: "x_messages_raw",
+		platform: "x",
+		requests: [{
+			path: "/dm_events",
+			bakedQuery: {
+				"dm_event.fields": defaultDMEventFields,
+				expansions: defaultDMExpansions,
+				"user.fields": defaultDMUserFields
+			}
+		}],
+		pagination: xPagination,
+		pageSize: 100,
+		sinceField: "created_at",
+		lift: liftDMEvent
+	}
+];
+const X_CACHE_METADATA = {
+	joins: ["x_messages.sender_id = x_profiles.provider_id", "x_followers.id = x_profiles.provider_id"],
+	enums: {
+		"x_followers.verified_type": [
+			"blue",
+			"business",
+			"government",
+			"none"
+		],
+		"x_following.verified_type": [
+			"blue",
+			"business",
+			"government",
+			"none"
+		]
+	},
+	indexed: {
+		x_bookmarks: [
+			"created_at",
+			"author_id",
+			"conversation_id"
+		],
+		x_followers: [
+			"created_at",
+			"username",
+			"verified",
+			"verified_type"
+		],
+		x_following: [
+			"created_at",
+			"username",
+			"verified",
+			"verified_type"
+		],
+		x_messages: [
+			"created_at",
+			"conversation_id",
+			"sender_id"
+		],
+		x_profiles: ["username"],
+		x_tweets: [
+			"created_at",
+			"author_id",
+			"conversation_id"
+		]
 	}
-	return tables;
-};
-const assertPlatformQuery = (sql, platform) => {
-	const allowedTables = tablesForPlatform(platform);
-	const rejectedTables = new Set(knownTableTokens(sql).filter((table) => !allowedTables.has(table)));
-	if (rejectedTables.size > 0) throw new Error(`Cache SQL for ${platform} cannot read ${[...rejectedTables].sort().join(", ")}.`);
-};
-const referencedTablesForRead = (sql, platform) => {
-	const allowedTables = platformTables[platform];
-	return knownTableTokens(sql).filter((table) => allowedTables.has(table));
-};
-const collectionForReadTable = (table) => table === "x_raw_messages" ? "x_messages" : table;
-const collectionShortName = (collection) => collection.replace(/^(x|li)_/, "");
-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.`;
+//#endregion
+//#region ../../packages/sync-engine/src/collections/index.ts
+const COLLECTIONS = [...X_COLLECTIONS, ...LINKEDIN_COLLECTIONS];
+const CACHE_METADATA_BY_PLATFORM = {
+	linkedin: LINKEDIN_CACHE_METADATA,
+	x: X_CACHE_METADATA
 };
-const assertKnownProfileTable = (table) => {
-	assertKnownTable(table);
-	if (!profileTables.has(table)) throw new Error(`Unknown profile table: ${table}`);
+const collectionByKey = (key) => COLLECTIONS.find((collection) => collection.key === key);
+const collectionsFor = (platform) => COLLECTIONS.filter((collection) => collection.platform === platform);
+const syncableCollectionsFor = (platform) => {
+	const parentKeys = new Set(COLLECTIONS.map((collection) => collection.parentCollection).filter(Boolean));
+	return collectionsFor(platform).filter((collection) => !parentKeys.has(collection.key));
 };
-const cachePath = (args) => join(homedir(), ".social", "cache", `${args.platform}-${sanitizeAccountId(args.accountId)}.db`);
-const openCacheAt = (path, opts) => {
-	const dbPath = resolveCachePath(path);
-	if (opts?.readonly) {
-		const db = openDatabase(dbPath, { readonly: true });
-		assertAtLatest(db);
-		return createCache(dbPath, db);
-	}
-	if (dbPath !== ":memory:") mkdirSync(dirname(dbPath), { recursive: true });
-	const db = openDatabase(dbPath);
-	const result = migrate(db);
-	if (result.applied > 0) opts?.onMigrate?.(result);
-	return createCache(dbPath, db);
+const physicalTableFor = (collection) => collection.table ?? collection.key;
+const resetTablesFor = (collection) => {
+	if (!collection.parentCollection) return [collection];
+	const parent = collectionByKey(collection.parentCollection);
+	return parent ? [collection, parent] : [collection];
 };
-const openCache = (args) => openCacheAt(cachePath(args), {
-	readonly: args.readonly,
-	onMigrate: args.onMigrate
-});
-const createCache = (path, db) => ({
-	upsert: (table, rows, syncedAt = Date.now()) => {
-		if (rows.length === 0) return;
-		assertKnownTable(table);
-		const columns = [...Object.keys(rows[0] ?? {}).filter((column) => column !== "synced_at"), "synced_at"];
-		const updateColumns = columns.filter((column) => column !== "id");
-		const statement = db.prepare(`INSERT INTO ${quoteIdentifier(table)} (${columns.map(quoteIdentifier).join(", ")}) VALUES (${columns.map((column) => `:${column}`).join(", ")}) ON CONFLICT(id) DO UPDATE SET ${updateColumns.map((column) => `${quoteIdentifier(column)}=excluded.${quoteIdentifier(column)}`).join(", ")}`);
-		db.transaction(() => {
-			for (const row of rows) statement.run({
-				...row,
-				synced_at: syncedAt
-			});
-		});
-	},
-	upsertProfiles: (table, rows) => {
-		if (rows.length === 0) return;
-		assertKnownProfileTable(table);
-		const rowsByProviderId = /* @__PURE__ */ new Map();
-		for (const row of rows) rowsByProviderId.set(row.providerId, row);
-		const columns = [
-			"provider_id",
-			"handle",
-			"display_name",
-			"avatar_url",
-			"headline",
-			"raw",
-			"synced_at"
-		];
-		const quotedTable = quoteIdentifier(table);
-		const nullableColumns = [
-			"handle",
-			"avatar_url",
-			"headline"
-		];
-		const lastWriteColumns = [
-			"display_name",
-			"raw",
-			"synced_at"
-		];
-		const updateAssignments = [...nullableColumns.map((column) => `${quoteIdentifier(column)}=COALESCE(excluded.${quoteIdentifier(column)}, ${quotedTable}.${quoteIdentifier(column)})`), ...lastWriteColumns.map((column) => `${quoteIdentifier(column)}=excluded.${quoteIdentifier(column)}`)].join(", ");
-		const statement = db.prepare(`INSERT INTO ${quotedTable} (${columns.map(quoteIdentifier).join(", ")}) VALUES (${columns.map((column) => `:${column}`).join(", ")}) ON CONFLICT(provider_id) DO UPDATE SET ${updateAssignments}`);
-		const syncedAt = Date.now();
-		db.transaction(() => {
-			for (const row of rowsByProviderId.values()) statement.run({
-				provider_id: row.providerId,
-				handle: row.handle,
-				display_name: row.displayName,
-				avatar_url: row.avatarURL,
-				headline: row.headline,
-				raw: JSON.stringify(row.raw),
-				synced_at: syncedAt
-			});
-		});
+const resetPhysicalTablesFor = (collection) => resetTablesFor(collection).map(physicalTableFor);
+//#endregion
+//#region ../../packages/sync-engine/src/migrations.generated.ts
+const MIGRATIONS = [
+	{
+		"tag": "0000_modern_stephen_strange",
+		"sql": "CREATE TABLE `li_connections` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`object` text,\n	`url` text,\n	`user_id` text,\n	`user_object` text,\n	`user_type` text,\n	`user_display_name` text,\n	`user_public_identifier` text,\n	`user_profile_url` text,\n	`user_public_picture_url` text,\n	`user_description` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `li_connections_created_at_idx` ON `li_connections` (`created_at`);--> statement-breakpoint\nCREATE TABLE `li_conversations` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`last_message_timestamp` integer,\n	`muted_until` integer,\n	`creator_id` text,\n	`headline` text,\n	`image_url` text,\n	`name` text,\n	`object` text,\n	`provider` text,\n	`type` text,\n	`user_id` text,\n	`is_1to1` integer,\n	`is_archived` integer,\n	`is_channel` integer,\n	`is_group` integer,\n	`is_pinned` integer,\n	`is_readonly` integer,\n	`unread_count` integer,\n	`user_object` text,\n	`user_type` text,\n	`user_display_name` text,\n	`user_public_identifier` text,\n	`user_profile_url` text,\n	`user_public_picture_url` text,\n	`user_description` text,\n	`user_specifics_network_distance` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `li_conversations_created_at_idx` ON `li_conversations` (`created_at`);--> statement-breakpoint\nCREATE INDEX `li_conversations_last_message_timestamp_idx` ON `li_conversations` (`last_message_timestamp`);--> statement-breakpoint\nCREATE TABLE `li_messages` (\n	`id` text PRIMARY KEY NOT NULL,\n	`timestamp` integer,\n	`chat_id` text,\n	`object` text,\n	`provider` text,\n	`text` text,\n	`sender_id` text,\n	`is_deleted` integer,\n	`is_delivered` integer,\n	`is_edited` integer,\n	`is_event` integer,\n	`is_hidden` integer,\n	`is_mentionned` integer,\n	`is_pinned` integer,\n	`is_seen` integer,\n	`is_sender` integer,\n	`sender_object` text,\n	`sender_type` text,\n	`sender_display_name` text,\n	`sender_public_identifier` text,\n	`sender_profile_url` text,\n	`sender_public_picture_url` text,\n	`sender_description` text,\n	`sender_specifics_network_distance` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `li_messages_timestamp_idx` ON `li_messages` (`timestamp`);--> statement-breakpoint\nCREATE INDEX `li_messages_chat_id_idx` ON `li_messages` (`chat_id`);--> statement-breakpoint\nCREATE TABLE `li_posts` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`object` text,\n	`share_url` text,\n	`text` text,\n	`url` text,\n	`is_repost` integer,\n	`user_reacted` text,\n	`comments_counter` integer,\n	`reposts_counter` integer,\n	`analytics_impressions_counter` integer,\n	`author_id` text,\n	`author_object` text,\n	`author_type` text,\n	`author_display_name` text,\n	`author_public_identifier` text,\n	`author_profile_url` text,\n	`author_public_picture_url` text,\n	`author_description` text,\n	`author_specifics_network_distance` text,\n	`permissions_can_post_comments` integer,\n	`permissions_can_react` integer,\n	`permissions_can_share` integer,\n	`poll_id` text,\n	`poll_question` text,\n	`poll_is_open` integer,\n	`poll_total_votes_count` integer,\n	`quoted_post_id` text,\n	`quoted_post_object` text,\n	`quoted_post_created_at` integer,\n	`quoted_post_text` text,\n	`quoted_post_share_url` text,\n	`quoted_post_user_reacted` text,\n	`quoted_post_comments_counter` integer,\n	`quoted_post_reposts_counter` integer,\n	`quoted_post_permissions_can_post_comments` integer,\n	`quoted_post_permissions_can_react` integer,\n	`quoted_post_permissions_can_share` integer,\n	`quoted_post_author_id` text,\n	`quoted_post_author_object` text,\n	`quoted_post_author_type` text,\n	`quoted_post_author_display_name` text,\n	`quoted_post_author_public_identifier` text,\n	`quoted_post_author_profile_url` text,\n	`quoted_post_author_public_picture_url` text,\n	`quoted_post_author_description` text,\n	`quoted_post_author_specifics_network_distance` text,\n	`reposted_by_id` text,\n	`reposted_by_object` text,\n	`reposted_by_type` text,\n	`reposted_by_display_name` text,\n	`reposted_by_public_identifier` text,\n	`reposted_by_profile_url` text,\n	`reposted_by_public_picture_url` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `li_posts_created_at_idx` ON `li_posts` (`created_at`);--> statement-breakpoint\nCREATE TABLE `li_requests` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`object` text,\n	`type` text,\n	`user_id` text,\n	`user_object` text,\n	`user_type` text,\n	`user_display_name` text,\n	`user_public_identifier` text,\n	`user_profile_url` text,\n	`user_public_picture_url` text,\n	`user_description` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `li_requests_created_at_idx` ON `li_requests` (`created_at`);--> statement-breakpoint\nCREATE TABLE `sync_state` (\n	`collection` text PRIMARY KEY NOT NULL,\n	`cursor` text,\n	`last_synced` integer,\n	`object_count` integer\n);\n--> statement-breakpoint\nCREATE TABLE `x_bookmarks` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`author_id` text,\n	`conversation_id` text,\n	`in_reply_to_user_id` text,\n	`lang` text,\n	`reply_settings` text,\n	`text` text,\n	`url` text,\n	`paid_partnership` integer,\n	`possibly_sensitive` integer,\n	`edit_controls_editable_until` integer,\n	`edit_controls_edits_remaining` integer,\n	`edit_controls_is_edit_eligible` integer,\n	`like_count` integer,\n	`retweet_count` integer,\n	`reply_count` integer,\n	`quote_count` integer,\n	`bookmark_count` integer,\n	`impression_count` integer,\n	`article_cover_media` text,\n	`article_plain_text` text,\n	`article_preview_text` text,\n	`article_title` text,\n	`note_tweet_text` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `x_bookmarks_created_at_idx` ON `x_bookmarks` (`created_at`);--> statement-breakpoint\nCREATE TABLE `x_followers` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`username` text,\n	`name` text,\n	`description` text,\n	`location` text,\n	`url` text,\n	`is_identity_verified` integer,\n	`protected` integer,\n	`verified` integer,\n	`verified_type` text,\n	`subscription_type` text,\n	`parody` integer,\n	`most_recent_tweet_id` text,\n	`pinned_tweet_id` text,\n	`profile_banner_url` text,\n	`profile_image_url` text,\n	`affiliation_badge_url` text,\n	`affiliation_description` text,\n	`affiliation_url` text,\n	`subscription_subscribes_to_you` integer,\n	`followers_count` integer,\n	`following_count` integer,\n	`tweet_count` integer,\n	`listed_count` integer,\n	`like_count` integer,\n	`media_count` integer,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `x_followers_created_at_idx` ON `x_followers` (`created_at`);--> statement-breakpoint\nCREATE TABLE `x_following` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`username` text,\n	`name` text,\n	`description` text,\n	`location` text,\n	`url` text,\n	`is_identity_verified` integer,\n	`protected` integer,\n	`verified` integer,\n	`verified_type` text,\n	`subscription_type` text,\n	`parody` integer,\n	`most_recent_tweet_id` text,\n	`pinned_tweet_id` text,\n	`profile_banner_url` text,\n	`profile_image_url` text,\n	`affiliation_badge_url` text,\n	`affiliation_description` text,\n	`affiliation_url` text,\n	`subscription_subscribes_to_you` integer,\n	`followers_count` integer,\n	`following_count` integer,\n	`tweet_count` integer,\n	`listed_count` integer,\n	`like_count` integer,\n	`media_count` integer,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `x_following_created_at_idx` ON `x_following` (`created_at`);--> statement-breakpoint\nCREATE TABLE `x_tweets` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`author_id` text,\n	`conversation_id` text,\n	`in_reply_to_user_id` text,\n	`lang` text,\n	`reply_settings` text,\n	`text` text,\n	`url` text,\n	`paid_partnership` integer,\n	`possibly_sensitive` integer,\n	`edit_controls_editable_until` integer,\n	`edit_controls_edits_remaining` integer,\n	`edit_controls_is_edit_eligible` integer,\n	`like_count` integer,\n	`retweet_count` integer,\n	`reply_count` integer,\n	`quote_count` integer,\n	`bookmark_count` integer,\n	`impression_count` integer,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `x_tweets_created_at_idx` ON `x_tweets` (`created_at`);"
 	},
-	getCursor: (collection) => {
-		const row = db.prepare("SELECT cursor, last_synced, object_count FROM sync_state WHERE collection = :collection").get({ collection });
-		if (!row) return;
-		return {
-			cursor: stringOrNull(row.cursor),
-			lastSynced: numberOrNull(row.last_synced),
-			objectCount: numberOrNull(row.object_count)
-		};
+	{
+		"tag": "0001_far_beast",
+		"sql": "CREATE TABLE `li_profiles` (\n	`provider_id` text PRIMARY KEY NOT NULL,\n	`handle` text,\n	`display_name` text NOT NULL,\n	`avatar_url` text,\n	`headline` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `li_profiles_handle_idx` ON `li_profiles` (`handle`);--> statement-breakpoint\nCREATE TABLE `x_messages` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`dm_conversation_id` text,\n	`event_type` text,\n	`sender_id` text,\n	`text` text,\n	`participant_ids` text,\n	`attachments` text,\n	`entities` text,\n	`referenced_tweets` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `x_messages_created_at_idx` ON `x_messages` (`created_at`);--> statement-breakpoint\nCREATE INDEX `x_messages_dm_conversation_id_idx` ON `x_messages` (`dm_conversation_id`);--> statement-breakpoint\nCREATE TABLE `x_profiles` (\n	`provider_id` text PRIMARY KEY NOT NULL,\n	`handle` text,\n	`display_name` text NOT NULL,\n	`avatar_url` text,\n	`headline` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `x_profiles_handle_idx` ON `x_profiles` (`handle`);"
 	},
-	setCursor: (collection, cursor, objectCount, lastSynced = Date.now()) => {
-		db.prepare("INSERT INTO sync_state (collection, cursor, last_synced, object_count) VALUES (:collection, :cursor, :last_synced, :object_count) ON CONFLICT(collection) DO UPDATE SET cursor=excluded.cursor, last_synced=excluded.last_synced, object_count=excluded.object_count").run({
-			collection,
-			cursor,
-			last_synced: lastSynced,
-			object_count: objectCount
-		});
+	{
+		"tag": "0002_previous_spitfire",
+		"sql": "ALTER TABLE `li_connections` ADD `user_headline` text;--> statement-breakpoint\nALTER TABLE `li_requests` ADD `user_headline` text;--> statement-breakpoint\nALTER TABLE `x_bookmarks` DROP COLUMN `edit_controls_editable_until`;--> statement-breakpoint\nALTER TABLE `x_bookmarks` DROP COLUMN `edit_controls_edits_remaining`;--> statement-breakpoint\nALTER TABLE `x_bookmarks` DROP COLUMN `edit_controls_is_edit_eligible`;--> statement-breakpoint\nALTER TABLE `x_tweets` DROP COLUMN `edit_controls_editable_until`;--> statement-breakpoint\nALTER TABLE `x_tweets` DROP COLUMN `edit_controls_edits_remaining`;--> statement-breakpoint\nALTER TABLE `x_tweets` DROP COLUMN `edit_controls_is_edit_eligible`;"
 	},
-	reset: ({ tables, collections }) => {
-		for (const table of tables) assertKnownTable(table);
-		const results = [];
-		db.transaction(() => {
-			for (const table of tables) {
-				const result = db.prepare(`DELETE FROM ${quoteIdentifier(table)}`).run();
-				results.push({
-					table,
-					rowsDeleted: result?.changes ?? 0
-				});
-			}
-			const deleteState = db.prepare("DELETE FROM sync_state WHERE collection = :collection");
-			for (const collection of collections) deleteState.run({ collection });
-		});
-		return results;
+	{
+		"tag": "0003_wonderful_makkari",
+		"sql": "ALTER TABLE `li_conversations` RENAME COLUMN \"headline\" TO \"user_headline\";--> statement-breakpoint\nCREATE INDEX `li_conversations_user_id_last_message_timestamp_idx` ON `li_conversations` (`user_id`,`last_message_timestamp`);--> statement-breakpoint\nCREATE INDEX `li_conversations_user_public_identifier_last_message_timestamp_idx` ON `li_conversations` (`user_public_identifier`,`last_message_timestamp`);--> statement-breakpoint\nCREATE INDEX `li_conversations_user_display_name_idx` ON `li_conversations` (`user_display_name`);--> statement-breakpoint\nCREATE INDEX `li_conversations_is_archived_last_message_timestamp_idx` ON `li_conversations` (`is_archived`,`last_message_timestamp`);--> statement-breakpoint\nDROP INDEX `li_messages_chat_id_idx`;--> statement-breakpoint\nCREATE INDEX `li_messages_chat_id_timestamp_idx` ON `li_messages` (`chat_id`,`timestamp`);--> statement-breakpoint\nCREATE INDEX `li_messages_sender_id_timestamp_idx` ON `li_messages` (`sender_id`,`timestamp`);--> statement-breakpoint\nDROP INDEX `x_messages_dm_conversation_id_idx`;--> statement-breakpoint\nCREATE INDEX `x_messages_dm_conversation_id_created_at_idx` ON `x_messages` (`dm_conversation_id`,`created_at`);--> statement-breakpoint\nCREATE INDEX `x_messages_sender_id_created_at_idx` ON `x_messages` (`sender_id`,`created_at`);--> statement-breakpoint\nCREATE INDEX `li_connections_synced_at_idx` ON `li_connections` (`synced_at`);--> statement-breakpoint\nCREATE INDEX `li_connections_user_id_idx` ON `li_connections` (`user_id`);--> statement-breakpoint\nCREATE INDEX `li_connections_user_public_identifier_idx` ON `li_connections` (`user_public_identifier`);--> statement-breakpoint\nCREATE INDEX `li_connections_user_display_name_idx` ON `li_connections` (`user_display_name`);--> statement-breakpoint\nCREATE INDEX `li_posts_author_id_created_at_idx` ON `li_posts` (`author_id`,`created_at`);--> statement-breakpoint\nCREATE INDEX `li_posts_author_public_identifier_created_at_idx` ON `li_posts` (`author_public_identifier`,`created_at`);--> statement-breakpoint\nCREATE INDEX `li_requests_type_synced_at_idx` ON `li_requests` (`type`,`synced_at`);--> statement-breakpoint\nCREATE INDEX `li_requests_user_id_idx` ON `li_requests` (`user_id`);--> statement-breakpoint\nCREATE INDEX `li_requests_user_public_identifier_idx` ON `li_requests` (`user_public_identifier`);--> statement-breakpoint\nCREATE INDEX `li_requests_user_display_name_idx` ON `li_requests` (`user_display_name`);--> statement-breakpoint\nCREATE INDEX `x_bookmarks_author_id_created_at_idx` ON `x_bookmarks` (`author_id`,`created_at`);--> statement-breakpoint\nCREATE INDEX `x_bookmarks_conversation_id_created_at_idx` ON `x_bookmarks` (`conversation_id`,`created_at`);--> statement-breakpoint\nCREATE INDEX `x_followers_synced_at_idx` ON `x_followers` (`synced_at`);--> statement-breakpoint\nCREATE INDEX `x_followers_username_idx` ON `x_followers` (`username`);--> statement-breakpoint\nCREATE INDEX `x_followers_verified_idx` ON `x_followers` (`verified`);--> statement-breakpoint\nCREATE INDEX `x_followers_verified_type_idx` ON `x_followers` (`verified_type`);--> statement-breakpoint\nCREATE INDEX `x_following_synced_at_idx` ON `x_following` (`synced_at`);--> statement-breakpoint\nCREATE INDEX `x_following_username_idx` ON `x_following` (`username`);--> statement-breakpoint\nCREATE INDEX `x_following_verified_idx` ON `x_following` (`verified`);--> statement-breakpoint\nCREATE INDEX `x_following_verified_type_idx` ON `x_following` (`verified_type`);--> statement-breakpoint\nCREATE INDEX `x_tweets_author_id_created_at_idx` ON `x_tweets` (`author_id`,`created_at`);--> statement-breakpoint\nCREATE INDEX `x_tweets_conversation_id_created_at_idx` ON `x_tweets` (`conversation_id`,`created_at`);"
 	},
-	query: (sql, opts) => {
-		if (opts?.platform) assertPlatformQuery(sql, opts.platform);
-		return db.prepare(sql).all();
+	{
+		"tag": "0004_quiet_prism",
+		"sql": "ALTER TABLE `x_messages` RENAME TO `x_raw_messages`;--> statement-breakpoint\nCREATE VIEW `x_messages` AS\nSELECT m.*, p.handle AS sender_handle, p.display_name AS sender_name,\n       p.avatar_url AS sender_avatar_url, p.headline AS sender_headline\nFROM `x_raw_messages` m LEFT JOIN `x_profiles` p ON m.sender_id = p.provider_id;\n"
 	},
-	read: (sql, opts) => {
-		assertPlatformQuery(sql, opts.platform);
-		const tables = referencedTablesForRead(sql, opts.platform).map((name) => {
-			const collection = collectionForReadTable(name);
-			return {
-				name,
-				collection,
-				lastSynced: numberOrNull(db.prepare("SELECT last_synced FROM sync_state WHERE collection = :collection").get({ collection })?.last_synced)
-			};
-		});
-		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));
-		return {
-			rows: db.prepare(sql).all(),
-			tables: tables.map(({ name, lastSynced }) => ({
-				name,
-				lastSynced
-			}))
-		};
+	{
+		"tag": "0005_raw_table_views",
+		"sql": "DROP VIEW IF EXISTS \"x_messages\";\nALTER TABLE \"x_tweets\" RENAME TO \"x_tweets_raw\";\nALTER TABLE \"x_bookmarks\" RENAME TO \"x_bookmarks_raw\";\nALTER TABLE \"x_followers\" RENAME TO \"x_followers_raw\";\nALTER TABLE \"x_following\" RENAME TO \"x_following_raw\";\nALTER TABLE \"x_profiles\" RENAME TO \"x_profiles_raw\";\nALTER TABLE \"x_raw_messages\" RENAME TO \"x_messages_raw\";\nALTER TABLE \"li_connections\" RENAME TO \"li_connections_raw\";\nALTER TABLE \"li_profiles\" RENAME TO \"li_profiles_raw\";\nALTER TABLE \"li_conversations\" RENAME TO \"li_conversations_raw\";\nALTER TABLE \"li_messages\" RENAME TO \"li_messages_raw\";\nALTER TABLE \"li_posts\" RENAME TO \"li_posts_raw\";\nALTER TABLE \"li_requests\" RENAME TO \"li_requests_raw\";\nCREATE VIEW \"x_tweets\" AS\nSELECT \"id\", \"created_at\", \"author_id\", \"conversation_id\", \"in_reply_to_user_id\", \"lang\",\n       \"reply_settings\", \"text\", \"url\", \"paid_partnership\", \"possibly_sensitive\",\n       \"like_count\", \"retweet_count\", \"reply_count\", \"quote_count\", \"bookmark_count\",\n       \"impression_count\"\nFROM \"x_tweets_raw\";\nCREATE VIEW \"x_bookmarks\" AS\nSELECT \"id\", \"created_at\", \"author_id\", \"conversation_id\", \"in_reply_to_user_id\", \"lang\",\n       \"reply_settings\", \"text\", \"url\", \"paid_partnership\", \"possibly_sensitive\",\n       \"like_count\", \"retweet_count\", \"reply_count\", \"quote_count\", \"bookmark_count\",\n       \"impression_count\", \"article_cover_media\", \"article_plain_text\",\n       \"article_preview_text\", \"article_title\", \"note_tweet_text\"\nFROM \"x_bookmarks_raw\";\nCREATE VIEW \"x_followers\" AS\nSELECT \"id\", \"created_at\", \"username\", \"name\", \"description\", \"location\", \"url\",\n       \"verified\", \"verified_type\", \"is_identity_verified\", \"protected\",\n       \"subscription_type\", \"parody\", \"followers_count\", \"following_count\",\n       \"tweet_count\", \"listed_count\", \"like_count\", \"media_count\", \"most_recent_tweet_id\",\n       \"pinned_tweet_id\", \"profile_image_url\" AS \"avatar_url\", \"profile_banner_url\",\n       \"affiliation_description\", \"affiliation_url\", \"affiliation_badge_url\",\n       \"subscription_subscribes_to_you\"\nFROM \"x_followers_raw\";\nCREATE VIEW \"x_following\" AS\nSELECT \"id\", \"created_at\", \"username\", \"name\", \"description\", \"location\", \"url\",\n       \"verified\", \"verified_type\", \"is_identity_verified\", \"protected\",\n       \"subscription_type\", \"parody\", \"followers_count\", \"following_count\",\n       \"tweet_count\", \"listed_count\", \"like_count\", \"media_count\", \"most_recent_tweet_id\",\n       \"pinned_tweet_id\", \"profile_image_url\" AS \"avatar_url\", \"profile_banner_url\",\n       \"affiliation_description\", \"affiliation_url\", \"affiliation_badge_url\",\n       \"subscription_subscribes_to_you\"\nFROM \"x_following_raw\";\nCREATE VIEW \"x_messages\" AS\nSELECT m.\"id\", m.\"created_at\", m.\"dm_conversation_id\" AS \"conversation_id\",\n       m.\"event_type\", m.\"sender_id\", m.\"text\", m.\"participant_ids\", m.\"attachments\",\n       m.\"entities\", m.\"referenced_tweets\", p.\"handle\" AS \"sender_username\",\n       p.\"display_name\" AS \"sender_name\", p.\"avatar_url\" AS \"sender_avatar_url\",\n       p.\"headline\" AS \"sender_headline\"\nFROM \"x_messages_raw\" m\nLEFT JOIN \"x_profiles_raw\" p ON m.\"sender_id\" = p.\"provider_id\";\nCREATE VIEW \"x_profiles\" AS\nSELECT \"provider_id\", \"handle\" AS \"username\", \"display_name\" AS \"name\", \"avatar_url\",\n       \"headline\", json_extract(\"raw\", '$.receives_your_dm') AS \"receives_your_dm\"\nFROM \"x_profiles_raw\";\nCREATE VIEW \"li_profiles\" AS\nSELECT \"provider_id\", \"handle\" AS \"username\", \"display_name\" AS \"name\", \"avatar_url\",\n       \"headline\"\nFROM \"li_profiles_raw\";\nCREATE VIEW \"li_connections\" AS\nSELECT \"id\", \"created_at\", \"url\", \"user_id\", \"user_public_identifier\" AS \"user_username\",\n       \"user_display_name\" AS \"user_name\", \"user_headline\", \"user_description\",\n       \"user_profile_url\", \"user_public_picture_url\" AS \"user_avatar_url\", \"user_type\"\nFROM \"li_connections_raw\";\nCREATE VIEW \"li_requests\" AS\nSELECT \"id\", \"created_at\", \"type\", json_extract(\"raw\", '$.message') AS \"message\",\n       \"user_id\", \"user_public_identifier\" AS \"user_username\",\n       \"user_display_name\" AS \"user_name\", \"user_headline\", \"user_description\",\n       \"user_profile_url\", \"user_public_picture_url\" AS \"user_avatar_url\", \"user_type\"\nFROM \"li_requests_raw\";\nCREATE VIEW \"li_conversations\" AS\nSELECT \"id\", \"created_at\", \"last_message_timestamp\" AS \"last_message_at\", \"name\",\n       CASE\n         WHEN \"is_1to1\" = 1 THEN '1to1'\n         WHEN \"is_group\" = 1 THEN 'group'\n         ELSE \"type\"\n       END AS \"type\",\n       \"unread_count\", \"is_archived\", \"is_pinned\", \"is_readonly\", \"is_channel\",\n       \"muted_until\", \"image_url\", \"creator_id\", \"user_id\",\n       \"user_public_identifier\" AS \"user_username\", \"user_display_name\" AS \"user_name\",\n       \"user_headline\", \"user_description\", \"user_profile_url\",\n       \"user_public_picture_url\" AS \"user_avatar_url\", \"user_type\",\n       \"user_specifics_network_distance\" AS \"user_distance\"\nFROM \"li_conversations_raw\";\nCREATE VIEW \"li_messages\" AS\nSELECT \"id\", \"timestamp\" AS \"created_at\", \"chat_id\" AS \"conversation_id\", \"text\",\n       \"sender_id\", \"is_deleted\", \"is_delivered\", \"is_edited\", \"is_event\", \"is_hidden\",\n       \"is_mentionned\" AS \"is_mentioned\", \"is_pinned\", \"is_seen\", \"is_sender\",\n       \"sender_public_identifier\" AS \"sender_username\",\n       \"sender_display_name\" AS \"sender_name\", \"sender_description\" AS \"sender_headline\",\n       \"sender_public_picture_url\" AS \"sender_avatar_url\", \"sender_profile_url\",\n       \"sender_type\", \"sender_specifics_network_distance\" AS \"sender_distance\"\nFROM \"li_messages_raw\";\nCREATE VIEW \"li_posts\" AS\nSELECT \"id\", \"created_at\", \"text\", \"url\", \"share_url\", \"is_repost\", \"user_reacted\",\n       \"comments_counter\", \"reposts_counter\",\n       \"analytics_impressions_counter\" AS \"impressions_counter\", \"author_id\",\n       \"author_public_identifier\" AS \"author_username\",\n       \"author_display_name\" AS \"author_name\", \"author_description\", \"author_profile_url\",\n       \"author_public_picture_url\" AS \"author_avatar_url\", \"author_type\",\n       \"author_specifics_network_distance\" AS \"author_distance\", \"poll_id\", \"poll_question\",\n       \"poll_is_open\", \"poll_total_votes_count\", \"quoted_post_id\", \"quoted_post_created_at\",\n       \"quoted_post_text\", \"quoted_post_author_public_identifier\" AS \"quoted_post_author_username\",\n       \"quoted_post_author_display_name\" AS \"quoted_post_author_name\", \"reposted_by_id\",\n       \"reposted_by_public_identifier\" AS \"reposted_by_username\",\n       \"reposted_by_display_name\" AS \"reposted_by_name\"\nFROM \"li_posts_raw\";\n"
 	},
-	describe: (opts) => {
-		const allowedTables = opts?.platform ? tablesForPlatform(opts.platform) : void 0;
-		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) => {
-				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)
-				};
-			})
-		};
+	{
+		"tag": "0006_username_profiles",
+		"sql": "DROP VIEW IF EXISTS \"x_messages\";\nDROP VIEW IF EXISTS \"x_profiles\";\nDROP VIEW IF EXISTS \"li_profiles\";\nALTER TABLE \"x_profiles_raw\" RENAME COLUMN \"handle\" TO \"username\";\nALTER TABLE \"li_profiles_raw\" RENAME COLUMN \"handle\" TO \"username\";\nDROP INDEX IF EXISTS \"x_profiles_handle_idx\";\nDROP INDEX IF EXISTS \"li_profiles_handle_idx\";\nCREATE INDEX \"x_profiles_username_idx\" ON \"x_profiles_raw\" (\"username\");\nCREATE INDEX \"li_profiles_username_idx\" ON \"li_profiles_raw\" (\"username\");\nCREATE VIEW \"x_messages\" AS\nSELECT m.\"id\", m.\"created_at\", m.\"dm_conversation_id\" AS \"conversation_id\",\n       m.\"event_type\", m.\"sender_id\", m.\"text\", m.\"participant_ids\", m.\"attachments\",\n       m.\"entities\", m.\"referenced_tweets\", p.\"username\" AS \"sender_username\",\n       p.\"display_name\" AS \"sender_name\", p.\"avatar_url\" AS \"sender_avatar_url\",\n       p.\"headline\" AS \"sender_headline\"\nFROM \"x_messages_raw\" m\nLEFT JOIN \"x_profiles_raw\" p ON m.\"sender_id\" = p.\"provider_id\";\nCREATE VIEW \"x_profiles\" AS\nSELECT \"provider_id\", \"username\", \"display_name\" AS \"name\", \"avatar_url\",\n       \"headline\", json_extract(\"raw\", '$.receives_your_dm') AS \"receives_your_dm\"\nFROM \"x_profiles_raw\";\nCREATE VIEW \"li_profiles\" AS\nSELECT \"provider_id\", \"username\", \"display_name\" AS \"name\", \"avatar_url\", \"headline\"\nFROM \"li_profiles_raw\";\n"
 	},
-	close: () => {
-		db.close();
+	{
+		"tag": "0007_connection_headline_coalesce",
+		"sql": "DROP VIEW IF EXISTS \"li_connections\";\nDROP VIEW IF EXISTS \"li_requests\";\nDROP VIEW IF EXISTS \"li_conversations\";\nCREATE VIEW \"li_connections\" AS\nSELECT \"id\", \"created_at\", \"url\", \"user_id\", \"user_public_identifier\" AS \"user_username\",\n       \"user_display_name\" AS \"user_name\",\n       COALESCE(\"user_headline\", \"user_description\") AS \"user_headline\", \"user_description\",\n       \"user_profile_url\", \"user_public_picture_url\" AS \"user_avatar_url\", \"user_type\"\nFROM \"li_connections_raw\";\nCREATE VIEW \"li_requests\" AS\nSELECT \"id\", \"created_at\", \"type\", json_extract(\"raw\", '$.message') AS \"message\",\n       \"user_id\", \"user_public_identifier\" AS \"user_username\",\n       \"user_display_name\" AS \"user_name\",\n       COALESCE(\"user_headline\", \"user_description\") AS \"user_headline\", \"user_description\",\n       \"user_profile_url\", \"user_public_picture_url\" AS \"user_avatar_url\", \"user_type\"\nFROM \"li_requests_raw\";\nCREATE VIEW \"li_conversations\" AS\nSELECT \"id\", \"created_at\", \"last_message_timestamp\" AS \"last_message_at\", \"name\",\n       CASE\n         WHEN \"is_1to1\" = 1 THEN '1to1'\n         WHEN \"is_group\" = 1 THEN 'group'\n         ELSE \"type\"\n       END AS \"type\",\n       \"unread_count\", \"is_archived\", \"is_pinned\", \"is_readonly\", \"is_channel\",\n       \"muted_until\", \"image_url\", \"creator_id\", \"user_id\",\n       \"user_public_identifier\" AS \"user_username\", \"user_display_name\" AS \"user_name\",\n       COALESCE(\"user_headline\", \"user_description\") AS \"user_headline\", \"user_description\",\n       \"user_profile_url\", \"user_public_picture_url\" AS \"user_avatar_url\", \"user_type\",\n       \"user_specifics_network_distance\" AS \"user_distance\"\nFROM \"li_conversations_raw\";\n"
 	}
-});
+];
 //#endregion
-//#region ../../packages/sync-engine/src/collections/linkedin.ts
-const linkedinCursorPagination = {
-	style: "cursor",
-	limitParam: "limit",
-	cursorParam: "cursor",
-	cursorPath: "next_cursor",
-	totalCountPath: "total_count",
-	itemsPath: "data"
+//#region ../../packages/sync-engine/src/migrate.ts
+const readUserVersion = (db) => {
+	const version = db.prepare("PRAGMA user_version").get()?.user_version;
+	return typeof version === "number" ? version : Number(version ?? 0);
 };
-const linkedinRelationsCursorPagination = {
-	style: "cursor",
-	limitParam: "limit",
-	cursorParam: "cursor",
-	cursorPath: "next_cursor",
-	itemsPath: "data"
+const setUserVersion = (db, version) => {
+	db.exec(`PRAGMA user_version = ${version}`);
 };
-const linkedinOffsetPagination = {
-	style: "offset",
-	limitParam: "limit",
-	offsetParam: "offset",
-	totalCountPath: "total_count",
-	itemsPath: "data"
+const migrate = (db) => {
+	const currentVersion = readUserVersion(db);
+	if (currentVersion >= MIGRATIONS.length) return {
+		fromVersion: currentVersion,
+		toVersion: currentVersion,
+		applied: 0
+	};
+	for (let index = currentVersion; index < MIGRATIONS.length; index += 1) {
+		const migration = MIGRATIONS[index];
+		if (!migration) throw new Error(`Missing migration at index ${index}`);
+		db.transaction(() => {
+			db.exec(migration.sql);
+			setUserVersion(db, index + 1);
+		});
+	}
+	return {
+		fromVersion: currentVersion,
+		toVersion: MIGRATIONS.length,
+		applied: MIGRATIONS.length - currentVersion
+	};
 };
-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;
-const trimmed$1 = (value) => typeof value === "string" ? value.trim() || void 0 : void 0;
-const userHeadline = (user) => {
-	const specifics = asRecord$1(user.specifics);
-	return trimmed$1(user.description) ?? trimmed$1(user.headline) ?? trimmed$1(specifics.description) ?? trimmed$1(specifics.headline) ?? trimmed$1(specifics.occupation) ?? null;
+const assertAtLatest = (db) => {
+	const currentVersion = readUserVersion(db);
+	if (currentVersion < MIGRATIONS.length) throw new Error(`Local SQLite cache schema is at version ${currentVersion}; expected ${MIGRATIONS.length}`);
+};
+//#endregion
+//#region ../../packages/sync-engine/src/sqlite.ts
+const loadModule = createRequire(import.meta.url);
+const isBunRuntime = () => typeof Bun !== "undefined";
+const normalizeValue = (value) => {
+	if (value === null || value === void 0) return null;
+	if (typeof value === "boolean") return value ? 1 : 0;
+	return value;
+};
+const normalizeParams$1 = (params) => {
+	if (!params) return;
+	return Object.fromEntries(Object.entries(params).map(([key, value]) => [key, normalizeValue(value)]));
 };
-const isoToEpochMs$1 = (value) => {
-	if (typeof value === "number") return Number.isFinite(value) ? value : null;
-	if (typeof value !== "string") return null;
-	const epochMs = Date.parse(value);
-	return Number.isNaN(epochMs) ? null : epochMs;
+const invokeWithParams = (fn, params) => {
+	const normalizedParams = normalizeParams$1(params);
+	return normalizedParams ? fn(normalizedParams) : fn();
 };
-const toBool$1 = (value) => {
-	if (typeof value !== "boolean") return null;
-	return value ? 1 : 0;
+const wrapStatement = (statement) => ({
+	run: (params) => invokeWithParams(statement.run.bind(statement), params),
+	get: (params) => invokeWithParams(statement.get.bind(statement), params),
+	all: (params) => invokeWithParams(statement.all.bind(statement), params)
+});
+const openRuntimeDatabase = (path, opts) => {
+	if (isBunRuntime()) {
+		const { Database } = loadModule("bun:sqlite");
+		return new Database(path, {
+			readonly: opts?.readonly,
+			strict: true
+		});
+	}
+	const { DatabaseSync } = loadModule("node:sqlite");
+	return opts?.readonly ? new DatabaseSync(path, { readOnly: true }) : new DatabaseSync(path);
 };
-const liftConnection = (item) => {
-	const user = asRecord$1(item.user);
-	return {
-		id: read$1(item.id),
-		created_at: isoToEpochMs$1(item.created_at),
-		object: read$1(item.object),
-		url: read$1(item.url),
-		user_id: read$1(user.id),
-		user_object: read$1(user.object),
-		user_type: read$1(user.type),
-		user_display_name: read$1(user.display_name),
-		user_public_identifier: read$1(user.public_identifier),
-		user_profile_url: read$1(user.profile_url),
-		user_public_picture_url: read$1(user.public_picture_url),
-		user_description: read$1(user.description),
-		user_headline: userHeadline(user),
-		raw: JSON.stringify(item)
+const openDatabase = (path, opts) => {
+	const database = openRuntimeDatabase(path, opts);
+	const exec = (sql) => {
+		database.exec(sql);
 	};
-};
-const liftConversation = (item) => {
-	const user = asRecord$1(item.user);
-	const userSpecifics = asRecord$1(user.specifics);
 	return {
-		id: read$1(item.id),
-		created_at: isoToEpochMs$1(item.created_at),
-		last_message_timestamp: isoToEpochMs$1(item.last_message_timestamp),
-		muted_until: isoToEpochMs$1(item.muted_until),
-		creator_id: read$1(item.creator_id),
-		user_headline: userHeadline(user),
-		image_url: read$1(item.image_url),
-		name: read$1(item.name),
-		object: read$1(item.object),
-		provider: read$1(item.provider),
-		type: read$1(item.type),
-		user_id: read$1(item.user_id ?? user.id),
-		is_1to1: toBool$1(item.is_1to1),
-		is_archived: toBool$1(item.is_archived),
-		is_channel: toBool$1(item.is_channel),
-		is_group: toBool$1(item.is_group),
-		is_pinned: toBool$1(item.is_pinned),
-		is_readonly: toBool$1(item.is_readonly),
-		unread_count: read$1(item.unread_count),
-		user_object: read$1(user.object),
-		user_type: read$1(user.type),
-		user_display_name: read$1(user.display_name),
-		user_public_identifier: read$1(user.public_identifier),
-		user_profile_url: read$1(user.profile_url),
-		user_public_picture_url: read$1(user.public_picture_url),
-		user_description: read$1(user.description),
-		user_specifics_network_distance: read$1(userSpecifics.network_distance),
-		raw: JSON.stringify(item)
+		exec,
+		prepare: (sql) => wrapStatement(database.prepare(sql)),
+		transaction: (fn) => {
+			exec("BEGIN");
+			try {
+				fn();
+				exec("COMMIT");
+			} catch (error) {
+				exec("ROLLBACK");
+				throw error;
+			}
+		},
+		close: () => {
+			database.close();
+		}
 	};
 };
-const liftMessage = (item) => {
-	const sender = asRecord$1(item.sender);
-	const senderSpecifics = asRecord$1(sender.specifics);
-	return {
-		id: read$1(item.id),
-		timestamp: isoToEpochMs$1(item.timestamp),
-		chat_id: read$1(item.chat_id ?? null),
-		object: read$1(item.object),
-		provider: read$1(item.provider),
-		text: read$1(item.text),
-		sender_id: read$1(item.sender_id),
-		is_deleted: toBool$1(item.is_deleted),
-		is_delivered: toBool$1(item.is_delivered),
-		is_edited: toBool$1(item.is_edited),
-		is_event: toBool$1(item.is_event),
-		is_hidden: toBool$1(item.is_hidden),
-		is_mentionned: toBool$1(item.is_mentionned),
-		is_pinned: toBool$1(item.is_pinned),
-		is_seen: toBool$1(item.is_seen),
-		is_sender: toBool$1(item.is_sender),
-		sender_object: read$1(sender.object),
-		sender_type: read$1(sender.type),
-		sender_display_name: read$1(sender.display_name),
-		sender_public_identifier: read$1(sender.public_identifier),
-		sender_profile_url: read$1(sender.profile_url),
-		sender_public_picture_url: read$1(sender.public_picture_url),
-		sender_description: read$1(sender.description),
-		sender_specifics_network_distance: read$1(senderSpecifics.network_distance),
-		raw: JSON.stringify(item)
-	};
+//#endregion
+//#region ../../packages/sync-engine/src/cache.ts
+var NeverSyncedError = class extends Error {
+	name = "NeverSyncedError";
+	tables;
+	constructor(tables, message) {
+		super(message);
+		this.tables = tables;
+	}
 };
-const liftPost = (item) => {
-	const analytics = asRecord$1(item.analytics);
-	const author = asRecord$1(item.author);
-	const authorSpecifics = asRecord$1(author.specifics);
-	const permissions = asRecord$1(item.permissions);
-	const poll = asRecord$1(item.poll);
-	const quotedPost = asRecord$1(item.quoted_post);
-	const quotedPostPermissions = asRecord$1(quotedPost.permissions);
-	const quotedPostAuthor = asRecord$1(quotedPost.author);
-	const quotedPostAuthorSpecifics = asRecord$1(quotedPostAuthor.specifics);
-	const repostedBy = asRecord$1(item.reposted_by);
-	return {
-		id: read$1(item.id),
-		created_at: isoToEpochMs$1(item.created_at),
-		object: read$1(item.object),
-		share_url: read$1(item.share_url),
-		text: read$1(item.text),
-		url: read$1(item.url),
-		is_repost: toBool$1(item.is_repost),
-		user_reacted: readReaction(item.user_reacted),
-		comments_counter: read$1(item.comments_counter),
-		reposts_counter: read$1(item.reposts_counter),
-		analytics_impressions_counter: read$1(analytics.impressions_counter),
-		author_id: read$1(author.id),
-		author_object: read$1(author.object),
-		author_type: read$1(author.type),
-		author_display_name: read$1(author.display_name),
-		author_public_identifier: read$1(author.public_identifier),
-		author_profile_url: read$1(author.profile_url),
-		author_public_picture_url: read$1(author.public_picture_url),
-		author_description: read$1(author.description),
-		author_specifics_network_distance: read$1(authorSpecifics.network_distance),
-		permissions_can_post_comments: toBool$1(permissions.can_post_comments),
-		permissions_can_react: toBool$1(permissions.can_react),
-		permissions_can_share: toBool$1(permissions.can_share),
-		poll_id: read$1(poll.id),
-		poll_question: read$1(poll.question),
-		poll_is_open: toBool$1(poll.is_open),
-		poll_total_votes_count: read$1(poll.total_votes_count),
-		quoted_post_id: read$1(quotedPost.id),
-		quoted_post_object: read$1(quotedPost.object),
-		quoted_post_created_at: isoToEpochMs$1(quotedPost.created_at),
-		quoted_post_text: read$1(quotedPost.text),
-		quoted_post_share_url: read$1(quotedPost.share_url),
-		quoted_post_user_reacted: readReaction(quotedPost.user_reacted),
-		quoted_post_comments_counter: read$1(quotedPost.comments_counter),
-		quoted_post_reposts_counter: read$1(quotedPost.reposts_counter),
-		quoted_post_permissions_can_post_comments: toBool$1(quotedPostPermissions.can_post_comments),
-		quoted_post_permissions_can_react: toBool$1(quotedPostPermissions.can_react),
-		quoted_post_permissions_can_share: toBool$1(quotedPostPermissions.can_share),
-		quoted_post_author_id: read$1(quotedPostAuthor.id),
-		quoted_post_author_object: read$1(quotedPostAuthor.object),
-		quoted_post_author_type: read$1(quotedPostAuthor.type),
-		quoted_post_author_display_name: read$1(quotedPostAuthor.display_name),
-		quoted_post_author_public_identifier: read$1(quotedPostAuthor.public_identifier),
-		quoted_post_author_profile_url: read$1(quotedPostAuthor.profile_url),
-		quoted_post_author_public_picture_url: read$1(quotedPostAuthor.public_picture_url),
-		quoted_post_author_description: read$1(quotedPostAuthor.description),
-		quoted_post_author_specifics_network_distance: read$1(quotedPostAuthorSpecifics.network_distance),
-		reposted_by_id: read$1(repostedBy.id),
-		reposted_by_object: read$1(repostedBy.object),
-		reposted_by_type: read$1(repostedBy.type),
-		reposted_by_display_name: read$1(repostedBy.display_name),
-		reposted_by_public_identifier: read$1(repostedBy.public_identifier),
-		reposted_by_profile_url: read$1(repostedBy.profile_url),
-		reposted_by_public_picture_url: read$1(repostedBy.public_picture_url),
-		raw: JSON.stringify(item)
-	};
+const publicCacheTables = [
+	"x_tweets",
+	"x_followers",
+	"x_following",
+	"x_bookmarks",
+	"x_profiles",
+	"x_messages",
+	"li_conversations",
+	"li_messages",
+	"li_connections",
+	"li_posts",
+	"li_profiles",
+	"li_requests",
+	"sync_state"
+];
+const rawCacheTables = publicCacheTables.filter((table) => table !== "sync_state").map((table) => `${table}_raw`);
+const cacheTables = new Set([...publicCacheTables, ...rawCacheTables]);
+const profileTables = new Set(["x_profiles_raw", "li_profiles_raw"]);
+const sharedTables = new Set(["sync_state"]);
+const platformTables = {
+	linkedin: new Set([...cacheTables].filter((table) => table.startsWith("li_"))),
+	x: new Set([...cacheTables].filter((table) => table.startsWith("x_")))
 };
-const liftRequest = (item) => {
-	const user = asRecord$1(item.user);
-	return {
-		id: read$1(item.id),
-		created_at: isoToEpochMs$1(item.created_at),
-		object: read$1(item.object),
-		type: read$1(item.type ?? null),
-		user_id: read$1(user.id),
-		user_object: read$1(user.object),
-		user_type: read$1(user.type),
-		user_display_name: read$1(user.display_name),
-		user_public_identifier: read$1(user.public_identifier),
-		user_profile_url: read$1(user.profile_url),
-		user_public_picture_url: read$1(user.public_picture_url),
-		user_description: read$1(user.description),
-		user_headline: userHeadline(user),
-		raw: JSON.stringify(item)
-	};
+const sanitizeAccountId = (accountId) => accountId.replaceAll(/[^A-Za-z0-9._-]/g, "_");
+const quoteIdentifier = (identifier) => `\`${identifier.replaceAll("`", "``")}\``;
+const resolveCachePath = (path) => path === ":memory:" ? path : resolve(path);
+const rawTableFor = (table) => table === "sync_state" ? table : `${table}_raw`;
+const collectionForReadTable = (table) => table.endsWith("_raw") ? table.slice(0, -4) : table;
+const physicalTableForCacheTable = (table) => table === "sync_state" || table.endsWith("_raw") ? table : rawTableFor(table);
+const stringOrNull = (value) => typeof value === "string" ? value : null;
+const numberOrNull = (value) => typeof value === "number" ? value : null;
+const assertKnownTable = (table) => {
+	if (!cacheTables.has(table)) throw new Error(`Unknown cache table: ${table}`);
+};
+const tablesForPlatform = (platform) => new Set([...platformTables[platform], ...sharedTables]);
+const knownTableTokens = (sql) => {
+	const tokens = sql.match(/\b[A-Za-z_][A-Za-z0-9_]*\b/g) ?? [];
+	const tables = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const token of tokens) {
+		const table = token.toLowerCase();
+		if (cacheTables.has(table) && !seen.has(table)) {
+			seen.add(table);
+			tables.push(table);
+		}
+	}
+	return tables;
 };
-const LINKEDIN_COLLECTIONS = [
-	{
-		key: "li_conversations",
-		platform: "linkedin",
-		requests: [{ path: "/chats" }],
-		pagination: linkedinCursorPagination,
-		pageSize: 20,
-		sinceField: "last_message_timestamp",
-		lift: liftConversation
+const assertPlatformQuery = (sql, platform) => {
+	const allowedTables = tablesForPlatform(platform);
+	const rejectedTables = new Set(knownTableTokens(sql).filter((table) => !allowedTables.has(table)));
+	if (rejectedTables.size > 0) throw new Error(`Cache SQL for ${platform} cannot read ${[...rejectedTables].sort().join(", ")}.`);
+};
+const referencedTablesForRead = (sql, platform) => {
+	const allowedTables = platformTables[platform];
+	return knownTableTokens(sql).filter((table) => allowedTables.has(table));
+};
+const collectionShortName = (collection) => collection.replace(/^(x|li)_/, "");
+const tableFreshnessPolicies = {
+	x_messages_raw: {
+		kind: "collection",
+		collection: "x_messages"
 	},
-	{
-		key: "li_messages",
-		platform: "linkedin",
-		requests: [{ path: "/chats/:chat_id/messages" }],
-		parentCollection: "li_conversations",
-		parentIdToken: ":chat_id",
-		pagination: linkedinCursorPagination,
-		pageSize: 250,
-		sinceField: "timestamp",
-		lift: liftMessage
+	li_conversations: {
+		kind: "collection",
+		collection: "li_conversations",
+		commandCollection: "li_messages"
 	},
-	{
-		key: "li_connections",
-		platform: "linkedin",
-		requests: [{ path: "/users/connections" }],
-		requiresFullInitialSync: true,
-		pagination: linkedinRelationsCursorPagination,
-		pageSize: 100,
-		sinceField: "created_at",
-		lift: liftConnection
+	li_conversations_raw: {
+		kind: "collection",
+		collection: "li_conversations",
+		commandCollection: "li_messages"
 	},
-	{
-		key: "li_posts",
-		platform: "linkedin",
-		requests: [{ path: "/users/:identifier/posts" }],
-		ownIdToken: ":identifier",
-		pagination: linkedinOffsetPagination,
-		pageSize: 50,
-		sinceField: "created_at",
-		lift: liftPost
+	li_profiles: {
+		kind: "platform",
+		platform: "linkedin"
 	},
-	{
-		key: "li_requests",
-		platform: "linkedin",
-		requests: [{
-			path: "/users/me/relation-requests/received",
-			bakedQuery: { type: "received" }
-		}, {
-			path: "/users/me/relation-requests/sent",
-			bakedQuery: { type: "sent" }
-		}],
-		pagination: linkedinRelationsCursorPagination,
-		pageSize: 100,
-		lift: liftRequest
+	li_profiles_raw: {
+		kind: "platform",
+		platform: "linkedin"
+	},
+	x_profiles: {
+		kind: "platform",
+		platform: "x"
+	},
+	x_profiles_raw: {
+		kind: "platform",
+		platform: "x"
 	}
-];
-//#endregion
-//#region ../../packages/sync-engine/src/collections/x.ts
-const xPagination = {
-	style: "cursor",
-	limitParam: "max_results",
-	cursorParam: "pagination_token",
-	cursorPath: "meta.next_token",
-	itemsPath: "data"
 };
-const defaultDMEventFields = "attachments,created_at,dm_conversation_id,entities,event_type,id,participant_ids,referenced_tweets,sender_id,text";
-const defaultDMExpansions = "attachments.media_keys,participant_ids,referenced_tweets.id,sender_id";
-const defaultDMUserFields = "affiliation,connection_status,created_at,description,entities,id,location,most_recent_tweet_id,name,pinned_tweet_id,profile_banner_url,profile_image_url,protected,public_metrics,receives_your_dm,subscription_type,url,username,verified,verified_type,withheld";
-const asRecord = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
-const read = (value) => value === null || value === void 0 ? null : value;
-const isoToEpochMs = (value) => {
-	if (typeof value === "number") return Number.isFinite(value) ? value : null;
-	if (typeof value !== "string") return null;
-	const epochMs = Date.parse(value);
-	return Number.isNaN(epochMs) ? null : epochMs;
+const freshnessPolicyForTable = (table) => tableFreshnessPolicies[table] ?? {
+	kind: "collection",
+	collection: collectionForReadTable(table)
 };
-const toBool = (value) => {
-	if (typeof value !== "boolean") return null;
-	return value ? 1 : 0;
+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 stringifyJSON$1 = (value) => value === null || value === void 0 ? null : JSON.stringify(value);
-const liftTweetColumns = (item) => {
-	const publicMetrics = asRecord(item.public_metrics);
-	return {
-		id: read(item.id),
-		created_at: isoToEpochMs(item.created_at),
-		author_id: read(item.author_id),
-		conversation_id: read(item.conversation_id),
-		in_reply_to_user_id: read(item.in_reply_to_user_id),
-		lang: read(item.lang),
-		reply_settings: read(item.reply_settings),
-		text: read(item.text),
-		url: read(item.url),
-		paid_partnership: toBool(item.paid_partnership),
-		possibly_sensitive: toBool(item.possibly_sensitive),
-		like_count: read(publicMetrics.like_count),
-		retweet_count: read(publicMetrics.retweet_count),
-		reply_count: read(publicMetrics.reply_count),
-		quote_count: read(publicMetrics.quote_count),
-		bookmark_count: read(publicMetrics.bookmark_count),
-		impression_count: read(publicMetrics.impression_count)
-	};
+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 liftTweet = (item) => ({
-	...liftTweetColumns(item),
-	raw: JSON.stringify(item)
-});
-const liftBookmark = (item) => {
-	const article = asRecord(item.article);
-	const noteTweet = asRecord(item.note_tweet);
-	return {
-		...liftTweetColumns(item),
-		article_cover_media: read(article.cover_media),
-		article_plain_text: read(article.plain_text),
-		article_preview_text: read(article.preview_text),
-		article_title: read(article.title),
-		note_tweet_text: read(noteTweet.text),
-		raw: JSON.stringify(item)
-	};
+const collectionLastSynced = (db, collection) => {
+	return numberOrNull(db.prepare("SELECT last_synced FROM sync_state WHERE collection = :collection").get({ collection })?.last_synced);
 };
-const liftDMEvent = (item) => ({
-	id: read(item.id),
-	created_at: isoToEpochMs(item.created_at),
-	dm_conversation_id: read(item.dm_conversation_id),
-	event_type: read(item.event_type),
-	sender_id: read(item.sender_id),
-	text: read(item.text),
-	participant_ids: stringifyJSON$1(item.participant_ids),
-	attachments: stringifyJSON$1(item.attachments),
-	entities: stringifyJSON$1(item.entities),
-	referenced_tweets: stringifyJSON$1(item.referenced_tweets),
-	raw: JSON.stringify(item)
-});
-const liftXUser = (item) => {
-	const affiliation = asRecord(item.affiliation);
-	const publicMetrics = asRecord(item.public_metrics);
-	const subscription = asRecord(item.subscription);
+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);
+	if (!profileTables.has(physicalTableForCacheTable(table))) throw new Error(`Unknown profile table: ${table}`);
+};
+const cacheDescriptionNotes = ["time columns (*_at, muted_until, synced_at) are epoch ms; booleans are 0/1", "each view has a <name>_raw twin holding the upstream JSON: json_extract(raw,'$.field')"];
+const metadataForPlatform = (platform) => {
+	const platforms = platform ? [platform] : ["linkedin", "x"];
 	return {
-		id: read(item.id),
-		created_at: isoToEpochMs(item.created_at),
-		username: read(item.username),
-		name: read(item.name),
-		description: read(item.description),
-		location: read(item.location),
-		url: read(item.url),
-		is_identity_verified: toBool(item.is_identity_verified),
-		protected: toBool(item.protected),
-		verified: toBool(item.verified),
-		verified_type: read(item.verified_type),
-		subscription_type: read(item.subscription_type),
-		parody: toBool(item.parody),
-		most_recent_tweet_id: read(item.most_recent_tweet_id),
-		pinned_tweet_id: read(item.pinned_tweet_id),
-		profile_banner_url: read(item.profile_banner_url),
-		profile_image_url: read(item.profile_image_url),
-		affiliation_badge_url: read(affiliation.badge_url),
-		affiliation_description: read(affiliation.description),
-		affiliation_url: read(affiliation.url),
-		subscription_subscribes_to_you: toBool(subscription.subscribes_to_you),
-		followers_count: read(publicMetrics.followers_count),
-		following_count: read(publicMetrics.following_count),
-		tweet_count: read(publicMetrics.tweet_count),
-		listed_count: read(publicMetrics.listed_count),
-		like_count: read(publicMetrics.like_count),
-		media_count: read(publicMetrics.media_count),
-		raw: JSON.stringify(item)
+		joins: platforms.flatMap((item) => CACHE_METADATA_BY_PLATFORM[item].joins),
+		enums: Object.assign({}, ...platforms.map((item) => CACHE_METADATA_BY_PLATFORM[item].enums)),
+		indexed: Object.assign({}, ...platforms.map((item) => CACHE_METADATA_BY_PLATFORM[item].indexed))
 	};
 };
-//#endregion
-//#region ../../packages/sync-engine/src/collections/index.ts
-const COLLECTIONS = [...[
-	{
-		key: "x_tweets",
-		platform: "x",
-		requests: [{ path: "/users/:id/tweets" }],
-		ownIdToken: ":id",
-		pagination: xPagination,
-		pageSize: 100,
-		sinceField: "created_at",
-		lift: liftTweet
+const cachePath = (args) => join(homedir(), ".social", "cache", `${args.platform}-${sanitizeAccountId(args.accountId)}.db`);
+const openCacheAt = (path, opts) => {
+	const dbPath = resolveCachePath(path);
+	if (opts?.readonly) {
+		const db = openDatabase(dbPath, { readonly: true });
+		assertAtLatest(db);
+		return createCache(dbPath, db);
+	}
+	if (dbPath !== ":memory:") mkdirSync(dirname(dbPath), { recursive: true });
+	const db = openDatabase(dbPath);
+	const result = migrate(db);
+	if (result.applied > 0) opts?.onMigrate?.(result);
+	return createCache(dbPath, db);
+};
+const openCache = (args) => openCacheAt(cachePath(args), {
+	readonly: args.readonly,
+	onMigrate: args.onMigrate
+});
+const createCache = (path, db) => ({
+	upsert: (table, rows, syncedAt = Date.now()) => {
+		if (rows.length === 0) return;
+		assertKnownTable(table);
+		const physicalTable = physicalTableForCacheTable(table);
+		const columns = [...Object.keys(rows[0] ?? {}).filter((column) => column !== "synced_at"), "synced_at"];
+		const updateColumns = columns.filter((column) => column !== "id");
+		const statement = db.prepare(`INSERT INTO ${quoteIdentifier(physicalTable)} (${columns.map(quoteIdentifier).join(", ")}) VALUES (${columns.map((column) => `:${column}`).join(", ")}) ON CONFLICT(id) DO UPDATE SET ${updateColumns.map((column) => `${quoteIdentifier(column)}=excluded.${quoteIdentifier(column)}`).join(", ")}`);
+		db.transaction(() => {
+			for (const row of rows) statement.run({
+				...row,
+				synced_at: syncedAt
+			});
+		});
 	},
-	{
-		key: "x_followers",
-		platform: "x",
-		requests: [{ path: "/users/:id/followers" }],
-		ownIdToken: ":id",
-		requiresFullInitialSync: true,
-		pagination: xPagination,
-		pageSize: 1e3,
-		lift: liftXUser
+	upsertProfiles: (table, rows) => {
+		if (rows.length === 0) return;
+		assertKnownProfileTable(table);
+		const physicalTable = physicalTableForCacheTable(table);
+		const rowsByProviderId = /* @__PURE__ */ new Map();
+		for (const row of rows) rowsByProviderId.set(row.providerId, row);
+		const columns = [
+			"provider_id",
+			"username",
+			"display_name",
+			"avatar_url",
+			"headline",
+			"raw",
+			"synced_at"
+		];
+		const quotedTable = quoteIdentifier(physicalTable);
+		const nullableColumns = [
+			"username",
+			"avatar_url",
+			"headline"
+		];
+		const lastWriteColumns = [
+			"display_name",
+			"raw",
+			"synced_at"
+		];
+		const updateAssignments = [...nullableColumns.map((column) => `${quoteIdentifier(column)}=COALESCE(excluded.${quoteIdentifier(column)}, ${quotedTable}.${quoteIdentifier(column)})`), ...lastWriteColumns.map((column) => `${quoteIdentifier(column)}=excluded.${quoteIdentifier(column)}`)].join(", ");
+		const statement = db.prepare(`INSERT INTO ${quotedTable} (${columns.map(quoteIdentifier).join(", ")}) VALUES (${columns.map((column) => `:${column}`).join(", ")}) ON CONFLICT(provider_id) DO UPDATE SET ${updateAssignments}`);
+		const syncedAt = Date.now();
+		db.transaction(() => {
+			for (const row of rowsByProviderId.values()) statement.run({
+				provider_id: row.providerId,
+				username: row.username,
+				display_name: row.displayName,
+				avatar_url: row.avatarURL,
+				headline: row.headline,
+				raw: JSON.stringify(row.raw),
+				synced_at: syncedAt
+			});
+		});
 	},
-	{
-		key: "x_following",
-		platform: "x",
-		requests: [{ path: "/users/:id/following" }],
-		ownIdToken: ":id",
-		requiresFullInitialSync: true,
-		pagination: xPagination,
-		pageSize: 1e3,
-		lift: liftXUser
+	getCursor: (collection) => {
+		const row = db.prepare("SELECT cursor, last_synced, object_count FROM sync_state WHERE collection = :collection").get({ collection });
+		if (!row) return;
+		return {
+			cursor: stringOrNull(row.cursor),
+			lastSynced: numberOrNull(row.last_synced),
+			objectCount: numberOrNull(row.object_count)
+		};
 	},
-	{
-		key: "x_bookmarks",
-		platform: "x",
-		requests: [{ path: "/users/:id/bookmarks" }],
-		ownIdToken: ":id",
-		pagination: xPagination,
-		pageSize: 100,
-		lift: liftBookmark
+	setCursor: (collection, cursor, objectCount, lastSynced = Date.now()) => {
+		db.prepare("INSERT INTO sync_state (collection, cursor, last_synced, object_count) VALUES (:collection, :cursor, :last_synced, :object_count) ON CONFLICT(collection) DO UPDATE SET cursor=excluded.cursor, last_synced=excluded.last_synced, object_count=excluded.object_count").run({
+			collection,
+			cursor,
+			last_synced: lastSynced,
+			object_count: objectCount
+		});
 	},
-	{
-		key: "x_messages",
-		table: "x_raw_messages",
-		platform: "x",
-		requests: [{
-			path: "/dm_events",
-			bakedQuery: {
-				"dm_event.fields": defaultDMEventFields,
-				expansions: defaultDMExpansions,
-				"user.fields": defaultDMUserFields
+	reset: ({ tables, collections }) => {
+		for (const table of tables) assertKnownTable(table);
+		const results = [];
+		db.transaction(() => {
+			for (const table of tables) {
+				const physicalTable = physicalTableForCacheTable(table);
+				const result = db.prepare(`DELETE FROM ${quoteIdentifier(physicalTable)}`).run();
+				results.push({
+					table: physicalTable,
+					rowsDeleted: result?.changes ?? 0
+				});
 			}
-		}],
-		pagination: xPagination,
-		pageSize: 100,
-		sinceField: "created_at",
-		lift: liftDMEvent
+			const deleteState = db.prepare("DELETE FROM sync_state WHERE collection = :collection");
+			for (const collection of collections) deleteState.run({ collection });
+		});
+		return results;
+	},
+	query: (sql, opts) => {
+		if (opts?.platform) assertPlatformQuery(sql, opts.platform);
+		return db.prepare(sql).all();
+	},
+	read: (sql, opts) => {
+		assertPlatformQuery(sql, opts.platform);
+		const tables = referencedTablesForRead(sql, opts.platform).map((name) => {
+			const policy = freshnessPolicyForTable(name);
+			return {
+				name,
+				missingName: missingNameForPolicy(name, policy),
+				command: syncCommandForPolicy(opts.platform, policy),
+				lastSynced: lastSyncedForPolicy(db, policy)
+			};
+		});
+		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 }) => ({
+				name,
+				lastSynced
+			}))
+		};
+	},
+	describe: (opts) => {
+		const allowedTables = opts?.platform ? tablesForPlatform(opts.platform) : void 0;
+		const metadata = metadataForPlatform(opts?.platform);
+		const tables = db.prepare("SELECT name FROM sqlite_master WHERE type IN ('table', 'view') AND name NOT LIKE 'sqlite_%' ORDER BY name").all().filter((table) => !String(table.name).endsWith("_raw")).filter((table) => allowedTables === void 0 || allowedTables.has(String(table.name)));
+		const lastSyncedForTable = (name) => {
+			if (name === "sync_state") return null;
+			return lastSyncedForPolicy(db, freshnessPolicyForTable(name));
+		};
+		const columnsForTable = (name) => db.prepare(`PRAGMA table_info(${quoteIdentifier(name)})`).all().map((row) => String(row.name)).join(", ");
+		return {
+			path,
+			notes: cacheDescriptionNotes,
+			joins: metadata.joins,
+			enums: metadata.enums,
+			tables: tables.map((table) => {
+				const name = String(table.name);
+				const rowCount = db.prepare(`SELECT count(*) AS rows FROM ${quoteIdentifier(name)}`).get();
+				const syncedAt = lastSyncedForTable(name);
+				return {
+					name,
+					rows: Number(rowCount?.rows ?? 0),
+					synced_at: syncedAt,
+					query_ready: syncedAt != null,
+					columns: columnsForTable(name),
+					indexed: metadata.indexed[name] ?? []
+				};
+			})
+		};
+	},
+	close: () => {
+		db.close();
 	}
-], ...LINKEDIN_COLLECTIONS];
-const collectionByKey = (key) => COLLECTIONS.find((collection) => collection.key === key);
-const collectionsFor = (platform) => COLLECTIONS.filter((collection) => collection.platform === platform);
-const syncableCollectionsFor = (platform) => {
-	const parentKeys = new Set(COLLECTIONS.map((collection) => collection.parentCollection).filter(Boolean));
-	return collectionsFor(platform).filter((collection) => !parentKeys.has(collection.key));
-};
-const physicalTableFor = (collection) => collection.table ?? collection.key;
-const resetTablesFor = (collection) => {
-	if (!collection.parentCollection) return [collection];
-	const parent = collectionByKey(collection.parentCollection);
-	return parent ? [collection, parent] : [collection];
-};
-const resetPhysicalTablesFor = (collection) => resetTablesFor(collection).map(physicalTableFor);
+});
 //#endregion
 //#region ../../packages/sync-engine/src/cost.ts
 const creditsFromHeader = (headers) => {
@@ -937,7 +1146,7 @@ const creditsFromHeader = (headers) => {
 };
 //#endregion
 //#region ../../packages/sync-engine/src/profiles.ts
-const profileTableFor = (platform) => platform === "x" ? "x_profiles" : "li_profiles";
+const profileTableFor = (platform) => platform === "x" ? "x_profiles_raw" : "li_profiles_raw";
 //#endregion
 //#region ../../node_modules/.bun/drizzle-orm@0.43.1+ae5d55cf414a93be/node_modules/drizzle-orm/entity.js
 const entityKind = Symbol.for("drizzle:entityKind");
@@ -3698,7 +3907,7 @@ const rawColumns = () => ({
 	raw: text$1("raw").notNull(),
 	syncedAt: integer$2("synced_at").notNull()
 });
-sqliteTable("x_tweets", {
+sqliteTable("x_tweets_raw", {
 	id: idColumn(),
 	createdAt: integer$2("created_at"),
 	authorId: text$1("author_id"),
@@ -3722,7 +3931,7 @@ sqliteTable("x_tweets", {
 	index$1("x_tweets_author_id_created_at_idx").on(table.authorId, table.createdAt),
 	index$1("x_tweets_conversation_id_created_at_idx").on(table.conversationId, table.createdAt)
 ]);
-sqliteTable("x_bookmarks", {
+sqliteTable("x_bookmarks_raw", {
 	id: idColumn(),
 	createdAt: integer$2("created_at"),
 	authorId: text$1("author_id"),
@@ -3753,14 +3962,14 @@ sqliteTable("x_bookmarks", {
 ]);
 const profileColumns = () => ({
 	providerId: text$1("provider_id").primaryKey(),
-	handle: text$1("handle"),
+	username: text$1("username"),
 	displayName: text$1("display_name").notNull(),
 	avatarURL: text$1("avatar_url"),
 	headline: text$1("headline"),
 	...rawColumns()
 });
-sqliteTable("x_profiles", profileColumns(), (table) => [index$1("x_profiles_handle_idx").on(table.handle)]);
-sqliteTable("x_raw_messages", {
+sqliteTable("x_profiles_raw", profileColumns(), (table) => [index$1("x_profiles_username_idx").on(table.username)]);
+sqliteTable("x_messages_raw", {
 	id: idColumn(),
 	createdAt: integer$2("created_at"),
 	dmConversationId: text$1("dm_conversation_id"),
@@ -3807,21 +4016,21 @@ const xUserColumns = () => ({
 	mediaCount: integer$2("media_count"),
 	...rawColumns()
 });
-sqliteTable("x_followers", xUserColumns(), (table) => [
+sqliteTable("x_followers_raw", xUserColumns(), (table) => [
 	index$1("x_followers_created_at_idx").on(table.createdAt),
 	index$1("x_followers_synced_at_idx").on(table.syncedAt),
 	index$1("x_followers_username_idx").on(table.username),
 	index$1("x_followers_verified_idx").on(table.verified),
 	index$1("x_followers_verified_type_idx").on(table.verifiedType)
 ]);
-sqliteTable("x_following", xUserColumns(), (table) => [
+sqliteTable("x_following_raw", xUserColumns(), (table) => [
 	index$1("x_following_created_at_idx").on(table.createdAt),
 	index$1("x_following_synced_at_idx").on(table.syncedAt),
 	index$1("x_following_username_idx").on(table.username),
 	index$1("x_following_verified_idx").on(table.verified),
 	index$1("x_following_verified_type_idx").on(table.verifiedType)
 ]);
-sqliteTable("li_connections", {
+sqliteTable("li_connections_raw", {
 	id: idColumn(),
 	createdAt: integer$2("created_at"),
 	object: text$1("object"),
@@ -3843,8 +4052,8 @@ sqliteTable("li_connections", {
 	index$1("li_connections_user_public_identifier_idx").on(table.userPublicIdentifier),
 	index$1("li_connections_user_display_name_idx").on(table.userDisplayName)
 ]);
-sqliteTable("li_profiles", profileColumns(), (table) => [index$1("li_profiles_handle_idx").on(table.handle)]);
-sqliteTable("li_conversations", {
+sqliteTable("li_profiles_raw", profileColumns(), (table) => [index$1("li_profiles_username_idx").on(table.username)]);
+sqliteTable("li_conversations_raw", {
 	id: idColumn(),
 	createdAt: integer$2("created_at"),
 	lastMessageTimestamp: integer$2("last_message_timestamp"),
@@ -3881,7 +4090,7 @@ sqliteTable("li_conversations", {
 	index$1("li_conversations_user_display_name_idx").on(table.userDisplayName),
 	index$1("li_conversations_is_archived_last_message_timestamp_idx").on(table.isArchived, table.lastMessageTimestamp)
 ]);
-sqliteTable("li_messages", {
+sqliteTable("li_messages_raw", {
 	id: idColumn(),
 	timestamp: integer$2("timestamp"),
 	chatId: text$1("chat_id"),
@@ -3912,7 +4121,7 @@ sqliteTable("li_messages", {
 	index$1("li_messages_chat_id_timestamp_idx").on(table.chatId, table.timestamp),
 	index$1("li_messages_sender_id_timestamp_idx").on(table.senderId, table.timestamp)
 ]);
-sqliteTable("li_posts", {
+sqliteTable("li_posts_raw", {
 	id: idColumn(),
 	createdAt: integer$2("created_at"),
 	object: text$1("object"),
@@ -3973,7 +4182,7 @@ sqliteTable("li_posts", {
 	index$1("li_posts_author_id_created_at_idx").on(table.authorId, table.createdAt),
 	index$1("li_posts_author_public_identifier_created_at_idx").on(table.authorPublicIdentifier, table.createdAt)
 ]);
-sqliteTable("li_requests", {
+sqliteTable("li_requests_raw", {
 	id: idColumn(),
 	createdAt: integer$2("created_at"),
 	object: text$1("object"),
@@ -4003,19 +4212,31 @@ sqliteTable("sync_state", {
 });
 //#endregion
 //#region ../../packages/sync-engine/src/since.ts
-const durationPattern = /^(\d+):(hours|days|weeks)$/;
-const isoPattern = /^\d{4}-\d{2}-\d{2}(?:T\d{2}:\d{2}:\d{2}Z)?$/;
-const unitMs = {
-	hours: 36e5,
-	days: 864e5,
-	weeks: 6048e5
-};
-const parseSince = (input, now = Date.now()) => {
+const isoDatePattern = /^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$/;
+const isoDateTimePattern = /^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])T([01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d{1,3})?)?(?:Z|[+-]([01]\d|2[0-3]):[0-5]\d)?$/;
+const timezonePattern = /(Z|[+-]\d{2}:\d{2})$/;
+const invalidSinceMessage = "Invalid --since value. Use an ISO 8601 date like 2026-05-04 or datetime like 2026-05-04T00:00:00Z.";
+const daysInMonth = (year, month) => {
+	if (month === 2) return year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0) ? 29 : 28;
+	return [
+		4,
+		6,
+		9,
+		11
+	].includes(month) ? 30 : 31;
+};
+const hasValidDate = (value) => {
+	const year = Number.parseInt(value.slice(0, 4), 10);
+	const month = Number.parseInt(value.slice(5, 7), 10);
+	return Number.parseInt(value.slice(8, 10), 10) <= daysInMonth(year, month);
+};
+const parseSince = (input) => {
 	const value = input.trim();
-	const duration = durationPattern.exec(value);
-	if (duration != null) return now - Number.parseInt(duration[1] ?? "", 10) * unitMs[duration[2]];
-	const parsed = isoPattern.test(value) ? Date.parse(value) : NaN;
-	if (Number.isNaN(parsed)) throw new Error("Invalid --since value. Use an ISO 8601 date/datetime like 2026-06-01 or 2026-06-01T00:00:00Z, or a compact duration like 2:days, 3:weeks, or 5:hours.");
+	const isISODate = isoDatePattern.test(value);
+	const isISODateTime = isoDateTimePattern.test(value);
+	const normalized = isISODateTime && !timezonePattern.test(value) ? `${value}Z` : value;
+	const parsed = (isISODate || isISODateTime) && hasValidDate(value) ? Date.parse(normalized) : NaN;
+	if (Number.isNaN(parsed)) throw new Error(invalidSinceMessage);
 	return parsed;
 };
 //#endregion
@@ -8672,6 +8893,7 @@ var SyncPageError = class extends Error {
 	pagesCompleted;
 	objectsUpserted;
 	creditsSpent;
+	cursorPersisted;
 	cause;
 	constructor(context, cause) {
 		super(`Failed to sync ${context.collectionKey} page at ${context.path}`);
@@ -8687,13 +8909,31 @@ var SyncPageError = class extends Error {
 		this.pagesCompleted = context.pagesCompleted;
 		this.objectsUpserted = context.objectsUpserted;
 		this.creditsSpent = context.creditsSpent;
+		this.cursorPersisted = context.cursorPersisted;
 		this.cause = cause;
 	}
 };
+const PARTIAL_SYNC_CURSOR_PREFIX = "partial-sync-v1:";
 const itemsSchema = array$1(record$1(string$1(), unknown$1()));
 const cursorSchema = union$1([string$1(), _null$1()]);
 const totalCountSchema = number$1().int().nonnegative();
 const isRecord$5 = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const validPartialSyncCursor = (value) => value.version === 1 && Number.isInteger(value.requestIndex) && typeof value.requestIndex === "number" && value.requestIndex >= 0 && typeof value.cursor === "string" && (typeof value.checkpoint === "string" || value.checkpoint === null) && (typeof value.newestId === "string" || value.newestId === null) && (typeof value.since === "number" || value.since === null);
+const decodePartialSyncCursor = (value) => {
+	if (!value?.startsWith(PARTIAL_SYNC_CURSOR_PREFIX)) return;
+	try {
+		const parsed = JSON.parse(value.slice(16));
+		return isRecord$5(parsed) && validPartialSyncCursor(parsed) ? parsed : void 0;
+	} catch {
+		return;
+	}
+};
+const encodePartialSyncCursor = (cursor) => `${PARTIAL_SYNC_CURSOR_PREFIX}${JSON.stringify(cursor)}`;
+const isRateLimitError = (error) => isRecord$5(error) && error.status === 429;
+const retryAfterSecondsFromRateLimitError = (error) => {
+	if (!(isRateLimitError(error) && isRecord$5(error))) return;
+	return typeof error.retryAfterSeconds === "number" && Number.isFinite(error.retryAfterSeconds) && error.retryAfterSeconds >= 0 ? error.retryAfterSeconds : void 0;
+};
 const getByPath = (obj, path) => {
 	if (path === void 0) return;
 	let current = obj;
@@ -8756,6 +8996,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 +9012,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 +9020,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;
@@ -8825,18 +9067,62 @@ const mergeStoppedReason = (current, next) => {
 	return "complete";
 };
 const walkRequest = async (args) => {
-	const checkpoint = args.useCheckpoint ? args.deps.cache.getCursor(args.collection.key)?.cursor ?? null : null;
+	const storedCursor = args.deps.cache.getCursor(args.collection.key)?.cursor ?? null;
+	const storedPartialCursor = decodePartialSyncCursor(storedCursor);
+	const checkpoint = args.resumeCursor?.checkpoint ?? (args.useCheckpoint ? storedPartialCursor?.checkpoint ?? storedCursor : null);
 	const ids = [];
 	let state = {
 		checkpoint,
-		cursor: null,
+		cursor: args.resumeCursor?.cursor ?? null,
 		offset: 0,
-		newestId: null,
-		firstPage: true
+		newestId: args.resumeCursor?.newestId ?? null,
+		firstPage: args.resumeCursor === void 0
 	};
 	let pages = 0;
 	let upserted = 0;
 	let stoppedReason = "complete";
+	const rateLimitNow = args.rateLimit?.now ?? Date.now;
+	const rateLimitSleep = args.rateLimit?.sleep ?? sleep;
+	const rateLimitMaxRetries = args.rateLimit?.maxRetries ?? 25;
+	const pageRequestOptions = {
+		headers: args.deps.accountHeaders,
+		...args.rateLimit?.timeoutSeconds === void 0 ? {} : { retry: { limit: 0 } }
+	};
+	const waitForRateLimit = async (error) => {
+		if (!(args.rateLimit && args.rateLimitState?.deadlineMs !== void 0)) return false;
+		const retryCount = args.rateLimitState.retryCount + 1;
+		const retryAfterSeconds = args.rateLimit.retryAfterSecondsFor(error, retryCount);
+		if (!(args.rateLimit.isRateLimitError?.(error) ?? retryAfterSeconds !== void 0)) return false;
+		const delaySeconds = retryAfterSeconds ?? args.rateLimit.fallbackDelaySecondsForRetry?.(retryCount);
+		if (delaySeconds === void 0 || retryCount > rateLimitMaxRetries) return false;
+		const remainingMs = args.rateLimitState.deadlineMs - rateLimitNow();
+		if (delaySeconds * 1e3 > remainingMs) return false;
+		args.rateLimitState.retryCount = retryCount;
+		await args.rateLimit.onRetry?.({
+			delaySeconds,
+			retryCount
+		});
+		await rateLimitSleep(delaySeconds * 1e3);
+		return true;
+	};
+	const persistPartialCursor = (error) => {
+		const isRateLimit = args.rateLimit?.isRateLimitError?.(error) ?? args.rateLimit?.retryAfterSecondsFor(error, 1) !== void 0;
+		if (!(args.allowPartialResume && args.rateLimit && isRateLimit) || args.collection.pagination.style !== "cursor" || !state.cursor) return false;
+		args.writePendingCursor({
+			collection: args.collection.key,
+			cursor: encodePartialSyncCursor({
+				version: 1,
+				requestIndex: args.requestIndex,
+				cursor: state.cursor,
+				checkpoint,
+				newestId: state.newestId,
+				since: args.since ?? null
+			}),
+			objectCount: upserted,
+			lastSynced: null
+		});
+		return true;
+	};
 	while (true) {
 		if (args.pageDelayState.pagesCompleted > 0) {
 			const delay = pageDelayFor(args.deps.pageDelayMs, args.pageDelayState.pagesCompleted);
@@ -8863,13 +9149,17 @@ const walkRequest = async (args) => {
 			objectsUpserted: upserted,
 			creditsSpent: args.credits.spent
 		};
-		const response = await (async () => {
-			try {
-				return await args.deps.api.get(path, { headers: args.deps.accountHeaders });
-			} catch (error) {
-				return wrapPageError(pageContext, error);
-			}
-		})();
+		let response;
+		while (true) try {
+			response = await args.deps.api.get(path, pageRequestOptions);
+			break;
+		} catch (error) {
+			if (await waitForRateLimit(error)) continue;
+			return wrapPageError({
+				...pageContext,
+				cursorPersisted: persistPartialCursor(error) || void 0
+			}, error);
+		}
 		const credits = creditsFromHeader(response.headers);
 		args.credits.spent += credits;
 		let json;
@@ -8937,52 +9227,72 @@ const runSync = async (deps, opts) => {
 	let stoppedReason = "complete";
 	const pendingCursors = [];
 	const pageDelayState = { pagesCompleted: 0 };
+	const rateLimitNow = opts.rateLimit?.now ?? Date.now;
+	const rateLimitState = opts.rateLimit ? {
+		deadlineMs: opts.rateLimit.timeoutSeconds === void 0 ? void 0 : rateLimitNow() + opts.rateLimit.timeoutSeconds * 1e3,
+		retryCount: 0
+	} : void 0;
 	const addResult = (result) => {
 		pages += result.pages;
 		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;
-		for (const request of parentCollection.requests) {
+		let parentCheckpoint;
+		for (const [requestIndex, request] of parentCollection.requests.entries()) {
 			const result = await walkRequest({
 				deps,
 				collection: parentCollection,
 				request,
+				requestIndex,
 				since: opts.since,
 				useCheckpoint: false,
 				collectIds: true,
+				allowPartialResume: false,
 				credits,
 				pageDelayState,
+				rateLimit: opts.rateLimit,
+				rateLimitState,
+				writePendingCursor,
 				onPage: opts.onPage,
 				onProgress: opts.onProgress
 			});
 			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()
-		});
-		for (const parentId of parentIds) for (const request of collection.requests) addResult(await walkRequest({
+		};
+		if (parentCheckpoint) writePendingCursor(parentCheckpoint);
+		for (const parentId of parentIds) for (const [requestIndex, request] of collection.requests.entries()) addResult(await walkRequest({
 			deps,
 			collection,
 			request,
+			requestIndex,
 			since: opts.since,
 			useCheckpoint: false,
+			allowPartialResume: false,
 			parentId,
 			parentIdToken: collection.parentIdToken,
 			credits,
 			pageDelayState,
+			rateLimit: opts.rateLimit,
+			rateLimitState,
+			writePendingCursor,
 			onPage: opts.onPage,
 			onProgress: opts.onProgress
 		}));
@@ -8994,15 +9304,24 @@ const runSync = async (deps, opts) => {
 		});
 	} else {
 		const useCheckpoint = collection.requests.length === 1;
-		for (const request of collection.requests) {
+		const partialCursor = decodePartialSyncCursor(deps.cache.getCursor(collection.key)?.cursor ?? null);
+		const activePartialCursor = partialCursor && partialCursor.since === (opts.since ?? null) && partialCursor.requestIndex < collection.requests.length ? partialCursor : void 0;
+		for (const [requestIndex, request] of collection.requests.entries()) {
+			if (activePartialCursor && requestIndex < activePartialCursor.requestIndex) continue;
 			const result = await walkRequest({
 				deps,
 				collection,
 				request,
+				requestIndex,
 				since: opts.since,
 				useCheckpoint,
+				resumeCursor: activePartialCursor?.requestIndex === requestIndex ? activePartialCursor : void 0,
+				allowPartialResume: true,
 				credits,
 				pageDelayState,
+				rateLimit: opts.rateLimit,
+				rateLimitState,
+				writePendingCursor,
 				onPage: opts.onPage,
 				onProgress: opts.onProgress
 			});
@@ -9019,7 +9338,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,
@@ -9813,7 +10132,7 @@ pgTable("profiles", {
 	id: text("id").primaryKey().$defaultFn(() => crypto.randomUUID()),
 	platform: text("platform", { enum: ["linkedin", "x"] }).notNull(),
 	providerId: text("provider_id").notNull(),
-	handle: text("handle"),
+	username: text("username"),
 	displayName: text("display_name").notNull(),
 	avatarURL: text("avatar_url"),
 	headline: text("headline"),
@@ -9822,7 +10141,7 @@ pgTable("profiles", {
 	updatedAt: timestamptz("updated_at").notNull().defaultNow()
 }, (table) => [
 	uniqueIndex("profiles_platform_provider_id_pkey").on(table.platform, table.providerId),
-	index("profiles_platform_handle_idx").on(table.platform, table.handle),
+	index("profiles_platform_username_idx").on(table.platform, table.username),
 	check("profiles_platform_check", sql`${table.platform} in ('linkedin', 'x')`)
 ]);
 pgTable("feedback_submissions", {
@@ -9845,7 +10164,7 @@ pgTable("wrapped_runs", {
 	userId: text("user_id").notNull().references(() => user.id, { onDelete: "cascade" }),
 	connectedAccountId: text("connected_account_id").references(() => connectedAccounts.id, { onDelete: "set null" }),
 	platform: text("platform", { enum: ["x"] }).notNull().default("x"),
-	handle: text("handle").notNull(),
+	username: text("username").notNull(),
 	platformProfileId: text("platform_profile_id"),
 	status: text("status", { enum: [
 		"pending",
@@ -9865,7 +10184,7 @@ pgTable("wrapped_runs", {
 }, (table) => [
 	uniqueIndex("wrapped_runs_share_slug_key").on(table.shareSlug),
 	index("wrapped_runs_user_created_idx").on(table.userId, table.createdAt.desc()),
-	index("wrapped_runs_handle_done_idx").on(table.handle, table.createdAt.desc()).where(sql`${table.status} = 'done'`),
+	index("wrapped_runs_username_done_idx").on(table.username, table.createdAt.desc()).where(sql`${table.status} = 'done'`),
 	check("wrapped_runs_platform_check", sql`${table.platform} in ('x')`),
 	check("wrapped_runs_status_check", sql`${table.status} in ('pending', 'running', 'done', 'failed')`)
 ]);
@@ -9930,16 +10249,16 @@ const createURL = (baseURL, path) => {
 const createAbsoluteURL = (baseURL, path) => createURL(baseURL, path).toString();
 //#endregion
 //#region ../../packages/linkedin/src/profiles.ts
-const displayNameFrom = (firstName, lastName, handle) => [firstName, lastName].filter(Boolean).join(" ").trim() || handle || "";
+const displayNameFrom = (firstName, lastName, username) => [firstName, lastName].filter(Boolean).join(" ").trim() || username || "";
 const rowFrom$1 = (fields) => {
 	const providerId = fields.providerId?.trim();
 	if (!providerId) return null;
-	const handle = fields.handle?.trim() || null;
-	const displayName = fields.displayName?.trim() || displayNameFrom(fields.firstName, fields.lastName, handle ?? void 0);
+	const username = fields.username?.trim() || null;
+	const displayName = fields.displayName?.trim() || displayNameFrom(fields.firstName, fields.lastName, username ?? void 0);
 	if (!displayName) return null;
 	return {
 		providerId,
-		handle,
+		username,
 		displayName,
 		avatarURL: fields.avatarURL?.trim() || null,
 		headline: fields.headline?.trim() || null,
@@ -9971,7 +10290,7 @@ const rowFromUser = ({ user, providerId, raw }) => rowFrom$1({
 	displayName: user.display_name,
 	firstName: user.first_name,
 	lastName: user.last_name,
-	handle: user.public_identifier,
+	username: user.public_identifier,
 	avatarURL: user.public_picture_url,
 	headline: headlineFromUser(user),
 	raw
@@ -9985,7 +10304,7 @@ const extractProfile$1 = (body) => {
 		displayName: parsed.data.display_name,
 		firstName: parsed.data.first_name,
 		lastName: parsed.data.last_name,
-		handle: parsed.data.public_identifier,
+		username: parsed.data.public_identifier,
 		avatarURL: parsed.data.public_picture_url,
 		headline: headlineFromUser(parsed.data),
 		raw: parsed.data
@@ -10676,10 +10995,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 +11007,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",
@@ -13170,7 +13489,7 @@ const buildRuntimeArgs = (adapter, op) => {
 	};
 	args.account = {
 		type: "string",
-		description: "Account selector: @handle or profile_id:<id>; overrides config default"
+		description: "Account selector: @username or profile_id:<id>; overrides config default"
 	};
 	if (adapter.isCacheable(op.endpoint)) args.header = {
 		type: "string",
@@ -13669,8 +13988,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({
@@ -14093,7 +14412,7 @@ const linkedinRuntimeAdapter = {
 	accountFromOwnAccount: (ownAccount) => ownAccount.account,
 	ownAccountTargetId: (ownAccount) => ownAccount.providerId,
 	ownAccountHeader: (ownAccount, selectedAccount) => ownAccount?.accountIdHeader ?? selectedAccount.selector,
-	accountRecordInput: (ownAccount) => ownAccount.account.handle ?? ownAccount.providerId,
+	accountRecordInput: (ownAccount) => ownAccount.account.username ?? ownAccount.providerId,
 	argAliases: argNameAliasesFrom,
 	bodyParamArg,
 	bodyValidationError: ({ bodyFromJSON, bodyParamEntries, bodyParamValues, bodyText, bodyTextArg, displayTextArg, op }) => {
@@ -14197,6 +14516,8 @@ const DM_INTERACTION_ENDPOINT_BILLING = {
 	billingCategory: DM_INTERACTION_BILLING_CATEGORY,
 	costBPS: costBPSForCategory$1(DM_INTERACTION_BILLING_CATEGORY)
 };
+const LINKEDIN_RATE_LIMIT_RETRY_LIMIT$1 = 25;
+const LINKEDIN_RATE_LIMIT_MAX_FALLBACK_SECONDS$1 = 60;
 const linkedinSyncPageDelayMs = (pagesCompleted) => {
 	if (pagesCompleted < 10) return 1e3;
 	if (pagesCompleted < 20) return 2500;
@@ -14289,6 +14610,60 @@ const createSyncProgressReporter = (deps, collectionKey) => {
 		stop: () => void 0
 	};
 };
+const writeRateLimitRetryNotice$1 = (args) => {
+	process.stderr.write(`LinkedIn rate limited; waiting ${args.delaySeconds}s before retry ${args.retryCount}/${LINKEDIN_RATE_LIMIT_RETRY_LIMIT$1}.\n`);
+};
+const linkedInRateLimitFallbackDelaySeconds$1 = (retryCount) => Math.min(2 ** Math.max(0, retryCount - 1), LINKEDIN_RATE_LIMIT_MAX_FALLBACK_SECONDS$1);
+const shellQuote$1 = (value) => /^[A-Za-z0-9_@%+=:,./-]+$/.test(value) ? value : `'${value.replaceAll("'", "'\\''")}'`;
+const syncRetryCommand$1 = (platform, args) => {
+	const parts = [
+		"social",
+		platform,
+		"sync"
+	];
+	if (args.collection) parts.push(String(args.collection));
+	if (typeof args.account === "string") parts.push("--account", args.account);
+	if (typeof args.since === "string") parts.push("--since", args.since);
+	if (args.timeout != null) parts.push("--timeout", String(args.timeout));
+	return parts.map(shellQuote$1).join(" ");
+};
+const rateLimitCauseFor$1 = (error) => {
+	if (isRateLimitError(error)) return error;
+	if (error instanceof SyncPageError && isRateLimitError(error.cause)) return error.cause;
+};
+const enrichRateLimitSyncError$1 = (args) => {
+	const cause = rateLimitCauseFor$1(args.error);
+	if (!cause || typeof cause !== "object") return;
+	const retryAfterSeconds = retryAfterSecondsFromRateLimitError(cause);
+	const resumeAt = retryAfterSeconds === void 0 ? void 0 : new Date(Date.now() + retryAfterSeconds * 1e3).toISOString();
+	const retryCommand = syncRetryCommand$1(args.platform, args.commandArgs);
+	const cursorPersisted = args.error instanceof SyncPageError && args.error.cursorPersisted === true;
+	const savedPages = args.error instanceof SyncPageError && args.error.pagesCompleted > 0;
+	const retryAt = resumeAt ? ` at or after ${resumeAt}` : "";
+	Object.assign(cause, {
+		resumeAt,
+		retryCommand,
+		hint: `Rate limited. Wait${retryAt}, then run \`${retryCommand}\`. ${cursorPersisted ? "Already-synced pages are saved; this sync will resume from the saved cursor." : savedPages ? "Already-synced rows are saved, but this collection cannot safely resume the partial page walk; the re-run may re-fetch unfinished pages." : "No sync page completed before the abort."}`,
+		syncResume: {
+			collection: args.collectionKey,
+			command: retryCommand,
+			cursorPersisted,
+			savedPages,
+			behavior: cursorPersisted ? "resume" : "rerun"
+		}
+	});
+	return cause;
+};
+const syncRateLimitOptions$1 = (timeoutSeconds) => ({
+	retryAfterSecondsFor: retryAfterSecondsFromRateLimitError,
+	fallbackDelaySecondsForRetry: linkedInRateLimitFallbackDelaySeconds$1,
+	isRateLimitError,
+	...timeoutSeconds === void 0 ? {} : {
+		timeoutSeconds,
+		maxRetries: LINKEDIN_RATE_LIMIT_RETRY_LIMIT$1,
+		onRetry: writeRateLimitRetryNotice$1
+	}
+});
 const buildSync$1 = (deps, platform) => defineCommand({
 	meta: commandMeta$2({
 		name: "sync",
@@ -14344,7 +14719,7 @@ const buildSync$1 = (deps, platform) => defineCommand({
 		},
 		since: {
 			type: "string",
-			description: "ISO date/datetime or compact duration like 2:days|3:weeks|5:hours"
+			description: "ISO date (2026-05-04) or datetime (2026-05-04T00:00:00Z)"
 		},
 		reset: {
 			type: "boolean",
@@ -14353,6 +14728,10 @@ const buildSync$1 = (deps, platform) => defineCommand({
 		account: {
 			type: "string",
 			description: "Account selector; defaults to the first connected account"
+		},
+		timeout: {
+			type: "string",
+			description: "Optional LinkedIn rate-limit wait budget in seconds"
 		}
 	},
 	run: async ({ args }) => {
@@ -14364,6 +14743,7 @@ const buildSync$1 = (deps, platform) => defineCommand({
 		const accountSelector = requireAccountSelector$1(res.account.selector);
 		const accountHeaders = { "x-social-account-id": accountSelector };
 		if (args.credits != null) throw new UsageError("Unsupported option --credits for linkedin sync.");
+		const timeoutSeconds = args.timeout == null ? void 0 : deps.parseIntegerString("--timeout", args.timeout, { min: 1 });
 		if (!args.collection) {
 			if (args.reset === true) throw new UsageError("--reset requires a collection");
 			const cache = openLinkedinCache({
@@ -14436,12 +14816,20 @@ const buildSync$1 = (deps, platform) => defineCommand({
 				collection,
 				since,
 				onPage: progress.onPage,
-				onProgress
+				onProgress,
+				rateLimit: syncRateLimitOptions$1(timeoutSeconds)
 			});
 			progress.stop(summary);
 			deps.printData(summary);
 		} catch (error) {
 			progress.error();
+			const rateLimitError = enrichRateLimitSyncError$1({
+				error,
+				platform,
+				commandArgs: args,
+				collectionKey: collection.key
+			});
+			if (rateLimitError) throw rateLimitError;
 			throw error;
 		} finally {
 			cache.close();
@@ -14475,7 +14863,7 @@ const buildSql$1 = (deps, platform) => defineCommand({
 				formats: ["json"],
 				projection: false
 			},
-			examples: [{ command: "social linkedin sql \"SELECT * FROM li_messages LIMIT 5\"" }],
+			examples: [{ command: "social linkedin sql \"SELECT user_username, user_name, user_headline FROM li_connections WHERE user_headline LIKE '%founder%' LIMIT 20\"" }, { command: "social linkedin sql \"SELECT sender_name, text FROM li_messages ORDER BY created_at DESC LIMIT 20\"" }],
 			cost: {
 				metered: false,
 				unit: "local_cache",
@@ -14602,7 +14990,7 @@ const buildMark = (deps) => {
 			},
 			account: {
 				type: "string",
-				description: "Account selector: @handle or profile_id:<id>; overrides config default"
+				description: "Account selector: @username or profile_id:<id>; overrides config default"
 			}
 		},
 		run: async ({ args, cmd }) => {
@@ -14713,7 +15101,7 @@ const buildMessageDelete = (deps) => {
 			},
 			account: {
 				type: "string",
-				description: "Account selector: @handle or profile_id:<id>; overrides config default"
+				description: "Account selector: @username or profile_id:<id>; overrides config default"
 			}
 		},
 		run: async ({ args, cmd }) => {
@@ -14804,7 +15192,7 @@ const buildMessageEdit = (deps) => {
 			},
 			account: {
 				type: "string",
-				description: "Account selector: @handle or profile_id:<id>; overrides config default"
+				description: "Account selector: @username or profile_id:<id>; overrides config default"
 			}
 		},
 		run: async ({ args, cmd }) => {
@@ -14868,12 +15256,12 @@ const buildMessage$1 = (deps, sendCommand) => {
 			target: {
 				type: "positional",
 				required: true,
-				description: "LinkedIn person or conversation target: @handle, profile URL, profile_id:<id>, chat_id:<id>, or a messaging thread URL",
+				description: "LinkedIn person or conversation target: @username, profile URL, profile_id:<id>, chat_id:<id>, or a messaging thread URL",
 				valueHint: "target"
 			},
 			account: {
 				type: "string",
-				description: "Account selector: @handle or profile_id:<id>; overrides config default"
+				description: "Account selector: @username or profile_id:<id>; overrides config default"
 			}
 		},
 		run: async ({ args }) => {
@@ -14957,7 +15345,7 @@ const buildPosts = (liveCommand) => defineCommand({
 		});
 	}
 });
-const messagesTeachingUsage = "LinkedIn messages live in your local mirror. Read them with: social linkedin sql \"SELECT * FROM li_messages ORDER BY timestamp DESC LIMIT 20\" (after `social linkedin sync messages`). To change read state: social linkedin messages chat_id:<id> mark read|unread";
+const messagesTeachingUsage = "LinkedIn messages live in your local mirror. Read them with: social linkedin sql \"SELECT sender_name, text FROM li_messages ORDER BY created_at DESC LIMIT 20\" (after `social linkedin sync messages`). To change read state: social linkedin messages chat_id:<id> mark read|unread";
 const buildMessages = (deps) => {
 	const markCommand = buildMark(deps);
 	const schemaContract = markCommand.meta.schemaContract;
@@ -14980,7 +15368,7 @@ const buildMessages = (deps) => {
 			},
 			account: {
 				type: "string",
-				description: "Account selector: @handle or profile_id:<id>; overrides config default"
+				description: "Account selector: @username or profile_id:<id>; overrides config default"
 			}
 		},
 		run: async ({ args }) => {
@@ -15317,12 +15705,12 @@ const XUser = looseObject({
 const rowFrom = (user) => {
 	const providerId = user.id.trim();
 	if (!providerId) return null;
-	const handle = user.username?.trim() || null;
-	const displayName = user.name?.trim() || handle || "";
+	const username = user.username?.trim() || null;
+	const displayName = user.name?.trim() || username || "";
 	if (!displayName) return null;
 	return {
 		providerId,
-		handle,
+		username,
 		displayName,
 		avatarURL: user.profile_image_url?.trim() || null,
 		headline: user.description?.trim() || null,
@@ -15550,7 +15938,7 @@ const X_OPERATIONS = [
 			required: true,
 			kind: "string",
 			valueHint: "target",
-			description: "Target profile: @handle, profile URL, or profile_id:<id>"
+			description: "Target profile: @username, profile URL, or profile_id:<id>"
 		}]
 	},
 	{
@@ -16102,7 +16490,7 @@ const X_OPERATIONS = [
 				required: true,
 				kind: "string",
 				valueHint: "target",
-				description: "Target profile: @handle, profile URL, or profile_id:<id>. Defaults to the selected account when omitted."
+				description: "Target profile: @username, profile URL, or profile_id:<id>. Defaults to the selected account when omitted."
 			},
 			{
 				name: "user.fields",
@@ -16278,7 +16666,7 @@ const X_OPERATIONS = [
 				required: true,
 				kind: "string",
 				valueHint: "target",
-				description: "Target profile: @handle, profile URL, or profile_id:<id>. Defaults to the selected account when omitted."
+				description: "Target profile: @username, profile URL, or profile_id:<id>. Defaults to the selected account when omitted."
 			},
 			{
 				name: "max_results",
@@ -16362,7 +16750,7 @@ const X_OPERATIONS = [
 				required: true,
 				kind: "string",
 				valueHint: "target",
-				description: "Target profile: @handle, profile URL, or profile_id:<id>. Defaults to the selected account when omitted."
+				description: "Target profile: @username, profile URL, or profile_id:<id>. Defaults to the selected account when omitted."
 			},
 			{
 				name: "max_results",
@@ -16453,7 +16841,7 @@ const X_OPERATIONS = [
 				required: true,
 				kind: "string",
 				valueHint: "target",
-				description: "Target profile: @handle, profile URL, or profile_id:<id>. Defaults to the selected account when omitted."
+				description: "Target profile: @username, profile URL, or profile_id:<id>. Defaults to the selected account when omitted."
 			},
 			{
 				name: "max_results",
@@ -16565,7 +16953,7 @@ const X_OPERATIONS = [
 				required: true,
 				kind: "string",
 				valueHint: "target",
-				description: "Target profile: @handle, profile URL, or profile_id:<id>. Defaults to the selected account when omitted."
+				description: "Target profile: @username, profile URL, or profile_id:<id>. Defaults to the selected account when omitted."
 			},
 			{
 				name: "since_id",
@@ -16848,7 +17236,7 @@ const X_OPERATIONS = [
 				required: true,
 				kind: "string",
 				valueHint: "target",
-				description: "Target profile: @handle, profile URL, or profile_id:<id>. Defaults to the selected account when omitted."
+				description: "Target profile: @username, profile URL, or profile_id:<id>. Defaults to the selected account when omitted."
 			},
 			{
 				name: "since_id",
@@ -17852,13 +18240,13 @@ const targetDescriptionFor = (targetKind) => {
 	const kinds = kindsOf(targetKind);
 	if (kinds.length === 1) {
 		const [kind] = kinds;
-		if (kind === "profile") return "Target profile: @handle, profile URL, or profile_id:<id>";
+		if (kind === "profile") return "Target profile: @username, profile URL, or profile_id:<id>";
 		if (kind === "post") return "Target post: a post URL or post_id:<id>";
 		if (kind === "list") return "Target list: a list URL or list_id:<id>";
 		if (kind === "chat") return "Target conversation: a chat URL or chat_id:<id>";
 		return "Target company: a company URL or company_id:<id>";
 	}
-	return "Target: @handle, URL, or a typed ID such as profile_id:<id>.";
+	return "Target: @username, URL, or a typed ID such as profile_id:<id>.";
 };
 const commandParameters = (op) => op.parameters.filter((p) => !(p.in === "path" && ownMode(op, p.name) === "implicit"));
 const parameterHelpRank = (op, param, index) => {
@@ -18105,7 +18493,7 @@ const xRuntimeAdapter = {
 	accountFromOwnAccount: (ownAccount) => ownAccount.account,
 	ownAccountTargetId: (ownAccount) => ownAccount.xUserId,
 	ownAccountHeader: (_ownAccount, selectedAccount) => selectedAccount.selector,
-	accountRecordInput: (ownAccount) => ownAccount.account.handle ?? ownAccount.xUserId,
+	accountRecordInput: (ownAccount) => ownAccount.account.username ?? ownAccount.xUserId,
 	argAliases,
 	bodyTextResolvesTarget: resolvesTargetArg,
 	bodyTextTargetRequired: resolvesTargetArg,
@@ -18181,6 +18569,50 @@ const syncListRowFor = (collection, shortName, state) => {
 		objectCount: lastSynced === null ? null : state?.objectCount ?? 0
 	};
 };
+const shellQuote = (value) => /^[A-Za-z0-9_@%+=:,./-]+$/.test(value) ? value : `'${value.replaceAll("'", "'\\''")}'`;
+const syncRetryCommand = (platform, args) => {
+	const parts = [
+		"social",
+		platform,
+		"sync"
+	];
+	if (args.collection) parts.push(String(args.collection));
+	if (typeof args.account === "string") parts.push("--account", args.account);
+	if (typeof args.since === "string") parts.push("--since", args.since);
+	if (args.timeout != null) parts.push("--timeout", String(args.timeout));
+	return parts.map(shellQuote).join(" ");
+};
+const rateLimitCauseFor = (error) => {
+	if (isRateLimitError(error)) return error;
+	if (error instanceof SyncPageError && isRateLimitError(error.cause)) return error.cause;
+};
+const enrichRateLimitSyncError = (args) => {
+	const cause = rateLimitCauseFor(args.error);
+	if (!cause || typeof cause !== "object") return;
+	const retryAfterSeconds = retryAfterSecondsFromRateLimitError(cause);
+	const resumeAt = retryAfterSeconds === void 0 ? void 0 : new Date(Date.now() + retryAfterSeconds * 1e3).toISOString();
+	const retryCommand = syncRetryCommand(args.platform, args.commandArgs);
+	const cursorPersisted = args.error instanceof SyncPageError && args.error.cursorPersisted === true;
+	const savedPages = args.error instanceof SyncPageError && args.error.pagesCompleted > 0;
+	const retryAt = resumeAt ? ` at or after ${resumeAt}` : "";
+	Object.assign(cause, {
+		resumeAt,
+		retryCommand,
+		hint: `Rate limited. Wait${retryAt}, then run \`${retryCommand}\`. ${cursorPersisted ? "Already-synced pages are saved; this sync will resume from the saved cursor." : savedPages ? "Already-synced rows are saved, but this collection cannot safely resume the partial page walk; the re-run may re-fetch unfinished pages." : "No sync page completed before the abort."}`,
+		syncResume: {
+			collection: args.collectionKey,
+			command: retryCommand,
+			cursorPersisted,
+			savedPages,
+			behavior: cursorPersisted ? "resume" : "rerun"
+		}
+	});
+	return cause;
+};
+const syncRateLimitOptions = () => ({
+	retryAfterSecondsFor: retryAfterSecondsFromRateLimitError,
+	isRateLimitError
+});
 const buildSync = (deps, platform) => defineCommand({
 	meta: commandMeta$1({
 		name: "sync",
@@ -18231,7 +18663,7 @@ const buildSync = (deps, platform) => defineCommand({
 		},
 		since: {
 			type: "string",
-			description: "ISO date/datetime or compact duration like 2:days|3:weeks|5:hours"
+			description: "ISO date (2026-05-04) or datetime (2026-05-04T00:00:00Z)"
 		},
 		reset: {
 			type: "boolean",
@@ -18240,6 +18672,10 @@ const buildSync = (deps, platform) => defineCommand({
 		account: {
 			type: "string",
 			description: "Account selector; defaults to the first connected account"
+		},
+		timeout: {
+			type: "string",
+			description: "Optional rate-limit wait budget in seconds"
 		}
 	},
 	run: async ({ args }) => {
@@ -18251,6 +18687,7 @@ const buildSync = (deps, platform) => defineCommand({
 		const accountSelector = requireAccountSelector(res.account.selector);
 		const accountHeaders = { "x-social-account-id": accountSelector };
 		if (args.credits != null) throw new UsageError("Unsupported option --credits for x sync.");
+		if (args.timeout != null) deps.parseIntegerString("--timeout", args.timeout, { min: 1 });
 		if (!args.collection) {
 			if (args.reset === true) throw new UsageError("--reset requires a collection");
 			const cache = openXCache({
@@ -18309,9 +18746,19 @@ const buildSync = (deps, platform) => defineCommand({
 			}, {
 				collection,
 				since,
-				onProgress
+				onProgress,
+				rateLimit: syncRateLimitOptions()
 			});
 			deps.printData(summary);
+		} catch (error) {
+			const rateLimitError = enrichRateLimitSyncError({
+				error,
+				platform,
+				commandArgs: args,
+				collectionKey: collection.key
+			});
+			if (rateLimitError) throw rateLimitError;
+			throw error;
 		} finally {
 			cache.close();
 		}
@@ -18346,7 +18793,7 @@ const buildSql = (deps, platform) => {
 			formats: ["json"],
 			projection: false
 		},
-		examples: [{ command: "social x sql \"SELECT * FROM x_tweets LIMIT 5\"" }],
+		examples: [{ command: "social x sql \"SELECT username, name, followers_count FROM x_followers ORDER BY followers_count DESC LIMIT 20\"" }, { command: "social x sql \"SELECT username, name FROM x_following WHERE verified = 1 ORDER BY followers_count DESC LIMIT 20\"" }],
 		cost: {
 			metered: false,
 			unit: "local_cache",
@@ -18452,7 +18899,7 @@ const buildTweets = (deps) => {
 	if (args.target !== void 0) args.target = {
 		...args.target,
 		required: true,
-		description: "Target profile: @handle, profile URL, or profile_id:<id>"
+		description: "Target profile: @username, profile URL, or profile_id:<id>"
 	};
 	return defineCommand({
 		meta: commandMeta$1({
@@ -18486,12 +18933,12 @@ const buildMessage = (deps) => {
 			recipients: {
 				type: "positional",
 				required: true,
-				description: "Recipient(s): chat URL, chat_id:<id>, @handle, profile URL, or profile_id:<id>; comma-separate profiles for a group",
+				description: "Recipient(s): chat URL, chat_id:<id>, @username, profile URL, or profile_id:<id>; comma-separate profiles for a group",
 				valueHint: "recipients"
 			},
 			account: {
 				type: "string",
-				description: "Account selector: @handle or profile_id:<id>; overrides config default"
+				description: "Account selector: @username or profile_id:<id>; overrides config default"
 			}
 		},
 		run: async ({ args }) => {
@@ -18607,7 +19054,7 @@ const buildReplies = (deps) => {
 			},
 			account: {
 				type: "string",
-				description: "Account selector: @handle or profile_id:<id>; overrides config default"
+				description: "Account selector: @username or profile_id:<id>; overrides config default"
 			}
 		},
 		run: async ({ args }) => {
@@ -18777,14 +19224,14 @@ const prepareAccountConnect$1 = async (deps) => {
 	await pollForSeat$2(deps);
 };
 const normalizeIdentifier$1 = (value) => value.trim().replace(LEADING_AT_PATTERN$1, "").toLowerCase();
-const accountHandle = (account) => account.handle.replace(LEADING_AT_PATTERN$1, "");
+const accountUsername = (account) => account.username.replace(LEADING_AT_PATTERN$1, "");
 const linkedinReconnectTargetFrom = (value) => {
 	const trimmed = value.trim();
 	if (trimmed.startsWith("@")) {
-		const handle = normalizeIdentifier$1(trimmed);
-		if (handle) return {
-			type: "handle",
-			value: handle
+		const username = normalizeIdentifier$1(trimmed);
+		if (username) return {
+			type: "username",
+			value: username
 		};
 	}
 	if (trimmed.startsWith("profile_id:")) {
@@ -18799,20 +19246,20 @@ const linkedinReconnectTargetFrom = (value) => {
 		if ((url.protocol === "https:" || url.protocol === "http:") && LINKEDIN_PROFILE_HOST_PATTERN.test(url.hostname.replace(/^www\./i, ""))) {
 			const [, section, publicIdentifier] = url.pathname.split("/");
 			if (section === "in" && publicIdentifier) return {
-				type: "handle",
+				type: "username",
 				value: decodeURIComponent(publicIdentifier).toLowerCase()
 			};
 		}
 	} catch {}
-	throw new Error("LinkedIn reconnect account must be @handle, a LinkedIn profile URL, or profile_id:<id>.");
+	throw new Error("LinkedIn reconnect account must be @username, a LinkedIn profile URL, or profile_id:<id>.");
 };
 const accountMatchesReconnectTarget = (account, target) => {
 	if (target.type === "profileId") return account.profileId.toLowerCase() === target.value;
-	return normalizeIdentifier$1(account.handle) === target.value;
+	return normalizeIdentifier$1(account.username) === target.value;
 };
 const reconnectCommandTargetFor = (account) => {
-	const handle = accountHandle(account);
-	return normalizeIdentifier$1(handle) === normalizeIdentifier$1(account.profileId) ? `profile_id:${account.profileId}` : `@${handle}`;
+	const username = accountUsername(account);
+	return normalizeIdentifier$1(username) === normalizeIdentifier$1(account.profileId) ? `profile_id:${account.profileId}` : `@${username}`;
 };
 const listLinkedinLifecycleAccounts = (deps, includeDisconnected = true) => deps.client.listAccounts({
 	platform: LINKEDIN_PLATFORM,
@@ -18872,7 +19319,7 @@ const reconnectLinkedinAccount = async (deps, identifier) => {
 	return {
 		platform: LINKEDIN_PLATFORM,
 		status: "connected",
-		account: await pollForAccount$1(deps, (candidate) => candidate.profileId === account.profileId && candidate.status === CONNECTED_STATUS, `Timed out waiting for LinkedIn account ${account.handle} to reconnect.`)
+		account: await pollForAccount$1(deps, (candidate) => candidate.profileId === account.profileId && candidate.status === CONNECTED_STATUS, `Timed out waiting for LinkedIn account @${accountUsername(account)} to reconnect.`)
 	};
 };
 const disconnectLinkedinAccount = async (deps, identifier) => {
@@ -18947,7 +19394,7 @@ const prepareAccountConnect = async (deps) => {
 };
 const accountKey = (account) => account.profileId;
 const normalizeIdentifier = (value) => value.trim().replace(/^@+/, "").toLowerCase();
-const accountSelectorFor$1 = (account) => account.handle || `profile_id:${account.profileId}`;
+const accountSelectorFor$1 = (account) => account.username ? `@${account.username.replace(/^@+/, "")}` : `profile_id:${account.profileId}`;
 const assertXAccountSelector = (target) => {
 	const trimmed = target.trim();
 	if (trimmed.startsWith("profile_id:")) {
@@ -18955,7 +19402,7 @@ const assertXAccountSelector = (target) => {
 		if (profileId && !/[/?#%]/.test(profileId)) return;
 	}
 	if (trimmed.startsWith("@") && !/[/?#%]/.test(trimmed)) return;
-	throw new Error("account must be an @handle or profile_id:<id>.");
+	throw new Error("account must be an @username or profile_id:<id>.");
 };
 const findAccount = (accounts, target) => {
 	const trimmed = target.trim();
@@ -18963,7 +19410,7 @@ const findAccount = (accounts, target) => {
 		const profileId = trimmed.slice(11).trim().toLowerCase();
 		return accounts.find((account) => account.profileId.toLowerCase() === profileId);
 	}
-	if (trimmed.startsWith("@")) return accounts.find((account) => normalizeIdentifier(account.handle) === normalizeIdentifier(target));
+	if (trimmed.startsWith("@")) return accounts.find((account) => normalizeIdentifier(account.username) === normalizeIdentifier(target));
 };
 const listXLifecycleAccounts = (deps, includeDisconnected) => deps.client.accounts.list({
 	platform: "x",
@@ -21572,7 +22019,7 @@ const createInstance = (defaults) => {
 const ky = createInstance();
 //#endregion
 //#region package.json
-var version$1 = "0.7.0";
+var version$1 = "0.8.0";
 //#endregion
 //#region src/lib/env.ts
 const URLWithTrailingSlash = url().transform(ensureTrailingSlash);
@@ -21705,12 +22152,20 @@ var CLIAPIError = class extends Error {
 	status;
 	body;
 	retryAfterSeconds;
-	constructor(message, status, body, retryAfterSeconds) {
+	hint;
+	resumeAt;
+	retryCommand;
+	syncResume;
+	constructor(message, status, body, retryAfterSeconds, details = {}) {
 		super(message);
 		this.name = "CLIAPIError";
 		this.status = status;
 		this.body = body;
 		this.retryAfterSeconds = retryAfterSeconds;
+		this.hint = details.hint;
+		this.resumeAt = details.resumeAt;
+		this.retryCommand = details.retryCommand;
+		this.syncResume = details.syncResume;
 	}
 };
 const readBearerToken = async () => {
@@ -21720,8 +22175,12 @@ const readBearerToken = async () => {
 };
 const linkedInRateLimitFallbackDelaySeconds = (retryCount) => Math.min(2 ** Math.max(0, retryCount - 1), LINKEDIN_RATE_LIMIT_MAX_FALLBACK_SECONDS);
 const linkedInRateLimitRetryDelaySeconds = (retryCount, retryAfterSeconds) => retryAfterSeconds ?? linkedInRateLimitFallbackDelaySeconds(retryCount);
+const linkedInRateLimitWaitBudgetCovers = (args) => args.delaySeconds <= (args.waitBudgetSeconds ?? LINKEDIN_RATE_LIMIT_MAX_FALLBACK_SECONDS);
 const isLinkedInProxyRequest = (request) => new URL(request.url).pathname.includes("/linkedin/");
-const shouldRetryLinkedInRateLimit = (args) => args.error instanceof HTTPError && args.error.response.status === 429 && isLinkedInProxyRequest(args.error.request) && args.retryCount <= LINKEDIN_RATE_LIMIT_RETRY_LIMIT;
+const shouldRetryLinkedInRateLimit = (args) => args.error instanceof HTTPError && args.error.response.status === 429 && isLinkedInProxyRequest(args.error.request) && args.retryCount <= LINKEDIN_RATE_LIMIT_RETRY_LIMIT && linkedInRateLimitWaitBudgetCovers({
+	delaySeconds: linkedInRateLimitRetryDelaySeconds(args.retryCount, retryAfterSecondsFrom(args.error.response.headers.get("retry-after"))),
+	waitBudgetSeconds: args.waitBudgetSeconds
+});
 const writeRateLimitRetryNotice = (args) => {
 	process.stderr.write(`LinkedIn rate limited; waiting ${args.delaySeconds}s before retry ${args.retryCount}/${LINKEDIN_RATE_LIMIT_RETRY_LIMIT}.\n`);
 };
@@ -21913,26 +22372,9 @@ const authWhoamiOutput = async (client, apiURL = env.SOCIAL_API_URL) => {
 		};
 	}
 };
-//#endregion
-//#region src/lib/config.ts
-const CACHE_MODE_TTL_SECONDS = {
-	live: 900,
-	analytical: 1440 * 60,
-	historical: 10080 * 60
-};
-const CACHE_MODES = [
-	"live",
-	"analytical",
-	"historical"
-];
-const MAX_CACHE_TTL_SECONDS = CACHE_MODE_TTL_SECONDS.historical;
-const CacheMode = _enum$1([...CACHE_MODES, "custom"]);
-const ConfigurableCacheMode = _enum$1(CACHE_MODES);
-const CLIConfig = object$1({ cache: object$1({
-	mode: CacheMode.default("live"),
-	cacheTTLSeconds: number$1().int().min(0).max(MAX_CACHE_TTL_SECONDS).optional()
-}).default({ mode: "live" }) });
-const defaultCLIConfig = () => ({ cache: { mode: "live" } });
+const MAX_CACHE_TTL_SECONDS = 10080 * 60;
+const CLIConfig = object$1({ cache: object$1({ cacheTTLSeconds: number$1().int().min(0).max(MAX_CACHE_TTL_SECONDS).default(900) }).default({ cacheTTLSeconds: 900 }) });
+const defaultCLIConfig = () => ({ cache: { cacheTTLSeconds: 900 } });
 const configPath = () => join(process.env.HOME ?? homedir(), ".social", "config.json");
 const parseCLIConfig = (serialized) => CLIConfig.parse(JSON.parse(serialized));
 const readCLIConfig = async () => {
@@ -21950,27 +22392,15 @@ const writeCLIConfig = async (config) => {
 	await writeFile(path, `${JSON.stringify(parsed, null, 2)}\n`, { mode: 384 });
 	await chmod(path, 384);
 };
-const cacheTTLSecondsFrom = (config) => config.cache.mode === "custom" ? config.cache.cacheTTLSeconds ?? CACHE_MODE_TTL_SECONDS.live : CACHE_MODE_TTL_SECONDS[config.cache.mode];
-const setCacheMode = async (mode) => {
-	const next = {
-		...await readCLIConfig(),
-		cache: { mode }
-	};
-	await writeCLIConfig(next);
-	return next;
-};
 const setCacheTTLSeconds = async (cacheTTLSeconds) => {
 	const next = {
 		...await readCLIConfig(),
-		cache: {
-			mode: "custom",
-			cacheTTLSeconds
-		}
+		cache: { cacheTTLSeconds }
 	};
 	await writeCLIConfig(next);
 	return next;
 };
-const cacheControlHeaderFromConfig = async () => `max-age=${cacheTTLSecondsFrom(await readCLIConfig())}`;
+const cacheControlHeaderFromConfig = async () => `max-age=${(await readCLIConfig()).cache.cacheTTLSeconds}`;
 //#endregion
 //#region src/lib/output.ts
 const isRecord$3 = (value) => Boolean(value && typeof value === "object" && !Array.isArray(value));
@@ -22159,7 +22589,7 @@ const resultEnvelope = ({ account, contract, data, local, resolved = [], respons
 	return {
 		account: {
 			platform: account.platform,
-			handle: account.handle
+			username: account.username
 		},
 		...payload,
 		meta: {
@@ -22189,7 +22619,11 @@ const errorPayload = (error) => {
 		type: error.name,
 		status: error.status,
 		body: error.body,
-		retryAfterSeconds: error.retryAfterSeconds
+		retryAfterSeconds: error.retryAfterSeconds,
+		resumeAt: error.resumeAt,
+		retryCommand: error.retryCommand,
+		hint: error.hint,
+		syncResume: error.syncResume
 	};
 	if (error instanceof Error) return {
 		error: error.message,
@@ -22213,7 +22647,11 @@ const apiErrorCause = (error) => ({
 	error: error.message,
 	status: error.status,
 	body: error.body,
-	retryAfterSeconds: error.retryAfterSeconds
+	retryAfterSeconds: error.retryAfterSeconds,
+	resumeAt: error.resumeAt,
+	retryCommand: error.retryCommand,
+	hint: error.hint,
+	syncResume: error.syncResume
 });
 const errorCause = (error) => {
 	if (!("cause" in error)) return {};
@@ -22287,7 +22725,7 @@ const TARGET_PREFIXES = {
 	request_id: "request"
 };
 const KIND_HINTS = {
-	profile: "a profile (@handle, a profile URL, or profile_id:…)",
+	profile: "a profile (@username, a profile URL, or profile_id:…)",
 	post: "a post (a post URL or post_id:…)",
 	list: "a list (a list URL or list_id:…)",
 	chat: "a conversation (a chat URL or chat_id:…)",
@@ -22399,8 +22837,8 @@ const resolveTarget = async (name, value, options) => {
 			const list = url.pathname.match(/^\/i\/lists\/(\d+)/)?.[1];
 			if (list) return accept("list", list, { url: url.toString() });
 			const segments = url.pathname.split("/").filter(Boolean);
-			const handle = segments[0];
-			if (segments.length === 1 && handle && !X_RESERVED_SEGMENTS.has(handle.toLowerCase())) return await lookupProfile(handle, url.toString());
+			const username = segments[0];
+			if (segments.length === 1 && username && !X_RESERVED_SEGMENTS.has(username.toLowerCase())) return await lookupProfile(username, url.toString());
 		}
 		if (platform === "linkedin" && isLinkedinHost(url)) {
 			const post = linkedinPostURN(input, url);
@@ -22421,10 +22859,10 @@ const resolveTarget = async (name, value, options) => {
 	if (colon > 0) {
 		const prefix = input.slice(0, colon);
 		const kind = TARGET_PREFIXES[prefix];
-		if (!kind) throw validationError([name], `${name}: unknown prefix "${prefix}:". Use ${Object.keys(TARGET_PREFIXES).map((targetPrefix) => `${targetPrefix}:<id>`).join(", ")}, @handle, or a URL.`);
+		if (!kind) throw validationError([name], `${name}: unknown prefix "${prefix}:". Use ${Object.keys(TARGET_PREFIXES).map((targetPrefix) => `${targetPrefix}:<id>`).join(", ")}, @username, or a URL.`);
 		return accept(kind, parseResourceId(name, input.slice(colon + 1)));
 	}
-	throw validationError([name], `${name} must be @handle, a URL, or a typed ID (${Object.keys(TARGET_PREFIXES).map((targetPrefix) => `${targetPrefix}:<id>`).join(", ")}). Bare IDs are not accepted.`);
+	throw validationError([name], `${name} must be @username, a URL, or a typed ID (${Object.keys(TARGET_PREFIXES).map((targetPrefix) => `${targetPrefix}:<id>`).join(", ")}). Bare IDs are not accepted.`);
 };
 const plainResourceRecord = (platform, kind, id, options = {}) => resolutionRecord({
 	input: options.input ?? id,
@@ -22493,14 +22931,8 @@ const commandMeta = (meta) => {
 		contract
 	};
 };
-const CacheStateOutput = object$1({
-	mode: string$1(),
-	cacheTTLSeconds: number$1().int().nonnegative()
-});
-const cacheStateFrom = (config) => ({
-	mode: config.cache.mode,
-	cacheTTLSeconds: cacheTTLSecondsFrom(config)
-});
+const CacheStateOutput = object$1({ cacheTTLSeconds: number$1().int().nonnegative() });
+const cacheStateFrom = (config) => ({ cacheTTLSeconds: config.cache.cacheTTLSeconds });
 const printCacheState = (config) => {
 	printData(cacheStateFrom(config));
 };
@@ -22514,79 +22946,43 @@ const configCommand = defineCommand({
 			name: "cache",
 			description: "Read or configure proxy cache defaults."
 		},
-		subCommands: {
-			mode: defineCommand({
-				meta: commandMeta({
-					name: "mode",
-					description: "Read or set the default cache mode.",
-					contract: {
-						capability: "none",
-						auth: {
-							local: true,
-							required: false
-						},
-						mutates: true,
-						outputSchema: CacheStateOutput,
-						idempotency: "idempotent",
-						confirmation: false,
-						responseShaping: { formats: ["json"] },
-						hazards: [{
-							code: "local_config_write",
-							message: "Writes local CLI configuration when mode is provided."
-						}]
-					}
-				}),
-				args: { mode: {
-					type: "positional",
-					required: false,
-					description: "Cache mode: live, analytical, or historical."
-				} },
-				run: async ({ args }) => {
-					if (args.mode === void 0) {
-						printCacheState(await readCLIConfig());
-						return;
-					}
-					printCacheState(await setCacheMode(ConfigurableCacheMode.parse(String(args.mode))));
+		subCommands: { ttl: defineCommand({
+			meta: commandMeta({
+				name: "ttl",
+				description: "Read or set the default cache TTL in seconds.",
+				contract: {
+					capability: "none",
+					auth: {
+						local: true,
+						required: false
+					},
+					mutates: true,
+					outputSchema: CacheStateOutput,
+					idempotency: "idempotent",
+					confirmation: false,
+					responseShaping: { formats: ["json"] },
+					hazards: [{
+						code: "local_config_write",
+						message: "Writes local CLI configuration when ttl_seconds is provided."
+					}]
 				}
 			}),
-			ttl: defineCommand({
-				meta: commandMeta({
-					name: "ttl",
-					description: "Read or set the default cache TTL in seconds.",
-					contract: {
-						capability: "none",
-						auth: {
-							local: true,
-							required: false
-						},
-						mutates: true,
-						outputSchema: CacheStateOutput,
-						idempotency: "idempotent",
-						confirmation: false,
-						responseShaping: { formats: ["json"] },
-						hazards: [{
-							code: "local_config_write",
-							message: "Writes local CLI configuration when ttl_seconds is provided."
-						}]
-					}
-				}),
-				args: { ttl_seconds: {
-					type: "positional",
-					required: false,
-					description: "Cache TTL in seconds. Setting this switches cache mode to custom."
-				} },
-				run: async ({ args }) => {
-					if (args.ttl_seconds === void 0) {
-						printCacheState(await readCLIConfig());
-						return;
-					}
-					printCacheState(await setCacheTTLSeconds(parseIntegerString("--ttl-seconds", args.ttl_seconds, {
-						min: 0,
-						max: MAX_CACHE_TTL_SECONDS
-					})));
+			args: { ttl_seconds: {
+				type: "positional",
+				required: false,
+				description: "Cache TTL in seconds."
+			} },
+			run: async ({ args }) => {
+				if (args.ttl_seconds === void 0) {
+					printCacheState(await readCLIConfig());
+					return;
 				}
-			})
-		}
+				printCacheState(await setCacheTTLSeconds(parseIntegerString("--ttl-seconds", args.ttl_seconds, {
+					min: 0,
+					max: MAX_CACHE_TTL_SECONDS
+				})));
+			}
+		}) }
 	}) }
 });
 //#endregion
@@ -28871,7 +29267,7 @@ const writeAuthContract = {
 };
 const LifecycleAccountOutput = object$1({
 	platform: string$1(),
-	handle: string$1(),
+	username: string$1(),
 	profileId: string$1(),
 	url: string$1(),
 	displayName: string$1(),
@@ -28937,17 +29333,17 @@ const AccountOverviewOutput = object$1({
 const accountArg = {
 	type: "positional",
 	required: true,
-	description: "Account @handle, profile URL, or profile_id:<id>."
+	description: "Account @username, profile URL, or profile_id:<id>."
 };
 const xAccountArg = {
 	type: "positional",
 	required: true,
-	description: "X account @handle or profile_id:<id>."
+	description: "X account @username or profile_id:<id>."
 };
 const linkedinReconnectAccountArg = {
 	type: "positional",
 	required: true,
-	description: "LinkedIn account @handle, profile URL, or profile_id:<id>."
+	description: "LinkedIn account @username, profile URL, or profile_id:<id>."
 };
 const writeOutput = async (deps, value) => {
 	if (deps.writeOutput) {
@@ -28973,7 +29369,7 @@ const lifecycleConnectContract = {
 	idempotency: "non-idempotent",
 	confirmation: false
 };
-const handleFor = (account) => account.handle.startsWith("@") ? account.handle : `@${account.handle}`;
+const usernameLabelFor = (account) => account.username.startsWith("@") ? account.username : `@${account.username}`;
 const authHandshakeMessage = "Handshaking auth...";
 const lifecycleDepsWithTextLogs = (deps) => ({
 	...deps,
@@ -28998,7 +29394,7 @@ const lifecycleDepsWithTextLogs = (deps) => ({
 	}
 });
 const runConnectOutput = async (deps, connect) => {
-	writeText(deps, `${handleFor((await connect(lifecycleDepsWithTextLogs(deps))).account)} connected!`);
+	writeText(deps, `${usernameLabelFor((await connect(lifecycleDepsWithTextLogs(deps))).account)} connected!`);
 };
 const createConnectPlatformCommand = (platform, run) => defineCommand({
 	meta: commandMeta({
@@ -29206,11 +29602,11 @@ const createFeedbackCommand = (deps) => defineCommand({
 //#region src/lib/account.ts
 const LEADING_AT_PATTERN = /^@+/;
 const normalizeAccountIdentifier = (value) => value.trim().replace(LEADING_AT_PATTERN, "").toLowerCase();
-const accountSelectorFor = (account) => account.handle || `profile_id:${account.profileId}`;
+const accountSelectorFor = (account) => account.username ? `@${account.username.replace(LEADING_AT_PATTERN, "")}` : `profile_id:${account.profileId}`;
 const accountMatchesIdentifier = (account, identifier) => {
 	const trimmed = identifier.trim();
 	if (trimmed.startsWith("profile_id:")) return account.profileId.toLowerCase() === trimmed.slice(11).trim().toLowerCase();
-	return trimmed.startsWith("@") && normalizeAccountIdentifier(account.handle) === normalizeAccountIdentifier(trimmed);
+	return trimmed.startsWith("@") && normalizeAccountIdentifier(account.username) === normalizeAccountIdentifier(trimmed);
 };
 const resolveAccountId = ({ account }) => {
 	if (!account) return;
@@ -29306,12 +29702,12 @@ const createCLIDeps = () => {
 		if (account && !selected) throw new NotFoundError("account_not_found");
 		return {
 			platform,
-			handle: selected?.handle ?? (account?.startsWith("@") ? account : `@${account ?? "default"}`),
+			username: selected?.username ?? (account?.startsWith("@") ? account.slice(1) : account ?? "default"),
 			selector: selected ? accountSelectorFor(selected) : account
 		};
 	};
 	const lookupXHandle = async (input, account) => {
-		const handle = input.replace(/^@+/, "");
+		const inputUsername = input.replace(/^@+/, "");
 		const selectedAccount = await resolveAccount({
 			account,
 			platform: "x"
@@ -29320,13 +29716,13 @@ const createCLIDeps = () => {
 			"Cache-Control": await cacheControlHeaderFromConfig(),
 			...selectedAccount.selector === void 0 ? {} : { "x-social-account-id": selectedAccount.selector }
 		};
-		const data = await api.get(`x/users/by/username/${encodeURIComponent(handle)}`, { headers }).json();
-		if (!data || typeof data !== "object" || !("data" in data)) throw new Error(`Could not resolve X handle ${input}.`);
+		const data = await api.get(`x/users/by/username/${encodeURIComponent(inputUsername)}`, { headers }).json();
+		if (!data || typeof data !== "object" || !("data" in data)) throw new Error(`Could not resolve X username ${input}.`);
 		const user = data.data;
-		if (!user || typeof user !== "object" || !("id" in user)) throw new Error(`Could not resolve X handle ${input}.`);
+		if (!user || typeof user !== "object" || !("id" in user)) throw new Error(`Could not resolve X username ${input}.`);
 		return {
 			id: String(user.id),
-			url: `https://x.com/${"username" in user && typeof user.username === "string" ? user.username : handle}`
+			url: `https://x.com/${"username" in user && typeof user.username === "string" ? user.username : inputUsername}`
 		};
 	};
 	const lookupLinkedinProfile = async (input, account, selectedAccount) => {
@@ -29417,7 +29813,7 @@ const createCLIDeps = () => {
 			return {
 				account: {
 					platform: "x",
-					handle: selected.handle,
+					username: selected.username,
 					selector: accountSelectorFor(selected)
 				},
 				accountIdHeader: accountSelectorFor(selected),
@@ -29434,13 +29830,13 @@ const createCLIDeps = () => {
 			if (!selected) throw account ? new NotFoundError("linkedin_account_not_found") : /* @__PURE__ */ new Error("linkedin_account_not_connected");
 			const profile = await lookupLinkedinProfile("me", account, {
 				platform: "linkedin",
-				handle: selected.handle,
+				username: selected.username,
 				selector: accountSelectorFor(selected)
 			});
 			return {
 				account: {
 					platform: "linkedin",
-					handle: selected.handle,
+					username: selected.username,
 					selector: accountSelectorFor(selected)
 				},
 				accountIdHeader: accountSelectorFor(selected),
@@ -29647,7 +30043,6 @@ const compactSchemaForCommand = (command, path) => {
 	const label = commandLabel(command, path);
 	const { method, capability, mutates } = declaredMetadataFor(command, contractFor(command, label), label, { require: false });
 	return {
-		schemaVersion: "1.0",
 		name: path.join(".") || commandName(command, "social"),
 		description: commandDescription(command),
 		...method ? { method } : {},
@@ -29667,7 +30062,6 @@ const compactLeafSchemaForCommand = (command, path) => {
 	if (capability === void 0 || mutates === void 0) throw new Error(`Missing CLI contract metadata for ${label}.`);
 	const pagination = metadataValueFor(contract.pagination ?? command.meta?.pagination, `${label}.pagination`);
 	return {
-		schemaVersion: "1.0",
 		path: path.join(" "),
 		name: path.join(".") || commandName(command, "social"),
 		description: commandDescription(command),
@@ -29694,14 +30088,12 @@ const schemaForCommand = (command, path) => {
 	const pagination = metadataValueFor(contract.pagination ?? command.meta?.pagination, `${label}.pagination`);
 	if (pagination === void 0) throw new Error(`Missing CLI contract pagination for ${label}.`);
 	return {
-		schemaVersion: "1.0",
 		name: path.join(".") || commandName(command, "social"),
 		description: commandDescription(command),
 		...method ? { method } : {},
 		...inputSourceFor(command),
 		args: metadataValueFor(contract.args, `${label}.args`) ?? positionalArgs,
 		flags: metadataValueFor(contract.flags, `${label}.flags`) ?? flags,
-		params: metadataValueFor(contract.params, `${label}.params`) ?? args,
 		inputSchema: inputSchemaFor(command, contract, label, args),
 		outputSchema,
 		auth: authFor(contract.auth ?? command.meta?.auth, capability),
@@ -29719,9 +30111,11 @@ const schemaForCommand = (command, path) => {
 };
 const treeForCommand = (command, path = []) => {
 	const subCommands = childCommandsFor(command);
+	const entries = Object.entries(subCommands).filter(([, subCommand]) => !isHiddenCommand(subCommand));
+	const visibleSubCommands = Object.fromEntries(entries.map(([name, subCommand]) => [name, treeForCommand(subCommand, [...path, commandName(subCommand, name)])]));
 	return {
 		...compactSchemaForCommand(command, path),
-		subCommands: Object.fromEntries(Object.entries(subCommands).filter(([, subCommand]) => !isHiddenCommand(subCommand)).map(([name, subCommand]) => [name, treeForCommand(subCommand, [...path, commandName(subCommand, name)])]))
+		...entries.length > 0 ? { subCommands: visibleSubCommands } : {}
 	};
 };
 const leafSchemasForCommand = (command, path = []) => {
@@ -29807,11 +30201,20 @@ const schemaCommand = defineCommand({
 			return;
 		}
 		if (parts.length === 0) {
-			printData(treeForCommand(rootCommand));
+			printData({
+				schemaVersion: "1.0",
+				...treeForCommand(rootCommand)
+			});
 			return;
 		}
 		const { command, path } = commandAtPath(rootCommand, parts);
-		printData(command.subCommands && typeof command.run !== "function" ? treeForCommand(command, path) : schemaForCommand(command, path));
+		printData(command.subCommands && typeof command.run !== "function" ? {
+			schemaVersion: "1.0",
+			...treeForCommand(command, path)
+		} : {
+			schemaVersion: "1.0",
+			...schemaForCommand(command, path)
+		});
 	}
 });
 //#endregion
@@ -29918,7 +30321,7 @@ const unknownSubCommandFor = async (command, rawArgs) => {
 * `commandForUsage` walk but collects names.
 *
 * PRIVACY: only tokens that resolve to a real subcommand are appended. The first
-* arg that does not resolve (a positional value: tweet ID, handle, query text,
+* arg that does not resolve (a positional value: tweet ID, username, query text,
 * flag value) breaks the walk and is NEVER captured. Never returns rawArgs or
 * flag values.
 */