Class GitHubFetch

src/github/github_fetch.mjs:76–452

 * - basic rate-limit backoff (single retry with bounded sleep)
 */
export class GitHubFetch {
  /**
   * @param {object} opts
   * @param {string} opts.repo - "owner/name"
   * @param {string} [opts.cacheDir] - defaults to ".cache/pr-sheriff/github"
   * @param {number} [opts.cacheTtlSeconds] - defaults to 300 seconds
   * @param {(args: string[], runnerOpts?: any) => Promise<{exitCode:number, stdout:string, stderr:string, timedOut?:boolean}>} [opts.ghRunner]
   * @param {(ms:number) => Promise<void>} [opts.sleepFn]
   * @param {number} [opts.maxBackoffSeconds] - max sleep for rate-limit backoff
   */
  constructor({
    repo,
    cacheDir = path.join('.cache', 'pr-sheriff', 'github'),
    cacheTtlSeconds = 300,
    ghRunner = defaultGhRunner,
    sleepFn = (ms) => new Promise((r) => setTimeout(r, ms)),
    maxBackoffSeconds = 10,
  }) {
    const { owner, name } = parseOwnerRepo(repo);
    this.repo = repo;
    this.owner = owner;
    this.name = name;

    this.cacheDir = cacheDir;
    this.cacheTtlSeconds = cacheTtlSeconds;
    this.ghRunner = ghRunner;
    this.sleepFn = sleepFn;
    this.maxBackoffSeconds = maxBackoffSeconds;
  }

  /**
   * Fetch pull request details.
   */
  async getPR(number, { useCache = true } = {}) {
    return await this.#restRequest({
      method: 'GET',
      endpoint: `/repos/${this.owner}/${this.name}/pulls/${number}`,
      useCache,
    });
  }

  /**
   * Fetch issue details.
   */
  async getIssue(number, { useCache = true } = {}) {
    return await this.#restRequest({
      method: 'GET',
      endpoint: `/repos/${this.owner}/${this.name}/issues/${number}`,
      useCache,
    });
  }

  /**
   * List all comments on a PR: issue comments + PR review (inline) comments.
   *
   * @returns {Promise<{issueComments:any[], reviewComments:any[], all:any[]}>}
   */
  async listPRComments(number, { useCache = true } = {}) {