Merge pull request #487 from notion-dotnet/477-add-support-for-create-file-upload

Add support for create file upload API endpoint

Author: KoditkarVedant

Src/Notion.Client/Api/ApiEndpoints.cs

@@ -139,5 +139,10 @@ public static class AuthenticationUrls
             public static string IntrospectToken() => "/v1/oauth/introspect";
             public static string RefreshToken() => "/v1/oauth/token";
         }
+
+        public static class FileUploadsApiUrls
+        {
+            public static string Create() => "/v1/file_uploads";
+        }
     }
 }

Src/Notion.Client/Api/FileUploads/Create/FileUploadsClient.cs

@@ -0,0 +1,27 @@
+using System;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace Notion.Client
+{
+    public sealed partial class FileUploadsClient : IFileUploadsClient
+    {
+        public async Task<CreateFileUploadResponse> CreateAsync(
+            CreateFileUploadRequest fileUploadObjectRequest,
+            CancellationToken cancellationToken = default)
+        {
+            if (fileUploadObjectRequest == null)
+            {
+                throw new ArgumentNullException(nameof(fileUploadObjectRequest));
+            }
+
+            ICreateFileUploadBodyParameters body = fileUploadObjectRequest;
+
+            return await _restClient.PostAsync<CreateFileUploadResponse>(
+                ApiEndpoints.FileUploadsApiUrls.Create(),
+                body,
+                cancellationToken: cancellationToken
+            );
+        }
+    }
+}

Src/Notion.Client/Api/FileUploads/Create/Request/CreateFileUploadRequest.cs

@@ -0,0 +1,15 @@
+namespace Notion.Client
+{
+    public class CreateFileUploadRequest : ICreateFileUploadBodyParameters
+    {
+        public FileUploadMode Mode { get; set; }
+
+        public string Filename { get; set; }
+
+        public string ContentType { get; set; }
+
+        public int? NumberOfParts { get; set; }
+
+        public string ExternalUrl { get; set; }
+    }
+}

Src/Notion.Client/Api/FileUploads/Create/Request/FileUploadMode.cs

@@ -0,0 +1,16 @@
+using System.Runtime.Serialization;
+
+namespace Notion.Client
+{
+    public enum FileUploadMode
+    {
+        [EnumMember(Value = "single_part")]
+        SinglePart,
+
+        [EnumMember(Value = "multi_part")]
+        MultiPart,
+
+        [EnumMember(Value = "external_url")]
+        ExternalUrl
+    }
+}

Src/Notion.Client/Api/FileUploads/Create/Request/ICreateFileUploadBodyParameters.cs

@@ -0,0 +1,45 @@
+using Newtonsoft.Json;
+using Newtonsoft.Json.Converters;
+
+namespace Notion.Client
+{
+    public interface ICreateFileUploadBodyParameters
+    {
+        /// <summary>
+        /// How the file is being sent. Use multi_part for files larger than 20MB. 
+        /// Use external_url for files that are temporarily hosted publicly elsewhere. 
+        /// Default is single_part.
+        /// </summary>
+        [JsonProperty("mode")]
+        [JsonConverter(typeof(StringEnumConverter))]
+        FileUploadMode Mode { get; }
+
+        /// <summary>
+        /// Name of the file to be created. Required when mode is multi_part or external_url. 
+        /// Otherwise optional, and used to override the filename. Must include an extension, or have one inferred 
+        /// from the content_type parameter.
+        /// </summary>
+        [JsonProperty("filename")]
+        string Filename { get; }
+
+        /// <summary>
+        /// MIME type of the file to be created. Recommended when sending the file in multiple parts. 
+        /// Must match the content type of the file that's sent, and the extension of the filename parameter if any.
+        /// </summary>
+        [JsonProperty("content_type")]
+        string ContentType { get; }
+
+        /// <summary>
+        /// When mode is multi_part, the number of parts you are uploading. 
+        /// Must be between 1 and 1,000. This must match the number of parts as well as the final part_number you send.
+        /// </summary>
+        [JsonProperty("number_of_parts")]
+        int? NumberOfParts { get; }
+
+        /// <summary>
+        /// When mode is external_url, provide the HTTPS URL of a publicly accessible file to import into your workspace.
+        /// </summary>
+        [JsonProperty("external_url")]
+        string ExternalUrl { get; }
+    }
+}

Src/Notion.Client/Api/FileUploads/Create/Response/CreateFileUploadResponse.cs

@@ -0,0 +1,6 @@
+namespace Notion.Client
+{
+    public class CreateFileUploadResponse : FileObjectResponse
+    {
+    }
+}

Src/Notion.Client/Api/FileUploads/FileUploadObjectResponse/FileImportError.cs

@@ -0,0 +1,22 @@
+using Newtonsoft.Json;
+
+namespace Notion.Client
+{
+    public class FileImportError
+    {
+        [JsonProperty("type")]
+        public string Type { get; set; }
+
+        [JsonProperty("code")]
+        public string Code { get; set; }
+
+        [JsonProperty("message")]
+        public string Message { get; set; }
+
+        [JsonProperty("parameter")]
+        public string Parameter { get; set; }
+
+        [JsonProperty("status_code")]
+        public int? StatusCode { get; set; }
+    }
+}

Src/Notion.Client/Api/FileUploads/FileUploadObjectResponse/FileImportErrorResult.cs

@@ -0,0 +1,12 @@
+using Newtonsoft.Json;
+
+namespace Notion.Client
+{
+    public class FileImportErrorResult : FileImportResult
+    {
+        public override string Type => "error";
+
+        [JsonProperty("error")]
+        public FileImportError Error { get; set; }
+    }
+}

Src/Notion.Client/Api/FileUploads/FileUploadObjectResponse/FileImportResult.cs

@@ -0,0 +1,21 @@
+using System;
+using JsonSubTypes;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Converters;
+
+namespace Notion.Client
+{
+    [JsonConverter(typeof(JsonSubtypes), "type")]
+    [JsonSubtypes.KnownSubTypeAttribute(typeof(FileImportSuccessResult), "success")]
+    [JsonSubtypes.KnownSubTypeAttribute(typeof(FileImportErrorResult), "error")]
+    [JsonSubtypes.FallBackSubTypeAttribute(typeof(FileImportResult))]
+    public abstract class FileImportResult
+    {
+        [JsonProperty("type")]
+        public virtual string Type { get; set; }
+
+        [JsonProperty("imported_time")]
+        [JsonConverter(typeof(IsoDateTimeConverter))]
+        public DateTime ImportedTime { get; set; }
+    }
+}

Src/Notion.Client/Api/FileUploads/FileUploadObjectResponse/FileImportSuccessResult.cs

@@ -0,0 +1,13 @@
+using System.Collections.Generic;
+using Newtonsoft.Json;
+
+namespace Notion.Client
+{
+    public class FileImportSuccessResult : FileImportResult
+    {
+        public override string Type => "success";
+
+        [JsonProperty("success")]
+        public Dictionary<string, object> Success { get; set; }
+    }
+}