Changelog

Unreleased

These changes are merged into the source and will ship in the next version.

• Metadata: Point the npm homepage to the documentation site at https://cronbake.chaqchase.com.

• Add optional reference dates and bounded calendar execution searches. Fix duplicate polling executions, honor overlap settings in both scheduler modes, and prevent callbacks from resurrecting stopped schedulers. Validate delay and scheduler options, copy history snapshots defensively, serialize provider writes, apply autoStart to new jobs, and order bulk starts by priority.

• Reject malformed cron fields, out-of-range values, invalid presets, and zero steps before scheduling. Support mixed lists of ranges and steps, normalize whitespace, and return sorted unique field values.

0.4.0

Features

• Custom Logger Support: Add pluggable logger interface allowing integration with any logging library (pino, winston, bunyan, logtape, etc.)
  • New Logger interface exported from package API
  • Pass logger option to Baker.create() to set a global logger for all jobs
  • Override logger per job via logger option in baker.add() or Cron.create()
  • Default behavior unchanged (falls back to console)
  • Thanks to @nemvince for the work in PR #17

Examples

• Added examples/logging.ts demonstrating custom logger usage with colored output, global logger, per-job overrides, and error logging

Documentation

• Updated README with comprehensive custom logger documentation and examples

0.3.2

Fixes

• Persistence: Fix job redefinition warning by allowing user-defined jobs to replace restored jobs without conflicts (#14). Previously, restarting an app with updated job configurations would show a warning “Failed to restore job ‘my-job’: warn: Cron job with name ‘my-job’ already exists”. Now, user-defined configurations take precedence over restored state.
• Runtime: Failed job executions now bubble up properly so metrics/history and lastError reflect the failure, and onError handlers still fire exactly once.
• Runtime: baker.lastExecution() uses the timestamp of the most recent actual run and Cron.time() once again reports the remaining delay rather than the current epoch time, matching the documented API.

Minor Changes

• Persistence: Honor the persist flag per job so only opted-in jobs are saved/restored, and hydrate metrics/history snapshots during restore.
• API: Added baker.ready() to await automatic restoration before interacting with jobs; autoStart now waits for persistence to finish.
• DX: Prevent redundant persistence writes during restore for faster startups and fewer warnings.
• Metadata: Point npm metadata to chaqchase/cronbake.
• Docs: Added examples/ folder plus README guidance so common use cases have copy-paste starting points without bloating published bundles.

0.3.1

Patch Changes

• Fix critical parser bugs in cron expression aliases:
  • @hourly: Corrected from running every minute to running every hour at minute 0
  • @daily: Fixed from running every hour to running once daily at midnight
  • @weekly: Fixed invalid cron expression (had month=0) to run at midnight every Sunday
  • @monthly: Corrected hour from 1 AM to midnight on the 1st of each month
  • @yearly & @annually: Corrected hour from 1 AM to midnight on January 1st
  • parseOnDayStr: Fixed parsing logic to correctly handle @on_<day> format

0.3.0

Minor Changes

• Immediate/delayed first run: Add immediate and delay options so the first callback can run right away or after a configurable delay (e.g., "10s").
• Overrun protection: Add overrunProtection (default: true) to skip starting a new run if the previous execution is still running; tracks skippedExecutions in metrics.
• Pluggable persistence: Refactor persistence to use providers. Add FilePersistenceProvider (JSON on disk) and RedisPersistenceProvider (single-key JSON via injected client). New persistence.strategy and persistence.provider options.

Features

• New Cron options: immediate, delay, overrunProtection.
• New metrics: skippedExecutions.
• New persistence API: PersistenceProvider with save/load and types for persisted state.
• Export providers from package API: FilePersistenceProvider, RedisPersistenceProvider.

Fixes

• Parser: Correct @on_<day> mapping to Sunday=0…Saturday=6, fix @every_<n>_months to run on day 1 (0 0 0 1 */n *), and @every_<n>_dayOfWeek to */n on day-of-week.
• Types: Replace Timer with ReturnType<typeof setTimeout|setInterval> for portability.
• Build: Replace @/lib path aliases in source with relative imports to avoid bundler resolution issues.
• Packaging: Set module to dist/index.js, move @changesets/cli to devDependencies, ensure Changesets access is public.

Tests

• Add tests for immediate/delayed first run and overrun protection.
• Add provider-focused tests and shared test utilities for persistence (file and Redis via a fake client).

0.2.0

Minor Changes

• Enhanced Job Control: Added pause and resume functionality for fine-grained job control
• Job Persistence: Added support for saving and restoring job state across application restarts
• Execution Metrics & History: Comprehensive tracking of job performance including execution counts, success/failure rates, average execution time, and detailed execution history
• Priority System: Jobs can now be assigned priority levels for execution ordering
• Advanced Scheduling: Added two scheduling modes - calculated timeouts (default) for efficiency and traditional polling-based scheduling
• Enhanced Error Handling: Improved error handling with custom error handlers and detailed error tracking
• Async Callback Support: Job callbacks now support both synchronous and asynchronous functions
• Job Metrics API: New methods to access execution history, performance metrics, and reset statistics
• Configurable Options: Enhanced configuration options for polling intervals, history retention, and timeout calculations
• Type Safety Improvements: Enhanced TypeScript definitions for better development experience

Features

• New Job Control Methods: pause(), resume(), getHistory(), getMetrics(), resetMetrics()
• Persistence Options: Configurable file-based state persistence with automatic restoration
• Job Status Tracking: Extended status states including ‘paused’ and ‘error’ states
• Performance Monitoring: Track total executions, success/failure counts, execution duration, and error details
• Priority-based Execution: Assign and manage job priorities for execution ordering
• Enhanced Baker Configuration: New options for scheduler configuration, persistence settings, and global error handling
• Improved Documentation: Comprehensive README updates with new feature examples and usage patterns

0.1.2

Patch Changes

• 833dfa8: Update the docs

0.1.1

Patch Changes

• 5ed68b2: Add license and fix readme

0.1.0

Minor Changes

• 3d2e50a: First minor release

0.0.1

Patch Changes

• 6e02baf: Initial release