Merge pull request #14 from felixgollnhuber/codex/fge-internationalisierung-hinzu

Add English internationalization support across app routes and UI

Author: felixgollnhuber

.env.coolify.example

@@ -1,6 +1,7 @@
 APP_SETUP_COMPLETE=false
 APP_NAME=tempoll
 APP_URL=https://tempoll.example.com
+APP_DEFAULT_LOCALE=de
 LEGAL_PAGES_ENABLED=false
 
 TEMPOLL_DB_NAME=tempoll

.env.example

@@ -2,6 +2,7 @@ APP_SETUP_COMPLETE=false
 
 APP_NAME="tempoll"
 APP_URL="http://localhost:3000"
+APP_DEFAULT_LOCALE="de"
 DATABASE_URL="postgresql://postgres:postgres@localhost:55432/tempoll?schema=public"
 LEGAL_PAGES_ENABLED=false
 

proxy.ts

@@ -3,6 +3,8 @@ import type { NextRequest } from "next/server";
 
 import { getParticipantSessionCookieFromEditLink } from "@/lib/event-service";
 import { appConfig } from "@/lib/config";
+import { LOCALE_COOKIE_NAME } from "@/lib/i18n/locale";
+import { createI18n, resolveLocale } from "@/lib/i18n/server";
 import { getParticipantCookieOptions } from "@/lib/tokens";
 import { isAppSetupComplete } from "@/lib/setup-state";
 import { PRIVATE_NO_STORE_HEADERS, mergeHeaders } from "@/lib/security";
