diff --git a/.version b/.version index 39326cb9..0c8f8801 100644 --- a/.version +++ b/.version @@ -1 +1 @@ -v2.15.0 \ No newline at end of file +v2.15.1 \ No newline at end of file diff --git a/CHANGELOG.md b/CHANGELOG.md index 70612f81..09d2f271 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,11 @@ # Change Log +## [v2.15.1](https://github.com/auth0/auth0-react/tree/v2.15.1) (2026-03-13) +[Full Changelog](https://github.com/auth0/auth0-react/compare/v2.15.0...v2.15.1) + +**Changed** +- chore(deps): update @auth0/auth0-spa-js to version 2.17.1 [\#1045](https://github.com/auth0/auth0-react/pull/1045) ([gyaneshgouraw-okta](https://github.com/gyaneshgouraw-okta)) + ## [v2.15.0](https://github.com/auth0/auth0-react/tree/v2.15.0) (2026-02-17) [Full Changelog](https://github.com/auth0/auth0-react/compare/v2.14.0...v2.15.0) diff --git a/docs/classes/OAuthError.html b/docs/classes/OAuthError.html index e286af6f..aa732719 100644 --- a/docs/classes/OAuthError.html +++ b/docs/classes/OAuthError.html @@ -1,7 +1,7 @@ OAuthError | @auth0/auth0-react
@auth0/auth0-react
    Preparing search index...

    Class OAuthError

    An OAuth2 error will come from the authorization server and will have at least an error property which will be the error code. And possibly an error_description property

    See: https://openid.net/specs/openid-connect-core-1_0.html#rfc.section.3.1.2.6

    -

    Hierarchy

    • Error
      • OAuthError
    Index

    Constructors

    constructor +

    Hierarchy

    • Error
      • OAuthError
    Index

    Constructors

    constructor

    Properties

    error error_description? message @@ -10,7 +10,7 @@ prepareStackTrace? stackTraceLimit

    Methods

    captureStackTrace -

    Constructors

    • Parameters

      • error: string
      • Optionalerror_description: string

      Returns OAuthError

    Properties

    error: string
    error_description?: string
    message: string
    name: string
    stack?: string
    prepareStackTrace?: (err: Error, stackTraces: CallSite[]) => any

    Optional override for formatting stack traces

    +

    Constructors

    • Parameters

      • error: string
      • Optionalerror_description: string

      Returns OAuthError

    Properties

    error: string
    error_description?: string
    message: string
    name: string
    stack?: string
    prepareStackTrace?: (err: Error, stackTraces: CallSite[]) => any

    Optional override for formatting stack traces

    https://v8.dev/docs/stack-trace-api#customizing-stack-traces

    stackTraceLimit: number

    Methods

    • Create .stack property on a target object

      Parameters

      • targetObject: object
      • OptionalconstructorOpt: Function

      Returns void

    Settings

    Member Visibility

    On This Page

    Constructors
    Properties
    Methods
    diff --git a/docs/functions/Auth0Provider.html b/docs/functions/Auth0Provider.html index 7aeeaa56..5d0369c1 100644 --- a/docs/functions/Auth0Provider.html +++ b/docs/functions/Auth0Provider.html @@ -2,4 +2,4 @@

    Provides the Auth0Context to its child components.

    -

    Type Parameters

    Parameters

    Returns Element

    Settings

    Member Visibility
    +

    Type Parameters

    Parameters

    Returns Element

    Settings

    Member Visibility
    diff --git a/docs/functions/useAuth0.html b/docs/functions/useAuth0.html index d7b020fb..3d7063f3 100644 --- a/docs/functions/useAuth0.html +++ b/docs/functions/useAuth0.html @@ -3,4 +3,4 @@

    Use the useAuth0 hook in your components to access the auth state and methods.

    TUser is an optional type param to provide a type to the user field.

    -

    Type Parameters

    Parameters

    Returns Auth0ContextInterface<TUser>

    Settings

    Member Visibility
    +

    Type Parameters

    Parameters

    Returns Auth0ContextInterface<TUser>

    Settings

    Member Visibility
    diff --git a/docs/functions/withAuth0.html b/docs/functions/withAuth0.html index b9e45090..f9099fbc 100644 --- a/docs/functions/withAuth0.html +++ b/docs/functions/withAuth0.html @@ -4,4 +4,4 @@

    Wrap your class components in this Higher Order Component to give them access to the Auth0Context.

    Providing a context as the second argument allows you to configure the Auth0Provider the Auth0Context should come from f you have multiple within your application.

    -

    Type Parameters

    Parameters

    Returns ComponentType<Omit<P, "auth0">>

    Settings

    Member Visibility
    +

    Type Parameters

    Parameters

    Returns ComponentType<Omit<P, "auth0">>

    Settings

    Member Visibility
    diff --git a/docs/functions/withAuthenticationRequired.html b/docs/functions/withAuthenticationRequired.html index 3a0c1ea7..25f8f0c0 100644 --- a/docs/functions/withAuthenticationRequired.html +++ b/docs/functions/withAuthenticationRequired.html @@ -3,4 +3,4 @@

    When you wrap your components in this Higher Order Component and an anonymous user visits your component they will be redirected to the login page; after login they will be returned to the page they were redirected from.

    -

    Type Parameters

    Parameters

    Returns FC<P>

    Settings

    Member Visibility
    +

    Type Parameters

    Parameters

    Returns FC<P>

    Settings

    Member Visibility
    diff --git a/docs/interfaces/Auth0ContextInterface.html b/docs/interfaces/Auth0ContextInterface.html index e2cc528d..3da0a917 100644 --- a/docs/interfaces/Auth0ContextInterface.html +++ b/docs/interfaces/Auth0ContextInterface.html @@ -1,5 +1,5 @@ Auth0ContextInterface | @auth0/auth0-react
    @auth0/auth0-react
      Preparing search index...

      Interface Auth0ContextInterface<TUser>

      Contains the authenticated state and authentication methods provided by the useAuth0 hook.

      -
      interface Auth0ContextInterface<TUser extends User = User> {
          connectAccountWithRedirect: (
              options: RedirectConnectAccountOptions,
          ) => Promise<void>;
          createFetcher: <TOutput extends CustomFetchMinimalOutput = Response>(
              config?: FetcherConfig<TOutput>,
          ) => Fetcher<TOutput>;
          error: Error | undefined;
          exchangeToken: (
              options: CustomTokenExchangeOptions,
          ) => Promise<TokenEndpointResponse>;
          generateDpopProof: (
              params: {
                  accessToken: string;
                  method: string;
                  nonce?: string;
                  url: string;
              },
          ) => Promise<string>;
          getAccessTokenSilently: {
              (
                  options: GetTokenSilentlyOptions & { detailedResponse: true },
              ): Promise<GetTokenSilentlyVerboseResponse>;
              (options?: GetTokenSilentlyOptions): Promise<string>;
              (
                  options: GetTokenSilentlyOptions,
              ): Promise<string | GetTokenSilentlyVerboseResponse>;
          };
          getAccessTokenWithPopup: (
              options?: GetTokenWithPopupOptions,
              config?: PopupConfigOptions,
          ) => Promise<string | undefined>;
          getConfiguration: () => Readonly<ClientConfiguration>;
          getDpopNonce: (id?: string) => Promise<string | undefined>;
          getIdTokenClaims: () => Promise<IdToken | undefined>;
          handleRedirectCallback: (
              url?: string,
          ) => Promise<ConnectAccountRedirectResult | RedirectLoginResult<any>>;
          isAuthenticated: boolean;
          isLoading: boolean;
          loginWithCustomTokenExchange: (
              options: CustomTokenExchangeOptions,
          ) => Promise<TokenEndpointResponse>;
          loginWithPopup: (
              options?: PopupLoginOptions,
              config?: PopupConfigOptions,
          ) => Promise<void>;
          loginWithRedirect: (
              options?: RedirectLoginOptions<AppState>,
          ) => Promise<void>;
          logout: (options?: LogoutOptions) => Promise<void>;
          mfa: MfaApiClient;
          setDpopNonce: (nonce: string, id?: string) => Promise<void>;
          user: TUser | undefined;
      }

      Type Parameters

      Hierarchy

      • AuthState<TUser>
        • Auth0ContextInterface
      Index

      Properties

      connectAccountWithRedirect +
      interface Auth0ContextInterface<TUser extends User = User> {
          connectAccountWithRedirect: (
              options: RedirectConnectAccountOptions,
          ) => Promise<void>;
          createFetcher: <TOutput extends CustomFetchMinimalOutput = Response>(
              config?: FetcherConfig<TOutput>,
          ) => Fetcher<TOutput>;
          error: Error | undefined;
          exchangeToken: (
              options: CustomTokenExchangeOptions,
          ) => Promise<TokenEndpointResponse>;
          generateDpopProof: (
              params: {
                  accessToken: string;
                  method: string;
                  nonce?: string;
                  url: string;
              },
          ) => Promise<string>;
          getAccessTokenSilently: {
              (
                  options: GetTokenSilentlyOptions & { detailedResponse: true },
              ): Promise<GetTokenSilentlyVerboseResponse>;
              (options?: GetTokenSilentlyOptions): Promise<string>;
              (
                  options: GetTokenSilentlyOptions,
              ): Promise<string | GetTokenSilentlyVerboseResponse>;
          };
          getAccessTokenWithPopup: (
              options?: GetTokenWithPopupOptions,
              config?: PopupConfigOptions,
          ) => Promise<string | undefined>;
          getConfiguration: () => Readonly<ClientConfiguration>;
          getDpopNonce: (id?: string) => Promise<string | undefined>;
          getIdTokenClaims: () => Promise<IdToken | undefined>;
          handleRedirectCallback: (
              url?: string,
          ) => Promise<ConnectAccountRedirectResult | RedirectLoginResult<any>>;
          isAuthenticated: boolean;
          isLoading: boolean;
          loginWithCustomTokenExchange: (
              options: CustomTokenExchangeOptions,
          ) => Promise<TokenEndpointResponse>;
          loginWithPopup: (
              options?: PopupLoginOptions,
              config?: PopupConfigOptions,
          ) => Promise<void>;
          loginWithRedirect: (
              options?: RedirectLoginOptions<AppState>,
          ) => Promise<void>;
          logout: (options?: LogoutOptions) => Promise<void>;
          mfa: MfaApiClient;
          setDpopNonce: (nonce: string, id?: string) => Promise<void>;
          user: TUser | undefined;
      }

      Type Parameters

      Hierarchy

      • AuthState<TUser>
        • Auth0ContextInterface
      Index

      Properties

      connectAccountWithRedirect createFetcher error exchangeToken @@ -27,7 +27,7 @@ where the user can authenticate and authorize the account to be connected.

      If connecting the account is successful onRedirectCallback will be called with the details of the connected account.

      -
      createFetcher: <TOutput extends CustomFetchMinimalOutput = Response>(
          config?: FetcherConfig<TOutput>,
      ) => Fetcher<TOutput>

      Returns a new Fetcher class that will contain a fetchWithAuth() method. +

      createFetcher: <TOutput extends CustomFetchMinimalOutput = Response>(
          config?: FetcherConfig<TOutput>,
      ) => Fetcher<TOutput>

      Returns a new Fetcher class that will contain a fetchWithAuth() method. This is a drop-in replacement for the Fetch API's fetch() method, but will handle certain authentication logic for you, like building the proper auth headers or managing DPoP nonces and retries automatically.

      @@ -37,7 +37,7 @@ handle certain authentication logic for you, like building the proper auth headers or managing DPoP nonces and retries automatically.

      Check the EXAMPLES.md file for a deeper look into this method.

      -

      Type Parameters

      • TOutput extends CustomFetchMinimalOutput = Response

      Parameters

      Returns Fetcher<TOutput>

      error: Error | undefined
      exchangeToken: (
          options: CustomTokenExchangeOptions,
      ) => Promise<TokenEndpointResponse>

      Type Declaration

      error: Error | undefined
      exchangeToken: (
          options: CustomTokenExchangeOptions,
      ) => Promise<TokenEndpointResponse>

      Type Declaration

      Use loginWithCustomTokenExchange() instead. This method will be removed in the next major version.

      const tokenResponse = await exchangeToken({
        subject_token: 'external_token_value',
        subject_token_type: 'urn:acme:legacy-system-token',
        scope: 'openid profile email'
      });
