Contributions welcome! https://github.com/agenda/agenda/pulls
5.0.0 / 2022-11-07
- MongoDB 3.4 and 3.6 are not supported anymore. Only MongoDB v4.0 and above are supported.
Otherwise, all the changes are minor: https://github.com/agenda/agenda/releases/tag/v5.0.0
4.4.0 / 2022-10-19
-
Feat: Add
drain()
method for graceful process shutdowns (#1488) thanks @nmehmedrnd4.3.0 / 2022-05-10
-
Feat:
disableAutoIndex
-
Feat:
shouldSaveResult
-
fix: deprecation warning for collection.findOneAndUpdate (#1338) thanks @frobinsonj
-
Feat: Add top level disable and enable (#1109) thanks @pdfowler
-
fix(history): match cron-parser pattern (#1335) thanks @dockleryxk
-
fix: "RangeError: Maximum call stack size exceeded" (#1365) thanks @koresar
-
fix: JobAttributes.lockedAt to allow null values (#1340) thanks @tjramage
-
Updated dependencies:
[email protected]
,[email protected]
, as well as various dev dependencies. -
Added node 16 in tests (#1314) thanks @simison
-
fix: export cjs and es (#1298) thanks @koresar
-
fix: broken main cjs export works again. See more here.
-
Docs, JSDocs and TS typo fixes. Thanks @niftylettuce @thebestnom @simllll and @Igor-lkm
-
fix: typescript export needs es6 (#1268) thanks @simllll
-
Compatibility with DefinitelyTyped/agenda (#1258) thanks @boredland
-
Added type information (#1202 #1243) thanks @boredland, @leonardlin
-
Fix "Cannot find module ./lib/agenda" bug due us not targeting correct ES5 files for distribution after the TypeScript rewrite. (#1193)
-
Update dependencies
-
Add
agenda.close()
(#450) thanks @simison -
Add ability to schedule jobs with startDate, endDate, and skipping (#361) thanks @suryanaik
-
Fix issue with concurrent locking beyond locklimit (#1086) thanks @leonardlin
-
Fix issue with too many locks being set asynchronously (#1119) thanks @GimpMaster
-
Upgrade
mongodb
dependency ~3.5.0 -> ~3.6.2 (security) (#1122) thanks @Elisa23 -
Upgrade to Human Interval v2, a refactor using numbered package:
- Supports all the formats as previously, and more!
- Supports numbers written as English words (one, two hundred)
- Supports time expressions in singular and plural (minute and minutes)
- Supports negative numbers (-2)
- Supports hyphenated words (twenty-five)
-
Upgrade various dependencies
-
Switch from ncb000gt/node-cron to harrisiirak/cron-parser for cron-pattern parsing. See issue (#475)
Previously month was 0-based (0=January). Going forward standard Unix pattern is used, which is 1-based (1=January). Please update existing cron-patterns that specify a month (4th position of a pattern). The month is now 1 - 12 1 = January 2 = February 3... | Example | Execute on 1st of January | |---------|---------------------------| | Old | 0 0 1 **0** * | | New | 0 0 1 **1** * | ([#1150](https://github.com/agenda/agenda/pull/1150)) old Cron patterns ``` * * * * * * | | | | | | | | | | | +-- Year (range: 1900-3000) | | | | +---- Day of the Week (range: 1-7, 1 standing for Monday) | | | +------ Month of the Year (range: 0-11) NOTE: Difference here | | +-------- Day of the Month (range: 1-31) | +---------- Hour (range: 0-23) +------------ Minute (range: 0-59) ``` new cron patterns ``` * * * * * * | | | | | | | | | | | +-- Day of the Week (range: 0-7, 0 or 7 is Sunday) | | | | +---- Month of the Year (range: 1-12) NOTE: Difference here | | | +------ Day of the Month (range: 1-31) | | +-------- Hour (range: 0-23) | +---------- Minute (range: 0-59) +------------ Second (range: 0-59, optional) ```
Stay safe!
- Fix for skipImmediate resetting nextRunAt to current date (#860) (Thanks @AshlinDuncan!)
- Fix deprecated reconnect options (#948) (Thanks @ekegodigital!)
- Add ability to set a skip when querying jobs. (#898) (Thanks @cjolif!)
Internal:
- Fixed deprecated MongoDB functions in tests (#928) (Thanks @MichielDeMey!)
- Updated devDependencies
Thank you @koresar, @sampathBlam, and @MichielDeMey helping to review PRs for this release! 👏
- Support MongoDB's Unified Topology Design (#921) (Thanks @viktorzavadil!)
- Fix: check that the new nextRunAt is different that the previous nextRunAt (#863) (Thanks @RaphaelRheault!)
- Update dependencies. Most notably MongoDB driver 3.4 → 3.5 (#899, #900, #903, #906, #908, #910, #912, #913, #920, #922)
- Documentation updates, thanks @MichielDeMey and @Sunghee2. (#923 & #907)
-
Stop testing for Node.js 8. This might still work but we're no longer actively testing for it. (#925)
-
Improved performance in situations when there are many "expired" jobs in the database (#869) (Thanks @mfred488!)
-
Fix periodic node.js process unhandledRejection (#887) (Thanks @koresar and @Scorpil)
-
Update dependencies
- Fix
skipImmediate
option in.every
(#861) (Thanks @erics2783!) - Add try/catch block to agenda#now method (#876) (Thanks @sampathBlam!)
- Refactor job queuing mechanism. Agenda n ow guarantees priority when executing jobs scheduled the same datetime. Fixes also some tests. (#852) (Thank you @dmbarreiro!)
- Update dependencies (Kudos @simison!)
Most notably
mongodb
~3.2.7 -> ~3.3.0 (changelog) — highlights:- Mongo DB Server Version 4.2 feature support
- Merged
mongodb-core
intonode-mongodb-native
- Beta support for MongoDB Client-Side Encryption
- SRV Polling for Sharded Clusters
- Updates to documentation (Thank you @lautarobock, @sampathBlam, @indatawetrust)
- Support async functions in job processing (#653) (thanks @princjef!)
- Allow sorting and limiting jobs when searching (#665) (thank you @edwin-jones)
- Update MongoClient connection settings with
useNewUrlParser: true
to remove the deprecation warning. (#806) (thanks @dpawson905!) - Allow valid date strings when scheduling (#808) (Thanks @wingsbob!)
- Update dependencies (#820)
- Update documentation (kudos @dandv, @pedruino and many others!)
- Fix linting errors (#847) (thanks @dmbarreiro!)
- Fixes a MongoDB connection string issue with Atlas (#674
- Fix a bug where
job.touch()
wasn't promise based, as it should've been (#667
- Rewrite tests: replace
mocha
andblanket
withava
andnyc
(#506) - Optimization: don't try and unlock jobs when
_lockedJobs
is empty (#509) - Code cleanup (#503)
- Ensure tests pass for Node.js version 10 #608)
- Add
skipImmediate
torepeatEvery()
options to skip immediate run of repeated jobs when Agenda starts. See documentation (#594) - Fixes some flaky tests
- Adds docs generator (
npm run docs
to generate/docs
)
- Fix
-
Rewrite Agenda API support promises! (#557)
No more callbacks! Instead of:
function graceful() { agenda.stop(function () { process.exit(0); }); }
You need to:
async function graceful() { await agenda.stop(); process.exit(0); }
You don't anymore have to listen for
start
event. Instead you can do:await agenda.start(); agenda.every("10 minutes", "example");
However, this will still work:
agenda.on("ready", function () { agenda.every("10 minutes", "example"); agenda.start(); });
See the documentation for more!
-
Drop support for MongoDB 2.4 (#497)
-
Update Native MongoDB driver to 3.1 from 2.2 (#616)
-
Jobs emit errors instead of throwing them
- Update dependencies (2854c7e)
- Update dependencies (2854c7e)
- Update dependencies
cron
anddebug
(#505)
-
Fix jobs not running in order of them being queued (#464)
-
Changes in Cron string parsing, changed parsing library from ncb000gt/node-cron to harrisiirak/cron-parser (#475)
Previously Agenda would treat months as 0-11 where as normally, cron months are parsed as 1-12.
* * * * * *
| | | | | |
| | | | | +-- Year (range: 1900-3000)
| | | | +---- Day of the Week (range: 1-7, 1 standing for Monday)
| | | +------ Month of the Year (range: 0-11) NOTE: Difference here
| | +-------- Day of the Month (range: 1-31)
| +---------- Hour (range: 0-23)
+------------ Minute (range: 0-59)
Starting in version 1.0.0
, cron will be parsed in the standard UNIX style:
* * * * * *
| | | | | |
| | | | | +-- Year (range: 1900-3000)
| | | | +---- Day of the Week (range: 1-7, 1 standing for Monday)
| | | +------ Month of the Year (range: 1-12) NOTE: Difference here
| | +-------- Day of the Month (range: 1-31)
| +---------- Hour (range: 0-23)
+------------ Minute (range: 0-59)
- Adds debugging, see instructions from README.md.
- Unpublished and re-published as v0.10.2
- Replace the deprecated
findAndModify
method from native MongoDB driver tofindOneAndUpdate
(#448) - Going forward, we won't ensure Node.js v0.10 and v0.11 compatibility anymore (#449)
- Code cleanup (#491, #489, #488, #487)
Republish release for NPM. Includes fixes from 0.9.0 release:
- add support for
mongoose.connection
foragenda.mongo()
, fixes #156 - Fix for race condition in the afterEach clean up code (#355)
- Fixes + protects against concurrency not being honored (#379)
- add support for
mongoose.connection
foragenda.mongo()
, fixes #156 - Fix for race condition in the afterEach clean up code (#355)
- Fixes + protects against concurrency not being honored (#379)
- Bump mongodb dep version to support ssl conns (#368)
- Increase Mongo compatability to 2.4
- Add Node v6 to CI
-
- Update dev dependencies for out of date. 2. Small fix to job.js for invalid repeatAt
- Update .npmignore
- Fix doc: cb not marked as optional (closes #279)
- Including nextRunAt check in query for on the fly lock.
- Picking up any job with an expired lock (not just recurring or queued).
- Fixed failing test
- throw on processJobResult error
- Requeuing concurrency blocked jobs wrt priority.
- Processing the next job that is not blocked by concurrency.
- Fix test which fails only sometimes
- Add agendash as alternative ui
- Merge pull request #288 from diesal11/master
- Implementing lock limit
- Use callback to handle errors if we can.
- fix: ReferenceError: MongoError is not defined
- fix: computeNextRunAt timezone bug
- feat: add timezone option for repeatAt.
- fix: job locking logic
- fix: bug with jobs expiring and being enqueued anyway
- fix: bug where jobs wouldn't run concurrently
- fix: agenda throwing an exception when starting a job defined on another instance
- fix: possible bug when using extended Array.prototype
- feat: Add failCount attribute to jobs
- fix: job priority for on the fly job lock and queueing is now respected
- fix: make agenda.cancel no longer require a callback
- fix: stale jobs running after a more up-to-date job has completed
- fix: fail/success event emit after jobs have been saved in the database
- fix: ready event when using config.mongo
- Adds options.insertOnly to job.unique that prevents the job from being updated multiple times on multiple runs
- fix job priority scheduling
- add support for success callbacks on schedule, every and now (@mgregson)
- using self for reference to collection (@3choBoomer)
- emit ready from db_init (@jdiamond)
- Rollback job completion callback to pre-0.7.0
- Emit events when Agenda init is ready or has failed
- Switch from mongoskin to mongodb native. Big thanks to the classdojo team for this. Shoutouts to @liamdon, @jetzhou and @byronmwong for the help!
- Fix for when _findAndLockNextJob returns multiple jobs.
- code cleanup, fix leaking ignoreErrors
- fix double run bug
- Allow specifying mongo config (optionally)
- Fix .every() running when using cron strings.
- Remove debugger
- add job.unique (@nwkeeley)
- Re-add tests for those who use the
npat
option.
- add job.disable() and job.enable()
- Added .npmignore for test/ build scripts.
- Create database indexes when initializing Agenda instance (@andyneville)
- Implemented job.isRunning()
- Fixed issue where jobs would continue being processed after agenda is explicitly stopped
- Fixed complete event being emitted before asynchronous jobs are finished
- add job.repeatAt
- fix job queue being processed even when agenda was stopped
- fix agenda.every method
- fix agenda.every overwriting nextRunAt [closes #70]
- Added agenda.cancel function
- Fix more circumstances where jobs re-create after remove
- fix jobs resaving after remove [closes #66]
- fix jobs skipping in line from database querying
- update saveJob to allow for pre-set Ids [closes #64]
- add job.touch to reset lock lifetime [references #63]
- make job saving use agenda._name
- add agenda.name config method
- fix agenda.mongo not being chainable
- add graceful job unlocking to stop
- Implement, document, and test defaultLockLifetime [@shakefu]
- Bump date.js version [@psema4]
- mongoskin version bump (better support for mongodb 2.6) [@loginx]
- fix $setOnInsert with empty obj cause mongodb 2.6 complain [@inetfuture]
- fix cron-jobs executing multiple times
- fail the job if repeat interval is wrong
- fix bug that resulted in jobs scheduled in memory to always re-run
- Update mongoskin to 1.3
- allow every and schedule to take array of job names
- convert to using setTimeout for precise job scheduling [closes #6]
- fix agenda.every not properly saving jobs
- improve instantiating jobs, fixes bug where certain attrs weren't loaded in
- add job#remove method
- Fixed single jobs not being saved properly [closes #38]
- fix every re-running jobs out of queue at load
- Added failing for jobs with undefined definitions
- Added agenda.purge() to remove old jobs
- added support to directly give mongoskin object, to help minimize connections
- Added start event to jobs. (@clayzermki)
- Added agenda.now method
- Added ability for job.fail to take an error
- Updated version of humanInterval, adding weeks and months support
- Added job locking mechanism, enabling support for multiple works / agenda instances (@bars3s)
- fix job.toJson method: add failReason & failedAt attrs (Broken in 0.4.3 and 0.4.2)
- fix job cb for working with 'q' promises
- fix job.schedule's taking Date object as 'when' argument [@bars3s]
- Refactored Job to ensure that everything is stored as an ISODate in the Database. [Closes #14] [@raisch]
- Added support for synchronous job definitions
- Added Cron Support [Closes #2]
- removed modella dependency
- Fix for setImmediate on Node 0.8
- Added Events to the Event Queue [References #7]
- Fixed a bug where mongo wasn't giving updated document
- Added error for running undefined job. [Closes #4]
- Fixed critical error where new jobs are not correctly saved.
- Small Bug fix for global-namespace pollution
- Updated write concern to avoid annoying notices
- Removed unecessary UUID code
- Initial Release