roster-server 1.8.0 → 1.8.4

package/.claude/settings.local.json

@@ -3,7 +3,8 @@
     "allow": [
       "Bash(node:*)",
       "Bash(timeout:*)",
-      "Bash(rm:*)"
+      "Bash(rm:*)",
+      "Bash(git checkout:*)"
     ],
     "deny": []
   }

package/README.md

@@ -162,6 +162,31 @@ When creating a new `RosterServer` instance, you can pass the following options:
 - `wwwPath` (string): Path to your `www` directory containing your sites.
 - `greenlockStorePath` (string): Directory for Greenlock configuration.
 - `staging` (boolean): Set to `true` to use Let's Encrypt's staging environment (for testing).
+- `local` (boolean): Set to `true` to run in local development mode.
+
+## 🏠 Local Development Mode
+
+For local development and testing, you can run RosterServer in local mode by setting `local: true`. This mode is perfect for development environments where you don't need SSL certificates or production features.
+
+When `{ local: true }` is enabled, RosterServer **Skips SSL/HTTPS**: Runs pure HTTP servers instead of HTTPS.
+
+### Setting Up Local Mode
+
+```javascript
+const server = new Roster({
+    wwwPath: '/srv/www',
+    local: true  // Enable local development mode
+});
+server.start();
+```
+
+### Port Assignment
+
+In local mode, domains are automatically assigned ports starting from 3000:
+
+- `example.com` → `http://localhost:3000`
+- `api.example.com` → `http://localhost:3001`  
+- And so on...
 
 ## 🧂 A Touch of Magic
 

package/demo/roster/server.js

@@ -2,6 +2,7 @@ const Roster = require('../../index.js');
 const path = require('path');
 
 const roster = new Roster({
+    local: true,
     email: 'admin@example.com',
     wwwPath: path.join(__dirname, '..', 'www'),
 });

package/demo/www/example.com/index.js

@@ -1,6 +1,6 @@
 module.exports = (httpsServer) => {
     return (req, res) => {
         res.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
-        res.end('"Loco de pensar, queriendo entrar en razón, y el corazón tiene razones que la propia razón nunca entenderá."');
+        res.end('"example.com: Loco de pensar, queriendo entrar en razón, y el corazón tiene razones que la propia razón nunca entenderá."');
     };
 };

package/demo/www/express.example.com/index.js

