@nindroidsystems/pluginator 2.3.0

package/dist/infrastructure/cache/performance-monitor.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Performance Monitor
+ *
+ * Tracks and reports performance metrics for operations.
+ *
+ * @since v1.29.0
+ */
+/**
+ * Performance metric entry
+ */
+export interface PerformanceMetric {
+    /** Metric name */
+    name: string;
+    /** Value */
+    value: number;
+    /** Unit of measurement */
+    unit: string;
+    /** When recorded */
+    timestamp: number;
+}
+/**
+ * Timer result
+ */
+export interface TimerResult {
+    /** Duration in milliseconds */
+    duration: number;
+    /** Start time */
+    startTime: number;
+    /** End time */
+    endTime: number;
+}
+/**
+ * Aggregated metrics
+ */
+export interface AggregatedMetrics {
+    /** Average value */
+    avg: number;
+    /** Minimum value */
+    min: number;
+    /** Maximum value */
+    max: number;
+    /** Count of samples */
+    count: number;
+    /** Total sum */
+    sum: number;
+}
+/**
+ * Performance report
+ */
+export interface PerformanceReport {
+    /** Report generation time */
+    generatedAt: string;
+    /** Metrics by name */
+    metrics: Record<string, AggregatedMetrics>;
+    /** Active timers */
+    activeTimers: string[];
+    /** Memory usage */
+    memory?: {
+        heapUsed: number;
+        heapTotal: number;
+        external: number;
+        rss: number;
+    };
+}
+/**
+ * Performance monitor service
+ */
+export declare class PerformanceMonitor {
+    private metrics;
+    private timers;
+    private maxSamples;
+    constructor(options?: {
+        maxSamples?: number;
+    });
+    /**
+     * Start a timer
+     * @returns Function to stop the timer and get duration
+     */
+    startTimer(name: string): () => TimerResult;
+    /**
+     * Time an async operation
+     */
+    timeAsync<T>(name: string, operation: () => Promise<T>): Promise<{
+        result: T;
+        duration: number;
+    }>;
+    /**
+     * Time a sync operation
+     */
+    timeSync<T>(name: string, operation: () => T): {
+        result: T;
+        duration: number;
+    };
+    /**
+     * Check if a timer is running
+     */
+    isTimerRunning(name: string): boolean;
+    /**
+     * Get elapsed time for a running timer
+     */
+    getElapsed(name: string): number | null;
+    /**
+     * Record a metric
+     */
+    recordMetric(name: string, value: number, unit?: string): void;
+    /**
+     * Get metrics for a name
+     */
+    getMetrics(name: string): PerformanceMetric[];
+    /**
+     * Get aggregated metrics for a name
+     */
+    getAggregated(name: string): AggregatedMetrics | null;
+    /**
+     * Get all metric names
+     */
+    getMetricNames(): string[];
+    /**
+     * Get a full performance report
+     */
+    getReport(): PerformanceReport;
+    /**
+     * Get a formatted report string
+     */
+    getFormattedReport(): string;
+    /**
+     * Clear all metrics
+     */
+    clearMetrics(): void;
+    /**
+     * Clear metrics for a specific name
+     */
+    clearMetric(name: string): void;
+    /**
+     * Reset the monitor
+     */
+    reset(): void;
+}
+/**
+ * Get the singleton performance monitor
+ */
+export declare function getPerformanceMonitor(): PerformanceMonitor;
+/**
+ * Reset the singleton (for testing)
+ */
+export declare function resetPerformanceMonitor(): void;
+//# sourceMappingURL=performance-monitor.d.ts.map

package/dist/infrastructure/cache/performance-monitor.d.ts.map

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

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

