@venturialstd/email 0.0.1

package/README.md

@@ -0,0 +1,315 @@
+# @venturialstd/email
+
+Email Module with Multiple Transporter Support for Venturial Standard Backend.
+
+## Features
+
+- 📧 Multiple transporter support (SMTP, and extensible for others)
+- 🔧 Configuration via code or settings service
+- 🎨 **Handlebars template support** - Beautiful, dynamic email templates
+- 📊 **Database template management** - Store and manage templates in database
+- 📝 HTML and plain text emails
+- 🔄 Attachment support
+- 📊 **Email logging and tracking** - All sent emails are logged with status
+- 🚀 Built on top of @nestjs-modules/mailer
+
+## Quick Links
+
+- [Database Template Management](./DATABASE_TEMPLATES.md) - Store templates in database
+- [Handlebars Templates Guide](./HANDLEBARS_TEMPLATES.md) - Complete guide to using templates
+- [Email Logging Documentation](./EMAIL_LOGGING.md) - Email tracking and monitoring
+- [Usage Examples](./USAGE.md) - Comprehensive usage examples
+
+## Installation
+
+```bash
+npm install @venturialstd/email
+```
+
+## Usage
+
+### Import the Module
+
+```typescript
+import { EmailModule } from '@venturialstd/email';
+
+@Module({
+  imports: [
+    EmailModule,
+    // ... other modules
+  ],
+})
+export class AppModule {}
+```
+
+### Send Emails
+
+```typescript
+import { EmailService, EmailConfig } from '@venturialstd/email';
+
+@Injectable()
+export class MyService {
+  constructor(private readonly emailService: EmailService) {}
+
+  async sendWelcomeEmail() {
+    const config: EmailConfig = {
+      transporter: 'SMTP',
+      smtp: {
+        host: 'smtp.example.com',
+        port: 587,
+        secure: false,
+        auth: {
+          user: 'user@example.com',
+          pass: 'password',
+        },
+      },
+    };
+
+    await this.emailService.sendEmail(config, {
+      to: 'recipient@example.com',
+      subject: 'Welcome!',
+      html: '<h1>Welcome to our platform!</h1>',
+    });
+  }
+}
+```
+
+### Send Emails with Handlebars Templates
+
+The module includes pre-built Handlebars templates and helper methods:
+
+```typescript
+// Welcome email
+await emailService.sendWelcomeEmail(null, {
+  to: 'user@example.com',
+  name: 'John Doe',
+  message: 'Thank you for joining our platform!',
+  actionUrl: 'https://app.example.com/onboarding',
+});
+
+// Password reset email
+await emailService.sendPasswordResetEmail(null, {
+  to: 'user@example.com',
+  name: 'John Doe',
+  resetUrl: 'https://app.example.com/reset?token=abc123',
+  expirationTime: 30,
+});
+
+// Notification email
+await emailService.sendNotificationEmail(null, {
+  to: 'user@example.com',
+  name: 'John Doe',
+  title: 'Order Confirmation',
+  notificationTitle: 'Your order has been confirmed!',
+  message: 'Order #12345 is being processed.',
+});
+
+// Custom template
+await emailService.sendEmailWithTemplate(null, {
+  to: 'user@example.com',
+  subject: 'Custom Email',
+  template: 'my-custom-template',
+  context: {
+    customVariable: 'value',
+  },
+});
+```
+
+See [HANDLEBARS_TEMPLATES.md](./HANDLEBARS_TEMPLATES.md) for complete template documentation.
+
+### Configuration Options
+
+#### SMTP Configuration
+
+```typescript
+const config: EmailConfig = {
+  transporter: 'SMTP',
+  smtp: {
+    host: 'smtp.gmail.com',
+    port: 587,
+    secure: false, // true for 465, false for other ports
+    auth: {
+      user: 'your-email@gmail.com',
+      pass: 'your-password',
+    },
+  },
+  defaults: {
+    from: '"Your Name" <your-email@gmail.com>',
+  },
+};
+```
+
+### Using Settings Service
+
+If no config is provided, the module will attempt to load configuration from the Settings Service:
+
+- `EMAIL_TRANSPORTER` - Transport type (default: 'SMTP')
+- `EMAIL_SMTP_HOST` - SMTP server host
+- `EMAIL_SMTP_PORT` - SMTP server port
+- `EMAIL_SMTP_SECURE` - Use SSL/TLS (true/false)
+- `EMAIL_SMTP_USER` - SMTP authentication user
+- `EMAIL_SMTP_PASSWORD` - SMTP authentication password
+- `EMAIL_DEFAULT_FROM` - Default sender email address
+
+## API
+
+### EmailService
+
+#### `sendEmail(config, options)`
+
+Sends an email with the specified options. **All emails are automatically logged to the database.**
+
+**Parameters:**
+- `config: EmailConfig | null` - Email configuration (transporter settings)
+- `options: SendEmailOptions` - Email options (to, subject, html, etc.)
+
+**Returns:** `Promise<void>`
+
+#### `getEmailLogs(options?)`
+
+Retrieves email logs with optional filtering.
+
+**Parameters:**
+- `options?`: Optional filtering options
+  - `status?: EmailStatus` - Filter by status (PENDING, SENT, FAILED)
+  - `to?: string` - Filter by recipient email
+  - `from?: string` - Filter by sender email
+  - `startDate?: Date` - Filter from this date
+  - `endDate?: Date` - Filter until this date
+  - `limit?: number` - Limit number of results
+
+**Returns:** `Promise<EmailLog[]>`
+
+**Example:**
+```typescript
+// Get all failed emails
+const failedEmails = await emailService.getEmailLogs({
+  status: EmailStatus.FAILED,
+  limit: 10,
+});
+
+// Get emails sent to specific recipient
+const userEmails = await emailService.getEmailLogs({
+  to: 'user@example.com',
+});
+```
+
+#### `getEmailLogById(id)`
+
+Gets a single email log by ID.
+
+**Parameters:**
+- `id: string` - Email log ID
+
+**Returns:** `Promise<EmailLog | null>`
+
+#### `getEmailLogStats(startDate?, endDate?)`
+
+Gets email statistics for a date range.
+
+**Parameters:**
+- `startDate?: Date` - Start date for statistics
+- `endDate?: Date` - End date for statistics
+
+**Returns:** `Promise<{ total: number; sent: number; failed: number; pending: number }>`
+
+**Example:**
+```typescript
+const stats = await emailService.getEmailLogStats(
+  new Date('2024-01-01'),
+  new Date('2024-01-31')
+);
+console.log(`Total emails: ${stats.total}, Sent: ${stats.sent}, Failed: ${stats.failed}`);
+```
+
+## Email Logging
+
+All emails sent through the service are automatically logged to the `email_log` table with the following information:
+
+- **Recipient(s)**: to, cc, bcc
+- **Sender**: from address
+- **Content**: subject, text, html
+- **Status**: PENDING, SENT, or FAILED
+- **Metadata**: Additional information like template name, config source
+- **Timestamps**: Created, updated, and sent timestamps
+- **Error tracking**: Error messages for failed emails
+
+### Email Log Entity
+
+```typescript
+export enum EmailStatus {
+  PENDING = 'PENDING',
+  SENT = 'SENT',
+  FAILED = 'FAILED',
+}
+
+export interface EmailLog {
+  id: string;
+  to: string;
+  from?: string;
+  cc?: string;
+  bcc?: string;
+  subject: string;
+  textContent?: string;
+  htmlContent?: string;
+  transporter: string;
+  status: EmailStatus;
+  errorMessage?: string;
+  metadata?: Record<string, any>;
+  hasAttachments: boolean;
+  sentAt?: Date;
+  createdAt: Date;
+  updatedAt: Date;
+}
+```
+
+## Types
+
+### EmailConfig
+
+```typescript
+interface EmailConfig {
+  transporter: 'SMTP';
+  smtp?: SMTPConfig;
+  defaults?: {
+    from?: string;
+  };
+}
+```
+
+### SMTPConfig
+
+```typescript
+interface SMTPConfig {
+  host: string;
+  port: number;
+  secure: boolean;
+  auth: {
+    user: string;
+    pass: string;
+  };
+}
+```
+
+### SendEmailOptions
+
+```typescript
+interface SendEmailOptions {
+  to: string | string[];
+  subject: string;
+  text?: string;
+  html?: string;
+  from?: string;
+  cc?: string | string[];
+  bcc?: string | string[];
+  attachments?: Array<{
+    filename: string;
+    content?: string | Buffer;
+    path?: string;
+  }>;
+}
+```
+
+## License
+
+Proprietary - Venturial Standard

