nodejs-quickstart-structure 1.14.0 → 1.16.0

package/CHANGELOG.md

@@ -5,6 +5,38 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.16.0] - 2026-03-14
+
+### Added
+- **Robust Kafka Singleton Implementation**: Refactored `KafkaService` to a strict singleton pattern across all architectures with `connectionPromise` and automated retry logic for resilient messaging.
+- **BaseConsumer Standards**: Implemented constructor guards in `BaseConsumer` to prevent direct instantiation of abstract messaging classes.
+- **Professional Docker Log Hygiene**: Added `NPM_CONFIG_UPDATE_NOTIFIER=false` to both builder and production stages to suppress non-essential npm upgrade notifications.
+
+### Fixed
+- **Docker Build & Type Safety**: Resolved a critical build failure in MVC TypeScript projects using EJS/Pug by addressing missing Express `Request` and `Response` type imports.
+- **Network Resilience**: Removed redundant `npm install -g npm@latest` from the `Dockerfile` template to fix `ECONNRESET` failures during project verification on unstable networks.
+- **Controller Testing Modernization**: Refactored `userController` spec templates (TS and JS) to correctly mock and verify the shared Kafka singleton, fixing persistent unit test failures.
+- **Database Mocking Refinement**: Resolved a data flow bug in the "None" database mock where generated IDs were being overwritten, and enhanced TypeScript types to eliminate `any` in repository patterns.
+
+## [1.15.1] - 2026-03-12
+
+### Added
+- **Magic AI Scaffolding**: Automated AI context generation ( `.cursorrules`, `prompts/`) by intelligently inferring project goals from the project name, removing the need for manual business domain prompts.
+- **Enhanced README**: Added specialized guidance for AI-native development with Cursor and LLMs.
+
+### Fixed
+- **GitHub Actions Compliance**: Fully resolved Node.js 20 deprecation warnings by moving `FORCE_JAVASCRIPT_ACTIONS_TO_NODE24` to global workflow scope.
+- **CI Modernization**: Upgraded daily audit and GitLab CI runners to Node.js 22.
+- **CI Enforcement**: Updated all CI/CD templates (GitHub, GitLab, Jenkins) to strictly enforce the >70% test coverage gate.
+
+## [1.15.0] - 2026-03-12
+### Added
+- **AI-Native Scaffolding & Agent Skill Templates:**
+  - Added a new CLI prompt for `businessDomain` to inject custom domain knowledge into generated templates.
+  - Generates a `.cursorrules` file at the root to enforce >70% Test coverage and Architecture patterns automatically for AI Code Editors.
+  - Scaffolds a `prompts/` directory with specialized Agent Skill templates (`project-context.md`, `add-feature.md`, `troubleshoot.md`) designed to provide deep structural understanding to LLMs like ChatGPT or Claude.
+  - Added an "AI-Native Development" section to the generated `README.md` and prominent print messages in the CLI upon successful completion.
+
 ## [1.14.0] - 2026-03-09
 ### Added
 - **Unit test:**

package/bin/index.js

@@ -1,81 +1,85 @@
 #!/usr/bin/env node
