@seip/blue-bird 0.6.4 → 0.7.1

package/core/cli/init.js

@@ -3,6 +3,10 @@
 import fs from "node:fs";
 import path from "node:path";
 import chalk from "chalk";
+import readline from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import crypto from "node:crypto";
+import { execSync } from "node:child_process";
 
 /**
  * Initializes a new Blue Bird project by copying the base structure.
@@ -19,13 +23,63 @@ class ProjectInit {
     async run() {
         console.log(chalk.cyan("Starting Blue Bird project initialization..."));
 
+        const rl = readline.createInterface({ input, output });
+
+        let title = "Blue-Bird";
+        let port = 3000;
+        let appUrl = "http://localhost:3000";
+        let useMysql = false;
+        let dbName = "blue_bird";
+        let dbUser = "root";
+        let dbPassword = "root";
+        let dbPort = 3306;
+
+        try {
+            const ask = async (query, defaultValue) => {
+                const formattedQuery = defaultValue !== undefined ? `${query} [${defaultValue}]: ` : `${query}: `;
+                const answer = await rl.question(formattedQuery);
+                return answer.trim() || defaultValue;
+            };
+
+            title = await ask("Project Title", title);
+            const portInput = await ask("Server Port", port);
+            port = parseInt(portInput, 10);
+            if (Number.isNaN(port)) {
+                port = 3000;
+            }
+
+            const defaultAppUrl = `http://localhost:${port}`;
+            appUrl = await ask("Application URL", defaultAppUrl);
+
+            const mysqlAns = await ask("Do you want to configure MySQL? (y/n)", "n");
+            useMysql = mysqlAns.toLowerCase() === "y" || mysqlAns.toLowerCase() === "yes";
+
+            if (useMysql) {
+                dbName = await ask("Database Name", dbName);
+                dbUser = await ask("Database User", dbUser);
+                dbPassword = await ask("Database Password", dbPassword);
+                const dbPortInput = await ask("Database Port", dbPort);
+                dbPort = parseInt(dbPortInput, 10);
+                if (Number.isNaN(dbPort)) {
+                    dbPort = 3306;
+                }
+            }
+        } catch (error) {
+            console.error(chalk.red("[ERROR] Error reading configuration input:"), error.message);
+            rl.close();
+            return;
+        } finally {
+            rl.close();
+        }
+
         const itemsToCopy = [
             "backend",
             "frontend",
             "docker",
             "docker-compose.yml",
             ".env_example",
-            "AGENTS.md"
+            "AGENTS.md",
+            "index.js"
         ];
 
         try {
@@ -36,31 +90,78 @@ class ProjectInit {
                 if (fs.existsSync(src)) {
                     if (!fs.existsSync(dest)) {
                         this.copyRecursive(src, dest);
-                        console.log(chalk.green(`✓ Copied ${item} to root.`));
+                        console.log(chalk.green(`[OK] Copied ${item} to root.`));
                     } else {
-                        console.log(chalk.yellow(`! ${item} already exists, skipping.`));
+                        console.log(chalk.yellow(`[SKIP] ${item} already exists, skipping.`));
                     }
                 } else {
-                    console.warn(chalk.red(`✗ Source ${item} not found in ${this.sourceDir}`));
+                    console.warn(chalk.red(`[ERROR] Source ${item} not found in ${this.sourceDir}`));
                 }
             });
 
             const envPath = path.join(this.appDir, ".env");
             const envExamplePath = path.join(this.appDir, ".env_example");
-            if (fs.existsSync(envExamplePath) && !fs.existsSync(envPath)) {
-                fs.copyFileSync(envExamplePath, envPath);
-                console.log(chalk.green("✓ Created .env from .env_example."));
+
+            if (fs.existsSync(envExamplePath)) {
+                let envContent = fs.readFileSync(envExamplePath, "utf-8");
+
+                const jwtSecret = crypto.randomBytes(32).toString("hex");
+
+                const updates = {
+                    TITLE: title,
+                    PORT: port,
+                    APP_URL: appUrl,
+                    JWT_SECRET: jwtSecret,
+                };
+
+                if (useMysql) {
+                    updates.DB_NAME = dbName;
+                    updates.DB_USER = dbUser;
+                    updates.DB_PASSWORD = dbPassword;
+                    updates.DB_PORT = dbPort;
+                    updates.DATABASE_URL = `mysql://${dbUser}:${dbPassword}@localhost:${dbPort}/${dbName}`;
+                }
+
+                const lines = envContent.split(/\r?\n/);
+                const updatedLines = lines.map(line => {
+                    const match = line.match(/^([A-Z_]+)=(.+)/);
+                    if (match) {
+                        const key = match[1];
+                        if (updates[key] !== undefined) {
+                            const value = updates[key];
+                            if (typeof value === "string" && !value.startsWith('"')) {
+                                return `${key}="${value}"`;
+                            }
+                            return `${key}=${value}`;
+                        }
+                    }
+                    return line;
+                });
+                envContent = updatedLines.join("\n");
+
+                fs.writeFileSync(envPath, envContent, "utf-8");
+                console.log(chalk.green("[OK] Created and configured .env file."));
             }
 
             this.updatePackageJson();
 
+            if (useMysql) {
+                console.log(chalk.cyan("[INFO] Installing mysql2 and redis packages..."));
+                try {
+                    execSync("npm install mysql2 redis", { stdio: "inherit", cwd: this.appDir });
+                    console.log(chalk.green("[OK] Successfully installed mysql2 and redis."));
+                } catch (error) {
+                    console.warn(chalk.yellow("[ERROR] Automatic package installation failed. Please run 'npm install mysql2 redis' manually."));
+                }
+            }
+
             console.log(chalk.blue("\nBlue Bird initialization completed!"));
             console.log(chalk.white("Next steps:"));
             console.log(chalk.bold("  npm install"));
             console.log(chalk.bold("  npm run dev"));
 
         } catch (error) {
-            console.error(chalk.red("Error during initialization:"), error.message);
+            console.error(chalk.red("[ERROR] Error during initialization:"), error.message);
         }
     }
 
@@ -74,8 +175,11 @@ class ProjectInit {
             pkg.scripts = pkg.scripts || {};
 
             const scriptsToAdd = {
-                "dev": "node --watch --env-file=.env backend/index.js",
-                "start": "node --env-file=.env backend/index.js",
+                "dev": "node --watch --env-file=.env index.js",
+                "dev:astro": "astro dev --root frontend",
+                "dev:api": "node --watch --env-file=.env index.js",
+                "start": "node --env-file=.env index.js",
+                "build": "astro build --root frontend",
                 "init": "blue-bird",
                 "route": "blue-bird route",
                 "swagger-install": "blue-bird swagger-install",
@@ -90,9 +194,14 @@ class ProjectInit {
                 }
             }
 
+            if (pkg.type !== "module") {
+                pkg.type = "module";
+                updated = true;
+            }
+
             if (updated) {
                 fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2));
-                console.log(chalk.green("✓ Updated package.json scripts."));
+                console.log(chalk.green("[OK] Updated package.json configuration."));
             }
         }
     }

package/core/logger.js

@@ -1,100 +1,99 @@
 import fs from "node:fs";
 import path from "node:path";
-import Config from "./config.js"
+import Config from "./config.js";
 
-const __dirname = Config.dirname()
+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 });
-        }
+  /**
+   * Initializes the Logger instance and ensures the logs directory exists.
+   */
+  constructor() {
+    this.folder = path.join(__dirname, "backend", "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;
-        }
+  /**
+   * 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();
 
-        const folder = path.join(this.folder, today);
+    if (this._currentDay === today && this._currentDayFolder) {
+      return this._currentDayFolder;
+    }
 
-        if (!fs.existsSync(folder)) {
-            fs.mkdirSync(folder, { recursive: true });
-        }
+    const folder = path.join(this.folder, today);
 
-        this._currentDay = today;
-        this._currentDayFolder = folder;
-        return folder;
+    if (!fs.existsSync(folder)) {
+      fs.mkdirSync(folder, { recursive: true });
     }
 
-    /**
-     * Gets the current date formatted as YYYY-MM-DD.
-     * @returns {string} The formatted date string.
-     */
-    now() {
-        return new Date().toISOString().split("T")[0];
-    }
+    this._currentDay = today;
+    this._currentDayFolder = folder;
+    return folder;
+  }
 
