firebase-tools 15.9.1 → 15.10.0

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

@@ -3,15 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.askQuestions = askQuestions;
 exports.actuate = actuate;
 const clc = require("colorette");
-const node_fs_1 = require("node:fs");
 const path_1 = require("path");
 const apiv2_1 = require("../../../apiv2");
-const github_1 = require("./github");
+const frameworks_1 = require("../../../frameworks");
+const github = require("./github");
 const prompt_1 = require("../../../prompt");
 const logger_1 = require("../../../logger");
-const frameworks_1 = require("../../../frameworks");
-const constants_1 = require("../../../frameworks/constants");
-const experiments = require("../../../experiments");
 const getDefaultHostingSite_1 = require("../../../getDefaultHostingSite");
 const utils_1 = require("../../../utils");
 const interactive_1 = require("../../../hosting/interactive");
@@ -22,7 +19,51 @@ const INDEX_TEMPLATE = (0, templates_1.readTemplateSync)("init/hosting/index.htm
 const MISSING_TEMPLATE = (0, templates_1.readTemplateSync)("init/hosting/404.html");
 const DEFAULT_IGNORES = ["firebase.json", "**/.*", "**/node_modules/**"];
 async function askQuestions(setup, config, options) {
-    var _a, _b, _c, _d, _e;
+    var _a, _b;
+    const discoveredFramework = await (0, frameworks_1.discover)(config.projectDir, false);
+    if (discoveredFramework && discoveredFramework.mayWantBackend) {
+        const frameworkName = frameworks_1.WebFrameworks[discoveredFramework.framework]?.name ?? discoveredFramework.framework;
+        switch (discoveredFramework.framework) {
+            case "next":
+            case "angular":
+            case "nuxt":
+            case "nuxt2":
+            case "express":
+            case "svelekit":
+            case "sveltekit":
+                logger_1.logger.info();
+                const useAppHosting = await (0, prompt_1.confirm)({
+                    message: `Detected a ${frameworkName} codebase with SSR features. We can't guarantee that ` +
+                        `this site will work on Firebase Hosting, which is optimized for static sites. Another ` +
+                        `product, Firebase App Hosting, was designed for SSR web apps. Would ` +
+                        `you like to use App Hosting instead? Learn more here: ` +
+                        `https://firebase.google.com/docs/app-hosting/product-comparison#hostings`,
+                    default: true,
+                });
+                if (useAppHosting) {
+                    setup.featureInfo || (setup.featureInfo = {});
+                    setup.featureInfo.hosting = { redirectToAppHosting: true };
+                    setup.features?.unshift("apphosting");
+                    return;
+                }
+                break;
+            default:
+                logger_1.logger.info();
+                logger_1.logger.info(`Detected a ${frameworkName} codebase with SSR features. We can't guarantee that ` +
+                    `this site will work on Firebase Hosting, which is optimized for static sites. Another ` +
+                    `product, Firebase App Hosting, was designed for SSR web apps.`);
+                logger_1.logger.info(`Learn about App Hosting here: https://firebase.google.com/docs/app-hosting/product-comparison#hostings`);
+                logger_1.logger.info(`Learn how to deploy frameworks with App Hosting here: https://firebase.blog/posts/2025/06/app-hosting-frameworks/`);
+                const continueWithHosting = await (0, prompt_1.confirm)({
+                    message: `Would you like to continue setting up Firebase Hosting?`,
+                    default: false,
+                });
+                if (!continueWithHosting) {
+                    throw new error_1.FirebaseError("Hosting initialization cancelled.", { exit: 1 });
+                }
+                break;
+        }
+    }
     setup.featureInfo = setup.featureInfo || {};
     setup.featureInfo.hosting = {};
     if (setup.projectId) {
@@ -48,75 +89,18 @@ 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")) {
-        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?`,
-                default: true,
-            }))) {
-            setup.featureInfo.hosting.source = ".";
-            setup.featureInfo.hosting.useWebFrameworks = true;
-            setup.featureInfo.hosting.useDiscoveredFramework = true;
-            setup.featureInfo.hosting.webFramework = discoveredFramework.framework;
-        }
-        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 = setup.featureInfo.hosting).source ?? (_a.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 = setup.featureInfo.hosting).useDiscoveredFramework ?? (_b.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 });
-            }
-        }
-        const defaultChoice = choices.find(({ value }) => value === discoveredFramework?.framework)?.value;
-        (_c = setup.featureInfo.hosting).webFramework ?? (_c.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();
-        logger_1.logger.info(`Your ${clc.bold("public")} directory is the folder (relative to your project directory) that`);
-        logger_1.logger.info(`will contain Hosting assets to be uploaded with ${clc.bold("firebase deploy")}. If you`);
-        logger_1.logger.info("have a build process for your assets, use your build's output directory.");
-        logger_1.logger.info();
-        (_d = setup.featureInfo.hosting).public ?? (_d.public = await (0, prompt_1.input)({
-            message: "What do you want to use as your public directory?",
-            default: "public",
-        }));
-        (_e = setup.featureInfo.hosting).spa ?? (_e.spa = await (0, prompt_1.confirm)("Configure as a single-page app (rewrite all urls to /index.html)?"));
-    }
+    logger_1.logger.info();
+    logger_1.logger.info(`Your ${clc.bold("public")} directory is the folder (relative to your project directory) that`);
+    logger_1.logger.info(`will contain Hosting assets to be uploaded with ${clc.bold("firebase deploy")}. If you`);
+    logger_1.logger.info("have a build process for your assets, use your build's output directory.");
+    logger_1.logger.info();
+    (_a = setup.featureInfo.hosting).public ?? (_a.public = await (0, prompt_1.input)({
+        message: "What do you want to use as your public directory?",
+        default: "public",
+    }));
+    (_b = setup.featureInfo.hosting).spa ?? (_b.spa = await (0, prompt_1.confirm)("Configure as a single-page app (rewrite all urls to /index.html)?"));
     if (await (0, prompt_1.confirm)("Set up automatic builds and deploys with GitHub?")) {
-        return (0, github_1.initGitHub)(setup);
+        return github.initGitHub(setup);
     }
 }
 async function actuate(setup, config, options) {
@@ -124,40 +108,26 @@ async function actuate(setup, config, options) {
     if (!hostingInfo) {
         throw new error_1.FirebaseError("Could not find hosting info in setup.featureInfo.hosting. This should not happen.", { exit: 2 });
     }
+    if (hostingInfo.redirectToAppHosting) {
+        return;
+    }
     if (hostingInfo.newSiteId && setup.projectId) {
         await (0, api_1.createSite)(setup.projectId, hostingInfo.newSiteId);
         logger_1.logger.info();
         (0, utils_1.logSuccess)(`Firebase Hosting site ${hostingInfo.newSiteId} created!`);
         logger_1.logger.info();
     }
-    if (hostingInfo.webFramework) {
-        if (!hostingInfo.useDiscoveredFramework) {
-            if (hostingInfo.source && (0, node_fs_1.existsSync)(hostingInfo.source)) {
-                (0, node_fs_1.rmSync)(hostingInfo.source, { recursive: true });
-            }
-            await frameworks_1.WebFrameworks[hostingInfo.webFramework].init(setup, config);
-        }
-        setup.config.hosting = {
-            source: hostingInfo.source,
-            ignore: DEFAULT_IGNORES,
-            frameworksBackend: {
-                region: hostingInfo.region,
-            },
-        };
+    setup.config.hosting = {
+        public: hostingInfo.public,
+        ignore: DEFAULT_IGNORES,
+    };
+    if (hostingInfo.spa) {
+        setup.config.hosting.rewrites = [{ source: "**", destination: "/index.html" }];
     }
     else {
-        setup.config.hosting = {
-            public: hostingInfo.public,
-            ignore: DEFAULT_IGNORES,
-        };
-        if (hostingInfo.spa) {
-            setup.config.hosting.rewrites = [{ source: "**", destination: "/index.html" }];
-        }
-        else {
-            await config.askWriteProjectFile(`${hostingInfo.public}/404.html`, MISSING_TEMPLATE, !!options.force);
-        }
-        const c = new apiv2_1.Client({ urlPrefix: "https://www.gstatic.com", auth: false });
-        const response = await c.get("/firebasejs/releases.json");
-        await config.askWriteProjectFile(`${hostingInfo.public}/index.html`, INDEX_TEMPLATE.replace(/{{VERSION}}/g, response.body.current.version), !!options.force);
+        await config.askWriteProjectFile((0, path_1.join)(hostingInfo.public ?? "public", "404.html"), MISSING_TEMPLATE, !!options.force);
     }
+    const c = new apiv2_1.Client({ urlPrefix: "https://www.gstatic.com", auth: false });
+    const response = await c.get("/firebasejs/releases.json");
+    await config.askWriteProjectFile((0, path_1.join)(hostingInfo.public ?? "public", "index.html"), INDEX_TEMPLATE.replace(/{{VERSION}}/g, response.body.current.version), !!options.force);
 }

package/lib/mcp/tools/apptesting/tests.js

@@ -58,8 +58,8 @@ exports.run_tests = (0, tool_1.tool)("apptesting", {
 }, async ({ appId, releaseBinaryFile, testDevices, testCase }) => {
     const devices = testDevices || defaultDevices;
     const client = new client_1.AppDistributionClient();
-    const releaseName = await (0, distribution_1.upload)(client, (0, options_parser_util_1.toAppName)(appId), new distribution_1.Distribution(releaseBinaryFile));
-    return (0, util_1.toContent)(await client.createReleaseTest(releaseName, devices, testCase));
+    const release = await (0, distribution_1.upload)(client, (0, options_parser_util_1.toAppName)(appId), new distribution_1.Distribution(releaseBinaryFile));
+    return (0, util_1.toContent)(await client.createReleaseTest(release.name, devices, testCase));
 });
 exports.check_status = (0, tool_1.tool)("apptesting", {
     name: "check_status",

package/lib/track.js

@@ -33,7 +33,7 @@ exports.GA4_PROPERTIES = {
     },
 };
 function usageEnabled() {
-    return ((!!process.env.IS_FIREBASE_CLI || !!process.env.IS_FIREBASE_MCP) && !!configstore_1.configstore.get("usage"));
+    return (!!process.env.IS_FIREBASE_CLI || (0, env_1.isFirebaseMcp)()) && !!configstore_1.configstore.get("usage");
 }
 const GA4_USER_PROPS = {
     node_platform: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firebase-tools",
-  "version": "15.9.1",
+  "version": "15.10.0",
   "description": "Command-Line Interface for Firebase",
   "main": "./lib/index.js",
   "mcpName": "io.github.firebase/firebase-mcp",

package/schema/dataconnect-yaml.json

@@ -10,6 +10,10 @@
           "type": "string",
           "description": "The name of the PostgreSQL database."
         },
+        "schema": {
+          "type": "string",
+          "description": "The PostgreSQL schema name. Defaults to 'public' if not specified."
+        },
         "cloudSql": {
           "additionalProperties": false,
           "type": "object",

package/templates/firebase-studio-export/system_instructions_template.md

@@ -9,6 +9,17 @@ App Name: ${appName}
 
 # Migration Guidelines
 
-- Focus on ensuring zero-friction deployments to Firebase App Hosting.
-- Maintain the original intent defined in docs/blueprint.md.
-- Use Genkit for AI features as already configured in src/ai/.
+- `docs/blueprint.md` describes what this app was supposed to do when it was exported. Read it before making changes to the app.
+
+- Use Agent Skills to guide Firebase usage. If they are not available, install them by running `npx -y skills add  firebase/agent-skills --skill "*" -y`
+
+- When asked to deploy or publish the app, deploy to Firebase App Hosting using `firebase deploy`.
+If you run into issues, ensure `firebase.json` contains a valid `apphosting` block (with `backendId` and `rootDir`).
+DO NOT use `firebase apphosting:backends:create` or `firebase apphosting:rollouts:create`.
+DO NOT try to deploy to Firebase Hosting.
+
+- When asked to add AI features, use Genkit (as already configured in `src/ai/`).
+
+# Important
+
+Never display, log, or commit sensitive credentials, .env files, or service account keys.

package/templates/firebase-studio-export/workflows/startup_workflow.md

@@ -5,12 +5,8 @@ description: Run initial checks and fix common migration issues
 
 # Step 1: Check Compilation
 
-Run \`npm run typecheck\` and \`npm run build\` to ensure the project is in a healthy state.
+Run \`npm run typecheck\` and \`npm run build\` (depending on the app type) to ensure the project is in a healthy state.
 
-# Step 2: Verify Firebase Auth/Firestore
+# Step 2: Cleanup Genkit config
 
-If the app uses Firebase services, ensure the environment variables are correctly set or provided via App Hosting.
-
-# Step 3: Cleanup Genkit config
-
-If genkit is otherwise unused in this project, remove the configuration in src/ai/genkit.ts and remove related dependencies in package.json.
+If genkit is otherwise unused in this project, ask the user if they'd like to remove the configuration in src/ai/genkit.ts and remove related dependencies in package.json.