nodejs-quickstart-structure 1.18.1 → 1.19.1

package/templates/common/_github/workflows/ci.yml.ejs

@@ -1,46 +1,46 @@
-name: Node.js CI
-
-env:
-  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: 'true'
-
-on:
-  push:
-    branches: [ "main" ]
-  pull_request:
-    branches: [ "main" ]
-
-jobs:
-  build:
-
-    runs-on: ubuntu-latest
-
-    steps:
-    - uses: actions/checkout@v4
-    
-    - name: Use Node.js 22.x
-      uses: actions/setup-node@v4
-      with:
-        node-version: 22.x
-        cache: 'npm'
-        
-    - name: Install Dependencies
-      run: npm ci
-      
-    - name: Lint Code
-      run: npm run lint
-      
-    - name: Run Unit Tests
-      run: npm run test:coverage
-      
-    - name: Run E2E Tests
-      run: npm run test:e2e
-      
-    - name: Build
-      run: npm run build --if-present
-<% if (includeSecurity) { %>
-    - name: SonarQube Scan
-      uses: SonarSource/sonarqube-scan-action@master
-      env:
-        SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
-        SONAR_HOST_URL: ${{ secrets.SONAR_HOST_URL }}
-<% } %>
+name: Node.js CI
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: 'true'
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Use Node.js 22.x
+      uses: actions/setup-node@v4
+      with:
+        node-version: 22.x
+        cache: 'npm'
+        
+    - name: Install Dependencies
+      run: npm ci
+      
+    - name: Lint Code
+      run: npm run lint
+      
+    - name: Run Unit Tests
+      run: npm run test:coverage
+      
+    - name: Run E2E Tests
+      run: npm run test:e2e
+      
+    - name: Build
+      run: npm run build --if-present
+<% if (includeSecurity) { %>
+    - name: SonarQube Scan
+      uses: SonarSource/sonarqube-scan-action@master
+      env:
+        SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
+        SONAR_HOST_URL: ${{ secrets.SONAR_HOST_URL }}
+<% } %>

package/templates/common/_github/workflows/security.yml.ejs

@@ -1,36 +1,36 @@
-name: Enterprise Security Scan
-
-on:
-  push:
-    branches: [ "main" ]
-  pull_request:
-    branches: [ "main" ]
-  schedule:
-    - cron: '0 0 * * 1' # Weekly scan
-
-jobs:
-  node-security:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Run Snyk to check for vulnerabilities
-        uses: snyk/actions/node@master
-        env:
-          SNYK_TOKEN: ${{ secrets.SNYK_TOKEN }}
-        with:
-          args: --severity-threshold=high
-
-  container-security:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: Build Docker image
-        run: docker build -t <%= projectName %>:latest .
-      - name: Run Snyk to check Docker image for vulnerabilities
-        uses: snyk/actions/docker@master
-        env:
-          SNYK_TOKEN: ${{ secrets.SNYK_TOKEN }}
-        with:
-          image: <%= projectName %>:latest
-          args: --file=Dockerfile --severity-threshold=high --skip-unused-projects
+name: Enterprise Security Scan
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+  schedule:
+    - cron: '0 0 * * 1' # Weekly scan
+
+jobs:
+  node-security:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Run Snyk to check for vulnerabilities
+        uses: snyk/actions/node@master
+        env:
+          SNYK_TOKEN: ${{ secrets.SNYK_TOKEN }}
+        with:
+          args: --severity-threshold=high
+
+  container-security:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Build Docker image
+        run: docker build -t <%= projectName %>:latest .
+      - name: Run Snyk to check Docker image for vulnerabilities
+        uses: snyk/actions/docker@master
+        env:
+          SNYK_TOKEN: ${{ secrets.SNYK_TOKEN }}
+        with:
+          image: <%= projectName %>:latest
+          args: --file=Dockerfile --severity-threshold=high --skip-unused-projects

package/templates/common/_gitignore

@@ -1,5 +1,5 @@
-node_modules
-dist
-.env
-.DS_Store
-coverage
+node_modules
+dist
+.env
+.DS_Store
+coverage

package/templates/common/_husky/pre-commit

@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
-. "$(dirname -- "$0")/_/husky.sh"
-
-npx lint-staged
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+npx lint-staged

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