-    /**
-     * 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);
-        });
-    }
+  /**
+   * 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 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 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 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 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 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);
-        });
-    }
+  /**
+   * 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/router.js

@@ -1,6 +1,6 @@
 import express from "express";
 import Config from "./config.js";
-import SEO from "./seo.js";
+
 
 const props = Config.props();
 
@@ -57,11 +57,7 @@ class Router {
     if (path === "/*" || path === "*") {
       path = /.*/;
     }
-    if (this._seo && typeof path === "string") {
-      const fullPath = this.path === "/" ? path : `${this.path}${path}`;
-      const normalizedPath = fullPath === "//" ? "/" : fullPath.replace(/\/+/g, "/");
-      SEO.addRoute(normalizedPath, this._languages);
-    }
+
     this.router.get(path, callback);
   }
 

package/docker/Dockerfile

@@ -1,25 +1,16 @@
-# ─────────────────────────────────────────────────────────────────────────────
-# Blue Bird Framework — Production Dockerfile
-# Node.js 24-alpine for lightweight, production-ready environment
-# ─────────────────────────────────────────────────────────────────────────────
 FROM node:24.7.0-alpine3.21
 
-# Set environment variables
 ENV NODE_ENV=production
 
 WORKDIR /app
 
-# Copy package files first (layer cache optimization)
 COPY package*.json ./
 
