mailery 0.10.2 → 0.12.0

package/dist/{null-CU_EApC6.d.cts → null-CfzvqNEp.d.cts}

@@ -236,7 +236,8 @@ interface SendArgs {
     fromEmail: string;
     replyTo?: string;
     subject: string;
-    html: string;
+    /** Omitted for `text_only` templates — send the text part alone. */
+    html?: string;
     text: string;
     headers?: Record<string, string>;
     messageMeta?: Record<string, string>;
@@ -418,6 +419,19 @@ type QueueDriverConfig = {
 type SubscriptionStatus = 'subscribed' | 'pending_doi' | 'unsubscribed' | 'bounced' | 'complained';
 type SendStatus = 'queued' | 'sending' | 'sent' | 'delivered' | 'bounced' | 'complained' | 'failed' | 'suppressed' | 'cancelled';
 type TemplateKind = 'transactional' | 'marketing';
+/**
+ * How a template's body goes on the wire.
+ *
+ *   multipart — HTML + plain-text alternative (the default, and what almost
+ *               every template wants).
+ *   text_only — plain text alone, no HTML part at all. For mail that should
+ *               read as if it were typed by a person. Open tracking is
+ *               impossible without an HTML part to carry the pixel, and click
+ *               tracking is skipped too (rewriting bare URLs in text produces
+ *               the opaque redirect links this format exists to avoid), so a
+ *               text_only send reports no opens and no clicks — by design.
+ */
+type TemplateBodyFormat = 'multipart' | 'text_only';
 type SuppressionScope = 'all' | 'marketing' | 'transactional';
 type SuppressionReason = 'unsubscribed' | 'hard_bounce' | 'complaint' | 'manual' | 'list_cleaning' | 'gdpr_forget';
 type FlowRunStatus = 'active' | 'completed' | 'exited' | 'failed';
@@ -928,6 +942,8 @@ interface TemplateDoc {
     }>;
     draft: TemplateDraft | null;
     tags: string[];
+    /** Wire format for the body. Absent on documents written before 0.11. */
+    bodyFormat?: TemplateBodyFormat;
     trackOpens: boolean;
     trackClicks: boolean;
     stats: {

package/dist/{null-CU_EApC6.d.ts → null-CfzvqNEp.d.ts}

@@ -236,7 +236,8 @@ interface SendArgs {
     fromEmail: string;
     replyTo?: string;
     subject: string;
-    html: string;
+    /** Omitted for `text_only` templates — send the text part alone. */
+    html?: string;
     text: string;
     headers?: Record<string, string>;
     messageMeta?: Record<string, string>;
@@ -418,6 +419,19 @@ type QueueDriverConfig = {
 type SubscriptionStatus = 'subscribed' | 'pending_doi' | 'unsubscribed' | 'bounced' | 'complained';
 type SendStatus = 'queued' | 'sending' | 'sent' | 'delivered' | 'bounced' | 'complained' | 'failed' | 'suppressed' | 'cancelled';
 type TemplateKind = 'transactional' | 'marketing';
+/**
+ * How a template's body goes on the wire.
+ *
+ *   multipart — HTML + plain-text alternative (the default, and what almost
+ *               every template wants).
+ *   text_only — plain text alone, no HTML part at all. For mail that should
+ *               read as if it were typed by a person. Open tracking is
+ *               impossible without an HTML part to carry the pixel, and click
+ *               tracking is skipped too (rewriting bare URLs in text produces
+ *               the opaque redirect links this format exists to avoid), so a
+ *               text_only send reports no opens and no clicks — by design.
+ */
+type TemplateBodyFormat = 'multipart' | 'text_only';
 type SuppressionScope = 'all' | 'marketing' | 'transactional';
 type SuppressionReason = 'unsubscribed' | 'hard_bounce' | 'complaint' | 'manual' | 'list_cleaning' | 'gdpr_forget';
 type FlowRunStatus = 'active' | 'completed' | 'exited' | 'failed';
@@ -928,6 +942,8 @@ interface TemplateDoc {
     }>;
     draft: TemplateDraft | null;
     tags: string[];
+    /** Wire format for the body. Absent on documents written before 0.11. */
+    bodyFormat?: TemplateBodyFormat;
     trackOpens: boolean;
     trackClicks: boolean;
     stats: {

package/dist/testing.cjs

@@ -336,7 +336,10 @@ var init_sendgrid = __esm({
           replyTo: args.replyTo,
           subject: args.subject,
           text: args.text,
-          html: args.html,
+          // Omit the key entirely rather than sending `html: undefined` — a
+          // text_only template must produce a single-part text/plain message, and
+          // an explicit undefined can still serialize into an empty HTML part.
+          ...args.html ? { html: args.html } : {},
           headers: args.headers,
           customArgs: args.messageMeta,
           trackingSettings: {
@@ -15856,7 +15859,8 @@ async function dispatchSend(sendId, ctx) {
     await markFailed(send._id, `render error: ${String(err?.message ?? err)}`, ctx);
     throw err;
   }
-  const tracking = applyTracking(rendered.html, {
+  const textOnly = template.bodyFormat === "text_only";
+  const tracking = textOnly ? { html: "", links: [] } : applyTracking(rendered.html, {
     sendId: String(send._id),
     publicUrl: ctx.config.publicUrl,
     trackOpens: template.trackOpens ?? ctx.config.trackOpens,
@@ -15868,7 +15872,9 @@ async function dispatchSend(sendId, ctx) {
     {
       $set: {
         links: tracking.links,
-        bodyHash: sha256(tracking.html),
+        // Hash what actually goes out, so a text_only send's fingerprint
+        // tracks the text body rather than an HTML part it never had.
+        bodyHash: sha256(textOnly ? rendered.plainText : tracking.html),
         status: "sending",
         fromName: rendered.fromName,
         fromEmail: rendered.fromEmail,
@@ -15893,7 +15899,7 @@ async function dispatchSend(sendId, ctx) {
       fromEmail: rendered.fromEmail,
       replyTo: rendered.replyTo ?? void 0,
       subject: rendered.subject,
-      html: tracking.html,
+      ...textOnly ? {} : { html: tracking.html },
       text: rendered.plainText,
       headers,
       messageMeta: { sendId: String(send._id) }
@@ -18131,6 +18137,7 @@ async function buildTemplate(spec) {
     variablesSchema: spec.variablesSchema ?? {},
     draft: null,
     tags: spec.tags ?? [],
+    bodyFormat: spec.bodyFormat ?? "multipart",
     trackOpens: spec.trackOpens ?? false,
     trackClicks: spec.trackClicks ?? false,
     stats: {