@emmvish/stable-request 2.8.5 → 3.0.0

package/dist/core/stable-scheduler.js

@@ -1,782 +0,0 @@
-import { ScheduleTypes } from '../enums/index.js';
-import { isStableBuffer, MetricsValidator } from '../utilities/index.js';
-export class StableScheduler {
-    config;
-    handler;
-    jobs = new Map();
-    queue = [];
-    queued = new Set();
-    timer = null;
-    persistTimer = null;
-    persistQueued = false;
-    runningCount = 0;
-    completed = 0;
-    failed = 0;
-    dropped = 0;
-    sequence = 0;
-    schedulerStartTime = null;
-    totalExecutionTimeMs = 0;
-    totalQueueDelayMs = 0;
-    constructor(config, handler) {
-        this.config = {
-            maxParallel: config.maxParallel ?? 2,
-            tickIntervalMs: config.tickIntervalMs ?? 500,
-            queueLimit: config.queueLimit ?? 1000,
-            timezone: config.timezone,
-            persistence: {
-                enabled: config.persistence?.enabled ?? false,
-                saveState: config.persistence?.saveState,
-                loadState: config.persistence?.loadState,
-                persistenceDebounceMs: config.persistence?.persistenceDebounceMs
-            },
-            retry: config.retry,
-            executionTimeoutMs: config.executionTimeoutMs,
-            metricsGuardrails: config.metricsGuardrails,
-            sharedBuffer: config.sharedBuffer,
-            sharedInfrastructure: config.sharedInfrastructure,
-            loadTransactionLogs: config.loadTransactionLogs
-        };
-        this.handler = handler;
-    }
-    addJobs(jobs) {
-        jobs.forEach((job) => this.addJob(job));
-        void this.persistStateIfEnabled();
-    }
-    setJobs(jobs) {
-        this.stop();
-        this.jobs.clear();
-        this.queue.length = 0;
-        this.queued.clear();
-        this.runningCount = 0;
-        this.completed = 0;
-        this.failed = 0;
-        this.dropped = 0;
-        this.addJobs(jobs);
-        this.start();
-        void this.persistStateIfEnabled();
-    }
-    addJob(job) {
-        const id = job.id ?? this.createId('job');
-        const schedule = job.schedule;
-        const now = Date.now();
-        const { nextRunAt, runOnce, remainingTimestamps } = this.initializeSchedule(schedule, now);
-        const scheduledJob = {
-            id,
-            job: { ...job, id },
-            schedule,
-            nextRunAt,
-            lastRunAt: null,
-            remainingTimestamps,
-            runOnce,
-            isRunning: false,
-            retryAttempts: 0
-        };
-        this.jobs.set(id, scheduledJob);
-        void this.persistStateIfEnabled();
-        return id;
-    }
-    start() {
-        if (this.timer) {
-            return;
-        }
-        if (!this.schedulerStartTime) {
-            this.schedulerStartTime = Date.now();
-        }
-        this.timer = setInterval(() => this.tick(), Math.max(50, this.config.tickIntervalMs));
-        this.tick();
-    }
-    stop() {
-        if (this.timer) {
-            clearInterval(this.timer);
-            this.timer = null;
-        }
-    }
-    tick() {
-        const now = Date.now();
-        let stateChanged = false;
-        for (const [id, job] of this.jobs.entries()) {
-            if (job.isRunning || this.queued.has(id) || job.nextRunAt === null) {
-                continue;
-            }
-            if (job.nextRunAt <= now) {
-                if (this.queue.length >= this.config.queueLimit) {
-                    this.dropped += 1;
-                    continue;
-                }
-                this.queue.push(id);
-                this.queued.add(id);
-                stateChanged = true;
-            }
-        }
-        while (this.runningCount < this.config.maxParallel && this.queue.length > 0) {
-            const id = this.queue.shift();
-            if (!id)
-                break;
-            this.queued.delete(id);
-            const job = this.jobs.get(id);
-            if (!job)
-                continue;
-            this.dispatch(job);
-            stateChanged = true;
-        }
-        if (stateChanged) {
-            void this.persistStateIfEnabled();
-        }
-    }
-    getStats() {
-        return {
-            queued: this.queue.length,
-            running: this.runningCount,
-            completed: this.completed,
-            failed: this.failed,
-            dropped: this.dropped,
-            totalJobs: this.jobs.size
-        };
-    }
-    getSharedInfrastructure() {
-        return this.config.sharedInfrastructure;
-    }
-    getInfrastructureMetrics() {
-        const infra = this.config.sharedInfrastructure;
-        if (!infra) {
-            return {};
-        }
-        return {
-            ...(infra.circuitBreaker ? { circuitBreaker: infra.circuitBreaker.getState() } : {}),
-            ...(infra.rateLimiter ? { rateLimiter: infra.rateLimiter.getState() } : {}),
-            ...(infra.concurrencyLimiter ? { concurrencyLimiter: infra.concurrencyLimiter.getState() } : {}),
-            ...(infra.cacheManager ? { cacheManager: infra.cacheManager.getStats() } : {})
-        };
-    }
-    getMetrics() {
-        const totalRuns = this.completed + this.failed;
-        const startedAt = this.schedulerStartTime ?? Date.now();
-        const elapsedMs = Math.max(0, Date.now() - startedAt);
-        const successRate = totalRuns > 0 ? (this.completed / totalRuns) * 100 : 0;
-        const failureRate = totalRuns > 0 ? (this.failed / totalRuns) * 100 : 0;
-        const throughput = elapsedMs > 0 ? totalRuns / (elapsedMs / 1000) : 0;
-        const averageExecutionTime = totalRuns > 0 ? this.totalExecutionTimeMs / totalRuns : 0;
-        const averageQueueDelay = totalRuns > 0 ? this.totalQueueDelayMs / totalRuns : 0;
-        const infra = this.config.sharedInfrastructure;
-        const infrastructureMetrics = this.buildInfrastructureMetrics(infra);
-        const metrics = {
-            totalJobs: this.jobs.size,
-            queued: this.queue.length,
-            running: this.runningCount,
-            completed: this.completed,
-            failed: this.failed,
-            dropped: this.dropped,
-            totalRuns,
-            successRate,
-            failureRate,
-            throughput,
-            averageExecutionTime,
-            averageQueueDelay,
-            startedAt: this.schedulerStartTime ? new Date(this.schedulerStartTime).toISOString() : undefined,
-            lastUpdated: new Date().toISOString(),
-            ...(Object.keys(infrastructureMetrics).length > 0 ? { infrastructure: infrastructureMetrics } : {})
-        };
-        if (!this.config.metricsGuardrails) {
-            return { metrics };
-        }
-        const schedulerValidation = MetricsValidator.validateSchedulerMetrics(metrics, this.config.metricsGuardrails);
-        const infraValidation = this.validateInfrastructureMetrics(infrastructureMetrics);
-        const combinedAnomalies = [
-            ...schedulerValidation.anomalies,
-            ...infraValidation.anomalies
-        ];
-        return {
-            metrics,
-            validation: {
-                isValid: combinedAnomalies.length === 0,
-                anomalies: combinedAnomalies,
-                validatedAt: new Date().toISOString()
-            }
-        };
-    }
-    buildInfrastructureMetrics(infra) {
-        const result = {};
-        if (!infra)
-            return result;
-        if (infra.circuitBreaker) {
-            const cbState = infra.circuitBreaker.getState();
-            result.circuitBreaker = {
-                state: cbState.state,
-                totalRequests: cbState.totalRequests,
-                failedRequests: cbState.failedRequests,
-                successfulRequests: cbState.successfulRequests,
-                failurePercentage: cbState.failurePercentage
-            };
-        }
-        if (infra.rateLimiter) {
-            const rlState = infra.rateLimiter.getState();
-            result.rateLimiter = {
-                totalRequests: rlState.totalRequests,
-                throttledRequests: rlState.throttledRequests,
-                throttleRate: rlState.throttleRate,
-                queueLength: rlState.queueLength,
-                averageQueueWaitTime: rlState.averageQueueWaitTime
-            };
-        }
-        if (infra.concurrencyLimiter) {
-            const clState = infra.concurrencyLimiter.getState();
-            result.concurrencyLimiter = {
-                totalRequests: clState.totalRequests,
-                completedRequests: clState.completedRequests,
-                queuedRequests: clState.queuedRequests,
-                queueLength: clState.queueLength,
-                averageQueueWaitTime: clState.averageQueueWaitTime,
-                utilizationPercentage: clState.utilizationPercentage
-            };
-        }
-        if (infra.cacheManager) {
-            const cacheStats = infra.cacheManager.getStats();
-            result.cacheManager = {
-                hits: cacheStats.hits,
-                misses: cacheStats.misses,
-                hitRate: cacheStats.hitRate,
-                missRate: cacheStats.missRate,
-                utilizationPercentage: cacheStats.utilizationPercentage,
-                evictions: cacheStats.evictions
-            };
-        }
-        return result;
-    }
-    validateInfrastructureMetrics(infraMetrics) {
-        if (!this.config.metricsGuardrails?.infrastructure || Object.keys(infraMetrics).length === 0) {
-            return { isValid: true, anomalies: [], validatedAt: new Date().toISOString() };
-        }
-        const transformedMetrics = {};
-        if (infraMetrics.circuitBreaker) {
-            transformedMetrics.circuitBreaker = {
-                failureRate: infraMetrics.circuitBreaker.failurePercentage,
-                totalRequests: infraMetrics.circuitBreaker.totalRequests,
-                failedRequests: infraMetrics.circuitBreaker.failedRequests
-            };
-        }
-        if (infraMetrics.cacheManager) {
-            transformedMetrics.cache = {
-                hitRate: infraMetrics.cacheManager.hitRate,
-                missRate: infraMetrics.cacheManager.missRate,
-                utilizationPercentage: infraMetrics.cacheManager.utilizationPercentage,
-                evictionRate: infraMetrics.cacheManager.evictions > 0 ?
-                    (infraMetrics.cacheManager.evictions / (infraMetrics.cacheManager.hits + infraMetrics.cacheManager.misses)) * 100 : 0
-            };
-        }
-        if (infraMetrics.rateLimiter) {
-            transformedMetrics.rateLimiter = {
-                throttleRate: infraMetrics.rateLimiter.throttleRate,
-                queueLength: infraMetrics.rateLimiter.queueLength,
-                averageQueueWaitTime: infraMetrics.rateLimiter.averageQueueWaitTime
-            };
-        }
-        if (infraMetrics.concurrencyLimiter) {
-            transformedMetrics.concurrencyLimiter = {
-                utilizationPercentage: infraMetrics.concurrencyLimiter.utilizationPercentage,
-                queueLength: infraMetrics.concurrencyLimiter.queueLength,
-                averageQueueWaitTime: infraMetrics.concurrencyLimiter.averageQueueWaitTime
-            };
-        }
-        return MetricsValidator.validateInfrastructureMetrics(transformedMetrics, this.config.metricsGuardrails);
-    }
-    getState() {
-        const sharedBufferSnapshot = isStableBuffer(this.config.sharedBuffer)
-            ? this.config.sharedBuffer.read()
-            : this.config.sharedBuffer;
-        return {
-            jobs: Array.from(this.jobs.values()).map((job) => ({
-                id: job.id,
-                job: job.job,
-                schedule: job.schedule,
-                nextRunAt: job.nextRunAt,
-                lastRunAt: job.lastRunAt,
-                remainingTimestamps: job.remainingTimestamps ? [...job.remainingTimestamps] : null,
-                runOnce: job.runOnce,
-                isRunning: job.isRunning,
-                retryAttempts: job.retryAttempts
-            })),
-            queue: [...this.queue],
-            stats: {
-                completed: this.completed,
-                failed: this.failed,
-                dropped: this.dropped,
-                sequence: this.sequence
-            },
-            sharedBuffer: sharedBufferSnapshot
-        };
-    }
-    async restoreState(state) {
-        let resolvedState = state;
-        if (!resolvedState && this.config.persistence.loadState) {
-            resolvedState = await this.config.persistence.loadState();
-        }
-        if (!resolvedState) {
-            return false;
-        }
-        this.stop();
-        this.jobs.clear();
-        this.queue.length = 0;
-        this.queued.clear();
-        this.runningCount = 0;
-        this.completed = resolvedState.stats.completed;
-        this.failed = resolvedState.stats.failed;
-        this.dropped = resolvedState.stats.dropped;
-        this.sequence = resolvedState.stats.sequence;
-        if (resolvedState.sharedBuffer !== undefined) {
-            if (isStableBuffer(this.config.sharedBuffer)) {
-                this.config.sharedBuffer.setState(resolvedState.sharedBuffer);
-            }
-            else {
-                this.config.sharedBuffer = resolvedState.sharedBuffer;
-            }
-        }
-        resolvedState.jobs.forEach((jobState) => {
-            const restored = {
-                id: jobState.id,
-                job: jobState.job,
-                schedule: jobState.schedule,
-                nextRunAt: jobState.nextRunAt,
-                lastRunAt: jobState.lastRunAt,
-                remainingTimestamps: jobState.remainingTimestamps ? [...jobState.remainingTimestamps] : null,
-                runOnce: jobState.runOnce,
-                isRunning: false,
-                retryAttempts: jobState.retryAttempts ?? 0
-            };
-            this.jobs.set(jobState.id, restored);
-        });
-        resolvedState.queue.forEach((id) => {
-            if (this.jobs.has(id)) {
-                this.queue.push(id);
-                this.queued.add(id);
-            }
-        });
-        this.tick();
-        void this.persistStateIfEnabled();
-        return true;
-    }
-    dispatch(job) {
-        this.runningCount += 1;
-        job.isRunning = true;
-        if (job.runOnce) {
-            job.nextRunAt = null;
-        }
-        void this.persistStateIfEnabled();
-        const startedAt = Date.now();
-        const scheduledAtMs = job.nextRunAt ?? startedAt;
-        const queueDelay = Math.max(0, startedAt - scheduledAtMs);
-        this.totalQueueDelayMs += queueDelay;
-        const sharedInfra = this.config.sharedInfrastructure;
-        let transactionLogs;
-        const createBaseContext = () => ({
-            runId: this.createId('run'),
-            jobId: job.id,
-            scheduledAt: new Date(job.nextRunAt ?? startedAt).toISOString(),
-            startedAt: new Date(startedAt).toISOString(),
-            schedule: job.schedule,
-            ...(sharedInfra ? { sharedInfrastructure: sharedInfra } : {}),
-            ...(transactionLogs ? { transactionLogs } : {})
-        });
-        const retryConfig = this.getRetryConfig(job);
-        if (retryConfig) {
-            job.retryAttempts += 1;
-        }
-        let jobError = null;
-        const executeHandler = async () => {
-            if (this.config.loadTransactionLogs) {
-                try {
-                    transactionLogs = await this.config.loadTransactionLogs({});
-                }
-                catch (e) {
-                    console.error(`stable-request: Failed to load transaction logs: ${e.message}`);
-                }
-            }
-            const baseContext = createBaseContext();
-            if (sharedInfra?.circuitBreaker) {
-                const canExecute = await sharedInfra.circuitBreaker.canExecute();
-                if (!canExecute) {
-                    throw new Error('Circuit breaker is open');
-                }
-            }
-            if (sharedInfra?.rateLimiter) {
-                await sharedInfra.rateLimiter.execute(async () => { });
-            }
-            const runHandler = async () => {
-                if (isStableBuffer(this.config.sharedBuffer)) {
-                    return this.config.sharedBuffer.run((bufferState) => this.handler(job.job, { ...baseContext, sharedBuffer: bufferState }));
-                }
-                else {
-                    return this.handler(job.job, {
-                        ...baseContext,
-                        ...(this.config.sharedBuffer !== undefined
-                            ? { sharedBuffer: this.config.sharedBuffer }
-                            : {})
-                    });
-                }
-            };
-            if (sharedInfra?.concurrencyLimiter) {
-                return sharedInfra.concurrencyLimiter.execute(runHandler);
-            }
-            return runHandler();
-        };
-        let handlerPromise;
-        if (sharedInfra?.circuitBreaker || sharedInfra?.rateLimiter || sharedInfra?.concurrencyLimiter || this.config.loadTransactionLogs) {
-            handlerPromise = executeHandler();
-        }
-        else if (isStableBuffer(this.config.sharedBuffer)) {
-            const baseContext = createBaseContext();
-            handlerPromise = this.config.sharedBuffer.run((bufferState) => this.handler(job.job, { ...baseContext, sharedBuffer: bufferState }));
-        }
-        else {
-            try {
-                const baseContext = createBaseContext();
-                const result = this.handler(job.job, {
-                    ...baseContext,
-                    ...(this.config.sharedBuffer !== undefined
-                        ? { sharedBuffer: this.config.sharedBuffer }
-                        : {})
-                });
-                handlerPromise = Promise.resolve(result);
-            }
-            catch (error) {
-                handlerPromise = Promise.reject(error);
-            }
-        }
-        const executionPromise = this.withTimeout(handlerPromise, this.getExecutionTimeoutMs(job));
-        void executionPromise
-            .then(() => {
-            this.completed += 1;
-            job.retryAttempts = 0;
-            if (sharedInfra?.circuitBreaker) {
-                sharedInfra.circuitBreaker.recordSuccess();
-            }
-        })
-            .catch((error) => {
-            this.failed += 1;
-            jobError = error;
-            if (sharedInfra?.circuitBreaker) {
-                sharedInfra.circuitBreaker.recordFailure();
-            }
-        })
-            .finally(() => {
-            const scheduledRetry = this.scheduleRetryIfEnabled(job, startedAt, jobError);
-            const executionTime = Date.now() - startedAt;
-            this.totalExecutionTimeMs += Math.max(0, executionTime);
-            job.isRunning = false;
-            job.lastRunAt = startedAt;
-            this.runningCount -= 1;
-            if (!scheduledRetry) {
-                job.retryAttempts = 0;
-                this.updateNextRun(job, startedAt);
-            }
-            this.tick();
-            void this.persistStateIfEnabled();
-        });
-    }
-    getRetryConfig(job) {
-        return job.job.retry ?? this.config.retry;
-    }
-    getExecutionTimeoutMs(job) {
-        return job.job.executionTimeoutMs ?? this.config.executionTimeoutMs;
-    }
-    scheduleRetryIfEnabled(job, startedAt, error) {
-        if (!error) {
-            return false;
-        }
-        const retryConfig = this.getRetryConfig(job);
-        if (!retryConfig) {
-            return false;
-        }
-        const maxAttempts = retryConfig.maxAttempts ?? 1;
-        if (maxAttempts <= 1 || job.retryAttempts >= maxAttempts) {
-            return false;
-        }
-        const baseDelay = retryConfig.delayMs ?? 1000;
-        const backoff = retryConfig.backoffMultiplier ?? 1;
-        const calculatedDelay = baseDelay * Math.pow(backoff, Math.max(job.retryAttempts - 1, 0));
-        const delay = retryConfig.maxDelayMs ? Math.min(calculatedDelay, retryConfig.maxDelayMs) : calculatedDelay;
-        job.nextRunAt = startedAt + Math.max(0, delay);
-        return true;
-    }
-    withTimeout(promise, timeoutMs) {
-        if (!timeoutMs || timeoutMs <= 0) {
-            return promise;
-        }
-        return new Promise((resolve, reject) => {
-            const timeoutId = setTimeout(() => {
-                reject(new Error(`Scheduler job timed out after ${timeoutMs}ms`));
-            }, timeoutMs);
-            promise
-                .then((value) => {
-                clearTimeout(timeoutId);
-                resolve(value);
-            })
-                .catch((error) => {
-                clearTimeout(timeoutId);
-                reject(error);
-            });
-        });
-    }
-    initializeSchedule(schedule, now) {
-        if (!schedule) {
-            return { nextRunAt: now, runOnce: true, remainingTimestamps: null };
-        }
-        if (schedule.type === ScheduleTypes.INTERVAL) {
-            const startAt = this.parseTimestamp(schedule.startAt);
-            if (startAt !== null && startAt > now) {
-                return { nextRunAt: startAt, runOnce: false, remainingTimestamps: null };
-            }
-            return { nextRunAt: now, runOnce: false, remainingTimestamps: null };
-        }
-        if (schedule.type === ScheduleTypes.CRON) {
-            const nextRunAt = this.getNextCronTime(schedule.expression, now, schedule.timezone);
-            return { nextRunAt, runOnce: false, remainingTimestamps: null };
-        }
-        if (schedule.type === ScheduleTypes.TIMESTAMP) {
-            const at = this.parseTimestamp(schedule.at);
-            return { nextRunAt: at, runOnce: true, remainingTimestamps: null };
-        }
-        const timestamps = schedule.at
-            .map((value) => this.parseTimestamp(value))
-            .filter((value) => value !== null)
-            .sort((a, b) => a - b);
-        const nextRunAt = timestamps.length > 0 ? timestamps[0] : null;
-        return { nextRunAt, runOnce: false, remainingTimestamps: timestamps };
-    }
-    updateNextRun(job, lastRunAt) {
-        const schedule = job.schedule;
-        if (!schedule) {
-            job.nextRunAt = job.runOnce ? null : lastRunAt;
-            return;
-        }
-        if (schedule.type === ScheduleTypes.INTERVAL) {
-            job.nextRunAt = lastRunAt + schedule.everyMs;
-            return;
-        }
-        if (schedule.type === ScheduleTypes.CRON) {
-            job.nextRunAt = this.getNextCronTime(schedule.expression, lastRunAt, schedule.timezone);
-            return;
-        }
-        if (schedule.type === ScheduleTypes.TIMESTAMP) {
-            job.nextRunAt = null;
-            return;
-        }
-        const remaining = job.remainingTimestamps ?? [];
-        while (remaining.length > 0 && remaining[0] <= lastRunAt) {
-            remaining.shift();
-        }
-        job.remainingTimestamps = remaining;
-        job.nextRunAt = remaining.length > 0 ? remaining[0] : null;
-    }
-    parseTimestamp(value) {
-        if (typeof value === 'number') {
-            return Number.isFinite(value) ? value : null;
-        }
-        if (typeof value === 'string') {
-            const parsed = Date.parse(value);
-            return Number.isNaN(parsed) ? null : parsed;
-        }
-        return null;
-    }
-    getNextCronTime(expression, fromMs, timezone) {
-        const fields = expression.trim().split(/\s+/);
-        if (fields.length < 5 || fields.length > 6) {
-            return null;
-        }
-        const hasSeconds = fields.length === 6;
-        const [secField, minField, hourField, dayField, monthField, dowField] = hasSeconds
-            ? fields
-            : ['0', ...fields];
-        const seconds = this.parseCronField(secField, 0, 59, true);
-        const minutes = this.parseCronField(minField, 0, 59, true);
-        const hours = this.parseCronField(hourField, 0, 23, true);
-        const days = this.parseCronField(dayField, 1, 31, true);
-        const months = this.parseCronField(monthField, 1, 12, true);
-        const dows = this.parseCronField(dowField, 0, 6, true);
-        if (!seconds || !minutes || !hours || !days || !months || !dows) {
-            return null;
-        }
-        const maxIterations = 366 * 24 * 60 * 60;
-        let candidate = new Date(fromMs + 1000);
-        for (let i = 0; i < maxIterations; i += 1) {
-            const candidateDate = candidate;
-            const parts = this.getCronDateParts(candidateDate, timezone);
-            if (!parts) {
-                return null;
-            }
-            const match = seconds.has(parts.second) &&
-                minutes.has(parts.minute) &&
-                hours.has(parts.hour) &&
-                days.has(parts.day) &&
-                months.has(parts.month) &&
-                dows.has(parts.dow);
-            if (match) {
-                return candidateDate.getTime();
-            }
-            candidate = new Date(candidateDate.getTime() + 1000);
-        }
-        return null;
-    }
-    parseCronField(field, min, max, strict) {
-        const values = new Set();
-        const segments = field.split(',');
-        let hasValidSegment = false;
-        segments.forEach((segment) => {
-            const trimmed = segment.trim();
-            if (!trimmed)
-                return;
-            const [rangePart, stepPart] = trimmed.split('/');
-            if (stepPart !== undefined && !this.isValidInteger(stepPart)) {
-                return;
-            }
-            const step = stepPart ? Number(stepPart) : 1;
-            const safeStep = Number.isFinite(step) && step > 0 ? step : null;
-            if (!safeStep) {
-                return;
-            }
-            let rangeStart;
-            let rangeEnd;
-            if (rangePart === '*') {
-                rangeStart = min;
-                rangeEnd = max;
-            }
-            else if (rangePart.includes('-')) {
-                const [startRaw, endRaw] = rangePart.split('-');
-                if (!this.isValidInteger(startRaw) || !this.isValidInteger(endRaw)) {
-                    return;
-                }
-                rangeStart = Number(startRaw);
-                rangeEnd = Number(endRaw);
-            }
-            else {
-                if (!this.isValidInteger(rangePart)) {
-                    return;
-                }
-                rangeStart = Number(rangePart);
-                rangeEnd = rangeStart;
-            }
-            if (rangeStart < min || rangeEnd > max || rangeStart > rangeEnd) {
-                return;
-            }
-            for (let value = rangeStart; value <= rangeEnd; value += safeStep) {
-                values.add(value);
-            }
-            hasValidSegment = true;
-        });
-        if (values.size === 0) {
-            if (strict) {
-                return null;
-            }
-            for (let value = min; value <= max; value += 1) {
-                values.add(value);
-            }
-        }
-        return values;
-    }
-    isValidInteger(value) {
-        return /^\d+$/.test(value);
-    }
-    getCronDateParts(date, timezone) {
-        if (!timezone) {
-            return {
-                second: date.getSeconds(),
-                minute: date.getMinutes(),
-                hour: date.getHours(),
-                day: date.getDate(),
-                month: date.getMonth() + 1,
-                dow: date.getDay()
-            };
-        }
-        try {
-            const formatter = new Intl.DateTimeFormat('en-US', {
-                timeZone: timezone,
-                hour12: false,
-                weekday: 'short',
-                year: 'numeric',
-                month: '2-digit',
-                day: '2-digit',
-                hour: '2-digit',
-                minute: '2-digit',
-                second: '2-digit'
-            });
-            const parts = formatter.formatToParts(date);
-            const partMap = new Map(parts.map((part) => [part.type, part.value]));
-            const month = Number(partMap.get('month'));
-            const day = Number(partMap.get('day'));
-            const hour = Number(partMap.get('hour'));
-            const minute = Number(partMap.get('minute'));
-            const second = Number(partMap.get('second'));
-            const weekday = partMap.get('weekday');
-            if (Number.isNaN(month) ||
-                Number.isNaN(day) ||
-                Number.isNaN(hour) ||
-                Number.isNaN(minute) ||
-                Number.isNaN(second) ||
-                !weekday) {
-                return null;
-            }
-            const weekdayIndex = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'].indexOf(weekday);
-            if (weekdayIndex === -1) {
-                return null;
-            }
-            return {
-                second,
-                minute,
-                hour,
-                day,
-                month,
-                dow: weekdayIndex
-            };
-        }
-        catch {
-            return null;
-        }
-    }
-    createId(prefix) {
-        return `${prefix}-${this.generateUuid()}-${Date.now()}`;
-    }
-    generateUuid() {
-        if (typeof globalThis.crypto?.randomUUID === 'function') {
-            return globalThis.crypto.randomUUID();
-        }
-        const bytes = new Uint8Array(16);
-        if (typeof globalThis.crypto?.getRandomValues === 'function') {
-            globalThis.crypto.getRandomValues(bytes);
-        }
-        else {
-            for (let i = 0; i < bytes.length; i += 1) {
-                bytes[i] = Math.floor(Math.random() * 256);
-            }
-        }
-        bytes[6] = (bytes[6] & 0x0f) | 0x40;
-        bytes[8] = (bytes[8] & 0x3f) | 0x80;
-        const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, '0'));
-        return `${hex.slice(0, 4).join('')}-${hex.slice(4, 6).join('')}-${hex
-            .slice(6, 8)
-            .join('')}-${hex.slice(8, 10).join('')}-${hex.slice(10, 16).join('')}`;
-    }
-    async persistStateIfEnabled() {
-        if (!this.config.persistence.enabled || !this.config.persistence.saveState) {
-            return;
-        }
-        const debounceMs = this.config.persistence?.persistenceDebounceMs ?? 0;
-        if (debounceMs > 0) {
-            if (this.persistTimer) {
-                this.persistQueued = true;
-                return;
-            }
-            this.persistQueued = false;
-            this.persistTimer = setTimeout(async () => {
-                this.persistTimer = null;
-                const state = this.getState();
-                await this.config.persistence.saveState?.(state);
-                if (this.persistQueued) {
-                    void this.persistStateIfEnabled();
-                }
-            }, debounceMs);
-            return;
-        }
-        const state = this.getState();
-        await this.config.persistence.saveState(state);
-    }
-}
-//# sourceMappingURL=stable-scheduler.js.map