endpoints

type ArgumentDeleter interface {
	// Delete deletes an argument (and all its versions) from the site.
	// If the argument didn't exist, the error will be a NotFoundError.
	Delete(ctx context.Context, id int64) error
}

type ArgumentGetterByVersion interface {
	// FetchVersion should return a particular version of an argument.
	// If the the argument didn't exist, the error should be an arguments.NotFoundError.
	FetchVersion(ctx context.Context, id int64, version int) (arguments.Argument, error)
}

type ArgumentGetterLiveVersion interface {
	// FetchLive should return the latest "active" version of an argument.
	// If no argument with this ID exists, the error should be an arguments.NotFoundError.
	FetchLive(ctx context.Context, id int64) (arguments.Argument, error)
}

type ArgumentSaver interface {
	// Save stores an argument and returns that argument's ID.
	// The ID on the input argument will be ignored.
	Save(ctx context.Context, argument arguments.Argument) (id int64, err error)
}

type ArgumentUpdater interface {
	// Update makes a new version of the argument. It returns the new argument's version.
	// If no argument with this ID exists, the returned error is an arguments.NotFoundError.
	Update(ctx context.Context, argument arguments.Argument) (version int, err error)
}

type ArgumentsGetter interface {
	// FetchSome finds the arguments which match the options.
	// If none exist, error will be nil and the slice empty.
	FetchSome(ctx context.Context, options arguments.FetchSomeOptions) ([]arguments.Argument, error)
}

type GetAllResponse struct {
	Arguments []arguments.Argument `json:"arguments"`
}

type GetOneResponse struct {
	Argument arguments.Argument `json:"argument"`
}

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

type Store interface {
	ArgumentDeleter
	ArgumentsGetter
	ArgumentGetterByVersion
	ArgumentGetterLiveVersion
	ArgumentSaver
	ArgumentUpdater
}