backup

type Class string

type Config struct {
	Target, CredentialsFile, DataDir, KeyPrefix string
	SingleWriter                                bool
	Retention                                   Retention
	Logger                                      *slog.Logger
}

type Entry struct {
	Generation uint64
	Timeline   string
	Class      Class
	Complete   bool
	At         time.Time
}

type GenRef struct {
	Timeline   string `json:"timeline"`
	Generation uint64 `json:"generation"`
}

type Keys struct {
	SecretsKey   string   `json:"secretsKey,omitempty"`
	MasterSecret string   `json:"masterSecret,omitempty"`
	Recipients   []string `json:"recipients,omitempty"`
}

type Manifest struct {
	Format     int    `json:"format"`
	Generation uint64 `json:"generation"`
	// At is when the cut began (ADR-0196's form).
	At    v1alpha1.Timestamp `json:"at"`
	Funcd string             `json:"funcd"`
	// Timeline and Revision split the metastore version the cut returned.
	Timeline string `json:"timeline"`
	Revision uint64 `json:"revision"`
	// Parent is the generation a restore loaded; nil when the timeline began at a first start.
	Parent *GenRef     `json:"parent,omitempty"`
	Stores []StoreFile `json:"stores"`
	Keys
}

type Opener func(recipients []string) (Unseal, error)

type Retention struct{ Hourly, Daily, Weekly, Verified int }

type Seal func(dst io.Writer) (io.WriteCloser, error)

type StoreFile struct {
	Name   string `json:"name"`
	Parts  int    `json:"parts"`
	Bytes  int64  `json:"bytes"`
	SHA256 string `json:"sha256"`
}

type Target interface {
	// Ready takes a directory's lock and probes the target (Decision 4); Write calls it first.
	Ready(ctx context.Context) error
	// Conditional reports, after Ready's nil, whether puts carry IfNotExist: false only when the target refused it
	// and singleWriter is set.
	Conditional() bool
	List(ctx context.Context) ([]Entry, error)
	// Write cuts the stores and writes one generation; a second writer is fault.Conflict.
	Write(ctx context.Context, events, meta, runs snapshot.Source, opts WriteOptions) (Manifest, error)
	// Close releases the lock and the bucket.
	Close() error
}

type Unseal func(src io.Reader) (io.Reader, error)

type WriteOptions struct {
	Seal   Seal
	Keys   Keys
	Parent *GenRef
	Pin    Class
}