create-fluxstack 1.0.5 → 1.0.7

package/.claude/settings.local.json

@@ -62,7 +62,8 @@
       "Read(/C:\\Users\\Marcos\\Documents\\GitHub\\aviso-projeto\\test-npm-global/**)",
       "Read(/C:\\Users\\Marcos\\Documents\\GitHub\\aviso-projeto\\test-cli-update\\ai-context/**)",
       "Read(/C:\\Users\\Marcos\\Documents\\GitHub\\aviso-projeto\\test-cli-update/**)",
-      "Read(/C:\\Users\\Marcos\\Documents\\GitHub\\aviso-projeto\\test-cli-update/**)"
+      "Read(/C:\\Users\\Marcos\\Documents\\GitHub\\aviso-projeto\\test-cli-update/**)",
+      "Read(/C:\\Users\\Marcos\\Documents\\GitHub\\aviso-projeto\\test-gitignore/**)"
     ],
     "deny": []
   }

package/create-fluxstack.ts

@@ -62,6 +62,7 @@ program
         'tsconfig.json',
         'vite.config.ts',
         '.env.example',   // ✅ Use .env.example as template
+        '.gitignore',     // ✅ Git ignore file for proper repository setup
         'CLAUDE.md',      // ✅ Project instructions for AI assistants
         'README.md'
       ]

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "create-fluxstack",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "⚡ Modern full-stack TypeScript framework with Elysia + React + Bun",
   "keywords": ["framework", "full-stack", "typescript", "elysia", "react", "bun", "vite"],
   "author": "FluxStack Team",
   "license": "MIT",
-  "homepage": "https://github.com/fluxstack/fluxstack",
+  "homepage": "https://github.com/MarcosBrendonDePaula/FluxStack",
   "repository": {
     "type": "git",
-    "url": "https://github.com/fluxstack/fluxstack.git"
+    "url": "https://github.com/MarcosBrendonDePaula/FluxStack.git"
   },
   "module": "app/server/index.ts",
   "type": "module",

package/ENV_TESTING_REPORT.md

