- introduce branch (head ref) as data point in the PullRequestInfo object

- expand extractor to allow using the `branch` -> e.g. to extract the label

src/configuration.ts

@@ -40,11 +40,12 @@ export interface Transformer extends Regex {
 
 export interface Extractor extends Transformer {
   on_property?:
-    | ('title' | 'author' | 'milestone' | 'body')[]
+    | ('title' | 'author' | 'milestone' | 'body' | 'branch')[]
     | 'title'
     | 'author'
     | 'milestone'
     | 'body'
+    | 'branch'
     | undefined // retrieve the property to extract the value from
   method?: 'replace' | 'match' | undefined // the method to use to extract the value, `match` will not use the `target` property
   on_empty?: string | undefined // in case the regex results in an empty string, this value is gonna be used instead (only for label_extractor currently)

src/pullRequests.ts

@@ -9,6 +9,7 @@ export interface PullRequestInfo {
   title: string
   htmlURL: string
   baseBranch: string
+  branch?: string
   createdAt: moment.Moment
   mergedAt: moment.Moment | null
   mergeCommitSha: string
@@ -227,6 +228,7 @@ const mapPullRequest = (
   title: pr.title,
   htmlURL: pr.html_url,
   baseBranch: pr.base.ref,
+  branch: pr.head.ref,
   createdAt: moment(pr.created_at),
   mergedAt: pr.merged_at ? moment(pr.merged_at) : null,
   mergeCommitSha: pr.merge_commit_sha || '',

src/transform.ts

@@ -462,12 +462,18 @@ function extractValues(
 
   if (extractor.onProperty !== undefined) {
     let results: string[] = []
-    const list: ('title' | 'author' | 'milestone' | 'body' | 'status')[] =
-      extractor.onProperty
+    const list: (
+      | 'title'
+      | 'author'
+      | 'milestone'
+      | 'body'
+      | 'status'
+      | 'branch'
+    )[] = extractor.onProperty
     // eslint-disable-next-line @typescript-eslint/prefer-for-of
     for (let i = 0; i < list.length; i++) {
       const prop = list[i]
-      let value: string = pr[prop]
+      let value: string | undefined = pr[prop]
       if (value === undefined) {
         core.warning(
           `⚠️ the provided property '${extractor.onProperty}' for \`${extractor_usecase}\` is not valid`
@@ -514,7 +520,9 @@ function extractValuesFromString(
 export interface RegexTransformer {
   pattern: RegExp | null
   target: string
-  onProperty?: ('title' | 'author' | 'milestone' | 'body')[] | undefined
+  onProperty?:
+    | ('title' | 'author' | 'milestone' | 'body' | 'status' | 'branch')[]
+    | undefined
   method?: 'replace' | 'match' | undefined
   onEmpty?: string | undefined
 }