promidas 2.0.0

package/dist/fetcher/client/fetch-with-progress.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Custom fetch function factory with download progress tracking.
+ *
+ * This module provides a factory function that creates a custom fetch wrapper
+ * which monitors the complete request lifecycle and provides event-based
+ * progress tracking for UI updates and logging.
+ *
+ * @module
+ */
+import type { Logger } from '../../logger/index.js';
+import type { FetchProgressEvent } from '../types/progress-event.types.js';
+/**
+ * Check if the logger should output progress logs based on its current level.
+ *
+ * This function is used to control direct stderr output (process.stderr.write)
+ * which bypasses the logger's internal level filtering. For logger.info() calls,
+ * the logger itself handles level filtering.
+ *
+ * @param logger - Logger instance to check
+ * @returns true if progress logs should be output, false otherwise
+ *
+ * @remarks
+ * - Used only for process.stderr.write() calls, not for logger.info()
+ * - If the logger has a 'level' property, checks if it's 'debug' or 'info'
+ * - If no 'level' property exists, assumes logging should be enabled
+ *
+ * @example
+ * ```typescript
+ * const logger = new ConsoleLogger('warn');
+ * shouldProgressLog(logger); // false (warn > info)
+ *
+ * const debugLogger = new ConsoleLogger('debug');
+ * shouldProgressLog(debugLogger); // true (debug <= info)
+ * ```
+ */
+export declare function shouldProgressLog(logger: Logger): boolean;
+/**
+ * Configuration for creating a fetch function with progress tracking.
+ *
+ * @remarks
+ * This interface defines all options needed to create a custom fetch wrapper
+ * that monitors the complete request lifecycle through event callbacks.
+ *
+ * @example Basic usage with logging
+ * ```typescript
+ * const customFetch = createFetchWithProgress({
+ *   logger: myLogger,
+ *   enableProgressLog: true,
+ * });
+ * ```
+ *
+ * @example With event callback for UI updates
+ * ```typescript
+ * const customFetch = createFetchWithProgress({
+ *   logger: myLogger,
+ *   enableProgressLog: false,
+ *   onProgressEvent: (event) => {
+ *     if (event.type === 'download-progress') {
+ *       updateProgressBar(event.percentage);
+ *     }
+ *   },
+ * });
+ * ```
+ */
+export interface FetchWithProgressConfig {
+    /**
+     * Logger instance for progress output.
+     */
+    logger: Logger;
+    /**
+     * Whether to log progress to the logger.
+     */
+    enableProgressLog: boolean;
+    /**
+     * Base fetch function to wrap with progress tracking.
+     * If not provided, uses global fetch.
+     */
+    baseFetch?: typeof fetch;
+    /**
+     * Optional callback for progress events.
+     *
+     * Receives all lifecycle events:
+     * - request-start
+     * - response-received
+     * - download-progress (throttled to 500ms)
+     * - complete
+     *
+     * @param event - Progress event with type-specific data
+     */
+    onProgressEvent?: (event: FetchProgressEvent) => void;
+}
+/**
+ * Create a custom fetch function with complete lifecycle progress tracking.
+ *
+ * This factory function creates a fetch wrapper that monitors the entire request
+ * lifecycle and provides real-time feedback through event callbacks and/or logging.
+ * The returned function is compatible with the standard fetch API signature.
+ *
+ * @param config - Configuration object containing logger and callback options
+ * @returns A fetch-compatible function with progress tracking capabilities
+ *
+ * @remarks
+ * The returned fetch function:
+ * - Maintains the same signature as standard fetch
+ * - Fires events for all lifecycle phases: request-start, response-received, download-progress, complete
+ * - Wraps response body with a ReadableStream that tracks bytes received
+ * - Throttles progress updates to 500ms intervals to avoid overhead
+ * - Automatically estimates download size based on URL parameters (limit × 2670 bytes)
+ * - Works in both Node.js (using process.stderr for live updates) and browser environments
+ *
+ * Progress tracking behavior:
+ * - If `enableProgressLog` is true and logger level is 'debug' or 'info', logs progress messages
+ * - If `onProgressEvent` callback is provided, fires events regardless of log level
+ * - If neither logging nor callback are enabled, returns response without tracking overhead
+ *
+ * @example With progress logging
+ * ```typescript
+ * const customFetch = createFetchWithProgress({
+ *   logger: myLogger,
+ *   enableProgressLog: true,
+ * });
+ *
+ * // Use like standard fetch
+ * const response = await customFetch('https://api.example.com/data?limit=1000');
+ * const data = await response.json();
+ * ```
+ *
+ * @example With custom event handler
+ * ```typescript
+ * let progressBar: ProgressBar | null = null;
+ *
+ * const customFetch = createFetchWithProgress({
+ *   logger: myLogger,
+ *   enableProgressLog: false,
+ *   onProgressEvent: (event) => {
+ *     switch (event.type) {
+ *       case 'request-start':
+ *         console.log('Starting request...');
+ *         break;
+ *       case 'response-received':
+ *         progressBar = new ProgressBar({ total: event.estimatedTotal });
+ *         break;
+ *       case 'download-progress':
+ *         progressBar?.update(event.percentage);
+ *         break;
+ *       case 'complete':
+ *         progressBar?.complete();
+ *         console.log(`Downloaded ${event.received} bytes in ${event.totalTimeMs}ms`);
+ *         break;
+ *     }
+ *   },
+ * });
+ * ```
+ */
+export declare function createFetchWithProgress(config: FetchWithProgressConfig): typeof fetch;
+//# sourceMappingURL=fetch-with-progress.d.ts.map