@@ -0,0 +1,154 @@
+/**
+ * Persistent Cache Service
+ *
+ * Extends CacheService with file-based persistence for caching across sessions.
+ * Uses a two-level cache: memory (fast) + disk (persistent).
+ *
+ * @since v1.42.0
+ */
+import { CacheService } from './cache-service.js';
+import type { CacheConfig } from './cache-types.js';
+/**
+ * Cache entry stored on disk
+ */
+export interface PersistedCacheEntry<T = unknown> {
+    key: string;
+    value: T;
+    createdAt: number;
+    expiresAt: number;
+    version: number;
+}
+/**
+ * Persistence backend interface
+ */
+export interface PersistenceBackend {
+    /** Get an entry by key */
+    get<T>(key: string): Promise<PersistedCacheEntry<T> | null>;
+    /** Set an entry */
+    set<T>(key: string, entry: PersistedCacheEntry<T>): Promise<void>;
+    /** Delete an entry */
+    delete(key: string): Promise<boolean>;
+    /** Clear all entries */
+    clear(): Promise<void>;
+    /** Get all keys */
+    keys(): Promise<string[]>;
+    /** Get total size in bytes */
+    getSize(): Promise<number>;
+}
+/**
+ * File-based persistence backend
+ *
+ * Stores cache entries as JSON files in a directory structure:
+ * cacheDir/
+ *   ab/
+ *     abcd1234...json
+ *   cd/
+ *     cdef5678...json
+ */
+export declare class FilePersistenceBackend implements PersistenceBackend {
+    private readonly cacheDir;
+    private readonly version;
+    constructor(cacheDir: string, version?: number);
+    private keyToPath;
+    private pathToKey;
+    get<T>(key: string): Promise<PersistedCacheEntry<T> | null>;
+    set<T>(key: string, entry: PersistedCacheEntry<T>): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    keys(): Promise<string[]>;
+    getSize(): Promise<number>;
+}
+/**
+ * Persistent cache options
+ */
+export interface PersistentCacheOptions extends Partial<CacheConfig> {
+    /** Cache directory path */
+    cacheDir: string;
+    /** Cache version (entries with different version are invalidated) */
+    cacheVersion?: number;
+    /** Write-through: persist on every set (default: true) */
+    writeThrough?: boolean;
+    /** Read-through: check disk on memory miss (default: true) */
+    readThrough?: boolean;
+}
+/**
+ * Persistent Cache Service
+ *
+ * Two-level cache with memory and disk storage.
+ */
+export declare class PersistentCacheService extends CacheService {
+    private readonly backend;
+    private readonly cacheVersion;
+    private readonly writeThrough;
+    private readonly readThrough;
+    constructor(options: PersistentCacheOptions);
+    /**
+     * Get a value, checking disk if not in memory
+     */
+    get<T>(key: string, fetcher?: () => Promise<T>): Promise<T | undefined>;
+    /**
+     * Set a value in both memory and disk
+     */
+    set<T>(key: string, value: T, options?: {
+        ttl?: number;
+        tags?: string[];
+    }): void;
+    /**
+     * Async set that waits for persistence
+     */
+    setAsync<T>(key: string, value: T, options?: {
+        ttl?: number;
+        tags?: string[];
+    }): Promise<void>;
+    /**
+     * Persist an entry to disk
+     */
+    private persistEntry;
+    /**
+     * Invalidate from both memory and disk
+     */
+    invalidate(key: string): boolean;
+    /**
+     * Clear both memory and disk
+     */
+    clear(): void;
+    /**
+     * Clear disk cache synchronously waiting for completion
+     */
+    clearAsync(): Promise<void>;
+    /**
+     * Get all keys from both memory and disk
+     */
+    allKeys(): Promise<string[]>;
+    /**
+     * Get disk cache size in bytes
+     */
+    getDiskSize(): Promise<number>;
+    /**
+     * Load all disk entries into memory
+     */
+    warmFromDisk(): Promise<number>;
+    /**
+     * Persist all memory entries to disk
+     */
+    flushToDisk(): Promise<number>;
+    /**
+     * Get extended stats including disk info
+     */
+    getExtendedStatsWithDisk(): Promise<{
+        memory: ReturnType<CacheService['getStats']>;
+        disk: {
+            entries: number;
+            sizeBytes: number;
+        };
+    }>;
+}
+/**
+ * Get the singleton persistent cache service
+ */
+export declare function getPersistentCacheService(options?: PersistentCacheOptions): PersistentCacheService;
+/**
+ * Reset the singleton (for testing)
+ */
+export declare function resetPersistentCacheService(): void;
+//# sourceMappingURL=persistent-cache.d.ts.map

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

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

