@arikajs/scheduler 0.0.5

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# @arikajs/scheduler
+
+## 0.0.5
+
+### Patch Changes
+
+- feat: implement CSRF protection and standardized middleware architecture
+
+  - Added session-based CSRF protection middleware.
+  - Refactored middleware into project-level stubs for better customization.
+  - Standardized auth controller stubs.
+  - Enhanced CLI project scaffolding.
+  - Added session and localization packages.
+
+- Updated dependencies
+  - @arikajs/cache@0.0.5
+  - @arikajs/console@0.0.5
+  - @arikajs/events@0.0.5
+  - @arikajs/foundation@0.0.5
+  - @arikajs/logging@0.0.5
+  - @arikajs/queue@0.0.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ArikaJs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,167 @@
+
+## Arika Scheduler
+
+`@arikajs/scheduler` provides a clean, expressive, and framework-integrated task scheduling system for the ArikaJS ecosystem.
+
+It allows you to define scheduled jobs directly in code using a fluent API — designed for elegance and clarity — while remaining lightweight and Node.js-native.
+
+The scheduler is designed to work seamlessly with `@arikajs/foundation`, `@arikajs/queue`, and `@arikajs/logging`.
+
+---
+
+## ✨ Features
+
+- **🕒 Fluent scheduling API**: Expressive and readable schedule definitions
+- **⚡ Parallel Execution**: Non-blocking task execution for high performance
+- **🏆 Cluster Safety**: Leader election prevents double-execution in distributed environments
+- **🔁 Cron-based scheduling**: Full support for standard cron expressions
+- **⏱ Human-readable intervals**: Preset methods like `everyMinute()`, `hourly()`, `daily()`
+- **🧵 Queue integration**: Dispatch jobs directly to the background instead of blocking
+- **🪵 Logging integration**: Automatically logs task starts, completions, and failures
+- **🛡️ Task Control**: Built-in support for timeouts and automatic retries
+- **📡 Lifecycle Events**: Real-time monitoring via `@arikajs/events`
+- **🌍 Timezone support**: Run tasks relative to your preferred global or local timezone
+- **🛑 Graceful Shutdown**: Safe worker termination without dropping tasks
+- **🟦 TypeScript-first**: Full type safety for all scheduling operations
+
+---
+
+## 📦 Installation
+
+```bash
+npm install @arikajs/scheduler
+```
+
+**Requires:**
+- `@arikajs/foundation`
+- `@arikajs/logging`
+- `@arikajs/cache` (recommended for overlapping & cluster locks)
+- `@arikajs/events` (optional, for monitoring)
+
+---
+
+## 🚀 Quick Start
+
+### 1️⃣ Define Scheduled Tasks
+
+Create a scheduler definition file (e.g., `app/Console/Kernel.ts`):
+
+```ts
+import { Schedule } from '@arikajs/scheduler';
+
+export default (schedule: Schedule) => {
+  // Run a closure every minute with a name
+  schedule.call(() => {
+    console.log('Running every minute');
+  }).everyMinute().name('important-sync');
+
+  // Run a CLI command daily with timeout and retries
+  schedule.command('app:cleanup')
+    .daily()
+    .timeout(60) // 1 minute timeout
+    .retry(3, 10); // retry 3 times with 10s delay
+
+  // Dispatch a job to the queue hourly
+  schedule.job(CleanupJob).hourly();
+};
+```
+
+### 2️⃣ Run the Scheduler
+
+You can run the scheduler in two modes:
+
+**Long-running Daemon (Recommended for Production)**
+```bash
+arika schedule:work
+```
+
+**Single Run (For Cron Jobs)**
+```bash
+* * * * * cd /path-to-your-project && node artisan schedule:run >> /dev/null 2>&1
+```
+
+---
+
+## 📅 Defining Tasks
+
+### 🔁 Run a Closure
+```ts
+schedule.call(async () => {
+  await db.table('users').where('active', false).delete();
+}).everyMinute();
+```
+
+### 🧾 Run a Command
+```ts
+schedule.command('cache:clear').dailyAt('02:00');
+```
+
+---
+
+## 🛡 Advanced Usage
+
+### Parallel Execution & Leader Election
+The scheduler automatically runs all due tasks in parallel so complex tasks don't block simple ones. 
+
+In a clustered environment (multiple servers/containers), the scheduler uses `@arikajs/cache` to perform **Leader Election**. Only one server will process the schedule for any given minute, ensuring safety without extra configuration.
+
+### Preventing Overlaps
+If a specific task should not start if its previous instance is still active:
+```ts
+schedule
+  .command('report:generate')
+  .everyMinute()
+  .withoutOverlapping();
+```
+
+### Timezone & Retries
+```ts
+schedule
+  .command('backup:run')
+  .dailyAt('01:00')
+  .timezone('Asia/Kolkata')
+  .retry(3, 30); // Retry 3 times with 30s delay between attempts
+```
+
+### Monitoring via Events
+The scheduler emits events that you can listen to in your `EventsServiceProvider`:
+- `scheduler.TaskStarting`
+- `scheduler.TaskFinished
+- `scheduler.TaskFailed`
+
+```ts
+Event.listen('scheduler.TaskFailed', (data) => {
+    Log.error(`CRITICAL: Task ${data.task} failed! Error: ${data.err.message}`);
+});
+```
+
+---
+
+## 🏗 Architecture
+
+```text
+scheduler/
+├── src/
+│   ├── Contracts
+│   │   └── Task.ts
+│   ├── Mutex
+│   ├── Event.ts
+│   ├── index.ts
+│   ├── Schedule.ts
+│   ├── Scheduler.ts
+│   └── Worker.ts
+├── tests/
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+## 📄 License
+
+`@arikajs/scheduler` is open-source software licensed under the **MIT License**.
+
+---
+
+## 🧭 Philosophy
+
+> "If it must run, it must run reliably."

