nodejs-quickstart-structure 1.19.0 → 2.0.0

package/templates/common/public/css/style.css

@@ -1,147 +1,147 @@
-:root {
-  --primary-color: #4f46e5;
-  --primary-hover: #4338ca;
-  --bg-color: #f9fafb;
-  --card-bg: #ffffff;
-  --text-main: #111827;
-  --text-muted: #6b7280;
-  --success-color: #10b981;
-  --border-color: #e5e7eb;
-  --shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
-  --shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
-}
-
-body {
-  font-family: 'Inter', system-ui, -apple-system, sans-serif;
-  background-color: var(--bg-color);
-  color: var(--text-main);
-  margin: 0;
-  padding: 0;
-  line-height: 1.5;
-  display: flex;
-  justify-content: center;
-  min-height: 100vh;
-}
-
-.container {
-  width: 100%;
-  max-width: 800px;
-  padding: 40px 20px;
-}
-
-.header {
-  text-align: center;
-  margin-bottom: 40px;
-}
-
-.logo {
-  font-size: 3rem;
-  margin-bottom: 10px;
-}
-
-h1 {
-  font-size: 2.5rem;
-  font-weight: 800;
-  color: var(--text-main);
-  margin: 0 0 10px 0;
-  letter-spacing: -0.025em;
-}
-
-.subtitle {
-  color: var(--text-muted);
-  font-size: 1.125rem;
-}
-
-.card-grid {
-  display: grid;
-  grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
-  gap: 20px;
-  margin-bottom: 40px;
-}
-
-.card {
-  background: var(--card-bg);
-  padding: 24px;
-  border-radius: 12px;
-  box-shadow: var(--shadow-sm);
-  border: 1px solid var(--border-color);
-  transition: transform 0.2s, box-shadow 0.2s;
-}
-
-.card:hover {
-  transform: translateY(-2px);
-  box-shadow: var(--shadow-md);
-}
-
-.card h3 {
-  margin-top: 0;
-  font-size: 0.875rem;
-  text-transform: uppercase;
-  letter-spacing: 0.05em;
-  color: var(--text-muted);
-  font-weight: 600;
-}
-
-.card p {
-  font-size: 1.25rem;
-  font-weight: 600;
-  color: var(--text-main);
-  margin: 5px 0 0 0;
-}
-
-.status-card {
-  background: var(--card-bg);
-  border-radius: 12px;
-  padding: 24px;
-  box-shadow: var(--shadow-md);
-  border-left: 6px solid var(--success-color);
-  display: flex;
-  align-items: center;
-  gap: 20px;
-}
-
-.status-icon {
-  background: #d1fae5;
-  color: var(--success-color);
-  width: 48px;
-  height: 48px;
-  border-radius: 50%;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  font-size: 1.5rem;
-}
-
-.status-content h3 {
-  margin: 0;
-  font-size: 1.25rem;
-  font-weight: 700;
-}
-
-.status-content p {
-  margin: 5px 0 0 0;
-  color: var(--text-muted);
-}
-
-.action-btn {
-  display: inline-block;
-  margin-top: 40px;
-  background-color: var(--primary-color);
-  color: white;
-  padding: 12px 24px;
-  border-radius: 8px;
-  text-decoration: none;
-  font-weight: 600;
-  transition: background-color 0.2s;
-}
-
-.action-btn:hover {
-  background-color: var(--primary-hover);
-}
-
-footer {
-  margin-top: 60px;
-  text-align: center;
-  color: var(--text-muted);
-  font-size: 0.875rem;
-}
+:root {
+  --primary-color: #4f46e5;
+  --primary-hover: #4338ca;
+  --bg-color: #f9fafb;
+  --card-bg: #ffffff;
+  --text-main: #111827;
+  --text-muted: #6b7280;
+  --success-color: #10b981;
+  --border-color: #e5e7eb;
+  --shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
+  --shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
+}
+
+body {
+  font-family: 'Inter', system-ui, -apple-system, sans-serif;
+  background-color: var(--bg-color);
+  color: var(--text-main);
+  margin: 0;
+  padding: 0;
+  line-height: 1.5;
+  display: flex;
+  justify-content: center;
+  min-height: 100vh;
+}
+
+.container {
+  width: 100%;
+  max-width: 800px;
+  padding: 40px 20px;
+}
+
+.header {
+  text-align: center;
+  margin-bottom: 40px;
+}
+
+.logo {
+  font-size: 3rem;
+  margin-bottom: 10px;
+}
+
+h1 {
+  font-size: 2.5rem;
+  font-weight: 800;
+  color: var(--text-main);
+  margin: 0 0 10px 0;
+  letter-spacing: -0.025em;
+}
+
+.subtitle {
+  color: var(--text-muted);
+  font-size: 1.125rem;
+}
+
+.card-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
+  gap: 20px;
+  margin-bottom: 40px;
+}
+
+.card {
+  background: var(--card-bg);
+  padding: 24px;
+  border-radius: 12px;
+  box-shadow: var(--shadow-sm);
+  border: 1px solid var(--border-color);
+  transition: transform 0.2s, box-shadow 0.2s;
+}
+
+.card:hover {
+  transform: translateY(-2px);
+  box-shadow: var(--shadow-md);
+}
+
+.card h3 {
+  margin-top: 0;
+  font-size: 0.875rem;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  color: var(--text-muted);
+  font-weight: 600;
+}
+
+.card p {
+  font-size: 1.25rem;
+  font-weight: 600;
+  color: var(--text-main);
+  margin: 5px 0 0 0;
+}
+
+.status-card {
+  background: var(--card-bg);
+  border-radius: 12px;
+  padding: 24px;
+  box-shadow: var(--shadow-md);
+  border-left: 6px solid var(--success-color);
+  display: flex;
+  align-items: center;
+  gap: 20px;
+}
+
+.status-icon {
+  background: #d1fae5;
+  color: var(--success-color);
+  width: 48px;
+  height: 48px;
+  border-radius: 50%;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 1.5rem;
+}
+
+.status-content h3 {
+  margin: 0;
+  font-size: 1.25rem;
+  font-weight: 700;
+}
+
+.status-content p {
+  margin: 5px 0 0 0;
+  color: var(--text-muted);
+}
+
+.action-btn {
+  display: inline-block;
+  margin-top: 40px;
+  background-color: var(--primary-color);
+  color: white;
+  padding: 12px 24px;
+  border-radius: 8px;
+  text-decoration: none;
+  font-weight: 600;
+  transition: background-color 0.2s;
+}
+
+.action-btn:hover {
+  background-color: var(--primary-hover);
+}
+
+footer {
+  margin-top: 60px;
+  text-align: center;
+  color: var(--text-muted);
+  font-size: 0.875rem;
+}

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

