create-fluxstack 1.0.1 → 1.0.3

package/fluxstack.config.ts

@@ -0,0 +1,318 @@
+/**
+ * FluxStack Configuration
+ * Enhanced configuration with comprehensive settings and environment support
+ * Updated to use dynamic environment variables
+ */
+
+import type { FluxStackConfig } from './core/config/schema'
+import { env, helpers } from './core/utils/env-runtime-v2'
+
+console.log(`🔧 Loading FluxStack config for ${env.NODE_ENV} environment`)
+
+// Main FluxStack configuration with dynamic env vars
+export const config: FluxStackConfig = {
+  // Application metadata
+  app: {
+    name: env.FLUXSTACK_APP_NAME,        // Direto! (string)
+    version: env.FLUXSTACK_APP_VERSION,  // Direto! (string)
+    description: env.get('FLUXSTACK_APP_DESCRIPTION', 'A FluxStack application')
+  },
+
+  // Server configuration
+  server: {
+    port: env.PORT,                      // Direto! (number)
+    host: env.HOST,                      // Direto! (string)
+    apiPrefix: env.API_PREFIX,           // Direto! (string)
+    cors: {
+      origins: env.CORS_ORIGINS,           // Direto! (string[])
+      methods: env.get('CORS_METHODS', ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS']),
+      headers: env.get('CORS_HEADERS', ['Content-Type', 'Authorization']),
+      credentials: env.get('CORS_CREDENTIALS', false),  // boolean casting
+      maxAge: env.get('CORS_MAX_AGE', 86400)           // number casting
+    },
+    middleware: []
+  },
+
+  // Client configuration
+  client: {
+    port: env.VITE_PORT,                 // Direto! (number)
+    proxy: {
+      target: helpers.getServerUrl(),    // Helper inteligente
+      changeOrigin: env.get('PROXY_CHANGE_ORIGIN', true)
+    },
+    build: {
+      sourceMaps: env.get('CLIENT_SOURCEMAPS', helpers.isDevelopment()),
+      minify: env.get('CLIENT_MINIFY', helpers.isProduction()),
+      target: env.get('CLIENT_TARGET', 'esnext'),
+      outDir: env.get('CLIENT_OUTDIR', 'dist/client')
+    }
+  },
+
+  // Build configuration
+  build: {
+    target: env.get('BUILD_TARGET', 'bun'),   // string casting
+    outDir: env.get('BUILD_OUTDIR', 'dist'),  // string
+    optimization: {
+      minify: env.get('BUILD_MINIFY', helpers.isProduction()),
+      treeshake: env.get('BUILD_TREESHAKE', helpers.isProduction()),
+      compress: env.get('BUILD_COMPRESS', helpers.isProduction()),
+      splitChunks: env.get('BUILD_SPLIT_CHUNKS', true),
+      bundleAnalyzer: env.get('BUILD_ANALYZER', helpers.isDevelopment())
+    },
+    sourceMaps: env.get('BUILD_SOURCEMAPS', !helpers.isProduction()),
+    clean: env.get('BUILD_CLEAN', true)
+  },
+
+  // Plugin configuration
+  plugins: {
+    enabled: env.get('FLUXSTACK_PLUGINS_ENABLED', ['logger', 'swagger', 'vite', 'cors']),
+    disabled: env.get('FLUXSTACK_PLUGINS_DISABLED', []),
+    config: {
+      // Plugin-specific configurations can be added here
+      logger: {
+        // Logger plugin config will be handled by logging section
+      },
+      swagger: {
+        title: env.get('SWAGGER_TITLE', 'FluxStack API'),
+        version: env.get('SWAGGER_VERSION', '1.0.0'),
+        description: env.get('SWAGGER_DESCRIPTION', 'API documentation for FluxStack application')
+      }
+    }
+  },
+
+  // Logging configuration
+  logging: {
+    level: env.LOG_LEVEL as any,         // Direto! (com smart default)
+    format: env.get('LOG_FORMAT', helpers.isDevelopment() ? 'pretty' : 'json'),
+    transports: [
+      {
+        type: 'console' as const,
+        level: env.LOG_LEVEL as any,     // Direto! (com smart default)
+        format: env.get('LOG_FORMAT', helpers.isDevelopment() ? 'pretty' : 'json')
+      }
+    ]
+  },
+
+  // Monitoring configuration
+  monitoring: {
+    enabled: env.ENABLE_MONITORING,      // Direto! (boolean)
+    metrics: {
+      enabled: env.ENABLE_METRICS,       // Direto! (boolean)
+      collectInterval: env.get('METRICS_INTERVAL', 5000),  // number casting
+      httpMetrics: env.get('HTTP_METRICS', true),
+      systemMetrics: env.get('SYSTEM_METRICS', true),
+      customMetrics: env.get('CUSTOM_METRICS', false)
+    },
+    profiling: {
+      enabled: env.get('PROFILING_ENABLED', false),
+      sampleRate: env.get('PROFILING_SAMPLE_RATE', 0.1),   // number casting
+      memoryProfiling: env.get('MEMORY_PROFILING', false),
+      cpuProfiling: env.get('CPU_PROFILING', false)
+    },
+    exporters: env.get('MONITORING_EXPORTERS', [])         // array casting
+  },
+
+  // Optional database configuration
+  ...(env.has('DATABASE_URL') || env.has('DATABASE_HOST') ? {
+    database: {
+      url: env.DATABASE_URL,               // Direto! (string)
+      host: env.DB_HOST,                   // Direto! (string)
+      port: env.DB_PORT,                   // Direto! (number)
+      database: env.DB_NAME,               // Direto! (string)
+      user: env.DB_USER,                   // Direto! (string)
+      password: env.DB_PASSWORD,           // Direto! (string)
+      ssl: env.DB_SSL,                     // Direto! (boolean)
+      poolSize: env.get('DB_POOL_SIZE', 10)  // number casting
+    }
+  } : {}),
+
+  // Optional authentication configuration
+  ...(env.has('JWT_SECRET') ? {
+    auth: {
+      secret: env.JWT_SECRET,              // Direto! (string)
+      expiresIn: env.get('JWT_EXPIRES_IN', '24h'),
+      algorithm: env.get('JWT_ALGORITHM', 'HS256'),
+      issuer: env.get('JWT_ISSUER')
+    }
+  } : {}),
+
+  // Optional email configuration
+  ...(env.has('SMTP_HOST') ? {
+    email: {
+      host: env.SMTP_HOST,                 // Direto! (string)
+      port: env.SMTP_PORT,                 // Direto! (number)
+      user: env.SMTP_USER,                 // Direto! (string)
+      password: env.SMTP_PASSWORD,         // Direto! (string)
+      secure: env.SMTP_SECURE,             // Direto! (boolean)
+      from: env.get('SMTP_FROM')
+    }
+  } : {}),
+
+  // Optional storage configuration
+  ...(env.has('UPLOAD_PATH') || env.has('STORAGE_PROVIDER') ? {
+    storage: {
+      uploadPath: env.get('UPLOAD_PATH'),
+      maxFileSize: env.get('MAX_FILE_SIZE', 10485760),  // 10MB default
+      allowedTypes: env.get('ALLOWED_FILE_TYPES', []),  // array casting
+      provider: env.get('STORAGE_PROVIDER', 'local'),
+      config: env.get('STORAGE_CONFIG', {})             // object casting
+    }
+  } : {}),
+
+  // Environment-specific overrides
+  environments: {
+    development: {
+      logging: {
+        level: 'debug',
+        format: 'pretty',
+        transports: [
+          {
+            type: 'console',
+            level: 'debug',
+            format: 'pretty'
+          }
+        ]
+      },
+      client: {
+        port: 5173,
+        proxy: { target: 'http://localhost:3000' },
+        build: {
+          minify: false,
+          sourceMaps: true,
+          target: 'es2020',
+          outDir: 'dist'
+        }
+      },
+      build: {
+        target: 'bun',
+        outDir: 'dist',
+        optimization: {
+          minify: false,
+          compress: false,
+          treeshake: false,
+          splitChunks: false,
+          bundleAnalyzer: false
+        },
+        sourceMaps: true,
+        clean: true
+      },
+      monitoring: {
+        enabled: false,
+        metrics: { enabled: false, collectInterval: 5000, httpMetrics: false, systemMetrics: false, customMetrics: false },
+        profiling: { enabled: false, sampleRate: 0.1, memoryProfiling: false, cpuProfiling: false },
+        exporters: []
+      }
+    },
+
+    production: {
+      logging: {
+        level: 'warn',
+        format: 'json',
+        transports: [
+          {
+            type: 'console',
+            level: 'warn',
+            format: 'json'
+          },
+          {
+            type: 'file',
+            level: 'error',
+            format: 'json',
+            options: {
+              filename: 'logs/error.log',
+              maxSize: '10m',
+              maxFiles: 5
+            }
+          }
+        ]
+      },
+      client: {
+        port: 5173,
+        proxy: { target: 'http://localhost:3000' },
+        build: {
+          minify: true,
+          sourceMaps: false,
+          target: 'es2020',
+          outDir: 'dist'
+        }
+      },
+      build: {
+        target: 'bun',
+        outDir: 'dist',
+        optimization: {
+          minify: true,
+          treeshake: true,
+          compress: true,
+          splitChunks: true,
+          bundleAnalyzer: false
+        },
+        sourceMaps: false,
+        clean: true
+      },
+      monitoring: {
+        enabled: true,
+        metrics: {
+          enabled: true,
+          collectInterval: 10000,
+          httpMetrics: true,
+          systemMetrics: true,
+          customMetrics: false
+        },
+        profiling: {
+          enabled: true,
+          sampleRate: 0.01, // Lower sample rate in production
+          memoryProfiling: true,
+          cpuProfiling: false
+        },
+        exporters: ['console', 'file']
+      }
+    },
+
+    test: {
+      logging: {
+        level: 'error',
+        format: 'json',
+        transports: [
+          {
+            type: 'console',
+            level: 'error',
+            format: 'json'
+          }
+        ]
+      },
+      server: {
+        port: 0, // Use random available port
+        host: 'localhost',
+        apiPrefix: '/api',
+        cors: { origins: [], methods: [], headers: [] },
+        middleware: []
+      },
+      client: {
+        port: 0, // Use random available port
+        proxy: { target: 'http://localhost:3000' },
+        build: { sourceMaps: true, minify: false, target: 'es2020', outDir: 'dist' }
+      },
+      monitoring: {
+        enabled: false,
+        metrics: { enabled: false, collectInterval: 5000, httpMetrics: false, systemMetrics: false, customMetrics: false },
+        profiling: { enabled: false, sampleRate: 0.1, memoryProfiling: false, cpuProfiling: false },
+        exporters: []
+      }
+    }
+  },
+
+  // Custom configuration for application-specific settings
+  custom: {
+    // Add any custom configuration here
+    // This will be merged with environment variables prefixed with FLUXSTACK_
+  }
+}
+
+// Export as default for ES modules
+export default config
+
+// Named export for backward compatibility
+export { config as fluxStackConfig }
+
+// Export type for TypeScript users
+export type { FluxStackConfig } from './core/config/schema'

package/meu-app-teste/README.md

@@ -0,0 +1,44 @@
+# 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

@@ -0,0 +1,69 @@
+# 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

@@ -0,0 +1,12 @@
+// 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

@@ -0,0 +1,13 @@
+<!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

@@ -0,0 +1 @@
+<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>