@materializecms/cli 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -4,6 +4,14 @@ 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.

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@materializecms/cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Il comando materialize: sviluppo, produzione con aggiornamenti dal pannello, generazione del sito, backup, MCP.",
   "type": "module",
   "license": "MIT",
@@ -21,10 +21,10 @@
     }
   },
   "dependencies": {
-    "@materializecms/astro": "0.2.0",
-    "@materializecms/core": "0.2.0",
-    "@materializecms/db": "0.2.0",
-    "@materializecms/server": "0.2.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,11 @@
     "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",

package/src/commands.js

@@ -5,7 +5,7 @@ import { dirname, join, relative, resolve } from 'node:path';
 import { styleText } from 'node:util';
 import { resolveRedirect } from '@materializecms/core/seo';
 import { createActivityStore, createAuthStore, createContentStore, createSettingsStore, openDatabase, } from '@materializecms/db';
-import { apiCaller, createFonts, createMcpServer, createMediaFiles, extractTarGz, restoreMedia, startServer, VERSION, } from '@materializecms/server';
+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';
@@ -28,6 +28,9 @@ ${accent('materialize')} ${dim(VERSION)}
   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
@@ -402,6 +405,57 @@ async function resetPassword(args) {
         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);
@@ -409,6 +463,9 @@ 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);
 }