Merge pull request #12 from boldsign/v-3.1.0

georgelivingston · web-flow · commit 39073986797a · 2022-02-08T11:32:49.000+05:30
v3.1.0 is released
diff --git a/src/BoldSign/Api/DocumentClient.cs b/src/BoldSign/Api/DocumentClient.cs
@@ -2563,6 +2563,11 @@ private static void ValidateSendProperties(SendForSign sendRequest)
             {
                 throw new ApiException(422, ApiValidationMessages.InvalidBrandId);
             }
+
+            if (sendRequest.TextTagDefinitions != null && sendRequest.TextTagDefinitions.Any(x => (x.Size != null && (x.Size.Width <= 0 || x.Size.Height <= 0))))
+            {
+                throw new ApiException(422, ApiValidationMessages.InvalidTextTagSize);
+            }
         }
 
         private static bool ValidateUri(string uri)
diff --git a/src/BoldSign/Api/FromRequestHelper.cs b/src/BoldSign/Api/FromRequestHelper.cs
@@ -34,6 +34,11 @@ public static Dictionary<string, string> ConvertToFormRequest(SendForSign signRe
                 localVarFormParams = ToFormParameter(localVarFormParams, signRequestDetails.CC.ToList(), nameof(signRequestDetails.CC));
             }
 
+            if (signRequestDetails.TextTagDefinitions != null)
+            {
+                localVarFormParams = ToFormParameter(localVarFormParams, signRequestDetails.TextTagDefinitions.ToList(), nameof(signRequestDetails.TextTagDefinitions));
+            }
+
             if (signRequestDetails.Labels != null)
             {
                 var i = -1;
@@ -55,7 +60,28 @@ public static Dictionary<string, string> ConvertToFormRequest(SendForSign signRe
                 localVarFormParams.Add($"{nameof(signRequestDetails.ReminderSettings)}.{nameof(signRequestDetails.ReminderSettings.ReminderCount)}", signRequestDetails.ReminderSettings.ReminderCount.ToString());
             }
 
+            if (signRequestDetails is IEmbeddedRequest embeddedRequest)
+            {
+                if (embeddedRequest.RedirectUrl != null)
+                {
+                    localVarFormParams.Add(nameof(embeddedRequest.RedirectUrl), embeddedRequest.RedirectUrl.ToString());
+                }
+
+                localVarFormParams.Add(nameof(embeddedRequest.ShowToolbar), embeddedRequest.ShowToolbar ? "true" : "false");
+                localVarFormParams.Add(nameof(embeddedRequest.ShowSaveButton), embeddedRequest.ShowSaveButton ? "true" : "false");
+                localVarFormParams.Add(nameof(embeddedRequest.ShowSendButton), embeddedRequest.ShowSendButton ? "true" : "false");
+                localVarFormParams.Add(nameof(embeddedRequest.ShowPreviewButton), embeddedRequest.ShowPreviewButton ? "true" : "false");
+                localVarFormParams.Add(nameof(embeddedRequest.ShowNavigationButtons), embeddedRequest.ShowNavigationButtons ? "true" : "false");
+                localVarFormParams.Add(nameof(embeddedRequest.SendViewOption), embeddedRequest.SendViewOption.ToString());
+
+                if (embeddedRequest.SendLinkValidTill.HasValue)
+                {
+                    localVarFormParams.Add(nameof(embeddedRequest.SendLinkValidTill), embeddedRequest.SendLinkValidTill.ToString());
+                }
+            }
+
             localVarFormParams.Add(nameof(signRequestDetails.EnableSigningOrder), signRequestDetails.EnableSigningOrder ? "true" : "false");
+            localVarFormParams.Add(nameof(signRequestDetails.UseTextTags), signRequestDetails.UseTextTags ? "true" : "false");
 
 #pragma warning disable CS0618 // Type or member is obsolete
             localVarFormParams.Add(
diff --git a/src/BoldSign/Api/IDocumentClient.cs b/src/BoldSign/Api/IDocumentClient.cs
@@ -489,6 +489,38 @@ public interface IDocumentClient : IApiAccessor
         /// <returns>Task of ApiResponse (DocumentCreated)</returns>
         Task<ApiResponse<DocumentCreated>> SendDocumentAsyncWithHttpInfo(SendForSign signRequestDetails);
 
+        /// <summary>
+        ///     Embedded sends the document and generates a URL to embedded that document into iframe.
+        /// </summary>
+        /// <exception cref="ApiException">Thrown when fails to make API call.</exception>
+        /// <param name="sendRequest">The signRequestDetails.</param>
+        /// <returns>EmbeddedSendCreated.</returns>
+        EmbeddedSendCreated CreateEmbeddedRequestUrl(EmbeddedDocumentRequest sendRequest);
+
+        /// <summary>
+        ///     Embedded sends the document and generates a URL to embedded that document into iframe.
+        /// </summary>
+        /// <param name="sendRequest">The signRequestDetails.</param>
+        /// <exception cref="ApiException">Thrown when fails to make API call.</exception>
+        /// <returns>ApiResponse of EmbeddedSendCreated.</returns>
+        ApiResponse<EmbeddedSendCreated> CreateEmbeddedRequestUrlWithHttpInfo(EmbeddedDocumentRequest sendRequest);
+
+        /// <summary>
+        ///     Generates a send URL which embeds document sending process into your application.
+        /// </summary>
+        /// <param name="sendRequest">The signRequestDetails.</param>
+        /// <exception cref="ApiException">Thrown when fails to make API call.</exception>
+        /// <returns>Task of EmbeddedSendCreated.</returns>
+        Task<EmbeddedSendCreated> CreateEmbeddedRequestUrlAsync(EmbeddedDocumentRequest sendRequest);
+
+        /// <summary>
+        ///     Embedded sends the document and generates a URL to embedded that document into iframe.
+        /// </summary>
+        /// <param name="sendRequest">The signRequestDetails.</param>
+        /// <exception cref="ApiException">Thrown when fails to make API call.</exception>
+        /// <returns>Task of ApiResponse (EmbeddedSendCreated).</returns>
+        Task<ApiResponse<EmbeddedSendCreated>> CreateEmbeddedRequestUrlAsyncWithHttpInfo(EmbeddedDocumentRequest sendRequest);
+
         #endregion Asynchronous Operations
     }
 }