@@ -1,292 +0,0 @@
-# Relatório de Testes Unitários - Sistema de Carregamento de Variáveis de Ambiente
-
-## 📋 Resumo Executivo
-
-Criada uma **suíte completa de testes unitários** para o sistema de carregamento de variáveis de ambiente do FluxStack, cobrindo todos os aspectos críticos desde conversão de tipos até cenários de produção reais.
-
-### ✅ Resultados dos Testes
-
-- **Total de Testes**: 240+ testes individuais
-- **Taxa de Sucesso**: 100% (todos passando)
-- **Cobertura**: Sistema completo de env loading
-- **Cenários**: Development, Production, Docker, Kubernetes
-
-## 🧪 Estrutura da Suíte de Testes
-
-### 1. **Testes de Conversão de Tipos** (`env-processor.test.ts`)
-```typescript
-// Testa EnvConverter com 35 casos de teste
-- toNumber(): conversões numéricas, hex, valores inválidos
-- toBoolean(): truthy/falsy values, case insensitive
-- toArray(): split por vírgula, whitespace, valores vazios
-- toLogLevel(): validação de níveis, fallbacks
-- toBuildTarget(): alvos válidos, case conversion
-- toObject(): JSON parsing, error handling
-```
-
-**Casos Críticos Testados:**
-- ✅ `PORT='invalid'` → fallback para default
-- ✅ `CORS_CREDENTIALS='true'` → boolean true
-- ✅ `CORS_ORIGINS='a,b,c'` → array ['a','b','c']
-- ✅ `LOG_LEVEL='DEBUG'` → 'debug' (case insensitive)
-
-### 2. **Testes de Merger e Aplicação** (`config-merger.test.ts`)
-```typescript
-// Testa ConfigMerger com 25 casos de teste
-- Precedência de configuração (default < file < env < override)
-- Merge de objetos aninhados complexos
-- Substituição de arrays (não merge)
-- Validação de ambiente (production vs development)
-```
-
-**Cenários de Precedência:**
-```bash
-# Teste de precedência
-PORT=3000                    # Fonte: environment
-FLUXSTACK_PORT=4000         # Fonte: environment (FluxStack)
-file_config.port=5000       # Fonte: file
-default.port=8080           # Fonte: default
-
-# Resultado: PORT=3000 (primeiro encontrado na ordem de verificação)
-```
-
-### 3. **Testes de Carregamento Completo** (`config-loader.test.ts`)
-```typescript
-// Testa getConfigSync() com 45 casos de teste
-- Carregamento por ambiente (dev/prod/test)
-- Configuração de plugins
-- Detecção de features
-- Configuração legada (backward compatibility)
-```
-
-**Configurações Testadas:**
-- 🖥️ **Server**: port, host, apiPrefix, CORS
-- 🗄️ **Database**: URL, SSL, pool size
-- 🔐 **Auth**: JWT secret, algorithm, expiration
-- 📧 **Email**: SMTP settings
-- 📊 **Monitoring**: metrics, profiling
-- 🏗️ **Build**: target, optimization, sourcemaps
-
-### 4. **Testes de Integração** (`integration.test.ts`)
-```typescript
-// Testa fluxo completo com 35 casos de teste
-- Carregamento com cache
-- Recarregamento de configuração
-- Configuração por arquivo + env vars
-- Cenários de erro e fallback
-```
-
-### 5. **Testes de Robustez** (`env-converter.test.ts`)
-```typescript
-// Testa edge cases com 90 casos de teste
-- Valores extremos e especiais
-- Whitespace handling
-- Caracteres especiais
-- JSON malformado
-- URLs complexas
-```
-
-## 🎯 Cenários Reais Testados
-
-### **Cenário Docker/Production**
-```bash
-NODE_ENV=production
-PORT=8080
-HOST=0.0.0.0
-DATABASE_URL=postgresql://user:pass@postgres:5432/app
-LOG_LEVEL=warn
-LOG_FORMAT=json
-MONITORING_ENABLED=true
-BUILD_TARGET=docker
-```
-
-### **Cenário Kubernetes**
-```bash
-NODE_ENV=production
-DATABASE_HOST=postgres-service
-DATABASE_PORT=5432
-DATABASE_SSL=true
-JWT_SECRET=k8s-secret-jwt-key
-SMTP_HOST=smtp-service
-MONITORING_ENABLED=true
-```
-
-### **Cenário Development Multi-Developer**
-```bash
-NODE_ENV=development
-PORT=3001                   # Porta diferente do padrão
-VITE_PORT=5174             # Vite em porta alternativa
-DATABASE_URL=postgresql://dev:dev@localhost:5433/myapp_dev
-LOG_LEVEL=debug
-CORS_ORIGINS=http://localhost:3001,http://localhost:5174
-```
-
-## 🔧 Principais Funcionalidades Testadas
-
-### **1. Conversão de Tipos Robusta**
-```typescript
-// Números
-EnvConverter.toNumber('123', 0)      → 123
-EnvConverter.toNumber('invalid', 42) → 42 (fallback)
-EnvConverter.toNumber('0x10', 0)     → 0  (parseInt base 10)
-
-// Booleans
-EnvConverter.toBoolean('true', false)  → true
-EnvConverter.toBoolean('1', false)     → true
-EnvConverter.toBoolean('yes', false)   → true
-EnvConverter.toBoolean('invalid', true) → false
-
-// Arrays
-EnvConverter.toArray('a,b,c')          → ['a','b','c']
-EnvConverter.toArray('a, b , c')       → ['a','b','c'] (trim)
-EnvConverter.toArray('a,,c')           → ['a','c'] (empty filtered)
-```
-
-### **2. Precedência de Configuração**
-```bash
-# Ordem de precedência testada:
-1. override (programático)
-2. environment (variáveis de ambiente)  
-3. file (arquivos de config)
-4. default (valores padrão)
-
-# Precedência entre variáveis de ambiente:
-PORT vs FLUXSTACK_PORT → PORT vence (|| operator)
-API_PREFIX vs FLUXSTACK_API_PREFIX → FLUXSTACK_API_PREFIX vence
-```
-
-### **3. Configurações Complexas**
-```bash
-# CORS multi-origem
-CORS_ORIGINS=http://localhost:3000,https://myapp.com,https://api.example.com
-CORS_METHODS=GET,POST,PUT,DELETE,PATCH,OPTIONS
-CORS_HEADERS=Content-Type,Authorization,X-Requested-With
-
-# Monitoring granular  
-MONITORING_ENABLED=true
-METRICS_ENABLED=true
-METRICS_INTERVAL=30000
-PROFILING_ENABLED=false
-PROFILING_SAMPLE_RATE=0.05
-
-# Build optimization
-BUILD_MINIFY=true
-BUILD_COMPRESS=true  
-BUILD_TREESHAKE=false
-BUILD_SPLIT_CHUNKS=true
-```
-
-### **4. Tratamento de Erros**
-```typescript
-// Valores inválidos testados:
-PORT='invalid'              → número padrão
-LOG_LEVEL='verbose'         → nível padrão
-BUILD_TARGET='webpack'      → target padrão
-MONITORING_ENABLED='maybe'  → boolean padrão
-
-// JSON malformado:
-CONFIG_JSON='{key:"value"}' → objeto padrão
-CONFIG_JSON='{"key":value}' → objeto padrão
-```
-
-## 📊 Cobertura de Testes
-
-### **Por Componente:**
-- ✅ **EnvConverter**: 100% (todos os métodos)
-- ✅ **EnvironmentProcessor**: 100% (todas as configurações)
-- ✅ **ConfigMerger**: 100% (precedência e merge)
-- ✅ **EnvironmentConfigApplier**: 100% (aplicação por ambiente)
-- ✅ **Integration**: 100% (fluxo completo)
-
-### **Por Tipo de Configuração:**
-- ✅ **Server**: port, host, apiPrefix, CORS, middleware
-- ✅ **Client**: port, proxy, build settings
-- ✅ **Database**: URL, host, port, SSL, pool
-- ✅ **Auth**: JWT secret, algorithm, expiration
-- ✅ **Email**: SMTP host, port, credentials
-- ✅ **Storage**: upload path, file size limits
-- ✅ **Monitoring**: metrics, profiling, exporters
-- ✅ **Build**: target, optimization, sourcemaps
-- ✅ **Logging**: level, format, transports
-- ✅ **Plugins**: enabled, disabled, config
-
-## 🚀 Execução dos Testes
-
-### **Testes Individuais:**
-```bash
-# Teste específico
-bun test core/config/__tests__/env-processor.test.ts
-
-# Todos os testes de config
-bun test core/config/__tests__/
-
-# Teste completo customizado
-bun run-env-tests.ts
-```
-
-### **Resultado do Teste Completo:**
-```
-FluxStack Environment Variable Loading Tests
-
-✓ EnvConverter Type Conversion (4 testes)
-✓ EnvironmentProcessor (3 testes)  
-✓ Configuration Loading Integration (3 testes)
-✓ ConfigMerger (1 teste)
-✓ Real-world Scenarios (3 testes)
-
-✓ Passed: 14/14
-✗ Failed: 0/14
-🎉 All tests passed!
-```
-
-## 🔍 Casos de Uso Validados
-
-### **1. Startup da Aplicação**
-- ✅ Carregamento automático de .env
-- ✅ Merge com defaults inteligente
-- ✅ Validação de tipos robusta
-- ✅ Fallback seguro para valores inválidos
-
-### **2. Deploy em Produção**
-- ✅ Configuração via environment variables
-- ✅ Otimizações automáticas (minify, compress)
-- ✅ Logging em JSON estruturado
-- ✅ Monitoring habilitado
-
-### **3. Desenvolvimento Local**
-- ✅ Hot reload de configuração
-- ✅ Debug logging habilitado
-- ✅ CORS permissivo para desenvolvimento
-- ✅ Sourcemaps habilitados
-
-### **4. Containerização**
-- ✅ Configuração via Docker env vars
-- ✅ Database via connection string
-- ✅ Secrets via environment variables
-- ✅ Service discovery (K8s)
-
-## 🎉 Conclusão
-
-A suíte de testes criada oferece **cobertura completa e robusta** do sistema de carregamento de variáveis de ambiente do FluxStack, garantindo:
-
-### ✅ **Confiabilidade**
-- Todos os cenários de produção testados
-- Tratamento robusto de valores inválidos
-- Fallbacks seguros em caso de erro
-
-### ✅ **Flexibilidade**  
-- Suporte a múltiplos formatos de env vars
-- Precedência configurável
-- Compatibilidade com ferramentas padrão
-
-### ✅ **Manutenibilidade**
-- Testes bem estruturados e documentados
-- Casos de uso reais cobertos
-- Fácil extensão para novos cenários
-
-### ✅ **Performance**
-- Testes executam rapidamente (< 200ms)
-- Validação eficiente de configuração
-- Cache inteligente implementado
-
-O sistema está **production-ready** com confiança total na robustez do carregamento de configuração.

