@studiosonrai/nestjs-email 1.0.0

package/dist/src/email.constants.d.ts

@@ -0,0 +1,2 @@
+export declare const EMAIL_MODULE_OPTIONS = "EMAIL_MODULE_OPTIONS";
+export declare const EMAIL_PROVIDER = "EMAIL_PROVIDER";

package/dist/src/email.constants.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMAIL_PROVIDER = exports.EMAIL_MODULE_OPTIONS = void 0;
+exports.EMAIL_MODULE_OPTIONS = 'EMAIL_MODULE_OPTIONS';
+exports.EMAIL_PROVIDER = 'EMAIL_PROVIDER';
+//# sourceMappingURL=email.constants.js.map

package/dist/src/email.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.constants.js","sourceRoot":"","sources":["../../src/email.constants.ts"],"names":[],"mappings":";;;AAGa,QAAA,oBAAoB,GAAG,sBAAsB,CAAC;AAK9C,QAAA,cAAc,GAAG,gBAAgB,CAAC"}

package/dist/src/email.module.d.ts

@@ -0,0 +1,8 @@
+import { DynamicModule } from '@nestjs/common';
+import { EmailModuleOptions, EmailModuleAsyncOptions } from './interfaces/email.interfaces';
+export declare class EmailModule {
+    static forRoot(options: EmailModuleOptions): DynamicModule;
+    static forRootAsync(options: EmailModuleAsyncOptions): DynamicModule;
+    private static createAsyncProviders;
+    private static createAsyncOptionsProvider;
+}

package/dist/src/email.module.js

@@ -0,0 +1,105 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var EmailModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailModule = void 0;
+const common_1 = require("@nestjs/common");
+const email_service_1 = require("./email.service");
+const email_constants_1 = require("./email.constants");
+const smtp_provider_1 = require("./providers/smtp.provider");
+const azure_provider_1 = require("./providers/azure.provider");
+function createEmailProvider(options) {
+    const providerOptions = {
+        defaultFrom: options.defaultFrom,
+        imageCompression: options.imageCompression,
+        verbose: options.verbose,
+    };
+    if (options.provider === 'smtp') {
+        if (!options.smtp) {
+            throw new Error('SMTP configuration is required when provider is "smtp"');
+        }
+        return new smtp_provider_1.SmtpEmailProvider(options.smtp, providerOptions);
+    }
+    if (options.provider === 'azure') {
+        if (!options.azure) {
+            throw new Error('Azure configuration is required when provider is "azure"');
+        }
+        return new azure_provider_1.AzureEmailProvider(options.azure, providerOptions);
+    }
+    throw new Error(`Unknown email provider: ${options.provider}`);
+}
+let EmailModule = EmailModule_1 = class EmailModule {
+    static forRoot(options) {
+        const optionsProvider = {
+            provide: email_constants_1.EMAIL_MODULE_OPTIONS,
+            useValue: options,
+        };
+        const emailProvider = {
+            provide: email_constants_1.EMAIL_PROVIDER,
+            useValue: createEmailProvider(options),
+        };
+        return {
+            module: EmailModule_1,
+            providers: [optionsProvider, emailProvider, email_service_1.EmailService],
+            exports: [email_service_1.EmailService, email_constants_1.EMAIL_MODULE_OPTIONS, email_constants_1.EMAIL_PROVIDER],
+        };
+    }
+    static forRootAsync(options) {
+        const asyncProviders = this.createAsyncProviders(options);
+        const emailProvider = {
+            provide: email_constants_1.EMAIL_PROVIDER,
+            useFactory: (opts) => createEmailProvider(opts),
+            inject: [email_constants_1.EMAIL_MODULE_OPTIONS],
+        };
+        return {
+            module: EmailModule_1,
+            imports: options.imports ?? [],
+            providers: [...asyncProviders, emailProvider, email_service_1.EmailService],
+            exports: [email_service_1.EmailService, email_constants_1.EMAIL_MODULE_OPTIONS, email_constants_1.EMAIL_PROVIDER],
+        };
+    }
+    static createAsyncProviders(options) {
+        if (options.useExisting || options.useFactory) {
+            return [this.createAsyncOptionsProvider(options)];
+        }
+        if (options.useClass) {
+            return [
+                this.createAsyncOptionsProvider(options),
+                {
+                    provide: options.useClass,
+                    useClass: options.useClass,
+                },
+            ];
+        }
+        throw new Error('Invalid EmailModuleAsyncOptions: provide useExisting, useClass, or useFactory');
+    }
+    static createAsyncOptionsProvider(options) {
+        if (options.useFactory) {
+            return {
+                provide: email_constants_1.EMAIL_MODULE_OPTIONS,
+                useFactory: options.useFactory,
+                inject: options.inject ?? [],
+            };
+        }
+        const inject = options.useExisting ?? options.useClass;
+        if (!inject) {
+            throw new Error('Invalid EmailModuleAsyncOptions: provide useExisting, useClass, or useFactory');
+        }
+        return {
+            provide: email_constants_1.EMAIL_MODULE_OPTIONS,
+            useFactory: async (optionsFactory) => optionsFactory.createEmailOptions(),
+            inject: [inject],
+        };
+    }
+};
+exports.EmailModule = EmailModule;
+exports.EmailModule = EmailModule = EmailModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], EmailModule);
+//# sourceMappingURL=email.module.js.map

