@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.
- package/README.md +38 -50
- package/dist/_virtual/{_@oxc-project_runtime@0.152.0 → _@oxc-project_runtime@0.155.0}/helpers/esm/decorate.js +1 -2
- package/dist/index.js +4 -6
- package/dist/nodefony/command/frontend-build.js +5 -3
- package/dist/nodefony/command/frontend-dev.js +5 -3
- package/dist/nodefony/command/frontend-status.js +5 -3
- package/dist/nodefony/config/config.js +4 -10
- package/dist/nodefony/config/defineModuleConfig.js +1 -2
- package/dist/nodefony/service/FrontendService.js +75 -299
- package/dist/nodefony/service/ViteConfigGenerator.js +12 -32
- package/dist/nodefony/service/ViteProcessSupervisor.js +18 -14
- package/dist/nodefony/service/bootSummary.js +43 -0
- package/dist/nodefony/src/FrontendAdminApi.js +1 -2
- package/dist/nodefony/src/builders/ViteBuilder.js +1 -2
- package/dist/nodefony/src/errors/FrontendError.js +1 -2
- package/dist/nodefony/src/isolationGroups.js +28 -34
- package/dist/nodefony/src/presets/angular-vite.js +1 -2
- package/dist/nodefony/src/presets/react19-vite.js +1 -2
- package/dist/nodefony/src/presets/svelte5-vite.js +1 -2
- package/dist/nodefony/src/presets/vanilla-vite.js +1 -2
- package/dist/nodefony/src/presets/vue3-vite.js +1 -2
- package/dist/nodefony/src/template/TemplateHelper.js +54 -22
- package/dist/types/nodefony/config/config.d.ts +0 -8
- package/dist/types/nodefony/interfaces/IFrontBuilder.d.ts +0 -9
- package/dist/types/nodefony/interfaces/IFrontendService.d.ts +6 -10
- package/dist/types/nodefony/interfaces/IViteSupervisor.d.ts +11 -5
- package/dist/types/nodefony/service/FrontendService.d.ts +24 -118
- package/dist/types/nodefony/service/ViteConfigGenerator.d.ts +13 -21
- package/dist/types/nodefony/service/ViteProcessSupervisor.d.ts +13 -16
- package/dist/types/nodefony/service/bootSummary.d.ts +23 -0
- package/dist/types/nodefony/src/isolationGroups.d.ts +24 -23
- package/dist/types/nodefony/src/template/TemplateHelper.d.ts +23 -7
- package/docs/index.md +210 -182
- package/package.json +13 -13
- package/dist/_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/decorateMetadata.js +0 -6
- package/dist/nodefony/src/remoteDev.js +0 -216
- 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
|
-
*
|
|
14
|
-
*
|
|
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
|
|
18
|
+
readonly devBase?: string | undefined;
|
|
17
19
|
/**
|
|
18
|
-
*
|
|
19
|
-
*
|
|
20
|
-
*
|
|
21
|
-
*
|
|
22
|
-
*
|
|
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
|
-
*
|
|
48
|
-
*
|
|
49
|
-
*
|
|
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
|
-
*
|
|
17
|
-
*
|
|
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
|
|
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
|
|
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
|
|
67
|
+
renderDocument(entryName: string, nonce?: string): string;
|
|
52
68
|
/** Injecte `tags` dans `html` (marqueur > `</head>` > `</body>` > append). */
|
|
53
69
|
private injectIntoHtml;
|
|
54
70
|
/**
|