chore: refactor services to eliminate code duplication

[imorland]

Overview:

This PR introduces several enhancements to fof/geoip. The primary change is the introduction of a base class for the GeoIP services, which refactors and streamlines the service implementations.

Additionally, a trait for handling GeoIP errors has been added, and localization updates have been made.

Key Changes:

• Localization Update: The description for the IPData service in resources/locale/en.yml has been updated to mention the availability of paid plans for higher usage limits.
• Refactoring GeoIP Service Classes: A new base class BaseGeoService has been introduced in Api/Services/BaseGeoService.php. This abstracts away common functionality from the individual service classes, providing a cleaner and more standardized approach.
  • The service classes for IPApi, IPData, IPLocation, and IPStack have been refactored to extend this new base class.
  • Common methods such as building the request URL, checking for errors, and handling errors have been abstracted into the base class.
• Handling GeoIP Errors: A new trait HandlesGeoIPErrors has been added in Traits/HandlesGeoIPErrors.php. This trait provides a method to handle GeoIP errors and is used in the GeoIP class.
• Miscellaneous Updates:
  • The constructor of the GeoIP class has been updated to use the shorthand syntax for property promotion.
  • The RetrieveIP class has been updated to use the contract for the cache repository instead of the concrete implementation..