velocity

type App struct {
	// Core services — all exported for direct access
	Router     *router.VelocityRouterV2
	DB         *orm.Manager
	Auth       *auth.Manager
	Log        log.Logger
	Cache      *cache.Manager
	Crypto     crypto.Encryptor
	CSRF       *csrf.CSRF
	Events     events.Dispatcher
	Queue      queue.Driver
	Storage    *storage.Manager
	View       *view.Engine
	Scheduler  *scheduler.Scheduler
	Mail       mail.Mailer
	Exceptions *exceptions.Handler
	Validator  validation.Validator
	// contains filtered or unexported fields
}

type AuthConfig struct {
	DefaultGuard string                    // AUTH_GUARD
	Guards       map[string]GuardConfig    // Guard definitions
	Providers    map[string]ProviderConfig // Provider definitions
	BcryptCost   int                       // HASH_BCRYPT_COST, default 10
}

type CacheConfig struct {
	Driver        string // CACHE_DRIVER: memory, file, redis, database
	Prefix        string // CACHE_PREFIX, default "velocity_cache"
	Path          string // CACHE_PATH (for file driver)
	RedisHost     string // REDIS_HOST, default "127.0.0.1"
	RedisPort     int    // REDIS_PORT, default 6379
	RedisPassword string // REDIS_PASSWORD
	RedisDatabase int    // REDIS_DATABASE, default 0
}

type Config struct {
	// App
	Name  string // APP_NAME, default "Velocity"
	Env   string // APP_ENV, default "development"
	Debug bool   // APP_DEBUG, default false
	Port  string // PORT, default "4000"
	Key   string // APP_KEY (used for crypto)

	// Database
	DB DBConfig

	// Auth
	Auth AuthConfig

	// Cache
	Cache CacheConfig

	// Log
	Log LogConfig

	// Queue
	Queue QueueConfig

	// Storage
	Storage StorageConfig

	// Session
	Session SessionConfig

	// View
	View ViewConfig

	// Crypto
	Crypto CryptoConfig

	// Mail
	Mail MailConfig
}

type CryptoConfig struct {
	Key          string   // APP_KEY or CRYPTO_KEY
	Cipher       string   // CRYPTO_CIPHER, default "AES-256-GCM"
	PreviousKeys []string // CRYPTO_OLD_KEYS (comma-separated)
}

type DBConfig struct {
	Connection      string        // DB_CONNECTION: sqlite, postgres, mysql
	Host            string        // DB_HOST, default "127.0.0.1"
	Port            string        // DB_PORT, default per driver
	Database        string        // DB_DATABASE
	Username        string        // DB_USERNAME
	Password        string        // DB_PASSWORD
	Charset         string        // DB_CHARSET
	Collation       string        // DB_COLLATION
	Prefix          string        // DB_PREFIX
	Schema          string        // DB_SCHEMA
	SSLMode         string        // DB_SSL_MODE
	Timezone        string        // DB_TIMEZONE
	MaxIdleConns    int           // DB_MAX_IDLE_CONNS, default 10
	MaxOpenConns    int           // DB_MAX_OPEN_CONNS, default 100
	ConnMaxLifetime time.Duration // DB_CONN_MAX_LIFETIME, default 3600s
	LogQueries      bool          // DB_LOG_QUERIES
	SlowThreshold   time.Duration // DB_SLOW_QUERY_THRESHOLD
}

type DiskConfig struct {
	Driver string // "local", "s3", "memory"
	Root   string // Root path for local driver
	// S3 fields
	Bucket   string
	Region   string
	Key      string
	Secret   string
	Endpoint string
	URL      string
}

type GuardConfig struct {
	Driver   string                 // "session" or "jwt"
	Provider string                 // Provider name
	Options  map[string]interface{} // Guard-specific options
}

type JWTConfig struct {
	Secret           string // JWT_SECRET
	Algorithm        string // JWT_ALGO, default "HS256"
	TTL              int    // JWT_TTL in minutes, default 60
	RefreshTTL       int    // JWT_REFRESH_TTL in minutes, default 20160
	BlacklistEnabled bool   // JWT_BLACKLIST_ENABLED, default true
}

type LogConfig struct {
	Driver string         // LOG_DRIVER: console, file
	Config map[string]any // Driver-specific config (e.g., "path" for file driver)
}

type MailConfig struct {
	Driver string // MAIL_DRIVER: postmark, mailgun, log
}

type Option func(*App)

type ProviderConfig struct {
	Driver  string // "orm"
	Model   string // AUTH_MODEL, default "User"
	Options map[string]interface{}
}

type QueueConfig struct {
	Driver        string // QUEUE_DRIVER: memory, redis, database
	RedisHost     string // QUEUE_REDIS_HOST, default "localhost"
	RedisPort     string // QUEUE_REDIS_PORT, default "6379"
	RedisPassword string // QUEUE_REDIS_PASSWORD
	RedisDB       string // QUEUE_REDIS_DB, default "0"
}

type SessionConfig struct {
	Driver   string        // SESSION_DRIVER, default "cookie"
	Name     string        // SESSION_NAME, default "velocity_session"
	Lifetime int           // SESSION_LIFETIME in minutes, default 120
	Path     string        // SESSION_PATH, default "/"
	Domain   string        // SESSION_DOMAIN
	Secure   bool          // SESSION_SECURE, default true
	HttpOnly bool          // SESSION_HTTP_ONLY, default true
	SameSite http.SameSite // SESSION_SAME_SITE, default Lax
}

type StorageConfig struct {
	Default string                // STORAGE_DRIVER, default "local"
	Disks   map[string]DiskConfig // Disk configurations
}

type ViewConfig struct {
	RootTemplate string // Path to root template or template string
	Version      string // Asset version for cache busting
	SSREnabled   bool   // Future: SSR support
	SSRURL       string // SSR server URL
}