firebase-tools 14.11.0 → 14.11.2

package/lib/apptesting/ensureProjectConfigured.js

@@ -0,0 +1,56 @@
+"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)(), "Firebase App Testing", false);
+    await (0, ensureApiEnabled_1.ensure)(projectId, (0, api_1.cloudRunApiOrigin)(), "Cloud Run", false);
+    await (0, ensureApiEnabled_1.ensure)(projectId, (0, api_1.storageOrigin)(), "Cloud Storage", false);
+    await (0, ensureApiEnabled_1.ensure)(projectId, (0, api_1.artifactRegistryDomain)(), "Artifact Registry", 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/ext-export.js

@@ -45,7 +45,7 @@ exports.command = new command_1.Command("ext:export")
         return;
     }
     const manifestSpecs = withRefSubbed.map((spec) => {
-        const paramCopy = Object.assign({}, spec.params);
+        const paramCopy = Object.assign(Object.assign({}, spec.params), spec.systemParams);
         if (spec.eventarcChannel) {
             paramCopy.EVENTARC_CHANNEL = spec.eventarcChannel;
         }

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/commands/login.js

@@ -22,7 +22,7 @@ exports.command = new command_1.Command("login")
     }
     const user = options.user;
     const tokens = options.tokens;
-    if (user && tokens && !options.reauth) {
+    if (user && (tokens === null || tokens === void 0 ? void 0 : tokens.refresh_token) && !options.reauth) {
         logger_1.logger.info("Already logged in as", clc.bold(user.email));
         return user;
     }
@@ -37,7 +37,7 @@ exports.command = new command_1.Command("login")
         configstore_1.configstore.set("usage", collectUsage);
         if (geminiUsage || collectUsage) {
             logger_1.logger.info();
-            utils.logBullet("To change your the preference at any time, run `firebase logout` and `firebase login` again.");
+            utils.logBullet("To change your preferences at any time, run `firebase logout` and `firebase login` again.");
         }
     }
     const useLocalhost = (0, utils_1.isCloudEnvironment)() ? false : options.localhost;

package/lib/deploy/functions/params.js

@@ -108,6 +108,10 @@ class ParamValue {
         return ["true", "y", "yes", "1"].includes(this.rawValue);
     }
     asList() {
+        if (this.rawValue.includes("[")) {
+            const unquoted = this.rawValue.replace(/'/g, '"');
+            return JSON.parse(unquoted);
+        }
         return this.rawValue.split(this.delimiter);
     }
     asNumber() {

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/errors.js

@@ -3,8 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.mcpGeminiError = exports.mcpAuthError = exports.NO_PROJECT_ERROR = void 0;
 const util_1 = require("./util");
 exports.NO_PROJECT_ERROR = (0, util_1.mcpError)('No active project was found. Use the `firebase_update_environment` tool to set the project directory to an absolute folder location containing a firebase.json config file. Alternatively, change the MCP server config to add [...,"--dir","/absolute/path/to/project/directory"] in its command-line arguments.', "PRECONDITION_FAILED");
-function mcpAuthError() {
+function mcpAuthError(skipADC) {
     const cmd = (0, util_1.commandExistsSync)("firebase") ? "firebase" : "npx -y firebase-tools";
+    if (skipADC) {
+        return (0, util_1.mcpError)(`The user is not currently logged into the Firebase CLI, which is required to use this tool. Please instruct the user to execute this shell command to sign in.
+\`\`\`sh
+${cmd} login
+\`\`\``);
+    }
     return (0, util_1.mcpError)(`The user is not currently logged into the Firebase CLI, which is required to use this tool. Please instruct the user to execute this shell command to sign in or to configure [Application Default Credentials][ADC] on their machine.
 \`\`\`sh
 ${cmd} login