npm - @seip/blue-bird - Versions diffs - 0.4.3 - Mend

@seip/blue-bird 0.4.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (53) hide show

package/.env_example +26 -0
package/AGENTS.md +199 -0
package/README.md +79 -0
package/backend/index.js +13 -0
package/backend/routes/api.js +31 -0
package/backend/routes/frontend.js +41 -0
package/backend/routes/seo.js +39 -0
package/core/app.js +325 -0
package/core/auth.js +83 -0
package/core/cache.js +45 -0
package/core/cli/component.js +42 -0
package/core/cli/init.js +118 -0
package/core/cli/react.js +435 -0
package/core/cli/route.js +43 -0
package/core/cli/swagger.js +40 -0
package/core/config.js +47 -0
package/core/debug.js +249 -0
package/core/logger.js +100 -0
package/core/middleware.js +27 -0
package/core/router.js +333 -0
package/core/seo.js +100 -0
package/core/swagger.js +25 -0
package/core/template.js +462 -0
package/core/upload.js +76 -0
package/core/validate.js +380 -0
package/frontend/index.html +27 -0
package/frontend/landing.html +70 -0
package/frontend/public/favicon.ico +0 -0
package/frontend/resources/css/tailwind.css +18 -0
package/frontend/resources/js/App.jsx +70 -0
package/frontend/resources/js/Main.jsx +19 -0
package/frontend/resources/js/blue-bird/components/Button.jsx +67 -0
package/frontend/resources/js/blue-bird/components/Card.jsx +18 -0
package/frontend/resources/js/blue-bird/components/DataTable.jsx +126 -0
package/frontend/resources/js/blue-bird/components/Input.jsx +21 -0
package/frontend/resources/js/blue-bird/components/Label.jsx +12 -0
package/frontend/resources/js/blue-bird/components/LanguageButton.jsx +23 -0
package/frontend/resources/js/blue-bird/components/Link.jsx +16 -0
package/frontend/resources/js/blue-bird/components/Modal.jsx +27 -0
package/frontend/resources/js/blue-bird/components/Skeleton.jsx +45 -0
package/frontend/resources/js/blue-bird/components/Translate.jsx +12 -0
package/frontend/resources/js/blue-bird/components/Typography.jsx +69 -0
package/frontend/resources/js/blue-bird/contexts/LanguageContext.jsx +41 -0
package/frontend/resources/js/blue-bird/contexts/SPAContext.jsx +237 -0
package/frontend/resources/js/blue-bird/contexts/SnackbarContext.jsx +38 -0
package/frontend/resources/js/blue-bird/contexts/ThemeContext.jsx +49 -0
package/frontend/resources/js/blue-bird/locales/en.json +48 -0
package/frontend/resources/js/blue-bird/locales/es.json +48 -0
package/frontend/resources/js/components/Header.jsx +56 -0
package/frontend/resources/js/pages/About.jsx +32 -0
package/frontend/resources/js/pages/Home.jsx +82 -0
package/package.json +58 -0
package/vite.config.js +23 -0

package/core/debug.js ADDED Viewed

