mailchannels-sdk 1.3.0 → 1.4.0

package/dist/_chunks/simulator.mjs

@@ -313,8 +313,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, {
@@ -627,7 +627,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;
 			}
@@ -646,7 +646,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;
 			}
@@ -659,7 +659,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
 				});
@@ -678,7 +678,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;
 			}
@@ -718,7 +718,7 @@ 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;
@@ -796,6 +796,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) => {
@@ -819,6 +823,7 @@ const createSimulator = (options = {}) => {
 		},
 		async close() {
 			await new Promise((resolve, reject) => {
+				console.info("[Simulator] Shutting down simulator...");
 				for (const socket of sockets) socket.destroy();
 				server.close((error) => error ? reject(error) : resolve());
 			});
@@ -835,10 +840,13 @@ const createSimulator = (options = {}) => {
 					server.off("error", onError);
 					resolve();
 				});
+			}).catch((error) => {
+				console.error(`[Simulator] ${error.message}`);
+				process.exit(1);
 			});
 			const address = server.address();
 			serverUrl = `http://${nextHost}:${typeof address === "object" && address ? address.port : nextPort}`;
-			if (logRequests) console.info("[Simulator]", `listening on ${serverUrl}`);
+			if (logRequests) console.info(`[Simulator] listening on ${serverUrl}`);
 			return serverUrl;
 		}
 	};

package/dist/cli/index.mjs

