@nodefony/frontend 10.0.0-beta.4 → 10.0.0-beta.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -291,7 +291,8 @@ let FrontendService = class FrontendService extends Service {
291
291
  target: () => helper.devTarget(),
292
292
  websocket: true,
293
293
  methods: ["GET", "HEAD"],
294
- stripHeaders: ["cookie", "authorization"]
294
+ stripHeaders: ["cookie", "authorization"],
295
+ accessLog: "errors"
295
296
  });
296
297
  }
297
298
  /**
@@ -1,5 +1,5 @@
1
1
  import { createRequire } from "node:module";
2
- import { Nodefony, PLATFORM_EVENTS, escapeRegExp } from "nodefony";
2
+ import { Nodefony, PLATFORM_EVENTS, RequestContext, escapeRegExp, isPlainObject } from "nodefony";
3
3
  import path from "node:path";
4
4
  import fs from "node:fs";
5
5
  // nodefony/src/template/TemplateHelper.ts
@@ -18,6 +18,31 @@ function basePathOf(status) {
18
18
  * (`nodefony/debugbar`). `undefined` = pas encore tenté, `null` = irrésolu.
19
19
  */
20
20
  let debugbarFile;
21
+ const isStringArray = (v) => Array.isArray(v) && v.every((x) => typeof x === "string");
22
+ /**
23
+ * Lit la forme d'un `manifest.json` de Vite relu sur disque : un objet dont chaque
24
+ * valeur porte au moins `file`.
25
+ *
26
+ * Une entrée mal formée est écartée — elle rendrait une balise sans fichier ; un
27
+ * document qui n'est pas un objet rend `null`, traité comme un manifeste ABSENT
28
+ * (jamais caché, donc relu au rendu suivant).
29
+ *
30
+ * @param value - le JSON parsé, de forme inconnue.
31
+ * @returns le manifeste réduit aux champs lus par le rendu, ou `null`.
32
+ */
33
+ function toViteManifest(value) {
34
+ if (!isPlainObject(value)) return null;
35
+ const manifest = {};
36
+ for (const [key, raw] of Object.entries(value)) {
37
+ if (!isPlainObject(raw) || typeof raw.file !== "string") continue;
38
+ const chunk = { file: raw.file };
39
+ if (typeof raw.isEntry === "boolean") chunk.isEntry = raw.isEntry;
40
+ if (isStringArray(raw.css)) chunk.css = raw.css;
41
+ if (isStringArray(raw.imports)) chunk.imports = raw.imports;
42
+ manifest[key] = chunk;
43
+ }
44
+ return manifest;
45
+ }
21
46
  /** Marqueur optionnel dans l'`index.html` du module où injecter les tags. */
22
47
  const FRONTEND_MARKER = "<!--nodefony:frontend-->";
23
48
  /** Échappe une string pour usage littéral dans une RegExp. */
@@ -163,10 +188,10 @@ window.$RefreshSig$ = () => (type) => type;
163
188
  window.__vite_plugin_react_preamble_installed__ = true;
164
189
  <\/script>`);
165
190
  tags.push(`<script type="module"${n} src="${baseUrl}/@vite/client"><\/script>`);
166
- tags.push(`<script type="module"${n} src="${entryUrl}"><\/script>`);
167
- tags.push(this.hmrBridgeTag(baseUrl, n));
168
191
  const dbg = this.debugBarTag(baseUrl, entry.type, entryName, n);
169
192
  if (dbg) tags.push(dbg);
193
+ tags.push(`<script type="module"${n} src="${entryUrl}"><\/script>`);
194
+ tags.push(this.hmrBridgeTag(baseUrl, n));
170
195
  return tags.join("\n");
171
196
  }
172
197
  /**
@@ -210,13 +235,15 @@ try {
210
235
  if (!debugbarFile) return `<!-- @nodefony/frontend: debugbar unresolved -->`;
211
236
  const norm = debugbarFile.replace(/\\/g, "/");
212
237
  const fsUrl = `${baseUrl}${norm.startsWith("/") ? `/@fs${norm}` : `/@fs/${norm}`}`;
238
+ const requestId = RequestContext.getRequestId();
213
239
  const opts = JSON.stringify({
214
240
  frontend: {
215
241
  framework,
216
242
  name: entryName,
217
243
  viteOrigin: baseUrl
218
244
  },
219
- env: Nodefony.getKernel()?.environment ?? ""
245
+ env: Nodefony.getKernel()?.environment ?? "",
246
+ ...requestId ? { page: { requestId } } : {}
220
247
  });
221
248
  return `<script type="module"${nonceAttr}>
