v2.5.0

2026-03-07T19:24:00Z

v2.5.0 - 2026-03-07

Added

feature [Laravel] Improve Laravel Octane support by resetting FallbackSession static storage between requests to prevent notification leakage
feature [Symfony] Add FrankenPHP/Swoole/RoadRunner support with WorkerListener that implements ResetInterface and is tagged with kernel.reset
feature [Symfony] Add reset() method to FallbackSession for long-running process support
feature [Flasher] Add Hotwire/Turbo Drive support with turbo:before-cache event listener to clean up notifications before page caching
feature [Flasher] Add event dispatching system for all notification adapters and themes with Livewire integration:
- [Toastr] Dispatch events: flasher:toastr:click, flasher:toastr:close, flasher:toastr:show, flasher:toastr:hidden
- [Noty] Dispatch events: flasher:noty:click, flasher:noty:close, flasher:noty:show, flasher:noty:hover
- [Notyf] Dispatch events: flasher:notyf:click, flasher:notyf:dismiss
- [Themes] Dispatch events: flasher:theme:click (generic) and flasher:theme:{name}:click (specific)
- [Laravel] Add LivewireListener classes for all adapters and themes to enable Livewire event handling
feature [Flasher] Add 16 notification themes: Amazon, Amber, Jade, Crystal, and more
feature [DX] Add @method annotations to FlasherInterface and NotificationFactoryInterface for better IDE autocompletion
feature [DX] Add Type::all() and Type::isValid() helper methods with PHPStan type narrowing
feature [DX] Add @throws annotations to FlasherContainer methods for better exception documentation
feature [DX] Add FlasherContainer::setContainer() method as convenient alias for testing
feature [DX] Add PHPStan type alias NotificationType for valid notification types

Fixed

fix [SweetAlert] Fix SweetAlertBuilder::question() bug where options parameter was being ignored
fix [Flasher] Fix potential runtime error in Envelope::toArray() when no PresentableStampInterface stamps exist
fix [Flasher] Use more specific \Random\RandomException in IdStamp instead of broad \Exception
fix [Flasher] Update Livewire navigation cleanup to use correct .fl-wrapper selector instead of unused .fl-no-cache class
fix [Flasher] Fix FilterCriteria uninitialized property error when constructed with empty array
fix [Flasher] Fix null comparison issues in PriorityCriteria, HopsCriteria, and DelayCriteria that relied on PHP's implicit null-to-0 coercion
fix [Flasher] Add type validation for callable factory return values in NotificationFactoryLocator with descriptive error messages
fix [Flasher] Add error handling for invalid regex patterns in ResponseExtension::isPathExcluded()
fix [Flasher] Fix ContentSecurityPolicyHandler parsing of CSP headers with trailing semicolons creating empty directive keys
fix [Flasher] Add reset() method to ContentSecurityPolicyHandler to fix CSP state leak in long-running processes (Octane, FrankenPHP)
fix [Flasher] Fix FilterEvent::setFilter() type inconsistency - now accepts FilterInterface instead of concrete Filter class
fix [Flasher] Remove redundant callable check in FlasherContainer::getContainer()
fix [Flasher] Fix NotificationStorageMethods::resolveResourceName() return type from ?string to string (never returns null)
fix [Flasher] Fix parameter name inconsistency in NotificationBuilderInterface::options() - changed $merge to $append to match implementation
fix [Flasher] Add type validation for callable presenter return values in ResponseManager with descriptive error messages
fix [Flasher] Fix FlasherPlugin::normalizePlugins() losing scripts/styles when both top-level and plugin-level configs are provided - replaced array union operator with array_merge
fix [Flasher] Simplify FlasherPlugin::normalizeFlashBag() by replacing redundant array union with direct array_merge
fix [Flasher] Fix array_merge() syntax in InstallCommand by removing unnecessary empty array
fix [Flasher] Add return type validation in FilterCriteria::apply() with proper exception handling

Changed

refactor [Flasher] Reduce theme configuration duplication by generating themes programmatically
refactor [Flasher] Standardize exception message format in PresetNotFoundException to use brackets like other exceptions
refactor [Flasher] Standardize exception message wording in CriteriaNotRegisteredException to use "not found" instead of "is not found"
refactor [SweetAlert] Replace @phpstan-ignore-line suppressions with proper @var annotations

v2.3.0

2025-12-09T10:28:22Z

Full Changelog: v2.2.0...v2.3.0

Updates Flasher to v2.2.0

2025-11-10T14:20:21Z

Updates the flasher dependencies in composer.json files and package.json files to version 2.2.0.

Updates the Flasher version constant in the Prime Flasher class.

Merge pull request #216 from php-flasher/v2.1.5

2025-02-21T17:55:10Z

prepare for v2.1.5

v2.1.4

2025-02-18T13:06:36Z

Merge pull request #215 from php-flasher/v2.1.4

chore: bump flasher dependency to v2.1.4

v2.1.3

2025-01-25T13:40:29Z

bug #208 [Flasher] Add GitHub workflow for automatic publishing of assets to NPM. See PR #211 by ToshY

Full Changelog: v2.1.2...v2.1.3

v2.1.2: Merge pull request #210 from php-flasher/upgrade-dependencies

2025-01-18T10:34:10Z

upgrade dependencies

v2.1.1

2024-10-20T14:15:23Z

feature [Laravel] Add excluded_paths option. See PR #203 by yoeunes

Full Changelog: v2.1.0...v2.1.1

v2.1.0

2024-10-19T15:58:17Z

feature [Flasher] Update laravel and symfony configuration documentation . See PR #201 by yoeunes
feature [Flasher] Improve Type Safety and IDE Support with Enhanced PHPDoc Annotations and Stricter PHPStan Validations. See PR #200 by yoeunes
feature [Symfony] Improve configuration descriptions and add examples. See PR #199 by yoeunes
feature [Symfony] Add Symfony Profiler integration for PHPFlasher. See PR #198 by yoeunes

Full Changelog: v2.0.4...v2.1.0

v2.0.4

2024-09-22T14:32:58Z

chore: update CHANGELOG

Release notes from php-flasher