@veap/mail 0.1.7 → 0.1.8

package/dist/composition.js

@@ -1,8 +1,8 @@
 import { ApplicationBuilder } from "@veap/kernel";
-import { CommunicationServiceProvider } from "./provider.js";
+import { MailServiceProvider } from "./provider.js";
 ApplicationBuilder.prototype.withMail = function () {
-    return this.use(CommunicationServiceProvider);
+    return this.use(MailServiceProvider);
 };
 ApplicationBuilder.prototype.withCommunication = function () {
-    return this.use(CommunicationServiceProvider);
+    return this.use(MailServiceProvider);
 };

package/dist/context.d.ts

@@ -1,22 +1,33 @@
 import type { IMailer } from "./mailer.js";
 /**
- * Typed boundary between the communication use cases and their consumers
- * (facades, application services). The same pattern as
- * `application/auth/context.ts` and `application/plugins/context.ts`.
+ * Typed boundary between the mail use cases and their consumers
+ * (facades, application services).
  *
- * The composition root (`CommunicationServiceProvider`) selects the mail
+ * The composition root (`MailServiceProvider`) selects the mail
  * transport once at boot and binds it here.
  */
-export interface CommunicationContext {
+export interface MailContext {
     mailer: IMailer;
 }
 /**
- * Binds the resolved communication services. Called once by the composition root.
+ * @deprecated Use `MailContext` instead.
  */
-export declare function bindCommunicationContext(context: CommunicationContext): void;
+export type CommunicationContext = MailContext;
 /**
- * Returns the bound communication services.
+ * Binds the resolved mail services. Called once by the composition root.
+ */
+export declare function bindMailContext(context: MailContext): void;
+/**
+ * @deprecated Use `bindMailContext` instead.
+ */
+export declare const bindCommunicationContext: typeof bindMailContext;
+/**
+ * Returns the bound mail services.
  *
- * @throws If the communication service provider has not booted yet.
+ * @throws If the mail service provider has not booted yet.
+ */
+export declare function mailContext(): MailContext;
+/**
+ * @deprecated Use `mailContext` instead.
  */
-export declare function communicationContext(): CommunicationContext;
+export declare const communicationContext: typeof mailContext;

package/dist/context.js

@@ -1,20 +1,30 @@
 import { AppError } from "@veap/kernel";
-const globalForCommunicationContext = globalThis;
+const globalForMailContext = globalThis;
 /**
- * Binds the resolved communication services. Called once by the composition root.
+ * Binds the resolved mail services. Called once by the composition root.
  */
-export function bindCommunicationContext(context) {
-    globalForCommunicationContext.__VEAP_COMMUNICATION_CONTEXT__ = context;
+export function bindMailContext(context) {
+    globalForMailContext.__VEAP_MAIL_CONTEXT__ = context;
+    globalForMailContext.__VEAP_COMMUNICATION_CONTEXT__ = context;
 }
 /**
- * Returns the bound communication services.
+ * @deprecated Use `bindMailContext` instead.
+ */
+export const bindCommunicationContext = bindMailContext;
+/**
+ * Returns the bound mail services.
  *
- * @throws If the communication service provider has not booted yet.
+ * @throws If the mail service provider has not booted yet.
  */
-export function communicationContext() {
-    const context = globalForCommunicationContext.__VEAP_COMMUNICATION_CONTEXT__;
+export function mailContext() {
+    const context = globalForMailContext.__VEAP_MAIL_CONTEXT__ ??
+        globalForMailContext.__VEAP_COMMUNICATION_CONTEXT__;
     if (!context) {
-        throw AppError.Internal("[Communication] Context is not bound. CommunicationServiceProvider must boot before the communication facades are used.");
+        throw AppError.Internal("[Mail] Context is not bound. MailServiceProvider must boot before the mail facades are used.");
     }
     return context;
 }
+/**
+ * @deprecated Use `mailContext` instead.
+ */
+export const communicationContext = mailContext;

package/dist/index.d.ts

@@ -8,4 +8,3 @@ export * from "./provider.js";
 export * from "./providers/console.provider.js";
 export * from "./providers/nodemailer.provider.js";
 export { NodemailerMailService as MailService } from "./providers/nodemailer.provider.js";
-export * from "./translator.js";

package/dist/index.js

@@ -7,4 +7,3 @@ export * from "./provider.js";
 export * from "./providers/console.provider.js";
 export * from "./providers/nodemailer.provider.js";
 export { NodemailerMailService as MailService } from "./providers/nodemailer.provider.js";
-export * from "./translator.js";

package/dist/mail.d.ts

@@ -1,19 +1,9 @@
 import type { MailMessage } from "./mail-message.js";
 /**
- * Mailables - the domain vocabulary of email.
+ * Sends an email message through the configured transport.
  *
- * Transports deliver; mailables decide *what* is sent. Each helper builds a
- * `MailMessage` (localized via the injected translator) and hands it to the
- * bound `IMailer` port. This is the Laravel split: `Mailable` defines the
- * content, `Transport` only delivers it - a transport never knows whether it
- * is carrying a verification code or a newsletter.
- *
- * Application services (auth flows) and plugins call these helpers; swapping
- * the transport never touches them, and adding a new mail kind never touches
- * a transport.
+ * Transports deliver; application services, plugins, and domains decide
+ * what is sent (subject, body, recipients, templates). Swapping the transport
+ * never touches the caller.
  */
 export declare function sendMail(message: MailMessage): Promise<void>;
-export declare function sendVerifyEmail(email: string, code: string): Promise<void>;
-export declare function sendResetPassword(email: string, code: string): Promise<void>;
-export declare function sendRecoveryCode(email: string, recoveryCode: string): Promise<void>;
-export declare function send2FACode(email: string, code: string): Promise<void>;

package/dist/mail.js

@@ -1,52 +1,11 @@
-import { communicationContext } from "./context.js";
-import { getMailTranslator } from "./translator.js";
+import { mailContext } from "./context.js";
 /**
- * Mailables - the domain vocabulary of email.
+ * Sends an email message through the configured transport.
  *
- * Transports deliver; mailables decide *what* is sent. Each helper builds a
- * `MailMessage` (localized via the injected translator) and hands it to the
- * bound `IMailer` port. This is the Laravel split: `Mailable` defines the
- * content, `Transport` only delivers it - a transport never knows whether it
- * is carrying a verification code or a newsletter.
- *
- * Application services (auth flows) and plugins call these helpers; swapping
- * the transport never touches them, and adding a new mail kind never touches
- * a transport.
+ * Transports deliver; application services, plugins, and domains decide
+ * what is sent (subject, body, recipients, templates). Swapping the transport
+ * never touches the caller.
  */
 export async function sendMail(message) {
-    return communicationContext().mailer.sendMail(message);
-}
-export async function sendVerifyEmail(email, code) {
-    const t = await getMailTranslator();
-    return sendMail({
-        to: email,
-        subject: t("Verify Email"),
-        text: t("Verify your email address with your code: {code}", { code }),
-    });
-}
-export async function sendResetPassword(email, code) {
-    const t = await getMailTranslator();
-    return sendMail({
-        to: email,
-        subject: t("Password Reset"),
-        text: t("Verify password reset with code: {code}", { code }),
-    });
-}
-export async function sendRecoveryCode(email, recoveryCode) {
-    const t = await getMailTranslator();
-    return sendMail({
-        to: email,
-        subject: t("Recovery Code"),
-        text: t("Your recovery code is: {recoveryCode}", { recoveryCode }),
-    });
-}
-export async function send2FACode(email, code) {
-    const t = await getMailTranslator();
-    return sendMail({
-        to: email,
-        subject: t("Your 2FA Code"),
-        text: t("Your verification code is: {code}. It will expire in 10 minutes.", {
-            code,
-        }),
-    });
+    return mailContext().mailer.sendMail(message);
 }

package/dist/provider.d.ts

@@ -1,9 +1,9 @@
 import { ServiceProvider } from "@veap/kernel";
 /**
- * Composition root of the communication context.
+ * Composition root of the mail context.
  *
  * Selects the mail transport exactly once (in `boot()`) from `MAIL_TRANSPORT`
- * and binds it into `CommunicationContext`, so facades and services never
+ * and binds it into `MailContext`, so facades and services never
  * look transports up themselves:
  *
  * - `smtp` (default) - Nodemailer (`MAIL_SERVICE`, `MAIL_HOST`, `MAIL_PORT`,
@@ -11,9 +11,13 @@ import { ServiceProvider } from "@veap/kernel";
  * - `console` - logs the message; dev/test with zero mail configuration
  * - `custom` - resolves `CUSTOM_MAILER`; bring your own SES/Postmark/Resend…
  */
-export declare class CommunicationServiceProvider extends ServiceProvider {
+export declare class MailServiceProvider extends ServiceProvider {
     register(): void;
     boot(): Promise<void>;
     private selectTransport;
 }
-export declare const MailServiceProvider: typeof CommunicationServiceProvider;
+/**
+ * @deprecated Use `MailServiceProvider` instead.
+ */
+export declare const CommunicationServiceProvider: typeof MailServiceProvider;
+export type CommunicationServiceProvider = MailServiceProvider;

package/dist/provider.js

@@ -1,14 +1,13 @@
 import { ConfigService, logger, ServiceProvider } from "@veap/kernel";
-import { bindCommunicationContext } from "./context.js";
+import { bindMailContext } from "./context.js";
 import { CUSTOM_MAILER, MAILER } from "./mailer.js";
 import { ConsoleMailService } from "./providers/console.provider.js";
 import { NodemailerMailService } from "./providers/nodemailer.provider.js";
-import { setMailTranslatorFactory } from "./translator.js";
 /**
- * Composition root of the communication context.
+ * Composition root of the mail context.
  *
  * Selects the mail transport exactly once (in `boot()`) from `MAIL_TRANSPORT`
- * and binds it into `CommunicationContext`, so facades and services never
+ * and binds it into `MailContext`, so facades and services never
  * look transports up themselves:
  *
  * - `smtp` (default) - Nodemailer (`MAIL_SERVICE`, `MAIL_HOST`, `MAIL_PORT`,
@@ -16,7 +15,7 @@ import { setMailTranslatorFactory } from "./translator.js";
  * - `console` - logs the message; dev/test with zero mail configuration
  * - `custom` - resolves `CUSTOM_MAILER`; bring your own SES/Postmark/Resend…
  */
-export class CommunicationServiceProvider extends ServiceProvider {
+export class MailServiceProvider extends ServiceProvider {
     register() {
         // Default registration: the Nodemailer transport under the port token,
         // with config getters wired here at the composition root (the adapter
@@ -53,13 +52,6 @@ export class CommunicationServiceProvider extends ServiceProvider {
         });
     }
     async boot() {
-        // Bind the default translation factory that supports `{placeholder}`
-        // interpolation into the message text.
-        setMailTranslatorFactory(async () => (key, params) => {
-            if (!params)
-                return key;
-            return Object.entries(params).reduce((acc, [k, v]) => acc.replaceAll(`{${k}}`, String(v)), key);
-        });
         const config = this.container.has(ConfigService)
             ? await this.container.resolve(ConfigService)
             : undefined;
@@ -71,8 +63,8 @@ export class CommunicationServiceProvider extends ServiceProvider {
             useValue: mailer,
             singleton: true,
         });
-        bindCommunicationContext({ mailer });
-        logger.debug("veap:communication", `Mail transport bound: ${mailer.constructor.name}`);
+        bindMailContext({ mailer });
+        logger.debug("veap:mail", `Mail transport bound: ${mailer.constructor.name}`);
     }
     async selectTransport(config) {
         const getVal = (key) => {
@@ -82,7 +74,7 @@ export class CommunicationServiceProvider extends ServiceProvider {
         const transport = getVal("MAIL_TRANSPORT")?.trim().toLowerCase();
         if (transport === "custom") {
             if (!this.container.has(CUSTOM_MAILER)) {
-                throw new Error("[Communication] MAIL_TRANSPORT=custom but no provider is registered under the CUSTOM_MAILER token (register an IMailer in a ServiceProvider).");
+                throw new Error("[Mail] MAIL_TRANSPORT=custom but no provider is registered under the CUSTOM_MAILER token (register an IMailer in a ServiceProvider).");
             }
             return this.container.resolve(CUSTOM_MAILER);
         }
@@ -93,11 +85,14 @@ export class CommunicationServiceProvider extends ServiceProvider {
             Boolean(getVal("GOOGLE_SMTP_APP_PASSWORD") || getVal("MAIL_PASSWORD"));
         const hasSmtpHostOrService = Boolean(getVal("MAIL_HOST") || getVal("MAIL_SERVICE"));
         if (!transport && !hasSmtpCredentials && !hasSmtpHostOrService) {
-            logger.warn("veap:communication", "MAIL_TRANSPORT is not set and no SMTP credentials (MAIL_USERNAME/MAIL_PASSWORD) or host (MAIL_HOST) are configured. Defaulting to ConsoleMailService (emails will be logged to server console).");
+            logger.warn("veap:mail", "MAIL_TRANSPORT is not set and no SMTP credentials (MAIL_USERNAME/MAIL_PASSWORD) or host (MAIL_HOST) are configured. Defaulting to ConsoleMailService (emails will be logged to server console).");
             return new ConsoleMailService((line) => logger.info("veap:mail", line));
         }
         // Default ("smtp" / unset with credentials/host): whatever register() wired - Nodemailer.
         return this.container.resolve(MAILER);
     }
 }
-export const MailServiceProvider = CommunicationServiceProvider;
+/**
+ * @deprecated Use `MailServiceProvider` instead.
+ */
+export const CommunicationServiceProvider = MailServiceProvider;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veap/mail",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Mail and communication transport abstraction for Veap",
   "bugs": "https://github.com/veapjs/veap-mail/issues",
   "repository": {
@@ -28,7 +28,7 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@veap/kernel": "0.2.0",
+    "@veap/kernel": "0.2.1",
     "nodemailer": "^10.0.1"
   },
   "devDependencies": {

package/dist/translator.d.ts

@@ -1,24 +0,0 @@
-/**
- * Translation hook for mailables.
- *
- * Lives in the application layer because building localized messages is a
- * use-case concern; the intl implementation (infrastructure) is injected here
- * once by `CommunicationServiceProvider` - so mailables never import intl
- * directly and the package never imports its own entry points (ADR-006).
- */
-export type Translator = (key: string, params?: Record<string, unknown>) => string;
-/**
- * Helper to interpolate template placeholders like `{name}` or `{code}`.
- */
-export declare function interpolateMailText(text: string, params?: Record<string, unknown>): string;
-/**
- * Binds the translation factory. Invoked per message build, so the locale
- * always reflects the current request.
- */
-export declare function setMailTranslatorFactory(factory: () => Promise<Translator>): void;
-/**
- * Returns the bound translator, falling back to simple `{param}`
- * interpolation into the raw key when intl has not bound one yet
- * (unit tests, early boot).
- */
-export declare function getMailTranslator(): Promise<Translator>;

package/dist/translator.js

@@ -1,31 +0,0 @@
-let translatorFactory = null;
-/**
- * Helper to interpolate template placeholders like `{name}` or `{code}`.
- */
-export function interpolateMailText(text, params) {
-    if (!params)
-        return text;
-    return Object.entries(params).reduce((acc, [k, v]) => acc.replaceAll(`{${k}}`, String(v)), text);
-}
-/**
- * Binds the translation factory. Invoked per message build, so the locale
- * always reflects the current request.
- */
-export function setMailTranslatorFactory(factory) {
-    translatorFactory = factory;
-}
-/**
- * Returns the bound translator, falling back to simple `{param}`
- * interpolation into the raw key when intl has not bound one yet
- * (unit tests, early boot).
- */
-export async function getMailTranslator() {
-    if (translatorFactory) {
-        const fn = await translatorFactory();
-        return (key, params) => {
-            const translated = fn(key, params);
-            return interpolateMailText(translated, params);
-        };
-    }
-    return (key, params) => interpolateMailText(key, params);
-}