Merge pull request #5 from portier/featNormalize

Add `normalize` method

Author: Stéphan Kochen

composer.json

@@ -22,7 +22,7 @@
     },
     "require-dev": {
         "phpunit/phpunit": "^6.3",
-        "phpstan/phpstan": "^0.8",
+        "phpstan/phpstan": "^0.9",
         "squizlabs/php_codesniffer": "^3.1"
     }
 }

src/AbstractStore.php

@@ -49,8 +49,8 @@ public function generateNonce(string $email): string
 
     /**
      * Fetch a URL using HTTP GET.
-     * @param  string $url  The URL to fetch.
-     * @return object       An object with `ttl` and `data` properties.
+     * @param  string    $url  The URL to fetch.
+     * @return \stdClass       An object with `ttl` and `data` properties.
      */
     public function fetch(string $url)
     {

src/Client.php

@@ -42,6 +42,29 @@ public function __construct(StoreInterface $store, string $redirectUri)
         $this->clientId = self::getOrigin($this->redirectUri);
     }
 
+    /**
+     * Normalize one or more email addresses.
+     *
+     * This method is useful when comparing user input to an email address
+     * returned in a Portier token. It is not necessary to call this before
+     * `authenticate`, normalization is already part of the authentication
+     * process.
+     *
+     * This is currently implemented by making an HTTP call to Portier, without
+     * cache.
+     *
+     * @param  string[] $emails Email addresses to normalize.
+     * @return string[]         Normalized email addresses, empty strings for invalid.
+     */
+    public function normalize(array $emails): array
+    {
+        $res = $this->store->guzzle->post(
+            $this->broker . '/normalize',
+            ['body' => implode("\n", $emails)]
+        );
+        return explode("\n", (string) $res->getBody());
+    }
+
     /**
      * Start authentication of an email address.
      * @param  string $email  Email address to authenticate.