@rovela-ai/sdk 0.4.1 → 0.4.2

package/dist/emails/send/orders.d.ts

@@ -0,0 +1,186 @@
+/**
+ * @rovela/sdk/emails/send/orders
+ *
+ * Send functions for order-related emails.
+ */
+import type { SendEmailResult, EmailOrderItem, EmailAddress } from '../types';
+export interface SendOrderConfirmationParams {
+    to: string;
+    customerName: string;
+    orderNumber: string;
+    orderDate: string;
+    paymentStatus: string;
+    items: EmailOrderItem[];
+    subtotal: string;
+    /** Formatted discount amount (e.g., "-$10.00") - optional */
+    discount?: string;
+    /** Discount code used (e.g., "SUMMER20") - optional */
+    discountCode?: string;
+    shippingCost: string;
+    tax: string;
+    total: string;
+    shippingAddress: EmailAddress;
+    orderTrackingUrl: string;
+    /** URL to view/download Stripe receipt */
+    receiptUrl?: string;
+}
+/**
+ * Send an order confirmation email.
+ *
+ * @example
+ * ```typescript
+ * import { sendOrderConfirmation } from '@rovela/sdk/emails'
+ *
+ * await sendOrderConfirmation({
+ *   to: 'john@example.com',
+ *   customerName: 'John',
+ *   orderNumber: 'ORD-12345',
+ *   orderDate: 'November 28, 2025',
+ *   paymentStatus: 'Paid',
+ *   items: [{ name: 'Product', quantity: 1, price: '$29.99' }],
+ *   subtotal: '$29.99',
+ *   shippingCost: '$5.00',
+ *   tax: '$2.80',
+ *   total: '$37.79',
+ *   shippingAddress: { name: 'John Doe', ... },
+ *   orderTrackingUrl: 'https://store.com/orders/12345',
+ * })
+ * ```
+ */
+export declare function sendOrderConfirmation(params: SendOrderConfirmationParams): Promise<SendEmailResult>;
+/**
+ * Send order confirmation without waiting (fire-and-forget).
+ * Use this in webhooks to not block the response.
+ */
+export declare function sendOrderConfirmationAsync(params: SendOrderConfirmationParams): void;
+export interface SendOrderShippedParams {
+    to: string;
+    customerName: string;
+    orderNumber: string;
+    trackingNumber: string;
+    carrierName: string;
+    estimatedDeliveryDate: string;
+    shippingAddress: EmailAddress;
+    trackingUrl: string;
+}
+/**
+ * Send an order shipped email.
+ *
+ * @example
+ * ```typescript
+ * import { sendOrderShipped } from '@rovela/sdk/emails'
+ *
+ * await sendOrderShipped({
+ *   to: 'john@example.com',
+ *   customerName: 'John',
+ *   orderNumber: 'ORD-12345',
+ *   trackingNumber: '1Z999AA10123456784',
+ *   carrierName: 'UPS',
+ *   estimatedDeliveryDate: 'December 3, 2025',
+ *   shippingAddress: { name: 'John Doe', ... },
+ *   trackingUrl: 'https://ups.com/track/...',
+ * })
+ * ```
+ */
+export declare function sendOrderShipped(params: SendOrderShippedParams): Promise<SendEmailResult>;
+/**
+ * Send order shipped without waiting (fire-and-forget).
+ */
+export declare function sendOrderShippedAsync(params: SendOrderShippedParams): void;
+export interface SendOrderDeliveredParams {
+    to: string;
+    customerName: string;
+    orderNumber: string;
+    deliveryDate: string;
+    /** Optional delivery location description (e.g., "Front Door") */
+    deliveryLocation?: string;
+    /** Optional URL to leave a review */
+    reviewUrl?: string;
+    /** Optional URL to return center */
+    returnCenterUrl?: string;
+}
+/**
+ * Send an order delivered email.
+ *
+ * @example
+ * ```typescript
+ * import { sendOrderDelivered } from '@rovela/sdk/emails'
+ *
+ * await sendOrderDelivered({
+ *   to: 'john@example.com',
+ *   customerName: 'John',
+ *   orderNumber: 'ORD-12345',
+ *   deliveryDate: 'December 3, 2025',
+ * })
+ * ```
+ */
+export declare function sendOrderDelivered(params: SendOrderDeliveredParams): Promise<SendEmailResult>;
+/**
+ * Send order delivered without waiting (fire-and-forget).
+ */
+export declare function sendOrderDeliveredAsync(params: SendOrderDeliveredParams): void;
+export interface SendOrderCancelledParams {
+    to: string;
+    customerName: string;
+    orderNumber: string;
+    cancellationReason?: string;
+    cancellationDate: string;
+    refundMessage: string;
+}
+/**
+ * Send an order cancelled email.
+ *
+ * @example
+ * ```typescript
+ * import { sendOrderCancelled } from '@rovela/sdk/emails'
+ *
+ * await sendOrderCancelled({
+ *   to: 'john@example.com',
+ *   customerName: 'John',
+ *   orderNumber: 'ORD-12345',
+ *   cancellationReason: 'Customer requested cancellation.',
+ *   cancellationDate: 'November 28, 2025',
+ *   refundMessage: 'Your refund will be processed within 3-5 business days.',
+ * })
+ * ```
+ */
+export declare function sendOrderCancelled(params: SendOrderCancelledParams): Promise<SendEmailResult>;
+/**
+ * Send order cancelled without waiting (fire-and-forget).
+ */
+export declare function sendOrderCancelledAsync(params: SendOrderCancelledParams): void;
+export interface SendRefundProcessedParams {
+    to: string;
+    customerName: string;
+    orderNumber: string;
+    refundAmount: string;
+    refundDate: string;
+    paymentMethod: string;
+    estimatedArrival: string;
+    businessDays: string;
+}
+/**
+ * Send a refund processed email.
+ *
+ * @example
+ * ```typescript
+ * import { sendRefundProcessed } from '@rovela/sdk/emails'
+ *
+ * await sendRefundProcessed({
+ *   to: 'john@example.com',
+ *   customerName: 'John',
+ *   orderNumber: 'ORD-12345',
+ *   refundAmount: '$99.00',
+ *   refundDate: 'November 28, 2025',
+ *   paymentMethod: 'Visa ending in 4242',
+ *   estimatedArrival: '3-5 business days',
+ *   businessDays: '3-5',
+ * })
+ * ```
+ */
+export declare function sendRefundProcessed(params: SendRefundProcessedParams): Promise<SendEmailResult>;
+/**
+ * Send refund processed without waiting (fire-and-forget).
+ */
+export declare function sendRefundProcessedAsync(params: SendRefundProcessedParams): void;
+//# sourceMappingURL=orders.d.ts.map

