koa-classic-server 2.0.0 → 2.1.2

package/docs/template-engine/esempi-incrementali.js

@@ -0,0 +1,192 @@
+const koa = require("koa");
+const app = new koa();
+const port = 3000;
+const classicServer = require("../../index.cjs");
+const ejs = require("ejs");
+const path = require("path");
+
+// ============================================================
+// ESEMPIO 1: Nessun dato passato
+// ============================================================
+// Template: esempio1-nessun-dato.ejs
+// Uso: Non serve passare nessun dato
+// URL: http://localhost:3000/esempio1-nessun-dato.ejs
+
+const esempio1 = async (ctx, next, filePath) => {
+  try {
+    // Nessun dato passato - il template non usa variabili
+    ctx.body = await ejs.renderFile(filePath, {});
+    ctx.type = 'text/html';
+  } catch (error) {
+    console.error('Errore:', error.message);
+    ctx.status = 500;
+    ctx.body = `<h1>Errore</h1><pre>${error.message}</pre>`;
+  }
+};
+
+// ============================================================
+// ESEMPIO 2: Una sola variabile
+// ============================================================
+// Template: esempio2-una-variabile.ejs
+// Uso: Passa solo "nome"
+// URL: http://localhost:3000/esempio2-una-variabile.ejs
+
+const esempio2 = async (ctx, next, filePath) => {
+  try {
+    // Passa UNA variabile
+    ctx.body = await ejs.renderFile(filePath, {
+      nome: 'Mario'
+    });
+    ctx.type = 'text/html';
+  } catch (error) {
+    console.error('Errore:', error.message);
+    ctx.status = 500;
+    ctx.body = `<h1>Errore</h1><pre>${error.message}</pre>`;
+  }
+};
+
+// ============================================================
+// ESEMPIO 3: Più variabili
+// ============================================================
+// Template: esempio3-piu-variabili.ejs
+// Uso: Passa "nome", "eta", "citta"
+// URL: http://localhost:3000/esempio3-piu-variabili.ejs
+
+const esempio3 = async (ctx, next, filePath) => {
+  try {
+    // Passa PIÙ variabili
+    ctx.body = await ejs.renderFile(filePath, {
+      nome: 'Mario',
+      eta: 30,
+      citta: 'Roma'
+    });
+    ctx.type = 'text/html';
+  } catch (error) {
+    console.error('Errore:', error.message);
+    ctx.status = 500;
+    ctx.body = `<h1>Errore</h1><pre>${error.message}</pre>`;
+  }
+};
+
+// ============================================================
+// ESEMPIO 4: Condizionale (if/else)
+// ============================================================
+// Template: esempio4-condizionale.ejs
+// Uso: Passa "autenticato" e "nome"
+// URL: http://localhost:3000/esempio4-condizionale.ejs
+
+const esempio4 = async (ctx, next, filePath) => {
+  try {
+    // Passa variabili per logica condizionale
+    ctx.body = await ejs.renderFile(filePath, {
+      autenticato: true,  // Cambia in false per vedere il messaggio diverso
+      nome: 'Mario'
+    });
+    ctx.type = 'text/html';
+  } catch (error) {
+    console.error('Errore:', error.message);
+    ctx.status = 500;
+    ctx.body = `<h1>Errore</h1><pre>${error.message}</pre>`;
+  }
+};
+
+// ============================================================
+// ESEMPIO 5: Loop (forEach)
+// ============================================================
+// Template: esempio5-loop.ejs
+// Uso: Passa array "prodotti"
+// URL: http://localhost:3000/esempio5-loop.ejs
+
+const esempio5 = async (ctx, next, filePath) => {
+  try {
+    // Passa un array per il loop
+    ctx.body = await ejs.renderFile(filePath, {
+      prodotti: ['Laptop', 'Mouse', 'Tastiera', 'Monitor']
+    });
+    ctx.type = 'text/html';
+  } catch (error) {
+    console.error('Errore:', error.message);
+    ctx.status = 500;
+    ctx.body = `<h1>Errore</h1><pre>${error.message}</pre>`;
+  }
+};
+
+// ============================================================
+// FUNZIONE RENDER UNIVERSALE
+// ============================================================
+// Questa funzione sceglie quale esempio usare in base al file
+
+const templateRender = async (ctx, next, filePath) => {
+  const fileName = path.basename(filePath);
+
+  // Sceglie la funzione giusta in base al nome del file
+  switch(fileName) {
+    case 'esempio1-nessun-dato.ejs':
+      return esempio1(ctx, next, filePath);
+
+    case 'esempio2-una-variabile.ejs':
+      return esempio2(ctx, next, filePath);
+
+    case 'esempio3-piu-variabili.ejs':
+      return esempio3(ctx, next, filePath);
+
+    case 'esempio4-condizionale.ejs':
+      return esempio4(ctx, next, filePath);
+
+    case 'esempio5-loop.ejs':
+      return esempio5(ctx, next, filePath);
+
+    default:
+      // Per altri file .ejs, non passa dati
+      try {
+        ctx.body = await ejs.renderFile(filePath, {});
+        ctx.type = 'text/html';
+      } catch (error) {
+        console.error('Errore:', error.message);
+        ctx.status = 500;
+        ctx.body = `<h1>Errore</h1><pre>${error.message}</pre>`;
+      }
+  }
+};
+
+// ============================================================
+// CONFIGURAZIONE SERVER
+// ============================================================
+
+app.use(
+  classicServer(
+    __dirname + "/examples",
+    {
+      showDirContents: true,
+      template: {
+        render: templateRender,
+        ext: ["ejs", "EJS"],
+      },
+    }
+  )
+);
+
+app.listen(port, () => {
+  console.log("\n" + "=".repeat(60));
+  console.log("✅ SERVER AVVIATO");
+  console.log("=".repeat(60));
+  console.log(`URL: http://localhost:${port}\n`);
+
+  console.log("📚 ESEMPI DISPONIBILI:");
+  console.log("─".repeat(60));
+  console.log("1️⃣  Nessun dato:");
+  console.log("    http://localhost:3000/esempio1-nessun-dato.ejs");
+  console.log("");
+  console.log("2️⃣  Una variabile:");
+  console.log("    http://localhost:3000/esempio2-una-variabile.ejs");
+  console.log("");
+  console.log("3️⃣  Più variabili:");
+  console.log("    http://localhost:3000/esempio3-piu-variabili.ejs");
+  console.log("");
+  console.log("4️⃣  Condizionale (if/else):");
+  console.log("    http://localhost:3000/esempio4-condizionale.ejs");
+  console.log("");
+  console.log("5️⃣  Loop (forEach):");
+  console.log("    http://localhost:3000/esempio5-loop.ejs");
+  console.log("=".repeat(60) + "\n");
+});

