agenda-ts 1.6.9-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Mohamed Meabed <mo.meabed@gmail.com>
+
+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,353 @@
+<p align="center">
+  <img src="./pulse.png" width="100" alt="project-logo">
+</p>
+<p align="center">
+            <h1 align="center">AGENDA-TS</h1>
+</p>
+<p align="center">
+    <em>The modern MongoDB-powered job scheduler library for Node.js</em>
+</p>
+<p align="center">
+			<img src="https://img.shields.io/github/license/meabed/agenda-ts?style=default&logo=opensourceinitiative&logoColor=white&color=24E0A4" alt="license">
+	<img src="https://img.shields.io/github/last-commit/meabed/agenda-ts?style=default&logo=git&logoColor=white&color=24E0A4" alt="last-commit">
+	<img src="https://img.shields.io/github/languages/top/meabed/agenda-ts?style=default&color=24E0A4" alt="repo-top-language">
+	<img src="https://img.shields.io/github/languages/count/meabed/agenda-ts?style=default&color=24E0A4" alt="repo-language-count">
+<p>
+<p align="center">
+	<!-- default option, no dependency badges. -->
+</p>
+
+<br><!-- TABLE OF CONTENTS -->
+
+<p align="center">
+        <a href="https://github.com/meabed/agenda-ts">Documentation</a> | <a href="https://github.com/meabed/agenda-ts">Repository</a>
+</p>
+<details>
+  <summary>Table of Contents</summary><br>
+
+- [Overview](#overview)
+    - [Related Projects](#related-projects)
+- [Unique Features in Agenda-TS](#unique-features-in-agenda-ts)
+- [Repository Structure](#repository-structure)
+- [Modules](#modules)
+- [Getting Started](#getting-started)
+    - [Installation](#installation)
+    - [Example](#example)
+- [Project Roadmap](#project-roadmap)
+- [Contributing](#contributing)
+- [License](#license)
+- [Acknowledgments](#acknowledgments)
+</details>
+<hr>
+
+##  Overview
+
+Agenda-TS is a modern TypeScript fork of the [Agenda](https://github.com/agenda/agenda) project, created as the original project is no longer actively maintained. Positioned as a vital solution in the Node.js ecosystem for job scheduling, the hiatus of Agenda prompted the creation of Agenda-TS. Utilizing MongoDB, Agenda-TS introduces advanced functionalities, improved scalability, and contemporary features to address today's complex scheduling challenges.
+
+<br/>
+
+#### Related Projects
+- [agenda-ts](https://github.com/meabed/agenda-ts) - Modern MongoDB-powered job scheduler for Node.js
+- [nestjs-agenda-ts](https://github.com/meabed/nestjs-agenda-ts) - official NestJS module for Agenda-TS.
+
+---
+
+<br/>
+<br/>
+
+
+##  Unique Features in Agenda-TS
+
+- **Latest MongoDB Driver Support**: Agenda-TS is fully compatible with the latest MongoDB driver, ensuring users can take advantage of the most current database features and enhancements.
+- **Resume Incomplete Tasks After System Restart**: When the system restarts, Agenda-TS resumes incomplete tasks that were in progress or queued for execution, providing seamless continuation without manual intervention.
+- **Retry Failed Tasks**: Agenda-TS offers retry mechanisms using exponential and fixed backoff strategies with configurable attempts, ensuring efficient retries of failed tasks without overwhelming the system.
+- **Continuous Maintenance**: As an open-source project actively maintained, Agenda-TS is consistently improved, providing users with reliable updates and support.
+- **Extensive Documentation**: Provides detailed guides and examples for a quick and easy start.
+
+---
+<br/>
+<br/>
+
+##  Repository Structure
+
+```sh
+└── agenda-ts/
+    ├── LICENSE
+    ├── README.md
+    ├── es.js
+    ├── examples
+    │   └── concurrency.ts
+    ├── package-lock.json
+    ├── package.json
+    ├── src
+    │   ├── cjs.ts
+    │   ├── index.ts
+    │   ├── job
+    │   ├── pulse
+    │   └── utils
+    ├── tsconfig.eslint.json
+    └── tsconfig.json
+```
+
+---
+<br/>
+<br/>
+
+##  Modules
+
+<details closed><summary>src.pulse</summary>
+
+| File                                                                                                            | Summary                                                                                                                                                                                                                                                                                                                       |
+| ---                                                                                                             | ---                                                                                                                                                                                                                                                                                                                           |
+| [has-mongo-protocol.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/has-mongo-protocol.ts)         | HasMongoProtocol establishes a function that evaluates if a given URL string contains a valid MongoDB connection protocol, contributing to the repositorys ability to handle and verify database connections.                                                                                                                 |
+| [default-concurrency.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/default-concurrency.ts)       | Sets the default concurrency for each job within the Agendta-TS open-source project by modifying the internal state. It contributes to the task scheduling and management functionalities in the project.                                                                                                                          |
+| [name.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/name.ts)                                     | Sets the name of a queue within the Agendta object in the parent repositorys architecture. It utilizes debugging for traceability and maintains the flow architecture by returning the Agendta instance after the name assignment.                                                                                                |
+| [drain.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/drain.ts)                                   | Drain.ts serves a crucial role in the Agendta module, enabling the cancellation of ongoing job processes. It ensures that all running jobs get completed before terminating the processing interval, promoting an efficient and orderly execution flow in the application.                                                      |
+| [enable.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/enable.ts)                                 | Enables specific jobs within the Agendta module by toggling the disabled flag to false. Utilizes MongoDB queries to precisely select matching jobs, aspiring to enhance the flexibility and robustness of job execution. Returns the count of jobs successfully enabled, aiding in operational tracking.                        |
+| [schedule.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/schedule.ts)                             | Schedule.ts within the Agenda directory facilitates job scheduling for specific timings. Through this module, users can assign an array of job names to be executed at a specified time, along with associated data. Multiple jobs can be created at once, enhancing the efficiency of task management in the repository.      |
+| [default-lock-lifetime.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/default-lock-lifetime.ts)   | Establishes the default lock lifetime in an Agendta application. It allows setting the default lock time in milliseconds, providing flexibility in managing task execution timelines. This is a critical feature for handling concurrency control in Agendta's job processing system.                                               |
+| [db-init.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/db-init.ts)                               | Establishes and initializes the database collection for job management in the Agendta-TS open-source project. It also includes optional index creation functionality, providing efficient job searching within the database. Notifiers for success or errors make the process transparent and manageable.                          |
+| [process-every.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/process-every.ts)                   | ProcessEvery sets a default interval for an Agendta objects processing time. It leverages human-readable time intervals to determine the frequency of certain operations within the agenda directory of the repository. This function returns the updated Agendta object.                                                           |
+| [disable.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/disable.ts)                               | Disables selected jobs in the Agendta application by applying a MongoDB filter query. The function returns the number of successfully disabled job instances, providing enhanced control over task execution.                                                                                                                   |
+| [jobs.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/jobs.ts)                                     | Within the Agendta-TS repository, the jobs.ts script from the src/pulse directory performs a crucial task. It retrieves all jobs matching a certain query from a MongoDB collection, with options for sorting, limiting and skipping results, transforming these into job objects before returning.                                |
+| [start.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/start.ts)                                   | Start.ts initializes job processing for the Agendta module. It validates system readiness before periodically processing tasks using the processJobs method from the utils directory. The method ensures job execution regularity and guarantees uninterrupted operation, provided a database is set beforehand.                |
+| [every.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/every.ts)                                   | Within the agendta directory, every.ts establishes a regular job execution framework. It enables job scheduling at specified intervals, handling singular and multiple job names. Pertinent debugging information for scheduled job processes is also provided by this module.                                                  |
+| [max-concurrency.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/max-concurrency.ts)               | MaxConcurrency controls job execution in the Agendta system by globally setting the maximum concurrency value, thereby optimizing task management. It directly interacts with the core Agendta framework, ensuring that job execution does not exceed the defined threshold, enhancing overall process efficiency.                |
+| [purge.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/purge.ts)                                   | Purge.ts, within the agenda subdirectory, provides functionality to remove all jobs from the queue in the Agenda application. It exports an asynchronous function that cancels undefined jobs, ensuring only defined jobs remain. The function's outcome is confirmed with success or failure notifications.                    |
+| [now.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/now.ts)                                       | Establishes a function within the Agenda module, designed to create a job task instantly. This function, named now, accepts job details, schedules it for the current time, saves the job into the system, and handles potential creation errors.                                                                              |
+| [default-lock-limit.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/default-lock-limit.ts)         | Defines the maximum number of locks per job type in the Agenda system. It establishes a default limit, with each instance adjustable per user needs. The limit optimizes concurrent task handling, enhancing overall application performance.                                                                                  |
+| [stop.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/stop.ts)                                     | Stop.ts within the Agenda sub-directory is responsible for terminating the process of job execution. It achieves this by unlocking jobs that were locked for processing, allowing them to be re-run or accessed, and by clearing the job execution interval, effectively stopping further job processing.                      |
+| [database.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/database.ts)                             | Database.ts, located in the src/pulse directory, establishes a connection to a specified MongoDB server. It features the flexibility to use an existing MongoDB connection, customize collection names, and handle connection errors. Ultimately, this file integrates MongoDB into the broader Agenda architecture.           |
+| [sort.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/sort.ts)                                     | Sort.ts orchestrates the sorting functionality within the Agenda component, allowing users to customize their queries for job searches. It primarily manages the rules for prioritizing and scheduling jobs, with the default being jobs sorted by their next run time and priority.                                           |
+| [mongo.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/mongo.ts)                                   | Mongo.ts integrates MongoDB with the Agenda application, enabling the establishment of database connections. It provides a method to inject MongoClient instance, specify the collection, and handle database initialization errors through callbacks.                                                                         |
+| [cancel.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/cancel.ts)                                 | Cancel.ts facilitates the termination of specific Agenda jobs based on a provided MongoDB query, effectively removing them from the database. These cancellations can be initiated by the client code, the Agenda.purge() function, or the Job.remove() function.                                                               |
+| [index.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/index.ts)                                   | Agenda, the heart of the repository, manages a queue of jobs in a MongoDB collection. This task scheduling system facilitates job creation, scheduling, locking, and execution, handling concurrency defaults, lock limits, and durations. Moreover, it supports optional configuration and customization parameters.          |
+| [define.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/define.ts)                                 | Defines job parameters and execution procedures in the Agenda library. Users can configure concurrency, locking, priority, lifetime, and result persistence for a named job. Job definitions are stored and debugged for future execution within the Agendta system.                                                             |
+| [create.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/create.ts)                                 | Creates new jobs within the Agendta module of the repository. This piece of code initializes these jobs with given names and data, also setting specific attributes such as priority and whether to save results based on predefined definitions.                                                                               |
+| [find-and-lock-next-job.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/find-and-lock-next-job.ts) | Unlocks and processes queued jobs within the Agenda-TS repository. In the find-and-lock-next-job file, the function identifies a specific job based on its name, locks it for execution, and returns the job status. This operation ensures efficient management of tasks within the system.                                      |
+| [job-processing-queue.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/job-processing-queue.ts)     | JobProcessingQueue, as part of the larger Agenda-TS repository, manages job processing through an internal queue. It offers capabilities like job insertion in a specific order, popping jobs without concurrency checks, and identifying the next job eligible for processing whose execution isnt blocked by concurrency.       |
+| [lock-limit.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/lock-limit.ts)                         | LockLimit sets a global upper limit on the number of jobs that can be simultaneously locked within the Agenda system, ensuring efficient task execution without resource overstretching. Its essential for maintaining concurrency control in the broader repository architecture.                                             |
+| [close.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/close.ts)                                   | Agenda/close.ts secures the main functionality of closing database connections within the Agenda-TS project. It incorporates a provision for forcefully closing connections and handles exceptions that might arise during this process. The feature is specifically adapted for MongoDB databases that havent been preconfigured. |
+| [save-job.ts](https://github.com/meabed/agenda-ts/blob/master/src/pulse/save-job.ts)                             | <code>► INSERT-TEXT-HERE</code>                                                                                                                                                                                                                                                                                               |
+
+</details>
+
+<details closed><summary>src.utils</summary>
+
+| File                                                                                            | Summary                                                                                                                                                                                                                                                                      |
+| ---                                                                                             | ---                                                                                                                                                                                                                                                                          |
+| [parse-priority.ts](https://github.com/meabed/agenda-ts/blob/master/src/utils/parse-priority.ts) | ParsePriority, situated in the src/utils folder, transforms the priority of jobs from a textual format to a numerical representation. This allows the Agenda system within the repository to handle job scheduling based on priority levels, improving task queue management. |
+| [process-jobs.ts](https://github.com/meabed/agenda-ts/blob/master/src/utils/process-jobs.ts)     | <code>► INSERT-TEXT-HERE</code>                                                                                                                                                                                                                                              |
+| [create-job.ts](https://github.com/meabed/agenda-ts/blob/master/src/utils/create-job.ts)         | CreateJob function, residing in src/utils/create-job.ts, orchestrates the generation of Job objects within the Agenda application. It complements the parent repositorys architecture by leveraging the Agenda instance and supplied job data to construct and return a Job.   |
+| [index.ts](https://github.com/meabed/agenda-ts/blob/master/src/utils/index.ts)                   | Facilitates job creation, priority parsing, and job processing, serving as a utility hub within the agenda repository. It critically interlinks these utility functions to streamline task organization and execution, enhancing the repository's overall functionality.      |
+
+</details>
+
+<details closed><summary>src.job</summary>
+
+| File                                                                                                      | Summary                                                                                                                                                                                                                                                                                                                    |
+| ---                                                                                                       | ---                                                                                                                                                                                                                                                                                                                        |
+| [enable.ts](https://github.com/meabed/agenda-ts/blob/master/src/job/enable.ts)                             | Enable.ts activates a specific job type within the agenda project. By modifying an attribute in the Job object, it reverses the disabled status, allowing the job to run. This function integrates seamlessly with the wider repository structure, particularly the job module.                                             |
+| [is-running.ts](https://github.com/meabed/agenda-ts/blob/master/src/job/is-running.ts)                     | Defines a function that determines if specific jobs within the application are currently running. It uses time comparisons, analyzing lastRunAt and lastFinishedAt properties, to deliver its verdict, thereby enhancing task management in the parent repository agenda.                                                   |
+| [schedule.ts](https://github.com/meabed/agenda-ts/blob/master/src/job/schedule.ts)                         | Schedule.ts in the job directory empowers a certain task to run at a predefined time. Using this feature, users can set either a specific date or a string pattern to determine the next execution instance of a job, thereby enhancing the scheduling capabilities in the overall Agenda project.                          |
+| [touch.ts](https://github.com/meabed/agenda-ts/blob/master/src/job/touch.ts)                               | Touch.ts within the job directory of the Agenda repository manages job concurrency. It updates a jobs lockedAt time, preventing multiple instances from running simultaneously. Can have an optional progress parameter (0-100). The function returns a Promise for the saved job.                                                                                           |
+| [compute-next-run-at.ts](https://github.com/meabed/agenda-ts/blob/master/src/job/compute-next-run-at.ts)   | <code>► INSERT-TEXT-HERE</code>                                                                                                                                                                                                                                                                                            |
+| [to-json.ts](https://github.com/meabed/agenda-ts/blob/master/src/job/to-json.ts)                           | Transforms job details into a storable JSON object within the repositorys job management module. Converts key date attributes into the Date data type, facilitating data interchange with MongoDB.                                                                                                                         |
+| [repeat-at.ts](https://github.com/meabed/agenda-ts/blob/master/src/job/repeat-at.ts)                       | RepeatAt is a functionality of the Job module that arranges a task repetition at a specific interval. It accepts human-readable or numeric time variables, thereby empowering developers to schedule tasks dynamically within the agendta project.                                                                           |
+| [set-shouldsaveresult.ts](https://github.com/meabed/agenda-ts/blob/master/src/job/set-shouldsaveresult.ts) | SetShouldSaveResult in the Job directory enables the persistence of a jobs return value by managing the relevant flag. It forms part of the repositorys core functionality, influencing how job results are stored and retrieved within the agendta system.                                                                  |
+| [disable.ts](https://github.com/meabed/agenda-ts/blob/master/src/job/disable.ts)                           | Acting as a crucial component in the agendta repository, src/job/disable.ts provides the functionality to prevent specific jobs from running within the software system by modifying the job attributes. The solution enhances system control and ensures efficient resource allocation.                                     |
+| [fail.ts](https://github.com/meabed/agenda-ts/blob/master/src/job/fail.ts)                                 | Fail within the job directory of the Agenda repository ensures efficient error handling by marking a job as failed. It records the failure reason, increments the failure count, timestamps it, and debugs the number of times a job has failed, thereby improving transparency and traceability.                           |
+| [priority.ts](https://github.com/meabed/agenda-ts/blob/master/src/job/priority.ts)                         | In the context of the Agenda repository, priority.ts facilitates adjustment of task prioritization within the job queue. It leverages a method to parse and set job priority based on provided parameters, thereby influencing the order of job execution.                                                                  |
+| [remove.ts](https://github.com/meabed/agenda-ts/blob/master/src/job/remove.ts)                             | In the context of the Agenda repository, remove.ts distresses a crucial function within the Job module. It facilitates the removal of a job from MongoDB by cancelling the job identified by its unique _id attribute.                                                                                                      |
+| [unique.ts](https://github.com/meabed/agenda-ts/blob/master/src/job/unique.ts)                             | Within the broader Agenda repository, the unique.ts file fundamentally manages the uniqueness of a job. It contains a function that allows the creation of unique jobs by adding specific unique attributes and options to the job data.                                                                                    |
+| [index.ts](https://github.com/meabed/agenda-ts/blob/master/src/job/index.ts)                               | <code>► INSERT-TEXT-HERE</code>                                                                                                                                                                                                                                                                                            |
+| [repeat-every.ts](https://github.com/meabed/agenda-ts/blob/master/src/job/repeat-every.ts)                 | RepeatEvery, located within the job directory, enables task scheduling at regular intervals. It includes versatile options such as setting start dates, end dates, skipping specific days, and handling immediate execution scenarios, contributing significantly to the parent repository's task management capabilities. |
+| [run.ts](https://github.com/meabed/agenda-ts/blob/master/src/job/run.ts)                                   | <code>► INSERT-TEXT-HERE</code>                                                                                                                                                                                                                                                                                            |
+| [save.ts](https://github.com/meabed/agenda-ts/blob/master/src/job/save.ts)                                 | Save.ts facilitates the persistence of job instances into MongoDB. Working within the job subdirectory of the agenda project, it enables asynchronous saving operations, either successfully storing a job or returning errors.                                                                                             |
+
+</details>
+
+---
+<br/>
+<br/>
+
+##  Getting Started
+| Take a look at our [Quick Start](https://github.com/meabed/agenda-ts#example) guide.
+
+####  Installation
+
+ ```console
+ $ npm install --save agenda-ts
+```
+
+
+
+####  Example
+
+```typescript
+import Agenda from 'agenda-ts';
+
+const mongoConnectionString = 'mongodb://localhost:27017/agenda';
+
+const agenda = new Agenda({
+  db: { address: mongoConnectionString },
+  defaultConcurrency: 4,
+  maxConcurrency: 4,
+  processEvery: '10 seconds',
+  resumeOnRestart: true,
+});
+
+// Or override the default collection name:
+// const agenda = new Agenda({db: {address: mongoConnectionString, collection: 'jobCollectionName'}});
+
+// or pass additional connection options:
+// const agenda = new Agenda({db: {address: mongoConnectionString, collection: 'jobCollectionName', options: {ssl: true}}});
+
+// or pass in an existing mongodb-native MongoClient instance
+// const agenda = new Agenda({mongo: myMongoClient});
+
+/**
+ * Example of defining a job
+ */
+agenda.define('delete old users', async (job) => {
+  console.log('Deleting old users...');
+  return;
+});
+
+/**
+ * Example of repeating a job
+ */
+(async function () {
+  // IIFE to give access to async/await
+  await agenda.start();
+
+  await agenda.every('3 minutes', 'delete old users');
+
+  // Alternatively, you could also do:
+  await agenda.every('*/3 * * * *', 'delete old users');
+})();
+
+/**
+ * Example of defining a job with options
+ */
+pulse.define(
+  'send email report',
+  async (job) => {
+    const { to } = job.attrs.data;
+
+    console.log(`Sending email report to ${to}`);
+  },
+  { lockLifetime: 5 * 1000, priority: 'high', concurrency: 10 }
+);
+
+/**
+ * Example of scheduling a job
+ */
+(async function () {
+  await agenda.start();
+  await agenda.schedule('in 20 minutes', 'send email report', { to: 'admin@example.com' });;
+})();
+
+/**
+ * Example of repeating a job
+ */
+(async function () {
+  const weeklyReport = agenda.create('send email report', { to: 'example@example.com' });
+  await agenda.start();
+  await weeklyReport.repeatEvery('1 week').save();
+})();
+
+/**
+ * Check job start and completion/failure
+ */
+agenda.on('start', (job) => {
+  console.log(time(), `Job <${job.attrs.name}> starting`);
+});
+agenda.on('success', (job) => {
+  console.log(time(), `Job <${job.attrs.name}> succeeded`);
+});
+agenda.on('fail', (error, job) => {
+  console.log(time(), `Job <${job.attrs.name}> failed:`, error);
+});
+
+function time() {
+  return new Date().toTimeString().split(' ')[0];
+}
+
+
+```
+
+
+---
+<br/>
+<br/>
+
+##  Project Roadmap
+
+- [X] **Add Support for Latest Mongoose Version(8.x.x)**: Upgrade Agenda-TS to be fully compatible with the latest version of Mongoose. This will enable Agenda-TS to leverage the newest features and improvements in Mongoose, ensuring better performance, stability, and security for applications that rely on MongoDB through Mongoose.
+- [X] **Refactoring to Modern TypeScript Syntax**: Undertake a comprehensive refactor of the codebase to utilize modern TypeScript features and syntax. This refactoring will improve code readability, maintainability, and make it easier for new contributors to understand and contribute to the project.
+- [X] **Resolving Issues in Existing Agenda Projects**: Actively address and resolve outstanding issues within the original Agenda project. This initiative not only aids the community by improving the legacy codebase but also informs the development of Pulse by identifying and addressing past challenges.
+- [ ] **Rewrite Test Code**: Revamp our testing suite to increase coverage and ensure tests are up-to-date with modern testing practices. This rewrite aims to enhance test reliability and efficiency, facilitating smoother development and deployment cycles.
+- [X] **Rewrite Documentation**: Completely revise and update the documentation to reflect all new changes and features, ensure clarity of information, and improve navigation and readability for developers. This effort will include new getting started guides, API documentation, and use case examples to facilitate easier adoption and implementation by users.
+---
+<br/>
+<br/>
+
+##  Contributing
+
+Contributions are welcome! Here are several ways you can contribute:
+
+- **[Report Issues](https://github.com/meabed/agenda-ts/issues)**: Submit bugs found or log feature requests for the `agenda-ts` project.
+- **[Submit Pull Requests](https://github.com/meabed/agenda-ts/pulls)**: Review open PRs, and submit your own PRs.
+- **[Join the Discussions](https://github.com/meabed/agenda-ts/discussions)**: Share your insights, provide feedback, or ask questions.
+
+<details closed>
+<summary>Contributing Guidelines</summary>
+
+1. **Fork the Repository**: Start by forking the project repository to your github account.
+2. **Clone Locally**: Clone the forked repository to your local machine using a git client.
+   ```sh
+      git clone https://github.com/meabed/agenda-ts
+   ```
+3. **Create a New Branch**: Always work on a new branch, giving it a descriptive name.
+   ```sh
+   git checkout -b new-feature-x
+   ```
+4. **Make Your Changes**: Develop and test your changes locally.
+5. **Commit Your Changes**: Commit with a clear message describing your updates.
+   ```sh
+   git commit -m 'Implemented new feature x.'
+   ```
+6. **Push to github**: Push the changes to your forked repository.
+   ```sh
+   git push origin new-feature-x
+   ```
+7. **Submit a Pull Request**: Create a PR against the original project repository. Clearly describe the changes and their motivations.
+8. **Review**: Once your PR is reviewed and approved, it will be merged into the main branch. Congratulations on your contribution!
+</details>
+
+<details closed>
+<summary>Contributor Graph</summary>
+<br>
+<p align="center">
+      <a href="https://github.com/meabed/agenda-ts/graphs/contributors">
+      <img src="https://contrib.rocks/image?repo=meabed/agenda-ts">
+   </a>
+</p>
+</details>
+
+---
+<br/>
+<br/>
+
+##  License
+
+This project is protected under the [MIT](https://github.com/meabed/agenda-ts?tab=MIT-1-ov-file#readme) License. For more details, refer to the [LICENSE](https://github.com/meabed/agenda-ts?tab=MIT-1-ov-file#readme) file.
+
+---
+<br/>
+<br/>
+
+
+##  Acknowledgments
+- Agenda-TS is maintained by [Mohamed Meabed](https://github.com/meabed) and was forked from the [Agenda](https://github.com/agenda/agenda) project.

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './job';
+export * from './pulse';
+export { JobOptions } from './job/repeat-every';
+export { DefineOptions, JobPriority, Processor } from './pulse/define';
+export { Pulse };
+import { Pulse } from './pulse';
+export default Pulse;

package/dist/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Pulse = exports.JobPriority = void 0;
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./job"), exports);
+tslib_1.__exportStar(require("./pulse"), exports);
+var define_1 = require("./pulse/define");
+Object.defineProperty(exports, "JobPriority", { enumerable: true, get: function () { return define_1.JobPriority; } });
+const pulse_1 = require("./pulse");
+Object.defineProperty(exports, "Pulse", { enumerable: true, get: function () { return pulse_1.Pulse; } });
+exports.default = pulse_1.Pulse;
+//# 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,gDAAsB;AACtB,kDAAwB;AAGxB,yCAAuE;AAA/C,qGAAA,WAAW,OAAA;AAGnC,mCAAgC;AAFvB,sFAEA,aAAK,OAFA;AAId,kBAAe,aAAK,CAAC"}

package/dist/job/compute-next-run-at.d.ts

@@ -0,0 +1,3 @@
+import { Job } from '../job';
+export type ComputeNextRunAtMethod = () => Job;
+export declare const computeNextRunAt: ComputeNextRunAtMethod;

package/dist/job/compute-next-run-at.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeNextRunAt = void 0;
+const tslib_1 = require("tslib");
+const debug_1 = tslib_1.__importDefault(require("debug"));
+const human_interval_1 = tslib_1.__importDefault(require("human-interval"));
+const moment_timezone_1 = tslib_1.__importDefault(require("moment-timezone"));
+const cron_parser_1 = require("cron-parser");
+const date_js_1 = tslib_1.__importDefault(require("date.js"));
+const debug = (0, debug_1.default)('pulse:job');
+const computeNextRunAt = function () {
+    const interval = this.attrs.repeatInterval;
+    const timezone = this.attrs.repeatTimezone;
+    const { repeatAt } = this.attrs;
+    const previousNextRunAt = this.attrs.nextRunAt || new Date();
+    this.attrs.nextRunAt = undefined;
+    const dateForTimezone = (date) => {
+        const mdate = (0, moment_timezone_1.default)(date);
+        if (timezone) {
+            mdate.tz(timezone);
+        }
+        return mdate;
+    };
+    const computeFromInterval = () => {
+        debug('[%s:%s] computing next run via interval [%s]', this.attrs.name, this.attrs._id, interval);
+        const dateNow = new Date();
+        let lastRun = this.attrs.lastRunAt || dateNow;
+        let { startDate, endDate, skipDays } = this.attrs;
+        lastRun = dateForTimezone(lastRun).toDate();
+        const cronOptions = { currentDate: lastRun };
+        if (timezone) {
+            cronOptions.tz = timezone;
+        }
+        try {
+            let cronTime = cron_parser_1.CronExpressionParser.parse(interval, cronOptions);
+            let nextDate = cronTime.next().toDate();
+            if (nextDate.getTime() === lastRun.getTime() || nextDate.getTime() <= previousNextRunAt.getTime()) {
+                cronOptions.currentDate = new Date(lastRun.getTime() + 1000);
+                cronTime = cron_parser_1.CronExpressionParser.parse(interval, cronOptions);
+                nextDate = cronTime.next().toDate();
+            }
+            if (startDate) {
+                startDate = moment_timezone_1.default.tz((0, moment_timezone_1.default)(startDate).format('YYYY-MM-DD HH:mm'), timezone).toDate();
+                if (startDate > nextDate) {
+                    cronOptions.currentDate = startDate;
+                    cronTime = cron_parser_1.CronExpressionParser.parse(interval, cronOptions);
+                    nextDate = cronTime.next().toDate();
+                }
+            }
+            if (dateNow > lastRun && skipDays !== null) {
+                try {
+                    nextDate = new Date(nextDate.getTime() + ((0, human_interval_1.default)(skipDays) ?? 0));
+                }
+                catch { }
+            }
+            if (endDate) {
+                const endDateDate = moment_timezone_1.default.tz((0, moment_timezone_1.default)(endDate).format('YYYY-MM-DD HH:mm'), timezone).toDate();
+                if (nextDate > endDateDate) {
+                    nextDate = null;
+                }
+            }
+            this.attrs.nextRunAt = nextDate;
+            debug('[%s:%s] nextRunAt set to [%s]', this.attrs.name, this.attrs._id, this.attrs.nextRunAt?.toISOString());
+        }
+        catch {
+            debug('[%s:%s] failed nextRunAt based on interval [%s]', this.attrs.name, this.attrs._id, interval);
+            try {
+                if (!this.attrs.lastRunAt && (0, human_interval_1.default)(interval)) {
+                    this.attrs.nextRunAt = lastRun;
+                    debug('[%s:%s] nextRunAt set to [%s]', this.attrs.name, this.attrs._id, this.attrs.nextRunAt.toISOString());
+                }
+                else {
+                    this.attrs.nextRunAt = new Date(lastRun.getTime() + ((0, human_interval_1.default)(interval) ?? 0));
+                    debug('[%s:%s] nextRunAt set to [%s]', this.attrs.name, this.attrs._id, this.attrs.nextRunAt.toISOString());
+                }
+            }
+            catch { }
+        }
+        finally {
+            if (!this.attrs.nextRunAt?.getTime()) {
+                this.attrs.nextRunAt = undefined;
+                debug('[%s:%s] failed to calculate nextRunAt due to invalid repeat interval', this.attrs.name, this.attrs._id);
+                this.fail('failed to calculate nextRunAt due to invalid repeat interval');
+            }
+        }
+    };
+    const computeFromRepeatAt = () => {
+        const lastRun = this.attrs.lastRunAt || new Date();
+        const nextDate = (0, date_js_1.default)(repeatAt);
+        const offset = Date.now();
+        if (offset === (0, date_js_1.default)(repeatAt, offset).getTime()) {
+            this.attrs.nextRunAt = undefined;
+            debug('[%s:%s] failed to calculate repeatAt due to invalid format', this.attrs.name, this.attrs._id);
+            this.fail('failed to calculate repeatAt time due to invalid format');
+        }
+        else if (nextDate.getTime() === lastRun.getTime()) {
+            this.attrs.nextRunAt = (0, date_js_1.default)('tomorrow at ', repeatAt);
+            debug('[%s:%s] nextRunAt set to [%s]', this.attrs.name, this.attrs._id, this.attrs.nextRunAt?.toISOString());
+        }
+        else {
+            this.attrs.nextRunAt = (0, date_js_1.default)(repeatAt);
+            debug('[%s:%s] nextRunAt set to [%s]', this.attrs.name, this.attrs._id, this.attrs.nextRunAt?.toISOString());
+        }
+    };
+    if (interval) {
+        computeFromInterval();
+    }
+    else if (repeatAt) {
+        computeFromRepeatAt();
+    }
+    return this;
+};
+exports.computeNextRunAt = computeNextRunAt;
+//# sourceMappingURL=compute-next-run-at.js.map

package/dist/job/compute-next-run-at.js.map

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

package/dist/job/disable.d.ts

@@ -0,0 +1,3 @@
+import { Job } from '.';
+export type DisableMethod = () => Job;
+export declare const disable: DisableMethod;

package/dist/job/disable.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.disable = void 0;
+const disable = function () {
+    this.attrs.disabled = true;
+    return this;
+};
+exports.disable = disable;
+//# sourceMappingURL=disable.js.map

package/dist/job/disable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disable.js","sourceRoot":"","sources":["../../src/job/disable.ts"],"names":[],"mappings":";;;AAQO,MAAM,OAAO,GAAkB;IACpC,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC3B,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAHW,QAAA,OAAO,WAGlB"}

package/dist/job/enable.d.ts

@@ -0,0 +1,3 @@
+import { Job } from '.';
+export type EnableMethod = () => Job;
+export declare const enable: EnableMethod;

package/dist/job/enable.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enable = void 0;
+const enable = function () {
+    this.attrs.disabled = false;
+    return this;
+};
+exports.enable = enable;
+//# sourceMappingURL=enable.js.map

package/dist/job/enable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enable.js","sourceRoot":"","sources":["../../src/job/enable.ts"],"names":[],"mappings":";;;AAQO,MAAM,MAAM,GAAiB;IAClC,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC;IAC5B,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAHW,QAAA,MAAM,UAGjB"}

package/dist/job/fail.d.ts

@@ -0,0 +1,3 @@
+import { Job } from '.';
+export type FailMethod = (reason: string | Error) => Job;
+export declare const fail: FailMethod;

package/dist/job/fail.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fail = void 0;
+const tslib_1 = require("tslib");
+const debug_1 = tslib_1.__importDefault(require("debug"));
+const debug = (0, debug_1.default)('pulse:job');
+const fail = function (reason) {
+    const failReason = reason instanceof Error ? reason.message : reason;
+    const attrs = this.attrs;
+    attrs.failReason = failReason;
+    attrs.failCount = (attrs.failCount || 0) + 1;
+    attrs.runCount = attrs.runCount || 1;
+    const now = new Date();
+    attrs.failedAt = attrs.lastFinishedAt = now;
+    debug('[%s:%s] fail() called [%d] times so far', attrs.name, attrs._id, attrs.failCount);
+    const attempts = attrs.attempts || 0;
+    const step = attrs.runCount <= attempts * (attempts + 1) ? Math.ceil(attrs.runCount / (attempts + 1)) : attempts;
+    const retryCount = attrs.failCount - step;
+    const backoff = attrs.backoff;
+    if (attempts && backoff && retryCount < step * attempts) {
+        const delayMultiplier = backoff.type === 'fixed' ? 1 : Math.pow(2, retryCount);
+        attrs.nextRunAt = new Date(now.getTime() + delayMultiplier * backoff.delay);
+        debug('[%s:%s] setting retry at time [%s], retryCount: [%d]', attrs.name, attrs._id, attrs.nextRunAt, retryCount);
+    }
+    return this;
+};
+exports.fail = fail;
+//# sourceMappingURL=fail.js.map