@impruthvi/nodemail 0.2.0

package/dist/core/Message.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Message = void 0;
+class Message {
+    options = {};
+    to(address) {
+        this.options.to = address;
+        return this;
+    }
+    from(address) {
+        this.options.from = address;
+        return this;
+    }
+    subject(subject) {
+        this.options.subject = subject;
+        return this;
+    }
+    html(html) {
+        this.options.html = html;
+        return this;
+    }
+    text(text) {
+        this.options.text = text;
+        return this;
+    }
+    cc(address) {
+        this.options.cc = address;
+        return this;
+    }
+    bcc(address) {
+        this.options.bcc = address;
+        return this;
+    }
+    replyTo(address) {
+        this.options.replyTo = address;
+        return this;
+    }
+    attach(attachment) {
+        if (!this.options.attachments) {
+            this.options.attachments = [];
+        }
+        this.options.attachments.push(attachment);
+        return this;
+    }
+    header(name, value) {
+        if (!this.options.headers) {
+            this.options.headers = {};
+        }
+        this.options.headers[name] = value;
+        return this;
+    }
+    template(name, data) {
+        this.options.template = name;
+        this.options.data = data;
+        return this;
+    }
+    toOptions() {
+        return this.options;
+    }
+}
+exports.Message = Message;
+//# sourceMappingURL=Message.js.map

package/dist/core/Message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Message.js","sourceRoot":"","sources":["../../src/core/Message.ts"],"names":[],"mappings":";;;AAMA,MAAa,OAAO;IACV,OAAO,GAAyB,EAAE,CAAC;IAK3C,EAAE,CAAC,OAAwD;QACzD,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAKD,IAAI,CAAC,OAA6B;QAChC,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAKD,OAAO,CAAC,OAAe;QACrB,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAKD,IAAI,CAAC,IAAY;QACf,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAKD,IAAI,CAAC,IAAY;QACf,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAKD,EAAE,CAAC,OAAwD;QACzD,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAKD,GAAG,CAAC,OAAwD;QAC1D,IAAI,CAAC,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAKD,OAAO,CAAC,OAA6B;QACnC,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAKD,MAAM,CAAC,UAAsB;QAC3B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YAC9B,IAAI,CAAC,OAAO,CAAC,WAAW,GAAG,EAAE,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAKD,MAAM,CAAC,IAAY,EAAE,KAAa;QAChC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,EAAE,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAKD,QAAQ,CAAC,IAAY,EAAE,IAA6B;QAClD,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAKD,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF;AAxGD,0BAwGC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { Mail } from './core/MailFacade';
+export { MailManager } from './core/MailManager';
+export { Mailable } from './core/Mailable';
+export { Message } from './core/Message';
+export { SmtpProvider } from './providers/SmtpProvider';
+export { SendGridProvider } from './providers/SendGridProvider';
+export { SesProvider } from './providers/SesProvider';
+export * from './types';
+export declare const VERSION = "0.1.0";
+//# 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":"AAKA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGzC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGtD,cAAc,SAAS,CAAC;AAGxB,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,34 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = exports.SesProvider = exports.SendGridProvider = exports.SmtpProvider = exports.Message = exports.Mailable = exports.MailManager = exports.Mail = void 0;
+var MailFacade_1 = require("./core/MailFacade");
+Object.defineProperty(exports, "Mail", { enumerable: true, get: function () { return MailFacade_1.Mail; } });
+var MailManager_1 = require("./core/MailManager");
+Object.defineProperty(exports, "MailManager", { enumerable: true, get: function () { return MailManager_1.MailManager; } });
+var Mailable_1 = require("./core/Mailable");
+Object.defineProperty(exports, "Mailable", { enumerable: true, get: function () { return Mailable_1.Mailable; } });
+var Message_1 = require("./core/Message");
+Object.defineProperty(exports, "Message", { enumerable: true, get: function () { return Message_1.Message; } });
+var SmtpProvider_1 = require("./providers/SmtpProvider");
+Object.defineProperty(exports, "SmtpProvider", { enumerable: true, get: function () { return SmtpProvider_1.SmtpProvider; } });
+var SendGridProvider_1 = require("./providers/SendGridProvider");
+Object.defineProperty(exports, "SendGridProvider", { enumerable: true, get: function () { return SendGridProvider_1.SendGridProvider; } });
+var SesProvider_1 = require("./providers/SesProvider");
+Object.defineProperty(exports, "SesProvider", { enumerable: true, get: function () { return SesProvider_1.SesProvider; } });
+__exportStar(require("./types"), exports);
+exports.VERSION = '0.1.0';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAKA,gDAAyC;AAAhC,kGAAA,IAAI,OAAA;AACb,kDAAiD;AAAxC,0GAAA,WAAW,OAAA;AACpB,4CAA2C;AAAlC,oGAAA,QAAQ,OAAA;AACjB,0CAAyC;AAAhC,kGAAA,OAAO,OAAA;AAGhB,yDAAwD;AAA/C,4GAAA,YAAY,OAAA;AACrB,iEAAgE;AAAvD,oHAAA,gBAAgB,OAAA;AACzB,uDAAsD;AAA7C,0GAAA,WAAW,OAAA;AAGpB,0CAAwB;AAGX,QAAA,OAAO,GAAG,OAAO,CAAC"}

