@breadstone/archipel-mcp 0.0.33 → 0.0.35

package/data/packages/platform-mailing/api/Class.DeliveryStrategyBase.md

@@ -5,12 +5,13 @@ editUrl: false
 ---
 # Abstract Class: DeliveryStrategyBase
 
-Defined in: [platform-mailing/src/services/strategies/abstracts/DeliveryStrategyBase.ts:9](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/abstracts/DeliveryStrategyBase.ts#L9)
+Defined in: [platform-mailing/src/delivering/strategies/abstracts/DeliveryStrategyBase.ts:9](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/delivering/strategies/abstracts/DeliveryStrategyBase.ts#L9)
 
 Represents the base class for all email delivery strategies.
 
 ## Extended by
 
+- [`LogDeliveryStrategy`](Class.LogDeliveryStrategy)
 - [`SmtpDeliveryStrategy`](Class.SmtpDeliveryStrategy)
 - [`PostmarkDeliveryStrategy`](Class.PostmarkDeliveryStrategy)
 - [`ResendDeliveryStrategy`](Class.ResendDeliveryStrategy)
@@ -25,7 +26,7 @@ Represents the base class for all email delivery strategies.
 protected new DeliveryStrategyBase(): DeliveryStrategyBase;
 ```
 
-Defined in: [platform-mailing/src/services/strategies/abstracts/DeliveryStrategyBase.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/abstracts/DeliveryStrategyBase.ts#L17)
+Defined in: [platform-mailing/src/delivering/strategies/abstracts/DeliveryStrategyBase.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/delivering/strategies/abstracts/DeliveryStrategyBase.ts#L17)
 
 Initializes a new instance of the `DeliveryStrategyBase` class.
 
@@ -47,7 +48,7 @@ abstract send(
 attachments?): Promise<void>;
 ```
 
-Defined in: [platform-mailing/src/services/strategies/abstracts/DeliveryStrategyBase.ts:37](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/abstracts/DeliveryStrategyBase.ts#L37)
+Defined in: [platform-mailing/src/delivering/strategies/abstracts/DeliveryStrategyBase.ts:37](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/delivering/strategies/abstracts/DeliveryStrategyBase.ts#L37)
 
 Sends an email with either plain text or HTML content.
 

package/data/packages/platform-mailing/api/Class.FileTemplateFetchStrategy.md

@@ -0,0 +1,62 @@
+---
+title: 'Class: FileTemplateFetchStrategy'
+generated: true
+editUrl: false
+---
+# Class: FileTemplateFetchStrategy
+
+Defined in: [platform-mailing/src/templating/strategies/file/FileTemplateFetchStrategy.ts:20](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/templating/strategies/file/FileTemplateFetchStrategy.ts#L20)
+
+The `FileTemplateFetchStrategy` class.
+
+Loads mail templates from the file system via `ResourceManager`.
+Template names are injected via `MAIL_TEMPLATE_NAMES_TOKEN` — defaults to an empty array.
+
+## Extends
+
+- [`TemplateFetchStrategyBase`](Class.TemplateFetchStrategyBase)
+
+## Constructors
+
+### Constructor
+
+```ts
+new FileTemplateFetchStrategy(resourceManager, templateNames): FileTemplateFetchStrategy;
+```
+
+Defined in: [platform-mailing/src/templating/strategies/file/FileTemplateFetchStrategy.ts:31](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/templating/strategies/file/FileTemplateFetchStrategy.ts#L31)
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `resourceManager` | `ResourceManager` |
+| `templateNames` | readonly `string`[] |
+
+#### Returns
+
+`FileTemplateFetchStrategy`
+
+#### Overrides
+
+[`TemplateFetchStrategyBase`](Class.TemplateFetchStrategyBase).[`constructor`](Class.TemplateFetchStrategyBase#constructor)
+
+## Methods
+
+### load()
+
+```ts
+load(): Promise<Record<string, IMailTemplateVariants>>;
+```
+
+Defined in: [platform-mailing/src/templating/strategies/file/FileTemplateFetchStrategy.ts:46](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/templating/strategies/file/FileTemplateFetchStrategy.ts#L46)
+
+Loads mail templates from the file system.
+
+#### Returns
+
+`Promise`\<`Record`\<`string`, [`IMailTemplateVariants`](Interface.IMailTemplateVariants)\>\>
+
+#### Overrides
+
+[`TemplateFetchStrategyBase`](Class.TemplateFetchStrategyBase).[`load`](Class.TemplateFetchStrategyBase#load)

package/data/packages/platform-mailing/api/Class.LogDeliveryStrategy.md

@@ -0,0 +1,71 @@
+---
+title: 'Class: LogDeliveryStrategy'
+generated: true
+editUrl: false
+---
+# Class: LogDeliveryStrategy
+
+Defined in: [platform-mailing/src/delivering/strategies/logger/LogDeliveryStrategy.ts:13](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/delivering/strategies/logger/LogDeliveryStrategy.ts#L13)
+
+The `LogDeliveryStrategy` class.
+
+## Extends
+
+- [`DeliveryStrategyBase`](Class.DeliveryStrategyBase)
+
+## Constructors
+
+### Constructor
+
+```ts
+new LogDeliveryStrategy(): LogDeliveryStrategy;
+```
+
+Defined in: [platform-mailing/src/delivering/strategies/logger/LogDeliveryStrategy.ts:27](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/delivering/strategies/logger/LogDeliveryStrategy.ts#L27)
+
+Constructs a new instance of the `LogDelivery` class.
+
+#### Returns
+
+`LogDeliveryStrategy`
+
+#### Overrides
+
+[`DeliveryStrategyBase`](Class.DeliveryStrategyBase).[`constructor`](Class.DeliveryStrategyBase#constructor)
+
+## Methods
+
+### send()
+
+```ts
+abstract send(
+   from, 
+   to, 
+   subject, 
+   content, 
+   isHtml, 
+_attachments?): Promise<void>;
+```
+
+Defined in: [platform-mailing/src/delivering/strategies/logger/LogDeliveryStrategy.ts:35](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/delivering/strategies/logger/LogDeliveryStrategy.ts#L35)
+
+Sends an email with either plain text or HTML content.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `from` | `string` | Sender's email address (optional, defaults to config) |
+| `to` | `string` | Recipient's email address |
+| `subject` | `string` | Subject of the email |
+| `content` | `string` | Email body content (plain text or HTML) |
+| `isHtml` | `boolean` | Flag to indicate whether the email is HTML (true) or plain text (false) |
+| `_attachments?` | [`IMailAttachment`](Interface.IMailAttachment)[] | - |
+
+#### Returns
+
+`Promise`\<`void`\>
+
+#### Overrides
+
+[`DeliveryStrategyBase`](Class.DeliveryStrategyBase).[`send`](Class.DeliveryStrategyBase#send)

package/data/packages/platform-mailing/api/Class.MailModule.md

@@ -5,12 +5,12 @@ editUrl: false
 ---
 # Class: MailModule
 
-Defined in: [platform-mailing/src/tokens/MailModule.ts:67](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/tokens/MailModule.ts#L67)
+Defined in: [platform-mailing/src/MailModule.ts:91](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/MailModule.ts#L91)
 
 Represents the mail module.
 
-Delivery and template strategies are resolved at runtime based on
-configuration keys `MAIL_DELIVERY_STRATEGY` and `MAIL_TEMPLATE_STRATEGY`.
+Delivery and template strategies are selected at compile time via
+`IMailModuleOptions`. NestJS DI resolves the concrete classes.
 
 ## Constructors
 
@@ -29,18 +29,18 @@ new MailModule(): MailModule;
 ### register()
 
 ```ts
-static register(options?): DynamicModule;
+static register(options): DynamicModule;
 ```
 
-Defined in: [platform-mailing/src/tokens/MailModule.ts:76](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/tokens/MailModule.ts#L76)
+Defined in: [platform-mailing/src/MailModule.ts:102](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/MailModule.ts#L102)
 
-Registers the mail module with optional configuration.
+Registers the mail module with the specified configuration.
 
 #### Parameters
 
 | Parameter | Type | Description |
 | ------ | ------ | ------ |
-| `options?` | [`IMailModuleOptions`](Interface.IMailModuleOptions) | Module registration options. |
+| `options` | [`IMailModuleOptions`](Interface.IMailModuleOptions) | Module registration options. |
 
 #### Returns
 

package/data/packages/platform-mailing/api/Class.MailService.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: MailService
 
-Defined in: [platform-mailing/src/services/MailService.ts:23](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/MailService.ts#L23)
+Defined in: [platform-mailing/src/services/MailService.ts:20](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/MailService.ts#L20)
 
 Represents the `MailService` class.
 
@@ -20,7 +20,7 @@ new MailService(
    deliveryStrategy): MailService;
 ```
 
-Defined in: [platform-mailing/src/services/MailService.ts:40](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/MailService.ts#L40)
+Defined in: [platform-mailing/src/services/MailService.ts:37](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/MailService.ts#L37)
 
 Constructs a new instance of the `MailService` class.
 
@@ -48,7 +48,7 @@ send(
 attachments?): Promise<void>;
 ```
 
-Defined in: [platform-mailing/src/services/MailService.ts:70](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/MailService.ts#L70)
+Defined in: [platform-mailing/src/services/MailService.ts:67](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/MailService.ts#L67)
 
 Sends an email with either plain text or HTML content.
 
@@ -76,22 +76,26 @@ Sends an email with either plain text or HTML content.
 sendTemplate(mailOptions, templateOptions): Promise<void>;
 ```
 
-Defined in: [platform-mailing/src/services/MailService.ts:104](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/MailService.ts#L104)
+Defined in: [platform-mailing/src/services/MailService.ts:105](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/MailService.ts#L105)
 
 Sends an email using a predefined template (HTML or text).
 Automatically uses the template format (either 'html' or 'txt') based on the environment variable.
 
+When no `subject` is provided in `mailOptions`, the subject is resolved from the
+stored template and interpolated with the given `templateParams` (industry-standard
+behavior matching Mailchimp/SendGrid/Postmark).
+
 #### Parameters
 
 | Parameter | Type | Description |
 | ------ | ------ | ------ |
-| `mailOptions` | \{ `from?`: `string`; `subject`: `string`; `to`: `string`; \} | - |
+| `mailOptions` | \{ `from?`: `string`; `subject?`: `string`; `to`: `string`; \} | - |
 | `mailOptions.from?` | `string` | Sender's email address (optional, defaults to config) |
-| `mailOptions.subject` | `string` | Subject of the email |
+| `mailOptions.subject?` | `string` | Subject of the email (optional — resolved from template if omitted) |
 | `mailOptions.to` | `string` | Recipient's email address |
 | `templateOptions` | \{ `templateName`: `string`; `templateParams`: `Record`\<`string`, `string` \| `number` \| `boolean` \| `Date` \| `undefined` \| `null`\>; \} | - |
 | `templateOptions.templateName` | `string` | Name of the template to be used |
-| `templateOptions.templateParams` | `Record`\<`string`, `string` \| `number` \| `boolean` \| `Date` \| `undefined` \| `null`\> | - |
+| `templateOptions.templateParams` | `Record`\<`string`, `string` \| `number` \| `boolean` \| `Date` \| `undefined` \| `null`\> | Parameters to inject into the template |
 
 #### Returns
 

package/data/packages/platform-mailing/api/Class.MailTemplateEngine.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: MailTemplateEngine
 
-Defined in: [platform-mailing/src/templating/MailTemplateEngine.ts:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/templating/MailTemplateEngine.ts#L16)
+Defined in: [platform-mailing/src/templating/MailTemplateEngine.ts:18](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/templating/MailTemplateEngine.ts#L18)
 
 The `MailTemplateEngine` class.
 
@@ -21,7 +21,7 @@ The `MailTemplateEngine` class.
 new MailTemplateEngine(templateFetchStrategy, contentTemplateEngine): MailTemplateEngine;
 ```
 
-Defined in: [platform-mailing/src/templating/MailTemplateEngine.ts:32](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/templating/MailTemplateEngine.ts#L32)
+Defined in: [platform-mailing/src/templating/MailTemplateEngine.ts:34](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/templating/MailTemplateEngine.ts#L34)
 
 Constructs a new instance of the `MailTemplateEngine` class.
 
@@ -47,7 +47,7 @@ compileTemplate(
    format): string;
 ```
 
-Defined in: [platform-mailing/src/templating/MailTemplateEngine.ts:65](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/templating/MailTemplateEngine.ts#L65)
+Defined in: [platform-mailing/src/templating/MailTemplateEngine.ts:67](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/templating/MailTemplateEngine.ts#L67)
 
 Compiles a template by replacing placeholders with the provided parameters.
 
@@ -77,7 +77,7 @@ Error if the template or format is not found.
 onModuleInit(): Promise<void>;
 ```
 
-Defined in: [platform-mailing/src/templating/MailTemplateEngine.ts:51](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/templating/MailTemplateEngine.ts#L51)
+Defined in: [platform-mailing/src/templating/MailTemplateEngine.ts:53](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/templating/MailTemplateEngine.ts#L53)
 
 Lifecycle hook that runs after the module initialization.
 Loads all templates from the disk and caches them in memory.
@@ -91,3 +91,28 @@ Loads all templates from the disk and caches them in memory.
 ```ts
 OnModuleInit.onModuleInit
 ```
+
+***
+
+### resolveSubject()
+
+```ts
+resolveSubject(templateKey, params): string | undefined;
+```
+
+Defined in: [platform-mailing/src/templating/MailTemplateEngine.ts:97](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/templating/MailTemplateEngine.ts#L97)
+
+Resolves and interpolates the subject line from a stored template.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `templateKey` | `string` | The key of the template. |
+| `params` | `Record`\<`string`, `unknown`\> | The parameters to insert into the subject. |
+
+#### Returns
+
+`string` \| `undefined`
+
+The compiled subject string, or `undefined` if no subject is stored.

package/data/packages/platform-mailing/api/Class.MailgunDeliveryStrategy.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: MailgunDeliveryStrategy
 
-Defined in: [platform-mailing/src/services/strategies/MailgunDeliveryStrategy.ts:19](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/MailgunDeliveryStrategy.ts#L19)
+Defined in: [platform-mailing/src/delivering/strategies/mailgun/MailgunDeliveryStrategy.ts:19](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/delivering/strategies/mailgun/MailgunDeliveryStrategy.ts#L19)
 
 Delivers emails via the Mailgun API.
 
@@ -21,7 +21,7 @@ Delivers emails via the Mailgun API.
 new MailgunDeliveryStrategy(configService): MailgunDeliveryStrategy;
 ```
 
-Defined in: [platform-mailing/src/services/strategies/MailgunDeliveryStrategy.ts:35](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/MailgunDeliveryStrategy.ts#L35)
+Defined in: [platform-mailing/src/delivering/strategies/mailgun/MailgunDeliveryStrategy.ts:35](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/delivering/strategies/mailgun/MailgunDeliveryStrategy.ts#L35)
 
 Constructs a new instance of the `MailgunDeliveryStrategy` class.
 
@@ -53,7 +53,7 @@ send(
 _attachments?): Promise<void>;
 ```
 
-Defined in: [platform-mailing/src/services/strategies/MailgunDeliveryStrategy.ts:60](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/MailgunDeliveryStrategy.ts#L60)
+Defined in: [platform-mailing/src/delivering/strategies/mailgun/MailgunDeliveryStrategy.ts:60](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/delivering/strategies/mailgun/MailgunDeliveryStrategy.ts#L60)
 
 Sends an email using the Mailgun transport.
 

package/data/packages/platform-mailing/api/Class.PostmarkDeliveryStrategy.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: PostmarkDeliveryStrategy
 
-Defined in: [platform-mailing/src/services/strategies/PostmarkDeliveryStrategy.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/PostmarkDeliveryStrategy.ts#L17)
+Defined in: [platform-mailing/src/delivering/strategies/postmark/PostmarkDeliveryStrategy.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/delivering/strategies/postmark/PostmarkDeliveryStrategy.ts#L17)
 
 The `PostmarkDeliveryStrategy` class.
 
@@ -21,7 +21,7 @@ The `PostmarkDeliveryStrategy` class.
 new PostmarkDeliveryStrategy(configService): PostmarkDeliveryStrategy;
 ```
 
-Defined in: [platform-mailing/src/services/strategies/PostmarkDeliveryStrategy.ts:32](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/PostmarkDeliveryStrategy.ts#L32)
+Defined in: [platform-mailing/src/delivering/strategies/postmark/PostmarkDeliveryStrategy.ts:32](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/delivering/strategies/postmark/PostmarkDeliveryStrategy.ts#L32)
 
 Constructs a new instance of the `PostmarkDeliveryStrategy` class.
 
@@ -53,7 +53,7 @@ send(
 _attachments?): Promise<void>;
 ```
 
-Defined in: [platform-mailing/src/services/strategies/PostmarkDeliveryStrategy.ts:52](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/PostmarkDeliveryStrategy.ts#L52)
+Defined in: [platform-mailing/src/delivering/strategies/postmark/PostmarkDeliveryStrategy.ts:52](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/delivering/strategies/postmark/PostmarkDeliveryStrategy.ts#L52)
 
 Sends an email using the Postmark transport.
 

package/data/packages/platform-mailing/api/Class.ResendDeliveryStrategy.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: ResendDeliveryStrategy
 
-Defined in: [platform-mailing/src/services/strategies/ResendDeliveryStrategy.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/ResendDeliveryStrategy.ts#L17)
+Defined in: [platform-mailing/src/delivering/strategies/resend/ResendDeliveryStrategy.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/delivering/strategies/resend/ResendDeliveryStrategy.ts#L17)
 
 Delivers emails via the Resend API.
 
@@ -21,7 +21,7 @@ Delivers emails via the Resend API.
 new ResendDeliveryStrategy(configService): ResendDeliveryStrategy;
 ```
 
-Defined in: [platform-mailing/src/services/strategies/ResendDeliveryStrategy.ts:32](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/ResendDeliveryStrategy.ts#L32)
+Defined in: [platform-mailing/src/delivering/strategies/resend/ResendDeliveryStrategy.ts:32](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/delivering/strategies/resend/ResendDeliveryStrategy.ts#L32)
 
 Constructs a new instance of the `ResendDeliveryStrategy` class.
 
@@ -53,7 +53,7 @@ send(
 _attachments?): Promise<void>;
 ```
 
-Defined in: [platform-mailing/src/services/strategies/ResendDeliveryStrategy.ts:52](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/ResendDeliveryStrategy.ts#L52)
+Defined in: [platform-mailing/src/delivering/strategies/resend/ResendDeliveryStrategy.ts:52](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/delivering/strategies/resend/ResendDeliveryStrategy.ts#L52)
 
 Sends an email using the Resend transport.
 

package/data/packages/platform-mailing/api/Class.SendGridDeliveryStrategy.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: SendGridDeliveryStrategy
 
-Defined in: [platform-mailing/src/services/strategies/SendGridDeliveryStrategy.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/SendGridDeliveryStrategy.ts#L17)
+Defined in: [platform-mailing/src/delivering/strategies/sendgrid/SendGridDeliveryStrategy.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/delivering/strategies/sendgrid/SendGridDeliveryStrategy.ts#L17)
 
 Delivers emails via the SendGrid API.
 
@@ -21,7 +21,7 @@ Delivers emails via the SendGrid API.
 new SendGridDeliveryStrategy(configService): SendGridDeliveryStrategy;
 ```
 
-Defined in: [platform-mailing/src/services/strategies/SendGridDeliveryStrategy.ts:31](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/SendGridDeliveryStrategy.ts#L31)
+Defined in: [platform-mailing/src/delivering/strategies/sendgrid/SendGridDeliveryStrategy.ts:31](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/delivering/strategies/sendgrid/SendGridDeliveryStrategy.ts#L31)
 
 Constructs a new instance of the `SendGridDeliveryStrategy` class.
 
@@ -53,7 +53,7 @@ send(
 _attachments?): Promise<void>;
 ```
 
-Defined in: [platform-mailing/src/services/strategies/SendGridDeliveryStrategy.ts:51](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/SendGridDeliveryStrategy.ts#L51)
+Defined in: [platform-mailing/src/delivering/strategies/sendgrid/SendGridDeliveryStrategy.ts:51](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/delivering/strategies/sendgrid/SendGridDeliveryStrategy.ts#L51)
 
 Sends an email using the SendGrid transport.
 

package/data/packages/platform-mailing/api/Class.SmtpDeliveryStrategy.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: SmtpDeliveryStrategy
 
-Defined in: [platform-mailing/src/services/strategies/SmtpDeliveryStrategy.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/SmtpDeliveryStrategy.ts#L17)
+Defined in: [platform-mailing/src/delivering/strategies/smtp/SmtpDeliveryStrategy.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/delivering/strategies/smtp/SmtpDeliveryStrategy.ts#L17)
 
 The `SmtpDeliveryStrategy` class.
 
@@ -21,7 +21,7 @@ The `SmtpDeliveryStrategy` class.
 new SmtpDeliveryStrategy(configService): SmtpDeliveryStrategy;
 ```
 
-Defined in: [platform-mailing/src/services/strategies/SmtpDeliveryStrategy.ts:32](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/SmtpDeliveryStrategy.ts#L32)
+Defined in: [platform-mailing/src/delivering/strategies/smtp/SmtpDeliveryStrategy.ts:32](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/delivering/strategies/smtp/SmtpDeliveryStrategy.ts#L32)
 
 Constructs a new instance of the `LogDelivery` class.
 
@@ -53,7 +53,7 @@ send(
 _attachments?): Promise<void>;
 ```
 
-Defined in: [platform-mailing/src/services/strategies/SmtpDeliveryStrategy.ts:62](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/SmtpDeliveryStrategy.ts#L62)
+Defined in: [platform-mailing/src/delivering/strategies/smtp/SmtpDeliveryStrategy.ts:62](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/delivering/strategies/smtp/SmtpDeliveryStrategy.ts#L62)
 
 Sends an email using the SMTP transport.
 

package/data/packages/platform-mailing/api/Class.TemplateFetchStrategyBase.md

@@ -5,12 +5,14 @@ editUrl: false
 ---
 # Abstract Class: TemplateFetchStrategyBase
 
-Defined in: [platform-mailing/src/templating/strategies/abstracts/TemplateFetchStrategyBase.ts:7](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/templating/strategies/abstracts/TemplateFetchStrategyBase.ts#L7)
+Defined in: [platform-mailing/src/templating/strategies/abstracts/TemplateFetchStrategyBase.ts:9](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/templating/strategies/abstracts/TemplateFetchStrategyBase.ts#L9)
 
 Represents the base class for template fetch strategies.
 
 ## Extended by
 
+- [`BlobTemplateFetchStrategy`](Class.BlobTemplateFetchStrategy)
+- [`FileTemplateFetchStrategy`](Class.FileTemplateFetchStrategy)
 - [`DatabaseTemplateFetchStrategy`](Class.DatabaseTemplateFetchStrategy)
 
 ## Constructors
@@ -21,7 +23,7 @@ Represents the base class for template fetch strategies.
 protected new TemplateFetchStrategyBase(): TemplateFetchStrategyBase;
 ```
 
-Defined in: [platform-mailing/src/templating/strategies/abstracts/TemplateFetchStrategyBase.ts:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/templating/strategies/abstracts/TemplateFetchStrategyBase.ts#L16)
+Defined in: [platform-mailing/src/templating/strategies/abstracts/TemplateFetchStrategyBase.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/templating/strategies/abstracts/TemplateFetchStrategyBase.ts#L17)
 
 Initializes a new instance of the `TemplateFetchStrategyBase` class.
 
@@ -34,19 +36,13 @@ Initializes a new instance of the `TemplateFetchStrategyBase` class.
 ### load()
 
 ```ts
-abstract load(): Promise<Record<string, {
-  html?: string;
-  txt?: string;
-}>>;
+abstract load(): Promise<Record<string, IMailTemplateVariants>>;
 ```
 
-Defined in: [platform-mailing/src/templating/strategies/abstracts/TemplateFetchStrategyBase.ts:30](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/templating/strategies/abstracts/TemplateFetchStrategyBase.ts#L30)
+Defined in: [platform-mailing/src/templating/strategies/abstracts/TemplateFetchStrategyBase.ts:31](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/templating/strategies/abstracts/TemplateFetchStrategyBase.ts#L31)
 
 Loads the templates.
 
 #### Returns
 
-`Promise`\<`Record`\<`string`, \{
-  `html?`: `string`;
-  `txt?`: `string`;
-\}\>\>
+`Promise`\<`Record`\<`string`, [`IMailTemplateVariants`](Interface.IMailTemplateVariants)\>\>

package/data/packages/platform-mailing/api/Interface.IMailEvents.md

@@ -5,10 +5,14 @@ editUrl: false
 ---
 # Interface: IMailEvents
 
-Defined in: [platform-mailing/src/events/IMailEvents.ts:12](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/events/IMailEvents.ts#L12)
+Defined in: [platform-mailing/src/events/IMailEvents.ts:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/events/IMailEvents.ts#L16)
 
 Represents the contract of events emitted by the mail domain.
 
+Publishers only need to specify `recipientEmail`, `templateName`, and `templateParams`.
+The subject is resolved from the stored template (industry-standard behavior).
+An explicit `subject` can be provided as an override.
+
 ## Extends
 
 - `IEventMap`
@@ -25,15 +29,24 @@ Represents the contract of events emitted by the mail domain.
 
 ```ts
 sendMail: {
+  locale?: string;
   recipientEmail: string;
   senderEmail?: string;
-  subject: string;
+  subject?: string;
   templateName: string;
   templateParams: Record<string, string | number | boolean | Date | undefined | null>;
 };
 ```
 
-Defined in: [platform-mailing/src/events/IMailEvents.ts:13](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/events/IMailEvents.ts#L13)
+Defined in: [platform-mailing/src/events/IMailEvents.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/events/IMailEvents.ts#L17)
+
+#### locale?
+
+```ts
+optional locale?: string;
+```
+
+Optional locale for template resolution (e.g. `'de'`, `'en'`).
 
 #### recipientEmail
 
@@ -41,26 +54,36 @@ Defined in: [platform-mailing/src/events/IMailEvents.ts:13](https://github.com/R
 recipientEmail: string;
 ```
 
+Recipient email address.
+
 #### senderEmail?
 
 ```ts
 optional senderEmail?: string;
 ```
 
-#### subject
+Optional sender email override. When omitted, uses the configured default.
+
+#### subject?
 
 ```ts
-subject: string;
+optional subject?: string;
 ```
 
+Optional subject override. When omitted, resolved from the template.
+
 #### templateName
 
 ```ts
 templateName: string;
 ```
 
+Template key to resolve (e.g. `'AuthRegister'`).
+
 #### templateParams
 
 ```ts
 templateParams: Record<string, string | number | boolean | Date | undefined | null>;
 ```
+
+Placeholder values to interpolate into subject and body.