firebase-tools 10.4.2 → 10.7.0

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_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;
+exports.JAVA_DEPRECATION_WARNING = exports.checkJavaSupported = 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");
@@ -287,15 +287,19 @@ async function emulatorExec(script, options) {
         extraEnv.GCLOUD_PROJECT = projectId;
     }
     let exitCode = 0;
+    let deprecationNotices;
     try {
         const showUI = !!options.ui;
-        await controller.startAll(options, showUI);
+        ({ deprecationNotices } = await controller.startAll(options, showUI));
         exitCode = await runScript(script, extraEnv);
         await (0, controller_1.onExit)(options);
     }
     finally {
         await controller.cleanShutdown();
     }
+    for (const notice of deprecationNotices) {
+        utils.logLabeledWarning("emulators", notice, "warn");
+    }
     if (exitCode !== 0) {
         throw new error_1.FirebaseError(`Script "${clc.bold(script)}" exited with code ${exitCode}`, {
             exit: exitCode,
@@ -303,3 +307,69 @@ async function emulatorExec(script, options) {
     }
 }
 exports.emulatorExec = emulatorExec;
+const JAVA_VERSION_REGEX = /version "([1-9][0-9]*)/;
+const MIN_SUPPORTED_JAVA_MAJOR_VERSION = 11;
+const JAVA_HINT = "Please make sure Java is installed and on your system PATH.";
+async function checkJavaSupported() {
+    return new Promise((resolve, reject) => {
+        var _a, _b;
+        let child;
+        try {
+            child = childProcess.spawn("java", ["-Duser.language=en", "-Dfile.encoding=UTF-8", "-version"], {
+                stdio: ["inherit", "pipe", "pipe"],
+            });
+        }
+        catch (err) {
+            return reject(new error_1.FirebaseError(`Could not spawn \`java -version\`. ${JAVA_HINT}`, { original: err }));
+        }
+        let output = "";
+        let error = "";
+        (_a = child.stdout) === null || _a === void 0 ? void 0 : _a.on("data", (data) => {
+            const str = data.toString("utf8");
+            logger_1.logger.debug(str);
+            output += str;
+        });
+        (_b = child.stderr) === null || _b === void 0 ? void 0 : _b.on("data", (data) => {
+            const str = data.toString("utf8");
+            logger_1.logger.debug(str);
+            error += str;
+        });
+        child.once("error", (err) => {
+            reject(new error_1.FirebaseError(`Could not spawn \`java -version\`. ${JAVA_HINT}`, { original: err }));
+        });
+        child.once("exit", (code, signal) => {
+            if (signal) {
+                reject(new error_1.FirebaseError(`Process \`java -version\` was killed by signal ${signal}.`));
+            }
+            else if (code && code !== 0) {
+                reject(new error_1.FirebaseError(`Process \`java -version\` has exited with code ${code}. ${JAVA_HINT}\n` +
+                    `-----Original stdout-----\n${output}` +
+                    `-----Original stderr-----\n${error}`));
+            }
+            else {
+                resolve(`${output}\n${error}`);
+            }
+        });
+    }).then((output) => {
+        const match = output.match(JAVA_VERSION_REGEX);
+        if (match) {
+            const version = match[1];
+            const versionInt = parseInt(version, 10);
+            if (!versionInt) {
+                utils.logLabeledWarning("emulators", `Failed to parse Java version. Got "${match[0]}".`, "warn");
+            }
+            else {
+                logger_1.logger.debug(`Parsed Java major version: ${versionInt}`);
+                return versionInt >= MIN_SUPPORTED_JAVA_MAJOR_VERSION;
+            }
+        }
+        else {
+            logger_1.logger.debug("java -version outputs:", output);
+            logger_1.logger.warn(`Failed to parse Java version.`);
+        }
+        return false;
+    });
+}
+exports.checkJavaSupported = checkJavaSupported;
+exports.JAVA_DEPRECATION_WARNING = "Support for Java version <= 10 will be dropped soon in firebase-tools@11. " +
+    "Please upgrade to Java version 11 or above to continue using the emulators.";

package/lib/emulator/controller.js

@@ -6,7 +6,7 @@ const clc = require("cli-color");
 const fs = require("fs");
 const path = require("path");
 const logger_1 = require("../logger");
-const track = require("../track");
+const track_1 = require("../track");
 const utils = require("../utils");
 const registry_1 = require("./registry");
 const types_1 = require("./types");
@@ -39,6 +39,7 @@ const auth_2 = require("../auth");
 const extensionsEmulator_1 = require("./extensionsEmulator");
 const previews_1 = require("../previews");
 const projectConfig_1 = require("../functions/projectConfig");
+const downloadableEmulators_1 = require("./downloadableEmulators");
 const START_LOGGING_EMULATOR = utils.envOverride("START_LOGGING_EMULATOR", "false", (val) => val === "true");
 async function getAndCheckAddress(emulator, options) {
     var _a, _b, _c, _d;
@@ -94,7 +95,7 @@ async function getAndCheckAddress(emulator, options) {
 }
 async function startEmulator(instance) {
     const name = instance.getName();
-    void track("Emulator Run", name);
+    void (0, track_1.track)("Emulator Run", name);
     await registry_1.EmulatorRegistry.start(instance);
 }
 exports.startEmulator = startEmulator;
@@ -216,6 +217,13 @@ async function startAll(options, showUI = true) {
     if (targets.length === 0) {
         throw new error_1.FirebaseError(`No emulators to start, run ${clc.bold("firebase init emulators")} to get started.`);
     }
+    const deprecationNotices = [];
+    if (targets.some(downloadableEmulators_1.requiresJava)) {
+        if (!(await commandUtils.checkJavaSupported())) {
+            utils.logLabeledWarning("emulators", commandUtils_1.JAVA_DEPRECATION_WARNING, "warn");
+            deprecationNotices.push(commandUtils_1.JAVA_DEPRECATION_WARNING);
+        }
+    }
     const hubLogger = emulatorLogger_1.EmulatorLogger.forEmulator(types_1.Emulators.HUB);
     hubLogger.logLabeled("BULLET", "emulators", `Starting emulators: ${targets.join(", ")}`);
     const projectId = (0, projectUtils_1.getProjectId)(options) || "";
@@ -240,7 +248,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));
-        void track("emulators:start", "hub");
+        void (0, track_1.track)("emulators:start", "hub");
         await startEmulator(hub);
     }
     let exportMetadata = {
@@ -286,8 +294,8 @@ async function startAll(options, showUI = true) {
         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();
+        void (0, track_1.track)("Emulator Run", types_1.Emulators.EXTENSIONS);
+        await startEmulator(extensionEmulator);
     }
     if (emulatableBackends.length) {
         const functionsLogger = emulatorLogger_1.EmulatorLogger.forEmulator(types_1.Emulators.FUNCTIONS);
@@ -479,6 +487,7 @@ async function startAll(options, showUI = true) {
             await instance.connect();
         }
     }
+    return { deprecationNotices };
 }
 exports.startAll = startAll;
 async function exportEmulatorData(exportPath, options) {

package/lib/emulator/downloadableEmulators.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.start = exports.downloadIfNecessary = exports.stop = exports.getPID = exports.get = exports.getDownloadDetails = exports.handleEmulatorProcessError = exports._getCommand = exports.getLogFileName = exports.DownloadDetails = void 0;
+exports.start = exports.downloadIfNecessary = exports.stop = exports.getPID = exports.get = exports.getDownloadDetails = exports.requiresJava = exports.handleEmulatorProcessError = exports._getCommand = exports.getLogFileName = exports.DownloadDetails = void 0;
 const types_1 = require("./types");
 const constants_1 = require("./constants");
 const error_1 = require("../error");
@@ -29,13 +29,13 @@ exports.DownloadDetails = {
         },
     },
     firestore: {
-        downloadPath: path.join(CACHE_DIR, "cloud-firestore-emulator-v1.13.1.jar"),
-        version: "1.13.1",
+        downloadPath: path.join(CACHE_DIR, "cloud-firestore-emulator-v1.14.3.jar"),
+        version: "1.14.3",
         opts: {
             cacheDir: CACHE_DIR,
-            remoteUrl: "https://storage.googleapis.com/firebase-preview-drop/emulator/cloud-firestore-emulator-v1.13.1.jar",
-            expectedSize: 60486708,
-            expectedChecksum: "e0590880408eacb790874643147c0081",
+            remoteUrl: "https://storage.googleapis.com/firebase-preview-drop/emulator/cloud-firestore-emulator-v1.14.3.jar",
+            expectedSize: 60442855,
+            expectedChecksum: "63517534875818689639ee5dee57dd52",
             namePrefix: "cloud-firestore-emulator",
         },
     },
@@ -50,15 +50,15 @@ exports.DownloadDetails = {
             namePrefix: "cloud-storage-rules-emulator",
         },
     },