@@ -1,29 +1,29 @@
-const User = require('../domain/models/User');
-<%_ 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 CreateUser {
-    constructor(userRepository) {
-        this.userRepository = userRepository;
-    }
-
-    async execute(name, email) {
-        const user = new User(null, name, email);
-        const savedUser = await this.userRepository.save(user);
-
-        try {
-            await cacheService.del('users:all');
-            logger.info('Invalidated users:all cache');
-        } catch (error) {
-            logger.error('Cache error (del):', error);
-        }
-
-        return savedUser;
-    }
-}
-
-module.exports = CreateUser;
+const User = require('../domain/models/User');
+<%_ 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 CreateUser {
+    constructor(userRepository) {
+        this.userRepository = userRepository;
+    }
+
+    async execute(name, email) {
+        const user = new User(null, name, email);
+        const savedUser = await this.userRepository.save(user);
+
+        try {
+            await cacheService.del('users:all');
+            logger.info('Invalidated users:all cache');
+        } catch (error) {
+            logger.error('Cache error (del):', error);
+        }
+
+        return savedUser;
+    }
+}
+
+module.exports = CreateUser;

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

@@ -0,0 +1,27 @@
+<%_ 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 DeleteUser {
+    constructor(userRepository) {
+        this.userRepository = userRepository;
+    }
+
+    async execute(id) {
+        const result = await this.userRepository.delete(id);
+
+        try {
+            await cacheService.del('users:all');
+            logger.info('Invalidated users:all cache');
+        } catch (error) {
+             logger.error('Cache error (del):', error);
+        }
+
+        return result;
+    }
+}
+
+module.exports = DeleteUser;

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

@@ -1,37 +1,37 @@
-<%_ 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 GetAllUsers {
-    constructor(userRepository) {
-        this.userRepository = userRepository;
-    }
-
-    async execute() {
-        const cacheKey = 'users:all';
-        try {
-            const cachedUsers = await cacheService.get(cacheKey);
-            if (cachedUsers) {
-                logger.info('Serving users from cache');
-                return cachedUsers;
-            }
-        } catch (error) {
-            logger.error('Cache error (get):', error);
-        }
-
-        const users = await this.userRepository.getUsers();
-
-        try {
-            await cacheService.set(cacheKey, users, 60);
-        } catch (error) {
-            logger.error('Cache error (set):', error);
-        }
-
-        return users;
-    }
-}
-
-module.exports = GetAllUsers;
+<%_ 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 GetAllUsers {
+    constructor(userRepository) {
+        this.userRepository = userRepository;
+    }
+
+    async execute() {
+        const cacheKey = 'users:all';
+        try {
+            const cachedUsers = await cacheService.get(cacheKey);
+            if (cachedUsers) {
+                logger.info('Serving users from cache');
+                return cachedUsers;
+            }
+        } catch (error) {
+            logger.error('Cache error (get):', error);
+        }
+
+        const users = await this.userRepository.getUsers();
+
+        try {
+            await cacheService.set(cacheKey, users, 60);
+        } catch (error) {
+            logger.error('Cache error (set):', error);
+        }
+
+        return users;
+    }
+}
+
+module.exports = GetAllUsers;

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

@@ -0,0 +1,27 @@
+<%_ 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 UpdateUser {
+    constructor(userRepository) {
+        this.userRepository = userRepository;
+    }
+
+    async execute(id, data) {
+        const updatedUser = await this.userRepository.update(id, data);
+
+        try {
+            await cacheService.del('users:all');
+            logger.info('Invalidated users:all cache');
+        } catch (error) {
+            logger.error('Cache error (del):', error);
+        }
+
+        return updatedUser;
+    }
+}
+
+module.exports = UpdateUser;

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

@@ -1,27 +1,27 @@
-import { User } from '@/domain/user';
-
-import { UserRepository } from '@/infrastructure/repositories/UserRepository';
-<%_ if (caching === 'Redis') { -%>
-import cacheService from '@/infrastructure/caching/redisClient';
-<%_ } 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);
-        const savedUser = await this.userRepository.save(user);
-
-        try {
-            await cacheService.del('users:all');
-            logger.info('Invalidated users:all cache');
-        } catch (error) {
-            logger.error('Cache error (del):', error);
-        }
-
-        return savedUser;
-    }
-}
+import { User } from '@/domain/user';
+
+import { UserRepository } from '@/infrastructure/repositories/UserRepository';
+<%_ if (caching === 'Redis') { -%>
+import cacheService from '@/infrastructure/caching/redisClient';
+<%_ } 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);
+        const savedUser = await this.userRepository.save(user);
+
+        try {
+            await cacheService.del('users:all');
+            logger.info('Invalidated users:all cache');
+        } catch (error) {
+            logger.error('Cache error (del):', error);
+        }
+
+        return savedUser;
+    }
+}

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

