create-fluxstack 1.7.4 → 1.8.1

package/.dockerignore

@@ -0,0 +1,82 @@
+# =====================================
+# FluxStack Docker Ignore
+# =====================================
+
+# Node modules (will be installed in container)
+node_modules/
+**/node_modules/
+
+# Build artifacts (will be built in container)
+dist/
+**/dist/
+
+# Development files
+.git/
+.github/
+.vscode/
+.idea/
+
+# Environment files
+.env
+.env.*
+!.env.example
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+bun-debug.log*
+lerna-debug.log*
+
+# Testing
+coverage/
+.nyc_output/
+**/__tests__/
+**/*.test.ts
+**/*.test.tsx
+**/*.spec.ts
+**/*.spec.tsx
+
+# Documentation
+*.md
+!README.md
+ai-context/
+docs/
+
+# Development tools
+.eslintrc*
+.prettierrc*
+tsconfig*.json
+vitest.config.ts
+vite.config.ts
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Temporary files
+tmp/
+temp/
+*.tmp
+*.swp
+*.swo
+*~
+
+# Lock files (exclude other package managers, keep bun.lock)
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+
+# CI/CD
+.github/
+
+# Editor directories
+.vscode/
+.idea/
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?

package/Dockerfile

@@ -0,0 +1,70 @@
+# 🐳 FluxStack Production Dockerfile
+# Multi-stage build for optimized production image
+
+# =====================================
+# Stage 1: Dependencies
+# =====================================
+FROM oven/bun:1.1.34-alpine AS deps
+
+WORKDIR /app
+
+# Copy package files
+COPY package.json bun.lock ./
+
+# Install production dependencies only
+RUN bun install --production --frozen-lockfile
+
+# =====================================
+# Stage 2: Builder
+# =====================================
+FROM oven/bun:1.1.34-alpine AS builder
+
+WORKDIR /app
+
+# Copy package files and install all dependencies (including dev)
+COPY package.json bun.lock ./
+RUN bun install --frozen-lockfile
+
+# Copy source code
+COPY . .
+
+# Build the application
+RUN bun run build
+
+# =====================================
+# Stage 3: Production Runner
+# =====================================
+FROM oven/bun:1.1.34-alpine AS runner
+
+WORKDIR /app
+
+# Set production environment
+ENV NODE_ENV=production
+ENV PORT=3000
+
+# Create non-root user for security
+RUN addgroup -g 1001 -S fluxstack && \
+    adduser -S fluxstack -u 1001
+
+# Copy production dependencies from deps stage
+COPY --from=deps --chown=fluxstack:fluxstack /app/node_modules ./node_modules
+
+# Copy built application from builder stage
+COPY --from=builder --chown=fluxstack:fluxstack /app/dist ./dist
+COPY --from=builder --chown=fluxstack:fluxstack /app/package.json ./
+
+# Copy config directory (required for runtime configuration)
+COPY --from=builder --chown=fluxstack:fluxstack /app/config ./config
+
+# Switch to non-root user
+USER fluxstack
+
+# Expose application port
+EXPOSE 3000
+
+# Health check disabled for now
+# HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \
+#   CMD bun run -e 'fetch("http://localhost:3000/api/health").then(r => r.ok ? process.exit(0) : process.exit(1))' || exit 1
+
+# Start the application
+CMD ["bun", "run", "start"]

package/app/server/app.ts

@@ -1,10 +1,25 @@
-// Export the main app type for Eden Treaty
-import { apiRoutes } from "./routes"
+/**
+ * 🎯 Application Instance - Single Source of Truth
+ *
+ * This instance is used by:
+ * - index.ts (full-stack mode)
+ * - backend-only.ts (backend standalone mode)
+ * - Eden Treaty client (type inference)
+ *
+ * This ensures that the type exported for Eden Treaty is exactly
+ * the same as what the server uses.
+ */
+
 import { Elysia } from "elysia"
+import { apiRoutes } from "./routes"
+import { envTestRoute } from "./routes/env-test"
 
-// Create the full app structure that matches the server
-const appInstance = new Elysia()
-  .use(apiRoutes)
+/**
+ * Main application instance with all routes registered
+ */
+export const appInstance = new Elysia()
+  .use(envTestRoute)  // Environment test/debug endpoint
+  .use(apiRoutes)     // Main application routes
 
 // Export the type correctly for Eden Treaty
 export type App = typeof appInstance

