feat(fax): support services

src/Sinch/Fax/Emails/Emails.cs

@@ -7,6 +7,7 @@
 using System.Threading.Tasks;
 using System.Web;
 using Sinch.Core;
+using Sinch.Fax.Services;
 using Sinch.Logger;
 
 namespace Sinch.Fax.Emails
@@ -120,44 +121,26 @@ internal class EmailsClient : ISinchFaxEmails
         private readonly string _projectId;
         private readonly Uri _apiBasePath;
         private readonly IHttp _http;
+        private readonly ISinchFaxServices _services;
         private readonly ILoggerAdapter<ISinchFaxEmails>? _logger;
-        private readonly Uri _baseAddress;
 
 
         internal EmailsClient(string projectId, Uri baseAddress, ILoggerAdapter<ISinchFaxEmails>? loggerAdapter,
-            IHttp httpClient)
+            IHttp httpClient, ISinchFaxServices services)
         {
             _logger = loggerAdapter;
             _http = httpClient;
+            _services = services;
             _projectId = projectId;
-            _baseAddress = baseAddress;
             _apiBasePath = new Uri(baseAddress, $"/v3/projects/{projectId}/emails");
         }
 
-        /// <inheritdoc />
+
         public Task<ListEmailsResponse<string>> ListForNumber(string serviceId, string phoneNumber, int? page,
             int? pageSize,
             CancellationToken cancellationToken = default)
         {
-            _logger?.LogInformation("Listing emails for {serviceId} and {number}", serviceId, phoneNumber);
-            ExceptionUtils.CheckEmptyString(nameof(serviceId), serviceId);
-            ExceptionUtils.CheckEmptyString(nameof(phoneNumber), phoneNumber);
-
-            var uriBuilder = new UriBuilder(_baseAddress);
-            uriBuilder.Path += $"services/{serviceId}/numbers/{phoneNumber}/emails";
-            var queryString = HttpUtility.ParseQueryString(string.Empty);
-            if (page.HasValue)
-            {
-                queryString.Add("page", page.Value.ToString());
-            }
-
-            if (pageSize.HasValue)
-            {
-                queryString.Add("pageSize", pageSize.Value.ToString());
-            }
-
-            uriBuilder.Query = queryString.ToString();
-            return _http.Send<ListEmailsResponse<string>>(uriBuilder.Uri, HttpMethod.Get, cancellationToken);
+            return _services.ListEmailsForNumber(serviceId, phoneNumber, page, pageSize, cancellationToken);
         }
 
         public Task<ListEmailsResponse<EmailAddress>> List(int? page, int? pageSize,
@@ -181,23 +164,14 @@ public Task<ListEmailsResponse<EmailAddress>> List(int? page, int? pageSize,
             return _http.Send<ListEmailsResponse<EmailAddress>>(uriBuilder.Uri, HttpMethod.Get, cancellationToken);
         }
 
-
-        public async IAsyncEnumerable<string> ListForNumberAuto(string serviceId, string phoneNumber, int? page,
+        public IAsyncEnumerable<string> ListForNumberAuto(string serviceId, string phoneNumber, int? page,
             int? pageSize,
-            [EnumeratorCancellation] CancellationToken cancellationToken = default)
+            CancellationToken cancellationToken = default)
         {
-            _logger?.LogDebug("Auto Listing emails");
-
-            ListEmailsResponse<string> response;
-            do
-            {
-                response = await ListForNumber(serviceId, phoneNumber, page, pageSize, cancellationToken);
-                foreach (var contact in response.Emails)
-                    yield return contact;
-                page += 1;
-            } while (!Utils.IsLastPage(response.PageNumber, response.PageSize, response.TotalItems, PageStart.One));
+            return _services.ListEmailsForNumberAuto(serviceId, phoneNumber, page, pageSize, cancellationToken);
         }
 
+
         public async IAsyncEnumerable<EmailAddress> ListAuto(int? page, int? pageSize,
             [EnumeratorCancellation] CancellationToken cancellationToken = default)
         {

src/Sinch/Fax/FaxClient.cs

@@ -2,6 +2,7 @@
 using Sinch.Core;
 using Sinch.Fax.Emails;
 using Sinch.Fax.Faxes;
+using Sinch.Fax.Services;
 using Sinch.Logger;
 
 namespace Sinch.Fax
@@ -17,20 +18,26 @@ public interface ISinchFax
 
         /// <inheritdoc cref="ISinchFaxEmails" />
         public ISinchFaxEmails Emails { get; }
+
+        /// <inheritdoc cref="ISinchFaxServices " />
+        public ISinchFaxServices Services { get; }
     }
 
     internal class FaxClient : ISinchFax
     {
         internal FaxClient(string projectId, Uri baseAddress, LoggerFactory? loggerFactory, IHttp http)
         {
             Faxes = new FaxesClient(projectId, baseAddress, loggerFactory?.Create<ISinchFaxFaxes>(), http);
-            Emails = new EmailsClient(projectId, baseAddress, loggerFactory?.Create<ISinchFaxEmails>(), http);
+            Services = new ServicesClient(projectId, baseAddress, loggerFactory?.Create<ISinchFaxServices>(), http);
+            Emails = new EmailsClient(projectId, baseAddress, loggerFactory?.Create<ISinchFaxEmails>(), http, Services);
         }
 
         /// <inheritdoc />
         public ISinchFaxFaxes Faxes { get; }
 
         /// <inheritdoc />
         public ISinchFaxEmails Emails { get; }
+
+        public ISinchFaxServices Services { get; }
     }
 }