@@ -0,0 +1,24 @@
+import { UserRepository } from '@/infrastructure/repositories/UserRepository';
+<%_ if (caching === 'Redis') { -%>
+import cacheService from '@/infrastructure/caching/redisClient';
+<%_ } else if (caching === 'Memory Cache') { -%>
+import cacheService from '@/infrastructure/caching/memoryCache';
+<%_ } -%>
+import logger from '@/infrastructure/log/logger';
+
+export default class DeleteUser {
+    constructor(private userRepository: UserRepository) {}
+
+    async execute(id: number | string) {
+        const result = await this.userRepository.delete(id);
+
+        try {
+            await cacheService.del('users:all');
+            logger.info('Invalidated users:all cache');
+        } catch (error) {
+            logger.error('Cache error (del):', error);
+        }
+
+        return result;
+    }
+}

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

@@ -1,34 +1,34 @@
-import { UserRepository } from '@/infrastructure/repositories/UserRepository';
-<%_ if (caching === 'Redis') { -%>
-import cacheService from '@/infrastructure/caching/redisClient';
-<%_ } else if (caching === 'Memory Cache') { -%>
-import cacheService from '@/infrastructure/caching/memoryCache';
-<%_ } -%>
-import logger from '@/infrastructure/log/logger';
-
-export default class GetAllUsers {
-    constructor(private userRepository: UserRepository) {}
-
-    async execute() {
-        const cacheKey = 'users:all';
-        try {
-            const cachedUsers = await cacheService.get(cacheKey);
-            if (cachedUsers) {
-                logger.info('Serving users from cache');
-                return cachedUsers;
-            }
-        } catch (error) {
-            logger.error('Cache error (get):', error);
-        }
-
-        const users = await this.userRepository.getUsers();
-
-        try {
-            await cacheService.set(cacheKey, users, 60);
-        } catch (error) {
-            logger.error('Cache error (set):', error);
-        }
-
-        return users;
-    }
-}
+import { UserRepository } from '@/infrastructure/repositories/UserRepository';
+<%_ if (caching === 'Redis') { -%>
+import cacheService from '@/infrastructure/caching/redisClient';
+<%_ } else if (caching === 'Memory Cache') { -%>
+import cacheService from '@/infrastructure/caching/memoryCache';
+<%_ } -%>
+import logger from '@/infrastructure/log/logger';
+
+export default class GetAllUsers {
+    constructor(private userRepository: UserRepository) {}
+
+    async execute() {
+        const cacheKey = 'users:all';
+        try {
+            const cachedUsers = await cacheService.get(cacheKey);
+            if (cachedUsers) {
+                logger.info('Serving users from cache');
+                return cachedUsers;
+            }
+        } catch (error) {
+            logger.error('Cache error (get):', error);
+        }
+
+        const users = await this.userRepository.getUsers();
+
+        try {
+            await cacheService.set(cacheKey, users, 60);
+        } catch (error) {
+            logger.error('Cache error (set):', error);
+        }
+
+        return users;
+    }
+}

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

@@ -0,0 +1,25 @@
+import { User } from '@/domain/user';
+import { UserRepository } from '@/infrastructure/repositories/UserRepository';
+<%_ if (caching === 'Redis') { -%>
+import cacheService from '@/infrastructure/caching/redisClient';
+<%_ } else if (caching === 'Memory Cache') { -%>
+import cacheService from '@/infrastructure/caching/memoryCache';
+<%_ } -%>
+import logger from '@/infrastructure/log/logger';
+
+export default class UpdateUser {
+    constructor(private userRepository: UserRepository) {}
+
+    async execute(id: number | string, data: { name?: string, email?: string }) {
+        const updatedUser = await this.userRepository.update(id, data);
+
+        try {
+            await cacheService.del('users:all');
+            logger.info('Invalidated users:all cache');
+        } catch (error) {
+            logger.error('Cache error (del):', error);
+        }
+
+        return updatedUser;
+    }
+}