octokit.pulls.listRequestedReviewers should not support pagination

[nikclayton-dfinity]

Checklist

• I checked all open bugs and none of them matched my problem.

Environment

• https://api.github.com

Versions

├── @octokit/webhooks@7.21.0

and:

├── @actions/github@4.0.0
├── @actions/core@1.2.6

What happened?

The GitHub documentation notes that listRequestedReviewers can be paginated.

I don't think it can -- the response object contains users and teams properties that are arrays that contain all the requested user and team reviewers within a single response, there's no pagination that needs to happen.

So if you write this:

const reviewers = octokit.paginate(octokit.pulls.listRequestedReviewers
  {...context.repo, pull_number})

then reviewers is actually a single element array, but the Tyepscript type inference system thinks it's an object.

So then you go and write:

for (const user of reviewers.users) {
    // ...
}

and you it compiles OK, but you get an error at runtime because the users property is not defined on the response, it's actually reviewers[0].users, but if you write reviewers[0].users in the code you get type errors.

What you actually need to write is:

const {data: reviewers} = await octokit.pulls.listRequestedReviewers(
  {...context.repo, pull_number})

i.e., remove the call to paginate and destructure the response.

I don't think there's much Octokit can do here in the code, but the documentation (i.e., https://octokit.github.io/rest.js/v18#pulls-list-requested-reviewers) could be updated to reference this and note that octokit.paginate should not be used with this API call.

[gr2m]

Thank you for reporting this problem! I created an issue with the docs team to find out if the endpoint does indeed not support any pagination. See github/docs#2433

[gr2m]

It seems like it was filed internally, but the problem still seem to persist. I asked about the current status at github/docs#2433

[gr2m]

@nikclayton-dfinity just a quick update: an internal issue has been back in January but remains open as of today