@bernierllc/cache-manager 1.0.1

package/README.md

@@ -0,0 +1,425 @@
+# @bernierllc/cache-manager
+
+Multi-tier caching with TTL support, cache invalidation, and multiple storage backends.
+
+## Installation
+
+```bash
+npm install @bernierllc/cache-manager
+```
+
+For Redis support:
+```bash
+npm install @bernierllc/cache-manager redis
+```
+
+## Quick Start
+
+```typescript
+import { CacheManager } from '@bernierllc/cache-manager';
+
+// Create cache with default memory backend
+const cache = new CacheManager({
+  strategy: 'lru',
+  maxSize: 1000,
+  defaultTtl: 60 * 1000 // 1 minute
+});
+
+// Set cache value
+await cache.set('user:123', { name: 'John', email: 'john@example.com' });
+
+// Get cache value
+const user = await cache.get('user:123');
+console.log(user); // { name: 'John', email: 'john@example.com' }
+
+// Get or set pattern
+const userData = await cache.getOrSet('user:456', async () => {
+  return await fetchUserFromDatabase('456');
+}, 5 * 60 * 1000); // Cache for 5 minutes
+```
+
+## Core Features
+
+- **Multiple Backends**: Memory, Redis, database, multi-tier
+- **Cache Strategies**: LRU, LFU, TTL-based eviction policies  
+- **Intelligent Invalidation**: Tag-based, pattern-based cache invalidation
+- **Serialization**: JSON, binary, custom serializers
+- **Compression**: Optional compression for large values
+- **Stats & Monitoring**: Hit rates, memory usage, performance metrics
+- **Distributed Support**: Redis-backed distributed caching
+
+## API Reference
+
+### CacheManager
+
+#### Constructor
+
+```typescript
+const cache = new CacheManager(options: CacheOptions)
+```
+
+**Options:**
+- `backend?: CacheBackend | CacheBackend[]` - Storage backend(s)
+- `strategy?: 'lru' | 'lfu' | 'ttl'` - Eviction strategy (default: 'lru')
+- `maxSize?: number` - Maximum cache size (default: 1000)
+- `defaultTtl?: number` - Default TTL in milliseconds
+- `keyPrefix?: string` - Prefix for all cache keys
+- `onEviction?: (key, value) => void` - Eviction callback
+- `onExpiration?: (key, value) => void` - Expiration callback
+
+#### Core Methods
+
+```typescript
+// Basic operations
+await cache.set(key: string, value: any, ttl?: number, tags?: string[]): Promise<void>
+await cache.get<T>(key: string): Promise<T | null>
+await cache.delete(key: string): Promise<boolean>
+await cache.clear(): Promise<void>
+await cache.has(key: string): Promise<boolean>
+
+// Batch operations  
+await cache.mget<T>(keys: string[]): Promise<(T | null)[]>
+await cache.mset<T>(entries: Record<string, T>, ttl?: number): Promise<void>
+await cache.getOrSet<T>(key: string, factory: () => Promise<T>, ttl?: number): Promise<T>
+
+// Invalidation
+await cache.invalidateByTag(tag: string): Promise<void>
+await cache.invalidateByPattern(pattern: string): Promise<void>
+
+// Utilities
+await cache.keys(pattern?: string): Promise<string[]>
+await cache.size(): Promise<number>
+await cache.getStats(): Promise<CacheStats>
+await cache.cleanup(): Promise<number>
+```
+
+## Usage Examples
+
+### Basic Memory Caching
+
+```typescript
+import { CacheManager, MemoryCacheBackend } from '@bernierllc/cache-manager';
+
+const cache = new CacheManager({
+  backend: new MemoryCacheBackend({
+    maxSize: 1000,
+    strategy: 'lru'
+  }),
+  defaultTtl: 60 * 60 * 1000 // 1 hour
+});
+
+// Cache user data
+await cache.set('user:123', { 
+  name: 'John Doe', 
+  email: 'john@example.com' 
+});
+
+const user = await cache.get('user:123');
+console.log(user.name); // 'John Doe'
+```
+
+### Redis-backed Distributed Cache
+
+```typescript
+import { CacheManager, RedisCacheBackend } from '@bernierllc/cache-manager';
+
+const cache = new CacheManager({
+  backend: new RedisCacheBackend({
+    host: 'localhost',
+    port: 6379,
+    keyPrefix: 'myapp:'
+  }),
+  defaultTtl: 15 * 60 * 1000 // 15 minutes
+});
+
+// Works across multiple application instances
+await cache.set('global:config', configObject);
+```
+
+### Multi-tier Caching
+
+```typescript
+import { 
+  CacheManager, 
+  MemoryCacheBackend, 
+  RedisCacheBackend 
+} from '@bernierllc/cache-manager';
+
+const cache = new CacheManager({
+  backend: [
+    new MemoryCacheBackend({ maxSize: 100 }),    // L1 cache - fast, small
+    new RedisCacheBackend({ host: 'localhost' })  // L2 cache - shared, persistent
+  ]
+});
+
+// Automatically checks L1, then L2, updates L1 on L2 hits
+const data = await cache.get('expensive:computation');
+```
+
+### Tag-based Invalidation
+
+```typescript
+const cache = new CacheManager({
+  backend: new RedisCacheBackend({ host: 'localhost' })
+});
+
+// Cache with tags
+await cache.set('post:1', postData, 60 * 60 * 1000, ['user:123', 'category:tech']);
+await cache.set('post:2', postData2, 60 * 60 * 1000, ['user:123', 'category:news']);
+
+// Invalidate all posts by user
+await cache.invalidateByTag('user:123');
+
+// Invalidate all tech posts  
+await cache.invalidateByTag('category:tech');
+```
+
+### Pattern-based Invalidation
+
+```typescript
+// Cache user-specific data
+await cache.set('user:123:profile', profileData);
+await cache.set('user:123:settings', settingsData);
+await cache.set('user:456:profile', otherProfileData);
+
+// Invalidate all data for user 123
+await cache.invalidateByPattern('user:123:*');
+```
+
+### Cache Warming and Preloading
+
+```typescript
+// Warm cache with frequently accessed data
+async function warmCache() {
+  const popularUsers = await getPopularUsers();
+  
+  for (const user of popularUsers) {
+    await cache.set(`user:${user.id}`, user, 60 * 60 * 1000);
+  }
+}
+
+// Background cache refresh
+setInterval(async () => {
+  const keys = await cache.keys('user:*');
+  
+  for (const key of keys) {
+    const userId = key.split(':')[1];
+    const freshData = await fetchUserFromDatabase(userId);
+    await cache.set(key, freshData, 60 * 60 * 1000);
+  }
+}, 30 * 60 * 1000); // Refresh every 30 minutes
+```
+
+### Performance Monitoring
+
+```typescript
+// Monitor cache performance
+setInterval(async () => {
+  const stats = await cache.getStats();
+  
+  console.log(`Cache Performance:
+    Hit Rate: ${(stats.hitRate * 100).toFixed(1)}%
+    Size: ${stats.size} entries
+    Memory: ${Math.round(stats.memoryUsage / 1024)}KB
+    Evictions: ${stats.evictions}
+  `);
+}, 60000);
+
+// Automatic cleanup
+cache.startCleanupInterval(5 * 60 * 1000); // Clean every 5 minutes
+```
+
+## Configuration
+
+### Cache Backends
+
+#### MemoryCacheBackend
+```typescript
+new MemoryCacheBackend({
+  maxSize: 1000,              // Maximum number of entries
+  strategy: 'lru',            // Eviction strategy
+  onEviction: (key, value) => console.log('Evicted:', key),
+  onExpiration: (key, value) => console.log('Expired:', key)
+})
+```
+
+#### RedisCacheBackend
+```typescript
+new RedisCacheBackend({
+  host: 'localhost',
+  port: 6379,
+  password: 'secret',         // Optional
+  db: 0,                      // Database number
+  keyPrefix: 'cache:',        // Key prefix
+  connectionString: 'redis://localhost:6379' // Alternative to host/port
+})
+```
+
+#### MultiTierCacheBackend
+```typescript
+new MultiTierCacheBackend({
+  backends: [
+    new MemoryCacheBackend({ maxSize: 100 }),
+    new RedisCacheBackend({ host: 'localhost' })
+  ]
+})
+```
+
+### Cache Strategies
+
+- **LRU (Least Recently Used)**: Evicts the least recently accessed entries
+- **LFU (Least Frequently Used)**: Evicts the least frequently accessed entries  
+- **TTL (Time To Live)**: Evicts entries based on expiration time
+
+### Serializers
+
+```typescript
+import { JSONSerializer, BinarySerializer } from '@bernierllc/cache-manager';
+
+// JSON serialization (default)
+const cache = new CacheManager({
+  serializer: new JSONSerializer()
+});
+
+// Binary serialization for better performance
+const cache = new CacheManager({
+  serializer: new BinarySerializer()
+});
+```
+
+## Error Handling
+
+```typescript
+try {
+  await cache.set('key', 'value');
+  const value = await cache.get('key');
+} catch (error) {
+  console.error('Cache operation failed:', error);
+  // Fallback to original data source
+}
+```
+
+## Best Practices
+
+1. **Choose appropriate TTL**: Set TTL based on data freshness requirements
+2. **Use appropriate cache size**: Balance memory usage with hit rates
+3. **Implement cache warming**: Preload frequently accessed data
+4. **Monitor performance**: Track hit rates and adjust configuration
+5. **Handle failures gracefully**: Always have fallback mechanisms
+6. **Use tags wisely**: Group related cache entries for efficient invalidation
+
+## Performance
+
+The cache manager is designed for high-performance scenarios:
+
+- **Memory backend**: >50,000 operations/second
+- **Redis backend**: >10,000 operations/second  
+- **Multi-tier**: Combines speed of memory with persistence of Redis
+- **Efficient serialization**: Minimal overhead for data conversion
+- **Smart eviction**: Algorithms optimized for real-world usage patterns
+
+## Integration Documentation
+
+### Logger Integration
+
+The cache manager supports optional logger integration using `@bernierllc/logger`:
+
+```typescript
+import { CacheManager } from '@bernierllc/cache-manager';
+import { detectLogger } from '@bernierllc/logger';
+
+const cache = new CacheManager({
+  strategy: 'lru',
+  maxSize: 1000
+});
+
+// Auto-detect logger if available
+const logger = await detectLogger();
+if (logger) {
+  // Enhanced logging for cache operations
+  cache.on('hit', (key) => {
+    logger.debug('Cache hit', { key });
+  });
+  
+  cache.on('miss', (key) => {
+    logger.debug('Cache miss', { key });
+  });
+  
+  cache.on('evicted', (key, reason) => {
+    logger.info('Cache eviction', { key, reason });
+  });
+}
+```
+
+### NeverHub Integration
+
+The cache manager integrates with NeverHub when available for enhanced service discovery and monitoring:
+
+```typescript
+import { CacheManager } from '@bernierllc/cache-manager';
+import { detectNeverHub } from '@bernierllc/neverhub-adapter';
+
+async function initializeCacheManager() {
+  const cache = new CacheManager({
+    strategy: 'lru',
+    maxSize: 1000
+  });
+
+  // Auto-detect NeverHub
+  const neverhub = await detectNeverHub();
+  if (neverhub) {
+    // Register cache manager as a service
+    await neverhub.register({
+      type: 'cache-manager',
+      name: '@bernierllc/cache-manager',
+      version: '1.0.0',
+      capabilities: [
+        { type: 'cache', name: 'memory', version: '1.0.0' },
+        { type: 'cache', name: 'redis', version: '1.0.0' }
+      ]
+    });
+
+    // Publish cache events
+    cache.on('hit', async (key) => {
+      await neverhub.publishEvent({
+        type: 'cache.hit',
+        data: { key, timestamp: Date.now() }
+      });
+    });
+
+    // Subscribe to cache invalidation events
+    await neverhub.subscribe('cache.invalidate', async (event) => {
+      if (event.data.pattern) {
+        await cache.invalidatePattern(event.data.pattern);
+      } else if (event.data.key) {
+        await cache.delete(event.data.key);
+      }
+    });
+  }
+
+  return cache;
+}
+```
+
+### Graceful Degradation
+
+The cache manager implements graceful degradation patterns:
+
+- **Works without external services**: Core functionality operates independently
+- **Logger integration**: Enhanced monitoring when logger service is available
+- **NeverHub integration**: Service discovery and events when NeverHub is present
+- **Backend flexibility**: Falls back to memory storage if Redis is unavailable
+- **Error resilience**: Cache failures don't break application functionality
+
+## Dependencies
+
+- **Required**: None (core functionality)
+- **Optional**: `redis` for Redis backend support
+- **Optional**: `lz4` for compression support
+- **Optional**: `@bernierllc/logger` for enhanced logging capabilities
+- **Optional**: `@bernierllc/neverhub-adapter` for service discovery integration
+- **Internal**: `@bernierllc/connection-parser` for connection string parsing
+
+## License
+
+Copyright (c) 2025 Bernier LLC. All rights reserved.

