@breadstone/archipel-mcp 0.0.20 → 0.0.22

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
 

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

@@ -0,0 +1,135 @@
+---
+title: platform-resources
+description: Multi-strategy resource management with MIME type detection and optional caching.
+order: 3
+tags: [resources, files, blob, mime, caching]
+package: '@breadstone/archipel-platform-resources'
+---
+
+# platform-resources
+
+Multi-strategy resource management for NestJS applications. Loads files from the file system, embedded buffers, or blob storage with MIME type detection and optional caching. Extracted from `platform-core` to provide a focused, independently versionable resource module.
+
+**Package:** `@breadstone/archipel-platform-resources`
+
+## Installation
+
+```typescript
+import {
+  ResourceModule,
+  ResourceManager,
+  FileResourceStrategy,
+  BlobResourceStrategy,
+  EmbeddedResourceStrategy,
+  ResourceNotFoundError,
+} from '@breadstone/archipel-platform-resources';
+```
+
+---
+
+## Module Registration
+
+Register the module with one or more resource strategies:
+
+```typescript
+import { Module } from '@nestjs/common';
+import { ResourceModule, FileResourceStrategy, EmbeddedResourceStrategy } from '@breadstone/archipel-platform-resources';
+import { join } from 'node:path';
+
+@Module({
+  imports: [
+    ResourceModule.forRoot({
+      strategies: [
+        new FileResourceStrategy({
+          basePath: join(__dirname, '..', 'assets'),
+        }),
+        new EmbeddedResourceStrategy([
+          { name: 'fallback.html', buffer: Buffer.from('<html>Fallback</html>') },
+        ]),
+      ],
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+## Using ResourceManager
+
+Inject and use `ResourceManager` to load resources at runtime:
+
+```typescript
+import { Injectable } from '@nestjs/common';
+import { ResourceManager } from '@breadstone/archipel-platform-resources';
+
+@Injectable()
+export class TemplateService {
+  constructor(private readonly _resourceManager: ResourceManager) {}
+
+  public async loadTemplate(name: string): Promise<string> {
+    const result = await this._resourceManager.get(name);
+    return result.buffer.toString('utf-8');
+  }
+}
+```
+
+---
+
+## Strategies
+
+| Strategy                    | Description                                                       |
+| --------------------------- | ----------------------------------------------------------------- |
+| `FileResourceStrategy`     | Loads resources from the local file system with glob support       |
+| `BlobResourceStrategy`     | Loads resources from a blob storage adapter (Vercel, Azure, S3)    |
+| `EmbeddedResourceStrategy` | Serves pre-loaded in-memory buffers                                |
+
+### BlobResourceStrategy
+
+For loading resources from cloud blob storage, provide an adapter that implements `IBlobServiceAdapter`:
+
+```typescript
+import { BlobResourceStrategy, type IBlobServiceAdapter } from '@breadstone/archipel-platform-resources';
+
+const blobStrategy = new BlobResourceStrategy({
+  adapter: myBlobAdapter,
+  containerName: 'templates',
+});
+```
+
+### Custom Strategies
+
+Implement `IResourceStrategy` to create your own resource loading strategy:
+
+```typescript
+import type { IResourceStrategy, IResourceResult } from '@breadstone/archipel-platform-resources';
+
+export class CustomStrategy implements IResourceStrategy {
+  public async get(name: string): Promise<IResourceResult | undefined> {
+    // Custom loading logic
+  }
+}
+```
+
+---
+
+## Interfaces
+
+| Interface              | Description                              |
+| ---------------------- | ---------------------------------------- |
+| `IResourceResult`     | Result object with `buffer` and `metadata` |
+| `IResourceMetadata`   | Metadata including `mimeType` and `size`  |
+| `IResourceStrategy`   | Strategy contract for resource loading    |
+| `IBlobServiceAdapter`  | Adapter contract for blob storage access  |
+
+---
+
+## Error Classes
+
+| Error                    | Description                                   |
+| ------------------------ | --------------------------------------------- |
+| `ResourceNotFoundError` | Thrown when a requested resource is not found   |
+
+---
+
+## API Reference
+
+See the auto-generated [API Reference](./api/) for full details on all exported classes, interfaces, and types.

package/data/packages/platform-telemetry/api/Class.MetricsService.md

@@ -7,10 +7,14 @@ editUrl: false
 
 Defined in: [metrics/MetricsService.ts:25](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/metrics/MetricsService.ts#L25)
 
-Provides lazily-initialized OpenTelemetry metric instruments.
+Provides eagerly-initialized OpenTelemetry metric instruments.
 
 Replaces the former module-level `let instruments` closure (TEL-4).
 
+## Implements
+
+- `OnModuleInit`
+
 ## Constructors
 
 ### Constructor
@@ -31,10 +35,32 @@ new MetricsService(): MetricsService;
 getInstruments(): IMetricInstruments | undefined;
 ```
 
