@flusys/nestjs-email 1.1.0-beta

package/fesm/entities/email-config-base.entity.js

@@ -0,0 +1,101 @@
+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);
+}
+import { Identity } from '@flusys/nestjs-shared/entities';
+import { Column, Index } from 'typeorm';
+import { EmailProviderTypeEnum } from '../enums';
+export class EmailConfigBase extends Identity {
+    constructor(...args){
+        super(...args), _define_property(this, "name", void 0), _define_property(this, "provider", void 0), _define_property(this, "config", void 0), _define_property(this, "fromEmail", void 0), _define_property(this, "fromName", void 0), _define_property(this, "isActive", void 0), _define_property(this, "isDefault", void 0);
+    }
+}
+_ts_decorate([
+    Column({
+        type: 'varchar',
+        length: 255,
+        nullable: false
+    }),
+    _ts_metadata("design:type", String)
+], EmailConfigBase.prototype, "name", void 0);
+_ts_decorate([
+    Column({
+        type: 'enum',
+        enum: EmailProviderTypeEnum,
+        nullable: false
+    }),
+    _ts_metadata("design:type", typeof EmailProviderTypeEnum === "undefined" ? Object : EmailProviderTypeEnum)
+], EmailConfigBase.prototype, "provider", void 0);
+_ts_decorate([
+    Column({
+        type: 'json',
+        nullable: false
+    }),
+    _ts_metadata("design:type", typeof Record === "undefined" ? Object : Record)
+], EmailConfigBase.prototype, "config", void 0);
+_ts_decorate([
+    Column({
+        type: 'varchar',
+        length: 255,
+        nullable: true,
+        name: 'from_email'
+    }),
+    _ts_metadata("design:type", Object)
+], EmailConfigBase.prototype, "fromEmail", void 0);
+_ts_decorate([
+    Column({
+        type: 'varchar',
+        length: 255,
+        nullable: true,
+        name: 'from_name'
+    }),
+    _ts_metadata("design:type", Object)
+], EmailConfigBase.prototype, "fromName", void 0);
+_ts_decorate([
+    Column({
+        type: 'boolean',
+        default: true,
+        name: 'is_active'
+    }),
+    _ts_metadata("design:type", Boolean)
+], EmailConfigBase.prototype, "isActive", void 0);
+_ts_decorate([
+    Column({
+        type: 'boolean',
+        default: false,
+        name: 'is_default'
+    }),
+    _ts_metadata("design:type", Boolean)
+], EmailConfigBase.prototype, "isDefault", void 0);
+EmailConfigBase = _ts_decorate([
+    Index([
+        'name'
+    ]),
+    Index([
+        'provider'
+    ]),
+    Index([
+        'isActive'
+    ]),
+    Index([
+        'isDefault'
+    ])
+], EmailConfigBase);

package/fesm/entities/email-config-with-company.entity.js

@@ -0,0 +1,53 @@
+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);
+}
+import { Column, Entity, Index } from 'typeorm';
+import { EmailConfigBase } from './email-config-base.entity';
+export class EmailConfigWithCompany extends EmailConfigBase {
+    constructor(...args){
+        super(...args), _define_property(this, "companyId", void 0);
+    }
+}
+_ts_decorate([
+    Column({
+        type: 'uuid',
+        nullable: true,
+        name: 'company_id'
+    }),
+    _ts_metadata("design:type", Object)
+], EmailConfigWithCompany.prototype, "companyId", void 0);
+EmailConfigWithCompany = _ts_decorate([
+    Entity({
+        name: 'email_config'
+    }),
+    Index([
+        'companyId'
+    ]),
+    Index([
+        'companyId',
+        'name'
+    ]),
+    Index([
+        'companyId',
+        'isActive'
+    ])
+], EmailConfigWithCompany);

package/fesm/entities/email-config.entity.js

@@ -0,0 +1,15 @@
+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;
+}
+import { Entity } from 'typeorm';
+import { EmailConfigBase } from './email-config-base.entity';
+export class EmailConfig extends EmailConfigBase {
+}
+EmailConfig = _ts_decorate([
+    Entity({
+        name: 'email_config'
+    })
+], EmailConfig);

package/fesm/entities/email-template-base.entity.js

