@breadstone/archipel-mcp 0.0.20 → 0.0.21

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:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/ResendDeliveryStrategy.ts#L16)
+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)
 
 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:31](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/ResendDeliveryStrategy.ts#L31)
+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)
 
 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:51](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/ResendDeliveryStrategy.ts#L51)
+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)
 
 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:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/SendGridDeliveryStrategy.ts#L16)
+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)
 
 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:30](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/SendGridDeliveryStrategy.ts#L30)
+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)
 
 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:50](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/SendGridDeliveryStrategy.ts#L50)
+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)
 
 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:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/SmtpDeliveryStrategy.ts#L16)
+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)
 
 The `SmtpDeliveryStrategy` class.
 
@@ -21,7 +21,7 @@ The `SmtpDeliveryStrategy` class.
 new SmtpDeliveryStrategy(configService): SmtpDeliveryStrategy;
 ```
 
-Defined in: [platform-mailing/src/services/strategies/SmtpDeliveryStrategy.ts:31](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/SmtpDeliveryStrategy.ts#L31)
+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)
 
 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:61](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/SmtpDeliveryStrategy.ts#L61)
+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)
 
 Sends an email using the SMTP transport.
 

package/data/packages/platform-mailing/api/index.md

@@ -13,6 +13,7 @@ editUrl: false
 | [DeliveryStrategyBase](Class.DeliveryStrategyBase) | Represents the base class for all email delivery strategies. |
 | [FileTemplateFetchStrategy](Class.FileTemplateFetchStrategy) | The `FileTemplateFetchStrategy` class. |
 | [LogDeliveryStrategy](Class.LogDeliveryStrategy) | The `LogDeliveryStrategy` class. |
+| [MailDeliveryError](Class.MailDeliveryError) | Domain error thrown when email delivery fails. |
 | [MailgunDeliveryStrategy](Class.MailgunDeliveryStrategy) | Delivers emails via the Mailgun API. |
 | [MailHealthIndicator](Class.MailHealthIndicator) | Health indicator for mail service. |
 | [MailModule](Class.MailModule) | Represents the mail module. |

package/data/packages/platform-mailing/index.md

@@ -353,6 +353,34 @@ export class OrderEmailService {
 
 ---
 
+## Error Handling
+
+All delivery strategies throw a `MailDeliveryError` when email sending fails. This domain error class wraps the underlying provider SDK error and exposes structured metadata for error handling and observability.
+
+```typescript
+import { MailDeliveryError } from '@breadstone/archipel-platform-mailing';
+
+try {
+  await this._mail.send(options, content, true);
+} catch (error) {
+  if (error instanceof MailDeliveryError) {
+    logger.error('Mail delivery failed', {
+      provider: error.provider,  // 'postmark', 'resend', 'sendgrid', etc.
+      code: error.code,          // 'MAIL_DELIVERY'
+      cause: error.cause,        // Original provider SDK error
+    });
+  }
+}
+```
+
+| Property   | Type     | Description                                    |
+| ---------- | -------- | ---------------------------------------------- |
+| `code`     | `string` | Always `'MAIL_DELIVERY'`                       |
+| `provider` | `string` | Provider that failed (`smtp`, `postmark`, etc.) |
+| `cause`    | `unknown`| Original error from the provider SDK           |
+
+---
+
 ## Exports Summary
 
 ### Core (`@breadstone/archipel-platform-mailing`)
@@ -372,6 +400,7 @@ export class OrderEmailService {
 | `FileTemplateFetchStrategy` | Strategy       | File-based templates            |
 | `BlobTemplateFetchStrategy` | Strategy       | Blob-stored templates           |
 | `MailHealthIndicator`       | Health         | Mail readiness check            |
+| `MailDeliveryError`         | Error class    | Domain error for delivery failures |
 
 ### Provider subpaths
 

package/data/packages/platform-mcp/api/Class.McpServerService.md

@@ -24,7 +24,7 @@ the registry, and provides methods to connect various transports.
 new McpServerService(_options, _registry): McpServerService;
 ```
 
