stratal 0.0.1

package/dist/email/consumers/email.consumer.d.ts

@@ -0,0 +1,43 @@
+import { type LoggerService } from '../../logger';
+import type { IQueueConsumer, QueueMessage } from '../../queue/queue-consumer';
+import { type StorageService } from '../../storage';
+import type { SendEmailInput } from '../contracts';
+import type { EmailProviderFactory } from '../services/email-provider-factory';
+/**
+ * Email Consumer
+ *
+ * Generic queue consumer that handles email.send and email.batch.send messages
+ * from ANY queue. Message routing is based on message type, not queue name.
+ *
+ * This consumer:
+ * - Resolves storage-based attachments to streams
+ * - Creates email provider instances via factory
+ * - Sends emails with proper logging (no PII)
+ * - Handles errors with retry support
+ *
+ * @example
+ * ```typescript
+ * // Registered in EmailModule
+ * @Module({
+ *   consumers: [EmailConsumer]
+ * })
+ * ```
+ */
+export declare class EmailConsumer implements IQueueConsumer<SendEmailInput> {
+    private readonly logger;
+    private readonly providerFactory;
+    private readonly storage;
+    readonly messageTypes: string[];
+    constructor(logger: LoggerService, providerFactory: EmailProviderFactory, storage: StorageService);
+    handle(message: QueueMessage<SendEmailInput>): Promise<void>;
+    onError(error: Error, message: QueueMessage<SendEmailInput>): Promise<void>;
+    /**
+     * Resolve email attachments
+     *
+     * Converts attachment schemas to resolved attachments.
+     * - Inline attachments: decode base64 to Buffer
+     * - Storage attachments: pass stream directly (providers support streams)
+     */
+    private resolveAttachments;
+}
+//# sourceMappingURL=email.consumer.d.ts.map

package/dist/email/consumers/email.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.consumer.d.ts","sourceRoot":"","sources":["../../../src/email/consumers/email.consumer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9E,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAA;AACnE,OAAO,KAAK,EAA4C,cAAc,EAAE,MAAM,cAAc,CAAA;AAE5F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAA;AAE9E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBACa,aAAc,YAAW,cAAc,CAAC,cAAc,CAAC;IAKhE,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAR1B,QAAQ,CAAC,YAAY,WAAqC;gBAIvC,MAAM,EAAE,aAAa,EAErB,eAAe,EAAE,oBAAoB,EAErC,OAAO,EAAE,cAAc;IAGpC,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAyClE,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAe3E;;;;;;OAMG;YACW,kBAAkB;CA4BjC"}

package/dist/email/consumers/email.consumer.js