package/dist/infrastructure/checksum.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Checksum Utilities
+ *
+ * Provides hash verification for downloaded files
+ * Supports SHA-256, SHA-512, SHA-1, and MD5
+ */
+import { type BinaryLike } from 'node:crypto';
+/**
+ * Supported hash algorithms
+ */
+export type HashAlgorithm = 'sha256' | 'sha512' | 'sha1' | 'md5';
+/**
+ * Hash result with algorithm and value
+ */
+export interface HashResult {
+    algorithm: HashAlgorithm;
+    hash: string;
+}
+/**
+ * Checksum verification result
+ */
+export interface VerifyResult {
+    valid: boolean;
+    expected: string;
+    actual: string;
+    algorithm: HashAlgorithm;
+}
+/**
+ * Calculate hash of a buffer
+ */
+export declare function hashBuffer(data: BinaryLike, algorithm?: HashAlgorithm): string;
+/**
+ * Calculate hash of a string
+ */
+export declare function hashString(data: string, algorithm?: HashAlgorithm): string;
+/**
+ * Calculate hash of a file (loads entire file into memory)
+ * Use for small files < 100MB
+ */
+export declare function hashFile(filePath: string, algorithm?: HashAlgorithm): Promise<string>;
+/**
+ * Calculate hash of a file using streams (memory efficient)
+ * Use for large files
+ */
+export declare function hashFileStream(filePath: string, algorithm?: HashAlgorithm): Promise<string>;
+/**
+ * Calculate multiple hashes of a file in a single pass
+ */
+export declare function hashFileMultiple(filePath: string, algorithms?: HashAlgorithm[]): Promise<Map<HashAlgorithm, string>>;
+/**
+ * Verify a file's checksum against an expected value
+ */
+export declare function verifyChecksum(filePath: string, expected: string, algorithm?: HashAlgorithm): Promise<VerifyResult>;
+/**
+ * Verify multiple checksums for a file
+ * Returns true only if all provided checksums match
+ */
+export declare function verifyChecksums(filePath: string, checksums: Partial<Record<HashAlgorithm, string>>): Promise<{
+    valid: boolean;
+    results: VerifyResult[];
+}>;
+/**
+ * Detect hash algorithm from hash string length
+ */
+export declare function detectAlgorithm(hash: string): HashAlgorithm;
+/**
+ * Check if a string looks like a valid hash
+ */
+export declare function isValidHashFormat(hash: string, algorithm?: HashAlgorithm): boolean;
+/**
+ * Format a hash for display (truncated with ellipsis)
+ */
+export declare function formatHash(hash: string, maxLength?: number): string;
+/**
+ * Calculate hash of an entire directory
+ *
+ * Recursively hashes all files and combines them into a single hash.
+ * File paths are included in the hash to detect renames/moves.
+ *
+ * @since v1.41.0
+ */
+export declare function hashDirectory(dirPath: string, algorithm?: HashAlgorithm): Promise<string>;
+/**
+ * Compare two hash strings using timing-safe comparison
+ *
+ * This prevents timing attacks where an attacker could infer
+ * the correct hash by measuring comparison time.
+ *
+ * @since v1.41.4
+ */
+export declare function hashesEqual(a: string, b: string): boolean;
+//# sourceMappingURL=checksum.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.d.ts","sourceRoot":"","sources":["../../src/infrastructure/checksum.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,UAAU,EAA+B,MAAM,aAAa,CAAC;AAI3E;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,aAAa,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,aAAa,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,GAAE,aAAwB,GAAG,MAAM,CAExF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,aAAwB,GAAG,MAAM,CAEpF;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,aAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAGrG;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,aAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmB3G;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAE,aAAa,EAAsB,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CA6B7I;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAczH;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC,CA4B/J;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAc3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,aAAa,GAAG,OAAO,CAmBlF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAK,GAAG,MAAM,CAM/D;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,aAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqCzG;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CA0BzD"}

package/dist/infrastructure/crypto-security.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Crypto Security Utilities
+ *
+ * Additional security measures for cryptographic operations:
+ * - Memory protection (secure buffer zeroing)
+ * - Session integrity verification (HMAC-based)
+ */
+/**
+ * Securely zero a buffer's contents to prevent key material from
+ * lingering in memory after use.
+ *
+ * Note: This provides best-effort protection. JavaScript's garbage
+ * collector may still retain copies of sensitive data in memory.
+ * For maximum security, use native crypto libraries that handle
+ * key material in secure memory regions.
+ */
+export declare function secureZeroBuffer(buffer: Buffer): void;
+/**
+ * Create an HMAC of the session file path using the encryption key.
+ * This is used to detect if a session file has been moved/copied
+ * to a different location (potential tampering or session theft).
+ *
+ * @param sessionPath - Absolute path to the session file
+ * @param key - The encryption key (32 bytes)
+ * @returns HMAC as hex string
+ */
+export declare function createSessionHmac(sessionPath: string, key: Buffer): string;
+/**
+ * Verify that a session file is in its original location by
+ * comparing the stored HMAC with a freshly computed one.
+ *
+ * Uses timing-safe comparison to prevent timing attacks.
+ *
+ * @param sessionPath - Current absolute path to the session file
+ * @param key - The encryption key (32 bytes)
+ * @param storedHmac - The HMAC that was stored with the session
+ * @returns true if the session is in its original location
+ */
+export declare function verifySessionIntegrity(sessionPath: string, key: Buffer, storedHmac: string): boolean;
+//# sourceMappingURL=crypto-security.d.ts.map

package/dist/infrastructure/crypto-security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-security.d.ts","sourceRoot":"","sources":["../../src/infrastructure/crypto-security.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAErD;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAI1E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAapG"}

