Approval v2.0.0

A complete overhaul — every source file reviewed, refactored, and tested to 100% coverage. Built for Laravel 11, 12, and 13.

⚠️ Breaking Changes

Full upgrade guide: UPGRADE.md

• thenDo(callable) removed — Renamed to thenCustom() with no parameter. The callback was silently discarded in v1. Move custom expiration logic to an ApprovalExpired event listener.
• ModelRolledBackEvent renamed to ModelRolledBack — Update imports and event listener type-hints.
• Facade removed — Cjmellor\Approval\Facades\Approval is gone. Use Cjmellor\Approval\Models\Approval directly.
• Config keys flattened — config('approval.approval.approval_pivot') → config('approval.approval_pivot'). Re-publish your config: php artisan vendor:publish --tag="approval-config" --force
• Event $approval property — Now typed as Approval instead of Model. Update any type-hints in event listeners.
• pending() scope — Now excludes approvals with custom states set. Use whereState('pending') for the old behaviour.
• Expiration actions — Now use ExpirationAction enum instead of raw strings. $approval->expiration_action === ExpirationAction::Reject instead of === 'reject'.
• Mass assignment — $guarded = [] replaced with explicit $fillable. Use forceFill() if you were mass-assigning non-standard columns.

✨ New Features

• ExpirationAction enum — Type-safe expiration actions (Reject, Postpone, Custom)
• ApprovalEvent base class — All events share typed Approval $approval and ?Authenticatable $user properties
• ApprovalStatus::values() helper — Derive standard state values from the enum
• actioned_by tracking — Expired approvals record who processed them
• Laravel Boost AI skills — Package ships with AI guidelines and two skills:
  • approval-development — Full API reference for AI-assisted development
  • approval-upgrade-v2 — Automated v1→v2 migration runbook

🔧 Improvements

• 100% test coverage — 74 tests, 208 assertions
• Events fire after DB writes — No more listeners acting on uncommitted state
• processExpired() resilience — Chunked queries, per-approval error handling, pending-only filter
• Duplicate detection scoped to model — Prevents cross-model false positives
• Null guards — Clear errors when related models are deleted
• getState() bug fix — No longer returns null for standard states after v2 migration
• Performance — Removed per-request schema introspection from boot and state updates
• Defensive coding — JSON_THROW_ON_ERROR, class_uses_recursive(), strict in_array(), explicit $fillable
• Migration rollbacks — All newer migrations include idempotent down() methods

📦 Upgrading

composer require cjmellor/approval:"^2.0"
php artisan vendor:publish --tag="approval-migrations"
php artisan approval:upgrade-to-v2
php artisan migrate
php artisan vendor:publish --tag="approval-config" --force

See UPGRADE.md for the full guide with all breaking changes and before/after examples.

Using Laravel Boost? The approval-upgrade-v2 skill can automatically search your codebase and apply all breaking changes.

What's Changed

• [2.x] Added creator field by @Temepest74 in https://github.com/cjmellor/approval/pull/79
• [2.x] feature: Time-Based Approvals by @cjmellor in https://github.com/cjmellor/approval/pull/81
• [2.x] chore: Drop Support for Versions by @cjmellor in https://github.com/cjmellor/approval/pull/82
• [2.x] feature: Configurable Approval States by @cjmellor in https://github.com/cjmellor/approval/pull/83
• [2.x] feature: Revert to default Service Provider logic by @cjmellor in https://github.com/cjmellor/approval/pull/84
• chore: Add Workbench by @cjmellor in https://github.com/cjmellor/approval/pull/85
• build(deps): Bump dependabot/fetch-metadata from 2.3.0 to 2.4.0 by @dependabot[bot] in https://github.com/cjmellor/approval/pull/86
• build(deps): Bump stefanzweifel/git-auto-commit-action from 5 to 6 by @dependabot[bot] in https://github.com/cjmellor/approval/pull/87
• build(deps): Bump stefanzweifel/git-auto-commit-action from 6 to 7 by @dependabot[bot] in https://github.com/cjmellor/approval/pull/89
• build(deps): Bump actions/checkout from 4 to 5 by @dependabot[bot] in https://github.com/cjmellor/approval/pull/88
• build(deps): Bump dependabot/fetch-metadata from 2.4.0 to 2.5.0 by @dependabot[bot] in https://github.com/cjmellor/approval/pull/91
• Laravel 13.x Compatibility by @laravel-shift in https://github.com/cjmellor/approval/pull/92
• build(deps): Bump actions/checkout from 5 to 6 by @dependabot[bot] in https://github.com/cjmellor/approval/pull/90
• ci: add Composer ecosystem to Dependabot by @cjmellor in https://github.com/cjmellor/approval/pull/93
• build(deps-dev): Bump driftingly/rector-laravel from 2.0.4 to 2.2.0 by @dependabot[bot] in https://github.com/cjmellor/approval/pull/96
• build(deps-dev): Bump rector/rector from 2.0.12 to 2.3.9 by @dependabot[bot] in https://github.com/cjmellor/approval/pull/94
• v2.0.0 by @cjmellor in https://github.com/cjmellor/approval/pull/97

