feat: verifyV2 BYOP (#392)

* Implement BYOP (custom code)

* Remove dead code

Vonage.Test.Unit/VerifyV2/StartVerification/Data/ShouldSerialize-request.json

@@ -4,6 +4,7 @@
   "client_ref": "my-personal-reference",
   "code_length": 4,
   "brand": "ACME, Inc",
+  "code": "123456",
   "workflow": [
     {
       "channel": "email",

Vonage.Test.Unit/VerifyV2/StartVerification/RequestBuilderTest.cs

@@ -237,6 +237,17 @@ public class RequestBuilderTest
                 .Should()
                 .BeSuccess("client ref");
 
+        [Fact]
+        public void Create_ShouldSetCode() =>
+            StartVerificationRequest.Build()
+                .WithBrand(this.fixture.Create<string>())
+                .WithWorkflow(EmailWorkflow.Parse(ValidEmail))
+                .WithCode("123456")
+                .Create()
+                .Map(request => request.Code)
+                .Should()
+                .BeSuccess("123456");
+
         [Theory]
         [InlineData(4)]
         [InlineData(10)]

Vonage.Test.Unit/VerifyV2/StartVerification/SerializationTest.cs

@@ -39,6 +39,7 @@ public class SerializationTest
                 .WithChannelTimeout(300)
                 .WithClientReference("my-personal-reference")
                 .WithCodeLength(4)
+                .WithCode("123456")
                 .Create()
                 .GetStringContent()
                 .Should()

Vonage/VerifyV2/StartVerification/StartVerificationRequest.cs

@@ -31,6 +31,11 @@ namespace Vonage.VerifyV2.StartVerification;
     /// </summary>
     public Maybe<string> ClientReference { get; internal init; }
 
+    /// <summary>
+    ///     An optional alphanumeric custom code to use, if you don't want Vonage to generate the code.
+    /// </summary>
+    public Maybe<string> Code { get; internal init; }
+
     /// <summary>
     ///     Gets the length of the code to send to the user
     /// </summary>
@@ -83,6 +88,7 @@ private StringContent GetRequestContent()
         this.ClientReference.IfSome(some => values.Add("client_ref", some));
         values.Add("code_length", this.CodeLength);
         values.Add("brand", this.Brand);
+        this.Code.IfSome(some => values.Add("code", some));
         values.Add("workflow", this.Workflows
             .Select(workflow => workflow.Serialize(serializer))
             .Select(serializedString => serializer.DeserializeObject<dynamic>(serializedString))

Vonage/VerifyV2/StartVerification/StartVerificationRequestBuilder.cs

@@ -18,6 +18,7 @@ internal class StartVerificationRequestBuilder :
     private Locale locale = Locale.EnUs;
     private Maybe<IResultFailure> failure = Maybe<IResultFailure>.None;
     private Maybe<string> clientReference = Maybe<string>.None;
+    private Maybe<string> code;
     private string brand;
 
     /// <inheritdoc />
@@ -33,6 +34,7 @@ internal class StartVerificationRequestBuilder :
                     ClientReference = this.clientReference,
                     CodeLength = this.codeLength,
                     Workflows = this.workflows.ToArray(),
+                    Code = this.code,
                 }))
             .Bind(VerifyWorkflowsNotEmpty)
             .Bind(VerifyBrandNotEmpty)
@@ -62,6 +64,13 @@ public IOptionalBuilder WithClientReference(string value)
         return this;
     }
 
+    /// <inheritdoc />
+    public IOptionalBuilder WithCode(string value)
+    {
+        this.code = value;
+        return this;
+    }
+
     /// <inheritdoc />
     public IOptionalBuilder WithCodeLength(int value)
     {
@@ -189,6 +198,19 @@ public interface IOptionalBuilderForCodeLength
     IOptionalBuilder WithCodeLength(int value);
 }
 
+/// <summary>
+///     Represents a builder for Code.
+/// </summary>
+public interface IOptionalBuilderForCode
+{
+    /// <summary>
+    ///     Sets a custom code, if you don't want Vonage to generate the code.
+    /// </summary>
+    /// <param name="value">The custom code.</param>
+    /// <returns>The builder.</returns>
+    IOptionalBuilder WithCode(string value);
+}
+
 /// <summary>
 ///     Represents a builder for fallback workflow.
 /// </summary>
@@ -237,6 +259,7 @@ public interface IOptionalBuilder :
     IOptionalOptionalBuilderForChannelTimeout,
     IOptionalOptionalBuilderForClientReference,
     IOptionalBuilderForCodeLength,
-    IOptionalBuilderForFallbackWorkflow
+    IOptionalBuilderForFallbackWorkflow,
+    IOptionalBuilderForCode
 {
 }