package/dist/emails/send/orders.d.ts.map

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

package/dist/emails/send/orders.js

@@ -0,0 +1,258 @@
+/**
+ * @rovela/sdk/emails/send/orders
+ *
+ * Send functions for order-related emails.
+ */
+import { sendEmail } from '../sender';
+import { getEmailConfig, getStoreName } from '../config';
+import { renderOrderConfirmation, getOrderConfirmationSubject, renderOrderShipped, getOrderShippedSubject, renderOrderDelivered, getOrderDeliveredSubject, renderOrderCancelled, getOrderCancelledSubject, renderRefundProcessed, getRefundProcessedSubject, } from '../templates';
+/**
+ * Send an order confirmation email.
+ *
+ * @example
+ * ```typescript
+ * import { sendOrderConfirmation } from '@rovela/sdk/emails'
+ *
+ * await sendOrderConfirmation({
+ *   to: 'john@example.com',
+ *   customerName: 'John',
+ *   orderNumber: 'ORD-12345',
+ *   orderDate: 'November 28, 2025',
+ *   paymentStatus: 'Paid',
+ *   items: [{ name: 'Product', quantity: 1, price: '$29.99' }],
+ *   subtotal: '$29.99',
+ *   shippingCost: '$5.00',
+ *   tax: '$2.80',
+ *   total: '$37.79',
+ *   shippingAddress: { name: 'John Doe', ... },
+ *   orderTrackingUrl: 'https://store.com/orders/12345',
+ * })
+ * ```
+ */
+export async function sendOrderConfirmation(params) {
+    const [config, storeName] = await Promise.all([
+        getEmailConfig(),
+        getStoreName(),
+    ]);
+    const html = renderOrderConfirmation({
+        config,
+        customerName: params.customerName,
+        customerEmail: params.to,
+        orderNumber: params.orderNumber,
+        orderDate: params.orderDate,
+        paymentStatus: params.paymentStatus,
+        items: params.items,
+        subtotal: params.subtotal,
+        discount: params.discount,
+        discountCode: params.discountCode,
+        shippingCost: params.shippingCost,
+        tax: params.tax,
+        total: params.total,
+        shippingAddress: params.shippingAddress,
+        orderTrackingUrl: params.orderTrackingUrl,
+        receiptUrl: params.receiptUrl,
+    });
+    return sendEmail({
+        to: params.to,
+        subject: getOrderConfirmationSubject(storeName, params.orderNumber),
+        html,
+    });
+}
+/**
+ * Send order confirmation without waiting (fire-and-forget).
+ * Use this in webhooks to not block the response.
+ */
+export function sendOrderConfirmationAsync(params) {
+    sendOrderConfirmation(params).catch((err) => {
+        console.error('[Email] Failed to send order confirmation:', err);
+    });
+}
+/**
+ * Send an order shipped email.
+ *
+ * @example
+ * ```typescript
+ * import { sendOrderShipped } from '@rovela/sdk/emails'
+ *
+ * await sendOrderShipped({
+ *   to: 'john@example.com',
+ *   customerName: 'John',
+ *   orderNumber: 'ORD-12345',
+ *   trackingNumber: '1Z999AA10123456784',
+ *   carrierName: 'UPS',
+ *   estimatedDeliveryDate: 'December 3, 2025',
+ *   shippingAddress: { name: 'John Doe', ... },
+ *   trackingUrl: 'https://ups.com/track/...',
+ * })
+ * ```
+ */
+export async function sendOrderShipped(params) {
+    const [config, storeName] = await Promise.all([
+        getEmailConfig(),
+        getStoreName(),
+    ]);
+    const html = renderOrderShipped({
+        config,
+        customerName: params.customerName,
+        customerEmail: params.to,
+        orderNumber: params.orderNumber,
+        trackingNumber: params.trackingNumber,
+        carrierName: params.carrierName,
+        estimatedDeliveryDate: params.estimatedDeliveryDate,
+        shippingAddress: params.shippingAddress,
+        trackingUrl: params.trackingUrl,
+    });
+    return sendEmail({
+        to: params.to,
+        subject: getOrderShippedSubject(storeName, params.orderNumber),
+        html,
+    });
+}
+/**
+ * Send order shipped without waiting (fire-and-forget).
+ */
+export function sendOrderShippedAsync(params) {
+    sendOrderShipped(params).catch((err) => {
+        console.error('[Email] Failed to send order shipped email:', err);
+    });
+}
+/**
+ * Send an order delivered email.
+ *
+ * @example
+ * ```typescript
+ * import { sendOrderDelivered } from '@rovela/sdk/emails'
+ *
+ * await sendOrderDelivered({
+ *   to: 'john@example.com',
+ *   customerName: 'John',
+ *   orderNumber: 'ORD-12345',
+ *   deliveryDate: 'December 3, 2025',
+ * })
+ * ```
+ */
+export async function sendOrderDelivered(params) {
+    const [config, storeName] = await Promise.all([
+        getEmailConfig(),
+        getStoreName(),
+    ]);
+    const html = renderOrderDelivered({
+        config,
+        customerName: params.customerName,
+        customerEmail: params.to,
+        orderNumber: params.orderNumber,
+        deliveryDate: params.deliveryDate,
+        // Only pass optional fields if provided
+        ...(params.deliveryLocation && { deliveryLocation: params.deliveryLocation }),
+        ...(params.reviewUrl && { reviewUrl: params.reviewUrl }),
+        ...(params.returnCenterUrl && { returnCenterUrl: params.returnCenterUrl }),
+    });
+    return sendEmail({
+        to: params.to,
+        subject: getOrderDeliveredSubject(storeName, params.orderNumber),
+        html,
+    });
+}
+/**
+ * Send order delivered without waiting (fire-and-forget).
+ */
+export function sendOrderDeliveredAsync(params) {
+    sendOrderDelivered(params).catch((err) => {
+        console.error('[Email] Failed to send order delivered email:', err);
+    });
+}
+/**
+ * Send an order cancelled email.
+ *
+ * @example
+ * ```typescript
+ * import { sendOrderCancelled } from '@rovela/sdk/emails'
+ *
+ * await sendOrderCancelled({
+ *   to: 'john@example.com',
+ *   customerName: 'John',
+ *   orderNumber: 'ORD-12345',
+ *   cancellationReason: 'Customer requested cancellation.',
+ *   cancellationDate: 'November 28, 2025',
+ *   refundMessage: 'Your refund will be processed within 3-5 business days.',
+ * })
+ * ```
+ */
+export async function sendOrderCancelled(params) {
+    const [config, storeName] = await Promise.all([
+        getEmailConfig(),
+        getStoreName(),
+    ]);
+    const html = renderOrderCancelled({
+        config,
+        customerName: params.customerName,
+        customerEmail: params.to,
+        orderNumber: params.orderNumber,
+        cancellationReason: params.cancellationReason,
+        cancellationDate: params.cancellationDate,
+        refundMessage: params.refundMessage,
+    });
+    return sendEmail({
+        to: params.to,
+        subject: getOrderCancelledSubject(storeName, params.orderNumber),
+        html,
+    });
+}
+/**
+ * Send order cancelled without waiting (fire-and-forget).
+ */
+export function sendOrderCancelledAsync(params) {
+    sendOrderCancelled(params).catch((err) => {
+        console.error('[Email] Failed to send order cancelled email:', err);
+    });
+}
+/**
+ * Send a refund processed email.
+ *
+ * @example
+ * ```typescript
+ * import { sendRefundProcessed } from '@rovela/sdk/emails'
+ *
+ * await sendRefundProcessed({
+ *   to: 'john@example.com',
+ *   customerName: 'John',
+ *   orderNumber: 'ORD-12345',
+ *   refundAmount: '$99.00',
+ *   refundDate: 'November 28, 2025',
+ *   paymentMethod: 'Visa ending in 4242',
+ *   estimatedArrival: '3-5 business days',
+ *   businessDays: '3-5',
+ * })
+ * ```
+ */
+export async function sendRefundProcessed(params) {
+    const [config, storeName] = await Promise.all([
+        getEmailConfig(),
+        getStoreName(),
+    ]);
+    const html = renderRefundProcessed({
+        config,
+        customerName: params.customerName,
+        customerEmail: params.to,
+        orderNumber: params.orderNumber,
+        refundAmount: params.refundAmount,
+        refundDate: params.refundDate,
+        paymentMethod: params.paymentMethod,
+        estimatedArrival: params.estimatedArrival,
+        businessDays: params.businessDays,
+    });
+    return sendEmail({
+        to: params.to,
+        subject: getRefundProcessedSubject(storeName, params.orderNumber),
+        html,
+    });
+}
+/**
+ * Send refund processed without waiting (fire-and-forget).
+ */
+export function sendRefundProcessedAsync(params) {
+    sendRefundProcessed(params).catch((err) => {
+        console.error('[Email] Failed to send refund processed email:', err);
+    });
+}
+//# sourceMappingURL=orders.js.map

