@flusys/nestjs-email 1.1.0-beta → 2.0.0

package/fesm/dtos/email-send.dto.js

@@ -21,11 +21,48 @@ function _ts_metadata(k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { IsArray, IsEmail, IsNotEmpty, IsObject, IsOptional, IsString, IsUUID, registerDecorator, ValidateNested } from 'class-validator';
+import { IsArray, IsEmail, IsNotEmpty, IsObject, IsOptional, IsString, IsUUID, registerDecorator, ValidateNested, ValidatorConstraint } from 'class-validator';
 import { Type } from 'class-transformer';
-/**
- * Custom validator: Requires at least one of templateId or templateSlug
- */ function RequireTemplateIdOrSlug(validationOptions) {
+export class IsEmailOrEmailArrayConstraint {
+    validate(value) {
+        if (typeof value === 'string') {
+            return this.emailRegex.test(value);
+        }
+        if (Array.isArray(value)) {
+            return value.length > 0 && value.every((email)=>typeof email === 'string' && this.emailRegex.test(email));
+        }
+        return false;
+    }
+    defaultMessage(args) {
+        const value = args.value;
+        if (Array.isArray(value)) {
+            const invalidEmails = value.filter((v)=>typeof v !== 'string' || !this.emailRegex.test(v));
+            return `Invalid email(s) in array: ${invalidEmails.join(', ')}`;
+        }
+        return `${args.property} must be a valid email address or array of email addresses`;
+    }
+    constructor(){
+        _define_property(this, "emailRegex", /^[^\s@]+@[^\s@]+\.[^\s@]+$/);
+    }
+}
+IsEmailOrEmailArrayConstraint = _ts_decorate([
+    ValidatorConstraint({
+        name: 'isEmailOrEmailArray',
+        async: false
+    })
+], IsEmailOrEmailArrayConstraint);
+function IsEmailOrEmailArray(validationOptions) {
+    return function(object, propertyName) {
+        registerDecorator({
+            name: 'isEmailOrEmailArray',
+            target: object.constructor,
+            propertyName,
+            options: validationOptions,
+            validator: IsEmailOrEmailArrayConstraint
+        });
+    };
+}
+function RequireTemplateIdOrSlug(validationOptions) {
     return function(object, propertyName) {
         registerDecorator({
             name: 'requireTemplateIdOrSlug',
@@ -44,9 +81,7 @@ import { Type } from 'class-transformer';
         });
     };
 }
-/**
- * Email attachment DTO
- */ export class EmailAttachmentDto {
+export class EmailAttachmentDto {
     constructor(){
         _define_property(this, "filename", void 0);
         _define_property(this, "content", void 0);
@@ -77,69 +112,54 @@ _ts_decorate([
     IsOptional(),
     _ts_metadata("design:type", String)
 ], EmailAttachmentDto.prototype, "contentType", void 0);
-/**
- * DTO for sending email directly
- */ export class SendEmailDto {
+/** Base class for common email fields (recipients, sender, attachments) */ let BaseEmailDto = class BaseEmailDto {
     constructor(){
         _define_property(this, "to", void 0);
         _define_property(this, "cc", void 0);
         _define_property(this, "bcc", void 0);
-        _define_property(this, "subject", void 0);
-        _define_property(this, "html", void 0);
-        _define_property(this, "text", void 0);
         _define_property(this, "from", void 0);
         _define_property(this, "fromName", void 0);
         _define_property(this, "replyTo", void 0);
         _define_property(this, "emailConfigId", void 0);
         _define_property(this, "attachments", void 0);
     }
-}
+};
 _ts_decorate([
     ApiProperty({
         example: 'user@example.com',
-        description: 'Recipient email(s)'
+        description: 'Recipient email(s) - single email or array of emails',
+        oneOf: [
+            {
+                type: 'string'
+            },
+            {
+                type: 'array',
+                items: {
+                    type: 'string'
+                }
+            }
+        ]
     }),
     IsNotEmpty(),
+    IsEmailOrEmailArray(),
     _ts_metadata("design:type", Object)
-], SendEmailDto.prototype, "to", void 0);
+], BaseEmailDto.prototype, "to", void 0);
 _ts_decorate([
     ApiPropertyOptional({
-        description: 'CC recipients'
+        description: 'CC recipients - single email or array'
     }),
     IsOptional(),
+    IsEmailOrEmailArray(),
     _ts_metadata("design:type", Object)
-], SendEmailDto.prototype, "cc", void 0);
+], BaseEmailDto.prototype, "cc", void 0);
 _ts_decorate([
     ApiPropertyOptional({
-        description: 'BCC recipients'
+        description: 'BCC recipients - single email or array'
     }),
     IsOptional(),
+    IsEmailOrEmailArray(),
     _ts_metadata("design:type", Object)
-], SendEmailDto.prototype, "bcc", void 0);
-_ts_decorate([
-    ApiProperty({
-        example: 'Welcome to our platform!'
-    }),
-    IsString(),
-    IsNotEmpty(),
-    _ts_metadata("design:type", String)
-], SendEmailDto.prototype, "subject", void 0);
-_ts_decorate([
-    ApiProperty({
-        example: '<h1>Hello!</h1><p>Welcome to our platform.</p>'
-    }),
-    IsString(),
-    IsNotEmpty(),
-    _ts_metadata("design:type", String)
-], SendEmailDto.prototype, "html", void 0);
-_ts_decorate([
-    ApiPropertyOptional({
-        example: 'Hello! Welcome to our platform.'
-    }),
-    IsString(),
-    IsOptional(),
-    _ts_metadata("design:type", String)
-], SendEmailDto.prototype, "text", void 0);
+], BaseEmailDto.prototype, "bcc", void 0);
 _ts_decorate([
     ApiPropertyOptional({
         example: 'sender@example.com'
@@ -147,7 +167,7 @@ _ts_decorate([
     IsEmail(),
     IsOptional(),
     _ts_metadata("design:type", String)
-], SendEmailDto.prototype, "from", void 0);
+], BaseEmailDto.prototype, "from", void 0);
 _ts_decorate([
     ApiPropertyOptional({
         example: 'FLUSYS'
@@ -155,7 +175,7 @@ _ts_decorate([
     IsString(),
     IsOptional(),
     _ts_metadata("design:type", String)
-], SendEmailDto.prototype, "fromName", void 0);
+], BaseEmailDto.prototype, "fromName", void 0);
 _ts_decorate([
     ApiPropertyOptional({
         example: 'reply@example.com'
@@ -163,7 +183,7 @@ _ts_decorate([
     IsEmail(),
     IsOptional(),
     _ts_metadata("design:type", String)
-], SendEmailDto.prototype, "replyTo", void 0);
+], BaseEmailDto.prototype, "replyTo", void 0);
 _ts_decorate([
     ApiPropertyOptional({
         description: 'Email configuration ID to use'
@@ -171,7 +191,7 @@ _ts_decorate([
     IsUUID(),
     IsOptional(),
     _ts_metadata("design:type", String)
-], SendEmailDto.prototype, "emailConfigId", void 0);
+], BaseEmailDto.prototype, "emailConfigId", void 0);
 _ts_decorate([
     ApiPropertyOptional({
         type: [
@@ -185,23 +205,39 @@ _ts_decorate([
     Type(()=>EmailAttachmentDto),
     IsOptional(),
     _ts_metadata("design:type", Array)
-], SendEmailDto.prototype, "attachments", void 0);
-/**
- * DTO for sending email using template
- * Requires either templateId or templateSlug (at least one must be provided)
- */ export class SendTemplateEmailDto {
-    constructor(){
-        _define_property(this, "templateId", void 0);
-        _define_property(this, "templateSlug", void 0);
-        _define_property(this, "to", void 0);
-        _define_property(this, "cc", void 0);
-        _define_property(this, "bcc", void 0);
-        _define_property(this, "variables", void 0);
-        _define_property(this, "from", void 0);
-        _define_property(this, "fromName", void 0);
-        _define_property(this, "replyTo", void 0);
-        _define_property(this, "emailConfigId", void 0);
-        _define_property(this, "attachments", void 0);
+], BaseEmailDto.prototype, "attachments", void 0);
+export class SendEmailDto extends BaseEmailDto {
+    constructor(...args){
+        super(...args), _define_property(this, "subject", void 0), _define_property(this, "html", void 0), _define_property(this, "text", void 0);
+    }
+}
+_ts_decorate([
+    ApiProperty({
+        example: 'Welcome to our platform!'
+    }),
+    IsString(),
+    IsNotEmpty(),
+    _ts_metadata("design:type", String)
+], SendEmailDto.prototype, "subject", void 0);
+_ts_decorate([
+    ApiProperty({
+        example: '<h1>Hello!</h1><p>Welcome to our platform.</p>'
+    }),
+    IsString(),
+    IsNotEmpty(),
+    _ts_metadata("design:type", String)
+], SendEmailDto.prototype, "html", void 0);
+_ts_decorate([
+    ApiPropertyOptional({
+        example: 'Hello! Welcome to our platform.'
+    }),
+    IsString(),
+    IsOptional(),
+    _ts_metadata("design:type", String)
+], SendEmailDto.prototype, "text", void 0);
+export class SendTemplateEmailDto extends BaseEmailDto {
+    constructor(...args){
+        super(...args), _define_property(this, "templateId", void 0), _define_property(this, "templateSlug", void 0), _define_property(this, "variables", void 0);
     }
 }
 _ts_decorate([
@@ -224,28 +260,6 @@ _ts_decorate([
     IsOptional(),
     _ts_metadata("design:type", String)
 ], SendTemplateEmailDto.prototype, "templateSlug", void 0);
-_ts_decorate([
-    ApiProperty({
-        example: 'user@example.com',
-        description: 'Recipient email(s)'
-    }),
-    IsNotEmpty(),
-    _ts_metadata("design:type", Object)
-], SendTemplateEmailDto.prototype, "to", void 0);
-_ts_decorate([
-    ApiPropertyOptional({
-        description: 'CC recipients'
-    }),
-    IsOptional(),
-    _ts_metadata("design:type", Object)
-], SendTemplateEmailDto.prototype, "cc", void 0);
-_ts_decorate([
-    ApiPropertyOptional({
-        description: 'BCC recipients'
-    }),
-    IsOptional(),
-    _ts_metadata("design:type", Object)
-], SendTemplateEmailDto.prototype, "bcc", void 0);
 _ts_decorate([
     ApiPropertyOptional({
         type: 'object',
@@ -260,55 +274,7 @@ _ts_decorate([
     IsOptional(),
     _ts_metadata("design:type", typeof Record === "undefined" ? Object : Record)
 ], SendTemplateEmailDto.prototype, "variables", void 0);
-_ts_decorate([
-    ApiPropertyOptional({
-        example: 'sender@example.com'
-    }),
-    IsEmail(),
-    IsOptional(),
-    _ts_metadata("design:type", String)
-], SendTemplateEmailDto.prototype, "from", void 0);
-_ts_decorate([
-    ApiPropertyOptional({
-        example: 'FLUSYS'
-    }),
-    IsString(),
-    IsOptional(),
-    _ts_metadata("design:type", String)
-], SendTemplateEmailDto.prototype, "fromName", void 0);
-_ts_decorate([
-    ApiPropertyOptional({
-        example: 'reply@example.com'
-    }),
-    IsEmail(),
-    IsOptional(),
-    _ts_metadata("design:type", String)
-], SendTemplateEmailDto.prototype, "replyTo", void 0);
-_ts_decorate([
-    ApiPropertyOptional({
-        description: 'Email configuration ID to use'
-    }),
-    IsUUID(),
-    IsOptional(),
-    _ts_metadata("design:type", String)
-], SendTemplateEmailDto.prototype, "emailConfigId", void 0);
-_ts_decorate([
-    ApiPropertyOptional({
-        type: [
-            EmailAttachmentDto
-        ]
-    }),
-    IsArray(),
-    ValidateNested({
-        each: true
-    }),
-    Type(()=>EmailAttachmentDto),
-    IsOptional(),
-    _ts_metadata("design:type", Array)
-], SendTemplateEmailDto.prototype, "attachments", void 0);
-/**
- * DTO for test email
- */ export class TestEmailDto {
+export class TestEmailDto {
     constructor(){
         _define_property(this, "emailConfigId", void 0);
         _define_property(this, "recipient", void 0);
@@ -331,9 +297,7 @@ _ts_decorate([
     IsNotEmpty(),
     _ts_metadata("design:type", String)
 ], TestEmailDto.prototype, "recipient", void 0);
-/**
- * Response DTO for email send result
- */ export class EmailSendResultDto {
+export class EmailSendResultDto {
     constructor(){
         _define_property(this, "success", void 0);
         _define_property(this, "messageId", void 0);

package/fesm/dtos/email-template.dto.js

@@ -21,11 +21,9 @@ function _ts_metadata(k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
 import { IdentityResponseDto } from '@flusys/nestjs-shared/dtos';
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { ApiProperty, ApiPropertyOptional, PartialType } from '@nestjs/swagger';
 import { IsBoolean, IsNotEmpty, IsObject, IsOptional, IsString, MaxLength } from 'class-validator';
-/**
- * DTO for creating email template
- */ export class CreateEmailTemplateDto {
+export class CreateEmailTemplateDto {
     constructor(){
         _define_property(this, "name", void 0);
         _define_property(this, "slug", void 0);
@@ -79,12 +77,9 @@ _ts_decorate([
     ApiProperty({
         type: 'object',
         additionalProperties: true,
-        description: 'Visual builder schema (sections, blocks, settings)',
         example: {
             id: 'template-1',
-            version: '1.0.0',
-            sections: [],
-            settings: {}
+            sections: []
         }
     }),
     IsObject(),
@@ -93,8 +88,7 @@ _ts_decorate([
 ], CreateEmailTemplateDto.prototype, "schema", void 0);
 _ts_decorate([
     ApiProperty({
-        example: '<h1>Welcome {{userName}}!</h1><p>Thanks for joining us.</p>',
-        description: 'Rendered HTML content with {{variable}} placeholders'
+        example: '<h1>Welcome {{userName}}!</h1>'
     }),
     IsString(),
     IsNotEmpty(),
@@ -102,8 +96,7 @@ _ts_decorate([
 ], CreateEmailTemplateDto.prototype, "htmlContent", void 0);
 _ts_decorate([
     ApiPropertyOptional({
-        example: 'Welcome {{userName}}!\n\nThanks for joining us.',
-        description: 'Plain text fallback content'
+        example: 'Welcome {{userName}}!'
     }),
     IsString(),
     IsOptional(),
@@ -119,8 +112,7 @@ _ts_decorate([
 ], CreateEmailTemplateDto.prototype, "isActive", void 0);
 _ts_decorate([
     ApiPropertyOptional({
-        example: true,
-        description: 'Whether template uses HTML (true) or plain text (false)'
+        example: true
     }),
     IsBoolean(),
     IsOptional(),
@@ -130,34 +122,17 @@ _ts_decorate([
     ApiPropertyOptional({
         type: 'object',
         additionalProperties: true,
-        description: 'Additional metadata (tags, category, etc.)',
         example: {
-            category: 'onboarding',
-            tags: [
-                'welcome',
-                'new-user'
-            ]
+            category: 'onboarding'
         }
     }),
     IsObject(),
     IsOptional(),
     _ts_metadata("design:type", typeof Record === "undefined" ? Object : Record)
 ], CreateEmailTemplateDto.prototype, "metadata", void 0);
-/**
- * DTO for updating email template
- */ export class UpdateEmailTemplateDto {
-    constructor(){
-        _define_property(this, "id", void 0);
-        _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, "isActive", void 0);
-        _define_property(this, "isHtml", void 0);
-        _define_property(this, "metadata", void 0);
+export class UpdateEmailTemplateDto extends PartialType(CreateEmailTemplateDto) {
+    constructor(...args){
+        super(...args), _define_property(this, "id", void 0);
     }
 }
 _ts_decorate([
@@ -168,101 +143,58 @@ _ts_decorate([
     IsNotEmpty(),
     _ts_metadata("design:type", String)
 ], UpdateEmailTemplateDto.prototype, "id", void 0);
+export class EmailTemplateResponseDto extends IdentityResponseDto {
+    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([
-    ApiPropertyOptional({
-        example: 'Welcome Email'
-    }),
-    IsString(),
-    IsOptional(),
-    MaxLength(255),
+    ApiProperty(),
     _ts_metadata("design:type", String)
-], UpdateEmailTemplateDto.prototype, "name", void 0);
+], EmailTemplateResponseDto.prototype, "name", void 0);
 _ts_decorate([
-    ApiPropertyOptional({
-        example: 'welcome-email'
-    }),
-    IsString(),
-    IsOptional(),
-    MaxLength(255),
+    ApiProperty(),
     _ts_metadata("design:type", String)
-], UpdateEmailTemplateDto.prototype, "slug", void 0);
+], EmailTemplateResponseDto.prototype, "slug", void 0);
 _ts_decorate([
-    ApiPropertyOptional({
-        example: 'Email sent to new users upon registration'
-    }),
-    IsString(),
-    IsOptional(),
-    MaxLength(500),
-    _ts_metadata("design:type", String)
-], UpdateEmailTemplateDto.prototype, "description", void 0);
+    ApiPropertyOptional(),
+    _ts_metadata("design:type", Object)
+], EmailTemplateResponseDto.prototype, "description", void 0);
 _ts_decorate([
-    ApiPropertyOptional({
-        example: 'Welcome to {{appName}}!'
-    }),
-    IsString(),
-    IsOptional(),
-    MaxLength(500),
+    ApiProperty(),
     _ts_metadata("design:type", String)
-], UpdateEmailTemplateDto.prototype, "subject", void 0);
+], EmailTemplateResponseDto.prototype, "subject", void 0);
 _ts_decorate([
-    ApiPropertyOptional({
+    ApiProperty({
         type: 'object',
-        additionalProperties: true,
-        description: 'Visual builder schema'
+        additionalProperties: true
     }),
-    IsObject(),
-    IsOptional(),
     _ts_metadata("design:type", typeof Record === "undefined" ? Object : Record)
-], UpdateEmailTemplateDto.prototype, "schema", void 0);
+], EmailTemplateResponseDto.prototype, "schema", void 0);
 _ts_decorate([
-    ApiPropertyOptional({
-        example: '<h1>Welcome {{userName}}!</h1>',
-        description: 'Rendered HTML content'
-    }),
-    IsString(),
-    IsOptional(),
+    ApiProperty(),
     _ts_metadata("design:type", String)
-], UpdateEmailTemplateDto.prototype, "htmlContent", void 0);
+], EmailTemplateResponseDto.prototype, "htmlContent", void 0);
 _ts_decorate([
-    ApiPropertyOptional({
-        example: 'Welcome {{userName}}!',
-        description: 'Plain text fallback'
-    }),
-    IsString(),
-    IsOptional(),
-    _ts_metadata("design:type", String)
-], UpdateEmailTemplateDto.prototype, "textContent", void 0);
+    ApiPropertyOptional(),
+    _ts_metadata("design:type", Object)
+], EmailTemplateResponseDto.prototype, "textContent", void 0);
 _ts_decorate([
-    ApiPropertyOptional({
-        example: true
-    }),
-    IsBoolean(),
-    IsOptional(),
+    ApiProperty(),
+    _ts_metadata("design:type", Number)
+], EmailTemplateResponseDto.prototype, "schemaVersion", void 0);
+_ts_decorate([
+    ApiProperty(),
     _ts_metadata("design:type", Boolean)
-], UpdateEmailTemplateDto.prototype, "isActive", void 0);
+], EmailTemplateResponseDto.prototype, "isActive", void 0);
 _ts_decorate([
-    ApiPropertyOptional({
-        example: true,
-        description: 'Whether template uses HTML (true) or plain text (false)'
-    }),
-    IsBoolean(),
-    IsOptional(),
+    ApiProperty(),
     _ts_metadata("design:type", Boolean)
-], UpdateEmailTemplateDto.prototype, "isHtml", void 0);
+], EmailTemplateResponseDto.prototype, "isHtml", void 0);
 _ts_decorate([
     ApiPropertyOptional({
         type: 'object',
-        additionalProperties: true,
-        description: 'Additional metadata'
+        additionalProperties: true
     }),
-    IsObject(),
-    IsOptional(),
-    _ts_metadata("design:type", typeof Record === "undefined" ? Object : Record)
-], UpdateEmailTemplateDto.prototype, "metadata", void 0);
-/**
- * Response DTO for email template
- */ export class EmailTemplateResponseDto extends IdentityResponseDto {
-    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_metadata("design:type", Object)
+], EmailTemplateResponseDto.prototype, "metadata", void 0);

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

@@ -21,8 +21,8 @@ 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 {
+import { EmailConfig } from './email-config.entity';
+export class EmailConfigWithCompany extends EmailConfig {
     constructor(...args){
         super(...args), _define_property(this, "companyId", void 0);
     }