@flusys/nestjs-email 1.1.0-beta

package/cjs/entities/email-template-with-company.entity.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "EmailTemplateWithCompany", {
+    enumerable: true,
+    get: function() {
+        return EmailTemplateWithCompany;
+    }
+});
+const _typeorm = require("typeorm");
+const _emailtemplatebaseentity = require("./email-template-base.entity");
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _ts_decorate(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;
+}
+function _ts_metadata(k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+let EmailTemplateWithCompany = class EmailTemplateWithCompany extends _emailtemplatebaseentity.EmailTemplateBase {
+    constructor(...args){
+        super(...args), _define_property(this, "companyId", void 0);
+    }
+};
+_ts_decorate([
+    (0, _typeorm.Column)({
+        type: 'uuid',
+        nullable: true,
+        name: 'company_id'
+    }),
+    _ts_metadata("design:type", Object)
+], EmailTemplateWithCompany.prototype, "companyId", void 0);
+EmailTemplateWithCompany = _ts_decorate([
+    (0, _typeorm.Entity)({
+        name: 'email_template'
+    }),
+    (0, _typeorm.Index)([
+        'companyId'
+    ]),
+    (0, _typeorm.Index)([
+        'companyId',
+        'slug'
+    ]),
+    (0, _typeorm.Index)([
+        'companyId',
+        'isActive'
+    ])
+], EmailTemplateWithCompany);

package/cjs/entities/email-template.entity.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "EmailTemplate", {
+    enumerable: true,
+    get: function() {
+        return EmailTemplate;
+    }
+});
+const _typeorm = require("typeorm");
+const _emailtemplatebaseentity = require("./email-template-base.entity");
+function _ts_decorate(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;
+}
+let EmailTemplate = class EmailTemplate extends _emailtemplatebaseentity.EmailTemplateBase {
+};
+EmailTemplate = _ts_decorate([
+    (0, _typeorm.Entity)({
+        name: 'email_template'
+    })
+], EmailTemplate);

package/cjs/entities/index.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "getEmailEntitiesByConfig", {
+    enumerable: true,
+    get: function() {
+        return getEmailEntitiesByConfig;
+    }
+});
+_export_star(require("./email-config-base.entity"), exports);
+_export_star(require("./email-config.entity"), exports);
+_export_star(require("./email-config-with-company.entity"), exports);
+_export_star(require("./email-template-base.entity"), exports);
+_export_star(require("./email-template.entity"), exports);
+_export_star(require("./email-template-with-company.entity"), exports);
+function _export_star(from, to) {
+    Object.keys(from).forEach(function(k) {
+        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
+            Object.defineProperty(to, k, {
+                enumerable: true,
+                get: function() {
+                    return from[k];
+                }
+            });
+        }
+    });
+    return from;
+}
+function getEmailEntitiesByConfig(enableCompanyFeature) {
+    if (enableCompanyFeature) {
+        return [
+            require('./email-config-with-company.entity').EmailConfigWithCompany,
+            require('./email-template-with-company.entity').EmailTemplateWithCompany
+        ];
+    }
+    return [
+        require('./email-config.entity').EmailConfig,
+        require('./email-template.entity').EmailTemplate
+    ];
+}

package/cjs/enums/email-provider-type.enum.js

@@ -0,0 +1,18 @@
+/**
+ * Supported email provider types
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "EmailProviderTypeEnum", {
+    enumerable: true,
+    get: function() {
+        return EmailProviderTypeEnum;
+    }
+});
+var EmailProviderTypeEnum = /*#__PURE__*/ function(EmailProviderTypeEnum) {
+    /** SMTP - Default provider using nodemailer (always available) */ EmailProviderTypeEnum["SMTP"] = "smtp";
+    /** SendGrid - Optional (requires @sendgrid/mail) */ EmailProviderTypeEnum["SENDGRID"] = "sendgrid";
+    /** Mailgun - Optional (requires mailgun.js) */ EmailProviderTypeEnum["MAILGUN"] = "mailgun";
+    return EmailProviderTypeEnum;
+}({});

package/cjs/enums/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+_export_star(require("./email-provider-type.enum"), exports);
+function _export_star(from, to) {
+    Object.keys(from).forEach(function(k) {
+        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
+            Object.defineProperty(to, k, {
+                enumerable: true,
+                get: function() {
+                    return from[k];
+                }
+            });
+        }
+    });
+    return from;
+}

