Merge remote-tracking branch 'origin/master' into release

Author: dynabic-billing-team

README.md

@@ -27,7 +27,7 @@ Add this dependency to your *pubspec.yaml*:
 
 ```yaml
 dependencies:
-  aspose_words_cloud: 25.9.0
+  aspose_words_cloud: 25.10.0
 ```
 
 ## Getting Started

lib/aspose_words_cloud.dart

@@ -582,6 +582,7 @@ export 'src/requests/insert_watermark_request.dart';
 export 'src/requests/insert_watermark_text_online_request.dart';
 export 'src/requests/insert_watermark_text_request.dart';
 export 'src/requests/link_header_footers_to_previous_request.dart';
+export 'src/requests/load_web_document_online_request.dart';
 export 'src/requests/load_web_document_request.dart';
 export 'src/requests/merge_with_next_online_request.dart';
 export 'src/requests/merge_with_next_request.dart';
@@ -706,6 +707,7 @@ export 'src/responses/insert_table_row_online_response.dart';
 export 'src/responses/insert_watermark_image_online_response.dart';
 export 'src/responses/insert_watermark_online_response.dart';
 export 'src/responses/insert_watermark_text_online_response.dart';
+export 'src/responses/load_web_document_online_response.dart';
 export 'src/responses/protect_document_online_response.dart';
 export 'src/responses/reject_all_revisions_online_response.dart';
 export 'src/responses/remove_all_signatures_online_response.dart';

lib/src/api_client.dart

@@ -518,7 +518,7 @@ class ApiClient {
     }
 
     httpRequest.headers['x-aspose-client'] = 'dart sdk';
-    httpRequest.headers['x-aspose-client-version'] = '25.9';
+    httpRequest.headers['x-aspose-client-version'] = '25.10';
     httpRequest.headers['Authorization'] = await _getAuthToken();
     httpRequest.headers.addAll(requestData.headers);
 

lib/src/requests/load_web_document_online_request.dart

@@ -0,0 +1,89 @@
+/*
+ * --------------------------------------------------------------------------------
+ * <copyright company="Aspose" file="load_web_document_online_request.dart">
+ *   Copyright (c) 2025 Aspose.Words for Cloud
+ * </copyright>
+ * <summary>
+ *   Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ * 
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ * 
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ * </summary>
+ * --------------------------------------------------------------------------------
+ */
+
+library aspose_words_cloud;
+
+import 'dart:typed_data';
+import '../../aspose_words_cloud.dart';
+import '../api_client.dart';
+import '../api_request_data.dart';
+import '../api_request_part.dart';
+
+/// Request model for LoadWebDocumentOnline operation.
+class LoadWebDocumentOnlineRequest implements RequestBase {
+  /// The properties of data downloading.
+  final LoadWebDocumentData? data;
+
+  /// Request send data progress callback
+  final SendDataProgressCallback? sendDataProgressCallback;
+
+  /// Response receive data progress callback
+  final ReceiveDataProgressCallback? receiveDataProgressCallback;
+
+  LoadWebDocumentOnlineRequest(this.data, { this.sendDataProgressCallback, this.receiveDataProgressCallback });
+
+  @override
+  Future<ApiRequestData> createRequestData(final ApiClient _apiClient) async {
+    var _path = '/words/online/put/loadWebDocument';
+    var _queryParams = <String, String>{};
+    var _headers = <String, String>{};
+    var _bodyParts = <ApiRequestPart>[];
+    var _fileContentParts = <FileReference>[];
+    if (data != null) {
+      data!.validate();
+
+      var _formBody = _apiClient.serializeBody(data, 'Data');
+      if (_formBody != null) {
+        _bodyParts.add(_formBody);
+      }
+    }
+    else {
+      throw ApiException(400, 'Parameter data is required.');
+    }
+
+    for (final _fileContentPart in _fileContentParts) {
+        _fileContentPart.encryptPassword(_apiClient);
+        if (_fileContentPart.source == 'Request') {
+            _bodyParts.add(ApiRequestPart(_fileContentPart.content!, 'application/octet-stream', name: _fileContentPart.reference));
+        }
+    }
+    var _url = _apiClient.configuration.getApiRootUrl() + _apiClient.applyQueryParams(_path, _queryParams).replaceAll('//', '/');
+    var _body = _apiClient.serializeBodyParts(_bodyParts, _headers);
+    return ApiRequestData('PUT', _url, _headers, _body, this.sendDataProgressCallback, this.receiveDataProgressCallback);
+  }
+
+  @override
+  dynamic deserializeResponse(final ApiClient _apiClient, final Map<String, String> _headers, final ByteData? _body) {
+    if (_body == null) {
+        return ApiException(400, "Nullable response body is not allowed for this operation type.");
+    }
+
+    var _result = LoadWebDocumentOnlineResponse();
+    _result.deserialize(_apiClient, _apiClient.deserializeMultipartMap(_body));
+    return _result;
+  }
+}

