firebase-tools 9.16.6 → 9.20.0

package/lib/extensions/changelog.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseChangelog = exports.getLocalChangelog = exports.breakingChangesInUpdate = exports.displayReleaseNotes = exports.getReleaseNotesForUpdate = void 0;
+const clc = require("cli-color");
+const marked = require("marked");
+const path = require("path");
+const semver = require("semver");
+const TerminalRenderer = require("marked-terminal");
+const Table = require("cli-table");
+const extensionsApi_1 = require("./extensionsApi");
+const localHelper_1 = require("./localHelper");
+const logger_1 = require("../logger");
+const refs = require("./refs");
+const utils_1 = require("../utils");
+marked.setOptions({
+    renderer: new TerminalRenderer(),
+});
+const EXTENSIONS_CHANGELOG = "CHANGELOG.md";
+const VERSION_LINE_REGEX = /##.*(\d+\.\d+\.\d+).*/;
+async function getReleaseNotesForUpdate(args) {
+    const releaseNotes = {};
+    const filter = `id<="${args.toVersion}" AND id>"${args.fromVersion}"`;
+    const extensionVersions = await extensionsApi_1.listExtensionVersions(args.extensionRef, filter);
+    extensionVersions.sort((ev1, ev2) => {
+        return -semver.compare(ev1.spec.version, ev2.spec.version);
+    });
+    for (const extensionVersion of extensionVersions) {
+        if (extensionVersion.releaseNotes) {
+            const version = refs.parse(extensionVersion.ref).version;
+            releaseNotes[version] = extensionVersion.releaseNotes;
+        }
+    }
+    return releaseNotes;
+}
+exports.getReleaseNotesForUpdate = getReleaseNotesForUpdate;
+function displayReleaseNotes(releaseNotes, fromVersion) {
+    const versions = [fromVersion].concat(Object.keys(releaseNotes));
+    const breakingVersions = breakingChangesInUpdate(versions);
+    const table = new Table({ head: ["Version", "What's New"], style: { head: ["yellow", "bold"] } });
+    for (const [version, note] of Object.entries(releaseNotes)) {
+        if (breakingVersions.includes(version)) {
+            table.push([clc.yellow.bold(version), marked(note)]);
+        }
+        else {
+            table.push([version, marked(note)]);
+        }
+    }
+    logger_1.logger.info(clc.bold("What's new with this update:"));
+    if (breakingVersions.length) {
+        utils_1.logLabeledWarning("warning", "This is a major version update, which means it may contain breaking changes." +
+            " Read the release notes carefully before continuing with this update.");
+    }
+    logger_1.logger.info(table.toString());
+}
+exports.displayReleaseNotes = displayReleaseNotes;
+function breakingChangesInUpdate(versionsInUpdate) {
+    const breakingVersions = [];
+    const semvers = versionsInUpdate.map((v) => semver.parse(v)).sort(semver.compare);
+    for (let i = 1; i < semvers.length; i++) {
+        const hasMajorBump = semvers[i - 1].major < semvers[i].major;
+        const hasMinorBumpInPreview = semvers[i - 1].major == 0 && semvers[i].major == 0 && semvers[i - 1].minor < semvers[i].minor;
+        if (hasMajorBump || hasMinorBumpInPreview) {
+            breakingVersions.push(semvers[i].raw);
+        }
+    }
+    return breakingVersions;
+}
+exports.breakingChangesInUpdate = breakingChangesInUpdate;
+function getLocalChangelog(directory) {
+    const rawChangelog = localHelper_1.readFile(path.resolve(directory, EXTENSIONS_CHANGELOG));
+    return parseChangelog(rawChangelog);
+}
+exports.getLocalChangelog = getLocalChangelog;
+function parseChangelog(rawChangelog) {
+    const changelog = {};
+    let currentVersion = "";
+    for (const line of rawChangelog.split("\n")) {
+        const matches = line.match(VERSION_LINE_REGEX);
+        if (matches) {
+            currentVersion = matches[1];
+        }
+        else if (currentVersion) {
+            if (!changelog[currentVersion]) {
+                changelog[currentVersion] = line;
+            }
+            else {
+                changelog[currentVersion] += `\n${line}`;
+            }
+        }
+    }
+    return changelog;
+}
+exports.parseChangelog = parseChangelog;

