runtime

type Action int

type Config struct {
	Logger        logger.LoggerFactory
	DryRun        bool
	Resolver      resolver.DnsResolver
	Telemetry     *telemetry.Telemetry
	QuotaHandler  QuotaHandler
	License       licensecfg.ConfigManager
	OffloadEngine offload.Engine
	Net           transport.Net
	// Fifos are the in-process fifos the FIFO listeners bind and the FIFO clusters dial.
	Fifos *fifo.Fifos
	// BuildInfo is the version of the binary.
	BuildInfo buildinfo.BuildInfo
}

type Object interface {
	Runnable
	Reconcilable
}

type ObjectType string

type QuotaHandler interface {
	CheckAndIncrement(username, realm string, quota int) bool
	Decrement(username, realm string)
}

type Reconcilable interface {
	// GetConfig returns the live running config. Implementations MUST be safe for
	// concurrent use: the dataplane reads configs from request handlers while the
	// reconciler may be writing (use an atomic snapshot, see the concrete objects).
	GetConfig() stnrv2.Config
	// Inspect compares the live state (old), desired object config (new), and the full
	// desired StunnerConfig (full) and reports the object-local decision. Recursion into
	// children is handled by the reconciler walk, not Inspect.
	Inspect(old, new stnrv2.Config, full *stnrv2.StunnerConfig) (Action, error)
	// Reconcile applies a new config to the Object in place; a restart replaces the Object
	// instead.
	Reconcile(conf stnrv2.Config) error
	// Status returns the live status of the Object.
	Status() stnrv2.Status
}

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

type Runnable interface {
	Name() string
	Type() ObjectType
	// Start brings the node online.
	Start() error
	// Close shuts the node down. The shutdown flag distinguishes terminate (true) from
	// reconcile-driven restart (false).
	Close(shutdown bool) error
}

type Runtime struct {
	Config

	// Registry stores every live node in the dataplane.
	Registry *Registry
	// contains filtered or unexported fields
}