Merge pull request #3 from Wish-Org:feat/Add-Organization

Add organization API with tests and update version to 2.7.0

Author: clement911

HelpScoutSharp.Tests/OrganizationService_Tests.cs

@@ -0,0 +1,33 @@
+using Microsoft.VisualStudio.TestTools.UnitTesting;
+
+namespace HelpScoutSharp.Tests;
+
+[TestClass]
+public class OrganizationService_Tests
+{
+    private OrganizationService _service;
+
+    [TestInitialize]
+    public async Task Initialize()
+    {
+        HelpScoutHttpClient.RateLimitBreachBehavior = RateLimitBreachBehavior.WaitAndRetryOnce;
+        var authSvc = new AuthenticationService();
+        var token = await authSvc.GetApplicationTokenAsync(TestHelper.ApplicationId, TestHelper.ApplicationSecret);
+        _service = new OrganizationService(token.access_token);
+    }
+
+    [TestMethod]
+    public async Task GetOrganizationAsync_Works()
+    {
+        var res = await _service.ListAsync();
+        var organization = await _service.GetAsync(res.entities[0].id);
+        Assert.IsTrue(organization.id > 0);
+    }
+
+    [TestMethod]
+    public async Task ListOrganizationsAsync_Works()
+    {
+        var res = await _service.ListAsync(new ListOrganizationsOptions());
+        Assert.IsTrue(res.page.size > 0);
+    }
+}

HelpScoutSharp/HelpScoutSharp.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <Version>2.6.3</Version>
+    <Version>2.7.0</Version>
     <Company>Better Reports</Company>
     <Product>Help Scout API Client for .NET</Product>
     <Authors>Better Reports</Authors>

HelpScoutSharp/Organizations/ListOrganizationsOptions.cs

@@ -0,0 +1,6 @@
+namespace HelpScoutSharp;
+
+public class ListOrganizationsOptions : ListOptions
+{
+    public string sort { get; set; }
+}

HelpScoutSharp/Organizations/Organization.cs

@@ -0,0 +1,26 @@
+namespace HelpScoutSharp;
+
+public class Organization : IHasId
+{
+    public long id { get; set; }
+
+    public string name { get; set; }
+
+    public string website { get; set; }
+
+    public string description { get; set; }
+
+    public string location { get; set; }
+
+    public string logoUrl { get; set; }
+
+    public string[] domains { get; set; }
+
+    public string[] phones { get; set; }
+
+    public string brandColor { get; set; }
+
+    public long customerCount { get; set; }
+
+    public long conversationCount { get; set; }
+}

HelpScoutSharp/Organizations/OrganizationPage.cs

@@ -0,0 +1,15 @@
+namespace HelpScoutSharp;
+
+public class OrganizationPage : IPage<Organization>
+{
+    public class Embedded
+    {
+        public Organization[] organizations { get; set; }
+    }
+
+    public Embedded _embedded { get; set; }
+
+    public Page page { get; set; }
+
+    public Organization[] entities => _embedded.organizations;
+}

HelpScoutSharp/Organizations/OrganizationService.cs

@@ -0,0 +1,21 @@
+using Flurl;
+
+namespace HelpScoutSharp;
+
+public class OrganizationService : ServiceBase, IListableService<Organization, ListOrganizationsOptions>
+{
+    public OrganizationService(string accessToken)
+        : base(accessToken, "organizations")
+    {
+    }
+
+    public async Task<Organization> GetAsync(long organizationId)
+    {
+        return await _client.GetAsync<Organization>(new Url(_serviceUri).AppendPathSegment(organizationId).ToUri());
+    }
+
+    public async Task<IPage<Organization>> ListAsync(ListOrganizationsOptions options = null)
+    {
+        return await _client.GetAsync<OrganizationPage>(_serviceUri, options);
+    }
+}