@breadstone/archipel-mcp 0.0.23 → 0.0.26

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

@@ -0,0 +1,78 @@
+---
+title: 'Class: McpHealthIndicator'
+generated: true
+editUrl: false
+---
+# Class: McpHealthIndicator
+
+Defined in: [health/McpHealthIndicator.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mcp/src/health/McpHealthIndicator.ts#L17)
+
+Health indicator for the MCP server infrastructure.
+Verifies that at least one tool, resource, or prompt handler is registered.
+
+## Implements
+
+- `IHealthIndicator`
+
+## Constructors
+
+### Constructor
+
+```ts
+new McpHealthIndicator(registry?): McpHealthIndicator;
+```
+
+Defined in: [health/McpHealthIndicator.ts:26](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mcp/src/health/McpHealthIndicator.ts#L26)
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `registry?` | [`McpRegistryService`](Class.McpRegistryService) |
+
+#### Returns
+
+`McpHealthIndicator`
+
+## Properties
+
+### key
+
+```ts
+readonly key: string = 'mcp';
+```
+
+Defined in: [health/McpHealthIndicator.ts:34](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mcp/src/health/McpHealthIndicator.ts#L34)
+
+Unique key identifying the indicator
+
+#### Implementation of
+
+```ts
+IHealthIndicator.key
+```
+
+## Methods
+
+### check()
+
+```ts
+check(): HealthIndicatorResult<string>;
+```
+
+Defined in: [health/McpHealthIndicator.ts:47](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mcp/src/health/McpHealthIndicator.ts#L47)
+
+Verifies that the MCP registry has at least one registered handler.
+Returns disabled status when no registry is configured.
+
+#### Returns
+
+`HealthIndicatorResult`\<`string`\>
+
+The health indicator result.
+
+#### Implementation of
+
+```ts
+IHealthIndicator.check
+```

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

@@ -10,6 +10,7 @@ editUrl: false
 | Class | Description |
 | ------ | ------ |
 | [McpDiscoveryService](Class.McpDiscoveryService) | Discovers all NestJS providers that have methods decorated with `@McpTool`, `@McpResource`, or `@McpPrompt` and registers them in the [McpRegistryService](Class.McpRegistryService). |
+| [McpHealthIndicator](Class.McpHealthIndicator) | Health indicator for the MCP server infrastructure. Verifies that at least one tool, resource, or prompt handler is registered. |
 | [McpModule](Class.McpModule) | NestJS dynamic module that bootstraps an MCP server. |
 | [McpRegistryService](Class.McpRegistryService) | Central registry that stores all MCP tool, resource, and prompt handlers discovered from NestJS providers. |
 | [McpServerService](Class.McpServerService) | Manages the MCP server lifecycle. Creates the `McpServer` instance, registers all discovered handlers from the registry, and provides methods to connect various transports. |

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

@@ -2,7 +2,7 @@
 title: platform-mcp
 description: Reusable NestJS module for building Model Context Protocol (MCP) servers with decorator-driven handler registration and multi-transport support.
 order: 13
-tags: [mcp, model-context-protocol, tools, resources, prompts, transports]
+tags: [mcp, model-context-protocol, tools, resources, prompts, transports, health]
 package: '@breadstone/archipel-platform-mcp'
 ---
 
@@ -300,6 +300,29 @@ graph TD
 
 ---
 
+## Health Check
+
+The `McpHealthIndicator` verifies that the `McpRegistryService` is injected. If no MCP registry is available, it reports `disabled: true`. Import it from the `/health` subpath:
+
+```typescript
+import { McpHealthIndicator } from '@breadstone/archipel-platform-mcp/health';
+import { HealthModule } from '@breadstone/archipel-platform-health';
+
+@Module({
+  imports: [
+    McpModule.register({ /* ... */ }),
+    HealthModule.withIndicators([McpHealthIndicator]),
+  ],
+})
+export class AppModule {}
+```
+
+| Key | Check | Dependencies |
+| --- | ----- | ------------ |
+| `mcp` | `up` if `McpRegistryService` injected, else `disabled` | `@Optional() McpRegistryService` |
+
+---
+
 ## Resource Limits & Shutdown
 
 | Limit                | Value      | Description                                                              |

package/data/packages/platform-openapi/api/Function.SwaggerFeature.md

@@ -6,7 +6,7 @@ editUrl: false
 # Function: SwaggerFeature()
 
 ```ts
-function SwaggerFeature(metadata): (target) => any;
+function SwaggerFeature(metadata): (target) => (...args) => object;
 ```
 
 Defined in: [decorators/SwaggerFeature.ts:92](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/decorators/SwaggerFeature.ts#L92)
@@ -22,7 +22,7 @@ This allows the SwaggerMultiDocumentService to automatically discover and create
 
 ## Returns
 
-(`target`) => `any`
+(`target`) => (...`args`) => `object`
 
 ## Example
 

package/data/packages/platform-openapi/api/Function.getSwaggerFeatureMetadata.md

@@ -11,7 +11,7 @@ function getSwaggerFeatureMetadata(target):
   | undefined;
 ```
 
-Defined in: [decorators/SwaggerFeature.ts:113](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/decorators/SwaggerFeature.ts#L113)
+Defined in: [decorators/SwaggerFeature.ts:111](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/decorators/SwaggerFeature.ts#L111)
 
 Get the Swagger feature metadata from a module class
 
@@ -19,7 +19,7 @@ Get the Swagger feature metadata from a module class
 
 | Parameter | Type |
 | ------ | ------ |
-| `target` | `any` |
+| `target` | (...`args`) => `object` |
 
 ## Returns
 

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

@@ -161,3 +161,27 @@ Normalized subscription or `null` if not found.
 #### Overrides
 
 [`PaymentClientPort`](Class.PaymentClientPort).[`fetchSubscription`](Class.PaymentClientPort#fetchsubscription)
+
+***
+
+### ping()
+
+```ts
+ping(): Promise<boolean>;
+```
+
+Defined in: [contracts/PaymentClientPort.ts:76](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/contracts/PaymentClientPort.ts#L76)
+
+Lightweight connectivity check for the payment provider.
+Override in adapters to perform a real API call (e.g. list products).
+Defaults to `true` if not overridden.
+
+#### Returns
+
+`Promise`\<`boolean`\>
+
+`true` if the provider is reachable.
+
+#### Inherited from
+
+[`PaymentClientPort`](Class.PaymentClientPort).[`ping`](Class.PaymentClientPort#ping)

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

@@ -164,3 +164,27 @@ Normalized subscription or `null` if not found.
 #### Overrides
 
 [`PaymentClientPort`](Class.PaymentClientPort).[`fetchSubscription`](Class.PaymentClientPort#fetchsubscription)
+
+***
+
+### ping()
+
+```ts
+ping(): Promise<boolean>;
+```
+
+Defined in: [contracts/PaymentClientPort.ts:76](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/contracts/PaymentClientPort.ts#L76)
+
+Lightweight connectivity check for the payment provider.
+Override in adapters to perform a real API call (e.g. list products).
+Defaults to `true` if not overridden.
+
+#### Returns
+
+`Promise`\<`boolean`\>
+
+`true` if the provider is reachable.
+
+#### Inherited from
+
+[`PaymentClientPort`](Class.PaymentClientPort).[`ping`](Class.PaymentClientPort#ping)

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

@@ -161,3 +161,27 @@ Normalized subscription or `null` if not found.
 #### Overrides
 
 [`PaymentClientPort`](Class.PaymentClientPort).[`fetchSubscription`](Class.PaymentClientPort#fetchsubscription)
+
+***
+
+### ping()
+
+```ts
+ping(): Promise<boolean>;
+```
+
+Defined in: [contracts/PaymentClientPort.ts:76](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/contracts/PaymentClientPort.ts#L76)
+
+Lightweight connectivity check for the payment provider.
+Override in adapters to perform a real API call (e.g. list products).
+Defaults to `true` if not overridden.
+
+#### Returns
+
+`Promise`\<`boolean`\>
+
+`true` if the provider is reachable.
+
+#### Inherited from
+
+[`PaymentClientPort`](Class.PaymentClientPort).[`ping`](Class.PaymentClientPort#ping)

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

@@ -140,3 +140,23 @@ Retrieve subscription details.
   \| `null`\>
 
 Normalized subscription or `null` if not found.
+
+***
+
+### ping()
+
+```ts
+ping(): Promise<boolean>;
+```
+
+Defined in: [contracts/PaymentClientPort.ts:76](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/contracts/PaymentClientPort.ts#L76)
+
+Lightweight connectivity check for the payment provider.
+Override in adapters to perform a real API call (e.g. list products).
+Defaults to `true` if not overridden.
+
+#### Returns
+
+`Promise`\<`boolean`\>
+
+`true` if the provider is reachable.

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

@@ -0,0 +1,78 @@
+---
+title: 'Class: PaymentHealthIndicator'
+generated: true
+editUrl: false
+---
+# Class: PaymentHealthIndicator
+
+Defined in: [health/PaymentHealthIndicator.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/health/PaymentHealthIndicator.ts#L17)
+
+Health indicator for the payment infrastructure.
+Calls [PaymentClientPort.ping](Class.PaymentClientPort#ping) to verify provider connectivity.
+
+## Implements
+
+- `IHealthIndicator`
+
+## Constructors
+
+### Constructor
+
+```ts
+new PaymentHealthIndicator(paymentClient?): PaymentHealthIndicator;
+```
+
+Defined in: [health/PaymentHealthIndicator.ts:27](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/health/PaymentHealthIndicator.ts#L27)
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `paymentClient?` | [`PaymentClientPort`](Class.PaymentClientPort) |
+
+#### Returns
+
+`PaymentHealthIndicator`
+
+## Properties
+
+### key
+
+```ts
+readonly key: string = 'payment';
+```
+
+Defined in: [health/PaymentHealthIndicator.ts:35](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/health/PaymentHealthIndicator.ts#L35)
+
+Unique key identifying the indicator
+
+#### Implementation of
+
+```ts
+IHealthIndicator.key
+```
+
+## Methods
+
+### check()
+
+```ts
+check(): Promise<HealthIndicatorResult<string>>;
+```
+
+Defined in: [health/PaymentHealthIndicator.ts:48](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/health/PaymentHealthIndicator.ts#L48)
+
+Pings the payment provider to verify connectivity.
+Returns disabled status when no client is configured.
+
+#### Returns
+
+`Promise`\<`HealthIndicatorResult`\<`string`\>\>
+
+The health indicator result.
+
+#### Implementation of
+
+```ts
+IHealthIndicator.check
+```

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

@@ -46,7 +46,7 @@ Defined in: [stripe/StripeClient.ts:40](https://github.com/RueDeRennes/archipel/
 constructWebhookEvent(payload, signature): INormalizedWebhookEvent;
 ```
 
-Defined in: [stripe/StripeClient.ts:153](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/stripe/StripeClient.ts#L153)
+Defined in: [stripe/StripeClient.ts:156](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/stripe/StripeClient.ts#L156)
 
 Construct and normalize a webhook event.
 
@@ -79,7 +79,7 @@ createCheckoutSession(
 userId?): Promise<INormalizedCheckoutSession>;
 ```
 
-Defined in: [stripe/StripeClient.ts:88](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/stripe/StripeClient.ts#L88)
+Defined in: [stripe/StripeClient.ts:91](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/stripe/StripeClient.ts#L91)
 
 Create a checkout session.
 
@@ -110,7 +110,7 @@ Normalized checkout session
 fetchPrices(productId): Promise<INormalizedPrice[]>;
 ```
 
-Defined in: [stripe/StripeClient.ts:59](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/stripe/StripeClient.ts#L59)
+Defined in: [stripe/StripeClient.ts:62](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/stripe/StripeClient.ts#L62)
 
 Fetch all active prices for a product.
 
@@ -140,7 +140,7 @@ fetchSubscription(subscriptionId): Promise<
 | null>;
 ```
 
-Defined in: [stripe/StripeClient.ts:128](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/stripe/StripeClient.ts#L128)
+Defined in: [stripe/StripeClient.ts:131](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/stripe/StripeClient.ts#L131)
 
 Retrieve subscription details.
 
@@ -161,3 +161,27 @@ Normalized subscription
 #### Overrides
 
 [`PaymentClientPort`](Class.PaymentClientPort).[`fetchSubscription`](Class.PaymentClientPort#fetchsubscription)
+
+***
+
+### ping()
+
+```ts
+ping(): Promise<boolean>;
+```
+
+Defined in: [contracts/PaymentClientPort.ts:76](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-payments/src/contracts/PaymentClientPort.ts#L76)
+
+Lightweight connectivity check for the payment provider.
+Override in adapters to perform a real API call (e.g. list products).
+Defaults to `true` if not overridden.
+
+#### Returns
+
+`Promise`\<`boolean`\>
+
+`true` if the provider is reachable.
+
+#### Inherited from
+
+[`PaymentClientPort`](Class.PaymentClientPort).[`ping`](Class.PaymentClientPort#ping)

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

@@ -17,6 +17,7 @@ editUrl: false
 | [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. |
+| [PaymentHealthIndicator](Class.PaymentHealthIndicator) | Health indicator for the payment infrastructure. Calls [PaymentClientPort.ping](Class.PaymentClientPort#ping) to verify provider connectivity. |
 | [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

@@ -2,7 +2,7 @@
 title: platform-payments
 description: Provider-agnostic payment infrastructure with support for Stripe, Paddle, LemonSqueezy, and Mollie.
 order: 4
-tags: [payments, stripe, paddle, lemonsqueezy, mollie, feature-gating, quotas, guards, interceptors, ports-and-adapters]
+tags: [payments, stripe, paddle, lemonsqueezy, mollie, feature-gating, quotas, guards, interceptors, ports-and-adapters, health]
 package: '@breadstone/archipel-platform-payments'
 ---
 
@@ -151,7 +151,7 @@ import { LemonSqueezyClient, LEMONSQUEEZY_CONFIG_ENTRIES } from '@breadstone/arc
 | Variable                | Description                            | Required |
 | ----------------------- | -------------------------------------- | -------- |
 | `MOLLIE_API_KEY`        | Mollie API key                         | Yes      |
-| `MOLLIE_WEBHOOK_SECRET` | Mollie webhook secret for verification | No       |
+| `MOLLIE_WEBHOOK_SECRET` | Mollie webhook secret for verification | Yes      |
 
 ```typescript
 import { MollieClient, MOLLIE_CONFIG_ENTRIES } from '@breadstone/archipel-platform-payments/mollie';
@@ -532,6 +532,29 @@ try {
 
 ---
 
+## Health Check
+
+The `PaymentHealthIndicator` verifies that a `PaymentClientPort` is injected. If no payment client is registered, it reports `disabled: true`. Import it from the `/health` subpath:
+
+```typescript
+import { PaymentHealthIndicator } from '@breadstone/archipel-platform-payments/health';
+import { HealthModule } from '@breadstone/archipel-platform-health';
+
+@Module({
+  imports: [
+    PaymentModule.register({ /* ... */ }),
+    HealthModule.withIndicators([PaymentHealthIndicator]),
+  ],
+})
+export class AppModule {}
+```
+
+| Key | Check | Dependencies |
+| --- | ----- | ------------ |
+| `payment` | `up` if `PaymentClientPort` injected, else `disabled` | `@Optional() PaymentClientPort` |
+
+---
+
 ## Exports Summary
 
 ### Core (`@breadstone/archipel-platform-payments`)
@@ -552,6 +575,7 @@ try {
 | `INormalizedWebhookEvent`    | Interface     | Normalized webhook event            |
 | `SubscriptionStatus`         | Type Alias    | Subscription status union           |
 | `PaymentError`               | Error class   | Domain error for payment failures   |
+| `PaymentHealthIndicator`     | Health        | Payment readiness check (`/health` subpath) |
 
 ### Provider subpaths