mailchannels-sdk 1.0.0 → 1.1.0

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.0.0";
+var version = "1.1.0";
 var MailChannelsClient = class MailChannelsClient {
 	static DEFAULT_BASE_URL = "https://api.mailchannels.net";
 	static DEFAULT_TIMEOUT = 12e4;
@@ -160,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",
@@ -424,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 = 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
-		};
-	}
-};
 var DomainsDkim = class {
 	mailchannels;
 	constructor(mailchannels) {
@@ -524,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, {
@@ -576,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." });
@@ -611,7 +537,7 @@ var DomainsDkim = class {
 			};
 		}
 		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, {
@@ -651,7 +577,7 @@ var DomainsDkim = class {
 			};
 		}
 		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, {
@@ -677,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"
@@ -749,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) {
@@ -936,17 +965,17 @@ var Webhooks = class Webhooks {
 			data: null,
 			error: createValidationError("Status filters must be unique.")
 		};
-		if (options?.createdAfter && Number.isNaN(Date.parse(options.createdAfter))) return {
-			data: null,
-			error: createValidationError("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: createValidationError("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,
@@ -959,8 +988,8 @@ var Webhooks = class Webhooks {
 		}
 		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,
@@ -993,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.`
@@ -1020,152 +1049,12 @@ 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 = 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/${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/${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/${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) {
+	async create(handle) {
 		let error = null;
 		if (!handle) {
 			error = createValidationError("No handle provided.");
@@ -1174,7 +1063,7 @@ var SubAccounts = class SubAccounts {
 				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.`,
@@ -1193,7 +1082,7 @@ var SubAccounts = class SubAccounts {
 			error: null
 		};
 	}
-	async listApiKeys(handle, options) {
+	async list(handle, options) {
 		let error = null;
 		if (!handle) {
 			error = createValidationError("No handle provided.");
@@ -1210,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;
 		});
@@ -1228,7 +1120,7 @@ var SubAccounts = class SubAccounts {
 			error: null
 		};
 	}
-	async deleteApiKey(handle, id) {
+	async delete(handle, id) {
 		let error = null;
 		if (!handle) {
 			error = createValidationError("No handle provided.");
@@ -1237,7 +1129,7 @@ var SubAccounts = class SubAccounts {
 				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.");
@@ -1247,7 +1139,13 @@ 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 = createValidationError("No handle provided.");
@@ -1256,7 +1154,7 @@ var SubAccounts = class SubAccounts {
 				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.`,
@@ -1279,7 +1177,7 @@ var SubAccounts = class SubAccounts {
 			error: null
 		};
 	}
-	async listSmtpPasswords(handle) {
+	async list(handle) {
 		let error = null;
 		if (!handle) {
 			error = createValidationError("No handle provided.");
@@ -1288,7 +1186,7 @@ var SubAccounts = class SubAccounts {
 				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.");
@@ -1307,7 +1205,7 @@ var SubAccounts = class SubAccounts {
 			error: null
 		};
 	}
-	async deleteSmtpPassword(handle, id) {
+	async delete(handle, id) {
 		let error = null;
 		if (!handle) {
 			error = createValidationError("No handle provided.");
@@ -1316,7 +1214,7 @@ var SubAccounts = class SubAccounts {
 				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.");
@@ -1326,7 +1224,13 @@ 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 = createValidationError("No handle provided.");
@@ -1335,7 +1239,7 @@ var SubAccounts = class SubAccounts {
 				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.");
@@ -1350,7 +1254,7 @@ var SubAccounts = class SubAccounts {
 			error: null
 		};
 	}
-	async setLimit(handle, limit) {
+	async set(handle, options) {
 		let error = null;
 		if (!handle) {
 			error = createValidationError("No handle provided.");
@@ -1359,15 +1263,15 @@ var SubAccounts = class SubAccounts {
 				error
 			};
 		}
-		if (limit.sends < 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.",
@@ -1382,7 +1286,7 @@ var SubAccounts = class SubAccounts {
 			error
 		};
 	}
-	async deleteLimit(handle) {
+	async delete(handle) {
 		let error = null;
 		if (!handle) {
 			error = createValidationError("No handle provided.");
@@ -1391,7 +1295,7 @@ var SubAccounts = class SubAccounts {
 				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.");
@@ -1401,6 +1305,158 @@ 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) {
@@ -1410,7 +1466,7 @@ var SubAccounts = class SubAccounts {
 				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.");
@@ -1429,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 {
@@ -1443,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
 			},
@@ -1481,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
 			},
@@ -1517,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
 			},
@@ -1551,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
 			},
@@ -1608,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
@@ -1616,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
@@ -1690,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." });
@@ -1712,6 +1835,14 @@ var Suppressions = class {
 				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
@@ -1723,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
 		};