From 3c336bdc459411654b542ae99ec86c8550261d27 Mon Sep 17 00:00:00 2001
From: Paul Schaeflein <paul@schaeflein.net>
Date: Wed, 22 Feb 2023 16:46:20 -0600
Subject: [PATCH] Add SitePageVersions

---
 src/Models/SitePageVersion.cs                 | 34 ++++++++++
 .../ISitePageCollectionRequestBuilder.cs      |  7 +-
 .../SitePages/ISitePageRequestBuilder.cs      |  2 +
 .../ISitePageVersionCollectionPage.cs         |  9 +++
 .../ISitePageVersionCollectionRequest.cs      | 12 ++++
 ...SitePageVersionCollectionRequestBuilder.cs | 21 ++++++
 .../SitePages/SitePageCollectionRequest.cs    |  4 +-
 .../SitePageCollectionRequestBuilder.cs       |  1 -
 .../SitePages/SitePageRequestBuilder.cs       |  8 +++
 .../SitePageVersionCollectionPage.cs          |  8 +++
 .../SitePageVersionCollectionRequest.cs       | 39 +++++++++++
 ...SitePageVersionCollectionRequestBuilder.cs | 29 ++++++++
 test/Graph.Community.Test.csproj              |  5 ++
 test/Mocks/GetSitePageVersionsResponse.json   | 44 ++++++++++++
 test/SitePageRequestTests.cs                  | 68 +++++++++++++++++++
 15 files changed, 282 insertions(+), 9 deletions(-)
 create mode 100644 src/Models/SitePageVersion.cs
 create mode 100644 src/Requests/SitePages/ISitePageVersionCollectionPage.cs
 create mode 100644 src/Requests/SitePages/ISitePageVersionCollectionRequest.cs
 create mode 100644 src/Requests/SitePages/ISitePageVersionCollectionRequestBuilder.cs
 create mode 100644 src/Requests/SitePages/SitePageVersionCollectionPage.cs
 create mode 100644 src/Requests/SitePages/SitePageVersionCollectionRequest.cs
 create mode 100644 src/Requests/SitePages/SitePageVersionCollectionRequestBuilder.cs
 create mode 100644 test/Mocks/GetSitePageVersionsResponse.json

diff --git a/src/Models/SitePageVersion.cs b/src/Models/SitePageVersion.cs
new file mode 100644
index 0000000..4d761c3
--- /dev/null
+++ b/src/Models/SitePageVersion.cs
@@ -0,0 +1,34 @@
+using System;
+using System.Text.Json.Serialization;
+using Microsoft.Graph;
+
+namespace Graph.Community
+{
+  public class SitePageVersion : BaseItem
+  {
+    public new int Id { get; set; }
+
+    //public string CheckInComment { get; set; }
+    public DateTime Created { get; set; }
+    public bool IsCurrentVersion { get; set; }
+
+    // Refer to https://github.com/pnp/pnpcore/issues/581
+    public string Length { get; set; }
+
+    [JsonIgnore]
+    public long Size
+    {
+      get
+      {
+        if (long.TryParse(Length, out var size))
+        {
+          return size;
+        }
+        return 0;
+      }
+
+    }
+
+    public string VersionLabel { get; set; }
+  }
+}
diff --git a/src/Requests/SitePages/ISitePageCollectionRequestBuilder.cs b/src/Requests/SitePages/ISitePageCollectionRequestBuilder.cs
index da40df9..15f21cb 100644
--- a/src/Requests/SitePages/ISitePageCollectionRequestBuilder.cs
+++ b/src/Requests/SitePages/ISitePageCollectionRequestBuilder.cs
@@ -1,11 +1,9 @@
-using System;
-using System.Collections.Generic;
-using System.Text;
+using System.Collections.Generic;
 using Microsoft.Graph;
 
 namespace Graph.Community
 {
-  public interface ISitePageCollectionRequestBuilder
+  public interface ISitePageCollectionRequestBuilder: IBaseRequestBuilder
   {
     /// <summary>
     /// Builds the request.
@@ -21,6 +19,5 @@ public interface ISitePageCollectionRequestBuilder
     ISitePageCollectionRequest Request(IEnumerable<Option> options);
 
     ISitePageRequestBuilder this[string name] { get; }
-
   }
 }
