Improve PHPDoc and add some missing type info

Author: alies-dev

src/Facades/GeoIP.php

@@ -7,6 +7,9 @@
 use Illuminate\Support\Facades\Facade;
 
 /**
+ * @method static \InteractionDesignFoundation\GeoIP\Location getLocation(string|null $ip)
+ * @method static string getCurrency(string $iso)
+ * @method static \InteractionDesignFoundation\GeoIP\Contracts\ServiceInterface getService()
  * @mixin \InteractionDesignFoundation\GeoIP\GeoIP
  */
 class GeoIP extends Facade

src/GeoIP.php

@@ -133,7 +133,7 @@ public function getLocation($ip = null)
      * @return \InteractionDesignFoundation\GeoIP\Location
      * @throws \Exception
      */
-    private function find($ip = null)
+    private function find($ip = null): Location
     {
         // If IP not set, user remote IP
         $ip = $ip ?: $this->remote_ip;

src/Location.php

@@ -25,6 +25,7 @@
  * @property string|null $currency
  * @property bool $default
  * @property bool $cached
+ * @property-read string $displayName {@see static::getDisplayNameAttribute()}
  */
 class Location implements ArrayAccess
 {

src/helpers.php

@@ -6,13 +6,14 @@
     /**
      * Get the location of the provided IP.
      *
-     * @param string $ip
-     *
+     * @param string|null $ip
      * @return \InteractionDesignFoundation\GeoIP\GeoIP|\InteractionDesignFoundation\GeoIP\Location
+     * @psalm-return ($ip is null ? \InteractionDesignFoundation\GeoIP\GeoIP : \InteractionDesignFoundation\GeoIP\Location)
+     * @throws \Exception
      */
     function geoip($ip = null)
     {
-        if (is_null($ip)) {
+        if ($ip === null) {
             return app('geoip');
         }