types

type PagedResult ¶

type PagedResult[T any] struct {
	Items         []T     `json:"items"`
	PageSize      int32   `json:"pageSize"`
	TotalCount    int64   `json:"totalCount"`
	NextPageToken *string `json:"nextPageToken"`
}

type PagedResultRequest ¶

type PagedResultRequest struct {
	PageSize      int32   `json:"pageSize"`
	NextPageToken *string `json:"nextPageToken"`
	Page          *int32  `json:"page"`
}

PagedResultRequest carries pagination parameters for a list query.

It supports two mutually exclusive modes:

• Cursor (default): leave Page nil and pass NextPageToken. Forward-only, TotalCount is not computed. Works with any backend.
• Offset: set Page (1-based) for arbitrary page jumps. NextPageToken is ignored and TotalCount is populated. Only offset-capable backends (SQL via gormx) honor it; others reject an offset request.