Add helper method Users::findOne()

Author: danmichaelo

CHANGELOG.md

@@ -27,6 +27,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - Added item checkout and scan-in.
 - Analytics: The `getRows()` method is deprecated. Iterate over the `Report` instead.
 - Made package auto-discoverable in Laravel 5.5+.
+- Added helper method `Users::findOne()` to get the first match from a search.
 
 ### Changed
 

src/Model/Model.php

@@ -7,7 +7,7 @@
 /**
  * The Model class is our base class.
  */
-abstract class Model
+abstract class Model implements \JsonSerializable
 {
     /* @var Client */
     protected $client;
@@ -75,4 +75,9 @@ public function __get($key)
 
         return null;
     }
+
+    public function jsonSerialize()
+    {
+        return $this->data;
+    }
 }

src/Users/Users.php

@@ -34,6 +34,18 @@ public function get($user_id, $params = [])
             ->setParams($params);
     }
 
+    /**
+     * Get the first user matching a given query, or NULL if not found.
+     *
+     * @param string $query
+     * @param array $options
+     * @return User|null
+     */
+    public function findOne($query, array $options = [])
+    {
+        return $this->search($query, $options)->current();
+    }
+
     /**
      * Iterates over all users matching the given query.
      * Handles continuation.