@zmdb/jobs 1.0.0-beta.1

package/dist/schedule/cron.js

@@ -0,0 +1,390 @@
+// Cron parsing and zoned next-instant calculation for @zmdb/jobs/schedule.
+//
+// Expressions are parsed once into numeric sets. Runtime state is always an
+// epoch-millisecond instant; local calendar fields exist only while calculating
+// the next one. Resolving a wall time uses Temporal's "compatible" rule: gaps
+// move forward and overlaps choose the earlier instant.
+const SECOND_MS = 1000;
+const MINUTE_MS = 60 * SECOND_MS;
+const HOUR_MS = 60 * MINUTE_MS;
+const DAY_MS = 24 * HOUR_MS;
+const MAX_SEARCH_DAYS = 366 * 8;
+const MONTH_NAMES = new Map([
+    ['JAN', 1],
+    ['FEB', 2],
+    ['MAR', 3],
+    ['APR', 4],
+    ['MAY', 5],
+    ['JUN', 6],
+    ['JUL', 7],
+    ['AUG', 8],
+    ['SEP', 9],
+    ['OCT', 10],
+    ['NOV', 11],
+    ['DEC', 12],
+]);
+const WEEKDAY_NAMES = new Map([
+    ['SUN', 0],
+    ['MON', 1],
+    ['TUE', 2],
+    ['WED', 3],
+    ['THU', 4],
+    ['FRI', 5],
+    ['SAT', 6],
+]);
+const NICKNAMES = new Map([
+    ['@yearly', '0 0 1 1 *'],
+    ['@annually', '0 0 1 1 *'],
+    ['@monthly', '0 0 1 * *'],
+    ['@weekly', '0 0 * * 0'],
+    ['@daily', '0 0 * * *'],
+    ['@midnight', '0 0 * * *'],
+    ['@hourly', '0 * * * *'],
+]);
+const SECOND = { kind: 'second', minimum: 0, maximum: 59 };
+const MINUTE = { kind: 'minute', minimum: 0, maximum: 59 };
+const HOUR = { kind: 'hour', minimum: 0, maximum: 23 };
+const DAY_OF_MONTH = { kind: 'day-of-month', minimum: 1, maximum: 31 };
+const MONTH = { kind: 'month', minimum: 1, maximum: 12, names: MONTH_NAMES };
+const DAY_OF_WEEK = { kind: 'day-of-week', minimum: 0, maximum: 7, names: WEEKDAY_NAMES };
+/** Parse once and return the two next-instant operations the scheduler needs. */
+export function createCronPlan(expression, timeZone, taskName) {
+    const parsed = parseExpression(expression, taskName);
+    const formatter = createFormatter(timeZone, taskName);
+    const nextAfter = (instant) => {
+        const local = localParts(formatter, instant);
+        const firstDay = Date.UTC(local.year, local.month - 1, local.day);
+        for (let offset = 0; offset < MAX_SEARCH_DAYS; offset += 1) {
+            const candidateDateValue = new Date(firstDay + offset * DAY_MS);
+            const date = {
+                year: candidateDateValue.getUTCFullYear(),
+                month: candidateDateValue.getUTCMonth() + 1,
+                day: candidateDateValue.getUTCDate(),
+            };
+            if (!dateMatches(parsed, date)) {
+                continue;
+            }
+            const threshold = offset === 0 ? local.hour * 3600 + local.minute * 60 + local.second : -1;
+            const candidate = candidateOnDate(parsed, formatter, date, threshold, instant);
+            if (candidate !== undefined) {
+                return candidate;
+            }
+        }
+        throw new RangeError(`@zmdb/jobs: schedule "${taskName}" has no cron instant within ${String(MAX_SEARCH_DAYS)} days`);
+    };
+    return {
+        nextAtOrAfter: instant => nextAfter(instant - 1),
+        nextAfter,
+    };
+}
+function parseExpression(expression, taskName) {
+    const source = expression.trim();
+    if (source === '@reboot') {
+        throw cronError(taskName, 'expression', expression, '@reboot is not an instant');
+    }
+    const expanded = source.startsWith('@') ? NICKNAMES.get(source.toLowerCase()) : source;
+    if (expanded === undefined) {
+        throw cronError(taskName, 'expression', expression, 'unknown cron nickname');
+    }
+    const fields = expanded.split(/\s+/);
+    if (fields.length !== 5 && fields.length !== 6) {
+        throw cronError(taskName, 'expression', expression, 'expected five fields or six with leading seconds');
+    }
+    const values = fields.length === 5 ? ['0', ...fields] : fields;
+    const second = values[0];
+    const minute = values[1];
+    const hour = values[2];
+    const dayOfMonth = values[3];
+    const month = values[4];
+    const dayOfWeek = values[5];
+    if (second === undefined ||
+        minute === undefined ||
+        hour === undefined ||
+        dayOfMonth === undefined ||
+        month === undefined ||
+        dayOfWeek === undefined) {
+        throw cronError(taskName, 'expression', expression, 'incomplete cron expression');
+    }
+    return {
+        seconds: parseField(second, SECOND, taskName),
+        minutes: parseField(minute, MINUTE, taskName),
+        hours: parseField(hour, HOUR, taskName),
+        daysOfMonth: parseField(dayOfMonth, DAY_OF_MONTH, taskName),
+        months: parseField(month, MONTH, taskName),
+        daysOfWeek: parseField(dayOfWeek, DAY_OF_WEEK, taskName),
+    };
+}
+function parseField(source, spec, taskName) {
+    if (/[LW#?]/i.test(source)) {
+        throw cronError(taskName, spec.kind, source, 'Quartz extensions are not supported');
+    }
+    const values = new Set();
+    for (const segment of source.split(',')) {
+        if (segment.length === 0) {
+            throw cronError(taskName, spec.kind, source, 'empty list item');
+        }
+        const stepParts = segment.split('/');
+        if (stepParts.length > 2) {
+            throw cronError(taskName, spec.kind, source, 'too many step separators');
+        }
+        const base = stepParts[0];
+        const stepSource = stepParts[1];
+        if (base === undefined || base.length === 0) {
+            throw cronError(taskName, spec.kind, source, 'missing range before step');
+        }
+        const step = stepSource === undefined ? 1 : parseInteger(stepSource, spec, taskName, source);
+        if (step <= 0) {
+            throw cronError(taskName, spec.kind, source, 'step must be a positive integer');
+        }
+        let first;
+        let last;
+        if (base === '*') {
+            first = spec.minimum;
+            last = spec.maximum;
+        }
+        else {
+            const range = base.split('-');
+            if (range.length > 2) {
+                throw cronError(taskName, spec.kind, source, 'too many range separators');
+            }
+            const start = range[0];
+            const end = range[1];
+            if (start === undefined || start.length === 0) {
+                throw cronError(taskName, spec.kind, source, 'missing range start');
+            }
+            first = parseValue(start, spec, taskName, source);
+            last = end === undefined ? first : parseValue(end, spec, taskName, source);
+            if (stepSource !== undefined && end === undefined) {
+                throw cronError(taskName, spec.kind, source, 'a stepped value must use * or a range');
+            }
+            if (last < first) {
+                throw cronError(taskName, spec.kind, source, 'range end precedes its start');
+            }
+        }
+        for (let value = first; value <= last; value += step) {
+            values.add(spec.kind === 'day-of-week' && value === 7 ? 0 : value);
+        }
+    }
+    const ordered = [...values].toSorted((left, right) => left - right);
+    if (ordered.length === 0) {
+        throw cronError(taskName, spec.kind, source, 'field selects no values');
+    }
+    return { values: ordered, matches: new Set(ordered), wildcard: source === '*' };
+}
+function parseValue(source, spec, taskName, field) {
+    const named = spec.names?.get(source.toUpperCase());
+    const value = named ?? parseInteger(source, spec, taskName, field);
+    if (value < spec.minimum || value > spec.maximum) {
+        throw cronError(taskName, spec.kind, field, `value ${String(value)} is outside ${String(spec.minimum)}-${String(spec.maximum)}`);
+    }
+    return value;
+}
+function parseInteger(source, spec, taskName, field) {
+    if (!/^\d+$/.test(source)) {
+        throw cronError(taskName, spec.kind, field, `"${source}" is not a number or known name`);
+    }
+    return Number.parseInt(source, 10);
+}
+function cronError(taskName, field, source, detail) {
+    return new RangeError(`@zmdb/jobs: schedule "${taskName}" has invalid ${field} "${source}": ${detail}`);
+}
+function createFormatter(timeZone, taskName) {
+    try {
+        const formatter = new Intl.DateTimeFormat('en-CA', {
+            timeZone,
+            calendar: 'iso8601',
+            numberingSystem: 'latn',
+            year: 'numeric',
+            month: '2-digit',
+            day: '2-digit',
+            hour: '2-digit',
+            minute: '2-digit',
+            second: '2-digit',
+            hourCycle: 'h23',
+        });
+        formatter.formatToParts(new Date(0));
+        return formatter;
+    }
+    catch {
+        throw new RangeError(`@zmdb/jobs: schedule "${taskName}" has unknown time zone "${timeZone}"`);
+    }
+}
+function localParts(formatter, instant) {
+    let year = Number.NaN;
+    let month = Number.NaN;
+    let day = Number.NaN;
+    let hour = Number.NaN;
+    let minute = Number.NaN;
+    let second = Number.NaN;
+    for (const part of formatter.formatToParts(new Date(instant))) {
+        const value = Number.parseInt(part.value, 10);
+        if (part.type === 'year')
+            year = value;
+        else if (part.type === 'month')
+            month = value;
+        else if (part.type === 'day')
+            day = value;
+        else if (part.type === 'hour')
+            hour = value;
+        else if (part.type === 'minute')
+            minute = value;
+        else if (part.type === 'second')
+            second = value;
+    }
+    if ([year, month, day, hour, minute, second].some(value => !Number.isFinite(value))) {
+        throw new Error('@zmdb/jobs: Intl.DateTimeFormat omitted a required calendar field');
+    }
+    return { year, month, day, hour, minute, second };
+}
+function dateMatches(expression, date) {
+    if (!expression.months.matches.has(date.month)) {
+        return false;
+    }
+    const dayOfMonth = expression.daysOfMonth.matches.has(date.day);
+    const dayOfWeek = expression.daysOfWeek.matches.has(new Date(Date.UTC(date.year, date.month - 1, date.day)).getUTCDay());
+    if (expression.daysOfMonth.wildcard && expression.daysOfWeek.wildcard) {
+        return true;
+    }
+    if (expression.daysOfMonth.wildcard) {
+        return dayOfWeek;
+    }
+    if (expression.daysOfWeek.wildcard) {
+        return dayOfMonth;
+    }
+    return dayOfMonth || dayOfWeek;
+}
+function candidateOnDate(expression, formatter, date, threshold, after) {
+    let best;
+    let cursor = threshold;
+    for (let attempts = 0; attempts < 86_400; attempts += 1) {
+        const secondOfDay = firstAllowedTimeAfter(expression, cursor);
+        if (secondOfDay === undefined) {
+            break;
+        }
+        const candidate = resolveWallTime(formatter, date, secondOfDay);
+        if (candidate > after) {
+            best = candidate;
+            break;
+        }
+        cursor = secondOfDay;
+    }
+    for (const range of gapRanges(formatter, date)) {
+        let gapCursor = range.startSecond - 1;
+        for (let attempts = 0; attempts < 86_400; attempts += 1) {
+            const secondOfDay = firstAllowedTimeAfter(expression, gapCursor);
+            if (secondOfDay === undefined || secondOfDay >= range.endSecond) {
+                break;
+            }
+            const candidate = resolveWallTime(formatter, date, secondOfDay);
+            if (candidate > after) {
+                best = best === undefined ? candidate : Math.min(best, candidate);
+                break;
+            }
+            gapCursor = secondOfDay;
+        }
+    }
+    return best;
+}
+function firstAllowedTimeAfter(expression, threshold) {
+    for (const hour of expression.hours.values) {
+        for (const minute of expression.minutes.values) {
+            for (const second of expression.seconds.values) {
+                const candidate = hour * 3600 + minute * 60 + second;
+                if (candidate > threshold) {
+                    return candidate;
+                }
+            }
+        }
+    }
+    return undefined;
+}
+function resolveWallTime(formatter, date, secondOfDay) {
+    const desired = {
+        ...date,
+        hour: Math.floor(secondOfDay / 3600),
+        minute: Math.floor((secondOfDay % 3600) / 60),
+        second: secondOfDay % 60,
+    };
+    const wall = wallEpoch(desired);
+    const offsets = offsetsNear(formatter, wall);
+    const exact = [...offsets]
+        .map(offset => wall - offset)
+        .filter(candidate => sameLocal(localParts(formatter, candidate), desired))
+        .toSorted((left, right) => left - right);
+    const first = exact[0];
+    if (first !== undefined) {
+        return first;
+    }
+    // No instant owns this wall time: it is inside a forward offset transition.
+    // Temporal's "compatible" rule uses the pre-transition offset, shifting the
+    // local time forward by the size of the gap.
+    return wall - Math.min(...offsets);
+}
+function offsetsNear(formatter, wall) {
+    const offsets = new Set();
+    for (let hours = -36; hours <= 36; hours += 6) {
+        offsets.add(offsetAt(formatter, wall + hours * HOUR_MS));
+    }
+    return offsets;
+}
+function offsetAt(formatter, instant) {
+    const rounded = Math.floor(instant / SECOND_MS) * SECOND_MS;
+    return wallEpoch(localParts(formatter, rounded)) - rounded;
+}
+function wallEpoch(parts) {
+    return Date.UTC(parts.year, parts.month - 1, parts.day, parts.hour, parts.minute, parts.second);
+}
+function sameLocal(left, right) {
+    return (left.year === right.year &&
+        left.month === right.month &&
+        left.day === right.day &&
+        left.hour === right.hour &&
+        left.minute === right.minute &&
+        left.second === right.second);
+}
+function gapRanges(formatter, date) {
+    const dayStart = Date.UTC(date.year, date.month - 1, date.day);
+    const dayEnd = dayStart + DAY_MS;
+    const scanStart = dayStart - 36 * HOUR_MS;
+    const scanEnd = dayEnd + 36 * HOUR_MS;
+    const ranges = [];
+    let previousInstant = scanStart;
+    let previousOffset = offsetAt(formatter, previousInstant);
+    for (let instant = scanStart + HOUR_MS; instant <= scanEnd; instant += HOUR_MS) {
+        const currentOffset = offsetAt(formatter, instant);
+        if (currentOffset !== previousOffset) {
+            const transition = firstOffsetChange(formatter, previousInstant, instant, previousOffset);
+            const afterOffset = offsetAt(formatter, transition);
+            if (afterOffset > previousOffset) {
+                const gapStart = wallEpoch(localParts(formatter, transition - SECOND_MS)) + SECOND_MS;
+                const gapEnd = wallEpoch(localParts(formatter, transition));
+                const intersectionStart = Math.max(dayStart, gapStart);
+                const intersectionEnd = Math.min(dayEnd, gapEnd);
+                if (intersectionStart < intersectionEnd) {
+                    ranges.push({
+                        startSecond: (intersectionStart - dayStart) / SECOND_MS,
+                        endSecond: (intersectionEnd - dayStart) / SECOND_MS,
+                    });
+                }
+            }
+            previousOffset = currentOffset;
+        }
+        previousInstant = instant;
+    }
+    return ranges;
+}
+function firstOffsetChange(formatter, lower, upper, previousOffset) {
+    let left = lower;
+    let right = upper;
+    while (right - left > SECOND_MS) {
+        const middle = Math.floor((left + right) / (2 * SECOND_MS)) * SECOND_MS;
+        if (offsetAt(formatter, middle) === previousOffset) {
+            left = middle;
+        }
+        else {
+            right = middle;
+        }
+    }
+    return right;
+}
+//# sourceMappingURL=cron.js.map

package/dist/schedule/cron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.js","sourceRoot":"","sources":["../../src/schedule/cron.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,EAAE;AACF,4EAA4E;AAC5E,gFAAgF;AAChF,8EAA8E;AAC9E,wDAAwD;AAExD,MAAM,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,SAAS,GAAG,EAAE,GAAG,SAAS,CAAC;AACjC,MAAM,OAAO,GAAG,EAAE,GAAG,SAAS,CAAC;AAC/B,MAAM,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC;AAC5B,MAAM,eAAe,GAAG,GAAG,GAAG,CAAC,CAAC;AAEhC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAiB;IAC1C,CAAC,KAAK,EAAE,CAAC,CAAC;IACV,CAAC,KAAK,EAAE,CAAC,CAAC;IACV,CAAC,KAAK,EAAE,CAAC,CAAC;IACV,CAAC,KAAK,EAAE,CAAC,CAAC;IACV,CAAC,KAAK,EAAE,CAAC,CAAC;IACV,CAAC,KAAK,EAAE,CAAC,CAAC;IACV,CAAC,KAAK,EAAE,CAAC,CAAC;IACV,CAAC,KAAK,EAAE,CAAC,CAAC;IACV,CAAC,KAAK,EAAE,CAAC,CAAC;IACV,CAAC,KAAK,EAAE,EAAE,CAAC;IACX,CAAC,KAAK,EAAE,EAAE,CAAC;IACX,CAAC,KAAK,EAAE,EAAE,CAAC;CACZ,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,IAAI,GAAG,CAAiB;IAC5C,CAAC,KAAK,EAAE,CAAC,CAAC;IACV,CAAC,KAAK,EAAE,CAAC,CAAC;IACV,CAAC,KAAK,EAAE,CAAC,CAAC;IACV,CAAC,KAAK,EAAE,CAAC,CAAC;IACV,CAAC,KAAK,EAAE,CAAC,CAAC;IACV,CAAC,KAAK,EAAE,CAAC,CAAC;IACV,CAAC,KAAK,EAAE,CAAC,CAAC;CACX,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAiB;IACxC,CAAC,SAAS,EAAE,WAAW,CAAC;IACxB,CAAC,WAAW,EAAE,WAAW,CAAC;IAC1B,CAAC,UAAU,EAAE,WAAW,CAAC;IACzB,CAAC,SAAS,EAAE,WAAW,CAAC;IACxB,CAAC,QAAQ,EAAE,WAAW,CAAC;IACvB,CAAC,WAAW,EAAE,WAAW,CAAC;IAC1B,CAAC,SAAS,EAAE,WAAW,CAAC;CACzB,CAAC,CAAC;AAoDH,MAAM,MAAM,GAAc,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AACtE,MAAM,MAAM,GAAc,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AACtE,MAAM,IAAI,GAAc,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AAClE,MAAM,YAAY,GAAc,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AAClF,MAAM,KAAK,GAAc,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AACxF,MAAM,WAAW,GAAc,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;AAErG,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAAC,UAAkB,EAAE,QAAgB,EAAE,QAAgB;IACnF,MAAM,MAAM,GAAG,eAAe,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAEtD,MAAM,SAAS,GAAG,CAAC,OAAe,EAAU,EAAE;QAC5C,MAAM,KAAK,GAAG,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAElE,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;YAC3D,MAAM,kBAAkB,GAAG,IAAI,IAAI,CAAC,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;YAChE,MAAM,IAAI,GAAc;gBACtB,IAAI,EAAE,kBAAkB,CAAC,cAAc,EAAE;gBACzC,KAAK,EAAE,kBAAkB,CAAC,WAAW,EAAE,GAAG,CAAC;gBAC3C,GAAG,EAAE,kBAAkB,CAAC,UAAU,EAAE;aACrC,CAAC;YACF,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;gBAC/B,SAAS;YACX,CAAC;YAED,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3F,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YAC/E,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QAED,MAAM,IAAI,UAAU,CAClB,yBAAyB,QAAQ,gCAAgC,MAAM,CAAC,eAAe,CAAC,OAAO,CAChG,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO;QACL,aAAa,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,GAAG,CAAC,CAAC;QAChD,SAAS;KACV,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,UAAkB,EAAE,QAAgB;IAC3D,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IACjC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,SAAS,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,2BAA2B,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACvF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,SAAS,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,uBAAuB,CAAC,CAAC;IAC/E,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/C,MAAM,SAAS,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,kDAAkD,CAAC,CAAC;IAC1G,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/D,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACvB,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAC5B,IACE,MAAM,KAAK,SAAS;QACpB,MAAM,KAAK,SAAS;QACpB,IAAI,KAAK,SAAS;QAClB,UAAU,KAAK,SAAS;QACxB,KAAK,KAAK,SAAS;QACnB,SAAS,KAAK,SAAS,EACvB,CAAC;QACD,MAAM,SAAS,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,4BAA4B,CAAC,CAAC;IACpF,CAAC;IAED,OAAO;QACL,OAAO,EAAE,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;QAC7C,OAAO,EAAE,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;QAC7C,KAAK,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC;QACvC,WAAW,EAAE,UAAU,CAAC,UAAU,EAAE,YAAY,EAAE,QAAQ,CAAC;QAC3D,MAAM,EAAE,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC;QAC1C,UAAU,EAAE,UAAU,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC;KACzD,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,MAAc,EAAE,IAAe,EAAE,QAAgB;IACnE,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,qCAAqC,CAAC,CAAC;IACtF,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACxC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC;QAClE,CAAC;QACD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,0BAA0B,CAAC,CAAC;QAC3E,CAAC;QACD,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5C,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,2BAA2B,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,IAAI,GAAG,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC7F,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;YACd,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,iCAAiC,CAAC,CAAC;QAClF,CAAC;QAED,IAAI,KAAa,CAAC;QAClB,IAAI,IAAY,CAAC;QACjB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC;YACrB,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,2BAA2B,CAAC,CAAC;YAC5E,CAAC;YACD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACvB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACrB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9C,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,qBAAqB,CAAC,CAAC;YACtE,CAAC;YACD,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YAClD,IAAI,GAAG,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC3E,IAAI,UAAU,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBAClD,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,uCAAuC,CAAC,CAAC;YACxF,CAAC;YACD,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;gBACjB,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,8BAA8B,CAAC,CAAC;YAC/E,CAAC;QACH,CAAC;QAED,KAAK,IAAI,KAAK,GAAG,KAAK,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC;YACrD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,aAAa,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;IACpE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,yBAAyB,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,GAAG,EAAE,CAAC;AAClF,CAAC;AAED,SAAS,UAAU,CAAC,MAAc,EAAE,IAAe,EAAE,QAAgB,EAAE,KAAa;IAClF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,KAAK,IAAI,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IACnE,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACjD,MAAM,SAAS,CACb,QAAQ,EACR,IAAI,CAAC,IAAI,EACT,KAAK,EACL,SAAS,MAAM,CAAC,KAAK,CAAC,eAAe,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CACpF,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,MAAc,EAAE,IAAe,EAAE,QAAgB,EAAE,KAAa;IACpF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,MAAM,iCAAiC,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,SAAS,CAAC,QAAgB,EAAE,KAAa,EAAE,MAAc,EAAE,MAAc;IAChF,OAAO,IAAI,UAAU,CAAC,yBAAyB,QAAQ,iBAAiB,KAAK,KAAK,MAAM,MAAM,MAAM,EAAE,CAAC,CAAC;AAC1G,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB,EAAE,QAAgB;IACzD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;YACjD,QAAQ;YACR,QAAQ,EAAE,SAAS;YACnB,eAAe,EAAE,MAAM;YACvB,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,SAAS;YACd,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;QACH,SAAS,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,UAAU,CAAC,yBAAyB,QAAQ,4BAA4B,QAAQ,GAAG,CAAC,CAAC;IACjG,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,SAA8B,EAAE,OAAe;IACjE,IAAI,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC;IACtB,IAAI,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC;IACvB,IAAI,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;IACrB,IAAI,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC;IACtB,IAAI,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC;IACxB,IAAI,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC;IACxB,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC9C,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;YAAE,IAAI,GAAG,KAAK,CAAC;aAClC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO;YAAE,KAAK,GAAG,KAAK,CAAC;aACzC,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK;YAAE,GAAG,GAAG,KAAK,CAAC;aACrC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;YAAE,IAAI,GAAG,KAAK,CAAC;aACvC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,GAAG,KAAK,CAAC;aAC3C,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,GAAG,KAAK,CAAC;IAClD,CAAC;IACD,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACpF,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACpD,CAAC;AAED,SAAS,WAAW,CAAC,UAA4B,EAAE,IAAe;IAChE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,UAAU,GAAG,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CACjD,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,CACpE,CAAC;IACF,IAAI,UAAU,CAAC,WAAW,CAAC,QAAQ,IAAI,UAAU,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,UAAU,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;QACpC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,UAAU,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QACnC,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,UAAU,IAAI,SAAS,CAAC;AACjC,CAAC;AAED,SAAS,eAAe,CACtB,UAA4B,EAC5B,SAA8B,EAC9B,IAAe,EACf,SAAiB,EACjB,KAAa;IAEb,IAAI,IAAwB,CAAC;IAC7B,IAAI,MAAM,GAAG,SAAS,CAAC;IACvB,KAAK,IAAI,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,MAAM,EAAE,QAAQ,IAAI,CAAC,EAAE,CAAC;QACxD,MAAM,WAAW,GAAG,qBAAqB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC9D,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM;QACR,CAAC;QACD,MAAM,SAAS,GAAG,eAAe,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QAChE,IAAI,SAAS,GAAG,KAAK,EAAE,CAAC;YACtB,IAAI,GAAG,SAAS,CAAC;YACjB,MAAM;QACR,CAAC;QACD,MAAM,GAAG,WAAW,CAAC;IACvB,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC;QAC/C,IAAI,SAAS,GAAG,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC;QACtC,KAAK,IAAI,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,MAAM,EAAE,QAAQ,IAAI,CAAC,EAAE,CAAC;YACxD,MAAM,WAAW,GAAG,qBAAqB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;YACjE,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;gBAChE,MAAM;YACR,CAAC;YACD,MAAM,SAAS,GAAG,eAAe,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;YAChE,IAAI,SAAS,GAAG,KAAK,EAAE,CAAC;gBACtB,IAAI,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBAClE,MAAM;YACR,CAAC;YACD,SAAS,GAAG,WAAW,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,qBAAqB,CAAC,UAA4B,EAAE,SAAiB;IAC5E,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAC3C,KAAK,MAAM,MAAM,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAC/C,KAAK,MAAM,MAAM,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBAC/C,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,GAAG,EAAE,GAAG,MAAM,CAAC;gBACrD,IAAI,SAAS,GAAG,SAAS,EAAE,CAAC;oBAC1B,OAAO,SAAS,CAAC;gBACnB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,eAAe,CAAC,SAA8B,EAAE,IAAe,EAAE,WAAmB;IAC3F,MAAM,OAAO,GAAe;QAC1B,GAAG,IAAI;QACP,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;QACpC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7C,MAAM,EAAE,WAAW,GAAG,EAAE;KACzB,CAAC;IACF,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC;SACvB,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,GAAG,MAAM,CAAC;SAC5B,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;SACzE,QAAQ,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,4EAA4E;IAC5E,4EAA4E;IAC5E,6CAA6C;IAC7C,OAAO,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,WAAW,CAAC,SAA8B,EAAE,IAAY;IAC/D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,QAAQ,CAAC,SAA8B,EAAE,OAAe;IAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IAC5D,OAAO,SAAS,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC;AAC7D,CAAC;AAED,SAAS,SAAS,CAAC,KAAiB;IAClC,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;AAClG,CAAC;AAED,SAAS,SAAS,CAAC,IAAgB,EAAE,KAAiB;IACpD,OAAO,CACL,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;QACxB,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;QAC1B,IAAI,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG;QACtB,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;QACxB,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;QAC5B,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAC7B,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,SAA8B,EAAE,IAAe;IAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IACjC,MAAM,SAAS,GAAG,QAAQ,GAAG,EAAE,GAAG,OAAO,CAAC;IAC1C,MAAM,OAAO,GAAG,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC;IACtC,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,IAAI,eAAe,GAAG,SAAS,CAAC;IAChC,IAAI,cAAc,GAAG,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IAE1D,KAAK,IAAI,OAAO,GAAG,SAAS,GAAG,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,CAAC;QAC/E,MAAM,aAAa,GAAG,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACnD,IAAI,aAAa,KAAK,cAAc,EAAE,CAAC;YACrC,MAAM,UAAU,GAAG,iBAAiB,CAAC,SAAS,EAAE,eAAe,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;YAC1F,MAAM,WAAW,GAAG,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YACpD,IAAI,WAAW,GAAG,cAAc,EAAE,CAAC;gBACjC,MAAM,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC,SAAS,EAAE,UAAU,GAAG,SAAS,CAAC,CAAC,GAAG,SAAS,CAAC;gBACtF,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;gBAC5D,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBACvD,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACjD,IAAI,iBAAiB,GAAG,eAAe,EAAE,CAAC;oBACxC,MAAM,CAAC,IAAI,CAAC;wBACV,WAAW,EAAE,CAAC,iBAAiB,GAAG,QAAQ,CAAC,GAAG,SAAS;wBACvD,SAAS,EAAE,CAAC,eAAe,GAAG,QAAQ,CAAC,GAAG,SAAS;qBACpD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YACD,cAAc,GAAG,aAAa,CAAC;QACjC,CAAC;QACD,eAAe,GAAG,OAAO,CAAC;IAC5B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,iBAAiB,CACxB,SAA8B,EAC9B,KAAa,EACb,KAAa,EACb,cAAsB;IAEtB,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,OAAO,KAAK,GAAG,IAAI,GAAG,SAAS,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,SAAS,CAAC;QACxE,IAAI,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,cAAc,EAAE,CAAC;YACnD,IAAI,GAAG,MAAM,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,MAAM,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/schedule/index.d.ts

@@ -0,0 +1,62 @@
+import '@zmdb/app';
+import type { Clock } from '../queues/index.js';
+import { type LeaseStore } from './lease.js';
+export type { LeaseStore } from './lease.js';
+type ScheduledMethod = (signal: AbortSignal) => void | Promise<void>;
+export type TaskDecorator = (target: ScheduledMethod, context: ClassMethodDecoratorContext) => void;
+export type TaskRuns = 'once-per-replica' | 'once-per-cluster';
+export interface TaskOptions {
+    readonly runs: TaskRuns;
+    readonly name?: string;
+    readonly timeZone?: string;
+    readonly timeoutMs?: number;
+}
+export interface IntervalOptions {
+    readonly runs: TaskRuns;
+    readonly name?: string;
+    readonly timeoutMs?: number;
+}
+export interface ScheduleDef {
+    readonly name: string;
+    readonly method: string;
+    readonly trigger: {
+        readonly kind: 'cron';
+        readonly expression: string;
+    } | {
+        readonly kind: 'interval';
+        readonly everyMs: number;
+    };
+    readonly runs: TaskRuns;
+    readonly timeZone: string;
+    readonly timeoutMs: number;
+}
+export interface SkippedRun {
+    readonly task: string;
+    readonly scheduledFor: Date;
+    readonly reason: 'still-running' | 'lease-not-held' | 'missed';
+}
+export interface SchedulerOptions {
+    readonly tasks: readonly object[];
+    readonly clock: Clock;
+    readonly onTaskError: (task: string, scheduledFor: Date, error: unknown) => void;
+    readonly onSkipped: (skipped: SkippedRun) => void;
+    readonly leases?: LeaseStore;
+    readonly leaseMs?: number;
+    readonly graceMs?: number;
+}
+export interface Scheduler {
+    start(): void;
+    onShutdown(options?: {
+        readonly graceMs: number;
+    }): Promise<void>;
+    tick(now: number): Promise<void>;
+}
+/** Declare one cron-triggered method. The expression is parsed at scheduler construction. */
+export declare function Cron(expression: string, options: TaskOptions): TaskDecorator;
+/** Declare one fixed-duration, completion-to-start method. */
+export declare function Interval(everyMs: number, options: IntervalOptions): TaskDecorator;
+/** Read and normalize the schedules declared by one class. */
+export declare function schedulesOf(controller: abstract new (...args: never[]) => unknown): readonly ScheduleDef[];
+/** Build one isolated scheduler for the supplied application-owned instances. */
+export declare function createScheduler(options: SchedulerOptions): Scheduler;
+//# sourceMappingURL=index.d.ts.map

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

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