nodejs-quickstart-structure 2.0.0 → 2.0.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.0.1] - 2026-04-07
+
+### Added
+- **Universal CI/CD Support (Phase 8)**: Expanded the generator's CI/CD capabilities to include out-of-the-box support for **Bitbucket Pipelines** and **CircleCI**.
+- **Modernized Pipe & Orb Integration**: 
+  - Bitbucket templates now utilize official Atlassian Pipes for automated Snyk security scans and SonarCloud analysis.
+  - CircleCI configurations (v2.1) are optimized with official Orbs (`circleci/node`, `snyk/snyk`) for advanced dependency caching and security execution.
+- **Project Blueprints (CI/CD Guide)**: Launched a comprehensive "CI/CD Setup Guide" in the VitePress documentation, providing step-by-step configuration workflows for all 5 supported platforms (GitHub, GitLab, Jenkins, Bitbucket, CircleCI).
+- **CLI Ecosystem Sync**: Updated the interactive prompts and command-line flags to seamlessly integrate the new CI/CD choices while maintaining 100% backward compatibility.
+- **Enterprise Readness Documentation**: Updated the generated `README.md` templates to officially include Bitbucket and CircleCI in the supported feature set.
+
+
 ## [2.0.0] - 2026-04-02
 
 ### Added

package/README.md

