Files
Studio_Grasso/scripts/package.mjs
T
Alby96andClaude Opus 5.5 3befe7e266 fix: CI adattata a Forgejo, revisione completa del codice e avvio in debug
Le run della CI restavano «in attesa» perché l'unico runner dell'istanza («Ferrari») non si è
mai collegato: il runner resta da configurare. La revisione completa del codice ha trovato
anche difetti che avrebbero fatto fallire la CI con il runner online, oltre ad altri problemi
del sito, dei controlli e della documentazione.

CI e rilascio:
- continue-on-error sullo step dei link esterni: Forgejo lo ignora sul job, e un sito esterno
  irraggiungibile avrebbe reso rossa la CI;
- artifact con i file nascosti (report Lighthouse e .htaccess non venivano mai caricati);
- token personale RELEASE_TOKEN: FORGEJO_TOKEN è riservato ed è sempre il token automatico;
- dominio in un solo punto (site.config.mjs) e variabile del repository SITE_URL;
- ripiego REST: release in bozza, file, poi pubblicazione; tag verificato sul server;
  sostituzione dei file senza mai lasciarli mancanti;
- tar.gz identico su Windows, macOS e Linux (byte del sistema operativo nell'header gzip).

Sito: CSS compatibile con Safari/iOS 15 (media query classiche, backdrop-filter), anello di
focus con contrasto di almeno 3:1, bersagli touch di 44 px dove servono, intestazione desktop
senza voci o logo a capo, HTML valido in /servizi/, colore delle chip, stampa senza mappe,
giorni di apertura, ricerca e titolo delle mappe e numero breve ricavati dai dati.

Modulo di contatto e contact.php: stesse regole nel browser e sul server (spazi, e-mail,
a capo, lunghezze), tempo minimo misurato con un solo orologio (ts_invio), corpo in
quoted-printable e oggetto RFC 2047, funzionamento con PHP a 32 bit, costante
MODALITA_PREDEFINITA per attivarlo.

Controlli e test: valori letti dai dati del sito, i sei servizi del brief con le ancore,
«commercialista» anche in meta, attributi e dati strutturati, .htaccess su righe attive,
HSTS attivabile con una scelta esplicita, contrasto del focus misurato nei test.

Esempi di pubblicazione: nginx con gli header di sicurezza in un solo punto (HSTS compreso),
deploy automatico che parte alla pubblicazione e sincronizza solo una cartella confermata,
procedura nginx che toglie i file delle versioni precedenti.

Debug: .vscode/launch.json e tasks.json, F5 avvia il server Astro e apre il browser con il
debugger collegato.

Documentazione aggiornata (README, DEPLOY, CONTENUTI, CONFORMITA, TODO-STUDIO, CHANGELOG) e
decisioni D-045…D-055.

Verificato: npm run verify su Windows e nel container della CI (Playwright 1.56.1, root);
job dei link esterni in node:24; contact.php con PHP 7.4 e 8.3, a 64 e 32 bit; nginx in
Docker; release-upload.sh e deploy di esempio contro API e shell simulate.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-16 13:40:16 +02:00

126 lines
4.6 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/usr/bin/env node
/**
* Pacchetto di rilascio (brief §12.4). Da `dist/` crea in `release/`:
*
* sito-studio-grasso-v<versione>.zip per i pannelli di hosting (cPanel, Plesk, …)
* sito-studio-grasso-v<versione>.tar.gz per server Linux/SSH, nginx, object storage
* SHA256SUMS.txt impronte SHA-256 (verificabili con `sha256sum -c`)
* BUILD-INFO.txt versione, commit, data, Node, Astro
*
* Il contenuto di dist/ è alla radice degli archivi (nessuna cartella di primo livello), con
* `.htaccess`. Voci ordinate, date fisse e header gzip senza il sistema operativo: a parità di
* dist/ (e di versione di Node.js) gli archivi sono identici anche tra Windows, macOS e Linux.
* Versione: variabile RELEASE_VERSION (tag vX.Y.Z) oppure package.json.
*/
process.env.TZ = 'UTC';
import { createHash } from 'node:crypto';
import { createReadStream, createWriteStream, existsSync, readFileSync, statSync } from 'node:fs';
import { mkdir, readFile, rm, writeFile } from 'node:fs/promises';
import { join, resolve } from 'node:path';
import { pipeline } from 'node:stream/promises';
import { TarArchive, ZipArchive } from 'archiver';
import { siteUrl } from '../site.config.mjs';
import {
archiveEpoch,
archiveNames,
distDir,
gitCommit,
listFiles,
releaseDir,
resolveVersion,
root,
} from './lib/release.mjs';
if (!existsSync(join(distDir, 'index.html'))) {
console.error('✘ dist/ assente o incompleta: eseguire prima `npm run build`.');
process.exit(1);
}
let version;
try {
version = resolveVersion();
} catch (e) {
console.error(`✘ ${e.message}`);
process.exit(1);
}
const names = archiveNames(version);
const files = listFiles(distDir);
const date = new Date(archiveEpoch() * 1000);
await rm(releaseDir, { recursive: true, force: true });
await mkdir(releaseDir, { recursive: true });
async function build(archive, target) {
const output = createWriteStream(target);
const done = pipeline(archive, output);
archive.on('warning', (err) => {
throw err;
});
for (const rel of files) {
// contenuto letto in memoria: l'ordine delle voci resta quello dell'elenco ordinato
archive.append(readFileSync(join(distDir, rel)), { name: rel, date, mode: 0o644 });
}
await archive.finalize();
await done;
}
/**
* Il byte 9 dell'header gzip indica il sistema operativo (zlib scrive 10 su Windows, 19 su
* macOS, 3 altrove): lo si fissa a 3 (Unix) così il tar.gz non dipende dalla piattaforma.
* Il byte non è coperto da alcun CRC (flag FHCRC assente; il CRC finale riguarda i dati).
*/
async function normalizeGzipOs(file) {
const buf = await readFile(file);
const isGzip = buf[0] === 0x1f && buf[1] === 0x8b && buf[2] === 8;
if (!isGzip || (buf[3] & 0x02) !== 0) throw new Error(`${file}: header gzip inatteso`);
if (buf[9] !== 3) {
buf[9] = 3;
await writeFile(file, buf);
}
}
await build(new ZipArchive({ zlib: { level: 9 } }), join(releaseDir, names.zip));
await build(new TarArchive({ gzip: true, gzipOptions: { level: 9 } }), join(releaseDir, names.tgz));
await normalizeGzipOs(join(releaseDir, names.tgz));
const sha256 = (file) =>
new Promise((ok, ko) => {
const hash = createHash('sha256');
createReadStream(file)
.on('data', (d) => hash.update(d))
.on('end', () => ok(hash.digest('hex')))
.on('error', ko);
});
const pkgLock = JSON.parse(readFileSync(resolve(root, 'package-lock.json'), 'utf8'));
const astroVersion = pkgLock.packages?.['node_modules/astro']?.version ?? 'sconosciuta';
const info = [
'Sito web dello Studio Grasso — Studio Tributario e Societario',
`Versione: ${version}`,
`Commit: ${gitCommit()}`,
`Data: ${new Date().toISOString()}`,
`Data dei file negli archivi: ${date.toISOString()}`,
`Node.js: ${process.version}`,
`Astro: ${astroVersion}`,
`SITE_URL: ${siteUrl()}`,
`File: ${files.length}`,
'',
'Pubblicazione: estrarre il contenuto dell’archivio nella cartella pubblica del sito',
'(es. public_html o httpdocs), includendo il file nascosto .htaccess. Vedi docs/DEPLOY.md.',
'',
].join('\n');
await writeFile(join(releaseDir, 'BUILD-INFO.txt'), info);
const sums = [];
for (const name of [names.zip, names.tgz, 'BUILD-INFO.txt']) {
sums.push(`${await sha256(join(releaseDir, name))} ${name}`);
}
await writeFile(join(releaseDir, 'SHA256SUMS.txt'), sums.join('\n') + '\n');
const kb = (f) => `${(statSync(join(releaseDir, f)).size / 1024).toFixed(1)} KB`;
console.log(`✔ Pacchetto v${version} creato in release/ (${files.length} file da dist/):`);
for (const f of [names.zip, names.tgz, 'SHA256SUMS.txt', 'BUILD-INFO.txt']) {
console.log(` ${f.padEnd(40)} ${kb(f)}`);
}