@@ -0,0 +1,249 @@
+import Router from "./router.js";
+/**
+ * Advanced Debug module for Blue Bird.
+ * Provides metrics history, route statistics and live monitoring.
+ */
+class Debug {
+    constructor() {
+        this.router = new Router("/debug");
+        this.limit = 50;
+        this.initStore();
+        this.registerRoutes();
+    }
+    initStore() {
+        if (!global.__bluebird_debug_store__) {
+            global.__bluebird_debug_store__ = {
+                requests: [],
+                routes: {},
+                errors4xx: 0,
+                errors5xx: 0
+            };
+        }
+    }
+    static shouldTrack(req) {
+        const url = req.originalUrl || "";
+        if (url.startsWith("/debug")) return false;
+        if (/\.(json|css|js|map|png|jpg|jpeg|gif|svg|ico|webp)$/i.test(url)) {
+            return false;
+        }
+        if (req.method === "OPTIONS") return false;
+        return true;
+    }
+    static middlewareMetrics(app) {
+        app.use((req, res, next) => {
+            if (!Debug.shouldTrack(req)) return next();
+            const start = process.hrtime();
+            res.on("finish", () => {
+                const diff = process.hrtime(start);
+                const responseTime = diff[0] * 1e3 + diff[1] / 1e6;
+                const memory = process.memoryUsage();
+                const ramUsedMB = memory.rss / 1024 / 1024;
+                const cpuUsage = process.cpuUsage();
+                const cpuUsedMS = (cpuUsage.user + cpuUsage.system) / 1000;
+                const record = {
+                    method: req.method,
+                    url: req.originalUrl,
+                    status: res.statusCode,
+                    responseTime: Number(responseTime.toFixed(2)),
+                    ramUsedMB: Number(ramUsedMB.toFixed(2)),
+                    cpuUsedMS: Number(cpuUsedMS.toFixed(2)),
+                    date: new Date().toISOString()
+                };
+                const store = global.__bluebird_debug_store__;
+                store.requests.unshift(record);
+                if (store.requests.length > 50) store.requests.pop();
+                const routeKey = `${req.method} ${req.route?.path || req.path}`;
+                if (!store.routes[routeKey]) {
+                    store.routes[routeKey] = {
+                        count: 0,
+                        totalTime: 0
+                    };
+                }
+                store.routes[routeKey].count += 1;
+                store.routes[routeKey].totalTime += record.responseTime;
+                if (record.status >= 400 && record.status < 500) store.errors4xx++;
+                if (record.status >= 500) store.errors5xx++;
+            });
+            next();
+        });
+    }
+    registerRoutes() {
+        this.router.get("/", (req, res) => {
+            const store = global.__bluebird_debug_store__;
+            if (req.query.fetch === "true") {
+                return res.json(store);
+            }
+            if (req.query.reset === "true") {
+                global.__bluebird_debug_store__ = {
+                    requests: [],
+                    routes: {},
+                    errors4xx: 0,
+                    errors5xx: 0
+                };
+                return res.json({ ok: true });
+            }
+            res.send(`
+<!DOCTYPE html>
+<html>
+<head>
+<script src="https://cdn.tailwindcss.com"></script>
+<title>Blue Bird Debug</title>
+</head>
+<body class="bg-gray-100 text-gray-800 p-10">
+<div class="max-w-7xl mx-auto">
+<div class="flex justify-between items-center mb-8">
+<h1 class="text-3xl font-bold text-blue-600">Blue Bird Debug Panel</h1>
+<button onclick="resetData()" class="bg-red-500 hover:bg-red-600 text-white px-4 py-2 rounded-lg shadow">
+Reset
+</button>
+</div>
+<div class="grid grid-cols-3 gap-6 mb-8">
+<div class="bg-white p-6 rounded-xl shadow">
+<h3 class="text-gray-500 text-sm">Total Requests</h3>
+<p id="totalReq" class="text-2xl font-bold">0</p>
+</div>
+<div class="bg-yellow-100 p-6 rounded-xl shadow">
+<h3 class="text-yellow-600 text-sm">4xx Errors</h3>
+<p id="err4" class="text-2xl font-bold text-yellow-700">0</p>
+</div>
+<div class="bg-red-100 p-6 rounded-xl shadow">
+<h3 class="text-red-600 text-sm">5xx Errors</h3>
+<p id="err5" class="text-2xl font-bold text-red-700">0</p>
+</div>
+</div>
+<div class="grid grid-cols-2 gap-10">
+<div class="bg-white p-6 rounded-xl shadow">
+<h2 class="text-lg font-semibold mb-4">Route Stats</h2>
+<table class="table-fixed w-full text-sm">
+<thead>
+<tr class="border-b">
+<th class="text-left w-1/2 py-2">Route</th>
+<th class="text-left w-1/4">Hits</th>
+<th class="text-left w-1/4">Avg Time</th>
+</tr>
+</thead>
+<tbody id="routesBody"></tbody>
+</table>
+</div>
+<div class="bg-white p-6 rounded-xl shadow">
+<h2 class="text-lg font-semibold mb-4">Last Requests</h2>
+<table class="table-fixed w-full text-sm">
+<thead>
+<tr class="border-b">
+<th class="text-left w-1/2 py-2">URL</th>
+<th class="text-left w-1/6">Method</th>
+<th class="text-left w-1/6">Status</th>
+<th class="text-left w-1/6">Time</th>
+</tr>
+</thead>
+<tbody id="historyBody"></tbody>
+</table>
+</div>
+</div>
+</div>
+<script>
+async function loadData() {
+    const res = await fetch('/debug?fetch=true');
+    const data = await res.json();
+    document.getElementById("totalReq").innerText = data.requests.length;
+    document.getElementById("err4").innerText = data.errors4xx;
+    document.getElementById("err5").innerText = data.errors5xx;
+    const routesBody = document.getElementById("routesBody");
+    const historyBody = document.getElementById("historyBody");
+    routesBody.innerHTML = "";
+    historyBody.innerHTML = "";
+    Object.entries(data.routes).forEach(([key, value]) => {
+        const avg = (value.totalTime / value.count).toFixed(2);
+        let color = "";
+        if (avg > 500) color = "text-red-600 font-semibold";
+        else if (avg > 200) color = "text-yellow-600";
+        routesBody.innerHTML += \`
+        <tr class="border-b">
+            <td class="py-1 truncate">\${key}</td>
+            <td>\${value.count}</td>
+            <td class="\${color}">\${avg} ms</td>
+        </tr>\`;
+    });
+    data.requests.forEach(r => {
+        historyBody.innerHTML += \`
+        <tr class="border-b text-xs">
+            <td class="truncate">\${r.url}</td>
+            <td>\${r.method}</td>
+            <td>\${r.status}</td>
+            <td>\${r.responseTime} ms</td>
+        </tr>\`;
+    });
+}
+async function resetData() {
+    await fetch('/debug?reset=true');
+    loadData();
+}
+loadData();
+setInterval(loadData, 3000);
+</script>
+</body>
+</html>
+            `);
+        });
+    }
+    getRouter() {
+        return {
+            path: this.router.getPath(),
+            router: this.router.getRouter()
+        };
+    }
+}
+export default Debug;