-Defined in: [metrics/MetricsService.ts:38](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/metrics/MetricsService.ts#L38)
+Defined in: [metrics/MetricsService.ts:61](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/metrics/MetricsService.ts#L61)
 
-Returns the cached metric instruments, creating them on first access.
+Returns the cached metric instruments.
 
 #### Returns
 
 [`IMetricInstruments`](Interface.IMetricInstruments) \| `undefined`
+
+***
+
+### onModuleInit()
+
+```ts
+onModuleInit(): void;
+```
+
+Defined in: [metrics/MetricsService.ts:40](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/metrics/MetricsService.ts#L40)
+
+Eagerly initializes metric instruments at module startup.
+
+#### Returns
+
+`void`
+
+#### Implementation of
+
+```ts
+OnModuleInit.onModuleInit
+```

package/data/packages/platform-telemetry/api/Class.OtelSdkHolder.md

@@ -36,7 +36,7 @@ new OtelSdkHolder(): OtelSdkHolder;
 onApplicationShutdown(): Promise<void>;
 ```
 
-Defined in: [OtelSdkHolder.ts:34](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/OtelSdkHolder.ts#L34)
+Defined in: [OtelSdkHolder.ts:39](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/OtelSdkHolder.ts#L39)
 
 #### Returns
 
@@ -58,9 +58,10 @@ OnApplicationShutdown.onApplicationShutdown
 setSdk(sdk): void;
 ```
 
-Defined in: [OtelSdkHolder.ts:29](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/OtelSdkHolder.ts#L29)
+Defined in: [OtelSdkHolder.ts:30](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/OtelSdkHolder.ts#L30)
 
 Stores the SDK reference so it can be shut down later.
+Can only be called once — subsequent calls are ignored.
 
 #### Parameters
 

package/data/packages/platform-telemetry/api/Class.TelemetryLoggerService.md

@@ -23,7 +23,7 @@ Defined in: [logger/TelemetryLoggerService.ts:5](https://github.com/RueDeRennes/
 new TelemetryLoggerService(ruleEngine?): TelemetryLoggerService;
 ```
 
-Defined in: [logger/TelemetryLoggerService.ts:12](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/logger/TelemetryLoggerService.ts#L12)
+Defined in: [logger/TelemetryLoggerService.ts:11](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/logger/TelemetryLoggerService.ts#L11)
 
 #### Parameters
 
@@ -49,7 +49,7 @@ ConsoleLogger.constructor
 debug(message, context?): void;
 ```
 
-Defined in: [logger/TelemetryLoggerService.ts:19](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/logger/TelemetryLoggerService.ts#L19)
+Defined in: [logger/TelemetryLoggerService.ts:30](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/logger/TelemetryLoggerService.ts#L30)
 
 Write a 'debug' level log, if the configured level allows for it.
 Prints to `stdout` with newline.
@@ -88,7 +88,7 @@ error(
    context?): void;
 ```
 
-Defined in: [logger/TelemetryLoggerService.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/logger/TelemetryLoggerService.ts#L17)
+Defined in: [logger/TelemetryLoggerService.ts:22](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/logger/TelemetryLoggerService.ts#L22)
 
 Write an 'error' level log, if the configured level allows for it.
 Prints to `stderr` with newline.
@@ -125,7 +125,7 @@ ConsoleLogger.error
 log(message, context?): void;
 ```
 
-Defined in: [logger/TelemetryLoggerService.ts:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/logger/TelemetryLoggerService.ts#L16)
+Defined in: [logger/TelemetryLoggerService.ts:18](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/logger/TelemetryLoggerService.ts#L18)
 
 Write a 'log' level log, if the configured level allows for it.
 Prints to `stdout` with newline.
@@ -161,7 +161,7 @@ ConsoleLogger.log
 verbose(message, context?): void;
 ```
 
-Defined in: [logger/TelemetryLoggerService.ts:20](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/logger/TelemetryLoggerService.ts#L20)
+Defined in: [logger/TelemetryLoggerService.ts:34](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/logger/TelemetryLoggerService.ts#L34)
 
 Write a 'verbose' level log, if the configured level allows for it.
 Prints to `stdout` with newline.
@@ -197,7 +197,7 @@ ConsoleLogger.verbose
 warn(message, context?): void;
 ```
 
-Defined in: [logger/TelemetryLoggerService.ts:18](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/logger/TelemetryLoggerService.ts#L18)
+Defined in: [logger/TelemetryLoggerService.ts:26](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/logger/TelemetryLoggerService.ts#L26)
 
 Write a 'warn' level log, if the configured level allows for it.
 Prints to `stdout` with newline.

package/data/packages/platform-telemetry/api/Class.TelemetryRuleEngine.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: TelemetryRuleEngine
 
-Defined in: [rules/TelemetryRuleEngine.ts:11](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/rules/TelemetryRuleEngine.ts#L11)
+Defined in: [rules/TelemetryRuleEngine.ts:12](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/rules/TelemetryRuleEngine.ts#L12)
 
 ## Constructors
 
@@ -15,7 +15,7 @@ Defined in: [rules/TelemetryRuleEngine.ts:11](https://github.com/RueDeRennes/arc
 new TelemetryRuleEngine(options, metricsService): TelemetryRuleEngine;
 ```
 
-Defined in: [rules/TelemetryRuleEngine.ts:18](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/rules/TelemetryRuleEngine.ts#L18)
+Defined in: [rules/TelemetryRuleEngine.ts:20](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/rules/TelemetryRuleEngine.ts#L20)
 
 #### Parameters
 
@@ -36,7 +36,7 @@ Defined in: [rules/TelemetryRuleEngine.ts:18](https://github.com/RueDeRennes/arc
 process(message): void;
 ```
 
-Defined in: [rules/TelemetryRuleEngine.ts:25](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/rules/TelemetryRuleEngine.ts#L25)
+Defined in: [rules/TelemetryRuleEngine.ts:27](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/rules/TelemetryRuleEngine.ts#L27)
 
 #### Parameters
 

package/data/packages/platform-telemetry/api/Variable.TELEMETRY_ENABLED.md

@@ -9,4 +9,4 @@ editUrl: false
 const TELEMETRY_ENABLED: typeof TELEMETRY_ENABLED;
 ```
 
-Defined in: [tokens.ts:4](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/tokens.ts#L4)
+Defined in: [tokens/TelemetryTokens.ts:4](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/tokens/TelemetryTokens.ts#L4)

package/data/packages/platform-telemetry/api/Variable.TELEMETRY_FACADE.md

@@ -9,4 +9,4 @@ editUrl: false
 const TELEMETRY_FACADE: typeof TELEMETRY_FACADE;
 ```
 
-Defined in: [tokens.ts:3](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/tokens.ts#L3)
+Defined in: [tokens/TelemetryTokens.ts:3](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/tokens/TelemetryTokens.ts#L3)

package/data/packages/platform-telemetry/api/Variable.TELEMETRY_OPTIONS.md

@@ -9,4 +9,4 @@ editUrl: false
 const TELEMETRY_OPTIONS: typeof TELEMETRY_OPTIONS;
 ```
 
-Defined in: [tokens.ts:2](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/tokens.ts#L2)
+Defined in: [tokens/TelemetryTokens.ts:2](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/tokens/TelemetryTokens.ts#L2)

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

@@ -9,7 +9,7 @@ editUrl: false
 
 | Class | Description |
 | ------ | ------ |
-| [MetricsService](Class.MetricsService) | Provides lazily-initialized OpenTelemetry metric instruments. |
+| [MetricsService](Class.MetricsService) | Provides eagerly-initialized OpenTelemetry metric instruments. |
 | [NoopTelemetryFacade](Class.NoopTelemetryFacade) | - |
 | [OtelSdkHolder](Class.OtelSdkHolder) | Holds a reference to the OpenTelemetry NodeSDK instance and performs a graceful shutdown when the application terminates. |
 | [TelemetryCacheMetricsRecorder](Class.TelemetryCacheMetricsRecorder) | Generic cache metrics recorder that forwards cache lifecycle events into the telemetry facade (which may be a noop when disabled). |

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

@@ -164,7 +164,9 @@ The module initializes these OTEL components:
 | Metrics exporter        | OTLP/HTTP                                |
 | Express instrumentation | `@opentelemetry/instrumentation-express` |
 | HTTP instrumentation    | `@opentelemetry/instrumentation-http`    |
-| SDK shutdown hook       | Graceful on `OnModuleDestroy`            |
+| SDK shutdown hook       | Graceful on `OnModuleDestroy` (5-second timeout) |
+| SDK init guard          | `OtelSdkHolder` write-once — prevents double-init |
+| Metric instruments      | Eager init via `MetricsService.onModuleInit()`     |
 
 ---