hiddenpathdb

type HiddenPathDB interface {
	ReadWrite
	BeginTransaction(ctx context.Context, opts *sql.TxOptions) (Transaction, error)
	io.Closer
}

type Params struct {
	GroupIds hiddenpath.GroupIdSet
	EndsAt   addr.IA
}

type Read interface {
	// Get returns all path segment(s) matching the parameters specified.
	Get(context.Context, *Params) (query.Results, error)
}

type ReadWrite interface {
	Read
	Write
}

type Transaction interface {
	ReadWrite
	Commit() error
	Rollback() error
}

type Write interface {
	// Insert inserts or updates a hidden path segment. It returns the number of path segments
	// that have been inserted/updated.
	Insert(context.Context, *seg.Meta, hiddenpath.GroupIdSet) (pathdb.InsertStats, error)
	// Delete deletes all path segments that match the given query,
	// returning the number of deleted segments
	Delete(context.Context, *Params) (int, error)
	// DeleteExpired deletes all hidden path segments that are expired, using now as a reference.
	// Returns the number of deleted segments.
	DeleteExpired(context.Context, time.Time) (int, error)
}