package/dist/infrastructure/crypto.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Crypto Utilities
+ *
+ * Provides AES-256-GCM encryption/decryption for token storage at rest.
+ * Uses PBKDF2 for key derivation from machine-specific identifiers.
+ */
+/**
+ * Encrypted data structure for storage
+ */
+export interface EncryptedData {
+    /** Base64-encoded 12-byte IV (96 bits for GCM) */
+    iv: string;
+    /** Base64-encoded 16-byte authentication tag */
+    authTag: string;
+    /** Base64-encoded ciphertext */
+    ciphertext: string;
+}
+/**
+ * Encrypt plaintext using AES-256-GCM
+ *
+ * @param plaintext - The string to encrypt
+ * @param key - 32-byte encryption key
+ * @returns Encrypted data with IV, auth tag, and ciphertext
+ */
+export declare function encrypt(plaintext: string, key: Buffer): EncryptedData;
+/**
+ * Decrypt data encrypted with AES-256-GCM
+ *
+ * @param data - Encrypted data structure
+ * @param key - 32-byte encryption key (must match encryption key)
+ * @returns Decrypted plaintext
+ * @throws Error if decryption fails (wrong key, corrupted data, or tampered)
+ */
+export declare function decrypt(data: EncryptedData, key: Buffer): string;
+/**
+ * Derive a 256-bit encryption key using PBKDF2
+ *
+ * @param machineId - Machine identifier string
+ * @param salt - Random salt (should be stored alongside encrypted data)
+ * @param iterations - PBKDF2 iterations (default: 100000)
+ * @returns 32-byte key buffer
+ */
+export declare function deriveKey(machineId: string, salt: Buffer, iterations?: number): Buffer;
+//# sourceMappingURL=crypto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../src/infrastructure/crypto.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,CAkBrE;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAahE;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,SAAS,GAAG,MAAM,CAEtF"}

package/dist/infrastructure/format.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Formatting Utilities
+ *
+ * Provides utilities for formatting values in human-readable formats.
+ */
+/**
+ * Options for formatting bytes
+ */
+export interface FormatBytesOptions {
+    /** Number of decimal places (default: 2) */
+    decimals?: number;
+    /** Threshold for switching units - use 1024 for binary, 1000 for decimal (default: 1024) */
+    threshold?: number;
+    /** Whether to include a space between number and unit (default: true) */
+    space?: boolean;
+}
+/**
+ * Format a byte count into a human-readable string
+ *
+ * @param bytes - The number of bytes to format
+ * @param options - Formatting options
+ * @returns Formatted string (e.g., "1.24 MB", "512 KB")
+ *
+ * @example
+ * formatBytes(0)           // "0 B"
+ * formatBytes(500)         // "500 B"
+ * formatBytes(1024)        // "1.00 KB"
+ * formatBytes(1536)        // "1.50 KB"
+ * formatBytes(1048576)     // "1.00 MB"
+ * formatBytes(1073741824)  // "1.00 GB"
+ * formatBytes(1536, { decimals: 1 }) // "1.5 KB"
+ */
+export declare function formatBytes(bytes: number, options?: FormatBytesOptions): string;
+/**
+ * Format bytes with automatic precision adjustment
+ * Uses fewer decimal places for larger numbers
+ *
+ * @param bytes - The number of bytes to format
+ * @returns Formatted string with smart precision
+ *
+ * @example
+ * formatBytesAuto(1536)      // "1.50 KB"
+ * formatBytesAuto(15360)     // "15.0 KB"
+ * formatBytesAuto(153600)    // "150 KB"
+ */
+export declare function formatBytesAuto(bytes: number): string;
+/**
+ * Format a download progress as a string
+ *
+ * @param downloaded - Bytes downloaded
+ * @param total - Total bytes (0 if unknown)
+ * @returns Formatted progress string
+ *
+ * @example
+ * formatDownloadProgress(1048576, 10485760) // "1.00 MB / 10.00 MB"
+ * formatDownloadProgress(1048576, 0)         // "1.00 MB"
+ */
+export declare function formatDownloadProgress(downloaded: number, total: number): string;
+/**
+ * Format a percentage value
+ *
+ * @param value - The percentage (0-100)
+ * @param decimals - Number of decimal places (default: 0)
+ * @returns Formatted percentage string
+ *
+ * @example
+ * formatPercent(50)     // "50%"
+ * formatPercent(33.333) // "33%"
+ * formatPercent(33.333, 1) // "33.3%"
+ */
+export declare function formatPercent(value: number, decimals?: number): string;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/infrastructure/format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAOD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAqBnF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAsBrD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAShF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAGjE"}