best-email-builder 0.5.0 → 0.6.0

package/dist/{chunk-MPX5CWTZ.js → chunk-NZIQF7IW.js}

@@ -1,22 +1,28 @@
 import {
   LONGHAND_SPACING,
+  MJML_DEFAULTS,
   SIDES,
   parseSpacing
-} from "./chunk-2RZHGAH5.js";
+} from "./chunk-OWVXKMLI.js";
 import {
   isSafeUrl,
   validateMjml
-} from "./chunk-5SASKCUC.js";
+} from "./chunk-W424KPCR.js";
 import {
   DEFAULT_VARIABLES,
   FONT_OPTIONS,
   PALETTE,
   applyBrand,
   cleanBrand,
+  contrastRatio,
+  createId,
   createNode,
+  parseColor,
   parseMjml,
+  parseMjmlFragment,
+  readableOn,
   serializeMjml
-} from "./chunk-DFNHICTF.js";
+} from "./chunk-JI36FNWE.js";
 
 // src/ai/draft.js
 var GENERATION_ERRORS = {
@@ -113,6 +119,11 @@ function cleanAttributes(node, keepImages) {
     if (unitless && (PIXEL_ATTRIBUTES.has(name) || /^padding-/.test(name))) attributes[name] = `${value.trim()}px`;
   }
   if (node.tag === "mj-image" && attributes.src !== void 0 && !keepImages.has(attributes.src.trim())) attributes.src = "";
+  if (node.tag === "mj-button") {
+    const fill = attributes["background-color"] ?? MJML_DEFAULTS["mj-button"]["background-color"];
+    const words = attributes.color ?? MJML_DEFAULTS["mj-button"].color;
+    if (parseColor(fill) && parseColor(words) && contrastRatio(fill, words) < 3) attributes.color = readableOn(fill);
+  }
   delete attributes["background-url"];
   return attributes;
 }
@@ -133,6 +144,30 @@ function wrapLoose(children, isLoose, wrap) {
   flush();
   return out;
 }
+var MJML_IN_HTML = /<mj-image\b(?:[^>"']|"[^"]*"|'[^']*')*?(?:\/>|>[\s\S]*?<\/mj-image\s*>)|<\/?mj-[a-z-]*\b(?:[^>"']|"[^"]*"|'[^']*')*>/gi;
+function liftImages(node, attributes, keepImages) {
+  const content = String(node.content);
+  const parts = [];
+  let text2 = "";
+  const flush = () => {
+    if (text2.replace(/<[^>]*>|&nbsp;|\s/g, "")) {
+      parts.push({ ...node, id: parts.length ? createId() : node.id, attributes, content: text2.trim() });
+    }
+    text2 = "";
+  };
+  let last = 0;
+  for (const match of content.matchAll(MJML_IN_HTML)) {
+    text2 += content.slice(last, match.index);
+    last = (match.index ?? 0) + match[0].length;
+    const image = /^<mj-image\b/i.test(match[0]) && parseMjmlFragment(match[0]).find((child) => child.tag === "mj-image");
+    if (!image) continue;
+    flush();
+    parts.push(...cleanNode(image, keepImages));
+  }
+  text2 += content.slice(last);
+  flush();
+  return parts;
+}
 function cleanNode(node, keepImages) {
   if (REMOVED_TAGS.has(node.tag)) return [];
   const children = node.children.flatMap((child) => cleanNode(child, keepImages));
@@ -156,6 +191,10 @@ function cleanNode(node, keepImages) {
     const wrapped = wrapLoose(sectioned, (child) => CONTENT_TAGS.has(child.tag), (nodes) => whiteSection([column(nodes)]));
     return [{ ...node, attributes: { "background-color": PALETTE.canvas, ...attributes, width: "600px" }, children: wrapped }];
   }
+  if (typeof node.content === "string" && /<\/?mj-/i.test(node.content)) {
+    if (node.tag === "mj-text") return liftImages(node, attributes, keepImages);
+    return [{ ...node, attributes, children, content: node.content.replace(MJML_IN_HTML, "") }];
+  }
   return [{ ...node, attributes, children }];
 }
 var placeholderOf = (key) => `[${key.replace(/[._]+/g, " ").trim()}]`;
@@ -173,6 +212,21 @@ function normalizeGeneratedMjml(mjml, { variables = [], keepImages = [] } = {})
   const known = /* @__PURE__ */ new Set(["unsubscribe", ...variables.map((variable) => variable.key)]);
   return replaceUnknownVariables(serializeMjml(root), known);
 }
