@breadstone/archipel-mcp 0.0.14 → 0.0.16

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

@@ -0,0 +1,121 @@
+---
+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,70 @@
+---
+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.

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

@@ -0,0 +1,198 @@
+---
+title: 'Interface: ILayeredCache\<TKey, TValue\>'
+generated: true
+editUrl: false
+---
+# Interface: ILayeredCache\<TKey, TValue\>
+
+Defined in: [ILayeredCache.ts:15](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/ILayeredCache.ts#L15)
+
+Generic layered cache contract supporting synchronous and asynchronous
+access patterns with optional warm-up and statistics.
+
+## Type Parameters
+
+| Type Parameter | Description |
+| ------ | ------ |
+| `TKey` | The type of the cache keys. |
+| `TValue` | The type of the cache values. |
+
+## Methods
+
+### get()
+
+```ts
+get(key): TValue | undefined;
+```
+
+Defined in: [ILayeredCache.ts:25](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/ILayeredCache.ts#L25)
+
+Retrieves a value from the cache synchronously.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `key` | `TKey` | The key to retrieve. |
+
+#### Returns
+
+`TValue` \| `undefined`
+
+The cached value or `undefined` on a miss.
+
+***
+
+### getAsync()
+
+```ts
+getAsync(key): Promise<TValue | undefined>;
+```
+
+Defined in: [ILayeredCache.ts:34](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/ILayeredCache.ts#L34)
+
+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.
+
+***
+
+### invalidate()
+
+```ts
+invalidate(key): void;
+```
+
+Defined in: [ILayeredCache.ts:69](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/ILayeredCache.ts#L69)
+
+Invalidates a key in the cache synchronously.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `key` | `TKey` | The key to invalidate. |
+
+#### Returns
+
+`void`
+
+***
+
+### invalidateAsync()
+
+```ts
+invalidateAsync(key): Promise<void>;
+```
+
+Defined in: [ILayeredCache.ts:77](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/ILayeredCache.ts#L77)
+
+Invalidates a key in the cache asynchronously.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `key` | `TKey` | The key to invalidate. |
+
+#### Returns
+
+`Promise`\<`void`\>
+
+***
+
+### set()
+
+```ts
+set(key, value): void;
+```
+
+Defined in: [ILayeredCache.ts:43](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/ILayeredCache.ts#L43)
+
+Stores a value in the cache synchronously.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `key` | `TKey` | The key to store. |
+| `value` | `TValue` | The value to store. |
+
+#### Returns
+
+`void`
+
+***
+
+### setAsync()
+
+```ts
+setAsync(key, value): Promise<void>;
+```
+
+Defined in: [ILayeredCache.ts:52](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/ILayeredCache.ts#L52)
+
+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`\>
+
+***
+
+### stats()?
+
+```ts
+optional stats(): ICacheStats;
+```
+
+Defined in: [ILayeredCache.ts:85](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/ILayeredCache.ts#L85)
+
+Returns current cache statistics.
+
+#### Returns
+
+[`ICacheStats`](Interface.ICacheStats)
+
+The cache statistics snapshot.
+
+***
+
+### warm()?
+
+```ts
+optional warm(key): Promise<TValue | undefined>;
+```
+
+Defined in: [ILayeredCache.ts:61](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/ILayeredCache.ts#L61)
+
+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.

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

@@ -0,0 +1,75 @@
+---
+title: 'Interface: ILayeredCacheOptions'
+generated: true
+editUrl: false
+---
+# Interface: ILayeredCacheOptions
+
+Defined in: [MemoryLayeredCache.ts:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/MemoryLayeredCache.ts#L16)
+
+Configuration options for [MemoryLayeredCache](Class.MemoryLayeredCache).
+
+## Properties
+
+### cacheName?
+
+```ts
+optional cacheName?: string;
+```
+
+Defined in: [MemoryLayeredCache.ts:57](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/MemoryLayeredCache.ts#L57)
+
+An optional name / label for the cache instance, used in metrics.
+Defaults to `'memory'`.
+
+***
+
+### maxEntries?
+
+```ts
+optional maxEntries?: number;
+```
+
+Defined in: [MemoryLayeredCache.ts:41](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/MemoryLayeredCache.ts#L41)
+
+Maximum number of entries retained in the cache. Oldest entries are
+evicted first (LRU). Defaults to infinite.
+
+***
+
+### metricsRecorder?
+
+```ts
+optional metricsRecorder?: ICacheMetricsRecorder;
+```
+
+Defined in: [MemoryLayeredCache.ts:49](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/MemoryLayeredCache.ts#L49)
+
+Optional metrics recorder forwarded cache operation statistics.
+Falls back to [NoopCacheMetricsRecorder](Class.NoopCacheMetricsRecorder) when omitted.
+
+***
+
+### staleWhileRevalidate?
+
+```ts
+optional staleWhileRevalidate?: boolean;
+```
+
+Defined in: [MemoryLayeredCache.ts:33](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/MemoryLayeredCache.ts#L33)
+
+When `true`, expired entries are served immediately while a background
+refresh is triggered. Defaults to `false`.
+
+***
+
+### ttlMs?
+
+```ts
+optional ttlMs?: number;
+```
+
+Defined in: [MemoryLayeredCache.ts:25](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/MemoryLayeredCache.ts#L25)
+
+Time to live in milliseconds. Entries older than this are considered expired.
+Defaults to infinite (no expiration).

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

@@ -0,0 +1,121 @@
+---
+title: 'Interface: IRedisLayeredCacheOptions\<TValue\>'
+generated: true
+editUrl: false
+---
+# Interface: IRedisLayeredCacheOptions\<TValue\>
+
+Defined in: [redis/RedisLayeredCache.ts:18](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/redis/RedisLayeredCache.ts#L18)
+
+Configuration options for [RedisLayeredCache](Class.RedisLayeredCache).
+
+## Type Parameters
+
+| Type Parameter | Description |
+| ------ | ------ |
+| `TValue` | The type of values stored in this cache. |
+
+## Properties
+
+### cacheName?
+
+```ts
+optional cacheName?: string;
+```
+
+Defined in: [redis/RedisLayeredCache.ts:67](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/redis/RedisLayeredCache.ts#L67)
+
+An optional name / label for the cache instance, used in metrics.
+Defaults to `'redis'`.
+
+***
+
+### deserialize?
+
+```ts
+optional deserialize?: (raw) => TValue;
+```
+
+Defined in: [redis/RedisLayeredCache.ts:52](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/redis/RedisLayeredCache.ts#L52)
+
+Custom deserialization function. Defaults to `JSON.parse`.
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `raw` | `string` |
+
+#### Returns
+
+`TValue`
+
+***
+
+### keyPrefix
+
+```ts
+keyPrefix: string;
+```
+
+Defined in: [redis/RedisLayeredCache.ts:31](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/redis/RedisLayeredCache.ts#L31)
+
+Key prefix applied to all Redis keys managed by this cache instance.
+
+***
+
+### metricsRecorder?
+
+```ts
+optional metricsRecorder?: ICacheMetricsRecorder;
+```
+
+Defined in: [redis/RedisLayeredCache.ts:59](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/redis/RedisLayeredCache.ts#L59)
+
+Optional metrics recorder forwarded cache operation statistics.
+
+***
+
+### serialize?
+
+```ts
+optional serialize?: (value) => string;
+```
+
+Defined in: [redis/RedisLayeredCache.ts:45](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/redis/RedisLayeredCache.ts#L45)
+
+Custom serialization function. Defaults to `JSON.stringify`.
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `value` | `TValue` |
+
+#### Returns
+
+`string`
+
+***
+
+### ttlSeconds?
+
+```ts
+optional ttlSeconds?: number;
+```
+
+Defined in: [redis/RedisLayeredCache.ts:38](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/redis/RedisLayeredCache.ts#L38)
+
+Optional TTL in seconds applied to every stored entry.
+
+***
+
+### url
+
+```ts
+url: string;
+```
+
+Defined in: [redis/RedisLayeredCache.ts:24](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-caching/src/redis/RedisLayeredCache.ts#L24)
+
+Redis connection URL (e.g. `redis://localhost:6379`).

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

@@ -0,0 +1,24 @@
+---
+title: '@breadstone/archipel-platform-caching'
+generated: true
+editUrl: false
+---
+# @breadstone/archipel-platform-caching
+
+## Classes
+
+| Class | Description |
+| ------ | ------ |
+| [MemoryLayeredCache](Class.MemoryLayeredCache) | In-memory layered cache with LRU eviction, TTL expiration and optional stale-while-revalidate support. Falls back to an asynchronous loader function on cache misses. |
+| [NoopCacheMetricsRecorder](Class.NoopCacheMetricsRecorder) | No-op implementation of [ICacheMetricsRecorder](Interface.ICacheMetricsRecorder) used as the default when no external metrics backend is configured. |
+| [RedisLayeredCache](Class.RedisLayeredCache) | Redis-backed layered cache implementation. Falls back to an asynchronous loader function when the requested key is not present in Redis. |
+
+## Interfaces
+
+| Interface | Description |
+| ------ | ------ |
+| [ICacheMetricsRecorder](Interface.ICacheMetricsRecorder) | Metrics recorder for cache operations. Implementations can forward measurements to Prometheus, OpenTelemetry, or any other backend. |
+| [ICacheStats](Interface.ICacheStats) | Cache statistics snapshot returned by cache implementations. |
+| [ILayeredCache](Interface.ILayeredCache) | Generic layered cache contract supporting synchronous and asynchronous access patterns with optional warm-up and statistics. |
+| [ILayeredCacheOptions](Interface.ILayeredCacheOptions) | Configuration options for [MemoryLayeredCache](Class.MemoryLayeredCache). |
+| [IRedisLayeredCacheOptions](Interface.IRedisLayeredCacheOptions) | Configuration options for [RedisLayeredCache](Class.RedisLayeredCache). |