@omega.js/backend 0.1.0

package/dist/manager/libraries/email/generators/lib/templates/order.js

@@ -0,0 +1,461 @@
+/**
+ * Order email template — handles ALL order event types in one file.
+ *
+ * Event type comes from data.content.event (e.g. 'confirmation', 'payment-failed', 'cancelled').
+ *
+ * Sections:
+ *   _header()      — emoji + title + subtitle
+ *   _summary()     — product/price/discount/total table
+ *   _details()     — date, provider, frequency, account
+ *   _explanation() — conditional paragraphs (trial, promo, cancellation, etc.)
+ *   _ctaButton()   — dashboard/billing/pricing CTA
+ *   _helpText()    — "Questions? Contact support"
+ */
+const { skeleton, logo, cardWrapper, signoff, footer, escape } = require('./base.js');
+const { resolveTheme, safeUrl } = require('./shared-campaign.js');
+
+const PROVIDER_NAMES = {
+  stripe: 'Stripe',
+  paypal: 'PayPal',
+  chargebee: 'Chargebee',
+  coinbase: 'Crypto',
+};
+
+// Events that show the price summary table
+const SUMMARY_EVENTS = ['confirmation', 'payment-failed', 'payment-recovered', 'trial-ending', 'plan-changed', 'refunded', 'abandoned-cart'];
+
+function build({ data, theme: themeIn, templateName }) {
+  const theme = resolveTheme(themeIn);
+  const brand = data?.brand || {};
+  const email = data?.email || {};
+  const order = data?.content || {};
+  const event = order.event || 'confirmation';
+
+  return skeleton({ subject: email.subject, preview: email.preview, categories: email.categories }, `
+    ${logo(brand, theme)}
+    ${cardWrapper(`
+        ${_header(event, order, data)}
+        ${_summary(event, order, data, theme)}
+        ${_details(event, order, data)}
+        ${_explanation(event, order, data, brand)}
+        ${_ctaButton(event, brand, order)}
+        ${_helpText(brand)}
+        ${signoff(data, theme)}
+    `)}
+    ${footer(brand, email)}
+  `);
+}
+
+// ============================================================
+// Sections
+// ============================================================
+
+function _header(event, order, data) {
+  const name = data?.personalization?.name;
+  const isSubscription = order.type === 'subscription';
+  const isTrial = order.unified?.trial?.claimed;
+
+  const variants = {
+    'confirmation': {
+      emoji: '🎉',
+      title: isSubscription ? 'Your subscription is confirmed!' : 'Your order is confirmed!',
+      subtitle: isSubscription
+        ? `${name ? `Hey ${escape(name)}, thanks` : 'Thanks'} for subscribing. Here's a summary of your order.`
+        : `${name ? `Hey ${escape(name)}, thanks` : 'Thanks'} for your purchase. Here's your receipt.`,
+    },
+    'payment-failed': {
+      emoji: '⚠️',
+      title: 'Payment failed',
+      subtitle: `${name ? `Hey ${escape(name)}, we` : 'We'} were unable to process your payment.`,
+    },
+    'payment-recovered': {
+      emoji: '✅',
+      title: 'Payment successful',
+      subtitle: 'Your payment has been processed and your access has been restored.',
+    },
+    'cancellation-requested': {
+      emoji: '📅',
+      title: 'Cancellation confirmed',
+      subtitle: 'Your subscription has been scheduled for cancellation.',
+    },
+    'cancelled': {
+      emoji: '❌',
+      title: 'Subscription cancelled',
+      subtitle: isTrial
+        ? 'Your free trial has been cancelled.'
+        : 'Your subscription has been cancelled.',
+    },
+    'plan-changed': {
+      emoji: '🔄',
+      title: 'Plan updated',
+      subtitle: 'Your subscription plan has been changed.',
+    },
+    'trial-ending': {
+      emoji: '⏰',
+      title: 'Your free trial is ending soon',
+      subtitle: 'Your trial period is almost over.',
+    },
+    'refunded': {
+      emoji: '💰',
+      title: 'Payment refunded',
+      subtitle: 'Your refund has been processed.',
+    },
+    'abandoned-cart': {
+      emoji: '😲',
+      title: 'You left something behind!',
+      subtitle: 'Your cart is still waiting for you.',
+    },
+  };
+
+  const v = variants[event] || variants['confirmation'];
+
+  return `
+        <mj-text padding="0" align="center">
+          <p style="font-size: 48px; line-height: 1; margin: 0 0 12px;">${v.emoji}</p>
+          <h2 style="font-size: 32px; line-height: 1.2; font-weight: 500; margin: 0 0 8px;">${v.title}</h2>
+          <p style="font-weight: 700; color: #718096; margin: 0 0 8px;">Order #${escape(order.id || '')}</p>
+          <p style="color: #718096; margin: 0 0 0;">${v.subtitle}</p>
+        </mj-text>`;
+}
+
+function _summary(event, order, data, theme) {
+  if (!SUMMARY_EVENTS.includes(event)) {
+    return '';
+  }
+  if (event === 'abandoned-cart') {
+    return _abandonedCartSummary(order, data, theme);
+  }
+  if (event === 'refunded') {
+    return _refundSummary(order, theme);
+  }
+  if (event === 'plan-changed') {
+    return _planChangedSummary(order, data, theme);
+  }
+
+  const unified = order.unified || {};
+  const product = unified.product || {};
+  const payment = unified.payment || {};
+  const computed = order._computed || {};
+  const brandName = data?.brand?.name || '';
+  const isSubscription = order.type === 'subscription';
+
+  const rows = [];
+
+  if (product.name) {
+    // Both kinds name WHAT WAS BOUGHT, and differ only in the line under it.
+    // A one-time receipt used to label its single row `Order #<id>` — the id
+    // the header already prints two lines above — so the one thing a receipt
+    // exists to state, the product, appeared nowhere in the email
+    // ([#668](https://github.com/Omega-JS-Stack/omega/issues/668)).
+    const sublabel = isSubscription ? `Billed ${escape(payment.frequency || '')}` : 'One-time purchase';
+    const label = `<strong>${escape(brandName)} ${escape(product.name)}</strong><br/><span style="color: #888; font-size: 13px;">${sublabel}</span>`;
+    const price = payment.price != null ? `<strong>$${payment.price}</strong>` : '';
+    rows.push(_row(label, price));
+  }
+
+  if (unified.trial?.claimed) {
+    rows.push(_row(
+      '<span style="color: #16a34a;">Free trial discount</span>',
+      `<span style="color: #16a34a;">&minus;$${payment.price || 0}</span>`,
+    ));
+  }
+
+  if (computed.promoCode) {
+    // A code is percent-based or amount-based (the two shapes a provider coupon
+    // comes in) — quote whichever it is, the amount in the same money format the
+    // rows around it use ([#239](https://github.com/Omega-JS-Stack/omega/issues/239))
+    const promoOff = computed.promoPercent != null
+      ? `${computed.promoPercent}% off`
+      : `$${computed.promoAmount} off`;
+
+    rows.push(_row(
+      `<span style="color: #16a34a;">${escape(computed.promoCode)} &ndash; ${promoOff}</span>`,
+      `<span style="color: #16a34a;">&minus;$${computed.promoSavings || '0.00'}</span>`,
+    ));
+  }
+
+  if (computed.totalToday != null) {
+    rows.push(`<tr><td style="padding: 8px 0 4px 0; border-top: 1px solid #e5e7eb;"><strong>Total paid today</strong></td><td style="padding: 8px 0 4px 0; border-top: 1px solid #e5e7eb; text-align: right; white-space: nowrap;"><strong style="font-size: 18px;">$${computed.totalToday}</strong></td></tr>`);
+  }
+
+  if (!rows.length) {
+    return '';
+  }
+
+  return _sectionLabel('SUMMARY') + _tableCard(rows, theme);
+}
+
+function _details(event, order, data) {
+  if (event === 'abandoned-cart') {
+    return '';
+  }
+
+  const computed = order._computed || {};
+  const payment = order.unified?.payment || {};
+  const isSubscription = order.type === 'subscription';
+  const userEmail = data?.personalization?.email || data?.user?.auth?.email || '';
+
+  const rows = [];
+
+  if (computed.date) {
+    rows.push(_detailRow('Date', computed.date));
+  }
+
+  const providerName = PROVIDER_NAMES[order.provider] || PROVIDER_NAMES[payment.provider] || 'Other';
+  rows.push(_detailRow('Payment', providerName));
+
+  if (isSubscription && payment.frequency) {
+    const freq = payment.frequency === 'annually' ? 'Annually'
+      : payment.frequency === 'monthly' ? 'Monthly'
+        : payment.frequency;
+    rows.push(_detailRow('Frequency', freq));
+  }
+
+  if (userEmail) {
+    rows.push(_detailRow('Account', escape(userEmail)));
+  }
+
+  if (event === 'refunded' && computed.refundReason) {
+    rows.push(_detailRow('Reason', escape(computed.refundReason)));
+  }
+
+  if (event === 'cancelled' && computed.expiresDate) {
+    rows.push(_detailRow('Access until', computed.expiresDate));
+  }
+
+  return _sectionLabel('DETAILS') + _tableCard(rows, null);
+}
+
+function _explanation(event, order, data, brand) {
+  const computed = order._computed || {};
+  const payment = order.unified?.payment || {};
+  const isTrial = order.unified?.trial?.claimed;
+  const brandName = brand?.name || '';
+  const brandUrl = brand?.url || '#';
+  const productName = order.unified?.product?.name || '';
+  const promoNote = computed.promoCode ? ' Discount code applies to first payment only.' : '';
+  const chargeAmount = computed.firstChargeAmount || payment.price || '0.00';
+
+  let html = '';
+
+  switch (event) {
+    case 'confirmation':
+      if (order.type === 'subscription') {
+        if (isTrial) {
+          html = `<p style="color: #718096;">Your free trial is active until <strong>${escape(computed.trialExpires || '')}</strong>. You may cancel at any time before then and you will not be charged. After your trial ends, your paid subscription will automatically begin and you will be charged <strong>$${chargeAmount}/${escape(payment.frequency || '')}</strong>.${promoNote}</p>
+          <p style="color: #718096;">If you cancel your subscription during the free trial period, you will be immediately downgraded to a basic account and <strong>lose access to all premium features</strong>. You can <a href="${brandUrl}/dashboard/account#billing">cancel your subscription</a> at any time on our website.</p>`;
+        } else {
+          html = `<p style="color: #718096;">Your subscription to <strong>${escape(brandName)} ${escape(productName)}</strong> is now active. You'll be billed <strong>$${payment.price}/${escape(payment.frequency || '')}</strong> going forward.${promoNote} You can manage or cancel your subscription anytime from your <a href="${brandUrl}/dashboard/account#billing">account</a>.</p>`;
+        }
+      } else {
+        html = `<p style="color: #718096;">Your payment of <strong>$${payment.price || computed.totalToday || '0.00'}</strong> has been processed successfully. You can view your order details and access your purchase from your <a href="${brandUrl}/dashboard/account">account</a>.</p>`;
+      }
+      break;
+
+    case 'payment-failed':
+      // A one-time buyer has no subscription to keep accruing and no payment
+      // method on file to update — telling them otherwise describes somebody
+      // else's account. Both twins send this same event (transitions/one-time/
+      // purchase-failed.js delegates to the subscription one), so the ORDER's
+      // type is what decides which of them the mail is for.
+      if (order.type === 'subscription') {
+        html = `<p style="color: #718096;">Your payment method was declined. Your access has been suspended, but your subscription is <strong>not cancelled</strong> &mdash; charges will continue to accrue.</p>
+        <p style="color: #718096;">Please update your payment method to restore access.</p>`;
+      } else {
+        html = `<p style="color: #718096;">Your payment of <strong>$${payment.price || computed.totalToday || '0.00'}</strong> for <strong>${escape(productName)}</strong> was declined, so the purchase did not go through and you have not been charged.</p>
+        <p style="color: #718096;">Nothing is owed. If you still want it, you can buy it again from our <a href="${brandUrl}/pricing">pricing page</a>.</p>`;
+      }
+      break;
+
+    case 'payment-recovered':
+      html = `<p style="color: #718096;">Your payment has been processed successfully and your access has been restored. Your subscription is now active again.</p>`;
+      break;
+
+    case 'cancellation-requested':
+      html = `<p style="color: #718096;">Your subscription is scheduled for cancellation at the end of your current billing period. You'll continue to have access until <strong>${escape(computed.cancellationDate || '')}</strong>.</p>
+      <p style="color: #718096;">Changed your mind? You can reactivate your subscription anytime before that date from your <a href="${brandUrl}/dashboard/account#billing">account</a>.</p>`;
+      break;
+
+    case 'cancelled':
+      if (isTrial) {
+        html = `<p style="color: #718096;">Your free trial has been cancelled. You've been downgraded to a basic account. To re-subscribe, visit our <a href="${brandUrl}/pricing">pricing page</a>.</p>`;
+      } else if (computed.expiresDate) {
+        html = `<p style="color: #718096;">Your subscription has been cancelled. You'll continue to have access until <strong>${escape(computed.expiresDate)}</strong>. After that, you'll be downgraded to a basic account.</p>`;
+      } else {
+        html = `<p style="color: #718096;">Your subscription has been cancelled and your access has been revoked immediately.</p>`;
+      }
+      html += `<p style="color: #718096;">We're sorry to see you go. If you'd like to come back, you can re-subscribe anytime.</p>`;
+      break;
+
+    case 'plan-changed': {
+      const prev = order.unified?.previous;
+      const prevName = prev?.product?.name || '';
+      html = `<p style="color: #718096;">Your plan has been changed${prevName ? ` from <strong>${escape(brandName)} ${escape(prevName)}</strong>` : ''} to <strong>${escape(brandName)} ${escape(productName)}</strong> at <strong>$${payment.price}/${escape(payment.frequency || '')}</strong>. The change is effective immediately.</p>`;
+      break;
+    }
+
+    case 'trial-ending':
+      html = `<p style="color: #718096;">Your free trial ends on <strong>${escape(computed.trialExpires || '')}</strong>. After that, you will be charged <strong>$${chargeAmount}/${escape(payment.frequency || '')}</strong> automatically.</p>
+      <p style="color: #718096;">If you don't want to be charged, <a href="${brandUrl}/dashboard/account#billing">cancel your subscription</a> before your trial ends. After your trial, no full refund will be issued.</p>`;
+      break;
+
+    case 'refunded':
+      html = `<p style="color: #718096;">A refund of <strong>$${escape(computed.refundAmount || computed.totalToday || '0.00')}</strong> has been processed and will appear on your statement within 5&ndash;10 business days.</p>`;
+      break;
+
+    case 'abandoned-cart': {
+      const reminderN = computed.reminderNumber || 1;
+      if (reminderN === 1) {
+        html = `<p style="color: #718096;">Your cart is still saved and we have a special discount waiting for you!</p>`;
+      } else if (reminderN >= 5) {
+        html = `<p style="color: #718096;">This is your last reminder &mdash; your cart and discount are still waiting for you.</p>`;
+      } else {
+        html = `<p style="color: #718096;">Just a friendly reminder &mdash; your checkout is still waiting for you.</p>`;
+      }
+      break;
+    }
+  }
+
+  if (!html) {
+    return '';
+  }
+
+  return `<mj-text padding="16px 0 0 0">${html}</mj-text>`;
+}
+
+function _ctaButton(event, brand, order) {
+  const brandUrl = brand?.url || '#';
+
+  // A one-time receipt sends the customer to the ORDERS list, which is where
+  // that purchase actually appears — the account page's other sections are all
+  // subscription surfaces, and a one-time purchase writes nothing to any of them
+  // ([#672](https://github.com/Omega-JS-Stack/omega/issues/672)).
+  const accountUrl = order?.type === 'one-time'
+    ? `${brandUrl}/dashboard/account#orders`
+    : `${brandUrl}/dashboard/account`;
+
+  // A declined ONE-TIME purchase has no payment method to update: the buyer's
+  // only surface is the order itself, which the orders list is the one page to show
+  const paymentFailed = order?.type === 'one-time'
+    ? { text: 'View your order &rarr;', url: accountUrl }
+    : { text: 'Update payment method &rarr;', url: `${brandUrl}/dashboard/account#billing` };
+
+  const variants = {
+    'confirmation': { text: 'Go to your dashboard &rarr;', url: accountUrl },
+    'payment-failed': paymentFailed,
+    'payment-recovered': { text: 'Go to your dashboard &rarr;', url: `${brandUrl}/dashboard/account` },
+    'cancellation-requested': { text: 'Manage subscription &rarr;', url: `${brandUrl}/dashboard/account#billing` },
+    'cancelled': { text: 'Re-subscribe &rarr;', url: `${brandUrl}/pricing` },
+    'plan-changed': { text: 'Go to your dashboard &rarr;', url: `${brandUrl}/dashboard/account` },
+    'trial-ending': { text: 'Manage subscription &rarr;', url: `${brandUrl}/dashboard/account#billing` },
+    'refunded': { text: 'Go to your account &rarr;', url: accountUrl },
+    'abandoned-cart': { text: 'Complete checkout &rarr;', url: order._computed?.checkoutUrl || `${brandUrl}/pricing` },
+  };
+
+  const v = variants[event] || variants['confirmation'];
+
+  return `<mj-button href="${safeUrl(v.url)}" background-color="#1A202C" color="#ffffff" border-radius="4px" font-size="16px" font-weight="normal" inner-padding="10px 20px" padding="24px 0 0 0">${v.text}</mj-button>`;
+}
+
+function _helpText(brand) {
+  const brandUrl = brand?.url || '#';
+
+  return `
+        <mj-text padding="16px 0 0 0" align="center">
+          <p style="color: #718096; margin: 0;">Questions about your order? <a href="${brandUrl}/support">Contact our support team</a>.</p>
+        </mj-text>`;
+}
+
+// ============================================================
+// Variant summary builders
+// ============================================================
+
+function _refundSummary(order, theme) {
+  const computed = order._computed || {};
+  const amount = computed.refundAmount || computed.totalToday || '0.00';
+
+  const rows = [
+    `<tr><td style="padding: 4px 0;"><strong>Refund amount</strong></td><td style="padding: 4px 0; text-align: right; white-space: nowrap;"><strong style="font-size: 18px; color: #16a34a;">$${amount}</strong></td></tr>`,
+  ];
+
+  return _sectionLabel('REFUND SUMMARY') + _tableCard(rows, theme);
+}
+
+function _planChangedSummary(order, data, theme) {
+  const payment = order.unified?.payment || {};
+  const brandName = data?.brand?.name || '';
+  const productName = order.unified?.product?.name || '';
+  const prev = order.unified?.previous;
+
+  const rows = [];
+
+  if (prev?.product?.name) {
+    const prevFreq = payment.frequency ? `/${escape(payment.frequency)}` : '';
+    rows.push(_row(
+      `<span style="text-decoration: line-through; color: #888;">${escape(brandName)} ${escape(prev.product.name)}</span>`,
+      prev.price != null
+        ? `<span style="text-decoration: line-through; color: #888;">$${prev.price}${prevFreq}</span>`
+        : '',
+    ));
+  }
+
+  rows.push(_row(
+    `<strong>${escape(brandName)} ${escape(productName)}</strong>`,
+    payment.price != null ? `<strong>$${payment.price}/${escape(payment.frequency || '')}</strong>` : '',
+  ));
+
+  return _sectionLabel('SUMMARY') + _tableCard(rows, theme);
+}
+
+function _abandonedCartSummary(order, data, theme) {
+  const payment = order.unified?.payment || {};
+  const product = order.unified?.product || {};
+  const brandName = data?.brand?.name || '';
+
+  const rows = [];
+
+  if (product.name) {
+    rows.push(_row(
+      `<strong>${escape(brandName)} ${escape(product.name)}</strong>`,
+      payment.price != null ? `<strong>$${payment.price}</strong>` : '',
+    ));
+  }
+
+  return _sectionLabel('YOUR CART') + _tableCard(rows, theme);
+}
+
+// ============================================================
+// Primitives
+// ============================================================
+
+function _sectionLabel(text) {
+  return `
+        <mj-text padding="24px 0 8px 0">
+          <p style="font-weight: 700; font-size: 12px; color: #718096; letter-spacing: 0.5px; margin: 0;">${text}</p>
+        </mj-text>`;
+}
+
+function _tableCard(rows, theme) {
+  const bg = theme?.accentColor || '#F7FAFC';
+  return `
+        <mj-text padding="0">
+          <div style="background-color: ${bg}; border-radius: 8px; padding: 16px;">
+            <table style="width: 100%; border-collapse: collapse; font-size: 15px;">${rows.join('')}</table>
+          </div>
+        </mj-text>`;
+}
+
+function _row(left, right) {
+  return `<tr><td style="padding: 4px 0;">${left}</td><td style="padding: 4px 0; text-align: right; white-space: nowrap;">${right}</td></tr>`;
+}
+
+function _detailRow(label, value) {
+  return `<tr><td style="padding: 4px 0; color: #718096; white-space: nowrap;">${escape(label)}</td><td style="padding: 4px 0; text-align: right; white-space: nowrap;">${value}</td></tr>`;
+}
+
+const meta = {
+  name: 'order',
+  description: 'Order email — handles all order event types with componentized sections',
+};
+
+module.exports = { build, meta };

