mailchannels-sdk 0.7.0 → 0.7.1

package/README.md

@@ -77,6 +77,7 @@ Already implemented features are marked with a checkmark. Please open an issue i
 
 - 📧 Emails
   - ✅ [Send an Email](https://docs.mailchannels.net/email-api/api-reference/send-an-email)
+  - ✅ [Send an Email Asynchronously](https://docs.mailchannels.net/email-api/api-reference/send-an-email-asynchronously)
   - ✅ [DKIM, SPF & Domain Lockdown Check](https://docs.mailchannels.net/email-api/api-reference/dkim-spf-domain-lockdown-check)
   - ✅ [Create DKIM Key Pair](https://docs.mailchannels.net/email-api/api-reference/create-dkim-key-pair)
   - ✅ [Retrieve DKIM Keys](https://docs.mailchannels.net/email-api/api-reference/retrieve-dkim-keys)

package/dist/mailchannels.d.mts

@@ -28,7 +28,7 @@ interface SuccessResponse {
   error: ErrorResponse | null;
 }
 
-type DataResponse<T> = {
+type DataResponse$1<T> = {
   /**
    * The response data.
    */
@@ -252,35 +252,46 @@ type EmailsSendOptions = EmailsSendOptionsBase & (
   }
 );
 
-type EmailsSendResponse = SuccessResponse & DataResponse<{
+type EmailsSendResponse = SuccessResponse & DataResponse$1<{
   /**
-     * Fully rendered message if `dryRun` was set to `true`. A string representation of a rendered message, one per personalization in the request.
-     */
+   * Fully rendered message if `dryRun` was set to `true`. A string representation of a rendered message, one per personalization in the request.
+   */
   rendered?: string[];
   /**
-     * The Request ID is a unique identifier generated by the service to track the HTTP request. It will also be included in all webhooks for reference.
-     */
+   * The Request ID is a unique identifier generated by the service to track the HTTP request. It will also be included in all webhooks for reference.
+   */
   requestId?: string;
   results?: {
     /**
-       * The index of the personalization in the request. Starts at 0.
-       */
+     * The index of the personalization in the request. Starts at 0.
+     */
     index?: number;
     /**
-       * The Message ID is a unique identifier generated by the service. Each personalization has a distinct Message ID, which is also used in the `Message-Id` header and included in webhooks.
-       */
+     * The Message ID is a unique identifier generated by the service. Each personalization has a distinct Message ID, which is also used in the `Message-Id` header and included in webhooks.
+     */
     messageId: string;
     /**
-       * A human-readable explanation of the status.
-       */
+     * A human-readable explanation of the status.
+     */
     reason?: string;
     /**
-       * The status of the message. Note that 'sent' is a temporary status; the final status will be provided through webhooks, if configured.
-       */
+     * The status of the message. Note that 'sent' is a temporary status; the final status will be provided through webhooks, if configured.
+     */
     status: "sent" | "failed";
   }[];
 }>;
 
+type EmailsSendAsyncResponse = DataResponse<{
+  /**
+   * ISO 8601 timestamp when the request was queued for processing.
+   */
+  queuedAt: string[];
+  /**
+   * Unique identifier for tracking this async request. Will be included in all webhook events for this request.
+   */
+  requestId: string;
+}>;
+
 interface EmailsCreateDkimKeyOptions {
   /**
    * Algorithm used for the new key pair Currently, only RSA is supported.
@@ -348,7 +359,7 @@ interface EmailsDkimKey {
   statusModifiedAt?: string;
 }
 
-type EmailsCreateDkimKeyResponse = DataResponse<EmailsDkimKey>;
+type EmailsCreateDkimKeyResponse = DataResponse$1<EmailsDkimKey>;
 
 interface EmailsCheckDomainDkim {
   /**
@@ -388,7 +399,7 @@ interface EmailsCheckDomainOptions {
 
 type EmailsCheckDomainVerdict = "passed" | "failed" | "soft failed" | "temporary error" | "permanent error" | "neutral" | "none" | "unknown";
 
-type EmailsCheckDomainResponse = DataResponse<{
+type EmailsCheckDomainResponse = DataResponse$1<{
   dkim: {
     domain: string;
     /**
@@ -470,7 +481,7 @@ interface EmailsGetDkimKeysOptions {
 
 type Optional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
 
-type EmailsGetDkimKeysResponse = DataResponse<Optional<EmailsDkimKey, "dnsRecords">[]>;
+type EmailsGetDkimKeysResponse = DataResponse$1<Optional<EmailsDkimKey, "dnsRecords">[]>;
 
 interface EmailsUpdateDkimKeyOptions {
   /**
@@ -495,7 +506,7 @@ interface EmailsRotateDkimKeyOptions {
   };
 }
 
-type EmailsRotateDkimKeyResponse = DataResponse<{
+type EmailsRotateDkimKeyResponse = DataResponse$1<{
   new: EmailsDkimKey;
   rotated: EmailsDkimKey;
 }>;
@@ -503,14 +514,15 @@ type EmailsRotateDkimKeyResponse = DataResponse<{
 declare class Emails {
     protected mailchannels: MailChannelsClient;
     constructor(mailchannels: MailChannelsClient);
+    private _sendEmail;
     /**
-     * Send an email using MailChannels Email API.
+     * Sends an email message to one or more recipients.
      * @param options - The email options to send.
      * @param dryRun - When set to `true`, the message will not be sent. Instead, the fully rendered message will be returned in the `data` property of the response. The default value is `false`.
      * @example
      * ```ts
      * const mailchannels = new MailChannels('your-api-key')
-     * const { success, data } = await mailchannels.emails.send({
+     * const { success, data, error } = await mailchannels.emails.send({
      *   to: 'to@example.com',
      *   from: 'from@example.com',
      *   subject: 'Test',
@@ -519,13 +531,32 @@ declare class Emails {
      * ```
      */
     send(options: EmailsSendOptions, dryRun?: boolean): Promise<EmailsSendResponse>;
+    /**
+     * Queues an email message for asynchronous processing and returns immediately with a request ID.
+     *
+     * The email will be processed in the background, and you'll receive webhook events for all delivery status updates (e.g. `dropped`, `processed`, `delivered`, `hard-bounced`). These webhook events are identical to those sent for the synchronous /send endpoint.
+     *
+     * Use this endpoint when you need to send emails without waiting for processing to complete. This can improve your application's response time, especially when sending to multiple recipients.
+     * @param options - The email options to send.
+     * @example
+     * ```ts
+     * const mailchannels = new MailChannels('your-api-key')
+     * const { data, error } = await mailchannels.emails.sendAsync({
+     *   to: 'to@example.com',
+     *   from: 'from@example.com',
+     *   subject: 'Test',
+     *   html: 'Test'
+     * })
+     * ```
+     */
+    sendAsync(options: EmailsSendOptions): Promise<EmailsSendAsyncResponse>;
     /**
      * Validates a domain's email authentication setup by retrieving its DKIM, SPF, and Domain Lockdown status. This endpoint checks whether the domain is properly configured for secure email delivery.
      * @param options - The domain options to check.
      * @example
      * ```ts
      * const mailchannels = new MailChannels('your-api-key')
-     * const { results } = await mailchannels.emails.checkDomain({
+     * const { data, error } = await mailchannels.emails.checkDomain({
      *   dkim: [{
      *     domain: 'example.com',
      *     privateKey: 'your-private-key',
@@ -595,13 +626,13 @@ declare class Emails {
     rotateDkimKey(domain: string, selector: string, options: EmailsRotateDkimKeyOptions): Promise<EmailsRotateDkimKeyResponse>;
 }
 
-type WebhooksListResponse = DataResponse<string[]>;
+type WebhooksListResponse = DataResponse$1<string[]>;
 
-type WebhooksSigningKeyResponse = DataResponse<{
+type WebhooksSigningKeyResponse = DataResponse$1<{
   key: string;
 }>;
 
-type WebhooksValidateResponse = DataResponse<{
+type WebhooksValidateResponse = DataResponse$1<{
   /**
    * Indicates whether all webhook validations passed.
    */
@@ -702,7 +733,7 @@ interface SubAccountsAccount {
   handle: string;
 }
 
-type SubAccountsCreateResponse = DataResponse<SubAccountsAccount>;
+type SubAccountsCreateResponse = DataResponse$1<SubAccountsAccount>;
 
 interface SubAccountsListOptions {
   /**
@@ -717,7 +748,7 @@ interface SubAccountsListOptions {
   offset?: number;
 }
 
-type SubAccountsListResponse = DataResponse<SubAccountsAccount[]>;
+type SubAccountsListResponse = DataResponse$1<SubAccountsAccount[]>;
 
 interface SubAccountsApiKey {
   /**
@@ -730,7 +761,7 @@ interface SubAccountsApiKey {
   value: string;
 }
 
-type SubAccountsCreateApiKeyResponse = DataResponse<SubAccountsApiKey>;
+type SubAccountsCreateApiKeyResponse = DataResponse$1<SubAccountsApiKey>;
 
 interface SubAccountsListApiKeyOptions {
   /**
@@ -745,7 +776,7 @@ interface SubAccountsListApiKeyOptions {
   offset?: number;
 }
 
-type SubAccountsListApiKeyResponse = DataResponse<SubAccountsApiKey[]>;
+type SubAccountsListApiKeyResponse = DataResponse$1<SubAccountsApiKey[]>;
 
 interface SubAccountsSmtpPassword {
   /**
@@ -762,15 +793,15 @@ interface SubAccountsSmtpPassword {
   value: string;
 }
 
-type SubAccountsCreateSmtpPasswordResponse = DataResponse<SubAccountsSmtpPassword>;
+type SubAccountsCreateSmtpPasswordResponse = DataResponse$1<SubAccountsSmtpPassword>;
 
-type SubAccountsListSmtpPasswordResponse = DataResponse<SubAccountsSmtpPassword[]>;
+type SubAccountsListSmtpPasswordResponse = DataResponse$1<SubAccountsSmtpPassword[]>;
 
 interface SubAccountsLimit {
   sends: number;
 }
 
-type SubAccountsLimitResponse = DataResponse<SubAccountsLimit>;
+type SubAccountsLimitResponse = DataResponse$1<SubAccountsLimit>;
 
 interface SubAccountsUsage {
   /**
@@ -789,7 +820,7 @@ interface SubAccountsUsage {
   total: number;
 }
 
-type SubAccountsUsageResponse = DataResponse<SubAccountsUsage>;
+type SubAccountsUsageResponse = DataResponse$1<SubAccountsUsage>;
 
 declare class SubAccounts {
     protected mailchannels: MailChannelsClient;
@@ -970,7 +1001,7 @@ interface MetricsEngagement {
   startTime: string;
 }
 
-type MetricsEngagementResponse = DataResponse<MetricsEngagement>;
+type MetricsEngagementResponse = DataResponse$1<MetricsEngagement>;
 
 interface MetricsPerformance {
   /**
@@ -1003,7 +1034,7 @@ interface MetricsPerformance {
   startTime: string;
 }
 
-type MetricsPerformanceResponse = DataResponse<MetricsPerformance>;
+type MetricsPerformanceResponse = DataResponse$1<MetricsPerformance>;
 
 interface MetricsRecipientBehaviour {
   /**
@@ -1031,7 +1062,7 @@ interface MetricsRecipientBehaviour {
   unsubscribed: number;
 }
 
-type MetricsRecipientBehaviourResponse = DataResponse<MetricsRecipientBehaviour>;
+type MetricsRecipientBehaviourResponse = DataResponse$1<MetricsRecipientBehaviour>;
 
 interface MetricsVolume {
   /**
@@ -1064,9 +1095,9 @@ interface MetricsVolume {
   startTime: string;
 }
 
-type MetricsVolumeResponse = DataResponse<MetricsVolume>;
+type MetricsVolumeResponse = DataResponse$1<MetricsVolume>;
 
-type MetricsUsageResponse = DataResponse<{
+type MetricsUsageResponse = DataResponse$1<{
   /**
    * The end date of the current billing period (ISO 8601 format).
    * @example "2025-04-11"
@@ -1134,7 +1165,7 @@ interface MetricsSenders {
   total: number;
 }
 
-type MetricsSendersResponse = DataResponse<MetricsSenders>;
+type MetricsSendersResponse = DataResponse$1<MetricsSenders>;
 
 interface MetricsBucket {
   /**
@@ -1305,7 +1336,7 @@ interface SuppressionsListEntry {
   types: SuppressionsTypes[];
 }
 
-type SuppressionsListResponse = DataResponse<SuppressionsListEntry[]>;
+type SuppressionsListResponse = DataResponse$1<SuppressionsListEntry[]>;
 
 declare class Suppressions {
     protected mailchannels: MailChannelsClient;
@@ -1363,9 +1394,9 @@ interface ListEntry {
   type: "domain" | "email_address" | "ip_address";
 }
 
-type ListEntryResponse = DataResponse<ListEntry>;
+type ListEntryResponse = DataResponse$1<ListEntry>;
 
-type ListEntriesResponse = DataResponse<ListEntry[]>;
+type ListEntriesResponse = DataResponse$1<ListEntry[]>;
 
 interface DomainsData {
   /**
@@ -1441,9 +1472,9 @@ interface DomainsProvisionOptions {
 
 type DomainsBulkProvisionOptions = DomainsProvisionOptions & Pick<DomainsData, "subscriptionHandle">;
 
-type DomainsProvisionResponse = DataResponse<DomainsData>;
+type DomainsProvisionResponse = DataResponse$1<DomainsData>;
 
-type DomainsBulkProvisionResponse = DataResponse<{
+type DomainsBulkProvisionResponse = DataResponse$1<{
   /**
    * Domains that were successfully provisioned or updated.
    */
@@ -1485,7 +1516,7 @@ interface DomainsListOptions {
   offset?: number;
 }
 
-type DomainsListResponse = DataResponse<{
+type DomainsListResponse = DataResponse$1<{
   /**
    * A list of domains.
    */
@@ -1503,7 +1534,7 @@ interface DomainsCreateLoginLink {
   link: string;
 }
 
-type DomainsCreateLoginLinkResponse = DataResponse<DomainsCreateLoginLink>;
+type DomainsCreateLoginLinkResponse = DataResponse$1<DomainsCreateLoginLink>;
 
 interface DomainsListDownstreamAddressesOptions {
   /**
@@ -1537,7 +1568,7 @@ interface DomainsDownstreamAddress {
   weight: number;
 }
 
-type DomainsListDownstreamAddressesResponse = DataResponse<DomainsDownstreamAddress[]>;
+type DomainsListDownstreamAddressesResponse = DataResponse$1<DomainsDownstreamAddress[]>;
 
 interface DomainsBulkCreateLoginLinkResult {
   /**
@@ -1560,7 +1591,7 @@ interface DomainsBulkCreateLoginLinks {
   errors: Omit<DomainsBulkCreateLoginLinkResult, "loginLink">[];
 }
 
-type DomainsBulkCreateLoginLinksResponse = DataResponse<DomainsBulkCreateLoginLinks>;
+type DomainsBulkCreateLoginLinksResponse = DataResponse$1<DomainsBulkCreateLoginLinks>;
 
 declare class Domains {
     protected mailchannels: MailChannelsClient;
@@ -1784,7 +1815,7 @@ interface UsersCreateOptions {
   };
 }
 
-type UsersCreateResponse = DataResponse<{
+type UsersCreateResponse = DataResponse$1<{
   email: string;
   roles: string[];
   filter?: boolean;
@@ -1852,7 +1883,7 @@ declare class Users {
     deleteListEntry(email: string, options: ListEntryOptions): Promise<SuccessResponse>;
 }
 
-type ServiceSubscriptionsResponse = DataResponse<{
+type ServiceSubscriptionsResponse = DataResponse$1<{
   active: boolean;
   activeAccountsCount: number;
   handle: string;
@@ -1940,4 +1971,4 @@ declare class MailChannels extends MailChannelsClient {
 }
 
 export { Domains, Emails, Lists, MailChannels, MailChannelsClient, Metrics, Service, SubAccounts, Suppressions, Users, Webhooks };
-export type { DataResponse, DomainsBulkCreateLoginLinkResult, DomainsBulkCreateLoginLinks, DomainsBulkCreateLoginLinksResponse, DomainsBulkProvisionOptions, DomainsBulkProvisionResponse, DomainsCreateLoginLink, DomainsCreateLoginLinkResponse, DomainsData, DomainsDownstreamAddress, DomainsListDownstreamAddressesOptions, DomainsListDownstreamAddressesResponse, DomainsListOptions, DomainsListResponse, DomainsProvisionOptions, DomainsProvisionResponse, EmailsCheckDomainDkim, EmailsCheckDomainOptions, EmailsCheckDomainResponse, EmailsCheckDomainVerdict, EmailsCreateDkimKeyOptions, EmailsCreateDkimKeyResponse, EmailsDkimKey, EmailsDkimKeyStatus, EmailsGetDkimKeysOptions, EmailsGetDkimKeysResponse, EmailsRotateDkimKeyOptions, EmailsRotateDkimKeyResponse, EmailsSendAttachment, EmailsSendOptions, EmailsSendOptionsBase, EmailsSendRecipient, EmailsSendResponse, EmailsSendTracking, EmailsUpdateDkimKeyOptions, ErrorResponse, ListEntriesResponse, ListEntry, ListEntryOptions, ListEntryResponse, ListNames, MetricsBucket, MetricsEngagement, MetricsEngagementResponse, MetricsOptions, MetricsPerformance, MetricsPerformanceResponse, MetricsRecipientBehaviour, MetricsRecipientBehaviourResponse, MetricsSenders, MetricsSendersOptions, MetricsSendersResponse, MetricsSendersType, MetricsUsageResponse, MetricsVolume, MetricsVolumeResponse, Optional, ServiceReportOptions, ServiceSubscriptionsResponse, SubAccountsAccount, SubAccountsApiKey, SubAccountsCreateApiKeyResponse, SubAccountsCreateResponse, SubAccountsCreateSmtpPasswordResponse, SubAccountsLimit, SubAccountsLimitResponse, SubAccountsListApiKeyOptions, SubAccountsListApiKeyResponse, SubAccountsListOptions, SubAccountsListResponse, SubAccountsListSmtpPasswordResponse, SubAccountsSmtpPassword, SubAccountsUsage, SubAccountsUsageResponse, SuccessResponse, SuppressionsCreateOptions, SuppressionsListEntry, SuppressionsListOptions, SuppressionsListResponse, SuppressionsSource, SuppressionsTypes, UsersCreateOptions, UsersCreateResponse, WebhooksListResponse, WebhooksSigningKeyResponse, WebhooksValidateResponse };
+export type { DataResponse$1 as DataResponse, DomainsBulkCreateLoginLinkResult, DomainsBulkCreateLoginLinks, DomainsBulkCreateLoginLinksResponse, DomainsBulkProvisionOptions, DomainsBulkProvisionResponse, DomainsCreateLoginLink, DomainsCreateLoginLinkResponse, DomainsData, DomainsDownstreamAddress, DomainsListDownstreamAddressesOptions, DomainsListDownstreamAddressesResponse, DomainsListOptions, DomainsListResponse, DomainsProvisionOptions, DomainsProvisionResponse, EmailsCheckDomainDkim, EmailsCheckDomainOptions, EmailsCheckDomainResponse, EmailsCheckDomainVerdict, EmailsCreateDkimKeyOptions, EmailsCreateDkimKeyResponse, EmailsDkimKey, EmailsDkimKeyStatus, EmailsGetDkimKeysOptions, EmailsGetDkimKeysResponse, EmailsRotateDkimKeyOptions, EmailsRotateDkimKeyResponse, EmailsSendAsyncResponse, EmailsSendAttachment, EmailsSendOptions, EmailsSendOptionsBase, EmailsSendRecipient, EmailsSendResponse, EmailsSendTracking, EmailsUpdateDkimKeyOptions, ErrorResponse, ListEntriesResponse, ListEntry, ListEntryOptions, ListEntryResponse, ListNames, MetricsBucket, MetricsEngagement, MetricsEngagementResponse, MetricsOptions, MetricsPerformance, MetricsPerformanceResponse, MetricsRecipientBehaviour, MetricsRecipientBehaviourResponse, MetricsSenders, MetricsSendersOptions, MetricsSendersResponse, MetricsSendersType, MetricsUsageResponse, MetricsVolume, MetricsVolumeResponse, Optional, ServiceReportOptions, ServiceSubscriptionsResponse, SubAccountsAccount, SubAccountsApiKey, SubAccountsCreateApiKeyResponse, SubAccountsCreateResponse, SubAccountsCreateSmtpPasswordResponse, SubAccountsLimit, SubAccountsLimitResponse, SubAccountsListApiKeyOptions, SubAccountsListApiKeyResponse, SubAccountsListOptions, SubAccountsListResponse, SubAccountsListSmtpPasswordResponse, SubAccountsSmtpPassword, SubAccountsUsage, SubAccountsUsageResponse, SuccessResponse, SuppressionsCreateOptions, SuppressionsListEntry, SuppressionsListOptions, SuppressionsListResponse, SuppressionsSource, SuppressionsTypes, UsersCreateOptions, UsersCreateResponse, WebhooksListResponse, WebhooksSigningKeyResponse, WebhooksValidateResponse };

package/dist/mailchannels.d.ts

@@ -28,7 +28,7 @@ interface SuccessResponse {
   error: ErrorResponse | null;
 }
 
-type DataResponse<T> = {
+type DataResponse$1<T> = {
   /**
    * The response data.
    */
@@ -252,35 +252,46 @@ type EmailsSendOptions = EmailsSendOptionsBase & (
   }
 );
 
-type EmailsSendResponse = SuccessResponse & DataResponse<{
+type EmailsSendResponse = SuccessResponse & DataResponse$1<{
   /**
-     * Fully rendered message if `dryRun` was set to `true`. A string representation of a rendered message, one per personalization in the request.
-     */
+   * Fully rendered message if `dryRun` was set to `true`. A string representation of a rendered message, one per personalization in the request.
+   */
   rendered?: string[];
   /**
-     * The Request ID is a unique identifier generated by the service to track the HTTP request. It will also be included in all webhooks for reference.
-     */
+   * The Request ID is a unique identifier generated by the service to track the HTTP request. It will also be included in all webhooks for reference.
+   */
   requestId?: string;
   results?: {
     /**
-       * The index of the personalization in the request. Starts at 0.
-       */
+     * The index of the personalization in the request. Starts at 0.
+     */
     index?: number;
     /**
-       * The Message ID is a unique identifier generated by the service. Each personalization has a distinct Message ID, which is also used in the `Message-Id` header and included in webhooks.
-       */
+     * The Message ID is a unique identifier generated by the service. Each personalization has a distinct Message ID, which is also used in the `Message-Id` header and included in webhooks.
+     */
     messageId: string;
     /**
-       * A human-readable explanation of the status.
-       */
+     * A human-readable explanation of the status.
+     */
     reason?: string;
     /**
-       * The status of the message. Note that 'sent' is a temporary status; the final status will be provided through webhooks, if configured.
-       */
+     * The status of the message. Note that 'sent' is a temporary status; the final status will be provided through webhooks, if configured.
+     */
     status: "sent" | "failed";
   }[];
 }>;
 
+type EmailsSendAsyncResponse = DataResponse<{
+  /**
+   * ISO 8601 timestamp when the request was queued for processing.
+   */
+  queuedAt: string[];
+  /**
+   * Unique identifier for tracking this async request. Will be included in all webhook events for this request.
+   */
+  requestId: string;
+}>;
+
 interface EmailsCreateDkimKeyOptions {
   /**
    * Algorithm used for the new key pair Currently, only RSA is supported.
@@ -348,7 +359,7 @@ interface EmailsDkimKey {
   statusModifiedAt?: string;
 }
 
-type EmailsCreateDkimKeyResponse = DataResponse<EmailsDkimKey>;
+type EmailsCreateDkimKeyResponse = DataResponse$1<EmailsDkimKey>;
 
 interface EmailsCheckDomainDkim {
   /**
@@ -388,7 +399,7 @@ interface EmailsCheckDomainOptions {
 
 type EmailsCheckDomainVerdict = "passed" | "failed" | "soft failed" | "temporary error" | "permanent error" | "neutral" | "none" | "unknown";
 
-type EmailsCheckDomainResponse = DataResponse<{
+type EmailsCheckDomainResponse = DataResponse$1<{
   dkim: {
     domain: string;
     /**
@@ -470,7 +481,7 @@ interface EmailsGetDkimKeysOptions {
 
 type Optional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
 
-type EmailsGetDkimKeysResponse = DataResponse<Optional<EmailsDkimKey, "dnsRecords">[]>;
+type EmailsGetDkimKeysResponse = DataResponse$1<Optional<EmailsDkimKey, "dnsRecords">[]>;
 
 interface EmailsUpdateDkimKeyOptions {
   /**
@@ -495,7 +506,7 @@ interface EmailsRotateDkimKeyOptions {
   };
 }
 
-type EmailsRotateDkimKeyResponse = DataResponse<{
+type EmailsRotateDkimKeyResponse = DataResponse$1<{
   new: EmailsDkimKey;
   rotated: EmailsDkimKey;
 }>;
@@ -503,14 +514,15 @@ type EmailsRotateDkimKeyResponse = DataResponse<{
 declare class Emails {
     protected mailchannels: MailChannelsClient;
     constructor(mailchannels: MailChannelsClient);
+    private _sendEmail;
     /**
-     * Send an email using MailChannels Email API.
+     * Sends an email message to one or more recipients.
      * @param options - The email options to send.
      * @param dryRun - When set to `true`, the message will not be sent. Instead, the fully rendered message will be returned in the `data` property of the response. The default value is `false`.
      * @example
      * ```ts
      * const mailchannels = new MailChannels('your-api-key')
-     * const { success, data } = await mailchannels.emails.send({
+     * const { success, data, error } = await mailchannels.emails.send({
      *   to: 'to@example.com',
      *   from: 'from@example.com',
      *   subject: 'Test',
@@ -519,13 +531,32 @@ declare class Emails {
      * ```
      */
     send(options: EmailsSendOptions, dryRun?: boolean): Promise<EmailsSendResponse>;
+    /**
+     * Queues an email message for asynchronous processing and returns immediately with a request ID.
+     *
+     * The email will be processed in the background, and you'll receive webhook events for all delivery status updates (e.g. `dropped`, `processed`, `delivered`, `hard-bounced`). These webhook events are identical to those sent for the synchronous /send endpoint.
+     *
+     * Use this endpoint when you need to send emails without waiting for processing to complete. This can improve your application's response time, especially when sending to multiple recipients.
+     * @param options - The email options to send.
+     * @example
+     * ```ts
+     * const mailchannels = new MailChannels('your-api-key')
+     * const { data, error } = await mailchannels.emails.sendAsync({
+     *   to: 'to@example.com',
+     *   from: 'from@example.com',
+     *   subject: 'Test',
+     *   html: 'Test'
+     * })
+     * ```
+     */
+    sendAsync(options: EmailsSendOptions): Promise<EmailsSendAsyncResponse>;
     /**
      * Validates a domain's email authentication setup by retrieving its DKIM, SPF, and Domain Lockdown status. This endpoint checks whether the domain is properly configured for secure email delivery.
      * @param options - The domain options to check.
      * @example
      * ```ts
      * const mailchannels = new MailChannels('your-api-key')
-     * const { results } = await mailchannels.emails.checkDomain({
+     * const { data, error } = await mailchannels.emails.checkDomain({
      *   dkim: [{
      *     domain: 'example.com',
      *     privateKey: 'your-private-key',
@@ -595,13 +626,13 @@ declare class Emails {
     rotateDkimKey(domain: string, selector: string, options: EmailsRotateDkimKeyOptions): Promise<EmailsRotateDkimKeyResponse>;
 }
 
-type WebhooksListResponse = DataResponse<string[]>;
+type WebhooksListResponse = DataResponse$1<string[]>;
 
-type WebhooksSigningKeyResponse = DataResponse<{
+type WebhooksSigningKeyResponse = DataResponse$1<{
   key: string;
 }>;
 
-type WebhooksValidateResponse = DataResponse<{
+type WebhooksValidateResponse = DataResponse$1<{
   /**
    * Indicates whether all webhook validations passed.
    */
@@ -702,7 +733,7 @@ interface SubAccountsAccount {
   handle: string;
 }
 
-type SubAccountsCreateResponse = DataResponse<SubAccountsAccount>;
+type SubAccountsCreateResponse = DataResponse$1<SubAccountsAccount>;
 
 interface SubAccountsListOptions {
   /**
@@ -717,7 +748,7 @@ interface SubAccountsListOptions {
   offset?: number;
 }
 
-type SubAccountsListResponse = DataResponse<SubAccountsAccount[]>;
+type SubAccountsListResponse = DataResponse$1<SubAccountsAccount[]>;
 
 interface SubAccountsApiKey {
   /**
@@ -730,7 +761,7 @@ interface SubAccountsApiKey {
   value: string;
 }
 
-type SubAccountsCreateApiKeyResponse = DataResponse<SubAccountsApiKey>;
+type SubAccountsCreateApiKeyResponse = DataResponse$1<SubAccountsApiKey>;
 
 interface SubAccountsListApiKeyOptions {
   /**
@@ -745,7 +776,7 @@ interface SubAccountsListApiKeyOptions {
   offset?: number;
 }
 
-type SubAccountsListApiKeyResponse = DataResponse<SubAccountsApiKey[]>;
+type SubAccountsListApiKeyResponse = DataResponse$1<SubAccountsApiKey[]>;
 
 interface SubAccountsSmtpPassword {
   /**
@@ -762,15 +793,15 @@ interface SubAccountsSmtpPassword {
   value: string;
 }
 
-type SubAccountsCreateSmtpPasswordResponse = DataResponse<SubAccountsSmtpPassword>;
+type SubAccountsCreateSmtpPasswordResponse = DataResponse$1<SubAccountsSmtpPassword>;
 
-type SubAccountsListSmtpPasswordResponse = DataResponse<SubAccountsSmtpPassword[]>;
+type SubAccountsListSmtpPasswordResponse = DataResponse$1<SubAccountsSmtpPassword[]>;
 
 interface SubAccountsLimit {
   sends: number;
 }
 
-type SubAccountsLimitResponse = DataResponse<SubAccountsLimit>;
+type SubAccountsLimitResponse = DataResponse$1<SubAccountsLimit>;
 
 interface SubAccountsUsage {
   /**
@@ -789,7 +820,7 @@ interface SubAccountsUsage {
   total: number;
 }
 
-type SubAccountsUsageResponse = DataResponse<SubAccountsUsage>;
+type SubAccountsUsageResponse = DataResponse$1<SubAccountsUsage>;
 
 declare class SubAccounts {
     protected mailchannels: MailChannelsClient;
@@ -970,7 +1001,7 @@ interface MetricsEngagement {
   startTime: string;
 }
 
-type MetricsEngagementResponse = DataResponse<MetricsEngagement>;
+type MetricsEngagementResponse = DataResponse$1<MetricsEngagement>;
 
 interface MetricsPerformance {
   /**
@@ -1003,7 +1034,7 @@ interface MetricsPerformance {
   startTime: string;
 }
 
-type MetricsPerformanceResponse = DataResponse<MetricsPerformance>;
+type MetricsPerformanceResponse = DataResponse$1<MetricsPerformance>;
 
 interface MetricsRecipientBehaviour {
   /**
@@ -1031,7 +1062,7 @@ interface MetricsRecipientBehaviour {
   unsubscribed: number;
 }
 
-type MetricsRecipientBehaviourResponse = DataResponse<MetricsRecipientBehaviour>;
+type MetricsRecipientBehaviourResponse = DataResponse$1<MetricsRecipientBehaviour>;
 
 interface MetricsVolume {
   /**
@@ -1064,9 +1095,9 @@ interface MetricsVolume {
   startTime: string;
 }
 
-type MetricsVolumeResponse = DataResponse<MetricsVolume>;
+type MetricsVolumeResponse = DataResponse$1<MetricsVolume>;
 
-type MetricsUsageResponse = DataResponse<{
+type MetricsUsageResponse = DataResponse$1<{
   /**
    * The end date of the current billing period (ISO 8601 format).
    * @example "2025-04-11"
@@ -1134,7 +1165,7 @@ interface MetricsSenders {
   total: number;
 }
 
-type MetricsSendersResponse = DataResponse<MetricsSenders>;
+type MetricsSendersResponse = DataResponse$1<MetricsSenders>;
 
 interface MetricsBucket {
   /**
@@ -1305,7 +1336,7 @@ interface SuppressionsListEntry {
   types: SuppressionsTypes[];
 }
 
-type SuppressionsListResponse = DataResponse<SuppressionsListEntry[]>;
+type SuppressionsListResponse = DataResponse$1<SuppressionsListEntry[]>;
 
 declare class Suppressions {
     protected mailchannels: MailChannelsClient;
@@ -1363,9 +1394,9 @@ interface ListEntry {
   type: "domain" | "email_address" | "ip_address";
 }
 
-type ListEntryResponse = DataResponse<ListEntry>;
+type ListEntryResponse = DataResponse$1<ListEntry>;
 
-type ListEntriesResponse = DataResponse<ListEntry[]>;
+type ListEntriesResponse = DataResponse$1<ListEntry[]>;
 
 interface DomainsData {
   /**
@@ -1441,9 +1472,9 @@ interface DomainsProvisionOptions {
 
 type DomainsBulkProvisionOptions = DomainsProvisionOptions & Pick<DomainsData, "subscriptionHandle">;
 
-type DomainsProvisionResponse = DataResponse<DomainsData>;
+type DomainsProvisionResponse = DataResponse$1<DomainsData>;
 
-type DomainsBulkProvisionResponse = DataResponse<{
+type DomainsBulkProvisionResponse = DataResponse$1<{
   /**
    * Domains that were successfully provisioned or updated.
    */
@@ -1485,7 +1516,7 @@ interface DomainsListOptions {
   offset?: number;
 }
 
-type DomainsListResponse = DataResponse<{
+type DomainsListResponse = DataResponse$1<{
   /**
    * A list of domains.
    */
@@ -1503,7 +1534,7 @@ interface DomainsCreateLoginLink {
   link: string;
 }
 
-type DomainsCreateLoginLinkResponse = DataResponse<DomainsCreateLoginLink>;
+type DomainsCreateLoginLinkResponse = DataResponse$1<DomainsCreateLoginLink>;
 
 interface DomainsListDownstreamAddressesOptions {
   /**
@@ -1537,7 +1568,7 @@ interface DomainsDownstreamAddress {
   weight: number;
 }
 
-type DomainsListDownstreamAddressesResponse = DataResponse<DomainsDownstreamAddress[]>;
+type DomainsListDownstreamAddressesResponse = DataResponse$1<DomainsDownstreamAddress[]>;
 
 interface DomainsBulkCreateLoginLinkResult {
   /**
@@ -1560,7 +1591,7 @@ interface DomainsBulkCreateLoginLinks {
   errors: Omit<DomainsBulkCreateLoginLinkResult, "loginLink">[];
 }
 
-type DomainsBulkCreateLoginLinksResponse = DataResponse<DomainsBulkCreateLoginLinks>;
+type DomainsBulkCreateLoginLinksResponse = DataResponse$1<DomainsBulkCreateLoginLinks>;
 
 declare class Domains {
     protected mailchannels: MailChannelsClient;
@@ -1784,7 +1815,7 @@ interface UsersCreateOptions {
   };
 }
 
-type UsersCreateResponse = DataResponse<{
+type UsersCreateResponse = DataResponse$1<{
   email: string;
   roles: string[];
   filter?: boolean;
@@ -1852,7 +1883,7 @@ declare class Users {
     deleteListEntry(email: string, options: ListEntryOptions): Promise<SuccessResponse>;
 }
 
-type ServiceSubscriptionsResponse = DataResponse<{
+type ServiceSubscriptionsResponse = DataResponse$1<{
   active: boolean;
   activeAccountsCount: number;
   handle: string;
@@ -1940,4 +1971,4 @@ declare class MailChannels extends MailChannelsClient {
 }
 
 export { Domains, Emails, Lists, MailChannels, MailChannelsClient, Metrics, Service, SubAccounts, Suppressions, Users, Webhooks };
-export type { DataResponse, DomainsBulkCreateLoginLinkResult, DomainsBulkCreateLoginLinks, DomainsBulkCreateLoginLinksResponse, DomainsBulkProvisionOptions, DomainsBulkProvisionResponse, DomainsCreateLoginLink, DomainsCreateLoginLinkResponse, DomainsData, DomainsDownstreamAddress, DomainsListDownstreamAddressesOptions, DomainsListDownstreamAddressesResponse, DomainsListOptions, DomainsListResponse, DomainsProvisionOptions, DomainsProvisionResponse, EmailsCheckDomainDkim, EmailsCheckDomainOptions, EmailsCheckDomainResponse, EmailsCheckDomainVerdict, EmailsCreateDkimKeyOptions, EmailsCreateDkimKeyResponse, EmailsDkimKey, EmailsDkimKeyStatus, EmailsGetDkimKeysOptions, EmailsGetDkimKeysResponse, EmailsRotateDkimKeyOptions, EmailsRotateDkimKeyResponse, EmailsSendAttachment, EmailsSendOptions, EmailsSendOptionsBase, EmailsSendRecipient, EmailsSendResponse, EmailsSendTracking, EmailsUpdateDkimKeyOptions, ErrorResponse, ListEntriesResponse, ListEntry, ListEntryOptions, ListEntryResponse, ListNames, MetricsBucket, MetricsEngagement, MetricsEngagementResponse, MetricsOptions, MetricsPerformance, MetricsPerformanceResponse, MetricsRecipientBehaviour, MetricsRecipientBehaviourResponse, MetricsSenders, MetricsSendersOptions, MetricsSendersResponse, MetricsSendersType, MetricsUsageResponse, MetricsVolume, MetricsVolumeResponse, Optional, ServiceReportOptions, ServiceSubscriptionsResponse, SubAccountsAccount, SubAccountsApiKey, SubAccountsCreateApiKeyResponse, SubAccountsCreateResponse, SubAccountsCreateSmtpPasswordResponse, SubAccountsLimit, SubAccountsLimitResponse, SubAccountsListApiKeyOptions, SubAccountsListApiKeyResponse, SubAccountsListOptions, SubAccountsListResponse, SubAccountsListSmtpPasswordResponse, SubAccountsSmtpPassword, SubAccountsUsage, SubAccountsUsageResponse, SuccessResponse, SuppressionsCreateOptions, SuppressionsListEntry, SuppressionsListOptions, SuppressionsListResponse, SuppressionsSource, SuppressionsTypes, UsersCreateOptions, UsersCreateResponse, WebhooksListResponse, WebhooksSigningKeyResponse, WebhooksValidateResponse };
+export type { DataResponse$1 as DataResponse, DomainsBulkCreateLoginLinkResult, DomainsBulkCreateLoginLinks, DomainsBulkCreateLoginLinksResponse, DomainsBulkProvisionOptions, DomainsBulkProvisionResponse, DomainsCreateLoginLink, DomainsCreateLoginLinkResponse, DomainsData, DomainsDownstreamAddress, DomainsListDownstreamAddressesOptions, DomainsListDownstreamAddressesResponse, DomainsListOptions, DomainsListResponse, DomainsProvisionOptions, DomainsProvisionResponse, EmailsCheckDomainDkim, EmailsCheckDomainOptions, EmailsCheckDomainResponse, EmailsCheckDomainVerdict, EmailsCreateDkimKeyOptions, EmailsCreateDkimKeyResponse, EmailsDkimKey, EmailsDkimKeyStatus, EmailsGetDkimKeysOptions, EmailsGetDkimKeysResponse, EmailsRotateDkimKeyOptions, EmailsRotateDkimKeyResponse, EmailsSendAsyncResponse, EmailsSendAttachment, EmailsSendOptions, EmailsSendOptionsBase, EmailsSendRecipient, EmailsSendResponse, EmailsSendTracking, EmailsUpdateDkimKeyOptions, ErrorResponse, ListEntriesResponse, ListEntry, ListEntryOptions, ListEntryResponse, ListNames, MetricsBucket, MetricsEngagement, MetricsEngagementResponse, MetricsOptions, MetricsPerformance, MetricsPerformanceResponse, MetricsRecipientBehaviour, MetricsRecipientBehaviourResponse, MetricsSenders, MetricsSendersOptions, MetricsSendersResponse, MetricsSendersType, MetricsUsageResponse, MetricsVolume, MetricsVolumeResponse, Optional, ServiceReportOptions, ServiceSubscriptionsResponse, SubAccountsAccount, SubAccountsApiKey, SubAccountsCreateApiKeyResponse, SubAccountsCreateResponse, SubAccountsCreateSmtpPasswordResponse, SubAccountsLimit, SubAccountsLimitResponse, SubAccountsListApiKeyOptions, SubAccountsListApiKeyResponse, SubAccountsListOptions, SubAccountsListResponse, SubAccountsListSmtpPasswordResponse, SubAccountsSmtpPassword, SubAccountsUsage, SubAccountsUsageResponse, SuccessResponse, SuppressionsCreateOptions, SuppressionsListEntry, SuppressionsListOptions, SuppressionsListResponse, SuppressionsSource, SuppressionsTypes, UsersCreateOptions, UsersCreateResponse, WebhooksListResponse, WebhooksSigningKeyResponse, WebhooksValidateResponse };

package/dist/mailchannels.mjs

@@ -148,22 +148,7 @@ class Emails {
   constructor(mailchannels) {
     this.mailchannels = mailchannels;
   }
-  /**
-   * Send an email using MailChannels Email API.
-   * @param options - The email options to send.
-   * @param dryRun - When set to `true`, the message will not be sent. Instead, the fully rendered message will be returned in the `data` property of the response. The default value is `false`.
-   * @example
-   * ```ts
-   * const mailchannels = new MailChannels('your-api-key')
-   * const { success, data } = await mailchannels.emails.send({
-   *   to: 'to@example.com',
-   *   from: 'from@example.com',
-   *   subject: 'Test',
-   *   html: 'Test'
-   * })
-   * ```
-   */
-  async send(options, dryRun = false) {
+  async _sendEmail(options, flags) {
     let error = null;
     const { cc, bcc, from, to, html, text, mustaches, dkim } = options;
     const parsedFrom = parseRecipient(from);
@@ -207,8 +192,9 @@ class Emails {
       } : void 0,
       transactional: options.transactional
     };
-    const response = await this.mailchannels.post("/tx/v1/send", {
-      query: { "dry-run": dryRun },
+    const endpoint = flags.async ? "/tx/v1/send-async" : "/tx/v1/send";
+    const response = await this.mailchannels.post(endpoint, {
+      query: { "dry-run": flags.dryRun },
       body: payload,
       onResponseError: async ({ response: response2 }) => {
         error = getStatusError(response2, {
@@ -218,14 +204,23 @@ class Emails {
         });
       }
     }).catch((e) => {
-      error ||= getResultError(e, "Failed to send email.");
+      error ||= getResultError(e, flags.async ? "Failed to queue email." : "Failed to send email.");
       return null;
     });
     if (!response) return { success: false, data: null, error };
+    if (flags.async) {
+      const asyncResponse = response;
+      const data2 = clean({
+        queuedAt: asyncResponse.queued_at,
+        requestId: asyncResponse.request_id
+      });
+      return { data: data2, error: null };
+    }
+    const syncResponse = response;
     const data = clean({
-      rendered: response.data,
-      requestId: response.request_id,
-      results: response.results?.map((result) => ({
+      rendered: syncResponse.data,
+      requestId: syncResponse.request_id,
+      results: syncResponse.results?.map((result) => ({
         index: result.index,
         messageId: result.message_id,
         reason: result.reason,
@@ -234,13 +229,52 @@ class Emails {
     });
     return { success: !!data, data, error: null };
   }
+  /**
+   * Sends an email message to one or more recipients.
+   * @param options - The email options to send.
+   * @param dryRun - When set to `true`, the message will not be sent. Instead, the fully rendered message will be returned in the `data` property of the response. The default value is `false`.
+   * @example
+   * ```ts
+   * const mailchannels = new MailChannels('your-api-key')
+   * const { success, data, error } = await mailchannels.emails.send({
+   *   to: 'to@example.com',
+   *   from: 'from@example.com',
+   *   subject: 'Test',
+   *   html: 'Test'
+   * })
+   * ```
+   */
+  async send(options, dryRun = false) {
+    return this._sendEmail(options, { dryRun });
+  }
+  /**
+   * Queues an email message for asynchronous processing and returns immediately with a request ID.
+   *
+   * The email will be processed in the background, and you'll receive webhook events for all delivery status updates (e.g. `dropped`, `processed`, `delivered`, `hard-bounced`). These webhook events are identical to those sent for the synchronous /send endpoint.
+   *
+   * Use this endpoint when you need to send emails without waiting for processing to complete. This can improve your application's response time, especially when sending to multiple recipients.
+   * @param options - The email options to send.
+   * @example
+   * ```ts
+   * const mailchannels = new MailChannels('your-api-key')
+   * const { data, error } = await mailchannels.emails.sendAsync({
+   *   to: 'to@example.com',
+   *   from: 'from@example.com',
+   *   subject: 'Test',
+   *   html: 'Test'
+   * })
+   * ```
+   */
+  async sendAsync(options) {
+    return this._sendEmail(options, { async: true });
+  }
   /**
    * Validates a domain's email authentication setup by retrieving its DKIM, SPF, and Domain Lockdown status. This endpoint checks whether the domain is properly configured for secure email delivery.
    * @param options - The domain options to check.
    * @example
    * ```ts
    * const mailchannels = new MailChannels('your-api-key')
-   * const { results } = await mailchannels.emails.checkDomain({
+   * const { data, error } = await mailchannels.emails.checkDomain({
    *   dkim: [{
    *     domain: 'example.com',
    *     privateKey: 'your-private-key',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mailchannels-sdk",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Node.js SDK to integrate MailChannels API into your JavaScript or TypeScript server-side applications.",
   "type": "module",
   "license": "MIT",
@@ -37,13 +37,13 @@
     "ofetch": "^2.0.0-alpha.3"
   },
   "devDependencies": {
-    "@eslint/compat": "^2.0.0",
-    "@stylistic/eslint-plugin": "^5.6.1",
+    "@eslint/compat": "^2.0.1",
+    "@stylistic/eslint-plugin": "^5.7.0",
     "@types/markdown-it": "^14.1.2",
-    "@types/node": "^25.0.3",
-    "@typescript-eslint/eslint-plugin": "^8.50.0",
-    "@typescript-eslint/parser": "^8.50.0",
-    "@vitest/coverage-v8": "^4.0.16",
+    "@types/node": "^25.0.9",
+    "@typescript-eslint/eslint-plugin": "^8.53.1",
+    "@typescript-eslint/parser": "^8.53.1",
+    "@vitest/coverage-v8": "^4.0.17",
     "changelogen": "^0.6.2",
     "eslint": "^9.39.2",
     "eslint-plugin-import-x": "^4.16.1",
@@ -51,10 +51,10 @@
     "scule": "^1.3.0",
     "typescript": "^5.9.3",
     "unbuild": "^3.6.1",
-    "vitepress": "^1.6.4",
-    "vitepress-plugin-group-icons": "^1.6.5",
-    "vitepress-plugin-llms": "^1.9.3",
-    "vitest": "^4.0.16"
+    "vitepress": "^v2.0.0-alpha.15",
+    "vitepress-plugin-group-icons": "^1.7.1",
+    "vitepress-plugin-llms": "^1.10.0",
+    "vitest": "^4.0.17"
   },
   "scripts": {
     "build": "unbuild",