@nindroidsystems/pluginator 2.3.0

package/dist/infrastructure/backup.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Backup Utilities
+ *
+ * Provides backup creation and restoration functionality
+ * Uses tar.gz format for compressed backups
+ */
+/**
+ * Backup metadata stored in the archive
+ */
+export interface BackupMetadata {
+    created: string;
+    version: string;
+    description?: string;
+    sourceDir: string;
+    fileCount: number;
+    totalSize: number;
+}
+/**
+ * Options for creating a backup
+ */
+export interface BackupOptions {
+    description?: string;
+    include?: string[];
+    exclude?: string[];
+    followSymlinks?: boolean;
+    onProgress?: (current: number, total: number, filename: string) => void;
+}
+/**
+ * Result of backup creation
+ */
+export interface BackupResult {
+    path: string;
+    metadata: BackupMetadata;
+    compressedSize: number;
+}
+/**
+ * Options for restoring a backup
+ */
+export interface RestoreOptions {
+    overwrite?: boolean;
+    backupCurrent?: boolean;
+    onProgress?: (current: number, total: number, filename: string) => void;
+}
+/**
+ * Generate a backup filename with timestamp
+ */
+export declare function generateBackupFilename(prefix?: string): string;
+/**
+ * Create a backup of a directory
+ */
+export declare function createBackup(sourceDir: string, outputPath: string, options?: BackupOptions): Promise<BackupResult>;
+/**
+ * Create a simple backup by copying files
+ * Useful for quick backups without compression
+ */
+export declare function createSimpleBackup(sourceDir: string, outputDir: string, options?: {
+    suffix?: string;
+}): Promise<string>;
+/**
+ * Restore a backup to a directory
+ */
+export declare function restoreBackup(backupPath: string, targetDir: string, options?: RestoreOptions): Promise<{
+    restoredFiles: number;
+}>;
+/**
+ * List contents of a backup without extracting
+ */
+export declare function listBackupContents(backupPath: string): Promise<string[]>;
+/**
+ * Move a file to a backup location (rename with timestamp)
+ */
+export declare function backupFile(filePath: string, backupDir?: string): Promise<string>;
+/**
+ * Rotate backups, keeping only the N most recent
+ */
+export declare function rotateBackups(backupDir: string, pattern: RegExp, keepCount: number): Promise<string[]>;
+/**
+ * Get backup info from a tar.gz file
+ */
+export declare function getBackupInfo(backupPath: string): Promise<{
+    fileCount: number;
+    compressedSize: number;
+    files: string[];
+}>;
+//# sourceMappingURL=backup.d.ts.map

package/dist/infrastructure/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/infrastructure/backup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACzE;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACzE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,SAAW,GAAG,MAAM,CAIhE;AA6BD;;GAEG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAK5H;AA8DD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBjI;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,CAK3I;AAgDD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAW9E;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAYtF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA4B5G;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC,CASD"}

