feat: add server URL normalization hook

Normalize server URLs by prepending https:// when no scheme is present
and stripping trailing slashes, ensuring consistent base URL formatting
across SDK configurations.

Author: chris-freeman-glean

src/main/java/com/glean/api_client/glean_api_client/hooks/SDKHooks.java

@@ -13,6 +13,8 @@ private SDKHooks() {
     }
 
     public static void initialize(com.glean.api_client.glean_api_client.utils.Hooks hooks) {
+        hooks.registerSdkInit(ServerURLNormalizerHook.createSyncHook());
+
         hooks.registerAfterError(AgentFileUploadErrorHook.createSyncHook());
 
         // Register the X-Glean header hook for experimental features and deprecation testing

src/main/java/com/glean/api_client/glean_api_client/hooks/ServerURLNormalizerHook.java

@@ -0,0 +1,27 @@
+package com.glean.api_client.glean_api_client.hooks;
+
+import com.glean.api_client.glean_api_client.utils.Hook;
+
+import java.util.regex.Pattern;
+
+public final class ServerURLNormalizerHook {
+
+    private static final Pattern SCHEME_PATTERN = Pattern.compile("(?i)^https?://");
+
+    private ServerURLNormalizerHook() {
+        // prevent instantiation
+    }
+
+    static String normalize(String url) {
+        String normalized = url;
+        if (!SCHEME_PATTERN.matcher(normalized).find()) {
+            normalized = "https://" + normalized;
+        }
+        normalized = normalized.replaceAll("/+$", "");
+        return normalized;
+    }
+
+    public static Hook.SdkInit createSyncHook() {
+        return data -> new Hook.SdkInitData(normalize(data.baseUrl()), data.client());
+    }
+}

src/test/java/com/glean/api_client/glean_api_client/hooks/ServerURLNormalizerHookTest.java

@@ -0,0 +1,40 @@
+package com.glean.api_client.glean_api_client.hooks;
+
+import com.glean.api_client.glean_api_client.utils.Hook;
+
+import org.junit.jupiter.params.ParameterizedTest;
+import org.junit.jupiter.params.provider.CsvSource;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+class ServerURLNormalizerHookTest {
+
+    @ParameterizedTest
+    @CsvSource({
+        "example.glean.com,             https://example.glean.com",
+        "https://example.glean.com,     https://example.glean.com",
+        "http://localhost:8080,          http://localhost:8080",
+        "https://example.glean.com///,  https://example.glean.com",
+        "https://example.glean.com/api/v1, https://example.glean.com/api/v1",
+        "example.glean.com/,            https://example.glean.com",
+        "HTTP://EXAMPLE.COM,            HTTP://EXAMPLE.COM",
+        "HTTPS://EXAMPLE.COM,           HTTPS://EXAMPLE.COM",
+    })
+    void normalize(String input, String expected) {
+        assertEquals(expected, ServerURLNormalizerHook.normalize(input));
+    }
+
+    @ParameterizedTest
+    @CsvSource({
+        "example.glean.com,             https://example.glean.com",
+        "https://example.glean.com///,  https://example.glean.com",
+        "http://localhost:8080,          http://localhost:8080",
+    })
+    void createSyncHook(String input, String expected) {
+        Hook.SdkInit hook = ServerURLNormalizerHook.createSyncHook();
+        Hook.SdkInitData data = new Hook.SdkInitData(input, null);
+        Hook.SdkInitData result = hook.sdkInit(data);
+        assertEquals(expected, result.baseUrl());
+        assertNull(result.client());
+    }
+}