firebase-tools 15.4.0 → 15.5.1

package/lib/emulator/dataconnect/pgliteServer.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PGliteExtendedQueryPatch = exports.PostgresServer = exports.TRUNCATE_TABLES_SQL = void 0;
+exports.PGliteLoggerPatch = exports.PostgresServer = exports.TRUNCATE_TABLES_SQL = void 0;
 exports.fromNodeSocket = fromNodeSocket;
 const pglite_1 = require("@electric-sql/pglite");
 const { dynamicImport } = require(true && "../../dynamicImport");
@@ -42,12 +42,12 @@ class PostgresServer {
                         await db.query("DEALLOCATE ALL");
                     }
                     const response = await db.execProtocolRaw(data);
-                    for await (const message of extendedQueryPatch.filterResponse(data, response)) {
+                    for await (const message of extendedQueryPatch.getMessages(data, response)) {
                         yield message;
                     }
                 },
             });
-            const extendedQueryPatch = new PGliteExtendedQueryPatch(connection);
+            const extendedQueryPatch = new PGliteLoggerPatch(connection);
             socket.on("end", () => {
                 logger_1.logger.debug("Postgres client disconnected");
             });
@@ -202,42 +202,35 @@ async function fromNodeSocket(socket, options) {
         : undefined;
     return new pg_gateway_1.PostgresConnection({ readable: rs, writable: ws }, opts);
 }