package/dist/infrastructure/cache/cache-service.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Cache Service
+ *
+ * In-memory cache with TTL, persistence, and statistics.
+ *
+ * @since v1.29.0
+ */
+import { type CacheConfig, type CacheDebugExport, type CacheOptions, type CacheStats, type CacheWarmer, type ExtendedCacheStats, type PreloadResult, type WarmingResult } from './cache-types.js';
+/**
+ * Cache service for storing and retrieving data with TTL
+ */
+export declare class CacheService {
+    private memory;
+    private config;
+    private stats;
+    private cleanupTimer;
+    constructor(config?: Partial<CacheConfig>);
+    /**
+     * Start the periodic cleanup timer
+     */
+    private startCleanupTimer;
+    /**
+     * Stop the cleanup timer
+     */
+    stopCleanupTimer(): void;
+    /**
+     * Get a value from cache, optionally fetching if missing/stale
+     */
+    get<T>(key: string, fetcher?: () => Promise<T>, options?: CacheOptions): Promise<T | undefined>;
+    /**
+     * Get a value synchronously (no fetcher)
+     */
+    getSync<T>(key: string): T | undefined;
+    /**
+     * Check if a key exists and is not expired
+     */
+    has(key: string): boolean;
+    /**
+     * Set a value in the cache
+     */
+    set<T>(key: string, data: T, options?: CacheOptions): void;
+    /**
+     * Invalidate a specific key
+     */
+    invalidate(key: string): boolean;
+    /**
+     * Invalidate all keys matching a pattern
+     */
+    invalidatePattern(pattern: RegExp): number;
+    /**
+     * Invalidate all keys starting with a prefix
+     */
+    invalidatePrefix(prefix: string): number;
+    /**
+     * Clear all entries
+     */
+    clear(): void;
+    /**
+     * Ensure there's capacity for a new entry
+     */
+    private ensureCapacity;
+    /**
+     * Evict the oldest entry
+     */
+    private evictOldest;
+    /**
+     * Get total size of all entries
+     */
+    private getTotalSize;
+    /**
+     * Clean up expired entries
+     */
+    cleanup(): number;
+    /**
+     * Get cache statistics
+     */
+    getStats(): CacheStats;
+    /**
+     * Reset statistics
+     */
+    resetStats(): void;
+    /**
+     * Get a formatted stats report
+     */
+    getStatsReport(): string;
+    /**
+     * Serialize the cache for persistence
+     */
+    serialize(): string;
+    /**
+     * Load from serialized data
+     */
+    static fromSerialized(data: string, config?: Partial<CacheConfig>): CacheService;
+    /**
+     * Get the number of entries
+     */
+    size(): number;
+    /**
+     * Get all keys
+     */
+    keys(): string[];
+    /**
+     * Get configuration
+     */
+    getConfig(): CacheConfig;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<CacheConfig>): void;
+    /**
+     * Reset the service (for testing)
+     */
+    reset(): void;
+    /**
+     * Warm the cache with multiple entries
+     *
+     * Loads multiple cache entries in parallel. Entries that are already
+     * cached are skipped. Returns results including any errors.
+     */
+    warmCache<T>(warmers: CacheWarmer<T>[]): Promise<WarmingResult>;
+    /**
+     * Preload specific keys using a loader function
+     *
+     * Only loads keys that are not already cached.
+     */
+    preload<T>(keys: string[], loader: (key: string) => Promise<T>, options?: CacheOptions): Promise<PreloadResult>;
+    /**
+     * Get memory pressure as a percentage (0-100)
+     *
+     * Based on both entry count and total size limits.
+     */
+    getMemoryPressure(): number;
+    /**
+     * Get extended statistics including memory info
+     */
+    getExtendedStats(): ExtendedCacheStats;
+    /**
+     * Get the oldest entry's age in milliseconds
+     */
+    getOldestEntryAge(): number;
+    /**
+     * Get the newest entry's age in milliseconds
+     */
+    getNewestEntryAge(): number;
+    /**
+     * Export cache state for debugging
+     *
+     * Returns a human-readable snapshot of the cache state.
+     * Useful for debugging and analysis.
+     */
+    exportDebugInfo(): CacheDebugExport;
+    /**
+     * Format debug export as a readable string
+     */
+    formatDebugExport(): string;
+}
+/**
+ * Get the singleton cache service
+ */
+export declare function getCacheService(): CacheService;
+/**
+ * Reset the singleton (for testing)
+ */
+export declare function resetCacheService(): void;
+/**
+ * Generate a cache key from parts
+ */
+export declare function generateCacheKey(source: string, endpoint: string, params?: Record<string, unknown>): string;
+//# sourceMappingURL=cache-service.d.ts.map

package/dist/infrastructure/cache/cache-service.d.ts.map

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

package/dist/infrastructure/cache/cache-types.d.ts