package/dist/Contracts/Task.d.ts

@@ -0,0 +1,14 @@
+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/dist/Contracts/Task.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Task.js.map

package/dist/Contracts/Task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Task.js","sourceRoot":"","sources":["../../src/Contracts/Task.ts"],"names":[],"mappings":""}

package/dist/Event.d.ts

@@ -0,0 +1,44 @@
+import { Task } from './Contracts/Task';
+export declare class Event implements Task {
+    readonly command: string | Function;
+    protected cronExpression: string;
+    protected timezoneVal?: string;
+    protected withoutOverlappingVal: boolean;
+    protected expiresAt: number;
+    protected successCallbacks: Function[];
+    protected failureCallbacks: (Function)[];
+    protected timeoutVal: number;
+    protected retriesVal: number;
+    protected retryDelayVal: number;
+    protected descriptionVal: string;
+    constructor(command: string | Function);
+    name(description: string): this;
+    timeout(seconds: number): this;
+    retry(times: number, delay?: number): this;
+    cron(expression: string): this;
+    timezone(timezone: string): this;
+    withoutOverlapping(expiresAt?: number): this;
+    onSuccess(callback: Function): this;
+    onFailure(callback: Function): this;
+    everySecond(): this;
+    everyMinute(): this;
+    everyFiveMinutes(): this;
+    everyTenMinutes(): this;
+    hourly(): this;
+    hourlyAt(minute: number): this;
+    daily(): this;
+    dailyAt(time: string): this;
+    weekly(): this;
+    weeklyOn(day: number, time?: string): this;
+    monthly(): this;
+    monthlyOn(day: number, time?: string): this;
+    expression(): string;
+    isDue(date: Date, timezone?: string): boolean;
+    run(): Promise<void>;
+    shouldSkipOverlapping(): boolean;
+    mutexExpiration(): number;
+    getTimeout(): number;
+    getRetries(): number;
+    getRetryDelay(): number;
+    getDescription(): string;
+}

package/dist/Event.js

@@ -0,0 +1,140 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Event = void 0;
+const cron_parser_1 = __importDefault(require("cron-parser"));
+class Event {
+    command;
+    cronExpression = '* * * * *';
+    timezoneVal;
+    withoutOverlappingVal = false;
+    expiresAt = 1440; // 24 hours default for overlap lock
+    successCallbacks = [];
+    failureCallbacks = [];
+    timeoutVal = 0;
+    retriesVal = 0;
+    retryDelayVal = 0;
+    descriptionVal = '';
+    constructor(command) {
+        this.command = command;
+    }
+    name(description) {
+        this.descriptionVal = description;
+        return this;
+    }
+    timeout(seconds) {
+        this.timeoutVal = seconds;
+        return this;
+    }
+    retry(times, delay = 0) {
+        this.retriesVal = times;
+        this.retryDelayVal = delay;
+        return this;
+    }
+    cron(expression) {
+        this.cronExpression = expression;
+        return this;
+    }
+    timezone(timezone) {
+        this.timezoneVal = timezone;
+        return this;
+    }
+    withoutOverlapping(expiresAt = 1440) {
+        this.withoutOverlappingVal = true;
+        this.expiresAt = expiresAt;
+        return this;
+    }
+    onSuccess(callback) {
+        this.successCallbacks.push(callback);
+        return this;
+    }
+    onFailure(callback) {
+        this.failureCallbacks.push(callback);
+        return this;
+    }
+    // Frequencies
+    everySecond() { return this.cron('* * * * * *'); }
+    everyMinute() { return this.cron('* * * * *'); }
+    everyFiveMinutes() { return this.cron('*/5 * * * *'); }
+    everyTenMinutes() { return this.cron('*/10 * * * *'); }
+    hourly() { return this.cron('0 * * * *'); }
+    hourlyAt(minute) { return this.cron(`${minute} * * * *`); }
+    daily() { return this.cron('0 0 * * *'); }
+    dailyAt(time) {
+        const [hour, minute] = time.split(':');
+        return this.cron(`${minute} ${hour} * * *`);
+    }
+    weekly() { return this.cron('0 0 * * 0'); }
+    weeklyOn(day, time = '00:00') {
+        const [hour, minute] = time.split(':');
+        return this.cron(`${minute} ${hour} * * ${day}`);
+    }
+    monthly() { return this.cron('0 0 1 * *'); }
+    monthlyOn(day, time = '00:00') {
+        const [hour, minute] = time.split(':');
+        return this.cron(`${minute} ${hour} ${day} * *`);
+    }
+    expression() {
+        return this.cronExpression;
+    }
+    isDue(date, timezone) {
+        const options = {
+            currentDate: new Date(date.getTime() - 1000),
+            tz: this.timezoneVal || timezone
+        };
+        try {
+            const interval = cron_parser_1.default.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;
+        }
+    }
+    async run() {
+        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;
+        }
+    }
+    shouldSkipOverlapping() {
+        return this.withoutOverlappingVal;
+    }
+    mutexExpiration() {
+        return this.expiresAt;
+    }
+    getTimeout() {
+        return this.timeoutVal;
+    }
+    getRetries() {
+        return this.retriesVal;
+    }
+    getRetryDelay() {
+        return this.retryDelayVal;
+    }
+    getDescription() {
+        return this.descriptionVal;
+    }
+}
+exports.Event = Event;
+//# sourceMappingURL=Event.js.map