diff --git a/src/Requests/SitePages/ISitePageRequestBuilder.cs b/src/Requests/SitePages/ISitePageRequestBuilder.cs
index b3601e3..e222589 100644
--- a/src/Requests/SitePages/ISitePageRequestBuilder.cs
+++ b/src/Requests/SitePages/ISitePageRequestBuilder.cs
@@ -19,5 +19,7 @@ public interface ISitePageRequestBuilder : IBaseRequestBuilder
     /// <param name="options">The query and header options for the request.</param>
     /// <returns>The built request.</returns>
     ISitePageRequest Request(IEnumerable<Option> options);
+
+    ISitePageVersionCollectionRequestBuilder Versions { get; }
   }
 }
diff --git a/src/Requests/SitePages/ISitePageVersionCollectionPage.cs b/src/Requests/SitePages/ISitePageVersionCollectionPage.cs
new file mode 100644
index 0000000..e164e28
--- /dev/null
+++ b/src/Requests/SitePages/ISitePageVersionCollectionPage.cs
@@ -0,0 +1,9 @@
+using Microsoft.Graph;
+
+namespace Graph.Community
+{
+  [InterfaceConverter(typeof(InterfaceConverter<SitePageVersionCollectionPage>))]
+  public interface ISitePageVersionCollectionPage : ICollectionPage<SitePageVersion>
+  {
+  }
+}
diff --git a/src/Requests/SitePages/ISitePageVersionCollectionRequest.cs b/src/Requests/SitePages/ISitePageVersionCollectionRequest.cs
new file mode 100644
index 0000000..40b3459
--- /dev/null
+++ b/src/Requests/SitePages/ISitePageVersionCollectionRequest.cs
@@ -0,0 +1,12 @@
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.Graph;
+
+namespace Graph.Community
+{
+  public interface ISitePageVersionCollectionRequest : IBaseRequest
+  {
+    Task<ISitePageVersionCollectionPage> GetAsync();
+    Task<ISitePageVersionCollectionPage> GetAsync(CancellationToken cancellationToken);
+  }
+}
diff --git a/src/Requests/SitePages/ISitePageVersionCollectionRequestBuilder.cs b/src/Requests/SitePages/ISitePageVersionCollectionRequestBuilder.cs
new file mode 100644
index 0000000..c0834d4
--- /dev/null
+++ b/src/Requests/SitePages/ISitePageVersionCollectionRequestBuilder.cs
@@ -0,0 +1,21 @@
+using System.Collections.Generic;
+using Microsoft.Graph;
+
+namespace Graph.Community
+{
+  public interface ISitePageVersionCollectionRequestBuilder:IBaseRequestBuilder
+  {
+    /// <summary>
+    /// Builds the request.
+    /// </summary>
+    /// <returns>The built request.</returns>
+    ISitePageVersionCollectionRequest Request();
+
+    /// <summary>
+    /// Builds the request.
+    /// </summary>
+    /// <param name="options">The query and header options for the request.</param>
+    /// <returns>The built request.</returns>
+    ISitePageVersionCollectionRequest Request(IEnumerable<Option> options);
+  }
+}
diff --git a/src/Requests/SitePages/SitePageCollectionRequest.cs b/src/Requests/SitePages/SitePageCollectionRequest.cs
index 77f58b2..9298204 100644
--- a/src/Requests/SitePages/SitePageCollectionRequest.cs
+++ b/src/Requests/SitePages/SitePageCollectionRequest.cs
@@ -1,6 +1,4 @@
-using System;
-using System.Collections.Generic;
-using System.Text;
+using System.Collections.Generic;
 using System.Threading;
 using System.Threading.Tasks;
 using Microsoft.Graph;
