[SDK-2435] Add Organizations support to Management API Client (#483)

Author: evansims

phpunit.xml.dist

@@ -1,7 +1,10 @@
-<phpunit
-  colors="true"
-  verbose="true"
-  bootstrap="./tests/bootstrap.php">
+<?xml version="1.0"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" colors="true" verbose="true" bootstrap="./tests/bootstrap.php" xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.3/phpunit.xsd">
+  <coverage>
+    <include>
+      <directory suffix=".php">./src/</directory>
+    </include>
+  </coverage>
   <testsuites>
     <testsuite name="unit">
       <directory>./tests/unit</directory>
@@ -10,10 +13,4 @@
       <directory>./tests/integration</directory>
     </testsuite>
   </testsuites>
-
-  <filter>
-    <whitelist>
-      <directory suffix=".php">./src/</directory>
-    </whitelist>
-  </filter>
 </phpunit>

src/API/Management.php

@@ -18,6 +18,7 @@
 use Auth0\SDK\API\Management\Logs;
 use Auth0\SDK\API\Management\LogStreams;
 use Auth0\SDK\API\Management\ResourceServers;
+use Auth0\SDK\API\Management\Organizations;
 use Auth0\SDK\API\Management\Roles;
 use Auth0\SDK\API\Management\Rules;
 use Auth0\SDK\API\Management\Stats;
@@ -126,6 +127,13 @@ class Management
      */
     private $logStreams;
 
+    /**
+     * Instance of Auth0\SDK\API\Management\Organizations
+     *
+     * @var Organizations
+     */
+    private $organizations;
+
     /**
      * Instance of Auth0\SDK\API\Management\Roles
      *
@@ -381,6 +389,20 @@ public function logStreams() : LogStreams
         return $this->logStreams;
     }
 
+    /**
+     * Return an instance of the Organizations class.
+     *
+     * @return Organizations
+     */
+    public function organizations() : Organizations
+    {
+        if (! $this->organizations instanceof Organizations) {
+            $this->organizations = new Organizations($this->apiClient);
+        }
+
+        return $this->organizations;
+    }
+
     /**
      * Return an instance of the Roles class.
      *

src/API/Management/GenericResource.php

@@ -183,4 +183,21 @@ protected function checkEmptyOrInvalidString($var, $var_name)
             throw new EmptyOrInvalidParameterException($var_name);
         }
     }
+
+    /**
+     * Check that a variable is an array and is not empty.
+     *
+     * @param mixed  $var      The variable to check.
+     * @param string $var_name The variable name.
+     *
+     * @return void
+     *
+     * @throws EmptyOrInvalidParameterException If $var is empty or is not a string.
+     */
+    protected function checkEmptyOrInvalidArray($var, $var_name)
+    {
+        if (! is_array($var) || ! count($var)) {
+            throw new EmptyOrInvalidParameterException($var_name);
+        }
+    }
 }

src/API/Management/Jobs.php

@@ -125,10 +125,11 @@ public function exportUsers($params = [])
      *
      * @param string $user_id User ID of the user to send the verification email to.
      * @param array  $params  Array of optional parameters to add.
-     *        - client_id: Client ID of the requesting application. If not provided, the global Client ID will be used.
-     *        - identity:  The optional identity of the user, as an array. Required to verify primary identities when using social, enterprise, or passwordless connections. It is also required to verify secondary identities.
-     *              - user_id: User ID of the identity to be verified. Must be a non-empty string.
-     *              - provider: Identity provider name of the identity (e.g. google-oauth2). Must be a non-empty string.
+     *                        - client_id: Client ID of the requesting application. If not provided, the global Client ID will be used.
+     *                        - identity: The optional identity of the user, as an array. Required to verify primary identities when using social, enterprise, or passwordless connections. It is also required to verify secondary identities.
+     *                        - user_id: User ID of the identity to be verified. Must be a non-empty string.
+     *                        - provider: Identity provider name of the identity (e.g. google-oauth2). Must be a non-empty string.
+     *                        - organization_id: ID of the organization. If provided, the organization_id and organization_name will be included as query arguments in the link back to the application.
      *
      * @throws EmptyOrInvalidParameterException Thrown if any required parameters are empty or invalid.
      * @throws \Exception Thrown by the HTTP client when there is a problem with the API call.
@@ -145,6 +146,10 @@ public function sendVerificationEmail($user_id, array $params = [])
             $body['client_id'] = $params['client_id'];
         }
 
+        if (! empty( $params['organization_id'] )) {
+            $body['organization_id'] = $params['organization_id'];
+        }
+
         if (! empty( $params['identity'] )) {
             if (empty( $params['identity']['user_id']) || ! is_string($params['identity']['user_id'])) {
                 throw new EmptyOrInvalidParameterException('Missing required "user_id" field of the "identity" object.');