@@ -0,0 +1,268 @@
+#!/usr/bin/env node
+import { Attachment, Emails, MailChannelsClient, name, version } from "../_chunks/mailchannels.mjs";
+import { createSimulator } from "../_chunks/simulator.mjs";
+import { defineCommand, runMain } from "citty";
+var simulate_default = defineCommand({
+	meta: {
+		name: "simulate",
+		description: "Start a local MailChannels simulator server"
+	},
+	args: {
+		port: {
+			type: "string",
+			alias: "p"
+		},
+		host: {
+			type: "string",
+			alias: "h"
+		},
+		silent: {
+			type: "boolean",
+			alias: "s",
+			default: false
+		}
+	},
+	async run({ args }) {
+		const { MAILCHANNELS_SIMULATOR_HOST, MAILCHANNELS_SIMULATOR_PORT } = process.env;
+		const host = args.host || MAILCHANNELS_SIMULATOR_HOST;
+		const port = args.port || MAILCHANNELS_SIMULATOR_PORT;
+		const simulator = createSimulator({
+			host,
+			port: port !== void 0 ? Number.parseInt(port, 10) : void 0,
+			silent: args.silent
+		});
+		await simulator.listen();
+		const shutdown = async () => {
+			await simulator.close();
+		};
+		process.on("SIGINT", shutdown);
+		process.on("SIGTERM", shutdown);
+	}
+});
+const emailArgs = {
+	"api-key": {
+		type: "string",
+		alias: "k"
+	},
+	"campaign-id": { type: "string" },
+	"dkim-domain": { type: "string" },
+	"dkim-selector": { type: "string" },
+	"dkim-private-key": { type: "string" },
+	"envelope-from": { type: "string" },
+	"tracking-click": {
+		type: "boolean",
+		default: false
+	},
+	"tracking-click-custom-domain-name": {
+		type: "string",
+		valueHint: "name"
+	},
+	"tracking-open": {
+		type: "boolean",
+		default: false
+	},
+	"tracking-open-custom-domain-name": {
+		type: "string",
+		valueHint: "name"
+	},
+	"from": {
+		type: "string",
+		required: true
+	},
+	"headers": {
+		type: "string",
+		alias: "h",
+		valueHint: "JSON"
+	},
+	"to": {
+		type: "string",
+		required: true
+	},
+	"subject": {
+		type: "string",
+		required: true
+	},
+	"text": {
+		type: "string",
+		default: ""
+	},
+	"html": {
+		type: "string",
+		default: ""
+	},
+	"cc": { type: "string" },
+	"bcc": { type: "string" },
+	"reply-to": { type: "string" },
+	"attachments": {
+		type: "boolean",
+		alias: "a",
+		default: false
+	},
+	"transactional": {
+		type: "boolean",
+		default: true
+	},
+	"unsubscribe-custom-domain-name": {
+		type: "string",
+		valueHint: "name"
+	}
+};
+const getApiKey = (apiKey) => {
+	const { MAILCHANNELS_API_KEY } = process.env;
+	const key = MAILCHANNELS_API_KEY || apiKey;
+	if (!key) {
+		console.error("[Emails] Missing API key. Provide it using the '--api-key' flag or set the 'MAILCHANNELS_API_KEY' environment variable.");
+		process.exit(1);
+	}
+	return key;
+};
+const parseAttachments = async (rawAttachments) => {
+	if (!rawAttachments) return;
+	if (process.stdin.isTTY) {
+		console.error("[Emails] '--attachments' requires JSON input piped to stdin.");
+		process.exit(1);
+	}
+	let input = "";
+	for await (const chunk of process.stdin) input += chunk;
+	let inputAttachments = [];
+	try {
+		inputAttachments = JSON.parse(input);
+	} catch {
+		console.error("[Emails] JSON input for '--attachments' is not valid.");
+		process.exit(1);
+	}
+	return inputAttachments.map((attachment, index) => {
+		if (!attachment.content || !attachment.filename) {
+			console.error("[Emails] Attachment at index " + index + " is missing required fields 'content' or 'filename'.");
+			process.exit(1);
+		}
+		if (attachment.type) return {
+			content: attachment.content,
+			filename: attachment.filename,
+			type: attachment.type,
+			contentId: attachment.content_id
+		};
+		return Attachment.fromBytes(Buffer.from(attachment.content, "base64"), {
+			filename: attachment.filename,
+			type: attachment.type,
+			contentId: attachment.content_id
+		});
+	});
+};
+const parseHeaders = (rawHeaders) => {
+	if (!rawHeaders) return;
+	try {
+		return JSON.parse(rawHeaders);
+	} catch {
+		console.error("[Emails] Invalid JSON for '--headers'");
+		process.exit(1);
+	}
+};
+const parseOptions = async (args) => {
+	const attachments = await parseAttachments(args["attachments"]);
+	const headers = parseHeaders(args["headers"]);
+	return {
+		attachments,
+		campaignId: args["campaign-id"],
+		dkim: {
+			domain: args["dkim-domain"],
+			selector: args["dkim-selector"],
+			privateKey: args["dkim-private-key"]
+		},
+		envelopeFrom: args["envelope-from"],
+		tracking: {
+			click: {
+				customDomainName: args["tracking-click-custom-domain-name"],
+				enable: args["tracking-click"] || Boolean(args["tracking-click-custom-domain-name"])
+			},
+			open: {
+				customDomainName: args["tracking-open-custom-domain-name"],
+				enable: args["tracking-open"] || Boolean(args["tracking-open-custom-domain-name"])
+			}
+		},
+		headers,
+		from: args["from"],
+		to: args["to"].split(",").map((r) => r.trim()),
+		subject: args["subject"],
+		cc: args["cc"]?.split(",").map((r) => r.trim()),
+		bcc: args["bcc"]?.split(",").map((r) => r.trim()),
+		replyTo: args["reply-to"],
+		html: args["html"],
+		text: args["text"],
+		transactional: args["transactional"],
+		unsubscribe: { customDomainName: args["unsubscribe-custom-domain-name"] }
+	};
+};
+var send_default = defineCommand({
+	meta: {
+		name: "send",
+		description: "Send an email using the MailChannels Email API"
+	},
+	args: {
+		...emailArgs,
+		"dry-run": {
+			type: "boolean",
+			default: false
+		}
+	},
+	async run({ args }) {
+		const apiKey = getApiKey(args["api-key"]);
+		const client = new MailChannelsClient(apiKey);
+		const emails = new Emails(client);
+		const sendOptions = await parseOptions(args);
+		const { error } = await emails.send(sendOptions, args["dry-run"]);
+		if (error) {
+			console.error(`[Emails] ${error.message}`);
+			process.exit(1);
+		}
+		console.info("[Emails] Email sent successfully.");
+	}
+});
+var queue_default = defineCommand({
+	meta: {
+		name: "queue",
+		description: "Queue an email to be sent using the MailChannels Email API"
+	},
+	args: emailArgs,
+	async run({ args }) {
+		const apiKey = getApiKey(args["api-key"]);
+		const client = new MailChannelsClient(apiKey);
+		const emails = new Emails(client);
+		const sendOptions = await parseOptions(args);
+		const { error } = await emails.queue(sendOptions);
+		if (error) {
+			console.error(`[Emails] ${error.message}`);
+			process.exit(1);
+		}
+		console.info("[Emails] Email queued successfully.");
+	}
+});
+var emails_default = defineCommand({
+	meta: {
+		name: "emails",
+		description: "Commands for sending emails using the MailChannels Email API"
+	},
+	args: {},
+	subCommands: {
+		send: send_default,
+		queue: queue_default
+	}
+});
+const main = defineCommand({
+	meta: {
+		name,
+		description: "MailChannels CLI",
+		version
+	},
+	subCommands: {
+		simulate: simulate_default,
+		emails: emails_default
+	},
+	setup() {
+		const LOGGER_NAME = "[MailChannels-CLI]";
+		console.info = console.info.bind(console, LOGGER_NAME);
+		console.error = console.error.bind(console, LOGGER_NAME);
+	}
+});
+runMain(main);
+export {};