@@ -51,13 +51,13 @@
 
      // Instead of:
      const tokens = await exchangeToken(options);

      // Use:
      const tokens = await loginWithCustomTokenExchange(options);
 
      
 
-
      generateDpopProof: (
          params: {
              accessToken: string;
              method: string;
              nonce?: string;
              url: string;
          },
      ) => Promise<string>

      Returns a string to be used to demonstrate possession of the private +

      generateDpopProof: (
          params: {
              accessToken: string;
              method: string;
              nonce?: string;
              url: string;
          },
      ) => Promise<string>

      Returns a string to be used to demonstrate possession of the private key used to cryptographically bind access tokens with DPoP.

      It requires enabling the Auth0ClientOptions.useDpop option.

      Type Declaration

        • (
              params: {
                  accessToken: string;
                  method: string;
                  nonce?: string;
                  url: string;
              },
          ): Promise<string>

        • Returns a string to be used to demonstrate possession of the private key used to cryptographically bind access tokens with DPoP.

          It requires enabling the Auth0ClientOptions.useDpop option.

          -

          Parameters

          • params: { accessToken: string; method: string; nonce?: string; url: string }

          Returns Promise<string>

      getAccessTokenSilently: {
          (
              options: GetTokenSilentlyOptions & { detailedResponse: true },
          ): Promise<GetTokenSilentlyVerboseResponse>;
          (options?: GetTokenSilentlyOptions): Promise<string>;
          (
              options: GetTokenSilentlyOptions,
          ): Promise<string | GetTokenSilentlyVerboseResponse>;
      }
      const token = await getAccessTokenSilently(options);
