@rovela-ai/sdk 0.4.1 → 0.4.2

package/dist/emails/index.js

@@ -0,0 +1,110 @@
+/**
+ * @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
+ */
+// =============================================================================
+// Configuration
+// =============================================================================
+export { getResend, getFromEmail, getStoreName, getStoreUrl, getEmailConfig, getSupportEmail, } from './config';
+// =============================================================================
+// Core Sender
+// =============================================================================
+export { sendEmail, sendEmailAsync, sendEmailBatch } from './sender';
+// =============================================================================
+// Utilities
+// =============================================================================
+export { formatDate, formatDateTime, formatPrice, formatAddressLine, formatAddressHtml, escapeHtml, emailButton, emailFooter, formatOrderNumber, } from './utils';
+// =============================================================================
+// Templates (Render Functions)
+// =============================================================================
+export { 
+// Base components
+baseLayout, primaryButton, heading, paragraph, infoBox, linkFallback, detailBox, statusBadge, highlightBox, secondaryButton, addressSection, sectionHeading, STYLES, 
+// Auth templates
+renderEmailVerification, getEmailVerificationSubject, renderWelcomeEmail, getWelcomeEmailSubject, renderPasswordResetEmail, getPasswordResetSubject, 
+// Order templates
+renderOrderConfirmation, getOrderConfirmationSubject, renderOrderShipped, getOrderShippedSubject, renderOrderDelivered, getOrderDeliveredSubject, renderOrderCancelled, getOrderCancelledSubject, renderRefundProcessed, getRefundProcessedSubject, } from './templates';
+// =============================================================================
+// Send Functions (Convenience)
+// =============================================================================
+export { 
+// Auth emails (customer)
+sendVerificationEmail, sendVerificationEmailAsync, sendWelcomeEmail, sendWelcomeEmailAsync, sendPasswordResetEmail, sendPasswordResetEmailAsync, 
+// Admin auth emails
+sendAdminPasswordResetEmail, sendAdminPasswordResetEmailAsync, sendAdminInviteEmail, sendAdminInviteEmailAsync, 
+// Order emails
+sendOrderConfirmation, sendOrderConfirmationAsync, sendOrderShipped, sendOrderShippedAsync, sendOrderDelivered, sendOrderDeliveredAsync, sendOrderCancelled, sendOrderCancelledAsync, sendRefundProcessed, sendRefundProcessedAsync, } from './send';
+//# sourceMappingURL=index.js.map

package/dist/emails/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/emails/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4EG;AA6BH,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF,OAAO,EACL,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,eAAe,GAChB,MAAM,UAAU,CAAA;AAEjB,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAEpE,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,OAAO,EACL,UAAU,EACV,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,WAAW,EACX,iBAAiB,GAClB,MAAM,SAAS,CAAA;AAEhB,gFAAgF;AAChF,+BAA+B;AAC/B,gFAAgF;AAEhF,OAAO;AACL,kBAAkB;AAClB,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;AACN,iBAAiB;AACjB,uBAAuB,EACvB,2BAA2B,EAC3B,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB;AACvB,kBAAkB;AAClB,uBAAuB,EACvB,2BAA2B,EAC3B,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,aAAa,CAAA;AAEpB,gFAAgF;AAChF,+BAA+B;AAC/B,gFAAgF;AAEhF,OAAO;AACL,yBAAyB;AACzB,qBAAqB,EACrB,0BAA0B,EAC1B,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B;AAC3B,oBAAoB;AACpB,2BAA2B,EAC3B,gCAAgC,EAChC,oBAAoB,EACpB,yBAAyB;AACzB,eAAe;AACf,qBAAqB,EACrB,0BAA0B,EAC1B,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,QAAQ,CAAA"}

