firebase-tools 14.22.0 → 14.23.0

package/README.md

@@ -1,6 +1,6 @@
-# Firebase CLI [![Actions Status][gh-actions-badge]][gh-actions] [![Node Version][node-badge]][npm] [![NPM version][npm-badge]][npm] [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=firebase&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImZpcmViYXNlLXRvb2xzIiwiZXhwZXJpbWVudGFsOm1jcCIsIi0tZGlyIiwiLiJdfQ==)
+# Firebase CLI and MCP Server [![Actions Status][gh-actions-badge]][gh-actions] [![Node Version][node-badge]][npm] [![NPM version][npm-badge]][npm] [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=firebase&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImZpcmViYXNlLXRvb2xzIiwiZXhwZXBpbWVudGFsOm1jcCIsIi0tZGlyIiwiLiJdfQ==)
 
-The Firebase Command Line Interface (CLI) Tools can be used to test, manage, and deploy your Firebase project from the command line.
+The Firebase Command Line Interface (CLI) Tools can be used to test, manage, and deploy your Firebase project from the command line. This repository is also the home of the official Firebase MCP Server. For more information, please see the [Firebase MCP Server documentation](./src/mcp).
 
 - Deploy code and assets to your Firebase projects
 - Run a local web server for your Firebase Hosting site
@@ -87,9 +87,17 @@ These commands let you deploy and interact with your Firebase services.
 
 ### App Distribution Commands
 
-| Command                        | Description            |
-| ------------------------------ | ---------------------- |
-| **appdistribution:distribute** | Upload a distribution. |
+| Command                              | Description                                                                              |
+| ------------------------------------ | ---------------------------------------------------------------------------------------- |
+| **appdistribution:distribute**       | Upload a release binary and optionally distribute it to testers and run automated tests. |
+| **appdistribution:testers:list**     | List testers in project.                                                                 |
+| **appdistribution:testers:add**      | Add testers to project (and group, if specified via flag).                               |
+| **appdistribution:testers:remove**   | Remove testers from a project (or group, if specified via flag).                         |
+| **appdistribution:groups:list**      | List groups (of testers).                                                                |
+| **appdistribution:groups:create**    | Create a group (of testers).                                                             |
+| **appdistribution:groups:delete**    | Delete a group (of testers).                                                             |
+| **appdistribution:testcases:export** | Export test cases as a YAML file.                                                        |
+| **appdistribution:testcases:import** | Import test cases from YAML file.                                                        |
 
 ### Auth Commands
 

package/lib/apiv2.js

