secretservice

type Registry interface {
	// Register registers a secret service implementation.
	// Returns an error if a secret service with the same name is already registered.
	Register(service SecretService) error
	// Get retrieves a secret service implementation by name.
	// Returns ErrSecretServiceNotFound if the secret service is not registered.
	Get(name string) (SecretService, error)
	// List returns all registered secret service names.
	List() []string
}

type SecretService interface {
	// Name returns the identifier of the secret service.
	Name() string

	// Description returns a human-readable description of the secret service.
	// Returns an empty string if not set.
	Description() string

	// HostsPatterns returns the list of regular expression patterns for matching hosts.
	// Returns nil if not set.
	HostsPatterns() []string

	// Path returns the optional path for the secret service.
	// Returns an empty string if not set.
	Path() string

	// EnvVars returns the optional list of environment variable names.
	// Returns nil if not set.
	EnvVars() []string

	// HeaderName returns the name of the HTTP header.
	HeaderName() string

	// HeaderTemplate returns the optional template for the header value.
	// The template uses ${value} for value insertion.
	// Returns an empty string if not set.
	HeaderTemplate() string
}