package/dist/Event.js.map

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

package/dist/Schedule.d.ts

@@ -0,0 +1,24 @@
+import { Event } from './Event';
+export declare class Schedule {
+    protected events: Event[];
+    /**
+     * Add a new callback event to the schedule.
+     */
+    call(callback: Function): Event;
+    /**
+     * Add a new command event to the schedule.
+     */
+    command(command: string): Event;
+    /**
+     * Add a new job event to the schedule.
+     */
+    job(job: any): Event;
+    /**
+     * Get all events.
+     */
+    allEvents(): Event[];
+    /**
+     * Get due events.
+     */
+    dueEvents(date: Date, timezone?: string): Event[];
+}

package/dist/Schedule.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Schedule = void 0;
+const Event_1 = require("./Event");
+class Schedule {
+    events = [];
+    /**
+     * Add a new callback event to the schedule.
+     */
+    call(callback) {
+        const event = new Event_1.Event(callback);
+        this.events.push(event);
+        return event;
+    }
+    /**
+     * Add a new command event to the schedule.
+     */
+    command(command) {
+        const event = new Event_1.Event(command);
+        this.events.push(event);
+        return event;
+    }
+    /**
+     * Add a new job event to the schedule.
+     */
+    job(job) {
+        const event = new Event_1.Event(async () => {
+            const { Queue } = await import('@arikajs/queue');
+            await Queue.dispatch(job);
+        });
+        this.events.push(event);
+        return event;
+    }
+    /**
+     * Get all events.
+     */
+    allEvents() {
+        return this.events;
+    }
+    /**
+     * Get due events.
+     */
+    dueEvents(date, timezone) {
+        return this.events.filter(event => event.isDue(date, timezone));
+    }
+}
+exports.Schedule = Schedule;
+//# sourceMappingURL=Schedule.js.map

package/dist/Schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Schedule.js","sourceRoot":"","sources":["../src/Schedule.ts"],"names":[],"mappings":";;;AACA,mCAAgC;AAEhC,MAAa,QAAQ;IACP,MAAM,GAAY,EAAE,CAAC;IAE/B;;OAEG;IACI,IAAI,CAAC,QAAkB;QAC1B,MAAM,KAAK,GAAG,IAAI,aAAK,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;OAEG;IACI,OAAO,CAAC,OAAe;QAC1B,MAAM,KAAK,GAAG,IAAI,aAAK,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;OAEG;IACI,GAAG,CAAC,GAAQ;QACf,MAAM,KAAK,GAAG,IAAI,aAAK,CAAC,KAAK,IAAI,EAAE;YAC/B,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;YACjD,MAAM,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;OAEG;IACI,SAAS;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACI,SAAS,CAAC,IAAU,EAAE,QAAiB;QAC1C,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IACpE,CAAC;CACJ;AA9CD,4BA8CC"}

package/dist/Scheduler.d.ts

@@ -0,0 +1,27 @@
+import { Container } from '@arikajs/foundation';
+import { Schedule } from './Schedule';
+import { Event } from './Event';
+export declare class Scheduler {
+    protected container: Container;
+    protected schedule: Schedule;
+    constructor(container: Container);
+    /**
+     * Define the schedule.
+     */
+    define(callback: (schedule: Schedule) => void): this;
+    /**
+     * Run the scheduled tasks.
+     */
+    run(date?: Date): Promise<void>;
+    protected shouldSkipBecauseAnotherInstanceIsRunning(): Promise<boolean>;
+    protected runEvent(event: Event): Promise<void>;
+    protected executeWithRetries(event: Event): Promise<void>;
+    protected executeWithTimeout(event: Event): Promise<void>;
+    protected actuallyRun(event: Event): Promise<void>;
+    protected dispatchLifecycleEvent(type: string, event: Event, extra?: any): Promise<void>;
+    protected getEventName(event: Event): string;
+    protected isLocked(event: Event): Promise<boolean>;
+    protected lock(event: Event): Promise<void>;
+    protected unlock(event: Event): Promise<void>;
+    protected getMutexName(event: Event): string;
+}