vintasend-liquidjs 1.0.0-alpha7 → 1.0.0-alpha9

package/dist/liquid-email-template-renderer.d.ts

@@ -17,7 +17,10 @@ export type LiquidTemplateRendererOptions = LiquidOptions & {
  *
  * The body is rendered with `outputEscape: 'escape'` unless `options.outputEscape` says otherwise,
  * so context values cannot inject markup into an HTML email; use `{{ value | raw }}` for values
- * that are trusted HTML. The subject is plain text and is never escaped; its whitespace, including
+ * that are trusted HTML. When template content carries a `preheader` (as managed templates do),
+ * it is rendered with the body's escaping and injected as a hidden element at the top of the body,
+ * which is what mail clients show as inbox preview text. The file-based `render` has no preheader.
+ * The subject is plain text and is never escaped; its whitespace, including
  * the trailing newline of a template file, is collapsed to single spaces.
  */
 export declare class LiquidEmailTemplateRenderer<Config extends BaseNotificationTypeConfig> implements BaseEmailTemplateRenderer<Config> {
@@ -27,6 +30,8 @@ export declare class LiquidEmailTemplateRenderer<Config extends BaseNotification
     /** What this renderer produces, for log lines. */
     protected readonly templateKind: string;
     protected readonly subjectRequired: boolean;
+    /** Whether a preheader in template content is injected into the body. Off for plain text. */
+    protected readonly preheaderSupported: boolean;
     private readonly bodyEngine;
     private readonly subjectEngine;
     constructor(options?: LiquidTemplateRendererOptions);

package/dist/liquid-email-template-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"liquid-email-template-renderer.d.ts","sourceRoot":"","sources":["../src/liquid-email-template-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,KAAK,EACV,eAAe,EACf,yBAAyB,EACzB,UAAU,EACV,0BAA0B,EAC1B,aAAa,EACb,oBAAoB,EACpB,UAAU,EACX,MAAM,WAAW,CAAC;AAKnB,MAAM,MAAM,6BAA6B,GAAG,aAAa,GAAG;IAC1D;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,qBAAa,2BAA2B,CAAC,MAAM,SAAS,0BAA0B,CAChF,YAAW,yBAAyB,CAAC,MAAM,CAAC;IAUhC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,6BAA6B;IARrE,MAAM,EAAE,UAAU,GAAG,IAAI,CAAQ;IACjC,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAiC;IACxE,kDAAkD;IAClD,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAW;IAClD,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAQ;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAER,OAAO,GAAE,6BAAkC;IAQ1E;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAIhC,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;IA6B1F,yBAAyB,CAC7B,YAAY,EAAE,eAAe,CAAC,MAAM,CAAC,EACrC,eAAe,EAAE,oBAAoB,EACrC,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,aAAa,CAAC;IAsBzB,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI7C,OAAO,CAAC,oBAAoB;IAO5B;;;;OAIG;YACW,UAAU;CAiBzB;AAMD,qBAAa,kCAAkC,CAAC,MAAM,SAAS,0BAA0B;IACvF,MAAM,CAAC,OAAO,GAAE,6BAAkC,GAAG,2BAA2B,CAAC,MAAM,CAAC;CAGzF"}
+{"version":3,"file":"liquid-email-template-renderer.d.ts","sourceRoot":"","sources":["../src/liquid-email-template-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,KAAK,EACV,eAAe,EACf,yBAAyB,EACzB,UAAU,EACV,0BAA0B,EAC1B,aAAa,EACb,oBAAoB,EACpB,UAAU,EACX,MAAM,WAAW,CAAC;AAKnB,MAAM,MAAM,6BAA6B,GAAG,aAAa,GAAG;IAC1D;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,2BAA2B,CAAC,MAAM,SAAS,0BAA0B,CAChF,YAAW,yBAAyB,CAAC,MAAM,CAAC;IAYhC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,6BAA6B;IAVrE,MAAM,EAAE,UAAU,GAAG,IAAI,CAAQ;IACjC,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAiC;IACxE,kDAAkD;IAClD,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAW;IAClD,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAQ;IACnD,6FAA6F;IAC7F,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAQ;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IAEvC,YAA+B,OAAO,GAAE,6BAAkC,EAMzE;IAED;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAErC;IAEK,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CA2B/F;IAEK,yBAAyB,CAC7B,YAAY,EAAE,eAAe,CAAC,MAAM,CAAC,EACrC,eAAe,EAAE,oBAAoB,EACrC,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,aAAa,CAAC,CA8BxB;IAED,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;IAED,OAAO,CAAC,oBAAoB;IAO5B;;;;OAIG;YACW,UAAU;CAiBzB;AA2BD,qBAAa,kCAAkC,CAAC,MAAM,SAAS,0BAA0B;IACvF,MAAM,CAAC,OAAO,GAAE,6BAAkC,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAEvF;CACF"}

package/dist/liquid-email-template-renderer.js

@@ -10,7 +10,10 @@ import { log, logError, logId, logLabel } from 'vintasend';
  *
  * The body is rendered with `outputEscape: 'escape'` unless `options.outputEscape` says otherwise,
  * so context values cannot inject markup into an HTML email; use `{{ value | raw }}` for values
- * that are trusted HTML. The subject is plain text and is never escaped; its whitespace, including
+ * that are trusted HTML. When template content carries a `preheader` (as managed templates do),
+ * it is rendered with the body's escaping and injected as a hidden element at the top of the body,
+ * which is what mail clients show as inbox preview text. The file-based `render` has no preheader.
+ * The subject is plain text and is never escaped; its whitespace, including
  * the trailing newline of a template file, is collapsed to single spaces.
  */
 export class LiquidEmailTemplateRenderer {
@@ -21,6 +24,8 @@ export class LiquidEmailTemplateRenderer {
         /** What this renderer produces, for log lines. */
         this.templateKind = 'email';
         this.subjectRequired = true;
+        /** Whether a preheader in template content is injected into the body. Off for plain text. */
+        this.preheaderSupported = true;
         const { configureEngine, ...liquidOptions } = options;
         this.bodyEngine = new Liquid({ outputEscape: 'escape', ...liquidOptions });
         this.subjectEngine = new Liquid({ ...liquidOptions, outputEscape: undefined });
@@ -54,6 +59,7 @@ export class LiquidEmailTemplateRenderer {
     }
     async renderFromTemplateContent(notification, templateContent, context) {
         const { subject: subjectContent, body: bodyContent } = templateContent;
+        const preheaderContent = templateContent.preheader;
         if (!subjectContent && this.subjectRequired) {
             throw new Error('Subject template is required');
         }
@@ -62,7 +68,13 @@ export class LiquidEmailTemplateRenderer {
         const subject = subjectContent
             ? await this.renderPart('subject', null, notification, () => this.subjectEngine.parseAndRender(subjectContent, context))
             : '';
-        return { subject: normalizeSubject(subject), body: this.normalizeBody(body) };
+        const preheader = this.preheaderSupported && preheaderContent?.trim()
+            ? await this.renderPart('preheader', null, notification, () => this.bodyEngine.parseAndRender(preheaderContent, context))
+            : '';
+        return {
+            subject: normalizeSubject(subject),
+            body: this.normalizeBody(injectPreheader(body, preheader)),
+        };
     }
     normalizeBody(body) {
         return body;
@@ -90,6 +102,24 @@ export class LiquidEmailTemplateRenderer {
         }
     }
 }
+const PREHEADER_STYLE = 'display:none;font-size:1px;line-height:1px;max-height:0;max-width:0;opacity:0;overflow:hidden;mso-hide:all;visibility:hidden;';
+/**
+ * Put `preheader` (already escaped by the engine) in a hidden element at the top of the body, or
+ * straight after the opening `<body>` tag when the body is a full document. No-op when blank.
+ */
+function injectPreheader(body, preheader) {
+    const text = preheader.replace(/\s+/g, ' ').trim();
+    if (!text) {
+        return body;
+    }
+    const element = `<div style="${PREHEADER_STYLE}">${text}</div>`;
+    const bodyTag = /<body\b[^>]*>/i.exec(body);
+    if (bodyTag === null) {
+        return element + body;
+    }
+    const end = bodyTag.index + bodyTag[0].length;
+    return body.slice(0, end) + element + body.slice(end);
+}
 function normalizeSubject(subject) {
     return subject.replace(/\s+/g, ' ').trim();
 }

package/dist/liquid-inline-email-template-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"liquid-inline-email-template-renderer.d.ts","sourceRoot":"","sources":["../src/liquid-inline-email-template-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EACL,2BAA2B,EAC3B,KAAK,6BAA6B,EACnC,MAAM,qCAAqC,CAAC;AAE7C;;;;;;;;;GASG;AACH,qBAAa,iCAAiC,CAC5C,MAAM,SAAS,0BAA0B,CACzC,SAAQ,2BAA2B,CAAC,MAAM,CAAC;IAC3C,mBAA4B,YAAY,EAAE,MAAM,CAAuC;gBAGrF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,OAAO,GAAE,IAAI,CAAC,6BAA6B,EAAE,WAAW,CAAM;CAIjE;AAED,qBAAa,wCAAwC,CAAC,MAAM,SAAS,0BAA0B;IAC7F,MAAM,CACJ,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,OAAO,GAAE,IAAI,CAAC,6BAA6B,EAAE,WAAW,CAAM,GAC7D,iCAAiC,CAAC,MAAM,CAAC;CAG7C"}
+{"version":3,"file":"liquid-inline-email-template-renderer.d.ts","sourceRoot":"","sources":["../src/liquid-inline-email-template-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EACL,2BAA2B,EAC3B,KAAK,6BAA6B,EACnC,MAAM,qCAAqC,CAAC;AAE7C;;;;;;;;;GASG;AACH,qBAAa,iCAAiC,CAC5C,MAAM,SAAS,0BAA0B,CACzC,SAAQ,2BAA2B,CAAC,MAAM,CAAC;IAC3C,mBAA4B,YAAY,EAAE,MAAM,CAAuC;IAEvF,YACE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,OAAO,GAAE,IAAI,CAAC,6BAA6B,EAAE,WAAW,CAAM,EAG/D;CACF;AAED,qBAAa,wCAAwC,CAAC,MAAM,SAAS,0BAA0B;IAC7F,MAAM,CACJ,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,OAAO,GAAE,IAAI,CAAC,6BAA6B,EAAE,WAAW,CAAM,GAC7D,iCAAiC,CAAC,MAAM,CAAC,CAE3C;CACF"}

package/dist/liquid-sms-template-renderer.d.ts

@@ -18,6 +18,7 @@ export declare class LiquidSmsTemplateRenderer<Config extends BaseNotificationTy
     protected readonly rendererName: string;
     protected readonly templateKind: string;
     protected readonly subjectRequired: boolean;
+    protected readonly preheaderSupported: boolean;
     constructor(options?: LiquidTemplateRendererOptions);
     protected normalizeBody(body: string): string;
 }

package/dist/liquid-sms-template-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"liquid-sms-template-renderer.d.ts","sourceRoot":"","sources":["../src/liquid-sms-template-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EACL,2BAA2B,EAC3B,KAAK,6BAA6B,EACnC,MAAM,qCAAqC,CAAC;AAE7C;;;;;;;;;;;;;GAaG;AACH,qBAAa,yBAAyB,CACpC,MAAM,SAAS,0BAA0B,CACzC,SAAQ,2BAA2B,CAAC,MAAM,CAAC;IAC3C,mBAA4B,YAAY,EAAE,MAAM,CAA+B;IAC/E,mBAA4B,YAAY,EAAE,MAAM,CAAS;IACzD,mBAA4B,eAAe,EAAE,OAAO,CAAS;gBAEjD,OAAO,GAAE,6BAAkC;cAIpC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAGvD;AAED,qBAAa,gCAAgC,CAAC,MAAM,SAAS,0BAA0B;IACrF,MAAM,CAAC,OAAO,GAAE,6BAAkC,GAAG,yBAAyB,CAAC,MAAM,CAAC;CAGvF"}
+{"version":3,"file":"liquid-sms-template-renderer.d.ts","sourceRoot":"","sources":["../src/liquid-sms-template-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EACL,2BAA2B,EAC3B,KAAK,6BAA6B,EACnC,MAAM,qCAAqC,CAAC;AAE7C;;;;;;;;;;;;;GAaG;AACH,qBAAa,yBAAyB,CACpC,MAAM,SAAS,0BAA0B,CACzC,SAAQ,2BAA2B,CAAC,MAAM,CAAC;IAC3C,mBAA4B,YAAY,EAAE,MAAM,CAA+B;IAC/E,mBAA4B,YAAY,EAAE,MAAM,CAAS;IACzD,mBAA4B,eAAe,EAAE,OAAO,CAAS;IAC7D,mBAA4B,kBAAkB,EAAE,OAAO,CAAS;IAEhE,YAAY,OAAO,GAAE,6BAAkC,EAEtD;IAED,UAAmB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;CACF;AAED,qBAAa,gCAAgC,CAAC,MAAM,SAAS,0BAA0B;IACrF,MAAM,CAAC,OAAO,GAAE,6BAAkC,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAErF;CACF"}

package/dist/liquid-sms-template-renderer.js

@@ -19,6 +19,7 @@ export class LiquidSmsTemplateRenderer extends LiquidEmailTemplateRenderer {
         this.rendererName = 'LiquidSmsTemplateRenderer';
         this.templateKind = 'SMS';
         this.subjectRequired = false;
+        this.preheaderSupported = false;
     }
     normalizeBody(body) {
         return body.trim();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vintasend-liquidjs",
-  "version": "1.0.0-alpha7",
+  "version": "1.0.0-alpha9",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/vintasoftware/vintasend-liquidjs.git"
@@ -37,15 +37,15 @@
   "author": "Hugo Bessa",
   "license": "MIT",
   "dependencies": {
-    "liquidjs": "^10.29.0",
-    "vintasend": "^1.0.0-alpha7"
+    "liquidjs": "^10.30.1",
+    "vintasend": "^1.0.0-alpha9"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.5.10",
-    "@types/node": "25.3.3",
-    "@vitest/coverage-v8": "4.0.18",
+    "@biomejs/biome": "^2.6.4",
+    "@types/node": "26.6.6",
+    "@vitest/coverage-v8": "5.0.5",
     "husky": "^9.1.7",
-    "typescript": "^5.9.3",
-    "vitest": "4.0.18"
+    "typescript": "^7.0.2",
+    "vitest": "5.0.5"
   }
 }