@breadstone/archipel-mcp 0.0.46 → 0.0.47

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

@@ -9,6 +9,6 @@ editUrl: false
 const AWS_S3_REGION: IConfigKey<string>;
 ```
 
-Defined in: [strategies/aws-s3/env.ts:10](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/strategies/aws-s3/env.ts#L10)
+Defined in: [strategies/aws-s3/env.ts:12](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/strategies/aws-s3/env.ts#L12)
 
 AWS S3 region.

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

@@ -9,6 +9,6 @@ editUrl: false
 const AWS_S3_SECRET_ACCESS_KEY: IConfigKey<string>;
 ```
 
-Defined in: [strategies/aws-s3/env.ts:19](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/strategies/aws-s3/env.ts#L19)
+Defined in: [strategies/aws-s3/env.ts:33](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/strategies/aws-s3/env.ts#L33)
 
 AWS S3 secret access key.

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

@@ -9,6 +9,6 @@ editUrl: false
 const LOCAL_BLOB_BASE_PATH: IConfigKey<string>;
 ```
 
-Defined in: [strategies/local/env.ts:10](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/strategies/local/env.ts#L10)
+Defined in: [strategies/local/env.ts:12](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/strategies/local/env.ts#L12)
 
 Local blob storage base path.

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

@@ -9,6 +9,6 @@ editUrl: false
 const LOCAL_BLOB_BUCKET: IConfigKey<string>;
 ```
 
-Defined in: [strategies/local/env.ts:13](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/strategies/local/env.ts#L13)
+Defined in: [strategies/local/env.ts:19](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/strategies/local/env.ts#L19)
 
 Local blob storage bucket (subdirectory).

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

@@ -9,6 +9,6 @@ editUrl: false
 const LOCAL_CONFIG_ENTRIES: ReadonlyArray<Omit<IConfigRegistryEntry, "module">>;
 ```
 
-Defined in: [strategies/local/env.ts:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/strategies/local/env.ts#L16)
+Defined in: [strategies/local/env.ts:26](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/strategies/local/env.ts#L26)
 
 Configuration entries required by the local blob storage strategy.

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

@@ -9,6 +9,6 @@ editUrl: false
 const PLATFORM_BLOB_STORAGE_CONFIG_ENTRIES: ReadonlyArray<Omit<IConfigRegistryEntry, "module">>;
 ```
 
-Defined in: [env.ts:26](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/env.ts#L26)
+Defined in: [env.ts:21](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/env.ts#L21)
 
 All configuration entries for `platform-blob-storage`. All keys are optional at the aggregate level.

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

@@ -17,6 +17,7 @@ editUrl: false
 | [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 })`. |
+| [EmptyBlobStorageStrategy](Class.EmptyBlobStorageStrategy) | Provides a blob storage strategy backed by the local filesystem. |
 | [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. |
 

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 strategies and optional metadata persistence via ports. Ships with Vercel Blob, Azure Blob Storage, AWS S3, and local filesystem strategies 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, local filesystem, and an empty/mock strategy out of the box.
 
 **Package:** `@breadstone/archipel-platform-blob-storage`
 
@@ -63,6 +63,7 @@ import { VercelBlobStorageStrategy, VERCEL_CONFIG_ENTRIES } from '@breadstone/ar
 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';
+import { EmptyBlobStorageStrategy } from '@breadstone/archipel-platform-blob-storage/strategies/empty';
 
 // Vercel Blob
 BlobModule.register({ storageStrategy: VercelBlobStorageStrategy, configEntries: VERCEL_CONFIG_ENTRIES });
@@ -76,6 +77,9 @@ BlobModule.register({ storageStrategy: AwsS3BlobStorageStrategy, configEntries:
 // Local filesystem
 BlobModule.register({ storageStrategy: LocalBlobStorageStrategy, configEntries: LOCAL_CONFIG_ENTRIES });
 
+// Empty/mock strategy (for development and testing — logs operations, returns mock data)
+BlobModule.register({ storageStrategy: EmptyBlobStorageStrategy });
+
 // Custom strategy — extend BlobStorageStrategyBase
 BlobModule.register({ storageStrategy: MyCustomStrategy });
 ```
@@ -307,6 +311,20 @@ BlobModule.register({
 | `LOCAL_BLOB_BASE_PATH` | No       | `./blob-data` | Base directory for local file storage |
 | `LOCAL_BLOB_BUCKET`    | No       | `default`     | Default bucket subdirectory           |
 
+### EmptyBlobStorageStrategy
+
+A no-op storage strategy for development and testing. Logs all operations to the NestJS logger and returns mock results. No actual storage occurs.
+
+```typescript
+import { EmptyBlobStorageStrategy } from '@breadstone/archipel-platform-blob-storage/strategies/empty';
+
+BlobModule.register({
+  storageStrategy: EmptyBlobStorageStrategy,
+});
+```
+
+No environment variables required.
+
 ### Custom Strategy
 
 Extend `BlobStorageStrategyBase` for any other storage backend (GCS, MinIO, etc.):
@@ -375,6 +393,7 @@ Each strategy is tree-shakeable via sub-path imports:
 | `@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/strategies/empty`  | EmptyBlobStorageStrategy (mock/logging)                     |
 | `@breadstone/archipel-platform-blob-storage/health`            | BlobHealthIndicator                                        |
 
 ---
@@ -392,5 +411,6 @@ Each strategy is tree-shakeable via sub-path imports:
 | `AzureBlobStorageStrategy`    | Strategy      | Azure Blob Storage implementation (sub-path)           |
 | `AwsS3BlobStorageStrategy`    | Strategy      | AWS S3 implementation (sub-path)                       |
 | `LocalBlobStorageStrategy`    | Strategy      | Local filesystem implementation (sub-path)             |
+| `EmptyBlobStorageStrategy`    | Strategy      | Mock/logging implementation (sub-path)                 |
 | `BlobHealthIndicator`         | Health        | Blob storage health check (`/health` subpath)          |
 | `BlobDownloadResponseTypes`   | Constant      | `'arraybuffer'` \| `'json'` \| `'stream'` \| `'text'` |

package/data/packages/platform-bootstrap/api/Class.CompositionContext.md

@@ -0,0 +1,226 @@
+---
+title: 'Class: CompositionContext'
+generated: true
+editUrl: false
+---
+# Class: CompositionContext
+
+Defined in: composition/context/CompositionContext.ts:17
+
+Default implementation of the composition context.
+
+Wraps a temporary NestJS application context and provides convenient
+access to configuration values during module composition.
+
+## Implements
+
+- [`ICompositionContext`](Interface.ICompositionContext)
+
+## Constructors
+
+### Constructor
+
+```ts
+new CompositionContext(context, config): CompositionContext;
+```
+
+Defined in: composition/context/CompositionContext.ts:35
+
+Constructs a new composition context.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `context` | `INestApplicationContext` | The temporary NestJS application context. |
+| `config` | `ConfigService` | The configuration service instance. |
+
+#### Returns
+
+`CompositionContext`
+
+## Accessors
+
+### config
+
+#### Get Signature
+
+```ts
+get config(): ConfigService;
+```
+
+Defined in: composition/context/CompositionContext.ts:54
+
+The Archipel configuration service.
+
+Provides typed access to environment configuration values.
+
+##### Returns
+
+`ConfigService`
+
+The Archipel configuration service.
+
+Provides typed access to environment configuration values.
+
+#### Implementation of
+
+[`ICompositionContext`](Interface.ICompositionContext).[`config`](Interface.ICompositionContext#config)
+
+***
+
+### context
+
+#### Get Signature
+
+```ts
+get context(): INestApplicationContext;
+```
+
+Defined in: composition/context/CompositionContext.ts:47
+
+The temporary NestJS application context.
+
+Used only for dependency injection resolution during composition.
+Do not use this context for runtime services.
+
+##### Returns
+
+`INestApplicationContext`
+
+The temporary NestJS application context.
+
+Used only for dependency injection resolution during composition.
+Do not use this context for runtime services.
+
+#### Implementation of
+
+[`ICompositionContext`](Interface.ICompositionContext).[`context`](Interface.ICompositionContext#context)
+
+## Methods
+
+### close()
+
+```ts
+close(): Promise<void>;
+```
+
+Defined in: composition/context/CompositionContext.ts:86
+
+Closes the temporary composition context.
+
+Must be called after the real application has been created to release
+resources held by the composition context.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+A promise that resolves when the context is closed.
+
+#### Implementation of
+
+[`ICompositionContext`](Interface.ICompositionContext).[`close`](Interface.ICompositionContext#close)
+
+***
+
+### getConfigValue()
+
+```ts
+getConfigValue<T>(key): T;
+```
+
+Defined in: composition/context/CompositionContext.ts:65
+
+Reads a required configuration value.
+
+#### Type Parameters
+
+| Type Parameter | Description |
+| ------ | ------ |
+| `T` | The expected type of the configuration value. |
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `key` | `IConfigKey`\<`T`\> | The typed configuration key. |
+
+#### Returns
+
+`T`
+
+The typed configuration value.
+
+#### Implementation of
+
+[`ICompositionContext`](Interface.ICompositionContext).[`getConfigValue`](Interface.ICompositionContext#getconfigvalue)
+
+***
+
+### getService()
+
+```ts
+getService<T>(token): T;
+```
+
+Defined in: composition/context/CompositionContext.ts:79
+
+Resolves a provider from the composition context.
+
+#### Type Parameters
+
+| Type Parameter | Description |
+| ------ | ------ |
+| `T` | The type of the provider. |
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `token` | (...`args`) => `T` | The provider token (class, string, or symbol). |
+
+#### Returns
+
+`T`
+
+The resolved provider instance.
+
+#### Implementation of
+
+[`ICompositionContext`](Interface.ICompositionContext).[`getService`](Interface.ICompositionContext#getservice)
+
+***
+
+### tryGetConfigValue()
+
+```ts
+tryGetConfigValue<T>(key, fallback): T;
+```
+
+Defined in: composition/context/CompositionContext.ts:72
+
+Reads an optional configuration value with a fallback.
+
+#### Type Parameters
+
+| Type Parameter | Description |
+| ------ | ------ |
+| `T` | The expected type of the configuration value. |
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `key` | `IConfigKey`\<`T`\> | The typed configuration key. |
+| `fallback` | `T` | The fallback value when the key is absent. |
+
+#### Returns
+
+`T`
+
+The typed configuration value or the fallback.
+
+#### Implementation of
+
+[`ICompositionContext`](Interface.ICompositionContext).[`tryGetConfigValue`](Interface.ICompositionContext#trygetconfigvalue)

package/data/packages/platform-bootstrap/api/Class.CompositionModule.md

@@ -0,0 +1,56 @@
+---
+title: 'Class: CompositionModule'
+generated: true
+editUrl: false
+---
+# Class: CompositionModule
+
+Defined in: composition/module/CompositionModule.ts:53
+
+Minimal module providing configuration access for composition.
+
+This module is used by [createCompositionContext](Function.createCompositionContext) to create a
+lightweight NestJS application context for module composition decisions.
+
+## Remarks
+
+The composition module intentionally does **not** import heavy infrastructure
+such as database, queues, cron, or external API clients. It only provides
+configuration access.
+
+To add custom composition services (e.g., a custom [CompositionResolver](Class.CompositionResolver)),
+create a custom module extending this pattern and pass it to
+[createCompositionContext](Function.createCompositionContext).
+
+## Example
+
+```typescript
+// Custom composition module with application-specific resolver
+@Module({
+    imports: [
+        ConfigModule.forRoot({
+            strategyFactory: () => new EnvironmentConfigStrategy()
+        })
+    ],
+    providers: [AppCompositionResolver],
+    exports: [ConfigModule, AppCompositionResolver]
+})
+export class AppCompositionModule {}
+
+// Usage
+const context = await createCompositionContext({
+    module: AppCompositionModule
+});
+```
+
+## Constructors
+
+### Constructor
+
+```ts
+new CompositionModule(): CompositionModule;
+```
+
+#### Returns
+
+`CompositionModule`

package/data/packages/platform-bootstrap/api/Class.CompositionResolver.md

@@ -0,0 +1,206 @@
+---
+title: 'Abstract Class: CompositionResolver'
+generated: true
+editUrl: false
+---
+# Abstract Class: CompositionResolver
+
+Defined in: composition/services/CompositionResolver.ts:46
+
+Abstract base class for composition-time feature resolution.
+
+Applications extend this class to define their own composition logic,
+determining which modules and providers should be imported based on
+configuration, stage, or other criteria.
+
+## Remarks
+
+The resolver is instantiated within a lightweight composition context
+before the main application module graph is built. It should only
+depend on configuration and other composition-safe services.
+
+Do not inject heavy infrastructure services (database, queues, etc.)
+into the resolver as they are not available during composition.
+
+## Example
+
+```typescript
+@Injectable()
+export class AppCompositionResolver extends CompositionResolver {
+    public constructor(configService: ConfigService) {
+        super(configService);
+    }
+
+    public shouldImportSmtpMail(): boolean {
+        const driver = this.tryGetConfigValue(MAIL_DRIVER, 'log');
+        return driver === 'smtp' || this.isProductionLike();
+    }
+
+    public isProductionLike(): boolean {
+        const stage = this.tryGetConfigValue(NODE_ENV, 'development');
+        return stage === 'production' || stage === 'staging';
+    }
+}
+```
+
+## Constructors
+
+### Constructor
+
+```ts
+protected new CompositionResolver(configService): CompositionResolver;
+```
+
+Defined in: composition/services/CompositionResolver.ts:62
+
+Constructs a new composition resolver.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `configService` | `ConfigService` | The configuration service for reading environment values. |
+
+#### Returns
+
+`CompositionResolver`
+
+## Accessors
+
+### configService
+
+#### Get Signature
+
+```ts
+get protected configService(): ConfigService;
+```
+
+Defined in: composition/services/CompositionResolver.ts:75
+
+The underlying configuration service.
+
+##### Returns
+
+`ConfigService`
+
+## Methods
+
+### compareConfigValue()
+
+```ts
+protected compareConfigValue<T>(key, value): boolean;
+```
+
+Defined in: composition/services/CompositionResolver.ts:133
+
+Compares a configuration value against an expected value.
+
+#### Type Parameters
+
+| Type Parameter | Description |
+| ------ | ------ |
+| `T` | The expected type of the configuration value. |
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `key` | `IConfigKey`\<`T`\> | The typed configuration key. |
+| `value` | `T` | The value to compare against. |
+
+#### Returns
+
+`boolean`
+
+`true` if the configuration value matches; otherwise, `false`.
+
+***
+
+### getConfigValue()
+
+```ts
+protected getConfigValue<T>(key): T;
+```
+
+Defined in: composition/services/CompositionResolver.ts:105
+
+Gets a required configuration value.
+
+#### Type Parameters
+
+| Type Parameter | Description |
+| ------ | ------ |
+| `T` | The expected type of the configuration value. |
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `key` | `IConfigKey`\<`T`\> | The typed configuration key. |
+
+#### Returns
+
+`T`
+
+The typed configuration value.
+
+#### Throws
+
+When the configuration key is not found.
+
+***
+
+### shouldImportProvider()
+
+```ts
+abstract shouldImportProvider(providerKey): boolean;
+```
+
+Defined in: composition/services/CompositionResolver.ts:93
+
+Determines whether a specific provider should be imported.
+
+Override this method to implement custom provider resolution logic.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `providerKey` | `string` | A unique key identifying the provider (e.g., `'mail'`, `'blob-storage'`). |
+
+#### Returns
+
+`boolean`
+
+`true` if the provider should be imported; otherwise, `false`.
+
+***
+
+### tryGetConfigValue()
+
+```ts
+protected tryGetConfigValue<T>(key, fallback): T;
+```
+
+Defined in: composition/services/CompositionResolver.ts:119
+
+Gets an optional configuration value with a fallback.
+
+#### Type Parameters
+
+| Type Parameter | Description |
+| ------ | ------ |
+| `T` | The expected type of the configuration value. |
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `key` | `IConfigKey`\<`T`\> | The typed configuration key. |
+| `fallback` | `T` | The fallback value when the key is absent. |
+
+#### Returns
+
+`T`
+
+The typed configuration value or the fallback.