test: add comprehensive automated test coverage

- Vitest multi-project setup (unit / integration / component) - Real-Postgres integration harness via in-process PGlite (TEST_DATABASE_URL override), migrations applied per worker; production code untouched - Unit: routing, locale, validation/Zod schemas, metadata, mail, site-theme, marquee, media, portfolio helpers, plus architecture-rule tests - Integration: Prisma data layer, API routes, and all server actions - Component: UI primitives and form components (jsdom + Testing Library) - 371 tests passing
2026-08-06 02:27:20 +02:00
parent 0f48381894
commit e2e06be86e
50 changed files with 4975 additions and 26 deletions
@@ -0,0 +1,133 @@
+import { cleanup } from "@testing-library/react";
+import { afterEach, vi } from "vitest";
+import "@testing-library/jest-dom/vitest";
+import React from "react";
+
+afterEach(() => {
+  cleanup();
+});
+
+// ---------------------------------------------------------------------------
+// Global mocks for heavy / browser-only libraries so components render in jsdom.
+// (vi.mock in a setup file applies to every test file in the component project.)
+// ---------------------------------------------------------------------------
+
+vi.mock("framer-motion", () => {
+  const passthrough = (tag: string) =>
+    React.forwardRef(function MotionMock(
+      { children, ...props }: Record<string, unknown> & { children?: React.ReactNode },
+      ref: React.Ref<unknown>,
+    ) {
+      const domProps: Record<string, unknown> = {};
+      for (const [key, value] of Object.entries(props)) {
+        // Drop motion-only props that would warn as unknown DOM attributes.
+        if (
+          /^(initial|animate|exit|transition|variants|whileHover|whileTap|whileInView|whileFocus|whileDrag|drag|layout|layoutId|viewport|custom|onAnimationComplete|style)$/.test(
+            key,
+          )
+        ) {
+          if (key === "style") domProps.style = value;
+          continue;
+        }
+        domProps[key] = value;
+      }
+      return React.createElement(tag, { ...domProps, ref }, children as React.ReactNode);
+    });
+
+  const motion = new Proxy(
+    {},
+    {
+      get: (_target, tag: string) => passthrough(tag),
+    },
+  );
+
+  return {
+    motion,
+    AnimatePresence: ({ children }: { children?: React.ReactNode }) =>
+      React.createElement(React.Fragment, null, children),
+    useReducedMotion: () => true,
+    useInView: () => true,
+    useScroll: () => ({ scrollYProgress: { on: () => () => {}, get: () => 0 } }),
+    useTransform: () => 0,
+    useMotionValue: (value: unknown) => ({ get: () => value, set: () => {}, on: () => () => {} }),
+    useAnimate: () => [React.useRef(null), () => Promise.resolve()],
+  };
+});
+
+vi.mock("gsap", () => {
+  const tween = { kill: () => {}, play: () => {}, pause: () => {}, progress: () => {} };
+  const gsap = {
+    to: () => tween,
+    from: () => tween,
+    fromTo: () => tween,
+    set: () => tween,
+    timeline: () => ({
+      to: () => ({}),
+      from: () => ({}),
+      fromTo: () => ({}),
+      add: () => ({}),
+      kill: () => {},
+    }),
+    registerPlugin: () => {},
+    context: (fn: () => void) => {
+      if (typeof fn === "function") fn();
+      return { revert: () => {}, kill: () => {} };
+    },
+    matchMedia: () => ({ add: () => {}, revert: () => {} }),
+    utils: { toArray: (v: unknown) => (Array.isArray(v) ? v : [v]) },
+  };
+  return { gsap, default: gsap };
+});
+
+vi.mock("@gsap/react", () => ({
+  useGSAP: () => ({ context: {}, contextSafe: (fn: unknown) => fn }),
+}));
+
+vi.mock("next/link", () => ({
+  default: React.forwardRef(function LinkMock(
+    { href, children, ...props }: Record<string, unknown> & { href?: unknown; children?: React.ReactNode },
+    ref: React.Ref<HTMLAnchorElement>,
+  ) {
+    return React.createElement("a", { href: String(href ?? ""), ref, ...props }, children as React.ReactNode);
+  }),
+}));
+
+vi.mock("next/image", () => ({
+  default: ({ src, alt, ...props }: Record<string, unknown> & { src?: unknown; alt?: string }) =>
+    React.createElement("img", { src: String(src ?? ""), alt: alt ?? "", ...props }),
+}));
+
+vi.mock("next/navigation", () => ({
+  usePathname: () => "/",
+  useRouter: () => ({
+    push: vi.fn(),
+    replace: vi.fn(),
+    refresh: vi.fn(),
+    back: vi.fn(),
+    forward: vi.fn(),
+    prefetch: vi.fn(),
+  }),
+  useSearchParams: () => new URLSearchParams(),
+  useParams: () => ({}),
+  redirect: vi.fn(),
+  notFound: vi.fn(),
+}));
+
+vi.mock("next-intl", () => ({
+  useTranslations: () => {
+    const t = (key: string) => key;
+    t.rich = (key: string) => key;
+    t.markup = (key: string) => key;
+    t.raw = (key: string) => key;
+    return t;
+  },
+  useLocale: () => "de",
+  useFormatter: () => ({
+    dateTime: (v: Date) => v.toISOString(),
+    number: (v: number) => String(v),
+    relativeTime: (v: unknown) => String(v),
+  }),
+  useMessages: () => ({}),
+  NextIntlClientProvider: ({ children }: { children?: React.ReactNode }) =>
+    React.createElement(React.Fragment, null, children),
+}));
@@ -0,0 +1,117 @@
+import { MediaKind, MediaSource, MediaUsageType, PortfolioSectionType } from "@prisma/client";
+
+import { prisma } from "@/lib/prisma";
+
+let counter = 0;
+function uniq(prefix: string) {
+  counter += 1;
+  return `${prefix}-${counter}`;
+}
+
+export function createCategory(overrides: Record<string, unknown> = {}) {
+  const slug = (overrides.slug as string) ?? uniq("cat");
+  return prisma.category.create({
+    data: {
+      slug,
+      nameAr: "الاسم",
+      nameEn: "Name",
+      nameDe: "Name",
+      descriptionAr: "وصف",
+      descriptionEn: "Description",
+      descriptionDe: "Beschreibung",
+      sortOrder: 0,
+      isActive: true,
+      ...overrides,
+    },
+  });
+}
+
+export async function createProject(overrides: Record<string, unknown> = {}) {
+  const categoryId = (overrides.categoryId as string) ?? (await createCategory()).id;
+  const isPublished = (overrides.isPublished as boolean) ?? true;
+  const slug = (overrides.slug as string) ?? uniq("proj");
+  return prisma.portfolioProject.create({
+    data: {
+      categoryId,
+      slug,
+      viewMode: "GRID",
+      titleAr: "عنوان",
+      titleEn: "Title",
+      titleDe: "Titel",
+      summaryAr: "ملخص",
+      summaryEn: "Summary",
+      summaryDe: "Zusammenfassung",
+      clientName: "Client",
+      projectYear: 2025,
+      serviceLabelAr: "خدمة",
+      serviceLabelEn: "Service",
+      serviceLabelDe: "Service",
+      isFeatured: false,
+      sortOrder: 0,
+      ...overrides,
+      isPublished,
+      publishedAt: isPublished ? new Date() : null,
+    },
+  });
+}
+
+export function createSection(projectId: string, overrides: Record<string, unknown> = {}) {
+  return prisma.portfolioSection.create({
+    data: {
+      projectId,
+      type: PortfolioSectionType.RICH_TEXT,
+      titleAr: "ع",
+      titleEn: "t",
+      titleDe: "t",
+      bodyAr: "ب",
+      bodyEn: "b",
+      bodyDe: "b",
+      sortOrder: 0,
+      ...overrides,
+    },
+  });
+}
+
+export function createAsset(projectId: string, overrides: Record<string, unknown> = {}) {
+  return prisma.portfolioAsset.create({
+    data: {
+      projectId,
+      kind: "IMAGE",
+      filePath: "/uploads/media/assets/x.svg",
+      altAr: "ع",
+      altEn: "a",
+      altDe: "a",
+      sortOrder: 0,
+      ...overrides,
+    },
+  });
+}
+
+export function createMediaAsset(overrides: Record<string, unknown> = {}) {
+  return prisma.mediaAsset.create({
+    data: {
+      source: MediaSource.EXTERNAL,
+      kind: MediaKind.IMAGE,
+      url: (overrides.url as string) ?? `https://cdn.example.com/${uniq("img")}.png`,
+      fileName: "img.png",
+      label: "Image",
+      ...overrides,
+    },
+  });
+}
+
+export function createMediaUsage(
+  assetId: string,
+  overrides: Record<string, unknown> = {},
+) {
+  return prisma.mediaUsage.create({
+    data: {
+      assetId,
+      usageType: MediaUsageType.GENERIC,
+      entityType: "test-entity",
+      entityId: "e1",
+      fieldKey: uniq("field"),
+      ...overrides,
+    },
+  });
+}
@@ -0,0 +1,23 @@
+import { mkdirSync, unlinkSync, writeFileSync } from "fs";
+import path from "path";
+
+import { MEDIA_UPLOAD_ROOT } from "@/lib/media-storage";
+
+/**
+ * Some sandboxed / read-only-mount environments allow writes but forbid `unlink`.
+ * Filesystem round-trip tests that create AND delete managed media files self-skip
+ * when deletion isn't permitted, so the suite stays green there while still running
+ * fully on a normal filesystem (developer machine / CI).
+ */
+export const canManageUploads: boolean = (() => {
+  try {
+    const dir = path.join(MEDIA_UPLOAD_ROOT, "tests");
+    mkdirSync(dir, { recursive: true });
+    const probe = path.join(dir, `.cap-probe-${process.pid}-${Date.now()}`);
+    writeFileSync(probe, "probe");
+    unlinkSync(probe);
+    return true;
+  } catch {
+    return false;
+  }
+})();
@@ -0,0 +1,35 @@
+import { readFileSync, readdirSync } from "fs";
+import path from "path";
+
+/**
+ * Global integration setup.
+ *
+ * Only needed when running against a real Postgres via TEST_DATABASE_URL: reset the
+ * schema and apply every migration once before the workers start. When
+ * TEST_DATABASE_URL is not set, each worker spins up its own in-process PGlite database
+ * (see tests/helpers/integration-setup.ts) and this is a no-op.
+ */
+
+const MIGRATIONS_DIR = path.resolve(process.cwd(), "prisma", "migrations");
+
+export default async function setup() {
+  const connectionString = process.env.TEST_DATABASE_URL?.trim();
+  if (!connectionString) {
+    return;
+  }
+
+  const pg = (await import("pg")).default;
+  const client = new pg.Client({ connectionString });
+  await client.connect();
+  try {
+    await client.query("DROP SCHEMA IF EXISTS public CASCADE; CREATE SCHEMA public;");
+    const dirs = readdirSync(MIGRATIONS_DIR)
+      .filter((entry) => /^\d/.test(entry))
+      .sort();
+    for (const dir of dirs) {
+      await client.query(readFileSync(path.join(MIGRATIONS_DIR, dir, "migration.sql"), "utf8"));
+    }
+  } finally {
+    await client.end();
+  }
+}
@@ -0,0 +1,69 @@
+import { readFileSync, readdirSync } from "fs";
+import path from "path";
+
+import { afterAll, beforeEach, vi } from "vitest";
+
+/**
+ * Integration database wiring.
+ *
+ *  - If TEST_DATABASE_URL is set, the real `lib/prisma` singleton is used unchanged,
+ *    pointed at that Postgres (e.g. the Docker instance). Migrations are applied once
+ *    by the global setup; files run serially and truncate between tests.
+ *
+ *  - Otherwise, `lib/prisma` is mocked with a Prisma client backed by an in-process
+ *    PGlite database (Postgres compiled to WASM) — real Postgres semantics, fully
+ *    isolated per worker, no external server. Production code is never modified.
+ */
+
+const realDbUrl = process.env.TEST_DATABASE_URL?.trim();
+if (realDbUrl) {
+  process.env.DATABASE_URL = realDbUrl;
+}
+
+vi.mock("@/lib/prisma", async () => {
+  if (process.env.TEST_DATABASE_URL?.trim()) {
+    return await vi.importActual<typeof import("@/lib/prisma")>("@/lib/prisma");
+  }
+
+  const { PGlite } = await import("@electric-sql/pglite");
+  const { PrismaPGlite } = await import("pglite-prisma-adapter");
+  const { PrismaClient } = await import("@prisma/client");
+
+  const db = await PGlite.create();
+  const migrationsDir = path.resolve(process.cwd(), "prisma", "migrations");
+  const dirs = readdirSync(migrationsDir)
+    .filter((entry) => /^\d/.test(entry))
+    .sort();
+  for (const dir of dirs) {
+    await db.exec(readFileSync(path.join(migrationsDir, dir, "migration.sql"), "utf8"));
+  }
+
+  const prisma = new PrismaClient({ adapter: new PrismaPGlite(db) });
+  return { prisma };
+});
+
+const { prisma } = await import("@/lib/prisma");
+
+// Truncated in dependency order (children first) between every test for isolation.
+const TABLES = [
+  "MediaUsage",
+  "MediaAsset",
+  "PortfolioAsset",
+  "PortfolioSection",
+  "PortfolioProject",
+  "Category",
+  "AppConfig",
+];
+
+export async function resetDb() {
+  const list = TABLES.map((table) => `"${table}"`).join(", ");
+  await prisma.$executeRawUnsafe(`TRUNCATE TABLE ${list} RESTART IDENTITY CASCADE;`);
+}
+
+beforeEach(async () => {
+  await resetDb();
+});
+
+afterAll(async () => {
+  await prisma.$disconnect();
+});
@@ -0,0 +1,67 @@
+import { vi } from "vitest";
+
+/**
+ * Shared mocks for the Next.js runtime pieces that server actions depend on.
+ * Action tests wire these in with `vi.mock(...)` at the top of each file, e.g.:
+ *
+ *   vi.mock("next/navigation", async () => ({
+ *     redirect: (await import("@/tests/helpers/next-mocks")).redirect,
+ *   }));
+ */
+
+export class RedirectError extends Error {
+  readonly digest = "NEXT_REDIRECT";
+  readonly __isRedirect = true;
+  constructor(public url: string) {
+    super(`NEXT_REDIRECT:${url}`);
+  }
+}
+
+export function redirect(url: string): never {
+  throw new RedirectError(url);
+}
+
+export function isRedirectError(error: unknown): error is RedirectError {
+  return (
+    error instanceof RedirectError ||
+    (typeof error === "object" && error !== null && (error as { __isRedirect?: boolean }).__isRedirect === true)
+  );
+}
+
+export const revalidatePath = vi.fn();
+
+export const adminAuth = { authenticated: true };
+export const clearAdminSessionCookie = vi.fn(async () => {});
+export async function isAdminAuthenticated(): Promise<boolean> {
+  return adminAuth.authenticated;
+}
+
+/** Run an action and return the URL it redirected to (or throw if it didn't). */
+export async function captureRedirect(run: () => Promise<unknown>): Promise<string> {
+  try {
+    await run();
+  } catch (error) {
+    if (isRedirectError(error)) {
+      return error.url;
+    }
+    throw error;
+  }
+  throw new Error("Expected the action to redirect, but it returned normally.");
+}
+
+export function resetNextMocks() {
+  revalidatePath.mockClear();
+  clearAdminSessionCookie.mockClear();
+  adminAuth.authenticated = true;
+}
+
+/** Build a FormData from a flat record (strings and Files). */
+export function formDataFrom(fields: Record<string, string | File | undefined>): FormData {
+  const formData = new FormData();
+  for (const [key, value] of Object.entries(fields)) {
+    if (value !== undefined) {
+      formData.set(key, value);
+    }
+  }
+  return formData;
+}