feat: added uuid4 pseudonym generator (#62)

src/Vfps.Benchmarks/PseudonymGeneratorBenchmarks.cs

@@ -9,12 +9,16 @@ public class PseudonymGeneratorBenchmarks
 {
     private readonly CryptoRandomBase64UrlEncodedGenerator crbase64Generator = new();
     private readonly HexEncodedSha256HashGenerator sha256HashGenerator = new();
+    private readonly Uuid4Generator uuid4Generator = new();
 
     [Benchmark]
     public string CryptoRandomBase64UrlEncodedGenerator() =>
-        crbase64Generator.GeneratePseudonym("test", 16);
+        crbase64Generator.GeneratePseudonym("test", 64);
 
     [Benchmark]
     public string HexEncodedSha256HashGenerator() =>
         sha256HashGenerator.GeneratePseudonym("test", 64);
+
+    [Benchmark]
+    public string Uuid4HashGenerator() => uuid4Generator.GeneratePseudonym("test", 36);
 }

src/Vfps.Tests/PseudonymGeneratorTests/Uuid4GeneratorTests.cs

@@ -0,0 +1,23 @@
+using Vfps.PseudonymGenerators;
+
+namespace Vfps.Tests.PseudonymGeneratorTests;
+
+public class Uuid4GeneratorTests
+{
+    private readonly Uuid4Generator sut = new();
+
+    [Theory]
+    [InlineData("test")]
+    [InlineData("longer Value with an Emoji 👷‍♂️")]
+    public void GeneratePseudonym_WithGivenInput_ShouldGenerateExpectedPseudonyms(string input)
+    {
+        var generated = sut.GeneratePseudonym(input);
+        generated.Should().HaveLength(36);
+    }
+
+    [Fact]
+    public void GeneratePseudonym_WithLengthOtherThan36_ShouldThrowException()
+    {
+        sut.Invoking(s => s.GeneratePseudonym("test", 64)).Should().Throw<ArgumentException>();
+    }
+}

src/Vfps/Protos/vfps/api/v1/namespaces.proto

@@ -73,6 +73,8 @@ enum PseudonymGenerationMethod {
   PSEUDONYM_GENERATION_METHOD_SECURE_RANDOM_BASE64URL_ENCODED = 1;
   // SHA256-encodes the original value and uses the hex-encoded hash as the pseudonym.
   PSEUDONYM_GENERATION_METHOD_SHA256_HEX_ENCODED = 2;
+  // The method creates a Version 4 Universally Unique Identifier (UUID) as described in RFC 4122, Sec. 4.4.
+  PSEUDONYM_GENERATION_METHOD_UUID4 = 3;
 }
 
 // request to create a new namespace

src/Vfps/PseudonymGenerators/PseudonymizationMethodsLookup.cs

@@ -16,6 +16,7 @@ public PseudonymizationMethodsLookup()
                 new CryptoRandomBase64UrlEncodedGenerator()
             },
             { PseudonymGenerationMethod.Sha256HexEncoded, new HexEncodedSha256HashGenerator() },
+            { PseudonymGenerationMethod.Uuid4, new Uuid4Generator() }
         };
     }
 

src/Vfps/PseudonymGenerators/Uuid4Generator.cs

@@ -0,0 +1,17 @@
+namespace Vfps.PseudonymGenerators;
+
+public class Uuid4Generator : IPseudonymGenerator
+{
+    public string GeneratePseudonym(string originalValue, uint pseudonymLength = 36)
+    {
+        if (pseudonymLength != 36)
+        {
+            throw new ArgumentOutOfRangeException(
+                nameof(pseudonymLength),
+                $"When using the {nameof(Uuid4Generator)}, the pseudonym length must be set to 36."
+            );
+        }
+
+        return Guid.NewGuid().ToString();
+    }
+}