@@ -40,7 +40,7 @@ The v2.0.0 release is a major leap forward, turning the generator into a **Commu
 - [🚀 Quick Start](#-quick-start)
 - [✨ Key Features](#-key-features)
 - [🛡️ Professional Standards](#-professional-standards)
-- [🧩 1,680+ Project Combinations](#-1680-project-combinations)
+- [🧩 2,640+ Project Combinations](#-2640-project-combinations)
 - [⚙️ Configuration Options](#-configuration-options)
 - [🏗️ Generated Project Structure](#-generated-project-structure)
 - [📖 Documentation](#-documentation)
@@ -88,19 +88,19 @@ We don't just generate boilerplate; we generate **production-ready** foundations
 - **🛡️ Enterprise Security**: Integrated **Snyk (SCA)**, **SonarCloud (SAST)**, `Helmet`, `HPP`, and Rate-Limiting.
 - **🚨 Robust Error Handling**: Centralized global error middleware with custom error classes (`ApiError`, `NotFoundError`, etc.) — consistent across REST & GraphQL.
 - **🧪 Testing Excellence**: Integrated `Jest` and `Supertest` with **>80% Unit Test coverage** out of the box.
-- **🔄 DevOps & CI/CD**: Optimized **Multi-Stage Dockerfiles**, health checks, infrastructure retry logic, and workflows for **GitHub Actions**, **Jenkins**, and **GitLab CI**.
+- **🔄 DevOps & CI/CD**: Optimized **Multi-Stage Dockerfiles**, health checks, infrastructure retry logic, and workflows for **GitHub Actions**, **Jenkins**, **GitLab CI**, **CircleCI**, and **Bitbucket Pipelines**.
 - **🚀 Scalable Deployment**: Integrated **PM2 Ecosystem** config for zero-downtime reloads.
 
 ---
 
-## 🧩 1,680+ Project Combinations
+## 🧩 2,640+ Project Combinations
 
 The CLI supports a massive number of configurations to fit your exact needs:
 
 - **240 Core Combinations**:
   - **MVC Architecture**: 180 variants (Languages × View Engines × Databases × Communication Patterns × Caching)
   - **Clean Architecture**: 60 variants (Languages × Databases × Communication Patterns × Caching)
-- **1,680+ Total Scenarios**:
+- **2,640+ Total Scenarios**:
   - Every combination can be generated across 3 CI/CD providers.
   - Optional **Enterprise-Grade Security Hardening** doubles the scenarios.
   - Every single scenario is verified to be compatible with our **80% Coverage Threshold** policy.
@@ -117,7 +117,7 @@ The CLI will guide you through:
 5. **Database**: `MySQL` | `PostgreSQL` | `MongoDB`
 6. **Communication**: `REST` | `GraphQL` | `Kafka`
 7. **Caching**: `None` | `Redis` | `Memory Cache`
-8. **CI/CD**: `GitHub Actions` | `Jenkins` | `GitLab CI`
+8. **CI/CD**: `GitHub Actions` | `Jenkins` | `GitLab CI` | `CircleCI` | `Bitbucket Pipelines`
 9. **Security**: (Optional) Snyk & SonarCloud Hardening
 
 ---

package/bin/index.js

@@ -29,7 +29,7 @@ program
     .option('-d, --database <database>', 'Database (MySQL, PostgreSQL)')
     .option('--db-name <name>', 'Database name')
     .option('-c, --communication <communication>', 'Communication (REST APIs, GraphQL, Kafka)')
-    .option('--ci-provider <provider>', 'CI/CD Provider (None, GitHub Actions, Jenkins, GitLab CI)')
+    .option('--ci-provider <provider>', 'CI/CD Provider (None, GitHub Actions, Jenkins, GitLab CI, Bitbucket Pipelines, CircleCI)')
     .option('--include-security', 'Include Enterprise Security Hardening')
     .option('--no-include-security', 'Exclude Enterprise Security Hardening')
     .option('--caching <type>', 'Caching Layer (None/Redis)')

package/lib/modules/config-files.js

@@ -120,6 +120,16 @@ export const setupCiCd = async (templatesDir, targetDir, config) => {
         const gitlabTemplate = await fs.readFile(path.join(templatesDir, 'common', '.gitlab-ci.yml.ejs'), 'utf-8');
         const gitlabContent = ejs.render(gitlabTemplate, { ...config });
         await fs.writeFile(path.join(targetDir, '.gitlab-ci.yml'), gitlabContent);
+    } else if (ciProvider === 'Bitbucket Pipelines') {
+        const bitbucketTemplate = await fs.readFile(path.join(templatesDir, 'common', 'bitbucket-pipelines.yml.ejs'), 'utf-8');
+        const bitbucketContent = ejs.render(bitbucketTemplate, { ...config });
+        await fs.writeFile(path.join(targetDir, 'bitbucket-pipelines.yml'), bitbucketContent);
+    } else if (ciProvider === 'CircleCI') {
+        const circleCiDir = path.join(targetDir, '.circleci');
+        await fs.ensureDir(circleCiDir);
+        const circleCiTemplate = await fs.readFile(path.join(templatesDir, 'common', '_circleci/config.yml.ejs'), 'utf-8');
+        const circleCiContent = ejs.render(circleCiTemplate, { ...config });
+        await fs.writeFile(path.join(circleCiDir, 'config.yml'), circleCiContent);
     }
 };
 

package/lib/prompts.js

@@ -74,7 +74,7 @@ export const getProjectDetails = async (options = {}) => {
             type: 'select',
             name: 'ciProvider',
             message: 'Select CI/CD Provider:',
-            choices: ['None', 'GitHub Actions', 'Jenkins', 'GitLab CI'],
+            choices: ['None', 'GitHub Actions', 'Jenkins', 'GitLab CI', 'CircleCI', 'Bitbucket Pipelines'],
             default: 'None',
             when: !options.ciProvider
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nodejs-quickstart-structure",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "type": "module",
   "description": "The ultimate nodejs quickstart structure CLI to scaffold Node.js microservices with MVC or Clean Architecture",
   "main": "bin/index.js",

package/templates/common/.gitlab-ci.yml.ejs

@@ -1,5 +1,7 @@
 variables:
   NODE_ENV: 'test'
+  WAIT_ON_HOST: docker
+  TEST_URL: http://docker:3001
 
 stages:
   - lint
@@ -30,7 +32,7 @@ run_unit_tests:
   stage: test
   image: node:22-slim
   script:
-    - npm run test:coverage
+    - npm run test:coverage -- --maxWorkers=2
 
 run_e2e_tests:
   stage: test

package/templates/common/Jenkinsfile.ejs

@@ -3,6 +3,15 @@ pipeline {
 
     environment {
         CI = 'true'
+        DOCKER_BUILDKIT = '0'
+        PORT = '3001'
+        DB_PORT = '3307'
+        WAIT_ON_HOST = 'host.docker.internal'
+        TEST_URL = 'http://host.docker.internal:3001'
+    }
+
+    tools {
+        nodejs 'nodejs'
     }
 
     stages {
@@ -21,7 +30,7 @@ pipeline {
 
         stage('Unit Test') {
             steps {
-                sh 'npm run test:coverage'
+                sh 'npm run test:coverage -- --maxWorkers=2'
             }
         }
 

package/templates/common/README.md.ejs

@@ -31,7 +31,7 @@ This project follows a strict **7-Step Production-Ready Process** to ensure qual
 -   **Database**: <%= database %> <% if (database !== 'None') { %>(via <%= database === 'MongoDB' ? 'Mongoose' : 'Sequelize' %>)<% } %>.
 -   **Security**: Helmet, CORS, Rate Limiting, HPP, Snyk SCA.
 -   **Quality**: 80%+ Test Coverage, Eslint, Prettier, Husky.
--   **DevOps**: Multi-stage Docker, CI/CD ready (GitHub/GitLab/Jenkins).
+-   **DevOps**: Multi-stage Docker, CI/CD ready (GitHub/GitLab/Jenkins/Bitbucket/CircleCI).
 <% if (includeSecurity) { %>-   **Enterprise Hardening**: SonarCloud SAST, Security Policies.<% } %>
 
 ## 📂 Project Structure

package/templates/common/_circleci/config.yml.ejs

@@ -0,0 +1,96 @@
+version: 2.1
+
+orbs:
+  node: circleci/node@5.2.0
+<% if (includeSecurity) { %>
+  snyk: snyk/snyk@2.1.0
+<% } %>
+
+executors:
+  node-executor:
+    docker:
+      - image: cimg/node:22.0
+  machine-executor:
+    machine:
+      image: ubuntu-2204:current
+
+jobs:
+  lint:
+    executor: node-executor
+    steps:
+      - checkout
+      - node/install-packages
+      - run: npm run lint
+
+  unit_test:
+    executor: node-executor
+    steps:
+      - checkout
+      - node/install-packages
+      - run:
+          name: Run Unit Tests with Coverage
+          command: npm run test:coverage -- --maxWorkers=2
+
+  e2e_test:
+    executor: machine-executor
+    steps:
+      - checkout
+      - node/install:
+          node-version: '22.0'
+      - run: npm ci
+      - run: npm run test:e2e
+
+<% if (includeSecurity) { %>
+  security_scan:
+    executor: node-executor
+    steps:
+      - checkout
+      - node/install-packages
+      - snyk/scan:
+          fail-on-issues: true
+          severity-threshold: high
+
+  sonarqube_analysis:
+    executor: node-executor
+    steps:
+      - checkout
+      - node/install-packages
+      - run:
+          name: SonarQube Analysis
+          command: |
+            # Assuming sonar-scanner is available or run via npx
+            npx sonar-scanner
+<% } %>
+
+  build:
+    executor: node-executor
+    steps:
+      - checkout
+      - node/install-packages
+      - run: npm run build --if-present
+
+workflows:
+  build_and_test:
+    jobs:
+      - lint
+      - unit_test:
+          requires:
+            - lint
+      - e2e_test:
+          requires:
+            - unit_test
+<% if (includeSecurity) { %>
+      - security_scan:
+          requires:
+            - unit_test
+      - sonarqube_analysis:
+          requires:
+            - unit_test
+<% } %>
+      - build:
+          requires:
+            - e2e_test
+<% if (includeSecurity) { %>
+            - security_scan
+            - sonarqube_analysis
+<% } %>

package/templates/common/_github/workflows/ci.yml.ejs

@@ -30,7 +30,7 @@ jobs:
       run: npm run lint
       
     - name: Run Unit Tests
-      run: npm run test:coverage
+      run: npm run test:coverage -- --maxWorkers=2
       
     - name: Run E2E Tests
       run: npm run test:e2e

package/templates/common/bitbucket-pipelines.yml.ejs

@@ -0,0 +1,60 @@
+image: node:22-slim
+
+pipelines:
+  default:
+    - step:
+        name: Install Dependencies
+        caches:
+          - node
+        script:
+          - npm ci
+    - parallel:
+        - step:
+            name: Lint Code
+            script:
+              - npm ci
+              - npm run lint
+        - step:
+            name: Run Unit Tests
+            script:
+              - npm ci
+              - npm run test:coverage -- --maxWorkers=2
+    - step:
+        name: Run E2E Tests
+        image: docker:20.10.16
+        services:
+          - docker
+        script:
+          - apk add --no-cache nodejs npm docker-compose
+          - npm ci
+          - export DOCKER_BUILDKIT=0
+          - npm run test:e2e
+<% if (includeSecurity) { %>
+    - parallel:
+        - step:
+            name: Snyk Security Scan
+            script:
+              - pipe: snyk/snyk-scan:1.0.0
+                variables:
+                  SNYK_TOKEN: $SNYK_TOKEN
+                  LANGUAGE: "npm"
+                  SEVERITY_THRESHOLD: "high"
+        - step:
+            name: SonarQube Analysis
+            script:
+              - pipe: sonarsource/sonarcloud-scan:2.0.0
+                variables:
+                  SONAR_TOKEN: $SONAR_TOKEN
+<% } %>
+    - step:
+        name: Build Application
+        script:
+          - npm ci
+          - npm run build --if-present
+
+definitions:
+  services:
+    docker:
+      memory: 2048
+  caches:
+    node: ~/.npm

package/templates/common/caching/clean/ts/updateUser.ts.ejs

@@ -1,4 +1,3 @@
-import { User } from '@/domain/user';
 import { UserRepository } from '@/infrastructure/repositories/UserRepository';
 <%_ if (caching === 'Redis') { -%>
 import cacheService from '@/infrastructure/caching/redisClient';

package/templates/common/docker-compose.yml.ejs

@@ -122,10 +122,12 @@ services:
       FLYWAY_URL: jdbc:mysql://db:3306/<%= dbName %>
       FLYWAY_USER: root
       FLYWAY_PASSWORD: root
+      FLYWAY_BASELINE_ON_MIGRATE: "true"
 <%_ } -%><%_ if (database === 'PostgreSQL') { -%>
       FLYWAY_URL: jdbc:postgresql://db:5432/<%= dbName %>
       FLYWAY_USER: postgres
       FLYWAY_PASSWORD: root
+      FLYWAY_BASELINE_ON_MIGRATE: "true"
 <%_ } -%>
     depends_on:
       - db

package/templates/common/package.json.ejs

@@ -28,7 +28,8 @@
     "micromatch": "^4.0.8",
     "braces": "^3.0.3",
     "picomatch": "^4.0.4",
-    "lodash": "^4.17.23"
+    "lodash": "^4.17.23",
+    "debounce": "^1.2.1"
   },
   "dependencies": {
     "express": "^4.18.2",

package/templates/common/scripts/run-e2e.js.ejs

@@ -3,13 +3,21 @@ const { execSync } = require('child_process');
 const path = require('path');
 
 // Set a specific port for E2E tests to avoid collisions with local development
-process.env.PORT = '3001';
-const TEST_PORT = process.env.PORT;
+const TEST_PORT = <% if (database === 'MySQL') { %>process.env.PORT || '3001'<% } else { %>process.env.PORT || '3001'<% } %>;
+const WAIT_ON_HOST = process.env.WAIT_ON_HOST || '127.0.0.1';
 
 const execute = (command) => {
-    console.log(`\n> ${command}`);
-    // Run commands from the project root instead of the scripts folder
-    execSync(command, { stdio: 'inherit', cwd: path.resolve(__dirname, '../') });
+  console.log(`\n> ${command}`);
+  // Run commands from the project root instead of the scripts folder
+  execSync(command, { 
+    stdio: 'inherit', 
+    cwd: path.resolve(__dirname, '../'),
+    env: { 
+      ...process.env, 
+      PORT: TEST_PORT,
+      DB_PORT: process.env.DB_PORT || '3306'
+    }
+  });
 };
 
 let composeCmd = 'docker-compose';
@@ -26,7 +34,7 @@ try {
     let isAlreadyUp = false;
     try {
         // Silently check if the endpoint is already live (1.5-second timeout)
-        execSync(`npx wait-on http-get://127.0.0.1:${TEST_PORT}/health -t 1500`, { 
+        execSync(`npx wait-on http-get://${WAIT_ON_HOST}:${TEST_PORT}/health -t 1500`, { 
             stdio: 'ignore',
             cwd: path.resolve(__dirname, '../') 
         });
@@ -42,10 +50,18 @@ try {
         execute(`${composeCmd} up -d --build`);
         currentProcessStartedDocker = true;
 
-        console.log('Waiting for application healthcheck to turn green (120s timeout)...');
-        // Using wait-on to poll the universal /health endpoint injected into all architectures
-        execute(`npx wait-on http-get://127.0.0.1:${TEST_PORT}/health -t 120000`);
-        console.log('Infrastructure is healthy!');
+        console.log(`Waiting for application healthcheck to turn green (420s timeout)...`);
+        try {
+            // Using WAIT_ON_HOST to allow containerized CI to hit host ports (e.g. host.docker.internal)
+            execute(`npx wait-on http-get://${WAIT_ON_HOST}:${TEST_PORT}/health -t 420000`);
+            console.log('Infrastructure is healthy!');
+        } catch (e) {
+            console.error('\n❌ Healthcheck timed out! Printing infrastructure logs for debugging:');
+            console.error('------------------------------------------------------------');
+            execute(`${composeCmd} logs --tail=100`);
+            console.error('------------------------------------------------------------');
+            throw e;
+        }
     }
 
     console.log('Running E2E tests...');