Laravel Fsm Laravel Package

What's new

• Fsm\Contracts\FsmEventEnum — new marker interface (extends \BackedEnum) for typing FSM event identifiers, mirroring the existing FsmStateEnum pattern. Implementations are string-backed enums whose ->value is the wire identifier.
• Widened APIs: HasFsm::trigger(), HasFsm::can(), HasFsm::dryRun(), TransitionBuilder::event(), and TransitionBuilder::on() now accept FsmEventEnum|string. Internal storage stays string; the union is at the public boundary only.

Usage

enum CheckoutEvent: string implements FsmEventEnum {
    case Submit = 'submit';
    case Complete = 'complete';
}

\$cart->fsm()->trigger(CheckoutEvent::Submit);   // typed
\$cart->fsm()->trigger('submit');                // still works

Why marker-only (no required methods)?

Events are programmatic identifiers, not user-facing values, so no `displayName()`/`icon()` analog to `FsmStateEnum`. The interface extends `\BackedEnum` so the type system enforces backed-enum-only at parse time and `->value` is statically guaranteed to exist.

Back-compat

100% back-compat with v1.0.4. Existing string callers continue to work unchanged.

Tests

3 new tests in `HasFsmEventEnumTest` confirm enum and string callers produce identical FSM behavior. Full Pest suite passes (one pre-existing test mutation flake on main is unrelated).

What's Changed

• Enhance error handling in PersistStateTransitionedEvent and update tests by @ChrisThompsonTLDR in https://github.com/ChrisThompsonTLDR/laravel-fsm/pull/4

Full Changelog: https://github.com/ChrisThompsonTLDR/laravel-fsm/compare/v1.0.3...v1.0.4

What's Changed

• refactor: simplify FSM config discovery_paths setting by @ChrisThompsonTLDR in https://github.com/ChrisThompsonTLDR/laravel-fsm/pull/3

Full Changelog: https://github.com/ChrisThompsonTLDR/laravel-fsm/compare/v1.0.2...v1.0.3

What's Changed

• Update GitHub and Coverage badge links in README by @ChrisThompsonTLDR in https://github.com/ChrisThompsonTLDR/laravel-fsm/pull/2

Full Changelog: https://github.com/ChrisThompsonTLDR/laravel-fsm/compare/v1.0.1...v1.0.2

What's Changed

• Expanding and enhancing the test suite by @ChrisThompsonTLDR in https://github.com/ChrisThompsonTLDR/laravel-fsm/pull/1

New Contributors

• @ChrisThompsonTLDR made their first contribution in https://github.com/ChrisThompsonTLDR/laravel-fsm/pull/1

Full Changelog: https://github.com/ChrisThompsonTLDR/laravel-fsm/compare/v1.0.0...v1.0.1

Full Changelog: https://github.com/ChrisThompsonTLDR/laravel-fsm/commits/v1.0.0