Ready for Review WorkforceManagementApi

src/PureCloud.Client/Apis/WorkforceManagementApi.cs

@@ -0,0 +1,244 @@
+using System.Collections.Specialized;
+using System.Net.Http.Json;
+using System.Text.Json;
+using Microsoft.Extensions.Options;
+using PureCloud.Client.Contracts;
+using PureCloud.Client.Http;
+using PureCloud.Client.Json;
+using PureCloud.Client.Models;
+
+namespace PureCloud.Client.Apis;
+
+/// <inheritdoc />
+public sealed class WorkforceManagementApi : IWorkforceManagementApi
+{
+    private readonly HttpClient _httpClient;
+    private readonly JsonSerializerOptions _options;
+
+    public WorkforceManagementApi(IHttpClientFactory httpClientFactory, IOptions<PureCloudJsonSerializerOptions> options)
+    {
+        _httpClient = httpClientFactory.CreateClient(PureCloudConstants.PureCloudClientName);
+        _options = options.Value.JsonSerializerOptions;
+    }
+
+    /// <inheritdoc />
+    public async Task<BusinessUnitListing> GetBusinessUnitsAsync(string feature = null, string divisionId = null, CancellationToken cancellationToken = default)
+    {
+        var parameters = new NameValueCollection();
+
+        if (!string.IsNullOrEmpty(feature))
+        {
+            parameters.Add("feature", UriHelper.ParameterToString(feature));
+        }
+
+        if (!string.IsNullOrEmpty(divisionId))
+        {
+            parameters.Add("divisionId", UriHelper.ParameterToString(divisionId));
+        }
+
+        var uri = UriHelper.GetUri("api/v2/workforcemanagement/businessunits", parameters);
+
+        var response = await _httpClient.GetAsync(uri, cancellationToken);
+
+        response.EnsureSuccessStatusCode();
+
+        return await response.Content.ReadFromJsonAsync<BusinessUnitListing>(_options, cancellationToken);
+    }
+
+    /// <inheritdoc />
+    public async Task<BusinessUnitResponse> GetBusinessUnitAsync(string businessUnitId, List<string> expand = null, CancellationToken cancellationToken = default)
+    {
+        ArgumentException.ThrowIfNullOrEmpty(businessUnitId);
+
+        var parameters = new NameValueCollection();
+
+        if (expand != null && expand.Any())
+        {
+            parameters.Add("expand", string.Join(",", expand));
+        }
+
+        var uri = UriHelper.GetUri($"api/v2/workforcemanagement/businessunits/{businessUnitId}", parameters);
+
+        var response = await _httpClient.GetAsync(uri, cancellationToken);
+
+        response.EnsureSuccessStatusCode();
+
+        return await response.Content.ReadFromJsonAsync<BusinessUnitResponse>(_options, cancellationToken);
+    }
+
+    /// <inheritdoc />
+    public async Task DeleteBusinessUnitAsync(string businessUnitId, CancellationToken cancellationToken = default)
+    {
+        ArgumentException.ThrowIfNullOrEmpty(businessUnitId);
+
+        var uri = UriHelper.GetUri($"api/v2/workforcemanagement/businessunits/{businessUnitId}", null);
+
+        var response = await _httpClient.DeleteAsync(uri, cancellationToken);
+
+        response.EnsureSuccessStatusCode();
+    }
+
+    /// <inheritdoc />
+    public async Task DeleteManagementUnitAsync(string managementUnitId, CancellationToken cancellationToken = default)
+    {
+        ArgumentException.ThrowIfNullOrEmpty(managementUnitId);
+
+        var uri = UriHelper.GetUri($"api/v2/workforcemanagement/managementunits/{managementUnitId}", null);
+
+        var response = await _httpClient.DeleteAsync(uri, cancellationToken);
+
+        response.EnsureSuccessStatusCode();
+    }
+
+    /// <inheritdoc />
+    public async Task<ActivityCodeContainer> GetActivityCodesAsync(string businessUnitId, CancellationToken cancellationToken = default)
+    {
+        ArgumentException.ThrowIfNullOrEmpty(businessUnitId);
+
+        var uri = UriHelper.GetUri($"api/v2/workforcemanagement/businessunits/{businessUnitId}/activitycodes", null);
+
+        var response = await _httpClient.GetAsync(uri, cancellationToken);
+
+        response.EnsureSuccessStatusCode();
+
+        return await response.Content.ReadFromJsonAsync<ActivityCodeContainer>(_options, cancellationToken);
+    }
+
+    /// <inheritdoc />
+    public async Task<ActivityCode> CreateActivityCodeAsync(string businessUnitId, CreateActivityCodeRequest body, CancellationToken cancellationToken = default)
+    {
+        ArgumentException.ThrowIfNullOrEmpty(businessUnitId);
+        ArgumentNullException.ThrowIfNull(body);
+
+        var uri = UriHelper.GetUri($"api/v2/workforcemanagement/businessunits/{businessUnitId}/activitycodes", null);
+
+        var response = await _httpClient.PostAsJsonAsync(uri, body, _options, cancellationToken);
+
+        response.EnsureSuccessStatusCode();
+
+        return await response.Content.ReadFromJsonAsync<ActivityCode>(_options, cancellationToken);
+    }
+
+    /// <inheritdoc />
+    public async Task DeleteActivityCodeAsync(string businessUnitId, string activityCodeId, CancellationToken cancellationToken = default)
+    {
+        ArgumentException.ThrowIfNullOrEmpty(businessUnitId);
+        ArgumentException.ThrowIfNullOrEmpty(activityCodeId);
+
+        var uri = UriHelper.GetUri($"api/v2/workforcemanagement/businessunits/{businessUnitId}/activitycodes/{activityCodeId}", null);
+
+        var response = await _httpClient.DeleteAsync(uri, cancellationToken);
+
+        response.EnsureSuccessStatusCode();
+    }
+
+    /// <inheritdoc />
+    public async Task<string> GetSchedulesAsync(string businessUnitId, string weekId, bool? includeOnlyPublished = null, string expand = null, CancellationToken cancellationToken = default)
+    {
+        ArgumentException.ThrowIfNullOrEmpty(businessUnitId);
+        ArgumentException.ThrowIfNullOrEmpty(weekId);
+
+        var parameters = new NameValueCollection();
+
+        if (includeOnlyPublished.HasValue)
+        {
+            parameters.Add("includeOnlyPublished", UriHelper.ParameterToString(includeOnlyPublished.Value));
+        }
+
+        if (!string.IsNullOrEmpty(expand))
+        {
+            parameters.Add("expand", UriHelper.ParameterToString(expand));
+        }
+
+        var uri = UriHelper.GetUri($"api/v2/workforcemanagement/businessunits/{businessUnitId}/weeks/{weekId}/schedules", parameters);
+
+        var response = await _httpClient.GetAsync(uri, cancellationToken);
+
+        response.EnsureSuccessStatusCode();
+
+        return await response.Content.ReadAsStringAsync(cancellationToken);
+    }
+
+    /// <inheritdoc />
+    public async Task<string> GetScheduleAsync(string businessUnitId, string weekId, string scheduleId, string expand = null, CancellationToken cancellationToken = default)
+    {
+        ArgumentException.ThrowIfNullOrEmpty(businessUnitId);
+        ArgumentException.ThrowIfNullOrEmpty(weekId);
+        ArgumentException.ThrowIfNullOrEmpty(scheduleId);
+
+        var parameters = new NameValueCollection();
+
+        if (!string.IsNullOrEmpty(expand))
+        {
+            parameters.Add("expand", UriHelper.ParameterToString(expand));
+        }
+
+        var uri = UriHelper.GetUri($"api/v2/workforcemanagement/businessunits/{businessUnitId}/weeks/{weekId}/schedules/{scheduleId}", parameters);
+
+        var response = await _httpClient.GetAsync(uri, cancellationToken);
+
+        response.EnsureSuccessStatusCode();
+
+        return await response.Content.ReadAsStringAsync(cancellationToken);
+    }
+
+    /// <inheritdoc />
+    public async Task DeleteScheduleAsync(string businessUnitId, string weekId, string scheduleId, CancellationToken cancellationToken = default)
+    {
+        ArgumentException.ThrowIfNullOrEmpty(businessUnitId);
+        ArgumentException.ThrowIfNullOrEmpty(weekId);
+        ArgumentException.ThrowIfNullOrEmpty(scheduleId);
+
+        var uri = UriHelper.GetUri($"api/v2/workforcemanagement/businessunits/{businessUnitId}/weeks/{weekId}/schedules/{scheduleId}", null);
+
+        var response = await _httpClient.DeleteAsync(uri, cancellationToken);
+
+        response.EnsureSuccessStatusCode();
+    }
+
+    /// <inheritdoc />
+    public async Task<string> GetForecastsAsync(string businessUnitId, string weekDateId, CancellationToken cancellationToken = default)
+    {
+        ArgumentException.ThrowIfNullOrEmpty(businessUnitId);
+        ArgumentException.ThrowIfNullOrEmpty(weekDateId);
+
+        var uri = UriHelper.GetUri($"api/v2/workforcemanagement/businessunits/{businessUnitId}/weeks/{weekDateId}/shorttermforecasts", null);
+
+        var response = await _httpClient.GetAsync(uri, cancellationToken);
+
+        response.EnsureSuccessStatusCode();
+
+        return await response.Content.ReadAsStringAsync(cancellationToken);
+    }
+
+    /// <inheritdoc />
+    public async Task DeleteForecastAsync(string businessUnitId, string weekDateId, string forecastId, CancellationToken cancellationToken = default)
+    {
+        ArgumentException.ThrowIfNullOrEmpty(businessUnitId);
+        ArgumentException.ThrowIfNullOrEmpty(weekDateId);
+        ArgumentException.ThrowIfNullOrEmpty(forecastId);
+
+        var uri = UriHelper.GetUri($"api/v2/workforcemanagement/businessunits/{businessUnitId}/weeks/{weekDateId}/shorttermforecasts/{forecastId}", null);
+
+        var response = await _httpClient.DeleteAsync(uri, cancellationToken);
+
+        response.EnsureSuccessStatusCode();
+    }
+
+    /// <inheritdoc />
+    public async Task<string> CreateTimeOffRequestAsync(string managementUnitId, CreateAdminTimeOffRequest body, CancellationToken cancellationToken = default)
+    {
+        ArgumentException.ThrowIfNullOrEmpty(managementUnitId);
+        ArgumentNullException.ThrowIfNull(body);
+
+        var uri = UriHelper.GetUri($"api/v2/workforcemanagement/managementunits/{managementUnitId}/timeoffrequests", null);
+
+        var response = await _httpClient.PostAsJsonAsync(uri, body, _options, cancellationToken);
+
+        response.EnsureSuccessStatusCode();
+
+        var responseText = await response.Content.ReadAsStringAsync(cancellationToken);
+
+        return responseText;
+    }
+}