package/data/README.md

@@ -0,0 +1,102 @@
+# Email Templates Data
+
+This folder contains the default email templates in JSON format that are seeded into the database during setup.
+
+## File Structure
+
+### `default-templates.json`
+
+Contains an array of email template objects with the following structure:
+
+```json
+{
+  "name": "template-name",           // Unique identifier (lowercase, hyphenated)
+  "type": "HANDLEBARS",              // Template type: HANDLEBARS, HTML, or TEXT
+  "subject": "Email Subject {{var}}", // Subject line (supports Handlebars variables)
+  "description": "Template description", // Human-readable description
+  "variables": ["var1", "var2"],     // Array of variable names used in template
+  "defaultValues": {                 // Default values for variables
+    "var1": "default value"
+  },
+  "htmlContent": "HTML content...",  // Full HTML email content
+  "textContent": "Text content..."   // Optional plain text version (optional)
+}
+```
+
+## Template Types
+
+- **HANDLEBARS**: Template uses Handlebars syntax for variable interpolation and logic
+- **HTML**: Plain HTML template without variable processing
+- **TEXT**: Plain text template without HTML
+
+## Default Templates
+
+The following templates are included by default:
+
+1. **welcome** - Welcome email for new users
+2. **password-reset** - Password reset request with URL or code
+3. **notification** - General notification email
+
+## Adding New Templates
+
+To add new default templates:
+
+1. Add a new template object to the `default-templates.json` array
+2. Ensure all required fields are included
+3. Test the template by running `npm run db:setup` in the test folder
+4. The template will be automatically seeded into the database
+
+## Variable Interpolation
+
+Templates support Handlebars syntax:
+
+- Simple variables: `{{variableName}}`
+- Conditional blocks: `{{#if variable}}...{{/if}}`
+- Loops: `{{#each items}}{{name}}{{/each}}`
+- Nested properties: `{{user.name}}`
+
+## Best Practices
+
+1. **Keep HTML inline-styled** - Email clients don't support external CSS well
+2. **Provide default values** - Include sensible defaults for optional variables
+3. **List all variables** - Document all variables used in the `variables` array
+4. **Test across clients** - Email rendering varies significantly across clients
+5. **Include text version** - Always provide a `textContent` fallback for accessibility
+
+## Usage in Code
+
+Templates are automatically loaded from this file during database setup:
+
+```typescript
+// test/db-setup.ts
+const defaultTemplates = JSON.parse(
+  readFileSync(join(__dirname, '..', 'data', 'default-templates.json'), 'utf-8')
+);
+```
+
+For production use, templates are managed through the `EmailTemplateService`:
+
+```typescript
+// Create a new template
+await emailTemplateService.createTemplate({
+  name: 'my-template',
+  subject: 'Hello {{name}}',
+  htmlContent: '<h1>Hello {{name}}!</h1>',
+  type: TemplateType.HANDLEBARS,
+  variables: ['name'],
+});
+
+// Send email using template
+await emailService.sendEmailWithTemplate(null, {
+  to: 'user@example.com',
+  template: 'my-template',
+  context: { name: 'John' },
+});
+```
+
+## Notes
+
+- Templates are seeded only during `npm run db:setup`
+- Existing templates in the database are not overwritten
+- Template modifications should be done through the API or database directly
+- This file is for initial seeding only

