firebase-tools 14.15.2 → 14.17.0

package/lib/mcp/tools/dataconnect/{info.js → list_services.js}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.info = void 0;
+exports.list_services = void 0;
 const zod_1 = require("zod");
 const path = require("path");
 const tool_1 = require("../../tool");
@@ -9,12 +9,12 @@ const client = require("../../../dataconnect/client");
 const load_1 = require("../../../dataconnect/load");
 const js_yaml_1 = require("js-yaml");
 const logger_1 = require("../../../logger");
-exports.info = (0, tool_1.tool)({
-    name: "info",
-    description: "Get information about the Firebase Data Connect local and deployed resources.",
+exports.list_services = (0, tool_1.tool)({
+    name: "list_services",
+    description: "List existing local and backend Firebase Data Connect services",
     inputSchema: zod_1.z.object({}),
     annotations: {
-        title: "Get information about Firebase Data Connect",
+        title: "List existing Firebase Data Connect services",
         readOnlyHint: true,
     },
     _meta: {

package/lib/mcp/util.js

@@ -1,9 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.cleanSchema = exports.checkFeatureActive = exports.commandExistsSync = exports.mcpError = exports.toContent = void 0;
-const child_process_1 = require("child_process");
+exports.cleanSchema = exports.checkFeatureActive = exports.mcpError = exports.toContent = void 0;
 const js_yaml_1 = require("js-yaml");
-const os_1 = require("os");
 const api_1 = require("../api");
 const ensureApiEnabled_1 = require("../ensureApiEnabled");
 const timeout_1 = require("../timeout");
@@ -41,20 +39,6 @@ function mcpError(message, code) {
     };
 }
 exports.mcpError = mcpError;
-function commandExistsSync(command) {
-    try {
-        const isWindows = (0, os_1.platform)() === "win32";
-        const commandToCheck = isWindows
-            ? `where "${command}" > nul 2> nul`
-            : `which "${command}" > /dev/null 2> /dev/null`;
-        (0, child_process_1.execSync)(commandToCheck);
-        return true;
-    }
-    catch (error) {
-        return false;
-    }
-}
-exports.commandExistsSync = commandExistsSync;
 const SERVER_FEATURE_APIS = {
     core: "",
     firestore: (0, api_1.firestoreOrigin)(),

package/lib/serve/functions.js

@@ -21,11 +21,12 @@ class FunctionsServer {
         const config = projectConfig.normalizeAndValidate(options.config.src.functions);
         const backends = [];
         for (const cfg of config) {
-            const functionsDir = path.join(options.config.projectDir, cfg.source);
+            const localCfg = projectConfig.requireLocal(cfg, "Remote sources are not supported in the Functions emulator.");
+            const functionsDir = path.join(options.config.projectDir, localCfg.source);
             backends.push({
                 functionsDir,
-                codebase: cfg.codebase,
-                runtime: cfg.runtime,
+                codebase: localCfg.codebase,
+                runtime: localCfg.runtime,
                 env: {},
                 secretEnv: [],
             });

package/lib/unzip.js

@@ -57,6 +57,9 @@ const extractEntriesFromBuffer = async (data, outputDir) => {
         logger_1.logger.debug(`[unzip] Entry: ${entry.fileName} (compressed_size=${entry.compressedSize} bytes, uncompressed_size=${entry.uncompressedSize} bytes)`);
         entry.fileName = entry.fileName.replace(/\//g, path.sep);
         const outputFilePath = path.normalize(path.join(outputDir, entry.fileName));
+        if (!isChildDir(outputDir, outputFilePath)) {
+            throw new error_1.FirebaseError(`ZIP contained an entry for ${outputFilePath},  a path outside of ${outputDir}`);
+        }
         logger_1.logger.debug(`[unzip] Processing entry: ${entry.fileName}`);
         if (entry.fileName.endsWith(path.sep)) {
             logger_1.logger.debug(`[unzip] mkdir: ${outputFilePath}`);
@@ -82,6 +85,16 @@ const extractEntriesFromBuffer = async (data, outputDir) => {
         position += entry.headerSize + entry.compressedSize + dataDescriptorSize;
     }
 };
+function isChildDir(parentDir, potentialChild) {
+    try {
+        const resolvedParent = path.resolve(parentDir);
+        const resolvedChild = path.resolve(potentialChild);
+        return resolvedChild.startsWith(resolvedParent) && resolvedChild !== resolvedParent;
+    }
+    catch (error) {
+        return false;
+    }
+}
 const unzip = async (inputPath, outputDir) => {
     const data = await fs.promises.readFile(inputPath);
     await extractEntriesFromBuffer(data, outputDir);

package/lib/utils.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.openInBrowserPopup = exports.openInBrowser = exports.connectableHostname = exports.randomInt = exports.debounce = exports.last = exports.cloneDeep = exports.groupBy = exports.assertIsStringOrUndefined = exports.assertIsNumber = exports.assertIsString = exports.thirtyDaysFromNow = exports.isRunningInWSL = exports.isCloudEnvironment = exports.datetimeString = exports.createDestroyer = exports.sleep = exports.promiseWithSpinner = exports.tryParse = exports.promiseProps = exports.withTimeout = exports.promiseWhile = exports.promiseAllSettled = exports.getFunctionsEventProvider = exports.endpoint = exports.makeActiveProject = exports.streamToString = exports.stringToStream = exports.explainStdin = exports.allSettled = exports.reject = exports.logLabeledError = exports.logLabeledWarning = exports.logWarningToStderr = exports.logWarning = exports.logLabeledBullet = exports.logBullet = exports.logLabeledSuccess = exports.logSuccess = exports.addSubdomain = exports.addDatabaseNamespace = exports.getDatabaseViewDataUrl = exports.getDatabaseUrl = exports.envOverride = exports.setVSCodeEnvVars = exports.getInheritedOption = exports.consoleUrl = exports.vscodeEnvVars = exports.envOverrides = exports.IS_WINDOWS = void 0;
-exports.newUniqueId = exports.deepEqual = exports.promptForDirectory = exports.updateOrCreateGitignore = exports.readSecretValue = exports.generatePassword = exports.generateId = exports.wrappedSafeLoad = exports.readFileFromDirectory = exports.getHostnameFromUrl = void 0;
+exports.commandExistsSync = exports.newUniqueId = exports.deepEqual = exports.promptForDirectory = exports.updateOrCreateGitignore = exports.readSecretValue = exports.generatePassword = exports.generateId = exports.wrappedSafeLoad = exports.readFileFromDirectory = exports.getHostnameFromUrl = void 0;
 const fs = require("fs-extra");
 const tty = require("tty");
 const path = require("node:path");
@@ -24,6 +24,8 @@ const prompt_1 = require("./prompt");
 const templates_1 = require("./templates");
 const vsCodeUtils_1 = require("./vsCodeUtils");
 const fsutils_1 = require("./fsutils");
+const node_os_1 = require("node:os");
+const node_child_process_1 = require("node:child_process");
 exports.IS_WINDOWS = process.platform === "win32";
 const SUCCESS_CHAR = exports.IS_WINDOWS ? "+" : "✔";
 const WARNING_CHAR = exports.IS_WINDOWS ? "!" : "⚠";
@@ -657,3 +659,17 @@ function newUniqueId(recommended, existingIDs) {
     return id;
 }
 exports.newUniqueId = newUniqueId;
+function commandExistsSync(command) {
+    try {
+        const isWindows = (0, node_os_1.platform)() === "win32";
+        const commandToCheck = isWindows
+            ? `where "${command}" > nul 2> nul`
+            : `which "${command}" > /dev/null 2> /dev/null`;
+        (0, node_child_process_1.execSync)(commandToCheck);
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+}
+exports.commandExistsSync = commandExistsSync;

package/package.json

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

package/schema/firebase-config.json

@@ -2,6 +2,18 @@
     "$schema": "http://json-schema.org/draft-07/schema#",
     "additionalProperties": false,
     "definitions": {
+        "ActiveRuntime": {
+            "enum": [
+                "nodejs18",
+                "nodejs20",
+                "nodejs22",
+                "python310",
+                "python311",
+                "python312",
+                "python313"
+            ],
+            "type": "string"
+        },
         "DataConnectSingle": {
             "additionalProperties": false,
             "properties": {
@@ -242,66 +254,14 @@
             "type": "object"
         },
         "FunctionConfig": {
-            "additionalProperties": false,
-            "properties": {
-                "codebase": {
-                    "type": "string"
-                },
-                "configDir": {
-                    "type": "string"
-                },
-                "ignore": {
-                    "items": {
-                        "type": "string"
-                    },
-                    "type": "array"
-                },
-                "postdeploy": {
-                    "anyOf": [
-                        {
-                            "items": {
-                                "type": "string"
-                            },
-                            "type": "array"
-                        },
-                        {
-                            "type": "string"
-                        }
-                    ]
-                },
-                "predeploy": {
-                    "anyOf": [
-                        {
-                            "items": {
-                                "type": "string"
-                            },
-                            "type": "array"
-                        },
-                        {
-                            "type": "string"
-                        }
-                    ]
-                },
-                "prefix": {
-                    "type": "string"
-                },
-                "runtime": {
-                    "enum": [
-                        "nodejs18",
-                        "nodejs20",
-                        "nodejs22",
-                        "python310",
-                        "python311",
-                        "python312",
-                        "python313"
-                    ],
-                    "type": "string"
+            "anyOf": [
+                {
+                    "$ref": "#/definitions/LocalFunctionConfig"
                 },
-                "source": {
-                    "type": "string"
+                {
+                    "$ref": "#/definitions/RemoteFunctionConfig"
                 }
-            },
-            "type": "object"
+            ]
         },
         "HostingHeaders": {
             "anyOf": [
@@ -903,6 +863,71 @@
             },
             "type": "object"
         },
+        "LocalFunctionConfig": {
+            "additionalProperties": false,
+            "properties": {
+                "codebase": {
+                    "type": "string"
+                },
+                "configDir": {
+                    "type": "string"
+                },
+                "ignore": {
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                },
+                "postdeploy": {
+                    "anyOf": [
+                        {
+                            "items": {
+                                "type": "string"
+                            },
+                            "type": "array"
+                        },
+                        {
+                            "type": "string"
+                        }
+                    ]
+                },
+                "predeploy": {
+                    "anyOf": [
+                        {
+                            "items": {
+                                "type": "string"
+                            },
+                            "type": "array"
+                        },
+                        {
+                            "type": "string"
+                        }
+                    ]
+                },
+                "prefix": {
+                    "type": "string"
+                },
+                "runtime": {
+                    "enum": [
+                        "nodejs18",
+                        "nodejs20",
+                        "nodejs22",
+                        "python310",
+                        "python311",
+                        "python312",
+                        "python313"
+                    ],
+                    "type": "string"
+                },
+                "source": {
+                    "type": "string"
+                }
+            },
+            "required": [
+                "source"
+            ],
+            "type": "object"
+        },
         "Record<string,string>": {
             "additionalProperties": false,
             "type": "object"
@@ -945,6 +970,79 @@
             ],
             "type": "object"
         },
+        "RemoteFunctionConfig": {
+            "additionalProperties": false,
+            "properties": {
+                "codebase": {
+                    "type": "string"
+                },
+                "configDir": {
+                    "type": "string"
+                },
+                "ignore": {
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                },
+                "postdeploy": {
+                    "anyOf": [
+                        {
+                            "items": {
+                                "type": "string"
+                            },
+                            "type": "array"
+                        },
+                        {
+                            "type": "string"
+                        }
+                    ]
+                },
+                "predeploy": {
+                    "anyOf": [
+                        {
+                            "items": {
+                                "type": "string"
+                            },
+                            "type": "array"
+                        },
+                        {
+                            "type": "string"
+                        }
+                    ]
+                },
+                "prefix": {
+                    "type": "string"
+                },
+                "remoteSource": {
+                    "additionalProperties": false,
+                    "properties": {
+                        "dir": {
+                            "type": "string"
+                        },
+                        "ref": {
+                            "type": "string"
+                        },
+                        "repository": {
+                            "type": "string"
+                        }
+                    },
+                    "required": [
+                        "ref",
+                        "repository"
+                    ],
+                    "type": "object"
+                },
+                "runtime": {
+                    "$ref": "#/definitions/ActiveRuntime"
+                }
+            },
+            "required": [
+                "remoteSource",
+                "runtime"
+            ],
+            "type": "object"
+        },
         "StorageSingle": {
             "additionalProperties": false,
             "properties": {
@@ -1487,7 +1585,10 @@
         "functions": {
             "anyOf": [
                 {
-                    "$ref": "#/definitions/FunctionConfig"
+                    "$ref": "#/definitions/LocalFunctionConfig"
+                },
+                {
+                    "$ref": "#/definitions/RemoteFunctionConfig"
                 },
                 {
                     "items": {

package/lib/crashlytics/addNote.js

@@ -1,27 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.addNote = void 0;
-const logger_1 = require("../logger");
-const error_1 = require("../error");
-const utils_1 = require("./utils");
-async function addNote(appId, issueId, note) {
-    const requestProjectNumber = (0, utils_1.parseProjectNumber)(appId);
-    logger_1.logger.debug(`[mcp][crashlytics] addNote called with appId: ${appId}, issueId: ${issueId}, note: ${note}`);
-    try {
-        const response = await utils_1.CRASHLYTICS_API_CLIENT.request({
-            method: "POST",
-            headers: {
-                "Content-Type": "application/json",
-            },
-            path: `/projects/${requestProjectNumber}/apps/${appId}/issues/${issueId}/notes`,
-            body: { body: note },
-            timeout: utils_1.TIMEOUT,
-        });
-        return response.body;
-    }
-    catch (err) {
-        logger_1.logger.debug(err.message);
-        throw new error_1.FirebaseError(`Failed to add note to issue ${issueId} for app ${appId}. Error: ${err}.`, { original: err });
-    }
-}
-exports.addNote = addNote;

package/lib/crashlytics/deleteNote.js

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.deleteNote = void 0;
-const logger_1 = require("../logger");
-const error_1 = require("../error");
-const utils_1 = require("./utils");
-async function deleteNote(appId, issueId, noteId) {
-    const requestProjectNumber = (0, utils_1.parseProjectNumber)(appId);
-    logger_1.logger.debug(`[mcp][crashlytics] deleteNote called with appId: ${appId}, issueId: ${issueId}, noteId: ${noteId}`);
-    try {
-        await utils_1.CRASHLYTICS_API_CLIENT.request({
-            method: "DELETE",
-            path: `/projects/${requestProjectNumber}/apps/${appId}/issues/${issueId}/notes/${noteId}`,
-            timeout: utils_1.TIMEOUT,
-        });
-        return `Successfully deleted note ${noteId} from issue ${issueId}.`;
-    }
-    catch (err) {
-        logger_1.logger.debug(err.message);
-        throw new error_1.FirebaseError(`Failed to delete note ${noteId} from issue ${issueId} for app ${appId}. Error: ${err}.`, { original: err });
-    }
-}
-exports.deleteNote = deleteNote;

package/lib/crashlytics/getIssueDetails.js

@@ -1,26 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getIssueDetails = void 0;
-const logger_1 = require("../logger");
-const error_1 = require("../error");
-const utils_1 = require("./utils");
-async function getIssueDetails(appId, issueId) {
-    const requestProjectNumber = (0, utils_1.parseProjectNumber)(appId);
-    logger_1.logger.debug(`[mcp][crashlytics] getIssueDetails called with appId: ${appId}, issueId: ${issueId}`);
-    try {
-        const response = await utils_1.CRASHLYTICS_API_CLIENT.request({
-            method: "GET",
-            headers: {
-                "Content-Type": "application/json",
-            },
-            path: `/projects/${requestProjectNumber}/apps/${appId}/issues/${issueId}`,
-            timeout: utils_1.TIMEOUT,
-        });
-        return response.body;
-    }
-    catch (err) {
-        logger_1.logger.debug(err.message);
-        throw new error_1.FirebaseError(`Failed to fetch the issue details for the Firebase AppId ${appId}, IssueId ${issueId}. Error: ${err}.`, { original: err });
-    }
-}
-exports.getIssueDetails = getIssueDetails;

package/lib/crashlytics/getSampleCrash.js

@@ -1,34 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getSampleCrash = void 0;
-const logger_1 = require("../logger");
-const error_1 = require("../error");
-const utils_1 = require("./utils");
-async function getSampleCrash(appId, issueId, sampleCount, variantId) {
-    const requestProjectNumber = (0, utils_1.parseProjectNumber)(appId);
-    logger_1.logger.debug(`[mcp][crashlytics] getSampleCrash called with appId: ${appId}, issueId: ${issueId}, sampleCount: ${sampleCount}, variantId: ${variantId}`);
-    try {
-        const queryParams = new URLSearchParams();
-        queryParams.set("filter.issue.id", issueId);
-        queryParams.set("page_size", String(sampleCount));
-        if (variantId) {
-            queryParams.set("filter.issue.variant_id", variantId);
-        }
-        logger_1.logger.debug(`[mcp][crashlytics] getSampleCrash query paramaters: ${queryParams}`);
-        const response = await utils_1.CRASHLYTICS_API_CLIENT.request({
-            method: "GET",
-            headers: {
-                "Content-Type": "application/json",
-            },
-            path: `/projects/${requestProjectNumber}/apps/${appId}/events`,
-            queryParams: queryParams,
-            timeout: utils_1.TIMEOUT,
-        });
-        return response.body;
-    }
-    catch (err) {
-        logger_1.logger.debug(err.message);
-        throw new error_1.FirebaseError(`Failed to fetch the same crash for the Firebase AppId ${appId}, IssueId ${issueId}. Error: ${err}.`, { original: err });
-    }
-}
-exports.getSampleCrash = getSampleCrash;

package/lib/crashlytics/listTopDevices.js

@@ -1,33 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.listTopDevices = void 0;
-const logger_1 = require("../logger");
-const error_1 = require("../error");
-const utils_1 = require("./utils");
-async function listTopDevices(appId, deviceCount, issueId) {
-    const requestProjectNumber = (0, utils_1.parseProjectNumber)(appId);
-    const platformPath = (0, utils_1.parsePlatform)(appId);
-    try {
-        const queryParams = new URLSearchParams();
-        queryParams.set("page_size", `${deviceCount}`);
-        if (issueId) {
-            queryParams.set("filter.issue.id", issueId);
-        }
-        logger_1.logger.debug(`[mcp][crashlytics] listTopDevices called with appId: ${appId}, deviceCount: ${deviceCount}, issueId: ${issueId}`);
-        const response = await utils_1.CRASHLYTICS_API_CLIENT.request({
-            method: "GET",
-            headers: {
-                "Content-Type": "application/json",
-            },
-            path: `/projects/${requestProjectNumber}/apps/${appId}/reports/${platformPath}`,
-            queryParams: queryParams,
-            timeout: utils_1.TIMEOUT,
-        });
-        return response.body;
-    }
-    catch (err) {
-        logger_1.logger.debug(err.message);
-        throw new error_1.FirebaseError(`Failed to fetch the top devices for the Firebase app id: ${appId}. Error: ${err}.`, { original: err });
-    }
-}
-exports.listTopDevices = listTopDevices;

package/lib/crashlytics/listTopIssues.js

@@ -1,30 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.listTopIssues = void 0;
-const logger_1 = require("../logger");
-const error_1 = require("../error");
-const utils_1 = require("./utils");
-async function listTopIssues(appId, issueType, issueCount) {
-    const requestProjectNumber = (0, utils_1.parseProjectNumber)(appId);
-    try {
-        const queryParams = new URLSearchParams();
-        queryParams.set("page_size", `${issueCount}`);
-        queryParams.set("filter.issue.error_types", `${issueType}`);
-        logger_1.logger.debug(`[mcp][crashlytics] listTopIssues called with appId: ${appId}, issueType: ${issueType}, issueCount: ${issueCount}`);
-        const response = await utils_1.CRASHLYTICS_API_CLIENT.request({
-            method: "GET",
-            headers: {
-                "Content-Type": "application/json",
-            },
-            path: `/projects/${requestProjectNumber}/apps/${appId}/reports/topIssues`,
-            queryParams: queryParams,
-            timeout: utils_1.TIMEOUT,
-        });
-        return response.body;
-    }
-    catch (err) {
-        logger_1.logger.debug(err.message);
-        throw new error_1.FirebaseError(`Failed to fetch the top issues for the Firebase app id: ${appId}. Error: ${err}.`, { original: err });
-    }
-}
-exports.listTopIssues = listTopIssues;

package/lib/crashlytics/listTopOperatingSystems.js

@@ -1,32 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.listTopOperatingSystems = void 0;
-const logger_1 = require("../logger");
-const error_1 = require("../error");
-const utils_1 = require("./utils");
-async function listTopOperatingSystems(appId, osCount, issueId) {
-    const requestProjectNumber = (0, utils_1.parseProjectNumber)(appId);
-    try {
-        const queryParams = new URLSearchParams();
-        queryParams.set("page_size", `${osCount}`);
-        if (issueId) {
-            queryParams.set("filter.issue.id", issueId);
-        }
-        logger_1.logger.debug(`[mcp][crashlytics] listTopOperatingSystems called with appId: ${appId}, osCount: ${osCount}, issueId: ${issueId}`);
-        const response = await utils_1.CRASHLYTICS_API_CLIENT.request({
-            method: "GET",
-            headers: {
-                "Content-Type": "application/json",
-            },
-            path: `/projects/${requestProjectNumber}/apps/${appId}/reports/topOperatingSystems`,
-            queryParams: queryParams,
-            timeout: utils_1.TIMEOUT,
-        });
-        return response.body;
-    }
-    catch (err) {
-        logger_1.logger.debug(err.message);
-        throw new error_1.FirebaseError(`Failed to fetch the top operating systems for the Firebase app id: ${appId}. Error: ${err}.`, { original: err });
-    }
-}
-exports.listTopOperatingSystems = listTopOperatingSystems;

package/lib/crashlytics/listTopVersions.js

@@ -1,32 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.listTopVersions = void 0;
-const logger_1 = require("../logger");
-const error_1 = require("../error");
-const utils_1 = require("./utils");
-async function listTopVersions(appId, versionCount, issueId) {
-    const requestProjectNumber = (0, utils_1.parseProjectNumber)(appId);
-    try {
-        const queryParams = new URLSearchParams();
-        queryParams.set("page_size", `${versionCount}`);
-        if (issueId) {
-            queryParams.set("filter.issue.id", issueId);
-        }
-        logger_1.logger.debug(`[mcp][crashlytics] listTopVersions called with appId: ${appId}, versionCount: ${versionCount}, issueId: ${issueId}`);
-        const response = await utils_1.CRASHLYTICS_API_CLIENT.request({
-            method: "GET",
-            headers: {
-                "Content-Type": "application/json",
-            },
-            path: `/projects/${requestProjectNumber}/apps/${appId}/reports/topVersions`,
-            queryParams: queryParams,
-            timeout: utils_1.TIMEOUT,
-        });
-        return response.body;
-    }
-    catch (err) {
-        logger_1.logger.debug(err.message);
-        throw new error_1.FirebaseError(`Failed to fetch the top versions for the Firebase app id: ${appId}. Error: ${err}.`, { original: err });
-    }
-}
-exports.listTopVersions = listTopVersions;