Documentation
¶
Overview ¶
Package domain defines provider-neutral value types shared across every storage backend (AWS SSM, AWS Secrets Manager, and future providers).
It has ZERO knowledge of any cloud SDK: no ARNs, no staging labels, no provider metadata bags. Types here carry only cross-provider essentials so that the usecase and CLI layers can be written once against a single shape.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Entry ¶
type Entry struct {
// Name is the entry's identifier within its provider namespace.
Name string
// Value is the entry's current value.
Value string
// Type classifies the value in a provider-neutral way.
Type ValueType
// Version identifies the retrieved version.
Version Version
// Description is an optional human-readable description.
Description string
// Tags are the labels attached to the entry.
Tags []Tag
// Modified is the last-modified time, if known.
Modified *time.Time
// Extra holds provider-populated, display-only metadata (e.g. an AWS
// Secrets Manager ARN). Its SHAPE is provider-neutral: a list of neutral
// Field values, never AWS types or an untyped any. Providers may leave it
// empty when they have no extra metadata to surface.
Extra []Field
}
Entry is a provider-neutral retrieved parameter/secret. It carries only cross-provider essentials: no ARN, no provider metadata bag.
type Field ¶
type Field struct {
// Label is the human-facing field name (e.g. "ARN").
Label string
// Value is the pre-formatted display value.
Value string
}
Field is a neutral, display-only piece of provider metadata surfaced on a read Entry (e.g. an AWS Secrets Manager ARN). It carries a human-facing Label and a pre-formatted string Value only: it is deliberately provider-neutral in SHAPE (no AWS types, no any) so the usecase/CLI layers can render it without knowing which provider produced it. Providers populate Entry.Extra; consumers display it verbatim and never interpret it.
type Tag ¶
type Tag struct{ Key, Value string }
Tag is a single key/value label attached to an entry.
type TagChange ¶
type TagChange struct {
// Add holds tags to create or update, keyed by tag key.
Add map[string]string
// Remove holds tag keys to delete.
Remove []string
}
TagChange describes staged tag mutations (add/update + remove-by-key).
type ValueType ¶
type ValueType string
ValueType classifies the nature of an entry's value in a provider-neutral way. Providers map their own native types onto these values.
const ( // ValueTypePlaintext is a plain, non-secret value (AWS String). ValueTypePlaintext ValueType = "plaintext" // AWS String, plain values // ValueTypeSecret is an encrypted/secret value (AWS SecureString, Secrets Manager). ValueTypeSecret ValueType = "secret" // AWS SecureString, Secrets Manager // ValueTypeList is a list of values (AWS StringList). ValueTypeList ValueType = "list" // AWS StringList )
type Version ¶
type Version struct {
// ID is the provider-internal version identifier.
ID string
// Label is an optional human-facing label (empty when unsupported).
Label string
// Created is the version creation time, if known.
Created *time.Time
}
Version identifies one version of an entry. Label is optional and may be empty for providers without human-facing version labels.
Source Files