create-fluxstack 1.7.5 → 1.8.3

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

package/config/fluxstack.config.ts

@@ -4,8 +4,8 @@
  * @deprecated Use the configuration from the root fluxstack.config.ts instead
  */
 
-import { getConfigSync, createLegacyConfig } from '../core/config'
-import type { FluxStackConfig } from '../core/config'
+import { getConfigSync, createLegacyConfig } from '@/core/config'
+import type { FluxStackConfig } from '@/core/config'
 
 // Load the new configuration
 const newConfig = getConfigSync()

package/config/index.ts

@@ -5,72 +5,107 @@
  *
  * @example
  * ```ts
- * import { appConfig, databaseConfig, servicesConfig } from '@/config'
+ * import { appConfig, serverConfig, databaseConfig } from '@/config'
  *
  * // All configs are type-safe and validated!
- * console.log(appConfig.name)        // string
- * console.log(appConfig.port)        // number
- * console.log(appConfig.debug)       // boolean
+ * console.log(appConfig.name)                    // string
+ * console.log(serverConfig.server.port)          // number
+ * console.log(clientConfig.vite.port)            // number
  *
  * // Nested configs
- * console.log(servicesConfig.email.host)  // string
- * console.log(servicesConfig.jwt.secret)  // string
+ * console.log(servicesConfig.email.host)         // string
+ * console.log(monitoringConfig.metrics.enabled)  // boolean
  * ```
  */
 
+// ============================================================================
+// 📦 CONFIG EXPORTS
+// ============================================================================
+
 export { appConfig } from './app.config'
+export { serverConfig } from './server.config'
+export { clientConfig } from './client.config'
 export { databaseConfig } from './database.config'
 export { servicesConfig } from './services.config'
-export { serverConfig } from './server.config'
 export { loggerConfig } from './logger.config'
-export { buildConfig } from './build.config'
+export { pluginsConfig } from './plugins.config'
+export { monitoringConfig } from './monitoring.config'
 export { appRuntimeConfig } from './runtime.config'
 export { systemConfig, systemRuntimeInfo } from './system.config'
 
 // Plugin configs (re-exported for convenience)
 export { cryptoAuthConfig } from '../plugins/crypto-auth/config'
 
-// Re-export types
-export type { AppConfig } from './app.config'
+// ============================================================================
+// 📝 TYPE EXPORTS
+// ============================================================================
+
+// Core types
+export type { AppConfig, Environment } from './app.config'
+export type {
+  ServerConfig,
+  CorsConfig,
+  ServerFullConfig
+} from './server.config'
+export type {
+  ClientConfig,
+  ViteConfig,
+  ProxyConfig,
+  ClientBuildConfig
+} from './client.config'
 export type { DatabaseConfig } from './database.config'
-export type { ServerConfig } from './server.config'
-export type { LoggerConfig } from './logger.config'
-export type { BuildConfig } from './build.config'
-export type { SystemConfig, SystemRuntimeInfo } from './system.config'
 export type {
   EmailConfig,
   JWTConfig,
   StorageConfig,
   RedisConfig
 } from './services.config'
+export type { LoggerConfig } from './logger.config'
+export type { PluginsConfig } from './plugins.config'
+export type {
+  MonitoringConfig,
+  MetricsConfig,
+  ProfilingConfig,
+  MonitoringFullConfig
+} from './monitoring.config'
+export type { SystemConfig, SystemRuntimeInfo } from './system.config'
 
 // Plugin types
 export type { CryptoAuthConfig } from '../plugins/crypto-auth/config'
 
-/**
- * All configs in one object
- */
+// ============================================================================
+// 🎯 UNIFIED CONFIG OBJECT
+// ============================================================================
+
 import { appConfig } from './app.config'
+import { serverConfig } from './server.config'
+import { clientConfig } from './client.config'
 import { databaseConfig } from './database.config'
 import { servicesConfig } from './services.config'
-import { serverConfig } from './server.config'
 import { loggerConfig } from './logger.config'
-import { buildConfig } from './build.config'
+import { pluginsConfig } from './plugins.config'
+import { monitoringConfig } from './monitoring.config'
 import { appRuntimeConfig } from './runtime.config'
 import { systemConfig, systemRuntimeInfo } from './system.config'
 import { cryptoAuthConfig } from '../plugins/crypto-auth/config'
 
