@breadstone/archipel-platform-mailing 0.0.23 → 0.0.25

package/README.md

@@ -2,7 +2,19 @@
 
 Multi-strategy email delivery for NestJS with support for SMTP, Postmark, Resend, SendGrid, and Mailgun.
 
-## ⚠️ Environment Variables (Most Important)
+## Features
+
+- **Multi-provider** — Switch between SMTP, Postmark, Resend, SendGrid, or Mailgun via config
+- **Subpath imports** — Each provider lives in its own subpath — install only the SDK you need
+- **Template engines** — File-based or blob-based template fetching with variable substitution
+- **Health checks** — `MailHealthIndicator` for readiness probes (separate `/health` subpath)
+- **SMTP connection verification** — `SmtpConnectionVerifier` for verifying SMTP server reachability and sending test emails
+- **Attachment support** — Send file attachments with MIME-type validation and size limits (25 MB max)
+- **Header injection prevention** — Subject lines are automatically sanitized against SMTP header injection
+
+> **Deprecation notice:** `MailVerificationService` is deprecated. Use `SmtpConnectionVerifier` instead — it provides `verifyConnection()` and `sendTestEmail()` methods.
+
+## ⚠️ Environment Variables
 
 ### Core mailing configuration
 
@@ -37,18 +49,6 @@ Multi-strategy email delivery for NestJS with support for SMTP, Postmark, Resend
 | `MAIL_USER` | no       | `''`    | Health-check mail user |
 | `MAIL_PORT` | no       | `0`     | Health-check mail port |
 
-## Import Options
-
-```typescript
-import { MailModule, MailService } from '@breadstone/archipel-platform-mailing';
-```
-
-Provider-specific import:
-
-```typescript
-import { PostmarkDeliveryStrategy, POSTMARK_CONFIG_ENTRIES } from '@breadstone/archipel-platform-mailing/postmark';
-```
-
 ## Quick Start
 
 ```typescript
@@ -63,50 +63,65 @@ export class AppModule {}
 
 Set `MAIL_DELIVERY_STRATEGY` to one of: `smtp`, `postmark`, `resend`, `sendgrid`, `mailgun`, `log`.
 
-## Features
+## Supported Providers
 
-- **Multi-provider**: Switch between SMTP, Postmark, Resend, SendGrid, or Mailgun via config
-- **Subpath imports**: Each provider lives in its own subpath - install only the SDK you need
-- **Template engines**: File-based or blob-based template fetching with variable substitution
-- **Health checks**: Built-in `MailHealthIndicator` for readiness probes
-- **Email verification**: `MailVerificationService` for address verification flows
-- **Attachment support**: Send file attachments with MIME-type validation and size limits (25 MB max)
-- **Header injection prevention**: Subject lines are automatically sanitized against SMTP header injection
+| Subpath                                          | Class                      | SDK              |
+| ------------------------------------------------ | -------------------------- | ---------------- |
+| `@breadstone/archipel-platform-mailing/postmark` | `PostmarkDeliveryStrategy` | `postmark`       |
+| `@breadstone/archipel-platform-mailing/resend`   | `ResendDeliveryStrategy`   | `resend`         |
+| `@breadstone/archipel-platform-mailing/sendgrid` | `SendGridDeliveryStrategy` | `@sendgrid/mail` |
+| `@breadstone/archipel-platform-mailing/mailgun`  | `MailgunDeliveryStrategy`  | `mailgun.js`     |
 
-## Error Handling
+SMTP and Log strategies are built-in (no external SDK required).
 
-All delivery strategies throw a `MailDeliveryError` when email sending fails. This domain error wraps the underlying provider error and exposes structured metadata:
+## Import Options
 
 ```typescript
