@arikajs/scheduler 0.0.5

package/dist/Scheduler.js

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Scheduler = void 0;
+const logging_1 = require("@arikajs/logging");
+const Schedule_1 = require("./Schedule");
+class Scheduler {
+    container;
+    schedule;
+    constructor(container) {
+        this.container = container;
+        this.schedule = new Schedule_1.Schedule();
+    }
+    /**
+     * Define the schedule.
+     */
+    define(callback) {
+        callback(this.schedule);
+        return this;
+    }
+    /**
+     * Run the scheduled tasks.
+     */
+    async run(date = new Date()) {
+        const config = this.container.make('config');
+        const timezone = config.get('app.timezone', 'UTC');
+        const dueEvents = this.schedule.dueEvents(date, timezone);
+        if (dueEvents.length === 0) {
+            return;
+        }
+        // Leader Election (Prevent multiple instances from running the same schedule)
+        if (await this.shouldSkipBecauseAnotherInstanceIsRunning()) {
+            return;
+        }
+        logging_1.Log.info(`Running ${dueEvents.length} scheduled tasks in parallel...`);
+        // Run events in parallel
+        await Promise.allSettled(dueEvents.map(event => this.runEvent(event)));
+    }
+    async shouldSkipBecauseAnotherInstanceIsRunning() {
+        if (!this.container.has('cache'))
+            return false;
+        const cache = this.container.make('cache');
+        const lockKey = 'framework/scheduler-leader-lock';
+        const isLeader = await cache.add(lockKey, true, 55); // Lock for 55 seconds
+        if (!isLeader) {
+            logging_1.Log.debug('Another instance is already running the scheduler. Skipping...');
+            return true;
+        }
+        return false;
+    }
+    async runEvent(event) {
+        const name = this.getEventName(event);
+        try {
+            await this.dispatchLifecycleEvent('TaskStarting', event);
+            // Check for overlapping
+            if (event.shouldSkipOverlapping()) {
+                const locked = await this.isLocked(event);
+                if (locked) {
+                    logging_1.Log.debug(`Skipping task [${name}] as it is still running.`);
+                    return;
+                }
+                await this.lock(event);
+            }
+            logging_1.Log.info(`Running scheduled task: [${name}]`);
+            // Handle execution with Retries and Timeout
+            await this.executeWithRetries(event);
+            logging_1.Log.info(`Task [${name}] completed successfully.`);
+            await this.dispatchLifecycleEvent('TaskFinished', event);
+        }
+        catch (e) {
+            logging_1.Log.error(`Task [${name}] failed: ${e.message}`);
+            await this.dispatchLifecycleEvent('TaskFailed', event, { error: e });
+        }
+        finally {
+            if (event.shouldSkipOverlapping()) {
+                await this.unlock(event);
+            }
+        }
+    }
+    async executeWithRetries(event) {
+        const maxRetries = event.getRetries();
+        let attempt = 0;
+        while (attempt <= maxRetries) {
+            try {
+                await this.executeWithTimeout(event);
+                return;
+            }
+            catch (e) {
+                attempt++;
+                if (attempt > maxRetries)
+                    throw e;
+                const delay = event.getRetryDelay();
+                if (delay > 0) {
+                    await new Promise(resolve => setTimeout(resolve, delay * 1000));
+                }
+                logging_1.Log.warning(`Retrying task [${this.getEventName(event)}] (Attempt ${attempt}/${maxRetries})...`);
+            }
+        }
+    }
+    async executeWithTimeout(event) {
+        const timeoutSeconds = event.getTimeout();
+        if (timeoutSeconds <= 0) {
+            return this.actuallyRun(event);
+        }
+        return new Promise(async (resolve, reject) => {
+            const timer = setTimeout(() => {
+                reject(new Error(`Task timed out after ${timeoutSeconds} seconds.`));
+            }, timeoutSeconds * 1000);
+            try {
+                await this.actuallyRun(event);
+                clearTimeout(timer);
+                resolve();
+            }
+            catch (e) {
+                clearTimeout(timer);
+                reject(e);
+            }
+        });
+    }
+    async actuallyRun(event) {
+        if (typeof event.command === 'string') {
+            const { CommandRegistry } = await import('@arikajs/console');
+            const registry = this.container.make(CommandRegistry);
+            await registry.run([event.command]);
+        }
+        else {
+            await event.run();
+        }
+    }
+    async dispatchLifecycleEvent(type, event, extra = {}) {
+        // Only if @arikajs/events is available
+        try {
+            const { Event: Emitter } = await import('@arikajs/events');
+            await Emitter.dispatch({
+                type: `scheduler.${type}`,
+                task: this.getEventName(event),
+                expression: event.expression(),
+                ...extra
+            });
+        }
+        catch (e) {
+            // Events package might not be installed, ignore silently
+        }
+    }
+    getEventName(event) {
+        return event.getDescription() || (typeof event.command === 'string' ? event.command : 'closure');
+    }
+    async isLocked(event) {
+        if (!this.container.has('cache'))
+            return false;
+        const cache = this.container.make('cache');
+        return await cache.has(this.getMutexName(event));
+    }
+    async lock(event) {
+        if (!this.container.has('cache'))
+            return;
+        const cache = this.container.make('cache');
+        await cache.put(this.getMutexName(event), true, event.mutexExpiration());
+    }
+    async unlock(event) {
+        if (!this.container.has('cache'))
+            return;
+        const cache = this.container.make('cache');
+        await cache.forget(this.getMutexName(event));
+    }
+    getMutexName(event) {
+        return `framework/schedule-${Buffer.from(this.getEventName(event) + event.expression()).toString('base64')}`;
+    }
+}
+exports.Scheduler = Scheduler;
+//# sourceMappingURL=Scheduler.js.map

