nodejs-quickstart-structure 2.0.1 → 2.1.1

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

@@ -0,0 +1,161 @@
+<%_ if (architecture === 'Clean Architecture') { _%>
+import { AuthController } from '@/interfaces/controllers/auth/authController';
+import { JwtService } from '@/infrastructure/auth/jwtService';
+<%_ } else { _%>
+import { AuthController } from '@/controllers/authController';
+import { JwtService } from '@/services/jwtService';
+<%_ } _%>
+import { HTTP_STATUS } from '@/utils/httpCodes';
+import bcrypt from 'bcryptjs';
+import { Request, Response, NextFunction } from 'express';
+
+<%_ if (architecture === 'Clean Architecture') { _%>
+jest.mock('@/infrastructure/auth/jwtService');
+<%_ } else { _%>
+jest.mock('@/services/jwtService');
+<%_ } _%>
+jest.mock('bcryptjs');
+
+<%_ if (architecture === 'Clean Architecture') { _%>
+jest.mock('@/infrastructure/database/models/User', () => ({ findOne: jest.fn() }));
+const User = require('@/infrastructure/database/models/User');
+<%_ } else { _%>
+jest.mock('@/models/User', () => ({ findOne: jest.fn() }));
+const User = require('@/models/User');
+<%_ } _%>
+
+<%_ if (caching !== 'None') { _%>
+<%_ const cachePath = (architecture === "MVC") ? (caching === "Redis" ? "@/config/redisClient" : "@/config/memoryCache") : (caching === "Redis" ? "@/infrastructure/caching/redisClient" : "@/infrastructure/caching/memoryCache"); _%>
+jest.mock('<%= cachePath %>', () => ({
+  __esModule: true,
+  default: {
+    get: jest.fn(),
+    set: jest.fn(),
+    del: jest.fn()
+  }
+}), { virtual: true });
+import cacheService from '<%= cachePath %>';
+<%_ } _%>
+
+describe('AuthController', () => {
+  let authController: AuthController;
+  let mockRequest: any;
+  let mockResponse: any;
+  const nextFunction: NextFunction = jest.fn();
+
+  beforeEach(() => {
+    authController = new AuthController();
+    mockRequest = {
+      body: {}
+    };
+    mockResponse = {
+      status: jest.fn().mockReturnThis(),
+      json: jest.fn()
+    };
+    jest.clearAllMocks();
+  });
+
+  describe('login', () => {
+    it('should return 401 if user not found', async () => {
+      mockRequest.body = { email: 'notfound@test.com', password: 'password' };
+      (User.findOne as jest.Mock).mockResolvedValue(null);
+
+      await authController.login(mockRequest as Request, mockResponse as Response, nextFunction);
+
+      expect(mockResponse.status).toHaveBeenCalledWith(HTTP_STATUS.UNAUTHORIZED);
+      expect(mockResponse.json).toHaveBeenCalledWith({ message: 'Invalid credentials' });
+    });
+
+    it('should return 401 if password does not match', async () => {
+      const user = { email: 'test@test.com', password: 'hashedpassword' };
+      mockRequest.body = { email: 'test@test.com', password: 'wrongpassword' };
+      (User.findOne as jest.Mock).mockResolvedValue(user);
+      (bcrypt.compare as jest.Mock).mockResolvedValue(false);
+
+      await authController.login(mockRequest as Request, mockResponse as Response, nextFunction);
+
+      expect(mockResponse.status).toHaveBeenCalledWith(HTTP_STATUS.UNAUTHORIZED);
+      expect(mockResponse.json).toHaveBeenCalledWith({ message: 'Invalid credentials' });
+    });
+
+    it('should return 200 and a token if credentials are valid', async () => {
+      const user = { id: 1, email: 'test@test.com', password: 'hashedpassword' };
+      mockRequest.body = { email: 'test@test.com', password: 'password123' };
+      (User.findOne as jest.Mock).mockResolvedValue(user);
+      (bcrypt.compare as jest.Mock).mockResolvedValue(true);
+      (JwtService.generateToken as jest.Mock).mockReturnValue('mock-token');
+      (JwtService.generateRefreshToken as jest.Mock).mockReturnValue('mock-refresh-token');
+      (JwtService.decodeToken as jest.Mock).mockReturnValue({ jti: 'test-jti' });
+
+      await authController.login(mockRequest as Request, mockResponse as Response, nextFunction);
+
+      expect(JwtService.generateToken).toHaveBeenCalledWith(expect.objectContaining({ sid: 'test-jti' }));
+      expect(mockResponse.json).toHaveBeenCalledWith({ token: 'mock-token', accessToken: 'mock-token', refreshToken: 'mock-refresh-token' });
+    });
+
+    it('should call next with error if something fails', async () => {
+      const error = new Error('DB Error');
+      mockRequest.body = { email: 'test@test.com', password: 'password123' };
+      (User.findOne as jest.Mock).mockRejectedValue(error);
+
+      await authController.login(mockRequest as Request, mockResponse as Response, nextFunction);
+
+      expect(nextFunction).toHaveBeenCalledWith(error);
+    });
+  });
+
+  describe('refresh', () => {
+    it('should return new tokens for a valid refresh token', async () => {
+      mockRequest.body = { refreshToken: 'valid-refresh' };
+      const decoded = { id: '1', email: 'test@test.com', jti: 'old-jti' };
+      (JwtService.verifyRefreshToken as jest.Mock).mockReturnValue(decoded);
+      (JwtService.generateToken as jest.Mock).mockReturnValue('new-access');
+      (JwtService.generateRefreshToken as jest.Mock).mockReturnValue('new-refresh');
+      (JwtService.decodeToken as jest.Mock).mockReturnValue({ jti: 'new-jti' });
+
+      // Mock cache success
+      <% if (caching !== 'None') { %>
+      (cacheService.get as jest.Mock).mockResolvedValue(['old-jti']);
+      <% } else { %>
+      JwtService.activeRefreshTokens.set('1', ['old-jti']);
+      <% } %>
+
+      await authController.refresh(mockRequest as Request, mockResponse as Response, nextFunction);
+
+      expect(JwtService.generateToken).toHaveBeenCalledWith(expect.objectContaining({ sid: 'new-jti' }));
+      expect(mockResponse.json).toHaveBeenCalledWith({ accessToken: 'new-access', refreshToken: 'new-refresh' });
+    });
+
+    it('should detect theft and revoke all tokens if jti is not active', async () => {
+      mockRequest.body = { refreshToken: 'stolen-refresh' };
+      const decoded = { id: '1', email: 'test@test.com', jti: 'stolen-jti' };
+      (JwtService.verifyRefreshToken as jest.Mock).mockReturnValue(decoded);
+
+      <% if (caching !== 'None') { %>
+      (cacheService.get as jest.Mock).mockResolvedValue(['some-other-jti']);
+      <% } else { %>
+      JwtService.activeRefreshTokens.set('1', ['some-other-jti']);
+      <% } %>
+
+      await authController.refresh(mockRequest as Request, mockResponse as Response, nextFunction);
+
+      expect(mockResponse.status).toHaveBeenCalledWith(HTTP_STATUS.UNAUTHORIZED);
+      expect(mockResponse.json).toHaveBeenCalledWith({ message: 'Invalid session' });
+    });
+  });
+
+  describe('logout', () => {
+    it('should blacklist the access token and remove the refresh token', async () => {
+      mockRequest.headers = { authorization: 'Bearer access-token' };
+      mockRequest.body = { refreshToken: 'refresh-token' };
+      
+      (JwtService.decodeToken as jest.Mock)
+        .mockReturnValueOnce({ jti: 'access-jti', exp: Math.floor(Date.now() / 1000) + 3600 }) // for access token
+        .mockReturnValueOnce({ id: '1', jti: 'refresh-jti' }); // for refresh token
+
+      await authController.logout(mockRequest as Request, mockResponse as Response, nextFunction);
+
+      expect(mockResponse.json).toHaveBeenCalledWith({ message: 'Logged out successfully' });
+    });
+  });
+});

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

