mongodash 2.0.0 → 2.1.1

package/dist/lib/src/reactiveTasks/ReactiveTaskRepository.js

@@ -0,0 +1,348 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReactiveTaskRepository = void 0;
+const OnError_1 = require("../OnError");
+const OnInfo_1 = require("../OnInfo");
+const processInBatches_1 = require("../processInBatches");
+const ReactiveTaskTypes_1 = require("./ReactiveTaskTypes");
+/**
+ * Handles all database interactions for reactive tasks.
+ *
+ * Responsibilities:
+ * - Generates MongoDB operations for creating, updating, and deleting tasks.
+ * - Manages task state transitions (pending -> processing -> completed/failed).
+ * - Implements the locking mechanism for task execution.
+ * - Handles task finalization (retries, completion, failure).
+ * - Manages database indexes for performance.
+ * - Cleans up orphaned tasks.
+ */
+class ReactiveTaskRepository {
+    constructor(tasksCollection, onInfo = OnInfo_1.defaultOnInfo, onError = OnError_1.defaultOnError) {
+        this.tasksCollection = tasksCollection;
+        this.onInfo = onInfo;
+        this.onError = onError;
+        this.initPromise = this.ensureIndexes();
+    }
+    async findAndLockNextTask(taskDefs, options) {
+        const now = new Date();
+        const lockExpiresAt = new Date(now.getTime() + options.visibilityTimeoutMs);
+        const filter = {
+            task: { $in: taskDefs.map((c) => c.task) },
+            $or: [
+                {
+                    status: { $in: ['pending', 'processing_dirty'] },
+                    scheduledAt: { $lte: now },
+                    $or: [{ lockExpiresAt: { $lt: now } }, { lockExpiresAt: { $exists: false } }, { lockExpiresAt: null }],
+                },
+                {
+                    status: 'processing',
+                    lockExpiresAt: { $lt: now },
+                },
+            ],
+        };
+        const update = {
+            $set: {
+                status: 'processing',
+                lockExpiresAt: lockExpiresAt,
+                startedAt: now,
+            },
+            $inc: { attempts: 1 },
+        };
+        try {
+            const result = await this.tasksCollection.findOneAndUpdate(filter, update, {
+                sort: { scheduledAt: 1 },
+                returnDocument: 'after',
+                includeResultMetadata: true,
+            });
+            // In MongoDB v4, findOneAndUpdate returns { value: T } by default.
+            // In MongoDB v6+, if includeResultMetadata: true, it returns { value: T }.
+            // If we cast options to any, TS might infer return type as Document or ModifyResult depending on library version.
+            // We treat 'result' as any or check strictly.
+            // result is derived from findOneAndUpdate which is generic.
+            // Should be safe to access .value if runtime behaves as expected.
+            return result.value || null;
+        }
+        catch (error) {
+            this.onError(error);
+            return null;
+        }
+    }
+    async finalizeTask(taskRecord, strategy, error, debounceMs = 1000, executionStats, executionHistoryLimit = 5) {
+        var _a;
+        const isError = !!error;
+        const errorMessage = (error === null || error === void 0 ? void 0 : error.message) || 'Unknown error';
+        // Determine First Error At
+        let firstErrorAt = taskRecord.firstErrorAt;
+        if (isError && !firstErrorAt) {
+            firstErrorAt = new Date();
+        }
+        else if (!isError) {
+            firstErrorAt = null; // Reset on success
+        }
+        const attempts = taskRecord.attempts || 0;
+        const shouldFail = isError && strategy.shouldFail(attempts, firstErrorAt);
+        const nextRetryScheduledAt = isError && !shouldFail ? strategy.calculateNextRetry(attempts) : null;
+        const updateSet = {
+            status: {
+                $cond: {
+                    if: { $eq: ['$status', 'processing_dirty'] },
+                    then: 'pending',
+                    else: isError ? (shouldFail ? 'failed' : 'pending') : 'completed',
+                },
+            },
+            scheduledAt: {
+                $cond: {
+                    if: { $eq: ['$status', 'processing_dirty'] },
+                    then: { $add: ['$updatedAt', debounceMs] },
+                    else: isError ? (shouldFail ? '$scheduledAt' : nextRetryScheduledAt) : '$scheduledAt',
+                },
+            },
+            completedAt: {
+                $cond: {
+                    if: { $eq: ['$status', 'processing_dirty'] },
+                    then: '$completedAt',
+                    else: isError ? '$completedAt' : new Date(),
+                },
+            },
+            lockExpiresAt: null,
+            firstErrorAt: {
+                $cond: {
+                    if: { $eq: ['$status', 'processing_dirty'] },
+                    then: '$firstErrorAt',
+                    else: firstErrorAt,
+                },
+            },
+            lastError: {
+                $cond: {
+                    if: { $eq: ['$status', 'processing_dirty'] },
+                    then: '$lastError',
+                    else: isError ? errorMessage : null,
+                },
+            },
+            lastFinalizedAt: new Date(),
+        };
+        const durationMs = (_a = executionStats === null || executionStats === void 0 ? void 0 : executionStats.durationMs) !== null && _a !== void 0 ? _a : 0;
+        const historyEntry = Object.assign({ at: new Date(), status: isError ? 'failed' : 'completed', durationMs: durationMs }, (isError ? { error: errorMessage } : {}));
+        if (!isError) {
+            updateSet.lastSuccess = {
+                at: new Date(),
+                durationMs: durationMs,
+            };
+        }
+        await this.tasksCollection.updateOne({ _id: taskRecord._id }, [
+            {
+                $set: updateSet,
+            },
+            {
+                $set: {
+                    executionHistory: {
+                        $slice: [
+                            {
+                                $concatArrays: [{ $ifNull: ['$executionHistory', []] }, [historyEntry]],
+                            },
+                            -executionHistoryLimit, // Keep last N
+                        ],
+                    },
+                },
+            },
+        ]);
+    }
+    async deferTask(taskRecord, delay) {
+        var _a;
+        const now = Date.now();
+        const newScheduledAt = typeof delay === 'number' ? new Date(now + delay) : delay;
+        const originalScheduledAt = (_a = taskRecord.initialScheduledAt) !== null && _a !== void 0 ? _a : taskRecord.scheduledAt;
+        await this.tasksCollection.updateOne({ _id: taskRecord._id }, {
+            $set: {
+                status: 'pending',
+                scheduledAt: newScheduledAt,
+                initialScheduledAt: originalScheduledAt,
+                lockExpiresAt: null,
+                attempts: 0,
+            },
+        });
+    }
+    async executeBulkWrite(operations, options) {
+        await this.tasksCollection.bulkWrite(operations, options || {});
+    }
+    async findTasks(filter, options = {}) {
+        return this.tasksCollection.find(filter, options).toArray();
+    }
+    async countTasks(filter) {
+        return this.tasksCollection.countDocuments(filter);
+    }
+    async updateTasks(filter, update) {
+        const result = await this.tasksCollection.updateMany(filter, update);
+        return {
+            matchedCount: result.matchedCount,
+            modifiedCount: result.modifiedCount,
+        };
+    }
+    async resetTasks(filter) {
+        const updatePipeline = [
+            {
+                $set: {
+                    updatedAt: '$$NOW',
+                    status: {
+                        $cond: {
+                            if: { $in: ['$status', ['processing', 'processing_dirty']] },
+                            then: 'processing_dirty',
+                            else: 'pending',
+                        },
+                    },
+                    scheduledAt: {
+                        $cond: {
+                            if: { $in: ['$status', ['processing', 'processing_dirty']] },
+                            then: '$scheduledAt',
+                            else: '$$NOW',
+                        },
+                    },
+                    // Preserve history - don't reset attempts, firstErrorAt, or lastError
+                    initialScheduledAt: { $ifNull: ['$initialScheduledAt', '$scheduledAt'] },
+                },
+            },
+        ];
+        const result = await this.tasksCollection.updateMany(filter, updatePipeline);
+        return {
+            matchedCount: result.matchedCount,
+            modifiedCount: result.modifiedCount,
+        };
+    }
+    async resetTasksForUpgrade(taskName, mode) {
+        const filter = { task: taskName };
+        if (mode === 'failed') {
+            filter.status = 'failed';
+        }
+        else if (mode === 'all') {
+            filter.status = { $in: ['failed', 'completed'] };
+        }
+        // Use safe reset logic
+        const result = await this.resetTasks(filter);
+        return { modifiedCount: result.modifiedCount };
+    }
+    async ensureIndexes() {
+        // Optimized index for findAndLockNextTask (ESR Rule Compliance)
+        // 1. Equality: task (since we query by IN loop usually, and it's always equality context)
+        // 2. Status: status is next
+        await this.tasksCollection.createIndex({
+            task: 1,
+            status: 1,
+            scheduledAt: 1,
+            lockExpiresAt: 1,
+        });
+        // Unique index to ensure one task per task definition per source document
+        await this.tasksCollection.createIndex({ sourceDocId: 1, task: 1 }, { unique: true });
+    }
+    /**
+     * Periodically cleans up orphaned tasks that match the cleanupPolicy.
+     * This runs on a schedule (e.g. hourly) in the Leader instance.
+     */
+    async deleteOrphanedTasks(taskName, sourceCollectionName, taskFilter, cleanupPolicy, shouldStop, limitToSourceIds) {
+        const { deleteWhen, keepForMs } = cleanupPolicy;
+        if (deleteWhen === 'never') {
+            return;
+        }
+        const cutoffDate = new Date(Date.now() - keepForMs);
+        const matchStage = {
+            task: taskName,
+            $expr: {
+                $lt: [{ $max: ['$updatedAt', { $ifNull: ['$lastFinalizedAt', '$createdAt'] }] }, cutoffDate],
+            },
+        };
+        if (limitToSourceIds && limitToSourceIds.length > 0) {
+            matchStage.sourceDocId = { $in: limitToSourceIds };
+        }
+        const pipeline = [
+            {
+                $match: matchStage,
+            },
+            {
+                $lookup: {
+                    from: sourceCollectionName,
+                    let: { sId: '$sourceDocId' },
+                    pipeline: [
+                        { $match: { $expr: { $eq: ['$_id', '$$sId'] } } },
+                        {
+                            $project: {
+                                _id: 0,
+                                matches: Object.keys(taskFilter).length > 0 ? taskFilter : true,
+                            },
+                        },
+                    ],
+                    as: 'orphanCheck',
+                },
+            },
+            {
+                $match: {
+                    $or: [
+                        { orphanCheck: { $size: 0 } }, // Source document deleted
+                        ...(deleteWhen === 'sourceDocumentDeletedOrNoLongerMatching'
+                            ? [{ 'orphanCheck.matches': false }] // Filter no longer matches
+                            : []),
+                    ],
+                },
+            },
+            {
+                $project: {
+                    _id: 1,
+                },
+            },
+        ];
+        await (0, processInBatches_1.processInBatches)(this.tasksCollection, pipeline, (task) => task._id, async (batch) => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            await this.tasksCollection.deleteMany({ _id: { $in: batch } });
+            this.onInfo({
+                message: `Cleaned up ${batch.length} orphaned tasks for '${taskName}'`,
+                code: ReactiveTaskTypes_1.CODE_REACTIVE_TASK_CLEANUP,
+                meta: { count: batch.length },
+            });
+        }, { batchSize: 1000, shouldStop });
+    }
+    async getStatistics(filter, options) {
+        const pipeline = [];
+        if (Object.keys(filter).length > 0) {
+            pipeline.push({ $match: filter });
+        }
+        const facets = {};
+        if (options.includeStatusCounts) {
+            const groupId = options.groupByTask ? { task: '$task', status: '$status' } : '$status';
+            facets.statuses = [{ $group: { _id: groupId, count: { $sum: 1 } } }];
+        }
+        if (options.includeErrorCount) {
+            if (options.groupByTask) {
+                facets.errorCounts = [{ $match: { lastError: { $exists: true, $ne: null } } }, { $group: { _id: '$task', count: { $sum: 1 } } }];
+            }
+            else {
+                facets.errorCount = [{ $match: { lastError: { $exists: true, $ne: null } } }, { $count: 'count' }];
+            }
+        }
+        if (options.includeGlobalLag) {
+            facets.globalLag = [
+                { $match: { status: 'pending' } },
+                { $group: { _id: '$task', minScheduledAt: { $min: { $ifNull: ['$initialScheduledAt', '$scheduledAt'] } } } },
+            ];
+        }
+        pipeline.push({ $facet: facets });
+        const projection = { statuses: 1 };
+        if (options.includeErrorCount) {
+            if (options.groupByTask) {
+                projection.errorCounts = 1;
+            }
+            else {
+                projection.errorCount = { $ifNull: [{ $arrayElemAt: ['$errorCount.count', 0] }, 0] };
+            }
+        }
+        if (options.includeGlobalLag) {
+            projection.globalLag = 1;
+        }
+        pipeline.push({ $project: projection });
+        const [result] = await this.tasksCollection.aggregate(pipeline, { readPreference: options.readPreference }).toArray();
+        return (result || {
+            statuses: [],
+            errorCount: options.includeErrorCount ? 0 : undefined,
+            globalLag: options.includeGlobalLag ? [] : undefined,
+        });
+    }
+}
+exports.ReactiveTaskRepository = ReactiveTaskRepository;
+//# sourceMappingURL=ReactiveTaskRepository.js.map

