exisjs 0.7.6 → 0.7.8

package/dist/cron/job.js

@@ -0,0 +1,247 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CronJob = void 0;
+const parser_1 = require("./parser");
+class CronJob {
+    constructor(options, app) {
+        this.status = 'idle';
+        this.parsedPattern = null;
+        this.timer = null;
+        this.runningPromise = null;
+        this.executionCount = 0;
+        this.failureCount = 0;
+        this.abortController = null;
+        this.app = app;
+        this.name =
+            options.name || `job_${Math.random().toString(36).substring(2, 9)}`;
+        this.schedule = options.schedule;
+        this.intervalMs = options.interval;
+        this.timeoutMs = options.timeout;
+        this.timezone = options.timezone;
+        this.preventOverlap = options.preventOverlap !== false;
+        this.retries = options.retries ?? 0;
+        this.retryDelayMs = options.retryDelayMs ?? 1000;
+        this.onErrorHook = options.onError;
+        const fn = options.run || options.handle;
+        if (typeof fn !== 'function') {
+            throw new Error(`CronJob "${this.name}" requires a valid handler function ('run' or 'handle')`);
+        }
+        this.handler = fn;
+        if (this.schedule) {
+            this.parsedPattern = (0, parser_1.parseCronExpression)(this.schedule);
+        }
+        if (options.autoStart !== false) {
+            this.start();
+        }
+    }
+    getStatus() {
+        return this.status;
+    }
+    getStats() {
+        return {
+            name: this.name,
+            status: this.status,
+            schedule: this.schedule,
+            intervalMs: this.intervalMs,
+            timezone: this.timezone,
+            preventOverlap: this.preventOverlap,
+            lastRun: this.lastRun,
+            nextRun: this.nextRun,
+            executionCount: this.executionCount,
+            failureCount: this.failureCount,
+            lastDurationMs: this.lastDurationMs,
+            lastError: this.lastError,
+        };
+    }
+    start() {
+        if (this.status === 'running' || this.status === 'idle') {
+            this.scheduleNextRun();
+        }
+        else if (this.status === 'paused' || this.status === 'stopped') {
+            this.status = 'idle';
+            this.scheduleNextRun();
+        }
+        return this;
+    }
+    pause() {
+        this.status = 'paused';
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        this.nextRun = undefined;
+        return this;
+    }
+    resume() {
+        if (this.status === 'paused') {
+            this.status = 'idle';
+            this.scheduleNextRun();
+        }
+        return this;
+    }
+    stop() {
+        this.status = 'stopped';
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        if (this.abortController) {
+            this.abortController.abort();
+            this.abortController = null;
+        }
+        this.nextRun = undefined;
+        return this;
+    }
+    /**
+     * Manually triggers an immediate execution of the job without affecting its recurring schedule.
+     */
+    async trigger() {
+        return this.execute('manual');
+    }
+    /**
+     * Schedules the next timer execution.
+     */
+    scheduleNextRun() {
+        if (this.status === 'stopped' || this.status === 'paused')
+            return;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        if (this.timeoutMs !== undefined) {
+            this.nextRun = new Date(Date.now() + this.timeoutMs);
+            this.timer = setTimeout(async () => {
+                await this.execute('timeout');
+                this.status = 'stopped';
+            }, this.timeoutMs);
+            this.timer.unref?.();
+            return;
+        }
+        if (this.intervalMs !== undefined) {
+            this.nextRun = new Date(Date.now() + this.intervalMs);
+            this.timer = setTimeout(async () => {
+                await this.execute('interval');
+                if (this.status !== 'stopped' && this.status !== 'paused') {
+                    this.scheduleNextRun();
+                }
+            }, this.intervalMs);
+            this.timer.unref?.();
+            return;
+        }
+        if (this.parsedPattern) {
+            try {
+                const nextDate = (0, parser_1.getNextCronDate)(this.parsedPattern, new Date(), this.timezone);
+                this.nextRun = nextDate;
+                const delayMs = Math.max(0, nextDate.getTime() - Date.now());
+                this.timer = setTimeout(async () => {
+                    await this.execute('cron');
+                    if (this.status !== 'stopped' && this.status !== 'paused') {
+                        this.scheduleNextRun();
+                    }
+                }, delayMs);
+                this.timer.unref?.();
+            }
+            catch (err) {
+                this.app.log?.error({ err: err.message, job: this.name }, `[exis:cron] Failed to compute next execution date for "${this.name}"`);
+            }
+        }
+    }
+    /**
+     * Executes the handler inside an isolated error sandbox with overlap prevention.
+     */
+    async execute(_triggerSource) {
+        if (this.status === 'running' && this.preventOverlap) {
+            this.app.log?.warn({ job: this.name }, `[exis:cron] Skipped execution of "${this.name}" because previous instance is still running (preventOverlap: true)`);
+            return;
+        }
+        const previousStatus = this.status;
+        this.status = 'running';
+        this.abortController = new AbortController();
+        const startedAt = new Date();
+        this.lastRun = startedAt;
+        this.executionCount++;
+        const context = {
+            app: this.app,
+            log: this.app.log,
+            jobName: this.name,
+            startedAt,
+            iteration: this.executionCount,
+            signal: this.abortController.signal,
+        };
+        const startTimer = process.hrtime();
+        const runWithRetry = async (attempt = 0) => {
+            try {
+                return await this.handler(context);
+            }
+            catch (err) {
+                if (attempt < this.retries) {
+                    this.app.log?.warn({ job: this.name, attempt: attempt + 1, retries: this.retries }, `[exis:cron] Retrying job "${this.name}" in ${this.retryDelayMs}ms`);
+                    await new Promise((resolve) => setTimeout(resolve, this.retryDelayMs));
+                    return runWithRetry(attempt + 1);
+                }
+                throw err;
+            }
+        };
+        this.runningPromise = runWithRetry();
+        try {
+            const result = await this.runningPromise;
+            const [sec, nano] = process.hrtime(startTimer);
+            this.lastDurationMs = Math.round(sec * 1000 + nano / 1e6);
+            this.lastError = undefined;
+            return result;
+        }
+        catch (err) {
+            const [sec, nano] = process.hrtime(startTimer);
+            this.lastDurationMs = Math.round(sec * 1000 + nano / 1e6);
+            this.failureCount++;
+            this.lastError = err?.message || String(err);
+            this.app.log?.error({
+                err: this.lastError,
+                job: this.name,
+                durationMs: this.lastDurationMs,
+            }, `[exis:cron] Unhandled error in cron job "${this.name}"`);
+            if (this.onErrorHook) {
+                try {
+                    await this.onErrorHook(err, context);
+                }
+                catch (hookErr) {
+                    this.app.log?.error({ err: hookErr.message, job: this.name }, `[exis:cron] Error in onError hook for "${this.name}"`);
+                }
+            }
+        }
+        finally {
+            this.runningPromise = null;
+            this.abortController = null;
+            if (this.status === 'running') {
+                this.status = previousStatus === 'running' ? 'idle' : previousStatus;
+            }
+        }
+    }
+    /**
+     * Awaits completion of in-flight execution during graceful shutdown.
+     */
+    async drain(timeoutMs = 5000) {
+        this.stop();
+        if (this.runningPromise) {
+            let timeoutHandle;
+            const timeoutPromise = new Promise((_, reject) => {
+                timeoutHandle = setTimeout(() => {
+                    reject(new Error(`[exis:cron] Job "${this.name}" drain timed out after ${timeoutMs}ms`));
+                }, timeoutMs);
+                timeoutHandle.unref?.();
+            });
+            try {
+                await Promise.race([this.runningPromise, timeoutPromise]);
+            }
+            catch (err) {
+                this.app.log?.warn({ err }, `[exis:cron] Drain timeout on job "${this.name}"`);
+            }
+            finally {
+                if (timeoutHandle)
+                    clearTimeout(timeoutHandle);
+            }
+        }
+    }
+}
+exports.CronJob = CronJob;
+//# sourceMappingURL=job.js.map