package/data/default-templates.json

@@ -0,0 +1,34 @@
+[
+  {
+    "name": "welcome",
+    "type": "HANDLEBARS",
+    "subject": "Welcome to {{companyName}}!",
+    "description": "Welcome email for new users",
+    "variables": ["name", "message", "companyName", "actionUrl", "actionText"],
+    "defaultValues": {
+      "companyName": "Your Company",
+      "actionText": "Get Started"
+    },
+    "htmlContent": "<!DOCTYPE html>\n<html>\n<head>\n  <meta charset=\"utf-8\">\n  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n  <title>{{subject}}</title>\n  <style>\n    body {\n      font-family: Arial, sans-serif;\n      line-height: 1.6;\n      color: #333;\n      max-width: 600px;\n      margin: 0 auto;\n      padding: 20px;\n    }\n    .header {\n      background-color: #4CAF50;\n      color: white;\n      padding: 20px;\n      text-align: center;\n      border-radius: 5px 5px 0 0;\n    }\n    .content {\n      background-color: #f9f9f9;\n      padding: 30px;\n      border-radius: 0 0 5px 5px;\n    }\n    .button {\n      display: inline-block;\n      padding: 12px 24px;\n      background-color: #4CAF50;\n      color: white;\n      text-decoration: none;\n      border-radius: 4px;\n      margin: 20px 0;\n    }\n    .footer {\n      text-align: center;\n      margin-top: 30px;\n      padding-top: 20px;\n      border-top: 1px solid #ddd;\n      color: #666;\n      font-size: 12px;\n    }\n  </style>\n</head>\n<body>\n  <div class=\"header\">\n    <h1>Welcome!</h1>\n  </div>\n  <div class=\"content\">\n    <h2>Hello {{name}}!</h2>\n    <p>Welcome to our platform. We're excited to have you on board.</p>\n    <p>{{message}}</p>\n    {{#if actionUrl}}\n    <p style=\"text-align: center;\">\n      <a href=\"{{actionUrl}}\" class=\"button\">{{actionText}}</a>\n    </p>\n    {{/if}}\n  </div>\n  <div class=\"footer\">\n    <p>&copy; {{year}} {{companyName}}. All rights reserved.</p>\n  </div>\n</body>\n</html>"
+  },
+  {
+    "name": "password-reset",
+    "type": "HANDLEBARS",
+    "subject": "Password Reset Request",
+    "description": "Password reset email with URL or code",
+    "variables": ["name", "resetUrl", "resetCode", "expirationTime"],
+    "defaultValues": {
+      "expirationTime": 60
+    },
+    "htmlContent": "<!DOCTYPE html>\n<html>\n<head>\n  <meta charset=\"utf-8\">\n  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n  <title>{{subject}}</title>\n  <style>\n    body {\n      font-family: Arial, sans-serif;\n      line-height: 1.6;\n      color: #333;\n      max-width: 600px;\n      margin: 0 auto;\n      padding: 20px;\n    }\n    .header {\n      background-color: #ff9800;\n      color: white;\n      padding: 20px;\n      text-align: center;\n      border-radius: 5px 5px 0 0;\n    }\n    .content {\n      background-color: #f9f9f9;\n      padding: 30px;\n      border-radius: 0 0 5px 5px;\n    }\n    .button {\n      display: inline-block;\n      padding: 12px 24px;\n      background-color: #ff9800;\n      color: white;\n      text-decoration: none;\n      border-radius: 4px;\n      margin: 20px 0;\n    }\n    .code {\n      background-color: #f0f0f0;\n      padding: 15px;\n      text-align: center;\n      font-size: 24px;\n      font-weight: bold;\n      letter-spacing: 5px;\n      border-radius: 4px;\n      margin: 20px 0;\n    }\n    .footer {\n      text-align: center;\n      margin-top: 30px;\n      padding-top: 20px;\n      border-top: 1px solid #ddd;\n      color: #666;\n      font-size: 12px;\n    }\n  </style>\n</head>\n<body>\n  <div class=\"header\">\n    <h1>Password Reset Request</h1>\n  </div>\n  <div class=\"content\">\n    <h2>Hello {{name}}!</h2>\n    <p>We received a request to reset your password. If you didn't make this request, you can safely ignore this email.</p>\n    {{#if resetCode}}\n    <p>Your password reset code is:</p>\n    <div class=\"code\">{{resetCode}}</div>\n    <p>This code will expire in {{expirationTime}} minutes.</p>\n    {{else}}\n    <p>Click the button below to reset your password:</p>\n    <p style=\"text-align: center;\">\n      <a href=\"{{resetUrl}}\" class=\"button\">Reset Password</a>\n    </p>\n    <p>This link will expire in {{expirationTime}} minutes.</p>\n    <p style=\"font-size: 12px; color: #666;\">If the button doesn't work, copy and paste this link into your browser:<br>{{resetUrl}}</p>\n    {{/if}}\n  </div>\n  <div class=\"footer\">\n    <p>&copy; {{year}} Your Company. All rights reserved.</p>\n    <p>If you didn't request this password reset, please contact support immediately.</p>\n  </div>\n</body>\n</html>"
+  },
+  {
+    "name": "notification",
+    "type": "HANDLEBARS",
+    "subject": "{{title}}",
+    "description": "General notification email",
+    "variables": ["name", "title", "notificationTitle", "message", "details"],
+    "defaultValues": {},
+    "htmlContent": "<!DOCTYPE html>\n<html>\n<head>\n  <meta charset=\"utf-8\">\n  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n  <title>{{subject}}</title>\n  <style>\n    body {\n      font-family: Arial, sans-serif;\n      line-height: 1.6;\n      color: #333;\n      max-width: 600px;\n      margin: 0 auto;\n      padding: 20px;\n    }\n    .header {\n      background-color: #2196F3;\n      color: white;\n      padding: 20px;\n      text-align: center;\n      border-radius: 5px 5px 0 0;\n    }\n    .content {\n      background-color: #f9f9f9;\n      padding: 30px;\n      border-radius: 0 0 5px 5px;\n    }\n    .notification-box {\n      background-color: white;\n      border-left: 4px solid #2196F3;\n      padding: 15px;\n      margin: 20px 0;\n    }\n    .footer {\n      text-align: center;\n      margin-top: 30px;\n      padding-top: 20px;\n      border-top: 1px solid #ddd;\n      color: #666;\n      font-size: 12px;\n    }\n  </style>\n</head>\n<body>\n  <div class=\"header\">\n    <h1>{{title}}</h1>\n  </div>\n  <div class=\"content\">\n    <h2>Hello {{name}}!</h2>\n    <div class=\"notification-box\">\n      <p><strong>{{notificationTitle}}</strong></p>\n      <p>{{message}}</p>\n    </div>\n    {{#if details}}\n    <h3>Details:</h3>\n    <ul>\n      {{#each details}}\n      <li><strong>{{@key}}:</strong> {{this}}</li>\n      {{/each}}\n    </ul>\n    {{/if}}\n  </div>\n  <div class=\"footer\">\n    <p>&copy; {{year}} Your Company. All rights reserved.</p>\n  </div>\n</body>\n</html>"
+  }
+]

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

