alepha 0.21.2 → 0.22.0

package/dist/email/cloudflare/index.js

@@ -11,8 +11,14 @@ import { $logger } from "alepha/logger";
 const SEND_EMAIL_DEFAULT_BINDING = "SEND_EMAIL";
 /**
 * Environment variables for Cloudflare email configuration.
+*
+* `EMAIL_FROM` is `optional` at the schema level so the provider can be
+* registered (and constructed) in non-Workers contexts — Node `yarn
+* start`, build-time introspection, etc. — without forcing every dev to
+* set it. `send()` re-checks at call time and throws a clear error if
+* it's missing then.
 */
-const envSchema = t.object({ EMAIL_FROM: t.text({ description: "Default sender email address (must be a verified sender)" }) });
+const envSchema = t.object({ EMAIL_FROM: t.optional(t.text({ description: "Default sender (a verified sender address). Accepts a bare address or an RFC 5322 display-name form, e.g. `Lore <noreply@lore.alepha.dev>`." })) });
 /**
 * Email provider using Cloudflare's Email Sending API via a Workers binding.
 *
@@ -49,22 +55,29 @@ var CloudflareEmailProvider = class {
 		on: "start",
 		handler: () => {
 			const cloudflareEnv = this.alepha.get("cloudflare.env");
-			if (!cloudflareEnv) throw new AlephaError("Cloudflare Workers environment not found in Alepha store under 'cloudflare.env'.");
+			if (!cloudflareEnv) {
+				this.log.warn("Cloudflare Email Sending inert: 'cloudflare.env' not set (not running on Workers).");
+				return;
+			}
 			const binding = cloudflareEnv[SEND_EMAIL_DEFAULT_BINDING];
-			if (!binding) throw new AlephaError(`Cloudflare Email binding '${SEND_EMAIL_DEFAULT_BINDING}' not found in Workers environment.`);
+			if (!binding) {
+				this.log.warn(`Cloudflare Email Sending inert: binding '${SEND_EMAIL_DEFAULT_BINDING}' not found in Workers environment.`);
+				return;
+			}
 			this.binding = binding;
 			this.log.info("Cloudflare Email Sending OK");
 		}
 	});
 	async send(options) {
 		const { to, subject, body } = options;
+		if (!this.env.EMAIL_FROM) throw new EmailError("Cannot send email via Cloudflare: EMAIL_FROM env var is not set.");
 		this.log.info("Sending email via Cloudflare", {
 			to,
 			subject
 		});
 		const message = {
 			to: Array.isArray(to) ? to : [to],
-			from: this.env.EMAIL_FROM,
+			from: this.resolveFrom(this.env.EMAIL_FROM),
 			subject,
 			html: body
 		};
@@ -87,6 +100,27 @@ var CloudflareEmailProvider = class {
 			throw new EmailError(message, error instanceof Error ? error : void 0);
 		}
 	}
+	/**
+	* Map the configured `EMAIL_FROM` to Cloudflare's `from` shape. An RFC 5322
+	* display-name form — `Name <addr@host>` (the name may be quoted) — is split
+	* into `{ email, name }` so Cloudflare renders the sender's display name
+	* (e.g. `Lore <noreply@lore.alepha.dev>` → "Lore"). A bare address is passed
+	* through unchanged.
+	*
+	* The object key is `email` (not `address`) — that is the field the
+	* Cloudflare Email Service Workers API expects. Sending `{ address, name }`
+	* makes the API reject the message with an opaque "internal error".
+	*/
+	resolveFrom(value) {
+		const match = value.match(/^\s*(.*?)\s*<([^>]+)>\s*$/);
+		if (!match) return value.trim();
+		const name = match[1].replace(/^"|"$/g, "").trim();
+		const email = match[2].trim();
+		return name ? {
+			email,
+			name
+		} : { email };
+	}
 	getBinding() {
 		if (!this.binding) throw new AlephaError("Cloudflare Email binding not initialized. Call start() first.");
 		return this.binding;
@@ -104,11 +138,14 @@ var CloudflareEmailProvider = class {
 const AlephaEmailCloudflare = $module({
 	name: "alepha.email.cloudflare",
 	services: [CloudflareEmailProvider],
-	register: (alepha) => alepha.with({
-		optional: true,
-		provide: EmailProvider,
-		use: CloudflareEmailProvider
-	}).with(AlephaEmail)
+	register: (alepha) => {
+		if (alepha.isServerless()) alepha.with({
+			optional: true,
+			provide: EmailProvider,
+			use: CloudflareEmailProvider
+		});
+		return alepha.with(AlephaEmail);
+	}
 });
 //#endregion
 export { AlephaEmailCloudflare, CloudflareEmailProvider, SEND_EMAIL_DEFAULT_BINDING };

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/email/cloudflare/providers/CloudflareEmailProvider.ts","../../../src/email/cloudflare/index.ts"],"sourcesContent":["import { $env, $hook, $inject, Alepha, AlephaError, t } from \"alepha\";\nimport {\n  EmailError,\n  type EmailProvider,\n  type EmailSendOptions,\n} from \"alepha/email\";\nimport { $logger } from \"alepha/logger\";\n\n/**\n * Default Cloudflare Email Sending binding name.\n *\n * Matches the convention used by other Alepha Cloudflare providers\n * (e.g. `KV_CACHE` for {@link CloudflareKVProvider}).\n */\nexport const SEND_EMAIL_DEFAULT_BINDING = \"SEND_EMAIL\";\n\n/**\n * Environment variables for Cloudflare email configuration.\n */\nconst envSchema = t.object({\n  EMAIL_FROM: t.text({\n    description: \"Default sender email address (must be a verified sender)\",\n  }),\n});\n\n/**\n * Shape of the Cloudflare Email Sending binding (public beta, 2026-04-16).\n *\n * @see https://developers.cloudflare.com/email-service/\n */\nexport interface CloudflareEmailBinding {\n  send(message: CloudflareEmailSendMessage): Promise<CloudflareEmailSendResult>;\n}\n\nexport interface CloudflareEmailSendMessage {\n  to: string | string[];\n  from: string | { address: string; name?: string };\n  subject: string;\n  html?: string;\n  text?: string;\n  cc?: string | string[];\n  bcc?: string | string[];\n  reply_to?: string | string[];\n  headers?: Record<string, string>;\n}\n\nexport interface CloudflareEmailSendResult {\n  id?: string;\n  status?: \"queued\" | \"sent\" | \"bounced\" | string;\n}\n\n/**\n * Email provider using Cloudflare's Email Sending API via a Workers binding.\n *\n * Requires the Workers Paid plan and a verified sender address on the\n * `EMAIL_FROM` domain.\n *\n * **Required Cloudflare binding:**\n * - `SEND_EMAIL` — an Email Sending binding in wrangler configuration\n *\n * Configuration is provided via environment variables:\n * - `EMAIL_FROM`: Default sender email address\n *\n * @example\n * ```toml\n * # wrangler.toml\n * [[send_email]]\n * binding = \"SEND_EMAIL\"\n * ```\n *\n * @example\n * ```typescript\n * // app.ts\n * import { AlephaEmailCloudflare } from \"alepha/email/cloudflare\";\n *\n * const app = Alepha.create().with(AlephaEmailCloudflare);\n * ```\n */\nexport class CloudflareEmailProvider implements EmailProvider {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly env = $env(envSchema);\n  protected readonly log = $logger();\n\n  protected binding?: CloudflareEmailBinding;\n\n  protected readonly onStart = $hook({\n    on: \"start\",\n    handler: () => {\n      const cloudflareEnv = this.alepha.get(\"cloudflare.env\") as\n        | Record<string, unknown>\n        | undefined;\n      if (!cloudflareEnv) {\n        throw new AlephaError(\n          \"Cloudflare Workers environment not found in Alepha store under 'cloudflare.env'.\",\n        );\n      }\n\n      const binding = cloudflareEnv[SEND_EMAIL_DEFAULT_BINDING] as\n        | CloudflareEmailBinding\n        | undefined;\n      if (!binding) {\n        throw new AlephaError(\n          `Cloudflare Email binding '${SEND_EMAIL_DEFAULT_BINDING}' not found in Workers environment.`,\n        );\n      }\n\n      this.binding = binding;\n      this.log.info(\"Cloudflare Email Sending OK\");\n    },\n  });\n\n  public async send(options: EmailSendOptions): Promise<void> {\n    const { to, subject, body } = options;\n    this.log.info(\"Sending email via Cloudflare\", { to, subject });\n\n    const message: CloudflareEmailSendMessage = {\n      to: Array.isArray(to) ? to : [to],\n      from: this.env.EMAIL_FROM,\n      subject,\n      html: body,\n    };\n\n    try {\n      const result = await this.getBinding().send(message);\n\n      if (result?.status === \"bounced\") {\n        throw new EmailError(\n          `Cloudflare email bounced (id=${result.id ?? \"unknown\"})`,\n        );\n      }\n\n      this.log.info(\"Email sent successfully via Cloudflare\", {\n        to,\n        subject,\n        id: result?.id,\n        status: result?.status,\n      });\n    } catch (error) {\n      if (error instanceof EmailError) {\n        throw error;\n      }\n      const status = (error as { status?: number })?.status;\n      const message =\n        status === 429\n          ? `Cloudflare email rate limit hit (429): ${error instanceof Error ? error.message : String(error)}`\n          : `Failed to send email via Cloudflare: ${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 getBinding(): CloudflareEmailBinding {\n    if (!this.binding) {\n      throw new AlephaError(\n        \"Cloudflare Email binding not initialized. Call start() first.\",\n      );\n    }\n    return this.binding;\n  }\n}\n","import { $module, type Alepha } from \"alepha\";\nimport { AlephaEmail, EmailProvider } from \"alepha/email\";\nimport { CloudflareEmailProvider } from \"./providers/CloudflareEmailProvider.ts\";\n\n// Exports\nexport * from \"./providers/CloudflareEmailProvider.ts\";\n\n/**\n * Plugin for Alepha Email that sends through Cloudflare's Email Sending API\n * via a Workers binding.\n *\n * @see {@link CloudflareEmailProvider}\n * @module alepha.email.cloudflare\n */\nexport const AlephaEmailCloudflare = $module({\n  name: \"alepha.email.cloudflare\",\n  services: [CloudflareEmailProvider],\n  register: (alepha: Alepha) =>\n    alepha\n      .with({\n        optional: true,\n        provide: EmailProvider,\n        use: CloudflareEmailProvider,\n      })\n      .with(AlephaEmail),\n});\n"],"mappings":";;;;;;;;;;AAcA,MAAa,6BAA6B;;;;AAK1C,MAAM,YAAY,EAAE,OAAO,EACzB,YAAY,EAAE,KAAK,EACjB,aAAa,4DACd,CAAC,EACH,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuDF,IAAa,0BAAb,MAA8D;CAC5D,SAA4B,QAAQ,OAAO;CAC3C,MAAyB,KAAK,UAAU;CACxC,MAAyB,SAAS;CAElC;CAEA,UAA6B,MAAM;EACjC,IAAI;EACJ,eAAe;GACb,MAAM,gBAAgB,KAAK,OAAO,IAAI,iBAAiB;GAGvD,IAAI,CAAC,eACH,MAAM,IAAI,YACR,mFACD;GAGH,MAAM,UAAU,cAAc;GAG9B,IAAI,CAAC,SACH,MAAM,IAAI,YACR,6BAA6B,2BAA2B,qCACzD;GAGH,KAAK,UAAU;GACf,KAAK,IAAI,KAAK,8BAA8B;;EAE/C,CAAC;CAEF,MAAa,KAAK,SAA0C;EAC1D,MAAM,EAAE,IAAI,SAAS,SAAS;EAC9B,KAAK,IAAI,KAAK,gCAAgC;GAAE;GAAI;GAAS,CAAC;EAE9D,MAAM,UAAsC;GAC1C,IAAI,MAAM,QAAQ,GAAG,GAAG,KAAK,CAAC,GAAG;GACjC,MAAM,KAAK,IAAI;GACf;GACA,MAAM;GACP;EAED,IAAI;GACF,MAAM,SAAS,MAAM,KAAK,YAAY,CAAC,KAAK,QAAQ;GAEpD,IAAI,QAAQ,WAAW,WACrB,MAAM,IAAI,WACR,gCAAgC,OAAO,MAAM,UAAU,GACxD;GAGH,KAAK,IAAI,KAAK,0CAA0C;IACtD;IACA;IACA,IAAI,QAAQ;IACZ,QAAQ,QAAQ;IACjB,CAAC;WACK,OAAO;GACd,IAAI,iBAAiB,YACnB,MAAM;GAGR,MAAM,UADU,OAA+B,WAElC,MACP,0CAA0C,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,KAChG,wCAAwC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GACpG,KAAK,IAAI,MAAM,SAAS;IAAE;IAAI;IAAS,CAAC;GACxC,MAAM,IAAI,WAAW,SAAS,iBAAiB,QAAQ,QAAQ,KAAA,EAAU;;;CAI7E,aAA+C;EAC7C,IAAI,CAAC,KAAK,SACR,MAAM,IAAI,YACR,gEACD;EAEH,OAAO,KAAK;;;;;;;;;;;;AC/IhB,MAAa,wBAAwB,QAAQ;CAC3C,MAAM;CACN,UAAU,CAAC,wBAAwB;CACnC,WAAW,WACT,OACG,KAAK;EACJ,UAAU;EACV,SAAS;EACT,KAAK;EACN,CAAC,CACD,KAAK,YAAY;CACvB,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/email/cloudflare/providers/CloudflareEmailProvider.ts","../../../src/email/cloudflare/index.ts"],"sourcesContent":["import { $env, $hook, $inject, Alepha, AlephaError, t } from \"alepha\";\nimport {\n  EmailError,\n  type EmailProvider,\n  type EmailSendOptions,\n} from \"alepha/email\";\nimport { $logger } from \"alepha/logger\";\n\n/**\n * Default Cloudflare Email Sending binding name.\n *\n * Matches the convention used by other Alepha Cloudflare providers\n * (e.g. `KV_CACHE` for {@link CloudflareKVProvider}).\n */\nexport const SEND_EMAIL_DEFAULT_BINDING = \"SEND_EMAIL\";\n\n/**\n * Environment variables for Cloudflare email configuration.\n *\n * `EMAIL_FROM` is `optional` at the schema level so the provider can be\n * registered (and constructed) in non-Workers contexts — Node `yarn\n * start`, build-time introspection, etc. — without forcing every dev to\n * set it. `send()` re-checks at call time and throws a clear error if\n * it's missing then.\n */\nconst envSchema = t.object({\n  EMAIL_FROM: t.optional(\n    t.text({\n      description:\n        \"Default sender (a verified sender address). Accepts a bare address or an RFC 5322 display-name form, e.g. `Lore <noreply@lore.alepha.dev>`.\",\n    }),\n  ),\n});\n\n/**\n * Shape of the Cloudflare Email Sending binding (public beta, 2026-04-16).\n *\n * @see https://developers.cloudflare.com/email-service/\n */\nexport interface CloudflareEmailBinding {\n  send(message: CloudflareEmailSendMessage): Promise<CloudflareEmailSendResult>;\n}\n\nexport interface CloudflareEmailSendMessage {\n  to: string | string[];\n  from: string | { email: string; name?: string };\n  subject: string;\n  html?: string;\n  text?: string;\n  cc?: string | string[];\n  bcc?: string | string[];\n  reply_to?: string | string[];\n  headers?: Record<string, string>;\n}\n\nexport interface CloudflareEmailSendResult {\n  id?: string;\n  status?: \"queued\" | \"sent\" | \"bounced\" | string;\n}\n\n/**\n * Email provider using Cloudflare's Email Sending API via a Workers binding.\n *\n * Requires the Workers Paid plan and a verified sender address on the\n * `EMAIL_FROM` domain.\n *\n * **Required Cloudflare binding:**\n * - `SEND_EMAIL` — an Email Sending binding in wrangler configuration\n *\n * Configuration is provided via environment variables:\n * - `EMAIL_FROM`: Default sender email address\n *\n * @example\n * ```toml\n * # wrangler.toml\n * [[send_email]]\n * binding = \"SEND_EMAIL\"\n * ```\n *\n * @example\n * ```typescript\n * // app.ts\n * import { AlephaEmailCloudflare } from \"alepha/email/cloudflare\";\n *\n * const app = Alepha.create().with(AlephaEmailCloudflare);\n * ```\n */\nexport class CloudflareEmailProvider implements EmailProvider {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly env = $env(envSchema);\n  protected readonly log = $logger();\n\n  protected binding?: CloudflareEmailBinding;\n\n  protected readonly onStart = $hook({\n    on: \"start\",\n    handler: () => {\n      // Tolerate boot off-Workers. The provider has to be registered\n      // unconditionally so the CF build task can see it and emit the\n      // `send_email` binding into wrangler.jsonc — but actually starting\n      // on Node (yarn start / yarn dev) would crash because no binding\n      // is wired. Treat that as \"inert provider\": warn, don't throw.\n      // `send()` later will surface the real error if it's ever called.\n      const cloudflareEnv = this.alepha.get(\"cloudflare.env\") as\n        | Record<string, unknown>\n        | undefined;\n      if (!cloudflareEnv) {\n        this.log.warn(\n          \"Cloudflare Email Sending inert: 'cloudflare.env' not set (not running on Workers).\",\n        );\n        return;\n      }\n\n      const binding = cloudflareEnv[SEND_EMAIL_DEFAULT_BINDING] as\n        | CloudflareEmailBinding\n        | undefined;\n      if (!binding) {\n        this.log.warn(\n          `Cloudflare Email Sending inert: binding '${SEND_EMAIL_DEFAULT_BINDING}' not found in Workers environment.`,\n        );\n        return;\n      }\n\n      this.binding = binding;\n      this.log.info(\"Cloudflare Email Sending OK\");\n    },\n  });\n\n  public async send(options: EmailSendOptions): Promise<void> {\n    const { to, subject, body } = options;\n    if (!this.env.EMAIL_FROM) {\n      throw new EmailError(\n        \"Cannot send email via Cloudflare: EMAIL_FROM env var is not set.\",\n      );\n    }\n    this.log.info(\"Sending email via Cloudflare\", { to, subject });\n\n    const message: CloudflareEmailSendMessage = {\n      to: Array.isArray(to) ? to : [to],\n      from: this.resolveFrom(this.env.EMAIL_FROM),\n      subject,\n      html: body,\n    };\n\n    try {\n      const result = await this.getBinding().send(message);\n\n      if (result?.status === \"bounced\") {\n        throw new EmailError(\n          `Cloudflare email bounced (id=${result.id ?? \"unknown\"})`,\n        );\n      }\n\n      this.log.info(\"Email sent successfully via Cloudflare\", {\n        to,\n        subject,\n        id: result?.id,\n        status: result?.status,\n      });\n    } catch (error) {\n      if (error instanceof EmailError) {\n        throw error;\n      }\n      const status = (error as { status?: number })?.status;\n      const message =\n        status === 429\n          ? `Cloudflare email rate limit hit (429): ${error instanceof Error ? error.message : String(error)}`\n          : `Failed to send email via Cloudflare: ${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  /**\n   * Map the configured `EMAIL_FROM` to Cloudflare's `from` shape. An RFC 5322\n   * display-name form — `Name <addr@host>` (the name may be quoted) — is split\n   * into `{ email, name }` so Cloudflare renders the sender's display name\n   * (e.g. `Lore <noreply@lore.alepha.dev>` → \"Lore\"). A bare address is passed\n   * through unchanged.\n   *\n   * The object key is `email` (not `address`) — that is the field the\n   * Cloudflare Email Service Workers API expects. Sending `{ address, name }`\n   * makes the API reject the message with an opaque \"internal error\".\n   */\n  protected resolveFrom(\n    value: string,\n  ): string | { email: string; name?: string } {\n    const match = value.match(/^\\s*(.*?)\\s*<([^>]+)>\\s*$/);\n    if (!match) {\n      return value.trim();\n    }\n    const name = match[1].replace(/^\"|\"$/g, \"\").trim();\n    const email = match[2].trim();\n    return name ? { email, name } : { email };\n  }\n\n  protected getBinding(): CloudflareEmailBinding {\n    if (!this.binding) {\n      throw new AlephaError(\n        \"Cloudflare Email binding not initialized. Call start() first.\",\n      );\n    }\n    return this.binding;\n  }\n}\n","import { $module, type Alepha } from \"alepha\";\nimport { AlephaEmail, EmailProvider } from \"alepha/email\";\nimport { CloudflareEmailProvider } from \"./providers/CloudflareEmailProvider.ts\";\n\n// Exports\nexport * from \"./providers/CloudflareEmailProvider.ts\";\n\n/**\n * Plugin for Alepha Email that sends through Cloudflare's Email Sending API\n * via a Workers binding.\n *\n * @see {@link CloudflareEmailProvider}\n * @module alepha.email.cloudflare\n */\nexport const AlephaEmailCloudflare = $module({\n  name: \"alepha.email.cloudflare\",\n  services: [CloudflareEmailProvider],\n  // Gate the substitution on `isServerless()` so apps can register this\n  // module unconditionally — the build path needs to see the service to\n  // emit the wrangler `send_email` binding, but the runtime substitution\n  // must only kick in on Workers. Off-Workers we fall through to\n  // AlephaEmail's defaults (LocalEmailProvider for dev, MemoryEmailProvider\n  // for tests), so `yarn start` / `yarn dev` / e2e keep working without\n  // a real binding.\n  register: (alepha: Alepha) => {\n    if (alepha.isServerless()) {\n      alepha.with({\n        optional: true,\n        provide: EmailProvider,\n        use: CloudflareEmailProvider,\n      });\n    }\n    return alepha.with(AlephaEmail);\n  },\n});\n"],"mappings":";;;;;;;;;;AAcA,MAAa,6BAA6B;;;;;;;;;;AAW1C,MAAM,YAAY,EAAE,OAAO,EACzB,YAAY,EAAE,SACZ,EAAE,KAAK,EACL,aACE,8IACJ,CAAC,CACH,EACF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuDD,IAAa,0BAAb,MAA8D;CAC5D,SAA4B,QAAQ,MAAM;CAC1C,MAAyB,KAAK,SAAS;CACvC,MAAyB,QAAQ;CAEjC;CAEA,UAA6B,MAAM;EACjC,IAAI;EACJ,eAAe;GAOb,MAAM,gBAAgB,KAAK,OAAO,IAAI,gBAAgB;GAGtD,IAAI,CAAC,eAAe;IAClB,KAAK,IAAI,KACP,oFACF;IACA;GACF;GAEA,MAAM,UAAU,cAAc;GAG9B,IAAI,CAAC,SAAS;IACZ,KAAK,IAAI,KACP,4CAA4C,2BAA2B,oCACzE;IACA;GACF;GAEA,KAAK,UAAU;GACf,KAAK,IAAI,KAAK,6BAA6B;EAC7C;CACF,CAAC;CAED,MAAa,KAAK,SAA0C;EAC1D,MAAM,EAAE,IAAI,SAAS,SAAS;EAC9B,IAAI,CAAC,KAAK,IAAI,YACZ,MAAM,IAAI,WACR,kEACF;EAEF,KAAK,IAAI,KAAK,gCAAgC;GAAE;GAAI;EAAQ,CAAC;EAE7D,MAAM,UAAsC;GAC1C,IAAI,MAAM,QAAQ,EAAE,IAAI,KAAK,CAAC,EAAE;GAChC,MAAM,KAAK,YAAY,KAAK,IAAI,UAAU;GAC1C;GACA,MAAM;EACR;EAEA,IAAI;GACF,MAAM,SAAS,MAAM,KAAK,WAAW,EAAE,KAAK,OAAO;GAEnD,IAAI,QAAQ,WAAW,WACrB,MAAM,IAAI,WACR,gCAAgC,OAAO,MAAM,UAAU,EACzD;GAGF,KAAK,IAAI,KAAK,0CAA0C;IACtD;IACA;IACA,IAAI,QAAQ;IACZ,QAAQ,QAAQ;GAClB,CAAC;EACH,SAAS,OAAO;GACd,IAAI,iBAAiB,YACnB,MAAM;GAGR,MAAM,UADU,OAA+B,WAElC,MACP,0CAA0C,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,MAC/F,wCAAwC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GACnG,KAAK,IAAI,MAAM,SAAS;IAAE;IAAI;GAAQ,CAAC;GACvC,MAAM,IAAI,WAAW,SAAS,iBAAiB,QAAQ,QAAQ,KAAA,CAAS;EAC1E;CACF;;;;;;;;;;;;CAaA,YACE,OAC2C;EAC3C,MAAM,QAAQ,MAAM,MAAM,2BAA2B;EACrD,IAAI,CAAC,OACH,OAAO,MAAM,KAAK;EAEpB,MAAM,OAAO,MAAM,GAAG,QAAQ,UAAU,EAAE,EAAE,KAAK;EACjD,MAAM,QAAQ,MAAM,GAAG,KAAK;EAC5B,OAAO,OAAO;GAAE;GAAO;EAAK,IAAI,EAAE,MAAM;CAC1C;CAEA,aAA+C;EAC7C,IAAI,CAAC,KAAK,SACR,MAAM,IAAI,YACR,+DACF;EAEF,OAAO,KAAK;CACd;AACF;;;;;;;;;;AC9LA,MAAa,wBAAwB,QAAQ;CAC3C,MAAM;CACN,UAAU,CAAC,uBAAuB;CAQlC,WAAW,WAAmB;EAC5B,IAAI,OAAO,aAAa,GACtB,OAAO,KAAK;GACV,UAAU;GACV,SAAS;GACT,KAAK;EACP,CAAC;EAEH,OAAO,OAAO,KAAK,WAAW;CAChC;AACF,CAAC"}

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