package/dist/cron/job.js.map

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

package/dist/cron/manager.d.ts

@@ -0,0 +1,105 @@
+import type { App } from '../server/app';
+import { CronJob } from './job';
+import type { CronJobOptions, CronJobStats, CronContext } from './types';
+export declare class CronManager {
+    private jobs;
+    private app;
+    constructor(app: App<any>);
+    /**
+     * Checks whether a cron job with the given name is registered.
+     */
+    has(name: string): boolean;
+    /**
+     * Registers and optionally starts a scheduled background task or cron job.
+     *
+     * @param nameOrOptions Job name or configuration options
+     * @param schedule Optional cron schedule pattern if name is passed as first argument
+     * @param handler Optional execution handler if name is passed as first argument
+     * @param options Optional additional configuration options
+     * @returns Active `CronJob` instance
+     *
+     * @example
+     * ```ts
+     * app.cron.schedule({
+     *   name: 'nightly-backup',
+     *   schedule: '0 2 * * *',
+     *   timezone: 'UTC',
+     *   run: async ({ log }) => {
+     *     log.info('Running database backup')
+     *   }
+     * })
+     * ```
+     */
+    schedule(nameOrOptions: string | CronJobOptions, schedule?: string, handler?: (ctx: CronContext) => any, options?: Partial<CronJobOptions>): CronJob;
+    /**
+     * Schedules a recurring task using fixed millisecond intervals.
+     */
+    interval(name: string, ms: number, handler: (ctx: CronContext) => any, options?: Partial<CronJobOptions>): CronJob;
+    /**
+     * Schedules a one-time delayed task.
+     */
+    timeout(name: string, ms: number, handler: (ctx: CronContext) => any, options?: Partial<CronJobOptions>): CronJob;
+    /**
+     * Retrieves a registered cron job by its unique identifier.
+     */
+    getJob(name: string): CronJob | undefined;
+    /**
+     * Returns a snapshot map of all registered cron jobs and their execution statistics.
+     */
+    getJobs(): Map<string, CronJob>;
+    /**
+     * Returns an array of statistics for all registered jobs (last run, failure count, execution duration).
+     */
+    getStats(): CronJobStats[];
+    /**
+     * Starts all registered idle, paused, or stopped cron jobs.
+     */
+    startAll(): void;
+    /**
+     * Pauses all registered active cron jobs.
+     */
+    pauseAll(): void;
+    /**
+     * Permanently stops all registered cron jobs.
+     */
+    stopAll(): void;
+    /**
+     * Triggers immediate manual execution of a specific cron job by name.
+     */
+    trigger(name: string): Promise<any>;
+    /**
+     * Gracefully waits for all in-flight cron job executions to finish before server shutdown.
+     */
+    drain(timeoutMs?: number): Promise<void>;
+}
+/**
+ * Functional definition helper object for ExisJS cron jobs.
+ */
+export interface FunctionalCronDefinition {
+    __isExisCron: true;
+    options: CronJobOptions;
+    handler?: (ctx: CronContext) => any;
+}
+/**
+ * Declarative helper for creating scheduled background jobs and cron tasks.
+ *
+ * @param scheduleOrOptions Standard 5/6-field cron pattern (e.g. `'0 * * * *'`) or full `CronJobOptions`
+ * @param handler Execution function receiving `CronContext`
+ * @returns Functional cron definition ready for export
+ *
+ * @example
+ * ```ts
+ * // src/cron/cleanup.ts
+ * export default cron('0 0 * * *', async ({ log }) => {
+ *   log.info('Running nightly cleanup')
+ * })
+ * ```
+ */
+export declare function cron(scheduleOrOptions: string | CronJobOptions, handler?: (ctx: CronContext) => any): FunctionalCronDefinition;
+export declare namespace cron {
+    var every: (duration: string, handler: (ctx: CronContext) => any, options?: Omit<CronJobOptions, "schedule" | "run" | "handle">) => FunctionalCronDefinition;
+    var interval: (ms: number, handler: (ctx: CronContext) => any, options?: Omit<CronJobOptions, "interval" | "run" | "handle">) => FunctionalCronDefinition;
+    var timeout: (ms: number, handler: (ctx: CronContext) => any, options?: Omit<CronJobOptions, "timeout" | "run" | "handle">) => FunctionalCronDefinition;
+}
+export declare const defineCron: typeof cron;
+//# sourceMappingURL=manager.d.ts.map