package/dist/providers/SendGridProvider.d.ts

@@ -0,0 +1,7 @@
+import { MailOptions, MailResponse, SendGridConfig } from '../types';
+export declare class SendGridProvider {
+    private apiKey;
+    constructor(config: SendGridConfig);
+    send(options: MailOptions): Promise<MailResponse>;
+}
+//# sourceMappingURL=SendGridProvider.d.ts.map

package/dist/providers/SendGridProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SendGridProvider.d.ts","sourceRoot":"","sources":["../../src/providers/SendGridProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAe,MAAM,UAAU,CAAC;AAiClF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,cAAc;IAW5B,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;CAyCxD"}

package/dist/providers/SendGridProvider.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SendGridProvider = void 0;
+let sendGridMail = null;
+try {
+    sendGridMail = require('@sendgrid/mail');
+}
+catch {
+}
+function formatAddress(address) {
+    if (typeof address === 'string') {
+        return address;
+    }
+    return address.name ? `${address.name} <${address.address}>` : address.address;
+}
+function formatAddresses(addresses) {
+    if (Array.isArray(addresses)) {
+        return addresses.map((addr) => formatAddress(addr));
+    }
+    return formatAddress(addresses);
+}
+class SendGridProvider {
+    apiKey;
+    constructor(config) {
+        if (!sendGridMail) {
+            throw new Error('SendGrid provider requires @sendgrid/mail package. Install it with: npm install @sendgrid/mail');
+        }
+        this.apiKey = config.apiKey;
+        sendGridMail.setApiKey(this.apiKey);
+    }
+    async send(options) {
+        if (!sendGridMail) {
+            return {
+                success: false,
+                error: 'SendGrid not available',
+            };
+        }
+        try {
+            const msg = {
+                to: formatAddresses(options.to),
+                from: options.from ? formatAddress(options.from) : undefined,
+                subject: options.subject,
+                text: options.text,
+                html: options.html,
+                cc: options.cc ? formatAddresses(options.cc) : undefined,
+                bcc: options.bcc ? formatAddresses(options.bcc) : undefined,
+                replyTo: options.replyTo ? formatAddress(options.replyTo) : undefined,
+                attachments: options.attachments?.map((att) => ({
+                    filename: att.filename,
+                    content: att.content?.toString('base64') ?? '',
+                    type: att.contentType,
+                    disposition: 'attachment',
+                })),
+                headers: options.headers,
+            };
+            const [response] = await sendGridMail.send(msg);
+            return {
+                success: true,
+                messageId: response.headers['x-message-id'],
+                response: `${response.statusCode} ${response.statusMessage ?? ''}`,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error occurred',
+            };
+        }
+    }
+}
+exports.SendGridProvider = SendGridProvider;
+//# sourceMappingURL=SendGridProvider.js.map

