firebase-tools 9.17.0 → 9.21.0

package/lib/extensions/extensionsApi.js

@@ -1,18 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseExtensionVersionName = exports.parseRef = exports.getExtension = exports.deleteExtension = exports.unpublishExtension = exports.publishExtensionVersion = exports.registerPublisherProfile = exports.listExtensionVersions = exports.listExtensions = exports.getExtensionVersion = exports.getSource = exports.createSource = exports.updateInstanceFromRegistry = exports.updateInstance = exports.configureInstance = exports.listInstances = exports.getInstance = exports.deleteInstance = exports.createInstanceFromExtensionVersion = exports.createInstanceFromSource = exports.createInstance = exports.ParamType = exports.Visibility = exports.RegistryLaunchStage = void 0;
-const semver = require("semver");
+exports.getExtension = exports.deleteExtension = exports.unpublishExtension = exports.publishExtensionVersion = exports.registerPublisherProfile = exports.listExtensionVersions = exports.listExtensions = exports.getExtensionVersion = exports.getSource = exports.createSource = exports.updateInstanceFromRegistry = exports.updateInstance = exports.configureInstance = exports.listInstances = exports.getInstance = exports.deleteInstance = exports.createInstance = exports.ParamType = exports.Visibility = exports.RegistryLaunchStage = void 0;
 const yaml = require("js-yaml");
 const _ = require("lodash");
 const clc = require("cli-color");
 const marked = require("marked");
 const api = require("../api");
+const refs = require("./refs");
 const logger_1 = require("../logger");
 const operationPoller = require("../operation-poller");
 const error_1 = require("../error");
 const VERSION = "v1beta";
 const PAGE_SIZE_MAX = 100;
-const refRegex = new RegExp(/^([^/@\n]+)\/{1}([^/@\n]+)(@{1}([a-z0-9.-]+)|)$/);
 var RegistryLaunchStage;
 (function (RegistryLaunchStage) {
     RegistryLaunchStage["EXPERIMENTAL"] = "EXPERIMENTAL";
@@ -31,8 +30,9 @@ var ParamType;
     ParamType["STRING"] = "STRING";
     ParamType["SELECT"] = "SELECT";
     ParamType["MULTISELECT"] = "MULTISELECT";
+    ParamType["SECRET"] = "SECRET";
 })(ParamType = exports.ParamType || (exports.ParamType = {}));