package/dist/emails/send/admin-auth.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @rovela/sdk/emails/send/admin-auth
+ *
+ * Send functions for admin-specific authentication emails.
+ *
+ * Currently ships:
+ *   - sendAdminPasswordResetEmail (Phase 1 — forgot-password flow)
+ *
+ * Phase 3 will add `sendAdminInviteEmail` here when the invite flow lands.
+ */
+import type { SendEmailResult } from '../types';
+export interface SendAdminPasswordResetEmailParams {
+    /** Admin email address */
+    to: string;
+    /** Admin's display name (used in greeting) */
+    adminName: string;
+    /** Password reset link URL (e.g. `https://store.com/admin/reset-password?token=...`) */
+    resetLink: string;
+    /** Link expiry time in hours as a string (default: "1") */
+    expiryTime?: string;
+}
+/**
+ * Send a password reset email to an admin.
+ *
+ * Reuses the existing customer `renderPasswordResetEmail` template, which
+ * has neutral copy ("Reset Your Password") that works for any recipient.
+ * The `customerName` field in `PasswordResetEmailData` is overloaded here
+ * to carry the admin's display name — cosmetic naming only, no functional
+ * difference. If future requirements diverge, swap in a dedicated template.
+ *
+ * @example
+ * ```typescript
+ * import { sendAdminPasswordResetEmail } from '@rovela-ai/sdk/emails'
+ *
+ * await sendAdminPasswordResetEmail({
+ *   to: 'owner@store.com',
+ *   adminName: 'Jane',
+ *   resetLink: 'https://store.com/admin/reset-password?token=...',
+ * })
+ * ```
+ */
+export declare function sendAdminPasswordResetEmail(params: SendAdminPasswordResetEmailParams): Promise<SendEmailResult>;
+export interface SendAdminInviteEmailParams {
+    /** Invitee email address */
+    to: string;
+    /** Invitee's display name (used in greeting) */
+    adminName: string;
+    /** Display name of the admin who sent the invite */
+    inviterName: string;
+    /** Human-readable role label: "Owner" | "Administrator" | "Manager" | "User" */
+    roleLabel: string;
+    /** Accept-invite URL (e.g. `https://store.com/admin/accept-invite?token=...`) */
+    acceptLink: string;
+    /** Expiry time in hours as a string (default: "72") */
+    expiryHours?: string;
+}
+/**
+ * Send an invite email to a newly-created admin.
+ *
+ * Uses the dedicated `admin-invite.ts` template — copy is purpose-built
+ * for the invite flow (headline, inviter attribution, role callout, CTA,
+ * expiry note). Unlike `sendAdminPasswordResetEmail`, this does NOT reuse
+ * the customer template.
+ *
+ * Failures propagate to the caller. The `user-management.ts::inviteAdmin`
+ * service catches email errors and still returns success with the
+ * inviteUrl so the caller can share it manually.
+ *
+ * @example
+ * ```typescript
+ * import { sendAdminInviteEmail } from '@rovela-ai/sdk/emails'
+ *
+ * await sendAdminInviteEmail({
+ *   to: 'jane@example.com',
+ *   adminName: 'Jane',
+ *   inviterName: 'Chris',
+ *   roleLabel: 'Administrator',
+ *   acceptLink: 'https://store.com/admin/accept-invite?token=...',
+ * })
+ * ```
+ */
+export declare function sendAdminInviteEmail(params: SendAdminInviteEmailParams): Promise<SendEmailResult>;
+/**
+ * Fire-and-forget variant of `sendAdminInviteEmail`.
+ */
+export declare function sendAdminInviteEmailAsync(params: SendAdminInviteEmailParams): void;
+/**
+ * Fire-and-forget variant of `sendAdminPasswordResetEmail`.
+ *
+ * Use in hot paths where you don't want to await email delivery.
+ * Errors are logged and swallowed — the caller never sees them.
+ */
+export declare function sendAdminPasswordResetEmailAsync(params: SendAdminPasswordResetEmailParams): void;
+//# sourceMappingURL=admin-auth.d.ts.map

package/dist/emails/send/admin-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-auth.d.ts","sourceRoot":"","sources":["../../../src/emails/send/admin-auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAM/C,MAAM,WAAW,iCAAiC;IAChD,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAA;IACjB,wFAAwF;IACxF,SAAS,EAAE,MAAM,CAAA;IACjB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,iCAAiC,GACxC,OAAO,CAAC,eAAe,CAAC,CAkB1B;AAMD,MAAM,WAAW,0BAA0B;IACzC,4BAA4B;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAA;IACjB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAA;IACnB,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAA;IACjB,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAA;IAClB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,eAAe,CAAC,CAqB1B;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,0BAA0B,GACjC,IAAI,CAIN;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,iCAAiC,GACxC,IAAI,CAIN"}

