firebase-tools 14.15.2 → 14.16.0

package/lib/commands/firestore-bulkdelete.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
+const command_1 = require("../command");
+const fsi = require("../firestore/api");
+const logger_1 = require("../logger");
+const requirePermissions_1 = require("../requirePermissions");
+const types_1 = require("../emulator/types");
+const commandUtils_1 = require("../emulator/commandUtils");
+const prompt_1 = require("../prompt");
+const utils = require("../utils");
+const clc = require("colorette");
+const utils_1 = require("../utils");
+const error_1 = require("../error");
+function confirmationMessage(options, databaseId, collectionIds) {
+    const root = `projects/${options.project}/databases/${databaseId}/documents`;
+    return ("You are about to delete all documents in the following collection groups: " +
+        clc.cyan(collectionIds.map((item) => `"${item}"`).join(", ")) +
+        " in " +
+        clc.cyan(`"${root}"`) +
+        ". Are you sure?");
+}
+exports.command = new command_1.Command("firestore:bulkdelete")
+    .description("managed bulk delete service to delete data from one or more collection groups")
+    .option("--database <databaseName>", 'Database ID for database to delete from. "(default)" if none is provided.')
+    .option("--collection-ids <collectionIds>", "A comma-separated list of collection group IDs to delete. Deletes all documents in the specified collection groups.")
+    .before(requirePermissions_1.requirePermissions, ["datastore.databases.bulkDeleteDocuments"])
+    .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.FIRESTORE)
+    .action(async (options) => {
+    if (!options.collectionIds) {
+        throw new error_1.FirebaseError("Missing required flag --collection-ids=[comma separated list of collection groups]");
+    }
+    let collectionIds = [];
+    try {
+        collectionIds = options.collectionIds
+            .split(",")
+            .filter((id) => id.trim() !== "");
+    }
+    catch (e) {
+        throw new error_1.FirebaseError("The value for --collection-ids must a list of comma separated collection group names");
+    }
+    if (collectionIds.length === 0) {
+        throw new error_1.FirebaseError("Must specify at least one collection ID in --collection-ids.");
+    }
+    const databaseId = options.database || "(default)";
+    const api = new fsi.FirestoreApi();
+    const confirmed = await (0, prompt_1.confirm)({
+        message: confirmationMessage(options, databaseId, collectionIds),
+        default: false,
+        force: options.force,
+        nonInteractive: options.nonInteractive,
+    });
+    if (!confirmed) {
+        return utils.reject("Command aborted.", { exit: 1 });
+    }
+    const op = await api.bulkDeleteDocuments(options.project, databaseId, collectionIds);
+    if (options.json) {
+        logger_1.logger.info(JSON.stringify(op, undefined, 2));
+    }
+    else {
+        if (op.name) {
+            (0, utils_1.logSuccess)(`Successfully started bulk delete operation.`);
+            (0, utils_1.logBullet)(`Operation name: ` + clc.cyan(op.name));
+            (0, utils_1.logBullet)("You can monitor the operation's progress using the " +
+                clc.cyan(`gcloud firestore operations describe`) +
+                ` command.`);
+        }
+        else {
+            (0, utils_1.logLabeledError)(`Bulk Delete:`, `Failed to start a bulk delete operation.`);
+        }
+    }
+    return op;
+});

