param

type CreateInput struct {
	Name        string
	Value       string
	Type        domain.ValueType
	Description string
	// Options carries provider-specific write options (e.g. AWS param Tier,
	// DataType). They are passed through to the provider unchanged.
	Options []provider.WriteOption
}

type CreateOutput struct {
	Name    string
	Version string // opaque version id; "" for an unversioned store
}

type CreateUseCase struct {
	Writer provider.Writer
	// ItemNoun names one item of the service in error messages ("parameter",
	// "setting"; capability.ServiceCapability.ItemNoun). Empty means "entry".
	ItemNoun string
}

type DeleteInput struct {
	Name string
}

type DeleteOutput struct {
	Name string
}

type DeleteUseCase struct {
	Store provider.Store
	// ItemNoun names one item of the service in error messages ("parameter",
	// "setting"; capability.ServiceCapability.ItemNoun). Empty means "entry".
	ItemNoun string
}

type DiffInput struct {
	Name1   string
	Suffix1 string
	Name2   string
	Suffix2 string
}

type DiffOutput struct {
	OldName    string
	OldVersion string // opaque version id
	OldValue   string
	NewName    string
	NewVersion string // opaque version id
	NewValue   string
	// Secret reports whether either version holds a secret value (e.g. an AWS
	// SecureString), so a consumer masks both sides before rendering the diff. A
	// secret-typed param is a secret on the value-type axis even though it lives
	// on the param service axis, so masking must key off this flag, not the
	// service (#677/#702).
	Secret bool
}

type DiffUseCase struct {
	Reader provider.Reader
}

type ListEntry struct {
	Name  string
	Value *string // nil when error or not requested
	// Type is the provider-neutral value type. It is only known when values are
	// fetched (WithValue); for name-only listings it stays the zero value.
	Type  domain.ValueType
	Error error
}

type ListInput struct {
	Prefix string
	// Recursive matches any depth under Prefix instead of immediate children
	// only (see MatchPrefix). Ignored with PlainPrefix.
	Recursive bool
	// PlainPrefix matches Prefix as a plain, case-sensitive string prefix, for
	// stores whose keys have no path hierarchy. Without it Prefix uses the
	// path-hierarchy semantics of MatchPrefix.
	PlainPrefix bool
	Filter      string // Regex filter pattern
	WithValue   bool   // Include parameter values
}

type ListNamespacesEntry struct {
	Namespace string
	Name      string
	Value     *string
}

type ListNamespacesInput struct {
	Prefix    string // Name prefix filter (case-sensitive)
	Filter    string // Regex filter pattern (client-side)
	WithValue bool   // Include values (App Config's list response already carries them)
}

type ListNamespacesOutput struct {
	Entries []ListNamespacesEntry
}

type ListNamespacesRow struct {
	Key       string
	Namespace string
	Value     string
}

type ListNamespacesUseCase struct {
	Lister NamespacesLister
}

type ListOutput struct {
	Entries []ListEntry
}

type ListUseCase struct {
	Reader provider.Reader
}

type LogEntry struct {
	Version      string // opaque version id
	Type         domain.ValueType
	Value        string
	LastModified *time.Time
	// IsCurrent reports whether the adapter marked this version as the current
	// one (domain.Version.Current).
	IsCurrent bool
	Error     error // Error from fetching value, if any
}

type LogInput struct {
	Name       string
	MaxResults int32
	Since      *time.Time
	Until      *time.Time
	Reverse    bool // Reverse chronological order
}

type LogOutput struct {
	Name    string
	Entries []LogEntry
	// InitialIncluded reports whether the oldest entry in Entries is the very
	// first version that ever existed. It is false when the window was cut by
	// --number or a date filter, so the oldest shown version is not a creation.
	InitialIncluded bool
}

type LogUseCase struct {
	Reader provider.Reader
}

type NamespacesLister interface {
	ListNamespaces(ctx context.Context) ([]ListNamespacesRow, error)
}

type ShowInput struct {
	Name string
	// Suffix is the version-spec suffix after the name ("#3", "~2", or "" for
	// the latest version), re-parsed by the adapter.
	Suffix string
}

type ShowOutput struct {
	Name         string
	Value        string
	Version      string // opaque version id
	Type         domain.ValueType
	Description  string
	LastModified *time.Time
	Tags         []ShowTag
}

type ShowTag struct {
	Key   string
	Value string
}

type ShowUseCase struct {
	Reader provider.Reader
}

type UpdateInput struct {
	Name        string
	Value       string
	Type        domain.ValueType
	Description string
	// PreserveType, when true, keeps the existing parameter's type instead of
	// applying Type, so a value-only update never downgrades an existing secret
	// or list value (e.g. an AWS SecureString losing its KMS encryption) to
	// plaintext. The AWS CLI sets it when no type flag is given; callers that
	// pass an explicit type (GUI, TUI) leave it false and Type is applied as-is.
	PreserveType bool
	// Options carries provider-specific write options (e.g. AWS param Tier,
	// DataType). They are passed through to the provider unchanged.
	Options []provider.WriteOption
}

type UpdateOutput struct {
	Name    string
	Version string // opaque version id; "" for an unversioned store
}

type UpdateUseCase struct {
	Store provider.Store
	// ItemNoun names one item of the service in error messages ("parameter",
	// "setting"; capability.ServiceCapability.ItemNoun). Empty means "entry".
	ItemNoun string
}