@@ -4,7 +4,7 @@ module.exports = (httpsServer) => {
     const app = express();
     app.get('/', (req, res) => {
         res.setHeader('Content-Type', 'text/plain; charset=utf-8');
-        res.send('"Loco de pensar, queriendo entrar en razón, y el corazón tiene razones que la propia razón nunca entenderá."');
+        res.send('"subdomain.example.com: Loco de pensar, queriendo entrar en razón, y el corazón tiene razones que la propia razón nunca entenderá."');
     });
 
     return app;

package/demo/www/subdomain.example.com/index.js

@@ -1,6 +1,6 @@
 module.exports = (httpsServer) => {
     return (req, res) => {
         res.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
-        res.end('"Loco de pensar, queriendo entrar en razón, y el corazón tiene razones que la propia razón nunca entenderá."');
+        res.end('"subdomain.example.com: Crazy from thinking, wanting to be reasonable, and the heart has reasons that reason itself will never understand."');
     };
 };

package/index.js

@@ -1,9 +1,11 @@
 const fs = require('fs');
 const path = require('path');
+const http = require('http');
 const https = require('https');
 const tls = require('tls');
 const { EventEmitter } = require('events');
 const Greenlock = require('greenlock-express');
+const log = require('lemonlog')('roster');
 
 // Virtual Server that completely isolates applications
 class VirtualServer extends EventEmitter {
@@ -79,6 +81,7 @@ class Roster {
         this.greenlockStorePath = options.greenlockStorePath || path.join(basePath, 'greenlock.d');
         this.staging = options.staging || false;
         this.cluster = options.cluster || false;
+        this.local = options.local || false;
         this.domains = [];
         this.sites = {};
         this.domainServers = {}; // Store separate servers for each domain
@@ -87,7 +90,7 @@ class Roster {
         this.filename = options.filename || 'index';
 
         const port = options.port === undefined ? 443 : options.port;
-        if (port === 80) {
+        if (port === 80 && !this.local) {
             throw new Error('⚠️  Port 80 is reserved for ACME challenge. Please use a different port.');
         }
         this.defaultPort = port;
@@ -96,7 +99,7 @@ class Roster {
     async loadSites() {
         // Check if wwwPath exists
         if (!fs.existsSync(this.wwwPath)) {
-            console.warn(`⚠️  WWW path does not exist: ${this.wwwPath}`);
+            log.warn(`⚠️  WWW path does not exist: ${this.wwwPath}`);
             return;
         }
 
@@ -123,7 +126,7 @@ class Roster {
                         siteApp = siteApp.default || siteApp;
                         break;
                     } catch (err) {
-                        console.warn(`⚠️  Error loading ${indexPath}:`, err);
+                        log.warn(`⚠️  Error loading ${indexPath}:`, err);
                     }
                 }
             }
@@ -135,9 +138,9 @@ class Roster {
                     this.sites[d] = siteApp;
                 });
 
-                console.log(`✅  Loaded site: ${domain}`);
+                log.info(`(✔) Loaded site: ${domain}`);
             } else {
-                console.warn(`⚠️  No index file (js/mjs/cjs) found in ${domainPath}`);
+                log.warn(`⚠️  No index file (js/mjs/cjs) found in ${domainPath}`);
             }
         }
     }
@@ -215,16 +218,16 @@ class Roster {
             const currentConfigContentFormatted = JSON.stringify(currentConfig, null, 2);
 
             if (newConfigContent === currentConfigContentFormatted) {
-                console.log('ℹ️  Configuration has not changed. config.json will not be overwritten.');
+                log.info('ℹ️  Configuration has not changed. config.json will not be overwritten.');
                 return;
             }
-            console.log('🔄  Configuration has changed. config.json will be updated.');
+            log.info('🔄  Configuration has changed. config.json will be updated.');
         } else {
-            console.log('🆕  config.json does not exist. A new one will be created.');
+            log.info('🆕  config.json does not exist. A new one will be created.');
         }
 
         fs.writeFileSync(configPath, JSON.stringify(newConfig, null, 2));
-        console.log(`📁  config.json generated at ${configPath}`);
+        log.info(`📁  config.json generated at ${configPath}`);
     }
 
     handleRequest(req, res) {
@@ -268,7 +271,7 @@ class Roster {
             this.sites[domainKey] = requestHandler;
         });
 
-        console.log(`✅  Registered site: ${domain}${port !== this.defaultPort ? ':' + port : ''}`);
+        log.info(`(✔) Registered site: ${domain}${port !== this.defaultPort ? ':' + port : ''}`);
         return this;
     }
 
