@bloomneo/appkit 1.2.9

package/dist/email/strategies/resend.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Resend email strategy with modern API and automatic retry logic
+ * @module @bloomneo/appkit/email
+ * @file src/email/strategies/resend.ts
+ *
+ * @llm-rule WHEN: App has RESEND_API_KEY environment variable for modern email sending
+ * @llm-rule AVOID: Manual Resend setup - this handles API calls, retry logic, and error handling
+ * @llm-rule NOTE: Modern email provider with excellent deliverability and developer experience
+ */
+import type { EmailStrategy, EmailData, EmailResult } from '../email.js';
+import type { EmailConfig } from '../defaults.js';
+/**
+ * Resend email strategy with modern API and reliability features
+ */
+export declare class ResendStrategy implements EmailStrategy {
+    private config;
+    private apiKey;
+    private baseURL;
+    private timeout;
+    /**
+     * Creates Resend strategy with direct environment access (like auth pattern)
+     * @llm-rule WHEN: Email initialization with RESEND_API_KEY detected
+     * @llm-rule AVOID: Manual Resend configuration - environment detection handles this
+     */
+    constructor(config: EmailConfig);
+    /**
+     * Sends email via Resend API with automatic retry and error handling
+     * @llm-rule WHEN: Sending emails through Resend service
+     * @llm-rule AVOID: Manual API calls - this handles all Resend complexity
+     * @llm-rule NOTE: Includes retry logic, proper error handling, and response parsing
+     */
+    send(data: EmailData): Promise<EmailResult>;
+    /**
+     * Disconnects Resend strategy (no-op for HTTP API)
+     * @llm-rule WHEN: App shutdown or email cleanup
+     * @llm-rule AVOID: Expecting cleanup behavior - Resend is stateless HTTP API
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Converts EmailData to Resend API format
+     */
+    private convertToResendFormat;
+    /**
+     * Formats single email address for Resend API
+     */
+    private formatEmailAddress;
+    /**
+     * Formats multiple email addresses for Resend API
+     */
+    private formatEmailAddresses;
+    /**
+     * Formats attachments for Resend API
+     */
+    private formatAttachments;
+    /**
+     * Encodes attachment content for Resend API
+     */
+    private encodeAttachmentContent;
+    /**
+     * Guesses content type from filename
+     */
+    private guessContentType;
+    /**
+     * Sends email with retry logic and exponential backoff
+     */
+    private sendWithRetry;
+    /**
+     * Makes HTTP request to Resend API
+     */
+    private makeResendRequest;
+    /**
+     * Fetch with timeout support
+     */
+    private fetchWithTimeout;
+    /**
+     * Parses Resend API errors into user-friendly messages
+     */
+    private parseResendError;
+    /**
+     * Sleep for specified milliseconds
+     */
+    private sleep;
+}
+//# sourceMappingURL=resend.d.ts.map

package/dist/email/strategies/resend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resend.d.ts","sourceRoot":"","sources":["../../../src/email/strategies/resend.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAiC,MAAM,aAAa,CAAC;AACxG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;GAEG;AACH,qBAAa,cAAe,YAAW,aAAa;IAClD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IAExB;;;;OAIG;gBACS,MAAM,EAAE,WAAW;IAW/B;;;;;OAKG;IACG,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IA0BjD;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAkC7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAK5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAO/B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;OAEG;YACW,aAAa;IA4B3B;;OAEG;YACW,iBAAiB;IAqB/B;;OAEG;YACW,gBAAgB;IAuB9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmCxB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd"}

package/dist/email/strategies/resend.js

