firebase-tools 10.4.0 → 10.5.0

package/lib/deploy/functions/prepareFunctionsUpload.js

@@ -48,15 +48,14 @@ async function pipeAsync(from, to) {
         from.pipe(to);
     });
 }
-async function packageSource(options, sourceDir, configValues) {
-    var _a;
+async function packageSource(sourceDir, config, runtimeConfig) {
     const tmpFile = tmp.fileSync({ prefix: "firebase-functions-", postfix: ".zip" }).name;
     const fileStream = fs.createWriteStream(tmpFile, {
         flags: "w",
         encoding: "binary",
     });
     const archive = archiver("zip");
-    const ignore = ((_a = options.config.src.functions) === null || _a === void 0 ? void 0 : _a.ignore) || ["node_modules", ".git"];
+    const ignore = config.ignore || ["node_modules", ".git"];
     ignore.push("firebase-debug.log", "firebase-debug.*.log", CONFIG_DEST_FILE);
     try {
         const files = await fsAsync.readdirRecursive({ path: sourceDir, ignore: ignore });
@@ -66,8 +65,8 @@ async function packageSource(options, sourceDir, configValues) {
                 mode: file.mode,
             });
         });
-        if (typeof configValues !== "undefined") {
-            archive.append(JSON.stringify(configValues, null, 2), {
+        if (typeof runtimeConfig !== "undefined") {
+            archive.append(JSON.stringify(runtimeConfig, null, 2), {
                 name: CONFIG_DEST_FILE,
                 mode: 420,
             });
@@ -81,20 +80,15 @@ async function packageSource(options, sourceDir, configValues) {
             exit: 1,
         });
     }
-    utils.assertDefined(options.config.src.functions);
-    utils.assertDefined(options.config.src.functions.source, "Error: 'functions.source' is not defined");
     utils.logBullet(clc.cyan.bold("functions:") +
         " packaged " +
-        clc.bold(options.config.src.functions.source) +
+        clc.bold(sourceDir) +
         " (" +
         filesize(archive.pointer()) +
         ") for uploading");
     return tmpFile;
 }
-async function prepareFunctionsUpload(runtimeConfig, options) {
-    utils.assertDefined(options.config.src.functions);
-    utils.assertDefined(options.config.src.functions.source, "Error: 'functions.source' is not defined");
-    const sourceDir = options.config.path(options.config.src.functions.source);
-    return packageSource(options, sourceDir, runtimeConfig);
+async function prepareFunctionsUpload(sourceDir, config, runtimeConfig) {
+    return packageSource(sourceDir, config, runtimeConfig);
 }
 exports.prepareFunctionsUpload = prepareFunctionsUpload;

package/lib/deploy/functions/release/fabricator.js

@@ -180,6 +180,13 @@ class Fabricator {
                     .catch(rethrowAs(endpoint, "set invoker"));
             }
         }
+        else if (backend.isCallableTriggered(endpoint)) {
+            await this.executor
+                .run(async () => {
+                await gcf.setInvokerCreate(endpoint.project, backend.functionName(endpoint), ["public"]);
+            })
+                .catch(rethrowAs(endpoint, "set invoker"));
+        }
         else if (backend.isTaskQueueTriggered(endpoint)) {
             const invoker = endpoint.taskQueueTrigger.invoker;
             if (invoker && !invoker.includes("private")) {
@@ -232,12 +239,17 @@ class Fabricator {
                     .catch(rethrowAs(endpoint, "set invoker"));
             }
         }
+        else if (backend.isCallableTriggered(endpoint)) {
+            await this.executor
+                .run(() => run.setInvokerCreate(endpoint.project, serviceName, ["public"]))
+                .catch(rethrowAs(endpoint, "set invoker"));
+        }
         else if (backend.isTaskQueueTriggered(endpoint)) {
             const invoker = endpoint.taskQueueTrigger.invoker;
             if (invoker && !invoker.includes("private")) {
                 await this.executor
                     .run(async () => {
-                    await gcf.setInvokerCreate(endpoint.project, backend.functionName(endpoint), invoker);
+                    await run.setInvokerCreate(endpoint.project, serviceName, invoker);
                 })
                     .catch(rethrowAs(endpoint, "set invoker"));
             }

package/lib/deploy/functions/release/index.js

@@ -15,7 +15,7 @@ const functionsConfig_1 = require("../../../functionsConfig");
 const functionsDeployHelper_1 = require("../functionsDeployHelper");
 const error_1 = require("../../../error");
 async function release(context, options, payload) {
-    if (!options.config.has("functions")) {
+    if (!context.config) {
         return;
     }
     const plan = planner.createDeploymentPlan(payload.functions.backend, await backend.existingBackend(context), { filters: context.filters });

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

@@ -1,23 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ensureFirebaseAlertsTriggerRegion = exports.obtainFirebaseAlertsBindings = exports.SERVICE_ACCOUNT_TOKEN_CREATOR_ROLE = void 0;
+exports.ensureFirebaseAlertsTriggerRegion = void 0;
 const error_1 = require("../../../error");
-exports.SERVICE_ACCOUNT_TOKEN_CREATOR_ROLE = "roles/iam.serviceAccountTokenCreator";
-function obtainFirebaseAlertsBindings(projectNumber, existingPolicy) {
-    const pubsubServiceAgent = `serviceAccount:service-${projectNumber}@gcp-sa-pubsub.iam.gserviceaccount.com`;
-    let pubsubBinding = existingPolicy.bindings.find((b) => b.role === exports.SERVICE_ACCOUNT_TOKEN_CREATOR_ROLE);
-    if (!pubsubBinding) {
-        pubsubBinding = {
-            role: exports.SERVICE_ACCOUNT_TOKEN_CREATOR_ROLE,
-            members: [],
-        };
-    }
-    if (!pubsubBinding.members.find((m) => m === pubsubServiceAgent)) {
-        pubsubBinding.members.push(pubsubServiceAgent);
-    }
-    return Promise.resolve([pubsubBinding]);
-}
-exports.obtainFirebaseAlertsBindings = obtainFirebaseAlertsBindings;
 function ensureFirebaseAlertsTriggerRegion(endpoint) {
     if (!endpoint.eventTrigger.region) {
         endpoint.eventTrigger.region = "global";

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

@@ -5,6 +5,7 @@ const backend = require("../backend");
 const storage_1 = require("./storage");
 const firebaseAlerts_1 = require("./firebaseAlerts");
 const noop = () => Promise.resolve();
+const noopProjectBindings = () => Promise.resolve([]);
 exports.NoOpService = {
     name: "noop",
     api: "",
@@ -26,7 +27,7 @@ exports.StorageService = {
 exports.FirebaseAlertsService = {
     name: "firebasealerts",
     api: "logging.googleapis.com",
-    requiredProjectBindings: firebaseAlerts_1.obtainFirebaseAlertsBindings,
+    requiredProjectBindings: noopProjectBindings,
     ensureTriggerRegion: firebaseAlerts_1.ensureFirebaseAlertsTriggerRegion,
 };
 exports.EVENT_SERVICE_MAPPING = {

package/lib/deploy/hosting/deploy.js

@@ -41,12 +41,22 @@ async function deploy(context, options) {
         const publicDir = options.config.path(deploy.config.public);
         const files = (0, listFiles_1.listFiles)(publicDir, deploy.config.ignore);
         (0, utils_1.logLabeledBullet)(`hosting[${deploy.site}]`, `found ${files.length} files in ${clc.bold(deploy.config.public)}`);
+        let concurrency = 200;
+        const envConcurrency = (0, utils_1.envOverride)("FIREBASE_HOSTING_UPLOAD_CONCURRENCY", "");
+        if (envConcurrency) {
+            const c = parseInt(envConcurrency, 10);
+            if (!isNaN(c) && c > 0) {
+                concurrency = c;
+            }
+        }
+        logger_1.logger.debug(`[hosting] uploading with ${concurrency} concurrency`);
         const uploader = new uploader_1.Uploader({
             version: deploy.version,
             files: files,
             public: publicDir,
             cwd: options.cwd,
             projectRoot: (0, detectProjectRoot_1.detectProjectRoot)(options),
+            uploadConcurrency: concurrency,
         });
         const progressInterval = setInterval(() => updateSpinner(uploader.statusMessage(), debugging), debugging ? 2000 : 200);
         try {

package/lib/emulator/auth/operations.js

@@ -39,6 +39,7 @@ exports.authOperations = {
         projects: {
             createSessionCookie,
             queryAccounts,
+            updateConfig,
             accounts: {
                 _: signUp,
                 delete: deleteAccount,
@@ -1236,28 +1237,17 @@ function getEmulatorProjectConfig(state) {
         usageMode: state.usageMode,
     };
 }
-function updateEmulatorProjectConfig(state, reqBody) {
+function updateEmulatorProjectConfig(state, reqBody, ctx) {
     var _a;
-    const allowDuplicateEmails = (_a = reqBody.signIn) === null || _a === void 0 ? void 0 : _a.allowDuplicateEmails;
-    if (allowDuplicateEmails != null) {
-        (0, errors_1.assert)(state instanceof state_1.AgentProjectState, "((Only top level projects can set oneAccountPerEmail.))");
-        state.oneAccountPerEmail = !allowDuplicateEmails;
-    }
-    const usageMode = reqBody.usageMode;
-    if (usageMode != null) {
-        (0, errors_1.assert)(state instanceof state_1.AgentProjectState, "((Only top level projects can set usageMode.))");
-        switch (usageMode) {
-            case "PASSTHROUGH":
-                (0, errors_1.assert)(state.getUserCount() === 0, "Users are present, unable to set passthrough mode");
-                state.usageMode = state_1.UsageMode.PASSTHROUGH;
-                break;
-            case "DEFAULT":
-                state.usageMode = state_1.UsageMode.DEFAULT;
-                break;
-            default:
-                throw new errors_1.BadRequestError("Invalid usage mode provided");
-        }
+    const updateMask = [];
+    if (((_a = reqBody.signIn) === null || _a === void 0 ? void 0 : _a.allowDuplicateEmails) != null) {
+        updateMask.push("signIn.allowDuplicateEmails");
+    }
+    if (reqBody.usageMode) {
+        updateMask.push("usageMode");
     }
+    ctx.params.query.updateMask = updateMask.join();
+    updateConfig(state, reqBody, ctx);
     return getEmulatorProjectConfig(state);
 }
 function listOobCodesInProject(state) {
@@ -1390,6 +1380,17 @@ function mfaSignInFinalize(state, reqBody) {
         refreshToken,
     };
 }
+function updateConfig(state, reqBody, ctx) {
+    var _a;
+    (0, errors_1.assert)(state instanceof state_1.AgentProjectState, "((Can only update top-level configurations on agent projects.))");
+    for (const event in (_a = reqBody.blockingFunctions) === null || _a === void 0 ? void 0 : _a.triggers) {
+        if (Object.prototype.hasOwnProperty.call(reqBody.blockingFunctions.triggers, event)) {
+            (0, errors_1.assert)(Object.values(state_1.BlockingFunctionEvents).includes(event), "INVALID_BLOCKING_FUNCTION: ((Event type is invalid.))");
+            (0, errors_1.assert)((0, utils_1.parseAbsoluteUri)(reqBody.blockingFunctions.triggers[event].functionUri), "INVALID_BLOCKING_FUNCTION: ((Expected an absolute URI with valid scheme and host.))");
+        }
+    }
+    return state.updateConfig(reqBody, ctx.params.query.updateMask);
+}
 function coercePrimitiveToString(value) {
     switch (typeof value) {
         case "string":

package/lib/emulator/auth/state.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UsageMode = exports.TenantProjectState = exports.AgentProjectState = exports.ProjectState = exports.SIGNIN_METHOD_EMAIL_LINK = exports.PROVIDER_GAME_CENTER = exports.PROVIDER_CUSTOM = exports.PROVIDER_ANONYMOUS = exports.PROVIDER_PHONE = exports.PROVIDER_PASSWORD = void 0;
+exports.BlockingFunctionEvents = exports.UsageMode = exports.TenantProjectState = exports.AgentProjectState = exports.ProjectState = exports.SIGNIN_METHOD_EMAIL_LINK = exports.PROVIDER_GAME_CENTER = exports.PROVIDER_CUSTOM = exports.PROVIDER_ANONYMOUS = exports.PROVIDER_PHONE = exports.PROVIDER_PASSWORD = void 0;
 const utils_1 = require("./utils");
 const cloudFunctions_1 = require("./cloudFunctions");
 const errors_1 = require("./errors");
@@ -422,25 +422,28 @@ exports.ProjectState = ProjectState;
 class AgentProjectState extends ProjectState {
     constructor(projectId) {
         super(projectId);
-        this._oneAccountPerEmail = true;
-        this._usageMode = UsageMode.DEFAULT;
         this.tenantProjectForTenantId = new Map();
         this._authCloudFunction = new cloudFunctions_1.AuthCloudFunction(this.projectId);
+        this._config = {
+            signIn: { allowDuplicateEmails: false },
+            usageMode: UsageMode.DEFAULT,
+            blockingFunctions: {},
+        };
     }
     get authCloudFunction() {
         return this._authCloudFunction;
     }
     get oneAccountPerEmail() {
-        return this._oneAccountPerEmail;
+        return !this._config.signIn.allowDuplicateEmails;
     }
     set oneAccountPerEmail(oneAccountPerEmail) {
-        this._oneAccountPerEmail = oneAccountPerEmail;
+        this._config.signIn.allowDuplicateEmails = !oneAccountPerEmail;
     }
     get usageMode() {
-        return this._usageMode;
+        return this._config.usageMode;
     }
     set usageMode(usageMode) {
-        this._usageMode = usageMode;
+        this._config.usageMode = usageMode;
     }
     get allowPasswordSignup() {
         return true;
@@ -457,6 +460,31 @@ class AgentProjectState extends ProjectState {
     get enableEmailLinkSignin() {
         return true;
     }
+    get config() {
+        return this._config;
+    }
+    get blockingFunctionsConfig() {
+        return this._config.blockingFunctions;
+    }
+    set blockingFunctionsConfig(blockingFunctions) {
+        this._config.blockingFunctions = blockingFunctions;
+    }
+    updateConfig(update, updateMask) {
+        var _a, _b, _c, _d;
+        if (update.usageMode) {
+            (0, errors_1.assert)(update.usageMode !== UsageMode.USAGE_MODE_UNSPECIFIED, "INVALID_USAGE_MODE: ((Invalid usage mode provided.))");
+            if (update.usageMode === UsageMode.PASSTHROUGH) {
+                (0, errors_1.assert)(this.getUserCount() === 0, "USERS_STILL_EXIST: ((Users are present, unable to set passthrough mode.))");
+            }
+        }
+        if (!updateMask) {
+            this.oneAccountPerEmail = (_b = !((_a = update.signIn) === null || _a === void 0 ? void 0 : _a.allowDuplicateEmails)) !== null && _b !== void 0 ? _b : true;
+            this.blockingFunctionsConfig = (_c = update.blockingFunctions) !== null && _c !== void 0 ? _c : {};
+            this.usageMode = (_d = update.usageMode) !== null && _d !== void 0 ? _d : UsageMode.DEFAULT;
+            return this.config;
+        }
+        return applyMask(updateMask, this.config, update);
+    }
     getTenantProject(tenantId) {
         if (!this.tenantProjectForTenantId.has(tenantId)) {
             this.createTenantWithTenantId(tenantId, {
@@ -574,40 +602,21 @@ class TenantProjectState extends ProjectState {
             };
             return this.tenantConfig;
         }
-        const paths = updateMask.split(",");
-        for (const path of paths) {
-            const fields = path.split(".");
-            let updateField = update;
-            let existingField = this._tenantConfig;
-            let field;
-            for (let i = 0; i < fields.length - 1; i++) {
-                field = fields[i];
-                if (updateField[field] == null) {
-                    console.warn(`Unable to find field '${field}' in update '${updateField}`);
-                    break;
-                }
-                if (Array.isArray(updateField[field]) ||
-                    Object(updateField[field]) !== updateField[field]) {
-                    console.warn(`Field '${field}' is singular and cannot have sub-fields`);
-                    break;
-                }
-                if (!existingField[field]) {
-                    existingField[field] = {};
-                }
-                updateField = updateField[field];
-                existingField = existingField[field];
-            }
-            field = fields[fields.length - 1];
-            if (updateField[field] == null) {
-                console.warn(`Unable to find field '${field}' in update '${JSON.stringify(updateField)}`);
-                continue;
-            }
-            existingField[field] = updateField[field];
-        }
-        return this.tenantConfig;
+        return applyMask(updateMask, this.tenantConfig, update);
     }
 }
 exports.TenantProjectState = TenantProjectState;
+var UsageMode;
+(function (UsageMode) {
+    UsageMode["USAGE_MODE_UNSPECIFIED"] = "USAGE_MODE_UNSPECIFIED";
+    UsageMode["DEFAULT"] = "DEFAULT";
+    UsageMode["PASSTHROUGH"] = "PASSTHROUGH";
+})(UsageMode = exports.UsageMode || (exports.UsageMode = {}));
+var BlockingFunctionEvents;
+(function (BlockingFunctionEvents) {
+    BlockingFunctionEvents["BEFORE_CREATE"] = "beforeCreate";
+    BlockingFunctionEvents["BEFORE_SIGN_IN"] = "beforeSignIn";
+})(BlockingFunctionEvents = exports.BlockingFunctionEvents || (exports.BlockingFunctionEvents = {}));
 function getProviderEmailsForUser(user) {
     var _a;
     const emails = new Set();
@@ -618,8 +627,35 @@ function getProviderEmailsForUser(user) {
     });
     return emails;
 }
-var UsageMode;
-(function (UsageMode) {
-    UsageMode["DEFAULT"] = "DEFAULT";
-    UsageMode["PASSTHROUGH"] = "PASSTHROUGH";
-})(UsageMode = exports.UsageMode || (exports.UsageMode = {}));
+function applyMask(updateMask, dest, update) {
+    const paths = updateMask.split(",");
+    for (const path of paths) {
+        const fields = path.split(".");
+        let updateField = update;
+        let existingField = dest;
+        let field;
+        for (let i = 0; i < fields.length - 1; i++) {
+            field = fields[i];
+            if (updateField[field] == null) {
+                console.warn(`Unable to find field '${field}' in update '${updateField}`);
+                break;
+            }
+            if (Array.isArray(updateField[field]) || Object(updateField[field]) !== updateField[field]) {
+                console.warn(`Field '${field}' is singular and cannot have sub-fields`);
+                break;
+            }
+            if (!existingField[field]) {
+                existingField[field] = {};
+            }
+            updateField = updateField[field];
+            existingField = existingField[field];
+        }
+        field = fields[fields.length - 1];
+        if (updateField[field] == null) {
+            console.warn(`Unable to find field '${field}' in update '${JSON.stringify(updateField)}`);
+            continue;
+        }
+        existingField[field] = updateField[field];
+    }
+    return dest;
+}

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

@@ -38,6 +38,8 @@ const getDefaultDatabaseInstance_1 = require("../getDefaultDatabaseInstance");
 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;
@@ -140,7 +142,7 @@ function filterEmulatorTargets(options) {
 }
 exports.filterEmulatorTargets = filterEmulatorTargets;
 function shouldStart(options, name) {
-    var _a, _b, _c;
+    var _a, _b;
     if (name === types_1.Emulators.HUB) {
         return !!options.project;
     }
@@ -155,9 +157,15 @@ function shouldStart(options, name) {
         }
         return (!!options.project && targets.some((target) => types_1.EMULATORS_SUPPORTED_BY_UI.includes(target)));
     }
-    if (name === types_1.Emulators.FUNCTIONS && emulatorInTargets && !((_c = options.config.src.functions) === null || _c === void 0 ? void 0 : _c.source)) {
-        emulatorLogger_1.EmulatorLogger.forEmulator(types_1.Emulators.FUNCTIONS).logLabeled("WARN", "functions", `The functions emulator is configured but there is no functions source directory. Have you run ${clc.bold("firebase init functions")}?`);
-        return false;
+    if (name === types_1.Emulators.FUNCTIONS && emulatorInTargets) {
+        try {
+            (0, projectConfig_1.normalizeAndValidate)(options.config.src.functions);
+            return true;
+        }
+        catch (err) {
+            emulatorLogger_1.EmulatorLogger.forEmulator(types_1.Emulators.FUNCTIONS).logLabeled("WARN", "functions", `The functions emulator is configured but there is no functions source directory. Have you run ${clc.bold("firebase init functions")}?`);
+            return false;
+        }
     }
     if (name === types_1.Emulators.HOSTING && emulatorInTargets && !options.config.get("hosting")) {
         emulatorLogger_1.EmulatorLogger.forEmulator(types_1.Emulators.HOSTING).logLabeled("WARN", "hosting", `The hosting emulator is configured but there is no hosting configuration. Have you run ${clc.bold("firebase init hosting")}?`);
@@ -209,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) || "";
@@ -253,16 +268,15 @@ async function startAll(options, showUI = true) {
     const emulatableBackends = [];
     const projectDir = (options.extDevDir || options.config.projectDir);
     if (shouldStart(options, types_1.Emulators.FUNCTIONS)) {
-        utils.assertDefined(options.config.src.functions);
-        utils.assertDefined(options.config.src.functions.source, "Error: 'functions.source' is not defined");
+        const functionsCfg = (0, projectConfig_1.normalizeAndValidate)(options.config.src.functions)[0];
         utils.assertIsStringOrUndefined(options.extDevDir);
-        const functionsDir = path.join(projectDir, options.config.src.functions.source);
+        const functionsDir = path.join(projectDir, functionsCfg.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")),
+            nodeMajorVersion: (0, functionsEmulatorUtils_1.parseRuntimeVersion)(options.extDevNodeVersion || functionsCfg.runtime),
         });
     }
     if (shouldStart(options, types_1.Emulators.EXTENSIONS) && previews_1.previews.extensionsemulator) {
@@ -473,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,24 +29,24 @@ 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.1.jar"),
+        version: "1.14.1",
         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.1.jar",
+            expectedSize: 60416634,
+            expectedChecksum: "33cffe8065d4250816f257eb19245932",
             namePrefix: "cloud-firestore-emulator",
         },
     },
     storage: {
-        downloadPath: path.join(CACHE_DIR, "cloud-storage-rules-runtime-v1.0.1.jar"),
-        version: "1.0.1",
+        downloadPath: path.join(CACHE_DIR, "cloud-storage-rules-runtime-v1.0.2.jar"),
+        version: "1.0.2",
         opts: {
             cacheDir: CACHE_DIR,
-            remoteUrl: "https://storage.googleapis.com/firebase-preview-drop/emulator/cloud-storage-rules-runtime-v1.0.1.jar",
-            expectedSize: 32729999,
-            expectedChecksum: "1a441f5e16c17aa7a27db71c9c9186d5",
+            remoteUrl: "https://storage.googleapis.com/firebase-preview-drop/emulator/cloud-storage-rules-runtime-v1.0.2.jar",
+            expectedSize: 35704306,
+            expectedChecksum: "0dd3e17939610fc3dbdf53fb24cfda86",
             namePrefix: "cloud-storage-rules-emulator",
         },
     },
@@ -236,6 +236,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;