nodejs-quickstart-structure 1.11.0 → 1.12.0

package/lib/modules/kafka-setup.js

@@ -55,21 +55,12 @@ export const setupKafka = async (templatesDir, targetDir, config) => {
         // Cleanup old services folder
         await fs.remove(path.join(targetDir, 'src/services'));
         
-        // Remove src/config if it was only for Kafka and not needed by other parts
-        // But Database setup might assume src/config existence in some templates (though moved to infrastructure/database for clean arch)
-        // Safest to leave src/config if non-empty, or remove if empty. 
-        // For now, mirroring original logic: remove specific REST folders
-        
         // Remove REST-specific folders (Interfaces)
         await fs.remove(path.join(targetDir, 'src/interfaces/routes'));
         await fs.remove(path.join(targetDir, 'src/interfaces/controllers'));
         
-        // Original logic removed src/config entirely for clean arch kafka? 
-        // Let's check original logic: 
-        // await fs.remove(path.join(targetDir, 'src/config'));
-        // Yes, it did.
-         await fs.remove(path.join(targetDir, 'src/config'));
-
+        // Original logic removed src/config entirely, but now we use it for Zod env validation in TS.
+        // We will no longer delete it.
     } else if (architecture === 'MVC' && (!config.viewEngine || config.viewEngine === 'None')) {
         // MVC Cleanup for Kafka Worker (No views)
         await fs.remove(path.join(targetDir, 'src/controllers'));
@@ -84,29 +75,5 @@ export const setupViews = async (templatesDir, targetDir, config) => {
         if (await fs.pathExists(publicDir)) {
             await fs.copy(publicDir, path.join(targetDir, 'public'));
         }
-        
-        // Copy views mapping
-        // Logic handled in database-setup (part of db config block in original) but functionally belongs here or separate.
-        // Original: if (viewEngine && viewEngine !== 'None') await fs.copy(...) inside the DB block for MVC.
-        // We moved it to database-setup.js to match flow, but let's double check if we missed it there.
-        // Checked database-setup.js: It copies views ONLY if database !== 'None' OR if database === 'None'
-        // So it is covered. Ideally it should be here, but for now strict refactor keeps it effectively in DB/structure setup phase.
-        // To be cleaner, we should move the VIEW copying here.
-        
-        // Moving View Copying Check here for better separation:
-        // We need to verify if database-setup.js ALREADY does this. 
-        // In my prev step for database-setup.js, I included logic:
-        // if (architecture === 'MVC') { if (viewEngine...) copy views }
-        // So duplication might occur if I add it here too. 
-        // Let's relies on this module ONLY for public assets for now, or ensure idempotency.
-        
-        // Actually, let's keep it clean. database-setup.js shouldn't handle views. 
-        // I will assume I can update database-setup.js to remove view copying if I put it here?
-        // OR just leave it there for this iteration to avoid breaking changes in flow order.
-        // Let's stick to the original flow where possible, but this module is 'kafka-and-views'.
-        
-        // The original logic had view copying inside the "Database Config" block.
-        // My database-setup.js preserved that. 
-        // So this logic here only handles 'public' folder copying which was Step 8 in original.
     }
 };

package/package.json

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

package/templates/clean-architecture/js/src/errors/BadRequestError.js

@@ -1,5 +1,5 @@
 const { ApiError } = require('./ApiError');
