mailchannels-sdk 1.2.0 → 1.3.1

package/.agents/skills/mailchannels-js/resources/attachments.md

@@ -45,12 +45,11 @@ const attachment = await Attachment.fromBlob(blob, { filename: 'hello.txt' })
 
 ### Inline Images (CID References)
 
-Pass `disposition: 'inline'` and a `contentId` to embed an image inside the HTML body:
+Pass a `contentId` to embed an image inside the HTML body:
 
 ```ts
 const logo = Attachment.fromBytes(bytes, {
   filename: 'logo.png',
-  disposition: 'inline',
   contentId: 'company-logo'
 })
 
@@ -72,7 +71,6 @@ Both `fromBytes` and `fromBlob` accept an `AttachmentOptions` object:
 | `filename` | `string` | Required. MIME type is inferred from it when `type` is omitted. |
 | `type` | `string` | MIME type. Inferred from `filename` if omitted. For `fromBlob`, defaults to the Blob's own `type`. |
 | `contentId` | `string` | For `cid:` inline image references. |
-| `disposition` | `'attachment' \| 'inline'` | Defaults to `'attachment'`. |
 
 ### Awaiting Attachments Lazily
 

package/.agents/skills/mailchannels-js/resources/sub-accounts.md

@@ -4,8 +4,6 @@ Sub-accounts are first-class on MailChannels. Use them for tenants, customers, o
 senders so that one customer's reputation, limits, and bad traffic don't contaminate the
 parent account or other tenants.
 
-> Sub-accounts are only available on parent accounts on the 100K and higher plans.
-
 ### Handles
 
 A handle uniquely identifies a sub-account. Rules:

package/.agents/skills/mailchannels-js/resources/suppressions.md

@@ -10,8 +10,8 @@ import { MailChannels } from 'mailchannels-sdk'
 
 const mc = new MailChannels('YOUR-API-KEY')
 
-const { success, error } = await mc.suppressions.create({
-  entries: [
+const { success, error } = await mc.suppressions.create(
+  [
     {
       recipient: 'out@example.net',
       types: ['non-transactional'],          // optional; defaults to non-transactional
@@ -22,8 +22,8 @@ const { success, error } = await mc.suppressions.create({
       types: ['transactional', 'non-transactional']
     }
   ],
-  addToSubAccounts: true   // parent only; copies entries to every sub-account
-})
+  { addToSubAccounts: true }   // parent only; copies entries to every sub-account
+)
 ```
 
 Constraints:
@@ -83,9 +83,9 @@ that recipient regardless of origin.
 
 ### Patterns
 
-- **Preference center opt-out**: set `type` according to the email category, e.g. `non-transactional` for marketing 
-  emails, `transactional` for order updates, and so on. 
+- **Preference center opt-out**: set `types` according to the email category, e.g. `non-transactional` for marketing
+  emails, `transactional` for order updates, and so on.
   Configure `addToSubAccounts` depending on whether the preference applies to all sub-accounts or just the parent account.
   Add a note to indicate the source, e.g. "Opted out via preference center".
-- **Migrating from another ESP**: bulk-create with `addToSubAccounts: true` so every tenant
+- **Migrating from another ESP**: bulk-create with option `addToSubAccounts: true` so every tenant
   inherits the list.

package/README.md

@@ -9,7 +9,7 @@
 [![TypeScript][typescript-src]][typescript-href]
 [![Node.js][node-src]][node-href]
 
