mailchannels-sdk 0.7.1 → 0.7.2

package/dist/mailchannels.d.mts

@@ -54,7 +54,7 @@ interface EmailsSendRecipient {
    */
   email: string;
   /**
-   * The name of the recipient.
+   * The name of the recipient. Display name in raw text, e.g. John Doe, 张三.
    */
   name?: string;
 }
@@ -147,6 +147,16 @@ interface EmailsSendOptionsBase {
      */
     selector: string;
   };
+  /**
+   * Optional envelope sender address. If not set, the envelope sender defaults to the `from.email` field. Can be overridden per-personalization. Only the email portion is used; the name field is ignored.
+   * @example
+   * { email: 'email@example.com', name: 'Example' }
+   * @example
+   * 'email@example.com'
+   * @example
+   * 'Name <email@example.com>'
+   */
+  envelopeFrom?: EmailsSendRecipient | string;
   /**
    * The sender of the email. Can be a string or an object with email and name properties.
    * @example
@@ -185,6 +195,11 @@ interface EmailsSendOptionsBase {
   to: EmailsSendRecipient[] | EmailsSendRecipient | string[] | string;
   /**
    * Adjust open and click tracking for the message. Please note that enabling tracking for your messages requires a subscription that supports open and click tracking.
+   *
+   * Only links (`<a>` tags) meeting all of the following conditions are processed for click tracking:
+   * - The URL is non-empty.
+   * - The URL starts with `http` or `https`.
+   * - The link does not have a `clicktracking` attribute set to `off`.
    */
   tracking?: EmailsSendTracking;
   /**

package/dist/mailchannels.d.ts

@@ -54,7 +54,7 @@ interface EmailsSendRecipient {
    */
   email: string;
   /**
-   * The name of the recipient.
+   * The name of the recipient. Display name in raw text, e.g. John Doe, 张三.
    */
   name?: string;
 }
@@ -147,6 +147,16 @@ interface EmailsSendOptionsBase {
      */
     selector: string;
   };
+  /**
+   * Optional envelope sender address. If not set, the envelope sender defaults to the `from.email` field. Can be overridden per-personalization. Only the email portion is used; the name field is ignored.
+   * @example
+   * { email: 'email@example.com', name: 'Example' }
+   * @example
+   * 'email@example.com'
+   * @example
+   * 'Name <email@example.com>'
+   */
+  envelopeFrom?: EmailsSendRecipient | string;
   /**
    * The sender of the email. Can be a string or an object with email and name properties.
    * @example
@@ -185,6 +195,11 @@ interface EmailsSendOptionsBase {
   to: EmailsSendRecipient[] | EmailsSendRecipient | string[] | string;
   /**
    * Adjust open and click tracking for the message. Please note that enabling tracking for your messages requires a subscription that supports open and click tracking.
+   *
+   * Only links (`<a>` tags) meeting all of the following conditions are processed for click tracking:
+   * - The URL is non-empty.
+   * - The URL starts with `http` or `https`.
+   * - The link does not have a `clicktracking` attribute set to `off`.
    */
   tracking?: EmailsSendTracking;
   /**

package/dist/mailchannels.mjs

@@ -183,6 +183,7 @@ class Emails {
       }],
       headers: options.headers,
       reply_to: parseRecipient(options.replyTo),
+      envelope_from: parseRecipient(options.envelopeFrom),
       from: parsedFrom,
       subject: options.subject,
       content,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mailchannels-sdk",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "Node.js SDK to integrate MailChannels API into your JavaScript or TypeScript server-side applications.",
   "type": "module",
   "license": "MIT",
@@ -38,12 +38,12 @@
   },
   "devDependencies": {
     "@eslint/compat": "^2.0.1",
-    "@stylistic/eslint-plugin": "^5.7.0",
+    "@stylistic/eslint-plugin": "^5.7.1",
     "@types/markdown-it": "^14.1.2",
-    "@types/node": "^25.0.9",
-    "@typescript-eslint/eslint-plugin": "^8.53.1",
-    "@typescript-eslint/parser": "^8.53.1",
-    "@vitest/coverage-v8": "^4.0.17",
+    "@types/node": "^25.0.10",
+    "@typescript-eslint/eslint-plugin": "^8.54.0",
+    "@typescript-eslint/parser": "^8.54.0",
+    "@vitest/coverage-v8": "^4.0.18",
     "changelogen": "^0.6.2",
     "eslint": "^9.39.2",
     "eslint-plugin-import-x": "^4.16.1",
@@ -54,7 +54,7 @@
     "vitepress": "^v2.0.0-alpha.15",
     "vitepress-plugin-group-icons": "^1.7.1",
     "vitepress-plugin-llms": "^1.10.0",
-    "vitest": "^4.0.17"
+    "vitest": "^4.0.18"
   },
   "scripts": {
     "build": "unbuild",