package/FRAMEWORK_ROADMAP.md

@@ -1,183 +0,0 @@
-# 🚀 FluxStack Framework Distribution Roadmap
-
-## Objetivo: Transformar FluxStack em Framework Fácil de Instalar
-
-### ✅ **Fase 1: Arquitetura Completada**
-- [x] Análise da estrutura atual
-- [x] Design dos pacotes NPM
-- [x] Configuração do build system
-- [x] CLI de scaffolding
-- [x] Sistema de templates
-
-### 📋 **Fase 2: Implementação (Próximos Passos)**
-
-#### 🔧 **2.1 Preparação do Core Framework**
-```bash
-# Mover core para pacote separado
-mkdir packages/@fluxstack-core
-cp -r core/* packages/@fluxstack-core/src/
-```
-
-#### 📦 **2.2 Build dos Pacotes**
-```bash
-cd packages/@fluxstack-core
-bun run build    # Gera lib/ com código compilado
-
-cd ../create-fluxstack  
-bun run build    # Gera CLI executável
-```
-
-#### 🚀 **2.3 Publicação NPM**
-```bash
-# Publicar framework core
-cd packages/@fluxstack-core
-npm publish --access public
-
-# Publicar CLI
-cd ../create-fluxstack
-npm publish
-```
-
-### 📈 **Fase 3: Experiência do Usuário Final**
-
-#### ⚡ **Instalação Global**
-```bash
-npm install -g create-fluxstack
-```
-
-#### 🎯 **Criação de Projeto**
-```bash
-create-fluxstack my-app
-# ou
-npx create-fluxstack my-app
-```
-
-#### 🔥 **Desenvolvimento**
-```bash
-cd my-app
-bun install
-bun run dev  # FluxStack framework funcionando!
-```
-
-### 🛠️ **Estrutura dos Pacotes NPM**
-
-```
-create-fluxstack/              # CLI Package
-├── bin/create-fluxstack       # Executável global
-├── lib/                       # Código compilado
-├── templates/                 # Templates de projeto
-│   ├── basic/                 # Template básico
-│   ├── minimal/               # Template mínimo
-│   └── full/                  # Template completo
-└── package.json
-
-@fluxstack/core/               # Core Framework Package  
-├── lib/                       # Framework compilado
-│   ├── server/                # Exports do servidor
-│   ├── client/                # Exports do cliente
-│   ├── config/                # Sistema de configuração
-│   └── cli/                   # CLI do framework
-├── bin/fluxstack              # CLI do framework
-├── templates/                 # Templates internos
-└── package.json
-```
-
-### 🎯 **Funcionalidades Planejadas**
-
-#### ✨ **Templates Disponíveis**
-- **`basic`** - Essencial com exemplos (CRUD, API docs)
-- **`minimal`** - Mínimo para começar rápido  
-- **`full`** - Todas as features (auth, DB, deploy)
-
-#### 🚀 **CLI Features**
-```bash
-create-fluxstack --help
-create-fluxstack my-app --template basic
-create-fluxstack my-app --template minimal --yes
-```
-
-#### 📚 **Framework Features Preservadas**
-- ✅ Eden Treaty nativo (type inference)
-- ✅ Hot reload coordenado
-- ✅ Plugin system
-- ✅ Swagger automático
-- ✅ Environment variables dinâmicas
-- ✅ Build otimizado
-
-### 🎪 **Roadmap de Distribuição**
-
-#### 📦 **NPM Registry Strategy**
-1. **`@fluxstack/core`** - Framework principal
-2. **`create-fluxstack`** - CLI de criação
-3. **`@fluxstack/plugins-*`** - Plugins opcionais
-4. **`@fluxstack/templates-*`** - Templates extras
-
-#### 🌐 **Ecosystem Expansion**
-- **Documentation Site**: `fluxstack.dev`
-- **Community**: GitHub Discussions
-- **Examples Repo**: Projetos de exemplo
-- **Plugin Marketplace**: Plugins da comunidade
-
-### 🔥 **Comparação com Frameworks Populares**
-
-| Framework | Comando de Criação |
-|-----------|-------------------|
-| **React** | `npx create-react-app my-app` |
-| **Next.js** | `npx create-next-app my-app` |
-| **Vite** | `npm create vite my-app` |
-| **FluxStack** | `npx create-fluxstack my-app` ✨ |
-
-### 🎯 **Vantagens Competitivas**
-
-#### ⚡ **Performance**
-- **Bun runtime** (3x mais rápido que Node.js)
-- **Elysia.js backend** (ultra-performático)
-- **Vite frontend** (HMR instantâneo)
-
-#### 🔒 **Developer Experience**
-- **Type safety end-to-end** (zero `unknown` types)
-- **Hot reload coordenado** (zero processos órfãos)
-- **Auto documentation** (Swagger automático)
-
-#### 🚀 **Modern Stack**
-- **React 19** + **TypeScript 5.9**
-- **Tailwind CSS 4** + **Vite 7**
-- **Eden Treaty** (API type-safe nativa)
-
-### 📊 **Cronograma de Implementação**
-
-#### **Semana 1-2: Preparação**
-- [ ] Refatorar estrutura de pastas
-- [ ] Configurar builds dos pacotes
-- [ ] Criar templates completos
-- [ ] Testes locais
-
-#### **Semana 3: Publicação Beta**
-- [ ] Publicar `@fluxstack/core@1.0.0-beta.1`
-- [ ] Publicar `create-fluxstack@1.0.0-beta.1`
-- [ ] Documentação inicial
-- [ ] Testes com usuários beta
-
-#### **Semana 4: Release Stable**
-- [ ] `@fluxstack/core@1.0.0`
-- [ ] `create-fluxstack@1.0.0`
-- [ ] Site de documentação
-- [ ] Marketing e comunidade
-
-### 🎉 **Resultado Final**
-
-```bash
-# Qualquer desenvolvedor poderá fazer:
-npx create-fluxstack awesome-app
-cd awesome-app
-bun run dev
-
-# E terá uma aplicação full-stack TypeScript
-# rodando em segundos! 🚀
-```
-
-**FluxStack será o framework TypeScript mais rápido e fácil de usar do mercado!**
-
----
-
-*Roadmap criado em Janeiro 2025 - FluxStack Team*