-> Built and tested against Email API `1.4.0`
+> Built and tested against Email API `1.6.0`
 
 Node.js SDK to integrate [MailChannels Email API](https://docs.mailchannels.com/email-api) into your JavaScript or TypeScript server-side applications.
 
@@ -273,7 +273,7 @@ pnpm test:watch
 # Run typecheck
 pnpm test:types
 
-# Refresh API parity fixtures, specs, and README version note
+# Refresh API parity fixtures and README version note
 pnpm parity:fixtures
 
 # Run the local simulator

package/dist/_chunks/{simulator.mjs → simulate.mjs}

@@ -1,4 +1,5 @@
 import { randomBytes, randomUUID } from "node:crypto";
+import { parseArgs } from "node:util";
 import { createServer } from "node:http";
 const SIMULATOR_SIGNING_KEY_ID = "simulator-default";
 const JSON_HEADERS = { "content-type": "application/json" };
@@ -55,6 +56,7 @@ const createMetricsBuckets = (count) => [{
 const createAccountState = (apiKey) => ({
 	apiKey,
 	customerHandle: createId("customer"),
+	limit: { sends: 1e5 },
 	customTrackingDomains: [],
 	dkimKeysByDomain: /* @__PURE__ */ new Map(),
 	messages: [],
@@ -312,8 +314,8 @@ const createEmailApiHandler = ({ logRequests = true } = {}) => {
 				}
 				targetKey.status = "rotated";
 				targetKey.status_modified_at = currentTimestamp();
-				targetKey.gracePeriodExpiresAt = new Date(Date.now() + 10080 * 60 * 1e3).toISOString();
-				targetKey.retiresAt = new Date(Date.now() + 720 * 60 * 60 * 1e3).toISOString();
+				targetKey.gracePeriodExpiresAt = new Date(Date.now() + 6048e5).toISOString();
+				targetKey.retiresAt = new Date(Date.now() + 2592e6).toISOString();
 				const newKey = createDkimKey(domain, body?.new_key?.selector || createId("selector"));
 				account.dkimKeysByDomain.set(domain, [...keys, newKey]);
 				sendJson(response, 201, {
@@ -600,10 +602,13 @@ const createEmailApiHandler = ({ logRequests = true } = {}) => {
 					return;
 				}
 				if (suffix === "usage" && method === "GET") {
+					const subLimitSends = subAccount.limit?.sends ?? -1;
+					const monthlyLimit = subLimitSends === -1 ? account.limit.sends : subLimitSends;
 					sendJson(response, 200, {
 						period_end_date: currentTimestamp(),
 						period_start_date: new Date((/* @__PURE__ */ new Date()).setDate(1)).toISOString(),
-						total_usage: subAccount.usage
+						total_usage: subAccount.usage,
+						monthly_limit: monthlyLimit
 					});
 					return;
 				}
@@ -623,7 +628,7 @@ const createEmailApiHandler = ({ logRequests = true } = {}) => {
 					end_time: url.searchParams.get("end_time") || currentTimestamp(),
 					open: summary.open,
 					open_tracking_delivered: summary.openTrackingDelivered,
-					start_time: url.searchParams.get("start_time") || (/* @__PURE__ */ new Date(Date.now() - 720 * 60 * 60 * 1e3)).toISOString()
+					start_time: url.searchParams.get("start_time") || (/* @__PURE__ */ new Date(Date.now() - 2592e6)).toISOString()
 				});
 				return;
 			}
@@ -642,7 +647,7 @@ const createEmailApiHandler = ({ logRequests = true } = {}) => {
 					delivered: summary.delivered,
 					end_time: url.searchParams.get("end_time") || currentTimestamp(),
 					processed: summary.processed,
-					start_time: url.searchParams.get("start_time") || (/* @__PURE__ */ new Date(Date.now() - 720 * 60 * 60 * 1e3)).toISOString()
+					start_time: url.searchParams.get("start_time") || (/* @__PURE__ */ new Date(Date.now() - 2592e6)).toISOString()
 				});
 				return;
 			}
@@ -655,7 +660,7 @@ const createEmailApiHandler = ({ logRequests = true } = {}) => {
 						unsubscribed: createMetricsBuckets(summary.unsubscribed)
 					},
 					end_time: url.searchParams.get("end_time") || currentTimestamp(),
-					start_time: url.searchParams.get("start_time") || (/* @__PURE__ */ new Date(Date.now() - 720 * 60 * 60 * 1e3)).toISOString(),
+					start_time: url.searchParams.get("start_time") || (/* @__PURE__ */ new Date(Date.now() - 2592e6)).toISOString(),
 					unsubscribe_delivered: summary.unsubscribeDelivered,
 					unsubscribed: summary.unsubscribed
 				});
@@ -674,7 +679,7 @@ const createEmailApiHandler = ({ logRequests = true } = {}) => {
 					dropped: summary.dropped,
 					end_time: url.searchParams.get("end_time") || currentTimestamp(),
 					processed: summary.processed,
-					start_time: url.searchParams.get("start_time") || (/* @__PURE__ */ new Date(Date.now() - 720 * 60 * 60 * 1e3)).toISOString()
+					start_time: url.searchParams.get("start_time") || (/* @__PURE__ */ new Date(Date.now() - 2592e6)).toISOString()
 				});
 				return;
 			}
