mailchannels-sdk 1.3.0 → 1.3.1

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

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

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

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

package/README.md

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

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

@@ -1,4 +1,5 @@
 import { randomBytes, randomUUID } from "node:crypto";
+import { parseArgs } from "node:util";
 import { createServer } from "node:http";
 const SIMULATOR_SIGNING_KEY_ID = "simulator-default";
 const JSON_HEADERS = { "content-type": "application/json" };
@@ -313,8 +314,8 @@ const createEmailApiHandler = ({ logRequests = true } = {}) => {
 				}
 				targetKey.status = "rotated";
 				targetKey.status_modified_at = currentTimestamp();
-				targetKey.gracePeriodExpiresAt = new Date(Date.now() + 10080 * 60 * 1e3).toISOString();
-				targetKey.retiresAt = new Date(Date.now() + 720 * 60 * 60 * 1e3).toISOString();
+				targetKey.gracePeriodExpiresAt = new Date(Date.now() + 6048e5).toISOString();
+				targetKey.retiresAt = new Date(Date.now() + 2592e6).toISOString();
 				const newKey = createDkimKey(domain, body?.new_key?.selector || createId("selector"));
 				account.dkimKeysByDomain.set(domain, [...keys, newKey]);
 				sendJson(response, 201, {
@@ -627,7 +628,7 @@ const createEmailApiHandler = ({ logRequests = true } = {}) => {
 					end_time: url.searchParams.get("end_time") || currentTimestamp(),
 					open: summary.open,
 					open_tracking_delivered: summary.openTrackingDelivered,
-					start_time: url.searchParams.get("start_time") || (/* @__PURE__ */ new Date(Date.now() - 720 * 60 * 60 * 1e3)).toISOString()
+					start_time: url.searchParams.get("start_time") || (/* @__PURE__ */ new Date(Date.now() - 2592e6)).toISOString()
 				});
 				return;
 			}
@@ -646,7 +647,7 @@ const createEmailApiHandler = ({ logRequests = true } = {}) => {
 					delivered: summary.delivered,
 					end_time: url.searchParams.get("end_time") || currentTimestamp(),
 					processed: summary.processed,
-					start_time: url.searchParams.get("start_time") || (/* @__PURE__ */ new Date(Date.now() - 720 * 60 * 60 * 1e3)).toISOString()
+					start_time: url.searchParams.get("start_time") || (/* @__PURE__ */ new Date(Date.now() - 2592e6)).toISOString()
 				});
 				return;
 			}
@@ -659,7 +660,7 @@ const createEmailApiHandler = ({ logRequests = true } = {}) => {
 						unsubscribed: createMetricsBuckets(summary.unsubscribed)
 					},
 					end_time: url.searchParams.get("end_time") || currentTimestamp(),
-					start_time: url.searchParams.get("start_time") || (/* @__PURE__ */ new Date(Date.now() - 720 * 60 * 60 * 1e3)).toISOString(),
+					start_time: url.searchParams.get("start_time") || (/* @__PURE__ */ new Date(Date.now() - 2592e6)).toISOString(),
 					unsubscribe_delivered: summary.unsubscribeDelivered,
 					unsubscribed: summary.unsubscribed
 				});
@@ -678,7 +679,7 @@ const createEmailApiHandler = ({ logRequests = true } = {}) => {
 					dropped: summary.dropped,
 					end_time: url.searchParams.get("end_time") || currentTimestamp(),
 					processed: summary.processed,
-					start_time: url.searchParams.get("start_time") || (/* @__PURE__ */ new Date(Date.now() - 720 * 60 * 60 * 1e3)).toISOString()
+					start_time: url.searchParams.get("start_time") || (/* @__PURE__ */ new Date(Date.now() - 2592e6)).toISOString()
 				});
 				return;
 			}