package/dist/fetcher/client/fetch-with-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-with-progress.d.ts","sourceRoot":"","sources":["../../../lib/fetcher/client/fetch-with-progress.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAMzD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAEzB;;;;;;;;;;OAUG;IACH,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;CACvD;AAyCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,uBAAuB,GAC9B,OAAO,KAAK,CAgNd"}

package/dist/fetcher/client/fetch-with-progress.js

@@ -0,0 +1,313 @@
+/**
+ * Custom fetch function factory with download progress tracking.
+ *
+ * This module provides a factory function that creates a custom fetch wrapper
+ * which monitors the complete request lifecycle and provides event-based
+ * progress tracking for UI updates and logging.
+ *
+ * @module
+ */
+/**
+ * Check if the logger should output progress logs based on its current level.
+ *
+ * This function is used to control direct stderr output (process.stderr.write)
+ * which bypasses the logger's internal level filtering. For logger.info() calls,
+ * the logger itself handles level filtering.
+ *
+ * @param logger - Logger instance to check
+ * @returns true if progress logs should be output, false otherwise
+ *
+ * @remarks
+ * - Used only for process.stderr.write() calls, not for logger.info()
+ * - If the logger has a 'level' property, checks if it's 'debug' or 'info'
+ * - If no 'level' property exists, assumes logging should be enabled
+ *
+ * @example
+ * ```typescript
+ * const logger = new ConsoleLogger('warn');
+ * shouldProgressLog(logger); // false (warn > info)
+ *
+ * const debugLogger = new ConsoleLogger('debug');
+ * shouldProgressLog(debugLogger); // true (debug <= info)
+ * ```
+ */
+export function shouldProgressLog(logger) {
+    if ('level' in logger && typeof logger.level === 'string') {
+        const level = logger.level;
+        return level === 'debug' || level === 'info';
+    }
+    return true;
+}
+/**
+ * Estimate total response size from URL parameters.
+ *
+ * Uses empirical data to estimate the total download size based on the
+ * limit parameter in the query string.
+ *
+ * @param url - Request URL
+ * @returns Estimated size in bytes and item count (both 0 if cannot estimate)
+ */
+function estimateTotalSize(url) {
+    try {
+        const urlObj = new URL(url);
+        const limitParam = urlObj.searchParams.get('limit');
+        if (!limitParam) {
+            return { estimatedSize: 0, itemCount: 0 };
+        }
+        const limit = parseInt(limitParam, 10);
+        if (isNaN(limit) || limit <= 0) {
+            return { estimatedSize: 0, itemCount: 0 };
+        }
+        // Average prototype size: approximately 2670 bytes per item
+        // Based on 5,000 sample data from ProtoPedia API (13,350,369 bytes / 5,000 items)
+        const AVERAGE_PROTOTYPE_SIZE = 2670;
+        return {
+            estimatedSize: limit * AVERAGE_PROTOTYPE_SIZE,
+            itemCount: limit,
+        };
+    }
+    catch (error) {
+        return { estimatedSize: 0, itemCount: 0 };
+    }
+}
+/**
+ * Create a custom fetch function with complete lifecycle progress tracking.
+ *
+ * This factory function creates a fetch wrapper that monitors the entire request
+ * lifecycle and provides real-time feedback through event callbacks and/or logging.
+ * The returned function is compatible with the standard fetch API signature.
+ *
+ * @param config - Configuration object containing logger and callback options
+ * @returns A fetch-compatible function with progress tracking capabilities
+ *
+ * @remarks
+ * The returned fetch function:
+ * - Maintains the same signature as standard fetch
+ * - Fires events for all lifecycle phases: request-start, response-received, download-progress, complete
+ * - Wraps response body with a ReadableStream that tracks bytes received
+ * - Throttles progress updates to 500ms intervals to avoid overhead
+ * - Automatically estimates download size based on URL parameters (limit × 2670 bytes)
+ * - Works in both Node.js (using process.stderr for live updates) and browser environments
+ *
+ * Progress tracking behavior:
+ * - If `enableProgressLog` is true and logger level is 'debug' or 'info', logs progress messages
+ * - If `onProgressEvent` callback is provided, fires events regardless of log level
+ * - If neither logging nor callback are enabled, returns response without tracking overhead
+ *
+ * @example With progress logging
+ * ```typescript
+ * const customFetch = createFetchWithProgress({
+ *   logger: myLogger,
+ *   enableProgressLog: true,
+ * });
+ *
+ * // Use like standard fetch
+ * const response = await customFetch('https://api.example.com/data?limit=1000');
+ * const data = await response.json();
+ * ```
+ *
+ * @example With custom event handler
+ * ```typescript
+ * let progressBar: ProgressBar | null = null;
+ *
+ * const customFetch = createFetchWithProgress({
+ *   logger: myLogger,
+ *   enableProgressLog: false,
+ *   onProgressEvent: (event) => {
+ *     switch (event.type) {
+ *       case 'request-start':
+ *         console.log('Starting request...');
+ *         break;
+ *       case 'response-received':
+ *         progressBar = new ProgressBar({ total: event.estimatedTotal });
+ *         break;
+ *       case 'download-progress':
+ *         progressBar?.update(event.percentage);
+ *         break;
+ *       case 'complete':
+ *         progressBar?.complete();
+ *         console.log(`Downloaded ${event.received} bytes in ${event.totalTimeMs}ms`);
+ *         break;
+ *     }
+ *   },
+ * });
+ * ```
+ */
+export function createFetchWithProgress(config) {
+    const { logger, enableProgressLog, baseFetch, onProgressEvent } = config;
+    return async (url, init) => {
+        // State for this request (reset for each request)
+        let lastLoggedPercentage = -1;
+        let lastLoggedReceived = 0;
+        let lastLoggedTime = 0;
+        let isEstimatedSize = false;
+        let estimatedItemCount = 0;
+        // Start timing before fetch call
+        const requestStartTime = Date.now();
+        // Fire request-start event
+        if (enableProgressLog && shouldProgressLog(logger)) {
+            logger.info('Request starting...');
+        }
+        onProgressEvent?.({ type: 'request-start' });
+        // Use provided baseFetch or globalThis.fetch (allows mocking in tests)
+        const fetchFn = baseFetch ?? globalThis.fetch;
+        const response = await fetchFn(url, init);
+        // Calculate preparation time (request + response headers)
+        const bodyStartTime = Date.now();
+        const prepareTimeMs = bodyStartTime - requestStartTime;
+        // Get Content-Length header to calculate progress
+        const contentLength = response.headers.get('Content-Length');
+        let total = contentLength ? parseInt(contentLength, 10) : 0;
+        if (isNaN(total)) {
+            total = 0;
+        }
+        // Estimate item count from URL parameters
+        const estimation = estimateTotalSize(url.toString());
+        estimatedItemCount = estimation.itemCount;
+        // If Content-Length is not available, use estimation for total
+        if (total === 0) {
+            total = estimation.estimatedSize;
+            isEstimatedSize = total > 0; // Mark as estimated if we got a value
+        }
+        // Fire response-received event
+        if (enableProgressLog && total > 0 && shouldProgressLog(logger)) {
+            const sizeNote = isEstimatedSize ? ' (estimated)' : '';
+            logger.info(`Response received (${prepareTimeMs}ms) - ${total} bytes${sizeNote}, limit=${estimatedItemCount}`);
+        }
+        onProgressEvent?.({
+            type: 'response-received',
+            prepareTimeMs,
+            estimatedTotal: total,
+            limit: estimatedItemCount,
+        });
+        // If no body, fire complete event and return response as-is
+        if (!response.body) {
+            const completionTime = Date.now();
+            const totalTimeMs = completionTime - requestStartTime;
+            if (enableProgressLog && shouldProgressLog(logger)) {
+                const message = isEstimatedSize
+                    ? `Download complete: 0 bytes received (estimated ${total} bytes) in 0ms (total: ${totalTimeMs}ms)`
+                    : `Download complete: 0 / ${total} bytes received in 0ms (total: ${totalTimeMs}ms)`;
+                if (typeof process !== 'undefined' && process.stderr?.write) {
+                    process.stderr.write(`\r${message}\n`);
+                }
+                else {
+                    logger.info(message);
+                }
+            }
+            onProgressEvent?.({
+                type: 'complete',
+                received: 0,
+                estimatedTotal: total,
+                downloadTimeMs: 0,
+                totalTimeMs,
+            });
+            return response;
+        }
+        // Create a new ReadableStream that monitors progress
+        const reader = response.body.getReader();
+        let received = 0;
+        const stream = new ReadableStream({
+            async start(controller) {
+                try {
+                    while (true) {
+                        const { done, value } = await reader.read();
+                        if (done) {
+                            // Finish progress logging
+                            const completionTime = Date.now();
+                            const totalElapsedMs = completionTime - requestStartTime;
+                            const bodyElapsedMs = completionTime - bodyStartTime;
+                            if (enableProgressLog && shouldProgressLog(logger)) {
+                                // Show final progress (always output, regardless of time)
+                                const message = isEstimatedSize
+                                    ? `Download complete: ${received} bytes received (estimated ${total} bytes) in ${bodyElapsedMs}ms (total: ${totalElapsedMs}ms)`
+                                    : `Download complete: ${received} / ${total} bytes received in ${bodyElapsedMs}ms (total: ${totalElapsedMs}ms)`;
+                                // In Node.js, overwrite the progress line with \r; in browsers, use logger
+                                if (typeof process !== 'undefined' && process.stderr?.write) {
+                                    process.stderr.write(`\r${message}\n`);
+                                }
+                                else {
+                                    logger.info(message);
+                                }
+                            }
+                            // Fire complete event
+                            onProgressEvent?.({
+                                type: 'complete',
+                                received,
+                                estimatedTotal: total,
+                                downloadTimeMs: bodyElapsedMs,
+                                totalTimeMs: totalElapsedMs,
+                            });
+                            controller.close();
+                            break;
+                        }
+                        received += value.length;
+                        // Notify progress with time-based throttling (500ms)
+                        const percentage = total > 0 ? (received / total) * 100 : 0;
+                        const now = Date.now();
+                        const timeElapsed = now - lastLoggedTime;
+                        const isFirstLog = lastLoggedTime === 0;
+                        if (isFirstLog || timeElapsed >= 500) {
+                            // Log progress if enabled
+                            if (enableProgressLog && shouldProgressLog(logger)) {
+                                const delta = received - lastLoggedReceived;
+                                const estimatedNote = isEstimatedSize && isFirstLog ? ' (estimated)' : '';
+                                const message = `Download progress: ${percentage.toFixed(1)}%${estimatedNote} (${received} / ${total} bytes, +${delta})`;
+                                // Write to stderr with \r to overwrite the same line (Node.js only)
+                                if (typeof process !== 'undefined' && process.stderr?.write) {
+                                    process.stderr.write(`\r${message}`);
+                                }
+                                else {
+                                    logger.info(message);
+                                }
+                            }
+                            // Fire download-progress event
+                            onProgressEvent?.({
+                                type: 'download-progress',
+                                received,
+                                total,
+                                percentage,
+                            });
+                            lastLoggedPercentage = percentage;
+                            lastLoggedReceived = received;
+                            lastLoggedTime = now;
+                        }
+                        controller.enqueue(value);
+                    }
+                }
+                catch (error) {
+                    const completionTime = Date.now();
+                    const totalElapsedMs = completionTime - requestStartTime;
+                    const bodyElapsedMs = completionTime - bodyStartTime;
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    if (enableProgressLog && shouldProgressLog(logger)) {
+                        const message = `Download error: ${errorMessage} (${totalElapsedMs}ms)`;
+                        if (typeof process !== 'undefined' && process.stderr?.write) {
+                            process.stderr.write(`\r${message}\n`);
+                        }
+                        else {
+                            logger.error(message);
+                        }
+                    }
+                    // Fire error event
+                    onProgressEvent?.({
+                        type: 'error',
+                        error: errorMessage,
+                        received,
+                        estimatedTotal: total,
+                        downloadTimeMs: bodyElapsedMs,
+                        totalTimeMs: totalElapsedMs,
+                    });
+                    controller.error(error);
+                }
+            },
+        });
+        // Create new response with monitored stream
+        return new Response(stream, {
+            status: response.status,
+            statusText: response.statusText,
+            headers: response.headers,
+        });
+    };
+}
+//# sourceMappingURL=fetch-with-progress.js.map