package/dist/manager/libraries/email/generators/lib/templates/plain.js

@@ -0,0 +1,83 @@
+/**
+ * Plain template — looks like a regular email from a person.
+ * No logo, no card, no branding. Full-width MJML body so it doesn't center in a narrow column.
+ */
+const { escape, safeUrl } = require('./shared-campaign.js');
+
+function build({ data }) {
+  const brand = data?.brand || {};
+  const brandName = brand.name || '';
+  const brandUrl = brand.url || '#';
+  const email = data?.email || {};
+  const content = data?.content || {};
+  const signoffData = data?.signoff || {};
+  const name = data?.personalization?.name;
+
+  const unsubscribeUrl = email.unsubscribeUrl || `${brandUrl}/portal/email-preferences`;
+  const addr = brand.address || {};
+  const address = [addr.line1, addr.line2, addr.city, addr.region, addr.postalCode].filter(Boolean).join(' · ');
+
+  // Greeting
+  const greeting = content.greeting
+    ? `<p>${escape(content.greeting)}${name ? ` ${escape(name)}` : ''},</p>`
+    : '';
+
+  // Message
+  const message = content.message || '';
+
+  // Optional link
+  const link = content.link?.url
+    ? `<p><a href="${safeUrl(content.link.url)}" style="color: #1a73e8;">${escape(content.link.text || content.link.url)}</a></p>`
+    : '';
+
+  // Signoff
+  const signoffGreeting = content.signoff || 'Best';
+  // A personal signoff always arrives named — prepare.resolveSignoff() fills it from
+  // brand.contact.person and fails loudly when that is not configured, so there is no
+  // personal-identity fallback to make here.
+  const signoffName = signoffData.name || `The ${brandName} Team`;
+
+  // Hidden tags
+  const hiddenAsm = `<div style="display:none;max-height:0;overflow:hidden;mso-hide:all;"><a href="<%asm_group_unsubscribe_raw_url%>">unsubscribe</a><a href="<%asm_preferences_raw_url%>">preferences</a></div>`;
+
+  const categoryTags = (email.categories || []).map(c => `category=${escape(c)}`).join(', ');
+  const hiddenMeta = categoryTags
+    ? `<span style="display:none;">${categoryTags}</span>`
+    : '';
+
+  return `<mjml>
+  <mj-head>
+    <mj-title>${escape(email.subject || '')}</mj-title>
+    <mj-preview>${escape(email.preview || '')}</mj-preview>
+    <mj-attributes>
+      <mj-all font-family="Arial, Helvetica, sans-serif" />
+      <mj-text font-size="14px" line-height="1.6" color="#222222" padding="0" />
+      <mj-section padding="0" />
+    </mj-attributes>
+  </mj-head>
+  <mj-body background-color="#ffffff" width="100%">
+
+    <mj-section>
+      <mj-column>
+        <mj-text>${greeting}${message}${link}</mj-text>
+        <mj-text padding="12px 0 0 0"><p>${escape(signoffGreeting)},<br>${escape(signoffName)}</p></mj-text>
+        <mj-text padding="24px 0 0 0" font-size="11px" color="#aaaaaa">
+          <a href="${unsubscribeUrl}" style="color:#aaaaaa;">Unsubscribe</a> &middot;
+          <a href="${brandUrl}/dashboard/account" style="color:#aaaaaa;">Manage account</a> &middot;
+          ${address}
+          ${hiddenAsm}
+          ${hiddenMeta}
+        </mj-text>
+      </mj-column>
+    </mj-section>
+
+  </mj-body>
+</mjml>`;
+}
+
+const meta = {
+  name: 'plain',
+  description: 'Plain personal email — no branding, just text + required footer',
+};
+
+module.exports = { build, meta };