package/dist/emails/send/admin-auth.js

@@ -0,0 +1,118 @@
+/**
+ * @rovela/sdk/emails/send/admin-auth
+ *
+ * Send functions for admin-specific authentication emails.
+ *
+ * Currently ships:
+ *   - sendAdminPasswordResetEmail (Phase 1 — forgot-password flow)
+ *
+ * Phase 3 will add `sendAdminInviteEmail` here when the invite flow lands.
+ */
+import { sendEmail } from '../sender';
+import { getEmailConfig, getStoreName } from '../config';
+import { renderPasswordResetEmail, getPasswordResetSubject, renderAdminInviteEmail, getAdminInviteSubject, } from '../templates';
+// =============================================================================
+// Send functions
+// =============================================================================
+/**
+ * Send a password reset email to an admin.
+ *
+ * Reuses the existing customer `renderPasswordResetEmail` template, which
+ * has neutral copy ("Reset Your Password") that works for any recipient.
+ * The `customerName` field in `PasswordResetEmailData` is overloaded here
+ * to carry the admin's display name — cosmetic naming only, no functional
+ * difference. If future requirements diverge, swap in a dedicated template.
+ *
+ * @example
+ * ```typescript
+ * import { sendAdminPasswordResetEmail } from '@rovela-ai/sdk/emails'
+ *
+ * await sendAdminPasswordResetEmail({
+ *   to: 'owner@store.com',
+ *   adminName: 'Jane',
+ *   resetLink: 'https://store.com/admin/reset-password?token=...',
+ * })
+ * ```
+ */
+export async function sendAdminPasswordResetEmail(params) {
+    const [config, storeName] = await Promise.all([
+        getEmailConfig(),
+        getStoreName(),
+    ]);
+    const html = renderPasswordResetEmail({
+        config,
+        customerName: params.adminName,
+        resetLink: params.resetLink,
+        expiryTime: params.expiryTime || '1',
+    });
+    return sendEmail({
+        to: params.to,
+        subject: getPasswordResetSubject(storeName),
+        html,
+    });
+}
+/**
+ * Send an invite email to a newly-created admin.
+ *
+ * Uses the dedicated `admin-invite.ts` template — copy is purpose-built
+ * for the invite flow (headline, inviter attribution, role callout, CTA,
+ * expiry note). Unlike `sendAdminPasswordResetEmail`, this does NOT reuse
+ * the customer template.
+ *
+ * Failures propagate to the caller. The `user-management.ts::inviteAdmin`
+ * service catches email errors and still returns success with the
+ * inviteUrl so the caller can share it manually.
+ *
+ * @example
+ * ```typescript
+ * import { sendAdminInviteEmail } from '@rovela-ai/sdk/emails'
+ *
+ * await sendAdminInviteEmail({
+ *   to: 'jane@example.com',
+ *   adminName: 'Jane',
+ *   inviterName: 'Chris',
+ *   roleLabel: 'Administrator',
+ *   acceptLink: 'https://store.com/admin/accept-invite?token=...',
+ * })
+ * ```
+ */
+export async function sendAdminInviteEmail(params) {
+    const [config, storeName] = await Promise.all([
+        getEmailConfig(),
+        getStoreName(),
+    ]);
+    const html = renderAdminInviteEmail({
+        config,
+        adminName: params.adminName,
+        inviterName: params.inviterName,
+        storeName,
+        roleLabel: params.roleLabel,
+        acceptLink: params.acceptLink,
+        expiryHours: params.expiryHours || '72',
+    });
+    return sendEmail({
+        to: params.to,
+        subject: getAdminInviteSubject(storeName, params.inviterName),
+        html,
+    });
+}
+/**
+ * Fire-and-forget variant of `sendAdminInviteEmail`.
+ */
+export function sendAdminInviteEmailAsync(params) {
+    sendAdminInviteEmail(params).catch((err) => {
+        console.error('[Admin Email] Failed to send invite email:', err);
+    });
+}
+/**
+ * Fire-and-forget variant of `sendAdminPasswordResetEmail`.
+ *
+ * Use in hot paths where you don't want to await email delivery.
+ * Errors are logged and swallowed — the caller never sees them.
+ */
+export function sendAdminPasswordResetEmailAsync(params) {
+    sendAdminPasswordResetEmail(params).catch((err) => {
+        console.error('[Admin Email] Failed to send password reset email:', err);
+    });
+}
+//# sourceMappingURL=admin-auth.js.map