@@ -205,7 +205,12 @@ class Client {
             fetchOptions.agent = new proxy_agent_1.ProxyAgent();
         }
         if (options.signal) {
-            fetchOptions.signal = options.signal;
+            const signal = options.signal;
+            signal.reason = "";
+            signal.throwIfAborted = () => {
+                throw new error_1.FirebaseError("Aborted");
+            };
+            fetchOptions.signal = signal;
         }
         let reqTimeout;
         if (options.timeout) {
@@ -213,7 +218,12 @@ class Client {
             reqTimeout = setTimeout(() => {
                 controller.abort();
             }, options.timeout);
-            fetchOptions.signal = controller.signal;
+            const signal = controller.signal;
+            signal.reason = "";
+            signal.throwIfAborted = () => {
+                throw new error_1.FirebaseError("Aborted");
+            };
+            fetchOptions.signal = signal;
         }
         if (typeof options.body === "string" || isStream(options.body)) {
             fetchOptions.body = options.body;

package/lib/appdistribution/client.js

@@ -6,7 +6,6 @@ const operationPoller = require("../operation-poller");
 const error_1 = require("../error");
 const apiv2_1 = require("../apiv2");
 const api_1 = require("../api");
-const types_1 = require("./types");
 class AppDistributionClient {
     constructor() {
         this.appDistroV1Client = new apiv2_1.Client({
@@ -84,7 +83,7 @@ class AppDistributionClient {
             await this.appDistroV1Client.post(`/${releaseName}:distribute`, data);
         }
         catch (err) {
-            let errorMessage = err.message;
+            let errorMessage = (0, error_1.getErrMsg)(err);
             const errorStatus = (_c = (_b = (_a = err === null || err === void 0 ? void 0 : err.context) === null || _a === void 0 ? void 0 : _a.body) === null || _b === void 0 ? void 0 : _b.error) === null || _c === void 0 ? void 0 : _c.status;
             if (errorStatus === "FAILED_PRECONDITION") {
                 errorMessage = "invalid testers";
@@ -100,12 +99,10 @@ class AppDistributionClient {
     }
     async listTesters(projectName, groupName) {
         var _a;
-        const listTestersResponse = {
-            testers: [],
-        };
+        const testers = [];
         const client = this.appDistroV1Client;
-        let pageToken;
         const filter = groupName ? `groups=${projectName}/groups/${groupName}` : null;
+        let pageToken;
         do {
             const queryParams = pageToken ? { pageToken } : {};
             if (filter != null) {
@@ -118,10 +115,10 @@ class AppDistributionClient {
                 });
             }
             catch (err) {
-                throw new error_1.FirebaseError(`Client request failed to list testers ${err}`);
+                throw new error_1.FirebaseError(`Client request failed to list testers ${(0, error_1.getErrMsg)(err)}`);
             }
             for (const t of (_a = apiResponse.body.testers) !== null && _a !== void 0 ? _a : []) {
-                listTestersResponse.testers.push({
+                testers.push({
                     name: t.name,
                     displayName: t.displayName,
                     groups: t.groups,
@@ -130,7 +127,7 @@ class AppDistributionClient {
             }
             pageToken = apiResponse.body.nextPageToken;
         } while (pageToken);
-        return listTestersResponse;
+        return testers;
     }
     async addTesters(projectName, emails) {
         try {
@@ -161,9 +158,7 @@ class AppDistributionClient {
     }
     async listGroups(projectName) {
         var _a;
-        const listGroupsResponse = {
-            groups: [],
-        };
+        const groups = [];
         const client = this.appDistroV1Client;
         let pageToken;
         do {
@@ -172,14 +167,14 @@ class AppDistributionClient {
                 const apiResponse = await client.get(`${projectName}/groups`, {
                     queryParams,
                 });
-                listGroupsResponse.groups.push(...((_a = apiResponse.body.groups) !== null && _a !== void 0 ? _a : []));
+                groups.push(...((_a = apiResponse.body.groups) !== null && _a !== void 0 ? _a : []));
                 pageToken = apiResponse.body.nextPageToken;
             }
             catch (err) {
-                throw new error_1.FirebaseError(`Client failed to list groups ${err}`);
+                throw new error_1.FirebaseError(`Client failed to list groups ${(0, error_1.getErrMsg)(err)}`);
             }
         } while (pageToken);
-        return listGroupsResponse;
+        return groups;
     }
     async createGroup(projectName, displayName, alias) {
         let apiResponse;
@@ -239,7 +234,7 @@ class AppDistributionClient {
                 method: "POST",
                 path: `${releaseName}/tests`,
                 body: {
-                    deviceExecutions: devices.map(types_1.mapDeviceToExecution),
+                    deviceExecutions: devices.map((device) => ({ device })),
                     loginCredential,
                     testCase: testCaseName,
                 },
@@ -254,5 +249,56 @@ class AppDistributionClient {
         const response = await this.appDistroV1AlphaClient.get(releaseTestName);
         return response.body;
     }
+    async listTestCases(appName) {
+        var _a;
+        const testCases = [];
+        const client = this.appDistroV1AlphaClient;
+        let pageToken;
+        do {
+            const queryParams = pageToken ? { pageToken } : {};
+            try {
+                const apiResponse = await client.get(`${appName}/testCases`, {
+                    queryParams,
+                });
+                testCases.push(...((_a = apiResponse.body.testCases) !== null && _a !== void 0 ? _a : []));
+                pageToken = apiResponse.body.nextPageToken;
+            }
+            catch (err) {
+                throw new error_1.FirebaseError(`Client failed to list test cases ${(0, error_1.getErrMsg)(err)}`);
+            }
+        } while (pageToken);
+        return testCases;
+    }
+    async createTestCase(appName, testCase) {
+        try {
+            const response = await this.appDistroV1AlphaClient.request({
+                method: "POST",
+                path: `${appName}/testCases`,
+                body: testCase,
+            });
+            return response.body;
+        }
+        catch (err) {
+            throw new error_1.FirebaseError(`Failed to create test case ${(0, error_1.getErrMsg)(err)}`);
+        }
+    }
+    async batchUpsertTestCases(appName, testCases) {
+        try {
+            const response = await this.appDistroV1AlphaClient.request({
+                method: "POST",
+                path: `${appName}/testCases:batchUpdate`,
+                body: {
+                    requests: testCases.map((tc) => ({
+                        testCase: tc,
+                        allowMissing: true,
+                    })),
+                },
+            });
+            return response.body.testCases;
+        }
+        catch (err) {
+            throw new error_1.FirebaseError(`Failed to upsert test cases ${(0, error_1.getErrMsg)(err)}`);
+        }
+    }
 }
 exports.AppDistributionClient = AppDistributionClient;

package/lib/appdistribution/types.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapDeviceToExecution = exports.UploadReleaseResult = exports.IntegrationState = void 0;
+exports.UploadReleaseResult = exports.IntegrationState = void 0;
 var IntegrationState;
 (function (IntegrationState) {
     IntegrationState["AAB_INTEGRATION_STATE_UNSPECIFIED"] = "AAB_INTEGRATION_STATE_UNSPECIFIED";
@@ -18,14 +18,3 @@ var UploadReleaseResult;
     UploadReleaseResult["RELEASE_UPDATED"] = "RELEASE_UPDATED";
     UploadReleaseResult["RELEASE_UNMODIFIED"] = "RELEASE_UNMODIFIED";
 })(UploadReleaseResult = exports.UploadReleaseResult || (exports.UploadReleaseResult = {}));
-function mapDeviceToExecution(device) {
-    return {
-        device: {
-            model: device.model,
-            version: device.version,
-            orientation: device.orientation,
-            locale: device.locale,
-        },
-    };
-}
-exports.mapDeviceToExecution = mapDeviceToExecution;

package/lib/appdistribution/yaml_helper.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fromYaml = exports.toYaml = void 0;
+const jsYaml = require("js-yaml");
+const error_1 = require("../error");
+const ALLOWED_YAML_STEP_KEYS = new Set(["goal", "hint", "successCriteria"]);
+const ALLOWED_YAML_TEST_CASE_KEYS = new Set([
+    "displayName",
+    "id",
+    "prerequisiteTestCaseId",
+    "steps",
+]);
+function extractIdFromResourceName(name) {
+    var _a;
+    return (_a = name.split("/").pop()) !== null && _a !== void 0 ? _a : "";
+}
+function toYamlTestCases(testCases) {
+    return testCases.map((testCase) => (Object.assign(Object.assign({ displayName: testCase.displayName, id: extractIdFromResourceName(testCase.name) }, (testCase.prerequisiteTestCase && {
+        prerequisiteTestCaseId: extractIdFromResourceName(testCase.prerequisiteTestCase),
+    })), { steps: testCase.aiInstructions.steps.map((step) => (Object.assign(Object.assign({ goal: step.goal }, (step.hint && { hint: step.hint })), (step.successCriteria && { successCriteria: step.successCriteria })))) })));
+}
+function toYaml(testCases) {
+    return jsYaml.safeDump(toYamlTestCases(testCases));
+}
+exports.toYaml = toYaml;
+function castExists(it, thing) {
+    if (it == null) {
+        throw new error_1.FirebaseError(`"${thing}" is required`);
+    }
+    return it;
+}
+function checkAllowedKeys(allowedKeys, o) {
+    for (const key of Object.keys(o)) {
+        if (!allowedKeys.has(key)) {
+            throw new error_1.FirebaseError(`unexpected property "${key}"`);
+        }
+    }
+}
+function fromYamlTestCases(appName, yamlTestCases) {
+    return yamlTestCases.map((yamlTestCase) => {
+        checkAllowedKeys(ALLOWED_YAML_TEST_CASE_KEYS, yamlTestCase);
+        return Object.assign(Object.assign({ displayName: castExists(yamlTestCase.displayName, "displayName"), aiInstructions: {
+                steps: castExists(yamlTestCase.steps, "steps").map((yamlStep) => {
+                    checkAllowedKeys(ALLOWED_YAML_STEP_KEYS, yamlStep);
+                    return Object.assign(Object.assign({ goal: castExists(yamlStep.goal, "goal") }, (yamlStep.hint && { hint: yamlStep.hint })), (yamlStep.successCriteria && {
+                        successCriteria: yamlStep.successCriteria,
+                    }));
+                }),
+            } }, (yamlTestCase.id && {
+            name: `${appName}/testCases/${yamlTestCase.id}`,
+        })), (yamlTestCase.prerequisiteTestCaseId && {
+            prerequisiteTestCase: `${appName}/testCases/${yamlTestCase.prerequisiteTestCaseId}`,
+        }));
+    });
+}
+function fromYaml(appName, yaml) {
+    let parsedYaml;
+    try {
+        parsedYaml = jsYaml.safeLoad(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.");
+    }
+    return fromYamlTestCases(appName, parsedYaml);
+}
+exports.fromYaml = fromYaml;

package/lib/commands/appdistribution-groups-list.js

@@ -15,13 +15,12 @@ exports.command = new command_1.Command("appdistribution:groups:list")
     .alias("appdistribution:group:list")
     .before(requireAuth_1.requireAuth)
     .action(async (options) => {
-    var _a;
     const projectName = await (0, options_parser_util_1.getProjectName)(options);
     const appDistroClient = new client_1.AppDistributionClient();
-    let groupsResponse;
+    let groups;
     const spinner = ora("Preparing the list of your App Distribution Groups").start();
     try {
-        groupsResponse = await appDistroClient.listGroups(projectName);
+        groups = await appDistroClient.listGroups(projectName);
     }
     catch (err) {
         spinner.fail();
@@ -31,10 +30,9 @@ exports.command = new command_1.Command("appdistribution:groups:list")
         });
     }
     spinner.succeed();
-    const groups = (_a = groupsResponse.groups) !== null && _a !== void 0 ? _a : [];
     printGroupsTable(groups);
     utils.logSuccess(`Groups listed successfully`);
-    return groupsResponse;
+    return { groups };
 });
 function printGroupsTable(groups) {
     const tableHead = ["Group", "Display Name", "Tester Count", "Release Count", "Invite Link Count"];

package/lib/commands/appdistribution-testcases-export.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
+const fs = require("fs-extra");
+const command_1 = require("../command");
+const yaml_helper_1 = require("../appdistribution/yaml_helper");
+const requireAuth_1 = require("../requireAuth");
+const client_1 = require("../appdistribution/client");
+const options_parser_util_1 = require("../appdistribution/options-parser-util");
+const error_1 = require("../error");
+const utils = require("../utils");
+exports.command = new command_1.Command("appdistribution:testcases:export <test-cases-yaml-file>")
+    .description("export test cases as a YAML file")
+    .option("--app <app_id>", "the app id of your Firebase app")
+    .before(requireAuth_1.requireAuth)
+    .action(async (yamlFile, options) => {
+    const appName = (0, options_parser_util_1.getAppName)(options);
+    const appDistroClient = new client_1.AppDistributionClient();
+    let testCases;
+    try {
+        testCases = await appDistroClient.listTestCases(appName);
+    }
+    catch (err) {
+        throw new error_1.FirebaseError("Failed to list test cases.", {
+            exit: 1,
+            original: err,
+        });
+    }
+    fs.writeFileSync(yamlFile, (0, yaml_helper_1.toYaml)(testCases), "utf8");
+    utils.logSuccess(`Exported ${testCases.length} test cases to ${yamlFile}`);
+    return { testCases };
+});

package/lib/commands/appdistribution-testcases-import.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
+const fs = require("fs-extra");
+const command_1 = require("../command");
+const yaml_helper_1 = require("../appdistribution/yaml_helper");
+const requireAuth_1 = require("../requireAuth");
+const client_1 = require("../appdistribution/client");
+const options_parser_util_1 = require("../appdistribution/options-parser-util");
+const utils = require("../utils");
+const error_1 = require("../error");
+exports.command = new command_1.Command("appdistribution:testcases:import <test-cases-yaml-file>")
+    .description("import test cases from YAML file")
+    .option("--app <app_id>", "the app id of your Firebase app")
+    .before(requireAuth_1.requireAuth)
+    .action(async (yamlFile, options) => {
+    const appName = (0, options_parser_util_1.getAppName)(options);
+    const appDistroClient = new client_1.AppDistributionClient();
+    (0, options_parser_util_1.ensureFileExists)(yamlFile);
+    const testCases = (0, yaml_helper_1.fromYaml)(appName, fs.readFileSync(yamlFile, "utf8"));
+    const testCasesWithoutName = testCases.filter((tc) => !tc.name);
+    const creationResults = await Promise.allSettled(testCasesWithoutName.map((tc) => appDistroClient.createTestCase(appName, tc)));
+    const failed = creationResults.filter((r) => r.status === "rejected");
+    if (failed.length > 0) {
+        for (const f of failed) {
+            utils.logWarning(f.reason);
+        }
+        const succeeded = creationResults.length - failed.length;
+        throw new error_1.FirebaseError(`Created ${succeeded} test case(s), but failed to create ${failed.length}.`);
+    }
+    const testCasesWithName = testCases.filter((tc) => !!tc.name);
+    await appDistroClient.batchUpsertTestCases(appName, testCasesWithName);
+    utils.logSuccess(`Imported ${testCases.length} test cases from ${yamlFile}`);
+});

package/lib/commands/appdistribution-testers-list.js

@@ -14,13 +14,12 @@ exports.command = new command_1.Command("appdistribution:testers:list [group]")
     .description("list testers in project")
     .before(requireAuth_1.requireAuth)
     .action(async (group, options) => {
-    var _a;
     const projectName = await (0, options_parser_util_1.getProjectName)(options);
     const appDistroClient = new client_1.AppDistributionClient();
-    let testersResponse;
+    let testers;
     const spinner = ora("Preparing the list of your App Distribution testers").start();
     try {
-        testersResponse = await appDistroClient.listTesters(projectName, group);
+        testers = await appDistroClient.listTesters(projectName, group);
     }
     catch (err) {
         spinner.fail();
@@ -30,10 +29,9 @@ exports.command = new command_1.Command("appdistribution:testers:list [group]")
         });
     }
     spinner.succeed();
-    const testers = (_a = testersResponse.testers) !== null && _a !== void 0 ? _a : [];
     printTestersTable(testers);
     utils.logSuccess(`Testers listed successfully`);
-    return testersResponse;
+    return { testers };
 });
 function printTestersTable(testers) {
     var _a, _b;

package/lib/commands/index.js

@@ -20,11 +20,14 @@ function load(client) {
     client.appdistribution.testers.list = loadCommand("appdistribution-testers-list");
     client.appdistribution.testers.add = loadCommand("appdistribution-testers-add");
     client.appdistribution.testers.delete = loadCommand("appdistribution-testers-remove");
-    client.appdistribution.group = {};
-    client.appdistribution.group.list = loadCommand("appdistribution-groups-list");
-    client.appdistribution.group.create = loadCommand("appdistribution-groups-create");
-    client.appdistribution.group.delete = loadCommand("appdistribution-groups-delete");
-    client.appdistribution.groups = client.appdistribution.group;
+    client.appdistribution.groups = {};
+    client.appdistribution.groups.list = loadCommand("appdistribution-groups-list");
+    client.appdistribution.groups.create = loadCommand("appdistribution-groups-create");
+    client.appdistribution.groups.delete = loadCommand("appdistribution-groups-delete");
+    client.appdistribution.group = client.appdistribution.groups;
+    client.appdistribution.testCases = {};
+    client.appdistribution.testCases.export = loadCommand("appdistribution-testcases-export");
+    client.appdistribution.testCases.import = loadCommand("appdistribution-testcases-import");
     client.apps = {};
     client.apps.create = loadCommand("apps-create");
     client.apps.list = loadCommand("apps-list");

package/lib/commands/init.js

@@ -105,13 +105,11 @@ if ((0, experiments_1.isEnabled)("apptesting")) {
         checked: false,
     });
 }
-if ((0, experiments_1.isEnabled)("ailogic")) {
-    choices.push({
-        value: "ailogic",
-        name: "AI Logic: Set up Firebase AI Logic with app provisioning",
-        checked: false,
-    });
-}
+choices.push({
+    value: "ailogic",
+    name: "AI Logic: Set up Firebase AI Logic with app provisioning",
+    checked: false,
+});
 choices.push({
     value: "aitools",
     name: "AI Tools: Configure AI coding assistants to work with your Firebase project",

package/lib/emulator/auth/operations.js

@@ -10,6 +10,7 @@ const errors_1 = require("./errors");
 const types_1 = require("../types");
 const emulatorLogger_1 = require("../emulatorLogger");
 const state_1 = require("./state");
+const error_1 = require("../../error");
 exports.authOperations = {
     identitytoolkit: {
         getProjects,
@@ -2054,11 +2055,16 @@ async function fetchBlockingFunction(state, event, user, options = {}, oauthToke
     let status;
     let text;
     try {
+        const signal = controller.signal;
+        signal.reason = "";
+        signal.throwIfAborted = () => {
+            throw new error_1.FirebaseError("Aborted");
+        };
         const res = await (0, node_fetch_1.default)(url, {
             method: "POST",
             headers: { "Content-Type": "application/json" },
             body: JSON.stringify(reqBody),
-            signal: controller.signal,
+            signal,
         });
         ok = res.ok;
         status = res.status;

package/lib/emulator/downloadableEmulatorInfo.json

@@ -44,38 +44,38 @@
         }
     },
     "pubsub": {
-        "version": "0.8.14",
-        "expectedSize": 66786933,
-        "expectedChecksum": "a9025b3e53fdeafd2969ccb3ba1e1d38",
-        "expectedChecksumSHA256": "4fbeefd8ecb32b10e5ab522e5d8748e0c2b13891c471c0c327c04632dcc75a8d",
-        "remoteUrl": "https://storage.googleapis.com/firebase-preview-drop/emulator/pubsub-emulator-0.8.14.zip",
-        "downloadPathRelativeToCacheDir": "pubsub-emulator-0.8.14.zip",
-        "binaryPathRelativeToCacheDir": "pubsub-emulator-0.8.14/pubsub-emulator/bin/cloud-pubsub-emulator"
+        "version": "0.8.17",
+        "expectedSize": 65162324,
+        "expectedChecksum": "a88ec6424e49af459b5c8a3657d69c06",
+        "expectedChecksumSHA256": "72a49d14ee6cd4c1a0fee4a46f520fe4d7465396a155c61abc0103905047edd3",
+        "remoteUrl": "https://storage.googleapis.com/firebase-preview-drop/emulator/pubsub-emulator-0.8.17.zip",
+        "downloadPathRelativeToCacheDir": "pubsub-emulator-0.8.17.zip",
+        "binaryPathRelativeToCacheDir": "pubsub-emulator-0.8.17/pubsub-emulator/bin/cloud-pubsub-emulator"
     },
     "dataconnect": {
         "darwin": {
-            "version": "2.15.1",
-            "expectedSize": 29946720,
-            "expectedChecksum": "cc8d5dd053cc71adad0f640ac2627018",
-            "expectedChecksumSHA256": "a3749396507678bc546987ef047a9d0c25145064503a9adc777229f1bc9b8c6f",
-            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-macos-v2.15.1",
-            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.15.1"
+            "version": "2.16.0",
+            "expectedSize": 29963104,
+            "expectedChecksum": "ee4d81abfba3576c7c6c8082313acfd0",
+            "expectedChecksumSHA256": "8aed1dc6cc8c35ab23fdf10e519e9cf3d93c8a0ccb0ff7d5af3ddc41a4847e3e",
+            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-macos-amd64-v2.16.0",
+            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.16.0"
         },
         "win32": {
-            "version": "2.15.1",
-            "expectedSize": 30440960,
-            "expectedChecksum": "57390c392101a13952ff2aea74b62787",
-            "expectedChecksumSHA256": "905a9ab2200189dc31f23b5454d21803b0c672442f0ee4bb7db8286d159a86e0",
-            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-windows-v2.15.1",
-            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.15.1.exe"
+            "version": "2.16.0",
+            "expectedSize": 30456320,
+            "expectedChecksum": "546019a713be28620a3b43d49fc9d4b0",
+            "expectedChecksumSHA256": "ec1de720e173f0a613fbbb51767c0288121aa2f80e45e6bad0f3d2aff12689ec",
+            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-windows-amd64-v2.16.0",
+            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.16.0.exe"
         },
         "linux": {
-            "version": "2.15.1",
-            "expectedSize": 29868216,
-            "expectedChecksum": "cc6ef676d8c5c3a3f74c0bf037083cf0",
-            "expectedChecksumSHA256": "1dfe085c467637ebf6a71cc6c8e8bc11fac85202056b960633607627bd647a6d",
-            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-linux-v2.15.1",
-            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.15.1"
+            "version": "2.16.0",
+            "expectedSize": 29888696,
+            "expectedChecksum": "5ab8da956043a48b43199f07b94ac48c",
+            "expectedChecksumSHA256": "1a420f3d2672627eae2d9b0b6747b833517cfc08f7e80ae3a79389788691b67a",
+            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-linux-amd64-v2.16.0",
+            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.16.0"
         }
     }
 }

package/lib/emulator/functionsEmulatorRuntime.js

@@ -240,6 +240,10 @@ function initializeNetworkFiltering() {
 }
 async function initializeFirebaseFunctionsStubs() {
     const firebaseFunctionsResolution = await assertResolveDeveloperNodeModule("firebase-functions");
+    if ((0, functionsEmulatorUtils_1.compareVersionStrings)(firebaseFunctionsResolution.version, "7.0.0") >= 0) {
+        logDebug("Detected firebase-functions v7+, skipping legacy stubs.");
+        return;
+    }
     const firebaseFunctionsRoot = (0, functionsEmulatorShared_1.findModuleRoot)("firebase-functions", firebaseFunctionsResolution.resolution);
     const httpsProviderResolution = path.join(firebaseFunctionsRoot, "lib/providers/https");
     const httpsProviderV1Resolution = path.join(firebaseFunctionsRoot, "lib/v1/providers/https");
@@ -451,6 +455,10 @@ function warnAboutStorageProd() {
 }
 async function initializeFunctionsConfigHelper() {
     const functionsResolution = await assertResolveDeveloperNodeModule("firebase-functions");
+    if ((0, functionsEmulatorUtils_1.compareVersionStrings)(functionsResolution.version, "7.0.0") >= 0) {
+        logDebug("Detected firebase-functions v7+, skipping config helper.");
+        return;
+    }
     const localFunctionsModule = require(functionsResolution.resolution);
     logDebug("Checked functions.config()", {
         config: localFunctionsModule.config(),

package/lib/emulator/taskQueue.js

@@ -4,6 +4,7 @@ exports.TaskQueue = exports.TaskStatus = exports.Queue = void 0;
 const abort_controller_1 = require("abort-controller");
 const emulatorLogger_1 = require("./emulatorLogger");
 const types_1 = require("./types");
+const error_1 = require("../error");
 const node_fetch_1 = require("node-fetch");
 class Node {
     constructor(data) {
@@ -198,6 +199,10 @@ class TaskQueue {
             }
             const controller = new abort_controller_1.default();
             const signal = controller.signal;
+            signal.reason = "";
+            signal.throwIfAborted = () => {
+                throw new error_1.FirebaseError("Aborted");
+            };
             const request = (0, node_fetch_1.default)(emulatedTask.task.httpRequest.url, {
                 method: "POST",
                 headers: headers,

package/lib/experiments.js

@@ -118,12 +118,6 @@ exports.ALL_EXPERIMENTS = experiments({
         shortDescription: "Adds experimental App Testing feature",
         public: true,
     },
-    ailogic: {
-        shortDescription: "Enable Firebase AI Logic feature for existing apps",
-        fullDescription: "Enables the AI Logic initialization feature that provisions AI Logic for existing Firebase apps.",
-        public: true,
-        default: false,
-    },
 });
 function isValidExperiment(name) {
     return Object.keys(exports.ALL_EXPERIMENTS).includes(name);

package/lib/firestore/api.js

@@ -22,16 +22,34 @@ class FirestoreApi {
         this.printer = new pretty_print_1.PrettyPrint();
     }
     static processIndex(index) {
-        var _a, _b, _c;
-        const fields = index.fields;
+        var _a;
+        let fields = index.fields;
+        const suffixOrder = FirestoreApi.lastIndexFieldOrder(fields);
+        const nameSuffix = { fieldPath: "__name__", order: suffixOrder };
         const lastField = (_a = index.fields) === null || _a === void 0 ? void 0 : _a[index.fields.length - 1];
+        if (lastField.vectorConfig) {
+            const vectorField = lastField;
+            fields = fields.slice(0, -1);
+            if (fields.length === 0 || (fields === null || fields === void 0 ? void 0 : fields[fields.length - 1].fieldPath) !== "__name__") {
+                fields.push(nameSuffix);
+            }
+            fields.push(vectorField);
+            return Object.assign(Object.assign({}, index), { fields });
+        }
         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 - 1]) === null || _c === void 0 ? void 0 : _c.order;
-            const nameSuffix = { fieldPath: "__name__", order: defaultDirection };
             fields.push(nameSuffix);
         }
         return Object.assign(Object.assign({}, index), { fields });
     }
+    static lastIndexFieldOrder(fields) {
+        let lastIndexFieldOrder = types.Order.ASCENDING;
+        for (const field of fields) {
+            if (field.order) {
+                lastIndexFieldOrder = field.order;
+            }
+        }
+        return lastIndexFieldOrder;
+    }
     async deploy(options, indexes, fieldOverrides, databaseId = "(default)") {
         var _a;
         const spec = this.upgradeOldSpec({

package/lib/init/features/hosting/github.js

@@ -29,11 +29,11 @@ const HOSTING_GITHUB_ACTION_NAME = "FirebaseExtended/action-hosting-deploy@v0";
 const SERVICE_ACCOUNT_MAX_KEY_NUMBER = 10;
 const githubApiClient = new apiv2_1.Client({ urlPrefix: (0, api_1.githubApiOrigin)(), auth: false });
 async function initGitHub(setup) {
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d, _e, _f, _g;
     if (!setup.projectId) {
         return (0, utils_1.reject)("Could not determine Project ID, can't set up GitHub workflow.", { exit: 1 });
     }
-    if (!setup.config.hosting) {
+    if (!setup.config.hosting && !((_a = setup.featureInfo) === null || _a === void 0 ? void 0 : _a.hosting)) {
         return (0, utils_1.reject)(`Didn't find a Hosting config in firebase.json. Run ${(0, colorette_1.bold)("firebase init hosting")} instead.`);
     }
     logger_1.logger.info();
@@ -67,10 +67,10 @@ async function initGitHub(setup) {
     (0, utils_1.logSuccess)(`Uploaded service account JSON to GitHub as secret ${(0, colorette_1.bold)(githubSecretName)}.`);
     (0, utils_1.logBullet)(`You can manage your secrets at https://github.com/${repo}/settings/secrets.`);
     logger_1.logger.info();
-    if (!Array.isArray(setup.config.hosting) && setup.config.hosting.predeploy) {
+    if (!Array.isArray(setup.config.hosting) && ((_b = setup.config.hosting) === null || _b === void 0 ? void 0 : _b.predeploy)) {
         (0, utils_1.logBullet)(`You have a predeploy script configured in firebase.json.`);
     }
-    const { script } = await promptForBuildScript((_a = setup === null || setup === void 0 ? void 0 : setup.hosting) === null || _a === void 0 ? void 0 : _a.useWebFrameworks);
+    const { script } = await promptForBuildScript((_c = setup === null || setup === void 0 ? void 0 : setup.hosting) === null || _c === void 0 ? void 0 : _c.useWebFrameworks);
     const ymlDeployDoc = loadYMLDeploy();
     let shouldWriteYMLHostingFile = true;
     let shouldWriteYMLDeployFile = false;
@@ -81,7 +81,7 @@ async function initGitHub(setup) {
         shouldWriteYMLHostingFile = overwrite;
     }
     if (shouldWriteYMLHostingFile) {
-        writeChannelActionYMLFile(YML_FULL_PATH_PULL_REQUEST, githubSecretName, setup.projectId, script, (_b = setup === null || setup === void 0 ? void 0 : setup.hosting) === null || _b === void 0 ? void 0 : _b.useWebFrameworks, (_c = setup === null || setup === void 0 ? void 0 : setup.hosting) === null || _c === void 0 ? void 0 : _c.source);
+        writeChannelActionYMLFile(YML_FULL_PATH_PULL_REQUEST, githubSecretName, setup.projectId, script, (_d = setup === null || setup === void 0 ? void 0 : setup.hosting) === null || _d === void 0 ? void 0 : _d.useWebFrameworks, (_e = setup === null || setup === void 0 ? void 0 : setup.hosting) === null || _e === void 0 ? void 0 : _e.source);
         logger_1.logger.info();
         (0, utils_1.logSuccess)(`Created workflow file ${(0, colorette_1.bold)(YML_FULL_PATH_PULL_REQUEST)}`);
     }
@@ -101,7 +101,7 @@ async function initGitHub(setup) {
             shouldWriteYMLDeployFile = true;
         }
         if (shouldWriteYMLDeployFile) {
-            writeDeployToProdActionYMLFile(YML_FULL_PATH_MERGE, branch, githubSecretName, setup.projectId, script, (_d = setup === null || setup === void 0 ? void 0 : setup.hosting) === null || _d === void 0 ? void 0 : _d.useWebFrameworks, (_e = setup === null || setup === void 0 ? void 0 : setup.hosting) === null || _e === void 0 ? void 0 : _e.source);
+            writeDeployToProdActionYMLFile(YML_FULL_PATH_MERGE, branch, githubSecretName, setup.projectId, script, (_f = setup === null || setup === void 0 ? void 0 : setup.hosting) === null || _f === void 0 ? void 0 : _f.useWebFrameworks, (_g = setup === null || setup === void 0 ? void 0 : setup.hosting) === null || _g === void 0 ? void 0 : _g.source);
             logger_1.logger.info();
             (0, utils_1.logSuccess)(`Created workflow file ${(0, colorette_1.bold)(YML_FULL_PATH_MERGE)}`);
         }

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

@@ -48,10 +48,10 @@ async function askQuestions(setup, config, options) {
             setup.featureInfo.hosting.newSiteId = await (0, interactive_1.pickHostingSiteName)("", createOptions);
         }
     }
+    let discoveredFramework = experiments.isEnabled("webframeworks")
+        ? await (0, frameworks_1.discover)(config.projectDir, false)
+        : undefined;
     if (experiments.isEnabled("webframeworks")) {
-        let discoveredFramework = experiments.isEnabled("webframeworks")
-            ? await (0, frameworks_1.discover)(config.projectDir, false)
-            : undefined;
         if (discoveredFramework &&
             (await (0, prompt_1.confirm)({
                 message: `Detected an existing ${frameworks_1.WebFrameworks[discoveredFramework.framework].name} codebase in the current directory, do you want to use this?`,
@@ -65,43 +65,43 @@ async function askQuestions(setup, config, options) {
         else {
             setup.featureInfo.hosting.useWebFrameworks = await (0, prompt_1.confirm)(`Do you want to use a web framework? (${clc.bold("experimental")})`);
         }
-        if (setup.featureInfo.hosting.useWebFrameworks) {
-            (_a = (_g = setup.featureInfo.hosting).source) !== null && _a !== void 0 ? _a : (_g.source = await (0, prompt_1.input)({
-                message: "What folder would you like to use for your web application's root directory?",
-                default: "hosting",
+    }
+    if (setup.featureInfo.hosting.useWebFrameworks) {
+        (_a = (_g = setup.featureInfo.hosting).source) !== null && _a !== void 0 ? _a : (_g.source = await (0, prompt_1.input)({
+            message: "What folder would you like to use for your web application's root directory?",
+            default: "hosting",
+        }));
+        discoveredFramework = await (0, frameworks_1.discover)((0, path_1.join)(config.projectDir, setup.featureInfo.hosting.source));
+        if (discoveredFramework) {
+            const name = frameworks_1.WebFrameworks[discoveredFramework.framework].name;
+            (_b = (_h = setup.featureInfo.hosting).useDiscoveredFramework) !== null && _b !== void 0 ? _b : (_h.useDiscoveredFramework = await (0, prompt_1.confirm)({
+                message: `Detected an existing ${name} codebase in ${setup.featureInfo.hosting.source}, should we use this?`,
+                default: true,
             }));
-            discoveredFramework = await (0, frameworks_1.discover)((0, path_1.join)(config.projectDir, setup.featureInfo.hosting.source));
-            if (discoveredFramework) {
-                const name = frameworks_1.WebFrameworks[discoveredFramework.framework].name;
-                (_b = (_h = setup.featureInfo.hosting).useDiscoveredFramework) !== null && _b !== void 0 ? _b : (_h.useDiscoveredFramework = await (0, prompt_1.confirm)({
-                    message: `Detected an existing ${name} codebase in ${setup.featureInfo.hosting.source}, should we use this?`,
-                    default: true,
-                }));
-                if (setup.featureInfo.hosting.useDiscoveredFramework)
-                    setup.featureInfo.hosting.webFramework = discoveredFramework.framework;
-            }
-            const choices = [];
-            for (const value in frameworks_1.WebFrameworks) {
-                if (frameworks_1.WebFrameworks[value]) {
-                    const { name, init } = frameworks_1.WebFrameworks[value];
-                    if (init)
-                        choices.push({ name, value });
-                }
+            if (setup.featureInfo.hosting.useDiscoveredFramework)
+                setup.featureInfo.hosting.webFramework = discoveredFramework.framework;
+        }
+        const choices = [];
+        for (const value in frameworks_1.WebFrameworks) {
+            if (frameworks_1.WebFrameworks[value]) {
+                const { name, init } = frameworks_1.WebFrameworks[value];
+                if (init)
+                    choices.push({ name, value });
             }
-            const defaultChoice = (_c = choices.find(({ value }) => value === (discoveredFramework === null || discoveredFramework === void 0 ? void 0 : discoveredFramework.framework))) === null || _c === void 0 ? void 0 : _c.value;
-            (_d = (_j = setup.featureInfo.hosting).webFramework) !== null && _d !== void 0 ? _d : (_j.webFramework = await (0, prompt_1.select)({
-                message: "Please choose the framework:",
-                default: defaultChoice,
-                choices,
-            }));
-            setup.featureInfo.hosting.region =
-                setup.featureInfo.hosting.region ||
-                    (await (0, prompt_1.select)({
-                        message: "In which region would you like to host server-side content, if applicable?",
-                        default: constants_1.DEFAULT_REGION,
-                        choices: constants_1.ALLOWED_SSR_REGIONS.filter((region) => region.recommended),
-                    }));
         }
+        const defaultChoice = (_c = choices.find(({ value }) => value === (discoveredFramework === null || discoveredFramework === void 0 ? void 0 : discoveredFramework.framework))) === null || _c === void 0 ? void 0 : _c.value;
+        (_d = (_j = setup.featureInfo.hosting).webFramework) !== null && _d !== void 0 ? _d : (_j.webFramework = await (0, prompt_1.select)({
+            message: "Please choose the framework:",
+            default: defaultChoice,
+            choices,
+        }));
+        setup.featureInfo.hosting.region =
+            setup.featureInfo.hosting.region ||
+                (await (0, prompt_1.select)({
+                    message: "In which region would you like to host server-side content, if applicable?",
+                    default: constants_1.DEFAULT_REGION,
+                    choices: constants_1.ALLOWED_SSR_REGIONS.filter((region) => region.recommended),
+                }));
     }
     else {
         logger_1.logger.info();

package/lib/management/provisioning/errorHandler.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enhanceProvisioningError = void 0;
+const error_1 = require("../../error");
+function isErrorInfo(detail) {
+    return detail["@type"] === "type.googleapis.com/google.rpc.ErrorInfo";
+}
+function isHelpLinks(detail) {
+    return detail["@type"] === "type.googleapis.com/google.rpc.Help";
+}
+function extractErrorDetails(err) {
+    var _a;
+    if (!(err instanceof Error)) {
+        return "";
+    }
+    if (err instanceof error_1.FirebaseError && err.context) {
+        const context = err.context;
+        const errorBody = (_a = context.body) === null || _a === void 0 ? void 0 : _a.error;
+        if ((errorBody === null || errorBody === void 0 ? void 0 : errorBody.details) && Array.isArray(errorBody.details)) {
+            const parts = [];
+            for (const detail of errorBody.details) {
+                if (isErrorInfo(detail)) {
+                    parts.push(`Error details:`);
+                    parts.push(`  Reason: ${detail.reason}`);
+                    parts.push(`  Domain: ${detail.domain}`);
+                    if (detail.metadata) {
+                        parts.push(`  Additional Info: ${JSON.stringify(detail.metadata)}`);
+                    }
+                }
+                else if (isHelpLinks(detail)) {
+                    parts.push(`\nFor help resolving this issue:`);
+                    for (const link of detail.links) {
+                        parts.push(`  - ${link.description}`);
+                        parts.push(`    ${link.url}`);
+                    }
+                }
+            }
+            return parts.length > 0 ? `\n\n${parts.join("\n")}` : "";
+        }
+    }
+    return "";
+}
+function enhanceProvisioningError(err, contextMessage) {
+    const originalError = (0, error_1.getError)(err);
+    const errorDetails = extractErrorDetails(err);
+    const fullMessage = errorDetails
+        ? `${contextMessage}: ${originalError.message}${errorDetails}`
+        : `${contextMessage}: ${originalError.message}`;
+    return new error_1.FirebaseError(fullMessage, {
+        exit: 2,
+        original: originalError,
+    });
+}
+exports.enhanceProvisioningError = enhanceProvisioningError;

package/lib/management/provisioning/provision.js

@@ -7,6 +7,7 @@ const error_1 = require("../../error");
 const logger_1 = require("../../logger");
 const operation_poller_1 = require("../../operation-poller");
 const apps_1 = require("../apps");
+const errorHandler_1 = require("./errorHandler");
 const apiClient = new apiv2_1.Client({
     urlPrefix: (0, api_1.firebaseApiOrigin)(),
     apiVersion: "v1alpha",
@@ -100,11 +101,7 @@ async function provisionFirebaseApp(options) {
         return result;
     }
     catch (err) {
-        const errorMessage = err instanceof Error ? err.message : String(err);
-        throw new error_1.FirebaseError(`Failed to provision Firebase app: ${errorMessage}`, {
-            exit: 2,
-            original: err instanceof Error ? err : new Error(String(err)),
-        });
+        throw (0, errorHandler_1.enhanceProvisioningError)(err, "Failed to provision Firebase app");
     }
 }
 exports.provisionFirebaseApp = provisionFirebaseApp;

package/lib/mcp/tools/functions/index.js

@@ -2,4 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.functionsTools = void 0;
 const get_logs_1 = require("./get_logs");
-exports.functionsTools = [get_logs_1.get_logs];
+const list_functions_1 = require("./list_functions");
+exports.functionsTools = [get_logs_1.get_logs, list_functions_1.list_functions];

package/lib/mcp/tools/functions/list_functions.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.list_functions = void 0;
+const zod_1 = require("zod");
+const tool_1 = require("../../tool");
+const util_1 = require("../../util");
+const backend = require("../../../deploy/functions/backend");
+const error_1 = require("../../../error");
+exports.list_functions = (0, tool_1.tool)("functions", {
+    name: "list_functions",
+    description: "List all deployed functions in your Firebase project.",
+    inputSchema: zod_1.z.object({}),
+    annotations: {
+        title: "List Deployed Functions",
+        readOnlyHint: true,
+        openWorldHint: true,
+    },
+    _meta: {
+        requiresAuth: true,
+        requiresProject: true,
+    },
+}, async (_, { projectId }) => {
+    const context = {
+        projectId,
+    };
+    try {
+        const existing = await backend.existingBackend(context);
+        const endpointsList = backend.allEndpoints(existing).sort(backend.compareFunctions);
+        const formattedList = endpointsList.map((endpoint) => ({
+            function: endpoint.id,
+            version: endpoint.platform === "gcfv2" ? "v2" : "v1",
+            trigger: backend.endpointTriggerType(endpoint),
+            location: endpoint.region,
+            memory: endpoint.availableMemoryMb || "---",
+            runtime: endpoint.runtime,
+        }));
+        if (!formattedList.length) {
+            return (0, util_1.toContent)([], {
+                contentPrefix: "No functions found in this project.\n\n",
+            });
+        }
+        return (0, util_1.toContent)(formattedList);
+    }
+    catch (err) {
+        const errMsg = (0, error_1.getErrMsg)((err === null || err === void 0 ? void 0 : err.original) || err, "Failed to list functions.");
+        return (0, util_1.mcpError)(errMsg);
+    }
+});

package/lib/utils.js

@@ -357,7 +357,10 @@ function datetimeString(d) {
 }
 exports.datetimeString = datetimeString;
 function isCloudEnvironment() {
-    return !!process.env.CODESPACES || !!process.env.GOOGLE_CLOUD_WORKSTATIONS;
+    return (!!process.env.CODESPACES ||
+        !!process.env.GOOGLE_CLOUD_WORKSTATIONS ||
+        !!process.env.CLOUD_SHELL ||
+        !!process.env.GOOGLE_CLOUD_SHELL);
 }
 exports.isCloudEnvironment = isCloudEnvironment;
 function isRunningInWSL() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firebase-tools",
-  "version": "14.22.0",
+  "version": "14.23.0",
   "description": "Command-Line Interface for Firebase",
   "main": "./lib/index.js",
   "bin": {
@@ -66,7 +66,7 @@
     "@electric-sql/pglite": "^0.3.3",
     "@electric-sql/pglite-tools": "^0.2.8",
     "@google-cloud/cloud-sql-connector": "^1.3.3",
-    "@google-cloud/pubsub": "^4.5.0",
+    "@google-cloud/pubsub": "^4.11.0",
     "@inquirer/prompts": "^7.4.0",
     "@modelcontextprotocol/sdk": "^1.10.2",
     "abort-controller": "^3.0.0",

package/schema/firebase-config.json

@@ -1090,7 +1090,6 @@
     },
     "properties": {
         "$schema": {
-            "format": "uri",
             "type": "string"
         },
         "apphosting": {