firebase-tools 14.15.2 → 14.17.0

package/lib/deploy/apphosting/util.js

@@ -7,28 +7,25 @@ const path = require("path");
 const tmp = require("tmp");
 const error_1 = require("../../error");
 const fsAsync = require("../../fsAsync");
-async function createArchive(config, projectRoot) {
+async function createArchive(config, rootDir) {
     const tmpFile = tmp.fileSync({ prefix: `${config.backendId}-`, postfix: ".zip" }).name;
     const fileStream = fs.createWriteStream(tmpFile, {
         flags: "w",
         encoding: "binary",
     });
     const archive = archiver("zip");
-    if (!projectRoot) {
-        projectRoot = process.cwd();
-    }
     const ignore = config.ignore || ["node_modules", ".git"];
     ignore.push("firebase-debug.log", "firebase-debug.*.log");
-    const gitIgnorePatterns = parseGitIgnorePatterns(projectRoot);
+    const gitIgnorePatterns = parseGitIgnorePatterns(rootDir);
     ignore.push(...gitIgnorePatterns);
     try {
         const files = await fsAsync.readdirRecursive({
-            path: projectRoot,
+            path: rootDir,
             ignore: ignore,
             isGitIgnore: true,
         });
         for (const file of files) {
-            const name = path.relative(projectRoot, file.name);
+            const name = path.relative(rootDir, file.name);
             archive.file(file.name, {
                 name,
                 mode: file.mode,
@@ -39,7 +36,7 @@ async function createArchive(config, projectRoot) {
     catch (err) {
         throw new error_1.FirebaseError("Could not read source directory. Remove links and shortcuts and try again.", { original: err, exit: 1 });
     }
-    return { projectSourcePath: projectRoot, zippedSourcePath: tmpFile };
+    return tmpFile;
 }
 exports.createArchive = createArchive;
 function parseGitIgnorePatterns(projectRoot, gitIgnorePath = ".gitignore") {

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/apphosting/developmentServer.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.detectStartCommand = exports.detectPackageManager = exports.logger = void 0;
+exports.detectPackageManagerStartCommand = exports.detectPackageManager = exports.logger = void 0;
 const fs_extra_1 = require("fs-extra");
 const path_1 = require("path");
 const emulatorLogger_1 = require("../emulatorLogger");
@@ -20,7 +20,7 @@ async function detectPackageManager(rootdir) {
     throw new error_1.FirebaseError("Unsupported package manager");
 }
 exports.detectPackageManager = detectPackageManager;
-async function detectStartCommand(rootDir) {
+async function detectPackageManagerStartCommand(rootDir) {
     try {
         const packageManager = await detectPackageManager(rootDir);
         return `${packageManager} run dev`;
@@ -29,4 +29,4 @@ async function detectStartCommand(rootDir) {
         throw new error_1.FirebaseError("Failed to auto-detect your project's start command. Consider manually setting the start command by setting `firebase.json#emulators.apphosting.startCommand`");
     }
 }
-exports.detectStartCommand = detectStartCommand;
+exports.detectPackageManagerStartCommand = detectPackageManagerStartCommand;

package/lib/emulator/apphosting/serve.js

@@ -22,17 +22,6 @@ const fetchWebSetup_1 = require("../../fetchWebSetup");
 const apps_1 = require("../../management/apps");
 const child_process_1 = require("child_process");
 const semver_1 = require("semver");
-async function start(options) {
-    var _a;
-    const hostname = constants_1.DEFAULT_HOST;
-    let port = (_a = options === null || options === void 0 ? void 0 : options.port) !== null && _a !== void 0 ? _a : constants_1.DEFAULT_PORTS.apphosting;
-    while (!(await availablePort(hostname, port))) {
-        port += 1;
-    }
-    await serve(options === null || options === void 0 ? void 0 : options.projectId, options === null || options === void 0 ? void 0 : options.backendId, port, options === null || options === void 0 ? void 0 : options.startCommand, options === null || options === void 0 ? void 0 : options.rootDirectory);
-    return { hostname, port };
-}
-exports.start = start;
 const secretResourceRegex = /^projects\/([^/]+)\/secrets\/([^/]+)(?:\/versions\/((?:latest)|\d+))?$/;
 const secretShorthandRegex = /^([^/@]+)(?:@((?:latest)|\d+))?$/;
 async function loadSecret(project, name) {
@@ -70,21 +59,41 @@ async function loadSecret(project, name) {
         throw err;
     }
 }
-async function serve(projectId, backendId, port, startCommand, backendRelativeDir) {
-    backendRelativeDir = backendRelativeDir !== null && backendRelativeDir !== void 0 ? backendRelativeDir : "./";
-    const backendRoot = (0, projectPath_1.resolveProjectPath)({}, backendRelativeDir);
+async function start(options) {
+    var _a, _b;
+    const hostname = constants_1.DEFAULT_HOST;
+    let port = (_a = options === null || options === void 0 ? void 0 : options.port) !== null && _a !== void 0 ? _a : constants_1.DEFAULT_PORTS.apphosting;
+    while (!(await availablePort(hostname, port))) {
+        port += 1;
+    }
+    const backendRoot = (0, projectPath_1.resolveProjectPath)({}, (_b = options === null || options === void 0 ? void 0 : options.rootDirectory) !== null && _b !== void 0 ? _b : "./");
+    let startCommand;
+    if (options === null || options === void 0 ? void 0 : options.startCommand) {
+        startCommand = options === null || options === void 0 ? void 0 : options.startCommand;
+        if (startCommand.includes("--port") || startCommand.includes(" -p ")) {
+            throw new error_1.FirebaseError("Specifying a port in the start command is not supported by the apphosting emulator");
+        }
+        if (startCommand.includes("ng serve")) {
+            startCommand += ` --port ${port}`;
+        }
+        developmentServer_2.logger.logLabeled("BULLET", types_1.Emulators.APPHOSTING, `running custom start command: '${startCommand}'`);
+    }
+    else {
+        startCommand = await (0, developmentServer_1.detectPackageManagerStartCommand)(backendRoot);
+        developmentServer_2.logger.logLabeled("BULLET", types_1.Emulators.APPHOSTING, `starting app with: '${startCommand}'`);
+    }
     const apphostingLocalConfig = await (0, config_1.getLocalAppHostingConfiguration)(backendRoot);
     const resolveEnv = Object.entries(apphostingLocalConfig.env).map(async ([key, value]) => [
         key,
-        value.value ? value.value : await loadSecret(projectId, value.secret),
+        value.value ? value.value : await loadSecret(options === null || options === void 0 ? void 0 : options.projectId, value.secret),
     ]);
-    const environmentVariablesToInject = Object.assign(Object.assign(Object.assign({ NODE_ENV: process.env.NODE_ENV }, getEmulatorEnvs()), Object.fromEntries(await Promise.all(resolveEnv))), { FIREBASE_APP_HOSTING: "1", X_GOOGLE_TARGET_PLATFORM: "fah", GCLOUD_PROJECT: projectId, PROJECT_ID: projectId, PORT: port.toString() });
+    const environmentVariablesToInject = Object.assign(Object.assign(Object.assign({ NODE_ENV: process.env.NODE_ENV }, getEmulatorEnvs()), Object.fromEntries(await Promise.all(resolveEnv))), { FIREBASE_APP_HOSTING: "1", X_GOOGLE_TARGET_PLATFORM: "fah", GCLOUD_PROJECT: options === null || options === void 0 ? void 0 : options.projectId, PROJECT_ID: options === null || options === void 0 ? void 0 : options.projectId, PORT: port.toString() });
     const packageManager = await (0, developmentServer_1.detectPackageManager)(backendRoot).catch(() => undefined);
     if (packageManager === "pnpm") {
         (0, utils_1.logLabeledWarning)("apphosting", `Firebase JS SDK autoinit does not currently support PNPM.`);
     }
     else {
-        const webappConfig = await getBackendAppConfig(projectId, backendId);
+        const webappConfig = await getBackendAppConfig(options === null || options === void 0 ? void 0 : options.projectId, options === null || options === void 0 ? void 0 : options.backendId);
         if (webappConfig) {
             environmentVariablesToInject["FIREBASE_WEBAPP_CONFIG"] || (environmentVariablesToInject["FIREBASE_WEBAPP_CONFIG"] = JSON.stringify(webappConfig));
             environmentVariablesToInject["FIREBASE_CONFIG"] || (environmentVariablesToInject["FIREBASE_CONFIG"] = JSON.stringify({
@@ -95,23 +104,14 @@ async function serve(projectId, backendId, port, startCommand, backendRelativeDi
         }
         await tripFirebasePostinstall(backendRoot, environmentVariablesToInject);
     }
-    if (startCommand) {
-        developmentServer_2.logger.logLabeled("BULLET", types_1.Emulators.APPHOSTING, `running custom start command: '${startCommand}'`);
-        (0, spawn_1.spawnWithCommandString)(startCommand, backendRoot, environmentVariablesToInject)
-            .catch((err) => {
-            developmentServer_2.logger.logLabeled("ERROR", types_1.Emulators.APPHOSTING, `failed to start Dev Server: ${err}`);
-        })
-            .then(() => developmentServer_2.logger.logLabeled("BULLET", types_1.Emulators.APPHOSTING, `Dev Server stopped`));
-        return;
-    }
-    const detectedStartCommand = await (0, developmentServer_1.detectStartCommand)(backendRoot);
-    developmentServer_2.logger.logLabeled("BULLET", types_1.Emulators.APPHOSTING, `starting app with: '${detectedStartCommand}'`);
-    (0, spawn_1.spawnWithCommandString)(detectedStartCommand, backendRoot, environmentVariablesToInject)
+    (0, spawn_1.spawnWithCommandString)(startCommand, backendRoot, environmentVariablesToInject)
         .catch((err) => {
         developmentServer_2.logger.logLabeled("ERROR", types_1.Emulators.APPHOSTING, `failed to start Dev Server: ${err}`);
     })
         .then(() => developmentServer_2.logger.logLabeled("BULLET", types_1.Emulators.APPHOSTING, `Dev Server stopped`));
+    return { hostname, port };
 }
+exports.start = start;
 function availablePort(host, port) {
     return (0, portUtils_1.checkListenable)({
         address: host,

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/emulator/initEmulators.js

@@ -24,7 +24,7 @@ exports.AdditionalInitFns = {
         additionalConfigs.set("rootDirectory", backendRelativeDir);
         const backendRoot = (0, path_1.join)(cwd, backendRelativeDir);
         try {
-            const startCommand = await (0, developmentServer_1.detectStartCommand)(backendRoot);
+            const startCommand = await (0, developmentServer_1.detectPackageManagerStartCommand)(backendRoot);
             additionalConfigs.set("startCommand", startCommand);
         }
         catch (e) {

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 {

package/lib/firestore/api.js

@@ -544,6 +544,19 @@ class FirestoreApi {
         }
         return database;
     }
+    async bulkDeleteDocuments(project, databaseId, collectionIds) {
+        var _a;
+        const name = `/projects/${project}/databases/${databaseId}`;
+        const url = `${name}:bulkDeleteDocuments`;
+        const payload = {
+            name,
+            collectionIds,
+        };
+        const res = await this.apiClient.post(url, payload);
+        return {
+            name: (_a = res.body) === null || _a === void 0 ? void 0 : _a.name,
+        };
+    }
     async restoreDatabase(project, databaseId, backupName, encryptionConfig) {
         const url = `/projects/${project}/databases:restore`;
         const payload = {
@@ -559,5 +572,37 @@ class FirestoreApi {
         }
         return database;
     }
+    async listOperations(project, databaseId, limit) {
+        const url = `/projects/${project}/databases/${databaseId}/operations`;
+        const res = await this.apiClient.get(url, {
+            queryParams: {
+                pageSize: limit,
+            },
+        });
+        return res.body;
+    }
+    async describeOperation(project, databaseId, operationName) {
+        const url = `/projects/${project}/databases/${databaseId}/operations/${operationName}`;
+        const res = await this.apiClient.get(url);
+        return res.body;
+    }
+    async cancelOperation(project, databaseId, operationName) {
+        var _a, _b, _c, _d;
+        const url = `/projects/${project}/databases/${databaseId}/operations/${operationName}:cancel`;
+        try {
+            const res = await this.apiClient.post(url);
+            return { success: res.status === 200 };
+        }
+        catch (error) {
+            const reason = "Cannot cancel an operation that is completed.";
+            const details = ((_c = (_b = (_a = error.context) === null || _a === void 0 ? void 0 : _a.body) === null || _b === void 0 ? void 0 : _b.error) === null || _c === void 0 ? void 0 : _c.details) || [];
+            for (const detail of details) {
+                if ((_d = detail.detail) === null || _d === void 0 ? void 0 : _d.includes(reason)) {
+                    throw new error_1.FirebaseError(reason);
+                }
+            }
+            throw error;
+        }
+    }
 }
 exports.FirestoreApi = FirestoreApi;

package/lib/firestore/pretty-print.js

@@ -120,6 +120,29 @@ class PrettyPrint {
         table.push(["Name", clc.yellow(backup.name)], ["Database", clc.yellow(backup.database)], ["Database UID", clc.yellow(backup.databaseUid)], ["State", clc.yellow(backup.state)], ["Snapshot Time", clc.yellow(backup.snapshotTime)], ["Expire Time", clc.yellow(backup.expireTime)], ["Stats", clc.yellow(backup.stats)]);
         logger_1.logger.info(table.toString());
     }
+    prettyPrintOperation(operation) {
+        const table = new Table({
+            head: ["Operation", ""],
+        });
+        table.push(["Name", clc.yellow(operation.name)], ["Done?", clc.yellow(operation.done ? "YES" : "NO")], ["Metadata", clc.yellow(JSON.stringify(operation.metadata, undefined, 2))]);
+        if (operation.response) {
+            table.push(["Response", clc.yellow(JSON.stringify(operation.response, undefined, 2))]);
+        }
+        logger_1.logger.info(table.toString());
+    }
+    prettyPrintOperations(operations) {
+        if (operations.length === 0) {
+            logger_1.logger.info("No operations found.");
+            return;
+        }
+        const table = new Table({
+            head: ["Operation Name", "Done"],
+        });
+        for (const op of operations) {
+            table.push([clc.yellow(op.name), op.done ? clc.green("YES") : clc.yellow("NO")]);
+        }
+        logger_1.logger.info(table.toString());
+    }
     prettyPrintLocations(locations) {
         if (locations.length === 0) {
             logger_1.logger.info("No Locations Available");