create-fluxstack 1.10.1 → 1.12.0

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

package/config/system/build.config.ts

@@ -0,0 +1,49 @@
+/**
+ * Build Configuration
+ * Server build and optimization settings
+ */
+
+import { defineConfig, defineNestedConfig, config } from '@core/utils/config-schema'
+import { helpers } from '@core/utils/env'
+
+/**
+ * Build optimization schema
+ */
+const optimizationSchema = {
+  minify: config.boolean('BUILD_MINIFY', helpers.isProduction()),
+  treeshake: config.boolean('BUILD_TREESHAKE', true),
+  compress: config.boolean('BUILD_COMPRESS', helpers.isProduction()),
+  splitChunks: config.boolean('BUILD_SPLIT_CHUNKS', true),
+  bundleAnalyzer: config.boolean('BUILD_BUNDLE_ANALYZER', false),
+  removeUnusedCSS: config.boolean('BUILD_REMOVE_UNUSED_CSS', false),
+  optimizeImages: config.boolean('BUILD_OPTIMIZE_IMAGES', false)
+} as const
+
+/**
+ * Build configuration schema
+ */
+const buildSchema = {
+  target: config.enum('BUILD_TARGET', ['bun', 'node', 'docker'] as const, 'bun', true),
+  outDir: config.string('BUILD_OUT_DIR', 'dist', true),
+  sourceMaps: config.boolean('BUILD_SOURCE_MAPS', helpers.isDevelopment()),
+  clean: config.boolean('BUILD_CLEAN', true),
+  mode: config.enum('BUILD_MODE', ['development', 'production'] as const, helpers.isProduction() ? 'production' : 'development'),
+  external: config.array('BUILD_EXTERNAL', []),
+  optimize: config.boolean('BUILD_OPTIMIZE', true)
+} as const
+
+/**
+ * Export build config (nested with optimization)
+ */
+export const buildConfig = defineNestedConfig({
+  build: buildSchema,
+  optimization: optimizationSchema
+})
+
+// Export types
+export type BuildConfig = typeof buildConfig.build
+export type OptimizationConfig = typeof buildConfig.optimization
+export type BuildFullConfig = typeof buildConfig
+
+// Export default
+export default buildConfig

package/config/system/client.config.ts

@@ -0,0 +1,68 @@
+/**
+ * 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', true),
+
+  open: config.boolean('VITE_OPEN', false),
+
+  enableLogging: config.boolean('ENABLE_VITE_PROXY_LOGS', false),
+
+  logLevel: config.enum('VITE_LOG_LEVEL', ['error' , 'warn' , 'info', 'silent'], undefined),
+
+  allowedHosts: config.array('VITE_ALLOWED_HOSTS', ['localhost'])
+} 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,
+  build: buildSchema,
+})
+
+// ℹ️ Proxy config removed: Not needed in FluxStack architecture
+// All requests go through Elysia (localhost:3000):
+//   - /api, /swagger → Elysia handlers (viteExcludePaths)
+//   - Everything else → Proxy to Vite dev server (handled by core/plugins/built-in/vite)
+
+// Export types
+export type ViteConfig = typeof clientConfig.vite
+export type ClientBuildConfig = typeof clientConfig.build
+export type ClientConfig = typeof clientConfig
+
+// Export default
+export default clientConfig

package/config/system/database.config.ts

@@ -0,0 +1,17 @@
+/**
+ * Database Configuration
+ * Optional database settings for backward compatibility
+ */
+
+import { defineConfig, config } from '@core/utils/config-schema'
+
+export const databaseConfig = defineConfig({
+  url: config.string('DATABASE_URL', ''),
+  provider: config.enum('DATABASE_PROVIDER', ['postgres', 'mysql', 'sqlite', 'mssql', 'mongodb'] as const, 'postgres'),
+  connectionTimeout: config.number('DATABASE_CONNECTION_TIMEOUT', 5000),
+  ssl: config.boolean('DATABASE_SSL', false)
+})
+
+export type DatabaseConfig = typeof databaseConfig
+
+export default databaseConfig

package/config/system/fluxstack.config.ts

