Ci fix after rebasing from main branch (#7085)

* test

* Revert "test"

This reverts commit 474b996.

* format

* lint

* non-browser env

* yarn docgen devsite

* yarn docgen devsite

* Update API reports

---------

Co-authored-by: renkelvin <[email protected]>

Author: renkelvin

common/api-review/auth.api.md

@@ -665,7 +665,7 @@ export function reauthenticateWithPopup(user: User, provider: AuthProvider, reso
 // @public
 export function reauthenticateWithRedirect(user: User, provider: AuthProvider, resolver?: PopupRedirectResolver): Promise<never>;
 
-// @public
+// @public (undocumented)
 export interface RecaptchaConfig {
     emailPasswordEnabled: boolean;
 }

docs-devsite/auth.auth.md

@@ -38,6 +38,7 @@ export interface Auth
 |  Method | Description |
 |  --- | --- |
 |  [beforeAuthStateChanged(callback, onAbort)](./auth.auth.md#authbeforeauthstatechanged) | Adds a blocking callback that runs before an auth state change sets a new user. |
+|  [initializeRecaptchaConfig()](./auth.auth.md#authinitializerecaptchaconfig) | Initializes the reCAPTCHA configuration on the <code>Auth</code> instance. |
 |  [onAuthStateChanged(nextOrObserver, error, completed)](./auth.auth.md#authonauthstatechanged) | Adds an observer for changes to the user's sign-in state. |
 |  [onIdTokenChanged(nextOrObserver, error, completed)](./auth.auth.md#authonidtokenchanged) | Adds an observer for changes to the signed-in user's ID token. |
 |  [setPersistence(persistence)](./auth.auth.md#authsetpersistence) | Changes the type of persistence on the <code>Auth</code> instance. |
@@ -165,6 +166,33 @@ beforeAuthStateChanged(callback: (user: User | null) => void | Promise<void>, on
 
 [Unsubscribe](./util.md#unsubscribe)
 
+## Auth.initializeRecaptchaConfig()
+
+Initializes the reCAPTCHA configuration on the `Auth` instance.
+
+This will initialize reCAPTCHA config of the current Auth session which affects the future auth requests.
+
+The reCAPTCHA config indicates whether the reCAPTCHA verification flow should be triggered for a specific auth provider. Note that this only affect the client auth request but won't override the actual enablement state on the server side.
+
+For example, assume that reCAPTCHA verfication is enabled for Email provider via Cloud console or Admin SDKs. If the enablement is initialized to false via `initializeRecaptchaConfig()`<!-- -->, the auth flow will be started without the reCAPTCHA verfication. This will result in a `reCAPTCHA token missing` error while the SDK will automatically start the auth flow again with the reCAPTCHA verfication flow. Developers can avoid such round trip by enabling the reCAPTCHA flow with this method.
+
+<b>Signature:</b>
+
+```typescript
+initializeRecaptchaConfig(): Promise<void>;
+```
+<b>Returns:</b>
+
+Promise&lt;void&gt;
+
+### Example
+
+
+```javascript
+auth.initializeRecaptchaConfig();
+
+```
+
 ## Auth.onAuthStateChanged()
 
 Adds an observer for changes to the user's sign-in state.

docs-devsite/auth.md

@@ -31,6 +31,7 @@ Firebase Authentication
 |  [fetchSignInMethodsForEmail(auth, email)](./auth.md#fetchsigninmethodsforemail) | Gets the list of possible sign in methods for the given email address. |
 |  [getMultiFactorResolver(auth, error)](./auth.md#getmultifactorresolver) | Provides a [MultiFactorResolver](./auth.multifactorresolver.md#multifactorresolver_interface) suitable for completion of a multi-factor flow. |
 |  [getRedirectResult(auth, resolver)](./auth.md#getredirectresult) | Returns a [UserCredential](./auth.usercredential.md#usercredential_interface) from the redirect-based sign-in flow. |
+|  [initializeRecaptchaConfig(auth)](./auth.md#initializerecaptchaconfig) | Initializes the reCAPTCHA configuration on the <code>Auth</code> instance. |
 |  [isSignInWithEmailLink(auth, emailLink)](./auth.md#issigninwithemaillink) | Checks if an incoming link is a sign-in with email link suitable for [signInWithEmailLink()](./auth.md#signinwithemaillink)<!-- -->. |
 |  [onAuthStateChanged(auth, nextOrObserver, error, completed)](./auth.md#onauthstatechanged) | Adds an observer for changes to the user's sign-in state. |
 |  [onIdTokenChanged(auth, nextOrObserver, error, completed)](./auth.md#onidtokenchanged) | Adds an observer for changes to the signed-in user's ID token. |
@@ -129,6 +130,7 @@ Firebase Authentication
 |  [PhoneSingleFactorInfoOptions](./auth.phonesinglefactorinfooptions.md#phonesinglefactorinfooptions_interface) | Options used for single-factor sign-in. |
 |  [PopupRedirectResolver](./auth.popupredirectresolver.md#popupredirectresolver_interface) | A resolver used for handling DOM specific operations like [signInWithPopup()](./auth.md#signinwithpopup) or [signInWithRedirect()](./auth.md#signinwithredirect)<!-- -->. |
 |  [ReactNativeAsyncStorage](./auth.reactnativeasyncstorage.md#reactnativeasyncstorage_interface) | Interface for a supplied <code>AsyncStorage</code>. |
+|  [RecaptchaConfig](./auth.recaptchaconfig.md#recaptchaconfig_interface) |  |
 |  [RecaptchaParameters](./auth.recaptchaparameters.md#recaptchaparameters_interface) | Interface representing reCAPTCHA parameters.<!-- -->See the \[reCAPTCHA docs\](https://developers.google.com/recaptcha/docs/display\#render\_param) for the list of accepted parameters. All parameters are accepted except for <code>sitekey</code>: Firebase Auth provisions a reCAPTCHA for each project and will configure the site key upon rendering.<!-- -->For an invisible reCAPTCHA, set the <code>size</code> key to <code>invisible</code>. |
 |  [User](./auth.user.md#user_interface) | A user account. |
 |  [UserCredential](./auth.usercredential.md#usercredential_interface) | A structure containing a [User](./auth.user.md#user_interface)<!-- -->, the [OperationType](./auth.md#operationtype)<!-- -->, and the provider ID. |
@@ -482,6 +484,36 @@ const operationType = result.operationType;
 
 ```
 
+## initializeRecaptchaConfig()
+
+Initializes the reCAPTCHA configuration on the `Auth` instance.
+
+This will pull the reCAPTCHA config to the current Auth session and affect future auth requests, which indicates whether the reCAPTCHA verification flow should be triggered for a specific auth provider. If initializeRecaptchaConfig() is not invoked, the auth flow will start without reCAPTCHA verification. But if reCAPTCHA verification is required, the reCAPTCHA config will be automatically pulled internally and the flows will restart. Thus, calling this optional method will reduce the latency of auth flows.
+
+<b>Signature:</b>
+
+```typescript
+export declare function initializeRecaptchaConfig(auth: Auth): Promise<void>;
+```
+
+### Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  auth | [Auth](./auth.auth.md#auth_interface) | The [Auth](./auth.auth.md#auth_interface) instance. |
+
+<b>Returns:</b>
+
+Promise&lt;void&gt;
+
+### Example
+
+
+```javascript
+initializeRecaptchaConfig(auth);
+
+```
+
 ## isSignInWithEmailLink()
 
 Checks if an incoming link is a sign-in with email link suitable for [signInWithEmailLink()](./auth.md#signinwithemaillink)<!-- -->.
@@ -1791,6 +1823,8 @@ AUTH_ERROR_CODES_MAP_DO_NOT_USE_INTERNALLY: {
     readonly WEAK_PASSWORD: "auth/weak-password";
     readonly WEB_STORAGE_UNSUPPORTED: "auth/web-storage-unsupported";
     readonly ALREADY_INITIALIZED: "auth/already-initialized";
+    readonly RECAPTCHA_CHECK_FAILED: "auth/recaptcha-check-failed";
+    readonly RECAPTCHA_NOT_ENABLED: "auth/recaptcha-not-enabled";
 }
 ```
 

docs-devsite/auth.recaptchaconfig.md

@@ -0,0 +1,34 @@
+Project: /docs/reference/js/_project.yaml
+Book: /docs/reference/_book.yaml
+page_type: reference
+
+{% comment %}
+DO NOT EDIT THIS FILE!
+This is generated by the JS SDK team, and any local changes will be
+overwritten. Changes should be made in the source code at
+https://github.com/firebase/firebase-js-sdk
+{% endcomment %}
+
+# RecaptchaConfig interface
+
+<b>Signature:</b>
+
+```typescript
+export interface RecaptchaConfig 
+```
+
+## Properties
+
+|  Property | Type | Description |
+|  --- | --- | --- |
+|  [emailPasswordEnabled](./auth.recaptchaconfig.md#recaptchaconfigemailpasswordenabled) | boolean | The reCAPTCHA enablement status of the [EmailAuthProvider](./auth.emailauthprovider.md#emailauthprovider_class) for the current tenant. |
+
+## RecaptchaConfig.emailPasswordEnabled
+
+The reCAPTCHA enablement status of the [EmailAuthProvider](./auth.emailauthprovider.md#emailauthprovider_class) for the current tenant.
+
+<b>Signature:</b>
+
+```typescript
+emailPasswordEnabled: boolean;
+```

packages/auth/demo/src/index.js

@@ -473,7 +473,7 @@ function onSignInAnonymously() {
 function onSetTenantID(_event) {
   const tenantId = $('#tenant-id').val();
   auth.tenantId = tenantId;
-  if (tenantId === "") {
+  if (tenantId === '') {
     auth.tenantId = null;
   }
 }

packages/auth/src/api/authentication/email_and_password.test.ts

@@ -21,7 +21,12 @@ import chaiAsPromised from 'chai-as-promised';
 import { ActionCodeOperation } from '../../model/public_types';
 import { FirebaseError } from '@firebase/util';
 
-import { Endpoint, HttpHeader, RecaptchaClientType, RecaptchaVersion } from '../';
+import {
+  Endpoint,
+  HttpHeader,
+  RecaptchaClientType,
+  RecaptchaVersion
+} from '../';
 import { mockEndpoint } from '../../../test/helpers/api/helper';
 import { testAuth, TestAuth } from '../../../test/helpers/mock_auth';
 import * as mockFetch from '../../../test/helpers/mock_fetch';
@@ -47,7 +52,7 @@ describe('api/authentication/signInWithPassword', () => {
     password: 'my-password',
     captchaResponse: 'recaptcha-token',
     clientType: RecaptchaClientType.WEB,
-    recaptchaVersion: RecaptchaVersion.ENTERPRISE,
+    recaptchaVersion: RecaptchaVersion.ENTERPRISE
   };
 
   let auth: TestAuth;
@@ -168,8 +173,8 @@ describe('api/authentication/sendPasswordResetEmail', () => {
     email: '[email protected]',
     captchaResp: 'recaptcha-token',
     clientType: RecaptchaClientType.WEB,
-    recaptchaVersion: RecaptchaVersion.ENTERPRISE,
-};
+    recaptchaVersion: RecaptchaVersion.ENTERPRISE
+  };
 
   let auth: TestAuth;
 
@@ -229,7 +234,7 @@ describe('api/authentication/sendSignInLinkToEmail', () => {
     email: '[email protected]',
     captchaResp: 'recaptcha-token',
     clientType: RecaptchaClientType.WEB,
-    recaptchaVersion: RecaptchaVersion.ENTERPRISE,
+    recaptchaVersion: RecaptchaVersion.ENTERPRISE
   };
 
   let auth: TestAuth;

packages/auth/src/api/authentication/recaptcha.test.ts

@@ -20,12 +20,20 @@ import chaiAsPromised from 'chai-as-promised';
 
 import { FirebaseError } from '@firebase/util';
 
-import { Endpoint, HttpHeader, RecaptchaClientType, RecaptchaVersion } from '../';
-import { mockEndpoint, mockEndpointWithParams } from '../../../test/helpers/api/helper';
+import {
+  Endpoint,
+  HttpHeader,
+  RecaptchaClientType,
+  RecaptchaVersion
+} from '../';
+import {
+  mockEndpoint,
+  mockEndpointWithParams
+} from '../../../test/helpers/api/helper';
 import { testAuth, TestAuth } from '../../../test/helpers/mock_auth';
 import * as mockFetch from '../../../test/helpers/mock_fetch';
 import { ServerError } from '../errors';
-import { getRecaptchaParams, getRecaptchaConfig,  } from './recaptcha';
+import { getRecaptchaParams, getRecaptchaConfig } from './recaptcha';
 
 use(chaiAsPromised);
 
@@ -84,7 +92,7 @@ describe('api/authentication/getRecaptchaParams', () => {
 describe('api/authentication/getRecaptchaConfig', () => {
   const request = {
     clientType: RecaptchaClientType.WEB,
-    recaptchaVersion: RecaptchaVersion.ENTERPRISE,
+    recaptchaVersion: RecaptchaVersion.ENTERPRISE
   };
 
   let auth: TestAuth;
@@ -97,9 +105,13 @@ describe('api/authentication/getRecaptchaConfig', () => {
   afterEach(mockFetch.tearDown);
 
   it('should GET to the correct endpoint', async () => {
-    const mock = mockEndpointWithParams(Endpoint.GET_RECAPTCHA_CONFIG, request, {
-      recaptchaKey: 'site-key'
-    });
+    const mock = mockEndpointWithParams(
+      Endpoint.GET_RECAPTCHA_CONFIG,
+      request,
+      {
+        recaptchaKey: 'site-key'
+      }
+    );
 
     const response = await getRecaptchaConfig(auth, request);
     expect(response.recaptchaKey).to.eq('site-key');
@@ -119,7 +131,7 @@ describe('api/authentication/getRecaptchaConfig', () => {
       {
         error: {
           code: 400,
-          message: ServerError.UNAUTHORIZED_DOMAIN,
+          message: ServerError.UNAUTHORIZED_DOMAIN
         }
       },
       400
@@ -130,4 +142,4 @@ describe('api/authentication/getRecaptchaConfig', () => {
       'auth/unauthorized-continue-uri'
     );
   });
-});
+});

packages/auth/src/api/authentication/recaptcha.ts

@@ -15,7 +15,14 @@
  * limitations under the License.
  */
 
-import { Endpoint, HttpMethod, RecaptchaClientType, RecaptchaVersion, _performApiRequest, _addTidIfNecessary } from '../index';
+import {
+  Endpoint,
+  HttpMethod,
+  RecaptchaClientType,
+  RecaptchaVersion,
+  _performApiRequest,
+  _addTidIfNecessary
+} from '../index';
 import { Auth, RecaptchaConfig } from '../../model/public_types';
 
 interface GetRecaptchaParamResponse {
@@ -42,13 +49,17 @@ interface GetRecaptchaConfigRequest {
 
 interface GetRecaptchaConfigResponse {
   recaptchaKey?: string;
-  recaptchaConfig?: RecaptchaConfig
+  recaptchaConfig?: RecaptchaConfig;
 }
 
-export async function getRecaptchaConfig(auth: Auth,
+export async function getRecaptchaConfig(
+  auth: Auth,
   request: GetRecaptchaConfigRequest
 ): Promise<GetRecaptchaConfigResponse> {
-  return _performApiRequest<GetRecaptchaConfigRequest, GetRecaptchaConfigResponse>(
+  return _performApiRequest<
+    GetRecaptchaConfigRequest,
+    GetRecaptchaConfigResponse
+  >(
     auth,
     HttpMethod.GET,
     Endpoint.GET_RECAPTCHA_CONFIG,

packages/auth/src/api/authentication/sign_up.test.ts

@@ -20,7 +20,12 @@ import chaiAsPromised from 'chai-as-promised';
 
 import { FirebaseError } from '@firebase/util';
 
-import { Endpoint, HttpHeader, RecaptchaClientType, RecaptchaVersion } from '../';
+import {
+  Endpoint,
+  HttpHeader,
+  RecaptchaClientType,
+  RecaptchaVersion
+} from '../';
 import { mockEndpoint } from '../../../test/helpers/api/helper';
 import { testAuth, TestAuth } from '../../../test/helpers/mock_auth';
 import * as mockFetch from '../../../test/helpers/mock_fetch';
@@ -36,8 +41,8 @@ describe('api/authentication/signUp', () => {
     password: 'my-password',
     captchaResponse: 'recaptcha-token',
     clientType: RecaptchaClientType.WEB,
-    recaptchaVersion: RecaptchaVersion.ENTERPRISE,
-};
+    recaptchaVersion: RecaptchaVersion.ENTERPRISE
+  };
 
   let auth: TestAuth;
 

packages/auth/src/api/index.ts

@@ -66,23 +66,23 @@ export const enum Endpoint {
   FINALIZE_MFA_SIGN_IN = '/v2/accounts/mfaSignIn:finalize',
   WITHDRAW_MFA = '/v2/accounts/mfaEnrollment:withdraw',
   GET_PROJECT_CONFIG = '/v1/projects',
-  GET_RECAPTCHA_CONFIG = '/v2/recaptchaConfig',
+  GET_RECAPTCHA_CONFIG = '/v2/recaptchaConfig'
 }
 
 export const enum RecaptchaClientType {
   WEB = 'CLIENT_TYPE_WEB',
   ANDROID = 'CLIENT_TYPE_ANDROID',
-  IOS = 'CLIENT_TYPE_IOS',
+  IOS = 'CLIENT_TYPE_IOS'
 }
 
 export const enum RecaptchaVersion {
-  ENTERPRISE = 'RECAPTCHA_ENTERPRISE',
+  ENTERPRISE = 'RECAPTCHA_ENTERPRISE'
 }
 
 export const enum RecaptchaActionName {
   SIGN_IN_WITH_PASSWORD = 'signInWithPassword',
   GET_OOB_CODE = 'getOobCode',
-  SIGN_UP_PASSWORD = 'signUpPassword',
+  SIGN_UP_PASSWORD = 'signUpPassword'
 }
 
 export const DEFAULT_API_TIMEOUT_MS = new Delay(30_000, 60_000);