mailchannels-sdk 1.3.1 → 1.4.0

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

@@ -1,5 +1,4 @@
 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" };
@@ -798,7 +797,7 @@ 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.`);
+		console.error(`[Simulator] Invalid port '${port}': must be an integer between 0 and 65535.`);
 		process.exit(1);
 	}
 	const logRequests = !options.silent;
@@ -824,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());
 			});
@@ -840,47 +840,15 @@ 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;
 		}
 	};
 };
-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 };
+export { createSimulator };

package/dist/cli/index.mjs

@@ -1,15 +1,268 @@
 #!/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);
-}
+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 {};