mailgun.js 11.0.0 → 12.0.0

package/README.md

@@ -38,31 +38,94 @@ npm install mailgun.js
 
 ## Setup Client
 
-Next, require the module and instantiate a mailgun client by calling `new Mailgun(formData)` and then using `mailgun.client` setup the client with basic auth credentials `(username: 'api', key: 'key-yourkeyhere')`.
+The next step is to import the module and instantiate a mailgun client by calling `new Mailgun(formData)` and then using `mailgun.client` setup the client with basic auth credentials `(username: 'api', key: 'key-yourkeyhere')`.
 
-NOTE: starting from version 3.0 you need to pass FormData (we need this to keep library universal). For node.js you can use `form-data` library.
+NOTE: starting from version 3.0 you need to pass FormData (we need this to keep library universal). For node.js you can use built-in FormData or `form-data` library.
 
-IMPORTANT: if you are using EU infrastructure, you need to also pass `url: 'https://api.eu.mailgun.net'` together with auth credentials as stated in [Mailgun docs](https://documentation.mailgun.com/en/latest/quickstart-sending.html#send-via-api)
+**IMPORTANT**: if you are using EU infrastructure, you need to also pass `url: 'https://api.eu.mailgun.net'` together with auth credentials as stated in [Mailgun docs](https://documentation.mailgun.com/en/latest/quickstart-sending.html#send-via-api)
 
 ### Imports
 Once the package is installed, you can import the library using `import` or `require` approach:
 
 ```js
-  const formData = require('form-data');
+  const formData = require('form-data'); // or built-in FormData
   const Mailgun = require('mailgun.js');
   const mailgun = new Mailgun(formData);
   const mg = mailgun.client({username: 'api', key: process.env.MAILGUN_API_KEY || 'key-yourkeyhere'});
 ```
 ```js
-  import FormData from 'form-data';
+  import FormData from 'form-data'; // or built-in FormData
   import Mailgun from 'mailgun.js';
   const mailgun = new Mailgun(FormData);
   const mg = mailgun.client({username: 'api', key: process.env.MAILGUN_API_KEY || 'key-yourkeyhere'});
 ```
+
+Be aware that there are four bundles available for usage. All of them are conditionally exported by package.json and separated by environment (Browser/Node.js):
+  - Node.js environment:
+    - CommonJS ([CJS](https://nodejs.org/api/modules.html#modules-commonjs-modules)), a bundle to use with the CommonJS module system in Node.js.
+
+      Usage example:
+
+      ``` JS
+      // In this case, the .dist/CJS/mailgun.node.cjs file is expected to be used
+      const Mailgun = require('mailgun.js');
+      const mailgun = new Mailgun(FormData);
+      ```
+
+    - ECMAScript modules ([ESM](https://nodejs.org/download/release/v18.11.0/docs/api/esm.html#modules-ecmascript-modules)) a bundle for the **Node.js** environment
+
+      Usage example:
+      ``` JS
+      // In this case, the .dist/ESM/mailgun.node.js file is expected to be used
+      import Mailgun from 'mailgun.js';
+      const mailgun = new Mailgun(FormData);
+      ...
+      ```
+      or with dynamic imports:
+      ``` JS
+      // In this case, the .dist/ESM/mailgun.node.js file is expected to be used
+      const Mailgun = await import('mailgun.js');
+      const mailgun = new Mailgun.default(FormData);
+      ...
+      ```
+
+  - Browser environment:
+    - Asynchronous Module Definition ([AMD](https://github.com/amdjs/amdjs-api/wiki/AMD)), a bundle to use with the `Require.js` module loader in the browser. This bundle requires the RequireJS module loader to be present in the environment.
+
+      Usage example for the case when the distribution is used directly in the browser:
+      ``` HTML
+      <script src='http://requirejs.org/docs/release/2.3.6/comments/require.js'></script>
+      <script>
+      require(['./dist/AMD/mailgun.amd.js'], function(Mailgun) {
+        const mailgun = new Mailgun(FormData);
+        ...
+      })
+      </script>
+      ```
+
+    - ECMAScript modules ([ESM](https://nodejs.org/download/release/v18.11.0/docs/api/esm.html#modules-ecmascript-modules)) a bundle for **browser** environment.
+
+      Usage example for the case the distribution is used directly in the browser:
+      ``` HTML
+      <script type="module">
+        import Mailgun from './dist/ESM/mailgun.browser.js';
+        const mailgun = new Mailgun(FormData);
+        ...
+      </script>
+      ```
+      or with dynamic imports:
+      ``` HTML
+      <script>
+      import ('./dist/ESM/mailgun.browser.js').then(Mailgun =>{
+        const mailgun = new Mailgun.default(FormData);
+        ...
+      })
+      </script>
+      ```
 ### Using Subaccounts
 Primary accounts can make API calls on behalf of their subaccounts. [API documentation](https://documentation.mailgun.com/en/latest/subaccounts.html#subaccounts)
 ```js
-  import FormData from 'form-data';
+  import FormData from 'form-data'; // or built-in FormData
   import Mailgun from 'mailgun.js';
   const mailgun = new Mailgun(FormData);
   const mg = mailgun.client({username: 'api', key: process.env.MAILGUN_API_KEY || 'key-yourkeyhere'});
@@ -75,7 +138,7 @@ Primary accounts can make API calls on behalf of their subaccounts. [API documen
 By leveraging client configuration options, users can effortlessly establish proxy connections that align with their network requirements.
 Ex:
 ```js
-  import FormData from 'form-data';
+  import FormData from 'form-data'; // or built-in FormData
   import Mailgun from 'mailgun.js';
   const mailgun = new Mailgun(FormData);
 
@@ -94,15 +157,15 @@ Ex:
   });
 ```
 ### Types imports
-Starting from version **9.0.0.** Types can be includes as named import:
+Types defined by SDK can be imported from 'definitions' submodule:
 ```TS
- import Mailgun, { MailgunClientOptions, MessagesSendResult } from 'mailgun.js';
+ import { MailgunClientOptions, MessagesSendResult } from 'mailgun.js/definitions';
 ```
 
 ### Interfaces and Enums imports
-Starting from version **9.0.0.** Interfaces and Enums can be imported in the next way:
+Interfaces and Enums defined by SDK can be imported from 'definitions' submodule:
 ```TS
-  import Mailgun, { Interfaces, Enums } from 'mailgun.js';
+  import { Interfaces, Enums } from 'mailgun.js/definitions';
   ...
   const mailgunClient: Interfaces.IMailgunClient = mailgun.client(clientOptions);
   const yes = Enums.YesNo.YES;
@@ -149,8 +212,14 @@ The following service methods are available to instantiated clients. The example
       - [createVersion](#createversion)
       - [updateVersion](#updateversion)
       - [destroyVersion](#destroyversion)
-    - [events](#events)
+    - [domain tracking](#domain-tracking)
+      - [getTracking](#gettracking-1)
+      - [updateTracking](#updatetracking-1)
       - [get](#get-2)
+      - [generate](#generate)
+      - [regenerate](#regenerate)
+    - [events](#events)
+      - [get](#get-3)
         - [Example with Date and *Filter field*](#example-with-date-and-filter-field)
     - [stats](#stats)
       - [Stats Options](#stats-options)
@@ -164,7 +233,7 @@ The following service methods are available to instantiated clients. The example
         - [Bounces Example](#bounces-example)
         - [Unsubscribes Example](#unsubscribes-example)
         - [Complaints Example](#complaints-example)
-      - [get](#get-3)
+      - [get](#get-4)
         - [Bounces Example](#bounces-example-1)
         - [Unsubscribes Example](#unsubscribes-example-1)
         - [Complaints Example](#complaints-example-1)
@@ -180,26 +249,26 @@ The following service methods are available to instantiated clients. The example
         - [Complaints Example](#complaints-example-3)
     - [webhooks](#webhooks)
       - [list](#list-3)
-      - [get](#get-4)
+      - [get](#get-5)
       - [create](#create-4)
       - [update](#update-2)
       - [destroy](#destroy-3)
     - [routes](#routes)
       - [list](#list-4)
-      - [get](#get-5)
+      - [get](#get-6)
       - [create](#create-5)
       - [update](#update-3)
       - [destroy](#destroy-4)
     - [validate](#validate)
-      - [get](#get-6)
+      - [get](#get-7)
     - [multiple validation](#multiple-validation)
       - [create](#create-6)
       - [list](#list-5)
-      - [get](#get-7)
+      - [get](#get-8)
       - [destroy](#destroy-5)
     - [mailing lists](#mailing-lists)
       - [list](#list-6)
-      - [get](#get-8)
+      - [get](#get-9)
       - [create](#create-7)
       - [update](#update-4)
       - [destroy](#destroy-6)
@@ -212,36 +281,36 @@ The following service methods are available to instantiated clients. The example
       - [destroyMember](#destroymember)
     - [subaccounts](#subaccounts)
       - [list](#list-7)
-      - [get](#get-9)
+      - [get](#get-10)
       - [create](#create-8)
       - [enable](#enable)
       - [disable](#disable)
     - [inbox placements](#inbox-placements)
       - [SeedsLists](#seedslists)
         - [list](#list-8)
-        - [get](#get-10)
+        - [get](#get-11)
         - [create](#create-9)
         - [update](#update-5)
         - [destroy](#destroy-7)
         - [SeedsLists Attributes](#attributes)
           - [list](#list-9)
-          - [get](#get-11)
+          - [get](#get-12)
         - [SeedsLists Filters](#filters)
           - [list](#list-10)
       - [Providers](#providers)
         - [list](#list-11)
       - [Results](#results)
         - [list](#list-12)
-        - [get](#get-12)
+        - [get](#get-13)
         - [destroy](#destroy-8)
         - [getResultByShareId](#getresultbyshareid)
         - [Results Attributes](#attributes-1)
           - [list](#list-13)
-          - [get](#get-13)
+          - [get](#get-14)
         - [Results Filters](#filters-1)
           - [list](#list-14)
         - [Sharing](#sharing)
-          - [get](#get-14)
+          - [get](#get-15)
           - [update](#update-6)
       - [Run Test](#run-test)
   - [Navigation thru lists](#navigation-thru-lists)
@@ -906,133 +975,11 @@ The following service methods are available to instantiated clients. The example
   }
   ```
 
-
 - #### getTracking
-  Mailgun offers tracking for clicks, unsubscribes, and opens, with optional HTTPS protocol support on tracking URLs. To enable HTTPS, Mailgun uses Let’s Encrypt with HTTP-01 challenges through your existing tracking CNAME record to issue a TLS certificate. This setup also includes support for HTTP Strict Transport Security (HSTS) for enhanced security.
-
-  `mg.domains.getTracking(domainAddress)` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domain-Tracking/#tag/Domain-Tracking)
-
-  Example:
-
-  ```JS
-  mg.domains.getTracking('foobar.example.com')
-    .then(msg => console.log(msg)) // logs response data
-    .catch(err => console.error(err)); // logs any error
-  ```
-
-  Promise returns:
-
-  ```JS
-  {
-    "click": {
-      "active": false
-    },
-    "open": {
-      "active": false
-    },
-    "unsubscribe": {
-      "active": false,
-      "html_footer": "\n<br>\n<p><a href=\"%unsubscribe_url%\">unsubscribe</a></p>\n",
-      "text_footer": "\n\nTo unsubscribe click: <%unsubscribe_url%>\n\n"
-    }
-  }
-  ```
+  `domains.getTracking` method is deprecated, and will be removed. Please use `domains.domainTracking.getTracking` instead.
 
 - #### updateTracking
-  A common method to turn on/off the click, open, and unsubscribe tracking at the domain level.
-
-  `mg.domains.updateTracking(domain, trackingType, data)`
-
-  - Open Tracking Example:
-
-    [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domain-Tracking/#tag/Domain-Tracking/operation/PUT-v3-domains--name--tracking-open)
-    ```js
-    mg.domains.updateTracking('foobar.example.com', 'open', {
-      active: true,
-      place_at_the_top: true,
-    })
-      .then(msg => console.log(msg)) // logs response data
-      .catch(err => console.error(err)); // logs any error
-    ```
-
-    Open tracking data object properties:
-
-    | Property | Description                                |
-    |:----------|:-------------------------------------------|
-    | active    | Boolean, enables or disables open tracking |
-    | place_at_the_top| Setting this param to true will place the open tracking pixel at the top of the HTML body when inserted into the email mime. Omit this param to keep current setting. |
-
-    Promise returns:
-
-    ```JS
-    {
-      message: 'Tracking settings have been updated',
-      open: {
-        active: true,
-        place_at_the_top: true,
-      }
-    }
-    ```
-
-  - Click Tracking Example:
-
-    [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domain-Tracking/#tag/Domain-Tracking/operation/PUT-v3-domains--name--tracking-click)
-    ```JS
-    mg.domains.updateTracking('foobar.example.com', 'click', {active: true})
-      .then(msg => console.log(msg)) // logs response data
-      .catch(err => console.error(err)); // logs any error
-    ```
-
-    Click tracking data object properties:
-
-    | Property | Description                                 |
-    |:----------|:--------------------------------------------|
-    | active    | Boolean, enables or disables click tracking |
-
-    Promise returns:
-
-    ```JS
-    {
-      message: 'Tracking settings have been updated',
-      click: {
-        active: true
-      }
-    }
-    ```
-
-  - Unsubscribe Tracking Example
-
-    [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domain-Tracking/#tag/Domain-Tracking/operation/PUT-v3-domains--name--tracking-unsubscribe)
-    ```js
-    mg.domains.updateTracking('foobar.example.com', 'unsubscribe', {
-        active: true,
-        html_footer: "\n<br>\n<p><a href=\"%unsubscribe_url%\">unsubscribe</a></p>\n",
-        text_footer: "\n\nTo unsubscribe click: <%unsubscribe_url%>\n\n"
-      })
-      .then(msg => console.log(msg)) // logs response data
-      .catch(err => console.error(err)); // logs any error
-    ```
-
-    Unsubscribe Tracking data object properties:
-
-    | Property   | Description                                                   |
-    |:------------|:--------------------------------------------------------------|
-    | active      | Boolean, enables or disables unsubscribe tracking             |
-    | html_footer | string appended to html emails for managing unsubscribe links |
-    | text_footer | string appended to html emails for managing unsubscribe links |
-
-    Promise returns:
-
-    ```JS
-    {
-      message: 'Tracking settings have been updated',
-      unsubscribe: {
-        active: true,
-        html_footer: '\n<br>\n<p><a href=\'%unsubscribe_url%\">unsubscribe</a></p>\n',
-        text_footer: '\n\nTo unsubscribe click: <%unsubscribe_url%>\n\n'
-      }
-    }
-    ```
+   `domains.updateTracking` method is deprecated, and will be removed. Please use `domains.domainTracking.updateTracking` instead.
 
 - #### getConnection
   Returns domain's delivery connection settings.
@@ -1644,6 +1591,207 @@ The following service methods are available to instantiated clients. The example
     }
     ```
 
+### Domain tracking
+
+- #### getTracking
+
+  Mailgun offers tracking for clicks, unsubscribes, and opens, with optional HTTPS protocol support on tracking URLs. To enable HTTPS, Mailgun uses Let’s Encrypt with HTTP-01 challenges through your existing tracking CNAME record to issue a TLS certificate. This setup also includes support for HTTP Strict Transport Security (HSTS) for enhanced security.
+
+  `mg.domains.domainTracking.getTracking(domainAddress)` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domain-Tracking/#tag/Domain-Tracking)
+
+  Example:
+
+  ```JS
+  mg.domains.domainTracking.getTracking('foobar.example.com')
+    .then(msg => console.log(msg)) // logs response data
+    .catch(err => console.error(err)); // logs any error
+  ```
+
+  Promise returns:
+
+  ```JS
+  {
+    "click": {
+      "active": false
+    },
+    "open": {
+      "active": false
+    },
+    "unsubscribe": {
+      "active": false,
+      "html_footer": "\n<br>\n<p><a href=\"%unsubscribe_url%\">unsubscribe</a></p>\n",
+      "text_footer": "\n\nTo unsubscribe click: <%unsubscribe_url%>\n\n"
+    }
+  }
+  ```
+
+- #### updateTracking
+
+  A common method to turn on/off the click, open, and unsubscribe tracking at the domain level.
+
+  `mg.domains.domainTracking.updateTracking(domain, trackingType, data)`
+
+  - Open Tracking Example:
+
+    [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domain-Tracking/#tag/Domain-Tracking/operation/PUT-v3-domains--name--tracking-open)
+    ```js
+    mg.domains.domainTracking.updateTracking('foobar.example.com', 'open', {
+      active: true,
+      place_at_the_top: true,
+    })
+      .then(msg => console.log(msg)) // logs response data
+      .catch(err => console.error(err)); // logs any error
+    ```
+
+    Open tracking data object properties:
+
+    | Property | Description                                |
+    |:----------|:-------------------------------------------|
+    | active    | Boolean, enables or disables open tracking |
+    | place_at_the_top| Setting this param to true will place the open tracking pixel at the top of the HTML body when inserted into the email mime. Omit this param to keep current setting. |
+
+    Promise returns:
+
+    ```JS
+    {
+      message: 'Tracking settings have been updated',
+      open: {
+        active: true,
+        place_at_the_top: true,
+      }
+    }
+    ```
+
+  - Click Tracking Example:
+
+    [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domain-Tracking/#tag/Domain-Tracking/operation/PUT-v3-domains--name--tracking-click)
+    ```JS
+    mg.domains.domainTracking.updateTracking('foobar.example.com', 'click', {active: true})
+      .then(msg => console.log(msg)) // logs response data
+      .catch(err => console.error(err)); // logs any error
+    ```
+
+    Click tracking data object properties:
+
+    | Property | Description                                 |
+    |:----------|:--------------------------------------------|
+    | active    | Boolean, enables or disables click tracking |
+
+    Promise returns:
+
+    ```JS
+    {
+      message: 'Tracking settings have been updated',
+      click: {
+        active: true
+      }
+    }
+    ```
+
+  - Unsubscribe Tracking Example
+
+    [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domain-Tracking/#tag/Domain-Tracking/operation/PUT-v3-domains--name--tracking-unsubscribe)
+    ```js
+    mg.domains.domainTracking.updateTracking('foobar.example.com', 'unsubscribe', {
+        active: true,
+        html_footer: "\n<br>\n<p><a href=\"%unsubscribe_url%\">unsubscribe</a></p>\n",
+        text_footer: "\n\nTo unsubscribe click: <%unsubscribe_url%>\n\n"
+      })
+      .then(msg => console.log(msg)) // logs response data
+      .catch(err => console.error(err)); // logs any error
+    ```
+
+    Unsubscribe Tracking data object properties:
+
+    | Property   | Description                                                   |
+    |:------------|:--------------------------------------------------------------|
+    | active      | Boolean, enables or disables unsubscribe tracking             |
+    | html_footer | string appended to html emails for managing unsubscribe links |
+    | text_footer | string appended to html emails for managing unsubscribe links |
+
+    Promise returns:
+
+    ```JS
+    {
+      message: 'Tracking settings have been updated',
+      unsubscribe: {
+        active: true,
+        html_footer: '\n<br>\n<p><a href=\'%unsubscribe_url%\">unsubscribe</a></p>\n',
+        text_footer: '\n\nTo unsubscribe click: <%unsubscribe_url%>\n\n'
+      }
+    }
+    ```
+
+- #### get
+  Get x509 TLS certificate and status
+
+  `mg.domains.domainTracking.get(domainAddress)` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domain-Tracking/#tag/Domain-Tracking/operation/httpapi.(*HttpAPI).getStatusV2-fm-8)
+
+  Example:
+
+  ```JS
+  mg.domains.domainTracking.get('foobar.example.com')
+    .then(msg => console.log(msg)) // logs response data
+    .catch(err => console.error(err)); // logs any error
+  ```
+
+  Promise returns:
+
+  ```JS
+  {
+    responseStatusCode: 200,
+    status: 'expired',
+    error: 'x509 certificate has expired',
+    certificate: '{CERT}';
+  }
+  ```
+
+- #### generate
+  Initiates generation of a TLS certificate for the tracking domain in a background task. Once generation is enqueued, you may poll the status endpoint in location field to check for success
+
+  `mg.domains.domainTracking.generate(domainAddress)` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domain-Tracking/#tag/Domain-Tracking/operation/httpapi.(*HttpAPI).generateStatusV2-fm-8)
+
+  Example:
+
+  ```JS
+  mg.domains.domainTracking.generate('foobar.example.com')
+    .then(msg => console.log(msg)) // logs response data
+    .catch(err => console.error(err)); // logs any error
+  ```
+
+  Promise returns:
+
+  ```JS
+  {
+    message: 'Initiated x509 key pair generation',
+    location: '/v2/x509/example.com/status',
+    status: 202,
+  }
+  ```
+
+- #### regenerate
+  Initiates regeneration of an expired TLS certificate for the tracking domain in a background task. Once generation is enqueued, you may poll status endpoint in location field to check for success. This will not regenerate an existing certificate that is still valid
+
+  `mg.domains.domainTracking.regenerate(domainAddress)` [api docs](https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Domain-Tracking/#tag/Domain-Tracking/operation/httpapi.(*HttpAPI).generateStatusV2-fm-8)
+
+  Example:
+
+  ```JS
+  mg.domains.domainTracking.regenerate('foobar.example.com')
+    .then(msg => console.log(msg)) // logs response data
+    .catch(err => console.error(err)); // logs any error
+  ```
+
+  Promise returns:
+
+  ```JS
+  {
+    message: 'Initiated x509 key pair generation',
+    location: '/v2/x509/example.com/status',
+    status: 202,
+  }
+  ```
+
 ### Events
 
 - #### get

package/{Classes → Types/Classes}/Domains/domain.d.ts

@@ -1,4 +1,4 @@
-import { DNSRecord, DomainData, TDomain } from '../../Types/Domains';
+import { DNSRecord, DomainData, TDomain } from '../../Types/Domains/index.js';
 export default class Domain implements TDomain {
     name: string;
     require_tls: boolean;

package/{Classes → Types/Classes}/Domains/domainsClient.d.ts

@@ -1,25 +1,20 @@
-import { IDomainTemplatesClient, IDomainTagsClient, IDomainCredentials, IDomainsClient } from '../../Interfaces/Domains';
-import { APIResponse } from '../../Types/Common/ApiResponse';
-import Request from '../common/Request';
-import DomainCredentialsClient from './domainsCredentials';
-import DomainTemplatesClient from './domainsTemplates';
-import DomainTagsClient from './domainsTags';
-import { MessageResponse, DomainTrackingData, UpdatedOpenTracking, DomainsQuery, DomainInfo, ConnectionSettings, UpdatedConnectionSettings, OpenTrackingInfo, ClickTrackingInfo, UnsubscribeTrackingInfo, ReplacementForPool, DKIMAuthorityInfo, UpdatedDKIMAuthority, DKIMSelectorInfo, WebPrefixInfo, UpdatedWebPrefixResponse, TDomain, DomainUpdateInfo, DomainGetQuery, UpdatedDKIMSelectorResult } from '../../Types/Domains';
-import { ILogger } from '../../Interfaces';
+import { IDomainTemplatesClient, IDomainTagsClient, IDomainCredentials, IDomainsClient } from '../../Interfaces/Domains/index.js';
+import { APIResponse } from '../../Types/Common/ApiResponse.js';
+import Request from '../common/Request.js';
+import { MessageResponse, DomainTrackingData, UpdatedOpenTracking, DomainsQuery, DomainInfo, ConnectionSettings, UpdatedConnectionSettings, OpenTrackingInfo, ClickTrackingInfo, UnsubscribeTrackingInfo, ReplacementForPool, DKIMAuthorityInfo, UpdatedDKIMAuthority, DKIMSelectorInfo, WebPrefixInfo, UpdatedWebPrefixResponse, TDomain, DomainUpdateInfo, DomainGetQuery, UpdatedDKIMSelectorResult } from '../../Types/Domains/index.js';
+import { ILogger, IDomainTrackingClient } from '../../Interfaces/index.js';
 export default class DomainsClient implements IDomainsClient {
     request: Request;
     domainCredentials: IDomainCredentials;
     domainTemplates: IDomainTemplatesClient;
     domainTags: IDomainTagsClient;
+    domainTracking: IDomainTrackingClient;
     private logger;
-    constructor(request: Request, domainCredentialsClient: DomainCredentialsClient, domainTemplatesClient: DomainTemplatesClient, domainTagsClient: DomainTagsClient, logger?: ILogger);
+    constructor(request: Request, domainCredentialsClient: IDomainCredentials, domainTemplatesClient: IDomainTemplatesClient, domainTagsClient: IDomainTagsClient, domainTracking: IDomainTrackingClient, logger?: ILogger);
     private _handleBoolValues;
     private _parseMessage;
     private parseDomainList;
     private _parseDomain;
-    private _parseTrackingSettings;
-    private _parseTrackingUpdate;
-    private _isOpenTrackingInfoWitPlace;
     list(query?: DomainsQuery): Promise<TDomain[]>;
     get(domain: string, query?: DomainGetQuery): Promise<TDomain>;
     create(data: DomainInfo): Promise<TDomain>;
@@ -28,7 +23,15 @@ export default class DomainsClient implements IDomainsClient {
     destroy(domain: string): Promise<MessageResponse>;
     getConnection(domain: string): Promise<ConnectionSettings>;
     updateConnection(domain: string, data: ConnectionSettings): Promise<UpdatedConnectionSettings>;
+    /**
+    * @deprecated 'domains.getTracking' method is deprecated, and will be removed.
+    * Please use 'domains.domainTracking.getTracking' instead.
+    */
     getTracking(domain: string): Promise<DomainTrackingData>;
+    /**
+    * @deprecated 'domains.updateTracking' method is deprecated, and will be removed.
+    * Please use 'domains.domainTracking.updateTracking' instead.
+    */
     updateTracking(domain: string, type: string, data: OpenTrackingInfo | ClickTrackingInfo | UnsubscribeTrackingInfo): Promise<UpdatedOpenTracking>;
     /**
     * @deprecated "domains.getIps" method is deprecated, and will be removed in the future releases.

package/{Classes → Types/Classes}/Domains/domainsCredentials.d.ts

@@ -1,6 +1,6 @@
-import { IDomainCredentials } from '../../Interfaces/Domains';
-import { DomainCredentialsList, DomainCredentialsResult, DomainCredentialsQuery, DomainCredentials, UpdateDomainCredentialsData } from '../../Types/Domains';
-import Request from '../common/Request';
+import { IDomainCredentials } from '../../Interfaces/Domains/index.js';
+import { DomainCredentialsList, DomainCredentialsResult, DomainCredentialsQuery, DomainCredentials, UpdateDomainCredentialsData } from '../../Types/Domains/index.js';
+import Request from '../common/Request.js';
 export default class DomainCredentialsClient implements IDomainCredentials {
     baseRoute: string;
     request: Request;

package/{Classes → Types/Classes}/Domains/domainsTags.d.ts

@@ -1,8 +1,8 @@
-import Request from '../common/Request';
-import { IDomainTagStatisticResult, IDomainTagsClient } from '../../Interfaces/Domains';
-import NavigationThruPages from '../common/NavigationThruPages';
-import { Resolution } from '../../Enums';
-import { DomainTagsItem, DomainTagsItemInfo, DomainTagStatisticItem, DomainTagStatAPIResponse, DomainTagsList, DomainTagsResponseData, DomainTagsQuery, DomainTagsMessageRes, DomainTagsStatisticQuery, DomainTagCountriesAggregation, DomainTagProvidersAggregation, DomainTagDevicesAggregation } from '../../Types/Domains';
+import Request from '../common/Request.js';
+import { IDomainTagStatisticResult, IDomainTagsClient } from '../../Interfaces/Domains/index.js';
+import NavigationThruPages from '../common/NavigationThruPages.js';
+import { Resolution } from '../../Enums/index.js';
+import { DomainTagsItem, DomainTagsItemInfo, DomainTagStatisticItem, DomainTagStatAPIResponse, DomainTagsList, DomainTagsResponseData, DomainTagsQuery, DomainTagsMessageRes, DomainTagsStatisticQuery, DomainTagCountriesAggregation, DomainTagProvidersAggregation, DomainTagDevicesAggregation } from '../../Types/Domains/index.js';
 export declare class DomainTag implements DomainTagsItem {
     tag: string;
     description: string;

package/{Classes → Types/Classes}/Domains/domainsTemplates.d.ts

@@ -1,7 +1,7 @@
-import Request from '../common/Request';
-import { CreateDomainTemplateVersionResult, DomainTemplateData, DomainTemplatesQuery, DomainTemplateUpdateData, DomainTemplateUpdateVersionData, DomainTemplateVersionData, ListDomainTemplatesAPIResponse, ListDomainTemplatesResult, ListDomainTemplateVersionsResult, MutateDomainTemplateVersionResult, NotificationResult, ShortTemplateVersion, TemplateQuery, TemplateVersion, UpdateOrDeleteDomainTemplateResult } from '../../Types/Domains';
-import NavigationThruPages from '../common/NavigationThruPages';
-import { IDomainTemplate, IDomainTemplatesClient } from '../../Interfaces/Domains';
+import Request from '../common/Request.js';
+import { CreateDomainTemplateVersionResult, DomainTemplateData, DomainTemplatesQuery, DomainTemplateUpdateData, DomainTemplateUpdateVersionData, DomainTemplateVersionData, ListDomainTemplatesAPIResponse, ListDomainTemplatesResult, ListDomainTemplateVersionsResult, MutateDomainTemplateVersionResult, NotificationResult, ShortTemplateVersion, TemplateQuery, TemplateVersion, UpdateOrDeleteDomainTemplateResult } from '../../Types/Domains/index.js';
+import NavigationThruPages from '../common/NavigationThruPages.js';
+import { IDomainTemplate, IDomainTemplatesClient } from '../../Interfaces/Domains/index.js';
 export declare class DomainTemplateItem implements IDomainTemplate {
     name: string;
     description: string;