feat: nest v11 support, latest testing tooling (#457)

Author: MrMaz

.eslintrc.js

@@ -9,7 +9,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [18.x]
+        node-version: [20.x]
     steps:
       - uses: actions/checkout@v2
       - name: Enable Corepack

.github/workflows/ci-merge.yml

@@ -10,7 +10,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [18.x]
+        node-version: [20.x]
 
     steps:
       - uses: actions/checkout@v2

.github/workflows/ci-pr-test.yml

@@ -0,0 +1,3 @@
+import config from '@concepta/prettier-config/node';
+
+export default config;

.prettierrc.js

@@ -0,0 +1,109 @@
+// @ts-check
+import conceptaConfig from '@concepta/eslint-config/nest';
+import tseslint from 'typescript-eslint';
+import importPlugin from 'eslint-plugin-import';
+import tsdocPlugin from 'eslint-plugin-tsdoc';
+import jsdocPlugin from 'eslint-plugin-jsdoc';
+
+export default tseslint.config(
+  // Ignore patterns
+  {
+    ignores: [
+      'packages/*/dist/**',
+      '**/node_modules/**',
+      '**/.eslintrc.js',
+      '**/.eslintrc.spec.js',
+      '**/tsconfig.json',
+      '**/tsconfig.eslint.json',
+      '**/commitlint.config.js',
+    ],
+  },
+
+  // Extend @concepta/eslint-config/nest (filter out undefined configs)
+  ...conceptaConfig.filter(config => config !== undefined),
+
+  // JSDoc recommended config
+  jsdocPlugin.configs['flat/recommended-typescript'],
+
+  // Project-specific overrides
+  {
+    languageOptions: {
+      parserOptions: {
+        project: './tsconfig.eslint.json',
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+    plugins: {
+      import: importPlugin,
+      tsdoc: tsdocPlugin,
+    },
+    settings: {
+      jsdoc: {
+        mode: 'typescript',
+      },
+    },
+    rules: {
+      // Import rules
+      'import/no-duplicates': 'error',
+      'import/no-extraneous-dependencies': 'error',
+      // Project-specific import order with @nestjs and @concepta path groups
+      'import/order': [
+        'error',
+        {
+          pathGroups: [
+            {
+              pattern: '@nestjs/**',
+              group: 'external',
+              position: 'after',
+            },
+            {
+              pattern: '@concepta/**',
+              group: 'external',
+              position: 'after',
+            },
+            {
+              pattern: '{./__fixtures__/**,../__fixtures__/**}',
+              group: 'sibling',
+              position: 'after',
+            },
+          ],
+          alphabetize: {
+            order: 'asc',
+            caseInsensitive: false,
+          },
+          pathGroupsExcludedImportTypes: ['builtin', 'object'],
+          'newlines-between': 'always',
+        },
+      ],
+
+      // NestJS typed rules
+      '@darraghor/nestjs-typed/param-decorator-name-matches-route-param': 'off',
+      '@darraghor/nestjs-typed/injectable-should-be-provided': 'off',
+
+      // JSDoc/TSDoc rules
+      'jsdoc/tag-lines': ['error', 'any', { startLines: 1 }],
+      'tsdoc/syntax': 'error',
+    },
+  },
+
+  // TypeScript files override
+  {
+    files: ['**/*.ts'],
+    rules: {
+      'jsdoc/require-jsdoc': 'off',
+      'jsdoc/require-param': 'off',
+      'jsdoc/require-returns': 'off',
+    },
+  },
+
+  // Spec and fixture files override
+  {
+    files: ['**/*.spec.ts', '**/*.fixture.ts'],
+    rules: {
+      '@darraghor/nestjs-typed/controllers-should-supply-api-tags': 'off',
+      '@darraghor/nestjs-typed/api-method-should-specify-api-response': 'off',
+      'jsdoc/tag-lines': 'off',
+      'tsdoc/syntax': 'off',
+    },
+  },
+);

.prettierrc.mjs

@@ -5,7 +5,7 @@
       "tsconfig": "tsconfig.jest.json"
     }
   },
-  "setupFilesAfterEnv": ["jest-extended/all"],
+  "setupFilesAfterEnv": ["<rootDir>/jest.setup.js", "jest-extended/all"],
   "coverageThreshold": {
     "global": {
       "branches": 0,

eslint.config.mjs

@@ -0,0 +1,3 @@
+// Make Node.js crypto module available globally for tests
+// This is needed for @nestjs/typeorm v11 which expects crypto to be global
+global.crypto = require('crypto');

jest.config.json

@@ -3,57 +3,61 @@
   "version": "7.0.0-alpha.9",
   "license": "BSD-3-Clause",
   "private": true,
+  "engines": {
+    "node": ">=20.0.0",
+    "yarn": ">=4.0.0"
+  },
   "workspaces": {
     "packages": [
       "packages/*"
     ]
   },
   "devDependencies": {
-    "@commitlint/cli": "^19.4.0",
-    "@commitlint/config-conventional": "^19.2.2",
-    "@concepta/eslint-config": "^1.1.4",
-    "@concepta/prettier-config": "^1.1.4",
-    "@darraghor/eslint-plugin-nestjs-typed": "^3.22.6",
-    "@nestjs/cli": "^10.4.4",
-    "@nestjs/schematics": "^10.1.3",
-    "@nestjs/testing": "^10.4.1",
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
+    "@concepta/eslint-config": "2.0.0-alpha.4",
+    "@concepta/prettier-config": "2.0.0-alpha.4",
+    "@darraghor/eslint-plugin-nestjs-typed": "^6.9.3",
+    "@eslint/js": "^9.39.1",
+    "@nestjs/cli": "^11.0.10",
+    "@nestjs/schematics": "^11.0.9",
+    "@nestjs/testing": "^11.1.9",
     "@types/express": "^4.17.21",
     "@types/jest": "^27.5.2",
-    "@types/node": "^18.19.44",
+    "@types/node": "^20.19.25",
     "@types/nodemailer": "^6.4.15",
-    "@types/supertest": "^2.0.16",
-    "@typescript-eslint/eslint-plugin": "^5.62.0",
-    "@typescript-eslint/parser": "^5.62.0",
+    "@types/supertest": "^6.0.3",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.1",
-    "eslint": "^8.57.0",
-    "eslint-config-prettier": "^8.10.0",
-    "eslint-plugin-import": "^2.31.0",
-    "eslint-plugin-jsdoc": "^48.11.0",
-    "eslint-plugin-node": "^11.1.0",
-    "eslint-plugin-prettier": "^4.2.1",
-    "eslint-plugin-tsdoc": "^0.3.0",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-jsdoc": "^61.2.1",
+    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-tsdoc": "^0.5.0",
+    "globals": "^16.5.0",
     "husky": "^7.0.4",
-    "jest": "27.5.1",
+    "jest": "30.2.0",
     "jest-junit": "^13.2.0",
-    "jest-mock-extended": "^2.0.9",
-    "jsonc-eslint-parser": "^2.4.0",
+    "jest-mock-extended": "^4.0.0",
+    "jsonc-eslint-parser": "^2.4.1",
     "lerna": "^3.22.1",
     "markdownlint-cli": "^0.41.0",
-    "prettier": "^2.8.8",
+    "prettier": "^3.6.2",
     "reflect-metadata": "^0.1.14",
     "rimraf": "^3.0.2",
     "rxjs": "^7.8.1",
     "standard-version": "^9.5.0",
     "supertest": "^6.3.4",
-    "ts-jest": "^27.1.5",
-    "ts-loader": "^9.5.1",
+    "ts-jest": "^29.4.5",
+    "ts-loader": "^9.5.4",
     "ts-node": "^10.9.2",
     "tsconfig-paths": "^3.15.0",
     "typedoc": "^0.25.13",
     "typedoc-plugin-coverage": "^3.3.0",
-    "typeorm": "^0.3.20",
-    "typescript": "^4.9.5"
+    "typeorm": "^0.3.27",
+    "typescript": "^4.9.5",
+    "typescript-eslint": "^8.46.4"
   },
   "scripts": {
     "postinstall": "husky install",
@@ -80,5 +84,5 @@
     "changelog:patch": "standard-version --release-as patch",
     "changelog:major": "standard-version --release-as major"
   },
-  "packageManager": "yarn@4.4.0"
+  "packageManager": "yarn@4.11.0"
 }

jest.setup.js

@@ -13,17 +13,17 @@
   ],
   "dependencies": {
     "@concepta/nestjs-common": "^7.0.0-alpha.9",
-    "@nestjs/common": "^10.4.1",
-    "@nestjs/config": "^3.2.3",
-    "@nestjs/core": "^10.4.1",
+    "@nestjs/common": "^11.1.9",
+    "@nestjs/config": "^4.0.2",
+    "@nestjs/core": "^11.1.9",
     "accesscontrol": "^2.2.1",
     "rxjs": "^7.8.1"
   },
   "devDependencies": {
-    "@nestjs/swagger": "^7.4.0",
-    "@nestjs/testing": "^10.4.1",
-    "@types/supertest": "^2.0.16",
-    "jest-mock-extended": "^2.0.9",
+    "@nestjs/swagger": "^11.2.2",
+    "@nestjs/testing": "^11.1.9",
+    "@types/supertest": "^6.0.3",
+    "jest-mock-extended": "^4.0.0",
     "supertest": "^6.3.4"
   }
 }