package/cjs/index.js

@@ -0,0 +1,27 @@
+// Export all email module components
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+_export_star(require("./controllers"), exports);
+_export_star(require("./services"), exports);
+_export_star(require("./entities"), exports);
+_export_star(require("./modules"), exports);
+_export_star(require("./config"), exports);
+_export_star(require("./dtos"), exports);
+_export_star(require("./enums"), exports);
+_export_star(require("./interfaces"), exports);
+_export_star(require("./providers"), exports);
+function _export_star(from, to) {
+    Object.keys(from).forEach(function(k) {
+        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
+            Object.defineProperty(to, k, {
+                enumerable: true,
+                get: function() {
+                    return from[k];
+                }
+            });
+        }
+    });
+    return from;
+}

package/cjs/interfaces/email-config.interface.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});

package/cjs/interfaces/email-module-options.interface.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});

package/cjs/interfaces/email-provider.interface.js

@@ -0,0 +1,6 @@
+/**
+ * Email provider configuration
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});

package/cjs/interfaces/email-template.interface.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});

package/cjs/interfaces/index.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+_export_star(require("./email-provider.interface"), exports);
+_export_star(require("./email-module-options.interface"), exports);
+_export_star(require("./email-config.interface"), exports);
+_export_star(require("./email-template.interface"), exports);
+function _export_star(from, to) {
+    Object.keys(from).forEach(function(k) {
+        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
+            Object.defineProperty(to, k, {
+                enumerable: true,
+                get: function() {
+                    return from[k];
+                }
+            });
+        }
+    });
+    return from;
+}

package/cjs/modules/email.module.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "EmailModule", {
+    enumerable: true,
+    get: function() {
+        return EmailModule;
+    }
+});
+const _modules = require("@flusys/nestjs-shared/modules");
+const _common = require("@nestjs/common");
+const _config = require("../config");
+const _emailconstants = require("../config/email.constants");
+const _enums = require("../enums");
+const _providers = require("../providers");
+const _services = require("../services");
+const _controllers = require("../controllers");
+function _ts_decorate(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;
+}
+// Auto-register built-in email providers
+const logger = new _common.Logger('EmailModule');
+// Register all providers (they use dynamic imports internally)
+_providers.EmailProviderRegistry.register(_enums.EmailProviderTypeEnum.SMTP, _providers.SmtpProvider);
+logger.log('Registered SmtpProvider');
+_providers.EmailProviderRegistry.register(_enums.EmailProviderTypeEnum.SENDGRID, _providers.SendGridProvider);
+logger.log('Registered SendGridProvider');
+_providers.EmailProviderRegistry.register(_enums.EmailProviderTypeEnum.MAILGUN, _providers.MailgunProvider);
+logger.log('Registered MailgunProvider');
+let EmailModule = class EmailModule {
+    /**
+   * Register EmailModule synchronously
+   */ static forRoot(options) {
+        const controllers = this.getControllers(options);
+        const providers = this.getProviders(options);
+        return {
+            module: EmailModule,
+            global: options.global ?? false,
+            imports: [
+                _modules.CacheModule,
+                _modules.UtilsModule
+            ],
+            controllers: options.includeController !== false ? controllers : [],
+            providers,
+            exports: [
+                _config.EmailConfigService,
+                _services.EmailDataSourceProvider,
+                _services.EmailProviderConfigService,
+                _services.EmailTemplateService,
+                _services.EmailSendService,
+                _providers.EmailFactoryService
+            ]
+        };
+    }
+    /**
+   * Register EmailModule asynchronously
+   */ static forRootAsync(options) {
+        const controllers = this.getControllers(options);
+        const asyncProviders = this.createAsyncProviders(options);
+        return {
+            module: EmailModule,
+            global: options.global ?? false,
+            imports: [
+                ...options.imports || [],
+                _modules.CacheModule,
+                _modules.UtilsModule
+            ],
+            controllers: options.includeController !== false ? controllers : [],
+            providers: [
+                ...asyncProviders,
+                ...this.getProviders(options, false)
+            ],
+            exports: [
+                _config.EmailConfigService,
+                _services.EmailDataSourceProvider,
+                _services.EmailProviderConfigService,
+                _services.EmailTemplateService,
+                _services.EmailSendService,
+                _providers.EmailFactoryService
+            ]
+        };
+    }
+    // ==================== Private Helper Methods ====================
+    /**
+   * Get controllers
+   */ static getControllers(_options) {
+        return [
+            _controllers.EmailConfigController,
+            _controllers.EmailTemplateController,
+            _controllers.EmailSendController
+        ];
+    }
+    /**
+   * Get providers
+   */ static getProviders(options, includeOptionsProvider = true) {
+        const providers = [
+            _config.EmailConfigService,
+            _services.EmailDataSourceProvider,
+            _services.EmailProviderConfigService,
+            _services.EmailTemplateService,
+            _services.EmailSendService,
+            _providers.EmailFactoryService
+        ];
+        if (includeOptionsProvider) {
+            providers.unshift({
+                provide: _emailconstants.EMAIL_MODULE_OPTIONS,
+                useValue: options
+            });
+        }
+        return providers;
+    }
+    /**
+   * Create async providers for forRootAsync
+   */ static createAsyncProviders(options) {
+        if (options.useFactory) {
+            return [
+                {
+                    provide: _emailconstants.EMAIL_MODULE_OPTIONS,
+                    useFactory: async (...args)=>{
+                        const config = await options.useFactory(...args);
+                        return {
+                            ...options,
+                            config
+                        };
+                    },
+                    inject: options.inject || []
+                }
+            ];
+        }
+        if (options.useClass) {
+            return [
+                {
+                    provide: _emailconstants.EMAIL_MODULE_OPTIONS,
+                    useFactory: async (optionsFactory)=>{
+                        const config = await optionsFactory.createEmailOptions();
+                        return {
+                            ...options,
+                            config
+                        };
+                    },
+                    inject: [
+                        options.useClass
+                    ]
+                },
+                {
+                    provide: options.useClass,
+                    useClass: options.useClass
+                }
+            ];
+        }
+        if (options.useExisting) {
+            return [
+                {
+                    provide: _emailconstants.EMAIL_MODULE_OPTIONS,
+                    useFactory: async (optionsFactory)=>{
+                        const config = await optionsFactory.createEmailOptions();
+                        return {
+                            ...options,
+                            config
+                        };
+                    },
+                    inject: [
+                        options.useExisting
+                    ]
+                }
+            ];
+        }
+        return [];
+    }
+};
+EmailModule = _ts_decorate([
+    (0, _common.Module)({})
+], EmailModule);

