Funktioniert es mit webpack: true in nest-cli.json?

Antwort

Ja: Registriere nestjs-docfy in compilerOptions.plugins von nest-cli.json und ruf applyDocfyMetadata(document) direkt nach SwaggerModule.createDocument() auf. Das ist derselbe Mechanismus, den auch das eigene CLI-Plugin von @nestjs/swagger nutzt, um unter Webpack zu funktionieren, und es behebt die zugrunde liegende Einschränkung an der Wurzel, statt sie zu umgehen: Runtime-Discovery (DocfyModule, ohne das Plugin) funktioniert weiterhin nicht, da sie von require.cache abhängt und Webpack alles in ein einziges Bundle inlined, ohne je einen Eintrag pro ursprünglicher Quelldatei zu befüllen. Siehe Das CLI-Plugin.

Was ist mit dem SWC-Builder?

Ja, aber es braucht "typeCheck": true zusammen mit "builder": "swc" — unter SWC ruft @nestjs/cli Plugins nur über einen anderen Hook auf, der an aktiviertes Type-Checking gekoppelt ist. Ohne das bleibt das Plugin stumm: der Build läuft trotzdem durch, nur ohne erzeugtes docfy-metadata.json. Vollständige Erklärung im Abschnitt SWC-Builder der Plugin-Anleitung.