@@ -0,0 +1,9 @@
+export declare enum EMAIL_TRANSPORTER {
+    SMTP = "SMTP"
+}
+export declare const EMAIL_DEFAULT_CONFIG: {
+    TRANSPORTER: EMAIL_TRANSPORTER;
+    SMTP_PORT: number;
+    SMTP_SECURE: boolean;
+};
+//# sourceMappingURL=email.constant.d.ts.map

package/dist/constants/email.constant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.constant.d.ts","sourceRoot":"","sources":["../../src/constants/email.constant.ts"],"names":[],"mappings":"AAGA,oBAAY,iBAAiB;IAC3B,IAAI,SAAS;CACd;AAKD,eAAO,MAAM,oBAAoB;;;;CAIhC,CAAC"}

package/dist/constants/email.constant.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMAIL_DEFAULT_CONFIG = exports.EMAIL_TRANSPORTER = void 0;
+var EMAIL_TRANSPORTER;
+(function (EMAIL_TRANSPORTER) {
+    EMAIL_TRANSPORTER["SMTP"] = "SMTP";
+})(EMAIL_TRANSPORTER || (exports.EMAIL_TRANSPORTER = EMAIL_TRANSPORTER = {}));
+exports.EMAIL_DEFAULT_CONFIG = {
+    TRANSPORTER: EMAIL_TRANSPORTER.SMTP,
+    SMTP_PORT: 587,
+    SMTP_SECURE: false,
+};
+//# sourceMappingURL=email.constant.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"email.constant.js","sourceRoot":"","sources":["../../src/constants/email.constant.ts"],"names":[],"mappings":";;;AAGA,IAAY,iBAEX;AAFD,WAAY,iBAAiB;IAC3B,kCAAa,CAAA;AACf,CAAC,EAFW,iBAAiB,iCAAjB,iBAAiB,QAE5B;AAKY,QAAA,oBAAoB,GAAG;IAClC,WAAW,EAAE,iBAAiB,CAAC,IAAI;IACnC,SAAS,EAAE,GAAG;IACd,WAAW,EAAE,KAAK;CACnB,CAAC"}