src/PureCloud.Client/Contracts/IWorkforceManagementApi.cs

@@ -0,0 +1,74 @@
+using PureCloud.Client.Models;
+
+namespace PureCloud.Client.Contracts;
+
+/// <summary>
+/// Workforce Management API operations
+/// </summary>
+public interface IWorkforceManagementApi
+{
+    /// <summary>
+    /// Get business units
+    /// </summary>
+    Task<BusinessUnitListing> GetBusinessUnitsAsync(string feature = null, string divisionId = null, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Get a business unit
+    /// </summary>
+    Task<BusinessUnitResponse> GetBusinessUnitAsync(string businessUnitId, List<string> expand = null, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Delete a business unit
+    /// </summary>
+    Task DeleteBusinessUnitAsync(string businessUnitId, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Delete a management unit
+    /// </summary>
+    Task DeleteManagementUnitAsync(string managementUnitId, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Get activity codes
+    /// </summary>
+    Task<ActivityCodeContainer> GetActivityCodesAsync(string businessUnitId, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Create an activity code
+    /// </summary>
+    Task<ActivityCode> CreateActivityCodeAsync(string businessUnitId, CreateActivityCodeRequest body, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Delete an activity code
+    /// </summary>
+    Task DeleteActivityCodeAsync(string businessUnitId, string activityCodeId, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Get schedules for a week - simplified return type
+    /// </summary>
+    Task<string> GetSchedulesAsync(string businessUnitId, string weekId, bool? includeOnlyPublished = null, string expand = null, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Get a schedule - simplified return type
+    /// </summary>
+    Task<string> GetScheduleAsync(string businessUnitId, string weekId, string scheduleId, string expand = null, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Delete a schedule
+    /// </summary>
+    Task DeleteScheduleAsync(string businessUnitId, string weekId, string scheduleId, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Get short term forecasts - simplified return type
+    /// </summary>
+    Task<string> GetForecastsAsync(string businessUnitId, string weekDateId, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Delete a short term forecast
+    /// </summary>
+    Task DeleteForecastAsync(string businessUnitId, string weekDateId, string forecastId, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Create a time off request
+    /// </summary>
+    Task<string> CreateTimeOffRequestAsync(string managementUnitId, CreateAdminTimeOffRequest body, CancellationToken cancellationToken = default);
+}

src/PureCloud.Client/Extensions/ServiceCollectionExtensions.cs

@@ -221,9 +221,11 @@ public static IServiceCollection AddPureCloudApis(this IServiceCollection servic
 
         services.TryAddScoped<IWebChatApi, WebChatApi>();
 
-        services.TryAddScoped<IWebMessagingApi, WebMessagingApi>();
-
-        services.TryAddScoped<IWidgetsApi, WidgetsApi>();
+        services.TryAddScoped<IWebMessagingApi, WebMessagingApi>();
+
+        services.TryAddScoped<IWidgetsApi, WidgetsApi>();
+
+        services.TryAddScoped<IWorkforceManagementApi, WorkforceManagementApi>();
 
         return services;
     }

src/PureCloud.Client/Models/BuAsyncScheduleResponseStatus.cs

@@ -0,0 +1,33 @@
+using System.Text.Json.Serialization;
+
+namespace PureCloud.Client.Models;
+
+/// <summary>
+/// BuAsyncScheduleResponseStatus
+/// </summary>
+public enum BuAsyncScheduleResponseStatus
+{
+    /// <summary>
+    /// Processing
+    /// </summary>
+    [JsonPropertyName("Processing")]
+    Processing,
+
+    /// <summary>
+    /// Complete
+    /// </summary>
+    [JsonPropertyName("Complete")]
+    Complete,
+
+    /// <summary>
+    /// Canceled
+    /// </summary>
+    [JsonPropertyName("Canceled")]
+    Canceled,
+
+    /// <summary>
+    /// Error
+    /// </summary>
+    [JsonPropertyName("Error")]
+    Error
+}

src/PureCloud.Client/Models/BuNotificationSettingsResponse.cs

@@ -12,8 +12,8 @@ public partial class BuNotificationSettingsResponse : IEquatable<BuNotificationS
     /// <summary>
     /// Initializes a new instance of the <see cref="BuNotificationSettingsResponse" /> class.
     /// </summary>
-    /// <param name="Scheduling">Schedule notification settings.</param>
-    public BuNotificationSettingsResponse(BuScheduleNotificationsSettingsResponse Scheduling = null)
+    /// <param name="Scheduling">Schedule notification settings (simplified).</param>
+    public BuNotificationSettingsResponse(object Scheduling = null)
     {
         this.Scheduling = Scheduling;
 
@@ -22,11 +22,11 @@ public BuNotificationSettingsResponse(BuScheduleNotificationsSettingsResponse Sc
 
 
     /// <summary>
-    /// Schedule notification settings
+    /// Schedule notification settings (simplified)
     /// </summary>
-    /// <value>Schedule notification settings</value>
+    /// <value>Schedule notification settings (simplified)</value>
     [JsonPropertyName("scheduling")]
-    public BuScheduleNotificationsSettingsResponse Scheduling { get; set; }
+    public object Scheduling { get; set; }
 
 
     /// <summary>