Add seam for customizing GitHubBuilder's prior to instantiating GitHub clients

Author: ryandens

runtime/src/main/java/io/quarkiverse/githubapp/GitHubCustomizer.java

@@ -0,0 +1,23 @@
+package io.quarkiverse.githubapp;
+
+import org.kohsuke.github.GitHubBuilder;
+
+import io.quarkiverse.githubapp.runtime.config.CheckedConfigProvider;
+
+/**
+ * Seam for customizing the {@link GitHubBuilder} used to create the {@link org.kohsuke.github.GitHub} instance.
+ */
+public interface GitHubCustomizer {
+
+    /**
+     * Customize the {@link GitHubBuilder} with various options for runtime.
+     * <p>
+     * Note that customizations that use {@link GitHubBuilder#withAppInstallationToken(String)} and
+     * {@link GitHubBuilder#withEndpoint(String)} are eventually overridden by the
+     * {@link io.quarkiverse.githubapp.runtime.github.GitHubService}. Installation tokens are created and cached by the service.
+     * To specify a custom endpoint, prefer the {@link CheckedConfigProvider#restApiEndpoint()}
+     *
+     * @param builder to customize
+     */
+    void customize(GitHubBuilder builder);
+}

runtime/src/main/java/io/quarkiverse/githubapp/runtime/github/GitHubService.java

@@ -9,6 +9,7 @@
 import java.util.concurrent.TimeUnit;
 
 import jakarta.enterprise.context.ApplicationScoped;
+import jakarta.enterprise.inject.Instance;
 import jakarta.inject.Inject;
 
 import org.kohsuke.github.GHAppInstallationToken;
@@ -23,6 +24,7 @@
 import com.github.benmanes.caffeine.cache.LoadingCache;
 
 import io.quarkiverse.githubapp.GitHubClientProvider;
+import io.quarkiverse.githubapp.GitHubCustomizer;
 import io.quarkiverse.githubapp.runtime.config.CheckedConfigProvider;
 import io.quarkiverse.githubapp.runtime.signing.JwtTokenCreator;
 import io.smallrye.graphql.client.dynamic.api.DynamicGraphQLClient;
@@ -40,9 +42,13 @@ public class GitHubService implements GitHubClientProvider {
 
     private final JwtTokenCreator jwtTokenCreator;
     private final GitHubConnector gitHubConnector;
+    private final GitHubCustomizer githubCustomizer;
 
     @Inject
-    public GitHubService(CheckedConfigProvider checkedConfigProvider, JwtTokenCreator jwtTokenCreator) {
+    public GitHubService(
+            CheckedConfigProvider checkedConfigProvider,
+            JwtTokenCreator jwtTokenCreator,
+            Instance<GitHubCustomizer> gitHubCustomizer) {
         this.checkedConfigProvider = checkedConfigProvider;
         this.jwtTokenCreator = jwtTokenCreator;
         this.installationTokenCache = Caffeine.newBuilder()
@@ -74,6 +80,9 @@ public long expireAfterRead(Long installationId, CachedInstallationToken cachedI
                 .build(new CreateInstallationToken());
         this.gitHubConnector = new HttpClientGitHubConnector(
                 HttpClient.newBuilder().version(Version.HTTP_1_1).followRedirects(HttpClient.Redirect.NEVER).build());
+        // if the customizer is not resolvable, we use a no-op customizer
+        githubCustomizer = gitHubCustomizer.isResolvable() ? gitHubCustomizer.get() : builder -> {
+        };
     }
 
     @Override
@@ -126,7 +135,11 @@ private GitHub createInstallationClient(long installationId) throws IOException
         CachedInstallationToken installationToken = installationTokenCache.get(installationId);
 
         final GitHubBuilder gitHubBuilder = new GitHubBuilder()
-                .withConnector(gitHubConnector)
+                .withConnector(gitHubConnector);
+        // apply customizations
+        githubCustomizer.customize(gitHubBuilder);
+        // configure mandatory defaults
+        gitHubBuilder
                 .withAppInstallationToken(installationToken.getToken())
                 .withEndpoint(checkedConfigProvider.restApiEndpoint());
 
@@ -194,7 +207,11 @@ private GitHub createApplicationGitHub() {
 
         try {
             final GitHubBuilder gitHubBuilder = new GitHubBuilder()
-                    .withConnector(gitHubConnector)
+                    .withConnector(gitHubConnector);
+            // apply customizations
+            githubCustomizer.customize(gitHubBuilder);
+            // configure mandatory defaults
+            gitHubBuilder
                     .withJwtToken(jwtToken)
                     .withEndpoint(checkedConfigProvider.restApiEndpoint());