alepha 0.14.3 → 0.15.0

package/dist/email/index.js

@@ -1,7 +1,6 @@
-import { $env, $hook, $module, KIND, Primitive, createPrimitive, t } from "alepha";
+import { $atom, $env, $hook, $inject, $module, $use, KIND, Primitive, createPrimitive, t } from "alepha";
 import { $logger } from "alepha/logger";
-import * as fs from "node:fs/promises";
-import * as path from "node:path";
+import { FileSystemProvider } from "alepha/file";
 import nodemailer from "nodemailer";
 
 //#region ../../src/email/providers/EmailProvider.ts
@@ -104,12 +103,34 @@ var EmailError = class extends Error {
 
 //#endregion
 //#region ../../src/email/providers/LocalEmailProvider.ts
+/**
+* Local email provider configuration atom
+*/
+const localEmailOptions = $atom({
+	name: "alepha.email.local.options",
+	schema: t.object({ directory: t.string({ description: "Directory path where email files will be stored" }) }),
+	default: { directory: "node_modules/.alepha/emails" }
+});
 var LocalEmailProvider = class {
 	log = $logger();
-	directory;
-	constructor(options = {}) {
-		this.directory = options.directory ?? "node_modules/.alepha/emails";
+	fs = $inject(FileSystemProvider);
+	options = $use(localEmailOptions);
+	get directory() {
+		return this.options.directory;
 	}
+	onStart = $hook({
+		on: "start",
+		handler: async () => {
+			try {
+				await this.fs.mkdir(this.directory, { recursive: true });
+				this.log.info("Email directory OK", { directory: this.directory });
+			} catch (error) {
+				const message = `Failed to create email directory: ${error instanceof Error ? error.message : String(error)}`;
+				this.log.error(message, { directory: this.directory });
+				throw new EmailError(message, error instanceof Error ? error : void 0);
+			}
+		}
+	});
 	async send(options) {
 		const { to, subject, body } = options;
 		this.log.debug("Sending email to local file", {
@@ -118,17 +139,16 @@ var LocalEmailProvider = class {
 			directory: this.directory
 		});
 		try {
-			await fs.mkdir(this.directory, { recursive: true });
 			const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
 			for (const recipient of Array.isArray(to) ? to : [to]) {
 				const filename = `${recipient.replace(/[^a-zA-Z0-9@.-]/g, "_")}+${timestamp}.html`;
-				const filepath = path.join(this.directory, filename);
+				const filepath = this.fs.join(this.directory, filename);
 				const htmlContent = this.createEmailHtml({
 					to: recipient,
 					subject,
 					body
 				});
-				await fs.writeFile(filepath, htmlContent, "utf8");
+				await this.fs.writeFile(filepath, htmlContent);
 				this.log.info("Email saved to local file", {
 					filepath,
 					to,
@@ -180,29 +200,98 @@ var LocalEmailProvider = class {
 
 //#endregion
 //#region ../../src/email/providers/NodemailerEmailProvider.ts
+/**
+* Environment variables for nodemailer configuration
+*/
 const envSchema = t.object({
-	EMAIL_HOST: t.text({ description: "SMTP server host" }),
+	EMAIL_HOST: t.optional(t.text({ description: "SMTP server host" })),
 	EMAIL_PORT: t.number({
 		default: 587,
 		description: "SMTP server port"
 	}),
-	EMAIL_USER: t.text({ description: "SMTP authentication username" }),
-	EMAIL_PASS: t.text({ description: "SMTP authentication password" }),
-	EMAIL_FROM: t.text({ description: "Default from email address" }),
+	EMAIL_USER: t.optional(t.text({ description: "SMTP authentication username" })),
+	EMAIL_PASS: t.optional(t.text({ description: "SMTP authentication password" })),
+	EMAIL_FROM: t.optional(t.text({ description: "Default from email address" })),
 	EMAIL_SECURE: t.boolean({
 		default: false,
 		description: "Use secure connection (TLS)"
 	})
 });
+/**
+* Nodemailer connection pooling and rate limiting options
+*/
+const nodemailerEmailOptions = $atom({
+	name: "alepha.email.nodemailer.options",
+	schema: t.object({
+		pool: t.optional(t.boolean({ description: "Enable connection pooling" })),
+		maxConnections: t.optional(t.number({ description: "Maximum number of connections in pool" })),
+		maxMessages: t.optional(t.number({ description: "Maximum messages per connection" })),
+		rateDelta: t.optional(t.number({ description: "Time in milliseconds between message sends" })),
+		rateLimit: t.optional(t.number({ description: "Maximum number of messages per rateDelta" }))
+	}),
+	default: {}
+});
+/**
+* Email provider using Nodemailer for SMTP transport.
+*
+* Configuration is provided via environment variables:
+* - EMAIL_HOST: SMTP server host
+* - EMAIL_PORT: SMTP server port (default: 587)
+* - EMAIL_USER: SMTP authentication username
+* - EMAIL_PASS: SMTP authentication password
+* - EMAIL_FROM: Default from email address
+* - EMAIL_SECURE: Use secure connection (default: false)
+*
+* Advanced pooling/rate limiting options can be configured via atom:
+* @see {@link nodemailerEmailOptions}
+*
+* @example
+* ```typescript
+* // Configure via environment variables
+* // EMAIL_HOST=smtp.example.com
+* // EMAIL_PORT=587
+* // EMAIL_USER=user@example.com
+* // EMAIL_PASS=secret
+* // EMAIL_FROM=noreply@example.com
+*
+* // Optionally configure pooling via atom
+* alepha.state.set(nodemailerEmailOptions.key, {
+*   pool: true,
+*   maxConnections: 5,
+*   rateLimit: 10,
+* });
+* ```
+*/
 var NodemailerEmailProvider = class {
 	env = $env(envSchema);
 	log = $logger();
-	transporter;
-	fromAddress;
-	options = {};
-	constructor() {
-		this.fromAddress = this.options.from ?? this.env.EMAIL_FROM;
-		this.transporter = this.createTransporter();
+	options = $use(nodemailerEmailOptions);
+	transporter = null;
+	get host() {
+		const host = this.env.EMAIL_HOST;
+		if (!host) throw new EmailError("Email host not configured. Set EMAIL_HOST env var.");
+		return host;
+	}
+	get port() {
+		return this.env.EMAIL_PORT;
+	}
+	get secure() {
+		return this.env.EMAIL_SECURE;
+	}
+	get user() {
+		return this.env.EMAIL_USER;
+	}
+	get pass() {
+		return this.env.EMAIL_PASS;
+	}
+	get fromAddress() {
+		const from = this.env.EMAIL_FROM;
+		if (!from) throw new EmailError("Email from address not configured. Set EMAIL_FROM env var.");
+		return from;
+	}
+	getTransporter() {
+		if (!this.transporter) this.transporter = this.createTransporter();
+		return this.transporter;
 	}
 	async send(options) {
 		const { to, subject, body } = options;
@@ -211,7 +300,7 @@ var NodemailerEmailProvider = class {
 			subject
 		});
 		try {
-			const result = await this.transporter.sendMail({
+			const result = await this.getTransporter().sendMail({
 				from: this.fromAddress,
 				to,
 				subject,
@@ -233,22 +322,26 @@ var NodemailerEmailProvider = class {
 		}
 	}
 	createTransporter() {
-		if (this.options.transporter) return this.options.transporter;
 		const transporterConfig = {
-			host: this.env.EMAIL_HOST,
-			port: this.env.EMAIL_PORT,
-			secure: this.env.EMAIL_SECURE,
-			auth: {
-				user: this.env.EMAIL_USER,
-				pass: this.env.EMAIL_PASS
-			},
-			...this.options.options
+			host: this.host,
+			port: this.port,
+			secure: this.secure,
+			auth: this.user && this.pass ? {
+				user: this.user,
+				pass: this.pass
+			} : void 0,
+			pool: this.options.pool,
+			maxConnections: this.options.maxConnections,
+			maxMessages: this.options.maxMessages,
+			rateDelta: this.options.rateDelta,
+			rateLimit: this.options.rateLimit
 		};
 		this.log.debug("Creating Nodemailer transporter", {
 			host: transporterConfig.host,
 			port: transporterConfig.port,
 			secure: transporterConfig.secure,
-			user: transporterConfig.auth.user
+			user: transporterConfig.auth?.user,
+			pool: transporterConfig.pool
 		});
 		return nodemailer.createTransport(transporterConfig);
 	}
@@ -257,7 +350,7 @@ var NodemailerEmailProvider = class {
 	*/
 	async verify() {
 		try {
-			await this.transporter.verify();
+			await this.getTransporter().verify();
 			this.log.info("Email server connection verified");
 			return true;
 		} catch (error) {
@@ -269,7 +362,10 @@ var NodemailerEmailProvider = class {
 	* Close the transporter connection.
 	*/
 	close() {
-		this.transporter.close();
+		if (this.transporter) {
+			this.transporter.close();
+			this.transporter = null;
+		}
 	}
 	onStart = $hook({
 		on: "start",
@@ -327,5 +423,5 @@ const AlephaEmail = $module({
 });
 
 //#endregion
-export { $email, AlephaEmail, EmailError, EmailPrimitive, EmailProvider, LocalEmailProvider, MemoryEmailProvider, NodemailerEmailProvider };
+export { $email, AlephaEmail, EmailError, EmailPrimitive, EmailProvider, LocalEmailProvider, MemoryEmailProvider, NodemailerEmailProvider, localEmailOptions, nodemailerEmailOptions };
 //# sourceMappingURL=index.js.map

package/dist/email/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/email/providers/EmailProvider.ts","../../src/email/providers/MemoryEmailProvider.ts","../../src/email/primitives/$email.ts","../../src/email/errors/EmailError.ts","../../src/email/providers/LocalEmailProvider.ts","../../src/email/providers/NodemailerEmailProvider.ts","../../src/email/index.ts"],"sourcesContent":["/**\n * Email provider interface.\n *\n * All methods are asynchronous and return promises.\n */\nexport abstract class EmailProvider {\n  /**\n   * Send an email.\n   *\n   * @return Promise that resolves when the email is sent.\n   */\n  public abstract send(options: EmailSendOptions): Promise<void>;\n}\n\nexport type EmailSendOptions = {\n  to: string | string[];\n  subject: string;\n  body: string;\n};\n","import { $logger } from \"alepha/logger\";\nimport type { EmailProvider, EmailSendOptions } from \"./EmailProvider.ts\";\n\nexport interface EmailRecord {\n  to: string;\n  subject: string;\n  body: string;\n  sentAt: Date;\n}\n\nexport class MemoryEmailProvider implements EmailProvider {\n  protected readonly log = $logger();\n  public records: EmailRecord[] = [];\n\n  public async send(options: EmailSendOptions): Promise<void> {\n    const { to, subject, body } = options;\n    this.log.debug(\"Sending email to memory store\", { to, subject });\n\n    for (const recipient of Array.isArray(to) ? to : [to]) {\n      this.records.push({\n        to: recipient,\n        subject,\n        body,\n        sentAt: new Date(),\n      });\n    }\n  }\n\n  /**\n   * Get the last email sent (for testing purposes).\n   */\n  public get last(): EmailRecord | undefined {\n    return this.records[this.records.length - 1];\n  }\n}\n","import {\n  createPrimitive,\n  type InstantiableClass,\n  KIND,\n  Primitive,\n} from \"alepha\";\nimport type { EmailSendOptions } from \"../providers/EmailProvider.ts\";\nimport { EmailProvider } from \"../providers/EmailProvider.ts\";\nimport { MemoryEmailProvider } from \"../providers/MemoryEmailProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport const $email = (options: EmailPrimitiveOptions = {}) =>\n  createPrimitive(EmailPrimitive, options);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface EmailPrimitiveOptions {\n  name?: string;\n  provider?: InstantiableClass<EmailProvider> | \"memory\";\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Email primitive for sending emails through various providers.\n *\n * Usage:\n * ```typescript\n * class MyService {\n *   private readonly welcomeEmail = $email({ name: \"welcome\" });\n *\n *   async sendWelcome(userEmail: string, userName: string) {\n *     await this.welcomeEmail.send({\n *       to: userEmail,\n *       subject: \"Welcome!\",\n *       body: `<p>Hello ${userName}!</p>`\n *     });\n *   }\n * }\n * ```\n */\nexport class EmailPrimitive extends Primitive<EmailPrimitiveOptions> {\n  protected readonly provider = this.$provider();\n\n  public get name() {\n    return this.options.name ?? `${this.config.propertyKey}`;\n  }\n\n  /**\n   * Send an email using the configured provider.\n   */\n  public async send(options: EmailSendOptions): Promise<void> {\n    await this.alepha.events.emit(\"email:sending\", {\n      to: options.to,\n      template: this.name,\n      variables: {},\n      provider: this.provider,\n      abort: () => {\n        throw new Error(\"Email sending aborted by hook\");\n      },\n    });\n\n    await this.provider.send(options);\n\n    await this.alepha.events.emit(\"email:sent\", {\n      to: options.to,\n      template: this.name,\n      provider: this.provider,\n    });\n  }\n\n  protected $provider(): EmailProvider {\n    if (!this.options.provider) {\n      return this.alepha.inject(EmailProvider);\n    }\n    if (this.options.provider === \"memory\") {\n      return this.alepha.inject(MemoryEmailProvider);\n    }\n    return this.alepha.inject(this.options.provider);\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n$email[KIND] = EmailPrimitive;\n","export class EmailError extends Error {\n  constructor(message: string, cause?: Error) {\n    super(message);\n    this.name = \"EmailError\";\n    this.cause = cause;\n  }\n}\n","import * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport { $logger } from \"alepha/logger\";\nimport { EmailError } from \"../errors/EmailError.ts\";\nimport type { EmailProvider, EmailSendOptions } from \"./EmailProvider.ts\";\n\nexport interface LocalEmailProviderOptions {\n  /**\n   * Directory to save email files.\n   */\n  directory?: string;\n}\n\nexport class LocalEmailProvider implements EmailProvider {\n  protected readonly log = $logger();\n  protected readonly directory: string;\n\n  constructor(options: LocalEmailProviderOptions = {}) {\n    this.directory = options.directory ?? \"node_modules/.alepha/emails\";\n  }\n\n  public async send(options: EmailSendOptions): Promise<void> {\n    const { to, subject, body } = options;\n\n    this.log.debug(\"Sending email to local file\", {\n      to,\n      subject,\n      directory: this.directory,\n    });\n\n    try {\n      // Ensure directory exists\n      await fs.mkdir(this.directory, { recursive: true });\n\n      // Create filename: emailcontact+date\n      const timestamp = new Date().toISOString().replace(/[:.]/g, \"-\");\n      for (const recipient of Array.isArray(to) ? to : [to]) {\n        const sanitizedEmail = recipient.replace(/[^a-zA-Z0-9@.-]/g, \"_\");\n        const filename = `${sanitizedEmail}+${timestamp}.html`;\n        const filepath = path.join(this.directory, filename);\n\n        // Create HTML content\n        const htmlContent = this.createEmailHtml({\n          to: recipient,\n          subject,\n          body,\n        });\n\n        // Write to file\n        await fs.writeFile(filepath, htmlContent, \"utf8\");\n\n        this.log.info(\"Email saved to local file\", { filepath, to, subject });\n      }\n    } catch (error) {\n      const message = `Failed to save email to local file: ${error instanceof Error ? error.message : String(error)}`;\n      this.log.error(message, { to, subject, directory: this.directory });\n      throw new EmailError(message, error instanceof Error ? error : undefined);\n    }\n  }\n\n  public createEmailHtml(options: {\n    to: string;\n    subject: string;\n    body: string;\n  }): string {\n    const { to, subject, body } = options;\n    const timestamp = new Date().toISOString();\n\n    return `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n    <meta charset=\"UTF-8\">\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n    <title>${this.escapeHtml(subject)}</title>\n    <style>\n        body { font-family: Arial, sans-serif; margin: 20px; }\n        .email-header { background-color: #f5f5f5; padding: 15px; border-radius: 5px; margin-bottom: 20px; }\n        .email-body { background-color: #ffffff; padding: 15px; border: 1px solid #ddd; border-radius: 5px; }\n        .meta { font-size: 12px; color: #666; margin-bottom: 10px; }\n    </style>\n</head>\n<body>\n    <div class=\"email-header\">\n        <div class=\"meta\">Sent: ${timestamp}</div>\n        <div class=\"meta\">To: ${this.escapeHtml(to)}</div>\n        <h1>${this.escapeHtml(subject)}</h1>\n    </div>\n    <div class=\"email-body\">\n        ${body}\n    </div>\n</body>\n</html>`;\n  }\n\n  public escapeHtml(text: string): string {\n    return text\n      .replace(/&/g, \"&amp;\")\n      .replace(/</g, \"&lt;\")\n      .replace(/>/g, \"&gt;\")\n      .replace(/\"/g, \"&quot;\")\n      .replace(/'/g, \"&#39;\");\n  }\n}\n","import { $env, $hook, t } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport type { Transporter } from \"nodemailer\";\nimport nodemailer from \"nodemailer\";\nimport { EmailError } from \"../errors/EmailError.ts\";\nimport type { EmailProvider, EmailSendOptions } from \"./EmailProvider.ts\";\n\nconst envSchema = t.object({\n  EMAIL_HOST: t.text({\n    description: \"SMTP server host\",\n  }),\n  EMAIL_PORT: t.number({\n    default: 587,\n    description: \"SMTP server port\",\n  }),\n  EMAIL_USER: t.text({\n    description: \"SMTP authentication username\",\n  }),\n  EMAIL_PASS: t.text({\n    description: \"SMTP authentication password\",\n  }),\n  EMAIL_FROM: t.text({\n    description: \"Default from email address\",\n  }),\n  EMAIL_SECURE: t.boolean({\n    default: false,\n    description: \"Use secure connection (TLS)\",\n  }),\n});\n\nexport interface NodemailerEmailProviderOptions {\n  /**\n   * Custom transporter configuration.\n   * If provided, will override environment variables.\n   */\n  transporter?: Transporter;\n\n  /**\n   * Custom from email address.\n   * If not provided, will use EMAIL_FROM from environment.\n   */\n  from?: string;\n\n  /**\n   * Additional nodemailer options.\n   */\n  options?: {\n    pool?: boolean;\n    maxConnections?: number;\n    maxMessages?: number;\n    rateDelta?: number;\n    rateLimit?: number;\n  };\n}\n\nexport class NodemailerEmailProvider implements EmailProvider {\n  protected readonly env = $env(envSchema);\n  protected readonly log = $logger();\n  protected transporter: Transporter;\n  protected fromAddress: string;\n\n  public readonly options: NodemailerEmailProviderOptions = {};\n\n  constructor() {\n    this.fromAddress = this.options.from ?? this.env.EMAIL_FROM;\n    this.transporter = this.createTransporter();\n  }\n\n  public async send(options: EmailSendOptions): Promise<void> {\n    const { to, subject, body } = options;\n    this.log.debug(\"Sending email via Nodemailer\", { to, subject });\n\n    try {\n      const result = await this.transporter.sendMail({\n        from: this.fromAddress,\n        to,\n        subject,\n        html: body,\n      });\n\n      this.log.info(\"Email sent successfully\", {\n        to,\n        subject,\n        messageId: result.messageId,\n        response: result.response,\n      });\n    } catch (error) {\n      const message = `Failed to send email via Nodemailer: ${error instanceof Error ? error.message : String(error)}`;\n      this.log.error(message, { to, subject });\n      throw new EmailError(message, error instanceof Error ? error : undefined);\n    }\n  }\n\n  protected createTransporter(): Transporter {\n    if (this.options.transporter) {\n      return this.options.transporter;\n    }\n\n    const transporterConfig = {\n      host: this.env.EMAIL_HOST,\n      port: this.env.EMAIL_PORT,\n      secure: this.env.EMAIL_SECURE,\n      auth: {\n        user: this.env.EMAIL_USER,\n        pass: this.env.EMAIL_PASS,\n      },\n      ...this.options.options,\n    };\n\n    this.log.debug(\"Creating Nodemailer transporter\", {\n      host: transporterConfig.host,\n      port: transporterConfig.port,\n      secure: transporterConfig.secure,\n      user: transporterConfig.auth.user,\n    });\n\n    return nodemailer.createTransport(transporterConfig);\n  }\n\n  /**\n   * Verify the connection to the email server.\n   */\n  public async verify(): Promise<boolean> {\n    try {\n      await this.transporter.verify();\n      this.log.info(\"Email server connection verified\");\n      return true;\n    } catch (error) {\n      this.log.error(\"Email server connection failed\", { error });\n      return false;\n    }\n  }\n\n  /**\n   * Close the transporter connection.\n   */\n  public close(): void {\n    this.transporter.close();\n  }\n\n  protected readonly onStart = $hook({\n    on: \"start\",\n    handler: () => this.verify(),\n  });\n\n  protected readonly onStop = $hook({\n    on: \"stop\",\n    handler: () => this.close(),\n  });\n}\n","import { $module } from \"alepha\";\nimport { $email } from \"./primitives/$email.ts\";\nimport { EmailProvider } from \"./providers/EmailProvider.ts\";\nimport { LocalEmailProvider } from \"./providers/LocalEmailProvider.ts\";\nimport { MemoryEmailProvider } from \"./providers/MemoryEmailProvider.ts\";\nimport { NodemailerEmailProvider } from \"./providers/NodemailerEmailProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./errors/EmailError.ts\";\nexport * from \"./primitives/$email.ts\";\nexport * from \"./providers/EmailProvider.ts\";\nexport * from \"./providers/LocalEmailProvider.ts\";\nexport * from \"./providers/MemoryEmailProvider.ts\";\nexport * from \"./providers/NodemailerEmailProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha\" {\n  interface Hooks {\n    \"email:sending\": {\n      to: string | string[];\n      template: string;\n      variables: Record<string, unknown>;\n      provider: EmailProvider;\n      abort(): void;\n    };\n    \"email:sent\": {\n      to: string | string[];\n      template: string;\n      provider: EmailProvider;\n    };\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Provides email sending capabilities for Alepha applications with multiple provider backends.\n *\n * The email module enables declarative email sending through the `$email` primitive, allowing you to send\n * emails through different providers: memory (for testing), local file system, or SMTP via Nodemailer.\n * It supports HTML email content and automatic provider selection based on environment configuration.\n *\n * @see {@link EmailProvider}\n * @module alepha.email\n */\nexport const AlephaEmail = $module({\n  name: \"alepha.email\",\n  primitives: [$email],\n  services: [\n    EmailProvider,\n    MemoryEmailProvider,\n    LocalEmailProvider,\n    NodemailerEmailProvider,\n  ],\n  register: (alepha) => {\n    if (alepha.isTest()) {\n      alepha.with({\n        optional: true,\n        provide: EmailProvider,\n        use: MemoryEmailProvider,\n      });\n    } else if (alepha.env.EMAIL_HOST) {\n      alepha.with({\n        optional: true,\n        provide: EmailProvider,\n        use: NodemailerEmailProvider,\n      });\n    } else {\n      if (alepha.isServerless()) {\n        alepha.with({\n          optional: true,\n          provide: EmailProvider,\n          use: MemoryEmailProvider,\n        });\n      } else {\n        alepha.with({\n          optional: true,\n          provide: EmailProvider,\n          use: LocalEmailProvider,\n        });\n      }\n    }\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/email/providers/EmailProvider.ts","../../src/email/providers/MemoryEmailProvider.ts","../../src/email/primitives/$email.ts","../../src/email/errors/EmailError.ts","../../src/email/providers/LocalEmailProvider.ts","../../src/email/providers/NodemailerEmailProvider.ts","../../src/email/index.ts"],"sourcesContent":["/**\n * Email provider interface.\n *\n * All methods are asynchronous and return promises.\n */\nexport abstract class EmailProvider {\n  /**\n   * Send an email.\n   *\n   * @return Promise that resolves when the email is sent.\n   */\n  public abstract send(options: EmailSendOptions): Promise<void>;\n}\n\nexport type EmailSendOptions = {\n  to: string | string[];\n  subject: string;\n  body: string;\n};\n","import { $logger } from \"alepha/logger\";\nimport type { EmailProvider, EmailSendOptions } from \"./EmailProvider.ts\";\n\nexport interface EmailRecord {\n  to: string;\n  subject: string;\n  body: string;\n  sentAt: Date;\n}\n\nexport class MemoryEmailProvider implements EmailProvider {\n  protected readonly log = $logger();\n  public records: EmailRecord[] = [];\n\n  public async send(options: EmailSendOptions): Promise<void> {\n    const { to, subject, body } = options;\n    this.log.debug(\"Sending email to memory store\", { to, subject });\n\n    for (const recipient of Array.isArray(to) ? to : [to]) {\n      this.records.push({\n        to: recipient,\n        subject,\n        body,\n        sentAt: new Date(),\n      });\n    }\n  }\n\n  /**\n   * Get the last email sent (for testing purposes).\n   */\n  public get last(): EmailRecord | undefined {\n    return this.records[this.records.length - 1];\n  }\n}\n","import {\n  createPrimitive,\n  type InstantiableClass,\n  KIND,\n  Primitive,\n} from \"alepha\";\nimport type { EmailSendOptions } from \"../providers/EmailProvider.ts\";\nimport { EmailProvider } from \"../providers/EmailProvider.ts\";\nimport { MemoryEmailProvider } from \"../providers/MemoryEmailProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport const $email = (options: EmailPrimitiveOptions = {}) =>\n  createPrimitive(EmailPrimitive, options);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface EmailPrimitiveOptions {\n  name?: string;\n  provider?: InstantiableClass<EmailProvider> | \"memory\";\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Email primitive for sending emails through various providers.\n *\n * Usage:\n * ```typescript\n * class MyService {\n *   private readonly welcomeEmail = $email({ name: \"welcome\" });\n *\n *   async sendWelcome(userEmail: string, userName: string) {\n *     await this.welcomeEmail.send({\n *       to: userEmail,\n *       subject: \"Welcome!\",\n *       body: `<p>Hello ${userName}!</p>`\n *     });\n *   }\n * }\n * ```\n */\nexport class EmailPrimitive extends Primitive<EmailPrimitiveOptions> {\n  protected readonly provider = this.$provider();\n\n  public get name() {\n    return this.options.name ?? `${this.config.propertyKey}`;\n  }\n\n  /**\n   * Send an email using the configured provider.\n   */\n  public async send(options: EmailSendOptions): Promise<void> {\n    await this.alepha.events.emit(\"email:sending\", {\n      to: options.to,\n      template: this.name,\n      variables: {},\n      provider: this.provider,\n      abort: () => {\n        throw new Error(\"Email sending aborted by hook\");\n      },\n    });\n\n    await this.provider.send(options);\n\n    await this.alepha.events.emit(\"email:sent\", {\n      to: options.to,\n      template: this.name,\n      provider: this.provider,\n    });\n  }\n\n  protected $provider(): EmailProvider {\n    if (!this.options.provider) {\n      return this.alepha.inject(EmailProvider);\n    }\n    if (this.options.provider === \"memory\") {\n      return this.alepha.inject(MemoryEmailProvider);\n    }\n    return this.alepha.inject(this.options.provider);\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n$email[KIND] = EmailPrimitive;\n","export class EmailError extends Error {\n  constructor(message: string, cause?: Error) {\n    super(message);\n    this.name = \"EmailError\";\n    this.cause = cause;\n  }\n}\n","import { $atom, $hook, $inject, $use, type Static, t } from \"alepha\";\nimport { FileSystemProvider } from \"alepha/file\";\nimport { $logger } from \"alepha/logger\";\nimport { EmailError } from \"../errors/EmailError.ts\";\nimport type { EmailProvider, EmailSendOptions } from \"./EmailProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Local email provider configuration atom\n */\nexport const localEmailOptions = $atom({\n  name: \"alepha.email.local.options\",\n  schema: t.object({\n    directory: t.string({\n      description: \"Directory path where email files will be stored\",\n    }),\n  }),\n  default: {\n    directory: \"node_modules/.alepha/emails\",\n  },\n});\n\nexport type LocalEmailProviderOptions = Static<typeof localEmailOptions.schema>;\n\ndeclare module \"alepha\" {\n  interface State {\n    [localEmailOptions.key]: LocalEmailProviderOptions;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class LocalEmailProvider implements EmailProvider {\n  protected readonly log = $logger();\n  protected readonly fs = $inject(FileSystemProvider);\n  protected readonly options = $use(localEmailOptions);\n\n  protected get directory(): string {\n    return this.options.directory;\n  }\n\n  protected onStart = $hook({\n    on: \"start\",\n    handler: async () => {\n      try {\n        await this.fs.mkdir(this.directory, { recursive: true });\n        this.log.info(\"Email directory OK\", {\n          directory: this.directory,\n        });\n      } catch (error) {\n        const message = `Failed to create email directory: ${error instanceof Error ? error.message : String(error)}`;\n        this.log.error(message, { directory: this.directory });\n        throw new EmailError(\n          message,\n          error instanceof Error ? error : undefined,\n        );\n      }\n    },\n  });\n\n  public async send(options: EmailSendOptions): Promise<void> {\n    const { to, subject, body } = options;\n\n    this.log.debug(\"Sending email to local file\", {\n      to,\n      subject,\n      directory: this.directory,\n    });\n\n    try {\n      // Create filename: emailcontact+date\n      const timestamp = new Date().toISOString().replace(/[:.]/g, \"-\");\n      for (const recipient of Array.isArray(to) ? to : [to]) {\n        const sanitizedEmail = recipient.replace(/[^a-zA-Z0-9@.-]/g, \"_\");\n        const filename = `${sanitizedEmail}+${timestamp}.html`;\n        const filepath = this.fs.join(this.directory, filename);\n\n        // Create HTML content\n        const htmlContent = this.createEmailHtml({\n          to: recipient,\n          subject,\n          body,\n        });\n\n        // Write to file\n        await this.fs.writeFile(filepath, htmlContent);\n\n        this.log.info(\"Email saved to local file\", { filepath, to, subject });\n      }\n    } catch (error) {\n      const message = `Failed to save email to local file: ${error instanceof Error ? error.message : String(error)}`;\n      this.log.error(message, { to, subject, directory: this.directory });\n      throw new EmailError(message, error instanceof Error ? error : undefined);\n    }\n  }\n\n  public createEmailHtml(options: {\n    to: string;\n    subject: string;\n    body: string;\n  }): string {\n    const { to, subject, body } = options;\n    const timestamp = new Date().toISOString();\n\n    return `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n    <meta charset=\"UTF-8\">\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n    <title>${this.escapeHtml(subject)}</title>\n    <style>\n        body { font-family: Arial, sans-serif; margin: 20px; }\n        .email-header { background-color: #f5f5f5; padding: 15px; border-radius: 5px; margin-bottom: 20px; }\n        .email-body { background-color: #ffffff; padding: 15px; border: 1px solid #ddd; border-radius: 5px; }\n        .meta { font-size: 12px; color: #666; margin-bottom: 10px; }\n    </style>\n</head>\n<body>\n    <div class=\"email-header\">\n        <div class=\"meta\">Sent: ${timestamp}</div>\n        <div class=\"meta\">To: ${this.escapeHtml(to)}</div>\n        <h1>${this.escapeHtml(subject)}</h1>\n    </div>\n    <div class=\"email-body\">\n        ${body}\n    </div>\n</body>\n</html>`;\n  }\n\n  public escapeHtml(text: string): string {\n    return text\n      .replace(/&/g, \"&amp;\")\n      .replace(/</g, \"&lt;\")\n      .replace(/>/g, \"&gt;\")\n      .replace(/\"/g, \"&quot;\")\n      .replace(/'/g, \"&#39;\");\n  }\n}\n","import { $atom, $env, $hook, $use, type Static, t } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport type { Transporter } from \"nodemailer\";\nimport nodemailer from \"nodemailer\";\nimport { EmailError } from \"../errors/EmailError.ts\";\nimport type { EmailProvider, EmailSendOptions } from \"./EmailProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Environment variables for nodemailer configuration\n */\nconst envSchema = t.object({\n  EMAIL_HOST: t.optional(\n    t.text({\n      description: \"SMTP server host\",\n    }),\n  ),\n  EMAIL_PORT: t.number({\n    default: 587,\n    description: \"SMTP server port\",\n  }),\n  EMAIL_USER: t.optional(\n    t.text({\n      description: \"SMTP authentication username\",\n    }),\n  ),\n  EMAIL_PASS: t.optional(\n    t.text({\n      description: \"SMTP authentication password\",\n    }),\n  ),\n  EMAIL_FROM: t.optional(\n    t.text({\n      description: \"Default from email address\",\n    }),\n  ),\n  EMAIL_SECURE: t.boolean({\n    default: false,\n    description: \"Use secure connection (TLS)\",\n  }),\n});\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Nodemailer connection pooling and rate limiting options\n */\nexport const nodemailerEmailOptions = $atom({\n  name: \"alepha.email.nodemailer.options\",\n  schema: t.object({\n    pool: t.optional(\n      t.boolean({\n        description: \"Enable connection pooling\",\n      }),\n    ),\n    maxConnections: t.optional(\n      t.number({\n        description: \"Maximum number of connections in pool\",\n      }),\n    ),\n    maxMessages: t.optional(\n      t.number({\n        description: \"Maximum messages per connection\",\n      }),\n    ),\n    rateDelta: t.optional(\n      t.number({\n        description: \"Time in milliseconds between message sends\",\n      }),\n    ),\n    rateLimit: t.optional(\n      t.number({\n        description: \"Maximum number of messages per rateDelta\",\n      }),\n    ),\n  }),\n  default: {},\n});\n\nexport type NodemailerEmailProviderOptions = Static<\n  typeof nodemailerEmailOptions.schema\n>;\n\ndeclare module \"alepha\" {\n  interface State {\n    [nodemailerEmailOptions.key]: NodemailerEmailProviderOptions;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Email provider using Nodemailer for SMTP transport.\n *\n * Configuration is provided via environment variables:\n * - EMAIL_HOST: SMTP server host\n * - EMAIL_PORT: SMTP server port (default: 587)\n * - EMAIL_USER: SMTP authentication username\n * - EMAIL_PASS: SMTP authentication password\n * - EMAIL_FROM: Default from email address\n * - EMAIL_SECURE: Use secure connection (default: false)\n *\n * Advanced pooling/rate limiting options can be configured via atom:\n * @see {@link nodemailerEmailOptions}\n *\n * @example\n * ```typescript\n * // Configure via environment variables\n * // EMAIL_HOST=smtp.example.com\n * // EMAIL_PORT=587\n * // EMAIL_USER=user@example.com\n * // EMAIL_PASS=secret\n * // EMAIL_FROM=noreply@example.com\n *\n * // Optionally configure pooling via atom\n * alepha.state.set(nodemailerEmailOptions.key, {\n *   pool: true,\n *   maxConnections: 5,\n *   rateLimit: 10,\n * });\n * ```\n */\nexport class NodemailerEmailProvider implements EmailProvider {\n  protected readonly env = $env(envSchema);\n  protected readonly log = $logger();\n  protected readonly options = $use(nodemailerEmailOptions);\n  protected transporter: Transporter | null = null;\n\n  protected get host(): string {\n    const host = this.env.EMAIL_HOST;\n    if (!host) {\n      throw new EmailError(\n        \"Email host not configured. Set EMAIL_HOST env var.\",\n      );\n    }\n    return host;\n  }\n\n  protected get port(): number {\n    return this.env.EMAIL_PORT;\n  }\n\n  protected get secure(): boolean {\n    return this.env.EMAIL_SECURE;\n  }\n\n  protected get user(): string | undefined {\n    return this.env.EMAIL_USER;\n  }\n\n  protected get pass(): string | undefined {\n    return this.env.EMAIL_PASS;\n  }\n\n  protected get fromAddress(): string {\n    const from = this.env.EMAIL_FROM;\n    if (!from) {\n      throw new EmailError(\n        \"Email from address not configured. Set EMAIL_FROM env var.\",\n      );\n    }\n    return from;\n  }\n\n  protected getTransporter(): Transporter {\n    if (!this.transporter) {\n      this.transporter = this.createTransporter();\n    }\n    return this.transporter;\n  }\n\n  public async send(options: EmailSendOptions): Promise<void> {\n    const { to, subject, body } = options;\n    this.log.debug(\"Sending email via Nodemailer\", { to, subject });\n\n    try {\n      const result = await this.getTransporter().sendMail({\n        from: this.fromAddress,\n        to,\n        subject,\n        html: body,\n      });\n\n      this.log.info(\"Email sent successfully\", {\n        to,\n        subject,\n        messageId: result.messageId,\n        response: result.response,\n      });\n    } catch (error) {\n      const message = `Failed to send email via Nodemailer: ${error instanceof Error ? error.message : String(error)}`;\n      this.log.error(message, { to, subject });\n      throw new EmailError(message, error instanceof Error ? error : undefined);\n    }\n  }\n\n  protected createTransporter(): Transporter {\n    const transporterConfig = {\n      host: this.host,\n      port: this.port,\n      secure: this.secure,\n      auth:\n        this.user && this.pass\n          ? {\n              user: this.user,\n              pass: this.pass,\n            }\n          : undefined,\n      pool: this.options.pool,\n      maxConnections: this.options.maxConnections,\n      maxMessages: this.options.maxMessages,\n      rateDelta: this.options.rateDelta,\n      rateLimit: this.options.rateLimit,\n    };\n\n    this.log.debug(\"Creating Nodemailer transporter\", {\n      host: transporterConfig.host,\n      port: transporterConfig.port,\n      secure: transporterConfig.secure,\n      user: transporterConfig.auth?.user,\n      pool: transporterConfig.pool,\n    });\n\n    return nodemailer.createTransport(transporterConfig);\n  }\n\n  /**\n   * Verify the connection to the email server.\n   */\n  public async verify(): Promise<boolean> {\n    try {\n      await this.getTransporter().verify();\n      this.log.info(\"Email server connection verified\");\n      return true;\n    } catch (error) {\n      this.log.error(\"Email server connection failed\", { error });\n      return false;\n    }\n  }\n\n  /**\n   * Close the transporter connection.\n   */\n  public close(): void {\n    if (this.transporter) {\n      this.transporter.close();\n      this.transporter = null;\n    }\n  }\n\n  protected readonly onStart = $hook({\n    on: \"start\",\n    handler: () => this.verify(),\n  });\n\n  protected readonly onStop = $hook({\n    on: \"stop\",\n    handler: () => this.close(),\n  });\n}\n","import { $module } from \"alepha\";\nimport { $email } from \"./primitives/$email.ts\";\nimport { EmailProvider } from \"./providers/EmailProvider.ts\";\nimport { LocalEmailProvider } from \"./providers/LocalEmailProvider.ts\";\nimport { MemoryEmailProvider } from \"./providers/MemoryEmailProvider.ts\";\nimport { NodemailerEmailProvider } from \"./providers/NodemailerEmailProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./errors/EmailError.ts\";\nexport * from \"./primitives/$email.ts\";\nexport * from \"./providers/EmailProvider.ts\";\nexport * from \"./providers/LocalEmailProvider.ts\";\nexport * from \"./providers/MemoryEmailProvider.ts\";\nexport * from \"./providers/NodemailerEmailProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha\" {\n  interface Hooks {\n    \"email:sending\": {\n      to: string | string[];\n      template: string;\n      variables: Record<string, unknown>;\n      provider: EmailProvider;\n      abort(): void;\n    };\n    \"email:sent\": {\n      to: string | string[];\n      template: string;\n      provider: EmailProvider;\n    };\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Provides email sending capabilities for Alepha applications with multiple provider backends.\n *\n * The email module enables declarative email sending through the `$email` primitive, allowing you to send\n * emails through different providers: memory (for testing), local file system, or SMTP via Nodemailer.\n * It supports HTML email content and automatic provider selection based on environment configuration.\n *\n * @see {@link EmailProvider}\n * @module alepha.email\n */\nexport const AlephaEmail = $module({\n  name: \"alepha.email\",\n  primitives: [$email],\n  services: [\n    EmailProvider,\n    MemoryEmailProvider,\n    LocalEmailProvider,\n    NodemailerEmailProvider,\n  ],\n  register: (alepha) => {\n    if (alepha.isTest()) {\n      alepha.with({\n        optional: true,\n        provide: EmailProvider,\n        use: MemoryEmailProvider,\n      });\n    } else if (alepha.env.EMAIL_HOST) {\n      alepha.with({\n        optional: true,\n        provide: EmailProvider,\n        use: NodemailerEmailProvider,\n      });\n    } else {\n      if (alepha.isServerless()) {\n        alepha.with({\n          optional: true,\n          provide: EmailProvider,\n          use: MemoryEmailProvider,\n        });\n      } else {\n        alepha.with({\n          optional: true,\n          provide: EmailProvider,\n          use: LocalEmailProvider,\n        });\n      }\n    }\n  },\n});\n"],"mappings":"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"}