@breadstone/archipel-mcp 0.0.21 → 0.0.22

package/data/packages/platform-mailing/api/Variable.SMTP_PASSWORD.md

@@ -0,0 +1,14 @@
+---
+title: 'Variable: SMTP\_PASSWORD'
+generated: true
+editUrl: false
+---
+# Variable: SMTP\_PASSWORD
+
+```ts
+const SMTP_PASSWORD: IConfigKey<string>;
+```
+
+Defined in: [platform-mailing/src/smtp/env.ts:24](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/smtp/env.ts#L24)
+
+SMTP authentication password.

package/data/packages/platform-mailing/api/Variable.SMTP_PORT.md

@@ -0,0 +1,14 @@
+---
+title: 'Variable: SMTP\_PORT'
+generated: true
+editUrl: false
+---
+# Variable: SMTP\_PORT
+
+```ts
+const SMTP_PORT: IConfigKey<number>;
+```
+
+Defined in: [platform-mailing/src/smtp/env.ts:15](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/smtp/env.ts#L15)
+
+SMTP server port.

package/data/packages/platform-mailing/api/Variable.SMTP_SECURE.md

@@ -0,0 +1,14 @@
+---
+title: 'Variable: SMTP\_SECURE'
+generated: true
+editUrl: false
+---
+# Variable: SMTP\_SECURE
+
+```ts
+const SMTP_SECURE: IConfigKey<boolean>;
+```
+
+Defined in: [platform-mailing/src/smtp/env.ts:18](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/smtp/env.ts#L18)
+
+Whether the SMTP connection uses TLS.

package/data/packages/platform-mailing/api/Variable.SMTP_USER.md

@@ -0,0 +1,14 @@
+---
+title: 'Variable: SMTP\_USER'
+generated: true
+editUrl: false
+---
+# Variable: SMTP\_USER
+
+```ts
+const SMTP_USER: IConfigKey<string>;
+```
+
+Defined in: [platform-mailing/src/smtp/env.ts:21](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/smtp/env.ts#L21)
+
+SMTP authentication username.

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

@@ -9,10 +9,7 @@ editUrl: false
 
 | Class | Description |
 | ------ | ------ |
-| [BlobTemplateFetchStrategy](Class.BlobTemplateFetchStrategy) | The `BlobTemplateFetchStrategy` class. |
 | [DeliveryStrategyBase](Class.DeliveryStrategyBase) | Represents the base class for all email delivery strategies. |
-| [FileTemplateFetchStrategy](Class.FileTemplateFetchStrategy) | The `FileTemplateFetchStrategy` class. |
-| [LogDeliveryStrategy](Class.LogDeliveryStrategy) | The `LogDeliveryStrategy` class. |
 | [MailDeliveryError](Class.MailDeliveryError) | Domain error thrown when email delivery fails. |
 | [MailgunDeliveryStrategy](Class.MailgunDeliveryStrategy) | Delivers emails via the Mailgun API. |
 | [MailHealthIndicator](Class.MailHealthIndicator) | Health indicator for mail service. |
@@ -76,3 +73,9 @@ editUrl: false
 | [SEND\_MAIL\_EVENT\_KEY](Variable.SEND_MAIL_EVENT_KEY) | Event key registry for the mail domain events. |
 | [SENDGRID\_API\_KEY](Variable.SENDGRID_API_KEY) | API key for the SendGrid delivery service. |
 | [SENDGRID\_CONFIG\_ENTRIES](Variable.SENDGRID_CONFIG_ENTRIES) | Configuration entries required by the SendGrid delivery provider. |
+| [SMTP\_CONFIG\_ENTRIES](Variable.SMTP_CONFIG_ENTRIES) | Configuration entries required by the SMTP delivery provider. |
+| [SMTP\_HOST](Variable.SMTP_HOST) | SMTP server host. |
+| [SMTP\_PASSWORD](Variable.SMTP_PASSWORD) | SMTP authentication password. |
+| [SMTP\_PORT](Variable.SMTP_PORT) | SMTP server port. |
+| [SMTP\_SECURE](Variable.SMTP_SECURE) | Whether the SMTP connection uses TLS. |
+| [SMTP\_USER](Variable.SMTP_USER) | SMTP authentication username. |

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

@@ -0,0 +1,121 @@
+---
+title: platform-mapping
+description: Type-safe object-to-object mapping framework with profile-based configuration.
+order: 2
+tags: [mapping, dto, profiles, type-safe]
+package: '@breadstone/archipel-platform-mapping'
+---
+
+# platform-mapping
+
+Type-safe object-to-object mapping framework for transforming domain entities into response DTOs. Extracted from `platform-core` to provide a focused, independently versionable mapping module.
+
+**Package:** `@breadstone/archipel-platform-mapping`
+
+## Installation
+
+```typescript
+import {
+  MappingModule,
+  MappingService,
+  MappingProfileBase,
+  MappingKey,
+  MappingError,
+  MappingNotRegisteredError,
+  TypeMappingNotRegisteredError,
+} from '@breadstone/archipel-platform-mapping';
+```
+
+---
+
+## Defining Mapping Keys
+
+Mapping keys are branded constants that provide compile-time safety for source → destination pairs:
+
+```typescript
+import { MappingKey } from '@breadstone/archipel-platform-mapping';
+import type { IUserEntity } from './entities';
+import type { UserResponse } from './responses';
+
+export const USER_TO_RESPONSE = new MappingKey<IUserEntity, UserResponse>('UserEntity→UserResponse');
+export const USER_TO_SUMMARY = new MappingKey<IUserEntity, UserSummary>('UserEntity→UserSummary');
+```
+
+## Creating a Mapping Profile
+
+Profiles group related mappings into cohesive, injectable classes:
+
+```typescript
+import { Injectable } from '@nestjs/common';
+import { MappingProfileBase, type IMappingBuilder } from '@breadstone/archipel-platform-mapping';
+import { USER_TO_RESPONSE, USER_TO_SUMMARY } from './mapping-keys';
+
+@Injectable()
+export class UserMappingProfile extends MappingProfileBase {
+  public override configure(builder: IMappingBuilder): void {
+    builder.createKeyedMap(USER_TO_RESPONSE, (source) => ({
+      id: source.id,
+      name: source.userName,
+      email: source.email,
+      verified: source.isVerified,
+      roles: [...source.roles],
+    }));
+
+    builder.createKeyedMap(USER_TO_SUMMARY, (source) => ({
+      id: source.id,
+      displayName: source.userName ?? source.email ?? 'Anonymous',
+    }));
+  }
+}
+```
+
+## Registering Profiles in a Module
+
+```typescript
+import { Module } from '@nestjs/common';
+import { MappingModule } from '@breadstone/archipel-platform-mapping';
+import { UserMappingProfile } from './mappers/UserMappingProfile';
+
+@Module({
+  imports: [MappingModule.withProfiles([UserMappingProfile])],
+})
+export class AppModule {}
+```
+
+## Using in a Controller
+
+```typescript
+import { Controller, Get, Param } from '@nestjs/common';
+import { MappingService } from '@breadstone/archipel-platform-mapping';
+import { USER_TO_RESPONSE } from './mapping-keys';
+
+@Controller('users')
+export class UserController {
+  constructor(
+    private readonly _userService: UserService,
+    private readonly _mappingService: MappingService,
+  ) {}
+
+  @Get(':id')
+  public async getUser(@Param('id') id: string): Promise<UserResponse> {
+    const entity = await this._userService.findById(id);
+    return this._mappingService.map(USER_TO_RESPONSE, entity);
+  }
+}
+```
+
+---
+
+## Error Classes
+
+| Error                          | Description                                     |
+| ------------------------------ | ----------------------------------------------- |
+| `MappingError`                 | Base error for all mapping failures              |
+| `MappingNotRegisteredError`    | Thrown when a mapping key has no registered map   |
+| `TypeMappingNotRegisteredError`| Thrown when a type-based mapping is not found     |
+
+---
+
+## API Reference
+
+See the auto-generated [API Reference](./api/) for full details on all exported classes, interfaces, and types.

package/data/packages/platform-mcp/api/Variable.MCP_MODULE_OPTIONS.md

@@ -9,6 +9,6 @@ editUrl: false
 const MCP_MODULE_OPTIONS: typeof MCP_MODULE_OPTIONS;
 ```
 
-Defined in: [constants/McpTokens.ts:4](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mcp/src/constants/McpTokens.ts#L4)
+Defined in: [tokens/McpTokens.ts:4](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mcp/src/tokens/McpTokens.ts#L4)
 
 Injection tokens used by the MCP module.

package/data/packages/platform-openapi/api/Class.SwaggerMultiDocumentService.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: SwaggerMultiDocumentService
 
-Defined in: [services/SwaggerMultiDocumentService.ts:14](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/services/SwaggerMultiDocumentService.ts#L14)
+Defined in: [services/SwaggerMultiDocumentService.ts:15](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/services/SwaggerMultiDocumentService.ts#L15)
 
 ## Constructors
 
@@ -21,7 +21,7 @@ new SwaggerMultiDocumentService(
    contentTemplateEngine): SwaggerMultiDocumentService;
 ```
 
-Defined in: [services/SwaggerMultiDocumentService.ts:30](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/services/SwaggerMultiDocumentService.ts#L30)
+Defined in: [services/SwaggerMultiDocumentService.ts:31](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/services/SwaggerMultiDocumentService.ts#L31)
 
 #### Parameters
 
@@ -49,7 +49,7 @@ generateOpenApiDocuments(): {
 }[];
 ```
 
-Defined in: [services/SwaggerMultiDocumentService.ts:78](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/services/SwaggerMultiDocumentService.ts#L78)
+Defined in: [services/SwaggerMultiDocumentService.ts:79](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/services/SwaggerMultiDocumentService.ts#L79)
 
 Generates OpenAPI documents for every registered feature without wiring HTTP routes.
 
@@ -68,7 +68,7 @@ Generates OpenAPI documents for every registered feature without wiring HTTP rou
 setupMultipleSwaggerDocuments(): Promise<void>;
 ```
 
-Defined in: [services/SwaggerMultiDocumentService.ts:54](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/services/SwaggerMultiDocumentService.ts#L54)
+Defined in: [services/SwaggerMultiDocumentService.ts:55](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/services/SwaggerMultiDocumentService.ts#L55)
 
 Setup multiple Swagger documents for different features
 

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

@@ -0,0 +1,135 @@
+---
+title: platform-resources
+description: Multi-strategy resource management with MIME type detection and optional caching.
+order: 3
+tags: [resources, files, blob, mime, caching]
+package: '@breadstone/archipel-platform-resources'
+---
+
+# platform-resources
+
+Multi-strategy resource management for NestJS applications. Loads files from the file system, embedded buffers, or blob storage with MIME type detection and optional caching. Extracted from `platform-core` to provide a focused, independently versionable resource module.
+
+**Package:** `@breadstone/archipel-platform-resources`
+
+## Installation
+
+```typescript
+import {
+  ResourceModule,
+  ResourceManager,
+  FileResourceStrategy,
+  BlobResourceStrategy,
+  EmbeddedResourceStrategy,
+  ResourceNotFoundError,
+} from '@breadstone/archipel-platform-resources';
+```
+
+---
+
+## Module Registration
+
+Register the module with one or more resource strategies:
+
+```typescript
+import { Module } from '@nestjs/common';
+import { ResourceModule, FileResourceStrategy, EmbeddedResourceStrategy } from '@breadstone/archipel-platform-resources';
+import { join } from 'node:path';
+
+@Module({
+  imports: [
+    ResourceModule.forRoot({
+      strategies: [
+        new FileResourceStrategy({
+          basePath: join(__dirname, '..', 'assets'),
+        }),
+        new EmbeddedResourceStrategy([
+          { name: 'fallback.html', buffer: Buffer.from('<html>Fallback</html>') },
+        ]),
+      ],
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+## Using ResourceManager
+
+Inject and use `ResourceManager` to load resources at runtime:
+
+```typescript
+import { Injectable } from '@nestjs/common';
+import { ResourceManager } from '@breadstone/archipel-platform-resources';
+
+@Injectable()
+export class TemplateService {
+  constructor(private readonly _resourceManager: ResourceManager) {}
+
+  public async loadTemplate(name: string): Promise<string> {
+    const result = await this._resourceManager.get(name);
+    return result.buffer.toString('utf-8');
+  }
+}
+```
+
+---
+
+## Strategies
+
+| Strategy                    | Description                                                       |
+| --------------------------- | ----------------------------------------------------------------- |
+| `FileResourceStrategy`     | Loads resources from the local file system with glob support       |
+| `BlobResourceStrategy`     | Loads resources from a blob storage adapter (Vercel, Azure, S3)    |
+| `EmbeddedResourceStrategy` | Serves pre-loaded in-memory buffers                                |
+
+### BlobResourceStrategy
+
+For loading resources from cloud blob storage, provide an adapter that implements `IBlobServiceAdapter`:
+
+```typescript
+import { BlobResourceStrategy, type IBlobServiceAdapter } from '@breadstone/archipel-platform-resources';
+
+const blobStrategy = new BlobResourceStrategy({
+  adapter: myBlobAdapter,
+  containerName: 'templates',
+});
+```
+
+### Custom Strategies
+
+Implement `IResourceStrategy` to create your own resource loading strategy:
+
+```typescript
+import type { IResourceStrategy, IResourceResult } from '@breadstone/archipel-platform-resources';
+
+export class CustomStrategy implements IResourceStrategy {
+  public async get(name: string): Promise<IResourceResult | undefined> {
+    // Custom loading logic
+  }
+}
+```
+
+---
+
+## Interfaces
+
+| Interface              | Description                              |
+| ---------------------- | ---------------------------------------- |
+| `IResourceResult`     | Result object with `buffer` and `metadata` |
+| `IResourceMetadata`   | Metadata including `mimeType` and `size`  |
+| `IResourceStrategy`   | Strategy contract for resource loading    |
+| `IBlobServiceAdapter`  | Adapter contract for blob storage access  |
+
+---
+
+## Error Classes
+
+| Error                    | Description                                   |
+| ------------------------ | --------------------------------------------- |
+| `ResourceNotFoundError` | Thrown when a requested resource is not found   |
+
+---
+
+## API Reference
+
+See the auto-generated [API Reference](./api/) for full details on all exported classes, interfaces, and types.

package/data/packages/platform-telemetry/api/Variable.TELEMETRY_ENABLED.md

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

package/data/packages/platform-telemetry/api/Variable.TELEMETRY_FACADE.md

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

package/data/packages/platform-telemetry/api/Variable.TELEMETRY_OPTIONS.md

@@ -9,4 +9,4 @@ editUrl: false
 const TELEMETRY_OPTIONS: typeof TELEMETRY_OPTIONS;
 ```
 
-Defined in: [tokens.ts:2](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/tokens.ts#L2)
+Defined in: [tokens/TelemetryTokens.ts:2](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/tokens/TelemetryTokens.ts#L2)

package/{src/knowledge/configPattern.js → data/patterns/config-pattern.md}

@@ -1,46 +1,45 @@
-"use strict";
-/**
- * Static knowledge content for the Archipel configuration pattern.
- * Returned by the get-config-pattern tool.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONFIG_PATTERN_KNOWLEDGE = void 0;
-exports.CONFIG_PATTERN_KNOWLEDGE = `# Archipel Configuration Pattern
+---
+title: Configuration Pattern
+description: Typed config keys, ConfigRegistry, ConfigService, env.ts conventions, and ConfigModule integration.
+order: 1
+---
+
+# Archipel Configuration Pattern
 
 ## Overview
 
 Archipel uses a **typed configuration key** system with a **central registry**.
-Each platform library declares its required and optional config keys in an \`env.ts\`
-file, which are registered into the global \`ConfigRegistry\`. At runtime, the
-\`ConfigService\` resolves values through a pluggable strategy (environment variables,
+Each platform library declares its required and optional config keys in an `env.ts`
+file, which are registered into the global `ConfigRegistry`. At runtime, the
+`ConfigService` resolves values through a pluggable strategy (environment variables,
 Azure App Configuration, etc.).
 
-**Rule:** No direct \`process.env\` access outside of config strategy implementations.
+**Rule:** No direct `process.env` access outside of config strategy implementations.
 
 ## Core Types
 
 ### IConfigKey<TType>
 
-\`\`\`typescript
+```typescript
 export interface IConfigKey<TType = unknown> {
   readonly _type?: TType;  // Phantom type for compile-time safety
   readonly key: string;     // The actual config key string
 }
-\`\`\`
+```
 
 ### createConfigKey<TType>
 
-\`\`\`typescript
+```typescript
 import { createConfigKey } from '@breadstone/archipel-platform-core';
 
 export const APP_URL = createConfigKey<string>('APP_URL');
 export const APP_PORT = createConfigKey<number>('APP_PORT');
 export const FEATURE_ENABLED = createConfigKey<boolean>('FEATURE_ENABLED');
-\`\`\`
+```
 
 ## ConfigService API
 
-\`\`\`typescript
+```typescript
 @Injectable()
 export class ConfigService {
 
@@ -54,18 +53,18 @@ export class ConfigService {
   public compare<T>(key: string, value: T): boolean;
 
 }
-\`\`\`
+```
 
 **Auto-parsing:** String values are automatically converted:
-- \`'true'\` / \`'false'\` → \`boolean\`
-- Numeric strings → \`number\`
-- Empty strings → \`null\`
+- `'true'` / `'false'` → `boolean`
+- Numeric strings → `number`
+- Empty strings → `null`
 
 ## ConfigRegistry
 
 A static global registry that collects all declared config keys at module initialization.
 
-\`\`\`typescript
+```typescript
 export class ConfigRegistry {
 
   // Register keys for a module
@@ -78,11 +77,11 @@ export class ConfigRegistry {
   public static getModules(): ReadonlyArray<string>;
 
 }
-\`\`\`
+```
 
 ### IConfigRegistryEntry
 
-\`\`\`typescript
+```typescript
 export interface IConfigRegistryEntry<TType = unknown> {
   readonly key: IConfigKey<TType>;
   readonly module: string;
@@ -90,13 +89,13 @@ export interface IConfigRegistryEntry<TType = unknown> {
   readonly defaultValue?: TType;
   readonly description?: string;
 }
-\`\`\`
+```
 
 ## How to Add Configuration to a Library
 
 ### Step 1: Define typed config keys in env.ts
 
-\`\`\`typescript
+```typescript
 // src/env.ts
 import { createConfigKey } from '@breadstone/archipel-platform-core';
 import { ConfigRegistry, IConfigRegistryEntry } from '@breadstone/archipel-platform-core';
@@ -118,25 +117,25 @@ export const PLATFORM_PAYMENTS_CONFIG_ENTRIES: ReadonlyArray<Omit<IConfigRegistr
   { key: STRIPE_WEBHOOK_SECRET, required: true, description: 'Stripe webhook signing secret.' },
   { key: PAYMENT_CURRENCY, required: false, defaultValue: 'EUR', description: 'Default payment currency.' },
 ];
-\`\`\`
+```
 
 ### Step 2: Register in ConfigModule
 
-\`\`\`typescript
+```typescript
 // In the module's register() method:
 imports: [ConfigModule.register('platform-payments', PLATFORM_PAYMENTS_CONFIG_ENTRIES)]
-\`\`\`
+```
 
 Or for libraries without a dedicated module (self-registration):
 
-\`\`\`typescript
+```typescript
 // At the bottom of env.ts:
 ConfigRegistry.register('platform-payments', PLATFORM_PAYMENTS_CONFIG_ENTRIES);
-\`\`\`
+```
 
 ### Step 3: Use in services
 
-\`\`\`typescript
+```typescript
 @Injectable()
 export class StripeClient {
 
@@ -151,41 +150,41 @@ export class StripeClient {
   }
 
 }
-\`\`\`
+```
 
 ## ConfigModule
 
 ### register() — Per-library config registration
 
-Declares which config keys a library needs. Used in \`imports\` of feature modules.
+Declares which config keys a library needs. Used in `imports` of feature modules.
 
-\`\`\`typescript
+```typescript
 ConfigModule.register('platform-authentication', PLATFORM_AUTHENTICATION_CONFIG_ENTRIES)
-\`\`\`
+```
 
 ### forRoot() — Application bootstrap
 
 Configures the global strategy and static overrides. Used once in the root module.
 
-\`\`\`typescript
+```typescript
 ConfigModule.forRoot({
   strategyFactory: () => new EnvironmentConfigStrategy(),
   statics: { APP_VERSION: '1.0.0' },
 })
-\`\`\`
+```
 
 ## ConfigStrategyBase
 
 Pluggable strategy for resolving config values:
 
-\`\`\`typescript
+```typescript
 export abstract class ConfigStrategyBase {
   public abstract initialize(): void;
   public abstract resolve<T>(key: string): T;
   public abstract tryResolve<T>(key: string, fallback: T): T;
   public abstract has(key: string): boolean;
 }
-\`\`\`
+```
 
 Implementations can read from environment variables, Azure App Configuration, Consul, etc.
 
@@ -200,12 +199,10 @@ Implementations can read from environment variables, Azure App Configuration, Co
 
 ## Rules
 
-1. **All config keys defined via \`createConfigKey<T>()\`** — never raw \`process.env\` access.
-2. **Each library declares entries in \`env.ts\`** with required flag, default value, and description.
-3. **Registration via \`ConfigModule.register()\`** in the module, or self-registration for libraries without modules.
-4. **\`ConfigService.get()\` throws on missing required keys** — fail-fast at startup.
-5. **Use \`tryGet()\` with fallback** for optional keys.
+1. **All config keys defined via `createConfigKey<T>()`** — never raw `process.env` access.
+2. **Each library declares entries in `env.ts`** with required flag, default value, and description.
+3. **Registration via `ConfigModule.register()`** in the module, or self-registration for libraries without modules.
+4. **`ConfigService.get()` throws on missing required keys** — fail-fast at startup.
+5. **Use `tryGet()` with fallback** for optional keys.
 6. **Config key names use UPPER_SNAKE_CASE** matching environment variable conventions.
 7. **Group related keys** with comment separators in env.ts.
-`;
-//# sourceMappingURL=configPattern.js.map