firebase-tools 10.2.1 → 10.3.1

package/lib/commands/ext-install.js

@@ -27,9 +27,173 @@ const utils = require("../utils");
 const track_1 = require("../track");
 const logger_1 = require("../logger");
 const previews_1 = require("../previews");
+const manifest = require("../extensions/manifest");
+const paramHelper_1 = require("../extensions/paramHelper");
 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 paramBindingOptions = await paramHelper.getParams({
+        projectId,
+        paramSpecs: spec.params,
+        nonInteractive,
+        paramsEnvPath,
+        instanceId,
+    });
+    const params = (0, paramHelper_1.getBaseParamBindings)(paramBindingOptions);
+    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);
@@ -97,17 +261,19 @@ async function installExtension(options) {
         else {
             choice = "installNew";
         }
-        let params;
+        let paramBindingOptions;
+        let paramBindings;
         switch (choice) {
             case "installNew":
                 instanceId = await (0, extensionsHelper_1.promptForValidInstanceId)(`${instanceId}-${(0, utils_1.getRandomString)(4)}`);
-                params = await paramHelper.getParams({
+                paramBindingOptions = await paramHelper.getParams({
                     projectId,
                     paramSpecs: spec.params,
                     nonInteractive,
                     paramsEnvPath,
                     instanceId,
                 });
+                paramBindings = (0, paramHelper_1.getBaseParamBindings)(paramBindingOptions);
                 spinner.text = "Installing your extension instance. This usually takes 3 to 5 minutes...";
                 spinner.start();
                 await extensionsApi.createInstance({
@@ -115,20 +281,21 @@ async function installExtension(options) {
                     instanceId,
                     extensionSource: source,
                     extensionVersionRef: extVersion === null || extVersion === void 0 ? void 0 : extVersion.ref,
-                    params,
+                    params: paramBindings,
                 });
                 spinner.stop();
                 utils.logLabeledSuccess(extensionsHelper_1.logPrefix, `Successfully installed your instance of ${clc.bold(spec.displayName || spec.name)}! ` +
                     `Its Instance ID is ${clc.bold(instanceId)}.`);
                 break;
             case "updateExisting":
-                params = await paramHelper.getParams({
+                paramBindingOptions = await paramHelper.getParams({
                     projectId,
                     paramSpecs: spec.params,
                     nonInteractive,
                     paramsEnvPath,
                     instanceId,
                 });
+                paramBindings = (0, paramHelper_1.getBaseParamBindings)(paramBindingOptions);
                 spinner.text = "Updating your extension instance. This usually takes 3 to 5 minutes...";
                 spinner.start();
                 await (0, updateHelper_1.update)({
@@ -136,7 +303,7 @@ async function installExtension(options) {
                     instanceId,
                     source,
                     extRef: extVersion === null || extVersion === void 0 ? void 0 : extVersion.ref,
-                    params,
+                    params: paramBindings,
                 });
                 spinner.stop();
                 utils.logLabeledSuccess(extensionsHelper_1.logPrefix, `Successfully updated your instance of ${clc.bold(spec.displayName || spec.name)}! ` +
@@ -149,6 +316,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 +330,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;
-    }
-});

package/lib/commands/ext-uninstall.js

@@ -16,25 +16,25 @@ 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(),
 });
-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();
-}
 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 {
@@ -101,4 +101,13 @@ exports.default = new command_1.Command("ext:uninstall <extensionInstanceId>")
         return utils.reject(`Error occurred uninstalling extension ${instanceId}`, { original: err });
     }
     utils.logLabeledSuccess(extensionsHelper_1.logPrefix, `uninstalled ${clc.bold(instanceId)}`);
+    manifest.showDeprecationWarning();
 });
+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

@@ -22,18 +22,10 @@ const projectUtils_1 = require("../projectUtils");
 const requirePermissions_1 = require("../requirePermissions");
 const utils = require("../utils");
 const previews_1 = require("../previews");
+const manifest = require("../extensions/manifest");
 marked.setOptions({
     renderer: new TerminalRenderer(),
 });
-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);
-    }
-    else if (existingSourceOrigin === extensionsHelper_1.SourceOrigin.LOCAL) {
-        return [extensionsHelper_1.SourceOrigin.LOCAL, extensionsHelper_1.SourceOrigin.URL].includes(newSourceOrigin);
-    }
-    return false;
-}
 exports.default = new command_1.Command("ext:update <extensionInstanceId> [updateSource]")
     .description(previews_1.previews.extdev
     ? "update an existing extension instance to the latest version or from a local or URL source"
@@ -47,10 +39,62 @@ exports.default = new command_1.Command("ext:update <extensionInstanceId> [updat
     .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;
+    const projectId = (0, projectUtils_1.needProjectId)(options);
+    if (options.local) {
+        const config = manifest.loadConfig(options);
+        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 newParamBindings = paramHelper.getBaseParamBindings(newParamBindingOptions);
+        await manifest.writeToManifest([
+            {
+                instanceId,
+                ref: refs.parse(newExtensionVersion.ref),
+                params: newParamBindings,
+            },
+        ], config, {
+            nonInteractive: options.nonInteractive,
+            force: true,
+        });
+        manifest.showPreviewWarning();
+        return;
+    }
     const spinner = ora(`Updating ${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);
@@ -152,15 +196,16 @@ exports.default = new command_1.Command("ext:update <extensionInstanceId> [updat
             }
         }
         const oldParamValues = Object.assign({}, existingParams);
-        const newParams = await paramHelper.getParamsForUpdate({
+        const newParamBindings = await paramHelper.getParamsForUpdate({
             spec: existingSpec,
             newSpec,
             currentParams: existingParams,
             projectId,
-            paramsEnvPath: options.params,
+            paramsEnvPath: ((_b = options.params) !== null && _b !== void 0 ? _b : ""),
             nonInteractive: options.nonInteractive,
             instanceId,
         });
+        const newParams = paramHelper.getBaseParamBindings(newParamBindings);
         spinner.start();
         const updateOptions = {
             projectId,
@@ -179,6 +224,7 @@ exports.default = new command_1.Command("ext:update <extensionInstanceId> [updat
         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();
     }
     catch (err) {
         if (spinner.isSpinning) {
@@ -192,3 +238,12 @@ exports.default = new command_1.Command("ext:update <extensionInstanceId> [updat
         throw err;
     }
 });
+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);
+    }
+    else if (existingSourceOrigin === extensionsHelper_1.SourceOrigin.LOCAL) {
+        return [extensionsHelper_1.SourceOrigin.LOCAL, extensionsHelper_1.SourceOrigin.URL].includes(newSourceOrigin);
+    }
+    return false;
+}

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

@@ -96,7 +96,7 @@ exports.default = new command_1.Command("functions:config:export")
             throw new error_1.FirebaseError("Exceeded max attempts to fix invalid config keys.");
         }
         const errMsg = configExport.hydrateEnvs(pInfos, prefix);
-        if (errMsg.length == 0) {
+        if (errMsg.length === 0) {
             break;
         }
         prefix = await promptForPrefix(errMsg);

package/lib/commands/hosting-clone.js

@@ -32,8 +32,8 @@ exports.default = new command_1.Command("hosting:clone <source> <targetChannel>"
     if (sourceChannelId) {
         sourceChannelId = (0, api_1.normalizeName)(sourceChannelId);
     }
-    const equalSiteIds = sourceSiteId == targetSiteId;
-    const equalChannelIds = sourceChannelId == targetChannelId;
+    const equalSiteIds = sourceSiteId === targetSiteId;
+    const equalChannelIds = sourceChannelId === targetChannelId;
     if (equalSiteIds && equalChannelIds) {
         throw new error_1.FirebaseError(`Source and destination cannot be equal. Please pick a different source or desination.`);
     }
@@ -67,7 +67,7 @@ exports.default = new command_1.Command("hosting:clone <source> <targetChannel>"
         }
     }
     const currentTargetVersionName = (_d = (_c = tChannel.release) === null || _c === void 0 ? void 0 : _c.version) === null || _d === void 0 ? void 0 : _d.name;
-    if (equalSiteIds && sourceVersionName == currentTargetVersionName) {
+    if (equalSiteIds && sourceVersionName === currentTargetVersionName) {
         utils.logSuccess(`Channels ${(0, cli_color_1.bold)(sourceChannelId)} and ${(0, cli_color_1.bold)(targetChannel)} are serving identical versions. No need to clone.`);
         return;
     }

package/lib/commands/remoteconfig-get.js

@@ -15,7 +15,7 @@ const error_1 = require("../error");
 const tableHead = ["Entry Name", "Value"];
 const MAX_DISPLAY_ITEMS = 20;
 function checkValidOptionalNumber(versionNumber) {
-    if (!versionNumber || typeof Number(versionNumber) == "number") {
+    if (!versionNumber || typeof Number(versionNumber) === "number") {
         return versionNumber;
     }
     throw new error_1.FirebaseError(`Could not interpret "${versionNumber}" as a valid number.`);

package/lib/config.js

@@ -17,12 +17,12 @@ const logger_1 = require("./logger");
 const loadCJSON = require("./loadCJSON");
 const parseBoltRules = require("./parseBoltRules");
 class Config {
-    constructor(src, options) {
+    constructor(src, options = {}) {
         this.data = {};
         this.defaults = {};
         this.notes = {};
-        this.options = options || {};
-        this.projectDir = options.projectDir || (0, detectProjectRoot_1.detectProjectRoot)(options);
+        this.options = options;
+        this.projectDir = this.options.projectDir || (0, detectProjectRoot_1.detectProjectRoot)(this.options);
         this._src = src;
         if (this._src.firebase) {
             this.defaults.project = this._src.firebase;
@@ -144,6 +144,9 @@ class Config {
         fs.ensureFileSync(this.path(p));
         fs.writeFileSync(this.path(p), content, "utf8");
     }
+    deleteProjectFile(p) {
+        fs.removeSync(this.path(p));
+    }
     askWriteProjectFile(p, content, force) {
         const writeTo = this.path(p);
         let next;

package/lib/deploy/extensions/deploymentSummary.js

@@ -7,8 +7,8 @@ const humanReadable = (dep) => `${clc.bold(dep.instanceId)} (${dep.ref ? `${refs
 exports.humanReadable = humanReadable;
 const humanReadableUpdate = (from, to) => {
     var _a, _b, _c, _d, _e;
-    if (((_a = from.ref) === null || _a === void 0 ? void 0 : _a.publisherId) == ((_b = to.ref) === null || _b === void 0 ? void 0 : _b.publisherId) &&
-        ((_c = from.ref) === null || _c === void 0 ? void 0 : _c.extensionId) == ((_d = to.ref) === null || _d === void 0 ? void 0 : _d.extensionId)) {
+    if (((_a = from.ref) === null || _a === void 0 ? void 0 : _a.publisherId) === ((_b = to.ref) === null || _b === void 0 ? void 0 : _b.publisherId) &&
+        ((_c = from.ref) === null || _c === void 0 ? void 0 : _c.extensionId) === ((_d = to.ref) === null || _d === void 0 ? void 0 : _d.extensionId)) {
         return `\t${clc.bold(from.instanceId)} (${refs.toExtensionVersionRef(from.ref)} => ${(_e = to.ref) === null || _e === void 0 ? void 0 : _e.version})`;
     }
     else {
@@ -28,7 +28,7 @@ exports.createsSummary = createsSummary;
 function updatesSummary(toUpdate, have) {
     const instancesToUpdate = toUpdate
         .map((to) => {
-        const from = have.find((exists) => exists.instanceId == to.instanceId);
+        const from = have.find((exists) => exists.instanceId === to.instanceId);
         return humanReadableUpdate(from, to);
     })
         .join("\n");

package/lib/deploy/extensions/planner.js

@@ -2,12 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveVersion = exports.want = exports.have = exports.getExtension = exports.getExtensionVersion = void 0;
 const semver = require("semver");
-const error_1 = require("../../error");
 const extensionsApi = require("../../extensions/extensionsApi");
-const extensionsHelper_1 = require("../../extensions/extensionsHelper");
 const refs = require("../../extensions/refs");
-const params_1 = require("./params");
+const error_1 = require("../../error");
+const extensionsHelper_1 = require("../../extensions/extensionsHelper");
 const logger_1 = require("../../logger");
+const manifest_1 = require("../../extensions/manifest");
 async function getExtensionVersion(i) {
     if (!i.extensionVersion) {
         if (!i.ref) {
@@ -52,14 +52,15 @@ async function want(args) {
             const instanceId = e[0];
             const ref = refs.parse(e[1]);
             ref.version = await resolveVersion(ref);
-            const params = (0, params_1.readParams)({
+            const params = (0, manifest_1.readInstanceParam)({
                 projectDir: args.projectDir,
                 instanceId,
                 projectId: args.projectId,
                 projectNumber: args.projectNumber,
                 aliases: args.aliases,
+                checkLocal: args.emulatorMode,
             });
-            const autoPopulatedParams = await (0, extensionsHelper_1.getFirebaseProjectParams)(args.projectId);
+            const autoPopulatedParams = await (0, extensionsHelper_1.getFirebaseProjectParams)(args.projectId, args.emulatorMode);
             const subbedParams = (0, extensionsHelper_1.substituteParams)(params, autoPopulatedParams);
             instanceSpecs.push({
                 instanceId,
@@ -80,7 +81,7 @@ async function want(args) {
 }
 exports.want = want;
 async function resolveVersion(ref) {
-    if (!ref.version || ref.version == "latest") {
+    if (!ref.version || ref.version === "latest") {
         return "latest";
     }
     const extensionRef = refs.toExtensionRef(ref);

package/lib/deploy/extensions/tasks.js

@@ -5,7 +5,7 @@ const clc = require("cli-color");
 const extensionsApi = require("../../extensions/extensionsApi");
 const refs = require("../../extensions/refs");
 const utils = require("../../utils");
-const isRetryable = (err) => err.status == 429 || err.status == 409;
+const isRetryable = (err) => err.status === 429 || err.status === 409;
 function extensionsDeploymentHandler(errorHandler) {
     return async (task) => {
         var _a, _b, _c, _d;