+

      Parameters

      • params: { accessToken: string; method: string; nonce?: string; url: string }

      Returns Promise<string>

      getAccessTokenSilently: {
          (
              options: GetTokenSilentlyOptions & { detailedResponse: true },
          ): Promise<GetTokenSilentlyVerboseResponse>;
          (options?: GetTokenSilentlyOptions): Promise<string>;
          (
              options: GetTokenSilentlyOptions,
          ): Promise<string | GetTokenSilentlyVerboseResponse>;
      }
      const token = await getAccessTokenSilently(options);

      If there's a valid token stored, return it. Otherwise, opens an @@ -76,7 +76,7 @@ back to using an iframe to make the token exchange.

      Note that in all cases, falling back to an iframe requires access to the auth0 cookie.

      -
      getAccessTokenWithPopup: (
          options?: GetTokenWithPopupOptions,
          config?: PopupConfigOptions,
      ) => Promise<string | undefined>
      const token = await getTokenWithPopup(options, config);
+
      getAccessTokenWithPopup: (
          options?: GetTokenWithPopupOptions,
          config?: PopupConfigOptions,
      ) => Promise<string | undefined>
      const token = await getTokenWithPopup(options, config);

      Get an access token interactively.

      @@ -84,7 +84,7 @@ provided as arguments. Random and secure state and nonce parameters will be auto-generated. If the response is successful, results will be valid according to their expiration times.

      -
      getConfiguration: () => Readonly<ClientConfiguration>
      const config = getConfiguration();
      // { domain: 'tenant.auth0.com', clientId: 'abc123' }