-
-import { Command } from 'commander';
-import chalk from 'chalk';
-import { getProjectDetails } from '../lib/prompts.js';
-import { generateProject } from '../lib/generator.js';
-import { readFileSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const pkg = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
-
-const program = new Command();
-
-program
-    .name('nodejs-quickstart')
-    .description('🚀 CLI to scaffold production-ready Node.js microservices.\n\nGenerates projects with:\n- MVC or Clean Architecture\n- REST or Kafka\n- MySQL, PostgreSQL, or MongoDB\n- Docker, Flyway & Mongoose support')
-    .version(pkg.version, '-v, --version', 'Output the current version')
-    .addHelpText('after', `
-\n${chalk.yellow('Example:')}
-  $ nodejs-quickstart init   ${chalk.gray('# Start the interactive setup')}
-`);
-
-program
-    .command('init')
-    .description('Initialize a new Node.js project')
-    .option('-n, --project-name <name>', 'Project name')
-    .option('-l, --language <language>', 'Language (JavaScript, TypeScript)')
-    .option('-a, --architecture <architecture>', 'Architecture (MVC, Clean Architecture)')
-    .option('--view-engine <view>', 'View Engine (None, EJS, Pug) - MVC only')
-    .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)')
-    .option('--caching <type>', 'Caching Layer (None/Redis)')
-    .action(async (options) => {
-        // Fix for Commander camelCase conversion
-        if (options.ciProvider) {
-            options.ciProvider = options.ciProvider;
-        }
-
-        console.log(chalk.blue('Welcome to the Node.js Quickstart Generator!'));
-
-        try {
-            const answers = await getProjectDetails(options);
-            console.log(chalk.green('\nConfiguration received:'));
-            console.log(JSON.stringify(answers, null, 2));
-
-            console.log(chalk.yellow('\nGenerating project...'));
-            await generateProject(answers);
-
-            console.log(chalk.green('\n✔ Project generated successfully!'));
-            
-            let manualStartInstructions = `\n${chalk.yellow('Development:')}\n  cd ${answers.projectName}\n  npm install`;
-            
-            const needsInfrastructure = answers.database !== 'None' || answers.caching === 'Redis' || answers.communication === 'Kafka';
-            
-            if (needsInfrastructure) {
-                let servicesToStart = '';
-                if (answers.database !== 'None') servicesToStart += ' db';
-                if (answers.caching === 'Redis') servicesToStart += ' redis';
-                if (answers.communication === 'Kafka') servicesToStart += ' zookeeper kafka';
-                
-                manualStartInstructions += `\n  docker-compose up -d${servicesToStart}  # Start infrastructure first\n  npm run dev`;
-            } else {
-                manualStartInstructions += `\n  npm run dev`;
-            }
-            
-            console.log(chalk.cyan(`\nNext steps:\n  cd ${answers.projectName}\n  npm install\n  docker-compose up\n-----------------------${manualStartInstructions}\n\n${chalk.yellow('Production (PM2):')}\n  npm run build\n  npm run deploy\n  npx pm2 logs`));
-
-        } catch (error) {
-            console.error(chalk.red('Error generating project:'), error);
-            process.exit(1);
-        }
-    });
-program.parse(process.argv);
-
-if (!process.argv.slice(2).length) {
-    program.outputHelp();
-}
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { getProjectDetails } from '../lib/prompts.js';
+import { generateProject } from '../lib/generator.js';
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
+
+const program = new Command();
+
+program
+    .name('nodejs-quickstart')
+    .description('🚀 CLI to scaffold production-ready Node.js microservices.\n\nGenerates projects with:\n- MVC or Clean Architecture\n- REST or Kafka\n- MySQL, PostgreSQL, or MongoDB\n- Docker, Flyway & Mongoose support')
+    .version(pkg.version, '-v, --version', 'Output the current version')
+    .addHelpText('after', `\n${chalk.yellow('Example:')}\n  $ nodejs-quickstart init   ${chalk.gray('# Start the interactive setup')}\n`);
+
+program
+    .command('init')
+    .description('Initialize a new Node.js project')
+    .option('-n, --project-name <name>', 'Project name')
+    .option('-l, --language <language>', 'Language (JavaScript, TypeScript)')
+    .option('-a, --architecture <architecture>', 'Architecture (MVC, Clean Architecture)')
+    .option('--view-engine <view>', 'View Engine (None, EJS, Pug) - MVC only')
+    .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)')
+    .option('--caching <type>', 'Caching Layer (None/Redis)')
+    .action(async (options) => {
+        // Fix for Commander camelCase conversion
+        if (options.ciProvider) {
+            options.ciProvider = options.ciProvider;
+        }
+
+        console.log(chalk.blue('Welcome to the Node.js Quickstart Generator!'));
+
+        try {
+            const answers = await getProjectDetails(options);
+            console.log(chalk.green('\nConfiguration received:'));
+            console.log(JSON.stringify(answers, null, 2));
+
+            console.log(chalk.yellow('\nGenerating project...'));
+            await generateProject(answers);
+
+            console.log(chalk.green('\n✔ Project generated successfully!'));
+            
+            console.log(chalk.magenta('\n🚀 Project is AI-Ready!'));
+            console.log(chalk.magenta('-----------------------------------------'));
+            console.log(chalk.magenta('🤖 We detected you are using AI tools.'));
+            console.log(chalk.magenta(`📍 Use Cursor? We've configured '.cursorrules' for you.`));
+            console.log(chalk.magenta(`📍 Use ChatGPT/Gemini? Check the 'prompts/' folder for Agent Skills.`));
+            console.log(chalk.magenta('-----------------------------------------'));
+
+            let manualStartInstructions = `\n${chalk.yellow('Development:')}\n  cd ${answers.projectName}\n  npm install`;
+            
+            const needsInfrastructure = answers.database !== 'None' || answers.caching === 'Redis' || answers.communication === 'Kafka';
+            
+            if (needsInfrastructure) {
+                let servicesToStart = '';
+                if (answers.database !== 'None') servicesToStart += ' db';
+                if (answers.caching === 'Redis') servicesToStart += ' redis';
+                if (answers.communication === 'Kafka') servicesToStart += ' zookeeper kafka';
+                
+                manualStartInstructions += `\n  docker-compose up -d${servicesToStart}  # Start infrastructure first\n  npm run dev`;
+            } else {
+                manualStartInstructions += `\n  npm run dev`;
+            }
+            
+            console.log(chalk.cyan(`\nNext steps:\n  cd ${answers.projectName}\n  npm install\n  docker-compose up\n-----------------------${manualStartInstructions}\n\n${chalk.yellow('Production (PM2):')}\n  npm run build\n  npm run deploy\n  npx pm2 logs`));
+
+        } catch (error) {
+            console.error(chalk.red('Error generating project:'), error);
+            process.exit(1);
+        }
+    });
+program.parse(process.argv);
+
+if (!process.argv.slice(2).length) {
+    program.outputHelp();
+}

