@leancodepl/mail-translation 10.5.0 → 10.5.2

package/CHANGELOG.md

@@ -3,10 +3,21 @@
 All notable changes to this project will be documented in this file. See
 [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-# [10.5.0](https://github.com/leancodepl/js_corelibrary/compare/v10.4.0...v10.5.0) (2026-07-01)
+## [10.5.2](https://github.com/leancodepl/js_corelibrary/compare/v10.5.1...v10.5.2) (2026-07-02)
+
+**Note:** Version bump only for package @leancodepl/mail-translation
+
+# Change Log
+
+All notable changes to this project will be documented in this file. See
+[Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## [10.5.1](https://github.com/leancodepl/js_corelibrary/compare/v10.4.0...v10.5.1) (2026-07-01)
 
 ### Bug Fixes
 
+- **mail-translation:** follow mjml include best practices + drop comment
+  ([f523436](https://github.com/leancodepl/js_corelibrary/commit/f523436d2df62553eb74d2be9804c534a22a7d02))
 - resolve pre-existing typecheck errors in logger affected set
   ([9bb40cf](https://github.com/leancodepl/js_corelibrary/commit/9bb40cf62ffd84b55f1bb20a19aef1fcf7a15dff))
 

package/README.md

@@ -100,6 +100,18 @@ templates/
     └── footer.mjml
 ```
 
+### Includes
+
+You can pull shared partials into a template with `mj-include`:
+
+```mjml
+<mj-include path="./components/styles.mjml" />
+```
+
+Any `.mjml` file inside your templates root can be included, referenced with a base-relative path such as
+`./components/styles.mjml`. Files outside the templates root are not allowed: paths cannot escape the root with `..`,
+and absolute paths outside it are rejected.
+
 ### Translation Files
 
 Create JSON translation files in your `translationsPath`:

package/dist/bin.cjs

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-"use strict";const c=require("yargs/helpers"),u=require("yargs/yargs"),n=require("./saveOutputs-Dq_vvJdp.cjs"),g=require("lilconfig"),d=require("yaml"),t=require("zod/v4");function p(e){const a=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const r in e)if(r!=="default"){const i=Object.getOwnPropertyDescriptor(e,r);Object.defineProperty(a,r,i.get?i:{enumerable:!0,get:()=>e[r]})}}return a.default=e,Object.freeze(a)}const f=p(d),m=t.z.enum(["kratos","razor"]),h=t.z.object({translationsPath:t.z.string().optional().describe("Path to directory containing translation JSON files. When omitted, templates are compiled without translations. Each JSON file should be named with the language code (e.g., en.json, pl.json)."),mailsPath:t.z.string().describe("Path to directory containing MJML email templates. All .mjml files in this directory will be processed."),plaintextMailsPath:t.z.string().optional().describe("Path to directory containing plaintext templates. If not specified, defaults to the same value as mailsPath. Used for generating text-only versions of emails alongside HTML versions."),outputPath:t.z.string().describe("Directory where processed templates will be saved. The tool will create this directory if it doesn't exist."),outputMode:m.describe("Target templating system format: 'kratos' for Go template files compatible with Ory Kratos, 'razor' for C# Razor template files."),defaultLanguage:t.z.string().optional().describe("Default language code for templates with translations. Required when translationsPath is provided."),languages:t.z.array(t.z.string()).optional().describe("Array of language codes to process. When omitted, all languages found in translation files are automatically processed. Use this to limit output to specific languages."),kratosLanguageVariable:t.z.string().optional().describe("Variable path used for language detection in Kratos templates. Defaults to '.Identity.traits.lang'. This determines how the generated template will access the user's language preference. Only used in Kratos mode.")});function s(e,a){return f.parse(a)}const o="mail-translation",y={searchPlaces:[`.${o}rc`,`.${o}rc.json`,`.${o}rc.yaml`,`.${o}rc.yml`,`.${o}rc.js`,`.${o}rc.cjs`,`${o}.config.js`,`${o}.config.cjs`],loaders:{".yaml":s,".yml":s}};function b(e){const a=g.lilconfigSync("mail-translation",y),r=e?a.load(e):a.search();if(!r)throw new Error("No configuration file found");try{return h.parse(r.config)}catch(i){throw new Error(`Failed to load configuration: ${i}`)}}const w=u(c.hideBin(process.argv)).option("config",{alias:"c",type:"string",description:"Config file location"}).parseSync(),l=b(w.config);n.generate(l).then(e=>n.saveOutputs({processedTemplates:e,outputPath:l.outputPath}));
+"use strict";const c=require("yargs/helpers"),u=require("yargs/yargs"),n=require("./saveOutputs-C8epdHxg.cjs"),g=require("lilconfig"),d=require("yaml"),t=require("zod/v4");function p(e){const a=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const r in e)if(r!=="default"){const i=Object.getOwnPropertyDescriptor(e,r);Object.defineProperty(a,r,i.get?i:{enumerable:!0,get:()=>e[r]})}}return a.default=e,Object.freeze(a)}const f=p(d),m=t.z.enum(["kratos","razor"]),h=t.z.object({translationsPath:t.z.string().optional().describe("Path to directory containing translation JSON files. When omitted, templates are compiled without translations. Each JSON file should be named with the language code (e.g., en.json, pl.json)."),mailsPath:t.z.string().describe("Path to directory containing MJML email templates. All .mjml files in this directory will be processed."),plaintextMailsPath:t.z.string().optional().describe("Path to directory containing plaintext templates. If not specified, defaults to the same value as mailsPath. Used for generating text-only versions of emails alongside HTML versions."),outputPath:t.z.string().describe("Directory where processed templates will be saved. The tool will create this directory if it doesn't exist."),outputMode:m.describe("Target templating system format: 'kratos' for Go template files compatible with Ory Kratos, 'razor' for C# Razor template files."),defaultLanguage:t.z.string().optional().describe("Default language code for templates with translations. Required when translationsPath is provided."),languages:t.z.array(t.z.string()).optional().describe("Array of language codes to process. When omitted, all languages found in translation files are automatically processed. Use this to limit output to specific languages."),kratosLanguageVariable:t.z.string().optional().describe("Variable path used for language detection in Kratos templates. Defaults to '.Identity.traits.lang'. This determines how the generated template will access the user's language preference. Only used in Kratos mode.")});function s(e,a){return f.parse(a)}const o="mail-translation",y={searchPlaces:[`.${o}rc`,`.${o}rc.json`,`.${o}rc.yaml`,`.${o}rc.yml`,`.${o}rc.js`,`.${o}rc.cjs`,`${o}.config.js`,`${o}.config.cjs`],loaders:{".yaml":s,".yml":s}};function b(e){const a=g.lilconfigSync("mail-translation",y),r=e?a.load(e):a.search();if(!r)throw new Error("No configuration file found");try{return h.parse(r.config)}catch(i){throw new Error(`Failed to load configuration: ${i}`)}}const w=u(c.hideBin(process.argv)).option("config",{alias:"c",type:"string",description:"Config file location"}).parseSync(),l=b(w.config);n.generate(l).then(e=>n.saveOutputs({processedTemplates:e,outputPath:l.outputPath}));

package/dist/bin.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { hideBin as l } from "yargs/helpers";
 import c from "yargs/yargs";
-import { g, s as d } from "./saveOutputs-UaR47fWW.js";
+import { g, s as d } from "./saveOutputs-C5A3oaMr.js";
 import { lilconfigSync as m } from "lilconfig";
 import * as p from "yaml";
 import { z as t } from "zod/v4";

package/dist/compileMjml.d.ts

@@ -7,8 +7,8 @@ export interface MjmlCompileResult {
     html: string;
     mjmlParseErrors: MjmlParseError[];
 }
-export declare function compileMjml({ mjmlContent, filePath }: {
+export declare function compileMjml({ mjmlContent, filePath, }: {
     mjmlContent: string;
     filePath: string;
-}): MjmlCompileResult;
+}): Promise<MjmlCompileResult>;
 //# sourceMappingURL=compileMjml.d.ts.map

package/dist/compileMjml.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compileMjml.d.ts","sourceRoot":"","sources":["../src/compileMjml.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,eAAe,EAAE,cAAc,EAAE,CAAA;CAClC;AAED,wBAAgB,WAAW,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CAsBnH"}
+{"version":3,"file":"compileMjml.d.ts","sourceRoot":"","sources":["../src/compileMjml.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,eAAe,EAAE,cAAc,EAAE,CAAA;CAClC;AAED,wBAAsB,WAAW,CAAC,EAChC,WAAW,EACX,QAAQ,GACT,EAAE;IACD,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;CACjB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA2B7B"}

package/dist/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAKhD,wBAAsB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,qBAAqB,EAAE,YAAY,CAAC,4DAmB/E"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAKhD,wBAAsB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,qBAAqB,EAAE,YAAY,CAAC,4DAqB/E"}

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./saveOutputs-Dq_vvJdp.cjs");exports.generate=e.generate;exports.saveOutputs=e.saveOutputs;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./saveOutputs-C8epdHxg.cjs");exports.generate=e.generate;exports.saveOutputs=e.saveOutputs;

package/dist/index.js

@@ -1,4 +1,4 @@
-import { g as a, s as t } from "./saveOutputs-UaR47fWW.js";
+import { g as a, s as t } from "./saveOutputs-C5A3oaMr.js";
 export {
   a as generate,
   t as saveOutputs

package/dist/processTemplate.d.ts

@@ -25,5 +25,5 @@ export declare function processTemplate({ template, translationData, outputMode,
     defaultLanguage?: string;
     kratosLanguageVariable?: string;
     mailsPath: string;
-}): ProcessedTemplate;
+}): Promise<ProcessedTemplate>;
 //# sourceMappingURL=processTemplate.d.ts.map

package/dist/processTemplate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"processTemplate.d.ts","sourceRoot":"","sources":["../src/processTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,cAAc,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AACrC,OAAO,EAA2B,cAAc,EAAE,MAAM,2BAA2B,CAAA;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAGpD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,eAAe,EAAE,cAAc,EAAE,CAAA;IACjC,eAAe,EAAE,cAAc,EAAE,CAAA;CAClC;AAED,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,eAAe,EACf,UAAU,EACV,eAAe,EACf,sBAAsB,EACtB,SAAS,GACV,EAAE;IACD,QAAQ,EAAE,QAAQ,CAAA;IAClB,eAAe,EAAE,eAAe,CAAA;IAChC,UAAU,EAAE,UAAU,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,SAAS,EAAE,MAAM,CAAA;CAClB,GAAG,iBAAiB,CAmCpB"}
+{"version":3,"file":"processTemplate.d.ts","sourceRoot":"","sources":["../src/processTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,cAAc,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AACrC,OAAO,EAA2B,cAAc,EAAE,MAAM,2BAA2B,CAAA;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAGpD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,eAAe,EAAE,cAAc,EAAE,CAAA;IACjC,eAAe,EAAE,cAAc,EAAE,CAAA;CAClC;AAED,wBAAsB,eAAe,CAAC,EACpC,QAAQ,EACR,eAAe,EACf,UAAU,EACV,eAAe,EACf,sBAAsB,EACtB,SAAS,GACV,EAAE;IACD,QAAQ,EAAE,QAAQ,CAAA;IAClB,eAAe,EAAE,eAAe,CAAA;IAChC,UAAU,EAAE,UAAU,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,SAAS,EAAE,MAAM,CAAA;CAClB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmC7B"}

package/dist/{saveOutputs-UaR47fWW.js → saveOutputs-C5A3oaMr.js}

@@ -6,12 +6,12 @@ import F from "intl-messageformat";
 import { createCliLogger as O } from "@leancodepl/logger/cli";
 async function M(t) {
   try {
-    const r = (await f(t)).filter((e) => g(e) === ".mjml");
+    const a = (await f(t)).filter((e) => g(e) === ".mjml");
     return Promise.all(
-      r.map(async (e) => {
-        const a = x(e, ".mjml"), o = p(t, e), i = await h(o, "utf8");
+      a.map(async (e) => {
+        const r = x(e, ".mjml"), s = p(t, e), i = await h(s, "utf8");
         return {
-          name: a,
+          name: r,
           content: i,
           isPlaintext: !1
         };
@@ -26,19 +26,19 @@ async function k({
   outputMode: n
 }) {
   try {
-    const r = await f(t), e = n === "kratos" ? r.filter((a) => a.endsWith(".plaintext.gotmpl")) : r.filter((a) => a.endsWith(".txt.cshtml"));
+    const a = await f(t), e = n === "kratos" ? a.filter((r) => r.endsWith(".plaintext.gotmpl")) : a.filter((r) => r.endsWith(".txt.cshtml"));
     return Promise.all(
-      e.map(async (a) => {
-        const o = n === "kratos" ? a.replace(/\.plaintext\.gotmpl$/, "") : a.replace(/\.txt\.cshtml$/, ""), i = p(t, a), s = await h(i, "utf8");
+      e.map(async (r) => {
+        const s = n === "kratos" ? r.replace(/\.plaintext\.gotmpl$/, "") : r.replace(/\.txt\.cshtml$/, ""), i = p(t, r), o = await h(i, "utf8");
         return {
-          name: o,
-          content: s,
+          name: s,
+          content: o,
           isPlaintext: !0
         };
       })
     );
-  } catch (r) {
-    throw new Error(`Failed to load plaintext templates: ${r}`);
+  } catch (a) {
+    throw new Error(`Failed to load plaintext templates: ${a}`);
   }
 }
 const c = O();
@@ -47,82 +47,90 @@ async function C(t) {
   if (!t)
     return n;
   try {
-    const e = (await f(t)).filter((a) => g(a) === ".json");
+    const e = (await f(t)).filter((r) => g(r) === ".json");
     if (e.length === 0)
       return c.warn(`No translation files found in: ${t}. Continuing without translations.`), n;
-    for (const a of e) {
-      const o = x(a, ".json"), i = p(t, a);
+    for (const r of e) {
+      const s = x(r, ".json"), i = p(t, r);
       try {
-        const s = await h(i, "utf8"), l = JSON.parse(s);
-        n[o] = l;
-      } catch (s) {
-        c.warn(`Failed to load translation file ${a}:`, s);
+        const o = await h(i, "utf8"), l = JSON.parse(o);
+        n[s] = l;
+      } catch (o) {
+        c.warn(`Failed to load translation file ${r}:`, o);
       }
     }
     return n;
-  } catch (r) {
-    return c.warn(`Failed to load translations: ${r}. Continuing without translations.`), n;
+  } catch (a) {
+    return c.warn(`Failed to load translations: ${a}. Continuing without translations.`), n;
   }
 }
 const { html: b } = E;
-function N({ mjmlContent: t, filePath: n }) {
+async function N({
+  mjmlContent: t,
+  filePath: n
+}) {
   try {
-    const r = v(t, {
+    const a = await v(t, {
       keepComments: !1,
       validationLevel: "soft",
-      filePath: n
+      // `filePath` points at the templates root; templates use base-relative
+      // `mj-include` paths so partials resolve within it (mjml scopes includes to
+      // `filePath`/`includePath` and denies `..` escapes).
+      filePath: n,
+      // mjml 5 disables `mj-include` by default; re-enable it to resolve shared partials.
+      ignoreIncludes: !1
     });
     return {
-      html: b(r.html, {
+      html: b(a.html, {
         indent_size: 2,
         preserve_newlines: !0,
         max_preserve_newlines: 1
       }),
-      mjmlParseErrors: r.errors || []
+      mjmlParseErrors: a.errors || []
     };
-  } catch (r) {
-    throw new Error(`MJML compilation failed: ${r}`);
+  } catch (a) {
+    throw new Error(`MJML compilation failed: ${a}`);
   }
 }
 function R({
   translatedTemplates: t,
   defaultLanguage: n,
-  kratosLanguageVariable: r
+  kratosLanguageVariable: a
 }) {
-  const e = t.filter((s) => s.isPlaintext), a = t.filter((s) => !s.isPlaintext), o = a.map((s) => ({
-    filename: `${s.name}.gotmpl`,
+  const e = t.filter((o) => o.isPlaintext), r = t.filter((o) => !o.isPlaintext), s = r.map((o) => ({
+    filename: `${o.name}.gotmpl`,
     content: d({
-      templates: a,
+      templates: r,
       defaultLanguage: n,
-      kratosLanguageVariable: r
+      kratosLanguageVariable: a
     })
-  })), i = e.map((s) => ({
-    filename: `${s.name}.plaintext.gotmpl`,
+  })), i = e.map((o) => ({
+    filename: `${o.name}.plaintext.gotmpl`,
     content: d({
       templates: e,
       defaultLanguage: n,
-      kratosLanguageVariable: r
+      kratosLanguageVariable: a
     })
   }));
-  return [...o, ...i];
+  return [...s, ...i];
 }
 function d({
   templates: t,
   defaultLanguage: n,
-  kratosLanguageVariable: r = ".Identity.traits.lang"
+  kratosLanguageVariable: a = ".Identity.traits.lang"
 }) {
   if (t.length === 1 || !n)
     return t[0]?.content ?? "";
   let e = "";
-  return t.forEach((o) => {
-    e += `{{define "${o.language}"}}
-`, e += o.content, e += `
+  return t.forEach((s) => {
+    e += `{{define "${s.language}"}}
+`, e += s.content, e += `
 {{end}}
 
 `;
-  }), t.filter((o) => o.language !== n).map((o) => o.language).forEach((o, i) => {
-    e += `{{- ${i === 0 ? "if" : "else if"} eq ${r} "${o}" -}}
-`, e += `{{ template "${o}" . }}
+  }), t.filter((s) => s.language !== n).map((s) => s.language).forEach((s, i) => {
+    e += `{{- ${i === 0 ? "if" : "else if"} eq ${a} "${s}" -}}
+`, e += `{{ template "${s}" . }}
 `;
   }), e += `{{- else -}}
 `, e += `{{ template "${n}" . }}
@@ -133,9 +141,9 @@ function z({
   translatedTemplates: t,
   defaultLanguage: n
 }) {
-  return t.map((r) => ({
-    filename: L({ template: r, defaultLanguage: n }),
-    content: J(r.content)
+  return t.map((a) => ({
+    filename: L({ template: a, defaultLanguage: n }),
+    content: J(a.content)
   }));
 }
 function J(t) {
@@ -173,10 +181,10 @@ function L({
   template: t,
   defaultLanguage: n
 }) {
-  const r = !!n && !!t.language && t.language !== n;
+  const a = !!n && !!t.language && t.language !== n;
   return [
     t.name,
-    ...r ? [t.language] : [],
+    ...a ? [t.language] : [],
     ...t.isPlaintext ? ["txt"] : [],
     "cshtml"
   ].join(".");
@@ -184,34 +192,34 @@ function L({
 function _({
   translatedTemplates: t,
   outputMode: n,
-  defaultLanguage: r,
+  defaultLanguage: a,
   kratosLanguageVariable: e
 }) {
   switch (n) {
     case "kratos":
       return R({
         translatedTemplates: t,
-        defaultLanguage: r,
+        defaultLanguage: a,
         kratosLanguageVariable: e
       });
     case "razor":
-      return z({ translatedTemplates: t, defaultLanguage: r });
+      return z({ translatedTemplates: t, defaultLanguage: a });
   }
 }
 function A({
   template: t,
   translations: n,
-  language: r
+  language: a
 }) {
   const e = /\(\(t\s+["']([^"']+)["']\s*(?:,\s*({.*?}))?\s*\)\)/g;
-  return t.replaceAll(e, (o, i, s) => {
+  return t.replaceAll(e, (s, i, o) => {
     const l = n[i];
-    if (!l || !r)
-      return c.warn(`Translation is missing for key "${i}"` + (r ? ` for "${r}" language` : "")), i;
-    if (s && r)
+    if (!l || !a)
+      return c.warn(`Translation is missing for key "${i}"` + (a ? ` for "${a}" language` : "")), i;
+    if (o && a)
       try {
-        const m = JSON.parse(s);
-        return new F(l, r).format(m);
+        const m = JSON.parse(o);
+        return new F(l, a).format(m);
       } catch (m) {
         return c.warn(`Error parsing JSON parameters or formatting message for key "${i}":`, m), i;
       }
@@ -219,27 +227,27 @@ function A({
       return l;
   });
 }
-function D({
+async function D({
   template: t,
   translationData: n,
-  outputMode: r,
+  outputMode: a,
   defaultLanguage: e,
-  kratosLanguageVariable: a,
-  mailsPath: o
+  kratosLanguageVariable: r,
+  mailsPath: s
 }) {
-  const i = Object.keys(n), s = i.length > 0 ? i : [e], l = t.isPlaintext ? void 0 : N({ mjmlContent: t.content, filePath: o }), m = t.isPlaintext ? t.content : l?.html ?? "", w = s.map((u) => {
-    const T = u ? n[u] ?? {} : {}, P = A({ template: m, translations: T, language: u });
+  const i = Object.keys(n), o = i.length > 0 ? i : [e], l = t.isPlaintext ? void 0 : await N({ mjmlContent: t.content, filePath: s }), m = t.isPlaintext ? t.content : l?.html ?? "", w = o.map((u) => {
+    const P = u ? n[u] ?? {} : {}, T = A({ template: m, translations: P, language: u });
     return {
       name: t.name,
-      content: P,
+      content: T,
       isPlaintext: t.isPlaintext,
       language: u
     };
   }), y = _({
     translatedTemplates: w,
-    outputMode: r,
+    outputMode: a,
     defaultLanguage: e,
-    kratosLanguageVariable: a
+    kratosLanguageVariable: r
   });
   return {
     name: t.name,
@@ -248,19 +256,21 @@ function D({
   };
 }
 async function H(t) {
-  const n = await C(t.translationsPath), r = await M(t.mailsPath), e = await k({
+  const n = await C(t.translationsPath), a = await M(t.mailsPath), e = await k({
     plaintextMailsPath: t.plaintextMailsPath ?? t.mailsPath,
     outputMode: t.outputMode
   });
-  return [...r, ...e].map(
-    (a) => D({
-      template: a,
-      translationData: n,
-      outputMode: t.outputMode,
-      defaultLanguage: t.defaultLanguage,
-      kratosLanguageVariable: t.kratosLanguageVariable,
-      mailsPath: t.mailsPath
-    })
+  return Promise.all(
+    [...a, ...e].map(
+      (r) => D({
+        template: r,
+        translationData: n,
+        outputMode: t.outputMode,
+        defaultLanguage: t.defaultLanguage,
+        kratosLanguageVariable: t.kratosLanguageVariable,
+        mailsPath: t.mailsPath
+      })
+    )
   );
 }
 async function V({
@@ -268,9 +278,9 @@ async function V({
   outputPath: n
 }) {
   await $(n, { recursive: !0 });
-  const r = t.flatMap((e) => e.outputTemplates);
+  const a = t.flatMap((e) => e.outputTemplates);
   await Promise.all(
-    r.map((e) => j(p(n, e.filename), e.content, "utf8"))
+    a.map((e) => j(p(n, e.filename), e.content, "utf8"))
   );
   for (const e of t)
     e.mjmlParseErrors.length > 0 && c.warn(`Errors in ${e.name}:`, e.mjmlParseErrors);

package/dist/saveOutputs-C8epdHxg.cjs

@@ -0,0 +1,10 @@
+"use strict";const m=require("node:fs/promises"),c=require("node:path"),y=require("js-beautify"),j=require("mjml"),P=require("intl-messageformat"),T=require("@leancodepl/logger/cli");async function $(t){try{const a=(await m.readdir(t)).filter(e=>c.extname(e)===".mjml");return Promise.all(a.map(async e=>{const r=c.basename(e,".mjml"),s=c.join(t,e),i=await m.readFile(s,"utf8");return{name:r,content:i,isPlaintext:!1}}))}catch(n){throw new Error(`Failed to load templates: ${n}`)}}async function v({plaintextMailsPath:t,outputMode:n}){try{const a=await m.readdir(t),e=n==="kratos"?a.filter(r=>r.endsWith(".plaintext.gotmpl")):a.filter(r=>r.endsWith(".txt.cshtml"));return Promise.all(e.map(async r=>{const s=n==="kratos"?r.replace(/\.plaintext\.gotmpl$/,""):r.replace(/\.txt\.cshtml$/,""),i=c.join(t,r),o=await m.readFile(i,"utf8");return{name:s,content:o,isPlaintext:!0}}))}catch(a){throw new Error(`Failed to load plaintext templates: ${a}`)}}const u=T.createCliLogger();async function E(t){const n={};if(!t)return n;try{const e=(await m.readdir(t)).filter(r=>c.extname(r)===".json");if(e.length===0)return u.warn(`No translation files found in: ${t}. Continuing without translations.`),n;for(const r of e){const s=c.basename(r,".json"),i=c.join(t,r);try{const o=await m.readFile(i,"utf8"),l=JSON.parse(o);n[s]=l}catch(o){u.warn(`Failed to load translation file ${r}:`,o)}}return n}catch(a){return u.warn(`Failed to load translations: ${a}. Continuing without translations.`),n}}const{html:F}=y;async function O({mjmlContent:t,filePath:n}){try{const a=await j(t,{keepComments:!1,validationLevel:"soft",filePath:n,ignoreIncludes:!1});return{html:F(a.html,{indent_size:2,preserve_newlines:!0,max_preserve_newlines:1}),mjmlParseErrors:a.errors||[]}}catch(a){throw new Error(`MJML compilation failed: ${a}`)}}function M({translatedTemplates:t,defaultLanguage:n,kratosLanguageVariable:a}){const e=t.filter(o=>o.isPlaintext),r=t.filter(o=>!o.isPlaintext),s=r.map(o=>({filename:`${o.name}.gotmpl`,content:d({templates:r,defaultLanguage:n,kratosLanguageVariable:a})})),i=e.map(o=>({filename:`${o.name}.plaintext.gotmpl`,content:d({templates:e,defaultLanguage:n,kratosLanguageVariable:a})}));return[...s,...i]}function d({templates:t,defaultLanguage:n,kratosLanguageVariable:a=".Identity.traits.lang"}){if(t.length===1||!n)return t[0]?.content??"";let e="";return t.forEach(s=>{e+=`{{define "${s.language}"}}
+`,e+=s.content,e+=`
+{{end}}
+
+`}),t.filter(s=>s.language!==n).map(s=>s.language).forEach((s,i)=>{e+=`{{- ${i===0?"if":"else if"} eq ${a} "${s}" -}}
+`,e+=`{{ template "${s}" . }}
+`}),e+=`{{- else -}}
+`,e+=`{{ template "${n}" . }}
+`,e+=`{{- end -}}
+`,e}function k({translatedTemplates:t,defaultLanguage:n}){return t.map(a=>({filename:b({template:a,defaultLanguage:n}),content:C(a.content)}))}function C(t){const n=["annotation","character-variant","charset","color-profile","container","counter-style","font-face","font-feature-values","font-palette-values","import","keyframes","-webkit-keyframes","layer","media","namespace","ornaments","page","position-try","property","scope","starting-style","styleset","stylistic","supports","swash","view-transition"].join("|");return t.replaceAll(new RegExp(`(?<!@)@(${n})`,"g"),"@@$1")}function b({template:t,defaultLanguage:n}){const a=!!n&&!!t.language&&t.language!==n;return[t.name,...a?[t.language]:[],...t.isPlaintext?["txt"]:[],"cshtml"].join(".")}function q({translatedTemplates:t,outputMode:n,defaultLanguage:a,kratosLanguageVariable:e}){switch(n){case"kratos":return M({translatedTemplates:t,defaultLanguage:a,kratosLanguageVariable:e});case"razor":return k({translatedTemplates:t,defaultLanguage:a})}}function N({template:t,translations:n,language:a}){const e=/\(\(t\s+["']([^"']+)["']\s*(?:,\s*({.*?}))?\s*\)\)/g;return t.replaceAll(e,(s,i,o)=>{const l=n[i];if(!l||!a)return u.warn(`Translation is missing for key "${i}"`+(a?` for "${a}" language`:"")),i;if(o&&a)try{const p=JSON.parse(o);return new P(l,a).format(p)}catch(p){return u.warn(`Error parsing JSON parameters or formatting message for key "${i}":`,p),i}else return l})}async function R({template:t,translationData:n,outputMode:a,defaultLanguage:e,kratosLanguageVariable:r,mailsPath:s}){const i=Object.keys(n),o=i.length>0?i:[e],l=t.isPlaintext?void 0:await O({mjmlContent:t.content,filePath:s}),p=t.isPlaintext?t.content:l?.html??"",h=o.map(f=>{const g=f?n[f]??{}:{},x=N({template:p,translations:g,language:f});return{name:t.name,content:x,isPlaintext:t.isPlaintext,language:f}}),w=q({translatedTemplates:h,outputMode:a,defaultLanguage:e,kratosLanguageVariable:r});return{name:t.name,mjmlParseErrors:l?.mjmlParseErrors??[],outputTemplates:w}}async function _(t){const n=await E(t.translationsPath),a=await $(t.mailsPath),e=await v({plaintextMailsPath:t.plaintextMailsPath??t.mailsPath,outputMode:t.outputMode});return Promise.all([...a,...e].map(r=>R({template:r,translationData:n,outputMode:t.outputMode,defaultLanguage:t.defaultLanguage,kratosLanguageVariable:t.kratosLanguageVariable,mailsPath:t.mailsPath})))}async function z({processedTemplates:t,outputPath:n}){await m.mkdir(n,{recursive:!0});const a=t.flatMap(e=>e.outputTemplates);await Promise.all(a.map(e=>m.writeFile(c.join(n,e.filename),e.content,"utf8")));for(const e of t)e.mjmlParseErrors.length>0&&u.warn(`Errors in ${e.name}:`,e.mjmlParseErrors)}exports.generate=_;exports.saveOutputs=z;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leancodepl/mail-translation",
-  "version": "10.5.0",
+  "version": "10.5.2",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,11 +18,11 @@
     "mail-translation": "./dist/bin.js"
   },
   "dependencies": {
-    "@leancodepl/logger": "10.5.0",
-    "intl-messageformat": "^10.7.16",
+    "@leancodepl/logger": "10.5.2",
+    "intl-messageformat": "^11.2.9",
     "js-beautify": "^1.15.4",
     "lilconfig": "^3.1.3",
-    "mjml": "^4.17.1",
+    "mjml": "^5.4.0",
     "tslib": "^2.8.1",
     "yaml": "^2.8.0",
     "yargs": "^18.0.0",
@@ -30,7 +30,7 @@
   },
   "devDependencies": {
     "@types/js-beautify": "^1.14.3",
-    "@types/mjml": "^4.7.4",
+    "@types/mjml": "^5.0.0",
     "@types/yaml": "^1.9.7",
     "@types/yargs": "^17.0.33"
   },

package/dist/saveOutputs-Dq_vvJdp.cjs

@@ -1,10 +0,0 @@
-"use strict";const m=require("node:fs/promises"),c=require("node:path"),j=require("js-beautify"),y=require("mjml"),T=require("intl-messageformat"),P=require("@leancodepl/logger/cli");async function $(t){try{const r=(await m.readdir(t)).filter(e=>c.extname(e)===".mjml");return Promise.all(r.map(async e=>{const a=c.basename(e,".mjml"),s=c.join(t,e),i=await m.readFile(s,"utf8");return{name:a,content:i,isPlaintext:!1}}))}catch(n){throw new Error(`Failed to load templates: ${n}`)}}async function v({plaintextMailsPath:t,outputMode:n}){try{const r=await m.readdir(t),e=n==="kratos"?r.filter(a=>a.endsWith(".plaintext.gotmpl")):r.filter(a=>a.endsWith(".txt.cshtml"));return Promise.all(e.map(async a=>{const s=n==="kratos"?a.replace(/\.plaintext\.gotmpl$/,""):a.replace(/\.txt\.cshtml$/,""),i=c.join(t,a),o=await m.readFile(i,"utf8");return{name:s,content:o,isPlaintext:!0}}))}catch(r){throw new Error(`Failed to load plaintext templates: ${r}`)}}const u=P.createCliLogger();async function E(t){const n={};if(!t)return n;try{const e=(await m.readdir(t)).filter(a=>c.extname(a)===".json");if(e.length===0)return u.warn(`No translation files found in: ${t}. Continuing without translations.`),n;for(const a of e){const s=c.basename(a,".json"),i=c.join(t,a);try{const o=await m.readFile(i,"utf8"),l=JSON.parse(o);n[s]=l}catch(o){u.warn(`Failed to load translation file ${a}:`,o)}}return n}catch(r){return u.warn(`Failed to load translations: ${r}. Continuing without translations.`),n}}const{html:F}=j;function O({mjmlContent:t,filePath:n}){try{const r=y(t,{keepComments:!1,validationLevel:"soft",filePath:n});return{html:F(r.html,{indent_size:2,preserve_newlines:!0,max_preserve_newlines:1}),mjmlParseErrors:r.errors||[]}}catch(r){throw new Error(`MJML compilation failed: ${r}`)}}function M({translatedTemplates:t,defaultLanguage:n,kratosLanguageVariable:r}){const e=t.filter(o=>o.isPlaintext),a=t.filter(o=>!o.isPlaintext),s=a.map(o=>({filename:`${o.name}.gotmpl`,content:d({templates:a,defaultLanguage:n,kratosLanguageVariable:r})})),i=e.map(o=>({filename:`${o.name}.plaintext.gotmpl`,content:d({templates:e,defaultLanguage:n,kratosLanguageVariable:r})}));return[...s,...i]}function d({templates:t,defaultLanguage:n,kratosLanguageVariable:r=".Identity.traits.lang"}){if(t.length===1||!n)return t[0]?.content??"";let e="";return t.forEach(s=>{e+=`{{define "${s.language}"}}
-`,e+=s.content,e+=`
-{{end}}
-
-`}),t.filter(s=>s.language!==n).map(s=>s.language).forEach((s,i)=>{e+=`{{- ${i===0?"if":"else if"} eq ${r} "${s}" -}}
-`,e+=`{{ template "${s}" . }}
-`}),e+=`{{- else -}}
-`,e+=`{{ template "${n}" . }}
-`,e+=`{{- end -}}
-`,e}function k({translatedTemplates:t,defaultLanguage:n}){return t.map(r=>({filename:b({template:r,defaultLanguage:n}),content:C(r.content)}))}function C(t){const n=["annotation","character-variant","charset","color-profile","container","counter-style","font-face","font-feature-values","font-palette-values","import","keyframes","-webkit-keyframes","layer","media","namespace","ornaments","page","position-try","property","scope","starting-style","styleset","stylistic","supports","swash","view-transition"].join("|");return t.replaceAll(new RegExp(`(?<!@)@(${n})`,"g"),"@@$1")}function b({template:t,defaultLanguage:n}){const r=!!n&&!!t.language&&t.language!==n;return[t.name,...r?[t.language]:[],...t.isPlaintext?["txt"]:[],"cshtml"].join(".")}function q({translatedTemplates:t,outputMode:n,defaultLanguage:r,kratosLanguageVariable:e}){switch(n){case"kratos":return M({translatedTemplates:t,defaultLanguage:r,kratosLanguageVariable:e});case"razor":return k({translatedTemplates:t,defaultLanguage:r})}}function N({template:t,translations:n,language:r}){const e=/\(\(t\s+["']([^"']+)["']\s*(?:,\s*({.*?}))?\s*\)\)/g;return t.replaceAll(e,(s,i,o)=>{const l=n[i];if(!l||!r)return u.warn(`Translation is missing for key "${i}"`+(r?` for "${r}" language`:"")),i;if(o&&r)try{const p=JSON.parse(o);return new T(l,r).format(p)}catch(p){return u.warn(`Error parsing JSON parameters or formatting message for key "${i}":`,p),i}else return l})}function R({template:t,translationData:n,outputMode:r,defaultLanguage:e,kratosLanguageVariable:a,mailsPath:s}){const i=Object.keys(n),o=i.length>0?i:[e],l=t.isPlaintext?void 0:O({mjmlContent:t.content,filePath:s}),p=t.isPlaintext?t.content:l?.html??"",h=o.map(f=>{const g=f?n[f]??{}:{},x=N({template:p,translations:g,language:f});return{name:t.name,content:x,isPlaintext:t.isPlaintext,language:f}}),w=q({translatedTemplates:h,outputMode:r,defaultLanguage:e,kratosLanguageVariable:a});return{name:t.name,mjmlParseErrors:l?.mjmlParseErrors??[],outputTemplates:w}}async function _(t){const n=await E(t.translationsPath),r=await $(t.mailsPath),e=await v({plaintextMailsPath:t.plaintextMailsPath??t.mailsPath,outputMode:t.outputMode});return[...r,...e].map(a=>R({template:a,translationData:n,outputMode:t.outputMode,defaultLanguage:t.defaultLanguage,kratosLanguageVariable:t.kratosLanguageVariable,mailsPath:t.mailsPath}))}async function z({processedTemplates:t,outputPath:n}){await m.mkdir(n,{recursive:!0});const r=t.flatMap(e=>e.outputTemplates);await Promise.all(r.map(e=>m.writeFile(c.join(n,e.filename),e.content,"utf8")));for(const e of t)e.mjmlParseErrors.length>0&&u.warn(`Errors in ${e.name}:`,e.mjmlParseErrors)}exports.generate=_;exports.saveOutputs=z;