firebase-tools 11.5.0 → 11.8.0

package/lib/gcp/cloudfunctions.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.functionFromEndpoint = exports.endpointFromFunction = exports.listAllFunctions = exports.listFunctions = exports.deleteFunction = exports.updateFunction = exports.setInvokerUpdate = exports.setInvokerCreate = exports.getIamPolicy = exports.setIamPolicy = exports.createFunction = exports.generateUploadUrl = exports.BLOCKING_LABEL = exports.CODEBASE_LABEL = exports.API_VERSION = void 0;
+exports.functionFromEndpoint = exports.endpointFromFunction = exports.listAllFunctions = exports.listFunctions = exports.deleteFunction = exports.updateFunction = exports.setInvokerUpdate = exports.setInvokerCreate = exports.getIamPolicy = exports.setIamPolicy = exports.createFunction = exports.generateUploadUrl = exports.API_VERSION = void 0;
 const clc = require("colorette");
 const error_1 = require("../error");
 const logger_1 = require("../logger");
@@ -11,18 +11,9 @@ const runtimes = require("../deploy/functions/runtimes");
 const projectConfig = require("../functions/projectConfig");
 const apiv2_1 = require("../apiv2");
 const api_1 = require("../api");
+const constants_1 = require("../functions/constants");
 exports.API_VERSION = "v1";
-exports.CODEBASE_LABEL = "firebase-functions-codebase";
 const client = new apiv2_1.Client({ urlPrefix: api_1.functionsOrigin, apiVersion: exports.API_VERSION });