@@ -0,0 +1,114 @@
+/**
+ * FluxStack Main Configuration
+ * Composes all modular system configs into a single unified configuration
+ *
+ * ✨ 100% modular and type-safe using defineConfig
+ * ✨ No composer needed - direct config composition
+ * ✨ All configs use defineConfig for automatic validation and inference
+ */
+
+import { appConfig } from './app.config'
+import { serverConfig } from './server.config'
+import { clientConfig } from './client.config'
+import { buildConfig } from './build.config'
+import { loggerConfig } from './logger.config'
+import { pluginsConfig } from './plugins.config'
+import { monitoringConfig } from './monitoring.config'
+import { appRuntimeConfig } from './runtime.config'
+import { systemConfig } from './system.config'
+import { databaseConfig } from './database.config'
+import { servicesConfig } from './services.config'
+
+const serverWithCors = {
+  ...serverConfig.server,
+  cors: {
+    origins: serverConfig.cors.origins,
+    methods: serverConfig.cors.methods,
+    headers: serverConfig.cors.headers,
+    credentials: serverConfig.cors.credentials,
+    maxAge: serverConfig.cors.maxAge
+  }
+}
+
+const client = {
+  port: clientConfig.vite.port,
+  host: clientConfig.vite.host,
+  build: {
+    ...clientConfig.build,
+    sourceMaps: true
+  }
+}
+
+const monitoring = {
+  ...monitoringConfig.monitoring,
+  metrics: monitoringConfig.metrics,
+  profiling: monitoringConfig.profiling
+}
+
+const environments = {
+  development: {
+    logging: { level: 'debug', format: 'pretty' },
+    build: { optimization: { ...buildConfig.optimization, minify: false } }
+  },
+  production: {
+    logging: { level: 'warn', format: 'json' },
+    monitoring: { enabled: true }
+  },
+  test: {
+    logging: { level: 'error', format: 'pretty' },
+    server: { port: 0 },
+    client: { port: 0 }
+  }
+}
+
+/**
+ * FluxStack complete configuration
+ * Direct composition of all modular configs
+ */
+export const fluxStackConfig = {
+  // Core system configs
+  app: appConfig,
+  server: serverWithCors,
+  client,
+  build: {
+    ...buildConfig.build,
+    optimization: {
+      ...buildConfig.optimization,
+      minify: true
+    }
+  },
+
+  // CORS (from server)
+  cors: serverConfig.cors,
+
+  // Client Build (from client)
+  clientBuild: clientConfig.build,
+
+  // Build optimization
+  optimization: buildConfig.optimization,
+
+  // Logging, plugins, monitoring
+  logging: loggerConfig,
+  plugins: pluginsConfig,
+  monitoring,
+
+  // Runtime & system
+  runtime: appRuntimeConfig.values,
+  system: systemConfig,
+  database: databaseConfig,
+  services: servicesConfig,
+
+  // Environment defaults (backward compatibility)
+  environments
+} as const
+
+/**
+ * Type for the complete FluxStack configuration
+ */
+export type FluxStackConfig = typeof fluxStackConfig
+
+/**
+ * Named exports
+ */
+export default fluxStackConfig
+export { fluxStackConfig as config }

package/config/{logger.config.ts → system/logger.config.ts}

@@ -3,11 +3,12 @@
  * Declarative logger config using FluxStack config system
  */
 
-import { defineConfig, config } from '@/core/utils/config-schema'
+import { defineConfig, config } from '@core/utils/config-schema'
 
 export const loggerConfig = defineConfig({
   // Log level
   level: config.enum('LOG_LEVEL', ['debug', 'info', 'warn', 'error'] as const, 'info'),
+  format: config.enum('LOG_FORMAT', ['pretty', 'json'] as const, 'pretty'),
 
   // Format settings
   dateFormat: config.string('LOG_DATE_FORMAT', 'YYYY-MM-DD HH:mm:ss'),
@@ -17,6 +18,7 @@ export const loggerConfig = defineConfig({
   logToFile: config.boolean('LOG_TO_FILE', false),
   maxSize: config.string('LOG_MAX_SIZE', '20m'),
   maxFiles: config.string('LOG_MAX_FILES', '14d'),
+  transports: config.array('LOG_TRANSPORTS', ['console']),
 
   // Display options
   enableColors: config.boolean('LOG_COLORS', true),