diff --git a/src/Requests/SitePages/SitePageCollectionRequestBuilder.cs b/src/Requests/SitePages/SitePageCollectionRequestBuilder.cs
index 3883a50..a8c474e 100644
--- a/src/Requests/SitePages/SitePageCollectionRequestBuilder.cs
+++ b/src/Requests/SitePages/SitePageCollectionRequestBuilder.cs
@@ -1,7 +1,6 @@
 using System;
 using System.Collections.Generic;
 using System.Net;
-using System.Text;
 using Microsoft.Graph;
 
 namespace Graph.Community
diff --git a/src/Requests/SitePages/SitePageRequestBuilder.cs b/src/Requests/SitePages/SitePageRequestBuilder.cs
index fa866d0..58a5c7b 100644
--- a/src/Requests/SitePages/SitePageRequestBuilder.cs
+++ b/src/Requests/SitePages/SitePageRequestBuilder.cs
@@ -27,5 +27,13 @@ public ISitePageRequest Request(IEnumerable<Option> options)
     {
       return new SitePageRequest(this.RequestUrl, this.Client, options);
     }
+
+    public ISitePageVersionCollectionRequestBuilder Versions
+    {
+      get
+      {
+        return new Graph.Community.SitePageVersionCollectionRequestBuilder(this.AppendSegmentToRequestUrl("versions"), this.Client);
+      }
+    }
   }
 }
