@koalarx/nest-cli 1.2.24 → 1.19.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Igor D. Rangel
+Copyright (c) 2023 Igor D. Rangel
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,76 +1,71 @@
 # @koalarx/nest-cli
 
-Ferramenta oficial de CLI para scaffolding rápido de projetos NestJS estruturados com padrões DDD.
-
-## 📋 Sobre
-
-`@koalarx/nest-cli` é a forma recomendada para inicializar novos projetos que utilizam a biblioteca [@koalarx/nest](https://github.com/igordrangel/koala-nest). Cria automaticamente a estrutura de diretórios, configurações de ambiente e setup inicial.
+CLI oficial para criar projetos utilizando **Koala Nest** - uma abstração robusta do NestJS seguindo princípios de Domain-Driven Design (DDD).
 
 ## 📦 Instalação
 
 ```bash
+npm install -g @koalarx/nest-cli
+# ou
 bun add -g @koalarx/nest-cli
 ```
 
-**Requisitos:** 
-- Bun 1.0.0+ ([Instale o Bun](https://bun.sh))
+## 🚀 Uso
 
-## 🚀 Uso Rápido
+### Criar Novo Projeto
 
 ```bash
-# Criar novo projeto
 koala-nest new meu-projeto
-
-# Entrar no diretório
-cd meu-projeto
-
-# Iniciar desenvolvimento (as dependências são instaladas automaticamente com bun)
-bun start:dev
 ```
 
-> **Nota:** A CLI utiliza **Bun** por debaixo dos panos para instalar os pacotes do projeto no comando `koala-nest new`. Isso torna o processo mais rápido e eficiente.
-
-## Comandos Disponíveis
-
-### `prisma:generate`
-
-Comando especializado que substitui o comando nativo do Prisma para compatibilidade com a biblioteca `@koalarx/nest`.
+Ou de forma interativa:
 
 ```bash
-bun run prisma:generate
+koala-nest new
 ```
 
-#### O problema:
-
-As versões mais recentes do Prisma utilizam um provider que gera arquivos de cliente com importações que não funcionam corretamente ao ser integrados com a biblioteca `@koalarx/nest`. O comando nativo `prisma generate` não resolve esses problemas automaticamente.
+Isso criará um novo projeto com:
+- ✅ Estrutura DDD completa (Domain, Application, Host, Infra)
+- ✅ Configuração do Prisma
+- ✅ Exemplo de CRUD com Person
+- ✅ Testes unitários e E2E configurados
+- ✅ Bun configurado
+- ✅ Dockerfile
+- ✅ ESLint e Prettier
+- ✅ AutoMapping
+- ✅ Validação com Zod
+- ✅ Swagger/Scalar
 
-#### A solução:
+## 📁 Estrutura Gerada
 
-Este comando executa uma sequência de operações para corrigir os importes e garantir compatibilidade total:
-
-1. **`prisma generate`** — Gera o cliente Prisma baseado no schema atual
-2. **`tsc --project tsconfig.build-prisma.json`** — Compila os arquivos TypeScript gerados na pasta `prisma/generated` para JavaScript utilizando a configuração específica do Prisma
-3. **`bun prisma/scripts/fix-extensions.mjs`** — Corrige os importes ESM dos arquivos compilados, adicionando extensões `.js` onde necessário
-
-#### Por que não usar `prisma generate` diretamente:
-
-O comando nativo do Prisma gera importações relativas sem extensão (ex: `from './generated'`), que não funcionam corretamente com ESM e causam incompatibilidades com a biblioteca `@koalarx/nest`. Este comando customizado resolve isso automaticamente.
-
-#### Quando executar:
-
-- Após modificar `prisma/schema.prisma`
-- Ao atualizar as versões do Prisma ou NestJS
-- Antes de fazer deploy em produção (incluído no CI/CD)
+```
+meu-projeto/
+├── src/
+│   ├── application/      # Handlers, Validators, Mapping
+│   ├── core/            # Configurações e variáveis globais
+│   ├── domain/          # Entities, DTOs, Repositories
+│   ├── host/            # Controllers e Modules
+│   ├── infra/           # Database e implementações
+│   └── test/            # Configurações de teste
+├── prisma/
+│   ├── schema.prisma
+│   └── migrations/
+├── .env
+├── Dockerfile
+├── package.json
+└── tsconfig.json
+```
 
-> **Importante:** Sempre use `bun run prisma:generate` ao invés do comando nativo `prisma generate` ao trabalhar com projetos `@koalarx/nest`.
+## 🔗 Links Úteis
 
-## Documentação Completa
+- [Documentação Koala Nest](https://github.com/igordrangel/koala-nest)
+- [Exemplo Completo](https://github.com/igordrangel/koala-nest/blob/main/docs/EXAMPLE.md)
+- [NPM Package](https://www.npmjs.com/package/@koalarx/nest)
 
-Para guias detalhados, exemplos avançados e referência de features, consulte:
+## 🤝 Contribuindo
 
-- **[@koalarx/nest](https://github.com/igordrangel/koala-nest)** — Documentação da biblioteca principal
-- **[Exemplo de Projeto](./code-base/startup-project)** — Estrutura padrão gerada pela CLI
+Contribuições são bem-vindas! Veja o [repositório principal](https://github.com/igordrangel/koala-nest) para mais informações.
 
 ## 📄 Licença
 
-MIT
+ISC © Igor D. Rangel

package/commands/new-project/index.js

@@ -0,0 +1,70 @@
+import chalk from 'chalk';
+import { execSync } from 'node:child_process';
+import { cpSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const TEMPLATE_BASE = join(__dirname, '../../templates/startup-project');
+const TEMPLATES_DIR = join(__dirname, '../../templates');
+export async function newProject(projectName) {
+    const targetDir = join(process.cwd(), projectName);
+    console.log(chalk.blue('🚀 Criando projeto Koala Nest...'));
+    console.log(chalk.gray(`📁 Destino: ${targetDir}\n`));
+    console.log(chalk.yellow('📋 Copiando estrutura base...'));
+    cpSync(TEMPLATE_BASE, targetDir, {
+        recursive: true,
+        filter: (src) => {
+            const isBlacklisted = src.includes('node_modules') ||
+                (src.includes('dist') && !src.includes('dist-cli')) ||
+                src.includes('.git');
+            return !isBlacklisted;
+        }
+    });
+    console.log(chalk.yellow('📦 Adicionando configurações extras...'));
+    const dockerfilePath = join(TEMPLATES_DIR, 'startup-project', 'Dockerfile');
+    try {
+        cpSync(dockerfilePath, join(targetDir, 'Dockerfile'));
+    }
+    catch {
+        console.log(chalk.red('⚠️  Dockerfile não encontrado nos templates, pulando...'));
+    }
+    console.log(chalk.yellow('⚙️  Configurando package.json...'));
+    const packageJsonPath = join(targetDir, 'package.json');
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+    packageJson.name = projectName;
+    writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
+    console.log(chalk.yellow('📄 Atualizando README...'));
+    const readmePath = join(targetDir, 'README.md');
+    let readme = readFileSync(readmePath, 'utf-8');
+    readme = readme.replace(/\[projectName\]/g, projectName);
+    writeFileSync(readmePath, readme);
+    console.log(chalk.yellow('🔐 Criando arquivo .env...'));
+    const envTemplate = readFileSync(join(TEMPLATES_DIR, 'env', 'config.txt'), 'utf-8');
+    const envContent = envTemplate.replace(/\[projectName\]/g, projectName.replace(/-/g, '_'));
+    writeFileSync(join(targetDir, '.env'), envContent);
+    console.log(chalk.yellow('🚫 Criando .gitignore...'));
+    const gitIgnoreContent = readFileSync(join(TEMPLATES_DIR, 'gitignore', 'config.txt'), 'utf-8');
+    writeFileSync(join(targetDir, '.gitignore'), gitIgnoreContent);
+    console.log(chalk.yellow('\n📥 Instalando dependências...'));
+    try {
+        execSync(`cd ${projectName} && bun install`, {
+            stdio: 'inherit',
+        });
+        console.log(chalk.yellow('🔨 Gerando Prisma Client...'));
+        execSync(`cd ${projectName} && bun run prisma:generate`, {
+            stdio: 'inherit',
+        });
+    }
+    catch {
+        console.log(chalk.red('⚠️  Erro ao instalar dependências. Execute manualmente:'));
+        console.log(chalk.gray(`  cd ${projectName}`));
+        console.log(chalk.gray(`  bun install`));
+        console.log(chalk.gray(`  bun run prisma:generate`));
+    }
+    console.log(chalk.green('\n✅ Projeto criado com sucesso!'));
+    console.log(chalk.cyan('\n📚 Próximos passos:'));
+    console.log(chalk.gray(`  cd ${projectName}`));
+    console.log(chalk.gray(`  bun run start:dev`));
+    console.log(chalk.gray(`\n📖 Documentação: https://github.com/igordrangel/koala-nest\n`));
+}

package/commands/new-project/new-project.js

@@ -0,0 +1,69 @@
+import chalk from 'chalk';
+import { execSync } from 'node:child_process';
+import { cpSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const TEMPLATE_BASE = join(__dirname, '../../../example');
+const TEMPLATES_DIR = join(__dirname, '../../templates');
+export async function newProject(projectName) {
+    const targetDir = join(process.cwd(), projectName);
+    console.log(chalk.blue('🚀 Criando projeto Koala Nest...'));
+    console.log(chalk.gray(`📁 Destino: ${targetDir}\n`));
+    console.log(chalk.yellow('📋 Copiando estrutura base...'));
+    cpSync(TEMPLATE_BASE, targetDir, {
+        recursive: true,
+        filter: (src) => {
+            return !src.includes('node_modules') &&
+                !src.includes('dist') &&
+                !src.includes('.git');
+        }
+    });
+    console.log(chalk.yellow('📦 Adicionando configurações extras...'));
+    const dockerfilePath = join(TEMPLATES_DIR, 'startup-project', 'Dockerfile');
+    try {
+        cpSync(dockerfilePath, join(targetDir, 'Dockerfile'));
+    }
+    catch {
+        console.log(chalk.red('⚠️  Dockerfile não encontrado nos templates, pulando...'));
+    }
+    console.log(chalk.yellow('⚙️  Configurando package.json...'));
+    const packageJsonPath = join(targetDir, 'package.json');
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+    packageJson.name = projectName;
+    writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
+    console.log(chalk.yellow('📄 Atualizando README...'));
+    const readmePath = join(targetDir, 'README.md');
+    let readme = readFileSync(readmePath, 'utf-8');
+    readme = readme.replace(/\[projectName\]/g, projectName);
+    writeFileSync(readmePath, readme);
+    console.log(chalk.yellow('🔐 Criando arquivo .env...'));
+    const envTemplate = readFileSync(join(TEMPLATES_DIR, 'env', 'config.txt'), 'utf-8');
+    const envContent = envTemplate.replace(/\[projectName\]/g, projectName.replace(/-/g, '_'));
+    writeFileSync(join(targetDir, '.env'), envContent);
+    console.log(chalk.yellow('🚫 Criando .gitignore...'));
+    const gitIgnoreContent = readFileSync(join(TEMPLATES_DIR, 'gitignore', 'config.txt'), 'utf-8');
+    writeFileSync(join(targetDir, '.gitignore'), gitIgnoreContent);
+    console.log(chalk.yellow('\n📥 Instalando dependências...'));
+    try {
+        execSync(`cd ${projectName} && bun install`, {
+            stdio: 'inherit',
+        });
+        console.log(chalk.yellow('🔨 Gerando Prisma Client...'));
+        execSync(`cd ${projectName} && bun build:prisma`, {
+            stdio: 'inherit',
+        });
+    }
+    catch {
+        console.log(chalk.red('⚠️  Erro ao instalar dependências. Execute manualmente:'));
+        console.log(chalk.gray(`  cd ${projectName}`));
+        console.log(chalk.gray(`  bun install`));
+        console.log(chalk.gray(`  bun build:prisma`));
+    }
+    console.log(chalk.green('\n✅ Projeto criado com sucesso!'));
+    console.log(chalk.cyan('\n📚 Próximos passos:'));
+    console.log(chalk.gray(`  cd ${projectName}`));
+    console.log(chalk.gray(`  bun run start:dev`));
+    console.log(chalk.gray(`\n📖 Documentação: https://github.com/igordrangel/koala-nest\n`));
+}