package/dist/cron/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/cron/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAGxE,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,GAAG,CAAU;gBAET,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC;IAIzB;;OAEG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;;;;;;;;;;;;;;;;;;;OAoBG;IACI,QAAQ,CACb,aAAa,EAAE,MAAM,GAAG,cAAc,EACtC,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,GAAG,EACnC,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,OAAO;IAyBV;;OAEG;IACI,QAAQ,CACb,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,GAAG,EAClC,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,OAAO;IASV;;OAEG;IACI,OAAO,CACZ,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,GAAG,EAClC,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,OAAO;IASV;;OAEG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIhD;;OAEG;IACI,OAAO,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IAItC;;OAEG;IACI,QAAQ,IAAI,YAAY,EAAE;IAIjC;;OAEG;IACI,QAAQ,IAAI,IAAI;IAMvB;;OAEG;IACI,QAAQ,IAAI,IAAI;IAMvB;;OAEG;IACI,OAAO,IAAI,IAAI;IAMtB;;OAEG;IACU,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAQhD;;OAEG;IACU,KAAK,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAMpD;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,IAAI,CAAA;IAClB,OAAO,EAAE,cAAc,CAAA;IACvB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,GAAG,CAAA;CACpC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,IAAI,CAClB,iBAAiB,EAAE,MAAM,GAAG,cAAc,EAC1C,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,GAAG,GAClC,wBAAwB,CAoB1B;yBAvBe,IAAI;0BAyCR,MAAM,WACP,CAAC,GAAG,EAAE,WAAW,KAAK,GAAG,YACzB,IAAI,CAAC,cAAc,EAAE,UAAU,GAAG,KAAK,GAAG,QAAQ,CAAC,KAC3D,wBAAwB;uBAwBrB,MAAM,WACD,CAAC,GAAG,EAAE,WAAW,KAAK,GAAG,YACzB,IAAI,CAAC,cAAc,EAAE,UAAU,GAAG,KAAK,GAAG,QAAQ,CAAC,KAC3D,wBAAwB;sBAwBrB,MAAM,WACD,CAAC,GAAG,EAAE,WAAW,KAAK,GAAG,YACzB,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC,KAC1D,wBAAwB;;AAQ3B,eAAO,MAAM,UAAU,aAAO,CAAA"}