+
      getConfiguration: () => Readonly<ClientConfiguration>
      const config = getConfiguration();
      // { domain: 'tenant.auth0.com', clientId: 'abc123' }

      Returns a readonly copy of the initialization configuration @@ -94,7 +94,7 @@ 

      const auth0 = new Auth0Client({
        domain: 'tenant.auth0.com',
        clientId: 'abc123'
      });

      const config = auth0.getConfiguration();
      // { domain: 'tenant.auth0.com', clientId: 'abc123' }
      -
      getDpopNonce: (id?: string) => Promise<string | undefined>

      Returns the current DPoP nonce used for making requests to Auth0.

      +
      getDpopNonce: (id?: string) => Promise<string | undefined>

      Returns the current DPoP nonce used for making requests to Auth0.

      It can return undefined because when starting fresh it will not be populated until after the first response from the server.

      It requires enabling the Auth0ClientOptions.useDpop option.

      @@ -109,16 +109,16 @@

      The identifier of a nonce: if absent, it will get the nonce used for requests to Auth0. Otherwise, it will be used to select a specific non-Auth0 nonce.

      -
      getIdTokenClaims: () => Promise<IdToken | undefined>
      const claims = await getIdTokenClaims();
+
      getIdTokenClaims: () => Promise<IdToken | undefined>
      const claims = await getIdTokenClaims();

      Returns all claims from the id_token if available.

      -
      handleRedirectCallback: (
          url?: string,
      ) => Promise<ConnectAccountRedirectResult | RedirectLoginResult<any>>

      After the browser redirects back to the callback page, +

      handleRedirectCallback: (
          url?: string,
      ) => Promise<ConnectAccountRedirectResult | RedirectLoginResult<any>>

      After the browser redirects back to the callback page, call handleRedirectCallback to handle success and error responses from Auth0. If the response is successful, results will be valid according to their expiration times.

      Type Declaration

      isAuthenticated: boolean
      isLoading: boolean
      loginWithCustomTokenExchange: (
          options: CustomTokenExchangeOptions,
      ) => Promise<TokenEndpointResponse>
      await loginWithCustomTokenExchange(options);
+

      Returns Promise<ConnectAccountRedirectResult | RedirectLoginResult<any>>

      isAuthenticated: boolean
      isLoading: boolean
      loginWithCustomTokenExchange: (
          options: CustomTokenExchangeOptions,
      ) => Promise<TokenEndpointResponse>
      await loginWithCustomTokenExchange(options);

      Exchanges an external subject token for Auth0 tokens and logs the user in. @@ -142,7 +142,7 @@ 

      const options = {
        subject_token: 'eyJhbGciOiJIUzI1NiIsInR5cCI6Ikp...',
        subject_token_type: 'urn:acme:legacy-system-token',
        scope: 'openid profile email',
        audience: 'https://api.example.com',
        organization: 'org_12345'
      };

      try {
        const tokenResponse = await loginWithCustomTokenExchange(options);
        console.log('Access token:', tokenResponse.access_token);

        // User is now logged in - access user info
        const user = await getUser();
        console.log('Logged in user:', user);
      } catch (error) {
        console.error('Token exchange failed:', error);
      }
      -
      loginWithPopup: (
          options?: PopupLoginOptions,
          config?: PopupConfigOptions,
      ) => Promise<void>
      await loginWithPopup(options, config);
+
      loginWithPopup: (
          options?: PopupLoginOptions,
          config?: PopupConfigOptions,
      ) => Promise<void>
      await loginWithPopup(options, config);

      Opens a popup with the /authorize URL using the parameters @@ -152,20 +152,20 @@

      IMPORTANT: This method has to be called from an event handler that was started by the user like a button click, for example, otherwise the popup will be blocked in most browsers.

      -
      loginWithRedirect: (options?: RedirectLoginOptions<AppState>) => Promise<void>
      await loginWithRedirect(options);