+/**
+ * All configs in one object
+ * Use this when you need access to multiple configs at once
+ */
 export const config = {
   app: appConfig,
+  server: serverConfig,
+  client: clientConfig,
   database: databaseConfig,
   services: servicesConfig,
-  server: serverConfig,
   logger: loggerConfig,
-  build: buildConfig,
+  plugins: pluginsConfig,
+  monitoring: monitoringConfig,
   runtime: appRuntimeConfig,
   system: systemConfig,
   systemRuntime: systemRuntimeInfo,
   cryptoAuth: cryptoAuthConfig
-}
+} as const
 
 export default config

package/config/monitoring.config.ts

@@ -0,0 +1,114 @@
+/**
+ * Monitoring Configuration
+ * Declarative monitoring, metrics and profiling configuration
+ */
+
+import { defineConfig, defineNestedConfig, config } from '@/core/utils/config-schema'
+import { helpers } from '@/core/utils/env'
+
+/**
+ * Metrics Configuration Schema
+ */
+const metricsSchema = {
+  enabled: config.boolean('ENABLE_METRICS', false),
+
+  collectInterval: {
+    type: 'number' as const,
+    env: 'METRICS_INTERVAL',
+    default: 5000,
+    validate: (value: number) => {
+      if (value < 1000) {
+        return 'Metrics interval must be at least 1000ms'
+      }
+      return true
+    }
+  },
+
+  httpMetrics: config.boolean('HTTP_METRICS', true),
+
+  systemMetrics: config.boolean('SYSTEM_METRICS', true),
+
+  customMetrics: config.boolean('CUSTOM_METRICS', false),
+
+  // Metric exporters
+  exportToConsole: config.boolean('METRICS_EXPORT_CONSOLE', helpers.isDevelopment()),
+
+  exportToFile: config.boolean('METRICS_EXPORT_FILE', false),
+
+  exportToHttp: config.boolean('METRICS_EXPORT_HTTP', false),
+
+  exportHttpUrl: config.string('METRICS_EXPORT_URL'),
+
+  // Metric storage
+  retentionPeriod: config.number('METRICS_RETENTION_PERIOD', 3600000), // 1 hour in ms
+
+  maxDataPoints: config.number('METRICS_MAX_DATA_POINTS', 1000)
+} as const
+
+/**
+ * Profiling Configuration Schema
+ */
+const profilingSchema = {
+  enabled: config.boolean('PROFILING_ENABLED', false),
+
+  sampleRate: {
+    type: 'number' as const,
+    env: 'PROFILING_SAMPLE_RATE',
+    default: helpers.isProduction() ? 0.01 : 0.1,
+    validate: (value: number) => {
+      if (value < 0 || value > 1) {
+        return 'Sample rate must be between 0 and 1'
+      }
+      return true
+    }
+  },
+
+  memoryProfiling: config.boolean('MEMORY_PROFILING', false),
+
+  cpuProfiling: config.boolean('CPU_PROFILING', false),
+
+  heapSnapshot: config.boolean('HEAP_SNAPSHOT', false),
+
+  // Profiling output
+  outputDir: config.string('PROFILING_OUTPUT_DIR', 'profiling'),
+
+  maxProfiles: config.number('PROFILING_MAX_PROFILES', 10)
+} as const
+
+/**
+ * Monitoring Configuration Schema
+ */
+const monitoringSchema = {
+  enabled: config.boolean('ENABLE_MONITORING', false),
+
+  // Exporters
+  exporters: config.array('MONITORING_EXPORTERS', []),
+
+  // Health checks
+  enableHealthChecks: config.boolean('ENABLE_HEALTH_CHECKS', true),
+
+  healthCheckInterval: config.number('HEALTH_CHECK_INTERVAL', 30000), // 30s
+
+  // Alerting
+  enableAlerts: config.boolean('ENABLE_ALERTS', false),
+
+  alertWebhook: config.string('ALERT_WEBHOOK')
+} as const
+
+/**
+ * Export monitoring config (nested)
+ */
+export const monitoringConfig = defineNestedConfig({
+  monitoring: monitoringSchema,
+  metrics: metricsSchema,
+  profiling: profilingSchema
+})
+
+// Export types
+export type MonitoringConfig = typeof monitoringConfig.monitoring
+export type MetricsConfig = typeof monitoringConfig.metrics
+export type ProfilingConfig = typeof monitoringConfig.profiling
+export type MonitoringFullConfig = typeof monitoringConfig
+
+// Export default
+export default monitoringConfig

package/config/plugins.config.ts

