auth0 2.41.0 → 2.43.0

package/src/management/ClientsManager.js

@@ -1,6 +1,5 @@
 const { ArgumentError } = require('rest-facade');
-const Auth0RestClient = require('../Auth0RestClient');
-const RetryRestClient = require('../RetryRestClient');
+const BaseManager = require('./BaseManager');
 
 /**
  * Auth0 Clients Manager.
@@ -11,7 +10,7 @@ const RetryRestClient = require('../RetryRestClient');
  * {@link https://auth0.com/docs/applications Applications} section of the
  * documentation.
  */
-class ClientsManager {
+class ClientsManager extends BaseManager {
   /**
    * @param {object} options            The client options.
    * @param {string} options.baseUrl    The URL of the API.
@@ -19,28 +18,7 @@ class ClientsManager {
    * @param {object} [options.retry]    Retry Policy Config
    */
   constructor(options) {
-    if (options === null || typeof options !== 'object') {
-      throw new ArgumentError('Must provide client options');
-    }
-
-    if (options.baseUrl === null || options.baseUrl === undefined) {
-      throw new ArgumentError('Must provide a base URL for the API');
-    }
-
-    if ('string' !== typeof options.baseUrl || options.baseUrl.length === 0) {
-      throw new ArgumentError('The provided base URL is invalid');
-    }
-
-    /**
-     * Options object for the Rest Client instance.
-     *
-     * @type {object}
-     */
-    const clientOptions = {
-      errorFormatter: { message: 'message', name: 'error' },
-      headers: options.headers,
-      query: { repeatParams: false },
-    };
+    super(options);
 
     /**
      * Provides an abstraction layer for consuming the
@@ -48,12 +26,7 @@ class ClientsManager {
      *
      * @type {external:RestClient}
      */
-    const auth0RestClient = new Auth0RestClient(
-      `${options.baseUrl}/clients/:client_id`,
-      clientOptions,
-      options.tokenProvider
-    );
-    this.resource = new RetryRestClient(auth0RestClient, options.retry);
+    this.resource = this._getRestClient('/clients/:client_id');
 
     /**
      * Provides an abstraction layer for consuming the
@@ -61,12 +34,7 @@ class ClientsManager {
      *
      * @type {external:RestClient}
      */
-    const auth0RotateSecretClient = new Auth0RestClient(
-      `${options.baseUrl}/clients/:client_id/rotate-secret`,
-      clientOptions,
-      options.tokenProvider
-    );
-    this.rotateSecretResource = new RetryRestClient(auth0RotateSecretClient, options.retry);
+    this.rotateSecretResource = this._getRestClient('/clients/:client_id/rotate-secret');
   }
 
   /**

package/src/management/ConnectionsManager.js

@@ -1,11 +1,10 @@
 const { ArgumentError } = require('rest-facade');
-const Auth0RestClient = require('../Auth0RestClient');
-const RetryRestClient = require('../RetryRestClient');
+const BaseManager = require('./BaseManager');
 
 /**
  * Represents the relationship between Auth0 and an Identity provider.
  */
-class ConnectionsManager {
+class ConnectionsManager extends BaseManager {
   /**
    * @param {object} options            The client options.
    * @param {string} options.baseUrl    The URL of the API.
@@ -13,27 +12,7 @@ class ConnectionsManager {
    * @param {object} [options.retry]    Retry Policy Config
    */
   constructor(options) {
-    if (options === null || typeof options !== 'object') {
-      throw new ArgumentError('Must provide client options');
-    }
-
-    if (options.baseUrl === null || options.baseUrl === undefined) {
-      throw new ArgumentError('Must provide a base URL for the API');
-    }
-
-    if ('string' !== typeof options.baseUrl || options.baseUrl.length === 0) {
-      throw new ArgumentError('The provided base URL is invalid');
-    }
-
-    /**
-     * Options object for the Rest Client instance.
-     *
-     * @type {object}
-     */
-    const clientOptions = {
-      headers: options.headers,
-      query: { repeatParams: false },
-    };
+    super(options);
 
     /**
      * Provides an abstraction layer for performing CRUD operations on
@@ -42,19 +21,9 @@ class ConnectionsManager {
      *
      * @type {external:RestClient}
      */
-    const auth0RestClient = new Auth0RestClient(
-      `${options.baseUrl}/connections/:id`,
-      clientOptions,
-      options.tokenProvider
-    );
-    this.resource = new RetryRestClient(auth0RestClient, options.retry);
+    this.resource = this._getRestClient('/connections/:id');
 
-    const statusClient = new Auth0RestClient(
-      `${options.baseUrl}/connections/:id/status`,
-      clientOptions,
-      options.tokenProvider
-    );
-    this.status = new RetryRestClient(statusClient, options.retry);
+    this.status = this._getRestClient('/connections/:id/status');
 
     /**
      * Provides an abstraction layer for consuming the
@@ -63,12 +32,7 @@ class ConnectionsManager {
      *
      * @type {external:RestClient}
      */
-    const userAuth0RestClient = new Auth0RestClient(
-      `${options.baseUrl}/connections/:id/users`,
-      clientOptions,
-      options.tokenProvider
-    );
-    this.user = new RetryRestClient(userAuth0RestClient, options.retry);
+    this.user = this._getRestClient('/connections/:id/users');
   }
 
   /**

package/src/management/CustomDomainsManager.js

@@ -1,6 +1,5 @@
 const { ArgumentError } = require('rest-facade');
-const Auth0RestClient = require('../Auth0RestClient');
-const RetryRestClient = require('../RetryRestClient');
+const BaseManager = require('./BaseManager');
 
 /**
  * Auth0 Custom Domains Manager.
@@ -11,7 +10,7 @@ const RetryRestClient = require('../RetryRestClient');
  * {@link https://auth0.com/docs/custom-domains CustomDomains} section of the
  * documentation.
  */
-class CustomDomainsManager {
+class CustomDomainsManager extends BaseManager {
   /**
    * @param {object} options            The client options.
    * @param {string} options.baseUrl    The URL of the API.
@@ -19,28 +18,7 @@ class CustomDomainsManager {
    * @param {object} [options.retry]    Retry Policy Config
    */
   constructor(options) {
-    if (options === null || typeof options !== 'object') {
-      throw new ArgumentError('Must provide manager options');
-    }
-
-    if (options.baseUrl === null || options.baseUrl === undefined) {
-      throw new ArgumentError('Must provide a base URL for the API');
-    }
-
-    if ('string' !== typeof options.baseUrl || options.baseUrl.length === 0) {
-      throw new ArgumentError('The provided base URL is invalid');
-    }
-
-    /**
-     * Options object for the Rest Client instance.
-     *
-     * @type {object}
-     */
-    const clientOptions = {
-      errorFormatter: { message: 'message', name: 'error' },
-      headers: options.headers,
-      query: { repeatParams: false },
-    };
+    super(options);
 
     /**
      * Provides an abstraction layer for consuming the
@@ -48,12 +26,7 @@ class CustomDomainsManager {
      *
      * @type {external:RestClient}
      */
-    const auth0CustomDomainsRestClient = new Auth0RestClient(
-      `${options.baseUrl}/custom-domains/:id`,
-      clientOptions,
-      options.tokenProvider
-    );
-    this.resource = new RetryRestClient(auth0CustomDomainsRestClient, options.retry);
+    this.resource = this._getRestClient('/custom-domains/:id');
 
     /**
      * Provides an abstraction layer for consuming the
@@ -61,12 +34,7 @@ class CustomDomainsManager {
      *
      * @type {external:RestClient}
      */
-    const auth0VerifyRestClient = new Auth0RestClient(
-      `${options.baseUrl}/custom-domains/:id/verify`,
-      clientOptions,
-      options.tokenProvider
-    );
-    this.vefifyResource = new RetryRestClient(auth0VerifyRestClient, options.retry);
+    this.vefifyResource = this._getRestClient('/custom-domains/:id/verify');
   }
 
   /**

package/src/management/DeviceCredentialsManager.js

@@ -1,11 +1,9 @@
-const { ArgumentError } = require('rest-facade');
-const Auth0RestClient = require('../Auth0RestClient');
-const RetryRestClient = require('../RetryRestClient');
+const BaseManager = require('./BaseManager');
 
 /**
  * Manages Auth0 Device Credentials.
  */
-class DeviceCredentialsManager {
+class DeviceCredentialsManager extends BaseManager {
   /**
    * @param {object} options            The client options.
    * @param {string} options.baseUrl    The URL of the API.
@@ -13,28 +11,13 @@ class DeviceCredentialsManager {
    * @param {object} [options.retry]    Retry Policy Config
    */
   constructor(options) {
-    if (options === null || typeof options !== 'object') {
-      throw new ArgumentError('Must provide manager options');
-    }
-
-    if (options.baseUrl === null || options.baseUrl === undefined) {
-      throw new ArgumentError('Must provide a base URL for the API');
-    }
-
-    if ('string' !== typeof options.baseUrl || options.baseUrl.length === 0) {
-      throw new ArgumentError('The provided base URL is invalid');
-    }
+    super(options);
 
     /**
      * Options object for the RestClient instance.
      *
      * @type {object}
      */
-    const clientOptions = {
-      errorFormatter: { message: 'message', name: 'error' },
-      headers: options.headers,
-      query: { repeatParams: false },
-    };
 
     /**
      * Provides an abstraction layer for consuming the
@@ -43,12 +26,7 @@ class DeviceCredentialsManager {
      *
      * @type {external:RestClient}
      */
-    const auth0RestClient = new Auth0RestClient(
-      `${options.baseUrl}/device-credentials/:id`,
-      clientOptions,
-      options.tokenProvider
-    );
-    this.resource = new RetryRestClient(auth0RestClient, options.retry);
+    this.resource = this._getRestClient('/device-credentials/:id');
   }
 
   /**

package/src/management/EmailProviderManager.js

@@ -1,11 +1,9 @@
-const { ArgumentError } = require('rest-facade');
-const Auth0RestClient = require('../Auth0RestClient');
-const RetryRestClient = require('../RetryRestClient');
+const BaseManager = require('./BaseManager');
 
 /**
  * Auth0 Email Provider.
  */
-class EmailProviderManager {
+class EmailProviderManager extends BaseManager {
   /**
    * @param {object} options            The client options.
    * @param {string} options.baseUrl    The URL of the API.
@@ -13,28 +11,7 @@ class EmailProviderManager {
    * @param {object} [options.retry]    Retry Policy Config
    */
   constructor(options) {
-    if (options === null || typeof options !== 'object') {
-      throw new ArgumentError('Must provide client options');
-    }
-
-    if (options.baseUrl === null || options.baseUrl === undefined) {
-      throw new ArgumentError('Must provide a base URL for the API');
-    }
-
-    if ('string' !== typeof options.baseUrl || options.baseUrl.length === 0) {
-      throw new ArgumentError('The provided base URL is invalid');
-    }
-
-    /**
-     * Options object for the Rest Client instance.
-     *
-     * @type {object}
-     */
-    const clientOptions = {
-      errorFormatter: { message: 'message', name: 'error' },
-      headers: options.headers,
-      query: { repeatParams: false },
-    };
+    super(options);
 
     /**
      * Provides an abstraction layer for consuming the
@@ -42,12 +19,7 @@ class EmailProviderManager {
      *
      * @type {external:RestClient}
      */
-    const auth0RestClient = new Auth0RestClient(
-      `${options.baseUrl}/emails/provider`,
-      clientOptions,
-      options.tokenProvider
-    );
-    this.resource = new RetryRestClient(auth0RestClient, options.retry);
+    this.resource = this._getRestClient('/emails/provider');
   }
 
   /**

package/src/management/EmailTemplatesManager.js

@@ -1,12 +1,10 @@
-const { ArgumentError } = require('rest-facade');
-const Auth0RestClient = require('../Auth0RestClient');
-const RetryRestClient = require('../RetryRestClient');
+const BaseManager = require('./BaseManager');
 
 /**
  * This class provides a simple abstraction for performing CRUD operations
  * on Auth0's Email Templates. {@link https://auth0.com/docs/api/management/v2#!/Email_Templates/get_email_templates_by_templateName}
  */
-class EmailTemplatesManager {
+class EmailTemplatesManager extends BaseManager {
   /**
    * @param {object} options            The client options.
    * @param {string} options.baseUrl    The URL of the API.
@@ -14,23 +12,7 @@ class EmailTemplatesManager {
    * @param {object} [options.retry]    Retry Policy Config
    */
   constructor(options) {
-    if (!options || 'object' !== typeof options) {
-      throw new ArgumentError('Must provide manager options');
-    }
-
-    if (!options.baseUrl || 'string' !== typeof options.baseUrl) {
-      throw new ArgumentError('Must provide a valid string as base URL for the API');
-    }
-
-    /**
-     * Options object for the Rest Client instance.
-     *
-     * @type {object}
-     */
-    const clientOptions = {
-      headers: options.headers,
-      query: { repeatParams: false },
-    };
+    super(options);
 
     /**
      * Provides an abstraction layer for performing CRUD operations on
@@ -38,12 +20,7 @@ class EmailTemplatesManager {
      *
      * @type {external:RestClient}
      */
-    const auth0RestClient = new Auth0RestClient(
-      `${options.baseUrl}/email-templates/:name`,
-      clientOptions,
-      options.tokenProvider
-    );
-    this.resource = new RetryRestClient(auth0RestClient, options.retry);
+    this.resource = this._getRestClient('/email-templates/:name');
   }
 
   /**

package/src/management/GrantsManager.js

@@ -1,13 +1,11 @@
-const { ArgumentError } = require('rest-facade');
-const Auth0RestClient = require('../Auth0RestClient');
-const RetryRestClient = require('../RetryRestClient');
+const BaseManager = require('./BaseManager');
 
 /**
  * Auth0 Grants Manager.
  *
  * See {@link https://auth0.com/docs/api/v2#!/Grants Grants}
  */
-class GrantsManager {
+class GrantsManager extends BaseManager {
   /**
    * @param {object} options            The client options.
    * @param {string} options.baseUrl    The URL of the API.
@@ -15,28 +13,7 @@ class GrantsManager {
    * @param {object} [options.retry]    Retry Policy Config
    */
   constructor(options) {
-    if (options === null || typeof options !== 'object') {
-      throw new ArgumentError('Must provide client options');
-    }
-
-    if (options.baseUrl === null || options.baseUrl === undefined) {
-      throw new ArgumentError('Must provide a base URL for the API');
-    }
-
-    if ('string' !== typeof options.baseUrl || options.baseUrl.length === 0) {
-      throw new ArgumentError('The provided base URL is invalid');
-    }
-
-    /**
-     * Options object for the Rest Client instance.
-     *
-     * @type {object}
-     */
-    const clientOptions = {
-      errorFormatter: { message: 'message', name: 'error' },
-      headers: options.headers,
-      query: { repeatParams: false },
-    };
+    super(options);
 
     /**
      * Provides an abstraction layer for consuming the
@@ -44,12 +21,7 @@ class GrantsManager {
      *
      * @type {external:RestClient}
      */
-    const auth0RestClient = new Auth0RestClient(
-      `${options.baseUrl}/grants/:id`,
-      clientOptions,
-      options.tokenProvider
-    );
-    this.resource = new RetryRestClient(auth0RestClient, options.retry);
+    this.resource = this._getRestClient('/grants/:id');
   }
 
   /**

package/src/management/GuardianManager.js

@@ -1,11 +1,9 @@
-const { ArgumentError } = require('rest-facade');
-const Auth0RestClient = require('../Auth0RestClient');
-const RetryRestClient = require('../RetryRestClient');
+const BaseManager = require('./BaseManager');
 
 /**
  * Abstracts interaction with the Guardian endpoint.
  */
-class GuardianManager {
+class GuardianManager extends BaseManager {
   /**
    * @param {object} options            The client options.
    * @param {string} options.baseUrl    The URL of the API.
@@ -13,127 +11,64 @@ class GuardianManager {
    * @param {object} [options.retry]    Retry Policy Config
    */
   constructor(options) {
-    if (options === null || typeof options !== 'object') {
-      throw new ArgumentError('Must provide manager options');
-    }
-
-    if (options.baseUrl === null || options.baseUrl === undefined) {
-      throw new ArgumentError('Must provide a base URL for the API');
-    }
-
-    if ('string' !== typeof options.baseUrl || options.baseUrl.length === 0) {
-      throw new ArgumentError('The provided base URL is invalid');
-    }
-
-    const clientOptions = {
-      errorFormatter: { message: 'message', name: 'error' },
-      headers: options.headers,
-      query: { repeatParams: false },
-    };
+    super(options);
 
     /**
      * Provides an abstraction layer for retrieving Guardian enrollments.
      *
      * @type {external:RestClient}
      */
-    const guardianEnrollmentsAuth0RestClient = new Auth0RestClient(
-      `${options.baseUrl}/guardian/enrollments/:id`,
-      clientOptions,
-      options.tokenProvider
-    );
-    this.enrollments = new RetryRestClient(guardianEnrollmentsAuth0RestClient, options.retry);
+    this.enrollments = this._getRestClient('/guardian/enrollments/:id');
 
     /**
      * Provides an abstraction layer for retrieving Guardian tickets.
      *
      * @type {external:RestClient}
      */
-    const guardianTicketsAuth0RestClient = new Auth0RestClient(
-      `${options.baseUrl}/guardian/enrollments/ticket`,
-      clientOptions,
-      options.tokenProvider
-    );
-    this.tickets = new RetryRestClient(guardianTicketsAuth0RestClient, options.retry);
+    this.tickets = this._getRestClient('/guardian/enrollments/ticket');
 
     /**
      * Provides an abstraction layer for retrieving Guardian factors.
      *
      * @type {external:RestClient}
      */
-    const guardianFactorsAuth0RestClient = new Auth0RestClient(
-      `${options.baseUrl}/guardian/factors/:name`,
-      clientOptions,
-      options.tokenProvider
-    );
-    this.factors = new RetryRestClient(guardianFactorsAuth0RestClient, options.retry);
+    this.factors = this._getRestClient('/guardian/factors/:name');
 
     /**
      * Provides an abstraction layer for configuring Factor settings
      *
      * @type {external:RestClient}
      */
-    const guardianFactorSettingsAuth0RestClient = new Auth0RestClient(
-      `${options.baseUrl}/guardian/factors/:name/settings`,
-      clientOptions,
-      options.tokenProvider
-    );
-    this.factorSettings = new RetryRestClient(guardianFactorSettingsAuth0RestClient, options.retry);
+    this.factorSettings = this._getRestClient('/guardian/factors/:name/settings');
 
     /**
      * Provides an abstraction layer for retrieving Guardian factor templates.
      *
      * @type {external:RestClient}
      */
-    const guardianFactorsTemplatesAuth0RestClient = new Auth0RestClient(
-      `${options.baseUrl}/guardian/factors/:name/templates`,
-      clientOptions,
-      options.tokenProvider
-    );
-    this.factorsTemplates = new RetryRestClient(
-      guardianFactorsTemplatesAuth0RestClient,
-      options.retry
-    );
+    this.factorsTemplates = this._getRestClient('/guardian/factors/:name/templates');
 
     /**
      * Provides an abstraction layer for retrieving Guardian factor providers.
      *
      * @type {external:RestClient}
      */
-    const guardianFactorsProvidersAuth0RestClient = new Auth0RestClient(
-      `${options.baseUrl}/guardian/factors/:name/providers/:provider`,
-      clientOptions,
-      options.tokenProvider
-    );
-    this.factorsProviders = new RetryRestClient(
-      guardianFactorsProvidersAuth0RestClient,
-      options.retry
-    );
+    this.factorsProviders = this._getRestClient('/guardian/factors/:name/providers/:provider');
 
     /**
      * Provides an abstraction layer for retrieving Guardian policies.
      *
      * @type {external:RestClient}
      */
-    const guardianPoliciesAuth0RestClient = new Auth0RestClient(
-      `${options.baseUrl}/guardian/policies`,
-      clientOptions,
-      options.tokenProvider
-    );
-    this.policies = new RetryRestClient(guardianPoliciesAuth0RestClient, options.retry);
+    this.policies = this._getRestClient('/guardian/policies');
 
     /**
      * Provides an abstraction layer for retrieving Guardian phone factor selected provider.
      *
      * @type {external:RestClient}
      */
-    const guardianFactorsPhoneSelectedProviderAuth0RestClient = new Auth0RestClient(
-      `${options.baseUrl}/guardian/factors/sms/selected-provider`,
-      clientOptions,
-      options.tokenProvider
-    );
-    this.factorsPhoneSelectedProvider = new RetryRestClient(
-      guardianFactorsPhoneSelectedProviderAuth0RestClient,
-      options.retry
+    this.factorsPhoneSelectedProvider = this._getRestClient(
+      '/guardian/factors/sms/selected-provider'
     );
 
     /**
@@ -141,15 +76,7 @@ class GuardianManager {
      *
      * @type {external:RestClient}
      */
-    const guardianFactorsPhoneMessageTypesAuth0RestClient = new Auth0RestClient(
-      `${options.baseUrl}/guardian/factors/phone/message-types`,
-      clientOptions,
-      options.tokenProvider
-    );
-    this.factorsPhoneMessageTypes = new RetryRestClient(
-      guardianFactorsPhoneMessageTypesAuth0RestClient,
-      options.retry
-    );
+    this.factorsPhoneMessageTypes = this._getRestClient('/guardian/factors/phone/message-types');
   }
 
   /**

package/src/management/HooksManager.js

@@ -1,12 +1,11 @@
 const { ArgumentError } = require('rest-facade');
-const Auth0RestClient = require('../Auth0RestClient');
-const RetryRestClient = require('../RetryRestClient');
+const BaseManager = require('./BaseManager');
 
 /**
  * The hooks manager class provides a simple abstraction for performing CRUD operations
  * on Auth0 HooksManagers.
  */
-class HooksManager {
+class HooksManager extends BaseManager {
   /**
    * @param {object} options            The client options.
    * @param {string} options.baseUrl    The URL of the API.
@@ -14,27 +13,7 @@ class HooksManager {
    * @param {object} [options.retry]    Retry Policy Config
    */
   constructor(options) {
-    if (options === null || typeof options !== 'object') {
-      throw new ArgumentError('Must provide manager options');
-    }
-
-    if (options.baseUrl === null || options.baseUrl === undefined) {
-      throw new ArgumentError('Must provide a base URL for the API');
-    }
-
-    if ('string' !== typeof options.baseUrl || options.baseUrl.length === 0) {
-      throw new ArgumentError('The provided base URL is invalid');
-    }
-
-    /**
-     * Options object for the Rest Client instance.
-     *
-     * @type {object}
-     */
-    const clientOptions = {
-      headers: options.headers,
-      query: { repeatParams: false },
-    };
+    super(options);
 
     /**
      * Provides an abstraction layer for performing CRUD operations on
@@ -42,19 +21,9 @@ class HooksManager {
      *
      * @type {external:RestClient}
      */
-    const auth0RestClient = new Auth0RestClient(
-      `${options.baseUrl}/hooks/:id`,
-      clientOptions,
-      options.tokenProvider
-    );
-    this.resource = new RetryRestClient(auth0RestClient, options.retry);
+    this.resource = this._getRestClient('/hooks/:id');
 
-    const hookSecretsClient = new Auth0RestClient(
-      `${options.baseUrl}/hooks/:id/secrets`,
-      clientOptions,
-      options.tokenProvider
-    );
-    this.secrets = new RetryRestClient(hookSecretsClient, options.retry);
+    this.secrets = this._getRestClient('/hooks/:id/secrets');
   }
 
   /**