create-fluxstack 1.9.1 → 1.12.0

package/app/server/routes/users.routes.ts

@@ -1,5 +1,6 @@
 import { Elysia, t } from 'elysia'
-import { UsersController } from '@/app/server/controllers/users.controller'
+import { UsersController } from '@app/server/controllers/users.controller'
+import type { CreateUserRequest } from '@app/shared/types'
 
 // ===== Request/Response Schemas =====
 
@@ -77,9 +78,7 @@ const ErrorResponseSchema = t.Object({
  */
 export const usersRoutes = new Elysia({ prefix: '/users', tags: ['Users'] })
   // GET /users - Get all users
-  .get('/', async () => {
-    return await UsersController.getUsers()
-  }, {
+  .get('/', async () => UsersController.getUsers(), {
     detail: {
       summary: 'Get All Users',
       description: 'Retrieves a list of all registered users',
@@ -90,19 +89,18 @@ export const usersRoutes = new Elysia({ prefix: '/users', tags: ['Users'] })
 
   // GET /users/:id - Get user by ID
   .get('/:id', async ({ params, set }) => {
-    const id = parseInt(params.id)
+    const id = Number(params.id)
 
-    // Handle invalid ID
-    if (isNaN(id)) {
+    if (!Number.isFinite(id)) {
       set.status = 400
-      return { error: 'ID inválido' }
+      return { success: false, error: 'ID invalido' }
     }
 
     const result = await UsersController.getUserById(id)
 
-    if (!result) {
+    if (!result.success) {
       set.status = 404
-      return { error: 'Usuário não encontrado' }
+      return result
     }
 
     return result
@@ -124,17 +122,17 @@ export const usersRoutes = new Elysia({ prefix: '/users', tags: ['Users'] })
 
   // POST /users - Create new user
   .post('/', async ({ body, set }) => {
-    // Validate required fields
-    if (!body.name || !body.email) {
+    const payload = body as CreateUserRequest
+
+    if (!payload.name || !payload.email) {
       set.status = 400
       return {
         success: false,
-        error: 'Nome e email são obrigatórios'
+        error: 'Nome e email sao obrigatorios'
       }
     }
 
-    // Validate name length
-    if (body.name.length < 2) {
+    if (payload.name.trim().length < 2) {
       set.status = 400
       return {
         success: false,
@@ -142,23 +140,28 @@ export const usersRoutes = new Elysia({ prefix: '/users', tags: ['Users'] })
       }
     }
 
-    // Validate email format
-    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/
-    if (!emailRegex.test(body.email)) {
+    const emailRegex = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)+$/
+    if (!emailRegex.test(payload.email)) {
       set.status = 400
       return {
         success: false,
-        error: 'Email inválido'
+        error: 'Email invalido'
       }
     }
 
-    const result = await UsersController.createUser(body)
+    const sanitizedPayload: CreateUserRequest = {
+      name: payload.name.trim(),
+      email: payload.email.trim()
+    }
+
+    const result = await UsersController.createUser(sanitizedPayload)
 
-    // If email is duplicate, still return 200 but with success: false
     if (!result.success) {
+      set.status = 409
       return result
     }
 
+    set.status = 201
     return result
   }, {
     detail: {
@@ -168,30 +171,34 @@ export const usersRoutes = new Elysia({ prefix: '/users', tags: ['Users'] })
     },
     body: CreateUserRequestSchema,
     response: {
-      200: CreateUserResponseSchema,
+      201: CreateUserResponseSchema,
       400: t.Object({
         success: t.Literal(false),
         error: t.String()
+      }),
+      409: t.Object({
+        success: t.Literal(false),
+        error: t.String()
       })
     }
   })
 
   // DELETE /users/:id - Delete user
   .delete('/:id', async ({ params, set }) => {
-    const id = parseInt(params.id)
+    const id = Number(params.id)
 
-    if (isNaN(id)) {
+    if (!Number.isFinite(id)) {
       set.status = 400
       return {
         success: false,
-        message: 'ID inválido'
+        message: 'ID invalido'
       }
     }
 
     const result = await UsersController.deleteUser(id)
 
     if (!result.success) {
-      // Don't set 404 status, just return success: false
+      set.status = 404
       return result
     }
 
@@ -210,6 +217,7 @@ export const usersRoutes = new Elysia({ prefix: '/users', tags: ['Users'] })
       400: t.Object({
         success: t.Literal(false),
         message: t.String()
-      })
+      }),
+      404: DeleteUserResponseSchema
     }
   })

package/app/shared/types/index.ts

@@ -11,8 +11,20 @@ export interface CreateUserRequest {
   email: string
 }
 
-export interface UserResponse {
+export interface UserListResponse {
+  success: true
+  users: User[]
+  count: number
+}
+
+export interface UserDetailResponse {
   success: boolean
   user?: User
+  error?: string
+}
+
+export interface MutationResponse {
+  success: boolean
   message?: string
-}
+  error?: string
+}

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