firebase-tools 10.2.0 → 10.3.0

package/lib/apiv2.js

@@ -259,6 +259,9 @@ class Client {
                             }
                         }
                     }
+                    else if (options.responseType === "xml") {
+                        body = (await res.text());
+                    }
                     else if (options.responseType === "stream") {
                         body = res.body;
                     }

package/lib/appdistribution/options-parser-util.js

@@ -16,7 +16,7 @@ function getTestersOrGroups(value, file) {
 }
 exports.getTestersOrGroups = getTestersOrGroups;
 function getEmails(emails, file) {
-    if (emails.length == 0) {
+    if (emails.length === 0) {
         ensureFileExists(file);
         const readFile = fs.readFileSync(file, "utf8");
         return splitter(readFile);

package/lib/auth.js

@@ -291,7 +291,7 @@ async function loginRemotely(userHint) {
     });
     try {
         const tokens = await getTokensFromAuthorizationCode(code, `${api.authProxyOrigin}/complete`, codeVerifier);
-        (0, track_1.track)("login", "google_remote");
+        void (0, track_1.track)("login", "google_remote");
         return {
             user: jwt.decode(tokens.id_token),
             tokens: tokens,
@@ -307,7 +307,7 @@ async function loginWithLocalhostGoogle(port, userHint) {
     const authUrl = getLoginUrl(callbackUrl, userHint);
     const successTemplate = "../templates/loginSuccess.html";
     const tokens = await loginWithLocalhost(port, callbackUrl, authUrl, successTemplate, getTokensFromAuthorizationCode);
-    (0, track_1.track)("login", "google_localhost");
+    void (0, track_1.track)("login", "google_localhost");
     return {
         user: jwt.decode(tokens.id_token),
         tokens: tokens,
@@ -319,7 +319,7 @@ async function loginWithLocalhostGitHub(port) {
     const authUrl = getGithubLoginUrl(callbackUrl);
     const successTemplate = "../templates/loginSuccessGithub.html";
     const tokens = await loginWithLocalhost(port, callbackUrl, authUrl, successTemplate, getGithubTokensFromAuthorizationCode);
-    (0, track_1.track)("login", "google_localhost");
+    void (0, track_1.track)("login", "google_localhost");
     return tokens;
 }
 async function loginWithLocalhost(port, callbackUrl, authUrl, successTemplate, getTokens) {

package/lib/command.js

@@ -85,7 +85,7 @@ class Command {
                     }, null, 2));
                 }
                 const duration = new Date().getTime() - start;
-                track(this.name, "success", duration).then(() => process.exit());
+                void track(this.name, "success", duration).then(() => process.exit());
             })
                 .catch(async (err) => {
                 if ((0, utils_1.getInheritedOption)(options, "json")) {

package/lib/commands/apps-android-sha-create.js

@@ -9,9 +9,9 @@ const utils_1 = require("../utils");
 function getCertHashType(shaHash) {
     shaHash = shaHash.replace(/:/g, "");
     const shaHashCount = shaHash.length;
-    if (shaHashCount == 40)
+    if (shaHashCount === 40)
         return apps_1.ShaCertificateType.SHA_1.toString();
-    if (shaHashCount == 64)
+    if (shaHashCount === 64)
         return apps_1.ShaCertificateType.SHA_256.toString();
     return apps_1.ShaCertificateType.SHA_CERTIFICATE_TYPE_UNSPECIFIED.toString();
 }

package/lib/commands/apps-sdkconfig.js

@@ -70,7 +70,7 @@ module.exports = new command_1.Command("apps:sdkconfig [platform] [appId]")
     }
     spinner.succeed();
     const fileInfo = (0, apps_1.getAppConfigFile)(configData, appPlatform);
-    if (appPlatform == apps_1.AppPlatform.WEB) {
+    if (appPlatform === apps_1.AppPlatform.WEB) {
         fileInfo.sdkConfig = configData;
     }
     if (options.out === undefined) {

package/lib/commands/auth-import.js

@@ -93,7 +93,7 @@ module.exports = new command_1.Command("auth:import [dataFile]")
                     if (err) {
                         throw new error_1.FirebaseError(`Validation Error: ${err}`);
                     }
-                    currentBatch.push(user);
+                    currentBatch.push(value);
                     if (currentBatch.length === MAX_BATCH_SIZE) {
                         batches.push(currentBatch);
                         currentBatch = [];

package/lib/commands/database-rules-list.js

@@ -18,10 +18,10 @@ exports.default = new command_1.Command("database:rules:list")
     const rulesets = await metadata.listAllRulesets(options.instance);
     for (const ruleset of rulesets) {
         const labels = [];
-        if (ruleset.id == labeled.stable) {
+        if (ruleset.id === labeled.stable) {
             labels.push("stable");
         }
-        if (ruleset.id == labeled.canary) {
+        if (ruleset.id === labeled.canary) {
             labels.push("canary");
         }
         logger_1.logger.info(`${ruleset.id}  ${ruleset.createdAt}  ${labels.join(",")}`);

package/lib/commands/emulators-start.js

@@ -59,9 +59,9 @@ module.exports = new command_1.Command("emulators:start")
     emulatorsTable.push(...controller
         .filterEmulatorTargets(options)
         .map((emulator) => {
-        const info = registry_1.EmulatorRegistry.getInfo(emulator);
         const emulatorName = constants_1.Constants.description(emulator).replace(/ emulator/i, "");
         const isSupportedByUi = types_1.EMULATORS_SUPPORTED_BY_UI.includes(emulator);
+        const info = registry_1.EmulatorRegistry.getInfo(emulator === types_1.Emulators.EXTENSIONS ? types_1.Emulators.FUNCTIONS : emulator);
         if (!info) {
             return [emulatorName, "Failed to initialize (see above)", "", ""];
         }

package/lib/commands/ext-configure.js

@@ -15,6 +15,9 @@ const paramHelper = require("../extensions/paramHelper");
 const requirePermissions_1 = require("../requirePermissions");
 const utils = require("../utils");
 const logger_1 = require("../logger");
+const refs = require("../extensions/refs");
+const manifest = require("../extensions/manifest");
+const functional_1 = require("../functional");
 marked.setOptions({
     renderer: new TerminalRenderer(),
 });
@@ -22,6 +25,7 @@ exports.default = new command_1.Command("ext:configure <extensionInstanceId>")
     .description("configure an existing extension instance")
     .withForce()
     .option("--params <paramsFile>", "path of params file with .env format.")
+    .option("--local", "save to firebase.json rather than directly install to a Firebase project")
     .before(requirePermissions_1.requirePermissions, [
     "firebaseextensions.instances.update",
     "firebaseextensions.instances.get",
@@ -29,9 +33,46 @@ exports.default = new command_1.Command("ext:configure <extensionInstanceId>")
     .before(checkMinRequiredVersion_1.checkMinRequiredVersion, "extMinVersion")
     .before(extensionsHelper_1.diagnoseAndFixProject)
     .action(async (instanceId, options) => {
+    var _a;
+    const projectId = (0, projectUtils_1.needProjectId)(options);
+    if (options.local) {
+        if (options.nonInteractive) {
+            throw new error_1.FirebaseError(`Command not supported in non-interactive mode, edit ./extensions/${instanceId}.env directly instead`);
+        }
+        const config = manifest.loadConfig(options);
+        const targetRef = manifest.getInstanceRef(instanceId, config);
+        const extensionVersion = await extensionsApi.getExtensionVersion(refs.toExtensionVersionRef(targetRef));
+        const oldParamValues = manifest.readInstanceParam({
+            instanceId,
+            projectDir: config.projectDir,
+        });
+        const [immutableParams, tbdParams] = (0, functional_1.partition)(extensionVersion.spec.params, (param) => { var _a; return (_a = param.immutable) !== null && _a !== void 0 ? _a : false; });
+        infoImmutableParams(immutableParams, oldParamValues);
+        paramHelper.setNewDefaults(tbdParams, oldParamValues);
+        const mutableParamsValues = await paramHelper.getParams({
+            projectId,
+            paramSpecs: tbdParams,
+            nonInteractive: false,
+            paramsEnvPath: ((_a = options.params) !== null && _a !== void 0 ? _a : ""),
+            instanceId,
+            reconfiguring: true,
+        });
+        const newParamValues = Object.assign(Object.assign({}, oldParamValues), mutableParamsValues);
+        await manifest.writeToManifest([
+            {
+                instanceId,
+                ref: targetRef,
+                params: newParamValues,
+            },
+        ], config, {
+            nonInteractive: false,
+            force: true,
+        });
+        manifest.showPreviewWarning();
+        return;
+    }
     const spinner = ora(`Configuring ${clc.bold(instanceId)}. This usually takes 3 to 5 minutes...`);
     try {
-        const projectId = (0, projectUtils_1.needProjectId)(options);
         let existingInstance;
         try {
             existingInstance = await extensionsApi.getInstance(projectId, instanceId);
@@ -45,9 +86,7 @@ exports.default = new command_1.Command("ext:configure <extensionInstanceId>")
             throw err;
         }
         const paramSpecWithNewDefaults = paramHelper.getParamsWithCurrentValuesAsDefaults(existingInstance);
-        const immutableParams = _.remove(paramSpecWithNewDefaults, (param) => {
-            return param.immutable || param.param === "LOCATION";
-        });
+        const immutableParams = _.remove(paramSpecWithNewDefaults, (param) => param.immutable);
         const params = await paramHelper.getParams({
             projectId,
             paramSpecs: paramSpecWithNewDefaults,
@@ -74,6 +113,7 @@ exports.default = new command_1.Command("ext:configure <extensionInstanceId>")
         spinner.stop();
         utils.logLabeledSuccess(extensionsHelper_1.logPrefix, `successfully configured ${clc.bold(instanceId)}.`);
         utils.logLabeledBullet(extensionsHelper_1.logPrefix, marked(`You can view your reconfigured instance in the Firebase console: ${utils.consoleUrl(projectId, `/extensions/instances/${instanceId}?tab=config`)}`));
+        manifest.showDeprecationWarning();
         return res;
     }
     catch (err) {
@@ -88,3 +128,17 @@ exports.default = new command_1.Command("ext:configure <extensionInstanceId>")
         throw err;
     }
 });
+function infoImmutableParams(immutableParams, paramValues) {
+    if (!immutableParams.length) {
+        return;
+    }
+    const plural = immutableParams.length > 1;
+    utils.logLabeledWarning(extensionsHelper_1.logPrefix, marked(`The following param${plural ? "s are" : " is"} immutable and won't be changed:`));
+    for (const { param } of immutableParams) {
+        logger_1.logger.info(`param: ${param}, value: ${paramValues[param]}`);
+    }
+    logger_1.logger.info((plural
+        ? "To set different values for these params"
+        : "To set a different value for this param") +
+        ", uninstall the extension, then install a new instance of this extension.");
+}

package/lib/commands/ext-dev-init.js

@@ -24,6 +24,55 @@ function readCommonTemplates() {
         changelogTemplate: fs.readFileSync(path.join(TEMPLATE_ROOT, "CHANGELOG.md"), "utf8"),
     };
 }
+exports.default = new command_1.Command("ext:dev:init")
+    .description("initialize files for writing an extension in the current directory")
+    .before(checkMinRequiredVersion_1.checkMinRequiredVersion, "extDevMinVersion")
+    .action(async (options) => {
+    const cwd = options.cwd || process.cwd();
+    const config = new config_1.Config({}, { projectDir: cwd, cwd: cwd });
+    try {
+        const lang = await (0, prompt_1.promptOnce)({
+            type: "list",
+            name: "language",
+            message: "In which language do you want to write the Cloud Functions for your extension?",
+            default: "javascript",
+            choices: [
+                {
+                    name: "JavaScript",
+                    value: "javascript",
+                },
+                {
+                    name: "TypeScript",
+                    value: "typescript",
+                },
+            ],
+        });
+        switch (lang) {
+            case "javascript": {
+                await javascriptSelected(config);
+                break;
+            }
+            case "typescript": {
+                await typescriptSelected(config);
+                break;
+            }
+            default: {
+                throw new error_1.FirebaseError(`${lang} is not supported.`);
+            }
+        }
+        await npmDependencies.askInstallDependencies({}, config);
+        const welcome = fs.readFileSync(path.join(TEMPLATE_ROOT, lang, "WELCOME.md"), "utf8");
+        return logger_1.logger.info("\n" + marked(welcome));
+    }
+    catch (err) {
+        if (!(err instanceof error_1.FirebaseError)) {
+            throw new error_1.FirebaseError(`Error occurred when initializing files for new extension: ${err.message}`, {
+                original: err,
+            });
+        }
+        throw err;
+    }
+});
 async function typescriptSelected(config) {
     const packageLintingTemplate = fs.readFileSync(path.join(TEMPLATE_ROOT, "typescript", "package.lint.json"), "utf8");
     const packageNoLintingTemplate = fs.readFileSync(path.join(TEMPLATE_ROOT, "typescript", "package.nolint.json"), "utf8");
@@ -84,52 +133,3 @@ async function javascriptSelected(config) {
     }
     await config.askWriteProjectFile("functions/.gitignore", gitignoreTemplate);
 }
-exports.default = new command_1.Command("ext:dev:init")
-    .description("initialize files for writing an extension in the current directory")
-    .before(checkMinRequiredVersion_1.checkMinRequiredVersion, "extDevMinVersion")
-    .action(async (options) => {
-    const cwd = options.cwd || process.cwd();
-    const config = new config_1.Config({}, { projectDir: cwd, cwd: cwd });
-    try {
-        const lang = await (0, prompt_1.promptOnce)({
-            type: "list",
-            name: "language",
-            message: "In which language do you want to write the Cloud Functions for your extension?",
-            default: "javascript",
-            choices: [
-                {
-                    name: "JavaScript",
-                    value: "javascript",
-                },
-                {
-                    name: "TypeScript",
-                    value: "typescript",
-                },
-            ],
-        });
-        switch (lang) {
-            case "javascript": {
-                await javascriptSelected(config);
-                break;
-            }
-            case "typescript": {
-                await typescriptSelected(config);
-                break;
-            }
-            default: {
-                throw new error_1.FirebaseError(`${lang} is not supported.`);
-            }
-        }
-        await npmDependencies.askInstallDependencies({}, config);
-        const welcome = fs.readFileSync(path.join(TEMPLATE_ROOT, lang, "WELCOME.md"), "utf8");
-        return logger_1.logger.info("\n" + marked(welcome));
-    }
-    catch (err) {
-        if (!(err instanceof error_1.FirebaseError)) {
-            throw new error_1.FirebaseError(`Error occurred when initializing files for new extension: ${err.message}`, {
-                original: err,
-            });
-        }
-        throw err;
-    }
-});

package/lib/commands/ext-export.js

@@ -5,6 +5,7 @@ const command_1 = require("../command");
 const planner = require("../deploy/extensions/planner");
 const export_1 = require("../extensions/export");
 const extensionsHelper_1 = require("../extensions/extensionsHelper");
+const manifest = require("../extensions/manifest");
 const functional_1 = require("../functional");
 const getProjectNumber_1 = require("../getProjectNumber");
 const logger_1 = require("../logger");
@@ -24,7 +25,7 @@ module.exports = new command_1.Command("ext:export")
         const subbed = await (0, export_1.setSecretParamsToLatest)(i);
         return (0, export_1.parameterizeProject)(projectId, projectNumber, subbed);
     }));
-    if (have.length == 0) {
+    if (have.length === 0) {
         logger_1.logger.info(`No extension instances installed on ${projectId}, so there is nothing to export.`);
         return;
     }
@@ -40,5 +41,9 @@ module.exports = new command_1.Command("ext:export")
         logger_1.logger.info("Exiting. No changes made.");
         return;
     }
-    await (0, export_1.writeFiles)(withRef, options);
+    const existingConfig = manifest.loadConfig(options);
+    await manifest.writeToManifest(withRef, existingConfig, {
+        nonInteractive: options.nonInteractive,
+        force: options.force,
+    }, true);
 });

package/lib/commands/ext-install.js

@@ -27,9 +27,171 @@ const utils = require("../utils");
 const track_1 = require("../track");
 const logger_1 = require("../logger");
 const previews_1 = require("../previews");
+const manifest = require("../extensions/manifest");
 marked.setOptions({
     renderer: new TerminalRenderer(),
 });
+exports.default = new command_1.Command("ext:install [extensionName]")
+    .description("install an official extension if [extensionName] or [extensionName@version] is provided; " +
+    (previews_1.previews.extdev
+        ? "install a local extension if [localPathOrUrl] or [url#root] is provided; install a published extension (not authored by Firebase) if [publisherId/extensionId] is provided "
+        : "") +
+    "or run with `-i` to see all available extensions.")
+    .withForce()
+    .option("--params <paramsFile>", "name of params variables file with .env format.")
+    .option("--local", "save to firebase.json rather than directly install to a Firebase project")
+    .before(requirePermissions_1.requirePermissions, ["firebaseextensions.instances.create"])
+    .before(extensionsHelper_1.ensureExtensionsApiEnabled)
+    .before(checkMinRequiredVersion_1.checkMinRequiredVersion, "extMinVersion")
+    .before(extensionsHelper_1.diagnoseAndFixProject)
+    .action(async (extensionName, options) => {
+    var _a;
+    const projectId = (0, projectUtils_1.needProjectId)(options);
+    const paramsEnvPath = ((_a = options.params) !== null && _a !== void 0 ? _a : "");
+    let learnMore = false;
+    if (!extensionName) {
+        if (options.interactive) {
+            learnMore = true;
+            extensionName = await (0, extensionsHelper_1.promptForOfficialExtension)("Which official extension do you wish to install?\n" +
+                "  Select an extension, then press Enter to learn more.");
+        }
+        else {
+            throw new error_1.FirebaseError(`Unable to find published extension '${clc.bold(extensionName)}'. ` +
+                `Run ${clc.bold("firebase ext:install -i")} to select from the list of all available published extensions.`);
+        }
+    }
+    let source;
+    let extVersion;
+    if ((0, extensionsHelper_1.isUrlPath)(extensionName)) {
+        void (0, track_1.track)("Extension Install", "Install by url path", options.interactive ? 1 : 0);
+    }
+    if ((0, extensionsHelper_1.isLocalOrURLPath)(extensionName)) {
+        void (0, track_1.track)("Extension Install", "Install by Source", options.interactive ? 1 : 0);
+        if (options.local) {
+            throw new error_1.FirebaseError("Installing a local source locally is not supported yet, please use ext:dev:emulator commands");
+        }
+        source = await infoInstallBySource(projectId, extensionName);
+    }
+    else {
+        void (0, track_1.track)("Extension Install", "Install by Extension Ref", options.interactive ? 1 : 0);
+        extVersion = await infoInstallByReference(extensionName, options.interactive);
+    }
+    if (!(await (0, extensionsHelper_1.confirm)({
+        nonInteractive: options.nonInteractive,
+        force: options.force,
+        default: true,
+    }))) {
+        return;
+    }
+    if (!source && !extVersion) {
+        throw new error_1.FirebaseError("Could not find a source. Please specify a valid source to continue.");
+    }
+    const spec = (source === null || source === void 0 ? void 0 : source.spec) || (extVersion === null || extVersion === void 0 ? void 0 : extVersion.spec);
+    if (!spec) {
+        throw new error_1.FirebaseError(`Could not find the extension.yaml for extension '${clc.bold(extensionName)}'. Please make sure this is a valid extension and try again.`);
+    }
+    if (learnMore) {
+        utils.logLabeledBullet(extensionsHelper_1.logPrefix, `You selected: ${clc.bold(spec.displayName)}.\n` +
+            `${spec.description}\n` +
+            `View details: https://firebase.google.com/products/extensions/${spec.name}\n`);
+    }
+    if (options.local) {
+        try {
+            return installToManifest({
+                paramsEnvPath,
+                projectId,
+                extensionName,
+                source,
+                extVersion,
+                nonInteractive: options.nonInteractive,
+                force: options.force,
+            });
+        }
+        catch (err) {
+            if (!(err instanceof error_1.FirebaseError)) {
+                throw new error_1.FirebaseError(`Error occurred saving the extension to manifest: ${err.message}`, {
+                    original: err,
+                });
+            }
+            throw err;
+        }
+    }
+    try {
+        return installExtension({
+            paramsEnvPath,
+            projectId,
+            extensionName,
+            source,
+            extVersion,
+            nonInteractive: options.nonInteractive,
+            force: options.force,
+        });
+    }
+    catch (err) {
+        if (!(err instanceof error_1.FirebaseError)) {
+            throw new error_1.FirebaseError(`Error occurred installing the extension: ${err.message}`, {
+                original: err,
+            });
+        }
+        throw err;
+    }
+});
+async function infoInstallBySource(projectId, extensionName) {
+    let source;
+    try {
+        source = await (0, extensionsHelper_1.createSourceFromLocation)(projectId, extensionName);
+    }
+    catch (err) {
+        throw new error_1.FirebaseError(`Unable to find published extension '${clc.bold(extensionName)}', ` +
+            `and encountered the following error when trying to create an instance of extension '${clc.bold(extensionName)}':\n ${err.message}`);
+    }
+    (0, displayExtensionInfo_1.displayExtInfo)(extensionName, "", source.spec);
+    return source;
+}
+async function infoInstallByReference(extensionName, interactive) {
+    if (extensionName.split("/").length < 2) {
+        const [extensionID, version] = extensionName.split("@");
+        extensionName = `firebase/${extensionID}@${version || "latest"}`;
+    }
+    const ref = refs.parse(extensionName);
+    const extension = await extensionsApi.getExtension(refs.toExtensionRef(ref));
+    if (!ref.version) {
+        void (0, track_1.track)("Extension Install", "Install by Extension Version Ref", interactive ? 1 : 0);
+        extensionName = `${extensionName}@latest`;
+    }
+    const extVersion = await extensionsApi.getExtensionVersion(extensionName);
+    (0, displayExtensionInfo_1.displayExtInfo)(extensionName, ref.publisherId, extVersion.spec, true);
+    await (0, warnings_1.displayWarningPrompts)(ref.publisherId, extension.registryLaunchStage, extVersion);
+    return extVersion;
+}
+async function installToManifest(options) {
+    const { projectId, extensionName, extVersion, paramsEnvPath, nonInteractive, force } = options;
+    const spec = extVersion === null || extVersion === void 0 ? void 0 : extVersion.spec;
+    if (!spec) {
+        throw new error_1.FirebaseError(`Could not find the extension.yaml for ${extensionName}. Please make sure this is a valid extension and try again.`);
+    }
+    const config = manifest.loadConfig(options);
+    let instanceId = spec.name;
+    while (manifest.instanceExists(instanceId, config)) {
+        instanceId = await (0, extensionsHelper_1.promptForValidInstanceId)(`${spec.name}-${(0, utils_1.getRandomString)(4)}`);
+    }
+    const params = await paramHelper.getParams({
+        projectId,
+        paramSpecs: spec.params,
+        nonInteractive,
+        paramsEnvPath,
+        instanceId,
+    });
+    const ref = refs.parse(extVersion.ref);
+    await manifest.writeToManifest([
+        {
+            instanceId,
+            ref,
+            params,
+        },
+    ], config, { nonInteractive, force: force !== null && force !== void 0 ? force : false });
+    manifest.showPreviewWarning();
+}
 async function installExtension(options) {
     const { projectId, extensionName, source, extVersion, paramsEnvPath, nonInteractive, force } = options;
     const spec = (source === null || source === void 0 ? void 0 : source.spec) || (extVersion === null || extVersion === void 0 ? void 0 : extVersion.spec);
@@ -149,6 +311,7 @@ async function installExtension(options) {
             `which may include some required post-installation tasks: ${utils.consoleUrl(projectId, `/extensions/instances/${instanceId}?tab=usage`)}`));
         logger_1.logger.info(marked("You can run `firebase ext` to view available Firebase Extensions commands, " +
             "including those to update, reconfigure, or delete your installed extension."));
+        manifest.showDeprecationWarning();
     }
     catch (err) {
         if (spinner.isSpinning) {
@@ -162,107 +325,3 @@ async function installExtension(options) {
         });
     }
 }
-async function infoInstallBySource(projectId, extensionName) {
-    let source;
-    try {
-        source = await (0, extensionsHelper_1.createSourceFromLocation)(projectId, extensionName);
-    }
-    catch (err) {
-        throw new error_1.FirebaseError(`Unable to find published extension '${clc.bold(extensionName)}', ` +
-            `and encountered the following error when trying to create an instance of extension '${clc.bold(extensionName)}':\n ${err.message}`);
-    }
-    (0, displayExtensionInfo_1.displayExtInfo)(extensionName, "", source.spec);
-    return source;
-}
-async function infoInstallByReference(extensionName, interactive) {
-    if (extensionName.split("/").length < 2) {
-        const [extensionID, version] = extensionName.split("@");
-        extensionName = `firebase/${extensionID}@${version || "latest"}`;
-    }
-    const ref = refs.parse(extensionName);
-    const extension = await extensionsApi.getExtension(refs.toExtensionRef(ref));
-    if (!ref.version) {
-        (0, track_1.track)("Extension Install", "Install by Extension Version Ref", interactive ? 1 : 0);
-        extensionName = `${extensionName}@latest`;
-    }
-    const extVersion = await extensionsApi.getExtensionVersion(extensionName);
-    (0, displayExtensionInfo_1.displayExtInfo)(extensionName, ref.publisherId, extVersion.spec, true);
-    await (0, warnings_1.displayWarningPrompts)(ref.publisherId, extension.registryLaunchStage, extVersion);
-    return extVersion;
-}
-exports.default = new command_1.Command("ext:install [extensionName]")
-    .description("install an official extension if [extensionName] or [extensionName@version] is provided; " +
-    (previews_1.previews.extdev
-        ? "install a local extension if [localPathOrUrl] or [url#root] is provided; install a published extension (not authored by Firebase) if [publisherId/extensionId] is provided "
-        : "") +
-    "or run with `-i` to see all available extensions.")
-    .withForce()
-    .option("--params <paramsFile>", "name of params variables file with .env format.")
-    .before(requirePermissions_1.requirePermissions, ["firebaseextensions.instances.create"])
-    .before(extensionsHelper_1.ensureExtensionsApiEnabled)
-    .before(checkMinRequiredVersion_1.checkMinRequiredVersion, "extMinVersion")
-    .before(extensionsHelper_1.diagnoseAndFixProject)
-    .action(async (extensionName, options) => {
-    const projectId = (0, projectUtils_1.needProjectId)(options);
-    const paramsEnvPath = options.params;
-    let learnMore = false;
-    if (!extensionName) {
-        if (options.interactive) {
-            learnMore = true;
-            extensionName = await (0, extensionsHelper_1.promptForOfficialExtension)("Which official extension do you wish to install?\n" +
-                "  Select an extension, then press Enter to learn more.");
-        }
-        else {
-            throw new error_1.FirebaseError(`Unable to find published extension '${clc.bold(extensionName)}'. ` +
-                `Run ${clc.bold("firebase ext:install -i")} to select from the list of all available published extensions.`);
-        }
-    }
-    let source;
-    let extVersion;
-    if ((0, extensionsHelper_1.isLocalOrURLPath)(extensionName)) {
-        (0, track_1.track)("Extension Install", "Install by Source", options.interactive ? 1 : 0);
-        source = await infoInstallBySource(projectId, extensionName);
-    }
-    else {
-        (0, track_1.track)("Extension Install", "Install by Extension Ref", options.interactive ? 1 : 0);
-        extVersion = await infoInstallByReference(extensionName, options.interactive);
-    }
-    if (!(await (0, extensionsHelper_1.confirm)({
-        nonInteractive: options.nonInteractive,
-        force: options.force,
-        default: true,
-    }))) {
-        return;
-    }
-    if (!source && !extVersion) {
-        throw new error_1.FirebaseError("Could not find a source. Please specify a valid source to continue.");
-    }
-    const spec = (source === null || source === void 0 ? void 0 : source.spec) || (extVersion === null || extVersion === void 0 ? void 0 : extVersion.spec);
-    if (!spec) {
-        throw new error_1.FirebaseError(`Could not find the extension.yaml for extension '${clc.bold(extensionName)}'. Please make sure this is a valid extension and try again.`);
-    }
-    if (learnMore) {
-        utils.logLabeledBullet(extensionsHelper_1.logPrefix, `You selected: ${clc.bold(spec.displayName)}.\n` +
-            `${spec.description}\n` +
-            `View details: https://firebase.google.com/products/extensions/${spec.name}\n`);
-    }
-    try {
-        return installExtension({
-            paramsEnvPath,
-            projectId,
-            extensionName,
-            source,
-            extVersion,
-            nonInteractive: options.nonInteractive,
-            force: options.force,
-        });
-    }
-    catch (err) {
-        if (!(err instanceof error_1.FirebaseError)) {
-            throw new error_1.FirebaseError(`Error occurred installing the extension: ${err.message}`, {
-                original: err,
-            });
-        }
-        throw err;
-    }
-});