# Changelog

Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), versioning: [SemVer](https://semver.org/spec/v2.0.0.html).

## [1.0.0] - 2026-09-29

First release.

### Added

- Filter-combination detection in category and search controllers, separate threshold per context and per website; the decision runs in the `controller_action_predispatch` observer, before `execute()`, so `afterExecute` plugins of other modules cannot replace the challenge response
- Cloudflare Turnstile challenge page from `emacom/bot-shield-core`, HMAC-signed cookie with configurable TTL, key derived from `crypt/key` through HKDF
- 403 with the Turnstile modal payload for AJAX layered navigation, `challenge-interceptor.js` on listing pages, JSON answer from `botshield/challenge/verify`
- `js/jquery-challenge-guard.js`: the jQuery `error` handler of a challenged AJAX call is skipped, so layered navigation modules do not leave the page under the modal
- ElasticSuite support without a dependency on Smile classes: the `catalog/navigation_filter/ajax` endpoint is guarded, each value of a multi-value filter counts separately, `cat` on that endpoint is not counted
- Amasty Improved Layered Navigation support, detected by module name: AJAX navigation gets the 403 challenge, each comma-separated value of a multi-select filter counts separately, SEO URLs included, `shopbyAjax` dropped from the return address
- Pass-list: infrastructure CIDR ranges, `X-Verified-Bot` header, forward-confirmed reverse DNS for declared bots
- `log_only` and `enforce` modes, logfmt log at `var/log/botshield.log`, fail-open on Turnstile API failure, degraded mode when the client IP is private
- 122 unit tests, 29 integration tests, PHPStan level 5, `Magento2` coding standard

### Verified

Each release below with sample data, BotShield in `enforce` mode, native layered navigation.

| Magento | PHP | OpenSearch | PHPUnit | Result |
|---|---|---|---|---|
| 2.4.6-p15 | 8.2 | 2.12 | 9.6 | pass |
| 2.4.7-p6 | 8.3 | 3.6 | 9.6 | pass |
| 2.4.8-p5 | 8.4 | 3.6 | 10.5 | pass |
| 2.4.9 | 8.5 | 3.6 | 12.5 | pass |

| Component | Version |
|---|---|
| Monolog | 2.11.1 and 3.x |
| `emacom/bot-shield-core` | 1.0.0 |
