firebase-tools 15.8.0 → 15.9.0

package/lib/apiv2.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Client = exports.CLI_OAUTH_PROJECT_NUMBER = exports.GOOG_USER_PROJECT_HEADER = exports.STANDARD_HEADERS = void 0;
+exports.Client = exports.CLI_OAUTH_PROJECT_NUMBER = exports.GOOG_USER_PROJECT_HEADER = exports.standardHeaders = void 0;
 exports.setRefreshToken = setRefreshToken;
 exports.setAccessToken = setAccessToken;
 exports.getAccessToken = getAccessToken;
@@ -19,15 +19,18 @@ const responseToError_1 = require("./responseToError");
 const FormData = require("form-data");
 const pkg = require("../package.json");
 const CLI_VERSION = pkg.version;
-const agent = (0, env_1.detectAIAgent)();
-const agentStr = agent === "unknown" ? "" : ` agent-name/${agent}`;
-const platform = (0, env_1.isFirebaseMcp)() ? "FirebaseMCP" : "FirebaseCLI";
-const clientVersion = `${platform}/${CLI_VERSION}${agentStr}`;
-exports.STANDARD_HEADERS = {
-    Connection: "keep-alive",
-    "User-Agent": clientVersion,
-    "X-Client-Version": clientVersion,
+const standardHeaders = () => {
+    const agent = (0, env_1.detectAIAgent)();
+    const agentStr = agent === "unknown" ? "" : ` agent-name/${agent}`;
+    const platform = (0, env_1.isFirebaseMcp)() ? "FirebaseMCP" : "FirebaseCLI";
+    const clientVersion = `${platform}/${CLI_VERSION}${agentStr}`;
+    return {
+        Connection: "keep-alive",
+        "User-Agent": clientVersion,
+        "X-Client-Version": clientVersion,
+    };
 };
+exports.standardHeaders = standardHeaders;
 const GOOG_QUOTA_USER_HEADER = "x-goog-quota-user";
 exports.GOOG_USER_PROJECT_HEADER = "x-goog-user-project";
 const GOOGLE_CLOUD_QUOTA_PROJECT = process.env.GOOGLE_CLOUD_QUOTA_PROJECT;
@@ -150,7 +153,7 @@ class Client {
         if (!reqOptions.headers) {
             reqOptions.headers = new node_fetch_1.Headers();
         }
-        for (const [h, v] of Object.entries(exports.STANDARD_HEADERS)) {
+        for (const [h, v] of Object.entries((0, exports.standardHeaders)())) {
             if (!reqOptions.headers.has(h)) {
                 reqOptions.headers.set(h, v);
             }

package/lib/appdistribution/client.js

@@ -225,7 +225,7 @@ class AppDistributionClient {
         }
         utils.logSuccess(`Testers removed from group successfully`);
     }
-    async createReleaseTest(releaseName, devices, aiInstruction, loginCredential, testCaseName, displayName) {
+    async createReleaseTest(releaseName, devices, aiInstructions, loginCredential, testCaseName, displayName) {
         try {
             const response = await this.appDistroV1AlphaClient.request({
                 method: "POST",
@@ -234,7 +234,7 @@ class AppDistributionClient {
                     deviceExecutions: devices.map((device) => ({ device })),
                     loginCredential,
                     testCase: testCaseName,
-                    aiInstructions: aiInstruction,
+                    aiInstructions: aiInstructions,
                     displayName: displayName,
                 },
             });

package/lib/appdistribution/yaml_helper.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toYaml = toYaml;
+exports.fromYamlStep = fromYamlStep;
 exports.fromYaml = fromYaml;
 const jsYaml = require("js-yaml");
 const error_1 = require("../error");
-const ALLOWED_YAML_STEP_KEYS = new Set(["goal", "hint", "successCriteria"]);
+const ALLOWED_YAML_STEP_KEYS = new Set(["goal", "hint", "finalScreenAssertion"]);
 const ALLOWED_YAML_TEST_CASE_KEYS = new Set([
     "displayName",
     "id",
@@ -24,12 +25,14 @@ function toYamlTestCases(testCases) {
         steps: testCase.aiInstructions.steps.map((step) => ({
             goal: step.goal,
             ...(step.hint && { hint: step.hint }),
-            ...(step.successCriteria && { successCriteria: step.successCriteria }),
+            ...(step.successCriteria && {
+                finalScreenAssertion: step.successCriteria,
+            }),
         })),
     }));
 }
 function toYaml(testCases) {
-    return jsYaml.safeDump(toYamlTestCases(testCases));
+    return jsYaml.safeDump({ tests: toYamlTestCases(testCases) });
 }
 function castExists(it, thing) {
     if (it == null) {
@@ -44,22 +47,23 @@ function checkAllowedKeys(allowedKeys, o) {
         }
     }
 }
+function fromYamlStep(yamlStep) {
+    checkAllowedKeys(ALLOWED_YAML_STEP_KEYS, yamlStep);
+    return {
+        goal: castExists(yamlStep.goal, "goal"),
+        ...(yamlStep.hint && { hint: yamlStep.hint }),
+        ...(yamlStep.finalScreenAssertion && {
+            successCriteria: yamlStep.finalScreenAssertion,
+        }),
+    };
+}
 function fromYamlTestCases(appName, yamlTestCases) {
     return yamlTestCases.map((yamlTestCase) => {
         checkAllowedKeys(ALLOWED_YAML_TEST_CASE_KEYS, yamlTestCase);
         return {
             displayName: castExists(yamlTestCase.displayName, "displayName"),
             aiInstructions: {
-                steps: castExists(yamlTestCase.steps, "steps").map((yamlStep) => {
-                    checkAllowedKeys(ALLOWED_YAML_STEP_KEYS, yamlStep);
-                    return {
-                        goal: castExists(yamlStep.goal, "goal"),
-                        ...(yamlStep.hint && { hint: yamlStep.hint }),
-                        ...(yamlStep.successCriteria && {
-                            successCriteria: yamlStep.successCriteria,
-                        }),
-                    };
-                }),
+                steps: castExists(yamlTestCase.steps, "steps").map((yamlStep) => fromYamlStep(yamlStep)),
             },
             ...(yamlTestCase.id && {
                 name: `${appName}/testCases/${yamlTestCase.id}`,
@@ -78,8 +82,12 @@ function fromYaml(appName, yaml) {
     catch (err) {
         throw new error_1.FirebaseError(`Failed to parse YAML: ${(0, error_1.getErrMsg)(err)}`);
     }
-    if (!Array.isArray(parsedYaml)) {
-        throw new error_1.FirebaseError("YAML file must contain a list of test cases.");
+    if (!parsedYaml || typeof parsedYaml !== "object" || !("tests" in parsedYaml)) {
+        throw new error_1.FirebaseError("YAML file must contain a top-level 'tests' field with a list of test cases.");
+    }
+    const yamlTestCases = parsedYaml.tests;
+    if (!Array.isArray(yamlTestCases)) {
+        throw new error_1.FirebaseError("The 'tests' field in the YAML file must contain a list of test cases.");
     }
-    return fromYamlTestCases(appName, parsedYaml);
+    return fromYamlTestCases(appName, yamlTestCases);
 }

package/lib/apphosting/secrets/dialogs.js

@@ -71,7 +71,7 @@ exports.WARN_NO_BACKENDS = "To use this secret, your backend's service account m
     "It does not look like you have a backend yet. After creating a backend, grant access with " +
     clc.bold("firebase apphosting:secrets:grantaccess");
 exports.GRANT_ACCESS_IN_FUTURE = `To grant access in the future, run ${clc.bold("firebase apphosting:secrets:grantaccess")}`;
-async function selectBackendServiceAccounts(projectNumber, projectId, options) {
+async function selectBackendServiceAccounts(projectNumber, projectId, nonInteractive) {
     const listBackends = await apphosting.listBackends(projectId, "-");
     if (listBackends.unreachable.length) {
         utils.logWarning(`Could not reach location(s) ${listBackends.unreachable.join(", ")}. You may need to run ` +
@@ -83,7 +83,7 @@ async function selectBackendServiceAccounts(projectNumber, projectId, options) {
     }
     if (listBackends.backends.length === 1) {
         const grant = await prompt.confirm({
-            nonInteractive: options.nonInteractive,
+            nonInteractive,
             default: true,
             message: "To use this secret, your backend's service account must be granted access. Would you like to grant access now?",
         });
@@ -101,7 +101,7 @@ async function selectBackendServiceAccounts(projectNumber, projectId, options) {
             serviceAccountDisplay(metadata[0]) +
             ".\nGranting access to one backend will grant access to all backends.");
         const grant = await prompt.confirm({
-            nonInteractive: options.nonInteractive,
+            nonInteractive,
             default: true,
             message: "Would you like to grant access to all backends now?",
         });

package/lib/apphosting/secrets/index.js

@@ -7,6 +7,8 @@ exports.grantEmailsSecretAccess = grantEmailsSecretAccess;
 exports.upsertSecret = upsertSecret;
 exports.fetchSecrets = fetchSecrets;
 exports.getSecretNameParts = getSecretNameParts;
+exports.apphostingSecretsSetAction = apphostingSecretsSetAction;
+const clc = require("colorette");
 const error_1 = require("../../error");
 const gcsm = require("../../gcp/secretManager");
 const gcb = require("../../gcp/cloudbuild");
@@ -16,6 +18,9 @@ const secretManager_1 = require("../../gcp/secretManager");
 const secretManager_2 = require("../../gcp/secretManager");
 const utils = require("../../utils");
 const prompt = require("../../prompt");
+const dialogs = require("../../apphosting/secrets/dialogs");
+const config = require("../../apphosting/config");
+const projects_1 = require("../../management/projects");
 function toMulti(accounts) {
     const m = {
         buildServiceAccounts: [accounts.buildServiceAccount],
@@ -169,3 +174,57 @@ function getSecretNameParts(secret) {
     }
     return [name, version];
 }
+async function apphostingSecretsSetAction(secretName, projectId, projectNumber, location, dataFile, nonInteractive) {
+    if (!projectNumber) {
+        projectNumber = (await (0, projects_1.getProject)(projectId)).projectNumber;
+    }
+    const created = await upsertSecret(projectId, secretName, location);
+    if (created === null) {
+        return;
+    }
+    else if (created) {
+        utils.logSuccess(`Created new secret projects/${projectId}/secrets/${secretName}`);
+    }
+    const secretValue = await utils.readSecretValue(`Enter a value for ${secretName}`, dataFile);
+    const version = await gcsm.addVersion(projectId, secretName, secretValue);
+    utils.logSuccess(`Created new secret version ${gcsm.toSecretVersionResourceName(version)}`);
+    utils.logBullet(`You can access the contents of the secret's latest value with ${clc.bold(`firebase apphosting:secrets:access ${secretName}\n`)}`);
+    if (!created) {
+        return;
+    }
+    const type = await prompt.select({
+        message: "Is this secret for production or only local testing?",
+        choices: [
+            { name: "Production", value: "production" },
+            { name: "Local testing only", value: "local" },
+        ],
+        nonInteractive: !!nonInteractive,
+        default: "production",
+    });
+    if (type === "local") {
+        const emailList = await prompt.input({
+            message: "Please enter a comma separated list of user or groups who should have access to this secret:",
+        });
+        if (emailList.length) {
+            await grantEmailsSecretAccess(projectId, [secretName], emailList.split(","));
+        }
+        else {
+            utils.logBullet("To grant access in the future run " +
+                clc.bold(`firebase apphosting:secrets:grantaccess ${secretName} --emails [email list]`));
+        }
+        await config.maybeAddSecretToYaml(secretName, config.APPHOSTING_EMULATORS_YAML_FILE);
+        return;
+    }
+    const accounts = await dialogs.selectBackendServiceAccounts(projectNumber, projectId, !!nonInteractive);
+    if (!accounts.buildServiceAccounts.length && !accounts.runServiceAccounts.length) {
+        utils.logWarning(`To use this secret in your backend, you must grant access. You can do so in the future with ${clc.bold("firebase apphosting:secrets:grantaccess")}`);
+    }
+    else {
+        await grantSecretAccess(projectId, projectNumber, secretName, accounts);
+    }
+    await config.maybeAddSecretToYaml(secretName, config.APPHOSTING_BASE_YAML_FILE);
+    utils.logBullet("To grant additional users access to this secret run " +
+        clc.bold(`firebase apphosting:secrets:grantaccess ${secretName} --email [email list]`) +
+        ".\nTo grant additional backends access to this secret run " +
+        clc.bold(`firebase apphosting:secrets:grantaccess ${secretName} --backend [backend ID]`));
+}

package/lib/apptesting/parseTestFiles.js

@@ -7,6 +7,7 @@ const logger_1 = require("../logger");
 const types_1 = require("./types");
 const utils_1 = require("../utils");
 const error_1 = require("../error");
+const yaml_helper_1 = require("../appdistribution/yaml_helper");
 async function parseTestFiles(dir, targetUri, filePattern, namePattern) {
     if (targetUri) {
         try {
@@ -115,7 +116,7 @@ function toTestCaseInvocation(testDef, targetUri, defaultConfig) {
             prerequisiteTestCaseId: testDef.prerequisiteTestCaseId,
             startUri: targetUri + route,
             displayName: testDef.displayName,
-            steps: steps,
+            steps: steps.map((step) => (0, yaml_helper_1.fromYamlStep)(step)),
         },
         testExecution: browsers.map((browser) => ({ config: { browser } })),
     };

package/lib/bin/mcp.js

@@ -6,6 +6,7 @@ const path_1 = require("path");
 const util_1 = require("util");
 const logger_1 = require("../logger");
 const index_1 = require("../mcp/index");
+const env_1 = require("../env");
 const index_js_1 = require("../mcp/prompts/index.js");
 const index_js_2 = require("../mcp/resources/index.js");
 const index_js_3 = require("../mcp/tools/index.js");
@@ -80,7 +81,7 @@ async function mcp() {
     }
     if (earlyExit)
         return;
-    process.env.IS_FIREBASE_MCP = "true";
+    (0, env_1.setFirebaseMcp)(true);
     (0, logger_1.useFileLogger)();
     const activeFeatures = (values.only || "")
         .split(",")

package/lib/commands/apphosting-secrets-set.js

@@ -1,18 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.command = void 0;
-const clc = require("colorette");
 const command_1 = require("../command");
 const projectUtils_1 = require("../projectUtils");
 const requireAuth_1 = require("../requireAuth");
 const gcsm = require("../gcp/secretManager");
 const apphosting = require("../gcp/apphosting");
 const requirePermissions_1 = require("../requirePermissions");
-const secrets = require("../apphosting/secrets");
-const dialogs = require("../apphosting/secrets/dialogs");
-const config = require("../apphosting/config");
-const utils = require("../utils");
-const prompt = require("../prompt");
+const secrets_1 = require("../apphosting/secrets");
 exports.command = new command_1.Command("apphosting:secrets:set <secretName>")
     .description("create or update a secret for use in Firebase App Hosting")
     .option("-l, --location <location>", "optional location to retrict secret replication")
@@ -32,51 +27,5 @@ exports.command = new command_1.Command("apphosting:secrets:set <secretName>")
     .action(async (secretName, options) => {
     const projectId = (0, projectUtils_1.needProjectId)(options);
     const projectNumber = await (0, projectUtils_1.needProjectNumber)(options);
-    const created = await secrets.upsertSecret(projectId, secretName, options.location);
-    if (created === null) {
-        return;
-    }
-    else if (created) {
-        utils.logSuccess(`Created new secret projects/${projectId}/secrets/${secretName}`);
-    }
-    const secretValue = await utils.readSecretValue(`Enter a value for ${secretName}`, options.dataFile);
-    const version = await gcsm.addVersion(projectId, secretName, secretValue);
-    utils.logSuccess(`Created new secret version ${gcsm.toSecretVersionResourceName(version)}`);
-    utils.logBullet(`You can access the contents of the secret's latest value with ${clc.bold(`firebase apphosting:secrets:access ${secretName}\n`)}`);
-    if (!created) {
-        return;
-    }
-    const type = await prompt.select({
-        message: "Is this secret for production or only local testing?",
-        choices: [
-            { name: "Production", value: "production" },
-            { name: "Local testing only", value: "local" },
-        ],
-    });
-    if (type === "local") {
-        const emailList = await prompt.input({
-            message: "Please enter a comma separated list of user or groups who should have access to this secret:",
-        });
-        if (emailList.length) {
-            await secrets.grantEmailsSecretAccess(projectId, [secretName], emailList.split(","));
-        }
-        else {
-            utils.logBullet("To grant access in the future run " +
-                clc.bold(`firebase apphosting:secrets:grantaccess ${secretName} --emails [email list]`));
-        }
-        await config.maybeAddSecretToYaml(secretName, config.APPHOSTING_EMULATORS_YAML_FILE);
-        return;
-    }
-    const accounts = await dialogs.selectBackendServiceAccounts(projectNumber, projectId, options);
-    if (!accounts.buildServiceAccounts.length && !accounts.runServiceAccounts.length) {
-        utils.logWarning(`To use this secret in your backend, you must grant access. You can do so in the future with ${clc.bold("firebase apphosting:secrets:grantaccess")}`);
-    }
-    else {
-        await secrets.grantSecretAccess(projectId, projectNumber, secretName, accounts);
-    }
-    await config.maybeAddSecretToYaml(secretName, config.APPHOSTING_BASE_YAML_FILE);
-    utils.logBullet("To grant additional users access to this secret run " +
-        clc.bold(`firebase apphosting:secrets:grantaccess ${secretName} --email [email list]`) +
-        ".\nTo grant additional backends access to this secret run " +
-        clc.bold(`firebase apphosting:secrets:grantaccess ${secretName} --backend [backend ID]`));
+    return (0, secrets_1.apphostingSecretsSetAction)(secretName, projectId, projectNumber, options.location, options.dataFile, options.nonInteractive);
 });

package/lib/commands/apptesting.js

@@ -62,10 +62,10 @@ async function invokeTests(client, releaseName, testDefs, devices) {
     try {
         const testInvocations = [];
         for (const testDef of testDefs) {
-            const aiInstruction = {
+            const aiInstructions = {
                 steps: testDef.testCase.steps,
             };
-            testInvocations.push(await client.createReleaseTest(releaseName, devices, aiInstruction, undefined, undefined, testDef.testCase.displayName));
+            testInvocations.push(await client.createReleaseTest(releaseName, devices, aiInstructions, undefined, undefined, testDef.testCase.displayName));
         }
         return testInvocations;
     }

package/lib/commands/studio-export.js

@@ -3,10 +3,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.command = void 0;
 const command_1 = require("../command");
 const logger_1 = require("../logger");
+const migrate_1 = require("../firebase_studio/migrate");
+const path = require("path");
 const experiments = require("../experiments");
-exports.command = new command_1.Command("studio:export")
-    .description("export Firebase Studio apps to continue development locally")
-    .action(() => {
+const error_1 = require("../error");
+exports.command = new command_1.Command("studio:export <path>")
+    .description("Bootstrap Firebase Studio apps for migration to Antigravity. Run on the unzipped folder from the Firebase Studio download.")
+    .option("--no-start-agy", "skip starting the Antigravity IDE after migration")
+    .action(async (exportPath, options) => {
     experiments.assertEnabled("studioexport", "export Studio apps");
-    logger_1.logger.info("Exporting Studio apps to Antigravity...");
+    if (!exportPath) {
+        throw new error_1.FirebaseError("Must specify a path for migration.", { exit: 1 });
+    }
+    const rootPath = path.resolve(exportPath);
+    logger_1.logger.info(`Exporting Studio apps from ${rootPath} to Antigravity...`);
+    await (0, migrate_1.migrate)(rootPath, options);
 });

package/lib/dataconnect/schemaMigration.js

@@ -24,6 +24,7 @@ const cloudSqlAdminClient = require("../gcp/cloudsql/cloudsqladmin");
 const errors = require("./errors");
 const provisionCloudSql_1 = require("./provisionCloudSql");
 const requireAuth_1 = require("../requireAuth");
+const cloudbilling_1 = require("../gcp/cloudbilling");
 async function setupSchemaIfNecessary(instanceId, databaseId, options) {
     try {
         await (0, connect_1.setupIAMUsers)(instanceId, options);
@@ -429,7 +430,17 @@ async function ensureServiceIsConnectedToCloudSql(serviceName, instanceName, dat
         postgresql?.schemaValidation === "NONE") {
         const [, , , , , serviceId] = serviceName.split("/");
         const [, projectId, , , , instanceId] = postgresql.cloudSql.instance.split("/");
-        throw new error_1.FirebaseError(`While checking the service ${serviceId}, ` + (0, provisionCloudSql_1.cloudSQLBeingCreated)(projectId, instanceId));
+        let isFreeTrial = false;
+        let billingEnabled = false;
+        try {
+            const instance = await cloudSqlAdminClient.getInstance(projectId, instanceId);
+            isFreeTrial = instance.settings?.userLabels?.["firebase-data-connect"] === "ft";
+            billingEnabled = await (0, cloudbilling_1.checkBillingEnabled)(projectId);
+        }
+        catch (err) {
+        }
+        throw new error_1.FirebaseError(`While checking the service ${serviceId}, ` +
+            (0, provisionCloudSql_1.cloudSQLBeingCreated)(projectId, instanceId, isFreeTrial, billingEnabled));
     }
     if (!currentSchema || !postgresql) {
         if (!linkIfNotConnected) {

package/lib/deploy/apphosting/release.js

@@ -7,6 +7,7 @@ const backend_1 = require("../../apphosting/backend");
 const rollout_1 = require("../../apphosting/rollout");
 const projectUtils_1 = require("../../projectUtils");
 const utils_1 = require("../../utils");
+const error_1 = require("../../error");
 async function default_1(context, options) {
     let backendIds = Object.keys(context.backendConfigs);
     const missingBackends = backendIds.filter((id) => !context.backendLocations[id] || !context.backendStorageUris[id]);
@@ -39,6 +40,7 @@ async function default_1(context, options) {
     (0, utils_1.logLabeledBullet)("apphosting", `You may also track the rollout(s) at:\n\t${(0, api_1.consoleOrigin)()}/project/${projectId}/apphosting`);
     const rolloutsSpinner = ora(`Starting rollout(s) for backend(s) ${backendIds.join(", ")}; this may take a few minutes. It's safe to exit now.\n`).start();
     const results = await Promise.allSettled(rollouts);
+    let failed = false;
     for (let i = 0; i < results.length; i++) {
         const res = results[i];
         if (res.status === "fulfilled") {
@@ -47,9 +49,13 @@ async function default_1(context, options) {
             (0, utils_1.logLabeledSuccess)("apphosting", `Your backend is now deployed at:\n\thttps://${backend.uri}`);
         }
         else {
+            failed = true;
             (0, utils_1.logLabeledWarning)("apphosting", `Rollout for backend ${backendIds[i]} failed.`);
-            (0, utils_1.logLabeledError)("apphosting", res.reason);
+            (0, utils_1.logLabeledError)("apphosting", `${res.reason}`);
         }
     }
     rolloutsSpinner.stop();
+    if (failed) {
+        throw new error_1.FirebaseError("One or more rollouts failed. Please review the errors above and try again.");
+    }
 }

package/lib/deploy/extensions/prepare.js

@@ -20,6 +20,7 @@ const tos_1 = require("../../extensions/tos");
 const common_1 = require("../../extensions/runtimes/common");
 const functionsDeployHelper_1 = require("../functions/functionsDeployHelper");
 const projectConfig_1 = require("../../functions/projectConfig");
+const utils_1 = require("../../utils");
 const matchesInstanceId = (dep) => (test) => {
     return dep.instanceId === test.instanceId;
 };
@@ -123,10 +124,18 @@ async function prepareDynamicExtensions(context, options, payload, builds) {
     const extensions = (0, common_1.extractExtensionsFromBuilds)(builds, filters);
     const projectId = (0, projectUtils_1.needProjectId)(options);
     const projectNumber = await (0, projectUtils_1.needProjectNumber)(options);
-    await (0, extensionsHelper_1.ensureExtensionsApiEnabled)(options);
-    await (0, requirePermissions_1.requirePermissions)(options, ["firebaseextensions.instances.list"]);
-    let haveExtensions = await planner.haveDynamic(projectId);
-    haveExtensions = haveExtensions.filter((e) => (0, common_1.extensionMatchesAnyFilter)(e.labels?.codebase, e.instanceId, filters));
+    let haveExtensions = [];
+    try {
+        await (0, extensionsHelper_1.ensureExtensionsApiEnabled)(options);
+        await (0, requirePermissions_1.requirePermissions)(options, ["firebaseextensions.instances.list"]);
+        haveExtensions = await planner.haveDynamic(projectId);
+        haveExtensions = haveExtensions.filter((e) => (0, common_1.extensionMatchesAnyFilter)(e.labels?.codebase, e.instanceId, filters));
+    }
+    catch (err) {
+        (0, utils_1.logLabeledError)("extensions", "Failed to fetch the list of extensions. Assuming for now that there are no existing extensions. " +
+            "If you are trying to install an extension through Firebase Functions this may fail later.");
+        return;
+    }
     if (Object.keys(extensions).length === 0 && haveExtensions.length === 0) {
         return;
     }

package/lib/downloadUtils.js

@@ -21,7 +21,9 @@ async function downloadToTmp(remoteUrl, auth = false) {
         resolveOnHTTPError: true,
     });
     if (res.status !== 200) {
-        throw new error_1.FirebaseError(`download failed, status ${res.status}: ${await res.response.text()}`);
+        throw new error_1.FirebaseError(`download failed, status ${res.status}: ${await res.response.text()}`, {
+            status: res.status,
+        });
     }
     const total = parseInt(res.response.headers.get("content-length") || "0", 10);
     const totalMb = Math.ceil(total / 1000000);

package/lib/emulator/download.js

@@ -18,9 +18,23 @@ async function downloadEmulator(name) {
         emulatorLogger_1.EmulatorLogger.forEmulator(name).logLabeled("WARN", name, `Env variable override detected, skipping download. Using ${emulator} emulator at ${emulator.binaryPath}`);
         return;
     }
+    const overrideVersion = downloadableEmulators.emulatorVersionOverride(name);
+    if (overrideVersion) {
+        emulatorLogger_1.EmulatorLogger.forEmulator(name).logLabeled("WARN", name, `Env variable override detected. Using custom ${name} emulator version ${overrideVersion}.`);
+    }
     emulatorLogger_1.EmulatorLogger.forEmulator(name).logLabeled("BULLET", name, `downloading ${path.basename(emulator.downloadPath)}...`);
     fs.ensureDirSync(emulator.opts.cacheDir);
-    const tmpfile = await downloadUtils.downloadToTmp(emulator.opts.remoteUrl, !!emulator.opts.auth);
+    let tmpfile;
+    try {
+        tmpfile = await downloadUtils.downloadToTmp(emulator.opts.remoteUrl, !!emulator.opts.auth);
+    }
+    catch (err) {
+        if (overrideVersion && err instanceof error_1.FirebaseError && err.status === 404) {
+            throw new error_1.FirebaseError(`env variable ${name.toUpperCase()}_EMULATOR_VERSION set to ${overrideVersion}, 
+        but no such version of ${name} was found. Please double check the version number, or unset this environment variable to use the latest default.`);
+        }
+        throw err;
+    }
     if (!emulator.opts.skipChecksumAndSize) {
         await validateSize(tmpfile, emulator.opts.expectedSize);
         await validateChecksum(tmpfile, emulator.opts.expectedChecksum);

package/lib/emulator/downloadableEmulatorInfo.json

@@ -54,36 +54,36 @@
     },
     "dataconnect": {
         "darwin": {
-            "version": "3.2.0",
-            "expectedSize": 30823264,
-            "expectedChecksum": "165dcd011685866ca7a1970b6f2605f0",
-            "expectedChecksumSHA256": "a4d0a700ae38172324927c7054e7ade86dbdae87389be1d801665e46d3759451",
-            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-macos-amd64-v3.2.0",
-            "downloadPathRelativeToCacheDir": "dataconnect-emulator-3.2.0"
+            "version": "3.2.1",
+            "expectedSize": 30880608,
+            "expectedChecksum": "ef63443e5132e4ade7b89506fea60e29",
+            "expectedChecksumSHA256": "0a9c05413cb3048a4bef1968e55109ca67eb607e6d77355741cb9a7dcae51607",
+            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-macos-amd64-v3.2.1",
+            "downloadPathRelativeToCacheDir": "dataconnect-emulator-3.2.1"
         },
         "darwin_arm64": {
-            "version": "3.2.0",
-            "expectedSize": 30287890,
-            "expectedChecksum": "b1c75fa410033ed93463ab41b2bd8e61",
-            "expectedChecksumSHA256": "408c52c857af86df7bcf71b9ab7d9e1eeb29a12f042d79c76000e85f22a2e975",
-            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-macos-arm64-v3.2.0",
-            "downloadPathRelativeToCacheDir": "dataconnect-emulator-3.2.0"
+            "version": "3.2.1",
+            "expectedSize": 30339010,
+            "expectedChecksum": "866989b28ae5cad1084403bd4404dcee",
+            "expectedChecksumSHA256": "558e334c456c646b1ddf4b32ab43d976c5b03c191a4c92855e8c93cd32e1215a",
+            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-macos-arm64-v3.2.1",
+            "downloadPathRelativeToCacheDir": "dataconnect-emulator-3.2.1"
         },
         "win32": {
-            "version": "3.2.0",
-            "expectedSize": 31328256,
-            "expectedChecksum": "474319dff7a1a1eb364c1b5144ae11f5",
-            "expectedChecksumSHA256": "9f3852e35c60bb7adfc2bd24fd2d0a2f815659dbb6fec48bab0bd07bbd7d1651",
-            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-windows-amd64-v3.2.0",
-            "downloadPathRelativeToCacheDir": "dataconnect-emulator-3.2.0.exe"
+            "version": "3.2.1",
+            "expectedSize": 31385088,
+            "expectedChecksum": "cb46949156c889d5724f7fa80e8a613b",
+            "expectedChecksumSHA256": "1dd1f9ef7910d8295baac61741fde29fac536d82ff841a2d5cefe25e98f7cd98",
+            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-windows-amd64-v3.2.1",
+            "downloadPathRelativeToCacheDir": "dataconnect-emulator-3.2.1.exe"
         },
         "linux": {
-            "version": "3.2.0",
-            "expectedSize": 30744760,
-            "expectedChecksum": "dc9f0766287d982a0dabf1e2f90aa726",
-            "expectedChecksumSHA256": "82bd05e748526330b94b2d2d797507175ea1251b1760f64bc1d1e904f23c2f22",
-            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-linux-amd64-v3.2.0",
-            "downloadPathRelativeToCacheDir": "dataconnect-emulator-3.2.0"
+            "version": "3.2.1",
+            "expectedSize": 30798008,
+            "expectedChecksum": "8c29b6b526efcbf13de278bd3b5b598a",
+            "expectedChecksumSHA256": "d7eb7f7afd98dd9018039c83782312f975b160c3708eb49f8fecdf7d27508d82",
+            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-linux-amd64-v3.2.1",
+            "downloadPathRelativeToCacheDir": "dataconnect-emulator-3.2.1"
         }
     }
 }