-    ui: previews_1.previews.emulatoruisnapshot
+    ui: previews_1.previews.extensionsemulator
         ? {
-            version: "SNAPSHOT",
-            downloadPath: path.join(CACHE_DIR, "ui-vSNAPSHOT.zip"),
-            unzipDir: path.join(CACHE_DIR, "ui-vSNAPSHOT"),
-            binaryPath: path.join(CACHE_DIR, "ui-vSNAPSHOT", "server.bundle.js"),
+            version: "EXTENSIONS",
+            downloadPath: path.join(CACHE_DIR, "ui-vEXTENSIONS.zip"),
+            unzipDir: path.join(CACHE_DIR, "ui-vEXTENSIONS"),
+            binaryPath: path.join(CACHE_DIR, "ui-vEXTENSIONS", "server.bundle.js"),
             opts: {
                 cacheDir: CACHE_DIR,
-                remoteUrl: "https://storage.googleapis.com/firebase-preview-drop/emulator/ui-vSNAPSHOT.zip",
+                remoteUrl: "https://storage.googleapis.com/firebase-preview-drop/emulator/ui-vEXTENSIONS.zip",
                 expectedSize: -1,
                 expectedChecksum: "",
                 skipCache: true,
@@ -66,19 +66,35 @@ exports.DownloadDetails = {
                 namePrefix: "ui",
             },
         }
-        : {
-            version: "1.6.5",
-            downloadPath: path.join(CACHE_DIR, "ui-v1.6.5.zip"),
-            unzipDir: path.join(CACHE_DIR, "ui-v1.6.5"),
-            binaryPath: path.join(CACHE_DIR, "ui-v1.6.5", "server.bundle.js"),
-            opts: {
-                cacheDir: CACHE_DIR,
-                remoteUrl: "https://storage.googleapis.com/firebase-preview-drop/emulator/ui-v1.6.5.zip",
-                expectedSize: 3816994,
-                expectedChecksum: "92dfff4b2ef8ab616e8a60cc93e0a00b",
-                namePrefix: "ui",
+        : previews_1.previews.emulatoruisnapshot
+            ? {
+                version: "SNAPSHOT",
+                downloadPath: path.join(CACHE_DIR, "ui-vSNAPSHOT.zip"),
+                unzipDir: path.join(CACHE_DIR, "ui-vSNAPSHOT"),
+                binaryPath: path.join(CACHE_DIR, "ui-vSNAPSHOT", "server.bundle.js"),
+                opts: {
+                    cacheDir: CACHE_DIR,
+                    remoteUrl: "https://storage.googleapis.com/firebase-preview-drop/emulator/ui-vSNAPSHOT.zip",
+                    expectedSize: -1,
+                    expectedChecksum: "",
+                    skipCache: true,
+                    skipChecksumAndSize: true,
+                    namePrefix: "ui",
+                },
+            }
+            : {
+                version: "1.6.5",
+                downloadPath: path.join(CACHE_DIR, "ui-v1.6.5.zip"),
+                unzipDir: path.join(CACHE_DIR, "ui-v1.6.5"),
+                binaryPath: path.join(CACHE_DIR, "ui-v1.6.5", "server.bundle.js"),
+                opts: {
+                    cacheDir: CACHE_DIR,
+                    remoteUrl: "https://storage.googleapis.com/firebase-preview-drop/emulator/ui-v1.6.5.zip",
+                    expectedSize: 3816994,
+                    expectedChecksum: "92dfff4b2ef8ab616e8a60cc93e0a00b",
+                    namePrefix: "ui",
+                },
             },
-        },
     pubsub: {
         downloadPath: path.join(CACHE_DIR, "pubsub-emulator-0.1.0.zip"),
         version: "0.1.0",
@@ -236,6 +252,13 @@ async function handleEmulatorProcessError(emulator, err) {
     }
 }
 exports.handleEmulatorProcessError = handleEmulatorProcessError;
+function requiresJava(emulator) {
+    if (emulator in Commands) {
+        return Commands[emulator].binary === "java";
+    }
+    return false;
+}
+exports.requiresJava = requiresJava;
 async function _runBinary(emulator, command, extraEnv) {
     return new Promise((resolve) => {
         var _a, _b;

package/lib/emulator/extensions/postinstall.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.replaceConsoleLinks = void 0;
+const registry_1 = require("../registry");
+const types_1 = require("../types");
+function replaceConsoleLinks(postinstall) {
+    const uiInfo = registry_1.EmulatorRegistry.getInfo(types_1.Emulators.UI);
+    const uiUrl = uiInfo ? `http://${registry_1.EmulatorRegistry.getInfoHostString(uiInfo)}` : "unknown";
+    let subbedPostinstall = postinstall;
+    const linkReplacements = new Map([
+        [
+            /(http[s]?:\/\/)?console\.firebase\.google\.com\/(u\/[0-9]\/)?project\/[A-Za-z0-9-]+\/storage[A-Za-z0-9\/-]*(?=[\)\]\s])/,
+            `${uiUrl}/${types_1.Emulators.STORAGE}`,
+        ],
+        [
+            /(http[s]?:\/\/)?console\.firebase\.google\.com\/(u\/[0-9]\/)?project\/[A-Za-z0-9-]+\/firestore[A-Za-z0-9\/-]*(?=[\)\]\s])/,
+            `${uiUrl}/${types_1.Emulators.FIRESTORE}`,
+        ],
+        [
+            /(http[s]?:\/\/)?console\.firebase\.google\.com\/(u\/[0-9]\/)?project\/[A-Za-z0-9-]+\/database[A-Za-z0-9\/-]*(?=[\)\]\s])/,
+            `${uiUrl}/${types_1.Emulators.DATABASE}`,
+        ],
+        [
+            /(http[s]?:\/\/)?console\.firebase\.google\.com\/(u\/[0-9]\/)?project\/[A-Za-z0-9-]+\/authentication[A-Za-z0-9\/-]*(?=[\)\]\s])/,
+            `${uiUrl}/${types_1.Emulators.AUTH}`,
+        ],
+        [
+            /(http[s]?:\/\/)?console\.firebase\.google\.com\/(u\/[0-9]\/)?project\/[A-Za-z0-9-]+\/functions[A-Za-z0-9\/-]*(?=[\)\]\s])/,
+            `${uiUrl}/logs`,
+        ],
+        [
+            /(http[s]?:\/\/)?console\.firebase\.google\.com\/(u\/[0-9]\/)?project\/[A-Za-z0-9-]+\/extensions[A-Za-z0-9\/-]*(?=[\)\]\s])/,
+            `${uiUrl}/${types_1.Emulators.EXTENSIONS}`,
+        ],
+    ]);
+    for (const [consoleLinkRegex, replacement] of linkReplacements) {
+        subbedPostinstall = subbedPostinstall.replace(consoleLinkRegex, replacement);
+    }
+    return subbedPostinstall;
+}
+exports.replaceConsoleLinks = replaceConsoleLinks;