-import { MailDeliveryError } from '@breadstone/archipel-platform-mailing';
-
-try {
-  await mailService.send(options, content, true);
-} catch (error) {
-  if (error instanceof MailDeliveryError) {
-    console.error(error.provider); // 'postmark', 'smtp', 'resend', etc.
-    console.error(error.code); // 'MAIL_DELIVERY'
-    console.error(error.cause); // Original provider SDK error
-  }
-}
+// Main import (module, service)
+import { MailModule, MailService } from '@breadstone/archipel-platform-mailing';
+
+// Built-in strategies
+import { SmtpDeliveryStrategy } from '@breadstone/archipel-platform-mailing/smtp';
+import { LogDeliveryStrategy } from '@breadstone/archipel-platform-mailing/log';
+
+// Provider-specific (tree-shakable sub-exports)
+import { PostmarkDeliveryStrategy, POSTMARK_CONFIG_ENTRIES } from '@breadstone/archipel-platform-mailing/postmark';
+import { ResendDeliveryStrategy } from '@breadstone/archipel-platform-mailing/resend';
+import { SendGridDeliveryStrategy } from '@breadstone/archipel-platform-mailing/sendgrid';
+import { MailgunDeliveryStrategy } from '@breadstone/archipel-platform-mailing/mailgun';
+
+// Health indicator (optional)
+import { MailHealthIndicator } from '@breadstone/archipel-platform-mailing/health';
 ```
 
-| Property   | Type      | Description                                     |
-| ---------- | --------- | ----------------------------------------------- |
-| `code`     | `string`  | Always `'MAIL_DELIVERY'`                        |
-| `provider` | `string`  | Provider that failed (`smtp`, `postmark`, etc.) |
-| `cause`    | `unknown` | Original error from the provider SDK            |
+## Error Handling
 
-## Available Providers
+| Error Class         | Code            | When Thrown                         |
+| ------------------- | --------------- | ----------------------------------- |
+| `MailDeliveryError` | `MAIL_DELIVERY` | Provider SDK failure during sending |
 
-| Subpath                                          | Class                      | SDK              |
-| ------------------------------------------------ | -------------------------- | ---------------- |
-| `@breadstone/archipel-platform-mailing/postmark` | `PostmarkDeliveryStrategy` | `postmark`       |
-| `@breadstone/archipel-platform-mailing/resend`   | `ResendDeliveryStrategy`   | `resend`         |
-| `@breadstone/archipel-platform-mailing/sendgrid` | `SendGridDeliveryStrategy` | `@sendgrid/mail` |
-| `@breadstone/archipel-platform-mailing/mailgun`  | `MailgunDeliveryStrategy`  | `mailgun.js`     |
+## Lifecycle
 
-SMTP and Log strategies are built-in (no external SDK required).
+- **Startup (`OnModuleInit`):** `MailTemplateEngine` preloads and compiles templates.
+- **Shutdown (`OnModuleDestroy`):** `MailEventSubscriber` unsubscribes from event streams.
+
+## Peer Dependencies
+
+| Package                                       | Required | Notes                          |
+| --------------------------------------------- | -------- | ------------------------------ |
+| `@breadstone/archipel-platform-configuration` | Yes      | Typed config key support       |
+| `@nestjs/common`                              | Yes      | NestJS core                    |
+| `nodemailer`                                  | No       | Required for SMTP strategy     |
+| `postmark`                                    | No       | Required for Postmark provider |
+| `resend`                                      | No       | Required for Resend provider   |
+| `@sendgrid/mail`                              | No       | Required for SendGrid provider |
+| `mailgun.js`                                  | No       | Required for Mailgun provider  |
+| `@breadstone/archipel-platform-health`        | No       | Required for health indicator  |
+| `@nestjs/terminus`                            | No       | Required for health indicator  |
+
+## Documentation
+
+📖 **Package Docs:** [`.docs/packages/platform-mailing/index.md`](../../.docs/packages/platform-mailing/index.md)
 
 ## Development
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@breadstone/archipel-platform-mailing",
-  "version": "0.0.23",
+  "version": "0.0.25",
   "description": "Email delivery with strategy-based transport and template engines for NestJS applications.",
   "type": "commonjs",
   "main": "./src/index.js",
@@ -24,6 +24,9 @@
       ],
       "sendgrid": [
         "./src/sendgrid/index.d.ts"
+      ],
+      "health": [
+        "./src/health/index.d.ts"
       ]
     }
   },
@@ -56,12 +59,17 @@
       "types": "./src/sendgrid/index.d.ts",
       "default": "./src/sendgrid/index.js"
     },
+    "./health": {
+      "types": "./src/health/index.d.ts",
+      "default": "./src/health/index.js"
+    },
     "./package.json": "./package.json",
     "./smtp/index": "./src/smtp/index.js",
     "./postmark/index": "./src/postmark/index.js",
     "./resend/index": "./src/resend/index.js",
     "./sendgrid/index": "./src/sendgrid/index.js",
-    "./mailgun/index": "./src/mailgun/index.js"
+    "./mailgun/index": "./src/mailgun/index.js",
+    "./health/index": "./src/health/index.js"
   },
   "license": "MIT",
   "repository": {
@@ -91,14 +99,14 @@
     "README.md"
   ],
   "dependencies": {
-    "@breadstone/archipel-platform-blob-storage": "0.0.23",
-    "@breadstone/archipel-platform-configuration": "0.0.23",
-    "@breadstone/archipel-platform-core": "0.0.23",
-    "@breadstone/archipel-platform-health": "0.0.23",
-    "@breadstone/archipel-platform-resources": "0.0.23",
+    "@breadstone/archipel-platform-blob-storage": "0.0.25",
+    "@breadstone/archipel-platform-configuration": "0.0.25",
+    "@breadstone/archipel-platform-core": "0.0.25",
+    "@breadstone/archipel-platform-resources": "0.0.25",
     "tslib": "2.8.1"
   },
   "peerDependencies": {
+    "@breadstone/archipel-platform-health": ">=0.0.1",
     "@nestjs/common": ">=11.0.0",
     "@nestjs/terminus": ">=11.0.0",
     "@sendgrid/mail": ">=8.0.0",
@@ -110,6 +118,12 @@
     "rxjs": ">=7.0.0"
   },
   "peerDependenciesMeta": {
+    "@breadstone/archipel-platform-health": {
+      "optional": true
+    },
+    "@nestjs/terminus": {
+      "optional": true
+    },
     "@sendgrid/mail": {
       "optional": true
     },

package/src/{terminus → health}/MailHealthIndicator.d.ts

@@ -14,7 +14,7 @@ export declare class MailHealthIndicator implements IHealthIndicator {
      * @public
      */
     constructor(configService: ConfigService);
-    readonly key = "mail";
+    readonly key: string;
     /**
      * Checks if the mail configuration is valid.
      *

package/src/{terminus → health}/MailHealthIndicator.js

@@ -22,11 +22,11 @@ let MailHealthIndicator = class MailHealthIndicator {
      */
     constructor(configService) {
         // #endregion
-        //#region Properties
+        // #region Properties
         this.key = 'mail';
         this._configService = configService;
     }
-    //#endregion
+    // #endregion
     // #region Methods
     /**
      * Checks if the mail configuration is valid.
@@ -40,7 +40,7 @@ let MailHealthIndicator = class MailHealthIndicator {
         const mailPort = this._configService.tryGet(env_1.MAIL_PORT.key, 0);
         const isHealthy = mailHost !== '' && mailUser !== '' && mailPort > 0;
         return {
-            [this.key]: {
+            mail: {
                 status: isHealthy ? 'up' : 'down',
                 ...(isHealthy ? {} : { message: 'Mail configuration is invalid' }),
             },

package/src/health/index.d.ts

@@ -0,0 +1 @@
+export { MailHealthIndicator } from './MailHealthIndicator';

package/src/health/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MailHealthIndicator = void 0;
+var MailHealthIndicator_1 = require("./MailHealthIndicator");
+Object.defineProperty(exports, "MailHealthIndicator", { enumerable: true, get: function () { return MailHealthIndicator_1.MailHealthIndicator; } });
+//# sourceMappingURL=index.js.map

package/src/index.d.ts

@@ -5,8 +5,9 @@ export * from './MailTokens';
 export * from './models/IMailAttachment';
 export * from './services/MailService';
 export * from './services/MailVerificationService';
+export * from './services/SmtpConnectionVerifier';
 export * from './services/strategies/abstracts/DeliveryStrategyBase';
 export * from './templating/MailTemplateEngine';
 export * from './templating/strategies/abstracts/TemplateFetchStrategyBase';
-export * from './terminus/MailHealthIndicator';
 export * from './tokens/MailModule';
+export type { IMailModuleOptions } from './tokens/MailModule';

package/src/index.js

@@ -8,9 +8,9 @@ tslib_1.__exportStar(require("./MailTokens"), exports);
 tslib_1.__exportStar(require("./models/IMailAttachment"), exports);
 tslib_1.__exportStar(require("./services/MailService"), exports);
 tslib_1.__exportStar(require("./services/MailVerificationService"), exports);
+tslib_1.__exportStar(require("./services/SmtpConnectionVerifier"), exports);
 tslib_1.__exportStar(require("./services/strategies/abstracts/DeliveryStrategyBase"), exports);
 tslib_1.__exportStar(require("./templating/MailTemplateEngine"), exports);
 tslib_1.__exportStar(require("./templating/strategies/abstracts/TemplateFetchStrategyBase"), exports);
-tslib_1.__exportStar(require("./terminus/MailHealthIndicator"), exports);
 tslib_1.__exportStar(require("./tokens/MailModule"), exports);
 //# sourceMappingURL=index.js.map

package/src/services/MailVerificationService.d.ts

@@ -1,30 +1,19 @@
-import { ConfigService } from '@breadstone/archipel-platform-configuration';
+import { SmtpConnectionVerifier } from './SmtpConnectionVerifier';
 /**
- * Verifies SMTP server connectivity. Does **not** validate individual email
- * addresses - only checks whether the configured SMTP transport is reachable.
+ * @deprecated Use {@link SmtpConnectionVerifier} instead. This class will be
+ * removed in a future major release.
  *
  * @public
- * @deprecated Renamed to `SmtpConnectionVerifier` in a future release to better
- * reflect its actual purpose. Prefer wrapping this in a health-check rather
- * than calling it directly.
  */
-export declare class MailVerificationService {
-    private readonly _logger;
-    private readonly _transporter;
+export declare class MailVerificationService extends SmtpConnectionVerifier {
     /**
-     * Constructs a new instance of the `MailVerificationService` class.
+     * Verifies SMTP server connectivity.
+     *
+     * @deprecated Use {@link SmtpConnectionVerifier.verifyConnection} instead.
+     * The `email` parameter was never used.
      *
      * @public
+     * @param _email - Unused. Kept for backward compatibility.
      */
-    constructor(configService: ConfigService);
-    /**
-     * Verifies if the email address is valid and reachable.
-     * @param email - The email address to verify
-     * @returns Promise<boolean> - Resolves true if email exists, false otherwise
-     */
-    verifyEmail(email: string): Promise<boolean>;
-    /**
-     * Send an email for testing purposes or verification
-     */
-    sendTestEmail(from: string, to: string, subject: string, text: string): Promise<void>;
+    verifyEmail(_email: string): Promise<boolean>;
 }

package/src/services/MailVerificationService.js

@@ -1,84 +1,34 @@
 "use strict";
 // #region Imports
-var MailVerificationService_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MailVerificationService = void 0;
 const tslib_1 = require("tslib");
-const archipel_platform_configuration_1 = require("@breadstone/archipel-platform-configuration");
 const common_1 = require("@nestjs/common");
-const nodemailer = tslib_1.__importStar(require("nodemailer"));
-const env_1 = require("../env");
+const SmtpConnectionVerifier_1 = require("./SmtpConnectionVerifier");
 // #endregion
 /**
- * Verifies SMTP server connectivity. Does **not** validate individual email
- * addresses - only checks whether the configured SMTP transport is reachable.
+ * @deprecated Use {@link SmtpConnectionVerifier} instead. This class will be
+ * removed in a future major release.
  *
  * @public
- * @deprecated Renamed to `SmtpConnectionVerifier` in a future release to better
- * reflect its actual purpose. Prefer wrapping this in a health-check rather
- * than calling it directly.
  */
-let MailVerificationService = MailVerificationService_1 = class MailVerificationService {
-    // #endregion
-    // #region Ctor
+let MailVerificationService = class MailVerificationService extends SmtpConnectionVerifier_1.SmtpConnectionVerifier {
+    // #region Methods
     /**
-     * Constructs a new instance of the `MailVerificationService` class.
+     * Verifies SMTP server connectivity.
+     *
+     * @deprecated Use {@link SmtpConnectionVerifier.verifyConnection} instead.
+     * The `email` parameter was never used.
      *
      * @public
+     * @param _email - Unused. Kept for backward compatibility.
      */
-    constructor(configService) {
-        // #region Fields
-        this._logger = new common_1.Logger(MailVerificationService_1.name);
-        this._transporter = nodemailer.createTransport({
-            host: configService.tryGet(env_1.MAIL_SMTP_HOST.key, 'localhost'),
-            port: 465,
-            secure: true,
-            auth: {
-                user: configService.tryGet(env_1.MAIL_SMTP_USER.key, ''),
-                pass: configService.tryGet(env_1.MAIL_SMTP_PASSWORD.key, ''),
-            },
-        });
-    }
-    // #endregion
-    /**
-     * Verifies if the email address is valid and reachable.
-     * @param email - The email address to verify
-     * @returns Promise<boolean> - Resolves true if email exists, false otherwise
-     */
-    async verifyEmail(email) {
-        return new Promise((resolve, reject) => {
-            this._transporter.verify((error, success) => {
-                if (error) {
-                    this._logger.error('SMTP verification error:', error);
-                    resolve(false);
-                    return; // Couldn't connect or verify
-                }
-                // Here we perform a simple check if the server is reachable
-                if (success) {
-                    // Nodemailer does not explicitly verify an email exists but confirms server readiness.
-                    resolve(true);
-                }
-                else {
-                    resolve(false);
-                }
-            });
-        });
-    }
-    /**
-     * Send an email for testing purposes or verification
-     */
-    async sendTestEmail(from, to, subject, text) {
-        await this._transporter.sendMail({
-            from,
-            to,
-            subject,
-            text,
-        });
+    async verifyEmail(_email) {
+        return this.verifyConnection();
     }
 };
 exports.MailVerificationService = MailVerificationService;
-exports.MailVerificationService = MailVerificationService = MailVerificationService_1 = tslib_1.__decorate([
-    (0, common_1.Injectable)(),
-    tslib_1.__metadata("design:paramtypes", [archipel_platform_configuration_1.ConfigService])
+exports.MailVerificationService = MailVerificationService = tslib_1.__decorate([
+    (0, common_1.Injectable)()
 ], MailVerificationService);
 //# sourceMappingURL=MailVerificationService.js.map

package/src/services/SmtpConnectionVerifier.d.ts

@@ -0,0 +1,30 @@
+import { ConfigService } from '@breadstone/archipel-platform-configuration';
+/**
+ * Verifies SMTP server connectivity. Does **not** validate individual email
+ * addresses — only checks whether the configured SMTP transport is reachable.
+ *
+ * @public
+ */
+export declare class SmtpConnectionVerifier {
+    private readonly _logger;
+    private readonly _transporter;
+    /**
+     * Constructs a new instance of the {@link SmtpConnectionVerifier} class.
+     *
+     * @public
+     */
+    constructor(configService: ConfigService);
+    /**
+     * Verifies that the configured SMTP server is reachable.
+     *
+     * @public
+     * @returns `true` if the SMTP server is reachable, `false` otherwise.
+     */
+    verifyConnection(): Promise<boolean>;
+    /**
+     * Send an email for testing purposes.
+     *
+     * @public
+     */
+    sendTestEmail(from: string, to: string, subject: string, text: string): Promise<void>;
+}

package/src/services/SmtpConnectionVerifier.js

@@ -0,0 +1,78 @@
+"use strict";
+// #region Imports
+var SmtpConnectionVerifier_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SmtpConnectionVerifier = void 0;
+const tslib_1 = require("tslib");
+const archipel_platform_configuration_1 = require("@breadstone/archipel-platform-configuration");
+const common_1 = require("@nestjs/common");
+const nodemailer = tslib_1.__importStar(require("nodemailer"));
+const env_1 = require("../env");
+// #endregion
+/**
+ * Verifies SMTP server connectivity. Does **not** validate individual email
+ * addresses — only checks whether the configured SMTP transport is reachable.
+ *
+ * @public
+ */
+let SmtpConnectionVerifier = SmtpConnectionVerifier_1 = class SmtpConnectionVerifier {
+    // #endregion
+    // #region Ctor
+    /**
+     * Constructs a new instance of the {@link SmtpConnectionVerifier} class.
+     *
+     * @public
+     */
+    constructor(configService) {
+        // #region Fields
+        this._logger = new common_1.Logger(SmtpConnectionVerifier_1.name);
+        this._transporter = nodemailer.createTransport({
+            host: configService.tryGet(env_1.MAIL_SMTP_HOST.key, 'localhost'),
+            port: 465,
+            secure: true,
+            auth: {
+                user: configService.tryGet(env_1.MAIL_SMTP_USER.key, ''),
+                pass: configService.tryGet(env_1.MAIL_SMTP_PASSWORD.key, ''),
+            },
+        });
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * Verifies that the configured SMTP server is reachable.
+     *
+     * @public
+     * @returns `true` if the SMTP server is reachable, `false` otherwise.
+     */
+    async verifyConnection() {
+        return new Promise((resolve) => {
+            this._transporter.verify((error, success) => {
+                if (error) {
+                    this._logger.error('SMTP verification error:', error);
+                    resolve(false);
+                    return;
+                }
+                resolve(!!success);
+            });
+        });
+    }
+    /**
+     * Send an email for testing purposes.
+     *
+     * @public
+     */
+    async sendTestEmail(from, to, subject, text) {
+        await this._transporter.sendMail({
+            from,
+            to,
+            subject,
+            text,
+        });
+    }
+};
+exports.SmtpConnectionVerifier = SmtpConnectionVerifier;
+exports.SmtpConnectionVerifier = SmtpConnectionVerifier = SmtpConnectionVerifier_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [archipel_platform_configuration_1.ConfigService])
+], SmtpConnectionVerifier);
+//# sourceMappingURL=SmtpConnectionVerifier.js.map

package/src/tokens/MailModule.d.ts

@@ -1,7 +1,38 @@
+import type { IConfigRegistryEntry } from '@breadstone/archipel-platform-configuration';
+import { type DynamicModule } from '@nestjs/common';
+/**
+ * Options for configuring the {@link MailModule}.
+ *
+ * @public
+ */
+export interface IMailModuleOptions {
+    /**
+     * Whether to register the module globally.
+     * Defaults to `true`.
+     */
+    readonly isGlobal?: boolean;
+    /**
+     * Additional or overriding configuration entries.
+     * Merged with the platform default entries.
+     */
+    readonly configEntries?: ReadonlyArray<Omit<IConfigRegistryEntry, 'module'>>;
+}
 /**
  * Represents the mail module.
  *
+ * Delivery and template strategies are resolved at runtime based on
+ * configuration keys `MAIL_DELIVERY_STRATEGY` and `MAIL_TEMPLATE_STRATEGY`.
+ *
  * @public
  */
 export declare class MailModule {
+    /**
+     * Registers the mail module with optional configuration.
+     *
+     * @param options - Module registration options.
+     * @returns A configured `DynamicModule`.
+     *
+     * @public
+     */
+    static register(options?: IMailModuleOptions): DynamicModule;
 }

package/src/tokens/MailModule.js

@@ -1,12 +1,12 @@
 "use strict";
 // #region Imports
+var MailModule_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MailModule = void 0;
 const tslib_1 = require("tslib");
 const archipel_platform_blob_storage_1 = require("@breadstone/archipel-platform-blob-storage");
 const archipel_platform_configuration_1 = require("@breadstone/archipel-platform-configuration");
 const archipel_platform_core_1 = require("@breadstone/archipel-platform-core");
-const archipel_platform_health_1 = require("@breadstone/archipel-platform-health");
 const archipel_platform_resources_1 = require("@breadstone/archipel-platform-resources");
 const common_1 = require("@nestjs/common");
 const env_1 = require("../env");
@@ -14,91 +14,94 @@ const MailEventSubscriber_1 = require("../events/listeners/MailEventSubscriber")
 const MailTokens_1 = require("../MailTokens");
 const MailService_1 = require("../services/MailService");
 const MailVerificationService_1 = require("../services/MailVerificationService");
+const SmtpConnectionVerifier_1 = require("../services/SmtpConnectionVerifier");
 const MailTemplateEngine_1 = require("../templating/MailTemplateEngine");
-const MailHealthIndicator_1 = require("../terminus/MailHealthIndicator");
-// #endregion
 /**
  * Represents the mail module.
  *
+ * Delivery and template strategies are resolved at runtime based on
+ * configuration keys `MAIL_DELIVERY_STRATEGY` and `MAIL_TEMPLATE_STRATEGY`.
+ *
  * @public
  */
-let MailModule = class MailModule {
-};
-exports.MailModule = MailModule;
-exports.MailModule = MailModule = tslib_1.__decorate([
-    (0, common_1.Global)(),
-    (0, common_1.Module)({
-        imports: [
-            archipel_platform_configuration_1.ConfigModule.register('platform-mailing', env_1.PLATFORM_MAILING_CONFIG_ENTRIES),
-            archipel_platform_blob_storage_1.BlobModule,
-            archipel_platform_core_1.EventModule,
-            archipel_platform_health_1.HealthModule,
-        ],
-        providers: [
-            {
-                provide: MailTokens_1.MAIL_TEMPLATE_FETCH_STRATEGY_TOKEN,
-                useFactory: async (configService, blobService, resourceManager) => {
-                    const templateStrategy = configService.get(env_1.MAIL_TEMPLATE_STRATEGY.key);
-                    if (templateStrategy === 'file') {
-                        const { FileTemplateFetchStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('../templating/strategies/FileTemplateFetchStrategy')));
-                        return new FileTemplateFetchStrategy(resourceManager);
-                    }
-                    if (templateStrategy === 'blob') {
-                        const { BlobTemplateFetchStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('../templating/strategies/BlobTemplateFetchStrategy')));
-                        return new BlobTemplateFetchStrategy(blobService);
-                    }
-                    throw new Error(`Unknown template strategy: ${templateStrategy}`);
+let MailModule = MailModule_1 = class MailModule {
+    /**
+     * Registers the mail module with optional configuration.
+     *
+     * @param options - Module registration options.
+     * @returns A configured `DynamicModule`.
+     *
+     * @public
+     */
+    static register(options) {
+        const isGlobal = options?.isGlobal ?? true;
+        const configEntries = options?.configEntries ?? env_1.PLATFORM_MAILING_CONFIG_ENTRIES;
+        return {
+            module: MailModule_1,
+            global: isGlobal,
+            imports: [archipel_platform_configuration_1.ConfigModule.register('platform-mailing', configEntries), archipel_platform_blob_storage_1.BlobModule, archipel_platform_core_1.EventModule],
+            providers: [
+                {
+                    provide: MailTokens_1.MAIL_TEMPLATE_FETCH_STRATEGY_TOKEN,
+                    useFactory: async (configService, blobService, resourceManager) => {
+                        const templateStrategy = configService.get(env_1.MAIL_TEMPLATE_STRATEGY.key);
+                        if (templateStrategy === 'file') {
+                            const { FileTemplateFetchStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('../templating/strategies/FileTemplateFetchStrategy')));
+                            return new FileTemplateFetchStrategy(resourceManager);
+                        }
+                        if (templateStrategy === 'blob') {
+                            const { BlobTemplateFetchStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('../templating/strategies/BlobTemplateFetchStrategy')));
+                            return new BlobTemplateFetchStrategy(blobService);
+                        }
+                        throw new Error(`Unknown template strategy: ${templateStrategy}`);
+                    },
+                    inject: [archipel_platform_configuration_1.ConfigService, archipel_platform_blob_storage_1.BlobService, archipel_platform_resources_1.ResourceManager],
                 },
-                inject: [archipel_platform_configuration_1.ConfigService, archipel_platform_blob_storage_1.BlobService, archipel_platform_resources_1.ResourceManager],
-            },
-            {
-                provide: MailTokens_1.MAIL_DELIVERY_STRATEGY_TOKEN,
-                useFactory: async (configService) => {
-                    const deliveryStrategy = configService.get(env_1.MAIL_DELIVERY_STRATEGY.key);
-                    if (deliveryStrategy === 'log') {
-                        const { LogDeliveryStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('../services/strategies/LogDeliveryStrategy')));
-                        return new LogDeliveryStrategy();
-                    }
-                    if (deliveryStrategy === 'smtp') {
-                        const { SmtpDeliveryStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('../services/strategies/SmtpDeliveryStrategy')));
-                        return new SmtpDeliveryStrategy(configService);
-                    }
-                    if (deliveryStrategy === 'postmark') {
-                        const { PostmarkDeliveryStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('../services/strategies/PostmarkDeliveryStrategy')));
-                        return new PostmarkDeliveryStrategy(configService);
-                    }
-                    if (deliveryStrategy === 'resend') {
-                        const { ResendDeliveryStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('../services/strategies/ResendDeliveryStrategy')));
-                        return new ResendDeliveryStrategy(configService);
-                    }
-                    if (deliveryStrategy === 'sendgrid') {
-                        const { SendGridDeliveryStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('../services/strategies/SendGridDeliveryStrategy')));
-                        return new SendGridDeliveryStrategy(configService);
-                    }
-                    if (deliveryStrategy === 'mailgun') {
-                        const { MailgunDeliveryStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('../services/strategies/MailgunDeliveryStrategy')));
-                        return new MailgunDeliveryStrategy(configService);
-                    }
-                    throw new Error(`Unknown delivery strategy: ${deliveryStrategy}`);
+                {
+                    provide: MailTokens_1.MAIL_DELIVERY_STRATEGY_TOKEN,
+                    useFactory: async (configService) => {
+                        const deliveryStrategy = configService.get(env_1.MAIL_DELIVERY_STRATEGY.key);
+                        if (deliveryStrategy === 'log') {
+                            const { LogDeliveryStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('../services/strategies/LogDeliveryStrategy')));
+                            return new LogDeliveryStrategy();
+                        }
+                        if (deliveryStrategy === 'smtp') {
+                            const { SmtpDeliveryStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('../services/strategies/SmtpDeliveryStrategy')));
+                            return new SmtpDeliveryStrategy(configService);
+                        }
+                        if (deliveryStrategy === 'postmark') {
+                            const { PostmarkDeliveryStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('../services/strategies/PostmarkDeliveryStrategy')));
+                            return new PostmarkDeliveryStrategy(configService);
+                        }
+                        if (deliveryStrategy === 'resend') {
+                            const { ResendDeliveryStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('../services/strategies/ResendDeliveryStrategy')));
+                            return new ResendDeliveryStrategy(configService);
+                        }
+                        if (deliveryStrategy === 'sendgrid') {
+                            const { SendGridDeliveryStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('../services/strategies/SendGridDeliveryStrategy')));
+                            return new SendGridDeliveryStrategy(configService);
+                        }
+                        if (deliveryStrategy === 'mailgun') {
+                            const { MailgunDeliveryStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('../services/strategies/MailgunDeliveryStrategy')));
+                            return new MailgunDeliveryStrategy(configService);
+                        }
+                        throw new Error(`Unknown delivery strategy: ${deliveryStrategy}`);
+                    },
+                    inject: [archipel_platform_configuration_1.ConfigService],
                 },
-                inject: [archipel_platform_configuration_1.ConfigService],
-            },
-            archipel_platform_core_1.ContentTemplateEngine,
-            MailService_1.MailService,
-            MailTemplateEngine_1.MailTemplateEngine,
-            MailVerificationService_1.MailVerificationService,
-            MailHealthIndicator_1.MailHealthIndicator,
-            MailEventSubscriber_1.MailEventSubscriber,
-            {
-                provide: 'MAIL_HEALTH_INDICATOR_BOOTSTRAP',
-                useFactory: (orchestrator, indicator) => {
-                    orchestrator.registerIndicator(indicator);
-                    return true;
-                },
-                inject: [archipel_platform_health_1.HealthOrchestrator, MailHealthIndicator_1.MailHealthIndicator],
-            },
-        ],
-        exports: [MailService_1.MailService, MailVerificationService_1.MailVerificationService, MailHealthIndicator_1.MailHealthIndicator],
-    })
+                archipel_platform_core_1.ContentTemplateEngine,
+                MailService_1.MailService,
+                MailTemplateEngine_1.MailTemplateEngine,
+                MailVerificationService_1.MailVerificationService,
+                SmtpConnectionVerifier_1.SmtpConnectionVerifier,
+                MailEventSubscriber_1.MailEventSubscriber,
+            ],
+            exports: [MailService_1.MailService, MailVerificationService_1.MailVerificationService, SmtpConnectionVerifier_1.SmtpConnectionVerifier],
+        };
+    }
+};
+exports.MailModule = MailModule;
+exports.MailModule = MailModule = MailModule_1 = tslib_1.__decorate([
+    (0, common_1.Module)({})
 ], MailModule);
 //# sourceMappingURL=MailModule.js.map