@absolutejs/commerce 0.3.0-beta.0 → 0.4.0-beta.0

package/dist/core/email.d.ts

@@ -0,0 +1,51 @@
+export type EmailMessage = {
+    to: string;
+    subject: string;
+    html: string;
+};
+export type EmailProvider = {
+    send(message: EmailMessage): Promise<void>;
+};
+export type EmailTheme = {
+    brandName: string;
+    tagline?: string;
+    footerNote?: string;
+    colors: {
+        ink: string;
+        accent: string;
+        gold: string;
+        paper: string;
+        card: string;
+        muted: string;
+        hairline: string;
+    };
+};
+export declare const DEFAULT_EMAIL_THEME: EmailTheme;
+/** A short, human order reference derived from a session id. */
+export declare const orderNumber: (sessionId: string) => string;
+/** Format a minor-unit amount for display (null → em dash). */
+export declare const formatMoneyCents: (cents: number | null, currency?: string | null) => string;
+/** A carrier tracking URL, or '' for an unknown carrier. */
+export declare const carrierTrackingUrl: (carrier: string, trackingNumber: string) => string;
+/** A branded call-to-action button (inline-styled for email clients). */
+export declare const emailButton: (theme: EmailTheme, href: string, label: string) => string;
+export type EmailLineItem = {
+    label: string;
+    amountCents: number;
+};
+export type LineItemsOptions = {
+    currency?: string | null;
+    totalCents?: number | null;
+    totalLabel?: string;
+};
+/** A line-items table with an optional total row. */
+export declare const emailLineItems: (theme: EmailTheme, items: EmailLineItem[], options?: LineItemsOptions) => string;
+export type RenderEmailArgs = {
+    preheader: string;
+    heading: string;
+    intro: string;
+    /** Pre-built inner HTML (line tables, buttons, paragraphs). */
+    inner?: string;
+};
+/** Wrap content in the branded, responsive email shell. */
+export declare const renderEmail: (theme: EmailTheme, { preheader, heading, intro, inner }: RenderEmailArgs) => string;

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from './core/cart';
 export * from './core/discounts';
+export * from './core/email';
 export * from './core/money';
 export * from './core/orders';
 export * from './core/payment';

package/dist/index.js

@@ -26,6 +26,78 @@ var formatPrice = (value, currency = "USD") => {
   const code = currency.toUpperCase();
   return code === "USD" ? `$${value.toFixed(2)}` : `${value.toFixed(2)} ${code}`;
 };
