firebase-tools 14.11.0 → 14.11.1

package/lib/apptesting/ensureProjectConfigured.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureProjectConfigured = void 0;
+const resourceManager_1 = require("../gcp/resourceManager");
+const ensureApiEnabled_1 = require("../ensureApiEnabled");
+const api_1 = require("../api");
+const utils_1 = require("../utils");
+const error_1 = require("../error");
+const iam = require("../gcp/iam");
+const prompt_1 = require("../prompt");
+const TEST_RUNNER_ROLE = "roles/firebaseapptesting.testRunner";
+const TEST_RUNNER_SERVICE_ACCOUNT_NAME = "firebaseapptesting-test-runner";
+async function ensureProjectConfigured(projectId) {
+    await (0, ensureApiEnabled_1.ensure)(projectId, (0, api_1.appTestingOrigin)(), "storage", false);
+    await (0, ensureApiEnabled_1.ensure)(projectId, (0, api_1.appTestingOrigin)(), "run", false);
+    await (0, ensureApiEnabled_1.ensure)(projectId, (0, api_1.appTestingOrigin)(), "artifactregistry", false);
+    const serviceAccount = runnerServiceAccount(projectId);
+    const serviceAccountExistsAndIsRunner = await (0, resourceManager_1.serviceAccountHasRoles)(projectId, serviceAccount, [TEST_RUNNER_ROLE], true);
+    if (!serviceAccountExistsAndIsRunner) {
+        const grant = await (0, prompt_1.confirm)(`Firebase App Testing runs tests in Cloud Run using a service account, provision an account, "${serviceAccount}", with the role "${TEST_RUNNER_ROLE}"?`);
+        if (!grant) {
+            (0, utils_1.logBullet)("You, or your project administrator, should run the following command to grant the required role:\n\n" +
+                `\tgcloud projects add-iam-policy-binding ${projectId} \\\n` +
+                `\t  --member="serviceAccount:${serviceAccount}" \\\n` +
+                `\t  --role="${TEST_RUNNER_ROLE}"\n`);
+            throw new error_1.FirebaseError(`Firebase App Testing requires a service account named "${serviceAccount}" with the "${TEST_RUNNER_ROLE}" role to execute tests using Cloud Run`);
+        }
+        await provisionServiceAccount(projectId, serviceAccount);
+    }
+}
+exports.ensureProjectConfigured = ensureProjectConfigured;
+async function provisionServiceAccount(projectId, serviceAccount) {
+    try {
+        await iam.createServiceAccount(projectId, TEST_RUNNER_SERVICE_ACCOUNT_NAME, "Service Account used in Cloud Run, responsible for running tests", "Firebase App Testing Test Runner");
+    }
+    catch (err) {
+        if ((0, error_1.getErrStatus)(err) !== 409) {
+            throw err;
+        }
+    }
+    try {
+        await (0, resourceManager_1.addServiceAccountToRoles)(projectId, serviceAccount, [TEST_RUNNER_ROLE], true);
+    }
+    catch (err) {
+        if ((0, error_1.getErrStatus)(err) === 400) {
+            (0, utils_1.logWarning)(`Your App Testing runner service account, "${serviceAccount}", is still being provisioned in the background. If you encounter an error, please try again after a few moments.`);
+        }
+        else {
+            throw err;
+        }
+    }
+}
+function runnerServiceAccount(projectId) {
+    return `${TEST_RUNNER_SERVICE_ACCOUNT_NAME}@${projectId}.iam.gserviceaccount.com`;
+}

package/lib/commands/functions-config-clone.js

@@ -10,6 +10,7 @@ const requirePermissions_1 = require("../requirePermissions");
 const functionsConfig = require("../functionsConfig");
 const functionsConfigClone_1 = require("../functionsConfigClone");
 const utils = require("../utils");
+const deprecationWarnings_1 = require("../functions/deprecationWarnings");
 exports.command = new command_1.Command("functions:config:clone")
     .description("clone environment config from another project")
     .option("--from <projectId>", "the project from which to clone configuration")
@@ -50,4 +51,5 @@ exports.command = new command_1.Command("functions:config:clone")
     await (0, functionsConfigClone_1.functionsConfigClone)(options.from, projectId, only, except);
     utils.logSuccess(`Cloned functions config from ${clc.bold(options.from)} into ${clc.bold(projectId)}`);
     logger_1.logger.info(`\nPlease deploy your functions for the change to take effect by running ${clc.bold("firebase deploy --only functions")}\n`);
+    (0, deprecationWarnings_1.logFunctionsConfigDeprecationWarning)();
 });

package/lib/commands/functions-config-get.js

@@ -8,6 +8,7 @@ const logger_1 = require("../logger");
 const projectUtils_1 = require("../projectUtils");
 const requirePermissions_1 = require("../requirePermissions");
 const functionsConfig = require("../functionsConfig");
+const deprecationWarnings_1 = require("../functions/deprecationWarnings");
 async function materialize(projectId, path) {
     if (path === undefined) {
         return functionsConfig.materializeAll(projectId);
@@ -31,5 +32,6 @@ exports.command = new command_1.Command("functions:config:get [path]")
     .action(async (path, options) => {
     const result = await materialize((0, projectUtils_1.needProjectId)(options), path);
     logger_1.logger.info(JSON.stringify(result, null, 2));
+    (0, deprecationWarnings_1.logFunctionsConfigDeprecationWarning)();
     return result;
 });

package/lib/commands/functions-config-set.js

@@ -9,6 +9,7 @@ const projectUtils_1 = require("../projectUtils");
 const requirePermissions_1 = require("../requirePermissions");
 const functionsConfig = require("../functionsConfig");
 const utils = require("../utils");
+const deprecationWarnings_1 = require("../functions/deprecationWarnings");
 exports.command = new command_1.Command("functions:config:set [values...]")
     .description("set environment config with key=value syntax")
     .before(requirePermissions_1.requirePermissions, [
@@ -40,4 +41,5 @@ exports.command = new command_1.Command("functions:config:set [values...]")
     await Promise.all(promises);
     utils.logSuccess("Functions config updated.");
     logger_1.logger.info(`\nPlease deploy your functions for the change to take effect by running ${clc.bold("firebase deploy --only functions")}\n`);
+    (0, deprecationWarnings_1.logFunctionsConfigDeprecationWarning)();
 });

package/lib/commands/functions-config-unset.js

@@ -10,6 +10,7 @@ const functionsConfig = require("../functionsConfig");
 const runtimeconfig = require("../gcp/runtimeconfig");
 const utils = require("../utils");
 const error_1 = require("../error");
+const deprecationWarnings_1 = require("../functions/deprecationWarnings");
 exports.command = new command_1.Command("functions:config:unset [keys...]")
     .description("unset environment config at the specified path(s)")
     .before(requirePermissions_1.requirePermissions, [
@@ -39,4 +40,5 @@ exports.command = new command_1.Command("functions:config:unset [keys...]")
     }));
     utils.logSuccess("Environment updated.");
     logger_1.logger.info(`\nPlease deploy your functions for the change to take effect by running ${clc.bold("firebase deploy --only functions")}\n`);
+    (0, deprecationWarnings_1.logFunctionsConfigDeprecationWarning)();
 });