package/dist/emails/send/admin-auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-auth.js","sourceRoot":"","sources":["../../../src/emails/send/admin-auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACxD,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,cAAc,CAAA;AAkBrB,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,MAAyC;IAEzC,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,wBAAwB,CAAC;QACpC,MAAM;QACN,YAAY,EAAE,MAAM,CAAC,SAAS;QAC9B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,GAAG;KACrC,CAAC,CAAA;IAEF,OAAO,SAAS,CAAC;QACf,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,OAAO,EAAE,uBAAuB,CAAC,SAAS,CAAC;QAC3C,IAAI;KACL,CAAC,CAAA;AACJ,CAAC;AAqBD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAkC;IAElC,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,sBAAsB,CAAC;QAClC,MAAM;QACN,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,SAAS;QACT,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,IAAI;KACxC,CAAC,CAAA;IAEF,OAAO,SAAS,CAAC;QACf,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,OAAO,EAAE,qBAAqB,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC;QAC7D,IAAI;KACL,CAAC,CAAA;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAkC;IAElC,oBAAoB,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACzC,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,GAAG,CAAC,CAAA;IAClE,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gCAAgC,CAC9C,MAAyC;IAEzC,2BAA2B,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QAChD,OAAO,CAAC,KAAK,CAAC,oDAAoD,EAAE,GAAG,CAAC,CAAA;IAC1E,CAAC,CAAC,CAAA;AACJ,CAAC"}

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

@@ -0,0 +1,91 @@
+/**
+ * @rovela/sdk/emails/send/auth
+ *
+ * Send functions for authentication emails.
+ */
+import type { SendEmailResult } from '../types';
+export interface SendVerificationEmailParams {
+    /** Customer email address */
+    to: string;
+    /** Customer's first name */
+    customerName: string;
+    /** Verification link URL */
+    verificationLink: string;
+    /** Link expiry time in hours (default: "24") */
+    expiryTime?: string;
+}
+/**
+ * Send an email verification email.
+ *
+ * @example
+ * ```typescript
+ * import { sendVerificationEmail } from '@rovela/sdk/emails'
+ *
+ * await sendVerificationEmail({
+ *   to: 'john@example.com',
+ *   customerName: 'John',
+ *   verificationLink: 'https://store.com/verify?token=...',
+ * })
+ * ```
+ */
+export declare function sendVerificationEmail(params: SendVerificationEmailParams): Promise<SendEmailResult>;
+export interface SendWelcomeEmailParams {
+    /** Customer email address */
+    to: string;
+    /** Customer's first name */
+    customerName: string;
+    /** Account creation date (defaults to today) */
+    createdDate?: Date | string;
+}
+/**
+ * Send a welcome email after account creation/verification.
+ *
+ * @example
+ * ```typescript
+ * import { sendWelcomeEmail } from '@rovela/sdk/emails'
+ *
+ * await sendWelcomeEmail({
+ *   to: 'john@example.com',
+ *   customerName: 'John',
+ * })
+ * ```
+ */
+export declare function sendWelcomeEmail(params: SendWelcomeEmailParams): Promise<SendEmailResult>;
+export interface SendPasswordResetEmailParams {
+    /** Customer email address */
+    to: string;
+    /** Customer's first name */
+    customerName: string;
+    /** Password reset link URL */
+    resetLink: string;
+    /** Link expiry time in hours (default: "1") */
+    expiryTime?: string;
+}
+/**
+ * Send a password reset email.
+ *
+ * @example
+ * ```typescript
+ * import { sendPasswordResetEmail } from '@rovela/sdk/emails'
+ *
+ * await sendPasswordResetEmail({
+ *   to: 'john@example.com',
+ *   customerName: 'John',
+ *   resetLink: 'https://store.com/reset-password?token=...',
+ * })
+ * ```
+ */
+export declare function sendPasswordResetEmail(params: SendPasswordResetEmailParams): Promise<SendEmailResult>;
+/**
+ * Send verification email without waiting (fire-and-forget).
+ */
+export declare function sendVerificationEmailAsync(params: SendVerificationEmailParams): void;
+/**
+ * Send welcome email without waiting (fire-and-forget).
+ */
+export declare function sendWelcomeEmailAsync(params: SendWelcomeEmailParams): void;
+/**
+ * Send password reset email without waiting (fire-and-forget).
+ */
+export declare function sendPasswordResetEmailAsync(params: SendPasswordResetEmailParams): void;
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/emails/send/auth.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAc/C,MAAM,WAAW,2BAA2B;IAC1C,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAA;IACpB,4BAA4B;IAC5B,gBAAgB,EAAE,MAAM,CAAA;IACxB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,eAAe,CAAC,CAmB1B;AAED,MAAM,WAAW,sBAAsB;IACrC,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAA;IACpB,gDAAgD;IAChD,WAAW,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAkB1B;AAED,MAAM,WAAW,4BAA4B;IAC3C,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAA;IACpB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC,eAAe,CAAC,CAkB1B;AAMD;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,2BAA2B,GAClC,IAAI,CAIN;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAI1E;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,4BAA4B,GACnC,IAAI,CAIN"}

