birdclaw 0.8.3 → 0.8.4

package/src/lib/theme-transition.ts

@@ -1,113 +0,0 @@
-import { flushSync } from "react-dom";
-import type { ThemeValue } from "./theme";
-
-export interface ThemeTransitionContext {
-	element?: HTMLElement | null;
-	pointerClientX?: number;
-	pointerClientY?: number;
-}
-
-const clamp01 = (value: number) => {
-	if (Number.isNaN(value)) return 0.5;
-	if (value <= 0) return 0;
-	if (value >= 1) return 1;
-	return value;
-};
-
-const hasReducedMotionPreference = () => {
-	if (
-		typeof window === "undefined" ||
-		typeof window.matchMedia !== "function"
-	) {
-		return false;
-	}
-
-	return window.matchMedia("(prefers-reduced-motion: reduce)").matches ?? false;
-};
-
-const cleanupThemeTransition = (root: HTMLElement) => {
-	root.classList.remove("theme-transition");
-	root.style.removeProperty("--theme-switch-x");
-	root.style.removeProperty("--theme-switch-y");
-};
-
-export function startThemeTransition({
-	nextTheme,
-	currentTheme,
-	setTheme,
-	context,
-}: {
-	nextTheme: ThemeValue;
-	currentTheme: ThemeValue | null;
-	setTheme: (theme: ThemeValue) => void;
-	context?: ThemeTransitionContext;
-}) {
-	if (currentTheme === nextTheme) {
-		return;
-	}
-
-	if (typeof document === "undefined") {
-		setTheme(nextTheme);
-		return;
-	}
-
-	const root = document.documentElement;
-	const startViewTransition =
-		typeof document.startViewTransition === "function"
-			? document.startViewTransition.bind(document)
-			: undefined;
-	const canUseViewTransition =
-		Boolean(startViewTransition) && !hasReducedMotionPreference();
-
-	const applyTheme = () => {
-		flushSync(() => {
-			setTheme(nextTheme);
-		});
-	};
-
-	if (!canUseViewTransition) {
-		applyTheme();
-		cleanupThemeTransition(root);
-		return;
-	}
-
-	let xPercent = 0.5;
-	let yPercent = 0.5;
-
-	if (
-		context?.pointerClientX !== undefined &&
-		context.pointerClientY !== undefined &&
-		typeof window !== "undefined"
-	) {
-		xPercent = clamp01(context.pointerClientX / window.innerWidth);
-		yPercent = clamp01(context.pointerClientY / window.innerHeight);
-	} else if (context?.element && typeof window !== "undefined") {
-		const rect = context.element.getBoundingClientRect();
-		if (rect.width > 0 && rect.height > 0) {
-			xPercent = clamp01((rect.left + rect.width / 2) / window.innerWidth);
-			yPercent = clamp01((rect.top + rect.height / 2) / window.innerHeight);
-		}
-	}
-
-	root.style.setProperty("--theme-switch-x", `${xPercent * 100}%`);
-	root.style.setProperty("--theme-switch-y", `${yPercent * 100}%`);
-	root.classList.add("theme-transition");
-
-	try {
-		const transition = startViewTransition?.(() => {
-			applyTheme();
-		});
-
-		if (!transition?.finished) {
-			cleanupThemeTransition(root);
-			return;
-		}
-
-		void transition.finished
-			.catch(() => undefined)
-			.finally(() => cleanupThemeTransition(root));
-	} catch {
-		cleanupThemeTransition(root);
-		applyTheme();
-	}
-}

package/src/lib/theme.tsx