-class PGliteExtendedQueryPatch {
+const CODE_TO_FRONTEND_MESSAGE = {};
+for (const key in pg_gateway_1.FrontendMessageCode) {
+    if (Object.prototype.hasOwnProperty.call(pg_gateway_1.FrontendMessageCode, key)) {
+        CODE_TO_FRONTEND_MESSAGE[pg_gateway_1.FrontendMessageCode[key]] = key;
+    }
+}
+const CODE_TO_BACKEND_MESSAGE = {};
+for (const key in pg_gateway_1.BackendMessageCode) {
+    if (Object.prototype.hasOwnProperty.call(pg_gateway_1.BackendMessageCode, key)) {
+        CODE_TO_BACKEND_MESSAGE[pg_gateway_1.BackendMessageCode[key]] = key;
+    }
+}
+function codeToFrontendMessageName(code) {
+    return CODE_TO_FRONTEND_MESSAGE[code] || `UNKNOWN_FRONTEND_CODE_${code}`;
+}
+function codeTogBackendMessageName(code) {
+    return CODE_TO_BACKEND_MESSAGE[code] || `UNKNOWN_BACKEND_CODE_${code}`;
+}
+class PGliteLoggerPatch {
     constructor(connection) {
         this.connection = connection;
-        this.isExtendedQuery = false;
-        this.eqpErrored = false;
         this.pgliteDebugLog = fs.createWriteStream("pglite-debug.log");
     }
-    async *filterResponse(message, response) {
-        const pipelineStartMessages = [
-            pg_gateway_1.FrontendMessageCode.Parse,
-            pg_gateway_1.FrontendMessageCode.Bind,
-            pg_gateway_1.FrontendMessageCode.Close,
-        ];
-        const decoded = decoder.write(message);
-        this.pgliteDebugLog.write("Front: " + decoded);
-        if (pipelineStartMessages.includes(message[0])) {
-            this.isExtendedQuery = true;
-        }
-        if (message[0] === pg_gateway_1.FrontendMessageCode.Sync) {
-            this.isExtendedQuery = false;
-            this.eqpErrored = false;
-        }
+    async *getMessages(request, response) {
+        this.pgliteDebugLog.write(`\n[-> ${codeToFrontendMessageName(request[0])}] ` + decoder.write(request));
         for await (const bm of (0, pg_gateway_1.getMessages)(response)) {
-            if (this.eqpErrored) {
-                continue;
-            }
-            if (this.isExtendedQuery && bm[0] === pg_gateway_1.BackendMessageCode.ErrorMessage) {
-                this.eqpErrored = true;
-            }
-            if (this.isExtendedQuery && bm[0] === pg_gateway_1.BackendMessageCode.ReadyForQuery) {
-                this.pgliteDebugLog.write("Filtered: " + decoder.write(bm));
-                continue;
-            }
-            this.pgliteDebugLog.write("Sent: " + decoder.write(bm));
+            this.pgliteDebugLog.write(`\n[<- ${codeTogBackendMessageName(bm[0])}] ${decoder.write(bm)}`);
             yield bm;
         }
     }
 }
-exports.PGliteExtendedQueryPatch = PGliteExtendedQueryPatch;
+exports.PGliteLoggerPatch = PGliteLoggerPatch;

package/lib/emulator/downloadableEmulatorInfo.json

@@ -54,36 +54,36 @@
     },
     "dataconnect": {
         "darwin": {
-            "version": "3.1.0",
-            "expectedSize": 30315360,
-            "expectedChecksum": "f9bffb5f86bcff271d75e79a8439cb8d",
-            "expectedChecksumSHA256": "a9dac9a7dc90063d12ba5201d6e21cd7e62e68f1f10a537a9b302a21d9ffdef6",
-            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-macos-amd64-v3.1.0",
-            "downloadPathRelativeToCacheDir": "dataconnect-emulator-3.1.0"
+            "version": "3.1.1",
+            "expectedSize": 30450528,
+            "expectedChecksum": "06e49453e3c9f876d445972a3588965f",
+            "expectedChecksumSHA256": "07dbbb5d1356597acc478d3c58dbf48e716b3795f4da0e7e174b0fd472b004d2",
+            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-macos-amd64-v3.1.1",
+            "downloadPathRelativeToCacheDir": "dataconnect-emulator-3.1.1"
         },
         "darwin_arm64": {
-            "version": "3.1.0",
-            "expectedSize": 29796738,
-            "expectedChecksum": "668bb418e970aa90874afa3ac4e84d48",
-            "expectedChecksumSHA256": "ab94429f31f9354ead44ff3b3e0cc548b06244da0feb1f2c971a8f9c33519623",
-            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-macos-arm64-v3.1.0",
-            "downloadPathRelativeToCacheDir": "dataconnect-emulator-3.1.0"
+            "version": "3.1.1",
+            "expectedSize": 29916818,
+            "expectedChecksum": "477dd3da175dba6d7545ade62a8274f6",
+            "expectedChecksumSHA256": "472fe448f25fa8546aa383406db78eaf4eec4d8b700bb325dbc65899aba1bd20",
+            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-macos-arm64-v3.1.1",
+            "downloadPathRelativeToCacheDir": "dataconnect-emulator-3.1.1"
         },
         "win32": {
-            "version": "3.1.0",
-            "expectedSize": 30815744,
-            "expectedChecksum": "179244e68571a7fdc97a15921eeffa16",
-            "expectedChecksumSHA256": "c8b1dbf4c21046c09ed065952523a72678644423afc99b6ea4d0f559735b3437",
-            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-windows-amd64-v3.1.0",
-            "downloadPathRelativeToCacheDir": "dataconnect-emulator-3.1.0.exe"
+            "version": "3.1.1",
+            "expectedSize": 30951424,
+            "expectedChecksum": "c51ec99bffd2f37fa2bb793f7cc74ea7",
+            "expectedChecksumSHA256": "e03d0dae5f040b03d211d6741540ed11206b03548b230eb8e36338b5b57545ee",
+            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-windows-amd64-v3.1.1",
+            "downloadPathRelativeToCacheDir": "dataconnect-emulator-3.1.1.exe"
         },
         "linux": {
-            "version": "3.1.0",
-            "expectedSize": 30236856,
-            "expectedChecksum": "4314f5cb06307974bce9d0da1d4034fb",
-            "expectedChecksumSHA256": "6ced51471ba1dae0e0bd12263f558ce371901393ebbbb4ba8d2c298866600218",
-            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-linux-amd64-v3.1.0",
-            "downloadPathRelativeToCacheDir": "dataconnect-emulator-3.1.0"
+            "version": "3.1.1",
+            "expectedSize": 30372024,
+            "expectedChecksum": "8a3977f07facaacaa9be3f9ec6bd90b7",
+            "expectedChecksumSHA256": "5c36d16d4ded51dd887c939a82e8cdc7e84cb40a2c5d00cb02bff90ca65c2472",
+            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-linux-amd64-v3.1.1",
+            "downloadPathRelativeToCacheDir": "dataconnect-emulator-3.1.1"
         }
     }
 }

