bootifyjs 1.4.0 → 2.1.0

package/dist/scheduling/scheduler.service.js

@@ -0,0 +1,359 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchedulerService = void 0;
+/**
+ * SchedulerService - Manages scheduled job execution
+ */
+const component_registry_1 = require("../core/component-registry");
+const decorators_1 = require("../core/decorators");
+const di_container_1 = require("../core/di-container");
+const logging_1 = require("../logging");
+const scheduled_decorator_1 = require("./scheduled.decorator");
+let SchedulerService = class SchedulerService {
+    constructor() {
+        this.jobs = new Map();
+        this.isStarted = false;
+        this.nodeCron = null;
+    }
+    get logger() {
+        try {
+            return (0, logging_1.getLogger)();
+        }
+        catch {
+            // Fallback to console if logger not initialized
+            return {
+                info: (msg, ctx) => console.log(`[Scheduler] ${msg}`, ctx || ''),
+                warn: (msg, ctx) => console.warn(`[Scheduler] ${msg}`, ctx || ''),
+                error: (msg, err, ctx) => console.error(`[Scheduler] ${msg}`, err, ctx || ''),
+                debug: (msg, ctx) => console.debug(`[Scheduler] ${msg}`, ctx || ''),
+            };
+        }
+    }
+    /**
+     * Initialize and start all scheduled jobs
+     */
+    async start() {
+        if (this.isStarted) {
+            this.logger.warn('Scheduler already started');
+            return;
+        }
+        // Try to load node-cron
+        try {
+            this.nodeCron = await Promise.resolve().then(() => __importStar(require('node-cron')));
+        }
+        catch {
+            this.logger.warn('node-cron not installed. Cron expressions will not work. Install with: npm install node-cron');
+        }
+        // Discover all scheduled jobs from registered components
+        this.discoverJobs();
+        // Start all jobs
+        Array.from(this.jobs.entries()).forEach(([_name, job]) => {
+            this.startJob(job);
+        });
+        this.isStarted = true;
+        this.logger.info('Scheduler started', { totalJobs: this.jobs.size });
+    }
+    /**
+     * Stop all scheduled jobs gracefully
+     */
+    async stop() {
+        if (!this.isStarted)
+            return;
+        this.logger.info('Stopping all scheduled jobs...');
+        const stopPromises = [];
+        Array.from(this.jobs.entries()).forEach(([_name, job]) => {
+            // Stop timers
+            if (job.timer) {
+                clearInterval(job.timer);
+                clearTimeout(job.timer);
+            }
+            // Stop cron jobs
+            if (job.cronJob?.stop) {
+                job.cronJob.stop();
+            }
+            // Wait for running jobs to complete
+            if (job.isRunning) {
+                stopPromises.push(new Promise((resolve) => {
+                    const checkInterval = setInterval(() => {
+                        if (!job.isRunning) {
+                            clearInterval(checkInterval);
+                            resolve();
+                        }
+                    }, 100);
+                    // Timeout after 30 seconds
+                    setTimeout(() => {
+                        clearInterval(checkInterval);
+                        resolve();
+                    }, 30000);
+                }));
+            }
+        });
+        await Promise.all(stopPromises);
+        this.jobs.clear();
+        this.isStarted = false;
+        this.logger.info('All scheduled jobs stopped');
+    }
+    /**
+     * Manually trigger a job by name
+     */
+    async trigger(jobName) {
+        const job = this.jobs.get(jobName);
+        if (!job) {
+            throw new Error(`[Scheduler] Job '${jobName}' not found`);
+        }
+        await this.executeJob(job);
+    }
+    /**
+     * Enable a job
+     */
+    enable(jobName) {
+        const job = this.jobs.get(jobName);
+        if (!job) {
+            throw new Error(`[Scheduler] Job '${jobName}' not found`);
+        }
+        job.metadata.options.enabled = true;
+        job.status.status = 'idle';
+        this.startJob(job);
+        this.logger.info('Job enabled', { jobName });
+    }
+    /**
+     * Disable a job
+     */
+    disable(jobName) {
+        const job = this.jobs.get(jobName);
+        if (!job) {
+            throw new Error(`[Scheduler] Job '${jobName}' not found`);
+        }
+        job.metadata.options.enabled = false;
+        job.status.status = 'disabled';
+        if (job.timer) {
+            clearInterval(job.timer);
+            clearTimeout(job.timer);
+        }
+        if (job.cronJob?.stop) {
+            job.cronJob.stop();
+        }
+        this.logger.info('Job disabled', { jobName });
+    }
+    /**
+     * Get status of all jobs
+     */
+    getStats() {
+        const jobs = Array.from(this.jobs.values()).map(j => ({ ...j.status }));
+        return {
+            totalJobs: jobs.length,
+            runningJobs: jobs.filter(j => j.status === 'running').length,
+            disabledJobs: jobs.filter(j => j.status === 'disabled').length,
+            jobs,
+        };
+    }
+    /**
+     * Get status of a specific job
+     */
+    getJobStatus(jobName) {
+        return this.jobs.get(jobName)?.status;
+    }
+    discoverJobs() {
+        const components = Array.from(component_registry_1.registeredComponents);
+        for (let i = 0; i < components.length; i++) {
+            const componentClass = components[i];
+            const scheduledMethods = Reflect.getMetadata(scheduled_decorator_1.SCHEDULED_METADATA_KEY, componentClass) || [];
+            if (scheduledMethods.length === 0)
+                continue;
+            // Resolve the instance from DI container
+            let instance;
+            try {
+                instance = di_container_1.container.resolve(componentClass);
+            }
+            catch (error) {
+                this.logger.error(`Failed to resolve component`, error, { component: componentClass.name });
+                continue;
+            }
+            for (let j = 0; j < scheduledMethods.length; j++) {
+                const metadata = scheduledMethods[j];
+                const jobName = `${componentClass.name}.${metadata.options.name}`;
+                if (this.jobs.has(jobName)) {
+                    this.logger.warn('Duplicate job name', { jobName });
+                    continue;
+                }
+                this.jobs.set(jobName, {
+                    metadata,
+                    instance,
+                    status: {
+                        name: jobName,
+                        status: metadata.options.enabled ? 'idle' : 'disabled',
+                        runCount: 0,
+                        errorCount: 0,
+                    },
+                    isRunning: false,
+                    durations: [],
+                });
+                this.logger.debug('Registered scheduled job', { jobName });
+            }
+        }
+    }
+    startJob(job) {
+        const { options } = job.metadata;
+        if (!options.enabled) {
+            job.status.status = 'disabled';
+            return;
+        }
+        // Run on init if specified
+        if (options.runOnInit) {
+            setImmediate(() => this.executeJob(job));
+        }
+        // Setup cron schedule
+        if (options.cron) {
+            if (!this.nodeCron) {
+                this.logger.error('Cannot start cron job: node-cron not installed', undefined, { jobName: job.status.name });
+                return;
+            }
+            const cronOptions = {};
+            if (options.timezone) {
+                cronOptions.timezone = options.timezone;
+            }
+            try {
+                job.cronJob = this.nodeCron.schedule(options.cron, () => {
+                    this.executeJob(job);
+                }, cronOptions);
+                // Calculate next run
+                job.status.nextRun = this.getNextCronRun(options.cron);
+            }
+            catch (error) {
+                this.logger.error('Invalid cron expression', error, { jobName: job.status.name });
+                job.status.status = 'error';
+                job.status.lastError = error.message;
+            }
+        }
+        // Setup interval
+        if (options.interval) {
+            job.timer = setInterval(() => {
+                this.executeJob(job);
+            }, options.interval);
+            job.status.nextRun = new Date(Date.now() + options.interval);
+        }
+        // Setup fixed delay (runs after previous execution completes)
+        if (options.fixedDelay && !options.interval && !options.cron) {
+            const runWithDelay = async () => {
+                await this.executeJob(job);
+                if (job.metadata.options.enabled) {
+                    job.timer = setTimeout(runWithDelay, options.fixedDelay);
+                    job.status.nextRun = new Date(Date.now() + options.fixedDelay);
+                }
+            };
+            job.timer = setTimeout(runWithDelay, options.fixedDelay);
+            job.status.nextRun = new Date(Date.now() + options.fixedDelay);
+        }
+    }
+    async executeJob(job) {
+        const { options, methodName } = job.metadata;
+        // Check if job is enabled
+        if (!options.enabled)
+            return;
+        // Prevent overlap if configured
+        if (options.preventOverlap && job.isRunning) {
+            this.logger.debug('Skipping job - previous execution still running', { jobName: job.status.name });
+            return;
+        }
+        job.isRunning = true;
+        job.status.status = 'running';
+        const startTime = Date.now();
+        let attempt = 0;
+        const maxAttempts = (options.maxRetries || 0) + 1;
+        while (attempt < maxAttempts) {
+            try {
+                attempt++;
+                await job.instance[methodName]();
+                // Success
+                const duration = Date.now() - startTime;
+                job.durations.push(duration);
+                if (job.durations.length > 100)
+                    job.durations.shift(); // Keep last 100
+                job.status.lastRun = new Date();
+                job.status.runCount++;
+                job.status.averageDuration = job.durations.reduce((a, b) => a + b, 0) / job.durations.length;
+                job.status.status = 'idle';
+                job.status.lastError = undefined;
+                // Update next run time
+                if (options.cron) {
+                    job.status.nextRun = this.getNextCronRun(options.cron);
+                }
+                else if (options.interval) {
+                    job.status.nextRun = new Date(Date.now() + options.interval);
+                }
+                break; // Exit retry loop on success
+            }
+            catch (error) {
+                this.logger.error('Job execution failed', error, {
+                    jobName: job.status.name,
+                    attempt,
+                    maxAttempts
+                });
+                if (attempt >= maxAttempts) {
+                    job.status.errorCount++;
+                    job.status.lastError = error.message;
+                    job.status.status = 'error';
+                }
+                else {
+                    // Wait before retry
+                    await new Promise(resolve => setTimeout(resolve, options.retryDelay || 1000));
+                }
+            }
+        }
+        job.isRunning = false;
+        // Reset status to idle if not in error state
+        if (job.status.status === 'running') {
+            job.status.status = 'idle';
+        }
+    }
+    getNextCronRun(cronExpression) {
+        // Simple approximation - for accurate next run, would need cron-parser
+        // This is a placeholder that returns undefined
+        // Users can install cron-parser for accurate next run times
+        return undefined;
+    }
+};
+exports.SchedulerService = SchedulerService;
+exports.SchedulerService = SchedulerService = __decorate([
+    (0, decorators_1.Service)()
+], SchedulerService);
+//# sourceMappingURL=scheduler.service.js.map

