@emailens/engine 0.3.0 → 0.5.0

package/dist/compile/index.d.cts

@@ -0,0 +1,47 @@
+import { n as InputFormat } from '../react-email-BQljgXbo.cjs';
+export { g as CompileError, h as CompileReactEmailOptions, p as SandboxStrategy, x as compileReactEmail } from '../react-email-BQljgXbo.cjs';
+
+/**
+ * Compile an MJML source string into an HTML email string.
+ *
+ * MJML is a declarative markup language with no code execution capability
+ * (unlike JSX). The mjml library parses XML and generates HTML; there is
+ * no sandboxing concern.
+ *
+ * Requires peer dependency: mjml
+ */
+declare function compileMjml(source: string): Promise<string>;
+
+/**
+ * Compile a Maizzle template string into an HTML email string.
+ *
+ * Pipeline:
+ *  1. Validate input (size, basic structure check)
+ *  2. Reject inputs containing PostHTML file-access directives
+ *  3. Compile using @maizzle/framework
+ *
+ * Security:
+ *  - PostHTML file-system directives are rejected at validation time
+ *    to prevent server-side file reads and SSRF.
+ *  - Template expressions ({{ expr }}) are evaluated by posthtml-expressions
+ *    with empty `locals`, so unknown identifiers like `process` or `require`
+ *    return the literal string '{local}' rather than accessing Node.js globals.
+ *  - A hard timeout prevents pathological PostCSS/Tailwind inputs from
+ *    hanging indefinitely.
+ *
+ * Requires peer dependency: @maizzle/framework
+ */
+declare function compileMaizzle(source: string): Promise<string>;
+
+/**
+ * Compile source to HTML based on format.
+ * Returns the HTML unchanged if format is "html".
+ * Lazily imports per-format compilers to avoid loading unnecessary deps.
+ */
+declare function compile(source: string, format: InputFormat, filePath?: string): Promise<string>;
+/**
+ * Auto-detect input format from file extension.
+ */
+declare function detectFormat(filePath: string): InputFormat;
+
+export { compile, compileMaizzle, compileMjml, detectFormat };

package/dist/compile/index.d.ts

@@ -0,0 +1,47 @@
+import { n as InputFormat } from '../react-email-BQljgXbo.js';
+export { g as CompileError, h as CompileReactEmailOptions, p as SandboxStrategy, x as compileReactEmail } from '../react-email-BQljgXbo.js';
+
+/**
+ * Compile an MJML source string into an HTML email string.
+ *
+ * MJML is a declarative markup language with no code execution capability
+ * (unlike JSX). The mjml library parses XML and generates HTML; there is
+ * no sandboxing concern.
+ *
+ * Requires peer dependency: mjml
+ */
+declare function compileMjml(source: string): Promise<string>;
+
+/**
+ * Compile a Maizzle template string into an HTML email string.
+ *
+ * Pipeline:
+ *  1. Validate input (size, basic structure check)
+ *  2. Reject inputs containing PostHTML file-access directives
+ *  3. Compile using @maizzle/framework
+ *
+ * Security:
+ *  - PostHTML file-system directives are rejected at validation time
+ *    to prevent server-side file reads and SSRF.
+ *  - Template expressions ({{ expr }}) are evaluated by posthtml-expressions
+ *    with empty `locals`, so unknown identifiers like `process` or `require`
+ *    return the literal string '{local}' rather than accessing Node.js globals.
+ *  - A hard timeout prevents pathological PostCSS/Tailwind inputs from
+ *    hanging indefinitely.
+ *
+ * Requires peer dependency: @maizzle/framework
+ */
+declare function compileMaizzle(source: string): Promise<string>;
+
+/**
+ * Compile source to HTML based on format.
+ * Returns the HTML unchanged if format is "html".
+ * Lazily imports per-format compilers to avoid loading unnecessary deps.
+ */
+declare function compile(source: string, format: InputFormat, filePath?: string): Promise<string>;
+/**
+ * Auto-detect input format from file extension.
+ */
+declare function detectFormat(filePath: string): InputFormat;
+
+export { compile, compileMaizzle, compileMjml, detectFormat };

package/dist/compile/index.js