+
      loginWithRedirect: (options?: RedirectLoginOptions<AppState>) => Promise<void>
      await loginWithRedirect(options);

      Performs a redirect to /authorize using the parameters provided as arguments. Random and secure state and nonce parameters will be auto-generated.

      -
      logout: (options?: LogoutOptions) => Promise<void>
      auth0.logout({ logoutParams: { returnTo: window.location.origin } });
+
      logout: (options?: LogoutOptions) => Promise<void>
      auth0.logout({ logoutParams: { returnTo: window.location.origin } });

      Clears the application session and performs a redirect to /v2/logout, using the parameters provided as arguments, to clear the Auth0 session. If the logoutParams.federated option is specified, it also clears the Identity Provider session. Read more about how Logout works at Auth0.

      -
      mfa: MfaApiClient
      const { mfa } = useAuth0();
      const authenticators = await mfa.getAuthenticators(mfaToken);
+
      mfa: MfaApiClient
      const { mfa } = useAuth0();
      const authenticators = await mfa.getAuthenticators(mfaToken);

      MFA API client for Multi-Factor Authentication operations.

      @@ -180,7 +180,7 @@ 
      const { mfa, getAccessTokenSilently } = useAuth0();

      try {
        await getAccessTokenSilently();
      } catch (error) {
        if (error.error === 'mfa_required') {
          // Check if enrollment is needed
          const factors = await mfa.getEnrollmentFactors(error.mfa_token);

          if (factors.length > 0) {
            // Enroll in OTP
            const enrollment = await mfa.enroll({
              mfaToken: error.mfa_token,
              factorType: 'otp'
            });
            console.log('QR Code:', enrollment.barcodeUri);
          }

          // Get authenticators and challenge
          const authenticators = await mfa.getAuthenticators(error.mfa_token);
          await mfa.challenge({
            mfaToken: error.mfa_token,
            challengeType: 'otp',
            authenticatorId: authenticators[0].id
          });

          // Verify with user's code
          const tokens = await mfa.verify({
            mfaToken: error.mfa_token,
            otp: userCode
          });
        }
      }
      -
      setDpopNonce: (nonce: string, id?: string) => Promise<void>

      Sets the current DPoP nonce used for making requests to Auth0.

      +
      setDpopNonce: (nonce: string, id?: string) => Promise<void>

      Sets the current DPoP nonce used for making requests to Auth0.

      It requires enabling the Auth0ClientOptions.useDpop option.

      Type Declaration

      user: TUser | undefined

      Settings

      Member Visibility

      On This Page

      Properties
      +
      user: TUser | undefined

      Settings

      Member Visibility

      On This Page

      Properties
      diff --git a/docs/interfaces/Auth0ProviderOptions.html b/docs/interfaces/Auth0ProviderOptions.html index c026f7e3..5aea9abd 100644 --- a/docs/interfaces/Auth0ProviderOptions.html +++ b/docs/interfaces/Auth0ProviderOptions.html @@ -1,5 +1,5 @@ Auth0ProviderOptions | @auth0/auth0-react
      @auth0/auth0-react
        Preparing search index...

        Interface Auth0ProviderOptions<TUser>

        The main configuration to instantiate the Auth0Provider.

        -
        interface Auth0ProviderOptions<TUser extends User = User> {
            auth0Client?: {
                env?: { [key: string]: string };
                name: string;
                version: string;
            };
            authorizationParams?: ClientAuthorizationParams;
            authorizeTimeoutInSeconds?: number;
            cache?: ICache;
            cacheLocation?: CacheLocation;
            children?: ReactNode;
            clientId: string;
            context?: Context<Auth0ContextInterface<TUser>>;
            cookieDomain?: string;
            domain: string;
            httpTimeoutInSeconds?: number;
            interactiveErrorHandler?: "popup";
            issuer?: string;
            leeway?: number;
            legacySameSiteCookie?: boolean;
            nowProvider?: () => number | Promise<number>;
            onRedirectCallback?: (appState?: AppState, user?: TUser) => void;
            sessionCheckExpiryDays?: number;
            skipRedirectCallback?: boolean;
            useCookiesForTransactions?: boolean;
            useDpop?: boolean;
            useFormData?: boolean;
            useMrrt?: boolean;
            useRefreshTokens?: boolean;
            useRefreshTokensFallback?: boolean;
            workerUrl?: string;
        }

        Type Parameters

        Hierarchy

        • Auth0ClientOptions
          • Auth0ProviderOptions
        Index

        Properties

        auth0Client? +
        interface Auth0ProviderOptions<TUser extends User = User> {
            auth0Client?: {
                env?: { [key: string]: string };
                name: string;
                version: string;
            };
            authorizationParams?: ClientAuthorizationParams;
            authorizeTimeoutInSeconds?: number;
            cache?: ICache;
            cacheLocation?: CacheLocation;
            children?: ReactNode;
            clientId: string;
            context?: Context<Auth0ContextInterface<TUser>>;
            cookieDomain?: string;
            domain: string;
            httpTimeoutInSeconds?: number;
            interactiveErrorHandler?: "popup";
            issuer?: string;
            leeway?: number;
            legacySameSiteCookie?: boolean;
            nowProvider?: () => number | Promise<number>;
            onRedirectCallback?: (appState?: AppState, user?: TUser) => void;
            sessionCheckExpiryDays?: number;
            skipRedirectCallback?: boolean;
            useCookiesForTransactions?: boolean;
            useDpop?: boolean;
            useFormData?: boolean;
            useMrrt?: boolean;
            useRefreshTokens?: boolean;
            useRefreshTokensFallback?: boolean;
            workerUrl?: string;
        }

        Type Parameters

        Hierarchy

        • Auth0ClientOptions
          • Auth0ProviderOptions
        Index

        Properties

        auth0Client? authorizationParams? authorizeTimeoutInSeconds? cache? @@ -35,7 +35,7 @@ The default setting is memory.

        Read more about changing storage options in the Auth0 docs

        children?: ReactNode

        The child nodes your Provider has wrapped

        -
        clientId: string

        The Client ID found on your Application settings page

        +
        clientId: string

        The Client ID found on your Application settings page

        context?: Context<Auth0ContextInterface<TUser>>

        Context to be used when creating the Auth0Provider, defaults to the internally created context.

        This allows multiple Auth0Providers to be nested within the same application, the context value can then be passed to useAuth0, withAuth0, or withAuthenticationRequired to use that specific Auth0Provider to access @@ -49,7 +49,7 @@ used to store data is different

        For a sample on using multiple Auth0Providers review the React Account Linking Sample

        -
        cookieDomain?: string

        The domain the cookie is accessible from. If not set, the cookie is scoped to +

        cookieDomain?: string

        The domain the cookie is accessible from. If not set, the cookie is scoped to the current domain, including the subdomain.

        Note: setting this incorrectly may cause silent authentication to stop working on page load.

        @@ -86,7 +86,7 @@
        onRedirectCallback?: (appState?: AppState, user?: TUser) => void

        By default this removes the code and state parameters from the url when you are redirected from the authorize page. It uses window.history but you might want to overwrite this if you are using a custom router, like react-router-dom See the EXAMPLES.md for more info.

        -
        sessionCheckExpiryDays?: number

        Number of days until the cookie auth0.is.authenticated will expire +

        sessionCheckExpiryDays?: number

        Number of days until the cookie auth0.is.authenticated will expire Defaults to 1.

        skipRedirectCallback?: boolean

        By default, if the page url has code/state params, the SDK will treat them as Auth0's and attempt to exchange the code for a token. In some cases the code might be for something else (another OAuth SDK perhaps). In these @@ -94,7 +94,7 @@ 

        <Auth0Provider
          clientId={clientId}
          domain={domain}
          skipRedirectCallback={window.location.pathname === '/stripe-oauth-callback'}
        >
        -
        useCookiesForTransactions?: boolean

        If true, the SDK will use a cookie when storing information about the auth transaction while +

        useCookiesForTransactions?: boolean

        If true, the SDK will use a cookie when storing information about the auth transaction while the user is going through the authentication flow on the authorization server.

        The default is false, in which case the SDK will use session storage.

        You might want to enable this if you rely on your users being able to authenticate using flows that diff --git a/docs/interfaces/LogoutOptions.html b/docs/interfaces/LogoutOptions.html index 499a4958..d47e8e57 100644 --- a/docs/interfaces/LogoutOptions.html +++ b/docs/interfaces/LogoutOptions.html @@ -1,4 +1,4 @@ -LogoutOptions | @auth0/auth0-react

        @auth0/auth0-react
          Preparing search index...

          Interface LogoutOptions

          interface LogoutOptions {
              clientId?: string | null;
              logoutParams?: {
                  federated?: boolean;
                  returnTo?: string;
                  [key: string]: any;
              };
              openUrl?: false
              | ((url: string) => void | Promise<void>);
          }

          Hierarchy

          • Omit<SPALogoutOptions, "onRedirect">
            • LogoutOptions
          Index

          Properties

          clientId? +LogoutOptions | @auth0/auth0-react
          @auth0/auth0-react
            Preparing search index...

            Interface LogoutOptions

            interface LogoutOptions {
                clientId?: string | null;
                logoutParams?: {
                    federated?: boolean;
                    returnTo?: string;
                    [key: string]: any;
                };
                openUrl?: false
                | ((url: string) => void | Promise<void>);
            }

            Hierarchy

            • Omit<SPALogoutOptions, "onRedirect">
              • LogoutOptions
            Index

            Properties

            clientId? logoutParams? openUrl?

            Properties

            clientId?: string | null

            The clientId of your application.

            diff --git a/docs/interfaces/RedirectLoginOptions.html b/docs/interfaces/RedirectLoginOptions.html index 7bbcd17c..0c373f67 100644 --- a/docs/interfaces/RedirectLoginOptions.html +++ b/docs/interfaces/RedirectLoginOptions.html @@ -1,4 +1,4 @@ -RedirectLoginOptions | @auth0/auth0-react
            @auth0/auth0-react
              Preparing search index...

              Interface RedirectLoginOptions<TAppState>

              interface RedirectLoginOptions<TAppState = AppState> {
                  appState?: TAppState;
                  authorizationParams?: AuthorizationParams;
                  fragment?: string;
                  openUrl?: (url: string) => void | Promise<void>;
              }

              Type Parameters

              Hierarchy

              • Omit<SPARedirectLoginOptions<TAppState>, "onRedirect">
                • RedirectLoginOptions
              Index

              Properties

              appState? +RedirectLoginOptions | @auth0/auth0-react
              @auth0/auth0-react
                Preparing search index...

                Interface RedirectLoginOptions<TAppState>

                interface RedirectLoginOptions<TAppState = AppState> {
                    appState?: TAppState;
                    authorizationParams?: AuthorizationParams;
                    fragment?: string;
                    openUrl?: (url: string) => void | Promise<void>;
                }

                Type Parameters

                Hierarchy

                • Omit<SPARedirectLoginOptions<TAppState>, "onRedirect">
                  • RedirectLoginOptions
                Index

                Properties

                appState? authorizationParams? fragment? openUrl? diff --git a/docs/interfaces/WithAuth0Props.html b/docs/interfaces/WithAuth0Props.html index 7bd3cc97..ede4455c 100644 --- a/docs/interfaces/WithAuth0Props.html +++ b/docs/interfaces/WithAuth0Props.html @@ -1,3 +1,3 @@ WithAuth0Props | @auth0/auth0-react
                @auth0/auth0-react
                  Preparing search index...

                  Interface WithAuth0Props

                  Components wrapped in withAuth0 will have an additional auth0 prop

                  -
                  interface WithAuth0Props {
                      auth0: Auth0ContextInterface;
                  }
                  Index

                  Properties

                  auth0 -

                  Properties

                  auth0: Auth0ContextInterface

                  Settings

                  Member Visibility

                  On This Page

                  Properties
                  +
                  interface WithAuth0Props {
                      auth0: Auth0ContextInterface;
                  }
                  Index

                  Properties

                  auth0 +

                  Properties

                  auth0: Auth0ContextInterface

                  Settings

                  Member Visibility

                  On This Page

                  Properties
                  diff --git a/docs/interfaces/WithAuthenticationRequiredOptions.html b/docs/interfaces/WithAuthenticationRequiredOptions.html index b3cde592..483b4fa4 100644 --- a/docs/interfaces/WithAuthenticationRequiredOptions.html +++ b/docs/interfaces/WithAuthenticationRequiredOptions.html @@ -1,5 +1,5 @@ WithAuthenticationRequiredOptions | @auth0/auth0-react
                  @auth0/auth0-react
                    Preparing search index...

                    Interface WithAuthenticationRequiredOptions

                    Options for the withAuthenticationRequired Higher Order Component

                    -
                    interface WithAuthenticationRequiredOptions {
                        context?: Context<Auth0ContextInterface<User>>;
                        loginOptions?: RedirectLoginOptions<AppState>;
                        onBeforeAuthentication?: () => Promise<void>;
                        onRedirecting?: () => Element;
                        returnTo?: string | (() => string);
                    }
                    Index

                    Properties

                    context? +
                    interface WithAuthenticationRequiredOptions {
                        context?: Context<Auth0ContextInterface<User>>;
                        loginOptions?: RedirectLoginOptions<AppState>;
                        onBeforeAuthentication?: () => Promise<void>;
                        onRedirecting?: () => Element;
                        returnTo?: string | (() => string);
                    }
                    Index

                    Properties

                    context? loginOptions? onBeforeAuthentication? onRedirecting? @@ -7,20 +7,20 @@

                    Properties

                    context?: Context<Auth0ContextInterface<User>>

                    The context to be used when calling useAuth0, this should only be provided if you are using multiple Auth0Providers within your application and you wish to tie a specific component to a Auth0Provider other than the Auth0Provider associated with the default Auth0Context.

                    -
                    loginOptions?: RedirectLoginOptions<AppState>
                    withAuthenticationRequired(Profile, {
                      loginOptions: {
                        appState: {
                          customProp: 'foo'
                        }
                      }
                    })