package/docs/template-engine/examples/esempio1-nessun-dato.ejs

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="it">
+<head>
+    <meta charset="UTF-8">
+    <title>Esempio 1 - Nessun Dato</title>
+</head>
+<body>
+    <h1>Ciao Mondo!</h1>
+    <p>Questo è un template EJS che non usa nessuna variabile.</p>
+    <p>È identico a un normale file HTML.</p>
+</body>
+</html>

package/docs/template-engine/examples/esempio2-una-variabile.ejs

@@ -0,0 +1,11 @@
+<!DOCTYPE html>
+<html lang="it">
+<head>
+    <meta charset="UTF-8">
+    <title>Esempio 2 - Una Variabile</title>
+</head>
+<body>
+    <h1>Benvenuto!</h1>
+    <p>Il tuo nome è: <strong><%= nome %></strong></p>
+</body>
+</html>

package/docs/template-engine/examples/esempio3-piu-variabili.ejs

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html lang="it">
+<head>
+    <meta charset="UTF-8">
+    <title>Esempio 3 - Più Variabili</title>
+</head>
+<body>
+    <h1>Informazioni</h1>
+    <ul>
+        <li><strong>Nome:</strong> <%= nome %></li>
+        <li><strong>Età:</strong> <%= eta %></li>
+        <li><strong>Città:</strong> <%= citta %></li>
+    </ul>
+</body>
+</html>

package/docs/template-engine/examples/esempio4-condizionale.ejs

@@ -0,0 +1,18 @@
+<!DOCTYPE html>
+<html lang="it">
+<head>
+    <meta charset="UTF-8">
+    <title>Esempio 4 - Condizionale</title>
+</head>
+<body>
+    <h1>Controllo Accesso</h1>
+
+    <% if (autenticato) { %>
+        <p>✅ Benvenuto <strong><%= nome %></strong>!</p>
+        <p>Sei autenticato.</p>
+    <% } else { %>
+        <p>❌ Non sei autenticato.</p>
+        <p>Effettua il login per continuare.</p>
+    <% } %>
+</body>
+</html>

package/docs/template-engine/examples/esempio5-loop.ejs

@@ -0,0 +1,18 @@
+<!DOCTYPE html>
+<html lang="it">
+<head>
+    <meta charset="UTF-8">
+    <title>Esempio 5 - Loop</title>
+</head>
+<body>
+    <h1>Lista Prodotti</h1>
+
+    <ul>
+    <% prodotti.forEach(function(prodotto) { %>
+        <li><%= prodotto %></li>
+    <% }); %>
+    </ul>
+
+    <p>Totale: <%= prodotti.length %> prodotti</p>
+</body>
+</html>

package/docs/template-engine/examples/index-esempi.html