+function withoutIllegalAttributes(mjml, warnings) {
+  const illegal = /* @__PURE__ */ new Map();
+  for (const warning of warnings) {
+    const name = /Attribute ([\w-]+) is illegal/.exec(warning.message)?.[1];
+    const tag = warning.tagName || /\((mj-[\w-]+)\)/.exec(warning.message)?.[1];
+    if (name && tag) illegal.set(tag, /* @__PURE__ */ new Set([...illegal.get(tag) || [], name]));
+  }
+  if (!illegal.size) return null;
+  const strip = (node) => {
+    const names = illegal.get(node.tag);
+    const attributes = names ? Object.fromEntries(Object.entries(node.attributes).filter(([name]) => !names.has(name))) : node.attributes;
+    return { ...node, attributes, children: node.children.map(strip) };
+  };
+  return serializeMjml(strip(parseMjml(mjml)));
+}
 function reviewDraft(draft, { kind = "marketing", compileWarnings = [] } = {}) {
   const blocking = validateMjml(draft.mjml).issues.map((issue) => issue.message);
   const advice = [];
@@ -241,7 +295,7 @@ Return one JSON object, nothing else: {"name": string, "subject": string, "prehe
 
 # Copy
 - Write the real email for the purpose and the details given: specific, useful, warm and concise. Never lorem ipsum, never meta comments.
-- Personalize with the variables listed in the request, written exactly as {{key}}. A greeting gives the first name a natural default after a pipe, in the email's language, used when the name is unknown: Hello {{contact.firstname|there}},. Use no other {{...}} variable.
+- Personalize with the variables listed in the request, written exactly as {{key}}. A greeting gives the first name a natural default after a pipe, used when the name is unknown; the greeting and its default are in the email's language: Hello {{contact.firstname|there}}, in English, Bonjour {{contact.firstname|\xE0 vous}}, in French, \u0412\u0456\u0442\u0430\u0454\u043C\u043E, {{contact.firstname|\u0434\u0440\u0443\u0436\u0435}}! in Ukrainian. Use no other {{...}} variable.
 - Information that is not given and not in the variables (an order number, a date, a price, a code, an address) is written as a short placeholder in square brackets that the user will replace: [order number], [date], [20%]. Never invent facts that would be wrong.
 - Links read as what they do ("Reset my password", "See the collection"), never "click here".
 - The footer (last section): the sender's name and postal address (or [Company address]) in 12px #6d7484 text, centered, and the footer line the request asks for. The unsubscribe link is exactly <a href="{{ unsubscribe }}" style="color:#6d7484;text-decoration:underline;">...</a>.
@@ -1330,7 +1384,10 @@ var fr = {
   "Free models, with a free account": "Mod\xE8les gratuits, avec un compte gratuit",
   "Free tier, with rate limits": "Offre gratuite, avec des limites de d\xE9bit",
   'Free "Experiment" plan': "Offre gratuite \xAB Experiment \xBB",
-  "Runs on your own machine": "Tourne sur votre propre machine"
+  "Runs on your own machine": "Tourne sur votre propre machine",
+  "AI provider": "Fournisseur d'IA",
+  "Key saved": "Cl\xE9 enregistr\xE9e",
+  "A key for {provider} is saved in this browser: Connect uses it, or paste another one.": "Une cl\xE9 {provider} est enregistr\xE9e dans ce navigateur : Connecter l'utilise, ou collez-en une autre."
 };
 
 // src/ai/i18n/index.js
@@ -1385,7 +1442,12 @@ function createEmailGenerator({ model, maxAttempts = 2, compile } = (
         const draft = parseDraft(answer);
         draft.mjml = normalizeGeneratedMjml(draft.mjml, { variables: request.variables, keepImages });
         draft.mjml = applyBrand(draft.mjml, request.brand);
-        const compileWarnings = compile ? (await compile(draft.mjml)).warnings || [] : [];
+        let compileWarnings = compile ? (await compile(draft.mjml)).warnings || [] : [];
+        const legal = withoutIllegalAttributes(draft.mjml, compileWarnings);
+        if (legal && compile) {
+          draft.mjml = legal;
+          compileWarnings = (await compile(draft.mjml)).warnings || [];
+        }
         const { blocking, advice } = reviewDraft(draft, { kind, compileWarnings });
         if (!blocking.length) {
           usable = { ...draft, warnings: advice, attempts: attempt };
@@ -1412,18 +1474,24 @@ function createEmailGenerator({ model, maxAttempts = 2, compile } = (
 }
 
 // src/ai/providers.js
-var define = (provider) => Object.freeze({ format: "json_schema", tokens: "max_tokens", ...provider });
+var define = (provider) => Object.freeze({ format: "json_schema", tokens: "max_tokens", maxTokens: 16e3, ...provider });
 var AI_PROVIDERS = Object.freeze({
   openrouter: define({
     id: "openrouter",
     name: "OpenRouter",
     baseUrl: "https://openrouter.ai/api/v1",
-    // A router across the free models of the day.
+    // A router across the free models of the day — a name that lasts, where
+    // the free models themselves come and go (and an unknown one is a 400).
     model: "openrouter/free",
     keyUrl: "https://openrouter.ai/keys",
     keyHint: "sk-or-",
     free: "Free models, with a free account",
-    headers: { "X-Title": "Best Email Builder" }
+    headers: { "X-Title": "Best Email Builder" },
+    // Most free models reason before they answer: 5 000 to 12 000 tokens
+    // before the email itself, which a limit of 16 000 cut short. Less
+    // reasoning where the model lets it be chosen.
+    maxTokens: 32e3,
+    body: { reasoning: { effort: "low" } }
   }),
   openai: define({
     id: "openai",
@@ -1531,6 +1599,31 @@ function responseFormat(format, schema, task) {
   return void 0;
 }
 var formatRefused = (status, text2) => (status === 400 || status === 422) && /response_format|json_schema|json_object|structured|schema|grammar/i.test(text2);
+function errorMessage(text2) {
+  try {
+    const data = JSON.parse(text2);
+    const error = Array.isArray(data) ? data[0]?.error : data?.error;
+    return String(error?.metadata?.raw || error?.message || text2);
+  } catch {
+    return text2;
+  }
+}
+function refusal(status, message) {
+  if (status === 401) return "KEY_REFUSED";
+  if (status === 400) return /api[ _-]?key not valid|API_KEY_INVALID|invalid[ _-]api[ _-]key/i.test(message) ? "KEY_REFUSED" : null;
+  if (status !== 403) return null;
+  if (/flagged|moderation/i.test(message)) return "REFUSED";
+  if (/credit|limit exceeded|quota/i.test(message)) return "MODEL_CREDITS";
+  if (/\bmodels?\b|harness|region|country|territory|not available|not allowed to (sample|access|use)/i.test(message)) return "MODEL_ERROR";
+  return "KEY_REFUSED";
+}
+function failureCode(status, message) {
+  const refused = refusal(status, message);
+  if (refused) return refused;
+  if (status === 402 || /credit balance|insufficient[ _](quota|credits|balance)|exceeded your current quota/i.test(message)) return "MODEL_CREDITS";
+  if (status === 429 || status === 503 || status === 529) return "MODEL_BUSY";
+  return "MODEL_ERROR";
+}
 function textOf(message) {
   const content = message?.content;
   if (typeof content === "string") return content;
@@ -1538,8 +1631,9 @@ function textOf(message) {
   return "";
 }
 function providerEmailModel(options = {}) {
-  const { apiKey, maxTokens = 16e3, temperature, fetch: fetchImpl } = options;
+  const { apiKey, temperature, fetch: fetchImpl } = options;
   const provider = resolveProvider(options.provider ?? "openai-compatible");
+  const maxTokens = options.maxTokens ?? provider.maxTokens;
   const model = options.model || provider.model;
   const baseUrl = String(options.baseUrl || provider.baseUrl).replace(/\/+$/, "");
   if (!baseUrl) throw new TypeError(`providerEmailModel: ${provider.name} needs a \`baseUrl\``);
@@ -1555,6 +1649,8 @@ function providerEmailModel(options = {}) {
     if (!key && !provider.keyless) throw new EmailGenerationError("KEY_MISSING", `${provider.name}: no key`);
     for (; ; ) {
       const body = {
+        ...provider.body,
+        ...options.body,
         model,
         messages: [{ role: "system", content: system + answerInstruction(schema) }, ...messages],
         [provider.tokens]: maxTokens,
@@ -1587,10 +1683,7 @@ function providerEmailModel(options = {}) {
           continue;
         }
         const detail = `${provider.name} ${response.status}: ${text2.slice(0, 300)}`;
-        if (response.status === 401 || response.status === 403) throw new EmailGenerationError("KEY_REFUSED", detail);
-        if (response.status === 402) throw new EmailGenerationError("MODEL_CREDITS", detail);
-        if (response.status === 429 || response.status === 503 || response.status === 529) throw new EmailGenerationError("MODEL_BUSY", detail);
-        throw new EmailGenerationError("MODEL_ERROR", detail);
+        throw new EmailGenerationError(failureCode(response.status, errorMessage(text2)), detail);
       }
       let data;
       try {
@@ -1601,9 +1694,7 @@ function providerEmailModel(options = {}) {
       if (data?.error) {
         const code = Number(data.error.code) || 0;
         const detail = `${provider.name}: ${data.error.message || JSON.stringify(data.error).slice(0, 300)}`;
-        if (code === 401 || code === 403) throw new EmailGenerationError("KEY_REFUSED", detail);
-        if (code === 429 || code === 503) throw new EmailGenerationError("MODEL_BUSY", detail);
-        throw new EmailGenerationError("MODEL_ERROR", detail);
+        throw new EmailGenerationError(failureCode(code, String(data.error.metadata?.raw || data.error.message || "")), detail);
       }
       const choice = data?.choices?.[0];
       if (choice?.message?.refusal) throw new EmailGenerationError("REFUSED", String(choice.message.refusal));
@@ -1631,16 +1722,32 @@ function claudeEmailModel({
     throw new Error("claudeEmailModel: pass an Anthropic client \u2014 `new Anthropic()` from @anthropic-ai/sdk");
   }
   return async ({ system, messages, schema, signal, task }) => {
-    const message = await client.messages.stream(
-      {
-        model,
-        max_tokens: maxTokens,
-        system,
-        messages,
-        output_config: { effort: task === "rewrite" || task === "subjects" ? rewriteEffort : effort, format: { type: "json_schema", schema } }
-      },
-      { signal }
-    ).finalMessage();
+    let message;
+    try {
+      message = await client.messages.stream(
+        {
+          model,
+          max_tokens: maxTokens,
+          system,
+          messages,
+          output_config: { effort: task === "rewrite" || task === "subjects" ? rewriteEffort : effort, format: { type: "json_schema", schema } }
+        },
+        { signal }
+      ).finalMessage();
+    } catch (error) {
+      const { status, name } = (
+        /** @type {any} */
+        error || {}
+      );
+      if (signal?.aborted || name === "AbortError" || name === "APIUserAbortError" || error instanceof EmailGenerationError) throw error;
+      const text2 = String(
+        /** @type {any} */
+        error?.error?.error?.message || /** @type {any} */
+        error?.message || error
+      );
+      if (typeof status !== "number") throw new EmailGenerationError("MODEL_ERROR", `Claude: ${text2.slice(0, 300)}`);
+      throw new EmailGenerationError(failureCode(status, text2), `Claude ${status}: ${text2.slice(0, 300)}`);
+    }
     if (message.stop_reason === "refusal") {
       throw new EmailGenerationError("REFUSED");
     }
@@ -1650,6 +1757,40 @@ function claudeEmailModel({
     return message.content.filter((block) => block.type === "text").map((block) => block.text).join("");
   };
 }
+function claudeProvider(options) {
+  const { client, ...rest } = options || /** @type {any} */
+  {};
+  if (typeof client !== "function") {
+    throw new TypeError("claudeProvider: `client` is a function that makes the Anthropic client from a key");
+  }
+  return Object.freeze({
+    id: "anthropic",
+    name: "Claude",
+    baseUrl: "https://api.anthropic.com",
+    model: rest.model || DEFAULT_CLAUDE_MODEL,
+    keyUrl: "https://console.anthropic.com/settings/keys",
+    keyHint: "sk-ant-",
+    free: null,
+    format: (
+      /** @type {const} */
+      "json_schema"
+    ),
+    tokens: (
+      /** @type {const} */
+      "max_tokens"
+    ),
+    maxTokens: rest.maxTokens ?? 32e3,
+    createModel: ({ apiKey }) => {
+      let current = null;
+      return async (request) => {
+        const key = String(await apiKey() || "").trim();
+        if (!key) throw new EmailGenerationError("KEY_MISSING", "Claude: no key");
+        if (!current || current.key !== key) current = { key, model: claudeEmailModel({ ...rest, client: await client(key) }) };
+        return current.model(request);
+      };
+    }
+  });
+}
 
 export {
   GENERATION_ERRORS,
@@ -1680,8 +1821,10 @@ export {
   createEmailGenerator,
   AI_PROVIDERS,
   resolveProvider,
+  failureCode,
   providerEmailModel,
   DEFAULT_CLAUDE_MODEL,
-  claudeEmailModel
+  claudeEmailModel,
+  claudeProvider
 };
-//# sourceMappingURL=chunk-MPX5CWTZ.js.map
+//# sourceMappingURL=chunk-NZIQF7IW.js.map