alepha 0.23.0 → 0.24.0

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

@@ -1,6 +1,5 @@
 import { AlephaError, InstantiableClass, KIND, Primitive, Static } from "alepha";
 import { FileSystemProvider } from "alepha/system";
-
 //#region ../../src/email/core/providers/EmailProvider.d.ts
 /**
  * Email provider interface.
@@ -38,10 +37,14 @@ interface EmailPrimitiveOptions {
 /**
  * Email primitive for sending emails through various providers.
  *
+ * The primitive's `name` identifies the channel in the `email:sending` /
+ * `email:sent` hooks; it does not select a template — `send()` expects an
+ * already-rendered `subject` and `body`.
+ *
  * Usage:
  * ```typescript
  * class MyService {
- *   private readonly welcomeEmail = $email({ name: "welcome" });
+ *   protected readonly welcomeEmail = $email({ name: "welcome" });
  *
  *   async sendWelcome(userEmail: string, userName: string) {
  *     await this.welcomeEmail.send({
@@ -67,9 +70,9 @@ declare class EmailPrimitive extends Primitive<EmailPrimitiveOptions> {
 /**
  * Local email provider configuration atom
  */
-declare const localEmailOptions: import("alepha").Atom<import("typebox").TObject<{
-  directory: import("typebox").TString;
-}>, "alepha.email.local.options">;
+declare const localEmailOptions: import("alepha").Atom<import("zod").ZodObject<{
+  directory: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, "alepha.email.local.options">;
 type LocalEmailProviderOptions = Static<typeof localEmailOptions.schema>;
 declare module "alepha" {
   interface State {
@@ -132,14 +135,19 @@ declare module "alepha" {
   }
 }
 /**
- * Email delivery with template support.
+ * Email delivery over pluggable providers.
  *
  * **Features:**
- * - Send emails with templates
+ * - `$email` declares a named send channel; the name is surfaced to the
+ *   `email:sending` / `email:sent` hooks (as their `template` field) for
+ *   auditing and interception
  * - Multiple recipients
  * - Local file provider for development
  * - Memory provider for testing
  *
+ * There is **no template rendering**: `send()` takes an already-rendered
+ * `subject` and `body` — bring your own templating if you need it.
+ *
  * For SMTP support, use `AlephaEmailSmtp` from `alepha/email/smtp`.
  * For Brevo support, use `AlephaEmailBrevo` from `alepha/email/brevo`.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/email/core/providers/EmailProvider.ts","../../../src/email/core/errors/EmailError.ts","../../../src/email/core/primitives/$email.ts","../../../src/email/core/providers/LocalEmailProvider.ts","../../../src/email/core/providers/MemoryEmailProvider.ts","../../../src/email/core/index.ts"],"mappings":";;;;;;;;AAKA;uBAAsB,aAAA;;;;;;WAMJ,IAAA,CAAK,OAAA,EAAS,gBAAA,GAAmB,OAAO;AAAA;AAAA,KAG9C,gBAAA;EACV,EAAA;EACA,OAAA;EACA,IAAA;AAAA;;;cCfW,UAAA,SAAmB,WAAW;cAC7B,OAAA,UAAiB,KAAA,GAAQ,KAAA;AAAA;;;cCU1B,MAAA;EAAA,WAAmB,qBAAA,GAAqB,cAAA;EAAA;;UAKpC,qBAAA;EACf,IAAA;EACA,QAAA,GAAW,iBAAiB,CAAC,aAAA;AAAA;;;AFT2B;AAG1D;;;;;;;;AAGM;;;;ACfN;;;cCyCa,cAAA,SAAuB,SAAA,CAAU,qBAAA;EAAA,mBACzB,QAAA,EAAQ,aAAA;EAAA,IAEhB,IAAA;ED3CC;;;ECkDC,IAAA,CAAK,OAAA,EAAS,gBAAA,GAAmB,OAAA;EAAA,UAoBpC,SAAA,IAAa,aAAA;AAAA;;;;AFpEzB;;cGMa,iBAAA,mBAAiB,IAAA,mBAAA,OAAA;;;KAYlB,yBAAA,GAA4B,MAAM,QAAQ,iBAAA,CAAkB,MAAA;AAAA;EAAA,UAG5D,KAAA;IAAA,CACP,iBAAA,CAAkB,GAAG,GAAG,yBAAA;EAAA;AAAA;AAAA,cAMhB,kBAAA,YAA8B,aAAA;EAAA,mBACtB,GAAA,0BAAG,MAAA;EAAA,mBACH,EAAA,EAAE,kBAAA;EAAA,mBACF,OAAA,EAAO,QAAA;;;gBAEZ,SAAA;EAAA,UAIJ,OAAA,mBAAO,aAAA;EAmBJ,IAAA,CAAK,OAAA,EAAS,gBAAA,GAAmB,OAAA;EA4BvC,eAAA,CAAgB,OAAA;IACrB,EAAA;IACA,OAAA;IACA,IAAA;EAAA;IACI,EAAA;IAAY,OAAA;IAAiB,IAAA;IAAc,MAAA;EAAA;AAAA;;;UC1FlC,WAAA;EACf,EAAA;EACA,OAAA;EACA,IAAA;EACA,MAAA,EAAQ,IAAI;AAAA;AAAA,cAGD,mBAAA,YAA+B,aAAA;EAAA,mBACvB,GAAA,0BAAG,MAAA;EACf,OAAA,EAAS,WAAA;EAEH,IAAA,CAAK,OAAA,EAAS,gBAAA,GAAmB,OAAA;EJHG;;AAAO;EAAP,IIoBtC,IAAA,IAAQ,WAAA;AAAA;;;;YChBT,KAAA;IACR,eAAA;MACE,EAAA;MACA,QAAA;MACA,SAAA,EAAW,MAAA;MACX,QAAA,EAAU,aAAA;MACV,KAAA;IAAA;IAEF,YAAA;MACE,EAAA;MACA,QAAA;MACA,QAAA,EAAU,aAAA;IAAA;EAAA;AAAA;ALTV;;;;ACfN;;;;;;;;;;ADeM,cK4BO,WAAA,mBAAW,OAAA,kBAAA,MAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/email/core/providers/EmailProvider.ts","../../../src/email/core/errors/EmailError.ts","../../../src/email/core/primitives/$email.ts","../../../src/email/core/providers/LocalEmailProvider.ts","../../../src/email/core/providers/MemoryEmailProvider.ts","../../../src/email/core/index.ts"],"mappings":";;;;;;;;uBAKsB;;;;;;WAMJ,KAAK,SAAS,mBAAmB;;KAGvC;EACV;EACA;EACA;;;;cCfW,mBAAmB;EAC9B,YAAY,iBAAiB,QAAQ;;;;cCU1B;aAAmB,wBAAqB;;;UAKpC;EACf;EACA,WAAW,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;cA2BlB,uBAAuB,UAAU;qBACzB,UAAQ;MAEhB;;;;EAOE,KAAK,SAAS,mBAAmB;YAoBpC,aAAa;;;;;;;cClEZ,oCAAiB,mBAAA;;;KAYlB,4BAA4B,cAAc,kBAAkB;;YAG5D;KACP,kBAAkB,MAAM;;;cAMhB,8BAA8B;qBACtB,6BAAG;qBACH,IAAE;qBACF,SAAO;;;gBAEZ;YAIJ,0BAAO;EAmBJ,KAAK,SAAS,mBAAmB;EA4BvC,gBAAgB;IACrB;IACA;IACA;;IACI;IAAY;IAAiB;IAAc;;;;;UC1FlC;EACf;EACA;EACA;EACA,QAAQ;;cAGG,+BAA+B;qBACvB,6BAAG;EACf,SAAS;EAEH,KAAK,SAAS,mBAAmB;;;;MAiBnC,QAAQ;;;;;YChBT;IACR;MACE;MACA;MACA,WAAW;MACX,UAAU;MACV;;IAEF;MACE;MACA;MACA,UAAU;;;;;;;;;;;;;;;;;;;;;;;cAwBH,8BAAW,yBAAA"}

package/dist/email/core/index.js

@@ -1,4 +1,4 @@
-import { $atom, $hook, $inject, $module, $state, AlephaError, KIND, Primitive, createPrimitive, t } from "alepha";
+import { $atom, $hook, $inject, $module, $state, AlephaError, KIND, Primitive, createPrimitive, z } from "alepha";
 import { $logger } from "alepha/logger";
 import { FileSystemProvider } from "alepha/system";
 //#region ../../src/email/core/providers/EmailProvider.ts
@@ -39,10 +39,14 @@ const $email = (options = {}) => createPrimitive(EmailPrimitive, options);
 /**
 * Email primitive for sending emails through various providers.
 *
+* The primitive's `name` identifies the channel in the `email:sending` /
+* `email:sent` hooks; it does not select a template — `send()` expects an
+* already-rendered `subject` and `body`.
+*
 * Usage:
 * ```typescript
 * class MyService {
-*   private readonly welcomeEmail = $email({ name: "welcome" });
+*   protected readonly welcomeEmail = $email({ name: "welcome" });
 *
 *   async sendWelcome(userEmail: string, userName: string) {
 *     await this.welcomeEmail.send({
@@ -102,7 +106,7 @@ var EmailError = class extends AlephaError {
 */
 const localEmailOptions = $atom({
 	name: "alepha.email.local.options",
-	schema: t.object({ directory: t.string({ description: "Directory path where email files will be stored" }) }),
+	schema: z.object({ directory: z.string().describe("Directory path where email files will be stored") }),
 	default: { directory: "node_modules/.alepha/emails" }
 });
 var LocalEmailProvider = class {
@@ -171,14 +175,19 @@ var LocalEmailProvider = class {
 //#endregion
 //#region ../../src/email/core/index.ts
 /**
-* Email delivery with template support.
+* Email delivery over pluggable providers.
 *
 * **Features:**
-* - Send emails with templates
+* - `$email` declares a named send channel; the name is surfaced to the
+*   `email:sending` / `email:sent` hooks (as their `template` field) for
+*   auditing and interception
 * - Multiple recipients
 * - Local file provider for development
 * - Memory provider for testing
 *
+* There is **no template rendering**: `send()` takes an already-rendered
+* `subject` and `body` — bring your own templating if you need it.
+*
 * For SMTP support, use `AlephaEmailSmtp` from `alepha/email/smtp`.
 * For Brevo support, use `AlephaEmailBrevo` from `alepha/email/brevo`.
 *

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/email/core/providers/EmailProvider.ts","../../../src/email/core/providers/MemoryEmailProvider.ts","../../../src/email/core/primitives/$email.ts","../../../src/email/core/errors/EmailError.ts","../../../src/email/core/providers/LocalEmailProvider.ts","../../../src/email/core/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  AlephaError,\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 AlephaError(\"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","import { AlephaError } from \"alepha\";\n\nexport class EmailError extends AlephaError {\n  constructor(message: string, cause?: Error) {\n    super(message);\n    this.name = \"EmailError\";\n    this.cause = cause;\n  }\n}\n","import { $atom, $hook, $inject, $state, type Static, t } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { FileSystemProvider } from \"alepha/system\";\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 = $state(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          at: 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, { at: 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      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}.eml.json`;\n        const filepath = this.fs.join(this.directory, filename);\n\n        const content = this.createEmailJson({ to: recipient, subject, body });\n        await this.fs.writeFile(filepath, JSON.stringify(content, null, 2));\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 createEmailJson(options: {\n    to: string;\n    subject: string;\n    body: string;\n  }): { to: string; subject: string; body: string; sentAt: string } {\n    return {\n      to: options.to,\n      subject: options.subject,\n      body: options.body,\n      sentAt: new Date().toISOString(),\n    };\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\";\n\n// Exports\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\";\n\n// Hook declarations\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 * Email delivery with template support.\n *\n * **Features:**\n * - Send emails with templates\n * - Multiple recipients\n * - Local file provider for development\n * - Memory provider for testing\n *\n * For SMTP support, use `AlephaEmailSmtp` from `alepha/email/smtp`.\n * For Brevo support, use `AlephaEmailBrevo` from `alepha/email/brevo`.\n *\n * @module alepha.email\n */\nexport const AlephaEmail = $module({\n  name: \"alepha.email\",\n  primitives: [$email],\n  services: [EmailProvider],\n  variants: [MemoryEmailProvider, LocalEmailProvider],\n  register: (alepha) => {\n    if (alepha.isTest()) {\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"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/email/core/providers/EmailProvider.ts","../../../src/email/core/providers/MemoryEmailProvider.ts","../../../src/email/core/primitives/$email.ts","../../../src/email/core/errors/EmailError.ts","../../../src/email/core/providers/LocalEmailProvider.ts","../../../src/email/core/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  AlephaError,\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 * The primitive's `name` identifies the channel in the `email:sending` /\n * `email:sent` hooks; it does not select a template — `send()` expects an\n * already-rendered `subject` and `body`.\n *\n * Usage:\n * ```typescript\n * class MyService {\n *   protected 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 AlephaError(\"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","import { AlephaError } from \"alepha\";\n\nexport class EmailError extends AlephaError {\n  constructor(message: string, cause?: Error) {\n    super(message);\n    this.name = \"EmailError\";\n    this.cause = cause;\n  }\n}\n","import { $atom, $hook, $inject, $state, type Static, z } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { FileSystemProvider } from \"alepha/system\";\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: z.object({\n    directory: z\n      .string()\n      .describe(\"Directory path where email files will be stored\"),\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 = $state(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          at: 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, { at: 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      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}.eml.json`;\n        const filepath = this.fs.join(this.directory, filename);\n\n        const content = this.createEmailJson({ to: recipient, subject, body });\n        await this.fs.writeFile(filepath, JSON.stringify(content, null, 2));\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 createEmailJson(options: {\n    to: string;\n    subject: string;\n    body: string;\n  }): { to: string; subject: string; body: string; sentAt: string } {\n    return {\n      to: options.to,\n      subject: options.subject,\n      body: options.body,\n      sentAt: new Date().toISOString(),\n    };\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\";\n\n// Exports\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\";\n\n// Hook declarations\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 * Email delivery over pluggable providers.\n *\n * **Features:**\n * - `$email` declares a named send channel; the name is surfaced to the\n *   `email:sending` / `email:sent` hooks (as their `template` field) for\n *   auditing and interception\n * - Multiple recipients\n * - Local file provider for development\n * - Memory provider for testing\n *\n * There is **no template rendering**: `send()` takes an already-rendered\n * `subject` and `body` — bring your own templating if you need it.\n *\n * For SMTP support, use `AlephaEmailSmtp` from `alepha/email/smtp`.\n * For Brevo support, use `AlephaEmailBrevo` from `alepha/email/brevo`.\n *\n * @module alepha.email\n */\nexport const AlephaEmail = $module({\n  name: \"alepha.email\",\n  primitives: [$email],\n  services: [EmailProvider],\n  variants: [MemoryEmailProvider, LocalEmailProvider],\n  register: (alepha) => {\n    if (alepha.isTest()) {\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"],"mappings":"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"}

package/dist/email/core/index.workerd.js

@@ -38,10 +38,14 @@ const $email = (options = {}) => createPrimitive(EmailPrimitive, options);
 /**
 * Email primitive for sending emails through various providers.
 *
+* The primitive's `name` identifies the channel in the `email:sending` /
+* `email:sent` hooks; it does not select a template — `send()` expects an
+* already-rendered `subject` and `body`.
+*
 * Usage:
 * ```typescript
 * class MyService {
-*   private readonly welcomeEmail = $email({ name: "welcome" });
+*   protected readonly welcomeEmail = $email({ name: "welcome" });
 *
 *   async sendWelcome(userEmail: string, userName: string) {
 *     await this.welcomeEmail.send({

package/dist/email/core/index.workerd.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.workerd.js","names":[],"sources":["../../../src/email/core/providers/EmailProvider.ts","../../../src/email/core/providers/MemoryEmailProvider.ts","../../../src/email/core/primitives/$email.ts","../../../src/email/core/errors/EmailError.ts","../../../src/email/core/index.workerd.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  AlephaError,\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 AlephaError(\"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","import { AlephaError } from \"alepha\";\n\nexport class EmailError extends AlephaError {\n  constructor(message: string, cause?: Error) {\n    super(message);\n    this.name = \"EmailError\";\n    this.cause = cause;\n  }\n}\n","import { $module } from \"alepha\";\nimport { $email } from \"./primitives/$email.ts\";\nimport { EmailProvider } from \"./providers/EmailProvider.ts\";\nimport { MemoryEmailProvider } from \"./providers/MemoryEmailProvider.ts\";\n\n// Exports\nexport * from \"./errors/EmailError.ts\";\nexport * from \"./primitives/$email.ts\";\nexport * from \"./providers/EmailProvider.ts\";\nexport * from \"./providers/MemoryEmailProvider.ts\";\n\n/**\n * Email delivery for Cloudflare Workers.\n *\n * Uses Memory provider by default. For production email delivery,\n * add `AlephaEmailBrevo` from `alepha/email/brevo`.\n *\n * @module alepha.email\n */\nexport const AlephaEmail = $module({\n  name: \"alepha.email\",\n  primitives: [$email],\n  services: [EmailProvider, MemoryEmailProvider],\n  register: (alepha) => {\n    alepha.with({\n      optional: true,\n      provide: EmailProvider,\n      use: MemoryEmailProvider,\n    });\n  },\n});\n"],"mappings":";;;;;;;;AAKA,IAAsB,gBAAtB,MAAoC,CAOpC;;;ACFA,IAAa,sBAAb,MAA0D;CACxD,MAAyB,QAAQ;CACjC,UAAgC,CAAC;CAEjC,MAAa,KAAK,SAA0C;EAC1D,MAAM,EAAE,IAAI,SAAS,SAAS;EAC9B,KAAK,IAAI,MAAM,iCAAiC;GAAE;GAAI;EAAQ,CAAC;EAE/D,KAAK,MAAM,aAAa,MAAM,QAAQ,EAAE,IAAI,KAAK,CAAC,EAAE,GAClD,KAAK,QAAQ,KAAK;GAChB,IAAI;GACJ;GACA;GACA,wBAAQ,IAAI,KAAK;EACnB,CAAC;CAEL;;;;CAKA,IAAW,OAAgC;EACzC,OAAO,KAAK,QAAQ,KAAK,QAAQ,SAAS;CAC5C;AACF;;;ACrBA,MAAa,UAAU,UAAiC,CAAC,MACvD,gBAAgB,gBAAgB,OAAO;;;;;;;;;;;;;;;;;;;AA6BzC,IAAa,iBAAb,cAAoC,UAAiC;CACnE,WAA8B,KAAK,UAAU;CAE7C,IAAW,OAAO;EAChB,OAAO,KAAK,QAAQ,QAAQ,GAAG,KAAK,OAAO;CAC7C;;;;CAKA,MAAa,KAAK,SAA0C;EAC1D,MAAM,KAAK,OAAO,OAAO,KAAK,iBAAiB;GAC7C,IAAI,QAAQ;GACZ,UAAU,KAAK;GACf,WAAW,CAAC;GACZ,UAAU,KAAK;GACf,aAAa;IACX,MAAM,IAAI,YAAY,+BAA+B;GACvD;EACF,CAAC;EAED,MAAM,KAAK,SAAS,KAAK,OAAO;EAEhC,MAAM,KAAK,OAAO,OAAO,KAAK,cAAc;GAC1C,IAAI,QAAQ;GACZ,UAAU,KAAK;GACf,UAAU,KAAK;EACjB,CAAC;CACH;CAEA,YAAqC;EACnC,IAAI,CAAC,KAAK,QAAQ,UAChB,OAAO,KAAK,OAAO,OAAO,aAAa;EAEzC,IAAI,KAAK,QAAQ,aAAa,UAC5B,OAAO,KAAK,OAAO,OAAO,mBAAmB;EAE/C,OAAO,KAAK,OAAO,OAAO,KAAK,QAAQ,QAAQ;CACjD;AACF;AAIA,OAAO,QAAQ;;;ACpFf,IAAa,aAAb,cAAgC,YAAY;CAC1C,YAAY,SAAiB,OAAe;EAC1C,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,KAAK,QAAQ;CACf;AACF;;;;;;;;;;;ACWA,MAAa,cAAc,QAAQ;CACjC,MAAM;CACN,YAAY,CAAC,MAAM;CACnB,UAAU,CAAC,eAAe,mBAAmB;CAC7C,WAAW,WAAW;EACpB,OAAO,KAAK;GACV,UAAU;GACV,SAAS;GACT,KAAK;EACP,CAAC;CACH;AACF,CAAC"}
+{"version":3,"file":"index.workerd.js","names":[],"sources":["../../../src/email/core/providers/EmailProvider.ts","../../../src/email/core/providers/MemoryEmailProvider.ts","../../../src/email/core/primitives/$email.ts","../../../src/email/core/errors/EmailError.ts","../../../src/email/core/index.workerd.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  AlephaError,\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 * The primitive's `name` identifies the channel in the `email:sending` /\n * `email:sent` hooks; it does not select a template — `send()` expects an\n * already-rendered `subject` and `body`.\n *\n * Usage:\n * ```typescript\n * class MyService {\n *   protected 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 AlephaError(\"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","import { AlephaError } from \"alepha\";\n\nexport class EmailError extends AlephaError {\n  constructor(message: string, cause?: Error) {\n    super(message);\n    this.name = \"EmailError\";\n    this.cause = cause;\n  }\n}\n","import { $module } from \"alepha\";\nimport { $email } from \"./primitives/$email.ts\";\nimport { EmailProvider } from \"./providers/EmailProvider.ts\";\nimport { MemoryEmailProvider } from \"./providers/MemoryEmailProvider.ts\";\n\n// Exports\nexport * from \"./errors/EmailError.ts\";\nexport * from \"./primitives/$email.ts\";\nexport * from \"./providers/EmailProvider.ts\";\nexport * from \"./providers/MemoryEmailProvider.ts\";\n\n/**\n * Email delivery for Cloudflare Workers.\n *\n * Uses Memory provider by default. For production email delivery,\n * add `AlephaEmailBrevo` from `alepha/email/brevo`.\n *\n * @module alepha.email\n */\nexport const AlephaEmail = $module({\n  name: \"alepha.email\",\n  primitives: [$email],\n  services: [EmailProvider, MemoryEmailProvider],\n  register: (alepha) => {\n    alepha.with({\n      optional: true,\n      provide: EmailProvider,\n      use: MemoryEmailProvider,\n    });\n  },\n});\n"],"mappings":";;;;;;;;AAKA,IAAsB,gBAAtB,MAAoC,CAOpC;;;ACFA,IAAa,sBAAb,MAA0D;CACxD,MAAyB,QAAQ;CACjC,UAAgC,CAAC;CAEjC,MAAa,KAAK,SAA0C;EAC1D,MAAM,EAAE,IAAI,SAAS,SAAS;EAC9B,KAAK,IAAI,MAAM,iCAAiC;GAAE;GAAI;EAAQ,CAAC;EAE/D,KAAK,MAAM,aAAa,MAAM,QAAQ,EAAE,IAAI,KAAK,CAAC,EAAE,GAClD,KAAK,QAAQ,KAAK;GAChB,IAAI;GACJ;GACA;GACA,wBAAQ,IAAI,KAAK;EACnB,CAAC;CAEL;;;;CAKA,IAAW,OAAgC;EACzC,OAAO,KAAK,QAAQ,KAAK,QAAQ,SAAS;CAC5C;AACF;;;ACrBA,MAAa,UAAU,UAAiC,CAAC,MACvD,gBAAgB,gBAAgB,OAAO;;;;;;;;;;;;;;;;;;;;;;;AAiCzC,IAAa,iBAAb,cAAoC,UAAiC;CACnE,WAA8B,KAAK,UAAU;CAE7C,IAAW,OAAO;EAChB,OAAO,KAAK,QAAQ,QAAQ,GAAG,KAAK,OAAO;CAC7C;;;;CAKA,MAAa,KAAK,SAA0C;EAC1D,MAAM,KAAK,OAAO,OAAO,KAAK,iBAAiB;GAC7C,IAAI,QAAQ;GACZ,UAAU,KAAK;GACf,WAAW,CAAC;GACZ,UAAU,KAAK;GACf,aAAa;IACX,MAAM,IAAI,YAAY,+BAA+B;GACvD;EACF,CAAC;EAED,MAAM,KAAK,SAAS,KAAK,OAAO;EAEhC,MAAM,KAAK,OAAO,OAAO,KAAK,cAAc;GAC1C,IAAI,QAAQ;GACZ,UAAU,KAAK;GACf,UAAU,KAAK;EACjB,CAAC;CACH;CAEA,YAAqC;EACnC,IAAI,CAAC,KAAK,QAAQ,UAChB,OAAO,KAAK,OAAO,OAAO,aAAa;EAEzC,IAAI,KAAK,QAAQ,aAAa,UAC5B,OAAO,KAAK,OAAO,OAAO,mBAAmB;EAE/C,OAAO,KAAK,OAAO,OAAO,KAAK,QAAQ,QAAQ;CACjD;AACF;AAIA,OAAO,QAAQ;;;ACxFf,IAAa,aAAb,cAAgC,YAAY;CAC1C,YAAY,SAAiB,OAAe;EAC1C,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,KAAK,QAAQ;CACf;AACF;;;;;;;;;;;ACWA,MAAa,cAAc,QAAQ;CACjC,MAAM;CACN,YAAY,CAAC,MAAM;CACnB,UAAU,CAAC,eAAe,mBAAmB;CAC7C,WAAW,WAAW;EACpB,OAAO,KAAK;GACV,UAAU;GACV,SAAS;GACT,KAAK;EACP,CAAC;CACH;AACF,CAAC"}

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

@@ -1,18 +1,17 @@
 import { Static } from "alepha";
 import { EmailProvider, EmailSendOptions } from "alepha/email";
 import { Transporter } from "nodemailer";
-
 //#region ../../src/email/smtp/providers/NodemailerEmailProvider.d.ts
 /**
  * Nodemailer connection pooling and rate limiting options
  */
-declare const nodemailerEmailOptions: import("alepha").Atom<import("typebox").TObject<{
-  pool: import("typebox").TOptional<import("typebox").TBoolean>;
-  maxConnections: import("typebox").TOptional<import("typebox").TNumber>;
-  maxMessages: import("typebox").TOptional<import("typebox").TNumber>;
-  rateDelta: import("typebox").TOptional<import("typebox").TNumber>;
-  rateLimit: import("typebox").TOptional<import("typebox").TNumber>;
-}>, "alepha.email.nodemailer.options">;
+declare const nodemailerEmailOptions: import("alepha").Atom<import("zod").ZodObject<{
+  pool: import("zod").ZodOptional<import("zod").ZodBoolean>;
+  maxConnections: import("zod").ZodOptional<import("zod").ZodNumber>;
+  maxMessages: import("zod").ZodOptional<import("zod").ZodNumber>;
+  rateDelta: import("zod").ZodOptional<import("zod").ZodNumber>;
+  rateLimit: import("zod").ZodOptional<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, "alepha.email.nodemailer.options">;
 type NodemailerEmailProviderOptions = Static<typeof nodemailerEmailOptions.schema>;
 declare module "alepha" {
   interface State {
@@ -53,10 +52,10 @@ declare module "alepha" {
 declare class NodemailerEmailProvider implements EmailProvider {
   protected readonly env: {
     EMAIL_HOST?: string | undefined;
+    EMAIL_PORT: number;
     EMAIL_USER?: string | undefined;
     EMAIL_PASS?: string | undefined;
     EMAIL_FROM?: string | undefined;
-    EMAIL_PORT: number;
     EMAIL_SECURE: boolean;
   };
   protected readonly log: import("alepha/logger").Logger;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/email/smtp/providers/NodemailerEmailProvider.ts","../../../src/email/smtp/index.ts"],"mappings":";;;;;;;AAmDA;cAAa,sBAAA,mBAAsB,IAAA,mBAAA,OAAA;;;;;;;KAgCvB,8BAAA,GAAiC,MAAM,QAC1C,sBAAA,CAAuB,MAAA;AAAA;EAAA,UAIpB,KAAA;IAAA,CACP,sBAAA,CAAuB,GAAG,GAAG,8BAAA;EAAA;AAAA;;;;;;;;;;AANlC;;;;;;;;AACsC;AACpC;;;;;;;;;;;AAI8D;AAqChE;cAAa,uBAAA,YAAmC,aAAA;EAAA,mBAC3B,GAAA;;;;;;;;qBACA,GAAA,0BAAG,MAAA;EAAA,mBACH,OAAA,EAAO,QAAA;;;;;;;YAChB,WAAA,EAAa,WAAA;EAAA,cAET,IAAA;EAAA,cAUA,IAAA;EAAA,cAIA,MAAA;EAAA,cAIA,IAAA;EAAA,cAIA,IAAA;EAAA,cAIA,WAAA;EAAA,UAUJ,cAAA,IAAkB,WAAA;EAOf,IAAA,CAAK,OAAA,EAAS,gBAAA,GAAmB,OAAA;EAAA,UAyBpC,iBAAA,IAAqB,WAAA;;;;EAiClB,MAAA,IAAU,OAAA;EArGT;;;EAmHP,KAAA;EAAA,mBAOY,OAAA,mBAAO,aAAA;EAAA,mBAKP,MAAA,mBAAM,aAAA;AAAA;;;;;;;AAhN3B;;cCtCa,eAAA,mBAAe,OAAA,kBAAA,MAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/email/smtp/providers/NodemailerEmailProvider.ts","../../../src/email/smtp/index.ts"],"mappings":";;;;;;;cAgDa,yCAAsB,mBAAA;;;;;;;KAwBvB,iCAAiC,cACpC,uBAAuB;;YAIpB;KACP,uBAAuB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAqCrB,mCAAmC;qBAC3B;;;;;;;;qBACA,6BAAG;qBACH,SAAO;;;;;;;YAChB,aAAa;gBAET;gBAUA;gBAIA;gBAIA;gBAIA;gBAIA;YAUJ,kBAAkB;EAOf,KAAK,SAAS,mBAAmB;YAyBpC,qBAAqB;;;;EAiClB,UAAU;;;;EAchB;qBAOY,0BAAO;qBAKP,yBAAM;;;;;;;;;;cC3Od,kCAAe,yBAAA"}