package/dist/fetcher/client/fetch-with-progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-with-progress.js","sourceRoot":"","sources":["../../../lib/fetcher/client/fetch-with-progress.ts"],"names":[],"mappings":"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"}

package/dist/fetcher/client/fetch-with-timeout.d.ts

@@ -0,0 +1,6 @@
+export interface FetchWithTimeoutConfig {
+    timeoutMs: number;
+    baseFetch?: typeof fetch | undefined;
+}
+export declare function createFetchWithTimeout(config: FetchWithTimeoutConfig): typeof fetch;
+//# sourceMappingURL=fetch-with-timeout.d.ts.map

package/dist/fetcher/client/fetch-with-timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-with-timeout.d.ts","sourceRoot":"","sources":["../../../lib/fetcher/client/fetch-with-timeout.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,KAAK,GAAG,SAAS,CAAC;CACtC;AAMD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,sBAAsB,GAC7B,OAAO,KAAK,CA+Cd"}

package/dist/fetcher/client/fetch-with-timeout.js

@@ -0,0 +1,48 @@
+import { PromidasTimeoutError } from '../errors/fetcher-error.js';
+function isAbortError(error) {
+    return error instanceof DOMException && error.name === 'AbortError';
+}
+export function createFetchWithTimeout(config) {
+    const { timeoutMs, baseFetch } = config;
+    return async (url, init) => {
+        const fetchFn = baseFetch ?? globalThis.fetch;
+        const controller = new AbortController();
+        const timeoutError = new PromidasTimeoutError(timeoutMs);
+        const abortFromCaller = () => {
+            // Preserve caller-provided abort reason when available
+            controller.abort(init?.signal?.reason);
+        };
+        if (init?.signal?.aborted) {
+            abortFromCaller();
+        }
+        else if (init?.signal) {
+            init.signal.addEventListener('abort', abortFromCaller, { once: true });
+        }
+        const timeoutId = setTimeout(() => {
+            controller.abort(timeoutError);
+        }, timeoutMs);
+        try {
+            return await fetchFn(url, {
+                ...init,
+                signal: controller.signal,
+            });
+        }
+        catch (error) {
+            // Some runtimes may reject with AbortError instead of the abort reason.
+            if (error === timeoutError) {
+                throw error;
+            }
+            if (isAbortError(error) && controller.signal.reason === timeoutError) {
+                throw timeoutError;
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timeoutId);
+            if (init?.signal) {
+                init.signal.removeEventListener('abort', abortFromCaller);
+            }
+        }
+    };
+}
+//# sourceMappingURL=fetch-with-timeout.js.map

package/dist/fetcher/client/fetch-with-timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-with-timeout.js","sourceRoot":"","sources":["../../../lib/fetcher/client/fetch-with-timeout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAOlE,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,MAA8B;IAE9B,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAExC,OAAO,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACzB,MAAM,OAAO,GAAG,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC;QAE9C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,YAAY,GAAG,IAAI,oBAAoB,CAAC,SAAS,CAAC,CAAC;QAEzD,MAAM,eAAe,GAAG,GAAG,EAAE;YAC3B,uDAAuD;YACvD,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC,CAAC;QAEF,IAAI,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;YAC1B,eAAe,EAAE,CAAC;QACpB,CAAC;aAAM,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAChC,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACjC,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,GAAG,EAAE;gBACxB,GAAG,IAAI;gBACP,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,wEAAwE;YACxE,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;gBAC3B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,IAAI,YAAY,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;gBACrE,MAAM,YAAY,CAAC;YACrB,CAAC;YAED,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;gBACjB,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}