-# Install production dependencies
-RUN npm ci --omit=dev
+RUN npm ci --omit=dev && npm install -g pm2
 
-# Copy project source
 COPY . .
 
-# Expose the application port
 EXPOSE 3000
 
-# Start the application
-CMD ["npm", "start"]
+CMD ["sh", "-c", "pm2-runtime start index.js -i ${PM2_INSTANCES:-1}"]
+

package/docker/nginx.conf

@@ -0,0 +1,83 @@
+user  nginx;
+worker_processes  auto;
+
+error_log  /var/log/nginx/error.log notice;
+pid        /var/run/nginx.pid;
+
+events {
+    worker_connections  1024;
+}
+
+http {
+    include       /etc/nginx/mime.types;
+    default_type  application/octet-stream;
+
+    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
+                      '$status $body_bytes_sent "$http_referer" '
+                      '"$http_user_agent" "$http_x_forwarded_for"';
+
+    access_log  /var/log/nginx/access.log  main;
+
+    sendfile        on;
+    tcp_nopush     on;
+    tcp_nodelay    on;
+    keepalive_timeout  65;
+    types_hash_max_size 2048;
+
+    gzip on;
+    gzip_disable "msie6";
+    gzip_vary on;
+    gzip_proxied any;
+    gzip_comp_level 6;
+    gzip_buffers 16 8k;
+    gzip_http_version 1.1;
+    gzip_min_length 256;
+    gzip_types
+        text/plain
+        text/css
+        application/json
+        application/javascript
+        application/x-javascript
+        text/xml
+        application/xml
+        application/xml+rss
+        text/javascript
+        image/svg+xml;
+
+    limit_req_zone $binary_remote_addr zone=bluebird_limit:10m rate=10r/s;
+
+    server {
+        listen 80;
+        server_name localhost;
+        root /app/frontend/dist/client;
+
+        resolver 127.0.0.11 valid=5s;
+
+        location ~* /(\.env|\.git|wp-content|wp-admin|xmlrpc\.php) {
+            return 444;
+        }
+
+        location / {
+            try_files $uri @node_app;
+        }
+
+        location /_astro/ {
+            expires max;
+            add_header Cache-Control "public, max-age=31536000, immutable";
+            try_files $uri =404;
+        }
+
+        location @node_app {
+            limit_req zone=bluebird_limit burst=20 nodelay;
+
+            set $upstream_target http://app:3000;
+            proxy_pass $upstream_target;
+            proxy_http_version 1.1;
+            proxy_set_header Connection "";
+            proxy_set_header Host $host;
+            proxy_set_header X-Real-IP $remote_addr;
+            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+            proxy_set_header X-Forwarded-Proto $scheme;
+        }
+    }
+}