package/dist/Scheduler.js.map

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

package/dist/Worker.d.ts

@@ -0,0 +1,11 @@
+import { Scheduler } from './Scheduler';
+export declare class Worker {
+    protected scheduler: Scheduler;
+    protected stopped: boolean;
+    protected running: boolean;
+    constructor(scheduler: Scheduler);
+    /**
+     * Start the scheduler worker.
+     */
+    start(): Promise<void>;
+}

package/dist/Worker.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Worker = void 0;
+const logging_1 = require("@arikajs/logging");
+class Worker {
+    scheduler;
+    stopped = false;
+    running = false;
+    constructor(scheduler) {
+        this.scheduler = scheduler;
+    }
+    /**
+     * Start the scheduler worker.
+     */
+    async start() {
+        logging_1.Log.info('Scheduler worker started. Press Ctrl+C to stop.');
+        // Graceful shutdown
+        const shutdown = () => {
+            this.stopped = true;
+            logging_1.Log.info('Stopping scheduler worker gracefully...');
+        };
+        process.on('SIGINT', shutdown);
+        process.on('SIGTERM', shutdown);
+        while (!this.stopped) {
+            const now = new Date();
+            // Round down to the minute
+            now.setSeconds(0, 0);
+            this.running = true;
+            await this.scheduler.run(now);
+            this.running = false;
+            if (this.stopped)
+                break;
+            // Wait until the next minute
+            const waitTime = 60000 - (Date.now() % 60000);
+            await new Promise(resolve => setTimeout(resolve, waitTime));
+        }
+        logging_1.Log.info('Scheduler worker stopped.');
+    }
+}
+exports.Worker = Worker;
+//# sourceMappingURL=Worker.js.map

package/dist/Worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Worker.js","sourceRoot":"","sources":["../src/Worker.ts"],"names":[],"mappings":";;;AAEA,8CAAuC;AAEvC,MAAa,MAAM;IAIO;IAHZ,OAAO,GAAY,KAAK,CAAC;IACzB,OAAO,GAAY,KAAK,CAAC;IAEnC,YAAsB,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;IAAI,CAAC;IAE/C;;OAEG;IACI,KAAK,CAAC,KAAK;QACd,aAAG,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;QAE5D,oBAAoB;QACpB,MAAM,QAAQ,GAAG,GAAG,EAAE;YAClB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,aAAG,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QACxD,CAAC,CAAC;QAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAEhC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,2BAA2B;YAC3B,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAErB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;YAErB,IAAI,IAAI,CAAC,OAAO;gBAAE,MAAM;YAExB,6BAA6B;YAC7B,MAAM,QAAQ,GAAG,KAAK,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;YAC9C,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAChE,CAAC;QAED,aAAG,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC1C,CAAC;CACJ;AAvCD,wBAuCC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './Scheduler';
+export * from './Schedule';
+export * from './Event';
+export * from './Worker';
+export * from './Contracts/Task';

