O plugin do CLI

É o mesmo mecanismo que o próprio plugin de CLI do @nestjs/swagger usa para funcionar sob webpack: true. É por isso que @ApiProperty() não é necessário em toda propriedade de DTO mesmo em um build webpack. O Nest CLI alimenta um hook de plugin de compilador TypeScript (compilerOptions.plugins) tanto no builder tsc quanto no webpack (ts-loader), de forma idêntica.

Registre o plugin

Registre o nestjs-docfy no nest-cli.json:

{
  "compilerOptions": {
    "webpack": true,
    "plugins": ["nestjs-docfy"]
  }
}

import { applyDocfyMetadata } from 'nestjs-docfy';

const document = SwaggerModule.createDocument(app, config);
SwaggerModule.setup('api', app, applyDocfyMetadata(document));

Detecção automática

É fácil esquecer de registrar o plugin até um build sair sem documentação, então toda execução de generate já lê o nest-cli.json e imprime um aviso quando webpack: true está configurado sem o plugin. Passe --register-plugin pra corrigir isso automaticamente em vez de editar o arquivo à mão:

npx nestjs-docfy generate --register-plugin

Isso é opt-in de propósito, já que alguns times ficam deliberadamente com o patch-spec em vez de um plugin de compilador, então o generate nunca edita o nest-cli.json a menos que você peça explicitamente. Ele adiciona ao array compilerOptions.plugins já existente (reconhecendo entradas tanto em string quanto em objeto como já registradas) e respeita --dry-run.

Como funciona

O plugin do nestjs-docfy não reescreve nenhuma sintaxe de decorator nem toca na AST. A cada compilação, ele roda de novo a mesma análise estática que generate/check/patch-spec já fazem (via ts-morph, na árvore de source, não no bundle) e escreve o patch resultante em docfy-metadata.json ao lado do output do build.

Aí, logo após SwaggerModule.createDocument(), o applyDocfyMetadata() lê esse arquivo e mescla nele. Não há require.cache envolvido nem problema de identidade de classe de bundle, porque nunca precisa da app em execução pra calcular nada.

vs. patch-spec