create-fluxstack 1.10.1 → 1.12.1

package/config/fluxstack.config.ts

@@ -1,48 +1,28 @@
 /**
- * Backward Compatibility Layer for FluxStack Configuration
- * This file maintains compatibility with existing imports while redirecting to the new system
- * @deprecated Use the configuration from the root fluxstack.config.ts instead
+ * FluxStack Configuration - Main Entry Point
+ * Re-exports the complete FluxStack configuration from system/
+ *
+ * ✨ 100% modular configuration using defineConfig
+ * ✨ No composer needed - direct config composition
+ * ✨ All configs are type-safe with automatic validation
+ *
+ * To customize configuration, edit the individual config files:
+ * - system/app.config.ts - Application metadata
+ * - system/server.config.ts - Server and CORS settings
+ * - system/client.config.ts - Vite, proxy, and client build
+ * - system/build.config.ts - Server build and optimization
+ * - system/logger.config.ts - Logging configuration
+ * - system/plugins.config.ts - Plugin management
+ * - system/monitoring.config.ts - Monitoring and metrics
+ * - system/runtime.config.ts - Runtime-reloadable settings
+ * - system/system.config.ts - System information
+ * - database.config.ts - Database connection (optional)
+ * - services.config.ts - JWT, Email, Storage (optional)
  */
 
-import { getConfigSync, createLegacyConfig } from '@/core/config'
-import type { FluxStackConfig } from '@/core/config'
-
-// Load the new configuration
-const newConfig = getConfigSync()
-
-// Create legacy configuration format for backward compatibility
-const legacyConfig = createLegacyConfig(newConfig)
-
-// Export in the old format
-export const config = legacyConfig
-
-// Also export the environment config for backward compatibility
-export const envConfig = {
-  NODE_ENV: process.env.NODE_ENV || 'development',
-  HOST: newConfig.server.host,
-  PORT: newConfig.server.port,
-  FRONTEND_PORT: newConfig.client.port,
-  BACKEND_PORT: newConfig.server.port,
-  VITE_API_URL: newConfig.client.proxy.target,
-  API_URL: newConfig.client.proxy.target,
-  CORS_ORIGINS: newConfig.server.cors.origins,
-  CORS_METHODS: newConfig.server.cors.methods,
-  CORS_HEADERS: newConfig.server.cors.headers,
-  LOG_LEVEL: newConfig.logging.level,
-  BUILD_TARGET: newConfig.build.target,
-  BUILD_OUTDIR: newConfig.build.outDir,
-  // Add other legacy environment variables as needed
-}
-
-// Warn about deprecated usage in development
-if (process.env.NODE_ENV === 'development') {
-  console.warn(
-    '⚠️  DEPRECATED: Importing from config/fluxstack.config.ts is deprecated.\n' +
-    '   Please update your imports to use the new configuration system:\n' +
-    '   import { getConfig } from "./core/config"\n' +
-    '   or import config from "./fluxstack.config.ts"'
-  )
-}
-
-// Export types for backward compatibility
-export type { FluxStackConfig }
+export {
+  fluxStackConfig,
+  fluxStackConfig as config,
+  fluxStackConfig as default,
+  type FluxStackConfig
+} from './system/fluxstack.config'

package/config/index.ts

@@ -5,7 +5,7 @@
  *
  * @example
  * ```ts
- * import { appConfig, serverConfig, databaseConfig } from '@/config'
+ * import { appConfig, serverConfig, databaseConfig } from '@config'
  *
  * // All configs are type-safe and validated!
  * console.log(appConfig.name)                    // string
@@ -16,22 +16,33 @@
  * console.log(servicesConfig.email.host)         // string
  * console.log(monitoringConfig.metrics.enabled)  // boolean
  * ```
+ *
+ * ✨ For type safety with optional features (database, auth, email, storage):
+ * Import types from this file instead of core:
+ * ```ts
+ * import type { DatabaseConfig, JWTConfig, EmailConfig, StorageConfig } from '@config'
+ * ```
  */
 
 // ============================================================================
 // 📦 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 { loggerConfig } from './logger.config'
-export { pluginsConfig } from './plugins.config'
-export { monitoringConfig } from './monitoring.config'
-export { appRuntimeConfig } from './runtime.config'
-export { systemConfig, systemRuntimeInfo } from './system.config'
+// System configs (from config/system/)
+export { appConfig } from './system/app.config'
+export { serverConfig } from './system/server.config'
+export { clientConfig } from './system/client.config'
+export { buildConfig } from './system/build.config'
+export { loggerConfig } from './system/logger.config'
+export { pluginsConfig } from './system/plugins.config'
+export { monitoringConfig } from './system/monitoring.config'
+export { appRuntimeConfig } from './system/runtime.config'
+export { systemConfig, systemRuntimeInfo } from './system/system.config'
+export { databaseConfig } from './system/database.config'
+export { servicesConfig } from './system/services.config'
+
+// Main FluxStack config (composed)
+export { fluxStackConfig, config as fluxConfig, type FluxStackConfig } from './fluxstack.config'
 
 // Plugin configs (re-exported for convenience)
 export { cryptoAuthConfig } from '../plugins/crypto-auth/config'