package/docker-compose.yml

@@ -1,28 +1,12 @@
-# ─────────────────────────────────────────────────────────────────────────────
-# Blue Bird Framework — Docker Compose
-#
-# DEVELOPMENT / DATABASE ONLY:
-#   npx blue-bird docker start mysql   → Only MySQL container
-#
-# PRODUCTION:
-#   npx blue-bird docker start prod    → MySQL + Node.js app container
-#   npx blue-bird docker stop          → Stop all containers
-#
-# Multi-project VPS support:
-#   Each project uses TITLE (or sanitised TITLE) to name
-#   containers and networks uniquely.
-# ─────────────────────────────────────────────────────────────────────────────
-
 services:
-  # ── Node.js App (Production only) ─────────────────────────────────────────
   app:
     build:
       context: .
       dockerfile: docker/Dockerfile
     container_name: ${TITLE:-bluebird}-app
     restart: unless-stopped
-    ports:
-      - "${PORT:-3000}:${PORT:-3000}"
+    expose:
+      - "3000"
     volumes:
       - .:/app
       - /app/node_modules
@@ -32,15 +16,36 @@ services:
       - NODE_ENV=production
       - DEBUG=false
       - DATABASE_URL=mysql://root:${DB_PASSWORD:-root}@mysql:3306/${DB_NAME:-blue_bird}
+      - REDIS_HOST=redis
+      - REDIS_PORT=6379
+      - PORT=3000
     depends_on:
       mysql:
         condition: service_healthy
+      redis:
+        condition: service_healthy
+    networks:
+      - bluebird_net
+    profiles:
+      - prod
+
+  nginx:
+    image: nginx:1.27-alpine
+    container_name: ${TITLE:-bluebird}-nginx
+    restart: unless-stopped
+    ports:
+      - "${PORT:-3000}:80"
+    volumes:
+      - .:/app:ro
+      - ./docker/nginx.conf:/etc/nginx/nginx.conf:ro
+    depends_on:
+      app:
+        condition: service_started
     networks:
       - bluebird_net
     profiles:
       - prod
 
-  # ── MySQL Database ─────────────────────────────────────────────────────────
   mysql:
     image: mysql:8.0
     container_name: ${TITLE:-bluebird}-mysql
@@ -61,10 +66,28 @@ services:
     networks:
       - bluebird_net
 
+  redis:
+    image: redis:7-alpine
+    container_name: ${TITLE:-bluebird}-redis
+    restart: unless-stopped
+    ports:
+      - "${REDIS_PORT:-6379}:6379"
+    volumes:
+      - redis_data:/data
+    networks:
+      - bluebird_net
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 5s
+      timeout: 3s
+      retries: 5
+
 volumes:
   mysql_data:
+  redis_data:
 
 networks:
   bluebird_net:
     name: ${TITLE:-bluebird}_network
     driver: bridge
+

package/frontend/astro.config.mjs

@@ -0,0 +1,35 @@
+import { defineConfig } from 'astro/config';
+import node from '@astrojs/node';
+import { loadEnv } from 'vite';
+import { fileURLToPath } from 'url';
+import { dirname, resolve } from 'path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+const env = loadEnv(
+  process.env.NODE_ENV ?? 'development',
+  resolve(__dirname, '..'),
+  '',
+);
+
+const apiPort = env.PORT || '3000';
+const apiHost = (env.HOST || 'localhost').replace(/^["']|["']$/g, '');
+const apiTarget = `http://${apiHost}:${apiPort}`;
+
+export default defineConfig({
+  output: 'server',
+  adapter: node({
+    mode: 'middleware',
+  }),
+  vite: {
+    envDir: resolve(__dirname, '..'),
+    server: {
+      proxy: {
+        '/api': {
+          target: apiTarget,
+          changeOrigin: true,
+        },
+      },
+    },
+  },
+});