package/dist/emails/send/auth.js

@@ -0,0 +1,130 @@
+/**
+ * @rovela/sdk/emails/send/auth
+ *
+ * Send functions for authentication emails.
+ */
+import { sendEmail } from '../sender';
+import { getEmailConfig, getStoreName } from '../config';
+import { formatDate } from '../utils';
+import { renderEmailVerification, getEmailVerificationSubject, renderWelcomeEmail, getWelcomeEmailSubject, renderPasswordResetEmail, getPasswordResetSubject, } from '../templates';
+/**
+ * Send an email verification email.
+ *
+ * @example
+ * ```typescript
+ * import { sendVerificationEmail } from '@rovela/sdk/emails'
+ *
+ * await sendVerificationEmail({
+ *   to: 'john@example.com',
+ *   customerName: 'John',
+ *   verificationLink: 'https://store.com/verify?token=...',
+ * })
+ * ```
+ */
+export async function sendVerificationEmail(params) {
+    const [config, storeName] = await Promise.all([
+        getEmailConfig(),
+        getStoreName(),
+    ]);
+    const html = renderEmailVerification({
+        config,
+        customerName: params.customerName,
+        customerEmail: params.to,
+        verificationLink: params.verificationLink,
+        expiryTime: params.expiryTime || '24',
+    });
+    return sendEmail({
+        to: params.to,
+        subject: getEmailVerificationSubject(storeName),
+        html,
+    });
+}
+/**
+ * Send a welcome email after account creation/verification.
+ *
+ * @example
+ * ```typescript
+ * import { sendWelcomeEmail } from '@rovela/sdk/emails'
+ *
+ * await sendWelcomeEmail({
+ *   to: 'john@example.com',
+ *   customerName: 'John',
+ * })
+ * ```
+ */
+export async function sendWelcomeEmail(params) {
+    const [config, storeName] = await Promise.all([
+        getEmailConfig(),
+        getStoreName(),
+    ]);
+    const html = renderWelcomeEmail({
+        config,
+        customerName: params.customerName,
+        customerEmail: params.to,
+        createdDate: formatDate(params.createdDate || new Date()),
+    });
+    return sendEmail({
+        to: params.to,
+        subject: getWelcomeEmailSubject(storeName),
+        html,
+    });
+}
+/**
+ * Send a password reset email.
+ *
+ * @example
+ * ```typescript
+ * import { sendPasswordResetEmail } from '@rovela/sdk/emails'
+ *
+ * await sendPasswordResetEmail({
+ *   to: 'john@example.com',
+ *   customerName: 'John',
+ *   resetLink: 'https://store.com/reset-password?token=...',
+ * })
+ * ```
+ */
+export async function sendPasswordResetEmail(params) {
+    const [config, storeName] = await Promise.all([
+        getEmailConfig(),
+        getStoreName(),
+    ]);
+    const html = renderPasswordResetEmail({
+        config,
+        customerName: params.customerName,
+        resetLink: params.resetLink,
+        expiryTime: params.expiryTime || '1',
+    });
+    return sendEmail({
+        to: params.to,
+        subject: getPasswordResetSubject(storeName),
+        html,
+    });
+}
+// =============================================================================
+// Fire-and-Forget Variants
+// =============================================================================
+/**
+ * Send verification email without waiting (fire-and-forget).
+ */
+export function sendVerificationEmailAsync(params) {
+    sendVerificationEmail(params).catch((err) => {
+        console.error('[Email] Failed to send verification email:', err);
+    });
+}
+/**
+ * Send welcome email without waiting (fire-and-forget).
+ */
+export function sendWelcomeEmailAsync(params) {
+    sendWelcomeEmail(params).catch((err) => {
+        console.error('[Email] Failed to send welcome email:', err);
+    });
+}
+/**
+ * Send password reset email without waiting (fire-and-forget).
+ */
+export function sendPasswordResetEmailAsync(params) {
+    sendPasswordResetEmail(params).catch((err) => {
+        console.error('[Email] Failed to send password reset email:', err);
+    });
+}
+//# sourceMappingURL=auth.js.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * @rovela/sdk/emails/send
+ *
+ * Convenience functions for sending emails.
+ */
+export { sendVerificationEmail, sendVerificationEmailAsync, sendWelcomeEmail, sendWelcomeEmailAsync, sendPasswordResetEmail, sendPasswordResetEmailAsync, } from './auth';
+export type { SendVerificationEmailParams, SendWelcomeEmailParams, SendPasswordResetEmailParams, } from './auth';
+export { sendAdminPasswordResetEmail, sendAdminPasswordResetEmailAsync, sendAdminInviteEmail, sendAdminInviteEmailAsync, } from './admin-auth';
+export type { SendAdminPasswordResetEmailParams, SendAdminInviteEmailParams, } from './admin-auth';
+export { sendOrderConfirmation, sendOrderConfirmationAsync, sendOrderShipped, sendOrderShippedAsync, sendOrderDelivered, sendOrderDeliveredAsync, sendOrderCancelled, sendOrderCancelledAsync, sendRefundProcessed, sendRefundProcessedAsync, } from './orders';
+export type { SendOrderConfirmationParams, SendOrderShippedParams, SendOrderDeliveredParams, SendOrderCancelledParams, SendRefundProcessedParams, } from './orders';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/emails/send/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,QAAQ,CAAA;AAEf,YAAY,EACV,2BAA2B,EAC3B,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,QAAQ,CAAA;AAMf,OAAO,EACL,2BAA2B,EAC3B,gCAAgC,EAChC,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,cAAc,CAAA;AAErB,YAAY,EACV,iCAAiC,EACjC,0BAA0B,GAC3B,MAAM,cAAc,CAAA;AAMrB,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,UAAU,CAAA;AAEjB,YAAY,EACV,2BAA2B,EAC3B,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,UAAU,CAAA"}