package/dist/backends/index.d.ts

@@ -0,0 +1,4 @@
+export * from './memory';
+export * from './redis';
+export * from './multi-tier';
+//# sourceMappingURL=index.d.ts.map

package/dist/backends/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backends/index.ts"],"names":[],"mappings":"AAQA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC"}

package/dist/backends/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./memory"), exports);
+__exportStar(require("./redis"), exports);
+__exportStar(require("./multi-tier"), exports);
+//# sourceMappingURL=index.js.map

package/dist/backends/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backends/index.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;;;;;;;;;;;;;;AAEF,2CAAyB;AACzB,0CAAwB;AACxB,+CAA6B"}

package/dist/backends/memory.d.ts

@@ -0,0 +1,21 @@
+import type { CacheBackend, CacheEntry, CacheStats, MemoryCacheOptions } from '../types';
+export declare class MemoryCacheBackend implements CacheBackend {
+    private cache;
+    private strategy;
+    private maxSize;
+    private options;
+    private stats;
+    constructor(options?: MemoryCacheOptions);
+    get<T>(key: string): Promise<CacheEntry<T> | null>;
+    set<T>(key: string, entry: CacheEntry<T>, ttl?: number): Promise<void>;
+    private evictLeastImportant;
+    delete(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    keys(pattern?: string): Promise<string[]>;
+    size(): Promise<number>;
+    getStats(): Promise<CacheStats>;
+    private updateHitRate;
+    private updateStats;
+    private calculateMemoryUsage;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/backends/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/backends/memory.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAiB,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAIxG,qBAAa,kBAAmB,YAAW,YAAY;IACrD,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,KAAK,CAQX;gBAEU,OAAO,GAAE,kBAAuB;IAMtC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAoClD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAkB9D,mBAAmB;IAc3B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAYzC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAIvB,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;IAIrC,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,oBAAoB;CAuB7B"}

package/dist/backends/memory.js

@@ -0,0 +1,136 @@
+"use strict";
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryCacheBackend = void 0;
+const strategies_1 = require("../strategies");
+const constants_1 = require("../constants");
+class MemoryCacheBackend {
+    constructor(options = {}) {
+        this.cache = new Map();
+        this.stats = {
+            hits: 0,
+            misses: 0,
+            hitRate: 0,
+            size: 0,
+            memoryUsage: 0,
+            evictions: 0,
+            expirations: 0
+        };
+        this.options = options;
+        this.maxSize = options.maxSize || constants_1.DEFAULT_CACHE_OPTIONS.maxSize;
+        this.strategy = (0, strategies_1.createStrategy)(options.strategy || constants_1.DEFAULT_CACHE_OPTIONS.strategy);
+    }
+    async get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.stats.misses++;
+            this.updateHitRate();
+            return null;
+        }
+        // Check if expired
+        if (entry.expiresAt && entry.expiresAt < new Date()) {
+            this.cache.delete(key);
+            this.stats.expirations++;
+            this.stats.misses++;
+            this.updateHitRate();
+            if (this.options.onExpiration) {
+                this.options.onExpiration(key, entry.value);
+            }
+            return null;
+        }
+        // Update access information
+        entry.accessedAt = new Date();
+        entry.accessCount++;
+        // Update strategy
+        this.strategy.recordAccess(key, entry);
+        this.stats.hits++;
+        this.updateHitRate();
+        return entry;
+    }
+    async set(key, entry, ttl) {
+        // Set expiration if TTL provided
+        if (ttl) {
+            entry.expiresAt = new Date(Date.now() + ttl);
+        }
+        // Check if we need to evict
+        if (this.cache.size >= this.maxSize && !this.cache.has(key)) {
+            await this.evictLeastImportant();
+        }
+        // Store entry
+        this.cache.set(key, entry);
+        this.strategy.recordSet(key, entry);
+        this.updateStats();
+    }
+    async evictLeastImportant() {
+        const keyToEvict = this.strategy.selectForEviction(this.cache);
+        if (keyToEvict) {
+            const entry = this.cache.get(keyToEvict);
+            this.cache.delete(keyToEvict);
+            this.stats.evictions++;
+            if (entry && this.options.onEviction) {
+                this.options.onEviction(keyToEvict, entry.value);
+            }
+        }
+    }
+    async delete(key) {
+        const existed = this.cache.delete(key);
+        this.strategy.recordDelete(key);
+        this.updateStats();
+        return existed;
+    }
+    async clear() {
+        this.cache.clear();
+        this.strategy.clear();
+        this.updateStats();
+    }
+    async keys(pattern) {
+        const allKeys = Array.from(this.cache.keys());
+        if (!pattern) {
+            return allKeys;
+        }
+        // Simple pattern matching (* wildcard)
+        const regex = new RegExp(pattern.replace(/\*/g, '.*'));
+        return allKeys.filter(key => regex.test(key));
+    }
+    async size() {
+        return this.cache.size;
+    }
+    async getStats() {
+        return { ...this.stats };
+    }
+    updateHitRate() {
+        const total = this.stats.hits + this.stats.misses;
+        this.stats.hitRate = total > 0 ? this.stats.hits / total : 0;
+    }
+    updateStats() {
+        this.stats.size = this.cache.size;
+        this.stats.memoryUsage = this.calculateMemoryUsage();
+    }
+    calculateMemoryUsage() {
+        let totalSize = 0;
+        const keys = Array.from(this.cache.keys());
+        // Sample a subset for large caches
+        const sampleSize = Math.min(keys.length, Math.max(10, Math.floor(keys.length * constants_1.MEMORY_USAGE_SAMPLE_RATE)));
+        const sampleKeys = keys.slice(0, sampleSize);
+        for (const key of sampleKeys) {
+            const entry = this.cache.get(key);
+            if (entry) {
+                totalSize += Buffer.byteLength(key, 'utf8');
+                totalSize += Buffer.byteLength(JSON.stringify(entry.value), 'utf8');
+            }
+        }
+        // Extrapolate to full cache size
+        if (sampleSize > 0 && keys.length > sampleSize) {
+            totalSize = Math.round((totalSize / sampleSize) * keys.length);
+        }
+        return totalSize;
+    }
+}
+exports.MemoryCacheBackend = MemoryCacheBackend;
+//# sourceMappingURL=memory.js.map