@@ -0,0 +1,124 @@
+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);
+}
+import { Identity } from '@flusys/nestjs-shared/entities';
+import { Column, Index } from 'typeorm';
+export class EmailTemplateBase extends Identity {
+    constructor(...args){
+        super(...args), _define_property(this, "name", void 0), _define_property(this, "slug", void 0), _define_property(this, "description", void 0), _define_property(this, "subject", void 0), _define_property(this, "schema", void 0), _define_property(this, "htmlContent", void 0), _define_property(this, "textContent", void 0), _define_property(this, "schemaVersion", void 0), _define_property(this, "isActive", void 0), _define_property(this, "isHtml", void 0), _define_property(this, "metadata", void 0);
+    }
+}
+_ts_decorate([
+    Column({
+        type: 'varchar',
+        length: 255,
+        nullable: false
+    }),
+    _ts_metadata("design:type", String)
+], EmailTemplateBase.prototype, "name", void 0);
+_ts_decorate([
+    Column({
+        type: 'varchar',
+        length: 255,
+        nullable: false,
+        unique: true
+    }),
+    _ts_metadata("design:type", String)
+], EmailTemplateBase.prototype, "slug", void 0);
+_ts_decorate([
+    Column({
+        type: 'varchar',
+        length: 500,
+        nullable: true
+    }),
+    _ts_metadata("design:type", Object)
+], EmailTemplateBase.prototype, "description", void 0);
+_ts_decorate([
+    Column({
+        type: 'varchar',
+        length: 500,
+        nullable: false
+    }),
+    _ts_metadata("design:type", String)
+], EmailTemplateBase.prototype, "subject", void 0);
+_ts_decorate([
+    Column({
+        type: 'json',
+        nullable: false
+    }),
+    _ts_metadata("design:type", typeof Record === "undefined" ? Object : Record)
+], EmailTemplateBase.prototype, "schema", void 0);
+_ts_decorate([
+    Column({
+        type: 'text',
+        nullable: false,
+        name: 'html_content'
+    }),
+    _ts_metadata("design:type", String)
+], EmailTemplateBase.prototype, "htmlContent", void 0);
+_ts_decorate([
+    Column({
+        type: 'text',
+        nullable: true,
+        name: 'text_content'
+    }),
+    _ts_metadata("design:type", Object)
+], EmailTemplateBase.prototype, "textContent", void 0);
+_ts_decorate([
+    Column({
+        type: 'int',
+        nullable: false,
+        default: 1,
+        name: 'schema_version'
+    }),
+    _ts_metadata("design:type", Number)
+], EmailTemplateBase.prototype, "schemaVersion", void 0);
+_ts_decorate([
+    Column({
+        type: 'boolean',
+        default: true,
+        name: 'is_active'
+    }),
+    _ts_metadata("design:type", Boolean)
+], EmailTemplateBase.prototype, "isActive", void 0);
+_ts_decorate([
+    Column({
+        type: 'boolean',
+        default: true,
+        name: 'is_html'
+    }),
+    _ts_metadata("design:type", Boolean)
+], EmailTemplateBase.prototype, "isHtml", void 0);
+_ts_decorate([
+    Column('simple-json', {
+        nullable: true
+    }),
+    _ts_metadata("design:type", Object)
+], EmailTemplateBase.prototype, "metadata", void 0);
+EmailTemplateBase = _ts_decorate([
+    Index([
+        'name'
+    ]),
+    Index([
+        'isActive'
+    ])
+], EmailTemplateBase);

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

@@ -0,0 +1,53 @@
+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);
+}
+import { Column, Entity, Index } from 'typeorm';
+import { EmailTemplateBase } from './email-template-base.entity';
+export class EmailTemplateWithCompany extends EmailTemplateBase {
+    constructor(...args){
+        super(...args), _define_property(this, "companyId", void 0);
+    }
+}
+_ts_decorate([
+    Column({
+        type: 'uuid',
+        nullable: true,
+        name: 'company_id'
+    }),
+    _ts_metadata("design:type", Object)
+], EmailTemplateWithCompany.prototype, "companyId", void 0);
+EmailTemplateWithCompany = _ts_decorate([
+    Entity({
+        name: 'email_template'
+    }),
+    Index([
+        'companyId'
+    ]),
+    Index([
+        'companyId',
+        'slug'
+    ]),
+    Index([
+        'companyId',
+        'isActive'
+    ])
+], EmailTemplateWithCompany);

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

@@ -0,0 +1,15 @@
+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;
+}
+import { Entity } from 'typeorm';
+import { EmailTemplateBase } from './email-template-base.entity';
+export class EmailTemplate extends EmailTemplateBase {
+}
+EmailTemplate = _ts_decorate([
+    Entity({
+        name: 'email_template'
+    })
+], EmailTemplate);

package/fesm/entities/index.js

@@ -0,0 +1,20 @@
+export * from './email-config-base.entity';
+export * from './email-config.entity';
+export * from './email-config-with-company.entity';
+export * from './email-template-base.entity';
+export * from './email-template.entity';
+export * from './email-template-with-company.entity';
+/**
+ * Get email entities based on configuration
+ */ export 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/fesm/enums/email-provider-type.enum.js

@@ -0,0 +1,8 @@
+/**
+ * Supported email provider types
+ */ export 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/fesm/enums/index.js

@@ -0,0 +1 @@
+export * from './email-provider-type.enum';

package/fesm/index.js

