contract

type CliConfiguration interface {
	Name() string

	Description() string
}

type Configuration interface {
	Get(name string) Parameter

	MustGet(name string) Parameter

	RegisterRuntime(name string, value any)

	RegisterRuntimeSecret(name string, value any)

	MarkSecret(name string) bool

	Resolve() error

	Cli() CliConfiguration

	Kernel() KernelConfiguration

	Http() HttpConfiguration

	Names() []string
}

type EnvironmentSource interface {
	Load() (map[string]string, error)
}

type HttpConfiguration interface {
	Address() string

	DefaultLocale() string

	PublicDir() string

	StaticIndexFile() string

	MaxRequestBodyBytes() int

	StaticEnableCache() bool

	StaticCacheMaxAge() int

	StaticExcludedPaths() []string

	SessionTtl() time.Duration

	SessionTombstoneRetention() time.Duration

	ShutdownTimeout() time.Duration
}

type KernelConfiguration interface {
	DefaultMode() string

	ProcessRole() string

	Env() string

	ProjectDir() string

	LogsDir() string

	CacheDir() string

	LogPath() string

	LogLevel() loggingcontract.Level
}

type Parameter interface {
	EnvironmentKey() string

	EnvironmentValue() any

	Value() any

	IsDefault() bool

	IsSecret() bool

	String() string

	MustString() string

	Bool() (bool, error)

	Int() (int, error)

	Float() (float64, error)

	Duration() (time.Duration, error)
}