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

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.
Files changed (37) hide show
  1. package/README.md +38 -50
  2. package/dist/_virtual/{_@oxc-project_runtime@0.152.0 → _@oxc-project_runtime@0.155.0}/helpers/esm/decorate.js +1 -2
  3. package/dist/index.js +4 -6
  4. package/dist/nodefony/command/frontend-build.js +5 -3
  5. package/dist/nodefony/command/frontend-dev.js +5 -3
  6. package/dist/nodefony/command/frontend-status.js +5 -3
  7. package/dist/nodefony/config/config.js +4 -10
  8. package/dist/nodefony/config/defineModuleConfig.js +1 -2
  9. package/dist/nodefony/service/FrontendService.js +75 -299
  10. package/dist/nodefony/service/ViteConfigGenerator.js +12 -32
  11. package/dist/nodefony/service/ViteProcessSupervisor.js +18 -14
  12. package/dist/nodefony/service/bootSummary.js +43 -0
  13. package/dist/nodefony/src/FrontendAdminApi.js +1 -2
  14. package/dist/nodefony/src/builders/ViteBuilder.js +1 -2
  15. package/dist/nodefony/src/errors/FrontendError.js +1 -2
  16. package/dist/nodefony/src/isolationGroups.js +28 -34
  17. package/dist/nodefony/src/presets/angular-vite.js +1 -2
  18. package/dist/nodefony/src/presets/react19-vite.js +1 -2
  19. package/dist/nodefony/src/presets/svelte5-vite.js +1 -2
  20. package/dist/nodefony/src/presets/vanilla-vite.js +1 -2
  21. package/dist/nodefony/src/presets/vue3-vite.js +1 -2
  22. package/dist/nodefony/src/template/TemplateHelper.js +54 -22
  23. package/dist/types/nodefony/config/config.d.ts +0 -8
  24. package/dist/types/nodefony/interfaces/IFrontBuilder.d.ts +0 -9
  25. package/dist/types/nodefony/interfaces/IFrontendService.d.ts +6 -10
  26. package/dist/types/nodefony/interfaces/IViteSupervisor.d.ts +11 -5
  27. package/dist/types/nodefony/service/FrontendService.d.ts +24 -118
  28. package/dist/types/nodefony/service/ViteConfigGenerator.d.ts +13 -21
  29. package/dist/types/nodefony/service/ViteProcessSupervisor.d.ts +13 -16
  30. package/dist/types/nodefony/service/bootSummary.d.ts +23 -0
  31. package/dist/types/nodefony/src/isolationGroups.d.ts +24 -23
  32. package/dist/types/nodefony/src/template/TemplateHelper.d.ts +23 -7
  33. package/docs/index.md +210 -182
  34. package/package.json +13 -13
  35. package/dist/_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/decorateMetadata.js +0 -6
  36. package/dist/nodefony/src/remoteDev.js +0 -216
  37. package/dist/types/nodefony/src/remoteDev.d.ts +0 -152
@@ -10,17 +10,18 @@ import type { IResolvedFrontendEntry } from "../interfaces/IFrontBuilder.js";
10
10
  */
11
11
  export interface ViteConfigGeneratorOptions {
12
12
  /**
13
- * Origine du serveur Nodefony pour le proxy Vite (`server.proxy`).
14
- * Exemple : `"http://127.0.0.1:5151"`. En dev uniquement — ignoré en prod.
13
+ * Chemin de base Vite en développement — `/_vite/<famille>/`
14
+ * (`devBasePath`). Émis comme `base` : Vite préfixe alors TOUTES ses URLs
15
+ * (modules, assets, `url()` CSS, socket HMR), et Nodefony relaie ce préfixe
16
+ * vers le serveur Vite.
15
17
  */
16
- readonly backendOrigin?: string | undefined;
18
+ readonly devBase?: string | undefined;
17
19
  /**
18
- * Origine publique du dev server Vite — ex `"http://127.0.0.1:5173"`.
19
- * Définie comme `base` dans Vite, ce qui force les imports internes du
20
- * source transformé (ex `/src/App.tsx`) à devenir absolus
21
- * (`http://host:port/src/App.tsx`). Sans ça, une page rendue par
22
- * Nodefony (5151) qui charge `/src/main.tsx` voit ses imports résolus
23
- * contre 5151 → 404. Active aussi `strictPort` pour garantir l'origine.
20
+ * @deprecated Utiliser {@link ViteConfigGeneratorOptions.devBase}. Vite
21
+ * réduit un `base` absolu à son seul chemin en développement
22
+ * (`resolveBaseUrl`) : cette origine n'a jamais rendu aucune URL absolue.
23
+ * Sans effet : `strictPort`, qu'elle activait, est désormais toujours posé
24
+ * en développement.
24
25
  */
25
26
  readonly viteOrigin?: string | undefined;
26
27
  /**
@@ -32,23 +33,14 @@ export interface ViteConfigGeneratorOptions {
32
33
  readonly keyPath: string;
33
34
  readonly certPath: string;
34
35
  } | undefined;
35
- /**
36
- * Hôtes acceptés dans le header `Host` (`server.allowedHosts`, Vite ≥6).
37
- * `true` = tous. Un motif `.suffixe` couvre le domaine et ses sous-domaines.
38
- * Les IP et `localhost` sont toujours acceptés par Vite — cette liste ne
39
- * sert que les NOMS (vhosts, `host.docker.internal`, forwarders).
40
- */
41
- readonly allowedHosts?: true | ReadonlyArray<string> | undefined;
42
36
  }
