client build v1.2.3

vbilopav · vbilopav · commit b5fd4bb41319 · 2024-05-30T11:24:31.000+02:00
diff --git a/NpgsqlRest.sln b/NpgsqlRest.sln
@@ -14,6 +14,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution
 		annotations.md = annotations.md
 		.github\workflows\build-test-publish.yml = .github\workflows\build-test-publish.yml
 		changelog.md = changelog.md
+		client.md = client.md
 		LICENSE = LICENSE
 		options.md = options.md
 		README.md = README.md
diff --git a/NpgsqlRestClient/Builder.cs b/NpgsqlRestClient/Builder.cs
@@ -1,4 +1,5 @@
-﻿using Microsoft.AspNetCore.Authentication.BearerToken;
+﻿using System.Data.Common;
+using Microsoft.AspNetCore.Authentication.BearerToken;
 using Microsoft.AspNetCore.Authentication.Cookies;
 using Microsoft.Extensions.Primitives;
 using Microsoft.Net.Http.Headers;
@@ -268,13 +269,30 @@ public static void BuildCors()
         return connectionString;
     }
 
+    private static string? _instanceId = null;
+
+    public static string InstanceId
+    {
+        get
+        {
+            _instanceId ??= Convert.ToBase64String(Guid.NewGuid().ToByteArray());
+            return _instanceId;
+        }
+    }
+
     public static Dictionary<string, StringValues> GetCustomHeaders()
     {
         var result = new Dictionary<string, StringValues>();
         foreach(var section in NpgsqlRestCfg.GetSection("CustomRequestHeaders").GetChildren())
         {
             result.Add(section.Key, section.Value);
         }
+
+        var instIdName = GetConfigStr("InstanceIdRequestHeaderName", NpgsqlRestCfg);
+        if (string.IsNullOrEmpty(instIdName) is false)
+        {
+            result.Add(instIdName, InstanceId);
+        }
         return result;
     }
 }
diff --git a/NpgsqlRestClient/NpgsqlRestClient.csproj b/NpgsqlRestClient/NpgsqlRestClient.csproj
@@ -7,7 +7,7 @@
     <InvariantGlobalization>true</InvariantGlobalization>
     <NoDefaultLaunchSettingsFile>true</NoDefaultLaunchSettingsFile>
     <PublishAot>true</PublishAot>
-    <Version>1.2.2</Version>
+    <Version>1.2.3</Version>
   </PropertyGroup>
 
   <ItemGroup>
diff --git a/NpgsqlRestClient/appsettings.json b/NpgsqlRestClient/appsettings.json
@@ -371,6 +371,10 @@
             "57014": 205
         },
         //
+        // Add the unique NpgsqlRest instance id request header with this name to the response or set to null to ignore.
+        //
+        "InstanceIdRequestHeaderName": null,
+        //
         // https://vb-consulting.github.io/npgsqlrest/options/#customrequestheaders
         //
         "CustomRequestHeaders": { 
diff --git a/README.md b/README.md
@@ -1,6 +1,6 @@
 # NpgsqlRest
 
-![build-test-publish](https://github.com/vb-consulting/NpgsqlRest/workflows/build-test-publish/badge.svg)
+[![build-test-publish](https://github.com/vb-consulting/NpgsqlRest/actions/workflows/build-test-publish.yml/badge.svg)](https://github.com/vb-consulting/NpgsqlRest/actions/workflows/build-test-publish.yml)
 ![License](https://img.shields.io/badge/license-MIT-green)
 ![GitHub Stars](https://img.shields.io/github/stars/vb-consulting/NpgsqlRest?style=social)
 ![GitHub Forks](https://img.shields.io/github/forks/vb-consulting/NpgsqlRest?style=social)
diff --git a/client.md b/client.md
@@ -78,6 +78,30 @@ Example:                               npgsqlrest appsettings.json -o appsetting
 
 ## Changelog
 
+### Version 1.2.3
+
+New setting `NpgsqlRest.InstanceIdRequestHeaderName`:
+
+```jsonc
+{
+    //
+    //...
+    //
+    "NpgsqlRest": {
+        "InstanceIdRequestHeaderName": "X-Instance-Id"
+    }
+    //
+    //...
+    //
+}
+```
+
+The `NpgsqlRest.InstanceIdRequestHeaderName` setting allows you to specify the header name that will be used to identify the instance of the application. Header value will be used as the unique running instance ID.
+
+This is useful when you have multiple instances of the application running behind a load balancer, and you want to identify which instance is handling the request.
+
+Default is `null` (not used).
+
 ### Version 1.2.2
 
 New setting `NpgsqlRest.AuthenticationOptions.CustomParameterNameToClaimMappings`:
