firebase-tools 14.12.0 → 14.13.0

package/lib/management/studio.js

@@ -110,7 +110,7 @@ async function updateStudioFirebaseProject(projectId) {
         if (err.original) {
             message += ` (original: ${err.original.message})`;
         }
-        logger_1.logger.warn(`Failed to update active Firebase Project for current Studio Workspace: ${message}`);
+        logger_1.logger.debug(`Failed to update active Firebase Project for current Studio Workspace: ${message}`);
     }
     recordStudioProjectSyncTime();
 }

package/lib/mcp/index.js

@@ -7,6 +7,7 @@ const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
 const util_1 = require("./util");
 const types_1 = require("./types");
 const index_1 = require("./tools/index");
+const index_2 = require("./prompts/index");
 const configstore_1 = require("../configstore");
 const command_1 = require("../command");
 const requireAuth_1 = require("../requireAuth");
@@ -22,7 +23,7 @@ const api = require("../api");
 const logging_transport_1 = require("./logging-transport");
 const env_1 = require("../env");
 const timeout_1 = require("../timeout");
-const SERVER_VERSION = "0.2.0";
+const SERVER_VERSION = "0.3.0";
 const cmd = new command_1.Command("experimental:mcp");
 const orderedLogLevels = [
     "debug",
@@ -56,9 +57,15 @@ class FirebaseMcpServer {
         this.activeFeatures = options.activeFeatures;
         this.startupRoot = options.projectRoot || process.env.PROJECT_ROOT;
         this.server = new index_js_1.Server({ name: "firebase", version: SERVER_VERSION });
-        this.server.registerCapabilities({ tools: { listChanged: true }, logging: {} });
+        this.server.registerCapabilities({
+            tools: { listChanged: true },
+            logging: {},
+            prompts: { listChanged: true },
+        });
         this.server.setRequestHandler(types_js_1.ListToolsRequestSchema, this.mcpListTools.bind(this));
         this.server.setRequestHandler(types_js_1.CallToolRequestSchema, this.mcpCallTool.bind(this));
+        this.server.setRequestHandler(types_js_1.ListPromptsRequestSchema, this.mcpListPrompts.bind(this));
+        this.server.setRequestHandler(types_js_1.GetPromptRequestSchema, this.mcpGetPrompt.bind(this));
         this.server.oninitialized = async () => {
             var _a, _b;
             const clientInfo = this.server.getClientVersion();
@@ -159,11 +166,19 @@ class FirebaseMcpServer {
     getTool(name) {
         return this.availableTools.find((t) => t.mcp.name === name) || null;
     }
+    get availablePrompts() {
+        var _a;
+        return (0, index_2.availablePrompts)(((_a = this.activeFeatures) === null || _a === void 0 ? void 0 : _a.length) ? this.activeFeatures : this.detectedFeatures);
+    }
+    getPrompt(name) {
+        return this.availablePrompts.find((p) => p.mcp.name === name) || null;
+    }
     setProjectRoot(newRoot) {
         this.updateStoredClientConfig({ projectRoot: newRoot });
         this.cachedProjectRoot = newRoot || undefined;
         this.detectedFeatures = undefined;
         void this.server.sendToolListChanged();
+        void this.server.sendPromptListChanged();
     }
     async resolveOptions() {
         const options = { cwd: this.cachedProjectRoot, isMCP: true };
@@ -258,6 +273,64 @@ class FirebaseMcpServer {
             return (0, util_1.mcpError)(err);
         }
     }
+    async mcpListPrompts() {
+        await Promise.all([this.detectActiveFeatures(), this.detectProjectRoot()]);
+        const hasActiveProject = !!(await this.getProjectId());
+        await this.trackGA4("mcp_list_prompts");
+        const skipAutoAuthForStudio = (0, env_1.isFirebaseStudio)();
+        return {
+            prompts: this.availablePrompts.map((p) => ({
+                name: p.mcp.name,
+                description: p.mcp.description,
+                annotations: p.mcp.annotations,
+                arguments: p.mcp.arguments,
+            })),
+            _meta: {
+                projectRoot: this.cachedProjectRoot,
+                projectDetected: hasActiveProject,
+                authenticatedUser: await this.getAuthenticatedUser(skipAutoAuthForStudio),
+                activeFeatures: this.activeFeatures,
+                detectedFeatures: this.detectedFeatures,
+            },
+        };
+    }
+    async mcpGetPrompt(req) {
+        await this.detectProjectRoot();
+        const promptName = req.params.name;
+        const promptArgs = req.params.arguments || {};
+        const prompt = this.getPrompt(promptName);
+        if (!prompt) {
+            throw new Error(`Prompt '${promptName}' could not be found.`);
+        }
+        let projectId = await this.getProjectId();
+        projectId = projectId || "";
+        const skipAutoAuthForStudio = (0, env_1.isFirebaseStudio)();
+        const accountEmail = await this.getAuthenticatedUser(skipAutoAuthForStudio);
+        const options = { projectDir: this.cachedProjectRoot, cwd: this.cachedProjectRoot };
+        const promptsCtx = {
+            projectId: projectId,
+            host: this,
+            config: config_1.Config.load(options, true) || new config_1.Config({}, options),
+            rc: (0, rc_1.loadRC)(options),
+            accountEmail,
+        };
+        try {
+            const messages = await prompt.fn(promptArgs, promptsCtx);
+            await this.trackGA4("mcp_get_prompt", {
+                tool_name: promptName,
+            });
+            return {
+                messages,
+            };
+        }
+        catch (err) {
+            await this.trackGA4("mcp_get_prompt", {
+                tool_name: promptName,
+                error: 1,
+            });
+            throw err;
+        }
+    }
     async start() {
         const transport = process.env.FIREBASE_MCP_DEBUG_LOG
             ? new logging_transport_1.LoggingStdioServerTransport(process.env.FIREBASE_MCP_DEBUG_LOG)

package/lib/mcp/prompt.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prompt = void 0;
+function prompt(options, fn) {
+    return {
+        mcp: options,
+        fn,
+    };
+}
+exports.prompt = prompt;

package/lib/mcp/prompts/core/deploy.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deploy = void 0;
+const prompt_1 = require("../../prompt");
+exports.deploy = (0, prompt_1.prompt)({
+    name: "deploy",
+    omitPrefix: true,
+    description: "Use this command to deploy resources to Firebase.",
+    arguments: [
+        {
+            name: "prompt",
+            description: "any specific instructions you wish to provide about deploying",
+            required: false,
+        },
+    ],
+    annotations: {
+        title: "Deploy to Firebase",
+    },
+}, async ({ prompt }, { config, projectId, accountEmail }) => {
+    return [
+        {
+            role: "user",
+            content: {
+                type: "text",
+                text: `
+Your goal is to deploy resources from the current project to Firebase.
+
+Active user: ${accountEmail || "<NONE>"}
+Active project: ${projectId || "<NONE>"}
+
+Contents of \`firebase.json\` config file:
+
+\`\`\`json
+${config.readProjectFile("firebase.json", { fallback: "<FILE DOES NOT EXIST>" })}
+\`\`\`
+
+## User Instructions
+
+${prompt || "<the user didn't supply specific instructions>"}
+
+## Steps
+
+Follow the steps below taking note of any user instructions provided above.
+
+1. If there is no active user, prompt the user to run \`firebase login\` in an interactive terminal before continuing.
+2. If there is no \`firebase.json\` file and the current workspace is a static web application, manually create a \`firebase.json\` with \`"hosting"\` configuration based on the current directory's web app configuration. Add a \`{"hosting": {"predeploy": "<build_script>"}}\` config to build before deploying.
+3. If there is no active project, ask the user if they want to use an existing project or create a new one.
+  3a. If create a new one, use the \`firebase_create_project\` tool.
+  3b. If they want to use an existing one, ask them for a project id (the \`firebase_list_projects\` tool may be helpful).
+4. Only after making sure Firebase has been initialized, run the \`firebase deploy\` shell command to perform the deploy. This may take a few minutes.
+5. If the deploy has errors, attempt to fix them and ask the user clarifying questions as needed.
+6. If the deploy needs \`--force\` to run successfully, ALWAYS prompt the user before running \`firebase deploy --force\`.
+7. If only one specific feature is failing, use command \`firebase deploy --only <feature>\` as you debug.
+`.trim(),
+            },
+        },
+    ];
+});

package/lib/mcp/prompts/core/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.corePrompts = void 0;
+const deploy_1 = require("./deploy");
+exports.corePrompts = [deploy_1.deploy];

package/lib/mcp/prompts/index.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.availablePrompts = void 0;
+const core_1 = require("./core");
+const prompts = {
+    core: core_1.corePrompts,
+    firestore: [],
+    storage: [],
+    dataconnect: [],
+    auth: [],
+    messaging: [],
+    remoteconfig: [],
+    crashlytics: [],
+    apphosting: [],
+    database: [],
+};
+function namespacePrompts(promptsToNamespace, feature) {
+    return promptsToNamespace.map((p) => {
+        const newPrompt = Object.assign({}, p);
+        newPrompt.mcp = Object.assign({}, p.mcp);
+        if (newPrompt.mcp.omitPrefix) {
+        }
+        else if (feature === "core") {
+            newPrompt.mcp.name = `firebase:${p.mcp.name}`;
+        }
+        else {
+            newPrompt.mcp.name = `firebase:${feature}:${p.mcp.name}`;
+        }
+        newPrompt.mcp._meta = Object.assign(Object.assign({}, p.mcp._meta), { feature });
+        return newPrompt;
+    });
+}
+function availablePrompts(features) {
+    const allPrompts = namespacePrompts(prompts["core"], "core");
+    if (!features) {
+        features = Object.keys(prompts).filter((f) => f !== "core");
+    }
+    for (const feature of features) {
+        if (prompts[feature] && feature !== "core") {
+            allPrompts.push(...namespacePrompts(prompts[feature], feature));
+        }
+    }
+    return allPrompts;
+}
+exports.availablePrompts = availablePrompts;

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

@@ -37,5 +37,15 @@ exports.get_sdk_config = (0, tool_1.tool)({
     if (!appId)
         return (0, util_1.mcpError)(`Could not find an app for platform '${inputPlatform}' in project '${projectId}'`);
     const sdkConfig = await (0, apps_1.getAppConfig)(appId, platform);
+    if ("configFilename" in sdkConfig) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `SDK config content for \`${sdkConfig.configFilename}\`:\n\n\`\`\`\n${Buffer.from(sdkConfig.configFileContents, "base64").toString("utf-8")}\n\`\`\``,
+                },
+            ],
+        };
+    }
     return (0, util_1.toContent)(sdkConfig, { format: "json" });
 });

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

@@ -54,6 +54,10 @@ exports.init = (0, tool_1.tool)({
                 .describe("Provide this object to initialize Cloud Firestore in this project directory."),
             dataconnect: zod_1.z
                 .object({
+                app_description: zod_1.z
+                    .string()
+                    .optional()
+                    .describe("Provide a description of the app you are trying to build. If present, Gemini will help generate Data Connect Schema, Connector and seed data"),
                 service_id: zod_1.z
                     .string()
                     .optional()
@@ -74,7 +78,7 @@ exports.init = (0, tool_1.tool)({
                     .describe("The Postgres database ID to use in the Firebase Data Connect service."),
             })
                 .optional()
-                .describe("Provide this object to initialize Firebase Data Connect in this project directory."),
+                .describe("Provide this object to initialize Firebase Data Connect with Cloud SQL Postgres in this project directory."),
             storage: zod_1.z
                 .object({
                 rules_filename: zod_1.z
@@ -127,15 +131,12 @@ exports.init = (0, tool_1.tool)({
     if (features.dataconnect) {
         featuresList.push("dataconnect");
         featureInfo.dataconnect = {
+            analyticsFlow: "mcp",
+            appDescription: features.dataconnect.app_description || "",
             serviceId: features.dataconnect.service_id || "",
             locationId: features.dataconnect.location_id || "",
             cloudSqlInstanceId: features.dataconnect.cloudsql_instance_id || "",
             cloudSqlDatabase: features.dataconnect.cloudsql_database || "",
-            connectors: [],
-            isNewInstance: false,
-            isNewDatabase: false,
-            schemaGql: [],
-            shouldProvisionCSQL: true,
         };
     }
     const setup = {

package/lib/mcp/tools/crashlytics/get_issue_details.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.get_issue_details = void 0;
+const zod_1 = require("zod");
+const tool_1 = require("../../tool");
+const util_1 = require("../../util");
+const getIssueDetails_1 = require("../../../crashlytics/getIssueDetails");
+exports.get_issue_details = (0, tool_1.tool)({
+    name: "get_issue_details",
+    description: "Gets the details about a specific crashlytics issue.",
+    inputSchema: zod_1.z.object({
+        app_id: zod_1.z
+            .string()
+            .describe("The AppID for which the issues list should be fetched. For an Android application, read the mobilesdk_app_id value specified in the google-services.json file for the current package name. For an iOS Application, read the GOOGLE_APP_ID from GoogleService-Info.plist. If neither is available, use the `firebase_list_apps` tool to find an app_id to pass to this tool."),
+        issue_id: zod_1.z
+            .string()
+            .describe("The issue ID for which the details needs to be fetched. This is the value of the field `id` in the list of issues. Defaults to the first id in the list of issues."),
+    }),
+    annotations: {
+        title: "Gets the details of a specific issue.",
+        readOnlyHint: true,
+    },
+    _meta: {
+        requiresAuth: true,
+        requiresProject: false,
+    },
+}, async ({ app_id, issue_id }) => {
+    if (!app_id)
+        return (0, util_1.mcpError)(`Must specify 'app_id' parameter.`);
+    if (!issue_id)
+        return (0, util_1.mcpError)(`Must specify 'issue_id' parameter.`);
+    return (0, util_1.toContent)(await (0, getIssueDetails_1.getIssueDetails)(app_id, issue_id));
+});

package/lib/mcp/tools/crashlytics/get_sample_crash.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.get_sample_crash = void 0;
+const zod_1 = require("zod");
+const tool_1 = require("../../tool");
+const util_1 = require("../../util");
+const getSampleCrash_1 = require("../../../crashlytics/getSampleCrash");
+exports.get_sample_crash = (0, tool_1.tool)({
+    name: "get_sample_crash_for_issue",
+    description: "Gets the sample crash for an issue.",
+    inputSchema: zod_1.z.object({
+        app_id: zod_1.z
+            .string()
+            .describe("AppId for which the issues list should be fetched. For an Android application, read the mobilesdk_app_id value specified in the google-services.json file for the current package name. For an iOS Application, read the GOOGLE_APP_ID from GoogleService-Info.plist. If neither is available, use the `firebase_list_apps` tool to find an app_id to pass to this tool."),
+        issue_id: zod_1.z
+            .string()
+            .describe("The issue Id for which the sample crash needs to be fetched. This is the value of the field `id` in the list of issues. Defaults to the first id in the list of issues."),
+        variant_id: zod_1.z
+            .string()
+            .optional()
+            .describe("The issue variant Id used as a filter to get sample issues."),
+        sample_count: zod_1.z
+            .number()
+            .describe("Number of samples that needs to be fetched. Maximum value is 3. Defaults to 1.")
+            .default(1),
+    }),
+    annotations: {
+        title: "Gets a sample of a crash for a specific issue.",
+        readOnlyHint: true,
+    },
+    _meta: {
+        requiresAuth: true,
+        requiresProject: false,
+    },
+}, async ({ app_id, issue_id, variant_id, sample_count }) => {
+    if (!app_id)
+        return (0, util_1.mcpError)(`Must specify 'app_id' parameter.`);
+    if (!issue_id)
+        return (0, util_1.mcpError)(`Must specify 'issue_id' parameter.`);
+    if (sample_count > 3)
+        sample_count = 3;
+    return (0, util_1.toContent)(await (0, getSampleCrash_1.getSampleCrash)(app_id, issue_id, sample_count, variant_id));
+});

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

@@ -1,5 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.crashlyticsTools = void 0;
+const get_issue_details_1 = require("./get_issue_details");
 const list_top_issues_1 = require("./list_top_issues");
-exports.crashlyticsTools = [list_top_issues_1.list_top_issues];
+const get_sample_crash_1 = require("./get_sample_crash");
+exports.crashlyticsTools = [
+    list_top_issues_1.list_top_issues,
+    get_issue_details_1.get_issue_details,
+    get_sample_crash_1.get_sample_crash,
+];

package/lib/mcp/tools/crashlytics/list_top_issues.js

@@ -16,7 +16,8 @@ exports.list_top_issues = (0, tool_1.tool)({
         issue_count: zod_1.z
             .number()
             .optional()
-            .describe("Number of issues that needs to be fetched. Defaults to 10 if unspecified."),
+            .describe("Number of issues that needs to be fetched. Defaults to 10 if unspecified.")
+            .default(10),
         issue_type: zod_1.z
             .enum(["FATAL", "NON-FATAL", "ANR"])
             .optional()

package/lib/mcp/tools/database/get_data.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.get_data = void 0;
+const zod_1 = require("zod");
+const tool_1 = require("../../tool");
+const util_1 = require("../../util");
+const url = require("node:url");
+const apiv2_1 = require("../../../apiv2");
+const consumers_1 = require("node:stream/consumers");
+const node_path_1 = require("node:path");
+exports.get_data = (0, tool_1.tool)({
+    name: "get_data",
+    description: "Returns RTDB data from the specified location",
+    inputSchema: zod_1.z.object({
+        databaseUrl: zod_1.z
+            .string()
+            .optional()
+            .describe("connect to the database at url. If omitted, use default database instance <project>-default-rtdb.firebasedatabase.app. Can point to emulator URL (e.g. localhost:6000/<instance>)"),
+        path: zod_1.z.string().describe("The path to the data to read. (ex: /my/cool/path)"),
+    }),
+    annotations: {
+        title: "Get Realtime Database data",
+        readOnlyHint: true,
+    },
+    _meta: {
+        requiresAuth: false,
+        requiresProject: false,
+    },
+}, async ({ path: getPath, databaseUrl }, { projectId, host }) => {
+    if (!getPath.startsWith("/")) {
+        return (0, util_1.mcpError)(`paths must start with '/' (you passed ''${getPath}')`);
+    }
+    const dbUrl = new url.URL(databaseUrl
+        ? `${databaseUrl}/${getPath}.json`
+        : node_path_1.default.join(`https://${projectId}-default-rtdb.us-central1.firebasedatabase.app`, `${getPath}.json`));
+    const client = new apiv2_1.Client({
+        urlPrefix: dbUrl.origin,
+        auth: true,
+    });
+    host.logger.debug(`sending read request to path '${getPath}' for url '${dbUrl.toString()}'`);
+    const res = await client.request({
+        method: "GET",
+        path: dbUrl.pathname,
+        responseType: "stream",
+        resolveOnHTTPError: true,
+    });
+    const content = await (0, consumers_1.text)(res.body);
+    return (0, util_1.toContent)(content);
+});

package/lib/mcp/tools/database/get_rules.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.get_rules = void 0;
+const zod_1 = require("zod");
+const apiv2_1 = require("../../../apiv2");
+const tool_1 = require("../../tool");
+const util_1 = require("../../util");
+exports.get_rules = (0, tool_1.tool)({
+    name: "get_rules",
+    description: "Get an RTDB database's rules",
+    inputSchema: zod_1.z.object({
+        databaseUrl: zod_1.z
+            .string()
+            .optional()
+            .describe("connect to the database at url. If omitted, use default database instance <project>-default-rtdb.firebaseio.com. Can point to emulator URL (e.g. localhost:6000/<instance>)"),
+    }),
+    annotations: {
+        title: "Get Realtime Database rules",
+        readOnlyHint: true,
+    },
+    _meta: {
+        requiresAuth: false,
+        requiresProject: false,
+    },
+}, async ({ databaseUrl }, { projectId }) => {
+    const dbUrl = databaseUrl !== null && databaseUrl !== void 0 ? databaseUrl : `https://${projectId}-default-rtdb.us-central1.firebasedatabase.app`;
+    const client = new apiv2_1.Client({ urlPrefix: dbUrl });
+    const response = await client.request({
+        method: "GET",
+        path: "/.settings/rules.json",
+        responseType: "stream",
+        resolveOnHTTPError: true,
+    });
+    if (response.status !== 200) {
+        return (0, util_1.mcpError)(`Failed to fetch current rules. Code: ${response.status}`);
+    }
+    const rules = await response.response.text();
+    return (0, util_1.toContent)(rules);
+});

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

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.realtimeDatabaseTools = void 0;
+const get_rules_1 = require("./get_rules");
+const get_data_1 = require("./get_data");
+const set_data_1 = require("./set_data");
+const validate_rules_1 = require("./validate_rules");
+exports.realtimeDatabaseTools = [get_data_1.get_data, set_data_1.set_data, get_rules_1.get_rules, validate_rules_1.validate_rules];

package/lib/mcp/tools/database/set_data.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.set_data = void 0;
+const zod_1 = require("zod");
+const tool_1 = require("../../tool");
+const util_1 = require("../../util");
+const url = require("node:url");
+const utils_1 = require("../../../utils");
+const apiv2_1 = require("../../../apiv2");
+const error_1 = require("../../../error");
+const node_path_1 = require("node:path");
+exports.set_data = (0, tool_1.tool)({
+    name: "set_data",
+    description: "Writes RTDB data to the specified location",
+    inputSchema: zod_1.z.object({
+        databaseUrl: zod_1.z
+            .string()
+            .optional()
+            .describe("connect to the database at url. If omitted, use default database instance <project>-default-rtdb.us-central1.firebasedatabase.app. Can point to emulator URL (e.g. localhost:6000/<instance>)"),
+        path: zod_1.z.string().describe("The path to the data to read. (ex: /my/cool/path)"),
+        data: zod_1.z.string().describe('The JSON to write. (ex: {"alphabet": ["a", "b", "c"]})'),
+    }),
+    annotations: {
+        title: "Set Realtime Database data",
+        readOnlyHint: false,
+        idempotentHint: true,
+    },
+    _meta: {
+        requiresAuth: false,
+        requiresProject: false,
+    },
+}, async ({ path: setPath, databaseUrl, data }, { projectId, host }) => {
+    if (!setPath.startsWith("/")) {
+        return (0, util_1.mcpError)(`paths must start with '/' (you passed ''${setPath}')`);
+    }
+    const dbUrl = new url.URL(databaseUrl
+        ? `${databaseUrl}/${setPath}.json`
+        : node_path_1.default.join(`https://${projectId}-default-rtdb.us-central1.firebasedatabase.app`, `${setPath}.json`));
+    const client = new apiv2_1.Client({
+        urlPrefix: dbUrl.origin,
+        auth: true,
+    });
+    const inStream = (0, utils_1.stringToStream)(data);
+    host.logger.debug(`sending write request to path '${setPath}' for url '${dbUrl.toString()}'`);
+    try {
+        await client.request({
+            method: "PUT",
+            path: dbUrl.pathname,
+            body: inStream,
+        });
+    }
+    catch (err) {
+        host.logger.debug((0, error_1.getErrMsg)(err));
+        return (0, util_1.mcpError)(`Unexpected error while setting data: ${(0, error_1.getErrMsg)(err)}`);
+    }
+    return (0, util_1.toContent)("write successful!");
+});

package/lib/mcp/tools/database/set_rules.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validate_rules = void 0;
+const zod_1 = require("zod");
+const apiv2_1 = require("../../../apiv2");
+const tool_1 = require("../../tool");
+const util_1 = require("../../util");
+const rtdb_1 = require("../../../rtdb");
+const error_1 = require("../../../error");
+exports.validate_rules = (0, tool_1.tool)({
+    name: "validate_rules",
+    description: "Validates an RTDB database's rules",
+    inputSchema: zod_1.z.object({
+        databaseUrl: zod_1.z
+            .string()
+            .optional()
+            .describe("connect to the database at url. If omitted, use default database instance <project>-default-rtdb.firebaseio.com. Can point to emulator URL (e.g. localhost:6000/<instance>)"),
+        rules: zod_1.z
+            .string()
+            .describe('The rules object, as a string (ex: {".read": false, ".write": false})'),
+    }),
+    annotations: {
+        title: "Validate Realtime Database rules",
+        idempotentHint: true,
+    },
+    _meta: {
+        requiresAuth: true,
+        requiresProject: false,
+    },
+}, async ({ databaseUrl, rules }, { projectId, host }) => {
+    const dbUrl = databaseUrl !== null && databaseUrl !== void 0 ? databaseUrl : `https://${projectId}-default-rtdb.us-central1.firebasedatabase.app`;
+    const client = new apiv2_1.Client({ urlPrefix: dbUrl });
+    try {
+        await (0, rtdb_1.updateRulesWithClient)(client, rules, { dryRun: true });
+    }
+    catch (e) {
+        host.logger.debug(`failed to update rules at url ${dbUrl}`);
+        return (0, util_1.mcpError)((0, error_1.getErrMsg)(e));
+    }
+    return (0, util_1.toContent)("the inputted rules are valid!");
+});

package/lib/mcp/tools/database/validate_rules.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validate_rules = void 0;
+const zod_1 = require("zod");
+const apiv2_1 = require("../../../apiv2");
+const tool_1 = require("../../tool");
+const util_1 = require("../../util");
+const rtdb_1 = require("../../../rtdb");
+const error_1 = require("../../../error");
+exports.validate_rules = (0, tool_1.tool)({
+    name: "validate_rules",
+    description: "Validates an RTDB database's rules",
+    inputSchema: zod_1.z.object({
+        databaseUrl: zod_1.z
+            .string()
+            .optional()
+            .describe("connect to the database at url. If omitted, use default database instance <project>-default-rtdb.firebaseio.com. Can point to emulator URL (e.g. localhost:6000/<instance>)"),
+        rules: zod_1.z
+            .string()
+            .describe('The rules object, as a string (ex: {"rules": {".read": false, ".write": false}})'),
+    }),
+    annotations: {
+        title: "Validate Realtime Database rules",
+        idempotentHint: true,
+    },
+    _meta: {
+        requiresAuth: true,
+        requiresProject: false,
+    },
+}, async ({ databaseUrl, rules }, { projectId, host }) => {
+    const dbUrl = databaseUrl !== null && databaseUrl !== void 0 ? databaseUrl : `https://${projectId}-default-rtdb.us-central1.firebasedatabase.app`;
+    const client = new apiv2_1.Client({ urlPrefix: dbUrl });
+    try {
+        await (0, rtdb_1.updateRulesWithClient)(client, rules, { dryRun: true });
+    }
+    catch (e) {
+        host.logger.debug(`failed to validate rules at url ${dbUrl}`);
+        return (0, util_1.mcpError)((0, error_1.getErrMsg)(e));
+    }
+    return (0, util_1.toContent)("the inputted rules are valid!");
+});