@breadstone/archipel-mcp 0.0.20 → 0.0.22

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

@@ -16,7 +16,6 @@ editUrl: false
 | Class | Description |
 | ------ | ------ |
 | [AppHealthIndicator](Class.AppHealthIndicator) | Health indicator for the application. |
-| [BlobResourceStrategy](Class.BlobResourceStrategy) | Strategy for loading resources from blob storage. |
 | [BooleanUtils](Class.BooleanUtils) | Boolean Utility Class. This class provides static methods to parse and format boolean values. |
 | [CasingInterceptor](Class.CasingInterceptor) | Global NestJS interceptor that normalizes property casing across the HTTP boundary. |
 | [CatchUtils](Class.CatchUtils) | - |
@@ -24,15 +23,11 @@ editUrl: false
 | [CUIDGenerator](Class.CUIDGenerator) | CUID Generator class |
 | [DateTimeUtils](Class.DateTimeUtils) | TimeSpan Utility Class. Provides methods to parse and format time span values. |
 | [DeviceParserService](Class.DeviceParserService) | The `DeviceParserService` class. |
-| [EmbeddedResourceStrategy](Class.EmbeddedResourceStrategy) | Strategy for loading embedded resources from memory. |
 | [ErrorTemplateService](Class.ErrorTemplateService) | Service for rendering error page templates. |
 | [EventHub](Class.EventHub) | Provides a strongly typed event hub that can publish and subscribe to events. |
 | [EventModule](Class.EventModule) | Module that provides event hub services. |
-| [FileResourceStrategy](Class.FileResourceStrategy) | Strategy for loading resources from the local file system. |
 | [GlobalExceptionFilter](Class.GlobalExceptionFilter) | A global exception filter that handles all uncaught exceptions in the application. Returns HTML error pages for browser requests and JSON for API requests. |
 | [GUIDGenerator](Class.GUIDGenerator) | GUID Generator class |
-| [HealthModule](Class.HealthModule) | - |
-| [HealthOrchestrator](Class.HealthOrchestrator) | Orchestrates execution of all registered health indicators and aggregates their results. |
 | [HostModule](Class.HostModule) | The `HostModule` provides host-related services globally. |
 | [HostService](Class.HostService) | The `HostService` class. |
 | [HttpLoggerMiddleware](Class.HttpLoggerMiddleware) | - |
@@ -41,24 +36,16 @@ editUrl: false
 | [LimitRequestSizeMiddleware](Class.LimitRequestSizeMiddleware) | - |
 | [LocalizedTextRequest](Class.LocalizedTextRequest) | Request DTO for a single localized text entry. |
 | [LocalizedTextResponse](Class.LocalizedTextResponse) | Base class for localized text responses. |
