bro-framework 3.0.1 → 3.0.3

package/bin/bro.js

@@ -45,7 +45,7 @@ async function bootstrap() {
     db = globalConfig.db;
   }
 
-  const { app, server, routes, reload, reloadLocale, shutdown } = await createServer(globalConfig, routesDir, db);
+  const { app, server, routes, reload, reloadLocale, reloadTasks, shutdown } = await createServer(globalConfig, routesDir, db);
   let currentRoutes = routes;
 
   server.listen(port, () => {
@@ -55,7 +55,7 @@ async function bootstrap() {
 
       if (process.argv.includes('--ui')) {
         import('../src/dashboard.js').then(({ startDashboard }) => {
-          startDashboard(globalConfig, currentRoutes);
+          startDashboard(globalConfig, () => currentRoutes);
         }).catch(err => console.error('[bro.js] Error starting dashboard:', err));
       }
     } else if (command === 'start') {
@@ -93,7 +93,7 @@ async function bootstrap() {
           if (isLocaleFile) {
             await reloadLocale();
           } else if (isTaskFile) {
-            // Tasks reload
+            await reloadTasks();
           } else {
             currentRoutes = await reload();
           }
@@ -166,7 +166,7 @@ export default defineConfig({
 
     // Enable OpenTelemetry W3C trace propagation and HTTP span generation
     openTelemetry: true
-  }
+  },
 
   // Optional file-based API translations
   // Add locale/en.js, locale/fr.js, etc.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bro-framework",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "description": "The No-BS Backend Framework for Node.js",
   "repository": {
     "type": "git",

package/src/dashboard/dashboard.css

@@ -0,0 +1,286 @@
+/* Minimalist High-Contrast Monochrome Design */
+:root {
+  --bg-color: #000000;
+  --bg-card: #09090b;
+  --bg-card-hover: #121214;
+  --border-color: #27272a;
+  --text-primary: #fafafa;
+  --text-secondary: #a1a1aa;
+  --text-muted: #71717a;
+  --accent-color: #ffffff;
+  --success-color: #10b981;
+  --error-color: #ef4444;
+  --warning-color: #f59e0b;
+}
+
+* {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+}
+
+body {
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+  background-color: var(--bg-color);
+  color: var(--text-primary);
+  line-height: 1.5;
+  -webkit-font-smoothing: antialiased;
+}
+
+header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 1rem 2rem;
+  border-bottom: 1px solid var(--border-color);
+  background-color: var(--bg-card);
+  position: sticky;
+  top: 0;
+  z-index: 10;
+}
+
+.header-title {
+  font-size: 1.25rem;
+  font-weight: 600;
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.status-dot {
+  width: 8px;
+  height: 8px;
+  border-radius: 50%;
+  background-color: var(--success-color);
+  box-shadow: 0 0 8px var(--success-color);
+  animation: pulse 2s infinite;
+}
+
+@keyframes pulse {
+  0% { opacity: 1; }
+  50% { opacity: 0.5; }
+  100% { opacity: 1; }
+}
+
+.header-controls {
+  display: flex;
+  align-items: center;
+  gap: 1rem;
+}
+
+.port-label {
+  font-family: ui-monospace, "SF Mono", Menlo, monospace;
+  color: var(--text-secondary);
+  font-size: 0.875rem;
+}
+
+.btn {
+  background: var(--bg-card);
+  border: 1px solid var(--border-color);
+  color: var(--text-primary);
+  padding: 0.5rem 1rem;
+  border-radius: 6px;
+  font-size: 0.875rem;
+  cursor: pointer;
+  transition: all 0.2s;
+}
+
+.btn:hover {
+  background: var(--bg-card-hover);
+  border-color: var(--text-secondary);
+}
+
+main {
+  max-width: 1200px;
+  margin: 0 auto;
+  padding: 2rem;
+}
+
+/* Grid layout for metrics */
+.metrics-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
+  gap: 1.5rem;
+  margin-bottom: 2rem;
+}
+
+.card {
+  background: var(--bg-card);
+  border: 1px solid var(--border-color);
+  border-radius: 8px;
+  padding: 1.5rem;
+  display: flex;
+  flex-direction: column;
+}
+
+.card-title {
+  font-size: 0.875rem;
+  color: var(--text-secondary);
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  margin-bottom: 0.5rem;
+}
+
+.card-value {
+  font-size: 1.5rem;
+  font-weight: 600;
+}
+
+.card-subtitle {
+  font-size: 0.875rem;
+  color: var(--text-muted);
+  margin-top: 0.5rem;
+}
+
+/* Search bar */
+.search-container {
+  margin-bottom: 1.5rem;
+}
+
+.search-input {
+  width: 100%;
+  padding: 0.75rem 1rem;
+  background: var(--bg-card);
+  border: 1px solid var(--border-color);
+  color: var(--text-primary);
+  border-radius: 8px;
+  font-size: 1rem;
+  transition: border-color 0.2s;
+}
+
+.search-input:focus {
+  outline: none;
+  border-color: var(--accent-color);
+}
+
+/* Routes Table */
+.routes-list {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+.route-item {
+  background: var(--bg-card);
+  border: 1px solid var(--border-color);
+  border-radius: 8px;
+  padding: 1rem;
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+  transition: background 0.2s;
+}
+
+.route-item:hover {
+  background: var(--bg-card-hover);
+}
+
+.route-header {
+  display: flex;
+  align-items: center;
+  gap: 1rem;
+  cursor: pointer;
+}
+
+.method-pill {
+  font-family: ui-monospace, "SF Mono", Menlo, monospace;
+  font-size: 0.75rem;
+  font-weight: 700;
+  padding: 0.25rem 0.5rem;
+  border-radius: 4px;
+  border: 1px solid var(--border-color);
+  width: 60px;
+  text-align: center;
+}
+
+.method-GET { color: #38bdf8; border-color: #0369a1; background: rgba(3, 105, 161, 0.1); }
+.method-POST { color: #10b981; border-color: #047857; background: rgba(4, 120, 87, 0.1); }
+.method-PUT { color: #f59e0b; border-color: #b45309; background: rgba(180, 83, 9, 0.1); }
+.method-PATCH { color: #f59e0b; border-color: #b45309; background: rgba(180, 83, 9, 0.1); }
+.method-DELETE { color: #ef4444; border-color: #b91c1c; background: rgba(185, 28, 28, 0.1); }
+.method-ANY { color: #a1a1aa; border-color: #52525b; background: rgba(82, 82, 91, 0.1); }
+
+.route-path {
+  font-family: ui-monospace, "SF Mono", Menlo, monospace;
+  font-size: 0.875rem;
+  flex-grow: 1;
+}
+
+.badges {
+  display: flex;
+  gap: 0.5rem;
+}
+
+.badge {
+  font-size: 0.75rem;
+  padding: 0.1rem 0.4rem;
+  border-radius: 4px;
+  background: #18181b;
+  border: 1px solid var(--border-color);
+  color: var(--text-secondary);
+}
+
+.badge.active {
+  color: var(--text-primary);
+  border-color: var(--text-secondary);
+}
+
+.route-details {
+  display: none;
+  border-top: 1px dashed var(--border-color);
+  padding-top: 1rem;
+  font-family: ui-monospace, "SF Mono", Menlo, monospace;
+  font-size: 0.875rem;
+  color: var(--text-secondary);
+}
+
+.route-details.expanded {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+.detail-row {
+  display: flex;
+  gap: 1rem;
+}
+.detail-label {
+  color: var(--text-muted);
+  width: 80px;
+}
+.detail-value {
+  color: var(--text-primary);
+}
+
+/* Config Grid */
+.config-container {
+  margin-top: 3rem;
+  border-top: 1px solid var(--border-color);
+  padding-top: 2rem;
+}
+
+.config-container h2 {
+  font-size: 1.25rem;
+  margin-bottom: 1rem;
+}
+
+.config-grid {
+  display: grid;
+  grid-template-columns: max-content 1fr;
+  gap: 0.75rem 2rem;
+  font-family: ui-monospace, "SF Mono", Menlo, monospace;
+  font-size: 0.875rem;
+  background: var(--bg-card);
+  border: 1px solid var(--border-color);
+  padding: 1.5rem;
+  border-radius: 8px;
+  overflow-x: auto;
+}
+
+.config-key {
+  color: var(--text-secondary);
+}
+
+.config-val {
+  color: var(--text-primary);
+}

package/src/dashboard/dashboard.html

@@ -0,0 +1,196 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>bro.js | Dev Dashboard</title>
+  <link rel="stylesheet" href="/dashboard.css">
+</head>
+<body>
+  <header>
+    <div class="header-title">
+      <div class="status-dot"></div>
+      bro.js <span style="color: var(--text-muted); font-size: 1rem;">v3.0.0</span>
+    </div>
+    <div class="header-controls">
+      <span class="port-label" id="portLabel"></span>
+      <button class="btn" id="refreshBtn">Refresh</button>
+    </div>
+  </header>
+
+  <main>
+    <div class="metrics-grid">
+      <div class="card">
+        <div class="card-title">Active Routes</div>
+        <div class="card-value" id="routesCount">-</div>
+        <div class="card-subtitle">Endpoints loaded in memory</div>
+      </div>
+      <div class="card">
+        <div class="card-title">Security State</div>
+        <div class="card-value" id="securityState">Strict</div>
+        <div class="card-subtitle" id="securitySubtitle">CORS / Trust Proxy</div>
+      </div>
+      <div class="card">
+        <div class="card-title">Environment</div>
+        <div class="card-value" id="envState">Node.js</div>
+        <div class="card-subtitle" id="envSubtitle">Version</div>
+      </div>
+    </div>
+
+    <div class="search-container">
+      <input type="text" id="searchInput" class="search-input" placeholder="Search routes by path or method (e.g. GET /users)...">
+    </div>
+
+    <div class="routes-list" id="routesList">
+      <!-- Routes injected here -->
+    </div>
+
+    <div class="config-container">
+      <h2>Configuration Inspector</h2>
+      <div class="config-grid" id="configGrid">
+        <!-- Config injected here -->
+      </div>
+    </div>
+  </main>
+
+  <script>
+    let allRoutes = [];
+
+    async function fetchState() {
+      try {
+        const res = await fetch('/api/state');
+        if (!res.ok) throw new Error('Failed to fetch state');
+        const data = await res.json();
+        
+        // Update port
+        document.getElementById('portLabel').textContent = window.location.origin;
+
+        // Update Routes Count
+        document.getElementById('routesCount').textContent = data.routes.length;
+        
+        // Update Env
+        document.getElementById('envState').textContent = data.env.platform;
+        document.getElementById('envSubtitle').textContent = data.env.nodeVersion;
+
+        // Update Security
+        const isStrict = data.config.server?.cors === false || data.config.server?.cors === undefined;
+        document.getElementById('securityState').textContent = isStrict ? 'Strict' : 'Permissive';
+        document.getElementById('securitySubtitle').textContent = `Proxy: ${data.config.trustProxy ? 'Trusted' : 'Untrusted'}`;
+
+        allRoutes = data.routes;
+        renderRoutes(allRoutes);
+        renderConfig(data.config);
+      } catch (err) {
+        console.error(err);
+      }
+    }
+
+    function copyToClipboard(text) {
+      navigator.clipboard.writeText(text).then(() => {
+        // Could show a toast here
+      });
+    }
+
+    function toggleRoute(index) {
+      const el = document.getElementById(`details-${index}`);
+      if (el) {
+        el.classList.toggle('expanded');
+      }
+    }
+
+    function renderRoutes(routes) {
+      const container = document.getElementById('routesList');
+      container.innerHTML = '';
+      
+      if (routes.length === 0) {
+        container.innerHTML = '<div style="color: var(--text-muted); padding: 1rem;">No routes found.</div>';
+        return;
+      }
+
+      routes.forEach((r, idx) => {
+        const method = r.method.toUpperCase();
+        const path = r.path;
+        
+        const item = document.createElement('div');
+        item.className = 'route-item';
+        
+        item.innerHTML = `
+          <div class="route-header" onclick="toggleRoute(${idx})">
+            <div class="method-pill method-${method}">${method}</div>
+            <div class="route-path" title="Click to expand/collapse">${path}</div>
+            <div class="badges">
+              <div class="badge ${r.auth !== 'public' ? 'active' : ''}">AUTH: ${r.auth}</div>
+              <div class="badge ${r.rateLimit !== 'none' ? 'active' : ''}">RL: ${r.rateLimit}</div>
+              <div class="badge ${r.cache !== 'none' ? 'active' : ''}">CACHE: ${r.cache}</div>
+            </div>
+          </div>
+          <div class="route-details" id="details-${idx}">
+            <div class="detail-row">
+              <div class="detail-label">Body</div>
+              <div class="detail-value">${r.hasBodySchema ? 'Schema Validated' : 'Any'}</div>
+            </div>
+            <div class="detail-row">
+              <div class="detail-label">Query</div>
+              <div class="detail-value">${r.hasQuerySchema ? 'Schema Validated' : 'Any'}</div>
+            </div>
+            <div class="detail-row">
+              <div class="detail-label">Params</div>
+              <div class="detail-value">${r.hasParamsSchema ? 'Schema Validated' : 'Any'}</div>
+            </div>
+            <div class="detail-row">
+              <div class="detail-label">Response</div>
+              <div class="detail-value">${r.hasResponseSchema ? 'Schema Validated' : 'Any'}</div>
+            </div>
+          </div>
+        `;
+        
+        container.appendChild(item);
+      });
+    }
+
+    function renderConfig(config, prefix = '') {
+      const container = document.getElementById('configGrid');
+      if (prefix === '') container.innerHTML = ''; 
+      
+      for (const [key, val] of Object.entries(config)) {
+        const fullKey = prefix ? `${prefix}.${key}` : key;
+        
+        if (val !== null && typeof val === 'object' && !Array.isArray(val)) {
+          renderConfig(val, fullKey);
+        } else {
+          let displayVal = val;
+          if (typeof val === 'string') displayVal = `"${val}"`;
+          if (Array.isArray(val)) displayVal = `[${val.join(', ')}]`;
+          if (val === undefined) displayVal = 'undefined';
+          if (val === null) displayVal = 'null';
+          
+          const keyEl = document.createElement('div');
+          keyEl.className = 'config-key';
+          keyEl.textContent = fullKey;
+          
+          const valEl = document.createElement('div');
+          valEl.className = 'config-val';
+          valEl.textContent = displayVal;
+          
+          container.appendChild(keyEl);
+          container.appendChild(valEl);
+        }
+      }
+    }
+
+    document.getElementById('searchInput').addEventListener('input', (e) => {
+      const query = e.target.value.toLowerCase();
+      const filtered = allRoutes.filter(r => 
+        r.path.toLowerCase().includes(query) || 
+        r.method.toLowerCase().includes(query)
+      );
+      renderRoutes(filtered);
+    });
+
+    document.getElementById('refreshBtn').addEventListener('click', fetchState);
+
+    // Initial load
+    fetchState();
+  </script>
+</body>
+</html>

package/src/dashboard.js

@@ -1,17 +1,20 @@
 import http from 'http';
 import fs from 'fs';
 import path from 'path';
+import url from 'url';
+
+const __dirname = path.dirname(url.fileURLToPath(import.meta.url));
 
 /**
  * Local Developer Dashboard Server
  * Serves a dashboard UI that visualizes routes, telemetry, and configuration.
  */
-export function startDashboard(globalConfig, routes) {
+export function startDashboard(globalConfig, routeRegistryOrGetter) {
   const host = '127.0.0.1'; // Strict local binding
   const basePort = globalConfig.server?.port || globalConfig.port || process.env.PORT || 3000;
   const port = Number(basePort) + 1;
 
-  const server = http.createServer((req, res) => {
+  const server = http.createServer(async (req, res) => {
     // Restrict access to localhost strictly
     if (req.socket.remoteAddress !== '127.0.0.1' && req.socket.remoteAddress !== '::1') {
       res.writeHead(403);
@@ -20,52 +23,56 @@ export function startDashboard(globalConfig, routes) {
     }
 
     if (req.url === '/') {
-      res.writeHead(200, { 'Content-Type': 'text/html' });
-      res.end(`
-        <!DOCTYPE html>
-        <html>
-        <head>
-          <title>bro.js Dev Dashboard</title>
-          <style>
-            body { font-family: system-ui, sans-serif; background: #0f172a; color: #f8fafc; padding: 2rem; }
-            h1 { color: #38bdf8; }
-            .card { background: #1e293b; padding: 1.5rem; border-radius: 8px; margin-bottom: 1rem; }
-            pre { background: #0f172a; padding: 1rem; border-radius: 4px; overflow-x: auto; }
-          </style>
-        </head>
-        <body>
-          <h1>bro.js Dev Dashboard</h1>
-          
-          <div class="card">
-            <h2>Configuration (Redacted)</h2>
-            <pre id="config"></pre>
-          </div>
-          
-          <div class="card">
-            <h2>Active Routes</h2>
-            <pre id="routes"></pre>
-          </div>
-          
-          <script>
-            fetch('/api/state').then(r => r.json()).then(data => {
-              document.getElementById('config').textContent = JSON.stringify(data.config, null, 2);
-              document.getElementById('routes').textContent = JSON.stringify(data.routes, null, 2);
-            });
-          </script>
-        </body>
-        </html>
-      `);
+      try {
+        const html = await fs.promises.readFile(path.join(__dirname, 'dashboard', 'dashboard.html'), 'utf-8');
+        res.writeHead(200, { 'Content-Type': 'text/html' });
+        res.end(html);
+      } catch (err) {
+        res.writeHead(500);
+        res.end('Error loading dashboard UI');
+      }
+    } else if (req.url === '/dashboard.css') {
+      try {
+        const css = await fs.promises.readFile(path.join(__dirname, 'dashboard', 'dashboard.css'), 'utf-8');
+        res.writeHead(200, { 'Content-Type': 'text/css' });
+        res.end(css);
+      } catch (err) {
+        res.writeHead(500);
+        res.end('Error loading dashboard CSS');
+      }
     } else if (req.url === '/api/state') {
       res.writeHead(200, { 'Content-Type': 'application/json' });
       
       // Strict Redaction of Secrets
-      const redactedConfig = JSON.parse(JSON.stringify(globalConfig));
+      const redactedConfig = JSON.parse(JSON.stringify(globalConfig, (k, v) => typeof v === 'function' ? '[Function]' : v));
       if (redactedConfig.auth?.jwtSecret) redactedConfig.auth.jwtSecret = '***REDACTED***';
       if (redactedConfig.db) redactedConfig.db = '[Database Instance]';
+      if (redactedConfig.redisUrl) redactedConfig.redisUrl = '***REDACTED***';
+      
+      // Dynamic live state resolution
+      const routes = typeof routeRegistryOrGetter === 'function' 
+        ? routeRegistryOrGetter() 
+        : (routeRegistryOrGetter.getRoutes ? routeRegistryOrGetter.getRoutes() : routeRegistryOrGetter);
+        
+      const normalizedRoutes = (routes || []).map(r => ({
+        method: r.method || 'GET',
+        path: r.path || r.routePath || r.url || '/',
+        auth: r.auth ? (typeof r.auth === 'string' ? r.auth : 'required') : 'public',
+        rateLimit: r.rateLimit ? `${r.rateLimit.max} req / ${r.rateLimit.windowMs / 1000}s` : 'none',
+        cache: r.cache ? `${r.cache}s` : 'none',
+        hasBodySchema: Boolean(r.body || r.schema?.body),
+        hasQuerySchema: Boolean(r.query || r.schema?.query),
+        hasParamsSchema: Boolean(r.params || r.schema?.params),
+        hasResponseSchema: Boolean(r.response || r.schema?.response)
+      }));
       
       res.end(JSON.stringify({
         config: redactedConfig,
-        routes: routes.map(r => ({ method: r.method, path: r.routePath, auth: r.auth }))
+        routes: normalizedRoutes,
+        env: {
+          platform: process.platform,
+          nodeVersion: process.version
+        }
       }));
     } else {
       res.writeHead(404);
@@ -74,7 +81,7 @@ export function startDashboard(globalConfig, routes) {
   });
 
   server.listen(port, host, () => {
-    console.log(`[bro.js] 🛠️  Dev Dashboard running locally at http://${host}:${port}`);
+    console.log(`[bro.js] Dev Dashboard running locally at http://${host}:${port}`);
   });
 
   return server;

package/src/locale.js

@@ -81,8 +81,15 @@ export async function loadLocale(directory, options = {}) {
 
 	const messages = {};
 	for (const file of files) {
-		const module = await import(`${pathToFileURL(path.join(directory, file)).href}?update=${crypto.randomUUID()}`);
-		const catalog = module.default || module.messages || module;
+		const fullPath = path.join(directory, file);
+		let catalog;
+		if (file.endsWith('.json')) {
+			catalog = JSON.parse(fs.readFileSync(fullPath, 'utf8'));
+		} else {
+			const module = await import(`${pathToFileURL(fullPath).href}?update=${crypto.randomUUID()}`);
+			catalog = module.default || module.messages || module;
+		}
+		
 		if (catalog && typeof catalog === 'object') {
 			messages[localeFromFilename(file)] = catalog;
 		}

package/src/tasks.js

@@ -1,6 +1,7 @@
 import fs from 'fs';
 import path from 'path';
 import { pathToFileURL } from 'url';
+import crypto from 'node:crypto';
 import cron from 'node-cron';
 import { colors } from './logger.js';
 import { scanDir } from './router.js';
@@ -27,7 +28,7 @@ export async function scanTasks(ctx) {
   let count = 0;
   for (const file of files) {
     try {
-      const moduleUrl = pathToFileURL(file).href;
+      const moduleUrl = `${pathToFileURL(file).href}?update=${crypto.randomUUID()}`;
       const taskModule = await import(moduleUrl);
       
       if (taskModule.cron && typeof taskModule.handler === 'function') {