birdclaw 0.1.0 → 0.2.0

package/src/lib/xurl.ts

@@ -3,6 +3,7 @@ import { promisify } from "node:util";
 import type {
 	TransportStatus,
 	XurlMentionsResponse,
+	XurlMentionUser,
 	XurlUserTweet,
 } from "./types";
 
@@ -131,7 +132,7 @@ export async function getTransportStatus(): Promise<TransportStatus> {
 		return transportStatusCache.pending;
 	}
 
-	const pending = (async () => {
+	const pending: Promise<TransportStatus> = (async () => {
 		const installed = await hasXurl();
 		if (!installed) {
 			return {
@@ -242,7 +243,7 @@ export async function lookupUsersByIds(ids: string[]) {
 	});
 	const payload = await runJsonCommand([`/2/users?${query.toString()}`]);
 	const data = payload.data;
-	return Array.isArray(data) ? (data as Array<Record<string, unknown>>) : [];
+	return Array.isArray(data) ? (data as XurlMentionUser[]) : [];
 }
 
 export async function lookupUsersByHandles(handles: string[]) {
@@ -257,7 +258,7 @@ export async function lookupUsersByHandles(handles: string[]) {
 	});
 	const payload = await runJsonCommand([`/2/users/by?${query.toString()}`]);
 	const data = payload.data;
-	return Array.isArray(data) ? (data as Array<Record<string, unknown>>) : [];
+	return Array.isArray(data) ? (data as XurlMentionUser[]) : [];
 }
 
 export async function lookupAuthenticatedUser() {
@@ -357,6 +358,91 @@ export async function listMentionsViaXurl({
 	};
 }
 
+async function listTimelineCollectionViaXurl({
+	collection,
+	maxResults,
+	username,
+	userId,
+	paginationToken,
+}: {
+	collection: "liked_tweets" | "bookmarks";
+	maxResults: number;
+	username?: string;
+	userId?: string;
+	paginationToken?: string;
+}): Promise<XurlMentionsResponse> {
+	let resolvedUserId = userId;
+	if (!resolvedUserId) {
+		if (username) {
+			const [user] = await lookupUsersByHandles([username]);
+			if (!user?.id) {
+				throw new Error(`Could not resolve X user id for @${username}`);
+			}
+			resolvedUserId = String(user.id);
+		} else {
+			const user = await lookupAuthenticatedUser();
+			if (!user?.id) {
+				throw new Error("Could not resolve authenticated X user id");
+			}
+			resolvedUserId = String(user.id);
+		}
+	}
+
+	const query = new URLSearchParams({
+		max_results: String(maxResults),
+		expansions: "author_id",
+		"tweet.fields": "created_at,conversation_id,entities,public_metrics",
+		"user.fields":
+			"description,public_metrics,profile_image_url,created_at,verified",
+	});
+	if (paginationToken) {
+		query.set("pagination_token", paginationToken);
+	}
+
+	const payload = await runJsonCommand([
+		"--auth",
+		"oauth2",
+		`/2/users/${resolvedUserId}/${collection}?${query.toString()}`,
+	]);
+	return {
+		data: Array.isArray(payload.data)
+			? (payload.data as XurlMentionsResponse["data"])
+			: [],
+		includes:
+			payload.includes && typeof payload.includes === "object"
+				? (payload.includes as XurlMentionsResponse["includes"])
+				: undefined,
+		meta:
+			payload.meta && typeof payload.meta === "object"
+				? (payload.meta as XurlMentionsResponse["meta"])
+				: undefined,
+	};
+}
+
+export async function listLikedTweetsViaXurl(options: {
+	maxResults: number;
+	username?: string;
+	userId?: string;
+	paginationToken?: string;
+}): Promise<XurlMentionsResponse> {
+	return listTimelineCollectionViaXurl({
+		...options,
+		collection: "liked_tweets",
+	});
+}
+
+export async function listBookmarkedTweetsViaXurl(options: {
+	maxResults: number;
+	username?: string;
+	userId?: string;
+	paginationToken?: string;
+}): Promise<XurlMentionsResponse> {
+	return listTimelineCollectionViaXurl({
+		...options,
+		collection: "bookmarks",
+	});
+}
+
 export async function listBlockedUsers(
 	userId: string,
 	paginationToken?: string,
@@ -373,7 +459,7 @@ export async function listBlockedUsers(
 		`/2/users/${userId}/blocking?${query}`,
 	]);
 	const data = Array.isArray(payload.data)
-		? (payload.data as Array<Record<string, unknown>>)
+		? (payload.data as XurlMentionUser[])
 		: [];
 	const meta =
 		payload.meta && typeof payload.meta === "object"

package/src/routeTree.gen.ts

@@ -10,8 +10,10 @@
 
 import { Route as rootRouteImport } from './routes/__root'
 import { Route as MentionsRouteImport } from './routes/mentions'
+import { Route as LikesRouteImport } from './routes/likes'
 import { Route as InboxRouteImport } from './routes/inbox'
 import { Route as DmsRouteImport } from './routes/dms'
+import { Route as BookmarksRouteImport } from './routes/bookmarks'
 import { Route as BlocksRouteImport } from './routes/blocks'
 import { Route as IndexRouteImport } from './routes/index'
 import { Route as ApiStatusRouteImport } from './routes/api/status'
@@ -26,6 +28,11 @@ const MentionsRoute = MentionsRouteImport.update({
   path: '/mentions',
   getParentRoute: () => rootRouteImport,
 } as any)
+const LikesRoute = LikesRouteImport.update({
+  id: '/likes',
+  path: '/likes',
+  getParentRoute: () => rootRouteImport,
+} as any)
 const InboxRoute = InboxRouteImport.update({
   id: '/inbox',
   path: '/inbox',
@@ -36,6 +43,11 @@ const DmsRoute = DmsRouteImport.update({
   path: '/dms',
   getParentRoute: () => rootRouteImport,
 } as any)
+const BookmarksRoute = BookmarksRouteImport.update({
+  id: '/bookmarks',
+  path: '/bookmarks',
+  getParentRoute: () => rootRouteImport,
+} as any)
 const BlocksRoute = BlocksRouteImport.update({
   id: '/blocks',
   path: '/blocks',
@@ -80,8 +92,10 @@ const ApiActionRoute = ApiActionRouteImport.update({
 export interface FileRoutesByFullPath {
   '/': typeof IndexRoute
   '/blocks': typeof BlocksRoute
+  '/bookmarks': typeof BookmarksRoute
   '/dms': typeof DmsRoute
   '/inbox': typeof InboxRoute
+  '/likes': typeof LikesRoute
   '/mentions': typeof MentionsRoute
   '/api/action': typeof ApiActionRoute
   '/api/avatar': typeof ApiAvatarRoute
@@ -93,8 +107,10 @@ export interface FileRoutesByFullPath {
 export interface FileRoutesByTo {
   '/': typeof IndexRoute
   '/blocks': typeof BlocksRoute
+  '/bookmarks': typeof BookmarksRoute
   '/dms': typeof DmsRoute
   '/inbox': typeof InboxRoute
+  '/likes': typeof LikesRoute
   '/mentions': typeof MentionsRoute
   '/api/action': typeof ApiActionRoute
   '/api/avatar': typeof ApiAvatarRoute
@@ -107,8 +123,10 @@ export interface FileRoutesById {
   __root__: typeof rootRouteImport
   '/': typeof IndexRoute
   '/blocks': typeof BlocksRoute
+  '/bookmarks': typeof BookmarksRoute
   '/dms': typeof DmsRoute
   '/inbox': typeof InboxRoute
+  '/likes': typeof LikesRoute
   '/mentions': typeof MentionsRoute
   '/api/action': typeof ApiActionRoute
   '/api/avatar': typeof ApiAvatarRoute
@@ -122,8 +140,10 @@ export interface FileRouteTypes {
   fullPaths:
     | '/'
     | '/blocks'
+    | '/bookmarks'
     | '/dms'
     | '/inbox'
+    | '/likes'
     | '/mentions'
     | '/api/action'
     | '/api/avatar'
@@ -135,8 +155,10 @@ export interface FileRouteTypes {
   to:
     | '/'
     | '/blocks'
+    | '/bookmarks'
     | '/dms'
     | '/inbox'
+    | '/likes'
     | '/mentions'
     | '/api/action'
     | '/api/avatar'
@@ -148,8 +170,10 @@ export interface FileRouteTypes {
     | '__root__'
     | '/'
     | '/blocks'
+    | '/bookmarks'
     | '/dms'
     | '/inbox'
+    | '/likes'
     | '/mentions'
     | '/api/action'
     | '/api/avatar'
@@ -162,8 +186,10 @@ export interface FileRouteTypes {
 export interface RootRouteChildren {
   IndexRoute: typeof IndexRoute
   BlocksRoute: typeof BlocksRoute
+  BookmarksRoute: typeof BookmarksRoute
   DmsRoute: typeof DmsRoute
   InboxRoute: typeof InboxRoute
+  LikesRoute: typeof LikesRoute
   MentionsRoute: typeof MentionsRoute
   ApiActionRoute: typeof ApiActionRoute
   ApiAvatarRoute: typeof ApiAvatarRoute
@@ -182,6 +208,13 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof MentionsRouteImport
       parentRoute: typeof rootRouteImport
     }
+    '/likes': {
+      id: '/likes'
+      path: '/likes'
+      fullPath: '/likes'
+      preLoaderRoute: typeof LikesRouteImport
+      parentRoute: typeof rootRouteImport
+    }
     '/inbox': {
       id: '/inbox'
       path: '/inbox'
@@ -196,6 +229,13 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof DmsRouteImport
       parentRoute: typeof rootRouteImport
     }
+    '/bookmarks': {
+      id: '/bookmarks'
+      path: '/bookmarks'
+      fullPath: '/bookmarks'
+      preLoaderRoute: typeof BookmarksRouteImport
+      parentRoute: typeof rootRouteImport
+    }
     '/blocks': {
       id: '/blocks'
       path: '/blocks'
@@ -258,8 +298,10 @@ declare module '@tanstack/react-router' {
 const rootRouteChildren: RootRouteChildren = {
   IndexRoute: IndexRoute,
   BlocksRoute: BlocksRoute,
+  BookmarksRoute: BookmarksRoute,
   DmsRoute: DmsRoute,
   InboxRoute: InboxRoute,
+  LikesRoute: LikesRoute,
   MentionsRoute: MentionsRoute,
   ApiActionRoute: ApiActionRoute,
   ApiAvatarRoute: ApiAvatarRoute,

package/src/routes/__root.tsx

@@ -4,7 +4,7 @@ import { TanStackRouterDevtoolsPanel } from "@tanstack/react-router-devtools";
 import type { ReactNode } from "react";
 import { AppNav } from "#/components/AppNav";
 import { ThemeProvider, themeScript } from "#/lib/theme";
-import { bodyClass, siteShellClass } from "#/lib/ui";
+import { bodyClass, pageWrapClass, siteShellClass } from "#/lib/ui";
 
 import appCss from "../styles.css?url";
 
@@ -29,9 +29,14 @@ export const Route = createRootRoute({
 			},
 		],
 	}),
+	notFoundComponent: NotFoundView,
 	shellComponent: RootDocument,
 });
 
+function NotFoundView() {
+	return <main className={pageWrapClass}>Not Found</main>;
+}
+
 function RootDocument({ children }: { children: ReactNode }) {
 	return (
 		<html lang="en" suppressHydrationWarning>

package/src/routes/api/action.tsx

@@ -3,13 +3,23 @@ import { addBlock, removeBlock, syncBlocks } from "#/lib/blocks";
 import { scoreInbox } from "#/lib/inbox";
 import { addMute, removeMute } from "#/lib/mutes";
 import { createDmReply, createPost, createTweetReply } from "#/lib/queries";
+import type { ActionsTransport } from "#/lib/config";
 import type { InboxKind } from "#/lib/types";
 
+function parseActionsTransport(
+	value: string | undefined,
+): ActionsTransport | undefined {
+	return value === "auto" || value === "bird" || value === "xurl"
+		? value
+		: undefined;
+}
+
 export const Route = createFileRoute("/api/action")({
 	server: {
 		handlers: {
 			POST: async ({ request }) => {
 				const body = (await request.json()) as Record<string, string>;
+				const transport = parseActionsTransport(body.transport);
 				let result: unknown;
 
 				if (body.kind === "post") {
@@ -38,7 +48,7 @@ export const Route = createFileRoute("/api/action")({
 						body.accountId || "acct_primary",
 						body.query || "",
 						{
-							transport: body.transport,
+							transport,
 						},
 					);
 				} else if (body.kind === "unblockProfile") {
@@ -46,7 +56,7 @@ export const Route = createFileRoute("/api/action")({
 						body.accountId || "acct_primary",
 						body.query || "",
 						{
-							transport: body.transport,
+							transport,
 						},
 					);
 				} else if (body.kind === "muteProfile") {
@@ -54,7 +64,7 @@ export const Route = createFileRoute("/api/action")({
 						body.accountId || "acct_primary",
 						body.query || "",
 						{
-							transport: body.transport,
+							transport,
 						},
 					);
 				} else if (body.kind === "unmuteProfile") {
@@ -62,7 +72,7 @@ export const Route = createFileRoute("/api/action")({
 						body.accountId || "acct_primary",
 						body.query || "",
 						{
-							transport: body.transport,
+							transport,
 						},
 					);
 				} else if (body.kind === "syncBlocks") {

package/src/routes/api/inbox.tsx

@@ -1,4 +1,5 @@
 import { createFileRoute } from "@tanstack/react-router";
+import { maybeAutoUpdateBackup } from "#/lib/backup";
 import { listInboxItems } from "#/lib/inbox";
 import type { InboxKind } from "#/lib/types";
 
@@ -11,7 +12,8 @@ function parseNumber(value: string | null) {
 export const Route = createFileRoute("/api/inbox")({
 	server: {
 		handlers: {
-			GET: ({ request }) => {
+			GET: async ({ request }) => {
+				await maybeAutoUpdateBackup();
 				const url = new URL(request.url);
 				const kind = (url.searchParams.get("kind") ?? "mixed") as InboxKind;
 				return new Response(

package/src/routes/api/query.tsx

@@ -1,6 +1,11 @@
 import { createFileRoute } from "@tanstack/react-router";
+import { maybeAutoUpdateBackup } from "#/lib/backup";
 import { queryResource } from "#/lib/queries";
-import type { ReplyFilter, ResourceKind } from "#/lib/types";
+import type {
+	ReplyFilter,
+	ResourceKind,
+	TimelineQualityFilter,
+} from "#/lib/types";
 
 function json(data: unknown) {
 	return new Response(JSON.stringify(data), {
@@ -23,10 +28,15 @@ function parseNumber(value: string | null) {
 	return Number.isFinite(parsed) ? parsed : undefined;
 }
 
+function parseQualityFilter(value: string | null): TimelineQualityFilter {
+	return value === "summary" ? "summary" : "all";
+}
+
 export const Route = createFileRoute("/api/query")({
 	server: {
 		handlers: {
-			GET: ({ request }) => {
+			GET: async ({ request }) => {
+				await maybeAutoUpdateBackup();
 				const url = new URL(request.url);
 				const resource = (url.searchParams.get("resource") ??
 					"home") as ResourceKind;
@@ -34,6 +44,14 @@ export const Route = createFileRoute("/api/query")({
 					account: url.searchParams.get("account") ?? undefined,
 					search: url.searchParams.get("search") ?? undefined,
 					replyFilter: parseReplyFilter(url.searchParams.get("replyFilter")),
+					since: url.searchParams.get("since") ?? undefined,
+					until: url.searchParams.get("until") ?? undefined,
+					includeReplies: url.searchParams.get("originalsOnly") !== "true",
+					qualityFilter: parseQualityFilter(
+						url.searchParams.get("qualityFilter"),
+					),
+					likedOnly: url.searchParams.get("liked") === "true",
+					bookmarkedOnly: url.searchParams.get("bookmarked") === "true",
 					limit: parseNumber(url.searchParams.get("limit")) ?? undefined,
 				};
 

package/src/routes/api/status.tsx

@@ -1,15 +1,18 @@
 import { createFileRoute } from "@tanstack/react-router";
+import { maybeAutoUpdateBackup } from "#/lib/backup";
 import { getQueryEnvelope } from "#/lib/queries";
 
 export const Route = createFileRoute("/api/status")({
 	server: {
 		handlers: {
-			GET: async () =>
-				new Response(JSON.stringify(await getQueryEnvelope()), {
+			GET: async () => {
+				await maybeAutoUpdateBackup();
+				return new Response(JSON.stringify(await getQueryEnvelope()), {
 					headers: {
 						"content-type": "application/json",
 					},
-				}),
+				});
+			},
 		},
 	},
 });

package/src/routes/bookmarks.tsx

@@ -0,0 +1,18 @@
+import { createFileRoute } from "@tanstack/react-router";
+import { SavedTimelineView } from "#/components/SavedTimelineView";
+
+export const Route = createFileRoute("/bookmarks")({
+	component: BookmarksRoute,
+});
+
+function BookmarksRoute() {
+	return (
+		<SavedTimelineView
+			eyebrow="bookmarks"
+			filter="bookmarked"
+			loadingLabel="Loading bookmarks..."
+			searchPlaceholder="Search bookmarks"
+			title="Saved threads, receipts, and future rabbit holes."
+		/>
+	);
+}

package/src/routes/likes.tsx

@@ -0,0 +1,18 @@
+import { createFileRoute } from "@tanstack/react-router";
+import { SavedTimelineView } from "#/components/SavedTimelineView";
+
+export const Route = createFileRoute("/likes")({
+	component: LikesRoute,
+});
+
+function LikesRoute() {
+	return (
+		<SavedTimelineView
+			eyebrow="liked posts"
+			filter="liked"
+			loadingLabel="Loading liked posts..."
+			searchPlaceholder="Search likes"
+			title="Things worth keeping in the orbit."
+		/>
+	);
+}

package/tsconfig.json

@@ -4,7 +4,6 @@
     "target": "ES2022",
     "jsx": "react-jsx",
     "module": "ESNext",
-    "baseUrl": ".",
     "ignoreDeprecations": "6.0",
     "paths": {
       "#/*": ["./src/*"],