config

type AppConfig struct {
	Title       string `yaml:"title"`
	Port        int    `yaml:"port"`
	BaseURL     string `yaml:"baseURL" env:"APP_BASE_URL"`
	InternalURL string `yaml:"internalURL" env:"APP_INTERNAL_URL"`
	HomeURL     string `yaml:"homeURL"`
	ServiceURL  string `yaml:"serviceURL" env:"APP_SERVICE_URL"`

	// AssetsURL is the base URL for static UI assets (CSS, JS, images, icons).
	// Empty means assets are served with relative paths (default).
	AssetsURL string `yaml:"assetsURL" env:"APP_ASSETS_URL"`

	ContextAreaPrefix string            `yaml:"contextAreaPrefix"`
	DisableUI         bool              `yaml:"disableUI"`
	Paths             Paths             `yaml:"-"`
	Editor            *EditorConfig     `yaml:"editor"`
	History           *AppHistoryConfig `yaml:"history"`
	Storage           *StorageConfig    `yaml:"storage"`
	Extra             map[string]any    `yaml:"extra"`
}

type AppHistoryConfig struct {
	Enabled  *bool         `yaml:"enabled"`
	URL      string        `yaml:"url"`
	Duration time.Duration `yaml:"duration" env:"ROUTER_HISTORY_DURATION"`
}

type BodyMatchCondition struct {
	Path   string      `yaml:"path"`
	Equals interface{} `yaml:"equals"`
}

type BodyMatchConfig struct {
	Default string               `yaml:"default"`
	Fail    []BodyMatchCondition `yaml:"fail"`
	Except  []BodyMatchCondition `yaml:"except"`
}

type CacheConfig struct {
	Requests bool          `yaml:"requests"`
	Replay   *ReplayConfig `yaml:"replay,omitempty"`
}

type EditorConfig struct {
	Theme     string `yaml:"theme"`
	DarkTheme string `yaml:"darkTheme"`
	FontSize  int    `yaml:"fontSize"`
}

type HTTPStatusConfig struct {
	Exact  int              `yaml:"exact"`
	Range  string           `yaml:"range"`
	Except []int            `yaml:"except"`
	Body   *BodyMatchConfig `yaml:"body"`
}

type HTTPStatusMatchConfig []HTTPStatusConfig

type HandlerConfig struct {
	SelfPrefix string `yaml:"self-prefix"`
}

type HistoryConfig struct {
	Enabled     *bool    `yaml:"enabled,omitempty"`
	MaskHeaders []string `yaml:"mask-headers,omitempty"`
}

type KeyValue[K, V any] struct {
	Key   K
	Value V
}

type OptionalProperties struct {
	Min int `yaml:"min"`
	Max int `yaml:"max"`
}

type Paths struct {
	Base      string
	Docs      string
	Resources string
	Data      string
	OpenAPI   string
	Static    string
	Services  string
	UI        string
}

type RedisConfig struct {
	// host:port address. When Host is set via env, Address is built from Host:Port.
	Address  string `yaml:"address"`
	Host     string `yaml:"host" env:"REDIS_HOST"`
	Port     string `yaml:"port" env:"REDIS_PORT" envDefault:"6379"`
	Username string `yaml:"username" env:"REDIS_USERNAME"`
	Password string `yaml:"password" env:"REDIS_PASSWORD"`
	DB       int    `yaml:"db" env:"REDIS_DB"`
	TLS      bool   `yaml:"tls" env:"REDIS_TLS"`
}

type ReplayConfig struct {
	// TTL is how long recordings are kept. Default: 24h.
	TTL time.Duration `yaml:"ttl"`

	// UpstreamOnly when true only records responses from upstream services.
	UpstreamOnly bool `yaml:"upstream-only"`

	// AutoReplay when true activates replay for configured endpoints without requiring
	// the X-Cxs-Replay header. When false (default), the header must be present.
	AutoReplay bool `yaml:"auto-replay"`

	// Endpoints maps path patterns to their match configurations.
	// Two forms are supported:
	//
	//   With method (matches only that method):
	//     /pay:
	//       POST:
	//         match: [reference]
	//
	//   Without method (matches any request method):
	//     /pay:
	//       match: [reference]
	Endpoints map[string]map[string]*ReplayEndpoint `yaml:"endpoints"`
}

type ReplayEndpoint struct {
	// Match specifies which request fields form the replay key.
	Match *ReplayMatch `yaml:"match"`
}

type ReplayMatch struct {
	// Path fields are path variable names to include in the replay key.
	Path []string `yaml:"path"`

	// Body fields are extracted from the request body (JSON dotted paths or form-encoded flat keys).
	Body []string `yaml:"body"`

	// Query fields are extracted from the URL query string.
	Query []string `yaml:"query"`
}

type ServiceConfig struct {
	Name            string                   `yaml:"name,omitempty"`
	Upstream        *UpstreamConfig          `yaml:"upstream,omitempty"`
	Latency         time.Duration            `yaml:"latency,omitempty"`
	Latencies       map[string]time.Duration `yaml:"latencies,omitempty"`
	Errors          map[string]int           `yaml:"errors,omitempty"`
	Cache           *CacheConfig             `yaml:"cache,omitempty"`
	History         *HistoryConfig           `yaml:"history,omitempty"`
	ResourcesPrefix string                   `yaml:"resources-prefix,omitempty"`
	SpecOptions     *SpecOptions             `yaml:"spec,omitempty"`
	Extra           map[string]any           `yaml:"extra,omitempty"`
	// contains filtered or unexported fields
}

type SpecOptions struct {
	LazyLoad           bool                `yaml:"lazyLoad"`
	Simplify           bool                `yaml:"simplify"`
	OptionalProperties *OptionalProperties `yaml:"optional-properties"`
}

type StorageConfig struct {
	Type         StorageType    `yaml:"type" env:"STORAGE_TYPE"`
	DriverConfig map[string]any `yaml:"-"`

	// Redis is kept for backward compatibility with env tags (REDIS_HOST, etc.).
	Redis *RedisConfig `yaml:"redis"`
}

type StorageType string

type UpstreamConfig struct {
	URL     string            `yaml:"url"`
	Timeout time.Duration     `yaml:"timeout"`
	Headers map[string]string `yaml:"headers"`

	// FailOn defines which upstream HTTP status codes should be returned immediately
	// to the client without falling back to the generator.
	// nil (omitted): uses default (400-499 except 401, 403). Set to empty list (fail-on: []) to disable.
	FailOn *HTTPStatusMatchConfig `yaml:"fail-on"`

	// StickyTimeout enables server-side session affinity for upstream/generator routing.
	// When a client gets a generated (fallback) response, subsequent requests from the
	// same remote address skip upstream for this duration. 0 or omitted = disabled.
	StickyTimeout time.Duration `yaml:"sticky-timeout"`
}