package/lib/commands/init.js

@@ -102,7 +102,7 @@ if ((0, experiments_1.isEnabled)("genkit")) {
 if ((0, experiments_1.isEnabled)("apptesting")) {
     choices.push({
         value: "apptesting",
-        name: "App Testing: create a smoke test",
+        name: "App Testing: create a smoke test, enable Cloud APIs (storage, run, & artifactregistry), and add a service account.",
         checked: false,
     });
 }

package/lib/deploy/functions/prepare.js

@@ -53,7 +53,9 @@ async function prepare(context, options, payload) {
     context.firebaseConfig = firebaseConfig;
     let runtimeConfig = { firebase: firebaseConfig };
     if (checkAPIsEnabled[1]) {
-        runtimeConfig = Object.assign(Object.assign({}, runtimeConfig), (await (0, prepareFunctionsUpload_1.getFunctionsConfig)(projectId)));
+        const config = await (0, prepareFunctionsUpload_1.getFunctionsConfig)(projectId);
+        runtimeConfig = Object.assign(Object.assign({}, runtimeConfig), config);
+        context.hasRuntimeConfig = Object.keys(config).length > 0;
     }
     context.codebaseDeployEvents = {};
     const wantBuilds = await loadCodebases(context.config, options, firebaseConfig, runtimeConfig, context.filters);

package/lib/deploy/functions/prepareFunctionsUpload.js

@@ -13,6 +13,7 @@ const hash_1 = require("./cache/hash");
 const functionsConfig = require("../../functionsConfig");
 const utils = require("../../utils");
 const fsAsync = require("../../fsAsync");
+const deprecationWarnings_1 = require("../../functions/deprecationWarnings");
 const CONFIG_DEST_FILE = ".runtimeconfig.json";
 async function getFunctionsConfig(projectId) {
     var _a, _b;
@@ -73,6 +74,7 @@ async function packageSource(sourceDir, config, runtimeConfig) {
                 name: CONFIG_DEST_FILE,
                 mode: 420,
             });
+            (0, deprecationWarnings_1.logFunctionsConfigDeprecationWarning)();
         }
         await pipeAsync(archive, fileStream);
     }

package/lib/deploy/functions/release/reporter.js

@@ -81,6 +81,7 @@ async function logAndTrackDeployStats(summary, context) {
         fn_deploy_num_successes: totalSuccesses,
         fn_deploy_num_canceled: totalAborts,
         fn_deploy_num_failures: totalErrors,
+        has_runtime_config: String(!!(context === null || context === void 0 ? void 0 : context.hasRuntimeConfig)),
     };
     reports.push((0, track_1.trackGA4)("function_deploy_group", fnDeployGroupEvent));
     const avgTime = totalTime / (totalSuccesses + totalErrors);

package/lib/emulator/downloadableEmulatorInfo.json

@@ -54,28 +54,28 @@
     },
     "dataconnect": {
         "darwin": {
-            "version": "2.10.0",
-            "expectedSize": 29332320,
-            "expectedChecksum": "8e1f4303580e91017d449a091f987caa",
-            "expectedChecksumSHA256": "000356e1a93a8eb55ff6ba5e268b5dd4c0638636708e95874a74b859aa977cb3",
-            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-macos-v2.10.0",
-            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.10.0"
+            "version": "2.10.1",
+            "expectedSize": 29336416,
+            "expectedChecksum": "328ae0a354505430f1c162edf37da776",
+            "expectedChecksumSHA256": "ede5dc299045151f228b2adc346f47ad5d3ee10c3c9d7528df5fc0f0c6d70808",
+            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-macos-v2.10.1",
+            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.10.1"
         },
         "win32": {
-            "version": "2.10.0",
-            "expectedSize": 29824000,
-            "expectedChecksum": "ea880276edee4908c4a6def6b1c7e2c1",
-            "expectedChecksumSHA256": "99ab61eba3de0cf14ef4ed5597f54e81ea8383b6782beba4b9b3f884acae4629",
-            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-windows-v2.10.0",
-            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.10.0.exe"
+            "version": "2.10.1",
+            "expectedSize": 29829632,
+            "expectedChecksum": "82e82e35c1728a214db37967dba751e7",
+            "expectedChecksumSHA256": "ba509e921c692ac60c1138b5b9c83a23b4e11feb339f08df5f1cfced44cffc91",
+            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-windows-v2.10.1",
+            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.10.1.exe"
         },
         "linux": {
-            "version": "2.10.0",
-            "expectedSize": 29257912,
-            "expectedChecksum": "fa64e70507e70b8d8063ca0993a3b07a",
-            "expectedChecksumSHA256": "76880201ff7204c32cbbaa2c0cbf6a30528486eb1f2948064dcd218bceaab65e",
-            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-linux-v2.10.0",
-            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.10.0"
+            "version": "2.10.1",
+            "expectedSize": 29266104,
+            "expectedChecksum": "d183c2335e16f8c568bdc9e782dcd240",
+            "expectedChecksumSHA256": "338e0cce561d29993737b91abfe7fc12c7d82d014ef114348ccdafeb3b7be3ae",
+            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-linux-v2.10.1",
+            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.10.1"
         }
     }
 }