@@ -1,63 +1,63 @@
-/* eslint-disable */
-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 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, '../') });
-};
-
-let composeCmd = 'docker-compose';
-try {
-    execSync('docker compose version', { stdio: 'ignore' });
-    composeCmd = 'docker compose';
-} catch (e) {
-    // fallback to docker-compose
-}
-
-let currentProcessStartedDocker = false;
-
-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`, { 
-            stdio: 'ignore',
-            cwd: path.resolve(__dirname, '../') 
-        });
-        isAlreadyUp = true;
-    } catch (e) {
-        isAlreadyUp = false;
-    }
-
-    if (isAlreadyUp) {
-        console.log('Infrastructure is already running! Skipping Docker spin-up...');
-    } else {
-        console.log(`Starting Docker Compose infrastructure using '${composeCmd}'...`);
-        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('Running E2E tests...');
-    execute('npm run test:e2e:run');
-} catch (error) {
-    console.error('E2E tests failed or infrastructure did not boot in time.');
-    process.exitCode = 1;
-} finally {
-    if (currentProcessStartedDocker) {
-        console.log('Tearing down isolated Docker Compose infrastructure...');
-        execute(`${composeCmd} down`);
-    } else {
-        console.log('Leaving preexisting infrastructure running.');
-    }
-}
+/* eslint-disable */
+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 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, '../') });
+};
+
+let composeCmd = 'docker-compose';
+try {
+    execSync('docker compose version', { stdio: 'ignore' });
+    composeCmd = 'docker compose';
+} catch (e) {
+    // fallback to docker-compose
+}
+
+let currentProcessStartedDocker = false;
+
+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`, { 
+            stdio: 'ignore',
+            cwd: path.resolve(__dirname, '../') 
+        });
+        isAlreadyUp = true;
+    } catch (e) {
+        isAlreadyUp = false;
+    }
+
+    if (isAlreadyUp) {
+        console.log('Infrastructure is already running! Skipping Docker spin-up...');
+    } else {
+        console.log(`Starting Docker Compose infrastructure using '${composeCmd}'...`);
+        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('Running E2E tests...');
+    execute('npm run test:e2e:run');
+} catch (error) {
+    console.error('E2E tests failed or infrastructure did not boot in time.');
+    process.exitCode = 1;
+} finally {
+    if (currentProcessStartedDocker) {
+        console.log('Tearing down isolated Docker Compose infrastructure...');
+        execute(`${composeCmd} down`);
+    } else {
+        console.log('Leaving preexisting infrastructure running.');
+    }
+}