package/cjs/modules/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+_export_star(require("./email.module"), exports);
+function _export_star(from, to) {
+    Object.keys(from).forEach(function(k) {
+        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
+            Object.defineProperty(to, k, {
+                enumerable: true,
+                get: function() {
+                    return from[k];
+                }
+            });
+        }
+    });
+    return from;
+}

package/cjs/providers/email-factory.service.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "EmailFactoryService", {
+    enumerable: true,
+    get: function() {
+        return EmailFactoryService;
+    }
+});
+const _common = require("@nestjs/common");
+const _crypto = /*#__PURE__*/ _interop_require_wildcard(require("crypto"));
+const _emailconfigservice = require("../config/email-config.service");
+const _emailproviderregistry = require("./email-provider.registry");
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interop_require_wildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
+        return {
+            default: obj
+        };
+    }
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
+    }
+    var newObj = {
+        __proto__: null
+    };
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
+            }
+        }
+    }
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
+}
+function _ts_decorate(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;
+}
+function _ts_metadata(k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+function _ts_param(paramIndex, decorator) {
+    return function(target, key) {
+        decorator(target, key, paramIndex);
+    };
+}
+let EmailFactoryService = class EmailFactoryService {
+    /**
+   * Generate a unique cache key for a provider configuration
+   */ generateCacheKey(config) {
+        const configString = JSON.stringify(config.config, Object.keys(config.config || {}).sort());
+        const configHash = _crypto.createHash('sha256').update(configString).digest('hex').substring(0, 16);
+        return `${config.provider}-${configHash}`;
+    }
+    /**
+   * Create or retrieve a cached email provider instance
+   */ async createProvider(config) {
+        const providerKey = this.generateCacheKey(config);
+        // Return cached provider if exists
+        if (this.providerCache.has(providerKey)) {
+            return this.providerCache.get(providerKey);
+        }
+        // Get provider class from registry
+        const ProviderClass = _emailproviderregistry.EmailProviderRegistry.get(config.provider);
+        if (!ProviderClass) {
+            throw new _common.NotFoundException(`Email provider '${config.provider}' is not registered. ` + `Available providers: ${_emailproviderregistry.EmailProviderRegistry.getAll().join(', ')}`);
+        }
+        try {
+            // Create new instance
+            const instance = new ProviderClass();
+            // Initialize if provider has initialize method
+            if ('initialize' in instance && typeof instance.initialize === 'function') {
+                await instance.initialize(config.config);
+            }
+            // Cache the instance
+            this.providerCache.set(providerKey, instance);
+            this.logger.log(`Created email provider: ${config.provider} (key: ${providerKey})`);
+            return instance;
+        } catch (error) {
+            this.logger.error(`Failed to create provider ${config.provider}:`, error);
+            throw new Error(`Failed to initialize email provider '${config.provider}': ${error?.message || 'Unknown error'}`);
+        }
+    }
+    /**
+   * Check if a provider is available (registered)
+   */ isProviderAvailable(providerName) {
+        return _emailproviderregistry.EmailProviderRegistry.has(providerName);
+    }
+    /**
+   * Get list of available providers
+   */ getAvailableProviders() {
+        return _emailproviderregistry.EmailProviderRegistry.getAll();
+    }
+    /**
+   * Cleanup on module destroy
+   */ async onModuleDestroy() {
+        this.logger.log('Cleaning up email provider connections...');
+        const closePromises = [];
+        for (const [key, provider] of this.providerCache.entries()){
+            if ('close' in provider && typeof provider.close === 'function') {
+                closePromises.push(provider.close().then(()=>this.logger.debug(`Closed provider: ${key}`)).catch((err)=>this.logger.warn(`Failed to close provider ${key}: ${err.message}`)));
+            }
+        }
+        await Promise.allSettled(closePromises);
+        this.providerCache.clear();
+        this.logger.log('Email provider cleanup complete');
+    }
+    constructor(emailConfigService){
+        _define_property(this, "emailConfigService", void 0);
+        _define_property(this, "logger", void 0);
+        _define_property(this, "providerCache", void 0);
+        this.emailConfigService = emailConfigService;
+        this.logger = new _common.Logger(EmailFactoryService.name);
+        this.providerCache = new Map();
+    }
+};
+EmailFactoryService = _ts_decorate([
+    (0, _common.Injectable)(),
+    _ts_param(0, (0, _common.Inject)(_emailconfigservice.EmailConfigService)),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof _emailconfigservice.EmailConfigService === "undefined" ? Object : _emailconfigservice.EmailConfigService
+    ])
+], EmailFactoryService);