package/dist/lib/src/reactiveTasks/ReactiveTaskRepository.js.map

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

package/dist/lib/src/reactiveTasks/ReactiveTaskRetryStrategy.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReactiveTaskRetryStrategy = void 0;
+const cronParserPkg = require("cron-parser");
+const { Duration } = require('@sapphire/duration');
+// Handle CommonJS/ESM interop
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const CronExpressionParser = cronParserPkg.default || cronParserPkg.CronExpressionParser;
+class ReactiveTaskRetryStrategy {
+    constructor(policy) {
+        this.policy = policy;
+        // Validate policy at construction time
+        this.validatePolicy();
+    }
+    validatePolicy() {
+        const policy = this.policy;
+        const validTypes = ['fixed', 'linear', 'exponential', 'series', 'cron'];
+        if (!validTypes.includes(policy.type)) {
+            throw new Error(`Invalid retry policy type: '${policy.type}'. Valid types: ${validTypes.join(', ')}`);
+        }
+        // Validate duration strings based on policy type
+        if (policy.type === 'fixed' || policy.type === 'linear') {
+            this.validateDuration('interval', policy.interval);
+        }
+        if (policy.type === 'exponential') {
+            const minVal = policy.min !== undefined && policy.min !== null ? String(policy.min) : undefined;
+            this.validateDuration('min', minVal);
+            if (policy.max !== undefined && policy.max !== null) {
+                this.validateDuration('max', String(policy.max));
+            }
+        }
+        if (policy.type === 'series') {
+            if (!policy.intervals || policy.intervals.length === 0) {
+                throw new Error("Series retry policy requires non-empty 'intervals' array.");
+            }
+            policy.intervals.forEach((interval, index) => {
+                this.validateDuration(`intervals[${index}]`, interval);
+            });
+        }
+        if (policy.type === 'cron') {
+            try {
+                CronExpressionParser.parse(policy.expression, { currentDate: new Date() });
+            }
+            catch (err) {
+                throw new Error(`Invalid cron expression '${policy.expression}': ${err.message}`);
+            }
+        }
+        // Validate optional maxDuration if provided
+        if (policy.maxDuration) {
+            this.validateDuration('maxDuration', policy.maxDuration);
+        }
+    }
+    validateDuration(fieldName, value) {
+        if (!value) {
+            throw new Error(`Retry policy requires '${fieldName}' to be specified.`);
+        }
+        const parsed = new Duration(value).offset;
+        if (parsed === null || parsed === undefined || Number.isNaN(parsed)) {
+            throw new Error(`Invalid duration format for '${fieldName}': '${value}'. Use formats like '100ms', '1s', '5m', '1h'.`);
+        }
+        if (parsed < 0) {
+            throw new Error(`Duration '${fieldName}' must be non-negative, got '${value}'.`);
+        }
+    }
+    /**
+     * Calculates the timestamp for the next retry attempt.
+     * @param attempts Current number of attempts (will be incremented for next check) called AFTER failure
+     * @param lastError Timestamp of the last error or last attempt? No, policies are usually "after X time".
+     *                  For linear/exp/fixed, we add delay to NOW.
+     *                  For Cron, we find next date after NOW.
+     */
+    calculateNextRetry(attempts) {
+        var _a;
+        const now = new Date();
+        if (this.policy.type === 'fixed') {
+            const delay = new Duration(this.policy.interval).offset || 0;
+            return new Date(now.getTime() + delay);
+        }
+        else if (this.policy.type === 'linear') {
+            const interval = new Duration(this.policy.interval).offset || 0;
+            return new Date(now.getTime() + interval * attempts);
+        }
+        else if (this.policy.type === 'exponential') {
+            const min = new Duration(String(this.policy.min)).offset || 0;
+            const max = new Duration(String(this.policy.max)).offset || Infinity;
+            const factor = (_a = this.policy.factor) !== null && _a !== void 0 ? _a : 2;
+            // min * (factor ^ (attempts - 1))?
+            // Standard exp backoff:
+            // attempt 1: min
+            // attempt 2: min * factor
+            const delay = Math.min(max, min * Math.pow(factor, attempts - 1));
+            return new Date(now.getTime() + delay);
+        }
+        else if (this.policy.type === 'series') {
+            const intervals = this.policy.intervals;
+            // If attempts > intervals, use the last one (or maybe fail? usually last one)
+            // attempts is 1-based index of the *next* attempt?
+            // if we just failed attempt #1, we are scheduling attempt #2?
+            // Let's assume 'attempts' passed here is how many attempts have FAILED so far.
+            // So we are scheduling for attempt = attempts + 1.
+            // Series index should be attempts (0-based) ?
+            // If attempts=1 (1 failure), we want the 1st interval (index 0)?
+            // Wait.
+            // Policy: [1m, 5m]
+            // Fail attempt 1 -> wait 1m (index 0)
+            // Fail attempt 2 -> wait 5m (index 1)
+            // Fail attempt 3 -> wait 5m (index 1 - clamp)
+            const index = Math.min(Math.max(0, attempts - 1), intervals.length - 1);
+            const delay = new Duration(intervals[index]).offset || 0;
+            return new Date(now.getTime() + delay);
+        }
+        else if (this.policy.type === 'cron') {
+            // Cron expression was validated in constructor, so this should not fail
+            const interval = CronExpressionParser.parse(this.policy.expression, {
+                currentDate: now,
+            });
+            return interval.next().toDate();
+        }
+        else {
+            // This should never happen since we validate in constructor
+            throw new Error(`Unknown retry policy type: ${this.policy.type}`);
+        }
+    }
+    /**
+     * Determines if the task should be marked as permanently failed.
+     * @param attempts Number of attempts consumed so far (including the one that just failed)
+     * @param firstErrorAt When the first error in this sequence occurred
+     */
+    shouldFail(attempts, firstErrorAt) {
+        // Check Max Attempts
+        if (this.policy.maxAttempts !== undefined && this.policy.maxAttempts !== -1 && attempts >= this.policy.maxAttempts) {
+            return true;
+        }
+        // Check Max Duration
+        if (this.policy.maxDuration && firstErrorAt) {
+            const maxDurationMs = new Duration(this.policy.maxDuration).offset || 0;
+            const elapsed = Date.now() - firstErrorAt.getTime();
+            if (elapsed > maxDurationMs) {
+                return true;
+            }
+        }
+        return false;
+    }
+}
+exports.ReactiveTaskRetryStrategy = ReactiveTaskRetryStrategy;
+//# sourceMappingURL=ReactiveTaskRetryStrategy.js.map

