@sibiltech/sibil-mail 1.0.0

package/LICENSE

@@ -0,0 +1,3 @@
+UNLICENSED
+
+This is private and proprietary software. All rights reserved.

package/README.md

@@ -0,0 +1,2 @@
+# Sibil-mail
+Sibil Mail is used for all sending and receiving emails

package/dist/errors/sibil-mail-error.d.ts

@@ -0,0 +1,41 @@
+/**
+ * SibilMail Error Classes
+ *
+ * Custom error classes for better error handling.
+ */
+/**
+ * SibilMailError
+ *
+ * Base error class for all SibilMail errors.
+ */
+export declare class SibilMailError extends Error {
+    code?: string | undefined;
+    constructor(message: string, code?: string | undefined);
+}
+/**
+ * SmtpConnectionError
+ *
+ * Error thrown when SMTP connection fails.
+ */
+export declare class SmtpConnectionError extends SibilMailError {
+    constructor(message: string);
+}
+/**
+ * EmailValidationError
+ *
+ * Error thrown when email validation fails.
+ */
+export declare class EmailValidationError extends SibilMailError {
+    invalidEmails?: string[] | undefined;
+    constructor(message: string, invalidEmails?: string[] | undefined);
+}
+/**
+ * EmailSendError
+ *
+ * Error thrown when email sending fails.
+ */
+export declare class EmailSendError extends SibilMailError {
+    originalError?: Error | undefined;
+    constructor(message: string, originalError?: Error | undefined);
+}
+//# sourceMappingURL=sibil-mail-error.d.ts.map

package/dist/errors/sibil-mail-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sibil-mail-error.d.ts","sourceRoot":"","sources":["../../src/errors/sibil-mail-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACH,IAAI,CAAC,EAAE,MAAM;gBAArC,OAAO,EAAE,MAAM,EAAS,IAAI,CAAC,EAAE,MAAM,YAAA;CAKlD;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;gBACzC,OAAO,EAAE,MAAM;CAK5B;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,cAAc;IAClB,aAAa,CAAC,EAAE,MAAM,EAAE;gBAAhD,OAAO,EAAE,MAAM,EAAS,aAAa,CAAC,EAAE,MAAM,EAAE,YAAA;CAK7D;AAED;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,cAAc;IACZ,aAAa,CAAC,EAAE,KAAK;gBAA7C,OAAO,EAAE,MAAM,EAAS,aAAa,CAAC,EAAE,KAAK,YAAA;CAK1D"}

package/dist/errors/sibil-mail-error.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * SibilMail Error Classes
+ *
+ * Custom error classes for better error handling.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailSendError = exports.EmailValidationError = exports.SmtpConnectionError = exports.SibilMailError = void 0;
+/**
+ * SibilMailError
+ *
+ * Base error class for all SibilMail errors.
+ */
+class SibilMailError extends Error {
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'SibilMailError';
+        Object.setPrototypeOf(this, SibilMailError.prototype);
+    }
+}
+exports.SibilMailError = SibilMailError;
+/**
+ * SmtpConnectionError
+ *
+ * Error thrown when SMTP connection fails.
+ */
+class SmtpConnectionError extends SibilMailError {
+    constructor(message) {
+        super(message, 'SMTP_CONNECTION_ERROR');
+        this.name = 'SmtpConnectionError';
+        Object.setPrototypeOf(this, SmtpConnectionError.prototype);
+    }
+}
+exports.SmtpConnectionError = SmtpConnectionError;
+/**
+ * EmailValidationError
+ *
+ * Error thrown when email validation fails.
+ */
+class EmailValidationError extends SibilMailError {
+    constructor(message, invalidEmails) {
+        super(message, 'EMAIL_VALIDATION_ERROR');
+        this.invalidEmails = invalidEmails;
+        this.name = 'EmailValidationError';
+        Object.setPrototypeOf(this, EmailValidationError.prototype);
+    }
+}
+exports.EmailValidationError = EmailValidationError;
+/**
+ * EmailSendError
+ *
+ * Error thrown when email sending fails.
+ */
+class EmailSendError extends SibilMailError {
+    constructor(message, originalError) {
+        super(message, 'EMAIL_SEND_ERROR');
+        this.originalError = originalError;
+        this.name = 'EmailSendError';
+        Object.setPrototypeOf(this, EmailSendError.prototype);
+    }
+}
+exports.EmailSendError = EmailSendError;
+//# sourceMappingURL=sibil-mail-error.js.map