@@ -0,0 +1,80 @@
+/**
+ * Plugins Configuration
+ * Declarative plugin management configuration
+ */
+
+import { defineConfig, config } from '@/core/utils/config-schema'
+import { env } from '@/core/utils/env'
+import { FLUXSTACK_VERSION } from '@/core/utils/version'
+
+/**
+ * Plugins configuration schema
+ */
+const pluginsConfigSchema = {
+  // Plugin management
+  enabled: config.array(
+    'FLUXSTACK_PLUGINS_ENABLED',
+    ['logger', 'swagger', 'vite', 'cors', 'static-files', 'crypto-auth']
+  ),
+
+  disabled: config.array('FLUXSTACK_PLUGINS_DISABLED', []),
+
+  // Auto-discovery
+  autoDiscover: config.boolean('PLUGINS_AUTO_DISCOVER', true),
+
+  pluginsDir: config.string('PLUGINS_DIR', 'plugins'),
+
+  // Plugin-specific configurations
+  // Logger plugin (handled by logger.config.ts)
+  loggerEnabled: config.boolean('LOGGER_PLUGIN_ENABLED', true),
+
+  // Swagger plugin
+  swaggerEnabled: config.boolean('SWAGGER_ENABLED', true),
+  swaggerTitle: config.string('SWAGGER_TITLE', 'FluxStack API'),
+  swaggerVersion: config.string('SWAGGER_VERSION', FLUXSTACK_VERSION),
+  swaggerDescription: config.string(
+    'SWAGGER_DESCRIPTION',
+    'API documentation for FluxStack application'
+  ),
+  swaggerPath: config.string('SWAGGER_PATH', '/swagger'),
+
+  // Swagger advanced options
+  swaggerExcludePaths: config.array('SWAGGER_EXCLUDE_PATHS', []),
+
+  // Swagger servers (comma-separated list of URLs)
+  // Format: "url1|description1,url2|description2"
+  // Example: "https://api.prod.com|Production,https://api.staging.com|Staging"
+  swaggerServers: config.string('SWAGGER_SERVERS', ''),
+
+  // Swagger UI options
+  swaggerPersistAuthorization: config.boolean('SWAGGER_PERSIST_AUTH', true),
+  swaggerDisplayRequestDuration: config.boolean('SWAGGER_DISPLAY_DURATION', true),
+  swaggerEnableFilter: config.boolean('SWAGGER_ENABLE_FILTER', true),
+  swaggerShowExtensions: config.boolean('SWAGGER_SHOW_EXTENSIONS', true),
+  swaggerTryItOutEnabled: config.boolean('SWAGGER_TRY_IT_OUT', true),
+
+  // Swagger authentication (Basic Auth)
+  swaggerAuthEnabled: config.boolean('SWAGGER_AUTH_ENABLED', false),
+  swaggerAuthUsername: config.string('SWAGGER_AUTH_USERNAME', 'admin'),
+  swaggerAuthPassword: config.string('SWAGGER_AUTH_PASSWORD', ''),
+
+  // Static files plugin
+  staticFilesEnabled: config.boolean('STATIC_FILES_ENABLED', true),
+  staticPublicDir: config.string('STATIC_PUBLIC_DIR', 'public'),
+  staticUploadsDir: config.string('STATIC_UPLOADS_DIR', 'uploads'),
+  staticCacheMaxAge: config.number('STATIC_CACHE_MAX_AGE', 31536000), // 1 year
+  staticEnableUploads: config.boolean('STATIC_ENABLE_UPLOADS', true),
+  staticEnablePublic: config.boolean('STATIC_ENABLE_PUBLIC', true),
+
+  // CORS plugin (configuration via server.config.ts)
+  // Vite plugin
+  viteEnabled: config.boolean('VITE_PLUGIN_ENABLED', true)
+} as const
+
+export const pluginsConfig = defineConfig(pluginsConfigSchema)
+
+// Export type
+export type PluginsConfig = typeof pluginsConfig
+
+// Export default
+export default pluginsConfig

package/config/runtime.config.ts

