patch-spec : alternative manuelle pour webpack: true

Si tu préfères ne pas ajouter de plugin de compilateur, applique les fichiers docs à la compilation, à la main.

Préfère le plugin CLI, sauf si tu as une raison de ne pas le faire

Le plugin CLI fait la même chose automatiquement, à chaque build. Utilise patch-spec (ci-dessous) à la place si tu préfères ne pas ajouter de plugin de compilateur, par exemple un pipeline de build qui n'est pas le CLI Nest, ou une politique plus stricte sur ce qui s'exécute pendant la compilation.

Pourquoi c'est nécessaire

Avec "webpack": true dans nest-cli.json (la valeur par défaut documentée pour les monorepos avec plusieurs apps), la découverte runtime de DocfyModule ne fonctionne pas : webpack regroupe tout dans un seul bundle et ne remplit jamais require.cache avec une entrée par fichier source d'origine, ce dont dépend cette découverte. C'est architectural, pas un bug corrigeable. Voir mode strict & webpack.

Pipeline

bash

# 1. Démarre l'app juste pour obtenir le /api-json en direct
node dist/main.js &

# 2. Génère un document OpenAPI avec tous les fichiers docs déjà appliqués
npx nestjs-docfy patch-spec --spec http://localhost:3000/api-json --out openapi.patched.json

# 3. Sers le document patché via DocfyUiModule
#    DocfyUiModule.setup('/docs', app, { staticSpecPath: './openapi.patched.json' });

Appelle DocfyUiModule.setup() avant SwaggerModule.setup() pour que le /api-json statique prenne le pas sur celui en direct.