@@ -0,0 +1,133 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject } from 'tsyringe';
+import { Transient } from '../../di/decorators';
+import { LOGGER_TOKENS } from '../../logger';
+import { STORAGE_TOKENS } from '../../storage';
+import { EMAIL_TOKENS } from '../email.tokens';
+/**
+ * Email Consumer
+ *
+ * Generic queue consumer that handles email.send and email.batch.send messages
+ * from ANY queue. Message routing is based on message type, not queue name.
+ *
+ * This consumer:
+ * - Resolves storage-based attachments to streams
+ * - Creates email provider instances via factory
+ * - Sends emails with proper logging (no PII)
+ * - Handles errors with retry support
+ *
+ * @example
+ * ```typescript
+ * // Registered in EmailModule
+ * @Module({
+ *   consumers: [EmailConsumer]
+ * })
+ * ```
+ */
+let EmailConsumer = class EmailConsumer {
+    logger;
+    providerFactory;
+    storage;
+    messageTypes = ['email.send', 'email.batch.send'];
+    constructor(logger, providerFactory, storage) {
+        this.logger = logger;
+        this.providerFactory = providerFactory;
+        this.storage = storage;
+    }
+    async handle(message) {
+        const { type, payload, tenantId } = message;
+        const recipientCount = Array.isArray(payload.to) ? payload.to.length : 1;
+        this.logger.info('Processing email message', {
+            type,
+            tenantId,
+            recipientCount,
+            hasHtml: !!payload.html,
+            hasText: !!payload.text,
+            hasAttachments: !!payload.attachments?.length,
+        });
+        try {
+            // Resolve storage-based attachments before sending
+            const resolvedAttachments = await this.resolveAttachments(payload.attachments);
+            const provider = await this.providerFactory.create();
+            const result = await provider.send({
+                ...payload,
+                attachments: resolvedAttachments,
+            });
+            this.logger.info('Email sent successfully', {
+                type,
+                tenantId,
+                recipientCount,
+                messageId: result.messageId,
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to send email', {
+                type,
+                tenantId,
+                recipientCount,
+                error: error.message,
+            });
+            throw error; // Retry via queue
+        }
+    }
+    onError(error, message) {
+        const recipientCount = Array.isArray(message.payload.to)
+            ? message.payload.to.length
+            : 1;
+        this.logger.error('Email send failed after retries', {
+            tenantId: message.tenantId,
+            recipientCount,
+            error: error.message,
+            stack: error.stack,
+        });
+        return Promise.resolve();
+    }
+    /**
+     * Resolve email attachments
+     *
+     * Converts attachment schemas to resolved attachments.
+     * - Inline attachments: decode base64 to Buffer
+     * - Storage attachments: pass stream directly (providers support streams)
+     */
+    async resolveAttachments(attachments) {
+        if (!attachments?.length)
+            return undefined;
+        return Promise.all(attachments.map(async (attachment) => {
+            // Check for inline attachment (has content property)
+            if ('content' in attachment) {
+                return {
+                    filename: attachment.filename,
+                    content: Buffer.from(attachment.content, 'base64'),
+                    contentType: attachment.contentType,
+                };
+            }
+            // Storage attachment - pass stream directly to provider
+            const result = await this.storage.download(attachment.storageKey, attachment.disk);
+            return {
+                filename: attachment.filename,
+                content: result.toStream() ?? Buffer.alloc(0),
+                contentType: result.contentType,
+            };
+        }));
+    }
+};
+EmailConsumer = __decorate([
+    Transient(),
+    __param(0, inject(LOGGER_TOKENS.LoggerService)),
+    __param(1, inject(EMAIL_TOKENS.EmailProviderFactory)),
+    __param(2, inject(STORAGE_TOKENS.StorageService)),
+    __metadata("design:paramtypes", [Function, Function, Function])
+], EmailConsumer);
+export { EmailConsumer };
+//# sourceMappingURL=email.consumer.js.map

package/dist/email/consumers/email.consumer.js.map

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

package/dist/email/consumers/index.d.ts

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

package/dist/email/consumers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/email/consumers/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA"}

package/dist/email/consumers/index.js

@@ -0,0 +1,2 @@
+export * from './email.consumer';
+//# sourceMappingURL=index.js.map

package/dist/email/consumers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/email/consumers/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA"}

package/dist/email/contracts/email-attachment.d.ts

