@veloxts/scheduler 0.6.107 → 0.7.1

package/README.md

@@ -1,6 +1,6 @@
 # @veloxts/scheduler
 
-> **Early Access (v0.6.x)**
+> **Early Access (v0.7.x)**
 
 Cron-based task scheduling for VeloxTS Framework - provides a fluent API for defining recurring tasks with overlap prevention and timezone support. Learn more at [@veloxts/velox](https://www.npmjs.com/package/@veloxts/velox).
 

package/dist/manager.js

@@ -3,6 +3,7 @@
  *
  * Core scheduler that manages and executes scheduled tasks.
  */
+import { createLogger } from '@veloxts/core';
 import { CronJob } from 'cron';
 /**
  * Maximum execution history entries per task.
@@ -38,7 +39,7 @@ const DEFAULT_MAX_LOCK_MINUTES = 1440;
  * ```
  */
 export function createScheduler(tasks, options = {}) {
-    const { timezone: defaultTimezone = 'UTC', debug = false } = options;
+    const { timezone: defaultTimezone = 'UTC' } = options;
     // Job states
     const jobs = new Map();
     // Execution history - use per-task arrays for O(1) trimming instead of O(n²)
@@ -56,14 +57,7 @@ export function createScheduler(tasks, options = {}) {
     let running = false;
     // Track running task promises for graceful shutdown
     const runningTasks = new Map();
-    /**
-     * Log debug message.
-     */
-    function log(message) {
-        if (debug) {
-            console.log(`[scheduler] ${message}`);
-        }
-    }
+    const log = createLogger('scheduler');
     /**
      * Add execution to history.
      * O(1) amortized - uses per-task arrays with simple shift for trimming.
@@ -107,7 +101,7 @@ export function createScheduler(tasks, options = {}) {
             const lockExpired = jobState.runningStartedAt && Date.now() - jobState.runningStartedAt.getTime() > maxLockMs;
             if (lockExpired) {
                 // Lock expired - force release and allow new execution
-                log(`Lock expired for ${task.name} after ${task.maxLockMinutes ?? DEFAULT_MAX_LOCK_MINUTES} minutes, forcing new execution`);
+                log.debug(`Lock expired for ${task.name} after ${task.maxLockMinutes ?? DEFAULT_MAX_LOCK_MINUTES} minutes, forcing new execution`);
                 jobState.isRunning = false;
                 jobState.runningStartedAt = undefined;
             }
@@ -117,7 +111,7 @@ export function createScheduler(tasks, options = {}) {
                 execution.status = 'skipped';
                 execution.completedAt = new Date();
                 execution.duration = 0;
-                log(`Skipping ${task.name}: ${skipReason}`);
+                log.debug(`Skipping ${task.name}: ${skipReason}`);
                 if (task.onSkip) {
                     try {
                         await task.onSkip(ctx, skipReason);
@@ -147,7 +141,7 @@ export function createScheduler(tasks, options = {}) {
                     execution.status = 'skipped';
                     execution.completedAt = new Date();
                     execution.duration = 0;
-                    log(`Skipping ${task.name}: ${skipReason}`);
+                    log.debug(`Skipping ${task.name}: ${skipReason}`);
                     if (task.onSkip) {
                         try {
                             await task.onSkip(ctx, skipReason);
@@ -173,7 +167,7 @@ export function createScheduler(tasks, options = {}) {
                 execution.status = 'skipped';
                 execution.completedAt = new Date();
                 execution.duration = 0;
-                log(`Skipping ${task.name}: ${skipReason}`);
+                log.debug(`Skipping ${task.name}: ${skipReason}`);
                 addToHistory(execution);
                 return execution;
             }
@@ -181,7 +175,7 @@ export function createScheduler(tasks, options = {}) {
         // Mark as running
         jobState.isRunning = true;
         jobState.runningStartedAt = new Date();
-        log(`Starting ${task.name}`);
+        log.debug(`Starting ${task.name}`);
         if (options.onTaskStart) {
             try {
                 await options.onTaskStart(task, ctx);
@@ -216,7 +210,7 @@ export function createScheduler(tasks, options = {}) {
             execution.completedAt = completedAt;
             execution.duration = duration;
             jobState.lastRunAt = completedAt;
-            log(`Completed ${task.name} in ${duration}ms`);
+            log.debug(`Completed ${task.name} in ${duration}ms`);
             if (task.onSuccess) {
                 try {
                     await task.onSuccess(ctx, duration);
@@ -242,7 +236,7 @@ export function createScheduler(tasks, options = {}) {
             execution.completedAt = completedAt;
             execution.duration = duration;
             execution.error = errorObj.message;
-            log(`Failed ${task.name}: ${errorObj.message}`);
+            log.debug(`Failed ${task.name}: ${errorObj.message}`);
             if (task.onFailure) {
                 try {
                     await task.onFailure(ctx, errorObj, duration);
@@ -273,7 +267,7 @@ export function createScheduler(tasks, options = {}) {
     function initializeJobs() {
         for (const task of tasks) {
             if (!task.enabled) {
-                log(`Skipping disabled task: ${task.name}`);
+                log.debug(`Skipping disabled task: ${task.name}`);
                 continue;
             }
             const taskTimezone = task.timezone || defaultTimezone;
@@ -283,7 +277,7 @@ export function createScheduler(tasks, options = {}) {
                     // Track the running promise for graceful shutdown
                     const taskPromise = executeTask(jobState)
                         .catch((err) => {
-                        console.error(`[scheduler] Unhandled error in ${task.name}:`, err);
+                        log.error(`Unhandled error in ${task.name}:`, err);
                         // Return a failed execution to satisfy the type
                         return {
                             taskName: task.name,
@@ -308,7 +302,7 @@ export function createScheduler(tasks, options = {}) {
                 isRunning: false,
             };
             jobs.set(task.name, jobState);
-            log(`Registered task: ${task.name} (${task.cronExpression})`);
+            log.debug(`Registered task: ${task.name} (${task.cronExpression})`);
         }
     }
     // Initialize jobs
@@ -316,21 +310,21 @@ export function createScheduler(tasks, options = {}) {
     const manager = {
         start() {
             if (running) {
-                log('Scheduler already running');
+                log.debug('Scheduler already running');
                 return;
             }
             running = true;
-            log('Starting scheduler');
+            log.debug('Starting scheduler');
             for (const jobState of jobs.values()) {
                 jobState.cronJob.start();
             }
         },
         async stop() {
             if (!running) {
-                log('Scheduler not running');
+                log.debug('Scheduler not running');
                 return;
             }
-            log('Stopping scheduler');
+            log.debug('Stopping scheduler');
             // Stop all cron jobs (prevents new executions)
             for (const jobState of jobs.values()) {
                 jobState.cronJob.stop();
@@ -340,10 +334,10 @@ export function createScheduler(tasks, options = {}) {
             const maxWait = 30000; // 30 seconds
             const runningPromises = Array.from(runningTasks.values());
             if (runningPromises.length > 0) {
-                log(`Waiting for ${runningPromises.length} running task(s) to complete...`);
+                log.debug(`Waiting for ${runningPromises.length} running task(s) to complete...`);
                 const timeoutPromise = new Promise((resolve) => {
                     setTimeout(() => {
-                        log('Graceful shutdown timeout reached, forcing stop');
+                        log.debug('Graceful shutdown timeout reached, forcing stop');
                         resolve();
                     }, maxWait);
                 });
@@ -352,7 +346,7 @@ export function createScheduler(tasks, options = {}) {
             }
             running = false;
             runningTasks.clear();
-            log('Scheduler stopped');
+            log.debug('Scheduler stopped');
         },
         isRunning() {
             return running;
@@ -376,7 +370,7 @@ export function createScheduler(tasks, options = {}) {
             if (!jobState) {
                 throw new Error(`Task not found: ${name}`);
             }
-            log(`Manually running task: ${name}`);
+            log.debug(`Manually running task: ${name}`);
             return executeTask(jobState);
         },
         getNextRun(name) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veloxts/scheduler",
-  "version": "0.6.107",
+  "version": "0.7.1",
   "description": "Task scheduling for VeloxTS framework",
   "type": "module",
   "main": "./dist/index.js",
@@ -20,13 +20,13 @@
   "dependencies": {
     "cron": "4.4.0",
     "fastify-plugin": "5.1.0",
-    "@veloxts/core": "0.6.107"
+    "@veloxts/core": "0.7.1"
   },
   "peerDependencies": {
     "fastify": "^5.7.4"
   },
   "devDependencies": {
-    "@types/node": "25.1.0",
+    "@types/node": "25.2.3",
     "@vitest/coverage-v8": "4.0.18",
     "fastify": "5.7.4",
     "typescript": "5.9.3",