settings

type Component interface {
	// RuntimeSettings returns the configurable settings
	RuntimeSettings() map[string]RuntimeSetting
	// GetRuntimeSetting returns the value of a runtime configurable setting
	GetRuntimeSetting(setting string) (interface{}, error)
	// SetRuntimeSetting changes the value of a runtime configurable setting
	SetRuntimeSetting(setting string, value interface{}, source model.Source) error

	// GetFullConfig returns the full config
	GetFullConfig(namespaces ...string) http.HandlerFunc
	// GetFullConfigWithoutDefaults returns the full config without defaults
	GetFullConfigWithoutDefaults(namespaces ...string) http.HandlerFunc
	// GetFullConfigBySource returns the full config by sources (config, default, env vars ...)
	GetFullConfigBySource() http.HandlerFunc
	// GetValue allows to retrieve the runtime setting
	GetValue(w http.ResponseWriter, r *http.Request)
	// SetValue allows to modify the runtime setting
	SetValue(w http.ResponseWriter, r *http.Request)
	// ListConfigurable returns the list of configurable setting at runtime
	ListConfigurable(w http.ResponseWriter, r *http.Request)
}

type Params struct {
	// Settings define the runtime settings the component would understand
	Settings map[string]RuntimeSetting
	// The config object in which the settings would apply operations
	Config config.Component
	// Optional namespace restriction that GetFullConfig would return settings for
	Namespaces []string
}

type RuntimeSetting interface {
	Get(config config.Component) (interface{}, error)
	Set(config config.Component, v interface{}, source model.Source) error
	Description() string
	Hidden() bool
}

type RuntimeSettingProvider struct {
	fx.Out

	Setting RuntimeSetting `group:"runtime_setting"`
}

type RuntimeSettingResponse struct {
	Description string
	Hidden      bool
}

type SettingNotFoundError struct {
	Name string
}