package/dist/emails/send/orders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orders.js","sourceRoot":"","sources":["../../../src/emails/send/orders.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAMxD,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,cAAc,CAAA;AA2BrB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAmC;IAEnC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC5C,cAAc,EAAE;QAChB,YAAY,EAAE;KACf,CAAC,CAAA;IAEF,MAAM,IAAI,GAAG,uBAAuB,CAAC;QACnC,MAAM;QACN,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,aAAa,EAAE,MAAM,CAAC,EAAE;QACxB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC,CAAA;IAEF,OAAO,SAAS,CAAC;QACf,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,OAAO,EAAE,2BAA2B,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC;QACnE,IAAI;KACL,CAAC,CAAA;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAmC;IAEnC,qBAAqB,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QAC1C,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,GAAG,CAAC,CAAA;IAClE,CAAC,CAAC,CAAA;AACJ,CAAC;AAiBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAA8B;IAE9B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC5C,cAAc,EAAE;QAChB,YAAY,EAAE;KACf,CAAC,CAAA;IAEF,MAAM,IAAI,GAAG,kBAAkB,CAAC;QAC9B,MAAM;QACN,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,aAAa,EAAE,MAAM,CAAC,EAAE;QACxB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,qBAAqB,EAAE,MAAM,CAAC,qBAAqB;QACnD,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC,CAAA;IAEF,OAAO,SAAS,CAAC;QACf,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,OAAO,EAAE,sBAAsB,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC;QAC9D,IAAI;KACL,CAAC,CAAA;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAA8B;IAClE,gBAAgB,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACrC,OAAO,CAAC,KAAK,CAAC,6CAA6C,EAAE,GAAG,CAAC,CAAA;IACnE,CAAC,CAAC,CAAA;AACJ,CAAC;AAmBD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAgC;IAEhC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC5C,cAAc,EAAE;QAChB,YAAY,EAAE;KACf,CAAC,CAAA;IAEF,MAAM,IAAI,GAAG,oBAAoB,CAAC;QAChC,MAAM;QACN,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,aAAa,EAAE,MAAM,CAAC,EAAE;QACxB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,wCAAwC;QACxC,GAAG,CAAC,MAAM,CAAC,gBAAgB,IAAI,EAAE,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC7E,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QACxD,GAAG,CAAC,MAAM,CAAC,eAAe,IAAI,EAAE,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,CAAC;KAC3E,CAAC,CAAA;IAEF,OAAO,SAAS,CAAC;QACf,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,OAAO,EAAE,wBAAwB,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC;QAChE,IAAI;KACL,CAAC,CAAA;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAgC;IAEhC,kBAAkB,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACvC,OAAO,CAAC,KAAK,CAAC,+CAA+C,EAAE,GAAG,CAAC,CAAA;IACrE,CAAC,CAAC,CAAA;AACJ,CAAC;AAeD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAgC;IAEhC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC5C,cAAc,EAAE;QAChB,YAAY,EAAE;KACf,CAAC,CAAA;IAEF,MAAM,IAAI,GAAG,oBAAoB,CAAC;QAChC,MAAM;QACN,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,aAAa,EAAE,MAAM,CAAC,EAAE;QACxB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;QAC7C,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,aAAa,EAAE,MAAM,CAAC,aAAa;KACpC,CAAC,CAAA;IAEF,OAAO,SAAS,CAAC;QACf,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,OAAO,EAAE,wBAAwB,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC;QAChE,IAAI;KACL,CAAC,CAAA;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAgC;IAEhC,kBAAkB,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACvC,OAAO,CAAC,KAAK,CAAC,+CAA+C,EAAE,GAAG,CAAC,CAAA;IACrE,CAAC,CAAC,CAAA;AACJ,CAAC;AAiBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAiC;IAEjC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC5C,cAAc,EAAE;QAChB,YAAY,EAAE;KACf,CAAC,CAAA;IAEF,MAAM,IAAI,GAAG,qBAAqB,CAAC;QACjC,MAAM;QACN,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,aAAa,EAAE,MAAM,CAAC,EAAE;QACxB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,YAAY,EAAE,MAAM,CAAC,YAAY;KAClC,CAAC,CAAA;IAEF,OAAO,SAAS,CAAC;QACf,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,OAAO,EAAE,yBAAyB,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC;QACjE,IAAI;KACL,CAAC,CAAA;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAiC;IAEjC,mBAAmB,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACxC,OAAO,CAAC,KAAK,CAAC,gDAAgD,EAAE,GAAG,CAAC,CAAA;IACtE,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/emails/sender.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @rovela/sdk/emails/sender
+ *
+ * Core email sending functionality using Resend.
+ */
+import type { SendEmailOptions, SendEmailResult } from './types';
+/**
+ * Send an email via Resend.
+ *
+ * This is the core sending function used by all email templates.
+ * It handles error catching and returns a result object.
+ *
+ * @example
+ * ```typescript
+ * import { sendEmail } from '@rovela/sdk/emails'
+ *
+ * const result = await sendEmail({
+ *   to: 'customer@example.com',
+ *   subject: 'Order Confirmation',
+ *   html: '<html>...</html>',
+ * })
+ *
+ * if (result.success) {
+ *   console.log('Email sent:', result.messageId)
+ * } else {
+ *   console.error('Email failed:', result.error)
+ * }
+ * ```
+ */
+export declare function sendEmail(options: SendEmailOptions): Promise<SendEmailResult>;
+/**
+ * Send an email without waiting for the result (fire-and-forget).
+ *
+ * Use this when you don't want to block the main flow on email delivery.
+ * Errors are logged but not thrown.
+ *
+ * @example
+ * ```typescript
+ * import { sendEmailAsync } from '@rovela/sdk/emails'
+ *
+ * // In a webhook handler - don't block on email
+ * sendEmailAsync({
+ *   to: 'customer@example.com',
+ *   subject: 'Order Shipped',
+ *   html: orderShippedHtml,
+ * })
+ *
+ * // Continue processing immediately
+ * return Response.json({ received: true })
+ * ```
+ */
+export declare function sendEmailAsync(options: SendEmailOptions): void;
+/**
+ * Send multiple emails in parallel.
+ *
+ * Returns results for all emails, even if some fail.
+ *
+ * @example
+ * ```typescript
+ * import { sendEmailBatch } from '@rovela/sdk/emails'
+ *
+ * const results = await sendEmailBatch([
+ *   { to: 'user1@example.com', subject: 'Hello', html: '...' },
+ *   { to: 'user2@example.com', subject: 'Hello', html: '...' },
+ * ])
+ *
+ * const successful = results.filter(r => r.success).length
+ * console.log(`Sent ${successful}/${results.length} emails`)
+ * ```
+ */
+export declare function sendEmailBatch(emails: SendEmailOptions[]): Promise<SendEmailResult[]>;
+//# sourceMappingURL=sender.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sender.d.ts","sourceRoot":"","sources":["../../src/emails/sender.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAMhE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAsC1B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAI9D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,gBAAgB,EAAE,GACzB,OAAO,CAAC,eAAe,EAAE,CAAC,CAE5B"}