package/dist/cron/manager.js

@@ -0,0 +1,245 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineCron = exports.CronManager = void 0;
+exports.cron = cron;
+const job_1 = require("./job");
+const expressions_1 = require("./expressions");
+class CronManager {
+    constructor(app) {
+        this.jobs = new Map();
+        this.app = app;
+    }
+    /**
+     * Checks whether a cron job with the given name is registered.
+     */
+    has(name) {
+        return this.jobs.has(name);
+    }
+    /**
+     * Registers and optionally starts a scheduled background task or cron job.
+     *
+     * @param nameOrOptions Job name or configuration options
+     * @param schedule Optional cron schedule pattern if name is passed as first argument
+     * @param handler Optional execution handler if name is passed as first argument
+     * @param options Optional additional configuration options
+     * @returns Active `CronJob` instance
+     *
+     * @example
+     * ```ts
+     * app.cron.schedule({
+     *   name: 'nightly-backup',
+     *   schedule: '0 2 * * *',
+     *   timezone: 'UTC',
+     *   run: async ({ log }) => {
+     *     log.info('Running database backup')
+     *   }
+     * })
+     * ```
+     */
+    schedule(nameOrOptions, schedule, handler, options) {
+        let opts;
+        if (typeof nameOrOptions === 'string') {
+            opts = {
+                name: nameOrOptions,
+                schedule: schedule,
+                run: handler,
+                ...options,
+            };
+        }
+        else {
+            opts = nameOrOptions;
+        }
+        const job = new job_1.CronJob(opts, this.app);
+        if (this.jobs.has(job.name)) {
+            this.app.log?.warn({ job: job.name }, `[exis:cron] Overwriting existing cron job "${job.name}"`);
+            this.jobs.get(job.name)?.stop();
+        }
+        this.jobs.set(job.name, job);
+        return job;
+    }
+    /**
+     * Schedules a recurring task using fixed millisecond intervals.
+     */
+    interval(name, ms, handler, options) {
+        return this.schedule({
+            name,
+            interval: ms,
+            run: handler,
+            ...options,
+        });
+    }
+    /**
+     * Schedules a one-time delayed task.
+     */
+    timeout(name, ms, handler, options) {
+        return this.schedule({
+            name,
+            timeout: ms,
+            run: handler,
+            ...options,
+        });
+    }
+    /**
+     * Retrieves a registered cron job by its unique identifier.
+     */
+    getJob(name) {
+        return this.jobs.get(name);
+    }
+    /**
+     * Returns a snapshot map of all registered cron jobs and their execution statistics.
+     */
+    getJobs() {
+        return this.jobs;
+    }
+    /**
+     * Returns an array of statistics for all registered jobs (last run, failure count, execution duration).
+     */
+    getStats() {
+        return Array.from(this.jobs.values()).map((job) => job.getStats());
+    }
+    /**
+     * Starts all registered idle, paused, or stopped cron jobs.
+     */
+    startAll() {
+        for (const job of this.jobs.values()) {
+            job.start();
+        }
+    }
+    /**
+     * Pauses all registered active cron jobs.
+     */
+    pauseAll() {
+        for (const job of this.jobs.values()) {
+            job.pause();
+        }
+    }
+    /**
+     * Permanently stops all registered cron jobs.
+     */
+    stopAll() {
+        for (const job of this.jobs.values()) {
+            job.stop();
+        }
+    }
+    /**
+     * Triggers immediate manual execution of a specific cron job by name.
+     */
+    async trigger(name) {
+        const job = this.jobs.get(name);
+        if (!job) {
+            throw new Error(`[exis:cron] Job "${name}" not found`);
+        }
+        return job.trigger();
+    }
+    /**
+     * Gracefully waits for all in-flight cron job executions to finish before server shutdown.
+     */
+    async drain(timeoutMs = 5000) {
+        const drainPromises = Array.from(this.jobs.values()).map((job) => job.drain(timeoutMs));
+        await Promise.all(drainPromises);
+    }
+}
+exports.CronManager = CronManager;
+/**
+ * Declarative helper for creating scheduled background jobs and cron tasks.
+ *
+ * @param scheduleOrOptions Standard 5/6-field cron pattern (e.g. `'0 * * * *'`) or full `CronJobOptions`
+ * @param handler Execution function receiving `CronContext`
+ * @returns Functional cron definition ready for export
+ *
+ * @example
+ * ```ts
+ * // src/cron/cleanup.ts
+ * export default cron('0 0 * * *', async ({ log }) => {
+ *   log.info('Running nightly cleanup')
+ * })
+ * ```
+ */
+function cron(scheduleOrOptions, handler) {
+    let options;
+    if (typeof scheduleOrOptions === 'string') {
+        options = {
+            schedule: scheduleOrOptions,
+            run: handler,
+        };
+    }
+    else {
+        options = {
+            ...scheduleOrOptions,
+            run: handler || scheduleOrOptions.run || scheduleOrOptions.handle,
+        };
+    }
+    return {
+        __isExisCron: true,
+        options,
+        handler: options.run,
+    };
+}
+/**
+ * Schedules a cron job with human-readable English duration expressions.
+ *
+ * @param duration Natural language interval (e.g. `'5 minutes'`, `'1 hour'`, `'30 seconds'`, `'every weekday'`)
+ * @param handler Execution function receiving `CronContext`
+ * @param options Additional job options (retries, timezone, onError)
+ * @returns Functional cron definition
+ *
+ * @example
+ * ```ts
+ * export default cron.every('15 minutes', async ({ log }) => {
+ *   log.info('Heartbeat check')
+ * })
+ * ```
+ */
+cron.every = function (duration, handler, options = {}) {
+    return cron({
+        schedule: (0, expressions_1.every)(duration),
+        run: handler,
+        ...options,
+    });
+};
+/**
+ * Schedules a background task using millisecond fixed intervals with drift correction.
+ *
+ * @param ms Millisecond interval between executions
+ * @param handler Execution function receiving `CronContext`
+ * @param options Additional job options (retries, preventOverlap)
+ * @returns Functional cron definition
+ *
+ * @example
+ * ```ts
+ * export default cron.interval(60000, async ({ log }) => {
+ *   log.info('Running every 60 seconds')
+ * })
+ * ```
+ */
+cron.interval = function (ms, handler, options = {}) {
+    return cron({
+        interval: ms,
+        run: handler,
+        ...options,
+    });
+};
+/**
+ * Schedules a one-time background task to execute after a specified delay.
+ *
+ * @param ms Delay in milliseconds before execution
+ * @param handler Execution function receiving `CronContext`
+ * @param options Additional job options
+ * @returns Functional cron definition
+ *
+ * @example
+ * ```ts
+ * export default cron.timeout(5000, async ({ log }) => {
+ *   log.info('Executed once after 5s startup delay')
+ * })
+ * ```
+ */
+cron.timeout = function (ms, handler, options = {}) {
+    return cron({
+        timeout: ms,
+        run: handler,
+        ...options,
+    });
+};
+exports.defineCron = cron;
+//# sourceMappingURL=manager.js.map