@@ -1,165 +0,0 @@
-import {
-	createContext,
-	type ReactNode,
-	useContext,
-	useEffect,
-	useMemo,
-	useState,
-} from "react";
-
-export type ThemeValue = "system" | "light" | "dark";
-export type ResolvedTheme = "light" | "dark";
-
-const THEME_STORAGE_KEY = "birdclaw-theme";
-
-interface ThemeContextValue {
-	isReady: boolean;
-	theme: ThemeValue;
-	resolvedTheme: ResolvedTheme;
-	setTheme: (theme: ThemeValue) => void;
-}
-
-const ThemeContext = createContext<ThemeContextValue | null>(null);
-
-function getSystemTheme(): ResolvedTheme {
-	if (
-		typeof window === "undefined" ||
-		typeof window.matchMedia !== "function"
-	) {
-		return "light";
-	}
-	return window.matchMedia("(prefers-color-scheme: dark)").matches
-		? "dark"
-		: "light";
-}
-
-function resolveTheme(theme: ThemeValue): ResolvedTheme {
-	return theme === "system" ? getSystemTheme() : theme;
-}
-
-function applyThemeToDocument(theme: ThemeValue) {
-	if (typeof document === "undefined") return;
-
-	const resolvedTheme = resolveTheme(theme);
-	document.documentElement.dataset.themePreference = theme;
-	document.documentElement.dataset.theme = resolvedTheme;
-	document.documentElement.style.colorScheme = resolvedTheme;
-}
-
-function readInitialTheme(): ThemeValue {
-	if (typeof document !== "undefined") {
-		const value = document.documentElement.dataset.themePreference;
-		if (value === "light" || value === "dark" || value === "system") {
-			return value;
-		}
-	}
-
-	if (typeof window !== "undefined") {
-		const stored = window.localStorage.getItem(THEME_STORAGE_KEY);
-		if (stored === "light" || stored === "dark" || stored === "system") {
-			return stored;
-		}
-	}
-
-	return "system";
-}
-
-export const themeScript = `
-(() => {
-  const storageKey = "${THEME_STORAGE_KEY}";
-  const root = document.documentElement;
-  const stored = window.localStorage.getItem(storageKey);
-  const preference =
-    stored === "light" || stored === "dark" || stored === "system"
-      ? stored
-      : "system";
-  const resolved =
-    preference === "system"
-      ? window.matchMedia("(prefers-color-scheme: dark)").matches
-        ? "dark"
-        : "light"
-      : preference;
-  root.dataset.themePreference = preference;
-  root.dataset.theme = resolved;
-  root.style.colorScheme = resolved;
-})();
-`;
-
-export function ThemeProvider({ children }: { children: ReactNode }) {
-	const [theme, setThemeState] = useState<ThemeValue>("system");
-	const [resolvedTheme, setResolvedTheme] = useState<ResolvedTheme>("light");
-	const [isReady, setIsReady] = useState(false);
-
-	useEffect(() => {
-		const initialTheme = readInitialTheme();
-		setThemeState(initialTheme);
-		setResolvedTheme(resolveTheme(initialTheme));
-		applyThemeToDocument(initialTheme);
-		setIsReady(true);
-	}, []);
-
-	useEffect(() => {
-		if (!isReady) {
-			return;
-		}
-
-		applyThemeToDocument(theme);
-		setResolvedTheme(resolveTheme(theme));
-		window.localStorage.setItem(THEME_STORAGE_KEY, theme);
-
-		if (theme !== "system" || typeof window.matchMedia !== "function") {
-			return;
-		}
-
-		const media = window.matchMedia(
-			"(prefers-color-scheme: dark)",
-		) as unknown as {
-			matches: boolean;
-			addEventListener?: (type: "change", listener: () => void) => void;
-			removeEventListener?: (type: "change", listener: () => void) => void;
-			addListener?: (listener: () => void) => void;
-			removeListener?: (listener: () => void) => void;
-		};
-		const onChange = () => {
-			const nextResolvedTheme = media.matches ? "dark" : "light";
-			setResolvedTheme(nextResolvedTheme);
-			document.documentElement.dataset.theme = nextResolvedTheme;
-			document.documentElement.style.colorScheme = nextResolvedTheme;
-		};
-
-		if (typeof media.addEventListener === "function") {
-			media.addEventListener("change", onChange);
-		} else {
-			media.addListener?.(onChange);
-		}
-		return () => {
-			if (typeof media.removeEventListener === "function") {
-				media.removeEventListener("change", onChange);
-			} else {
-				media.removeListener?.(onChange);
-			}
-		};
-	}, [isReady, theme]);
-
-	const value = useMemo<ThemeContextValue>(
-		() => ({
-			isReady,
-			theme,
-			resolvedTheme,
-			setTheme: setThemeState,
-		}),
-		[isReady, resolvedTheme, theme],
-	);
-
-	return (
-		<ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>
-	);
-}
-
-export function useTheme() {
-	const context = useContext(ThemeContext);
-	if (!context) {
-		throw new Error("useTheme must be used within ThemeProvider");
-	}
-	return context;
-}

package/src/lib/timeline-collections-live.ts