@@ -0,0 +1,167 @@
+import { Request, Response, NextFunction } from 'express';
+import bcrypt from 'bcryptjs';
+<% if (architecture === 'MVC') { -%>
+import User from '@/models/User';
+import { JwtService } from '@/services/jwtService';
+import logger from '@/utils/logger';
+<% if (caching !== 'None') { -%>
+import cacheService from '<% if (caching === "Redis") { %>@/config/redisClient<% } else { %>@/config/memoryCache<% } %>';
+<% } -%>
+<% } else { -%>
+import User from '@/infrastructure/database/models/User';
+import { JwtService } from '@/infrastructure/auth/jwtService';
+import logger from '@/infrastructure/log/logger';
+<% if (caching !== 'None') { -%>
+import cacheService from '<% if (caching === "Redis") { %>@/infrastructure/caching/redisClient<% } else { %>@/infrastructure/caching/memoryCache<% } %>';
+<% } -%>
+<% } -%>
+import { HTTP_STATUS } from '@/utils/httpCodes';
+
+export class AuthController {
+  async login(req: Request, res: Response, next: NextFunction) {
+    try {
+      const { email, password } = req.body;
+      <%_ if (database === 'MongoDB' || database === 'None') { -%>
+      const user = await User.findOne({ email });
+      <%_ } else { -%>
+      const user = await User.findOne({ where: { email } });
+      <%_ } -%>
+      if (!user) {
+        return res.status(HTTP_STATUS.UNAUTHORIZED).json({ message: 'Invalid credentials' });
+      }
+
+      const isPasswordValid = await bcrypt.compare(password, user.password!);
+      if (!isPasswordValid) {
+        return res.status(HTTP_STATUS.UNAUTHORIZED).json({ message: 'Invalid credentials' });
+      }
+
+      const userId = String(user.id || ((user as unknown) as { _id?: string | number })._id);
+      
+      const refreshToken = JwtService.generateRefreshToken({ id: userId, email: user.email });
+      const refreshJti = JwtService.decodeToken(refreshToken)?.jti;
+      const accessToken = JwtService.generateToken({ id: userId, email: user.email, sid: refreshJti });
+      
+      // Store refresh token
+      <%_ if (caching !== 'None') { -%>
+      const cacheKey = `refresh_tokens:${userId}`;
+      const activeTokens = await cacheService.get<string[]>(cacheKey) || [];
+      activeTokens.push(refreshJti!);
+      await cacheService.set(cacheKey, activeTokens, 7 * 24 * 60 * 60); // 7 days
+      <%_ } else { -%>
+      const activeTokens = JwtService.activeRefreshTokens.get(userId) || [];
+      activeTokens.push(refreshJti!);
+      JwtService.activeRefreshTokens.set(userId, activeTokens);<% } %>
+
+      res.json({ token: accessToken, accessToken, refreshToken });
+    } catch (error) {
+      logger.error('Login error:', error);
+      next(error);
+    }
+  }
+
+  async refresh(req: Request, res: Response, next: NextFunction) {
+    try {
+      const { refreshToken } = req.body;
+      if (!refreshToken) {
+        return res.status(HTTP_STATUS.BAD_REQUEST).json({ message: 'Refresh token is required' });
+      }
+
+      const decoded = JwtService.verifyRefreshToken(refreshToken);
+      if (!decoded || !decoded.id || !decoded.jti) {
+        return res.status(HTTP_STATUS.UNAUTHORIZED).json({ message: 'Invalid refresh token' });
+      }
+
+      const userId = String(decoded.id);
+      const incomingJti = decoded.jti;
+
+      <% if (caching !== 'None') { %>
+      const cacheKey = `refresh_tokens:${userId}`;
+      let activeTokens = await cacheService.get<string[]>(cacheKey) || [];
+      
+      if (!activeTokens.includes(incomingJti)) {
+        // Theft detection! Revoke all sessions
+        logger.warn(`Token theft detected for user ${userId}. Revoking all sessions.`);
+        await cacheService.del(cacheKey);
+        return res.status(HTTP_STATUS.UNAUTHORIZED).json({ message: 'Invalid session' });
+      }
+
+      // Valid rotation
+      activeTokens = activeTokens.filter(t => t !== incomingJti);
+      const newRefreshToken = JwtService.generateRefreshToken({ id: userId, email: decoded.email });
+      const newRefreshJti = JwtService.decodeToken(newRefreshToken)?.jti;
+      const newAccessToken = JwtService.generateToken({ id: userId, email: decoded.email, sid: newRefreshJti });
+      
+      activeTokens.push(newRefreshJti!);
+      await cacheService.set(cacheKey, activeTokens, 7 * 24 * 60 * 60);
+      <% } else { %>
+      let activeTokens = JwtService.activeRefreshTokens.get(userId) || [];
+      
+      if (!activeTokens.includes(incomingJti)) {
+        // Theft detection!
+        logger.warn(`Token theft detected for user ${userId}. Revoking all sessions.`);
+        JwtService.activeRefreshTokens.delete(userId);
+        return res.status(HTTP_STATUS.UNAUTHORIZED).json({ message: 'Invalid session' });
+      }
+
+      activeTokens = activeTokens.filter(t => t !== incomingJti);
+      const newRefreshToken = JwtService.generateRefreshToken({ id: userId, email: decoded.email });
+      const newRefreshJti = JwtService.decodeToken(newRefreshToken)?.jti;
+      const newAccessToken = JwtService.generateToken({ id: userId, email: decoded.email, sid: newRefreshJti });
+      
+      activeTokens.push(newRefreshJti!);
+      JwtService.activeRefreshTokens.set(userId, activeTokens);
+      <% } %>
+      res.json({ accessToken: newAccessToken, refreshToken: newRefreshToken });
+    } catch (error) {
+      logger.error('Refresh token error:', error);
+      next(error);
+    }
+  }
+
+  async logout(req: Request, res: Response, next: NextFunction) {
+    try {
+      const authHeader = req.headers.authorization;
+      if (!authHeader) {
+        return res.status(HTTP_STATUS.BAD_REQUEST).json({ message: 'No token provided' });
+      }
+
+      const accessTokenStr = authHeader.split(' ')[1];
+      const decodedAccess = JwtService.decodeToken(accessTokenStr);
+      
+      if (decodedAccess && decodedAccess.jti && decodedAccess.exp) {
+        const remainingTime = Math.max(0, decodedAccess.exp - Math.floor(Date.now() / 1000));
+<%_ if (caching !== 'None') { -%>
+        if (remainingTime > 0) {
+            await cacheService.set(`blacklist:${decodedAccess.jti}`, true, remainingTime);
+        }
+<% } else { %>
+        if (remainingTime > 0) {
+            JwtService.blacklistedTokens.set(decodedAccess.jti, Date.now() + remainingTime * 1000);
+        }
+<%_ } -%>
+      }
+
+      const { refreshToken } = req.body;
+      if (refreshToken) {
+        const decodedRefresh = JwtService.decodeToken(refreshToken);
+        if (decodedRefresh && decodedRefresh.id && decodedRefresh.jti) {
+           const userId = String(decodedRefresh.id);
+           <%_ if (caching !== 'None') { -%>
+           const cacheKey = `refresh_tokens:${userId}`;
+           let activeTokens = await cacheService.get<string[]>(cacheKey) || [];
+           activeTokens = activeTokens.filter(t => t !== decodedRefresh.jti);
+           await cacheService.set(cacheKey, activeTokens, 7 * 24 * 60 * 60);
+           <% } else { %>
+           let activeTokens = JwtService.activeRefreshTokens.get(userId) || [];
+           activeTokens = activeTokens.filter(t => t !== decodedRefresh.jti);
+           JwtService.activeRefreshTokens.set(userId, activeTokens);<% } %>
+        }
+      }
+
+      res.json({ message: 'Logged out successfully' });
+    } catch (error) {
+      logger.error('Logout error:', error);
+      next(error);
+    }
+  }
+}

