mailchannels-sdk 0.8.0 → 1.1.0

package/dist/mailchannels.mjs

@@ -1,10 +1,8 @@
 import { $fetch } from "ofetch";
 import { subtle } from "node:crypto";
 import { Buffer } from "node:buffer";
-import { basename } from "node:path";
-import { readFile } from "node:fs/promises";
 import mime from "mime";
-var version = "0.8.0";
+var version = "1.1.0";
 var MailChannelsClient = class MailChannelsClient {
 	static DEFAULT_BASE_URL = "https://api.mailchannels.net";
 	static DEFAULT_TIMEOUT = 12e4;
@@ -70,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 = {}) => {
@@ -83,15 +93,18 @@ 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 clean = (data) => {
@@ -147,7 +160,7 @@ const parseArrayRecipients = (recipients) => {
 	return filtered.length > 0 ? filtered : void 0;
 };
 const stripPemHeaders = (pem) => pem.replace(/-----[^-]+-----|\s|#.*$/gm, "");
-const RESERVED_HEADER_NAMES = new Set([
+const RESERVED_HEADER_NAMES = /* @__PURE__ */ new Set([
 	"authentication-results",
 	"bcc",
 	"cc",
@@ -243,7 +256,8 @@ 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'.";
@@ -337,7 +351,7 @@ var Emails = class {
 		let error = null;
 		const payload = await buildSendPayload(options);
 		if (typeof payload === "string") {
-			error = createError(payload);
+			error = createValidationError(payload);
 			return {
 				data: null,
 				error
@@ -410,80 +424,6 @@ const mapDkimKey = (key) => ({
 	status: key.status,
 	statusModifiedAt: key.status_modified_at
 });
-var Domains = class {
-	mailchannels;
-	dkim;
-	constructor(mailchannels) {
-		this.mailchannels = mailchannels;
-		this.dkim = new DomainsDkim(mailchannels);
-	}
-	async check(domain, options) {
-		let error = null;
-		if (!domain) {
-			error = createError("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.");
-			return {
-				data: null,
-				error
-			};
-		}
-		if (dkimOptions?.find(({ privateKey, selector }) => privateKey && !selector)) {
-			error = createError("DKIM settings with a privateKey must also include a selector.");
-			return {
-				data: null,
-				error
-			};
-		}
-		const payload = {
-			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: options?.senderId
-		};
-		const response = await this.mailchannels.post("/tx/v1/check-domain", {
-			body: payload,
-			onResponseError: async ({ response }) => {
-				error = getStatusError(response, {
-					[400]: "Bad Request.",
-					[403]: "User does not have access to this feature."
-				});
-			}
-		}).catch((e) => {
-			error ||= getResultError(e, "Failed to check domain.");
-			return null;
-		});
-		if (!response) return {
-			data: null,
-			error
-		};
-		return {
-			data: clean({
-				dkim: response.check_results.dkim.map((dkimResults) => ({
-					domain: dkimResults.dkim_domain,
-					keyStatus: dkimResults.dkim_key_status,
-					selector: dkimResults.dkim_selector,
-					reason: dkimResults.reason,
-					verdict: dkimResults.verdict
-				})),
-				domainLockdown: response.check_results.domain_lockdown,
-				senderDomain: response.check_results.sender_domain,
-				spf: response.check_results.spf,
-				references: response.references
-			}),
-			error: null
-		};
-	}
-};
 var DomainsDkim = class {
 	mailchannels;
 	constructor(mailchannels) {
@@ -492,14 +432,14 @@ var DomainsDkim = class {
 	async create(domain, options) {
 		let error = null;
 		if (!domain) {
-			error = createError("No domain provided.");
+			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
@@ -510,7 +450,7 @@ var DomainsDkim = class {
 			key_length: options.length,
 			selector: options.selector
 		};
-		const response = await this.mailchannels.post(`/tx/v1/domains/${domain}/dkim-keys`, {
+		const response = await this.mailchannels.post(`/tx/v1/domains/${encodeURIComponent(domain)}/dkim-keys`, {
 			body: payload,
 			onResponseError: async ({ response }) => {
 				error = getStatusError(response, {
@@ -534,14 +474,14 @@ var DomainsDkim = class {
 	async list(domain, options) {
 		let error = null;
 		if (!domain) {
-			error = createError("No domain provided.");
+			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
@@ -562,7 +502,7 @@ var DomainsDkim = class {
 			limit: options?.limit,
 			include_dns_record: options?.includeDnsRecord
 		};
-		const response = await this.mailchannels.get(`/tx/v1/domains/${domain}/dkim-keys`, {
+		const response = await this.mailchannels.get(`/tx/v1/domains/${encodeURIComponent(domain)}/dkim-keys`, {
 			query: payload,
 			onResponseError: async ({ response }) => {
 				error = getStatusError(response, { [400]: "Bad Request." });
@@ -583,21 +523,21 @@ var DomainsDkim = class {
 	async updateStatus(domain, options) {
 		let error = null;
 		if (!domain) {
-			error = createError("No domain provided.");
+			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
 			};
 		}
 		const payload = { status: options.status };
-		await this.mailchannels.patch(`/tx/v1/domains/${domain}/dkim-keys/${options.selector}`, {
+		await this.mailchannels.patch(`/tx/v1/domains/${encodeURIComponent(domain)}/dkim-keys/${encodeURIComponent(options.selector)}`, {
 			body: payload,
 			onResponseError: async ({ response }) => {
 				error = getStatusError(response, {
@@ -616,28 +556,28 @@ var DomainsDkim = class {
 	async rotate(domain, selector, options) {
 		let error = null;
 		if (!domain) {
-			error = createError("No domain provided.");
+			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
 			};
 		}
 		const payload = { new_key: { selector: options.newKey.selector } };
-		const response = await this.mailchannels.post(`/tx/v1/domains/${domain}/dkim-keys/${selector}/rotate`, {
+		const response = await this.mailchannels.post(`/tx/v1/domains/${encodeURIComponent(domain)}/dkim-keys/${encodeURIComponent(selector)}/rotate`, {
 			body: payload,
 			onResponseError: async ({ response }) => {
 				error = getStatusError(response, {
@@ -663,6 +603,80 @@ var DomainsDkim = class {
 		};
 	}
 };
+var Domains = class {
+	mailchannels;
+	dkim;
+	constructor(mailchannels) {
+		this.mailchannels = mailchannels;
+		this.dkim = new DomainsDkim(mailchannels);
+	}
+	async check(domain, options) {
+		let error = null;
+		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 = createValidationError("A maximum of 10 DKIM settings can be provided.");
+			return {
+				data: null,
+				error
+			};
+		}
+		if (dkimOptions?.find(({ privateKey, selector }) => privateKey && !selector)) {
+			error = createValidationError("DKIM settings with a privateKey must also include a selector.");
+			return {
+				data: null,
+				error
+			};
+		}
+		const payload = {
+			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: options?.senderId
+		};
+		const response = await this.mailchannels.post("/tx/v1/check-domain", {
+			body: payload,
+			onResponseError: async ({ response }) => {
+				error = getStatusError(response, {
+					[400]: "Bad Request.",
+					[403]: "User does not have access to this feature."
+				});
+			}
+		}).catch((e) => {
+			error ||= getResultError(e, "Failed to check domain.");
+			return null;
+		});
+		if (!response) return {
+			data: null,
+			error
+		};
+		return {
+			data: clean({
+				dkim: response.check_results.dkim.map((dkimResults) => ({
+					domain: dkimResults.dkim_domain,
+					keyStatus: dkimResults.dkim_key_status,
+					selector: dkimResults.dkim_selector,
+					reason: dkimResults.reason,
+					verdict: dkimResults.verdict
+				})),
+				domainLockdown: response.check_results.domain_lockdown,
+				senderDomain: response.check_results.sender_domain,
+				spf: response.check_results.spf,
+				references: response.references
+			}),
+			error: null
+		};
+	}
+};
 const HMAC_SHA256 = {
 	name: "HMAC",
 	hash: "SHA-256"
@@ -735,6 +749,35 @@ async function isValidWebhook(options) {
 	const key = await subtle.importKey(format, publicKeyBuffer, ED25519, false, ["verify"]);
 	return subtle.verify(ED25519.name, key, webhookSignatureBuffer, encoder.encode(signingString));
 }
+const ISO_DATE_REGEX = /^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:?\d{2})$/;
+const ISO_DATE_ONLY_REGEX = /^\d{4}-\d{2}-\d{2}$/;
+const formatDateInput = (value) => {
+	if (value instanceof Date) {
+		if (Number.isNaN(value.getTime())) return null;
+		return value.toISOString();
+	}
+	if (typeof value === "string") {
+		if (!ISO_DATE_REGEX.test(value) && !ISO_DATE_ONLY_REGEX.test(value) || Number.isNaN(Date.parse(value))) return null;
+		if (ISO_DATE_REGEX.test(value)) return new Date(value).toISOString();
+	}
+	return value;
+};
+const parseDateInputs = (options) => {
+	const dates = {};
+	const keys = Object.keys(options);
+	for (const key of keys) {
+		const formatted = formatDateInput(options?.[key]);
+		if (formatted === null) return {
+			dates: null,
+			error: createValidationError(`The '${key}' value is not a valid date.`)
+		};
+		dates[key] = formatted;
+	}
+	return {
+		dates,
+		error: null
+	};
+};
 var Webhooks = class Webhooks {
 	mailchannels;
 	constructor(mailchannels) {
@@ -743,14 +786,14 @@ var Webhooks = class Webhooks {
 	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
@@ -827,7 +870,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
@@ -860,7 +903,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
@@ -869,7 +912,7 @@ 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
@@ -894,7 +937,7 @@ var Webhooks = class Webhooks {
 				error: null
 			};
 		} catch {
-			error = createError("Invalid webhook payload.");
+			error = createValidationError("Invalid webhook payload.");
 			return {
 				data: null,
 				error
@@ -916,37 +959,37 @@ 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.")
-		};
-		if (options?.createdBefore && Number.isNaN(Date.parse(options.createdBefore))) return {
+		const { dates, error: dateError } = parseDateInputs({
+			createdAfter: options?.createdAfter,
+			createdBefore: options?.createdBefore
+		});
+		if (!dates || dateError) return {
 			data: null,
-			error: createError("createdBefore must be a valid date string.")
+			error: dateError
 		};
-		if (options?.createdAfter && options?.createdBefore) {
-			const createdAfter = Date.parse(options.createdAfter);
-			const createdBefore = Date.parse(options.createdBefore);
+		if (dates.createdAfter && dates.createdBefore) {
+			const createdAfter = Date.parse(dates.createdAfter);
+			const createdBefore = Date.parse(dates.createdBefore);
 			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", {
 			query: {
-				created_after: options?.createdAfter,
-				created_before: options?.createdBefore,
+				created_after: dates.createdAfter,
+				created_before: dates.createdBefore,
 				statuses: options?.statuses,
 				webhook: options?.webhook,
 				limit: options?.limit,
@@ -979,7 +1022,7 @@ var Webhooks = class Webhooks {
 	}
 	async resendBatch(batchId) {
 		let error = null;
-		const response = await this.mailchannels.post(`/tx/v1/webhook-batch/${batchId}/resend`, { onResponseError: async ({ response }) => {
+		const response = await this.mailchannels.post(`/tx/v1/webhook-batch/${encodeURIComponent(batchId)}/resend`, { onResponseError: async ({ response }) => {
 			error = getStatusError(response, {
 				[400]: "Bad Request. The batch ID is invalid.",
 				[404]: `The batch '${batchId}' is not found for the customer.`
@@ -1006,161 +1049,21 @@ var Webhooks = class Webhooks {
 		};
 	}
 };
-var SubAccounts = class SubAccounts {
+var SubAccountsApiKeys = class {
 	mailchannels;
-	static COMPANY_PATTERN = /^.{3,128}$/;
-	static HANDLE_PATTERN = /^[a-z0-9]{3,128}$/;
 	constructor(mailchannels) {
 		this.mailchannels = mailchannels;
 	}
-	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.");
-			return {
-				data: null,
-				error
-			};
-		}
-		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.");
-				return {
-					data: null,
-					error
-				};
-			}
-		}
-		const response = await this.mailchannels.post("/tx/v1/sub-account", {
-			body: {
-				company_name: companyName,
-				handle
-			},
-			onResponseError: async ({ response }) => {
-				error = getStatusError(response, {
-					[403]: "The parent account does not have permission to create sub-accounts.",
-					[409]: `Sub-account with handle '${handle}' already exists.`
-				});
-			}
-		}).catch((e) => {
-			error ||= getResultError(e, "Failed to create sub-account.");
-			return null;
-		});
-		if (!response) return {
-			data: null,
-			error
-		};
-		return {
-			data: clean({
-				companyName: response.company_name,
-				enabled: response.enabled,
-				handle: response.handle
-			}),
-			error: null
-		};
-	}
-	async list(options) {
-		let error = null;
-		error = validatePagination({
-			...options,
-			max: 1e3
-		});
-		if (error) return {
-			data: null,
-			error
-		};
-		const response = await this.mailchannels.get("/tx/v1/sub-account", {
-			query: options,
-			onResponseError: async ({ response }) => {
-				error = getStatusError(response);
-			}
-		}).catch((e) => {
-			error ||= getResultError(e, "Failed to fetch sub-accounts.");
-			return null;
-		});
-		if (!response) return {
-			data: null,
-			error
-		};
-		return {
-			data: clean(response.map((account) => ({
-				companyName: account.company_name,
-				enabled: account.enabled,
-				handle: account.handle
-			}))),
-			error: null
-		};
-	}
-	async delete(handle) {
+	async create(handle) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
-			return {
-				success: false,
-				error
-			};
-		}
-		await this.mailchannels.delete(`/tx/v1/sub-account/${handle}`, { onResponseError: async ({ response }) => {
-			error = getStatusError(response);
-		} }).catch((e) => {
-			error ||= getResultError(e, "Failed to delete sub-account.");
-		});
-		return {
-			success: !error,
-			error
-		};
-	}
-	async suspend(handle) {
-		let error = null;
-		if (!handle) {
-			error = createError("No handle provided.");
-			return {
-				success: false,
-				error
-			};
-		}
-		await this.mailchannels.post(`/tx/v1/sub-account/${handle}/suspend`, { onResponseError: async ({ response }) => {
-			error = getStatusError(response, { [404]: `The specified sub-account '${handle}' does not exist.` });
-		} }).catch((e) => {
-			error ||= getResultError(e, "Failed to suspend sub-account.");
-		});
-		return {
-			success: !error,
-			error
-		};
-	}
-	async activate(handle) {
-		let error = null;
-		if (!handle) {
-			error = createError("No handle provided.");
-			return {
-				success: false,
-				error
-			};
-		}
-		await this.mailchannels.post(`/tx/v1/sub-account/${handle}/activate`, { onResponseError: async ({ response }) => {
-			error = getStatusError(response, {
-				[403]: "The parent account does not have permission to activate the sub-account.",
-				[404]: `The specified sub-account '${handle}' does not exist.`
-			});
-		} }).catch((e) => {
-			error ||= getResultError(e, "Failed to activate sub-account.");
-		});
-		return {
-			success: !error,
-			error
-		};
-	}
-	async createApiKey(handle) {
-		let error = null;
-		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				data: null,
 				error
 			};
 		}
-		const response = await this.mailchannels.post(`/tx/v1/sub-account/${handle}/api-key`, { onResponseError: async ({ response }) => {
+		const response = await this.mailchannels.post(`/tx/v1/sub-account/${encodeURIComponent(handle)}/api-key`, { onResponseError: async ({ response }) => {
 			error = getStatusError(response, {
 				[403]: "You can't create API keys for this sub-account.",
 				[404]: `Sub-account with handle '${handle}' not found.`,
@@ -1179,10 +1082,10 @@ var SubAccounts = class SubAccounts {
 			error: null
 		};
 	}
-	async listApiKeys(handle, options) {
+	async list(handle, options) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				data: null,
 				error
@@ -1196,9 +1099,12 @@ var SubAccounts = class SubAccounts {
 			data: null,
 			error
 		};
-		const response = await this.mailchannels.get(`/tx/v1/sub-account/${handle}/api-key`, { onResponseError: async ({ response }) => {
-			error = getStatusError(response, { [404]: `Sub-account with handle '${handle}' not found.` });
-		} }).catch((e) => {
+		const response = await this.mailchannels.get(`/tx/v1/sub-account/${encodeURIComponent(handle)}/api-key`, {
+			query: options,
+			onResponseError: async ({ response }) => {
+				error = getStatusError(response, { [404]: `Sub-account with handle '${handle}' not found.` });
+			}
+		}).catch((e) => {
 			error ||= getResultError(e, "Failed to fetch sub-account API keys.");
 			return null;
 		});
@@ -1214,16 +1120,16 @@ var SubAccounts = class SubAccounts {
 			error: null
 		};
 	}
-	async deleteApiKey(handle, id) {
+	async delete(handle, id) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				success: false,
 				error
 			};
 		}
-		await this.mailchannels.delete(`/tx/v1/sub-account/${handle}/api-key/${id}`, { onResponseError: async ({ response }) => {
+		await this.mailchannels.delete(`/tx/v1/sub-account/${encodeURIComponent(handle)}/api-key/${encodeURIComponent(id)}`, { onResponseError: async ({ response }) => {
 			error = getStatusError(response, { [400]: "Missing or invalid API key ID." });
 		} }).catch((e) => {
 			error ||= getResultError(e, "Failed to delete sub-account API key.");
@@ -1233,16 +1139,22 @@ var SubAccounts = class SubAccounts {
 			error
 		};
 	}
-	async createSmtpPassword(handle) {
+};
+var SubAccountsSmtpPasswords = class {
+	mailchannels;
+	constructor(mailchannels) {
+		this.mailchannels = mailchannels;
+	}
+	async create(handle) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				data: null,
 				error
 			};
 		}
-		const response = await this.mailchannels.post(`/tx/v1/sub-account/${handle}/smtp-password`, { onResponseError: async ({ response }) => {
+		const response = await this.mailchannels.post(`/tx/v1/sub-account/${encodeURIComponent(handle)}/smtp-password`, { onResponseError: async ({ response }) => {
 			error = getStatusError(response, {
 				[403]: "You can't create SMTP passwords for this sub-account.",
 				[404]: `Sub-account with handle '${handle}' not found.`,
@@ -1265,16 +1177,16 @@ var SubAccounts = class SubAccounts {
 			error: null
 		};
 	}
-	async listSmtpPasswords(handle) {
+	async list(handle) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				data: null,
 				error
 			};
 		}
-		const response = await this.mailchannels.get(`/tx/v1/sub-account/${handle}/smtp-password`, { onResponseError: async ({ response }) => {
+		const response = await this.mailchannels.get(`/tx/v1/sub-account/${encodeURIComponent(handle)}/smtp-password`, { onResponseError: async ({ response }) => {
 			error = getStatusError(response, { [404]: `Sub-account with handle '${handle}' not found.` });
 		} }).catch((e) => {
 			error ||= getResultError(e, "Failed to fetch sub-account SMTP passwords.");
@@ -1293,16 +1205,16 @@ var SubAccounts = class SubAccounts {
 			error: null
 		};
 	}
-	async deleteSmtpPassword(handle, id) {
+	async delete(handle, id) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				success: false,
 				error
 			};
 		}
-		await this.mailchannels.delete(`/tx/v1/sub-account/${handle}/smtp-password/${id}`, { onResponseError: async ({ response }) => {
+		await this.mailchannels.delete(`/tx/v1/sub-account/${encodeURIComponent(handle)}/smtp-password/${encodeURIComponent(id)}`, { onResponseError: async ({ response }) => {
 			error = getStatusError(response, { [400]: "Missing or invalid SMTP password ID." });
 		} }).catch((e) => {
 			error ||= getResultError(e, "Failed to delete sub-account SMTP password.");
@@ -1312,16 +1224,22 @@ var SubAccounts = class SubAccounts {
 			error
 		};
 	}
-	async getLimit(handle) {
+};
+var SubAccountsLimits = class {
+	mailchannels;
+	constructor(mailchannels) {
+		this.mailchannels = mailchannels;
+	}
+	async get(handle) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				data: null,
 				error
 			};
 		}
-		const response = await this.mailchannels.get(`/tx/v1/sub-account/${handle}/limit`, { onResponseError: async ({ response }) => {
+		const response = await this.mailchannels.get(`/tx/v1/sub-account/${encodeURIComponent(handle)}/limit`, { onResponseError: async ({ response }) => {
 			error = getStatusError(response, { [404]: `Sub-account with handle '${handle}' not found.` });
 		} }).catch((e) => {
 			error ||= getResultError(e, "Failed to fetch sub-account limit.");
@@ -1336,24 +1254,24 @@ var SubAccounts = class SubAccounts {
 			error: null
 		};
 	}
-	async setLimit(handle, limit) {
+	async set(handle, options) {
 		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.");
+		if (options.sends < 0) {
+			error = createValidationError("The sends value must be at least 0.");
 			return {
 				success: false,
 				error
 			};
 		}
-		await this.mailchannels.put(`/tx/v1/sub-account/${handle}/limit`, {
-			body: limit,
+		await this.mailchannels.put(`/tx/v1/sub-account/${encodeURIComponent(handle)}/limit`, {
+			body: options,
 			onResponseError: async ({ response }) => {
 				error = getStatusError(response, {
 					[400]: "Bad Request.",
@@ -1368,16 +1286,16 @@ var SubAccounts = class SubAccounts {
 			error
 		};
 	}
-	async deleteLimit(handle) {
+	async delete(handle) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				success: false,
 				error
 			};
 		}
-		await this.mailchannels.delete(`/tx/v1/sub-account/${handle}/limit`, { onResponseError: async ({ response }) => {
+		await this.mailchannels.delete(`/tx/v1/sub-account/${encodeURIComponent(handle)}/limit`, { onResponseError: async ({ response }) => {
 			error = getStatusError(response, { [404]: `Sub-account with handle '${handle}' not found.` });
 		} }).catch((e) => {
 			error ||= getResultError(e, "Failed to delete sub-account limit.");
@@ -1387,16 +1305,168 @@ var SubAccounts = class SubAccounts {
 			error
 		};
 	}
+};
+var SubAccounts = class SubAccounts {
+	mailchannels;
+	static COMPANY_PATTERN = /^.{3,128}$/;
+	static HANDLE_PATTERN = /^[a-z0-9]{3,128}$/;
+	apiKeys;
+	smtpPasswords;
+	limits;
+	constructor(mailchannels) {
+		this.mailchannels = mailchannels;
+		this.apiKeys = new SubAccountsApiKeys(mailchannels);
+		this.smtpPasswords = new SubAccountsSmtpPasswords(mailchannels);
+		this.limits = new SubAccountsLimits(mailchannels);
+	}
+	async create(companyName, handle) {
+		let error = null;
+		if (!SubAccounts.COMPANY_PATTERN.test(companyName)) {
+			error = createValidationError("Invalid company name. Company name must be between 3 and 128 characters.");
+			return {
+				data: null,
+				error
+			};
+		}
+		if (handle) {
+			if (!SubAccounts.HANDLE_PATTERN.test(handle)) {
+				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
+				};
+			}
+		}
+		const response = await this.mailchannels.post("/tx/v1/sub-account", {
+			body: {
+				company_name: companyName,
+				handle
+			},
+			onResponseError: async ({ response }) => {
+				error = getStatusError(response, {
+					[403]: "The parent account does not have permission to create sub-accounts.",
+					[409]: `Sub-account with handle '${handle}' already exists.`
+				});
+			}
+		}).catch((e) => {
+			error ||= getResultError(e, "Failed to create sub-account.");
+			return null;
+		});
+		if (!response) return {
+			data: null,
+			error
+		};
+		return {
+			data: clean({
+				companyName: response.company_name,
+				enabled: response.enabled,
+				handle: response.handle
+			}),
+			error: null
+		};
+	}
+	async list(options) {
+		let error = null;
+		error = validatePagination({
+			...options,
+			max: 1e3
+		});
+		if (error) return {
+			data: null,
+			error
+		};
+		const response = await this.mailchannels.get("/tx/v1/sub-account", {
+			query: options,
+			onResponseError: async ({ response }) => {
+				error = getStatusError(response);
+			}
+		}).catch((e) => {
+			error ||= getResultError(e, "Failed to fetch sub-accounts.");
+			return null;
+		});
+		if (!response) return {
+			data: null,
+			error
+		};
+		return {
+			data: clean(response.map((account) => ({
+				companyName: account.company_name,
+				enabled: account.enabled,
+				handle: account.handle
+			}))),
+			error: null
+		};
+	}
+	async delete(handle) {
+		let error = null;
+		if (!handle) {
+			error = createValidationError("No handle provided.");
+			return {
+				success: false,
+				error
+			};
+		}
+		await this.mailchannels.delete(`/tx/v1/sub-account/${encodeURIComponent(handle)}`, { onResponseError: async ({ response }) => {
+			error = getStatusError(response);
+		} }).catch((e) => {
+			error ||= getResultError(e, "Failed to delete sub-account.");
+		});
+		return {
+			success: !error,
+			error
+		};
+	}
+	async suspend(handle) {
+		let error = null;
+		if (!handle) {
+			error = createValidationError("No handle provided.");
+			return {
+				success: false,
+				error
+			};
+		}
+		await this.mailchannels.post(`/tx/v1/sub-account/${encodeURIComponent(handle)}/suspend`, { onResponseError: async ({ response }) => {
+			error = getStatusError(response, { [404]: `The specified sub-account '${handle}' does not exist.` });
+		} }).catch((e) => {
+			error ||= getResultError(e, "Failed to suspend sub-account.");
+		});
+		return {
+			success: !error,
+			error
+		};
+	}
+	async activate(handle) {
+		let error = null;
+		if (!handle) {
+			error = createValidationError("No handle provided.");
+			return {
+				success: false,
+				error
+			};
+		}
+		await this.mailchannels.post(`/tx/v1/sub-account/${encodeURIComponent(handle)}/activate`, { onResponseError: async ({ response }) => {
+			error = getStatusError(response, {
+				[403]: "The parent account does not have permission to activate the sub-account.",
+				[404]: `The specified sub-account '${handle}' does not exist.`
+			});
+		} }).catch((e) => {
+			error ||= getResultError(e, "Failed to activate sub-account.");
+		});
+		return {
+			success: !error,
+			error
+		};
+	}
 	async getUsage(handle) {
 		let error = null;
 		if (!handle) {
-			error = createError("No handle provided.");
+			error = createValidationError("No handle provided.");
 			return {
 				data: null,
 				error
 			};
 		}
-		const response = await this.mailchannels.get(`/tx/v1/sub-account/${handle}/usage`, { onResponseError: async ({ response }) => {
+		const response = await this.mailchannels.get(`/tx/v1/sub-account/${encodeURIComponent(handle)}/usage`, { onResponseError: async ({ response }) => {
 			error = getStatusError(response, { [404]: `Sub-account with handle '${handle}' not found.` });
 		} }).catch((e) => {
 			error ||= getResultError(e, "Failed to fetch sub-account usage.");
@@ -1415,6 +1485,33 @@ var SubAccounts = class SubAccounts {
 			error: null
 		};
 	}
+	createApiKey(...args) {
+		return this.apiKeys.create(...args);
+	}
+	listApiKeys(...args) {
+		return this.apiKeys.list(...args);
+	}
+	deleteApiKey(...args) {
+		return this.apiKeys.delete(...args);
+	}
+	createSmtpPassword(...args) {
+		return this.smtpPasswords.create(...args);
+	}
+	listSmtpPasswords(...args) {
+		return this.smtpPasswords.list(...args);
+	}
+	deleteSmtpPassword(...args) {
+		return this.smtpPasswords.delete(...args);
+	}
+	setLimit(...args) {
+		return this.limits.set(...args);
+	}
+	getLimit(...args) {
+		return this.limits.get(...args);
+	}
+	deleteLimit(...args) {
+		return this.limits.delete(...args);
+	}
 };
 const mapBucket = (bucket) => {
 	return {
@@ -1429,10 +1526,18 @@ var Metrics = class {
 	}
 	async engagement(options) {
 		let error = null;
+		const { dates, error: dateError } = parseDateInputs({
+			startTime: options?.startTime,
+			endTime: options?.endTime
+		});
+		if (!dates || dateError) return {
+			data: null,
+			error: dateError
+		};
 		const response = await this.mailchannels.get("/tx/v1/metrics/engagement", {
 			query: {
-				start_time: options?.startTime,
-				end_time: options?.endTime,
+				start_time: dates.startTime,
+				end_time: dates.endTime,
 				campaign_id: options?.campaignId,
 				interval: options?.interval
 			},
@@ -1467,10 +1572,18 @@ var Metrics = class {
 	}
 	async performance(options) {
 		let error = null;
+		const { dates, error: dateError } = parseDateInputs({
+			startTime: options?.startTime,
+			endTime: options?.endTime
+		});
+		if (!dates || dateError) return {
+			data: null,
+			error: dateError
+		};
 		const response = await this.mailchannels.get("/tx/v1/metrics/performance", {
 			query: {
-				start_time: options?.startTime,
-				end_time: options?.endTime,
+				start_time: dates.startTime,
+				end_time: dates.endTime,
 				campaign_id: options?.campaignId,
 				interval: options?.interval
 			},
@@ -1503,10 +1616,18 @@ var Metrics = class {
 	}
 	async recipientBehaviour(options) {
 		let error = null;
+		const { dates, error: dateError } = parseDateInputs({
+			startTime: options?.startTime,
+			endTime: options?.endTime
+		});
+		if (!dates || dateError) return {
+			data: null,
+			error: dateError
+		};
 		const response = await this.mailchannels.get("/tx/v1/metrics/recipient-behaviour", {
 			query: {
-				start_time: options?.startTime,
-				end_time: options?.endTime,
+				start_time: dates.startTime,
+				end_time: dates.endTime,
 				campaign_id: options?.campaignId,
 				interval: options?.interval
 			},
@@ -1537,10 +1658,18 @@ var Metrics = class {
 	}
 	async volume(options) {
 		let error = null;
+		const { dates, error: dateError } = parseDateInputs({
+			startTime: options?.startTime,
+			endTime: options?.endTime
+		});
+		if (!dates || dateError) return {
+			data: null,
+			error: dateError
+		};
 		const response = await this.mailchannels.get("/tx/v1/metrics/volume", {
 			query: {
-				start_time: options?.startTime,
-				end_time: options?.endTime,
+				start_time: dates.startTime,
+				end_time: dates.endTime,
 				campaign_id: options?.campaignId,
 				interval: options?.interval
 			},
@@ -1594,6 +1723,14 @@ var Metrics = class {
 	}
 	async senders(type, options) {
 		let error = null;
+		const { dates, error: dateError } = parseDateInputs({
+			startTime: options?.startTime,
+			endTime: options?.endTime
+		});
+		if (!dates || dateError) return {
+			data: null,
+			error: dateError
+		};
 		error = validatePagination({
 			...options,
 			max: 1e3
@@ -1602,10 +1739,10 @@ var Metrics = class {
 			data: null,
 			error
 		};
-		const response = await this.mailchannels.get(`/tx/v1/metrics/senders/${type}`, {
+		const response = await this.mailchannels.get(`/tx/v1/metrics/senders/${encodeURIComponent(type)}`, {
 			query: {
-				start_time: options?.startTime,
-				end_time: options?.endTime,
+				start_time: dates.startTime,
+				end_time: dates.endTime,
 				limit: options?.limit,
 				offset: options?.offset,
 				sort_order: options?.sortOrder
@@ -1643,7 +1780,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
@@ -1676,7 +1813,7 @@ var Suppressions = class {
 	}
 	async delete(recipient, source) {
 		let error = null;
-		await this.mailchannels.delete(`/tx/v1/suppression-list/recipients/${recipient}`, {
+		await this.mailchannels.delete(`/tx/v1/suppression-list/recipients/${encodeURIComponent(recipient)}`, {
 			query: { source },
 			onResponseError: async ({ response }) => {
 				error = getStatusError(response, { [400]: "Bad Request." });
@@ -1692,12 +1829,20 @@ 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
 			};
 		}
+		const { dates, error: dateError } = parseDateInputs({
+			createdBefore: options?.createdBefore,
+			createdAfter: options?.createdAfter
+		});
+		if (!dates || dateError) return {
+			data: null,
+			error: dateError
+		};
 		error = validatePagination({
 			...options,
 			max: 1e3
@@ -1709,8 +1854,8 @@ var Suppressions = class {
 		const payload = {
 			recipient: options?.recipient,
 			source: options?.source,
-			created_before: options?.createdBefore,
-			created_after: options?.createdAfter,
+			created_before: dates.createdBefore,
+			created_after: dates.createdAfter,
 			limit: options?.limit,
 			offset: options?.offset
 		};
@@ -1758,41 +1903,12 @@ var Attachment = class Attachment {
 			disposition
 		};
 	}
-	static async fromFile(path, options) {
-		try {
-			const data = await readFile(path);
-			return Attachment.fromBytes(data, {
-				filename: basename(path.toString()),
-				...options
-			});
-		} catch (error) {
-			throw new Error(`Unable to read attachment file: ${path}`, { cause: error });
-		}
-	}
-	static async fromUrl(url, options) {
-		try {
-			let contentType;
-			const data = await $fetch(url, {
-				responseType: "arrayBuffer",
-				timeout: 12e4,
-				onResponse: ({ response }) => {
-					const contentTypeHeader = response.headers.get("content-type");
-					if (contentTypeHeader) contentType = contentTypeHeader.split(";", 1)[0]?.trim();
-				}
-			});
-			return Attachment.fromBytes(data, {
-				type: contentType,
-				filename: basename(new URL(url).pathname),
-				...options
-			});
-		} catch (error) {
-			throw new Error(`Unable to fetch attachment from URL: ${url}`, { cause: error });
-		}
-	}
-	static inlineFile(path, options) {
-		return Attachment.fromFile(path, {
-			...options,
-			disposition: "inline"
+	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
 		});
 	}
 };