@@ -0,0 +1,181 @@
+<!DOCTYPE html>
+<html lang="it">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Esempi Incrementali EJS</title>
+    <style>
+        body {
+            font-family: Arial, sans-serif;
+            max-width: 800px;
+            margin: 50px auto;
+            padding: 20px;
+            background: #f5f5f5;
+        }
+        h1 {
+            color: #333;
+            border-bottom: 3px solid #007bff;
+            padding-bottom: 10px;
+        }
+        .esempio {
+            background: white;
+            padding: 20px;
+            margin: 20px 0;
+            border-radius: 8px;
+            box-shadow: 0 2px 4px rgba(0,0,0,0.1);
+        }
+        .esempio h2 {
+            margin-top: 0;
+            color: #007bff;
+        }
+        .esempio p {
+            color: #666;
+            margin: 10px 0;
+        }
+        .esempio code {
+            background: #f0f0f0;
+            padding: 2px 6px;
+            border-radius: 3px;
+            font-family: 'Courier New', monospace;
+        }
+        a.btn {
+            display: inline-block;
+            padding: 10px 20px;
+            background: #007bff;
+            color: white;
+            text-decoration: none;
+            border-radius: 4px;
+            margin-top: 10px;
+        }
+        a.btn:hover {
+            background: #0056b3;
+        }
+        .code-block {
+            background: #f8f9fa;
+            border-left: 4px solid #007bff;
+            padding: 15px;
+            margin: 15px 0;
+            font-family: 'Courier New', monospace;
+            font-size: 14px;
+            overflow-x: auto;
+        }
+    </style>
+</head>
+<body>
+    <h1>📚 Esempi Incrementali - Template EJS</h1>
+    <p>Questa pagina mostra esempi progressivi di template EJS, partendo dal più semplice al più complesso.</p>
+
+    <!-- ESEMPIO 1 -->
+    <div class="esempio">
+        <h2>1️⃣ Esempio 1: Nessun Dato</h2>
+        <p>Template EJS senza variabili - equivale a un normale file HTML.</p>
+
+        <div class="code-block">
+// Server: Non passa nessun dato
+ctx.body = await ejs.renderFile(filePath, {});
+
+// Template: Non usa variabili
+&lt;h1&gt;Ciao Mondo!&lt;/h1&gt;
+        </div>
+
+        <a href="/esempio1-nessun-dato.ejs" class="btn">Vedi Esempio 1</a>
+    </div>
+
+    <!-- ESEMPIO 2 -->
+    <div class="esempio">
+        <h2>2️⃣ Esempio 2: Una Variabile</h2>
+        <p>Template che usa <strong>una sola variabile</strong>.</p>
+
+        <div class="code-block">
+// Server: Passa UNA variabile
+ctx.body = await ejs.renderFile(filePath, {
+  nome: 'Mario'
+});
+
+// Template: Usa la variabile
+Il tuo nome è: &lt;%= nome %&gt;
+        </div>
+
+        <a href="/esempio2-una-variabile.ejs" class="btn">Vedi Esempio 2</a>
+    </div>
+
+    <!-- ESEMPIO 3 -->
+    <div class="esempio">
+        <h2>3️⃣ Esempio 3: Più Variabili</h2>
+        <p>Template che usa <strong>più variabili</strong>.</p>
+
+        <div class="code-block">
+// Server: Passa PIÙ variabili
+ctx.body = await ejs.renderFile(filePath, {
+  nome: 'Mario',
+  eta: 30,
+  citta: 'Roma'
+});
+
+// Template: Usa tutte le variabili
+Nome: &lt;%= nome %&gt;
+Età: &lt;%= eta %&gt;
+Città: &lt;%= citta %&gt;
+        </div>
+
+        <a href="/esempio3-piu-variabili.ejs" class="btn">Vedi Esempio 3</a>
+    </div>
+
+    <!-- ESEMPIO 4 -->
+    <div class="esempio">
+        <h2>4️⃣ Esempio 4: Condizionale (if/else)</h2>
+        <p>Template con <strong>logica condizionale</strong>.</p>
+
+        <div class="code-block">
+// Server: Passa variabili per if/else
+ctx.body = await ejs.renderFile(filePath, {
+  autenticato: true,
+  nome: 'Mario'
+});
+
+// Template: Usa if/else
+&lt;% if (autenticato) { %&gt;
+  Benvenuto &lt;%= nome %&gt;!
+&lt;% } else { %&gt;
+  Non sei autenticato.
+&lt;% } %&gt;
+        </div>
+
+        <a href="/esempio4-condizionale.ejs" class="btn">Vedi Esempio 4</a>
+    </div>
+
+    <!-- ESEMPIO 5 -->
+    <div class="esempio">
+        <h2>5️⃣ Esempio 5: Loop (forEach)</h2>
+        <p>Template con <strong>ciclo forEach</strong> su array.</p>
+
+        <div class="code-block">
+// Server: Passa un array
+ctx.body = await ejs.renderFile(filePath, {
+  prodotti: ['Laptop', 'Mouse', 'Tastiera']
+});
+
+// Template: Loop sull'array
+&lt;% prodotti.forEach(function(prodotto) { %&gt;
+  &lt;li&gt;&lt;%= prodotto %&gt;&lt;/li&gt;
+&lt;% }); %&gt;
+        </div>
+
+        <a href="/esempio5-loop.ejs" class="btn">Vedi Esempio 5</a>
+    </div>
+
+    <hr style="margin: 40px 0; border: 1px solid #ddd;">
+
+    <div class="esempio" style="background: #e3f2fd;">
+        <h2>💡 Punti Chiave</h2>
+        <ul>
+            <li><strong>Esempio 1:</strong> Template senza variabili → Non serve passare dati</li>
+            <li><strong>Esempio 2:</strong> Template con 1 variabile → Passa 1 dato</li>
+            <li><strong>Esempio 3:</strong> Template con N variabili → Passa N dati</li>
+            <li><strong>Esempio 4:</strong> Template con if/else → Passa dati per la logica</li>
+            <li><strong>Esempio 5:</strong> Template con forEach → Passa array</li>
+        </ul>
+        <p><strong>Regola:</strong> Devi passare esattamente i dati che il template usa!</p>
+    </div>
+</body>
+</html>

