app

type ServiceProvider interface {
	// Register binds services into the container. Called before any Boot method.
	Register(s *Services) error

	// Boot is called after all providers have been registered.
	// Use this to resolve cross-provider dependencies.
	Boot(s *Services) error

	// Shutdown gracefully tears down provider resources.
	// Called in reverse registration order.
	Shutdown(ctx context.Context) error
}

type Services struct {
	DB         *orm.Manager
	Log        log.Logger
	Cache      *cache.Manager
	Crypto     crypto.Encryptor
	Events     events.Dispatcher
	Queue      queue.Driver
	Storage    *storage.Manager
	Scheduler  *scheduler.Scheduler
	Mail       mail.Mailer
	Exceptions *exceptions.Handler
	Validator  validation.Validator

	// These use `any` to break import cycles (auth/csrf/view import router).
	// Use typed accessors on velocity.App or router.Context.
	Auth any // *auth.Manager
	CSRF any // *csrf.CSRF
	View any // *view.Engine
}