firebase-tools 14.7.0 → 14.8.0

package/lib/commands/functions-delete.js

@@ -16,7 +16,6 @@ const planner = require("../deploy/functions/release/planner");
 const fabricator = require("../deploy/functions/release/fabricator");
 const executor = require("../deploy/functions/release/executor");
 const reporter = require("../deploy/functions/release/reporter");
-const containerCleaner = require("../deploy/functions/containerCleaner");
 const getProjectNumber_1 = require("../getProjectNumber");
 exports.command = new command_1.Command("functions:delete [filters...]")
     .description("delete one or more Cloud Functions by name or group name.")
@@ -91,5 +90,4 @@ exports.command = new command_1.Command("functions:delete [filters...]")
             exit: 1,
         });
     }
-    await containerCleaner.cleanupBuildImages([], allEpToDelete);
 });

package/lib/deploy/functions/checkIam.js

@@ -120,10 +120,10 @@ async function ensureGenkitMonitoringRoles(projectId, projectNumber, want, have,
         .map((endpoint) => endpoint.serviceAccount || "")
         .filter((value, index, self) => self.indexOf(value) === index);
     const defaultServiceAccountIndex = serviceAccounts.indexOf("");
-    if (defaultServiceAccountIndex) {
+    if (defaultServiceAccountIndex !== -1) {
         serviceAccounts[defaultServiceAccountIndex] = await gce.getDefaultServiceAccount(projectNumber);
     }
-    const members = serviceAccounts.map((sa) => `serviceAccount:${sa}`);
+    const members = serviceAccounts.filter((sa) => !!sa).map((sa) => `serviceAccount:${sa}`);
     const requiredBindings = [];
     for (const monitoringRole of exports.GENKIT_MONITORING_ROLES) {
         requiredBindings.push({

package/lib/emulator/dataconnect/pgliteServer.js

@@ -19,16 +19,17 @@ var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _ar
     function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fromNodeSocket = exports.PGliteExtendedQueryPatch = exports.PostgresServer = exports.TRUNCATE_TABLES_SQL = void 0;
+exports.fromNodeSocket = exports.PostgresServer = exports.TRUNCATE_TABLES_SQL = void 0;
 const pglite_1 = require("@electric-sql/pglite");
 const { dynamicImport } = require(true && "../../dynamicImport");
 const net = require("node:net");
 const node_stream_1 = require("node:stream");
 const fs = require("fs");
+const path = require("node:path");
 const pg_gateway_1 = require("pg-gateway");
 const logger_1 = require("../../logger");
 const error_1 = require("../../error");
-const node_string_decoder_1 = require("node:string_decoder");
+const fsutils_1 = require("../../fsutils");
 exports.TRUNCATE_TABLES_SQL = `
 DO $do$
 DECLARE _clear text;
@@ -45,22 +46,43 @@ class PostgresServer {
     async createPGServer(host = "127.0.0.1", port) {
         const getDb = this.getDb.bind(this);
         const server = net.createServer(async (socket) => {
-            const connection = await fromNodeSocket(socket, {
-                serverVersion: "16.3 (PGlite 0.2.0)",
+            await fromNodeSocket(socket, {
+                serverVersion: "17.4 (PGlite 0.3.3)",
                 auth: { method: "trust" },
-                async onMessage(data, { isAuthenticated }) {
-                    if (!isAuthenticated) {
-                        return;
-                    }
-                    const db = await getDb();
-                    if (data[0] === pg_gateway_1.FrontendMessageCode.Terminate) {
-                        await db.query("DEALLOCATE ALL");
-                    }
-                    const result = await db.execProtocolRaw(data);
-                    return extendedQueryPatch.filterResponse(data, result);
+                onMessage(data, { isAuthenticated }) {
+                    return __asyncGenerator(this, arguments, function* onMessage_1() {
+                        var _a, e_1, _b, _c;
+                        if (!isAuthenticated) {
+                            return yield __await(void 0);
+                        }
+                        const db = yield __await(getDb());
+                        if (data[0] === pg_gateway_1.FrontendMessageCode.Terminate) {
+                            yield __await(db.query("DEALLOCATE ALL"));
+                        }
+                        const response = yield __await(db.execProtocolRaw(data));
+                        try {
+                            for (var _d = true, _e = __asyncValues((0, pg_gateway_1.getMessages)(response)), _f; _f = yield __await(_e.next()), _a = _f.done, !_a;) {
+                                _c = _f.value;
+                                _d = false;
+                                try {
+                                    const message = _c;
+                                    yield yield __await(message);
+                                }
+                                finally {
+                                    _d = true;
+                                }
+                            }
+                        }
+                        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                        finally {
+                            try {
+                                if (!_d && !_a && (_b = _e.return)) yield __await(_b.call(_e));
+                            }
+                            finally { if (e_1) throw e_1.error; }
+                        }
+                    });
                 },
             });
-            const extendedQueryPatch = new PGliteExtendedQueryPatch(connection);
             socket.on("end", () => {
                 logger_1.logger.debug("Postgres client disconnected");
             });
@@ -79,30 +101,15 @@ class PostgresServer {
     }
     async getDb() {
         if (!this.db) {
-            if (this.dataDirectory && !fs.existsSync(this.dataDirectory)) {
-                fs.mkdirSync(this.dataDirectory, { recursive: true });
-            }
-            const vector = (await dynamicImport("@electric-sql/pglite/vector")).vector;
-            const uuidOssp = (await dynamicImport("@electric-sql/pglite/contrib/uuid_ossp")).uuid_ossp;
-            const pgliteArgs = {
-                debug: this.debug,
-                extensions: {
-                    vector,
-                    uuidOssp,
-                },
-                dataDir: this.dataDirectory,
-            };
-            if (this.importPath) {
-                logger_1.logger.debug(`Importing from ${this.importPath}`);
-                const rf = fs.readFileSync(this.importPath);
-                const file = new File([rf], this.importPath);
-                pgliteArgs.loadDataDir = file;
-            }
-            this.db = await this.forceCreateDB(pgliteArgs);
-            await this.db.waitReady;
+            this.db = await this.forceCreateDB();
         }
         return this.db;
     }
+    async getExtensions() {
+        const vector = (await dynamicImport("@electric-sql/pglite/vector")).vector;
+        const uuidOssp = (await dynamicImport("@electric-sql/pglite/contrib/uuid_ossp")).uuid_ossp;
+        return { vector, uuidOssp };
+    }
     async clearDb() {
         const db = await this.getDb();
         await db.query(exports.TRUNCATE_TABLES_SQL);
@@ -113,18 +120,92 @@ class PostgresServer {
         const arrayBuff = await dump.arrayBuffer();
         fs.writeFileSync(exportPath, new Uint8Array(arrayBuff));
     }
-    async forceCreateDB(pgliteArgs) {
+    async migrateDb(pgliteArgs) {
+        if (!this.baseDataDirectory) {
+            throw new error_1.FirebaseError("Cannot migrate database without a data directory.");
+        }
+        const { PGlite: PGlite02 } = await dynamicImport("pglite-2");
+        const pgDump = (await dynamicImport("@electric-sql/pglite-tools/pg_dump")).pgDump;
+        logger_1.logger.info("Opening database with Postgres 16...");
+        const extensions = await this.getExtensions();
+        const dataDir = this.baseDataDirectory;
+        const oldDb = new PGlite02(Object.assign(Object.assign({}, pgliteArgs), { dataDir }));
+        await oldDb.waitReady;
+        const oldVersion = await oldDb.query("SELECT version();");
+        logger_1.logger.debug(`Old database version: ${oldVersion.rows[0].version}`);
+        if (!oldVersion.rows[0].version.includes("PostgreSQL 16")) {
+            await oldDb.close();
+            throw new error_1.FirebaseError("Migration started, but DB version is not PostgreSQL 16.");
+        }
+        logger_1.logger.info("Dumping data from old database...");
+        const dumpDir = await oldDb.dumpDataDir("none");
+        const tempOldDb = await PGlite02.create({
+            loadDataDir: dumpDir,
+            extensions,
+        });
+        const dumpResult = await pgDump({ pg: tempOldDb, args: ["--verbose", "--verbose"] });
+        await tempOldDb.close();
+        await oldDb.close();
+        logger_1.logger.info(`Moving old database directory to ${this.baseDataDirectory}/pg16...`);
+        const pg16Dir = this.getVersionedDataDir(16);
+        (0, fsutils_1.moveAll)(this.baseDataDirectory, pg16Dir);
+        logger_1.logger.info("If you need to use an older version of the Firebase CLI, you can restore from that directory.");
+        logger_1.logger.info("Creating new database with Postgres 17...");
+        const pg17Dir = this.getVersionedDataDir(17);
+        const newDb = new pglite_1.PGlite(Object.assign(Object.assign({}, pgliteArgs), { dataDir: pg17Dir }));
+        await newDb.waitReady;
+        logger_1.logger.info("Importing data into new database...");
+        const dumpText = await dumpResult.text();
+        await newDb.exec(dumpText);
+        await newDb.exec("SET SEARCH_PATH = public;");
+        logger_1.logger.info("Postgres database migration successful.");
+        return newDb;
+    }
+    getVersionedDataDir(version) {
+        if (!this.baseDataDirectory) {
+            return;
+        }
+        return path.join(this.baseDataDirectory, `pg${version}`);
+    }
+    async forceCreateDB() {
+        const baseArgs = {
+            debug: this.debug,
+            extensions: await this.getExtensions(),
+        };
+        const pg17Dir = this.getVersionedDataDir(17);
+        if (pg17Dir && !fs.existsSync(pg17Dir)) {
+            fs.mkdirSync(pg17Dir, { recursive: true });
+        }
+        if (this.importPath) {
+            logger_1.logger.debug(`Importing from ${this.importPath}`);
+            const rf = fs.readFileSync(this.importPath);
+            const file = new File([rf], this.importPath);
+            baseArgs.loadDataDir = file;
+        }
+        if (this.baseDataDirectory && fs.existsSync(this.baseDataDirectory)) {
+            const versionFilePath = path.join(this.baseDataDirectory, "PG_VERSION");
+            if (fs.existsSync(versionFilePath)) {
+                const version = fs.readFileSync(versionFilePath, "utf-8").trim();
+                logger_1.logger.debug(`Found Postgres version file with version: ${version}`);
+                if (version === "16") {
+                    logger_1.logger.info("Detected a Postgres 16 data directory from an older version of firebase-tools. Migrating to Postgres 17...");
+                    return this.migrateDb(baseArgs);
+                }
+            }
+        }
         try {
-            const db = await pglite_1.PGlite.create(pgliteArgs);
+            const db = new pglite_1.PGlite(Object.assign(Object.assign({}, baseArgs), { dataDir: pg17Dir }));
+            await db.waitReady;
             return db;
         }
         catch (err) {
-            if (pgliteArgs.dataDir && (0, error_1.hasMessage)(err) && /Database already exists/.test(err.message)) {
-                fs.rmSync(pgliteArgs.dataDir, { force: true, recursive: true });
-                const db = await pglite_1.PGlite.create(pgliteArgs);
+            if (pg17Dir && (0, error_1.hasMessage)(err) && /Database already exists/.test(err.message)) {
+                fs.rmSync(pg17Dir, { force: true, recursive: true });
+                const db = new pglite_1.PGlite(Object.assign(Object.assign({}, baseArgs), { dataDir: pg17Dir }));
+                await db.waitReady;
                 return db;
             }
-            logger_1.logger.debug(`Error from pglite: ${err}`);
+            logger_1.logger.warn(`Error from pglite: ${err}`);
             throw new error_1.FirebaseError("Unexpected error starting up Postgres.");
         }
     }
@@ -140,71 +221,12 @@ class PostgresServer {
     constructor(args) {
         this.db = undefined;
         this.server = undefined;
-        this.dataDirectory = args.dataDirectory;
+        this.baseDataDirectory = args.dataDirectory;
         this.importPath = args.importPath;
         this.debug = args.debug ? 5 : 0;
     }
 }
 exports.PostgresServer = PostgresServer;
-class PGliteExtendedQueryPatch {
-    constructor(connection) {
-        this.connection = connection;
-        this.isExtendedQuery = false;
-        this.eqpErrored = false;
-    }
-    filterResponse(message, response) {
-        return __asyncGenerator(this, arguments, function* filterResponse_1() {
-            var _a, e_1, _b, _c;
-            const pipelineStartMessages = [
-                pg_gateway_1.FrontendMessageCode.Parse,
-                pg_gateway_1.FrontendMessageCode.Bind,
-                pg_gateway_1.FrontendMessageCode.Close,
-            ];
-            const decoder = new node_string_decoder_1.StringDecoder();
-            const decoded = decoder.write(message);
-            logger_1.logger.debug(decoded);
-            if (pipelineStartMessages.includes(message[0])) {
-                this.isExtendedQuery = true;
-            }
-            if (message[0] === pg_gateway_1.FrontendMessageCode.Sync) {
-                this.isExtendedQuery = false;
-                this.eqpErrored = false;
-                return yield __await(this.connection.createReadyForQuery());
-            }
-            try {
-                for (var _d = true, _e = __asyncValues((0, pg_gateway_1.getMessages)(response)), _f; _f = yield __await(_e.next()), _a = _f.done, !_a;) {
-                    _c = _f.value;
-                    _d = false;
-                    try {
-                        const message = _c;
-                        if (this.eqpErrored) {
-                            continue;
-                        }
-                        if (this.isExtendedQuery && message[0] === pg_gateway_1.BackendMessageCode.ErrorMessage) {
-                            this.eqpErrored = true;
-                        }
-                        if (this.isExtendedQuery && message[0] === pg_gateway_1.BackendMessageCode.ReadyForQuery) {
-                            logger_1.logger.debug("Filtered out a ReadyForQuery.");
-                            continue;
-                        }
-                        yield yield __await(message);
-                    }
-                    finally {
-                        _d = true;
-                    }
-                }
-            }
-            catch (e_1_1) { e_1 = { error: e_1_1 }; }
-            finally {
-                try {
-                    if (!_d && !_a && (_b = _e.return)) yield __await(_b.call(_e));
-                }
-                finally { if (e_1) throw e_1.error; }
-            }
-        });
-    }
-}
-exports.PGliteExtendedQueryPatch = PGliteExtendedQueryPatch;
 async function fromNodeSocket(socket, options) {
     const rs = node_stream_1.Readable.toWeb(socket);
     const ws = node_stream_1.Writable.toWeb(socket);

package/lib/emulator/downloadableEmulatorInfo.json

@@ -54,28 +54,28 @@
     },
     "dataconnect": {
         "darwin": {
-            "version": "2.7.0",
-            "expectedSize": 27542272,
-            "expectedChecksum": "8b68e45ccae2d2cf35bea368e7ce379c",
-            "expectedChecksumSHA256": "6dce6ea23c39e4e44dbaa6db7181c9d7761dd1098589a627fa5aa0fb4a07ccd7",
-            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-macos-v2.7.0",
-            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.7.0"
+            "version": "2.7.1",
+            "expectedSize": 27607808,
+            "expectedChecksum": "3cf0b4dcb96639f1b7ddf3e2052ea28f",
+            "expectedChecksumSHA256": "76b6db1f87e14e3c39035301ae199bec0458a2e7534a1db962276a92fa99c215",
+            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-macos-v2.7.1",
+            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.7.1"
         },
         "win32": {
-            "version": "2.7.0",
-            "expectedSize": 28001280,
-            "expectedChecksum": "03ef2fd3ed2f7263539f1a9d7b748ee6",
-            "expectedChecksumSHA256": "3462f15ddc5d11371774de8f19b54468eb75eefac5f3a5623334f42154f06bc8",
-            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-windows-v2.7.0",
-            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.7.0.exe"
+            "version": "2.7.1",
+            "expectedSize": 28067328,
+            "expectedChecksum": "8dacedaecac242199dfcf3f6c023f89a",
+            "expectedChecksumSHA256": "fc098efa9aed9b1ac7d35b90da47608190f3a5562f37444012785a9793d743a0",
+            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-windows-v2.7.1",
+            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.7.1.exe"
         },
         "linux": {
-            "version": "2.7.0",
-            "expectedSize": 27451544,
-            "expectedChecksum": "8b73f21f1bdf168a5f2c3137c30abc7b",
-            "expectedChecksumSHA256": "e2d03d1d0524f8053b34376c8ad6ea1fdfb8bc48568e80a35c2e3e510754c121",
-            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-linux-v2.7.0",
-            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.7.0"
+            "version": "2.7.1",
+            "expectedSize": 27521176,
+            "expectedChecksum": "3c03d85c2d1de80a2f2ba13fe3b5a3ff",
+            "expectedChecksumSHA256": "94c35ab64bd8d206e7843513848e7375cd8f9b6a06d013b1ec541ac831cda8a8",
+            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-linux-v2.7.1",
+            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.7.1"
         }
     }
 }

package/lib/ensureApiEnabled.js

@@ -8,6 +8,7 @@ const apiv2_1 = require("./apiv2");
 const utils = require("./utils");
 const error_1 = require("./error");
 const logger_1 = require("./logger");
+const configstore_1 = require("./configstore");
 exports.POLL_SETTINGS = {
     pollInterval: 10000,
     pollsBeforeRetry: 12,
@@ -18,6 +19,9 @@ const apiClient = new apiv2_1.Client({
 });
 async function check(projectId, apiUri, prefix, silent = false) {
     const apiName = apiUri.startsWith("http") ? new URL(apiUri).hostname : apiUri;
+    if (checkAPIEnablementCache(projectId, apiName)) {
+        return true;
+    }
     const res = await apiClient.get(`/projects/${projectId}/services/${apiName}`, {
         headers: { "x-goog-quota-user": `projects/${projectId}` },
         skipLog: { resBody: true },
@@ -26,6 +30,9 @@ async function check(projectId, apiUri, prefix, silent = false) {
     if (isEnabled && !silent) {
         utils.logLabeledSuccess(prefix, `required API ${(0, colorette_1.bold)(apiName)} is enabled`);
     }
+    if (isEnabled) {
+        cacheEnabledAPI(projectId, apiName);
+    }
     return isEnabled;
 }
 exports.check = check;
@@ -39,6 +46,7 @@ async function enable(projectId, apiName) {
             headers: { "x-goog-quota-user": `projects/${projectId}` },
             skipLog: { resBody: true },
         });
+        cacheEnabledAPI(projectId, apiName);
     }
     catch (err) {
         if ((0, error_1.isBillingError)(err)) {
@@ -120,3 +128,17 @@ function enableApiURI(projectId, apiName) {
     return `https://console.cloud.google.com/apis/library/${apiName}?project=${projectId}`;
 }
 exports.enableApiURI = enableApiURI;
+const API_ENABLEMENT_CACHE_KEY = "apiEnablementCache";
+function checkAPIEnablementCache(projectId, apiName) {
+    var _a;
+    const cache = configstore_1.configstore.get(API_ENABLEMENT_CACHE_KEY);
+    return !!((_a = cache === null || cache === void 0 ? void 0 : cache[projectId]) === null || _a === void 0 ? void 0 : _a[apiName]);
+}
+function cacheEnabledAPI(projectId, apiName) {
+    const cache = (configstore_1.configstore.get(API_ENABLEMENT_CACHE_KEY) || {});
+    if (!cache[projectId]) {
+        cache[projectId] = {};
+    }
+    cache[projectId][apiName] = true;
+    configstore_1.configstore.set(API_ENABLEMENT_CACHE_KEY, cache);
+}

package/lib/fsutils.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.listFiles = exports.readFile = exports.dirExistsSync = exports.fileExistsSync = void 0;
+exports.moveAll = exports.listFiles = exports.readFile = exports.dirExistsSync = exports.fileExistsSync = void 0;
 const fs_1 = require("fs");
+const path = require("path");
 const error_1 = require("./error");
+const fs_extra_1 = require("fs-extra");
 function fileExistsSync(path) {
     try {
         return (0, fs_1.statSync)(path).isFile();
@@ -45,3 +47,16 @@ function listFiles(path) {
     }
 }
 exports.listFiles = listFiles;
+function moveAll(srcDir, destDir) {
+    if (!(0, fs_1.existsSync)(destDir)) {
+        (0, fs_1.mkdirSync)(destDir, { recursive: true });
+    }
+    const files = listFiles(srcDir);
+    for (const f of files) {
+        const srcPath = path.join(srcDir, f);
+        if (srcPath === destDir)
+            continue;
+        (0, fs_extra_1.moveSync)(srcPath, path.join(destDir, f));
+    }
+}
+exports.moveAll = moveAll;

package/lib/gcp/serviceusage.js

@@ -20,7 +20,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`);
+        const res = await exports.apiClient.post(`projects/${projectNumber}/services/${service}:generateServiceIdentity`, {}, { headers: { "x-goog-quota-user": `projects/${projectNumber}` } });
         return res.body;
     }
     catch (err) {
@@ -35,6 +35,6 @@ async function generateServiceIdentityAndPoll(projectNumber, service, prefix) {
     if (op.done) {
         return;
     }
-    await poller.pollOperation(Object.assign(Object.assign({}, serviceUsagePollerOptions), { operationResourceName: op.name }));
+    await poller.pollOperation(Object.assign(Object.assign({}, serviceUsagePollerOptions), { operationResourceName: op.name, headers: { "x-goog-quota-user": `projects/${projectNumber}` } }));
 }
 exports.generateServiceIdentityAndPoll = generateServiceIdentityAndPoll;

package/lib/operation-poller.js

@@ -34,7 +34,9 @@ class OperationPoller {
         return async () => {
             let res;
             try {
-                res = await apiClient.get(options.operationResourceName);
+                res = await apiClient.get(options.operationResourceName, {
+                    headers: options.headers,
+                });
             }
             catch (err) {
                 if (err.status === 500 || err.status === 503) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firebase-tools",
-  "version": "14.7.0",
+  "version": "14.8.0",
   "description": "Command-Line Interface for Firebase",
   "main": "./lib/index.js",
   "bin": {
@@ -60,7 +60,8 @@
     ]
   },
   "dependencies": {
-    "@electric-sql/pglite": "^0.2.17",
+    "@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",
     "@inquirer/prompts": "^7.4.0",
@@ -110,6 +111,7 @@
     "p-limit": "^3.0.1",
     "pg": "^8.11.3",
     "pg-gateway": "^0.3.0-beta.4",
+    "pglite-2": "npm:@electric-sql/pglite@0.2.17",
     "portfinder": "^1.0.32",
     "progress": "^2.0.3",
     "proxy-agent": "^6.3.0",

package/templates/init/functions/javascript/index.js

@@ -7,9 +7,22 @@
  * See a full list of supported triggers at https://firebase.google.com/docs/functions
  */
 
-const {onRequest} = require("firebase-functions/v2/https");
+const {setGlobalOptions} = require("firebase-functions");
+const {onRequest} = require("firebase-functions/https");
 const logger = require("firebase-functions/logger");
 
+// For cost control, you can set the maximum number of containers that can be
+// running at the same time. This helps mitigate the impact of unexpected
+// traffic spikes by instead downgrading performance. This limit is a
+// per-function limit. You can override the limit for each function using the
+// `maxInstances` option in the function's options, e.g.
+// `onRequest({ maxInstances: 5 }, (req, res) => { ... })`.
+// NOTE: setGlobalOptions does not apply to functions using the v1 API. V1
+// functions should each use functions.runWith({ maxInstances: 10 }) instead.
+// In the v1 API, each function can only serve one request per container, so
+// this will be the maximum concurrent request count.
+setGlobalOptions({ maxInstances: 10 });
+
 // Create and deploy your first functions
 // https://firebase.google.com/docs/functions/get-started
 

package/templates/init/functions/python/main.py

@@ -3,8 +3,16 @@
 # Deploy with `firebase deploy`
 
 from firebase_functions import https_fn
+from firebase_functions.options import set_global_options
 from firebase_admin import initialize_app
 
+# For cost control, you can set the maximum number of containers that can be
+# running at the same time. This helps mitigate the impact of unexpected
+# traffic spikes by instead downgrading performance. This limit is a per-function
+# limit. You can override the limit for each function using the max_instances
+# parameter in the decorator, e.g. @https_fn.on_request(max_instances=5).
+set_global_options(max_instances=10)
+
 # initialize_app()
 #
 #

package/templates/init/functions/typescript/index.ts

@@ -7,12 +7,25 @@
  * See a full list of supported triggers at https://firebase.google.com/docs/functions
  */
 
-import {onRequest} from "firebase-functions/v2/https";
+import {setGlobalOptions} from "firebase-functions";
+import {onRequest} from "firebase-functions/https";
 import * as logger from "firebase-functions/logger";
 
 // Start writing functions
 // https://firebase.google.com/docs/functions/typescript
 
+// For cost control, you can set the maximum number of containers that can be
+// running at the same time. This helps mitigate the impact of unexpected
+// traffic spikes by instead downgrading performance. This limit is a
+// per-function limit. You can override the limit for each function using the
+// `maxInstances` option in the function's options, e.g.
+// `onRequest({ maxInstances: 5 }, (req, res) => { ... })`.
+// NOTE: setGlobalOptions does not apply to functions using the v1 API. V1
+// functions should each use functions.runWith({ maxInstances: 10 }) instead.
+// In the v1 API, each function can only serve one request per container, so
+// this will be the maximum concurrent request count.
+setGlobalOptions({ maxInstances: 10 });
+
 // export const helloWorld = onRequest((request, response) => {
 //   logger.info("Hello logs!", {structuredData: true});
 //   response.send("Hello from Firebase!");