Created UpdateItem and added necessary trait implementations

src/types.rs

@@ -14,3 +14,4 @@ pub mod get_folder;
 pub mod get_item;
 pub mod sync_folder_hierarchy;
 pub mod sync_folder_items;
+pub mod update_item;

src/types/common.rs

@@ -177,6 +177,18 @@ pub enum DistinguishedPropertySet {
     UnifiedMessaging,
 }
 
+/// The action an Exchange server will take upon creating a `Message` item.
+///
+/// See <https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/createitem#messagedisposition-attribute>
+/// and <https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/updateitem#messagedisposition-attribute>
+#[derive(Clone, Copy, Debug, XmlSerialize)]
+#[xml_struct(text)]
+pub enum MessageDisposition {
+    SaveOnly,
+    SendOnly,
+    SendAndSaveCopy,
+}
+
 /// The type of the value of a MAPI property.
 ///
 /// See <https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/extendedfielduri#propertytype-attribute>
@@ -315,7 +327,7 @@ pub enum BaseItemId {
 /// The unique identifier of an item.
 ///
 /// See <https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/itemid>
-#[derive(Clone, Debug, Deserialize, XmlSerialize, PartialEq)]
+#[derive(Clone, Default, Debug, Deserialize, XmlSerialize, PartialEq)]
 pub struct ItemId {
     #[xml_struct(attribute)]
     #[serde(rename = "@Id")]
@@ -458,7 +470,7 @@ impl XmlSerialize for DateTime {
 /// An email message.
 ///
 /// See <https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/message-ex15websvcsotherref>
-#[derive(Clone, Debug, Deserialize)]
+#[derive(Clone, Debug, Default, Deserialize, XmlSerialize)]
 #[serde(rename_all = "PascalCase")]
 pub struct Message {
     /// The MIME content of the item.

src/types/create_item.rs

@@ -7,20 +7,10 @@ use xml_struct::XmlSerialize;
 
 use crate::{
     types::sealed::EnvelopeBodyContents, ArrayOfRecipients, BaseFolderId, ExtendedFieldURI, Items,
-    MimeContent, Operation, OperationResponse, ResponseClass, ResponseCode, MESSAGES_NS_URI,
+    MessageDisposition, MimeContent, Operation, OperationResponse, ResponseClass, ResponseCode,
+    MESSAGES_NS_URI,
 };
 
-/// The action an Exchange server will take upon creating a `Message` item.
-///
-/// See <https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/createitem#messagedisposition-attribute>
-#[derive(Clone, Debug, XmlSerialize)]
-#[xml_struct(text)]
-pub enum MessageDisposition {
-    SaveOnly,
-    SendOnly,
-    SendAndSaveCopy,
-}
-
 /// A request to create (and optionally send) one or more Exchange item(s).
 ///
 /// See <https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/createitem>

src/types/update_item.rs

@@ -0,0 +1,142 @@
+/* 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 crate::types::common::{BaseItemId, Message, MessageDisposition, PathToElement};
+use crate::{
+    types::sealed::EnvelopeBodyContents, Items, Operation, OperationResponse, ResponseClass,
+    ResponseCode,
+};
+use serde::Deserialize;
+use xml_struct::XmlSerialize;
+
+/// The method used by the Exchange server to resolve conflicts between item
+/// updates.
+///
+/// See <https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/updateitem#conflictresolution-attribute>
+#[derive(Clone, Copy, Debug, Default, XmlSerialize)]
+#[xml_struct(text)]
+pub enum ConflictResolution {
+    NeverOverwrite,
+
+    #[default]
+    AutoResolve,
+
+    AlwaysOverwrite,
+}
+
+/// Represents a change to an individual item, including the item ID and updates.
+///
+/// See <https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/itemchange>
+#[derive(Clone, Debug, XmlSerialize)]
+pub struct ItemChange {
+    pub item_id: BaseItemId, // Represents the <t:ItemId> element with Id and ChangeKey.
+
+    pub updates: Updates, // Represents the <t:Updates> element containing the changes.
+}
+
+/// Represents a list of item changes without an explicit container tag.
+///
+/// See <https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/itemchanges>
+#[derive(Clone, Debug, XmlSerialize)]
+pub struct ItemChanges {
+    pub item_changes: Vec<ItemChange>,
+}
+
+/// Struct representing the field update operation.
+///
+/// This struct contains details of the field that needs to be updated.
+/// See <https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/setitemfield>
+#[derive(Clone, Debug, XmlSerialize)]
+pub struct SetItemField {
+    pub field_uri: PathToElement, // Reference to the field being updated.
+    pub message: Message,         // The new value for the specified field.
+}
+
+/// Struct representing updates to be applied to an item.
+///
+/// This struct is used to create an UpdateItem request.
+/// See <https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/updates-item>
+#[derive(Clone, Debug, XmlSerialize)]
+pub struct Updates {
+    pub set_item_field: SetItemField,
+}
+
+/// Represents the UpdateItem operation for interacting with the EWS server.
+#[derive(Clone, Debug, XmlSerialize)]
+pub struct UpdateItem {
+    /// Describes how the item will be handled after it is updated.
+    /// The MessageDisposition attribute is required for message items, including meeting
+    /// messages such as meeting cancellations, meeting requests, and meeting responses.
+    ///
+    /// See <https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/updateitem#messagedisposition-attribute>
+    #[xml_struct(attribute)]
+    pub message_disposition: Option<MessageDisposition>,
+
+    /// Identifies the type of conflict resolution to try during an update.
+    /// The default value is AutoResolve.
+    ///
+    /// See <https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/updateitem#conflictresolution-attribute>
+    #[xml_struct(attribute)]
+    pub conflict_resolution: Option<ConflictResolution>,
+
+    /// Contains an array of ItemChange elements that identify items and
+    /// the updates to apply to the items.
+    ///
+    /// See <https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/itemchanges>
+    pub item_changes: ItemChanges, // Represents the list of item changes to be included in the request.
+}
+
+impl UpdateItem {
+    /// Adds another `ItemChange` to the `UpdateItem` request.
+    pub fn add_item_change(&mut self, item_change: ItemChange) {
+        self.item_changes.item_changes.push(item_change);
+    }
+}
+
+impl Operation for UpdateItem {
+    type Response = UpdateItemResponse;
+}
+
+impl EnvelopeBodyContents for UpdateItem {
+    fn name() -> &'static str {
+        "UpdateItem"
+    }
+}
+
+/// A response to an [`UpdateItem`] request.
+///
+/// See <https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/updateitemresponse>
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "PascalCase")]
+pub struct UpdateItemResponse {
+    pub response_messages: ResponseMessages,
+}
+
+impl OperationResponse for UpdateItemResponse {}
+
+impl EnvelopeBodyContents for UpdateItemResponse {
+    fn name() -> &'static str {
+        "UpdateItemResponse"
+    }
+}
+
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "PascalCase")]
+pub struct ResponseMessages {
+    pub update_item_response_message: Vec<UpdateItemResponseMessage>,
+}
+
+#[derive(Clone, Debug, Deserialize)]
+#[serde(rename_all = "PascalCase")]
+pub struct UpdateItemResponseMessage {
+    /// The status of the corresponding request, i.e. whether it succeeded or
+    /// resulted in an error.
+    pub response_class: ResponseClass,
+
+    pub response_code: Option<ResponseCode>,
+
+    pub message_text: Option<String>,
+
+    pub items: Items,
+}