222
249
  import { mountDebugBar } from ${JSON.stringify(fsUrl)};
@@ -263,8 +290,8 @@ mountDebugBar(${opts});
263
290
  let parsed = null;
264
291
  for (const rel of [".vite/manifest.json", "manifest.json"]) try {
265
292
  const raw = fs.readFileSync(path.join(outDir, rel), "utf8");
266
- parsed = JSON.parse(raw);
267
- break;
293
+ parsed = toViteManifest(JSON.parse(raw));
294
+ if (parsed !== null) break;
268
295
  } catch {}
269
296
  if (parsed !== null) this.manifestCache.set(outDir, parsed);
270
297
  return parsed;
package/docs/index.md CHANGED
@@ -690,6 +690,33 @@ Ce qui est injecté en développement (`TemplateHelper.renderDevTags()`, `Templa
690
690
  Quand Vite n'est pas prêt, le rendu ne lève **jamais** : il renvoie un commentaire HTML disant
691
691
  l'état. Une page dégradée reste une page.
692
692
 
693
+ ### Une route profonde, et la touche F5
694
+
695
+ Ton application monopage navigue côté navigateur : `/commandes/42` n'est qu'un état de l'écran. Mais
696
+ au premier chargement — un lien partagé, un F5 —, c'est le **serveur** qui reçoit ce chemin, et sans
697
+ route qui rende la page il répond 404. Le contrôleur de la page doit donc servir aussi les chemins
698
+ profonds, par une route de **repli** :
699
+
700
+ ```ts ignore
701
+ // Dans le contrôleur qui rend la page (AppController d'une application générée)
702
+ @route("route-app-commandes", {
703
+ path: "/commandes/*",
704
+ method: "GET",
705
+ fallback: true,
706
+ })
707
+ renderDeep(): unknown {
708
+ return this.renderApp();
709
+ }
710
+ ```
711
+
712
+ `fallback: true` range la route **après toutes les autres** (`Route.ts#RouteOptions.fallback`) : une
713
+ route d'API de même forme, déclarée par n'importe quel module, garde la priorité — voir
714
+ [l'ordre de résolution](../../framework/docs/routing.md#-ordre-de-résolution--trois-situations).
715
+ Deux détails : `/commandes/*` n'attrape pas `/commandes` lui-même (la barre oblique est requise),
716
+ qui demande sa propre route ; et un repli à la **racine** (`/*`) transformerait toute faute de
717
+ frappe — une URL d'API, un fichier absent — en page HTML servie en 200. Borne le repli aux
718
+ préfixes de ton application.
719
+
693
720
  ### Les helpers de vue
694
721
 
695
722
  Si tu rends une vue Eta plutôt qu'une chaîne, trois helpers sont déjà dans tes variables locales
@@ -903,6 +930,10 @@ apparaisse avant le « prêt ».
903
930
  | `Refused to load the script` (politique de sécurité) | page rendue avant que Vite soit prêt : le fragment de développement n'est pas encore déclaré | recharger une fois Vite prêt ; vérifier que le nonce est bien propagé |
904
931
  | Commentaire `prod manifest missing` dans la page | les bundles n'ont pas été construits, et Vite n'était pas là pour le faire au démarrage | `npm run build` (ou `npx nodefony frontend:build`) puis **recharge la page** — l'absence de manifeste n'est jamais mise en cache (`loadManifest()`, `TemplateHelper.ts#TemplateHelper.loadManifest`), le serveur voit le build sans redémarrer |
905
932
  | Les assets répondent 404 en production | le serveur statique est absent ou le préfixe ne correspond pas | vérifier le montage journalisé au démarrage, et `publicPath` |
933
+ | Après un `frontend:build` lancé serveur démarré, la page demande des fichiers en 404 | un manifeste TROUVÉ est gardé pour toute la vie du processus (`loadManifest()`, `TemplateHelper.ts#TemplateHelper.loadManifest`), et le build vide le dossier de sortie : la page désigne des fichiers effacés | redémarrer après tout build en production ; en déploiement réel, le build se fait à l'image, avant le démarrage |
934
+ | Après un redéploiement, un onglet resté ouvert casse au changement d'écran (`Failed to fetch dynamically imported module`) | il demande les morceaux de la génération précédente, dont les noms hachés n'existent plus | écouter l'événement `vite:preloadError` et recharger la page **une** fois, avec une garde anti-boucle — ce que fait la console d'administration (`staleChunk.ts#lazyRoute`) |
935
+ | Un import hors du dossier front est refusé par Vite (403) | le serveur de développement n'ouvre que le dossier de l'application, la racine de chaque entrée et la barre de débogage (`ViteConfigGenerator.toMjs()`, `ViteConfigGenerator.ts#ViteConfigGenerator.toMjs`) | placer la ressource sous l'une de ces racines |
936
+ | F5 sur une page profonde de l'application rend 404 | aucune route serveur ne rend la page pour ce chemin | une route de repli — voir [Une route profonde, et la touche F5](#une-route-profonde-et-la-touche-f5) |
906
937
  | Un module à interface est invisible de `listEntries()` | il est en mode `static` — il n'appelle jamais `registerEntry` | attendu ; regarder la molette `ui` et le mode journalisé au démarrage |
907
938
  | Modifications du front sans effet | `vite.config.generated.mjs` édité à la main | ne jamais l'éditer : il est réécrit à chaque démarrage |
908
939
  | Angular recharge la page entière au lieu du composant | son greffon ne fait pas de remplacement à chaud | attendu — c'est le comportement du greffon Angular |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nodefony/frontend",
3
- "version": "10.0.0-beta.4",
3
+ "version": "10.0.0-beta.5",
4
4
  "description": "Construction et rechargement à chaud des frontends de chaque module Nodefony — Vite intégré, multi-framework (React, Vue, Angular, Svelte)",
5
5
  "author": "Christophe CAMENSULI <ccamensuli@gmail.com>",
6
6
  "type": "module",
@@ -36,18 +36,18 @@
36
36
  "esm"
37
37
  ],
38
38
  "peerDependencies": {
39
- "@nodefony/framework": "^10.0.0-beta.4",
40
- "@nodefony/http": "^10.0.0-beta.4",
41
- "nodefony": "^10.0.0-beta.4",
39
+ "@nodefony/framework": "^10.0.0-beta.5",
40
+ "@nodefony/http": "^10.0.0-beta.5",
41
+ "nodefony": "^10.0.0-beta.5",
42
42
  "zod": "^4.6.7"
43
43
  },
44
44
  "devDependencies": {
45
- "@nodefony/framework": "^10.0.0-beta.4",
46
- "@nodefony/http": "^10.0.0-beta.4",
45
+ "@nodefony/framework": "^10.0.0-beta.5",
46
+ "@nodefony/http": "^10.0.0-beta.5",
47
47
  "@types/chai": "5.2.3",
48
48
  "@types/node": "26.6.5",
49
49
  "@vitest/coverage-v8": "5.0.5",
50
- "nodefony": "^10.0.0-beta.4",
50
+ "nodefony": "^10.0.0-beta.5",
51
51
  "vite": "8.3.5",
52
52
  "vitest": "5.0.5"
53
53
  },