firebase-tools 10.2.0 → 10.3.0

package/lib/deploy/functions/services/storage.js

@@ -2,12 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ensureStorageTriggerRegion = exports.obtainStorageBindings = void 0;
 const storage = require("../../../gcp/storage");
+const backend = require("../backend");
 const logger_1 = require("../../../logger");
 const error_1 = require("../../../error");
 const location_1 = require("../../../gcp/location");
 const PUBSUB_PUBLISHER_ROLE = "roles/pubsub.publisher";
-async function obtainStorageBindings(projectId, existingPolicy) {
-    const storageResponse = await storage.getServiceAccount(projectId);
+async function obtainStorageBindings(projectNumber, existingPolicy) {
+    const storageResponse = await storage.getServiceAccount(projectNumber);
     const storageServiceAgent = `serviceAccount:${storageResponse.email_address}`;
     let pubsubBinding = existingPolicy.bindings.find((b) => b.role === PUBSUB_PUBLISHER_ROLE);
     if (!pubsubBinding) {
@@ -22,11 +23,16 @@ async function obtainStorageBindings(projectId, existingPolicy) {
     return [pubsubBinding];
 }
 exports.obtainStorageBindings = obtainStorageBindings;
-async function ensureStorageTriggerRegion(endpoint, eventTrigger) {
+async function ensureStorageTriggerRegion(endpoint) {
+    const { eventTrigger } = endpoint;
     if (!eventTrigger.region) {
         logger_1.logger.debug("Looking up bucket region for the storage event trigger");
+        const bucketFilter = backend.findEventFilter(endpoint, "bucket");
+        if (!bucketFilter) {
+            throw new error_1.FirebaseError("Storage event trigger unexpectedly missing event filter with bucket attribute.");
+        }
         try {
-            const bucket = await storage.getBucket(eventTrigger.eventFilters.bucket);
+            const bucket = await storage.getBucket(bucketFilter.value);
             eventTrigger.region = bucket.location.toLowerCase();
             logger_1.logger.debug("Setting the event trigger region to", eventTrigger.region, ".");
         }

package/lib/deploy/functions/triggerRegionHelper.js

@@ -9,7 +9,7 @@ async function ensureTriggerRegions(want) {
         if (ep.platform === "gcfv1" || !backend.isEventTriggered(ep)) {
             continue;
         }
-        regionLookups.push((0, services_1.serviceForEndpoint)(ep).ensureTriggerRegion(ep, ep.eventTrigger));
+        regionLookups.push((0, services_1.serviceForEndpoint)(ep).ensureTriggerRegion(ep));
     }
     await Promise.all(regionLookups);
 }

package/lib/deploy/functions/validate.js

@@ -14,7 +14,7 @@ function endpointsAreValid(wantBackend) {
     functionIdsAreValid(backend.allEndpoints(wantBackend));
     const gcfV1WithConcurrency = backend
         .allEndpoints(wantBackend)
-        .filter((endpoint) => (endpoint.concurrency || 1) != 1 && endpoint.platform == "gcfv1")
+        .filter((endpoint) => (endpoint.concurrency || 1) !== 1 && endpoint.platform === "gcfv1")
         .map((endpoint) => endpoint.id);
     if (gcfV1WithConcurrency.length) {
         const msg = `Cannot set concurrency on the functions ${gcfV1WithConcurrency.join(",")} because they are GCF gen 1`;
@@ -23,7 +23,7 @@ function endpointsAreValid(wantBackend) {
     const tooSmallForConcurrency = backend
         .allEndpoints(wantBackend)
         .filter((endpoint) => {
-        if ((endpoint.concurrency || 1) == 1) {
+        if ((endpoint.concurrency || 1) === 1) {
             return false;
         }
         const mem = endpoint.availableMemoryMb || backend.DEFAULT_MEMORY;
@@ -98,7 +98,7 @@ async function validateSecretVersions(projectId, endpoints) {
     for (const result of results) {
         if (result.status === "fulfilled") {
             const sv = result.value;
-            if (sv.state != "ENABLED") {
+            if (sv.state !== "ENABLED") {
                 errs.push(new error_1.FirebaseError(`Expected secret ${sv.secret.name}@${sv.versionId} to be in state ENABLED not ${sv.state}.`));
             }
             secretVersions[sv.secret.name] = sv;

package/lib/deploy/hosting/client.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.client = void 0;
+const api_1 = require("../../api");
+const apiv2_1 = require("../../apiv2");
+exports.client = new apiv2_1.Client({
+    urlPrefix: api_1.hostingApiOrigin,
+    apiVersion: "v1beta1",
+});

package/lib/deploy/hosting/convertConfig.js

@@ -46,6 +46,12 @@ function convertConfig(config) {
             }
             else if ("function" in rewrite) {
                 vRewrite.function = rewrite.function;
+                if (rewrite.region) {
+                    vRewrite.functionRegion = rewrite.region;
+                }
+                else {
+                    vRewrite.functionRegion = "us-central1";
+                }
             }
             else if ("dynamicLinks" in rewrite) {
                 vRewrite.dynamicLinks = rewrite.dynamicLinks;

package/lib/deploy/hosting/deploy.js

@@ -53,7 +53,7 @@ async function deploy(context, options) {
             await uploader.start();
         }
         catch (err) {
-            track("Hosting Deploy", "failure");
+            void track("Hosting Deploy", "failure");
             throw err;
         }
         finally {
@@ -65,7 +65,7 @@ async function deploy(context, options) {
         (0, utils_1.logLabeledSuccess)("hosting[" + deploy.site + "]", "file upload complete");
         const dt = Date.now() - t0;
         logger_1.logger.debug("[hosting] deploy completed after " + dt + "ms");
-        track("Hosting Deploy", "success", dt);
+        void track("Hosting Deploy", "success", dt);
         return runDeploys(deploys, debugging);
     }
     const debugging = !!(options.debug || options.nonInteractive);

package/lib/deploy/hosting/hashcache.js

@@ -1,46 +1,48 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dump = exports.load = void 0;
 const fs = require("fs-extra");
 const path = require("path");
-const { logger } = require("../../logger");
+const logger_1 = require("../../logger");
 function cachePath(cwd, name) {
-    return path.resolve(cwd, ".firebase/hosting." + name + ".cache");
+    return path.resolve(cwd, `.firebase/hosting.${name}.cache`);
 }
-exports.load = function (cwd, name) {
+function load(cwd, name) {
     try {
-        const out = {};
-        const lines = fs.readFileSync(cachePath(cwd, name), {
-            encoding: "utf8",
-        });
-        lines.split("\n").forEach(function (line) {
+        const out = new Map();
+        const lines = fs.readFileSync(cachePath(cwd, name), "utf8");
+        for (const line of lines.split("\n")) {
             const d = line.split(",");
             if (d.length === 3) {
-                out[d[0]] = { mtime: parseInt(d[1]), hash: d[2] };
+                out.set(d[0], { mtime: parseInt(d[1]), hash: d[2] });
             }
-        });
+        }
         return out;
     }
     catch (e) {
         if (e.code === "ENOENT") {
-            logger.debug("[hosting] hash cache [" + name + "] not populated");
+            logger_1.logger.debug(`[hosting] hash cache [${name}] not populated`);
         }
         else {
-            logger.debug("[hosting] hash cache [" + name + "] load error:", e.message);
+            logger_1.logger.debug(`[hosting] hash cache [${name}] load error: ${e.message}`);
         }
-        return {};
+        return new Map();
     }
-};
-exports.dump = function (cwd, name, data) {
+}
+exports.load = load;
+function dump(cwd, name, data) {
     let st = "";
     let count = 0;
     for (const [path, d] of data) {
         count++;
-        st += path + "," + d.mtime + "," + d.hash + "\n";
+        st += `${path},${d.mtime},${d.hash}\n`;
     }
     try {
         fs.outputFileSync(cachePath(cwd, name), st, { encoding: "utf8" });
-        logger.debug("[hosting] hash cache [" + name + "] stored for", count, "files");
+        logger_1.logger.debug(`[hosting] hash cache [${name}] stored for ${count} files`);
     }
     catch (e) {
-        logger.debug("[hosting] unable to store hash cache [" + name + "]", e.stack);
+        logger_1.logger.debug(`[hosting] unable to store hash cache [${name}]: ${e.stack}`);
     }
-};
+}
+exports.dump = dump;

package/lib/deploy/hosting/index.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.release = exports.deploy = exports.prepare = void 0;
-const prepare = require("./prepare");
-exports.prepare = prepare;
-const deploy_1 = require("./deploy");
+var prepare_1 = require("./prepare");
+Object.defineProperty(exports, "prepare", { enumerable: true, get: function () { return prepare_1.prepare; } });
+var deploy_1 = require("./deploy");
 Object.defineProperty(exports, "deploy", { enumerable: true, get: function () { return deploy_1.deploy; } });
-const release = require("./release");
-exports.release = release;
+var release_1 = require("./release");
+Object.defineProperty(exports, "release", { enumerable: true, get: function () { return release_1.release; } });

package/lib/deploy/hosting/prepare.js

@@ -1,44 +1,44 @@
 "use strict";
-const _ = require("lodash");
-const api = require("../../api");
-const { convertConfig } = require("./convertConfig");
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepare = void 0;
+const error_1 = require("../../error");
+const client_1 = require("./client");
+const projectUtils_1 = require("../../projectUtils");
+const normalizedHostingConfigs_1 = require("../../hosting/normalizedHostingConfigs");
+const validate_1 = require("./validate");
+const convertConfig_1 = require("./convertConfig");
 const deploymentTool = require("../../deploymentTool");
-const { FirebaseError } = require("../../error");
-const { normalizedHostingConfigs } = require("../../hosting/normalizedHostingConfigs");
-const { validateDeploy } = require("./validate");
-module.exports = function (context, options) {
+async function prepare(context, options) {
     if (options.public) {
-        if (_.isArray(options.config.get("hosting"))) {
-            throw new FirebaseError("Cannot specify --public option with multi-site configuration.");
+        if (Array.isArray(options.config.get("hosting"))) {
+            throw new error_1.FirebaseError("Cannot specify --public option with multi-site configuration.");
         }
         options.config.set("hosting.public", options.public);
     }
-    const configs = normalizedHostingConfigs(options, { resolveTargets: true });
+    const projectNumber = await (0, projectUtils_1.needProjectNumber)(options);
+    const configs = (0, normalizedHostingConfigs_1.normalizedHostingConfigs)(options, { resolveTargets: true });
     if (configs.length === 0) {
         return Promise.resolve();
     }
     context.hosting = {
-        deploys: configs.map(function (cfg) {
+        deploys: configs.map((cfg) => {
             return { config: cfg, site: cfg.site };
         }),
     };
     const versionCreates = [];
-    _.each(context.hosting.deploys, function (deploy) {
+    for (const deploy of context.hosting.deploys) {
         const cfg = deploy.config;
-        validateDeploy(deploy, options);
+        (0, validate_1.validateDeploy)(deploy, options);
         const data = {
-            config: convertConfig(cfg),
+            config: (0, convertConfig_1.convertConfig)(cfg),
             labels: deploymentTool.labels(),
         };
-        versionCreates.push(api
-            .request("POST", `/v1beta1/sites/${deploy.site}/versions`, {
-            origin: api.hostingApiOrigin,
-            auth: true,
-            data,
-        })
-            .then(function (result) {
-            deploy.version = result.body.name;
+        versionCreates.push(client_1.client
+            .post(`/projects/${projectNumber}/sites/${deploy.site}/versions`, data)
+            .then((res) => {
+            deploy.version = res.body.name;
         }));
-    });
-    return Promise.all(versionCreates);
-};
+    }
+    await Promise.all(versionCreates);
+}
+exports.prepare = prepare;

package/lib/deploy/hosting/release.js

@@ -1,34 +1,31 @@
 "use strict";
-const api = require("../../api");
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.release = void 0;
+const client_1 = require("./client");
+const logger_1 = require("../../logger");
+const projectUtils_1 = require("../../projectUtils");
 const utils = require("../../utils");
-const { logger } = require("../../logger");
-module.exports = function (context, options) {
+async function release(context, options) {
     if (!context.hosting || !context.hosting.deploys) {
-        return Promise.resolve();
+        return;
     }
-    logger.debug(JSON.stringify(context.hosting.deploys, null, 2));
-    return Promise.all(context.hosting.deploys.map(async function (deploy) {
-        utils.logLabeledBullet("hosting[" + deploy.site + "]", "finalizing version...");
-        const finalizeResult = await api.request("PATCH", `/v1beta1/${deploy.version}?updateMask=status`, {
-            origin: api.hostingApiOrigin,
-            auth: true,
-            data: { status: "FINALIZED" },
-        });
-        logger.debug("[hosting] finalized version for " + deploy.site + ":", finalizeResult.body);
-        utils.logLabeledSuccess("hosting[" + deploy.site + "]", "version finalized");
-        utils.logLabeledBullet("hosting[" + deploy.site + "]", "releasing new version...");
+    const projectNumber = await (0, projectUtils_1.needProjectNumber)(options);
+    logger_1.logger.debug(JSON.stringify(context.hosting.deploys, null, 2));
+    await Promise.all(context.hosting.deploys.map(async (deploy) => {
+        utils.logLabeledBullet(`hosting[${deploy.site}]`, "finalizing version...");
+        const finalizeResult = await client_1.client.patch(`/${deploy.version}`, { status: "FINALIZED" }, { queryParams: { updateMask: "status" } });
+        logger_1.logger.debug(`[hosting] finalized version for ${deploy.site}:${finalizeResult.body}`);
+        utils.logLabeledSuccess(`hosting[${deploy.site}]`, "version finalized");
+        utils.logLabeledBullet(`hosting[${deploy.site}]`, "releasing new version...");
         const channelSegment = context.hostingChannel && context.hostingChannel !== "live"
             ? `/channels/${context.hostingChannel}`
             : "";
         if (channelSegment) {
-            logger.debug("[hosting] releasing to channel:", context.hostingChannel);
+            logger_1.logger.debug("[hosting] releasing to channel:", context.hostingChannel);
         }
-        const releaseResult = await api.request("POST", `/v1beta1/sites/${deploy.site}${channelSegment}/releases?version_name=${deploy.version}`, {
-            auth: true,
-            origin: api.hostingApiOrigin,
-            data: { message: options.message || null },
-        });
-        logger.debug("[hosting] release:", releaseResult.body);
-        utils.logLabeledSuccess("hosting[" + deploy.site + "]", "release complete");
+        const releaseResult = await client_1.client.post(`/projects/${projectNumber}/sites/${deploy.site}${channelSegment}/releases`, { message: options.message || null }, { queryParams: { versionName: deploy.version } });
+        logger_1.logger.debug("[hosting] release:", releaseResult.body);
+        utils.logLabeledSuccess(`hosting[${deploy.site}]`, "release complete");
     }));
-};
+}
+exports.release = release;

package/lib/deploy/hosting/uploader.js

@@ -11,7 +11,7 @@ const zlib = require("zlib");
 const apiv2_1 = require("../../apiv2");
 const queue_1 = require("../../throttler/queue");
 const api_1 = require("../../api");
-const hashcache = require("./hashcache");
+const hashcache_1 = require("./hashcache");
 const logger_1 = require("../../logger");
 const error_1 = require("../../error");
 const MIN_UPLOAD_TIMEOUT = 30000;
@@ -54,7 +54,7 @@ class Uploader {
         this.public = options.public || this.cwd;
         this.files = options.files;
         this.fileCount = this.files.length;
-        this.cache = hashcache.load(this.projectRoot, this.hashcacheName());
+        this.cache = (0, hashcache_1.load)(this.projectRoot, this.hashcacheName());
         this.cacheNew = new Map();
         this.sizeMap = {};
         this.hashMap = {};
@@ -78,7 +78,7 @@ class Uploader {
             .wait()
             .then(this.queuePopulate.bind(this))
             .then(() => {
-            hashcache.dump(this.projectRoot, this.hashcacheName(), this.cacheNew);
+            (0, hashcache_1.dump)(this.projectRoot, this.hashcacheName(), this.cacheNew);
             logger_1.logger.debug("[hosting][hash queue][FINAL]", this.hashQueue.stats());
             this.populateQueue.close();
             return this.populateQueue.wait();
@@ -91,7 +91,7 @@ class Uploader {
         this.uploadQueue.wait().catch((err) => {
             if (err.message.includes("content hash")) {
                 logger_1.logger.debug("[hosting][upload queue] upload failed with content hash error. Deleting hash cache");
-                hashcache.dump(this.projectRoot, this.hashcacheName(), new Map());
+                (0, hashcache_1.dump)(this.projectRoot, this.hashcacheName(), new Map());
             }
         });
         const fin = (err) => {
@@ -123,7 +123,7 @@ class Uploader {
         const stats = fs.statSync(path.resolve(this.public, filePath));
         const mtime = stats.mtime.getTime();
         this.sizeMap[filePath] = stats.size;
-        const cached = this.cache[filePath];
+        const cached = this.cache.get(filePath);
         if (cached && cached.mtime === mtime) {
             this.cacheNew.set(filePath, cached);
             this.addHash(filePath, cached.hash);

package/lib/deploy/remoteconfig/functions.js

@@ -20,10 +20,10 @@ async function getEtag(projectNumber, versionNumber) {
 exports.getEtag = getEtag;
 function validateInputRemoteConfigTemplate(template) {
     const templateCopy = JSON.parse(JSON.stringify(template));
-    if (!templateCopy || templateCopy == "null" || templateCopy == "undefined") {
+    if (!templateCopy || templateCopy === "null" || templateCopy === "undefined") {
         throw new error_1.FirebaseError(`Invalid Remote Config template: ${JSON.stringify(templateCopy)}`);
     }
-    if (typeof templateCopy.etag !== "string" || templateCopy.etag == "") {
+    if (typeof templateCopy.etag !== "string" || templateCopy.etag === "") {
         throw new error_1.FirebaseError("ETag must be a non-empty string");
     }
     if (templateCopy.conditions && !Array.isArray(templateCopy.conditions)) {

package/lib/emulator/auth/cloudFunctions.js

@@ -35,7 +35,7 @@ class AuthCloudFunction {
         catch (e) {
             err = e;
         }
-        if (err || (res === null || res === void 0 ? void 0 : res.status) != 200) {
+        if (err || (res === null || res === void 0 ? void 0 : res.status) !== 200) {
             this.logger.logLabeled("WARN", "functions", `Firebase Authentication function was not triggered due to emulation error. Please file a bug.`);
         }
     }

package/lib/emulator/auth/operations.js

@@ -1378,7 +1378,7 @@ function mfaSignInFinalize(state, reqBody) {
     (0, errors_1.assert)(sessionInfo, "MISSING_SESSION_INFO");
     const phoneNumber = verifyPhoneNumber(state, sessionInfo, code);
     let { user, signInProvider } = parsePendingCredential(state, reqBody.mfaPendingCredential);
-    const enrollment = (_b = user.mfaInfo) === null || _b === void 0 ? void 0 : _b.find((enrollment) => enrollment.unobfuscatedPhoneInfo == phoneNumber);
+    const enrollment = (_b = user.mfaInfo) === null || _b === void 0 ? void 0 : _b.find((enrollment) => enrollment.unobfuscatedPhoneInfo === phoneNumber);
     (0, errors_1.assert)(enrollment && enrollment.mfaEnrollmentId, "MFA_ENROLLMENT_NOT_FOUND");
     user = state.updateUserByLocalId(user.localId, { lastLoginAt: Date.now().toString() });
     (0, errors_1.assert)(!user.disabled, "USER_DISABLED");

package/lib/emulator/commandUtils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.emulatorExec = exports.shutdownWhenKilled = exports.setExportOnExitOptions = exports.parseInspectionPort = exports.beforeEmulatorCommand = exports.warnEmulatorNotSupported = exports.printNoticeIfEmulated = exports.DESC_TEST_PARAMS = exports.FLAG_TEST_PARAMS = exports.DESC_TEST_CONFIG = exports.FLAG_TEST_CONFIG = exports.DESC_UI = exports.FLAG_UI = exports.EXPORT_ON_EXIT_USAGE_ERROR = exports.DESC_EXPORT_ON_EXIT = exports.FLAG_EXPORT_ON_EXIT = exports.FLAG_EXPORT_ON_EXIT_NAME = exports.DESC_IMPORT = exports.FLAG_IMPORT = exports.DESC_INSPECT_FUNCTIONS = exports.FLAG_INSPECT_FUNCTIONS = exports.DESC_ONLY = exports.FLAG_ONLY = void 0;
+exports.emulatorExec = exports.shutdownWhenKilled = exports.setExportOnExitOptions = exports.parseInspectionPort = exports.beforeEmulatorCommand = exports.warnEmulatorNotSupported = exports.printNoticeIfEmulated = exports.DESC_TEST_PARAMS = exports.FLAG_TEST_PARAMS = exports.DESC_TEST_CONFIG = exports.FLAG_TEST_CONFIG = exports.DESC_UI = exports.FLAG_UI = exports.EXPORT_ON_EXIT_CWD_DANGER = exports.EXPORT_ON_EXIT_USAGE_ERROR = exports.DESC_EXPORT_ON_EXIT = exports.FLAG_EXPORT_ON_EXIT = exports.FLAG_EXPORT_ON_EXIT_NAME = exports.DESC_IMPORT = exports.FLAG_IMPORT = exports.DESC_INSPECT_FUNCTIONS = exports.FLAG_INSPECT_FUNCTIONS = exports.DESC_ONLY = exports.FLAG_ONLY = void 0;
 const clc = require("cli-color");
 const childProcess = require("child_process");
 const controller = require("../emulator/controller");
@@ -36,6 +36,7 @@ exports.DESC_EXPORT_ON_EXIT = "automatically export emulator data (emulators:exp
     `when no dir is provided the location of ${exports.FLAG_IMPORT} is used`;
 exports.EXPORT_ON_EXIT_USAGE_ERROR = `"${exports.FLAG_EXPORT_ON_EXIT_NAME}" must be used with "${exports.FLAG_IMPORT}"` +
     ` or provide a dir directly to "${exports.FLAG_EXPORT_ON_EXIT}"`;
+exports.EXPORT_ON_EXIT_CWD_DANGER = `"${exports.FLAG_EXPORT_ON_EXIT_NAME}" must not point to the current directory or parents. Please choose a new/dedicated directory for exports.`;
 exports.FLAG_UI = "--ui";
 exports.DESC_UI = "run the Emulator UI";
 exports.FLAG_TEST_CONFIG = "--test-config <firebase.json file>";
@@ -131,6 +132,9 @@ function setExportOnExitOptions(options) {
         if (options.exportOnExit === true || !options.exportOnExit) {
             throw new error_1.FirebaseError(exports.EXPORT_ON_EXIT_USAGE_ERROR);
         }
+        if (path.resolve(".").startsWith(path.resolve(options.exportOnExit))) {
+            throw new error_1.FirebaseError(exports.EXPORT_ON_EXIT_CWD_DANGER);
+        }
     }
     return;
 }

package/lib/emulator/constants.js

@@ -8,6 +8,7 @@ const DEFAULT_PORTS = {
     logging: 4500,
     hosting: 5000,
     functions: 5001,
+    extensions: 5001,
     firestore: 8080,
     pubsub: 8085,
     database: 9000,
@@ -25,6 +26,7 @@ exports.FIND_AVAILBLE_PORT_BY_DEFAULT = {
     pubsub: false,
     auth: false,
     storage: false,
+    extensions: false,
 };
 exports.EMULATOR_DESCRIPTION = {
     ui: "Emulator UI",
@@ -37,6 +39,7 @@ exports.EMULATOR_DESCRIPTION = {
     pubsub: "Pub/Sub Emulator",
     auth: "Authentication Emulator",
     storage: "Storage Emulator",
+    extensions: "Extensions Emulator",
 };
 const DEFAULT_HOST = "localhost";
 class Constants {
@@ -87,6 +90,7 @@ class Constants {
 }
 exports.Constants = Constants;
 Constants.FAKE_PROJECT_ID_PREFIX = "demo-";
+Constants.FAKE_PROJECT_NUMBER = "0";
 Constants.DEFAULT_DATABASE_EMULATOR_NAMESPACE = "fake-server";
 Constants.FIRESTORE_EMULATOR_HOST = "FIRESTORE_EMULATOR_HOST";
 Constants.FIREBASE_DATABASE_EMULATOR_HOST = "FIREBASE_DATABASE_EMULATOR_HOST";

package/lib/emulator/controller.js

@@ -33,10 +33,17 @@ const prompt_1 = require("../prompt");
 const commandUtils_1 = require("./commandUtils");
 const fsutils_1 = require("../fsutils");
 const storage_1 = require("./storage");
+const config_1 = require("./storage/rules/config");
 const getDefaultDatabaseInstance_1 = require("../getDefaultDatabaseInstance");
 const auth_2 = require("../auth");
+const extensionsEmulator_1 = require("./extensionsEmulator");
+const previews_1 = require("../previews");
+const START_LOGGING_EMULATOR = utils.envOverride("START_LOGGING_EMULATOR", "false", (val) => val === "true");
 async function getAndCheckAddress(emulator, options) {
     var _a, _b, _c, _d;
+    if (emulator === types_1.Emulators.EXTENSIONS) {
+        emulator = types_1.Emulators.FUNCTIONS;
+    }
     let host = ((_b = (_a = options.config.src.emulators) === null || _a === void 0 ? void 0 : _a[emulator]) === null || _b === void 0 ? void 0 : _b.host) || constants_1.Constants.getDefaultHost(emulator);
     if (host === "localhost" && utils.isRunningInWSL()) {
         host = "127.0.0.1";
@@ -56,7 +63,7 @@ async function getAndCheckAddress(emulator, options) {
     if (!portOpen) {
         if (findAvailablePort) {
             const newPort = await portUtils.findAvailablePort(host, port);
-            if (newPort != port) {
+            if (newPort !== port) {
                 loggerForEmulator.logLabeled("WARN", emulator, `${constants_1.Constants.description(emulator)} unable to start on port ${port}, starting on ${newPort} instead.`);
                 port = newPort;
             }
@@ -86,7 +93,7 @@ async function getAndCheckAddress(emulator, options) {
 }
 async function startEmulator(instance) {
     const name = instance.getName();
-    track("Emulator Run", name);
+    void track("Emulator Run", name);
     await registry_1.EmulatorRegistry.start(instance);
 }
 exports.startEmulator = startEmulator;
@@ -115,7 +122,11 @@ async function cleanShutdown() {
 }
 exports.cleanShutdown = cleanShutdown;
 function filterEmulatorTargets(options) {
-    let targets = types_1.ALL_SERVICE_EMULATORS.filter((e) => {
+    let targets = [...types_1.ALL_SERVICE_EMULATORS];
+    if (previews_1.previews.extensionsemulator) {
+        targets.push(types_1.Emulators.EXTENSIONS);
+    }
+    targets = targets.filter((e) => {
         return options.config.has(e) || options.config.has(`emulators.${e}`);
     });
     const onlyOptions = options.only;
@@ -222,7 +233,7 @@ async function startAll(options, showUI = true) {
     if (shouldStart(options, types_1.Emulators.HUB)) {
         const hubAddr = await getAndCheckAddress(types_1.Emulators.HUB, options);
         const hub = new hub_1.EmulatorHub(Object.assign({ projectId }, hubAddr));
-        track("emulators:start", "hub");
+        void track("emulators:start", "hub");
         await startEmulator(hub);
     }
     let exportMetadata = {
@@ -239,19 +250,47 @@ async function startAll(options, showUI = true) {
             hubLogger.logLabeled("WARN", "emulators", `Could not find import/export metadata file, ${clc.bold("skipping data import!")}`);
         }
     }
+    const emulatableBackends = [];
+    const projectDir = (options.extDevDir || options.config.projectDir);
     if (shouldStart(options, types_1.Emulators.FUNCTIONS)) {
-        const functionsLogger = emulatorLogger_1.EmulatorLogger.forEmulator(types_1.Emulators.FUNCTIONS);
-        const functionsAddr = await getAndCheckAddress(types_1.Emulators.FUNCTIONS, options);
-        const projectId = (0, projectUtils_1.needProjectId)(options);
         utils.assertDefined(options.config.src.functions);
         utils.assertDefined(options.config.src.functions.source, "Error: 'functions.source' is not defined");
-        utils.assertIsStringOrUndefined(options.extensionDir);
-        const projectDir = options.extensionDir || options.config.projectDir;
+        utils.assertIsStringOrUndefined(options.extDevDir);
         const functionsDir = path.join(projectDir, options.config.src.functions.source);
+        emulatableBackends.push({
+            functionsDir,
+            env: Object.assign({}, options.extDevEnv),
+            secretEnv: [],
+            predefinedTriggers: options.extDevTriggers,
+            nodeMajorVersion: (0, functionsEmulatorUtils_1.parseRuntimeVersion)(options.extDevNodeVersion || options.config.get("functions.runtime")),
+        });
+    }
+    if (shouldStart(options, types_1.Emulators.EXTENSIONS) && previews_1.previews.extensionsemulator) {
+        const projectNumber = constants_1.Constants.isDemoProject(projectId)
+            ? constants_1.Constants.FAKE_PROJECT_NUMBER
+            : await (0, projectUtils_1.needProjectNumber)(options);
+        const aliases = (0, projectUtils_1.getAliases)(options, projectId);
+        const extensionEmulator = new extensionsEmulator_1.ExtensionsEmulator({
+            projectId,
+            projectDir: options.config.projectDir,
+            projectNumber,
+            aliases,
+            extensions: options.config.get("extensions"),
+        });
+        const extensionsBackends = await extensionEmulator.getExtensionBackends();
+        const filteredExtensionsBackends = extensionEmulator.filterUnemulatedTriggers(options, extensionsBackends);
+        emulatableBackends.push(...filteredExtensionsBackends);
+        void track("Emulator Run", types_1.Emulators.EXTENSIONS);
+        registry_1.EmulatorRegistry.registerExtensionsEmulator();
+    }
+    if (emulatableBackends.length) {
+        const functionsLogger = emulatorLogger_1.EmulatorLogger.forEmulator(types_1.Emulators.FUNCTIONS);
+        const functionsAddr = await getAndCheckAddress(types_1.Emulators.FUNCTIONS, options);
+        const projectId = (0, projectUtils_1.needProjectId)(options);
         let inspectFunctions;
         if (options.inspectFunctions) {
             inspectFunctions = commandUtils.parseInspectionPort(options);
-            functionsLogger.logLabeled("WARN", "functions", `You are running the functions emulator in debug mode (port=${inspectFunctions}). This means that functions will execute in sequence rather than in parallel.`);
+            functionsLogger.logLabeled("WARN", "functions", `You are running the Functions emulator in debug mode (port=${inspectFunctions}). This means that functions will execute in sequence rather than in parallel.`);
         }
         const emulatorsNotRunning = types_1.ALL_SERVICE_EMULATORS.filter((e) => {
             return e !== types_1.Emulators.FUNCTIONS && !shouldStart(options, e);
@@ -260,14 +299,6 @@ async function startAll(options, showUI = true) {
             functionsLogger.logLabeled("WARN", "functions", `The following emulators are not running, calls to these services from the Functions emulator will affect production: ${clc.bold(emulatorsNotRunning.join(", "))}`);
         }
         const account = (0, auth_2.getProjectDefaultAccount)(options.projectRoot);
-        const emulatableBackends = [
-            {
-                functionsDir,
-                env: Object.assign({}, options.extensionEnv),
-                predefinedTriggers: options.extensionTriggers,
-                nodeMajorVersion: (0, functionsEmulatorUtils_1.parseRuntimeVersion)(options.extensionNodeVersion || options.config.get("functions.runtime")),
-            },
-        ];
         const functionsEmulator = new functionsEmulator_1.FunctionsEmulator({
             projectId,
             projectDir,
@@ -276,6 +307,7 @@ async function startAll(options, showUI = true) {
             host: functionsAddr.host,
             port: functionsAddr.port,
             debugPort: inspectFunctions,
+            projectAlias: options.projectAlias,
         });
         await startEmulator(functionsEmulator);
     }
@@ -395,15 +427,11 @@ async function startAll(options, showUI = true) {
     }
     if (shouldStart(options, types_1.Emulators.STORAGE)) {
         const storageAddr = await getAndCheckAddress(types_1.Emulators.STORAGE, options);
-        const storageConfig = options.config.data.storage;
-        if (!(storageConfig === null || storageConfig === void 0 ? void 0 : storageConfig.rules)) {
-            throw new error_1.FirebaseError("Cannot start the Storage emulator without rules file specified in firebase.json: run 'firebase init' and set up your Storage configuration");
-        }
         const storageEmulator = new storage_1.StorageEmulator({
             host: storageAddr.host,
             port: storageAddr.port,
             projectId: projectId,
-            rules: options.config.path(storageConfig.rules),
+            rules: (0, config_1.getStorageRulesConfig)(projectId, options),
         });
         await startEmulator(storageEmulator);
         if (exportMetadata.storage) {
@@ -425,13 +453,15 @@ async function startAll(options, showUI = true) {
     if (showUI && !shouldStart(options, types_1.Emulators.UI)) {
         hubLogger.logLabeled("WARN", "emulators", "The Emulator UI requires a project ID to start. Configure your default project with 'firebase use' or pass the --project flag.");
     }
-    if (showUI && shouldStart(options, types_1.Emulators.UI)) {
+    if (showUI && (shouldStart(options, types_1.Emulators.UI) || START_LOGGING_EMULATOR)) {
         const loggingAddr = await getAndCheckAddress(types_1.Emulators.LOGGING, options);
         const loggingEmulator = new loggingEmulator_1.LoggingEmulator({
             host: loggingAddr.host,
             port: loggingAddr.port,
         });
         await startEmulator(loggingEmulator);
+    }
+    if (showUI && shouldStart(options, types_1.Emulators.UI)) {
         const uiAddr = await getAndCheckAddress(types_1.Emulators.UI, options);
         const ui = new ui_1.EmulatorUI(Object.assign({ projectId: projectId, auto_download: true }, uiAddr));
         await startEmulator(ui);