@marlinjai/email-editor-core 0.3.0 → 0.4.0

package/dist/browser.mjs

@@ -0,0 +1,30 @@
+import {
+  EDITOR_MARKER,
+  MjmlBuilder,
+  mjmlOptions,
+  stripEditorMarkup
+} from "./chunk-OOCYGZMB.mjs";
+
+// src/browser.ts
+import mjml2html from "mjml-browser";
+var builder = new MjmlBuilder();
+async function compileInBrowser(template, options = {}) {
+  try {
+    const mjml = builder.toMJML(template, { editor: options.editor });
+    const result = await mjml2html(mjml, mjmlOptions(options));
+    return {
+      mjml,
+      html: result.html,
+      errors: result.errors.length > 0 ? result.errors.map((e) => e.formattedMessage) : void 0
+    };
+  } catch (error) {
+    return { mjml: "", html: "", errors: [error instanceof Error ? error.message : "Unknown compilation error"] };
+  }
+}
+export {
+  EDITOR_MARKER,
+  MjmlBuilder,
+  compileInBrowser,
+  mjmlOptions,
+  stripEditorMarkup
+};

package/dist/chunk-NQPMHQ5G.mjs

@@ -0,0 +1,490 @@
+// src/schema/validation.ts
+import { z } from "zod";
+var SpacingSchema = z.object({
+  top: z.string().optional(),
+  right: z.string().optional(),
+  bottom: z.string().optional(),
+  left: z.string().optional()
+});
+var GradientStopSchema = z.object({
+  color: z.string().min(1),
+  position: z.number().min(0).max(100)
+});
+var BackgroundGradientSchema = z.object({
+  type: z.enum(["linear", "radial"]),
+  angle: z.number().min(0).max(360),
+  stops: z.array(GradientStopSchema).min(1)
+});
+var ExtraAttributesSchema = z.record(z.string().regex(/^[a-z][a-z0-9-]*$/), z.string());
+var MjmlHeadSchema = z.object({
+  attributes: z.string().optional(),
+  bodyAttributes: ExtraAttributesSchema.optional(),
+  headRaw: z.string().optional()
+});
+var CustomFontSchema = z.object({
+  name: z.string(),
+  href: z.string()
+});
+var TemplateMetadataSchema = z.object({
+  name: z.string().optional(),
+  subject: z.string().optional(),
+  previewText: z.string().optional(),
+  title: z.string().optional(),
+  // Epoch milliseconds (what the editor's store emits) or an ISO 8601 string.
+  createdAt: z.union([z.string(), z.number()]).optional(),
+  updatedAt: z.union([z.string(), z.number()]).optional(),
+  // Head component settings
+  fonts: z.array(CustomFontSchema).optional(),
+  breakpoint: z.string().optional(),
+  customCSS: z.string().optional(),
+  inlineCSS: z.string().optional(),
+  mjmlHead: MjmlHeadSchema.optional()
+});
+var TextBlockSchema = z.object({
+  id: z.string(),
+  type: z.literal("text"),
+  hidden: z.boolean().optional(),
+  extraAttributes: ExtraAttributesSchema.optional(),
+  content: z.string(),
+  align: z.enum(["left", "center", "right", "justify"]).optional(),
+  color: z.string().optional(),
+  fontSize: z.string().optional(),
+  fontFamily: z.string().optional(),
+  padding: SpacingSchema.optional(),
+  lineHeight: z.string().optional()
+});
+var ImageBlockSchema = z.object({
+  id: z.string(),
+  type: z.literal("image"),
+  hidden: z.boolean().optional(),
+  extraAttributes: ExtraAttributesSchema.optional(),
+  src: z.string().min(1),
+  // Allow any non-empty string, not just URLs
+  alt: z.string().optional(),
+  width: z.string().optional(),
+  height: z.string().optional(),
+  align: z.enum(["left", "center", "right"]).optional(),
+  href: z.string().optional(),
+  // Allow any string for link
+  padding: SpacingSchema.optional(),
+  borderRadius: z.string().optional()
+  // Rounded corners
+});
+var ButtonBlockSchema = z.object({
+  id: z.string(),
+  type: z.literal("button"),
+  hidden: z.boolean().optional(),
+  extraAttributes: ExtraAttributesSchema.optional(),
+  label: z.string().min(1),
+  href: z.string().min(1),
+  // Allow any non-empty string
+  align: z.enum(["left", "center", "right"]).optional(),
+  backgroundColor: z.string().optional(),
+  color: z.string().optional(),
+  borderRadius: z.string().optional(),
+  border: z.string().optional(),
+  // CSS border shorthand
+  padding: SpacingSchema.optional(),
+  innerPadding: z.string().optional()
+});
+var DividerBlockSchema = z.object({
+  id: z.string(),
+  type: z.literal("divider"),
+  hidden: z.boolean().optional(),
+  extraAttributes: ExtraAttributesSchema.optional(),
+  borderColor: z.string().optional(),
+  borderWidth: z.string().optional(),
+  borderStyle: z.enum(["solid", "dashed", "dotted"]).optional(),
+  width: z.string().optional(),
+  // Width of the divider line
+  padding: SpacingSchema.optional()
+});
+var SpacerBlockSchema = z.object({
+  id: z.string(),
+  type: z.literal("spacer"),
+  hidden: z.boolean().optional(),
+  extraAttributes: ExtraAttributesSchema.optional(),
+  height: z.string()
+});
+var HeaderBlockSchema = z.object({
+  id: z.string(),
+  type: z.literal("header"),
+  hidden: z.boolean().optional(),
+  extraAttributes: ExtraAttributesSchema.optional(),
+  locked: z.literal(true)
+});
+var FooterBlockSchema = z.object({
+  id: z.string(),
+  type: z.literal("footer"),
+  hidden: z.boolean().optional(),
+  extraAttributes: ExtraAttributesSchema.optional(),
+  locked: z.literal(true)
+});
+var SocialBlockSchema = z.object({
+  id: z.string(),
+  type: z.literal("social"),
+  hidden: z.boolean().optional(),
+  extraAttributes: ExtraAttributesSchema.optional(),
+  mode: z.enum(["horizontal", "vertical"]).optional(),
+  align: z.enum(["left", "center", "right"]).optional(),
+  iconSize: z.string().optional(),
+  iconPadding: z.string().optional(),
+  borderRadius: z.string().optional(),
+  // For round icons
+  links: z.array(
+    z.object({
+      platform: z.enum(["facebook", "twitter", "instagram", "linkedin", "youtube", "pinterest", "github"]),
+      url: z.string(),
+      color: z.string().optional()
+      // Per-icon color override (uses platform default if not set)
+    })
+  )
+});
+var HeroBlockSchema = z.object({
+  id: z.string(),
+  type: z.literal("hero"),
+  hidden: z.boolean().optional(),
+  extraAttributes: ExtraAttributesSchema.optional(),
+  backgroundImage: z.string().min(1),
+  backgroundHeight: z.string().optional(),
+  backgroundWidth: z.string().optional(),
+  backgroundColor: z.string().optional(),
+  verticalAlign: z.enum(["top", "middle", "bottom"]).optional(),
+  mode: z.enum(["fluid-height", "fixed-height"]).optional()
+});
+var AccordionBlockSchema = z.object({
+  id: z.string(),
+  type: z.literal("accordion"),
+  hidden: z.boolean().optional(),
+  extraAttributes: ExtraAttributesSchema.optional(),
+  items: z.array(
+    z.object({
+      title: z.string(),
+      content: z.string()
+    })
+  ),
+  iconPosition: z.enum(["left", "right"]).optional(),
+  borderColor: z.string().optional(),
+  fontFamily: z.string().optional()
+});
+var RawBlockSchema = z.object({
+  id: z.string(),
+  type: z.literal("raw"),
+  hidden: z.boolean().optional(),
+  extraAttributes: ExtraAttributesSchema.optional(),
+  html: z.string()
+});
+var NavbarBlockSchema = z.object({
+  id: z.string(),
+  type: z.literal("navbar"),
+  hidden: z.boolean().optional(),
+  extraAttributes: ExtraAttributesSchema.optional(),
+  links: z.array(
+    z.object({
+      label: z.string(),
+      href: z.string(),
+      color: z.string().optional()
+    })
+  ),
+  hamburger: z.boolean().optional(),
+  baseUrl: z.string().optional(),
+  align: z.enum(["left", "center", "right"]).optional(),
+  icoColor: z.string().optional(),
+  padding: SpacingSchema.optional()
+});
+var CarouselBlockSchema = z.object({
+  id: z.string(),
+  type: z.literal("carousel"),
+  hidden: z.boolean().optional(),
+  extraAttributes: ExtraAttributesSchema.optional(),
+  images: z.array(
+    z.object({
+      src: z.string(),
+      alt: z.string().optional(),
+      href: z.string().optional(),
+      thumbnailSrc: z.string().optional()
+    })
+  ),
+  thumbnails: z.enum(["visible", "hidden"]).optional(),
+  borderRadius: z.string().optional(),
+  iconWidth: z.string().optional(),
+  tbBorderRadius: z.string().optional(),
+  padding: SpacingSchema.optional()
+});
+var TableBlockSchema = z.object({
+  id: z.string(),
+  type: z.literal("table"),
+  hidden: z.boolean().optional(),
+  extraAttributes: ExtraAttributesSchema.optional(),
+  headers: z.array(z.string()),
+  rows: z.array(z.array(z.string())),
+  align: z.enum(["left", "center", "right"]).optional(),
+  color: z.string().optional(),
+  fontFamily: z.string().optional(),
+  fontSize: z.string().optional(),
+  cellpadding: z.string().optional(),
+  cellspacing: z.string().optional(),
+  border: z.string().optional(),
+  padding: SpacingSchema.optional()
+});
+var BlockSchema = z.discriminatedUnion("type", [
+  TextBlockSchema,
+  ImageBlockSchema,
+  ButtonBlockSchema,
+  DividerBlockSchema,
+  SpacerBlockSchema,
+  HeaderBlockSchema,
+  FooterBlockSchema,
+  SocialBlockSchema,
+  HeroBlockSchema,
+  AccordionBlockSchema,
+  RawBlockSchema,
+  NavbarBlockSchema,
+  CarouselBlockSchema,
+  TableBlockSchema
+]);
+var ColumnSchema = z.object({
+  id: z.string(),
+  width: z.number().min(0).max(100).optional(),
+  backgroundColor: z.string().optional(),
+  backgroundGradient: BackgroundGradientSchema.optional(),
+  padding: SpacingSchema.optional(),
+  verticalAlign: z.enum(["top", "middle", "bottom"]).optional(),
+  // Vertical content alignment
+  hidden: z.boolean().optional(),
+  extraAttributes: ExtraAttributesSchema.optional(),
+  blocks: z.array(BlockSchema)
+});
+var sectionFields = {
+  id: z.string(),
+  type: z.literal("section"),
+  backgroundColor: z.string().optional(),
+  backgroundImage: z.string().optional(),
+  backgroundPosition: z.string().optional(),
+  backgroundRepeat: z.enum(["repeat", "no-repeat"]).optional(),
+  backgroundSize: z.string().optional(),
+  backgroundGradient: BackgroundGradientSchema.optional(),
+  padding: SpacingSchema.optional(),
+  noStack: z.boolean().optional(),
+  fullWidth: z.boolean().optional(),
+  hidden: z.boolean().optional(),
+  extraAttributes: ExtraAttributesSchema.optional(),
+  bodyRaw: z.boolean().optional(),
+  columns: z.array(ColumnSchema).min(1)
+};
+var SectionSchema = z.object({
+  ...sectionFields,
+  isWrapper: z.undefined({ invalid_type_error: "isWrapper is a schema 1.0 field; a 1.1 document holds a wrapper instead" }).optional()
+});
+var SectionSchemaV1_0 = z.object({
+  ...sectionFields,
+  isWrapper: z.boolean().optional()
+});
+var WrapperSchema = z.object({
+  id: z.string(),
+  type: z.literal("wrapper"),
+  hidden: z.boolean().optional(),
+  backgroundColor: z.string().optional(),
+  backgroundImage: z.string().optional(),
+  backgroundGradient: BackgroundGradientSchema.optional(),
+  backgroundPosition: z.string().optional(),
+  backgroundRepeat: z.enum(["repeat", "no-repeat"]).optional(),
+  backgroundSize: z.string().optional(),
+  border: z.string().optional(),
+  borderTop: z.string().optional(),
+  borderRight: z.string().optional(),
+  borderBottom: z.string().optional(),
+  borderLeft: z.string().optional(),
+  borderRadius: z.string().optional(),
+  padding: SpacingSchema.optional(),
+  fullWidth: z.boolean().optional(),
+  cssClass: z.string().optional(),
+  gap: z.string().regex(/^[0-9]+(\.[0-9]+)?px$/, "gap is a length in px, e.g. 16px").optional(),
+  textAlign: z.enum(["left", "center", "right"]).optional(),
+  extraAttributes: ExtraAttributesSchema.optional(),
+  sections: z.array(SectionSchema)
+});
+var TopLevelItemSchema = z.discriminatedUnion("type", [SectionSchema, WrapperSchema]);
+var EmailTemplateSchemaV1_0 = z.object({
+  id: z.string().optional(),
+  version: z.literal("1.0"),
+  metadata: TemplateMetadataSchema,
+  sections: z.array(SectionSchemaV1_0)
+});
+var EmailTemplateSchemaV1_1 = z.object({
+  id: z.string().optional(),
+  version: z.literal("1.1"),
+  metadata: TemplateMetadataSchema,
+  sections: z.array(TopLevelItemSchema)
+});
+var EmailTemplateSchema = z.discriminatedUnion("version", [EmailTemplateSchemaV1_0, EmailTemplateSchemaV1_1]);
+function validateTemplate(template) {
+  return EmailTemplateSchema.safeParse(template);
+}
+
+// src/schema/migrate.ts
+import { nanoid } from "nanoid";
+var CURRENT_TEMPLATE_VERSION = "1.1";
+var SUPPORTED_TEMPLATE_VERSIONS = ["1.0", CURRENT_TEMPLATE_VERSION];
+var TemplateMigrationError = class extends Error {
+  constructor(code, message, options = {}) {
+    super(message);
+    this.name = "TemplateMigrationError";
+    this.code = code;
+    this.version = options.version;
+    this.issues = options.issues ?? [];
+  }
+};
+function isTemplateMigrationError(error) {
+  return error instanceof TemplateMigrationError;
+}
+function parseVersion(version) {
+  const match = /^(\d+)\.(\d+)$/.exec(version);
+  if (!match) return null;
+  return [Number(match[1]), Number(match[2])];
+}
+function compareVersions(a, b) {
+  return a[0] !== b[0] ? a[0] - b[0] : a[1] - b[1];
+}
+function migrateTemplate(doc) {
+  if (typeof doc !== "object" || doc === null || Array.isArray(doc)) {
+    throw new TemplateMigrationError(
+      "INVALID_INPUT",
+      `Expected a template document object, received ${doc === null ? "null" : Array.isArray(doc) ? "an array" : typeof doc}.`
+    );
+  }
+  const version = doc.version;
+  if (typeof version !== "string" || version.length === 0) {
+    throw new TemplateMigrationError(
+      "MISSING_VERSION",
+      'The template document has no "version" field, so its schema cannot be determined.'
+    );
+  }
+  const parsed = parseVersion(version);
+  if (!parsed) {
+    throw new TemplateMigrationError(
+      "UNSUPPORTED_VERSION",
+      `Template schema version "${version}" is not of the form "major.minor".`,
+      { version }
+    );
+  }
+  const current = parseVersion(CURRENT_TEMPLATE_VERSION);
+  if (compareVersions(parsed, current) > 0) {
+    throw new TemplateMigrationError(
+      "NEWER_VERSION",
+      `Template schema version "${version}" is newer than this editor supports (${CURRENT_TEMPLATE_VERSION}). Upgrade the @marlinjai/email-editor packages to open it.`,
+      { version }
+    );
+  }
+  if (!SUPPORTED_TEMPLATE_VERSIONS.includes(version)) {
+    throw new TemplateMigrationError(
+      "UNSUPPORTED_VERSION",
+      `Template schema version "${version}" is not supported and has no migration to ${CURRENT_TEMPLATE_VERSION}.`,
+      { version }
+    );
+  }
+  let next = doc;
+  if (version === "1.0") {
+    assertValid(EmailTemplateSchemaV1_0, next, version);
+    next = migrateV1_0ToV1_1(next);
+  }
+  assertValid(EmailTemplateSchemaV1_1, next, version);
+  return next;
+}
+function assertValid(schema, doc, version) {
+  const result = schema.safeParse(doc);
+  if (result.success) return;
+  const issues = result.error.issues.map((issue) => ({ path: issue.path, message: issue.message }));
+  const first = issues[0];
+  throw new TemplateMigrationError(
+    "INVALID_DOCUMENT",
+    `Template document does not match schema version ${version}: ${first ? `${first.path.join(".") || "(root)"}: ${first.message}` : "unknown validation error"}${issues.length > 1 ? ` (and ${issues.length - 1} more)` : ""}.`,
+    { version, issues }
+  );
+}
+function migrateV1_0ToV1_1(doc) {
+  if (!doc.sections.some((s) => s.isWrapper === true && !s.bodyRaw)) {
+    return { ...doc, version: "1.1", sections: doc.sections.map(stripIsWrapper) };
+  }
+  const ids = /* @__PURE__ */ new Set();
+  for (const s of doc.sections) {
+    ids.add(s.id);
+    for (const c of s.columns ?? []) {
+      ids.add(c.id);
+      for (const b of c.blocks ?? []) ids.add(b.id);
+    }
+  }
+  const freshId = (base) => {
+    let candidate = `${base}-inner`;
+    for (let n = 2; ids.has(candidate); n++) candidate = `${base}-inner-${n}`;
+    ids.add(candidate);
+    return candidate;
+  };
+  const sections = doc.sections.map((s) => {
+    if (s.isWrapper !== true || s.bodyRaw) return stripIsWrapper(s);
+    const { isWrapper: _flag, noStack: _noStack, ...rest } = s;
+    const wrapper = { id: s.id, type: "wrapper", sections: [{ id: freshId(s.id), type: "section", columns: s.columns }] };
+    if (rest.hidden !== void 0) wrapper.hidden = rest.hidden;
+    if (rest.backgroundColor !== void 0) wrapper.backgroundColor = rest.backgroundColor;
+    if (rest.backgroundImage !== void 0) wrapper.backgroundImage = rest.backgroundImage;
+    if (rest.backgroundGradient !== void 0) wrapper.backgroundGradient = rest.backgroundGradient;
+    if (rest.backgroundPosition !== void 0) wrapper.backgroundPosition = rest.backgroundPosition;
+    if (rest.backgroundRepeat !== void 0) wrapper.backgroundRepeat = rest.backgroundRepeat;
+    if (rest.backgroundSize !== void 0) wrapper.backgroundSize = rest.backgroundSize;
+    if (rest.fullWidth !== void 0) wrapper.fullWidth = rest.fullWidth;
+    if (rest.padding !== void 0) wrapper.padding = rest.padding;
+    if (rest.extraAttributes !== void 0) wrapper.extraAttributes = rest.extraAttributes;
+    return wrapper;
+  });
+  return { ...doc, version: "1.1", sections };
+}
+function stripIsWrapper(s) {
+  if (!("isWrapper" in s)) return s;
+  const { isWrapper: _flag, ...rest } = s;
+  return rest;
+}
+function withTemplateId(doc) {
+  if (typeof doc.id === "string" && doc.id.length > 0) return doc;
+  return { ...doc, id: nanoid() };
+}
+
+export {
+  SpacingSchema,
+  GradientStopSchema,
+  BackgroundGradientSchema,
+  ExtraAttributesSchema,
+  MjmlHeadSchema,
+  CustomFontSchema,
+  TemplateMetadataSchema,
+  TextBlockSchema,
+  ImageBlockSchema,
+  ButtonBlockSchema,
+  DividerBlockSchema,
+  SpacerBlockSchema,
+  HeaderBlockSchema,
+  FooterBlockSchema,
+  SocialBlockSchema,
+  HeroBlockSchema,
+  AccordionBlockSchema,
+  RawBlockSchema,
+  NavbarBlockSchema,
+  CarouselBlockSchema,
+  TableBlockSchema,
+  BlockSchema,
+  ColumnSchema,
+  SectionSchema,
+  SectionSchemaV1_0,
+  WrapperSchema,
+  TopLevelItemSchema,
+  EmailTemplateSchemaV1_0,
+  EmailTemplateSchemaV1_1,
+  EmailTemplateSchema,
+  validateTemplate,
+  CURRENT_TEMPLATE_VERSION,
+  SUPPORTED_TEMPLATE_VERSIONS,
+  TemplateMigrationError,
+  isTemplateMigrationError,
+  migrateTemplate,
+  migrateV1_0ToV1_1,
+  withTemplateId
+};