palcarazm / batchjs / 28236748646

100%

version/v1: 100%

push

github

feat: add parallel step execution with fail-fast cancellation (#105)

* feat: add parallel step execution with fail-fast cancellation

Extends Job._steps() to support arrays of Step for parallel execution:
- _steps() now returns (Step | Step[])[] instead of Step[]
- Parallel groups run concurrently via Promise.all
- First failure cancels all other steps in the group (fail-fast)
- Added stepCancelled event for monitoring cancellations

Step improvements:
- Added isRunning getter to check execution state
- Added cancel() method for manual/interrupt cancellation
- Added destroy() method for resource cleanup
- Added CANCELLED status to RunnableStatus
- StepCancelledError for distinguishing cancellation from failure

Events & metrics:
- stepCancelled event emitted when steps are cancelled
- JobListener records metrics for cancelled steps
- JobLogger logs cancellation events

Tests:
- Step cancellation tests (running, non-running, multiple cancels)
- Step destroy tests (completed, failed, cancelled)
- Job parallel tests (success, failure, mixed sequential/parallel)
- Sequential failure before parallel group tests

Documentation:
- Added parallel execution behavior section to jobs.md
- Added cancellation section to steps.md
- Added status table with CANCELLED state

Implements #92

* fix: change delay property to readonly in MockPassingStep class

117 of 119 branches covered (98.32%)

Branch coverage included in aggregate %.

56 of 56 new or added lines in 6 files covered. (100.0%)

532 of 533 relevant lines covered (99.81%)

62.75 hits per line