fix(auth): skip project config name assertion when using the Auth emulator (#3142)

The Auth emulator does not populate the resource `name` field on its
/config responses, so getProjectConfig() and updateProjectConfig() throw
"INTERNAL ASSERT FAILED: Unable to get/update project config" against
the emulator. Skip the assertion in both validators when useEmulator()
is true. Production behavior is unchanged — a backend response missing
`name` still throws.

The guard reuses the existing useEmulator() helper, matching the same
dynamic-read pattern AuthResourceUrlBuilder and AuthHttpClient already
use to branch on the emulator.

Fixes #2461.

Author: kyungseopk1m

src/auth/auth-api-request.ts

@@ -2035,6 +2035,11 @@ export abstract class AbstractAuthRequestHandler {
 /** Instantiates the getConfig endpoint settings. */
 const GET_PROJECT_CONFIG = new ApiSettings('/config', 'GET')
   .setResponseValidator((response: RequestResponse) => {
+    // The Auth emulator does not populate the resource `name` field on the
+    // project config response, so skip the assertion when running against it.
+    if (useEmulator()) {
+      return;
+    }
     const data = response.data;
     // Response should always contain at least the config name.
     if (!validator.isNonEmptyString(data?.name)) {
@@ -2049,6 +2054,11 @@ const GET_PROJECT_CONFIG = new ApiSettings('/config', 'GET')
 /** Instantiates the updateConfig endpoint settings. */
 const UPDATE_PROJECT_CONFIG = new ApiSettings('/config?updateMask={updateMask}', 'PATCH')
   .setResponseValidator((response: RequestResponse) => {
+    // The Auth emulator does not populate the resource `name` field on the
+    // project config response, so skip the assertion when running against it.
+    if (useEmulator()) {
+      return;
+    }
     const data = response.data;
     // Response should always contain at least the config name.
     if (!validator.isNonEmptyString(data?.name)) {

test/unit/auth/auth-api-request.spec.ts

@@ -46,7 +46,7 @@ import { getMetricsHeader, getSdkVersion } from '../../../src/utils/index';
 import {
   UserImportRecord, OIDCAuthProviderConfig, SAMLAuthProviderConfig, OIDCUpdateAuthProviderRequest,
   SAMLUpdateAuthProviderRequest, UserIdentifier, UpdateRequest, UpdateMultiFactorInfoRequest,
-  CreateTenantRequest, UpdateTenantRequest,
+  CreateTenantRequest, UpdateTenantRequest, UpdateProjectConfigRequest,
 } from '../../../src/auth/index';
 
 chai.should();
@@ -4461,6 +4461,131 @@ AUTH_REQUEST_HANDLER_TESTS.forEach((handler) => {
     });
 
     if (handler.supportsTenantManagement) {
+      describe('getProjectConfig', () => {
+        const path = '/v2/projects/project_id/config';
+        const method = 'GET';
+        const expectedResult = utils.responseFrom({
+          name: 'projects/project_id/config',
+        });
+
+        afterEach(() => {
+          delete process.env.FIREBASE_AUTH_EMULATOR_HOST;
+        });
+
+        it('should be fulfilled with the project config response', () => {
+          const stub = sinon.stub(HttpClient.prototype, 'send').resolves(expectedResult);
+          stubs.push(stub);
+
+          const requestHandler = handler.init(mockApp) as AuthRequestHandler;
+          return requestHandler.getProjectConfig()
+            .then((result) => {
+              expect(result).to.deep.equal(expectedResult.data);
+              expect(stub).to.have.been.calledOnce.and.calledWith(callParams(path, method, {}));
+            });
+        });
+
+        it('should be rejected when the response is missing the name field', () => {
+          const stub = sinon.stub(HttpClient.prototype, 'send').resolves(utils.responseFrom({}));
+          stubs.push(stub);
+
+          const requestHandler = handler.init(mockApp) as AuthRequestHandler;
+          return requestHandler.getProjectConfig()
+            .then(() => {
+              throw new Error('Unexpected success');
+            }, (error) => {
+              expect(error).to.have.property('code', 'auth/internal-error');
+              expect(error.message).to.equal('INTERNAL ASSERT FAILED: Unable to get project config');
+            });
+        });
+
+        it('should be fulfilled when the response is missing the name field and the emulator is running', () => {
+          const emulatorHost = 'localhost:9099';
+          process.env.FIREBASE_AUTH_EMULATOR_HOST = emulatorHost;
+          const stub = sinon.stub(HttpClient.prototype, 'send').resolves(utils.responseFrom({}));
+          stubs.push(stub);
+
+          const requestHandler = handler.init(mockApp) as AuthRequestHandler;
+          return requestHandler.getProjectConfig()
+            .then((result) => {
+              expect(result).to.deep.equal({});
+              expect(stub).to.have.been.calledOnce.and.calledWith({
+                method,
+                url: `http://${emulatorHost}/identitytoolkit.googleapis.com${path}`,
+                headers: expectedHeadersEmulator,
+                data: {},
+                timeout,
+              });
+            });
+        });
+      });
+
+      describe('updateProjectConfig', () => {
+        const path = '/v2/projects/project_id/config';
+        const method = 'PATCH';
+        const validRequest: UpdateProjectConfigRequest = {
+          smsRegionConfig: {
+            allowlistOnly: {
+              allowedRegions: ['AC', 'AD'],
+            },
+          },
+        };
+        const expectedPath = path + '?updateMask=smsRegionConfig.allowlistOnly.allowedRegions';
+        const expectedResult = utils.responseFrom({
+          name: 'projects/project_id/config',
+        });
+
+        afterEach(() => {
+          delete process.env.FIREBASE_AUTH_EMULATOR_HOST;
+        });
+
+        it('should be fulfilled with the updated project config response', () => {
+          const stub = sinon.stub(HttpClient.prototype, 'send').resolves(expectedResult);
+          stubs.push(stub);
+
+          const requestHandler = handler.init(mockApp) as AuthRequestHandler;
+          return requestHandler.updateProjectConfig(validRequest)
+            .then((result) => {
+              expect(result).to.deep.equal(expectedResult.data);
+              expect(stub).to.have.been.calledOnce.and.calledWith(
+                callParams(expectedPath, method, validRequest));
+            });
+        });
+
+        it('should be rejected when the response is missing the name field', () => {
+          const stub = sinon.stub(HttpClient.prototype, 'send').resolves(utils.responseFrom({}));
+          stubs.push(stub);
+
+          const requestHandler = handler.init(mockApp) as AuthRequestHandler;
+          return requestHandler.updateProjectConfig(validRequest)
+            .then(() => {
+              throw new Error('Unexpected success');
+            }, (error) => {
+              expect(error).to.have.property('code', 'auth/internal-error');
+              expect(error.message).to.equal('INTERNAL ASSERT FAILED: Unable to update project config');
+            });
+        });
+
+        it('should be fulfilled when the response is missing the name field and the emulator is running', () => {
+          const emulatorHost = 'localhost:9099';
+          process.env.FIREBASE_AUTH_EMULATOR_HOST = emulatorHost;
+          const stub = sinon.stub(HttpClient.prototype, 'send').resolves(utils.responseFrom({}));
+          stubs.push(stub);
+
+          const requestHandler = handler.init(mockApp) as AuthRequestHandler;
+          return requestHandler.updateProjectConfig(validRequest)
+            .then((result) => {
+              expect(result).to.deep.equal({});
+              expect(stub).to.have.been.calledOnce.and.calledWith({
+                method,
+                url: `http://${emulatorHost}/identitytoolkit.googleapis.com${expectedPath}`,
+                headers: expectedHeadersEmulator,
+                data: validRequest,
+                timeout,
+              });
+            });
+        });
+      });
+
       describe('getTenant', () => {
         const path = '/v2/projects/project_id/tenants/tenant-id';
         const method = 'GET';