firebase-tools 14.15.1 → 14.16.0

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/dataconnectEmulator.js

@@ -15,7 +15,6 @@ const emulatorLogger_1 = require("./emulatorLogger");
 const types_2 = require("../dataconnect/types");
 const portUtils_1 = require("./portUtils");
 const registry_1 = require("./registry");
-const logger_1 = require("../logger");
 const load_1 = require("../dataconnect/load");
 const pgliteServer_1 = require("./dataconnect/pgliteServer");
 const controller_1 = require("./controller");
@@ -156,33 +155,37 @@ class DataConnectEmulator {
     }
     static async generate(args) {
         const commandInfo = await (0, downloadableEmulators_1.downloadIfNecessary)(types_1.Emulators.DATACONNECT);
-        const cmd = [
-            "--logtostderr",
-            "-v=2",
-            "generate",
-            `--config_dir=${args.configDir}`,
-            `--connector_id=${args.connectorId}`,
-        ];
+        const cmd = ["--logtostderr", "-v=2", "sdk", "generate", `--config_dir=${args.configDir}`];
         if (args.watch) {
             cmd.push("--watch");
         }
         const env = await DataConnectEmulator.getEnv(args.account);
-        const res = childProcess.spawnSync(commandInfo.binary, cmd, { encoding: "utf-8", env });
-        if ((0, downloadableEmulators_1.isIncomaptibleArchError)(res.error)) {
-            throw new error_1.FirebaseError(`Unknown system error when running the Data Connect toolkit. ` +
-                `You may be able to fix this by installing Rosetta: ` +
-                `softwareupdate --install-rosetta`);
-        }
-        logger_1.logger.info(res.stderr);
-        if (res.error) {
-            throw new error_1.FirebaseError(`Error starting up Data Connect generate: ${res.error.message}`, {
-                original: res.error,
-            });
-        }
-        if (res.status !== 0) {
-            throw new error_1.FirebaseError(`Unable to generate your Data Connect SDKs (exit code ${res.status}): ${res.stderr}`);
-        }
-        return res.stdout;
+        return new Promise((resolve, reject) => {
+            try {
+                const proc = childProcess.spawn(commandInfo.binary, cmd, { stdio: "inherit", env });
+                proc.on("close", (code) => {
+                    if (code === 0) {
+                        resolve();
+                    }
+                    else {
+                        reject(new Error(`Command failed with exit code ${code}`));
+                    }
+                });
+                proc.on("error", (err) => {
+                    reject(err);
+                });
+            }
+            catch (e) {
+                if ((0, downloadableEmulators_1.isIncomaptibleArchError)(e)) {
+                    reject(new error_1.FirebaseError(`Unknown system error when running the Data Connect toolkit. ` +
+                        `You may be able to fix this by installing Rosetta: ` +
+                        `softwareupdate --install-rosetta`));
+                }
+                else {
+                    reject(e);
+                }
+            }
+        });
     }
     static async build(args) {
         var _a;

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/functionsEmulator.js

@@ -341,11 +341,11 @@ class FunctionsEmulator {
             const resolution = await (0, build_1.resolveBackend)({
                 build: discoveredBuild,
                 firebaseConfig: JSON.parse(firebaseConfig),
-                userEnvOpt,
                 userEnvs,
                 nonInteractive: false,
                 isEmulator: true,
             });
+            functionsEnv.writeResolvedParams(resolution.envs, userEnvs, userEnvOpt);
             const discoveredBackend = resolution.backend;
             const endpoints = backend.allEndpoints(discoveredBackend);
             (0, functionsEmulatorShared_1.prepareEndpoints)(endpoints);

package/lib/emulator/hub.js

@@ -10,7 +10,6 @@ const types_1 = require("./types");
 const hubExport_1 = require("./hubExport");
 const registry_1 = require("./registry");
 const ExpressBasedEmulator_1 = require("./ExpressBasedEmulator");
-const vsCodeUtils_1 = require("../vsCodeUtils");
 const pkg = require("../../package.json");
 class EmulatorHub extends ExpressBasedEmulator_1.ExpressBasedEmulator {
     static readLocatorFile(projectId) {
@@ -20,16 +19,20 @@ class EmulatorHub extends ExpressBasedEmulator_1.ExpressBasedEmulator {
         }
         const data = fs.readFileSync(locatorPath, "utf8").toString();
         const locator = JSON.parse(data);
-        if (!(0, vsCodeUtils_1.isVSCodeExtension)() && locator.version !== this.CLI_VERSION) {
-            logger_1.logger.debug(`Found locator with mismatched version, ignoring: ${JSON.stringify(locator)}`);
-            return undefined;
+        if (locator.version !== this.CLI_VERSION) {
+            logger_1.logger.debug(`Found emulator locator with different version: ${JSON.stringify(locator)}, CLI_VERSION: ${this.CLI_VERSION}`);
         }
         return locator;
     }
     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({
@@ -179,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 {

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");

package/lib/functions/env.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadFirebaseEnvs = exports.loadUserEnvs = exports.checkForDuplicateKeys = exports.writeUserEnvs = exports.hasUserEnvs = exports.parseStrict = exports.validateKey = exports.KeyValidationError = exports.parse = void 0;
+exports.writeResolvedParams = exports.loadFirebaseEnvs = exports.loadUserEnvs = exports.checkForDuplicateKeys = exports.writeUserEnvs = exports.hasUserEnvs = exports.parseStrict = exports.validateKey = exports.KeyValidationError = exports.parse = void 0;
 const clc = require("colorette");
 const fs = require("fs");
 const path = require("path");
@@ -250,3 +250,14 @@ function loadFirebaseEnvs(firebaseConfig, projectId) {
     };
 }
 exports.loadFirebaseEnvs = loadFirebaseEnvs;
+function writeResolvedParams(resolvedEnvs, userEnvs, userEnvOpt) {
+    const toWrite = {};
+    for (const paramName of Object.keys(resolvedEnvs)) {
+        const paramValue = resolvedEnvs[paramName];
+        if (!paramValue.internal && !Object.prototype.hasOwnProperty.call(userEnvs, paramName)) {
+            toWrite[paramName] = paramValue.toString();
+        }
+    }
+    writeUserEnvs(toWrite, userEnvOpt);
+}
+exports.writeResolvedParams = writeResolvedParams;

package/lib/functions/projectConfig.js

@@ -1,6 +1,17 @@
 "use strict";
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.configForCodebase = exports.normalizeAndValidate = exports.validate = exports.assertUnique = exports.validatePrefix = exports.validateCodebase = exports.normalize = exports.DEFAULT_CODEBASE = void 0;
+exports.resolveConfigDir = exports.requireLocal = exports.isRemoteConfig = exports.isLocalConfig = exports.configForCodebase = exports.normalizeAndValidate = exports.validate = exports.assertUnique = exports.validatePrefix = exports.validateCodebase = exports.normalize = exports.DEFAULT_CODEBASE = void 0;
 const error_1 = require("../error");
 exports.DEFAULT_CODEBASE = "default";
 function normalize(config) {
@@ -33,17 +44,33 @@ function validatePrefix(prefix) {
 }
 exports.validatePrefix = validatePrefix;
 function validateSingle(config) {
-    if (!config.source) {
-        throw new error_1.FirebaseError("codebase source must be specified");
+    const { source, remoteSource, runtime, codebase: providedCodebase } = config, rest = __rest(config, ["source", "remoteSource", "runtime", "codebase"]);
+    if (source && remoteSource) {
+        throw new error_1.FirebaseError("Cannot specify both 'source' and 'remoteSource' in a single functions config. Please choose one.");
     }
-    if (!config.codebase) {
-        config.codebase = exports.DEFAULT_CODEBASE;
+    if (!source && !remoteSource) {
+        throw new error_1.FirebaseError("codebase source must be specified. Must specify either 'source' or 'remoteSource' in a functions config.");
     }
-    validateCodebase(config.codebase);
+    const codebase = providedCodebase !== null && providedCodebase !== void 0 ? providedCodebase : exports.DEFAULT_CODEBASE;
+    validateCodebase(codebase);
     if (config.prefix) {
         validatePrefix(config.prefix);
     }
-    return Object.assign(Object.assign({}, config), { source: config.source, codebase: config.codebase });
+    const commonConfig = Object.assign({ codebase }, rest);
+    if (source) {
+        return Object.assign(Object.assign(Object.assign({}, commonConfig), { source }), (runtime ? { runtime } : {}));
+    }
+    else if (remoteSource) {
+        if (!remoteSource.repository || !remoteSource.ref) {
+            throw new error_1.FirebaseError("remoteSource requires 'repository' and 'ref' to be specified.");
+        }
+        if (!runtime) {
+            throw new error_1.FirebaseError("functions.runtime is required when using remoteSource in firebase.json.");
+        }
+        return Object.assign(Object.assign({}, commonConfig), { remoteSource,
+            runtime });
+    }
+    throw new error_1.FirebaseError("Invalid functions config.");
 }
 function assertUnique(config, property, propval) {
     const values = new Set();
@@ -63,9 +90,22 @@ function assertUniqueSourcePrefixPair(config) {
     var _a;
     const sourcePrefixPairs = new Set();
     for (const c of config) {
-        const key = JSON.stringify({ source: c.source, prefix: c.prefix || "" });
+        let sourceIdentifier;
+        let sourceDescription;
+        if (c.source) {
+            sourceIdentifier = c.source;
+            sourceDescription = `source directory ('${c.source}')`;
+        }
+        else if (c.remoteSource) {
+            sourceIdentifier = `remote:${c.remoteSource.repository}#${c.remoteSource.ref}@dir:${c.remoteSource.dir || "."}`;
+            sourceDescription = `remote source ('${c.remoteSource.repository}')`;
+        }
+        else {
+            continue;
+        }
+        const key = JSON.stringify({ source: sourceIdentifier, prefix: c.prefix || "" });
         if (sourcePrefixPairs.has(key)) {
-            throw new error_1.FirebaseError(`More than one functions config specifies the same source directory ('${c.source}') and prefix ('${(_a = c.prefix) !== null && _a !== void 0 ? _a : ""}'). Please add a unique 'prefix' to each function configuration that shares this source to resolve the conflict.`);
+            throw new error_1.FirebaseError(`More than one functions config specifies the same ${sourceDescription} and prefix ('${(_a = c.prefix) !== null && _a !== void 0 ? _a : ""}'). Please add a unique 'prefix' to each function configuration that shares this source to resolve the conflict.`);
         }
         sourcePrefixPairs.add(key);
     }
@@ -89,3 +129,23 @@ function configForCodebase(config, codebase) {
     return codebaseCfg;
 }
 exports.configForCodebase = configForCodebase;
+function isLocalConfig(c) {
+    return c.source !== undefined;
+}
+exports.isLocalConfig = isLocalConfig;
+function isRemoteConfig(c) {
+    return c.remoteSource !== undefined;
+}
+exports.isRemoteConfig = isRemoteConfig;
+function requireLocal(c, purpose) {
+    if (!isLocalConfig(c)) {
+        const msg = purpose !== null && purpose !== void 0 ? purpose : "This operation requires a local functions source directory, but the codebase is configured with a remote source.";
+        throw new error_1.FirebaseError(msg);
+    }
+    return c;
+}
+exports.requireLocal = requireLocal;
+function resolveConfigDir(c) {
+    return c.configDir || c.source;
+}
+exports.resolveConfigDir = resolveConfigDir;

package/lib/gcp/cloudfunctions.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.functionFromEndpoint = exports.endpointFromFunction = exports.listAllFunctions = exports.listFunctions = exports.deleteFunction = exports.updateFunction = exports.setInvokerUpdate = exports.setInvokerCreate = exports.getIamPolicy = exports.setIamPolicy = exports.createFunction = exports.generateUploadUrl = exports.captureRuntimeValidationError = exports.API_VERSION = void 0;
+exports.functionFromEndpoint = exports.endpointFromFunction = exports.listAllFunctions = exports.deleteFunction = exports.updateFunction = exports.setInvokerUpdate = exports.setInvokerCreate = exports.getIamPolicy = exports.setIamPolicy = exports.createFunction = exports.generateUploadUrl = exports.captureRuntimeValidationError = exports.API_VERSION = void 0;
 const clc = require("colorette");
 const error_1 = require("../error");
 const logger_1 = require("../logger");
@@ -200,11 +200,6 @@ async function list(projectId, region) {
         });
     }
 }
-async function listFunctions(projectId, region) {
-    const res = await list(projectId, region);
-    return res.functions;
-}
-exports.listFunctions = listFunctions;
 async function listAllFunctions(projectId) {
     return list(projectId, "-");
 }

package/lib/gcp/cloudfunctionsv2.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.endpointFromFunction = exports.functionFromEndpoint = exports.deleteFunction = exports.updateFunction = exports.listAllFunctions = exports.listFunctions = exports.getFunction = exports.createFunction = exports.generateUploadUrl = exports.API_VERSION = void 0;
+exports.endpointFromFunction = exports.functionFromEndpoint = exports.deleteFunction = exports.updateFunction = exports.listAllFunctions = exports.getFunction = exports.createFunction = exports.generateUploadUrl = exports.API_VERSION = void 0;
 const apiv2_1 = require("../apiv2");
 const error_1 = require("../error");
 const api_1 = require("../api");
@@ -84,14 +84,6 @@ async function getFunction(projectId, location, functionId) {
     return res.body;
 }
 exports.getFunction = getFunction;
-async function listFunctions(projectId, region) {
-    const res = await listFunctionsInternal(projectId, region);
-    if (res.unreachable.includes(region)) {
-        throw new error_1.FirebaseError(`Cloud Functions region ${region} is unavailable`);
-    }
-    return res.functions;
-}
-exports.listFunctions = listFunctions;
 async function listAllFunctions(projectId) {
     return await listFunctionsInternal(projectId, "-");
 }

package/lib/gcp/cloudsql/cloudsqladmin.js

@@ -151,7 +151,7 @@ async function deleteDatabase(projectId, instanceId, databaseId) {
     return res.body;
 }
 exports.deleteDatabase = deleteDatabase;
-async function createUser(projectId, instanceId, type, username, password) {
+async function createUser(projectId, instanceId, type, username, password, retryTimeout) {
     const maxRetries = 3;
     let retries = 0;
     while (true) {
@@ -180,7 +180,7 @@ async function createUser(projectId, instanceId, type, username, password) {
             if (builtinRoleNotReady(err.message) && retries < maxRetries) {
                 retries++;
                 await new Promise((resolve) => {
-                    setTimeout(resolve, 1000 * retries);
+                    setTimeout(resolve, retryTimeout !== null && retryTimeout !== void 0 ? retryTimeout : 1000 * retries);
                 });
             }
             else {

package/lib/init/features/dataconnect/create_app.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createNextApp = exports.createReactApp = void 0;
+exports.createFlutterApp = exports.createNextApp = exports.createReactApp = void 0;
 const child_process_1 = require("child_process");
 const clc = require("colorette");
 const utils_1 = require("../../../utils");
@@ -26,8 +26,13 @@ async function createNextApp(webAppId) {
     await executeCommand("npx", args);
 }
 exports.createNextApp = createNextApp;
+async function createFlutterApp(webAppId) {
+    const args = ["create", webAppId];
+    await executeCommand("flutter", args);
+}
+exports.createFlutterApp = createFlutterApp;
 async function executeCommand(command, args) {
-    (0, utils_1.logLabeledBullet)("dataconnect", `Running ${clc.bold(`${command} ${args.join(" ")}`)}`);
+    (0, utils_1.logLabeledBullet)("dataconnect", `> ${clc.bold(`${command} ${args.join(" ")}`)}`);
     return new Promise((resolve, reject) => {
         const childProcess = (0, child_process_1.spawn)(command, args, {
             stdio: "inherit",