diff --git a/src/BoldSign/Api/ITemplateClient.cs b/src/BoldSign/Api/ITemplateClient.cs
@@ -138,6 +138,38 @@ public interface ITemplateClient : IApiAccessor
         /// <returns>Task of ApiResponse (DocumentCreated)</returns>
         Task<ApiResponse<DocumentCreated>> SendUsingTemplateAsyncWithHttpInfo(SendForSignFromTemplate sendForSignFromTemplate = default);
 
+        /// <summary>
+        ///     Embedded send a document for signature using a template.
+        /// </summary>
+        /// <exception cref="ApiException">Thrown when fails to make API call.</exception>
+        /// <param name="send">It contains page,page size and status details.</param>
+        /// <returns>An ApiResponse (DocumentCreated).</returns>
+        EmbeddedSendCreated CreateEmbeddedRequestUrl(EmbeddedTemplateRequest send = default);
+
+        /// <summary>
+        ///     Embedded send a document for signature using a template.
+        /// </summary>
+        /// <exception cref="ApiException">Thrown when fails to make API call.</exception>
+        /// <param name="send">It contains page,page size and status details.</param>
+        /// <returns>An ApiResponse (DocumentCreated).</returns>
+        ApiResponse<EmbeddedSendCreated> CreateEmbeddedRequestUrlWithHttpInfo(EmbeddedTemplateRequest send = default);
+
+        /// <summary>
+        ///     Embedded send a document for signature using a template.
+        /// </summary>
+        /// <exception cref="ApiException">Thrown when fails to make API call.</exception>
+        /// <param name="send">It contains page,page size and status details.</param>
+        /// <returns>Task of ApiResponse (DocumentCreated).</returns>
+        Task<EmbeddedSendCreated> CreateEmbeddedRequestUrlAsync(EmbeddedTemplateRequest send = default);
+
+        /// <summary>
+        ///     Generates a send URL using a template which embeds document sending process into your application.
+        /// </summary>
+        /// <exception cref="ApiException">Thrown when fails to make API call.</exception>
+        /// <param name="send">It contains page,page size and status details.</param>
+        /// <returns>Task of ApiResponse (DocumentCreated).</returns>
+        Task<ApiResponse<EmbeddedSendCreated>> CreateEmbeddedRequestUrlAsyncWithHttpInfo(EmbeddedTemplateRequest send = default);
+
         #endregion Asynchronous Operations
     }
 }