package/dist/lib/src/reactiveTasks/ReactiveTaskRetryStrategy.js.map

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

package/dist/lib/src/reactiveTasks/ReactiveTaskTypes.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REACTIVE_TASK_META_DOC_ID = exports.CODE_REACTIVE_TASK_CLEANUP = exports.CODE_REACTIVE_TASK_INITIALIZED = exports.CODE_REACTIVE_TASK_LEADER_LOCK_LOST = exports.CODE_REACTIVE_TASK_PLANNER_STREAM_ERROR = exports.CODE_REACTIVE_TASK_PLANNER_RECONCILIATION_FINISHED = exports.CODE_REACTIVE_TASK_PLANNER_RECONCILIATION_STARTED = exports.CODE_REACTIVE_TASK_PLANNER_STOPPED = exports.CODE_REACTIVE_TASK_PLANNER_STARTED = exports.CODE_REACTIVE_TASK_FAILED = exports.CODE_REACTIVE_TASK_FINISHED = exports.CODE_REACTIVE_TASK_STARTED = exports.TaskConditionFailedError = void 0;
+/**
+ * Error thrown when `getDocument` fails because the document no longer matches the filter
+ * or has been deleted. The worker will catch this and mark the task as skipped (success).
+ */
+class TaskConditionFailedError extends Error {
+    constructor(message = 'Document no longer matches filter or not found') {
+        super(message);
+        this.name = 'TaskConditionFailedError';
+    }
+}
+exports.TaskConditionFailedError = TaskConditionFailedError;
+exports.CODE_REACTIVE_TASK_STARTED = 'reactiveTaskStarted';
+exports.CODE_REACTIVE_TASK_FINISHED = 'reactiveTaskFinished';
+exports.CODE_REACTIVE_TASK_FAILED = 'reactiveTaskFailed';
+exports.CODE_REACTIVE_TASK_PLANNER_STARTED = 'reactiveTaskPlannerStarted';
+exports.CODE_REACTIVE_TASK_PLANNER_STOPPED = 'reactiveTaskPlannerStopped';
+exports.CODE_REACTIVE_TASK_PLANNER_RECONCILIATION_STARTED = 'reactiveTaskPlannerReconciliationStarted';
+exports.CODE_REACTIVE_TASK_PLANNER_RECONCILIATION_FINISHED = 'reactiveTaskPlannerReconciliationFinished';
+exports.CODE_REACTIVE_TASK_PLANNER_STREAM_ERROR = 'reactiveTaskPlannerStreamError';
+exports.CODE_REACTIVE_TASK_LEADER_LOCK_LOST = 'reactiveTaskLeaderLockLost';
+exports.CODE_REACTIVE_TASK_INITIALIZED = 'reactiveTaskInitialized';
+exports.CODE_REACTIVE_TASK_CLEANUP = 'reactiveTaskCleanup';
+exports.REACTIVE_TASK_META_DOC_ID = '_mongodash_planner_meta';
+//# sourceMappingURL=ReactiveTaskTypes.js.map

