contract

type CliModule interface {
	Module
	RegisterCliCommands(kernelInstance kernelcontract.Kernel) []clicontract.Command
}

type ConfigModule interface {
	Module
	RegisterConfigurations(registrar ConfigRegistrar)
}

type ConfigRegistrar interface {
	RegisterConfiguration(name string, configuration any)
}

type EventModule interface {
	Module
	RegisterEventSubscribers(kernelInstance kernelcontract.Kernel)
}

type HttpHandlerDecorator func(next nethttp.Handler) nethttp.Handler

type HttpHandlerDecoratorModule interface {
	Module
	RegisterHttpHandlerDecorators(kernelInstance kernelcontract.Kernel) []HttpHandlerDecorator
}

type HttpMiddlewareModule interface {
	Module
	RegisterHttpMiddlewares(kernelInstance kernelcontract.Kernel, registrar HttpMiddlewareRegistrar)
}

type HttpMiddlewareRegistrar interface {
	Use(middlewares ...httpcontract.Middleware)

	UseWithPriority(priority int, middlewares ...httpcontract.Middleware)
}

type HttpModule interface {
	Module
	RegisterHttpRoutes(kernelInstance kernelcontract.Kernel)
}

type Module interface {
	Name() string

	Description() string
}

type ModuleProvider interface {
	Modules() []Module
}

type ParameterModule interface {
	Module
	RegisterParameters(registrar ParameterRegistrar)
}

type ParameterRegistrar interface {
	RegisterParameter(name string, value any)

	/* RegisterSecretParameter declares a parameter holding a credential, so the commands that render the configuration redact it and every parameter whose template reads it. */
	RegisterSecretParameter(name string, value any)

	/* MarkParameterSecret marks a parameter that already exists, which is how the credentials melody registers automatically from the .env artifacts are covered. */
	MarkParameterSecret(name string)
}

type ServiceModule interface {
	Module
	RegisterServices(registrar ServiceRegistrar)
}

type ServiceRegistrar interface {
	containercontract.Registrar

	RegisterService(
		serviceName string,
		provider any,
		options ...containercontract.RegisterOption,
	)
}