Versions in this module Expand all Collapse all v0 v0.2.0 Aug 14, 2026 Changes in this version + const MaxPageItems + const MaxPageTokenLength + const MaxReferenceLength + const MaxReferencePathLength + const MaxReferenceSchemeLen + const MaxSecretSize + const MaxVersionLength + var ErrCanceled = errors.New("secrets: operation canceled") + var ErrConflict = errors.New("secrets: version conflict") + var ErrCorruptRecord = errors.New("secrets: corrupt record") + var ErrEmptySecret = errors.New("secrets: empty secret") + var ErrInsecurePath = errors.New("secrets: insecure path") + var ErrInvalidNamespace = errors.New("secrets: invalid namespace") + var ErrInvalidOptions = errors.New("secrets: invalid options") + var ErrInvalidPageToken = errors.New("secrets: invalid page token") + var ErrInvalidReference = errors.New("secrets: invalid reference") + var ErrInvalidVersion = errors.New("secrets: invalid version") + var ErrNotFound = errors.New("secrets: secret not found") + var ErrSecretTooLarge = errors.New("secrets: secret value too large") + var ErrUnavailable = errors.New("secrets: backend unavailable") + var ErrUnsupportedCapability = errors.New("secrets: unsupported capability") + var ErrUnsupportedScheme = errors.New("secrets: unsupported scheme") + var ErrZeroSecret = errors.New("secrets: zero secret") + var VersionUnsupported = Version + func IsVisibleCommit(err error) bool + type CanceledError struct + func NewCanceledError(operation string, cause error) *CanceledError + func (e *CanceledError) Error() string + func (e *CanceledError) Format(state fmt.State, verb rune) + func (e *CanceledError) GoString() string + func (e *CanceledError) Is(target error) bool + func (e *CanceledError) LogValue() slog.Value + type ConflictError struct + func NewConflictError(reference Reference) *ConflictError + func (e *ConflictError) Error() string + func (e *ConflictError) Format(state fmt.State, verb rune) + func (e *ConflictError) GoString() string + func (e *ConflictError) LogValue() slog.Value + func (e *ConflictError) Reference() Reference + func (e *ConflictError) Unwrap() error + type CorruptRecordError struct + func NewCorruptRecordError(reference Reference) *CorruptRecordError + func (e *CorruptRecordError) Error() string + func (e *CorruptRecordError) Format(state fmt.State, verb rune) + func (e *CorruptRecordError) GoString() string + func (e *CorruptRecordError) LogValue() slog.Value + func (e *CorruptRecordError) Reference() Reference + func (e *CorruptRecordError) Unwrap() error + type DeleteOptions struct + ExpectedVersion Version + Precondition Precondition + func CompareAndSwapDelete(version Version) DeleteOptions + func UnconditionalDelete() DeleteOptions + func (o DeleteOptions) Validate() error + type DeleteResult struct + Reference Reference + Status DeleteStatus + Version Version + func NewDeleteResult(reference Reference, status DeleteStatus, version Version) (DeleteResult, error) + func (r DeleteResult) Validate() error + type DeleteStatus uint8 + const DeleteStatusAbsent + const DeleteStatusDeleted + func (s DeleteStatus) String() string + type EmptySecretError struct + func (e *EmptySecretError) Error() string + func (e *EmptySecretError) Format(state fmt.State, verb rune) + func (e *EmptySecretError) GoString() string + func (e *EmptySecretError) LogValue() slog.Value + func (e *EmptySecretError) Unwrap() error + type InsecurePathError struct + func NewInsecurePathError(reason string) *InsecurePathError + func (e *InsecurePathError) Error() string + func (e *InsecurePathError) Format(state fmt.State, verb rune) + func (e *InsecurePathError) GoString() string + func (e *InsecurePathError) LogValue() slog.Value + func (e *InsecurePathError) Reason() string + func (e *InsecurePathError) Unwrap() error + type InvalidNamespaceError struct + func NewInvalidNamespaceError(reason string) *InvalidNamespaceError + func (e *InvalidNamespaceError) Error() string + func (e *InvalidNamespaceError) Format(state fmt.State, verb rune) + func (e *InvalidNamespaceError) GoString() string + func (e *InvalidNamespaceError) LogValue() slog.Value + func (e *InvalidNamespaceError) Reason() string + func (e *InvalidNamespaceError) Unwrap() error + type InvalidOptionsError struct + func NewInvalidOptionsError(reason string) *InvalidOptionsError + func (e *InvalidOptionsError) Error() string + func (e *InvalidOptionsError) Format(state fmt.State, verb rune) + func (e *InvalidOptionsError) GoString() string + func (e *InvalidOptionsError) LogValue() slog.Value + func (e *InvalidOptionsError) Reason() string + func (e *InvalidOptionsError) Unwrap() error + type InvalidPageTokenError struct + func NewInvalidPageTokenError(reason string) *InvalidPageTokenError + func (e *InvalidPageTokenError) Error() string + func (e *InvalidPageTokenError) Format(state fmt.State, verb rune) + func (e *InvalidPageTokenError) GoString() string + func (e *InvalidPageTokenError) LogValue() slog.Value + func (e *InvalidPageTokenError) Reason() string + func (e *InvalidPageTokenError) Unwrap() error + type InvalidReferenceError struct + func NewInvalidReferenceError(reason string) *InvalidReferenceError + func (e *InvalidReferenceError) Error() string + func (e *InvalidReferenceError) Format(state fmt.State, verb rune) + func (e *InvalidReferenceError) GoString() string + func (e *InvalidReferenceError) LogValue() slog.Value + func (e *InvalidReferenceError) Reason() string + func (e *InvalidReferenceError) Unwrap() error + type InvalidVersionError struct + func NewInvalidVersionError(reason string) *InvalidVersionError + func (e *InvalidVersionError) Error() string + func (e *InvalidVersionError) Format(state fmt.State, verb rune) + func (e *InvalidVersionError) GoString() string + func (e *InvalidVersionError) LogValue() slog.Value + func (e *InvalidVersionError) Reason() string + func (e *InvalidVersionError) Unwrap() error + type Lister interface + List func(context.Context, Namespace, PageToken, int) (Page[Metadata], error) + type Metadata struct + Reference Reference + UpdatedAt time.Time + Version Version + func (m Metadata) Validate() error + type Namespace struct + func NewNamespace(scheme, prefix string) (Namespace, error) + func ParseNamespace(raw string) (Namespace, error) + func (n Namespace) Canonical() string + func (n Namespace) Contains(ref Reference) bool + func (n Namespace) IsZero() bool + func (n Namespace) Path() string + func (n Namespace) Prefix() string + func (n Namespace) Scheme() string + func (n Namespace) String() string + type NotFoundError struct + func NewNotFoundError(reference Reference) *NotFoundError + func (e *NotFoundError) Error() string + func (e *NotFoundError) Format(state fmt.State, verb rune) + func (e *NotFoundError) GoString() string + func (e *NotFoundError) LogValue() slog.Value + func (e *NotFoundError) Reference() Reference + func (e *NotFoundError) Unwrap() error + type Page struct + Items []T + NextToken PageToken + func NewPage[T any](items []T, next PageToken) (Page[T], error) + func (p Page[T]) Validate(limit int) error + type PageToken struct + func NewPageToken(token string) (PageToken, error) + func (p *PageToken) UnmarshalText(text []byte) error + func (p PageToken) IsZero() bool + func (p PageToken) MarshalText() ([]byte, error) + func (p PageToken) String() string + func (p PageToken) Valid() bool + type Precondition uint8 + const PreconditionCompareAndSwap + const PreconditionCreateOnly + const PreconditionUnconditional + type PreconditionCapabilities interface + SupportsCompareAndSwap func() bool + SupportsCreateOnly func() bool + type PutOptions struct + ExpectedVersion Version + Precondition Precondition + func CompareAndSwapPut(version Version) PutOptions + func CreateOnlyPut() PutOptions + func UnconditionalPut() PutOptions + func (o PutOptions) Validate() error + type Record struct + Reference Reference + UpdatedAt time.Time + Value Secret + Version Version + func (r Record) Metadata() Metadata + func (r Record) Validate() error + type Reference struct + func NewReference(scheme, path string) (Reference, error) + func ParseReference(raw string) (Reference, error) + func (r *Reference) UnmarshalText(text []byte) error + func (r Reference) Canonical() string + func (r Reference) IsZero() bool + func (r Reference) MarshalText() ([]byte, error) + func (r Reference) Path() string + func (r Reference) Scheme() string + func (r Reference) String() string + type Resolver interface + Resolve func(context.Context, Reference) (Record, error) + type Secret struct + func New(value []byte) (Secret, error) + func (s Secret) Bytes() []byte + func (s Secret) Format(state fmt.State, verb rune) + func (s Secret) GoString() string + func (s Secret) IsZero() bool + func (s Secret) LogValue() slog.Value + func (s Secret) String() string + func (s Secret) Valid() bool + func (s Secret) Validate() error + type SecretSizeError struct + Got int + Limit int + func (e *SecretSizeError) Error() string + func (e *SecretSizeError) Format(state fmt.State, verb rune) + func (e *SecretSizeError) GoString() string + func (e *SecretSizeError) LogValue() slog.Value + func (e *SecretSizeError) Unwrap() error + type Store interface + Delete func(context.Context, Reference, DeleteOptions) (DeleteResult, error) + Put func(context.Context, Reference, Secret, PutOptions) (Record, error) + type UnavailableError struct + func NewUnavailableError(operation string, reference Reference) *UnavailableError + func (e *UnavailableError) Error() string + func (e *UnavailableError) Format(state fmt.State, verb rune) + func (e *UnavailableError) GoString() string + func (e *UnavailableError) Is(target error) bool + func (e *UnavailableError) LogValue() slog.Value + func (e *UnavailableError) Reference() Reference + type UnsupportedCapabilityError struct + func NewUnsupportedCapabilityError() *UnsupportedCapabilityError + func (e *UnsupportedCapabilityError) Error() string + func (e *UnsupportedCapabilityError) Format(state fmt.State, verb rune) + func (e *UnsupportedCapabilityError) GoString() string + func (e *UnsupportedCapabilityError) LogValue() slog.Value + func (e *UnsupportedCapabilityError) Unwrap() error + type UnsupportedSchemeError struct + func NewUnsupportedSchemeError() *UnsupportedSchemeError + func (e *UnsupportedSchemeError) Error() string + func (e *UnsupportedSchemeError) Format(state fmt.State, verb rune) + func (e *UnsupportedSchemeError) GoString() string + func (e *UnsupportedSchemeError) LogValue() slog.Value + func (e *UnsupportedSchemeError) Unwrap() error + type Version struct + func NewVersion(value string) (Version, error) + func (v *Version) UnmarshalText(text []byte) error + func (v Version) IsUnsupported() bool + func (v Version) IsZero() bool + func (v Version) MarshalText() ([]byte, error) + func (v Version) String() string + func (v Version) Valid() bool + type VersionMismatchError = ConflictError + type VisibleCommitError interface + Visible func() bool + type ZeroSecretError struct + func (e *ZeroSecretError) Error() string + func (e *ZeroSecretError) Format(state fmt.State, verb rune) + func (e *ZeroSecretError) GoString() string + func (e *ZeroSecretError) LogValue() slog.Value + func (e *ZeroSecretError) Unwrap() error v0.1.0 Aug 10, 2026