package/lib/emulator/extensions/validation.js

@@ -17,8 +17,8 @@ async function getUnemulatedAPIs(projectId, instances) {
     var _a;
     const unemulatedAPIs = {};
     for (const i of instances) {
-        const extensionVersion = await planner.getExtensionVersion(i);
-        for (const api of (_a = extensionVersion.spec.apis) !== null && _a !== void 0 ? _a : []) {
+        const extensionSpec = await planner.getExtensionSpec(i);
+        for (const api of (_a = extensionSpec.apis) !== null && _a !== void 0 ? _a : []) {
             if (!EMULATED_APIS.includes(api.apiName)) {
                 if (unemulatedAPIs[api.apiName]) {
                     unemulatedAPIs[api.apiName].instanceIds.push(i.instanceId);

package/lib/emulator/extensionsEmulator.js

@@ -18,13 +18,37 @@ const validation_1 = require("./extensions/validation");
 const ensureApiEnabled_1 = require("../ensureApiEnabled");
 const shortenUrl_1 = require("../shortenUrl");
 const constants_1 = require("./constants");
+const registry_1 = require("./registry");
 class ExtensionsEmulator {
     constructor(args) {
         this.want = [];
+        this.backends = [];
         this.logger = emulatorLogger_1.EmulatorLogger.forEmulator(types_1.Emulators.EXTENSIONS);
         this.pendingDownloads = new Map();
         this.args = args;
     }
+    start() {
+        this.logger.logLabeled("DEBUG", "Extensions", "Started Extensions emulator, this is a noop.");
+        return Promise.resolve();
+    }
+    stop() {
+        this.logger.logLabeled("DEBUG", "Extensions", "Stopping Extensions emulator, this is a noop.");
+        return Promise.resolve();
+    }
+    connect() {
+        this.logger.logLabeled("DEBUG", "Extensions", "Connecting Extensions emulator, this is a noop.");
+        return Promise.resolve();
+    }
+    getInfo() {
+        const info = registry_1.EmulatorRegistry.getInfo(types_1.Emulators.FUNCTIONS);
+        if (!info) {
+            throw new error_1.FirebaseError("Extensions Emulator is running but Functions emulator is not. This should never happen.");
+        }
+        return info;
+    }
+    getName() {
+        return types_1.Emulators.EXTENSIONS;
+    }
     async readManifest() {
         var _a;
         this.want = await planner.want({
@@ -37,22 +61,30 @@ class ExtensionsEmulator {
         });
     }
     async ensureSourceCode(instance) {
-        if (!instance.ref) {
-            throw new error_1.FirebaseError(`No ref found for ${instance.instanceId}. Emulating local extensions is not yet supported.`);
+        if (instance.localPath) {
+            if (!this.hasValidSource({ path: instance.localPath, extTarget: instance.localPath })) {
+                throw new error_1.FirebaseError(`Tried to emulate local extension at ${instance.localPath}, but it was missing required files.`);
+            }
+            return instance.localPath;
         }
-        const ref = (0, refs_1.toExtensionVersionRef)(instance.ref);
-        const cacheDir = process.env.FIREBASE_EXTENSIONS_CACHE_PATH ||
-            path.join(os.homedir(), ".cache", "firebase", "extensions");
-        const sourceCodePath = path.join(cacheDir, ref);
-        if (this.pendingDownloads.get(ref)) {
-            await this.pendingDownloads.get(ref);
+        else if (instance.ref) {
+            const ref = (0, refs_1.toExtensionVersionRef)(instance.ref);
+            const cacheDir = process.env.FIREBASE_EXTENSIONS_CACHE_PATH ||
+                path.join(os.homedir(), ".cache", "firebase", "extensions");
+            const sourceCodePath = path.join(cacheDir, ref);
+            if (this.pendingDownloads.get(ref)) {
+                await this.pendingDownloads.get(ref);
+            }
+            if (!this.hasValidSource({ path: sourceCodePath, extTarget: ref })) {
+                const promise = this.downloadSource(instance, ref, sourceCodePath);
+                this.pendingDownloads.set(ref, promise);
+                await promise;
+            }
+            return sourceCodePath;
         }
-        if (!this.hasValidSource({ path: sourceCodePath, extRef: ref })) {
-            const promise = this.downloadSource(instance, ref, sourceCodePath);
-            this.pendingDownloads.set(ref, promise);
-            await promise;
+        else {
+            throw new error_1.FirebaseError("Tried to emulate an extension instance without a ref or localPath. This should never happen.");
         }
-        return sourceCodePath;
     }
     async downloadSource(instance, ref, sourceCodePath) {
         const extensionVersion = await planner.getExtensionVersion(instance);
@@ -71,7 +103,7 @@ class ExtensionsEmulator {
         for (const requiredFile of requiredFiles) {
             const f = path.join(args.path, requiredFile);
             if (!fs.existsSync(f)) {
-                emulatorLogger_1.EmulatorLogger.forExtension({ ref: args.extRef }).logLabeled("BULLET", "extensions", `Detected invalid source code for ${args.extRef}, expected to find ${f}`);
+                emulatorLogger_1.EmulatorLogger.forExtension({ ref: args.extTarget }).logLabeled("BULLET", "extensions", `Detected invalid source code for ${args.extTarget}, expected to find ${f}`);
                 return false;
             }
         }
@@ -92,27 +124,32 @@ class ExtensionsEmulator {
     async getExtensionBackends() {
         await this.readManifest();
         await this.checkAndWarnAPIs(this.want);
-        return Promise.all(this.want.map((i) => {
+        this.backends = await Promise.all(this.want.map((i) => {
             return this.toEmulatableBackend(i);
         }));
+        return this.backends;
     }
     async toEmulatableBackend(instance) {
         const extensionDir = await this.ensureSourceCode(instance);
         const functionsDir = path.join(extensionDir, "functions");
         const env = Object.assign(this.autoPopulatedParams(instance), instance.params);
-        const { extensionTriggers, nodeMajorVersion, nonSecretEnv, secretEnvVariables } = await (0, optionsHelper_1.getExtensionFunctionInfo)(extensionDir, instance.instanceId, env);
-        const extension = await planner.getExtension(instance);
-        const extensionVersion = await planner.getExtensionVersion(instance);
-        return {
+        const { extensionTriggers, nodeMajorVersion, nonSecretEnv, secretEnvVariables } = await (0, optionsHelper_1.getExtensionFunctionInfo)(instance, env);
+        const emulatableBackend = {
             functionsDir,
             env: nonSecretEnv,
             secretEnv: secretEnvVariables,
             predefinedTriggers: extensionTriggers,
             nodeMajorVersion: nodeMajorVersion,
             extensionInstanceId: instance.instanceId,
-            extension,
-            extensionVersion,
         };
+        if (instance.ref) {
+            emulatableBackend.extension = await planner.getExtension(instance);
+            emulatableBackend.extensionVersion = await planner.getExtensionVersion(instance);
+        }
+        else if (instance.localPath) {
+            emulatableBackend.extensionSpec = await planner.getExtensionSpec(instance);
+        }
+        return emulatableBackend;
     }
     autoPopulatedParams(instance) {
         const projectId = this.args.projectId;
@@ -174,5 +211,32 @@ class ExtensionsEmulator {
         }
         return filteredBackends;
     }
+    extensionDetailsUILink(backend) {
+        const uiInfo = registry_1.EmulatorRegistry.getInfo(types_1.Emulators.UI);
+        if (!uiInfo || !backend.extensionInstanceId) {
+            return "";
+        }
+        const uiUrl = registry_1.EmulatorRegistry.getInfoHostString(uiInfo);
+        return clc.underline(clc.bold(`http://${uiUrl}/${types_1.Emulators.EXTENSIONS}/${backend.extensionInstanceId}`));
+    }
+    extensionsInfoTable(options) {
+        var _a;
+        const filtedBackends = this.filterUnemulatedTriggers(options, this.backends);
+        const uiRunning = registry_1.EmulatorRegistry.isRunning(types_1.Emulators.UI);
+        const tableHead = ["Extension Instance Name", "Extension Ref"];
+        if (uiRunning) {
+            tableHead.push("View in Emulator UI");
+        }
+        const table = new Table({ head: tableHead, style: { head: ["yellow"] } });
+        for (const b of filtedBackends) {
+            if (b.extensionInstanceId) {
+                const tableEntry = [b.extensionInstanceId, ((_a = b.extensionVersion) === null || _a === void 0 ? void 0 : _a.ref) || "Local Extension"];
+                if (uiRunning)
+                    tableEntry.push(this.extensionDetailsUILink(b));
+                table.push(tableEntry);
+            }
+        }
+        return table.toString();
+    }
 }
 exports.ExtensionsEmulator = ExtensionsEmulator;

package/lib/emulator/functionsEmulator.js

@@ -13,7 +13,7 @@ const url_1 = require("url");
 const events_1 = require("events");
 const api = require("../api");
 const logger_1 = require("../logger");
-const track = require("../track");
+const track_1 = require("../track");
 const constants_1 = require("./constants");
 const types_1 = require("./types");
 const chokidar = require("chokidar");
@@ -34,6 +34,7 @@ const secretManager_1 = require("../gcp/secretManager");
 const runtimes = require("../deploy/functions/runtimes");
 const backend = require("../deploy/functions/backend");
 const functionsEnv = require("../functions/env");
+const v1_1 = require("../functions/events/v1");
 const EVENT_INVOKE = "functions:invoke";
 const DATABASE_PATH_PATTERN = new RegExp("^projects/[^/]+/instances/([^/]+)/refs(/.*)$");
 class FunctionsEmulator {
@@ -54,6 +55,16 @@ class FunctionsEmulator {
             : types_1.FunctionsExecutionMode.AUTO;
         this.workerPool = new functionsRuntimeWorker_1.RuntimeWorkerPool(mode);
         this.workQueue = new workQueue_1.WorkQueue(mode);
+        this.blockingFunctionsConfig = {
+            triggers: {
+                beforeCreate: {
+                    functionUri: "",
+                },
+                beforeSignIn: {
+                    functionUri: "",
+                },
+            },
+        };
     }
     static getHttpFunctionUrl(host, port, projectId, name, region) {
         return `http://${host}:${port}/${projectId}/${region}/${name}`;
@@ -229,6 +240,7 @@ class FunctionsEmulator {
             loadTriggerPromises.push(this.loadTriggers(backend, true));
         }
         await Promise.all(loadTriggerPromises);
+        await this.performPostLoadOperations();
         return;
     }
     async stop() {
@@ -271,6 +283,7 @@ class FunctionsEmulator {
             logger_1.logger.debug(`Analyzing ${runtimeDelegate.name} backend spec`);
             const discoveredBackend = await runtimeDelegate.discoverSpec(runtimeConfig, Object.assign(Object.assign(Object.assign(Object.assign({}, this.getSystemEnvs()), this.getEmulatorEnvs()), { FIREBASE_CONFIG: this.getFirebaseConfig() }), emulatableBackend.env));
             const endpoints = backend.allEndpoints(discoveredBackend);
+            (0, functionsEmulatorShared_1.prepareEndpoints)(endpoints);
             triggerDefinitions = (0, functionsEmulatorShared_1.emulatedFunctionsFromEndpoints)(endpoints);
         }
         const toSetup = triggerDefinitions.filter((definition) => {
@@ -327,6 +340,11 @@ class FunctionsEmulator {
                         break;
                 }
             }
+            else if (definition.blockingTrigger) {
+                const { host, port } = this.getInfo();
+                url = FunctionsEmulator.getHttpFunctionUrl(host, port, this.args.projectId, definition.name, definition.region);
+                added = this.addBlockingTrigger(url, definition.blockingTrigger);
+            }
             else {
                 this.logger.log("WARN", `Unsupported function type on ${definition.name}. Expected either httpsTrigger or eventTrigger.`);
             }
@@ -350,6 +368,34 @@ class FunctionsEmulator {
             this.startRuntime(emulatableBackend, { nodeBinary: emulatableBackend.nodeBinary });
         }
     }
+    async performPostLoadOperations() {
+        var _a, _b, _c, _d;
+        if (((_b = (_a = this.blockingFunctionsConfig.triggers) === null || _a === void 0 ? void 0 : _a.beforeCreate) === null || _b === void 0 ? void 0 : _b.functionUri) === "" &&
+            ((_d = (_c = this.blockingFunctionsConfig.triggers) === null || _c === void 0 ? void 0 : _c.beforeSignIn) === null || _d === void 0 ? void 0 : _d.functionUri) === "") {
+            return;
+        }
+        const authEmu = registry_1.EmulatorRegistry.get(types_1.Emulators.AUTH);
+        if (!authEmu) {
+            return;
+        }
+        const path = `/identitytoolkit.googleapis.com/v2/projects/${this.getProjectId()}/config?updateMask=blockingFunctions`;
+        try {
+            await api.request("PATCH", path, {
+                origin: `http://${registry_1.EmulatorRegistry.getInfoHostString(authEmu.getInfo())}`,
+                headers: {
+                    Authorization: "Bearer owner",
+                },
+                data: {
+                    blockingFunctions: this.blockingFunctionsConfig,
+                },
+                json: true,
+            });
+        }
+        catch (err) {
+            this.logger.log("WARN", "Error updating blocking functions config to the auth emulator: " + err);
+            throw err;
+        }
+    }
     addRealtimeDatabaseTrigger(projectId, key, eventTrigger) {
         const databaseEmu = registry_1.EmulatorRegistry.get(types_1.Emulators.DATABASE);
         if (!databaseEmu) {
@@ -416,11 +462,10 @@ class FunctionsEmulator {
         });
     }
     async addPubsubTrigger(triggerName, key, eventTrigger, signatureType, schedule) {
-        const pubsubPort = registry_1.EmulatorRegistry.getPort(types_1.Emulators.PUBSUB);
-        if (!pubsubPort) {
+        const pubsubEmulator = registry_1.EmulatorRegistry.get(types_1.Emulators.PUBSUB);
+        if (!pubsubEmulator) {
             return false;
         }
-        const pubsubEmulator = registry_1.EmulatorRegistry.get(types_1.Emulators.PUBSUB);
         logger_1.logger.debug(`addPubsubTrigger`, JSON.stringify({ eventTrigger }));
         const resource = eventTrigger.resource;
         let topic;
@@ -458,6 +503,31 @@ class FunctionsEmulator {
         this.multicastTriggers[eventTriggerId] = triggers;
         return true;
     }
+    addBlockingTrigger(url, blockingTrigger) {
+        logger_1.logger.debug(`addBlockingTrigger`, JSON.stringify({ blockingTrigger }));
+        const eventType = blockingTrigger.eventType;
+        if (v1_1.AUTH_BLOCKING_EVENTS.includes(eventType)) {
+            if (blockingTrigger.eventType === v1_1.BEFORE_CREATE_EVENT) {
+                this.blockingFunctionsConfig.triggers = Object.assign(Object.assign({}, this.blockingFunctionsConfig.triggers), { beforeCreate: {
+                        functionUri: url,
+                    } });
+            }
+            else {
+                this.blockingFunctionsConfig.triggers = Object.assign(Object.assign({}, this.blockingFunctionsConfig.triggers), { beforeSignIn: {
+                        functionUri: url,
+                    } });
+            }
+            this.blockingFunctionsConfig.forwardInboundCredentials = {
+                accessToken: blockingTrigger.options.accessToken,
+                idToken: blockingTrigger.options.idToken,
+                refreshToken: blockingTrigger.options.refreshToken,
+            };
+        }
+        else {
+            return false;
+        }
+        return true;
+    }
     getProjectId() {
         return this.args.projectId;
     }
@@ -781,7 +851,9 @@ class FunctionsEmulator {
         for (const backend of this.args.emulatableBackends) {
             loadTriggerPromises.push(this.loadTriggers(backend));
         }
-        return Promise.all(loadTriggerPromises);
+        await Promise.all(loadTriggerPromises);
+        await this.performPostLoadOperations();
+        return;
     }
     async handleBackgroundTrigger(projectId, triggerKey, proto) {
         const record = this.getTriggerRecordByKey(triggerKey);
@@ -809,7 +881,7 @@ class FunctionsEmulator {
                     reject({ code: 500, body: el.text });
                 }
             });
-            void track(EVENT_INVOKE, (0, functionsEmulatorShared_1.getFunctionService)(trigger));
+            void (0, track_1.track)(EVENT_INVOKE, (0, functionsEmulatorShared_1.getFunctionService)(trigger));
             worker.waitForDone().then(() => {
                 resolve({ status: "acknowledged" });
             });
@@ -884,7 +956,7 @@ class FunctionsEmulator {
             }
         });
         await worker.waitForSocketReady();
-        void track(EVENT_INVOKE, "https");
+        void (0, track_1.track)(EVENT_INVOKE, "https");
         this.logger.log("DEBUG", `[functions] Runtime ready! Sending request!`);
         if (!worker.lastArgs) {
             throw new error_1.FirebaseError("Cannot execute on a worker with no arguments");