@@ -1,407 +0,0 @@
-import type { Database } from "./sqlite";
-import { Effect } from "effect";
-import { getNativeDb } from "./db";
-import { runEffectPromise } from "./effect-runtime";
-import { liveTransportGateway } from "./live-transport-gateway";
-import {
-	createLiveTransportAdapter,
-	normalizeCacheTtlMs,
-	resolveLiveSyncAccount,
-	runCachedLiveSyncEffect,
-} from "./live-sync-engine";
-import type {
-	XurlMentionData,
-	XurlMentionsResponse,
-	XurlMediaItem,
-	XurlMentionUser,
-} from "./types";
-import { ingestTweetPayload } from "./tweet-repository";
-
-export type TimelineCollectionKind = "likes" | "bookmarks";
-export type TimelineCollectionMode = "auto" | "xurl" | "bird";
-export interface SyncTimelineCollectionOptions {
-	kind: TimelineCollectionKind;
-	account?: string;
-	mode?: TimelineCollectionMode;
-	limit?: number;
-	all?: boolean;
-	maxPages?: number;
-	refresh?: boolean;
-	cacheTtlMs?: number;
-	earlyStop?: boolean;
-}
-
-const DEFAULT_COLLECTION_CACHE_TTL_MS = 2 * 60_000;
-const DEFAULT_EARLY_STOP_MAX_PAGES = 10;
-const MIN_XURL_LIMIT = 5;
-const MAX_XURL_LIMIT = 100;
-
-function toError(error: unknown) {
-	return error instanceof Error ? error : new Error(String(error));
-}
-
-function trySync<T>(try_: () => T) {
-	return Effect.try({
-		try: try_,
-		catch: toError,
-	});
-}
-
-function parseMaxPages(value?: number) {
-	if (value === undefined) {
-		return null;
-	}
-	if (!Number.isFinite(value) || value < 1) {
-		throw new Error("--max-pages must be at least 1");
-	}
-	return Math.floor(value);
-}
-
-function assertLimit(limit: number) {
-	if (!Number.isFinite(limit) || limit < 1) {
-		throw new Error("--limit must be at least 1");
-	}
-}
-
-function assertXurlLimit(limit: number) {
-	if (limit < MIN_XURL_LIMIT || limit > MAX_XURL_LIMIT) {
-		throw new Error("xurl mode requires --limit between 5 and 100");
-	}
-}
-
-function mergePayloads(pages: XurlMentionsResponse[]): XurlMentionsResponse {
-	const tweets: XurlMentionData[] = [];
-	const seenTweetIds = new Set<string>();
-	const users: XurlMentionUser[] = [];
-	const seenUserIds = new Set<string>();
-	const media: XurlMediaItem[] = [];
-	const seenMediaKeys = new Set<string>();
-
-	for (const page of pages) {
-		for (const tweet of page.data) {
-			if (seenTweetIds.has(tweet.id)) {
-				continue;
-			}
-			seenTweetIds.add(tweet.id);
-			tweets.push(tweet);
-		}
-
-		for (const user of page.includes?.users ?? []) {
-			if (seenUserIds.has(user.id)) {
-				continue;
-			}
-			seenUserIds.add(user.id);
-			users.push(user);
-		}
-
-		for (const item of page.includes?.media ?? []) {
-			if (seenMediaKeys.has(item.media_key)) {
-				continue;
-			}
-			seenMediaKeys.add(item.media_key);
-			media.push(item);
-		}
-	}
-
-	const lastPage = pages.at(-1);
-	const includes = {
-		...(users.length > 0 ? { users } : {}),
-		...(media.length > 0 ? { media } : {}),
-	};
-	return {
-		data: tweets,
-		includes: users.length > 0 || media.length > 0 ? includes : undefined,
-		meta: {
-			result_count: tweets.length,
-			page_count: pages.length,
-			next_token: lastPage?.meta?.next_token ?? null,
-			...(tweets[0] ? { newest_id: tweets[0].id } : {}),
-			...(tweets.at(-1) ? { oldest_id: tweets.at(-1)?.id } : {}),
-		},
-	};
-}
-
-function getCollectionPageDedupe(
-	db: Database,
-	accountId: string,
-	kind: TimelineCollectionKind,
-	tweetIds: string[],
-) {
-	const uniqueTweetIds = [...new Set(tweetIds)];
-	if (uniqueTweetIds.length === 0) {
-		return { existingTweetIds: new Set<string>(), uniqueTweetCount: 0 };
-	}
-
-	const rows = db
-		.prepare(
-			`
-      select tweet_id
-      from tweet_collections
-      where account_id = ?
-        and kind = ?
-        and tweet_id in (${uniqueTweetIds.map(() => "?").join(", ")})
-      `,
-		)
-		.all(accountId, kind, ...uniqueTweetIds) as { tweet_id: string }[];
-	return {
-		existingTweetIds: new Set(rows.map((row) => row.tweet_id)),
-		uniqueTweetCount: uniqueTweetIds.length,
-	};
-}
-
-function filterExistingCollectionTweets(
-	payload: XurlMentionsResponse,
-	existingTweetIds: Set<string>,
-) {
-	if (existingTweetIds.size === 0) {
-		return payload;
-	}
-	return {
-		...payload,
-		data: payload.data.filter((tweet) => !existingTweetIds.has(tweet.id)),
-	};
-}
-
-function readSaturatedAtPage(payload: XurlMentionsResponse) {
-	const value = payload.meta?.saturated_at_page;
-	return typeof value === "number" ? value : undefined;
-}
-
-function mergeTimelineCollectionIntoLocalStore(
-	db: Database,
-	accountId: string,
-	kind: TimelineCollectionKind,
-	payload: XurlMentionsResponse,
-	source: "xurl" | "bird",
-) {
-	const tweetKind = kind === "likes" ? "like" : "bookmark";
-	ingestTweetPayload(db, {
-		accountId,
-		payload,
-		kind: tweetKind,
-		collectionKind: kind,
-		markRepliesAsReplied: true,
-		replaceSecondaryKind: true,
-		source,
-	});
-}
-
-function fetchXurlCollectionEffect({
-	db,
-	kind,
-	accountId,
-	username,
-	userId,
-	limit,
-	all,
-	maxPages,
-	earlyStop,
-}: {
-	db: Database;
-	kind: TimelineCollectionKind;
-	accountId: string;
-	username: string;
-	userId?: string;
-	limit: number;
-	all: boolean;
-	maxPages: number | null;
-	earlyStop: boolean;
-}) {
-	return Effect.gen(function* () {
-		let resolvedUserId = userId;
-		if (!resolvedUserId) {
-			const [accountUser] =
-				yield* liveTransportGateway.xurl.lookupUsersByHandles([username]);
-			if (!accountUser?.id) {
-				return yield* Effect.fail(
-					new Error(`Could not resolve Twitter user id for @${username}`),
-				);
-			}
-			resolvedUserId = String(accountUser.id);
-		}
-
-		const pages: XurlMentionsResponse[] = [];
-		let nextToken: string | undefined;
-		let pageCount = 0;
-		let saturatedAtPage: number | undefined;
-		do {
-			const payload = yield* kind === "likes"
-				? liveTransportGateway.xurl.listLikes({
-						maxResults: limit,
-						username,
-						userId: resolvedUserId,
-						paginationToken: nextToken,
-					})
-				: liveTransportGateway.xurl.listBookmarks({
-						maxResults: limit,
-						username,
-						userId: resolvedUserId,
-						isPaginatedWalk: all,
-						paginationToken: nextToken,
-					});
-			pageCount += 1;
-			if (earlyStop) {
-				const tweetIds = payload.data.map((tweet) => tweet.id);
-				const { existingTweetIds, uniqueTweetCount } = yield* trySync(() =>
-					getCollectionPageDedupe(db, accountId, kind, tweetIds),
-				);
-				if (tweetIds.length > 0 && existingTweetIds.size === uniqueTweetCount) {
-					saturatedAtPage = pageCount;
-					console.error(
-						`${kind} saturated at page ${pageCount} (100% existing rows)`,
-					);
-					break;
-				}
-				pages.push(filterExistingCollectionTweets(payload, existingTweetIds));
-			} else {
-				pages.push(payload);
-			}
-			nextToken =
-				typeof payload.meta?.next_token === "string"
-					? payload.meta.next_token
-					: undefined;
-		} while (
-			(all || earlyStop) &&
-			nextToken &&
-			(maxPages === null || pageCount < maxPages)
-		);
-
-		const merged = mergePayloads(pages);
-		// A saturated page may expose another token, but our walk is complete.
-		const saturationMeta =
-			saturatedAtPage === undefined
-				? {}
-				: { saturated_at_page: saturatedAtPage, next_token: null };
-		merged.meta = {
-			...merged.meta,
-			page_count: pageCount,
-			...saturationMeta,
-		};
-		return merged;
-	});
-}
-
-function fetchBirdCollectionEffect({
-	kind,
-	limit,
-	all,
-	maxPages,
-}: {
-	kind: TimelineCollectionKind;
-	limit: number;
-	all: boolean;
-	maxPages: number | null;
-}) {
-	return kind === "likes"
-		? liveTransportGateway.bird.listLikes({
-				maxResults: limit,
-				all,
-				maxPages: maxPages ?? undefined,
-			})
-		: liveTransportGateway.bird.listBookmarks({
-				maxResults: limit,
-				all,
-				maxPages: maxPages ?? undefined,
-			});
-}
-
-export function syncTimelineCollectionEffect({
-	kind,
-	account,
-	mode = "auto",
-	limit = 20,
-	all = false,
-	maxPages,
-	refresh = false,
-	cacheTtlMs,
-	earlyStop = false,
-}: SyncTimelineCollectionOptions) {
-	return Effect.gen(function* () {
-		yield* trySync(() => assertLimit(limit));
-		const parsedMaxPages = yield* trySync(() => parseMaxPages(maxPages));
-		const shouldApplyEarlyStopCap =
-			earlyStop && !all && parsedMaxPages === null && mode !== "bird";
-		const xurlMaxPages = shouldApplyEarlyStopCap
-			? DEFAULT_EARLY_STOP_MAX_PAGES
-			: parsedMaxPages;
-		if (mode === "xurl" || mode === "auto") {
-			yield* trySync(() => assertXurlLimit(limit));
-		}
-
-		const db = yield* trySync(() => getNativeDb());
-		const resolvedAccount = yield* trySync(() =>
-			resolveLiveSyncAccount(db, account),
-		);
-		const cacheMaxPages = mode === "bird" ? parsedMaxPages : xurlMaxPages;
-		const cacheKey = `${kind}:${mode}:${resolvedAccount.accountId}:${String(limit)}:${all ? "all" : "single"}:${cacheMaxPages === null ? "all-pages" : String(cacheMaxPages)}${earlyStop ? ":early-stop" : ""}`;
-
-		if (shouldApplyEarlyStopCap) {
-			console.error(
-				`${kind} early-stop capped at ${DEFAULT_EARLY_STOP_MAX_PAGES} pages by default; pass --max-pages or --all to override`,
-			);
-		}
-
-		const xurlFetch = fetchXurlCollectionEffect({
-			db,
-			kind,
-			accountId: resolvedAccount.accountId,
-			username: resolvedAccount.username,
-			userId: resolvedAccount.externalUserId,
-			limit,
-			all,
-			maxPages: xurlMaxPages,
-			earlyStop,
-		});
-		const birdFetch = fetchBirdCollectionEffect({
-			kind,
-			limit,
-			all,
-			maxPages: parsedMaxPages,
-		});
-		const transports =
-			mode === "bird"
-				? [createLiveTransportAdapter("bird", birdFetch)]
-				: mode === "xurl"
-					? [createLiveTransportAdapter("xurl", xurlFetch)]
-					: [
-							createLiveTransportAdapter("xurl", xurlFetch),
-							createLiveTransportAdapter("bird", birdFetch),
-						];
-		const syncResult = yield* runCachedLiveSyncEffect({
-			db,
-			cacheKey,
-			refresh,
-			cacheTtlMs: normalizeCacheTtlMs(
-				cacheTtlMs,
-				DEFAULT_COLLECTION_CACHE_TTL_MS,
-			),
-			transports,
-			persistLive: (writeDb, livePayload, liveSource) =>
-				mergeTimelineCollectionIntoLocalStore(
-					writeDb,
-					resolvedAccount.accountId,
-					kind,
-					livePayload,
-					liveSource,
-				),
-		});
-		const { source, payload } = syncResult;
-		const saturatedAtPage = readSaturatedAtPage(payload);
-
-		return {
-			ok: true,
-			source,
-			kind,
-			accountId: resolvedAccount.accountId,
-			count: payload.data.length,
-			payload,
-			...(saturatedAtPage === undefined
-				? {}
-				: { saturated_at_page: saturatedAtPage }),
-		};
-	});
-}
-
-export function syncTimelineCollection(options: SyncTimelineCollectionOptions) {
-	return runEffectPromise(syncTimelineCollectionEffect(options));
-}