@seip/blue-bird 0.2.0 → 0.2.2

package/core/cli/route.js

@@ -1,43 +1,43 @@
-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();
+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()

package/core/config.js

@@ -1,42 +1,42 @@
-import path from "path";
-
-/**
- * Configuration class to manage application-wide settings and environment variables.
- */
-class Config {
-
-    /**
-     * Returns the base directory of the application.
-     * @returns {string} The current working directory.
-     */
-    static dirname() {
-        return process.cwd()
-    }
-
-    /**
-     * Retrieves application properties from environment variables or default values.
-     * @returns {Object} The configuration properties object.
-     */
-    static props() {
-        const config = {
-            debug: process.env.DEBUG === "true" ? true : false,
-            descriptionMeta: process.env.DESCRIPTION_META || "",
-            keywordsMeta: process.env.KEYWORDS_META || "",
-            titleMeta: process.env.TITLE_META || "",
-            authorMeta: process.env.AUTHOR_META || "",
-            description: process.env.DESCRIPTION || "",
-            title: process.env.TITLE || "",
-            version: process.env.VERSION || "1.0.0",
-            langMeta: process.env.LANGMETA || "en",
-            host: process.env.HOST || "http://localhost",
-            port: parseInt(process.env.PORT) || 3001,
-            static: {
-                path: process.env.STATIC_PATH || "frontend/public",
-                options: {}
-            }
-
-        }
-        return config
-    }
-}
+import path from "path";
+
+/**
+ * Configuration class to manage application-wide settings and environment variables.
+ */
+class Config {
+
+    /**
+     * Returns the base directory of the application.
+     * @returns {string} The current working directory.
+     */
+    static dirname() {
+        return process.cwd()
+    }
+
+    /**
+     * Retrieves application properties from environment variables or default values.
+     * @returns {Object} The configuration properties object.
+     */
+    static props() {
+        const config = {
+            debug: process.env.DEBUG === "true" ? true : false,
+            descriptionMeta: process.env.DESCRIPTION_META || "",
+            keywordsMeta: process.env.KEYWORDS_META || "",
+            titleMeta: process.env.TITLE_META || "",
+            authorMeta: process.env.AUTHOR_META || "",
+            description: process.env.DESCRIPTION || "",
+            title: process.env.TITLE || "",
+            version: process.env.VERSION || "1.0.0",
+            langMeta: process.env.LANGMETA || "en",
+            host: process.env.HOST || "http://localhost",
+            port: parseInt(process.env.PORT) || 3001,
+            static: {
+                path: process.env.STATIC_PATH || "frontend/public",
+                options: {}
+            }
+
+        }
+        return config
+    }
+}
 export default Config

package/core/logger.js

@@ -1,80 +1,80 @@
-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");
-        if (!fs.existsSync(this.folder)) {
-            fs.mkdirSync(this.folder, { recursive: true });
-        }
-    }
-
-    /**
-     * Ensures and returns the path to the log folder for the current day.
-     * @returns {string} The absolute path to the current day's log folder.
-     */
-    nowFolder() {
-        const folder = path.join(this.folder, this.now());
-
-        if (!fs.existsSync(folder)) {
-            fs.mkdirSync(folder, { recursive: true });
-        }
-        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.
-     * @param {string} message - The message to log.
-     */
-    info(message) {
-        const logFile = path.join(this.nowFolder(), 'info.log');
-        fs.appendFileSync(logFile, `${message}\n`);
-    }
-
-    /**
-     * Appends an error message to the error.log file.
-     * @param {string} message - The error message to log.
-     */
-    error(message) {
-        const logFile = path.join(this.nowFolder(), 'error.log');
-        fs.appendFileSync(logFile, `${message}\n`);
-    }
-
-    /**
-     * Appends a warning message to the warn.log file.
-     * @param {string} message - The warning message to log.
-     */
-    warning(message) {
-        const logFile = path.join(this.nowFolder(), 'warn.log');
-        fs.appendFileSync(logFile, `${message}\n`);
-    }
-
-    /**
-     * Appends a debug message to the debug.log file.
-     * @param {string} message - The debug message to log.
-     */
-    debug(message) {
-        const logFile = path.join(this.nowFolder(), 'debug.log');
-        fs.appendFileSync(logFile, `${message}\n`);
-    }
-}
-
-export default Logger;
+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");
+        if (!fs.existsSync(this.folder)) {
+            fs.mkdirSync(this.folder, { recursive: true });
+        }
+    }
+
+    /**
+     * Ensures and returns the path to the log folder for the current day.
+     * @returns {string} The absolute path to the current day's log folder.
+     */
+    nowFolder() {
+        const folder = path.join(this.folder, this.now());
+
+        if (!fs.existsSync(folder)) {
+            fs.mkdirSync(folder, { recursive: true });
+        }
+        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.
+     * @param {string} message - The message to log.
+     */
+    info(message) {
+        const logFile = path.join(this.nowFolder(), 'info.log');
+        fs.appendFileSync(logFile, `${message}\n`);
+    }
+
+    /**
+     * Appends an error message to the error.log file.
+     * @param {string} message - The error message to log.
+     */
+    error(message) {
+        const logFile = path.join(this.nowFolder(), 'error.log');
+        fs.appendFileSync(logFile, `${message}\n`);
+    }
+
+    /**
+     * Appends a warning message to the warn.log file.
+     * @param {string} message - The warning message to log.
+     */
+    warning(message) {
+        const logFile = path.join(this.nowFolder(), 'warn.log');
+        fs.appendFileSync(logFile, `${message}\n`);
+    }
+
+    /**
+     * Appends a debug message to the debug.log file.
+     * @param {string} message - The debug message to log.
+     */
+    debug(message) {
+        const logFile = path.join(this.nowFolder(), 'debug.log');
+        fs.appendFileSync(logFile, `${message}\n`);
+    }
+}
+
+export default Logger;

package/core/middleware.js

@@ -1,27 +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;
+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

@@ -1,135 +1,135 @@
-import express from "express";
-import Config from "./config.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 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
-    }
-}
+import express from "express";
+import Config from "./config.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 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
+    }
+}
 export default Router;