feat: add ability to add checks with app ids

as per https://docs.github.com/en/rest/branches/branch-protection?apiVersion=2022-11-28#update-status-check-protection

Author: tginiotis-at-work

src/main/java/org/kohsuke/github/GHBranchProtection.java

@@ -221,6 +221,54 @@ public boolean isEnabled() {
         }
     }
 
+    /**
+     * The type Check.
+     */
+    public static class Check {
+        @JsonProperty
+        private String context;
+
+        @JsonProperty
+        private Integer app_id;
+
+        /**
+         * no-arg constructor for the serializer
+         */
+        public Check() {
+        }
+
+        /**
+         * Regular constructor for use in user business logic
+         *
+         * @param context
+         *            the context string of the check
+         * @param appId
+         *            the application ID the check is supposed to come from
+         */
+        public Check(String context, Integer appId) {
+            this.context = context;
+            this.app_id = appId;
+        }
+
+        /**
+         * The context string of the check
+         *
+         * @return the string
+         */
+        public String getContext() {
+            return context;
+        }
+
+        /**
+         * The application ID the check is supposed to come from. The value "-1" indicates "any source".
+         *
+         * @return the integer
+         */
+        public Integer getAppId() {
+            return app_id;
+        }
+    }
+
     /**
      * The type AllowForcePushes.
      */
@@ -462,6 +510,9 @@ public static class RequiredStatusChecks {
         @JsonProperty
         private Collection<String> contexts;
 
+        @JsonProperty
+        private Collection<Check> checks;
+
         @JsonProperty
         private boolean strict;
 
@@ -477,6 +528,15 @@ public Collection<String> getContexts() {
             return Collections.unmodifiableCollection(contexts);
         }
 
+        /**
+         * Gets checks.
+         *
+         * @return the checks
+         */
+        public Collection<Check> getChecks() {
+            return Collections.unmodifiableCollection(checks);
+        }
+
         /**
          * Gets url.
          *

src/main/java/org/kohsuke/github/GHBranchProtectionBuilder.java

@@ -50,8 +50,27 @@ public class GHBranchProtectionBuilder {
      *            the checks
      * @return the gh branch protection builder
      */
+    public GHBranchProtectionBuilder addRequiredChecksWithAppIds(Collection<GHBranchProtection.Check> checks) {
+        if (!(getStatusChecks() instanceof StatusChecksWithAppId)) {
+            statusChecks = new StatusChecksWithAppId();
+        }
+        ((StatusChecksWithAppId) getStatusChecks()).checks.addAll(checks);
+        return this;
+    }
+
+    /**
+     * Add required checks gh branch protection builder.
+     *
+     * @param checks
+     *            the checks
+     * @return the gh branch protection builder
+     */
+    @Deprecated
     public GHBranchProtectionBuilder addRequiredChecks(Collection<String> checks) {
-        getStatusChecks().contexts.addAll(checks);
+        if (!(getStatusChecks() instanceof StatusChecksDeprecated)) {
+            statusChecks = new StatusChecksDeprecated();
+        }
+        ((StatusChecksDeprecated) getStatusChecks()).contexts.addAll(checks);
         return this;
     }
 
@@ -62,11 +81,24 @@ public GHBranchProtectionBuilder addRequiredChecks(Collection<String> checks) {
      *            the checks
      * @return the gh branch protection builder
      */
+    @Deprecated
     public GHBranchProtectionBuilder addRequiredChecks(String... checks) {
         addRequiredChecks(Arrays.asList(checks));
         return this;
     }
 
+    /**
+     * Add required checks gh branch protection builder.
+     *
+     * @param checks
+     *            the checks
+     * @return the gh branch protection builder
+     */
+    public GHBranchProtectionBuilder addRequiredChecksWithAppIds(GHBranchProtection.Check... checks) {
+        addRequiredChecksWithAppIds(Arrays.asList(checks));
+        return this;
+    }
+
     /**
      * Allow deletion of the protected branch.
      *
@@ -532,7 +564,7 @@ private Restrictions getRestrictions() {
 
     private StatusChecks getStatusChecks() {
         if (statusChecks == null) {
-            statusChecks = new StatusChecks();
+            statusChecks = new StatusChecksWithAppId();
         }
         return statusChecks;
     }
@@ -546,8 +578,15 @@ private static class Restrictions {
         private Set<String> users = new HashSet<String>();
     }
 
-    private static class StatusChecks {
-        final List<String> contexts = new ArrayList<String>();
+    private static abstract class StatusChecks {
         boolean strict;
     }
+
+    private static class StatusChecksWithAppId extends StatusChecks {
+        final List<GHBranchProtection.Check> checks = new ArrayList<>();
+    }
+
+    private static class StatusChecksDeprecated extends StatusChecks {
+        final List<String> contexts = new ArrayList<>();
+    }
 }