nodejs-quickstart-structure 2.0.1 → 2.1.1

package/templates/common/auth/ts/services/jwtService.ts.ejs

@@ -0,0 +1,60 @@
+import jwt from 'jsonwebtoken';
+import crypto from 'crypto';
+import { env } from '@/config/env';
+
+export interface JwtPayload {
+  id: string | number;
+  email: string;
+  jti?: string;
+  sid?: string;
+  exp?: number;
+}
+
+export class JwtService {
+  private static readonly SECRET = env.JWT_SECRET || 'your-secret-key';
+  private static readonly REFRESH_SECRET = env.JWT_REFRESH_SECRET || 'your-refresh-secret-key';
+  private static readonly EXPIRES_IN = env.JWT_EXPIRES_IN || '15m'; // Access tokens should be short-lived
+  private static readonly REFRESH_EXPIRES_IN = env.JWT_REFRESH_EXPIRES_IN || '7d';
+
+  static generateToken(payload: Partial<JwtPayload>, expiresIn?: string): string {
+    const jti = crypto.randomUUID();
+    return jwt.sign({ ...payload, jti }, this.SECRET, { 
+      expiresIn: expiresIn || this.EXPIRES_IN 
+    } as jwt.SignOptions);
+  }
+
+  static generateRefreshToken(payload: Partial<JwtPayload>, expiresIn?: string): string {
+    const jti = crypto.randomUUID();
+    return jwt.sign({ ...payload, jti }, this.REFRESH_SECRET, { 
+      expiresIn: expiresIn || this.REFRESH_EXPIRES_IN 
+    } as jwt.SignOptions);
+  }
+
+  static verifyToken(token: string): JwtPayload | null {
+    try {
+      return jwt.verify(token, this.SECRET) as JwtPayload;
+    } catch {
+      return null;
+    }
+  }
+
+  static verifyRefreshToken(token: string): JwtPayload | null {
+    try {
+      return jwt.verify(token, this.REFRESH_SECRET) as JwtPayload;
+    } catch {
+      return null;
+    }
+  }
+
+  static decodeToken(token: string): JwtPayload | null {
+    try {
+      return jwt.decode(token) as JwtPayload;
+    } catch {
+      return null;
+    }
+  }
+
+  // Fallback in-memory storage if caching = 'None'
+  static activeRefreshTokens = new Map<string, string[]>();
+  static blacklistedTokens = new Map<string, number>();
+}

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

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

package/templates/common/caching/clean/js/CreateUser.js.ejs

@@ -1,9 +1,12 @@
 const User = require('../domain/models/User');
