dogfather-universe/tools/seiten-stempel.mjs

/* =====================================================================
   seiten-stempel.mjs — Versionsstempel an die ÖFFENTLICHEN Seiten.

   ---------------------------------------------------------------------
   WARUM ES DAS BRAUCHT, UND WAS OHNE IHN PASSIERT IST

   Für den Workspace gibt es `workspace-stempel.mjs` seit Langem. Die
   öffentliche Website hatte nichts dergleichen — dort stand ein von
   HAND gepflegter Stempel, und der ist genau so gealtert, wie eine von
   Hand gepflegte Liste das tut.

   Gemessen am 30.09.2026:

       Stempel in allen 35 Seiten:  ?v=20260828e   (zuletzt am 27.08.)
       Änderungen an assets/ seither:  6 Commits
       Der Server sagt dazu:  Cache-Control: max-age=31536000, immutable

   `immutable` heißt: Der Browser fragt nicht einmal nach. Wer die Seite
   einmal geladen hat, behält Stilvorlagen und Skripte bis zu EINEM
   JAHR — oder bis sich die Adresse ändert.

   Damit ist seit dem 27.08. keine Änderung an der Website bei einem
   wiederkehrenden Besucher angekommen. Darunter der Partnercode
   DOGI10 auf der geprägten Münze und der komplette Sprachumbau der
   Oberfläche. Sie lagen auf dem Server, sie waren ausgeliefert, und
   niemand sah sie.

   Das ist dieselbe Sorte Fehler wie am 09.09. im Workspace („eine
   Änderung ist nicht gemacht" — sie war es, nur unsichtbar) und
   dieselbe wie bei VanVans Shop: Eine Änderung ist erst fertig, wenn
   sie auf der Adresse ankommt, die der Nutzer benutzt.

   ---------------------------------------------------------------------
   WAS GESTEMPELT WIRD

   Stilvorlagen, Skripte, Bilder und QR-Codes — in beiden
   Schreibweisen, mit führendem Schrägstrich und ohne. Beide kommen in
   den Seiten vor (98-mal `/assets/img/…`, 38-mal `assets/img/…`), und
   ein Muster, das nur eine kennt, stempelt die Hälfte.

   DERSELBE STEMPEL WIE IM WORKSPACE-WERKZEUG: die Minute des Aufrufs.
   So sieht man einer Seite an, wann sie zuletzt ausgeliefert wurde.

   AUFRUF:  node tools/seiten-stempel.mjs
   Gehört vor jeden Deploy, der `assets/` anfasst.
   ===================================================================== */

import { readdirSync, readFileSync, writeFileSync, statSync } from "node:fs";
import { join, dirname } from "node:path";
import { fileURLToPath } from "node:url";

const HIER = dirname(fileURLToPath(import.meta.url));
const WURZEL = join(HIER, "..");

const d = new Date();
const zz = (n) => String(n).padStart(2, "0");
export const STEMPEL = `${d.getFullYear()}${zz(d.getMonth() + 1)}${zz(d.getDate())}`
  + `${zz(d.getHours())}${zz(d.getMinutes())}`;

/* BEIDE SCHREIBWEISEN. Mit führendem Schrägstrich und ohne — beide
   stehen in den Seiten, und ein Muster, das nur eine kennt, stempelt
   die Hälfte. */
const MUSTER = /(href|src)="(\/?assets\/(?:css|js|img|qr)\/[^"?]+)(?:\?v=[^"]*)?"/g;

/* UND DIE, DIE IN EINEM `style="…url(…)"` STEHEN.

   Zwei Hintergrundbilder auf `streamplan.html` stehen so -- sie
   fielen durch das Muster oben und waeren ein Jahr lang die alten
   geblieben. Dieselbe Luecke gab es im Workspace-Stempler schon
   einmal, dort bei den App-Symbolen: Ein Muster, das nur die
   haeufigste Schreibweise kennt, stempelt die haeufigsten Dateien. */
const MUSTER_URL =
  /url\((['"]?)(\/?assets\/(?:css|js|img|qr)\/[^'")?]+)(?:\?v=[^'")]*)?\1\)/g;

let dateien = 0;
let stellen = 0;
/* Wie viele Verweise das Muster ueberhaupt getroffen hat. */
let gefunden = 0;

for (const name of readdirSync(WURZEL)) {
  if (!name.endsWith(".html")) continue;
  const pfad = join(WURZEL, name);
  if (!statSync(pfad).isFile()) continue;
  const alt = readFileSync(pfad, "utf8");
  let n = 0;
  const neu = alt
    .replace(MUSTER, (_, was, datei) => {
      n += 1;
      return `${was}="${datei}?v=${STEMPEL}"`;
    })
    .replace(MUSTER_URL, (_, anf, datei) => {
      n += 1;
      return `url(${anf}${datei}?v=${STEMPEL}${anf})`;
    });
  /* GEZAEHLT WIRD, WAS DAS MUSTER GEFUNDEN HAT -- nicht, was sich
     geaendert hat. Laeuft das Werkzeug zweimal in derselben Minute,
     ist der Stempel schon der richtige und keine Datei aendert sich;
     das ist kein Fehler, sondern Sorgfalt. Die Meldung darunter
     bestrafte genau das. */
  gefunden += n;
  if (neu !== alt) {
    writeFileSync(pfad, neu);
    dateien += 1;
    stellen += n;
    console.log(`  ${name.padEnd(28)} ${n} Verweise`);
  }
}

/* DIE ZAHL GEHÖRT IN DIE BEDINGUNG. Stempelte das Werkzeug nichts,
   liefe es stillschweigend durch — und der nächste Deploy wäre wieder
   unsichtbar. Genau dafür gibt es diesen Ausgang. */
if (gefunden === 0) {
  console.error("FEHLER: das Muster hat keinen einzigen Verweis getroffen. "
    + "Stimmt es noch?");
  process.exit(1);
}

if (dateien === 0) {
  console.log(`\nAlle ${gefunden} Verweise tragen den Stempel ${STEMPEL} schon `
    + `-- nichts zu tun.`);
} else {
  console.log(`\nStempel ${STEMPEL} auf ${stellen} Verweise in ${dateien} Seiten gesetzt `
    + `(${gefunden} insgesamt geprueft).`);
}