package/dist/constants/email.settings.constant.d.ts

@@ -0,0 +1,10 @@
+export declare const EMAIL_SETTING_KEYS: {
+    readonly GENERAL_TRANSPORTER: "GLOBAL:EMAIL:GENERAL:TRANSPORTER";
+    readonly GENERAL_DEFAULT_FROM: "GLOBAL:EMAIL:GENERAL:DEFAULT_FROM";
+    readonly SMTP_HOST: "GLOBAL:EMAIL:SMTP:HOST";
+    readonly SMTP_PORT: "GLOBAL:EMAIL:SMTP:PORT";
+    readonly SMTP_SECURE: "GLOBAL:EMAIL:SMTP:SECURE";
+    readonly SMTP_USER: "GLOBAL:EMAIL:SMTP:USER";
+    readonly SMTP_PASSWORD: "GLOBAL:EMAIL:SMTP:PASSWORD";
+};
+//# sourceMappingURL=email.settings.constant.d.ts.map

package/dist/constants/email.settings.constant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.settings.constant.d.ts","sourceRoot":"","sources":["../../src/constants/email.settings.constant.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,kBAAkB;;;;;;;;CAUrB,CAAC"}

package/dist/constants/email.settings.constant.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMAIL_SETTING_KEYS = void 0;
+exports.EMAIL_SETTING_KEYS = {
+    GENERAL_TRANSPORTER: 'GLOBAL:EMAIL:GENERAL:TRANSPORTER',
+    GENERAL_DEFAULT_FROM: 'GLOBAL:EMAIL:GENERAL:DEFAULT_FROM',
+    SMTP_HOST: 'GLOBAL:EMAIL:SMTP:HOST',
+    SMTP_PORT: 'GLOBAL:EMAIL:SMTP:PORT',
+    SMTP_SECURE: 'GLOBAL:EMAIL:SMTP:SECURE',
+    SMTP_USER: 'GLOBAL:EMAIL:SMTP:USER',
+    SMTP_PASSWORD: 'GLOBAL:EMAIL:SMTP:PASSWORD',
+};
+//# sourceMappingURL=email.settings.constant.js.map