package/app/server/backend-only.ts

@@ -1,15 +1,18 @@
-// Backend standalone entry point
-import { startBackendOnly } from "@/core/server/standalone"
-import { apiRoutes } from "./routes"
-import { serverConfig } from "@/config/server.config"
+/**
+ * Backend Standalone Entry Point
+ *
+ * This is a minimal wrapper for starting the backend in standalone mode.
+ * The core logic is protected in @/core/server/backend-entry.ts
+ *
+ * You can customize the configuration here if needed.
+ */
 
-// Configuração para backend standalone usando config declarativo
-const backendConfig = {
-  port: serverConfig.backendPort,
-  apiPrefix: serverConfig.apiPrefix
-}
+import { startBackend, createBackendConfig } from "@/core/server/backend-entry"
+import { appInstance } from "./app"
+import { serverConfig } from "@/config/server.config"
 
-console.log(`🚀 Backend standalone: ${serverConfig.host}:${backendConfig.port}`)
+// Create backend configuration from declarative config
+const backendConfig = createBackendConfig(serverConfig)
 
-// Iniciar apenas o backend
-startBackendOnly(apiRoutes, backendConfig)
+// Start backend in standalone mode
+startBackend(appInstance, backendConfig)

package/app/server/index.ts

@@ -1,125 +1,112 @@
-// User application entry point
-import { FluxStackFramework, vitePlugin, swaggerPlugin, staticPlugin, liveComponentsPlugin, staticFilesPlugin } from "@/core/server"
+/**
+ * 🚀 FluxStack Application Server Entry Point
+ * Main server configuration and initialization
+ */
+
+// ===== Core Framework =====
+import { FluxStackFramework } from "@/core/server"
 import { isDevelopment } from "@/core/utils/helpers"
 import { DEBUG } from "@/core/utils/logger"
-import { apiRoutes } from "./routes"
 import { helpers } from "@/core/utils/env"
-import { serverConfig } from "@/config/server.config"
+
+// ===== Configuration =====
 import { appConfig } from "@/config/app.config"
-import { loggerConfig } from "@/config/logger.config"
+import { serverConfig } from "@/config/server.config"
+
+// ===== Plugins =====
+import {
+  vitePlugin,
+  swaggerPlugin,
+  staticPlugin,
+  liveComponentsPlugin,
+  staticFilesPlugin
+} from "@/core/server"
 import cryptoAuthPlugin from "@/plugins/crypto-auth"
-import "./live/register-components"
 
-// Startup info moved to DEBUG level (set LOG_LEVEL=debug to see details)
+// ===== Application Routes =====
+import { appInstance } from "./app"
+
+// NOTE: Live Components auto-discovery is handled by liveComponentsPlugin
+// No need to import "./live/register-components" anymore
+
+// ===== Startup Logging =====
 DEBUG('🔧 Loading declarative configuration...')
 DEBUG(`📊 Environment: ${appConfig.env}`)