package/templates/common/auth/ts/middleware/authMiddleware.spec.ts.ejs

@@ -0,0 +1,128 @@
+<%_ if (architecture === 'Clean Architecture') { _%>
+import { authMiddleware } from '@/infrastructure/webserver/middleware/authMiddleware';
+import { JwtService } from '@/infrastructure/auth/jwtService';
+<%_ } else { _%>
+import { authMiddleware } from '@/middleware/authMiddleware';
+import { JwtService } from '@/services/jwtService';
+<%_ } _%>
+import { HTTP_STATUS } from '@/utils/httpCodes';
+import { Request, Response, NextFunction } from 'express';
+
+<%_ if (architecture === 'Clean Architecture') { _%>
+jest.mock('@/infrastructure/auth/jwtService');
+<%_ } else { _%>
+jest.mock('@/services/jwtService');
+<%_ } _%>
+
+<%_ if (caching !== 'None') { _%>
+<%_ const cachePath = (architecture === "MVC") ? (caching === "Redis" ? "@/config/redisClient" : "@/config/memoryCache") : (caching === "Redis" ? "@/infrastructure/caching/redisClient" : "@/infrastructure/caching/memoryCache"); _%>
+jest.mock('<%= cachePath %>', () => ({
+  __esModule: true,
+  default: {
+    get: jest.fn(),
+    set: jest.fn(),
+    del: jest.fn()
+  }
+}), { virtual: true });
+import cacheService from '<%= cachePath %>';
+<%_ } _%>
+
+describe('AuthMiddleware', () => {
+  let mockRequest: any;
+  let mockResponse: any;
+  const nextFunction: NextFunction = jest.fn();
+
+  beforeEach(() => {
+    mockRequest = {
+      headers: {}
+    };
+    mockResponse = {
+      status: jest.fn().mockReturnThis(),
+      json: jest.fn()
+    };
+    jest.clearAllMocks();
+  });
+
+  it('should return 401 if no authorization header is provided', async () => {
+    await authMiddleware(mockRequest as Request, mockResponse as Response, nextFunction);
+
+    expect(mockResponse.status).toHaveBeenCalledWith(HTTP_STATUS.UNAUTHORIZED);
+    expect(mockResponse.json).toHaveBeenCalledWith({ message: 'No token provided' });
+    expect(nextFunction).not.toHaveBeenCalled();
+  });
+
+  it('should return 401 if token is invalid', async () => {
+    mockRequest.headers.authorization = 'Bearer invalid-token';
+    (JwtService.verifyToken as jest.Mock).mockReturnValue(null);
+
+    await authMiddleware(mockRequest as Request, mockResponse as Response, nextFunction);
+
+    expect(mockResponse.status).toHaveBeenCalledWith(HTTP_STATUS.UNAUTHORIZED);
+    expect(mockResponse.json).toHaveBeenCalledWith({ message: 'Invalid or expired token' });
+    expect(nextFunction).not.toHaveBeenCalled();
+  });
+
+  it('should return 401 if token is blacklisted', async () => {
+    const payload = { id: 1, email: 'test@example.com', jti: 'blacklisted-jti' };
+    mockRequest.headers.authorization = 'Bearer valid-token';
+    (JwtService.verifyToken as jest.Mock).mockReturnValue(payload);
+    
+    // Mock the blacklist check
+    <% if (caching !== 'None') { %>
+    (cacheService.get as jest.Mock).mockResolvedValue(true);
+    <% } else { %>
+    JwtService.blacklistedTokens.set('blacklisted-jti', Date.now() + 10000);
+    <% } %>
+
+    await authMiddleware(mockRequest as Request, mockResponse as Response, nextFunction);
+
+    expect(mockResponse.status).toHaveBeenCalledWith(HTTP_STATUS.UNAUTHORIZED);
+    expect(mockResponse.json).toHaveBeenCalledWith({ message: 'Token revoked' });
+    expect(nextFunction).not.toHaveBeenCalled();
+  });
+
+  it('should return 401 if session is expired (sid not in activeTokens)', async () => {
+    const payload = { id: 1, email: 'test@example.com', jti: 'valid-jti', sid: 'expired-sid' };
+    mockRequest.headers.authorization = 'Bearer valid-token';
+    (JwtService.verifyToken as jest.Mock).mockReturnValue(payload);
+    
+    <% if (caching !== 'None') { %>
+    (cacheService.get as jest.Mock).mockImplementation((key: string) => {
+      if (key.startsWith('blacklist:')) return Promise.resolve(false);
+      if (key === 'refresh_tokens:1') return Promise.resolve(['other-sid']);
+      return Promise.resolve(null);
+    });
+    <% } else { %>
+    JwtService.blacklistedTokens.delete('valid-jti');
+    JwtService.activeRefreshTokens.set('1', ['other-sid']);
+    <% } %>
+
+    await authMiddleware(mockRequest as Request, mockResponse as Response, nextFunction);
+
+    expect(mockResponse.status).toHaveBeenCalledWith(HTTP_STATUS.UNAUTHORIZED);
+    expect(mockResponse.json).toHaveBeenCalledWith({ message: 'Session expired' });
+    expect(nextFunction).not.toHaveBeenCalled();
+  });
+
+  it('should call next() and set req.user if token is valid, not blacklisted and session is active', async () => {
+    const payload = { id: 1, email: 'test@example.com', jti: 'valid-jti', sid: 'active-sid' };
+    mockRequest.headers.authorization = 'Bearer valid-token';
+    (JwtService.verifyToken as jest.Mock).mockReturnValue(payload);
+    
+    <% if (caching !== 'None') { %>
+    (cacheService.get as jest.Mock).mockImplementation((key: string) => {
+      if (key.startsWith('blacklist:')) return Promise.resolve(false);
+      if (key === 'refresh_tokens:1') return Promise.resolve(['active-sid']);
+      return Promise.resolve(null);
+    });
+    <% } else { %>
+    JwtService.blacklistedTokens.delete('valid-jti');
+    JwtService.activeRefreshTokens.set('1', ['active-sid']);
+    <% } %>
+
+    await authMiddleware(mockRequest as Request, mockResponse as Response, nextFunction);
+
+    expect(mockRequest.user).toEqual(payload);
+    expect(nextFunction).toHaveBeenCalled();
+  });
+});

