firebase-tools 14.21.0 → 14.23.0

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/resources/guides/init_backend.js

@@ -7,7 +7,7 @@ exports.init_backend = (0, resource_1.resource)({
     name: "backend_init_guide",
     title: "Firebase Backend Init Guide",
     description: "guides the coding agent through configuring Firebase backend services in the current project",
-}, async (uri) => {
+}, async (uri, ctx) => {
     return {
         contents: [
             {
@@ -24,31 +24,8 @@ The user will likely need to setup Firestore, Authentication, and Hosting. Read
  3. [Firestore Rules](firebase://guides/init/firestore_rules): read this to setup the \`firestore.rules\` file for securing your database
  4. [Hosting](firebase://guides/init/hosting): read this if the user would like to deploy to Firebase Hosting
 
-**firebase.json**
-The firebase.json file is used to deploy Firebase products with the firebase deploy command.
-
-Here is an example firebase.json file with Firebase Hosting, Firestore, and Cloud Functions. Note that you do not need entries for services that the user isn't using. Do not remove sections from the user's firebase.json unless the user gives explicit permission. For more information, refer to [firebase.json file documentation](https://firebase.google.com/docs/cli/#the_firebasejson_file)
-\`\`\`json
-{
-  "hosting": {
-    "public": "public",
-    "ignore": [
-      "firebase.json",
-      "**/.*",
-      "**/node_modules/**"
-    ]
-  },
-  "firestore": {
-      "rules": "firestore.rules",
-      "indexes": "firestore.indexes.json"
-  },
-  "functions": {
-    "predeploy": [
-      "npm --prefix "$RESOURCE_DIR" run lint",
-      "npm --prefix "$RESOURCE_DIR" run build"
-    ]
-  }
-}
+Once you are done setting up, ask the user if they would like to deploy.
+If they say yes, run the command '${ctx.firebaseCliCommand} deploy --non-interactive' to do so.
 \`\`\`
 `.trim(),
             },

package/lib/mcp/resources/guides/init_hosting.js

@@ -1,13 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.init_hosting = void 0;
+const getDefaultHostingSite_1 = require("../../../getDefaultHostingSite");
 const resource_1 = require("../../resource");
 exports.init_hosting = (0, resource_1.resource)({
     uri: "firebase://guides/init/hosting",
     name: "hosting_init_guide",
     title: "Firebase Hosting Deployment Guide",
     description: "guides the coding agent through deploying to Firebase Hosting in the current project",
-}, async (uri) => {
+}, async (uri, ctx) => {
+    const defaultHostingSite = await (0, getDefaultHostingSite_1.getDefaultHostingSite)(ctx);
     return {
         contents: [
             {
@@ -15,18 +17,21 @@ exports.init_hosting = (0, resource_1.resource)({
                 type: "text",
                 text: `
 ### Configure Firebase Hosting
+Default hosting site for ${ctx.projectId}: ${defaultHostingSite || "Does not exist"}
+If there is not a default hosting site configured, ask the user what the site ID should be, and suggest ${ctx.projectId} as a good choice.
+Next, use the 'firebase_init' tool to set up hosting. Below is an example of what the arguments to do so look like;
+however, you should change the values to match the user's choices and project structure:
+{
+  features: {
+    hosting: {
+      site_id: ${ctx.projectId},
+      public_directory: public,
+    }
+  }
+}
 
 **Security Warning:**
 - Files included in the public folder of a hosting site are publicly accessible. Do not include sensitive API keys for services other than Firebase in these files.
-
-**When to Deploy:**
-- Introduce Firebase Hosting when developers are ready to deploy their application to production. 
-- Alternative: Developers can deploy later using the \`/firebase:deploy\` command.
-
-**Deployment Process:**
-- Request developer's permission before implementing Firebase Hosting
-- Request developer's permission before deploying Firebase Hosting app to production. 
-- Configure Firebase Hosting and deploy the application to production
 `.trim(),
             },
         ],

package/lib/mcp/tools/core/init.js

@@ -115,6 +115,25 @@ exports.init = (0, tool_1.tool)("core", {
             })
                 .optional()
                 .describe("Enable Firebase AI Logic feature for existing app"),
+            hosting: zod_1.z
+                .object({
+                site_id: zod_1.z
+                    .string()
+                    .optional()
+                    .describe("The ID of the hosting site to configure. If omitted and there is a default hosting site, that will be used."),
+                public_directory: zod_1.z
+                    .string()
+                    .optional()
+                    .default("public")
+                    .describe("The directory containing public files that will be served. If using a build tool, this likely should be the output directory of that tool."),
+                single_page_app: zod_1.z
+                    .boolean()
+                    .optional()
+                    .default(false)
+                    .describe("Configure as a single-page app."),
+            })
+                .optional()
+                .describe("Provide this object to initialize Firebase Hosting in this project directory."),
         }),
     }),
     annotations: {
@@ -185,6 +204,14 @@ exports.init = (0, tool_1.tool)("core", {
             displayName: appData.displayName,
         };
     }
+    if (features.hosting) {
+        featuresList.push("hosting");
+        featureInfo.hosting = {
+            newSiteId: features.hosting.site_id,
+            public: features.hosting.public_directory,
+            spa: features.hosting.single_page_app,
+        };
+    }
     const setup = {
         config: config === null || config === void 0 ? void 0 : config.src,
         rcfile: rc === null || rc === void 0 ? void 0 : rc.data,

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.21.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": {