package/core/logger.js ADDED Viewed

@@ -0,0 +1,100 @@
+import fs from "node:fs";
+import path from "node:path";
+import Config from "./config.js"
+const __dirname = Config.dirname()
+/**
+ * Logger class for managing application logs by creating dated folders and log files.
+ */
+class Logger {
+    /**
+     * Initializes the Logger instance and ensures the logs directory exists.
+     */
+    constructor() {
+        this.folder = path.join(__dirname, "logs");
+        this._currentDay = null;
+        this._currentDayFolder = null;
+        if (!fs.existsSync(this.folder)) {
+            fs.mkdirSync(this.folder, { recursive: true });
+        }
+    }
+    /**
+     * Ensures and returns the path to the log folder for the current day.
+     * Caches the folder path for the current day to avoid repeated fs checks.
+     * @returns {string} The absolute path to the current day's log folder.
+     */
+    nowFolder() {
+        const today = this.now();
+        if (this._currentDay === today && this._currentDayFolder) {
+            return this._currentDayFolder;
+        }
+        const folder = path.join(this.folder, today);
+        if (!fs.existsSync(folder)) {
+            fs.mkdirSync(folder, { recursive: true });
+        }
+        this._currentDay = today;
+        this._currentDayFolder = folder;
+        return folder;
+    }
+    /**
+     * Gets the current date formatted as YYYY-MM-DD.
+     * @returns {string} The formatted date string.
+     */
+    now() {
+        return new Date().toISOString().split("T")[0];
+    }
+    /**
+     * Appends an informational message to the info.log file (non-blocking).
+     * @param {string} message - The message to log.
+     */
+    info(message) {
+        const logFile = path.join(this.nowFolder(), 'info.log');
+        fs.appendFile(logFile, `${message}\n`, (err) => {
+            if (err) console.error('Logger write error:', err.message);
+        });
+    }
+    /**
+     * Appends an error message to the error.log file (non-blocking).
+     * @param {string} message - The error message to log.
+     */
+    error(message) {
+        const logFile = path.join(this.nowFolder(), 'error.log');
+        fs.appendFile(logFile, `${message}\n`, (err) => {
+            if (err) console.error('Logger write error:', err.message);
+        });
+    }
+    /**
+     * Appends a warning message to the warn.log file (non-blocking).
+     * @param {string} message - The warning message to log.
+     */
+    warning(message) {
+        const logFile = path.join(this.nowFolder(), 'warn.log');
+        fs.appendFile(logFile, `${message}\n`, (err) => {
+            if (err) console.error('Logger write error:', err.message);
+        });
+    }
+    /**
+     * Appends a debug message to the debug.log file (non-blocking).
+     * @param {string} message - The debug message to log.
+     */
+    debug(message) {
+        const logFile = path.join(this.nowFolder(), 'debug.log');
+        fs.appendFile(logFile, `${message}\n`, (err) => {
+            if (err) console.error('Logger write error:', err.message);
+        });
+    }
+}
+export default Logger;