43
37
  export declare class ViteConfigGenerator {
44
38
  /**
45
39
  * Construit le content `.mjs` à écrire à côté de `index.html` du module.
46
40
  *
47
- * Si `opts.backendOrigin` est fourni en mode `development`, agrège les
48
- * `apiProxyPaths` de toutes les entries et génère un `server.proxy` qui
49
- * forward chaque préfixe vers le backend Nodefony. Sans ça, les fetch
50
- * relatifs depuis l'app servie par Vite atterrissent sur Vite et reçoivent
51
- * un SPA-fallback HTML (cause classique de `Unexpected token '<'`).
41
+ * Aucun `server.proxy` : la page est rendue par Nodefony et ses appels d'API
42
+ * partent sur sa propre origine ; Vite ne reçoit que ce que le relais
43
+ * `/_vite/<famille>/` lui transmet (#528).
52
44
  */
53
45
  toMjs(entries: ReadonlyArray<IResolvedFrontendEntry>, mode: "development" | "production", opts?: ViteConfigGeneratorOptions): string;
54
46
  }
@@ -1,5 +1,15 @@
1
1
  import type { IViteSupervisor, IViteSupervisorStatus } from "../interfaces/IViteSupervisor.js";
2
2
  import type { IResolvedFrontendEntry } from "../interfaces/IFrontBuilder.js";
3
+ /**
4
+ * Hôte JOIGNABLE pour une adresse d'écoute : `0.0.0.0`/`::` désignent toutes
5
+ * les interfaces, pas une destination — s'y connecter échoue sous Windows. Le
6
+ * superviseur, sa sonde et le proxy inverse joignent Vite depuis la machine
7
+ * qui le lance : la boucle locale est alors toujours juste.
8
+ *
9
+ * @param listenHost - adresse d'écoute (`devHost`)
10
+ * @returns l'hôte à joindre
11
+ */
12
+ export declare function browserReachableHost(listenHost: string): string;
3
13
  /**
4
14
  * Logger minimal — injecté par FrontendService pour piper les logs Vite
5
15
  * dans le syslog Nodefony sans dépendance dure sur Service.
@@ -13,27 +23,14 @@ export interface ViteSupervisorOptions {
13
23
  readonly devHost: string;
14
24
  readonly devPort: number;
15
25
  /**
16
- * Template d'origine PUBLIQUE du dev server (P14.17) — `{port}` substitué au
17
- * port RÉEL de chaque spawn (suit les retries de port). Vide/absent = dérivé
18
- * de `devHost:port`. Dissocie ce que Vite ÉCOUTE de ce que le navigateur
19
- * APPELLE (forwarder Codespaces/Gitpod, `host.docker.internal`, remap).
26
+ * Chemin de base Vite de l'instance (`devBasePath(famille)`) — émis comme
27
+ * `base` dans la config générée, rendu par `status().base`.
20
28
  */
21
- readonly publicOriginTemplate?: string | undefined;
22
- /**
23
- * Hôtes que Vite doit accepter dans le header `Host` (`server.allowedHosts`).
24
- * `true` = tous. Dérivé par FrontendService de la liste `trustedHosts` http —
25
- * jamais maintenu ici (1 règle = 1 implémentation).
26
- */
27
- readonly allowedHosts?: true | ReadonlyArray<string> | undefined;
29
+ readonly devBase?: string | undefined;
28
30
  readonly startupTimeoutMs: number;
29
31
  readonly pipeLogs: boolean;
30
32
  readonly cwd: string;
31
33
  readonly logger: IViteSupervisorLogger;
