create-fluxstack 1.0.4 → 1.0.6

package/examples/hybrid-env-strategy.ts

@@ -1,212 +0,0 @@
-/**
- * Estratégia Híbrida: Env Fixado + Env Dinâmico
- * Use o melhor de cada abordagem conforme necessário
- */
-
-import { env } from '@/core/utils/env-runtime'
-
-// ========================================
-// CONFIGURAÇÕES FIXADAS (Build-time)
-// ========================================
-// Use para valores que nunca mudam ou precisam de máxima performance
-
-// App metadata - fixado é OK
-const APP_NAME = process.env.FLUXSTACK_APP_NAME || 'FluxStack'
-const APP_VERSION = process.env.FLUXSTACK_APP_VERSION || '1.0.0'
-
-// Feature flags - fixado é OK  
-const ENABLE_SWAGGER = process.env.ENABLE_SWAGGER !== 'false'
-const ENABLE_CORS = process.env.ENABLE_CORS !== 'false'
-
-// Build configuration - fixado é ideal
-const BUILD_TARGET = process.env.BUILD_TARGET || 'bun'
-const CLIENT_OUTDIR = process.env.CLIENT_OUTDIR || 'dist/client'
-
-// ========================================  
-// CONFIGURAÇÕES DINÂMICAS (Runtime)
-// ========================================
-// Use para valores que precisam mudar em diferentes deploys
-
-// Server config - deve ser dinâmico
-const getServerConfig = () => ({
-  port: env.num('PORT', 3000),           // 🔄 Dinâmico
-  host: env.get('HOST', 'localhost'),    // 🔄 Dinâmico
-  apiPrefix: env.get('API_PREFIX', '/api')
-})
-
-// Database - deve ser dinâmico
-const getDatabaseConfig = () => ({
-  url: env.get('DATABASE_URL'),          // 🔄 Dinâmico
-  maxConnections: env.num('DB_MAX_CONNECTIONS', 10),
-  ssl: env.bool('DB_SSL', env.get('NODE_ENV') === 'production')
-})
-
-// Secrets - deve ser dinâmico
-const getSecrets = () => ({
-  jwtSecret: env.get('JWT_SECRET'),      // 🔄 Dinâmico
-  apiKey: env.get('API_KEY'),
-  encryptionKey: env.get('ENCRYPTION_KEY')
-})
-
-// Environment specific - dinâmico
-const getEnvironmentConfig = () => ({
-  nodeEnv: env.get('NODE_ENV', 'development'),  // 🔄 Dinâmico
-  logLevel: env.get('LOG_LEVEL', 'info'),
-  debug: env.bool('DEBUG', false)
-})
-
-// ========================================
-// CONFIGURAÇÃO HÍBRIDA
-// ========================================
-
-export const hybridConfig = {
-  // Fixado no build (performance máxima)
-  app: {
-    name: APP_NAME,                    // ⚡ Fixado
-    version: APP_VERSION,              // ⚡ Fixado
-    enableSwagger: ENABLE_SWAGGER,     // ⚡ Fixado
-    enableCors: ENABLE_CORS           // ⚡ Fixado
-  },
-
-  build: {
-    target: BUILD_TARGET,              // ⚡ Fixado
-    clientOutDir: CLIENT_OUTDIR        // ⚡ Fixado
-  },
-
-  // Dinâmico no runtime (flexibilidade máxima)
-  runtime: {
-    server: getServerConfig(),         // 🔄 Dinâmico
-    database: getDatabaseConfig(),     // 🔄 Dinâmico
-    secrets: getSecrets(),             // 🔄 Dinâmico
-    environment: getEnvironmentConfig() // 🔄 Dinâmico
-  }
-}
-
-// ========================================
-// EXEMPLO DE USO PRÁTICO
-// ========================================
-
-export function createHybridServer() {
-  console.log(`🚀 Starting ${hybridConfig.app.name} v${hybridConfig.app.version}`)
-  
-  const { server, database, environment } = hybridConfig.runtime
-  
-  console.log(`📊 Environment: ${environment.nodeEnv}`)
-  console.log(`🌐 Server: ${server.host}:${server.port}`)
-  console.log(`💾 Database: ${database.url ? '✅ Connected' : '❌ Not configured'}`)
-  
-  // Configuração do FluxStack
-  const config = {
-    // Valores fixados (build-time) - performance máxima
-    app: hybridConfig.app,
-    build: hybridConfig.build,
-    
-    // Valores dinâmicos (runtime) - flexibilidade máxima
-    server: {
-      port: server.port,        // 🔄 Pode mudar sem rebuild
-      host: server.host,        // 🔄 Pode mudar sem rebuild
-      apiPrefix: server.apiPrefix,
-      cors: {
-        origins: env.array('CORS_ORIGINS', ['*']),
-        enabled: hybridConfig.app.enableCors  // ⚡ Fixado no build
-      }
-    },
-    
-    logging: {
-      level: environment.logLevel,  // 🔄 Pode mudar sem rebuild
-      debug: environment.debug
-    }
-  }
-  
-  return config
-}
-
-// ========================================
-// OTIMIZAÇÃO POR AMBIENTE
-// ========================================
-
-export function createOptimizedConfig() {
-  const nodeEnv = env.get('NODE_ENV', 'development')
-  
-  switch (nodeEnv) {
-    case 'development':
-      return {
-        // Development: tudo dinâmico para flexibilidade
-        port: env.num('PORT', 3000),           // 🔄
-        debug: env.bool('DEBUG', true),        // 🔄
-        logLevel: env.get('LOG_LEVEL', 'debug'), // 🔄
-        hotReload: env.bool('HOT_RELOAD', true)  // 🔄
-      }
-      
-    case 'production':
-      return {
-        // Production: mix de fixado e dinâmico
-        appName: APP_NAME,                     // ⚡ Fixado (performance)
-        version: APP_VERSION,                  // ⚡ Fixado (performance)
-        port: env.num('PORT', 3000),           // 🔄 Dinâmico (deploy)
-        dbUrl: env.get('DATABASE_URL'),        // 🔄 Dinâmico (deploy)
-        logLevel: env.get('LOG_LEVEL', 'warn') // 🔄 Dinâmico (ops)
-      }
-      
-    default:
-      return createHybridServer()
-  }
-}
-
-// ========================================
-// PERFORMANCE COMPARISON
-// ========================================
-
-export const performanceComparison = {
-  // ⚡ ULTRA RÁPIDO - Fixado no build
-  fixedConfig: {
-    port: 3000,                    // Literal number
-    dbUrl: "postgres://...",       // Literal string  
-    debug: false                   // Literal boolean
-  },
-  
-  // 🔄 LIGEIRAMENTE MAIS LENTO - Dinâmico
-  dynamicConfig: {
-    port: env.num('PORT', 3000),           // Function call
-    dbUrl: env.get('DATABASE_URL'),        // Function call
-    debug: env.bool('DEBUG', false)        // Function call
-  }
-}
-
-// ========================================
-// MIGRAÇÃO GRADUAL
-// ========================================
-
-export const migrationStrategy = {
-  // Passo 1: Identifique configurações críticas
-  critical: {
-    // Use dinâmico para configs que DEVEM mudar
-    port: env.num('PORT', 3000),
-    dbUrl: env.get('DATABASE_URL'),
-    secrets: env.get('JWT_SECRET')
-  },
-  
-  // Passo 2: Mantenha fixado o que não precisa mudar
-  static: {
-    appName: process.env.APP_NAME || 'MyApp',
-    version: process.env.APP_VERSION || '1.0.0',
-    features: process.env.FEATURES?.split(',') || []
-  },
-  
-  // Passo 3: Migre gradualmente conforme necessário
-  gradually: {
-    // Comece com fixado...
-    logLevel: process.env.LOG_LEVEL || 'info',
-    
-    // ...depois mude para dinâmico quando precisar
-    // logLevel: env.get('LOG_LEVEL', 'info')
-  }
-}
-
-export default {
-  hybridConfig,
-  createHybridServer,
-  createOptimizedConfig,
-  performanceComparison,
-  migrationStrategy
-}

