@mostajs/mjs-unit 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+@mostajs/mjs-unit
+Copyright (C) 2026 Dr Hamid MADANI <drmdh@msn.com>
+
+SPDX-License-Identifier: AGPL-3.0-or-later
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+The complete text of the GNU Affero General Public License version 3 is
+available at the URL above and must accompany any distribution of this
+software.

package/README.md

@@ -0,0 +1,138 @@
+# @mostajs/mjs-unit
+
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com> · **Licence** : AGPL-3.0-or-later
+
+Micro-framework de test **zéro dépendance** pour l'écosystème `@mostajs/*`. Trois apports :
+
+1. **API minimale** : `test()`, `describe()`, `expect()` + assertions (`ok`, `equal`, `deepEqual`, `throwsAsync`, `doesNotThrowAsync`).
+2. **Runner CLI** (`mjs-unit <fichiers>`) : importe les fichiers de test, exécute, affiche un rapport, code de sortie ≠ 0 si échec.
+3. **Resolver ESM** : exécute sous Node les `dist/` à imports **sans extension** (convention `moduleResolution: bundler` des modules @mostajs) — sans ce resolver, `node` échoue sur `import './x'`.
+
+## Installation
+
+```bash
+npm i -D @mostajs/mjs-unit
+# module local non publié : npm i -D "@mostajs/mjs-unit@file:../chemin/mosta-mjs-unit"
+```
+
+## How to use (pas à pas, dans n'importe quelle application)
+
+1. **Installer** le module en devDependency (voir ci-dessus).
+2. **Créer** un dossier `test-scripts/` et y écrire des fichiers `*.test.mjs`
+   (un test = `test(name, fn)` ; ne pas appeler `run()`, le runner s'en charge).
+3. **Versionner** un runner `test-scripts/run-tests.sh` qui (re)bâtit puis lance le CLI.
+4. **Brancher** `package.json` : `"scripts": { "test": "bash test-scripts/run-tests.sh" }`.
+5. **Lancer** : `npm test` (code de sortie ≠ 0 si un test échoue → utilisable en CI).
+
+```js
+// test-scripts/api.test.mjs — test d'unité + test web, dans la même suite
+import { test, equal, ok } from "@mostajs/mjs-unit";
+import { createHttpTester, waitForEvent } from "@mostajs/mjs-unit/web";
+import { app } from "../dist/app.js";            // votre app Express / handler natif
+
+const api = createHttpTester(app);
+
+test("GET /healthz → 200", async () => {
+  const res = await api.get("/healthz");
+  equal(res.status, 200);
+  ok(res.body.status === "ok");
+});
+```
+
+```bash
+# test-scripts/run-tests.sh
+#!/usr/bin/env bash
+set -euo pipefail
+cd "$(dirname "$0")/.."
+npm run build >/dev/null
+node node_modules/@mostajs/mjs-unit/bin/cli.mjs test-scripts/*.test.mjs
+```
+
+> Besoin d'un profil d'environnement (DB de test, secrets…) avant d'importer le
+> `dist/` ? Fixez-le **avant** les imports via un import dynamique :
+> `process.env.APP_ENV = "TEST"; const { app } = await import("../dist/app.js");`
+> (les `import` statiques sont hoistés, donc exécutés avant le code du module).
+
+## Écrire un test (`test-scripts/mon.test.mjs`)
+
+```js
+import { test, expect, ok } from "@mostajs/mjs-unit";
+import { maFonction } from "../dist/lib/ma-fonction.js"; // le dist peut avoir des imports sans extension
+
+test("addition", () => expect(maFonction(2, 2)).toBe(4));
+test("async", async () => { ok(await maFonction.async()); });
+```
+
+> Ne pas appeler `run()` dans le fichier : le **runner** s'en charge (les cas enregistrés via `test()` sont exécutés groupés par fichier).
+
+## Lancer
+
+```bash
+mjs-unit test-scripts/*.test.mjs          # via le bin
+# ou, programmatique :
+node --import @mostajs/mjs-unit/register test-scripts/mon.test.mjs   # + appeler run() soi-même
+```
+
+Runner versionné conseillé (`test-scripts/run-tests.sh`) :
+
+```bash
+#!/usr/bin/env bash
+set -euo pipefail
+cd "$(dirname "$0")/.."
+npm run build >/dev/null
+node node_modules/@mostajs/mjs-unit/bin/cli.mjs test-scripts/*.test.mjs
+```
+
+## API
+
+| Fonction | Rôle |
+|---|---|
+| `test(name, fn)` / `test.skip(...)` | Enregistre un cas (sync ou async) |
+| `describe(group, body)` | Préfixe les cas du groupe |
+| `expect(v).toBe/toEqual/toBeTruthy/toBeFalsy/toContain` | Assertions fluides |
+| `ok/equal/deepEqual(...)` | Assertions directes |
+| `throwsAsync/doesNotThrowAsync(fn)` | Vérifie qu'une promesse (ne) lève (pas) |
+| `run(label?)` | Exécute les cas en attente → `{passed, failed, skipped}` (appelé par le CLI) |
+
+Zéro dépendance runtime ; `@types/node` en dev uniquement.
+
+## Tests web (`@mostajs/mjs-unit/web`)
+
+Moteur **générique** pour tester des applications HTTP et événementielles — sans
+`supertest`, `jest` ni client socket dans le framework. Toujours **zéro
+dépendance** (uniquement `node:http`/`node:net`).
+
+| Fonction | Rôle |
+|---|---|
+| `startServer(target)` | Démarre un serveur HTTP éphémère (port 0) autour d'un `http.Server`, d'un `RequestListener` ou d'une app Express → `{ url, port, close() }` |
+| `createHttpTester(target)` | Client HTTP façon supertest : `get/post/put/del/request` → `{ status, headers, body }`. `target` = URL d'un serveur démarré **ou** handler/serveur (éphémère par requête) |
+| `waitForEvent(emitter, name, { timeout })` | Attend un événement sur tout émetteur (`EventEmitter`, client Socket.io, `ws`…) — teste le temps réel |
+
+```js
+import { test, equal, ok } from "@mostajs/mjs-unit";
+import { createHttpTester, startServer, waitForEvent } from "@mostajs/mjs-unit/web";
+
+// HTTP : éphémère par requête (app Express ou handler natif (req,res)=>…)
+const api = createHttpTester(app);
+test("login", async () => {
+  const res = await api.post("/login", { username: "admin", password: "admin" });
+  equal(res.status, 200);
+  ok(res.body.token);
+});
+
+// Temps réel : serveur durable + attente d'événement (ex. Socket.io)
+test("push", async () => {
+  const srv = await startServer(httpServer);          // serveur partagé
+  const client = ioClient(srv.url);                   // socket.io-client fourni par l'app
+  const received = waitForEvent(client, "new_ticket");
+  await createHttpTester(srv.url).post("/api/tickets", { serviceType: "general" });
+  const evt = await received;
+  ok(evt.ticket);
+  client.close();
+  await srv.close();
+});
+```
+
+> Le client socket (`socket.io-client`, `ws`…) reste fourni par l'application :
+> mjs-unit ne l'embarque pas, pour préserver le zéro-dépendance. `waitForEvent`
+> fonctionne avec n'importe quel émetteur exposant `on` (idéalement `once`/`off`).

package/bin/cli.mjs

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+/**
+ * @mostajs/mjs-unit — runner CLI. Active le resolver (imports sans extension), importe les fichiers
+ * de test passés en argument (chacun enregistre ses cas via `test()`), puis exécute.
+ * Usage : mjs-unit <fichier-de-test...>   (ex. mjs-unit test-scripts/*.test.mjs)
+ * @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+ */
+import { register } from "node:module";
+import { pathToFileURL } from "node:url";
+
+register(new URL("../loader.mjs", import.meta.url));
+const { run, pending } = await import("../dist/index.js");
+
+const files = process.argv.slice(2);
+if (!files.length) { console.error("usage: mjs-unit <fichier-de-test...>"); process.exit(2); }
+
+let totalFail = 0;
+for (const f of files) {
+  await import(pathToFileURL(f).href);     // le fichier enregistre ses cas (et peut appeler run() lui-même)
+  if (pending() > 0) {                       // sinon, on exécute les cas restants groupés par fichier
+    const r = await run(f);
+    totalFail += r.failed;
+  }
+}
+if (totalFail > 0) process.exitCode = 1;

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @mostajs/mjs-unit — micro-framework de test (zéro dépendance).
+ * API : `test(name, fn)` enregistre un cas ; `expect(v)` / helpers d'assertion ; `run()` exécute,
+ * affiche un rapport et positionne `process.exitCode`. Pensé pour l'écosystème @mostajs/* (ESM pur).
+ *
+ * @author Dr Hamid MADANI <drmdh@msn.com>
+ * @license AGPL-3.0-or-later
+ */
+export interface TestCase {
+    name: string;
+    fn: () => void | Promise<void>;
+    skip?: boolean;
+}
+/** Enregistre un test (exécuté par `run()`). */
+export declare function test(name: string, fn: () => void | Promise<void>): void;
+export declare namespace test {
+    var skip: (name: string, fn: () => void | Promise<void>) => void;
+}
+/** Groupe logique (préfixe les noms). */
+export declare function describe(group: string, body: () => void): void;
+export declare function ok(cond: unknown, message?: string): void;
+export declare function equal(actual: unknown, expected: unknown, message?: string): void;
+export declare function deepEqual(actual: unknown, expected: unknown, message?: string): void;
+export declare function throwsAsync(fn: () => Promise<unknown>, message?: string): Promise<void>;
+export declare function doesNotThrowAsync(fn: () => Promise<unknown>, message?: string): Promise<void>;
+/** API fluide : `expect(x).toBe(y)`, `.toEqual(obj)`, `.toBeTruthy()`, `.toContain(s)`. */
+export declare function expect(actual: unknown): {
+    toBe: (e: unknown, m?: string) => void;
+    toEqual: (e: unknown, m?: string) => void;
+    toBeTruthy: (m?: string) => void;
+    toBeFalsy: (m?: string) => void;
+    toContain: (sub: string, m?: string) => void;
+};
+export interface RunResult {
+    passed: number;
+    failed: number;
+    skipped: number;
+}
+/** Exécute les tests enregistrés, affiche le rapport, positionne `process.exitCode` si échec. */
+export declare function run(label?: string): Promise<RunResult>;
+/** Nombre de tests en attente (diagnostic). */
+export declare function pending(): number;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,QAAQ;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE;AAI1F,gDAAgD;AAChD,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAEvE;yBAFe,IAAI;qBAID,MAAM,MAAM,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAG,IAAI;;AAEhE,yCAAyC;AACzC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,GAAG,IAAI,CAI9D;AAMD,wBAAgB,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,SAAiB,GAAG,IAAI,CAEhE;AACD,wBAAgB,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAEhF;AACD,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAEpF;AACD,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,SAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGrG;AACD,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,SAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAElH;AAED,2FAA2F;AAC3F,wBAAgB,MAAM,CAAC,MAAM,EAAE,OAAO;cAExB,OAAO,MAAM,MAAM;iBAChB,OAAO,MAAM,MAAM;qBACf,MAAM;oBACP,MAAM;qBACL,MAAM,MAAM,MAAM;EAEtC;AAGD,MAAM,WAAW,SAAS;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AAE9E,iGAAiG;AACjG,wBAAsB,GAAG,CAAC,KAAK,SAAK,GAAG,OAAO,CAAC,SAAS,CAAC,CAYxD;AAED,+CAA+C;AAC/C,wBAAgB,OAAO,IAAI,MAAM,CAA0B"}

package/dist/index.js

@@ -0,0 +1,101 @@
+/**
+ * @mostajs/mjs-unit — micro-framework de test (zéro dépendance).
+ * API : `test(name, fn)` enregistre un cas ; `expect(v)` / helpers d'assertion ; `run()` exécute,
+ * affiche un rapport et positionne `process.exitCode`. Pensé pour l'écosystème @mostajs/* (ESM pur).
+ *
+ * @author Dr Hamid MADANI <drmdh@msn.com>
+ * @license AGPL-3.0-or-later
+ */
+const _suite = [];
+/** Enregistre un test (exécuté par `run()`). */
+export function test(name, fn) {
+    _suite.push({ name, fn });
+}
+/** Test ignoré (compté à part). */
+test.skip = (name, fn) => { _suite.push({ name, fn, skip: true }); };
+/** Groupe logique (préfixe les noms). */
+export function describe(group, body) {
+    const start = _suite.length;
+    body();
+    for (let i = start; i < _suite.length; i++)
+        _suite[i].name = `${group} › ${_suite[i].name}`;
+}
+// ── Assertions ───────────────────────────────────────────────────────────────
+class AssertionError extends Error {
+    constructor(m) { super(m); this.name = "AssertionError"; }
+}
+const fmt = (v) => { try {
+    return typeof v === "string" ? v : JSON.stringify(v);
+}
+catch {
+    return String(v);
+} };
+export function ok(cond, message = "valeur falsy") {
+    if (!cond)
+        throw new AssertionError(message);
+}
+export function equal(actual, expected, message) {
+    if (actual !== expected)
+        throw new AssertionError(message ?? `attendu ${fmt(expected)}, reçu ${fmt(actual)}`);
+}
+export function deepEqual(actual, expected, message) {
+    if (JSON.stringify(actual) !== JSON.stringify(expected))
+        throw new AssertionError(message ?? `attendu ${fmt(expected)}, reçu ${fmt(actual)}`);
+}
+export async function throwsAsync(fn, message = "devait lever") {
+    try {
+        await fn();
+    }
+    catch {
+        return;
+    }
+    throw new AssertionError(message);
+}
+export async function doesNotThrowAsync(fn, message = "ne devait pas lever") {
+    try {
+        await fn();
+    }
+    catch (e) {
+        throw new AssertionError(`${message} : ${e?.message}`);
+    }
+}
+/** API fluide : `expect(x).toBe(y)`, `.toEqual(obj)`, `.toBeTruthy()`, `.toContain(s)`. */
+export function expect(actual) {
+    return {
+        toBe: (e, m) => equal(actual, e, m),
+        toEqual: (e, m) => deepEqual(actual, e, m),
+        toBeTruthy: (m) => ok(actual, m),
+        toBeFalsy: (m) => ok(!actual, m ?? "attendu falsy"),
+        toContain: (sub, m) => ok(typeof actual === "string" && actual.includes(sub), m ?? `« ${fmt(actual)} » ne contient pas « ${sub} »`),
+    };
+}
+/** Exécute les tests enregistrés, affiche le rapport, positionne `process.exitCode` si échec. */
+export async function run(label = "") {
+    let passed = 0, failed = 0, skipped = 0;
+    if (label)
+        console.log(`\n▶ ${label}`);
+    for (const t of _suite) {
+        if (t.skip) {
+            console.log(`  ⊘ ${t.name} (ignoré)`);
+            skipped++;
+            continue;
+        }
+        try {
+            await t.fn();
+            console.log(`  ✓ ${t.name}`);
+            passed++;
+        }
+        catch (e) {
+            console.log(`  ✗ ${t.name}\n      ${e?.message ?? e}`);
+            failed++;
+        }
+    }
+    console.log(`\n${failed === 0 ? "✅" : "❌"} ${passed} passé(s), ${failed} échoué(s)${skipped ? `, ${skipped} ignoré(s)` : ""}`);
+    if (failed > 0 && typeof process !== "undefined")
+        process.exitCode = 1;
+    _suite.length = 0; // réinitialise pour un éventuel run suivant
+    return { passed, failed, skipped };
+}
+/** Nombre de tests en attente (diagnostic). */
+export function pending() { return _suite.length; }
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,MAAM,GAAe,EAAE,CAAC;AAE9B,gDAAgD;AAChD,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,EAA8B;IAC/D,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;AAC5B,CAAC;AACD,mCAAmC;AACnC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAY,EAAE,EAA8B,EAAQ,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAE/G,yCAAyC;AACzC,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,IAAgB;IACtD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5B,IAAI,EAAE,CAAC;IACP,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,KAAK,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC9F,CAAC;AAED,gFAAgF;AAChF,MAAM,cAAe,SAAQ,KAAK;IAAG,YAAY,CAAS,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC,CAAC,CAAC;CAAE;AACzG,MAAM,GAAG,GAAG,CAAC,CAAU,EAAE,EAAE,GAAG,IAAI,CAAC;IAAC,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAAC,CAAC;AAAC,MAAM,CAAC;IAAC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AAAC,CAAC,CAAC,CAAC,CAAC;AAE1H,MAAM,UAAU,EAAE,CAAC,IAAa,EAAE,OAAO,GAAG,cAAc;IACxD,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;AAC/C,CAAC;AACD,MAAM,UAAU,KAAK,CAAC,MAAe,EAAE,QAAiB,EAAE,OAAgB;IACxE,IAAI,MAAM,KAAK,QAAQ;QAAE,MAAM,IAAI,cAAc,CAAC,OAAO,IAAI,WAAW,GAAG,CAAC,QAAQ,CAAC,UAAU,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAChH,CAAC;AACD,MAAM,UAAU,SAAS,CAAC,MAAe,EAAE,QAAiB,EAAE,OAAgB;IAC5E,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,cAAc,CAAC,OAAO,IAAI,WAAW,GAAG,CAAC,QAAQ,CAAC,UAAU,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAChJ,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAA0B,EAAE,OAAO,GAAG,cAAc;IACpF,IAAI,CAAC;QAAC,MAAM,EAAE,EAAE,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO;IAAC,CAAC;IACrC,MAAM,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,EAA0B,EAAE,OAAO,GAAG,qBAAqB;IACjG,IAAI,CAAC;QAAC,MAAM,EAAE,EAAE,CAAC;IAAC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QAAC,MAAM,IAAI,cAAc,CAAC,GAAG,OAAO,MAAO,CAAW,EAAE,OAAO,EAAE,CAAC,CAAC;IAAC,CAAC;AACtG,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,MAAM,CAAC,MAAe;IACpC,OAAO;QACL,IAAI,EAAE,CAAC,CAAU,EAAE,CAAU,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QACrD,OAAO,EAAE,CAAC,CAAU,EAAE,CAAU,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5D,UAAU,EAAE,CAAC,CAAU,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;QACzC,SAAS,EAAE,CAAC,CAAU,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,eAAe,CAAC;QAC5D,SAAS,EAAE,CAAC,GAAW,EAAE,CAAU,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,GAAG,CAAC,MAAM,CAAC,wBAAwB,GAAG,IAAI,CAAC;KACrJ,CAAC;AACJ,CAAC;AAKD,iGAAiG;AACjG,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,KAAK,GAAG,EAAE;IAClC,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC;IACxC,IAAI,KAAK;QAAE,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC;YAAC,OAAO,EAAE,CAAC;YAAC,SAAS;QAAC,CAAC;QAC3E,IAAI,CAAC;YAAC,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC;YAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAAC,MAAM,EAAE,CAAC;QAAC,CAAC;QAC7D,OAAO,CAAC,EAAE,CAAC;YAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,WAAY,CAAW,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;YAAC,MAAM,EAAE,CAAC;QAAC,CAAC;IAC5F,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,cAAc,MAAM,aAAa,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/H,IAAI,MAAM,GAAG,CAAC,IAAI,OAAO,OAAO,KAAK,WAAW;QAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,4CAA4C;IAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACrC,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,OAAO,KAAa,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC"}

package/dist/web.d.ts

@@ -0,0 +1,104 @@
+/**
+ * @mostajs/mjs-unit/web — extension de test web (zéro dépendance).
+ *
+ * Moteur générique pour tester des applications HTTP et événementielles sans
+ * tirer supertest, jest ou socket.io-client dans le framework lui-même :
+ *
+ *  - `startServer(target)` : démarre un serveur HTTP éphémère (port 0) autour
+ *    d'un `http.Server`, d'un `RequestListener` ou d'une app Express
+ *    (`(req,res) => …`). Rend `{ url, port, close() }`. Utile quand le test a
+ *    besoin d'un serveur durable (ex. connexion WebSocket/Socket.io).
+ *  - `createHttpTester(target)` : client HTTP générique façon supertest.
+ *    `target` peut être une URL de base (serveur déjà démarré) OU un
+ *    handler/serveur (un serveur éphémère est alors ouvert puis fermé à CHAQUE
+ *    requête). Méthodes `get/post/put/del/request` → `{ status, headers, body }`.
+ *  - `waitForEvent(emitter, name, opts)` : attend un événement sur n'importe
+ *    quel émetteur compatible (`EventEmitter`, client Socket.io, `ws`…) avec
+ *    garde-fou de délai. Permet de tester le temps réel sans dépendance.
+ *
+ * S'appuie uniquement sur les modules natifs `node:http`/`node:net`. Aucune
+ * dépendance ajoutée : conforme à la philosophie zéro-dép de @mostajs/mjs-unit.
+ *
+ * @author Dr Hamid MADANI <drmdh@msn.com>
+ * @license AGPL-3.0-or-later
+ */
+import type { IncomingHttpHeaders, Server, RequestListener } from "node:http";
+/** Cible acceptée : serveur HTTP déjà construit, ou handler de requêtes (app Express). */
+export type ServerTarget = Server | RequestListener;
+/** Serveur de test démarré sur un port éphémère. */
+export interface TestServer {
+    /** URL de base, ex. `http://127.0.0.1:54123`. */
+    url: string;
+    /** Port effectif attribué par l'OS. */
+    port: number;
+    /** Le serveur Node sous-jacent. */
+    server: Server;
+    /** Ferme le serveur (idempotent). */
+    close(): Promise<void>;
+}
+/**
+ * Démarre `target` sur `127.0.0.1:0` (port libre) et résout quand il écoute.
+ * `close()` ne ferme le serveur que si mjs-unit l'a lui-même créé à partir d'un
+ * handler (un `http.Server` fourni par l'appelant reste sous sa responsabilité).
+ */
+export declare function startServer(target: ServerTarget): Promise<TestServer>;
+/** Réponse normalisée d'une requête de test. */
+export interface TestResponse {
+    /** Code de statut HTTP. */
+    status: number;
+    /** En-têtes de réponse. */
+    headers: IncomingHttpHeaders;
+    /** Corps brut (texte). */
+    text: string;
+    /** Corps parsé en JSON si le contenu est du JSON valide ; sinon le texte. */
+    body: any;
+}
+/** Options d'une requête. */
+export interface RequestOptions {
+    /** Méthode HTTP (défaut : `GET`). */
+    method?: string;
+    /** En-têtes additionnels. */
+    headers?: Record<string, string>;
+    /**
+     * Corps de requête. Un objet est sérialisé en JSON avec
+     * `Content-Type: application/json` (sauf en-tête explicite). Une chaîne ou un
+     * `Buffer` est envoyé tel quel.
+     */
+    body?: unknown;
+}
+/** Client HTTP de test générique. */
+export interface HttpTester {
+    request(path: string, opts?: RequestOptions): Promise<TestResponse>;
+    get(path: string, opts?: RequestOptions): Promise<TestResponse>;
+    post(path: string, body?: unknown, opts?: RequestOptions): Promise<TestResponse>;
+    put(path: string, body?: unknown, opts?: RequestOptions): Promise<TestResponse>;
+    del(path: string, opts?: RequestOptions): Promise<TestResponse>;
+}
+/** Effectue une requête unique vers `baseUrl + path`. */
+export declare function fetchRequest(baseUrl: string, path: string, opts?: RequestOptions): Promise<TestResponse>;
+/**
+ * Construit un client HTTP de test.
+ *  - `target` = URL (`string`) : requêtes vers ce serveur déjà démarré ;
+ *  - `target` = handler/serveur : un serveur éphémère est ouvert puis fermé à
+ *    chaque requête (façon supertest, sans état partagé).
+ */
+export declare function createHttpTester(target: ServerTarget | string): HttpTester;
+/** Émetteur minimal compatible (EventEmitter, client Socket.io, ws…). */
+export interface MinimalEmitter {
+    once?(event: string, listener: (...args: any[]) => void): unknown;
+    on(event: string, listener: (...args: any[]) => void): unknown;
+    off?(event: string, listener: (...args: any[]) => void): unknown;
+    removeListener?(event: string, listener: (...args: any[]) => void): unknown;
+}
+/** Options de `waitForEvent`. */
+export interface WaitForEventOptions {
+    /** Délai maximal en millisecondes avant rejet (défaut : 4000). */
+    timeout?: number;
+}
+/**
+ * Résout avec la (première) charge utile du prochain événement `name`, ou
+ * rejette après `timeout`. Compatible avec tout émetteur exposant `on`
+ * (et idéalement `once`/`off`) : Socket.io, `ws`, `EventEmitter`…
+ */
+export declare function waitForEvent<T = any>(emitter: MinimalEmitter, name: string, opts?: WaitForEventOptions): Promise<T>;
+//# sourceMappingURL=web.d.ts.map

package/dist/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../src/web.ts"],"names":[],"mappings":"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"}

package/dist/web.js

@@ -0,0 +1,164 @@
+/**
+ * @mostajs/mjs-unit/web — extension de test web (zéro dépendance).
+ *
+ * Moteur générique pour tester des applications HTTP et événementielles sans
+ * tirer supertest, jest ou socket.io-client dans le framework lui-même :
+ *
+ *  - `startServer(target)` : démarre un serveur HTTP éphémère (port 0) autour
+ *    d'un `http.Server`, d'un `RequestListener` ou d'une app Express
+ *    (`(req,res) => …`). Rend `{ url, port, close() }`. Utile quand le test a
+ *    besoin d'un serveur durable (ex. connexion WebSocket/Socket.io).
+ *  - `createHttpTester(target)` : client HTTP générique façon supertest.
+ *    `target` peut être une URL de base (serveur déjà démarré) OU un
+ *    handler/serveur (un serveur éphémère est alors ouvert puis fermé à CHAQUE
+ *    requête). Méthodes `get/post/put/del/request` → `{ status, headers, body }`.
+ *  - `waitForEvent(emitter, name, opts)` : attend un événement sur n'importe
+ *    quel émetteur compatible (`EventEmitter`, client Socket.io, `ws`…) avec
+ *    garde-fou de délai. Permet de tester le temps réel sans dépendance.
+ *
+ * S'appuie uniquement sur les modules natifs `node:http`/`node:net`. Aucune
+ * dépendance ajoutée : conforme à la philosophie zéro-dép de @mostajs/mjs-unit.
+ *
+ * @author Dr Hamid MADANI <drmdh@msn.com>
+ * @license AGPL-3.0-or-later
+ */
+import http from "node:http";
+function asServer(target) {
+    if (typeof target === "function") {
+        return { server: http.createServer(target), owned: true };
+    }
+    return { server: target, owned: false };
+}
+/**
+ * Démarre `target` sur `127.0.0.1:0` (port libre) et résout quand il écoute.
+ * `close()` ne ferme le serveur que si mjs-unit l'a lui-même créé à partir d'un
+ * handler (un `http.Server` fourni par l'appelant reste sous sa responsabilité).
+ */
+export function startServer(target) {
+    const { server, owned } = asServer(target);
+    return new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(0, "127.0.0.1", () => {
+            server.removeListener("error", reject);
+            const { port } = server.address();
+            resolve({
+                url: `http://127.0.0.1:${port}`,
+                port,
+                server,
+                close: () => new Promise((res) => {
+                    if (!owned)
+                        return res();
+                    server.close(() => res());
+                }),
+            });
+        });
+    });
+}
+function encodeBody(body, headers) {
+    if (body === undefined || body === null)
+        return undefined;
+    if (typeof body === "string" || Buffer.isBuffer(body))
+        return body;
+    const hasType = Object.keys(headers).some((h) => h.toLowerCase() === "content-type");
+    if (!hasType)
+        headers["Content-Type"] = "application/json";
+    return JSON.stringify(body);
+}
+/** Effectue une requête unique vers `baseUrl + path`. */
+export function fetchRequest(baseUrl, path, opts = {}) {
+    const url = new URL(path, baseUrl);
+    const headers = { ...(opts.headers ?? {}) };
+    const payload = encodeBody(opts.body, headers);
+    return new Promise((resolve, reject) => {
+        const req = http.request({
+            hostname: url.hostname,
+            port: url.port,
+            path: url.pathname + url.search,
+            method: opts.method ?? "GET",
+            headers,
+        }, (res) => {
+            const chunks = [];
+            res.on("data", (c) => chunks.push(c));
+            res.on("end", () => {
+                const text = Buffer.concat(chunks).toString("utf8");
+                let parsed = text;
+                const type = String(res.headers["content-type"] ?? "");
+                if (type.includes("application/json") && text.length) {
+                    try {
+                        parsed = JSON.parse(text);
+                    }
+                    catch {
+                        /* garde le texte brut */
+                    }
+                }
+                resolve({
+                    status: res.statusCode ?? 0,
+                    headers: res.headers,
+                    text,
+                    body: parsed,
+                });
+            });
+        });
+        req.on("error", reject);
+        if (payload !== undefined)
+            req.write(payload);
+        req.end();
+    });
+}
+/**
+ * Construit un client HTTP de test.
+ *  - `target` = URL (`string`) : requêtes vers ce serveur déjà démarré ;
+ *  - `target` = handler/serveur : un serveur éphémère est ouvert puis fermé à
+ *    chaque requête (façon supertest, sans état partagé).
+ */
+export function createHttpTester(target) {
+    async function once(path, opts) {
+        if (typeof target === "string") {
+            return fetchRequest(target, path, opts);
+        }
+        const srv = await startServer(target);
+        try {
+            return await fetchRequest(srv.url, path, opts);
+        }
+        finally {
+            await srv.close();
+        }
+    }
+    return {
+        request: (path, opts = {}) => once(path, opts),
+        get: (path, opts = {}) => once(path, { ...opts, method: "GET" }),
+        post: (path, body, opts = {}) => once(path, { ...opts, method: "POST", body }),
+        put: (path, body, opts = {}) => once(path, { ...opts, method: "PUT", body }),
+        del: (path, opts = {}) => once(path, { ...opts, method: "DELETE" }),
+    };
+}
+/**
+ * Résout avec la (première) charge utile du prochain événement `name`, ou
+ * rejette après `timeout`. Compatible avec tout émetteur exposant `on`
+ * (et idéalement `once`/`off`) : Socket.io, `ws`, `EventEmitter`…
+ */
+export function waitForEvent(emitter, name, opts = {}) {
+    const timeout = opts.timeout ?? 4000;
+    return new Promise((resolve, reject) => {
+        const detach = () => {
+            if (typeof emitter.off === "function")
+                emitter.off(name, handler);
+            else if (typeof emitter.removeListener === "function")
+                emitter.removeListener(name, handler);
+        };
+        const handler = (...args) => {
+            clearTimeout(timer);
+            detach();
+            resolve(args.length <= 1 ? args[0] : args);
+        };
+        const timer = setTimeout(() => {
+            detach();
+            reject(new Error(`événement « ${name} » non reçu après ${timeout} ms`));
+        }, timeout);
+        if (typeof emitter.once === "function")
+            emitter.once(name, handler);
+        else
+            emitter.on(name, handler);
+    });
+}
+//# sourceMappingURL=web.js.map