32
- /**
33
- * Origine du serveur Nodefony pour `server.proxy` côté Vite — ex `"http://127.0.0.1:5151"`.
34
- * Quand fourni, les paths `apiProxyPaths` des entries sont proxifiés vers ce backend.
35
- */
36
- readonly backendOrigin?: string;
37
34
  /**
38
35
  * Certificats à utiliser si Vite doit servir en HTTPS. Paths absolus vers les
39
36
  * fichiers PEM — les mêmes que Nodefony utilise pour son `server-https` (5152).
@@ -0,0 +1,23 @@
1
+ import type { IBootNotice } from "nodefony";
2
+ import type { IViteSupervisorStatus } from "../interfaces/IViteSupervisor.js";
3
+ /** Ce que le frontend dit au bilan de démarrage. */
4
+ export interface IFrontendBootSummary {
5
+ /** Instances Vite réellement prêtes. */
6
+ ready: number;
7
+ /**
8
+ * Une ligne par instance : les bundles qu'elle sert et son port INTERNE
9
+ * (`react, studio · Vite interne :5173`) — jamais présenté comme une adresse
10
+ * à ouvrir : Vite passe derrière Nodefony, on ouvre l'application.
11
+ */
12
+ lines: string[];
13
+ /** Le point d'attention à déclarer, ou `null` si tout est servi. */
14
+ notice: IBootNotice | null;
15
+ }
16
+ /**
17
+ * Résume les instances Vite pour le bilan de démarrage — fonction PURE (les
18
+ * statuts sont lus par l'appelant), éprouvable sans lancer Vite.
19
+ *
20
+ * @param statuses - l'état de chaque superviseur Vite, après démarrage.
21
+ * @returns lignes de détail, nombre d'instances prêtes, point d'attention.
22
+ */
23
+ export declare function summarizeFrontendBoot(statuses: readonly IViteSupervisorStatus[]): IFrontendBootSummary;
@@ -37,6 +37,30 @@
37
37
  * partager une instance, une clé dédiée pour ce qui doit être isolé).
38
38
  */
39
39
  export declare function isolationGroup(type: string): string;
40
+ /**
41
+ * Espace d'URL réservé aux serveurs Vite de développement, sur l'origine de
42
+ * Nodefony. Chaque famille y a son sous-préfixe (cf {@link devBasePath}).
43
+ */
44
+ export declare const DEV_BASE_ROOT = "/_vite/";
45
+ /**
46
+ * Chemin de base Vite d'une famille en développement (`/_vite/<famille>/`).
47
+ *
48
+ * Vite fabrique ses URLs d'assets RELATIVES AU DOCUMENT : une image importée
49
+ * devient `/<base>/src/logo.png`, que le navigateur résout contre l'origine de
50
+ * la page — servie par Nodefony, pas par Vite. Un préfixe réservé rend ces
51
+ * URLs reconnaissables : Nodefony les relaie (307) vers le serveur Vite, sans
52
+ * collision possible avec les routes de l'application. Un préfixe PAR famille,
53
+ * parce que chaque famille a son instance Vite, sur son port : le relais doit
54
+ * savoir vers laquelle renvoyer.
55
+ *
56
+ * `base` est l'option que Vite honore partout — dev classique, dev bundlé,
57
+ * socket HMR, `@vitejs/plugin-vue`, publicDir —, contrairement à
58
+ * `server.origin`, ignoré en mode bundlé.
59
+ *
60
+ * @param family - clé de famille ({@link isolationGroup})
61
+ * @returns le chemin, `/` en tête et en fin
62
+ */
63
+ export declare function devBasePath(family: string): string;
40
64
  /**
41
65
  * Famille servie sur le port de base (`devPort`). Les autres familles prennent
42
66
  * les blocs de ports suivants. Garder `default` ici garantit que l'instance
@@ -64,26 +88,3 @@ export declare function orderFamilies(families: ReadonlyArray<string>): string[]
64
88
  * @returns map ordonnée `famille → port de base de son bloc`.
65
89
  */
66
90
  export declare function familyPortPlan(devPort: number, families: ReadonlyArray<string>, portRetryAttempts: number): Map<string, number>;