package/lib/generator.js

@@ -1,7 +1,7 @@
 import path from 'path';
 import { fileURLToPath } from 'url';
 import { setupProjectDirectory, copyBaseStructure, copyCommonFiles } from './modules/project-setup.js';
-import { renderPackageJson, renderDockerCompose, renderReadme, renderDockerfile, renderProfessionalConfig, setupCiCd, renderTestSample, renderEnvExample, renderPm2Config } from './modules/config-files.js';
+import { renderPackageJson, renderDockerCompose, renderReadme, renderDockerfile, renderProfessionalConfig, setupCiCd, renderTestSample, renderEnvExample, renderPm2Config, renderAiNativeFiles } from './modules/config-files.js';
 import { renderIndexFile, renderEnvConfig, renderErrorMiddleware, renderDynamicComponents, renderSwaggerConfig, setupViews as setupSrcViews, processAllTests } from './modules/app-setup.js';
 import { setupDatabase } from './modules/database-setup.js';
 import { setupKafka, setupViews } from './modules/kafka-setup.js';
@@ -81,6 +81,9 @@ export const generateProject = async (config) => {
     await renderProfessionalConfig(templatesDir, targetDir, config);
     await renderTestSample(templatesDir, targetDir, config);
 
+    // 13.5 AI-Native Scaffolding
+    await renderAiNativeFiles(templatesDir, targetDir, config);
+
     // 14. CI/CD
     await setupCiCd(templatesDir, targetDir, config);
 
@@ -114,6 +117,13 @@ export const generateProject = async (config) => {
       ✅  Docker: Production-ready multi-stage build
       ${config.ciProvider !== 'None' ? `✅  CI/CD: ${config.ciProvider} Workflow ready` : '❌  CI/CD: Skipped (User preferred)'}
 
+      ----------------------------------------------------
+      🚀  Project is AI-Ready!
+      ----------------------------------------------------
+      🤖  We detected you are using AI tools. 
+      📍  Use Cursor? We've configured '.cursorrules' for you.
+      📍  Use ChatGPT/Gemini? Check the 'prompts/' folder for Agent Skills.
+
       ----------------------------------------------------
       👉  Next Steps:
       ----------------------------------------------------

package/lib/modules/app-setup.js

@@ -165,8 +165,8 @@ export const renderDynamicComponents = async (templatePath, targetDir, config) =
         }
     }
 
-    // Cleanup REST routes if GraphQL or Kafka is selected
-    if (config.communication !== 'REST APIs') {
+    // Cleanup REST routes if neither REST APIs nor Kafka is selected
+    if (config.communication !== 'REST APIs' && config.communication !== 'Kafka') {
         if (architecture === 'MVC') {
             await fs.remove(path.join(targetDir, 'src/routes'));
         } else if (architecture === 'Clean Architecture') {
@@ -280,7 +280,7 @@ export const renderSwaggerConfig = async (templatesDir, targetDir, config) => {
     }
     await fs.ensureDir(configDir);
 
-    if (communication === 'REST APIs') {
+    if (communication === 'REST APIs' || communication === 'Kafka') {
         const swaggerYmlTemplateSource = path.join(templatesDir, 'common', 'swagger.yml.ejs');
         if (await fs.pathExists(swaggerYmlTemplateSource)) {
             const ymlContent = ejs.render(await fs.readFile(swaggerYmlTemplateSource, 'utf-8'), { projectName });

package/lib/modules/config-files.js

@@ -49,6 +49,31 @@ export const renderProfessionalConfig = async (templatesDir, targetDir, config)
     await fs.writeFile(path.join(targetDir, 'jest.config.js'), jestContent);
 };
 
+export const renderAiNativeFiles = async (templatesDir, targetDir, config) => {
+    // 1. .cursorrules
+    const cursorRulesPath = path.join(targetDir, '.cursorrules');
+    const cursorRulesTemplate = await fs.readFile(path.join(templatesDir, 'common', '.cursorrules.ejs'), 'utf-8');
+    const cursorRulesContent = ejs.render(cursorRulesTemplate, { ...config });
+    await fs.writeFile(cursorRulesPath, cursorRulesContent);
+
+    // 2. prompts/
+    const promptsDirTarget = path.join(targetDir, 'prompts');
+    await fs.ensureDir(promptsDirTarget);
+    
+    const promptsSourceDir = path.join(templatesDir, 'common', 'prompts');
+    const promptFiles = await fs.readdir(promptsSourceDir);
+    
+    for (const file of promptFiles) {
+        if (file.endsWith('.ejs')) {
+            const templatePath = path.join(promptsSourceDir, file);
+            const targetFilePath = path.join(promptsDirTarget, file.replace('.ejs', ''));
+            const templateContent = await fs.readFile(templatePath, 'utf-8');
+            const renderedContent = ejs.render(templateContent, { ...config });
+            await fs.writeFile(targetFilePath, renderedContent);
+        }
+    }
+};
+
 export const setupCiCd = async (templatesDir, targetDir, config) => {
     const { ciProvider } = config;
     if (ciProvider === 'GitHub Actions') {
@@ -72,10 +97,10 @@ export const renderTestSample = async (templatesDir, targetDir, config) => {
             "extends": "../tsconfig.json",
             "compilerOptions": {
                 "types": ["jest", "node"],
-                "rootDir": "../tests",
+                "rootDir": "..",
                 "noEmit": true
             },
-            "include": ["**/*.ts"]
+            "include": ["**/*.ts", "../src/**/*.ts"]
         };
         await fs.writeFile(path.join(targetDir, 'tests', 'tsconfig.json'), JSON.stringify(testsTsConfig, null, 4));
     }

package/lib/modules/kafka-setup.js

@@ -8,7 +8,14 @@ export const setupKafka = async (templatesDir, targetDir, config) => {
 
     const langExt = language === 'TypeScript' ? 'ts' : 'js';
     const kafkaSource = path.join(templatesDir, 'common', 'kafka', langExt);
-    await fs.copy(kafkaSource, path.join(targetDir, 'src'));
+    
+    // 1. Copy necessary directories individually (to avoid orphaned templates in src)
+    if (await fs.pathExists(path.join(kafkaSource, 'services'))) {
+        await fs.copy(path.join(kafkaSource, 'services'), path.join(targetDir, 'src/services'));
+    }
+    if (await fs.pathExists(path.join(kafkaSource, 'config'))) {
+        await fs.copy(path.join(kafkaSource, 'config'), path.join(targetDir, 'src/config'));
+    }
 
     // Render Kafka Service with dynamic logger path
     const kafkaServiceFileName = `kafkaService.${langExt}`;
@@ -16,7 +23,7 @@ export const setupKafka = async (templatesDir, targetDir, config) => {
     // Render Kafka Service Spec
     const kafkaSpecFileName = `kafkaService.spec.${langExt}`;
     const kafkaSpecTemplate = path.join(targetDir, 'src', 'services', `${kafkaSpecFileName}.ejs`);
-
+   
     if (await fs.pathExists(kafkaServiceTemplate)) {
         let serviceLoggerPath, serviceConfigPath;
         if (language === 'TypeScript') {
@@ -39,10 +46,9 @@ export const setupKafka = async (templatesDir, targetDir, config) => {
             specConfigPath = architecture === 'Clean Architecture' ? '@/infrastructure/config/kafka' : '@/config/kafka';
             specServicePath = architecture === 'Clean Architecture' ? '@/infrastructure/messaging/kafkaClient' : '@/services/kafkaService';
         } else {
-            // For JS tests, we use @/ to ensure resolution after move to tests/
-            specLoggerPath = architecture === 'Clean Architecture' ? '@/infrastructure/log/logger' : '@/utils/logger';
-            specConfigPath = architecture === 'Clean Architecture' ? '@/infrastructure/config/kafka' : '@/config/kafka';
-            specServicePath = architecture === 'Clean Architecture' ? '@/infrastructure/messaging/kafkaClient' : '@/services/kafkaService';
+            specLoggerPath = architecture === 'Clean Architecture' ? '../../infrastructure/log/logger' : '../utils/logger';
+            specConfigPath = architecture === 'Clean Architecture' ? '../../infrastructure/config/kafka' : '../config/kafka';
+            specServicePath = architecture === 'Clean Architecture' ? '../../infrastructure/messaging/kafkaClient' : '../services/kafkaService';
         }
 
         const specContent = ejs.render(await fs.readFile(kafkaSpecTemplate, 'utf-8'), { ...config, loggerPath: specLoggerPath, configPath: specConfigPath, servicePath: specServicePath });
@@ -64,7 +70,6 @@ export const setupKafka = async (templatesDir, targetDir, config) => {
         await fs.ensureDir(path.dirname(specTarget));
         await fs.writeFile(specTarget, specContent);
         
-        // Remove the template from src in targetDir to avoid double processing by processAllTests
         const targetSpecTemplate = path.join(targetDir, 'src', 'config', `${kafkaConfigSpecFileName}.ejs`);
         if (await fs.pathExists(targetSpecTemplate)) {
             await fs.remove(targetSpecTemplate);
@@ -79,14 +84,12 @@ export const setupKafka = async (templatesDir, targetDir, config) => {
 
         const serviceExt = language === 'TypeScript' ? 'ts' : 'js';
         
-        // Move Service to Infrastructure/Messaging
         await fs.move(
             path.join(targetDir, `src/services/kafkaService.${serviceExt}`), 
             path.join(targetDir, `src/infrastructure/messaging/kafkaClient.${serviceExt}`),
             { overwrite: true }
         );
 
-        // Move Spec to Tests/Infrastructure/Messaging
         if (await fs.pathExists(path.join(targetDir, `src/services/kafkaService.spec.${serviceExt}`))) {
             await fs.move(
                 path.join(targetDir, `src/services/kafkaService.spec.${serviceExt}`),
@@ -95,8 +98,6 @@ export const setupKafka = async (templatesDir, targetDir, config) => {
             );
         }
 
-        // Move Config to Infrastructure/Config
-        // Note: Check if config path exists before moving, though copy above should have put it there
         if (await fs.pathExists(path.join(targetDir, `src/config/kafka.${serviceExt}`))) {
             await fs.move(
                 path.join(targetDir, `src/config/kafka.${serviceExt}`),
@@ -105,18 +106,68 @@ export const setupKafka = async (templatesDir, targetDir, config) => {
             );
         }
 
-        // Cleanup old services folder
         await fs.remove(path.join(targetDir, 'src/services'));
+
+        // Messaging Infrastructure Enhancement
+        const messagingDir = path.join(targetDir, 'src/interfaces/messaging');
+        await fs.ensureDir(path.join(messagingDir, 'consumers/instances'));
+        await fs.ensureDir(path.join(messagingDir, 'schemas'));
+
+        const loggerPath = language === 'TypeScript' ? '@/infrastructure/log/logger' : '../../infrastructure/log/logger';
+        const messagingTemplates = [
+            { src: 'baseConsumer', dest: 'interfaces/messaging/baseConsumer' },
+            { src: 'userEventSchema', dest: 'interfaces/messaging/schemas/userEventSchema' },
+            { src: 'welcomeEmailConsumer', dest: 'interfaces/messaging/consumers/instances/welcomeEmailConsumer' }
+        ];
+
+        for (const t of messagingTemplates) {
+            const templateSource = path.join(templatesDir, 'common', 'kafka', langExt, 'messaging', `${t.src}.${langExt}.ejs`);
+            if (await fs.pathExists(templateSource)) {
+                const content = ejs.render(await fs.readFile(templateSource, 'utf-8'), { ...config, loggerPath });
+                await fs.writeFile(path.join(targetDir, 'src', `${t.dest}.${langExt}`), content);
+            }
+
+            // Render Specs for messaging components
+            const specTemplateSource = path.join(templatesDir, 'common', 'kafka', langExt, 'messaging', `${t.src}.spec.${langExt}.ejs`);
+            if (await fs.pathExists(specTemplateSource)) {
+                const specContent = ejs.render(await fs.readFile(specTemplateSource, 'utf-8'), { ...config, loggerPath });
+                const specDest = path.join(targetDir, 'tests', `${t.dest}.spec.${langExt}`);
+                await fs.ensureDir(path.dirname(specDest));
+                await fs.writeFile(specDest, specContent);
+            }
+        }
         
-        // Remove REST-specific folders (Interfaces) - Note: routes is kept for health endpoint
-        await fs.remove(path.join(targetDir, 'src/interfaces/controllers'));
-        await fs.remove(path.join(targetDir, 'tests/interfaces/controllers'));
-        
-        // 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') {
         const serviceExt = language === 'TypeScript' ? 'ts' : 'js';
-        // Move Spec to Tests/Services
+        
+        const messagingDir = path.join(targetDir, 'src/messaging');
+        await fs.ensureDir(path.join(messagingDir, 'consumers/instances'));
+        await fs.ensureDir(path.join(messagingDir, 'schemas'));
+
+        const loggerPath = language === 'TypeScript' ? '@/utils/logger' : '../utils/logger';
+        const messagingTemplates = [
+            { src: 'baseConsumer', dest: 'messaging/baseConsumer' },
+            { src: 'userEventSchema', dest: 'messaging/schemas/userEventSchema' },
+            { src: 'welcomeEmailConsumer', dest: 'messaging/consumers/instances/welcomeEmailConsumer' }
+        ];
+
+        for (const t of messagingTemplates) {
+            const templateSource = path.join(templatesDir, 'common', 'kafka', langExt, 'messaging', `${t.src}.${langExt}.ejs`);
+            if (await fs.pathExists(templateSource)) {
+                const content = ejs.render(await fs.readFile(templateSource, 'utf-8'), { ...config, loggerPath });
+                await fs.writeFile(path.join(targetDir, 'src', `${t.dest}.${langExt}`), content);
+            }
+
+            // Render Specs for messaging components
+            const specTemplateSource = path.join(templatesDir, 'common', 'kafka', langExt, 'messaging', `${t.src}.spec.${langExt}.ejs`);
+            if (await fs.pathExists(specTemplateSource)) {
+                const specContent = ejs.render(await fs.readFile(specTemplateSource, 'utf-8'), { ...config, loggerPath });
+                const specDest = path.join(targetDir, 'tests', `${t.dest}.spec.${langExt}`);
+                await fs.ensureDir(path.dirname(specDest));
+                await fs.writeFile(specDest, specContent);
+            }
+        }
+
         if (await fs.pathExists(path.join(targetDir, `src/services/kafkaService.spec.${serviceExt}`))) {
             await fs.ensureDir(path.join(targetDir, 'tests/services'));
             await fs.move(
@@ -126,11 +177,6 @@ export const setupKafka = async (templatesDir, targetDir, config) => {
             );
         }
 
-        if (!config.viewEngine || config.viewEngine === 'None') {
-            // MVC Cleanup for Kafka Worker (No views) - Note: routes is kept for health endpoint
-            await fs.remove(path.join(targetDir, 'src/controllers'));
-            await fs.remove(path.join(targetDir, 'tests/controllers'));
-        }
     }
 };
 

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "nodejs-quickstart-structure",
-  "version": "1.14.0",
+  "version": "1.16.0",
   "type": "module",
-  "description": "A CLI to scaffold Node.js microservices with MVC or Clean Architecture",
+  "description": "The ultimate nodejs quickstart structure CLI to scaffold Node.js microservices with MVC or Clean Architecture",
   "main": "bin/index.js",
   "bin": {
     "nodejs-quickstart": "./bin/index.js"
@@ -16,12 +16,17 @@
   },
   "keywords": [
     "nodejs",
+    "node",
+    "quickstart",
+    "structure",
     "cli",
     "scaffold",
     "mvc",
     "clean-architecture",
     "microservices",
-    "backend"
+    "backend",
+    "generator",
+    "boilerplate"
   ],
   "author": "Pau Dang <[EMAIL_ADDRESS]>",
   "repository": {

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

@@ -1,7 +1,7 @@
 const startServer = require('./infrastructure/webserver/server');
 const logger = require('./infrastructure/log/logger');
 <% if (communication === 'Kafka') { -%>
-const { connectKafka, sendMessage } = require('./infrastructure/messaging/kafkaClient');
+const { connectKafka } = require('./infrastructure/messaging/kafkaClient');
 <% } -%>
 
 <%_ if (database !== 'None') { -%>
@@ -24,7 +24,6 @@ const syncDatabase = async () => {
             // Connect Kafka
             connectKafka().then(async () => {
               logger.info('Kafka connected');
-              await sendMessage('test-topic', 'Hello Kafka from Clean Arch JS!');
             }).catch(err => {
               logger.error('Failed to connect to Kafka:', err);
             });
@@ -45,7 +44,6 @@ startServer();
 // Connect Kafka
 connectKafka().then(async () => {
   logger.info('Kafka connected');
-  await sendMessage('test-topic', 'Hello Kafka from Clean Arch JS!');
 }).catch(err => {
   logger.error('Failed to connect to Kafka:', err);
 });

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

@@ -4,7 +4,7 @@ const logger = require('../log/logger');
 const morgan = require('morgan');
 const { errorMiddleware } = require('./middleware/errorMiddleware');
 const healthRoutes = require('../../interfaces/routes/healthRoute');
-<%_ if (communication === 'REST APIs') { -%>
+<%_ if (communication === 'REST APIs' || communication === 'Kafka') { -%>
 const apiRoutes = require('../../interfaces/routes/api');
 const swaggerUi = require('swagger-ui-express');
 const swaggerSpecs = require('./swagger');
@@ -29,10 +29,10 @@ const startServer = async () => {
     app.use(cors());
     app.use(express.json());
     app.use(morgan('combined', { stream: { write: message => logger.info(message.trim()) } }));
-    <%_ if (communication === 'REST APIs') { -%>
+    <%_ if (communication === 'REST APIs' || communication === 'Kafka') { -%>
     app.use('/api', apiRoutes);
     <%_ } -%>
-    <%_ if (communication === 'REST APIs') { -%>
+    <%_ if (communication === 'REST APIs' || communication === 'Kafka') { -%>
     app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerSpecs));
     <%_ } -%>
     <%_ if (communication === 'GraphQL') { -%>
@@ -71,13 +71,14 @@ const startServer = async () => {
     const server = app.listen(port, () => {
         logger.info(`Server running on port ${port}`);
 <%_ if (communication === 'Kafka') { -%>
-        const { connectKafka, sendMessage } = require('../../infrastructure/messaging/kafkaClient');
-        connectKafka().then(() => {
-          logger.info('Kafka connected');
-          sendMessage('test-topic', 'Hello Kafka from Clean Arch JS!');
-        }).catch(err => {
-          logger.error('Failed to connect to Kafka:', err);
-        });
+        const { connectKafka } = require('../../infrastructure/messaging/kafkaClient');
+        connectKafka()
+            .then(async () => {
+                logger.info('Kafka connected');
+            })
+            .catch(err => {
+                logger.error('Failed to connect to Kafka after retries:', err.message);
+            });
 <%_ } -%>
     });
 

package/templates/clean-architecture/js/src/interfaces/controllers/userController.js.ejs

@@ -26,7 +26,15 @@ class UserController {
     async createUser(data) {
         const { name, email } = data;
         try {
-            return await this.createUserUseCase.execute(name, email);
+            const user = await this.createUserUseCase.execute(name, email);
+<%_ if (communication === 'Kafka') { -%>
+            const { sendMessage } = require('../../infrastructure/messaging/kafkaClient');
+            await sendMessage('user-topic', JSON.stringify({
+                action: 'USER_CREATED',
+                payload: { id: user.id || user._id, email: user.email }
+            }));
+<%_ } -%>
+            return user;
         } catch (error) {
             logger.error('Error creating user:', error);
             throw error;
@@ -47,6 +55,13 @@ class UserController {
         const { name, email } = req.body;
         try {
             const user = await this.createUserUseCase.execute(name, email);
+<%_ if (communication === 'Kafka') { -%>
+            const { sendMessage } = require('../../infrastructure/messaging/kafkaClient');
+            await sendMessage('user-topic', JSON.stringify({
+                action: 'USER_CREATED',
+                payload: { id: user.id || user._id, email: user.email }
+            }));
+<%_ } -%>
             res.status(HTTP_STATUS.CREATED).json(user);
         } catch (error) {
             logger.error('Error creating user:', error);