@@ -718,7 +719,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 +797,10 @@ const DEFAULT_HOST = "127.0.0.1";
 const DEFAULT_PORT = 8787;
 const createSimulator = (options = {}) => {
 	const { host = DEFAULT_HOST, port = DEFAULT_PORT } = options;
+	if (port !== void 0 && (isNaN(port) || port < 0 || port > 65535)) {
+		console.error("[Simulator]", `Invalid port '${port}': must be an integer between 0 and 65535.`);
+		process.exit(1);
+	}
 	const logRequests = !options.silent;
 	const emailApi = createEmailApiHandler({ logRequests });
 	const server = createServer(async (request, response) => {
@@ -843,4 +848,39 @@ const createSimulator = (options = {}) => {
 		}
 	};
 };
-export { createSimulator };
+var simulate_default = async (args) => {
+	const { MAILCHANNELS_SIMULATOR_PORT, MAILCHANNELS_SIMULATOR_HOST } = process.env;
+	const { values } = parseArgs({
+		args,
+		options: {
+			port: {
+				type: "string",
+				short: "p",
+				default: MAILCHANNELS_SIMULATOR_PORT
+			},
+			host: {
+				type: "string",
+				short: "h",
+				default: MAILCHANNELS_SIMULATOR_HOST
+			},
+			silent: {
+				type: "boolean",
+				short: "s",
+				default: false
+			}
+		}
+	});
+	const simulator = createSimulator({
+		host: values.host,
+		port: values.port !== void 0 ? Number.parseInt(values.port, 10) : void 0,
+		silent: values.silent
+	});
+	await simulator.listen();
+	const shutdown = async () => {
+		await simulator.close();
+		process.exit(0);
+	};
+	process.on("SIGINT", shutdown);
+	process.on("SIGTERM", shutdown);
+};
+export { simulate_default as default };

package/dist/cli/index.d.mts

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

package/dist/cli/index.mjs

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

package/dist/mailchannels.d.mts

@@ -121,13 +121,11 @@ interface EmailsSendAttachment {
    */
   type?: string;
   /**
-   * The `Content-ID` header value for inline attachments, referenced from HTML with `cid:`.
+   * A unique identifier for this attachment.
+   *
+   * When set, the attachment is embedded inline in the message body (`Content-Disposition: inline`) instead of offered as a downloadable attachment, and can be referenced from HTML content via a `cid:` URI, e.g. `<img src="cid:logo123">` refers to an attachment with content_id: `logo123`. (RFC 2392). Must be unique across all attachments in the request. Max length is 255 characters.
    */
   contentId?: string;
-  /**
-   * The `Content-Disposition` header value for the attachment.
-   */
-  disposition?: "attachment" | "inline";
 }
 interface EmailsSendTracking {
   /**
@@ -193,7 +191,7 @@ interface EmailsSendContent {
    */
   value: string;
 }
-type EmailsSendRecipientInput = EmailsSendRecipient[] | EmailsSendRecipient | string[] | string;
+type EmailsSendRecipientInput = EmailsSendRecipient | string | (EmailsSendRecipient | string)[];
 interface EmailsSendDkim {
   /**
    * Domain used for DKIM signing.
@@ -1893,7 +1891,7 @@ declare class SubAccounts {
   readonly limits: SubAccountsLimits;
   constructor(mailchannels: MailChannelsClient);
   /**
-   * Creates a new sub-account under the parent account. Each sub-account must have a unique handle composed solely of lowercase alphanumeric characters. If no handle is provided, a random handle will be generated. Note that Sub-accounts are only available to parent accounts on 100K and higher plans.
+   * Creates a new sub-account under the parent account. Each sub-account must have a unique handle composed solely of lowercase alphanumeric characters. If no handle is provided, a random handle will be generated.
    * @param companyName - The name of the company associated with the sub-account. This name is used for display purposes only and does not affect the functionality of the sub-account. The length must be between 3 and 128 characters.
    * @param handle - A unique name for the sub-account to be created. The length must be between 3 and 128 characters, and it may contain only lowercase letters and numbers. If not provided, a random handle will be generated.
    * @example

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.3.0";
+var version = "1.3.1";
 var MailChannelsClient = class MailChannelsClient {
 	static DEFAULT_BASE_URL = "https://api.mailchannels.net";
 	static DEFAULT_TIMEOUT = 12e4;
@@ -225,8 +225,7 @@ const mapAttachment = (attachment) => ({
 	content: attachment.content,
 	filename: attachment.filename,
 	type: attachment.type,
-	content_id: attachment.contentId,
-	disposition: attachment.disposition
+	content_id: attachment.contentId
 });
 const mapPersonalization = (personalization, index, rootTemplateData) => {
 	const to = parseArrayRecipients(personalization.to);
@@ -1239,7 +1238,7 @@ var Webhooks = class Webhooks {
 		if (dates.createdAfter && dates.createdBefore) {
 			const createdAfter = Date.parse(dates.createdAfter);
 			const createdBefore = Date.parse(dates.createdBefore);
-			const maxRangeMs = 744 * 60 * 60 * 1e3;
+			const maxRangeMs = 26784e5;
 			if (createdBefore <= createdAfter) return {
 				data: null,
 				error: createValidationError("createdBefore must be later than createdAfter.")
@@ -2170,13 +2169,12 @@ const guessContentType = (filename) => {
 };
 var Attachment = class Attachment {
 	static fromBytes(data, options) {
-		const { filename, type, contentId, disposition = "attachment" } = options;
+		const { filename, type, contentId } = options;
 		return {
 			content: base64Content(data),
 			filename: decodeURIComponent(filename) || "attachment",
 			type: type || guessContentType(filename),
-			contentId,
-			disposition
+			contentId
 		};
 	}
 	static async fromBlob(blob, options) {

package/package.json

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

package/dist/cli.d.mts

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

package/dist/cli.mjs

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