@@ -16,19 +16,6 @@ export const appRuntimeConfig = defineReactiveConfig({
   enableMonitoring: config.boolean('ENABLE_MONITORING', false),
   enableDebugMode: config.boolean('DEBUG', false),
 
-  // Logging level can be changed in runtime
-  logLevel: config.enum(
-    'LOG_LEVEL',
-    ['debug', 'info', 'warn', 'error'] as const,
-    'info'
-  ),
-
-  logFormat: config.enum(
-    'LOG_FORMAT',
-    ['json', 'pretty'] as const,
-    'pretty'
-  ),
-
   // Rate limiting
   rateLimitEnabled: config.boolean('RATE_LIMIT_ENABLED', true),
 
@@ -62,9 +49,6 @@ export const appRuntimeConfig = defineReactiveConfig({
     validate: (value: number) => value > 0 || 'Max upload size must be positive'
   },
 
-  // Allowed origins (can be updated in runtime)
-  corsOrigins: config.array('CORS_ORIGINS', ['*']),
-
   // Maintenance mode
   maintenanceMode: config.boolean('MAINTENANCE_MODE', false),
 
@@ -80,7 +64,6 @@ export const appRuntimeConfig = defineReactiveConfig({
 appRuntimeConfig.watch((newConfig) => {
   console.log('🔄 Runtime config reloaded:')
   console.log('   Debug:', newConfig.enableDebugMode)
-  console.log('   Log Level:', newConfig.logLevel)
   console.log('   Maintenance:', newConfig.maintenanceMode)
 })
 

package/config/server.config.ts

@@ -1,48 +1,68 @@
 /**
  * Server Configuration
- * Declarative server config using FluxStack config system
+ * Server-specific settings (port, host, CORS, middleware)
  */
 
-import { defineConfig, config } from '@/core/utils/config-schema'
-import { FLUXSTACK_VERSION } from '@/core/utils/version'
+import { defineConfig, defineNestedConfig, config } from '@/core/utils/config-schema'
 
-const serverConfigSchema = {
+/**
+ * CORS configuration schema
+ */
+const corsSchema = {
+  origins: config.array('CORS_ORIGINS', ['http://localhost:3000', 'http://localhost:5173']),
+  methods: config.array('CORS_METHODS', ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS']),
+  headers: config.array('CORS_HEADERS', ['Content-Type', 'Authorization']),
+  credentials: config.boolean('CORS_CREDENTIALS', false),
+  maxAge: config.number('CORS_MAX_AGE', 86400)
+} as const
+
+/**
+ * Server configuration schema
+ */
+const serverSchema = {
   // Server basics
-  port: config.number('PORT', 3000, true),
-  host: config.string('HOST', 'localhost', true),
-  apiPrefix: config.string('API_PREFIX', '/api'),
+  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
+    }
+  },
 
-  // CORS configuration
-  corsOrigins: config.array('CORS_ORIGINS', ['http://localhost:3000', 'http://localhost:5173']),
-  corsMethods: config.array('CORS_METHODS', ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS']),
-  corsHeaders: config.array('CORS_HEADERS', ['Content-Type', 'Authorization']),
-  corsCredentials: config.boolean('CORS_CREDENTIALS', false),
-  corsMaxAge: config.number('CORS_MAX_AGE', 86400),
+  host: config.string('HOST', 'localhost', true),
 
-  // Client config
-  clientPort: config.number('VITE_PORT', 5173),
-  clientTarget: config.string('CLIENT_TARGET', 'es2020'),
-  clientOutDir: config.string('CLIENT_OUTDIR', 'dist'),
-  clientSourceMaps: config.boolean('CLIENT_SOURCEMAPS', false),
+  apiPrefix: {
+    type: 'string' as const,
+    env: 'API_PREFIX',
+    default: '/api',
+    validate: (value: string) => value.startsWith('/') || 'API prefix must start with /'
+  },
 
   // Backend-only mode
   backendPort: config.number('BACKEND_PORT', 3001),
 
-  // App info
-  appName: config.string('FLUXSTACK_APP_NAME', 'FluxStack'),
-  appVersion: config.string('FLUXSTACK_APP_VERSION', FLUXSTACK_VERSION),
-
   // Features
-  enableSwagger: config.boolean('ENABLE_SWAGGER', true),
-  enableMetrics: config.boolean('ENABLE_METRICS', false),
-  enableMonitoring: config.boolean('ENABLE_MONITORING', false),
   enableRequestLogging: config.boolean('ENABLE_REQUEST_LOGGING', true),
-
-  // Vite/Development
-  enableViteProxyLogs: config.boolean('ENABLE_VITE_PROXY_LOGS', false)
+  showBanner: config.boolean('SHOW_SERVER_BANNER', true)
 } as const
 
-export const serverConfig = defineConfig(serverConfigSchema)
+/**
+ * Export server config (nested with CORS)
+ */
+export const serverConfig = defineNestedConfig({
+  server: serverSchema,
+  cors: corsSchema
+})
+
+// Export types
+export type ServerConfig = typeof serverConfig.server
+export type CorsConfig = typeof serverConfig.cors
+export type ServerFullConfig = typeof serverConfig
 
-export type ServerConfig = typeof serverConfig
+// Export default
 export default serverConfig