@@ -0,0 +1,10 @@
+// Export all email module components
+export * from './controllers';
+export * from './services';
+export * from './entities';
+export * from './modules';
+export * from './config';
+export * from './dtos';
+export * from './enums';
+export * from './interfaces';
+export * from './providers';

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

@@ -0,0 +1,3 @@
+/**
+ * Mailgun provider configuration
+ */ export { };

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

@@ -0,0 +1,3 @@
+/**
+ * Async options for EmailModule registration
+ */ export { };

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

@@ -0,0 +1,5 @@
+/**
+ * Email provider configuration
+ */ /**
+ * Email provider interface - contract for all email providers
+ */ export { };

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

@@ -0,0 +1,3 @@
+/**
+ * Full email schema structure
+ */ export { };

package/fesm/interfaces/index.js

@@ -0,0 +1,4 @@
+export * from './email-provider.interface';
+export * from './email-module-options.interface';
+export * from './email-config.interface';
+export * from './email-template.interface';

package/fesm/modules/email.module.js

@@ -0,0 +1,167 @@
+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;
+}
+import { CacheModule, UtilsModule } from '@flusys/nestjs-shared/modules';
+import { Logger, Module } from '@nestjs/common';
+import { EmailConfigService } from '../config';
+import { EMAIL_MODULE_OPTIONS } from '../config/email.constants';
+import { EmailProviderTypeEnum } from '../enums';
+import { EmailFactoryService, EmailProviderRegistry, SmtpProvider, SendGridProvider, MailgunProvider } from '../providers';
+import { EmailDataSourceProvider, EmailProviderConfigService, EmailSendService, EmailTemplateService } from '../services';
+import { EmailConfigController, EmailSendController, EmailTemplateController } from '../controllers';
+// Auto-register built-in email providers
+const logger = new Logger('EmailModule');
+// Register all providers (they use dynamic imports internally)
+EmailProviderRegistry.register(EmailProviderTypeEnum.SMTP, SmtpProvider);
+logger.log('Registered SmtpProvider');
+EmailProviderRegistry.register(EmailProviderTypeEnum.SENDGRID, SendGridProvider);
+logger.log('Registered SendGridProvider');
+EmailProviderRegistry.register(EmailProviderTypeEnum.MAILGUN, MailgunProvider);
+logger.log('Registered MailgunProvider');
+export 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: [
+                CacheModule,
+                UtilsModule
+            ],
+            controllers: options.includeController !== false ? controllers : [],
+            providers,
+            exports: [
+                EmailConfigService,
+                EmailDataSourceProvider,
+                EmailProviderConfigService,
+                EmailTemplateService,
+                EmailSendService,
+                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 || [],
+                CacheModule,
+                UtilsModule
+            ],
+            controllers: options.includeController !== false ? controllers : [],
+            providers: [
+                ...asyncProviders,
+                ...this.getProviders(options, false)
+            ],
+            exports: [
+                EmailConfigService,
+                EmailDataSourceProvider,
+                EmailProviderConfigService,
+                EmailTemplateService,
+                EmailSendService,
+                EmailFactoryService
+            ]
+        };
+    }
+    // ==================== Private Helper Methods ====================
+    /**
+   * Get controllers
+   */ static getControllers(_options) {
+        return [
+            EmailConfigController,
+            EmailTemplateController,
+            EmailSendController
+        ];
+    }
+    /**
+   * Get providers
+   */ static getProviders(options, includeOptionsProvider = true) {
+        const providers = [
+            EmailConfigService,
+            EmailDataSourceProvider,
+            EmailProviderConfigService,
+            EmailTemplateService,
+            EmailSendService,
+            EmailFactoryService
+        ];
+        if (includeOptionsProvider) {
+            providers.unshift({
+                provide: EMAIL_MODULE_OPTIONS,
+                useValue: options
+            });
+        }
+        return providers;
+    }
+    /**
+   * Create async providers for forRootAsync
+   */ static createAsyncProviders(options) {
+        if (options.useFactory) {
+            return [
+                {
+                    provide: EMAIL_MODULE_OPTIONS,
+                    useFactory: async (...args)=>{
+                        const config = await options.useFactory(...args);
+                        return {
+                            ...options,
+                            config
+                        };
+                    },
+                    inject: options.inject || []
+                }
+            ];
+        }
+        if (options.useClass) {
+            return [
+                {
+                    provide: 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: EMAIL_MODULE_OPTIONS,
+                    useFactory: async (optionsFactory)=>{
+                        const config = await optionsFactory.createEmailOptions();
+                        return {
+                            ...options,
+                            config
+                        };
+                    },
+                    inject: [
+                        options.useExisting
+                    ]
+                }
+            ];
+        }
+        return [];
+    }
+}
+EmailModule = _ts_decorate([
+    Module({})
+], EmailModule);

package/fesm/modules/index.js

@@ -0,0 +1 @@
+export * from './email.module';