-| [MappingBuilder](Class.MappingBuilder) | A mapping builder that uses the mapping service to register maps. |
-| [MappingModule](Class.MappingModule) | Module that provides mapping services and allows registration of mapping profiles. |
-| [MappingNotRegisteredError](Class.MappingNotRegisteredError) | Thrown when a keyed mapping is requested but not registered. |
-| [MappingProfileBase](Class.MappingProfileBase) | Base class for mapping profiles to simplify implementation. |
-| [MappingService](Class.MappingService) | Central mapping registry supporting keyed & type-based mappings. |
 | [NormalizedUtils](Class.NormalizedUtils) | Utility functions for normalizing data. |
 | [PageableRequest](Class.PageableRequest) | Base class describing pagination query parameters shared across endpoints. |
 | [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. |
 | [QuantityResponse](Class.QuantityResponse) | Base class for quantity responses. |
-| [ResourceManager](Class.ResourceManager) | Central manager for loading resources from various sources. Supports multiple strategies (file, blob, embedded) with caching. |
-| [ResourceModule](Class.ResourceModule) | Module providing the ResourceManager. |
 | [ResponseReturn](Class.ResponseReturn) | - |
 | [SseHub](Class.SseHub) | Represents a server-sent event service. |
 | [SseModule](Class.SseModule) | Represents the `SseModule` class. |
 | [TimeStampResponse](Class.TimeStampResponse) | The base class for all time stamp responses. |
-| [TypeMappingNotRegisteredError](Class.TypeMappingNotRegisteredError) | Thrown when a type mapping is requested but not registered. |
 | [UserAvatarGeneratorService](Class.UserAvatarGeneratorService) | Service for generating GitHub-style identicon avatars. |
 | [UserNameGeneratorService](Class.UserNameGeneratorService) | Random user name generator class |
 | [UUIDGenerator](Class.UUIDGenerator) | UUID Generator class |
@@ -67,24 +54,12 @@ editUrl: false
 
 | Interface | Description |
 | ------ | ------ |
-| [IBlobResourceStrategyConfig](Interface.IBlobResourceStrategyConfig) | Configuration for the blob resource strategy. |
-| [IBlobServiceAdapter](Interface.IBlobServiceAdapter) | Minimal blob service interface to avoid circular dependencies. |
 | [IDeviceInfo](Interface.IDeviceInfo) | Interface for parsed device information |
 | [IErrorPageParams](Interface.IErrorPageParams) | Parameters for generating error page content. |
 | [IEventKey](Interface.IEventKey) | Represents a strongly typed event key that encodes the payload type. |
 | [IEventMap](Interface.IEventMap) | Represents the shape of the event map used by the [EventHub](Class.EventHub). |
-| [IFileResourceStrategyConfig](Interface.IFileResourceStrategyConfig) | Configuration for the file resource strategy. |
-| [IHealthCheckResult](Interface.IHealthCheckResult) | Represents the result of a health check indicator. |
-| [IHealthIndicator](Interface.IHealthIndicator) | Defines the contract for a health indicator that can be orchestrated. |
 | [IHostContentParams](Interface.IHostContentParams) | Parameters for generating host content. |
 | [IIdGenerator](Interface.IIdGenerator) | Interface for ID generators |
-| [IMappingBuilder](Interface.IMappingBuilder) | Defines the interface for a mapping builder. |
-| [IMappingKey](Interface.IMappingKey) | Type-safe mapping key that encodes both input and output types. This ensures compile-time type safety when using the mapping service. |
-| [IMappingProfile](Interface.IMappingProfile) | Defines the interface for a mapping profile. |
-| [IResourceManagerConfig](Interface.IResourceManagerConfig) | Configuration for the ResourceManager. |
-| [IResourceMetadata](Interface.IResourceMetadata) | Metadata about a resource. |
-| [IResourceResult](Interface.IResourceResult) | Result of loading a resource. |
-| [IResourceStrategy](Interface.IResourceStrategy) | Strategy for loading resources from a specific source. |
 | [ISseEventData](Interface.ISseEventData) | Represents the data of a Server-Sent Event. |
 | [ISseHub](Interface.ISseHub) | Represents a server-sent event service. |
 
@@ -107,7 +82,6 @@ editUrl: false
 | [APP\_URL](Variable.APP_URL) | Base URL the application is served from (e.g. `https://example.com`). |
 | [APP\_VERSION](Variable.APP_VERSION) | Semantic version of the running application (e.g. `1.2.3`). |
 | [GIT\_COMMIT](Variable.GIT_COMMIT) | Git commit SHA of the current build. |
-| [HEALTH\_INDICATORS\_TOKEN](Variable.HEALTH_INDICATORS_TOKEN) | Injection token for registered health indicators |
 | [ID\_GENERATOR\_TOKEN](Variable.ID_GENERATOR_TOKEN) | Interface for ID generators |
 | [IpAddress](Variable.IpAddress) | Extracts the client IP address from the current HTTP request. Handles IPv6 (::1), proxy headers (X-Forwarded-For), and normalizes the output. |
 | [IS\_PUBLIC\_KEY](Variable.IS_PUBLIC_KEY) | - |
@@ -121,7 +95,6 @@ editUrl: false
 | Function | Description |
 | ------ | ------ |
 | [createEventKey](Function.createEventKey) | Creates a branded event key for the [EventHub](Class.EventHub). |
-| [createMappingKey](Function.createMappingKey) | Creates a type-safe mapping key. |
 | [env](Function.env) | Marker function for environment strings. |
 | [getMimeTypeByFileNameOrExtension](Function.getMimeTypeByFileNameOrExtension) | Get MIME type by file name or extension. |
 | [Public](Function.Public) | The `Public` decorator. |

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

@@ -10,7 +10,7 @@ package: '@breadstone/archipel-platform-core'
 
 The foundation library that every other Archipel package depends on. Provides object mapping, template engines, event pub/sub, and shared utilities.
 
-> **Note:** Configuration has moved to [`platform-configuration`](../platform-configuration/), caching to [`platform-caching`](../platform-caching/), and cryptography/OTP to [`platform-cryptography`](../platform-cryptography/). Re-exports are still available from `platform-core` for backward compatibility.
+> **Note:** Configuration has moved to [`platform-configuration`](../platform-configuration/), caching to [`platform-caching`](../platform-caching/), cryptography/OTP to [`platform-cryptography`](../platform-cryptography/), mapping to [`platform-mapping`](../platform-mapping/), resource management to [`platform-resources`](../platform-resources/), and health checks to [`platform-health`](../platform-health/). Re-exports are still available from `platform-core` for backward compatibility.
 
 **Package:** `@breadstone/archipel-platform-core`
 
@@ -206,6 +206,8 @@ class MyMetricsRecorder implements ICacheMetricsRecorder {
 
 ## Mapping Service
 
+> **Extracted:** Mapping functionality now lives in [`platform-mapping`](/packages/platform-mapping/). The imports below still work via backward-compatible re-exports from `platform-core`, but new code should import from `@breadstone/archipel-platform-mapping` directly.
+
 Centralized object mapping with type-safe keys and profiles.
 
 ### Defining Mapping Keys
@@ -463,6 +465,7 @@ export class OrderService {
 | `HostService`                | Host configuration (title, logo, features, health endpoints)             |
 | `UserAvatarGeneratorService` | Generate deterministic avatars from user identifiers                     |
 | `UsernameGeneratorService`   | Generate random usernames from word lists                                |
+| `SseHub`                     | Server-Sent Events hub — bounded to 10,000 event subjects                |
 
 ---
 
@@ -471,12 +474,13 @@ export class OrderService {
 | Export                  | Type          | Description                                                                         |
 | ----------------------- | ------------- | ----------------------------------------------------------------------------------- |
 | `ConfigModule`          | NestJS Module | Configuration registration and validation (re-export from `platform-configuration`) |
-| `MappingModule`         | NestJS Module | Mapping profile registration                                                        |
+| `MappingModule`         | NestJS Module | Mapping profile registration (re-export from `platform-mapping`)                    |
 | `EventModule`           | NestJS Module | Event pub/sub system                                                                |
 | `IdentifierModule`      | NestJS Module | ID generation strategy                                                              |
 | `HostModule`            | NestJS Module | Host services and templates                                                         |
-| `HealthModule`          | NestJS Module | Health check orchestration                                                          |
-| `MappingService`        | Service       | Central object mapping                                                              |
+| `HealthModule`          | NestJS Module | Health check orchestration (re-export from `platform-health`)                       |
+| `ResourceModule`        | NestJS Module | Resource loading strategies (re-export from `platform-resources`)                   |
+| `MappingService`        | Service       | Central object mapping (re-export from `platform-mapping`)                          |
 | `ConfigService`         | Service       | Type-safe config access (re-export from `platform-configuration`)                   |
 | `BcryptService`         | Service       | Password hashing                                                                    |
 | `CryptoService`         | Service       | UUID generation                                                                     |

package/data/packages/platform-cryptography/api/Class.BcryptService.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: BcryptService
 
-Defined in: [BcryptService.ts:40](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/BcryptService.ts#L40)
+Defined in: [BcryptService.ts:34](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/BcryptService.ts#L34)
 
 The `BcryptService` class.
 Provides bcrypt hashing and comparison with configurable salt rounds,
@@ -20,7 +20,7 @@ exceeding bcrypt's 72-byte input limit.
 new BcryptService(options?): BcryptService;
 ```
 
-Defined in: [BcryptService.ts:56](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/BcryptService.ts#L56)
+Defined in: [BcryptService.ts:50](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/BcryptService.ts#L50)
 
 Initializes a new instance of the `BcryptService` class.
 
@@ -42,7 +42,7 @@ Initializes a new instance of the `BcryptService` class.
 compare(data, encrypted): Promise<boolean>;
 ```
 
-Defined in: [BcryptService.ts:98](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/BcryptService.ts#L98)
+Defined in: [BcryptService.ts:92](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/BcryptService.ts#L92)
 
 Compares the given data with the encrypted data.
 
@@ -73,7 +73,7 @@ symmetrically with [BcryptService.hash](#hash).
 hash(data): Promise<string>;
 ```
 
-Defined in: [BcryptService.ts:77](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/BcryptService.ts#L77)
+Defined in: [BcryptService.ts:71](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/BcryptService.ts#L71)
 
 Hashes the given data using bcrypt with a generated salt.
 

package/data/packages/platform-cryptography/api/Class.CryptoService.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: CryptoService
 
-Defined in: [CryptoService.ts:15](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/CryptoService.ts#L15)
+Defined in: [CryptoService.ts:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/CryptoService.ts#L16)
 
 The `CryptoService` class.
 Represents the service that provides cryptographic operations.
@@ -18,7 +18,7 @@ Represents the service that provides cryptographic operations.
 new CryptoService(): CryptoService;
 ```
 
-Defined in: [CryptoService.ts:21](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/CryptoService.ts#L21)
+Defined in: [CryptoService.ts:22](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/CryptoService.ts#L22)
 
 Initializes a new instance of the `CryptoService` class.
 
@@ -34,7 +34,7 @@ Initializes a new instance of the `CryptoService` class.
 getRandomGuid(prefix): string;
 ```
 
-Defined in: [CryptoService.ts:36](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/CryptoService.ts#L36)
+Defined in: [CryptoService.ts:37](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/CryptoService.ts#L37)
 
 Generates a random GUID prefixed with the given string.
 

package/data/packages/platform-cryptography/api/Class.OtpService.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: OtpService
 
-Defined in: [otp/OtpService.ts:58](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L58)
+Defined in: [otp/OtpService.ts:45](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L45)
 
 OTP service implementation backed by otplib v13.
 
@@ -25,7 +25,7 @@ the library version.
 new OtpService(options?): OtpService;
 ```
 
-Defined in: [otp/OtpService.ts:74](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L74)
+Defined in: [otp/OtpService.ts:61](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L61)
 
 Initializes a new instance of the `OtpService` class.
 
@@ -47,7 +47,7 @@ Initializes a new instance of the `OtpService` class.
 generateSecret(): string;
 ```
 
-Defined in: [otp/OtpService.ts:88](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L88)
+Defined in: [otp/OtpService.ts:75](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L75)
 
 Generates a cryptographically random secret suitable for TOTP.
 
@@ -69,7 +69,7 @@ The generated secret string.
 generateUri(options): string;
 ```
 
-Defined in: [otp/OtpService.ts:93](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L93)
+Defined in: [otp/OtpService.ts:80](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L80)
 
 Generates an `otpauth://` URI for QR code enrollment.
 
@@ -97,7 +97,7 @@ The formatted `otpauth://` URI.
 verify(token, secret): boolean;
 ```
 
-Defined in: [otp/OtpService.ts:105](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L105)
+Defined in: [otp/OtpService.ts:92](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L92)
 
 Verifies a TOTP token against the given secret.
 
@@ -132,7 +132,7 @@ verifyHotp(
 counter): Promise<boolean>;
 ```
 
-Defined in: [otp/OtpService.ts:112](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L112)
+Defined in: [otp/OtpService.ts:99](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L99)
 
 Verifies an HOTP (counter-based) token against the given secret and counter.
 

package/data/packages/platform-cryptography/api/Variable.BCRYPT_OPTIONS.md

@@ -9,6 +9,6 @@ editUrl: false
 const BCRYPT_OPTIONS: typeof BCRYPT_OPTIONS;
 ```
 
-Defined in: [BcryptService.ts:15](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/BcryptService.ts#L15)
+Defined in: [BcryptTokens.ts:6](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/BcryptTokens.ts#L6)
 
-Injection token for [IBcryptOptions](Interface.IBcryptOptions).
+Injection token for bcrypt options.

package/data/packages/platform-cryptography/api/Variable.MAX_BCRYPT_PASSWORD_BYTES.md

@@ -9,6 +9,6 @@ editUrl: false
 const MAX_BCRYPT_PASSWORD_BYTES: 72 = 72;
 ```
 
-Defined in: [BcryptService.ts:29](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/BcryptService.ts#L29)
+Defined in: [BcryptService.ts:23](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/BcryptService.ts#L23)
 
 Maximum password byte length that bcrypt processes without truncation.

package/data/packages/platform-cryptography/api/Variable.MIN_BCRYPT_ROUNDS.md

@@ -9,6 +9,6 @@ editUrl: false
 const MIN_BCRYPT_ROUNDS: 12 = 12;
 ```
 
-Defined in: [BcryptService.ts:22](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/BcryptService.ts#L22)
+Defined in: [BcryptService.ts:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/BcryptService.ts#L16)
 
 Minimum number of bcrypt salt rounds enforced by the service (OWASP ≥ 12).

package/data/packages/platform-cryptography/api/Variable.OTP_OPTIONS.md

@@ -9,6 +9,6 @@ editUrl: false
 const OTP_OPTIONS: typeof OTP_OPTIONS;
 ```
 
-Defined in: [otp/OtpService.ts:30](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L30)
+Defined in: [otp/OtpTokens.ts:6](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpTokens.ts#L6)
 
-Injection token for [IOtpOptions](Interface.IOtpOptions).
+Injection token for OTP service options.

package/data/packages/platform-cryptography/api/Variable.OTP_SERVICE_TOKEN.md

@@ -9,6 +9,6 @@ editUrl: false
 const OTP_SERVICE_TOKEN: typeof OTP_SERVICE_TOKEN;
 ```
 
-Defined in: [otp/OtpService.ts:23](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L23)
+Defined in: [otp/OtpTokens.ts:13](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpTokens.ts#L13)
 
-Injection token for [IOtpService](Interface.IOtpService).
+Injection token for the OTP service abstraction.

package/data/packages/platform-cryptography/api/Variable.TOTP_EPOCH_TOLERANCE.md

@@ -9,7 +9,7 @@ editUrl: false
 const TOTP_EPOCH_TOLERANCE: 30 = 30;
 ```
 
-Defined in: [otp/OtpService.ts:46](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L46)
+Defined in: [otp/OtpService.ts:33](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L33)
 
 Default TOTP verification tolerance expressed in **seconds** (otplib v13 `epochTolerance`).
 

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

@@ -29,9 +29,9 @@ editUrl: false
 
 | Variable | Description |
 | ------ | ------ |
-| [BCRYPT\_OPTIONS](Variable.BCRYPT_OPTIONS) | Injection token for [IBcryptOptions](Interface.IBcryptOptions). |
+| [BCRYPT\_OPTIONS](Variable.BCRYPT_OPTIONS) | Injection token for bcrypt options. |
 | [MAX\_BCRYPT\_PASSWORD\_BYTES](Variable.MAX_BCRYPT_PASSWORD_BYTES) | Maximum password byte length that bcrypt processes without truncation. |
 | [MIN\_BCRYPT\_ROUNDS](Variable.MIN_BCRYPT_ROUNDS) | Minimum number of bcrypt salt rounds enforced by the service (OWASP ≥ 12). |
-| [OTP\_OPTIONS](Variable.OTP_OPTIONS) | Injection token for [IOtpOptions](Interface.IOtpOptions). |
-| [OTP\_SERVICE\_TOKEN](Variable.OTP_SERVICE_TOKEN) | Injection token for [IOtpService](Interface.IOtpService). |
+| [OTP\_OPTIONS](Variable.OTP_OPTIONS) | Injection token for OTP service options. |
+| [OTP\_SERVICE\_TOKEN](Variable.OTP_SERVICE_TOKEN) | Injection token for the OTP service abstraction. |
 | [TOTP\_EPOCH\_TOLERANCE](Variable.TOTP_EPOCH_TOLERANCE) | Default TOTP verification tolerance expressed in **seconds** (otplib v13 `epochTolerance`). |

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

@@ -125,6 +125,16 @@ The default `TOTP_EPOCH_TOLERANCE` is 30 seconds (±1 time step):
 
 ---
 
+## Error Handling
+
+`CryptoService` throws `CryptoValidationError` when provided with invalid input (e.g. empty UUID prefix). The error carries a `code` property set to `'CRYPTO_VALIDATION'`.
+
+```typescript
+import { CryptoValidationError } from '@breadstone/archipel-platform-cryptography';
+```
+
+---
+
 ## API Reference
 
 See the full [API documentation](./api/) for all exported types and classes.

package/data/packages/platform-documents/api/Class.BaseDocumentRenderer.md

@@ -10,6 +10,11 @@ Defined in: [renderer/abstracts/BaseDocumentRenderer.ts:18](https://github.com/R
 Base class for document renderers.
 Provides common functionality for template loading, parsing, and image processing.
 
+## Extended by
+
+- [`DocxDocumentRenderer2`](Class.DocxDocumentRenderer2)
+- [`PdfDocumentRenderer`](Class.PdfDocumentRenderer)
+
 ## Implements
 
 - [`IDocumentRenderer`](Interface.IDocumentRenderer)
@@ -31,13 +36,15 @@ Defined in: [renderer/abstracts/BaseDocumentRenderer.ts:29](https://github.com/R
 
 | Parameter | Type | Description |
 | ------ | ------ | ------ |
-| `options` | \{ `debug`: `boolean`; `delimiters`: \{ `end`: `string`; `start`: `string`; \}; `maxImageHeight`: `number`; `maxImageWidth`: `number`; \} | - |
+| `options` | \{ `debug`: `boolean`; `delimiters`: \{ `end`: `string`; `start`: `string`; \}; `imageProcessor`: \{ \}; `maxImageHeight`: `number`; `maxImageWidth`: `number`; `renderers`: \{ \}[]; \} | - |
 | `options.debug` | `boolean` | Enable debug logging for document processing pipeline. When enabled, detailed logs will be written for: - Parser strategy selection - Template variable replacements - Data object transformations - Renderer processing steps |
 | `options.delimiters` | \{ `end`: `string`; `start`: `string`; \} | Delimiters for template placeholders. |
 | `options.delimiters.end` | `string` | Ending delimiter. **Default** `']]'` |
 | `options.delimiters.start` | `string` | Starting delimiter. **Default** `'[['` |
+| `options.imageProcessor` | \{ \} | Image processor implementation class. Import from `@breadstone/archipel-platform-documents/sharp` for the default Sharp-based processor. |
 | `options.maxImageHeight` | `number` | Maximum image height in pixels. |
 | `options.maxImageWidth` | `number` | Maximum image width in pixels. |
+| `options.renderers` | \{ \}[] | Document renderer implementation classes. Import from `@breadstone/archipel-platform-documents/docx` and `/pdf` for the built-in renderers. |
 | `resourceManager` | `ResourceManager` | - |
 | `imageProcessor` | [`IImageProcessor`](Interface.IImageProcessor) | - |
 
@@ -66,8 +73,12 @@ protected readonly _options: {
      end: string;
      start: string;
   };
+  imageProcessor: {
+  };
   maxImageHeight: number;
   maxImageWidth: number;
+  renderers: {
+  }[];
 };
 ```
 
@@ -125,6 +136,16 @@ Starting delimiter.
 '[['
 ```
 
+#### imageProcessor
+
+```ts
+readonly imageProcessor: {
+};
+```
+
+Image processor implementation class.
+Import from `@breadstone/archipel-platform-documents/sharp` for the default Sharp-based processor.
+
 #### maxImageHeight
 
 ```ts
@@ -141,6 +162,16 @@ readonly maxImageWidth: number;
 
 Maximum image width in pixels.
 
+#### renderers
+
+```ts
+readonly renderers: {
+}[];
+```
+
+Document renderer implementation classes.
+Import from `@breadstone/archipel-platform-documents/docx` and `/pdf` for the built-in renderers.
+
 ***
 
 ### \_resourceManager

package/data/packages/platform-documents/api/Class.DocumentEngine.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: DocumentEngine
 
-Defined in: [engine/DocumentEngine.ts:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/engine/DocumentEngine.ts#L16)
+Defined in: [engine/DocumentEngine.ts:19](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/engine/DocumentEngine.ts#L19)
 
 DocumentEngine orchestrates document generation workflow.
 Coordinates resource loading and renderer components.
@@ -18,7 +18,7 @@ Coordinates resource loading and renderer components.
 new DocumentEngine(resourceManager, renderers): DocumentEngine;
 ```
 
-Defined in: [engine/DocumentEngine.ts:41](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/engine/DocumentEngine.ts#L41)
+Defined in: [engine/DocumentEngine.ts:44](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/engine/DocumentEngine.ts#L44)
 
 #### Parameters
 
@@ -41,7 +41,7 @@ Defined in: [engine/DocumentEngine.ts:41](https://github.com/RueDeRennes/archipe
 get renderers(): ReadonlyMap<string, IDocumentRenderer>;
 ```
 
-Defined in: [engine/DocumentEngine.ts:33](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/engine/DocumentEngine.ts#L33)
+Defined in: [engine/DocumentEngine.ts:36](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/engine/DocumentEngine.ts#L36)
 
 Get available renderers.
 
@@ -61,7 +61,7 @@ render(options): Promise<IRenderResult & {
 }>;
 ```
 
-Defined in: [engine/DocumentEngine.ts:68](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/engine/DocumentEngine.ts#L68)
+Defined in: [engine/DocumentEngine.ts:71](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/engine/DocumentEngine.ts#L71)
 
 Render a document from template.
 

package/data/packages/platform-documents/api/Class.DocumentError.md

@@ -0,0 +1,61 @@
+---
+title: 'Abstract Class: DocumentError'
+generated: true
+editUrl: false
+---
+# Abstract Class: DocumentError
+
+Defined in: [errors/DocumentError.ts:7](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/errors/DocumentError.ts#L7)
+
+Base class for document-related domain errors.
+
+## Extends
+
+- `Error`
+
+## Extended by
+
+- [`DocumentRenderError`](Class.DocumentRenderError)
+- [`DocumentValidationError`](Class.DocumentValidationError)
+- [`ImageProcessingError`](Class.ImageProcessingError)
+
+## Constructors
+
+### Constructor
+
+```ts
+protected new DocumentError(
+   message, 
+   code, 
+   cause?): DocumentError;
+```
+
+Defined in: [errors/DocumentError.ts:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/errors/DocumentError.ts#L16)
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `message` | `string` |
+| `code` | `string` |
+| `cause?` | `unknown` |
+
+#### Returns
+
+`DocumentError`
+
+#### Overrides
+
+```ts
+Error.constructor
+```
+
+## Properties
+
+### code
+
+```ts
+readonly code: string;
+```
+
+Defined in: [errors/DocumentError.ts:10](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/errors/DocumentError.ts#L10)

package/data/packages/platform-documents/api/Class.DocumentModule.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: DocumentModule
 
-Defined in: [DocumentModule.ts:62](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/DocumentModule.ts#L62)
+Defined in: [DocumentModule.ts:73](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/DocumentModule.ts#L73)
 
 DocumentModule provides services for document generation and image processing.
 Uses abstract base classes and interfaces for extensibility.
@@ -30,7 +30,7 @@ new DocumentModule(): DocumentModule;
 static forRoot(options): DynamicModule;
 ```
 
-Defined in: [DocumentModule.ts:72](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/DocumentModule.ts#L72)
+Defined in: [DocumentModule.ts:83](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/DocumentModule.ts#L83)
 
 Configures the module with the specified options.
 

package/data/packages/platform-documents/api/Class.DocumentRenderError.md

@@ -0,0 +1,53 @@
+---
+title: 'Class: DocumentRenderError'
+generated: true
+editUrl: false
+---
+# Class: DocumentRenderError
+
+Defined in: [errors/DocumentRenderError.ts:8](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/errors/DocumentRenderError.ts#L8)
+
+Thrown when document rendering fails.
+
+## Extends
+
+- [`DocumentError`](Class.DocumentError)
+
+## Constructors
+
+### Constructor
+
+```ts
+new DocumentRenderError(message, cause?): DocumentRenderError;
+```
+
+Defined in: [errors/DocumentRenderError.ts:11](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/errors/DocumentRenderError.ts#L11)
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `message` | `string` |
+| `cause?` | `unknown` |
+
+#### Returns
+
+`DocumentRenderError`
+
+#### Overrides
+
+[`DocumentError`](Class.DocumentError).[`constructor`](Class.DocumentError#constructor)
+
+## Properties
+
+### code
+
+```ts
+readonly code: string;
+```
+
+Defined in: [errors/DocumentError.ts:10](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/errors/DocumentError.ts#L10)
+
+#### Inherited from
+
+[`DocumentError`](Class.DocumentError).[`code`](Class.DocumentError#code)

package/data/packages/platform-documents/api/Class.DocumentValidationError.md

@@ -0,0 +1,52 @@
+---
+title: 'Class: DocumentValidationError'
+generated: true
+editUrl: false
+---
+# Class: DocumentValidationError
+
+Defined in: [errors/DocumentValidationError.ts:8](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/errors/DocumentValidationError.ts#L8)
+
+Thrown when document input validation fails.
+
+## Extends
+
+- [`DocumentError`](Class.DocumentError)
+
+## Constructors
+
+### Constructor
+
+```ts
+new DocumentValidationError(message): DocumentValidationError;
+```
+
+Defined in: [errors/DocumentValidationError.ts:11](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/errors/DocumentValidationError.ts#L11)
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `message` | `string` |
+
+#### Returns
+
+`DocumentValidationError`
+
+#### Overrides
+
+[`DocumentError`](Class.DocumentError).[`constructor`](Class.DocumentError#constructor)
+
+## Properties
+
+### code
+
+```ts
+readonly code: string;
+```
+
+Defined in: [errors/DocumentError.ts:10](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/errors/DocumentError.ts#L10)
+
+#### Inherited from
+
+[`DocumentError`](Class.DocumentError).[`code`](Class.DocumentError#code)