Full Changelog: https://github.com/cjmellor/approval/compare/v1.6.6...v2.0.0

What's Changed

• Laravel 12.x Compatibility by @laravel-shift in https://github.com/cjmellor/approval/pull/77

Full Changelog: https://github.com/cjmellor/approval/compare/v1.6.5...v1.6.6

What's Changed

• feature(events): add new ApprovalCreated event by @cjmellor in https://github.com/cjmellor/approval/pull/76

Full Changelog: https://github.com/cjmellor/approval/compare/v1.6.4...v1.6.5

What's Changed

• Fix Type Error by @mojowill in https://github.com/cjmellor/approval/pull/73

Full Changelog: https://github.com/cjmellor/approval/compare/v1.6.3...v1.6.4

What's Changed

• build(deps): Bump dependabot/fetch-metadata from 2.2.0 to 2.3.0 by @dependabot in https://github.com/cjmellor/approval/pull/71
• Move spatie package tools to require instead of require-dev by @mojowill in https://github.com/cjmellor/approval/pull/72

New Contributors

• @mojowill made their first contribution in https://github.com/cjmellor/approval/pull/72

Full Changelog: https://github.com/cjmellor/approval/compare/v1.6.2...v1.6.3

What's Changed

• Fixes foreign key by @Temepest74 in https://github.com/cjmellor/approval/pull/70

Full Changelog: https://github.com/cjmellor/approval/compare/v1.6.1...v1.6.2

What's Changed

• build(deps): Bump dependabot/fetch-metadata from 2.1.0 to 2.2.0 by @dependabot in https://github.com/cjmellor/approval/pull/65
• Add comprehensive test for nested array attributes in approval process by @cjmellor in https://github.com/cjmellor/approval/pull/69

Full Changelog: https://github.com/cjmellor/approval/compare/v1.6.0...v1.6.1

What's Changed

• build(deps): Bump dependabot/fetch-metadata from 1.6.0 to 2.0.0 by @dependabot in https://github.com/cjmellor/approval/pull/61
• build(deps): Bump dependabot/fetch-metadata from 2.0.0 to 2.1.0 by @dependabot in https://github.com/cjmellor/approval/pull/62
• Factory support by @Temepest74 in https://github.com/cjmellor/approval/pull/64

New Contributors

• @Temepest74 made their first contribution in https://github.com/cjmellor/approval/pull/64

Full Changelog: https://github.com/cjmellor/approval/compare/v1.5.0...v1.6.0

What's Changed

• feat: Extract Foreign Key from Payload by @cjmellor in https://github.com/cjmellor/approval/pull/57

[!IMPORTANT] This release requires that you're using >= PHP 8.2. If you're not, stick to the previous version.

Full Changelog: https://github.com/cjmellor/approval/compare/v1.4.5...v1.5.0

What's Changed

• fix: Rolling Back Model Fields with JSON Data by @cjmellor in https://github.com/cjmellor/approval/pull/55
• Laravel 11.x Compatibility by @laravel-shift in https://github.com/cjmellor/approval/pull/56

New Contributors

• @laravel-shift made their first contribution in https://github.com/cjmellor/approval/pull/56

Full Changelog: https://github.com/cjmellor/approval/compare/v1.4.4...v1.4.5

What's Changed

• feat: Bypass Approving a Rollback by @cjmellor in https://github.com/cjmellor/approval/pull/53

Full Changelog: https://github.com/cjmellor/approval/compare/v1.4.3...v1.4.4

What's Changed

• feat: Audit Approvals by @cjmellor in https://github.com/cjmellor/approval/pull/51
• Add model and user to all event constructors by @nunodonato in https://github.com/cjmellor/approval/pull/49

New Contributors

• @nunodonato made their first contribution in https://github.com/cjmellor/approval/pull/49

Full Changelog: https://github.com/cjmellor/approval/compare/v1.4.2...v1.4.3

What's Changed

