refactor: share string normalization helpers

Author: marandaneto

lib/Client.php

@@ -104,10 +104,10 @@ public function __construct(
         bool $loadFeatureFlags = true,
     ) {
         $this->apiKey = trim($apiKey);
-        $this->personalAPIKey = self::normalizeOptionalString($personalAPIKey);
+        $this->personalAPIKey = StringNormalizer::normalizeOptional($personalAPIKey);
         $this->options = $options;
         $this->debug = $options["debug"] ?? false;
-        $this->options['host'] = HostNormalizer::normalize($options['host'] ?? null);
+        $this->options['host'] = StringNormalizer::normalizeHost($options['host'] ?? null);
         if ($this->apiKey === '') {
             error_log('[PostHog][Client] apiKey is empty after trimming whitespace; check your project API key');
         }
@@ -147,16 +147,6 @@ public function __destruct()
         $this->consumer->__destruct();
     }
 
-    private static function normalizeOptionalString(?string $value): ?string
-    {
-        if ($value === null) {
-            return null;
-        }
-
-        $normalized = trim($value);
-        return $normalized === '' ? null : $normalized;
-    }
-
     /**
      * Captures a user action
      *

lib/HostNormalizer.php

@@ -42,7 +42,7 @@ public static function init(
 
             // Infer ssl from the host protocol if the user hasn't explicitly set it
             if ($rawHost !== null && !array_key_exists("ssl", $options)) {
-                $normalizedHost = HostNormalizer::normalize($rawHost);
+                $normalizedHost = StringNormalizer::normalizeHost($rawHost);
                 if (str_starts_with($normalizedHost, "http://")) {
                     $options["ssl"] = false;
                 } elseif (str_starts_with($normalizedHost, "https://")) {
@@ -374,7 +374,7 @@ public static function getClient(): Client
 
     private static function cleanHost(?string $host): string
     {
-        $host = HostNormalizer::normalize($host);
+        $host = StringNormalizer::normalizeHost($host);
 
         // remove protocol
         if (substr($host, 0, 8) === "https://") {

lib/PostHog.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace PostHog;
+
+class StringNormalizer
+{
+    public const DEFAULT_HOST = 'us.i.posthog.com';
+
+    public static function normalizeOptional(?string $value): ?string
+    {
+        if ($value === null) {
+            return null;
+        }
+
+        $normalized = trim($value);
+        return $normalized === '' ? null : $normalized;
+    }
+
+    public static function normalizeHost(?string $host): string
+    {
+        return self::normalizeOptional($host) ?? self::DEFAULT_HOST;
+    }
+}