package/dist/emails/send/index.js

@@ -0,0 +1,18 @@
+/**
+ * @rovela/sdk/emails/send
+ *
+ * Convenience functions for sending emails.
+ */
+// =============================================================================
+// Auth Emails
+// =============================================================================
+export { sendVerificationEmail, sendVerificationEmailAsync, sendWelcomeEmail, sendWelcomeEmailAsync, sendPasswordResetEmail, sendPasswordResetEmailAsync, } from './auth';
+// =============================================================================
+// Admin Auth Emails
+// =============================================================================
+export { sendAdminPasswordResetEmail, sendAdminPasswordResetEmailAsync, sendAdminInviteEmail, sendAdminInviteEmailAsync, } from './admin-auth';
+// =============================================================================
+// Order Emails
+// =============================================================================
+export { sendOrderConfirmation, sendOrderConfirmationAsync, sendOrderShipped, sendOrderShippedAsync, sendOrderDelivered, sendOrderDeliveredAsync, sendOrderCancelled, sendOrderCancelledAsync, sendRefundProcessed, sendRefundProcessedAsync, } from './orders';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/emails/send/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,QAAQ,CAAA;AAQf,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF,OAAO,EACL,2BAA2B,EAC3B,gCAAgC,EAChC,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,cAAc,CAAA;AAOrB,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,UAAU,CAAA"}