exisjs 0.7.5 → 0.7.7

package/dist/config/types.d.ts

@@ -56,6 +56,8 @@ export interface HealthCheckConfig {
     path?: string;
     checks?: (() => Promise<boolean>)[];
 }
+import type { SwaggerConfig } from '../swagger/types';
+export type { SwaggerConfig } from '../swagger/types';
 export interface ExisConfig {
     port?: number;
     host?: string;
@@ -64,11 +66,15 @@ export interface ExisConfig {
     telemetry?: TelemetryConfig | boolean;
     metrics?: MetricsConfig | boolean;
     healthcheck?: HealthCheckConfig | boolean;
+    docs?: SwaggerConfig | boolean;
+    swagger?: SwaggerConfig | boolean;
     helmet?: HelmetConfig | boolean;
     trustProxy?: boolean | number;
     bodyLimit?: number;
     env?: 'development' | 'production' | 'test';
     compression?: boolean;
+    blockProbes?: boolean | import('../middleware/security').BlockProbesOptions;
+    blockSuspiciousProbes?: boolean | import('../middleware/security').BlockProbesOptions;
     keepAlive?: KeepAliveConfig | boolean;
     ssl?: SslConfig;
     http2?: boolean;

package/dist/config/types.d.ts.map

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

package/dist/cron/expressions.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Standard, production-tested cron expression constants.
+ */
+export declare const CronExpression: {
+    readonly EVERY_SECOND: "* * * * * *";
+    readonly EVERY_5_SECONDS: "*/5 * * * * *";
+    readonly EVERY_10_SECONDS: "*/10 * * * * *";
+    readonly EVERY_30_SECONDS: "*/30 * * * * *";
+    readonly EVERY_MINUTE: "* * * * *";
+    readonly EVERY_2_MINUTES: "*/2 * * * *";
+    readonly EVERY_3_MINUTES: "*/3 * * * *";
+    readonly EVERY_5_MINUTES: "*/5 * * * *";
+    readonly EVERY_10_MINUTES: "*/10 * * * *";
+    readonly EVERY_15_MINUTES: "*/15 * * * *";
+    readonly EVERY_30_MINUTES: "*/30 * * * *";
+    readonly EVERY_HOUR: "0 * * * *";
+    readonly EVERY_2_HOURS: "0 */2 * * *";
+    readonly EVERY_3_HOURS: "0 */3 * * *";
+    readonly EVERY_6_HOURS: "0 */6 * * *";
+    readonly EVERY_12_HOURS: "0 */12 * * *";
+    readonly EVERY_DAY_AT_MIDNIGHT: "0 0 * * *";
+    readonly EVERY_DAY_AT_1AM: "0 1 * * *";
+    readonly EVERY_DAY_AT_2AM: "0 2 * * *";
+    readonly EVERY_DAY_AT_NOON: "0 12 * * *";
+    readonly EVERY_WEEK: "0 0 * * 0";
+    readonly EVERY_WEEKDAY: "0 0 * * 1-5";
+    readonly EVERY_WEEKEND: "0 0 * * 6,0";
+    readonly EVERY_MONTH: "0 0 1 * *";
+    readonly EVERY_QUARTER: "0 0 1 1,4,7,10 *";
+    readonly EVERY_YEAR: "0 0 1 1 *";
+};
+export type CronExpressionValue = (typeof CronExpression)[keyof typeof CronExpression];
+/**
+ * Human-readable duration converter into standard cron patterns.
+ *
+ * @example
+ * ```typescript
+ * every('5 minutes') // Every 5 minutes
+ * every('10 seconds') // Every 10 seconds
+ * every('2 hours') // Every 2 hours
+ * every('1 day') // Daily at midnight
+ * ```
+ */
+export declare function every(duration: string): string;
+//# sourceMappingURL=expressions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"expressions.d.ts","sourceRoot":"","sources":["../../src/cron/expressions.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BjB,CAAA;AAEV,MAAM,MAAM,mBAAmB,GAC7B,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAA;AAEtD;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA8C9C"}

package/dist/cron/expressions.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CronExpression = void 0;
+exports.every = every;
+/**
+ * Standard, production-tested cron expression constants.
+ */
+exports.CronExpression = {
+    EVERY_SECOND: '* * * * * *',
+    EVERY_5_SECONDS: '*/5 * * * * *',
+    EVERY_10_SECONDS: '*/10 * * * * *',
+    EVERY_30_SECONDS: '*/30 * * * * *',
+    EVERY_MINUTE: '* * * * *',
+    EVERY_2_MINUTES: '*/2 * * * *',
+    EVERY_3_MINUTES: '*/3 * * * *',
+    EVERY_5_MINUTES: '*/5 * * * *',
+    EVERY_10_MINUTES: '*/10 * * * *',
+    EVERY_15_MINUTES: '*/15 * * * *',
+    EVERY_30_MINUTES: '*/30 * * * *',
+    EVERY_HOUR: '0 * * * *',
+    EVERY_2_HOURS: '0 */2 * * *',
+    EVERY_3_HOURS: '0 */3 * * *',
+    EVERY_6_HOURS: '0 */6 * * *',
+    EVERY_12_HOURS: '0 */12 * * *',
+    EVERY_DAY_AT_MIDNIGHT: '0 0 * * *',
+    EVERY_DAY_AT_1AM: '0 1 * * *',
+    EVERY_DAY_AT_2AM: '0 2 * * *',
+    EVERY_DAY_AT_NOON: '0 12 * * *',
+    EVERY_WEEK: '0 0 * * 0',
+    EVERY_WEEKDAY: '0 0 * * 1-5',
+    EVERY_WEEKEND: '0 0 * * 6,0',
+    EVERY_MONTH: '0 0 1 * *',
+    EVERY_QUARTER: '0 0 1 1,4,7,10 *',
+    EVERY_YEAR: '0 0 1 1 *',
+};
+/**
+ * Human-readable duration converter into standard cron patterns.
+ *
+ * @example
+ * ```typescript
+ * every('5 minutes') // Every 5 minutes
+ * every('10 seconds') // Every 10 seconds
+ * every('2 hours') // Every 2 hours
+ * every('1 day') // Daily at midnight
+ * ```
+ */
+function every(duration) {
+    const normalized = duration.trim().toLowerCase();
+    const match = normalized.match(/^(\d+)\s*(s|sec|second|seconds|m|min|minute|minutes|h|hr|hour|hours|d|day|days|w|week|weeks|mo|month|months)$/);
+    if (!match) {
+        throw new Error(`Invalid duration string "${duration}". Expected format like "5 minutes", "30 seconds", "2 hours", "1 day".`);
+    }
+    const count = parseInt(match[1], 10);
+    const unit = match[2];
+    if (unit.startsWith('s')) {
+        if (count === 1)
+            return exports.CronExpression.EVERY_SECOND;
+        return `*/${count} * * * * *`;
+    }
+    if (unit.startsWith('m') && !unit.startsWith('mo')) {
+        if (count === 1)
+            return exports.CronExpression.EVERY_MINUTE;
+        return `*/${count} * * * *`;
+    }
+    if (unit.startsWith('h')) {
+        if (count === 1)
+            return exports.CronExpression.EVERY_HOUR;
+        return `0 */${count} * * *`;
+    }
+    if (unit.startsWith('d')) {
+        if (count === 1)
+            return exports.CronExpression.EVERY_DAY_AT_MIDNIGHT;
+        return `0 0 */${count} * *`;
+    }
+    if (unit.startsWith('w')) {
+        if (count === 1)
+            return exports.CronExpression.EVERY_WEEK;
+        return `0 0 * * 0`;
+    }
+    if (unit.startsWith('mo')) {
+        if (count === 1)
+            return exports.CronExpression.EVERY_MONTH;
+        return `0 0 1 */${count} *`;
+    }
+    throw new Error(`Unsupported duration unit in "${duration}"`);
+}
+//# sourceMappingURL=expressions.js.map

package/dist/cron/expressions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expressions.js","sourceRoot":"","sources":["../../src/cron/expressions.ts"],"names":[],"mappings":";;;AA8CA,sBA8CC;AA5FD;;GAEG;AACU,QAAA,cAAc,GAAG;IAC5B,YAAY,EAAE,aAAa;IAC3B,eAAe,EAAE,eAAe;IAChC,gBAAgB,EAAE,gBAAgB;IAClC,gBAAgB,EAAE,gBAAgB;IAClC,YAAY,EAAE,WAAW;IACzB,eAAe,EAAE,aAAa;IAC9B,eAAe,EAAE,aAAa;IAC9B,eAAe,EAAE,aAAa;IAC9B,gBAAgB,EAAE,cAAc;IAChC,gBAAgB,EAAE,cAAc;IAChC,gBAAgB,EAAE,cAAc;IAChC,UAAU,EAAE,WAAW;IACvB,aAAa,EAAE,aAAa;IAC5B,aAAa,EAAE,aAAa;IAC5B,aAAa,EAAE,aAAa;IAC5B,cAAc,EAAE,cAAc;IAC9B,qBAAqB,EAAE,WAAW;IAClC,gBAAgB,EAAE,WAAW;IAC7B,gBAAgB,EAAE,WAAW;IAC7B,iBAAiB,EAAE,YAAY;IAC/B,UAAU,EAAE,WAAW;IACvB,aAAa,EAAE,aAAa;IAC5B,aAAa,EAAE,aAAa;IAC5B,WAAW,EAAE,WAAW;IACxB,aAAa,EAAE,kBAAkB;IACjC,UAAU,EAAE,WAAW;CACf,CAAA;AAKV;;;;;;;;;;GAUG;AACH,SAAgB,KAAK,CAAC,QAAgB;IACpC,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAChD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAC5B,+GAA+G,CAChH,CAAA;IAED,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,4BAA4B,QAAQ,wEAAwE,CAC7G,CAAA;IACH,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IACpC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IAErB,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,sBAAc,CAAC,YAAY,CAAA;QACnD,OAAO,KAAK,KAAK,YAAY,CAAA;IAC/B,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,sBAAc,CAAC,YAAY,CAAA;QACnD,OAAO,KAAK,KAAK,UAAU,CAAA;IAC7B,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,sBAAc,CAAC,UAAU,CAAA;QACjD,OAAO,OAAO,KAAK,QAAQ,CAAA;IAC7B,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,sBAAc,CAAC,qBAAqB,CAAA;QAC5D,OAAO,SAAS,KAAK,MAAM,CAAA;IAC7B,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,sBAAc,CAAC,UAAU,CAAA;QACjD,OAAO,WAAW,CAAA;IACpB,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,sBAAc,CAAC,WAAW,CAAA;QAClD,OAAO,WAAW,KAAK,IAAI,CAAA;IAC7B,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,iCAAiC,QAAQ,GAAG,CAAC,CAAA;AAC/D,CAAC"}

package/dist/cron/index.d.ts

@@ -0,0 +1,6 @@
+export * from './types';
+export * from './parser';
+export * from './expressions';
+export * from './job';
+export * from './manager';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cron/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,eAAe,CAAA;AAC7B,cAAc,OAAO,CAAA;AACrB,cAAc,WAAW,CAAA"}

package/dist/cron/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./parser"), exports);
+__exportStar(require("./expressions"), exports);
+__exportStar(require("./job"), exports);
+__exportStar(require("./manager"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cron/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cron/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAuB;AACvB,2CAAwB;AACxB,gDAA6B;AAC7B,wCAAqB;AACrB,4CAAyB"}

package/dist/cron/job.d.ts

@@ -0,0 +1,50 @@
+import type { App } from '../server/app';
+import type { CronJobOptions, CronJobStatus, CronJobStats } from './types';
+export declare class CronJob {
+    readonly name: string;
+    readonly schedule?: string;
+    readonly intervalMs?: number;
+    readonly timeoutMs?: number;
+    readonly timezone?: string;
+    readonly preventOverlap: boolean;
+    readonly retries: number;
+    readonly retryDelayMs: number;
+    private status;
+    private parsedPattern;
+    private timer;
+    private runningPromise;
+    private executionCount;
+    private failureCount;
+    private lastRun?;
+    private nextRun?;
+    private lastDurationMs?;
+    private lastError?;
+    private abortController;
+    private handler;
+    private onErrorHook?;
+    private app;
+    constructor(options: CronJobOptions, app: App<any>);
+    getStatus(): CronJobStatus;
+    getStats(): CronJobStats;
+    start(): this;
+    pause(): this;
+    resume(): this;
+    stop(): this;
+    /**
+     * Manually triggers an immediate execution of the job without affecting its recurring schedule.
+     */
+    trigger(): Promise<any>;
+    /**
+     * Schedules the next timer execution.
+     */
+    private scheduleNextRun;
+    /**
+     * Executes the handler inside an isolated error sandbox with overlap prevention.
+     */
+    private execute;
+    /**
+     * Awaits completion of in-flight execution during graceful shutdown.
+     */
+    drain(timeoutMs?: number): Promise<void>;
+}
+//# sourceMappingURL=job.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../../src/cron/job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,YAAY,EAEb,MAAM,SAAS,CAAA;AAOhB,qBAAa,OAAO;IAClB,SAAgB,IAAI,EAAE,MAAM,CAAA;IAC5B,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnC,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClC,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjC,SAAgB,cAAc,EAAE,OAAO,CAAA;IACvC,SAAgB,OAAO,EAAE,MAAM,CAAA;IAC/B,SAAgB,YAAY,EAAE,MAAM,CAAA;IAEpC,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,cAAc,CAAI;IAC1B,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,OAAO,CAAC,CAAM;IACtB,OAAO,CAAC,OAAO,CAAC,CAAM;IACtB,OAAO,CAAC,cAAc,CAAC,CAAQ;IAC/B,OAAO,CAAC,SAAS,CAAC,CAAQ;IAC1B,OAAO,CAAC,eAAe,CAA+B;IAEtD,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,WAAW,CAAC,CAAwD;IAC5E,OAAO,CAAC,GAAG,CAAU;gBAET,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC;IA8B3C,SAAS,IAAI,aAAa;IAI1B,QAAQ,IAAI,YAAY;IAiBxB,KAAK,IAAI,IAAI;IAUb,KAAK,IAAI,IAAI;IAUb,MAAM,IAAI,IAAI;IAQd,IAAI,IAAI,IAAI;IAcnB;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC;IAIpC;;OAEG;IACH,OAAO,CAAC,eAAe;IAwDvB;;OAEG;YACW,OAAO;IAsFrB;;OAEG;IACU,KAAK,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CA2BpD"}

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"}