roster-server 2.3.6 → 2.3.10

package/README.md

@@ -309,12 +309,13 @@ await roster.start();
 const url = roster.getUrl('example.com');
 console.log(url); 
 // Local mode: http://localhost:9465
+// Local subdomain: http://api.localhost:9465
 // Production mode: https://example.com
 ```
 
 This method:
 - Returns the correct URL based on your environment (`local: true/false`)
-- In **local mode**: Returns `http://localhost:{port}` with the assigned port
+- In **local mode**: Returns `http://localhost:{port}` for apex domains and `http://{subdomain}.localhost:{port}` for subdomains
 - In **production mode**: Returns `https://{domain}` (or with custom port if configured)
 - Handles `www.` prefix automatically (returns same URL)
 - Returns `null` for domains that aren't registered
@@ -327,9 +328,12 @@ import Roster from 'roster-server';
 // Local development
 const localRoster = new Roster({ local: true });
 localRoster.register('example.com', handler);
+localRoster.register('api.example.com', handler);
 await localRoster.start();
 console.log(localRoster.getUrl('example.com')); 
 // → http://localhost:9465
+console.log(localRoster.getUrl('api.example.com'));
+// → http://api.localhost:7342
 
 // Production
 const prodRoster = new Roster({ local: false });

package/demo/www/api.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('"subdomain.example.com: Crazy from thinking, wanting to be reasonable, and the heart has reasons that reason itself will never understand."');
+        res.end('"api.example.com: Crazy from thinking, wanting to be reasonable, and the heart has reasons that reason itself will never understand."');
     };
 };

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('"subdomain.example.com: Loco de pensar, queriendo entrar en razón, y el corazón tiene razones que la propia razón nunca entenderá."');
+        res.send('"express.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/docs/generated/local-mode-log-hostname-format.md

@@ -0,0 +1,12 @@
+---
+id: fralm92cih
+type: bugfix
+title: 'Bugfix: local mode startup logs show subdomain.localhost'
+created: '2026-03-16 17:19:26'
+---
+# Bug: local mode startup logs ignored subdomain localhost format
+
+**Symptom**: Startup logs still printed `http://localhost:<port>` for subdomains (e.g. `api.example.com`) even after local URL behavior changed.
+**Root cause**: `startLocalMode()` log message used a hardcoded `localhost` string.
+**Solution**: Added `localHostForDomain(domain)` helper and reused it in both `getUrl()` and local-mode startup logs so they stay consistent.
+**Location**: `index.js` (`localHostForDomain`, `getUrl`, `startLocalMode` listen log).

package/index.js

@@ -109,6 +109,19 @@ function parseBooleanFlag(value, fallback = false) {
     return fallback;
 }
 
+function normalizeDomainForLocalHost(domain) {
+    return (domain || '').trim().toLowerCase().replace(/^www\./, '');
+}
+
+function localHostForDomain(normalizedDomain) {
+    const normalized = normalizedDomain;
+    if (!normalized) return 'localhost';
+    if (normalized.startsWith('*.')) return '*.localhost';
+    const labels = normalized.split('.').filter(Boolean);
+    if (labels.length > 2) return `${labels.slice(0, -2).join('.')}.localhost`;
+    return 'localhost';
+}
+
 // Virtual Server that completely isolates applications
 class VirtualServer extends EventEmitter {
     constructor(domain) {
@@ -597,7 +610,7 @@ class Roster {
      * @returns {string|null} The URL if domain is registered (exact or wildcard), null otherwise
      */
     getUrl(domain) {
-        const cleanDomain = domain.startsWith('www.') ? domain.slice(4) : domain;
+        const cleanDomain = normalizeDomainForLocalHost(domain);
 
         const exactMatch = this.sites[cleanDomain] || this.sites[`www.${cleanDomain}`];
         const resolved = exactMatch ? { handler: exactMatch, siteKey: cleanDomain } : this.getHandlerAndKeyForHost(cleanDomain);
@@ -606,7 +619,7 @@ class Roster {
         if (this.local) {
             const pattern = resolved.siteKey.split(':')[0];
             if (this.domainPorts && this.domainPorts[pattern] !== undefined) {
-                return `http://localhost:${this.domainPorts[pattern]}`;
+                return `http://${localHostForDomain(cleanDomain)}:${this.domainPorts[pattern]}`;
             }
             return null;
         }
@@ -704,7 +717,8 @@ class Roster {
             });
 
             httpServer.listen(port, 'localhost', () => {
-                log.info(`🌐 ${domain} → http://localhost:${port}`);
+                const cleanDomain = normalizeDomainForLocalHost(domain);
+                log.info(`🌐 ${domain} → http://${localHostForDomain(cleanDomain)}:${port}`);
             });
 
             httpServer.on('error', (error) => {
@@ -778,8 +792,8 @@ class Roster {
                     }
                 }
                 if (!msg || msg === 'undefined') msg = `[${event}] (no details)`;
-                if (eventDomain && !msg.includes(`[domain:${eventDomain}]`)) {
-                    msg = `[domain:${eventDomain}] ${msg}`;
+                if (eventDomain && !msg.includes(`[${eventDomain}]`)) {
+                    msg = `[${eventDomain}] ${msg}`;
                 }
                 // Suppress known benign warnings from ACME when using acme-dns-01-cli
                 if (event === 'warning' && typeof msg === 'string') {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "roster-server",
-    "version": "2.3.6",
+    "version": "2.3.10",
     "description": "👾 RosterServer - A domain host router to host multiple HTTPS.",
     "main": "index.js",
     "scripts": {

package/test/roster-server.test.js

@@ -218,7 +218,7 @@ describe('Roster', () => {
             roster.register('*.example.com', () => {});
             roster.domainPorts = { '*.example.com': 9999 };
             roster.local = true;
-            assert.strictEqual(roster.getUrl('api.example.com'), 'http://localhost:9999');
+            assert.strictEqual(roster.getUrl('api.example.com'), 'http://api.localhost:9999');
         });
         it('returns https URL for wildcard-matched host in production', () => {
             const roster = new Roster({ local: false });
@@ -359,6 +359,13 @@ describe('Roster', () => {
             roster.local = true;
             assert.strictEqual(roster.getUrl('exact.local'), 'http://localhost:4567');
         });
+        it('returns http://subdomain.localhost:PORT in local mode for exact subdomain', () => {
+            const roster = new Roster({ local: true });
+            roster.register('api.example.com', () => {});
+            roster.domainPorts = { 'api.example.com': 5678 };
+            roster.local = true;
+            assert.strictEqual(roster.getUrl('api.example.com'), 'http://api.localhost:5678');
+        });
         it('returns https URL in production for registered domain', () => {
             const roster = new Roster({ local: false });
             roster.register('example.com', () => {});