-exports.BLOCKING_LABEL = "deployment-blocking";
-const BLOCKING_LABEL_KEY_TO_EVENT = {
-    "before-create": "providers/cloud.auth/eventTypes/user.beforeCreate",
-    "before-sign-in": "providers/cloud.auth/eventTypes/user.beforeSignIn",
-};
-const BLOCKING_EVENT_TO_LABEL_KEY = {
-    "providers/cloud.auth/eventTypes/user.beforeCreate": "before-create",
-    "providers/cloud.auth/eventTypes/user.beforeSignIn": "before-sign-in",
-};
 function functionsOpLogReject(funcName, type, err) {
     var _a, _b;
     if (((_b = (_a = err === null || err === void 0 ? void 0 : err.context) === null || _a === void 0 ? void 0 : _a.response) === null || _b === void 0 ? void 0 : _b.statusCode) === 429) {
@@ -199,7 +190,7 @@ async function listAllFunctions(projectId) {
 }
 exports.listAllFunctions = listAllFunctions;
 function endpointFromFunction(gcfFunction) {
-    var _a, _b, _c, _d, _e, _f, _g;
+    var _a, _b, _c, _d, _e, _f, _g, _h;
     const [, project, , region, , id] = gcfFunction.name.split("/");
     let trigger;
     let uri;
@@ -220,10 +211,10 @@ function endpointFromFunction(gcfFunction) {
             callableTrigger: {},
         };
     }
-    else if ((_e = gcfFunction.labels) === null || _e === void 0 ? void 0 : _e[exports.BLOCKING_LABEL]) {
+    else if ((_e = gcfFunction.labels) === null || _e === void 0 ? void 0 : _e[constants_1.BLOCKING_LABEL]) {
         trigger = {
             blockingTrigger: {
-                eventType: BLOCKING_LABEL_KEY_TO_EVENT[gcfFunction.labels[exports.BLOCKING_LABEL]],
+                eventType: constants_1.BLOCKING_LABEL_KEY_TO_EVENT[gcfFunction.labels[constants_1.BLOCKING_LABEL]],
             },
         };
     }
@@ -263,7 +254,10 @@ function endpointFromFunction(gcfFunction) {
         endpoint.vpc = { connector: gcfFunction.vpcConnector };
         proto.convertIfPresent(endpoint.vpc, gcfFunction, "egressSettings", "vpcConnectorEgressSettings", (raw) => raw);
     }
-    endpoint.codebase = ((_g = gcfFunction.labels) === null || _g === void 0 ? void 0 : _g[exports.CODEBASE_LABEL]) || projectConfig.DEFAULT_CODEBASE;
+    endpoint.codebase = ((_g = gcfFunction.labels) === null || _g === void 0 ? void 0 : _g[constants_1.CODEBASE_LABEL]) || projectConfig.DEFAULT_CODEBASE;
+    if ((_h = gcfFunction.labels) === null || _h === void 0 ? void 0 : _h[constants_1.HASH_LABEL]) {
+        endpoint.hash = gcfFunction.labels[constants_1.HASH_LABEL];
+    }
     return endpoint;
 }
 exports.endpointFromFunction = endpointFromFunction;
@@ -312,7 +306,7 @@ function functionFromEndpoint(endpoint, sourceUploadUrl) {
     }
     else if (backend.isBlockingTriggered(endpoint)) {
         gcfFunction.httpsTrigger = {};
-        gcfFunction.labels = Object.assign(Object.assign({}, gcfFunction.labels), { [exports.BLOCKING_LABEL]: BLOCKING_EVENT_TO_LABEL_KEY[endpoint.blockingTrigger.eventType] });
+        gcfFunction.labels = Object.assign(Object.assign({}, gcfFunction.labels), { [constants_1.BLOCKING_LABEL]: constants_1.BLOCKING_EVENT_TO_LABEL_KEY[endpoint.blockingTrigger.eventType] });
     }
     else {
         gcfFunction.httpsTrigger = {};
@@ -337,10 +331,13 @@ function functionFromEndpoint(endpoint, sourceUploadUrl) {
     }
     const codebase = endpoint.codebase || projectConfig.DEFAULT_CODEBASE;
     if (codebase !== projectConfig.DEFAULT_CODEBASE) {
-        gcfFunction.labels = Object.assign(Object.assign({}, gcfFunction.labels), { [exports.CODEBASE_LABEL]: codebase });
+        gcfFunction.labels = Object.assign(Object.assign({}, gcfFunction.labels), { [constants_1.CODEBASE_LABEL]: codebase });
     }
     else {
-        (_b = gcfFunction.labels) === null || _b === void 0 ? true : delete _b[exports.CODEBASE_LABEL];
+        (_b = gcfFunction.labels) === null || _b === void 0 ? true : delete _b[constants_1.CODEBASE_LABEL];
+    }
+    if (endpoint.hash) {
+        gcfFunction.labels = Object.assign(Object.assign({}, gcfFunction.labels), { [constants_1.HASH_LABEL]: endpoint.hash });
     }
     return gcfFunction;
 }

package/lib/gcp/cloudfunctionsv2.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.endpointFromFunction = exports.functionFromEndpoint = exports.deleteFunction = exports.updateFunction = exports.listAllFunctions = exports.listFunctions = exports.getFunction = exports.createFunction = exports.generateUploadUrl = exports.mebibytes = exports.BLOCKING_LABEL = exports.CODEBASE_LABEL = exports.API_VERSION = void 0;
+exports.endpointFromFunction = exports.functionFromEndpoint = exports.deleteFunction = exports.updateFunction = exports.listAllFunctions = exports.listFunctions = exports.getFunction = exports.createFunction = exports.generateUploadUrl = exports.mebibytes = exports.API_VERSION = void 0;
 const clc = require("colorette");
 const apiv2_1 = require("../apiv2");
 const error_1 = require("../error");
@@ -12,22 +12,13 @@ const runtimes = require("../deploy/functions/runtimes");
 const proto = require("./proto");
 const utils = require("../utils");
 const projectConfig = require("../functions/projectConfig");
+const constants_1 = require("../functions/constants");
 exports.API_VERSION = "v2alpha";
-exports.CODEBASE_LABEL = "firebase-functions-codebase";
 const client = new apiv2_1.Client({
     urlPrefix: api_1.functionsV2Origin,
     auth: true,
     apiVersion: exports.API_VERSION,
 });
-exports.BLOCKING_LABEL = "deployment-blocking";
-const BLOCKING_LABEL_KEY_TO_EVENT = {
-    "before-create": "providers/cloud.auth/eventTypes/user.beforeCreate",
-    "before-sign-in": "providers/cloud.auth/eventTypes/user.beforeSignIn",
-};
-const BLOCKING_EVENT_TO_LABEL_KEY = {
-    "providers/cloud.auth/eventTypes/user.beforeCreate": "before-create",
-    "providers/cloud.auth/eventTypes/user.beforeSignIn": "before-sign-in",
-};
 const BYTES_PER_UNIT = {
     "": 1,
     k: 1e3,
@@ -243,20 +234,23 @@ function functionFromEndpoint(endpoint, source) {
         gcfFunction.labels = Object.assign(Object.assign({}, gcfFunction.labels), { "deployment-callable": "true" });
     }
     else if (backend.isBlockingTriggered(endpoint)) {
-        gcfFunction.labels = Object.assign(Object.assign({}, gcfFunction.labels), { [exports.BLOCKING_LABEL]: BLOCKING_EVENT_TO_LABEL_KEY[endpoint.blockingTrigger.eventType] });
+        gcfFunction.labels = Object.assign(Object.assign({}, gcfFunction.labels), { [constants_1.BLOCKING_LABEL]: constants_1.BLOCKING_EVENT_TO_LABEL_KEY[endpoint.blockingTrigger.eventType] });
     }
     const codebase = endpoint.codebase || projectConfig.DEFAULT_CODEBASE;
     if (codebase !== projectConfig.DEFAULT_CODEBASE) {
-        gcfFunction.labels = Object.assign(Object.assign({}, gcfFunction.labels), { [exports.CODEBASE_LABEL]: codebase });
+        gcfFunction.labels = Object.assign(Object.assign({}, gcfFunction.labels), { [constants_1.CODEBASE_LABEL]: codebase });
     }
     else {
-        (_b = gcfFunction.labels) === null || _b === void 0 ? true : delete _b[exports.CODEBASE_LABEL];
+        (_b = gcfFunction.labels) === null || _b === void 0 ? true : delete _b[constants_1.CODEBASE_LABEL];
+    }
+    if (endpoint.hash) {
+        gcfFunction.labels = Object.assign(Object.assign({}, gcfFunction.labels), { [constants_1.HASH_LABEL]: endpoint.hash });
     }
     return gcfFunction;
 }
 exports.functionFromEndpoint = functionFromEndpoint;
 function endpointFromFunction(gcfFunction) {
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d, _e, _f;
     const [, project, , region, , id] = gcfFunction.name.split("/");
     let trigger;
     if (((_a = gcfFunction.labels) === null || _a === void 0 ? void 0 : _a["deployment-scheduled"]) === "true") {
@@ -274,10 +268,10 @@ function endpointFromFunction(gcfFunction) {
             callableTrigger: {},
         };
     }
-    else if ((_d = gcfFunction.labels) === null || _d === void 0 ? void 0 : _d[exports.BLOCKING_LABEL]) {
+    else if ((_d = gcfFunction.labels) === null || _d === void 0 ? void 0 : _d[constants_1.BLOCKING_LABEL]) {
         trigger = {
             blockingTrigger: {
-                eventType: BLOCKING_LABEL_KEY_TO_EVENT[gcfFunction.labels[exports.BLOCKING_LABEL]],
+                eventType: constants_1.BLOCKING_LABEL_KEY_TO_EVENT[gcfFunction.labels[constants_1.BLOCKING_LABEL]],
             },
         };
     }
@@ -341,7 +335,10 @@ function endpointFromFunction(gcfFunction) {
         endpoint.vpc = { connector: gcfFunction.serviceConfig.vpcConnector };
         proto.renameIfPresent(endpoint.vpc, gcfFunction.serviceConfig, "egressSettings", "vpcConnectorEgressSettings");
     }
-    endpoint.codebase = ((_e = gcfFunction.labels) === null || _e === void 0 ? void 0 : _e[exports.CODEBASE_LABEL]) || projectConfig.DEFAULT_CODEBASE;
+    endpoint.codebase = ((_e = gcfFunction.labels) === null || _e === void 0 ? void 0 : _e[constants_1.CODEBASE_LABEL]) || projectConfig.DEFAULT_CODEBASE;
+    if ((_f = gcfFunction.labels) === null || _f === void 0 ? void 0 : _f[constants_1.HASH_LABEL]) {
+        endpoint.hash = gcfFunction.labels[constants_1.HASH_LABEL];
+    }
     return endpoint;
 }
 exports.endpointFromFunction = endpointFromFunction;

package/lib/gcp/cloudscheduler.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.jobFromEndpoint = exports.topicNameForEndpoint = exports.jobNameForEndpoint = exports.createOrReplaceJob = exports.updateJob = exports.getJob = exports.deleteJob = exports.createJob = void 0;
+exports.jobFromEndpoint = exports.topicNameForEndpoint = exports.jobNameForEndpoint = exports.createOrReplaceJob = exports.getJob = exports.deleteJob = void 0;
 const _ = require("lodash");
 const error_1 = require("../error");
 const logger_1 = require("../logger");
@@ -8,15 +8,18 @@ const api_1 = require("../api");
 const apiv2_1 = require("../apiv2");
 const backend = require("../deploy/functions/backend");
 const proto = require("./proto");
+const checkIam_1 = require("../deploy/functions/checkIam");
 const functional_1 = require("../functional");
 const VERSION = "v1";
-const DEFAULT_TIME_ZONE = "America/Los_Angeles";
+const DEFAULT_TIME_ZONE_V1 = "America/Los_Angeles";
+const DEFAULT_TIME_ZONE_V2 = "UTC";
 const apiClient = new apiv2_1.Client({ urlPrefix: api_1.cloudschedulerOrigin, apiVersion: VERSION });
 function createJob(job) {
     const strippedName = job.name.substring(0, job.name.lastIndexOf("/"));
-    return apiClient.post(`/${strippedName}`, Object.assign({ timeZone: DEFAULT_TIME_ZONE }, job));
+    const json = job.pubsubTarget
+        ? Object.assign({ timeZone: DEFAULT_TIME_ZONE_V1 }, job) : Object.assign({ timeZone: DEFAULT_TIME_ZONE_V2 }, job);
+    return apiClient.post(`/${strippedName}`, json);
 }
-exports.createJob = createJob;
 function deleteJob(name) {
     return apiClient.delete(`/${name}`);
 }
@@ -28,14 +31,22 @@ function getJob(name) {
 }
 exports.getJob = getJob;
 function updateJob(job) {
-    const fieldMasks = proto.fieldMasks(job, "pubsubTarget");
-    return apiClient.patch(`/${job.name}`, Object.assign({ timeZone: DEFAULT_TIME_ZONE }, job), {
+    let fieldMasks;
+    let json;
+    if (job.pubsubTarget) {
+        fieldMasks = proto.fieldMasks(job, "pubsubTarget");
+        json = Object.assign({ timeZone: DEFAULT_TIME_ZONE_V1 }, job);
+    }
+    else {
+        fieldMasks = proto.fieldMasks(job, "httpTarget");
+        json = Object.assign({ timeZone: DEFAULT_TIME_ZONE_V2 }, job);
+    }
+    return apiClient.patch(`/${job.name}`, json, {
         queryParams: {
             updateMask: fieldMasks.join(","),
         },
     });
 }
-exports.updateJob = updateJob;
 async function createOrReplaceJob(job) {
     var _a, _b;
     const jobName = job.name.split("/").pop();
@@ -56,7 +67,7 @@ async function createOrReplaceJob(job) {
         return newJob;
     }
     if (!job.timeZone) {
-        job.timeZone = DEFAULT_TIME_ZONE;
+        job.timeZone = job.pubsubTarget ? DEFAULT_TIME_ZONE_V1 : DEFAULT_TIME_ZONE_V2;
     }
     if (!needUpdate(existingJob.body, job)) {
         logger_1.logger.debug(`scheduler job ${jobName} is up to date, no changes required`);
@@ -90,9 +101,9 @@ function needUpdate(existingJob, newJob) {
     }
     return false;
 }
-function jobNameForEndpoint(endpoint, appEngineLocation) {
+function jobNameForEndpoint(endpoint, location) {
     const id = backend.scheduleIdForFunction(endpoint);
-    return `projects/${endpoint.project}/locations/${appEngineLocation}/jobs/${id}`;
+    return `projects/${endpoint.project}/locations/${location}/jobs/${id}`;
 }
 exports.jobNameForEndpoint = jobNameForEndpoint;
 function topicNameForEndpoint(endpoint) {
@@ -100,10 +111,11 @@ function topicNameForEndpoint(endpoint) {
     return `projects/${endpoint.project}/topics/${id}`;
 }
 exports.topicNameForEndpoint = topicNameForEndpoint;
-function jobFromEndpoint(endpoint, appEngineLocation) {
+function jobFromEndpoint(endpoint, location, projectNumber) {
     const job = {};
+    job.name = jobNameForEndpoint(endpoint, location);
     if (endpoint.platform === "gcfv1") {
-        job.name = jobNameForEndpoint(endpoint, appEngineLocation);
+        job.timeZone = endpoint.scheduleTrigger.timeZone || DEFAULT_TIME_ZONE_V1;
         job.pubsubTarget = {
             topicName: topicNameForEndpoint(endpoint),
             attributes: {
@@ -112,7 +124,14 @@ function jobFromEndpoint(endpoint, appEngineLocation) {
         };
     }
     else if (endpoint.platform === "gcfv2") {
-        throw new error_1.FirebaseError("Do not know how to create a scheduled GCFv2 function");
+        job.timeZone = endpoint.scheduleTrigger.timeZone || DEFAULT_TIME_ZONE_V2;
+        job.httpTarget = {
+            uri: endpoint.uri,
+            httpMethod: "POST",
+            oidcToken: {
+                serviceAccountEmail: (0, checkIam_1.getDefaultComputeServiceAgent)(projectNumber),
+            },
+        };
     }
     else {
         (0, functional_1.assertExhaustive)(endpoint.platform);
@@ -121,7 +140,6 @@ function jobFromEndpoint(endpoint, appEngineLocation) {
         throw new error_1.FirebaseError("Cannot create a scheduler job without a schedule:" + JSON.stringify(endpoint));
     }
     job.schedule = endpoint.scheduleTrigger.schedule;
-    job.timeZone = endpoint.scheduleTrigger.timeZone || DEFAULT_TIME_ZONE;
     if (endpoint.scheduleTrigger.retryConfig) {
         job.retryConfig = {};
         proto.copyIfPresent(job.retryConfig, endpoint.scheduleTrigger.retryConfig, "maxDoublings", "retryCount");

package/lib/serve/index.js

@@ -4,6 +4,9 @@ exports.serve = void 0;
 const logger_1 = require("../logger");
 const frameworks_1 = require("../frameworks");
 const previews_1 = require("../previews");
+const track_1 = require("../track");
+const projectUtils_1 = require("../projectUtils");
+const constants_1 = require("../emulator/constants");
 const { FunctionsServer } = require("./functions");
 const TARGETS = {
     hosting: require("./hosting"),
@@ -17,12 +20,24 @@ async function serve(options) {
         [].concat(options.config.get("hosting")).some((it) => it.source)) {
         await (0, frameworks_1.prepareFrameworks)(targetNames, options, options);
     }
+    const isDemoProject = constants_1.Constants.isDemoProject((0, projectUtils_1.getProjectId)(options) || "");
+    targetNames.forEach((targetName) => {
+        void (0, track_1.trackEmulator)("emulator_run", {
+            emulator_name: targetName,
+            is_demo_project: String(isDemoProject),
+        });
+    });
     await Promise.all(targetNames.map((targetName) => {
         return TARGETS[targetName].start(options);
     }));
     await Promise.all(targetNames.map((targetName) => {
         return TARGETS[targetName].connect();
     }));
+    void (0, track_1.trackEmulator)("emulators_started", {
+        count: targetNames.length,
+        count_all: targetNames.length,
+        is_demo_project: String(isDemoProject),
+    });
     await new Promise((resolve) => {
         process.on("SIGINT", () => {
             logger_1.logger.info("Shutting down...");

package/lib/track.js

@@ -1,16 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.track = void 0;
+exports.emulatorSession = exports.trackEmulator = exports.track = exports.usageEnabled = exports.EMULATOR_GA4_MEASUREMENT_ID = void 0;
+const node_fetch_1 = require("node-fetch");
 const ua = require("universal-analytics");
 const uuid_1 = require("uuid");
+const auth_1 = require("./auth");
 const configstore_1 = require("./configstore");
+const logger_1 = require("./logger");
 const pkg = require("../package.json");
+exports.EMULATOR_GA4_MEASUREMENT_ID = process.env.FIREBASE_EMULATOR_GA4_MEASUREMENT_ID || "G-KYP2JMPFC0";
+function usageEnabled() {
+    return !!configstore_1.configstore.get("usage");
+}
+exports.usageEnabled = usageEnabled;
+const FIREBASE_ANALYTICS_UA = process.env.FIREBASE_ANALYTICS_UA || "UA-29174744-3";
 let anonId = configstore_1.configstore.get("analytics-uuid");
 if (!anonId) {
     anonId = (0, uuid_1.v4)();
     configstore_1.configstore.set("analytics-uuid", anonId);
 }
-const visitor = ua(process.env.FIREBASE_ANALYTICS_UA || "UA-29174744-3", anonId, {
+const visitor = ua(FIREBASE_ANALYTICS_UA, anonId, {
     strictCidFormat: false,
     https: true,
 });
@@ -19,7 +28,7 @@ visitor.set("cd2", process.version);
 visitor.set("cd3", process.env.FIREPIT_VERSION || "none");
 function track(action, label, duration = 0) {
     return new Promise((resolve) => {
-        if (configstore_1.configstore.get("tokens") && configstore_1.configstore.get("usage")) {
+        if (configstore_1.configstore.get("tokens") && usageEnabled()) {
             visitor.event("Firebase CLI " + pkg.version, action, label, duration).send(() => {
                 resolve();
             });
@@ -30,3 +39,113 @@ function track(action, label, duration = 0) {
     });
 }
 exports.track = track;
+const EMULATOR_GA4_API_SECRET = process.env.FIREBASE_EMULATOR_GA4_API_SECRET || "2V_zBYc4TdeoppzDaIu0zw";
+const EMULATOR_GA4_USER_PROPS = {
+    node_platform: {
+        value: process.platform,
+    },
+    node_version: {
+        value: process.version,
+    },
+    cli_version: {
+        value: pkg.version,
+    },
+    firepit_version: {
+        value: process.env.FIREPIT_VERSION || "none",
+    },
+};
+async function trackEmulator(eventName, params) {
+    const session = emulatorSession();
+    if (!session) {
+        return;
+    }
+    const oldTotalEngagementSeconds = session.totalEngagementSeconds;
+    session.totalEngagementSeconds = process.uptime();
+    session.commandName = (params === null || params === void 0 ? void 0 : params.command_name) || session.commandName;
+    const search = `?api_secret=${EMULATOR_GA4_API_SECRET}&measurement_id=${session.measurementId}`;
+    const validate = session.validateOnly ? "debug/" : "";
+    const url = `https://www.google-analytics.com/${validate}mp/collect${search}`;
+    const body = {
+        timestamp_micros: `${Date.now()}000`,
+        client_id: session.clientId,
+        user_properties: Object.assign(Object.assign({}, EMULATOR_GA4_USER_PROPS), { java_major_version: session.javaMajorVersion
+                ? { value: session.javaMajorVersion }
+                : undefined }),
+        validationBehavior: session.validateOnly ? "ENFORCE_RECOMMENDATIONS" : undefined,
+        events: [
+            {
+                name: eventName,
+                params: Object.assign({ session_id: session.sessionId, engagement_time_msec: (session.totalEngagementSeconds - oldTotalEngagementSeconds)
+                        .toFixed(3)
+                        .replace(".", "")
+                        .replace(/^0+/, ""), debug_mode: session.debugMode ? true : undefined, command_name: session.commandName }, params),
+            },
+        ],
+    };
+    if (session.validateOnly) {
+        logger_1.logger.info(`Sending Analytics for event ${eventName}`, params, body);
+    }
+    try {
+        const response = await (0, node_fetch_1.default)(url, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json;charset=UTF-8",
+            },
+            body: JSON.stringify(body),
+        });
+        if (session.validateOnly) {
+            if (!response.ok) {
+                logger_1.logger.warn(`Analytics validation HTTP error: ${response.status}`);
+            }
+            const respBody = await response.text();
+            logger_1.logger.info(`Analytics validation result: ${respBody}`);
+        }
+    }
+    catch (e) {
+        if (session.validateOnly) {
+            throw e;
+        }
+        return;
+    }
+}
+exports.trackEmulator = trackEmulator;
+function emulatorSession() {
+    const validateOnly = !!process.env.FIREBASE_CLI_MP_VALIDATE;
+    if (!usageEnabled()) {
+        if (validateOnly) {
+            logger_1.logger.warn("Google Analytics is DISABLED. To enable, (re)login and opt in to collection.");
+        }
+        return;
+    }
+    if (!currentEmulatorSession) {
+        let clientId = configstore_1.configstore.get("emulator-analytics-clientId");
+        if (!clientId) {
+            clientId = (0, uuid_1.v4)();
+            configstore_1.configstore.set("emulator-analytics-clientId", clientId);
+        }
+        currentEmulatorSession = {
+            measurementId: exports.EMULATOR_GA4_MEASUREMENT_ID,
+            clientId,
+            sessionId: (Math.random() * Number.MAX_SAFE_INTEGER).toFixed(0),
+            totalEngagementSeconds: 0,
+            debugMode: isDebugMode(),
+            validateOnly,
+        };
+    }
+    return currentEmulatorSession;
+}
+exports.emulatorSession = emulatorSession;
+let currentEmulatorSession = undefined;
+function isDebugMode() {
+    const account = (0, auth_1.getGlobalDefaultAccount)();
+    if (account === null || account === void 0 ? void 0 : account.user.email.endsWith("@google.com")) {
+        try {
+            require("../tsconfig.json");
+            logger_1.logger.info(`Using Google Analytics in DEBUG mode. Emulators (+ UI) events will be shown in GA Debug View only.`);
+            return true;
+        }
+        catch (_a) {
+        }
+    }
+    return false;
+}

package/lib/utils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.randomInt = exports.debounce = exports.last = exports.cloneDeep = exports.groupBy = exports.assertIsStringOrUndefined = exports.assertIsNumber = exports.assertIsString = exports.assertDefined = exports.thirtyDaysFromNow = exports.isRunningInWSL = exports.isCloudEnvironment = exports.datetimeString = exports.createDestroyer = exports.promiseWithSpinner = exports.setupLoggers = exports.tryParse = exports.tryStringify = exports.promiseProps = 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.logWarning = exports.logLabeledBullet = exports.logBullet = exports.logLabeledSuccess = exports.logSuccess = exports.addSubdomain = exports.addDatabaseNamespace = exports.getDatabaseViewDataUrl = exports.getDatabaseUrl = exports.envOverride = exports.getInheritedOption = exports.consoleUrl = exports.envOverrides = void 0;
+exports.randomInt = exports.debounce = exports.last = exports.cloneDeep = exports.groupBy = exports.assertIsStringOrUndefined = exports.assertIsNumber = exports.assertIsString = exports.assertDefined = exports.thirtyDaysFromNow = exports.isRunningInWSL = exports.isCloudEnvironment = exports.datetimeString = exports.createDestroyer = exports.promiseWithSpinner = exports.setupLoggers = exports.tryParse = exports.tryStringify = 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.logWarning = exports.logLabeledBullet = exports.logBullet = exports.logLabeledSuccess = exports.logSuccess = exports.addSubdomain = exports.addDatabaseNamespace = exports.getDatabaseViewDataUrl = exports.getDatabaseUrl = exports.envOverride = exports.getInheritedOption = exports.consoleUrl = exports.envOverrides = void 0;
 const _ = require("lodash");
 const url = require("url");
 const clc = require("colorette");
@@ -248,6 +248,19 @@ async function promiseWhile(action, check, interval = 2500) {
     });
 }
 exports.promiseWhile = promiseWhile;
+function withTimeout(timeoutMs, promise) {
+    return new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => reject(new Error("Timed out.")), timeoutMs);
+        promise.then((value) => {
+            clearTimeout(timeout);
+            resolve(value);
+        }, (err) => {
+            clearTimeout(timeout);
+            reject(err);
+        });
+    });
+}
+exports.withTimeout = withTimeout;
 async function promiseProps(obj) {
     const resultObj = {};
     const promises = Object.keys(obj).map(async (key) => {