@mkappelhof/ts-config 2.0.1 → 2.1.0

package/AGENTS.md

@@ -11,6 +11,7 @@ Check `extends` in the project's `tsconfig.json`:
 | `@mkappelhof/ts-config/next.json` | Next.js apps | ESM, bundler resolution, type-check only (`noEmit`) |
 | `@mkappelhof/ts-config/react.json` | React apps and libraries built with a bundler (Vite, etc.) | ESM, bundler resolution, type-check only (`noEmit`) |
 | `@mkappelhof/ts-config/node.json` | Node.js 24+ services, scripts and CLIs | Native Node ESM (`NodeNext`) |
+| `@mkappelhof/ts-config/nest.json` | NestJS services | CommonJS, legacy decorators (`experimentalDecorators`, `emitDecoratorMetadata`) |
 | `@mkappelhof/ts-config/library.json` | React libraries built with a bundler that publish type declarations | ESM, bundler resolution, declaration emit only (`emitDeclarationOnly`) |
 | `@mkappelhof/ts-config/astro.json` | Astro sites and apps | ESM, bundler resolution, type-check only (`noEmit`), `jsx: "preserve"` |
 
@@ -52,6 +53,12 @@ Check `extends` in the project's `tsconfig.json`:
 - Top-level `await` is allowed.
 - `@types/node` must be installed. It is the only ambient types package loaded (`"types": ["node"]`); add others to `types` in the project's `tsconfig.json`.
 
+## nest.json
+
+- CommonJS, not ESM: `module`/`moduleResolution` are `commonjs`/`node`. Use `require`/`module.exports` semantics via `import`/`export` as Nest's CLI generates them; there's no `"type": "module"` requirement and no file-extension-in-import rule.
+- `experimentalDecorators` and `emitDecoratorMetadata` are on, and `erasableSyntaxOnly`/`verbatimModuleSyntax` are off (unlike every other preset in this package). Parameter properties (`constructor(private readonly foo: FooService) {}`) and decorators (`@Injectable()`, `@Controller()`, etc.) are expected and fine to use here — this is the one preset where that's true.
+- Run `nest build` (or `tsc -p tsconfig.build.json` if the project has one) to compile; don't switch the project to `tsc --noEmit`-only workflows.
+
 ## astro.json
 
 - `jsx` is `"preserve"`, not `"react-jsx"`. `.astro` files are their own syntax, compiled by the Astro compiler, not `tsc`; this setting only matters for `.tsx` islands (e.g. from `@astrojs/react`), and Astro's Vite plugin handles their actual JSX transform regardless of this setting.

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @mkappelhof/ts-config
 
+## 2.1.0
+
+### Minor Changes
+
+- 3c4c6b4: Add `nest.json` preset for NestJS services: CommonJS, `experimentalDecorators`/`emitDecoratorMetadata` on, `erasableSyntaxOnly`/`verbatimModuleSyntax` off so parameter properties and decorator-based DI work.
+
 ## 2.0.1
 
 ### Patch Changes

package/README.md

@@ -7,6 +7,7 @@ Shared `tsconfig.json` presets for TypeScript 6 and 7.
 | `@mkappelhof/ts-config/next.json` | Next.js applications |
 | `@mkappelhof/ts-config/react.json` | React apps and libraries built with a bundler (Vite, Rsbuild, etc.) |
 | `@mkappelhof/ts-config/node.json` | Node.js 24+ services, scripts and CLIs (native ESM) |
+| `@mkappelhof/ts-config/nest.json` | NestJS services (CommonJS, legacy decorators) |
 | `@mkappelhof/ts-config/library.json` | React libraries built with a bundler that publish type declarations |
 | `@mkappelhof/ts-config/astro.json` | Astro sites and apps |
 
@@ -83,6 +84,25 @@ Set `"type": "module"` in your `package.json`, then:
 
 The code only uses erasable TypeScript syntax, so you can run it directly with `node src/index.ts` or compile it with `tsc`. Relative imports must include an extension (`./util.ts`), which is rewritten to `.js` on emit.
 
+### NestJS
+
+```sh
+pnpm add -D @types/node
+```
+
+```JSON
+{
+  "extends": "@mkappelhof/ts-config/nest.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"]
+}
+```
+
+Unlike the other presets, this one stays on CommonJS and legacy decorators (`experimentalDecorators`, `emitDecoratorMetadata`) with `erasableSyntaxOnly` and `verbatimModuleSyntax` off, since Nest's constructor-based DI relies on parameter properties and decorator metadata. Build with `nest build` (or `tsc -p tsconfig.build.json`).
+
 ### Astro
 
 ```JSON

package/nest.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://www.schemastore.org/tsconfig",
+  "display": "NestJS",
+  "compilerOptions": {
+    "target": "ES2023",
+    "lib": [
+      "ES2023"
+    ],
+    "module": "commonjs",
+    "moduleResolution": "node",
+    "moduleDetection": "force",
+    "types": [
+      "node"
+    ],
+    "resolveJsonModule": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+    "noFallthroughCasesInSwitch": true,
+    "skipLibCheck": true
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mkappelhof/ts-config",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "main": "base.json",
   "license": "MIT",
   "repository": "git@github.com:mkappelhof/frontend-tools.git",