package/templates/common/sonar-project.properties.ejs

@@ -1,27 +1,27 @@
-# SonarCloud/SonarQube Project Configuration
-# See https://docs.sonarqube.org/latest/analysis/analysis-parameters/
-
-sonar.projectKey=your-org-key_<%= projectName %>
-sonar.projectName=<%= projectName %>
-sonar.organization=your-org-key
-sonar.projectVersion=1.0.0
-
-# Path to the source directories
-sonar.sources=src
-# Path to the test directories
-sonar.tests=tests
-
-# Language specific settings
-sonar.javascript.environments=node
-sonar.typescript.tsconfigPath=tsconfig.json
-sonar.javascript.lcov.reportPaths=coverage/lcov.info
-
-# Exclusions
-sonar.exclusions=node_modules/**, dist/**, coverage/**, tests/**
-
-# Quality Gates
-sonar.qualitygate.wait=true
-sonar.qualitygate.timeout=300
-
-# Security Hotspots
-sonar.security.reportPaths=snyk-report.json
+# SonarCloud/SonarQube Project Configuration
+# See https://docs.sonarqube.org/latest/analysis/analysis-parameters/
+
+sonar.projectKey=your-org-key_<%= projectName %>
+sonar.projectName=<%= projectName %>
+sonar.organization=your-org-key
+sonar.projectVersion=1.0.0
+
+# Path to the source directories
+sonar.sources=src
+# Path to the test directories
+sonar.tests=tests
+
+# Language specific settings
+sonar.javascript.environments=node
+sonar.typescript.tsconfigPath=tsconfig.json
+sonar.javascript.lcov.reportPaths=coverage/lcov.info
+
+# Exclusions
+sonar.exclusions=node_modules/**, dist/**, coverage/**, tests/**
+
+# Quality Gates
+sonar.qualitygate.wait=true
+sonar.qualitygate.timeout=300
+
+# Security Hotspots
+sonar.security.reportPaths=snyk-report.json

package/templates/common/src/utils/errorMiddleware.spec.js.ejs

@@ -1,79 +1,79 @@
-const { errorMiddleware } = require('<% if (architecture === "MVC") { %>@/utils/errorMiddleware<% } else { %>@/infrastructure/webserver/middleware/errorMiddleware<% } %>');
-const { ApiError } = require('@/errors/ApiError');
-const HTTP_STATUS = require('@/utils/httpCodes');
-const logger = require('<% if (architecture === "MVC") { %>@/utils/logger<% } else { %>@/infrastructure/log/logger<% } %>');
-
-jest.mock('<% if (architecture === "MVC") { %>@/utils/logger<% } else { %>@/infrastructure/log/logger<% } %>');
-
-describe('Error Middleware', () => {
-    let mockRequest;
-    let mockResponse;
-    let nextFunction;
-    const originalEnv = process.env.NODE_ENV;
-
-    beforeEach(() => {
-        mockRequest = {
-            originalUrl: '/test',
-            method: 'GET',
-            ip: '127.0.0.1'
-        };
-        mockResponse = {
-            status: jest.fn().mockReturnThis(),
-            json: jest.fn()
-        };
-        nextFunction = jest.fn();
-        jest.clearAllMocks();
-    });
-
-    afterEach(() => {
-        process.env.NODE_ENV = originalEnv;
-    });
-
-    it('should handle standard Error by wrapping it in a 500 ApiError', () => {
-        const error = new Error('Standard Error');
-        errorMiddleware(error, mockRequest, mockResponse, nextFunction);
-
-        expect(logger.error).toHaveBeenCalled();
-        expect(mockResponse.status).toHaveBeenCalledWith(HTTP_STATUS.INTERNAL_SERVER_ERROR);
-    });
-
-    it('should handle custom ApiError directly', () => {
-        const customError = new ApiError(HTTP_STATUS.BAD_REQUEST, 'Bad Request Data', true);
-        errorMiddleware(customError, mockRequest, mockResponse, nextFunction);
-
-        expect(mockResponse.status).toHaveBeenCalledWith(HTTP_STATUS.BAD_REQUEST);
-        expect(mockResponse.json).toHaveBeenCalledWith(expect.objectContaining({
-            statusCode: HTTP_STATUS.BAD_REQUEST,
-            message: 'Bad Request Data'
-        }));
-    });
-
-    it('should include stack trace in development environment', () => {
-        process.env.NODE_ENV = 'development';
-        const error = new Error('Test Error');
-        errorMiddleware(error, mockRequest, mockResponse, nextFunction);
-
-        expect(mockResponse.json).toHaveBeenCalledWith(expect.objectContaining({
-            stack: expect.any(String)
-        }));
-    });
-
-    it('should omit stack trace in production environment', () => {
-        process.env.NODE_ENV = 'production';
-        const error = new Error('Test Error');
-        errorMiddleware(error, mockRequest, mockResponse, nextFunction);
-
-        const jsonArg = mockResponse.json.mock.calls[0][0];
-        expect(jsonArg.stack).toBeUndefined();
-    });
-
-    it('should handle error without stack trace', () => {
-        const { ApiError } = require('@/errors/ApiError');
-        const customError = new ApiError(500, 'No Stack', false);
-        delete customError.stack;
-        errorMiddleware(customError, mockRequest, mockResponse, nextFunction);
-
-        expect(logger.error).toHaveBeenCalledWith(expect.stringContaining('No Stack'));
-        expect(logger.error).toHaveBeenCalledWith('No stack trace');
-    });
-});
+const { errorMiddleware } = require('<% if (architecture === "MVC") { %>@/utils/errorMiddleware<% } else { %>@/infrastructure/webserver/middleware/errorMiddleware<% } %>');
+const { ApiError } = require('@/errors/ApiError');
+const HTTP_STATUS = require('@/utils/httpCodes');
+const logger = require('<% if (architecture === "MVC") { %>@/utils/logger<% } else { %>@/infrastructure/log/logger<% } %>');
+
+jest.mock('<% if (architecture === "MVC") { %>@/utils/logger<% } else { %>@/infrastructure/log/logger<% } %>');
+
+describe('Error Middleware', () => {
+    let mockRequest;
+    let mockResponse;
+    let nextFunction;
+    const originalEnv = process.env.NODE_ENV;
+
+    beforeEach(() => {
+        mockRequest = {
+            originalUrl: '/test',
+            method: 'GET',
+            ip: '127.0.0.1'
+        };
+        mockResponse = {
+            status: jest.fn().mockReturnThis(),
+            json: jest.fn()
+        };
+        nextFunction = jest.fn();
+        jest.clearAllMocks();
+    });
+
+    afterEach(() => {
+        process.env.NODE_ENV = originalEnv;
+    });
+
+    it('should handle standard Error by wrapping it in a 500 ApiError', () => {
+        const error = new Error('Standard Error');
+        errorMiddleware(error, mockRequest, mockResponse, nextFunction);
+
+        expect(logger.error).toHaveBeenCalled();
+        expect(mockResponse.status).toHaveBeenCalledWith(HTTP_STATUS.INTERNAL_SERVER_ERROR);
+    });
+
+    it('should handle custom ApiError directly', () => {
+        const customError = new ApiError(HTTP_STATUS.BAD_REQUEST, 'Bad Request Data', true);
+        errorMiddleware(customError, mockRequest, mockResponse, nextFunction);
+
+        expect(mockResponse.status).toHaveBeenCalledWith(HTTP_STATUS.BAD_REQUEST);
+        expect(mockResponse.json).toHaveBeenCalledWith(expect.objectContaining({
+            statusCode: HTTP_STATUS.BAD_REQUEST,
+            message: 'Bad Request Data'
+        }));
+    });
+
+    it('should include stack trace in development environment', () => {
+        process.env.NODE_ENV = 'development';
+        const error = new Error('Test Error');
+        errorMiddleware(error, mockRequest, mockResponse, nextFunction);
+
+        expect(mockResponse.json).toHaveBeenCalledWith(expect.objectContaining({
+            stack: expect.any(String)
+        }));
+    });
+
+    it('should omit stack trace in production environment', () => {
+        process.env.NODE_ENV = 'production';
+        const error = new Error('Test Error');
+        errorMiddleware(error, mockRequest, mockResponse, nextFunction);
+
+        const jsonArg = mockResponse.json.mock.calls[0][0];
+        expect(jsonArg.stack).toBeUndefined();
+    });
+
+    it('should handle error without stack trace', () => {
+        const { ApiError } = require('@/errors/ApiError');
+        const customError = new ApiError(500, 'No Stack', false);
+        delete customError.stack;
+        errorMiddleware(customError, mockRequest, mockResponse, nextFunction);
+
+        expect(logger.error).toHaveBeenCalledWith(expect.stringContaining('No Stack'));
+        expect(logger.error).toHaveBeenCalledWith('No stack trace');
+    });
+});