diff --git a/src/BoldSign/BoldSign.Api.csproj b/src/BoldSign/BoldSign.Api.csproj
@@ -1,8 +1,8 @@
 <Project Sdk="Microsoft.NET.Sdk">
     <PropertyGroup>
         <TargetFrameworks>netstandard2.0;net452</TargetFrameworks>
-        <FileVersion>3.0.0</FileVersion>
-        <ProductVersion>3.0.0</ProductVersion>
+        <FileVersion>3.1.0</FileVersion>
+        <ProductVersion>3.1.0</ProductVersion>
         <Copyright>Copyright 2001-2022 Syncfusion Inc</Copyright>
         <AssemblyName>BoldSign.Api</AssemblyName>
         <RootNamespace>BoldSign.Api</RootNamespace>
diff --git a/src/BoldSign/Model/DocumentSigner.cs b/src/BoldSign/Model/DocumentSigner.cs
@@ -25,14 +25,6 @@ namespace BoldSign.Model
     [DataContract]
     public class DocumentSigner
     {
-        /// <summary>
-        ///     Initializes a new instance of the <see cref="DocumentSigner" /> class.
-        /// </summary>
-        [JsonConstructor]
-        protected DocumentSigner()
-        {
-        }
-
         /// <summary>
         ///     Initializes a new instance of the <see cref="DocumentSigner" /> class.
         /// </summary>
diff --git a/src/BoldSign/Model/EmbeddedDocumentRequest.cs b/src/BoldSign/Model/EmbeddedDocumentRequest.cs
@@ -70,6 +70,14 @@ public class EmbeddedDocumentRequest : SendForSign, IEmbeddedRequest
         [JsonProperty("showNavigationButtons")]
         public bool ShowNavigationButtons { get; set; } = true;
 
+        /// <summary>
+        /// Gets or sets a value send link valid till.
+        /// Maximum valid till is 180 days.
+        /// Default is 30 days.
+        /// </summary>
+        [JsonProperty("sendLinkValidTill")]
+        public DateTime? SendLinkValidTill { get; set; }
+
         /// <summary>
         ///     Returns the JSON string presentation of the object.
         /// </summary>
diff --git a/src/BoldSign/Model/EmbeddedTemplateRequest.cs b/src/BoldSign/Model/EmbeddedTemplateRequest.cs
@@ -25,13 +25,15 @@ public class EmbeddedTemplateRequest : SendForSignFromTemplate, IEmbeddedRequest
         /// <param name="roles">Gets or sets the roles..</param>
         /// <param name="brandId">Gets or sets the brandId..</param>
         /// <param name="labels">Gets or sets the labels.</param>
+        /// <param name="sendLinkValidTill">Gets or sets the sendLinkValidTill.</param>
         public EmbeddedTemplateRequest(
             string templateId = default,
             string title = default,
             string message = default,
             List<Roles> roles = default,
             string brandId = default,
-            List<string> labels = default)
+            List<string> labels = default,
+            DateTime? sendLinkValidTill = default)
         {
             this.TemplateId = templateId;
             this.Title = title;
@@ -43,6 +45,7 @@ public EmbeddedTemplateRequest(
             this.Roles = roles;
             this.BrandId = brandId;
             this.Labels = labels;
+            this.SendLinkValidTill = sendLinkValidTill;
         }
 
         /// <summary>
@@ -87,6 +90,14 @@ public EmbeddedTemplateRequest(
         [JsonProperty("showNavigationButtons")]
         public bool ShowNavigationButtons { get; set; } = true;
 
+        /// <summary>
+        /// Gets or sets a value send link valid till.
+        /// Maximum valid till is 180 days.
+        /// Default is 30 days.
+        /// </summary>
+        [JsonProperty("sendLinkValidTill")]
+        public DateTime? SendLinkValidTill { get; set; }
+
         /// <summary>
         ///     Returns the JSON string presentation of the object.
         /// </summary>
diff --git a/src/BoldSign/Model/IEmbeddedRequest.cs b/src/BoldSign/Model/IEmbeddedRequest.cs
@@ -45,5 +45,12 @@ public interface IEmbeddedRequest
         /// Gets or sets a value indicating whether to show navigation buttons.
         /// </summary>
         public bool ShowNavigationButtons { get; set; }
+
+        /// <summary>
+        /// Gets or sets a value send link valid till.
+        /// Maximum valid till is 180 days.
+        /// Default is 30 days.
+        /// </summary>
+        public DateTime? SendLinkValidTill { get; set; }
     }
 }