package/dist/providers/SendGridProvider.js.map

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

package/dist/providers/SesProvider.d.ts

@@ -0,0 +1,7 @@
+import { MailOptions, MailResponse, SesConfig } from '../types';
+export declare class SesProvider {
+    private client;
+    constructor(config: SesConfig);
+    send(options: MailOptions): Promise<MailResponse>;
+}
+//# sourceMappingURL=SesProvider.d.ts.map

package/dist/providers/SesProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SesProvider.d.ts","sourceRoot":"","sources":["../../src/providers/SesProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAe,MAAM,UAAU,CAAC;AAuC7E,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAY;gBAEd,MAAM,EAAE,SAAS;IAoBvB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;CA0DxD"}

package/dist/providers/SesProvider.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SesProvider = void 0;
+let SESClient = null;
+let SendEmailCommand = null;
+try {
+    const sesModule = require('@aws-sdk/client-ses');
+    SESClient = sesModule.SESClient;
+    SendEmailCommand = sesModule.SendEmailCommand;
+}
+catch {
+}
+function formatAddress(address) {
+    if (typeof address === 'string') {
+        return address;
+    }
+    return address.name ? `"${address.name}" <${address.address}>` : address.address;
+}
+function formatAddresses(addresses) {
+    if (Array.isArray(addresses)) {
+        return addresses.map((addr) => formatAddress(addr));
+    }
+    return [formatAddress(addresses)];
+}
+class SesProvider {
+    client;
+    constructor(config) {
+        if (!SESClient || !SendEmailCommand) {
+            throw new Error('AWS SES provider requires @aws-sdk/client-ses package. Install it with: npm install @aws-sdk/client-ses');
+        }
+        this.client = new SESClient({
+            region: config.region,
+            ...(config.accessKeyId && config.secretAccessKey
+                ? {
+                    credentials: {
+                        accessKeyId: config.accessKeyId,
+                        secretAccessKey: config.secretAccessKey,
+                    },
+                }
+                : {}),
+        });
+    }
+    async send(options) {
+        if (!SendEmailCommand) {
+            return {
+                success: false,
+                error: 'AWS SES not available',
+            };
+        }
+        try {
+            const body = {};
+            if (options.html) {
+                body.Html = {
+                    Charset: 'UTF-8',
+                    Data: options.html,
+                };
+            }
+            if (options.text) {
+                body.Text = {
+                    Charset: 'UTF-8',
+                    Data: options.text,
+                };
+            }
+            const params = {
+                Source: options.from ? formatAddress(options.from) : undefined,
+                Destination: {
+                    ToAddresses: formatAddresses(options.to),
+                    CcAddresses: options.cc ? formatAddresses(options.cc) : undefined,
+                    BccAddresses: options.bcc ? formatAddresses(options.bcc) : undefined,
+                },
+                Message: {
+                    Subject: {
+                        Charset: 'UTF-8',
+                        Data: options.subject,
+                    },
+                    Body: body,
+                },
+                ReplyToAddresses: options.replyTo ? [formatAddress(options.replyTo)] : undefined,
+            };
+            const command = new SendEmailCommand(params);
+            const response = await this.client.send(command);
+            return {
+                success: true,
+                messageId: response.MessageId ?? '',
+                response: 'Email sent via AWS SES',
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error occurred',
+            };
+        }
+    }
+}
+exports.SesProvider = SesProvider;
+//# sourceMappingURL=SesProvider.js.map

package/dist/providers/SesProvider.js.map

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

package/dist/providers/SmtpProvider.d.ts

@@ -0,0 +1,8 @@
+import { MailOptions, MailResponse, SmtpConfig } from '../types';
+export declare class SmtpProvider {
+    private transporter;
+    constructor(config: SmtpConfig);
+    send(options: MailOptions): Promise<MailResponse>;
+    verify(): Promise<boolean>;
+}
+//# sourceMappingURL=SmtpProvider.d.ts.map