package/templates/common/auth/ts/middleware/authMiddleware.ts.ejs

@@ -0,0 +1,59 @@
+import { Request, Response, NextFunction } from 'express';
+<% if (architecture === 'MVC') { %>
+import { JwtService, JwtPayload } from '@/services/jwtService';
+<% if (caching !== 'None') { -%>
+import cacheService from '<% if (caching === "Redis") { %>@/config/redisClient<% } else { %>@/config/memoryCache<% } %>';
+<% } -%>
+<% } else { %>
+import { JwtService, JwtPayload } from '@/infrastructure/auth/jwtService';
+<% if (caching !== 'None') { -%>
+import cacheService from '<% if (caching === "Redis") { %>@/infrastructure/caching/redisClient<% } else { %>@/infrastructure/caching/memoryCache<% } %>';
+<% } -%>
+<% } %>
+import { HTTP_STATUS } from '@/utils/httpCodes';
+
+interface CustomRequest extends Request {
+  user?: JwtPayload;
+}
+
+export const authMiddleware = async (req: CustomRequest, res: Response, next: NextFunction) => {
+  const authHeader = req.headers.authorization;
+
+  if (!authHeader || !authHeader.startsWith('Bearer ')) {
+    return res.status(HTTP_STATUS.UNAUTHORIZED).json({ message: 'No token provided' });
+  }
+
+  const token = authHeader.split(' ')[1];
+  const decoded = JwtService.verifyToken(token);
+
+  if (!decoded) {
+    return res.status(HTTP_STATUS.UNAUTHORIZED).json({ message: 'Invalid or expired token' });
+  }
+
+  if (decoded.jti) {
+    <%_ if (caching !== 'None') { -%>
+    const isBlacklisted = await cacheService.get(`blacklist:${decoded.jti}`);
+    if (isBlacklisted) {
+      return res.status(HTTP_STATUS.UNAUTHORIZED).json({ message: 'Token revoked' });
+    }<%_ } else { -%>
+    const expiryDate = JwtService.blacklistedTokens.get(decoded.jti);
+    if (expiryDate && Date.now() < expiryDate) {
+      return res.status(HTTP_STATUS.UNAUTHORIZED).json({ message: 'Token revoked' });
+    }<% } %>
+  }
+
+  if (decoded.sid) {
+    <%_ if (caching !== 'None') { -%>
+    const activeTokens = await cacheService.get<string[]>(`refresh_tokens:${decoded.id}`) || [];
+    if (!activeTokens.includes(decoded.sid)) {
+      return res.status(HTTP_STATUS.UNAUTHORIZED).json({ message: 'Session expired' });
+    }<%_ } else { -%>
+    const activeTokens = JwtService.activeRefreshTokens.get(String(decoded.id)) || [];
+    if (!activeTokens.includes(decoded.sid)) {
+      return res.status(HTTP_STATUS.UNAUTHORIZED).json({ message: 'Session expired' });
+    }<% } %>
+  }
+
+  req.user = decoded;
+  next();
+};

