@rovela-ai/sdk 0.1.2 → 0.1.3

package/dist/emails/templates/refund-processed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refund-processed.js","sourceRoot":"","sources":["../../../src/emails/templates/refund-processed.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAuCH,sDAgEC;AAKD,8DAKC;AA9GD,oCAAqC;AACrC,iCASe;AAEf,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,qBAAqB,CAAC,IAAyB;IAC7D,MAAM,KAAK,GAAG,IAAA,kBAAW,EAAC,kBAAkB,CAAC,CAAA;IAE7C,yCAAyC;IACzC,MAAM,gBAAgB,GAAG;;;;;wDAK6B,aAAM,CAAC,UAAU,+CAA+C,aAAM,CAAC,aAAa;gDAC5F,aAAM,CAAC,UAAU,+CAA+C,aAAM,CAAC,YAAY,MAAM,IAAA,kBAAU,EAAC,IAAI,CAAC,YAAY,CAAC;;;UAG5J,IAAA,mBAAY,EAAC,cAAc,EAAE,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE;QACrD,SAAS,EAAE,MAAM;QACjB,SAAS,EAAE,IAAI;QACf,YAAY,EAAE,IAAI;KACnB,CAAC;UACA,IAAA,mBAAY,EAAC,aAAa,EAAE,IAAI,CAAC,UAAU,EAAE;QAC7C,SAAS,EAAE,MAAM;QACjB,SAAS,EAAE,IAAI;KAChB,CAAC;;;GAGP,CAAA;IAED,0BAA0B;IAC1B,MAAM,gBAAgB,GAAG,IAAA,gBAAS,EAAC,gBAAgB,EAAE;QACnD,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE;QACtD,EAAE,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE;KAC7D,CAAC,CAAA;IAEF,MAAM,OAAO,GAAG;MACZ,KAAK;MACL,IAAA,cAAO,EAAC,gCAAgC,CAAC;;MAEzC,IAAA,gBAAS,EAAC,MAAM,IAAA,kBAAU,EAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC;;MAEjD,IAAA,gBAAS,EACT,qCAAqC,IAAA,kBAAU,EAAC,IAAI,CAAC,WAAW,CAAC,iEAAiE,EAClI,MAAM,CACP;;MAEC,gBAAgB;;MAEhB,gBAAgB;;MAEhB,IAAA,gBAAS,EACT,gBAAgB,IAAA,kBAAU,EAAC,IAAI,CAAC,YAAY,CAAC,gHAAgH,EAC7J,MAAM,CACP;;iDAE4C,aAAM,CAAC,UAAU,mEAAmE,aAAM,CAAC,aAAa;;;;MAInJ,IAAA,oBAAa,EAAC,mBAAmB,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;GAC1D,CAAA;IAED,OAAO,IAAA,iBAAU,EAAC;QAChB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,uBAAuB,IAAI,CAAC,WAAW,EAAE;QAChD,OAAO;KACR,CAAC,CAAA;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,yBAAyB,CACvC,SAAiB,EACjB,WAAmB;IAEnB,OAAO,uBAAuB,WAAW,MAAM,SAAS,EAAE,CAAA;AAC5D,CAAC"}

package/dist/emails/templates/welcome.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @rovela/sdk/emails/templates/welcome
+ *
+ * Welcome email template for newly verified accounts.
+ */
+import type { WelcomeEmailData } from '../types';
+/**
+ * Render the welcome email template.
+ *
+ * @example
+ * ```typescript
+ * import { renderWelcomeEmail } from '@rovela/sdk/emails'
+ *
+ * const html = renderWelcomeEmail({
+ *   config: emailConfig,
+ *   customerName: 'John',
+ *   customerEmail: 'john@example.com',
+ *   createdDate: 'November 28, 2025',
+ * })
+ * ```
+ */
+export declare function renderWelcomeEmail(data: WelcomeEmailData): string;
+/**
+ * Get the subject line for welcome emails.
+ */
+export declare function getWelcomeEmailSubject(storeName: string): string;
+//# sourceMappingURL=welcome.d.ts.map