package/dist/providers/SmtpProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmtpProvider.d.ts","sourceRoot":"","sources":["../../src/providers/SmtpProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAe,MAAM,UAAU,CAAC;AAkB9E,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE,UAAU;IAexB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAqCjD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;CASjC"}

package/dist/providers/SmtpProvider.js

@@ -0,0 +1,81 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SmtpProvider = void 0;
+const nodemailer_1 = __importDefault(require("nodemailer"));
+function formatAddress(address) {
+    if (typeof address === 'string') {
+        return address;
+    }
+    return address.name ? `"${address.name}" <${address.address}>` : address.address;
+}
+function formatAddresses(addresses) {
+    if (Array.isArray(addresses)) {
+        return addresses.map((addr) => formatAddress(addr)).join(', ');
+    }
+    return formatAddress(addresses);
+}
+class SmtpProvider {
+    transporter;
+    constructor(config) {
+        this.transporter = nodemailer_1.default.createTransport({
+            host: config.host,
+            port: config.port,
+            secure: config.secure ?? false,
+            auth: config.auth
+                ? {
+                    user: String(config.auth.user),
+                    pass: String(config.auth.pass),
+                }
+                : undefined,
+            ...config.options,
+        });
+    }
+    async send(options) {
+        try {
+            const mailOptions = {
+                from: options.from ? formatAddress(options.from) : undefined,
+                to: formatAddresses(options.to),
+                cc: options.cc ? formatAddresses(options.cc) : undefined,
+                bcc: options.bcc ? formatAddresses(options.bcc) : undefined,
+                subject: options.subject,
+                text: options.text,
+                html: options.html,
+                attachments: options.attachments?.map((att) => ({
+                    filename: att.filename,
+                    content: att.content,
+                    path: att.path,
+                    contentType: att.contentType,
+                })),
+                replyTo: options.replyTo ? formatAddress(options.replyTo) : undefined,
+                headers: options.headers,
+            };
+            const info = await this.transporter.sendMail(mailOptions);
+            return {
+                success: true,
+                messageId: info.messageId ?? '',
+                response: info.response ?? '',
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error occurred',
+            };
+        }
+    }
+    async verify() {
+        try {
+            await this.transporter.verify();
+            return true;
+        }
+        catch (error) {
+            console.error('SMTP verification failed:', error);
+            return false;
+        }
+    }
+}
+exports.SmtpProvider = SmtpProvider;
+//# sourceMappingURL=SmtpProvider.js.map

