container

type CacheProvider interface {
	Caches() (map[string]storage.Cache, error)
	Cache(name string) (storage.Cache, error)
	DefaultCache(globalDefaultName string) (storage.Cache, error)
	RegisterCache(name string, cache storage.Cache)
}

type ClientMiddlewareProvider interface {
	Names() []string
	ClientMiddlewares() (map[string]middleware.KMiddleware, error)
	ClientMiddleware(name string) (middleware.KMiddleware, error)
	RegisterClientMiddleware(name string, mw middleware.KMiddleware)
}

type ComponentFactory interface {
	// Priority determines the initialization order of the component.
	// Components with lower priority values are created and initialized first.
	Priority() int
	// NewComponent creates a new component instance.
	// It receives a component-specific configuration and the container instance,
	// allowing it to register other components or access other services.
	NewComponent(cfg interfaces.StructuredConfig, container Container, opts ...options.Option) (interfaces.Component, error)
}

type ComponentFunc func(cfg interfaces.StructuredConfig, container Container, opts ...options.Option) (interfaces.Component, error)

type Container interface {
	// Registry returns the service registry provider.
	Registry(opts ...options.Option) (RegistryProvider, error)
	// Middleware returns the middleware provider.
	Middleware(opts ...options.Option) (MiddlewareProvider, error)
	// Cache returns the cache provider.
	Cache(opts ...options.Option) (CacheProvider, error)
	// Database returns the database provider.
	Database(opts ...options.Option) (DatabaseProvider, error)
	// ObjectStore returns the object storage provider.
	ObjectStore(opts ...options.Option) (ObjectStoreProvider, error)

	// Component retrieves a generic component by its name, using a lazy-initialization strategy.
	// If the component is not yet created, the container will use its registered factory to create it.
	// The provided options are only used during the creation of the component.
	// This method is concurrency-safe.
	Component(name string, opts ...options.Option) (interfaces.Component, error)

	// RegisterComponent registers a pre-built component instance.
	RegisterComponent(name string, comp interfaces.Component)

	// RegisterFactory registers a factory for creating a component on demand.
	RegisterFactory(name string, factory ComponentFactory)

	// HasComponent checks if a component instance or factory has been registered.
	HasComponent(name string) bool

	// RegisteredComponents returns a slice of names for all registered components and factories.
	RegisteredComponents() []string

	// Logger returns the container's configured logger.
	Logger() runtimelog.Logger
	// AppInfo returns the application's metadata.
	AppInfo() interfaces.AppInfo

	// DefaultCache returns the default cache instance.
	DefaultCache() (storageiface.Cache, error)
	// DefaultDatabase returns the default database instance.
	DefaultDatabase() (storageiface.Database, error)
	// DefaultObjectStore returns the default object storage instance.
	DefaultObjectStore() (storageiface.ObjectStore, error)
	// DefaultRegistrar returns the default service registrar instance.
	DefaultRegistrar() (runtimeregistry.KRegistrar, error)
}

type DatabaseProvider interface {
	Databases() (map[string]storage.Database, error)
	Database(name string) (storage.Database, error)
	DefaultDatabase(globalDefaultName string) (storage.Database, error)
	RegisterDatabase(name string, db storage.Database)
}

type MiddlewareProvider interface {
	Names() []string
	ServerMiddlewareProvider
	ClientMiddlewareProvider
}

type ObjectStoreProvider interface {
	ObjectStores() (map[string]storage.ObjectStore, error)
	ObjectStore(name string) (storage.ObjectStore, error)
	DefaultObjectStore(globalDefaultName string) (storage.ObjectStore, error)
	RegisterObjectStore(name string, store storage.ObjectStore)
}

type RegistryProvider interface {
	Discoveries() (map[string]registry.KDiscovery, error)
	Discovery(name string) (registry.KDiscovery, error)
	Registrars() (map[string]registry.KRegistrar, error)
	Registrar(name string) (registry.KRegistrar, error)
	DefaultRegistrar(globalDefaultName string) (registry.KRegistrar, error)
	RegisterDiscovery(name string, discovery registry.KDiscovery)
	RegisterRegistrar(name string, registrar registry.KRegistrar)
}

type ServerMiddlewareProvider interface {
	Names() []string
	ServerMiddlewares() (map[string]middleware.KMiddleware, error)
	ServerMiddleware(name string) (middleware.KMiddleware, error)
	RegisterServerMiddleware(name string, mw middleware.KMiddleware)
}