@breadstone/archipel-mcp 0.0.7 → 0.0.9

package/data/packages/platform-caching/api/Class.NoopCacheMetricsRecorder.md

@@ -0,0 +1,158 @@
+---
+title: 'Class: NoopCacheMetricsRecorder'
+generated: true
+editUrl: false
+---
+
+# Class: NoopCacheMetricsRecorder
+
+Defined in: [NoopCacheMetricsRecorder.ts:13](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/NoopCacheMetricsRecorder.ts#L13)
+
+No-op implementation of [ICacheMetricsRecorder](Interface.ICacheMetricsRecorder) used as the default
+when no external metrics backend is configured.
+
+## Implements
+
+- [`ICacheMetricsRecorder`](Interface.ICacheMetricsRecorder)
+
+## Constructors
+
+### Constructor
+
+```ts
+new NoopCacheMetricsRecorder(): NoopCacheMetricsRecorder;
+```
+
+#### Returns
+
+`NoopCacheMetricsRecorder`
+
+## Methods
+
+### recordEviction()?
+
+```ts
+optional recordEviction(_cache): void;
+```
+
+Defined in: [NoopCacheMetricsRecorder.ts:37](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/NoopCacheMetricsRecorder.ts#L37)
+
+Records a cache eviction.
+
+#### Parameters
+
+| Parameter | Type     | Description             |
+| --------- | -------- | ----------------------- |
+| `_cache`  | `string` | The cache name / label. |
+
+#### Returns
+
+`void`
+
+#### Implementation of
+
+[`ICacheMetricsRecorder`](Interface.ICacheMetricsRecorder).[`recordEviction`](Interface.ICacheMetricsRecorder#recordeviction)
+
+---
+
+### recordHit()
+
+```ts
+recordHit(_cache): void;
+```
+
+Defined in: [NoopCacheMetricsRecorder.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/NoopCacheMetricsRecorder.ts#L17)
+
+Records a cache hit.
+
+#### Parameters
+
+| Parameter | Type     | Description             |
+| --------- | -------- | ----------------------- |
+| `_cache`  | `string` | The cache name / label. |
+
+#### Returns
+
+`void`
+
+#### Implementation of
+
+[`ICacheMetricsRecorder`](Interface.ICacheMetricsRecorder).[`recordHit`](Interface.ICacheMetricsRecorder#recordhit)
+
+---
+
+### recordLoadError()
+
+```ts
+recordLoadError(_cache): void;
+```
+
+Defined in: [NoopCacheMetricsRecorder.ts:32](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/NoopCacheMetricsRecorder.ts#L32)
+
+Records a failed cache load.
+
+#### Parameters
+
+| Parameter | Type     | Description             |
+| --------- | -------- | ----------------------- |
+| `_cache`  | `string` | The cache name / label. |
+
+#### Returns
+
+`void`
+
+#### Implementation of
+
+[`ICacheMetricsRecorder`](Interface.ICacheMetricsRecorder).[`recordLoadError`](Interface.ICacheMetricsRecorder#recordloaderror)
+
+---
+
+### recordLoadSuccess()
+
+```ts
+recordLoadSuccess(_cache): void;
+```
+
+Defined in: [NoopCacheMetricsRecorder.ts:27](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/NoopCacheMetricsRecorder.ts#L27)
+
+Records a successful cache load.
+
+#### Parameters
+
+| Parameter | Type     | Description             |
+| --------- | -------- | ----------------------- |
+| `_cache`  | `string` | The cache name / label. |
+
+#### Returns
+
+`void`
+
+#### Implementation of
+
+[`ICacheMetricsRecorder`](Interface.ICacheMetricsRecorder).[`recordLoadSuccess`](Interface.ICacheMetricsRecorder#recordloadsuccess)
+
+---
+
+### recordMiss()
+
+```ts
+recordMiss(_cache): void;
+```
+
+Defined in: [NoopCacheMetricsRecorder.ts:22](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/NoopCacheMetricsRecorder.ts#L22)
+
+Records a cache miss.
+
+#### Parameters
+
+| Parameter | Type     | Description             |
+| --------- | -------- | ----------------------- |
+| `_cache`  | `string` | The cache name / label. |
+
+#### Returns
+
+`void`
+
+#### Implementation of
+
+[`ICacheMetricsRecorder`](Interface.ICacheMetricsRecorder).[`recordMiss`](Interface.ICacheMetricsRecorder#recordmiss)

package/data/packages/platform-caching/api/Class.RedisLayeredCache.md

@@ -0,0 +1,296 @@
+---
+title: 'Class: RedisLayeredCache\<TKey, TValue\>'
+generated: true
+editUrl: false
+---
+
+# Class: RedisLayeredCache\<TKey, TValue\>
+
+Defined in: [redis/RedisLayeredCache.ts:83](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/redis/RedisLayeredCache.ts#L83)
+
+Redis-backed layered cache implementation. Falls back to an asynchronous
+loader function when the requested key is not present in Redis.
+
+## Remarks
+
+Synchronous methods (`get`, `set`, `invalidate`) throw because Redis
+is inherently asynchronous. Use the `*Async` variants instead.
+
+## Type Parameters
+
+| Type Parameter | Description                   |
+| -------------- | ----------------------------- |
+| `TKey`         | The type of the cache keys.   |
+| `TValue`       | The type of the cache values. |
+
+## Implements
+
+- [`ILayeredCache`](Interface.ILayeredCache)\<`TKey`, `TValue`\>
+- `OnModuleDestroy`
+
+## Constructors
+
+### Constructor
+
+```ts
+new RedisLayeredCache<TKey, TValue>(loadFn, options): RedisLayeredCache<TKey, TValue>;
+```
+
+Defined in: [redis/RedisLayeredCache.ts:107](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/redis/RedisLayeredCache.ts#L107)
+
+Initializes a new instance of the RedisLayeredCache class.
+
+#### Parameters
+
+| Parameter | Type                                                                           | Description                                         |
+| --------- | ------------------------------------------------------------------------------ | --------------------------------------------------- |
+| `loadFn`  | (`key`) => `Promise`\<`TValue` \| `undefined`\>                                | Async loader invoked on cache misses.               |
+| `options` | [`IRedisLayeredCacheOptions`](Interface.IRedisLayeredCacheOptions)\<`TValue`\> | Redis connection and cache behaviour configuration. |
+
+#### Returns
+
+`RedisLayeredCache`\<`TKey`, `TValue`\>
+
+## Methods
+
+### get()
+
+```ts
+get(key): TValue | undefined;
+```
+
+Defined in: [redis/RedisLayeredCache.ts:124](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/redis/RedisLayeredCache.ts#L124)
+
+Not supported — Redis is inherently asynchronous.
+
+#### Parameters
+
+| Parameter | Type   |
+| --------- | ------ |
+| `key`     | `TKey` |
+
+#### Returns
+
+`TValue` \| `undefined`
+
+#### Throws
+
+Always throws. Use [getAsync](#getasync) instead.
+
+#### Implementation of
+
+[`ILayeredCache`](Interface.ILayeredCache).[`get`](Interface.ILayeredCache#get)
+
+---
+
+### getAsync()
+
+```ts
+getAsync(key): Promise<TValue | undefined>;
+```
+
+Defined in: [redis/RedisLayeredCache.ts:129](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/redis/RedisLayeredCache.ts#L129)
+
+Retrieves a value from the cache asynchronously.
+
+#### Parameters
+
+| Parameter | Type   | Description          |
+| --------- | ------ | -------------------- |
+| `key`     | `TKey` | The key to retrieve. |
+
+#### Returns
+
+`Promise`\<`TValue` \| `undefined`\>
+
+A promise resolving to the cached value or `undefined` on a miss.
+
+#### Implementation of
+
+[`ILayeredCache`](Interface.ILayeredCache).[`getAsync`](Interface.ILayeredCache#getasync)
+
+---
+
+### invalidate()
+
+```ts
+invalidate(key): void;
+```
+
+Defined in: [redis/RedisLayeredCache.ts:186](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/redis/RedisLayeredCache.ts#L186)
+
+Not supported — Redis is inherently asynchronous.
+
+#### Parameters
+
+| Parameter | Type   |
+| --------- | ------ |
+| `key`     | `TKey` |
+
+#### Returns
+
+`void`
+
+#### Throws
+
+Always throws. Use [invalidateAsync](#invalidateasync) instead.
+
+#### Implementation of
+
+[`ILayeredCache`](Interface.ILayeredCache).[`invalidate`](Interface.ILayeredCache#invalidate)
+
+---
+
+### invalidateAsync()
+
+```ts
+invalidateAsync(key): Promise<void>;
+```
+
+Defined in: [redis/RedisLayeredCache.ts:193](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/redis/RedisLayeredCache.ts#L193)
+
+Invalidates a key in the cache asynchronously.
+
+#### Parameters
+
+| Parameter | Type   | Description            |
+| --------- | ------ | ---------------------- |
+| `key`     | `TKey` | The key to invalidate. |
+
+#### Returns
+
+`Promise`\<`void`\>
+
+#### Implementation of
+
+[`ILayeredCache`](Interface.ILayeredCache).[`invalidateAsync`](Interface.ILayeredCache#invalidateasync)
+
+---
+
+### onModuleDestroy()
+
+```ts
+onModuleDestroy(): Promise<void>;
+```
+
+Defined in: [redis/RedisLayeredCache.ts:214](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/redis/RedisLayeredCache.ts#L214)
+
+Gracefully disconnects the Redis client when the NestJS module is destroyed.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+#### Implementation of
+
+```ts
+OnModuleDestroy.onModuleDestroy;
+```
+
+---
+
+### set()
+
+```ts
+set(key, value): void;
+```
+
+Defined in: [redis/RedisLayeredCache.ts:160](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/redis/RedisLayeredCache.ts#L160)
+
+Not supported — Redis is inherently asynchronous.
+
+#### Parameters
+
+| Parameter | Type     |
+| --------- | -------- |
+| `key`     | `TKey`   |
+| `value`   | `TValue` |
+
+#### Returns
+
+`void`
+
+#### Throws
+
+Always throws. Use [setAsync](#setasync) instead.
+
+#### Implementation of
+
+[`ILayeredCache`](Interface.ILayeredCache).[`set`](Interface.ILayeredCache#set)
+
+---
+
+### setAsync()
+
+```ts
+setAsync(key, value): Promise<void>;
+```
+
+Defined in: [redis/RedisLayeredCache.ts:165](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/redis/RedisLayeredCache.ts#L165)
+
+Stores a value in the cache asynchronously.
+
+#### Parameters
+
+| Parameter | Type     | Description         |
+| --------- | -------- | ------------------- |
+| `key`     | `TKey`   | The key to store.   |
+| `value`   | `TValue` | The value to store. |
+
+#### Returns
+
+`Promise`\<`void`\>
+
+#### Implementation of
+
+[`ILayeredCache`](Interface.ILayeredCache).[`setAsync`](Interface.ILayeredCache#setasync)
+
+---
+
+### stats()
+
+```ts
+stats(): ICacheStats;
+```
+
+Defined in: [redis/RedisLayeredCache.ts:202](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/redis/RedisLayeredCache.ts#L202)
+
+Returns current cache statistics.
+
+#### Returns
+
+[`ICacheStats`](Interface.ICacheStats)
+
+The cache statistics snapshot.
+
+#### Implementation of
+
+[`ILayeredCache`](Interface.ILayeredCache).[`stats`](Interface.ILayeredCache#stats)
+
+---
+
+### warm()
+
+```ts
+warm(key): Promise<TValue | undefined>;
+```
+
+Defined in: [redis/RedisLayeredCache.ts:177](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/redis/RedisLayeredCache.ts#L177)
+
+Proactively warms the cache for a given key.
+
+#### Parameters
+
+| Parameter | Type   | Description      |
+| --------- | ------ | ---------------- |
+| `key`     | `TKey` | The key to warm. |
+
+#### Returns
+
+`Promise`\<`TValue` \| `undefined`\>
+
+The value that was loaded and cached, or `undefined` if not found.
+
+#### Implementation of
+
+[`ILayeredCache`](Interface.ILayeredCache).[`warm`](Interface.ILayeredCache#warm)

package/data/packages/platform-caching/api/Interface.ICacheMetricsRecorder.md

@@ -0,0 +1,122 @@
+---
+title: 'Interface: ICacheMetricsRecorder'
+generated: true
+editUrl: false
+---
+
+# Interface: ICacheMetricsRecorder
+
+Defined in: [ICacheMetricsRecorder.ts:7](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/ICacheMetricsRecorder.ts#L7)
+
+Metrics recorder for cache operations. Implementations can forward
+measurements to Prometheus, OpenTelemetry, or any other backend.
+
+## Methods
+
+### recordEviction()?
+
+```ts
+optional recordEviction(cache): void;
+```
+
+Defined in: [ICacheMetricsRecorder.ts:48](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/ICacheMetricsRecorder.ts#L48)
+
+Records a cache eviction.
+
+#### Parameters
+
+| Parameter | Type     | Description             |
+| --------- | -------- | ----------------------- |
+| `cache`   | `string` | The cache name / label. |
+
+#### Returns
+
+`void`
+
+---
+
+### recordHit()
+
+```ts
+recordHit(cache): void;
+```
+
+Defined in: [ICacheMetricsRecorder.ts:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/ICacheMetricsRecorder.ts#L16)
+
+Records a cache hit.
+
+#### Parameters
+
+| Parameter | Type     | Description             |
+| --------- | -------- | ----------------------- |
+| `cache`   | `string` | The cache name / label. |
+
+#### Returns
+
+`void`
+
+---
+
+### recordLoadError()
+
+```ts
+recordLoadError(cache): void;
+```
+
+Defined in: [ICacheMetricsRecorder.ts:40](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/ICacheMetricsRecorder.ts#L40)
+
+Records a failed cache load.
+
+#### Parameters
+
+| Parameter | Type     | Description             |
+| --------- | -------- | ----------------------- |
+| `cache`   | `string` | The cache name / label. |
+
+#### Returns
+
+`void`
+
+---
+
+### recordLoadSuccess()
+
+```ts
+recordLoadSuccess(cache): void;
+```
+
+Defined in: [ICacheMetricsRecorder.ts:32](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/ICacheMetricsRecorder.ts#L32)
+
+Records a successful cache load.
+
+#### Parameters
+
+| Parameter | Type     | Description             |
+| --------- | -------- | ----------------------- |
+| `cache`   | `string` | The cache name / label. |
+
+#### Returns
+
+`void`
+
+---
+
+### recordMiss()
+
+```ts
+recordMiss(cache): void;
+```
+
+Defined in: [ICacheMetricsRecorder.ts:24](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/ICacheMetricsRecorder.ts#L24)
+
+Records a cache miss.
+
+#### Parameters
+
+| Parameter | Type     | Description             |
+| --------- | -------- | ----------------------- |
+| `cache`   | `string` | The cache name / label. |
+
+#### Returns
+
+`void`

package/data/packages/platform-caching/api/Interface.ICacheStats.md

@@ -0,0 +1,71 @@
+---
+title: 'Interface: ICacheStats'
+generated: true
+editUrl: false
+---
+
+# Interface: ICacheStats
+
+Defined in: [ICacheStats.ts:6](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/ICacheStats.ts#L6)
+
+Cache statistics snapshot returned by cache implementations.
+
+## Properties
+
+### evictions?
+
+```ts
+optional evictions?: number;
+```
+
+Defined in: [ICacheStats.ts:42](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/ICacheStats.ts#L42)
+
+Number of cache evictions (if supported).
+
+---
+
+### hits
+
+```ts
+hits: number;
+```
+
+Defined in: [ICacheStats.ts:14](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/ICacheStats.ts#L14)
+
+Number of cache hits.
+
+---
+
+### loadErrors
+
+```ts
+loadErrors: number;
+```
+
+Defined in: [ICacheStats.ts:35](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/ICacheStats.ts#L35)
+
+Number of failed cache loads.
+
+---
+
+### loads
+
+```ts
+loads: number;
+```
+
+Defined in: [ICacheStats.ts:28](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/ICacheStats.ts#L28)
+
+Number of successful cache loads.
+
+---
+
+### misses
+
+```ts
+misses: number;
+```
+
+Defined in: [ICacheStats.ts:21](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/ICacheStats.ts#L21)
+
+Number of cache misses.