@starterlib/cli 0.10.7 → 0.10.9

package/README.md

@@ -31,17 +31,17 @@ Scripts d'une SPA :
 
 ## Commandes
 
-| Commande                    | Ce qu'elle fait                                                                                                                               |
-| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
-| `starter-web start`         | L'hote de developpement : sprite, simulations (remote), puis `ng serve` sous `STARTER_WEB_HOTE_DEV=1` (`--port N`)                            |
-| `starter-web verify`        | Les etapes ci-dessous, dans l'ordre, arretees a la premiere qui echoue, dont le nom est ecrit                                                 |
-| `starter-web construire`    | Sprite, `ng build`, prechargement de la police (hote), manifeste, precompression                                                              |
-| `starter-web sprite`        | Pose le sprite hache (`public/`) et sa constante engendree (`sprite-genere.ts`)                                                               |
-| `starter-web manifeste`     | Engendre `manifest.json` dans le dossier livre ; idempotent                                                                                   |
-| `starter-web precompresser` | Ecrit les variantes `.br` et `.gz` ; `starter-web precompresser <dossier>` pour un autre dossier                                              |
-| `starter-web i18n:types`    | Engendre `src/app/i18n/cles.ts`, le type des cles de chaque perimetre (`injecterTraduction<C>`)                                               |
-| `starter-web simulations`   | Recopie les stubs WireMock du service (`../src/mock`), corps compris, pour l'hote de developpement (`src/hote-dev/simulations.engendre.json`) |
-| `starter-web etapes`        | Liste les etapes et les roles qu'elles concernent                                                                                             |
+| Commande                    | Ce qu'elle fait                                                                                                                                                                                      |
+| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `starter-web start`         | L'hote de developpement : sprite, simulations (remote), puis `ng serve` sous `STARTER_WEB_HOTE_DEV=1` (`--port N`)                                                                                   |
+| `starter-web verify`        | Les etapes ci-dessous, dans l'ordre, arretees a la premiere qui echoue, dont le nom est ecrit                                                                                                        |
+| `starter-web construire`    | Sprite, `ng build`, prechargement de la police (hote), manifeste, precompression                                                                                                                     |
+| `starter-web sprite`        | Pose le sprite hache (`public/`) et sa constante engendree (`sprite-genere.ts`)                                                                                                                      |
+| `starter-web manifeste`     | Engendre `manifest.json` dans le dossier livre ; idempotent                                                                                                                                          |
+| `starter-web precompresser` | Ecrit les variantes `.br` et `.gz`, et `precompression.index` (chaque variante et le condense de son source, que le serveur confronte) ; `starter-web precompresser <dossier>` pour un autre dossier |
+| `starter-web i18n:types`    | Engendre `src/app/i18n/cles.ts`, le type des cles de chaque perimetre (`injecterTraduction<C>`)                                                                                                      |
+| `starter-web simulations`   | Recopie les stubs WireMock du service (`../src/mock`), corps compris, pour l'hote de developpement (`src/hote-dev/simulations.engendre.json`)                                                        |
+| `starter-web etapes`        | Liste les etapes et les roles qu'elles concernent                                                                                                                                                    |
 
 Codes de sortie : `0` conforme ; `1` une etape a echoue ; `2` la commande ne peut pas s'executer
 (argument inconnu, projet illisible).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starterlib/cli",
-  "version": "0.10.7",
+  "version": "0.10.9",
   "description": "Chaine de verification et de construction des SPA du socle frontal starter : starter-web verify, construire, sprite, manifeste, precompresser. Jamais en dependance de production.",
   "license": "UNLICENSED",
   "type": "module",

package/src/construction/precompresser.mjs

@@ -27,11 +27,21 @@
  *     morceau d'une construction precedente) est retiree, et une variante devenue inutile aussi :
  *     le serveur servirait sinon un contenu que plus rien ne produit.
  *
+ * LE CONDENSE DE CHAQUE SOURCE (lot 120)
+ *
+ *   Dans l'image, Jib fige toutes les dates : le serveur ne peut pas voir qu'une variante vient
+ *   d'une construction precedente (une copie sans purge garde l'ancien `remoteEntry.json.gz` quand
+ *   la nouvelle construction n'ecrit plus que le `.br`). L'etape ecrit donc `precompression.index`
+ *   a la racine du dossier : une ligne par VARIANTE ecrite, le condense de son SOURCE (SHA-256
+ *   tronque a 128 bits, comme l'ETag du serveur), deux blancs, le chemin de la variante.
+ *   `ActifsStatiques` ne sert une variante que si l'index la nomme avec le condense de son source.
+ *
  * L'etape vient APRES la generation du manifeste, qui renomme les catalogues i18n.
  */
 import { brotliCompressSync, constants, gzipSync } from 'node:zlib';
+import { createHash } from 'node:crypto';
 import { existsSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
-import { extname } from 'node:path';
+import { extname, join } from 'node:path';
 import { fichiers, ko, relatif } from '../commun.mjs';
 
 /** Exactement ce que le serveur declare compressible (ActifsStatiques.EXTENSIONS_COMPRESSIBLES). */
@@ -48,6 +58,14 @@ export const COMPRESSIBLES = new Set([
 /** Reecrit a chaque reponse par le serveur : une variante figee serait fausse. */
 const EXCLUS = new Set(['index.html']);
 
+/** L'index des variantes, lu par `ActifsStatiques.INDEX_DES_VARIANTES`. */
+export const INDEX_DES_VARIANTES = 'precompression.index';
+
+/** Le condense d'un contenu tel que le serveur le calcule : SHA-256 tronque a 128 bits, en hexadecimal. */
+export function condense(contenu) {
+  return createHash('sha256').update(contenu).digest('hex').slice(0, 32);
+}
+
 /**
  * Precompresse `dossier`. Rend `{ compresses, orphelines, octetsAvant, octetsBrotli, sansVariante }`,
  * `sansVariante` listant les `.js` qui devraient avoir une variante brotli et n'en ont pas.
@@ -69,6 +87,7 @@ export function precompresser(dossier) {
   let octetsAvant = 0;
   let octetsBrotli = 0;
   const sansGain = new Set();
+  const index = [];
   for (const fichier of fichiers(dossier)) {
     const extension = extname(fichier);
     if (extension === '.br' || extension === '.gz') continue;
@@ -88,6 +107,7 @@ export function precompresser(dossier) {
     ]) {
       if (compresse.length < contenu.length) {
         writeFileSync(variante, compresse);
+        index.push(`${condense(contenu)}  ${relatif(dossier, variante)}`);
         ecrit = true;
       } else {
         // Une variante d'une passe precedente, devenue plus lourde que l'original : retiree.
@@ -102,12 +122,18 @@ export function precompresser(dossier) {
       sansGain.add(fichier);
     }
   }
+  const cheminDeLIndex = join(dossier, INDEX_DES_VARIANTES);
+  if (index.length > 0) {
+    writeFileSync(cheminDeLIndex, `${index.sort().join('\n')}\n`);
+  } else {
+    rmSync(cheminDeLIndex, { force: true });
+  }
 
   const sansVariante = fichiers(dossier)
     .filter((fichier) => extname(fichier) === '.js' && !sansGain.has(fichier))
     .filter((fichier) => !existsSync(`${fichier}.br`))
     .map((fichier) => relatif(dossier, fichier));
-  return { compresses, orphelines, octetsAvant, octetsBrotli, sansVariante };
+  return { compresses, orphelines, octetsAvant, octetsBrotli, sansVariante, indexes: index.length };
 }
 
 /** Le compte rendu d'une precompression, et ses defauts (une etape devenue inutile en est un). */