daycry / jobs / 25509260188

75%

push

github

feat(v2.0): opt-in API with immutable JobDefinition + lease-based QueueBackend

Introduces the new Daycry\Jobs\V2\ namespace alongside the existing v1 API
so adopters can migrate incrementally. Nothing in v1 changes: legacy Job
builders, QueueInterface and WorkerInterface keep working unchanged.

- JobDefinition: readonly value object replacing the mutable Job builder;
  withXxx() copies for safe sharing across enqueue sites; fromLegacyJob()
  bridges from the v1 mutable builder.
- JobLease + QueueBackend: unified enqueue/fetch/ack/nack/abandon contract
  that replaces the QueueInterface+WorkerInterface split, removing the
  per-instance hidden state in legacy backends.
- LegacyWorkerAdapter wraps any v1 backend so worker code can already use
  the new lease API without touching the underlying implementation.
- TypedJobHandler base class rehydrates payloads to a declared DTO via
  reflection so handlers receive typed objects instead of mixed.
- docs/V2_MIGRATION.md documents the four-step adoption path and the
  proposed deprecation timeline (v1.2 -> v1.3 native -> v2.0 -> v3.0).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

118 of 144 new or added lines in 4 files covered. (81.94%)

2139 of 2850 relevant lines covered (75.05%)

12.03 hits per line