pagination

type Envelope[T any] struct {
	PageInfo PageInfo `json:"pageInfo" yaml:"pageInfo"`
	Items    []T      `json:"items"    yaml:"items"`
}

type Fetcher[T any] func(ctx context.Context, limit, offset int) (*Page[T], error)

type Options struct {
	// Limit is the total number of items to return. Ignored when All is true.
	Limit int
	// Offset is the starting offset into the result set.
	Offset int
	// All iterates until the server reports no more results.
	All bool
}

type Page[T any] struct {
	Count    int
	Next     *string
	Previous *string
	Results  []T
}

type PageInfo struct {
	Count    int     `json:"count"              yaml:"count"`
	HasMore  bool    `json:"hasMore"            yaml:"hasMore"`
	Next     *string `json:"next,omitempty"     yaml:"next,omitempty"`
	Previous *string `json:"previous,omitempty" yaml:"previous,omitempty"`
}