@@ -40,35 +51,35 @@ export { cryptoAuthConfig } from '../plugins/crypto-auth/config'
 // 📝 TYPE EXPORTS
 // ============================================================================
 
-// Core types
-export type { AppConfig, Environment } from './app.config'
+// System config types
+export type { AppConfig } from './system/app.config'
 export type {
   ServerConfig,
   CorsConfig,
   ServerFullConfig
-} from './server.config'
+} from './system/server.config'
 export type {
   ClientConfig,
   ViteConfig,
-  ProxyConfig,
   ClientBuildConfig
-} from './client.config'
-export type { DatabaseConfig } from './database.config'
+} from './system/client.config'
 export type {
-  EmailConfig,
-  JWTConfig,
-  StorageConfig,
-  RedisConfig
-} from './services.config'
-export type { LoggerConfig } from './logger.config'
-export type { PluginsConfig } from './plugins.config'
+  BuildConfig,
+  OptimizationConfig,
+  BuildFullConfig
+} from './system/build.config'
+export type { LoggerConfig } from './system/logger.config'
+export type { PluginsConfig } from './system/plugins.config'
 export type {
   MonitoringConfig,
   MetricsConfig,
   ProfilingConfig,
   MonitoringFullConfig
-} from './monitoring.config'
-export type { SystemConfig, SystemRuntimeInfo } from './system.config'
+} from './system/monitoring.config'
+export type { SystemConfig, SystemRuntimeInfo } from './system/system.config'
+export type { AppRuntimeConfig } from './system/runtime.config'
+export type { DatabaseConfig } from './system/database.config'
+export type { ServicesConfig } from './system/services.config'
 
 // Plugin types
 export type { CryptoAuthConfig } from '../plugins/crypto-auth/config'
@@ -77,34 +88,42 @@ export type { CryptoAuthConfig } from '../plugins/crypto-auth/config'
 // 🎯 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 { loggerConfig } from './logger.config'
-import { pluginsConfig } from './plugins.config'
-import { monitoringConfig } from './monitoring.config'
-import { appRuntimeConfig } from './runtime.config'
-import { systemConfig, systemRuntimeInfo } from './system.config'
+import { appConfig } from './system/app.config'
+import { serverConfig } from './system/server.config'
+import { clientConfig } from './system/client.config'
+import { buildConfig } from './system/build.config'
+import { loggerConfig } from './system/logger.config'
+import { pluginsConfig } from './system/plugins.config'
+import { monitoringConfig } from './system/monitoring.config'
+import { appRuntimeConfig } from './system/runtime.config'
+import { systemConfig, systemRuntimeInfo } from './system/system.config'
+import { databaseConfig } from './system/database.config'
+import { servicesConfig } from './system/services.config'
 import { cryptoAuthConfig } from '../plugins/crypto-auth/config'
 
 /**
  * All configs in one object
  * Use this when you need access to multiple configs at once
+ *
+ * For the complete FluxStack configuration with proper structure,
+ * use `fluxStackConfig` from './fluxstack.config'
  */
 export const config = {
+  // System configs
   app: appConfig,
   server: serverConfig,
   client: clientConfig,
-  database: databaseConfig,
-  services: servicesConfig,
+  build: buildConfig,
   logger: loggerConfig,
   plugins: pluginsConfig,
   monitoring: monitoringConfig,
   runtime: appRuntimeConfig,
   system: systemConfig,
   systemRuntime: systemRuntimeInfo,
+  database: databaseConfig,
+  services: servicesConfig,
+
+  // Plugin configs
   cryptoAuth: cryptoAuthConfig
 } as const
 

package/config/monitoring.config.ts