package/templates/common/auth/ts/routes/authRoutes.ts.ejs

@@ -0,0 +1,20 @@
+import { Router } from 'express';
+<%_ if (architecture === 'MVC') { -%>
+import { AuthController } from '@/controllers/authController';
+<%_ } else { -%>
+import { AuthController } from '@/interfaces/controllers/auth/authController';
+<%_ } -%>
+<%_ if (architecture === 'MVC') { -%>
+import { authMiddleware } from '@/middleware/authMiddleware';
+<%_ } else { -%>
+import { authMiddleware } from '@/infrastructure/webserver/middleware/authMiddleware';
+<%_ } -%>
+
+const router = Router();
+const authController = new AuthController();
+
+router.post('/login', (req, res, next) => authController.login(req, res, next));
+router.post('/refresh', (req, res, next) => authController.refresh(req, res, next));
+router.post('/logout', authMiddleware, (req, res, next) => authController.logout(req, res, next));
+
+export default router;

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

@@ -0,0 +1,89 @@
+<% if (architecture === 'Clean Architecture') { -%>
+import { JwtService } from '@/infrastructure/auth/jwtService';
+<% } else { -%>
+import { JwtService } from '@/services/jwtService';
+<% } -%>
+import jwt from 'jsonwebtoken';
+
+jest.mock('jsonwebtoken');
+jest.mock('@/config/env', () => ({
+  env: {
+    JWT_SECRET: 'test-secret',
+    JWT_REFRESH_SECRET: 'test-refresh-secret',
+    JWT_EXPIRES_IN: '15m'
+  }
+}));
+
+describe('JwtService', () => {
+  const secret = 'test-secret';
+  const refreshSecret = 'test-refresh-secret';
+  const payload = { id: 1, email: 'test@example.com' };
+  const token = 'mock-token';
+
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  describe('generateToken', () => {
+    it('should generate a token with standard expiration and jti', () => {
+      (jwt.sign as jest.Mock).mockReturnValue(token);
+
+      const result = JwtService.generateToken(payload);
+
+      expect(jwt.sign).toHaveBeenCalledWith(
+        expect.objectContaining({ ...payload, jti: expect.any(String) }),
+        secret,
+        { expiresIn: '15m' }
+      );
+      expect(result).toBe(token);
+    });
+  });
+
+  describe('generateRefreshToken', () => {
+    it('should generate a refresh token with refresh secret and jti', () => {
+      (jwt.sign as jest.Mock).mockReturnValue(token);
+
+      const result = JwtService.generateRefreshToken(payload);
+
+      expect(jwt.sign).toHaveBeenCalledWith(
+        expect.objectContaining({ ...payload, jti: expect.any(String) }),
+        refreshSecret,
+        { expiresIn: '7d' }
+      );
+      expect(result).toBe(token);
+    });
+  });
+
+  describe('verifyToken', () => {
+    it('should return decoded payload for a valid token', () => {
+      (jwt.verify as jest.Mock).mockReturnValue(payload);
+
+      const result = JwtService.verifyToken(token);
+
+      expect(jwt.verify).toHaveBeenCalledWith(token, secret);
+      expect(result).toEqual(payload);
+    });
+  });
+
+  describe('verifyRefreshToken', () => {
+    it('should return decoded payload for a valid refresh token', () => {
+      (jwt.verify as jest.Mock).mockReturnValue(payload);
+
+      const result = JwtService.verifyRefreshToken(token);
+
+      expect(jwt.verify).toHaveBeenCalledWith(token, refreshSecret);
+      expect(result).toEqual(payload);
+    });
+  });
+
+  describe('decodeToken', () => {
+    it('should return decoded payload without verification', () => {
+      (jwt.decode as jest.Mock).mockReturnValue(payload);
+
+      const result = JwtService.decodeToken(token);
+
+      expect(jwt.decode).toHaveBeenCalledWith(token);
+      expect(result).toEqual(payload);
+    });
+  });
+});