@breadstone/archipel-mcp 0.0.21 → 0.0.22

package/data/guides/cryptography-and-otp.md

@@ -105,7 +105,7 @@ The prefix is required and must be a non-empty string. Use short, descriptive pr
 
 ```typescript
 import { Module } from '@nestjs/common';
-import { OtpService, OTP_SERVICE_TOKEN } from '@breadstone/archipel-platform-cryptography';
+import { OtpService, OTP_SERVICE_TOKEN } from '@breadstone/archipel-platform-cryptography/otp';
 
 @Module({
   providers: [
@@ -125,7 +125,7 @@ Generate a secret and a QR code URI for the user's authenticator app:
 
 ```typescript
 import { Inject, Injectable } from '@nestjs/common';
-import { OTP_SERVICE_TOKEN, type IOtpService } from '@breadstone/archipel-platform-cryptography';
+import { OTP_SERVICE_TOKEN, type IOtpService } from '@breadstone/archipel-platform-cryptography/otp';
 
 @Injectable()
 export class MfaService {

package/data/guides/database-setup.md

@@ -362,7 +362,7 @@ const result = await this._db.transactionCallback(async (tx) => {
 
 ## Health Checks
 
-`DatabaseModule` automatically registers a `DatabaseHealthIndicator` with the health orchestrator from `platform-core`. Once your application exposes a `/health` endpoint, database connectivity is checked via a `SELECT 1` ping. No additional configuration is needed.
+`DatabaseModule` automatically registers a `DatabaseHealthIndicator` with the health orchestrator from `platform-health`. Once your application exposes a `/health` endpoint, database connectivity is checked via a `SELECT 1` ping. No additional configuration is needed.
 
 If the health check fails, the indicator reports `database: down` with the error details.
 
@@ -484,7 +484,7 @@ export class UserService {
 // src/users/UserController.ts
 import { Controller, Get, Param, NotFoundException } from '@nestjs/common';
 import { UserService } from './UserService';
-import { MappingService } from '@breadstone/archipel-platform-core';
+import { MappingService } from '@breadstone/archipel-platform-mapping';
 import { USER_TO_RESPONSE } from './mapping-keys';
 
 @Controller('users')
@@ -514,7 +514,8 @@ And the root module wiring everything together:
 ```typescript
 // src/app.module.ts
 import { Module } from '@nestjs/common';
-import { ConfigModule, MappingModule } from '@breadstone/archipel-platform-core';
+import { ConfigModule } from '@breadstone/archipel-platform-configuration';
+import { MappingModule } from '@breadstone/archipel-platform-mapping';
 import { DatabaseModule, PLATFORM_DATABASE_CONFIG_ENTRIES } from '@breadstone/archipel-platform-database';
 import { UserModule } from './users/UserModule';
 

package/data/guides/email-templates.md

@@ -1,12 +1,12 @@
 ---
 title: Email Templates
-description: Create, register, and override email templates using the ResourceManager from platform-core and the template engine from platform-mailing.
+description: Create, register, and override email templates using the ResourceManager from platform-resources and the template engine from platform-mailing.
 order: 8
 ---
 
 # Email Templates
 
-This guide explains how to create email templates for `platform-mailing` and register them with `ResourceManager` from `platform-core`. It covers the template syntax, the built-in template names, how to provide your own HTML/TXT files, and how to override library defaults.
+This guide explains how to create email templates for `platform-mailing` and register them with `ResourceManager` from `platform-resources`. It covers the template syntax, the built-in template names, how to provide your own HTML/TXT files, and how to override library defaults.
 
 > **Prerequisite:** You should be familiar with [Email Delivery](/guides/email-delivery) for general mail setup and [Resource Management](/guides/resource-management) for how `ResourceManager` strategies work.
 
@@ -134,7 +134,7 @@ my-app/
 ```typescript
 import { Module } from '@nestjs/common';
 import { join } from 'node:path';
-import { ResourceModule, FileResourceStrategy } from '@breadstone/archipel-platform-core';
+import { ResourceModule, FileResourceStrategy } from '@breadstone/archipel-platform-resources';
 import { MailModule } from '@breadstone/archipel-platform-mailing';
 
 @Module({

package/data/guides/getting-started.md

@@ -17,10 +17,10 @@ This guide walks you through adding Archipel packages to a NestJS application. B
 
 ## Install the Foundation
 
-Every Archipel application starts with `platform-core` and `platform-configuration`. Core provides object mapping, templates, events, and cryptographic utilities. Configuration provides the type-safe config system that all other packages depend on.
+Every Archipel application starts with `platform-core`, `platform-configuration`, and `platform-mapping`. Core provides templates, events, and cryptographic utilities. Mapping provides the object-to-object mapping system. Configuration provides the type-safe config system that all other packages depend on.
 
 ```bash
-yarn add @breadstone/archipel-platform-core @breadstone/archipel-platform-configuration
+yarn add @breadstone/archipel-platform-core @breadstone/archipel-platform-configuration @breadstone/archipel-platform-mapping
 ```
 
 ### Set Up Configuration
@@ -85,7 +85,7 @@ The `MappingModule` provides a centralized service for transforming domain entit
 ```typescript
 import { Module } from '@nestjs/common';
 import { ConfigModule } from '@breadstone/archipel-platform-configuration';
-import { MappingModule } from '@breadstone/archipel-platform-core';
+import { MappingModule } from '@breadstone/archipel-platform-mapping';
 import { APP_CONFIG_ENTRIES } from './env';
 import { UserMappingProfile } from './mapping/UserMappingProfile';
 
@@ -100,7 +100,7 @@ You define mapping profiles that register transformations:
 
 ```typescript
 import { Injectable } from '@nestjs/common';
-import { MappingProfileBase, type MappingRegistry } from '@breadstone/archipel-platform-core';
+import { MappingProfileBase, type MappingRegistry } from '@breadstone/archipel-platform-mapping';
 import { USER_TO_RESPONSE } from './mapping-keys';
 
 @Injectable()
@@ -135,7 +135,7 @@ Register the module:
 // src/app.module.ts
 import { Module } from '@nestjs/common';
 import { ConfigModule } from '@breadstone/archipel-platform-configuration';
-import { MappingModule } from '@breadstone/archipel-platform-core';
+import { MappingModule } from '@breadstone/archipel-platform-mapping';
 import { DatabaseModule } from '@breadstone/archipel-platform-database';
 import { APP_CONFIG_ENTRIES } from './env';
 
@@ -286,7 +286,7 @@ Pass your adapter classes to `AuthModule.register()`:
 // src/app.module.ts
 import { Module } from '@nestjs/common';
 import { ConfigModule } from '@breadstone/archipel-platform-configuration';
-import { MappingModule } from '@breadstone/archipel-platform-core';
+import { MappingModule } from '@breadstone/archipel-platform-mapping';
 import { DatabaseModule } from '@breadstone/archipel-platform-database';
 import { AuthModule } from '@breadstone/archipel-platform-authentication';
 import { APP_CONFIG_ENTRIES } from './env';

package/data/guides/resource-management.md

@@ -6,16 +6,16 @@ order: 17
 
 # Resource Management
 
-This guide covers working with `ResourceManager` from `platform-core`: registering file strategies, loading resources at runtime, and using the built-in caching layer. If your application ships email templates, HTML pages, CSS/JS assets, or any other file-based content, this is how you make it available to services.
+This guide covers working with `ResourceManager` from `platform-resources`: registering file strategies, loading resources at runtime, and using the built-in caching layer. If your application ships email templates, HTML pages, CSS/JS assets, or any other file-based content, this is how you make it available to services.
 
 ---
 
 ## Installation
 
-`ResourceManager` is part of `platform-core` — no extra package needed.
+`ResourceManager` is part of `platform-resources`.
 
 ```bash
-yarn add @breadstone/archipel-platform-core
+yarn add @breadstone/archipel-platform-resources
 ```
 
 ---
@@ -47,7 +47,7 @@ If the file exists on disk, it's served immediately. If not, blob storage is che
 ```typescript
 import { Module } from '@nestjs/common';
 import { join } from 'node:path';
-import { ResourceModule, FileResourceStrategy, EmbeddedResourceStrategy } from '@breadstone/archipel-platform-core';
+import { ResourceModule, FileResourceStrategy, EmbeddedResourceStrategy } from '@breadstone/archipel-platform-resources';
 
 @Module({
   imports: [
@@ -56,7 +56,7 @@ import { ResourceModule, FileResourceStrategy, EmbeddedResourceStrategy } from '
         new FileResourceStrategy({
           basePaths: [
             join(__dirname, 'assets'),
-            join(__dirname, '..', 'node_modules', '@breadstone', 'archipel-platform-core', 'assets'),
+            join(__dirname, '..', 'node_modules', '@breadstone', 'archipel-platform-resources', 'assets'),
             join(__dirname, '..', 'node_modules', '@breadstone', 'archipel-platform-openapi', 'assets'),
             join(__dirname, '..', 'node_modules', '@breadstone', 'archipel-platform-mailing', 'assets'),
           ],
@@ -90,7 +90,7 @@ Inject `ResourceManager` and call its load methods. Every method has a `try*` va
 
 ```typescript
 import { Injectable } from '@nestjs/common';
-import { ResourceManager } from '@breadstone/archipel-platform-core';
+import { ResourceManager } from '@breadstone/archipel-platform-resources';
 
 @Injectable()
 export class InvoiceService {
@@ -172,7 +172,7 @@ The key you pass to `load()` is the **filename** (e.g. `'invoice-template.html'`
 Loads from cloud blob storage via a minimal `IBlobServiceAdapter` interface. This is **async-only** — calling `load()` (sync) will throw.
 
 ```typescript
-import { BlobResourceStrategy, IBlobServiceAdapter } from '@breadstone/archipel-platform-core';
+import { BlobResourceStrategy, IBlobServiceAdapter } from '@breadstone/archipel-platform-resources';
 
 const blobAdapter: IBlobServiceAdapter = {
   async downloadFile(key: string) {
@@ -247,7 +247,7 @@ const js = this._resourceManager.loadAsString('swagger.js');
 
 ### Application Index Page
 
-`platform-core`'s `HostService` loads `index.html` as a template for the root route:
+`platform-core`'s `HostService` loads `index.html` as a template for the root route (the `ResourceManager` itself comes from `platform-resources`):
 
 ```typescript
 const html = await this._resourceManager.loadAsStringAsync('index.html');
@@ -300,7 +300,7 @@ Enable `debug: true` in the module config to have `ResourceManager` call `whatDo
 Implement `IResourceStrategy` to support a new source (e.g. a database, S3 directly, or a remote API):
 
 ```typescript
-import { IResourceStrategy, IResourceResult } from '@breadstone/archipel-platform-core';
+import { IResourceStrategy, IResourceResult } from '@breadstone/archipel-platform-resources';
 
 export class DatabaseResourceStrategy implements IResourceStrategy {
   public get name(): string {

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

@@ -9,4 +9,4 @@ editUrl: false
 const AWS_S3_PROVIDER_OPTIONS: typeof AWS_S3_PROVIDER_OPTIONS;
 ```
 
-Defined in: [tokens.ts:6](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/tokens.ts#L6)
+Defined in: [BlobStorageTokens.ts:6](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobStorageTokens.ts#L6)

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

@@ -9,4 +9,4 @@ editUrl: false
 const AZURE_BLOB_PROVIDER_OPTIONS: typeof AZURE_BLOB_PROVIDER_OPTIONS;
 ```
 
-Defined in: [tokens.ts:5](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/tokens.ts#L5)
+Defined in: [BlobStorageTokens.ts:5](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobStorageTokens.ts#L5)

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

@@ -9,4 +9,4 @@ editUrl: false
 const BLOB_PROVIDER: typeof BLOB_PROVIDER;
 ```
 
-Defined in: [tokens.ts:3](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/tokens.ts#L3)
+Defined in: [BlobStorageTokens.ts:3](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobStorageTokens.ts#L3)

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

@@ -9,4 +9,4 @@ editUrl: false
 const VERCEL_BLOB_PROVIDER_OPTIONS: typeof VERCEL_BLOB_PROVIDER_OPTIONS;
 ```
 
-Defined in: [tokens.ts:4](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/tokens.ts#L4)
+Defined in: [BlobStorageTokens.ts:4](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-blob-storage/src/BlobStorageTokens.ts#L4)

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

@@ -30,7 +30,7 @@ Constructs a new instance of the `ErrorTemplateService` class.
 | ------ | ------ |
 | `configService` | `ConfigService` |
 | `contentTemplateEngine` | [`ContentTemplateEngine`](Class.ContentTemplateEngine) |
-| `resourceManager` | [`ResourceManager`](Class.ResourceManager) |
+| `resourceManager` | `ResourceManager` |
 
 #### Returns
 

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

@@ -30,7 +30,7 @@ Constructs a new instance of the `HostService` class.
 | ------ | ------ |
 | `configService` | `ConfigService` |
 | `contentTemplateEngine` | [`ContentTemplateEngine`](Class.ContentTemplateEngine) |
-| `resourceManager` | [`ResourceManager`](Class.ResourceManager) |
+| `resourceManager` | `ResourceManager` |
 
 #### Returns
 

package/data/packages/platform-core/api/Variable.ID_GENERATOR_TOKEN.md

@@ -9,6 +9,6 @@ editUrl: false
 const ID_GENERATOR_TOKEN: typeof ID_GENERATOR_TOKEN;
 ```
 
-Defined in: [identifiers/IdentifierTokens.ts:6](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/identifiers/IdentifierTokens.ts#L6)
+Defined in: [identifiers/tokens/IdentifierTokens.ts:6](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/identifiers/tokens/IdentifierTokens.ts#L6)
 
 Interface for ID generators

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
@@ -472,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 (max 100 indicators)                             |
-| `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.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-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