feat: pull request backporting

feat: backport still open pull requests

src/service/git/github/github-mapper.ts

@@ -0,0 +1,33 @@
+import { GitPullRequest } from "@bp/service/git/git.types";
+import { PullRequest, User } from "@octokit/webhooks-types";
+
+export default class GitHubMapper {
+
+  mapPullRequest(pr: PullRequest): GitPullRequest {
+    return {
+      number: pr.number,
+      author: pr.user.login,
+      url: pr.url,
+      htmlUrl: pr.html_url,
+      title: pr.title,
+      body: pr.body ?? "",
+      state: pr.state,
+      merged: pr.merged ?? false,
+      mergedBy: pr.merged_by?.login,
+      reviewers: pr.requested_reviewers.filter(r => "login" in r).map((r => (r as User)?.login)),
+      sourceRepo: {
+        owner: pr.head.repo.full_name.split("/")[0],
+        project: pr.head.repo.full_name.split("/")[1],
+        cloneUrl: pr.head.repo.clone_url
+      },
+      targetRepo: {
+        owner: pr.base.repo.full_name.split("/")[0],
+        project: pr.base.repo.full_name.split("/")[1],
+        cloneUrl: pr.base.repo.clone_url
+      },
+      nCommits: pr.commits,
+      // if pr is open use latest commit sha otherwise use merge_commit_sha
+      commits: pr.state === "open" ? [pr.head.sha] : [pr.merge_commit_sha as string]
+    };
+  }
+}

src/service/git/github/github-service.ts

@@ -0,0 +1,83 @@
+import GitService from "@bp/service/git/git-service";
+import { BackportPullRequest, GitPullRequest } from "@bp/service/git/git.types";
+import GitHubMapper from "@bp/service/git/github/github-mapper";
+import OctokitFactory from "@bp/service/git/github/octokit-factory";
+import LoggerService from "@bp/service/logger/logger-service";
+import LoggerServiceFactory from "@bp/service/logger/logger-service-factory";
+import { Octokit } from "@octokit/rest";
+import { PullRequest } from "@octokit/webhooks-types";
+
+export default class GitHubService implements GitService {
+  
+  private logger: LoggerService;
+  private octokit: Octokit;
+  private mapper: GitHubMapper;
+
+  constructor(token: string) {
+    this.logger = LoggerServiceFactory.getLogger();
+    this.octokit = OctokitFactory.getOctokit(token);
+    this.mapper = new GitHubMapper();
+  }
+
+  // READ
+
+  async getPullRequest(owner: string, repo: string, prNumber: number): Promise<GitPullRequest> {
+    this.logger.info(`Getting pull request ${owner}/${repo}/${prNumber}.`);
+    const { data } = await this.octokit.rest.pulls.get({
+      owner: owner,
+      repo: repo,
+      pull_number: prNumber
+    });
+
+    return this.mapper.mapPullRequest(data as PullRequest);
+  }
+
+  async getPullRequestFromUrl(prUrl: string): Promise<GitPullRequest> {
+    const {owner, project} = this.getRepositoryFromPrUrl(prUrl);
+    return this.getPullRequest(owner, project, parseInt(prUrl.substring(prUrl.lastIndexOf("/") + 1, prUrl.length)));
+  }
+
+  // WRITE
+  
+  async createPullRequest(backport: BackportPullRequest): Promise<void> {
+    this.logger.info(`Creating pull request ${backport.head} -> ${backport.base}.`);
+    this.logger.info(`${JSON.stringify(backport, null, 2)}`);
+
+    const { data } = await this.octokit.pulls.create({
+      owner: backport.owner,
+      repo: backport.repo,
+      head: backport.head,
+      base: backport.base,
+      title: backport.title,
+      body: backport.body
+    });
+
+    if (backport.reviewers.length > 0) {
+      try {
+        await this.octokit.pulls.requestReviewers({
+          owner: backport.owner,
+          repo: backport.repo,
+          pull_number: (data as PullRequest).number,
+          reviewers: backport.reviewers
+        });
+      } catch (error) {
+        this.logger.error(`Error requesting reviewers: ${error}`);
+      }
+    }
+  }
+
+  // UTILS
+
+  /**
+   * Extract repository owner and project from the pull request url
+   * @param prUrl pull request url
+   * @returns {{owner: string, project: string}}
+   */
+  private getRepositoryFromPrUrl(prUrl: string): {owner: string, project: string} {
+    const elems: string[] = prUrl.split("/");
+    return {
+      owner: elems[elems.length - 4],
+      project: elems[elems.length - 3]
+    };
+  } 
+}

src/service/git/github/octokit-factory.ts

@@ -0,0 +1,24 @@
+import LoggerService from "@bp/service/logger/logger-service";
+import LoggerServiceFactory from "@bp/service/logger/logger-service-factory";
+import { Octokit } from "@octokit/rest";
+
+/**
+ * Singleton factory class for {Octokit} instance
+ */
+export default class OctokitFactory {
+  
+  private static logger: LoggerService = LoggerServiceFactory.getLogger();
+  private static octokit?: Octokit;
+
+  public static getOctokit(token: string): Octokit {
+    if (!OctokitFactory.octokit) {
+      OctokitFactory.logger.info("Creating octokit instance.");
+      OctokitFactory.octokit = new Octokit({
+        auth: token,
+        userAgent: "lampajr/backporting"
+      });
+    }
+
+    return OctokitFactory.octokit;
+  }
+}