• added support for 'include attributes list'. by @gerb-ster in https://github.com/cjmellor/approval/pull/46
• Bugfix array attributes by @gerb-ster in https://github.com/cjmellor/approval/pull/47

New Contributors

• @gerb-ster made their first contribution in https://github.com/cjmellor/approval/pull/46

Full Changelog: https://github.com/cjmellor/approval/compare/v1.4.1...v1.4.2

What's Changed

• fix: Force data approval by @cjmellor in https://github.com/cjmellor/approval/pull/43

Full Changelog: https://github.com/cjmellor/approval/compare/v1.4.0...v1.4.1

What's Changed

• build(deps): Bump stefanzweifel/git-auto-commit-action from 4 to 5 by @dependabot in https://github.com/cjmellor/approval/pull/40
• feat: Rollback Approvals by @cjmellor in https://github.com/cjmellor/approval/pull/41

Full Changelog: https://github.com/cjmellor/approval/compare/v1.3.1...v1.4.0

What's Changed

• build(deps): Bump actions/checkout from 3 to 4 by @dependabot in https://github.com/cjmellor/approval/pull/37
• fix: Use with morphMaps by @cjmellor in https://github.com/cjmellor/approval/pull/39

Full Changelog: https://github.com/cjmellor/approval/compare/v1.3.0...v1.3.1

What's Changed

• Add conditional helper methods by @cjmellor in https://github.com/cjmellor/approval/pull/34

Full Changelog: https://github.com/cjmellor/approval/compare/v1.2.0...v1.3.0

What's Changed

• build(deps): Bump dependabot/fetch-metadata from 1.5.1 to 1.6.0 by @dependabot in https://github.com/cjmellor/approval/pull/32
• Add Events by @cjmellor in https://github.com/cjmellor/approval/pull/33

Full Changelog: https://github.com/cjmellor/approval/compare/v1.1.5...v1.2.0

What's Changed

• build(deps): Bump dependabot/fetch-metadata from 1.3.6 to 1.4.0 by @dependabot in https://github.com/cjmellor/approval/pull/28
• build(deps): Bump dependabot/fetch-metadata from 1.4.0 to 1.5.1 by @dependabot in https://github.com/cjmellor/approval/pull/30
• fix getting approvalable_type by @mtawil in https://github.com/cjmellor/approval/pull/31

New Contributors

• @mtawil made their first contribution in https://github.com/cjmellor/approval/pull/31

Full Changelog: https://github.com/cjmellor/approval/compare/v1.1.4...v1.1.5

What's Changed

• fix: Rejected and Postponed State Updating by @cjmellor in https://github.com/cjmellor/approval/pull/25

Full Changelog: https://github.com/cjmellor/approval/compare/v1.1.3...v1.1.4

What's Changed

• build(deps): Bump dependabot/fetch-metadata from 1.3.5 to 1.3.6 by @dependabot in https://github.com/cjmellor/approval/pull/19
• fix: Status Updates by @cjmellor in https://github.com/cjmellor/approval/pull/23

Full Changelog: https://github.com/cjmellor/approval/compare/v1.1.2...v1.1.3

What's Changed

• build: Ugrade to Laravel 10 by @cjmellor in https://github.com/cjmellor/approval/pull/18

Full Changelog: https://github.com/cjmellor/approval/compare/v1.1.1...v1.1.2

What's Changed

• htofix: Add logic for updating data to existing data by @cjmellor in https://github.com/cjmellor/approval/pull/16

Full Changelog: https://github.com/cjmellor/approval/compare/v1.1.0...v1.1.1

What's Changed

• build(deps): Bump aglipanci/laravel-pint-action from 0.1.0 to 1.0.0 by @dependabot in https://github.com/cjmellor/approval/pull/8
• build(deps): Bump dependabot/fetch-metadata from 1.3.3 to 1.3.4 by @dependabot in https://github.com/cjmellor/approval/pull/13
• build(deps): Bump dependabot/fetch-metadata from 1.3.4 to 1.3.5 by @dependabot in https://github.com/cjmellor/approval/pull/14
• feature: Add optional logic to persist data on approval by @cjmellor in https://github.com/cjmellor/approval/pull/15

Full Changelog: https://github.com/cjmellor/approval/compare/v1.0.1...v1.1.0

What's Changed

• Use whereJsonContains instead of exact match query by @rawilk in https://github.com/cjmellor/approval/pull/7

New Contributors

• @rawilk made their first contribution in https://github.com/cjmellor/approval/pull/7

Full Changelog: https://github.com/cjmellor/approval/compare/v1.0.0...v1.0.1

Initial release