package/dist/constants/email.settings.constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.settings.constant.js","sourceRoot":"","sources":["../../src/constants/email.settings.constant.ts"],"names":[],"mappings":";;;AAGa,QAAA,kBAAkB,GAAG;IAChC,mBAAmB,EAAE,kCAAkC;IACvD,oBAAoB,EAAE,mCAAmC;IAGzD,SAAS,EAAE,wBAAwB;IACnC,SAAS,EAAE,wBAAwB;IACnC,WAAW,EAAE,0BAA0B;IACvC,SAAS,EAAE,wBAAwB;IACnC,aAAa,EAAE,4BAA4B;CACnC,CAAC"}

package/dist/constants/index.d.ts

@@ -0,0 +1,3 @@
+export * from './email.constant';
+export * from './email.settings.constant';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC"}

package/dist/constants/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("./email.constant"), exports);
+__exportStar(require("./email.settings.constant"), exports);
+//# sourceMappingURL=index.js.map

package/dist/constants/index.js.map

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

package/dist/email.module.d.ts

@@ -0,0 +1,3 @@
+export declare class EmailModule {
+}
+//# sourceMappingURL=email.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"email.module.d.ts","sourceRoot":"","sources":["../src/email.module.ts"],"names":[],"mappings":"AASA,qBA+Da,WAAW;CAAG"}