+
                    loginOptions?: RedirectLoginOptions<AppState>
                    withAuthenticationRequired(Profile, {
                      loginOptions: {
                        appState: {
                          customProp: 'foo'
                        }
                      }
                    })

                    Pass additional login options, like extra appState to the login page. This will be merged with the returnTo option used by the onRedirectCallback handler.

                    -
                    onBeforeAuthentication?: () => Promise<void>
                    withAuthenticationRequired(Profile, {
                      onBeforeAuthentication: () => { analyticsLibrary.track('login_triggered'); }
                    })
+
                    onBeforeAuthentication?: () => Promise<void>
                    withAuthenticationRequired(Profile, {
                      onBeforeAuthentication: () => { analyticsLibrary.track('login_triggered'); }
                    })

                    Allows executing logic before the user is redirected to the login page.

                    -
                    onRedirecting?: () => Element
                    withAuthenticationRequired(Profile, {
                      onRedirecting: () => <div>Redirecting you to the login...</div>
                    })
+
                    onRedirecting?: () => Element
                    withAuthenticationRequired(Profile, {
                      onRedirecting: () => <div>Redirecting you to the login...</div>
                    })

                    Render a message to show that the user is being redirected to the login.

                    -
                    returnTo?: string | (() => string)
                    withAuthenticationRequired(Profile, {
                      returnTo: '/profile'
                    })