package/dist/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("./Scheduler"), exports);
+__exportStar(require("./Schedule"), exports);
+__exportStar(require("./Event"), exports);
+__exportStar(require("./Worker"), exports);
+__exportStar(require("./Contracts/Task"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,8CAA4B;AAC5B,6CAA2B;AAC3B,0CAAwB;AACxB,2CAAyB;AACzB,mDAAiC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@arikajs/scheduler",
+  "version": "0.0.5",
+  "description": "Task scheduling for ArikaJS.",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "test": "npx tsx --test tests/**/*.test.ts",
+    "dev": "tsc -p tsconfig.json --watch"
+  },
+  "dependencies": {
+    "@arikajs/foundation": "*",
+    "@arikajs/logging": "*",
+    "@arikajs/queue": "*",
+    "@arikajs/console": "*",
+    "@arikajs/cache": "*",
+    "@arikajs/events": "*",
+    "cron-parser": "^4.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.24",
+    "typescript": "^5.3.3",
+    "tsx": "^4.7.1"
+  },
+  "author": "Prakash Tank",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ArikaJs/arikajs.git",
+    "directory": "packages/scheduler"
+  },
+  "bugs": {
+    "url": "https://github.com/ArikaJs/arikajs/issues"
+  },
+  "homepage": "https://github.com/ArikaJs/arikajs/tree/main/packages/scheduler#readme"
+}

package/src/Contracts/Task.ts

@@ -0,0 +1,17 @@
+
+export interface Task {
+    /**
+     * Run the scheduled task.
+     */
+    run(): Promise<void> | void;
+
+    /**
+     * Get the cron expression for the task.
+     */
+    expression(): string;
+
+    /**
+     * Determine if the task is due to run.
+     */
+    isDue(date: Date, timezone?: string): boolean;
+}

package/src/Event.ts