package/lib/ensureApiEnabled.js

@@ -27,7 +27,7 @@ async function check(projectId, apiUri, prefix, silent = false) {
         return true;
     }
     const res = await apiClient.get(`/projects/${projectId}/services/${apiName}`, {
-        headers: { "x-goog-quota-user": `projects/${projectId}` },
+        headers: { "x-goog-user-project": `${projectId}` },
         skipLog: { resBody: true },
     });
     const isEnabled = res.body.state === "ENABLED";
@@ -45,7 +45,7 @@ function isPermissionError(e) {
 async function enable(projectId, apiName) {
     try {
         await apiClient.post(`/projects/${projectId}/services/${apiName}:enable`, undefined, {
-            headers: { "x-goog-quota-user": `projects/${projectId}` },
+            headers: { "x-goog-user-project": `${projectId}` },
             skipLog: { resBody: true },
         });
         cacheEnabledAPI(projectId, apiName);

package/lib/firestore/api-types.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RecurrenceType = exports.DatabaseEdition = exports.PointInTimeRecoveryEnablement = exports.PointInTimeRecoveryEnablementOption = exports.DatabaseDeleteProtectionState = exports.DatabaseDeleteProtectionStateOption = exports.DatabaseType = exports.StateTtl = exports.State = exports.ArrayConfig = exports.Order = exports.Density = exports.ApiScope = exports.QueryScope = exports.Mode = void 0;
+exports.RecurrenceType = exports.DatabaseEdition = exports.DataAccessMode = exports.RealtimeUpdatesMode = exports.PointInTimeRecoveryEnablement = exports.DatabaseDeleteProtectionState = exports.EnablementOption = exports.DatabaseType = exports.StateTtl = exports.State = exports.ArrayConfig = exports.Order = exports.Density = exports.ApiScope = exports.QueryScope = exports.Mode = void 0;
+exports.validateEnablementOption = validateEnablementOption;
+const error_1 = require("../error");
 var Mode;
 (function (Mode) {
     Mode["ASCENDING"] = "ASCENDING";
@@ -51,26 +53,32 @@ var DatabaseType;
     DatabaseType["DATASTORE_MODE"] = "DATASTORE_MODE";
     DatabaseType["FIRESTORE_NATIVE"] = "FIRESTORE_NATIVE";
 })(DatabaseType || (exports.DatabaseType = DatabaseType = {}));
-var DatabaseDeleteProtectionStateOption;
-(function (DatabaseDeleteProtectionStateOption) {
-    DatabaseDeleteProtectionStateOption["ENABLED"] = "ENABLED";
-    DatabaseDeleteProtectionStateOption["DISABLED"] = "DISABLED";
-})(DatabaseDeleteProtectionStateOption || (exports.DatabaseDeleteProtectionStateOption = DatabaseDeleteProtectionStateOption = {}));
+var EnablementOption;
+(function (EnablementOption) {
+    EnablementOption["ENABLED"] = "ENABLED";
+    EnablementOption["DISABLED"] = "DISABLED";
+})(EnablementOption || (exports.EnablementOption = EnablementOption = {}));
 var DatabaseDeleteProtectionState;
 (function (DatabaseDeleteProtectionState) {
     DatabaseDeleteProtectionState["ENABLED"] = "DELETE_PROTECTION_ENABLED";
     DatabaseDeleteProtectionState["DISABLED"] = "DELETE_PROTECTION_DISABLED";
 })(DatabaseDeleteProtectionState || (exports.DatabaseDeleteProtectionState = DatabaseDeleteProtectionState = {}));
-var PointInTimeRecoveryEnablementOption;
-(function (PointInTimeRecoveryEnablementOption) {
-    PointInTimeRecoveryEnablementOption["ENABLED"] = "ENABLED";
-    PointInTimeRecoveryEnablementOption["DISABLED"] = "DISABLED";
-})(PointInTimeRecoveryEnablementOption || (exports.PointInTimeRecoveryEnablementOption = PointInTimeRecoveryEnablementOption = {}));
 var PointInTimeRecoveryEnablement;
 (function (PointInTimeRecoveryEnablement) {
     PointInTimeRecoveryEnablement["ENABLED"] = "POINT_IN_TIME_RECOVERY_ENABLED";
     PointInTimeRecoveryEnablement["DISABLED"] = "POINT_IN_TIME_RECOVERY_DISABLED";
 })(PointInTimeRecoveryEnablement || (exports.PointInTimeRecoveryEnablement = PointInTimeRecoveryEnablement = {}));
+var RealtimeUpdatesMode;
+(function (RealtimeUpdatesMode) {
+    RealtimeUpdatesMode["ENABLED"] = "REALTIME_UPDATES_MODE_ENABLED";
+    RealtimeUpdatesMode["DISABLED"] = "REALTIME_UPDATES_MODE_DISABLED";
+})(RealtimeUpdatesMode || (exports.RealtimeUpdatesMode = RealtimeUpdatesMode = {}));
+var DataAccessMode;
+(function (DataAccessMode) {
+    DataAccessMode["UNSPECIFIED"] = "DATA_ACCESS_MODE_UNSPECIFIED";
+    DataAccessMode["ENABLED"] = "DATA_ACCESS_MODE_ENABLED";
+    DataAccessMode["DISABLED"] = "DATA_ACCESS_MODE_DISABLED";
+})(DataAccessMode || (exports.DataAccessMode = DataAccessMode = {}));
 var DatabaseEdition;
 (function (DatabaseEdition) {
     DatabaseEdition["DATABASE_EDITION_UNSPECIFIED"] = "DATABASE_EDITION_UNSPECIFIED";
@@ -82,3 +90,10 @@ var RecurrenceType;
     RecurrenceType["DAILY"] = "DAILY";
     RecurrenceType["WEEKLY"] = "WEEKLY";
 })(RecurrenceType || (exports.RecurrenceType = RecurrenceType = {}));
+function validateEnablementOption(optionValue, flagName, helpCommandText) {
+    if (optionValue &&
+        optionValue !== EnablementOption.ENABLED &&
+        optionValue !== EnablementOption.DISABLED) {
+        throw new error_1.FirebaseError(`Invalid value for flag --${flagName}. ${helpCommandText}`);
+    }
+}

package/lib/firestore/api.js

@@ -536,6 +536,9 @@ class FirestoreApi {
             databaseEdition: req.databaseEdition,
             deleteProtectionState: req.deleteProtectionState,
             pointInTimeRecoveryEnablement: req.pointInTimeRecoveryEnablement,
+            realtimeUpdatesMode: req.realtimeUpdatesMode,
+            firestoreDataAccessMode: req.firestoreDataAccessMode,
+            mongodbCompatibleDataAccessMode: req.mongodbCompatibleDataAccessMode,
             cmekConfig: req.cmekConfig,
         };
         const options = { queryParams: { databaseId: req.databaseId } };

package/lib/gcp/iam.js

@@ -63,7 +63,7 @@ async function testResourceIamPermissions(origin, apiVersion, resourceName, perm
     }
     const headers = {};
     if (quotaUser) {
-        headers["x-goog-quota-user"] = quotaUser;
+        headers["x-goog-user-project"] = quotaUser;
     }
     const response = await localClient.post(`/${resourceName}:testIamPermissions`, { permissions }, { headers });
     const allowed = new Set(response.body.permissions || []);
@@ -78,7 +78,7 @@ async function testResourceIamPermissions(origin, apiVersion, resourceName, perm
     };
 }
 async function testIamPermissions(projectId, permissions) {
-    return testResourceIamPermissions((0, api_1.resourceManagerOrigin)(), "v1", `projects/${projectId}`, permissions, `projects/${projectId}`);
+    return testResourceIamPermissions((0, api_1.resourceManagerOrigin)(), "v1", `projects/${projectId}`, permissions, `${projectId}`);
 }
 function mergeBindings(policy, requiredBindings) {
     let updated = false;

package/lib/gcp/rules.js

@@ -28,9 +28,12 @@ function _handleErrorResponse(response) {
         code: 2,
     });
 }
-async function getLatestRulesetName(projectId, service) {
+async function getLatestRulesetName(projectId, service, resourceName) {
     const releases = await listAllReleases(projectId);
-    const prefix = `projects/${projectId}/releases/${service}`;
+    let prefix = `projects/${projectId}/releases/${service}`;
+    if (resourceName) {
+        prefix += `/${resourceName}`;
+    }
     const release = releases.find((r) => r.name.startsWith(prefix));
     if (!release) {
         return null;

package/lib/gcp/serviceusage.js

@@ -22,7 +22,7 @@ const serviceUsagePollerOptions = {
 async function generateServiceIdentity(projectNumber, service, prefix) {
     utils.logLabeledBullet(prefix, `generating the service identity for ${(0, colorette_1.bold)(service)}...`);
     try {
-        const res = await exports.apiClient.post(`projects/${projectNumber}/services/${service}:generateServiceIdentity`, {}, { headers: { "x-goog-quota-user": `projects/${projectNumber}` } });
+        const res = await exports.apiClient.post(`projects/${projectNumber}/services/${service}:generateServiceIdentity`, {}, { headers: { "x-goog-user-project": `${projectNumber}` } });
         return res.body;
     }
     catch (err) {
@@ -39,6 +39,6 @@ async function generateServiceIdentityAndPoll(projectNumber, service, prefix) {
     await poller.pollOperation({
         ...serviceUsagePollerOptions,
         operationResourceName: op.name,
-        headers: { "x-goog-quota-user": `projects/${projectNumber}` },
+        headers: { "x-goog-user-project": `${projectNumber}` },
     });
 }

package/lib/init/features/firestore/indexes.js

@@ -33,7 +33,7 @@ async function initIndexes(setup, config, info) {
             utils.logBullet(`Downloaded the existing Firestore indexes from the Firebase console`);
         }
     }
-    info.writeRules = await config.confirmWriteProjectFile(info.indexesFilename, info.indexes);
+    info.writeIndexes = await config.confirmWriteProjectFile(info.indexesFilename, info.indexes);
 }
 async function getIndexesFromConsole(projectId, databaseId) {
     const indexesPromise = indexes.listIndexes(projectId, databaseId);

package/lib/init/features/{storage.js → storage/index.js}

@@ -3,10 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.askQuestions = askQuestions;
 exports.actuate = actuate;
 const clc = require("colorette");
-const logger_1 = require("../../logger");
-const prompt_1 = require("../../prompt");
-const templates_1 = require("../../templates");
-const error_1 = require("../../error");
+const logger_1 = require("../../../logger");
+const prompt_1 = require("../../../prompt");
+const templates_1 = require("../../../templates");
+const error_1 = require("../../../error");
+const rules_1 = require("./rules");
 const RULES_TEMPLATE = (0, templates_1.readTemplateSync)("init/storage/storage.rules");
 const DEFAULT_RULES_FILE = "storage.rules";
 async function askQuestions(setup, config) {
@@ -20,6 +21,13 @@ async function askQuestions(setup, config) {
         rules: RULES_TEMPLATE,
         writeRules: true,
     };
+    if (setup.projectId) {
+        const downloadedRules = await (0, rules_1.getRulesFromConsole)(setup.projectId);
+        if (downloadedRules) {
+            info.rules = downloadedRules;
+            logger_1.logger.info(`Downloaded the existing Storage Security Rules from the Firebase console`);
+        }
+    }
     info.rulesFilename = await (0, prompt_1.input)({
         message: "What file should be used for Storage Rules?",
         default: DEFAULT_RULES_FILE,

package/lib/init/features/storage/rules.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRulesFromConsole = getRulesFromConsole;
+const gcp = require("../../../gcp");
+const utils = require("../../../utils");
+async function getRulesFromConsole(projectId) {
+    const defaultBucket = await gcp.storage.getDefaultBucket(projectId);
+    const name = await gcp.rules.getLatestRulesetName(projectId, "firebase.storage", defaultBucket);
+    if (!name) {
+        return null;
+    }
+    const rules = await gcp.rules.getRulesetContent(name);
+    if (rules.length <= 0) {
+        return utils.reject("Ruleset has no files", { exit: 1 });
+    }
+    if (rules.length > 1) {
+        return utils.reject("Ruleset has too many files: " + rules.length, { exit: 1 });
+    }
+    return rules[0].content;
+}

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

@@ -10,7 +10,7 @@ const getDefaultDatabaseInstance_1 = require("../../../getDefaultDatabaseInstanc
 exports.get_security_rules = (0, tool_1.tool)("core", {
     name: "get_security_rules",
     description: "Use this to retrieve the security rules for a specified Firebase service. " +
-        "If there are multiple instances of that service in the product, the rules for the defualt instance are returned.",
+        "If there are multiple instances of that service in the product, the rules for the default instance are returned.",
     inputSchema: zod_1.z.object({
         type: zod_1.z.enum(["firestore", "rtdb", "storage"]).describe("The service to get rules for."),
     }),

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

@@ -31,7 +31,7 @@ function toText(response, filters) {
 }
 exports.get_report = (0, tool_1.tool)("crashlytics", {
     name: "get_report",
-    description: `Use this to request numerical reports from Crashlytics. The result aggregates the sum of events and impacted users, grouped by a dimension appropriate for that report. Agents must read the [Firebase Crashlytics Reports Guide](firebase://guides/crashlytics/reports) using the \`firebase_read_resources\` tool before calling to understand criticial prerequisites for requesting reports and how to interpret the results.
+    description: `Use this to request numerical reports from Crashlytics. The result aggregates the sum of events and impacted users, grouped by a dimension appropriate for that report. Agents must read the [Firebase Crashlytics Reports Guide](firebase://guides/crashlytics/reports) using the \`firebase_read_resources\` tool before calling to understand critical prerequisites for requesting reports and how to interpret the results.
     `.trim(),
     inputSchema: reports_1.ReportInputSchema,
     annotations: {

package/lib/mcp/tools/firestore/delete_document.js

@@ -9,7 +9,7 @@ const delete_1 = require("../../../firestore/delete");
 const types_1 = require("../../../emulator/types");
 exports.delete_document = (0, tool_1.tool)("firestore", {
     name: "delete_document",
-    description: "Use this to delete a Firestore documents from a database in the current project by full document paths. Use this if you know the exact path of a document.",
+    description: "Use this to delete Firestore documents from a database in the current project by full document paths. Use this if you know the exact path of a document.",
     inputSchema: zod_1.z.object({
         database: zod_1.z
             .string()

package/lib/mcp/tools/firestore/query_collection.js

@@ -9,7 +9,7 @@ const converter_1 = require("./converter");
 const types_1 = require("../../../emulator/types");
 exports.query_collection = (0, tool_1.tool)("firestore", {
     name: "query_collection",
-    description: "Use this to retrieve one or more Firestore documents from a collection is a database in the current project by a collection with a full document path. Use this if you know the exact path of a collection and the filtering clause you would like for the document.",
+    description: "Use this to retrieve one or more Firestore documents from a collection in a database in the current project by a collection with a full document path. Use this if you know the exact path of a collection and the filtering clause you would like for the document.",
     inputSchema: zod_1.z.object({
         database: zod_1.z
             .string()