@@ -1,8 +1,5 @@
-import * as _$alepha from "alepha";
 import { AlephaError, InstantiableClass, KIND, Primitive, Static } from "alepha";
-import * as _$alepha_logger0 from "alepha/logger";
 import { FileSystemProvider } from "alepha/system";
-import * as _$typebox from "typebox";
 
 //#region ../../src/email/core/providers/EmailProvider.d.ts
 /**
@@ -70,8 +67,8 @@ declare class EmailPrimitive extends Primitive<EmailPrimitiveOptions> {
 /**
  * Local email provider configuration atom
  */
-declare const localEmailOptions: _$alepha.Atom<_$typebox.TObject<{
-  directory: _$typebox.TString;
+declare const localEmailOptions: import("alepha").Atom<import("typebox").TObject<{
+  directory: import("typebox").TString;
 }>, "alepha.email.local.options">;
 type LocalEmailProviderOptions = Static<typeof localEmailOptions.schema>;
 declare module "alepha" {
@@ -80,13 +77,13 @@ declare module "alepha" {
   }
 }
 declare class LocalEmailProvider implements EmailProvider {
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly fs: FileSystemProvider;
   protected readonly options: Readonly<{
     directory: string;
   }>;
   protected get directory(): string;
-  protected onStart: _$alepha.HookPrimitive<"start">;
+  protected onStart: import("alepha").HookPrimitive<"start">;
   send(options: EmailSendOptions): Promise<void>;
   createEmailJson(options: {
     to: string;
@@ -108,7 +105,7 @@ interface EmailRecord {
   sentAt: Date;
 }
 declare class MemoryEmailProvider implements EmailProvider {
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   records: EmailRecord[];
   send(options: EmailSendOptions): Promise<void>;
   /**
@@ -148,7 +145,7 @@ declare module "alepha" {
  *
  * @module alepha.email
  */
-declare const AlephaEmail: _$alepha.Service<_$alepha.Module>;
+declare const AlephaEmail: import("alepha").Service<import("alepha").Module>;
 //#endregion
 export { $email, AlephaEmail, EmailError, EmailPrimitive, EmailPrimitiveOptions, EmailProvider, EmailRecord, EmailSendOptions, LocalEmailProvider, LocalEmailProviderOptions, MemoryEmailProvider, localEmailOptions };
 //# sourceMappingURL=index.d.ts.map

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":";;;;;;;;;;;;uBAKsB,aAAA;;AAAtB;;;;WAMkB,IAAA,CAAK,OAAA,EAAS,gBAAA,GAAmB,OAAA;AAAA;AAAA,KAGvC,gBAAA;EACV,EAAA;EACA,OAAA;EACA,IAAA;AAAA;;;cCfW,UAAA,SAAmB,WAAA;cAClB,OAAA,UAAiB,KAAA,GAAQ,KAAA;AAAA;;;cCU1B,MAAA;EAAA,WAAmB,qBAAA,GAAqB,cAAA;EAAA;;UAKpC,qBAAA;EACf,IAAA;EACA,QAAA,GAAW,iBAAA,CAAkB,aAAA;AAAA;;;;;;;AFN/B;;;;;;;;;;;;cE6Ba,cAAA,SAAuB,SAAA,CAAU,qBAAA;EAAA,mBACzB,QAAA,EAAQ,aAAA;EAAA,IAEhB,IAAA,CAAA;ED5C8B;;;ECmD5B,IAAA,CAAK,OAAA,EAAS,gBAAA,GAAmB,OAAA;EAAA,UAoBpC,SAAA,CAAA,GAAa,aAAA;AAAA;;;;;;cC9DZ,iBAAA,EAAiB,QAAA,CAAA,IAAA,WAAA,OAAA;aAU5B,SAAA,CAAA,OAAA;AAAA;AAAA,KAEU,yBAAA,GAA4B,MAAA,QAAc,iBAAA,CAAkB,MAAA;AAAA;EAAA,UAG5D,KAAA;IAAA,CACP,iBAAA,CAAkB,GAAA,GAAM,yBAAA;EAAA;AAAA;AAAA,cAMhB,kBAAA,YAA8B,aAAA;EAAA,mBACtB,GAAA,EADW,gBAAA,CACR,MAAA;EAAA,mBACH,EAAA,EAAE,kBAAA;EAAA,mBACF,OAAA,EAAO,QAAA;;;gBAEZ,SAAA,CAAA;EAAA,UAIJ,OAAA,EANgB,QAAA,CAMT,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,IAAA;AAAA;AAAA,cAGG,mBAAA,YAA+B,aAAA;EAAA,mBACvB,GAAA,EADY,gBAAA,CACT,MAAA;EACf,OAAA,EAAS,WAAA;EAEH,IAAA,CAAK,OAAA,EAAS,gBAAA,GAAmB,OAAA;EJH9B;;;EAAA,IIoBL,IAAA,CAAA,GAAQ,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;;;;;;;;AJxBhB;;;;;;;cI2Ca,WAAA,EAAW,QAAA,CAAA,OAAA,CAoBtB,QAAA,CApBsB,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":";;;;;;;;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"}

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 * 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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"}

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;;;ACKpC,IAAa,sBAAb,MAA0D;CACxD,MAAyB,SAAS;CAClC,UAAgC,EAAE;CAElC,MAAa,KAAK,SAA0C;EAC1D,MAAM,EAAE,IAAI,SAAS,SAAS;EAC9B,KAAK,IAAI,MAAM,iCAAiC;GAAE;GAAI;GAAS,CAAC;EAEhE,KAAK,MAAM,aAAa,MAAM,QAAQ,GAAG,GAAG,KAAK,CAAC,GAAG,EACnD,KAAK,QAAQ,KAAK;GAChB,IAAI;GACJ;GACA;GACA,wBAAQ,IAAI,MAAM;GACnB,CAAC;;;;;CAON,IAAW,OAAgC;EACzC,OAAO,KAAK,QAAQ,KAAK,QAAQ,SAAS;;;;;ACnB9C,MAAa,UAAU,UAAiC,EAAE,KACxD,gBAAgB,gBAAgB,QAAQ;;;;;;;;;;;;;;;;;;;AA6B1C,IAAa,iBAAb,cAAoC,UAAiC;CACnE,WAA8B,KAAK,WAAW;CAE9C,IAAW,OAAO;EAChB,OAAO,KAAK,QAAQ,QAAQ,GAAG,KAAK,OAAO;;;;;CAM7C,MAAa,KAAK,SAA0C;EAC1D,MAAM,KAAK,OAAO,OAAO,KAAK,iBAAiB;GAC7C,IAAI,QAAQ;GACZ,UAAU,KAAK;GACf,WAAW,EAAE;GACb,UAAU,KAAK;GACf,aAAa;IACX,MAAM,IAAI,YAAY,gCAAgC;;GAEzD,CAAC;EAEF,MAAM,KAAK,SAAS,KAAK,QAAQ;EAEjC,MAAM,KAAK,OAAO,OAAO,KAAK,cAAc;GAC1C,IAAI,QAAQ;GACZ,UAAU,KAAK;GACf,UAAU,KAAK;GAChB,CAAC;;CAGJ,YAAqC;EACnC,IAAI,CAAC,KAAK,QAAQ,UAChB,OAAO,KAAK,OAAO,OAAO,cAAc;EAE1C,IAAI,KAAK,QAAQ,aAAa,UAC5B,OAAO,KAAK,OAAO,OAAO,oBAAoB;EAEhD,OAAO,KAAK,OAAO,OAAO,KAAK,QAAQ,SAAS;;;AAMpD,OAAO,QAAQ;;;ACpFf,IAAa,aAAb,cAAgC,YAAY;CAC1C,YAAY,SAAiB,OAAe;EAC1C,MAAM,QAAQ;EACd,KAAK,OAAO;EACZ,KAAK,QAAQ;;;;;;;;;;;;;ACajB,MAAa,cAAc,QAAQ;CACjC,MAAM;CACN,YAAY,CAAC,OAAO;CACpB,UAAU,CAAC,eAAe,oBAAoB;CAC9C,WAAW,WAAW;EACpB,OAAO,KAAK;GACV,UAAU;GACV,SAAS;GACT,KAAK;GACN,CAAC;;CAEL,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 * 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"}

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

@@ -1,20 +1,17 @@
-import * as _$alepha from "alepha";
 import { Static } from "alepha";
 import { EmailProvider, EmailSendOptions } from "alepha/email";
-import * as _$alepha_logger0 from "alepha/logger";
-import * as _$typebox from "typebox";
 import { Transporter } from "nodemailer";
 
 //#region ../../src/email/smtp/providers/NodemailerEmailProvider.d.ts
 /**
  * Nodemailer connection pooling and rate limiting options
  */
-declare const nodemailerEmailOptions: _$alepha.Atom<_$typebox.TObject<{
-  pool: _$typebox.TOptional<_$typebox.TBoolean>;
-  maxConnections: _$typebox.TOptional<_$typebox.TNumber>;
-  maxMessages: _$typebox.TOptional<_$typebox.TNumber>;
-  rateDelta: _$typebox.TOptional<_$typebox.TNumber>;
-  rateLimit: _$typebox.TOptional<_$typebox.TNumber>;
+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">;
 type NodemailerEmailProviderOptions = Static<typeof nodemailerEmailOptions.schema>;
 declare module "alepha" {
@@ -62,7 +59,7 @@ declare class NodemailerEmailProvider implements EmailProvider {
     EMAIL_PORT: number;
     EMAIL_SECURE: boolean;
   };
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly options: Readonly<{
     pool?: boolean | undefined;
     maxConnections?: number | undefined;
@@ -88,8 +85,8 @@ declare class NodemailerEmailProvider implements EmailProvider {
    * Close the transporter connection.
    */
   close(): void;
-  protected readonly onStart: _$alepha.HookPrimitive<"start">;
-  protected readonly onStop: _$alepha.HookPrimitive<"stop">;
+  protected readonly onStart: import("alepha").HookPrimitive<"start">;
+  protected readonly onStop: import("alepha").HookPrimitive<"stop">;
 }
 //#endregion
 //#region ../../src/email/smtp/index.d.ts
@@ -99,7 +96,7 @@ declare class NodemailerEmailProvider implements EmailProvider {
  * @see {@link NodemailerEmailProvider}
  * @module alepha.email.smtp
  */
-declare const AlephaEmailSmtp: _$alepha.Service<_$alepha.Module>;
+declare const AlephaEmailSmtp: import("alepha").Service<import("alepha").Module>;
 //#endregion
 export { AlephaEmailSmtp, NodemailerEmailProvider, NodemailerEmailProviderOptions, nodemailerEmailOptions };
 //# sourceMappingURL=index.d.ts.map

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":";;;;;;;;;;;cAmDa,sBAAA,EAAsB,QAAA,CAAA,IAAA,WAAA,OAAA;4BA8BjC,SAAA,CAAA,QAAA;;;;;;KAEU,8BAAA,GAAiC,MAAA,QACpC,sBAAA,CAAuB,MAAA;AAAA;EAAA,UAIpB,KAAA;IAAA,CACP,sBAAA,CAAuB,GAAA,GAAM,8BAAA;EAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;AANlC;;;;;;cA2Ca,uBAAA,YAAmC,aAAA;EAAA,mBAC3B,GAAA;;;;;;;;qBACA,GAAA,EAFgB,gBAAA,CAEb,MAAA;EAAA,mBACH,OAAA,EAAO,QAAA;;;;;;;YAChB,WAAA,EAAa,WAAA;EAAA,cAET,IAAA,CAAA;EAAA,cAUA,IAAA,CAAA;EAAA,cAIA,MAAA,CAAA;EAAA,cAIA,IAAA,CAAA;EAAA,cAIA,IAAA,CAAA;EAAA,cAIA,WAAA,CAAA;EAAA,UAUJ,cAAA,CAAA,GAAkB,WAAA;EAOf,IAAA,CAAK,OAAA,EAAS,gBAAA,GAAmB,OAAA;EAAA,UAyBpC,iBAAA,CAAA,GAAqB,WAAA;EAsDL;;;EArBb,MAAA,CAAA,GAAU,OAAA;EA3GuB;;;EAyHvC,KAAA,CAAA;EAAA,mBAOY,OAAA,EArBW,QAAA,CAqBJ,aAAA;EAAA,mBAKP,MAAA,EALO,QAAA,CAKD,aAAA;AAAA;;;;;;;;;cCtPd,eAAA,EAAe,QAAA,CAAA,OAAA,CAU1B,QAAA,CAV0B,MAAA"}
+{"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"}