create-fluxstack 1.10.1 → 1.12.0

package/config/app.config.ts

@@ -1,62 +1,2 @@
-/**
- * Application Configuration
- * Core application metadata and global settings
- */
-
-import { defineConfig, config } from '@/core/utils/config-schema'
-import { FLUXSTACK_VERSION } from '@/core/utils/version'
-
-/**
- * App configuration schema
- * Contains only app-level metadata and global feature flags
- */
-const appConfigSchema = {
-  // App basics
-  name: config.string('APP_NAME', 'FluxStack', true),
-
-  version: {
-    type: 'string' as const,
-    env: 'APP_VERSION',
-    default: FLUXSTACK_VERSION,
-    validate: (value: string) => /^\d+\.\d+\.\d+$/.test(value) || 'Version must be semver format (e.g., 1.0.0)'
-  },
-
-  description: config.string('APP_DESCRIPTION', 'A FluxStack application'),
-
-  // Environment
-  env: config.enum('NODE_ENV', ['development', 'production', 'test'] as const, 'development', true),
-
-  // URLs
-  url: config.string('APP_URL', undefined, false),
-
-  // Security
-  trustProxy: config.boolean('TRUST_PROXY', false),
-
-  sessionSecret: {
-    type: 'string' as const,
-    env: 'SESSION_SECRET',
-    default: undefined,
-    required: false,
-    validate: (value: string) => {
-      if (!value) return true // Optional
-      if (value.length < 32) {
-        return 'Session secret must be at least 32 characters'
-      }
-      return true
-    }
-  }
-} as const
-
-export const appConfig = defineConfig(appConfigSchema)
-
-// Export type for use in other files
-export type AppConfig = typeof appConfig
-
-/**
- * Type-safe environment type
- * Use this when you need the literal type explicitly
- */
-export type Environment = typeof appConfig.env
-
-// Export default
-export default appConfig
+export { appConfig as default, appConfig } from './system/app.config'
+export type { AppConfig } from './system/app.config'

package/config/client.config.ts

@@ -1,95 +1,2 @@
-/**
- * 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
+export { clientConfig as default, clientConfig } from './system/client.config'
+export type { ClientConfig, ViteConfig, ClientBuildConfig } from './system/client.config'

package/config/database.config.ts

@@ -1,99 +1,2 @@
-/**
- * Database Configuration
- * Laravel-style declarative config with validation
- */
-
-import { defineConfig, config } from '@/core/utils/config-schema'
-
-/**
- * Database configuration schema
- */
-export const databaseConfig = defineConfig({
-  // Connection
-  url: {
-    type: 'string',
-    env: 'DATABASE_URL',
-    default: undefined,
-    required: false,
-    validate: (value) => {
-      if (!value) return true // Optional
-      if (!value.includes('://')) {
-        return 'DATABASE_URL must be a valid connection string (e.g., postgres://...)'
-      }
-      return true
-    },
-    description: 'Full database connection URL (overrides individual settings)'
-  },
-
-  host: config.string('DB_HOST', 'localhost'),
-
-  port: config.number('DB_PORT', 5432),
-
-  database: {
-    type: 'string',
-    env: 'DB_NAME',
-    default: undefined,
-    required: false,
-    description: 'Database name'
-  },
-
-  user: {
-    type: 'string',
-    env: 'DB_USER',
-    default: undefined,
-    required: false
-  },
-
-  password: {
-    type: 'string',
-    env: 'DB_PASSWORD',
-    default: undefined,
-    required: false
-  },
-
-  // Connection pool
-  poolMin: {
-    type: 'number',
-    env: 'DB_POOL_MIN',
-    default: 2,
-    validate: (value) => value >= 0 || 'Pool min must be >= 0'
-  },
-
-  poolMax: {
-    type: 'number',
-    env: 'DB_POOL_MAX',
-    default: 10,
-    validate: (value) => value > 0 || 'Pool max must be > 0'
-  },
-
-  // SSL
-  ssl: config.boolean('DB_SSL', false),
-
-  // Timeouts
-  connectionTimeout: {
-    type: 'number',
-    env: 'DB_CONNECTION_TIMEOUT',
-    default: 30000,
-    description: 'Connection timeout in milliseconds'
-  },
-
-  queryTimeout: {
-    type: 'number',
-    env: 'DB_QUERY_TIMEOUT',
-    default: 60000,
-    description: 'Query timeout in milliseconds'
-  },
-
-  // Features
-  enableLogging: config.boolean('DB_ENABLE_LOGGING', false),
-
-  enableMigrations: config.boolean('DB_ENABLE_MIGRATIONS', true),
-
-  migrationsTable: config.string('DB_MIGRATIONS_TABLE', 'migrations')
-})
-
-// Export type
-export type DatabaseConfig = typeof databaseConfig
-
-// Export default
-export default databaseConfig
+export { databaseConfig as default, databaseConfig } from './system/database.config'
+export type { DatabaseConfig } from './system/database.config'

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'