@@ -714,16 +719,27 @@ const createEmailApiHandler = ({ logRequests = true } = {}) => {
 					limit,
 					offset,
 					senders: senders.slice(offset, offset + limit),
-					start_time: (/* @__PURE__ */ new Date(Date.now() - 720 * 60 * 60 * 1e3)).toISOString(),
+					start_time: (/* @__PURE__ */ new Date(Date.now() - 2592e6)).toISOString(),
 					total: senders.length
 				});
 				return;
 			}
 			if (url.pathname === "/tx/v1/usage" && method === "GET") {
+				let totalUsage = account.messages.length;
+				let monthlyLimit = account.limit.sends;
+				if (scopeHandle) {
+					const subAccount = account.subAccounts.get(scopeHandle);
+					if (subAccount) {
+						totalUsage = subAccount.usage;
+						const subLimitSends = subAccount.limit?.sends ?? -1;
+						monthlyLimit = subLimitSends === -1 ? account.limit.sends : subLimitSends;
+					}
+				}
 				sendJson(response, 200, {
 					period_end_date: currentTimestamp(),
 					period_start_date: new Date((/* @__PURE__ */ new Date()).setDate(1)).toISOString(),
-					total_usage: account.messages.length
+					total_usage: totalUsage,
+					monthly_limit: monthlyLimit
 				});
 				return;
 			}
