@breadstone/archipel-mcp 0.0.28 → 0.0.31

package/data/guides/queue-infrastructure.md

@@ -28,6 +28,12 @@ For Azure Service Bus:
 yarn add @azure/service-bus
 ```
 
+For Vercel Queues:
+
+```bash
+yarn add @vercel/queue
+```
+
 ---
 
 ## Configuration
@@ -58,6 +64,18 @@ AZURE_RECEIVE_WAIT_MS=5000
 
 `AZURE_CONNECTION_STRING` is required when using `AzureQueue`. `AZURE_RECEIVE_WAIT_MS` is optional (defaults to `5000`).
 
+### Vercel Queues Variables
+
+```env
+VERCEL_QUEUE_REGION=iad1
+VERCEL_QUEUE_CONSUMER_GROUP=my-consumer
+VERCEL_QUEUE_TOKEN=
+VERCEL_QUEUE_DEPLOYMENT_ID=
+VERCEL_QUEUE_VISIBILITY_TIMEOUT_SECONDS=300
+```
+
+`VERCEL_QUEUE_REGION` and `VERCEL_QUEUE_CONSUMER_GROUP` are required when using `VercelQueue`. `VERCEL_QUEUE_TOKEN` is auto-fetched via OIDC when omitted. `VERCEL_QUEUE_VISIBILITY_TIMEOUT_SECONDS` defaults to `300`.
+
 ### Using Config Keys
 
 Import the typed config keys and pass them to your module registration:
@@ -66,6 +84,7 @@ Import the typed config keys and pass them to your module registration:
 import { PLATFORM_QUEUE_CONFIG_ENTRIES } from '@breadstone/archipel-platform-queue';
 import { BULLMQ_CONFIG_ENTRIES } from '@breadstone/archipel-platform-queue/bullmq';
 import { AZURE_CONFIG_ENTRIES } from '@breadstone/archipel-platform-queue/azure';
+import { VERCEL_CONFIG_ENTRIES } from '@breadstone/archipel-platform-queue/vercel';
 ```
 
 ---
@@ -79,6 +98,7 @@ import { AZURE_CONFIG_ENTRIES } from '@breadstone/archipel-platform-queue/azure'
 | `MemoryQueue`  | In-memory          | No          | Development, testing, single-instance apps  |
 | `BullMqQueue`  | Redis via BullMQ   | Yes         | Multi-instance deployments, distributed jobs|
 | `AzureQueue`   | Azure Service Bus  | Yes         | Enterprise cloud messaging, peek-lock       |
+| `VercelQueue`  | Vercel Queues      | Yes         | Serverless Vercel deployments               |
 
 All implementations share the same `IQueue` contract, so switching providers requires only changing the import and constructor options — no business logic changes.
 
@@ -200,6 +220,48 @@ Senders and receivers are lazily created per queue name and cached for the lifet
 
 ---
 
+## Vercel Queues
+
+### Basic Setup
+
+`VercelQueue` uses the official `@vercel/queue` SDK (`PollingQueueClient`) for durable, serverless message streaming on Vercel:
+
+```typescript
+import { Module } from '@nestjs/common';
+import { VercelQueue } from '@breadstone/archipel-platform-queue/vercel';
+
+@Module({
+    providers: [
+        {
+            provide: 'IQueue',
+            useFactory: () =>
+                new VercelQueue({
+                    region: 'iad1',
+                    consumerGroup: 'my-consumer',
+                }),
+        },
+    ],
+    exports: ['IQueue'],
+})
+export class QueueModule {}
+```
+
+### How It Works
+
+`enqueue()` calls `send()` on the SDK to publish a message to the given topic. `dequeue()` calls `receive()`, which invokes a handler callback when a message is available. The handler is suspended via an internal gate promise until `markCompleted()` or `markFailed()` is called, at which point the handler completes and the SDK auto-acknowledges the message.
+
+Both `markCompleted()` and `markFailed()` acknowledge (remove) the message. If retry behaviour is desired, re-enqueue the job explicitly.
+
+### Authentication
+
+When deployed on Vercel, the SDK auto-fetches an OIDC token. For local development, provide a `token` in the constructor options.
+
+### Graceful Shutdown
+
+`VercelQueue` implements `OnModuleDestroy` and releases all pending gates, causing in-flight SDK handlers to complete normally and acknowledge their messages.
+
+---
+
 ## Usage in Services
 
 Inject the `IQueue` token and use the same API regardless of the underlying provider:

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

