Changed StringExt.cs HmacSha256 to public from internal

Author: ddjerqq

src/Klean.EntityFrameworkCore.DataProtection/Extensions/StringExt.cs

@@ -1,20 +1,30 @@
 using System.Security.Cryptography;
 using System.Text;
 
-namespace EntityFrameworkCore.DataProtection.Extensions;
+// ReSharper disable once CheckNamespace
+namespace System;
 
 /// <summary>
 /// Provides extensions for the <see cref="string"/> type.
 /// </summary>
-internal static class StringExt
+public static class StringExt
 {
-    internal const string EnvKey = "EFCORE_DATA_PROTECTION__HASHING_SALT";
+    /// <summary>
+    /// The environment variable key for the hashing salt. `EFCORE_DATA_PROTECTION__HASHING_SALT`
+    /// </summary>
+    public const string HashingSaltKey = "EFCORE_DATA_PROTECTION__HASHING_SALT";
 
-    internal static string HmacSha256Hash(this string value)
+    /// <summary>
+    /// Hashes the string using HMACSHA256
+    /// </summary>
+    /// <param name="value">The value to hash</param>
+    /// <returns>Hashed value as hex lowercase</returns>
+    /// <exception cref="InvalidOperationException">If `EFCORE_DATA_PROTECTION__HASHING_SALT` is not present in the environment</exception>
+    public static string HmacSha256Hash(this string value)
     {
         var salt =
-            Environment.GetEnvironmentVariable(EnvKey)
-            ?? throw new InvalidOperationException($"{EnvKey} is not present in the environment, please set it to a strong value and keep it safe, otherwise querying will not work.");
+            Environment.GetEnvironmentVariable(HashingSaltKey)
+            ?? throw new InvalidOperationException($"{HashingSaltKey} is not present in the environment, please set it to a strong value and keep it safe, otherwise querying will not work.");
 
         var saltBytes = Encoding.UTF8.GetBytes(salt);
         var payloadBytes = Encoding.UTF8.GetBytes(value);

src/Klean.EntityFrameworkCore.DataProtection/Klean.EntityFrameworkCore.DataProtection.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
     <PropertyGroup>
-        <Version>1.2.0</Version>
+        <Version>1.2.1</Version>
         <TargetFrameworks>net6.0;net7.0;net8.0;net9.0</TargetFrameworks>
         <ImplicitUsings>enable</ImplicitUsings>
         <Nullable>enable</Nullable>

test/Klean.EntityFrameworkCore.DataProtection.Test/DbContext.Test.cs

@@ -10,8 +10,8 @@ internal sealed class DbContextTests
     [OneTimeSetUp]
     public void InitializeEnv()
     {
-        var value = Environment.GetEnvironmentVariable(StringExt.EnvKey);
-        Environment.SetEnvironmentVariable(StringExt.EnvKey, value ?? Guid.NewGuid().ToString());
+        var value = Environment.GetEnvironmentVariable(StringExt.HashingSaltKey);
+        Environment.SetEnvironmentVariable(StringExt.HashingSaltKey, value ?? Guid.NewGuid().ToString());
     }
 
     [Test]

test/Klean.EntityFrameworkCore.DataProtection.Test/StringExt.Test.cs

@@ -8,8 +8,8 @@ internal sealed class StringExtTests
     [OneTimeSetUp]
     public void InitializeEnv()
     {
-        var value = Environment.GetEnvironmentVariable(StringExt.EnvKey);
-        Environment.SetEnvironmentVariable(StringExt.EnvKey, value ?? Guid.NewGuid().ToString());
+        var value = Environment.GetEnvironmentVariable(StringExt.HashingSaltKey);
+        Environment.SetEnvironmentVariable(StringExt.HashingSaltKey, value ?? Guid.NewGuid().ToString());
     }
 
     [Test]