nodejs-quickstart-structure 2.1.0 → 2.1.1

package/CHANGELOG.md

@@ -1,7 +1,18 @@
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
  
+## [2.1.1] - 2026-04-24
+
+### Fixed
+- **Template Security Hardening**: Resolved missing buffer bounds check vulnerability in `uuid` (GHSA-w5hq-g745-h8pq) by adding `"uuid": "^14.0.0"` to template `overrides`.
+- **Template Formatting**: Fixed an issue in `package.json.ejs` causing unexpected empty lines between generated dependencies.
+- **Unit Test Stability**: Resolved persistent `SyntaxError` and `TypeError` in Jest unit tests across all architecture permutations by implementing ESM-compatible transformation patterns for `uuid` and standardizing on `jest.clearAllMocks()` with factory mocks.
+
+### Changed
+- **Documentation Refinement**: Remade `README.md` and removed emojis for a cleaner, more professional, text-only presentation across the VitePress-based site.
+
 ## [2.1.0] - 2026-04-20
 
+
 ### Added
 - **Pluggable JWT Authentication**: Introduced a robust, production-ready authentication system.
   - Supports **Access & Refresh Token Rotation** for enhanced security.

package/README.md

@@ -6,41 +6,35 @@
 [![npm monthly downloads](https://img.shields.io/npm/dm/nodejs-quickstart-structure.svg?style=flat-square)](https://www.npmjs.com/package/nodejs-quickstart-structure)
 [![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg?style=flat-square)](https://opensource.org/licenses/ISC)
 
-### 📈 Real-world Adoption
-| **Metric** | **Insight** |
-| :--- | :--- |
-| 🔥 **4,000+** | Downloads on npm |
-| 🚀 **1,500+** | Recent GitHub Clones |
-| 🌍 **Trusted by** | Devs from **Google**, **Viblo**, and global tech teams |
 
 ---
 
 A powerful ecosystem to scaffold production-ready Node.js microservices with built-in best practices. Choose between **MVC** or **Clean Architecture**, **JavaScript** or **TypeScript**, and your preferred tech stack in seconds.
 
-## 📌 Table of Contents
+## Table of Contents
 
-- [🚀 Quick Start](#-choose-your-journey)
-- [🆕 What's New](#-whats-new-in-v21-the-authentication-release)
-- [✨ Key Features](#-key-features)
-- [🛡️ Professional Standards](#-professional-standards)
-- [🧩 5,280+ Project Combinations](#-5280-project-combinations)
-- [⚙️ Configuration Options](#-configuration-options)
-- [🏗️ Generated Project Structure](#-generated-project-structure)
-- [📖 Documentation](#-documentation)
-- [🗺️ Support & Roadmap](#️-roadmap--support)
+- [Quick Start](#choose-your-journey)
+- [What's New](#whats-new-in-v21-the-authentication-release)
+- [Key Features](#key-features)
+- [Professional Standards](#professional-standards)
+- [5,280+ Project Combinations](#5280-project-combinations)
+- [Configuration Options](#configuration-options)
+- [Generated Project Structure](#generated-project-structure)
+- [Documentation](#documentation)
+- [Support & Roadmap](#support--roadmap)
 
-## 🚀 Choose Your Journey
+## Choose Your Journey
  
-| **Path A: Next-Gen Web UI** (Recommended ⭐️) | **Path B: Interactive CLI** |
+| **Path A: Next-Gen Web UI** (Recommended) | **Path B: Interactive CLI** |
 | :--- | :--- |
 | <a href="https://paudang.github.io/nodejs-quickstart-structure/#configurator"><img src="docs/public/v2-preview.png" width="100%" alt="UI Preview"></a> | <img src="docs/demo.gif" width="100%" alt="CLI Demo"> |
-| [Try Visual Configurator →](https://paudang.github.io/nodejs-quickstart-structure/#configurator) | [See CLI Commands ↓](#-path-b-interactive-cli) |
-| ✨ **Visual Preview**: Real-time folder simulation. | ⚡ **Fast & Direct**: Quickly scaffold in terminal. |
-| 🛠️ **Zero-Prompt**: Paste a tailored command. | 🦾 **AI-Ready**: Generates `.cursorrules`. |
+| [Try Visual Configurator →](https://paudang.github.io/nodejs-quickstart-structure/#configurator) | [See CLI Commands ↓](#path-b-interactive-cli) |
+| **Visual Preview**: Real-time folder simulation. | **Fast & Direct**: Quickly scaffold in terminal. |
+| **Zero-Prompt**: Paste a tailored command. | **AI-Ready**: Generates `.cursorrules`. |
 
 ---
 
-### 🦾 Path B: Interactive CLI
+### Path B: Interactive CLI
 **Scaffold your project directly from your terminal in seconds.**
 
 ```bash
@@ -56,21 +50,21 @@ nodejs-quickstart init
 
 ---
 
-## 🆕 What's New in v2.1 (The Authentication Release)
+## What's New in v2.1 (The Authentication Release)
  
  The v2.1.0 release is a major leap forward, turning the generator into a **Community Standard**:
  
-- **🔐 Pluggable JWT Authentication**: Production-ready access & refresh token patterns with automatic PM2/Environment configuration.
-- **🦾 AI-Native Foundation**: Built-in `.cursorrules` optimized for **Cursor** & AI agents—projects are "Born to be Autonomously Coded."
-- **🖼️ Next-Gen Web UI**: A browser-based visual project simulator with real-time folder previews.
-- **🏗️ Enterprise Clean Architecture**: High-fidelity structure for professional Microservices (TS/JS).
-- **🛡️ Hardened Security**: Integrated Snyk & SonarCloud logic in core templates.
-- **⚡ Zero-Prompt Workflow**: Generate projects with a single CLI command.
+- **Pluggable JWT Authentication**: Production-ready access & refresh token patterns with automatic PM2/Environment configuration.
+- **AI-Native Foundation**: Built-in `.cursorrules` optimized for **Cursor** & AI agents—projects are "Born to be Autonomously Coded."
+- **Next-Gen Web UI**: A browser-based visual project simulator with real-time folder previews.
+- **Enterprise Clean Architecture**: High-fidelity structure for professional Microservices (TS/JS).
+- **Hardened Security**: Integrated Snyk & SonarCloud logic in core templates.
+- **Zero-Prompt Workflow**: Generate projects with a single CLI command.
 
 ---
 
 
-## ✨ Key Features
+## Key Features
 
 - **Interactive CLI**: Smooth, guided configuration process.
 - **Multiple Architectures**: Supports both **MVC** and **Clean Architecture**.
@@ -79,24 +73,24 @@ nodejs-quickstart init
 - **Communication Patterns**: Supports **REST**, **GraphQL** (Apollo), and **Kafka** (Event-driven).
 - **Multi-layer Caching**: Integrated **Redis** or built-in **Memory Cache**.
 - **Pluggable Authentication**: Built-in **JWT** support (Refresh/Access tokens).
-- **AI-Native Optimized**: specifically designed for **Cursor** and AI agents, including built-in `.cursorrules` and Agent Skill prompts. 🚀
+- **AI-Native Optimized**: specifically designed for **Cursor** and AI agents, including built-in `.cursorrules` and Agent Skill prompts.
 
 ---
 
-## 🛡️ Professional Standards
+## Professional Standards
 
 We don't just generate boilerplate; we generate **production-ready** foundations. Every project includes:
 
-- **🔍 Code Quality**: Pre-configured `Eslint` and `Prettier`.
-- **🛡️ 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**, **GitLab CI**, **CircleCI**, and **Bitbucket Pipelines**.
-- **🚀 Scalable Deployment**: Integrated **PM2 Ecosystem** config for zero-downtime reloads.
+- **Code Quality**: Pre-configured `Eslint` and `Prettier`.
+- **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**, **GitLab CI**, **CircleCI**, and **Bitbucket Pipelines**.
+- **Scalable Deployment**: Integrated **PM2 Ecosystem** config for zero-downtime reloads.
 
 ---
 
-## 🧩 5,280+ Project Combinations
+## 5,280+ Project Combinations
 
 The CLI supports a massive number of configurations to fit your exact needs:
 
@@ -110,7 +104,7 @@ The CLI supports a massive number of configurations to fit your exact needs:
 
 ---
 
-## ⚙️ Configuration Options
+## Configuration Options
 
 The CLI will guide you through:
 1. **Project Name**
@@ -126,7 +120,7 @@ The CLI will guide you through:
 
 ---
 
-## 🏗️ Generated Project Structure
+## Generated Project Structure
 Depending on your choices, the structure adapts. Here is a **TypeScript + Clean Architecture** preview:
 
 ```text
@@ -148,13 +142,13 @@ Depending on your choices, the structure adapts. Here is a **TypeScript + Clean
 
 ---
 
-## 📖 Documentation
+## Documentation
 
 For full guides, architecture deep-dives, and feature references, visit our **[Official Documentation Site](https://paudang.github.io/nodejs-quickstart-structure/guide/getting-started.html)**.
 
 ---
 
-## ❤️ Support & 🗺️ Roadmap
+## Support & Roadmap
 
 ### Support the Project
 If this tool helped you build your project faster, please support us:
@@ -163,11 +157,11 @@ If this tool helped you build your project faster, please support us:
 
 ### Roadmap
 Track our progress and vote for features on our public board:
-👉 **[View our Public Roadmap on Trello](https://trello.com/b/TPTo8ylF/nodejs-quickstart-structure-product)**
+**[View our Public Roadmap on Trello](https://trello.com/b/TPTo8ylF/nodejs-quickstart-structure-product)**
 
 ---
 
-## ⭐ Why Star us?
+## Why Star us?
 
 We are on a mission to build the best AI-Native Node.js scaffolding experience. Your star is not just a "like"—it's a vote of confidence that helps us:
 
@@ -175,7 +169,7 @@ We are on a mission to build the best AI-Native Node.js scaffolding experience.
 2. **AI Model Awareness**: Popular repositories are weighted higher by AI coding assistants (Cursor, Copilot, etc.), making the generated code even better.
 3. **Open Source Sustainability**: It motivates us to keep building and shipping "Enterprise-Grade" features for free.
 
-If this tool saved you hours of work, **[please give us a Star!](https://github.com/paudang/nodejs-quickstart-structure)** 🚀
+If this tool saved you hours of work, **[please give us a Star!](https://github.com/paudang/nodejs-quickstart-structure)**
 
 ---
 

package/lib/modules/config-files.js

@@ -53,6 +53,12 @@ export const renderProfessionalConfig = async (templatesDir, targetDir, config)
     const jestE2eContent = ejs.render(jestE2eTemplate, { ...config });
     await fs.writeFile(path.join(targetDir, 'jest.e2e.config.js'), jestE2eContent);
 
+    if (config.language === 'JavaScript') {
+        const babelTemplate = await fs.readFile(path.join(templatesDir, 'common', 'babel.config.js.ejs'), 'utf-8');
+        const babelContent = ejs.render(babelTemplate, { ...config });
+        await fs.writeFile(path.join(targetDir, 'babel.config.js'), babelContent);
+    }
+
     // 1. Setup Husky pre-commit (Always for Professional Standard)
     const huskyDir = path.join(targetDir, '.husky');
     await fs.ensureDir(huskyDir);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nodejs-quickstart-structure",
-  "version": "2.1.0",
+  "version": "2.1.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/clean-architecture/js/src/infrastructure/repositories/UserRepository.spec.js.ejs

@@ -1,7 +1,17 @@
 const UserRepository = require('@/infrastructure/repositories/UserRepository');
 const UserModel = require('@/infrastructure/database/models/User');
 
-jest.mock('@/infrastructure/database/models/User');
+jest.mock('@/infrastructure/database/models/User', () => ({
+    create: jest.fn(),
+    findAll: jest.fn(),
+    findByPk: jest.fn(),
+    update: jest.fn(),
+    destroy: jest.fn(),
+    find: jest.fn(),
+    findById: jest.fn(),
+    findByIdAndUpdate: jest.fn(),
+    findByIdAndDelete: jest.fn(),
+}));
 
 describe('UserRepository', () => {
     let userRepository;

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

@@ -28,6 +28,8 @@ jest.mock('express', () => {
 jest.mock('@/infrastructure/log/logger', () => ({
     info: jest.fn(),
     error: jest.fn(),
+    warn: jest.fn(),
+    debug: jest.fn(),
 }));
 
 jest.mock('@/utils/gracefulShutdown', () => jest.fn());

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

@@ -33,7 +33,7 @@ describe('UserController (Clean Architecture)', () => {
 <%_ } -%>
 
     beforeEach(() => {
-        jest.resetAllMocks();
+        jest.clearAllMocks();
 
         userController = new UserController();
 

package/templates/clean-architecture/js/src/interfaces/graphql/context.spec.js.ejs

@@ -1,10 +1,26 @@
-<% if (auth.includes('JWT')) { %>const JwtService = require('@/infrastructure/auth/jwtService');
-jest.mock('@/infrastructure/auth/jwtService');<% } %>
+<% if (auth.includes('JWT')) { %>
+const JwtService = require('@/infrastructure/auth/jwtService');
+jest.mock('@/infrastructure/auth/jwtService', () => ({
+    verifyToken: jest.fn(),
+    generateToken: jest.fn(),
+    generateRefreshToken: jest.fn(),
+    verifyRefreshToken: jest.fn(),
+    decodeToken: jest.fn(),
+}));
+<% } %>
 const { gqlContext } = require('@/interfaces/graphql/context');
 const { resolvers } = require('@/interfaces/graphql/index');
 const { typeDefs } = require('@/interfaces/graphql/typeDefs/index');
 
-jest.mock('@/infrastructure/repositories/UserRepository');
+jest.mock('@/infrastructure/repositories/UserRepository', () => {
+    return jest.fn().mockImplementation(() => ({
+        save: jest.fn(),
+        findById: jest.fn(),
+        getUsers: jest.fn(),
+        update: jest.fn(),
+        delete: jest.fn()
+    }));
+});
 
 describe('GraphQL Context', () => {
     afterEach(() => {

package/templates/clean-architecture/js/src/usecases/CreateUser.spec.js.ejs

@@ -4,7 +4,15 @@ const UserRepository = require('@/infrastructure/repositories/UserRepository');
 const cacheService = require('<% if (caching === "Redis") { %>@/infrastructure/caching/redisClient<% } else { %>@/infrastructure/caching/memoryCache<% } %>');
 <%_ } -%>
 
-jest.mock('@/infrastructure/repositories/UserRepository');
+jest.mock('@/infrastructure/repositories/UserRepository', () => {
+    return jest.fn().mockImplementation(() => ({
+        save: jest.fn(),
+        findById: jest.fn(),
+        getUsers: jest.fn(),
+        update: jest.fn(),
+        delete: jest.fn()
+    }));
+});
 <%_ if (caching !== 'None') { -%>
 jest.mock('<% if (caching === "Redis") { %>@/infrastructure/caching/redisClient<% } else { %>@/infrastructure/caching/memoryCache<% } %>', () => ({
     get: jest.fn(),

package/templates/clean-architecture/js/src/usecases/DeleteUser.spec.js.ejs

@@ -4,7 +4,15 @@ const UserRepository = require('@/infrastructure/repositories/UserRepository');
 const cacheService = require('<% if (caching === "Redis") { %>@/infrastructure/caching/redisClient<% } else { %>@/infrastructure/caching/memoryCache<% } %>');
 <%_ } -%>
 
-jest.mock('@/infrastructure/repositories/UserRepository');
+jest.mock('@/infrastructure/repositories/UserRepository', () => {
+    return jest.fn().mockImplementation(() => ({
+        save: jest.fn(),
+        findById: jest.fn(),
+        getUsers: jest.fn(),
+        update: jest.fn(),
+        delete: jest.fn()
+    }));
+});
 <%_ if (caching !== 'None') { -%>
 jest.mock('<% if (caching === "Redis") { %>@/infrastructure/caching/redisClient<% } else { %>@/infrastructure/caching/memoryCache<% } %>', () => ({
     get: jest.fn(),

package/templates/clean-architecture/js/src/usecases/GetAllUsers.spec.js.ejs

@@ -18,7 +18,15 @@ const UserRepository = require('@/infrastructure/repositories/UserRepository');
 const cacheService = require('<% if (caching === "Redis") { %>@/infrastructure/caching/redisClient<% } else { %>@/infrastructure/caching/memoryCache<% } %>');
 <%_ } -%>
 
-jest.mock('@/infrastructure/repositories/UserRepository');
+jest.mock('@/infrastructure/repositories/UserRepository', () => {
+    return jest.fn().mockImplementation(() => ({
+        save: jest.fn(),
+        findById: jest.fn(),
+        getUsers: jest.fn(),
+        update: jest.fn(),
+        delete: jest.fn()
+    }));
+});
 <%_ if (caching !== 'None') { -%>
 jest.mock('<% if (caching === "Redis") { %>@/infrastructure/caching/redisClient<% } else { %>@/infrastructure/caching/memoryCache<% } %>', () => ({
     get: jest.fn(),

package/templates/clean-architecture/js/src/usecases/UpdateUser.spec.js.ejs

@@ -4,7 +4,15 @@ const UserRepository = require('@/infrastructure/repositories/UserRepository');
 const cacheService = require('<% if (caching === "Redis") { %>@/infrastructure/caching/redisClient<% } else { %>@/infrastructure/caching/memoryCache<% } %>');
 <%_ } -%>
 
-jest.mock('@/infrastructure/repositories/UserRepository');
+jest.mock('@/infrastructure/repositories/UserRepository', () => {
+    return jest.fn().mockImplementation(() => ({
+        save: jest.fn(),
+        findById: jest.fn(),
+        getUsers: jest.fn(),
+        update: jest.fn(),
+        delete: jest.fn()
+    }));
+});
 <%_ if (caching !== 'None') { -%>
 jest.mock('<% if (caching === "Redis") { %>@/infrastructure/caching/redisClient<% } else { %>@/infrastructure/caching/memoryCache<% } %>', () => ({
     get: jest.fn(),

package/templates/clean-architecture/ts/src/infrastructure/repositories/UserRepository.spec.ts.ejs

@@ -2,7 +2,22 @@ import { UserRepository } from '@/infrastructure/repositories/UserRepository';
 import UserModel from '@/infrastructure/database/models/User';
 
 // Mock DB Model Database Layer
-jest.mock('@/infrastructure/database/models/User');
+jest.mock('@/infrastructure/database/models/User', () => {
+  return {
+    __esModule: true,
+    default: {
+      create: jest.fn(),
+      findAll: jest.fn(),
+      findByPk: jest.fn(),
+      update: jest.fn(),
+      destroy: jest.fn(),
+      find: jest.fn(),
+      findById: jest.fn(),
+      findByIdAndUpdate: jest.fn(),
+      findByIdAndDelete: jest.fn(),
+    }
+  };
+});
 
 describe('UserRepository', () => {
     let userRepository: UserRepository;

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

@@ -12,12 +12,26 @@ import UpdateUser from '@/usecases/updateUser';
 import DeleteUser from '@/usecases/deleteUser';
 
 // Mock dependencies
-jest.mock('@/infrastructure/repositories/UserRepository');
+jest.mock('@/infrastructure/repositories/UserRepository', () => ({
+    UserRepository: jest.fn().mockImplementation(() => ({
+        save: jest.fn(),
+        findById: jest.fn(),
+        getUsers: jest.fn(),
+        update: jest.fn(),
+        delete: jest.fn()
+    }))
+}));
 jest.mock('@/usecases/createUser');
 jest.mock('@/usecases/getAllUsers');
 jest.mock('@/usecases/updateUser');
 jest.mock('@/usecases/deleteUser');
-jest.mock('@/infrastructure/log/logger');
+jest.mock('@/usecases/getUserById');
+jest.mock('@/infrastructure/log/logger', () => ({
+    info: jest.fn(),
+    error: jest.fn(),
+    warn: jest.fn(),
+    debug: jest.fn()
+}));
 <%_ if (communication === 'Kafka') { -%>
 jest.mock('@/infrastructure/messaging/kafkaClient', () => ({
     kafkaService: {
@@ -45,7 +59,7 @@ describe('UserController (Clean Architecture)', () => {
 
     beforeEach(() => {
         // Clear all mocks
-        jest.resetAllMocks();
+        jest.clearAllMocks();
 
         userController = new UserController();
 

package/templates/clean-architecture/ts/src/interfaces/graphql/context.spec.ts.ejs

@@ -1,9 +1,27 @@
 import { Request } from 'express';
-<% if (auth.includes('JWT')) { %>import { JwtService } from '@/infrastructure/auth/jwtService';
-jest.mock('@/infrastructure/auth/jwtService');<% } %>
+<% if (auth.includes('JWT')) { %>
+import { JwtService } from '@/infrastructure/auth/jwtService';
+jest.mock('@/infrastructure/auth/jwtService', () => ({
+    JwtService: {
+        generateToken: jest.fn(),
+        verifyToken: jest.fn(),
+        generateRefreshToken: jest.fn(),
+        verifyRefreshToken: jest.fn(),
+        decodeToken: jest.fn(),
+    }
+}));
+<% } %>
 import { gqlContext } from '@/interfaces/graphql/context';
 
-jest.mock('@/infrastructure/repositories/UserRepository');
+jest.mock('@/infrastructure/repositories/UserRepository', () => ({
+    UserRepository: jest.fn().mockImplementation(() => ({
+        save: jest.fn(),
+        findById: jest.fn(),
+        getUsers: jest.fn(),
+        update: jest.fn(),
+        delete: jest.fn()
+    }))
+}));
 
 describe('GraphQL Context', () => {
     afterEach(() => {

package/templates/clean-architecture/ts/src/usecases/createUser.spec.ts.ejs

@@ -4,7 +4,15 @@ import { UserRepository } from '@/infrastructure/repositories/UserRepository';
 import cacheService from '<% if (caching === "Redis") { %>@/infrastructure/caching/redisClient<% } else { %>@/infrastructure/caching/memoryCache<% } %>';
 <%_ } -%>
 
-jest.mock('@/infrastructure/repositories/UserRepository');
+jest.mock('@/infrastructure/repositories/UserRepository', () => ({
+    UserRepository: jest.fn().mockImplementation(() => ({
+        save: jest.fn(),
+        findById: jest.fn(),
+        getUsers: jest.fn(),
+        update: jest.fn(),
+        delete: jest.fn()
+    }))
+}));
 <%_ if (caching !== 'None') { -%>
 jest.mock('<% if (caching === "Redis") { %>@/infrastructure/caching/redisClient<% } else { %>@/infrastructure/caching/memoryCache<% } %>', () => ({
     get: jest.fn(),

package/templates/clean-architecture/ts/src/usecases/deleteUser.spec.ts.ejs

@@ -4,7 +4,15 @@ import { UserRepository } from '@/infrastructure/repositories/UserRepository';
 import cacheService from '<% if (caching === "Redis") { %>@/infrastructure/caching/redisClient<% } else { %>@/infrastructure/caching/memoryCache<% } %>';
 <%_ } -%>
 
-jest.mock('@/infrastructure/repositories/UserRepository');
+jest.mock('@/infrastructure/repositories/UserRepository', () => ({
+    UserRepository: jest.fn().mockImplementation(() => ({
+        save: jest.fn(),
+        findById: jest.fn(),
+        getUsers: jest.fn(),
+        update: jest.fn(),
+        delete: jest.fn()
+    }))
+}));
 <%_ if (caching !== 'None') { -%>
 jest.mock('<% if (caching === "Redis") { %>@/infrastructure/caching/redisClient<% } else { %>@/infrastructure/caching/memoryCache<% } %>', () => ({
     get: jest.fn(),

package/templates/clean-architecture/ts/src/usecases/getAllUsers.spec.ts.ejs

@@ -4,7 +4,15 @@ import { UserRepository } from '@/infrastructure/repositories/UserRepository';
 import cacheService from '<% if (caching === "Redis") { %>@/infrastructure/caching/redisClient<% } else { %>@/infrastructure/caching/memoryCache<% } %>';
 <%_ } -%>
 
-jest.mock('@/infrastructure/repositories/UserRepository');
+jest.mock('@/infrastructure/repositories/UserRepository', () => ({
+    UserRepository: jest.fn().mockImplementation(() => ({
+        save: jest.fn(),
+        findById: jest.fn(),
+        getUsers: jest.fn(),
+        update: jest.fn(),
+        delete: jest.fn()
+    }))
+}));
 <%_ if (caching !== 'None') { -%>
 jest.mock('<% if (caching === "Redis") { %>@/infrastructure/caching/redisClient<% } else { %>@/infrastructure/caching/memoryCache<% } %>', () => ({
     get: jest.fn(),

package/templates/clean-architecture/ts/src/usecases/getUserById.spec.ts.ejs

@@ -1,7 +1,15 @@
 import GetUserById from '@/usecases/getUserById';
 import { UserRepository } from '@/infrastructure/repositories/UserRepository';
 
-jest.mock('@/infrastructure/repositories/UserRepository');
+jest.mock('@/infrastructure/repositories/UserRepository', () => ({
+    UserRepository: jest.fn().mockImplementation(() => ({
+        save: jest.fn(),
+        findById: jest.fn(),
+        getUsers: jest.fn(),
+        update: jest.fn(),
+        delete: jest.fn()
+    }))
+}));
 
 <% if (caching === 'Redis') { -%>
 jest.mock('@/infrastructure/caching/redisClient', () => ({

package/templates/clean-architecture/ts/src/usecases/updateUser.spec.ts.ejs

@@ -4,7 +4,15 @@ import { UserRepository } from '@/infrastructure/repositories/UserRepository';
 import cacheService from '<% if (caching === "Redis") { %>@/infrastructure/caching/redisClient<% } else { %>@/infrastructure/caching/memoryCache<% } %>';
 <%_ } -%>
 
-jest.mock('@/infrastructure/repositories/UserRepository');
+jest.mock('@/infrastructure/repositories/UserRepository', () => ({
+    UserRepository: jest.fn().mockImplementation(() => ({
+        save: jest.fn(),
+        findById: jest.fn(),
+        getUsers: jest.fn(),
+        update: jest.fn(),
+        delete: jest.fn()
+    }))
+}));
 <%_ if (caching !== 'None') { -%>
 jest.mock('<% if (caching === "Redis") { %>@/infrastructure/caching/redisClient<% } else { %>@/infrastructure/caching/memoryCache<% } %>', () => ({
     get: jest.fn(),

package/templates/common/auth/js/controllers/authController.js.ejs

@@ -45,16 +45,16 @@ class AuthController {
       const refreshJti = JwtService.decodeToken(refreshToken)?.jti;
       const accessToken = JwtService.generateToken({ id: userId, email: user.email, sid: refreshJti });
 
-      <% if (caching !== 'None') { %>
+<%_ if (caching !== 'None') { -%>
       const cacheKey = `refresh_tokens:${userId}`;
       const activeTokens = await cacheService.get(cacheKey) || [];
       activeTokens.push(refreshJti);
       await cacheService.set(cacheKey, activeTokens, 7 * 24 * 60 * 60);
-      <% } else { -%>
+<% } else { %>
       const activeTokens = JwtService.activeRefreshTokens.get(userId) || [];
       activeTokens.push(refreshJti);
       JwtService.activeRefreshTokens.set(userId, activeTokens);
-      <% } %>
+<%_ } -%>
 
       res.json({ token: accessToken, accessToken, refreshToken });
     } catch (error) {
@@ -78,7 +78,7 @@ class AuthController {
       const userId = String(decoded.id);
       const incomingJti = decoded.jti;
 
-      <% if (caching !== 'None') { %>
+<%_ if (caching !== 'None') { -%>
       const cacheKey = `refresh_tokens:${userId}`;
       let activeTokens = await cacheService.get(cacheKey) || [];
       
@@ -95,7 +95,7 @@ class AuthController {
       
       activeTokens.push(newRefreshJti);
       await cacheService.set(cacheKey, activeTokens, 7 * 24 * 60 * 60);
-      <% } else { -%>
+<% } else { %>
       let activeTokens = JwtService.activeRefreshTokens.get(userId) || [];
       
       if (!activeTokens.includes(incomingJti)) {
@@ -111,7 +111,7 @@ class AuthController {
       
       activeTokens.push(newRefreshJti);
       JwtService.activeRefreshTokens.set(userId, activeTokens);
-      <% } %>
+<%_ } -%>
       res.json({ accessToken: newAccessToken, refreshToken: newRefreshToken });
     } catch (error) {
       logger.error('Refresh token error:', error);
@@ -131,13 +131,15 @@ class AuthController {
       
       if (decodedAccess && decodedAccess.jti && decodedAccess.exp) {
         const remainingTime = Math.max(0, decodedAccess.exp - Math.floor(Date.now() / 1000));
-        <%_ if (caching !== 'None') { -%>
+<%_ if (caching !== 'None') { -%>
         if (remainingTime > 0) {
             await cacheService.set(`blacklist:${decodedAccess.jti}`, true, remainingTime);
-        }<%_ } else { -%>
+        }
+<% } else { %>
         if (remainingTime > 0) {
             JwtService.blacklistedTokens.set(decodedAccess.jti, Date.now() + remainingTime * 1000);
-        }<%_ } -%>
+        }
+<%_ } -%>
       }
 
       const { refreshToken } = req.body;

package/templates/common/auth/ts/controllers/authController.ts.ejs

@@ -93,7 +93,7 @@ export class AuthController {
       
       activeTokens.push(newRefreshJti!);
       await cacheService.set(cacheKey, activeTokens, 7 * 24 * 60 * 60);
-      <% } else { -%>
+      <% } else { %>
       let activeTokens = JwtService.activeRefreshTokens.get(userId) || [];
       
       if (!activeTokens.includes(incomingJti)) {
@@ -130,13 +130,15 @@ export class AuthController {
       
       if (decodedAccess && decodedAccess.jti && decodedAccess.exp) {
         const remainingTime = Math.max(0, decodedAccess.exp - Math.floor(Date.now() / 1000));
-        <%_ if (caching !== 'None') { -%>
+<%_ if (caching !== 'None') { -%>
         if (remainingTime > 0) {
             await cacheService.set(`blacklist:${decodedAccess.jti}`, true, remainingTime);
-        }<%_ } else { -%>
+        }
+<% } else { %>
         if (remainingTime > 0) {
             JwtService.blacklistedTokens.set(decodedAccess.jti, Date.now() + remainingTime * 1000);
-        }<%_ } -%>
+        }
+<%_ } -%>
       }
 
       const { refreshToken } = req.body;
@@ -149,7 +151,7 @@ export class AuthController {
            let activeTokens = await cacheService.get<string[]>(cacheKey) || [];
            activeTokens = activeTokens.filter(t => t !== decodedRefresh.jti);
            await cacheService.set(cacheKey, activeTokens, 7 * 24 * 60 * 60);
-           <%_ } else { -%>
+           <% } else { %>
            let activeTokens = JwtService.activeRefreshTokens.get(userId) || [];
            activeTokens = activeTokens.filter(t => t !== decodedRefresh.jti);
            JwtService.activeRefreshTokens.set(userId, activeTokens);<% } %>

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

@@ -0,0 +1,5 @@
+module.exports = {
+  presets: [
+    ['@babel/preset-env', { targets: { node: 'current' } }]
+  ]
+};

package/templates/common/caching/js/memoryCache.spec.js.ejs

@@ -9,6 +9,8 @@ jest.mock('node-cache', () => {
 jest.mock('<%- loggerPath %>', () => ({
     info: jest.fn(),
     error: jest.fn(),
+    warn: jest.fn(),
+    debug: jest.fn(),
 }));
 
 describe('Memory Cache Client', () => {

package/templates/common/caching/js/redisClient.spec.js.ejs

@@ -16,6 +16,8 @@ jest.mock('dotenv', () => ({
 const mockLogger = {
     info: jest.fn(),
     error: jest.fn(),
+    warn: jest.fn(),
+    debug: jest.fn(),
 };
 
 jest.mock('<%- loggerPath %>', () => mockLogger);

package/templates/common/caching/ts/memoryCache.spec.ts.ejs

@@ -9,6 +9,8 @@ jest.mock('node-cache', () => {
 jest.mock('<%- loggerPath %>', () => ({
     info: jest.fn(),
     error: jest.fn(),
+    warn: jest.fn(),
+    debug: jest.fn(),
 }));
 
 describe('Memory Cache Client', () => {

package/templates/common/caching/ts/redisClient.spec.ts.ejs

@@ -16,6 +16,8 @@ jest.mock('dotenv', () => ({
 const mockLogger = {
     info: jest.fn(),
     error: jest.fn(),
+    warn: jest.fn(),
+    debug: jest.fn(),
 };
 
 jest.mock('<%- loggerPath %>', () => mockLogger);

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

@@ -5,6 +5,8 @@ jest.mock('mongoose', () => ({
 const mockLogger = {
     info: jest.fn(),
     error: jest.fn(),
+    warn: jest.fn(),
+    debug: jest.fn(),
 };
 
 jest.mock('<% if (architecture === "MVC") { %>@/utils/logger<% } else { %>@/infrastructure/log/logger<% } %>', () => mockLogger);

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

@@ -5,6 +5,8 @@ jest.mock('mongoose', () => ({
 const logger = {
     info: jest.fn(),
     error: jest.fn(),
+    warn: jest.fn(),
+    debug: jest.fn(),
 };
 
 jest.mock('<% if (architecture === "MVC") { %>@/utils/logger<% } else { %>@/infrastructure/log/logger<% } %>', () => logger);

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

@@ -1,8 +1,10 @@
 module.exports = {
   testEnvironment: 'node',
+  testTimeout: 30000,
   coverageDirectory: 'coverage',
   collectCoverageFrom: ['src/**/*.{js,ts}'],
   testMatch: ['**/*.test.ts', '**/*.test.js', '**/*.spec.ts', '**/*.spec.js'],
+  transformIgnorePatterns: ['/node_modules/(?!.*uuid)'],
   testPathIgnorePatterns: ['/node_modules/', '/tests/e2e/'],
   <% if (language === 'TypeScript') { %>preset: 'ts-jest',<% } %>
   moduleNameMapper: {

package/templates/common/package.json.ejs

@@ -29,7 +29,8 @@
     "braces": "^3.0.3",
     "picomatch": "^4.0.4",
     "lodash": "^4.17.23",
-    "debounce": "^1.2.1"
+    "debounce": "^1.2.1",
+    "uuid": "^14.0.0"
   },
   "dependencies": {
     "express": "^4.18.2",
@@ -58,7 +59,6 @@
     "bcryptjs": "^2.4.3",
 <% } -%>
     "cors": "^2.8.5",
-
     "helmet": "^7.1.0",
     "hpp": "^0.2.3",
     "express-rate-limit": "^7.1.5",
@@ -92,7 +92,6 @@
     "cpx2": "^8.0.0"<% } %><% if (auth.includes('JWT')) { %>,
     "@types/jsonwebtoken": "^9.0.6",
     "@types/bcryptjs": "^2.4.6"<% } %><% } %>,
-
     "eslint": "^10.1.0",
     "@eslint/js": "^9.20.0",
     "globals": "^15.14.0",
@@ -115,6 +114,9 @@
     "tsc-alias": "^1.8.10",
     "@types/supertest": "^6.0.2"<% } else { %>,
     "jest": "^29.7.0",
+    "babel-jest": "^29.7.0",
+    "@babel/core": "^7.24.0",
+    "@babel/preset-env": "^7.24.0",
     "wait-on": "^7.2.0",
     "supertest": "^7.1.3"<% } %>
   },

package/templates/common/tsconfig.json

@@ -8,6 +8,7 @@
         "esModuleInterop": true,
         "skipLibCheck": true,
         "forceConsistentCasingInFileNames": true,
+        "allowJs": true,
         "baseUrl": ".",
         "paths": {
             "@/*": ["src/*"],