Add Sentry error monitoring (edge-compatible)

.gitignore

@@ -28,3 +28,6 @@ deno.lock
 /static/open-letter/portraits/original
 CLAUDE.md
 .claude/
+
+# Sentry Config File
+.env.sentry-build-plugin

package.json

@@ -87,6 +87,9 @@
 		"@pagefind/default-ui": "^1.4.0",
 		"@prgm/sveltekit-progress-bar": "^3.0.2",
 		"@remix-run/headers": "^0.12.0",
+		"@sentry/deno": "^10.47.0",
+		"@sentry/svelte": "^10.47.0",
+		"@sentry/vite-plugin": "^5.1.1",
 		"@sveltejs/enhanced-img": "^0.10.4",
 		"@turf/distance": "^7.3.4",
 		"airtable": "^0.12.2",

src/hooks.client.ts

@@ -0,0 +1,36 @@
+import * as Sentry from '@sentry/svelte'
+import type { HandleClientError } from '@sveltejs/kit'
+import { env } from '$env/dynamic/public'
+
+let dsn: string | undefined
+
+export const init = () => {
+	dsn = env.PUBLIC_SENTRY_DSN
+	const release = import.meta.env.SENTRY_RELEASE as string | undefined
+
+	if (dsn) {
+		try {
+			Sentry.init({
+				dsn,
+				release,
+				tracesSampleRate: 0
+			})
+		} catch (e) {
+			console.error('[Sentry Client] Failed to initialize:', e)
+		}
+	}
+}
+
+export const handleError: HandleClientError = ({ error, event, status, message }) => {
+	if (dsn) {
+		Sentry.captureException(error, {
+			extra: {
+				status,
+				message,
+				url: event.url?.href,
+				route: event.route?.id
+			}
+		})
+	}
+	return { message: 'An unexpected error occurred.' }
+}

src/hooks.server.ts

@@ -15,9 +15,32 @@ if (
 	delete (globalThis as { window?: Window }).window
 }
 
-import { type Handle } from '@sveltejs/kit'
+import { type Handle, type HandleServerError } from '@sveltejs/kit'
+import { env } from '$env/dynamic/public'
 import { paraglideMiddleware } from '$lib/paraglide/server.js'
 
+let Sentry: typeof import('@sentry/deno') | undefined
+
+export const init = async () => {
+	const dsn = env.PUBLIC_SENTRY_DSN
+	const release = import.meta.env.SENTRY_RELEASE as string | undefined
+	const isDeno = typeof Deno !== 'undefined'
+
+	if (dsn && isDeno) {
+		try {
+			Sentry = await import('@sentry/deno')
+			Sentry.init({
+				dsn,
+				release,
+				tracesSampleRate: 0,
+				enableLogs: true
+			})
+		} catch (e) {
+			console.error('[Sentry Server] Failed to initialize:', e)
+		}
+	}
+}
+
 const handle: Handle = ({ event, resolve }) =>
 	paraglideMiddleware(event.request, ({ request: localizedRequest, locale }) => {
 		event.request = localizedRequest
@@ -27,3 +50,19 @@ const handle: Handle = ({ event, resolve }) =>
 	})
 
 export { handle }
+
+export const handleError: HandleServerError = ({ error, event, status, message }) => {
+	console.error(error)
+	if (Sentry) {
+		Sentry.captureException(error, {
+			extra: {
+				status,
+				message,
+				url: event.url?.href,
+				method: event.request?.method
+			}
+		})
+		event.platform?.context.waitUntil(Sentry.flush(2000))
+	}
+	return { message: 'An unexpected error occurred.' }
+}

template.env

@@ -28,6 +28,9 @@ PARAGLIDE_LOCALES=en
 L10N_OPENROUTER_API_KEY=""
 # Add your OpenRouter API key above to enable l10n generation
 
+# Sentry DSN for error monitoring (PUBLIC_ prefix makes it available in client code)
+PUBLIC_SENTRY_DSN=""
+
 # Optionally override which branch of the l10n cache to use
 # (defaults to same name as current website branch, or 'main' if on main)
 # L10N_BRANCH="my-feature-branch"

vite.config.ts

@@ -1,14 +1,24 @@
 import { enhancedImages } from '@sveltejs/enhanced-img'
 import { sveltekit } from '@sveltejs/kit/vite'
+import { execSync } from 'child_process'
 import dotenv from 'dotenv'
 import fs from 'fs'
 import path from 'path'
 import { defineConfig } from 'vite'
 import lucidePreprocess from 'vite-plugin-lucide-preprocess'
+import { sentryVitePlugin } from '@sentry/vite-plugin'
 import { isDev } from './src/lib/env'
 import { MARKDOWN_L10NS } from './src/lib/l10n'
 import { locales as compiledLocales } from './src/lib/paraglide/runtime.js'
 
+function getSentryRelease(): string | undefined {
+	try {
+		return process.env.COMMIT_REF || execSync('git rev-parse HEAD').toString().trim()
+	} catch {
+		return undefined
+	}
+}
+
 function getLocaleExcludePatterns(): RegExp[] {
 	const md = path.resolve(MARKDOWN_L10NS)
 	const reposLocales = fs.existsSync(md)
@@ -33,7 +43,8 @@ export default defineConfig(() => {
 	return {
 		define: {
 			// Make PARAGLIDE_LOCALES accessible to browser code via import.meta.env
-			'import.meta.env.PARAGLIDE_LOCALES': JSON.stringify(process.env.PARAGLIDE_LOCALES)
+			'import.meta.env.PARAGLIDE_LOCALES': JSON.stringify(process.env.PARAGLIDE_LOCALES),
+			'import.meta.env.SENTRY_RELEASE': JSON.stringify(getSentryRelease())
 		},
 
 		server: {
@@ -61,6 +72,26 @@ export default defineConfig(() => {
 				external: getLocaleExcludePatterns()
 			}
 		} as const,
-		plugins: [lucidePreprocess(), enhancedImages(), sveltekit()]
+		plugins: [
+			lucidePreprocess(),
+			enhancedImages(),
+			sveltekit(),
+			!isDev() &&
+			process.env.SENTRY_AUTH_TOKEN &&
+			process.env.SENTRY_ORG &&
+			process.env.SENTRY_PROJECT
+				? sentryVitePlugin({
+						org: process.env.SENTRY_ORG,
+						project: process.env.SENTRY_PROJECT,
+						authToken: process.env.SENTRY_AUTH_TOKEN,
+						release: { name: getSentryRelease() },
+						sourcemaps: {
+							filesToDeleteAfterUpload: ['./build/**/*.map']
+						},
+						telemetry: false,
+						silent: true
+					})
+				: null
+		].filter(Boolean)
 	}
 })