@seip/blue-bird 0.2.0 → 0.2.2

package/core/app.js

@@ -1,182 +1,182 @@
-import express from "express"
-import cors from "cors"
-import path from "path"
-import chalk from "chalk"
-import cookieParser from "cookie-parser"
-import Config from "./config.js"
-import Logger from "./logger.js"
-
-const __dirname = Config.dirname()
-const props = Config.props()
-
-/**
- * Main Application class to manage Express server, routes, and middlewares.
- */
-class App {
-    /**
-     * Initializes the App instance with the provided options.
-     * @param {Object} [options] - Configuration options for the application.
-     * @param {Array<{path: string, router: import('express').Router}>} [options.routes=[]] - Array of route objects containing path and router components.
-     * @param {Object} [options.cors={}] - CORS configuration options.
-     * @param {Array<Function>} [options.middlewares=[]] - Array of middleware functions to be applied.
-     * @param {number|string} [options.port=3000] - Server port.
-     * @param {string} [options.host="http://localhost"] - Server host URL.
-     * @param {boolean} [options.logger=true] - Whether to enable the request logger.
-     * @param {boolean} [options.notFound=true] - Whether to enable the default 404 handler.
-     * @param {boolean} [options.json=true] - Whether to enable JSON body parsing.
-     * @param {boolean} [options.urlencoded=true] - Whether to enable URL-encoded body parsing.
-     * @param {Object} [options.static={path: null, options: {}}] - Static file configuration.
-     * @param {boolean} [options.cookieParser=true] - Whether to enable cookie parsing.
-     * @example 
-     * const app = new App({
-     *     routes: [],
-     *     cors: {},
-     *     middlewares: [],
-     *     port: 3000,
-     *     host: "http://localhost",
-     *     logger: true,
-     *     notFound: true,
-     *     json: true,
-     *     urlencoded: true,
-     *     static: {
-     *         path: "public",
-     *         options: {}
-     *     },
-     *     cookieParser: true,
-     * });
-     */
-    constructor(options = {
-        routes: [],
-        cors: {},
-        middlewares: [],
-        port: null,
-        host: null,
-        logger: true,
-        notFound: true,
-        json: true,
-        urlencoded: true,
-        static: {
-            path: null,
-            options: {}
-        },
-        cookieParser: true,
-
-    }) {
-        this.app = express()
-        this.routes = options.routes || []
-        this.cors = options.cors || {}
-        this.middlewares = options.middlewares || []
-        this.port = options.port || props.port
-        this.host = options.host || props.host
-        this.logger = options.logger || true
-        this.notFound = options.notFound || true
-        this.json = options.json || true
-        this.urlencoded = options.urlencoded || true
-        this.static = options.static || props.static
-        this.cookieParser = options.cookieParser || true
-        this.dispatch()
-
-    }
-
-    /**
-     * Registers a custom middleware or module in the Express application.
-     * @param {Function|import('express').Router} record - The middleware function or Express router to register.
-     * @example
-     * app.use((req, res, next) => {
-     *     console.log("Middleware");
-     *     next();
-     * });
-     */
-    use(record) {
-        this.app.use(record)
-    }
-    /**
-     * Sets a configuration value in the Express application.
-     * @param {string} key - The configuration key.
-     * @param {*} value - The value to set for the configuration key.
-     * @example
-     * app.set("port", 3000);
-     */
-    set(key, value) {
-        this.app.set(key, value)
-    }
-
-    /**
-     * Bootstraps the application by configuring global middlewares and routes.
-     * Sets up JSON parsing, URL encoding, CORS, and custom middlewares.
-     */
-    dispatch() {
-        if (this.json) this.app.use(express.json())
-        if (this.urlencoded) this.app.use(express.urlencoded({ extended: true }))
-        if (this.cookieParser) this.app.use(cookieParser())
-        if (this.static.path) this.app.use(express.static(path.join(__dirname, this.static.path), this.static.options))
-        this.app.use(cors(this.cors))
-        this.middlewares.map(middleware => {
-            this.app.use(middleware)
-        })
-        if (this.logger) this.middlewareLogger()
-        this.app.use((req, res, next) => {
-            res.setHeader('X-Powered-By', 'Blue Bird');
-            next();
-        });
-        this.dispatchRoutes()
-
-        if (this.notFound) this.notFoundDefault()
-    }
-
-
-    /**
-     * Middleware that logs incoming HTTP requests to the console and to a log file.
-     */
-    middlewareLogger() {
-        this.app.use((req, res, next) => {
-            const method = req.method
-            const url = req.url
-            const params = Object.keys(req.params).length > 0 ? ` ${JSON.stringify(req.params)}` : ""
-            const ip = req.ip
-            const now = new Date().toISOString()
-            const time = `${now.split("T")[0]} ${now.split("T")[1].split(".")[0]}`
-            let message = ` ${time} -${ip} -[${method}] ${url} ${params}`
-            const logger = new Logger()
-            logger.info(message)
-            if (props.debug) {
-                message = `${chalk.bold.green(time)} - ${chalk.bold.cyan(ip)} -[${chalk.bold.red(method)}] ${chalk.bold.blue(url)} ${chalk.bold.yellow(params)}`
-                console.log(message)
-            }
-            next()
-        })
-    }
-
-    /**
-     * Iterates through the stored routes and attaches them to the Express application instance.
-     */
-    dispatchRoutes() {
-        this.routes.map(route => {
-            this.app.use(route.path, route.router)
-        })
-    }
-    /**
-     * Default 404 handler for unmatched routes.
-     * Returns a JSON response with a "Not Found" message.
-     */
-    notFoundDefault() {
-        this.app.use((req, res) => {
-            return res.status(404).json({ message: "Not Found" })
-        });
-    }
-    /**
-     * Starts the HTTP server and begins listening for incoming connections.
-     */
-    run() {
-        this.app.listen(this.port, () => {
-            console.log(
-                chalk.bold.blue('Blue Bird Server Online\n') +
-                chalk.bold.cyan('Host: ') + chalk.green(`${this.host}:${this.port}`) + '\n' +
-                chalk.gray('────────────────────────────────')
-            );
-        });
-    }
-}
-
-export default App
-
+import express from "express"
+import cors from "cors"
+import path from "path"
+import chalk from "chalk"
+import cookieParser from "cookie-parser"
+import Config from "./config.js"
+import Logger from "./logger.js"
+
+const __dirname = Config.dirname()
+const props = Config.props()
+
+/**
+ * Main Application class to manage Express server, routes, and middlewares.
+ */
+class App {
+    /**
+     * Initializes the App instance with the provided options.
+     * @param {Object} [options] - Configuration options for the application.
+     * @param {Array<{path: string, router: import('express').Router}>} [options.routes=[]] - Array of route objects containing path and router components.
+     * @param {Object} [options.cors={}] - CORS configuration options.
+     * @param {Array<Function>} [options.middlewares=[]] - Array of middleware functions to be applied.
+     * @param {number|string} [options.port=3000] - Server port.
+     * @param {string} [options.host="http://localhost"] - Server host URL.
+     * @param {boolean} [options.logger=true] - Whether to enable the request logger.
+     * @param {boolean} [options.notFound=true] - Whether to enable the default 404 handler.
+     * @param {boolean} [options.json=true] - Whether to enable JSON body parsing.
+     * @param {boolean} [options.urlencoded=true] - Whether to enable URL-encoded body parsing.
+     * @param {Object} [options.static={path: null, options: {}}] - Static file configuration.
+     * @param {boolean} [options.cookieParser=true] - Whether to enable cookie parsing.
+     * @example 
+     * const app = new App({
+     *     routes: [],
+     *     cors: {},
+     *     middlewares: [],
+     *     port: 3000,
+     *     host: "http://localhost",
+     *     logger: true,
+     *     notFound: true,
+     *     json: true,
+     *     urlencoded: true,
+     *     static: {
+     *         path: "public",
+     *         options: {}
+     *     },
+     *     cookieParser: true,
+     * });
+     */
+    constructor(options = {
+        routes: [],
+        cors: {},
+        middlewares: [],
+        port: null,
+        host: null,
+        logger: true,
+        notFound: true,
+        json: true,
+        urlencoded: true,
+        static: {
+            path: null,
+            options: {}
+        },
+        cookieParser: true,
+
+    }) {
+        this.app = express()
+        this.routes = options.routes || []
+        this.cors = options.cors || {}
+        this.middlewares = options.middlewares || []
+        this.port = options.port || props.port
+        this.host = options.host || props.host
+        this.logger = options.logger || true
+        this.notFound = options.notFound || true
+        this.json = options.json || true
+        this.urlencoded = options.urlencoded || true
+        this.static = options.static || props.static
+        this.cookieParser = options.cookieParser || true
+        this.dispatch()
+
+    }
+
+    /**
+     * Registers a custom middleware or module in the Express application.
+     * @param {Function|import('express').Router} record - The middleware function or Express router to register.
+     * @example
+     * app.use((req, res, next) => {
+     *     console.log("Middleware");
+     *     next();
+     * });
+     */
+    use(record) {
+        this.app.use(record)
+    }
+    /**
+     * Sets a configuration value in the Express application.
+     * @param {string} key - The configuration key.
+     * @param {*} value - The value to set for the configuration key.
+     * @example
+     * app.set("port", 3000);
+     */
+    set(key, value) {
+        this.app.set(key, value)
+    }
+
+    /**
+     * Bootstraps the application by configuring global middlewares and routes.
+     * Sets up JSON parsing, URL encoding, CORS, and custom middlewares.
+     */
+    dispatch() {
+        if (this.json) this.app.use(express.json())
+        if (this.urlencoded) this.app.use(express.urlencoded({ extended: true }))
+        if (this.cookieParser) this.app.use(cookieParser())
+        if (this.static.path) this.app.use(express.static(path.join(__dirname, this.static.path), this.static.options))
+        this.app.use(cors(this.cors))
+        this.middlewares.map(middleware => {
+            this.app.use(middleware)
+        })
+        if (this.logger) this.middlewareLogger()
+        this.app.use((req, res, next) => {
+            res.setHeader('X-Powered-By', 'Blue Bird');
+            next();
+        });
+        this.dispatchRoutes()
+
+        if (this.notFound) this.notFoundDefault()
+    }
+
+
+    /**
+     * Middleware that logs incoming HTTP requests to the console and to a log file.
+     */
+    middlewareLogger() {
+        this.app.use((req, res, next) => {
+            const method = req.method
+            const url = req.url
+            const params = Object.keys(req.params).length > 0 ? ` ${JSON.stringify(req.params)}` : ""
+            const ip = req.ip
+            const now = new Date().toISOString()
+            const time = `${now.split("T")[0]} ${now.split("T")[1].split(".")[0]}`
+            let message = ` ${time} -${ip} -[${method}] ${url} ${params}`
+            const logger = new Logger()
+            logger.info(message)
+            if (props.debug) {
+                message = `${chalk.bold.green(time)} - ${chalk.bold.cyan(ip)} -[${chalk.bold.red(method)}] ${chalk.bold.blue(url)} ${chalk.bold.yellow(params)}`
+                console.log(message)
+            }
+            next()
+        })
+    }
+
+    /**
+     * Iterates through the stored routes and attaches them to the Express application instance.
+     */
+    dispatchRoutes() {
+        this.routes.map(route => {
+            this.app.use(route.path, route.router)
+        })
+    }
+    /**
+     * Default 404 handler for unmatched routes.
+     * Returns a JSON response with a "Not Found" message.
+     */
+    notFoundDefault() {
+        this.app.use((req, res) => {
+            return res.status(404).json({ message: "Not Found" })
+        });
+    }
+    /**
+     * Starts the HTTP server and begins listening for incoming connections.
+     */
+    run() {
+        this.app.listen(this.port, () => {
+            console.log(
+                chalk.bold.blue('Blue Bird Server Online\n') +
+                chalk.bold.cyan('Host: ') + chalk.green(`${this.host}:${this.port}`) + '\n' +
+                chalk.gray('────────────────────────────────')
+            );
+        });
+    }
+}
+
+export default App
+

