@seip/blue-bird 1.1.2 → 1.1.4

package/core/cli/route.js

@@ -1,43 +1,144 @@
-import path from 'path';
-import fs from 'fs';
-import Config from "../config.js";
-
-const __dirname = Config.dirname();
-
-class RouteCLI {
-  /**
-   * Create route 
-   */
-    create() {
-        let nameRoute = process.argv[2];
-        if (!nameRoute) {
-            console.log("Please provide a route name. Usage: npm run route <route-name>");
-            return;
-        }
-        nameRoute =nameRoute.charAt(0).toUpperCase() + nameRoute.slice(1);
-        const folder= path.join(__dirname, 'backend/routes');
-        if (!fs.existsSync(folder)){
-            fs.mkdirSync(folder, { recursive: true });
-        }
-        const filePath = path.join(folder, `${nameRoute}.js`);
-        if (fs.existsSync(filePath)) {
-            console.log(`Route ${nameRoute} already exists.`);
-            return;
-        }
-        const content =`import Router from "@seip/blue-bird/core/router.js" 
-
-const router${nameRoute} = new Router("/${nameRoute.toLowerCase()}");
-
-router${nameRoute}.get("/", (req, res) => {
-    res.json({ message: "Hello from ${nameRoute} route!" });
-});
-
-export default router${nameRoute};
-        `;
-        fs.writeFileSync(filePath, content);
-        console.log(`Route ${nameRoute} created successfully at ${filePath}`);
-    }
-}
-
-const routeCLI = new RouteCLI();
-routeCLI.create()
+#!/usr/bin/env node
+
+import path from "node:path";
+import fs from "node:fs";
+import chalk from "chalk";
+
+class RouteCLI {
+  /**
+   * Creates a new RESTful route file with Validation, Cache, and optional Auth.
+   */
+  create() {
+    const rawArgs = process.argv.slice(2);
+    // Filter out command name if invoked as 'route' or 'make:route'
+    const args = rawArgs.filter(
+      (a) => a !== "route" && a !== "make:route" && !a.endsWith("route.js")
+    );
+
+    let routeName = args.find((a) => !a.startsWith("-"));
+    const withAuth = args.some((a) => a === "--auth" || a === "-a");
+
+    if (!routeName) {
+      console.log(chalk.red("[ERROR] Missing route name."));
+      console.log("");
+      console.log("Usage:");
+      console.log("  npx blue-bird make:route <name> [--auth]");
+      console.log("");
+      console.log("Examples:");
+      console.log("  npx blue-bird make:route products");
+      console.log("  npx blue-bird make:route articles --auth");
+      process.exit(1);
+    }
+
+    // Normalize casing
+    routeName = routeName.toLowerCase().replace(/[^a-z0-9_-]/g, "");
+    const singularName = routeName.endsWith("s") ? routeName.slice(0, -1) : routeName;
+    const pascalName = routeName.charAt(0).toUpperCase() + routeName.slice(1);
+    const routerVarName = `router${pascalName}`;
+    const basePath = `/${routeName}`;
+
+    const routesFolder = path.resolve(process.cwd(), "backend/routes");
+    if (!fs.existsSync(routesFolder)) {
+      fs.mkdirSync(routesFolder, { recursive: true });
+    }
+
+    const filePath = path.join(routesFolder, `${routeName}.js`);
+    if (fs.existsSync(filePath)) {
+      console.log(chalk.yellow(`[WARN] Route file '${routeName}.js' already exists at backend/routes/${routeName}.js.`));
+      return;
+    }
+
+    const authImport = withAuth
+      ? `import Auth from "@seip/blue-bird/core/auth.js";\n`
+      : "";
+
+    const authProtect = withAuth ? `Auth.protect(), ` : "";
+
+    const content = `import Router from "@seip/blue-bird/core/router.js";
+import Validator from "@seip/blue-bird/core/validate.js";
+import Cache from "@seip/blue-bird/core/cache.js";
+${authImport}
+const ${routerVarName} = new Router("${basePath}");
+
+// Validation schema for incoming requests
+const ${singularName}Schema = {
+  name: { required: true, min: 2, max: 255 },
+  description: { required: false },
+  price: { required: false }
+};
+
+const validate${pascalName} = new Validator(${singularName}Schema, "en");
+
+/**
+ * GET ${basePath}
+ * List all items with in-memory / Redis route caching (60 seconds)
+ */
+${routerVarName}.get("/", Cache.middleware(60), (req, res) => {
+  res.ok({ ${routeName}: [] }, "${pascalName} list retrieved successfully");
+});
+
+/**
+ * GET ${basePath}/:id
+ * Retrieve a single item by ID
+ */
+${routerVarName}.get("/:id", Cache.middleware(60), (req, res) => {
+  const { id } = req.params;
+  res.ok({ ${singularName}: { id } }, "${pascalName} retrieved successfully");
+});
+
+/**
+ * POST ${basePath}
+ * Create a new item (with validation and automatic cache invalidation)
+ */
+${routerVarName}.post("/", ${authProtect}validate${pascalName}.middleware(), async (req, res) => {
+  const data = req.body;
+
+  // Invalidate cached route list
+  await Cache.delete("${basePath}");
+
+  res.created({ ${singularName}: data }, "${pascalName} created successfully");
+});
+
+/**
+ * PUT ${basePath}/:id
+ * Update an existing item
+ */
+${routerVarName}.put("/:id", ${authProtect}validate${pascalName}.middleware(), async (req, res) => {
+  const { id } = req.params;
+  const data = req.body;
+
+  // Invalidate cached item and list
+  await Cache.delete("${basePath}");
+  await Cache.delete(\`${basePath}/\${id}\`);
+
+  res.ok({ ${singularName}: { id, ...data } }, "${pascalName} updated successfully");
+});
+
+/**
+ * DELETE ${basePath}/:id
+ * Delete an existing item
+ */
+${routerVarName}.delete("/:id", ${authProtect}async (req, res) => {
+  const { id } = req.params;
+
+  // Invalidate cache
+  await Cache.delete("${basePath}");
+  await Cache.delete(\`${basePath}/\${id}\`);
+
+  res.ok({ id }, "${pascalName} deleted successfully");
+});
+
+export default ${routerVarName};
+`;
+
+    fs.writeFileSync(filePath, content, "utf-8");
+    console.log(chalk.green(`[OK] Route '${routeName}' created successfully at backend/routes/${routeName}.js`));
+    console.log("");
+    console.log(chalk.cyan("To register this route, import it in backend/index.js:"));
+    console.log(chalk.gray(`  import ${routerVarName} from "./routes/${routeName}.js";`));
+    console.log(chalk.gray(`  // Pass ${routerVarName} into App({ routes: [...] })`));
+  }
+}
+
+const routeCLI = new RouteCLI();
+routeCLI.create();