package/dist/scheduling/scheduler.service.js.map

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

package/dist/scheduling/scheduler.types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * BootifyJS Scheduling Types
+ */
+export interface ScheduledJobOptions {
+    /** Cron expression (e.g., '0 * * * *' for every hour) */
+    cron?: string;
+    /** Interval in milliseconds */
+    interval?: number;
+    /** Fixed delay in milliseconds (waits after completion before next run) */
+    fixedDelay?: number;
+    /** Run immediately on startup */
+    runOnInit?: boolean;
+    /** Prevent overlapping executions */
+    preventOverlap?: boolean;
+    /** Job name (defaults to method name) */
+    name?: string;
+    /** Timezone for cron expressions */
+    timezone?: string;
+    /** Maximum retries on failure */
+    maxRetries?: number;
+    /** Delay between retries in ms */
+    retryDelay?: number;
+    /** Whether the job is enabled */
+    enabled?: boolean;
+}
+export interface ScheduledJobMetadata {
+    methodName: string;
+    options: ScheduledJobOptions;
+    target: any;
+}
+export interface JobStatus {
+    name: string;
+    status: 'running' | 'idle' | 'disabled' | 'error';
+    lastRun?: Date;
+    lastError?: string;
+    nextRun?: Date;
+    runCount: number;
+    errorCount: number;
+    averageDuration?: number;
+}
+export interface SchedulerStats {
+    totalJobs: number;
+    runningJobs: number;
+    disabledJobs: number;
+    jobs: JobStatus[];
+}
+//# sourceMappingURL=scheduler.types.d.ts.map