package/lib/commands/firestore-operations-cancel.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
+const command_1 = require("../command");
+const fsi = require("../firestore/api");
+const types_1 = require("../emulator/types");
+const commandUtils_1 = require("../emulator/commandUtils");
+const firestore_utils_1 = require("./firestore-utils");
+const prompt_1 = require("../prompt");
+const clc = require("colorette");
+const utils = require("../utils");
+const logger_1 = require("../logger");
+exports.command = new command_1.Command("firestore:operations:cancel <operationName>")
+    .description("cancels a long-running Cloud Firestore admin operation")
+    .option("--database <databaseName>", 'Database ID for which the operation is running. "(default)" if none is provided.')
+    .option("--force", "Forces the operation cancellation without asking for confirmation")
+    .before(commandUtils_1.errorMissingProject)
+    .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.FIRESTORE)
+    .action(async (operationName, options) => {
+    const databaseId = options.database || "(default)";
+    operationName = (0, firestore_utils_1.getShortOperationName)(operationName);
+    if (!options.force) {
+        const fullName = `/projects/${options.project}/databases/${databaseId}/operations/${operationName}`;
+        const confirmMessage = `You are about to cancel the operation: ${clc.bold(clc.yellow(clc.underline(fullName)))}. Do you wish to continue?`;
+        const consent = await (0, prompt_1.confirm)(confirmMessage);
+        if (!consent) {
+            return utils.reject("Command aborted.", { exit: 1 });
+        }
+    }
+    const api = new fsi.FirestoreApi();
+    const status = await api.cancelOperation(options.project, databaseId, operationName);
+    if (options.json) {
+        logger_1.logger.info(JSON.stringify(status, undefined, 2));
+    }
+    else {
+        if (status.success) {
+            utils.logSuccess("Operation cancelled successfully.");
+        }
+        else {
+            utils.logWarning("Canceling the operation failed.");
+        }
+    }
+    return status;
+});

package/lib/commands/firestore-operations-describe.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
+const command_1 = require("../command");
+const fsi = require("../firestore/api");
+const logger_1 = require("../logger");
+const types_1 = require("../emulator/types");
+const commandUtils_1 = require("../emulator/commandUtils");
+const pretty_print_1 = require("../firestore/pretty-print");
+const firestore_utils_1 = require("./firestore-utils");
+exports.command = new command_1.Command("firestore:operations:describe <operationName>")
+    .description("retrieves information about a Cloud Firestore admin operation")
+    .option("--database <databaseName>", 'Database ID for which the operation is running. "(default)" if none is provided.')
+    .before(commandUtils_1.errorMissingProject)
+    .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.FIRESTORE)
+    .action(async (operationName, options) => {
+    const databaseId = options.database || "(default)";
+    operationName = (0, firestore_utils_1.getShortOperationName)(operationName);
+    const api = new fsi.FirestoreApi();
+    const operation = await api.describeOperation(options.project, databaseId, operationName);
+    if (options.json) {
+        logger_1.logger.info(JSON.stringify(operation, undefined, 2));
+    }
+    else {
+        const printer = new pretty_print_1.PrettyPrint();
+        printer.prettyPrintOperation(operation);
+    }
+    return operation;
+});

package/lib/commands/firestore-operations-list.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
+const command_1 = require("../command");
+const fsi = require("../firestore/api");
+const logger_1 = require("../logger");
+const types_1 = require("../emulator/types");
+const commandUtils_1 = require("../emulator/commandUtils");
+const pretty_print_1 = require("../firestore/pretty-print");
+exports.command = new command_1.Command("firestore:operations:list")
+    .description("list pending Cloud Firestore admin operations and their status")
+    .option("--database <databaseName>", 'Database ID for database to list operations for. "(default)" if none is provided.')
+    .option("--limit <number>", "The maximum number of operations to list. Uses 100 by default.")
+    .before(commandUtils_1.errorMissingProject)
+    .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.FIRESTORE)
+    .action(async (options) => {
+    const databaseId = options.database || "(default)";
+    const limit = options.limit === undefined ? 100 : Number(options.limit);
+    const api = new fsi.FirestoreApi();
+    const { operations } = await api.listOperations(options.project, databaseId, limit);
+    if (options.json) {
+        logger_1.logger.info(JSON.stringify(operations, undefined, 2));
+    }
+    else {
+        const printer = new pretty_print_1.PrettyPrint();
+        printer.prettyPrintOperations(operations);
+    }
+    return operations;
+});

package/lib/commands/firestore-utils.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getShortOperationName = void 0;
+const error_1 = require("../error");
+function getShortOperationName(operationName) {
+    let opName = operationName;
+    if (operationName.includes("/operations/")) {
+        opName = operationName.split("/operations/")[1];
+    }
+    if (opName.length === 0 || opName.includes("/")) {
+        throw new error_1.FirebaseError(`"${operationName}" is not a valid operation name.`);
+    }
+    return opName;
+}
+exports.getShortOperationName = getShortOperationName;

