@materializecms/cli 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -4,6 +4,22 @@ Ogni versione, dalla più recente. Le novità in arrivo si scrivono sotto «Pros
 
 ## Prossima versione
 
+## 0.3.0 — 2026-11-01
+
+- **Backup fuori dal server**, ogni notte e cifrati, su uno spazio S3 compatibile (Cloudflare R2, Backblaze B2, Hetzner, Amazon S3…) o in una cartella WebDAV (Nextcloud, NAS Synology e QNAP…). Si attiva in Impostazioni → Backup; `materialize decrypt` rende di nuovo leggibili i file scaricati.
+- **Email più facile da configurare**: si sceglie il fornitore (Brevo, Postmark, Mailgun, Amazon SES, Gmail…) e il server si compila da solo; se la prova non riesce, il pannello spiega perché (porta bloccata, password rifiutata, mittente non verificato…); **Controlla il dominio** verifica SPF, DKIM e DMARC.
+- **Pannello più chiaro**: Impostazioni → Protezione divisa in Sicurezza, Backup e Registro attività; barra dell'editor a gruppi, con gli elementi meno usati in **⋯**; pannello sinistro dell'editor allargabile; menu a tendina, intestazioni e testi d'aiuto uniformi e più leggibili; pagina dedicata per gli indirizzi del pannello che non esistono; in Persone, chi entra con la sola password si riconosce a colpo d'occhio; accesso e installazione con l'aspetto del pannello.
+- **Chi ha fatto ogni versione**: la cronologia mostra il nome dell'autore accanto alla data.
+- **Informazioni su Materialize** in Impostazioni: versione, autore, licenza, novità, guida e licenze di terzi.
+
+## 0.2.0 — 2026-11-01
+
+- **Password dimenticata?** nella pagina di accesso: un link per email, valido un'ora. Senza email configurata, il comando `materialize reset-password` stampa il link sul server, anche per l'unico amministratore.
+- **Cronologia per le pagine sulla tela**: ogni versione si guarda su desktop, tablet e mobile prima di ripristinarla.
+- **Esporta la pagina in PDF o PNG** dall'editor, per mandarla al cliente: desktop, tablet e mobile, ognuno come un'unica immagine lunga.
+- **Guida per chi usa Materialize**, in `docs/guida`: installazione, editor, contenuti, lingue, SEO, persone, aggiornamenti, backup e problemi comuni.
+- **Sicurezza**: i link degli inviti e delle nuove password puntano sempre all'indirizzo pubblico del sito, mai a quello dichiarato da chi fa la richiesta. Consigliato aggiornare.
+
 ## 0.1.0 — 2026-10-31
 
 La prima versione pubblica.

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Cristiano Casazza
+Copyright (c) 2026 Cristiano Casazza Consulting
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/compose.yaml

@@ -1,6 +1,7 @@
 # Materialize with HTTPS, on a server where Docker is already there:
 #
-#   DOMAIN=example.com docker compose up -d
+#   echo "DOMAIN=example.com" > .env      (read by every docker compose command in this folder)
+#   docker compose up -d
 #   docker compose logs materialize      (the link to finish the installation in the browser)
 #
 # Caddy gets the Let's Encrypt certificate for the domain, which must already point to the server.
@@ -13,7 +14,7 @@ services:
     volumes:
       - site:/site
     environment:
-      MATERIALIZE_SITE_URL: https://${DOMAIN:?Indica il dominio, per esempio DOMAIN=example.com docker compose up -d}
+      MATERIALIZE_SITE_URL: https://${DOMAIN:?Indica il dominio nel file .env, per esempio DOMAIN=example.com}
       MATERIALIZE_TRUST_PROXY: "1"
       # Other variables for the site go here, for example ANTHROPIC_API_KEY.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@materializecms/cli",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Il comando materialize: sviluppo, produzione con aggiornamenti dal pannello, generazione del sito, backup, MCP.",
   "type": "module",
   "license": "MIT",
