Hub sites

docs/ROADMAP.md

@@ -124,5 +124,10 @@ Interested in [SharePoint User Profile REST reference](https://docs.microsoft.co
 
 ### Hub Sites
 
-Interested in [Hub Sites REST API](https://docs.microsoft.com/en-us/sharepoint/dev/features/hub-site/hub-site-rest-api)? [Open an issue](https://github.com/microsoftgraph/msgraph-sdk-dotnet-contrib/issues/new)
+The following operations allow for retrieving HubSites.
+
+| Operation        | Request Builder | Method                   | Released version |
+|------------------|-----------------|--------------------------|------------------|
+| GetHubSites      | `.Hubs`         | GetAsync                 | 4.54.5           |
+
 

src/Models/Hub.cs

@@ -0,0 +1,50 @@
+namespace Graph.Community
+{
+  public class Hub
+  {
+    /// <summary>
+    /// Identifies the hub site.
+    /// </summary>
+    public string Id { get; set; }
+
+    /// <summary>
+    /// The display name of the hub site.
+    /// </summary>
+    public string Title { get; set; }
+
+    /// <summary>
+    /// ID of the hub parent site.
+    /// </summary>
+    public string SiteId { get; set; }
+
+    /// <summary>
+    /// The tenant instance ID in which the hub site is located. Use empty GUID for the default tenant instance.
+    /// </summary>
+    public string TenantInstanceId { get; set; }
+
+    /// <summary>
+    /// URL of the hub parent site.
+    /// </summary>
+    public string SiteUrl { get; set; }
+
+    /// <summary>
+    /// The URL of a logo to use in the hub site navigation.
+    /// </summary>
+    public string LogoUrl { get; set; }
+
+    /// <summary>
+    /// A description of the hub site.
+    /// </summary>
+    public string Description { get; set; }
+
+    /// <summary>
+    /// List of security groups with access to join the hub site. Null if everyone has permission.
+    /// </summary>
+    public string Targets { get; set; }
+
+    public bool HideNameInNavigation { get; set; }
+    public string ParentHubSiteId { get; set; }
+    public bool RequiresJoinApproval { get; set; }
+    public string SiteDesignId { get; set; }
+  }
+}

src/Models/RegionalSettings.cs

@@ -1,9 +1,4 @@
-using System;
-using System.Collections.Generic;
-using System.Text;
-using Microsoft.Graph;
-
-namespace Graph.Community.Models
+namespace Graph.Community.Models
 {
   public class RegionalSettings
   {

src/Requests/Hubs/HubCollectionPage.cs

@@ -0,0 +1,8 @@
+using Microsoft.Graph;
+
+namespace Graph.Community
+{
+  public class HubCollectionPage: CollectionPage<Hub>, IHubCollectionPage
+  {
+  }
+}

src/Requests/Hubs/HubCollectionRequest.cs

@@ -0,0 +1,38 @@
+using System.Collections.Generic;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.Graph;
+
+namespace Graph.Community
+{
+  public class HubCollectionRequest : BaseSharePointAPIRequest, IHubCollectionRequest
+  {
+    public HubCollectionRequest(
+      string requestUrl,
+      IBaseClient client,
+      IEnumerable<Option> options)
+      : base("SitePages", requestUrl, client, options)
+    {
+      this.Headers.Add(new HeaderOption(SharePointAPIRequestConstants.Headers.AcceptHeaderName, SharePointAPIRequestConstants.Headers.AcceptHeaderValue));
+      this.Headers.Add(new HeaderOption(SharePointAPIRequestConstants.Headers.ODataVersionHeaderName, SharePointAPIRequestConstants.Headers.ODataVersionHeaderValue));
+    }
+
+    public Task<IHubCollectionPage> GetAsync()
+    {
+      return this.GetAsync(CancellationToken.None);
+    }
+
+    public async Task<IHubCollectionPage> GetAsync(CancellationToken cancellationToken)
+    {
+      this.ContentType = "application/json";
+      var response = await this.SendAsync<SharePointAPICollectionResponse<IHubCollectionPage>>(null, cancellationToken).ConfigureAwait(false);
+
+      if (response?.Value?.CurrentPage != null)
+      {
+        return response.Value;
+      }
+
+      return null;
+    }
+  }
+}

src/Requests/Hubs/HubCollectionRequestBuilder.cs

@@ -0,0 +1,58 @@
+using System;
+using System.Collections.Generic;
+using Microsoft.Graph;
+
+namespace Graph.Community
+{
+  public class HubCollectionRequestBuilder : BaseRequestBuilder, IHubCollectionRequestBuilder
+  {
+    private readonly IEnumerable<Option> options;
+
+    public HubCollectionRequestBuilder(
+      string requestUrl,
+      IBaseClient client,
+      IEnumerable<Option> options = null)
+      : base(requestUrl, client)
+    {
+      this.options = options;
+    }
+
+    /// <summary>
+    /// Builds the request.
+    /// </summary>
+    /// <returns>The built request.</returns>
+    public IHubCollectionRequest Request()
+    {
+      return this.Request(options);
+    }
+
+    /// <summary>
+    /// Builds the request.
+    /// </summary>
+    /// <param name="options">The query and header options for the request.</param>
+    /// <returns>The built request.</returns>
+    public IHubCollectionRequest Request(IEnumerable<Option> options)
+    {
+      return new HubCollectionRequest(this.AppendSegmentToRequestUrl("HubSites"), this.Client, options);
+    }
+
+    /// <summary>
+    /// Gets an <see cref="IHubRequestBuilder"/> for the specified Hub
+    /// </summary>
+    /// <param name="id">The ID for the Hub</param>
+    /// <returns>The <see cref="IHubRequestBuilder"/>.</returns>
+    public IHubRequestBuilder this[string id]
+    {
+      get
+      {
+        if (string.IsNullOrEmpty(id))
+        {
+          throw new ArgumentNullException(nameof(id));
+        }
+
+        List<QueryOption> options = [new("hubSiteId", $"'{id}'")];
+        return new HubRequestBuilder(this.AppendSegmentToRequestUrl("HubSites/GetById"), this.Client, options);
+      }
+    }
+  }
+}

src/Requests/Hubs/HubRequest.cs

@@ -0,0 +1,32 @@
+using System.Collections.Generic;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.Graph;
+
+namespace Graph.Community
+{
+  public class HubRequest:BaseSharePointAPIRequest, IHubRequest
+  {
+    public HubRequest(
+      string requestUrl,
+      IBaseClient client,
+      IEnumerable<Option> options)
+      : base("Hub", requestUrl, client, options)
+    {
+      this.Headers.Add(new HeaderOption(SharePointAPIRequestConstants.Headers.AcceptHeaderName, SharePointAPIRequestConstants.Headers.AcceptHeaderValue));
+      this.Headers.Add(new HeaderOption(SharePointAPIRequestConstants.Headers.ODataVersionHeaderName, SharePointAPIRequestConstants.Headers.ODataVersionHeaderValue));
+    }
+
+    public Task<Hub> GetAsync()
+    {
+      return this.GetAsync(CancellationToken.None);
+    }
+
+    public async Task<Hub> GetAsync(CancellationToken cancellationToken)
+    {
+      this.ContentType = "application/json";
+      var entity = await this.SendAsync<Hub>(null, cancellationToken).ConfigureAwait(false);
+      return entity;
+    }
+  }
+}

src/Requests/Hubs/HubRequestBuilder.cs

@@ -0,0 +1,38 @@
+using System.Collections.Generic;
+using Microsoft.Graph;
+
+namespace Graph.Community
+{
+  public class HubRequestBuilder : BaseRequestBuilder,IHubRequestBuilder
+  {
+    private readonly IEnumerable<Option> options;
+
+    public HubRequestBuilder(
+      string requestUrl,
+      IBaseClient client,
+      IEnumerable<Option> options = null)
+      : base(requestUrl, client)
+    {
+      this.options = options;
+    }
+
+    /// <summary>
+    /// Builds the request.
+    /// </summary>
+    /// <returns>The built request.</returns>
+    public IHubRequest Request()
+    {
+      return this.Request(this.options);
+    }
+
+    /// <summary>
+    /// Builds the request.
+    /// </summary>
+    /// <param name="options">The query and header options for the request.</param>
+    /// <returns>The built request.</returns>
+    public IHubRequest Request(IEnumerable<Option> options)
+    {
+      return new HubRequest(this.RequestUrl, this.Client, options);
+    }
+  }
+}

src/Requests/Hubs/IHubCollectionPage.cs

@@ -0,0 +1,9 @@
+using Microsoft.Graph;
+
+namespace Graph.Community
+{
+  [InterfaceConverter(typeof(InterfaceConverter<HubCollectionPage>))]
+  public interface IHubCollectionPage : ICollectionPage<Hub>
+  {
+  }
+}

src/Requests/Hubs/IHubCollectionRequest.cs

@@ -0,0 +1,12 @@
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.Graph;
+
+namespace Graph.Community
+{
+  public interface IHubCollectionRequest : IBaseRequest
+  {
+    Task<IHubCollectionPage> GetAsync();
+    Task<IHubCollectionPage> GetAsync(CancellationToken cancellationToken);
+  }
+}

src/Requests/Hubs/IHubCollectionRequestBuilder .cs

@@ -0,0 +1,28 @@
+using System.Collections.Generic;
+using Microsoft.Graph;
+
+namespace Graph.Community
+{
+  public interface IHubCollectionRequestBuilder : IBaseRequestBuilder
+  {
+    /// <summary>
+    /// Builds the request.
+    /// </summary>
+    /// <returns>The built request.</returns>
+    IHubCollectionRequest Request();
+
+    /// <summary>
+    /// Builds the request.
+    /// </summary>
+    /// <param name="options">The query and header options for the request.</param>
+    /// <returns>The built request.</returns>
+    IHubCollectionRequest Request(IEnumerable<Option> options);
+
+    /// <summary>
+    /// Gets a <see cref="IHubRequestBuilder"/> for the specified Hub.
+    /// </summary>
+    /// <param name="id">The ID for the Hub.</param>
+    /// <returns>The <see cref="IHubRequestBuilder"/>.</returns>
+    IHubRequestBuilder this[string id] { get; }
+  }
+}

src/Requests/Hubs/IHubRequest.cs

@@ -0,0 +1,12 @@
+using System.Threading.Tasks;
+using System.Threading;
+using Microsoft.Graph;
+
+namespace Graph.Community
+{
+  public interface IHubRequest : IBaseRequest
+  {
+    Task<Hub> GetAsync();
+    Task<Hub> GetAsync(CancellationToken cancellationToken);
+  }
+}

src/Requests/Hubs/IHubRequestBuilder.cs

@@ -0,0 +1,21 @@
+using System.Collections.Generic;
+using Microsoft.Graph;
+
+namespace Graph.Community
+{
+  public interface IHubRequestBuilder : IBaseRequestBuilder
+  {
+    /// <summary>
+    /// Builds the request.
+    /// </summary>
+    /// <returns>The built request.</returns>
+    IHubRequest Request();
+
+    /// <summary>
+    /// Builds the request.
+    /// </summary>
+    /// <param name="options">The query and header options for the request.</param>
+    /// <returns>The built request.</returns>
+    IHubRequest Request(IEnumerable<Option> options);
+  }
+}

src/Requests/ISharePointAPIRequestBuilder.cs

@@ -19,5 +19,7 @@ public interface ISharePointAPIRequestBuilder : IBaseRequestBuilder
     ISearchRequestBuilder Search { get; }
 
     ITenantRequestBuilder Tenant { get; } 
+
+    IHubCollectionRequestBuilder Hubs { get; }
   }
 }

src/Requests/SharePointAPIRequestBuilder.cs

@@ -74,5 +74,13 @@ public Graph.Community.ITenantRequestBuilder Tenant
         return new Graph.Community.TenantRequestBuilder(this.AppendSegmentToRequestUrl("_api"), this.Client);
       }
     }
