branching

type Branch interface {
	// DB returns the branch's database handle.
	DB() dal.DB
	// Close closes the branch. Close must be idempotent.
	Close(context.Context) error
}

type Capability struct {
	Provider string
	Version  string
	Mode     string
}

type Checkpoint interface {
	// Generation returns the checkpoint generation.
	Generation() string
	// Branch returns a fresh branch created from this checkpoint.
	Branch(context.Context) (Branch, error)
	// Release releases this checkpoint. Release must be idempotent.
	Release(context.Context) error
}

type Provider interface {
	// Capability returns this provider's stable metadata.
	Capability() Capability
	// Capture captures immutable state from the source database.
	Capture(context.Context, dal.DB) (Checkpoint, error)
}

type UnsupportedError struct {
	Provider string
	Mode     string
	Reason   string
}