@@ -0,0 +1,200 @@
+/**
+ * Cache Types
+ *
+ * Type definitions for the caching system.
+ *
+ * @since v1.29.0
+ */
+/**
+ * Cache entry with metadata
+ */
+export interface CacheEntry<T> {
+    /** Cached data */
+    data: T;
+    /** When the entry was created */
+    timestamp: number;
+    /** Time-to-live in milliseconds */
+    ttl: number;
+    /** Optional ETag for HTTP caching */
+    etag?: string;
+    /** Size in bytes (approximate) */
+    size?: number;
+}
+/**
+ * Options for cache operations
+ */
+export interface CacheOptions {
+    /** Time-to-live in milliseconds */
+    ttl?: number;
+    /** Return stale data while revalidating */
+    staleWhileRevalidate?: boolean;
+    /** Persist this entry to disk */
+    persistent?: boolean;
+    /** ETag for HTTP caching */
+    etag?: string;
+}
+/**
+ * Cache statistics
+ */
+export interface CacheStats {
+    /** Number of cache hits */
+    hits: number;
+    /** Number of cache misses */
+    misses: number;
+    /** Hit rate percentage */
+    hitRate: number;
+    /** Number of entries in cache */
+    entryCount: number;
+    /** Total size in bytes (approximate) */
+    totalSize: number;
+    /** Number of evictions */
+    evictions: number;
+}
+/**
+ * Serialized cache for persistence
+ */
+export interface SerializedCache {
+    version: string;
+    entries: Array<{
+        key: string;
+        entry: CacheEntry<unknown>;
+    }>;
+    stats: {
+        hits: number;
+        misses: number;
+        evictions: number;
+    };
+}
+/**
+ * Cache configuration
+ */
+export interface CacheConfig {
+    /** Default TTL in milliseconds */
+    defaultTTL: number;
+    /** Maximum cache size in bytes */
+    maxSize: number;
+    /** Maximum number of entries */
+    maxEntries: number;
+    /** Enable persistence to disk */
+    persistEnabled: boolean;
+    /** Path for persistence file */
+    persistPath?: string;
+    /** Cleanup interval in milliseconds */
+    cleanupInterval: number;
+}
+/**
+ * Default cache configuration
+ */
+export declare const DEFAULT_CACHE_CONFIG: CacheConfig;
+/**
+ * Cache TTL presets for different data types
+ */
+export declare const CACHE_TTL: {
+    /** Short TTL - changes frequently */
+    readonly VERSION_CHECK: number;
+    readonly LATEST_RELEASE: number;
+    /** Medium TTL - changes occasionally */
+    readonly PLUGIN_INFO: number;
+    readonly CHANGELOG: number;
+    /** Long TTL - rarely changes */
+    readonly PLUGIN_METADATA: number;
+    readonly REGISTRY: number;
+};
+/**
+ * Source-specific concurrency limits
+ */
+export declare const SOURCE_CONCURRENCY: Record<string, number>;
+/**
+ * Cache store version
+ */
+export declare const CACHE_STORE_VERSION = "1.0";
+/**
+ * Create empty cache stats
+ */
+export declare function createEmptyCacheStats(): CacheStats;
+/**
+ * Cache warmer configuration
+ * @since v1.41.1
+ */
+export interface CacheWarmer<T = unknown> {
+    /** Cache key */
+    key: string;
+    /** Async function to load the data */
+    loader: () => Promise<T>;
+    /** Optional TTL for this entry */
+    ttl?: number;
+    /** Priority (higher = load first) */
+    priority?: number;
+}
+/**
+ * Extended cache stats with more detail
+ * @since v1.41.1
+ */
+export interface ExtendedCacheStats extends CacheStats {
+    /** Oldest entry timestamp */
+    oldestEntry?: number;
+    /** Newest entry timestamp */
+    newestEntry?: number;
+    /** Average entry age in ms */
+    averageAge: number;
+    /** Estimated memory usage in bytes */
+    estimatedMemoryUsage: number;
+    /** Memory pressure (0-100%) */
+    memoryPressure: number;
+    /** Number of stale entries (expired but not yet cleaned) */
+    staleEntries: number;
+}
+/**
+ * Debug export format
+ * @since v1.41.1
+ */
+export interface CacheDebugExport {
+    /** Export timestamp */
+    exportedAt: string;
+    /** Cache configuration */
+    config: CacheConfig;
+    /** Statistics */
+    stats: ExtendedCacheStats;
+    /** All entries with metadata */
+    entries: Array<{
+        key: string;
+        ttl: number;
+        age: number;
+        size: number;
+        expiresIn: number;
+        isExpired: boolean;
+    }>;
+}
+/**
+ * Cache warming result
+ * @since v1.41.1
+ */
+export interface WarmingResult {
+    /** Number of entries warmed */
+    warmed: number;
+    /** Number of entries that failed to load */
+    failed: number;
+    /** Errors encountered */
+    errors: Array<{
+        key: string;
+        error: string;
+    }>;
+    /** Time taken in ms */
+    duration: number;
+}
+/**
+ * Preload result
+ * @since v1.41.1
+ */
+export interface PreloadResult {
+    /** Keys that were loaded */
+    loaded: string[];
+    /** Keys that were already cached */
+    skipped: string[];
+    /** Keys that failed to load */
+    failed: Array<{
+        key: string;
+        error: string;
+    }>;
+}
+//# sourceMappingURL=cache-types.d.ts.map