package/dist/emails/templates/welcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"welcome.d.ts","sourceRoot":"","sources":["../../../src/emails/templates/welcome.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAUhD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CA6BjE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/dist/emails/templates/welcome.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * @rovela/sdk/emails/templates/welcome
+ *
+ * Welcome email template for newly verified accounts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderWelcomeEmail = renderWelcomeEmail;
+exports.getWelcomeEmailSubject = getWelcomeEmailSubject;
+const utils_1 = require("../utils");
+const base_1 = require("./base");
+/**
+ * Render the welcome email template.
+ *
+ * @example
+ * ```typescript
+ * import { renderWelcomeEmail } from '@rovela/sdk/emails'
+ *
+ * const html = renderWelcomeEmail({
+ *   config: emailConfig,
+ *   customerName: 'John',
+ *   customerEmail: 'john@example.com',
+ *   createdDate: 'November 28, 2025',
+ * })
+ * ```
+ */
+function renderWelcomeEmail(data) {
+    const content = `
+    ${(0, base_1.heading)(`Welcome to ${(0, utils_1.escapeHtml)(data.config.storeName)}!`)}
+
+    ${(0, base_1.paragraph)(`Hi ${(0, utils_1.escapeHtml)(data.customerName)},`)}
+
+    ${(0, base_1.paragraph)("Thank you for creating an account with us! We're excited to have you join our community.", '24px')}
+
+    ${(0, base_1.paragraph)('Your account is now set up and ready to go. You can start exploring our products and enjoy a seamless shopping experience.', '32px')}
+
+    ${(0, base_1.primaryButton)('Start Shopping', data.config.shopUrl)}
+
+    ${(0, base_1.detailBox)('Your Account Details', [
+        { label: 'Email', value: data.customerEmail },
+        { label: 'Account Created', value: data.createdDate },
+    ])}
+  `;
+    return (0, base_1.baseLayout)({
+        config: data.config,
+        title: `Welcome to ${data.config.storeName}`,
+        content,
+    });
+}
+/**
+ * Get the subject line for welcome emails.
+ */
+function getWelcomeEmailSubject(storeName) {
+    return `Welcome to ${storeName}!`;
+}
+//# sourceMappingURL=welcome.js.map

package/dist/emails/templates/welcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"welcome.js","sourceRoot":"","sources":["../../../src/emails/templates/welcome.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AA2BH,gDA6BC;AAKD,wDAEC;AA5DD,oCAAqC;AACrC,iCAMe;AAEf;;;;;;;;;;;;;;GAcG;AACH,SAAgB,kBAAkB,CAAC,IAAsB;IACvD,MAAM,OAAO,GAAG;MACZ,IAAA,cAAO,EAAC,cAAc,IAAA,kBAAU,EAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC;;MAE3D,IAAA,gBAAS,EAAC,MAAM,IAAA,kBAAU,EAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC;;MAEjD,IAAA,gBAAS,EACT,0FAA0F,EAC1F,MAAM,CACP;;MAEC,IAAA,gBAAS,EACT,4HAA4H,EAC5H,MAAM,CACP;;MAEC,IAAA,oBAAa,EAAC,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;;MAEpD,IAAA,gBAAS,EAAC,sBAAsB,EAAE;QAClC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE;QAC7C,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE;KACtD,CAAC;GACH,CAAA;IAED,OAAO,IAAA,iBAAU,EAAC;QAChB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,cAAc,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE;QAC5C,OAAO;KACR,CAAC,CAAA;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CAAC,SAAiB;IACtD,OAAO,cAAc,SAAS,GAAG,CAAA;AACnC,CAAC"}

package/dist/emails/types.d.ts

@@ -0,0 +1,202 @@
+/**
+ * @rovela/sdk/emails/types
+ *
+ * Type definitions for transactional email templates.
+ */
+/**
+ * Common configuration for all email templates.
+ * Loaded from environment variables and blueprint.
+ */
+export interface EmailConfig {
+    /** Store logo URL (empty string = no logo) */
+    logoUrl: string;
+    /** Store name */
+    storeName: string;
+    /** Store physical address */
+    storeAddress: string;
+    /** Support email address */
+    supportEmail: string;
+    /** Store URL for "Continue Shopping" links */
+    shopUrl: string;
+}
+/**
+ * Options for sending an email via Resend.
+ */
+export interface SendEmailOptions {
+    /** Recipient email address */
+    to: string;
+    /** Email subject line */
+    subject: string;
+    /** HTML content */
+    html: string;
+    /** Optional reply-to address */
+    replyTo?: string;
+}
+/**
+ * Result of sending an email.
+ */
+export interface SendEmailResult {
+    /** Whether the email was sent successfully */
+    success: boolean;
+    /** Resend message ID if successful */
+    messageId?: string;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Shipping/billing address for order emails.
+ */
+export interface EmailAddress {
+    name: string;
+    line1: string;
+    line2?: string;
+    city: string;
+    state: string;
+    postalCode: string;
+    country: string;
+}
+/**
+ * Order item for order confirmation email.
+ */
+export interface EmailOrderItem {
+    /** Product name */
+    name: string;
+    /** Item quantity */
+    quantity: number;
+    /** Formatted price (e.g., "$29.99") */
+    price: string;
+    /** Product image URL */
+    imageUrl?: string;
+}
+/**
+ * Data for email verification template.
+ */
+export interface EmailVerificationData {
+    config: EmailConfig;
+    customerName: string;
+    customerEmail: string;
+    verificationLink: string;
+    /** Expiry time in hours (e.g., "24") */
+    expiryTime: string;
+}
+/**
+ * Data for welcome email template.
+ */
+export interface WelcomeEmailData {
+    config: EmailConfig;
+    customerName: string;
+    customerEmail: string;
+    /** Formatted creation date (e.g., "November 28, 2025") */
+    createdDate: string;
+}
+/**
+ * Data for password reset email template.
+ */
+export interface PasswordResetEmailData {
+    config: EmailConfig;
+    customerName: string;
+    resetLink: string;
+    /** Expiry time in hours (e.g., "1") */
+    expiryTime: string;
+}
+/**
+ * Data for order confirmation email template.
+ */
+export interface OrderConfirmationData {
+    config: EmailConfig;
+    customerName: string;
+    customerEmail: string;
+    orderNumber: string;
+    /** Formatted order date (e.g., "November 28, 2025") */
+    orderDate: string;
+    /** Payment status (e.g., "Paid") */
+    paymentStatus: string;
+    items: EmailOrderItem[];
+    /** Formatted subtotal (e.g., "$99.00") */
+    subtotal: string;
+    /** Formatted shipping cost (e.g., "$5.00" or "Free") */
+    shippingCost: string;
+    /** Formatted tax (e.g., "$8.00") */
+    tax: string;
+    /** Formatted total (e.g., "$112.00") */
+    total: string;
+    shippingAddress: EmailAddress;
+    /** URL to track order */
+    orderTrackingUrl: string;
+}
+/**
+ * Data for order shipped email template.
+ */
+export interface OrderShippedData {
+    config: EmailConfig;
+    customerName: string;
+    customerEmail: string;
+    orderNumber: string;
+    trackingNumber: string;
+    carrierName: string;
+    /** Formatted estimated delivery date (e.g., "December 3, 2025") */
+    estimatedDeliveryDate: string;
+    shippingAddress: EmailAddress;
+    /** URL to track package */
+    trackingUrl: string;
+}
+/**
+ * Data for order delivered email template.
+ */
+export interface OrderDeliveredData {
+    config: EmailConfig;
+    customerName: string;
+    customerEmail: string;
+    orderNumber: string;
+    /** Formatted delivery date (e.g., "December 3, 2025") */
+    deliveryDate: string;
+    /** Delivery location description (e.g., "Front Door") */
+    deliveryLocation: string;
+    /** URL to leave a review */
+    reviewUrl: string;
+    /** URL to return center */
+    returnCenterUrl: string;
+}
+/**
+ * Data for order cancelled email template.
+ */
+export interface OrderCancelledData {
+    config: EmailConfig;
+    customerName: string;
+    customerEmail: string;
+    orderNumber: string;
+    /** Reason for cancellation (optional) */
+    cancellationReason?: string;
+    /** Formatted cancellation date */
+    cancellationDate: string;
+    /** Message about refund status */
+    refundMessage: string;
+}
+/**
+ * Data for refund processed email template.
+ */
+export interface RefundProcessedData {
+    config: EmailConfig;
+    customerName: string;
+    customerEmail: string;
+    orderNumber: string;
+    /** Formatted refund amount (e.g., "$99.00") */
+    refundAmount: string;
+    /** Formatted refund date */
+    refundDate: string;
+    /** Payment method (e.g., "Visa ending in 4242") */
+    paymentMethod: string;
+    /** Estimated arrival (e.g., "3-5 business days") */
+    estimatedArrival: string;
+    /** Number of business days for refund */
+    businessDays: string;
+}
+/**
+ * All available email template types.
+ */
+export type EmailTemplateType = 'email-verification' | 'welcome' | 'password-reset' | 'order-confirmation' | 'order-shipped' | 'order-delivered' | 'order-cancelled' | 'refund-processed';
+/**
+ * Union of all email data types.
+ */
+export type EmailData = EmailVerificationData | WelcomeEmailData | PasswordResetEmailData | OrderConfirmationData | OrderShippedData | OrderDeliveredData | OrderCancelledData | RefundProcessedData;
+//# sourceMappingURL=types.d.ts.map

package/dist/emails/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/emails/types.ts"],"names":[],"mappings":"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"}

package/dist/emails/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * @rovela/sdk/emails/types
+ *
+ * Type definitions for transactional email templates.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/emails/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/emails/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/emails/utils.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @rovela/sdk/emails/utils
+ *
+ * Utility functions for email template rendering.
+ */
+import type { EmailAddress } from './types';
+/**
+ * Format a date for display in emails.
+ * Returns format like "November 28, 2025"
+ *
+ * @example
+ * ```typescript
+ * formatDate(new Date()) // "November 28, 2025"
+ * formatDate('2025-11-28') // "November 28, 2025"
+ * ```
+ */
+export declare function formatDate(date: Date | string): string;
+/**
+ * Format a date with time for display in emails.
+ * Returns format like "November 28, 2025 at 2:30 PM"
+ */
+export declare function formatDateTime(date: Date | string): string;
+/**
+ * Format a price for display in emails.
+ * Accepts cents (integer) or dollars (decimal string).
+ *
+ * @example
+ * ```typescript
+ * formatPrice(2999) // "$29.99" (cents)
+ * formatPrice('29.99') // "$29.99" (dollars as string)
+ * formatPrice(0) // "$0.00"
+ * formatPrice('Free') // "Free" (passthrough)
+ * ```
+ */
+export declare function formatPrice(amount: number | string, currency?: string): string;
+/**
+ * Format an address for display in emails (single line).
+ *
+ * @example
+ * ```typescript
+ * formatAddressLine({
+ *   name: 'John Doe',
+ *   line1: '123 Main St',
+ *   city: 'New York',
+ *   state: 'NY',
+ *   postalCode: '10001',
+ *   country: 'US',
+ * })
+ * // "123 Main St, New York, NY 10001, US"
+ * ```
+ */
+export declare function formatAddressLine(address: EmailAddress): string;
+/**
+ * Format an address for display in emails (multi-line HTML).
+ *
+ * @example
+ * ```typescript
+ * formatAddressHtml({
+ *   name: 'John Doe',
+ *   line1: '123 Main St',
+ *   line2: 'Apt 4B',
+ *   city: 'New York',
+ *   state: 'NY',
+ *   postalCode: '10001',
+ *   country: 'United States',
+ * })
+ * // "John Doe<br>123 Main St<br>Apt 4B<br>New York, NY 10001<br>United States"
+ * ```
+ */
+export declare function formatAddressHtml(address: EmailAddress): string;
+/**
+ * Escape HTML special characters to prevent XSS.
+ */
+export declare function escapeHtml(str: string): string;
+/**
+ * Generate an HTML button for emails.
+ * Uses table-based layout for maximum email client compatibility.
+ */
+export declare function emailButton(text: string, href: string, options?: {
+    backgroundColor?: string;
+    textColor?: string;
+    borderRadius?: string;
+}): string;
+/**
+ * Generate the standard email footer.
+ */
+export declare function emailFooter(storeName: string, storeAddress: string): string;
+/**
+ * Format an order number for display.
+ * If the order ID is a UUID, shows first 8 characters.
+ * If already formatted (e.g., "ORD-12345"), returns as-is.
+ */
+export declare function formatOrderNumber(orderId: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/emails/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/emails/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAM3C;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAOtD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAU1D;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,QAAQ,GAAE,MAAc,GACvB,MAAM,CAsBR;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAW/D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CA4B/D;AAMD;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO9C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IACP,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;CACjB,GACL,MAAM,CAkBR;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAW3E;AAMD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAWzD"}

package/dist/emails/utils.js

@@ -0,0 +1,229 @@
+"use strict";
+/**
+ * @rovela/sdk/emails/utils
+ *
+ * Utility functions for email template rendering.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDate = formatDate;
+exports.formatDateTime = formatDateTime;
+exports.formatPrice = formatPrice;
+exports.formatAddressLine = formatAddressLine;
+exports.formatAddressHtml = formatAddressHtml;
+exports.escapeHtml = escapeHtml;
+exports.emailButton = emailButton;
+exports.emailFooter = emailFooter;
+exports.formatOrderNumber = formatOrderNumber;
+// =============================================================================
+// Date Formatting
+// =============================================================================
+/**
+ * Format a date for display in emails.
+ * Returns format like "November 28, 2025"
+ *
+ * @example
+ * ```typescript
+ * formatDate(new Date()) // "November 28, 2025"
+ * formatDate('2025-11-28') // "November 28, 2025"
+ * ```
+ */
+function formatDate(date) {
+    const d = typeof date === 'string' ? new Date(date) : date;
+    return d.toLocaleDateString('en-US', {
+        year: 'numeric',
+        month: 'long',
+        day: 'numeric',
+    });
+}
+/**
+ * Format a date with time for display in emails.
+ * Returns format like "November 28, 2025 at 2:30 PM"
+ */
+function formatDateTime(date) {
+    const d = typeof date === 'string' ? new Date(date) : date;
+    return d.toLocaleDateString('en-US', {
+        year: 'numeric',
+        month: 'long',
+        day: 'numeric',
+        hour: 'numeric',
+        minute: '2-digit',
+        hour12: true,
+    });
+}
+// =============================================================================
+// Price Formatting
+// =============================================================================
+/**
+ * Format a price for display in emails.
+ * Accepts cents (integer) or dollars (decimal string).
+ *
+ * @example
+ * ```typescript
+ * formatPrice(2999) // "$29.99" (cents)
+ * formatPrice('29.99') // "$29.99" (dollars as string)
+ * formatPrice(0) // "$0.00"
+ * formatPrice('Free') // "Free" (passthrough)
+ * ```
+ */
+function formatPrice(amount, currency = 'USD') {
+    // Handle "Free" or other string passthroughs
+    if (typeof amount === 'string' && isNaN(parseFloat(amount))) {
+        return amount;
+    }
+    // Convert to number
+    let dollars;
+    if (typeof amount === 'string') {
+        dollars = parseFloat(amount);
+    }
+    else if (Number.isInteger(amount) && amount > 100) {
+        // Assume cents if integer > 100
+        dollars = amount / 100;
+    }
+    else {
+        dollars = amount;
+    }
+    // Format with currency
+    return new Intl.NumberFormat('en-US', {
+        style: 'currency',
+        currency,
+    }).format(dollars);
+}
+// =============================================================================
+// Address Formatting
+// =============================================================================
+/**
+ * Format an address for display in emails (single line).
+ *
+ * @example
+ * ```typescript
+ * formatAddressLine({
+ *   name: 'John Doe',
+ *   line1: '123 Main St',
+ *   city: 'New York',
+ *   state: 'NY',
+ *   postalCode: '10001',
+ *   country: 'US',
+ * })
+ * // "123 Main St, New York, NY 10001, US"
+ * ```
+ */
+function formatAddressLine(address) {
+    const parts = [
+        address.line1,
+        address.line2,
+        address.city,
+        address.state,
+        address.postalCode,
+        address.country,
+    ].filter(Boolean);
+    return parts.join(', ');
+}
+/**
+ * Format an address for display in emails (multi-line HTML).
+ *
+ * @example
+ * ```typescript
+ * formatAddressHtml({
+ *   name: 'John Doe',
+ *   line1: '123 Main St',
+ *   line2: 'Apt 4B',
+ *   city: 'New York',
+ *   state: 'NY',
+ *   postalCode: '10001',
+ *   country: 'United States',
+ * })
+ * // "John Doe<br>123 Main St<br>Apt 4B<br>New York, NY 10001<br>United States"
+ * ```
+ */
+function formatAddressHtml(address) {
+    const lines = [];
+    // Name
+    if (address.name) {
+        lines.push(escapeHtml(address.name));
+    }
+    // Street address
+    if (address.line1) {
+        lines.push(escapeHtml(address.line1));
+    }
+    if (address.line2) {
+        lines.push(escapeHtml(address.line2));
+    }
+    // City, State ZIP
+    const cityLine = [address.city, address.state].filter(Boolean).join(', ');
+    if (cityLine || address.postalCode) {
+        lines.push(escapeHtml([cityLine, address.postalCode].filter(Boolean).join(' ')));
+    }
+    // Country
+    if (address.country) {
+        lines.push(escapeHtml(address.country));
+    }
+    return lines.join('<br>');
+}
+// =============================================================================
+// HTML Utilities
+// =============================================================================
+/**
+ * Escape HTML special characters to prevent XSS.
+ */
+function escapeHtml(str) {
+    return str
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+/**
+ * Generate an HTML button for emails.
+ * Uses table-based layout for maximum email client compatibility.
+ */
+function emailButton(text, href, options = {}) {
+    const { backgroundColor = '#0CAF7D', textColor = '#FFFFFF', borderRadius = '24px', } = options;
+    return `
+    <table cellpadding="0" cellspacing="0" border="0" style="margin: 24px 0;">
+      <tr>
+        <td align="center" bgcolor="${backgroundColor}" style="border-radius: ${borderRadius};">
+          <a href="${escapeHtml(href)}" target="_blank" style="display: inline-block; padding: 16px 32px; font-family: 'Plus Jakarta Sans', Arial, sans-serif; font-size: 16px; font-weight: 600; color: ${textColor}; text-decoration: none; border-radius: ${borderRadius};">
+            ${escapeHtml(text)}
+          </a>
+        </td>
+      </tr>
+    </table>
+  `;
+}
+/**
+ * Generate the standard email footer.
+ */
+function emailFooter(storeName, storeAddress) {
+    return `
+    <table width="100%" cellpadding="0" cellspacing="0" border="0" style="margin-top: 32px; padding-top: 24px; border-top: 1px solid #E5E5E5;">
+      <tr>
+        <td style="font-family: 'Plus Jakarta Sans', Arial, sans-serif; font-size: 12px; color: #6B6B6B; text-align: center;">
+          <p style="margin: 0 0 8px 0;">&copy; ${new Date().getFullYear()} ${escapeHtml(storeName)}. All rights reserved.</p>
+          ${storeAddress ? `<p style="margin: 0;">${escapeHtml(storeAddress)}</p>` : ''}
+        </td>
+      </tr>
+    </table>
+  `;
+}
+// =============================================================================
+// Order Number Formatting
+// =============================================================================
+/**
+ * Format an order number for display.
+ * If the order ID is a UUID, shows first 8 characters.
+ * If already formatted (e.g., "ORD-12345"), returns as-is.
+ */
+function formatOrderNumber(orderId) {
+    // If it looks like a UUID, format it
+    if (orderId.length === 36 && orderId.includes('-')) {
+        return `#${orderId.slice(0, 8).toUpperCase()}`;
+    }
+    // If it already has a prefix, return as-is
+    if (orderId.startsWith('#') || orderId.startsWith('ORD')) {
+        return orderId;
+    }
+    // Otherwise, add prefix
+    return `#${orderId}`;
+}
+//# sourceMappingURL=utils.js.map

package/dist/emails/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/emails/utils.ts"],"names":[],"mappings":"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"}