package/dist/errors/sibil-mail-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sibil-mail-error.js","sourceRoot":"","sources":["../../src/errors/sibil-mail-error.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH;;;;GAIG;AACH,MAAa,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe,EAAS,IAAa;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAC;QADmB,SAAI,GAAJ,IAAI,CAAS;QAE/C,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;CACF;AAND,wCAMC;AAED;;;;GAIG;AACH,MAAa,mBAAoB,SAAQ,cAAc;IACrD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;CACF;AAND,kDAMC;AAED;;;;GAIG;AACH,MAAa,oBAAqB,SAAQ,cAAc;IACtD,YAAY,OAAe,EAAS,aAAwB;QAC1D,KAAK,CAAC,OAAO,EAAE,wBAAwB,CAAC,CAAC;QADP,kBAAa,GAAb,aAAa,CAAW;QAE1D,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC9D,CAAC;CACF;AAND,oDAMC;AAED;;;;GAIG;AACH,MAAa,cAAe,SAAQ,cAAc;IAChD,YAAY,OAAe,EAAS,aAAqB;QACvD,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;QADD,kBAAa,GAAb,aAAa,CAAQ;QAEvD,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;CACF;AAND,wCAMC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Sibil Mail - SMTP Email Sending Library
+ *
+ * Main entry point for the email library.
+ * Exports all public APIs for sending emails via SMTP.
+ */
+export { SibilMail } from './sibil-mail';
+export { EmailOptions, EmailResult, SmtpConfig, EmailAttachment, TransportFactory, } from './types';
+export { createSmtpTransport, verifySmtpConnection, closeTransport } from './transport';
+export { isValidEmail, validateEmails, normalizeEmail, extractDomain, } from './utils/email-validator';
+export { replaceVariables, replaceVariablesInHtml, createEmailTemplate, } from './utils/template-engine';
+export { SibilMailError, SmtpConnectionError, EmailValidationError, EmailSendError, } from './errors/sibil-mail-error';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,EACL,YAAY,EACZ,WAAW,EACX,UAAU,EACV,eAAe,EACf,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGxF,OAAO,EACL,YAAY,EACZ,cAAc,EACd,cAAc,EACd,aAAa,GACd,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,GACf,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * Sibil Mail - SMTP Email Sending Library
+ *
+ * Main entry point for the email library.
+ * Exports all public APIs for sending emails via SMTP.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailSendError = exports.EmailValidationError = exports.SmtpConnectionError = exports.SibilMailError = exports.createEmailTemplate = exports.replaceVariablesInHtml = exports.replaceVariables = exports.extractDomain = exports.normalizeEmail = exports.validateEmails = exports.isValidEmail = exports.closeTransport = exports.verifySmtpConnection = exports.createSmtpTransport = exports.SibilMail = void 0;
+// Main classes
+var sibil_mail_1 = require("./sibil-mail");
+Object.defineProperty(exports, "SibilMail", { enumerable: true, get: function () { return sibil_mail_1.SibilMail; } });
+// Transport utilities
+var transport_1 = require("./transport");
+Object.defineProperty(exports, "createSmtpTransport", { enumerable: true, get: function () { return transport_1.createSmtpTransport; } });
+Object.defineProperty(exports, "verifySmtpConnection", { enumerable: true, get: function () { return transport_1.verifySmtpConnection; } });
+Object.defineProperty(exports, "closeTransport", { enumerable: true, get: function () { return transport_1.closeTransport; } });
+// Validation utilities
+var email_validator_1 = require("./utils/email-validator");
+Object.defineProperty(exports, "isValidEmail", { enumerable: true, get: function () { return email_validator_1.isValidEmail; } });
+Object.defineProperty(exports, "validateEmails", { enumerable: true, get: function () { return email_validator_1.validateEmails; } });
+Object.defineProperty(exports, "normalizeEmail", { enumerable: true, get: function () { return email_validator_1.normalizeEmail; } });
+Object.defineProperty(exports, "extractDomain", { enumerable: true, get: function () { return email_validator_1.extractDomain; } });
+// Template utilities
+var template_engine_1 = require("./utils/template-engine");
+Object.defineProperty(exports, "replaceVariables", { enumerable: true, get: function () { return template_engine_1.replaceVariables; } });
+Object.defineProperty(exports, "replaceVariablesInHtml", { enumerable: true, get: function () { return template_engine_1.replaceVariablesInHtml; } });
+Object.defineProperty(exports, "createEmailTemplate", { enumerable: true, get: function () { return template_engine_1.createEmailTemplate; } });
+// Error classes
+var sibil_mail_error_1 = require("./errors/sibil-mail-error");
+Object.defineProperty(exports, "SibilMailError", { enumerable: true, get: function () { return sibil_mail_error_1.SibilMailError; } });
+Object.defineProperty(exports, "SmtpConnectionError", { enumerable: true, get: function () { return sibil_mail_error_1.SmtpConnectionError; } });
+Object.defineProperty(exports, "EmailValidationError", { enumerable: true, get: function () { return sibil_mail_error_1.EmailValidationError; } });
+Object.defineProperty(exports, "EmailSendError", { enumerable: true, get: function () { return sibil_mail_error_1.EmailSendError; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,eAAe;AACf,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAWlB,sBAAsB;AACtB,yCAAwF;AAA/E,gHAAA,mBAAmB,OAAA;AAAE,iHAAA,oBAAoB,OAAA;AAAE,2GAAA,cAAc,OAAA;AAElE,uBAAuB;AACvB,2DAKiC;AAJ/B,+GAAA,YAAY,OAAA;AACZ,iHAAA,cAAc,OAAA;AACd,iHAAA,cAAc,OAAA;AACd,gHAAA,aAAa,OAAA;AAGf,qBAAqB;AACrB,2DAIiC;AAH/B,mHAAA,gBAAgB,OAAA;AAChB,yHAAA,sBAAsB,OAAA;AACtB,sHAAA,mBAAmB,OAAA;AAGrB,gBAAgB;AAChB,8DAKmC;AAJjC,kHAAA,cAAc,OAAA;AACd,uHAAA,mBAAmB,OAAA;AACnB,wHAAA,oBAAoB,OAAA;AACpB,kHAAA,cAAc,OAAA"}

package/dist/sibil-mail.d.ts

@@ -0,0 +1,123 @@
+/**
+ * SibilMail Class
+ *
+ * Professional email sending service with comprehensive error handling,
+ * retry mechanisms, and support for various SMTP providers.
+ */
+import { Transporter } from 'nodemailer';
+import { EmailOptions, EmailResult, SmtpConfig } from './types';
+/**
+ * Retry Configuration
+ */
+interface RetryConfig {
+    maxRetries: number;
+    retryDelay: number;
+}
+/**
+ * SibilMail Class
+ *
+ * Professional email sending service with:
+ * - Automatic retry on failure
+ * - Comprehensive error handling
+ * - Email validation
+ * - Connection pooling
+ * - Provider-specific optimizations
+ */
+export declare class SibilMail {
+    private transporter;
+    private config;
+    private retryConfig;
+    /**
+     * Constructor
+     *
+     * @param config - SMTP configuration
+     * @param retryConfig - Optional retry configuration
+     */
+    constructor(config: SmtpConfig, retryConfig?: Partial<RetryConfig>);
+    /**
+     * Normalize Configuration
+     *
+     * Cleans and validates configuration before use.
+     */
+    private normalizeConfig;
+    /**
+     * Sleep Helper
+     *
+     * Waits for specified milliseconds.
+     */
+    private sleep;
+    /**
+     * Retry Operation
+     *
+     * Retries an operation with exponential backoff.
+     */
+    private retry;
+    /**
+     * Validate Email Options
+     *
+     * Validates email options before sending.
+     */
+    private validateEmailOptions;
+    /**
+     * Send Email
+     *
+     * Sends an email with automatic retry on failure.
+     *
+     * @param options - Email options
+     * @returns Promise resolving to email result
+     */
+    send(options: EmailOptions): Promise<EmailResult>;
+    /**
+     * Get Error Message
+     *
+     * Extracts and formats error message from various error types.
+     */
+    private getErrorMessage;
+    /**
+     * Verify Connection
+     *
+     * Tests the SMTP connection with retry mechanism.
+     *
+     * @returns Promise resolving to true if connection is valid
+     * @throws SmtpConnectionError if connection fails
+     */
+    verifyConnection(): Promise<boolean>;
+    /**
+     * Get Transporter
+     *
+     * Returns the underlying nodemailer transporter instance.
+     *
+     * @returns Nodemailer transporter instance
+     */
+    getTransporter(): Transporter;
+    /**
+     * Update Configuration
+     *
+     * Updates SMTP configuration and recreates transporter.
+     *
+     * @param config - New SMTP configuration
+     */
+    updateConfig(config: SmtpConfig): void;
+    /**
+     * Get Configuration
+     *
+     * Returns current SMTP configuration (password masked).
+     *
+     * @returns SMTP configuration
+     */
+    getConfig(): Omit<SmtpConfig, 'auth'> & {
+        auth: {
+            user: string;
+            pass: string;
+        };
+    };
+    /**
+     * Close Connection
+     *
+     * Properly closes the transporter connection pool.
+     * Call this when done using the mailer instance.
+     */
+    close(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=sibil-mail.d.ts.map

package/dist/sibil-mail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sibil-mail.d.ts","sourceRoot":"","sources":["../src/sibil-mail.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAIhE;;GAEG;AACH,UAAU,WAAW;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAOD;;;;;;;;;GASG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,WAAW,CAAc;IAEjC;;;;;OAKG;gBACS,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC;IAMlE;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAcvB;;;;OAIG;IACH,OAAO,CAAC,KAAK;IAIb;;;;OAIG;YACW,KAAK;IAyBnB;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAwD5B;;;;;;;OAOG;IACG,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IA4CvD;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAoCvB;;;;;;;OAOG;IACG,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IAa1C;;;;;;OAMG;IACH,cAAc,IAAI,WAAW;IAI7B;;;;;;OAMG;IACH,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAStC;;;;;;OAMG;IACH,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG;QAAE,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE;IAUhF;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/sibil-mail.js

@@ -0,0 +1,286 @@
+"use strict";
+/**
+ * SibilMail Class
+ *
+ * Professional email sending service with comprehensive error handling,
+ * retry mechanisms, and support for various SMTP providers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SibilMail = void 0;
+const transport_1 = require("./transport");
+const email_validator_1 = require("./utils/email-validator");
+const sibil_mail_error_1 = require("./errors/sibil-mail-error");
+const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    retryDelay: 1000, // 1 second
+};
+/**
+ * SibilMail Class
+ *
+ * Professional email sending service with:
+ * - Automatic retry on failure
+ * - Comprehensive error handling
+ * - Email validation
+ * - Connection pooling
+ * - Provider-specific optimizations
+ */
+class SibilMail {
+    /**
+     * Constructor
+     *
+     * @param config - SMTP configuration
+     * @param retryConfig - Optional retry configuration
+     */
+    constructor(config, retryConfig) {
+        this.config = this.normalizeConfig(config);
+        this.retryConfig = { ...DEFAULT_RETRY_CONFIG, ...retryConfig };
+        this.transporter = (0, transport_1.createSmtpTransport)(this.config);
+    }
+    /**
+     * Normalize Configuration
+     *
+     * Cleans and validates configuration before use.
+     */
+    normalizeConfig(config) {
+        return {
+            ...config,
+            host: config.host.trim(),
+            port: config.port,
+            secure: config.secure,
+            auth: {
+                user: config.auth.user.trim(),
+                pass: config.auth.pass.trim(),
+            },
+            tls: config.tls,
+        };
+    }
+    /**
+     * Sleep Helper
+     *
+     * Waits for specified milliseconds.
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Retry Operation
+     *
+     * Retries an operation with exponential backoff.
+     */
+    async retry(operation, operationName) {
+        let lastError = null;
+        for (let attempt = 1; attempt <= this.retryConfig.maxRetries; attempt++) {
+            try {
+                return await operation();
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                if (attempt < this.retryConfig.maxRetries) {
+                    const delay = this.retryConfig.retryDelay * attempt; // Exponential backoff
+                    console.warn(`${operationName} failed (attempt ${attempt}/${this.retryConfig.maxRetries}). Retrying in ${delay}ms...`);
+                    await this.sleep(delay);
+                }
+            }
+        }
+        throw lastError || new Error(`${operationName} failed after ${this.retryConfig.maxRetries} attempts`);
+    }
+    /**
+     * Validate Email Options
+     *
+     * Validates email options before sending.
+     */
+    validateEmailOptions(options) {
+        // Validate from address
+        if (!options.from || !options.from.trim()) {
+            return { valid: false, error: 'From address is required' };
+        }
+        if (!(0, email_validator_1.isValidEmail)(options.from)) {
+            return { valid: false, error: `From address is not a valid email: ${options.from}` };
+        }
+        // Validate to address
+        if (!options.to) {
+            return { valid: false, error: 'To address is required' };
+        }
+        const toEmails = Array.isArray(options.to) ? options.to : [options.to];
+        if (toEmails.length === 0) {
+            return { valid: false, error: 'At least one recipient is required' };
+        }
+        const { valid, invalid } = (0, email_validator_1.validateEmails)(toEmails);
+        if (invalid.length > 0) {
+            return { valid: false, error: `Invalid email addresses: ${invalid.join(', ')}` };
+        }
+        // Validate subject
+        if (!options.subject || !options.subject.trim()) {
+            return { valid: false, error: 'Subject is required' };
+        }
+        // Validate body
+        if (!options.text && !options.html) {
+            return { valid: false, error: 'Either text or html body is required' };
+        }
+        // Validate CC if provided
+        if (options.cc) {
+            const ccEmails = Array.isArray(options.cc) ? options.cc : [options.cc];
+            const { invalid: invalidCC } = (0, email_validator_1.validateEmails)(ccEmails);
+            if (invalidCC.length > 0) {
+                return { valid: false, error: `Invalid CC email addresses: ${invalidCC.join(', ')}` };
+            }
+        }
+        // Validate BCC if provided
+        if (options.bcc) {
+            const bccEmails = Array.isArray(options.bcc) ? options.bcc : [options.bcc];
+            const { invalid: invalidBCC } = (0, email_validator_1.validateEmails)(bccEmails);
+            if (invalidBCC.length > 0) {
+                return { valid: false, error: `Invalid BCC email addresses: ${invalidBCC.join(', ')}` };
+            }
+        }
+        return { valid: true };
+    }
+    /**
+     * Send Email
+     *
+     * Sends an email with automatic retry on failure.
+     *
+     * @param options - Email options
+     * @returns Promise resolving to email result
+     */
+    async send(options) {
+        // Validate options
+        const validation = this.validateEmailOptions(options);
+        if (!validation.valid) {
+            return {
+                success: false,
+                error: validation.error || 'Validation failed',
+            };
+        }
+        // Prepare email data
+        const emailData = {
+            from: options.from.trim(),
+            to: options.to,
+            subject: options.subject.trim(),
+            text: options.text?.trim(),
+            html: options.html?.trim(),
+            cc: options.cc,
+            bcc: options.bcc,
+            replyTo: options.replyTo?.trim(),
+            attachments: options.attachments,
+        };
+        // Send with retry
+        try {
+            const info = await this.retry(() => this.transporter.sendMail(emailData), 'Send email');
+            return {
+                success: true,
+                messageId: info.messageId,
+                response: info.response,
+            };
+        }
+        catch (error) {
+            const errorMessage = this.getErrorMessage(error);
+            return {
+                success: false,
+                error: errorMessage,
+            };
+        }
+    }
+    /**
+     * Get Error Message
+     *
+     * Extracts and formats error message from various error types.
+     */
+    getErrorMessage(error) {
+        if (error instanceof Error) {
+            const message = error.message.toLowerCase();
+            // Authentication errors
+            if (message.includes('invalid login') || message.includes('authentication failed') || message.includes('535')) {
+                return 'Authentication failed: Invalid email or password. For Gmail, ensure you are using an App Password.';
+            }
+            // Connection errors
+            if (message.includes('connection') || message.includes('econnrefused') || message.includes('timeout')) {
+                return `Connection failed: Unable to connect to SMTP server. Check your network and firewall settings.`;
+            }
+            // TLS/SSL errors
+            if (message.includes('tls') || message.includes('ssl') || message.includes('certificate')) {
+                return `TLS/SSL error: ${error.message}. Try enabling "Ignore TLS Certificate Errors" or use port 465 with SSL.`;
+            }
+            // Socket errors
+            if (message.includes('socket') || message.includes('disconnected')) {
+                return `Network error: ${error.message}. Check if the SMTP port is accessible.`;
+            }
+            // Rate limiting
+            if (message.includes('rate') || message.includes('limit') || message.includes('too many')) {
+                return 'Rate limit exceeded: Too many emails sent. Please wait before trying again.';
+            }
+            // Return original message
+            return error.message;
+        }
+        return 'Unknown error occurred while sending email';
+    }
+    /**
+     * Verify Connection
+     *
+     * Tests the SMTP connection with retry mechanism.
+     *
+     * @returns Promise resolving to true if connection is valid
+     * @throws SmtpConnectionError if connection fails
+     */
+    async verifyConnection() {
+        try {
+            await this.retry(() => (0, transport_1.verifySmtpConnection)(this.transporter), 'Verify SMTP connection');
+            return true;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'SMTP connection failed';
+            throw new sibil_mail_error_1.SmtpConnectionError(message);
+        }
+    }
+    /**
+     * Get Transporter
+     *
+     * Returns the underlying nodemailer transporter instance.
+     *
+     * @returns Nodemailer transporter instance
+     */
+    getTransporter() {
+        return this.transporter;
+    }
+    /**
+     * Update Configuration
+     *
+     * Updates SMTP configuration and recreates transporter.
+     *
+     * @param config - New SMTP configuration
+     */
+    updateConfig(config) {
+        // Close old transporter
+        (0, transport_1.closeTransport)(this.transporter).catch(console.error);
+        // Update config and create new transporter
+        this.config = this.normalizeConfig(config);
+        this.transporter = (0, transport_1.createSmtpTransport)(this.config);
+    }
+    /**
+     * Get Configuration
+     *
+     * Returns current SMTP configuration (password masked).
+     *
+     * @returns SMTP configuration
+     */
+    getConfig() {
+        return {
+            ...this.config,
+            auth: {
+                user: this.config.auth.user,
+                pass: '***',
+            },
+        };
+    }
+    /**
+     * Close Connection
+     *
+     * Properly closes the transporter connection pool.
+     * Call this when done using the mailer instance.
+     */
+    async close() {
+        await (0, transport_1.closeTransport)(this.transporter);
+    }
+}
+exports.SibilMail = SibilMail;
+//# sourceMappingURL=sibil-mail.js.map

package/dist/sibil-mail.js.map

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

package/dist/test-connection-simple.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Simple Connection Test
+ *
+ * Direct test script to diagnose SMTP connection issues.
+ * Run with: npx ts-node src/test-connection-simple.ts
+ */
+export {};
+//# sourceMappingURL=test-connection-simple.d.ts.map

package/dist/test-connection-simple.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-connection-simple.d.ts","sourceRoot":"","sources":["../src/test-connection-simple.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}