67
- /**
68
- * Bloc de ports de chaque famille : tous les ports que SON instance Vite peut
69
- * prendre, port-retry compris.
70
- *
71
- * Le plan seul ne dit que le port ESPÉRÉ ; sur `EADDRINUSE` le superviseur
72
- * glisse dans son bloc. Un CSP construit sur le seul port espéré laisse la page
73
- * sans rechargement à chaud dès que le port de base est pris — et il l'est dès
74
- * qu'un second projet tourne sur la machine.
75
- *
76
- * Rendu par famille, et non à plat : le consommateur remplace le bloc d'une
77
- * famille par son port RÉEL dès qu'il est connu. Déclarer les douze ports d'un
78
- * poste à trois familles coûte un en-tête CSP de ~8 Ko sur chaque réponse
79
- * (mesuré) — la plage est le prix d'une incertitude, elle ne doit pas survivre
80
- * à sa levée.
81
- *
82
- * Dérivé du plan plutôt que recalculé depuis `devPort` : la règle des blocs
83
- * disjoints n'est écrite qu'à un endroit, `familyPortPlan`.
84
- *
85
- * @param plan - `famille → port de base`, tel que rendu par `familyPortPlan`.
86
- * @param portRetryAttempts - tentatives de port-retry par instance (bloc = +1).
87
- * @returns `famille → ports du bloc`, croissants.
88
- */
89
- export declare function familyPortBlocks(plan: ReadonlyMap<string, number>, portRetryAttempts: number): Map<string, number[]>;
@@ -27,18 +27,34 @@ export declare class TemplateHelper {
27
27
  * prod émises ; `""` = origine Nodefony (chemins relatifs).
28
28
  */
29
29
  constructor(supervisor: IViteSupervisor | null, mode: "development" | "production", entries?: ReadonlyArray<IResolvedFrontendEntry>, assetBaseUrl?: string);
30
+ /**
31
+ * Origine LOCALE du serveur Vite — la cible du proxy inverse que Nodefony
32
+ * monte sur `/_vite/<famille>/` (#528). Jamais annoncée au navigateur : la
33
+ * page ne connaît que sa propre origine, Vite reste sur la boucle locale.
34
+ *
35
+ * 🔴 Seul un Vite qui SERT (`ready`, `compiling`) est une cible. Un port
36
+ * retenu par une instance tombée ou en redémarrage peut avoir été repris
37
+ * par le Vite d'une AUTRE application de la machine (même préfixe
38
+ * `/_vite/<famille>/`) : relayer vers lui servirait les sources de l'autre
39
+ * application à cette page. Le superviseur quitte `ready` dès l'`exit` de
40
+ * son processus — avant qu'un autre ne puisse reprendre le port.
41
+ *
42
+ * @returns l'origine (`http://127.0.0.1:5173`), ou `undefined` sans
43
+ * superviseur, tant que Vite n'a pas résolu son port, ou quand il ne sert
44
+ * pas (amont pas prêt : le relais répond `503`, avant tout `101` pour la
45
+ * socket — le client Vite ne recharge la page qu'une fois Vite revenu)
46
+ */
47
+ devTarget(): string | undefined;
30
48
  /**
31
49
  * Tags à injecter dans `<head>` (ou avant `</body>`) pour une entrée donnée.
50
+ * En développement, toutes les URLs vers Vite sont relatives à la page
51
+ * (`/_vite/<famille>/…`) : Nodefony les relaie, la page n'a qu'une origine.
52
+ *
32
53
  * @param entryName nom logique de l'entrée (matche `entryName` dans IResolvedFrontendEntry)
33
54
  * @param nonce nonce CSP de la requête (`Context.cspNonce`) — posé sur les `<script>`
34
55
  * pour satisfaire `script-src 'nonce-…'` (preamble inline dev + entrée prod).
35
- * @param requestHost nom d'hôte par lequel le client a demandé la PAGE
36
- * (`Context.domain`, sans port). Dev : l'origine des assets est réécrite
37
- * sur ce nom (scheme et port restent ceux de Vite) → poste et conteneur
38
- * servis par la même instance. Prod : **ignoré** — les URLs du manifest
39
- * sont relatives au document, elles suivent déjà l'hôte de la page.
40
56
  */
41
- renderTags(entryName: string, nonce?: string, requestHost?: string): string;
57
+ renderTags(entryName: string, nonce?: string): string;
42
58
  /**
43
59
  * Document HTML complet pour une entrée : lit l'`index.html` du module (le dev
44
60
  * y met SES meta/polices/scripts externes), retire le `<script type=module>`
@@ -48,7 +64,7 @@ export declare class TemplateHelper {
48
64
  *
49
65
  * @param entryName nom logique de l'entrée
50
66
  */
51
- renderDocument(entryName: string, nonce?: string, requestHost?: string): string;
67
+ renderDocument(entryName: string, nonce?: string): string;
52
68
  /** Injecte `tags` dans `html` (marqueur > `</head>` > `</body>` > append). */
53
69
  private injectIntoHtml;
54
70
  /**