Skip to content

Expose calendar recording pagination - #125

Merged
robzolkos merged 1 commit into
mainfrom
fix-calendar-recordings-pagination
Aug 25, 2026
Merged

Expose calendar recording pagination#125
robzolkos merged 1 commit into
mainfrom
fix-calendar-recordings-pagination

Conversation

@robzolkos

@robzolkos robzolkos commented Aug 25, 2026

Copy link
Copy Markdown
Collaborator

Calendar recording windows are geared-paginated, but the SDK discarded their Link cursor. This adds the cursor-bearing page API needed for callers to enumerate complete windows, including recurring series whose original start falls after the first page.

API surface

  • Adds the optional page query parameter to GetCalendarRecordingsParams.
  • Adds CalendarRecordingsPage and Calendars().GetRecordingsPage.
  • Keeps Calendars().GetRecordings source-compatible and returning the requested page as before.
  • Bumps the Go SDK version to 0.25.0.

Proof

  • Unit coverage verifies the requested cursor is sent and the next cursor is extracted from the response Link header.
  • Conformance coverage verifies the date window and opaque page cursor on the generated request.
  • make check passes: Go tests and lint are green, generated artifacts are current, and all 165 conformance cases pass.

Risk and reviewer focus

Risk is low: the generated parameter and wrapper are additive, and existing GetRecordings callers retain one-page behavior. Please focus on the page wrapper contract and preservation of the existing method.

Consumer

basecamp/hey-cli#332 follows complete event, to-do, and journal windows with this page API. The original bug report was supplied out-of-band, so there is no durable issue link.

Copilot AI balanced review requested due to automatic review settings August 25, 2026 20:20

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds cursor-aware pagination for calendar recordings while preserving the existing single-page API.

Changes:

  • Adds the page query parameter and regenerates the Go client.
  • Introduces GetRecordingsPage with NextPage.
  • Adds unit and conformance coverage; bumps SDK to 0.25.0.

Tip

If you aren't ready for review, convert to a draft PR.
Click "Convert to draft" or run gh pr ready --undo.
Click "Ready for review" or run gh pr ready to reengage.

Reviewed changes

Copilot reviewed 7 out of 8 changed files in this pull request and generated no comments.

Show a summary per file
File Description
spec/hey.smithy Models the optional page cursor.
openapi.json Reflects the generated query parameter.
go/pkg/generated/client.gen.go Serializes the page cursor.
go/pkg/hey/calendars.go Adds the cursor-bearing page API.
go/pkg/hey/services_test.go Tests cursor submission and extraction.
conformance/tests/pagination.json Covers pagination request parameters.
conformance/runner/go/main.go Supplies calendar query parameters.
go/pkg/hey/version.go Bumps the SDK to 0.25.0.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@robzolkos
robzolkos merged commit 99c698d into main Aug 25, 2026
19 checks passed
@robzolkos
robzolkos deleted the fix-calendar-recordings-pagination branch August 25, 2026 21:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants