firebase-tools 14.15.1 → 14.16.0

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

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logout = void 0;
+const zod_1 = require("zod");
+const clc = require("colorette");
+const tool_1 = require("../../tool");
+const util_1 = require("../../util");
+const auth_1 = require("../../../auth");
+const logger_1 = require("../../../logger");
+exports.logout = (0, tool_1.tool)({
+    name: "logout",
+    description: "Log the CLI out of Firebase",
+    inputSchema: zod_1.z.object({
+        email: zod_1.z
+            .string()
+            .optional()
+            .describe("The email of the account to log out. If not provided, all accounts will be logged out."),
+    }),
+    _meta: {
+        requiresAuth: false,
+        requiresProject: false,
+    },
+}, async ({ email }) => {
+    const allAccounts = (0, auth_1.getAllAccounts)();
+    if (allAccounts.length === 0) {
+        return (0, util_1.toContent)("No need to log out, not logged in");
+    }
+    const defaultAccount = (0, auth_1.getGlobalDefaultAccount)();
+    const additionalAccounts = (0, auth_1.getAdditionalAccounts)();
+    const accountsToLogOut = email
+        ? allAccounts.filter((a) => a.user.email === email)
+        : allAccounts;
+    if (email && accountsToLogOut.length === 0) {
+        return (0, util_1.toContent)(`No account matches ${email}, can't log out.`);
+    }
+    const logoutDefault = email === (defaultAccount === null || defaultAccount === void 0 ? void 0 : defaultAccount.user.email);
+    let newDefaultAccount = undefined;
+    if (logoutDefault && additionalAccounts.length > 0) {
+        newDefaultAccount = additionalAccounts[0];
+    }
+    const logoutMessages = [];
+    for (const account of accountsToLogOut) {
+        const token = account.tokens.refresh_token;
+        if (token) {
+            try {
+                await (0, auth_1.logout)(token);
+                logoutMessages.push(`Logged out from ${clc.bold(account.user.email)}`);
+            }
+            catch (e) {
+                if (e instanceof Error) {
+                    logger_1.logger.debug(e.message);
+                }
+                logoutMessages.push(`Could not deauthorize ${account.user.email}, assuming already deauthorized.`);
+            }
+        }
+    }
+    if (newDefaultAccount) {
+        (0, auth_1.setGlobalDefaultAccount)(newDefaultAccount);
+        logoutMessages.push(`Setting default account to "${newDefaultAccount.user.email}"`);
+    }
+    return (0, util_1.toContent)(logoutMessages.join("\n"));
+});

package/lib/mcp/tools/dataconnect/execute.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execute = void 0;
+const zod_1 = require("zod");
+const tool_1 = require("../../tool");
+const dataplane = require("../../../dataconnect/dataplaneClient");
+const load_1 = require("../../../dataconnect/load");
+const converter_1 = require("../../util/dataconnect/converter");
+const emulator_1 = require("../../util/dataconnect/emulator");
+exports.execute = (0, tool_1.tool)({
+    name: "execute",
+    description: "Executes a GraphQL operation against a Data Connect service or its emulator.",
+    inputSchema: zod_1.z.object({
+        query: zod_1.z.string().describe(`A Firebase Data Connect GraphQL query or mutation to execute.
+You can use the \`dataconnect_generate_operation\` tool to generate a query.
+Example Data Connect schema and example queries can be found in files ending in \`.graphql\` or \`.gql\`.
+`),
+        service_id: zod_1.z.string().optional()
+            .describe(`Data Connect Service ID to dis-ambulate if there are multiple.
+It's only necessary if there are multiple dataconnect sources in \`firebase.json\`.
+You can find candidate service_id in \`dataconnect.yaml\`
+`),
+        variables_json: zod_1.z
+            .string()
+            .optional()
+            .describe("GraphQL variables to pass into the query. MUST be a valid stringified JSON object."),
+        auth_token_json: zod_1.z
+            .string()
+            .optional()
+            .describe("Firebase Auth Token JWT to use in this query. MUST be a valid stringified JSON object." +
+            'Importantly, when executing queries with `@auth(level: USER)` or `auth.uid`, a valid Firebase Auth Token JWT with "sub" field is required. ' +
+            '"auth.uid" expression in the query evaluates to the value of "sub" field in Firebase Auth token.'),
+        use_emulator: zod_1.z
+            .boolean()
+            .default(false)
+            .describe("If true, target the DataConnect emulator. Run `firebase emulators:start` to start it"),
+    }),
+    annotations: {
+        title: "Execute Firebase Data Connect Query",
+    },
+    _meta: {
+        requiresProject: true,
+        requiresAuth: true,
+    },
+}, async ({ query, service_id, variables_json: unparsedVariables, use_emulator, auth_token_json: unparsedAuthToken, }, { projectId, config, host }) => {
+    const serviceInfo = await (0, load_1.pickService)(projectId, config, service_id || undefined);
+    let apiClient;
+    if (use_emulator) {
+        apiClient = await (0, emulator_1.getDataConnectEmulatorClient)(host);
+    }
+    else {
+        apiClient = dataplane.dataconnectDataplaneClient();
+    }
+    let executeGraphQL = dataplane.executeGraphQL;
+    if (query.startsWith("query")) {
+        executeGraphQL = dataplane.executeGraphQLRead;
+    }
+    const response = await executeGraphQL(apiClient, serviceInfo.serviceName, {
+        name: "",
+        query,
+        variables: (0, converter_1.parseVariables)(unparsedVariables),
+        extensions: {
+            impersonate: unparsedAuthToken
+                ? {
+                    authClaims: (0, converter_1.parseVariables)(unparsedAuthToken),
+                }
+                : undefined,
+        },
+    });
+    return (0, converter_1.graphqlResponseToToolResponse)(response.body);
+});

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

@@ -4,22 +4,12 @@ exports.dataconnectTools = void 0;
 const generate_operation_1 = require("./generate_operation");
 const generate_schema_1 = require("./generate_schema");
 const list_services_1 = require("./list_services");
-const get_schema_1 = require("./get_schema");
-const get_connector_1 = require("./get_connector");
-const execute_graphql_1 = require("./execute_graphql");
-const execute_graphql_read_1 = require("./execute_graphql_read");
-const execute_query_1 = require("./execute_query");
-const execute_mutation_1 = require("./execute_mutation");
 const compile_1 = require("./compile");
+const execute_1 = require("./execute");
 exports.dataconnectTools = [
     compile_1.compile,
-    list_services_1.list_services,
     generate_schema_1.generate_schema,
     generate_operation_1.generate_operation,
-    get_schema_1.get_schema,
-    get_connector_1.get_connectors,
-    execute_graphql_1.execute_graphql,
-    execute_graphql_read_1.execute_graphql_read,
-    execute_mutation_1.execute_mutation,
-    execute_query_1.execute_query,
+    list_services_1.list_services,
+    execute_1.execute,
 ];

package/lib/mcp/tools/dataconnect/list_services.js

@@ -2,22 +2,119 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.list_services = void 0;
 const zod_1 = require("zod");
+const path = require("path");
 const tool_1 = require("../../tool");
 const util_1 = require("../../util");
 const client = require("../../../dataconnect/client");
