# Changelog

## 0.0.3
*(2026-10-12)*

#### Features
* **Skip fresh database downloads** — the `mirasvit:geolocation:download` command has a new `--max-age=<days>` option. If the database in use is newer than that many days, the download is skipped. Deploy scripts can then run the command on every deploy without downloading from MaxMind each time.

#### Fixed
* Storefront pages that use visitor location could return a 500 error when the GeoIP database was missing or couldn't be opened. In that case the lookup now returns no location, the page loads normally and a warning is logged.
* On multi-server stores and containers that start with an empty `var/` folder, location lookups failed on every server except the one that ran setup, because no database had been downloaded there. Those servers now use the database that ships with the module until a downloaded one is available.

---

## 0.0.2
*(2026-10-06)*

#### Fixed
* The database auto-update rewrote the hash and build date but kept the previously installed database file, so lookups silently ran against a stale GeoIP database. The downloaded archive is now unpacked over the installed database (the newest extracted build wins), and download attempts are logged.

## 0.0.1
*(2026-10-05)*

#### Features
* Initial release. The geolocation subsystem extracted from Mirasvit Core into its own package (`Mirasvit\GeoLocation`): the MaxMind GeoIP2 database download and update cron, IP-to-location/timezone lookup, and its admin configuration. Modules with geo-targeting features now depend on this package instead of Core.
