config

type APIConfig struct {
	Listen string `yaml:"listen"`

	// ExportByteHardCap is the byte ceiling on /api/export before
	// `?bytes_all=1` is required to bypass. Measured in source JSONL
	// bytes (sum of file sizes for matched groups, one os.Stat per
	// group). 0 = unlimited; default 2 GiB.
	//
	// Independent of the row cap. See internal/api/export.go's
	// defaultExportByteHardCap docstring for the rationale; this YAML
	// field overrides that default. Env var:
	// APILOG_API_EXPORT_BYTE_HARDCAP.
	ExportByteHardCap int64 `yaml:"export_byte_hardcap"`
}

type Config struct {
	Proxy       ProxyConfig       `yaml:"proxy"`
	API         APIConfig         `yaml:"api"`
	Storage     StorageConfig     `yaml:"storage"`
	Timeouts    TimeoutsConfig    `yaml:"timeouts"`
	Shutdown    ShutdownConfig    `yaml:"shutdown"`
	Logging     LoggingConfig     `yaml:"logging"`
	Diagnostics DiagnosticsConfig `yaml:"diagnostics"`
	Plugins     PluginsConfig     `yaml:"plugins"`
	Media       MediaConfig       `yaml:"media"`
	Viewer      ViewerConfig      `yaml:"viewer"`
}

type DiagnosticsConfig struct {
	// Cadence for the counter-snapshot INFO line. 0 disables.
	// Default 60s; tight enough for prod incident timelines, loose
	// enough not to spam logs.
	SnapshotIntervalSeconds int `yaml:"snapshot_interval_seconds"`
}

type LoggingConfig struct {
	Level string `yaml:"level"`
}

type MediaConfig struct {
	SaveAttachments bool `yaml:"save_attachments"`
}

type PluginsConfig struct {
	PathFilter    pathfilter.Config    `yaml:"path_filter"`
	CaptureFilter capturefilter.Config `yaml:"capture_filter"`
}

type ProxyConfig struct {
	Listen   string `yaml:"listen"`
	Upstream string `yaml:"upstream"`
}

type ShutdownConfig struct {
	GraceSeconds int `yaml:"grace_seconds"`
}

type StorageConfig struct {
	DataDir         string `yaml:"data_dir"`
	MaxBodyBytes    int64  `yaml:"max_body_bytes"`
	CaptureChanSize int    `yaml:"capture_chan_size"`
	WriterChanSize  int    `yaml:"writer_chan_size"`
}

type TimeoutsConfig struct {
	ReadHeaderSeconds     int `yaml:"read_header_seconds"`
	IdleSeconds           int `yaml:"idle_seconds"`
	StreamIdleSeconds     int `yaml:"stream_idle_seconds"`
	ReqBodyCaptureSeconds int `yaml:"req_body_capture_seconds"`

	// End-to-end traces this slow trigger a WARN log + slow_traces++.
	// 0 disables (no WARN). Default 30s.
	SlowTraceSeconds int `yaml:"slow_trace_seconds"`
}

type ViewerConfig struct {
	Enabled    bool   `yaml:"enabled"`
	Repo       string `yaml:"repo"`
	Version    string `yaml:"version"`
	Sha256     string `yaml:"sha256"`
	LocalPath  string `yaml:"local_path"`
	CacheDir   string `yaml:"cache_dir"`
	PublicPath string `yaml:"public_path"`

	// ReleasesAPIBase overrides the dist.zip fetch endpoint. Empty
	// means "use https://api.github.com" (the default). Internal
	// artifact stores (Gitea, Forgejo) speak the same release-API
	// shape and slot in via this field — e.g. setting it to
	// "http://gitea.homelab.lan/api/v1" with a matching `Repo` =
	// "<gitea-owner>/<repo>" reroutes the fetch.
	ReleasesAPIBase string `yaml:"releases_api_base"`

	// ReleasesAuthToken is sent on the metadata + asset requests as
	// `Authorization: token <value>`. Required for private Gitea
	// repos. Sensitive — source from env (APILOG_VIEWER_RELEASES_AUTH_TOKEN)
	// or a secrets file rather than committing to repo-tracked YAML.
	ReleasesAuthToken string `yaml:"releases_auth_token"`
}