-const { HTTP_STATUS } = require('../../utils/httpCodes');
+const { HTTP_STATUS } = require('../utils/httpCodes');
 
 class BadRequestError extends ApiError {
   constructor(message = 'Bad request') {

package/templates/clean-architecture/js/src/errors/NotFoundError.js

@@ -1,5 +1,5 @@
 const { ApiError } = require('./ApiError');
-const { HTTP_STATUS } = require('../../utils/httpCodes');
+const { HTTP_STATUS } = require('../utils/httpCodes');
 
 class NotFoundError extends ApiError {
   constructor(message = 'Resource not found') {

package/templates/clean-architecture/js/src/index.js.ejs

@@ -4,8 +4,6 @@ const logger = require('./infrastructure/log/logger');
 const { connectKafka, sendMessage } = require('./infrastructure/messaging/kafkaClient');
 <% } -%>
 
-const PORT = process.env.PORT || 3000;
-
 <%_ if (database !== 'None') { -%>
 // Database Sync
 const syncDatabase = async () => {
@@ -21,7 +19,7 @@ const syncDatabase = async () => {
             <%_ } -%>
             logger.info('Database synced');
             // Start the web server after DB sync
-            startServer(PORT);
+            startServer();
             <%_ if (communication === 'Kafka') { -%>
             // Connect Kafka
             connectKafka().then(async () => {
@@ -42,7 +40,7 @@ const syncDatabase = async () => {
 };
 syncDatabase();
 <%_ } else { -%>
-startServer(PORT);
+startServer();
 <%_ if (communication === 'Kafka') { -%>
 // Connect Kafka
 connectKafka().then(async () => {

package/templates/clean-architecture/js/src/infrastructure/config/env.js.ejs

@@ -0,0 +1,47 @@
+const { z } = require('zod');
+const logger = require('../log/logger');
+
+if (process.env.NODE_ENV !== 'production') {
+  require('dotenv').config();
+}
+
+const envSchema = z.object({
+  NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),
+  PORT: z.string().transform(Number).default('3000'),
+<%_ if (database !== 'None') { -%>
+  DB_HOST: z.string(),
+<%_ if (database === 'MySQL') { -%>
+  DB_USER: z.string(),
+  DB_PASSWORD: z.string(),
+  DB_NAME: z.string(),
+  DB_PORT: z.string().transform(Number),
+<%_ } else if (database === 'PostgreSQL') { -%>
+  DB_USER: z.string(),
+  DB_PASSWORD: z.string(),
+  DB_NAME: z.string(),
+  DB_PORT: z.string().transform(Number),
+<%_ } else if (database === 'MongoDB') { -%>
+  DB_NAME: z.string(),
+  DB_PORT: z.string().transform(Number),
+<%_ } -%>
+<%_ } -%>
+<%_ if (caching === 'Redis') { -%>
+  REDIS_HOST: z.string(),
+  REDIS_PORT: z.string().transform(Number),
+  REDIS_PASSWORD: z.string().optional(),
+<%_ } -%>
+<%_ if (communication === 'Kafka') { -%>
+  KAFKA_BROKER: z.string(),
+<%_ } -%>
+});
+
+const _env = envSchema.safeParse(process.env);
+
+if (!_env.success) {
+  logger.error('❌ Invalid environment variables:', _env.error.format());
+  process.exit(1);
+}
+
+const env = _env.data;
+
+module.exports = { env };

package/templates/clean-architecture/js/src/infrastructure/webserver/middlewares/error.middleware.js

@@ -2,7 +2,8 @@ const logger = require('../../log/logger');
 const { ApiError } = require('../../../errors/ApiError');
 const HTTP_STATUS = require('../../../utils/httpCodes');
 
-const errorMiddleware = (err, req, res, _) => {
+// eslint-disable-next-line no-unused-vars
+const errorMiddleware = (err, req, res, next) => {
   let error = err;
 
   if (!(error instanceof ApiError)) {

package/templates/clean-architecture/js/src/infrastructure/webserver/server.js.ejs

@@ -1,6 +1,5 @@
 const express = require('express');
 const cors = require('cors');
-require('dotenv').config();
 const logger = require('../log/logger');
 const morgan = require('morgan');
 const { errorMiddleware } = require('./middlewares/error.middleware');
@@ -19,7 +18,11 @@ const { typeDefs, resolvers } = require('../../interfaces/graphql');
 const { gqlContext } = require('../../interfaces/graphql/context');
 <%_ } -%>
 
-const startServer = async (port) => {
+const { env } = require('../config/env');
+
+const startServer = async () => {
+    // Determine port using the validated env
+    const port = env.PORT;
     const app = express();
 
     app.use(cors());

package/templates/clean-architecture/js/src/interfaces/graphql/resolvers/user.resolvers.js.ejs

@@ -12,7 +12,10 @@ const userResolvers = {
     createUser: async (_, { name, email }) => {
       return await userController.createUser({ name, email });
     }
-  }
+  }<%_ if (database === 'MongoDB') { -%>,
+  User: {
+    id: (parent) => parent.id || parent._id
+  }<%_ } %>
 };
 
 module.exports = { userResolvers };

package/templates/clean-architecture/ts/src/config/env.ts.ejs

@@ -0,0 +1,46 @@
+import dotenv from 'dotenv';
+import { z } from 'zod';
+import logger from '@/infrastructure/log/logger';
+
+if (process.env.NODE_ENV !== 'production') {
+  dotenv.config();
+}
+
+const envSchema = z.object({
+  NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),
+  PORT: z.string().transform(Number).default('3000'),
+<%_ if (database !== 'None') { -%>
+  DB_HOST: z.string(),
+<%_ if (database === 'MySQL') { -%>
+  DB_USER: z.string(),
+  DB_PASSWORD: z.string(),
+  DB_NAME: z.string(),
+  DB_PORT: z.string().transform(Number),
+<%_ } else if (database === 'PostgreSQL') { -%>
+  DB_USER: z.string(),
+  DB_PASSWORD: z.string(),
+  DB_NAME: z.string(),
+  DB_PORT: z.string().transform(Number),
+<%_ } else if (database === 'MongoDB') { -%>
+  DB_NAME: z.string(),
+  DB_PORT: z.string().transform(Number),
+<%_ } -%>
+<%_ } -%>
+<%_ if (caching === 'Redis') { -%>
+  REDIS_HOST: z.string(),
+  REDIS_PORT: z.string().transform(Number),
+  REDIS_PASSWORD: z.string().optional(),
+<%_ } -%>
+<%_ if (communication === 'Kafka') { -%>
+  KAFKA_BROKER: z.string(),
+<%_ } -%>
+});
+
+const _env = envSchema.safeParse(process.env);
+
+if (!_env.success) {
+  logger.error('❌ Invalid environment variables:', _env.error.format());
+  process.exit(1);
+}
+
+export const env = _env.data;

package/templates/clean-architecture/ts/src/index.ts.ejs

@@ -3,7 +3,6 @@ import cors from 'cors';
 import helmet from 'helmet';
 import hpp from 'hpp';
 import rateLimit from 'express-rate-limit';
-import dotenv from 'dotenv';
 import logger from '@/infrastructure/log/logger';
 import morgan from 'morgan';
 import { errorMiddleware } from '@/utils/error.middleware';
@@ -20,12 +19,12 @@ import { unwrapResolverError } from '@apollo/server/errors';
 import { ApiError } from '@/errors/ApiError';
 import { typeDefs, resolvers } from '@/interfaces/graphql';
 import { gqlContext, MyContext } from '@/interfaces/graphql/context';
-<% } -%>
+<%_ } -%>
 
-dotenv.config();
+import { env } from '@/config/env';
 
 const app = express();
-const port = process.env.PORT || 3000;
+const port = env.PORT;
 
 // Security Middleware
 <%_ if (communication === 'GraphQL') { -%>
@@ -96,15 +95,13 @@ const startServer = async () => {
     app.listen(port, () => {
         logger.info(`Server running on port ${port}`);
 <%_ if (communication === 'Kafka') { -%>
-        try {
-          const kafkaService = new KafkaService();
-          kafkaService.connect().then(() => {
-            logger.info('Kafka connected');
-            kafkaService.sendMessage('test-topic', 'Hello Kafka from Clean Arch TS!');
-          });
-        } catch (err) {
+        const kafkaService = new KafkaService();
+        kafkaService.connect().then(() => {
+          logger.info('Kafka connected');
+          kafkaService.sendMessage('test-topic', 'Hello Kafka from Clean Arch TS!');
+        }).catch(err => {
           logger.error('Failed to connect to Kafka:', err);
-        }
+        });
 <%_ } -%>
     });
 };

package/templates/clean-architecture/ts/src/interfaces/graphql/resolvers/user.resolvers.ts.ejs

@@ -14,5 +14,8 @@ export const userResolvers = {
       const user = await userController.createUser({ name, email });
       return user;
     }
-  }
+  }<%_ if (database === 'MongoDB') { -%>,
+  User: {
+    id: (parent: { id?: string; _id?: unknown }) => parent.id || parent._id
+  }<%_ } %>
 };

package/templates/clean-architecture/ts/src/utils/error.middleware.ts.ejs

@@ -3,7 +3,8 @@ import logger from '@/infrastructure/log/logger';
 import { ApiError } from '@/errors/ApiError';
 import { HTTP_STATUS } from '@/utils/httpCodes';
 
-export const errorMiddleware = (err: Error, req: Request, res: Response, _: unknown) => {
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export const errorMiddleware = (err: Error, req: Request, res: Response, next: unknown) => {
   let error = err;
 
   if (!(error instanceof ApiError)) {

package/templates/common/.env.example.ejs

@@ -19,7 +19,9 @@ DB_PASSWORD=root
 DB_NAME=<%= dbName %>
 <%_ } -%>
 <%_ if (database === 'MongoDB') { -%>
-DB_URI=mongodb://localhost:27017/<%= dbName %>
+DB_HOST=localhost
+DB_PORT=27017
+DB_NAME=<%= dbName %>
 <%_ } -%>
 <%_ } -%>
 

package/templates/common/README.md.ejs

@@ -183,6 +183,36 @@ docker run -p 3000:3000 <%= projectName %>
 ```
 <% } -%>
 
+## 🚀 PM2 Deployment (VPS/EC2)
+This project is pre-configured for direct deployment to a VPS/EC2 instance using **PM2** (via `ecosystem.config.js`).
+1. Install dependencies
+```bash
+npm install
+```
+2. **Start Infrastructure (DB, Redis, Kafka, etc.) in the background**
+*(This specifically starts the background services without running the application inside Docker, allowing PM2 to handle it).*
+```bash
+docker-compose up -d<% if (database !== 'None') { %> db<% } %><% if (caching === 'Redis') { %> redis<% } %><% if (communication === 'Kafka') { %> zookeeper kafka<% } %>
+```
+3. **Wait 5-10s** for the database to fully initialize.
+4. **Deploy the App using PM2 in Cluster Mode**
+```bash
+<% if (language === 'TypeScript') { %>npm run build
+<% } %>npm run deploy
+```
+5. **Check logs**
+```bash
+npx pm2 logs
+```
+6. Stop and remove the PM2 application
+```bash
+npx pm2 delete <%= projectName %>
+```
+7. Stop and remove the Docker infrastructure
+```bash
+docker-compose down
+```
+
 ## 🔒 Security Features
 -   **Helmet**: Sets secure HTTP headers.
 -   **CORS**: Configured for cross-origin requests.

package/templates/common/database/js/mongoose.js.ejs

@@ -8,7 +8,9 @@ logger = require('../log/logger');
 <% } %>
 const connectDB = async () => {
     const dbHost = process.env.DB_HOST || 'localhost';
-    const mongoURI = process.env.MONGO_URI || `mongodb://${dbHost}:27017/<%= dbName %>`;
+    const dbPort = process.env.DB_PORT || '27017';
+    const dbName = process.env.DB_NAME || '<%= dbName %>';
+    const mongoURI = process.env.MONGO_URI || `mongodb://${dbHost}:${dbPort}/${dbName}`;
     
     let retries = 5;
     while (retries) {

package/templates/common/database/ts/mongoose.ts.ejs

@@ -6,7 +6,9 @@ import logger from '@/infrastructure/log/logger';
 <% } %>
 const connectDB = async (): Promise<void> => {
     const dbHost = process.env.DB_HOST || 'localhost';
-    const mongoURI = process.env.MONGO_URI || `mongodb://${dbHost}:27017/<%= dbName %>`;
+    const dbPort = process.env.DB_PORT || '27017';
+    const dbName = process.env.DB_NAME || '<%= dbName %>';
+    const mongoURI = process.env.MONGO_URI || `mongodb://${dbHost}:${dbPort}/${dbName}`;
     
     let retries = 5;
     while (retries) {

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

@@ -28,10 +28,15 @@ services:
       - DB_USER=root
       - DB_PASSWORD=root
       - DB_NAME=<%= dbName %>
+      - DB_PORT=3306
 <%_ } -%><%_ if (database === 'PostgreSQL') { -%>
       - DB_USER=postgres
       - DB_PASSWORD=root
       - DB_NAME=<%= dbName %>
+      - DB_PORT=5432
+<%_ } -%><%_ if (database === 'MongoDB') { -%>
+      - DB_NAME=<%= dbName %>
+      - DB_PORT=27017
 <%_ } -%>
 <%_ } -%>
 <%_ } else { -%>
@@ -48,10 +53,15 @@ services:
       - DB_USER=root
       - DB_PASSWORD=root
       - DB_NAME=<%= dbName %>
+      - DB_PORT=3306
 <%_ } -%><%_ if (database === 'PostgreSQL') { -%>
       - DB_USER=postgres
       - DB_PASSWORD=root
       - DB_NAME=<%= dbName %>
+      - DB_PORT=5432
+<%_ } -%><%_ if (database === 'MongoDB') { -%>
+      - DB_NAME=<%= dbName %>
+      - DB_PORT=27017
 <%_ } -%>
 <%_ } -%>
 <%_ } -%>
@@ -89,7 +99,7 @@ services:
       - mongodb_data:/data/db
 
   mongo-migrate:
-    image: node:18-alpine
+    image: node:22-alpine
     working_dir: /app
     volumes:
       - .:/app

package/templates/common/ecosystem.config.js.ejs

@@ -0,0 +1,40 @@
+module.exports = {
+  apps: [{
+    name: "<%= projectName %>",
+    script: "<% if (language === 'TypeScript') { %>./dist/index.js<% } else { %>./src/index.js<% } %>", // Entry point
+    instances: "max",           // Run in Cluster Mode to utilize all CPUs (Note: On Windows, cluster mode may throw `spawn wmic ENOENT` errors due to missing WMIC in Windows 11. To fix, change instances to 1, or install wmic)
+    exec_mode: "cluster",
+    watch: false,               // Disable watch in production
+    max_memory_restart: "1G",
+    env_production: {
+      NODE_ENV: "production",
+      PORT: 3000,
+<%_ if (caching === 'Redis') { -%>
+      REDIS_HOST: "127.0.0.1",
+      REDIS_PORT: 6379,
+      REDIS_PASSWORD: "",
+<%_ } -%>
+<%_ if (communication === 'Kafka') { -%>
+      KAFKA_BROKER: "127.0.0.1:9092",
+      KAFKAJS_NO_PARTITIONER_WARNING: 1,
+<%_ } -%>
+<%_ if (database !== 'None') { -%>
+      DB_HOST: "127.0.0.1",
+<%_ if (database === 'MySQL') { -%>
+      DB_USER: "root",
+      DB_PASSWORD: "root",
+      DB_NAME: "<%= dbName %>",
+      DB_PORT: 3306
+<%_ } else if (database === 'PostgreSQL') { -%>
+      DB_USER: "postgres",
+      DB_PASSWORD: "root",
+      DB_NAME: "<%= dbName %>",
+      DB_PORT: 5432
+<%_ } else if (database === 'MongoDB') { -%>
+      DB_NAME: "<%= dbName %>",
+      DB_PORT: 27017
+<%_ } -%>
+<%_ } -%>
+    }
+  }]
+};

package/templates/common/package.json.ejs

@@ -7,6 +7,7 @@
     "start": "<% if (language === 'TypeScript') { %>node dist/index.js<% } else { %>node src/index.js<% } %>",
     "dev": "<% if (language === 'TypeScript') { %>nodemon --exec ts-node -r tsconfig-paths/register src/index.ts<% } else { %>nodemon src/index.js<% } %>"<% if (language === 'TypeScript') { %>,
     "build": "rimraf dist && tsc && tsc-alias<% if (viewEngine && viewEngine !== 'None') { %> && cpx \"src/views/**/*\" dist/views<% } %><% if (communication === 'REST APIs') { %> && cpx \"src/**/*.yml\" dist/<% } %>"<% } %>,
+    "deploy": "npx pm2 start ecosystem.config.js --env production",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "format": "prettier --write .",
@@ -20,6 +21,7 @@
   "dependencies": {
     "express": "^4.18.2",
     "dotenv": "^16.3.1",
+    "zod": "^3.22.4",
 <% if (database === 'MySQL') { %>    "mysql2": "^3.6.5",
     "sequelize": "^6.35.2",
 <% } -%>
@@ -81,7 +83,7 @@
     "lint-staged": "^15.4.3"<% if (language === 'TypeScript') { %>,
     "typescript-eslint": "^8.24.1",<%_ if (communication === 'REST APIs') { %>
     "@types/swagger-ui-express": "^4.1.6",
-    "@types/yamljs": "^0.2.34",<%_ } -%>
+    "@types/yamljs": "^0.2.34",<%_ } %>
     "jest": "^29.7.0",
     "ts-jest": "^29.2.5",
     "@types/jest": "^29.5.14",

package/templates/mvc/js/src/config/env.js.ejs

@@ -0,0 +1,46 @@
+const { z } = require('zod');
+const logger = require('../utils/logger');
+
+if (process.env.NODE_ENV !== 'production') {
+  require('dotenv').config();
+}
+const envSchema = z.object({
+  NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),
+  PORT: z.string().transform(Number).default('3000'),
+<%_ if (database !== 'None') { -%>
+  DB_HOST: z.string(),
+<%_ if (database === 'MySQL') { -%>
+  DB_USER: z.string(),
+  DB_PASSWORD: z.string(),
+  DB_NAME: z.string(),
+  DB_PORT: z.string().transform(Number),
+<%_ } else if (database === 'PostgreSQL') { -%>
+  DB_USER: z.string(),
+  DB_PASSWORD: z.string(),
+  DB_NAME: z.string(),
+  DB_PORT: z.string().transform(Number),
+<%_ } else if (database === 'MongoDB') { -%>
+  DB_NAME: z.string(),
+  DB_PORT: z.string().transform(Number),
+<%_ } -%>
+<%_ } -%>
+<%_ if (caching === 'Redis') { -%>
+  REDIS_HOST: z.string(),
+  REDIS_PORT: z.string().transform(Number),
+  REDIS_PASSWORD: z.string().optional(),
+<%_ } -%>
+<%_ if (communication === 'Kafka') { -%>
+  KAFKA_BROKER: z.string(),
+<%_ } -%>
+});
+
+const _env = envSchema.safeParse(process.env);
+
+if (!_env.success) {
+  logger.error('❌ Invalid environment variables:', _env.error.format());
+  process.exit(1);
+}
+
+const env = _env.data;
+
+module.exports = { env };

package/templates/mvc/js/src/errors/BadRequestError.js

@@ -1,5 +1,5 @@
 const { ApiError } = require('./ApiError');
-const { HTTP_STATUS } = require('../../utils/httpCodes');
+const { HTTP_STATUS } = require('../utils/httpCodes');
 
 class BadRequestError extends ApiError {
   constructor(message = 'Bad request') {

package/templates/mvc/js/src/errors/NotFoundError.js

@@ -1,5 +1,5 @@
 const { ApiError } = require('./ApiError');
-const { HTTP_STATUS } = require('../../utils/httpCodes');
+const { HTTP_STATUS } = require('../utils/httpCodes');
 
 class NotFoundError extends ApiError {
   constructor(message = 'Resource not found') {

package/templates/mvc/js/src/graphql/resolvers/user.resolvers.js.ejs

@@ -10,7 +10,10 @@ const userResolvers = {
     createUser: async (_, { name, email }) => {
       return await userController.createUser({ name, email });
     }
-  }
+  }<%_ if (database === 'MongoDB') { -%>,
+  User: {
+    id: (parent) => parent.id || parent._id
+  }<%_ } %>
 };
 
 module.exports = { userResolvers };

package/templates/mvc/js/src/index.js.ejs

@@ -1,6 +1,5 @@
 const express = require('express');
 const cors = require('cors');
-require('dotenv').config();
 <%_ if (communication === 'REST APIs') { -%>const apiRoutes = require('./routes/api');<%_ } -%>
 <%_ if (communication === 'Kafka') { -%>const { connectKafka, sendMessage } = require('./services/kafkaService');<%_ } -%>
 <%_ if (communication === 'GraphQL') { -%>
@@ -16,9 +15,10 @@ const { gqlContext } = require('./graphql/context');
 const swaggerUi = require('swagger-ui-express');
 const swaggerSpecs = require('./config/swagger');
 <%_ } -%>
+const { env } = require('./config/env');
 
 const app = express();
-const PORT = process.env.PORT || 3000;
+const PORT = env.PORT;
 const logger = require('./utils/logger');
 const morgan = require('morgan');
 const { errorMiddleware } = require('./utils/error.middleware');

package/templates/mvc/js/src/utils/error.middleware.js

@@ -2,7 +2,8 @@ const logger = require('./logger');
 const { ApiError } = require('../errors/ApiError');
 const HTTP_STATUS = require('./httpCodes');
 
-const errorMiddleware = (err, req, res, _) => {
+// eslint-disable-next-line no-unused-vars
+const errorMiddleware = (err, req, res, next) => {
   let error = err;
 
   if (!(error instanceof ApiError)) {

package/templates/mvc/ts/src/config/env.ts.ejs

@@ -0,0 +1,45 @@
+import dotenv from 'dotenv';
+import { z } from 'zod';
+import logger from '@/utils/logger';
+
+if (process.env.NODE_ENV !== 'production') {
+  dotenv.config();
+}
+const envSchema = z.object({
+  NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),
+  PORT: z.string().transform(Number).default('3000'),
+<%_ if (database !== 'None') { -%>
+  DB_HOST: z.string(),
+<%_ if (database === 'MySQL') { -%>
+  DB_USER: z.string(),
+  DB_PASSWORD: z.string(),
+  DB_NAME: z.string(),
+  DB_PORT: z.string().transform(Number),
+<%_ } else if (database === 'PostgreSQL') { -%>
+  DB_USER: z.string(),
+  DB_PASSWORD: z.string(),
+  DB_NAME: z.string(),
+  DB_PORT: z.string().transform(Number),
+<%_ } else if (database === 'MongoDB') { -%>
+  DB_NAME: z.string(),
+  DB_PORT: z.string().transform(Number),
+<%_ } -%>
+<%_ } -%>
+<%_ if (caching === 'Redis') { -%>
+  REDIS_HOST: z.string(),
+  REDIS_PORT: z.string().transform(Number),
+  REDIS_PASSWORD: z.string().optional(),
+<%_ } -%>
+<%_ if (communication === 'Kafka') { -%>
+  KAFKA_BROKER: z.string(),
+<%_ } -%>
+});
+
+const _env = envSchema.safeParse(process.env);
+
+if (!_env.success) {
+  logger.error('❌ Invalid environment variables:', _env.error.format());
+  process.exit(1);
+}
+
+export const env = _env.data;