birdclaw 0.4.1 → 0.5.0

package/src/routeTree.gen.ts

@@ -10,6 +10,7 @@
 
 import { Route as rootRouteImport } from './routes/__root'
 import { Route as MentionsRouteImport } from './routes/mentions'
+import { Route as LinksRouteImport } from './routes/links'
 import { Route as LikesRouteImport } from './routes/likes'
 import { Route as InboxRouteImport } from './routes/inbox'
 import { Route as DmsRouteImport } from './routes/dms'
@@ -18,7 +19,11 @@ import { Route as BlocksRouteImport } from './routes/blocks'
 import { Route as IndexRouteImport } from './routes/index'
 import { Route as ApiStatusRouteImport } from './routes/api/status'
 import { Route as ApiQueryRouteImport } from './routes/api/query'
+import { Route as ApiProfileHydrateRouteImport } from './routes/api/profile-hydrate'
+import { Route as ApiLinkPreviewRouteImport } from './routes/api/link-preview'
+import { Route as ApiLinkInsightsRouteImport } from './routes/api/link-insights'
 import { Route as ApiInboxRouteImport } from './routes/api/inbox'
+import { Route as ApiConversationRouteImport } from './routes/api/conversation'
 import { Route as ApiBlocksRouteImport } from './routes/api/blocks'
 import { Route as ApiAvatarRouteImport } from './routes/api/avatar'
 import { Route as ApiActionRouteImport } from './routes/api/action'
@@ -28,6 +33,11 @@ const MentionsRoute = MentionsRouteImport.update({
   path: '/mentions',
   getParentRoute: () => rootRouteImport,
 } as any)