-async function createInstance(projectId, instanceId, config) {
+async function createInstanceHelper(projectId, instanceId, config) {
     const createRes = await api.request("POST", `/${VERSION}/projects/${projectId}/instances/`, {
         auth: true,
         origin: api.extensionsOrigin,
@@ -49,25 +49,28 @@ async function createInstance(projectId, instanceId, config) {
     });
     return pollRes;
 }
-exports.createInstance = createInstance;
-async function createInstanceFromSource(projectId, instanceId, extensionSource, params) {
-    const config = {
-        source: { name: extensionSource.name },
-        params,
-    };
-    return createInstance(projectId, instanceId, config);
-}
-exports.createInstanceFromSource = createInstanceFromSource;
-async function createInstanceFromExtensionVersion(projectId, instanceId, extensionVersion, params) {
-    const { publisherId, extensionId, version } = parseRef(extensionVersion.ref);
+async function createInstance(args) {
+    var _a, _b;
     const config = {
-        extensionRef: `${publisherId}/${extensionId}`,
-        extensionVersion: version || "",
-        params,
+        params: args.params,
     };
-    return createInstance(projectId, instanceId, config);
+    if (args.extensionSource && args.extensionVersionRef) {
+        throw new error_1.FirebaseError("ExtensionSource and ExtensionVersion both provided, but only one should be.");
+    }
+    else if (args.extensionSource) {
+        config.source = { name: (_a = args.extensionSource) === null || _a === void 0 ? void 0 : _a.name };
+    }
+    else if (args.extensionVersionRef) {
+        const ref = refs.parse(args.extensionVersionRef);
+        config.extensionRef = refs.toExtensionRef(ref);
+        config.extensionVersion = (_b = ref.version) !== null && _b !== void 0 ? _b : "";
+    }
+    else {
+        throw new error_1.FirebaseError("No ExtensionVersion or ExtensionSource provided but one is required.");
+    }
+    return createInstanceHelper(args.projectId, args.instanceId, config);
 }
-exports.createInstanceFromExtensionVersion = createInstanceFromExtensionVersion;
+exports.createInstance = createInstance;
 async function deleteInstance(projectId, instanceId) {
     const deleteRes = await api.request("DELETE", `/${VERSION}/projects/${projectId}/instances/${instanceId}`, {
         auth: true,
@@ -129,23 +132,23 @@ async function updateInstance(projectId, instanceId, extensionSource, params) {
     };
     let updateMask = "config.source.name";
     if (params) {
-        body.params = params;
+        body.config.params = params;
         updateMask += ",config.params";
     }
     return await patchInstance(projectId, instanceId, updateMask, body);
 }
 exports.updateInstance = updateInstance;
 async function updateInstanceFromRegistry(projectId, instanceId, extRef, params) {
-    const { publisherId, extensionId, version } = parseRef(extRef);
+    const ref = refs.parse(extRef);
     const body = {
         config: {
-            extensionRef: `${publisherId}/${extensionId}`,
-            extensionVersion: version,
+            extensionRef: refs.toExtensionRef(ref),
+            extensionVersion: ref.version,
         },
     };
     let updateMask = "config.extension_ref,config.extension_version";
     if (params) {
-        body.params = params;
+        body.config.params = params;
         updateMask += ",config.params";
     }
     return await patchInstance(projectId, instanceId, updateMask, body);
@@ -217,13 +220,13 @@ function getSource(sourceName) {
     });
 }
 exports.getSource = getSource;
-async function getExtensionVersion(ref) {
-    const { publisherId, extensionId, version } = parseRef(ref);
-    if (!version) {
-        throw new error_1.FirebaseError(`ExtensionVersion ref "${ref}" must supply a version.`);
+async function getExtensionVersion(extensionVersionRef) {
+    const ref = refs.parse(extensionVersionRef);
+    if (!ref.version) {
+        throw new error_1.FirebaseError(`ExtensionVersion ref "${extensionVersionRef}" must supply a version.`);
     }
     try {
-        const res = await api.request("GET", `/${VERSION}/publishers/${publisherId}/extensions/${extensionId}/versions/${version}`, {
+        const res = await api.request("GET", `/${VERSION}/${refs.toExtensionVersionName(ref)}`, {
             auth: true,
             origin: api.extensionsOrigin,
         });
@@ -234,12 +237,12 @@ async function getExtensionVersion(ref) {
     }
     catch (err) {
         if (err.status === 404) {
-            throw refNotFoundError(publisherId, extensionId, version);
+            throw refNotFoundError(ref);
         }
         else if (err instanceof error_1.FirebaseError) {
             throw err;
         }
-        throw new error_1.FirebaseError(`Failed to query the extension version '${clc.bold(ref)}': ${err}`);
+        throw new error_1.FirebaseError(`Failed to query the extension version '${clc.bold(extensionVersionRef)}': ${err}`);
     }
 }
 exports.getExtensionVersion = getExtensionVersion;
@@ -267,7 +270,7 @@ async function listExtensions(publisherId) {
 }
 exports.listExtensions = listExtensions;
 async function listExtensionVersions(ref, filter) {
-    const { publisherId, extensionId } = parseRef(ref);
+    const { publisherId, extensionId } = refs.parse(ref);
     const extensionVersions = [];
     const getNextPage = async (pageToken) => {
         const res = await api.request("GET", `/${VERSION}/publishers/${publisherId}/extensions/${extensionId}/versions`, {
@@ -299,18 +302,18 @@ async function registerPublisherProfile(projectId, publisherId) {
     return res.body;
 }
 exports.registerPublisherProfile = registerPublisherProfile;
-async function publishExtensionVersion(ref, packageUri, extensionRoot) {
-    const { publisherId, extensionId, version } = parseRef(ref);
-    if (!version) {
-        throw new error_1.FirebaseError(`ExtensionVersion ref "${ref}" must supply a version.`);
+async function publishExtensionVersion(extensionVersionRef, packageUri, extensionRoot) {
+    const ref = refs.parse(extensionVersionRef);
+    if (!ref.version) {
+        throw new error_1.FirebaseError(`ExtensionVersion ref "${extensionVersionRef}" must supply a version.`);
     }
-    const publishRes = await api.request("POST", `/${VERSION}/publishers/${publisherId}/extensions/${extensionId}/versions:publish`, {
+    const publishRes = await api.request("POST", `/${VERSION}/${refs.toExtensionName(ref)}/versions:publish`, {
         auth: true,
         origin: api.extensionsOrigin,
         data: {
-            versionId: version,
+            versionId: ref.version,
             packageUri,
-            extensionRoot: extensionRoot || "/",
+            extensionRoot: extensionRoot !== null && extensionRoot !== void 0 ? extensionRoot : "/",
         },
     });
     const pollRes = await operationPoller.pollOperation({
@@ -322,12 +325,12 @@ async function publishExtensionVersion(ref, packageUri, extensionRoot) {
     return pollRes;
 }
 exports.publishExtensionVersion = publishExtensionVersion;
-async function unpublishExtension(ref) {
-    const { publisherId, extensionId, version } = parseRef(ref);
-    if (version) {
-        throw new error_1.FirebaseError(`Extension reference "${ref}" must not contain a version.`);
+async function unpublishExtension(extensionRef) {
+    const ref = refs.parse(extensionRef);
+    if (ref.version) {
+        throw new error_1.FirebaseError(`Extension reference "${extensionRef}" must not contain a version.`);
     }
-    const url = `/${VERSION}/publishers/${publisherId}/extensions/${extensionId}:unpublish`;
+    const url = `/${VERSION}/${refs.toExtensionName(ref)}:unpublish`;
     try {
         await api.request("POST", url, {
             auth: true,
@@ -336,23 +339,23 @@ async function unpublishExtension(ref) {
     }
     catch (err) {
         if (err.status === 403) {
-            throw new error_1.FirebaseError(`You are not the owner of extension '${clc.bold(ref)}' and don’t have the correct permissions to unpublish this extension.`, { status: err.status });
+            throw new error_1.FirebaseError(`You are not the owner of extension '${clc.bold(extensionRef)}' and don’t have the correct permissions to unpublish this extension.`, { status: err.status });
         }
         else if (err instanceof error_1.FirebaseError) {
             throw err;
         }
-        throw new error_1.FirebaseError(`Error occurred unpublishing extension '${ref}': ${err}`, {
+        throw new error_1.FirebaseError(`Error occurred unpublishing extension '${extensionRef}': ${err}`, {
             status: err.status,
         });
     }
 }
 exports.unpublishExtension = unpublishExtension;
-async function deleteExtension(ref) {
-    const { publisherId, extensionId, version } = parseRef(ref);
-    if (version) {
-        throw new error_1.FirebaseError(`Extension reference "${ref}" must not contain a version.`);
+async function deleteExtension(extensionRef) {
+    const ref = refs.parse(extensionRef);
+    if (ref.version) {
+        throw new error_1.FirebaseError(`Extension reference "${extensionRef}" must not contain a version.`);
     }
-    const url = `/${VERSION}/publishers/${publisherId}/extensions/${extensionId}`;
+    const url = `/${VERSION}/${refs.toExtensionName(ref)}`;
     try {
         await api.request("DELETE", url, {
             auth: true,
@@ -361,24 +364,24 @@ async function deleteExtension(ref) {
     }
     catch (err) {
         if (err.status === 403) {
-            throw new error_1.FirebaseError(`You are not the owner of extension '${clc.bold(ref)}' and don’t have the correct permissions to delete this extension.`, { status: err.status });
+            throw new error_1.FirebaseError(`You are not the owner of extension '${clc.bold(extensionRef)}' and don’t have the correct permissions to delete this extension.`, { status: err.status });
         }
         else if (err.status === 404) {
-            throw new error_1.FirebaseError(`Extension ${clc.bold(ref)} was not found.`);
+            throw new error_1.FirebaseError(`Extension ${clc.bold(extensionRef)} was not found.`);
         }
         else if (err instanceof error_1.FirebaseError) {
             throw err;
         }
-        throw new error_1.FirebaseError(`Error occurred delete extension '${ref}': ${err}`, {
+        throw new error_1.FirebaseError(`Error occurred delete extension '${extensionRef}': ${err}`, {
             status: err.status,
         });
     }
 }
 exports.deleteExtension = deleteExtension;
-async function getExtension(ref) {
-    const { publisherId, extensionId } = parseRef(ref);
+async function getExtension(extensionRef) {
+    const ref = refs.parse(extensionRef);
     try {
-        const res = await api.request("GET", `/${VERSION}/publishers/${publisherId}/extensions/${extensionId}`, {
+        const res = await api.request("GET", `/${VERSION}/${refs.toExtensionName(ref)}`, {
             auth: true,
             origin: api.extensionsOrigin,
         });
@@ -386,50 +389,20 @@ async function getExtension(ref) {
     }
     catch (err) {
         if (err.status === 404) {
-            throw refNotFoundError(publisherId, extensionId);
+            throw refNotFoundError(ref);
         }
         else if (err instanceof error_1.FirebaseError) {
             throw err;
         }
-        throw new error_1.FirebaseError(`Failed to query the extension '${clc.bold(ref)}': ${err}`, {
+        throw new error_1.FirebaseError(`Failed to query the extension '${clc.bold(extensionRef)}': ${err}`, {
             status: err.status,
         });
     }
 }
 exports.getExtension = getExtension;
-function refNotFoundError(publisherId, extensionId, versionId) {
-    const versionRef = `${publisherId}/${extensionId}@${versionId}`;
-    const extensionRef = `${publisherId}/${extensionId}`;
-    return new error_1.FirebaseError(`The extension reference '${clc.bold(versionId ? versionRef : extensionRef)}' doesn't exist. This could happen for two reasons:\n` +
-        `  -The publisher ID '${clc.bold(publisherId)}' doesn't exist or could be misspelled\n` +
-        `  -The name of the ${versionId ? "extension version" : "extension"} '${clc.bold(versionId ? `${extensionId}@${versionId}` : extensionId)}' doesn't exist or could be misspelled\n\n` +
+function refNotFoundError(ref) {
+    return new error_1.FirebaseError(`The extension reference '${clc.bold(ref.version ? refs.toExtensionVersionRef(ref) : refs.toExtensionRef(ref))}' doesn't exist. This could happen for two reasons:\n` +
+        `  -The publisher ID '${clc.bold(ref.publisherId)}' doesn't exist or could be misspelled\n` +
+        `  -The name of the ${ref.version ? "extension version" : "extension"} '${clc.bold(ref.version ? `${ref.extensionId}@${ref.version}` : ref.extensionId)}' doesn't exist or could be misspelled\n\n` +
         `Please correct the extension reference and try again. If you meant to install an extension from a local source, please provide a relative path prefixed with '${clc.bold("./")}', '${clc.bold("../")}', or '${clc.bold("~/")}'. Learn more about local extension installation at ${marked("[https://firebase.google.com/docs/extensions/alpha/install-extensions_community#install](https://firebase.google.com/docs/extensions/alpha/install-extensions_community#install).")}`, { status: 404 });
 }
-function parseRef(ref) {
-    const parts = refRegex.exec(ref);
-    if (parts && (parts.length == 5 || parts.length == 7)) {
-        const publisherId = parts[1];
-        const extensionId = parts[2];
-        const version = parts[4];
-        if (version && !semver.valid(version) && version !== "latest") {
-            throw new error_1.FirebaseError(`Extension reference ${ref} contains an invalid version ${version}.`);
-        }
-        return { publisherId, extensionId, version };
-    }
-    throw new error_1.FirebaseError("Extension reference must be in format '{publisher}/{extension}(@{version})'.");
-}
-exports.parseRef = parseRef;
-function parseExtensionVersionName(extensionVersionName) {
-    const parts = extensionVersionName.split("/");
-    if (parts.length !== 6 ||
-        parts[0] !== "publishers" ||
-        parts[2] !== "extensions" ||
-        parts[4] !== "versions") {
-        throw new error_1.FirebaseError("Extension version name must be in the format `publishers/<publisherID>/extensions/<extensionID>/versions/<versionID>`.");
-    }
-    const publisherId = parts[1];
-    const extensionId = parts[3];
-    const version = parts[5];
-    return { publisherId, extensionId, version };
-}
-exports.parseExtensionVersionName = parseExtensionVersionName;

package/lib/extensions/extensionsHelper.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.confirmInstallInstance = exports.getSourceOrigin = exports.isLocalOrURLPath = exports.isLocalPath = exports.isUrlPath = exports.instanceIdExists = exports.promptForRepeatInstance = exports.promptForOfficialExtension = exports.confirmExtensionVersion = exports.getExtensionSourceFromName = exports.createSourceFromLocation = exports.publishExtensionVersionFromLocalSource = exports.ensureExtensionsApiEnabled = exports.promptForValidInstanceId = exports.validateSpec = exports.validateCommandLineParams = exports.populateDefaultParams = exports.substituteParams = exports.getFirebaseProjectParams = exports.getDBInstanceFromURL = exports.resourceTypeToNiceName = exports.AUTOPOULATED_PARAM_PLACEHOLDERS = exports.EXTENSIONS_BUCKET_NAME = exports.URL_REGEX = exports.logPrefix = exports.SourceOrigin = exports.SpecParamType = void 0;
+exports.confirm = exports.getSourceOrigin = exports.isLocalOrURLPath = exports.isLocalPath = exports.isUrlPath = exports.instanceIdExists = exports.promptForRepeatInstance = exports.promptForOfficialExtension = exports.displayReleaseNotes = exports.getExtensionSourceFromName = exports.createSourceFromLocation = exports.publishExtensionVersionFromLocalSource = exports.ensureExtensionsApiEnabled = exports.promptForValidInstanceId = exports.validateSpec = exports.validateCommandLineParams = exports.populateDefaultParams = exports.substituteParams = exports.getFirebaseProjectParams = exports.getDBInstanceFromURL = exports.resourceTypeToNiceName = exports.AUTOPOULATED_PARAM_PLACEHOLDERS = exports.EXTENSIONS_BUCKET_NAME = exports.URL_REGEX = exports.logPrefix = exports.SourceOrigin = exports.SpecParamType = void 0;
 const _ = require("lodash");
 const clc = require("cli-color");
 const ora = require("ora");
@@ -21,6 +21,7 @@ const ensureApiEnabled_1 = require("../ensureApiEnabled");
 const storage_1 = require("../gcp/storage");
 const projectUtils_1 = require("../projectUtils");
 const extensionsApi_1 = require("./extensionsApi");
+const refs = require("./refs");
 const localHelper_1 = require("./localHelper");
 const prompt_1 = require("../prompt");
 const logger_1 = require("../logger");
@@ -32,6 +33,7 @@ var SpecParamType;
     SpecParamType["MULTISELECT"] = "multiSelect";
     SpecParamType["STRING"] = "string";
     SpecParamType["SELECTRESOURCE"] = "selectResource";
+    SpecParamType["SECRET"] = "secret";
 })(SpecParamType = exports.SpecParamType || (exports.SpecParamType = {}));
 var SourceOrigin;
 (function (SourceOrigin) {
@@ -260,23 +262,23 @@ async function archiveAndUploadSource(extPath, bucketName) {
     const res = await storage_1.uploadObject(zippedSource, bucketName);
     return `/${res.bucket}/${res.object}`;
 }
-async function publishExtensionVersionFromLocalSource(publisherId, extensionId, rootDirectory) {
-    const extensionSpec = await localHelper_1.getLocalExtensionSpec(rootDirectory);
-    if (extensionSpec.name != extensionId) {
-        throw new error_1.FirebaseError(`Extension ID '${clc.bold(extensionId)}' does not match the name in extension.yaml '${clc.bold(extensionSpec.name)}'.`);
+async function publishExtensionVersionFromLocalSource(args) {
+    const extensionSpec = await localHelper_1.getLocalExtensionSpec(args.rootDirectory);
+    if (extensionSpec.name != args.extensionId) {
+        throw new error_1.FirebaseError(`Extension ID '${clc.bold(args.extensionId)}' does not match the name in extension.yaml '${clc.bold(extensionSpec.name)}'.`);
     }
     const subbedSpec = JSON.parse(JSON.stringify(extensionSpec));
     subbedSpec.params = substituteParams(extensionSpec.params || [], exports.AUTOPOULATED_PARAM_PLACEHOLDERS);
     validateSpec(subbedSpec);
     let extension;
     try {
-        extension = await extensionsApi_1.getExtension(`${publisherId}/${extensionId}`);
+        extension = await extensionsApi_1.getExtension(`${args.publisherId}/${args.extensionId}`);
     }
     catch (err) {
     }
     let notes;
     try {
-        const changes = changelog_1.getLocalChangelog(rootDirectory);
+        const changes = changelog_1.getLocalChangelog(args.rootDirectory);
         notes = changes[extensionSpec.version];
     }
     catch (err) {
@@ -289,27 +291,31 @@ async function publishExtensionVersionFromLocalSource(publisherId, extensionId,
             "Please add one so users know what has changed in this version. " +
             marked("See https://firebase.google.com/docs/extensions/alpha/create-user-docs#writing-changelog for more details."));
     }
-    const consent = await confirmExtensionVersion(publisherId, extensionId, extensionSpec.version, notes);
-    if (!consent) {
+    displayReleaseNotes(args.publisherId, args.extensionId, extensionSpec.version, notes);
+    if (!(await confirm({
+        nonInteractive: args.nonInteractive,
+        force: args.force,
+        default: false,
+    }))) {
         return;
     }
     if (extension &&
         extension.latestVersion &&
         semver.lt(extensionSpec.version, extension.latestVersion)) {
-        throw new error_1.FirebaseError(`The version you are trying to publish (${clc.bold(extensionSpec.version)}) is lower than the current version (${clc.bold(extension.latestVersion)}) for the extension '${clc.bold(`${publisherId}/${extensionId}`)}'. Please make sure this version is greater than the current version (${clc.bold(extension.latestVersion)}) inside of extension.yaml.\n`);
+        throw new error_1.FirebaseError(`The version you are trying to publish (${clc.bold(extensionSpec.version)}) is lower than the current version (${clc.bold(extension.latestVersion)}) for the extension '${clc.bold(`${args.publisherId}/${args.extensionId}`)}'. Please make sure this version is greater than the current version (${clc.bold(extension.latestVersion)}) inside of extension.yaml.\n`);
     }
     else if (extension &&
         extension.latestVersion &&
         semver.eq(extensionSpec.version, extension.latestVersion)) {
-        throw new error_1.FirebaseError(`The version you are trying to publish (${clc.bold(extensionSpec.version)}) already exists for the extension '${clc.bold(`${publisherId}/${extensionId}`)}'. Please increment the version inside of extension.yaml.\n`);
+        throw new error_1.FirebaseError(`The version you are trying to publish (${clc.bold(extensionSpec.version)}) already exists for the extension '${clc.bold(`${args.publisherId}/${args.extensionId}`)}'. Please increment the version inside of extension.yaml.\n`, { exit: 103 });
     }
-    const ref = `${publisherId}/${extensionId}@${extensionSpec.version}`;
+    const ref = `${args.publisherId}/${args.extensionId}@${extensionSpec.version}`;
     let packageUri;
     let objectPath = "";
     const uploadSpinner = ora.default(" Archiving and uploading extension source code");
     try {
         uploadSpinner.start();
-        objectPath = await archiveAndUploadSource(rootDirectory, exports.EXTENSIONS_BUCKET_NAME);
+        objectPath = await archiveAndUploadSource(args.rootDirectory, exports.EXTENSIONS_BUCKET_NAME);
         uploadSpinner.succeed(" Uploaded extension source code");
         packageUri = api_1.storageOrigin + objectPath + "?alt=media";
     }
@@ -327,7 +333,7 @@ async function publishExtensionVersionFromLocalSource(publisherId, extensionId,
     catch (err) {
         publishSpinner.fail();
         if (err.status == 404) {
-            throw new error_1.FirebaseError(marked(`Couldn't find publisher ID '${clc.bold(publisherId)}'. Please ensure that you have registered this ID. To register as a publisher, you can check out the [Firebase documentation](https://firebase.google.com/docs/extensions/alpha/share#register_as_an_extensions_publisher) for step-by-step instructions.`));
+            throw new error_1.FirebaseError(marked(`Couldn't find publisher ID '${clc.bold(args.publisherId)}'. Please ensure that you have registered this ID. To register as a publisher, you can check out the [Firebase documentation](https://firebase.google.com/docs/extensions/alpha/share#register_as_an_extensions_publisher) for step-by-step instructions.`));
         }
         throw err;
     }
@@ -389,20 +395,15 @@ async function getExtensionSourceFromName(extensionName) {
     throw new error_1.FirebaseError(`Could not find an extension named '${extensionName}'. `);
 }
 exports.getExtensionSourceFromName = getExtensionSourceFromName;
-async function confirmExtensionVersion(publisherId, extensionId, versionId, releaseNotes) {
+function displayReleaseNotes(publisherId, extensionId, versionId, releaseNotes) {
     const releaseNotesMessage = releaseNotes
         ? ` Release notes for this version:\n${marked(releaseNotes)}\n`
         : "\n";
     const message = `You are about to publish version ${clc.green(versionId)} of ${clc.green(`${publisherId}/${extensionId}`)} to Firebase's registry of extensions.${releaseNotesMessage}` +
-        "Once an extension version is published, it cannot be changed. If you wish to make changes after publishing, you will need to publish a new version.\n\n" +
-        "Do you wish to continue?";
-    return await prompt_1.promptOnce({
-        type: "confirm",
-        message,
-        default: false,
-    });
+        "Once an extension version is published, it cannot be changed. If you wish to make changes after publishing, you will need to publish a new version.\n\n";
+    logger_1.logger.info(message);
 }
-exports.confirmExtensionVersion = confirmExtensionVersion;
+exports.displayReleaseNotes = displayReleaseNotes;
 async function promptForOfficialExtension(message) {
     const officialExts = await resolveSource_1.getExtensionRegistry(true);
     return await prompt_1.promptOnce({
@@ -415,11 +416,16 @@ async function promptForOfficialExtension(message) {
 }
 exports.promptForOfficialExtension = promptForOfficialExtension;
 async function promptForRepeatInstance(projectName, extensionName) {
-    const message = `An extension with the ID '${clc.bold(extensionName)}' already exists in the project '${clc.bold(projectName)}'.\n` +
-        `Do you want to proceed with installing another instance of extension '${clc.bold(extensionName)}' in this project?`;
+    const message = `An extension with the ID '${clc.bold(extensionName)}' already exists in the project '${clc.bold(projectName)}'. What would you like to do?`;
+    const choices = [
+        { name: "Update or reconfigure the existing instance", value: "updateExisting" },
+        { name: "Install a new instance with a different ID", value: "installNew" },
+        { name: "Cancel extension installation", value: "cancel" },
+    ];
     return await prompt_1.promptOnce({
-        type: "confirm",
+        type: "list",
         message,
+        choices,
     });
 }
 exports.promptForRepeatInstance = promptForRepeatInstance;
@@ -467,7 +473,7 @@ function getSourceOrigin(sourceOrVersion) {
     if (sourceOrVersion.includes("/")) {
         let ref;
         try {
-            ref = extensionsApi_1.parseRef(sourceOrVersion);
+            ref = refs.parse(sourceOrVersion);
         }
         catch (err) {
         }
@@ -481,12 +487,20 @@ function getSourceOrigin(sourceOrVersion) {
     throw new error_1.FirebaseError(`Could not find source '${clc.bold(sourceOrVersion)}'. Check to make sure the source is correct, and then please try again.`);
 }
 exports.getSourceOrigin = getSourceOrigin;
-async function confirmInstallInstance(defaultOption) {
-    const message = `Would you like to continue installing this extension?`;
-    return await prompt_1.promptOnce({
-        type: "confirm",
-        message,
-        default: defaultOption,
-    });
+async function confirm(args) {
+    if (!args.nonInteractive && !args.force) {
+        const message = `Do you wish to continue?`;
+        return await prompt_1.promptOnce({
+            type: "confirm",
+            message,
+            default: args.default,
+        });
+    }
+    else if (args.nonInteractive && !args.force) {
+        throw new error_1.FirebaseError("Pass the --force flag to use this command in non-interactive mode");
+    }
+    else {
+        return true;
+    }
 }
-exports.confirmInstallInstance = confirmInstallInstance;
+exports.confirm = confirm;