@breadstone/archipel-mcp 0.0.7 → 0.0.9

package/data/packages/platform-authentication/api/Variable.AUTH_MFA_PUSH_CODE_TTL.md

@@ -10,6 +10,6 @@ editUrl: false
 const AUTH_MFA_PUSH_CODE_TTL: IConfigKey<string>;
 ```
 
-Defined in: [libs/platform-authentication/src/env.ts:58](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/env.ts#L58)
+Defined in: [libs/platform-authentication/src/env.ts:61](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/env.ts#L61)
 
 Time-to-live for push OTP codes (e.g. `'10m'`).

package/data/packages/platform-authentication/api/Variable.AUTH_MFA_PUSH_MIN_RESEND.md

@@ -10,6 +10,6 @@ editUrl: false
 const AUTH_MFA_PUSH_MIN_RESEND: IConfigKey<string>;
 ```
 
-Defined in: [libs/platform-authentication/src/env.ts:61](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/env.ts#L61)
+Defined in: [libs/platform-authentication/src/env.ts:64](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/env.ts#L64)
 
 Minimum interval between push OTP resend requests (e.g. `'30s'`).

package/data/packages/platform-authentication/api/Variable.AUTH_MFA_SMS_CODE_TTL.md

@@ -10,6 +10,6 @@ editUrl: false
 const AUTH_MFA_SMS_CODE_TTL: IConfigKey<string>;
 ```
 
-Defined in: [libs/platform-authentication/src/env.ts:38](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/env.ts#L38)
+Defined in: [libs/platform-authentication/src/env.ts:41](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/env.ts#L41)
 
 Time-to-live for SMS OTP codes (e.g. `'10m'`).

package/data/packages/platform-authentication/api/Variable.AUTH_MFA_SMS_MIN_RESEND.md

@@ -10,6 +10,6 @@ editUrl: false
 const AUTH_MFA_SMS_MIN_RESEND: IConfigKey<string>;
 ```
 
-Defined in: [libs/platform-authentication/src/env.ts:41](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/env.ts#L41)
+Defined in: [libs/platform-authentication/src/env.ts:44](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/env.ts#L44)
 
 Minimum interval between SMS resend requests (e.g. `'30s'`).

package/data/packages/platform-authentication/api/Variable.AUTH_MICROSOFT_CALLBACK_URL.md

@@ -10,6 +10,6 @@ editUrl: false
 const AUTH_MICROSOFT_CALLBACK_URL: IConfigKey<string>;
 ```
 
-Defined in: [libs/platform-authentication/src/env.ts:90](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/env.ts#L90)
+Defined in: [libs/platform-authentication/src/env.ts:93](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/env.ts#L93)
 
 Microsoft OAuth2 callback URL.

package/data/packages/platform-authentication/api/Variable.AUTH_MICROSOFT_CLIENT_ID.md

@@ -10,6 +10,6 @@ editUrl: false
 const AUTH_MICROSOFT_CLIENT_ID: IConfigKey<string>;
 ```
 
-Defined in: [libs/platform-authentication/src/env.ts:84](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/env.ts#L84)
+Defined in: [libs/platform-authentication/src/env.ts:87](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/env.ts#L87)
 
 Microsoft OAuth2 client ID.

package/data/packages/platform-authentication/api/Variable.AUTH_MICROSOFT_CLIENT_SECRET.md

@@ -10,6 +10,6 @@ editUrl: false
 const AUTH_MICROSOFT_CLIENT_SECRET: IConfigKey<string>;
 ```
 
-Defined in: [libs/platform-authentication/src/env.ts:87](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/env.ts#L87)
+Defined in: [libs/platform-authentication/src/env.ts:90](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/env.ts#L90)
 
 Microsoft OAuth2 client secret.

package/data/packages/platform-authentication/api/Variable.AUTH_MICROSOFT_SCOPE.md

@@ -10,6 +10,6 @@ editUrl: false
 const AUTH_MICROSOFT_SCOPE: IConfigKey<string>;
 ```
 
-Defined in: [libs/platform-authentication/src/env.ts:96](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/env.ts#L96)
+Defined in: [libs/platform-authentication/src/env.ts:99](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/env.ts#L99)
 
 Comma-separated list of Microsoft OAuth scopes (e.g. `'user.read,mail.read'`).

package/data/packages/platform-authentication/api/Variable.AUTH_MICROSOFT_TENANT.md

@@ -10,6 +10,6 @@ editUrl: false
 const AUTH_MICROSOFT_TENANT: IConfigKey<string>;
 ```
 
-Defined in: [libs/platform-authentication/src/env.ts:93](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/env.ts#L93)
+Defined in: [libs/platform-authentication/src/env.ts:96](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/env.ts#L96)
 
 Microsoft tenant ID or `'common'` for multi-tenant.

package/data/packages/platform-authentication/api/Variable.GITHUB_AUTH_CONFIG_ENTRIES.md

@@ -10,6 +10,6 @@ editUrl: false
 const GITHUB_AUTH_CONFIG_ENTRIES: ReadonlyArray<Omit<IConfigRegistryEntry, 'module'>>;
 ```
 
-Defined in: [libs/platform-authentication/src/github/env.ts:9](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/github/env.ts#L9)
+Defined in: [libs/platform-authentication/src/connectors/github/env.ts:9](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/connectors/github/env.ts#L9)
 
 Configuration entries required by GitHub OAuth authentication.

package/data/packages/platform-authentication/api/Variable.GOOGLE_AUTH_CONFIG_ENTRIES.md

@@ -10,6 +10,6 @@ editUrl: false
 const GOOGLE_AUTH_CONFIG_ENTRIES: ReadonlyArray<Omit<IConfigRegistryEntry, 'module'>>;
 ```
 
-Defined in: [libs/platform-authentication/src/google/env.ts:9](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/google/env.ts#L9)
+Defined in: [libs/platform-authentication/src/connectors/google/env.ts:9](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/connectors/google/env.ts#L9)
 
 Configuration entries required by Google OAuth authentication.

package/data/packages/platform-authentication/api/Variable.MICROSOFT_AUTH_CONFIG_ENTRIES.md

@@ -10,6 +10,6 @@ editUrl: false
 const MICROSOFT_AUTH_CONFIG_ENTRIES: ReadonlyArray<Omit<IConfigRegistryEntry, 'module'>>;
 ```
 
-Defined in: [libs/platform-authentication/src/microsoft/env.ts:15](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/microsoft/env.ts#L15)
+Defined in: [libs/platform-authentication/src/connectors/microsoft/env.ts:15](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/connectors/microsoft/env.ts#L15)
 
 Configuration entries required by Microsoft OAuth authentication.

package/data/packages/platform-authentication/api/Variable.PLATFORM_AUTHENTICATION_CONFIG_ENTRIES.md

@@ -10,6 +10,6 @@ editUrl: false
 const PLATFORM_AUTHENTICATION_CONFIG_ENTRIES: ReadonlyArray<Omit<IConfigRegistryEntry, 'module'>>;
 ```
 
-Defined in: [libs/platform-authentication/src/env.ts:148](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/env.ts#L148)
+Defined in: [libs/platform-authentication/src/env.ts:151](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/env.ts#L151)
 
 Core configuration entries required by `platform-authentication`.

package/data/packages/platform-authentication/api/Variable.SEED_ANONYMOUS_USERNAME.md

@@ -10,6 +10,6 @@ editUrl: false
 const SEED_ANONYMOUS_USERNAME: IConfigKey<string>;
 ```
 
-Defined in: [libs/platform-authentication/src/env.ts:141](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/env.ts#L141)
+Defined in: [libs/platform-authentication/src/env.ts:144](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/env.ts#L144)
 
 Username used for the anonymous seed user.

package/data/packages/platform-authentication/api/Variable.TOTP_MFA_PROVIDERS.md

@@ -0,0 +1,30 @@
+---
+title: 'Variable: TOTP\_MFA\_PROVIDERS'
+generated: true
+editUrl: false
+---
+
+# Variable: TOTP_MFA_PROVIDERS
+
+```ts
+const TOTP_MFA_PROVIDERS: ReadonlyArray<Provider>;
+```
+
+Defined in: [libs/platform-authentication/src/mfa/totp/index.ts:27](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-authentication/src/mfa/totp/index.ts#L27)
+
+Providers required by the [TotpMfaChannel](Class.TotpMfaChannel).
+
+Spread these into the `additionalProviders` option of `AuthModule.register()`
+when enabling TOTP-based MFA.
+
+## Example
+
+```typescript
+import { TotpMfaChannel, TOTP_MFA_PROVIDERS } from '@breadstone/archipel-platform-authentication/mfa/totp';
+
+AuthModule.register({
+  mfaChannels: [TotpMfaChannel],
+  additionalProviders: [...TOTP_MFA_PROVIDERS],
+  // ...
+});
+```

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

@@ -11,21 +11,21 @@ editUrl: false
 | Class                                                    | Description                                                                                                                                                                                                                                 |
 | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | [AnonymousAuthGuard](Class.AnonymousAuthGuard)           | The `AnonymousAuthGuard` protects routes using anonymous authentication.                                                                                                                                                                    |
-| [AppleStrategy](Class.AppleStrategy)                     | The `AppleStrategy` integrates Apple Sign In authentication.                                                                                                                                                                                |
+| [AppleConnector](Class.AppleConnector)                   | The `AppleConnector` integrates Apple Sign In authentication.                                                                                                                                                                               |
 | [AuthModule](Class.AuthModule)                           | The `AuthModule` handles JWT-based authentication, including token creation and validation.                                                                                                                                                 |
 | [AuthSubjectPort](Class.AuthSubjectPort)                 | Abstract port for resolving authentication subjects by identity. Used by the JWT, Local, and Anonymous strategies.                                                                                                                          |
 | [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.                                                                                                                                                                                                  |
 | [GithubAuthGuard](Class.GithubAuthGuard)                 | The `GithubAuthGuard` protects routes using GitHub authentication.                                                                                                                                                                          |
-| [GithubStrategy](Class.GithubStrategy)                   | -                                                                                                                                                                                                                                           |
-| [GoogleStrategy](Class.GoogleStrategy)                   | The `GoogleStrategy` integrates Google OAuth authentication.                                                                                                                                                                                |
+| [GithubConnector](Class.GithubConnector)                 | -                                                                                                                                                                                                                                           |
+| [GoogleConnector](Class.GoogleConnector)                 | The `GoogleConnector` integrates Google OAuth authentication.                                                                                                                                                                               |
 | [JwtAuthGuard](Class.JwtAuthGuard)                       | The `JwtAuthGuard` protects routes using JWT-based authentication.                                                                                                                                                                          |
 | [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.                                                                                                                                                                            |
 | [MfaService](Class.MfaService)                           | Orchestrates MFA channels, backup codes, and user preferences.                                                                                                                                                                              |
 | [MfaSubjectPort](Class.MfaSubjectPort)                   | Abstract port for reading and writing MFA state on the underlying subject entity. Used by the MfaService and all MFA channel implementations.                                                                                               |
-| [MicrosoftStrategy](Class.MicrosoftStrategy)             | The `MicrosoftStrategy` integrates Microsoft OAuth authentication.                                                                                                                                                                          |
+| [MicrosoftConnector](Class.MicrosoftConnector)           | The `MicrosoftConnector` integrates Microsoft OAuth authentication.                                                                                                                                                                         |
 | [RolesGuard](Class.RolesGuard)                           | -                                                                                                                                                                                                                                           |
 | [SessionMappingProfile](Class.SessionMappingProfile)     | Mapping profile for Session entity to response transformations.                                                                                                                                                                             |
 | [SessionPersistencePort](Class.SessionPersistencePort)   | Abstract port for persisting and querying sessions. Used by the SessionService and LastActiveMiddleware.                                                                                                                                    |
@@ -34,6 +34,7 @@ editUrl: false
 | [SocialAuthGuard](Class.SocialAuthGuard)                 | -                                                                                                                                                                                                                                           |
 | [SocialAuthPort](Class.SocialAuthPort)                   | Abstract port for resolving or creating subjects from social / OAuth profiles. Used by all social strategies (GitHub, Google, Microsoft, Apple).                                                                                            |
 | [TokenEnricherPort](Class.TokenEnricherPort)             | Abstract port for enriching JWT claims with product-specific data. This is an optional port: when not provided, the token contains only base claims.                                                                                        |
+| [TotpMfaChannel](Class.TotpMfaChannel)                   | -                                                                                                                                                                                                                                           |
 | [VerificationService](Class.VerificationService)         | Manages email / PIN verification tokens via the [VerificationSubjectPort](Class.VerificationSubjectPort).                                                                                                                                   |
 | [VerificationSubjectPort](Class.VerificationSubjectPort) | Abstract port for verifiable subject persistence. Used by the VerificationService to manage email/PIN verification.                                                                                                                         |
 
@@ -80,6 +81,7 @@ editUrl: false
 | [AUTH_MFA_EMAIL_CODE_TTL](Variable.AUTH_MFA_EMAIL_CODE_TTL)                               | Time-to-live for email OTP codes (e.g. `'10m'`).                               |
 | [AUTH_MFA_EMAIL_MIN_RESEND](Variable.AUTH_MFA_EMAIL_MIN_RESEND)                           | Minimum interval between email OTP resend requests (e.g. `'30s'`).             |
 | [AUTH_MFA_ENCRYPTION_KEY](Variable.AUTH_MFA_ENCRYPTION_KEY)                               | AES encryption key used to encrypt MFA secrets at rest.                        |
+| [AUTH_MFA_ISSUER](Variable.AUTH_MFA_ISSUER)                                               | Issuer name shown in authenticator apps for TOTP MFA.                          |
 | [AUTH_MFA_MAX_ATTEMPTS](Variable.AUTH_MFA_MAX_ATTEMPTS)                                   | Maximum number of failed MFA attempts before lockout.                          |
 | [AUTH_MFA_PUSH_CODE_TTL](Variable.AUTH_MFA_PUSH_CODE_TTL)                                 | Time-to-live for push OTP codes (e.g. `'10m'`).                                |
 | [AUTH_MFA_PUSH_MIN_RESEND](Variable.AUTH_MFA_PUSH_MIN_RESEND)                             | Minimum interval between push OTP resend requests (e.g. `'30s'`).              |
@@ -99,6 +101,7 @@ editUrl: false
 | [SEED_ANONYMOUS_USERNAME](Variable.SEED_ANONYMOUS_USERNAME)                               | Username used for the anonymous seed user.                                     |
 | [SESSION_LIST_MAPPING_KEY](Variable.SESSION_LIST_MAPPING_KEY)                             | Type-safe mapping key for Session entity list to response list transformation. |
 | [SESSION_MAPPING_KEY](Variable.SESSION_MAPPING_KEY)                                       | Type-safe mapping key for Session entity to response transformation.           |
+| [TOTP_MFA_PROVIDERS](Variable.TOTP_MFA_PROVIDERS)                                         | Providers required by the [TotpMfaChannel](Class.TotpMfaChannel).              |
 | [User](Variable.User)                                                                     | Represents the `User` decorator.                                               |
 
 ## Functions

package/data/packages/platform-blob-storage/api/Class.BlobModule.md

@@ -6,7 +6,7 @@ editUrl: false
 
 # Class: BlobModule
 
-Defined in: [BlobModule.ts:89](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L89)
+Defined in: [BlobModule.ts:98](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L98)
 
 NestJS module responsible for providing blob storage services.
 
@@ -30,7 +30,7 @@ new BlobModule(): BlobModule;
 static forRoot(options?): DynamicModule;
 ```
 
-Defined in: [BlobModule.ts:100](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L100)
+Defined in: [BlobModule.ts:109](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L109)
 
 Configures the module with the specified options.
 When `objectPersistence` / `variantPersistence` are provided the

package/data/packages/platform-blob-storage/api/Interface.IAwsS3BlobProviderRegistration.md

@@ -6,7 +6,7 @@ editUrl: false
 
 # Interface: IAwsS3BlobProviderRegistration
 
-Defined in: [BlobModule.ts:44](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L44)
+Defined in: [BlobModule.ts:53](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L53)
 
 ## Properties
 
@@ -16,7 +16,7 @@ Defined in: [BlobModule.ts:44](https://github.com/RueDeRennes/archipel/blob/main
 kind: 'aws-s3';
 ```
 
-Defined in: [BlobModule.ts:45](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L45)
+Defined in: [BlobModule.ts:54](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L54)
 
 ---
 
@@ -26,4 +26,4 @@ Defined in: [BlobModule.ts:45](https://github.com/RueDeRennes/archipel/blob/main
 optional options?: Partial<IAwsS3ProviderOptions>;
 ```
 
-Defined in: [BlobModule.ts:46](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L46)
+Defined in: [BlobModule.ts:55](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L55)

package/data/packages/platform-blob-storage/api/Interface.IAzureBlobProviderRegistration.md

@@ -6,7 +6,7 @@ editUrl: false
 
 # Interface: IAzureBlobProviderRegistration
 
-Defined in: [BlobModule.ts:39](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L39)
+Defined in: [BlobModule.ts:48](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L48)
 
 ## Properties
 
@@ -16,7 +16,7 @@ Defined in: [BlobModule.ts:39](https://github.com/RueDeRennes/archipel/blob/main
 kind: 'azure';
 ```
 
-Defined in: [BlobModule.ts:40](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L40)
+Defined in: [BlobModule.ts:49](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L49)
 
 ---
 
@@ -26,4 +26,4 @@ Defined in: [BlobModule.ts:40](https://github.com/RueDeRennes/archipel/blob/main
 optional options?: Partial<IAzureBlobProviderOptions>;
 ```
 
-Defined in: [BlobModule.ts:41](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L41)
+Defined in: [BlobModule.ts:50](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L50)

package/data/packages/platform-blob-storage/api/Interface.IBlobModuleOptions.md

@@ -6,7 +6,7 @@ editUrl: false
 
 # Interface: IBlobModuleOptions
 
-Defined in: [BlobModule.ts:27](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L27)
+Defined in: [BlobModule.ts:36](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L36)
 
 ## Properties
 
@@ -16,7 +16,7 @@ Defined in: [BlobModule.ts:27](https://github.com/RueDeRennes/archipel/blob/main
 optional isGlobal?: boolean;
 ```
 
-Defined in: [BlobModule.ts:31](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L31)
+Defined in: [BlobModule.ts:40](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L40)
 
 ---
 
@@ -26,7 +26,7 @@ Defined in: [BlobModule.ts:31](https://github.com/RueDeRennes/archipel/blob/main
 optional objectPersistence?: Type<BlobObjectPersistencePort>;
 ```
 
-Defined in: [BlobModule.ts:29](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L29)
+Defined in: [BlobModule.ts:38](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L38)
 
 ---
 
@@ -36,7 +36,7 @@ Defined in: [BlobModule.ts:29](https://github.com/RueDeRennes/archipel/blob/main
 optional provider?: IBlobProviderRegistration;
 ```
 
-Defined in: [BlobModule.ts:28](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L28)
+Defined in: [BlobModule.ts:37](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L37)
 
 ---
 
@@ -46,4 +46,4 @@ Defined in: [BlobModule.ts:28](https://github.com/RueDeRennes/archipel/blob/main
 optional variantPersistence?: Type<BlobVariantPersistencePort>;
 ```
 
-Defined in: [BlobModule.ts:30](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L30)
+Defined in: [BlobModule.ts:39](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L39)

package/data/packages/platform-blob-storage/api/Interface.ICustomBlobProviderRegistration.md

@@ -6,7 +6,7 @@ editUrl: false
 
 # Interface: ICustomBlobProviderRegistration
 
-Defined in: [BlobModule.ts:49](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L49)
+Defined in: [BlobModule.ts:58](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L58)
 
 ## Properties
 
@@ -16,7 +16,7 @@ Defined in: [BlobModule.ts:49](https://github.com/RueDeRennes/archipel/blob/main
 kind: 'custom';
 ```
 
-Defined in: [BlobModule.ts:50](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L50)
+Defined in: [BlobModule.ts:59](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L59)
 
 ---
 
@@ -26,4 +26,4 @@ Defined in: [BlobModule.ts:50](https://github.com/RueDeRennes/archipel/blob/main
 useClass: Type<IBlobProvider>;
 ```
 
-Defined in: [BlobModule.ts:51](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L51)
+Defined in: [BlobModule.ts:60](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L60)

package/data/packages/platform-blob-storage/api/Interface.IVercelBlobProviderRegistration.md

@@ -6,7 +6,7 @@ editUrl: false
 
 # Interface: IVercelBlobProviderRegistration
 
-Defined in: [BlobModule.ts:34](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L34)
+Defined in: [BlobModule.ts:43](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L43)
 
 ## Properties
 
@@ -16,7 +16,7 @@ Defined in: [BlobModule.ts:34](https://github.com/RueDeRennes/archipel/blob/main
 kind: 'vercel';
 ```
 
-Defined in: [BlobModule.ts:35](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L35)
+Defined in: [BlobModule.ts:44](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L44)
 
 ---
 
@@ -26,4 +26,4 @@ Defined in: [BlobModule.ts:35](https://github.com/RueDeRennes/archipel/blob/main
 optional options?: Partial<IVercelBlobProviderOptions>;
 ```
 
-Defined in: [BlobModule.ts:36](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L36)
+Defined in: [BlobModule.ts:45](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L45)

package/data/packages/platform-blob-storage/api/TypeAlias.IBlobProviderRegistration.md

@@ -14,4 +14,4 @@ type IBlobProviderRegistration =
   | ICustomBlobProviderRegistration;
 ```
 
-Defined in: [BlobModule.ts:54](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L54)
+Defined in: [BlobModule.ts:63](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobModule.ts#L63)

package/data/packages/{platform-core → platform-caching}/api/Class.MemoryLayeredCache.md

@@ -6,9 +6,11 @@ editUrl: false
 
 # Class: MemoryLayeredCache\<TKey, TValue\>
 
-Defined in: [cache/MemoryLayeredCache.ts:66](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/cache/MemoryLayeredCache.ts#L66)
+Defined in: [MemoryLayeredCache.ts:72](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/MemoryLayeredCache.ts#L72)
 
-In-memory layered cache implementation.
+In-memory layered cache with LRU eviction, TTL expiration and
+optional stale-while-revalidate support. Falls back to an
+asynchronous loader function on cache misses.
 
 ## Type Parameters
 
@@ -29,14 +31,16 @@ In-memory layered cache implementation.
 new MemoryLayeredCache<TKey, TValue>(loadFn, options?): MemoryLayeredCache<TKey, TValue>;
 ```
 
-Defined in: [cache/MemoryLayeredCache.ts:87](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/cache/MemoryLayeredCache.ts#L87)
+Defined in: [MemoryLayeredCache.ts:97](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/MemoryLayeredCache.ts#L97)
+
+Initializes a new instance of the MemoryLayeredCache class.
 
 #### Parameters
 
-| Parameter  | Type                                                     |
-| ---------- | -------------------------------------------------------- |
-| `loadFn`   | (`key`) => `Promise`\<`TValue` \| `undefined`\>          |
-| `options?` | [`ILayeredCacheOptions`](Interface.ILayeredCacheOptions) |
+| Parameter  | Type                                                     | Description                                      |
+| ---------- | -------------------------------------------------------- | ------------------------------------------------ |
+| `loadFn`   | (`key`) => `Promise`\<`TValue` \| `undefined`\>          | Async loader invoked on cache misses.            |
+| `options?` | [`ILayeredCacheOptions`](Interface.ILayeredCacheOptions) | Optional configuration for TTL, LRU and metrics. |
 
 #### Returns
 
@@ -50,9 +54,9 @@ Defined in: [cache/MemoryLayeredCache.ts:87](https://github.com/RueDeRennes/arch
 get(key): TValue | undefined;
 ```
 
-Defined in: [cache/MemoryLayeredCache.ts:107](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/cache/MemoryLayeredCache.ts#L107)
+Defined in: [MemoryLayeredCache.ts:109](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/MemoryLayeredCache.ts#L109)
 
-Retrieves a value from the cache.
+Retrieves a value from the cache synchronously.
 
 #### Parameters
 
@@ -64,6 +68,8 @@ Retrieves a value from the cache.
 
 `TValue` \| `undefined`
 
+The cached value or `undefined` on a miss.
+
 #### Implementation of
 
 [`ILayeredCache`](Interface.ILayeredCache).[`get`](Interface.ILayeredCache#get)
@@ -76,9 +82,9 @@ Retrieves a value from the cache.
 getAsync(key): Promise<TValue | undefined>;
 ```
 
-Defined in: [cache/MemoryLayeredCache.ts:133](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/cache/MemoryLayeredCache.ts#L133)
+Defined in: [MemoryLayeredCache.ts:130](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/MemoryLayeredCache.ts#L130)
 
-Retrieves a value from the cache (asynchronous).
+Retrieves a value from the cache asynchronously.
 
 #### Parameters
 
@@ -90,6 +96,8 @@ Retrieves a value from the cache (asynchronous).
 
 `Promise`\<`TValue` \| `undefined`\>
 
+A promise resolving to the cached value or `undefined` on a miss.
+
 #### Implementation of
 
 [`ILayeredCache`](Interface.ILayeredCache).[`getAsync`](Interface.ILayeredCache#getasync)
@@ -102,9 +110,9 @@ Retrieves a value from the cache (asynchronous).
 invalidate(key): void;
 ```
 
-Defined in: [cache/MemoryLayeredCache.ts:193](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/cache/MemoryLayeredCache.ts#L193)
+Defined in: [MemoryLayeredCache.ts:174](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/MemoryLayeredCache.ts#L174)
 
-Invalidates a key in the cache.
+Invalidates a key in the cache synchronously.
 
 #### Parameters
 
@@ -128,9 +136,9 @@ Invalidates a key in the cache.
 invalidateAsync(key): Promise<void>;
 ```
 
-Defined in: [cache/MemoryLayeredCache.ts:203](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/cache/MemoryLayeredCache.ts#L203)
+Defined in: [MemoryLayeredCache.ts:179](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/MemoryLayeredCache.ts#L179)
 
-Invalidates a key in the cache (asynchronous).
+Invalidates a key in the cache asynchronously.
 
 #### Parameters
 
@@ -154,16 +162,16 @@ Invalidates a key in the cache (asynchronous).
 set(key, value): void;
 ```
 
-Defined in: [cache/MemoryLayeredCache.ts:161](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/cache/MemoryLayeredCache.ts#L161)
+Defined in: [MemoryLayeredCache.ts:152](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/MemoryLayeredCache.ts#L152)
 
-Sets a value in the cache.
+Stores a value in the cache synchronously.
 
 #### Parameters
 
-| Parameter | Type     | Description       |
-| --------- | -------- | ----------------- |
-| `key`     | `TKey`   | The key to set.   |
-| `value`   | `TValue` | The value to set. |
+| Parameter | Type     | Description         |
+| --------- | -------- | ------------------- |
+| `key`     | `TKey`   | The key to store.   |
+| `value`   | `TValue` | The value to store. |
 
 #### Returns
 
@@ -181,16 +189,16 @@ Sets a value in the cache.
 setAsync(key, value): Promise<void>;
 ```
 
-Defined in: [cache/MemoryLayeredCache.ts:175](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/cache/MemoryLayeredCache.ts#L175)
+Defined in: [MemoryLayeredCache.ts:160](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/MemoryLayeredCache.ts#L160)
 
-Sets a value in the cache (asynchronous).
+Stores a value in the cache asynchronously.
 
 #### Parameters
 
-| Parameter | Type     | Description       |
-| --------- | -------- | ----------------- |
-| `key`     | `TKey`   | The key to set.   |
-| `value`   | `TValue` | The value to set. |
+| Parameter | Type     | Description         |
+| --------- | -------- | ------------------- |
+| `key`     | `TKey`   | The key to store.   |
+| `value`   | `TValue` | The value to store. |
 
 #### Returns
 
@@ -208,15 +216,15 @@ Sets a value in the cache (asynchronous).
 stats(): ICacheStats;
 ```
 
-Defined in: [cache/MemoryLayeredCache.ts:207](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/cache/MemoryLayeredCache.ts#L207)
+Defined in: [MemoryLayeredCache.ts:184](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/MemoryLayeredCache.ts#L184)
 
-Retrieves cache statistics.
+Returns current cache statistics.
 
 #### Returns
 
 [`ICacheStats`](Interface.ICacheStats)
 
-The cache statistics.
+The cache statistics snapshot.
 
 #### Implementation of
 
@@ -230,9 +238,9 @@ The cache statistics.
 warm(key): Promise<TValue | undefined>;
 ```
 
-Defined in: [cache/MemoryLayeredCache.ts:182](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/cache/MemoryLayeredCache.ts#L182)
+Defined in: [MemoryLayeredCache.ts:168](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/MemoryLayeredCache.ts#L168)
 
-Proactively warms the cache for a given key (optional).
+Proactively warms the cache for a given key.
 
 #### Parameters
 
@@ -244,7 +252,7 @@ Proactively warms the cache for a given key (optional).
 
 `Promise`\<`TValue` \| `undefined`\>
 
-The value that was loaded and cached, or undefined if not found.
+The value that was loaded and cached, or `undefined` if not found.
 
 #### Implementation of