feat: add User-Agent header with SDK version

- Add user_agent/0 function to dynamically retrieve SDK version from Application.spec
- Format: flagsmith-elixir-sdk/<version> or flagsmith-elixir-sdk/unknown as fallback
- Add user_agent_middleware/0 to inject User-Agent header in all HTTP requests
- Add comprehensive tests with semver validation using Version.parse/1
- Follows the pattern established in Go and Java Flagsmith SDKs

Co-authored-by: Claude Code <[email protected]>

Author: emyller

lib/flagsmith_client.ex

@@ -8,6 +8,15 @@ defmodule Flagsmith.Client do
   @type tesla_header_list :: [{String.t(), String.t()}]
   @type config_or_env :: Configuration.t() | Keyword.t() | Schemas.Environment.t()
 
+  @doc false
+  @spec user_agent() :: String.t()
+  def user_agent do
+    case Application.spec(:flagsmith_engine, :vsn) do
+      nil -> "flagsmith-elixir-sdk/unknown"
+      vsn -> "flagsmith-elixir-sdk/#{vsn}"
+    end
+  end
+
   @doc """
   Create a `t:Flagsmith.Configuration.t/0` struct with the desired settings to use
   in requests.
@@ -31,6 +40,7 @@ defmodule Flagsmith.Client do
     Tesla.client([
       base_url_middleware(api_url),
       auth_middleware(environment_key),
+      user_agent_middleware(),
       Tesla.Middleware.JSON,
       {Tesla.Middleware.Retry, max_retries: retries},
       {Tesla.Middleware.Headers, custom_headers},
@@ -394,6 +404,12 @@ defmodule Flagsmith.Client do
   def auth_middleware(environment_key),
     do: {Tesla.Middleware.Headers, auth_header(environment_key)}
 
+  @doc false
+  @spec user_agent_middleware() ::
+          {Tesla.Middleware.Headers, tesla_header_list()}
+  def user_agent_middleware(),
+    do: {Tesla.Middleware.Headers, [{"user-agent", user_agent()}]}
+
   @doc false
   @spec base_url_middleware(base_url :: String.t()) ::
           {Tesla.Middleware.BaseUrl, String.t()}

test/flagsmith_client_test.exs

@@ -437,4 +437,35 @@ defmodule Flagsmith.Client.Test do
                Flagsmith.Client.get_flag(new_config, "some_flag")
     end
   end
+
+  describe "User-Agent header" do
+    test "user_agent/0 returns valid semver version" do
+      user_agent = Flagsmith.Client.user_agent()
+      version_part = String.replace_prefix(user_agent, "flagsmith-elixir-sdk/", "")
+
+      assert {:ok, parsed} = Version.parse(version_part)
+      assert is_integer(parsed.major) and parsed.major >= 0
+      assert is_integer(parsed.minor) and parsed.minor >= 0
+      assert is_integer(parsed.patch) and parsed.patch >= 0
+    end
+
+    test "HTTP client includes User-Agent header with valid semver", %{config: config} do
+      expect(Tesla.Adapter.Mock, :call, fn tesla_env, _options ->
+        user_agent_header =
+          Enum.find(tesla_env.headers, fn {header, _} ->
+            header == "user-agent"
+          end)
+
+        assert user_agent_header != nil
+        {_header, user_agent_value} = user_agent_header
+
+        version_part = String.replace_prefix(user_agent_value, "flagsmith-elixir-sdk/", "")
+        assert {:ok, _} = Version.parse(version_part)
+
+        {:ok, %Tesla.Env{status: 200, body: Test.Generators.map_env()}}
+      end)
+
+      Flagsmith.Client.get_environment(config)
+    end
+  end
 end