pagination

type Codec struct {
	Provider  KeyProvider
	ActiveKey string
	Keys      map[string][]byte
	TTL       time.Duration
	MaxBytes  int
	Now       func() time.Time
}

type Cursor struct {
	Version   int               `json:"v"`
	KeyID     string            `json:"kid"`
	Direction string            `json:"direction"`
	Keys      []json.RawMessage `json:"keys"`
	Query     string            `json:"query"`
	Filter    string            `json:"filter"`
	Expires   int64             `json:"exp,omitempty"`
}

type CursorMeta struct {
	Type        string `json:"type"`
	Limit       int    `json:"limit"`
	Total       *int64 `json:"total_records,omitempty"`
	Next        string `json:"next_cursor,omitempty"`
	Previous    string `json:"previous_cursor,omitempty"`
	HasNext     bool   `json:"has_next"`
	HasPrevious bool   `json:"has_previous"`
}

type CursorRequest struct {
	Cursor string
	Limit  int
}

type CursorResult[T any] struct {
	Data []T        `json:"data"`
	Meta CursorMeta `json:"meta"`
}

type KeyProvider interface {
	Active(context.Context) (string, []byte, error)
	Key(context.Context, string) ([]byte, error)
}

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

type KeyType string

type Offset struct {
	Page  int `json:"page"`
	Limit int `json:"page_size"`
}

type OffsetConfig struct{ DefaultLimit, MaxLimit, MaxOffset int }

type OffsetMeta struct {
	Type string `json:"type"`
	Offset
	Total       int64 `json:"total_records"`
	Pages       int64 `json:"total_pages"`
	HasNext     bool  `json:"has_next"`
	HasPrevious bool  `json:"has_previous"`
}

type Query struct {
	Dialect, Template, Identity, Filter string
	Args                                []any
	Columns                             map[string]string
	Sort                                []Sort
	KeyTypes                            []KeyType
}

type SQLPage struct {
	Where, OrderBy string
	Args           []any
	Reverse        bool
}

type SelectFunc func(context.Context, any, string, ...any) error

type Sort struct {
	Name                           string
	Descending, NullsFirst, Unique bool
}