@@ -0,0 +1,151 @@
+
+import { Task } from './Contracts/Task';
+import cronParser from 'cron-parser';
+
+export class Event implements Task {
+    protected cronExpression: string = '* * * * *';
+    protected timezoneVal?: string;
+    protected withoutOverlappingVal: boolean = false;
+    protected expiresAt: number = 1440; // 24 hours default for overlap lock
+    protected successCallbacks: Function[] = [];
+    protected failureCallbacks: (Function)[] = [];
+    protected timeoutVal: number = 0;
+    protected retriesVal: number = 0;
+    protected retryDelayVal: number = 0;
+    protected descriptionVal: string = '';
+
+    constructor(public readonly command: string | Function) { }
+
+    public name(description: string): this {
+        this.descriptionVal = description;
+        return this;
+    }
+
+    public timeout(seconds: number): this {
+        this.timeoutVal = seconds;
+        return this;
+    }
+
+    public retry(times: number, delay: number = 0): this {
+        this.retriesVal = times;
+        this.retryDelayVal = delay;
+        return this;
+    }
+
+    public cron(expression: string): this {
+        this.cronExpression = expression;
+        return this;
+    }
+
+    public timezone(timezone: string): this {
+        this.timezoneVal = timezone;
+        return this;
+    }
+
+    public withoutOverlapping(expiresAt: number = 1440): this {
+        this.withoutOverlappingVal = true;
+        this.expiresAt = expiresAt;
+        return this;
+    }
+
+    public onSuccess(callback: Function): this {
+        this.successCallbacks.push(callback);
+        return this;
+    }
+
+    public onFailure(callback: Function): this {
+        this.failureCallbacks.push(callback);
+        return this;
+    }
+
+    // Frequencies
+    public everySecond(): this { return this.cron('* * * * * *'); }
+    public everyMinute(): this { return this.cron('* * * * *'); }
+    public everyFiveMinutes(): this { return this.cron('*/5 * * * *'); }
+    public everyTenMinutes(): this { return this.cron('*/10 * * * *'); }
+    public hourly(): this { return this.cron('0 * * * *'); }
+    public hourlyAt(minute: number): this { return this.cron(`${minute} * * * *`); }
+    public daily(): this { return this.cron('0 0 * * *'); }
+    public dailyAt(time: string): this {
+        const [hour, minute] = time.split(':');
+        return this.cron(`${minute} ${hour} * * *`);
+    }
+    public weekly(): this { return this.cron('0 0 * * 0'); }
+    public weeklyOn(day: number, time: string = '00:00'): this {
+        const [hour, minute] = time.split(':');
+        return this.cron(`${minute} ${hour} * * ${day}`);
+    }
+    public monthly(): this { return this.cron('0 0 1 * *'); }
+    public monthlyOn(day: number, time: string = '00:00'): this {
+        const [hour, minute] = time.split(':');
+        return this.cron(`${minute} ${hour} ${day} * *`);
+    }
+
+    public expression(): string {
+        return this.cronExpression;
+    }
+
+    public isDue(date: Date, timezone?: string): boolean {
+        const options = {
+            currentDate: new Date(date.getTime() - 1000),
+            tz: this.timezoneVal || timezone
+        };
+
+        try {
+            const interval = cronParser.parseExpression(this.cronExpression, options);
+            const next = interval.next().toDate();
+
+            return next.getMinutes() === date.getMinutes() &&
+                next.getHours() === date.getHours() &&
+                next.getDate() === date.getDate() &&
+                next.getMonth() === date.getMonth() &&
+                next.getFullYear() === date.getFullYear();
+        } catch (e) {
+            return false;
+        }
+    }
+
+    public async run(): Promise<void> {
+        try {
+            if (typeof this.command === 'function') {
+                await this.command();
+            } else {
+                // For commands, we would usually use the CommandRegistry
+                // But this will be handled by the Scheduler runner
+            }
+
+            for (const callback of this.successCallbacks) {
+                await callback();
+            }
+        } catch (e) {
+            for (const callback of this.failureCallbacks) {
+                await callback(e);
+            }
+            throw e;
+        }
+    }
+
+    public shouldSkipOverlapping(): boolean {
+        return this.withoutOverlappingVal;
+    }
+
+    public mutexExpiration(): number {
+        return this.expiresAt;
+    }
+
+    public getTimeout(): number {
+        return this.timeoutVal;
+    }
+
+    public getRetries(): number {
+        return this.retriesVal;
+    }
+
+    public getRetryDelay(): number {
+        return this.retryDelayVal;
+    }
+
+    public getDescription(): string {
+        return this.descriptionVal;
+    }
+}

package/src/Schedule.ts

@@ -0,0 +1,50 @@
+
+import { Event } from './Event';
+
+export class Schedule {
+    protected events: Event[] = [];
+
+    /**
+     * Add a new callback event to the schedule.
+     */
+    public call(callback: Function): Event {
+        const event = new Event(callback);
+        this.events.push(event);
+        return event;
+    }
+
+    /**
+     * Add a new command event to the schedule.
+     */
+    public command(command: string): Event {
+        const event = new Event(command);
+        this.events.push(event);
+        return event;
+    }
+
+    /**
+     * Add a new job event to the schedule.
+     */
+    public job(job: any): Event {
+        const event = new Event(async () => {
+            const { Queue } = await import('@arikajs/queue');
+            await Queue.dispatch(job);
+        });
+        this.events.push(event);
+        return event;
+    }
+
+    /**
+     * Get all events.
+     */
+    public allEvents(): Event[] {
+        return this.events;
+    }
+
+    /**
+     * Get due events.
+     */
+    public dueEvents(date: Date, timezone?: string): Event[] {
+        return this.events.filter(event => event.isDue(date, timezone));
+    }
+}