tsconfig.json

{
  "compilerOptions": {
    // ── Output ──────────────────────────────────────────────────────────────
    "target": "ES2022",         // Modern JS — supports top-level await, etc.
    "module": "CommonJS",        // Node.js module system (require/exports)
    "outDir": "dist",            // Compiled JS lands here
    "rootDir": "src",            // Source lives here

    // ── Strict Mode (never turn these off) ──────────────────────────────────
    "strict": true,              // Master switch for all strict checks
    "noImplicitAny": true,       // Ban implicit 'any' types
    "strictNullChecks": true,    // null/undefined must be handled explicitly
    "noImplicitReturns": true,   // Every code path must return a value
    "noFallthroughCasesInSwitch": true,

    // ── Module Resolution ────────────────────────────────────────────────────
    "moduleResolution": "Node",
    "esModuleInterop": true,     // Allows: import express from 'express'
    "resolveJsonModule": true,   // Allows: import pkg from './package.json'
    "allowSyntheticDefaultImports": true,

    // ── Path Aliases ─────────────────────────────────────────────────────────
    // Instead of: import { env } from '../../../config/env'
    // You write:  import { env } from '@config/env'
    "baseUrl": ".",
    "paths": {
      "@/*":              ["src/*"],
      "@config/*":        ["src/config/*"],
      "@controllers/*":   ["src/controllers/*"],
      "@services/*":      ["src/services/*"],
      "@repositories/*":  ["src/repositories/*"],
      "@middlewares/*":   ["src/middlewares/*"],
      "@routes/*":        ["src/routes/*"],
      "@utils/*":         ["src/utils/*"],
      "@errors/*":        ["src/errors/*"],
      "@validations/*":   ["src/validations/*"],
      "@constants/*":     ["src/constants/*"],
      "@types/*":         ["src/types/*"]
    },

    // ── Quality & Output ─────────────────────────────────────────────────────
    "forceConsistentCasingInFileNames": true,
    "skipLibCheck": true,        // Skip type-checking node_modules (faster)
    "declaration": true,         // Emit .d.ts files
    "sourceMap": true            // Source maps for debugging
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist", "src/**/__tests__/**"]
}