marks

type Annotation struct {
	Key   string `json:"k"`
	Value string `json:"v"`
}

type ChunkingConfig struct {
	CD  *Chunking_CDConfig `json:"cd,omitempty"`
	Max *Chunking_Fixed    `json:"fixed,omitempty"`
}

type Chunking_CDConfig struct {
	MeanSize int `json:"mean_size"`
	MaxSize  int `json:"max_size"`
}

type Chunking_Fixed struct {
	Max uint32 `json:"max"`
	Min uint32 `json:"min"`
}

type DSConfig struct {
	// Salt is a 32-byte salt used to derive the cryptographic keys for the mark.
	Salt Salt `json:"salt"`
	// GotFS contains all configuration for GotFS
	GotFS FSConfig `json:"fs"`
}

type ErrInvalidName struct {
	Name   string
	Reason string
}

type FSConfig struct {
	Data     ChunkingConfig    `json:"data_chunking"`
	Metadata Chunking_CDConfig `json:"metadata_chunking"`
}

type FSMach = gotfs.Machine

type Info struct {
	// Config holds the all the datastructure parameters
	Config DSConfig `json:"config"`
	// Annotations are arbitrary metadata associated with the mark.
	Annotations []Annotation `json:"annotations"`

	// CreatedAt is the time the mark was created.
	CreatedAt tai64.TAI64 `json:"created_at"`
}

type Mark struct {
	Volume Volume
	Info   Info
	// contains filtered or unexported fields
}

type MemSpace struct {
	// contains filtered or unexported fields
}

type Metadata struct {
	Config      DSConfig     `json:"config"`
	Annotations []Annotation `json:"annotations"`
}

type ModifyCtx struct {
	VC    *VCMach
	FS    *FSMach
	Store stores.RW
	Root  *Snap
}

type Payload struct {
	Root gotfs.Root
	Aux  []byte
}

type Salt [32]byte

type Snap = gotvc.Snapshot[Payload]

type SnapInfo struct {
	AuthoredAt tai64.TAI64  `json:"authored_at"`
	Authors    []inet256.ID `json:"authors"`

	Message string `json:"message"`
}

type Space interface {
	Create(ctx context.Context, name string, cfg Metadata) (*Info, error)
	Inspect(ctx context.Context, name string) (*Info, error)
	Set(ctx context.Context, name string, cfg Metadata) error
	Delete(ctx context.Context, name string) error
	List(ctx context.Context, span Span, limit int) ([]string, error)

	// Open returns a volume for viewing and modifying the mark contents.
	Open(ctx context.Context, name string) (*Mark, error)
}

type Span struct {
	Begin string
	End   string
}

type SyncSpacesTask struct {
	// Src is the space to read from.
	Src Space
	// Dst is the name ofthe space to write to.
	Dst Space

	// Filter is applied to src to determine what to copy.
	// If nil, then all marks are copied.
	Filter func(string) bool
	// MapName is applied to go from names in the Src space, to name in the Dst space.
	MapName func(string) string
}

type Tx = volumes.Tx

type TxParams = volumes.TxParams

type VCMach = gotvc.Machine[Payload]

type Volume = volumes.Volume