-DEBUG(`🚀 Port: ${serverConfig.port}`)
-DEBUG(`🌐 Host: ${serverConfig.host}`)
-
-// Criar aplicação com configuração declarativa
-const app = new FluxStackFramework({
-  server: {
-    port: serverConfig.port,
-    host: serverConfig.host,
-    apiPrefix: serverConfig.apiPrefix,
-    cors: {
-      origins: serverConfig.corsOrigins,
-      methods: serverConfig.corsMethods,
-      headers: serverConfig.corsHeaders,
-      credentials: serverConfig.corsCredentials
+DEBUG(`🚀 Port: ${serverConfig.server.port}`)
+DEBUG(`🌐 Host: ${serverConfig.server.host}`)
+
+// ===== Framework Configuration Helper =====
+/**
+ * Creates FluxStack framework configuration from declarative configs
+ */
+function createFrameworkConfig() {
+  return {
+    server: {
+      port: serverConfig.server.port,
+      host: serverConfig.server.host,
+      apiPrefix: serverConfig.server.apiPrefix,
+      cors: {
+        origins: serverConfig.cors.origins,
+        methods: serverConfig.cors.methods,
+        headers: serverConfig.cors.headers,
+        credentials: serverConfig.cors.credentials
+      },
+      middleware: []
     },
-    middleware: []
-  },
-  app: {
-    name: serverConfig.appName,
-    version: serverConfig.appVersion
-  },
-  client: {
-    port: serverConfig.clientPort,
-    proxy: {
-      target: helpers.getServerUrl()
+    app: {
+      name: appConfig.name,
+      version: appConfig.version
     },
-    build: {
-      sourceMaps: serverConfig.clientSourceMaps,
-      minify: false,
-      target: serverConfig.clientTarget as any,
-      outDir: serverConfig.clientOutDir
+    client: {
+      port: serverConfig.server.backendPort,
+      proxy: {
+        target: helpers.getServerUrl()
+      },
+      build: {
+        sourceMaps: false,
+        minify: false,
+        target: 'es2020' as any,
+        outDir: 'dist'
+      }
     }
   }
-})
+}
 
+// ===== Initialize Application =====
+const app = new FluxStackFramework(createFrameworkConfig())
 
-// Usar plugins de infraestrutura primeiro (Logger é core, não é plugin)
+// ===== Register Plugins =====
+// Note: Logger is part of core, not a plugin
 
-// Registrar plugin de autenticação ANTES dos outros plugins
+// 1. Authentication plugin (must be registered first)
 app.use(cryptoAuthPlugin)
 
-// Usar plugins condicionalmente baseado no ambiente
+// 2. Development/Production plugins (conditional)
 if (isDevelopment()) {
-  app.use(vitePlugin)
+  app.use(vitePlugin)  // Development: Vite dev server
 } else {
-  app.use(staticPlugin)
+  app.use(staticPlugin)  // Production: Static file serving
 }
 
-// Add static files AFTER Vite to avoid conflicts, but BEFORE Live Components
-app.use(staticFilesPlugin) // Add Static Files support 
-app.use(liveComponentsPlugin) // Add Live Components support
-  
+// 3. Static files (after Vite, before Live Components to avoid conflicts)
+app.use(staticFilesPlugin)
 
-// Adicionar rota de teste para mostrar config declarativo (antes das rotas)
-app.getApp().get('/api/env-test', () => {
-  return {
-    message: '⚡ Declarative Config System!',
-    timestamp: new Date().toISOString(),
-    serverConfig: {
-      port: serverConfig.port,
-      host: serverConfig.host,
-      apiPrefix: serverConfig.apiPrefix,
-      appName: serverConfig.appName,
-      appVersion: serverConfig.appVersion,
-      cors: {
-        origins: serverConfig.corsOrigins,
-        methods: serverConfig.corsMethods,
-        credentials: serverConfig.corsCredentials
-      },
-      client: {
-        port: serverConfig.clientPort,
-        target: serverConfig.clientTarget,
-        sourceMaps: serverConfig.clientSourceMaps
-      },
-      features: {
-        enableSwagger: serverConfig.enableSwagger,
-        enableMetrics: serverConfig.enableMetrics,
-        enableMonitoring: serverConfig.enableMonitoring
-      }
-    },
-    environment: {
-      NODE_ENV: appConfig.env,
-      DEBUG: appConfig.debug,
-      LOG_LEVEL: loggerConfig.level
-    },
-    urls: {
-      server: helpers.getServerUrl(),
-      client: helpers.getClientUrl(),
-      swagger: `${helpers.getServerUrl()}/swagger`
-    },
-    system: {
-      version: 'declarative-config',
-      features: ['type-safe', 'validated', 'declarative', 'runtime-reload']
-    }
-  }
-})
+// 4. Live Components (WebSocket support)
+app.use(liveComponentsPlugin)
 
-// Registrar rotas da aplicação DEPOIS da rota de teste
-app.routes(apiRoutes)
+// ===== Register Routes =====
+// Note: Routes are now registered in app.ts (including envTestRoute)
+app.routes(appInstance)
 
-// Swagger por último para descobrir todas as rotas
+// ===== Final Setup =====
+
+// Swagger documentation (must be last to discover all routes)
 app.use(swaggerPlugin)
 
-// Iniciar servidor (banner displayed by framework)
+// ===== Start Server =====
+// Banner will be displayed automatically by the framework
 app.listen()
 
-
-
-// Exportar tipo da aplicação para Eden Treaty (método correto)
+// ===== Eden Treaty Type Export =====
+// Export application type for type-safe client communication
 export type App = typeof app

package/app/server/live/FluxStackConfig.ts

@@ -160,9 +160,9 @@ export class FluxStackConfig extends LiveComponent<FluxStackConfigState> {
     // Set default state with real configuration
     this.state = {
       environment: appConfig.env,
-      port: serverConfig.port,
-      host: serverConfig.host,
-      apiPrefix: serverConfig.apiPrefix,
+      port: serverConfig.server.port,
+      host: serverConfig.server.host,
+      apiPrefix: serverConfig.server.apiPrefix,
       
       framework: {
         name: 'FluxStack',
@@ -439,8 +439,8 @@ export class FluxStackConfig extends LiveComponent<FluxStackConfigState> {
   async getEnvironmentVariables() {
     const envVars = {
       NODE_ENV: appConfig.env,
-      PORT: serverConfig.port.toString(),
-      HOST: serverConfig.host,
+      PORT: serverConfig.server.port.toString(),
+      HOST: serverConfig.server.host,
       LOG_LEVEL: loggerConfig.level,
       // Add other non-sensitive env vars from system config
       PWD: systemConfig.pwd || undefined,

package/app/server/routes/env-test.ts

@@ -0,0 +1,59 @@
+/**
+ * 🔧 Environment Test Route
+ * Displays current configuration for debugging purposes
+ */
+
+import { Elysia } from 'elysia'
+import { appConfig } from '@/config/app.config'
+import { serverConfig } from '@/config/server.config'
+import { loggerConfig } from '@/config/logger.config'
+import { appRuntimeConfig } from '@/config/runtime.config'
+import { helpers } from '@/core/utils/env'
+
+/**
+ * Environment test endpoint
+ * Shows declarative config system information
+ */
+export const envTestRoute = new Elysia({ prefix: '/api' })
+  .get('/env-test', () => {
+    return {
+      message: '⚡ Declarative Config System!',
+      timestamp: new Date().toISOString(),
+      serverConfig: {
+        port: serverConfig.server.port,
+        host: serverConfig.server.host,
+        apiPrefix: serverConfig.server.apiPrefix,
+        appName: appConfig.name,
+        appVersion: appConfig.version,
+        cors: {
+          origins: serverConfig.cors.origins,
+          methods: serverConfig.cors.methods,
+          credentials: serverConfig.cors.credentials
+        },
+        client: {
+          port: serverConfig.server.backendPort,
+          target: 'es2020',
+          sourceMaps: false
+        },
+        features: {
+          enableSwagger: appRuntimeConfig.values.enableSwagger,
+          enableMetrics: appRuntimeConfig.values.enableMetrics,
+          enableMonitoring: appRuntimeConfig.values.enableMonitoring
+        }
+      },
+      environment: {
+        NODE_ENV: appConfig.env,
+        DEBUG: appRuntimeConfig.values.enableDebugMode,
+        LOG_LEVEL: loggerConfig.level
+      },
+      urls: {
+        server: helpers.getServerUrl(),
+        client: helpers.getClientUrl(),
+        swagger: `${helpers.getServerUrl()}/swagger`
+      },
+      system: {
+        version: 'declarative-config',
+        features: ['type-safe', 'validated', 'declarative', 'runtime-reload']
+      }
+    }
+  })

package/config/app.config.ts

@@ -1,6 +1,6 @@
 /**
  * Application Configuration
- * Laravel-style declarative config with validation
+ * Core application metadata and global settings
  */
 
 import { defineConfig, config } from '@/core/utils/config-schema'
@@ -8,6 +8,7 @@ import { FLUXSTACK_VERSION } from '@/core/utils/version'
 
 /**
  * App configuration schema
+ * Contains only app-level metadata and global feature flags
  */
 const appConfigSchema = {
   // App basics
@@ -25,52 +26,9 @@ const appConfigSchema = {
   // Environment
   env: config.enum('NODE_ENV', ['development', 'production', 'test'] as const, 'development', true),
 
-  debug: config.boolean('DEBUG', false),
-
-  // Server
-  port: {
-    type: 'number' as const,
-    env: 'PORT',
-    default: 3000,
-    required: true,
-    validate: (value: number) => {
-      if (value < 1 || value > 65535) {
-        return 'Port must be between 1 and 65535'
-      }
-      return true
-    }
-  },
-
-  host: config.string('HOST', 'localhost', true),
-
-  apiPrefix: {
-    type: 'string' as const,
-    env: 'API_PREFIX',
-    default: '/api',
-    validate: (value: string) => value.startsWith('/') || 'API prefix must start with /'
-  },
-
   // URLs
   url: config.string('APP_URL', undefined, false),
 
-  // Features
-  enableSwagger: config.boolean('ENABLE_SWAGGER', true),
-  enableMetrics: config.boolean('ENABLE_METRICS', false),
-  enableMonitoring: config.boolean('ENABLE_MONITORING', false),
-
-  // Client
-  clientPort: config.number('VITE_PORT', 5173),
-
-  // Logging
-  logLevel: config.enum('LOG_LEVEL', ['debug', 'info', 'warn', 'error'] as const, 'info'),
-  logFormat: config.enum('LOG_FORMAT', ['json', 'pretty'] as const, 'pretty'),
-
-  // CORS
-  corsOrigins: config.array('CORS_ORIGINS', ['*']),
-  corsMethods: config.array('CORS_METHODS', ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS']),
-  corsHeaders: config.array('CORS_HEADERS', ['Content-Type', 'Authorization']),
-  corsCredentials: config.boolean('CORS_CREDENTIALS', false),
-
   // Security
   trustProxy: config.boolean('TRUST_PROXY', false),
 
@@ -100,15 +58,5 @@ export type AppConfig = typeof appConfig
  */
 export type Environment = typeof appConfig.env
 
-/**
- * Type-safe log level type
- */
-export type LogLevel = typeof appConfig.logLevel
-
-/**
- * Type-safe log format type
- */
-export type LogFormat = typeof appConfig.logFormat
-
 // Export default
 export default appConfig

package/config/client.config.ts

@@ -0,0 +1,95 @@
+/**
+ * Client & Vite Configuration
+ * Declarative client, proxy and Vite dev server configuration
+ */
+
+import { defineConfig, defineNestedConfig, config } from '@/core/utils/config-schema'
+import { env, helpers } from '@/core/utils/env'
+
+/**
+ * Vite Dev Server Configuration
+ */
+const viteSchema = {
+  port: config.number('VITE_PORT', 5173, true),
+
+  host: config.string('VITE_HOST', 'localhost'),
+
+  strictPort: config.boolean('VITE_STRICT_PORT', false),
+
+  open: config.boolean('VITE_OPEN', false),
+
+  enableLogging: config.boolean('ENABLE_VITE_PROXY_LOGS', false)
+} as const
+
+/**
+ * API Proxy Configuration
+ */
+const proxySchema = {
+  target: {
+    type: 'string' as const,
+    env: 'PROXY_TARGET',
+    default: helpers.getServerUrl(),
+    required: false,
+    validate: (value: string) => {
+      if (!value) return true
+      try {
+        new URL(value)
+        return true
+      } catch {
+        return 'Proxy target must be a valid URL'
+      }
+    }
+  },
+
+  changeOrigin: config.boolean('PROXY_CHANGE_ORIGIN', true),
+
+  secure: config.boolean('PROXY_SECURE', false),
+
+  ws: config.boolean('PROXY_WS', true), // WebSocket support
+
+  rewrite: {
+    type: 'object' as const,
+    env: 'PROXY_REWRITE',
+    default: {},
+    required: false
+  }
+} as const
+
+/**
+ * Client Build Configuration
+ */
+const buildSchema = {
+  outDir: config.string('CLIENT_OUTDIR', 'dist/client'),
+
+  sourceMaps: config.boolean('CLIENT_SOURCEMAPS', helpers.isDevelopment()),
+
+  minify: config.boolean('CLIENT_MINIFY', helpers.isProduction()),
+
+  target: config.string('CLIENT_TARGET', 'esnext'),
+
+  assetsDir: config.string('CLIENT_ASSETS_DIR', 'assets'),
+
+  cssCodeSplit: config.boolean('CLIENT_CSS_CODE_SPLIT', true),
+
+  chunkSizeWarningLimit: config.number('CLIENT_CHUNK_SIZE_WARNING', 500), // KB
+
+  emptyOutDir: config.boolean('CLIENT_EMPTY_OUTDIR', true)
+} as const
+
+/**
+ * Client Configuration (nested)
+ */
+export const clientConfig = defineNestedConfig({
+  vite: viteSchema,
+  proxy: proxySchema,
+  build: buildSchema
+})
+
+// Export types
+export type ViteConfig = typeof clientConfig.vite
+export type ProxyConfig = typeof clientConfig.proxy
+export type ClientBuildConfig = typeof clientConfig.build
+export type ClientConfig = typeof clientConfig
+
+// Export default
+export default clientConfig