create-fluxstack 1.10.1 → 1.12.0

package/core/plugins/built-in/live-components/index.ts

@@ -1,4 +1,4 @@
-import type { FluxStack, PluginContext } from '@/core/plugins/types'
+import type { FluxStack, PluginContext } from '@core/plugins/types'
 import { createLiveComponentCommand } from './commands/create-live-component'
 
 type Plugin = FluxStack.Plugin

package/core/plugins/built-in/monitoring/index.ts

@@ -3,10 +3,9 @@
  * Provides performance monitoring, metrics collection, and system monitoring
  */
 
-import type { FluxStack, PluginContext, RequestContext, ResponseContext, ErrorContext } from "@/core/plugins/types"
-import { MetricsCollector } from "@/core/utils/monitoring"
-import { appConfig } from '@/config/app.config'
-import { monitoringConfig } from '@/config/monitoring.config'
+import type { FluxStack, PluginContext, RequestContext, ResponseContext, ErrorContext } from "@core/plugins/types"
+import { MetricsCollector } from "@core/utils/monitoring"
+import { appConfig, monitoringConfig } from '@config'
 import * as os from 'os'
 import * as fs from 'fs'
 import * as path from 'path'
@@ -95,6 +94,71 @@ const DEFAULTS = {
   alerts: [] as AlertThreshold[]
 }
 
