[FEAT]: accept repository ids, names and permissions in getInstallationOctokit

[safareli]

Describe the need

getInstallationOctokit doesn't accept repository ids, names or permissions, while the rest api and createAppAuth from @octokit/auth-app both accept them.

Temporarily what I did was look into implementation of the getInstallationOctokit and created modified version of it that works for my needs. I'm happy to contribute with this changes if maintainers are ok with that.

async function getInstallationOctokitWithPermissions(
  app: OctokitApp,
  installationId: number,
  params: {
    repositoryIds?: number[];
    repositoryNames?: string[];
    // This type is not exhaustive there are more permissions this can accept see here:
    // https://docs.github.com/en/rest/apps/apps?apiVersion=2022-11-28#create-an-installation-access-token-for-an-app
    // type should be updated as we need more kinds of permissions
    permissions: {
      metadata?: "read";
      contents?: "read";
    };
  }
): ReturnType<OctokitApp["getInstallationOctokit"]> {
  return app.octokit.auth({
    type: "installation",
    installationId: installationId,
    factory(auth: any) {
      return new auth.octokit.constructor({
        ...auth.octokitOptions,
        authStrategy: AppAuth.createAppAuth,
        ...{
          auth: {
            ...auth,
            installationId: installationId,
            ...params,
          },
        },
      });
    },
  }) as ReturnType<OctokitApp["getInstallationOctokit"]>;
}

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