firebase-tools 10.9.2 → 11.0.0

package/lib/commands/ext-uninstall.js

@@ -1,21 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const _ = require("lodash");
-const clc = require("cli-color");
-const ora = require("ora");
 const { marked } = require("marked");
 const TerminalRenderer = require("marked-terminal");
 const checkMinRequiredVersion_1 = require("../checkMinRequiredVersion");
 const command_1 = require("../command");
-const error_1 = require("../error");
-const projectUtils_1 = require("../projectUtils");
-const extensionsApi = require("../extensions/extensionsApi");
-const secretsUtils = require("../extensions/secretsUtils");
 const extensionsHelper_1 = require("../extensions/extensionsHelper");
-const prompt_1 = require("../prompt");
 const requirePermissions_1 = require("../requirePermissions");
-const utils = require("../utils");
-const logger_1 = require("../logger");
 const manifest = require("../extensions/manifest");
 marked.setOptions({
     renderer: new TerminalRenderer(),
@@ -23,91 +13,12 @@ marked.setOptions({
 exports.default = new command_1.Command("ext:uninstall <extensionInstanceId>")
     .description("uninstall an extension that is installed in your Firebase project by instance ID")
     .withForce()
-    .option("--local", "remove from firebase.json rather than directly uninstall from a Firebase project")
     .before(requirePermissions_1.requirePermissions, ["firebaseextensions.instances.delete"])
     .before(extensionsHelper_1.ensureExtensionsApiEnabled)
     .before(checkMinRequiredVersion_1.checkMinRequiredVersion, "extMinVersion")
     .before(extensionsHelper_1.diagnoseAndFixProject)
-    .action(async (instanceId, options) => {
-    if (options.local) {
-        const config = manifest.loadConfig(options);
-        manifest.removeFromManifest(instanceId, config);
-        manifest.showPreviewWarning();
-        return;
-    }
-    const projectId = (0, projectUtils_1.needProjectId)(options);
-    let instance;
-    try {
-        instance = await extensionsApi.getInstance(projectId, instanceId);
-    }
-    catch (err) {
-        if (err.status === 404) {
-            return utils.reject(`No extension instance ${instanceId} in project ${projectId}.`, {
-                exit: 1,
-            });
-        }
-        throw err;
-    }
-    if (_.get(instance, "config.source.spec.name") === "pubsub-stream-bigquery") {
-        return consoleUninstallOnly(projectId, instanceId);
-    }
-    if (!options.force) {
-        const serviceAccountMessage = `Uninstalling deletes the service account used by this extension instance:\n${clc.bold(instance.serviceAccountEmail)}\n\n`;
-        const managedSecrets = await secretsUtils.getManagedSecrets(instance);
-        const resourcesMessage = _.get(instance, "config.source.spec.resources", []).length
-            ? "Uninstalling deletes all extension resources created for this extension instance:\n" +
-                instance.config.source.spec.resources
-                    .map((resource) => clc.bold(`- ${extensionsHelper_1.resourceTypeToNiceName[resource.type] || resource.type}: ${resource.name} \n`))
-                    .join("") +
-                managedSecrets
-                    .map(secretsUtils.prettySecretName)
-                    .map((s) => clc.bold(`- Secret: ${s}\n`))
-                    .join("") +
-                "\n"
-            : "";
-        const artifactsMessage = `The following ${clc.bold("will not")} be deleted:\n` +
-            "Any artifacts (for example, stored images) created by this extension instance.\n" +
-            "Any other project resources with which this extension instance interacted.\n";
-        const extensionDeletionMessage = `Here's what will happen when you uninstall ${clc.bold(instanceId)} from project ${clc.bold(projectId)}. Be aware that this cannot be undone.\n\n` +
-            `${serviceAccountMessage}` +
-            `${resourcesMessage}` +
-            `${artifactsMessage}`;
-        logger_1.logger.info(extensionDeletionMessage);
-        const confirmedExtensionDeletion = await (0, prompt_1.promptOnce)({
-            type: "confirm",
-            default: true,
-            message: "Are you sure that you wish to uninstall this extension?",
-        });
-        if (!confirmedExtensionDeletion) {
-            return utils.reject("Command aborted.", { exit: 1 });
-        }
-    }
-    const spinner = ora(` ${clc.green.bold(extensionsHelper_1.logPrefix)}: uninstalling ${clc.bold(instanceId)}. This usually takes 1 to 2 minutes...`);
-    spinner.start();
-    try {
-        spinner.info();
-        spinner.text = ` ${clc.green.bold(extensionsHelper_1.logPrefix)}: deleting your extension instance's resources.`;
-        spinner.start();
-        await extensionsApi.deleteInstance(projectId, instanceId);
-        spinner.succeed(` ${clc.green.bold(extensionsHelper_1.logPrefix)}: deleted your extension instance's resources.`);
-    }
-    catch (err) {
-        if (spinner.isSpinning) {
-            spinner.fail();
-        }
-        if (err instanceof error_1.FirebaseError) {
-            throw err;
-        }
-        return utils.reject(`Error occurred uninstalling extension ${instanceId}`, { original: err });
-    }
-    utils.logLabeledSuccess(extensionsHelper_1.logPrefix, `uninstalled ${clc.bold(instanceId)}`);
-    manifest.showDeprecationWarning();
+    .action((instanceId, options) => {
+    const config = manifest.loadConfig(options);
+    manifest.removeFromManifest(instanceId, config);
+    manifest.showPostDeprecationNotice();
 });
-function consoleUninstallOnly(projectId, instanceId) {
-    const instanceURL = `https://console.firebase.google.com/project/${projectId}/extensions/instances/${instanceId}`;
-    const consoleUninstall = "This extension has additional uninstall checks that are not currently supported by the CLI, and can only be uninstalled through the Firebase Console. " +
-        `Please visit **[${instanceURL}](${instanceURL})** to uninstall this extension.`;
-    logger_1.logger.info("\n");
-    utils.logLabeledWarning(extensionsHelper_1.logPrefix, marked(consoleUninstall));
-    return Promise.resolve();
-}

package/lib/commands/ext-update.js

@@ -1,19 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const clc = require("cli-color");
-const _ = require("lodash");
 const { marked } = require("marked");
-const ora = require("ora");
 const TerminalRenderer = require("marked-terminal");
 const checkMinRequiredVersion_1 = require("../checkMinRequiredVersion");
 const command_1 = require("../command");
 const error_1 = require("../error");
-const billingMigrationHelper_1 = require("../extensions/billingMigrationHelper");
-const checkProjectBilling_1 = require("../extensions/checkProjectBilling");
-const cloudbilling_1 = require("../gcp/cloudbilling");
 const extensionsApi = require("../extensions/extensionsApi");
-const secretsUtils = require("../extensions/secretsUtils");
-const provisioningHelper = require("../extensions/provisioningHelper");
 const extensionsHelper_1 = require("../extensions/extensionsHelper");
 const paramHelper = require("../extensions/paramHelper");
 const updateHelper_1 = require("../extensions/updateHelper");
@@ -39,227 +32,71 @@ exports.default = new command_1.Command("ext:update <extensionInstanceId> [updat
     .before(checkMinRequiredVersion_1.checkMinRequiredVersion, "extMinVersion")
     .before(extensionsHelper_1.diagnoseAndFixProject)
     .withForce()
-    .option("--params <paramsFile>", "name of params variables file with .env format.")
-    .option("--local", "save the update to firebase.json rather than directly update an existing Extension instance on a Firebase project")
     .action(async (instanceId, updateSource, options) => {
-    var _a, _b;
-    if (options.local) {
-        const projectId = (0, projectUtils_1.getProjectId)(options);
-        const config = manifest.loadConfig(options);
-        const oldRefOrPath = manifest.getInstanceTarget(instanceId, config);
-        if ((0, extensionsHelper_1.isLocalPath)(oldRefOrPath)) {
-            throw new error_1.FirebaseError(`Updating an extension with local source is not neccessary. ` +
-                `Rerun "firebase deploy" or restart the emulator after making changes to your local extension source. ` +
-                `If you've edited the extension param spec, you can edit an extension instance's params ` +
-                `interactively by running "firebase ext:configure --local {instance-id}"`);
-        }
-        const oldRef = manifest.getInstanceRef(instanceId, config);
-        const oldExtensionVersion = await extensionsApi.getExtensionVersion(refs.toExtensionVersionRef(oldRef));
-        updateSource = (0, updateHelper_1.inferUpdateSource)(updateSource, refs.toExtensionRef(oldRef));
-        const newSourceOrigin = (0, extensionsHelper_1.getSourceOrigin)(updateSource);
-        if (![extensionsHelper_1.SourceOrigin.PUBLISHED_EXTENSION, extensionsHelper_1.SourceOrigin.PUBLISHED_EXTENSION_VERSION].includes(newSourceOrigin)) {
-            throw new error_1.FirebaseError(`Only updating to a published extension version is allowed`);
-        }
-        const newExtensionVersion = await extensionsApi.getExtensionVersion(updateSource);
-        if (oldExtensionVersion.ref === newExtensionVersion.ref) {
-            utils.logLabeledBullet(extensionsHelper_1.logPrefix, `${clc.bold(instanceId)} is already up to date. Its version is ${clc.bold(newExtensionVersion.ref)}.`);
-            return;
-        }
-        utils.logLabeledBullet(extensionsHelper_1.logPrefix, `Updating ${clc.bold(instanceId)} from version ${clc.bold(oldExtensionVersion.ref)} to version ${clc.bold(newExtensionVersion.ref)}.`);
-        if (!(await (0, extensionsHelper_1.confirm)({
-            nonInteractive: options.nonInteractive,
-            force: options.force,
-            default: false,
-        }))) {
-            utils.logLabeledBullet(extensionsHelper_1.logPrefix, "Update aborted.");
-            return;
-        }
-        const oldParamValues = manifest.readInstanceParam({
-            instanceId,
-            projectDir: config.projectDir,
-        });
-        const newParamBindingOptions = await paramHelper.getParamsForUpdate({
-            spec: oldExtensionVersion.spec,
-            newSpec: newExtensionVersion.spec,
-            currentParams: oldParamValues,
-            projectId,
-            paramsEnvPath: ((_a = options.params) !== null && _a !== void 0 ? _a : ""),
-            nonInteractive: options.nonInteractive,
-            instanceId,
-        });
-        const eventsConfig = newExtensionVersion.spec.events
-            ? await askUserForEventsConfig.askForEventsConfig(newExtensionVersion.spec.events, "${param:PROJECT_ID}", instanceId)
-            : undefined;
-        if (eventsConfig) {
-            newParamBindingOptions.EVENTARC_CHANNEL = { baseValue: eventsConfig.channel };
-            newParamBindingOptions.ALLOWED_EVENT_TYPES = {
-                baseValue: eventsConfig.allowedEventTypes.join(","),
-            };
-        }
-        await manifest.writeToManifest([
-            {
-                instanceId,
-                ref: refs.parse(newExtensionVersion.ref),
-                params: newParamBindingOptions,
-                extensionSpec: newExtensionVersion.spec,
-                extensionVersion: newExtensionVersion,
-            },
-        ], config, {
-            nonInteractive: options.nonInteractive,
-            force: true,
-        });
-        manifest.showPreviewWarning();
-        return;
+    const projectId = (0, projectUtils_1.getProjectId)(options);
+    const config = manifest.loadConfig(options);
+    const oldRefOrPath = manifest.getInstanceTarget(instanceId, config);
+    if ((0, extensionsHelper_1.isLocalPath)(oldRefOrPath)) {
+        throw new error_1.FirebaseError(`Updating an extension with local source is not neccessary. ` +
+            `Rerun "firebase deploy" or restart the emulator after making changes to your local extension source. ` +
+            `If you've edited the extension param spec, you can edit an extension instance's params ` +
+            `interactively by running "firebase ext:configure --local {instance-id}"`);
     }
-    const spinner = ora(`Updating ${clc.bold(instanceId)}. This usually takes 3 to 5 minutes...`);
-    try {
-        const projectId = (0, projectUtils_1.needProjectId)(options);
-        const existingInstance = await extensionsApi.getInstance(projectId, instanceId);
-        const existingSpec = existingInstance.config.source.spec;
-        if (existingInstance.config.source.state === "DELETED") {
-            throw new error_1.FirebaseError(`Instance '${clc.bold(instanceId)}' cannot be updated anymore because the underlying extension was unpublished from Firebase's registry of extensions. Going forward, you will only be able to re-configure or uninstall this instance.`);
-        }
-        const existingParams = existingInstance.config.params;
-        const existingSource = existingInstance.config.source.name;
-        if (existingInstance.config.extensionRef) {
-            updateSource = (0, updateHelper_1.inferUpdateSource)(updateSource, existingInstance.config.extensionRef);
-        }
-        let newSourceName;
-        const existingSourceOrigin = await (0, updateHelper_1.getExistingSourceOrigin)(projectId, instanceId, existingSpec.name, existingSource);
-        const newSourceOrigin = (0, extensionsHelper_1.getSourceOrigin)(updateSource);
-        const validUpdate = isValidUpdate(existingSourceOrigin, newSourceOrigin);
-        if (!validUpdate) {
-            throw new error_1.FirebaseError(`Cannot update from a(n) ${existingSourceOrigin} to a(n) ${newSourceOrigin}. Please provide a new source that is a(n) ${existingSourceOrigin} and try again.`);
-        }
-        switch (newSourceOrigin) {
-            case extensionsHelper_1.SourceOrigin.LOCAL:
-                if (previews_1.previews.extdev) {
-                    newSourceName = await (0, updateHelper_1.updateFromLocalSource)(projectId, instanceId, updateSource, existingSpec);
-                    break;
-                }
-            case extensionsHelper_1.SourceOrigin.URL:
-                if (previews_1.previews.extdev) {
-                    newSourceName = await (0, updateHelper_1.updateFromUrlSource)(projectId, instanceId, updateSource, existingSpec);
-                    break;
-                }
-            case extensionsHelper_1.SourceOrigin.PUBLISHED_EXTENSION_VERSION:
-                newSourceName = await (0, updateHelper_1.updateToVersionFromPublisherSource)(projectId, instanceId, updateSource, existingSpec);
-                break;
-            case extensionsHelper_1.SourceOrigin.PUBLISHED_EXTENSION:
-                newSourceName = await (0, updateHelper_1.updateFromPublisherSource)(projectId, instanceId, updateSource, existingSpec);
-                break;
-            default:
-                throw new error_1.FirebaseError(`Unknown source '${clc.bold(updateSource)}.'`);
-        }
-        if (!(await (0, extensionsHelper_1.confirm)({
-            nonInteractive: options.nonInteractive,
-            force: options.force,
-            default: true,
-        }))) {
-            throw new error_1.FirebaseError(`Update cancelled.`);
-        }
-        const newSource = await extensionsApi.getSource(newSourceName);
-        const newSpec = newSource.spec;
-        if (![extensionsHelper_1.SourceOrigin.LOCAL, extensionsHelper_1.SourceOrigin.URL].includes(newSourceOrigin) &&
-            existingSpec.version === newSpec.version) {
-            utils.logLabeledBullet(extensionsHelper_1.logPrefix, `${clc.bold(instanceId)} is already up to date. Its version is ${clc.bold(existingSpec.version)}.`);
-            const retry = await (0, extensionsHelper_1.confirm)({
-                nonInteractive: options.nonInteractive,
-                force: options.force,
-                default: false,
-            });
-            if (!retry) {
-                utils.logLabeledBullet(extensionsHelper_1.logPrefix, "Update aborted.");
-                return;
-            }
-        }
-        await (0, updateHelper_1.displayChanges)({
-            spec: existingSpec,
-            newSpec: newSpec,
-            nonInteractive: options.nonInteractive,
-            force: options.force,
-        });
-        await provisioningHelper.checkProductsProvisioned(projectId, newSpec);
-        const usesSecrets = secretsUtils.usesSecrets(newSpec);
-        if (newSpec.billingRequired || usesSecrets) {
-            const enabled = await (0, cloudbilling_1.checkBillingEnabled)(projectId);
-            (0, billingMigrationHelper_1.displayNode10UpdateBillingNotice)(existingSpec, newSpec);
-            if (!(await (0, extensionsHelper_1.confirm)({
-                nonInteractive: options.nonInteractive,
-                force: options.force,
-                default: true,
-            }))) {
-                throw new error_1.FirebaseError("Update cancelled.");
-            }
-            if (!enabled) {
-                if (!options.nonInteractive) {
-                    await (0, checkProjectBilling_1.enableBilling)(projectId);
-                }
-                else {
-                    throw new error_1.FirebaseError("The extension requires your project to be upgraded to the Blaze plan. " +
-                        "To run this command in non-interactive mode, first upgrade your project: " +
-                        marked(`https://console.cloud.google.com/billing/linkedaccount?project=${projectId}`));
-                }
-            }
-            if (usesSecrets) {
-                await secretsUtils.ensureSecretManagerApiEnabled(options);
-            }
-        }
-        const oldParamValues = Object.assign({}, existingParams);
-        const newParamBindings = await paramHelper.getParamsForUpdate({
-            spec: existingSpec,
-            newSpec,
-            currentParams: existingParams,
-            projectId,
-            paramsEnvPath: ((_b = options.params) !== null && _b !== void 0 ? _b : ""),
-            nonInteractive: options.nonInteractive,
-            instanceId,
-        });
-        const eventsConfig = newSpec.events
-            ? await askUserForEventsConfig.askForEventsConfig(newSpec.events, projectId, instanceId)
-            : undefined;
-        const newParams = paramHelper.getBaseParamBindings(newParamBindings);
-        spinner.start();
-        const updateOptions = {
-            projectId,
-            instanceId,
-            canEmitEvents: eventsConfig ? true : false,
-            eventarcChannel: eventsConfig === null || eventsConfig === void 0 ? void 0 : eventsConfig.channel,
-            allowedEventTypes: eventsConfig === null || eventsConfig === void 0 ? void 0 : eventsConfig.allowedEventTypes,
-        };
-        if (newSourceName.includes("publisher")) {
-            updateOptions.extRef = refs.toExtensionVersionRef(refs.parse(newSourceName));
-        }
-        else {
-            updateOptions.source = newSource;
-        }
-        if (!_.isEqual(newParams, oldParamValues)) {
-            updateOptions.params = newParams;
-        }
-        await (0, updateHelper_1.update)(updateOptions);
-        spinner.stop();
-        utils.logLabeledSuccess(extensionsHelper_1.logPrefix, `successfully updated ${clc.bold(instanceId)}.`);
-        utils.logLabeledBullet(extensionsHelper_1.logPrefix, marked(`You can view your updated instance in the Firebase console: ${utils.consoleUrl(projectId, `/extensions/instances/${instanceId}?tab=usage`)}`));
-        manifest.showDeprecationWarning();
+    const oldRef = manifest.getInstanceRef(instanceId, config);
+    const oldExtensionVersion = await extensionsApi.getExtensionVersion(refs.toExtensionVersionRef(oldRef));
+    updateSource = (0, updateHelper_1.inferUpdateSource)(updateSource, refs.toExtensionRef(oldRef));
+    const newSourceOrigin = (0, extensionsHelper_1.getSourceOrigin)(updateSource);
+    if (![extensionsHelper_1.SourceOrigin.PUBLISHED_EXTENSION, extensionsHelper_1.SourceOrigin.PUBLISHED_EXTENSION_VERSION].includes(newSourceOrigin)) {
+        throw new error_1.FirebaseError(`Only updating to a published extension version is allowed`);
     }
-    catch (err) {
-        if (spinner.isSpinning) {
-            spinner.fail();
-        }
-        if (!(err instanceof error_1.FirebaseError)) {
-            throw new error_1.FirebaseError(`Error occurred while updating the instance: ${err.message}`, {
-                original: err,
-            });
-        }
-        throw err;
+    const newExtensionVersion = await extensionsApi.getExtensionVersion(updateSource);
+    if (oldExtensionVersion.ref === newExtensionVersion.ref) {
+        utils.logLabeledBullet(extensionsHelper_1.logPrefix, `${clc.bold(instanceId)} is already up to date. Its version is ${clc.bold(newExtensionVersion.ref)}.`);
+        return;
     }
-});
-function isValidUpdate(existingSourceOrigin, newSourceOrigin) {
-    if (existingSourceOrigin === extensionsHelper_1.SourceOrigin.PUBLISHED_EXTENSION) {
-        return [extensionsHelper_1.SourceOrigin.PUBLISHED_EXTENSION, extensionsHelper_1.SourceOrigin.PUBLISHED_EXTENSION_VERSION].includes(newSourceOrigin);
+    utils.logLabeledBullet(extensionsHelper_1.logPrefix, `Updating ${clc.bold(instanceId)} from version ${clc.bold(oldExtensionVersion.ref)} to version ${clc.bold(newExtensionVersion.ref)}.`);
+    if (!(await (0, extensionsHelper_1.confirm)({
+        nonInteractive: options.nonInteractive,
+        force: options.force,
+        default: false,
+    }))) {
+        utils.logLabeledBullet(extensionsHelper_1.logPrefix, "Update aborted.");
+        return;
     }
-    else if (existingSourceOrigin === extensionsHelper_1.SourceOrigin.LOCAL) {
-        return [extensionsHelper_1.SourceOrigin.LOCAL, extensionsHelper_1.SourceOrigin.URL].includes(newSourceOrigin);
+    const oldParamValues = manifest.readInstanceParam({
+        instanceId,
+        projectDir: config.projectDir,
+    });
+    const newParamBindingOptions = await paramHelper.getParamsForUpdate({
+        spec: oldExtensionVersion.spec,
+        newSpec: newExtensionVersion.spec,
+        currentParams: oldParamValues,
+        projectId,
+        paramsEnvPath: "",
+        nonInteractive: options.nonInteractive,
+        instanceId,
+    });
+    const eventsConfig = newExtensionVersion.spec.events
+        ? await askUserForEventsConfig.askForEventsConfig(newExtensionVersion.spec.events, "${param:PROJECT_ID}", instanceId)
+        : undefined;
+    if (eventsConfig) {
+        newParamBindingOptions.EVENTARC_CHANNEL = { baseValue: eventsConfig.channel };
+        newParamBindingOptions.ALLOWED_EVENT_TYPES = {
+            baseValue: eventsConfig.allowedEventTypes.join(","),
+        };
     }
-    return false;
-}
+    await manifest.writeToManifest([
+        {
+            instanceId,
+            ref: refs.parse(newExtensionVersion.ref),
+            params: newParamBindingOptions,
+            extensionSpec: newExtensionVersion.spec,
+            extensionVersion: newExtensionVersion,
+        },
+    ], config, {
+        nonInteractive: options.nonInteractive,
+        force: true,
+    });
+    manifest.showPostDeprecationNotice();
+    return;
+});

package/lib/emulator/commandUtils.js

@@ -371,5 +371,5 @@ async function checkJavaSupported() {
     });
 }
 exports.checkJavaSupported = checkJavaSupported;
-exports.JAVA_DEPRECATION_WARNING = "Support for Java version <= 10 will be dropped soon in firebase-tools@11. " +
+exports.JAVA_DEPRECATION_WARNING = "firebase-tools no longer supports Java version before 11. " +
     "Please upgrade to Java version 11 or above to continue using the emulators.";

package/lib/emulator/controller.js

@@ -219,8 +219,8 @@ async function startAll(options, showUI = true) {
     const deprecationNotices = [];
     if (targets.some(downloadableEmulators_1.requiresJava)) {
         if (!(await commandUtils.checkJavaSupported())) {
-            utils.logLabeledWarning("emulators", commandUtils_1.JAVA_DEPRECATION_WARNING, "warn");
-            deprecationNotices.push(commandUtils_1.JAVA_DEPRECATION_WARNING);
+            utils.logLabeledError("emulators", commandUtils_1.JAVA_DEPRECATION_WARNING, "warn");
+            throw new error_1.FirebaseError(commandUtils_1.JAVA_DEPRECATION_WARNING);
         }
     }
     const hubLogger = emulatorLogger_1.EmulatorLogger.forEmulator(types_1.Emulators.HUB);

package/lib/emulator/downloadableEmulators.js

@@ -18,13 +18,13 @@ const EMULATOR_INSTANCE_KILL_TIMEOUT = 4000;
 const CACHE_DIR = process.env.FIREBASE_EMULATORS_PATH || path.join(os.homedir(), ".cache", "firebase", "emulators");
 exports.DownloadDetails = {
     database: {
-        downloadPath: path.join(CACHE_DIR, "firebase-database-emulator-v4.7.3.jar"),
-        version: "4.7.3",
+        downloadPath: path.join(CACHE_DIR, "firebase-database-emulator-v4.8.0.jar"),
+        version: "4.8.0",
         opts: {
             cacheDir: CACHE_DIR,
-            remoteUrl: "https://storage.googleapis.com/firebase-preview-drop/emulator/firebase-database-emulator-v4.7.3.jar",
-            expectedSize: 28862098,
-            expectedChecksum: "8f696f24ee89c937a789498a0c0e4899",
+            remoteUrl: "https://storage.googleapis.com/firebase-preview-drop/emulator/firebase-database-emulator-v4.8.0.jar",
+            expectedSize: 33676395,
+            expectedChecksum: "e5ae0085d9c88ed14b0bd9c25fe62916",
             namePrefix: "firebase-database-emulator",
         },
     },
@@ -164,7 +164,7 @@ const Commands = {
     },
     ui: {
         binary: "node",
-        args: [getExecPath(types_1.Emulators.UI)],
+        args: ["--dns-result-order=ipv4first", getExecPath(types_1.Emulators.UI)],
         optionalArgs: [],
         joinArgs: false,
     },

package/lib/emulator/extensionsEmulator.js

@@ -6,7 +6,7 @@ const os = require("os");
 const path = require("path");
 const clc = require("cli-color");
 const Table = require("cli-table");
-const child_process_1 = require("child_process");
+const spawn = require("cross-spawn");
 const planner = require("../deploy/extensions/planner");
 const error_1 = require("../error");
 const refs_1 = require("../extensions/refs");
@@ -110,16 +110,20 @@ class ExtensionsEmulator {
         return true;
     }
     installAndBuildSourceCode(sourceCodePath) {
-        const npmInstall = (0, child_process_1.spawnSync)("npm", ["--prefix", `/${sourceCodePath}/functions/`, "install"], {
+        this.logger.logLabeled("DEBUG", "Extensions", `Running "npm install" for ${sourceCodePath}`);
+        const npmInstall = spawn.sync("npm", ["--prefix", `/${sourceCodePath}/functions/`, "install"], {
             encoding: "utf8",
         });
         if (npmInstall.error) {
             throw npmInstall.error;
         }
-        const npmRunGCPBuild = (0, child_process_1.spawnSync)("npm", ["--prefix", `/${sourceCodePath}/functions/`, "run", "gcp-build"], { encoding: "utf8" });
+        this.logger.logLabeled("DEBUG", "Extensions", `Finished "npm install" for ${sourceCodePath}`);
+        this.logger.logLabeled("DEBUG", "Extensions", `Running "npm run gcp-build" for ${sourceCodePath}`);
+        const npmRunGCPBuild = spawn.sync("npm", ["--prefix", `/${sourceCodePath}/functions/`, "run", "gcp-build"], { encoding: "utf8" });
         if (npmRunGCPBuild.error) {
             throw npmRunGCPBuild.error;
         }
+        this.logger.logLabeled("DEBUG", "Extensions", `Finished "npm run gcp-build" for ${sourceCodePath}`);
     }
     async getExtensionBackends() {
         await this.readManifest();

package/lib/emulator/functionsEmulator.js

@@ -18,7 +18,6 @@ const constants_1 = require("./constants");
 const types_1 = require("./types");
 const chokidar = require("chokidar");
 const spawn = require("cross-spawn");
-const child_process_1 = require("child_process");
 const functionsEmulatorShared_1 = require("./functionsEmulatorShared");
 const registry_1 = require("./registry");
 const emulatorLogger_1 = require("./emulatorLogger");
@@ -605,7 +604,7 @@ class FunctionsEmulator {
         let localMajorVersion = "0";
         const localNodePath = path.join(backend.functionsDir, "node_modules/.bin/node");
         try {
-            const localNodeOutput = (0, child_process_1.spawnSync)(localNodePath, ["--version"]).stdout.toString();
+            const localNodeOutput = spawn.sync(localNodePath, ["--version"]).stdout.toString();
             localMajorVersion = localNodeOutput.slice(1).split(".")[0];
         }
         catch (err) {

package/lib/emulator/portUtils.js

@@ -3,8 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.waitForPortClosed = exports.checkPortOpen = exports.findAvailablePort = exports.suggestUnrestricted = exports.isRestricted = void 0;
 const pf = require("portfinder");
 const tcpport = require("tcp-port-used");
+const dns = require("dns");
 const error_1 = require("../error");
 const logger_1 = require("../logger");
+dns.setDefaultResultOrder("ipv4first");
 const RESTRICTED_PORTS = [
     1,
     7,

package/lib/emulator/storage/crc.js

@@ -25,6 +25,9 @@ function crc32c(bytes) {
 }
 exports.crc32c = crc32c;
 function crc32cToString(crc32cValue) {
+    if (typeof crc32cValue === "string") {
+        crc32cValue = Number(crc32cValue);
+    }
     return "----" + Buffer.from([crc32cValue]).toString("base64");
 }
 exports.crc32cToString = crc32cToString;

package/lib/emulator/storage/rules/runtime.js

@@ -115,7 +115,7 @@ class StorageRulesRuntime {
             }
         });
         (_b = this._childprocess.stdout) === null || _b === void 0 ? void 0 : _b.on("data", (buf) => {
-            const serializedRuntimeActionResponse = buf.toString("UTF8").trim();
+            const serializedRuntimeActionResponse = buf.toString("utf-8").trim();
             if (serializedRuntimeActionResponse !== "") {
                 let rap;
                 try {

package/lib/extensions/extensionsHelper.js

@@ -31,6 +31,7 @@ const utils_2 = require("../utils");
 const changelog_1 = require("./changelog");
 const getProjectNumber_1 = require("../getProjectNumber");
 const constants_1 = require("../emulator/constants");
+const planner_1 = require("../deploy/extensions/planner");
 var SpecParamType;
 (function (SpecParamType) {
     SpecParamType["SELECT"] = "select";
@@ -529,15 +530,13 @@ async function diagnoseAndFixProject(options) {
     }
 }
 exports.diagnoseAndFixProject = diagnoseAndFixProject;
-function canonicalizeRefInput(extensionName) {
+async function canonicalizeRefInput(extensionName) {
     if (extensionName.split("/").length < 2) {
         const [extensionID, version] = extensionName.split("@");
         extensionName = `firebase/${extensionID}@${version || "latest"}`;
     }
     const ref = refs.parse(extensionName);
-    if (!ref.version) {
-        extensionName = `${extensionName}@latest`;
-    }
-    return extensionName;
+    ref.version = await (0, planner_1.resolveVersion)(ref);
+    return refs.toExtensionVersionRef(ref);
 }
 exports.canonicalizeRefInput = canonicalizeRefInput;

package/lib/extensions/manifest.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.showPreviewWarning = exports.showDeprecationWarning = exports.readInstanceParam = exports.getInstanceRef = exports.getInstanceTarget = exports.instanceExists = exports.loadConfig = exports.removeFromManifest = exports.writeLocalSecrets = exports.writeToManifest = exports.ENV_DIRECTORY = void 0;
+exports.showPostDeprecationNotice = exports.readInstanceParam = exports.getInstanceRef = exports.getInstanceTarget = exports.instanceExists = exports.loadConfig = exports.removeFromManifest = exports.writeLocalSecrets = exports.writeToManifest = exports.ENV_DIRECTORY = void 0;
 const clc = require("cli-color");
 const path = require("path");
 const refs = require("./refs");
@@ -181,16 +181,10 @@ function readParamsFile(projectDir, fileName) {
     const params = (0, paramHelper_1.readEnvFile)(paramPath);
     return params;
 }
-function showDeprecationWarning() {
-    utils.logLabeledWarning(extensionsHelper_1.logPrefix, "The behavior of ext:install, ext:update, ext:configure, and ext:uninstall will change in firebase-tools@11.0.0. " +
+function showPostDeprecationNotice() {
+    utils.logLabeledBullet(extensionsHelper_1.logPrefix, "The behavior of ext:install, ext:update, ext:configure, and ext:uninstall has changed in firebase-tools@11.0.0. " +
         "Instead of deploying extensions directly, " +
         "changes to extension instances will be written to firebase.json and ./extensions/*.env. " +
-        `Then ${clc.bold("firebase deploy (--only extensions)")} will deploy the changes to your Firebase project. ` +
-        `To access this behavior now, pass the ${clc.bold("--local")} flag.`);
+        `Then ${clc.bold("firebase deploy (--only extensions)")} will deploy the changes to your Firebase project. See https://firebase.google.com/docs/extensions/manifest for more details.`);
 }
-exports.showDeprecationWarning = showDeprecationWarning;
-function showPreviewWarning() {
-    utils.logLabeledWarning(extensionsHelper_1.logPrefix, `See these changes in your Firebase Emulator by running "firebase emulators:start". ` +
-        `Run ${clc.bold("firebase deploy (--only extensions)")} to deploy the changes to your Firebase project. `);
-}
-exports.showPreviewWarning = showPreviewWarning;
+exports.showPostDeprecationNotice = showPostDeprecationNotice;

package/lib/firebaseConfigValidate.js

@@ -8,7 +8,7 @@ const ajv = new Ajv();
 let _VALIDATOR = undefined;
 function getValidator() {
     if (!_VALIDATOR) {
-        const schemaStr = fs.readFileSync(path.resolve(__dirname, "../schema/firebase-config.json"), "UTF-8");
+        const schemaStr = fs.readFileSync(path.resolve(__dirname, "../schema/firebase-config.json"), "utf-8");
         const schema = JSON.parse(schemaStr);
         _VALIDATOR = ajv.compile(schema);
     }