@@ -1,114 +1,2 @@
-/**
- * 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
+export { monitoringConfig as default, monitoringConfig } from './system/monitoring.config'
+export type { MonitoringConfig, MetricsConfig, ProfilingConfig, MonitoringFullConfig } from './system/monitoring.config'

package/config/plugins.config.ts

@@ -1,80 +1,2 @@
-/**
- * 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
+export { pluginsConfig as default, pluginsConfig } from './system/plugins.config'
+export type { PluginsConfig } from './system/plugins.config'

package/config/server.config.ts

@@ -1,68 +1,2 @@
-/**
- * Server Configuration
- * Server-specific settings (port, host, CORS, middleware)
- */
-
-import { defineConfig, defineNestedConfig, config } from '@/core/utils/config-schema'
-
-/**
- * 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: {
-    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 /'
-  },
-
-  // Backend-only mode
-  backendPort: config.number('BACKEND_PORT', 3001),
-
-  // Features
-  enableRequestLogging: config.boolean('ENABLE_REQUEST_LOGGING', true),
-  showBanner: config.boolean('SHOW_SERVER_BANNER', true)
-} as const
-
-/**
- * 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 default
-export default serverConfig
+export { serverConfig as default, serverConfig } from './system/server.config'
+export type { ServerConfig, CorsConfig, ServerFullConfig } from './system/server.config'

package/config/services.config.ts

@@ -1,130 +1,2 @@
-/**
- * External Services Configuration
- * Laravel-style declarative config for third-party services
- */
-
-import { defineConfig, defineNestedConfig, config } from '@/core/utils/config-schema'
-
-/**
- * Email service configuration
- */
-const emailSchema = {
-  // SMTP
-  host: config.string('SMTP_HOST'),
-
-  port: {
-    type: 'number' as const,
-    env: 'SMTP_PORT',
-    default: 587,
-    validate: (value: number) => value > 0 || 'SMTP port must be positive'
-  },
-
-  user: config.string('SMTP_USER'),
-  password: config.string('SMTP_PASSWORD'),
-
-  secure: config.boolean('SMTP_SECURE', false),
-
-  from: {
-    type: 'string' as const,
-    env: 'SMTP_FROM',
-    default: 'noreply@example.com',
-    validate: (value: string) => {
-      const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/
-      return emailRegex.test(value) || 'From email must be valid'
-    }
-  },
-
-  replyTo: config.string('SMTP_REPLY_TO')
-}
-
-/**
- * JWT authentication configuration
- */
-const jwtSchema = {
-  secret: {
-    type: 'string' as const,
-    env: 'JWT_SECRET',
-    default: undefined,
-    required: false,
-    validate: (value: string) => {
-      if (!value) return true // Optional
-      if (value.length < 32) {
-        return 'JWT secret must be at least 32 characters for security'
-      }
-      return true
-    }
-  },
-
-  expiresIn: config.string('JWT_EXPIRES_IN', '24h'),
-
-  algorithm: config.enum(
-    'JWT_ALGORITHM',
-    ['HS256', 'HS384', 'HS512', 'RS256', 'RS384', 'RS512'] as const,
-    'HS256'
-  ),
-
-  issuer: config.string('JWT_ISSUER', 'fluxstack'),
-
-  audience: config.string('JWT_AUDIENCE')
-}
-
-/**
- * Storage configuration
- */
-const storageSchema = {
-  provider: config.enum(
-    'STORAGE_PROVIDER',
-    ['local', 's3', 'gcs', 'azure'] as const,
-    'local'
-  ),
-
-  uploadPath: config.string('UPLOAD_PATH', './uploads'),
-
-  maxFileSize: {
-    type: 'number' as const,
-    env: 'MAX_FILE_SIZE',
-    default: 10485760, // 10MB
-    validate: (value: number) => value > 0 || 'Max file size must be positive'
-  },
-
-  allowedTypes: config.array('ALLOWED_FILE_TYPES', ['image/*', 'application/pdf']),
-
-  // S3 specific
-  s3Bucket: config.string('S3_BUCKET'),
-  s3Region: config.string('S3_REGION', 'us-east-1'),
-  s3AccessKey: config.string('S3_ACCESS_KEY'),
-  s3SecretKey: config.string('S3_SECRET_KEY')
-}
-
-/**
- * Redis configuration
- */
-const redisSchema = {
-  host: config.string('REDIS_HOST', 'localhost'),
-  port: config.number('REDIS_PORT', 6379),
-  password: config.string('REDIS_PASSWORD'),
-  db: config.number('REDIS_DB', 0),
-
-  keyPrefix: config.string('REDIS_KEY_PREFIX', 'fluxstack:'),
-
-  enableTls: config.boolean('REDIS_TLS', false)
-}
-
-/**
- * Export all service configs as nested object
- */
-export const servicesConfig = defineNestedConfig({
-  email: emailSchema,
-  jwt: jwtSchema,
-  storage: storageSchema,
-  redis: redisSchema
-})
-
-// Export types
-export type EmailConfig = typeof servicesConfig.email
-export type JWTConfig = typeof servicesConfig.jwt
-export type StorageConfig = typeof servicesConfig.storage
-export type RedisConfig = typeof servicesConfig.redis
-
-// Export default
-export default servicesConfig
+export { servicesConfig as default, servicesConfig } from './system/services.config'
+export type { ServicesConfig } from './system/services.config'

package/config/system/app.config.ts

@@ -0,0 +1,29 @@
+/**
+ * Application Configuration
+ * Core application settings and metadata
+ */
+
+import { defineConfig, config } from '@core/utils/config-schema'
+
+/**
+ * App configuration schema
+ */
+export const appConfig = defineConfig({
+  // Application metadata
+  name: config.string('APP_NAME', 'fluxstack-app', true),
+  version: config.string('APP_VERSION', '1.0.0', true),
+  description: config.string('APP_DESCRIPTION', 'A FluxStack application', false),
+  env: config.enum('NODE_ENV', ['development', 'production', 'test'] as const, 'development', false),
+
+  // Runtime mode (set by CLI: --backend-only, --frontend-only)
+  mode: config.enum('FLUXSTACK_MODE', ['full-stack', 'backend-only', 'frontend-only'] as const, 'full-stack', false),
+
+  // Security
+  trustProxy: config.boolean('APP_TRUST_PROXY', false),
+  sessionSecret: config.string('APP_SESSION_SECRET', '')
+})
+
+// Export type
+export type AppConfig = typeof appConfig
+
+export default appConfig