config

type Config struct {
	Server  ServerConfig  `mapstructure:"server"`
	Logging LoggingConfig `mapstructure:"logging"`
	Metrics MetricsConfig `mapstructure:"metrics"`
	Health  HealthConfig  `mapstructure:"health"`
	Debug   DebugConfig   `mapstructure:"debug"`
	Workers int           `mapstructure:"workers"`
	// DataRoot optionally relocates gonimbus operational state. DataDir is
	// accepted as a compatibility alias; DataRoot wins when both are set.
	DataRoot string `mapstructure:"data_root"`
	DataDir  string `mapstructure:"data_dir"`
	// HubReadHandles are logical read-only hub bindings used by exact acquisition
	// and as custody bridge sources. The resolved provider capability never
	// crosses into the configuration-free libraries as this structure or as a
	// handle name.
	HubReadHandles map[string]HubReadHandleConfig `mapstructure:"hub_read_handles"`
	// HubPublishHandles are logical exact-read plus conditional-create bindings
	// used by custody bridge publication. They deliberately do not grant list,
	// overwrite, delete, or destination-administration authority.
	HubPublishHandles map[string]HubPublishHandleConfig `mapstructure:"hub_publish_handles"`
}

type DebugConfig struct {
	// Enabled controls whether debug mode is active
	Enabled bool `mapstructure:"enabled"`

	// PprofEnabled controls whether pprof endpoints are exposed
	// WARNING: Only enable in development/staging environments
	PprofEnabled bool `mapstructure:"pprof_enabled"`
}

type EnvVarSpec = gfconfig.EnvVarSpec

type HealthConfig struct {
	// Enabled controls whether health endpoints are exposed
	Enabled bool `mapstructure:"enabled"`
}

type HubPublishHandleConfig struct {
	URI        string `mapstructure:"uri"`
	Profile    string `mapstructure:"profile"`
	Region     string `mapstructure:"region"`
	Endpoint   string `mapstructure:"endpoint"`
	GCPProject string `mapstructure:"gcp_project"`
}

type HubReadHandleConfig struct {
	URI        string `mapstructure:"uri"`
	Profile    string `mapstructure:"profile"`
	Region     string `mapstructure:"region"`
	Endpoint   string `mapstructure:"endpoint"`
	GCPProject string `mapstructure:"gcp_project"`
}

type LoggingConfig struct {
	// Level controls the minimum log level
	// Valid values: trace, debug, info, warn, error
	Level string `mapstructure:"level"`

	// Profile selects the logging complexity level
	// Valid values: SIMPLE, STRUCTURED, ENTERPRISE
	// See: gofulmen/docs/crucible-go/standards/observability/logging.md
	Profile string `mapstructure:"profile"`
}

type MetricsConfig struct {
	// Enabled controls whether metrics are exposed
	Enabled bool `mapstructure:"enabled"`

	// Port is the dedicated metrics endpoint port (Prometheus format)
	// Metrics are also available at the main HTTP port in JSON format
	Port int `mapstructure:"port"`
}

type ServerConfig struct {
	Host            string        `mapstructure:"host"`
	Port            int           `mapstructure:"port"`
	ReadTimeout     time.Duration `mapstructure:"read_timeout"`
	WriteTimeout    time.Duration `mapstructure:"write_timeout"`
	IdleTimeout     time.Duration `mapstructure:"idle_timeout"`
	ShutdownTimeout time.Duration `mapstructure:"shutdown_timeout"`
}