package/lib/commands/functions-config-export.js

@@ -78,7 +78,10 @@ exports.command = new command_1.Command("functions:config:export")
     .before(requireInteractive_1.default)
     .action(async (options) => {
     const config = (0, projectConfig_1.normalizeAndValidate)(options.config.src.functions)[0];
-    const functionsDir = config.source;
+    const configDir = (0, projectConfig_1.resolveConfigDir)(config);
+    if (!configDir) {
+        throw new error_1.FirebaseError("functions:config:export requires a local env directory. Set functions[].configDir in firebase.json when using remoteSource.");
+    }
     let pInfos = configExport.getProjectInfos(options);
     checkReservedAliases(pInfos);
     (0, utils_1.logBullet)("Importing functions configs from projects [" +
@@ -111,6 +114,6 @@ exports.command = new command_1.Command("functions:config:export")
     filesToWrite[".env"] =
         `${header}# .env file contains environment variables that applies to all projects.\n`;
     for (const [filename, content] of Object.entries(filesToWrite)) {
-        await options.config.askWriteProjectFile(path.join(functionsDir, filename), content);
+        await options.config.askWriteProjectFile(path.join(configDir, filename), content);
     }
 });

package/lib/commands/index.js

@@ -96,8 +96,13 @@ function load(client) {
     client.ext.dev.usage = loadCommand("ext-dev-usage");
     client.firestore = {};
     client.firestore.delete = loadCommand("firestore-delete");
+    client.firestore.bulkDelete = loadCommand("firestore-bulkdelete");
     client.firestore.indexes = loadCommand("firestore-indexes-list");
     client.firestore.locations = loadCommand("firestore-locations");
+    client.firestore.operations = {};
+    client.firestore.operations.cancel = loadCommand("firestore-operations-cancel");
+    client.firestore.operations.describe = loadCommand("firestore-operations-describe");
+    client.firestore.operations.list = loadCommand("firestore-operations-list");
     client.firestore.databases = {};
     client.firestore.databases.list = loadCommand("firestore-databases-list");
     client.firestore.databases.get = loadCommand("firestore-databases-get");

package/lib/config.js

@@ -42,13 +42,25 @@ class Config {
         });
         if (this.get("functions")) {
             if (this.projectDir && fsutils.dirExistsSync(this.path(Config.DEFAULT_FUNCTIONS_SOURCE))) {
-                if (Array.isArray(this.get("functions"))) {
-                    if (!this.get("functions.[0].source")) {
-                        this.set("functions.[0].source", Config.DEFAULT_FUNCTIONS_SOURCE);
+                const funcs = this.get("functions");
+                if (Array.isArray(funcs)) {
+                    let emptyIdx;
+                    for (let i = 0; i < funcs.length; i++) {
+                        const hasSource = this.get(`functions.[${i}].source`);
+                        const hasRemote = this.get(`functions.[${i}].remoteSource`);
+                        if (!hasSource && !hasRemote) {
+                            emptyIdx = i;
+                            break;
+                        }
+                    }
+                    if (emptyIdx !== undefined) {
+                        this.set(`functions.[${emptyIdx}].source`, Config.DEFAULT_FUNCTIONS_SOURCE);
                     }
                 }
                 else {
-                    if (!this.get("functions.source")) {
+                    const hasSource = this.get("functions.source");
+                    const hasRemote = this.get("functions.remoteSource");
+                    if (!hasSource && !hasRemote) {
                         this.set("functions.source", Config.DEFAULT_FUNCTIONS_SOURCE);
                     }
                 }

package/lib/dataconnect/ensureApis.js

@@ -4,10 +4,10 @@ exports.ensureGIFApis = exports.ensureApis = void 0;
 const api = require("../api");
 const ensureApiEnabled_1 = require("../ensureApiEnabled");
 const prefix = "dataconnect";
-async function ensureApis(projectId) {
+async function ensureApis(projectId, silent = false) {
     await Promise.all([
-        (0, ensureApiEnabled_1.ensure)(projectId, api.dataconnectOrigin(), prefix),
-        (0, ensureApiEnabled_1.ensure)(projectId, api.cloudSQLAdminOrigin(), prefix),
+        (0, ensureApiEnabled_1.ensure)(projectId, api.dataconnectOrigin(), prefix, silent),
+        (0, ensureApiEnabled_1.ensure)(projectId, api.cloudSQLAdminOrigin(), prefix, silent),
     ]);
 }
 exports.ensureApis = ensureApis;

package/lib/deploy/functions/deploy.js

@@ -51,7 +51,7 @@ async function uploadSourceV2(projectId, source, wantBackend) {
     return res.storageSource;
 }
 async function uploadCodebase(context, codebase, wantBackend) {
-    var _a;
+    var _a, _b, _c, _d;
     const source = (_a = context.sources) === null || _a === void 0 ? void 0 : _a[codebase];
     if (!source || (!source.functionsSourceV1 && !source.functionsSourceV2)) {
         return;
@@ -67,9 +67,10 @@ async function uploadCodebase(context, codebase, wantBackend) {
         if (storage) {
             source.storage = storage;
         }
-        const sourceDir = (0, projectConfig_1.configForCodebase)(context.config, codebase).source;
+        const cfg = (0, projectConfig_1.configForCodebase)(context.config, codebase);
+        const label = (_d = (_b = cfg.source) !== null && _b !== void 0 ? _b : (_c = cfg.remoteSource) === null || _c === void 0 ? void 0 : _c.dir) !== null && _d !== void 0 ? _d : "remote";
         if (uploads.length) {
-            (0, utils_1.logSuccess)(`${clc.green(clc.bold("functions:"))} ${clc.bold(sourceDir)} folder uploaded successfully`);
+            (0, utils_1.logLabeledSuccess)("functions", `${clc.bold(label)} source uploaded successfully`);
         }
     }
     catch (err) {

package/lib/deploy/functions/prepare.js

@@ -73,12 +73,13 @@ async function prepare(context, options, payload) {
     for (const [codebase, wantBuild] of Object.entries(wantBuilds)) {
         const config = (0, projectConfig_1.configForCodebase)(context.config, codebase);
         const firebaseEnvs = functionsEnv.loadFirebaseEnvs(firebaseConfig, projectId);
+        const localCfg = (0, projectConfig_1.requireLocal)(config, "Remote sources are not supported.");
         const userEnvOpt = {
-            functionsSource: options.config.path(config.source),
+            functionsSource: options.config.path(localCfg.source),
             projectId: projectId,
             projectAlias: options.projectAlias,
         };
-        proto.convertIfPresent(userEnvOpt, config, "configDir", (cd) => options.config.path(cd));
+        proto.convertIfPresent(userEnvOpt, localCfg, "configDir", (cd) => options.config.path(cd));
         const userEnvs = functionsEnv.loadUserEnvs(userEnvOpt);
         const envs = Object.assign(Object.assign({}, userEnvs), firebaseEnvs);
         const { backend: wantBackend, envs: resolvedEnvs } = await build.resolveBackend({
@@ -142,20 +143,21 @@ async function prepare(context, options, payload) {
     validate.endpointsAreUnique(wantBackends);
     context.sources = {};
     for (const [codebase, wantBackend] of Object.entries(wantBackends)) {
-        const config = (0, projectConfig_1.configForCodebase)(context.config, codebase);
-        const sourceDirName = config.source;
+        const cfg = (0, projectConfig_1.configForCodebase)(context.config, codebase);
+        const localCfg = (0, projectConfig_1.requireLocal)(cfg, "Remote sources are not supported.");
+        const sourceDirName = localCfg.source;
         const sourceDir = options.config.path(sourceDirName);
         const source = {};
         if (backend.someEndpoint(wantBackend, () => true)) {
             (0, utils_1.logLabeledBullet)("functions", `preparing ${clc.bold(sourceDirName)} directory for uploading...`);
         }
         if (backend.someEndpoint(wantBackend, (e) => e.platform === "gcfv2")) {
-            const packagedSource = await (0, prepareFunctionsUpload_1.prepareFunctionsUpload)(sourceDir, config);
+            const packagedSource = await (0, prepareFunctionsUpload_1.prepareFunctionsUpload)(sourceDir, localCfg);
             source.functionsSourceV2 = packagedSource === null || packagedSource === void 0 ? void 0 : packagedSource.pathToSource;
             source.functionsSourceV2Hash = packagedSource === null || packagedSource === void 0 ? void 0 : packagedSource.hash;
         }
         if (backend.someEndpoint(wantBackend, (e) => e.platform === "gcfv1")) {
-            const packagedSource = await (0, prepareFunctionsUpload_1.prepareFunctionsUpload)(sourceDir, config, runtimeConfig);
+            const packagedSource = await (0, prepareFunctionsUpload_1.prepareFunctionsUpload)(sourceDir, localCfg, runtimeConfig);
             source.functionsSourceV1 = packagedSource === null || packagedSource === void 0 ? void 0 : packagedSource.pathToSource;
             source.functionsSourceV1Hash = packagedSource === null || packagedSource === void 0 ? void 0 : packagedSource.hash;
         }

package/lib/emulator/commandUtils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.JAVA_DEPRECATION_WARNING = exports.MIN_SUPPORTED_JAVA_MAJOR_VERSION = exports.checkJavaMajorVersion = exports.emulatorExec = exports.getListenOverview = exports.shutdownWhenKilled = exports.setExportOnExitOptions = exports.parseInspectionPort = exports.beforeEmulatorCommand = exports.warnEmulatorNotSupported = exports.printNoticeIfEmulated = exports.DEFAULT_CONFIG = exports.DESC_TEST_PARAMS = exports.FLAG_TEST_PARAMS = exports.DESC_TEST_CONFIG = exports.FLAG_TEST_CONFIG = exports.DESC_UI = exports.FLAG_UI = exports.DESC_VERBOSITY = exports.FLAG_VERBOSITY = exports.FLAG_VERBOSITY_NAME = 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.MIN_SUPPORTED_JAVA_MAJOR_VERSION = exports.checkJavaMajorVersion = exports.emulatorExec = exports.getListenOverview = exports.shutdownWhenKilled = exports.setExportOnExitOptions = exports.parseInspectionPort = exports.beforeEmulatorCommand = exports.errorMissingProject = exports.warnEmulatorNotSupported = exports.printNoticeIfEmulated = exports.DEFAULT_CONFIG = exports.DESC_TEST_PARAMS = exports.FLAG_TEST_PARAMS = exports.DESC_TEST_CONFIG = exports.FLAG_TEST_CONFIG = exports.DESC_UI = exports.FLAG_UI = exports.DESC_VERBOSITY = exports.FLAG_VERBOSITY = exports.FLAG_VERBOSITY_NAME = 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("colorette");
 const childProcess = require("child_process");
 const controller = require("../emulator/controller");
@@ -86,6 +86,12 @@ async function warnEmulatorNotSupported(options, emulator) {
     }
 }
 exports.warnEmulatorNotSupported = warnEmulatorNotSupported;
+async function errorMissingProject(options) {
+    if (!options.project) {
+        throw new error_1.FirebaseError("Project is not defined. Either use `--project` or use `firebase use` to set your active project.");
+    }
+}
+exports.errorMissingProject = errorMissingProject;
 async function beforeEmulatorCommand(options) {
     const optionsWithDefaultConfig = Object.assign(Object.assign({}, options), { config: exports.DEFAULT_CONFIG });
     const optionsWithConfig = options.config ? options : optionsWithDefaultConfig;

package/lib/emulator/controller.js

@@ -98,7 +98,7 @@ exports.filterEmulatorTargets = filterEmulatorTargets;
 function shouldStart(options, name) {
     var _a, _b;
     if (name === types_1.Emulators.HUB) {
-        return !!options.project;
+        return true;
     }
     const targets = filterEmulatorTargets(options);
     const emulatorInTargets = targets.includes(name);
@@ -109,7 +109,7 @@ function shouldStart(options, name) {
         if (((_b = (_a = options.config.src.emulators) === null || _a === void 0 ? void 0 : _a.ui) === null || _b === void 0 ? void 0 : _b.enabled) === false) {
             return false;
         }
-        return (!!options.project && targets.some((target) => types_1.EMULATORS_SUPPORTED_BY_UI.includes(target)));
+        return targets.some((target) => types_1.EMULATORS_SUPPORTED_BY_UI.includes(target));
     }
     if (name === types_1.Emulators.FUNCTIONS && emulatorInTargets) {
         try {
@@ -188,7 +188,7 @@ async function startAll(options, showUI = true, runningTestScript = false) {
     }
     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) || "";
+    const projectId = (0, projectUtils_1.getProjectId)(options) || hub_1.EmulatorHub.MISSING_PROJECT_PLACEHOLDER;
     const isDemoProject = constants_1.Constants.isDemoProject(projectId);
     if (isDemoProject) {
         hubLogger.logLabeled("BULLET", "emulators", `Detected demo project ID "${projectId}", emulated services will use a demo configuration and attempts to access non-emulated services for this project will fail.`);
@@ -340,7 +340,8 @@ async function startAll(options, showUI = true, runningTestScript = false) {
         const functionsCfg = (0, projectConfig_1.normalizeAndValidate)(options.config.src.functions);
         utils.assertIsStringOrUndefined(options.extDevDir);
         for (const cfg of functionsCfg) {
-            const functionsDir = path.join(projectDir, cfg.source);
+            const localCfg = (0, projectConfig_1.requireLocal)(cfg, "Remote sources are not supported in the Functions emulator.");
+            const functionsDir = path.join(projectDir, localCfg.source);
             const runtime = ((_g = options.extDevRuntime) !== null && _g !== void 0 ? _g : cfg.runtime);
             if (runtime && !(0, supported_1.isRuntime)(runtime)) {
                 throw new error_1.FirebaseError(`Cannot load functions from ${functionsDir} because it has invalid runtime ${runtime}`);
@@ -348,14 +349,14 @@ async function startAll(options, showUI = true, runningTestScript = false) {
             const backend = {
                 functionsDir,
                 runtime,
-                codebase: cfg.codebase,
-                prefix: cfg.prefix,
+                codebase: localCfg.codebase,
+                prefix: localCfg.prefix,
                 env: Object.assign({}, options.extDevEnv),
                 secretEnv: [],
                 predefinedTriggers: options.extDevTriggers,
-                ignore: cfg.ignore,
+                ignore: localCfg.ignore,
             };
-            proto.convertIfPresent(backend, cfg, "configDir", (cd) => path.join(projectDir, cd));
+            proto.convertIfPresent(backend, localCfg, "configDir", (cd) => path.join(projectDir, cd));
             emulatableBackends.push(backend);
         }
     }
@@ -372,7 +373,6 @@ async function startAll(options, showUI = true, runningTestScript = false) {
         }
         const functionsLogger = emulatorLogger_1.EmulatorLogger.forEmulator(types_1.Emulators.FUNCTIONS);
         const functionsAddr = legacyGetFirstAddr(types_1.Emulators.FUNCTIONS);
-        const projectId = (0, projectUtils_1.needProjectId)(options);
         const inspectFunctions = commandUtils.parseInspectionPort(options);
         if (inspectFunctions) {
             functionsLogger.logLabeled("WARN", "functions", `You are running the Functions emulator in debug mode. This means that functions will execute in sequence rather than in parallel.`);
@@ -461,13 +461,8 @@ async function startAll(options, showUI = true, runningTestScript = false) {
             firestoreLogger.logLabeled("WARN", "firestore", "The emulator will default to allowing all reads and writes. Learn more about this option: https://firebase.google.com/docs/emulator-suite/install_and_configure#security_rules_configuration.");
         }
         if (singleProjectModeEnabled) {
-            if (projectId) {
-                args.single_project_mode = true;
-                args.single_project_mode_error = false;
-            }
-            else {
-                firestoreLogger.logLabeled("DEBUG", "firestore", "Could not enable single_project_mode: missing projectId.");
-            }
+            args.single_project_mode = true;
+            args.single_project_mode_error = false;
         }
         const firestoreEmulator = new firestoreEmulator_1.FirestoreEmulator(args);
         await startEmulator(firestoreEmulator);
@@ -525,9 +520,6 @@ async function startAll(options, showUI = true, runningTestScript = false) {
         }
     }
     if (listenForEmulator.auth) {
-        if (!projectId) {
-            throw new error_1.FirebaseError(`Cannot start the ${constants_1.Constants.description(types_1.Emulators.AUTH)} without a project: run 'firebase init' or provide the --project flag`);
-        }
         const authAddr = legacyGetFirstAddr(types_1.Emulators.AUTH);
         const authEmulator = new auth_2.AuthEmulator({
             host: authAddr.host,
@@ -546,9 +538,6 @@ async function startAll(options, showUI = true, runningTestScript = false) {
         }
     }
     if (listenForEmulator.pubsub) {
-        if (!projectId) {
-            throw new error_1.FirebaseError("Cannot start the Pub/Sub emulator without a project: run 'firebase init' or provide the --project flag");
-        }
         const pubsubAddr = legacyGetFirstAddr(types_1.Emulators.PUBSUB);
         const pubsubEmulator = new pubsubEmulator_1.PubsubEmulator({
             host: pubsubAddr.host,
@@ -571,7 +560,6 @@ async function startAll(options, showUI = true, runningTestScript = false) {
             projectId,
             auto_download: true,
             configDir: config[0].source,
-            rc: options.rc,
             config: options.config,
             autoconnectToPostgres: true,
             postgresListen: listenForEmulator["dataconnect.postgres"],
@@ -612,7 +600,7 @@ async function startAll(options, showUI = true, runningTestScript = false) {
         const storageEmulator = new storage_1.StorageEmulator({
             host: storageAddr.host,
             port: storageAddr.port,
-            projectId: projectId,
+            projectId,
             rules: (0, config_1.getStorageRulesConfig)(projectId, options),
         });
         await startEmulator(storageEmulator);
@@ -671,13 +659,12 @@ async function startAll(options, showUI = true, runningTestScript = false) {
         await startEmulator(loggingEmulator);
     }
     if (showUI && !shouldStart(options, types_1.Emulators.UI)) {
-        hubLogger.logLabeled("WARN", "emulators", "The Emulator UI is not starting, either because none of the running " +
-            "emulators have a UI component or the Emulator UI cannot " +
-            "determine the Project ID. Pass the --project flag to specify a project.");
+        hubLogger.logLabeled("WARN", "emulators", "The Emulator UI is not starting because none of the running " +
+            "emulators have a UI component.");
     }
     if (listenForEmulator.ui) {
         const ui = new ui_1.EmulatorUI({
-            projectId: projectId,
+            projectId,
             listen: listenForEmulator[types_1.Emulators.UI],
         });
         await startEmulator(ui);
@@ -726,9 +713,6 @@ function getListenConfig(options, emulator) {
 }
 async function exportEmulatorData(exportPath, options, initiatedBy) {
     const projectId = options.project;
-    if (!projectId) {
-        throw new error_1.FirebaseError("Could not determine project ID, make sure you're running in a Firebase project directory or add the --project flag.", { exit: 1 });
-    }
     const hubClient = new hubClient_1.EmulatorHubClient(projectId);
     if (!hubClient.foundHub()) {
         throw new error_1.FirebaseError(`Did not find any running emulators for project ${clc.bold(projectId)}.`, { exit: 1 });

package/lib/emulator/downloadableEmulatorInfo.json

@@ -54,28 +54,28 @@
     },
     "dataconnect": {
         "darwin": {
-            "version": "2.12.0",
-            "expectedSize": 29447008,
-            "expectedChecksum": "73a09e7f54b642c0232ce89e9a4dd14a",
-            "expectedChecksumSHA256": "5464803fec776eac553e1431474f3d4fcc7cc2f4fe43a58e8c1ce9d7ede28acd",
-            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-macos-v2.12.0",
-            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.12.0"
+            "version": "2.13.0",
+            "expectedSize": 29475680,
+            "expectedChecksum": "8bceed44e84d08f135ad10b8b62337e9",
+            "expectedChecksumSHA256": "92e0cda1a3fd690421cae4edd7d985e5c5de7069e731ad200ba6988c2321d76c",
+            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-macos-v2.13.0",
+            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.13.0"
         },
         "win32": {
-            "version": "2.12.0",
-            "expectedSize": 29936128,
-            "expectedChecksum": "b4077d6d298024c9c454b8eb9ad9bf69",
-            "expectedChecksumSHA256": "37be096ab8d4d29fa902ca12df97327997b1dc06d4b5026e11aa11d65f183a71",
-            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-windows-v2.12.0",
-            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.12.0.exe"
+            "version": "2.13.0",
+            "expectedSize": 29965312,
+            "expectedChecksum": "67794a3cb334805a06fffd872be7d67c",
+            "expectedChecksumSHA256": "2905c570d40e586dd1ca0aeee10785786dc0486500640064e4e1e43be3b97899",
+            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-windows-v2.13.0",
+            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.13.0.exe"
         },
         "linux": {
-            "version": "2.12.0",
-            "expectedSize": 29372600,
-            "expectedChecksum": "04fb5bc9ef194170a5ba0966247eaa79",
-            "expectedChecksumSHA256": "42397dd1b23094944aaf20044bc1ec0a5b400c79b536d15803eb4fa6b2bba025",
-            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-linux-v2.12.0",
-            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.12.0"
+            "version": "2.13.0",
+            "expectedSize": 29401272,
+            "expectedChecksum": "d72e185be8b782b8d4bca86d6bc76d2d",
+            "expectedChecksumSHA256": "87cb9541f157c3e9986b6eba80d161e6ef1debd17075e4d95e78861d3cdd353f",
+            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-linux-v2.13.0",
+            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.13.0"
         }
     }
 }

package/lib/emulator/hub.js

@@ -26,8 +26,13 @@ class EmulatorHub extends ExpressBasedEmulator_1.ExpressBasedEmulator {
     }
     static getLocatorFilePath(projectId) {
         const dir = os.tmpdir();
+        if (!projectId) {
+            projectId = EmulatorHub.MISSING_PROJECT_PLACEHOLDER;
+        }
         const filename = `hub-${projectId}.json`;
-        return path.join(dir, filename);
+        const locatorPath = path.join(dir, filename);
+        logger_1.logger.debug(`Emulator locator file path: ${locatorPath}`);
+        return locatorPath;
     }
     constructor(args) {
         super({
@@ -177,6 +182,7 @@ class EmulatorHub extends ExpressBasedEmulator_1.ExpressBasedEmulator {
     }
 }
 exports.EmulatorHub = EmulatorHub;
+EmulatorHub.MISSING_PROJECT_PLACEHOLDER = "demo-no-project";
 EmulatorHub.CLI_VERSION = pkg.version;
 EmulatorHub.PATH_EXPORT = "/_admin/export";
 EmulatorHub.PATH_DISABLE_FUNCTIONS = "/functions/disableBackgroundTriggers";

package/lib/extensions/runtimes/common.js

@@ -135,13 +135,14 @@ exports.copyDirectory = copyDirectory;
 async function getCodebaseRuntime(options) {
     const config = (0, projectConfig_1.normalizeAndValidate)(options.config.src.functions);
     const codebaseConfig = (0, projectConfig_1.configForCodebase)(config, options.codebase || projectConfig_1.DEFAULT_CODEBASE);
-    const sourceDirName = codebaseConfig.source;
+    const localCfg = (0, projectConfig_1.requireLocal)(codebaseConfig);
+    const sourceDirName = localCfg.source;
     const sourceDir = options.config.path(sourceDirName);
     const delegateContext = {
         projectId: "",
         sourceDir,
         projectDir: options.config.projectDir,
-        runtime: codebaseConfig.runtime,
+        runtime: localCfg.runtime,
     };
     let delegate;
     try {