diff --git a/src/Requests/SitePages/SitePageVersionCollectionPage.cs b/src/Requests/SitePages/SitePageVersionCollectionPage.cs
new file mode 100644
index 0000000..d743322
--- /dev/null
+++ b/src/Requests/SitePages/SitePageVersionCollectionPage.cs
@@ -0,0 +1,8 @@
+using Microsoft.Graph;
+
+namespace Graph.Community
+{
+  public class SitePageVersionCollectionPage: CollectionPage<SitePageVersion>, ISitePageVersionCollectionPage
+  {
+  }
+}
diff --git a/src/Requests/SitePages/SitePageVersionCollectionRequest.cs b/src/Requests/SitePages/SitePageVersionCollectionRequest.cs
new file mode 100644
index 0000000..8bd1b54
--- /dev/null
+++ b/src/Requests/SitePages/SitePageVersionCollectionRequest.cs
@@ -0,0 +1,39 @@
+using System.Collections.Generic;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.Graph;
+
+namespace Graph.Community
+{
+  public class SitePageVersionCollectionRequest : BaseSharePointAPIRequest, ISitePageVersionCollectionRequest
+  {
+    public SitePageVersionCollectionRequest(
+      string requestUrl,
+      IBaseClient client,
+      IEnumerable<Option> options)
+      : base("SitePageVersionCollection", 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 async Task<ISitePageVersionCollectionPage> GetAsync()
+    {
+      return await this.GetAsync(CancellationToken.None);
+    }
+
+    public async Task<ISitePageVersionCollectionPage> GetAsync(CancellationToken cancellationToken)
+    {
+      this.ContentType = "application/json";
+      var response = await this.SendAsync<SharePointAPICollectionResponse<ISitePageVersionCollectionPage>>(null, cancellationToken).ConfigureAwait(false);
+
+      if (response?.Value?.CurrentPage != null)
+      {
+        return response.Value;
+      }
+
+      return null;
+    }
+
+  }
+}
diff --git a/src/Requests/SitePages/SitePageVersionCollectionRequestBuilder.cs b/src/Requests/SitePages/SitePageVersionCollectionRequestBuilder.cs
new file mode 100644
index 0000000..870aa79
--- /dev/null
+++ b/src/Requests/SitePages/SitePageVersionCollectionRequestBuilder.cs
@@ -0,0 +1,29 @@
+using System.Collections.Generic;
+using Microsoft.Graph;
+
+namespace Graph.Community
+{
+  public class SitePageVersionCollectionRequestBuilder: BaseRequestBuilder, ISitePageVersionCollectionRequestBuilder
+  {
+    private readonly IEnumerable<Option> options;
+
+    public SitePageVersionCollectionRequestBuilder(
+      string requestUrl,
+      IBaseClient client,
+      IEnumerable<Option> options = null)
+      : base(requestUrl, client)
+    {
+      this.options = options;
+    }
+
+    public ISitePageVersionCollectionRequest Request()
+    {
+      return this.Request(options);
+    }
+
+    public ISitePageVersionCollectionRequest Request(IEnumerable<Option> options)
+    {
+      return new SitePageVersionCollectionRequest(this.RequestUrl, this.Client, options);
+    }
+  }
+}
diff --git a/test/Graph.Community.Test.csproj b/test/Graph.Community.Test.csproj
index 9212ff5..58a35db 100644
--- a/test/Graph.Community.Test.csproj
+++ b/test/Graph.Community.Test.csproj
@@ -6,6 +6,10 @@
     <IsPackable>false</IsPackable>
   </PropertyGroup>
 
+  <ItemGroup>
+    <None Remove="Mocks\GetSitePageVersionsResponse.json" />
+  </ItemGroup>
+
   <ItemGroup>
     <EmbeddedResource Include="Mocks\ApplySiteDesignResponse.json" />
     <EmbeddedResource Include="Mocks\CreateSiteDesignResponse.json" />
@@ -24,6 +28,7 @@
     <EmbeddedResource Include="Mocks\GetSiteGroupsResponse.json" />
     <EmbeddedResource Include="Mocks\GetSitePageResponse.json" />
     <EmbeddedResource Include="Mocks\GetSitePagesResponse.json" />
+    <EmbeddedResource Include="Mocks\GetSitePageVersionsResponse.json" />
 		<EmbeddedResource Include="Mocks\GetSiteScriptMetadataResponse.json" />
     <EmbeddedResource Include="Mocks\GetSiteScriptsResponse.json" />
     <EmbeddedResource Include="Mocks\GetSiteUserResponse.json" />
diff --git a/test/Mocks/GetSitePageVersionsResponse.json b/test/Mocks/GetSitePageVersionsResponse.json
new file mode 100644
index 0000000..19c0fd1
--- /dev/null
+++ b/test/Mocks/GetSitePageVersionsResponse.json
@@ -0,0 +1,44 @@
+{
+  "odata.metadata": "https://mock.sharepoint.com/sites/mockSite/_api/$metadata#SP.ApiData.FileVersions",
+  "value": [
+    {
+      "odata.type": "SP.FileVersion",
+      "odata.id": "https://mock.sharepoint.com/sites/mockSite/_api/SP.FileVersionc75ac36c-9b5b-4645-afac-ac14d63cb005",
+      "odata.editLink": "SP.FileVersionc75ac36c-9b5b-4645-afac-ac14d63cb005",
+      "CheckInComment": "",
+      "Created": "2023-02-14T10:56:13Z",
+      "ID": 512,
+      "IsCurrentVersion": false,
+      "Length": "26340",
+      "Size": 26340,
+      "Url": "_vti_history/512/SitePages/home.aspx.IgnoreExt?IgnoreExt=1",
+      "VersionLabel": "1.0"
+    },
+    {
+      "odata.type": "SP.FileVersion",
+      "odata.id": "https://mock.sharepoint.com/sites/mockSite/_api/SP.FileVersion53bee446-0c9a-4cda-ad3e-c81b5a53a980",
+      "odata.editLink": "SP.FileVersion53bee446-0c9a-4cda-ad3e-c81b5a53a980",
+      "CheckInComment": "",
+      "Created": "2023-02-20T21:33:06Z",
+      "ID": 1024,
+      "IsCurrentVersion": true,
+      "Length": "27887",
+      "Size": 27887,
+      "Url": "_vti_history/1024/SitePages/home.aspx.IgnoreExt?IgnoreExt=1",
+      "VersionLabel": "2.0"
+    },
+    {
+      "odata.type": "SP.FileVersion",
+      "odata.id": "https://mock.sharepoint.com/sites/mockSite/_api/SP.FileVersion744871d5-1b26-41a5-bd18-9923986e9fed",
+      "odata.editLink": "SP.FileVersion744871d5-1b26-41a5-bd18-9923986e9fed",
+      "CheckInComment": "",
+      "Created": "2023-02-22T21:28:29Z",
+      "ID": 1025,
+      "IsCurrentVersion": false,
+      "Length": "27744",
+      "Size": 27744,
+      "Url": "_vti_history/1025/SitePages/home.aspx.IgnoreExt?IgnoreExt=1",
+      "VersionLabel": "2.1"
+    }
+  ]
+}
diff --git a/test/SitePageRequestTests.cs b/test/SitePageRequestTests.cs
index 6a5ad20..5f92920 100644
--- a/test/SitePageRequestTests.cs
+++ b/test/SitePageRequestTests.cs
@@ -93,5 +93,73 @@ public async Task GetByName_ReturnsCorrectResponse()
         // Props checked in SitePageFileInfoConverterTests
       }
     }