src/Sinch/Fax/Faxes/CallbackUrlContentType.cs

@@ -0,0 +1,21 @@
+using System.Text.Json.Serialization;
+using Sinch.Core;
+
+namespace Sinch.Fax.Faxes
+{
+    /// <summary>
+    /// The content type of the callback.
+    /// </summary>
+    /// <value>The content type of the callback.</value>
+    [JsonConverter(typeof(EnumRecordJsonConverter<CallbackUrlContentType>))]
+    public record CallbackUrlContentType(string Value) : EnumRecord(Value)
+    {
+        public static readonly CallbackUrlContentType MultipartFormData = new("multipart/form-data");
+        public static readonly CallbackUrlContentType ApplicationJson = new("application/json");
+
+        public override string ToString()
+        {
+            return base.ToString();
+        }
+    }
+}

src/Sinch/Fax/Faxes/Fax.cs

@@ -2,7 +2,6 @@
 using System.Collections.Generic;
 using System.Text;
 using System.Text.Json.Serialization;
-using Sinch.Core;
 
 namespace Sinch.Fax.Faxes
 {
@@ -216,20 +215,4 @@ public override string ToString()
             return sb.ToString();
         }
     }
-
-    /// <summary>
-    /// The content type of the callback.
-    /// </summary>
-    /// <value>The content type of the callback.</value>
-    [JsonConverter(typeof(EnumRecordJsonConverter<CallbackUrlContentType>))]
-    public record CallbackUrlContentType(string Value) : EnumRecord(Value)
-    {
-        public static readonly CallbackUrlContentType MultipartFormData = new("multipart/form-data");
-        public static readonly CallbackUrlContentType ApplicationJson = new("application/json");
-
-        public override string ToString()
-        {
-            return base.ToString();
-        }
-    }
 }

src/Sinch/Fax/Emails/PagedResponse.cs → src/Sinch/Fax/PagedResponse.cs