+const load_1 = require("../../../dataconnect/load");
+const js_yaml_1 = require("js-yaml");
+const logger_1 = require("../../../logger");
 exports.list_services = (0, tool_1.tool)({
     name: "list_services",
-    description: "List the Firebase Data Connect services available in the current project.",
+    description: "List existing local and backend Firebase Data Connect services",
     inputSchema: zod_1.z.object({}),
     annotations: {
-        title: "List Data Connect Services",
+        title: "List existing Firebase Data Connect services",
         readOnlyHint: true,
     },
     _meta: {
-        requiresProject: true,
-        requiresAuth: true,
+        requiresProject: false,
+        requiresAuth: false,
     },
-}, async (_, { projectId }) => {
-    const services = await client.listAllServices(projectId);
-    return (0, util_1.toContent)(services, { format: "yaml" });
+}, async (_, { projectId, config }) => {
+    const localServiceInfos = await (0, load_1.loadAll)(projectId, config);
+    const serviceInfos = new Map();
+    for (const l of localServiceInfos) {
+        serviceInfos.set(`locations/${l.dataConnectYaml.location}/services/${l.dataConnectYaml.serviceId}`, { local: l });
+    }
+    if (projectId) {
+        try {
+            const [services, schemas, connectors] = await Promise.all([
+                client.listAllServices(projectId),
+                client.listSchemas(`projects/${projectId}/locations/-/services/-`),
+                client.listConnectors(`projects/${projectId}/locations/-/services/-`),
+            ]);
+            console.log(services, schemas, connectors);
+            for (const s of services) {
+                const k = s.name.split("/").slice(2, 6).join("/");
+                const st = serviceInfos.get(k) || {};
+                st.deployed = st.deployed || {};
+                st.deployed.service = s;
+                serviceInfos.set(k, st);
+            }
+            for (const s of schemas) {
+                const k = s.name.split("/").slice(2, 6).join("/");
+                const st = serviceInfos.get(k) || {};
+                st.deployed = st.deployed || {};
+                st.deployed.schemas = st.deployed.schemas || [];
+                st.deployed.schemas.push(s);
+                serviceInfos.set(k, st);
+            }
+            for (const s of connectors) {
+                const k = s.name.split("/").slice(2, 6).join("/");
+                const st = serviceInfos.get(k) || {};
+                st.deployed = st.deployed || {};
+                st.deployed.connectors = st.deployed.connectors || [];
+                st.deployed.connectors.push(s);
+                serviceInfos.set(k, st);
+            }
+        }
+        catch (e) {
+            logger_1.logger.debug("cannot fetch dataconnect resources in the backend", e);
+        }
+    }
+    const localServices = Array.from(serviceInfos.values()).filter((s) => s.local);
+    const remoteOnlyServices = Array.from(serviceInfos.values()).filter((s) => !s.local);
+    const output = [];
+    function includeDeployedServiceInfo(deployed) {
+        var _a, _b;
+        if ((_a = deployed.schemas) === null || _a === void 0 ? void 0 : _a.length) {
+            output.push(`### Schemas`);
+            for (const s of deployed.schemas) {
+                clearCCFEFields(s);
+                output.push((0, js_yaml_1.dump)(s));
+            }
+        }
+        if ((_b = deployed.connectors) === null || _b === void 0 ? void 0 : _b.length) {
+            output.push(`### Connectors`);
+            for (const c of deployed.connectors) {
+                clearCCFEFields(c);
+                output.push((0, js_yaml_1.dump)(c));
+            }
+        }
+    }
+    if (localServices.length) {
+        output.push(`# Local Data Connect Sources`);
+        for (const s of localServices) {
+            const local = s.local;
+            output.push((0, js_yaml_1.dump)(local.dataConnectYaml));
+            const schemaDir = path.join(local.sourceDirectory, local.dataConnectYaml.schema.source);
+            output.push(`You can find all of schema sources under ${schemaDir}/`);
+            if (s.deployed) {
+                output.push(`It's already deployed in the backend:\n`);
+                includeDeployedServiceInfo(s.deployed);
+            }
+        }
+    }
+    if (remoteOnlyServices.length) {
+        output.push(`# Data Connect Services in project ${projectId}`);
+        for (const s of remoteOnlyServices) {
+            if (s.deployed) {
+                includeDeployedServiceInfo(s.deployed);
+            }
+        }
+    }
+    output.push(`\n# What's next?`);
+    if (!localServices.length) {
+        output.push(`- There is no local Data Connect service in the local workspace. Consider use the \`firebase_init\` MCP tool to setup one.`);
+    }
+    output.push(`- You can use the \`dataconnect_compile\` tool to compile all local Data Connect schemas and query sources.`);
+    output.push(`- You run \`firebase deploy\` in command line to deploy the Data Connect schemas, connector and perform SQL migrations.`);
+    return (0, util_1.toContent)(output.join("\n"));
 });
+function clearCCFEFields(r) {
+    const fieldsToClear = ["updateTime", "uid", "etag"];
+    for (const k of fieldsToClear) {
+        delete r[k];
+    }
+}

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/track.js

@@ -8,6 +8,19 @@ const configstore_1 = require("./configstore");
 const logger_1 = require("./logger");
 const env_1 = require("./env");
 const pkg = require("../package.json");
+function detectAIAgent() {
+    if (process.env.CODEX_SANDBOX)
+        return "codex_cli";
+    if (process.env.CLAUDECODE)
+        return "claude_code";
+    if (process.env.GEMINI_CLI)
+        return "gemini_cli";
+    if (process.env.CURSOR_AGENT)
+        return "cursor";
+    if (process.env.OPENCODE)
+        return "open_code";
+    return "unknown";
+}
 exports.GA4_PROPERTIES = {
     cli: {
         measurementId: process.env.FIREBASE_CLI_GA4_MEASUREMENT_ID || "G-PDN0QWHQJR",
@@ -45,6 +58,9 @@ const GA4_USER_PROPS = {
     is_firebase_studio: {
         value: (0, env_1.isFirebaseStudio)().toString(),
     },
+    ai_agent: {
+        value: detectAIAgent(),
+    },
 };
 async function trackGA4(eventName, params, duration = 1) {
     const session = cliSession();

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.1",
+  "version": "14.16.0",
   "description": "Command-Line Interface for Firebase",
   "main": "./lib/index.js",
   "bin": {