package/cjs/providers/email-provider.registry.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "EmailProviderRegistry", {
+    enumerable: true,
+    get: function() {
+        return EmailProviderRegistry;
+    }
+});
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+let EmailProviderRegistry = class EmailProviderRegistry {
+    /**
+   * Register an email provider
+   */ static register(providerName, providerClass) {
+        this.providers.set(providerName.toLowerCase(), providerClass);
+    }
+    /**
+   * Get a registered provider class
+   */ static get(providerName) {
+        return this.providers.get(providerName.toLowerCase());
+    }
+    /**
+   * Check if a provider is registered
+   */ static has(providerName) {
+        return this.providers.has(providerName.toLowerCase());
+    }
+    /**
+   * Get all registered provider names
+   */ static getAll() {
+        return Array.from(this.providers.keys());
+    }
+    /**
+   * Clear all providers (useful for testing)
+   */ static clear() {
+        this.providers.clear();
+    }
+};
+_define_property(EmailProviderRegistry, "providers", new Map());

package/cjs/providers/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+_export_star(require("./email-provider.registry"), exports);
+_export_star(require("./email-factory.service"), exports);
+_export_star(require("./smtp-provider"), exports);
+_export_star(require("./sendgrid-provider"), exports);
+_export_star(require("./mailgun-provider"), exports);
+function _export_star(from, to) {
+    Object.keys(from).forEach(function(k) {
+        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
+            Object.defineProperty(to, k, {
+                enumerable: true,
+                get: function() {
+                    return from[k];
+                }
+            });
+        }
+    });
+    return from;
+}