Function paginateBoxPostings

internal/cmd/box.go:237–266

paginateBoxPostings follows next_history_url links to collect additional postings beyond the first page. When neither all nor a limit exceeding the first page is requested, it returns the first page only (preserving default behavior).

(ctx context.Context, firstPage *generated.BoxShowResponse, limit int, all bool, fetch pageFetcher)

// beyond the first page. When neither all nor a limit exceeding the first page is
// requested, it returns the first page only (preserving default behavior).
func paginateBoxPostings(ctx context.Context, firstPage *generated.BoxShowResponse, limit int, all bool, fetch pageFetcher) ([]generated.Posting, string, error) {
	postings := firstPage.Postings
	nextURL := firstPage.NextHistoryUrl

	needMore := all || (limit > 0 && len(postings) < limit)
	if !needMore || nextURL == "" {
		return postings, nextURL, nil
	}
	if fetch == nil {
		return nil, "", fmt.Errorf("paginateBoxPostings: fetch function is nil while pagination is required")
	}

	for page := 1; page <= maxAdditionalPages && nextURL != ""; page++ {
		resp, err := fetch(ctx, nextURL)
		if err != nil {
			return nil, "", err
		}
		nextURL = resp.NextHistoryUrl
		if len(resp.Postings) == 0 {
			break
		}
		postings = append(postings, resp.Postings...)

		if !all && limit > 0 && len(postings) >= limit {
			break
		}
	}

	return postings, nextURL, nil
}

// boxTruncationNotice returns a user-facing notice about truncated or paginated results.
func boxTruncationNotice(shown, fetched int, hasMore, all bool) string {