+
+// src/core/email.ts
+var DEFAULT_EMAIL_THEME = {
+  brandName: "AbsoluteJS Commerce",
+  colors: {
+    accent: "#1f6f5c",
+    card: "#fffdf8",
+    gold: "#b5862f",
+    hairline: "#e6ddcb",
+    ink: "#1a1712",
+    muted: "#7a7264",
+    paper: "#efece4"
+  },
+  footerNote: "Questions? Just reply to this email."
+};
+var orderNumber = (sessionId) => `#${sessionId.slice(-8).toUpperCase()}`;
+var formatMoneyCents = (cents, currency = "usd") => {
+  if (cents === null)
+    return "\u2014";
+  const code = (currency ?? "usd").toUpperCase();
+  const value = fromCents(cents).toFixed(2);
+  return code === "USD" ? `$${value}` : `${value} ${code}`;
+};
+var carrierTrackingUrl = (carrier, trackingNumber) => {
+  const slug = carrier.toLowerCase();
+  if (slug.includes("usps"))
+    return `https://tools.usps.com/go/TrackConfirmAction?tLabels=${trackingNumber}`;
+  if (slug.includes("ups"))
+    return `https://www.ups.com/track?tracknum=${trackingNumber}`;
+  if (slug.includes("fedex"))
+    return `https://www.fedex.com/fedextrack/?trknbr=${trackingNumber}`;
+  return "";
+};
+var emailButton = (theme, href, label) => `<a href="${href}" style="display:inline-block;background:${theme.colors.accent};color:#ffffff;text-decoration:none;font-weight:700;font-size:14px;padding:12px 22px;border-radius:6px;">${label}</a>`;
+var emailLineItems = (theme, items, options = {}) => {
+  const { colors } = theme;
+  const rows = items.map((item) => `<tr>
+					<td style="padding:8px 0;border-bottom:1px solid ${colors.hairline};font-size:14px;color:${colors.ink};">${item.label}</td>
+					<td style="padding:8px 0;border-bottom:1px solid ${colors.hairline};text-align:right;font-family:monospace;font-size:14px;color:${colors.ink};">${formatMoneyCents(item.amountCents, options.currency)}</td>
+				</tr>`).join("");
+  const total = options.totalCents === undefined ? "" : `<tr>
+				<td style="padding:12px 0 0;font-weight:700;font-size:15px;color:${colors.ink};">${options.totalLabel ?? "Total"}</td>
+				<td style="padding:12px 0 0;text-align:right;font-weight:700;font-family:monospace;font-size:15px;color:${colors.ink};">${formatMoneyCents(options.totalCents, options.currency)}</td>
+			</tr>`;
+  return `<table width="100%" cellpadding="0" cellspacing="0" style="border-collapse:collapse;margin:18px 0;">${rows}${total}</table>`;
+};
+var renderEmail = (theme, { preheader, heading, intro, inner = "" }) => {
+  const { colors } = theme;
+  const tagline = theme.tagline ? ` \xB7 ${theme.tagline}` : "";
+  const footer = theme.footerNote ?? "";
+  return `
+<div style="display:none;max-height:0;overflow:hidden;opacity:0;">${preheader}</div>
+<div style="margin:0;padding:24px 12px;background:${colors.paper};font-family:'Helvetica Neue',Arial,sans-serif;">
+	<table width="100%" cellpadding="0" cellspacing="0"><tr><td align="center">
+		<table width="560" cellpadding="0" cellspacing="0" style="max-width:560px;width:100%;background:${colors.card};border:1.5px solid ${colors.ink};">
+			<tr><td style="height:6px;background:${colors.accent};font-size:0;line-height:0;">&nbsp;</td></tr>
+			<tr><td style="padding:24px 28px 4px;">
+				<span style="font-family:'Courier New',monospace;font-size:11px;letter-spacing:0.22em;text-transform:uppercase;color:${colors.gold};font-weight:700;">${theme.brandName}</span>
+			</td></tr>
+			<tr><td style="padding:8px 28px 28px;">
+				<h1 style="margin:0 0 10px;font-size:26px;line-height:1.15;color:${colors.accent};">${heading}</h1>
+				<p style="margin:0 0 4px;font-size:15px;line-height:1.55;color:${colors.ink};">${intro}</p>
+				${inner}
+			</td></tr>
+			<tr><td style="padding:18px 28px;border-top:1px solid ${colors.hairline};font-family:'Courier New',monospace;font-size:11px;line-height:1.6;color:${colors.muted};">
+				${theme.brandName}${tagline}<br/>
+				${footer}
+			</td></tr>
+		</table>
+	</td></tr></table>
+</div>`;
+};
 // src/core/orders.ts
 var clampPercent = (percent) => Math.min(100, Math.max(0, percent));
 var depositCents = (totalCents, percent) => percent > 0 ? Math.round(totalCents * clampPercent(percent) / 100) : 0;
@@ -56,19 +128,26 @@ export {
   toProductionStage,
   toCents,
   roundMoney,
+  renderEmail,
   quantityDiscount,
   prevStage,
+  orderNumber,
   nextStage,
   nextQuantityBreak,
   lineTotal,
   isDiscountValid,
   fromCents,
   formatPrice,
+  formatMoneyCents,
+  emailLineItems,
+  emailButton,
   discountAmountCents,
   depositCents,
   cartSubtotal,
   cartSetupTotal,
   cartCount,
+  carrierTrackingUrl,
   PRODUCTION_STAGES,
+  DEFAULT_EMAIL_THEME,
   DEFAULT_APPAREL_PARCEL
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@absolutejs/commerce",
-	"version": "0.3.0-beta.0",
+	"version": "0.4.0-beta.0",
 	"description": "Provider-agnostic commerce primitives (cart, orders, fulfillment, shipping) for AbsoluteJS",
 	"repository": {
 		"type": "git",