package/dist/providers/SmtpProvider.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,92 @@
+export interface MailConfig {
+    default: string;
+    from: {
+        address: string;
+        name: string;
+    };
+    mailers: Record<string, MailerConfig>;
+}
+export interface MailerConfig {
+    driver: 'smtp' | 'sendgrid' | 'ses' | 'mailgun' | 'resend' | 'postmark' | 'mailtrap';
+    [key: string]: unknown;
+}
+export interface SmtpConfig extends MailerConfig {
+    driver: 'smtp';
+    host: string;
+    port: number;
+    username?: string;
+    password?: string;
+    encryption?: 'tls' | 'ssl';
+    secure?: boolean;
+    auth?: {
+        user: string;
+        pass: string;
+    };
+    options?: Record<string, unknown>;
+}
+export interface SendGridConfig extends MailerConfig {
+    driver: 'sendgrid';
+    apiKey: string;
+}
+export interface SesConfig extends MailerConfig {
+    driver: 'ses';
+    region: string;
+    accessKeyId?: string;
+    secretAccessKey?: string;
+}
+export interface MailgunConfig extends MailerConfig {
+    driver: 'mailgun';
+    domain: string;
+    apiKey: string;
+    region?: 'us' | 'eu';
+}
+export interface ResendConfig extends MailerConfig {
+    driver: 'resend';
+    apiKey: string;
+}
+export interface PostmarkConfig extends MailerConfig {
+    driver: 'postmark';
+    serverToken: string;
+}
+export interface MailtrapConfig extends MailerConfig {
+    driver: 'mailtrap';
+    token: string;
+    inboxId: string;
+}
+export interface MailAddress {
+    address: string;
+    name?: string;
+}
+export interface Attachment {
+    filename: string;
+    content?: Buffer | string;
+    path?: string;
+    contentType?: string;
+    cid?: string;
+}
+export interface MailOptions {
+    to: string | string[] | MailAddress | MailAddress[];
+    from?: string | MailAddress;
+    subject: string;
+    html?: string;
+    text?: string;
+    cc?: string | string[] | MailAddress | MailAddress[];
+    bcc?: string | string[] | MailAddress | MailAddress[];
+    replyTo?: string | MailAddress;
+    attachments?: Attachment[];
+    headers?: Record<string, string>;
+    template?: string;
+    data?: Record<string, unknown>;
+}
+export interface MailProvider {
+    send(options: MailOptions): Promise<MailResponse>;
+}
+export interface MailResponse {
+    success: boolean;
+    messageId?: string;
+    accepted?: string[];
+    rejected?: string[];
+    response?: string;
+    error?: string;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/examples/aws-ses.ts

@@ -0,0 +1,46 @@
+import { Mail } from '../src/index.js';
+import dotenv from 'dotenv';
+
+// Load environment variables
+dotenv.config();
+
+// Configure mail with AWS SES
+Mail.configure({
+  default: 'ses',
+  from: {
+    address: 'noreply@example.com',
+    name: 'Nodemail Test',
+  },
+  mailers: {
+    ses: {
+      driver: 'ses',
+      region: process.env.AWS_REGION ?? 'us-east-1',
+      accessKeyId: process.env.AWS_ACCESS_KEY_ID,
+      secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
+    },
+  },
+});
+
+async function sendTestEmail() {
+  try {
+    console.log('Sending test email via AWS SES...');
+
+    const result = await Mail.to('test@example.com')
+      .subject('Test Email from Nodemail (AWS SES)')
+      .html('<h1>Hello from Nodemail!</h1><p>This email was sent via AWS SES.</p>')
+      .text('Hello from Nodemail! This email was sent via AWS SES.')
+      .send();
+
+    if (result.success) {
+      console.log('✅ Email sent successfully!');
+      console.log('Message ID:', result.messageId);
+    } else {
+      console.error('❌ Failed to send email:', result.error);
+    }
+  } catch (error) {
+    console.error('❌ Error:', error);
+  }
+}
+
+// Run the test
+sendTestEmail().catch(console.error);

package/examples/basic-smtp.ts

@@ -0,0 +1,50 @@
+import { Mail } from '../src/index.js';
+import dotenv from 'dotenv';
+
+// Load environment variables
+dotenv.config();
+
+// Configure mail with SMTP
+Mail.configure({
+  default: 'smtp',
+  from: {
+    address: 'noreply@example.com',
+    name: 'Nodemail Test',
+  },
+  mailers: {
+    smtp: {
+      driver: 'smtp',
+      host: process.env.SMTP_HOST ?? 'smtp.mailtrap.io',
+      port: Number(process.env.SMTP_PORT) || 587,
+      secure: false,
+      auth: {
+        user: process.env.SMTP_USER ?? '',
+        pass: process.env.SMTP_PASS ?? '',
+      },
+    },
+  },
+});
+
+async function sendTestEmail() {
+  try {
+    console.log('Sending test email...');
+
+    const result = await Mail.to('test@example.com')
+      .subject('Test Email from Nodemail')
+      .html('<h1>Hello from Nodemail!</h1><p>This is a test email.</p>')
+      .text('Hello from Nodemail! This is a test email.')
+      .send();
+
+    if (result.success) {
+      console.log('✅ Email sent successfully!');
+      console.log('Message ID:', result.messageId);
+    } else {
+      console.error('❌ Failed to send email:', result.error);
+    }
+  } catch (error) {
+    console.error('❌ Error:', error);
+  }
+}
+
+// Run the test
+sendTestEmail().catch(console.error);