@seip/blue-bird 0.4.6 → 0.4.7

package/core/app.js

@@ -160,7 +160,7 @@ class App {
       this.app.use(middleware);
     });
 
-    if (this.logger) this._middlewareLogger();
+    if (this.logger || props.debug) this._middlewareLogger(this.logger);
 
     this.app.use((req, res, next) => {
       res.setHeader("X-Powered-By", "Blue Bird");
@@ -202,13 +202,14 @@ class App {
    * Middleware that logs incoming HTTP requests to the console and to a log file.
    * @private
    */
-  _middlewareLogger() {
+  _middlewareLogger(logger = false) {
     this.app.use((req, res, next) => {
       const method = req.method;
       const url = req.url.replace(
         /(password|token|authorization)=([^&]+)/gi,
         "$1=***",
       );
+      if (url.includes("chrome")) return;
       const params =
         Object.keys(req.params).length > 0
           ? ` ${JSON.stringify(req.params)}`
@@ -218,7 +219,8 @@ class App {
       const time = `${now.split("T")[0]} ${now.split("T")[1].split(".")[0]}`;
       let message = ` ${time} -${ip} -[${method}] ${url} ${params}`;
 
-      this.loggerInstance.info(message);
+      if (logger) this.loggerInstance.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);
@@ -290,13 +292,13 @@ class App {
         this.app.listen(this.port, () => {
           console.log(
             chalk.bold.blue("Blue Bird Server Online\n") +
-              chalk.bold.cyan("App URL: ") +
-              chalk.green(`${this.appUrl}`) +
-              "\n" +
-              chalk.bold.cyan("Internal: ") +
-              chalk.green(`${this.host}:${this.port}`) +
-              "\n" +
-              chalk.gray("────────────────────────────────"),
+            chalk.bold.cyan("App URL: ") +
+            chalk.green(`${this.appUrl}`) +
+            "\n" +
+            chalk.bold.cyan("Internal: ") +
+            chalk.green(`${this.host}:${this.port}`) +
+            "\n" +
+            chalk.gray("────────────────────────────────"),
           );
         });
       })

package/core/auth.js

@@ -94,21 +94,49 @@ class Auth {
       const token =
         req.cookies?.auth || req.headers.authorization?.split(" ")[1];
 
+      const isContentTypeJson = req.headers["content-type"] === "application/json";
+
       if (!token) {
-        if (options.redirect) return res.redirect(options.redirect);
-        return res.status(401).json({ message: "Unauthorized" });
+        if (options.redirect && !isContentTypeJson) return res.redirect(options.redirect);
+        return isContentTypeJson ? res.status(401).json({ message: "Unauthorized" }) : res.status(401).send();
       }
 
       const decoded = this.verifyToken(token);
       if (!decoded) {
-        if (options.redirect) return res.redirect(options.redirect);
-        return res.status(401).json({ message: "Unauthorized" });
+        if (options.redirect && !isContentTypeJson) return res.redirect(options.redirect);
+        return isContentTypeJson ? res.status(401).json({ message: "Unauthorized" }) : res.status(401).send();
       }
 
       req[options.key || "user"] = decoded;
       next();
     };
   }
+
+  /**
+   * Logs in a user by setting an authentication cookie.
+   * @param {import('express').Response} res - The response object.
+   * @param {Object} data - The data to store in the token.
+   * @param {string} [key="auth"] - The key for the cookie.
+   * @param {Object} [options={cookie: {maxAge: 60 * 60 * 1000, httpOnly: true, secure: true, sameSite: "strict"}}] - Options for the cookie.
+   * @returns {string} The generated token.
+   */
+  static login(res, data, key = "auth", options = { cookie: { maxAge: 60 * 60 * 1000, httpOnly: true, secure: true, sameSite: "strict" } }) {
+    const token = this.generateToken(data);
+    res.cookie(key, token, options.cookie);
+    return token;
+  }
+
+  /**
+   * Logs out a user by clearing the authentication cookie.
+   * @param {import('express').Response} res - The response object.
+   * @param {string} [key="auth"] - The key for the cookie.
+   * @param {Object} [options={cookie: {maxAge: 60 * 60 * 1000, httpOnly: true, secure: true, sameSite: "strict"}}] - Options for the cookie.
+   * @returns {boolean} True if the cookie was cleared successfully.
+   */
+  static logout(res, key = "auth", options = { cookie: { maxAge: 60 * 60 * 1000, httpOnly: true, secure: true, sameSite: "strict" } }) {
+    res.clearCookie(key, options.cookie);
+    return true;
+  }
 }
 
 export default Auth;

package/core/config.js

@@ -17,7 +17,10 @@ class Config {
   /**
    * Retrieves application properties from environment variables or default values.
    * Results are cached after first call for performance.
-   * @returns {Object} The configuration properties object.
+   * @returns {{debug: boolean, descriptionMeta: string, keywordsMeta: string, titleMeta: string, authorMeta: string, description: string, title: string, version: string, langMeta: string, host: string, appUrl: string, port: number, static: {path: string, options: Object}}} The configuration properties object.
+   * @example
+   * const props = Config.props();
+   * console.log(props);
    */
   static props() {
     if (_cachedProps) return _cachedProps;

package/core/seo.js

@@ -20,7 +20,7 @@ class SEO {
    */
   static generateSitemap(routesConfig, options = {}) {
     const { languages = [], defaultLanguage = "en" } = options;
-    const host = (props.appUrl || "http://localhost").replace(/\/$/, "");
+    const host = (props.appUrl || `${props.host}:${props.port}`).replace(/\/$/, "");
     const baseUrl = `${host}`;
     const date = new Date().toISOString().split("T")[0];
 

package/core/template.js

@@ -184,6 +184,8 @@ class Template {
         : "";
       const skeletonHtml = skeleton ? this.skeletonHtml() : "";
 
+      const canonicalUrl = metaTags.canonicalUrl || props.appUrl || "";
+
       const ogTags = `
         <meta property="og:title" content="${title}" />
         <meta property="og:description" content="${description}" />
@@ -210,6 +212,7 @@ class Template {
         .replace(/__VITE_ASSETS__/g, this.vite_assets())
         .replace(/__SCRIPTS_BODY__/g, scriptsBodyTags)
         .replace(/__STYLES_SKELETON__/g, stylesSkeleton)
+        .replace(/__CANONICAL_URL__/g, canonicalUrl)
         .replace(/__SKELETON__/g, skeletonHtml);
 
       html = this.minifyHtml(html);
@@ -338,6 +341,8 @@ class Template {
           ${ogImage ? `<meta name="twitter:image" content="${ogImage}" />` : ""}
         `;
 
+        const canonicalUrl = metaTags.canonicalUrl || props.appUrl || "";
+
         html = html
           .replace(/__LANG__/g, this.escapeHtml(langHtml))
           .replace(/__TITLE__/g, title)
@@ -347,6 +352,7 @@ class Template {
           .replace(/__HEAD_OPTIONS__/g, headOptions + ogTags)
           .replace(/__CLASS_BODY__/g, classBody)
           .replace(/__VITE_ASSETS__/g, withAssets ? this.vite_assets() : "")
+          .replace(/__CANONICAL_URL__/g, canonicalUrl)
           .replace(/__STYLES_SKELETON__/g, "");
 
         if (html.includes("__LINK_STYLES__")) {

package/core/upload.js

@@ -69,7 +69,8 @@ class Upload {
      * const url = Upload.url("file.jpg", "uploads");
      */
     static url(filename, folder = "uploads") {
-        return `${props.host}:${props.port}/${folder}/${filename}`;
+        const appUrl = props.appUrl ?? `${props.host}:${props.port}`;
+        return `${appUrl}/${folder}/${filename}`;
     }
 }
 

package/frontend/index.html

@@ -1,22 +1,27 @@
 <!DOCTYPE html>
 <html lang="__LANG__">
+
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>__TITLE__</title>
+    <link rel="canonical" href="__CANONICAL_URL__" />
     <link rel="icon" href="/favicon.ico" />
     <meta name="description" content="__DESCRIPTION__" />
     <meta name="keywords" content="__KEYWORDS__" />
     <meta name="author" content="__AUTHOR__" />
     <link rel="preconnect" href="https://fonts.googleapis.com">
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-    <link href="https://fonts.googleapis.com/css2?family=Outfit:wght@100..900&family=JetBrains+Mono:ital,wght@0,100..800;1,100..800&display=swap" rel="stylesheet">
+    <link
+        href="https://fonts.googleapis.com/css2?family=Outfit:wght@100..900&family=JetBrains+Mono:ital,wght@0,100..800;1,100..800&display=swap"
+        rel="stylesheet">
     __HEAD_OPTIONS__
     __LINK_STYLES__
     __SCRIPTS_HEAD__
     __VITE_ASSETS__
     __STYLES_SKELETON__
 </head>
+
 <body class="__CLASS_BODY__">
     <div id="root" data-react-component="__COMPONENT__" data-props='__PROPS__'>
         __SKELETON__

package/frontend/landing.html

@@ -5,6 +5,7 @@
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>__TITLE__</title>
+    <link rel="canonical" href="__CANONICAL_URL__" />
     <meta name="description" content="__DESCRIPTION__">
     <meta name="keywords" content="__KEYWORDS__">
     <meta name="author" content="__AUTHOR__">

package/package.json

@@ -1,58 +1,58 @@
-{
-  "name": "@seip/blue-bird",
-  "version": "0.4.6",
-  "description": "Express + React opinionated framework with SPA or API architecture and built-in JWT auth",
-  "type": "module",
-  "bin": {
-    "blue-bird": "core/cli/init.js"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/seip25/Blue-bird.git"
-  },
-  "keywords": [
-    "express",
-    "react",
-    "framework",
-    "vite"
-  ],
-  "author": "Seip25",
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/seip25/Blue-bird/issues"
-  },
-  "homepage": "https://seip25.github.io/Blue-bird/",
-  "scripts": {
-    "dev": "node --watch --env-file=.env backend/index.js",
-    "start": "node --env-file=.env backend/index.js",
-    "create-react-app": "node core/cli/react.js",
-    "react": "node core/cli/react.js",
-    "init": "node core/cli/init.js",
-    "route": "node core/cli/route.js",
-    "component": "node core/cli/component.js",
-    "swagger-install": "node core/cli/swagger.js",
-    "vite:dev": "vite",
-    "vite:build": "vite build"
-  },
-  "dependencies": {
-    "@tailwindcss/vite": "^4.2.2",
-    "chalk": "^5.6.2",
-    "compression": "^1.8.1",
-    "cookie-parser": "^1.4.7",
-    "cors": "^2.8.6",
-    "express": "^5.2.1",
-    "express-rate-limit": "^8.2.1",
-    "helmet": "^8.1.0",
-    "jsonwebtoken": "^9.0.2",
-    "multer": "^2.0.2",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
-    "react-router-dom": "^7.2.0",
-    "tailwindcss": "^4.2.2",
-    "xss": "^1.0.15"
-  },
-  "devDependencies": {
-    "@vitejs/plugin-react": "^4.3.4",
-    "vite": "^7.3.1"
-  }
+{
+  "name": "@seip/blue-bird",
+  "version": "0.4.7",
+  "description": "Express + React opinionated framework with SPA or API architecture and built-in JWT auth",
+  "type": "module",
+  "bin": {
+    "blue-bird": "core/cli/init.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/seip25/Blue-bird.git"
+  },
+  "keywords": [
+    "express",
+    "react",
+    "framework",
+    "vite"
+  ],
+  "author": "Seip25",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/seip25/Blue-bird/issues"
+  },
+  "homepage": "https://seip25.github.io/Blue-bird/",
+  "scripts": {
+    "dev": "node --watch --env-file=.env backend/index.js",
+    "start": "node --env-file=.env backend/index.js",
+    "create-react-app": "node core/cli/react.js",
+    "react": "node core/cli/react.js",
+    "init": "node core/cli/init.js",
+    "route": "node core/cli/route.js",
+    "component": "node core/cli/component.js",
+    "swagger-install": "node core/cli/swagger.js",
+    "vite:dev": "vite",
+    "vite:build": "vite build"
+  },
+  "dependencies": {
+    "@tailwindcss/vite": "^4.2.2",
+    "chalk": "^5.6.2",
+    "compression": "^1.8.1",
+    "cookie-parser": "^1.4.7",
+    "cors": "^2.8.6",
+    "express": "^5.2.1",
+    "express-rate-limit": "^8.2.1",
+    "helmet": "^8.1.0",
+    "jsonwebtoken": "^9.0.2",
+    "multer": "^2.0.2",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "react-router-dom": "^7.2.0",
+    "tailwindcss": "^4.2.2",
+    "xss": "^1.0.15"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-react": "^4.3.4",
+    "vite": "^7.3.1"
+  }
 }