opendal 0.1.6.pre.rc.1

data/core/src/services/onedrive/delete.rs

@@ -0,0 +1,47 @@
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+use std::sync::Arc;
+
+use http::StatusCode;
+
+use super::core::OneDriveCore;
+use super::error::parse_error;
+use crate::raw::*;
+use crate::*;
+
+/// Delete operation
+/// Documentation: https://learn.microsoft.com/en-us/onedrive/developer/rest-api/api/driveitem_delete?view=odsp-graph-online
+pub struct OneDriveDeleter {
+    core: Arc<OneDriveCore>,
+}
+
+impl OneDriveDeleter {
+    pub fn new(core: Arc<OneDriveCore>) -> Self {
+        Self { core }
+    }
+}
+
+impl oio::OneShotDelete for OneDriveDeleter {
+    async fn delete_once(&self, path: String, _: OpDelete) -> Result<()> {
+        let response = self.core.onedrive_delete(&path).await?;
+        match response.status() {
+            StatusCode::NO_CONTENT | StatusCode::NOT_FOUND => Ok(()),
+            _ => Err(parse_error(response)),
+        }
+    }
+}

data/core/src/services/onedrive/docs.md

@@ -0,0 +1,115 @@
+## Capabilities
+
+This service can be used to:
+
+- [x] stat
+- [x] read
+- [x] write
+- [ ] append
+- [x] create_dir
+- [x] delete
+- [x] copy
+- [x] rename
+- [x] list
+- [ ] presign
+- [ ] blocking
+
+## Notes
+
+Currently, OpenDAL supports OneDrive Personal only.
+
+### Write Operations and OneDrive Behavior
+
+For write-related operations, such as:
+
+- write
+- rename
+- copy
+- create_dir
+
+OpenDAL's OneDrive service replaces the destination folder instead of rename it.
+
+### Consistency Issues with Concurrent Requests
+
+OneDrive does not guarantee consistency when handling a large number of concurrent requests write operations.
+
+In some extreme cases, OneDrive may acknowledge an operation as successful but fail to commit the changes.
+This inconsistency can cause subsequent operations to fail, returning errors like:
+
+- 400 Bad Request: OneDrive considers folders in the path are not there yet
+- 404 Not Found: OneDrive doesn't recognize the created folder
+- 409 Conflict: OneDrive can't replace an existing folder
+
+You should consider [`RetryLayer`] and monitor your operations carefully.
+
+## Configuration
+
+- `access_token`: Set a short-live access token for Microsoft Graph API (also, OneDrive API)
+- `refresh_token`: Set a long term access token for Microsoft Graph API
+- `client_id`: Set the client ID for a Microsoft Graph API application (available though Azure's registration portal)
+- `client_secret`: Set the client secret for a Microsoft Graph API application
+- `root`: Set the work directory for OneDrive backend
+- `enable_versioning`: Enable versioning support for OneDrive items
+
+The configuration for tokens is one of the following:
+* `access_token` only, for short-lived access. Once the `access_token` expires, you must recreate the operator with a new token.
+* `refresh_token`, `client_id`, and an optional `client_secret`, for long-lived access. The operator will automatically get and refresh the access token.
+
+## How to get tokens
+
+1. Create an application: navigate to [Microsoft Entra Admin Center](https://entra.microsoft.com/) -> Applications -> App Registrations -> New registration
+2. In "Supported account types", choose "Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox)"
+3. Or in an existing application -> manifest, make sure `signInAudience` is `"AzureADandPersonalMicrosoftAccount"`. That's because we're calling Graph API with `/common` path segment.
+4. The platform you choose determines whether you have to provide a `client_secret` or not. See [Public and confidential client apps](https://learn.microsoft.com/en-us/entra/identity-platform/msal-client-applications) for more information.
+    1. In short, if you choose "Mobile and desktop applications" or "Single-page application" (Public Client), you must not provide `client_secret`.
+    2. If you choose "Web" (Confidential Client), create a secret in "Certificates & secrets -> Client secrets -> New client secret", and provide it as `client_secret`.
+5. Follow the [code grant flow](https://learn.microsoft.com/en-us/entra/identity-platform/v2-oauth2-auth-code-flow) or other flows to get the access_token. The minimum scope is `Files.ReadWrite`. And make sure the access token represents a user, because it's accessing the user's onedrive by `/me/drive`. So "client credentials flow" won't work.
+6. If you need `refresh_token` for long-lived access, add an additional `offline_access` scope.
+
+Read more at [`OnedriveBuilder`].
+
+## Example
+
+### Via Builder
+
+When you have a current access token: 
+
+```rust,no_run
+use anyhow::Result;
+use opendal::services::Onedrive;
+use opendal::Operator;
+
+#[tokio::main]
+async fn main() -> Result<()> {
+    // create backend builder
+    let mut builder = Onedrive::default()
+        .access_token("my_access_token")
+        .root("/root/folder/for/operator");
+
+    let op: Operator = Operator::new(builder)?.finish();
+    Ok(())
+}
+```
+
+When you have an Application with a refresh token:
+
+```rust,no_run
+use anyhow::Result;
+use opendal::services::Onedrive;
+use opendal::Operator;
+
+#[tokio::main]
+async fn main() -> Result<()> {
+    // create backend builder
+    let mut builder = Onedrive::default()
+        .refresh_token("my_refresh_token")
+        .client_id("my_client_id")
+        .root("/root/folder/for/operator");
+
+    let op: Operator = Operator::new(builder)?.finish();
+    Ok(())
+}
+```
+
+
+[conflict-behavior]: https://learn.microsoft.com/en-us/graph/api/resources/driveitem?view=graph-rest-1.0#instance-attributes

data/core/src/services/onedrive/error.rs

@@ -0,0 +1,61 @@
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+use http::Response;
+use http::StatusCode;
+
+use crate::raw::*;
+use crate::*;
+
+/// Parse error response into Error.
+pub(super) fn parse_error(response: Response<Buffer>) -> Error {
+    let (parts, body) = response.into_parts();
+    let bs = body.to_bytes();
+
+    let (kind, retryable) = match parts.status {
+        StatusCode::NOT_FOUND => (ErrorKind::NotFound, false),
+        // The OneDrive service replaces resources.
+        // However, the Onedrive doesn't have Strong Read-After-Write properties,
+        // the concurrent requests to create directories might result in errors.
+        //
+        // Running behavior tests can yield HTTP 409 Conflict because of the consistency guarantee.
+        //
+        // Read more about `REPLACE_EXISTING_ITEM_WHEN_CONFLICT` in `graph_model.rs`.
+        StatusCode::CONFLICT => (ErrorKind::AlreadyExists, true),
+        StatusCode::FORBIDDEN => (ErrorKind::PermissionDenied, false),
+        StatusCode::INTERNAL_SERVER_ERROR
+        | StatusCode::BAD_GATEWAY
+        | StatusCode::SERVICE_UNAVAILABLE
+        | StatusCode::GATEWAY_TIMEOUT => (ErrorKind::Unexpected, true),
+        StatusCode::NOT_MODIFIED | StatusCode::PRECONDITION_FAILED => {
+            (ErrorKind::ConditionNotMatch, false)
+        }
+        _ => (ErrorKind::Unexpected, false),
+    };
+
+    let message = String::from_utf8_lossy(&bs);
+
+    let mut err = Error::new(kind, message);
+
+    err = with_error_response_context(err, parts);
+
+    if retryable {
+        err = err.set_temporary();
+    }
+
+    err
+}

data/core/src/services/onedrive/graph_model.rs

@@ -0,0 +1,425 @@
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+use serde::Deserialize;
+use serde::Serialize;
+
+#[derive(Debug, Deserialize)]
+pub struct GraphOAuthRefreshTokenResponseBody {
+    pub access_token: String,
+    pub refresh_token: String,
+    pub expires_in: i64, // in seconds
+}
+
+/// We `$select` some fields when sending GET requests.
+/// Please keep [`OneDriveItem`] fields and this variable in sync.
+/// Read more at https://learn.microsoft.com/en-us/graph/query-parameters?tabs=http#select-parameter
+pub const GENERAL_SELECT_PARAM: &str =
+    "$select=id,name,lastModifiedDateTime,eTag,size,parentReference,folder,file";
+
+/// We `$select` some fields when listing versions.
+/// Please keep [`OneDriveItemVersion`] fields and this variable in sync.
+/// Read more at https://learn.microsoft.com/en-us/graph/query-parameters?tabs=http#select-parameter
+pub const VERSION_SELECT_PARAM: &str = "$select=id,size,lastModifiedDateTime";
+
+#[derive(Debug, Serialize, Deserialize)]
+pub struct GraphApiOneDriveListResponse {
+    #[serde(rename = "@odata.nextLink")]
+    pub next_link: Option<String>,
+    pub value: Vec<OneDriveItem>,
+}
+
+/// A `DriveItem`
+/// read more at https://learn.microsoft.com/en-us/onedrive/developer/rest-api/resources/driveitem
+#[derive(Debug, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct OneDriveItem {
+    pub id: String,
+    pub name: String,
+    pub last_modified_date_time: String,
+    pub e_tag: String,
+    pub size: i64,
+    pub parent_reference: ParentReference,
+    #[serde(flatten)]
+    pub item_type: ItemType,
+    pub versions: Option<Vec<OneDriveItemVersion>>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct ParentReference {
+    pub path: String,
+    pub drive_id: String,
+    pub id: String,
+}
+
+/// Additional properties when represents a facet of a "DriveItem":
+/// - "file", read more at https://learn.microsoft.com/en-us/onedrive/developer/rest-api/resources/file
+/// - "folder", read more at https://learn.microsoft.com/en-us/onedrive/developer/rest-api/resources/folder
+#[derive(Debug, Serialize, Deserialize, PartialEq, Clone)]
+#[serde(untagged)]
+pub enum ItemType {
+    Folder { folder: Folder },
+    File { file: File },
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
+#[serde(rename_all = "camelCase")]
+pub struct File {
+    mime_type: String,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
+#[serde(rename_all = "camelCase")]
+pub struct Folder {
+    child_count: i32,
+}
+
+#[derive(Debug, Serialize, Deserialize)]
+pub struct GraphApiOneDriveVersionsResponse {
+    pub value: Vec<OneDriveItemVersion>,
+}
+
+/// A `driveItemVersion`
+///
+/// Read more at https://learn.microsoft.com/en-us/graph/api/resources/driveitemversion
+#[derive(Debug, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct OneDriveItemVersion {
+    pub id: String,
+    pub last_modified_date_time: String,
+    pub size: i64,
+}
+
+// Microsoft's documentation wants developers to set this as URL parameters. Some APIs use
+// this as an data field in the payload.
+pub const REPLACE_EXISTING_ITEM_WHEN_CONFLICT: &str = "replace";
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct CreateDirPayload {
+    #[serde(rename = "@microsoft.graph.conflictBehavior")]
+    conflict_behavior: String,
+    name: String,
+    folder: EmptyStruct,
+}
+
+impl CreateDirPayload {
+    pub fn new(name: String) -> Self {
+        Self {
+            conflict_behavior: REPLACE_EXISTING_ITEM_WHEN_CONFLICT.to_string(),
+            name,
+            folder: EmptyStruct {},
+        }
+    }
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+struct EmptyStruct {}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+struct FileUploadItem {
+    #[serde(rename = "@microsoft.graph.conflictBehavior")]
+    conflict_behavior: String,
+    name: String,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct OneDriveUploadSessionCreationResponseBody {
+    pub upload_url: String,
+    pub expiration_date_time: String,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct OneDriveUploadSessionCreationRequestBody {
+    item: FileUploadItem,
+}
+
+impl OneDriveUploadSessionCreationRequestBody {
+    pub fn new(path: String) -> Self {
+        OneDriveUploadSessionCreationRequestBody {
+            item: FileUploadItem {
+                conflict_behavior: REPLACE_EXISTING_ITEM_WHEN_CONFLICT.to_string(),
+                name: path,
+            },
+        }
+    }
+}
+
+/// represents copy and rename (update) operations
+#[derive(Debug, Clone, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct OneDrivePatchRequestBody {
+    pub parent_reference: ParentReference,
+    pub name: String,
+}
+
+#[derive(Debug, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct OneDriveMonitorStatus {
+    pub percentage_complete: f64, // useful for debugging
+    pub status: String,
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn test_parse_one_drive_list_response_json() {
+        let data = r#"{
+            "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('opendal@outlook.com')/drive/root/children(id,name,lastModifiedDateTime,eTag,size,parentReference,folder,file)",
+            "value": [
+                {
+                    "@odata.etag": "\"{3B131E1C-7D81-20AF-80D0-450D00000000},10\"",
+                    "eTag": "\"{3B131E1C-7D81-20AF-80D0-450D00000000},10\"",
+                    "id": "A0AA0A000A000A0A!3397",
+                    "lastModifiedDateTime": "2025-02-23T11:45:26Z",
+                    "name": "empty_folder",
+                    "size": 0,
+                    "parentReference": {
+                        "driveType": "personal",
+                        "driveId": "A0AA0A000A000A0A",
+                        "id": "A0AA0A000A000A0A!sea8cc6beffdb43d7976fbc7da445c639",
+                        "name": "Documents",
+                        "path": "/drive/root:",
+                        "siteId": "5f1f11f3-a6b4-4414-aee0-215c774f80db"
+                    },
+                    "folder": {
+                        "childCount": 0,
+                        "view": {
+                            "sortBy": "name",
+                            "sortOrder": "ascending",
+                            "viewType": "thumbnails"
+                        }
+                    }
+                },
+                {
+                    "@odata.etag": "\"{3B131E1C-7D81-20AF-80D0-710000000000},6\"",
+                    "eTag": "\"{3B131E1C-7D81-20AF-80D0-710000000000},6\"",
+                    "id": "A0AA0A000A000A0A!113",
+                    "lastModifiedDateTime": "2025-02-16T19:48:39Z",
+                    "name": "folder_a",
+                    "size": 10560537,
+                    "parentReference": {
+                        "driveType": "personal",
+                        "driveId": "A0AA0A000A000A0A",
+                        "id": "A0AA0A000A000A0A!sea8cc6beffdb43d7976fbc7da445c639",
+                        "name": "Documents",
+                        "path": "/drive/root:",
+                        "siteId": "5f1f11f3-a6b4-4414-aee0-215c774f80db"
+                    },
+                    "folder": {
+                        "childCount": 5,
+                        "view": {
+                            "sortBy": "name",
+                            "sortOrder": "ascending",
+                            "viewType": "thumbnails"
+                        }
+                    }
+                }
+            ]
+        }"#;
+
+        let response: GraphApiOneDriveListResponse = serde_json::from_str(data).unwrap();
+        assert_eq!(response.value.len(), 2);
+        let item = &response.value[0];
+        assert_eq!(item.name, "empty_folder");
+        assert_eq!(item.last_modified_date_time, "2025-02-23T11:45:26Z");
+        assert_eq!(item.e_tag, "\"{3B131E1C-7D81-20AF-80D0-450D00000000},10\"");
+        assert_eq!(item.size, 0);
+        assert_eq!(item.parent_reference.path, "/drive/root:");
+        if let ItemType::Folder { folder, .. } = &item.item_type {
+            assert_eq!(folder.child_count, 0);
+        } else {
+            panic!("item_type is not a folder");
+        }
+    }
+
+    #[test]
+    fn test_parse_one_drive_list_response_with_next_link_json() {
+        let response_json = r#"{
+            "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('opendal@outlook.com')/drive/root/children(id,name,lastModifiedDateTime,eTag,size,parentReference,folder,file)",
+            "@odata.nextLink": "https://graph.microsoft.com/v1.0/me/drive/root/children?$select=id%2cname%2clastModifiedDateTime%2ceTag%2csize%2cparentReference%2cfolder%2cfile&$top=2&$skiptoken=UGFnZWQ9VFJVRSZwX1NvcnRCZWhhdmlvcj0xJnBfRmlsZUxlYWZSZWY9Zm9sZGVyX2EmcF9JRD03MDAz",
+            "value": [
+                {
+                    "@odata.etag": "\"{3B131E1C-7D81-20AF-80D0-450D00000000},10\"",
+                    "eTag": "\"{3B131E1C-7D81-20AF-80D0-450D00000000},10\"",
+                    "id": "A0AA0A000A000A0A!3397",
+                    "lastModifiedDateTime": "2025-02-23T11:45:26Z",
+                    "name": "empty_folder",
+                    "size": 0,
+                    "parentReference": {
+                        "driveType": "personal",
+                        "driveId": "A0AA0A000A000A0A",
+                        "id": "A0AA0A000A000A0A!sea8cc6beffdb43d7976fbc7da445c639",
+                        "name": "Documents",
+                        "path": "/drive/root:",
+                        "siteId": "5f1f11f3-a6b4-4414-aee0-215c774f80db"
+                    },
+                    "folder": {
+                        "childCount": 0,
+                        "view": {
+                            "sortBy": "name",
+                            "sortOrder": "ascending",
+                            "viewType": "thumbnails"
+                        }
+                    }
+                }
+            ]
+        }"#;
+
+        let response: GraphApiOneDriveListResponse = serde_json::from_str(response_json).unwrap();
+        assert_eq!(response.value.len(), 1);
+        let item = &response.value[0];
+        if let ItemType::Folder { folder, .. } = &item.item_type {
+            assert_eq!(folder.child_count, 0);
+        } else {
+            panic!("item_type is not a folder");
+        }
+    }
+
+    #[test]
+    fn test_parse_one_drive_file_json() {
+        let data = r#"{
+            "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('opendal%40outlook.com')/drive/root(id,name,lastModifiedDateTime,eTag,size,parentReference,folder,file)/$entity",
+            "@odata.etag": "\"{3B131E1C-7D81-20AF-80D0-720000000000},2\"",
+            "eTag": "\"{3B131E1C-7D81-20AF-80D0-720000000000},2\"",
+            "id": "A0AA0A000A000A0A!114",
+            "lastModifiedDateTime": "2025-02-16T19:49:05Z",
+            "name": "filename.txt",
+            "size": 3,
+            "parentReference": {
+                "driveType": "personal",
+                "driveId": "A0AA0A000A000A0A",
+                "id": "A0AA0A000A000A0A!113",
+                "name": "folder_a",
+                "path": "/drive/root:/folder_a",
+                "siteId": "5f1f11f3-a6b4-4414-aee0-215c774f80db"
+            },
+            "file": {
+                "mimeType": "text/plain",
+                "hashes": {
+                    "quickXorHash": "79jFLwAAAAAAAAAAAwAAAAAAAAA=",
+                    "sha1Hash": "57218C316B6921E2CD61027A2387EDC31A2D9471",
+                    "sha256Hash": "F1945CD6C19E56B3C1C78943EF5EC18116907A4CA1EFC40A57D48AB1DB7ADFC5"
+                }
+            }
+        }"#;
+
+        let item: OneDriveItem = serde_json::from_str(data).unwrap();
+        assert_eq!(item.name, "filename.txt");
+        assert_eq!(item.last_modified_date_time, "2025-02-16T19:49:05Z");
+        assert_eq!(item.e_tag, "\"{3B131E1C-7D81-20AF-80D0-720000000000},2\"");
+        assert_eq!(item.size, 3);
+        assert_eq!(item.parent_reference.id, "A0AA0A000A000A0A!113");
+        assert!(item.versions.is_none());
+        if let ItemType::File { file, .. } = &item.item_type {
+            assert_eq!(file.mime_type, "text/plain");
+        } else {
+            panic!("item_type is not a file");
+        }
+    }
+
+    #[test]
+    fn test_parse_one_drive_file_with_version_json() {
+        let data = r#"{
+            "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('opendal%40outlook.com')/drive/root(id,name,lastModifiedDateTime,eTag,size,parentReference,folder,file)/$entity",
+            "@odata.etag": "\"{3B131E1C-7D81-20AF-80D0-720000000000},2\"",
+            "eTag": "\"{3B131E1C-7D81-20AF-80D0-720000000000},2\"",
+            "id": "A0AA0A000A000A0A!114",
+            "lastModifiedDateTime": "2025-02-16T19:49:05Z",
+            "name": "filename.txt",
+            "size": 3,
+            "parentReference": {
+                "driveType": "personal",
+                "driveId": "A0AA0A000A000A0A",
+                "id": "A0AA0A000A000A0A!113",
+                "name": "folder_a",
+                "path": "/drive/root:/folder_a",
+                "siteId": "5f1f11f3-a6b4-4414-aee0-215c774f80db"
+            },
+            "file": {
+                "mimeType": "text/plain",
+                "hashes": {
+                    "quickXorHash": "79jFLwAAAAAAAAAAAwAAAAAAAAA=",
+                    "sha1Hash": "57218C316B6921E2CD61027A2387EDC31A2D9471",
+                    "sha256Hash": "F1945CD6C19E56B3C1C78943EF5EC18116907A4CA1EFC40A57D48AB1DB7ADFC5"
+                }
+            },
+            "versions@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('opendal%40outlook.com')/drive/root/versions",
+            "versions": [
+                {
+                    "@microsoft.graph.downloadUrl": "https://my.microsoftpersonalcontent.com/personal/A0AA0A000A000A0A/_layouts/15/download.aspx?UniqueId=3b131e1c-7d81-20af-80d0-720000000000&Translate=false&tempauth=v1e.a&ApiVersion=2.0",
+                    "id": "1.0",
+                    "lastModifiedDateTime": "2025-02-16T19:49:05Z",
+                    "size": 3,
+                    "lastModifiedBy": {
+                        "user": {
+                            "email": "erickgdev@outlook.com",
+                            "displayName": "erickgdev@outlook.com"
+                        }
+                    }
+                }
+            ]
+        }"#;
+
+        let item: OneDriveItem = serde_json::from_str(data).unwrap();
+        let versions = item.versions.expect("Versions present");
+        assert_eq!("1.0", versions[0].id);
+        assert_eq!("2025-02-16T19:49:05Z", versions[0].last_modified_date_time);
+    }
+
+    #[test]
+    fn test_parse_one_drive_monitor_status_json() {
+        let data = r#"{
+            "@odata.context": "https://my.microsoftpersonalcontent.com/personal/A0AA0A000A000A0A/_api/v2.0/$metadata#oneDrive.asynchronousOperationStatus",
+            "percentageComplete": 100.0,
+            "resourceId": "01JP3NYHGSBJ7R42UN65HZ333HZFWQTGL4",
+            "status": "completed"
+        }"#;
+
+        let response: OneDriveMonitorStatus = serde_json::from_str(data).unwrap();
+        assert_eq!(response.status, "completed");
+    }
+
+    #[test]
+    fn test_parse_one_drive_item_versions_json() {
+        let data = r#"{
+            "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('erickgdev%40outlook.com')/drive/root/versions(id,size,lastModifiedDateTime)",
+            "value": [
+                {
+                    "id": "2.0",
+                    "lastModifiedDateTime": "2025-03-16T17:02:49Z",
+                    "size": 74758
+                },
+                {
+                    "id": "1.0",
+                    "lastModifiedDateTime": "2025-03-12T21:59:54Z",
+                    "size": 74756
+                }
+            ]
+        }"#;
+
+        let response: GraphApiOneDriveVersionsResponse = serde_json::from_str(data).unwrap();
+        assert_eq!(response.value.len(), 2);
+        let version = &response.value[0];
+        assert_eq!(version.id, "2.0");
+        assert_eq!(version.last_modified_date_time, "2025-03-16T17:02:49Z");
+        assert_eq!(version.size, 74758);
+    }
+}