package/core/cli/swagger.js

@@ -1,3 +1,5 @@
+#!/usr/bin/env node
+
 import { execSync } from "node:child_process";
 
 class SwaggerCli {

package/core/index.d.ts

@@ -190,5 +190,12 @@ export class Database {
   close(): Promise<void>;
 }
 
+export class Queue {
+  static process(jobName: string, handler: (payload: any) => Promise<any> | any): void;
+  static dispatch(jobName: string, payload?: any, options?: { delayMs?: number }): Promise<boolean>;
+  static loadJobs(jobsDir?: string): Promise<void>;
+}
+
 export default App;
 
+

package/core/queue.js

@@ -0,0 +1,121 @@
+import fs from "node:fs";
+import path from "node:path";
+import { getRedisClient } from "./cache.js";
+
+/**
+ * Lightweight background queue worker module with Redis and in-memory fallback.
+ */
+class QueueManager {
+  constructor() {
+    this.handlers = new Map();
+    this.memoryQueue = [];
+    this.isProcessing = false;
+    this.redisPrefix = "bluebird:queue:";
+  }
+
+  /**
+   * Registers a job handler function.
+   * @param {string} jobName - Name of the job.
+   * @param {Function} handler - Async function(payload).
+   */
+  process(jobName, handler) {
+    if (typeof handler !== "function") {
+      throw new Error(`Handler for job '${jobName}' must be a function.`);
+    }
+    this.handlers.set(jobName, handler);
+  }
+
+  /**
+   * Dispatches a new job to the queue.
+   * @param {string} jobName - Name of the job.
+   * @param {any} payload - Data payload to pass to the handler.
+   * @param {object} [options] - Options (e.g. delayMs).
+   * @returns {Promise<boolean>}
+   */
+  async dispatch(jobName, payload = {}, options = {}) {
+    const jobItem = {
+      id: `${Date.now()}_${Math.random().toString(36).substring(2, 9)}`,
+      name: jobName,
+      payload,
+      createdAt: new Date().toISOString(),
+    };
+
+    const redis = getRedisClient();
+    if (redis && redis.isReady) {
+      try {
+        await redis.lPush(`${this.redisPrefix}jobs`, JSON.stringify(jobItem));
+        return true;
+      } catch (err) {
+        console.error("[QUEUE ERROR] Failed to dispatch job to Redis:", err.message);
+      }
+    }
+
+    // In-memory fallback
+    if (options.delayMs && options.delayMs > 0) {
+      setTimeout(() => {
+        this.memoryQueue.push(jobItem);
+        this.runMemoryWorker();
+      }, options.delayMs);
+    } else {
+      this.memoryQueue.push(jobItem);
+      setImmediate(() => this.runMemoryWorker());
+    }
+
+    return true;
+  }
+
+  /**
+   * Executes in-memory queue jobs sequentially.
+   * @private
+   */
+  async runMemoryWorker() {
+    if (this.isProcessing || this.memoryQueue.length === 0) return;
+    this.isProcessing = true;
+
+    while (this.memoryQueue.length > 0) {
+      const job = this.memoryQueue.shift();
+      if (!job) continue;
+
+      const handler = this.handlers.get(job.name);
+      if (!handler) {
+        console.warn(`[QUEUE WARN] No handler registered for job '${job.name}'.`);
+        continue;
+      }
+
+      try {
+        await handler(job.payload);
+      } catch (err) {
+        console.error(`[QUEUE ERROR] Error processing job '${job.name}' (${job.id}):`, err);
+      }
+    }
+
+    this.isProcessing = false;
+  }
+
+  /**
+   * Auto-loads all job definition files from backend/jobs/.
+   */
+  async loadJobs(jobsDir = path.resolve(process.cwd(), "backend/jobs")) {
+    if (!fs.existsSync(jobsDir)) return;
+
+    const files = fs
+      .readdirSync(jobsDir)
+      .filter((f) => f.endsWith(".js") || f.endsWith(".mjs"));
+
+    for (const file of files) {
+      const fullPath = path.join(jobsDir, file);
+      try {
+        const module = await import(`file://${fullPath}`);
+        if (typeof module.default === "function") {
+          const jobName = path.basename(file, path.extname(file));
+          this.process(jobName, module.default);
+        }
+      } catch (err) {
+        console.error(`[QUEUE ERROR] Failed to load job file '${file}':`, err.message);
+      }
+    }
+  }
+}
+
+export const Queue = new QueueManager();
+export default Queue;

package/core/validate.js

@@ -148,19 +148,20 @@ class Validator {
    * const result = await loginValidator.validate(req);
    */
   async validate(req) {
+    const isExpressReq = req && (req.body !== undefined || req.headers !== undefined);
     let lang =
       req?.body?.lang ||
       req?.query?.lang ||
       req?.params?.lang ||
       req?.cookies?.lang ||
-      req?.headers["accept-language"]?.split(",")[0]?.split("-")[0] ||
+      req?.headers?.["accept-language"]?.split(",")[0]?.split("-")[0] ||
       req?.session?.lang ||
       this.lang_default ||
       "es";
     const msg = this.messages[lang] || this.messages.es;
     const errors = [];
     const messages = [];
-    const body = req.body || {};
+    const body = isExpressReq ? (req.body || {}) : (req || {});
 
     for (const [field, config] of Object.entries(this.schema)) {
       let value = body[field];

package/docker/nginx.conf

@@ -65,6 +65,29 @@ http {
             try_files $uri =404;
         }
 
+        # -------------------------------------------------------------
+        # Optional: Protected Static Frontend Pages (auth_request)
+        # Uncomment this block to protect private static pages (e.g. /dashboard)
+        # Nginx will subrequest Express /api/auth/check before serving HTML.
+        # -------------------------------------------------------------
+        # location ~ ^/(dashboard|admin|app|account) {
+        #     auth_request /api/auth/check;
+        #     error_page 401 = @login_redirect;
+        #     try_files $uri $uri.html /index.html =404;
+        # }
+        #
+        # location = /api/auth/check {
+        #     internal;
+        #     proxy_pass http://app:3000/api/auth/check;
+        #     proxy_pass_request_body off;
+        #     proxy_set_header Content-Length "";
+        #     proxy_set_header X-Original-URI $request_uri;
+        # }
+        #
+        # location @login_redirect {
+        #     return 302 /login?redirect=$request_uri;
+        # }
+
         location / {
             add_header Cache-Control "no-cache";
             try_files $uri $uri.html $uri/ @node_app;

package/frontend/about.html

@@ -1,108 +1,157 @@
-<!DOCTYPE html>
-<html lang="en" data-theme="dark">
-
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Blue Bird - About</title>
-    <link rel="canonical" href="https://seip25.github.io/Blue-bird/" />
-    <meta name="description" content="Blue Bird is a fast, structured, and opinionated Express.js framework for developers who want
-                    visual elegance and performance with raw HTML and CSS.">
-    <meta name="keywords" content="">
-    <meta name="author" content="Seip25">
-    <link rel="icon" href="/images/favicon.ico" />
-    <script src="/js/tailwind.js"></script>
-    <script src="/js/utils.js"></script>
-    <style type="text/tailwindcss">
-        @custom-variant dark (&:where(.dark, .dark *));
-    </style>
-</head>
-
-<body class="min-h-screen bg-slate-950 text-white font-sans antialiased selection:bg-blue-500 selection:text-white">
-    <header class="sticky top-0 z-50 px-4 py-3">
-        <div
-            class="max-w-7xl mx-auto flex items-center justify-between backdrop-blur-md bg-slate-900/60 border border-white/10 rounded-2xl px-6 py-3 shadow-lg">
-            <div class="flex items-center space-x-3">
-                <div
-                    class="w-10 h-10 bg-gradient-to-tr from-blue-500 to-indigo-600 rounded-xl flex items-center justify-center shadow-md shadow-blue-500/30">
-                    <svg class="w-6 h-6 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
-                            d="M12 19l9 2-9-18-9 18 9-2zm0 0v-8" />
-                    </svg>
-                </div>
-                <span
-                    class="text-xl font-bold tracking-tight bg-gradient-to-r from-blue-400 via-indigo-200 to-white bg-clip-text text-transparent">Blue
-                    Bird</span>
-            </div>
-
-            <nav class="flex space-x-8 text-sm font-medium text-slate-300">
-                <a href="/" class="hover:text-blue-400 transition-colors">Home</a>
-                <a href="/about" class="hover:text-blue-400 transition-colors">About</a>
-            </nav>
-        </div>
-    </header>
-
-    <main class="max-w-7xl mx-auto px-4 pt-12 pb-24">
-
-        <div
-            class="relative py-16 px-6 md:px-12 rounded-3xl overflow-hidden bg-gradient-to-b from-blue-900/20 to-slate-950 border border-white/5 shadow-2xl mb-12">
-            <div class="relative max-w-4xl mx-auto space-y-6 text-center">
-                <h1
-                    class="text-4xl sm:text-5xl font-extrabold tracking-tight bg-gradient-to-r from-blue-400 via-indigo-300 to-white bg-clip-text text-transparent">
-                    About Blue Bird
-                </h1>
-                <p class="text-lg sm:text-xl text-slate-400 leading-relaxed max-w-2xl mx-auto">
-                    Built for performance, simplicity, and raw speed.
-                </p>
-            </div>
-        </div>
-
-        <section class="max-w-4xl mx-auto space-y-12">
-            <article class="p-8 rounded-2xl bg-slate-900/40 border border-white/5 shadow-xl">
-                <h2 class="text-2xl font-bold text-white mb-4">Our Philosophy</h2>
-                <p class="text-slate-400 leading-relaxed mb-4">
-                    Blue Bird was born out of a desire for a clean, performance-first approach to web development. We
-                    believe in harnessing the raw power of Express.js and Nginx, stripping away unnecessary bloat, and
-                    providing developers with a robust foundation that just works.
-                </p>
-                <p class="text-slate-400 leading-relaxed">
-                    By separating the static frontend delivery (handled blazingly fast by Nginx) from the dynamic API
-                    layer (powered by Express and Redis), Blue Bird achieves unparalleled performance out of the box.
-                </p>
-            </article>
-
-            <article class="p-8 rounded-2xl bg-slate-900/40 border border-white/5 shadow-xl">
-                <h2 class="text-2xl font-bold text-white mb-4">Why Blue Bird?</h2>
-                <ul class="space-y-3 text-slate-400">
-                    <li class="flex items-start">
-                        <span class="text-blue-500 mr-2">✓</span>
-                        <span><strong>Zero Config Docker:</strong> Go from development to production seamlessly.</span>
-                    </li>
-                    <li class="flex items-start">
-                        <span class="text-blue-500 mr-2">✓</span>
-                        <span><strong>Military Grade Security:</strong> Built-in AES-256-GCM JWT encryption.</span>
-                    </li>
-                    <li class="flex items-start">
-                        <span class="text-blue-500 mr-2">✓</span>
-                        <span><strong>High Performance:</strong> Redis caching for the data layer and Nginx static
-                            delivery.</span>
-                    </li>
-                    <li class="flex items-start">
-                        <span class="text-blue-500 mr-2">✓</span>
-                        <span><strong>Pure HTML/CSS:</strong> No bloated frontend frameworks. Write code close to the
-                            metal.</span>
-                    </li>
-                </ul>
-            </article>
-        </section>
-    </main>
-
-    <footer class="border-t border-white/5 py-8 bg-slate-950 mt-16">
-        <div class="max-w-7xl mx-auto px-4 text-center text-sm text-slate-500">
-            <p>Powered by Blue Bird Framework. All rights reserved.</p>
-        </div>
-    </footer>
-
-</body>
-
+<!DOCTYPE html>
+<html lang="en" data-theme="dark">
+
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Blue Bird - About</title>
+    <link rel="canonical" href="https://seip25.github.io/Blue-bird/" />
+    <meta name="description"
+        content="Blue Bird is a fast, structured, and opinionated Express.js framework for developers who want visual elegance and performance with raw HTML and CSS.">
+    <meta name="keywords" content="Blue Bird, Express.js, About, Semantic CSS, Architecture">
+    <meta name="author" content="Seip25">
+    <link rel="icon" href="/images/favicon.ico" />
+    <link rel="stylesheet" href="/css/bluebird.css" />
+    <script src="/js/bluebird.js"></script>
+</head>
+
+<body>
+    <header>
+        <nav>
+            <a href="/" class="flex items-center gap-2">
+                <svg width="28" height="28" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"
+                    stroke-linecap="round" stroke-linejoin="round" class="text-blue">
+                    <path d="M12 19l9 2-9-18-9 18 9-2zm0 0v-8" />
+                </svg>
+                <strong class="text-xl text-gradient">Blue Bird</strong>
+            </a>
+        </nav>
+    </header>
+
+    <main>
+        <aside>
+            <h4>Menu</h4>
+            <a href="/">Home</a>
+            <a href="/about" class="active badge badge-glow px-3 py-3">About</a>
+            <a href="https://seip25.github.io/Blue-bird-css/" target="_blank">Blue Bird CSS</a>
+            <a href="https://github.com/seip25/Blue-bird" target="_blank" role="button"
+                class="btn-sm outline">GitHub</a>
+        </aside>
+
+        <div>
+            <section class="hero ">
+                <h1 class="mt-3 text-gradient font-bold">About Blue Bird</h1>
+                <p class="lead">Built for performance, simplicity, and raw speed.</p>
+            </section>
+
+            <article class="mt-6 ">
+                <header>
+                    <h2 class="text-gradient-blue font-semibold">Our Philosophy</h2>
+                </header>
+                <p>
+                    Blue Bird was born out of a desire for a clean, performance-first approach to web development. We
+                    believe in harnessing the raw power of Express.js and Nginx, stripping away unnecessary bloat, and
+                    providing developers with a robust foundation that just works.
+                </p>
+                <p>
+                    By separating the static frontend delivery (handled blazingly fast by Nginx) from the dynamic API
+                    layer (powered by Express and Redis), Blue Bird achieves unparalleled performance out of the box.
+                </p>
+            </article>
+
+            <div class="px-4 py-4  mb-4">
+                <h2 class="text-gradient-blue font-semibold">Why Blue Bird?</h2>
+
+                <div class="grid cols-2 gap-4">
+                    <div>
+                        <details open>
+                            <summary>Zero Config Docker</summary>
+                            <p>Go from development to production seamlessly with ready-to-use
+                                Docker orchestration for
+                                SQLite, MySQL, PostgreSQL, and Redis.</p>
+                        </details>
+                        <details open>
+                            <summary>Military Grade Security</summary>
+                            <p>Built-in AES-256-GCM JWT encryption, secure HttpOnly cookie
+                                sessions, helmet headers, and
+                                route rate limiting.</p>
+                        </details>
+                    </div>
+                    <div>
+                        <details open>
+                            <summary>High Performance Layer</summary>
+                            <p>Redis caching for the data layer and Nginx static delivery with
+                                1-month browser asset
+                                caching.</p>
+                        </details>
+                        <details open>
+                            <summary>Pure Semantic HTML &amp; CSS</summary>
+                            <p>No bloated frontend frameworks or heavy node compile steps. Write
+                                clean, accessible code
+                                close to the metal.</p>
+                        </details>
+                    </div>
+                </div>
+                </article>
+
+                <article class="">
+                    <header>
+                        <h2 class="text-gradient-blue font-semibold">Core Architecture Summary</h2>
+                    </header>
+                    <table class="table table-hover">
+                        <thead>
+                            <tr>
+                                <th>Layer</th>
+                                <th>Technology</th>
+                                <th>Role</th>
+                            </tr>
+                        </thead>
+                        <tbody>
+                            <tr>
+                                <td><strong>Frontend</strong></td>
+                                <td>Pure Semantic HTML5 + <a href="https://seip25.github.io/Blue-bird-css/"
+                                        target="_blank">Blue Bird CSS</a></td>
+                                <td>Static rendering served directly via Nginx</td>
+                            </tr>
+                            <tr>
+                                <td><strong>Backend</strong></td>
+                                <td>Node.js + Express + PM2</td>
+                                <td>High-performance REST API services</td>
+                            </tr>
+                            <tr>
+                                <td><strong>Cache</strong></td>
+                                <td>Redis / In-Memory RAM</td>
+                                <td>Sub-millisecond route &amp; query caching</td>
+                            </tr>
+                            <tr>
+                                <td><strong>Database</strong></td>
+                                <td>SQLite (WAL) / PostgreSQL / MySQL</td>
+                                <td>Unified driver with connection pooling</td>
+                            </tr>
+                        </tbody>
+                    </table>
+                </article>
+
+
+            </div>
+    </main>
+
+    <footer>
+        <div class="footer-content">
+            <p>Powered by <strong class="text-gradient">Blue Bird Framework</strong> &amp;
+                <strong class="text-gradient-blue">
+                    <a href="https://seip25.github.io/Blue-bird-css/" target="_blank">Blue Bird
+                        CSS</a>
+                </strong>.
+            </p>
+            <div class="lang-switcher">
+                <a href="/" class="lang-link">Home</a>
+                <a href="/about" class="lang-link">About</a>
+                <a href="https://github.com/seip25/Blue-bird" target="_blank" class="github-star mt-2">&#9733;
+                    GitHub</a>
+            </div>
+        </div>
+    </footer>
+</body>
+
 </html>