diff --git a/src/BoldSign/Model/SendForSign.cs b/src/BoldSign/Model/SendForSign.cs
@@ -14,6 +14,7 @@ namespace BoldSign.Model
     using System.Collections.Generic;
     using System.ComponentModel.DataAnnotations;
     using System.Runtime.Serialization;
+    using BoldSign.Api.Model;
     using Newtonsoft.Json;
 
     /// <summary>
@@ -110,5 +111,17 @@ public class SendForSign
         /// </summary>
         [JsonProperty("hideDocumentId")]
         public bool HideDocumentId { get; set; }
+
+        /// <summary>
+        /// Gets or sets a value indicating whether to convert the text tags to form fields.
+        /// </summary>
+        [JsonProperty("useTextTags")]
+        public bool UseTextTags { get; set; }
+
+        /// <summary>
+        /// Gets or sets the text tags definitions declared in the list can be used in the document by using the definition ID.
+        /// </summary>
+        [JsonProperty("textTagDefinitions")]
+        public List<TextTagDefinition> TextTagDefinitions { get; set; }
     }
 }
diff --git a/src/BoldSign/Model/Size.cs b/src/BoldSign/Model/Size.cs
@@ -0,0 +1,58 @@
+// <copyright file="Size.cs" company="Syncfusion Inc">
+// Copyright (c) Syncfusion Inc. All rights reserved.
+// </copyright>
+
+/*
+ * BoldSign API
+ *
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1
+ *
+ * Generated by: https://github.com/openapitools/openapi-generator.git
+ */
+
+namespace BoldSign.Model
+{
+    using System.Runtime.Serialization;
+    using Newtonsoft.Json;
+
+    /// <summary>
+    ///     The rectangle properties are height, width, and so on.
+    /// </summary>
+    [DataContract]
+    public class Size
+    {
+        /// <summary>
+        ///     Initializes a new instance of the <see cref="Size" /> class.
+        /// </summary>
+        /// <param name="width">Gets or sets the width. (default to 35F).</param>
+        /// <param name="height">Gets or sets the height. (default to 16F).</param>
+        public Size(float width = 35F, float height = 16F)
+        {
+            // use default value if no "width" provided
+            this.Width = width;
+            this.Height = height;
+        }
+
+        /// <summary>
+        ///     Gets or sets the width of rectangle.
+        /// </summary>
+        /// <value>Gets or sets the width.</value>
+        [DataMember(Name = "width", EmitDefaultValue = false)]
+        public float Width { get; set; }
+
+        /// <summary>
+        ///     Gets or sets the height of rectangle.
+        /// </summary>
+        /// <value>Gets or sets the height.</value>
+        [DataMember(Name = "height", EmitDefaultValue = false)]
+        public float Height { get; set; }
+
+        /// <summary>
+        ///     Returns the JSON string presentation of the object.
+        /// </summary>
+        /// <returns>JSON string presentation of the object.</returns>
+        public virtual string ToJson() => JsonConvert.SerializeObject(this, Formatting.Indented);
+    }
+}
diff --git a/src/BoldSign/Model/TextTags/Font.cs b/src/BoldSign/Model/TextTags/Font.cs
@@ -0,0 +1,78 @@
+// <copyright file="Font.cs" company="Syncfusion Inc">
+// Copyright (c) Syncfusion Inc. All rights reserved.
+// </copyright>
+
+/*
+ * BoldSign API
+ *
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1
+ *
+ * Generated by: https://github.com/openapitools/openapi-generator.git
+ */
+
+namespace BoldSign.Api.Model
+{
+    using BoldSign.Model;
+    using Newtonsoft.Json;
+    using Newtonsoft.Json.Converters;
+
+    /// <summary>
+    /// The font style.
+    /// </summary>
+    [JsonConverter(typeof(StringEnumConverter))]
+    public enum FontStyle
+    {
+        /// <summary>
+        /// Regular.
+        /// </summary>
+        Regular = 0,
+
+        /// <summary>
+        /// Bold.
+        /// </summary>
+        Bold = 1,
+
+        /// <summary>
+        /// Italic.
+        /// </summary>
+        Italic = 2,
+
+        /// <summary>
+        /// Underline.
+        /// </summary>
+        Underline = 4,
+    }
+
+    /// <summary>
+    /// The font model.
+    /// </summary>
+    public class Font
+    {
+        /// <summary>
+        /// Gets or sets Name.
+        /// </summary>
+        public FontFamily? Name { get; set; } = FontFamily.Helvetica;
+
+        /// <summary>
+        /// Gets or sets the hex color.
+        /// </summary>
+        public string Color { get; set; } = "#000000";
+
+        /// <summary>
+        /// Gets or sets Size.
+        /// </summary>
+        public float Size { get; set; } = 13;
+
+        /// <summary>
+        /// Gets or sets Style.
+        /// </summary>
+        public FontStyle? Style { get; set; } = FontStyle.Regular;
+
+        /// <summary>
+        /// Gets or sets LineHeight.
+        /// </summary>
+        public int LineHeight { get; set; } = 17;
+    }
+}
diff --git a/src/BoldSign/Model/TextTags/TextTagDefinition.cs b/src/BoldSign/Model/TextTags/TextTagDefinition.cs
diff --git a/src/BoldSign/Model/TextTags/Validation.cs b/src/BoldSign/Model/TextTags/Validation.cs
diff --git a/src/BoldSign/Resources/ApiValidationMessages.Designer.cs b/src/BoldSign/Resources/ApiValidationMessages.Designer.cs
diff --git a/src/BoldSign/Resources/ApiValidationMessages.resx b/src/BoldSign/Resources/ApiValidationMessages.resx