package/dist/lib/src/reactiveTasks/ReactiveTaskTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReactiveTaskTypes.js","sourceRoot":"","sources":["../../../../src/reactiveTasks/ReactiveTaskTypes.ts"],"names":[],"mappings":";;;AAgHA;;;GAGG;AACH,MAAa,wBAAyB,SAAQ,KAAK;IAC/C,YAAY,OAAO,GAAG,gDAAgD;QAClE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IAC3C,CAAC;CACJ;AALD,4DAKC;AAuNY,QAAA,0BAA0B,GAAG,qBAAqB,CAAC;AACnD,QAAA,2BAA2B,GAAG,sBAAsB,CAAC;AACrD,QAAA,yBAAyB,GAAG,oBAAoB,CAAC;AAEjD,QAAA,kCAAkC,GAAG,4BAA4B,CAAC;AAClE,QAAA,kCAAkC,GAAG,4BAA4B,CAAC;AAClE,QAAA,iDAAiD,GAAG,0CAA0C,CAAC;AAC/F,QAAA,kDAAkD,GAAG,2CAA2C,CAAC;AACjG,QAAA,uCAAuC,GAAG,gCAAgC,CAAC;AAC3E,QAAA,mCAAmC,GAAG,4BAA4B,CAAC;AACnE,QAAA,8BAA8B,GAAG,yBAAyB,CAAC;AAC3D,QAAA,0BAA0B,GAAG,qBAAqB,CAAC;AACnD,QAAA,yBAAyB,GAAG,yBAAyB,CAAC"}