[FEAT]: Discriminate types based on media type

[wolfy1339]

Describe the need

Currently when specifying a media type format in the request options, the types always return the response for application/json

It would be nice if the returned types could be discriminated with the specified media type

SDK Version

No response

API Version

No response

Relevant log output

No response

Code of Conduct

• I agree to follow this project's Code of Conduct

[wolfy1339]

Here is an example snippet demonstrating the issue:

/** @type {import('@octokit/types').OctokitResponse<import('@octokit/openapi-types').components["schemas"]["content-tree"]>} */
// @ts-ignore Overriding the type of the response for the correct type with the `object` media type
const { data } = await octokit.request(
    'GET /repos/{owner}/{repo}/contents/{path}',
    {
      owner,
      repo,
      path: PATH,
      mediaType: {
        format: 'object'
      }
    }
);