package/core/auth.js

@@ -1,69 +1,69 @@
-import jwt from "jsonwebtoken";
-
-/**
- * Auth class to handle JWT generation, verification and protection.
- */
-class Auth {
-    /**
-     * Generates a JWT token.
-     * @param {Object} payload - The data to store in the token.
-     * @param {string} [secret=process.env.JWT_SECRET] - The secret key.
-     * @param {string|number} [expiresIn='24h'] - Expiration time.
-     * @returns {string} The generated token.
-     * @example
-     * const token = Auth.generateToken({ id: 1 });
-     * console.log(token);
-     * 
-     */
-    static generateToken(payload, secret = process.env.JWT_SECRET || 'blue-bird-secret', expiresIn = '24h') {
-        return jwt.sign(payload, secret, { expiresIn });
-    }
-
-    /**
-     * Verifies a JWT token.
-     * @param {string} token - The token to verify.
-     * @param {string} [secret=process.env.JWT_SECRET] - The secret key.
-     * @returns {Object|null} The decoded payload or null if invalid.
-     * @example
-     * const token = Auth.generateToken({ id: 1 });
-     * const decoded = Auth.verifyToken(token);
-     * console.log(decoded);
-     */
-    static verifyToken(token, secret = process.env.JWT_SECRET || 'blue-bird-secret') {
-        try {
-            return jwt.verify(token, secret);
-        } catch (error) {
-            return null;
-        }
-    }
-
-    /**
-     * Middleware to protect routes. Checks for token in Cookies or Authorization header.
-     * @param {Object} options - Options for protection.
-     * @param {string} [options.redirect] - URL to redirect if not authenticated (for web routes).
-     * @returns {Function} Express middleware.
-     * @example
-     * app.use(Auth.protect({ redirect: "/login" }));
-     */
-    static protect(options = { redirect: null }) {
-        return (req, res, next) => {
-            const token = req.cookies?.token || req.headers.authorization?.split(" ")[1];
-
-            if (!token) {
-                if (options.redirect) return res.redirect(options.redirect);
-                return res.status(401).json({ message: "Unauthorized: No token provided" });
-            }
-
-            const decoded = this.verifyToken(token);
-            if (!decoded) {
-                if (options.redirect) return res.redirect(options.redirect);
-                return res.status(401).json({ message: "Unauthorized: Invalid token" });
-            }
-
-            req.user = decoded;
-            next();
-        };
-    }
-}
-
-export default Auth;
+import jwt from "jsonwebtoken";
+
+/**
+ * Auth class to handle JWT generation, verification and protection.
+ */
+class Auth {
+    /**
+     * Generates a JWT token.
+     * @param {Object} payload - The data to store in the token.
+     * @param {string} [secret=process.env.JWT_SECRET] - The secret key.
+     * @param {string|number} [expiresIn='24h'] - Expiration time.
+     * @returns {string} The generated token.
+     * @example
+     * const token = Auth.generateToken({ id: 1 });
+     * console.log(token);
+     * 
+     */
+    static generateToken(payload, secret = process.env.JWT_SECRET || 'blue-bird-secret', expiresIn = '24h') {
+        return jwt.sign(payload, secret, { expiresIn });
+    }
+
+    /**
+     * Verifies a JWT token.
+     * @param {string} token - The token to verify.
+     * @param {string} [secret=process.env.JWT_SECRET] - The secret key.
+     * @returns {Object|null} The decoded payload or null if invalid.
+     * @example
+     * const token = Auth.generateToken({ id: 1 });
+     * const decoded = Auth.verifyToken(token);
+     * console.log(decoded);
+     */
+    static verifyToken(token, secret = process.env.JWT_SECRET || 'blue-bird-secret') {
+        try {
+            return jwt.verify(token, secret);
+        } catch (error) {
+            return null;
+        }
+    }
+
+    /**
+     * Middleware to protect routes. Checks for token in Cookies or Authorization header.
+     * @param {Object} options - Options for protection.
+     * @param {string} [options.redirect] - URL to redirect if not authenticated (for web routes).
+     * @returns {Function} Express middleware.
+     * @example
+     * app.use(Auth.protect({ redirect: "/login" }));
+     */
+    static protect(options = { redirect: null }) {
+        return (req, res, next) => {
+            const token = req.cookies?.token || req.headers.authorization?.split(" ")[1];
+
+            if (!token) {
+                if (options.redirect) return res.redirect(options.redirect);
+                return res.status(401).json({ message: "Unauthorized: No token provided" });
+            }
+
+            const decoded = this.verifyToken(token);
+            if (!decoded) {
+                if (options.redirect) return res.redirect(options.redirect);
+                return res.status(401).json({ message: "Unauthorized: Invalid token" });
+            }
+
+            req.user = decoded;
+            next();
+        };
+    }
+}
+
+export default Auth;

package/core/cli/component.js

@@ -1,42 +1,42 @@
-import path from "node:path";
-import fs from "node:fs";
-import Config from "../config.js"; 
-
-const __dirname = Config.dirname();
-
-class ComponentCLI {
-  /**
-   * Create component react
-   * @return {void}
-   * /
-   */
-
-  create() {
-    const folder = path.join(process.cwd(), "frontend/resources/components");
-    if (!fs.existsSync(folder)) {
-      fs.mkdirSync(folder, { recursive: true });
-    }
-    let nameComponent =`Component-${Math.random().toString(36).substring(7)}`;
-    const nameParam = process.argv[2];
-    if (nameParam.length > 0 && typeof nameParam === "string") {
-        nameComponent = nameParam;
-        nameComponent = nameComponent.charAt(0).toUpperCase() + nameComponent.slice(1);
-    }
-    const filePath = path.join(folder, `${nameComponent}.jsx`);
-    const content = `import React from 'react';
-        
-export default function ${nameComponent}() {
-    return (
-        <div>
-            <h1>${nameComponent} Component</h1>
-        </div>
-    );
-}
-        `;
-    fs.writeFileSync(filePath, content);
-    console.log(`Component ${nameComponent} created at ${filePath}`);
-  }
-}
-
-const componentCLI = new ComponentCLI();
-componentCLI.create();
+import path from "node:path";
+import fs from "node:fs";
+import Config from "../config.js"; 
+
+const __dirname = Config.dirname();
+
+class ComponentCLI {
+  /**
+   * Create component react
+   * @return {void}
+   * /
+   */
+
+  create() {
+    const folder = path.join(process.cwd(), "frontend/resources/components");
+    if (!fs.existsSync(folder)) {
+      fs.mkdirSync(folder, { recursive: true });
+    }
+    let nameComponent =`Component-${Math.random().toString(36).substring(7)}`;
+    const nameParam = process.argv[2];
+    if (nameParam.length > 0 && typeof nameParam === "string") {
+        nameComponent = nameParam;
+        nameComponent = nameComponent.charAt(0).toUpperCase() + nameComponent.slice(1);
+    }
+    const filePath = path.join(folder, `${nameComponent}.jsx`);
+    const content = `import React from 'react';
+        
+export default function ${nameComponent}() {
+    return (
+        <div>
+            <h1>${nameComponent} Component</h1>
+        </div>
+    );
+}
+        `;
+    fs.writeFileSync(filePath, content);
+    console.log(`Component ${nameComponent} created at ${filePath}`);
+  }
+}
+
+const componentCLI = new ComponentCLI();
+componentCLI.create();