@rovela-ai/sdk 0.1.2 → 0.1.4

package/dist/core/utils.js

@@ -0,0 +1,356 @@
+"use strict";
+/**
+ * @rovela/sdk/core/utils
+ *
+ * Utility functions for e-commerce stores
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cn = cn;
+exports.formatPrice = formatPrice;
+exports.parsePrice = parsePrice;
+exports.generateSlug = generateSlug;
+exports.generateUniqueSlug = generateUniqueSlug;
+exports.generateSKU = generateSKU;
+exports.formatDate = formatDate;
+exports.formatRelativeTime = formatRelativeTime;
+exports.truncate = truncate;
+exports.capitalize = capitalize;
+exports.titleCase = titleCase;
+exports.clamp = clamp;
+exports.formatNumber = formatNumber;
+exports.percentage = percentage;
+exports.isValidEmail = isValidEmail;
+exports.isValidPhone = isValidPhone;
+exports.isValidPostalCode = isValidPostalCode;
+exports.deepClone = deepClone;
+exports.compact = compact;
+exports.pick = pick;
+exports.omit = omit;
+exports.sleep = sleep;
+exports.retry = retry;
+const clsx_1 = require("clsx");
+const tailwind_merge_1 = require("tailwind-merge");
+// =============================================================================
+// Class Name Utilities
+// =============================================================================
+/**
+ * Merge Tailwind CSS classes with clsx
+ * Handles conflicting classes intelligently
+ *
+ * @example
+ * cn('px-4 py-2', 'px-6') // => 'py-2 px-6'
+ * cn('bg-red-500', { 'bg-blue-500': isBlue }) // => 'bg-blue-500' if isBlue
+ */
+function cn(...inputs) {
+    return (0, tailwind_merge_1.twMerge)((0, clsx_1.clsx)(inputs));
+}
+/**
+ * Format a price for display with proper currency formatting
+ *
+ * @param price - Price in cents or as decimal (e.g., 1999 or 19.99)
+ * @param options - Formatting options
+ * @returns Formatted price string (e.g., "$19.99")
+ *
+ * @example
+ * formatPrice(1999) // => "$19.99"
+ * formatPrice(19.99, { currency: 'EUR', locale: 'de-DE' }) // => "19,99 €"
+ */
+function formatPrice(price, options = {}) {
+    const { currency = 'USD', locale = 'en-US', showCents = true } = options;
+    // Convert to number
+    let numPrice = typeof price === 'string' ? parseFloat(price) : price;
+    // Assume cents if price is a large integer (> 100 and whole number)
+    if (Number.isInteger(numPrice) && numPrice > 100) {
+        numPrice = numPrice / 100;
+    }
+    return new Intl.NumberFormat(locale, {
+        style: 'currency',
+        currency,
+        minimumFractionDigits: showCents ? 2 : 0,
+        maximumFractionDigits: showCents ? 2 : 0,
+    }).format(numPrice);
+}
+/**
+ * Parse a formatted price string back to a number
+ *
+ * @param priceString - Formatted price (e.g., "$19.99")
+ * @returns Price as a number (e.g., 19.99)
+ */
+function parsePrice(priceString) {
+    // Remove currency symbols, spaces, and convert comma decimal to dot
+    const cleaned = priceString
+        .replace(/[^0-9.,]/g, '')
+        .replace(',', '.');
+    return parseFloat(cleaned) || 0;
+}
+// =============================================================================
+// Slug Generation
+// =============================================================================
+/**
+ * Generate a URL-safe slug from a string
+ *
+ * @param text - Text to convert to slug
+ * @returns URL-safe slug
+ *
+ * @example
+ * generateSlug('Hello World!') // => 'hello-world'
+ * generateSlug('Product Name (2024)') // => 'product-name-2024'
+ */
+function generateSlug(text) {
+    return text
+        .toString()
+        .toLowerCase()
+        .trim()
+        // Replace spaces with hyphens
+        .replace(/\s+/g, '-')
+        // Remove special characters except hyphens
+        .replace(/[^\w-]+/g, '')
+        // Replace multiple hyphens with single hyphen
+        .replace(/--+/g, '-')
+        // Remove leading/trailing hyphens
+        .replace(/^-+/, '')
+        .replace(/-+$/, '');
+}
+/**
+ * Generate a unique slug by appending a suffix if needed
+ *
+ * @param baseSlug - Base slug to make unique
+ * @param existingSlugs - Array of existing slugs to check against
+ * @returns Unique slug
+ */
+function generateUniqueSlug(baseSlug, existingSlugs) {
+    let slug = baseSlug;
+    let counter = 1;
+    while (existingSlugs.includes(slug)) {
+        slug = `${baseSlug}-${counter}`;
+        counter++;
+    }
+    return slug;
+}
+// =============================================================================
+// SKU Generation
+// =============================================================================
+/**
+ * Generate a SKU (Stock Keeping Unit) from product details
+ *
+ * @param productName - Product name
+ * @param variant - Optional variant attributes
+ * @returns Generated SKU
+ *
+ * @example
+ * generateSKU('Blue T-Shirt') // => 'BLU-TSH-XXXX'
+ * generateSKU('Blue T-Shirt', { size: 'L', color: 'Blue' }) // => 'BLU-TSH-L-BLU-XXXX'
+ */
+function generateSKU(productName, variant) {
+    // Extract first 3 characters of each significant word
+    const words = productName
+        .split(/\s+/)
+        .filter((w) => w.length > 2)
+        .slice(0, 2)
+        .map((w) => w.substring(0, 3).toUpperCase());
+    const baseSKU = words.join('-');
+    // Add variant attributes if provided
+    let variantPart = '';
+    if (variant) {
+        variantPart = Object.values(variant)
+            .map((v) => v.substring(0, 3).toUpperCase())
+            .join('-');
+    }
+    // Add random suffix for uniqueness
+    const suffix = Math.random().toString(36).substring(2, 6).toUpperCase();
+    return [baseSKU, variantPart, suffix].filter(Boolean).join('-');
+}
+// =============================================================================
+// Date Formatting
+// =============================================================================
+/**
+ * Format a date for display
+ *
+ * @param date - Date to format
+ * @param options - Intl.DateTimeFormat options
+ * @returns Formatted date string
+ */
+function formatDate(date, options = {
+    year: 'numeric',
+    month: 'short',
+    day: 'numeric',
+}) {
+    const d = typeof date === 'string' ? new Date(date) : date;
+    return new Intl.DateTimeFormat('en-US', options).format(d);
+}
+/**
+ * Format a date as relative time (e.g., "2 hours ago")
+ *
+ * @param date - Date to format
+ * @returns Relative time string
+ */
+function formatRelativeTime(date) {
+    const d = typeof date === 'string' ? new Date(date) : date;
+    const now = new Date();
+    const diffMs = now.getTime() - d.getTime();
+    const diffSecs = Math.floor(diffMs / 1000);
+    const diffMins = Math.floor(diffSecs / 60);
+    const diffHours = Math.floor(diffMins / 60);
+    const diffDays = Math.floor(diffHours / 24);
+    if (diffSecs < 60)
+        return 'just now';
+    if (diffMins < 60)
+        return `${diffMins} minute${diffMins > 1 ? 's' : ''} ago`;
+    if (diffHours < 24)
+        return `${diffHours} hour${diffHours > 1 ? 's' : ''} ago`;
+    if (diffDays < 7)
+        return `${diffDays} day${diffDays > 1 ? 's' : ''} ago`;
+    return formatDate(d);
+}
+// =============================================================================
+// String Utilities
+// =============================================================================
+/**
+ * Truncate text to a maximum length with ellipsis
+ *
+ * @param text - Text to truncate
+ * @param maxLength - Maximum length (default 100)
+ * @returns Truncated text with ellipsis if needed
+ */
+function truncate(text, maxLength = 100) {
+    if (text.length <= maxLength)
+        return text;
+    return text.substring(0, maxLength - 3).trim() + '...';
+}
+/**
+ * Capitalize the first letter of a string
+ */
+function capitalize(text) {
+    return text.charAt(0).toUpperCase() + text.slice(1);
+}
+/**
+ * Convert a string to title case
+ */
+function titleCase(text) {
+    return text
+        .toLowerCase()
+        .split(' ')
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+}
+// =============================================================================
+// Number Utilities
+// =============================================================================
+/**
+ * Clamp a number between min and max values
+ */
+function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+/**
+ * Format a number with thousands separators
+ */
+function formatNumber(value, locale = 'en-US') {
+    return new Intl.NumberFormat(locale).format(value);
+}
+/**
+ * Calculate percentage
+ */
+function percentage(value, total) {
+    if (total === 0)
+        return 0;
+    return Math.round((value / total) * 100);
+}
+// =============================================================================
+// Validation Utilities
+// =============================================================================
+/**
+ * Validate an email address
+ */
+function isValidEmail(email) {
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    return emailRegex.test(email);
+}
+/**
+ * Validate a phone number (basic validation)
+ */
+function isValidPhone(phone) {
+    // Remove all non-digits
+    const digits = phone.replace(/\D/g, '');
+    // Check if we have 10-15 digits
+    return digits.length >= 10 && digits.length <= 15;
+}
+/**
+ * Validate a postal/zip code (basic validation)
+ */
+function isValidPostalCode(postalCode, country = 'US') {
+    const patterns = {
+        US: /^\d{5}(-\d{4})?$/,
+        CA: /^[A-Za-z]\d[A-Za-z][ -]?\d[A-Za-z]\d$/,
+        UK: /^[A-Za-z]{1,2}\d[A-Za-z\d]?\s?\d[A-Za-z]{2}$/,
+    };
+    const pattern = patterns[country.toUpperCase()];
+    if (!pattern)
+        return postalCode.length > 0;
+    return pattern.test(postalCode);
+}
+// =============================================================================
+// Object Utilities
+// =============================================================================
+/**
+ * Deep clone an object
+ */
+function deepClone(obj) {
+    return JSON.parse(JSON.stringify(obj));
+}
+/**
+ * Remove undefined and null values from an object
+ */
+function compact(obj) {
+    return Object.fromEntries(Object.entries(obj).filter(([, v]) => v != null));
+}
+/**
+ * Pick specific keys from an object
+ */
+function pick(obj, keys) {
+    return keys.reduce((acc, key) => {
+        if (key in obj) {
+            acc[key] = obj[key];
+        }
+        return acc;
+    }, {});
+}
+/**
+ * Omit specific keys from an object
+ */
+function omit(obj, keys) {
+    const result = { ...obj };
+    for (const key of keys) {
+        delete result[key];
+    }
+    return result;
+}
+// =============================================================================
+// Async Utilities
+// =============================================================================
+/**
+ * Sleep for a specified duration
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Retry a function with exponential backoff
+ */
+async function retry(fn, options = {}) {
+    const { maxAttempts = 3, delayMs = 1000 } = options;
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (attempt < maxAttempts) {
+                await sleep(delayMs * Math.pow(2, attempt - 1));
+            }
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=utils.js.map

package/dist/core/utils.js.map

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

package/dist/emails/config.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @rovela/sdk/emails/config
+ *
+ * Email configuration and Resend client management.
+ */
+import { Resend } from 'resend';
+import type { EmailConfig } from './types';
+/**
+ * Get or create Resend client instance.
+ * Lazily initialized on first use.
+ *
+ * @throws Error if RESEND_API_KEY is not set
+ */
+export declare function getResend(): Resend;
+/**
+ * Get the sender email address.
+ * Format: "Store Name <email@domain.com>"
+ */
+export declare function getFromEmail(): string;
+/**
+ * Get the store name from environment configuration.
+ *
+ * The STORE_NAME environment variable is set during store deployment
+ * from the blueprint's store.name value.
+ *
+ * @returns Store name from STORE_NAME env var, or 'Our Store' as fallback
+ */
+export declare function getStoreName(): string;
+/**
+ * Get the store URL for links in emails.
+ */
+export declare function getStoreUrl(): string;
+/**
+ * Get the complete email configuration for templates.
+ * Assembles config from environment variables and blueprint.
+ */
+export declare function getEmailConfig(): EmailConfig;
+/**
+ * Get the support email address.
+ */
+export declare function getSupportEmail(): string;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/emails/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAQ1C;;;;;GAKG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAgBlC;AAMD;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAKrC;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAW5C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAMxC"}

package/dist/emails/config.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * @rovela/sdk/emails/config
+ *
+ * Email configuration and Resend client management.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getResend = getResend;
+exports.getFromEmail = getFromEmail;
+exports.getStoreName = getStoreName;
+exports.getStoreUrl = getStoreUrl;
+exports.getEmailConfig = getEmailConfig;
+exports.getSupportEmail = getSupportEmail;
+const resend_1 = require("resend");
+// =============================================================================
+// Resend Client
+// =============================================================================
+let resendClient = null;
+/**
+ * Get or create Resend client instance.
+ * Lazily initialized on first use.
+ *
+ * @throws Error if RESEND_API_KEY is not set
+ */
+function getResend() {
+    if (!resendClient) {
+        const apiKey = process.env.RESEND_API_KEY;
+        if (!apiKey) {
+            throw new Error('RESEND_API_KEY environment variable is not set. ' +
+                'Please add your Resend API key to .env.local:\n' +
+                'RESEND_API_KEY=re_xxx');
+        }
+        resendClient = new resend_1.Resend(apiKey);
+    }
+    return resendClient;
+}
+// =============================================================================
+// Email Configuration
+// =============================================================================
+/**
+ * Get the sender email address.
+ * Format: "Store Name <email@domain.com>"
+ */
+function getFromEmail() {
+    const email = process.env.RESEND_FROM_EMAIL || 'noreply@example.com';
+    const storeName = getStoreName();
+    return `${storeName} <${email}>`;
+}
+/**
+ * Get the store name from environment configuration.
+ *
+ * The STORE_NAME environment variable is set during store deployment
+ * from the blueprint's store.name value.
+ *
+ * @returns Store name from STORE_NAME env var, or 'Our Store' as fallback
+ */
+function getStoreName() {
+    return process.env.STORE_NAME || 'Our Store';
+}
+/**
+ * Get the store URL for links in emails.
+ */
+function getStoreUrl() {
+    return process.env.NEXT_PUBLIC_APP_URL || process.env.NEXTAUTH_URL || '';
+}
+/**
+ * Get the complete email configuration for templates.
+ * Assembles config from environment variables and blueprint.
+ */
+function getEmailConfig() {
+    return {
+        logoUrl: process.env.STORE_LOGO_URL || '',
+        storeName: getStoreName(),
+        storeAddress: process.env.STORE_ADDRESS || '',
+        supportEmail: process.env.SUPPORT_EMAIL ||
+            process.env.RESEND_FROM_EMAIL ||
+            'support@example.com',
+        shopUrl: getStoreUrl(),
+    };
+}
+/**
+ * Get the support email address.
+ */
+function getSupportEmail() {
+    return (process.env.SUPPORT_EMAIL ||
+        process.env.RESEND_FROM_EMAIL ||
+        'support@example.com');
+}
+//# sourceMappingURL=config.js.map

package/dist/emails/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/emails/config.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAiBH,8BAgBC;AAUD,oCAKC;AAUD,oCAEC;AAKD,kCAEC;AAMD,wCAWC;AAKD,0CAMC;AA7FD,mCAA+B;AAG/B,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF,IAAI,YAAY,GAAkB,IAAI,CAAA;AAEtC;;;;;GAKG;AACH,SAAgB,SAAS;IACvB,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAA;QAEzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,kDAAkD;gBAChD,iDAAiD;gBACjD,uBAAuB,CAC1B,CAAA;QACH,CAAC;QAED,YAAY,GAAG,IAAI,eAAM,CAAC,MAAM,CAAC,CAAA;IACnC,CAAC;IAED,OAAO,YAAY,CAAA;AACrB,CAAC;AAED,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF;;;GAGG;AACH,SAAgB,YAAY;IAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,qBAAqB,CAAA;IACpE,MAAM,SAAS,GAAG,YAAY,EAAE,CAAA;IAEhC,OAAO,GAAG,SAAS,KAAK,KAAK,GAAG,CAAA;AAClC,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,YAAY;IAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,WAAW,CAAA;AAC9C,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW;IACzB,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAA;AAC1E,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc;IAC5B,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE;QACzC,SAAS,EAAE,YAAY,EAAE;QACzB,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE;QAC7C,YAAY,EACV,OAAO,CAAC,GAAG,CAAC,aAAa;YACzB,OAAO,CAAC,GAAG,CAAC,iBAAiB;YAC7B,qBAAqB;QACvB,OAAO,EAAE,WAAW,EAAE;KACvB,CAAA;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe;IAC7B,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,aAAa;QACzB,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAC7B,qBAAqB,CACtB,CAAA;AACH,CAAC"}

package/dist/emails/index.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @rovela/sdk/emails
+ *
+ * Transactional email module for e-commerce stores.
+ *
+ * This module provides:
+ * - Email template rendering functions
+ * - Send functions for common transactional emails
+ * - Configuration utilities for Resend integration
+ *
+ * @example Basic Usage
+ * ```typescript
+ * import { sendOrderConfirmation, sendVerificationEmail } from '@rovela/sdk/emails'
+ *
+ * // Send order confirmation
+ * await sendOrderConfirmation({
+ *   to: 'customer@example.com',
+ *   customerName: 'John',
+ *   orderNumber: 'ORD-12345',
+ *   // ... other params
+ * })
+ *
+ * // Send verification email
+ * await sendVerificationEmail({
+ *   to: 'customer@example.com',
+ *   customerName: 'John',
+ *   verificationLink: 'https://store.com/verify?token=...',
+ * })
+ * ```
+ *
+ * @example Fire-and-Forget (Webhooks)
+ * ```typescript
+ * import { sendOrderConfirmationAsync } from '@rovela/sdk/emails'
+ *
+ * // In webhook handler - don't wait for email
+ * sendOrderConfirmationAsync({
+ *   to: 'customer@example.com',
+ *   // ...
+ * })
+ *
+ * // Return immediately
+ * return Response.json({ received: true })
+ * ```
+ *
+ * @example Custom Templates
+ * ```typescript
+ * import { sendEmail, getEmailConfig, baseLayout } from '@rovela/sdk/emails'
+ *
+ * // Build custom email HTML
+ * const config = getEmailConfig()
+ * const html = baseLayout({
+ *   config,
+ *   title: 'Custom Email',
+ *   content: '<h1>Hello World</h1>',
+ * })
+ *
+ * // Send it
+ * await sendEmail({
+ *   to: 'customer@example.com',
+ *   subject: 'Custom Email',
+ *   html,
+ * })
+ * ```
+ *
+ * ## Environment Variables
+ *
+ * Required:
+ * - `RESEND_API_KEY` - Your Resend API key
+ * - `RESEND_FROM_EMAIL` - Sender email address (must be verified in Resend)
+ *
+ * Optional:
+ * - `STORE_NAME` - Store name (falls back to blueprint config)
+ * - `STORE_LOGO_URL` - Logo URL for emails
+ * - `STORE_ADDRESS` - Physical address for footer
+ * - `SUPPORT_EMAIL` - Support email (falls back to RESEND_FROM_EMAIL)
+ * - `NEXT_PUBLIC_APP_URL` - Store URL for links
+ */
+export type { EmailConfig, SendEmailOptions, SendEmailResult, EmailAddress, EmailOrderItem, EmailVerificationData, WelcomeEmailData, PasswordResetEmailData, OrderConfirmationData, OrderShippedData, OrderDeliveredData, OrderCancelledData, RefundProcessedData, EmailTemplateType, EmailData, } from './types';
+export { getResend, getFromEmail, getStoreName, getStoreUrl, getEmailConfig, getSupportEmail, } from './config';
+export { sendEmail, sendEmailAsync, sendEmailBatch } from './sender';
+export { formatDate, formatDateTime, formatPrice, formatAddressLine, formatAddressHtml, escapeHtml, emailButton, emailFooter, formatOrderNumber, } from './utils';
+export { baseLayout, primaryButton, heading, paragraph, infoBox, linkFallback, detailBox, statusBadge, highlightBox, secondaryButton, addressSection, sectionHeading, STYLES, renderEmailVerification, getEmailVerificationSubject, renderWelcomeEmail, getWelcomeEmailSubject, renderPasswordResetEmail, getPasswordResetSubject, renderOrderConfirmation, getOrderConfirmationSubject, renderOrderShipped, getOrderShippedSubject, renderOrderDelivered, getOrderDeliveredSubject, renderOrderCancelled, getOrderCancelledSubject, renderRefundProcessed, getRefundProcessedSubject, } from './templates';
+export { sendVerificationEmail, sendVerificationEmailAsync, sendWelcomeEmail, sendWelcomeEmailAsync, sendPasswordResetEmail, sendPasswordResetEmailAsync, sendOrderConfirmation, sendOrderConfirmationAsync, sendOrderShipped, sendOrderShippedAsync, sendOrderDelivered, sendOrderDeliveredAsync, sendOrderCancelled, sendOrderCancelledAsync, sendRefundProcessed, sendRefundProcessedAsync, } from './send';
+export type { SendVerificationEmailParams, SendWelcomeEmailParams, SendPasswordResetEmailParams, SendOrderConfirmationParams, SendOrderShippedParams, SendOrderDeliveredParams, SendOrderCancelledParams, SendRefundProcessedParams, } from './send';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/emails/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4EG;AAMH,YAAY,EAEV,WAAW,EACX,gBAAgB,EAChB,eAAe,EAEf,YAAY,EACZ,cAAc,EAEd,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EAEtB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EAEnB,iBAAiB,EACjB,SAAS,GACV,MAAM,SAAS,CAAA;AAMhB,OAAO,EACL,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,eAAe,GAChB,MAAM,UAAU,CAAA;AAMjB,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAMpE,OAAO,EACL,UAAU,EACV,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,WAAW,EACX,iBAAiB,GAClB,MAAM,SAAS,CAAA;AAMhB,OAAO,EAEL,UAAU,EACV,aAAa,EACb,OAAO,EACP,SAAS,EACT,OAAO,EACP,YAAY,EACZ,SAAS,EACT,WAAW,EACX,YAAY,EACZ,eAAe,EACf,cAAc,EACd,cAAc,EACd,MAAM,EAEN,uBAAuB,EACvB,2BAA2B,EAC3B,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EAEvB,uBAAuB,EACvB,2BAA2B,EAC3B,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,aAAa,CAAA;AAMpB,OAAO,EAEL,qBAAqB,EACrB,0BAA0B,EAC1B,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,EAE3B,qBAAqB,EACrB,0BAA0B,EAC1B,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,QAAQ,CAAA;AAGf,YAAY,EACV,2BAA2B,EAC3B,sBAAsB,EACtB,4BAA4B,EAC5B,2BAA2B,EAC3B,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,QAAQ,CAAA"}