+
                    returnTo?: string | (() => string)
                    withAuthenticationRequired(Profile, {
                      returnTo: '/profile'
                    })

                    or

                    @@ -28,4 +28,4 @@

                    Add a path for the onRedirectCallback handler to return the user to after login.

                    -

                    Settings

                    Member Visibility

                    On This Page

                    Properties
                    +

                    Settings

                    Member Visibility

                    On This Page

                    Properties
                    diff --git a/docs/types/AppState.html b/docs/types/AppState.html index ed7002c7..feafe2f7 100644 --- a/docs/types/AppState.html +++ b/docs/types/AppState.html @@ -1,6 +1,6 @@ AppState | @auth0/auth0-react
                    @auth0/auth0-react
                      Preparing search index...

                      Type Alias AppState

                      The state of the application before the user was redirected to the login page and any account that the user may have connected to.

                      -
                      type AppState = {
                          connectedAccount?: ConnectedAccount;
                          response_type?: ResponseType;
                          returnTo?: string;
                          [key: string]: any;
                      }

                      Indexable

                      • [key: string]: any
                      Index

                      Properties

                      connectedAccount? +
                      type AppState = {
                          connectedAccount?: ConnectedAccount;
                          response_type?: ResponseType;
                          returnTo?: string;
                          [key: string]: any;
                      }

                      Indexable

                      • [key: string]: any
                      Index

                      Properties

                      connectedAccount? response_type? returnTo? -

                      Properties

                      connectedAccount?: ConnectedAccount
                      response_type?: ResponseType
                      returnTo?: string

                      Settings

                      Member Visibility

                      On This Page

                      Properties
                      +

                      Properties

                      connectedAccount?: ConnectedAccount
                      response_type?: ResponseType
                      returnTo?: string

                      Settings

                      Member Visibility

                      On This Page

                      Properties
                      diff --git a/docs/types/ConnectedAccount.html b/docs/types/ConnectedAccount.html index 0b51ad5d..d45362b1 100644 --- a/docs/types/ConnectedAccount.html +++ b/docs/types/ConnectedAccount.html @@ -1,2 +1,2 @@ ConnectedAccount | @auth0/auth0-react
                      @auth0/auth0-react
                        Preparing search index...

                        Type Alias ConnectedAccount

                        ConnectedAccount: Omit<
                            ConnectAccountRedirectResult,
                            "appState"
                            | "response_type",
                        >

                        The account that has been connected during the connect flow.

                        -

                        Settings

                        Member Visibility
                        +

                        Settings

                        Member Visibility
                        diff --git a/docs/variables/Auth0Context.html b/docs/variables/Auth0Context.html index 5bd3387a..3209337b 100644 --- a/docs/variables/Auth0Context.html +++ b/docs/variables/Auth0Context.html @@ -1,2 +1,2 @@ Auth0Context | @auth0/auth0-react
                        @auth0/auth0-react
                          Preparing search index...

                          Variable Auth0ContextConst

                          Auth0Context: Context<Auth0ContextInterface<User>> = ...

                          The Auth0 Context

                          -

                          Settings

                          Member Visibility
                          +

                          Settings

                          Member Visibility
                          diff --git a/package-lock.json b/package-lock.json index 1696f8f5..6057b9f8 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "@auth0/auth0-react", - "version": "2.15.0", + "version": "2.15.1", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "@auth0/auth0-react", - "version": "2.15.0", + "version": "2.15.1", "license": "MIT", "dependencies": { "@auth0/auth0-spa-js": "^2.17.1" diff --git a/package.json b/package.json index dd9a1401..8e6a332b 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "author": "Auth0", "name": "@auth0/auth0-react", - "version": "2.15.0", + "version": "2.15.1", "description": "Auth0 SDK for React Single Page Applications (SPA)", "keywords": [ "auth0",