@@ -12,6 +12,8 @@ Provider-agnostic analytics and error tracking module supporting multiple backen
 
 **Package:** `@breadstone/archipel-platform-analytics`
 
+<InstallTabs />
+
 ## Quick Start
 
 ```typescript

package/data/packages/platform-authentication/api/Class.AuthModule.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: AuthModule
 
-Defined in: [libs/platform-authentication/src/AuthModule.ts:146](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L146)
+Defined in: [libs/platform-authentication/src/AuthModule.ts:145](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L145)
 
 The `AuthModule` handles JWT-based authentication,
 including token creation and validation.
@@ -39,7 +39,7 @@ new AuthModule(): AuthModule;
 configure(consumer): void;
 ```
 
-Defined in: [libs/platform-authentication/src/AuthModule.ts:268](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L268)
+Defined in: [libs/platform-authentication/src/AuthModule.ts:265](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L265)
 
 #### Parameters
 
@@ -59,7 +59,7 @@ Defined in: [libs/platform-authentication/src/AuthModule.ts:268](https://github.
 static register(options): DynamicModule;
 ```
 
-Defined in: [libs/platform-authentication/src/AuthModule.ts:156](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L156)
+Defined in: [libs/platform-authentication/src/AuthModule.ts:155](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L155)
 
 Registers the auth module with the provided port implementations.
 

package/data/packages/platform-authentication/api/Class.JwtAuthGuard.md

@@ -5,9 +5,12 @@ editUrl: false
 ---
 # Class: JwtAuthGuard
 
-Defined in: [libs/platform-authentication/src/guards/JwtAuthGuard.ts:14](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/guards/JwtAuthGuard.ts#L14)
+Defined in: [libs/platform-authentication/src/guards/JwtAuthGuard.ts:19](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/guards/JwtAuthGuard.ts#L19)
 
 The `JwtAuthGuard` protects routes using JWT-based authentication.
+It checks for the `@Public()` decorator metadata.
+When registered as `APP_GUARD`, all routes require JWT authentication by default.
+Routes decorated with `@Public()` are exempt.
 
 ## Extends
 
@@ -18,23 +21,52 @@ The `JwtAuthGuard` protects routes using JWT-based authentication.
 ### Constructor
 
 ```ts
-new JwtAuthGuard(...args): JwtAuthGuard;
+new JwtAuthGuard(reflector): JwtAuthGuard;
 ```
 
-Defined in: node\_modules/@nestjs/passport/dist/interfaces/type.interface.d.ts:2
+Defined in: [libs/platform-authentication/src/guards/JwtAuthGuard.ts:22](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/guards/JwtAuthGuard.ts#L22)
 
 #### Parameters
 
 | Parameter | Type |
 | ------ | ------ |
-| ...`args` | `any`[] |
+| `reflector` | `Reflector` |
 
 #### Returns
 
 `JwtAuthGuard`
 
-#### Inherited from
+#### Overrides
 
 ```ts
 AuthGuard('jwt').constructor
 ```
+
+## Methods
+
+### canActivate()
+
+```ts
+canActivate(context): boolean | Promise<boolean> | Observable<boolean>;
+```
+
+Defined in: [libs/platform-authentication/src/guards/JwtAuthGuard.ts:30](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/guards/JwtAuthGuard.ts#L30)
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `context` | `ExecutionContext` | Current execution context. Provides access to details about the current request pipeline. |
+
+#### Returns
+
+`boolean` \| `Promise`\<`boolean`\> \| `Observable`\<`boolean`\>
+
+Value indicating whether or not the current request is allowed to
+proceed.
+
+#### Overrides
+
+```ts
+AuthGuard('jwt').canActivate
+```

package/data/packages/platform-authentication/api/Interface.IAuthModuleOptions.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Interface: IAuthModuleOptions
 
-Defined in: [libs/platform-authentication/src/AuthModule.ts:57](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L57)
+Defined in: [libs/platform-authentication/src/AuthModule.ts:56](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L56)
 
 Options for configuring the `AuthModule`.
 
@@ -17,7 +17,7 @@ Options for configuring the `AuthModule`.
 optional additionalConfigEntries?: readonly Omit<IConfigRegistryEntry<unknown>, "module">[];
 ```
 
-Defined in: [libs/platform-authentication/src/AuthModule.ts:97](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L97)
+Defined in: [libs/platform-authentication/src/AuthModule.ts:96](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L96)
 
 Optional additional configuration entries to register (e.g. provider-specific OAuth keys).
 Import them from the provider-specific sub-paths
@@ -31,7 +31,7 @@ Import them from the provider-specific sub-paths
 optional additionalProviders?: Provider[];
 ```
 
-Defined in: [libs/platform-authentication/src/AuthModule.ts:119](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L119)
+Defined in: [libs/platform-authentication/src/AuthModule.ts:118](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L118)
 
 Optional additional providers required by optional features (e.g. TOTP MFA).
 Import them from the provider-specific sub-paths
@@ -45,7 +45,7 @@ Import them from the provider-specific sub-paths
 authSubject: Type<AuthSubjectPort>;
 ```
 
-Defined in: [libs/platform-authentication/src/AuthModule.ts:61](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L61)
+Defined in: [libs/platform-authentication/src/AuthModule.ts:60](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L60)
 
 Implementation of the auth subject port (user lookup for JWT/Local/Anonymous connectors).
 
@@ -57,7 +57,7 @@ Implementation of the auth subject port (user lookup for JWT/Local/Anonymous con
 optional challengeStore?: Type<ChallengeStorePort>;
 ```
 
-Defined in: [libs/platform-authentication/src/AuthModule.ts:126](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L126)
+Defined in: [libs/platform-authentication/src/AuthModule.ts:125](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L125)
 
 Optional implementation of the challenge store port.
 Defaults to an in-memory store suitable for single-instance deployments.
@@ -71,7 +71,7 @@ For multi-instance deployments, provide a Redis-backed implementation.
 optional mfaChannels?: Type<any>[];
 ```
 
-Defined in: [libs/platform-authentication/src/AuthModule.ts:112](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L112)
+Defined in: [libs/platform-authentication/src/AuthModule.ts:111](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L111)
 
 Optional array of additional MFA channel types to register (e.g. `TotpMfaChannel`).
 Import them from the provider-specific sub-paths
@@ -87,7 +87,7 @@ Built-in channels (SMS, Email, Push) are always registered.
 mfaSubject: Type<MfaSubjectPort>;
 ```
 
-Defined in: [libs/platform-authentication/src/AuthModule.ts:66](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L66)
+Defined in: [libs/platform-authentication/src/AuthModule.ts:65](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L65)
 
 Implementation of the MFA subject port (MFA state persistence).
 
@@ -99,7 +99,7 @@ Implementation of the MFA subject port (MFA state persistence).
 sessionPersistence: Type<SessionPersistencePort>;
 ```
 
-Defined in: [libs/platform-authentication/src/AuthModule.ts:71](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L71)
+Defined in: [libs/platform-authentication/src/AuthModule.ts:70](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L70)
 
 Implementation of the session persistence port.
 
@@ -111,7 +111,7 @@ Implementation of the session persistence port.
 optional socialAuth?: Type<SocialAuthPort>;
 ```
 
-Defined in: [libs/platform-authentication/src/AuthModule.ts:82](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L82)
+Defined in: [libs/platform-authentication/src/AuthModule.ts:81](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L81)
 
 Optional implementation of the social auth port (OAuth connectors).
 When provided together with `socialConnectors`, the social auth flow is enabled.
@@ -124,7 +124,7 @@ When provided together with `socialConnectors`, the social auth flow is enabled.
 optional socialConnectors?: Type<any>[];
 ```
 
-Defined in: [libs/platform-authentication/src/AuthModule.ts:90](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L90)
+Defined in: [libs/platform-authentication/src/AuthModule.ts:89](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L89)
 
 Optional array of social connector types to register (e.g. `AppleConnector`, `GithubConnector`).
 Import them from the provider-specific sub-paths
@@ -139,7 +139,7 @@ Requires `socialAuth` to be set.
 optional tokenEnricher?: Type<TokenEnricherPort>;
 ```
 
-Defined in: [libs/platform-authentication/src/AuthModule.ts:103](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L103)
+Defined in: [libs/platform-authentication/src/AuthModule.ts:102](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L102)
 
 Optional implementation of the token enricher port.
 When provided, additional claims are added to JWT tokens.
@@ -152,6 +152,6 @@ When provided, additional claims are added to JWT tokens.
 verificationSubject: Type<VerificationSubjectPort>;
 ```
 
-Defined in: [libs/platform-authentication/src/AuthModule.ts:76](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L76)
+Defined in: [libs/platform-authentication/src/AuthModule.ts:75](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/AuthModule.ts#L75)
 
 Implementation of the verification subject port (email/pin verification).

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

@@ -17,10 +17,9 @@ editUrl: false
 | [AuthTokenService](Class.AuthTokenService) | Generic service responsible for creating JWT access tokens. Builds a base payload from [IAuthSubject](Interface.IAuthSubject) and optionally enriches it via the [TokenEnricherPort](Class.TokenEnricherPort) with product-specific claims. |
 | [ChallengeService](Class.ChallengeService) | Stores and validates MFA login challenges. |
 | [ChallengeStorePort](Class.ChallengeStorePort) | Abstract port for persisting MFA challenge state. |
-| [GithubAuthGuard](Class.GithubAuthGuard) | The `GithubAuthGuard` protects routes using GitHub authentication. |
 | [GithubConnector](Class.GithubConnector) | - |
 | [GoogleConnector](Class.GoogleConnector) | The `GoogleConnector` integrates Google OAuth authentication. |
-| [JwtAuthGuard](Class.JwtAuthGuard) | The `JwtAuthGuard` protects routes using JWT-based authentication. |
+| [JwtAuthGuard](Class.JwtAuthGuard) | The `JwtAuthGuard` protects routes using JWT-based authentication. It checks for the `@Public()` decorator metadata. When registered as `APP_GUARD`, all routes require JWT authentication by default. Routes decorated with `@Public()` are exempt. |
 | [JwtPayloadBase](Class.JwtPayloadBase) | Abstract base class for JWT payloads. Products extend this to add their own claims (e.g. `profileId`, `isPro`). Used as both a serialization contract and NestJS injection token. |
 | [LastActiveMiddleware](Class.LastActiveMiddleware) | Middleware to automatically update the lastActive timestamp for authenticated sessions. Extracts the JWT token from the Authorization header and updates the session asynchronously. |
 | [LocalAuthGuard](Class.LocalAuthGuard) | The `LocalAuthGuard` protects routes using local authentication. |

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

@@ -12,6 +12,8 @@ Full-featured authentication library supporting JWT tokens, OAuth social login (
 
 **Package:** `@breadstone/archipel-platform-authentication`
 
+<InstallTabs />
+
 ## Quick Start
 
 ```typescript

package/data/packages/platform-blob-storage/api/Variable.AWS_S3_PROVIDER_OPTIONS.md

@@ -9,4 +9,4 @@ editUrl: false
 const AWS_S3_PROVIDER_OPTIONS: typeof AWS_S3_PROVIDER_OPTIONS;
 ```
 
-Defined in: [BlobStorageTokens.ts:6](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobStorageTokens.ts#L6)
+Defined in: [tokens/BlobStorageTokens.ts:6](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/tokens/BlobStorageTokens.ts#L6)

package/data/packages/platform-blob-storage/api/Variable.AZURE_BLOB_PROVIDER_OPTIONS.md

@@ -9,4 +9,4 @@ editUrl: false
 const AZURE_BLOB_PROVIDER_OPTIONS: typeof AZURE_BLOB_PROVIDER_OPTIONS;
 ```
 
-Defined in: [BlobStorageTokens.ts:5](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobStorageTokens.ts#L5)
+Defined in: [tokens/BlobStorageTokens.ts:5](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/tokens/BlobStorageTokens.ts#L5)

package/data/packages/platform-blob-storage/api/Variable.BLOB_PROVIDER.md

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

package/data/packages/platform-blob-storage/api/Variable.VERCEL_BLOB_PROVIDER_OPTIONS.md

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

package/data/packages/platform-blob-storage/index.md

@@ -12,6 +12,8 @@ Cloud file storage abstraction supporting pluggable providers and optional metad
 
 **Package:** `@breadstone/archipel-platform-blob-storage`
 
+<InstallTabs />
+
 ## Quick Start
 
 ```typescript

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

@@ -12,6 +12,8 @@ Layered caching library providing both an in-memory LRU cache and a Redis-backed
 
 **Package:** `@breadstone/archipel-platform-caching`
 
+<InstallTabs />
+
 ## Quick Start
 
 ```typescript

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

@@ -14,6 +14,8 @@ Type-safe configuration management for NestJS applications. Provides compile-tim
 
 **Package:** `@breadstone/archipel-platform-configuration`
 
+<InstallTabs />
+
 ## Quick Start
 
 ```typescript

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

@@ -14,6 +14,8 @@ The foundation library that every other Archipel package depends on. Provides ob
 
 **Package:** `@breadstone/archipel-platform-core`
 
+<InstallTabs />
+
 ## Installation
 
 ```typescript

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

@@ -12,6 +12,8 @@ Cryptographic building blocks for NestJS applications: bcrypt password hashing,
 
 **Package:** `@breadstone/archipel-platform-cryptography`
 
+<InstallTabs />
+
 ## Quick Start
 
 ```typescript

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

@@ -12,6 +12,8 @@ Prisma ORM integration with PostgreSQL featuring a repository base class, type-s
 
 **Package:** `@breadstone/archipel-platform-database`
 
+<InstallTabs />
+
 ## Quick Start
 
 ```typescript

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

@@ -12,6 +12,8 @@ Template-based document generation engine supporting DOCX and PDF output. Uses p
 
 **Package:** `@breadstone/archipel-platform-documents`
 
+<InstallTabs />
+
 ## Quick Start
 
 ```typescript

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

@@ -12,6 +12,8 @@ Provider-agnostic e-signing infrastructure for NestJS. Exposes a unified `Esigni
 
 **Package:** `@breadstone/archipel-platform-esigning`
 
+<InstallTabs />
+
 ## Architecture
 
 ```mermaid

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

@@ -12,6 +12,8 @@ Health check orchestration for NestJS applications built on `@nestjs/terminus`.
 
 **Package:** `@breadstone/archipel-platform-health`
 
+<InstallTabs />
+
 ## Installation
 
 ```typescript

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

@@ -12,6 +12,8 @@ Multi-provider AI text generation library supporting OpenAI, Anthropic, Google G
 
 **Package:** `@breadstone/archipel-platform-intelligence`
 
+<InstallTabs />
+
 ## Quick Start
 
 ```typescript

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

@@ -12,6 +12,8 @@ Configurable logging module for NestJS applications with application-wide log-le
 
 **Package:** `@breadstone/archipel-platform-logging`
 
+<InstallTabs />
+
 ## Quick Start
 
 ```typescript

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

@@ -12,6 +12,8 @@ Multi-strategy email delivery system with pluggable transports (SMTP, Postmark,
 
 **Package:** `@breadstone/archipel-platform-mailing`
 
+<InstallTabs />
+
 ## Architecture
 
 ```mermaid

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

@@ -12,6 +12,8 @@ Type-safe object-to-object mapping framework for transforming domain entities in
 
 **Package:** `@breadstone/archipel-platform-mapping`
 
+<InstallTabs />
+
 ## Installation
 
 ```typescript

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

@@ -12,6 +12,8 @@ A reusable NestJS module for building [Model Context Protocol (MCP)](https://mod
 
 **Package:** `@breadstone/archipel-platform-mcp`
 
+<InstallTabs />
+
 ## Installation
 
 ```typescript

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

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: SwaggerFeatureDiscovery
 
-Defined in: [discovery/SwaggerFeatureDiscovery.ts:13](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/discovery/SwaggerFeatureDiscovery.ts#L13)
+Defined in: [discovery/SwaggerFeatureDiscovery.ts:19](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/discovery/SwaggerFeatureDiscovery.ts#L19)
 
 Centralizes the discovery of Swagger features declared across backend modules.
 
@@ -29,7 +29,7 @@ new SwaggerFeatureDiscovery(): SwaggerFeatureDiscovery;
 registerDefaultFeatures(featureRegistry): this;
 ```
 
-Defined in: [discovery/SwaggerFeatureDiscovery.ts:45](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/discovery/SwaggerFeatureDiscovery.ts#L45)
+Defined in: [discovery/SwaggerFeatureDiscovery.ts:51](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/discovery/SwaggerFeatureDiscovery.ts#L51)
 
 Registers the default composite Swagger documents that aggregate the complete API.
 
@@ -53,7 +53,7 @@ The discovery instance for chaining.
 registerDiscoveredFeatures(featureRegistry): this;
 ```
 
-Defined in: [discovery/SwaggerFeatureDiscovery.ts:23](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/discovery/SwaggerFeatureDiscovery.ts#L23)
+Defined in: [discovery/SwaggerFeatureDiscovery.ts:29](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/discovery/SwaggerFeatureDiscovery.ts#L29)
 
 Registers all discovered feature modules in the provided Swagger registry.
 
@@ -68,3 +68,54 @@ Registers all discovered feature modules in the provided Swagger registry.
 `this`
 
 The discovery instance for chaining.
+
+***
+
+### setupMultiDocumentSwagger()
+
+```ts
+static setupMultiDocumentSwagger(
+   app, 
+   config, 
+   host, 
+   resource, 
+   content, 
+themeConfig?): Promise<void>;
+```
+
+Defined in: [discovery/SwaggerFeatureDiscovery.ts:90](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/discovery/SwaggerFeatureDiscovery.ts#L90)
+
+Auto-discovers and sets up multi-document Swagger in a single call.
+Handles feature discovery, registry setup, and service initialization.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `app` | `INestApplication` | The NestJS application instance |
+| `config` | `ConfigService` | Configuration service for reading app settings |
+| `host` | `HostService` | Host service for determining base URL |
+| `resource` | `ResourceManager` | Resource manager for loading theme assets |
+| `content` | `ContentTemplateEngine` | Content template engine for rendering HTML |
+| `themeConfig?` | [`ISwaggerThemeConfig`](Interface.ISwaggerThemeConfig) | Optional theme configuration for branding colors |
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Promise resolving when setup is complete
+
+#### Static
+
+#### Example
+
+```typescript
+await SwaggerFeatureDiscovery.setupMultiDocumentSwagger(
+  app,
+  config,
+  host,
+  resource,
+  content,
+  { primary: '#0066cc', secondary: '#003d99' }
+);
+```

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

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: SwaggerMultiDocumentService
 
-Defined in: [services/SwaggerMultiDocumentService.ts:15](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/services/SwaggerMultiDocumentService.ts#L15)
+Defined in: [services/SwaggerMultiDocumentService.ts:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/services/SwaggerMultiDocumentService.ts#L16)
 
 ## Constructors
 
@@ -18,10 +18,11 @@ new SwaggerMultiDocumentService(
    hostService, 
    featureRegistry, 
    resourceManager, 
-   contentTemplateEngine): SwaggerMultiDocumentService;
+   contentTemplateEngine, 
+   themeConfig?): SwaggerMultiDocumentService;
 ```
 
-Defined in: [services/SwaggerMultiDocumentService.ts:31](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/services/SwaggerMultiDocumentService.ts#L31)
+Defined in: [services/SwaggerMultiDocumentService.ts:32](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/services/SwaggerMultiDocumentService.ts#L32)
 
 #### Parameters
 
@@ -33,6 +34,7 @@ Defined in: [services/SwaggerMultiDocumentService.ts:31](https://github.com/RueD
 | `featureRegistry` | [`SwaggerFeatureRegistry`](Class.SwaggerFeatureRegistry) |
 | `resourceManager` | `ResourceManager` |
 | `contentTemplateEngine` | `ContentTemplateEngine` |
+| `themeConfig?` | [`ISwaggerThemeConfig`](Interface.ISwaggerThemeConfig) |
 
 #### Returns
 
@@ -49,7 +51,7 @@ generateOpenApiDocuments(): {
 }[];
 ```
 
-Defined in: [services/SwaggerMultiDocumentService.ts:79](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/services/SwaggerMultiDocumentService.ts#L79)
+Defined in: [services/SwaggerMultiDocumentService.ts:81](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/services/SwaggerMultiDocumentService.ts#L81)
 
 Generates OpenAPI documents for every registered feature without wiring HTTP routes.
 
@@ -68,7 +70,7 @@ Generates OpenAPI documents for every registered feature without wiring HTTP rou
 setupMultipleSwaggerDocuments(): Promise<void>;
 ```
 
-Defined in: [services/SwaggerMultiDocumentService.ts:55](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/services/SwaggerMultiDocumentService.ts#L55)
+Defined in: [services/SwaggerMultiDocumentService.ts:57](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/services/SwaggerMultiDocumentService.ts#L57)
 
 Setup multiple Swagger documents for different features