package/dist/email.module.js

@@ -0,0 +1,75 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailModule = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const typeorm_1 = require("@nestjs/typeorm");
+const mailer_1 = require("@nestjs-modules/mailer");
+const core_1 = require("@venturialstd/core");
+const entities_1 = require("./entities");
+const services_1 = require("./services");
+let EmailModule = class EmailModule {
+};
+exports.EmailModule = EmailModule;
+exports.EmailModule = EmailModule = __decorate([
+    (0, common_1.Module)({
+        imports: [
+            core_1.SharedModule.forRoot({}),
+            core_1.SettingsModule,
+            typeorm_1.TypeOrmModule.forFeature([entities_1.EmailLog, entities_1.EmailTemplate]),
+            mailer_1.MailerModule.forRootAsync({
+                imports: [config_1.ConfigModule],
+                inject: [config_1.ConfigService],
+                useFactory: (configService) => {
+                    const port = Number(configService.get('SMTP_PORT', 587));
+                    const secure = configService.get('SMTP_SECURE', 'false') === 'true';
+                    const transportConfig = {
+                        host: configService.get('SMTP_HOST', 'localhost'),
+                        port,
+                        secure,
+                        auth: {
+                            user: configService.get('SMTP_USER'),
+                            pass: configService.get('SMTP_PASSWORD'),
+                        },
+                        requireTLS: undefined,
+                        tls: undefined,
+                    };
+                    if (port === 587 && !secure) {
+                        transportConfig.requireTLS = true;
+                        transportConfig.tls = {
+                            rejectUnauthorized: false,
+                            minVersion: 'TLSv1.2',
+                        };
+                    }
+                    else if (port === 465 && secure) {
+                        transportConfig.tls = {
+                            rejectUnauthorized: false,
+                            minVersion: 'TLSv1.2',
+                        };
+                    }
+                    else {
+                        transportConfig.tls = {
+                            rejectUnauthorized: false,
+                        };
+                    }
+                    return {
+                        transport: transportConfig,
+                        defaults: {
+                            from: configService.get('EMAIL_DEFAULT_FROM', '"No Reply" <noreply@example.com>'),
+                        },
+                    };
+                },
+            }),
+        ],
+        controllers: [],
+        providers: [services_1.EmailService, services_1.EmailLogService, services_1.EmailTemplateService],
+        exports: [services_1.EmailService, services_1.EmailLogService, services_1.EmailTemplateService],
+    })
+], EmailModule);
+//# sourceMappingURL=email.module.js.map