package/dist/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../src/web.ts"],"names":[],"mappings":"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"}

package/llms.txt

@@ -0,0 +1,67 @@
+# @mostajs/mjs-unit — fiche LLM
+
+> Micro-framework de test ZÉRO DÉPENDANCE pour l'écosystème @mostajs/* : API test/expect, runner CLI,
+> et un resolver ESM qui exécute sous Node les dist à imports SANS extension (moduleResolution=bundler).
+
+- Version: 0.2.0 · Licence: AGPL-3.0-or-later · Auteur: Dr Hamid MADANI <drmdh@msn.com>
+- Chemin: mostajs/mosta-mjs-unit
+
+## RÔLE
+Permettre à chaque module @mostajs/* d'avoir des tests reproductibles et versionnés sans tirer jest/vitest.
+Résout aussi le point dur de l'écosystème : les `dist/` compilés en `moduleResolution: bundler` omettent
+les extensions `.js` des imports relatifs → non exécutables par `node` seul. Le resolver de mjs-unit
+réécrit `./x` → `./x.js` puis `./x/index.js`.
+
+## EXPORTS
+- `.` (dist/index.js) : test, test.skip, describe, expect, ok, equal, deepEqual, throwsAsync,
+  doesNotThrowAsync, run, pending ; type TestCase, RunResult.
+- `./web` (dist/web.js) : moteur de test web GÉNÉRIQUE, zéro dépendance (node:http/net) —
+  startServer, createHttpTester, fetchRequest, waitForEvent ; types TestServer, HttpTester,
+  TestResponse, RequestOptions, MinimalEmitter.
+- `./register` (register.mjs) : enregistre le resolver via `node --import`.
+- `./loader` (loader.mjs) : le hook `resolve` (pour usage avancé).
+- bin `mjs-unit` (bin/cli.mjs) : runner — active le resolver, importe les fichiers, exécute.
+
+## API
+- test(name, fn): void  // fn sync ou async ; enregistre un cas
+- test.skip(name, fn): void
+- describe(group, body): void  // préfixe les noms
+- expect(v): { toBe(e), toEqual(e), toBeTruthy(), toBeFalsy(), toContain(sub) }
+- ok(cond, msg?) · equal(a, e, msg?) · deepEqual(a, e, msg?)
+- throwsAsync(fn, msg?) · doesNotThrowAsync(fn, msg?)
+- run(label?): Promise<{passed, failed, skipped}>  // exécute les cas en attente ; exitCode=1 si échec
+- pending(): number
+
+## API — WEB (./web, générique, zéro dépendance)
+- startServer(target): Promise<TestServer>  // target = http.Server | RequestListener | app Express
+    → { url, port, server, close() } ; écoute sur 127.0.0.1:0 ; close() ne ferme que les serveurs créés par mjs-unit
+- createHttpTester(target): HttpTester  // target = URL string (serveur démarré) OU handler/serveur (éphémère/requête)
+    → request(path,opts?) / get / post(path,body?) / put / del → TestResponse { status, headers, text, body }
+      (body parsé JSON si content-type json ; objet en body → JSON + Content-Type auto)
+- fetchRequest(baseUrl, path, opts?): Promise<TestResponse>  // requête unique bas niveau
+- waitForEvent(emitter, name, {timeout=4000}?): Promise<payload>  // EventEmitter | socket.io-client | ws ;
+    résout 1er arg (ou tableau si plusieurs) ; rejette après timeout. NE PAS unref le timer (sortie node 13).
+
+## PATTERN
+```js
+// test-scripts/x.test.mjs — NE PAS appeler run() (le runner le fait)
+import { test, expect } from '@mostajs/mjs-unit'
+import { f } from '../dist/lib/f.js'   // imports sans extension du dist résolus par le loader
+test('f', () => expect(f(2)).toBe(4))
+```
+```bash
+# runner versionné : test-scripts/run-tests.sh
+npm run build >/dev/null
+node node_modules/@mostajs/mjs-unit/bin/cli.mjs test-scripts/*.test.mjs
+```
+
+## PIÈGES
+- Importer la racine d'un module @mostajs qui ré-exporte des composants React (ex. @mostajs/audit → AuditPage)
+  charge react/lucide-react. En test, importer par SOUS-CHEMINS (dist/lib/*.js) pour éviter ces peers.
+- Le runner exécute les cas en attente APRÈS import du fichier. Si le fichier appelle run() lui-même,
+  le runner ne ré-exécute pas (pending()===0). Choisir l'un ou l'autre.
+- Le resolver n'agit que sur les specifiers RELATIFS sans extension ; les packages (bare) passent normalement.
+
+## CONVENTION (écosystème)
+Tout test ET son runner (`run-tests.sh`) sont versionnés dans `test-scripts/` ; `package.json` `scripts.test`
+pointe sur le runner. Jamais de test jetable.

package/loader.mjs

@@ -0,0 +1,16 @@
+/**
+ * @mostajs/mjs-unit — resolver ESM. Rend exécutables sous Node les imports relatifs SANS extension
+ * (convention `moduleResolution: bundler` des modules @mostajs/* dont le `dist/` omet le `.js`).
+ * Stratégie : pour un specifier relatif sans extension connue, essayer `+.js` puis `/index.js`.
+ * @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+ */
+const HAS_EXT = /\.(m?js|cjs|json|node|wasm)$/i;
+
+export async function resolve(specifier, context, nextResolve) {
+  if (specifier.startsWith(".") && !HAS_EXT.test(specifier)) {
+    for (const cand of [specifier + ".js", specifier + "/index.js"]) {
+      try { return await nextResolve(cand, context); } catch { /* essai suivant */ }
+    }
+  }
+  return nextResolve(specifier, context);
+}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@mostajs/mjs-unit",
+  "version": "0.2.0",
+  "description": "Micro-framework de test pour l'écosystème @mostajs/* : zéro dépendance, API minimale (test/expect/run), runner CLI, et un resolver ESM qui exécute sous Node les dist à imports sans extension (convention moduleResolution=bundler).",
+  "author": "Dr Hamid MADANI <drmdh@msn.com>",
+  "license": "AGPL-3.0-or-later",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "mjs-unit": "bin/cli.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./web": {
+      "types": "./dist/web.d.ts",
+      "import": "./dist/web.js",
+      "default": "./dist/web.js"
+    },
+    "./register": {
+      "default": "./register.mjs"
+    },
+    "./loader": {
+      "default": "./loader.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "bin",
+    "loader.mjs",
+    "register.mjs",
+    "llms.txt",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "bash test-scripts/run-tests.sh"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "@types/node": "^22.0.0"
+  },
+  "keywords": [
+    "test",
+    "unit",
+    "esm",
+    "bundler",
+    "zero-dependency",
+    "mostajs"
+  ]
+}

package/register.mjs

@@ -0,0 +1,6 @@
+/**
+ * @mostajs/mjs-unit — enregistre le resolver. Usage : `node --import @mostajs/mjs-unit/register tests.mjs`.
+ * @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+ */
+import { register } from "node:module";
+register(new URL("./loader.mjs", import.meta.url));