+
+    public IHubCollectionRequestBuilder Hubs
+    {
+      get
+      {
+        return new Graph.Community.HubCollectionRequestBuilder(this.AppendSegmentToRequestUrl("_api"), this.Client);
+      }
+    }
   }
 }

src/Requests/SiteDesign/ISiteDesignCollectionRequestBuilder.cs

@@ -22,7 +22,7 @@ public interface ISiteDesignCollectionRequestBuilder : IBaseRequestBuilder
     /// Gets a <see cref="ISiteDesignCollectionRequestBuilder"/> for the specified Site Design.
     /// </summary>
     /// <param name="id">The ID for the Site Design.</param>
-    /// <returns>The <see cref="ISiteDesignCollectionRequestBuilder"/>.</returns>
+    /// <returns>The <see cref="ISiteDesignRequestBuilder"/>.</returns>
     ISiteDesignRequestBuilder this[string id] { get; }
   }
 }

src/Requests/SiteDesign/SiteDesignCollectionRequestBuilder.cs

@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using Microsoft.Graph;
 
@@ -38,10 +38,10 @@ public ISiteDesignCollectionRequest Request(IEnumerable<Option> options)
     }
 
     /// <summary>
-    /// Gets an <see cref="ISiteDesignCollectionRequestBuilder"/> for the specified SiteDesign.
+    /// Gets an <see cref="ISiteDesignRequestBuilder"/> for the specified SiteDesign.
     /// </summary>
     /// <param name="id">The ID for the SiteDesign.</param>
-    /// <returns>The <see cref="ISiteDesignCollectionRequestBuilder"/>.</returns>
+    /// <returns>The <see cref="ISiteDesignRequestBuilder"/>.</returns>
     public ISiteDesignRequestBuilder this[string id]
     {
       get