-Defined in: [services/McpServerService.ts:50](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mcp/src/services/McpServerService.ts#L50)
+Defined in: [services/McpServerService.ts:51](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mcp/src/services/McpServerService.ts#L51)
 
 #### Parameters
 
@@ -47,7 +47,7 @@ Defined in: [services/McpServerService.ts:50](https://github.com/RueDeRennes/arc
 get server(): McpServer;
 ```
 
-Defined in: [services/McpServerService.ts:64](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mcp/src/services/McpServerService.ts#L64)
+Defined in: [services/McpServerService.ts:65](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mcp/src/services/McpServerService.ts#L65)
 
 Returns the underlying `McpServer` instance.
 
@@ -67,7 +67,7 @@ Error if the server has not been initialized yet.
 connectStdio(): Promise<StdioServerTransport>;
 ```
 
-Defined in: [services/McpServerService.ts:126](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mcp/src/services/McpServerService.ts#L126)
+Defined in: [services/McpServerService.ts:129](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mcp/src/services/McpServerService.ts#L129)
 
 Connects the server to a stdio transport.
 Suitable for local, process-spawned integrations.
@@ -84,7 +84,7 @@ Suitable for local, process-spawned integrations.
 connectTransport(transport): Promise<void>;
 ```
 
-Defined in: [services/McpServerService.ts:180](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mcp/src/services/McpServerService.ts#L180)
+Defined in: [services/McpServerService.ts:183](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mcp/src/services/McpServerService.ts#L183)
 
 Connects a custom transport to the MCP server.
 
@@ -106,7 +106,7 @@ Connects a custom transport to the MCP server.
 createSseTransport(options, response): Promise<SSEServerTransport>;
 ```
 
-Defined in: [services/McpServerService.ts:166](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mcp/src/services/McpServerService.ts#L166)
+Defined in: [services/McpServerService.ts:169](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mcp/src/services/McpServerService.ts#L169)
 
 Creates an SSE transport for legacy client support.
 The caller is responsible for wiring the returned transport to Express routes.
@@ -132,7 +132,7 @@ The configured SSE transport instance.
 createStreamableHttpTransport(options?): Promise<StreamableHTTPServerTransport>;
 ```
 
-Defined in: [services/McpServerService.ts:143](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mcp/src/services/McpServerService.ts#L143)
+Defined in: [services/McpServerService.ts:146](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mcp/src/services/McpServerService.ts#L146)
 
 Creates a Streamable HTTP transport for use with Express.
 The caller is responsible for wiring the transport's `handleRequest`
@@ -158,7 +158,7 @@ The configured transport instance.
 onModuleDestroy(): Promise<void>;
 ```
 
-Defined in: [services/McpServerService.ts:102](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mcp/src/services/McpServerService.ts#L102)
+Defined in: [services/McpServerService.ts:103](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mcp/src/services/McpServerService.ts#L103)
 
 Cleans up all active transports when the module is destroyed.
 
@@ -180,7 +180,7 @@ OnModuleDestroy.onModuleDestroy
 onModuleInit(): void;
 ```
 
-Defined in: [services/McpServerService.ts:80](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mcp/src/services/McpServerService.ts#L80)
+Defined in: [services/McpServerService.ts:81](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mcp/src/services/McpServerService.ts#L81)
 
 Initializes the MCP server and registers all tools, resources, and prompts
 from the registry.

package/data/packages/platform-mcp/index.md

@@ -297,3 +297,14 @@ graph TD
 2. **McpDiscoveryService** runs `onModuleInit`, iterates all providers, reads decorator metadata, and populates the registry.
 3. **McpServerService** runs `onModuleInit`, creates the `McpServer` instance, and registers all handlers from the registry.
 4. The application connects a transport (stdio, HTTP, SSE, or custom) to start serving MCP requests.
+
+---
+
+## Resource Limits & Shutdown
+
+| Limit                | Value      | Description                                                              |
+| -------------------- | ---------- | ------------------------------------------------------------------------ |
+| **Max transports**   | 1,000      | `McpServerService` tracks up to 1,000 active transports                  |
+| **Shutdown timeout** | 5 seconds  | Each transport and the server are closed with a 5-second timeout guard   |
+
+When the module is destroyed, `McpServerService.onModuleDestroy()` iterates all active transports, closes each with a 5-second timeout, and then closes the MCP server itself.

package/data/packages/platform-openapi/api/Class.SwaggerTheme.md

@@ -17,7 +17,7 @@ The swagger theme class
 new SwaggerTheme(resourceManager): SwaggerTheme;
 ```
 
-Defined in: [SwaggerTheme.ts:29](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/SwaggerTheme.ts#L29)
+Defined in: [SwaggerTheme.ts:30](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/SwaggerTheme.ts#L30)
 
 Constructs a new instance of the `SwaggerTheme` class.
 
@@ -39,7 +39,7 @@ Constructs a new instance of the `SwaggerTheme` class.
 getOptions(): Pick<SwaggerCustomOptions, "customCss" | "customJsStr">;
 ```
 
-Defined in: [SwaggerTheme.ts:37](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/SwaggerTheme.ts#L37)
+Defined in: [SwaggerTheme.ts:38](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/SwaggerTheme.ts#L38)
 
 #### Returns
 

package/data/packages/platform-openapi/index.md

@@ -201,5 +201,5 @@ const features = registry.getFeatures(); // sorted, read-only copy
 | `SwaggerFeatureDiscovery`     | Service   | Auto-discover features          |
 | `SwaggerFeatureRegistry`      | Service   | Manage feature configs          |
 | `SwaggerMultiDocumentService` | Service   | Generate per-feature specs      |
-| `SwaggerTheme`                | Utility   | Theme customization             |
+| `SwaggerTheme`                | Utility   | Theme customization (CSS/JS cached after first load) |
 | `IFeatureSwaggerConfig`       | Interface | Feature config shape            |

package/data/packages/platform-payments/api/Class.LemonSqueezyClient.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: LemonSqueezyClient
 
-Defined in: [lemonsqueezy/LemonSqueezyClient.ts:30](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/lemonsqueezy/LemonSqueezyClient.ts#L30)
+Defined in: [lemonsqueezy/LemonSqueezyClient.ts:31](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/lemonsqueezy/LemonSqueezyClient.ts#L31)
 
 LemonSqueezy implementation of the [PaymentClientPort](Class.PaymentClientPort).
 Uses the official `@lemonsqueezy/lemonsqueezy.js` SDK.
@@ -22,7 +22,7 @@ Uses the official `@lemonsqueezy/lemonsqueezy.js` SDK.
 new LemonSqueezyClient(configService): LemonSqueezyClient;
 ```
 
-Defined in: [lemonsqueezy/LemonSqueezyClient.ts:40](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/lemonsqueezy/LemonSqueezyClient.ts#L40)
+Defined in: [lemonsqueezy/LemonSqueezyClient.ts:41](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/lemonsqueezy/LemonSqueezyClient.ts#L41)
 
 #### Parameters
 
@@ -46,7 +46,7 @@ Defined in: [lemonsqueezy/LemonSqueezyClient.ts:40](https://github.com/RueDeRenn
 constructWebhookEvent(payload, signature): INormalizedWebhookEvent;
 ```
 
-Defined in: [lemonsqueezy/LemonSqueezyClient.ts:143](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/lemonsqueezy/LemonSqueezyClient.ts#L143)
+Defined in: [lemonsqueezy/LemonSqueezyClient.ts:144](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/lemonsqueezy/LemonSqueezyClient.ts#L144)
 
 Construct and normalize a webhook event from raw payload.
 
@@ -79,7 +79,7 @@ createCheckoutSession(
 userId?): Promise<INormalizedCheckoutSession>;
 ```
 
-Defined in: [lemonsqueezy/LemonSqueezyClient.ts:78](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/lemonsqueezy/LemonSqueezyClient.ts#L78)
+Defined in: [lemonsqueezy/LemonSqueezyClient.ts:79](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/lemonsqueezy/LemonSqueezyClient.ts#L79)
 
 Create a checkout session.
 
@@ -110,7 +110,7 @@ Normalized checkout session.
 fetchPrices(productId): Promise<INormalizedPrice[]>;
 ```
 
-Defined in: [lemonsqueezy/LemonSqueezyClient.ts:56](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/lemonsqueezy/LemonSqueezyClient.ts#L56)
+Defined in: [lemonsqueezy/LemonSqueezyClient.ts:57](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/lemonsqueezy/LemonSqueezyClient.ts#L57)
 
 Fetch all active prices for a product.
 
@@ -140,7 +140,7 @@ fetchSubscription(subscriptionId): Promise<
 | null>;
 ```
 
-Defined in: [lemonsqueezy/LemonSqueezyClient.ts:124](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/lemonsqueezy/LemonSqueezyClient.ts#L124)
+Defined in: [lemonsqueezy/LemonSqueezyClient.ts:125](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/lemonsqueezy/LemonSqueezyClient.ts#L125)
 
 Retrieve subscription details.
 

package/data/packages/platform-payments/api/Class.MollieClient.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: MollieClient
 
-Defined in: [mollie/MollieClient.ts:24](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/mollie/MollieClient.ts#L24)
+Defined in: [mollie/MollieClient.ts:25](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/mollie/MollieClient.ts#L25)
 
 Mollie implementation of the [PaymentClientPort](Class.PaymentClientPort).
 Uses the official `@mollie/api-client` to interact with the Mollie API.
@@ -22,7 +22,7 @@ Uses the official `@mollie/api-client` to interact with the Mollie API.
 new MollieClient(configService): MollieClient;
 ```
 
-Defined in: [mollie/MollieClient.ts:35](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/mollie/MollieClient.ts#L35)
+Defined in: [mollie/MollieClient.ts:36](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/mollie/MollieClient.ts#L36)
 
 #### Parameters
 
@@ -46,7 +46,7 @@ Defined in: [mollie/MollieClient.ts:35](https://github.com/RueDeRennes/archipel/
 constructWebhookEvent(payload, signature): INormalizedWebhookEvent;
 ```
 
-Defined in: [mollie/MollieClient.ts:132](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/mollie/MollieClient.ts#L132)
+Defined in: [mollie/MollieClient.ts:133](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/mollie/MollieClient.ts#L133)
 
 Construct and normalize a webhook event from raw payload.
 
@@ -79,7 +79,7 @@ createCheckoutSession(
 userId?): Promise<INormalizedCheckoutSession>;
 ```
 
-Defined in: [mollie/MollieClient.ts:65](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/mollie/MollieClient.ts#L65)
+Defined in: [mollie/MollieClient.ts:66](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/mollie/MollieClient.ts#L66)
 
 Creates a checkout session for Mollie.
 
@@ -113,7 +113,7 @@ formatted monetary amount (e.g. "10.00") for the payment creation.
 fetchPrices(_productId): Promise<INormalizedPrice[]>;
 ```
 
-Defined in: [mollie/MollieClient.ts:49](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/mollie/MollieClient.ts#L49)
+Defined in: [mollie/MollieClient.ts:50](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/mollie/MollieClient.ts#L50)
 
 Fetch all active prices for a product.
 
@@ -143,7 +143,7 @@ fetchSubscription(subscriptionId): Promise<
 | null>;
 ```
 
-Defined in: [mollie/MollieClient.ts:106](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/mollie/MollieClient.ts#L106)
+Defined in: [mollie/MollieClient.ts:107](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/mollie/MollieClient.ts#L107)
 
 Retrieve subscription details.
 

package/data/packages/platform-payments/api/Class.PaddleClient.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: PaddleClient
 
-Defined in: [paddle/PaddleClient.ts:24](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/paddle/PaddleClient.ts#L24)
+Defined in: [paddle/PaddleClient.ts:25](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/paddle/PaddleClient.ts#L25)
 
 Paddle implementation of the [PaymentClientPort](Class.PaymentClientPort).
 Uses the official `@paddle/paddle-node-sdk` to interact with the Paddle Billing API.
@@ -22,7 +22,7 @@ Uses the official `@paddle/paddle-node-sdk` to interact with the Paddle Billing
 new PaddleClient(configService): PaddleClient;
 ```
 
-Defined in: [paddle/PaddleClient.ts:35](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/paddle/PaddleClient.ts#L35)
+Defined in: [paddle/PaddleClient.ts:36](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/paddle/PaddleClient.ts#L36)
 
 #### Parameters
 
@@ -46,7 +46,7 @@ Defined in: [paddle/PaddleClient.ts:35](https://github.com/RueDeRennes/archipel/
 constructWebhookEvent(payload, signature): Promise<INormalizedWebhookEvent>;
 ```
 
-Defined in: [paddle/PaddleClient.ts:121](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/paddle/PaddleClient.ts#L121)
+Defined in: [paddle/PaddleClient.ts:122](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/paddle/PaddleClient.ts#L122)
 
 Construct and normalize a webhook event from raw payload.
 
@@ -79,7 +79,7 @@ createCheckoutSession(
 userId?): Promise<INormalizedCheckoutSession>;
 ```
 
-Defined in: [paddle/PaddleClient.ts:72](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/paddle/PaddleClient.ts#L72)
+Defined in: [paddle/PaddleClient.ts:73](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/paddle/PaddleClient.ts#L73)
 
 Create a checkout session.
 
@@ -110,7 +110,7 @@ Normalized checkout session.
 fetchPrices(productId): Promise<INormalizedPrice[]>;
 ```
 
-Defined in: [paddle/PaddleClient.ts:52](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/paddle/PaddleClient.ts#L52)
+Defined in: [paddle/PaddleClient.ts:53](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/paddle/PaddleClient.ts#L53)
 
 Fetch all active prices for a product.
 
@@ -140,7 +140,7 @@ fetchSubscription(subscriptionId): Promise<
 | null>;
 ```
 
-Defined in: [paddle/PaddleClient.ts:106](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/paddle/PaddleClient.ts#L106)
+Defined in: [paddle/PaddleClient.ts:107](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/paddle/PaddleClient.ts#L107)
 
 Retrieve subscription details.
 

package/data/packages/platform-payments/api/Class.PaymentError.md

@@ -0,0 +1,65 @@
+---
+title: 'Class: PaymentError'
+generated: true
+editUrl: false
+---
+# Class: PaymentError
+
+Defined in: [errors/PaymentError.ts:6](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/errors/PaymentError.ts#L6)
+
+Domain error thrown when a payment operation fails.
+
+## Extends
+
+- `Error`
+
+## Constructors
+
+### Constructor
+
+```ts
+new PaymentError(
+   provider, 
+   message, 
+   cause?): PaymentError;
+```
+
+Defined in: [errors/PaymentError.ts:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/errors/PaymentError.ts#L16)
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `provider` | `string` |
+| `message` | `string` |
+| `cause?` | `unknown` |
+
+#### Returns
+
+`PaymentError`
+
+#### Overrides
+
+```ts
+Error.constructor
+```
+
+## Properties
+
+### code
+
+```ts
+readonly code: "PAYMENT" = 'PAYMENT';
+```
+
+Defined in: [errors/PaymentError.ts:9](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/errors/PaymentError.ts#L9)
+
+***
+
+### provider
+
+```ts
+readonly provider: string;
+```
+
+Defined in: [errors/PaymentError.ts:10](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/errors/PaymentError.ts#L10)

package/data/packages/platform-payments/api/Class.StripeClient.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: StripeClient
 
-Defined in: [stripe/StripeClient.ts:28](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/stripe/StripeClient.ts#L28)
+Defined in: [stripe/StripeClient.ts:29](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/stripe/StripeClient.ts#L29)
 
 Stripe implementation of the [PaymentClientPort](Class.PaymentClientPort).
 All Stripe-specific types and logic are encapsulated here.
@@ -22,7 +22,7 @@ All Stripe-specific types and logic are encapsulated here.
 new StripeClient(configService): StripeClient;
 ```
 
-Defined in: [stripe/StripeClient.ts:39](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/stripe/StripeClient.ts#L39)
+Defined in: [stripe/StripeClient.ts:40](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/stripe/StripeClient.ts#L40)
 
 #### Parameters
 
@@ -46,7 +46,7 @@ Defined in: [stripe/StripeClient.ts:39](https://github.com/RueDeRennes/archipel/
 constructWebhookEvent(payload, signature): INormalizedWebhookEvent;
 ```
 
-Defined in: [stripe/StripeClient.ts:152](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/stripe/StripeClient.ts#L152)
+Defined in: [stripe/StripeClient.ts:153](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/stripe/StripeClient.ts#L153)
 
 Construct and normalize a webhook event.
 
@@ -79,7 +79,7 @@ createCheckoutSession(
 userId?): Promise<INormalizedCheckoutSession>;
 ```
 
-Defined in: [stripe/StripeClient.ts:87](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/stripe/StripeClient.ts#L87)
+Defined in: [stripe/StripeClient.ts:88](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/stripe/StripeClient.ts#L88)
 
 Create a checkout session.
 
@@ -110,7 +110,7 @@ Normalized checkout session
 fetchPrices(productId): Promise<INormalizedPrice[]>;
 ```
 
-Defined in: [stripe/StripeClient.ts:58](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/stripe/StripeClient.ts#L58)
+Defined in: [stripe/StripeClient.ts:59](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/stripe/StripeClient.ts#L59)
 
 Fetch all active prices for a product.
 
@@ -140,7 +140,7 @@ fetchSubscription(subscriptionId): Promise<
 | null>;
 ```
 
-Defined in: [stripe/StripeClient.ts:127](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/stripe/StripeClient.ts#L127)
+Defined in: [stripe/StripeClient.ts:128](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/stripe/StripeClient.ts#L128)
 
 Retrieve subscription details.
 

package/data/packages/platform-payments/api/index.md

@@ -16,6 +16,7 @@ editUrl: false
 | [MollieClient](Class.MollieClient) | Mollie implementation of the [PaymentClientPort](Class.PaymentClientPort). Uses the official `@mollie/api-client` to interact with the Mollie API. |
 | [PaddleClient](Class.PaddleClient) | Paddle implementation of the [PaymentClientPort](Class.PaymentClientPort). Uses the official `@paddle/paddle-node-sdk` to interact with the Paddle Billing API. |
 | [PaymentClientPort](Class.PaymentClientPort) | Abstract port for payment provider clients. Each provider (Stripe, Paddle, LemonSqueezy, Mollie) must implement this contract so that the consuming application can switch providers without changing business logic. |
+| [PaymentError](Class.PaymentError) | Domain error thrown when a payment operation fails. |
 | [PaymentModule](Class.PaymentModule) | NestJS module providing generic payment infrastructure. Exposes a configurable payment client, a feature-gating guard, and a usage-tracking interceptor. The specific payment provider (Stripe, Paddle, LemonSqueezy, Mollie) is selected via the options. |
 | [StripeClient](Class.StripeClient) | Stripe implementation of the [PaymentClientPort](Class.PaymentClientPort). All Stripe-specific types and logic are encapsulated here. |
 

package/data/packages/platform-payments/index.md

@@ -504,6 +504,34 @@ export class RecipeController {
 
 ---
 
+## Error Handling
+
+All payment clients throw a `PaymentError` when provider operations fail (checkout session creation, webhook signature verification, price fetching, etc.). This domain error wraps the underlying SDK error and exposes structured metadata:
+
+```typescript
+import { PaymentError } from '@breadstone/archipel-platform-payments';
+
+try {
+  await this._paymentClient.createCheckoutSession(params);
+} catch (error) {
+  if (error instanceof PaymentError) {
+    logger.error('Payment operation failed', {
+      provider: error.provider,  // 'stripe', 'paddle', 'mollie', 'lemonsqueezy'
+      code: error.code,          // 'PAYMENT'
+      cause: error.cause,        // Original provider SDK error
+    });
+  }
+}
+```
+
+| Property   | Type     | Description                                        |
+| ---------- | -------- | -------------------------------------------------- |
+| `code`     | `string` | Always `'PAYMENT'`                                 |
+| `provider` | `string` | Provider that failed (`stripe`, `paddle`, etc.)    |
+| `cause`    | `unknown`| Original error from the provider SDK               |
+
+---
+
 ## Exports Summary
 
 ### Core (`@breadstone/archipel-platform-payments`)
@@ -523,6 +551,7 @@ export class RecipeController {
 | `INormalizedSubscription`    | Interface     | Normalized subscription             |
 | `INormalizedWebhookEvent`    | Interface     | Normalized webhook event            |
 | `SubscriptionStatus`         | Type Alias    | Subscription status union           |
+| `PaymentError`               | Error class   | Domain error for payment failures   |
 
 ### Provider subpaths
 

package/data/packages/platform-reporting/api/Class.ReportingContributorRegistry.md

@@ -29,7 +29,7 @@ new ReportingContributorRegistry(): ReportingContributorRegistry;
 getContributors(): readonly IReportingContributor[];
 ```
 
-Defined in: [core/ReportingContributorRegistry.ts:31](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-reporting/src/core/ReportingContributorRegistry.ts#L31)
+Defined in: [core/ReportingContributorRegistry.ts:37](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-reporting/src/core/ReportingContributorRegistry.ts#L37)
 
 #### Returns
 

package/data/packages/platform-reporting/index.md

@@ -30,6 +30,8 @@ export class AppModule {}
 
 Each feature module provides an `IReportingContributor` that exposes the datasets it can report on. Contributors are registered with the `ReportingContributorRegistry` and discovered by the `ReportingFacade`.
 
+> **Capacity limit:** The registry enforces a maximum of **200** registered contributors. Attempts to exceed this limit are logged as warnings and silently ignored.
+
 ### IReportingContributor
 
 ```typescript
@@ -128,7 +130,7 @@ export class OrderModule implements OnModuleInit {
 
 ## ReportingFacade
 
-Central API for catalog browsing and query execution.
+Central API for catalog browsing and query execution. Each `executeQuery()` call is subject to a **30-second timeout** — queries that exceed this limit throw a `ReportingExecutionError`.
 
 ### Browse Catalog