@morojs/moro 1.6.5 → 1.6.8

package/dist/core/jobs/cron-parser.d.ts

@@ -0,0 +1,62 @@
+export interface CronSchedule {
+    minutes: number[];
+    hours: number[];
+    daysOfMonth: number[];
+    months: number[];
+    daysOfWeek: number[];
+}
+export interface NextRunResult {
+    next: Date;
+    delay: number;
+}
+export declare class CronParser {
+    private schedule;
+    private timezone;
+    private originalExpression;
+    constructor(expression: string, timezone?: string);
+    /**
+     * Parse cron expression into schedule object
+     * Format: minute hour dayOfMonth month dayOfWeek
+     * Each field can be: *, number, range (1-5), step (*\/2), list (1,3,5)
+     */
+    private parse;
+    /**
+     * Parse individual cron field
+     */
+    private parseField;
+    /**
+     * Generate range of numbers [min, max]
+     */
+    private range;
+    /**
+     * Calculate next run time from given date
+     */
+    getNextRun(from?: Date): NextRunResult;
+    /**
+     * Calculate all next N run times
+     */
+    getNextRuns(count: number, from?: Date): Date[];
+    /**
+     * Core algorithm to find next matching time
+     */
+    private calculateNextRun;
+    /**
+     * Check if date matches cron schedule
+     */
+    private matches;
+    /**
+     * Validate if expression is valid
+     */
+    static validate(expression: string): {
+        valid: boolean;
+        error?: string;
+    };
+    /**
+     * Get human-readable description
+     */
+    describe(): string;
+    /**
+     * Get schedule details
+     */
+    getSchedule(): CronSchedule;
+}

package/dist/core/jobs/cron-parser.js