package/dist/manager/libraries/email/generators/lib/templates/shared-campaign.js

@@ -0,0 +1,64 @@
+/**
+ * Shared helpers for campaign/transactional email templates.
+ * Minimal — just the utilities that card/plain/order/feedback need.
+ */
+
+const { safeUrl } = require('../../../constants.js');
+
+const DEFAULT_SPACING = {
+  gutter: '32px',
+  sectionGap: '24px',
+  ruleColor: '#e8e8ec',
+};
+
+function escape(s) {
+  return String(s || '')
+    .replace(/&/g, '&')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;');
+}
+
+function resolveTheme(theme, overrides) {
+  return {
+    ...theme,
+    spacing: {
+      ...DEFAULT_SPACING,
+      ...(theme?.spacing || {}),
+      ...(overrides || {}),
+    },
+  };
+}
+
+function formatAddress(address) {
+  if (!address) {
+    return '';
+  }
+
+  if (typeof address === 'string') {
+    return address;
+  }
+
+  const parts = [];
+
+  if (address.line1) parts.push(address.line1);
+  if (address.line2) parts.push(address.line2);
+
+  const cityLine = [
+    address.city,
+    [address.region, address.postalCode].filter(Boolean).join(' '),
+  ].filter(Boolean).join(', ');
+
+  if (cityLine) parts.push(cityLine);
+  if (address.country) parts.push(address.country);
+
+  return parts.join(', ');
+}
+
+module.exports = {
+  DEFAULT_SPACING,
+  escape,
+  safeUrl,
+  resolveTheme,
+  formatAddress,
+};