package/dist/email.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.module.js","sourceRoot":"","sources":["../src/email.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,2CAA6D;AAC7D,6CAAgD;AAChD,mDAAsD;AACtD,6CAAkE;AAElE,yCAAqD;AACrD,yCAAiF;AAiE1E,IAAM,WAAW,GAAjB,MAAM,WAAW;CAAG,CAAA;AAAd,kCAAW;sBAAX,WAAW;IA/DvB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,mBAAY,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,qBAAc;YACd,uBAAa,CAAC,UAAU,CAAC,CAAC,mBAAQ,EAAE,wBAAa,CAAC,CAAC;YACnD,qBAAY,CAAC,YAAY,CAAC;gBACxB,OAAO,EAAE,CAAC,qBAAY,CAAC;gBACvB,MAAM,EAAE,CAAC,sBAAa,CAAC;gBACvB,UAAU,EAAE,CAAC,aAA4B,EAAE,EAAE;oBAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC;oBACzD,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;oBAEpE,MAAM,eAAe,GAAG;wBACtB,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,WAAW,EAAE,WAAW,CAAC;wBACjD,IAAI;wBACJ,MAAM;wBACN,IAAI,EAAE;4BACJ,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC;4BACpC,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,eAAe,CAAC;yBACzC;wBACD,UAAU,EAAE,SAAgC;wBAC5C,GAAG,EAAE,SAKQ;qBACd,CAAC;oBAGF,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;wBAE5B,eAAe,CAAC,UAAU,GAAG,IAAI,CAAC;wBAClC,eAAe,CAAC,GAAG,GAAG;4BACpB,kBAAkB,EAAE,KAAK;4BACzB,UAAU,EAAE,SAAkB;yBAC/B,CAAC;oBACJ,CAAC;yBAAM,IAAI,IAAI,KAAK,GAAG,IAAI,MAAM,EAAE,CAAC;wBAElC,eAAe,CAAC,GAAG,GAAG;4BACpB,kBAAkB,EAAE,KAAK;4BACzB,UAAU,EAAE,SAAkB;yBAC/B,CAAC;oBACJ,CAAC;yBAAM,CAAC;wBAEN,eAAe,CAAC,GAAG,GAAG;4BACpB,kBAAkB,EAAE,KAAK;yBAC1B,CAAC;oBACJ,CAAC;oBAED,OAAO;wBACL,SAAS,EAAE,eAAe;wBAC1B,QAAQ,EAAE;4BACR,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,oBAAoB,EAAE,kCAAkC,CAAC;yBAClF;qBACF,CAAC;gBACJ,CAAC;aACF,CAAC;SACH;QACD,WAAW,EAAE,EAAE;QACf,SAAS,EAAE,CAAC,uBAAY,EAAE,0BAAe,EAAE,+BAAoB,CAAC;QAChE,OAAO,EAAE,CAAC,uBAAY,EAAE,0BAAe,EAAE,+BAAoB,CAAC;KAC/D,CAAC;GACW,WAAW,CAAG"}

package/dist/entities/email-log.entity.d.ts

@@ -0,0 +1,24 @@
+export declare enum EmailStatus {
+    PENDING = "PENDING",
+    SENT = "SENT",
+    FAILED = "FAILED"
+}
+export declare class EmailLog {
+    id: string;
+    to: string;
+    from: string | null;
+    cc: string | null;
+    bcc: string | null;
+    subject: string;
+    textContent: string | null;
+    htmlContent: string | null;
+    transporter: string;
+    status: EmailStatus;
+    errorMessage: string | null;
+    metadata: Record<string, unknown> | null;
+    hasAttachments: boolean;
+    sentAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=email-log.entity.d.ts.map