actuator

type Config struct {
	// Name is the instance name.
	Name string `koanf:"-"`

	// Enabled gates the whole module; when false Init/Start are no-ops. Default false.
	Enabled bool `koanf:"enabled"`

	// Host to bind the private actuator listener. Default 127.0.0.1.
	Host string `koanf:"host"`

	// Port to bind. Default 6060.
	Port uint16 `koanf:"port"`

	// BasePath prefixes every endpoint. Default /debug.
	BasePath string `koanf:"base_path"`

	// ShowValues controls config-value masking: never|always|when_authorized.
	// Default never (matched leaves render as ******).
	ShowValues string `enum:"never,always,when_authorized" koanf:"show_values"`

	// RedactPatterns extends (does not replace) the default key-redaction set.
	RedactPatterns []string `koanf:"redact_patterns"`

	// Endpoints toggles optional endpoint groups. All default true.
	Endpoints EndpointToggles `koanf:"endpoints"`

	// AllowInsecure downgrades the fail-closed security refusals (non-loopback
	// without auth; sensitive endpoints without auth) to a warn. Default false.
	AllowInsecure bool `koanf:"allow_insecure"`

	// Mount, when set, mounts endpoints under the caller's router instead of a
	// private listener (escape hatch, code-only).
	Mount fiber.Router `code_only:"WithMount" koanf:"-"`

	// Auth is caller-supplied middleware gating sensitive (and optionally all)
	// endpoints (code-only). The real JWT verifier is a later phase.
	Auth fiber.Handler `code_only:"WithAuth" koanf:"-"`
}

type ConfigResponse struct {
	Values     map[string]any    `json:"values"`
	Provenance map[string]string `json:"provenance,omitempty"`
}

type DIResponse struct {
	Format string `json:"format"`
	Graph  string `json:"graph"`
}

type EndpointToggles struct {
	Pprof   bool `koanf:"pprof"`
	Expvar  bool `koanf:"expvar"`
	UI      bool `koanf:"ui"`
	Loggers bool `koanf:"loggers"`
}

type InfoResponse struct {
	GoVersion string            `json:"go_version"`
	Path      string            `json:"path"`
	Main      ModuleVersion     `json:"main"`
	Settings  map[string]string `json:"settings"`
	Deps      []ModuleVersion   `json:"deps"`
}

type InstanceRoutes struct {
	Instance string      `json:"instance"`
	Routes   []RouteView `json:"routes"`
}

type LoggersRequest struct {
	Level string `json:"level"`
}

type LoggersResponse struct {
	Level string `json:"level"`
}

type Module struct {
	lakta.NamedBase
	lakta.SyncCtx
	// contains filtered or unexported fields
}

type ModuleVersion struct {
	Path    string `json:"path"`
	Version string `json:"version"`
}

type ModuleView struct {
	Name         string   `json:"name"`
	Type         string   `json:"type"`
	InitOrder    int      `json:"init_order"`
	Provides     []string `json:"provides"`
	Requires     []string `json:"requires"`
	Optional     []string `json:"optional"`
	Lifecycle    string   `json:"lifecycle"`
	State        string   `json:"state"`
	InitDuration string   `json:"init_duration"`
}

type ModulesResponse struct {
	Modules []ModuleView `json:"modules"`
}

type Option func(m *Config)

type Redactor struct {
	// contains filtered or unexported fields
}

type RouteView struct {
	Method string `json:"method"`
	Path   string `json:"path"`
	Name   string `json:"name,omitempty"`
}

type RoutesResponse struct {
	Instances []InstanceRoutes `json:"instances"`
}

type StartupEntry struct {
	Name         string `json:"name"`
	InitOrder    int    `json:"init_order"`
	InitDuration string `json:"init_duration"`
}

type StartupResponse struct {
	Total   string         `json:"total_init_duration"`
	Entries []StartupEntry `json:"entries"`
}