@@ -1,4 +1,4 @@
-namespace Sinch.Fax.Emails
+namespace Sinch.Fax
 {
     public class PagedResponse
     {

src/Sinch/Fax/Services/CreateServiceRequest.cs

@@ -0,0 +1,108 @@
+using System.Text;
+using System.Text.Json.Serialization;
+using Sinch.Fax.Faxes;
+
+namespace Sinch.Fax.Services
+{
+    public sealed class CreateServiceRequest
+    {
+        /// <summary>
+        /// Determines how documents are converted to black and white. Value should be halftone or monochrome. Defaults to value selected on Fax Settings page
+        /// </summary>
+        [JsonPropertyName("imageConversionMethod")]
+        public ImageConversionMethod? ImageConversionMethod { get; set; }
+
+        /// <summary>
+        /// The content type of the webhook.
+        /// </summary>
+        [JsonPropertyName("webhookContentType")]
+        public CallbackUrlContentType? WebhookContentType { get; set; }
+
+
+        /// <summary>
+        ///     ID of the fax service used.
+        /// </summary>
+        [JsonPropertyName("id")]
+        public string? Id { get; set; }
+
+
+        /// <summary>
+        ///     A friendly name for the service. Maximum is 60 characters.
+        /// </summary>
+        [JsonPropertyName("name")]
+        public string? Name { get; set; }
+
+
+        /// <summary>
+        ///     The URL to which Sinch will post when someone sends a fax to your Sinch number. To accept incoming faxes this must be set and your Sinch phone number must be configured to receive faxes.
+        /// </summary>
+        [JsonPropertyName("incomingWebhookUrl")]
+        public string? IncomingWebhookUrl { get; set; }
+
+
+        /// <summary>
+        ///     If set to true this is the service used to create faxes when no serviceId is specified in the API endpoints.
+        /// </summary>
+        [JsonPropertyName("defaultForProject")]
+        public bool? DefaultForProject { get; set; }
+
+
+        /// <summary>
+        ///     One of your sinch numbers connected to this service or any of your verified numbers
+        /// </summary>
+        [JsonPropertyName("defaultFrom")]
+        public string? DefaultFrom { get; set; }
+
+
+        /// <summary>
+        ///     The number of times to retry sending a fax if it fails. Default is 3. Maximum is 5.
+        /// </summary>
+        [JsonPropertyName("numberOfRetries")]
+        public int? NumberOfRetries { get; set; }
+
+
+        /// <summary>
+        ///     The number of seconds to wait between retries if the fax is not yet completed.
+        /// </summary>
+        [JsonPropertyName("retryDelaySeconds")]
+        public int? RetryDelaySeconds { get; set; }
+
+
+        /// <summary>
+        ///     Save fax documents with sinch when you send faxes
+        /// </summary>
+        [JsonPropertyName("saveOutboundFaxDocuments")]
+        public bool? SaveOutboundFaxDocuments { get; set; }
+
+
+        /// <summary>
+        ///     Save fax documents with sinch when you receive faxes
+        /// </summary>
+        [JsonPropertyName("saveInboundFaxDocuments")]
+        public bool? SaveInboundFaxDocuments { get; set; }
+
+
+        /// <summary>
+        ///     Returns the string presentation of the object
+        /// </summary>
+        /// <returns>String presentation of the object</returns>
+        public override string ToString()
+        {
+            var sb = new StringBuilder();
+            sb.Append($"class {nameof(Service)} {{\n");
+            sb.Append($"  {nameof(Id)}: ").Append(Id).Append('\n');
+            sb.Append($"  {nameof(Name)}: ").Append(Name).Append('\n');
+            sb.Append($"  {nameof(IncomingWebhookUrl)}: ").Append(IncomingWebhookUrl).Append('\n');
+            sb.Append($"  {nameof(WebhookContentType)}: ").Append(WebhookContentType).Append('\n');
+            sb.Append($"  {nameof(DefaultForProject)}: ").Append(DefaultForProject).Append('\n');
+            sb.Append($"  {nameof(DefaultFrom)}: ").Append(DefaultFrom).Append('\n');
+            sb.Append($"  {nameof(NumberOfRetries)}: ").Append(NumberOfRetries).Append('\n');
+            sb.Append($"  {nameof(RetryDelaySeconds)}: ").Append(RetryDelaySeconds).Append('\n');
+            sb.Append($"  {nameof(ImageConversionMethod)}: ").Append(ImageConversionMethod).Append('\n');
+            sb.Append($"  {nameof(SaveOutboundFaxDocuments)}: ").Append(SaveOutboundFaxDocuments).Append('\n');
+            sb.Append($"  {nameof(SaveInboundFaxDocuments)}: ").Append(SaveInboundFaxDocuments).Append('\n');
+            sb.Append("}\n");
+            return sb.ToString();
+        }
+    }
+}

src/Sinch/Fax/Services/ListServicesResponse.cs

@@ -0,0 +1,11 @@
+using System.Collections.Generic;
+using System.Text.Json.Serialization;
+
+namespace Sinch.Fax.Services
+{
+    public sealed class ListServicesResponse : PagedResponse
+    {
+        [JsonPropertyName("services")]
+        public List<Service> Services { get; set; } = new();
+    }
+}