@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
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@nodefony/frontend",
|
|
3
|
-
"version": "10.0.0-beta.
|
|
3
|
+
"version": "10.0.0-beta.4",
|
|
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,24 +36,24 @@
|
|
|
36
36
|
"esm"
|
|
37
37
|
],
|
|
38
38
|
"peerDependencies": {
|
|
39
|
-
"@nodefony/framework": "^10.0.0-beta.
|
|
40
|
-
"@nodefony/http": "^10.0.0-beta.
|
|
41
|
-
"nodefony": "^10.0.0-beta.
|
|
42
|
-
"zod": "^4.6.
|
|
39
|
+
"@nodefony/framework": "^10.0.0-beta.4",
|
|
40
|
+
"@nodefony/http": "^10.0.0-beta.4",
|
|
41
|
+
"nodefony": "^10.0.0-beta.4",
|
|
42
|
+
"zod": "^4.6.7"
|
|
43
43
|
},
|
|
44
44
|
"devDependencies": {
|
|
45
|
-
"@nodefony/framework": "^10.0.0-beta.
|
|
46
|
-
"@nodefony/http": "^10.0.0-beta.
|
|
45
|
+
"@nodefony/framework": "^10.0.0-beta.4",
|
|
46
|
+
"@nodefony/http": "^10.0.0-beta.4",
|
|
47
47
|
"@types/chai": "5.2.3",
|
|
48
|
-
"@types/node": "26.6.
|
|
49
|
-
"@vitest/coverage-v8": "5.0.
|
|
50
|
-
"nodefony": "^10.0.0-beta.
|
|
51
|
-
"vite": "8.3.
|
|
52
|
-
"vitest": "5.0.
|
|
48
|
+
"@types/node": "26.6.5",
|
|
49
|
+
"@vitest/coverage-v8": "5.0.5",
|
|
50
|
+
"nodefony": "^10.0.0-beta.4",
|
|
51
|
+
"vite": "8.3.5",
|
|
52
|
+
"vitest": "5.0.5"
|
|
53
53
|
},
|
|
54
54
|
"private": false,
|
|
55
55
|
"engines": {
|
|
56
|
-
"node": ">=24.
|
|
56
|
+
"node": ">=24.14.0"
|
|
57
57
|
},
|
|
58
58
|
"license": "Apache-2.0",
|
|
59
59
|
"dependencies": {
|
|
@@ -1,6 +0,0 @@
|
|
|
1
|
-
//#region \0@oxc-project+runtime@0.152.0/helpers/esm/decorateMetadata.js
|
|
2
|
-
function __decorateMetadata(k, v) {
|
|
3
|
-
if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
|
|
4
|
-
}
|
|
5
|
-
//#endregion
|
|
6
|
-
export { __decorateMetadata as default };
|
|
@@ -1,216 +0,0 @@
|
|
|
1
|
-
//#region nodefony/src/remoteDev.ts
|
|
2
|
-
/**
|
|
3
|
-
* Dev déporté (P14.17) — calculs PURS d'origine publique du dev server Vite.
|
|
4
|
-
*
|
|
5
|
-
* Le problème résolu : `devHost` est une adresse d'ÉCOUTE ; l'origine que le
|
|
6
|
-
* NAVIGATEUR utilise peut être toute autre chose — un forwarder TLS (Codespaces,
|
|
7
|
-
* Gitpod), une passerelle de conteneur (`host.docker.internal`), un port remappé.
|
|
8
|
-
* Ce module dissocie les deux : il produit l'origine publique (assets, `base`
|
|
9
|
-
* Vite) à partir d'un TEMPLATE (`{port}` substitué au port réel
|
|
10
|
-
* du spawn) — explicite (`frontend.publicOrigin`) ou détecté depuis
|
|
11
|
-
* l'environnement de la plateforme.
|
|
12
|
-
*
|
|
13
|
-
* Tout est pur et injectable (env en paramètre) : testable sans process, sans
|
|
14
|
-
* réseau, sur les trois plateformes.
|
|
15
|
-
*
|
|
16
|
-
* Formats VÉRIFIÉS (docs officielles + source Vite 8) :
|
|
17
|
-
* - Codespaces : `https://${CODESPACE_NAME}-${port}.${GITHUB_CODESPACES_PORT_FORWARDING_DOMAIN}`
|
|
18
|
-
* (TLS terminé par le forwarder ; le socket HMR s'en déduit côté client).
|
|
19
|
-
* - Gitpod classic : `https://${port}-<hôte de GITPOD_WORKSPACE_URL>`.
|
|
20
|
-
* - Vite `server.allowedHosts` : IP et `localhost`/`*.localhost` TOUJOURS
|
|
21
|
-
* acceptés ; un préfixe `.` = le domaine ET tous ses sous-domaines.
|
|
22
|
-
* - VS Code Remote / dev containers / WSL2 : forwarding sur `localhost` →
|
|
23
|
-
* les défauts locaux suffisent, aucune détection requise.
|
|
24
|
-
*/
|
|
25
|
-
/** Placeholder substitué par le port réel du spawn dans un template d'origine. */
|
|
26
|
-
const PORT_PLACEHOLDER = "{port}";
|
|
27
|
-
/**
|
|
28
|
-
* `127.0.0.0/8` avec des octets BORNÉS (0-255). Pas de quantificateur imbriqué
|
|
29
|
-
* ni d'alternance qui se chevauche : linéaire sur toute entrée, y compris
|
|
30
|
-
* forgée (le `Host` est une donnée cliente).
|
|
31
|
-
*/
|
|
32
|
-
const LOOPBACK_V4_RE = /^127\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)$/;
|
|
33
|
-
/**
|
|
34
|
-
* Template d'origine publique : `scheme://hostTemplate[:portTemplate]`, sans
|
|
35
|
-
* chemin. `{port}` peut apparaître dans l'hôte (Codespaces/Gitpod : port encodé
|
|
36
|
-
* dans le sous-domaine) OU en position de port (`host:{port}`).
|
|
37
|
-
* Regex plutôt que `new URL()` : le parseur WHATWG refuse `{`/`}` dans un hôte.
|
|
38
|
-
*/
|
|
39
|
-
const ORIGIN_TEMPLATE_RE = /^(https?):\/\/([^/:\s]+)(?::(\d+|\{port\}))?$/;
|
|
40
|
-
/**
|
|
41
|
-
* Hôte utilisable par un NAVIGATEUR pour une adresse d'écoute donnée.
|
|
42
|
-
* `0.0.0.0`/`::` sont des adresses d'ÉCOUTE (toutes interfaces), pas des
|
|
43
|
-
* destinations : dérivées telles quelles dans une URL, elles donnent des
|
|
44
|
-
* `<script src="http://0.0.0.0:5173/…">` que les navigateurs refusent — et
|
|
45
|
-
* sous Windows, une CONNEXION vers `0.0.0.0` échoue aussi (health check).
|
|
46
|
-
*/
|
|
47
|
-
function browserReachableHost(listenHost) {
|
|
48
|
-
return listenHost === "0.0.0.0" || listenHost === "::" || listenHost === "[::]" || listenHost === "" ? "127.0.0.1" : listenHost;
|
|
49
|
-
}
|
|
50
|
-
/**
|
|
51
|
-
* Le client est-il arrivé par la BOUCLE LOCALE de la machine qui sert ?
|
|
52
|
-
*
|
|
53
|
-
* Ce n'est pas une commodité : c'est un fait vérifiable qui prime sur toute
|
|
54
|
-
* déduction faite au démarrage. Une plateforme de dev déporté se détecte par
|
|
55
|
-
* une variable d'environnement — donc UNE FOIS, au lancement du serveur — alors
|
|
56
|
-
* qu'un même serveur reçoit simultanément des clients arrivés par des chemins
|
|
57
|
-
* différents : l'origine publique de la plateforme, et un tunnel local (VS Code
|
|
58
|
-
* Desktop redirige les ports d'un Codespace sur `localhost`, c'est sa
|
|
59
|
-
* configuration par défaut).
|
|
60
|
-
*
|
|
61
|
-
* Servir l'origine publique à un client venu du tunnel a un coût réel : cette
|
|
62
|
-
* origine exige la session de la plateforme. Un navigateur humain la porte et
|
|
63
|
-
* ne voit rien ; une intégration continue, une sonde ou un agent ne l'ont pas,
|
|
64
|
-
* se font refuser, et obtiennent une page blanche que rien n'explique.
|
|
65
|
-
*
|
|
66
|
-
* La liste est FERMÉE, et c'est ce qui la rend sûre : le `Host` est une donnée
|
|
67
|
-
* cliente, et seuls ces noms désignent la machine locale de façon non
|
|
68
|
-
* ambiguë. `0.0.0.0`/`::` en sont exclus — ce sont des adresses d'écoute, pas
|
|
69
|
-
* des destinations (cf `browserReachableHost`).
|
|
70
|
-
*
|
|
71
|
-
* @param hostname - nom d'hôte NU, sans port (`[::1]` pour l'IPv6 canonique).
|
|
72
|
-
* @returns `true` si ce nom désigne la boucle locale.
|
|
73
|
-
*/
|
|
74
|
-
function isLoopbackHostname(hostname) {
|
|
75
|
-
if (hostname === "localhost" || hostname === "::1" || hostname === "[::1]") return true;
|
|
76
|
-
return LOOPBACK_V4_RE.test(hostname);
|
|
77
|
-
}
|
|
78
|
-
/** Un template d'origine est-il syntaxiquement valide ? (autorité unique) */
|
|
79
|
-
function isValidOriginTemplate(template) {
|
|
80
|
-
return ORIGIN_TEMPLATE_RE.test(template);
|
|
81
|
-
}
|
|
82
|
-
/**
|
|
83
|
-
* Origine RÉSOLUE (scheme + hôte + port), telle qu'elle sort du superviseur :
|
|
84
|
-
* `https://127.0.0.1:5173`, `https://x.app.github.dev` (port implicite),
|
|
85
|
-
* `http://[::1]:5173`. Pas de `{port}` ici — le template est déjà substitué.
|
|
86
|
-
*/
|
|
87
|
-
const RESOLVED_ORIGIN_RE = /^(https?:\/\/)(\[[^\]/]+\]|[^/:\s]+)(:\d+)?$/;
|
|
88
|
-
/**
|
|
89
|
-
* Rejoue une origine résolue sur un AUTRE nom d'hôte, en conservant le scheme
|
|
90
|
-
* et le port. Pure.
|
|
91
|
-
*
|
|
92
|
-
* C'est le cœur de la dérivation par requête : le scheme et le port sont ceux
|
|
93
|
-
* du serveur Vite (il écoute où il écoute), seul le NOM change — celui par
|
|
94
|
-
* lequel le client est arrivé. Une page servie sur `http://poste:5151` charge
|
|
95
|
-
* donc `https://poste:5173` si Vite est en TLS : le scheme ne se déduit JAMAIS
|
|
96
|
-
* de la page.
|
|
97
|
-
*
|
|
98
|
-
* `new URL()` est volontairement évité (une allocation par page rendue, pour
|
|
99
|
-
* une chaîne dont nous produisons nous-mêmes la grammaire).
|
|
100
|
-
*
|
|
101
|
-
* @param origin - origine résolue (`scheme://hôte[:port]`).
|
|
102
|
-
* @param hostname - nom d'hôte de remplacement, SANS port (`Context.domain`) ;
|
|
103
|
-
* une IPv6 est acceptée sous sa forme canonique entre crochets (`[::1]`).
|
|
104
|
-
* @returns l'origine réécrite, ou `null` si l'un des deux est inexploitable
|
|
105
|
-
* (l'appelant garde alors l'origine d'origine — jamais d'URL bancale émise).
|
|
106
|
-
*/
|
|
107
|
-
function originWithHostname(origin, hostname) {
|
|
108
|
-
const m = RESOLVED_ORIGIN_RE.exec(origin);
|
|
109
|
-
if (!m) return null;
|
|
110
|
-
if (!/^(\[[^\]/]+\]|[A-Za-z0-9._-]+)$/.test(hostname)) return null;
|
|
111
|
-
const port = m[3];
|
|
112
|
-
return `${m[1]}${hostname}${port ?? ""}`;
|
|
113
|
-
}
|
|
114
|
-
/**
|
|
115
|
-
* Résout un template d'origine contre le port RÉEL du spawn. Pure.
|
|
116
|
-
*
|
|
117
|
-
* @returns l'origine publique, ou `null` si le template est invalide
|
|
118
|
-
* (l'appelant retombe sur la dérivation locale en l'ANNONÇANT — jamais en
|
|
119
|
-
* silence). Aucune config HMR n'est rendue : le socket suit l'origine par
|
|
120
|
-
* laquelle le client Vite a été chargé, il n'a rien à recevoir.
|
|
121
|
-
*/
|
|
122
|
-
function resolveOriginTemplate(template, port) {
|
|
123
|
-
const m = ORIGIN_TEMPLATE_RE.exec(template);
|
|
124
|
-
if (!m) return null;
|
|
125
|
-
const [, scheme, hostTemplate, portTemplate] = m;
|
|
126
|
-
const host = hostTemplate.replaceAll(PORT_PLACEHOLDER, String(port));
|
|
127
|
-
const explicitPort = portTemplate ? parseInt(portTemplate.replaceAll(PORT_PLACEHOLDER, String(port)), 10) : void 0;
|
|
128
|
-
return { origin: `${scheme}://${host}${explicitPort !== void 0 ? `:${explicitPort}` : ""}` };
|
|
129
|
-
}
|
|
130
|
-
/**
|
|
131
|
-
* Motif `server.allowedHosts` couvrant TOUTES les origines qu'un template peut
|
|
132
|
-
* produire. `{port}` dans l'hôte → le sous-domaine varie avec le port : motif
|
|
133
|
-
* `.suffixe` (wildcard Vite = domaine + sous-domaines). Hôte fixe → verbatim.
|
|
134
|
-
*
|
|
135
|
-
* @returns le motif, ou `null` si template invalide ou hôte non exprimable
|
|
136
|
-
* (un `{port}` dans le DERNIER label n'a pas de suffixe à wildcarder).
|
|
137
|
-
*/
|
|
138
|
-
function allowedHostPatternForTemplate(template) {
|
|
139
|
-
const [, , hostTemplate] = ORIGIN_TEMPLATE_RE.exec(template) ?? [];
|
|
140
|
-
if (hostTemplate === void 0) return null;
|
|
141
|
-
if (!hostTemplate.includes("{port}")) return hostTemplate;
|
|
142
|
-
const dot = hostTemplate.indexOf(".");
|
|
143
|
-
if (dot === -1 || hostTemplate.slice(dot + 1).includes("{port}")) return null;
|
|
144
|
-
return hostTemplate.slice(dot);
|
|
145
|
-
}
|
|
146
|
-
/**
|
|
147
|
-
* Motif Vite `allowedHosts` équivalent d'un pattern `trustedHosts` http.
|
|
148
|
-
* `*.suffixe` (wildcard un-label de la barrière Host) → `.suffixe` (wildcard
|
|
149
|
-
* Vite). Un `*` ailleurs n'est pas exprimable chez Vite → `null` (l'hôte reste
|
|
150
|
-
* couvert par la barrière Nodefony ; Vite le refusera — motif à écrire en
|
|
151
|
-
* clair dans `trustedHosts` si le cas se présente).
|
|
152
|
-
*/
|
|
153
|
-
function viteAllowedHostFromPattern(pattern) {
|
|
154
|
-
if (!pattern.includes("*")) return pattern;
|
|
155
|
-
if (pattern.startsWith("*.") && !pattern.slice(2).includes("*")) return pattern.slice(1);
|
|
156
|
-
return null;
|
|
157
|
-
}
|
|
158
|
-
/**
|
|
159
|
-
* Ce qu'il faut DIRE quand l'écoute du serveur Vite contredit la plateforme.
|
|
160
|
-
*
|
|
161
|
-
* Le symptôme que cette fonction existe pour expliquer : en dev déporté
|
|
162
|
-
* (Codespaces, Gitpod, conteneur, machine distante en SSH), la page se charge,
|
|
163
|
-
* aucun script ne démarre, et le navigateur rend `ERR_CONNECTION_REFUSED`. Rien
|
|
164
|
-
* ne relie ce refus à une adresse d'écoute — l'utilisateur ne peut pas deviner
|
|
165
|
-
* que le port existe mais n'est joignable que depuis la machine qui sert.
|
|
166
|
-
*
|
|
167
|
-
* **On AVERTIT, on n'ajuste pas.** Élargir l'écoute à toutes les interfaces est
|
|
168
|
-
* un geste RÉSEAU : il expose un port au-delà de la machine, et le framework ne
|
|
169
|
-
* le fait nulle part ailleurs en silence. Ce qui manquait n'était pas la
|
|
170
|
-
* capacité, c'était l'énoncé.
|
|
171
|
-
*
|
|
172
|
-
* Le message nomme les DEUX causes, et c'est délibéré : un message qui n'en
|
|
173
|
-
* énonce qu'une est cru PARCE QU'il est précis, et envoie chercher là où il n'y
|
|
174
|
-
* a rien. L'écoute est la première à vérifier ; le nom non déclaré de confiance
|
|
175
|
-
* produit exactement le même écran vide une fois l'écoute élargie.
|
|
176
|
-
*
|
|
177
|
-
* Pure, et l'environnement entre en paramètre : le cas se contrôle sans
|
|
178
|
-
* Codespace, sans conteneur et sans réseau.
|
|
179
|
-
*
|
|
180
|
-
* @param detection - ce que `detectRemoteDev` a rendu (`null` = pas de dev déporté).
|
|
181
|
-
* @param listenHost - l'adresse d'écoute configurée (`frontend.devHost`).
|
|
182
|
-
* @returns le message à journaliser, ou `null` quand il n'y a rien à dire —
|
|
183
|
-
* pas de plateforme distante, ou écoute déjà ouverte au-delà de la machine.
|
|
184
|
-
*/
|
|
185
|
-
function remoteDevListenAdvice(detection, listenHost) {
|
|
186
|
-
if (!detection) return null;
|
|
187
|
-
if (!isLoopbackHostname(listenHost)) return null;
|
|
188
|
-
return `dev déporté détecté (${detection.provider}) mais Vite écoute sur « ${listenHost} » — une adresse d'ÉCOUTE locale. Depuis l'extérieur de cette machine (ou de ce conteneur), ce port n'est PAS joignable : la page se charge, aucun script ne démarre, et le navigateur rend ERR_CONNECTION_REFUSED.\n → écouter sur toutes les interfaces : frontend.devHost = "0.0.0.0" (geste réseau — il expose ce port au-delà de la machine, c'est pourquoi il n'est pas posé tout seul).\n Si la page reste muette une fois l'écoute élargie, la cause est ailleurs : le nom par lequel le navigateur arrive doit être déclaré de confiance (http.trustedHosts), sinon l'origine des assets n'est pas dérivée du « Host » reçu.`;
|
|
189
|
-
}
|
|
190
|
-
/**
|
|
191
|
-
* Détecte un environnement de dev déporté depuis les variables de plateforme
|
|
192
|
-
* (variables qu'on ne possède pas — elles se lisent, ne se renomment pas).
|
|
193
|
-
* Ordre : Codespaces puis Gitpod (jamais les deux posées en pratique).
|
|
194
|
-
* Env local/VS Code Remote/WSL2 → `null` (les défauts locaux suffisent).
|
|
195
|
-
*/
|
|
196
|
-
function detectRemoteDev(env) {
|
|
197
|
-
const csName = env.CODESPACE_NAME;
|
|
198
|
-
const csDomain = env.GITHUB_CODESPACES_PORT_FORWARDING_DOMAIN;
|
|
199
|
-
if (csName && csDomain) return {
|
|
200
|
-
provider: "codespaces",
|
|
201
|
-
originTemplate: `https://${csName}-${PORT_PLACEHOLDER}.${csDomain}`
|
|
202
|
-
};
|
|
203
|
-
const gpUrl = env.GITPOD_WORKSPACE_URL;
|
|
204
|
-
if (gpUrl) try {
|
|
205
|
-
const host = new URL(gpUrl).hostname;
|
|
206
|
-
return {
|
|
207
|
-
provider: "gitpod",
|
|
208
|
-
originTemplate: `https://${PORT_PLACEHOLDER}-${host}`
|
|
209
|
-
};
|
|
210
|
-
} catch {
|
|
211
|
-
return null;
|
|
212
|
-
}
|
|
213
|
-
return null;
|
|
214
|
-
}
|
|
215
|
-
//#endregion
|
|
216
|
-
export { PORT_PLACEHOLDER, allowedHostPatternForTemplate, browserReachableHost, detectRemoteDev, isLoopbackHostname, isValidOriginTemplate, originWithHostname, remoteDevListenAdvice, resolveOriginTemplate, viteAllowedHostFromPattern };
|
|
@@ -1,152 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Dev déporté (P14.17) — calculs PURS d'origine publique du dev server Vite.
|
|
3
|
-
*
|
|
4
|
-
* Le problème résolu : `devHost` est une adresse d'ÉCOUTE ; l'origine que le
|
|
5
|
-
* NAVIGATEUR utilise peut être toute autre chose — un forwarder TLS (Codespaces,
|
|
6
|
-
* Gitpod), une passerelle de conteneur (`host.docker.internal`), un port remappé.
|
|
7
|
-
* Ce module dissocie les deux : il produit l'origine publique (assets, `base`
|
|
8
|
-
* Vite) à partir d'un TEMPLATE (`{port}` substitué au port réel
|
|
9
|
-
* du spawn) — explicite (`frontend.publicOrigin`) ou détecté depuis
|
|
10
|
-
* l'environnement de la plateforme.
|
|
11
|
-
*
|
|
12
|
-
* Tout est pur et injectable (env en paramètre) : testable sans process, sans
|
|
13
|
-
* réseau, sur les trois plateformes.
|
|
14
|
-
*
|
|
15
|
-
* Formats VÉRIFIÉS (docs officielles + source Vite 8) :
|
|
16
|
-
* - Codespaces : `https://${CODESPACE_NAME}-${port}.${GITHUB_CODESPACES_PORT_FORWARDING_DOMAIN}`
|
|
17
|
-
* (TLS terminé par le forwarder ; le socket HMR s'en déduit côté client).
|
|
18
|
-
* - Gitpod classic : `https://${port}-<hôte de GITPOD_WORKSPACE_URL>`.
|
|
19
|
-
* - Vite `server.allowedHosts` : IP et `localhost`/`*.localhost` TOUJOURS
|
|
20
|
-
* acceptés ; un préfixe `.` = le domaine ET tous ses sous-domaines.
|
|
21
|
-
* - VS Code Remote / dev containers / WSL2 : forwarding sur `localhost` →
|
|
22
|
-
* les défauts locaux suffisent, aucune détection requise.
|
|
23
|
-
*/
|
|
24
|
-
/** Placeholder substitué par le port réel du spawn dans un template d'origine. */
|
|
25
|
-
export declare const PORT_PLACEHOLDER = "{port}";
|
|
26
|
-
/** Résultat d'un template résolu contre un port réel. */
|
|
27
|
-
export interface IResolvedPublicOrigin {
|
|
28
|
-
/** Origine que le navigateur utilise — verbatim dans les `<script>` et le `base` Vite. */
|
|
29
|
-
readonly origin: string;
|
|
30
|
-
}
|
|
31
|
-
/** Environnement de dev déporté détecté depuis les variables de la plateforme. */
|
|
32
|
-
export interface IRemoteDevDetection {
|
|
33
|
-
readonly provider: "codespaces" | "gitpod";
|
|
34
|
-
/** Template d'origine publique du dev server Vite (`{port}` à substituer). */
|
|
35
|
-
readonly originTemplate: string;
|
|
36
|
-
}
|
|
37
|
-
/**
|
|
38
|
-
* Hôte utilisable par un NAVIGATEUR pour une adresse d'écoute donnée.
|
|
39
|
-
* `0.0.0.0`/`::` sont des adresses d'ÉCOUTE (toutes interfaces), pas des
|
|
40
|
-
* destinations : dérivées telles quelles dans une URL, elles donnent des
|
|
41
|
-
* `<script src="http://0.0.0.0:5173/…">` que les navigateurs refusent — et
|
|
42
|
-
* sous Windows, une CONNEXION vers `0.0.0.0` échoue aussi (health check).
|
|
43
|
-
*/
|
|
44
|
-
export declare function browserReachableHost(listenHost: string): string;
|
|
45
|
-
/**
|
|
46
|
-
* Le client est-il arrivé par la BOUCLE LOCALE de la machine qui sert ?
|
|
47
|
-
*
|
|
48
|
-
* Ce n'est pas une commodité : c'est un fait vérifiable qui prime sur toute
|
|
49
|
-
* déduction faite au démarrage. Une plateforme de dev déporté se détecte par
|
|
50
|
-
* une variable d'environnement — donc UNE FOIS, au lancement du serveur — alors
|
|
51
|
-
* qu'un même serveur reçoit simultanément des clients arrivés par des chemins
|
|
52
|
-
* différents : l'origine publique de la plateforme, et un tunnel local (VS Code
|
|
53
|
-
* Desktop redirige les ports d'un Codespace sur `localhost`, c'est sa
|
|
54
|
-
* configuration par défaut).
|
|
55
|
-
*
|
|
56
|
-
* Servir l'origine publique à un client venu du tunnel a un coût réel : cette
|
|
57
|
-
* origine exige la session de la plateforme. Un navigateur humain la porte et
|
|
58
|
-
* ne voit rien ; une intégration continue, une sonde ou un agent ne l'ont pas,
|
|
59
|
-
* se font refuser, et obtiennent une page blanche que rien n'explique.
|
|
60
|
-
*
|
|
61
|
-
* La liste est FERMÉE, et c'est ce qui la rend sûre : le `Host` est une donnée
|
|
62
|
-
* cliente, et seuls ces noms désignent la machine locale de façon non
|
|
63
|
-
* ambiguë. `0.0.0.0`/`::` en sont exclus — ce sont des adresses d'écoute, pas
|
|
64
|
-
* des destinations (cf `browserReachableHost`).
|
|
65
|
-
*
|
|
66
|
-
* @param hostname - nom d'hôte NU, sans port (`[::1]` pour l'IPv6 canonique).
|
|
67
|
-
* @returns `true` si ce nom désigne la boucle locale.
|
|
68
|
-
*/
|
|
69
|
-
export declare function isLoopbackHostname(hostname: string): boolean;
|
|
70
|
-
/** Un template d'origine est-il syntaxiquement valide ? (autorité unique) */
|
|
71
|
-
export declare function isValidOriginTemplate(template: string): boolean;
|
|
72
|
-
/**
|
|
73
|
-
* Rejoue une origine résolue sur un AUTRE nom d'hôte, en conservant le scheme
|
|
74
|
-
* et le port. Pure.
|
|
75
|
-
*
|
|
76
|
-
* C'est le cœur de la dérivation par requête : le scheme et le port sont ceux
|
|
77
|
-
* du serveur Vite (il écoute où il écoute), seul le NOM change — celui par
|
|
78
|
-
* lequel le client est arrivé. Une page servie sur `http://poste:5151` charge
|
|
79
|
-
* donc `https://poste:5173` si Vite est en TLS : le scheme ne se déduit JAMAIS
|
|
80
|
-
* de la page.
|
|
81
|
-
*
|
|
82
|
-
* `new URL()` est volontairement évité (une allocation par page rendue, pour
|
|
83
|
-
* une chaîne dont nous produisons nous-mêmes la grammaire).
|
|
84
|
-
*
|
|
85
|
-
* @param origin - origine résolue (`scheme://hôte[:port]`).
|
|
86
|
-
* @param hostname - nom d'hôte de remplacement, SANS port (`Context.domain`) ;
|
|
87
|
-
* une IPv6 est acceptée sous sa forme canonique entre crochets (`[::1]`).
|
|
88
|
-
* @returns l'origine réécrite, ou `null` si l'un des deux est inexploitable
|
|
89
|
-
* (l'appelant garde alors l'origine d'origine — jamais d'URL bancale émise).
|
|
90
|
-
*/
|
|
91
|
-
export declare function originWithHostname(origin: string, hostname: string): string | null;
|
|
92
|
-
/**
|
|
93
|
-
* Résout un template d'origine contre le port RÉEL du spawn. Pure.
|
|
94
|
-
*
|
|
95
|
-
* @returns l'origine publique, ou `null` si le template est invalide
|
|
96
|
-
* (l'appelant retombe sur la dérivation locale en l'ANNONÇANT — jamais en
|
|
97
|
-
* silence). Aucune config HMR n'est rendue : le socket suit l'origine par
|
|
98
|
-
* laquelle le client Vite a été chargé, il n'a rien à recevoir.
|
|
99
|
-
*/
|
|
100
|
-
export declare function resolveOriginTemplate(template: string, port: number): IResolvedPublicOrigin | null;
|
|
101
|
-
/**
|
|
102
|
-
* Motif `server.allowedHosts` couvrant TOUTES les origines qu'un template peut
|
|
103
|
-
* produire. `{port}` dans l'hôte → le sous-domaine varie avec le port : motif
|
|
104
|
-
* `.suffixe` (wildcard Vite = domaine + sous-domaines). Hôte fixe → verbatim.
|
|
105
|
-
*
|
|
106
|
-
* @returns le motif, ou `null` si template invalide ou hôte non exprimable
|
|
107
|
-
* (un `{port}` dans le DERNIER label n'a pas de suffixe à wildcarder).
|
|
108
|
-
*/
|
|
109
|
-
export declare function allowedHostPatternForTemplate(template: string): string | null;
|
|
110
|
-
/**
|
|
111
|
-
* Motif Vite `allowedHosts` équivalent d'un pattern `trustedHosts` http.
|
|
112
|
-
* `*.suffixe` (wildcard un-label de la barrière Host) → `.suffixe` (wildcard
|
|
113
|
-
* Vite). Un `*` ailleurs n'est pas exprimable chez Vite → `null` (l'hôte reste
|
|
114
|
-
* couvert par la barrière Nodefony ; Vite le refusera — motif à écrire en
|
|
115
|
-
* clair dans `trustedHosts` si le cas se présente).
|
|
116
|
-
*/
|
|
117
|
-
export declare function viteAllowedHostFromPattern(pattern: string): string | null;
|
|
118
|
-
/**
|
|
119
|
-
* Ce qu'il faut DIRE quand l'écoute du serveur Vite contredit la plateforme.
|
|
120
|
-
*
|
|
121
|
-
* Le symptôme que cette fonction existe pour expliquer : en dev déporté
|
|
122
|
-
* (Codespaces, Gitpod, conteneur, machine distante en SSH), la page se charge,
|
|
123
|
-
* aucun script ne démarre, et le navigateur rend `ERR_CONNECTION_REFUSED`. Rien
|
|
124
|
-
* ne relie ce refus à une adresse d'écoute — l'utilisateur ne peut pas deviner
|
|
125
|
-
* que le port existe mais n'est joignable que depuis la machine qui sert.
|
|
126
|
-
*
|
|
127
|
-
* **On AVERTIT, on n'ajuste pas.** Élargir l'écoute à toutes les interfaces est
|
|
128
|
-
* un geste RÉSEAU : il expose un port au-delà de la machine, et le framework ne
|
|
129
|
-
* le fait nulle part ailleurs en silence. Ce qui manquait n'était pas la
|
|
130
|
-
* capacité, c'était l'énoncé.
|
|
131
|
-
*
|
|
132
|
-
* Le message nomme les DEUX causes, et c'est délibéré : un message qui n'en
|
|
133
|
-
* énonce qu'une est cru PARCE QU'il est précis, et envoie chercher là où il n'y
|
|
134
|
-
* a rien. L'écoute est la première à vérifier ; le nom non déclaré de confiance
|
|
135
|
-
* produit exactement le même écran vide une fois l'écoute élargie.
|
|
136
|
-
*
|
|
137
|
-
* Pure, et l'environnement entre en paramètre : le cas se contrôle sans
|
|
138
|
-
* Codespace, sans conteneur et sans réseau.
|
|
139
|
-
*
|
|
140
|
-
* @param detection - ce que `detectRemoteDev` a rendu (`null` = pas de dev déporté).
|
|
141
|
-
* @param listenHost - l'adresse d'écoute configurée (`frontend.devHost`).
|
|
142
|
-
* @returns le message à journaliser, ou `null` quand il n'y a rien à dire —
|
|
143
|
-
* pas de plateforme distante, ou écoute déjà ouverte au-delà de la machine.
|
|
144
|
-
*/
|
|
145
|
-
export declare function remoteDevListenAdvice(detection: IRemoteDevDetection | null, listenHost: string): string | null;
|
|
146
|
-
/**
|
|
147
|
-
* Détecte un environnement de dev déporté depuis les variables de plateforme
|
|
148
|
-
* (variables qu'on ne possède pas — elles se lisent, ne se renomment pas).
|
|
149
|
-
* Ordre : Codespaces puis Gitpod (jamais les deux posées en pratique).
|
|
150
|
-
* Env local/VS Code Remote/WSL2 → `null` (les défauts locaux suffisent).
|
|
151
|
-
*/
|
|
152
|
-
export declare function detectRemoteDev(env: Readonly<Record<string, string | undefined>>): IRemoteDevDetection | null;
|