package/lib/extensions/displayExtensionInfo.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.printSourceDownloadLink = exports.getConsent = exports.displayUpdateChangesRequiringConfirmation = exports.displayUpdateChangesNoInput = exports.displayExtInfo = void 0;
+exports.printSourceDownloadLink = exports.displayUpdateChangesRequiringConfirmation = exports.displayUpdateChangesNoInput = exports.displayExtInfo = void 0;
 const _ = require("lodash");
 const clc = require("cli-color");
 const marked = require("marked");
@@ -9,7 +9,6 @@ const utils = require("../utils");
 const extensionsHelper_1 = require("./extensionsHelper");
 const logger_1 = require("../logger");
 const error_1 = require("../error");
-const prompt_1 = require("../prompt");
 marked.setOptions({
     renderer: new TerminalRenderer(),
 });
@@ -47,7 +46,7 @@ function displayExtInfo(extensionName, publisher, spec, published = false) {
     }
 }
 exports.displayExtInfo = displayExtInfo;
-function displayUpdateChangesNoInput(spec, newSpec, isOfficial = true) {
+function displayUpdateChangesNoInput(spec, newSpec) {
     var _a, _b, _c, _d;
     const lines = [];
     if (spec.displayName !== newSpec.displayName) {
@@ -59,10 +58,8 @@ function displayUpdateChangesNoInput(spec, newSpec, isOfficial = true) {
     if (spec.description !== newSpec.description) {
         lines.push("", "**Description:**", deletionColor(`- ${spec.description}`), additionColor(`+ ${newSpec.description}`));
     }
-    if (!isOfficial) {
-        if (spec.sourceUrl !== newSpec.sourceUrl) {
-            lines.push("", "**Source code:**", deletionColor(`- ${spec.sourceUrl}`), additionColor(`+ ${newSpec.sourceUrl}`));
-        }
+    if (spec.sourceUrl !== newSpec.sourceUrl) {
+        lines.push("", "**Source code:**", deletionColor(`- ${spec.sourceUrl}`), additionColor(`+ ${newSpec.sourceUrl}`));
     }
     if (spec.billingRequired && !newSpec.billingRequired) {
         lines.push("", "**Billing is no longer required for this extension.**");
@@ -71,17 +68,22 @@ function displayUpdateChangesNoInput(spec, newSpec, isOfficial = true) {
     return lines;
 }
 exports.displayUpdateChangesNoInput = displayUpdateChangesNoInput;
-async function displayUpdateChangesRequiringConfirmation(spec, newSpec) {
-    if (spec.license !== newSpec.license) {
+async function displayUpdateChangesRequiringConfirmation(args) {
+    const equals = (a, b) => {
+        return _.isEqual(a, b);
+    };
+    if (args.spec.license !== args.newSpec.license) {
         const message = "\n" +
             "**License**\n" +
-            deletionColor(spec.license ? `- ${spec.license}\n` : "- None\n") +
-            additionColor(newSpec.license ? `+ ${newSpec.license}\n` : "+ None\n") +
-            "Do you wish to continue?";
-        await getConsent("license", marked(message));
+            deletionColor(args.spec.license ? `- ${args.spec.license}\n` : "- None\n") +
+            additionColor(args.newSpec.license ? `+ ${args.newSpec.license}\n` : "+ None\n");
+        logger_1.logger.info(message);
+        if (!(await extensionsHelper_1.confirm({ nonInteractive: args.nonInteractive, force: args.force, default: true }))) {
+            throw new error_1.FirebaseError("Unable to update this extension instance without explicit consent for the change to 'License'.");
+        }
     }
-    const apisDiffDeletions = _.differenceWith(spec.apis, _.get(newSpec, "apis", []), _.isEqual);
-    const apisDiffAdditions = _.differenceWith(newSpec.apis, _.get(spec, "apis", []), _.isEqual);
+    const apisDiffDeletions = _.differenceWith(args.spec.apis, _.get(args.newSpec, "apis", []), equals);
+    const apisDiffAdditions = _.differenceWith(args.newSpec.apis, _.get(args.spec, "apis", []), equals);
     if (apisDiffDeletions.length || apisDiffAdditions.length) {
         let message = "\n**APIs:**\n";
         apisDiffDeletions.forEach((api) => {
@@ -90,11 +92,13 @@ async function displayUpdateChangesRequiringConfirmation(spec, newSpec) {
         apisDiffAdditions.forEach((api) => {
             message += additionColor(`+ ${api.apiName} (${api.reason})\n`);
         });
-        message += "Do you wish to continue?";
-        await getConsent("apis", marked(message));
+        logger_1.logger.info(message);
+        if (!(await extensionsHelper_1.confirm({ nonInteractive: args.nonInteractive, force: args.force, default: true }))) {
+            throw new error_1.FirebaseError("Unable to update this extension instance without explicit consent for the change to 'APIs'.");
+        }
     }
-    const resourcesDiffDeletions = _.differenceWith(spec.resources, _.get(newSpec, "resources", []), compareResources);
-    const resourcesDiffAdditions = _.differenceWith(newSpec.resources, _.get(spec, "resources", []), compareResources);
+    const resourcesDiffDeletions = _.differenceWith(args.spec.resources, _.get(args.newSpec, "resources", []), compareResources);
+    const resourcesDiffAdditions = _.differenceWith(args.newSpec.resources, _.get(args.spec, "resources", []), compareResources);
     if (resourcesDiffDeletions.length || resourcesDiffAdditions.length) {
         let message = "\n**Resources:**\n";
         resourcesDiffDeletions.forEach((resource) => {
@@ -103,11 +107,13 @@ async function displayUpdateChangesRequiringConfirmation(spec, newSpec) {
         resourcesDiffAdditions.forEach((resource) => {
             message += additionColor(`+ ${getResourceReadableName(resource)}`);
         });
-        message += "Do you wish to continue?";
-        await getConsent("resources", marked(message));
+        logger_1.logger.info(message);
+        if (!(await extensionsHelper_1.confirm({ nonInteractive: args.nonInteractive, force: args.force, default: true }))) {
+            throw new error_1.FirebaseError("Unable to update this extension instance without explicit consent for the change to 'Resources'.");
+        }
     }
-    const rolesDiffDeletions = _.differenceWith(spec.roles, _.get(newSpec, "roles", []), _.isEqual);
-    const rolesDiffAdditions = _.differenceWith(newSpec.roles, _.get(spec, "roles", []), _.isEqual);
+    const rolesDiffDeletions = _.differenceWith(args.spec.roles, _.get(args.newSpec, "roles", []), equals);
+    const rolesDiffAdditions = _.differenceWith(args.newSpec.roles, _.get(args.spec, "roles", []), equals);
     if (rolesDiffDeletions.length || rolesDiffAdditions.length) {
         let message = "\n**Permissions:**\n";
         rolesDiffDeletions.forEach((role) => {
@@ -116,11 +122,16 @@ async function displayUpdateChangesRequiringConfirmation(spec, newSpec) {
         rolesDiffAdditions.forEach((role) => {
             message += additionColor(`+ ${role.role} (${role.reason})\n`);
         });
-        message += "Do you wish to continue?";
-        await getConsent("apis", marked(message));
+        logger_1.logger.info(message);
+        if (!(await extensionsHelper_1.confirm({ nonInteractive: args.nonInteractive, force: args.force, default: true }))) {
+            throw new error_1.FirebaseError("Unable to update this extension instance without explicit consent for the change to 'Permissions'.");
+        }
     }
-    if (!spec.billingRequired && newSpec.billingRequired) {
-        await getConsent("billingRequired", "Billing is now required for the new version of this extension. Would you like to continue?");
+    if (!args.spec.billingRequired && args.newSpec.billingRequired) {
+        logger_1.logger.info("Billing is now required for the new version of this extension.");
+        if (!(await extensionsHelper_1.confirm({ nonInteractive: args.nonInteractive, force: args.force, default: true }))) {
+            throw new error_1.FirebaseError("Unable to update this extension instance without explicit consent for the change to 'BillingRequired'.");
+        }
     }
 }
 exports.displayUpdateChangesRequiringConfirmation = displayUpdateChangesRequiringConfirmation;
@@ -132,17 +143,6 @@ function getResourceReadableName(resource) {
         ? `${resource.name} (Cloud Function): ${resource.description}\n`
         : `${resource.name} (${resource.type})\n`;
 }
-async function getConsent(field, message) {
-    const consent = await prompt_1.promptOnce({
-        type: "confirm",
-        message,
-        default: true,
-    });
-    if (!consent) {
-        throw new error_1.FirebaseError(`Without explicit consent for the change to ${field}, we cannot update this extension instance.`, { exit: 2 });
-    }
-}
-exports.getConsent = getConsent;
 function printSourceDownloadLink(sourceDownloadUri) {
     const sourceDownloadMsg = `Want to review the source code that will be installed? Download it here: ${sourceDownloadUri}`;
     utils.logBullet(marked(sourceDownloadMsg));

package/lib/extensions/emulator/optionsHelper.js

@@ -19,7 +19,7 @@ async function buildOptions(options) {
     options.extensionDir = extensionDir;
     const spec = await specHelper.readExtensionYaml(extensionDir);
     extensionsHelper.validateSpec(spec);
-    const params = await getParams(options, spec);
+    const params = getParams(options, spec);
     extensionsHelper.validateCommandLineParams(params, spec.params);
     const functionResources = specHelper.getFunctionResourcesWithParamSubstitution(spec, params);
     let testConfig;
@@ -35,9 +35,9 @@ async function buildOptions(options) {
     return options;
 }
 exports.buildOptions = buildOptions;
-async function getParams(options, extensionSpec) {
+function getParams(options, extensionSpec) {
     const projectId = projectUtils_1.needProjectId(options);
-    const userParams = await paramHelper.readParamsFile(options.testParams);
+    const userParams = paramHelper.readEnvFile(options.testParams);
     const autoParams = {
         PROJECT_ID: projectId,
         EXT_INSTANCE_ID: extensionSpec.name,

package/lib/extensions/emulator/triggerHelper.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.functionResourceToEmulatedTriggerDefintion = void 0;
 const _ = require("lodash");
-const constants_1 = require("../../emulator/constants");
+const functionsEmulatorShared_1 = require("../../emulator/functionsEmulatorShared");
 const emulatorLogger_1 = require("../../emulator/emulatorLogger");
 const types_1 = require("../../emulator/types");
 function functionResourceToEmulatedTriggerDefintion(resource) {
@@ -24,7 +24,7 @@ function functionResourceToEmulatedTriggerDefintion(resource) {
         etd.httpsTrigger = properties.httpsTrigger;
     }
     else if (properties.eventTrigger) {
-        properties.eventTrigger.service = getServiceFromEventType(properties.eventTrigger.eventType);
+        properties.eventTrigger.service = functionsEmulatorShared_1.getServiceFromEventType(properties.eventTrigger.eventType);
         etd.eventTrigger = properties.eventTrigger;
     }
     else {
@@ -33,33 +33,3 @@ function functionResourceToEmulatedTriggerDefintion(resource) {
     return etd;
 }
 exports.functionResourceToEmulatedTriggerDefintion = functionResourceToEmulatedTriggerDefintion;
-function getServiceFromEventType(eventType) {
-    if (eventType.includes("firestore")) {
-        return constants_1.Constants.SERVICE_FIRESTORE;
-    }
-    if (eventType.includes("database")) {
-        return constants_1.Constants.SERVICE_REALTIME_DATABASE;
-    }
-    if (eventType.includes("pubsub")) {
-        return constants_1.Constants.SERVICE_PUBSUB;
-    }
-    if (eventType.includes("storage")) {
-        return constants_1.Constants.SERVICE_STORAGE;
-    }
-    if (eventType.includes("analytics")) {
-        return constants_1.Constants.SERVICE_ANALYTICS;
-    }
-    if (eventType.includes("auth")) {
-        return constants_1.Constants.SERVICE_AUTH;
-    }
-    if (eventType.includes("crashlytics")) {
-        return constants_1.Constants.SERVICE_CRASHLYTICS;
-    }
-    if (eventType.includes("remoteconfig")) {
-        return constants_1.Constants.SERVICE_REMOTE_CONFIG;
-    }
-    if (eventType.includes("testing")) {
-        return constants_1.Constants.SERVICE_TEST_LAB;
-    }
-    return "";
-}

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;
@@ -266,14 +269,15 @@ async function listExtensions(publisherId) {
     return extensions;
 }
 exports.listExtensions = listExtensions;
-async function listExtensionVersions(ref) {
-    const { publisherId, extensionId } = parseRef(ref);
+async function listExtensionVersions(ref, filter) {
+    const { publisherId, extensionId } = refs.parse(ref);
     const extensionVersions = [];
     const getNextPage = async (pageToken) => {
         const res = await api.request("GET", `/${VERSION}/publishers/${publisherId}/extensions/${extensionId}/versions`, {
             auth: true,
             origin: api.extensionsOrigin,
             query: {
+                filter,
                 pageSize: PAGE_SIZE_MAX,
                 pageToken,
             },
@@ -298,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({
@@ -321,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,
@@ -335,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,
@@ -360,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,
         });
@@ -385,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;