+type MonitoringOptions = typeof DEFAULTS
+
+function mergeMonitoringOptions(base: MonitoringOptions, overrides: Partial<MonitoringOptions>): MonitoringOptions {
+  const result: MonitoringOptions = { ...base }
+
+  for (const key of Object.keys(overrides) as (keyof MonitoringOptions)[]) {
+    const value = overrides[key]
+    if (value === undefined) continue
+
+    if (Array.isArray(value)) {
+      ;(result as any)[key] = value
+    } else if (value && typeof value === 'object' && !Array.isArray(value)) {
+      ;(result as any)[key] = { ...(base as any)[key], ...value }
+    } else {
+      ;(result as any)[key] = value
+    }
+  }
+
+  return result
+}
+
+function resolveMonitoringOptions(source: any): MonitoringOptions {
+  if (source?.monitoringConfig) return source.monitoringConfig
+  if (source?.context?.monitoringConfig) return source.context.monitoringConfig
+  return DEFAULTS
+}
+
+function normalizeRuntimeMonitoringConfig(runtime: any): Partial<MonitoringOptions> {
+  if (!runtime) return {}
+  const overrides: Partial<MonitoringOptions> = {}
+
+  if (typeof runtime.enabled === 'boolean') overrides.enabled = runtime.enabled
+  if (runtime.metrics) {
+    overrides.httpMetrics = runtime.metrics.httpMetrics
+    overrides.systemMetrics = runtime.metrics.systemMetrics
+    overrides.customMetrics = runtime.metrics.customMetrics
+    overrides.collectInterval = runtime.metrics.collectInterval
+    overrides.retentionPeriod = runtime.metrics.retentionPeriod
+  }
+  if (Array.isArray(runtime.exporters)) {
+    overrides.exporters = runtime.exporters as MetricsExporter[]
+  }
+  if (runtime.thresholds) {
+    overrides.thresholds = { ...DEFAULTS.thresholds, ...runtime.thresholds }
+  }
+  if (Array.isArray(runtime.alerts)) {
+    overrides.alerts = runtime.alerts
+  }
+
+  return overrides
+}
+
+const monitoringPluginConfigSchema = {
+  type: 'object' as const,
+  properties: {
+    enabled: { type: 'boolean' },
+    httpMetrics: { type: 'boolean' },
+    systemMetrics: { type: 'boolean' },
+    customMetrics: { type: 'boolean' },
+    collectInterval: { type: 'number' },
+    retentionPeriod: { type: 'number' },
+    exporters: { type: 'array' }
+  }
+}
+
 export const monitoringPlugin: Plugin = {
   name: "monitoring",
   version: "1.0.0",
@@ -104,64 +168,64 @@ export const monitoringPlugin: Plugin = {
   category: "monitoring",
   tags: ["monitoring", "metrics", "performance", "observability"],
   dependencies: [],
+  configSchema: monitoringPluginConfigSchema,
+  defaultConfig: DEFAULTS,
 
   setup: async (context: PluginContext) => {
-    if (!DEFAULTS.enabled) {
+    const runtimeOverrides = normalizeRuntimeMonitoringConfig((context as any).config?.monitoring)
+    const pluginOverrides = (context as any).config?.plugins?.config?.monitoring as Partial<MonitoringOptions> | undefined
+    const resolvedConfig = mergeMonitoringOptions(
+      mergeMonitoringOptions(DEFAULTS, runtimeOverrides),
+      pluginOverrides || {}
+    )
+
+    if (!resolvedConfig.enabled) {
       context.logger.info('Monitoring plugin disabled by configuration')
       return
     }
 
     context.logger.info('Initializing monitoring plugin', {
-      httpMetrics: DEFAULTS.httpMetrics,
-      systemMetrics: DEFAULTS.systemMetrics,
-      customMetrics: DEFAULTS.customMetrics,
-      exporters: DEFAULTS.exporters.length,
-      alerts: DEFAULTS.alerts.length
+      httpMetrics: resolvedConfig.httpMetrics,
+      systemMetrics: resolvedConfig.systemMetrics,
+      customMetrics: resolvedConfig.customMetrics,
+      exporters: resolvedConfig.exporters.length,
+      alerts: resolvedConfig.alerts.length
     })
 
-    // Initialize enhanced metrics registry
     const metricsRegistry: MetricsRegistry = {
       counters: new Map(),
       gauges: new Map(),
       histograms: new Map()
     }
 
-    // Initialize metrics collector
     const metricsCollector = new MetricsCollector()
 
-    // Store registry and collector in context for access by other hooks
     ;(context as any).metricsRegistry = metricsRegistry
     ;(context as any).metricsCollector = metricsCollector
+    ;(context as any).monitoringConfig = resolvedConfig
 
-    // Initialize HTTP metrics
-    if (DEFAULTS.httpMetrics) {
+    if (resolvedConfig.httpMetrics) {
       initializeHttpMetrics(metricsRegistry, metricsCollector)
     }
 
-    // Start system metrics collection
-    if (DEFAULTS.systemMetrics) {
-      startSystemMetricsCollection(context, metricsCollector)
+    if (resolvedConfig.systemMetrics) {
+      startSystemMetricsCollection(context, metricsCollector, resolvedConfig)
     }
 
-    // Setup metrics endpoint for Prometheus
-    setupMetricsEndpoint(context, metricsRegistry, metricsCollector)
-
-    // Start metrics exporters
-    startMetricsExporters(context, metricsRegistry, metricsCollector)
-
-    // Setup metrics cleanup
-    setupMetricsCleanup(context, metricsRegistry)
+    setupMetricsEndpoint(context, metricsRegistry, metricsCollector, resolvedConfig)
+    startMetricsExporters(context, metricsRegistry, metricsCollector, resolvedConfig)
+    setupMetricsCleanup(context, metricsRegistry, resolvedConfig)
 
-    // Setup alert monitoring
-    if (DEFAULTS.alerts.length > 0) {
-      setupAlertMonitoring(context, metricsRegistry)
+    if (resolvedConfig.alerts.length > 0) {
+      setupAlertMonitoring(context, metricsRegistry, resolvedConfig.alerts)
     }
 
     context.logger.info('Monitoring plugin initialized successfully')
   },
 
   onServerStart: async (context: PluginContext) => {
-    if (DEFAULTS.enabled) {
+    const options = resolveMonitoringOptions(context)
+    if (options.enabled) {
       context.logger.info('Monitoring plugin: Server monitoring started', {
         pid: process.pid,
         nodeVersion: process.version,
@@ -172,14 +236,15 @@ export const monitoringPlugin: Plugin = {
       const metricsRegistry = (context as any).metricsRegistry as MetricsRegistry
       if (metricsRegistry) {
         recordCounter(metricsRegistry, 'server_starts_total', 1, {
-          version: appConfig.version
+          version: appConfig.version ?? '1.0.0'
         })
       }
     }
   },
 
   onServerStop: async (context: PluginContext) => {
-    if (DEFAULTS.enabled) {
+    const options = resolveMonitoringOptions(context)
+    if (options.enabled) {
       context.logger.info('Monitoring plugin: Server monitoring stopped')
 
       // Record server stop metric
@@ -268,14 +333,14 @@ export const monitoringPlugin: Plugin = {
       responseContext.size
     )
 
-    // Check thresholds and log warnings
-    if (DEFAULTS.thresholds.responseTime && duration > DEFAULTS.thresholds.responseTime) {
+    const options = resolveMonitoringOptions(responseContext)
+    if (options.thresholds.responseTime && duration > options.thresholds.responseTime) {
       const logger = (responseContext as any).logger || console
       logger.warn(`Slow request detected: ${responseContext.method} ${responseContext.path} took ${duration}ms`, {
         method: responseContext.method,
         path: responseContext.path,
         duration,
-        threshold: DEFAULTS.thresholds.responseTime
+        threshold: options.thresholds.responseTime
       })
     }
   },
@@ -348,7 +413,7 @@ function initializeHttpMetrics(registry: MetricsRegistry, collector: MetricsColl
   collector.createHistogram('http_response_size_bytes', 'HTTP response size in bytes', [100, 1000, 10000, 100000, 1000000])
 }
 
-function startSystemMetricsCollection(context: PluginContext, collector: MetricsCollector) {
+function startSystemMetricsCollection(context: PluginContext, collector: MetricsCollector, options: MonitoringOptions) {
   const intervals: NodeJS.Timeout[] = []
 
   // Initialize system metrics in collector
@@ -422,16 +487,15 @@ function startSystemMetricsCollection(context: PluginContext, collector: Metrics
 
   // Collect metrics immediately and then at intervals
   collectSystemMetrics()
-  const interval = setInterval(collectSystemMetrics, DEFAULTS.collectInterval)
+  const interval = setInterval(collectSystemMetrics, options.collectInterval)
   intervals.push(interval)
 
   // Store intervals for cleanup
   ;(context as any).monitoringIntervals = intervals
 }
 
-function setupMetricsEndpoint(context: PluginContext, _registry: MetricsRegistry, collector: MetricsCollector) {
-  // Find Prometheus exporter configuration
-  const prometheusExporter = DEFAULTS.exporters.find((e: any) => e.type === 'prometheus' && e.enabled)
+function setupMetricsEndpoint(context: PluginContext, _registry: MetricsRegistry, collector: MetricsCollector, options: MonitoringOptions) {
+  const prometheusExporter = options.exporters.find((e: any) => e.type === 'prometheus' && e.enabled)
   if (!prometheusExporter) return
 
   const endpoint = prometheusExporter.endpoint || '/metrics'
@@ -451,10 +515,10 @@ function setupMetricsEndpoint(context: PluginContext, _registry: MetricsRegistry
   }
 }
 
-function startMetricsExporters(context: PluginContext, registry: MetricsRegistry, collector: MetricsCollector) {
+function startMetricsExporters(context: PluginContext, registry: MetricsRegistry, collector: MetricsCollector, options: MonitoringOptions) {
   const intervals: NodeJS.Timeout[] = (context as any).monitoringIntervals || []
 
-  for (const exporterConfig of DEFAULTS.exporters) {
+  for (const exporterConfig of options.exporters) {
     if (!exporterConfig.enabled) continue
 
     const exportMetrics = () => {
@@ -492,11 +556,11 @@ function startMetricsExporters(context: PluginContext, registry: MetricsRegistry
   ;(context as any).monitoringIntervals = intervals
 }
 
-function setupAlertMonitoring(context: PluginContext, registry: MetricsRegistry) {
+function setupAlertMonitoring(context: PluginContext, registry: MetricsRegistry, alerts: AlertThreshold[]) {
   const intervals: NodeJS.Timeout[] = (context as any).monitoringIntervals || []
 
   const checkAlerts = () => {
-    for (const alert of DEFAULTS.alerts) {
+    for (const alert of alerts) {
       try {
         const metricValue = getMetricValue(registry, alert.metric)
         if (metricValue !== null && evaluateThreshold(metricValue, alert.operator, alert.value)) {
@@ -544,12 +608,12 @@ function setupAlertMonitoring(context: PluginContext, registry: MetricsRegistry)
   ;(context as any).monitoringIntervals = intervals
 }
 
-function setupMetricsCleanup(context: PluginContext, registry: MetricsRegistry) {
+function setupMetricsCleanup(context: PluginContext, registry: MetricsRegistry, options: MonitoringOptions) {
   const intervals: NodeJS.Timeout[] = (context as any).monitoringIntervals || []
 
   const cleanup = () => {
     const now = Date.now()
-    const cutoff = now - DEFAULTS.retentionPeriod
+    const cutoff = now - (options.retentionPeriod ?? 3600000)
 
     // Clean up old metrics
     for (const [key, metric] of registry.counters.entries()) {
@@ -815,4 +879,4 @@ export function formatPrometheusLabels(labels?: Record<string, string>): string
   return `{${labelPairs}}`
 }
 
-export default monitoringPlugin
+export default monitoringPlugin

package/core/plugins/built-in/static/index.ts

@@ -1,6 +1,6 @@
 import { join } from "path"
 import { statSync, existsSync } from "fs"
-import type { Plugin, PluginContext } from "@/core/plugins"
+import type { Plugin, PluginContext } from "@core/plugins"
 
 // Default configuration values
 const DEFAULTS = {

package/core/plugins/built-in/swagger/index.ts

@@ -1,62 +1,25 @@
 import { swagger } from '@elysiajs/swagger'
-import type { FluxStack, PluginContext } from '@/core/plugins/types'
-import { appConfig } from '@/config/app.config'
-import { serverConfig } from '@/config/server.config'
-import { pluginsConfig } from '@/config/plugins.config'
+import type { FluxStack, PluginContext } from '@core/plugins/types'
+import { appConfig, serverConfig, pluginsConfig } from '@config'
 
 type Plugin = FluxStack.Plugin
 
-/**
- * Parse servers from config string
- * Format: "url1|description1,url2|description2"
- */
-function parseServersFromConfig(serversString: string): Array<{ url: string; description: string }> {
-  if (!serversString || serversString.trim() === '') {
-    return []
-  }
-
-  return serversString.split(',').map(server => {
-    const [url, description] = server.split('|').map(s => s.trim())
-    return {
-      url: url || '',
-      description: description || 'Server'
-    }
-  }).filter(s => s.url !== '')
-}
-
-// Configuration from config/plugins.config.ts (user editable)
-const DEFAULTS = {
-  enabled: pluginsConfig.swaggerEnabled,
-  path: pluginsConfig.swaggerPath,
-  title: pluginsConfig.swaggerTitle,
-  description: pluginsConfig.swaggerDescription,
-  version: pluginsConfig.swaggerVersion,
-  excludePaths: pluginsConfig.swaggerExcludePaths,
-  servers: parseServersFromConfig(pluginsConfig.swaggerServers),
-
-  // Swagger UI options
-  swaggerOptions: {
-    persistAuthorization: pluginsConfig.swaggerPersistAuthorization,
-    displayRequestDuration: pluginsConfig.swaggerDisplayRequestDuration,
-    filter: pluginsConfig.swaggerEnableFilter,
-    showExtensions: pluginsConfig.swaggerShowExtensions,
-    tryItOutEnabled: pluginsConfig.swaggerTryItOutEnabled
-  },
-
-  // Authentication
-  authEnabled: pluginsConfig.swaggerAuthEnabled,
-  authUsername: pluginsConfig.swaggerAuthUsername,
-  authPassword: pluginsConfig.swaggerAuthPassword,
+/** Parse servers from config string format: "url1|desc1,url2|desc2" */
+function parseServers(str: string): Array<{ url: string; description: string }> {
+  if (!str?.trim()) return []
 
-  // Security (can be extended via env vars if needed)
-  securitySchemes: {},
-  globalSecurity: [] as Array<Record<string, any>>
+  return str.split(',')
+    .map(s => {
+      const [url, desc] = s.split('|').map(p => p.trim())
+      return { url: url || '', description: desc || 'Server' }
+    })
+    .filter(s => s.url)
 }
 
 export const swaggerPlugin: Plugin = {
   name: 'swagger',
   version: '1.0.0',
-  description: 'Swagger documentation plugin for FluxStack with automatic tag discovery',
+  description: 'Swagger documentation plugin for FluxStack',
   author: 'FluxStack Team',
   priority: 500,
   category: 'documentation',
@@ -64,238 +27,78 @@ export const swaggerPlugin: Plugin = {
   dependencies: [],
 
   setup: async (context: PluginContext) => {
-    if (!DEFAULTS.enabled) {
-      context.logger.debug('Swagger plugin disabled by configuration')
+    if (!pluginsConfig.swaggerEnabled) {
+      context.logger.debug('Swagger plugin disabled')
       return
     }
 
-    try {
-      // Build servers list
-      const servers = DEFAULTS.servers.length > 0 ? DEFAULTS.servers : [
-        {
-          url: `http://${serverConfig.server.host}:${serverConfig.server.port}`,
-          description: 'Development server'
-        }
-      ]
-
-      // Add production server if in production
-      if (context.utils.isProduction()) {
-        servers.push({
-          url: 'https://api.example.com', // This would be configured
-          description: 'Production server'
-        })
-      }
-
-      // Simple Swagger configuration - all options from config/plugins.config.ts
-      const swaggerConfig = {
-        path: DEFAULTS.path,
-        documentation: {
-          info: {
-            title: DEFAULTS.title || appConfig.name || 'FluxStack API',
-            version: DEFAULTS.version || appConfig.version,
-            description: DEFAULTS.description || appConfig.description || 'Modern full-stack TypeScript framework with type-safe API endpoints'
-          },
-          servers,
-
-          // Add security schemes if defined
-          ...(Object.keys(DEFAULTS.securitySchemes).length > 0 && {
-            components: {
-              securitySchemes: DEFAULTS.securitySchemes
-            }
-          }),
+    // Build servers list
+    const servers = parseServers(pluginsConfig.swaggerServers ?? '')
+    if (servers.length === 0) {
+      servers.push({
+        url: `http://${serverConfig.server.host}:${serverConfig.server.port}`,
+        description: 'Development server'
+      })
+    }
 
-          // Add global security if defined
-          ...(DEFAULTS.globalSecurity.length > 0 && {
-            security: DEFAULTS.globalSecurity
-          })
+    // Swagger configuration
+    const config = {
+      path: pluginsConfig.swaggerPath ?? '/swagger',
+      documentation: {
+        info: {
+          title: pluginsConfig.swaggerTitle ?? appConfig.name ?? 'FluxStack API',
+          version: pluginsConfig.swaggerVersion ?? appConfig.version ?? '1.0.0',
+          description: pluginsConfig.swaggerDescription ?? 'API documentation'
         },
-        exclude: DEFAULTS.excludePaths,
-        swaggerOptions: DEFAULTS.swaggerOptions
+        servers
+      },
+      exclude: pluginsConfig.swaggerExcludePaths ?? [],
+      swaggerOptions: {
+        persistAuthorization: pluginsConfig.swaggerPersistAuthorization,
+        displayRequestDuration: pluginsConfig.swaggerDisplayRequestDuration,
+        filter: pluginsConfig.swaggerEnableFilter,
+        showExtensions: pluginsConfig.swaggerShowExtensions,
+        tryItOutEnabled: pluginsConfig.swaggerTryItOutEnabled
       }
+    }
 
-      // Add Basic Auth middleware if enabled
-      if (DEFAULTS.authEnabled && DEFAULTS.authPassword) {
-        context.app.onBeforeHandle({ as: 'global' }, ({ request, set, path }) => {
-          // Only protect Swagger routes
-          if (!path.startsWith(DEFAULTS.path)) {
-            return
-          }
-
-          const authHeader = request.headers.get('authorization')
-
-          if (!authHeader || !authHeader.startsWith('Basic ')) {
-            set.status = 401
-            set.headers['WWW-Authenticate'] = 'Basic realm="Swagger Documentation"'
-            return {
-              error: 'Authentication required',
-              message: 'Please provide valid credentials to access Swagger documentation'
-            }
-          }
-
-          // Decode Basic Auth credentials
-          const base64Credentials = authHeader.substring(6)
-          const credentials = Buffer.from(base64Credentials, 'base64').toString('utf-8')
-          const [username, password] = credentials.split(':')
-
-          // Validate credentials
-          if (username !== DEFAULTS.authUsername || password !== DEFAULTS.authPassword) {
-            set.status = 401
-            set.headers['WWW-Authenticate'] = 'Basic realm="Swagger Documentation"'
-            return {
-              error: 'Invalid credentials',
-              message: 'The provided username or password is incorrect'
-            }
-          }
-
-          // Credentials valid, continue to Swagger
-        })
+    // Add Basic Auth if enabled
+    if (pluginsConfig.swaggerAuthEnabled && pluginsConfig.swaggerAuthPassword) {
+      context.app.onBeforeHandle({ as: 'global' }, ({ request, set, path }: { request: Request; set: any; path: string }) => {
+        if (!path.startsWith(pluginsConfig.swaggerPath ?? '/swagger')) return
 
-        context.logger.debug(`🔒 Swagger authentication enabled (username: ${DEFAULTS.authUsername})`)
-      }
+        const authHeader = request.headers.get('authorization')
+        if (!authHeader?.startsWith('Basic ')) {
+          set.status = 401
+          set.headers['WWW-Authenticate'] = 'Basic realm="Swagger"'
+          return { error: 'Authentication required' }
+        }
 
-      // That's it! Elysia Swagger auto-discovers everything else
-      context.app.use(swagger(swaggerConfig))
+        const [username, password] = Buffer.from(authHeader.substring(6), 'base64')
+          .toString('utf-8')
+          .split(':')
 
-      context.logger.debug(`Swagger documentation enabled at ${DEFAULTS.path}`, {
-        title: swaggerConfig.documentation.info.title,
-        version: swaggerConfig.documentation.info.version,
-        servers: servers.length,
-        authEnabled: DEFAULTS.authEnabled
+        if (username !== pluginsConfig.swaggerAuthUsername ||
+            password !== pluginsConfig.swaggerAuthPassword) {
+          set.status = 401
+          set.headers['WWW-Authenticate'] = 'Basic realm="Swagger"'
+          return { error: 'Invalid credentials' }
+        }
       })
-    } catch (error) {
-      context.logger.error('Failed to setup Swagger plugin', { error })
-      throw error
+
+      context.logger.debug(`Swagger auth enabled (user: ${pluginsConfig.swaggerAuthUsername})`)
     }
+
+    context.app.use(swagger(config))
+    context.logger.debug(`Swagger enabled at ${pluginsConfig.swaggerPath}`)
   },
 
   onServerStart: async (context: PluginContext) => {
-    if (DEFAULTS.enabled) {
-      const swaggerUrl = `http://${serverConfig.server.host}:${serverConfig.server.port}${DEFAULTS.path}`
-      context.logger.debug(`📋 Swagger documentation available at: ${swaggerUrl}`)
-    }
+    if (!pluginsConfig.swaggerEnabled) return
+
+    const url = `http://${serverConfig.server.host}:${serverConfig.server.port}${pluginsConfig.swaggerPath}`
+    context.logger.debug(`Swagger available at: ${url}`)
   }
 }
 
-// ==========================================
-// ⚙️  SWAGGER CONFIGURATION
-// ==========================================
-//
-// All Swagger options are configurable via:
-// 📁 config/plugins.config.ts (user editable)
-// 🌍 Environment variables (.env file)
-//
-// Available configurations:
-//
-// 1️⃣ Basic Settings:
-//   - SWAGGER_ENABLED (default: true)
-//   - SWAGGER_TITLE (default: 'FluxStack API')
-//   - SWAGGER_VERSION (default: app version)
-//   - SWAGGER_DESCRIPTION (default: 'API documentation...')
-//   - SWAGGER_PATH (default: '/swagger')
-//
-// 2️⃣ Advanced Options:
-//   - SWAGGER_EXCLUDE_PATHS (array, default: [])
-//   - SWAGGER_SERVERS (format: "url1|desc1,url2|desc2")
-//     Example: "https://api.prod.com|Production,https://staging.com|Staging"
-//
-// 3️⃣ Swagger UI Options:
-//   - SWAGGER_PERSIST_AUTH (default: true)
-//   - SWAGGER_DISPLAY_DURATION (default: true)
-//   - SWAGGER_ENABLE_FILTER (default: true)
-//   - SWAGGER_SHOW_EXTENSIONS (default: true)
-//   - SWAGGER_TRY_IT_OUT (default: true)
-//
-// 4️⃣ Authentication (Basic Auth):
-//   - SWAGGER_AUTH_ENABLED (default: false)
-//   - SWAGGER_AUTH_USERNAME (default: 'admin')
-//   - SWAGGER_AUTH_PASSWORD (required if auth enabled)
-//
-// Example .env configuration:
-// ```
-// SWAGGER_ENABLED=true
-// SWAGGER_TITLE=My API
-// SWAGGER_PATH=/api-docs
-// SWAGGER_SERVERS=https://api.myapp.com|Production,https://staging.myapp.com|Staging
-// SWAGGER_EXCLUDE_PATHS=/internal,/admin
-//
-// # Protect Swagger with Basic Auth
-// SWAGGER_AUTH_ENABLED=true
-// SWAGGER_AUTH_USERNAME=admin
-// SWAGGER_AUTH_PASSWORD=super-secret-password
-// ```
-//
-// 🔒 When authentication is enabled:
-// - Browser will prompt for username/password
-// - All Swagger routes are protected (UI + JSON spec)
-// - Credentials are validated using Basic Auth
-// - Perfect for staging/production environments
-//
-// ==========================================
-// 🏷️  AUTOMATIC TAG DISCOVERY
-// ==========================================
-//
-// ✨ 100% AUTOMATIC - Just add tags to your routes!
-//
-// Example 1 - Simple route:
-// app.get('/products', handler, {
-//   detail: {
-//     summary: 'Get all products',
-//     tags: ['Products', 'Catalog']  // ✅ Auto-discovered!
-//   }
-// })
-//
-// Example 2 - Grouped routes:
-// export const ordersRoutes = new Elysia({ prefix: '/orders', tags: ['Orders'] })
-//   .get('/', handler, {
-//     detail: {
-//       summary: 'List orders',
-//       tags: ['Orders', 'Management']  // ✅ Auto-discovered!
-//     }
-//   })
-//
-// Elysia Swagger automatically:
-// - Discovers all tags from routes
-// - Organizes endpoints by tag
-// - Generates OpenAPI spec
-// - Creates interactive UI
-//
-// ==========================================
-// 🔐 SECURITY CONFIGURATION
-// ==========================================
-//
-// To enable security in your FluxStack app, configure like this:
-//
-// plugins: {
-//   config: {
-//     swagger: {
-//       securitySchemes: {
-//         bearerAuth: {
-//           type: 'http',
-//           scheme: 'bearer',
-//           bearerFormat: 'JWT'
-//         },
-//         apiKeyAuth: {
-//           type: 'apiKey',
-//           in: 'header',
-//           name: 'X-API-Key'
-//         }
-//       },
-//       globalSecurity: [
-//         { bearerAuth: [] }  // Apply JWT auth globally
-//       ]
-//     }
-//   }
-// }
-//
-// Then in your routes, you can override per endpoint:
-// app.get('/public', handler, {
-//   detail: { security: [] }  // No auth required
-// })
-//
-// app.get('/private', handler, {
-//   detail: {
-//     security: [{ apiKeyAuth: [] }]  // API key required
-//   }
-// })
-
 export default swaggerPlugin