@@ -0,0 +1,239 @@
+// Production-grade Cron Expression Parser
+// Supports standard 5-field cron syntax + extended macros
+// Macro definitions for common schedules
+const CRON_MACROS = {
+    '@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 * * * *',
+    '@every-15m': '*/15 * * * *',
+    '@every-30m': '*/30 * * * *',
+};
+export class CronParser {
+    schedule;
+    timezone;
+    originalExpression;
+    constructor(expression, timezone = 'UTC') {
+        this.originalExpression = expression;
+        this.timezone = timezone;
+        // Handle macros
+        const normalizedExpression = CRON_MACROS[expression.toLowerCase()] || expression;
+        this.schedule = this.parse(normalizedExpression);
+    }
+    /**
+     * Parse cron expression into schedule object
+     * Format: minute hour dayOfMonth month dayOfWeek
+     * Each field can be: *, number, range (1-5), step (*\/2), list (1,3,5)
+     */
+    parse(expression) {
+        const fields = expression.trim().split(/\s+/);
+        if (fields.length !== 5) {
+            throw new Error(`Invalid cron expression "${this.originalExpression}". Expected 5 fields (minute hour day month weekday), got ${fields.length}`);
+        }
+        const [minuteField, hourField, dayField, monthField, weekdayField] = fields;
+        return {
+            minutes: this.parseField(minuteField, 0, 59, 'minute'),
+            hours: this.parseField(hourField, 0, 23, 'hour'),
+            daysOfMonth: this.parseField(dayField, 1, 31, 'day of month'),
+            months: this.parseField(monthField, 1, 12, 'month'),
+            daysOfWeek: this.parseField(weekdayField, 0, 6, 'day of week'),
+        };
+    }
+    /**
+     * Parse individual cron field
+     */
+    parseField(field, min, max, fieldName) {
+        if (!field || field.trim() === '') {
+            throw new Error(`Empty field for ${fieldName}`);
+        }
+        // Wildcard - all values
+        if (field === '*') {
+            return this.range(min, max);
+        }
+        const values = new Set();
+        // Handle comma-separated values
+        const parts = field.split(',');
+        for (const part of parts) {
+            // Step values: */5 or 1-10/2
+            if (part.includes('/')) {
+                const [rangeOrWildcard, stepStr] = part.split('/');
+                const step = parseInt(stepStr, 10);
+                if (isNaN(step) || step <= 0) {
+                    throw new Error(`Invalid step value "${stepStr}" in ${fieldName}`);
+                }
+                let rangeStart = min;
+                let rangeEnd = max;
+                if (rangeOrWildcard !== '*') {
+                    if (rangeOrWildcard.includes('-')) {
+                        const [start, end] = rangeOrWildcard.split('-').map(v => parseInt(v, 10));
+                        rangeStart = start;
+                        rangeEnd = end;
+                    }
+                    else {
+                        rangeStart = parseInt(rangeOrWildcard, 10);
+                        rangeEnd = max;
+                    }
+                }
+                for (let i = rangeStart; i <= rangeEnd; i += step) {
+                    if (i >= min && i <= max) {
+                        values.add(i);
+                    }
+                }
+            }
+            // Range: 1-5
+            else if (part.includes('-')) {
+                const [startStr, endStr] = part.split('-');
+                const start = parseInt(startStr, 10);
+                const end = parseInt(endStr, 10);
+                if (isNaN(start) || isNaN(end)) {
+                    throw new Error(`Invalid range "${part}" in ${fieldName}`);
+                }
+                if (start > end) {
+                    throw new Error(`Invalid range "${part}" in ${fieldName}: start > end`);
+                }
+                for (let i = start; i <= end; i++) {
+                    if (i >= min && i <= max) {
+                        values.add(i);
+                    }
+                }
+            }
+            // Single value
+            else {
+                const value = parseInt(part, 10);
+                if (isNaN(value)) {
+                    throw new Error(`Invalid value "${part}" in ${fieldName}`);
+                }
+                if (value < min || value > max) {
+                    throw new Error(`Value ${value} out of range [${min}-${max}] in ${fieldName}`);
+                }
+                values.add(value);
+            }
+        }
+        if (values.size === 0) {
+            throw new Error(`No valid values parsed for ${fieldName}`);
+        }
+        return Array.from(values).sort((a, b) => a - b);
+    }
+    /**
+     * Generate range of numbers [min, max]
+     */
+    range(min, max) {
+        const result = [];
+        for (let i = min; i <= max; i++) {
+            result.push(i);
+        }
+        return result;
+    }
+    /**
+     * Calculate next run time from given date
+     */
+    getNextRun(from = new Date()) {
+        const next = this.calculateNextRun(from);
+        const delay = next.getTime() - from.getTime();
+        return { next, delay };
+    }
+    /**
+     * Calculate all next N run times
+     */
+    getNextRuns(count, from = new Date()) {
+        const runs = [];
+        let current = from;
+        for (let i = 0; i < count; i++) {
+            const { next } = this.getNextRun(current);
+            runs.push(next);
+            current = new Date(next.getTime() + 1000); // Move 1 second forward
+        }
+        return runs;
+    }
+    /**
+     * Core algorithm to find next matching time
+     */
+    calculateNextRun(from) {
+        // Start from next minute (reset seconds and milliseconds)
+        let candidate = new Date(from);
+        candidate.setSeconds(0, 0);
+        candidate.setMinutes(candidate.getMinutes() + 1);
+        // Prevent infinite loop with max iterations
+        let iterations = 0;
+        const maxIterations = 4 * 365 * 24 * 60; // 4 years in minutes
+        while (iterations < maxIterations) {
+            if (this.matches(candidate)) {
+                return candidate;
+            }
+            // Move to next minute
+            candidate = new Date(candidate.getTime() + 60000);
+            iterations++;
+        }
+        throw new Error(`Could not find next run time for cron expression "${this.originalExpression}" within 4 years`);
+    }
+    /**
+     * Check if date matches cron schedule
+     */
+    matches(date) {
+        const minute = date.getMinutes();
+        const hour = date.getHours();
+        const dayOfMonth = date.getDate();
+        const month = date.getMonth() + 1; // JS months are 0-indexed
+        const dayOfWeek = date.getDay();
+        // All fields must match
+        return (this.schedule.minutes.includes(minute) &&
+            this.schedule.hours.includes(hour) &&
+            this.schedule.daysOfMonth.includes(dayOfMonth) &&
+            this.schedule.months.includes(month) &&
+            this.schedule.daysOfWeek.includes(dayOfWeek));
+    }
+    /**
+     * Validate if expression is valid
+     */
+    static validate(expression) {
+        try {
+            new CronParser(expression);
+            return { valid: true };
+        }
+        catch (error) {
+            return {
+                valid: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Get human-readable description
+     */
+    describe() {
+        if (CRON_MACROS[this.originalExpression.toLowerCase()]) {
+            return this.originalExpression;
+        }
+        const parts = [];
+        // Minutes
+        if (this.schedule.minutes.length === 60) {
+            parts.push('every minute');
+        }
+        else if (this.schedule.minutes.length === 1) {
+            parts.push(`at minute ${this.schedule.minutes[0]}`);
+        }
+        else {
+            parts.push(`at minutes ${this.schedule.minutes.join(', ')}`);
+        }
+        // Hours
+        if (this.schedule.hours.length !== 24) {
+            if (this.schedule.hours.length === 1) {
+                parts.push(`at hour ${this.schedule.hours[0]}`);
+            }
+            else {
+                parts.push(`at hours ${this.schedule.hours.join(', ')}`);
+            }
+        }
+        return parts.join(', ');
+    }
+    /**
+     * Get schedule details
+     */
+    getSchedule() {
+        return { ...this.schedule };
+    }
+}
+//# sourceMappingURL=cron-parser.js.map

package/dist/core/jobs/cron-parser.js.map

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

package/dist/core/jobs/index.d.ts

@@ -0,0 +1,12 @@
+export { CronParser } from './cron-parser.js';
+export { JobStateManager } from './job-state-manager.js';
+export { LeaderElection } from './leader-election.js';
+export { JobExecutor } from './job-executor.js';
+export { JobScheduler } from './job-scheduler.js';
+export { JobHealthChecker, parseInterval, formatDuration, everyInterval, cronSchedule, oneTimeAt, createJob, JobBuilder, } from './utils.js';
+export type * from './types.js';
+export type { CronSchedule, NextRunResult } from './cron-parser.js';
+export type { JobExecution, JobState, JobHistory, StateManagerOptions, } from './job-state-manager.js';
+export type { LeaderElectionOptions, LeaderInfo } from './leader-election.js';
+export type { JobExecutorOptions, JobFunction, ExecutionContext, ExecutionResult, } from './job-executor.js';
+export type { JobScheduleType, JobSchedule, JobOptions, Job, JobSchedulerOptions, } from './job-scheduler.js';

package/dist/core/jobs/index.js

@@ -0,0 +1,9 @@
+// Job System - Production-grade background job scheduling for MoroJS
+// Main entry point and public API
+export { CronParser } from './cron-parser.js';
+export { JobStateManager } from './job-state-manager.js';
+export { LeaderElection } from './leader-election.js';
+export { JobExecutor } from './job-executor.js';
+export { JobScheduler } from './job-scheduler.js';
+export { JobHealthChecker, parseInterval, formatDuration, everyInterval, cronSchedule, oneTimeAt, createJob, JobBuilder, } from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/core/jobs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/jobs/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,kCAAkC;AAElC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,aAAa,EACb,YAAY,EACZ,SAAS,EACT,SAAS,EACT,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/core/jobs/job-executor.d.ts

@@ -0,0 +1,134 @@
+import { EventEmitter } from 'events';
+import { Logger } from '../../types/logger.js';
+type AbortSignal = {
+    readonly aborted: boolean;
+    addEventListener(type: 'abort', listener: () => void, options?: {
+        once: boolean;
+    }): void;
+    removeEventListener(type: 'abort', listener: () => void): void;
+};
+type AbortController = {
+    readonly signal: AbortSignal;
+    abort(): void;
+};
+declare global {
+    interface GlobalThis {
+        AbortController: new () => AbortController;
+    }
+}
+export interface JobExecutorOptions {
+    maxRetries?: number;
+    retryDelay?: number;
+    retryBackoff?: 'linear' | 'exponential';
+    retryBackoffMultiplier?: number;
+    maxRetryDelay?: number;
+    timeout?: number;
+    enableCircuitBreaker?: boolean;
+    circuitBreakerThreshold?: number;
+    circuitBreakerResetTimeout?: number;
+    enableMemoryMonitoring?: boolean;
+    memoryThreshold?: number;
+}
+export interface JobFunction {
+    (...args: any[]): Promise<any> | any;
+}
+export interface ExecutionContext {
+    jobId: string;
+    executionId: string;
+    attempt: number;
+    startTime: Date;
+    metadata?: Record<string, any>;
+}
+export interface ExecutionResult {
+    success: boolean;
+    value?: any;
+    error?: Error;
+    attempts: number;
+    duration: number;
+    memoryUsed?: number;
+    circuitBreakerTripped?: boolean;
+    timedOut?: boolean;
+}
+/**
+ * JobExecutor - Executes jobs with production-grade resilience
+ * Features:
+ * - Configurable retry with exponential backoff + jitter
+ * - Timeout enforcement
+ * - Circuit breaker integration
+ * - Memory leak detection
+ * - Graceful cancellation
+ */
+export declare class JobExecutor extends EventEmitter {
+    private options;
+    private logger;
+    private circuitBreakers;
+    private activeExecutions;
+    private isShuttingDown;
+    constructor(logger: Logger, options?: JobExecutorOptions);
+    /**
+     * Execute a job with full resilience features
+     */
+    execute(jobId: string, executionId: string, jobFn: JobFunction, context?: ExecutionContext): Promise<ExecutionResult>;
+    /**
+     * Execute job function with timeout
+     */
+    private executeWithTimeout;
+    /**
+     * Calculate retry delay with backoff and jitter
+     */
+    private calculateRetryDelay;
+    /**
+     * Sleep helper
+     */
+    private sleep;
+    /**
+     * Get or create circuit breaker for job
+     */
+    private getCircuitBreaker;
+    /**
+     * Check memory usage before execution
+     */
+    private checkMemoryUsage;
+    /**
+     * Get current memory usage in MB
+     */
+    private getMemoryUsage;
+    /**
+     * Cancel a running execution
+     */
+    cancelExecution(executionId: string): boolean;
+    /**
+     * Cancel all running executions
+     */
+    cancelAllExecutions(): void;
+    /**
+     * Get active execution count
+     */
+    getActiveExecutionCount(): number;
+    /**
+     * Get circuit breaker status for job
+     */
+    getCircuitBreakerStatus(jobId: string): {
+        exists: boolean;
+        state?: string;
+        failures?: number;
+        threshold?: number;
+    };
+    /**
+     * Reset circuit breaker for job
+     */
+    resetCircuitBreaker(jobId: string): boolean;
+    /**
+     * Update executor options at runtime
+     */
+    updateOptions(options: Partial<JobExecutorOptions>): void;
+    /**
+     * Get current options
+     */
+    getOptions(): Required<JobExecutorOptions>;
+    /**
+     * Shutdown and cleanup
+     */
+    shutdown(gracePeriod?: number): Promise<void>;
+}
+export {};