@@ -0,0 +1,61 @@
+import { z } from '../../i18n/validation';
+/**
+ * Inline Email Attachment Schema
+ *
+ * Attachment with content embedded as base64 string.
+ * Use for small files that can fit in queue message.
+ */
+export declare const inlineEmailAttachmentSchema: z.ZodObject<{
+    filename: z.ZodString;
+    content: z.ZodString;
+    contentType: z.ZodString;
+    size: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Storage Email Attachment Schema
+ *
+ * Attachment stored in cloud storage.
+ * Content type and size are derived from storage metadata.
+ * Use for large files to avoid queue message size limits.
+ */
+export declare const storageEmailAttachmentSchema: z.ZodObject<{
+    filename: z.ZodString;
+    storageKey: z.ZodString;
+    disk: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Email Attachment Schema
+ *
+ * Union type - type is inferred from presence of `content` vs `storageKey`.
+ * - If `content` is present: inline attachment
+ * - If `storageKey` is present: storage-based attachment
+ */
+export declare const emailAttachmentSchema: z.ZodUnion<readonly [z.ZodObject<{
+    filename: z.ZodString;
+    content: z.ZodString;
+    contentType: z.ZodString;
+    size: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    filename: z.ZodString;
+    storageKey: z.ZodString;
+    disk: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>;
+/**
+ * Type definitions
+ */
+export type InlineEmailAttachment = z.infer<typeof inlineEmailAttachmentSchema>;
+export type StorageEmailAttachment = z.infer<typeof storageEmailAttachmentSchema>;
+export type EmailAttachment = z.infer<typeof emailAttachmentSchema>;
+/**
+ * Resolved Email Attachment
+ *
+ * Attachment after resolution, ready for email provider.
+ * Content can be Buffer (for inline) or ReadableStream (for storage-based).
+ * Both nodemailer and Resend support these formats directly.
+ */
+export interface ResolvedEmailAttachment {
+    filename: string;
+    content: Buffer | ReadableStream;
+    contentType: string;
+}
+//# sourceMappingURL=email-attachment.d.ts.map

package/dist/email/contracts/email-attachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-attachment.d.ts","sourceRoot":"","sources":["../../../src/email/contracts/email-attachment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,uBAAuB,CAAA;AAEzC;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B;;;;;iBAoBtC,CAAA;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B;;;;iBAevC,CAAA;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;mBAGhC,CAAA;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAC/E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AACjF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnE;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,GAAG,cAAc,CAAA;IAChC,WAAW,EAAE,MAAM,CAAA;CACpB"}

package/dist/email/contracts/email-attachment.js

@@ -0,0 +1,58 @@
+import { z } from '../../i18n/validation';
+/**
+ * Inline Email Attachment Schema
+ *
+ * Attachment with content embedded as base64 string.
+ * Use for small files that can fit in queue message.
+ */
+export const inlineEmailAttachmentSchema = z.object({
+    /**
+     * Filename to display for the attachment
+     */
+    filename: z.string().min(1).max(255),
+    /**
+     * Base64 encoded content of the attachment
+     */
+    content: z.string(),
+    /**
+     * MIME type of the attachment (e.g., 'application/pdf', 'image/png')
+     */
+    contentType: z.string(),
+    /**
+     * Optional size of the attachment in bytes
+     */
+    size: z.number().positive().optional(),
+});
+/**
+ * Storage Email Attachment Schema
+ *
+ * Attachment stored in cloud storage.
+ * Content type and size are derived from storage metadata.
+ * Use for large files to avoid queue message size limits.
+ */
+export const storageEmailAttachmentSchema = z.object({
+    /**
+     * Filename to display for the attachment
+     */
+    filename: z.string().min(1).max(255),
+    /**
+     * Path to the file in storage
+     */
+    storageKey: z.string(),
+    /**
+     * Optional storage disk name (uses default if not provided)
+     */
+    disk: z.string().optional(),
+});
+/**
+ * Email Attachment Schema
+ *
+ * Union type - type is inferred from presence of `content` vs `storageKey`.
+ * - If `content` is present: inline attachment
+ * - If `storageKey` is present: storage-based attachment
+ */
+export const emailAttachmentSchema = z.union([
+    inlineEmailAttachmentSchema,
+    storageEmailAttachmentSchema,
+]);
+//# sourceMappingURL=email-attachment.js.map

package/dist/email/contracts/email-attachment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-attachment.js","sourceRoot":"","sources":["../../../src/email/contracts/email-attachment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,uBAAuB,CAAA;AAEzC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD;;OAEG;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAEpC;;OAEG;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IAEnB;;OAEG;IACH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IAEvB;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAA;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD;;OAEG;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAEpC;;OAEG;IACH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IAEtB;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAA;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC;IAC3C,2BAA2B;IAC3B,4BAA4B;CAC7B,CAAC,CAAA"}

package/dist/email/contracts/email-message.contract.d.ts

@@ -0,0 +1,58 @@
+import { z } from '../../i18n/validation';
+import { type ResolvedEmailAttachment } from './email-attachment';
+/**
+ * Email Address Schema
+ *
+ * Represents an email address with optional name
+ */
+export declare const emailAddressSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    email: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Base Email Message Schema
+ *
+ * Defines the core structure for email messages.
+ * Ensures either html or text content is provided.
+ */
+export declare const emailMessageSchema: z.ZodObject<{
+    to: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+    from: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        email: z.ZodString;
+    }, z.core.$strip>>;
+    subject: z.ZodString;
+    html: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    replyTo: z.ZodOptional<z.ZodString>;
+    cc: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    bcc: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        filename: z.ZodString;
+        content: z.ZodString;
+        contentType: z.ZodString;
+        size: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        filename: z.ZodString;
+        storageKey: z.ZodString;
+        disk: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>>;
+}, z.core.$strip>;
+/**
+ * Type definition for email message
+ */
+export type EmailMessage = z.infer<typeof emailMessageSchema>;
+/**
+ * Type definition for email address
+ */
+export type EmailAddress = z.infer<typeof emailAddressSchema>;
+/**
+ * Resolved Email Message
+ *
+ * Email message with attachments resolved to Buffer content.
+ * Used by providers after the consumer resolves storage-based attachments.
+ */
+export type ResolvedEmailMessage = Omit<EmailMessage, 'attachments'> & {
+    attachments?: ResolvedEmailAttachment[];
+};
+//# sourceMappingURL=email-message.contract.d.ts.map

package/dist/email/contracts/email-message.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-message.contract.d.ts","sourceRoot":"","sources":["../../../src/email/contracts/email-message.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,CAAC,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,EAAyB,KAAK,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAExF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;iBAsD5B,CAAA;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE7D;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE7D;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,GAAG;IACrE,WAAW,CAAC,EAAE,uBAAuB,EAAE,CAAA;CACxC,CAAA"}

package/dist/email/contracts/email-message.contract.js

@@ -0,0 +1,62 @@
+import { withI18n, z } from '../../i18n/validation';
+import { emailAttachmentSchema } from './email-attachment';
+/**
+ * Email Address Schema
+ *
+ * Represents an email address with optional name
+ */
+export const emailAddressSchema = z.object({
+    name: z.string().optional(),
+    email: z.string().email(),
+});
+/**
+ * Base Email Message Schema
+ *
+ * Defines the core structure for email messages.
+ * Ensures either html or text content is provided.
+ */
+export const emailMessageSchema = z
+    .object({
+    /**
+     * Recipient email address(es)
+     * Can be a single email string or array of emails
+     */
+    to: z.union([z.string().email(), z.array(z.string().email())]),
+    /**
+     * Sender email address with optional name
+     * Falls back to default from config if not provided
+     */
+    from: emailAddressSchema.optional(),
+    /**
+     * Email subject line
+     */
+    subject: z.string().min(1).max(500),
+    /**
+     * HTML content of the email
+     * Either html or text must be provided
+     */
+    html: z.string().optional(),
+    /**
+     * Plain text content of the email
+     * Either html or text must be provided
+     */
+    text: z.string().optional(),
+    /**
+     * Reply-to email address
+     */
+    replyTo: z.string().email().optional(),
+    /**
+     * CC recipients
+     */
+    cc: z.array(z.string().email()).optional(),
+    /**
+     * BCC recipients
+     */
+    bcc: z.array(z.string().email()).optional(),
+    /**
+     * Email attachments
+     */
+    attachments: z.array(emailAttachmentSchema).optional(),
+})
+    .refine((data) => data.html ?? data.text, withI18n('zodI18n.errors.custom.emailOrTextRequired'));
+//# sourceMappingURL=email-message.contract.js.map

package/dist/email/contracts/email-message.contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-message.contract.js","sourceRoot":"","sources":["../../../src/email/contracts/email-message.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,EAAE,qBAAqB,EAAgC,MAAM,oBAAoB,CAAA;AAExF;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE;CAC1B,CAAC,CAAA;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN;;;OAGG;IACH,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAE9D;;;OAGG;IACH,IAAI,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IAEnC;;OAEG;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAEnC;;;OAGG;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE3B;;;OAGG;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE3B;;OAEG;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;IAEtC;;OAEG;IACH,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE;IAE1C;;OAEG;IACH,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE;IAE3C;;OAEG;IACH,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,QAAQ,EAAE;CACvD,CAAC;KACD,MAAM,CACL,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAChC,QAAQ,CAAC,2CAA2C,CAAC,CACtD,CAAA"}

package/dist/email/contracts/index.d.ts

@@ -0,0 +1,4 @@
+export * from './email-attachment';
+export * from './email-message.contract';
+export * from './send-email.input';
+//# sourceMappingURL=index.d.ts.map

package/dist/email/contracts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/email/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,oBAAoB,CAAA"}

package/dist/email/contracts/index.js

@@ -0,0 +1,4 @@
+export * from './email-attachment';
+export * from './email-message.contract';
+export * from './send-email.input';
+//# sourceMappingURL=index.js.map

package/dist/email/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/email/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,oBAAoB,CAAA"}

package/dist/email/contracts/send-email.input.d.ts

@@ -0,0 +1,72 @@
+import { z } from '../../i18n/validation';
+/**
+ * Send Email Input Schema
+ *
+ * Input schema for sending emails through the EmailService.
+ * Extends the base email message with optional metadata.
+ * Uses safeExtend() because emailMessageSchema contains refinements.
+ */
+export declare const sendEmailInputSchema: z.ZodObject<{
+    to: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+    from: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        email: z.ZodString;
+    }, z.core.$strip>>;
+    subject: z.ZodString;
+    html: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    replyTo: z.ZodOptional<z.ZodString>;
+    cc: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    bcc: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        filename: z.ZodString;
+        content: z.ZodString;
+        contentType: z.ZodString;
+        size: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        filename: z.ZodString;
+        storageKey: z.ZodString;
+        disk: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/**
+ * Type definition for send email input
+ */
+export type SendEmailInput = z.infer<typeof sendEmailInputSchema>;
+/**
+ * Send Batch Email Input Schema
+ *
+ * Schema for sending multiple emails in a batch
+ */
+export declare const sendBatchEmailInputSchema: z.ZodObject<{
+    messages: z.ZodArray<z.ZodObject<{
+        to: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+        from: z.ZodOptional<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            email: z.ZodString;
+        }, z.core.$strip>>;
+        subject: z.ZodString;
+        html: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        replyTo: z.ZodOptional<z.ZodString>;
+        cc: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        bcc: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        attachments: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            filename: z.ZodString;
+            content: z.ZodString;
+            contentType: z.ZodString;
+            size: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            filename: z.ZodString;
+            storageKey: z.ZodString;
+            disk: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>]>>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Type definition for send batch email input
+ */
+export type SendBatchEmailInput = z.infer<typeof sendBatchEmailInputSchema>;
+//# sourceMappingURL=send-email.input.d.ts.map

package/dist/email/contracts/send-email.input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-email.input.d.ts","sourceRoot":"","sources":["../../../src/email/contracts/send-email.input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,uBAAuB,CAAA;AAGzC;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;iBAM/B,CAAA;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;iBAKpC,CAAA;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA"}

package/dist/email/contracts/send-email.input.js

@@ -0,0 +1,28 @@
+import { z } from '../../i18n/validation';
+import { emailMessageSchema } from './email-message.contract';
+/**
+ * Send Email Input Schema
+ *
+ * Input schema for sending emails through the EmailService.
+ * Extends the base email message with optional metadata.
+ * Uses safeExtend() because emailMessageSchema contains refinements.
+ */
+export const sendEmailInputSchema = emailMessageSchema.safeExtend({
+    /**
+     * Optional metadata to include with the email
+     * Can be used for tracking, categorization, etc.
+     */
+    metadata: z.record(z.string(), z.unknown()).optional(),
+});
+/**
+ * Send Batch Email Input Schema
+ *
+ * Schema for sending multiple emails in a batch
+ */
+export const sendBatchEmailInputSchema = z.object({
+    /**
+     * Array of email messages to send
+     */
+    messages: z.array(sendEmailInputSchema).min(1).max(100),
+});
+//# sourceMappingURL=send-email.input.js.map

package/dist/email/contracts/send-email.input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-email.input.js","sourceRoot":"","sources":["../../../src/email/contracts/send-email.input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,uBAAuB,CAAA;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAE7D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC,UAAU,CAAC;IAChE;;;OAGG;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACvD,CAAC,CAAA;AAOF;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD;;OAEG;IACH,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;CACxD,CAAC,CAAA"}