package/dist/emails/sender.js

@@ -0,0 +1,116 @@
+/**
+ * @rovela/sdk/emails/sender
+ *
+ * Core email sending functionality using Resend.
+ */
+import { getResend, getFromEmail, getSupportEmail } from './config';
+// =============================================================================
+// Email Sender
+// =============================================================================
+/**
+ * Send an email via Resend.
+ *
+ * This is the core sending function used by all email templates.
+ * It handles error catching and returns a result object.
+ *
+ * @example
+ * ```typescript
+ * import { sendEmail } from '@rovela/sdk/emails'
+ *
+ * const result = await sendEmail({
+ *   to: 'customer@example.com',
+ *   subject: 'Order Confirmation',
+ *   html: '<html>...</html>',
+ * })
+ *
+ * if (result.success) {
+ *   console.log('Email sent:', result.messageId)
+ * } else {
+ *   console.error('Email failed:', result.error)
+ * }
+ * ```
+ */
+export async function sendEmail(options) {
+    try {
+        const resend = getResend();
+        const [from, replyTo] = await Promise.all([
+            getFromEmail(),
+            options.replyTo ? Promise.resolve(options.replyTo) : getSupportEmail(),
+        ]);
+        const { data, error } = await resend.emails.send({
+            from,
+            to: options.to,
+            subject: options.subject,
+            html: options.html,
+            replyTo,
+        });
+        if (error) {
+            console.error('[Email] Resend error:', error);
+            return {
+                success: false,
+                error: error.message || 'Failed to send email',
+            };
+        }
+        console.log('[Email] Sent successfully:', data?.id, 'to:', options.to);
+        return {
+            success: true,
+            messageId: data?.id,
+        };
+    }
+    catch (err) {
+        const errorMessage = err instanceof Error ? err.message : 'Unknown error sending email';
+        console.error('[Email] Exception:', errorMessage);
+        return {
+            success: false,
+            error: errorMessage,
+        };
+    }
+}
+/**
+ * Send an email without waiting for the result (fire-and-forget).
+ *
+ * Use this when you don't want to block the main flow on email delivery.
+ * Errors are logged but not thrown.
+ *
+ * @example
+ * ```typescript
+ * import { sendEmailAsync } from '@rovela/sdk/emails'
+ *
+ * // In a webhook handler - don't block on email
+ * sendEmailAsync({
+ *   to: 'customer@example.com',
+ *   subject: 'Order Shipped',
+ *   html: orderShippedHtml,
+ * })
+ *
+ * // Continue processing immediately
+ * return Response.json({ received: true })
+ * ```
+ */
+export function sendEmailAsync(options) {
+    sendEmail(options).catch((err) => {
+        console.error('[Email] Async send failed:', err);
+    });
+}
+/**
+ * Send multiple emails in parallel.
+ *
+ * Returns results for all emails, even if some fail.
+ *
+ * @example
+ * ```typescript
+ * import { sendEmailBatch } from '@rovela/sdk/emails'
+ *
+ * const results = await sendEmailBatch([
+ *   { to: 'user1@example.com', subject: 'Hello', html: '...' },
+ *   { to: 'user2@example.com', subject: 'Hello', html: '...' },
+ * ])
+ *
+ * const successful = results.filter(r => r.success).length
+ * console.log(`Sent ${successful}/${results.length} emails`)
+ * ```
+ */
+export async function sendEmailBatch(emails) {
+    return Promise.all(emails.map(sendEmail));
+}
+//# sourceMappingURL=sender.js.map

package/dist/emails/sender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sender.js","sourceRoot":"","sources":["../../src/emails/sender.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAGnE,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,OAAyB;IAEzB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;QAC1B,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACxC,YAAY,EAAE;YACd,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE;SACvE,CAAC,CAAA;QAEF,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;YAC/C,IAAI;YACJ,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,OAAO;SACR,CAAC,CAAA;QAEF,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAA;YAC7C,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,CAAC,OAAO,IAAI,sBAAsB;aAC/C,CAAA;QACH,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;QACtE,OAAO;YACL,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI,EAAE,EAAE;SACpB,CAAA;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,YAAY,GAChB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B,CAAA;QACpE,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,YAAY,CAAC,CAAA;QACjD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,YAAY;SACpB,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,cAAc,CAAC,OAAyB;IACtD,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QAC/B,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAA;IAClD,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAA0B;IAE1B,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAA;AAC3C,CAAC"}