@@ -277,7 +280,7 @@ class Roster {
         if (parts.length === 2) {
             const domain = parts[0];
             const port = parseInt(parts[1]);
-            if (port === 80) {
+            if (port === 80 && !this.local) {
                 throw new Error('⚠️  Port 80 is reserved for ACME challenge. Please use a different port.');
             }
             return { domain, port };
@@ -307,9 +310,72 @@ class Roster {
         return null;
     }
 
+    // Start server in local mode with HTTP - simplified version
+    startLocalMode() {
+        const startPort = 3000;
+        let currentPort = startPort;
+        
+        // Create a simple HTTP server for each domain with sequential ports
+        for (const [hostKey, siteApp] of Object.entries(this.sites)) {
+            const domain = hostKey.split(':')[0]; // Remove port if present
+            
+            // Skip www domains in local mode
+            if (domain.startsWith('www.')) {
+                continue;
+            }
+            
+            const port = currentPort; // Capture current port value
+            
+            // Create virtual server for the domain
+            const virtualServer = this.createVirtualServer(domain);
+            this.domainServers[domain] = virtualServer;
+            
+            // Initialize app with virtual server
+            const appHandler = siteApp(virtualServer);
+            
+            // Create simple dispatcher for this domain
+            const dispatcher = (req, res) => {
+                if (virtualServer.requestListeners.length > 0) {
+                    virtualServer.processRequest(req, res);
+                } else if (appHandler) {
+                    appHandler(req, res);
+                } else {
+                    res.writeHead(404);
+                    res.end('Site not found');
+                }
+            };
+            
+            // Create HTTP server for this domain
+            const httpServer = http.createServer(dispatcher);
+            this.portServers[port] = httpServer;
+            
+            httpServer.listen(port, 'localhost', () => {
+                log.info(`🌐 ${domain} → http://localhost:${port}`);
+            });
+            
+            httpServer.on('error', (error) => {
+                log.error(`❌ Error on port ${port} for ${domain}:`, error.message);
+            });
+            
+            currentPort++;
+        }
+        
+        log.info(`(✔) Started ${currentPort - startPort} sites in local mode`);
+        return Promise.resolve();
+    }
+
     async start() {
         await this.loadSites();
-        this.generateConfigJson();
+        
+        // Skip Greenlock configuration generation in local mode
+        if (!this.local) {
+            this.generateConfigJson();
+        }
+
+        // Handle local mode with simple HTTP server
+        if (this.local) {
+            return this.startLocalMode();
+        }
 
         const greenlock = Greenlock.init({
             packageRoot: __dirname,
@@ -379,7 +445,7 @@ class Roster {
             };
 
             httpServer.listen(80, this.hostname, () => {
-                console.log('HTTP server listening on port 80');
+                log.info('HTTP server listening on port 80');
             });
 
             // Handle different port types
@@ -393,7 +459,7 @@ class Roster {
                     this.portServers[portNum] = httpsServer;
                     
                     httpsServer.listen(portNum, this.hostname, () => {
-                        console.log(`HTTPS server listening on port ${portNum}`);
+                        log.info(`HTTPS server listening on port ${portNum}`);
                     });
                 } else {
                     // Create HTTPS server for custom ports using Greenlock certificates
@@ -427,20 +493,23 @@ class Roster {
                     const httpsServer = https.createServer(httpsOptions, dispatcher);
                     
                     httpsServer.on('error', (error) => {
-                        console.error(`HTTPS server error on port ${portNum}:`, error.message);
+                        log.error(`HTTPS server error on port ${portNum}:`, error.message);
                     });
                     
                     httpsServer.on('tlsClientError', (error) => {
-                        console.error(`TLS error on port ${portNum}:`, error.message);
+                        // Suppress HTTP request errors to avoid log spam
+                        if (!error.message.includes('http request')) {
+                            log.error(`TLS error on port ${portNum}:`, error.message);
+                        }
                     });
                     
                     this.portServers[portNum] = httpsServer;
                     
                     httpsServer.listen(portNum, this.hostname, (error) => {
                         if (error) {
-                            console.error(`Failed to start HTTPS server on port ${portNum}:`, error.message);
+                            log.error(`Failed to start HTTPS server on port ${portNum}:`, error.message);
                         } else {
-                            console.log(`HTTPS server listening on port ${portNum}`);
+                            log.info(`HTTPS server listening on port ${portNum}`);
                         }
                     });
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "roster-server",
-    "version": "1.8.0",
+    "version": "1.8.4",
     "description": "👾 RosterServer - A domain host router to host multiple HTTPS.",
     "main": "index.js",
     "scripts": {
@@ -34,6 +34,7 @@
     },
     "homepage": "https://github.com/clasen/RosterServer#readme",
     "dependencies": {
-        "greenlock-express": "^4.0.3"
+        "greenlock-express": "^4.0.3",
+        "lemonlog": "^1.2.0"
     }
 }