@@ -17,6 +19,13 @@ function getEventSlug(pathname: string) {
 }
 
 export async function proxy(request: NextRequest) {
+  const i18n = createI18n(
+    resolveLocale({
+      cookieLocale: request.cookies.get(LOCALE_COOKIE_NAME)?.value,
+      acceptLanguage: request.headers.get("accept-language"),
+    }),
+  );
+
   if (!isAppSetupComplete()) {
     const { pathname } = request.nextUrl;
 
@@ -27,7 +36,7 @@ export async function proxy(request: NextRequest) {
     if (pathname.startsWith("/api/")) {
       return NextResponse.json(
         {
-          error: "App setup is not complete yet. Open /setup to generate the environment configuration.",
+          error: i18n.messages.errors.appSetupIncomplete,
         },
         { status: 503 },
       );

src/app/api/events/[slug]/availability/route.test.ts

@@ -49,6 +49,7 @@ describe("PUT /api/events/[slug]/availability", () => {
           selectedSlotStarts: ["2026-03-30T07:00:00.000Z"],
         }),
         headers: {
+          "Accept-Language": "en-US",
           "Content-Type": "application/json",
         },
       }),
@@ -61,6 +62,7 @@ describe("PUT /api/events/[slug]/availability", () => {
 
     expect(saveAvailability).toHaveBeenCalledWith(
       "test-event",
+      "en",
       {
         selectedSlotStarts: ["2026-03-30T07:00:00.000Z"],
       },
@@ -71,9 +73,7 @@ describe("PUT /api/events/[slug]/availability", () => {
   });
 
   it("returns the domain-auth error for missing or expired participant sessions", async () => {
-    saveAvailability.mockRejectedValue(
-      unauthorized("Your editing session is no longer valid. Reopen your participant link or join the event again."),
-    );
+    saveAvailability.mockRejectedValue(unauthorized("participant_session_missing"));
 
     const { PUT } = await import("./route");
     const response = await PUT(
@@ -83,6 +83,7 @@ describe("PUT /api/events/[slug]/availability", () => {
           selectedSlotStarts: [],
         }),
         headers: {
+          "Accept-Language": "en-US",
           "Content-Type": "application/json",
         },
       }),
@@ -110,6 +111,7 @@ describe("PUT /api/events/[slug]/availability", () => {
           selectedSlotStarts: [],
         }),
         headers: {
+          "Accept-Language": "en-US",
           "Content-Type": "application/json",
         },
       }),

src/app/api/events/[slug]/availability/route.ts

@@ -2,11 +2,12 @@ import { cookies } from "next/headers";
 import { NextResponse } from "next/server";
 
 import { saveAvailability } from "@/lib/event-service";
+import { createI18n, getLocaleFromRequest } from "@/lib/i18n/server";
 import { handleRouteError, PRIVATE_NO_STORE_HEADERS } from "@/lib/security";
 import { getClientIp } from "@/lib/request";
 import { enforceRateLimit } from "@/lib/rate-limit";
 import { getParticipantCookieName } from "@/lib/tokens";
-import { availabilityMutationSchema } from "@/lib/validators";
+import { createAvailabilityMutationSchema } from "@/lib/validators";
 
 type Context = {
   params: Promise<{
@@ -15,6 +16,8 @@ type Context = {
 };
 
 export async function PUT(request: Request, { params }: Context) {
+  const i18n = createI18n(getLocaleFromRequest(request));
+
   try {
     const { slug } = await params;
     const ip = getClientIp(request);
@@ -24,19 +27,19 @@ export async function PUT(request: Request, { params }: Context) {
     enforceRateLimit(`availability:ip:${slug}:${ip}`, {
       limit: 120,
       windowMs: 5 * 60 * 1000,
-      message: "Too many availability updates from this network. Please wait a moment and try again.",
+      code: "availability_ip_rate_limited",
     });
 
     enforceRateLimit(`availability:session:${slug}:${cookieValue ?? ip}`, {
       limit: 60,
       windowMs: 60 * 1000,
-      message: "Too many availability updates in a short time. Please slow down for a moment.",
+      code: "availability_session_rate_limited",
     });
 
     const json = await request.json();
-    const mutation = availabilityMutationSchema.parse(json);
+    const mutation = createAvailabilityMutationSchema().parse(json);
 
-    const result = await saveAvailability(slug, mutation, cookieValue);
+    const result = await saveAvailability(slug, i18n.locale, mutation, cookieValue);
 
     return NextResponse.json(
       { ok: true, snapshot: result.snapshot },
@@ -46,7 +49,8 @@ export async function PUT(request: Request, { params }: Context) {
     );
   } catch (error) {
     return handleRouteError(error, {
-      fallbackMessage: "Unable to save availability.",
+      fallbackMessage: i18n.messages.errors.routeFallbacks.saveAvailability,
+      messages: i18n.messages,
       route: "api/events/[slug]/availability",
       headers: PRIVATE_NO_STORE_HEADERS,
     });

src/app/api/events/[slug]/ics/route.test.ts

@@ -31,11 +31,18 @@ describe("GET /api/events/[slug]/ics", () => {
     });
 
     const { GET } = await import("./route");
-    const response = await GET(new Request("https://tempoll.example.com/api/events/team-sync/ics"), {
-      params: Promise.resolve({
-        slug: "team-sync",
+    const response = await GET(
+      new Request("https://tempoll.example.com/api/events/team-sync/ics", {
+        headers: {
+          "Accept-Language": "en-US",
+        },
       }),
-    });
+      {
+        params: Promise.resolve({
+          slug: "team-sync",
+        }),
+      },
+    );
 
     expect(response.status).toBe(200);
     expect(response.headers.get("content-type")).toContain("text/calendar");
@@ -60,11 +67,18 @@ describe("GET /api/events/[slug]/ics", () => {
     });
 
     const { GET } = await import("./route");
-    const response = await GET(new Request("https://tempoll.example.com/api/events/team-sync/ics"), {
-      params: Promise.resolve({
-        slug: "team-sync",
+    const response = await GET(
+      new Request("https://tempoll.example.com/api/events/team-sync/ics", {
+        headers: {
+          "Accept-Language": "en-US",
+        },
       }),
-    });
+      {
+        params: Promise.resolve({
+          slug: "team-sync",
+        }),
+      },
+    );
 
     expect(response.status).toBe(404);
     await expect(response.json()).resolves.toEqual({

src/app/api/events/[slug]/ics/route.ts

@@ -1,6 +1,7 @@
 import { NextResponse } from "next/server";
 
 import { getPublicEventSnapshot } from "@/lib/event-service";
+import { createI18n, getLocaleFromRequest } from "@/lib/i18n/server";
 import { buildEventCalendarFile } from "@/lib/ics";
 import { PUBLIC_NO_STORE_HEADERS, mergeHeaders } from "@/lib/security";
 import { buildPublicEventUrl } from "@/lib/tokens";
@@ -13,13 +14,14 @@ type Context = {
 
 export const dynamic = "force-dynamic";
 
-export async function GET(_request: Request, { params }: Context) {
+export async function GET(request: Request, { params }: Context) {
+  const i18n = createI18n(getLocaleFromRequest(request));
   const { slug } = await params;
-  const event = await getPublicEventSnapshot(slug);
+  const event = await getPublicEventSnapshot(slug, i18n.locale);
 
   if (!event || event.snapshot.status !== "CLOSED" || !event.snapshot.finalizedSlot) {
     return NextResponse.json(
-      { error: "Event not found." },
+      { error: i18n.messages.errors.routeFallbacks.eventNotFound },
       {
         status: 404,
         headers: mergeHeaders(PUBLIC_NO_STORE_HEADERS),

src/app/api/events/[slug]/participants/route.ts

@@ -2,11 +2,12 @@ import { NextResponse } from "next/server";
 
 import { appConfig } from "@/lib/config";
 import { joinParticipant } from "@/lib/event-service";
+import { createI18n, getLocaleFromRequest } from "@/lib/i18n/server";
 import { handleRouteError, PRIVATE_NO_STORE_HEADERS } from "@/lib/security";
 import { getClientIp } from "@/lib/request";
 import { enforceRateLimit } from "@/lib/rate-limit";
 import { getParticipantCookieOptions } from "@/lib/tokens";
-import { participantCreateSchema } from "@/lib/validators";
+import { createParticipantCreateSchema } from "@/lib/validators";
 
 type Context = {
   params: Promise<{
@@ -15,18 +16,20 @@ type Context = {
 };
 
 export async function POST(request: Request, { params }: Context) {
+  const i18n = createI18n(getLocaleFromRequest(request));
+
   try {
     const { slug } = await params;
     const ip = getClientIp(request);
 
     enforceRateLimit(`event-join:${slug}:${ip}`, {
       limit: 20,
       windowMs: 10 * 60 * 1000,
-      message: "Too many join attempts. Please wait a few minutes and try again.",
+      code: "event_join_rate_limited",
     });
 
     const json = await request.json();
-    const input = participantCreateSchema.parse(json);
+    const input = createParticipantCreateSchema(i18n.messages).parse(json);
     const result = await joinParticipant(slug, input.displayName);
 
     const response = NextResponse.json(
@@ -48,7 +51,8 @@ export async function POST(request: Request, { params }: Context) {
     return response;
   } catch (error) {
     return handleRouteError(error, {
-      fallbackMessage: "Unable to join event.",
+      fallbackMessage: i18n.messages.errors.routeFallbacks.joinEvent,
+      messages: i18n.messages,
       route: "api/events/[slug]/participants",
       headers: PRIVATE_NO_STORE_HEADERS,
     });

src/app/api/events/[slug]/route.ts

@@ -2,6 +2,7 @@ import { cookies } from "next/headers";
 import { NextResponse } from "next/server";
 
 import { getPublicEventSnapshot } from "@/lib/event-service";
+import { createI18n, getLocaleFromRequest } from "@/lib/i18n/server";
 import { PRIVATE_NO_STORE_HEADERS, PUBLIC_NO_STORE_HEADERS, mergeHeaders } from "@/lib/security";
 import { getParticipantCookieName } from "@/lib/tokens";
 
@@ -13,14 +14,18 @@ type Context = {
 
 export const dynamic = "force-dynamic";
 
-export async function GET(_request: Request, { params }: Context) {
+export async function GET(request: Request, { params }: Context) {
+  const i18n = createI18n(getLocaleFromRequest(request));
   const { slug } = await params;
   const cookieStore = await cookies();
   const cookieValue = cookieStore.get(getParticipantCookieName(slug))?.value;
-  const event = await getPublicEventSnapshot(slug, cookieValue);
+  const event = await getPublicEventSnapshot(slug, i18n.locale, cookieValue);
 
   if (!event) {
-    return NextResponse.json({ error: "Event not found." }, { status: 404 });
+    return NextResponse.json(
+      { error: i18n.messages.errors.routeFallbacks.eventNotFound },
+      { status: 404 },
+    );
   }
 
   return NextResponse.json(