@breadstone/archipel-platform-mailing 0.0.32 → 0.0.34

package/package.json

@@ -1,29 +1,39 @@
 {
   "name": "@breadstone/archipel-platform-mailing",
-  "version": "0.0.32",
+  "version": "0.0.34",
   "description": "Email delivery with strategy-based transport and template engines for NestJS applications.",
   "type": "commonjs",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",
+  "sideEffects": false,
   "typesVersions": {
     "*": {
-      "log": [
-        "./src/log/index.d.ts"
+      "delivering/logger": [
+        "./src/delivering/strategies/logger/index.d.ts"
       ],
-      "smtp": [
-        "./src/smtp/index.d.ts"
+      "delivering/smtp": [
+        "./src/delivering/strategies/smtp/index.d.ts"
       ],
-      "mailgun": [
-        "./src/mailgun/index.d.ts"
+      "delivering/mailgun": [
+        "./src/delivering/strategies/mailgun/index.d.ts"
       ],
-      "postmark": [
-        "./src/postmark/index.d.ts"
+      "delivering/postmark": [
+        "./src/delivering/strategies/postmark/index.d.ts"
       ],
-      "resend": [
-        "./src/resend/index.d.ts"
+      "delivering/resend": [
+        "./src/delivering/strategies/resend/index.d.ts"
       ],
-      "sendgrid": [
-        "./src/sendgrid/index.d.ts"
+      "delivering/sendgrid": [
+        "./src/delivering/strategies/sendgrid/index.d.ts"
+      ],
+      "templating/blob": [
+        "./src/templating/strategies/blob/index.d.ts"
+      ],
+      "templating/file": [
+        "./src/templating/strategies/file/index.d.ts"
+      ],
+      "templating/database": [
+        "./src/templating/strategies/database/index.d.ts"
       ],
       "health": [
         "./src/health/index.d.ts"
@@ -35,40 +45,65 @@
       "types": "./src/index.d.ts",
       "default": "./src/index.js"
     },
-    "./log": {
-      "types": "./src/log/index.d.ts",
-      "default": "./src/log/index.js"
+    "./delivering/logger": {
+      "types": "./src/delivering/strategies/logger/index.d.ts",
+      "default": "./src/delivering/strategies/logger/index.js"
+    },
+    "./delivering/smtp": {
+      "types": "./src/delivering/strategies/smtp/index.d.ts",
+      "default": "./src/delivering/strategies/smtp/index.js"
+    },
+    "./delivering/mailgun": {
+      "types": "./src/delivering/strategies/mailgun/index.d.ts",
+      "default": "./src/delivering/strategies/mailgun/index.js"
+    },
+    "./delivering/postmark": {
+      "types": "./src/delivering/strategies/postmark/index.d.ts",
+      "default": "./src/delivering/strategies/postmark/index.js"
     },
-    "./smtp": {
-      "types": "./src/smtp/index.d.ts",
-      "default": "./src/smtp/index.js"
+    "./delivering/resend": {
+      "types": "./src/delivering/strategies/resend/index.d.ts",
+      "default": "./src/delivering/strategies/resend/index.js"
     },
-    "./mailgun": {
-      "types": "./src/mailgun/index.d.ts",
-      "default": "./src/mailgun/index.js"
+    "./delivering/sendgrid": {
+      "types": "./src/delivering/strategies/sendgrid/index.d.ts",
+      "default": "./src/delivering/strategies/sendgrid/index.js"
     },
-    "./postmark": {
-      "types": "./src/postmark/index.d.ts",
-      "default": "./src/postmark/index.js"
+    "./templating/blob": {
+      "types": "./src/templating/strategies/blob/index.d.ts",
+      "default": "./src/templating/strategies/blob/index.js"
     },
-    "./resend": {
-      "types": "./src/resend/index.d.ts",
-      "default": "./src/resend/index.js"
+    "./templating/file": {
+      "types": "./src/templating/strategies/file/index.d.ts",
+      "default": "./src/templating/strategies/file/index.js"
     },
-    "./sendgrid": {
-      "types": "./src/sendgrid/index.d.ts",
-      "default": "./src/sendgrid/index.js"
+    "./templating/database": {
+      "types": "./src/templating/strategies/database/index.d.ts",
+      "default": "./src/templating/strategies/database/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",
+    "./delivering/strategies/logger": "./src/delivering/strategies/logger/index.js",
+    "./delivering/strategies/logger/index": "./src/delivering/strategies/logger/index.js",
+    "./delivering/strategies/smtp": "./src/delivering/strategies/smtp/index.js",
+    "./delivering/strategies/smtp/index": "./src/delivering/strategies/smtp/index.js",
+    "./delivering/strategies/postmark": "./src/delivering/strategies/postmark/index.js",
+    "./delivering/strategies/postmark/index": "./src/delivering/strategies/postmark/index.js",
+    "./delivering/strategies/resend": "./src/delivering/strategies/resend/index.js",
+    "./delivering/strategies/resend/index": "./src/delivering/strategies/resend/index.js",
+    "./delivering/strategies/sendgrid": "./src/delivering/strategies/sendgrid/index.js",
+    "./delivering/strategies/sendgrid/index": "./src/delivering/strategies/sendgrid/index.js",
+    "./delivering/strategies/mailgun": "./src/delivering/strategies/mailgun/index.js",
+    "./delivering/strategies/mailgun/index": "./src/delivering/strategies/mailgun/index.js",
+    "./templating/strategies/blob": "./src/templating/strategies/blob/index.js",
+    "./templating/strategies/blob/index": "./src/templating/strategies/blob/index.js",
+    "./templating/strategies/file": "./src/templating/strategies/file/index.js",
+    "./templating/strategies/file/index": "./src/templating/strategies/file/index.js",
+    "./templating/strategies/database": "./src/templating/strategies/database/index.js",
+    "./templating/strategies/database/index": "./src/templating/strategies/database/index.js",
     "./health/index": "./src/health/index.js"
   },
   "license": "MIT",
@@ -99,10 +134,10 @@
     "README.md"
   ],
   "dependencies": {
-    "@breadstone/archipel-platform-blob-storage": "0.0.32",
-    "@breadstone/archipel-platform-configuration": "0.0.32",
-    "@breadstone/archipel-platform-core": "0.0.32",
-    "@breadstone/archipel-platform-resources": "0.0.32",
+    "@breadstone/archipel-platform-blob-storage": "0.0.34",
+    "@breadstone/archipel-platform-configuration": "0.0.34",
+    "@breadstone/archipel-platform-core": "0.0.34",
+    "@breadstone/archipel-platform-resources": "0.0.34",
     "tslib": "2.8.1"
   },
   "peerDependencies": {

package/src/{tokens/MailModule.d.ts → MailModule.d.ts}

@@ -1,5 +1,6 @@
 import type { IConfigRegistryEntry } from '@breadstone/archipel-platform-configuration';
-import { type DynamicModule } from '@nestjs/common';
+import { type DynamicModule, type Provider } from '@nestjs/common';
+import type { IMailTemplateRepository } from './ports/IMailTemplateRepository';
 /**
  * Options for configuring the {@link MailModule}.
  *
@@ -16,6 +17,21 @@ export interface IMailModuleOptions {
      * Merged with the platform default entries.
      */
     readonly configEntries?: ReadonlyArray<Omit<IConfigRegistryEntry, 'module'>>;
+    /**
+     * Provider for the `IMailTemplateRepository` port.
+     * Required when `MAIL_TEMPLATE_STRATEGY` is set to `'database'`.
+     *
+     * Example:
+     * ```typescript
+     * MailModule.register({
+     *   templateRepositoryProvider: {
+     *     provide: MAIL_TEMPLATE_REPOSITORY_TOKEN,
+     *     useClass: PrismaMailTemplateRepository,
+     *   }
+     * })
+     * ```
+     */
+    readonly templateRepositoryProvider?: Provider<IMailTemplateRepository>;
 }
 /**
  * Represents the mail module.

package/src/{tokens/MailModule.js → MailModule.js}

@@ -9,13 +9,13 @@ const archipel_platform_configuration_1 = require("@breadstone/archipel-platform
 const archipel_platform_core_1 = require("@breadstone/archipel-platform-core");
 const archipel_platform_resources_1 = require("@breadstone/archipel-platform-resources");
 const common_1 = require("@nestjs/common");
-const env_1 = require("../env");
-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 env_1 = require("./env");
+const MailEventSubscriber_1 = require("./events/listeners/MailEventSubscriber");
+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 MailTokens_1 = require("./tokens/MailTokens");
 /**
  * Represents the mail module.
  *
@@ -36,53 +36,71 @@ let MailModule = MailModule_1 = class MailModule {
     static register(options) {
         const isGlobal = options?.isGlobal ?? true;
         const configEntries = options?.configEntries ?? env_1.PLATFORM_MAILING_CONFIG_ENTRIES;
+        const additionalProviders = [];
+        if (options?.templateRepositoryProvider) {
+            additionalProviders.push(options.templateRepositoryProvider);
+        }
         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: [
+                ...additionalProviders,
                 {
                     provide: MailTokens_1.MAIL_TEMPLATE_FETCH_STRATEGY_TOKEN,
-                    useFactory: async (configService, blobService, resourceManager) => {
+                    useFactory: async (configService, blobService, resourceManager, ...extra) => {
                         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')));
+                            const { FileTemplateFetchStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('./templating/strategies/file/FileTemplateFetchStrategy')));
                             return new FileTemplateFetchStrategy(resourceManager);
                         }
                         if (templateStrategy === 'blob') {
-                            const { BlobTemplateFetchStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('../templating/strategies/BlobTemplateFetchStrategy')));
+                            const { BlobTemplateFetchStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('./templating/strategies/blob/BlobTemplateFetchStrategy')));
                             return new BlobTemplateFetchStrategy(blobService);
                         }
+                        if (templateStrategy === 'database') {
+                            const repository = extra[0];
+                            if (!repository) {
+                                throw new Error("Template strategy 'database' requires a templateRepositoryProvider in MailModule.register() options.");
+                            }
+                            const { DatabaseTemplateFetchStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('./templating/strategies/database/DatabaseTemplateFetchStrategy')));
+                            return new DatabaseTemplateFetchStrategy(repository);
+                        }
                         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,
+                        ...(options?.templateRepositoryProvider ? [MailTokens_1.MAIL_TEMPLATE_REPOSITORY_TOKEN] : []),
+                    ],
                 },
                 {
                     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')));
+                            const { LogDeliveryStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('./delivering/strategies/logger/LogDeliveryStrategy')));
                             return new LogDeliveryStrategy();
                         }
                         if (deliveryStrategy === 'smtp') {
-                            const { SmtpDeliveryStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('../services/strategies/SmtpDeliveryStrategy')));
+                            const { SmtpDeliveryStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('./delivering/strategies/smtp/SmtpDeliveryStrategy')));
                             return new SmtpDeliveryStrategy(configService);
                         }
                         if (deliveryStrategy === 'postmark') {
-                            const { PostmarkDeliveryStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('../services/strategies/PostmarkDeliveryStrategy')));
+                            const { PostmarkDeliveryStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('./delivering/strategies/postmark/PostmarkDeliveryStrategy')));
                             return new PostmarkDeliveryStrategy(configService);
                         }
                         if (deliveryStrategy === 'resend') {
-                            const { ResendDeliveryStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('../services/strategies/ResendDeliveryStrategy')));
+                            const { ResendDeliveryStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('./delivering/strategies/resend/ResendDeliveryStrategy')));
                             return new ResendDeliveryStrategy(configService);
                         }
                         if (deliveryStrategy === 'sendgrid') {
-                            const { SendGridDeliveryStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('../services/strategies/SendGridDeliveryStrategy')));
+                            const { SendGridDeliveryStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('./delivering/strategies/sendgrid/SendGridDeliveryStrategy')));
                             return new SendGridDeliveryStrategy(configService);
                         }
                         if (deliveryStrategy === 'mailgun') {
-                            const { MailgunDeliveryStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('../services/strategies/MailgunDeliveryStrategy')));
+                            const { MailgunDeliveryStrategy } = await Promise.resolve().then(() => tslib_1.__importStar(require('./delivering/strategies/mailgun/MailgunDeliveryStrategy')));
                             return new MailgunDeliveryStrategy(configService);
                         }
                         throw new Error(`Unknown delivery strategy: ${deliveryStrategy}`);

package/src/{services/strategies → delivering/strategies/logger}/LogDeliveryStrategy.d.ts

@@ -1,4 +1,4 @@
-import { DeliveryStrategyBase } from './abstracts/DeliveryStrategyBase';
+import { DeliveryStrategyBase } from '../abstracts/DeliveryStrategyBase';
 /**
  * The `LogDeliveryStrategy` class.
  *
@@ -12,5 +12,5 @@ export declare class LogDeliveryStrategy extends DeliveryStrategyBase {
      * @public
      */
     constructor();
-    send(from: string, to: string, subject: string, content: string, isHtml: boolean, _attachments?: Array<import('../../models/IMailAttachment').IMailAttachment>): Promise<void>;
+    send(from: string, to: string, subject: string, content: string, isHtml: boolean, _attachments?: Array<import('../../../models/IMailAttachment').IMailAttachment>): Promise<void>;
 }

package/src/{services/strategies → delivering/strategies/logger}/LogDeliveryStrategy.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LogDeliveryStrategy = void 0;
 const common_1 = require("@nestjs/common");
-const DeliveryStrategyBase_1 = require("./abstracts/DeliveryStrategyBase");
+const DeliveryStrategyBase_1 = require("../abstracts/DeliveryStrategyBase");
 // #endregion
 /**
  * The `LogDeliveryStrategy` class.

package/src/delivering/strategies/logger/index.d.ts

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

package/src/{logger → delivering/strategies/logger}/index.js

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

package/src/{services/strategies → delivering/strategies/mailgun}/MailgunDeliveryStrategy.d.ts

@@ -1,5 +1,5 @@
 import { ConfigService } from '@breadstone/archipel-platform-configuration';
-import { DeliveryStrategyBase } from './abstracts/DeliveryStrategyBase';
+import { DeliveryStrategyBase } from '../abstracts/DeliveryStrategyBase';
 /**
  * Delivers emails via the Mailgun API.
  *
@@ -25,5 +25,5 @@ export declare class MailgunDeliveryStrategy extends DeliveryStrategyBase {
      * @param content - Email body content (plain text or HTML)
      * @param isHtml - Flag to indicate whether the email is HTML (true) or plain text (false)
      */
-    send(from: string, to: string, subject: string, content: string, isHtml: boolean, _attachments?: Array<import('../../models/IMailAttachment').IMailAttachment>): Promise<void>;
+    send(from: string, to: string, subject: string, content: string, isHtml: boolean, _attachments?: Array<import('../../../models/IMailAttachment').IMailAttachment>): Promise<void>;
 }

package/src/{services/strategies → delivering/strategies/mailgun}/MailgunDeliveryStrategy.js

@@ -6,9 +6,9 @@ const tslib_1 = require("tslib");
 const common_1 = require("@nestjs/common");
 const form_data_1 = tslib_1.__importDefault(require("form-data"));
 const mailgun_js_1 = tslib_1.__importDefault(require("mailgun.js"));
-const env_1 = require("../../env");
-const MailDeliveryError_1 = require("../../errors/MailDeliveryError");
-const DeliveryStrategyBase_1 = require("./abstracts/DeliveryStrategyBase");
+const env_1 = require("../../../env");
+const MailDeliveryError_1 = require("../../../errors/MailDeliveryError");
+const DeliveryStrategyBase_1 = require("../abstracts/DeliveryStrategyBase");
 // #endregion
 /**
  * Delivers emails via the Mailgun API.

package/src/delivering/strategies/mailgun/index.d.ts

@@ -0,0 +1,2 @@
+export { MAILGUN_API_KEY, MAILGUN_CONFIG_ENTRIES, MAILGUN_DOMAIN } from './env';
+export { MailgunDeliveryStrategy } from './MailgunDeliveryStrategy';

package/src/{mailgun → delivering/strategies/mailgun}/index.js

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAILGUN_DOMAIN = exports.MAILGUN_CONFIG_ENTRIES = exports.MAILGUN_API_KEY = exports.MailgunDeliveryStrategy = void 0;
-var MailgunDeliveryStrategy_1 = require("../services/strategies/MailgunDeliveryStrategy");
-Object.defineProperty(exports, "MailgunDeliveryStrategy", { enumerable: true, get: function () { return MailgunDeliveryStrategy_1.MailgunDeliveryStrategy; } });
+exports.MailgunDeliveryStrategy = exports.MAILGUN_DOMAIN = exports.MAILGUN_CONFIG_ENTRIES = exports.MAILGUN_API_KEY = void 0;
 var env_1 = require("./env");
 Object.defineProperty(exports, "MAILGUN_API_KEY", { enumerable: true, get: function () { return env_1.MAILGUN_API_KEY; } });
 Object.defineProperty(exports, "MAILGUN_CONFIG_ENTRIES", { enumerable: true, get: function () { return env_1.MAILGUN_CONFIG_ENTRIES; } });
 Object.defineProperty(exports, "MAILGUN_DOMAIN", { enumerable: true, get: function () { return env_1.MAILGUN_DOMAIN; } });
+var MailgunDeliveryStrategy_1 = require("./MailgunDeliveryStrategy");
+Object.defineProperty(exports, "MailgunDeliveryStrategy", { enumerable: true, get: function () { return MailgunDeliveryStrategy_1.MailgunDeliveryStrategy; } });
 //# sourceMappingURL=index.js.map

package/src/{services/strategies → delivering/strategies/postmark}/PostmarkDeliveryStrategy.d.ts

@@ -1,5 +1,5 @@
 import { ConfigService } from '@breadstone/archipel-platform-configuration';
-import { DeliveryStrategyBase } from './abstracts/DeliveryStrategyBase';
+import { DeliveryStrategyBase } from '../abstracts/DeliveryStrategyBase';
 /**
  * The `PostmarkDeliveryStrategy` class.
  *
@@ -24,5 +24,5 @@ export declare class PostmarkDeliveryStrategy extends DeliveryStrategyBase {
      * @param content - Email body content (plain text or HTML)
      * @param isHtml - Flag to indicate whether the email is HTML (true) or plain text (false)
      */
-    send(from: string, to: string, subject: string, content: string, isHtml: boolean, _attachments?: Array<import('../../models/IMailAttachment').IMailAttachment>): Promise<void>;
+    send(from: string, to: string, subject: string, content: string, isHtml: boolean, _attachments?: Array<import('../../../models/IMailAttachment').IMailAttachment>): Promise<void>;
 }

package/src/{services/strategies → delivering/strategies/postmark}/PostmarkDeliveryStrategy.js

@@ -4,9 +4,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PostmarkDeliveryStrategy = void 0;
 const common_1 = require("@nestjs/common");
 const postmark_1 = require("postmark");
-const env_1 = require("../../env");
-const MailDeliveryError_1 = require("../../errors/MailDeliveryError");
-const DeliveryStrategyBase_1 = require("./abstracts/DeliveryStrategyBase");
+const env_1 = require("../../../env");
+const MailDeliveryError_1 = require("../../../errors/MailDeliveryError");
+const DeliveryStrategyBase_1 = require("../abstracts/DeliveryStrategyBase");
 // #endregion
 /**
  * The `PostmarkDeliveryStrategy` class.

package/src/delivering/strategies/postmark/index.d.ts

@@ -0,0 +1,2 @@
+export { POSTMARK_API_KEY, POSTMARK_CONFIG_ENTRIES } from './env';
+export { PostmarkDeliveryStrategy } from './PostmarkDeliveryStrategy';

package/src/{postmark → delivering/strategies/postmark}/index.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.POSTMARK_CONFIG_ENTRIES = exports.POSTMARK_API_KEY = exports.PostmarkDeliveryStrategy = void 0;
-var PostmarkDeliveryStrategy_1 = require("../services/strategies/PostmarkDeliveryStrategy");
-Object.defineProperty(exports, "PostmarkDeliveryStrategy", { enumerable: true, get: function () { return PostmarkDeliveryStrategy_1.PostmarkDeliveryStrategy; } });
+exports.PostmarkDeliveryStrategy = exports.POSTMARK_CONFIG_ENTRIES = exports.POSTMARK_API_KEY = void 0;
 var env_1 = require("./env");
 Object.defineProperty(exports, "POSTMARK_API_KEY", { enumerable: true, get: function () { return env_1.POSTMARK_API_KEY; } });
 Object.defineProperty(exports, "POSTMARK_CONFIG_ENTRIES", { enumerable: true, get: function () { return env_1.POSTMARK_CONFIG_ENTRIES; } });
+var PostmarkDeliveryStrategy_1 = require("./PostmarkDeliveryStrategy");
+Object.defineProperty(exports, "PostmarkDeliveryStrategy", { enumerable: true, get: function () { return PostmarkDeliveryStrategy_1.PostmarkDeliveryStrategy; } });
 //# sourceMappingURL=index.js.map

package/src/{services/strategies → delivering/strategies/resend}/ResendDeliveryStrategy.d.ts

@@ -1,5 +1,5 @@
 import { ConfigService } from '@breadstone/archipel-platform-configuration';
-import { DeliveryStrategyBase } from './abstracts/DeliveryStrategyBase';
+import { DeliveryStrategyBase } from '../abstracts/DeliveryStrategyBase';
 /**
  * Delivers emails via the Resend API.
  *
@@ -24,5 +24,5 @@ export declare class ResendDeliveryStrategy extends DeliveryStrategyBase {
      * @param content - Email body content (plain text or HTML)
      * @param isHtml - Flag to indicate whether the email is HTML (true) or plain text (false)
      */
-    send(from: string, to: string, subject: string, content: string, isHtml: boolean, _attachments?: Array<import('../../models/IMailAttachment').IMailAttachment>): Promise<void>;
+    send(from: string, to: string, subject: string, content: string, isHtml: boolean, _attachments?: Array<import('../../../models/IMailAttachment').IMailAttachment>): Promise<void>;
 }

package/src/{services/strategies → delivering/strategies/resend}/ResendDeliveryStrategy.js

@@ -4,9 +4,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ResendDeliveryStrategy = void 0;
 const common_1 = require("@nestjs/common");
 const resend_1 = require("resend");
-const env_1 = require("../../env");
-const MailDeliveryError_1 = require("../../errors/MailDeliveryError");
-const DeliveryStrategyBase_1 = require("./abstracts/DeliveryStrategyBase");
+const env_1 = require("../../../env");
+const MailDeliveryError_1 = require("../../../errors/MailDeliveryError");
+const DeliveryStrategyBase_1 = require("../abstracts/DeliveryStrategyBase");
 // #endregion
 /**
  * Delivers emails via the Resend API.

package/src/delivering/strategies/resend/index.d.ts

@@ -0,0 +1,2 @@
+export { RESEND_API_KEY, RESEND_CONFIG_ENTRIES } from './env';
+export { ResendDeliveryStrategy } from './ResendDeliveryStrategy';

package/src/{resend → delivering/strategies/resend}/index.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RESEND_CONFIG_ENTRIES = exports.RESEND_API_KEY = exports.ResendDeliveryStrategy = void 0;
-var ResendDeliveryStrategy_1 = require("../services/strategies/ResendDeliveryStrategy");
-Object.defineProperty(exports, "ResendDeliveryStrategy", { enumerable: true, get: function () { return ResendDeliveryStrategy_1.ResendDeliveryStrategy; } });
+exports.ResendDeliveryStrategy = exports.RESEND_CONFIG_ENTRIES = exports.RESEND_API_KEY = void 0;
 var env_1 = require("./env");
 Object.defineProperty(exports, "RESEND_API_KEY", { enumerable: true, get: function () { return env_1.RESEND_API_KEY; } });
 Object.defineProperty(exports, "RESEND_CONFIG_ENTRIES", { enumerable: true, get: function () { return env_1.RESEND_CONFIG_ENTRIES; } });
+var ResendDeliveryStrategy_1 = require("./ResendDeliveryStrategy");
+Object.defineProperty(exports, "ResendDeliveryStrategy", { enumerable: true, get: function () { return ResendDeliveryStrategy_1.ResendDeliveryStrategy; } });
 //# sourceMappingURL=index.js.map

package/src/{services/strategies → delivering/strategies/sendgrid}/SendGridDeliveryStrategy.d.ts

@@ -1,5 +1,5 @@
 import { ConfigService } from '@breadstone/archipel-platform-configuration';
-import { DeliveryStrategyBase } from './abstracts/DeliveryStrategyBase';
+import { DeliveryStrategyBase } from '../abstracts/DeliveryStrategyBase';
 /**
  * Delivers emails via the SendGrid API.
  *
@@ -23,5 +23,5 @@ export declare class SendGridDeliveryStrategy extends DeliveryStrategyBase {
      * @param content - Email body content (plain text or HTML)
      * @param isHtml - Flag to indicate whether the email is HTML (true) or plain text (false)
      */
-    send(from: string, to: string, subject: string, content: string, isHtml: boolean, _attachments?: Array<import('../../models/IMailAttachment').IMailAttachment>): Promise<void>;
+    send(from: string, to: string, subject: string, content: string, isHtml: boolean, _attachments?: Array<import('../../../models/IMailAttachment').IMailAttachment>): Promise<void>;
 }

package/src/{services/strategies → delivering/strategies/sendgrid}/SendGridDeliveryStrategy.js

@@ -5,9 +5,9 @@ exports.SendGridDeliveryStrategy = void 0;
 const tslib_1 = require("tslib");
 const common_1 = require("@nestjs/common");
 const mail_1 = tslib_1.__importDefault(require("@sendgrid/mail"));
-const env_1 = require("../../env");
-const MailDeliveryError_1 = require("../../errors/MailDeliveryError");
-const DeliveryStrategyBase_1 = require("./abstracts/DeliveryStrategyBase");
+const env_1 = require("../../../env");
+const MailDeliveryError_1 = require("../../../errors/MailDeliveryError");
+const DeliveryStrategyBase_1 = require("../abstracts/DeliveryStrategyBase");
 // #endregion
 /**
  * Delivers emails via the SendGrid API.

package/src/delivering/strategies/sendgrid/index.d.ts

@@ -0,0 +1,2 @@
+export { SENDGRID_API_KEY, SENDGRID_CONFIG_ENTRIES } from './env';
+export { SendGridDeliveryStrategy } from './SendGridDeliveryStrategy';

package/src/{sendgrid → delivering/strategies/sendgrid}/index.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SENDGRID_CONFIG_ENTRIES = exports.SENDGRID_API_KEY = exports.SendGridDeliveryStrategy = void 0;
-var SendGridDeliveryStrategy_1 = require("../services/strategies/SendGridDeliveryStrategy");
-Object.defineProperty(exports, "SendGridDeliveryStrategy", { enumerable: true, get: function () { return SendGridDeliveryStrategy_1.SendGridDeliveryStrategy; } });
+exports.SendGridDeliveryStrategy = exports.SENDGRID_CONFIG_ENTRIES = exports.SENDGRID_API_KEY = void 0;
 var env_1 = require("./env");
 Object.defineProperty(exports, "SENDGRID_API_KEY", { enumerable: true, get: function () { return env_1.SENDGRID_API_KEY; } });
 Object.defineProperty(exports, "SENDGRID_CONFIG_ENTRIES", { enumerable: true, get: function () { return env_1.SENDGRID_CONFIG_ENTRIES; } });
+var SendGridDeliveryStrategy_1 = require("./SendGridDeliveryStrategy");
+Object.defineProperty(exports, "SendGridDeliveryStrategy", { enumerable: true, get: function () { return SendGridDeliveryStrategy_1.SendGridDeliveryStrategy; } });
 //# sourceMappingURL=index.js.map

package/src/{services/strategies → delivering/strategies/smtp}/SmtpDeliveryStrategy.d.ts

@@ -1,5 +1,5 @@
 import { ConfigService } from '@breadstone/archipel-platform-configuration';
-import { DeliveryStrategyBase } from './abstracts/DeliveryStrategyBase';
+import { DeliveryStrategyBase } from '../abstracts/DeliveryStrategyBase';
 /**
  * The `SmtpDeliveryStrategy` class.
  *
@@ -24,5 +24,5 @@ export declare class SmtpDeliveryStrategy extends DeliveryStrategyBase {
      * @param content - Email body content (plain text or HTML)
      * @param isHtml - Flag to indicate whether the email is HTML (true) or plain text (false)
      */
-    send(from: string, to: string, subject: string, content: string, isHtml: boolean, _attachments?: Array<import('../../models/IMailAttachment').IMailAttachment>): Promise<void>;
+    send(from: string, to: string, subject: string, content: string, isHtml: boolean, _attachments?: Array<import('../../../models/IMailAttachment').IMailAttachment>): Promise<void>;
 }

package/src/{services/strategies → delivering/strategies/smtp}/SmtpDeliveryStrategy.js

@@ -4,9 +4,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SmtpDeliveryStrategy = void 0;
 const common_1 = require("@nestjs/common");
 const nodemailer_1 = require("nodemailer");
-const env_1 = require("../../env");
-const MailDeliveryError_1 = require("../../errors/MailDeliveryError");
-const DeliveryStrategyBase_1 = require("./abstracts/DeliveryStrategyBase");
+const env_1 = require("../../../env");
+const MailDeliveryError_1 = require("../../../errors/MailDeliveryError");
+const DeliveryStrategyBase_1 = require("../abstracts/DeliveryStrategyBase");
 // #endregion
 /**
  * The `SmtpDeliveryStrategy` class.

package/src/{smtp → delivering/strategies/smtp}/index.d.ts

@@ -1,2 +1,2 @@
-export { SmtpDeliveryStrategy } from '../services/strategies/SmtpDeliveryStrategy';
 export { SMTP_CONFIG_ENTRIES, SMTP_HOST, SMTP_PASSWORD, SMTP_PORT, SMTP_SECURE, SMTP_USER } from './env';
+export { SmtpDeliveryStrategy } from './SmtpDeliveryStrategy';

package/src/{smtp → delivering/strategies/smtp}/index.js

@@ -1,8 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SMTP_USER = exports.SMTP_SECURE = exports.SMTP_PORT = exports.SMTP_PASSWORD = exports.SMTP_HOST = exports.SMTP_CONFIG_ENTRIES = exports.SmtpDeliveryStrategy = void 0;
-var SmtpDeliveryStrategy_1 = require("../services/strategies/SmtpDeliveryStrategy");
-Object.defineProperty(exports, "SmtpDeliveryStrategy", { enumerable: true, get: function () { return SmtpDeliveryStrategy_1.SmtpDeliveryStrategy; } });
+exports.SmtpDeliveryStrategy = exports.SMTP_USER = exports.SMTP_SECURE = exports.SMTP_PORT = exports.SMTP_PASSWORD = exports.SMTP_HOST = exports.SMTP_CONFIG_ENTRIES = void 0;
 var env_1 = require("./env");
 Object.defineProperty(exports, "SMTP_CONFIG_ENTRIES", { enumerable: true, get: function () { return env_1.SMTP_CONFIG_ENTRIES; } });
 Object.defineProperty(exports, "SMTP_HOST", { enumerable: true, get: function () { return env_1.SMTP_HOST; } });
@@ -10,4 +8,6 @@ Object.defineProperty(exports, "SMTP_PASSWORD", { enumerable: true, get: functio
 Object.defineProperty(exports, "SMTP_PORT", { enumerable: true, get: function () { return env_1.SMTP_PORT; } });
 Object.defineProperty(exports, "SMTP_SECURE", { enumerable: true, get: function () { return env_1.SMTP_SECURE; } });
 Object.defineProperty(exports, "SMTP_USER", { enumerable: true, get: function () { return env_1.SMTP_USER; } });
+var SmtpDeliveryStrategy_1 = require("./SmtpDeliveryStrategy");
+Object.defineProperty(exports, "SmtpDeliveryStrategy", { enumerable: true, get: function () { return SmtpDeliveryStrategy_1.SmtpDeliveryStrategy; } });
 //# sourceMappingURL=index.js.map

package/src/env.js

@@ -65,7 +65,7 @@ exports.MAIL_PORT = (0, archipel_platform_configuration_1.createConfigKey)('MAIL
 /** All configuration entries required by `platform-mailing`. */
 exports.PLATFORM_MAILING_CONFIG_ENTRIES = [
     // Strategy
-    { key: exports.MAIL_TEMPLATE_STRATEGY, required: true, description: 'Template-fetch strategy (file, blob).' },
+    { key: exports.MAIL_TEMPLATE_STRATEGY, required: true, description: 'Template-fetch strategy (file, blob, database).' },
     {
         key: exports.MAIL_DELIVERY_STRATEGY,
         required: true,

package/src/events/listeners/MailEventSubscriber.d.ts

@@ -1,5 +1,5 @@
-import { OnModuleDestroy } from '@nestjs/common';
 import { EventHub } from '@breadstone/archipel-platform-core';
+import { OnModuleDestroy } from '@nestjs/common';
 import { MailService } from '../../services/MailService';
 /**
  * Bridges verification email events to the {@link MailService} delivery workflow.
@@ -9,6 +9,7 @@ import { MailService } from '../../services/MailService';
 export declare class MailEventSubscriber implements OnModuleDestroy {
     private readonly _mailService;
     private readonly _subscription;
+    private readonly _logger;
     /**
      * Initializes a new instance of the {@link MailEventSubscriber} class.
      *

package/src/events/listeners/MailEventSubscriber.js

@@ -1,10 +1,11 @@
 "use strict";
 // #region Imports
+var MailEventSubscriber_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MailEventSubscriber = void 0;
 const tslib_1 = require("tslib");
-const common_1 = require("@nestjs/common");
 const archipel_platform_core_1 = require("@breadstone/archipel-platform-core");
+const common_1 = require("@nestjs/common");
 const MailService_1 = require("../../services/MailService");
 const MailEventKeys_1 = require("../MailEventKeys");
 // #endregion
@@ -13,7 +14,7 @@ const MailEventKeys_1 = require("../MailEventKeys");
  *
  * @public
  */
-let MailEventSubscriber = class MailEventSubscriber {
+let MailEventSubscriber = MailEventSubscriber_1 = class MailEventSubscriber {
     // #endregion
     // #region Ctor
     /**
@@ -24,11 +25,16 @@ let MailEventSubscriber = class MailEventSubscriber {
      * @param eventHub The shared event hub that emits verification email requests.
      */
     constructor(mailService, eventHub) {
+        this._logger = new common_1.Logger(MailEventSubscriber_1.name);
         this._mailService = mailService;
         this._subscription = eventHub.observe(MailEventKeys_1.SEND_MAIL_EVENT_KEY).subscribe({
             next: (payload) => {
+                this._logger.debug(`Received mail event for recipient ${(0, archipel_platform_core_1.maskSensitive)(payload.recipientEmail)} with subject "${(0, archipel_platform_core_1.maskSensitive)(payload.subject)}"`);
                 void this.handle(payload);
             },
+            error: (err) => {
+                this._logger.error('Error handling mail event', err);
+            },
         });
     }
     // #endregion
@@ -60,7 +66,7 @@ let MailEventSubscriber = class MailEventSubscriber {
     }
 };
 exports.MailEventSubscriber = MailEventSubscriber;
-exports.MailEventSubscriber = MailEventSubscriber = tslib_1.__decorate([
+exports.MailEventSubscriber = MailEventSubscriber = MailEventSubscriber_1 = tslib_1.__decorate([
     (0, common_1.Injectable)(),
     tslib_1.__metadata("design:paramtypes", [MailService_1.MailService, archipel_platform_core_1.EventHub])
 ], MailEventSubscriber);

package/src/index.d.ts

@@ -1,13 +1,14 @@
+export * from './delivering/strategies/abstracts/DeliveryStrategyBase';
 export * from './env';
 export * from './errors/MailDeliveryError';
 export * from './events';
-export * from './MailTokens';
+export * from './MailModule';
 export * from './models/IMailAttachment';
+export * from './models/IMailTemplate';
+export * from './ports/IMailTemplateRepository';
 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 './tokens/MailModule';
-export type { IMailModuleOptions } from './tokens/MailModule';
+export * from './tokens/MailTokens';

package/src/index.js

@@ -1,16 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./delivering/strategies/abstracts/DeliveryStrategyBase"), exports);
 tslib_1.__exportStar(require("./env"), exports);
 tslib_1.__exportStar(require("./errors/MailDeliveryError"), exports);
 tslib_1.__exportStar(require("./events"), exports);
-tslib_1.__exportStar(require("./MailTokens"), exports);
+tslib_1.__exportStar(require("./MailModule"), exports);
 tslib_1.__exportStar(require("./models/IMailAttachment"), exports);
+tslib_1.__exportStar(require("./models/IMailTemplate"), exports);
+tslib_1.__exportStar(require("./ports/IMailTemplateRepository"), 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("./tokens/MailModule"), exports);
+tslib_1.__exportStar(require("./tokens/MailTokens"), exports);
 //# sourceMappingURL=index.js.map

package/src/models/IMailTemplate.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Represents a single mail template record stored in a persistent store.
+ *
+ * @public
+ */
+export interface IMailTemplate {
+    /**
+     * Unique template key used to identify this template (e.g. `AuthRegister`, `AppointmentInvitation`).
+     */
+    readonly key: string;
+    /**
+     * Locale identifier (e.g. `de`, `en`). Used for multi-language support.
+     * When `undefined`, it is the default/fallback template.
+     */
+    readonly locale?: string;
+    /**
+     * Default subject line for this template.
+     * Can contain placeholders (e.g. `{{appName}}`).
+     */
+    readonly subject: string;
+    /**
+     * HTML body of the template. Contains Handlebars-style placeholders.
+     */
+    readonly htmlBody?: string;
+    /**
+     * Plain-text body of the template. Contains Handlebars-style placeholders.
+     */
+    readonly txtBody?: string;
+    /**
+     * Human-readable description of this template's purpose.
+     */
+    readonly description?: string;
+    /**
+     * List of placeholder names expected by this template (for documentation/validation).
+     */
+    readonly placeholders?: ReadonlyArray<string>;
+}

package/src/models/IMailTemplate.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IMailTemplate.js.map

package/src/ports/IMailTemplateRepository.d.ts

@@ -0,0 +1,39 @@
+import type { IMailTemplate } from '../models/IMailTemplate';
+/**
+ * Port interface for mail template persistence.
+ *
+ * Applications must implement this interface and register the implementation
+ * via the `MAIL_TEMPLATE_REPOSITORY_TOKEN` when using the `database` template strategy.
+ *
+ * @public
+ */
+export interface IMailTemplateRepository {
+    /**
+     * Finds a template by its unique key and optional locale.
+     * When no locale is provided, returns the default (locale-agnostic) template.
+     *
+     * @param key - The template key (e.g. `AuthRegister`).
+     * @param locale - Optional locale identifier (e.g. `de`, `en`).
+     * @returns The matching template, or `undefined` if not found.
+     */
+    findByKey(key: string, locale?: string): Promise<IMailTemplate | undefined>;
+    /**
+     * Returns all templates available in the store.
+     */
+    findAll(): Promise<Array<IMailTemplate>>;
+    /**
+     * Creates or updates a template. Upsert semantics: if a template with the
+     * same `key` and `locale` exists, it is overwritten.
+     *
+     * @param template - The template to persist.
+     * @returns The persisted template.
+     */
+    upsert(template: IMailTemplate): Promise<IMailTemplate>;
+    /**
+     * Deletes a template by key and locale.
+     *
+     * @param key - The template key.
+     * @param locale - Optional locale. When omitted, deletes the default template.
+     */
+    delete(key: string, locale?: string): Promise<void>;
+}

package/src/ports/IMailTemplateRepository.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IMailTemplateRepository.js.map

package/src/services/MailService.d.ts

@@ -1,7 +1,7 @@
 import { ConfigService } from '@breadstone/archipel-platform-configuration';
+import { DeliveryStrategyBase } from '../delivering/strategies/abstracts/DeliveryStrategyBase';
 import { type IMailAttachment } from '../models/IMailAttachment';
 import { MailTemplateEngine } from '../templating/MailTemplateEngine';
-import { DeliveryStrategyBase } from './strategies/abstracts/DeliveryStrategyBase';
 /**
  * Represents the `MailService` class.
  *

package/src/services/MailService.js

@@ -5,11 +5,11 @@ exports.MailService = void 0;
 const tslib_1 = require("tslib");
 const archipel_platform_configuration_1 = require("@breadstone/archipel-platform-configuration");
 const common_1 = require("@nestjs/common");
+const DeliveryStrategyBase_1 = require("../delivering/strategies/abstracts/DeliveryStrategyBase");
 const env_1 = require("../env");
 const IMailAttachment_1 = require("../models/IMailAttachment");
-const MailTokens_1 = require("../MailTokens");
 const MailTemplateEngine_1 = require("../templating/MailTemplateEngine");
-const DeliveryStrategyBase_1 = require("./strategies/abstracts/DeliveryStrategyBase");
+const MailTokens_1 = require("../tokens/MailTokens");
 // #endregion
 /**
  * Represents the `MailService` class.

package/src/templating/MailTemplateEngine.d.ts

@@ -1,6 +1,6 @@
 import { ContentTemplateEngine } from '@breadstone/archipel-platform-core';
 import { OnModuleInit } from '@nestjs/common';
-import { MailTemplateFormat } from '../MailTokens';
+import { MailTemplateFormat } from '../tokens/MailTokens';
 import { TemplateFetchStrategyBase } from './strategies/abstracts/TemplateFetchStrategyBase';
 /**
  * The `MailTemplateEngine` class.

package/src/templating/MailTemplateEngine.js

@@ -5,7 +5,7 @@ exports.MailTemplateEngine = void 0;
 const tslib_1 = require("tslib");
 const archipel_platform_core_1 = require("@breadstone/archipel-platform-core");
 const common_1 = require("@nestjs/common");
-const MailTokens_1 = require("../MailTokens");
+const MailTokens_1 = require("../tokens/MailTokens");
 const TemplateFetchStrategyBase_1 = require("./strategies/abstracts/TemplateFetchStrategyBase");
 // #endregion
 /**

package/src/templating/strategies/{BlobTemplateFetchStrategy.d.ts → blob/BlobTemplateFetchStrategy.d.ts}

@@ -1,6 +1,6 @@
 import { BlobService } from '@breadstone/archipel-platform-blob-storage';
-import { IMailTemplateVariants } from '../../MailTokens';
-import { TemplateFetchStrategyBase } from './abstracts/TemplateFetchStrategyBase';
+import { IMailTemplateVariants } from '../../../tokens/MailTokens';
+import { TemplateFetchStrategyBase } from '../abstracts/TemplateFetchStrategyBase';
 /**
  * The `BlobTemplateFetchStrategy` class.
  *

package/src/templating/strategies/{BlobTemplateFetchStrategy.js → blob/BlobTemplateFetchStrategy.js}

@@ -5,7 +5,7 @@ exports.BlobTemplateFetchStrategy = void 0;
 const archipel_platform_blob_storage_1 = require("@breadstone/archipel-platform-blob-storage");
 const common_1 = require("@nestjs/common");
 const node_path_1 = require("node:path");
-const TemplateFetchStrategyBase_1 = require("./abstracts/TemplateFetchStrategyBase");
+const TemplateFetchStrategyBase_1 = require("../abstracts/TemplateFetchStrategyBase");
 // #endregion
 /**
  * The `BlobTemplateFetchStrategy` class.

package/src/templating/strategies/blob/index.d.ts

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

package/src/templating/strategies/blob/index.js

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

package/src/templating/strategies/database/DatabaseTemplateFetchStrategy.d.ts

@@ -0,0 +1,26 @@
+import type { IMailTemplateRepository } from '../../../ports/IMailTemplateRepository';
+import type { IMailTemplateVariants } from '../../../tokens/MailTokens';
+import { TemplateFetchStrategyBase } from '../abstracts/TemplateFetchStrategyBase';
+/**
+ * Template fetch strategy that loads templates from a database via the
+ * {@link IMailTemplateRepository} port.
+ *
+ * Applications provide the concrete repository implementation at module
+ * registration time. This strategy loads all templates on module init
+ * and caches them in-memory.
+ *
+ * @public
+ */
+export declare class DatabaseTemplateFetchStrategy extends TemplateFetchStrategyBase {
+    private readonly _repository;
+    private readonly _logger;
+    constructor(repository: IMailTemplateRepository);
+    /**
+     * Loads all templates from the database and returns them grouped by key.
+     * Only the default locale (no locale or first match) is loaded into the
+     * in-memory cache used by `MailTemplateEngine`.
+     *
+     * @public
+     */
+    load(): Promise<Record<string, IMailTemplateVariants>>;
+}

package/src/templating/strategies/database/DatabaseTemplateFetchStrategy.js

@@ -0,0 +1,65 @@
+"use strict";
+// #region Imports
+var DatabaseTemplateFetchStrategy_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseTemplateFetchStrategy = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const MailTokens_1 = require("../../../tokens/MailTokens");
+const TemplateFetchStrategyBase_1 = require("../abstracts/TemplateFetchStrategyBase");
+// #endregion
+/**
+ * Template fetch strategy that loads templates from a database via the
+ * {@link IMailTemplateRepository} port.
+ *
+ * Applications provide the concrete repository implementation at module
+ * registration time. This strategy loads all templates on module init
+ * and caches them in-memory.
+ *
+ * @public
+ */
+let DatabaseTemplateFetchStrategy = DatabaseTemplateFetchStrategy_1 = class DatabaseTemplateFetchStrategy extends TemplateFetchStrategyBase_1.TemplateFetchStrategyBase {
+    // #endregion
+    // #region Ctor
+    constructor(repository) {
+        super();
+        this._logger = new common_1.Logger(DatabaseTemplateFetchStrategy_1.name);
+        this._repository = repository;
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * Loads all templates from the database and returns them grouped by key.
+     * Only the default locale (no locale or first match) is loaded into the
+     * in-memory cache used by `MailTemplateEngine`.
+     *
+     * @public
+     */
+    async load() {
+        const templates = {};
+        const allTemplates = await this._repository.findAll();
+        for (const template of allTemplates) {
+            const key = template.key;
+            if (!templates[key]) {
+                templates[key] = {};
+            }
+            // Only set if not already filled (first match wins — default locale preferred)
+            if (template.htmlBody && !templates[key].html) {
+                templates[key].html = template.htmlBody;
+            }
+            if (template.txtBody && !templates[key].txt) {
+                templates[key].txt = template.txtBody;
+            }
+        }
+        const templateCount = Object.keys(templates).length;
+        this._logger.log(`${templateCount} template(s) loaded from database`);
+        return templates;
+    }
+};
+exports.DatabaseTemplateFetchStrategy = DatabaseTemplateFetchStrategy;
+exports.DatabaseTemplateFetchStrategy = DatabaseTemplateFetchStrategy = DatabaseTemplateFetchStrategy_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(0, (0, common_1.Inject)(MailTokens_1.MAIL_TEMPLATE_REPOSITORY_TOKEN)),
+    tslib_1.__metadata("design:paramtypes", [Object])
+], DatabaseTemplateFetchStrategy);
+//# sourceMappingURL=DatabaseTemplateFetchStrategy.js.map

package/src/templating/strategies/database/index.d.ts

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

package/src/templating/strategies/database/index.js

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

package/src/templating/strategies/{FileTemplateFetchStrategy.d.ts → file/FileTemplateFetchStrategy.d.ts}

@@ -1,6 +1,6 @@
 import { ResourceManager } from '@breadstone/archipel-platform-resources';
-import { TemplateFetchStrategyBase } from './abstracts/TemplateFetchStrategyBase';
-import { IMailTemplateVariants } from '../../MailTokens';
+import { IMailTemplateVariants } from '../../../tokens/MailTokens';
+import { TemplateFetchStrategyBase } from '../abstracts/TemplateFetchStrategyBase';
 /**
  * The `FileTemplateFetchStrategy` class.
  *

package/src/templating/strategies/{FileTemplateFetchStrategy.js → file/FileTemplateFetchStrategy.js}

@@ -4,9 +4,9 @@ var FileTemplateFetchStrategy_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FileTemplateFetchStrategy = void 0;
 const tslib_1 = require("tslib");
-const common_1 = require("@nestjs/common");
 const archipel_platform_resources_1 = require("@breadstone/archipel-platform-resources");
-const TemplateFetchStrategyBase_1 = require("./abstracts/TemplateFetchStrategyBase");
+const common_1 = require("@nestjs/common");
+const TemplateFetchStrategyBase_1 = require("../abstracts/TemplateFetchStrategyBase");
 // #endregion
 /**
  * The `FileTemplateFetchStrategy` class.

package/src/templating/strategies/file/index.d.ts

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

package/src/templating/strategies/file/index.js

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

package/src/{MailTokens.d.ts → tokens/MailTokens.d.ts}

@@ -5,6 +5,7 @@
  */
 export declare const MAIL_TEMPLATE_FETCH_STRATEGY_TOKEN: unique symbol;
 export declare const MAIL_DELIVERY_STRATEGY_TOKEN: unique symbol;
+export declare const MAIL_TEMPLATE_REPOSITORY_TOKEN: unique symbol;
 /**
  * Union type of all supported template formats.
  */

package/src/{MailTokens.js → tokens/MailTokens.js}

@@ -7,7 +7,8 @@
  */
 // #endregion
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAIL_DELIVERY_STRATEGY_TOKEN = exports.MAIL_TEMPLATE_FETCH_STRATEGY_TOKEN = void 0;
+exports.MAIL_TEMPLATE_REPOSITORY_TOKEN = exports.MAIL_DELIVERY_STRATEGY_TOKEN = exports.MAIL_TEMPLATE_FETCH_STRATEGY_TOKEN = void 0;
 exports.MAIL_TEMPLATE_FETCH_STRATEGY_TOKEN = Symbol('MailTemplateFetchStrategy');
 exports.MAIL_DELIVERY_STRATEGY_TOKEN = Symbol('MailDeliveryStrategy');
+exports.MAIL_TEMPLATE_REPOSITORY_TOKEN = Symbol('MailTemplateRepository');
 //# sourceMappingURL=MailTokens.js.map

package/src/logger/index.d.ts

@@ -1 +0,0 @@
-export { LogDeliveryStrategy } from '../services/strategies/LogDeliveryStrategy';

package/src/mailgun/index.d.ts

@@ -1,2 +0,0 @@
-export { MailgunDeliveryStrategy } from '../services/strategies/MailgunDeliveryStrategy';
-export { MAILGUN_API_KEY, MAILGUN_CONFIG_ENTRIES, MAILGUN_DOMAIN } from './env';

package/src/postmark/index.d.ts

@@ -1,2 +0,0 @@
-export { PostmarkDeliveryStrategy } from '../services/strategies/PostmarkDeliveryStrategy';
-export { POSTMARK_API_KEY, POSTMARK_CONFIG_ENTRIES } from './env';

package/src/resend/index.d.ts

@@ -1,2 +0,0 @@
-export { ResendDeliveryStrategy } from '../services/strategies/ResendDeliveryStrategy';
-export { RESEND_API_KEY, RESEND_CONFIG_ENTRIES } from './env';

package/src/sendgrid/index.d.ts

@@ -1,2 +0,0 @@
-export { SendGridDeliveryStrategy } from '../services/strategies/SendGridDeliveryStrategy';
-export { SENDGRID_API_KEY, SENDGRID_CONFIG_ENTRIES } from './env';