@breadstone/archipel-mcp 0.0.39 → 0.0.41

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

@@ -0,0 +1,14 @@
+---
+title: 'Variable: VERCEL\_BLOB\_READ\_WRITE\_TOKEN'
+generated: true
+editUrl: false
+---
+# Variable: VERCEL\_BLOB\_READ\_WRITE\_TOKEN
+
+```ts
+const VERCEL_BLOB_READ_WRITE_TOKEN: IConfigKey<string>;
+```
+
+Defined in: [strategies/vercel/env.ts:13](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/strategies/vercel/env.ts#L13)
+
+Vercel Blob read/write access token.

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

@@ -0,0 +1,14 @@
+---
+title: 'Variable: VERCEL\_BLOB\_REGION'
+generated: true
+editUrl: false
+---
+# Variable: VERCEL\_BLOB\_REGION
+
+```ts
+const VERCEL_BLOB_REGION: IConfigKey<string>;
+```
+
+Defined in: [strategies/vercel/env.ts:19](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/strategies/vercel/env.ts#L19)
+
+Vercel Blob region.

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

@@ -0,0 +1,14 @@
+---
+title: 'Variable: VERCEL\_BLOB\_URL'
+generated: true
+editUrl: false
+---
+# Variable: VERCEL\_BLOB\_URL
+
+```ts
+const VERCEL_BLOB_URL: IConfigKey<string>;
+```
+
+Defined in: [strategies/vercel/env.ts:10](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/strategies/vercel/env.ts#L10)
+
+Vercel Blob API URL.

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

@@ -0,0 +1,14 @@
+---
+title: 'Variable: VERCEL\_CONFIG\_ENTRIES'
+generated: true
+editUrl: false
+---
+# Variable: VERCEL\_CONFIG\_ENTRIES
+
+```ts
+const VERCEL_CONFIG_ENTRIES: ReadonlyArray<Omit<IConfigRegistryEntry, "module">>;
+```
+
+Defined in: [strategies/vercel/env.ts:25](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/strategies/vercel/env.ts#L25)
+
+Configuration entries required by the Vercel blob storage strategy.

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

@@ -9,35 +9,29 @@ editUrl: false
 
 | Class | Description |
 | ------ | ------ |
-| [AwsS3BlobProvider](Class.AwsS3BlobProvider) | Provides an implementation of [IBlobProvider](Interface.IBlobProvider) for Amazon S3. |
-| [AzureBlobProvider](Class.AzureBlobProvider) | Provides an implementation of [IBlobProvider](Interface.IBlobProvider) for Microsoft Azure Blob Storage. |
+| [AwsS3BlobStorageStrategy](Class.AwsS3BlobStorageStrategy) | Provides a blob storage strategy backed by Amazon S3. |
+| [AzureBlobStorageStrategy](Class.AzureBlobStorageStrategy) | Provides a blob storage strategy backed by Microsoft Azure Blob Storage. |
 | [BlobHealthIndicator](Class.BlobHealthIndicator) | Health indicator for blob storage service. |
-| [BlobModule](Class.BlobModule) | NestJS module responsible for providing blob storage services. |
+| [BlobModule](Class.BlobModule) | NestJS module responsible for providing blob storage services. Uses a strategy pattern to support pluggable storage backends. |
 | [BlobObjectPersistencePort](Class.BlobObjectPersistencePort) | Abstract port for persisting blob object metadata. Consuming projects must provide a concrete implementation (e.g. backed by Prisma, Mongo, etc.) and register it via `BlobModule.forRoot({ objectPersistence: MyAdapter })`. |
 | [BlobService](Class.BlobService) | Provides a generic abstraction for blob storage operations independent of the underlying provider. |
+| [BlobStorageStrategyBase](Class.BlobStorageStrategyBase) | Abstract base class for blob storage strategies. Every concrete provider (AWS S3, Azure, Vercel, Local, etc.) must extend this class. Serves as both the type contract and the NestJS DI token type reference. |
 | [BlobVariantPersistencePort](Class.BlobVariantPersistencePort) | Abstract port for persisting blob variant metadata. Consuming projects must provide a concrete implementation and register it via `BlobModule.forRoot({ variantPersistence: MyAdapter })`. |
-| [VercelBlobProvider](Class.VercelBlobProvider) | Provides an implementation of [IBlobProvider](Interface.IBlobProvider) for Vercel Blob storage. |
+| [LocalBlobStorageStrategy](Class.LocalBlobStorageStrategy) | Provides a blob storage strategy backed by the local filesystem. |
+| [VercelBlobStorageStrategy](Class.VercelBlobStorageStrategy) | Provides a blob storage strategy backed by the Vercel Blob API. |
 
 ## Interfaces
 
 | Interface | Description |
 | ------ | ------ |
-| [IAwsS3BlobProviderRegistration](Interface.IAwsS3BlobProviderRegistration) | - |
-| [IAwsS3ProviderOptions](Interface.IAwsS3ProviderOptions) | - |
-| [IAzureBlobProviderOptions](Interface.IAzureBlobProviderOptions) | - |
-| [IAzureBlobProviderRegistration](Interface.IAzureBlobProviderRegistration) | - |
 | [IBlobDeleteRequest](Interface.IBlobDeleteRequest) | - |
 | [IBlobDownloadRequest](Interface.IBlobDownloadRequest) | - |
 | [IBlobDownloadResult](Interface.IBlobDownloadResult) | - |
 | [IBlobModuleOptions](Interface.IBlobModuleOptions) | - |
 | [IBlobObjectMetadata](Interface.IBlobObjectMetadata) | - |
-| [IBlobProvider](Interface.IBlobProvider) | - |
 | [IBlobSignedUrlRequest](Interface.IBlobSignedUrlRequest) | - |
 | [IBlobUploadRequest](Interface.IBlobUploadRequest) | - |
 | [IBlobUploadResult](Interface.IBlobUploadResult) | - |
-| [ICustomBlobProviderRegistration](Interface.ICustomBlobProviderRegistration) | - |
-| [IVercelBlobProviderOptions](Interface.IVercelBlobProviderOptions) | - |
-| [IVercelBlobProviderRegistration](Interface.IVercelBlobProviderRegistration) | - |
 
 ## Type Aliases
 
@@ -45,15 +39,29 @@ editUrl: false
 | ------ | ------ |
 | [BlobDownloadResponseType](TypeAlias.BlobDownloadResponseType) | - |
 | [BlobUploadBody](TypeAlias.BlobUploadBody) | - |
-| [IBlobProviderRegistration](TypeAlias.IBlobProviderRegistration) | - |
 
 ## Variables
 
 | Variable | Description |
 | ------ | ------ |
-| [AWS\_S3\_PROVIDER\_OPTIONS](Variable.AWS_S3_PROVIDER_OPTIONS) | - |
-| [AZURE\_BLOB\_PROVIDER\_OPTIONS](Variable.AZURE_BLOB_PROVIDER_OPTIONS) | - |
-| [BLOB\_PROVIDER](Variable.BLOB_PROVIDER) | - |
+| [AWS\_S3\_ACCESS\_KEY\_ID](Variable.AWS_S3_ACCESS_KEY_ID) | AWS S3 access key ID. |
+| [AWS\_S3\_BUCKET](Variable.AWS_S3_BUCKET) | AWS S3 bucket name. |
+| [AWS\_S3\_CONFIG\_ENTRIES](Variable.AWS_S3_CONFIG_ENTRIES) | Configuration entries required by the AWS S3 blob storage strategy. |
+| [AWS\_S3\_ENDPOINT](Variable.AWS_S3_ENDPOINT) | AWS S3 custom endpoint (for S3-compatible providers). |
+| [AWS\_S3\_REGION](Variable.AWS_S3_REGION) | AWS S3 region. |
+| [AWS\_S3\_SECRET\_ACCESS\_KEY](Variable.AWS_S3_SECRET_ACCESS_KEY) | AWS S3 secret access key. |
+| [AZURE\_BLOB\_CONNECTION\_STRING](Variable.AZURE_BLOB_CONNECTION_STRING) | Azure Blob Storage connection string. |
+| [AZURE\_BLOB\_CONTAINER\_NAME](Variable.AZURE_BLOB_CONTAINER_NAME) | Azure Blob Storage container name. |
+| [AZURE\_CONFIG\_ENTRIES](Variable.AZURE_CONFIG_ENTRIES) | Configuration entries required by the Azure blob storage strategy. |
+| [BLOB\_STORAGE\_STRATEGY\_TOKEN](Variable.BLOB_STORAGE_STRATEGY_TOKEN) | - |
 | [BlobDownloadResponseTypes](Variable.BlobDownloadResponseTypes) | - |
-| [BlobProviderKinds](Variable.BlobProviderKinds) | - |
-| [VERCEL\_BLOB\_PROVIDER\_OPTIONS](Variable.VERCEL_BLOB_PROVIDER_OPTIONS) | - |
+| [LOCAL\_BLOB\_BASE\_PATH](Variable.LOCAL_BLOB_BASE_PATH) | Local blob storage base path. |
+| [LOCAL\_BLOB\_BUCKET](Variable.LOCAL_BLOB_BUCKET) | Local blob storage bucket (subdirectory). |
+| [LOCAL\_CONFIG\_ENTRIES](Variable.LOCAL_CONFIG_ENTRIES) | Configuration entries required by the local blob storage strategy. |
+| [PLATFORM\_BLOB\_STORAGE\_CONFIG\_ENTRIES](Variable.PLATFORM_BLOB_STORAGE_CONFIG_ENTRIES) | All configuration entries for `platform-blob-storage`. All keys are optional at the aggregate level. |
+| [VERCEL\_BLOB\_BUCKET](Variable.VERCEL_BLOB_BUCKET) | Vercel Blob bucket name. |
+| [VERCEL\_BLOB\_PUBLIC\_URL](Variable.VERCEL_BLOB_PUBLIC_URL) | Vercel Blob public URL. |
+| [VERCEL\_BLOB\_READ\_WRITE\_TOKEN](Variable.VERCEL_BLOB_READ_WRITE_TOKEN) | Vercel Blob read/write access token. |
+| [VERCEL\_BLOB\_REGION](Variable.VERCEL_BLOB_REGION) | Vercel Blob region. |
+| [VERCEL\_BLOB\_URL](Variable.VERCEL_BLOB_URL) | Vercel Blob API URL. |
+| [VERCEL\_CONFIG\_ENTRIES](Variable.VERCEL_CONFIG_ENTRIES) | Configuration entries required by the Vercel blob storage strategy. |

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

@@ -8,7 +8,7 @@ package: '@breadstone/archipel-platform-blob-storage'
 
 # platform-blob-storage
 
-Cloud file storage abstraction supporting pluggable providers and optional metadata persistence via ports. Ships with Vercel Blob, Azure Blob Storage, and AWS S3 providers out of the box.
+Cloud file storage abstraction supporting pluggable strategies and optional metadata persistence via ports. Ships with Vercel Blob, Azure Blob Storage, AWS S3, and local filesystem strategies out of the box.
 
 **Package:** `@breadstone/archipel-platform-blob-storage`
 
@@ -19,15 +19,20 @@ Cloud file storage abstraction supporting pluggable providers and optional metad
 ```typescript
 import { Module } from '@nestjs/common';
 import { BlobModule } from '@breadstone/archipel-platform-blob-storage';
+import { VercelBlobStorageStrategy, VERCEL_CONFIG_ENTRIES } from '@breadstone/archipel-platform-blob-storage/strategies/vercel';
 
 @Module({
   imports: [
     // Minimal setup — Vercel Blob, no metadata tracking
-    BlobModule.forRoot(),
+    BlobModule.register({
+      storageStrategy: VercelBlobStorageStrategy,
+      configEntries: VERCEL_CONFIG_ENTRIES,
+    }),
 
-    // Full setup — custom provider + metadata tracking
-    BlobModule.forRoot({
-      provider: { kind: 'vercel' },
+    // Full setup — with metadata tracking
+    BlobModule.register({
+      storageStrategy: VercelBlobStorageStrategy,
+      configEntries: VERCEL_CONFIG_ENTRIES,
       objectPersistence: PrismaBlobObjectAdapter,
       variantPersistence: PrismaBlobVariantAdapter,
       isGlobal: true,
@@ -43,27 +48,36 @@ export class AppModule {}
 
 ### IBlobModuleOptions
 
-| Property             | Type                               | Required | Default     | Description                            |
-| -------------------- | ---------------------------------- | -------- | ----------- | -------------------------------------- |
-| `provider`           | `IBlobProviderRegistration`        | No       | Vercel Blob | Storage backend to use                 |
-| `objectPersistence`  | `Type<BlobObjectPersistencePort>`  | No       | —           | Metadata tracking for uploaded objects |
-| `variantPersistence` | `Type<BlobVariantPersistencePort>` | No       | —           | Metadata tracking for image variants   |
-| `isGlobal`           | `boolean`                          | No       | `true`      | Register as a global module            |
+| Property             | Type                               | Required | Default | Description                            |
+| -------------------- | ---------------------------------- | -------- | ------- | -------------------------------------- |
+| `storageStrategy`    | `Type<BlobStorageStrategyBase>`    | Yes      | —       | Storage strategy to use                |
+| `configEntries`      | `IConfigEntry[]`                   | No       | `[]`    | Config entries for the chosen strategy |
+| `objectPersistence`  | `Type<BlobObjectPersistencePort>`  | No       | —       | Metadata tracking for uploaded objects |
+| `variantPersistence` | `Type<BlobVariantPersistencePort>` | No       | —       | Metadata tracking for image variants   |
+| `isGlobal`           | `boolean`                          | No       | `true`  | Register as a global module            |
 
-### Provider Registration
+### Strategy Registration
 
 ```typescript
-// Vercel Blob (default)
-{ kind: 'vercel', options?: { token?: string } }
+import { VercelBlobStorageStrategy, VERCEL_CONFIG_ENTRIES } from '@breadstone/archipel-platform-blob-storage/strategies/vercel';
+import { AzureBlobStorageStrategy, AZURE_CONFIG_ENTRIES } from '@breadstone/archipel-platform-blob-storage/strategies/azure';
+import { AwsS3BlobStorageStrategy, AWS_S3_CONFIG_ENTRIES } from '@breadstone/archipel-platform-blob-storage/strategies/aws-s3';
+import { LocalBlobStorageStrategy, LOCAL_CONFIG_ENTRIES } from '@breadstone/archipel-platform-blob-storage/strategies/local';
+
+// Vercel Blob
+BlobModule.register({ storageStrategy: VercelBlobStorageStrategy, configEntries: VERCEL_CONFIG_ENTRIES });
 
 // Azure Blob Storage
-{ kind: 'azure', options?: { connectionString?: string; containerName?: string } }
+BlobModule.register({ storageStrategy: AzureBlobStorageStrategy, configEntries: AZURE_CONFIG_ENTRIES });
 
 // AWS S3
-{ kind: 'aws-s3', options?: { region?: string; accessKeyId?: string; secretAccessKey?: string; bucket?: string; endpoint?: string } }
+BlobModule.register({ storageStrategy: AwsS3BlobStorageStrategy, configEntries: AWS_S3_CONFIG_ENTRIES });
 
-// Custom provider
-{ kind: 'custom', useClass: MyBlobProvider }
+// Local filesystem
+BlobModule.register({ storageStrategy: LocalBlobStorageStrategy, configEntries: LOCAL_CONFIG_ENTRIES });
+
+// Custom strategy — extend BlobStorageStrategyBase
+BlobModule.register({ storageStrategy: MyCustomStrategy });
 ```
 
 ---
@@ -204,32 +218,33 @@ export class PrismaBlobObjectAdapter extends BlobObjectPersistencePort {
 
 ---
 
-## Built-in Providers
+## Built-in Strategies
 
-### VercelBlobProvider
+### VercelBlobStorageStrategy
 
-The default blob provider using Vercel's Blob Storage API.
+The Vercel Blob storage strategy using Vercel's Blob Storage API.
 
 ```typescript
-BlobModule.forRoot({
-  provider: {
-    kind: 'vercel',
-    options: { token: process.env.BLOB_READ_WRITE_TOKEN },
-  },
+import { VercelBlobStorageStrategy, VERCEL_CONFIG_ENTRIES } from '@breadstone/archipel-platform-blob-storage/strategies/vercel';
+
+BlobModule.register({
+  storageStrategy: VercelBlobStorageStrategy,
+  configEntries: VERCEL_CONFIG_ENTRIES,
 });
 ```
 
-**Environment variables:** `BLOB_READ_WRITE_TOKEN`, `BLOB_API_URL`, `BLOB_PUBLIC_URL`
+**Environment variables:** `VERCEL_BLOB_READ_WRITE_TOKEN`, `VERCEL_BLOB_URL`, `VERCEL_BLOB_PUBLIC_URL`, `VERCEL_BLOB_BUCKET`, `VERCEL_BLOB_REGION`
 
-### AzureBlobProvider
+### AzureBlobStorageStrategy
 
 Microsoft Azure Blob Storage integration using `@azure/storage-blob`.
 
 ```typescript
-import { AzureBlobProvider } from '@breadstone/archipel-platform-blob-storage/azure';
+import { AzureBlobStorageStrategy, AZURE_CONFIG_ENTRIES } from '@breadstone/archipel-platform-blob-storage/strategies/azure';
 
-BlobModule.forRoot({
-  provider: { kind: 'azure' },
+BlobModule.register({
+  storageStrategy: AzureBlobStorageStrategy,
+  configEntries: AZURE_CONFIG_ENTRIES,
 });
 ```
 
@@ -241,19 +256,20 @@ BlobModule.forRoot({
 | `AZURE_BLOB_ACCOUNT_NAME`      | No*      | Storage account name for DefaultAzureCredential  |
 | `AZURE_BLOB_CONTAINER_NAME`    | Yes      | Container to operate on                          |
 
-> **\*** Provide either `connectionString` or `accountName`. When `accountName` is set without a connection string, the provider authenticates via `DefaultAzureCredential` from `@azure/identity` (supports managed identity, environment credentials, etc.). Install `@azure/identity` as a peer dependency when using this mode.
+> **\*** Provide either `connectionString` or `accountName`. When `accountName` is set without a connection string, the strategy authenticates via `DefaultAzureCredential` from `@azure/identity` (supports managed identity, environment credentials, etc.). Install `@azure/identity` as a peer dependency when using this mode.
 
-The provider supports SAS token generation for signed URLs and lazy-loads the Azure SDK for tree-shaking.
+The strategy supports SAS token generation for signed URLs and lazy-loads the Azure SDK for tree-shaking.
 
-### AwsS3BlobProvider
+### AwsS3BlobStorageStrategy
 
 Amazon S3 integration using `@aws-sdk/client-s3` and `@aws-sdk/s3-request-presigner`.
 
 ```typescript
-import { AwsS3BlobProvider } from '@breadstone/archipel-platform-blob-storage/aws-s3';
+import { AwsS3BlobStorageStrategy, AWS_S3_CONFIG_ENTRIES } from '@breadstone/archipel-platform-blob-storage/strategies/aws-s3';
 
-BlobModule.forRoot({
-  provider: { kind: 'aws-s3' },
+BlobModule.register({
+  storageStrategy: AwsS3BlobStorageStrategy,
+  configEntries: AWS_S3_CONFIG_ENTRIES,
 });
 ```
 
@@ -269,16 +285,37 @@ BlobModule.forRoot({
 
 > **\*** `accessKeyId` and `secretAccessKey` must be provided **together**. Omit both to use the default AWS credential chain (IAM roles, instance profiles, environment variables).
 
-The provider supports pre-signed URLs and lazy-loads the AWS SDK for tree-shaking. `downloadObject()` gracefully handles JSON parse errors, returning the raw response body when content cannot be parsed.
+The strategy supports pre-signed URLs and lazy-loads the AWS SDK for tree-shaking. `downloadObject()` gracefully handles JSON parse errors, returning the raw response body when content cannot be parsed.
 
-### Custom Provider
+### LocalBlobStorageStrategy
 
-Implement `IBlobProvider` for any other storage backend (GCS, MinIO, etc.):
+Local filesystem storage for development and testing.
+
+```typescript
+import { LocalBlobStorageStrategy, LOCAL_CONFIG_ENTRIES } from '@breadstone/archipel-platform-blob-storage/strategies/local';
+
+BlobModule.register({
+  storageStrategy: LocalBlobStorageStrategy,
+  configEntries: LOCAL_CONFIG_ENTRIES,
+});
+```
+
+**Environment variables:**
+
+| Variable               | Required | Default       | Description                           |
+| ---------------------- | -------- | ------------- | ------------------------------------- |
+| `LOCAL_BLOB_BASE_PATH` | No       | `./blob-data` | Base directory for local file storage |
+| `LOCAL_BLOB_BUCKET`    | No       | `default`     | Default bucket subdirectory           |
+
+### Custom Strategy
+
+Extend `BlobStorageStrategyBase` for any other storage backend (GCS, MinIO, etc.):
 
 ```typescript
 @Injectable()
-export class GcsBlobProvider implements IBlobProvider {
-  public readonly providerId = 'gcs';
+export class GcsBlobStorageStrategy extends BlobStorageStrategyBase {
+  public override readonly providerId = 'gcs';
+  public override readonly defaultBucket = 'my-gcs-bucket';
 
   public async uploadObject(request: IBlobUploadRequest): Promise<IBlobUploadResult> {
     // GCS upload implementation
@@ -292,15 +329,13 @@ export class GcsBlobProvider implements IBlobProvider {
     // GCS delete implementation
   }
 
-  public async createSignedUrl(request: IBlobSignedUrlRequest): Promise<string> {
+  public override async createSignedUrl(request: IBlobSignedUrlRequest): Promise<string> {
     // GCS signed URL
   }
 }
 
 // Register
-BlobModule.forRoot({
-  provider: { kind: 'custom', useClass: GcsBlobProvider },
-});
+BlobModule.register({ storageStrategy: GcsBlobStorageStrategy });
 ```
 
 ---
@@ -315,7 +350,7 @@ import { HealthModule } from '@breadstone/archipel-platform-health';
 
 @Module({
   imports: [
-    BlobModule.forRoot({ /* ... */ }),
+    BlobModule.register({ /* ... */ }),
     HealthModule.withIndicators([BlobHealthIndicator]),
   ],
 })
@@ -331,30 +366,31 @@ export class AppModule {}
 
 ## Sub-path Imports
 
-Each provider is tree-shakeable via sub-path imports:
+Each strategy is tree-shakeable via sub-path imports:
 
-| Import Path                                         | Contents                                              |
-| --------------------------------------------------- | ----------------------------------------------------- |
-| `@breadstone/archipel-platform-blob-storage`        | Core module, service, ports, interfaces               |
-| `@breadstone/archipel-platform-blob-storage/vercel` | VercelBlobProvider, VERCEL_BLOB_PROVIDER_OPTIONS      |
-| `@breadstone/archipel-platform-blob-storage/azure`  | AzureBlobProvider, AZURE_BLOB_PROVIDER_OPTIONS        |
-| `@breadstone/archipel-platform-blob-storage/aws-s3` | AwsS3BlobProvider, AWS_S3_PROVIDER_OPTIONS            |
-| `@breadstone/archipel-platform-blob-storage/health`  | BlobHealthIndicator                                   |
+| Import Path                                                    | Contents                                                   |
+| -------------------------------------------------------------- | ---------------------------------------------------------- |
+| `@breadstone/archipel-platform-blob-storage`                   | Core module, service, ports, interfaces, abstract base     |
+| `@breadstone/archipel-platform-blob-storage/strategies/vercel` | VercelBlobStorageStrategy, VERCEL_CONFIG_ENTRIES            |
+| `@breadstone/archipel-platform-blob-storage/strategies/azure`  | AzureBlobStorageStrategy, AZURE_CONFIG_ENTRIES              |
+| `@breadstone/archipel-platform-blob-storage/strategies/aws-s3` | AwsS3BlobStorageStrategy, AWS_S3_CONFIG_ENTRIES             |
+| `@breadstone/archipel-platform-blob-storage/strategies/local`  | LocalBlobStorageStrategy, LOCAL_CONFIG_ENTRIES              |
+| `@breadstone/archipel-platform-blob-storage/health`            | BlobHealthIndicator                                        |
 
 ---
 
 ## Exports Summary
 
-| Export                       | Type          | Description                                           |
-| ---------------------------- | ------------- | ----------------------------------------------------- |
-| `BlobModule`                 | NestJS Module | Main module with `forRoot()`                          |
-| `BlobService`                | Service       | Upload, download, delete, signed URLs                 |
-| `BlobObjectPersistencePort`  | Port          | Object metadata tracking                              |
-| `BlobVariantPersistencePort` | Port          | Variant metadata tracking                             |
-| `VercelBlobProvider`         | Provider      | Vercel Blob implementation (sub-path)                 |
-| `AzureBlobProvider`          | Provider      | Azure Blob Storage implementation (sub-path)          |
-| `AwsS3BlobProvider`          | Provider      | AWS S3 implementation (sub-path)                      |
-| `BlobHealthIndicator`        | Health        | Blob storage health check (`/health` subpath)         |
-| `IBlobProvider`              | Interface     | Custom provider contract                              |
-| `BlobProviderKinds`          | Constant      | `'vercel'` \| `'azure'` \| `'aws-s3'` \| `'custom'`   |
-| `BlobDownloadResponseTypes`  | Constant      | `'arraybuffer'` \| `'json'` \| `'stream'` \| `'text'` |
+| Export                        | Type          | Description                                            |
+| ----------------------------- | ------------- | ------------------------------------------------------ |
+| `BlobModule`                  | NestJS Module | Main module with `register()`                          |
+| `BlobService`                 | Service       | Upload, download, delete, signed URLs                  |
+| `BlobStorageStrategyBase`     | Abstract      | Base class for custom storage strategies               |
+| `BlobObjectPersistencePort`   | Port          | Object metadata tracking                               |
+| `BlobVariantPersistencePort`  | Port          | Variant metadata tracking                              |
+| `VercelBlobStorageStrategy`   | Strategy      | Vercel Blob implementation (sub-path)                  |
+| `AzureBlobStorageStrategy`    | Strategy      | Azure Blob Storage implementation (sub-path)           |
+| `AwsS3BlobStorageStrategy`    | Strategy      | AWS S3 implementation (sub-path)                       |
+| `LocalBlobStorageStrategy`    | Strategy      | Local filesystem implementation (sub-path)             |
+| `BlobHealthIndicator`         | Health        | Blob storage health check (`/health` subpath)          |
+| `BlobDownloadResponseTypes`   | Constant      | `'arraybuffer'` \| `'json'` \| `'stream'` \| `'text'` |

package/data/packages/platform-core/api/Class.ProblemDetailResponse.md

@@ -0,0 +1,115 @@
+---
+title: 'Class: ProblemDetailResponse'
+generated: true
+editUrl: false
+---
+# Class: ProblemDetailResponse
+
+Defined in: models/response/ProblemDetailResponse.ts:29
+
+OpenAPI schema class representing a Problem Detail response as per RFC 9457.
+
+This class is used exclusively for Swagger / OpenAPI documentation. It is
+**not** instantiated at runtime — the actual response body is produced by
+[ProblemDetailExceptionFilter](Class.ProblemDetailExceptionFilter).
+
+The static [MEDIA\_TYPE](#media_type) property signals to the `@Api` decorator
+that this response schema must be served under `application/problem+json`
+instead of the default `application/json`.
+
+Usage in controllers:
+```typescript
+@Api({
+    responses: [
+        { status: HttpStatus.NOT_FOUND, description: 'User not found.', type: ProblemDetailResponse },
+    ]
+})
+```
+
+## Constructors
+
+### Constructor
+
+```ts
+new ProblemDetailResponse(): ProblemDetailResponse;
+```
+
+#### Returns
+
+`ProblemDetailResponse`
+
+## Properties
+
+### code?
+
+```ts
+optional code?: string;
+```
+
+Defined in: models/response/ProblemDetailResponse.ts:81
+
+***
+
+### detail
+
+```ts
+detail: string;
+```
+
+Defined in: models/response/ProblemDetailResponse.ts:69
+
+***
+
+### instance?
+
+```ts
+optional instance?: string;
+```
+
+Defined in: models/response/ProblemDetailResponse.ts:75
+
+***
+
+### MEDIA\_TYPE
+
+```ts
+readonly static MEDIA_TYPE: "application/problem+json" = 'application/problem+json';
+```
+
+Defined in: models/response/ProblemDetailResponse.ts:41
+
+The media type for Problem Detail responses as per RFC 9457.
+
+This static property is consumed by the `@Api` decorator to override the
+default `application/json` content type when this class is used as a
+response `type`.
+
+***
+
+### status
+
+```ts
+status: number;
+```
+
+Defined in: models/response/ProblemDetailResponse.ts:63
+
+***
+
+### title
+
+```ts
+title: string;
+```
+
+Defined in: models/response/ProblemDetailResponse.ts:57
+
+***
+
+### type
+
+```ts
+type: string;
+```
+
+Defined in: models/response/ProblemDetailResponse.ts:51

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

@@ -41,6 +41,7 @@ editUrl: false
 | [PageableResponse](Class.PageableResponse) | Base class describing pagination metadata returned alongside list payloads. |
 | [ProblemDetailException](Class.ProblemDetailException) | A NestJS HttpException that represents a Problem Detail as per RFC 7807. |
 | [ProblemDetailExceptionFilter](Class.ProblemDetailExceptionFilter) | A NestJS exception filter that transforms exceptions into Problem Details compliant responses as per RFC 7807. |
+| [ProblemDetailResponse](Class.ProblemDetailResponse) | OpenAPI schema class representing a Problem Detail response as per RFC 9457. |
 | [QuantityResponse](Class.QuantityResponse) | Base class for quantity responses. |
 | [ResponseReturn](Class.ResponseReturn) | - |
 | [SseHub](Class.SseHub) | Represents a server-sent event service. |

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

@@ -9,7 +9,7 @@ editUrl: false
 function Api(options): ClassDecorator & MethodDecorator & PropertyDecorator;
 ```
 
-Defined in: [decorators/Api.ts:141](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/decorators/Api.ts#L141)
+Defined in: [decorators/Api.ts:142](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/decorators/Api.ts#L142)
 
 Composite Swagger decorator that wraps all NestJS OpenAPI decorators into a single declaration.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@breadstone/archipel-mcp",
-  "version": "0.0.39",
+  "version": "0.0.41",
   "description": "MCP server providing Archipel platform knowledge - documentation, query patterns, and coding conventions - to AI development tools.",
   "type": "commonjs",
   "main": "./src/main.js",