package/dist/infrastructure/cache/cache-types.d.ts.map

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

package/dist/infrastructure/cache/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Cache Module
+ *
+ * Exports for caching, parallel execution, and performance monitoring.
+ *
+ * @since v1.29.0
+ */
+export { CACHE_STORE_VERSION, CACHE_TTL, type CacheConfig, type CacheEntry, type CacheOptions, type CacheStats, DEFAULT_CACHE_CONFIG, SOURCE_CONCURRENCY, type SerializedCache, createEmptyCacheStats, } from './cache-types.js';
+export { CacheService, generateCacheKey, getCacheService, resetCacheService } from './cache-service.js';
+export { FilePersistenceBackend, type PersistedCacheEntry, type PersistenceBackend, type PersistentCacheOptions, PersistentCacheService, getPersistentCacheService, resetPersistentCacheService, } from './persistent-cache.js';
+export { type ParallelOptions, type ParallelResult, type ProgressCallback, debounce, parallel, parallelByGroup, throttle, withRetry, withTimeout, } from './parallel.js';
+export { type AggregatedMetrics, type PerformanceMetric, PerformanceMonitor, type PerformanceReport, type TimerResult, getPerformanceMonitor, resetPerformanceMonitor, } from './performance-monitor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,eAAe,EACpB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGxG,OAAO,EACL,sBAAsB,EACtB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,sBAAsB,EACtB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,QAAQ,EACR,SAAS,EACT,WAAW,GACZ,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC"}

package/dist/infrastructure/cache/parallel.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Parallel Execution Utilities
+ *
+ * Functions for executing operations in parallel with concurrency limits.
+ *
+ * @since v1.29.0
+ */
+/**
+ * Result of a parallel operation
+ */
+export interface ParallelResult<T> {
+    /** Successful results */
+    results: T[];
+    /** Errors that occurred */
+    errors: Array<{
+        index: number;
+        error: Error;
+    }>;
+    /** Total items processed */
+    total: number;
+    /** Number of successes */
+    successes: number;
+    /** Number of failures */
+    failures: number;
+}
+/**
+ * Progress callback for parallel operations
+ */
+export type ProgressCallback = (completed: number, total: number, current?: string) => void;
+/**
+ * Options for parallel execution
+ */
+export interface ParallelOptions {
+    /** Maximum concurrent operations */
+    concurrency?: number;
+    /** Progress callback */
+    onProgress?: ProgressCallback;
+    /** Whether to stop on first error */
+    stopOnError?: boolean;
+    /** Delay between batches in milliseconds */
+    batchDelay?: number;
+}
+/**
+ * Execute operations in parallel with concurrency limit
+ */
+export declare function parallel<T, R>(items: T[], operation: (item: T, index: number) => Promise<R>, options?: ParallelOptions): Promise<ParallelResult<R>>;
+/**
+ * Execute operations grouped by a key with different concurrency per group
+ */
+export declare function parallelByGroup<T, R, K extends string>(items: T[], getGroup: (item: T) => K, operation: (item: T, index: number) => Promise<R>, options?: ParallelOptions & {
+    groupConcurrency?: Record<K, number>;
+}): Promise<ParallelResult<R>>;
+/**
+ * Execute with retry on failure
+ */
+export declare function withRetry<T>(operation: () => Promise<T>, options?: {
+    maxRetries?: number;
+    delay?: number;
+    backoff?: number;
+}): Promise<T>;
+/**
+ * Execute with timeout
+ */
+export declare function withTimeout<T>(operation: () => Promise<T>, timeoutMs: number): Promise<T>;
+/**
+ * Debounce a function
+ */
+export declare function debounce<T extends (...args: unknown[]) => unknown>(fn: T, delay: number): T;
+/**
+ * Throttle a function
+ */
+export declare function throttle<T extends (...args: unknown[]) => unknown>(fn: T, limit: number): T;
+//# sourceMappingURL=parallel.d.ts.map

package/dist/infrastructure/cache/parallel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/cache/parallel.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,yBAAyB;IACzB,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,2BAA2B;IAC3B,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;IAC/C,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAE5F;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,qCAAqC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAqD7J;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,MAAM,EAC1D,KAAK,EAAE,CAAC,EAAE,EACV,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,EACxB,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EACjD,OAAO,GAAE,eAAe,GAAG;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;CAAO,GACvE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CA4D5B;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAoBnJ;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAE/F;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAY3F;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAU3F"}