feat(api): add optional Sentry error tracking via SENTRY_DSN

Author: andrejsshell

.env.sample

@@ -73,3 +73,7 @@ SMTP_REQUIRE_TLS=
 # placeholder and apps/web/env.sh substitutes it at container start from this
 # env var. For local dev (vite), set VITE_TURNSTILE_SITE_KEY in apps/web/.env.
 #KANEO_TURNSTILE_SITE_KEY=
+
+# Sentry error tracking (Optional) — errors are only reported when a DSN is set
+# SENTRY_DSN=
+# SENTRY_ENVIRONMENT=production

apps/api/package.json

@@ -42,6 +42,7 @@
     "@oslojs/crypto": "^1.0.1",
     "@oslojs/encoding": "^1.1.0",
     "@paralleldrive/cuid2": "^3.3.0",
+    "@sentry/node": "^10.68.0",
     "@valibot/to-json-schema": "^1.7.1",
     "bcryptjs": "^3.0.2",
     "better-auth": "^1.6.9",

apps/api/src/index.ts

@@ -1,7 +1,10 @@
+import "./instrument";
+
 import { dirname } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { serve } from "@hono/node-server";
 import { createNodeWebSocket } from "@hono/node-ws";
+import * as Sentry from "@sentry/node";
 import type { Session, User } from "better-auth/types";
 import { eq, sql } from "drizzle-orm";
 import { migrate } from "drizzle-orm/node-postgres/migrator";
@@ -148,6 +151,19 @@ function buildContentDisposition(filename: string, inline: boolean) {
 
 export function createApp() {
   const app = new Hono<AppVariables>();
+
+  app.onError((err, c) => {
+    if (err instanceof HTTPException) {
+      // expected errors (401/404/...) are not reported; real failures are
+      if (err.status >= 500) {
+        Sentry.captureException(err);
+      }
+      return err.getResponse();
+    }
+
+    Sentry.captureException(err);
+    return c.json({ message: "Internal Server Error" }, 500);
+  });
   const nodeWs = createNodeWebSocket({ app });
   const { upgradeWebSocket, injectWebSocket } = nodeWs;
   const corsOriginSource = [

apps/api/src/instrument.ts

@@ -0,0 +1,10 @@
+import * as Sentry from "@sentry/node";
+
+if (process.env.SENTRY_DSN) {
+  Sentry.init({
+    dsn: process.env.SENTRY_DSN,
+    environment:
+      process.env.SENTRY_ENVIRONMENT ?? process.env.NODE_ENV ?? "production",
+    sendDefaultPii: false,
+  });
+}

apps/docs/docs.json

@@ -170,7 +170,7 @@
 	},
 	"integrations": {
 		"plausible": {
-			"domain": "kaneo.app/docs",
+			"domain": "kaneo.app",
 			"server": "plausible.kaneo.app"
 		}
 	}