+
+    [Fact]
+    public void GetVersions_GeneratesCorrectRequestUriAndHeaders()
+    {
+      // ARRANGE
+      var mockPagename = "champions.aspx";
+      var expectedUri = new Uri($"{mockWebUrl}/_api/web/getfilebyserverrelativeurl('/sites/mockSite/SitePages/{mockPagename}')/versions");
+
+      using HttpResponseMessage response = new HttpResponseMessage();
+      using GraphServiceTestClient testClient = GraphServiceTestClient.Create(response);
+
+      // ACT
+      var request = testClient.GraphServiceClient
+                          .SharePointAPI(mockWebUrl)
+                          .SitePages[mockPagename]
+                          .Versions
+                          .Request()
+                          .GetHttpRequestMessage();
+
+      // ASSERT
+
+      Assert.Equal(expectedUri, request.RequestUri);
+      Assert.Equal(SharePointAPIRequestConstants.Headers.AcceptHeaderValue, request.Headers.Accept.ToString());
+      Assert.True(request.Headers.Contains(SharePointAPIRequestConstants.Headers.ODataVersionHeaderName), $"Header does not contain {SharePointAPIRequestConstants.Headers.ODataVersionHeaderName} header");
+      Assert.Equal(SharePointAPIRequestConstants.Headers.ODataVersionHeaderValue, string.Join(',', request.Headers.GetValues(SharePointAPIRequestConstants.Headers.ODataVersionHeaderName)));
+
+    }
+
+    [Fact]
+    public async Task GetVersions_ReturnsCorrectResponse()
+    {
+      // ARRANGE
+      var mockPagename = "champions.aspx";
+
+      var responseContent = ResourceManager.GetHttpResponseContent("GetSitePageVersionsResponse.json");
+      var responseMessage = new HttpResponseMessage()
+      {
+        StatusCode = HttpStatusCode.OK,
+        Content = new StringContent(responseContent),
+      };
+
+      using (responseMessage)
+      using (GraphServiceTestClient gsc = GraphServiceTestClient.Create(responseMessage))
+      {
+        // ACT
+        var response = await gsc.GraphServiceClient
+                                    .SharePointAPI(mockWebUrl)
+                                    .SitePages[mockPagename]
+                                    .Versions
+                                    .Request()
+                                    .GetAsync();
+
+
+        var actual = response.CurrentPage;
+
+        //// ASSERT
+        Assert.IsAssignableFrom<IList<SitePageVersion>>(actual);
+        Assert.Equal(3, actual.Count);
+
+        var testVersion = actual[1];
+        Assert.Equal(new DateTime(2023, 2, 20, 21, 33, 6), testVersion.Created);
+        Assert.True(testVersion.IsCurrentVersion);
+        Assert.Equal(27887, testVersion.Size);
+        Assert.Equal("2.0", testVersion.VersionLabel);
+
+
+      }
+    }
   }
 }