pagination

package

v1.8.1 Latest Latest Go to latest Published: Oct 20, 2026 License: Apache-2.0 Imports: 7 Imported by: 0

Details

Package pagination implements stable created-time and TypeID continuation.

This section is empty.

This section is empty.

func Encode(entity ctrlplane.Entity) string

Encode returns an opaque continuation for an entity.

func Page[T any](items []T, cursor string, limit int, key func(T) ctrlplane.Entity) ([]T, string, int, error)

Page sorts an already scoped collection and applies continuation without requiring the anchor to still exist.

func Trim[T any](items []T, limit int, key func(T) ctrlplane.Entity) ([]T, string)

Trim removes the lookahead row and reports continuation only when more rows exist.

type Position struct {
	CreatedAt time.Time `json:"created_at"`
	ID        id.ID     `json:"id"`
}

Position is the last returned entity in descending creation order.

func Decode(cursor string) (Position, error)

Decode validates a cursor. An empty cursor starts at the newest entity.