[Nitro CLI] Add GraphQL-Client-Id header to CLI requests

src/Nitro/CommandLine/src/CommandLine/Directory.Build.targets

@@ -9,6 +9,7 @@
 
       <_NitroIdentityClientId>$(NitroIdentityClientId)</_NitroIdentityClientId>
       <_NitroIdentityScopes>$(NitroIdentityScopes)</_NitroIdentityScopes>
+      <_NitroApiClientId>$(NitroApiClientId)</_NitroApiClientId>
     </PropertyGroup>
 
     <MakeDir Directories="$(_GenDir)" />
@@ -23,6 +24,7 @@ namespace $(_SecretsNamespace)
     {
         internal const string NitroIdentityClientId = &quot;$(_NitroIdentityClientId)&quot;;
         internal const string NitroIdentityScopes = &quot;$(_NitroIdentityScopes)&quot;;
+        internal const string NitroApiClientId = &quot;$(_NitroApiClientId)&quot;;
     }
 }
 ))" />

src/Nitro/CommandLine/src/CommandLine/Services/NitroClientContext.cs

@@ -16,6 +16,8 @@ public Uri Url
 
     public INitroClientAuthorization? Authorization { get; private set; }
 
+    public string? ClientId => BuildSecrets.NitroApiClientId;
+
     public void Configure(string? apiUrl, INitroClientAuthorization? authorization)
     {
         if (string.IsNullOrWhiteSpace(apiUrl))

src/Nitro/CommandLine/test/CommandLine.Tests/GlobalOptionsTests.cs

@@ -67,6 +67,57 @@ public async Task ExecuteAsync_Should_PreferApiKey_Over_SessionToken()
         Assert.False(client.DefaultRequestHeaders.Contains("Authorization"));
     }
 
+    [Fact]
+    public async Task ExecuteAsync_Should_ConfigureApiKeyAuth_When_EnvApiKeySet()
+    {
+        // arrange
+        var envProvider = CreateEnvironmentProvider(apiKey: "env-key");
+
+        // act
+        await using var provider = await BuildAndExecuteAsync([], environmentVariables: envProvider);
+        using var client = CreateApiClient(provider);
+
+        // assert
+        var apiKeyHeader = Assert.Single(client.DefaultRequestHeaders.GetValues("CCC-api-key"));
+        Assert.Equal("env-key", apiKeyHeader);
+        Assert.False(client.DefaultRequestHeaders.Contains("Authorization"));
+    }
+
+    [Fact]
+    public async Task ExecuteAsync_Should_PreferEnvApiKey_Over_SessionToken()
+    {
+        // arrange
+        var session = CreateSessionWithTokens(accessToken: "session-token");
+        var envProvider = CreateEnvironmentProvider(apiKey: "env-key");
+
+        // act
+        await using var provider = await BuildAndExecuteAsync(
+            [], session, environmentVariables: envProvider);
+        using var client = CreateApiClient(provider);
+
+        // assert
+        var apiKeyHeader = Assert.Single(client.DefaultRequestHeaders.GetValues("CCC-api-key"));
+        Assert.Equal("env-key", apiKeyHeader);
+        Assert.False(client.DefaultRequestHeaders.Contains("Authorization"));
+    }
+
+    [Fact]
+    public async Task ExecuteAsync_Should_PreferExplicitApiKey_Over_EnvApiKey()
+    {
+        // arrange
+        var envProvider = CreateEnvironmentProvider(apiKey: "env-key");
+
+        // act
+        await using var provider = await BuildAndExecuteAsync(
+            ["--api-key", "cli-key"], environmentVariables: envProvider);
+        using var client = CreateApiClient(provider);
+
+        // assert
+        var apiKeyHeader = Assert.Single(client.DefaultRequestHeaders.GetValues("CCC-api-key"));
+        Assert.Equal("cli-key", apiKeyHeader);
+        Assert.False(client.DefaultRequestHeaders.Contains("Authorization"));
+    }
+
     [Theory]
     [InlineData("custom.host.com", "https://custom.host.com/graphql")]
     [InlineData("https://custom.host.com", "https://custom.host.com/graphql")]
@@ -239,6 +290,13 @@ private static HttpClient CreateApiClient(ServiceProvider provider)
         return factory.CreateClient(ApiClient.ClientName);
     }
 
+    private static IEnvironmentVariableProvider CreateEnvironmentProvider(string? apiKey = null)
+    {
+        var mock = new Mock<IEnvironmentVariableProvider>();
+        mock.Setup(x => x.GetEnvironmentVariable("NITRO_API_KEY")).Returns(apiKey);
+        return mock.Object;
+    }
+
     private static Session CreateSessionWithTokens(
         string apiUrl = "api.chillicream.com",
         string accessToken = "test-access-token")

src/Nitro/Common/src/ChilliCream.Nitro.Client/Extensions/NitroClientServiceCollectionExtensions.cs

@@ -195,6 +195,12 @@ private static void ConfigureApiHttpClient(IServiceProvider sp, HttpClient clien
         var provider = sp.GetRequiredService<INitroClientContextProvider>();
         client.BaseAddress = provider.Url;
 
+        if (!string.IsNullOrWhiteSpace(provider.ClientId))
+        {
+            client.DefaultRequestHeaders.Remove(NitroClientHeaders.GraphQLClientId);
+            client.DefaultRequestHeaders.Add(NitroClientHeaders.GraphQLClientId, provider.ClientId);
+        }
+
         switch (provider.Authorization)
         {
             case NitroClientApiKeyAuthorization apiKey:

src/Nitro/Common/src/ChilliCream.Nitro.Client/INitroClientContextProvider.cs

@@ -5,4 +5,6 @@ public interface INitroClientContextProvider
     Uri Url { get; }
 
     INitroClientAuthorization? Authorization { get; }
+
+    string? ClientId { get; }
 }

src/Nitro/Common/src/ChilliCream.Nitro.Client/NitroClientHeaders.cs

@@ -2,6 +2,7 @@ namespace ChilliCream.Nitro.Client;
 
 public static class NitroClientHeaders
 {
+    public const string GraphQLClientId = "GraphQL-Client-Id";
     public const string GraphQLClientVersion = "GraphQL-Client-Version";
     public const string GraphQLPreflight = "GraphQL-Preflight";
     public const string CccAgent = "ccc-agent";