package/dist/src/email.module.js.map

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

package/dist/src/email.service.d.ts

@@ -0,0 +1,11 @@
+import { EmailProvider, SendEmailOptions, SendEmailResult, EmailModuleOptions, EmailAttachment } from './interfaces/email.interfaces';
+export declare class EmailService {
+    private readonly options;
+    private readonly provider;
+    constructor(options: EmailModuleOptions, provider: EmailProvider);
+    sendEmail(to: string | string[], subject: string, body: string, attachments?: EmailAttachment[]): Promise<SendEmailResult>;
+    send(options: SendEmailOptions): Promise<SendEmailResult>;
+    trySend(options: SendEmailOptions): Promise<SendEmailResult>;
+    isReady(): boolean;
+    getProviderType(): string;
+}

package/dist/src/email.service.js

@@ -0,0 +1,59 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailService = void 0;
+const common_1 = require("@nestjs/common");
+const email_constants_1 = require("./email.constants");
+let EmailService = class EmailService {
+    constructor(options, provider) {
+        this.options = options;
+        this.provider = provider;
+    }
+    async sendEmail(to, subject, body, attachments) {
+        const result = await this.provider.sendEmail({
+            to,
+            subject,
+            html: body,
+            attachments,
+        });
+        if (!result.success) {
+            throw new common_1.InternalServerErrorException(result.error?.message ?? 'Failed to send email');
+        }
+        return result;
+    }
+    async send(options) {
+        const result = await this.provider.sendEmail(options);
+        if (!result.success) {
+            throw new common_1.InternalServerErrorException(result.error?.message ?? 'Failed to send email');
+        }
+        return result;
+    }
+    async trySend(options) {
+        return this.provider.sendEmail(options);
+    }
+    isReady() {
+        return this.provider.isReady();
+    }
+    getProviderType() {
+        return this.options.provider;
+    }
+};
+exports.EmailService = EmailService;
+exports.EmailService = EmailService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(email_constants_1.EMAIL_MODULE_OPTIONS)),
+    __param(1, (0, common_1.Inject)(email_constants_1.EMAIL_PROVIDER)),
+    __metadata("design:paramtypes", [Object, Object])
+], EmailService);
+//# sourceMappingURL=email.service.js.map