package/lib/env.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isFirebaseMcp = exports.isFirebaseStudio = void 0;
+const fsutils_1 = require("./fsutils");
+let googleIdxFolderExists;
+function isFirebaseStudio() {
+    if (googleIdxFolderExists === true || process.env.MONOSPACE_ENV)
+        return true;
+    if (googleIdxFolderExists === false)
+        return false;
+    googleIdxFolderExists = (0, fsutils_1.dirExistsSync)("/google/idx");
+    return googleIdxFolderExists;
+}
+exports.isFirebaseStudio = isFirebaseStudio;
+function isFirebaseMcp() {
+    return !!process.env.IS_FIREBASE_MCP;
+}
+exports.isFirebaseMcp = isFirebaseMcp;

package/lib/experiments.js

@@ -41,6 +41,13 @@ exports.ALL_EXPERIMENTS = experiments({
             "of how that image was created.",
         public: true,
     },
+    dangerouslyAllowFunctionsConfig: {
+        shortDescription: "Allows the use of deprecated functions.config() API",
+        fullDescription: "The functions.config() API is deprecated and will be removed on December 31, 2025. " +
+            "This experiment allows continued use of the API during the migration period.",
+        default: true,
+        public: true,
+    },
     emulatoruisnapshot: {
         shortDescription: "Load pre-release versions of the emulator UI",
     },

package/lib/firestore/api.js

@@ -18,6 +18,20 @@ class FirestoreApi {
         this.apiClient = new apiv2_1.Client({ urlPrefix: (0, api_1.firestoreOrigin)(), apiVersion: "v1" });
         this.printer = new pretty_print_1.PrettyPrint();
     }
+    static processIndexes(indexes) {
+        return indexes.map((index) => {
+            var _a, _b, _c;
+            let fields = index.fields;
+            const lastField = (_a = index.fields) === null || _a === void 0 ? void 0 : _a[index.fields.length - 1];
+            if ((lastField === null || lastField === void 0 ? void 0 : lastField.fieldPath) === "__name__") {
+                const defaultDirection = (_c = (_b = index.fields) === null || _b === void 0 ? void 0 : _b[index.fields.length - 2]) === null || _c === void 0 ? void 0 : _c.order;
+                if ((lastField === null || lastField === void 0 ? void 0 : lastField.order) === defaultDirection) {
+                    fields = fields.slice(0, -1);
+                }
+            }
+            return Object.assign(Object.assign({}, index), { fields });
+        });
+    }
     async deploy(options, indexes, fieldOverrides, databaseId = "(default)") {
         const spec = this.upgradeOldSpec({
             indexes,
@@ -126,7 +140,7 @@ class FirestoreApi {
         if (!indexes) {
             return [];
         }
-        return indexes;
+        return FirestoreApi.processIndexes(indexes);
     }
     async listFieldOverrides(project, databaseId = "(default)") {
         const parent = `projects/${project}/databases/${databaseId}/collectionGroups/-`;

package/lib/functions/deprecationWarnings.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logFunctionsConfigDeprecationWarning = void 0;
+const utils_1 = require("../utils");
+const FUNCTIONS_CONFIG_DEPRECATION_MESSAGE = `DEPRECATION NOTICE: Action required to deploy after Dec 31, 2025
+  
+  functions.config() API is deprecated.
+  Cloud Runtime Configuration API, the Google Cloud service used to store function configuration data, will be shut down on December 31, 2025. As a result, you must migrate away from using functions.config() to continue deploying your functions after December 31, 2025.
+  
+  What this means for you:
+  
+  - The Firebase CLI commands for managing this configuration (functions:config:set, get, unset, clone, and export) are deprecated. These commands no longer work after December 31, 2025.
+  - firebase deploy command will fail for functions that use the legacy functions.config() API after December 31, 2025.
+  
+  Existing deployments will continue to work with their current configuration.
+  
+  See your migration options at: https://firebase.google.com/docs/functions/config-env#migrate-to-dotenv`;
+function logFunctionsConfigDeprecationWarning() {
+    (0, utils_1.logWarningToStderr)(FUNCTIONS_CONFIG_DEPRECATION_MESSAGE);
+}
+exports.logFunctionsConfigDeprecationWarning = logFunctionsConfigDeprecationWarning;

package/lib/init/features/aitools/promptUpdater.js

@@ -7,7 +7,9 @@ const path = require("path");
 const prompt_1 = require("../../../prompt");
 const utils = require("../../../utils");
 const logger_1 = require("../../../logger");
-const PROMPTS_DIR = path.join(__dirname, "../../../../prompts");
+const vsCodeUtils_1 = require("../../../vsCodeUtils");
+const CLI_PROMPTS_DIR = path.join(__dirname, "../../../../prompts");
+const VSCODE_PROMPTS_DIR = path.join(__dirname, "./prompts");
 const FIREBASE_TAG_REGEX = /<firebase_prompts(?:\s+hash="([^"]+)")?>([\s\S]*?)<\/firebase_prompts>/;
 const PROMPT_FILES = {
     base: "FIREBASE.md",
@@ -92,6 +94,7 @@ function getFeatureContent(feature) {
     const filename = PROMPT_FILES[feature];
     if (!filename)
         return "";
+    const PROMPTS_DIR = (0, vsCodeUtils_1.isVSCodeExtension)() ? VSCODE_PROMPTS_DIR : CLI_PROMPTS_DIR;
     const content = fs.readFileSync(path.join(PROMPTS_DIR, filename), "utf8");
     return content;
 }

package/lib/init/features/apptesting/index.js

@@ -4,6 +4,7 @@ exports.actuate = exports.askQuestions = void 0;
 const path_1 = require("path");
 const prompt_1 = require("../../../prompt");
 const templates_1 = require("../../../templates");
+const ensureProjectConfigured_1 = require("../../../apptesting/ensureProjectConfigured");
 const SMOKE_TEST_YAML_TEMPLATE = (0, templates_1.readTemplateSync)("init/apptesting/smoke_test.yaml");
 async function askQuestions(setup) {
     var _a, _b;
@@ -14,6 +15,9 @@ async function askQuestions(setup) {
                     default: "tests",
                 })),
         } });
+    if (setup.projectId) {
+        await (0, ensureProjectConfigured_1.ensureProjectConfigured)(setup.projectId);
+    }
 }
 exports.askQuestions = askQuestions;
 async function actuate(setup, config) {

package/lib/mcp/index.js

@@ -19,8 +19,11 @@ const hubClient_js_1 = require("../emulator/hubClient.js");
 const node_fs_1 = require("node:fs");
 const ensureApiEnabled_js_1 = require("../ensureApiEnabled.js");
 const api = require("../api.js");
-const SERVER_VERSION = "0.1.0";
-const cmd = new command_js_1.Command("experimental:mcp").before(requireAuth_js_1.requireAuth);
+const logging_transport_js_1 = require("./logging-transport.js");
+const env_js_1 = require("../env.js");
+const timeout_js_1 = require("../timeout.js");
+const SERVER_VERSION = "0.2.0";
+const cmd = new command_js_1.Command("experimental:mcp");
 const orderedLogLevels = [
     "debug",
     "info",
@@ -32,9 +35,20 @@ const orderedLogLevels = [
     "emergency",
 ];
 class FirebaseMcpServer {
+    async trackGA4(event, params = {}) {
+        var _a, _b;
+        if (!this.clientInfo)
+            await (0, timeout_js_1.timeoutFallback)(this.ready(), null, 2000);
+        const clientInfoParams = {
+            mcp_client_name: ((_a = this.clientInfo) === null || _a === void 0 ? void 0 : _a.name) || "<unknown-client>",
+            mcp_client_version: ((_b = this.clientInfo) === null || _b === void 0 ? void 0 : _b.version) || "<unknown-version>",
+        };
+        (0, track_js_1.trackGA4)(event, Object.assign(Object.assign({}, params), clientInfoParams));
+    }
     constructor(options) {
         this._ready = false;
         this._readyPromises = [];
+        this.currentLogLevel = process.env.FIREBASE_MCP_DEBUG_LOG ? "debug" : undefined;
         this.logger = Object.fromEntries(orderedLogLevels.map((logLevel) => [
             logLevel,
             (message) => this.log(logLevel, message),
@@ -50,10 +64,7 @@ class FirebaseMcpServer {
             const clientInfo = this.server.getClientVersion();
             this.clientInfo = clientInfo;
             if (clientInfo === null || clientInfo === void 0 ? void 0 : clientInfo.name) {
-                (0, track_js_1.trackGA4)("mcp_client_connected", {
-                    mcp_client_name: clientInfo.name,
-                    mcp_client_version: clientInfo.version,
-                });
+                this.trackGA4("mcp_client_connected");
             }
             if (!((_a = this.clientInfo) === null || _a === void 0 ? void 0 : _a.name))
                 this.clientInfo = { name: "<unknown-client>" };
@@ -76,9 +87,12 @@ class FirebaseMcpServer {
             this._readyPromises.push({ resolve: resolve, reject });
         });
     }
+    get clientName() {
+        var _a, _b;
+        return (_b = (_a = this.clientInfo) === null || _a === void 0 ? void 0 : _a.name) !== null && _b !== void 0 ? _b : ((0, env_js_1.isFirebaseStudio)() ? "Firebase Studio" : "<unknown-client>");
+    }
     get clientConfigKey() {
-        var _a;
-        return `mcp.clientConfigs.${((_a = this.clientInfo) === null || _a === void 0 ? void 0 : _a.name) || "<unknown-client>"}:${this.startupRoot || process.cwd()}`;
+        return `mcp.clientConfigs.${this.clientName}:${this.startupRoot || process.cwd()}`;
     }
     getStoredClientConfig() {
         return configstore_js_1.configstore.get(this.clientConfigKey) || {};
@@ -90,17 +104,19 @@ class FirebaseMcpServer {
         return newConfig;
     }
     async detectProjectRoot() {
-        await this.ready();
+        await (0, timeout_js_1.timeoutFallback)(this.ready(), null, 2000);
         if (this.cachedProjectRoot)
             return this.cachedProjectRoot;
         const storedRoot = this.getStoredClientConfig().projectRoot;
         this.cachedProjectRoot = storedRoot || this.startupRoot || process.cwd();
+        this.log("debug", "detected and cached project root: " + this.cachedProjectRoot);
         return this.cachedProjectRoot;
     }
     async detectActiveFeatures() {
         var _a;
         if ((_a = this.detectedFeatures) === null || _a === void 0 ? void 0 : _a.length)
             return this.detectedFeatures;
+        this.log("debug", "detecting active features of Firebase MCP server...");
         const options = await this.resolveOptions();
         const projectId = await this.getProjectId();
         const detected = await Promise.all(types_js_2.SERVER_FEATURES.map(async (f) => {
@@ -109,6 +125,7 @@ class FirebaseMcpServer {
             return null;
         }));
         this.detectedFeatures = detected.filter((f) => !!f);
+        this.log("debug", "detected features of Firebase MCP server: " + (this.detectedFeatures.join(", ") || "<none>"));
         return this.detectedFeatures;
     }
     async getEmulatorHubClient() {
@@ -156,36 +173,37 @@ class FirebaseMcpServer {
     async getProjectId() {
         return (0, projectUtils_js_1.getProjectId)(await this.resolveOptions());
     }
-    async getAuthenticatedUser() {
+    async getAuthenticatedUser(skipAutoAuth = false) {
         try {
-            const email = await (0, requireAuth_js_1.requireAuth)(await this.resolveOptions());
-            return email !== null && email !== void 0 ? email : "Application Default Credentials";
+            this.log("debug", `calling requireAuth`);
+            const email = await (0, requireAuth_js_1.requireAuth)(await this.resolveOptions(), skipAutoAuth);
+            this.log("debug", `detected authenticated account: ${email || "<none>"}`);
+            return (email !== null && email !== void 0 ? email : skipAutoAuth) ? null : "Application Default Credentials";
         }
         catch (e) {
+            this.log("debug", `error in requireAuth: ${e}`);
             return null;
         }
     }
     async mcpListTools() {
-        var _a, _b;
         await Promise.all([this.detectActiveFeatures(), this.detectProjectRoot()]);
         const hasActiveProject = !!(await this.getProjectId());
-        await (0, track_js_1.trackGA4)("mcp_list_tools", {
-            mcp_client_name: (_a = this.clientInfo) === null || _a === void 0 ? void 0 : _a.name,
-            mcp_client_version: (_b = this.clientInfo) === null || _b === void 0 ? void 0 : _b.version,
-        });
+        await this.trackGA4("mcp_list_tools");
+        const skipAutoAuthForStudio = (0, env_js_1.isFirebaseStudio)();
+        this.log("debug", `skip auto-auth in studio environment: ${skipAutoAuthForStudio}`);
         return {
             tools: this.availableTools.map((t) => t.mcp),
             _meta: {
                 projectRoot: this.cachedProjectRoot,
                 projectDetected: hasActiveProject,
-                authenticatedUser: await this.getAuthenticatedUser(),
+                authenticatedUser: await this.getAuthenticatedUser(skipAutoAuthForStudio),
                 activeFeatures: this.activeFeatures,
                 detectedFeatures: this.detectedFeatures,
             },
         };
     }
     async mcpCallTool(request) {
-        var _a, _b, _c, _d, _e, _f, _g;
+        var _a, _b, _c;
         await this.detectProjectRoot();
         const toolName = request.params.name;
         const toolArgs = request.params.arguments;
@@ -225,26 +243,24 @@ class FirebaseMcpServer {
         };
         try {
             const res = await tool.fn(toolArgs, toolsCtx);
-            await (0, track_js_1.trackGA4)("mcp_tool_call", {
+            await this.trackGA4("mcp_tool_call", {
                 tool_name: toolName,
                 error: res.isError ? 1 : 0,
-                mcp_client_name: (_d = this.clientInfo) === null || _d === void 0 ? void 0 : _d.name,
-                mcp_client_version: (_e = this.clientInfo) === null || _e === void 0 ? void 0 : _e.version,
             });
             return res;
         }
         catch (err) {
-            await (0, track_js_1.trackGA4)("mcp_tool_call", {
+            await this.trackGA4("mcp_tool_call", {
                 tool_name: toolName,
                 error: 1,
-                mcp_client_name: (_f = this.clientInfo) === null || _f === void 0 ? void 0 : _f.name,
-                mcp_client_version: (_g = this.clientInfo) === null || _g === void 0 ? void 0 : _g.version,
             });
             return (0, util_js_1.mcpError)(err);
         }
     }
     async start() {
-        const transport = new stdio_js_1.StdioServerTransport();
+        const transport = process.env.FIREBASE_MCP_DEBUG_LOG
+            ? new logging_transport_js_1.LoggingStdioServerTransport(process.env.FIREBASE_MCP_DEBUG_LOG)
+            : new stdio_js_1.StdioServerTransport();
         await this.server.connect(transport);
     }
     async log(level, message) {
@@ -258,7 +274,8 @@ class FirebaseMcpServer {
         if (orderedLogLevels.indexOf(this.currentLogLevel) > orderedLogLevels.indexOf(level)) {
             return;
         }
-        await this.server.sendLoggingMessage({ level, data });
+        if (this._ready)
+            await this.server.sendLoggingMessage({ level, data });
     }
 }
 exports.FirebaseMcpServer = FirebaseMcpServer;

package/lib/mcp/logging-transport.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoggingStdioServerTransport = void 0;
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const fs_1 = require("fs");
+const promises_1 = require("fs/promises");
+class LoggingStdioServerTransport extends stdio_js_1.StdioServerTransport {
+    constructor(path) {
+        super();
+        this.path = path;
+        (0, fs_1.appendFileSync)(path, "--- new process start ---\n");
+        const origOnData = this._ondata;
+        this._ondata = (chunk) => {
+            origOnData(chunk);
+            (0, fs_1.appendFileSync)(path, chunk.toString(), { encoding: "utf8" });
+        };
+    }
+    async send(message) {
+        await super.send(message);
+        await (0, promises_1.appendFile)(this.path, JSON.stringify(message) + "\n");
+    }
+}
+exports.LoggingStdioServerTransport = LoggingStdioServerTransport;

package/lib/mcp/util.js

@@ -6,6 +6,7 @@ const js_yaml_1 = require("js-yaml");
 const os_1 = require("os");
 const api_1 = require("../api");
 const ensureApiEnabled_1 = require("../ensureApiEnabled");
+const timeout_1 = require("../timeout");
 function toContent(data, options) {
     if (typeof data === "string")
         return { content: [{ type: "text", text: data }] };
@@ -70,7 +71,7 @@ async function checkFeatureActive(feature, projectId, options) {
         return true;
     try {
         if (projectId)
-            return await (0, ensureApiEnabled_1.check)(projectId, SERVER_FEATURE_APIS[feature], "", true);
+            return await (0, timeout_1.timeoutFallback)((0, ensureApiEnabled_1.check)(projectId, SERVER_FEATURE_APIS[feature], "", true), true, 3000);
     }
     catch (e) {
         return true;

package/lib/requireAuth.js

@@ -10,6 +10,8 @@ const logger_1 = require("./logger");
 const utils = require("./utils");
 const scopes = require("./scopes");
 const auth_1 = require("./auth");
+const env_1 = require("./env");
+const timeout_1 = require("./timeout");
 const AUTH_ERROR_MESSAGE = `Command requires authentication, please run ${clc.bold("firebase login")}`;
 let authClient;
 let lastOptions;
@@ -28,13 +30,14 @@ async function autoAuth(options, authScopes) {
     logger_1.logger.debug(`Running auto auth`);
     let clientEmail;
     try {
-        const credentials = await client.getCredentials();
+        const timeoutMillis = (0, env_1.isFirebaseMcp)() ? 5000 : 15000;
+        const credentials = await (0, timeout_1.timeoutError)(client.getCredentials(), new error_1.FirebaseError(`Authenticating with default credentials timed out after ${timeoutMillis / 1000} seconds. Please try running \`firebase login\` instead.`), timeoutMillis);
         clientEmail = credentials.client_email;
     }
     catch (e) {
         logger_1.logger.debug(`Error getting account credentials.`);
     }
-    if (process.env.MONOSPACE_ENV && token && clientEmail) {
+    if ((0, env_1.isFirebaseStudio)() && token && clientEmail) {
         const activeAccount = {
             user: { email: clientEmail },
             tokens: {
@@ -56,7 +59,7 @@ async function refreshAuth() {
     return lastOptions.tokens;
 }
 exports.refreshAuth = refreshAuth;
-async function requireAuth(options) {
+async function requireAuth(options, skipAutoAuth = false) {
     lastOptions = options;
     api.setScopes([scopes.CLOUD_PLATFORM, scopes.FIREBASE_PLATFORM]);
     options.authScopes = api.getScopes();
@@ -76,6 +79,9 @@ async function requireAuth(options) {
     else if (user && (!(0, auth_1.isExpired)(tokens) || (tokens === null || tokens === void 0 ? void 0 : tokens.refresh_token))) {
         logger_1.logger.debug(`> authorizing via signed-in user (${user.email})`);
     }
+    else if (skipAutoAuth) {
+        return null;
+    }
     else {
         try {
             return await autoAuth(options, options.authScopes);

package/lib/timeout.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.timeoutError = exports.timeoutFallback = void 0;
+async function timeoutFallback(promise, value, timeoutMillis = 2000) {
+    return Promise.race([
+        promise,
+        new Promise((resolve) => setTimeout(() => resolve(value), timeoutMillis)),
+    ]);
+}
+exports.timeoutFallback = timeoutFallback;
+async function timeoutError(promise, error, timeoutMillis = 5000) {
+    if (typeof error === "string")
+        error = new Error(error);
+    return Promise.race([
+        promise,
+        new Promise((resolve, reject) => {
+            setTimeout(() => reject(error || new Error("Operation timed out.")), timeoutMillis);
+        }),
+    ]);
+}
+exports.timeoutError = timeoutError;

package/lib/track.js

@@ -1,5 +1,4 @@
 "use strict";
-var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cliSession = exports.vscodeSession = exports.emulatorSession = exports.trackVSCode = exports.trackEmulator = exports.trackGA4 = exports.usageEnabled = exports.GA4_PROPERTIES = void 0;
 const node_fetch_1 = require("node-fetch");
@@ -7,6 +6,7 @@ const uuid_1 = require("uuid");
 const auth_1 = require("./auth");
 const configstore_1 = require("./configstore");
 const logger_1 = require("./logger");
+const env_1 = require("./env");
 const pkg = require("../package.json");
 exports.GA4_PROPERTIES = {
     cli: {
@@ -43,7 +43,7 @@ const GA4_USER_PROPS = {
         value: process.env.FIREPIT_VERSION || "none",
     },
     is_firebase_studio: {
-        value: (_a = process.env.MONOSPACE_ENV) !== null && _a !== void 0 ? _a : "false",
+        value: (0, env_1.isFirebaseStudio)().toString(),
     },
 };
 async function trackGA4(eventName, params, duration = 1) {

package/lib/utils.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getHostnameFromUrl = exports.openInBrowserPopup = exports.openInBrowser = exports.connectableHostname = exports.randomInt = exports.debounce = exports.last = exports.cloneDeep = exports.groupBy = exports.assertIsStringOrUndefined = exports.assertIsNumber = exports.assertIsString = exports.thirtyDaysFromNow = exports.isRunningInWSL = exports.isCloudEnvironment = exports.datetimeString = exports.createDestroyer = exports.sleep = exports.promiseWithSpinner = exports.tryParse = exports.promiseProps = exports.withTimeout = exports.promiseWhile = exports.promiseAllSettled = exports.getFunctionsEventProvider = exports.endpoint = exports.makeActiveProject = exports.streamToString = exports.stringToStream = exports.explainStdin = exports.allSettled = exports.reject = exports.logLabeledError = exports.logLabeledWarning = exports.logWarning = exports.logLabeledBullet = exports.logBullet = exports.logLabeledSuccess = exports.logSuccess = exports.addSubdomain = exports.addDatabaseNamespace = exports.getDatabaseViewDataUrl = exports.getDatabaseUrl = exports.envOverride = exports.setVSCodeEnvVars = exports.getInheritedOption = exports.consoleUrl = exports.vscodeEnvVars = exports.envOverrides = exports.IS_WINDOWS = void 0;
-exports.deepEqual = exports.promptForDirectory = exports.updateOrCreateGitignore = exports.readSecretValue = exports.generateId = exports.wrappedSafeLoad = exports.readFileFromDirectory = void 0;
+exports.openInBrowserPopup = exports.openInBrowser = exports.connectableHostname = exports.randomInt = exports.debounce = exports.last = exports.cloneDeep = exports.groupBy = exports.assertIsStringOrUndefined = exports.assertIsNumber = exports.assertIsString = exports.thirtyDaysFromNow = exports.isRunningInWSL = exports.isCloudEnvironment = exports.datetimeString = exports.createDestroyer = exports.sleep = exports.promiseWithSpinner = exports.tryParse = exports.promiseProps = exports.withTimeout = exports.promiseWhile = exports.promiseAllSettled = exports.getFunctionsEventProvider = exports.endpoint = exports.makeActiveProject = exports.streamToString = exports.stringToStream = exports.explainStdin = exports.allSettled = exports.reject = exports.logLabeledError = exports.logLabeledWarning = exports.logWarningToStderr = exports.logWarning = exports.logLabeledBullet = exports.logBullet = exports.logLabeledSuccess = exports.logSuccess = exports.addSubdomain = exports.addDatabaseNamespace = exports.getDatabaseViewDataUrl = exports.getDatabaseUrl = exports.envOverride = exports.setVSCodeEnvVars = exports.getInheritedOption = exports.consoleUrl = exports.vscodeEnvVars = exports.envOverrides = exports.IS_WINDOWS = void 0;
+exports.deepEqual = exports.promptForDirectory = exports.updateOrCreateGitignore = exports.readSecretValue = exports.generateId = exports.wrappedSafeLoad = exports.readFileFromDirectory = exports.getHostnameFromUrl = void 0;
 const fs = require("fs-extra");
 const tty = require("tty");
 const path = require("node:path");
@@ -115,6 +115,11 @@ function logWarning(message, type = "warn", data = undefined) {
     logger_1.logger[type](clc.yellow(clc.bold(`${WARNING_CHAR} `)), message, data);
 }
 exports.logWarning = logWarning;
+function logWarningToStderr(message) {
+    const prefix = clc.bold(`${WARNING_CHAR} `);
+    process.stderr.write(clc.yellow(prefix + message) + "\n");
+}
+exports.logWarningToStderr = logWarningToStderr;
 function logLabeledWarning(label, message, type = "warn", data = undefined) {
     logger_1.logger[type](clc.yellow(clc.bold(`${WARNING_CHAR}  ${label}:`)), message, data);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firebase-tools",
-  "version": "14.11.0",
+  "version": "14.11.1",
   "description": "Command-Line Interface for Firebase",
   "main": "./lib/index.js",
   "bin": {

package/lib/emulator/adminSdkConfig.test.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const chai_1 = require("chai");
-const adminSdkConfig_1 = require("./adminSdkConfig");
-describe("adminSdkConfig", () => {
-    describe("getProjectAdminSdkConfigOrCached", () => {
-        it("should return a fake config for a demo project id", async () => {
-            const projectId = "demo-project-1234";
-            await (0, chai_1.expect)((0, adminSdkConfig_1.getProjectAdminSdkConfigOrCached)(projectId)).to.eventually.deep.equal({
-                projectId: "demo-project-1234",
-                databaseURL: "https://demo-project-1234.firebaseio.com",
-                storageBucket: "demo-project-1234.appspot.com",
-            });
-        });
-    });
-});

package/lib/firestore/api-sort.test.js

@@ -1,74 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const chai_1 = require("chai");
-const firestore_1 = require("../gcp/firestore");
-const proto_1 = require("../gcp/proto");
-const sort = require("./api-sort");
-describe("compareApiBackup", () => {
-    it("should compare backups by location", () => {
-        const nam5Backup = {
-            name: "projects/example/locations/nam5/backups/backupid",
-        };
-        const usWest1Backup = {
-            name: "projects/example/locations/us-west1/backups/backupid",
-        };
-        (0, chai_1.expect)(sort.compareApiBackup(usWest1Backup, nam5Backup)).to.greaterThanOrEqual(1);
-        (0, chai_1.expect)(sort.compareApiBackup(nam5Backup, usWest1Backup)).to.lessThanOrEqual(-1);
-    });
-    it("should compare backups by snapshotTime (descending) if location is the same", () => {
-        const earlierBackup = {
-            name: "projects/example/locations/nam5/backups/backupid",
-            snapshotTime: "2024-01-01T00:00:00.000000Z",
-        };
-        const laterBackup = {
-            name: "projects/example/locations/nam5/backups/backupid",
-            snapshotTime: "2024-02-02T00:00:00.000000Z",
-        };
-        (0, chai_1.expect)(sort.compareApiBackup(earlierBackup, laterBackup)).to.greaterThanOrEqual(1);
-        (0, chai_1.expect)(sort.compareApiBackup(laterBackup, earlierBackup)).to.lessThanOrEqual(-1);
-    });
-    it("should compare backups by full name if location and snapshotTime are the same", () => {
-        const nam5Backup1 = {
-            name: "projects/example/locations/nam5/backups/earlier-backupid",
-            snapshotTime: "2024-01-01T00:00:00.000000Z",
-        };
-        const nam5Backup2 = {
-            name: "projects/example/locations/nam5/backups/later-backupid",
-            snapshotTime: "2024-01-01T00:00:00.000000Z",
-        };
-        (0, chai_1.expect)(sort.compareApiBackup(nam5Backup2, nam5Backup1)).to.greaterThanOrEqual(1);
-        (0, chai_1.expect)(sort.compareApiBackup(nam5Backup1, nam5Backup2)).to.lessThanOrEqual(-1);
-    });
-});
-describe("compareApiBackupSchedule", () => {
-    it("daily schedules should precede weekly ones", () => {
-        const dailySchedule = {
-            name: "projects/example/databases/mydatabase/backupSchedules/schedule",
-            dailyRecurrence: {},
-            retention: (0, proto_1.durationFromSeconds)(60 * 60 * 24),
-        };
-        const weeklySchedule = {
-            name: "projects/example/databases/mydatabase/backupSchedules/schedule",
-            weeklyRecurrence: {
-                day: firestore_1.DayOfWeek.FRIDAY,
-            },
-            retention: (0, proto_1.durationFromSeconds)(60 * 60 * 24 * 7),
-        };
-        (0, chai_1.expect)(sort.compareApiBackupSchedule(weeklySchedule, dailySchedule)).to.greaterThanOrEqual(1);
-        (0, chai_1.expect)(sort.compareApiBackup(dailySchedule, weeklySchedule)).to.lessThanOrEqual(-1);
-    });
-    it("should compare schedules with the same recurrence by name", () => {
-        const dailySchedule1 = {
-            name: "projects/example/databases/mydatabase/backupSchedules/schedule1",
-            dailyRecurrence: {},
-            retention: (0, proto_1.durationFromSeconds)(60 * 60 * 24),
-        };
-        const dailySchedule2 = {
-            name: "projects/example/databases/mydatabase/backupSchedules/schedule2",
-            dailyRecurrence: {},
-            retention: (0, proto_1.durationFromSeconds)(60 * 60 * 24),
-        };
-        (0, chai_1.expect)(sort.compareApiBackupSchedule(dailySchedule1, dailySchedule2)).to.lessThanOrEqual(-1);
-        (0, chai_1.expect)(sort.compareApiBackup(dailySchedule2, dailySchedule1)).to.greaterThanOrEqual(1);
-    });
-});

package/lib/firestore/backupUtils.test.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const chai_1 = require("chai");
-const backupUtils_1 = require("./backupUtils");
-describe("calculateRetention", () => {
-    it("should accept minutes", () => {
-        (0, chai_1.expect)((0, backupUtils_1.calculateRetention)("5m")).to.eq(300);
-    });
-    it("should accept hours", () => {
-        (0, chai_1.expect)((0, backupUtils_1.calculateRetention)("3h")).to.eq(10800);
-    });
-    it("should accept days", () => {
-        (0, chai_1.expect)((0, backupUtils_1.calculateRetention)("2d")).to.eq(172800);
-    });
-    it("should accept weeks", () => {
-        (0, chai_1.expect)((0, backupUtils_1.calculateRetention)("3w")).to.eq(1814400);
-    });
-});

package/lib/firestore/pretty-print.test.js

@@ -1,61 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const chai_1 = require("chai");
-const API = require("./api-types");
-const pretty_print_1 = require("./pretty-print");
-const printer = new pretty_print_1.PrettyPrint();
-describe("prettyIndexString", () => {
-    it("should correctly print an order type Index", () => {
-        (0, chai_1.expect)(printer.prettyIndexString({
-            name: "/projects/project/databases/(default)/collectionGroups/collectionB/indexes/a",
-            queryScope: API.QueryScope.COLLECTION,
-            fields: [
-                { fieldPath: "foo", order: API.Order.ASCENDING },
-                { fieldPath: "bar", order: API.Order.DESCENDING },
-            ],
-        }, false)).to.contain("(foo,ASCENDING) (bar,DESCENDING) ");
-    });
-    it("should correctly print a contains type Index", () => {
-        (0, chai_1.expect)(printer.prettyIndexString({
-            name: "/projects/project/databases/(default)/collectionGroups/collectionB/indexes/a",
-            queryScope: API.QueryScope.COLLECTION,
-            fields: [
-                { fieldPath: "foo", order: API.Order.ASCENDING },
-                { fieldPath: "baz", arrayConfig: API.ArrayConfig.CONTAINS },
-            ],
-        }, false)).to.contain("(foo,ASCENDING) (baz,CONTAINS) ");
-    });
-    it("should correctly print a vector type Index", () => {
-        (0, chai_1.expect)(printer.prettyIndexString({
-            name: "/projects/project/databases/(default)/collectionGroups/collectionB/indexes/a",
-            queryScope: API.QueryScope.COLLECTION,
-            fields: [{ fieldPath: "foo", vectorConfig: { dimension: 100, flat: {} } }],
-        }, false)).to.contain("(foo,VECTOR<100>) ");
-    });
-    it("should correctly print a vector type Index with other fields", () => {
-        (0, chai_1.expect)(printer.prettyIndexString({
-            name: "/projects/project/databases/(default)/collectionGroups/collectionB/indexes/a",
-            queryScope: API.QueryScope.COLLECTION,
-            fields: [
-                { fieldPath: "foo", order: API.Order.ASCENDING },
-                { fieldPath: "bar", vectorConfig: { dimension: 200, flat: {} } },
-            ],
-        }, false)).to.contain("(foo,ASCENDING) (bar,VECTOR<200>) ");
-    });
-});
-describe("firebaseConsoleDatabaseUrl", () => {
-    it("should provide a console link", () => {
-        (0, chai_1.expect)(printer.firebaseConsoleDatabaseUrl("example-project", "example-db")).to.equal("https://console.firebase.google.com/project/example-project/firestore/databases/example-db/data");
-    });
-    it("should convert (default) to -default-", () => {
-        (0, chai_1.expect)(printer.firebaseConsoleDatabaseUrl("example-project", "(default)")).to.equal("https://console.firebase.google.com/project/example-project/firestore/databases/-default-/data");
-    });
-});
-describe("prettyStringArray", () => {
-    it("should correctly print an array of strings", () => {
-        (0, chai_1.expect)(printer.prettyStringArray(["kms-key-1", "kms-key-2"])).to.equal("kms-key-1\nkms-key-2\n");
-    });
-    it("should print nothing if the array is empty", () => {
-        (0, chai_1.expect)(printer.prettyStringArray([])).to.equal("");
-    });
-});

package/lib/firestore/util.test.js

@@ -1,42 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const chai_1 = require("chai");
-const util = require("./util");
-describe("IndexNameParsing", () => {
-    it("should parse an index name correctly", () => {
-        const name = "/projects/myproject/databases/(default)/collectionGroups/collection/indexes/abc123/";
-        (0, chai_1.expect)(util.parseIndexName(name)).to.eql({
-            projectId: "myproject",
-            databaseId: "(default)",
-            collectionGroupId: "collection",
-            indexId: "abc123",
-        });
-    });
-    it("should parse a field name correctly", () => {
-        const name = "/projects/myproject/databases/(default)/collectionGroups/collection/fields/abc123/";
-        (0, chai_1.expect)(util.parseFieldName(name)).to.eql({
-            projectId: "myproject",
-            databaseId: "(default)",
-            collectionGroupId: "collection",
-            fieldPath: "abc123",
-        });
-    });
-    it("should parse an index name from a named database correctly", () => {
-        const name = "/projects/myproject/databases/named-db/collectionGroups/collection/indexes/abc123/";
-        (0, chai_1.expect)(util.parseIndexName(name)).to.eql({
-            projectId: "myproject",
-            databaseId: "named-db",
-            collectionGroupId: "collection",
-            indexId: "abc123",
-        });
-    });
-    it("should parse a field name from a named database correctly", () => {
-        const name = "/projects/myproject/databases/named-db/collectionGroups/collection/fields/abc123/";
-        (0, chai_1.expect)(util.parseFieldName(name)).to.eql({
-            projectId: "myproject",
-            databaseId: "named-db",
-            collectionGroupId: "collection",
-            fieldPath: "abc123",
-        });
-    });
-});