package/examples/simplified-env-usage.ts

@@ -1,251 +0,0 @@
-/**
- * Exemplos da API simplificada de Environment Variables
- * Mais elegante, intuitiva e com menos código
- */
-
-import { env, createNamespace, validate, helpers } from '../core/utils/env-runtime-v2'
-
-// ========================================
-// 1. CASTING AUTOMÁTICO INTELIGENTE
-// ========================================
-
-// ✅ NOVO - API super simples com casting automático
-const config = {
-  port: env.get('PORT', 3000),              // -> number (baseado no default)
-  debug: env.get('DEBUG', false),           // -> boolean (baseado no default)
-  origins: env.get('CORS_ORIGINS', ['*']),  // -> string[] (baseado no default)
-  host: env.get('HOST', 'localhost'),       // -> string (baseado no default)
-  dbUrl: env.get('DATABASE_URL'),           // -> string | undefined
-  retries: env.get('MAX_RETRIES', 3),       // -> number
-  features: env.get('FEATURES', ['api'])    // -> string[]
-}
-
-// ❌ ANTES - API verbosa com métodos específicos
-const oldConfig = {
-  port: env.num('PORT', 3000),
-  debug: env.bool('DEBUG', false),
-  origins: env.array('CORS_ORIGINS', ['*']),
-  host: env.get('HOST', 'localhost'),
-  dbUrl: env.get('DATABASE_URL'),
-  retries: env.num('MAX_RETRIES', 3),
-  features: env.array('FEATURES', ['api'])
-}
-
-// ========================================
-// 2. ACESSO DIRETO COMO PROPRIEDADES
-// ========================================
-
-console.log(`🚀 Starting on ${env.HOST}:${env.PORT}`)           // Direto!
-console.log(`📊 Environment: ${env.NODE_ENV}`)                  // Direto!  
-console.log(`🐛 Debug mode: ${env.DEBUG}`)                      // Direto!
-console.log(`📋 Swagger: ${env.ENABLE_SWAGGER}`)                // Direto!
-console.log(`💾 Database: ${env.DATABASE_URL || 'not configured'}`) // Direto!
-
-// Todos com tipos corretos automaticamente!
-
-// ========================================
-// 3. CONFIGURAÇÃO DE SERVIDOR SIMPLIFICADA
-// ========================================
-
-export function createSimpleServer() {
-  return {
-    // Casting automático baseado no tipo do default
-    server: {
-      port: env.get('PORT', 3000),           // number
-      host: env.get('HOST', 'localhost'),    // string
-      timeout: env.get('TIMEOUT', 30000),    // number
-      keepAlive: env.get('KEEP_ALIVE', true) // boolean
-    },
-    
-    // Ou acesso direto
-    database: {
-      url: env.DATABASE_URL,          // string
-      ssl: env.DB_SSL,               // boolean 
-      port: env.DB_PORT,             // number
-      maxConnections: env.get('DB_MAX_CONNECTIONS', 10) // number
-    },
-    
-    cors: {
-      origins: env.CORS_ORIGINS,              // string[]
-      credentials: env.get('CORS_CREDENTIALS', false), // boolean
-      maxAge: env.get('CORS_MAX_AGE', 86400)  // number
-    }
-  }
-}
-
-// ========================================
-// 4. NAMESPACES PARA ORGANIZAÇÃO
-// ========================================
-
-// Criar namespaces especializados
-const db = createNamespace('DATABASE_')
-const redis = createNamespace('REDIS_')
-const smtp = createNamespace('SMTP_')
-
-const databaseConfig = {
-  url: db.get('URL'),                    // DATABASE_URL
-  host: db.get('HOST', 'localhost'),     // DATABASE_HOST  
-  port: db.get('PORT', 5432),           // DATABASE_PORT (number)
-  ssl: db.get('SSL', false),            // DATABASE_SSL (boolean)
-  poolSize: db.get('POOL_SIZE', 10),    // DATABASE_POOL_SIZE (number)
-  timeout: db.get('TIMEOUT', 30000)     // DATABASE_TIMEOUT (number)
-}
-
-const redisConfig = {
-  url: redis.get('URL'),                // REDIS_URL
-  host: redis.get('HOST', 'localhost'), // REDIS_HOST
-  port: redis.get('PORT', 6379),       // REDIS_PORT (number)
-  password: redis.get('PASSWORD')       // REDIS_PASSWORD
-}
-
-// ========================================
-// 5. CONFIGURAÇÃO CONDICIONAL ELEGANTE  
-// ========================================
-
-export function createConditionalConfig() {
-  const config: any = {
-    app: {
-      name: env.FLUXSTACK_APP_NAME,     // 'FluxStack'
-      version: env.FLUXSTACK_APP_VERSION // '1.0.0'
-    },
-    
-    server: {
-      port: env.PORT,                   // 3000
-      host: env.HOST                    // 'localhost'
-    }
-  }
-  
-  // Adicionar database se configurado
-  if (env.has('DATABASE_URL')) {
-    config.database = {
-      url: env.DATABASE_URL,
-      ssl: env.get('DB_SSL', env.NODE_ENV === 'production') // smart default
-    }
-  }
-  
-  // Features opcionais
-  if (env.ENABLE_MONITORING) {
-    config.monitoring = {
-      metrics: env.ENABLE_METRICS,
-      interval: env.get('METRICS_INTERVAL', 30000)
-    }
-  }
-  
-  return config
-}
-
-// ========================================
-// 6. VALIDAÇÃO SIMPLIFICADA
-// ========================================
-
-export function validateEnvironment() {
-  // Vars obrigatórias
-  validate.require(['NODE_ENV'])
-  
-  // Produção precisa de mais vars
-  if (helpers.isProduction()) {
-    validate.require(['DATABASE_URL', 'JWT_SECRET'])
-  }
-  
-  // Validar valores específicos
-  validate.oneOf('NODE_ENV', ['development', 'production', 'test'])
-  validate.oneOf('LOG_LEVEL', ['debug', 'info', 'warn', 'error'])
-}
-
-// ========================================
-// 7. HELPERS ÚTEIS
-// ========================================
-
-export function printConfiguration() {
-  console.log('🔧 Configuration loaded:')
-  console.log(`   Environment: ${env.NODE_ENV}`)
-  console.log(`   Server: ${helpers.getServerUrl()}`)
-  console.log(`   Client: ${helpers.getClientUrl()}`) 
-  console.log(`   Database: ${helpers.getDatabaseUrl() || 'not configured'}`)
-  console.log(`   Debug: ${env.DEBUG ? 'enabled' : 'disabled'}`)
-  console.log(`   Swagger: ${env.ENABLE_SWAGGER ? 'enabled' : 'disabled'}`)
-}
-
-// ========================================
-// 8. FLUXSTACK INTEGRATION SIMPLIFICADA
-// ========================================
-
-import { FluxStackFramework } from '../core/framework/server'
-
-export function createSimpleFluxStack() {
-  validateEnvironment()
-  
-  const app = new FluxStackFramework({
-    app: {
-      name: env.FLUXSTACK_APP_NAME,        // Direto!
-      version: env.FLUXSTACK_APP_VERSION   // Direto!
-    },
-    
-    server: {
-      port: env.PORT,                      // Direto! (number)
-      host: env.HOST,                      // Direto! (string)
-      apiPrefix: env.API_PREFIX,           // Direto! (string)
-      cors: {
-        origins: env.CORS_ORIGINS,         // Direto! (string[])
-        credentials: env.get('CORS_CREDENTIALS', false) // boolean
-      }
-    },
-    
-    client: {
-      port: env.VITE_PORT,                 // Direto! (number)
-      proxy: {
-        target: helpers.getServerUrl()     // Helper!
-      }
-    }
-  })
-  
-  // Plugins condicionais
-  if (env.ENABLE_SWAGGER) {
-    console.log('📋 Swagger enabled')
-    // app.use(swaggerPlugin)  
-  }
-  
-  if (env.ENABLE_MONITORING) {
-    console.log('📊 Monitoring enabled')
-    // app.use(monitoringPlugin)
-  }
-  
-  return app
-}
-
-// ========================================  
-// 9. COMPARAÇÃO ANTES vs DEPOIS
-// ========================================
-
-// ❌ ANTES - Verboso
-const beforeConfig = {
-  port: env.num('PORT', 3000),
-  debug: env.bool('DEBUG', false),
-  origins: env.array('CORS_ORIGINS', ['*']),
-  retries: env.num('MAX_RETRIES', 3),
-  timeout: env.num('TIMEOUT', 30000)
-}
-
-// ✅ DEPOIS - Limpo e elegante  
-const afterConfig = {
-  port: env.get('PORT', 3000),        // casting automático
-  debug: env.get('DEBUG', false),     // casting automático
-  origins: env.get('CORS_ORIGINS', ['*']), // casting automático
-  retries: env.get('MAX_RETRIES', 3), // casting automático
-  timeout: env.get('TIMEOUT', 30000)  // casting automático
-}
-
-// Ou ainda mais simples com propriedades diretas:
-const simpleConfig = {
-  port: env.PORT,           // Direto da propriedade
-  debug: env.DEBUG,         // Direto da propriedade
-  origins: env.CORS_ORIGINS // Direto da propriedade
-}
-
-export default {
-  createSimpleServer,
-  createConditionalConfig,
-  validateEnvironment,
-  printConfiguration,
-  createSimpleFluxStack
-}