package/dist/cron/manager.js.map

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

package/dist/cron/parser.d.ts

@@ -0,0 +1,22 @@
+export interface ParsedCronPattern {
+    hasSeconds: boolean;
+    seconds: Set<number>;
+    minutes: Set<number>;
+    hours: Set<number>;
+    daysOfMonth: Set<number>;
+    months: Set<number>;
+    daysOfWeek: Set<number>;
+}
+/**
+ * Parses a 5 or 6 field cron expression into a structured pattern object.
+ */
+export declare function parseCronExpression(expression: string): ParsedCronPattern;
+/**
+ * Validates whether a cron expression is syntactically valid.
+ */
+export declare function isValidCron(expression: string): boolean;
+/**
+ * Calculates the next occurrence Date for a cron pattern from a base date.
+ */
+export declare function getNextCronDate(pattern: ParsedCronPattern | string, fromDate?: Date, timezone?: string): Date;
+//# sourceMappingURL=parser.d.ts.map

package/dist/cron/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/cron/parser.ts"],"names":[],"mappings":"AAmCA,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,OAAO,CAAA;IACnB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACpB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACpB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAClB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACxB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACnB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CACxB;AA8ED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,CAkCzE;AAkFD;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAOvD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,iBAAiB,GAAG,MAAM,EACnC,QAAQ,OAAa,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,CAwDN"}