package/core/middleware.js ADDED Viewed

@@ -0,0 +1,27 @@
+import Auth from "./auth.js";
+/**
+ * Common middlewares for the Blue Bird framework.
+ */
+const Middleware = {
+    /**
+     * Authentication protection middleware.
+     * @type {Function}
+     */
+    auth: Auth.protect(),
+    /**
+     * Web authentication protection middleware (redirects to home if fails).
+     * @type {Function}
+     */
+    webAuth: Auth.protect({ redirect: "/" }),
+    /**
+     * Logging middleware (can be extended).
+     */
+    logger: (req, res, next) => {
+        next();
+    }
+};
+export default Middleware;

package/core/router.js ADDED Viewed

@@ -0,0 +1,333 @@
+import express from "express";
+import Config from "./config.js";
+import Template from "./template.js";
+import SEO from "./seo.js";
+const __dirname = Config.dirname();
+const props = Config.props();
+/**
+ * Router wrapper class for handling Express routing logic.
+ */
+class Router {
+  /**
+   * Creates a new Router instance.
+   * @param {string} [path="/"] - The base path for this router.
+   * @example
+   * const router = new Router("/api")
+   * router.get("/", (req, res) => {
+   *     res.json({ message: "Hello World!" })
+   * })
+   */
+  constructor(path = "/") {
+    this.router = express.Router();
+    this.path = path;
+  }
+  /**
+   * Registers a middleware on this router.
+   * @param {...Function} middleware - Middleware functions.
+   * @example
+   * router.use(Auth.protect());
+   * router.use(App.helmet());
+   */
+  use(...middleware) {
+    this.router.use(...middleware);
+  }
+  /**
+   * Registers a GET route handler.
+   * @param {string} path - The relative path for the GET route.
+   * @param {...Function} callback - One or more handler functions (middlewares and controller).
+   * @example
+   * router.get("/users", (req, res) => {
+   *     const users = [
+   *         {
+   *             name: "John Doe",
+   *             email: "john.doe@example.com",
+   *         },
+   *         {
+   *             name: "Jane Doe2",
+   *             email: "jane.doe2@example.com",
+   *         },
+   *     ]
+   *     res.json(users)
+   * })
+   */
+  get(path, ...callback) {
+    if (path === "/*" || path === "*") {
+      path = /.*/;
+    }
+    this.router.get(path, callback);
+  }
+  /**
+   * Registers a POST route handler.
+   * @param {string} path - The relative path for the POST route.
+   * @param {...Function} callback - One or more handler functions (middlewares and controller).
+   * @example
+   * router.post("/users", (req, res) => {
+   *  return res.json({ message: "User created successfully" })
+   * })
+   */
+  post(path, ...callback) {
+    if (path === "/*" || path === "*") {
+      path = /.*/;
+    }
+    this.router.post(path, callback);
+  }
+  /**
+   * Registers a PUT route handler.
+   * @param {string} path - The relative path for the PUT route.
+   * @param {...Function} callback - One or more handler functions (middlewares and controller).
+   * @example
+   * router.put("/users", (req, res) => {
+   *  return res.json({ message: "User updated successfully" })
+   * })
+   */
+  put(path, ...callback) {
+    this.router.put(path, callback);
+  }
+  /**
+   * Registers a DELETE route handler.
+   * @param {string} path - The relative path for the DELETE route.
+   * @param {...Function} callback - One or more handler functions (middlewares and controller).
+   * @example
+   * router.delete("/users", (req, res) => {
+   *  return res.json({ message: "User deleted successfully" })
+   * })
+   */
+  delete(path, ...callback) {
+    this.router.delete(path, callback);
+  }
+  /**
+   * Registers a PATCH route handler.
+   * @param {string} path - The relative path for the PATCH route.
+   * @param {...Function} callback - One or more handler functions (middlewares and controller).
+   * @example
+   * router.patch("/users", (req, res) => {
+   *  return res.json({ message: "User patched successfully" })
+   * })
+   */
+  patch(path, ...callback) {
+    this.router.patch(path, callback);
+  }
+  /**
+   * Registers an OPTIONS route handler.
+   * @param {string} path - The relative path for the OPTIONS route.
+   * @param {...Function} callback - One or more handler functions (middlewares and controller).
+   * @example
+   * router.options("/users", (req, res) => {
+   *  return res.json({ message: "User options successfully" })
+   * })
+   */
+  options(path, ...callback) {
+    this.router.options(path, callback);
+  }
+  /**
+   * Returns the underlying Express router instance.
+   * @returns {import('express').Router} The Express router object.
+   */
+  getRouter() {
+    return this.router;
+  }
+  /**
+   * Returns the base path associated with this router.
+   * @returns {string} The router path.
+   */
+  getPath() {
+    return this.path;
+  }
+  /**
+   * Resolves meta tags for a route, supporting simple meta, inline multilingual, or external seoData.
+   *
+   * @private
+   * @param {Object} route - The route configuration.
+   * @param {string} lang - Target language.
+   * @param {Object} [seoData=null] - External SEO data object.
+   * @param {Array<string>} [languages=[]] - Available languages.
+   * @returns {Object} Resolved meta tags object.
+   */
+  _resolveMeta(route, lang, seoData = null, languages = []) {
+    const { meta = {}, seoKey } = route;
+    if (seoKey && seoData && seoData[seoKey]) {
+      const seoEntry = seoData[seoKey];
+      return seoEntry[lang] || seoEntry[Object.keys(seoEntry)[0]] || {};
+    }
+    const hasLangKeys = languages.some(
+      (l) => meta[l] && typeof meta[l] === "object",
+    );
+    if (hasLangKeys) {
+      return meta[lang] || meta[Object.keys(meta).find((k) => meta[k])] || {};
+    }
+    return meta;
+  }
+  /**
+   * Registers a single SEO route with Template.renderReact.
+   *
+   * @private
+   * @param {string} routePath - Express route path.
+   * @param {string} component - React component name.
+   * @param {Object} props - Props to pass to the component.
+   * @param {Object} metaData - Resolved meta data.
+   * @param {string} lang - Language code.
+   */
+  _registerSeoRoute(routePath, component, props, metaData, lang, options = {}) {
+    const { seoData, languages } = options;
+    this.get(routePath, (req, res) => {
+      let activeLang = lang;
+      const isDefaultRoute = !languages.some(l => req.path.startsWith(`/${l}`));
+      if (isDefaultRoute && req.cookies?.blue_bird_lang && languages?.includes(req.cookies.blue_bird_lang)) {
+        activeLang = req.cookies.blue_bird_lang;
+      }
+      if (req.query.source === "frontend" && req.query.lang && languages?.includes(req.query.lang)) {
+        activeLang = req.query.lang;
+        res.cookie("blue_bird_lang", activeLang, {
+          maxAge: 31536000000,
+          httpOnly: false,
+          path: "/",
+        });
+      }
+      let activeMeta = metaData;
+      if (activeLang !== lang) {
+        activeMeta = this._resolveMeta(
+          { meta: metaData, seoKey: options.seoKey },
+          activeLang,
+          seoData,
+          languages,
+        );
+      }
+      const dynamicProps = {
+        props: {
+          ...props,
+          params: req.params,
+          query: req.query,
+          lang: activeLang,
+        },
+      };
+      const metaTags = {
+        titleMeta: activeMeta.titleMeta || activeMeta.title || "",
+        descriptionMeta: activeMeta.descriptionMeta || activeMeta.description || "",
+        keywordsMeta: activeMeta.keywordsMeta || activeMeta.keywords || "",
+        ogImage: activeMeta.ogImage || "",
+        ogType: activeMeta.ogType || "website",
+        twitterCard: activeMeta.twitterCard || "summary_large_image",
+        langMeta: activeLang,
+      };
+      return Template.renderReact(res, component, dynamicProps, { metaTags });
+    });
+  }
+  /**
+   * Registers multiple routes based on an SEO configuration array.
+   * Supports simple meta, inline multilingual meta, and external seoData files.
+   * Automatically generates language-prefixed routes and registers sitemap.xml and robots.txt.
+   *
+   * @param {Array<Object>} routesConfig - Array of route objects.
+   * @param {Object} [options={}] - Configuration options.
+   * @param {Array<string>} [options.languages=[]] - Languages to register (e.g., ["en", "es"]).
+   * @param {string} [options.defaultLanguage="en"] - The default language for unprefixed paths.
+   * @param {Object} [options.seoData=null] - External SEO data object (like seo.php pattern).
+   *
+   * @example
+   * // Simple (no i18n)
+   * router.seo([
+   *   {
+   *     path: "/",
+   *     component: "Home",
+   *     meta: { titleMeta: "Home", descriptionMeta: "Welcome" },
+   *     props: { id: 1 }
+   *   }
+   * ]);
+   *
+   * @example
+   * // Multilingual (inline)
+   * router.seo([
+   *   {
+   *     path: "/",
+   *     component: "Home",
+   *     meta: {
+   *       en: { titleMeta: "Home", descriptionMeta: "Welcome" },
+   *       es: { titleMeta: "Inicio", descriptionMeta: "Bienvenido" }
+   *     }
+   *   }
+   * ], { languages: ["en", "es"], defaultLanguage: "en" });
+   *
+   * @example
+   * // Multilingual (external seoData file)
+   * import seoData from "./seo.js";
+   * router.seo([
+   *   { path: "/", component: "Home", seoKey: "home" }
+   * ], { languages: ["en", "es"], defaultLanguage: "en", seoData });
+   */
+  seo(routesConfig, options = {}) {
+    const { languages = [], defaultLanguage = null, seoData = null } = options;
+    const defaultLanguageOption=(defaultLanguage === null) ? props.langMeta : "en";
+     SEO.registerRoutes(this.router, routesConfig, options);
+    routesConfig.forEach((route) => {
+      const { path: routePath, component, props = {}, seoKey } = route;
+      if (languages.length > 0) {
+        languages.forEach((lang) => {
+          const langMeta = this._resolveMeta(route, lang, seoData, languages);
+          const langPath = `/${lang}${routePath === "/" ? "" : routePath}`;
+          this._registerSeoRoute(
+            langPath,
+            component,
+            props,
+            langMeta,
+            lang,
+            { seoData, languages, seoKey },
+          );
+        });
+        const defaultMeta = this._resolveMeta(
+          route,
+          defaultLanguageOption,
+          seoData,
+          languages,
+        );
+        this._registerSeoRoute(
+          routePath,
+          component,
+          props,
+          defaultMeta,
+          defaultLanguageOption,
+          { seoData, languages, seoKey },
+        );
+      } else {
+        const meta = this._resolveMeta(route, defaultLanguageOption, seoData, []);
+        this._registerSeoRoute(
+          routePath,
+          component,
+          props,
+          meta,
+          defaultLanguageOption,
+          { seoData, languages: [], seoKey },
+        );
+      }
+    });
+  }
+}
+export default Router;