feat(library): allow accessing base_ref in Kotlin-based steps (#1948)

Closes #1946

Author: krzema12

github-workflows-kt/api/github-workflows-kt.api

@@ -619,16 +619,18 @@ public final class io/github/typesafegithub/workflows/domain/contexts/Contexts {
 
 public final class io/github/typesafegithub/workflows/domain/contexts/GithubContext {
 	public static final field Companion Lio/github/typesafegithub/workflows/domain/contexts/GithubContext$Companion;
-	public fun <init> (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Lio/github/typesafegithub/workflows/domain/contexts/GithubContextEvent;Ljava/lang/String;)V
-	public synthetic fun <init> (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Lio/github/typesafegithub/workflows/domain/contexts/GithubContextEvent;Ljava/lang/String;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
+	public fun <init> (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Lio/github/typesafegithub/workflows/domain/contexts/GithubContextEvent;Ljava/lang/String;)V
+	public synthetic fun <init> (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Lio/github/typesafegithub/workflows/domain/contexts/GithubContextEvent;Ljava/lang/String;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
 	public final fun component1 ()Ljava/lang/String;
 	public final fun component2 ()Ljava/lang/String;
 	public final fun component3 ()Ljava/lang/String;
-	public final fun component4 ()Lio/github/typesafegithub/workflows/domain/contexts/GithubContextEvent;
-	public final fun component5 ()Ljava/lang/String;
-	public final fun copy (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Lio/github/typesafegithub/workflows/domain/contexts/GithubContextEvent;Ljava/lang/String;)Lio/github/typesafegithub/workflows/domain/contexts/GithubContext;
-	public static synthetic fun copy$default (Lio/github/typesafegithub/workflows/domain/contexts/GithubContext;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Lio/github/typesafegithub/workflows/domain/contexts/GithubContextEvent;Ljava/lang/String;ILjava/lang/Object;)Lio/github/typesafegithub/workflows/domain/contexts/GithubContext;
+	public final fun component4 ()Ljava/lang/String;
+	public final fun component5 ()Lio/github/typesafegithub/workflows/domain/contexts/GithubContextEvent;
+	public final fun component6 ()Ljava/lang/String;
+	public final fun copy (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Lio/github/typesafegithub/workflows/domain/contexts/GithubContextEvent;Ljava/lang/String;)Lio/github/typesafegithub/workflows/domain/contexts/GithubContext;
+	public static synthetic fun copy$default (Lio/github/typesafegithub/workflows/domain/contexts/GithubContext;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Lio/github/typesafegithub/workflows/domain/contexts/GithubContextEvent;Ljava/lang/String;ILjava/lang/Object;)Lio/github/typesafegithub/workflows/domain/contexts/GithubContext;
 	public fun equals (Ljava/lang/Object;)Z
+	public final fun getBase_ref ()Ljava/lang/String;
 	public final fun getEvent ()Lio/github/typesafegithub/workflows/domain/contexts/GithubContextEvent;
 	public final fun getEvent_name ()Ljava/lang/String;
 	public final fun getRef ()Ljava/lang/String;

github-workflows-kt/src/main/kotlin/io/github/typesafegithub/workflows/domain/contexts/GithubContext.kt

@@ -9,6 +9,7 @@ public data class GithubContext(
     val repository: String,
     val sha: String,
     val ref: String? = null,
+    val base_ref: String? = null,
     val event: GithubContextEvent,
     val event_name: String,
 )

github-workflows-kt/src/test/kotlin/io/github/typesafegithub/workflows/yaml/ContextMappingTest.kt

@@ -28,6 +28,7 @@ class ContextMappingTest :
                             repository = "some-owner/some-repo",
                             sha = "db76dd0f1149901e1cdf60ec98d568b32fa7eb71",
                             ref = "refs/heads/main",
+                            base_ref = "refs/heads/develop",
                             event =
                                 GithubContextEvent(
                                     after = "1383af4847629428f1675f5c2e81e67cc3a4efb0",

github-workflows-kt/src/test/resources/contexts/github-all-fields.json

@@ -2,6 +2,7 @@
   "repository": "some-owner/some-repo",
   "sha": "db76dd0f1149901e1cdf60ec98d568b32fa7eb71",
   "ref": "refs/heads/main",
+  "base_ref": "refs/heads/develop",
   "event": {
     "after": "1383af4847629428f1675f5c2e81e67cc3a4efb0"
   },