lib/src/responses/load_web_document_online_response.dart

@@ -0,0 +1,59 @@
+/*
+ * --------------------------------------------------------------------------------
+ * <copyright company="Aspose" file="load_web_document_online_response.dart">
+ *   Copyright (c) 2025 Aspose.Words for Cloud
+ * </copyright>
+ * <summary>
+ *   Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ * 
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ * 
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ * </summary>
+ * --------------------------------------------------------------------------------
+ */
+
+library aspose_words_cloud;
+
+import 'dart:convert';
+import 'dart:typed_data';
+
+import '../../aspose_words_cloud.dart';
+import '../api_client.dart';
+import '../body_part_data.dart';
+
+/// Downloads a document from the Web using URL and saves it to cloud storage in the specified format.
+class LoadWebDocumentOnlineResponse implements ResponseBase {
+  /// The REST response with a save result.
+  SaveResponse? model;
+
+  /// The document after modification.
+  Map<String, ByteData>? document;
+
+  @override
+  void deserialize(ApiClient apiClient, Map<String, BodyPartData> _parts) {
+    final _modelBody = _parts['model'];
+    if (_modelBody != null) {
+        final _modelJsonData = utf8.decode(_modelBody.content.buffer.asUint8List(_modelBody.content.offsetInBytes, _modelBody.content.lengthInBytes));
+        model = ModelBase.createInstance< SaveResponse >(jsonDecode(_modelJsonData) as Map<String, dynamic>);
+    }
+
+    final _documentFile = _parts['document'];
+    if (_documentFile != null) {
+        document = apiClient.deserializeFilesCollection(_documentFile);
+    }
+  }
+}
+

lib/src/words_api.dart

@@ -1342,6 +1342,11 @@ class WordsApi {
     return await _apiClient.call(request) as SaveResponse;
   }
 
+  /// Downloads a document from the Web using URL and saves it to cloud storage in the specified format.
+  Future< LoadWebDocumentOnlineResponse > loadWebDocumentOnline(LoadWebDocumentOnlineRequest request) async {
+    return await _apiClient.call(request) as LoadWebDocumentOnlineResponse;
+  }
+
   /// Merge the section with the next one.
   Future< void > mergeWithNext(MergeWithNextRequest request) async {
   await _apiClient.call(request);

pubspec.yaml

@@ -1,6 +1,6 @@
 name: aspose_words_cloud
 description: This package allows you to work with Aspose.Words Cloud REST APIs in your Dart applications quickly and easily, with zero initial cost.
-version: 25.9.0
+version: 25.10.0
 homepage: https://github.com/aspose-words-cloud/aspose-words-cloud-dart
 
 environment:

test/aspose_words_cloud_tests.dart

@@ -215,6 +215,7 @@ void main() {
 
   group('LoadWebDocument', () {
     test('LoadWebDocument', () async => await LoadWebDocumentTests(testContext).testLoadWebDocument());
+    test('LoadWebDocumentOnline', () async => await LoadWebDocumentTests(testContext).testLoadWebDocumentOnline());
   });
 
   group('PasswordEncryption', () {

test/document/load_web_document_tests.dart

@@ -59,4 +59,24 @@ class LoadWebDocumentTests
     expect(result.saveResult?.destDocument, isNotNull);
     expect(result.saveResult?.destDocument?.href, 'google.doc');
   }
+
+  /// Test for loading web document online.
+  Future<void> testLoadWebDocumentOnline() async
+  {
+    final requestDataSaveOptions = DocSaveOptionsData();
+    requestDataSaveOptions.fileName = 'google.doc';
+    requestDataSaveOptions.dmlEffectsRenderingMode = SaveOptionsData_DmlEffectsRenderingModeEnum.none;
+    requestDataSaveOptions.dmlRenderingMode = SaveOptionsData_DmlRenderingModeEnum.drawingML;
+    requestDataSaveOptions.zipOutput = false;
+
+    final requestData = LoadWebDocumentData();
+    requestData.loadingDocumentUrl = 'http://google.com';
+    requestData.saveOptions = requestDataSaveOptions;
+
+    final request = LoadWebDocumentOnlineRequest(
+      requestData
+    );
+
+    await context.getApi().loadWebDocumentOnline(request);
+  }
 }