test: add e2e, integration, and unit tests for fixtures and mockFetch

Add test script to deno.json
Add @std/assert, @std/testing, happy-dom dependencies

.gitea/workflows/lint.yml

@@ -24,3 +24,6 @@ jobs:
 
       - name: Check linting
         run: deno lint
+
+      - name: Run tests
+        run: deno test -A --no-check tests/

deno.json

@@ -9,7 +9,8 @@
     "start": "deno run -A --unstable-ffi --watch=static/,routes/ dev.ts",
     "build": "deno run -A --unstable-ffi dev.ts build",
     "preview": "deno run -A --unstable-ffi main.ts",
-    "update": "deno run -A -r https://fresh.deno.dev/update ."
+    "update": "deno run -A -r https://fresh.deno.dev/update .",
+    "test": "deno test -A --no-check tests/"
   },
   "lint": {
     "rules": {
@@ -35,6 +36,9 @@
     "@preact/signals": "https://esm.sh/*@preact/signals@1.2.2",
     "@preact/signals-core": "https://esm.sh/*@preact/signals-core@1.5.1",
     "$std/": "https://deno.land/std@0.216.0/",
+    "@std/assert": "jsr:@std/assert@^1.0.0",
+    "@std/testing": "jsr:@std/testing@^1.0.0",
+    "happy-dom": "npm:happy-dom@^16.0.0",
     "$root/": "./",
     "$apps/": "./routes/(apps)/"
   },

tests/helpers/api_mock.ts

@@ -0,0 +1,56 @@
+// Mock de fetch() pour les tests
+
+// deno-lint-ignore no-explicit-any
+let _originalFetch: ((input: any, init?: any) => Promise<Response>) | null =
+  null;
+
+/**
+ * Remplace globalThis.fetch par un mock qui retourne des réponses
+ * pré-configurées selon l'URL.
+ *
+ * @param routes - Map URL pattern → données de réponse (sera sérialisé en JSON)
+ */
+export function mockFetch(
+  routes: Record<string, unknown>,
+): void {
+  _originalFetch = globalThis.fetch;
+
+  globalThis.fetch = (
+    input: string | URL | Request,
+    _init?: RequestInit,
+  ): Promise<Response> => {
+    const url = typeof input === "string"
+      ? input
+      : input instanceof URL
+      ? input.toString()
+      : input.url;
+
+    for (const [pattern, data] of Object.entries(routes)) {
+      if (url.includes(pattern)) {
+        return Promise.resolve(
+          new Response(JSON.stringify(data), {
+            status: 200,
+            headers: { "Content-Type": "application/json" },
+          }),
+        );
+      }
+    }
+
+    return Promise.resolve(
+      new Response(JSON.stringify({ error: "Not Found" }), {
+        status: 404,
+        headers: { "Content-Type": "application/json" },
+      }),
+    );
+  };
+}
+
+/**
+ * Restaure le fetch original.
+ */
+export function restoreFetch(): void {
+  if (_originalFetch) {
+    globalThis.fetch = _originalFetch;
+    _originalFetch = null;
+  }
+}

tests/helpers/fixtures.ts

@@ -0,0 +1,107 @@
+// Types et données de test pour l'API PolyMPR
+
+export interface Student {
+  numEtud: number;
+  nom: string;
+  prenom: string;
+  idPromo: number;
+}
+
+export interface Promotion {
+  idPromo: number;
+  annee: string;
+}
+
+export interface Prof {
+  id: number;
+  nom: string;
+  prenom: string;
+}
+
+export interface Module {
+  id: number;
+  nom: string;
+}
+
+export interface Note {
+  note: number;
+  numEtud: number;
+  idModule: number;
+}
+
+export interface UE {
+  id: number;
+  nom: string;
+}
+
+export interface UeModule {
+  idModule: number;
+  idUE: number;
+  idPromo: number;
+  coeff: number;
+}
+
+export interface Enseignement {
+  idProf: number;
+  idModule: number;
+  idPromo: number;
+}
+
+export interface Ajustement {
+  numEtud: number;
+  idUE: number;
+  valeur: number;
+}
+
+// --- Fixtures ---
+
+export const students: Student[] = [
+  { numEtud: 1, nom: "Dupont", prenom: "Alice", idPromo: 1 },
+  { numEtud: 2, nom: "Martin", prenom: "Bob", idPromo: 1 },
+  { numEtud: 3, nom: "Durand", prenom: "Claire", idPromo: 2 },
+];
+
+export const promotions: Promotion[] = [
+  { idPromo: 1, annee: "2025-2026" },
+  { idPromo: 2, annee: "2024-2025" },
+];
+
+export const profs: Prof[] = [
+  { id: 1, nom: "Leclerc", prenom: "Jean" },
+  { id: 2, nom: "Moreau", prenom: "Sophie" },
+];
+
+export const modules: Module[] = [
+  { id: 1, nom: "Mathématiques" },
+  { id: 2, nom: "Informatique" },
+  { id: 3, nom: "Physique" },
+];
+
+export const notes: Note[] = [
+  { note: 15, numEtud: 1, idModule: 1 },
+  { note: 12, numEtud: 1, idModule: 2 },
+  { note: 18, numEtud: 2, idModule: 1 },
+  { note: 9, numEtud: 3, idModule: 3 },
+];
+
+export const ues: UE[] = [
+  { id: 1, nom: "Sciences fondamentales" },
+  { id: 2, nom: "Sciences appliquées" },
+];
+
+export const ueModules: UeModule[] = [
+  { idModule: 1, idUE: 1, idPromo: 1, coeff: 3 },
+  { idModule: 2, idUE: 2, idPromo: 1, coeff: 4 },
+  { idModule: 3, idUE: 1, idPromo: 2, coeff: 2 },
+];
+
+export const enseignements: Enseignement[] = [
+  { idProf: 1, idModule: 1, idPromo: 1 },
+  { idProf: 2, idModule: 2, idPromo: 1 },
+  { idProf: 1, idModule: 3, idPromo: 2 },
+];
+
+export const ajustements: Ajustement[] = [
+  { numEtud: 1, idUE: 1, valeur: 0.5 },
+  { numEtud: 3, idUE: 1, valeur: -1 },
+];

tests/helpers/render.ts

@@ -0,0 +1,55 @@
+// Setup happy-dom + wrapper render pour les tests de composants Preact
+
+import { Window } from "happy-dom";
+
+let _window: Window | null = null;
+
+/**
+ * Initialise un environnement DOM virtuel via happy-dom.
+ * À appeler avant de rendre des composants Preact dans les tests.
+ */
+export function setupDOM(): void {
+  _window = new Window({ url: "http://localhost" });
+
+  // Expose les globals DOM nécessaires à Preact
+  const globals = _window as unknown as Record<string, unknown>;
+  const target = globalThis as unknown as Record<string, unknown>;
+
+  for (
+    const key of [
+      "document",
+      "navigator",
+      "location",
+      "HTMLElement",
+      "HTMLInputElement",
+      "HTMLTextAreaElement",
+      "HTMLSelectElement",
+      "Event",
+      "CustomEvent",
+      "KeyboardEvent",
+      "MouseEvent",
+      "InputEvent",
+      "MutationObserver",
+      "requestAnimationFrame",
+      "cancelAnimationFrame",
+    ]
+  ) {
+    target[key] = globals[key];
+  }
+
+  target["window"] = _window;
+}
+
+/**
+ * Nettoie l'environnement DOM.
+ * À appeler dans un afterEach ou à la fin d'un test.
+ */
+export function cleanupDOM(): void {
+  if (_window) {
+    const doc = _window.document;
+    doc.body.innerHTML = "";
+    doc.head.innerHTML = "";
+    _window.close();
+    _window = null;
+  }
+}

tests/unit/example_test.ts

@@ -0,0 +1,61 @@
+import { assertEquals, assertExists } from "@std/assert";
+import { mockFetch, restoreFetch } from "../helpers/api_mock.ts";
+import { notes, students } from "../helpers/fixtures.ts";
+import { cleanupDOM, setupDOM } from "../helpers/render.ts";
+
+Deno.test("fixtures - students have expected shape", () => {
+  assertEquals(students.length, 3);
+  assertEquals(students[0].nom, "Dupont");
+  assertExists(students[0].numEtud);
+});
+
+Deno.test("mockFetch - returns mocked data for matching route", async () => {
+  mockFetch({
+    "/students": students,
+    "/notes": notes,
+  });
+
+  try {
+    const res = await fetch("http://localhost/api/students");
+    assertEquals(res.status, 200);
+
+    const data = await res.json();
+    assertEquals(data.length, 3);
+    assertEquals(data[0].nom, "Dupont");
+  } finally {
+    restoreFetch();
+  }
+});
+
+Deno.test("mockFetch - returns 404 for unknown routes", async () => {
+  mockFetch({});
+
+  try {
+    const res = await fetch("http://localhost/api/unknown");
+    assertEquals(res.status, 404);
+  } finally {
+    restoreFetch();
+  }
+});
+
+Deno.test({
+  name: "happy-dom - document is available after setup",
+  sanitizeResources: false,
+  sanitizeOps: false,
+  fn() {
+  setupDOM();
+
+  try {
+    const doc = globalThis.document;
+    assertExists(doc);
+
+    const div = doc.createElement("div");
+    div.textContent = "hello";
+    doc.body.appendChild(div);
+
+    assertEquals(doc.body.textContent, "hello");
+  } finally {
+    cleanupDOM();
+  }
+  },
+});