cron-guardian 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nisarg Satasiya
+
+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,141 @@
+# Smart Cron Manager
+
+[![npm version](https://badge.fury.io/js/smart-cron-manager.svg)](https://badge.fury.io/js/smart-cron-manager)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
+
+A reliable cron job manager for Node.js applications with retries, monitoring, and job control.
+
+## Features
+
+- ✅ **Cron Scheduling**: Standard cron expressions with second precision
+- ✅ **Named Jobs**: Unique identifiers with duplicate prevention
+- ✅ **Automatic Retries**: Configurable retry logic with delays
+- ✅ **Overlap Prevention**: Prevent concurrent job executions
+- ✅ **Execution Logging**: Comprehensive logging with performance metrics
+- ✅ **Failure Notifications**: Custom callbacks for error handling
+- ✅ **Runtime Control**: Start, stop, and remove jobs dynamically
+- ✅ **TypeScript Support**: Full type definitions included
+
+## Installation
+
+```bash
+npm install smart-cron-manager
+```
+
+**Requirements:** Node.js ≥ 18.0.0
+
+## Quick Start
+
+```typescript
+import { SmartCron } from 'smart-cron-manager';
+
+const cronManager = new SmartCron();
+
+// Schedule a simple job
+cronManager.schedule('*/5 * * * *', async () => {
+  console.log('Runs every 5 minutes');
+});
+
+// Schedule with advanced options
+cronManager.schedule('0 */1 * * *', async () => {
+  await processData();
+}, {
+  name: 'hourly-processor',
+  retries: 3,
+  retryDelay: 5000,
+  preventOverlap: true,
+  onFailure: (error, job) => {
+    console.error(`Job ${job.name} failed:`, error.message);
+  }
+});
+
+// Control jobs
+cronManager.start('hourly-processor');
+cronManager.stop('hourly-processor');
+cronManager.remove('hourly-processor');
+
+// Monitor
+const jobs = cronManager.listJobs();
+const logs = cronManager.getLogs();
+```
+
+## API Overview
+
+### Core Methods
+- `schedule(cronExpression, handler, options?)` - Schedule a new job
+- `start(jobName)` - Start a stopped job
+- `stop(jobName)` - Stop a running job
+- `remove(jobName)` - Remove a job permanently
+- `listJobs()` - Get all scheduled jobs
+- `getLogs()` - Get execution logs
+
+### Job Options
+- `name` - Unique job identifier
+- `retries` - Number of retry attempts
+- `retryDelay` - Delay between retries (ms)
+- `preventOverlap` - Prevent concurrent executions
+- `onFailure` - Error callback function
+
+## Examples
+
+### Database Backup
+```typescript
+cronManager.schedule('0 2 * * *', async () => {
+  const backup = await createBackup();
+  await uploadToS3(backup);
+}, {
+  name: 'daily-backup',
+  retries: 3,
+  retryDelay: 300000,
+  preventOverlap: true,
+  onFailure: (error) => sendAlert(`Backup failed: ${error.message}`)
+});
+```
+
+### API Health Check
+```typescript
+cronManager.schedule('*/5 * * * *', async () => {
+  const response = await fetch('https://api.example.com/health');
+  if (!response.ok) throw new Error('API unhealthy');
+}, {
+  name: 'health-check',
+  retries: 2,
+  onFailure: (error) => console.error('Health check failed:', error.message)
+});
+```
+
+## Documentation
+
+📖 **[Complete Documentation](DOCS.md)** - Includes:
+- Detailed API reference
+- Advanced usage examples
+- Edge cases and error handling
+- Best practices
+- Troubleshooting guide
+- Performance considerations
+
+## Testing
+
+```bash
+# Run tests
+npm test
+
+# Build the project
+npm run build
+
+# Run example
+node test-example.js
+```
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Contributing
+
+Contributions welcome! Please see the [contributing guidelines](CONTRIBUTING.md) and [complete documentation](DOCS.md) for details.
+
+---
+
+**Version:** 1.0.0 | **Node.js:** ≥18.0.0 | **TypeScript:** ≥4.0.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { SmartCron } from './src/smartCron';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SmartCron = void 0;
+var smartCron_1 = require("./src/smartCron");
+Object.defineProperty(exports, "SmartCron", { enumerable: true, get: function () { return smartCron_1.SmartCron; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;AAAA,6CAA4C;AAAnC,sGAAA,SAAS,OAAA"}

package/dist/src/jobRegistry/jobRegistry.d.ts

@@ -0,0 +1,9 @@
+import { Job } from '../smartCron';
+export declare class JobRegistry {
+    private jobs;
+    add(job: Job): void;
+    get(name: string): Job | undefined;
+    remove(name: string): boolean;
+    list(): Job[];
+}
+//# sourceMappingURL=jobRegistry.d.ts.map

package/dist/src/jobRegistry/jobRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobRegistry.d.ts","sourceRoot":"","sources":["../../../src/jobRegistry/jobRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAA+B;IAE3C,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI;IAOnB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS;IAIlC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI7B,IAAI,IAAI,GAAG,EAAE;CAGd"}

package/dist/src/jobRegistry/jobRegistry.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JobRegistry = void 0;
+class JobRegistry {
+    constructor() {
+        this.jobs = new Map();
+    }
+    add(job) {
+        if (this.jobs.has(job.name)) {
+            throw new Error(`Job with name ${job.name} already exists`);
+        }
+        this.jobs.set(job.name, job);
+    }
+    get(name) {
+        return this.jobs.get(name);
+    }
+    remove(name) {
+        return this.jobs.delete(name);
+    }
+    list() {
+        return Array.from(this.jobs.values());
+    }
+}
+exports.JobRegistry = JobRegistry;
+//# sourceMappingURL=jobRegistry.js.map

package/dist/src/jobRegistry/jobRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobRegistry.js","sourceRoot":"","sources":["../../../src/jobRegistry/jobRegistry.ts"],"names":[],"mappings":";;;AAEA,MAAa,WAAW;IAAxB;QACU,SAAI,GAAqB,IAAI,GAAG,EAAE,CAAC;IAoB7C,CAAC;IAlBC,GAAG,CAAC,GAAQ;QACV,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,iBAAiB,GAAG,CAAC,IAAI,iBAAiB,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,IAAY;QACjB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,CAAC;CACF;AArBD,kCAqBC"}

package/dist/src/jobRunner/jobRunner.d.ts

@@ -0,0 +1,12 @@
+import { Job } from '../smartCron';
+import { Logger } from '../logger/logger';
+import { Notifier } from '../notifier/notifier';
+import { RetryManager } from '../retryManager/retryManager';
+export declare class JobRunner {
+    private logger;
+    private notifier;
+    private retryManager;
+    constructor(logger: Logger, notifier: Notifier, retryManager: RetryManager);
+    run(job: Job): Promise<void>;
+}
+//# sourceMappingURL=jobRunner.d.ts.map

package/dist/src/jobRunner/jobRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobRunner.d.ts","sourceRoot":"","sources":["../../../src/jobRunner/jobRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAY,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,qBAAa,SAAS;IAElB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,YAAY;gBAFZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,YAAY;IAG9B,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;CAsCnC"}

package/dist/src/jobRunner/jobRunner.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JobRunner = void 0;
+class JobRunner {
+    constructor(logger, notifier, retryManager) {
+        this.logger = logger;
+        this.notifier = notifier;
+        this.retryManager = retryManager;
+    }
+    async run(job) {
+        if (job.options.preventOverlap && job.isRunning) {
+            return; // skip overlapping
+        }
+        job.isRunning = true;
+        const startTime = new Date();
+        try {
+            await this.retryManager.runWithRetries(job.handler, job.options.retries || 0, job.options.retryDelay || 0);
+            const endTime = new Date();
+            this.logger.log({
+                jobName: job.name,
+                startTime,
+                endTime,
+                duration: endTime.getTime() - startTime.getTime(),
+                status: 'success',
+            });
+        }
+        catch (error) {
+            const endTime = new Date();
+            this.logger.log({
+                jobName: job.name,
+                startTime,
+                endTime,
+                duration: endTime.getTime() - startTime.getTime(),
+                status: 'failure',
+                errorMessage: error.message,
+            });
+            this.notifier.notifyFailure(error, job);
+        }
+        finally {
+            job.isRunning = false;
+            job.lastRun = new Date();
+        }
+    }
+}
+exports.JobRunner = JobRunner;
+//# sourceMappingURL=jobRunner.js.map

package/dist/src/jobRunner/jobRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobRunner.js","sourceRoot":"","sources":["../../../src/jobRunner/jobRunner.ts"],"names":[],"mappings":";;;AAKA,MAAa,SAAS;IACpB,YACU,MAAc,EACd,QAAkB,EAClB,YAA0B;QAF1B,WAAM,GAAN,MAAM,CAAQ;QACd,aAAQ,GAAR,QAAQ,CAAU;QAClB,iBAAY,GAAZ,YAAY,CAAc;IACjC,CAAC;IAEJ,KAAK,CAAC,GAAG,CAAC,GAAQ;QAChB,IAAI,GAAG,CAAC,OAAO,CAAC,cAAc,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;YAChD,OAAO,CAAC,mBAAmB;QAC7B,CAAC;QAED,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC;QACrB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAE7B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,YAAY,CAAC,cAAc,CACpC,GAAG,CAAC,OAAO,EACX,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,EACxB,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,CAC5B,CAAC;YACF,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;gBACd,OAAO,EAAE,GAAG,CAAC,IAAI;gBACjB,SAAS;gBACT,OAAO;gBACP,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE;gBACjD,MAAM,EAAE,SAAS;aAClB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;gBACd,OAAO,EAAE,GAAG,CAAC,IAAI;gBACjB,SAAS;gBACT,OAAO;gBACP,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE;gBACjD,MAAM,EAAE,SAAS;gBACjB,YAAY,EAAG,KAAe,CAAC,OAAO;aACvC,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAc,EAAE,GAAG,CAAC,CAAC;QACnD,CAAC;gBAAS,CAAC;YACT,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC;YACtB,GAAG,CAAC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;CACF;AA7CD,8BA6CC"}

package/dist/src/logger/logger.d.ts

@@ -0,0 +1,7 @@
+import { LogEntry } from '../smartCron';
+export declare class Logger {
+    private logs;
+    log(entry: LogEntry): void;
+    getLogs(): LogEntry[];
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/logger/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/logger/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,qBAAa,MAAM;IACjB,OAAO,CAAC,IAAI,CAAkB;IAE9B,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI1B,OAAO,IAAI,QAAQ,EAAE;CAGtB"}

package/dist/src/logger/logger.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+class Logger {
+    constructor() {
+        this.logs = [];
+    }
+    log(entry) {
+        this.logs.push(entry);
+    }
+    getLogs() {
+        return this.logs;
+    }
+}
+exports.Logger = Logger;
+//# sourceMappingURL=logger.js.map

package/dist/src/logger/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/logger/logger.ts"],"names":[],"mappings":";;;AAEA,MAAa,MAAM;IAAnB;QACU,SAAI,GAAe,EAAE,CAAC;IAShC,CAAC;IAPC,GAAG,CAAC,KAAe;QACjB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;CACF;AAVD,wBAUC"}

package/dist/src/notifier/notifier.d.ts

@@ -0,0 +1,5 @@
+import { Job } from '../smartCron';
+export declare class Notifier {
+    notifyFailure(error: Error, job: Job): void;
+}
+//# sourceMappingURL=notifier.d.ts.map

package/dist/src/notifier/notifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.d.ts","sourceRoot":"","sources":["../../../src/notifier/notifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,qBAAa,QAAQ;IACnB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI;CAK5C"}

package/dist/src/notifier/notifier.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Notifier = void 0;
+class Notifier {
+    notifyFailure(error, job) {
+        if (job.options.onFailure) {
+            job.options.onFailure(error, job);
+        }
+    }
+}
+exports.Notifier = Notifier;
+//# sourceMappingURL=notifier.js.map

package/dist/src/notifier/notifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.js","sourceRoot":"","sources":["../../../src/notifier/notifier.ts"],"names":[],"mappings":";;;AAEA,MAAa,QAAQ;IACnB,aAAa,CAAC,KAAY,EAAE,GAAQ;QAClC,IAAI,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YAC1B,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;CACF;AAND,4BAMC"}

package/dist/src/retryManager/retryManager.d.ts

@@ -0,0 +1,4 @@
+export declare class RetryManager {
+    runWithRetries(handler: () => Promise<void>, retries: number, delay: number): Promise<void>;
+}
+//# sourceMappingURL=retryManager.d.ts.map

package/dist/src/retryManager/retryManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retryManager.d.ts","sourceRoot":"","sources":["../../../src/retryManager/retryManager.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAY;IACjB,cAAc,CAClB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC5B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC;CAejB"}

package/dist/src/retryManager/retryManager.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetryManager = void 0;
+class RetryManager {
+    async runWithRetries(handler, retries, delay) {
+        let attempts = 0;
+        while (attempts <= retries) {
+            try {
+                await handler();
+                return;
+            }
+            catch (error) {
+                attempts++;
+                if (attempts > retries) {
+                    throw error;
+                }
+                await new Promise((resolve) => setTimeout(resolve, delay));
+            }
+        }
+    }
+}
+exports.RetryManager = RetryManager;
+//# sourceMappingURL=retryManager.js.map

package/dist/src/retryManager/retryManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retryManager.js","sourceRoot":"","sources":["../../../src/retryManager/retryManager.ts"],"names":[],"mappings":";;;AAAA,MAAa,YAAY;IACvB,KAAK,CAAC,cAAc,CAClB,OAA4B,EAC5B,OAAe,EACf,KAAa;QAEb,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,OAAO,QAAQ,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,OAAO,EAAE,CAAC;gBAChB,OAAO;YACT,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,QAAQ,EAAE,CAAC;gBACX,IAAI,QAAQ,GAAG,OAAO,EAAE,CAAC;oBACvB,MAAM,KAAK,CAAC;gBACd,CAAC;gBACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;IACH,CAAC;CACF;AApBD,oCAoBC"}

package/dist/src/scheduler/scheduler.d.ts

@@ -0,0 +1,11 @@
+import { Job } from '../smartCron';
+import { JobRunner } from '../jobRunner/jobRunner';
+export declare class Scheduler {
+    private jobRunner;
+    constructor(jobRunner: JobRunner);
+    scheduleJob(job: Job): void;
+    startJob(job: Job): void;
+    stopJob(job: Job): void;
+    destroyJob(job: Job): void;
+}
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/src/scheduler/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../../src/scheduler/scheduler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,qBAAa,SAAS;IACR,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAExC,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI;IAO3B,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI;IAMxB,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI;IAMvB,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI;CAK3B"}

package/dist/src/scheduler/scheduler.js

@@ -0,0 +1,65 @@
+"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 __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.Scheduler = void 0;
+const cron = __importStar(require("node-cron"));
+class Scheduler {
+    constructor(jobRunner) {
+        this.jobRunner = jobRunner;
+    }
+    scheduleJob(job) {
+        const scheduledJob = cron.schedule(job.cronExpression, () => {
+            this.jobRunner.run(job);
+        });
+        job.scheduledJob = scheduledJob;
+    }
+    startJob(job) {
+        if (job.scheduledJob) {
+            job.scheduledJob.start();
+        }
+    }
+    stopJob(job) {
+        if (job.scheduledJob) {
+            job.scheduledJob.stop();
+        }
+    }
+    destroyJob(job) {
+        if (job.scheduledJob) {
+            job.scheduledJob.stop();
+        }
+    }
+}
+exports.Scheduler = Scheduler;
+//# sourceMappingURL=scheduler.js.map

package/dist/src/scheduler/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../../../src/scheduler/scheduler.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,gDAAkC;AAIlC,MAAa,SAAS;IACpB,YAAoB,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;IAAG,CAAC;IAE5C,WAAW,CAAC,GAAQ;QAClB,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,EAAE,GAAG,EAAE;YAC1D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,YAAY,GAAG,YAAY,CAAC;IAClC,CAAC;IAED,QAAQ,CAAC,GAAQ;QACf,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;YACrB,GAAG,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAQ;QACd,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;YACrB,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,UAAU,CAAC,GAAQ;QACjB,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;YACrB,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;CACF;AA3BD,8BA2BC"}

package/dist/src/smartCron.d.ts

@@ -0,0 +1,40 @@
+import * as cron from 'node-cron';
+export interface JobOptions {
+    name?: string;
+    retries?: number;
+    retryDelay?: number;
+    preventOverlap?: boolean;
+    onFailure?: (error: Error, job: Job) => void;
+}
+export interface Job {
+    name: string;
+    cronExpression: string;
+    handler: () => Promise<void>;
+    options: JobOptions;
+    scheduledJob?: cron.ScheduledTask;
+    isRunning: boolean;
+    lastRun?: Date;
+}
+export interface LogEntry {
+    jobName: string;
+    startTime: Date;
+    endTime: Date;
+    duration: number;
+    status: 'success' | 'failure';
+    errorMessage?: string;
+}
+export declare class SmartCron {
+    private registry;
+    private logger;
+    private notifier;
+    private retryManager;
+    private jobRunner;
+    private scheduler;
+    schedule(cronExpression: string, handler: () => Promise<void>, options?: JobOptions): Job;
+    start(name: string): void;
+    stop(name: string): void;
+    remove(name: string): void;
+    listJobs(): Job[];
+    getLogs(): LogEntry[];
+}
+//# sourceMappingURL=smartCron.d.ts.map

package/dist/src/smartCron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smartCron.d.ts","sourceRoot":"","sources":["../../src/smartCron.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAQlC,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,EAAE,UAAU,CAAC;IACpB,YAAY,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,SAAS,CAAgE;IACjF,OAAO,CAAC,SAAS,CAAiC;IAElD,QAAQ,CACN,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC5B,OAAO,GAAE,UAAe,GACvB,GAAG;IAiBN,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMzB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMxB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO1B,QAAQ,IAAI,GAAG,EAAE;IAIjB,OAAO,IAAI,QAAQ,EAAE;CAGtB"}

package/dist/src/smartCron.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SmartCron = void 0;
+const jobRegistry_1 = require("./jobRegistry/jobRegistry");
+const jobRunner_1 = require("./jobRunner/jobRunner");
+const retryManager_1 = require("./retryManager/retryManager");
+const logger_1 = require("./logger/logger");
+const notifier_1 = require("./notifier/notifier");
+const scheduler_1 = require("./scheduler/scheduler");
+class SmartCron {
+    constructor() {
+        this.registry = new jobRegistry_1.JobRegistry();
+        this.logger = new logger_1.Logger();
+        this.notifier = new notifier_1.Notifier();
+        this.retryManager = new retryManager_1.RetryManager();
+        this.jobRunner = new jobRunner_1.JobRunner(this.logger, this.notifier, this.retryManager);
+        this.scheduler = new scheduler_1.Scheduler(this.jobRunner);
+    }
+    schedule(cronExpression, handler, options = {}) {
+        const name = options.name || `job-${Date.now()}`;
+        const job = {
+            name,
+            cronExpression,
+            handler,
+            options,
+            isRunning: false,
+        };
+        this.registry.add(job);
+        // Schedule the job
+        this.scheduler.scheduleJob(job);
+        return job;
+    }
+    start(name) {
+        const job = this.registry.get(name);
+        if (!job)
+            throw new Error(`Job ${name} not found`);
+        this.scheduler.startJob(job);
+    }
+    stop(name) {
+        const job = this.registry.get(name);
+        if (!job)
+            throw new Error(`Job ${name} not found`);
+        this.scheduler.stopJob(job);
+    }
+    remove(name) {
+        const job = this.registry.get(name);
+        if (!job)
+            throw new Error(`Job ${name} not found`);
+        this.scheduler.destroyJob(job);
+        this.registry.remove(name);
+    }
+    listJobs() {
+        return this.registry.list();
+    }
+    getLogs() {
+        return this.logger.getLogs();
+    }
+}
+exports.SmartCron = SmartCron;
+//# sourceMappingURL=smartCron.js.map

package/dist/src/smartCron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smartCron.js","sourceRoot":"","sources":["../../src/smartCron.ts"],"names":[],"mappings":";;;AACA,2DAAwD;AACxD,qDAAkD;AAClD,8DAA2D;AAC3D,4CAAyC;AACzC,kDAA+C;AAC/C,qDAAkD;AA6BlD,MAAa,SAAS;IAAtB;QACU,aAAQ,GAAG,IAAI,yBAAW,EAAE,CAAC;QAC7B,WAAM,GAAG,IAAI,eAAM,EAAE,CAAC;QACtB,aAAQ,GAAG,IAAI,mBAAQ,EAAE,CAAC;QAC1B,iBAAY,GAAG,IAAI,2BAAY,EAAE,CAAC;QAClC,cAAS,GAAG,IAAI,qBAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACzE,cAAS,GAAG,IAAI,qBAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAiDpD,CAAC;IA/CC,QAAQ,CACN,cAAsB,EACtB,OAA4B,EAC5B,UAAsB,EAAE;QAExB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACjD,MAAM,GAAG,GAAQ;YACf,IAAI;YACJ,cAAc;YACd,OAAO;YACP,OAAO;YACP,SAAS,EAAE,KAAK;SACjB,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEvB,mBAAmB;QACnB,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAEhC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,IAAY;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,YAAY,CAAC,CAAC;QACnD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,CAAC,IAAY;QACf,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,YAAY,CAAC,CAAC;QACnD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,IAAY;QACjB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,YAAY,CAAC,CAAC;QACnD,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IAC/B,CAAC;CACF;AAvDD,8BAuDC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "cron-guardian",
+  "version": "1.0.0",
+  "description": "A reliable cron job manager for Node.js applications with retries, monitoring, and job control",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "cron",
+    "scheduler",
+    "nodejs",
+    "jobs",
+    "retries"
+  ],
+  "author": "Nisarg Satasiya",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NISARG-J/smart-cron-manager"
+  },
+  "homepage": "https://github.com/NISARG-J/smart-cron-manager#readme",
+  "bugs": {
+    "url": "https://github.com/NISARG-J/smart-cron-manager/issues"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE",
+    "DOCS.md",
+    "CONTRIBUTING.md"
+  ],
+  "dependencies": {
+    "node-cron": "^3.0.3"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.11.24",
+    "@types/node-cron": "^3.0.11",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}