package/docs/template-engine/examples/index.html

@@ -0,0 +1,40 @@
+<!DOCTYPE html>
+<html lang="it">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Test koa-classic-server</title>
+    <style>
+        body {
+            font-family: Arial, sans-serif;
+            max-width: 800px;
+            margin: 50px auto;
+            padding: 20px;
+        }
+        h1 { color: #333; }
+        a {
+            display: block;
+            padding: 10px;
+            margin: 10px 0;
+            background: #007bff;
+            color: white;
+            text-decoration: none;
+            border-radius: 4px;
+        }
+        a:hover { background: #0056b3; }
+    </style>
+</head>
+<body>
+    <h1>Test koa-classic-server</h1>
+
+    <h2>File Statici</h2>
+    <p>✅ Questo è un file HTML statico</p>
+
+    <h2>Template EJS</h2>
+    <a href="/test.ejs">Apri test.ejs (Template EJS)</a>
+    <a href="/test.ejs?name=Mario&age=30">test.ejs con query parameters</a>
+
+    <h2>Directory Listing</h2>
+    <a href="/">Torna alla root (directory listing)</a>
+</body>
+</html>

package/docs/template-engine/examples/test.ejs

@@ -0,0 +1,64 @@
+<!DOCTYPE html>
+<html lang="it">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title><%= title || 'Test EJS' %></title>
+    <style>
+        body {
+            font-family: Arial, sans-serif;
+            max-width: 800px;
+            margin: 50px auto;
+            padding: 20px;
+            background: #f5f5f5;
+        }
+        .card {
+            background: white;
+            padding: 20px;
+            border-radius: 8px;
+            box-shadow: 0 2px 4px rgba(0,0,0,0.1);
+            margin: 20px 0;
+        }
+        h1 { color: #333; }
+        .info { color: #666; }
+        .success { color: green; font-weight: bold; }
+    </style>
+</head>
+<body>
+    <div class="card">
+        <h1>✅ EJS Template Funzionante!</h1>
+        <p class="success">Se vedi questo messaggio, il template EJS sta funzionando correttamente.</p>
+    </div>
+
+    <div class="card">
+        <h2>📊 Informazioni</h2>
+        <p><strong>Titolo:</strong> <%= title %></p>
+        <p><strong>User:</strong> <%= user.name %></p>
+        <p><strong>Path:</strong> <%= path %></p>
+        <p><strong>File Template:</strong> <%= filePath %></p>
+        <p><strong>Timestamp:</strong> <%= timestamp %></p>
+    </div>
+
+    <div class="card">
+        <h2>🔍 Query Parameters</h2>
+        <% if (Object.keys(query).length > 0) { %>
+            <ul>
+            <% Object.keys(query).forEach(function(key) { %>
+                <li><strong><%= key %>:</strong> <%= query[key] %></li>
+            <% }); %>
+            </ul>
+        <% } else { %>
+            <p class="info">Nessun parametro query. Prova ad aggiungere ?name=test alla URL</p>
+        <% } %>
+    </div>
+
+    <div class="card">
+        <h2>📝 Note</h2>
+        <ul>
+            <li>Questo è un template EJS renderizzato dinamicamente</li>
+            <li>I dati vengono passati dalla funzione <code>templateRender</code></li>
+            <li>Puoi modificare questo file e ricaricare la pagina</li>
+        </ul>
+    </div>
+</body>
+</html>