package/dist/backends/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/backends/memory.ts"],"names":[],"mappings":"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"}

package/dist/backends/multi-tier.d.ts

@@ -0,0 +1,17 @@
+import type { CacheBackend, CacheEntry, CacheStats, MultiTierCacheOptions } from '../types';
+export declare class MultiTierCacheBackend implements CacheBackend {
+    private backends;
+    private stats;
+    constructor(options: MultiTierCacheOptions);
+    get<T>(key: string): Promise<CacheEntry<T> | null>;
+    set<T>(key: string, entry: CacheEntry<T>, ttl?: number): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    keys(pattern?: string): Promise<string[]>;
+    size(): Promise<number>;
+    getStats(): Promise<CacheStats>;
+    private updateHitRate;
+    getBackendCount(): number;
+    getBackendStats(index: number): Promise<CacheStats | null>;
+}
+//# sourceMappingURL=multi-tier.d.ts.map

package/dist/backends/multi-tier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-tier.d.ts","sourceRoot":"","sources":["../../src/backends/multi-tier.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAE5F,qBAAa,qBAAsB,YAAW,YAAY;IACxD,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,KAAK,CAQX;gBAEU,OAAO,EAAE,qBAAqB;IAOpC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAgClD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAatE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAatB,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAYzC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAYvB,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;IAqBrC,OAAO,CAAC,aAAa;IAMrB,eAAe,IAAI,MAAM;IAInB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CAajE"}