package/meu-app-teste/README.md

@@ -1,44 +0,0 @@
-# meu-app-teste
-
-⚡ **FluxStack Application** - Modern full-stack TypeScript framework
-
-## 🚀 Getting Started
-
-```bash
-# Start development
-bun run dev
-
-# Build for production  
-bun run build
-
-# Start production server
-bun run start
-```
-
-## 📁 Project Structure
-
-```
-meu-app-teste/
-├── core/          # FluxStack framework (don't modify)
-├── app/           # Your application code
-│   ├── server/    # Backend API routes
-│   ├── client/    # Frontend React app
-│   └── shared/    # Shared types and utilities
-└── package.json
-```
-
-## 🔥 Features
-
-- **⚡ Bun Runtime** - 3x faster than Node.js
-- **🔒 Full Type Safety** - Eden Treaty + TypeScript
-- **🎨 Modern UI** - React 19 + Tailwind CSS v4
-- **📋 Auto Documentation** - Swagger UI generated
-- **🔄 Hot Reload** - Backend + Frontend
-
-## 📖 Learn More
-
-Visit the [FluxStack Documentation](https://fluxstack.dev) to learn more!
-
----
-
-Built with ❤️ using FluxStack

package/meu-app-teste/app/client/README.md

@@ -1,69 +0,0 @@
-# React + TypeScript + Vite
-
-This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
-
-Currently, two official plugins are available:
-
-- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Babel](https://babeljs.io/) for Fast Refresh
-- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
-
-## Expanding the ESLint configuration
-
-If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:
-
-```js
-export default tseslint.config([
-  globalIgnores(['dist']),
-  {
-    files: ['**/*.{ts,tsx}'],
-    extends: [
-      // Other configs...
-
-      // Remove tseslint.configs.recommended and replace with this
-      ...tseslint.configs.recommendedTypeChecked,
-      // Alternatively, use this for stricter rules
-      ...tseslint.configs.strictTypeChecked,
-      // Optionally, add this for stylistic rules
-      ...tseslint.configs.stylisticTypeChecked,
-
-      // Other configs...
-    ],
-    languageOptions: {
-      parserOptions: {
-        project: ['./tsconfig.node.json', './tsconfig.app.json'],
-        tsconfigRootDir: import.meta.dirname,
-      },
-      // other options...
-    },
-  },
-])
-```
-
-You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:
-
-```js
-// eslint.config.js
-import reactX from 'eslint-plugin-react-x'
-import reactDom from 'eslint-plugin-react-dom'
-
-export default tseslint.config([
-  globalIgnores(['dist']),
-  {
-    files: ['**/*.{ts,tsx}'],
-    extends: [
-      // Other configs...
-      // Enable lint rules for React
-      reactX.configs['recommended-typescript'],
-      // Enable lint rules for React DOM
-      reactDom.configs.recommended,
-    ],
-    languageOptions: {
-      parserOptions: {
-        project: ['./tsconfig.node.json', './tsconfig.app.json'],
-        tsconfigRootDir: import.meta.dirname,
-      },
-      // other options...
-    },
-  },
-])
-```

package/meu-app-teste/app/client/frontend-only.ts

@@ -1,12 +0,0 @@
-// Frontend standalone entry point
-import { startFrontendOnly } from "../../core/client/standalone"
-
-// Configuração para frontend standalone
-const frontendConfig = {
-  clientPath: "app/client",
-  vitePort: (globalThis as any).process?.env?.FRONTEND_PORT || 5173,
-  apiUrl: (globalThis as any).process?.env?.API_URL || "http://localhost:3001"
-}
-
-// Iniciar apenas o frontend
-startFrontendOnly(frontendConfig)

package/meu-app-teste/app/client/index.html

@@ -1,13 +0,0 @@
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Vite + React + TS</title>
-  </head>
-  <body>
-    <div id="root"></div>
-    <script type="module" src="/src/main.tsx"></script>
-  </body>
-</html>

package/meu-app-teste/app/client/public/vite.svg

@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>