package/dist/src/email.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.service.js","sourceRoot":"","sources":["../../src/email.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAkF;AAQlF,uDAAyE;AAMlE,IAAM,YAAY,GAAlB,MAAM,YAAY;IACvB,YAEmB,OAA2B,EAE3B,QAAuB;QAFvB,YAAO,GAAP,OAAO,CAAoB;QAE3B,aAAQ,GAAR,QAAQ,CAAe;IACvC,CAAC;IAUJ,KAAK,CAAC,SAAS,CACb,EAAqB,EACrB,OAAe,EACf,IAAY,EACZ,WAA+B;QAE/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC3C,EAAE;YACF,OAAO;YACP,IAAI,EAAE,IAAI;YACV,WAAW;SACZ,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,qCAA4B,CACpC,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,sBAAsB,CAChD,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAOD,KAAK,CAAC,IAAI,CAAC,OAAyB;QAClC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAEtD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,qCAA4B,CACpC,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,sBAAsB,CAChD,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAOD,KAAK,CAAC,OAAO,CAAC,OAAyB;QACrC,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAKD,OAAO;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IACjC,CAAC;IAKD,eAAe;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC/B,CAAC;CACF,CAAA;AA7EY,oCAAY;uBAAZ,YAAY;IADxB,IAAA,mBAAU,GAAE;IAGR,WAAA,IAAA,eAAM,EAAC,sCAAoB,CAAC,CAAA;IAE5B,WAAA,IAAA,eAAM,EAAC,gCAAc,CAAC,CAAA;;GAJd,YAAY,CA6ExB"}

package/dist/src/index.d.ts

@@ -0,0 +1,7 @@
+export * from './email.module';
+export * from './email.service';
+export * from './email.constants';
+export * from './template.service';
+export * from './interfaces/email.interfaces';
+export * from './providers/smtp.provider';
+export * from './providers/azure.provider';

package/dist/src/index.js