package/dist/scheduling/scheduler.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.types.d.ts","sourceRoot":"","sources":["../../src/scheduling/scheduler.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,mBAAmB;IAChC,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iCAAiC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,qCAAqC;IACrC,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iCAAiC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,oBAAoB;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,mBAAmB,CAAA;IAC5B,MAAM,EAAE,GAAG,CAAA;CACd;AAED,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAA;IACjD,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,SAAS,EAAE,CAAA;CACpB"}

package/dist/scheduling/scheduler.types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * BootifyJS Scheduling Types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=scheduler.types.js.map

package/dist/scheduling/scheduler.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.types.js","sourceRoot":"","sources":["../../src/scheduling/scheduler.types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bootifyjs",
-  "version": "1.4.0",
+  "version": "2.1.0",
   "keywords": [],
   "author": "Piyush Priyadarshi",
   "license": "ISC",
@@ -46,6 +46,11 @@
       "import": "./dist/config/index.js",
       "require": "./dist/config/index.js",
       "types": "./dist/config/index.d.ts"
+    },
+    "./scheduling": {
+      "import": "./dist/scheduling/index.js",
+      "require": "./dist/scheduling/index.js",
+      "types": "./dist/scheduling/index.d.ts"
     }
   },
   "dependencies": {
@@ -59,13 +64,23 @@
     "zod": "^3.25.76",
     "zod-to-json-schema": "^3.24.6"
   },
+  "peerDependencies": {
+    "node-cron": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "node-cron": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@fastify/swagger": "^9.5.1",
     "@fastify/swagger-ui": "^5.2.3",
     "@types/dotenv": "^6.1.1",
     "@types/node": "^24.1.0",
+    "@types/node-cron": "^3.0.11",
     "@types/validate-npm-package-name": "^4.0.2",
     "dotenv": "^17.2.1",
+    "node-cron": "^3.0.3",
     "nodemon": "^3.1.10",
     "pino-pretty": "^13.0.0",
     "ts-node": "^10.9.2",