Merge remote-tracking branch 'origin/develop' into develop

Author: Marat-Gumerov

README.md

@@ -1,98 +1,74 @@
-# Aspose.Email Cloud SDK for Node.Js
+# Manage Emails in Cloud via Node.Js/Typescript REST SDK
 
 [![npm](https://img.shields.io/npm/v/@asposecloud/aspose-email-cloud)](https://www.npmjs.com/package/@asposecloud/aspose-email-cloud) [![License](https://img.shields.io/github/license/aspose-email-cloud/aspose-email-cloud-node)](https://www.npmjs.com/package/@asposecloud/aspose-email-cloud) [![node](https://img.shields.io/node/v/@asposecloud/aspose-email-cloud)](https://www.npmjs.com/package/@asposecloud/aspose-email-cloud)  [![types](https://img.shields.io/npm/types/@asposecloud/aspose-email-cloud)](https://www.npmjs.com/package/@asposecloud/aspose-email-cloud) ![tests](https://github.com/aspose-email-cloud/aspose-email-cloud-node/workflows/tests/badge.svg)
 
-This repository contains Aspose.Email Cloud SDK for Node.Js source code. This SDK allows you to work with Aspose.Email Cloud REST APIs in your Node.Js applications quickly and easily, with zero initial cost.
+[Aspose.Email Cloud SDK for Node.Js/Typescript](https://products.aspose.cloud/email/nodejs) is a REST API SDK for creating email applications that work with standard email file formats such as Outlook MSG, EML, iCalendar files and VCard.
 
-[Aspose.Email Cloud home](https://products.aspose.cloud/email/family "Aspose.Email Cloud")  
-[API Reference](https://apireference.aspose.cloud/email/)  
+This SDK allows you to work with Aspose.Email Cloud REST APIs in your Node.Js applications quickly and easily, with zero initial cost.
 
-# Key features
+[Aspose.Email Cloud home](https://products.aspose.cloud/email/family)
+[API Reference](https://apireference.aspose.cloud/email/)
+
+# Cloud Email Processing Features
 Aspose.Email Cloud is a REST API for creating email applications that work with standard email file formats. This SDK:
-- Lets developers manipulate different emails’ formats such as Outlook MSG, EML, VCard, and iCalendar files
-- Lets developers manipulate different emails' formats such as Outlook MSG, EML, VCard, and iCalendar files
+- Lets developers manipulate different emails' formats such as Outlook MSG, EML, VCard, and iCalendar files.
 - Supports AI functions:
-    - The Business card recognition
-    - The Name API for parsing and handling personal names
+    - The Business card recognition.
+    - The Name API for parsing and handling personal names.
 - Has a built-in email client. This client provides:
-    - Unified REST API for different email protocols: IMAP, POP3, SMTP, EWS, WebDav
-    - Virtual multi-account
-    - Message threads (POP3 accounts are also supported)
-- Email configuration discovery
-- Disposable email address detection
-
-## New features in version 20.7
-- New MAPI message files API with models:
-    - `MapiMessageDto` - represents the Microsoft Outlook message.
-    - `MapiCalendarDto` - represents the Microsoft Outlook calendar object.
-    - `MapiContactDto` - represents the Microsoft Outlook contact information. 
-- Improved Recurrence pattern support for CalendarDto.
-
-See [Release notes](https://docs.aspose.cloud/display/emailcloud/Aspose.Email+Cloud+20.7+Release+Notes)
+    - Unified REST API for different email protocols: IMAP, POP3, SMTP, EWS, WebDav.
+    - Virtual multi-account.
+    - Message threads (POP3 accounts are also supported).
+- Email configuration discovery.
+- Disposable email address detection.
+
+## New features in version 20.9
+
+Aspose.Email Cloud SDK 20.9.0 is based on a new v4.0 REST API.
+
+- All SDK functions are divided into groups (Email, Calendar, Contact, Client, Ai, Mapi, etc.).
+- Unified file API provided for supported file types (Save, Get, Convert, AsFile, FromFile, AsMapi/AsDto).
+- HierarchicalObject based API is removed.
+- All models are stored in one folder/namespace.
+- The request models are simplified.
+
+See [Release notes](https://docs.aspose.cloud/display/emailcloud/Aspose.Email+Cloud+20.9+Release+Notes).
+
 ## How to use the SDK?
-The complete source code is available in the GIT repository.
+The complete source code is available in the [GIT repository](https://github.com/aspose-email-cloud/aspose-email-cloud-node/tree/master/src).
 
-Use [SDK tutorials](https://docs.aspose.cloud/display/emailcloud/SDK+Tutorials):
-- [SDK setup](https://docs.aspose.cloud/display/emailcloud/SDK+setup) - installation, account setup, first API calls
-- [Business Cards Recognition API](https://docs.aspose.cloud/display/emailcloud/Business+Cards+Recognition+API) - convert captured business cards and name card images, into a vCard format
-- [Working with Name API](https://docs.aspose.cloud/display/emailcloud/Working+with+Name+API) - format, genderize, compare, parse, autocomplete names
-- [Email Message Files](https://docs.aspose.cloud/display/emailcloud/Email+Message+Files) - Convert EML to MSG and back, edit EML files, etc.
-- [Quick Start With iCalendar API](https://docs.aspose.cloud/display/emailcloud/Quick+Start+With+iCalendar+API) - Crate and edit iCalendar files
-- [Quick Start With VCard API](https://docs.aspose.cloud/display/emailcloud/Quick+Start+With+VCard+API) - Create and edit VCard files, business card recognition
-- [Quick Start With Email Client](https://docs.aspose.cloud/display/emailcloud/Quick+Start+With+Email+Client) - Setup builtin email client, search/fetch/send/move/delete messages
-- [Email Client Threads](https://docs.aspose.cloud/display/emailcloud/Email+Client+Threads) - Fetch/Move/Delete email message threads using builtin email client
-- [File converters](https://docs.aspose.cloud/display/emailcloud/Convert+Email%2C+Calendar+and+Contact+Files)
+Use [SDK tutorials](https://docs.aspose.cloud/display/emailcloud/SDK+Tutorials).
 
-SDK reference documentation is available in [this README](doc/README.md)
+SDK reference documentation is available in [this README](https://github.com/aspose-email-cloud/aspose-email-cloud-node/blob/master/doc/README.md).
 
 ### Prerequisites
 To use this SDK, you need an App SID and an App Key; they can be looked up at [Aspose Cloud Dashboard](https://dashboard.aspose.cloud/#/apps) (it requires free registration in Aspose Cloud for this).
 
 ### Installation
-You can use it directly in your project via the source code or get a [npm package](https://www.npmjs.com/package/@asposecloud/aspose-email-cloud)
+You can use it directly in your project via the source code or get a [npm package](https://www.npmjs.com/package/@asposecloud/aspose-email-cloud).
 From the command line:
 
-	npm install @asposecloud/aspose-email-cloud --save
+    npm install @asposecloud/aspose-email-cloud --save
 
-See more details about SDK installation in this tutorial: [SDK setup](https://docs.aspose.cloud/display/emailcloud/SDK+setup)
+See more details about SDK installation in this tutorial: [SDK setup](https://docs.aspose.cloud/display/emailcloud/SDK+setup).
 
 ### Usage examples
-To use the API, you should create an EmailApi object:
+To use the API, you should create an EmailCloud object:
 ```typescript
 var appKey = "Your App Key";
 var appSid = "Your App SID";
-var api = new EmailApi(appSid, appKey);
+var api = new EmailCloud(appSid, appKey);
 ```
 
 #### Business cards recognition API
 
-Use `AiBcrParseModel` method to parse business card image to VCard DTO:
+Use `AiBcrApi.parse` method to parse business card image to VCard DTO:
 
 ```typescript
-var imageData = fs.readFileSync("/tmp/alex.png").toString('base64');
-var result = await api.aiBcrParseModel(new requests.AiBcrParseModelRequest(
-    new models.AiBcrBase64Rq(
-        undefined, [new models.AiBcrBase64Image(true, imageData)])));
-var contact = result.body.value[0];
+var imageData = fs.readFileSync("path/to/image/to/parse.png");
+var result = await api.ai.bcr.parse(new AiBcrParseRequest(
+    imageData, undefined, undefined, true));
+var contact = result.value[0];
 ```
 
-See more details [here](https://docs.aspose.cloud/display/emailcloud/Parse+Image+To+VCard+File) and [here](https://docs.aspose.cloud/display/emailcloud/Business+Cards+Recognition+API)
-
-# Licensing
-All Aspose.Email Cloud SDKs, helper scripts and templates are licensed under [MIT License](LICENSE).
-
-# Resources
-+ [**SDK reference documentation**](doc/README.md)
-+ [**Website**](https://www.aspose.cloud)
-+ [**Product Home**](https://products.aspose.cloud/Email/cloud)
-+ [**Documentation**](https://docs.aspose.cloud/display/Emailcloud/Home)
-+ [**API Reference**](https://apireference.aspose.cloud/email/)
-+ [**Free Support Forum**](https://forum.aspose.cloud/c/email)
-+ [**Paid Support Helpdesk**](https://helpdesk.aspose.cloud/)
-+ [**Blog**](https://blog.aspose.cloud/category/aspose-products/aspose-email-cloud/)
-+ [**Git repository: Aspose.Email Cloud SDK for .Net**](https://github.com/aspose-email-cloud/aspose-email-cloud-dotnet)
-+ [**Git repository: Aspose.Email Cloud SDK for Ruby**](https://github.com/aspose-email-cloud/aspose-email-cloud-ruby)
-+ [**Git repository: Aspose.Email Cloud SDK for Python**](https://github.com/aspose-email-cloud/aspose-email-cloud-python)
-+ [**Git repository: Aspose.Email Cloud SDK for PHP**](https://github.com/aspose-email-cloud/aspose-email-cloud-php)
-+ [**Git repository: Aspose.Email Cloud SDK for Typescript**](https://github.com/aspose-email-cloud/aspose-email-cloud-node)
-+ [**Git repository: Aspose.Email Cloud SDK for Java**](https://github.com/aspose-email-cloud/aspose-email-cloud-java)
+[Product Page](https://products.aspose.cloud/email/nodejs) | [Documentation](https://docs.aspose.cloud/display/Emailcloud/Home) | [Demo](https://products.aspose.app/email/family) | [API Reference](https://apireference.aspose.cloud/email/) | [Blog](https://blog.aspose.cloud/category/email/) | [Free support](https://forum.aspose.cloud/c/email) | [Free trial](https://dashboard.aspose.cloud/#/apps)

doc/ClientMessageApi.md

@@ -46,7 +46,7 @@ Name | Type | Description | Notes
  **file** | **byte[]**| Message file to append. |
  **storage** | **string**| Storage name where account file located. | [optional]
  **accountStorageFolder** | **string**| Folder in storage where account file located. | [optional]
- **format** | **string**| Email file format. Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef | [optional] [default to 0]
+ **format** | **string**| Email file format. Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef, Oft | [optional] [default to 0]
  **folder** | **string**| Path to folder on email server to append message to. | [optional]
  **markAsSent** | **boolean**| Determines that appended message should be market as sent or not. | [optional] [default to true]
 
@@ -103,7 +103,7 @@ Name | Type | Description | Notes
  **storage** | **string**| Storage name where account file located. | [optional]
  **accountStorageFolder** | **string**| Folder in storage where account file located. | [optional]
  **type** | **string**| MailMessageBase type. Using this property you can fetch message in different formats (as EmailDto, MapiMessageDto or a file represented as Base64 string).              Enum, available values: Dto, Mapi, Base64 | [optional] [default to 0]
- **format** | **string**| Base64 data format. Used only if type is set to Base64. Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef | [optional] [default to 0]
+ **format** | **string**| Base64 data format. Used only if type is set to Base64. Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef, Oft | [optional] [default to 0]
 
 ### Return type
 
@@ -137,7 +137,7 @@ Name | Type | Description | Notes
  **folder** | **string**| Account folder to fetch from (should be specified for some protocols such as IMAP)              | [optional]
  **storage** | **string**| Storage name where account file located. | [optional]
  **accountStorageFolder** | **string**| Folder in storage where account file located. | [optional]
- **format** | **string**| Fetched message file format. Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef | [optional] [default to 0]
+ **format** | **string**| Fetched message file format. Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef, Oft | [optional] [default to 0]
 
 ### Return type
 
@@ -176,7 +176,7 @@ Name | Type | Description | Notes
  **accountStorageFolder** | **string**| Folder in storage where account file located | [optional]
  **recursive** | **boolean**| Specifies that should message be searched in subfolders recursively | [optional] [default to false]
  **type** | **string**| MailMessageBase type. Using this property you can get messages in different formats (as EmailDto, MapiMessageDto or a file represented as Base64 string).              Enum, available values: Dto, Mapi, Base64 | [optional] [default to 0]
- **format** | **string**| Base64 data format. Used only if type is set to Base64. Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef | [optional] [default to 0]
+ **format** | **string**| Base64 data format. Used only if type is set to Base64. Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef, Oft | [optional] [default to 0]
 
 ### Return type
 
@@ -246,7 +246,7 @@ Name | Type | Description | Notes
  **file** | **byte[]**| File to send |
  **storage** | **string**| Storage name where account file located. | [optional]
  **accountStorageFolder** | **string**| Folder in storage where account file located. | [optional]
- **format** | **string**| Email file format Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef | [optional] [default to 0]
+ **format** | **string**| Email file format Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef, Oft | [optional] [default to 0]
 
 ### Return type
 

doc/EmailApi.md

@@ -57,8 +57,8 @@ new EmailConvert(
 
 Name | Type | Description | Notes
 ---- | ---- | ----------- | -----
- **fromFormat** | **string**| File format to convert to Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef |
- **toFormat** | **string**| File format to convert from Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef |
+ **fromFormat** | **string**| File format to convert to Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef, Oft |
+ **toFormat** | **string**| File format to convert from Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef, Oft |
  **file** | **byte[]**| File to convert |
 
 ### Return type
@@ -84,7 +84,7 @@ new EmailFromFile(
 
 Name | Type | Description | Notes
 ---- | ---- | ----------- | -----
- **format** | **string**|  Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef |
+ **format** | **string**|  Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef, Oft |
  **file** | **byte[]**| File to convert |
 
 ### Return type
@@ -112,7 +112,7 @@ new EmailGet(
 
 Name | Type | Description | Notes
 ---- | ---- | ----------- | -----
- **format** | **string**| Email document format. Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef |
+ **format** | **string**| Email document format. Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef, Oft |
  **fileName** | **string**| Email document file name. |
  **folder** | **string**| Path to folder in storage. | [optional]
  **storage** | **string**| Storage name. | [optional]
@@ -143,7 +143,7 @@ new EmailGetAsFile(
 Name | Type | Description | Notes
 ---- | ---- | ----------- | -----
  **fileName** | **string**| Email document file name |
- **format** | **string**| File format Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef |
+ **format** | **string**| File format Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef, Oft |
  **storage** | **string**| Storage name | [optional]
  **folder** | **string**| Path to folder in storage | [optional]
 
@@ -173,7 +173,7 @@ new EmailGetList(
 
 Name | Type | Description | Notes
 ---- | ---- | ----------- | -----
- **format** | **string**| Email document format. Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef |
+ **format** | **string**| Email document format. Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef, Oft |
  **folder** | **string**| Path to folder in storage. | [optional]
  **storage** | **string**| Storage name. | [optional]
  **itemsPerPage** | **number**| Count of items on page. | [optional] [default to 10]

doc/EmailAsFileRequest.md

@@ -3,7 +3,7 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**format** | **string** | Email document format. Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef | [default to undefined]
+**format** | **string** | Email document format. Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef, Oft | [default to undefined]
 **value** | [**EmailDto**](EmailDto.md) | Email model.              | [default to undefined]
 
 

doc/EmailSaveRequest.md

@@ -3,7 +3,7 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**format** | **string** | Email document format. Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef | [default to undefined]
+**format** | **string** | Email document format. Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef, Oft | [default to undefined]
 
  Parent class: [StorageModelOfEmailDto](StorageModelOfEmailDto.md)
 

doc/MailMessageBase64.md

@@ -4,7 +4,7 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **valueBase64** | **string** | Email message file data encoded to Base64 string.              | [default to undefined]
-**format** | **string** | Email document format. Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef | [default to undefined]
+**format** | **string** | Email document format. Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef, Oft | [default to undefined]
 
  Parent class: [MailMessageBase](MailMessageBase.md)
 

doc/MapiMessageApi.md

@@ -56,7 +56,7 @@ new MapiMessageFromFile(
 
 Name | Type | Description | Notes
 ---- | ---- | ----------- | -----
- **format** | **string**| File format Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef |
+ **format** | **string**| File format Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef, Oft |
  **file** | **byte[]**| File to convert |
 
 ### Return type
@@ -84,7 +84,7 @@ new MapiMessageGet(
 
 Name | Type | Description | Notes
 ---- | ---- | ----------- | -----
- **format** | **string**| Email document format. Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef |
+ **format** | **string**| Email document format. Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef, Oft |
  **fileName** | **string**| Email document file name. |
  **folder** | **string**| Path to folder in storage. | [optional]
  **storage** | **string**| Storage name. | [optional]

doc/MapiMessageAsFileRequest.md

@@ -3,7 +3,7 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**format** | **string** | Email document format. Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef | [default to undefined]
+**format** | **string** | Email document format. Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef, Oft | [default to undefined]
 **value** | [**MapiMessageDto**](MapiMessageDto.md) | MAPI message model.              | [default to undefined]
 
 

doc/MapiMessageSaveRequest.md

@@ -3,7 +3,7 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**format** | **string** | Email document format. Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef | [default to undefined]
+**format** | **string** | Email document format. Enum, available values: Eml, Msg, MsgUnicode, Mhtml, Html, Tnef, Oft | [default to undefined]
 
  Parent class: [StorageModelOfMapiMessageDto](StorageModelOfMapiMessageDto.md)
 

package.json

@@ -56,4 +56,4 @@
     "typescript": "^3.7.2",
     "uuid": "^3.3.3"
   }
-}
+}