config

type AppConfig struct {
	Title       string `yaml:"title" env:"APP_TITLE"`
	Port        int    `yaml:"port" env:"APP_PORT"`
	BaseURL     string `yaml:"baseURL" env:"APP_BASE_URL"`
	InternalURL string `yaml:"internalURL" env:"APP_INTERNAL_URL"`
	HomeURL     string `yaml:"homeURL" env:"APP_HOME_URL"`
	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" env:"APP_DISABLE_UI"`
	DisableConfigUI   bool              `yaml:"disableConfigUI" env:"APP_DISABLE_CONFIG_UI"`
	Paths             Paths             `yaml:"-"`
	Editor            *EditorConfig     `yaml:"editor"`
	History           *AppHistoryConfig `yaml:"history"`
	Replay            *AppReplayConfig  `yaml:"replay"`
	Storage           *StorageConfig    `yaml:"storage"`
	BasicAuth         *BasicAuthConfig  `yaml:"basicAuth"`
	Extra             map[string]any    `yaml:"extra"`
}

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

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

type BasicAuthConfig struct {
	User         string `yaml:"user" env:"MOCKZILLA_BASIC_AUTH_USER"`
	Password     string `yaml:"password" env:"MOCKZILLA_BASIC_AUTH_PASSWORD"`
	PasswordHash string `yaml:"passwordHash" env:"MOCKZILLA_BASIC_AUTH_PASSWORD_HASH"`
}

type BehaviorConfig struct {
	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"`
	// contains filtered or unexported fields
}

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"`
}

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

type EndpointConfig struct {
	BehaviorConfig `yaml:",inline"`
}

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"`
	Duration    time.Duration `yaml:"duration,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 {
	// Enabled toggles replay recording and serving (defaults to true when nil).
	Enabled *bool `yaml:"enabled,omitempty"`

	// Duration is how long recordings are kept. Defaults to the app-level
	// replay.duration when unset.
	Duration time.Duration `yaml:"duration"`

	// 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-Mockzilla-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 {
	BehaviorConfig `yaml:",inline"`

	Name        string                                `yaml:"name,omitempty"`
	Endpoints   map[string]map[string]*EndpointConfig `yaml:"endpoints,omitempty"`
	Cache       *CacheConfig                          `yaml:"cache,omitempty"`
	Replay      *ReplayConfig                         `yaml:"replay,omitempty"`
	History     *HistoryConfig                        `yaml:"history,omitempty"`
	Mount       string                                `yaml:"mount,omitempty"`
	SpecOptions *SpecOptions                          `yaml:"spec,omitempty"`
	Validate    *ValidateConfig                       `yaml:"validate,omitempty"`
	Extra       map[string]any                        `yaml:"extra,omitempty"`
}

type SpecOptions struct {
	LazyLoad bool `yaml:"lazyLoad"`
	Simplify bool `yaml:"simplify"`

	// Compress embeds the spec gzipped instead of verbatim, shrinking the
	// binary at the cost of a generated setup/spec.gz that has to be committed
	// alongside the generated code, since //go:embed resolves at compile time.
	Compress           bool                `yaml:"compress"`
	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"`
}

type ValidateConfig struct {
	Request  *bool `yaml:"request,omitempty"`
	Response *bool `yaml:"response,omitempty"`
	// Verbose keeps the validator's bulky ReferenceSchema and
	// ReferenceObject fields in the client-facing error payload. Default
	// (false) strips them so clients get a slim error with just the
	// actionable bits (reason, path, location, line/column). Tests and
	// debugging sessions set it true to see the full context.
	Verbose *bool `yaml:"verbose,omitempty"`
	// Timeout bounds a single request- or response-validation call.
	// The validator inlines the schema before checking the body, and
	// pathological specs (deeply self-referential allOf, mutually
	// recursive components, very large request bodies) trigger
	// exponential rendering that never returns within a request
	// lifetime. On timeout we skip validation for that request rather
	// than block the response. Default 1s; bump for specs with
	// legitimately large/complex bodies.
	Timeout *time.Duration `yaml:"timeout,omitempty"`
}