@koalarx/nest 4.0.1 → 4.0.3

package/README.md

@@ -4,6 +4,8 @@ Facilitador para criar APIs NestJS com arquitetura DDD, focado em manutenção,
 
 Em vez de depender de uma biblioteca opaca, a CLI **copia módulos prontos para dentro do projeto** — abordagem semelhante ao [shadcn/ui](https://ui.shadcn.com). Você recebe código que pode ler, adaptar e manter sem amarras futuras.
 
+**Documentação:** [nest.koalarx.com](https://nest.koalarx.com/) (PT e EN)
+
 ## O que está disponível hoje
 
 | Recurso | Status |
@@ -14,8 +16,8 @@ Em vez de depender de uma biblioteca opaca, a CLI **copia módulos prontos para
 | Template **Exemplo de CRUD** (Person) | Disponível |
 | Autenticação (JWT, OAuth2) | Disponível na CLI |
 | API Key | Em breve |
-| Cache, health check, jobs internos | Disponível no template (exemplos Person) |
-| Comando `add` (módulos avulsos) | Em breve |
+| Cache, health check, jobs internos | Disponível via `new` e `add` |
+| Comando `add` (funcionalidades avulsas) | Disponível |
 
 ## Instalação e uso
 
@@ -57,11 +59,14 @@ npx @koalarx/nest@latest new
 | Comando | Descrição |
 | --- | --- |
 | `kl-nest new` | Cria um novo projeto (fluxo interativo) |
+| `kl-nest add` | Adiciona funcionalidades a um projeto existente |
 | `kl-nest version` | Exibe a versão da CLI |
 | `kl-nest help` | Lista comandos disponíveis |
 
 ```bash
 kl-nest new
+kl-nest add cache
+kl-nest add auth jwt health
 kl-nest version
 kl-nest --help
 
@@ -75,7 +80,22 @@ O comando `new` pergunta:
 - nome do projeto;
 - gerenciador de pacotes (`bun`, `npm` ou `pnpm` — Bun recomendado);
 - template (**Padrão** ou **Exemplo de CRUD**);
-- estratégia de autenticação (**JWT**, **OAuth2** ou nenhuma) e funcionalidades extras (opções futuras aparecem desabilitadas).
+- estratégia de autenticação (**JWT**, **OAuth2** ou nenhuma) e funcionalidades extras (cache, health, cron, eventos); **API Key** ainda aparece desabilitada no prompt;
+
+O comando `add` instala funcionalidades em um projeto Koala Nest já existente (detecta o que já está presente e pula duplicatas):
+
+- `auth jwt` / `auth oauth2` — autenticação
+- `cache` — cache Redis (com exemplos no template CRUD)
+- `health` — endpoint `GET /health`
+- `cron` — jobs com expressão cron
+- `events` — jobs reativos a eventos
+
+```bash
+cd meu-projeto
+kl-nest add cache
+kl-nest add auth jwt health --verbose
+kl-nest add cron events
+```
 
 ### Templates
 
@@ -115,7 +135,7 @@ Crie um `.env` na raiz do projeto gerado:
 ```env
 PORT=3000
 NODE_ENV=develop
-DATABASE_URL=postgres://user:password@localhost:5432/my_api
+DATABASE_URL=postgresql://user:password@localhost:5432/my_api
 ```
 
 ### Scripts úteis no projeto gerado
@@ -127,11 +147,14 @@ bun run migration:run      # aplica migrations pendentes
 bun run migration:revert   # reverte a última migration
 ```
 
-## Documentação para agentes de IA
+## Documentação
+
+Site completo: **[nest.koalarx.com](https://nest.koalarx.com/)** — guias de instalação, arquitetura DDD, autenticação, cache, jobs e fluxo CRUD (português e inglês).
 
-Índice de documentação otimizado para LLMs:
+### Índices para agentes de IA
 
-https://nest.koalarx.com/llm.txt
+- PT: https://nest.koalarx.com/llms.txt (alias: `/llm.txt`)
+- EN: https://nest.koalarx.com/llms-en.txt (alias: `/llm-en.txt`)
 
 ## Repositório (desenvolvimento)
 
@@ -151,8 +174,9 @@ O script `bun kl-nest` no `package.json` compila o projeto e executa a CLI a par
 koala-nest/
 ├── libs/
 │   ├── cli/          # código-fonte da CLI (kl-nest)
+│   ├── doc/          # markdown da documentação + site Angular
 │   └── koala-nest/   # templates copiados para projetos gerados
-├── scripts/          # build da CLI e dos templates
+├── scripts/          # build da CLI, docs e templates
 └── dist/             # saída do build (cli + koala-nest + package.json)
 ```
 
@@ -162,5 +186,6 @@ koala-nest/
 bun run build              # build completo (CLI + templates + dist/package.json)
 bun run build:cli          # apenas a CLI
 bun run build:koala-nest   # apenas os templates
-bun test                   # testes em libs/koala-nest
+bun run build:docs         # site de documentação
+bun test                   # testes do monorepo (CLI, lib, docs)
 ```

package/cli/utils/patch-infra-module.js

@@ -1,61 +1,81 @@
-export function patchInfraModuleForCache(content) {
-  if (content.includes("CacheServiceProvider")) {
-    return content;
-  }
-  const withAuth = content.includes("ILoggedUserInfoService");
-  let patched = content.replace("import { ILoggingService } from '@/domain/common/ilogging.service';", `import { ICacheService } from '@/domain/common/icache.service';
-import { ILoggingService } from '@/domain/common/ilogging.service';
-import { IRedLockService } from '@/domain/common/ired-lock.service';`).replace("import { LoggingService } from '@/infra/common/logging.service';", `import { CacheServiceProvider } from '@/infra/common/cache-service.provider';
-import { LoggingService } from '@/infra/common/logging.service';
-import { RedLockService } from '@/infra/common/red-lock.service';`).replace(`  providers: [
-    { provide: ILoggingService, useClass: LoggingService },`, `  providers: [
-    CacheServiceProvider,
-    { provide: ICacheService, useExisting: CacheServiceProvider },
-    { provide: ILoggingService, useClass: LoggingService },
-    { provide: IRedLockService, useClass: RedLockService },`);
-  if (withAuth) {
-    return patched.replace("  exports: [RepositoryModule, ILoggingService, ILoggedUserInfoService],", `  exports: [
-    RepositoryModule,
-    ICacheService,
-    ILoggingService,
-    IRedLockService,
-    ILoggedUserInfoService,
-  ],`);
-  }
-  return patched.replace("  exports: [RepositoryModule, ILoggingService],", `  exports: [
-    RepositoryModule,
-    ICacheService,
-    ILoggingService,
-    IRedLockService,
-  ],`);
+function hasCacheProviders(content) {
+  return content.includes("{ provide: ICacheService, useExisting: CacheServiceProvider }");
+}
+function hasAuthProviders(content) {
+  return content.includes("{ provide: ILoggedUserInfoService, useClass: LoggedUserInfoService }");
 }
-export const SLIM_INFRA_MODULE = `import { ILoggingService } from '@/domain/common/ilogging.service';
-import { Module } from '@nestjs/common';
-import { LoggingService } from '@/infra/common/logging.service';
-import { RepositoryModule } from '@/infra/repositories/repository.module';
+export function buildInfraModule({ cache, auth }) {
+  const importLines = [
+    ...cache ? ["import { ICacheService } from '@/domain/common/icache.service';"] : [],
+    "import { ILoggingService } from '@/domain/common/ilogging.service';",
+    ...auth ? [
+      "import { ILoggedUserInfoService } from '@/domain/services/ilogged-user-info.service';"
+    ] : [],
+    ...cache ? ["import { IRedLockService } from '@/domain/common/ired-lock.service';"] : [],
+    "import { Module } from '@nestjs/common';",
+    ...cache ? [
+      "import { CacheServiceProvider } from '@/infra/common/cache-service.provider';"
+    ] : [],
+    "import { LoggingService } from '@/infra/common/logging.service';",
+    ...auth ? [
+      "import { LoggedUserInfoService } from '@/infra/services/logged-user-info.service';"
+    ] : [],
+    ...cache ? ["import { RedLockService } from '@/infra/common/red-lock.service';"] : [],
+    "import { RepositoryModule } from '@/infra/repositories/repository.module';"
+  ];
+  const providerLines = [
+    ...cache ? [
+      "    CacheServiceProvider,",
+      "    { provide: ICacheService, useExisting: CacheServiceProvider },"
+    ] : [],
+    "    { provide: ILoggingService, useClass: LoggingService },",
+    ...cache ? ["    { provide: IRedLockService, useClass: RedLockService },"] : [],
+    ...auth ? [
+      "    { provide: ILoggedUserInfoService, useClass: LoggedUserInfoService },"
+    ] : []
+  ];
+  const exportLines = [
+    "    RepositoryModule,",
+    ...cache ? ["    ICacheService,"] : [],
+    "    ILoggingService,",
+    ...cache ? ["    IRedLockService,"] : [],
+    ...auth ? ["    ILoggedUserInfoService,"] : []
+  ];
+  return `${importLines.join(`
+`)}
 
 @Module({
   imports: [RepositoryModule],
-  providers: [{ provide: ILoggingService, useClass: LoggingService }],
-  exports: [RepositoryModule, ILoggingService],
+  providers: [
+${providerLines.join(`
+`)}
+  ],
+  exports: [
+${exportLines.join(`
+`)}
+  ],
 })
 export class InfraModule {}
 `;
-export function patchInfraModuleForAuth(content) {
-  if (content.includes("ILoggedUserInfoService")) {
+}
+export function patchInfraModuleForCache(content) {
+  if (hasCacheProviders(content)) {
     return content;
   }
-  let patched = content.replace("import { ILoggingService } from '@/domain/common/ilogging.service';", `import { ILoggingService } from '@/domain/common/ilogging.service';
-import { ILoggedUserInfoService } from '@/domain/services/ilogged-user-info.service';`).replace("import { LoggingService } from '@/infra/common/logging.service';", `import { LoggingService } from '@/infra/common/logging.service';
-import { LoggedUserInfoService } from '@/infra/services/logged-user-info.service';`).replace("    { provide: ILoggingService, useClass: LoggingService },", `    { provide: ILoggingService, useClass: LoggingService },
-    { provide: ILoggedUserInfoService, useClass: LoggedUserInfoService },`);
-  if (patched.includes("IRedLockService,")) {
-    return patched.replace(`    IRedLockService,
-  ],`, `    IRedLockService,
-    ILoggedUserInfoService,
-  ],`);
+  return buildInfraModule({
+    cache: true,
+    auth: hasAuthProviders(content) || content.includes("ILoggedUserInfoService")
+  });
+}
+export const SLIM_INFRA_MODULE = buildInfraModule({ cache: false, auth: false });
+export function patchInfraModuleForAuth(content) {
+  if (hasAuthProviders(content)) {
+    return content;
   }
-  return patched.replace("  exports: [RepositoryModule, ILoggingService],", "  exports: [RepositoryModule, ILoggingService, ILoggedUserInfoService],");
+  return buildInfraModule({
+    cache: hasCacheProviders(content) || content.includes("ICacheService"),
+    auth: true
+  });
 }
 export function stripInfraModuleCache(_content) {
   return SLIM_INFRA_MODULE;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koalarx/nest",
-  "version": "4.0.1",
+  "version": "4.0.3",
   "description": "CLI para criar APIs NestJS com arquitetura DDD — copia módulos prontos para o seu repositório.",
   "license": "MIT",
   "type": "module",