@@ -0,0 +1,59 @@
+import {
+  compileReactEmail
+} from "../chunk-LW2IMTBA.js";
+import {
+  compileMjml
+} from "../chunk-W4SPWESS.js";
+import {
+  compileMaizzle
+} from "../chunk-SZ5O5PDZ.js";
+import {
+  CompileError
+} from "../chunk-PFONR3YC.js";
+
+// src/compile/index.ts
+import { extname } from "path";
+async function compile(source, format, filePath) {
+  switch (format) {
+    case "html":
+      return source;
+    case "jsx": {
+      const { compileReactEmail: compileReactEmail2 } = await import("../react-email-AN62KVVF.js");
+      return compileReactEmail2(source);
+    }
+    case "mjml": {
+      const { compileMjml: compileMjml2 } = await import("../mjml-IYGC6AOM.js");
+      return compileMjml2(source);
+    }
+    case "maizzle": {
+      const { compileMaizzle: compileMaizzle2 } = await import("../maizzle-YDSYDVSM.js");
+      return compileMaizzle2(source);
+    }
+    default:
+      throw new Error(`Unknown format: "${format}". Use html, jsx, mjml, or maizzle.`);
+  }
+}
+function detectFormat(filePath) {
+  const ext = extname(filePath).toLowerCase();
+  switch (ext) {
+    case ".tsx":
+    case ".jsx":
+      return "jsx";
+    case ".mjml":
+      return "mjml";
+    case ".html":
+    case ".htm":
+      return "html";
+    default:
+      return "html";
+  }
+}
+export {
+  CompileError,
+  compile,
+  compileMaizzle,
+  compileMjml,
+  compileReactEmail,
+  detectFormat
+};
+//# sourceMappingURL=index.js.map

package/dist/compile/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/compile/index.ts"],"sourcesContent":["import { extname } from \"node:path\";\r\nimport type { InputFormat } from \"../types.js\";\r\n\r\nexport { CompileError } from \"./errors.js\";\r\nexport { compileReactEmail } from \"./react-email.js\";\r\nexport type { SandboxStrategy, CompileReactEmailOptions } from \"./react-email.js\";\r\nexport { compileMjml } from \"./mjml.js\";\r\nexport { compileMaizzle } from \"./maizzle.js\";\r\n\r\n/**\r\n * Compile source to HTML based on format.\r\n * Returns the HTML unchanged if format is \"html\".\r\n * Lazily imports per-format compilers to avoid loading unnecessary deps.\r\n */\r\nexport async function compile(\r\n  source: string,\r\n  format: InputFormat,\r\n  filePath?: string,\r\n): Promise<string> {\r\n  switch (format) {\r\n    case \"html\":\r\n      return source;\r\n\r\n    case \"jsx\": {\r\n      const { compileReactEmail } = await import(\"./react-email.js\");\r\n      return compileReactEmail(source);\r\n    }\r\n\r\n    case \"mjml\": {\r\n      const { compileMjml } = await import(\"./mjml.js\");\r\n      return compileMjml(source);\r\n    }\r\n\r\n    case \"maizzle\": {\r\n      const { compileMaizzle } = await import(\"./maizzle.js\");\r\n      return compileMaizzle(source);\r\n    }\r\n\r\n    default:\r\n      throw new Error(`Unknown format: \"${format}\". Use html, jsx, mjml, or maizzle.`);\r\n  }\r\n}\r\n\r\n/**\r\n * Auto-detect input format from file extension.\r\n */\r\nexport function detectFormat(filePath: string): InputFormat {\r\n  const ext = extname(filePath).toLowerCase();\r\n\r\n  switch (ext) {\r\n    case \".tsx\":\r\n    case \".jsx\":\r\n      return \"jsx\";\r\n    case \".mjml\":\r\n      return \"mjml\";\r\n    case \".html\":\r\n    case \".htm\":\r\n      return \"html\";\r\n    default:\r\n      return \"html\";\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;AAAA,SAAS,eAAe;AAcxB,eAAsB,QACpB,QACA,QACA,UACiB;AACjB,UAAQ,QAAQ;AAAA,IACd,KAAK;AACH,aAAO;AAAA,IAET,KAAK,OAAO;AACV,YAAM,EAAE,mBAAAA,mBAAkB,IAAI,MAAM,OAAO,4BAAkB;AAC7D,aAAOA,mBAAkB,MAAM;AAAA,IACjC;AAAA,IAEA,KAAK,QAAQ;AACX,YAAM,EAAE,aAAAC,aAAY,IAAI,MAAM,OAAO,qBAAW;AAChD,aAAOA,aAAY,MAAM;AAAA,IAC3B;AAAA,IAEA,KAAK,WAAW;AACd,YAAM,EAAE,gBAAAC,gBAAe,IAAI,MAAM,OAAO,wBAAc;AACtD,aAAOA,gBAAe,MAAM;AAAA,IAC9B;AAAA,IAEA;AACE,YAAM,IAAI,MAAM,oBAAoB,MAAM,qCAAqC;AAAA,EACnF;AACF;AAKO,SAAS,aAAa,UAA+B;AAC1D,QAAM,MAAM,QAAQ,QAAQ,EAAE,YAAY;AAE1C,UAAQ,KAAK;AAAA,IACX,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;","names":["compileReactEmail","compileMjml","compileMaizzle"]}