@@ -0,0 +1,266 @@
+/**
+ * Resend email strategy with modern API and automatic retry logic
+ * @module @bloomneo/appkit/email
+ * @file src/email/strategies/resend.ts
+ *
+ * @llm-rule WHEN: App has RESEND_API_KEY environment variable for modern email sending
+ * @llm-rule AVOID: Manual Resend setup - this handles API calls, retry logic, and error handling
+ * @llm-rule NOTE: Modern email provider with excellent deliverability and developer experience
+ */
+/**
+ * Resend email strategy with modern API and reliability features
+ */
+export class ResendStrategy {
+    config;
+    apiKey;
+    baseURL;
+    timeout;
+    /**
+     * Creates Resend strategy with direct environment access (like auth pattern)
+     * @llm-rule WHEN: Email initialization with RESEND_API_KEY detected
+     * @llm-rule AVOID: Manual Resend configuration - environment detection handles this
+     */
+    constructor(config) {
+        this.config = config;
+        this.apiKey = config.resend.apiKey;
+        this.baseURL = config.resend.baseURL;
+        this.timeout = config.resend.timeout;
+        if (!this.apiKey) {
+            throw new Error('Resend API key is required. Set RESEND_API_KEY environment variable.');
+        }
+    }
+    /**
+     * Sends email via Resend API with automatic retry and error handling
+     * @llm-rule WHEN: Sending emails through Resend service
+     * @llm-rule AVOID: Manual API calls - this handles all Resend complexity
+     * @llm-rule NOTE: Includes retry logic, proper error handling, and response parsing
+     */
+    async send(data) {
+        try {
+            // Convert to Resend API format
+            const resendPayload = this.convertToResendFormat(data);
+            // Send via Resend API with retry logic
+            const result = await this.sendWithRetry(resendPayload);
+            return {
+                success: true,
+                messageId: result.id,
+            };
+        }
+        catch (error) {
+            const errorMessage = this.parseResendError(error);
+            if (this.config.environment.isDevelopment) {
+                console.error(`[AppKit] Resend error:`, errorMessage);
+            }
+            return {
+                success: false,
+                error: errorMessage,
+            };
+        }
+    }
+    /**
+     * Disconnects Resend strategy (no-op for HTTP API)
+     * @llm-rule WHEN: App shutdown or email cleanup
+     * @llm-rule AVOID: Expecting cleanup behavior - Resend is stateless HTTP API
+     */
+    async disconnect() {
+        // Resend is HTTP API, no persistent connection to close
+        return Promise.resolve();
+    }
+    // Private helper methods
+    /**
+     * Converts EmailData to Resend API format
+     */
+    convertToResendFormat(data) {
+        const payload = {
+            from: this.formatEmailAddress(data.from),
+            to: this.formatEmailAddresses(data.to),
+            subject: data.subject,
+        };
+        // Add content
+        if (data.html) {
+            payload.html = data.html;
+        }
+        if (data.text) {
+            payload.text = data.text;
+        }
+        // Add optional fields
+        if (data.replyTo) {
+            payload.reply_to = this.formatEmailAddress(data.replyTo);
+        }
+        if (data.cc) {
+            payload.cc = this.formatEmailAddresses(data.cc);
+        }
+        if (data.bcc) {
+            payload.bcc = this.formatEmailAddresses(data.bcc);
+        }
+        // Add attachments
+        if (data.attachments && data.attachments.length > 0) {
+            payload.attachments = this.formatAttachments(data.attachments);
+        }
+        return payload;
+    }
+    /**
+     * Formats single email address for Resend API
+     */
+    formatEmailAddress(address) {
+        if (typeof address === 'string') {
+            return address;
+        }
+        if (address.name) {
+            return `${address.name} <${address.email}>`;
+        }
+        return address.email;
+    }
+    /**
+     * Formats multiple email addresses for Resend API
+     */
+    formatEmailAddresses(addresses) {
+        const addressArray = Array.isArray(addresses) ? addresses : [addresses];
+        return addressArray.map(addr => this.formatEmailAddress(addr));
+    }
+    /**
+     * Formats attachments for Resend API
+     */
+    formatAttachments(attachments) {
+        return attachments.map(attachment => ({
+            filename: attachment.filename,
+            content: this.encodeAttachmentContent(attachment.content),
+            type: attachment.contentType || this.guessContentType(attachment.filename),
+        }));
+    }
+    /**
+     * Encodes attachment content for Resend API
+     */
+    encodeAttachmentContent(content) {
+        if (Buffer.isBuffer(content)) {
+            return content.toString('base64');
+        }
+        return Buffer.from(content).toString('base64');
+    }
+    /**
+     * Guesses content type from filename
+     */
+    guessContentType(filename) {
+        const ext = filename.split('.').pop()?.toLowerCase();
+        const mimeTypes = {
+            pdf: 'application/pdf',
+            doc: 'application/msword',
+            docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+            xls: 'application/vnd.ms-excel',
+            xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+            png: 'image/png',
+            jpg: 'image/jpeg',
+            jpeg: 'image/jpeg',
+            gif: 'image/gif',
+            txt: 'text/plain',
+            html: 'text/html',
+            css: 'text/css',
+            js: 'application/javascript',
+            json: 'application/json',
+            zip: 'application/zip',
+        };
+        return mimeTypes[ext || ''] || 'application/octet-stream';
+    }
+    /**
+     * Sends email with retry logic and exponential backoff
+     */
+    async sendWithRetry(payload, maxRetries = 3) {
+        let lastError;
+        for (let attempt = 1; attempt <= maxRetries; attempt++) {
+            try {
+                return await this.makeResendRequest(payload);
+            }
+            catch (error) {
+                lastError = error;
+                // Don't retry on client errors (4xx)
+                if (error.status && error.status >= 400 && error.status < 500) {
+                    throw error;
+                }
+                if (attempt < maxRetries) {
+                    const delay = 1000 * Math.pow(2, attempt - 1); // Exponential backoff
+                    console.warn(`[AppKit] Resend attempt ${attempt} failed, retrying in ${delay}ms:`, error.message);
+                    await this.sleep(delay);
+                }
+            }
+        }
+        throw lastError;
+    }
+    /**
+     * Makes HTTP request to Resend API
+     */
+    async makeResendRequest(payload) {
+        const url = `${this.baseURL}/emails`;
+        const response = await this.fetchWithTimeout(url, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${this.apiKey}`,
+                'Content-Type': 'application/json',
+                'User-Agent': 'VoilaJSX-AppKit-Email/1.0.0',
+            },
+            body: JSON.stringify(payload),
+        });
+        if (!response.ok) {
+            const errorData = await response.json().catch(() => ({}));
+            throw new Error(`Resend API error (${response.status}): ${errorData.message || response.statusText}`);
+        }
+        return await response.json();
+    }
+    /**
+     * Fetch with timeout support
+     */
+    async fetchWithTimeout(url, options) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                ...options,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            return response;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error.name === 'AbortError') {
+                throw new Error(`Resend API request timeout after ${this.timeout}ms`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Parses Resend API errors into user-friendly messages
+     */
+    parseResendError(error) {
+        if (error.message) {
+            // Extract useful error information
+            const message = error.message.toLowerCase();
+            if (message.includes('unauthorized') || message.includes('invalid api key')) {
+                return 'Invalid Resend API key. Check RESEND_API_KEY environment variable.';
+            }
+            if (message.includes('rate limit')) {
+                return 'Resend API rate limit exceeded. Please try again later.';
+            }
+            if (message.includes('quota') || message.includes('usage limit')) {
+                return 'Resend API quota exceeded. Check your account limits.';
+            }
+            if (message.includes('domain') || message.includes('verify')) {
+                return 'Email domain not verified in Resend. Please verify your sending domain.';
+            }
+            if (message.includes('timeout')) {
+                return 'Resend API request timeout. Please try again.';
+            }
+            if (message.includes('network') || message.includes('connection')) {
+                return 'Network error connecting to Resend API. Please check your internet connection.';
+            }
+            return error.message;
+        }
+        return 'Unknown Resend API error occurred';
+    }
+    /**
+     * Sleep for specified milliseconds
+     */
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=resend.js.map

package/dist/email/strategies/resend.js.map

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

package/dist/email/strategies/smtp.d.ts

@@ -0,0 +1,77 @@
+/**
+ * SMTP email strategy with nodemailer and connection pooling
+ * @module @bloomneo/appkit/email
+ * @file src/email/strategies/smtp.ts
+ *
+ * @llm-rule WHEN: App has SMTP_HOST environment variable for universal email sending
+ * @llm-rule AVOID: Manual SMTP setup - this handles connection pooling, authentication, and reliability
+ * @llm-rule NOTE: Universal email strategy that works with any SMTP server (Gmail, Outlook, etc.)
+ */
+import type { EmailStrategy, EmailData, EmailResult } from '../email.js';
+import type { EmailConfig } from '../defaults.js';
+/**
+ * SMTP email strategy with connection pooling and reliability features
+ */
+export declare class SmtpStrategy implements EmailStrategy {
+    private config;
+    private transporter;
+    private connected;
+    /**
+     * Creates SMTP strategy with direct environment access (like auth pattern)
+     * @llm-rule WHEN: Email initialization with SMTP_HOST detected
+     * @llm-rule AVOID: Manual SMTP configuration - environment detection handles this
+     */
+    constructor(config: EmailConfig);
+    /**
+     * Sends email via SMTP with automatic connection management
+     * @llm-rule WHEN: Sending emails through SMTP servers
+     * @llm-rule AVOID: Manual SMTP calls - this handles all connection complexity
+     * @llm-rule NOTE: Includes connection pooling, authentication, and error handling
+     */
+    send(data: EmailData): Promise<EmailResult>;
+    /**
+     * Disconnects SMTP strategy gracefully
+     * @llm-rule WHEN: App shutdown or email cleanup
+     * @llm-rule AVOID: Abrupt disconnection - graceful shutdown prevents connection issues
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Ensures SMTP transporter is connected
+     */
+    private ensureConnected;
+    /**
+     * Converts EmailData to nodemailer format
+     */
+    private convertToSmtpFormat;
+    /**
+     * Formats single email address for nodemailer
+     */
+    private formatEmailAddress;
+    /**
+     * Formats multiple email addresses for nodemailer
+     */
+    private formatEmailAddresses;
+    /**
+     * Formats attachments for nodemailer
+     */
+    private formatAttachments;
+    /**
+     * Guesses content type from filename
+     */
+    private guessContentType;
+    /**
+     * Parses SMTP errors into user-friendly messages
+     */
+    private parseSmtpError;
+    /**
+     * Gets SMTP connection info for debugging
+     */
+    getConnectionInfo(): {
+        host: string;
+        port: number;
+        secure: boolean;
+        authenticated: boolean;
+        connected: boolean;
+    };
+}
+//# sourceMappingURL=smtp.d.ts.map

package/dist/email/strategies/smtp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smtp.d.ts","sourceRoot":"","sources":["../../../src/email/strategies/smtp.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAiC,MAAM,aAAa,CAAC;AACxG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;GAEG;AACH,qBAAa,YAAa,YAAW,aAAa;IAChD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,SAAS,CAAkB;IAEnC;;;;OAIG;gBACS,MAAM,EAAE,WAAW;IAI/B;;;;;OAKG;IACG,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IA6BjD;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBjC;;OAEG;YACW,eAAe;IA6C7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkC3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAK5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;OAEG;IACH,OAAO,CAAC,cAAc;IA6EtB;;OAEG;IACH,iBAAiB,IAAI;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,OAAO,CAAC;QAChB,aAAa,EAAE,OAAO,CAAC;QACvB,SAAS,EAAE,OAAO,CAAC;KACpB;CAWF"}