@@ -0,0 +1,24 @@
+"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 });
+__exportStar(require("./email.module"), exports);
+__exportStar(require("./email.service"), exports);
+__exportStar(require("./email.constants"), exports);
+__exportStar(require("./template.service"), exports);
+__exportStar(require("./interfaces/email.interfaces"), exports);
+__exportStar(require("./providers/smtp.provider"), exports);
+__exportStar(require("./providers/azure.provider"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,iDAA+B;AAC/B,kDAAgC;AAChC,oDAAkC;AAClC,qDAAmC;AAGnC,gEAA8C;AAG9C,4DAA0C;AAC1C,6DAA2C"}

package/dist/src/interfaces/email.interfaces.d.ts

@@ -0,0 +1,74 @@
+import { ModuleMetadata, Type } from '@nestjs/common';
+export interface EmailAttachment {
+    filename: string;
+    content: Buffer | string;
+    contentType?: string;
+    encoding?: string;
+}
+export interface SendEmailOptions {
+    to: string | string[];
+    subject: string;
+    html?: string;
+    text?: string;
+    attachments?: EmailAttachment[];
+    from?: string;
+    cc?: string | string[];
+    bcc?: string | string[];
+    replyTo?: string;
+}
+export interface SendEmailResult {
+    success: boolean;
+    messageId?: string;
+    error?: Error;
+}
+export interface SmtpTransportConfig {
+    host: string;
+    port: number;
+    secure?: boolean;
+    auth?: {
+        user: string;
+        pass: string;
+    };
+    tls?: {
+        rejectUnauthorized?: boolean;
+    };
+    connectionTimeout?: number;
+    greetingTimeout?: number;
+    socketTimeout?: number;
+}
+export interface AzureEmailConfig {
+    connectionString: string;
+    senderAddress: string;
+}
+export interface ImageCompressionOptions {
+    enabled: boolean;
+    maxWidth?: number;
+    quality?: number;
+}
+export type EmailProviderType = 'smtp' | 'azure';
+export interface EmailModuleOptions {
+    provider: EmailProviderType;
+    smtp?: SmtpTransportConfig;
+    azure?: AzureEmailConfig;
+    defaultFrom?: string;
+    imageCompression?: ImageCompressionOptions;
+    verbose?: boolean;
+}
+export interface EmailModuleOptionsFactory {
+    createEmailOptions(): Promise<EmailModuleOptions> | EmailModuleOptions;
+}
+export interface EmailModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    useExisting?: Type<EmailModuleOptionsFactory>;
+    useClass?: Type<EmailModuleOptionsFactory>;
+    useFactory?: (...args: any[]) => Promise<EmailModuleOptions> | EmailModuleOptions;
+    inject?: any[];
+}
+export interface EmailProvider {
+    sendEmail(options: SendEmailOptions): Promise<SendEmailResult>;
+    isReady(): boolean;
+}
+export type TemplateData = Record<string, any>;
+export interface TemplateValidationResult {
+    isValid: boolean;
+    missingKeys: string[];
+}

package/dist/src/interfaces/email.interfaces.js

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

package/dist/src/interfaces/email.interfaces.js.map

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

package/dist/src/providers/azure.provider.d.ts

@@ -0,0 +1,16 @@
+import { EmailProvider, SendEmailOptions, SendEmailResult, AzureEmailConfig, ImageCompressionOptions } from '../interfaces/email.interfaces';
+export declare class AzureEmailProvider implements EmailProvider {
+    private emailClient;
+    private senderAddress;
+    private ready;
+    private imageCompression?;
+    private verbose;
+    constructor(config: AzureEmailConfig, options?: {
+        imageCompression?: ImageCompressionOptions;
+        verbose?: boolean;
+    });
+    private initializeClient;
+    private compressAttachment;
+    sendEmail(options: SendEmailOptions): Promise<SendEmailResult>;
+    isReady(): boolean;
+}

package/dist/src/providers/azure.provider.js

@@ -0,0 +1,183 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AzureEmailProvider = void 0;
+class AzureEmailProvider {
+    constructor(config, options) {
+        this.ready = false;
+        this.senderAddress = config.senderAddress;
+        this.imageCompression = options?.imageCompression;
+        this.verbose = options?.verbose ?? false;
+        this.initializeClient(config.connectionString);
+    }
+    async initializeClient(connectionString) {
+        try {
+            const { EmailClient } = await Promise.resolve().then(() => __importStar(require('@azure/communication-email')));
+            this.emailClient = new EmailClient(connectionString);
+            this.ready = true;
+            if (this.verbose) {
+                console.log('[EmailModule] Azure Communication Email provider initialized');
+            }
+        }
+        catch (error) {
+            console.error('[EmailModule] Failed to initialize Azure Email provider:', error);
+            throw new Error('Failed to initialize Azure Email provider. Make sure @azure/communication-email is installed.');
+        }
+    }
+    async compressAttachment(attachment) {
+        if (!this.imageCompression?.enabled) {
+            return attachment;
+        }
+        if (!attachment.contentType?.startsWith('image/')) {
+            return attachment;
+        }
+        try {
+            const sharp = (await Promise.resolve().then(() => __importStar(require('sharp')))).default;
+            const buffer = attachment.content instanceof Buffer
+                ? attachment.content
+                : Buffer.from(attachment.content, 'base64');
+            const compressedBuffer = await sharp(buffer)
+                .resize({
+                width: this.imageCompression.maxWidth ?? 1200,
+                withoutEnlargement: true,
+            })
+                .jpeg({ quality: this.imageCompression.quality ?? 75 })
+                .toBuffer();
+            return {
+                ...attachment,
+                content: compressedBuffer,
+                contentType: 'image/jpeg',
+            };
+        }
+        catch (error) {
+            if (this.verbose) {
+                console.warn(`[EmailModule] Failed to compress ${attachment.filename}, sending original.`);
+            }
+            return attachment;
+        }
+    }
+    async sendEmail(options) {
+        if (!this.emailClient) {
+            return {
+                success: false,
+                error: new Error('Azure Email client not initialized'),
+            };
+        }
+        try {
+            let processedAttachments = [];
+            if (options.attachments?.length) {
+                processedAttachments = await Promise.all(options.attachments.map((att) => this.compressAttachment(att)));
+            }
+            if (processedAttachments.length > 0) {
+                const totalSize = processedAttachments.reduce((acc, att) => {
+                    const size = att.content instanceof Buffer
+                        ? att.content.length
+                        : Buffer.byteLength(att.content, 'base64');
+                    return acc + size;
+                }, 0);
+                if (totalSize > 10 * 1024 * 1024) {
+                    return {
+                        success: false,
+                        error: new Error('Attachments exceed Azure 10MB email size limit'),
+                    };
+                }
+            }
+            const toRecipients = Array.isArray(options.to)
+                ? options.to.map((addr) => ({ address: addr }))
+                : [{ address: options.to }];
+            const emailMessage = {
+                senderAddress: options.from ?? this.senderAddress,
+                content: {
+                    subject: options.subject,
+                    html: options.html,
+                    plainText: options.text,
+                },
+                recipients: {
+                    to: toRecipients,
+                },
+            };
+            if (options.cc) {
+                const ccRecipients = Array.isArray(options.cc)
+                    ? options.cc.map((addr) => ({ address: addr }))
+                    : [{ address: options.cc }];
+                emailMessage.recipients.cc = ccRecipients;
+            }
+            if (options.bcc) {
+                const bccRecipients = Array.isArray(options.bcc)
+                    ? options.bcc.map((addr) => ({ address: addr }))
+                    : [{ address: options.bcc }];
+                emailMessage.recipients.bcc = bccRecipients;
+            }
+            if (options.replyTo) {
+                emailMessage.replyTo = [{ address: options.replyTo }];
+            }
+            if (processedAttachments.length > 0) {
+                emailMessage.attachments = processedAttachments.map((att) => {
+                    const contentBase64 = att.content instanceof Buffer
+                        ? att.content.toString('base64')
+                        : att.content;
+                    return {
+                        name: att.filename,
+                        contentType: att.contentType ?? 'application/octet-stream',
+                        contentInBase64: typeof contentBase64 === 'string'
+                            ? contentBase64
+                            : contentBase64.toString('base64'),
+                    };
+                });
+            }
+            const poller = await this.emailClient.beginSend(emailMessage);
+            const result = await poller.pollUntilDone();
+            if (this.verbose) {
+                console.log(`[EmailModule] Email sent successfully via Azure to ${options.to}`);
+            }
+            return {
+                success: true,
+                messageId: result?.id,
+            };
+        }
+        catch (error) {
+            console.error('[EmailModule] Azure send error:', error);
+            return {
+                success: false,
+                error: error instanceof Error ? error : new Error(String(error)),
+            };
+        }
+    }
+    isReady() {
+        return this.ready;
+    }
+}
+exports.AzureEmailProvider = AzureEmailProvider;
+//# sourceMappingURL=azure.provider.js.map

package/dist/src/providers/azure.provider.js.map

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

package/dist/src/providers/index.d.ts

@@ -0,0 +1,2 @@
+export * from './smtp.provider';
+export * from './azure.provider';

package/dist/src/providers/index.js

@@ -0,0 +1,19 @@
+"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 });
+__exportStar(require("./smtp.provider"), exports);
+__exportStar(require("./azure.provider"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,mDAAiC"}

package/dist/src/providers/smtp.provider.d.ts

@@ -0,0 +1,17 @@
+import { EmailProvider, SendEmailOptions, SendEmailResult, SmtpTransportConfig, ImageCompressionOptions } from '../interfaces/email.interfaces';
+export declare class SmtpEmailProvider implements EmailProvider {
+    private transporter;
+    private ready;
+    private defaultFrom?;
+    private imageCompression?;
+    private verbose;
+    constructor(config: SmtpTransportConfig, options?: {
+        defaultFrom?: string;
+        imageCompression?: ImageCompressionOptions;
+        verbose?: boolean;
+    });
+    private initializeTransporter;
+    private compressAttachment;
+    sendEmail(options: SendEmailOptions): Promise<SendEmailResult>;
+    isReady(): boolean;
+}