treewide: add e2e test infrastructure with Playwright

- Add e2e/ directory with Playwright configuration
  - Docker-based test database on port 5433
  - Global setup/teardown for server and frontend
  - Tests for message, channel, and navigation (9 tests)
- Mock session for DISABLE_AUTH mode in better-auth.ts
- Fix WebSocket URL duplication in +layout.svelte
- Add test:e2e scripts to package.json

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: aster-void

.gitignore

@@ -9,6 +9,7 @@ node_modules
 
 # Tests
 test-results
+playwright-report
 
 # target
 target

apps/desktop/src/routes/+layout.svelte

@@ -9,8 +9,8 @@
   // Initialize API client
   setupApi();
 
-  // Initialize WebSocket client
-  const wsUrl = `${env.PUBLIC_API_BASE_URL.replace(/^http/, "ws")}/ws`;
+  // Initialize WebSocket client (Eden Treaty adds /ws automatically)
+  const wsUrl = env.PUBLIC_API_BASE_URL.replace(/^http/, "ws");
 
   $effect(() => {
     let cleanup: (() => void) | undefined;

apps/server/src/domains/auth/better-auth.ts

@@ -1,7 +1,29 @@
 import { type Context, Elysia } from "elysia";
 import { auth } from "../../auth.ts";
+import { env } from "../../env.ts";
+
+const MOCK_SESSION = {
+  session: {
+    id: "mock-session-id",
+    userId: "dev-user-id",
+    expiresAt: new Date(Date.now() + 86400000).toISOString(),
+  },
+  user: {
+    id: "dev-user-id",
+    email: "dev@example.com",
+    name: "Dev User",
+    emailVerified: true,
+    createdAt: new Date().toISOString(),
+    updatedAt: new Date().toISOString(),
+  },
+};
 
 const betterAuthView = (context: Context) => {
+  // Return mock session when auth is disabled
+  if (env.DISABLE_AUTH && context.request.url.endsWith("/get-session")) {
+    return Response.json(MOCK_SESSION);
+  }
+
   const BETTER_AUTH_ACCEPT_METHODS = ["POST", "GET"];
   if (BETTER_AUTH_ACCEPT_METHODS.includes(context.request.method)) {
     return auth.handler(context.request);

bun.lock

@@ -0,0 +1,48 @@
+/**
+ * E2E test environment configuration.
+ * Uses isolated ports and Docker-based database.
+ */
+export const testEnv = {
+  // Database (Docker container on port 5433)
+  DATABASE_URL: "postgres://postgres:postgres@localhost:5433/postgres",
+  DB_CONTAINER_NAME: "prism-test-db",
+  DB_PORT: "5433",
+
+  // Server
+  PORT: "3001",
+  SERVER_URL: "http://localhost:3001",
+
+  // Frontend
+  FRONTEND_PORT: "5174",
+  FRONTEND_URL: "http://localhost:5174",
+
+  // Auth (disabled for tests)
+  DISABLE_AUTH: "true",
+  PUBLIC_DISABLE_AUTH: "true",
+  CORS_ORIGIN: "http://localhost:5174",
+  PUBLIC_API_BASE_URL: "http://localhost:3001",
+
+  // Dummy values for Better Auth (not used when DISABLE_AUTH=true)
+  BETTER_AUTH_SECRET: "test-secret-key-at-least-32-characters-long",
+  GOOGLE_CLIENT_ID: "test-client-id",
+  GOOGLE_CLIENT_SECRET: "test-client-secret",
+};
+
+/**
+ * Convert testEnv to process.env format
+ */
+export function getEnvString(): string {
+  return Object.entries(testEnv)
+    .filter(
+      ([key]) =>
+        ![
+          "DB_CONTAINER_NAME",
+          "DB_PORT",
+          "SERVER_URL",
+          "FRONTEND_URL",
+          "FRONTEND_PORT",
+        ].includes(key),
+    )
+    .map(([key, value]) => `${key}=${value}`)
+    .join("\n");
+}

e2e/env.ts

@@ -0,0 +1,170 @@
+import { type ChildProcess, execSync, spawn } from "node:child_process";
+import { testEnv } from "./env.ts";
+
+const processes: ChildProcess[] = [];
+
+/**
+ * Get all test environment variables for subprocess
+ */
+function getTestEnvVars(): NodeJS.ProcessEnv {
+  return {
+    ...process.env,
+    DATABASE_URL: testEnv.DATABASE_URL,
+    PORT: testEnv.PORT,
+    CORS_ORIGIN: testEnv.CORS_ORIGIN,
+    DISABLE_AUTH: testEnv.DISABLE_AUTH,
+    PUBLIC_DISABLE_AUTH: testEnv.PUBLIC_DISABLE_AUTH,
+    PUBLIC_API_BASE_URL: testEnv.PUBLIC_API_BASE_URL,
+    BETTER_AUTH_SECRET: testEnv.BETTER_AUTH_SECRET,
+    GOOGLE_CLIENT_ID: testEnv.GOOGLE_CLIENT_ID,
+    GOOGLE_CLIENT_SECRET: testEnv.GOOGLE_CLIENT_SECRET,
+  };
+}
+
+/**
+ * Wait for a URL to respond with 200 OK
+ */
+async function waitForUrl(url: string, timeout = 30000): Promise<void> {
+  const start = Date.now();
+  while (Date.now() - start < timeout) {
+    try {
+      const res = await fetch(url);
+      if (res.ok) return;
+    } catch {
+      // Not ready yet
+    }
+    await new Promise((r) => setTimeout(r, 500));
+  }
+  throw new Error(`Timeout waiting for ${url}`);
+}
+
+/**
+ * Wait for PostgreSQL to be ready
+ */
+async function waitForDb(timeout = 30000): Promise<void> {
+  const start = Date.now();
+  while (Date.now() - start < timeout) {
+    try {
+      execSync(
+        `docker exec ${testEnv.DB_CONTAINER_NAME} pg_isready -U postgres`,
+        { stdio: "ignore" },
+      );
+      return;
+    } catch {
+      // Not ready yet
+    }
+    await new Promise((r) => setTimeout(r, 500));
+  }
+  throw new Error("Timeout waiting for database");
+}
+
+/**
+ * Start PostgreSQL Docker container
+ */
+function startDatabase(): void {
+  console.log("🐘 Starting test database...");
+
+  // Remove existing container if any
+  try {
+    execSync(`docker rm -f ${testEnv.DB_CONTAINER_NAME}`, { stdio: "ignore" });
+  } catch {
+    // Container doesn't exist, that's fine
+  }
+
+  // Start new container
+  execSync(
+    `docker run -d --name ${testEnv.DB_CONTAINER_NAME} -p ${testEnv.DB_PORT}:5432 -e POSTGRES_PASSWORD=postgres postgres:16`,
+    { stdio: "inherit" },
+  );
+}
+
+/**
+ * Run database migrations
+ */
+function runMigrations(): void {
+  console.log("📦 Running migrations...");
+  execSync("bun db:migrate", {
+    cwd: "apps/server",
+    stdio: "inherit",
+    env: getTestEnvVars(),
+  });
+}
+
+/**
+ * Run database seed
+ */
+function runSeed(): void {
+  console.log("🌱 Seeding database...");
+  execSync("bun db:seed", {
+    stdio: "inherit",
+    env: getTestEnvVars(),
+  });
+}
+
+/**
+ * Start the API server
+ */
+function startServer(): ChildProcess {
+  console.log("🦊 Starting server...");
+  const server = spawn("bun", ["run", "src/index.ts"], {
+    cwd: "apps/server",
+    stdio: "inherit",
+    env: getTestEnvVars(),
+  });
+  processes.push(server);
+  return server;
+}
+
+/**
+ * Start the frontend dev server
+ */
+function startFrontend(): ChildProcess {
+  console.log("🌐 Starting frontend...");
+  const frontend = spawn(
+    "bun",
+    ["vite", "dev", "--port", testEnv.FRONTEND_PORT],
+    {
+      cwd: "apps/desktop",
+      stdio: "inherit",
+      env: {
+        ...process.env,
+        PUBLIC_API_BASE_URL: testEnv.PUBLIC_API_BASE_URL,
+        PUBLIC_DISABLE_AUTH: testEnv.PUBLIC_DISABLE_AUTH,
+      },
+    },
+  );
+  processes.push(frontend);
+  return frontend;
+}
+
+/**
+ * Global setup for Playwright tests
+ */
+export default async function globalSetup(): Promise<void> {
+  console.log("\n🚀 Starting E2E test environment...\n");
+
+  // 1. Start database
+  startDatabase();
+  await waitForDb();
+  console.log("✅ Database ready");
+
+  // 2. Run migrations and seed
+  runMigrations();
+  runSeed();
+  console.log("✅ Database seeded");
+
+  // 3. Start server
+  startServer();
+  await waitForUrl(`${testEnv.SERVER_URL}/health`);
+  console.log("✅ Server ready");
+
+  // 4. Start frontend
+  startFrontend();
+  await waitForUrl(testEnv.FRONTEND_URL);
+  console.log("✅ Frontend ready");
+
+  console.log("\n✨ E2E environment ready!\n");
+
+  // Store process info for teardown
+  (globalThis as Record<string, unknown>).__E2E_PROCESSES__ = processes;
+}

e2e/global-setup.ts

@@ -0,0 +1,31 @@
+import { type ChildProcess, execSync } from "node:child_process";
+import { testEnv } from "./env.ts";
+
+/**
+ * Global teardown for Playwright tests
+ */
+export default async function globalTeardown(): Promise<void> {
+  console.log("\n🧹 Cleaning up E2E test environment...\n");
+
+  // 1. Kill server and frontend processes
+  const processes = (globalThis as Record<string, unknown>)
+    .__E2E_PROCESSES__ as ChildProcess[] | undefined;
+  if (processes) {
+    for (const proc of processes) {
+      if (proc && !proc.killed) {
+        proc.kill("SIGTERM");
+      }
+    }
+    console.log("✅ Processes terminated");
+  }
+
+  // 2. Stop and remove Docker container
+  try {
+    execSync(`docker rm -f ${testEnv.DB_CONTAINER_NAME}`, { stdio: "inherit" });
+    console.log("✅ Database container removed");
+  } catch {
+    console.log("⚠️  Could not remove database container (may not exist)");
+  }
+
+  console.log("\n✨ Cleanup complete!\n");
+}

e2e/global-teardown.ts

@@ -0,0 +1,30 @@
+import { defineConfig, devices } from "@playwright/test";
+import { testEnv } from "./env.ts";
+
+export default defineConfig({
+  testDir: "./tests",
+  fullyParallel: true,
+  forbidOnly: !!process.env.CI,
+  retries: process.env.CI ? 2 : 0,
+  workers: 2,
+  reporter: "html",
+
+  globalSetup: "./global-setup.ts",
+  globalTeardown: "./global-teardown.ts",
+
+  use: {
+    baseURL: testEnv.FRONTEND_URL,
+    trace: "on-first-retry",
+    screenshot: "only-on-failure",
+    launchOptions: {
+      executablePath: process.env.PLAYWRIGHT_CHROMIUM_PATH,
+    },
+  },
+
+  projects: [
+    {
+      name: "chromium",
+      use: { ...devices["Desktop Chrome"] },
+    },
+  ],
+});