-<%_ if (caching === 'Redis') { -%>
+<% if (auth.includes('JWT')) { -%>
+const bcrypt = require('bcryptjs');
+<% } -%>
+<% if (caching === 'Redis') { -%>
 const cacheService = require('../infrastructure/caching/redisClient');
-<%_ } else if (caching === 'Memory Cache') { -%>
+<% } else if (caching === 'Memory Cache') { -%>
 const cacheService = require('../infrastructure/caching/memoryCache');
-<%_ } -%>
+<% } -%>
 const logger = require('../infrastructure/log/logger');
 
 class CreateUser {
@@ -11,8 +14,14 @@ class CreateUser {
         this.userRepository = userRepository;
     }
 
-    async execute(name, email) {
-        const user = new User(null, name, email);
+    async execute(name, email, password) {
+        let finalPassword = password;
+        <% if (auth.includes('JWT')) { -%>
+        if (password) {
+            finalPassword = await bcrypt.hash(password, 10);
+        }
+        <% } -%>
+        const user = new User(null, name, email, finalPassword);
         const savedUser = await this.userRepository.save(user);
 
         try {

package/templates/common/caching/clean/js/DeleteUser.js.ejs

@@ -15,7 +15,8 @@ class DeleteUser {
 
         try {
             await cacheService.del('users:all');
-            logger.info('Invalidated users:all cache');
+            await cacheService.del(`user:${id}`);
+            logger.info(`Invalidated cache for user:${id} and all users`);
         } catch (error) {
              logger.error('Cache error (del):', error);
         }

package/templates/common/caching/clean/js/GetUserById.js.ejs

@@ -0,0 +1,39 @@
+<%_ if (caching === 'Redis') { -%>
+const cacheService = require('../infrastructure/caching/redisClient');
+<%_ } else if (caching === 'Memory Cache') { -%>
+const cacheService = require('../infrastructure/caching/memoryCache');
+<%_ } -%>
+const logger = require('../infrastructure/log/logger');
+
+class GetUserById {
+  constructor(userRepository) {
+    this.userRepository = userRepository;
+  }
+
+  async execute(id) {
+    const cacheKey = `user:${id}`;
+    try {
+      const cachedUser = await cacheService.get(cacheKey);
+      if (cachedUser) {
+        logger.info(`Serving user ${id} from cache`);
+        return cachedUser;
+      }
+    } catch (error) {
+      logger.error('Cache error (get):', error);
+    }
+
+    const user = await this.userRepository.findById(id);
+
+    if (user) {
+      try {
+        await cacheService.set(cacheKey, user, 3600); // Cache for 1 hour
+      } catch (error) {
+        logger.error('Cache error (set):', error);
+      }
+    }
+
+    return user;
+  }
+}
+
+module.exports = GetUserById;

package/templates/common/caching/clean/js/UpdateUser.js.ejs

@@ -15,7 +15,8 @@ class UpdateUser {
 
         try {
             await cacheService.del('users:all');
-            logger.info('Invalidated users:all cache');
+            await cacheService.del(`user:${id}`);
+            logger.info(`Invalidated cache for user:${id} and all users`);
         } catch (error) {
             logger.error('Cache error (del):', error);
         }

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

@@ -1,18 +1,26 @@
 import { User } from '@/domain/user';
-
 import { UserRepository } from '@/infrastructure/repositories/UserRepository';
-<%_ if (caching === 'Redis') { -%>
+<% if (auth.includes('JWT')) { -%>
+import bcrypt from 'bcryptjs';
+<% } -%>
+<% if (caching === 'Redis') { -%>
 import cacheService from '@/infrastructure/caching/redisClient';
-<%_ } else if (caching === 'Memory Cache') { -%>
+<% } else if (caching === 'Memory Cache') { -%>
 import cacheService from '@/infrastructure/caching/memoryCache';
-<%_ } -%>
+<% } -%>
 import logger from '@/infrastructure/log/logger';
 
 export default class CreateUser {
     constructor(private userRepository: UserRepository) {}
 
-    async execute(name: string, email: string) {
-        const user = new User(null, name, email);
+    async execute(name: string, email: string, password?: string) {
+        let finalPassword = password;
+<% if (auth.includes('JWT')) { -%>
+        if (password) {
+            finalPassword = await bcrypt.hash(password, 10);
+        }
+<% } -%>
+        const user = new User(null, name, email, finalPassword);
         const savedUser = await this.userRepository.save(user);
 
         try {

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

@@ -14,7 +14,8 @@ export default class DeleteUser {
 
         try {
             await cacheService.del('users:all');
-            logger.info('Invalidated users:all cache');
+            await cacheService.del(`user:${id}`);
+            logger.info(`Invalidated cache for user:${id} and all users`);
         } catch (error) {
             logger.error('Cache error (del):', error);
         }

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

@@ -0,0 +1,32 @@
+import { UserRepository } from '@/infrastructure/repositories/UserRepository';
+import cacheService from '<% if (caching === "Redis") { %>@/infrastructure/caching/redisClient<% } else { %>@/infrastructure/caching/memoryCache<% } %>';
+import logger from '@/infrastructure/log/logger';
+
+export default class GetUserById {
+    constructor(private userRepository: UserRepository) {}
+
+    async execute(id: string | number) {
+        const cacheKey = `user:${id}`;
+        try {
+            const cachedUser = await cacheService.get(cacheKey);
+            if (cachedUser) {
+                logger.info(`Serving user ${id} from cache`);
+                return cachedUser;
+            }
+        } catch (error) {
+            logger.error('Cache error (get):', error);
+        }
+
+        const user = await this.userRepository.findById(id);
+
+        if (user) {
+            try {
+                await cacheService.set(cacheKey, user, 3600); // Cache for 1 hour
+            } catch (error) {
+                logger.error('Cache error (set):', error);
+            }
+        }
+
+        return user;
+    }
+}

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

@@ -14,7 +14,8 @@ export default class UpdateUser {
 
         try {
             await cacheService.del('users:all');
-            logger.info('Invalidated users:all cache');
+            await cacheService.del(`user:${id}`);
+            logger.info(`Invalidated cache for user:${id} and all users`);
         } catch (error) {
             logger.error('Cache error (del):', error);
         }

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/models/User.js.ejs

@@ -6,12 +6,18 @@ class UserModel {
     return this.mockData;
   }
 
+  static async findOne(query) {
+    return this.mockData.find((u) => {
+      return Object.entries(query).every(([key, value]) => u[key] === value);
+    });
+  }
+
   static async findAll() {
     return this.mockData;
   }
 
   static async create(data) {
-    const { id, ...rest } = data;
+    const { id: _, ...rest } = data;
     const newUser = { id: String(this.mockData.length + 1), ...rest };
     this.mockData.push(newUser);
     return newUser;
@@ -62,6 +68,12 @@ User.init(
       allowNull: false,
       unique: true,
     },
+    <% if (auth.includes('JWT')) { %>
+    password: {
+      type: DataTypes.STRING,
+      allowNull: false,
+    },
+    <% } %>
     deletedAt: {
       type: DataTypes.DATE,
       allowNull: true,
@@ -75,5 +87,6 @@ User.init(
   }
 );
 
+
 module.exports = User;
 <% } -%>

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

@@ -10,6 +10,12 @@ const UserSchema = new mongoose.Schema({
         required: true,
         unique: true
     },
+    <% if (auth.includes('JWT')) { %>
+    password: {
+        type: String,
+        required: true
+    },
+    <% } %>
     createdAt: {
         type: Date,
         default: Date.now
@@ -20,4 +26,5 @@ const UserSchema = new mongoose.Schema({
     }
 });
 
+
 module.exports = mongoose.model('User', UserSchema);

package/templates/common/database/js/models/User.spec.js.ejs

@@ -73,15 +73,27 @@ describe('User Model', () => {
         expect(await User.find()).toBeDefined();
         expect(await User.findAll()).toBeDefined();
         
+        // Test findOne
+        const oneUser = await User.findOne({ email: data.email });
+        expect(oneUser.email).toBe(data.email);
+        
         const found = await User.findByPk(user.id);
         expect(found.id).toBe(user.id);
         
         const updated = await User.update(user.id, { name: 'New Name' });
         expect(updated.name).toBe('New Name');
         
+        // Test update non-existent
+        const nonExistentUpdate = await User.update('999', { name: 'Fail' });
+        expect(nonExistentUpdate).toBeUndefined();
+
         const deleted = await User.destroy(user.id);
         expect(deleted).toBe(true);
         expect(await User.findByPk(user.id)).toBeUndefined();
+
+        // Test destroy non-existent
+        const notDeleted = await User.destroy('999');
+        expect(notDeleted).toBe(false);
         <% } else { %>
         User.create.mockResolvedValue({ id: 1, ...data });
         User.findAll.mockResolvedValue([{ id: 1, ...data }]);

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/models/User.spec.ts.ejs

@@ -40,6 +40,11 @@ jest.mock('@/infrastructure/database/database', () => ({}));
 describe('User Model', () => {
     beforeEach(() => {
         jest.clearAllMocks();
+        <% if (database === 'None') { %>
+        const UserPath = '<% if (architecture === "MVC") { %>@/models/User<% } else { %>@/infrastructure/database/models/User<% } %>';
+        const User = require(UserPath).default;
+        User.mockData = [];
+        <% } %>
     });
 
     it('should be defined and initialized', () => {
@@ -78,6 +83,11 @@ describe('User Model', () => {
         expect(found).toEqual(user);
         expect(await User.findByPk('invalid')).toBeUndefined();
         
+        // findOne
+        const foundOne = await User.findOne({ email: data.email });
+        expect(foundOne).toEqual(user);
+        expect(await User.findOne({ email: 'nonexistent' })).toBeUndefined();
+        
         // update
         const updated = await User.update(user.id, { name: 'Updated' });
         expect(updated.name).toBe('Updated');

package/templates/common/database/ts/models/User.ts.ejs

@@ -3,6 +3,9 @@ export interface User {
   id: string;
   name: string;
   email: string;
+<% if (auth.includes('JWT')) { -%>
+  password?: string;
+<% } -%>
 }
 
 export default class UserModel {
@@ -12,6 +15,12 @@ export default class UserModel {
     return this.mockData;
   }
 
+  static async findOne(query: Partial<User>) {
+    return this.mockData.find((u) => {
+      return Object.entries(query).every(([key, value]) => (u as unknown as Record<string, unknown>)[key] === value);
+    });
+  }
+
   static async findAll() {
     return this.mockData;
   }
@@ -52,6 +61,7 @@ class User extends Model {
   public id!: number;
   public name!: string;
   public email!: string;
+  <% if (auth.includes('JWT')) { %>public password!: string;<% } %>
 }
 
 User.init(
@@ -70,6 +80,12 @@ User.init(
       allowNull: false,
       unique: true,
     },
+    <% if (auth.includes('JWT')) { %>
+    password: {
+      type: DataTypes.STRING,
+      allowNull: false,
+    },
+    <% } %>
     deletedAt: {
       type: DataTypes.DATE,
       allowNull: true,
@@ -83,5 +99,6 @@ User.init(
   }
 );
 
+
 export default User;
 <% } -%>

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

@@ -3,6 +3,7 @@ import mongoose, { Schema, Document } from 'mongoose';
 export interface IUser extends Document {
     name: string;
     email: string;
+    <% if (auth.includes('JWT')) { %>password: string;<% } %>
     createdAt: Date;
     deletedAt?: Date | null;
 }
@@ -17,6 +18,12 @@ const UserSchema: Schema = new Schema({
         required: true,
         unique: true
     },
+    <% if (auth.includes('JWT')) { %>
+    password: {
+        type: String,
+        required: true
+    },
+    <% } %>
     createdAt: {
         type: Date,
         default: Date.now
@@ -27,4 +34,5 @@ const UserSchema: Schema = new Schema({
     }
 });
 
+
 export default mongoose.model<IUser>('User', UserSchema);

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/docker-compose.yml.ejs

@@ -39,6 +39,12 @@ services:
       - DB_PORT=27017
 <%_ } -%>
 <%_ } -%>
+<%_ if (auth.includes('JWT')) { -%>
+      - JWT_SECRET=your_jwt_secret_key_here_change_it
+      - JWT_REFRESH_SECRET=your_jwt_refresh_secret_key_here_change_it
+      - JWT_EXPIRES_IN=1d
+      - JWT_REFRESH_EXPIRES_IN=7d
+<%_ } -%>
 <%_ } else { -%>
     environment:
       - PORT=3000
@@ -64,6 +70,12 @@ services:
       - DB_PORT=27017
 <%_ } -%>
 <%_ } -%>
+<%_ if (auth.includes('JWT')) { -%>
+      - JWT_SECRET=your_jwt_secret_key_here_change_it
+      - JWT_REFRESH_SECRET=your_jwt_refresh_secret_key_here_change_it
+      - JWT_EXPIRES_IN=1d
+      - JWT_REFRESH_EXPIRES_IN=7d
+<%_ } -%>
 <%_ } -%>
 <%_ if (database !== 'None') { -%>
   db:

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

@@ -24,16 +24,22 @@ module.exports = {
       DB_USER: "root",
       DB_PASSWORD: "root",
       DB_NAME: "<%= dbName %>",
-      DB_PORT: 3306
+      DB_PORT: 3306,
 <%_ } else if (database === 'PostgreSQL') { -%>
       DB_USER: "postgres",
       DB_PASSWORD: "root",
       DB_NAME: "<%= dbName %>",
-      DB_PORT: 5432
+      DB_PORT: 5432,
 <%_ } else if (database === 'MongoDB') { -%>
       DB_NAME: "<%= dbName %>",
-      DB_PORT: 27017
+      DB_PORT: 27017,
 <%_ } -%>
+<%_ } -%>
+<%_ if (auth.includes('JWT')) { -%>
+      JWT_SECRET: "your_jwt_secret_here",
+      JWT_REFRESH_SECRET: "your_jwt_refresh_secret_here",
+      JWT_EXPIRES_IN: "1h",
+      JWT_REFRESH_EXPIRES_IN: "7d",
 <%_ } -%>
     }
   }]

package/templates/common/eslint.config.mjs.ejs

@@ -19,6 +19,9 @@ export default tseslint.config(
       },
     },
     languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.json', './tsconfig.eslint.json'],
+      },
       globals: {
         ...globals.node,
         ...globals.jest,

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: {
@@ -11,15 +13,17 @@ module.exports = {
   coveragePathIgnorePatterns: [
     "/node_modules/",
     "/dist/",
-    "src/index",
-    "src/app",
-    "src/config/env",
-    "src/infrastructure/config/env",
-    "src/config/swagger",
-    "src/infrastructure/webserver/swagger",
-    "src/infrastructure/webserver/server",
-    "src/utils/logger",
-    "src/infrastructure/log/logger"
+    "src/index.(js|ts)",
+    "src/app.(js|ts)",
+    "src/config",
+    "src/infrastructure/config",
+    "src/routes",
+    "src/infrastructure/routes",
+    "src/interfaces/routes",
+    "src/graphql",
+    "src/interfaces/graphql",
+    "src/utils",
+    "src/models"
   ],
   coverageThreshold: {
     global: {

package/templates/common/kafka/js/messaging/baseConsumer.js.ejs

@@ -22,7 +22,7 @@ class BaseConsumer {
     }
   }
 
-  async handle(data) {
+  async handle(_data) {
     throw new Error("Method 'handle()' must be implemented");
   }
 }

package/templates/common/kafka/js/services/kafkaService.js.ejs

@@ -34,7 +34,7 @@ const connectKafka = async (retries = 10) => {
                     await consumer.run({
                         eachMessage: async (payload) => welcomeConsumer.onMessage(payload),
                     });
-                } catch (error) {
+                } catch {
                     // Fallback or no consumers found
                     await consumer.subscribe({ topic: 'user-topic', fromBeginning: true });
                     await consumer.run({

package/templates/common/migrations/init.js.ejs

@@ -1,5 +1,5 @@
 module.exports = {
-  async up(db, client) {
+  async up(db, _client) {
     const adminEmail = 'admin@example.com';
     const existingAdmin = await db.collection('users').findOne({ email: adminEmail });
 
@@ -7,16 +7,17 @@ module.exports = {
       await db.collection('users').insertOne({
         name: 'Admin User',
         email: adminEmail,
+        <% if (auth.includes('JWT')) { %>password: '$2a$10$X.fO9PeyF0Lq0lF8uV6G9u4Vb4e5T0rF8l/JzM6S7X9u4Vb4e5T0r', // password: password123<% } %>
         createdAt: new Date(),
         updatedAt: new Date()
       });
-      console.log('Admin User seeded successfully');
+      console.log('Admin User seeded successfully'); // eslint-disable-line no-console
     } else {
-      console.log('Admin User already exists, skipping seed');
+      console.log('Admin User already exists, skipping seed'); // eslint-disable-line no-console
     }
   },
 
-  async down(db, client) {
+  async down(_db, _client) {
     // Optional: Undo the seed. Usually for seeds we might want to keep data, but strictly speaking 'down' should reverse 'up'.
     // await db.collection('users').deleteOne({ email: 'admin@example.com' });
   }