+const LinksRoute = LinksRouteImport.update({
+  id: '/links',
+  path: '/links',
+  getParentRoute: () => rootRouteImport,
+} as any)
 const LikesRoute = LikesRouteImport.update({
   id: '/likes',
   path: '/likes',
@@ -68,11 +78,31 @@ const ApiQueryRoute = ApiQueryRouteImport.update({
   path: '/api/query',
   getParentRoute: () => rootRouteImport,
 } as any)
+const ApiProfileHydrateRoute = ApiProfileHydrateRouteImport.update({
+  id: '/api/profile-hydrate',
+  path: '/api/profile-hydrate',
+  getParentRoute: () => rootRouteImport,
+} as any)
+const ApiLinkPreviewRoute = ApiLinkPreviewRouteImport.update({
+  id: '/api/link-preview',
+  path: '/api/link-preview',
+  getParentRoute: () => rootRouteImport,
+} as any)
+const ApiLinkInsightsRoute = ApiLinkInsightsRouteImport.update({
+  id: '/api/link-insights',
+  path: '/api/link-insights',
+  getParentRoute: () => rootRouteImport,
+} as any)
 const ApiInboxRoute = ApiInboxRouteImport.update({
   id: '/api/inbox',
   path: '/api/inbox',
   getParentRoute: () => rootRouteImport,
 } as any)
+const ApiConversationRoute = ApiConversationRouteImport.update({
+  id: '/api/conversation',
+  path: '/api/conversation',
+  getParentRoute: () => rootRouteImport,
+} as any)
 const ApiBlocksRoute = ApiBlocksRouteImport.update({
   id: '/api/blocks',
   path: '/api/blocks',
@@ -96,11 +126,16 @@ export interface FileRoutesByFullPath {
   '/dms': typeof DmsRoute
   '/inbox': typeof InboxRoute
   '/likes': typeof LikesRoute
+  '/links': typeof LinksRoute
   '/mentions': typeof MentionsRoute
   '/api/action': typeof ApiActionRoute
   '/api/avatar': typeof ApiAvatarRoute
   '/api/blocks': typeof ApiBlocksRoute
+  '/api/conversation': typeof ApiConversationRoute
   '/api/inbox': typeof ApiInboxRoute
+  '/api/link-insights': typeof ApiLinkInsightsRoute
+  '/api/link-preview': typeof ApiLinkPreviewRoute
+  '/api/profile-hydrate': typeof ApiProfileHydrateRoute
   '/api/query': typeof ApiQueryRoute
   '/api/status': typeof ApiStatusRoute
 }
@@ -111,11 +146,16 @@ export interface FileRoutesByTo {
   '/dms': typeof DmsRoute
   '/inbox': typeof InboxRoute
   '/likes': typeof LikesRoute
+  '/links': typeof LinksRoute
   '/mentions': typeof MentionsRoute
   '/api/action': typeof ApiActionRoute
   '/api/avatar': typeof ApiAvatarRoute
   '/api/blocks': typeof ApiBlocksRoute
+  '/api/conversation': typeof ApiConversationRoute
   '/api/inbox': typeof ApiInboxRoute
+  '/api/link-insights': typeof ApiLinkInsightsRoute
+  '/api/link-preview': typeof ApiLinkPreviewRoute
+  '/api/profile-hydrate': typeof ApiProfileHydrateRoute
   '/api/query': typeof ApiQueryRoute
   '/api/status': typeof ApiStatusRoute
 }
@@ -127,11 +167,16 @@ export interface FileRoutesById {
   '/dms': typeof DmsRoute
   '/inbox': typeof InboxRoute
   '/likes': typeof LikesRoute
+  '/links': typeof LinksRoute
   '/mentions': typeof MentionsRoute
   '/api/action': typeof ApiActionRoute
   '/api/avatar': typeof ApiAvatarRoute
   '/api/blocks': typeof ApiBlocksRoute
+  '/api/conversation': typeof ApiConversationRoute
   '/api/inbox': typeof ApiInboxRoute
+  '/api/link-insights': typeof ApiLinkInsightsRoute
+  '/api/link-preview': typeof ApiLinkPreviewRoute
+  '/api/profile-hydrate': typeof ApiProfileHydrateRoute
   '/api/query': typeof ApiQueryRoute
   '/api/status': typeof ApiStatusRoute
 }
@@ -144,11 +189,16 @@ export interface FileRouteTypes {
     | '/dms'
     | '/inbox'
     | '/likes'
+    | '/links'
     | '/mentions'
     | '/api/action'
     | '/api/avatar'
     | '/api/blocks'
+    | '/api/conversation'
     | '/api/inbox'
+    | '/api/link-insights'
+    | '/api/link-preview'
+    | '/api/profile-hydrate'
     | '/api/query'
     | '/api/status'
   fileRoutesByTo: FileRoutesByTo
@@ -159,11 +209,16 @@ export interface FileRouteTypes {
     | '/dms'
     | '/inbox'
     | '/likes'
+    | '/links'
     | '/mentions'
     | '/api/action'
     | '/api/avatar'
     | '/api/blocks'
+    | '/api/conversation'
     | '/api/inbox'
+    | '/api/link-insights'
+    | '/api/link-preview'
+    | '/api/profile-hydrate'
     | '/api/query'
     | '/api/status'
   id:
@@ -174,11 +229,16 @@ export interface FileRouteTypes {
     | '/dms'
     | '/inbox'
     | '/likes'
+    | '/links'
     | '/mentions'
     | '/api/action'
     | '/api/avatar'
     | '/api/blocks'
+    | '/api/conversation'
     | '/api/inbox'
+    | '/api/link-insights'
+    | '/api/link-preview'
+    | '/api/profile-hydrate'
     | '/api/query'
     | '/api/status'
   fileRoutesById: FileRoutesById
@@ -190,11 +250,16 @@ export interface RootRouteChildren {
   DmsRoute: typeof DmsRoute
   InboxRoute: typeof InboxRoute
   LikesRoute: typeof LikesRoute
+  LinksRoute: typeof LinksRoute
   MentionsRoute: typeof MentionsRoute
   ApiActionRoute: typeof ApiActionRoute
   ApiAvatarRoute: typeof ApiAvatarRoute
   ApiBlocksRoute: typeof ApiBlocksRoute
+  ApiConversationRoute: typeof ApiConversationRoute
   ApiInboxRoute: typeof ApiInboxRoute
+  ApiLinkInsightsRoute: typeof ApiLinkInsightsRoute
+  ApiLinkPreviewRoute: typeof ApiLinkPreviewRoute
+  ApiProfileHydrateRoute: typeof ApiProfileHydrateRoute
   ApiQueryRoute: typeof ApiQueryRoute
   ApiStatusRoute: typeof ApiStatusRoute
 }
@@ -208,6 +273,13 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof MentionsRouteImport
       parentRoute: typeof rootRouteImport
     }
+    '/links': {
+      id: '/links'
+      path: '/links'
+      fullPath: '/links'
+      preLoaderRoute: typeof LinksRouteImport
+      parentRoute: typeof rootRouteImport
+    }
     '/likes': {
       id: '/likes'
       path: '/likes'
@@ -264,6 +336,27 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof ApiQueryRouteImport
       parentRoute: typeof rootRouteImport
     }
+    '/api/profile-hydrate': {
+      id: '/api/profile-hydrate'
+      path: '/api/profile-hydrate'
+      fullPath: '/api/profile-hydrate'
+      preLoaderRoute: typeof ApiProfileHydrateRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+    '/api/link-preview': {
+      id: '/api/link-preview'
+      path: '/api/link-preview'
+      fullPath: '/api/link-preview'
+      preLoaderRoute: typeof ApiLinkPreviewRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+    '/api/link-insights': {
+      id: '/api/link-insights'
+      path: '/api/link-insights'
+      fullPath: '/api/link-insights'
+      preLoaderRoute: typeof ApiLinkInsightsRouteImport
+      parentRoute: typeof rootRouteImport
+    }
     '/api/inbox': {
       id: '/api/inbox'
       path: '/api/inbox'
@@ -271,6 +364,13 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof ApiInboxRouteImport
       parentRoute: typeof rootRouteImport
     }
+    '/api/conversation': {
+      id: '/api/conversation'
+      path: '/api/conversation'
+      fullPath: '/api/conversation'
+      preLoaderRoute: typeof ApiConversationRouteImport
+      parentRoute: typeof rootRouteImport
+    }
     '/api/blocks': {
       id: '/api/blocks'
       path: '/api/blocks'
@@ -302,11 +402,16 @@ const rootRouteChildren: RootRouteChildren = {
   DmsRoute: DmsRoute,
   InboxRoute: InboxRoute,
   LikesRoute: LikesRoute,
+  LinksRoute: LinksRoute,
   MentionsRoute: MentionsRoute,
   ApiActionRoute: ApiActionRoute,
   ApiAvatarRoute: ApiAvatarRoute,
   ApiBlocksRoute: ApiBlocksRoute,
+  ApiConversationRoute: ApiConversationRoute,
   ApiInboxRoute: ApiInboxRoute,
+  ApiLinkInsightsRoute: ApiLinkInsightsRoute,
+  ApiLinkPreviewRoute: ApiLinkPreviewRoute,
+  ApiProfileHydrateRoute: ApiProfileHydrateRoute,
   ApiQueryRoute: ApiQueryRoute,
   ApiStatusRoute: ApiStatusRoute,
 }

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, pageWrapClass, siteShellClass } from "#/lib/ui";
+import { bodyClass, mainColumnClass, siteShellClass } from "#/lib/ui";
 
 import appCss from "../styles.css?url";
 
@@ -34,7 +34,11 @@ export const Route = createRootRoute({
 });
 
 function NotFoundView() {
-	return <main className={pageWrapClass}>Not Found</main>;
+	return (
+		<main className={mainColumnClass}>
+			<div className="px-4 py-10 text-[var(--ink-soft)]">Not Found</div>
+		</main>
+	);
 }
 
 function RootDocument({ children }: { children: ReactNode }) {
@@ -48,7 +52,7 @@ function RootDocument({ children }: { children: ReactNode }) {
 				<ThemeProvider>
 					<div className={siteShellClass}>
 						<AppNav />
-						{children}
+						<main className={mainColumnClass}>{children}</main>
 					</div>
 				</ThemeProvider>
 				<TanStackDevtools

package/src/routes/api/conversation.tsx

@@ -0,0 +1,34 @@
+import { createFileRoute } from "@tanstack/react-router";
+import { maybeAutoUpdateBackup } from "#/lib/backup";
+import { getTweetConversation } from "#/lib/queries";
+
+function json(data: unknown, status = 200) {
+	return new Response(JSON.stringify(data), {
+		status,
+		headers: {
+			"content-type": "application/json",
+		},
+	});
+}
+
+export const Route = createFileRoute("/api/conversation")({
+	server: {
+		handlers: {
+			GET: async ({ request }) => {
+				await maybeAutoUpdateBackup();
+				const url = new URL(request.url);
+				const tweetId = url.searchParams.get("tweetId")?.trim();
+				if (!tweetId) {
+					return json({ ok: false, error: "Missing tweetId" }, 400);
+				}
+
+				const conversation = getTweetConversation(tweetId);
+				if (!conversation) {
+					return json({ ok: false, error: "Tweet not found" }, 404);
+				}
+
+				return json({ ok: true, ...conversation });
+			},
+		},
+	},
+});

package/src/routes/api/link-insights.tsx

@@ -0,0 +1,79 @@
+import { createFileRoute } from "@tanstack/react-router";
+import { maybeAutoUpdateBackup } from "#/lib/backup";
+import { getNativeDb } from "#/lib/db";
+import { getLinkInsights } from "#/lib/link-insights";
+import type {
+	LinkInsightKind,
+	LinkInsightRange,
+	LinkInsightSort,
+	LinkInsightSource,
+} from "#/lib/types";
+
+function json(data: unknown) {
+	return new Response(JSON.stringify(data), {
+		headers: {
+			"content-type": "application/json",
+		},
+	});
+}
+
+function parseKind(value: string | null): LinkInsightKind {
+	return value === "videos" ? "videos" : "links";
+}
+
+function parseRange(value: string | null): LinkInsightRange {
+	if (
+		value === "today" ||
+		value === "week" ||
+		value === "month" ||
+		value === "year" ||
+		value === "all"
+	) {
+		return value;
+	}
+	return "week";
+}
+
+function parseSource(value: string | null): LinkInsightSource {
+	if (value === "tweet" || value === "dm") {
+		return value;
+	}
+	return "all";
+}
+
+function parseSort(value: string | null): LinkInsightSort {
+	if (value === "recent" || value === "comments") {
+		return value;
+	}
+	return "rank";
+}
+
+function parseNumber(value: string | null) {
+	if (!value) return undefined;
+	const parsed = Number(value);
+	return Number.isFinite(parsed) ? parsed : undefined;
+}
+
+export const Route = createFileRoute("/api/link-insights")({
+	server: {
+		handlers: {
+			GET: async ({ request }) => {
+				await maybeAutoUpdateBackup();
+				getNativeDb();
+				const url = new URL(request.url);
+				return json(
+					getLinkInsights({
+						kind: parseKind(url.searchParams.get("kind")),
+						range: parseRange(url.searchParams.get("range")),
+						sort: parseSort(url.searchParams.get("sort")),
+						source: parseSource(url.searchParams.get("source")),
+						since: url.searchParams.get("since") ?? undefined,
+						until: url.searchParams.get("until") ?? undefined,
+						limit: parseNumber(url.searchParams.get("limit")),
+						commentsLimit: parseNumber(url.searchParams.get("commentsLimit")),
+					}),
+				);
+			},
+		},
+	},
+});

package/src/routes/api/link-preview.tsx

@@ -0,0 +1,43 @@
+import { createFileRoute } from "@tanstack/react-router";
+import { getOrFetchLinkPreview } from "#/lib/link-preview-metadata";
+
+function json(data: unknown, init?: ResponseInit) {
+	return new Response(JSON.stringify(data), {
+		...init,
+		headers: {
+			"content-type": "application/json",
+			...init?.headers,
+		},
+	});
+}
+
+function parseUrl(value: string | null) {
+	if (!value) return null;
+	try {
+		const parsed = new URL(value);
+		if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+			return null;
+		}
+		return parsed.toString();
+	} catch {
+		return null;
+	}
+}
+
+export const Route = createFileRoute("/api/link-preview")({
+	server: {
+		handlers: {
+			GET: async ({ request }) => {
+				const url = new URL(request.url);
+				const previewUrl = parseUrl(url.searchParams.get("url"));
+				const shortUrl = parseUrl(url.searchParams.get("shortUrl"));
+				if (!previewUrl) {
+					return json({ ok: false, message: "Missing url" }, { status: 400 });
+				}
+
+				const preview = await getOrFetchLinkPreview(previewUrl, { shortUrl });
+				return json({ ok: true, preview });
+			},
+		},
+	},
+});

package/src/routes/api/profile-hydrate.tsx

@@ -0,0 +1,51 @@
+import { createFileRoute } from "@tanstack/react-router";
+import { resolveProfilesForHandles } from "#/lib/profile-resolver";
+
+function json(data: unknown, init?: ResponseInit) {
+	return new Response(JSON.stringify(data), {
+		...init,
+		headers: {
+			"content-type": "application/json",
+			...init?.headers,
+		},
+	});
+}
+
+function parseHandles(url: URL) {
+	const rawValues = [
+		...url.searchParams.getAll("handle"),
+		...(url.searchParams.get("handles")?.split(",") ?? []),
+	];
+	return Array.from(
+		new Set(
+			rawValues
+				.map((value) => value.trim().replace(/^@/, ""))
+				.filter((value) => /^[A-Za-z0-9_]{1,15}$/.test(value)),
+		),
+	).slice(0, 50);
+}
+
+export const Route = createFileRoute("/api/profile-hydrate")({
+	server: {
+		handlers: {
+			GET: async ({ request }) => {
+				const url = new URL(request.url);
+				const handles = parseHandles(url);
+				if (handles.length === 0) {
+					return json(
+						{ ok: false, message: "Missing handles" },
+						{ status: 400 },
+					);
+				}
+
+				const results = await resolveProfilesForHandles(handles);
+				return json({
+					ok: true,
+					results,
+					hydratedProfiles: results.filter((result) => result.status === "hit")
+						.length,
+				});
+			},
+		},
+	},
+});