@@ -781,6 +797,10 @@ const DEFAULT_HOST = "127.0.0.1";
 const DEFAULT_PORT = 8787;
 const createSimulator = (options = {}) => {
 	const { host = DEFAULT_HOST, port = DEFAULT_PORT } = options;
+	if (port !== void 0 && (isNaN(port) || port < 0 || port > 65535)) {
+		console.error("[Simulator]", `Invalid port '${port}': must be an integer between 0 and 65535.`);
+		process.exit(1);
+	}
 	const logRequests = !options.silent;
 	const emailApi = createEmailApiHandler({ logRequests });
 	const server = createServer(async (request, response) => {
@@ -828,4 +848,39 @@ const createSimulator = (options = {}) => {
 		}
 	};
 };
-export { createSimulator };
+var simulate_default = async (args) => {
+	const { MAILCHANNELS_SIMULATOR_PORT, MAILCHANNELS_SIMULATOR_HOST } = process.env;
+	const { values } = parseArgs({
+		args,
+		options: {
+			port: {
+				type: "string",
+				short: "p",
+				default: MAILCHANNELS_SIMULATOR_PORT
+			},
+			host: {
+				type: "string",
+				short: "h",
+				default: MAILCHANNELS_SIMULATOR_HOST
+			},
+			silent: {
+				type: "boolean",
+				short: "s",
+				default: false
+			}
+		}
+	});
+	const simulator = createSimulator({
+		host: values.host,
+		port: values.port !== void 0 ? Number.parseInt(values.port, 10) : void 0,
+		silent: values.silent
+	});
+	await simulator.listen();
+	const shutdown = async () => {
+		await simulator.close();
+		process.exit(0);
+	};
+	process.on("SIGINT", shutdown);
+	process.on("SIGTERM", shutdown);
+};
+export { simulate_default as default };

package/dist/cli/index.d.mts

@@ -0,0 +1 @@
+export {}

package/dist/cli/index.mjs

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+const LOGGER_NAME = "[MailChannels-CLI]";
+console.info = console.info.bind(console.info, LOGGER_NAME);
+console.error = console.error.bind(console.error, LOGGER_NAME);
+const [command, ...args] = process.argv.slice(2);
+switch (command) {
+	case "simulate":
+		const { default: simulate } = await import("../_chunks/simulate.mjs");
+		await simulate(args);
+		break;
+	default:
+		console.error(`Unknown command: ${command}`);
+		process.exit(1);
+}
+export {};

package/dist/mailchannels.d.mts

@@ -121,13 +121,11 @@ interface EmailsSendAttachment {
    */
   type?: string;
   /**
-   * The `Content-ID` header value for inline attachments, referenced from HTML with `cid:`.
+   * A unique identifier for this attachment.
+   *
+   * When set, the attachment is embedded inline in the message body (`Content-Disposition: inline`) instead of offered as a downloadable attachment, and can be referenced from HTML content via a `cid:` URI, e.g. `<img src="cid:logo123">` refers to an attachment with content_id: `logo123`. (RFC 2392). Must be unique across all attachments in the request. Max length is 255 characters.
    */
   contentId?: string;
-  /**
-   * The `Content-Disposition` header value for the attachment.
-   */
-  disposition?: "attachment" | "inline";
 }
 interface EmailsSendTracking {
   /**
@@ -193,7 +191,7 @@ interface EmailsSendContent {
    */
   value: string;
 }
-type EmailsSendRecipientInput = EmailsSendRecipient[] | EmailsSendRecipient | string[] | string;
+type EmailsSendRecipientInput = EmailsSendRecipient | string | (EmailsSendRecipient | string)[];
 interface EmailsSendDkim {
   /**
    * Domain used for DKIM signing.
@@ -1440,8 +1438,15 @@ interface SubAccountsUsage {
   startDate?: string;
   /**
    * The total usage for the current billing period.
+   * @example 5000
    */
   total: number;
+  /**
+   * The effective monthly limit for the current billing period. A limit of zero means the account cannot send any messages.
+   * For sub-accounts with no explicit limit set (i.e., -1), the monthly limit for the parent account is returned.
+   * @example 10000
+   */
+  monthlyLimit: number;
 }
 type SubAccountsUsageResponse = DataResponse<SubAccountsUsage>;
 interface MetricsEngagement {
@@ -1612,8 +1617,15 @@ type MetricsUsageResponse = DataResponse<{
   startDate?: string;
   /**
    * The total usage for the current billing period.
+   * @example 5000
    */
   total: number;
+  /**
+   * The effective monthly limit for the current billing period. A limit of zero means the account cannot send any messages.
+   * For sub-accounts with no explicit limit set (i.e., -1), the monthly limit for the parent account is returned.
+   * @example 10000
+   */
+  monthlyLimit: number;
 }>;
 type MetricsSendersType = "sub-accounts" | "campaigns";
 interface MetricsSendersOptions {
@@ -1696,6 +1708,21 @@ interface MetricsOptions {
   interval?: "hour" | "day" | "week" | "month";
 }
 type SuppressionsTypes = "transactional" | "non-transactional";
+interface SuppressionsCreateEntry {
+  /**
+   * Must be less than `1024` characters.
+   */
+  notes?: string;
+  /**
+   * The email address to suppress. Must be a valid email address format and less than `255` characters.
+   */
+  recipient: string;
+  /**
+   * An array of types of suppression to apply to the recipient.
+   * @default ["non-transactional"]
+   */
+  types?: SuppressionsTypes[];
+}
 interface SuppressionsCreateOptions {
   /**
    * If true, the parent account creates suppression entries for all associated sub-accounts. This field is only applicable to parent accounts. Sub-accounts cannot create entries for other sub-accounts.
@@ -1704,22 +1731,9 @@ interface SuppressionsCreateOptions {
   addToSubAccounts?: boolean;
   /**
    * The total number of suppression entries to create, for the parent and/or its sub-accounts, must not exceed `1000`.
+   * @deprecated Use `create(entries, options?)` instead.
    */
-  entries: {
-    /**
-     * Must be less than `1024` characters.
-     */
-    notes?: string;
-    /**
-     * The email address to suppress. Must be a valid email address format and less than `255` characters.
-     */
-    recipient: string;
-    /**
-     * An array of types of suppression to apply to the recipient.
-     * @default ["non-transactional"]
-     */
-    types?: SuppressionsTypes[];
-  }[];
+  entries: SuppressionsCreateEntry[];
 }
 type SuppressionsSource = "api" | "unsubscribe_link" | "list_unsubscribe" | "hard_bounce" | "spam_complaint" | "all";
 interface SuppressionsListOptions {
@@ -1877,7 +1891,7 @@ declare class SubAccounts {
   readonly limits: SubAccountsLimits;
   constructor(mailchannels: MailChannelsClient);
   /**
-   * Creates a new sub-account under the parent account. Each sub-account must have a unique handle composed solely of lowercase alphanumeric characters. If no handle is provided, a random handle will be generated. Note that Sub-accounts are only available to parent accounts on 100K and higher plans.
+   * Creates a new sub-account under the parent account. Each sub-account must have a unique handle composed solely of lowercase alphanumeric characters. If no handle is provided, a random handle will be generated.
    * @param companyName - The name of the company associated with the sub-account. This name is used for display purposes only and does not affect the functionality of the sub-account. The length must be between 3 and 128 characters.
    * @param handle - A unique name for the sub-account to be created. The length must be between 3 and 128 characters, and it may contain only lowercase letters and numbers. If not provided, a random handle will be generated.
    * @example
@@ -2025,14 +2039,21 @@ declare class Suppressions {
   constructor(mailchannels: MailChannelsClient);
   /**
    * Creates suppression entries for the specified account. Parent accounts can create suppression entries for all associated sub-accounts. If `types` is not provided, it defaults to `non-transactional`. The operation is atomic, meaning all entries are successfully added or none are added if an error occurs.
-   * @param options - The details of the suppression entries to create.
+   * @param entries - The total number of suppression entries to create, for the parent and/or its sub-accounts, must not exceed `1000`.
+   * @param options - The options of the suppression entries to create.
    * @example
    * ```ts
    * const mailchannels = new MailChannels('your-api-key')
-   * const { success, error } = await mailchannels.suppressions.create({
-   * // ...
-   * });
+   * const { success, error } = await mailchannels.suppressions.create([
+   *   {
+   *     notes: "test",
+   *     recipient: "name@example.com",
+   *     types: ["transactional"]
+   *   }
+   * ], { addToSubAccounts: false });
    */
+  create(entries: SuppressionsCreateEntry[], options?: Omit<SuppressionsCreateOptions, "entries">): Promise<SuccessResponse>;
+  /** @deprecated Use positional params `create(entries, options?)` instead. */
   create(options: SuppressionsCreateOptions): Promise<SuccessResponse>;
   /**
    * Deletes suppression entry associated with the account based on the specified recipient and source.
@@ -2070,4 +2091,4 @@ declare class MailChannels extends MailChannelsClient {
   readonly suppressions: Suppressions;
   constructor(key: string, options?: MailChannelsClientOptions);
 }
-export { Attachment, type DataResponse, Domains, type DomainsCheckOptions, type DomainsCheckResponse, type DomainsCheckVerdict, type DomainsCustomTrackingCreateResponse, type DomainsCustomTrackingDnsSetupRequired, type DomainsCustomTrackingDomain, type DomainsCustomTrackingListOptions, type DomainsCustomTrackingListResponse, type DomainsCustomTrackingScope, type DomainsCustomTrackingUpdateOptions, type DomainsCustomTrackingUpdateResponse, type DomainsCustomTrackingWithDnsSetupRequired, 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, type SubAccount, SubAccounts, type SubAccountsAccount, type SubAccountsApiKey, type SubAccountsApiKeysCreateResponse, type SubAccountsApiKeysListOptions, type SubAccountsApiKeysListResponse, type SubAccountsCreateApiKeyResponse, type SubAccountsCreateResponse, type SubAccountsCreateSmtpPasswordResponse, type SubAccountsLimit, type SubAccountsLimitResponse, type SubAccountsLimitsGetResponse, type SubAccountsLimitsSetOptions, type SubAccountsListApiKeyOptions, type SubAccountsListApiKeyResponse, type SubAccountsListOptions, type SubAccountsListResponse, type SubAccountsListSmtpPasswordResponse, type SubAccountsSmtpPassword, type SubAccountsSmtpPasswordsCreateResponse, type SubAccountsSmtpPasswordsListResponse, 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 };
+export { Attachment, type DataResponse, Domains, type DomainsCheckOptions, type DomainsCheckResponse, type DomainsCheckVerdict, type DomainsCustomTrackingCreateResponse, type DomainsCustomTrackingDnsSetupRequired, type DomainsCustomTrackingDomain, type DomainsCustomTrackingListOptions, type DomainsCustomTrackingListResponse, type DomainsCustomTrackingScope, type DomainsCustomTrackingUpdateOptions, type DomainsCustomTrackingUpdateResponse, type DomainsCustomTrackingWithDnsSetupRequired, 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, type SubAccount, SubAccounts, type SubAccountsAccount, type SubAccountsApiKey, type SubAccountsApiKeysCreateResponse, type SubAccountsApiKeysListOptions, type SubAccountsApiKeysListResponse, type SubAccountsCreateApiKeyResponse, type SubAccountsCreateResponse, type SubAccountsCreateSmtpPasswordResponse, type SubAccountsLimit, type SubAccountsLimitResponse, type SubAccountsLimitsGetResponse, type SubAccountsLimitsSetOptions, type SubAccountsListApiKeyOptions, type SubAccountsListApiKeyResponse, type SubAccountsListOptions, type SubAccountsListResponse, type SubAccountsListSmtpPasswordResponse, type SubAccountsSmtpPassword, type SubAccountsSmtpPasswordsCreateResponse, type SubAccountsSmtpPasswordsListResponse, type SubAccountsUsage, type SubAccountsUsageResponse, type SuccessResponse, Suppressions, type SuppressionsCreateEntry, 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

@@ -2,7 +2,7 @@ import { $fetch } from "ofetch";
 import { subtle } from "node:crypto";
 import { Buffer } from "node:buffer";
 import mime from "mime";
-var version = "1.2.0";
+var version = "1.3.1";
 var MailChannelsClient = class MailChannelsClient {
 	static DEFAULT_BASE_URL = "https://api.mailchannels.net";
 	static DEFAULT_TIMEOUT = 12e4;
@@ -225,8 +225,7 @@ const mapAttachment = (attachment) => ({
 	content: attachment.content,
 	filename: attachment.filename,
 	type: attachment.type,
-	content_id: attachment.contentId,
-	disposition: attachment.disposition
+	content_id: attachment.contentId
 });
 const mapPersonalization = (personalization, index, rootTemplateData) => {
 	const to = parseArrayRecipients(personalization.to);
@@ -1239,7 +1238,7 @@ var Webhooks = class Webhooks {
 		if (dates.createdAfter && dates.createdBefore) {
 			const createdAfter = Date.parse(dates.createdAfter);
 			const createdBefore = Date.parse(dates.createdBefore);
-			const maxRangeMs = 744 * 60 * 60 * 1e3;
+			const maxRangeMs = 26784e5;
 			if (createdBefore <= createdAfter) return {
 				data: null,
 				error: createValidationError("createdBefore must be later than createdAfter.")
@@ -1743,7 +1742,8 @@ var SubAccounts = class SubAccounts {
 			data: clean({
 				endDate: response.period_end_date,
 				startDate: response.period_start_date,
-				total: response.total_usage
+				total: response.total_usage,
+				monthlyLimit: response.monthly_limit
 			}),
 			error: null
 		};
@@ -1989,7 +1989,8 @@ var Metrics = class {
 			data: clean({
 				endDate: response.period_end_date,
 				startDate: response.period_start_date,
-				total: response.total_usage
+				total: response.total_usage,
+				monthlyLimit: response.monthly_limit
 			}),
 			error: null
 		};
@@ -2049,9 +2050,10 @@ var Suppressions = class {
 	constructor(mailchannels) {
 		this.mailchannels = mailchannels;
 	}
-	async create(options) {
+	async create(entriesOrOptions, options) {
 		let error = null;
-		const { addToSubAccounts, entries } = options;
+		const entries = Array.isArray(entriesOrOptions) ? entriesOrOptions : entriesOrOptions.entries;
+		const createOptions = Array.isArray(entriesOrOptions) ? options : entriesOrOptions;
 		if (entries.length > 1e3) {
 			error = createValidationError("The number of suppression entries must not exceed 1000.");
 			return {
@@ -2060,7 +2062,7 @@ var Suppressions = class {
 			};
 		}
 		const payload = {
-			add_to_sub_accounts: addToSubAccounts,
+			add_to_sub_accounts: createOptions?.addToSubAccounts,
 			suppression_entries: entries.map((entry) => ({
 				notes: entry.notes,
 				recipient: entry.recipient,
@@ -2167,13 +2169,12 @@ const guessContentType = (filename) => {
 };
 var Attachment = class Attachment {
 	static fromBytes(data, options) {
-		const { filename, type, contentId, disposition = "attachment" } = options;
+		const { filename, type, contentId } = options;
 		return {
 			content: base64Content(data),
 			filename: decodeURIComponent(filename) || "attachment",
 			type: type || guessContentType(filename),
-			contentId,
-			disposition
+			contentId
 		};
 	}
 	static async fromBlob(blob, options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mailchannels-sdk",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "Node.js SDK to integrate MailChannels Email API into your JavaScript or TypeScript server-side applications.",
   "type": "module",
   "license": "MIT",
@@ -29,8 +29,8 @@
   },
   "types": "./dist/mailchannels.d.mts",
   "bin": {
-    "mailchannels-sdk": "./dist/cli.mjs",
-    "mailchannels": "./dist/cli.mjs"
+    "mailchannels-sdk": "./dist/cli/index.mjs",
+    "mailchannels": "./dist/cli/index.mjs"
   },
   "files": [
     "dist",
@@ -43,16 +43,16 @@
   "devDependencies": {
     "@stylistic/eslint-plugin": "^5.10.0",
     "@types/markdown-it": "^14.1.2",
-    "@types/node": "^26.1.1",
+    "@types/node": "^26.1.2",
     "@vitest/coverage-v8": "^4.1.10",
     "changelogen": "^0.6.2",
-    "obuild": "^0.4.37",
-    "oxlint": "^1.73.0",
+    "obuild": "^0.4.38",
+    "oxlint": "^1.76.0",
     "scule": "^1.3.0",
     "typescript": "^6.0.3",
     "vitepress": "^2.0.0-alpha.18",
-    "vitepress-plugin-group-icons": "^1.7.5",
-    "vitepress-plugin-llms": "^1.13.2",
+    "vitepress-plugin-group-icons": "^1.7.6",
+    "vitepress-plugin-llms": "^1.13.4",
     "vitest": "^4.1.10"
   },
   "engines": {
@@ -62,7 +62,7 @@
     "build": "obuild",
     "parity:fixtures": "node scripts/generate-parity-fixtures.ts",
     "release": "pnpm lint && pnpm test && pnpm build && changelogen --bump",
-    "simulate": "node src/cli.ts simulate",
+    "simulate": "node src/cli/index.ts simulate",
     "lint": "oxlint",
     "lint:fix": "oxlint --fix",
     "test": "vitest run --reporter=verbose --coverage",

package/dist/cli.d.mts

@@ -1 +0,0 @@
-export { };

package/dist/cli.mjs

@@ -1,50 +0,0 @@
-#!/usr/bin/env node
-import { parseArgs } from "node:util";
-const LOGGER_NAME = "[MailChannels-CLI]";
-console.info = console.info.bind(console.info, LOGGER_NAME);
-console.error = console.error.bind(console.error, LOGGER_NAME);
-const [command, ...args] = process.argv.slice(2);
-switch (command) {
-	case "simulate":
-		const { createSimulator } = await import("./_chunks/simulator.mjs");
-		const { MAILCHANNELS_SIMULATOR_PORT, MAILCHANNELS_SIMULATOR_HOST } = process.env;
-		const { values } = parseArgs({
-			args,
-			options: {
-				port: {
-					type: "string",
-					short: "p",
-					default: MAILCHANNELS_SIMULATOR_PORT
-				},
-				host: {
-					type: "string",
-					short: "h",
-					default: MAILCHANNELS_SIMULATOR_HOST
-				},
-				silent: {
-					type: "boolean",
-					short: "s",
-					default: false
-				}
-			}
-		});
-		const port = values.port !== void 0 ? Number.parseInt(values.port, 10) : void 0;
-		if (port !== void 0 && (isNaN(port) || port < 0 || port > 65535)) {
-			console.error("[Simulator]", `Invalid port "${values.port}": must be an integer between 0 and 65535.`);
-			process.exit(1);
-		}
-		const simulator = createSimulator({
-			host: values.host,
-			port,
-			silent: values.silent
-		});
-		await simulator.listen();
-		const shutdown = async () => {
-			await simulator.close();
-			process.exit(0);
-		};
-		process.on("SIGINT", shutdown);
-		process.on("SIGTERM", shutdown);
-		break;
-}
-export {};