mailchannels-sdk 0.8.0-1 → 1.0.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Yizack Rangel
+Copyright (c) 2026 MailChannels
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,12 +1,15 @@
-![MailChannels Node.js SDK](./docs/public/images/presentation.png)
+![MailChannels Node.js SDK](https://bitbucket.org/mailchannels/mailchannels-email-api-sdk-js/raw/HEAD/docs/public/images/presentation.png)
 
 # MailChannels Node.js SDK
 
 [![npm version][npm-version-src]][npm-version-href]
 [![npm downloads][npm-downloads-src]][npm-downloads-href]
-[![codecov][codecov-coverage-src]][codecov-coverage-href]
+[![Build Status][build-status-src]][build-status-href]
+[![License][license-src]][license-href]
+[![TypeScript][typescript-src]][typescript-href]
+[![Node.js][node-src]][node-href]
 
-> Built and tested against Email API `0.21.1`
+> Built and tested against Email API `1.0.0`
 
 Node.js SDK to integrate [MailChannels Email API](https://docs.mailchannels.net/email-api) into your JavaScript or TypeScript server-side applications.
 
@@ -14,7 +17,7 @@ Node.js SDK to integrate [MailChannels Email API](https://docs.mailchannels.net/
 This library provides a simple way to interact with the [MailChannels Email API](https://docs.mailchannels.net/email-api). It is written in TypeScript and can be used in both JavaScript and TypeScript projects and in different runtimes.
 <!-- #endregion overview -->
 
-- [✨ Release Notes](CHANGELOG.md)
+- [✨ Release Notes](https://bitbucket.org/mailchannels/mailchannels-email-api-sdk-js/src/HEAD/CHANGELOG.md)
 - [📖 Documentation](https://mailchannels.yizack.com)
 
 ## Contents
@@ -109,7 +112,7 @@ This package includes a local MailChannels simulator you can run via the CLI. It
 
 | API         | Source                                                                                                         |
 | ----------- | -------------------------------------------------------------------------------------------------------------- |
-| Email API   | [`src/simulator/email-api.mjs`](https://github.com/Yizack/mailchannels/blob/main/src/simulator/email-api.mjs)  |
+| Email API   | [`src/simulator/email-api.mjs`](https://bitbucket.org/mailchannels/mailchannels-email-api-sdk-js/src/main/src/simulator/email-api.mjs)  |
 
 > [!IMPORTANT]
 > The simulator approximates the MailChannels service for local development and testing. It is not a production implementation and may differ from the live service.
@@ -181,12 +184,11 @@ The next planned expansion is outbound webhook delivery so client applications c
 
 ## <a name="license">⚖️ License</a>
 
-[MIT License](LICENSE)
+[MIT License](https://bitbucket.org/mailchannels/mailchannels-email-api-sdk-js/src/HEAD/LICENSE)
 
 ## <a name="development">💻 Development</a>
 
-<details>
-  <summary>Local development</summary>
+Local development
 
 ```sh
 # Install dependencies
@@ -205,21 +207,19 @@ pnpm test:watch
 # Run typecheck
 pnpm test:types
 
-# Refresh API parity fixtures
+# Refresh API parity fixtures, specs, and README version note
 pnpm parity:fixtures
 
 # Run the local simulator
 pnpm simulate
 
 # Run a playground script
-npx jiti playground/emails/send.ts
+pnpx jiti playground/emails/send.ts
 
 # Release new version
 pnpm release
 ```
 
-</details>
-
 <!-- Badges -->
 [npm-version-src]: https://img.shields.io/npm/v/mailchannels-sdk.svg?style=flat&colorA=070a30&colorB=35a047
 [npm-version-href]: https://npmjs.com/package/mailchannels-sdk
@@ -227,5 +227,14 @@ pnpm release
 [npm-downloads-src]: https://img.shields.io/npm/dm/mailchannels-sdk.svg?style=flat&colorA=070a30&colorB=35a047
 [npm-downloads-href]: https://npmjs.com/package/mailchannels-sdk
 
-[codecov-coverage-src]: https://img.shields.io/codecov/c/github/yizack/mailchannels?style=flat&colorA=070a30&token=HTSBRHSJ5M
-[codecov-coverage-href]: https://codecov.io/gh/Yizack/mailchannels
+[build-status-src]: https://img.shields.io/bitbucket/pipelines/mailchannels/mailchannels-email-api-sdk-js/main.svg?style=flat&colorA=070a30
+[build-status-href]: https://bitbucket.org/mailchannels/mailchannels-email-api-sdk-js/pipelines
+
+[license-src]: https://img.shields.io/npm/l/mailchannels-sdk.svg?style=flat&colorA=070a30&colorB=35a047
+[license-href]: https://bitbucket.org/mailchannels/mailchannels-email-api-sdk-js/src/HEAD/LICENSE
+
+[typescript-src]: https://img.shields.io/badge/TypeScript-supported-35a047?style=flat&colorA=070a30
+[typescript-href]: https://www.typescriptlang.org
+
+[node-src]: https://img.shields.io/node/v/mailchannels-sdk.svg?style=flat&colorA=070a30&colorB=35a047
+[node-href]: https://bitbucket.org/mailchannels/mailchannels-email-api-sdk-js/src/HEAD/package.json

package/dist/mailchannels.d.mts

@@ -20,19 +20,31 @@ interface MailChannelsClientOptions {
    * @default false
    */
   retry?: number | false;
+  /**
+   * Request timeout in milliseconds.
+   * Set to `false` or `0` to disable timeout handling.
+   * @default 120000
+   */
+  timeout?: number | false;
+  /**
+   * Abort signal applied to requests made by the client.
+   */
+  signal?: AbortSignal;
 }
 declare class MailChannelsClient {
   #private;
   private static readonly DEFAULT_BASE_URL;
+  private static readonly DEFAULT_TIMEOUT;
   private readonly options;
   constructor(key: string, options?: MailChannelsClientOptions);
-  protected _fetch<T>(path: string, options?: FetchOptions<"json">): Promise<T>;
+  protected _fetch<T>(path: string, options: FetchOptions<"json">): Promise<T>;
   post<T>(path: string, options?: Omit<FetchOptions<"json">, "method">): Promise<T>;
   get<T>(path: string, options?: Omit<FetchOptions<"json">, "method">): Promise<T>;
   delete<T>(path: string, options?: Omit<FetchOptions<"json">, "method">): Promise<T>;
   put<T>(path: string, options?: Omit<FetchOptions<"json">, "method">): Promise<T>;
   patch<T>(path: string, options?: Omit<FetchOptions<"json">, "method">): Promise<T>;
 }
+type ErrorType = "invalid_request_error" | "authentication_error" | "permission_error" | "not_found" | "conflict_error" | "payload_too_large_error" | "unprocessable_entity_error" | "rate_limit_error" | "internal_server_error" | "validation_error" | "application_error" | "api_error";
 interface ErrorResponse {
   /**
    * A human-readable description of the error.
@@ -44,6 +56,12 @@ interface ErrorResponse {
    * This field is intended for diagnostic use only and should not be relied upon.
    */
   statusCode: number | null;
+  /**
+   * A string identifier for the type of error.
+   *
+   * This field is intended for diagnostic use only and should not be relied upon.
+   */
+  type: ErrorType;
 }
 interface SuccessResponse {
   /**
@@ -96,7 +114,15 @@ interface EmailsSendAttachment {
   /**
    * The MIME type of the attachment.
    */
-  type: string;
+  type?: string;
+  /**
+   * The `Content-ID` header value for inline attachments, referenced from HTML with `cid:`.
+   */
+  contentId?: string;
+  /**
+   * The `Content-Disposition` header value for the attachment.
+   */
+  disposition?: "attachment" | "inline";
 }
 interface EmailsSendTracking {
   /**
@@ -211,7 +237,7 @@ interface EmailsSendOptionsBase {
   /**
    * An array of attachments to be sent with the email.
    */
-  attachments?: EmailsSendAttachment[];
+  attachments?: (EmailsSendAttachment | Promise<EmailsSendAttachment>)[];
   /**
    * The campaign identifier. If specified, this ID will be included in all relevant webhooks. It can be up to 48 UTF-8 characters long and must not contain spaces.
    */
@@ -438,7 +464,7 @@ type EmailsSendResponse = DataResponse<{
     status: "sent" | "failed";
   }[];
 }>;
-type EmailsSendAsyncResponse = DataResponse<{
+type EmailsQueueResponse = DataResponse<{
   /**
    * ISO 8601 timestamp when the request was queued for processing.
    */
@@ -448,6 +474,7 @@ type EmailsSendAsyncResponse = DataResponse<{
    */
   requestId: string;
 }>;
+type EmailsSendAsyncResponse = EmailsQueueResponse;
 declare class Emails {
   protected mailchannels: MailChannelsClient;
   constructor(mailchannels: MailChannelsClient);
@@ -478,7 +505,7 @@ declare class Emails {
    * @example
    * ```ts
    * const mailchannels = new MailChannels('your-api-key')
-   * const { data, error } = await mailchannels.emails.sendAsync({
+   * const { data, error } = await mailchannels.emails.queue({
    *   to: 'to@example.com',
    *   from: 'from@example.com',
    *   subject: 'Test',
@@ -486,7 +513,11 @@ declare class Emails {
    * })
    * ```
    */
-  sendAsync(options: EmailsSendOptions): Promise<EmailsSendAsyncResponse>;
+  queue(options: EmailsSendOptions): Promise<EmailsQueueResponse>;
+  /**
+   * @deprecated Use `queue` instead.
+   */
+  sendAsync(options: EmailsSendOptions): Promise<EmailsQueueResponse>;
 }
 interface DomainsDkimCreateOptions {
   /**
@@ -578,10 +609,6 @@ interface DomainsCheckOptions {
    * 6. If `selector` is present and `domain` is not, the domain will be taken from the domain field of the request.
    */
   dkim?: DomainsCheck[] | DomainsCheck;
-  /**
-   * Domain used for sending emails. If `dkim` settings are not provided, or `dkim` settings are provided with no `domain`, the stored dkim settings for this domain will be used.
-   */
-  domain: string;
   /**
    * Used exclusively for [Domain Lockdown](https://support.mailchannels.com/hc/en-us/articles/16918954360845-Secure-your-domain-name-against-spoofing-with-Domain-Lockdown) verification. If you're not using senderid to associate your domain with your account, you can disregard this field. The corresponding value is included in the `X-MailChannels-SenderId` header of emails sent via MailChannels.
    */
@@ -676,7 +703,7 @@ interface DomainsDkimListOptions {
 }
 type Optional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
 type DomainsDkimListResponse = DataResponse<Optional<DomainsDkimKey, "dnsRecords">[]>;
-interface DomainsDkimUpdateOptions {
+interface DomainsDkimUpdateStatusOptions {
   /**
    * Selector of the DKIM key pair to update. Must be a maximum of 63 characters.
    */
@@ -707,22 +734,22 @@ declare class Domains {
   constructor(mailchannels: MailChannelsClient);
   /**
    * 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 domain - Domain used for sending emails. If `dkim` settings are not provided, or `dkim` settings are provided with no `domain`, the stored dkim settings for this domain will be used.
    * @param options - The domain options to check.
    * @example
    * ```ts
    * const mailchannels = new MailChannels('your-api-key')
-   * const { data, error } = await mailchannels.domains.check({
+   * const { data, error } = await mailchannels.domains.check('example.com', {
    *   dkim: [{
    *     domain: 'example.com',
    *     privateKey: 'your-private-key',
    *     selector: 'mailchannels'
    *   }],
-   *   domain: 'example.com',
    *   senderId: 'sender-id'
    * })
    * ```
    */
-  check(options: DomainsCheckOptions): Promise<DomainsCheckResponse>;
+  check(domain: string, options?: DomainsCheckOptions): Promise<DomainsCheckResponse>;
 }
 declare class DomainsDkim {
   private mailchannels;
@@ -760,12 +787,12 @@ declare class DomainsDkim {
    * @example
    * ```ts
    * const mailchannels = new MailChannels('your-api-key')
-   * const { success, error } = await mailchannels.domains.dkim.update('example.com', {
+   * const { success, error } = await mailchannels.domains.dkim.updateStatus('example.com', {
    *   selector: 'mailchannels',
    *   status: 'retired'
    * })
    */
-  update(domain: string, options: DomainsDkimUpdateOptions): Promise<SuccessResponse>;
+  updateStatus(domain: string, options: DomainsDkimUpdateStatusOptions): Promise<SuccessResponse>;
   /**
    * Rotate an active DKIM key pair. Mark the original key as `rotated`, and create a new key pair with the required new key selector, reusing the same algorithm and key length. The rotated key remains valid for signing for a 3-day grace period, and is automatically changed to `retired` 2 weeks after rotation. Publish the new key to its DNS TXT record before rotated key expires for signing as emails sent with an unpublished key will fail DKIM validation by receiving providers. After the grace period, only the new key is valid for signing if published.
    * @param domain - The domain the DKIM key belongs to.
@@ -842,7 +869,7 @@ interface WebhookEventBase<T extends WebhookEventType> {
    * The MailChannels account ID that generated the webhook.
    * If the message was sent by a sub-account, this field contains the sub-account handle.
    */
-  customer_handle: string;
+  customerHandle: string;
   /**
    * The Unix timestamp (in seconds) when the event occurred; the timezone is always UTC
    */
@@ -850,7 +877,7 @@ interface WebhookEventBase<T extends WebhookEventType> {
   /**
    * The Message-Id of the message that generated the event
    */
-  smtp_id?: string;
+  smtpId?: string;
   /**
    * The type of event that occurred
    */
@@ -858,11 +885,11 @@ interface WebhookEventBase<T extends WebhookEventType> {
   /**
    * A unique identifier generated to track the original HTTP request
    */
-  request_id?: string;
+  requestId?: string;
   /**
    * The campaign identifier for the message that generated the event
    */
-  campaign_id?: string;
+  campaignId?: string;
   /**
    * The recipients of the message
    */
@@ -874,7 +901,7 @@ interface WebhookEventWithTracking {
   /**
    * The User-Agent header given when the recipient opened the message
    */
-  user_agent?: string;
+  userAgent?: string;
   /**
    * The IP address of the host that made the HTTP request
    */
@@ -902,9 +929,8 @@ interface WebhookEventSoftBounced extends WebhookEventBase<"soft-bounced">, Webh
 interface WebhookEventDropped extends WebhookEventBase<"dropped">, WebhookEventWithStatus {}
 interface WebhookEventComplained extends WebhookEventBase<"complained"> {}
 interface WebhookEventUnsubscribed extends WebhookEventBase<"unsubscribed"> {}
-interface WebhookEventTest extends Omit<WebhookEventBase<"test">, "recipients" | "campaign_id"> {}
+interface WebhookEventTest extends Omit<WebhookEventBase<"test">, "recipients" | "campaignId"> {}
 type WebhookEvent = WebhookEventProcessed | WebhookEventDelivered | WebhookEventOpen | WebhookEventClick | WebhookEventHardBounced | WebhookEventSoftBounced | WebhookEventDropped | WebhookEventComplained | WebhookEventUnsubscribed | WebhookEventTest;
-type WebhookEvents = WebhookEvent[];
 interface WebhooksVerifyOptions {
   /**
    * The raw body of the incoming webhook request as a string. This should be the exact payload received from the webhook, without any modifications or parsing, to ensure accurate signature verification.
@@ -928,12 +954,7 @@ interface WebhooksVerifyOptions {
    */
   cache?: boolean;
 }
-type WebhooksVerifyResponse = DataResponse<{
-  /**
-   * The type of event that occurred.
-   */
-  event: WebhookEventType;
-}[]>;
+type WebhooksVerifyResponse = DataResponse<WebhookEvent[]>;
 type WebhooksBatchStatus = "1xx" | "2xx" | "3xx" | "4xx" | "5xx" | "no_response";
 type WebhooksBatchResponseStatus = "1xx_response" | "2xx_response" | "3xx_response" | "4xx_response" | "5xx_response" | "no_response";
 interface WebhooksBatchesOptions {
@@ -1042,10 +1063,10 @@ declare class Webhooks {
    * @example
    * ```ts
    * const mailchannels = new MailChannels('your-api-key')
-   * const { success, error } = mailchannels.webhooks.enroll('https://example.com/api/webhooks/mailchannels')
+   * const { success, error } = await mailchannels.webhooks.create('https://example.com/api/webhooks/mailchannels')
    * ```
    */
-  enroll(endpoint: string): Promise<SuccessResponse>;
+  create(endpoint: string): Promise<SuccessResponse>;
   /**
    * Retrieves all registered webhook endpoints associated with the customer.
    * @example
@@ -1743,6 +1764,11 @@ declare class Suppressions {
    */
   list(options?: SuppressionsListOptions): Promise<SuppressionsListResponse>;
 }
+type AttachmentOptions = Omit<EmailsSendAttachment, "content">;
+declare class Attachment {
+  static fromBytes(data: ArrayBuffer | Uint8Array, options: AttachmentOptions): EmailsSendAttachment;
+  static fromBlob(blob: Blob, options: AttachmentOptions): Promise<EmailsSendAttachment>;
+}
 declare class MailChannels extends MailChannelsClient {
   readonly emails: Emails;
   readonly domains: Domains;
@@ -1752,4 +1778,4 @@ declare class MailChannels extends MailChannelsClient {
   readonly suppressions: Suppressions;
   constructor(key: string, options?: MailChannelsClientOptions);
 }
-export { DataResponse, Domains, DomainsCheckOptions, DomainsCheckResponse, DomainsCheckVerdict, DomainsDkimCreateOptions, DomainsDkimCreateResponse, DomainsDkimKey, DomainsDkimKeyStatus, DomainsDkimListOptions, DomainsDkimListResponse, DomainsDkimRotateOptions, DomainsDkimRotateResponse, DomainsDkimUpdateOptions, Emails, EmailsSendAsyncResponse, EmailsSendAttachment, EmailsSendContent, EmailsSendDkim, EmailsSendOptions, EmailsSendPersonalization, EmailsSendRecipient, EmailsSendRecipientInput, EmailsSendResponse, EmailsSendTemplate, EmailsSendTemplateType, EmailsSendTemplateValue, EmailsSendTracking, ErrorResponse, MailChannels, MailChannelsClient, MailChannelsClientOptions, Metrics, MetricsBucket, MetricsEngagement, MetricsEngagementResponse, MetricsOptions, MetricsPerformance, MetricsPerformanceResponse, MetricsRecipientBehaviour, MetricsRecipientBehaviourResponse, MetricsSenders, MetricsSendersOptions, MetricsSendersResponse, MetricsSendersType, MetricsUsageResponse, MetricsVolume, MetricsVolumeResponse, SubAccounts, SubAccountsAccount, SubAccountsApiKey, SubAccountsCreateApiKeyResponse, SubAccountsCreateResponse, SubAccountsCreateSmtpPasswordResponse, SubAccountsLimit, SubAccountsLimitResponse, SubAccountsListApiKeyOptions, SubAccountsListApiKeyResponse, SubAccountsListOptions, SubAccountsListResponse, SubAccountsListSmtpPasswordResponse, SubAccountsSmtpPassword, SubAccountsUsage, SubAccountsUsageResponse, SuccessResponse, Suppressions, SuppressionsCreateOptions, SuppressionsListEntry, SuppressionsListOptions, SuppressionsListResponse, SuppressionsSource, SuppressionsTypes, WebhookEvent, WebhookEventClick, WebhookEventComplained, WebhookEventDelivered, WebhookEventDropped, WebhookEventHardBounced, WebhookEventOpen, WebhookEventProcessed, WebhookEventSoftBounced, WebhookEventTest, WebhookEventType, WebhookEventUnsubscribed, WebhookEvents, Webhooks, WebhooksBatch, WebhooksBatchResponseStatus, WebhooksBatchStatus, WebhooksBatchesOptions, WebhooksBatchesResponse, WebhooksListResponse, WebhooksResendBatch, WebhooksResendBatchResponse, WebhooksSigningKeyResponse, WebhooksValidateResponse, WebhooksVerifyOptions, WebhooksVerifyResponse };
+export { Attachment, type DataResponse, Domains, type DomainsCheckOptions, type DomainsCheckResponse, type DomainsCheckVerdict, type DomainsDkimCreateOptions, type DomainsDkimCreateResponse, type DomainsDkimKey, type DomainsDkimKeyStatus, type DomainsDkimListOptions, type DomainsDkimListResponse, type DomainsDkimRotateOptions, type DomainsDkimRotateResponse, type DomainsDkimUpdateStatusOptions, Emails, type EmailsQueueResponse, type EmailsSendAsyncResponse, type EmailsSendAttachment, type EmailsSendContent, type EmailsSendDkim, type EmailsSendOptions, type EmailsSendPersonalization, type EmailsSendRecipient, type EmailsSendRecipientInput, type EmailsSendResponse, type EmailsSendTemplate, type EmailsSendTemplateType, type EmailsSendTemplateValue, type EmailsSendTracking, type ErrorResponse, type ErrorType, MailChannels, MailChannelsClient, type MailChannelsClientOptions, Metrics, type MetricsBucket, type MetricsEngagement, type MetricsEngagementResponse, type MetricsOptions, type MetricsPerformance, type MetricsPerformanceResponse, type MetricsRecipientBehaviour, type MetricsRecipientBehaviourResponse, type MetricsSenders, type MetricsSendersOptions, type MetricsSendersResponse, type MetricsSendersType, type MetricsUsageResponse, type MetricsVolume, type MetricsVolumeResponse, SubAccounts, type SubAccountsAccount, type SubAccountsApiKey, type SubAccountsCreateApiKeyResponse, type SubAccountsCreateResponse, type SubAccountsCreateSmtpPasswordResponse, type SubAccountsLimit, type SubAccountsLimitResponse, type SubAccountsListApiKeyOptions, type SubAccountsListApiKeyResponse, type SubAccountsListOptions, type SubAccountsListResponse, type SubAccountsListSmtpPasswordResponse, type SubAccountsSmtpPassword, type SubAccountsUsage, type SubAccountsUsageResponse, type SuccessResponse, Suppressions, type SuppressionsCreateOptions, type SuppressionsListEntry, type SuppressionsListOptions, type SuppressionsListResponse, type SuppressionsSource, type SuppressionsTypes, type WebhookEvent, type WebhookEventClick, type WebhookEventComplained, type WebhookEventDelivered, type WebhookEventDropped, type WebhookEventHardBounced, type WebhookEventOpen, type WebhookEventProcessed, type WebhookEventSoftBounced, type WebhookEventTest, type WebhookEventType, type WebhookEventUnsubscribed, Webhooks, type WebhooksBatch, type WebhooksBatchResponseStatus, type WebhooksBatchStatus, type WebhooksBatchesOptions, type WebhooksBatchesResponse, type WebhooksListResponse, type WebhooksResendBatch, type WebhooksResendBatchResponse, type WebhooksSigningKeyResponse, type WebhooksValidateResponse, type WebhooksVerifyOptions, type WebhooksVerifyResponse };

package/dist/mailchannels.mjs

@@ -1,16 +1,20 @@
 import { $fetch } from "ofetch";
 import { subtle } from "node:crypto";
 import { Buffer } from "node:buffer";
-var version = "0.8.0-1";
+import mime from "mime";
+var version = "1.0.0";
 var MailChannelsClient = class MailChannelsClient {
 	static DEFAULT_BASE_URL = "https://api.mailchannels.net";
+	static DEFAULT_TIMEOUT = 12e4;
 	options;
 	#headers;
 	constructor(key, options = {}) {
 		if (!key) throw new Error("Missing MailChannels API key.");
 		this.options = {
 			baseUrl: options.baseUrl || MailChannelsClient.DEFAULT_BASE_URL,
-			retry: options.retry ?? false
+			retry: options.retry ?? false,
+			signal: options.signal,
+			timeout: options.timeout ?? MailChannelsClient.DEFAULT_TIMEOUT
 		};
 		this.#headers = {
 			"X-API-Key": key,
@@ -20,13 +24,16 @@ var MailChannelsClient = class MailChannelsClient {
 		};
 	}
 	async _fetch(path, options) {
+		const { headers, signal = this.options.signal, ...fetchOptions } = options;
 		return $fetch(path, {
 			baseURL: this.options.baseUrl,
 			retry: this.options.retry,
-			...options,
+			signal,
+			timeout: this.options.timeout === false ? void 0 : this.options.timeout,
+			...fetchOptions,
 			headers: {
 				...this.#headers,
-				...options?.headers
+				...headers
 			}
 		});
 	}
@@ -61,10 +68,22 @@ var MailChannelsClient = class MailChannelsClient {
 		});
 	}
 };
-const createError = (message, statusCode = null) => {
+const STATUS_ERROR_TYPE_MAP = {
+	[400]: "invalid_request_error",
+	[401]: "authentication_error",
+	[403]: "permission_error",
+	[404]: "not_found",
+	[409]: "conflict_error",
+	[413]: "payload_too_large_error",
+	[422]: "unprocessable_entity_error",
+	[429]: "rate_limit_error",
+	[500]: "internal_server_error"
+};
+const createError = (message, statusCode = null, type) => {
 	return {
 		message,
-		statusCode
+		statusCode,
+		type
 	};
 };
 const getStatusError = (response, errors = {}) => {
@@ -74,18 +93,20 @@ const getStatusError = (response, errors = {}) => {
 	if (typeof payload === "string") details = payload;
 	else if (payload?.message) details = payload.message;
 	else if (Array.isArray(payload?.errors) && payload.errors?.length) details = payload.errors.join(", ");
-	return createError(details ? `${statusText} ${details}` : statusText, response.status ?? null);
+	return createError(details ? `${statusText} ${details}` : statusText, response.status ?? null, STATUS_ERROR_TYPE_MAP[response.status] || "api_error");
 };
 const getResultError = (e, fallback) => {
-	return createError(e instanceof Error ? e.message : fallback);
+	return createError(e instanceof Error ? e.message : fallback, null, "application_error");
+};
+const createValidationError = (message) => {
+	return createError(message, null, "validation_error");
 };
 const validatePagination = (pagination = {}) => {
 	const { limit, offset, max } = pagination;
-	if (typeof limit === "number" && (limit < 1 || max && limit > max)) return createError("The limit value " + (max ? `must be between 1 and ${max}.` : "is invalid. Only positive values are allowed."));
-	if (typeof offset === "number" && offset < 0) return createError("Offset must be greater than or equal to 0.");
+	if (typeof limit === "number" && (limit < 1 || max && limit > max)) return createValidationError("The limit value " + (max ? `must be between 1 and ${max}.` : "is invalid. Only positive values are allowed."));
+	if (typeof offset === "number" && offset < 0) return createValidationError("Offset must be greater than or equal to 0.");
 	return null;
 };
-const stripPemHeaders = (pem) => pem.replace(/-----[^-]+-----|\s|#.*$/gm, "");
 const clean = (data) => {
 	if (Array.isArray(data)) {
 		const result = [];
@@ -108,25 +129,6 @@ const clean = (data) => {
 	}
 	return data;
 };
-const mapBuckets = (arr) => {
-	return arr.map(({ count, period_start }) => ({
-		count,
-		periodStart: period_start
-	}));
-};
-const mapDkimKey = (key) => ({
-	algorithm: key.algorithm,
-	createdAt: key.created_at,
-	dnsRecords: key.dkim_dns_records,
-	domain: key.domain,
-	gracePeriodExpiresAt: key.gracePeriodExpiresAt,
-	length: key.key_length,
-	publicKey: key.public_key,
-	retiresAt: key.retiresAt,
-	selector: key.selector,
-	status: key.status,
-	statusModifiedAt: key.status_modified_at
-});
 const isValidEmail = (email) => {
 	return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
 };
@@ -157,6 +159,7 @@ const parseArrayRecipients = (recipients) => {
 	const filtered = (typeof recipients === "string" ? [parseRecipientString(recipients)] : Array.isArray(recipients) ? recipients.map(parseRecipient) : [recipients]).filter((recipient) => Boolean(recipient));
 	return filtered.length > 0 ? filtered : void 0;
 };
+const stripPemHeaders = (pem) => pem.replace(/-----[^-]+-----|\s|#.*$/gm, "");
 const RESERVED_HEADER_NAMES = new Set([
 	"authentication-results",
 	"bcc",
@@ -207,6 +210,13 @@ const mapDkim = (dkim) => ({
 	dkim_private_key: dkim?.privateKey ? stripPemHeaders(dkim.privateKey) : void 0,
 	dkim_selector: dkim?.selector
 });
+const mapAttachment = (attachment) => ({
+	content: attachment.content,
+	filename: attachment.filename,
+	type: attachment.type,
+	content_id: attachment.contentId,
+	disposition: attachment.disposition
+});
 const mapPersonalization = (personalization, index, rootTemplateData) => {
 	const to = parseArrayRecipients(personalization.to);
 	if (!to || !to.length) return `Personalization at index ${index} must include at least one recipient in the 'to' field.`;
@@ -238,11 +248,16 @@ const mapPersonalization = (personalization, index, rootTemplateData) => {
 		to
 	};
 };
-const buildSendPayload = (options) => {
+const resolveAttachments = async (attachments) => {
+	if (!attachments) return;
+	return Promise.all(attachments.map((a) => Promise.resolve(a))).catch((e) => e.message);
+};
+const buildSendPayload = async (options) => {
 	const { from, html, text } = options;
 	const contentTypes = options.content ? new Set(options.content.map((item) => item.type.toLowerCase())) : void 0;
 	const parsedFrom = parseRecipient(from);
-	if (!parsedFrom || !parsedFrom.email) return "No sender provided. Use the `from` option to specify a sender";
+	if (!parsedFrom || !parsedFrom.email) return "No sender provided. Use the 'from' option to specify a sender.";
+	if (!options.subject || typeof options.subject !== "string" || !options.subject.trim()) return "No subject provided. Use the 'subject' option to specify a subject.";
 	if (!text && !html && (!options.content || !options.content.length)) return "No email content provided";
 	if (html && contentTypes?.has("text/html")) return "Cannot provide both 'html' and a 'content' entry with type 'text/html'.";
 	if (text && contentTypes?.has("text/plain")) return "Cannot provide both 'text' and a 'content' entry with type 'text/plain'.";
@@ -307,8 +322,10 @@ const buildSendPayload = (options) => {
 		value: item.value,
 		template_type
 	});
+	const resolvedAttachments = await resolveAttachments(options.attachments);
+	if (typeof resolvedAttachments === "string") return resolvedAttachments;
 	return {
-		attachments: options.attachments,
+		attachments: resolvedAttachments?.map((a) => mapAttachment(a)),
 		campaign_id: options.campaignId,
 		...mapDkim(options.dkim),
 		envelope_from: parseRecipient(options.envelopeFrom),
@@ -332,9 +349,9 @@ var Emails = class {
 	}
 	async _sendEmail(options, flags) {
 		let error = null;
-		const payload = buildSendPayload(options);
+		const payload = await buildSendPayload(options);
 		if (typeof payload === "string") {
-			error = createError(payload);
+			error = createValidationError(payload);
 			return {
 				data: null,
 				error
@@ -387,10 +404,26 @@ var Emails = class {
 	async send(options, dryRun = false) {
 		return this._sendEmail(options, { dryRun });
 	}
-	async sendAsync(options) {
+	async queue(options) {
 		return this._sendEmail(options, { async: true });
 	}
+	async sendAsync(options) {
+		return this.queue(options);
+	}
 };
+const mapDkimKey = (key) => ({
+	algorithm: key.algorithm,
+	createdAt: key.created_at,
+	dnsRecords: key.dkim_dns_records,
+	domain: key.domain,
+	gracePeriodExpiresAt: key.gracePeriodExpiresAt,
+	length: key.key_length,
+	publicKey: key.public_key,
+	retiresAt: key.retiresAt,
+	selector: key.selector,
+	status: key.status,
+	statusModifiedAt: key.status_modified_at
+});
 var Domains = class {
 	mailchannels;
 	dkim;
@@ -398,32 +431,38 @@ var Domains = class {
 		this.mailchannels = mailchannels;
 		this.dkim = new DomainsDkim(mailchannels);
 	}
-	async check(options) {
+	async check(domain, options) {
 		let error = null;
-		const { dkim, domain, senderId } = options;
-		const dkimOptions = dkim ? Array.isArray(dkim) ? dkim : [dkim] : void 0;
+		if (!domain) {
+			error = createValidationError("No domain provided.");
+			return {
+				data: null,
+				error
+			};
+		}
+		const dkimOptions = options?.dkim ? Array.isArray(options.dkim) ? options.dkim : [options.dkim] : void 0;
 		if (dkimOptions && dkimOptions.length > 10) {
-			error = createError("A maximum of 10 DKIM settings can be provided.");
+			error = createValidationError("A maximum of 10 DKIM settings can be provided.");
 			return {
 				data: null,
 				error
 			};
 		}
 		if (dkimOptions?.find(({ privateKey, selector }) => privateKey && !selector)) {
-			error = createError("DKIM settings with a privateKey must also include a selector.");
+			error = createValidationError("DKIM settings with a privateKey must also include a selector.");
 			return {
 				data: null,
 				error
 			};
 		}
 		const payload = {
-			dkim_settings: dkimOptions?.map(({ domain, privateKey, selector }) => ({
-				dkim_domain: domain,
-				dkim_private_key: privateKey ? stripPemHeaders(privateKey) : void 0,
-				dkim_selector: selector
+			dkim_settings: dkimOptions?.map((dkim) => ({
+				dkim_domain: dkim.domain,
+				dkim_private_key: dkim.privateKey ? stripPemHeaders(dkim.privateKey) : void 0,
+				dkim_selector: dkim.selector
 			})),
 			domain,
-			sender_id: senderId
+			sender_id: options?.senderId
 		};
 		const response = await this.mailchannels.post("/tx/v1/check-domain", {
 			body: payload,
@@ -466,8 +505,15 @@ var DomainsDkim = class {
 	}
 	async create(domain, options) {
 		let error = null;
+		if (!domain) {
+			error = createValidationError("No domain provided.");
+			return {
+				data: null,
+				error
+			};
+		}
 		if (!options.selector || options.selector.length > 63) {
-			error = createError("Selector must be between 1 and 63 characters.");
+			error = createValidationError("Selector must be between 1 and 63 characters.");
 			return {
 				data: null,
 				error
@@ -501,8 +547,15 @@ var DomainsDkim = class {
 	}
 	async list(domain, options) {
 		let error = null;
+		if (!domain) {
+			error = createValidationError("No domain provided.");
+			return {
+				data: null,
+				error
+			};
+		}
 		if (options?.selector && options.selector.length > 63) {
-			error = createError("Selector must be between 1 and 63 characters.");
+			error = createValidationError("Selector must be between 1 and 63 characters.");
 			return {
 				data: null,
 				error
@@ -541,10 +594,17 @@ var DomainsDkim = class {
 			error: null
 		};
 	}
-	async update(domain, options) {
+	async updateStatus(domain, options) {
 		let error = null;
+		if (!domain) {
+			error = createValidationError("No domain provided.");
+			return {
+				success: false,
+				error
+			};
+		}
 		if (!options.selector || options.selector.length > 63) {
-			error = createError("Selector must be between 1 and 63 characters.");
+			error = createValidationError("Selector must be between 1 and 63 characters.");
 			return {
 				success: false,
 				error
@@ -560,7 +620,7 @@ var DomainsDkim = class {
 				});
 			}
 		}).catch((e) => {
-			error ||= getResultError(e, "Failed to update DKIM key.");
+			error ||= getResultError(e, "Failed to update status of DKIM key.");
 		});
 		return {
 			success: !error,
@@ -569,15 +629,22 @@ var DomainsDkim = class {
 	}
 	async rotate(domain, selector, options) {
 		let error = null;
+		if (!domain) {
+			error = createValidationError("No domain provided.");
+			return {
+				data: null,
+				error
+			};
+		}
 		if (!selector || selector.length > 63) {
-			error = createError("Selector must be between 1 and 63 characters.");
+			error = createValidationError("Selector must be between 1 and 63 characters.");
 			return {
 				data: null,
 				error
 			};
 		}
 		if (!options.newKey.selector || options.newKey.selector.length > 63) {
-			error = createError("New key selector must be between 1 and 63 characters.");
+			error = createValidationError("New key selector must be between 1 and 63 characters.");
 			return {
 				data: null,
 				error
@@ -687,17 +754,17 @@ var Webhooks = class Webhooks {
 	constructor(mailchannels) {
 		this.mailchannels = mailchannels;
 	}
-	async enroll(endpoint) {
+	async create(endpoint) {
 		let error = null;
 		if (!endpoint) {
-			error = createError("No endpoint provided.");
+			error = createValidationError("No endpoint provided.");
 			return {
 				success: false,
 				error
 			};
 		}
 		if (endpoint.length > 8e3) {
-			error = createError("The endpoint exceeds the maximum length of 8000 characters.");
+			error = createValidationError("The endpoint exceeds the maximum length of 8000 characters.");
 			return {
 				success: false,
 				error
@@ -709,7 +776,7 @@ var Webhooks = class Webhooks {
 				error = getStatusError(response, { [409]: `Endpoint '${endpoint}' is already enrolled to receive notifications.` });
 			}
 		}).catch((e) => {
-			error ||= getResultError(e, "Failed to enroll webhook.");
+			error ||= getResultError(e, "Failed to create webhook.");
 		});
 		return {
 			success: !error,
@@ -774,7 +841,7 @@ var Webhooks = class Webhooks {
 	async validate(requestId) {
 		let error = null;
 		if (requestId && requestId.length > 28) {
-			error = createError("The request id should not exceed 28 characters.");
+			error = createValidationError("The request id should not exceed 28 characters.");
 			return {
 				data: null,
 				error
@@ -807,7 +874,7 @@ var Webhooks = class Webhooks {
 	static async verify(options) {
 		let error = null;
 		if (!await isValidWebhook(options).catch(() => false)) {
-			error = createError("Invalid webhook signature.");
+			error = createValidationError("Invalid webhook signature.");
 			return {
 				data: null,
 				error
@@ -816,18 +883,32 @@ var Webhooks = class Webhooks {
 		try {
 			const payload = JSON.parse(options.payload);
 			if (!Array.isArray(payload)) {
-				error = createError("Invalid webhook payload.");
+				error = createValidationError("Invalid webhook payload.");
 				return {
 					data: null,
 					error
 				};
 			}
 			return {
-				data: clean(payload.map((event) => ({ event: event.event }))),
+				data: clean(payload.map((event) => ({
+					email: event.email,
+					customerHandle: event.customer_handle,
+					timestamp: event.timestamp,
+					smtpId: event.smtp_id,
+					event: event.event,
+					requestId: event.request_id,
+					campaignId: "campaign_id" in event ? event.campaign_id : void 0,
+					recipients: "recipients" in event ? event.recipients : void 0,
+					userAgent: "user_agent" in event ? event.user_agent : void 0,
+					ip: "ip" in event ? event.ip : void 0,
+					url: "url" in event ? event.url : void 0,
+					status: "status" in event ? event.status : void 0,
+					reason: "reason" in event ? event.reason : void 0
+				}))),
 				error: null
 			};
 		} catch {
-			error = createError("Invalid webhook payload.");
+			error = createValidationError("Invalid webhook payload.");
 			return {
 				data: null,
 				error
@@ -849,19 +930,19 @@ var Webhooks = class Webhooks {
 		};
 		if (options?.statuses && options.statuses.length > 6) return {
 			data: null,
-			error: createError("A maximum of 6 status filters can be provided.")
+			error: createValidationError("A maximum of 6 status filters can be provided.")
 		};
 		if (options?.statuses && new Set(options.statuses).size !== options.statuses.length) return {
 			data: null,
-			error: createError("Status filters must be unique.")
+			error: createValidationError("Status filters must be unique.")
 		};
 		if (options?.createdAfter && Number.isNaN(Date.parse(options.createdAfter))) return {
 			data: null,
-			error: createError("createdAfter must be a valid date string.")
+			error: createValidationError("createdAfter must be a valid date string.")
 		};
 		if (options?.createdBefore && Number.isNaN(Date.parse(options.createdBefore))) return {
 			data: null,
-			error: createError("createdBefore must be a valid date string.")
+			error: createValidationError("createdBefore must be a valid date string.")
 		};
 		if (options?.createdAfter && options?.createdBefore) {
 			const createdAfter = Date.parse(options.createdAfter);
@@ -869,11 +950,11 @@ var Webhooks = class Webhooks {
 			const maxRangeMs = 744 * 60 * 60 * 1e3;
 			if (createdBefore <= createdAfter) return {
 				data: null,
-				error: createError("createdBefore must be later than createdAfter.")
+				error: createValidationError("createdBefore must be later than createdAfter.")
 			};
 			if (createdBefore - createdAfter > maxRangeMs) return {
 				data: null,
-				error: createError("The time range between createdAfter and createdBefore must not exceed 31 days.")
+				error: createValidationError("The time range between createdAfter and createdBefore must not exceed 31 days.")
 			};
 		}
 		const response = await this.mailchannels.get("/tx/v1/webhook-batch", {
@@ -949,7 +1030,7 @@ var SubAccounts = class SubAccounts {
 	async create(companyName, handle) {
 		let error = null;
 		if (!SubAccounts.COMPANY_PATTERN.test(companyName)) {
-			error = createError("Invalid company name. Company name must be between 3 and 128 characters.");
+			error = createValidationError("Invalid company name. Company name must be between 3 and 128 characters.");
 			return {
 				data: null,
 				error
@@ -957,7 +1038,7 @@ var SubAccounts = class SubAccounts {
 		}
 		if (handle) {
 			if (!SubAccounts.HANDLE_PATTERN.test(handle)) {
-				error = createError("Invalid handle. Sub-account handle must be between 3 and 128 characters and contain only lowercase letters and numbers.");
+				error = createValidationError("Invalid handle. Sub-account handle must be between 3 and 128 characters and contain only lowercase letters and numbers.");
 				return {
 					data: null,
 					error
@@ -1027,7 +1108,7 @@ var SubAccounts = class SubAccounts {
 	async delete(handle) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				success: false,
 				error
@@ -1046,7 +1127,7 @@ var SubAccounts = class SubAccounts {
 	async suspend(handle) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				success: false,
 				error
@@ -1065,7 +1146,7 @@ var SubAccounts = class SubAccounts {
 	async activate(handle) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				success: false,
 				error
@@ -1087,7 +1168,7 @@ var SubAccounts = class SubAccounts {
 	async createApiKey(handle) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				data: null,
 				error
@@ -1115,7 +1196,7 @@ var SubAccounts = class SubAccounts {
 	async listApiKeys(handle, options) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				data: null,
 				error
@@ -1150,7 +1231,7 @@ var SubAccounts = class SubAccounts {
 	async deleteApiKey(handle, id) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				success: false,
 				error
@@ -1169,7 +1250,7 @@ var SubAccounts = class SubAccounts {
 	async createSmtpPassword(handle) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				data: null,
 				error
@@ -1201,7 +1282,7 @@ var SubAccounts = class SubAccounts {
 	async listSmtpPasswords(handle) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				data: null,
 				error
@@ -1229,7 +1310,7 @@ var SubAccounts = class SubAccounts {
 	async deleteSmtpPassword(handle, id) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				success: false,
 				error
@@ -1248,7 +1329,7 @@ var SubAccounts = class SubAccounts {
 	async getLimit(handle) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				data: null,
 				error
@@ -1272,14 +1353,14 @@ var SubAccounts = class SubAccounts {
 	async setLimit(handle, limit) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				success: false,
 				error
 			};
 		}
 		if (limit.sends < 0) {
-			error = createError("The sends value must be at least 0.");
+			error = createValidationError("The sends value must be at least 0.");
 			return {
 				success: false,
 				error
@@ -1304,7 +1385,7 @@ var SubAccounts = class SubAccounts {
 	async deleteLimit(handle) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				success: false,
 				error
@@ -1323,7 +1404,7 @@ var SubAccounts = class SubAccounts {
 	async getUsage(handle) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				data: null,
 				error
@@ -1349,6 +1430,12 @@ var SubAccounts = class SubAccounts {
 		};
 	}
 };
+const mapBucket = (bucket) => {
+	return {
+		count: bucket.count,
+		periodStart: bucket.period_start
+	};
+};
 var Metrics = class {
 	mailchannels;
 	constructor(mailchannels) {
@@ -1377,10 +1464,10 @@ var Metrics = class {
 		return {
 			data: clean({
 				buckets: {
-					click: mapBuckets(response.buckets.click),
-					clickTrackingDelivered: mapBuckets(response.buckets.click_tracking_delivered),
-					open: mapBuckets(response.buckets.open),
-					openTrackingDelivered: mapBuckets(response.buckets.open_tracking_delivered)
+					click: response.buckets.click.map(mapBucket),
+					clickTrackingDelivered: response.buckets.click_tracking_delivered.map(mapBucket),
+					open: response.buckets.open.map(mapBucket),
+					openTrackingDelivered: response.buckets.open_tracking_delivered.map(mapBucket)
 				},
 				click: response.click,
 				clickTrackingDelivered: response.click_tracking_delivered,
@@ -1416,9 +1503,9 @@ var Metrics = class {
 			data: clean({
 				bounced: response.bounced,
 				buckets: {
-					bounced: mapBuckets(response.buckets.bounced),
-					delivered: mapBuckets(response.buckets.delivered),
-					processed: mapBuckets(response.buckets.processed)
+					bounced: response.buckets.bounced.map(mapBucket),
+					delivered: response.buckets.delivered.map(mapBucket),
+					processed: response.buckets.processed.map(mapBucket)
 				},
 				delivered: response.delivered,
 				endTime: response.end_time,
@@ -1451,8 +1538,8 @@ var Metrics = class {
 		return {
 			data: clean({
 				buckets: {
-					unsubscribeDelivered: mapBuckets(response.buckets.unsubscribe_delivered),
-					unsubscribed: mapBuckets(response.buckets.unsubscribed)
+					unsubscribeDelivered: response.buckets.unsubscribe_delivered.map(mapBucket),
+					unsubscribed: response.buckets.unsubscribed.map(mapBucket)
 				},
 				endTime: response.end_time,
 				startTime: response.start_time,
@@ -1485,9 +1572,9 @@ var Metrics = class {
 		return {
 			data: clean({
 				buckets: {
-					delivered: mapBuckets(response.buckets.delivered),
-					dropped: mapBuckets(response.buckets.dropped),
-					processed: mapBuckets(response.buckets.processed)
+					delivered: response.buckets.delivered.map(mapBucket),
+					dropped: response.buckets.dropped.map(mapBucket),
+					processed: response.buckets.processed.map(mapBucket)
 				},
 				delivered: response.delivered,
 				dropped: response.dropped,
@@ -1570,7 +1657,7 @@ var Suppressions = class {
 		let error = null;
 		const { addToSubAccounts, entries } = options;
 		if (entries.length > 1e3) {
-			error = createError("The number of suppression entries must not exceed 1000.");
+			error = createValidationError("The number of suppression entries must not exceed 1000.");
 			return {
 				success: false,
 				error
@@ -1619,7 +1706,7 @@ var Suppressions = class {
 	async list(options) {
 		let error = null;
 		if (options?.recipient && options.recipient.length > 255) {
-			error = createError("The recipient must not exceed 255 characters.");
+			error = createValidationError("The recipient must not exceed 255 characters.");
 			return {
 				data: null,
 				error
@@ -1667,6 +1754,33 @@ var Suppressions = class {
 		};
 	}
 };
+const base64Content = (data) => {
+	if (data instanceof ArrayBuffer) return Buffer.from(data).toString("base64");
+	return Buffer.from(data.buffer, data.byteOffset, data.byteLength).toString("base64");
+};
+const guessContentType = (filename) => {
+	return mime.getType(filename) || void 0;
+};
+var Attachment = class Attachment {
+	static fromBytes(data, options) {
+		const { filename, type, contentId, disposition = "attachment" } = options;
+		return {
+			content: base64Content(data),
+			filename: decodeURIComponent(filename) || "attachment",
+			type: type || guessContentType(filename),
+			contentId,
+			disposition
+		};
+	}
+	static async fromBlob(blob, options) {
+		if (!(blob instanceof Blob)) throw new Error("Unable to create attachment: expected a Blob");
+		const bytes = await blob.arrayBuffer();
+		return Attachment.fromBytes(bytes, {
+			type: blob.type,
+			...options
+		});
+	}
+};
 var MailChannels = class extends MailChannelsClient {
 	emails = new Emails(this);
 	domains = new Domains(this);
@@ -1678,4 +1792,4 @@ var MailChannels = class extends MailChannelsClient {
 		super(key, options);
 	}
 };
-export { Domains, Emails, MailChannels, MailChannelsClient, Metrics, SubAccounts, Suppressions, Webhooks };
+export { Attachment, Domains, Emails, MailChannels, MailChannelsClient, Metrics, SubAccounts, Suppressions, Webhooks };

package/package.json

@@ -1,26 +1,24 @@
 {
   "name": "mailchannels-sdk",
-  "version": "0.8.0-1",
+  "version": "1.0.0",
   "description": "Node.js SDK to integrate MailChannels Email API into your JavaScript or TypeScript server-side applications.",
   "type": "module",
   "license": "MIT",
   "keywords": [
     "mailchannels",
-    "javascript",
     "typescript",
-    "node",
-    "sdk",
-    "email"
+    "email",
+    "transactional-email",
+    "sdk"
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Yizack/mailchannels.git"
+    "url": "git+https://bitbucket.org/mailchannels/mailchannels-email-api-sdk-js.git"
   },
   "homepage": "https://mailchannels.yizack.com",
   "author": {
-    "name": "Yizack Rangel",
-    "email": "yizackr@gmail.com",
-    "url": "https://yizack.com"
+    "name": "MailChannels",
+    "email": "dev@mailchannels.com"
   },
   "main": "./dist/mailchannels.mjs",
   "exports": {
@@ -38,27 +36,31 @@
     "dist"
   ],
   "dependencies": {
+    "mime": "^4.1.0",
     "ofetch": "^2.0.0-alpha.3"
   },
   "devDependencies": {
     "@stylistic/eslint-plugin": "^5.10.0",
     "@types/markdown-it": "^14.1.2",
-    "@types/node": "^25.8.0",
-    "@vitest/coverage-v8": "^4.1.6",
+    "@types/node": "^25.9.2",
+    "@vitest/coverage-v8": "^4.1.8",
     "changelogen": "^0.6.2",
-    "obuild": "^0.4.35",
-    "oxlint": "^1.65.0",
+    "obuild": "^0.4.36",
+    "oxlint": "^1.68.0",
     "scule": "^1.3.0",
     "typescript": "^6.0.3",
     "vitepress": "^2.0.0-alpha.17",
     "vitepress-plugin-group-icons": "^1.7.5",
-    "vitepress-plugin-llms": "^1.12.2",
-    "vitest": "^4.1.6"
+    "vitepress-plugin-llms": "^1.13.1",
+    "vitest": "^4.1.8"
+  },
+  "engines": {
+    "node": ">=20"
   },
   "scripts": {
     "build": "obuild",
-    "parity:fixtures": "node scripts/generate-parity-fixtures.mjs",
-    "release": "pnpm lint && pnpm test && pnpm build && changelogen --release && git push --follow-tags",
+    "parity:fixtures": "node scripts/generate-parity-fixtures.ts",
+    "release": "pnpm lint && pnpm test && pnpm build && changelogen --bump",
     "simulate": "node src/cli.ts simulate",
     "lint": "oxlint",
     "lint:fix": "oxlint --fix",