@@ -12,7 +12,7 @@
   "homepage": "https://github.com/materializecms/materialize#readme",
   "bugs": "https://github.com/materializecms/materialize/issues",
   "bin": {
-    "materialize": "./src/cli.js"
+    "materialize": "src/cli.js"
   },
   "exports": {
     ".": {
@@ -21,10 +21,10 @@
     }
   },
   "dependencies": {
-    "@materializecms/astro": "0.1.0",
-    "@materializecms/core": "0.1.0",
-    "@materializecms/db": "0.1.0",
-    "@materializecms/server": "0.1.0",
+    "@materializecms/astro": "0.3.0",
+    "@materializecms/core": "0.3.0",
+    "@materializecms/db": "0.3.0",
+    "@materializecms/server": "0.3.0",
     "@modelcontextprotocol/sdk": "1.32.2"
   },
   "peerDependencies": {
@@ -42,6 +42,16 @@
     "access": "public"
   },
   "changelog": [
+    {
+      "version": "0.3.0",
+      "date": "2026-11-01",
+      "notes": "- **Backup fuori dal server**, ogni notte e cifrati, su uno spazio S3 compatibile (Cloudflare R2, Backblaze B2, Hetzner, Amazon S3…) o in una cartella WebDAV (Nextcloud, NAS Synology e QNAP…). Si attiva in Impostazioni → Backup; `materialize decrypt` rende di nuovo leggibili i file scaricati.\n- **Email più facile da configurare**: si sceglie il fornitore (Brevo, Postmark, Mailgun, Amazon SES, Gmail…) e il server si compila da solo; se la prova non riesce, il pannello spiega perché (porta bloccata, password rifiutata, mittente non verificato…); **Controlla il dominio** verifica SPF, DKIM e DMARC.\n- **Pannello più chiaro**: Impostazioni → Protezione divisa in Sicurezza, Backup e Registro attività; barra dell'editor a gruppi, con gli elementi meno usati in **⋯**; pannello sinistro dell'editor allargabile; menu a tendina, intestazioni e testi d'aiuto uniformi e più leggibili; pagina dedicata per gli indirizzi del pannello che non esistono; in Persone, chi entra con la sola password si riconosce a colpo d'occhio; accesso e installazione con l'aspetto del pannello.\n- **Chi ha fatto ogni versione**: la cronologia mostra il nome dell'autore accanto alla data.\n- **Informazioni su Materialize** in Impostazioni: versione, autore, licenza, novità, guida e licenze di terzi."
+    },
+    {
+      "version": "0.2.0",
+      "date": "2026-11-01",
+      "notes": "- **Password dimenticata?** nella pagina di accesso: un link per email, valido un'ora. Senza email configurata, il comando `materialize reset-password` stampa il link sul server, anche per l'unico amministratore.\n- **Cronologia per le pagine sulla tela**: ogni versione si guarda su desktop, tablet e mobile prima di ripristinarla.\n- **Esporta la pagina in PDF o PNG** dall'editor, per mandarla al cliente: desktop, tablet e mobile, ognuno come un'unica immagine lunga.\n- **Guida per chi usa Materialize**, in `docs/guida`: installazione, editor, contenuti, lingue, SEO, persone, aggiornamenti, backup e problemi comuni.\n- **Sicurezza**: i link degli inviti e delle nuove password puntano sempre all'indirizzo pubblico del sito, mai a quello dichiarato da chi fa la richiesta. Consigliato aggiornare."
+    },
     {
       "version": "0.1.0",
       "date": "2026-10-31",

package/src/commands.js

@@ -4,8 +4,8 @@ import { copyFile, mkdir, open, readFile, rm, writeFile } from 'node:fs/promises
 import { dirname, join, relative, resolve } from 'node:path';
 import { styleText } from 'node:util';
 import { resolveRedirect } from '@materializecms/core/seo';
-import { createAuthStore, createContentStore, createSettingsStore, openDatabase } from '@materializecms/db';
-import { apiCaller, createFonts, createMcpServer, createMediaFiles, extractTarGz, restoreMedia, startServer, VERSION, } from '@materializecms/server';
+import { createActivityStore, createAuthStore, createContentStore, createSettingsStore, openDatabase, } from '@materializecms/db';
+import { apiCaller, createFonts, createMcpServer, createMediaFiles, decryptTree, extractTarGz, parseRecoveryKey, restoreMedia, startServer, VERSION, } from '@materializecms/server';
 import { findConfig, loadConfig } from './load-config.js';
 import { buildSite, exportFonts, exportMedia, hasSite, ProductionSite, startDevSite } from './site.js';
 import { RESTART } from './supervisor.js';
@@ -25,6 +25,12 @@ ${accent('materialize')} ${dim(VERSION)}
   materialize restore <file>
                        Rimette un backup (content-….db, o l'archivio completo materialize-….tar.gz);
                        il server va fermato
+  materialize reset-password <email>
+                       Un link per una nuova password, valido un'ora: per chi non può riceverlo per email
+                       (per esempio l'unico amministratore, senza email configurata)
+  materialize decrypt <cartella o file> [--key <chiave>]
+                       Decifra i backup scaricati dallo spazio esterno (S3, WebDAV); la chiave di
+                       ripristino si può dare anche con MATERIALIZE_BACKUP_KEY
   materialize --help   Mostra questo aiuto
 
 Opzioni
@@ -345,6 +351,111 @@ async function restore(args) {
     if (kept)
         console.log(dim(`  Il database di prima è in ${relative(process.cwd(), kept)}, se servisse tornare indietro.`));
 }
+/**
+ * A one-time link for a new password, printed here: the way back in for someone who cannot get it
+ * by email, such as the only administrator of a site without email. Only who can run commands on
+ * the server can ask for it. The server may be running.
+ */
+async function resetPassword(args) {
+    const email = args
+        .find((a) => !a.startsWith('--'))
+        ?.trim()
+        .toLowerCase();
+    const path = findConfig(process.cwd());
+    if (!email || !path) {
+        console.error(fail(!email
+            ? 'Indica l’email: materialize reset-password <email>'
+            : 'Non trovo materialize.config.ts in questa cartella: lancia il comando dalla cartella del sito.'));
+        process.exit(1);
+    }
+    const config = await loadConfig(path);
+    const database = await openDatabase(config.database);
+    try {
+        const auth = createAuthStore(database.db);
+        const user = await auth.findForLogin(email);
+        if (!user) {
+            console.error(fail(`Nessun account con l’email ${email}.`));
+            process.exitCode = 1;
+            return;
+        }
+        const { token } = await auth.createInvite({
+            kind: 'reset',
+            email: user.email,
+            name: user.name,
+            role: user.role,
+            userId: user.id,
+            ttlMs: 60 * 60 * 1000,
+        });
+        await createActivityStore(database.db).record({
+            userId: null,
+            userName: '',
+            action: 'password.reset_cli',
+            target: user.email,
+            detail: null,
+            ip: 'server',
+        });
+        const base = config.site.url?.replace(/\/+$/, '') ?? `http://localhost:${config.server.port}`;
+        console.log(`  ${ok('✓')} Link per una nuova password di ${user.name} (${user.email}), valido un’ora:`);
+        console.log();
+        console.log(`    ${accent(`${base}/admin/_invite/${token}`)}`);
+        console.log();
+        console.log(dim('  Chi lo apre sceglie la password. La verifica in due passaggi, se attiva, resta.'));
+    }
+    finally {
+        database.close();
+    }
+}
+/**
+ * The backups sent outside the server, downloaded with any tool, made readable again: every .mzb
+ * file is decrypted next to itself. The key comes from --key, MATERIALIZE_BACKUP_KEY or, in the
+ * folder of a site that still has its database, from its settings.
+ */
+async function decrypt(args) {
+    const flag = args.indexOf('--key');
+    const source = args.find((a, i) => !a.startsWith('--') && (flag < 0 || i !== flag + 1));
+    if (!source) {
+        console.error(fail('Indica la cartella (o il file) da decifrare: materialize decrypt <cartella> --key <chiave>'));
+        process.exit(1);
+    }
+    let text = flag >= 0 ? args[flag + 1] : process.env.MATERIALIZE_BACKUP_KEY;
+    if (!text) {
+        const path = findConfig(process.cwd());
+        if (path) {
+            const database = await openDatabase((await loadConfig(path)).database).catch(() => null);
+            if (database) {
+                text = (await createSettingsStore(database.db).get('offsite'))?.key;
+                database.close();
+            }
+        }
+    }
+    if (!text) {
+        console.error(fail('Manca la chiave di ripristino: --key mzk1-… oppure MATERIALIZE_BACKUP_KEY.'));
+        process.exit(1);
+    }
+    let key;
+    try {
+        key = parseRecoveryKey(text);
+    }
+    catch (error) {
+        console.error(fail(describeError(error)));
+        process.exit(1);
+    }
+    try {
+        const done = await decryptTree(resolve(source), key);
+        console.log(`  ${ok('✓')} ${done.length} ${done.length === 1 ? 'file decifrato' : 'file decifrati'}, accanto agli originali.`);
+        const db = done
+            .filter((f) => /content-[^/\\]+\.db$/.test(f))
+            .sort()
+            .at(-1);
+        if (db)
+            // The shorter of the two ways to write the path.
+            console.log(dim(`  Per rimettere il database (a server fermo): npx materialize restore ${[relative(process.cwd(), db), db].sort((x, y) => x.length - y.length)[0]}`));
+    }
+    catch (error) {
+        console.error(fail(describeError(error)));
+        process.exit(1);
+    }
+}
 const [command = 'help', ...args] = process.argv.slice(2);
 if (command === 'dev' || command === 'start' || command === 'build') {
     await run(command, args);
@@ -352,6 +463,12 @@ if (command === 'dev' || command === 'start' || command === 'build') {
 else if (command === 'mcp') {
     await mcp(args);
 }
+else if (command === 'decrypt') {
+    await decrypt(args);
+}
+else if (command === 'reset-password') {
+    await resetPassword(args);
+}
 else if (command === 'restore') {
     await restore(args);
 }