Add CreateFolder operation (#26)

src/types.rs

@@ -9,6 +9,7 @@ pub use common::*;
 pub use operations::*;
 pub mod soap;
 
+pub mod create_folder;
 pub mod create_item;
 pub mod delete_item;
 pub mod delete_folder;

src/types/common.rs

@@ -814,45 +814,48 @@ pub struct ItemId {
 }
 
 /// The representation of a folder in an EWS operation.
-#[derive(Clone, Debug, Deserialize)]
+#[derive(Clone, Debug, Deserialize, XmlSerialize)]
 pub enum Folder {
     /// A calendar folder in a mailbox.
     ///
     /// See <https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/calendarfolder>
     #[serde(rename_all = "PascalCase")]
     CalendarFolder {
-        folder_id: FolderId,
+        folder_id: Option<FolderId>,
         parent_folder_id: Option<FolderId>,
         folder_class: Option<String>,
         display_name: Option<String>,
         total_count: Option<u32>,
         child_folder_count: Option<u32>,
+        extended_property: Option<Vec<ExtendedProperty>>,
     },
 
     /// A contacts folder in a mailbox.
     ///
     /// See <https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/contactsfolder>
     #[serde(rename_all = "PascalCase")]
     ContactsFolder {
-        folder_id: FolderId,
+        folder_id: Option<FolderId>,
         parent_folder_id: Option<FolderId>,
         folder_class: Option<String>,
         display_name: Option<String>,
         total_count: Option<u32>,
         child_folder_count: Option<u32>,
+        extended_property: Option<Vec<ExtendedProperty>>,
     },
 
     /// A folder in a mailbox.
     ///
     /// See <https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/folder>
     #[serde(rename_all = "PascalCase")]
     Folder {
-        folder_id: FolderId,
+        folder_id: Option<FolderId>,
         parent_folder_id: Option<FolderId>,
         folder_class: Option<String>,
         display_name: Option<String>,
         total_count: Option<u32>,
         child_folder_count: Option<u32>,
+        extended_property: Option<Vec<ExtendedProperty>>,
         unread_count: Option<u32>,
     },
 
@@ -861,25 +864,27 @@ pub enum Folder {
     /// See <https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/searchfolder>
     #[serde(rename_all = "PascalCase")]
     SearchFolder {
-        folder_id: FolderId,
+        folder_id: Option<FolderId>,
         parent_folder_id: Option<FolderId>,
         folder_class: Option<String>,
         display_name: Option<String>,
         total_count: Option<u32>,
         child_folder_count: Option<u32>,
+        extended_property: Option<Vec<ExtendedProperty>>,
     },
 
     /// A task folder in a mailbox.
     ///
     /// See <https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/tasksfolder>
     #[serde(rename_all = "PascalCase")]
     TasksFolder {
-        folder_id: FolderId,
+        folder_id: Option<FolderId>,
         parent_folder_id: Option<FolderId>,
         folder_class: Option<String>,
         display_name: Option<String>,
         total_count: Option<u32>,
         child_folder_count: Option<u32>,
+        extended_property: Option<Vec<ExtendedProperty>>,
     },
 }
 
@@ -996,7 +1001,7 @@ pub struct Message {
     #[xml_struct(ns_prefix = "t")]
     pub categories: Option<Vec<StringElement>>,
 
-    // Extended MAPI properties to set on the message.
+    // Extended MAPI properties of the message.
     #[xml_struct(ns_prefix = "t")]
     pub extended_property: Option<Vec<ExtendedProperty>>,
 
@@ -1109,7 +1114,7 @@ pub struct Message {
     pub conversation_id: Option<ItemId>,
 }
 
-/// An extended MAPI property to set on the message.
+/// An extended MAPI property of an Exchange item or folder.
 ///
 /// See <https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/extendedproperty>
 #[allow(non_snake_case)]

src/types/create_folder.rs

@@ -0,0 +1,69 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+use serde::Deserialize;
+use xml_struct::XmlSerialize;
+
+use crate::{
+    types::sealed::EnvelopeBodyContents, BaseFolderId, Folder, Operation, OperationResponse,
+    ResponseClass, ResponseCode, MESSAGES_NS_URI,
+};
+
+/// A request to create a new folder.
+///
+/// See <https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/createfolder>
+#[derive(Clone, Debug, XmlSerialize)]
+#[xml_struct(default_ns = MESSAGES_NS_URI)]
+pub struct CreateFolder {
+    pub parent_folder_id: BaseFolderId,
+    pub folders: Vec<Folder>,
+}
+
+impl Operation for CreateFolder {
+    type Response = CreateFolderResponse;
+}
+
+impl EnvelopeBodyContents for CreateFolder {
+    fn name() -> &'static str {
+        "CreateFolder"
+    }
+}
+
+/// A response to a [`CreateFolder`] request.
+///
+/// See <https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/createfolderresponse>
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "PascalCase")]
+pub struct CreateFolderResponse {
+    pub response_messages: ResponseMessages,
+}
+
+impl OperationResponse for CreateFolderResponse {}
+
+impl EnvelopeBodyContents for CreateFolderResponse {
+    fn name() -> &'static str {
+        "CreateFolderResponse"
+    }
+}
+
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "PascalCase")]
+pub struct ResponseMessages {
+    pub create_folder_response_message: Vec<CreateFolderResponseMessage>,
+}
+
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "PascalCase")]
+pub struct CreateFolderResponseMessage {
+    /// The status of the corresponding request, i.e. whether it succeeded or
+    /// resulted in an error.
+    #[serde(rename = "@ResponseClass")]
+    pub response_class: ResponseClass,
+
+    pub response_code: Option<ResponseCode>,
+
+    pub message_text: Option<String>,
+
+    pub folders: Vec<Folder>,
+}