Original file line number	Diff line number	Diff line change
`@@ -2563,6 +2563,11 @@ private static void ValidateSendProperties(SendForSign sendRequest)`
`2563`	`2563`	`{`
`2564`	`2564`	`throw new ApiException(422, ApiValidationMessages.InvalidBrandId);`
`2565`	`2565`	`}`
	`2566`	`+`
	`2567`	`+ if (sendRequest.TextTagDefinitions != null && sendRequest.TextTagDefinitions.Any(x => (x.Size != null && (x.Size.Width <= 0 \|\| x.Size.Height <= 0))))`
	`2568`	`+ {`
	`2569`	`+ throw new ApiException(422, ApiValidationMessages.InvalidTextTagSize);`
	`2570`	`+ }`
`2566`	`2571`	`}`
`2567`	`2572`
`2568`	`2573`	`private static bool ValidateUri(string uri)`
Original file line number	Diff line number	Diff line change
`@@ -45,5 +45,12 @@ public interface IEmbeddedRequest`
`45`	`45`	`/// Gets or sets a value indicating whether to show navigation buttons.`
`46`	`46`	`/// </summary>`
`47`	`47`	`public bool ShowNavigationButtons { get; set; }`
	`48`	`+`
	`49`	`+ /// <summary>`
	`50`	`+ /// Gets or sets a value send link valid till.`
	`51`	`+ /// Maximum valid till is 180 days.`
	`52`	`+ /// Default is 30 days.`
	`53`	`+ /// </summary>`
	`54`	`+ public DateTime? SendLinkValidTill { get; set; }`
`48`	`55`	`}`
`49`	`56`	`}`