jsdoc; fix async handlers; fix custom decorator unexpected validation

Author: rhyek

.github/workflows/pr.yaml

@@ -28,8 +28,8 @@ jobs:
           export NODE_OPTIONS="--max_old_space_size=4096"
           echo "$changed" | xargs pnpm eslint --max-warnings=0 --no-warn-ignored
       - name: Build
-        run: ./build.sh
+        run: ./scripts/build.sh
       - name: E2E tests
-        run: ./test.sh
+        run: ./scripts/test.sh
         env:
           FORCE_COLOR: true

.github/workflows/release.yaml

@@ -27,7 +27,7 @@ jobs:
           npm version "$version" --no-git-tag-version
 
       - name: Build package
-        run: ./build.sh
+        run: ./scripts/build.sh
 
       - run: cp README.md ./packages/nestjs-endpoints/README.md
 

.npmrc

@@ -0,0 +1 @@
+auto-install-peers=false # default is true

.vscode/settings.json

@@ -5,8 +5,11 @@
   "editor.formatOnPaste": true,
   "editor.formatOnSave": true,
   "editor.formatOnSaveMode": "file", // required to format on save
-  "eslint.rules.customizations": [{ "rule": "prettier/*", "severity": "off" }],
+  "eslint.rules.customizations": [
+    { "rule": "prettier/*", "severity": "off" }
+  ],
   "[typescript]": {
     "editor.defaultFormatter": "dbaeumer.vscode-eslint"
-  }
+  },
+  "typescript.preferences.importModuleSpecifier": "relative"
 }

build.sh

@@ -10,7 +10,9 @@ export default tseslint.config(
     ignores: [
       '**/node_modules',
       '**/dist',
-      'packages/!(nestjs-endpoints)/**',
+      'packages/*',
+      '!packages/nestjs-endpoints/',
+      '!packages/test-app-express-cjs/',
     ],
   },
   eslint.configs.recommended,
@@ -63,6 +65,16 @@ export default tseslint.config(
         },
       ],
       '@typescript-eslint/no-unsafe-assignment': 'off',
+      '@typescript-eslint/no-unsafe-argument': 'off',
+      '@typescript-eslint/no-unsafe-member-access': 'off',
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-unsafe-call': 'off',
+    },
+  },
+  {
+    files: ['packages/nestjs-endpoints/**'],
+    rules: {
+      'no-console': 'error',
     },
   },
 );

eslint.config.js

@@ -4,18 +4,23 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "test": "./test.sh"
+    "test": "./scripts/test.sh",
+    "dev": "pnpm --filter nestjs-endpoints --filter test-app-express-cjs run --parallel dev"
   },
   "devDependencies": {
     "@eslint/js": "^9.20.0",
+    "@nestjs/common": "^11.0.8",
+    "@nestjs/core": "^11.0.8",
+    "@nestjs/swagger": "^11.0.3",
     "@types/node": "^22.13.1",
     "@typescript-eslint/parser": "^8.23.0",
-    "eslint": "^8.42.0",
+    "eslint": "^9.20.1",
     "eslint-config-prettier": "^9.0.0",
     "eslint-plugin-import": "^2.31.0",
     "eslint-plugin-prettier": "^5.0.0",
     "eslint-plugin-unused-imports": "^4.1.4",
     "prettier": "^3.0.0",
-    "typescript-eslint": "^8.23.0"
+    "typescript-eslint": "^8.24.0",
+    "zod": "^3.24.1"
   }
 }

package.json

@@ -26,25 +26,21 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "scripts": {
-    "dev": "tsc --watch",
+    "dev": "tsc --watch --preserveWatchOutput",
     "build": "tsc"
   },
   "dependencies": {
     "callsites": "^3.1.0",
     "nestjs-zod": "^4.2.0"
   },
   "peerDependencies": {
-    "@nestjs/common": ">=11.0.0",
-    "@nestjs/core": ">=11.0.0",
-    "@nestjs/swagger": ">=11.0.0",
-    "zod": ">=3.24.1"
+    "@nestjs/common": ">=10.0.0",
+    "@nestjs/core": ">=10.0.0",
+    "@nestjs/swagger": ">=7.0.0",
+    "zod": ">=3.0.0"
   },
   "devDependencies": {
-    "@nestjs/common": "^11.0.0",
-    "@nestjs/core": "^11.0.0",
-    "@nestjs/swagger": "^11.0.0",
     "@types/node": "^22.13.1",
-    "typescript": "^5.7.3",
-    "zod": "^3.24.1"
+    "typescript": "^5.7.3"
   }
 }

packages/nestjs-endpoints/package.json

@@ -2,7 +2,7 @@ import { Module, ModuleMetadata, Type } from '@nestjs/common';
 
 export function EndpointsModule(
   metadata: Omit<ModuleMetadata, 'controllers'> & {
-    endpoints: Type[];
+    endpoints?: Type[];
   },
 ): ClassDecorator {
   const { endpoints = [], ...rest } = metadata;