@seip/blue-bird 0.9.8 → 1.0.0

package/AGENTS.md

@@ -117,7 +117,7 @@ Production deployments always use Docker for orchestration, running:
 
 ```bash
 # Manage containers using blue-bird CLI
-npx blue-bird docker dev            # Starts development environment stack (DB, redis, nginx). Run npm run dev manually.
+npx blue-bird docker dev            # Starts development database & redis containers. Run npm run dev manually.
 npx blue-bird docker start          # Starts production app stack (DB, redis, app, nginx)
 npx blue-bird docker start db       # Starts configured database container only (postgres or mysql)
 npx blue-bird docker start redis    # Starts Redis container only

package/README.md

@@ -385,7 +385,7 @@ npx blue-bird docker <command> [options]
 
 ### Supported Actions:
 
-- **`npx blue-bird docker dev`**: Boots the development environment stack (Database + Redis + Nginx). Run `npm run dev` locally to start the Node.js application.
+- **`npx blue-bird docker dev`**: Boots the development database and Redis containers. Run `npm run dev` locally on your host machine.
 - **`npx blue-bird docker start`**: Boots the production stack (Node.js App + Nginx + Database + Redis).
 - **`npx blue-bird docker start db`** (or `postgres` / `mysql`): Boots the configured database container only (great for local development outside Docker).
 - **`npx blue-bird docker start redis`**: Boots the Redis container only.

package/core/app.js

@@ -157,15 +157,16 @@ class App {
       next();
     });
 
-    if (this.static.path)
+    if (this.static.path || props.debug)
       this.app.use(
-        express.static(path.join(__dirname, this.static.path), {
+        express.static(path.join(__dirname, this.static.path || "frontend"), {
+          extensions: ["html"],
           ...this.static.options,
           setHeaders: (res) => {
             res.setHeader("X-Powered-By", "Blue Bird");
             res.setHeader(
               "Cache-Control",
-              "public, max-age=31536000, immutable",
+              props.debug ? "no-cache" : "public, max-age=31536000, immutable",
             );
           },
         }),
@@ -336,14 +337,14 @@ class App {
         this.server.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" +
-              (props.debug ? chalk.bold.magenta("Hot Reload: enabled\n") : "") +
-              chalk.gray("────────────────────────────────"),
+            chalk.bold.cyan("App URL: ") +
+            chalk.green(`${this.appUrl}`) +
+            "\n" +
+            chalk.bold.cyan("Internal: ") +
+            chalk.green(`${this.host}:${this.port}`) +
+            "\n" +
+            (props.debug ? chalk.bold.magenta("Hot Reload: enabled\n") : "") +
+            chalk.gray("────────────────────────────────"),
           );
         });
       })

package/core/cli/docker.js

@@ -148,20 +148,20 @@ async function startCommand(service) {
 async function devCommand() {
   checkComposeFile();
   const dbType = getDbType();
-  console.log(chalk.cyan("Starting development stack (DB + Redis + Nginx)..."));
+  console.log(chalk.cyan("Starting development environment (Database + Redis)..."));
 
-  const containers = ["redis", "nginx"];
+  const containers = ["redis"];
   if (dbType !== "none") {
     containers.unshift(dbType);
   }
 
   const code = await runCmd("docker", ["compose", "up", "-d", ...containers]);
   if (code === 0) {
-    console.log(chalk.green("Development stack started."));
-    console.log(chalk.cyan("View live logs with: npx blue-bird docker logs"));
+    console.log(chalk.green("Development containers started."));
+    console.log(chalk.cyan("View live logs with: npx blue-bird docker logs db"));
     console.log(chalk.yellow("Now execute: npm run dev"));
   } else {
-    console.error(chalk.red("Error starting development stack."));
+    console.error(chalk.red("Error starting development environment."));
     process.exit(1);
   }
 }

package/core/config.js

@@ -42,8 +42,10 @@ class Config {
       port: Number.isNaN(portRaw) ? 3000 : portRaw,
       jwtSecret: process.env.JWT_SECRET,
       static: {
-        path: process.env.STATIC_PATH || "frontend/public",
-        options: {},
+        path: process.env.STATIC_PATH || "frontend",
+        options: {
+          extensions: ["html"],
+        },
       },
     };
     return _cachedProps;

package/docker/docker-compose.mysql.yml

@@ -38,9 +38,6 @@ services:
     volumes:
       - .:/app:ro
       - ./docker/nginx.conf:/etc/nginx/nginx.conf:ro
-    depends_on:
-      app:
-        condition: service_started
     networks:
       - bluebird_net
     profiles:

package/docker/docker-compose.none.yml

@@ -35,9 +35,6 @@ services:
     volumes:
       - .:/app:ro
       - ./docker/nginx.conf:/etc/nginx/nginx.conf:ro
-    depends_on:
-      app:
-        condition: service_started
     networks:
       - bluebird_net
     profiles:

package/docker/docker-compose.postgres.yml

@@ -38,9 +38,6 @@ services:
     volumes:
       - .:/app:ro
       - ./docker/nginx.conf:/etc/nginx/nginx.conf:ro
-    depends_on:
-      app:
-        condition: service_started
     networks:
       - bluebird_net
     profiles:

package/docker-compose.yml

@@ -38,9 +38,6 @@ services:
     volumes:
       - .:/app:ro
       - ./docker/nginx.conf:/etc/nginx/nginx.conf:ro
-    depends_on:
-      app:
-        condition: service_started
     networks:
       - bluebird_net
     profiles:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seip/blue-bird",
-  "version": "0.9.8",
+  "version": "1.0.0",
   "description": "Express opinionated API framework with built-in JWT auth, validation, and caching",
   "type": "module",
   "types": "core/index.d.ts",
@@ -63,4 +63,4 @@
     "ws": "^8.18.0",
     "xss": "^1.0.15"
   }
-}
+}