birdclaw 0.5.1 → 0.7.0

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 });
+					}),
+				),
 		},
 	},
 });

package/src/routes/api/data-sources.tsx

@@ -0,0 +1,24 @@
+import { createFileRoute } from "@tanstack/react-router";
+import { Effect } from "effect";
+import { getLiveDataSourcesEffect } from "#/lib/data-sources";
+import {
+	jsonResponse,
+	runRouteEffect,
+	sensitiveRequestErrorResponse,
+} from "#/lib/http-effect";
+
+export const Route = createFileRoute("/api/data-sources")({
+	server: {
+		handlers: {
+			GET: ({ request }) =>
+				runRouteEffect(
+					Effect.gen(function* () {
+						const denied = sensitiveRequestErrorResponse(request);
+						if (denied) return denied;
+
+						return jsonResponse(yield* getLiveDataSourcesEffect());
+					}),
+				),
+		},
+	},
+});

package/src/routes/api/inbox.tsx

@@ -1,5 +1,11 @@
 import { createFileRoute } from "@tanstack/react-router";
-import { maybeAutoUpdateBackup } from "#/lib/backup";
+import { Effect } from "effect";
+import { maybeAutoUpdateBackupEffect } from "#/lib/backup";
+import {
+	jsonResponse,
+	runRouteEffect,
+	sensitiveRequestErrorResponse,
+} from "#/lib/http-effect";
 import { listInboxItems } from "#/lib/inbox";
 import type { InboxKind } from "#/lib/types";
 
@@ -12,26 +18,26 @@ function parseNumber(value: string | null) {
 export const Route = createFileRoute("/api/inbox")({
 	server: {
 		handlers: {
-			GET: async ({ request }) => {
-				await maybeAutoUpdateBackup();
-				const url = new URL(request.url);
-				const kind = (url.searchParams.get("kind") ?? "mixed") as InboxKind;
-				return new Response(
-					JSON.stringify(
-						listInboxItems({
-							kind: kind === "mentions" || kind === "dms" ? kind : "mixed",
-							minScore: parseNumber(url.searchParams.get("minScore")),
-							hideLowSignal: url.searchParams.get("hideLowSignal") === "1",
-							limit: parseNumber(url.searchParams.get("limit")) ?? 20,
-						}),
-					),
-					{
-						headers: {
-							"content-type": "application/json",
-						},
-					},
-				);
-			},
+			GET: ({ request }) =>
+				runRouteEffect(
+					Effect.gen(function* () {
+						const denied = sensitiveRequestErrorResponse(request);
+						if (denied) return denied;
+
+						yield* maybeAutoUpdateBackupEffect();
+						const url = new URL(request.url);
+						const kind = (url.searchParams.get("kind") ?? "mixed") as InboxKind;
+						return jsonResponse(
+							listInboxItems({
+								kind: kind === "mentions" || kind === "dms" ? kind : "mixed",
+								account: url.searchParams.get("account") ?? undefined,
+								minScore: parseNumber(url.searchParams.get("minScore")),
+								hideLowSignal: url.searchParams.get("hideLowSignal") === "1",
+								limit: parseNumber(url.searchParams.get("limit")) ?? 20,
+							}),
+						);
+					}),
+				),
 		},
 	},
 });

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

@@ -1,6 +1,12 @@
 import { createFileRoute } from "@tanstack/react-router";
-import { maybeAutoUpdateBackup } from "#/lib/backup";
+import { Effect } from "effect";
+import { maybeAutoUpdateBackupEffect } from "#/lib/backup";
 import { getNativeDb } from "#/lib/db";
+import {
+	jsonResponse,
+	runRouteEffect,
+	sensitiveRequestErrorResponse,
+} from "#/lib/http-effect";
 import { getLinkInsights } from "#/lib/link-insights";
 import type {
 	LinkInsightKind,
@@ -9,14 +15,6 @@ import type {
 	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";
 }
@@ -57,23 +55,31 @@ function parseNumber(value: string | null) {
 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")),
+			GET: ({ request }) =>
+				runRouteEffect(
+					Effect.gen(function* () {
+						const denied = sensitiveRequestErrorResponse(request);
+						if (denied) return denied;
+
+						yield* maybeAutoUpdateBackupEffect();
+						getNativeDb();
+						const url = new URL(request.url);
+						return jsonResponse(
+							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

@@ -1,15 +1,11 @@
 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,
-		},
-	});
-}
+import { Effect } from "effect";
+import {
+	jsonResponse,
+	runRouteEffect,
+	sensitiveRequestErrorResponse,
+} from "#/lib/http-effect";
+import { getOrFetchLinkPreviewEffect } from "#/lib/link-preview-metadata";
 
 function parseUrl(value: string | null) {
 	if (!value) return null;
@@ -27,17 +23,25 @@ function parseUrl(value: string | 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 });
-				}
+			GET: ({ request }) =>
+				runRouteEffect(
+					Effect.gen(function* () {
+						const denied = sensitiveRequestErrorResponse(request);
+						if (denied) return denied;
+
+						const url = new URL(request.url);
+						const previewUrl = parseUrl(url.searchParams.get("url"));
+						if (!previewUrl) {
+							return jsonResponse(
+								{ ok: false, message: "Missing url" },
+								{ status: 400 },
+							);
+						}
 
-				const preview = await getOrFetchLinkPreview(previewUrl, { shortUrl });
-				return json({ ok: true, preview });
-			},
+						const preview = yield* getOrFetchLinkPreviewEffect(previewUrl);
+						return jsonResponse({ ok: true, preview });
+					}),
+				),
 		},
 	},
 });