birdclaw 0.5.1 → 0.6.0

package/src/routeTree.gen.ts

@@ -9,6 +9,7 @@
 // Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified.
 
 import { Route as rootRouteImport } from './routes/__root'
+import { Route as TodayRouteImport } from './routes/today'
 import { Route as MentionsRouteImport } from './routes/mentions'
 import { Route as LinksRouteImport } from './routes/links'
 import { Route as LikesRouteImport } from './routes/likes'
@@ -21,6 +22,7 @@ import { Route as ApiSyncRouteImport } from './routes/api/sync'
 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 ApiPeriodDigestRouteImport } from './routes/api/period-digest'
 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'
@@ -29,6 +31,11 @@ import { Route as ApiBlocksRouteImport } from './routes/api/blocks'
 import { Route as ApiAvatarRouteImport } from './routes/api/avatar'
 import { Route as ApiActionRouteImport } from './routes/api/action'
 
+const TodayRoute = TodayRouteImport.update({
+  id: '/today',
+  path: '/today',
+  getParentRoute: () => rootRouteImport,
+} as any)
 const MentionsRoute = MentionsRouteImport.update({
   id: '/mentions',
   path: '/mentions',
@@ -89,6 +96,11 @@ const ApiProfileHydrateRoute = ApiProfileHydrateRouteImport.update({
   path: '/api/profile-hydrate',
   getParentRoute: () => rootRouteImport,
 } as any)
+const ApiPeriodDigestRoute = ApiPeriodDigestRouteImport.update({
+  id: '/api/period-digest',
+  path: '/api/period-digest',
+  getParentRoute: () => rootRouteImport,
+} as any)
 const ApiLinkPreviewRoute = ApiLinkPreviewRouteImport.update({
   id: '/api/link-preview',
   path: '/api/link-preview',
@@ -134,6 +146,7 @@ export interface FileRoutesByFullPath {
   '/likes': typeof LikesRoute
   '/links': typeof LinksRoute
   '/mentions': typeof MentionsRoute
+  '/today': typeof TodayRoute
   '/api/action': typeof ApiActionRoute
   '/api/avatar': typeof ApiAvatarRoute
   '/api/blocks': typeof ApiBlocksRoute
@@ -141,6 +154,7 @@ export interface FileRoutesByFullPath {
   '/api/inbox': typeof ApiInboxRoute
   '/api/link-insights': typeof ApiLinkInsightsRoute
   '/api/link-preview': typeof ApiLinkPreviewRoute
+  '/api/period-digest': typeof ApiPeriodDigestRoute
   '/api/profile-hydrate': typeof ApiProfileHydrateRoute
   '/api/query': typeof ApiQueryRoute
   '/api/status': typeof ApiStatusRoute
@@ -155,6 +169,7 @@ export interface FileRoutesByTo {
   '/likes': typeof LikesRoute
   '/links': typeof LinksRoute
   '/mentions': typeof MentionsRoute
+  '/today': typeof TodayRoute
   '/api/action': typeof ApiActionRoute
   '/api/avatar': typeof ApiAvatarRoute
   '/api/blocks': typeof ApiBlocksRoute
@@ -162,6 +177,7 @@ export interface FileRoutesByTo {
   '/api/inbox': typeof ApiInboxRoute
   '/api/link-insights': typeof ApiLinkInsightsRoute
   '/api/link-preview': typeof ApiLinkPreviewRoute
+  '/api/period-digest': typeof ApiPeriodDigestRoute
   '/api/profile-hydrate': typeof ApiProfileHydrateRoute
   '/api/query': typeof ApiQueryRoute
   '/api/status': typeof ApiStatusRoute
@@ -177,6 +193,7 @@ export interface FileRoutesById {
   '/likes': typeof LikesRoute
   '/links': typeof LinksRoute
   '/mentions': typeof MentionsRoute
+  '/today': typeof TodayRoute
   '/api/action': typeof ApiActionRoute
   '/api/avatar': typeof ApiAvatarRoute
   '/api/blocks': typeof ApiBlocksRoute
@@ -184,6 +201,7 @@ export interface FileRoutesById {
   '/api/inbox': typeof ApiInboxRoute
   '/api/link-insights': typeof ApiLinkInsightsRoute
   '/api/link-preview': typeof ApiLinkPreviewRoute
+  '/api/period-digest': typeof ApiPeriodDigestRoute
   '/api/profile-hydrate': typeof ApiProfileHydrateRoute
   '/api/query': typeof ApiQueryRoute
   '/api/status': typeof ApiStatusRoute
@@ -200,6 +218,7 @@ export interface FileRouteTypes {
     | '/likes'
     | '/links'
     | '/mentions'
+    | '/today'
     | '/api/action'
     | '/api/avatar'
     | '/api/blocks'
@@ -207,6 +226,7 @@ export interface FileRouteTypes {
     | '/api/inbox'
     | '/api/link-insights'
     | '/api/link-preview'
+    | '/api/period-digest'
     | '/api/profile-hydrate'
     | '/api/query'
     | '/api/status'
@@ -221,6 +241,7 @@ export interface FileRouteTypes {
     | '/likes'
     | '/links'
     | '/mentions'
+    | '/today'
     | '/api/action'
     | '/api/avatar'
     | '/api/blocks'
@@ -228,6 +249,7 @@ export interface FileRouteTypes {
     | '/api/inbox'
     | '/api/link-insights'
     | '/api/link-preview'
+    | '/api/period-digest'
     | '/api/profile-hydrate'
     | '/api/query'
     | '/api/status'
@@ -242,6 +264,7 @@ export interface FileRouteTypes {
     | '/likes'
     | '/links'
     | '/mentions'
+    | '/today'
     | '/api/action'
     | '/api/avatar'
     | '/api/blocks'
@@ -249,6 +272,7 @@ export interface FileRouteTypes {
     | '/api/inbox'
     | '/api/link-insights'
     | '/api/link-preview'
+    | '/api/period-digest'
     | '/api/profile-hydrate'
     | '/api/query'
     | '/api/status'
@@ -264,6 +288,7 @@ export interface RootRouteChildren {
   LikesRoute: typeof LikesRoute
   LinksRoute: typeof LinksRoute
   MentionsRoute: typeof MentionsRoute
+  TodayRoute: typeof TodayRoute
   ApiActionRoute: typeof ApiActionRoute
   ApiAvatarRoute: typeof ApiAvatarRoute
   ApiBlocksRoute: typeof ApiBlocksRoute
@@ -271,6 +296,7 @@ export interface RootRouteChildren {
   ApiInboxRoute: typeof ApiInboxRoute
   ApiLinkInsightsRoute: typeof ApiLinkInsightsRoute
   ApiLinkPreviewRoute: typeof ApiLinkPreviewRoute
+  ApiPeriodDigestRoute: typeof ApiPeriodDigestRoute
   ApiProfileHydrateRoute: typeof ApiProfileHydrateRoute
   ApiQueryRoute: typeof ApiQueryRoute
   ApiStatusRoute: typeof ApiStatusRoute
@@ -279,6 +305,13 @@ export interface RootRouteChildren {
 
 declare module '@tanstack/react-router' {
   interface FileRoutesByPath {
+    '/today': {
+      id: '/today'
+      path: '/today'
+      fullPath: '/today'
+      preLoaderRoute: typeof TodayRouteImport
+      parentRoute: typeof rootRouteImport
+    }
     '/mentions': {
       id: '/mentions'
       path: '/mentions'
@@ -363,6 +396,13 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof ApiProfileHydrateRouteImport
       parentRoute: typeof rootRouteImport
     }
+    '/api/period-digest': {
+      id: '/api/period-digest'
+      path: '/api/period-digest'
+      fullPath: '/api/period-digest'
+      preLoaderRoute: typeof ApiPeriodDigestRouteImport
+      parentRoute: typeof rootRouteImport
+    }
     '/api/link-preview': {
       id: '/api/link-preview'
       path: '/api/link-preview'
@@ -424,6 +464,7 @@ const rootRouteChildren: RootRouteChildren = {
   LikesRoute: LikesRoute,
   LinksRoute: LinksRoute,
   MentionsRoute: MentionsRoute,
+  TodayRoute: TodayRoute,
   ApiActionRoute: ApiActionRoute,
   ApiAvatarRoute: ApiAvatarRoute,
   ApiBlocksRoute: ApiBlocksRoute,
@@ -431,6 +472,7 @@ const rootRouteChildren: RootRouteChildren = {
   ApiInboxRoute: ApiInboxRoute,
   ApiLinkInsightsRoute: ApiLinkInsightsRoute,
   ApiLinkPreviewRoute: ApiLinkPreviewRoute,
+  ApiPeriodDigestRoute: ApiPeriodDigestRoute,
   ApiProfileHydrateRoute: ApiProfileHydrateRoute,
   ApiQueryRoute: ApiQueryRoute,
   ApiStatusRoute: ApiStatusRoute,

package/src/routes/__root.tsx

@@ -1,10 +1,21 @@
 import { TanStackDevtools } from "@tanstack/react-devtools";
-import { createRootRoute, HeadContent, Scripts } from "@tanstack/react-router";
+import {
+	createRootRoute,
+	HeadContent,
+	Scripts,
+	useRouterState,
+} from "@tanstack/react-router";
 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, mainColumnClass, siteShellClass } from "#/lib/ui";
+import {
+	bodyClass,
+	mainColumnClass,
+	mainColumnDmClass,
+	siteShellClass,
+	siteShellDmClass,
+} from "#/lib/ui";
 
 import appCss from "../styles.css?url";
 
@@ -42,6 +53,11 @@ function NotFoundView() {
 }
 
 function RootDocument({ children }: { children: ReactNode }) {
+	const pathname = useRouterState({
+		select: (state) => state.location.pathname,
+	});
+	const messagesMode = pathname.startsWith("/dms");
+
 	return (
 		<html lang="en" suppressHydrationWarning>
 			<head>
@@ -50,9 +66,13 @@ function RootDocument({ children }: { children: ReactNode }) {
 			</head>
 			<body className={bodyClass}>
 				<ThemeProvider>
-					<div className={siteShellClass}>
-						<AppNav />
-						<main className={mainColumnClass}>{children}</main>
+					<div className={messagesMode ? siteShellDmClass : siteShellClass}>
+						<AppNav compact={messagesMode} />
+						<main
+							className={messagesMode ? mainColumnDmClass : mainColumnClass}
+						>
+							{children}
+						</main>
 					</div>
 				</ThemeProvider>
 				<TanStackDevtools

package/src/routes/api/action.tsx

@@ -1,8 +1,24 @@
 import { createFileRoute } from "@tanstack/react-router";
-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 { Effect } from "effect";
+import {
+	addBlockEffect,
+	removeBlockEffect,
+	syncBlocksEffect,
+} from "#/lib/blocks";
+import {
+	jsonResponse,
+	parseBoundedInteger,
+	requestJsonEffect,
+	runRouteEffect,
+	sensitiveRequestErrorResponse,
+} from "#/lib/http-effect";
+import { scoreInboxEffect } from "#/lib/inbox";
+import { addMuteEffect, removeMuteEffect } from "#/lib/mutes";
+import {
+	createDmReplyEffect,
+	createPostEffect,
+	createTweetReplyEffect,
+} from "#/lib/queries";
 import type { ActionsTransport } from "#/lib/config";
 import type { InboxKind } from "#/lib/types";
 
@@ -14,85 +30,118 @@ function parseActionsTransport(
 		: undefined;
 }
 
+function actionErrorMessage(error: unknown) {
+	if (
+		typeof error === "object" &&
+		error !== null &&
+		"cause" in error &&
+		error.cause instanceof Error
+	) {
+		return error.cause.message;
+	}
+	if (error instanceof Error) {
+		return error.message;
+	}
+	return String(error);
+}
+
 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;
+			POST: ({ request }) =>
+				runRouteEffect(
+					Effect.gen(function* () {
+						const denied = sensitiveRequestErrorResponse(request);
+						if (denied) return denied;
+
+						const body =
+							yield* requestJsonEffect<Record<string, string>>(request);
+						const transport = parseActionsTransport(body.transport);
+						let result: unknown;
 
-				if (body.kind === "post") {
-					result = await createPost(
-						body.accountId || "acct_primary",
-						body.text || "",
-					);
-				} else if (body.kind === "replyTweet") {
-					result = await createTweetReply(
-						body.accountId || "acct_primary",
-						body.tweetId || "",
-						body.text || "",
-					);
-				} else if (body.kind === "replyDm") {
-					result = await createDmReply(
-						body.conversationId || "",
-						body.text || "",
-					);
-				} else if (body.kind === "scoreInbox") {
-					result = await scoreInbox({
-						kind: ((body.scoreKind as InboxKind) || "mixed") as InboxKind,
-						limit: body.limit ? Number(body.limit) : 8,
-					});
-				} else if (body.kind === "blockProfile") {
-					result = await addBlock(
-						body.accountId || "acct_primary",
-						body.query || "",
-						{
-							transport,
-						},
-					);
-				} else if (body.kind === "unblockProfile") {
-					result = await removeBlock(
-						body.accountId || "acct_primary",
-						body.query || "",
-						{
-							transport,
-						},
-					);
-				} else if (body.kind === "muteProfile") {
-					result = await addMute(
-						body.accountId || "acct_primary",
-						body.query || "",
-						{
-							transport,
-						},
-					);
-				} else if (body.kind === "unmuteProfile") {
-					result = await removeMute(
-						body.accountId || "acct_primary",
-						body.query || "",
-						{
-							transport,
-						},
-					);
-				} else if (body.kind === "syncBlocks") {
-					result = await syncBlocks(body.accountId || "acct_primary");
-				} else {
-					return new Response(
-						JSON.stringify({ ok: false, message: "Unknown action kind" }),
-						{
-							status: 400,
-							headers: { "content-type": "application/json" },
-						},
-					);
-				}
+						if (body.kind === "post") {
+							result = yield* createPostEffect(
+								body.accountId || "acct_primary",
+								body.text || "",
+							);
+						} else if (body.kind === "replyTweet") {
+							result = yield* createTweetReplyEffect(
+								body.accountId || "acct_primary",
+								body.tweetId || "",
+								body.text || "",
+							);
+						} else if (body.kind === "replyDm") {
+							result = yield* createDmReplyEffect(
+								body.conversationId || "",
+								body.text || "",
+							);
+						} else if (body.kind === "scoreInbox") {
+							result = yield* scoreInboxEffect({
+								kind: ((body.scoreKind as InboxKind) || "mixed") as InboxKind,
+								account: body.account,
+								limit: parseBoundedInteger(body.limit, {
+									defaultValue: 8,
+									max: 20,
+								}),
+							});
+						} else if (body.kind === "blockProfile") {
+							result = yield* addBlockEffect(
+								body.accountId || "acct_primary",
+								body.query || "",
+								{
+									transport,
+								},
+							);
+						} else if (body.kind === "unblockProfile") {
+							result = yield* removeBlockEffect(
+								body.accountId || "acct_primary",
+								body.query || "",
+								{
+									transport,
+								},
+							);
+						} else if (body.kind === "muteProfile") {
+							result = yield* addMuteEffect(
+								body.accountId || "acct_primary",
+								body.query || "",
+								{
+									transport,
+								},
+							);
+						} else if (body.kind === "unmuteProfile") {
+							result = yield* removeMuteEffect(
+								body.accountId || "acct_primary",
+								body.query || "",
+								{
+									transport,
+								},
+							);
+						} else if (body.kind === "syncBlocks") {
+							result = yield* syncBlocksEffect(
+								body.accountId || "acct_primary",
+							);
+						} else {
+							return jsonResponse(
+								{ ok: false, message: "Unknown action kind" },
+								{ status: 400 },
+							);
+						}
 
-				return new Response(JSON.stringify(result), {
-					headers: {
-						"content-type": "application/json",
-					},
-				});
-			},
+						return jsonResponse(result);
+					}).pipe(
+						Effect.catchAll((error) =>
+							Effect.succeed(
+								jsonResponse(
+									{
+										ok: false,
+										message: actionErrorMessage(error),
+									},
+									{ status: 500 },
+								),
+							),
+						),
+					),
+				),
 		},
 	},
 });

package/src/routes/api/avatar.tsx

@@ -1,41 +1,50 @@
 import { createFileRoute } from "@tanstack/react-router";
-import { readCachedAvatar } from "#/lib/avatar-cache";
+import { Effect } from "effect";
+import { readCachedAvatarEffect } from "#/lib/avatar-cache";
+import {
+	jsonResponse,
+	runRouteEffect,
+	sensitiveRequestErrorResponse,
+} from "#/lib/http-effect";
 
 export const Route = createFileRoute("/api/avatar")({
 	server: {
 		handlers: {
-			GET: async ({ request }) => {
-				const url = new URL(request.url);
-				const profileId = url.searchParams.get("profileId")?.trim();
+			GET: ({ request }) =>
+				runRouteEffect(
+					Effect.gen(function* () {
+						const sensitiveError = sensitiveRequestErrorResponse(request);
+						if (sensitiveError) return sensitiveError;
 
-				if (!profileId) {
-					return new Response(
-						JSON.stringify({ ok: false, message: "Missing profileId" }),
-						{
-							status: 400,
-							headers: { "content-type": "application/json" },
-						},
-					);
-				}
+						const url = new URL(request.url);
+						const profileId = url.searchParams.get("profileId")?.trim();
 
-				const avatar = await readCachedAvatar(profileId);
-				if (!avatar) {
-					return new Response(
-						JSON.stringify({ ok: false, message: "Avatar not found" }),
-						{
-							status: 404,
-							headers: { "content-type": "application/json" },
-						},
-					);
-				}
+						if (!profileId) {
+							return jsonResponse(
+								{ ok: false, message: "Missing profileId" },
+								{ status: 400 },
+							);
+						}
 
-				return new Response(new Uint8Array(avatar.buffer), {
-					headers: {
-						"cache-control": "public, max-age=86400, immutable",
-						"content-type": avatar.contentType,
-					},
-				});
-			},
+						const avatar = yield* readCachedAvatarEffect(profileId).pipe(
+							Effect.catchAll(() => Effect.succeed(null)),
+						);
+						if (!avatar) {
+							return jsonResponse(
+								{ ok: false, message: "Avatar not found" },
+								{ status: 404 },
+							);
+						}
+
+						return new Response(new Uint8Array(avatar.buffer), {
+							headers: {
+								"cache-control": "public, max-age=86400, immutable",
+								"content-type": avatar.contentType,
+								"x-content-type-options": "nosniff",
+							},
+						});
+					}),
+				),
 		},
 	},
 });

package/src/routes/api/blocks.tsx

@@ -1,32 +1,35 @@
 import { createFileRoute } from "@tanstack/react-router";
+import { Effect } from "effect";
 import { getBlocksResponse } from "#/lib/blocks";
-
-function parseNumber(value: string | null) {
-	if (!value) return undefined;
-	const parsed = Number(value);
-	return Number.isFinite(parsed) ? parsed : undefined;
-}
+import {
+	jsonResponse,
+	parseBoundedInteger,
+	runRouteEffect,
+	sensitiveRequestErrorResponse,
+} from "#/lib/http-effect";
 
 export const Route = createFileRoute("/api/blocks")({
 	server: {
 		handlers: {
-			GET: ({ request }) => {
-				const url = new URL(request.url);
-				return new Response(
-					JSON.stringify(
-						getBlocksResponse({
-							accountId: url.searchParams.get("account") ?? undefined,
-							search: url.searchParams.get("search") ?? undefined,
-							limit: parseNumber(url.searchParams.get("limit")) ?? 12,
-						}),
-					),
-					{
-						headers: {
-							"content-type": "application/json",
-						},
-					},
-				);
-			},
+			GET: ({ request }) =>
+				runRouteEffect(
+					Effect.sync(() => {
+						const denied = sensitiveRequestErrorResponse(request);
+						if (denied) return denied;
+
+						const url = new URL(request.url);
+						return jsonResponse(
+							getBlocksResponse({
+								accountId: url.searchParams.get("account") ?? undefined,
+								search: url.searchParams.get("search") ?? undefined,
+								limit: parseBoundedInteger(url.searchParams.get("limit"), {
+									defaultValue: 12,
+									max: 50,
+								}),
+							}),
+						);
+					}),
+				),
 		},
 	},
 });

package/src/routes/api/conversation.tsx

@@ -1,5 +1,10 @@
 import { createFileRoute } from "@tanstack/react-router";
-import { maybeAutoUpdateBackup } from "#/lib/backup";
+import { Effect } from "effect";
+import { maybeAutoUpdateBackupEffect } from "#/lib/backup";
+import {
+	runRouteEffect,
+	sensitiveRequestErrorResponse,
+} from "#/lib/http-effect";
 import { getTweetConversation } from "#/lib/queries";
 
 function json(data: unknown, status = 200) {
@@ -14,21 +19,27 @@ function json(data: unknown, status = 200) {
 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);
-				}
+			GET: ({ request }) =>
+				runRouteEffect(
+					Effect.gen(function* () {
+						const denied = sensitiveRequestErrorResponse(request);
+						if (denied) return denied;
 
-				const conversation = getTweetConversation(tweetId);
-				if (!conversation) {
-					return json({ ok: false, error: "Tweet not found" }, 404);
-				}
+						yield* maybeAutoUpdateBackupEffect();
+						const url = new URL(request.url);
+						const tweetId = url.searchParams.get("tweetId")?.trim();
+						if (!tweetId) {
+							return json({ ok: false, error: "Missing tweetId" }, 400);
+						}
 
-				return json({ ok: true, ...conversation });
-			},
+						const conversation = getTweetConversation(tweetId);
+						if (!conversation) {
+							return json({ ok: false, error: "Tweet not found" }, 404);
+						}
+
+						return json({ ok: true, ...conversation });
+					}),
+				),
 		},
 	},
 });