firebase-tools 9.21.0 → 9.22.0

package/lib/extensions/extensionsApi.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
+exports.getExtension = exports.deleteExtension = exports.unpublishExtension = exports.publishExtensionVersion = exports.undeprecateExtensionVersion = exports.deprecateExtensionVersion = 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");
@@ -32,7 +32,7 @@ var ParamType;
     ParamType["MULTISELECT"] = "MULTISELECT";
     ParamType["SECRET"] = "SECRET";
 })(ParamType = exports.ParamType || (exports.ParamType = {}));
-async function createInstanceHelper(projectId, instanceId, config) {
+async function createInstanceHelper(projectId, instanceId, config, validateOnly = false) {
     const createRes = await api.request("POST", `/${VERSION}/projects/${projectId}/instances/`, {
         auth: true,
         origin: api.extensionsOrigin,
@@ -40,7 +40,13 @@ async function createInstanceHelper(projectId, instanceId, config) {
             name: `projects/${projectId}/instances/${instanceId}`,
             config: config,
         },
+        query: {
+            validateOnly,
+        },
     });
+    if (validateOnly) {
+        return createRes;
+    }
     const pollRes = await operationPoller.pollOperation({
         apiOrigin: api.extensionsOrigin,
         apiVersion: VERSION,
@@ -68,7 +74,7 @@ async function createInstance(args) {
     else {
         throw new error_1.FirebaseError("No ExtensionVersion or ExtensionSource provided but one is required.");
     }
-    return createInstanceHelper(args.projectId, args.instanceId, config);
+    return createInstanceHelper(args.projectId, args.instanceId, config, args.validateOnly);
 }
 exports.createInstance = createInstance;
 async function deleteInstance(projectId, instanceId) {
@@ -115,31 +121,46 @@ async function listInstances(projectId) {
     return instances;
 }
 exports.listInstances = listInstances;
-async function configureInstance(projectId, instanceId, params) {
-    const res = await patchInstance(projectId, instanceId, "config.params", {
-        config: {
-            params,
+async function configureInstance(args) {
+    var _a;
+    const res = await patchInstance({
+        projectId: args.projectId,
+        instanceId: args.instanceId,
+        updateMask: "config.params",
+        validateOnly: (_a = args.validateOnly) !== null && _a !== void 0 ? _a : false,
+        data: {
+            config: {
+                params: args.params,
+            },
         },
     });
     return res;
 }
 exports.configureInstance = configureInstance;
-async function updateInstance(projectId, instanceId, extensionSource, params) {
+async function updateInstance(args) {
+    var _a;
     const body = {
         config: {
-            source: { name: extensionSource.name },
+            source: { name: args.extensionSource.name },
         },
     };
     let updateMask = "config.source.name";
-    if (params) {
-        body.config.params = params;
+    if (args.params) {
+        body.config.params = args.params;
         updateMask += ",config.params";
     }
-    return await patchInstance(projectId, instanceId, updateMask, body);
+    return await patchInstance({
+        projectId: args.projectId,
+        instanceId: args.instanceId,
+        updateMask,
+        validateOnly: (_a = args.validateOnly) !== null && _a !== void 0 ? _a : false,
+        data: body,
+    });
 }
 exports.updateInstance = updateInstance;
-async function updateInstanceFromRegistry(projectId, instanceId, extRef, params) {
-    const ref = refs.parse(extRef);
+async function updateInstanceFromRegistry(args) {
+    var _a;
+    const ref = refs.parse(args.extRef);
     const body = {
         config: {
             extensionRef: refs.toExtensionRef(ref),
@@ -147,22 +168,32 @@ async function updateInstanceFromRegistry(projectId, instanceId, extRef, params)
         },
     };
     let updateMask = "config.extension_ref,config.extension_version";
-    if (params) {
-        body.config.params = params;
+    if (args.params) {
+        body.config.params = args.params;
         updateMask += ",config.params";
     }
-    return await patchInstance(projectId, instanceId, updateMask, body);
+    return await patchInstance({
+        projectId: args.projectId,
+        instanceId: args.instanceId,
+        updateMask,
+        validateOnly: (_a = args.validateOnly) !== null && _a !== void 0 ? _a : false,
+        data: body,
+    });
 }
 exports.updateInstanceFromRegistry = updateInstanceFromRegistry;
-async function patchInstance(projectId, instanceId, updateMask, data) {
-    const updateRes = await api.request("PATCH", `/${VERSION}/projects/${projectId}/instances/${instanceId}`, {
+async function patchInstance(args) {
+    const updateRes = await api.request("PATCH", `/${VERSION}/projects/${args.projectId}/instances/${args.instanceId}`, {
         auth: true,
         origin: api.extensionsOrigin,
         query: {
-            updateMask,
+            updateMask: args.updateMask,
+            validateOnly: args.validateOnly,
         },
-        data,
+        data: args.data,
     });
+    if (args.validateOnly) {
+        return updateRes;
+    }
     const pollRes = await operationPoller.pollOperation({
         apiOrigin: api.extensionsOrigin,
         apiVersion: VERSION,
@@ -302,6 +333,57 @@ async function registerPublisherProfile(projectId, publisherId) {
     return res.body;
 }
 exports.registerPublisherProfile = registerPublisherProfile;
+async function deprecateExtensionVersion(extensionRef, deprecationMessage) {
+    const ref = refs.parse(extensionRef);
+    try {
+        const res = await api.request("POST", `/${VERSION}/${refs.toExtensionVersionName(ref)}:deprecate`, {
+            auth: true,
+            origin: api.extensionsOrigin,
+            data: { deprecationMessage },
+        });
+        return res.body;
+    }
+    catch (err) {
+        if (err.status === 403) {
+            throw new error_1.FirebaseError(`You are not the owner of extension '${clc.bold(extensionRef)}' and don’t have the correct permissions to deprecate this extension version.` + err, { status: err.status });
+        }
+        else if (err.status === 404) {
+            throw new error_1.FirebaseError(`Extension version ${clc.bold(extensionRef)} was not found.`);
+        }
+        else if (err instanceof error_1.FirebaseError) {
+            throw err;
+        }
+        throw new error_1.FirebaseError(`Error occurred deprecating extension version '${extensionRef}': ${err}`, {
+            status: err.status,
+        });
+    }
+}
+exports.deprecateExtensionVersion = deprecateExtensionVersion;
+async function undeprecateExtensionVersion(extensionRef) {
+    const ref = refs.parse(extensionRef);
+    try {
+        const res = await api.request("POST", `/${VERSION}/${refs.toExtensionVersionName(ref)}:undeprecate`, {
+            auth: true,
+            origin: api.extensionsOrigin,
+        });
+        return res.body;
+    }
+    catch (err) {
+        if (err.status === 403) {
+            throw new error_1.FirebaseError(`You are not the owner of extension '${clc.bold(extensionRef)}' and don’t have the correct permissions to undeprecate this extension version.`, { status: err.status });
+        }
+        else if (err.status === 404) {
+            throw new error_1.FirebaseError(`Extension version ${clc.bold(extensionRef)} was not found.`);
+        }
+        else if (err instanceof error_1.FirebaseError) {
+            throw err;
+        }
+        throw new error_1.FirebaseError(`Error occurred undeprecating extension version '${extensionRef}': ${err}`, {
+            status: err.status,
+        });
+    }
+}
+exports.undeprecateExtensionVersion = undeprecateExtensionVersion;
 async function publishExtensionVersion(extensionVersionRef, packageUri, extensionRoot) {
     const ref = refs.parse(extensionVersionRef);
     if (!ref.version) {

package/lib/extensions/extensionsHelper.js

@@ -27,6 +27,7 @@ const prompt_1 = require("../prompt");
 const logger_1 = require("../logger");
 const utils_2 = require("../utils");
 const changelog_1 = require("./changelog");
+const getProjectNumber_1 = require("../getProjectNumber");
 var SpecParamType;
 (function (SpecParamType) {
     SpecParamType["SELECT"] = "select";
@@ -76,6 +77,7 @@ function getDBInstanceFromURL(databaseUrl = "") {
 exports.getDBInstanceFromURL = getDBInstanceFromURL;
 async function getFirebaseProjectParams(projectId) {
     const body = await functionsConfig_1.getFirebaseConfig({ project: projectId });
+    const projectNumber = await getProjectNumber_1.getProjectNumber({ projectId });
     const FIREBASE_CONFIG = JSON.stringify({
         projectId: body.projectId,
         databaseURL: body.databaseURL,
@@ -83,6 +85,7 @@ async function getFirebaseProjectParams(projectId) {
     });
     return {
         PROJECT_ID: body.projectId,
+        PROJECT_NUMBER: projectNumber,
         DATABASE_URL: body.databaseURL,
         STORAGE_BUCKET: body.storageBucket,
         FIREBASE_CONFIG,
@@ -108,7 +111,7 @@ function populateDefaultParams(paramVars, paramSpecs) {
     const newParams = paramVars;
     for (const param of paramSpecs) {
         if (!paramVars[param.param]) {
-            if (param.default != undefined) {
+            if (param.default != undefined && param.required) {
                 newParams[param.param] = param.default;
             }
             else if (param.required) {

package/lib/extensions/listExtensions.js

@@ -8,19 +8,20 @@ const extensionsApi_1 = require("./extensionsApi");
 const extensionsHelper_1 = require("./extensionsHelper");
 const utils = require("../utils");
 const extensionsUtils = require("./utils");
-const logger_1 = require("../logger");
 async function listExtensions(projectId) {
     const instances = await extensionsApi_1.listInstances(projectId);
     if (instances.length < 1) {
         utils.logLabeledBullet(extensionsHelper_1.logPrefix, `there are no extensions installed on project ${clc.bold(projectId)}.`);
-        return { instances: [] };
+        return [];
     }
     const table = new Table({
         head: ["Extension", "Publisher", "Instance ID", "State", "Version", "Your last update"],
         style: { head: ["yellow"] },
     });
     const sorted = _.sortBy(instances, "createTime", "asc").reverse();
+    const formatted = [];
     sorted.forEach((instance) => {
+        var _a, _b, _c, _d;
         let extension = _.get(instance, "config.extensionRef", "");
         let publisher;
         if (extension === "") {
@@ -30,18 +31,22 @@ async function listExtensions(projectId) {
         else {
             publisher = extension.split("/")[0];
         }
-        table.push([
+        const instanceId = (_a = _.last(instance.name.split("/"))) !== null && _a !== void 0 ? _a : "";
+        const state = instance.state +
+            (_.get(instance, "config.source.state", "ACTIVE") === "DELETED" ? " (UNPUBLISHED)" : "");
+        const version = (_d = (_c = (_b = instance === null || instance === void 0 ? void 0 : instance.config) === null || _b === void 0 ? void 0 : _b.source) === null || _c === void 0 ? void 0 : _c.spec) === null || _d === void 0 ? void 0 : _d.version;
+        const updateTime = extensionsUtils.formatTimestamp(instance.updateTime);
+        table.push([extension, publisher, instanceId, state, version, updateTime]);
+        formatted.push({
             extension,
             publisher,
-            _.last(instance.name.split("/")),
-            instance.state +
-                (_.get(instance, "config.source.state", "ACTIVE") === "DELETED" ? " (UNPUBLISHED)" : ""),
-            _.get(instance, "config.source.spec.version", ""),
-            extensionsUtils.formatTimestamp(instance.updateTime),
-        ]);
+            instanceId,
+            state,
+            version,
+            updateTime,
+        });
     });
     utils.logLabeledBullet(extensionsHelper_1.logPrefix, `list of extensions installed in ${clc.bold(projectId)}:`);
-    logger_1.logger.info(table.toString());
-    return { instances: sorted };
+    return formatted;
 }
 exports.listExtensions = listExtensions;

package/lib/extensions/paramHelper.js

@@ -4,13 +4,13 @@ exports.readEnvFile = exports.getParamsFromFile = exports.promptForNewParams = e
 const _ = require("lodash");
 const path = require("path");
 const clc = require("cli-color");
-const dotenv = require("dotenv");
 const fs = require("fs-extra");
 const error_1 = require("../error");
 const logger_1 = require("../logger");
 const extensionsHelper_1 = require("./extensionsHelper");
 const askUserForParam = require("./askUserForParam");
 const track = require("../track");
+const env = require("../functions/env");
 function setNewDefaults(params, newDefaults) {
     params.forEach((param) => {
         if (newDefaults[param.param.toUpperCase()]) {
@@ -42,7 +42,6 @@ async function getParams(args) {
         params = getParamsFromFile({
             projectId: args.projectId,
             paramSpecs: args.paramSpecs,
-            noninteractive: args.nonInteractive,
             paramsEnvPath: args.paramsEnvPath,
         });
     }
@@ -71,7 +70,6 @@ async function getParamsForUpdate(args) {
         params = getParamsFromFile({
             projectId: args.projectId,
             paramSpecs: args.newSpec.params,
-            noninteractive: args.nonInteractive,
             paramsEnvPath: args.paramsEnvPath,
         });
     }
@@ -132,6 +130,10 @@ function getParamsFromFile(args) {
 exports.getParamsFromFile = getParamsFromFile;
 function readEnvFile(envPath) {
     const buf = fs.readFileSync(path.resolve(envPath), "utf8");
-    return dotenv.parse(buf.toString().trim(), { debug: true });
+    const result = env.parse(buf.toString().trim());
+    if (result.errors.length) {
+        throw new error_1.FirebaseError(`Error while parsing ${envPath} - unable to parse following lines:\n${result.errors.join("\n")}`);
+    }
+    return result.envs;
 }
 exports.readEnvFile = readEnvFile;

package/lib/extensions/provisioningHelper.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getUsedProducts = exports.checkProductsProvisioned = exports.DeferredProduct = void 0;
+exports.getUsedProducts = exports.bulkCheckProductsProvisioned = exports.checkProductsProvisioned = exports.DeferredProduct = void 0;
 const marked = require("marked");
 const api = require("../api");
+const functional_1 = require("../functional");
 const error_1 = require("../error");
+const planner_1 = require("../deploy/extensions/planner");
 var DeferredProduct;
 (function (DeferredProduct) {
     DeferredProduct[DeferredProduct["STORAGE"] = 0] = "STORAGE";
@@ -11,6 +13,18 @@ var DeferredProduct;
 })(DeferredProduct = exports.DeferredProduct || (exports.DeferredProduct = {}));
 async function checkProductsProvisioned(projectId, spec) {
     const usedProducts = getUsedProducts(spec);
+    await checkProducts(projectId, usedProducts);
+}
+exports.checkProductsProvisioned = checkProductsProvisioned;
+async function bulkCheckProductsProvisioned(projectId, instanceSpecs) {
+    const usedProducts = await Promise.all(instanceSpecs.map(async (i) => {
+        const extensionVersion = await planner_1.getExtensionVersion(i);
+        return getUsedProducts(extensionVersion.spec);
+    }));
+    await checkProducts(projectId, [...functional_1.flattenArray(usedProducts)]);
+}
+exports.bulkCheckProductsProvisioned = bulkCheckProductsProvisioned;
+async function checkProducts(projectId, usedProducts) {
     const needProvisioning = [];
     let isStorageProvisionedPromise;
     let isAuthProvisionedPromise;
@@ -29,7 +43,7 @@ async function checkProductsProvisioned(projectId, spec) {
     if (needProvisioning.length > 0) {
         let errorMessage = "Some services used by this extension have not been set up on your " +
             "Firebase project. To ensure this extension works as intended, you must enable these " +
-            "services by following the provided links, then retry installing the extension\n\n";
+            "services by following the provided links, then retry this command\n\n";
         if (needProvisioning.includes(DeferredProduct.STORAGE)) {
             errorMessage +=
                 " - Firebase Storage: store and retrieve user-generated files like images, audio, and " +
@@ -46,7 +60,6 @@ async function checkProductsProvisioned(projectId, spec) {
         throw new error_1.FirebaseError(marked(errorMessage), { exit: 2 });
     }
 }
-exports.checkProductsProvisioned = checkProductsProvisioned;
 function getUsedProducts(spec) {
     var _a, _b;
     const usedProducts = [];

package/lib/extensions/refs.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toExtensionVersionName = exports.toExtensionName = exports.toExtensionVersionRef = exports.toExtensionRef = exports.parse = void 0;
+exports.equal = exports.toExtensionVersionName = exports.toExtensionName = exports.toExtensionVersionRef = exports.toExtensionRef = exports.parse = void 0;
 const semver = require("semver");
 const error_1 = require("../error");
 const refRegex = new RegExp(/^([^/@\n]+)\/{1}([^/@\n]+)(@{1}([^\n]+)|)$/);
@@ -57,3 +57,11 @@ function toExtensionVersionName(ref) {
     return `publishers/${ref.publisherId}/extensions/${ref.extensionId}/versions/${ref.version}`;
 }
 exports.toExtensionVersionName = toExtensionVersionName;
+function equal(a, b) {
+    return (!!a &&
+        !!b &&
+        a.publisherId === b.publisherId &&
+        a.extensionId === b.extensionId &&
+        a.version === b.version);
+}
+exports.equal = equal;

package/lib/extensions/secretsUtils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.prettySecretName = exports.getSecretLabels = exports.getManagedSecrets = exports.grantFirexServiceAgentSecretAdminRole = exports.usesSecrets = exports.ensureSecretManagerApiEnabled = void 0;
+exports.prettySecretName = exports.getSecretLabels = exports.getActiveSecrets = exports.getManagedSecrets = exports.grantFirexServiceAgentSecretAdminRole = exports.usesSecrets = exports.ensureSecretManagerApiEnabled = exports.SECRET_LABEL = void 0;
 const getProjectNumber_1 = require("../getProjectNumber");
 const utils = require("../utils");
 const ensureApiEnabled_1 = require("../ensureApiEnabled");
@@ -8,7 +8,7 @@ const projectUtils_1 = require("../projectUtils");
 const extensionsApi = require("./extensionsApi");
 const secretManagerApi = require("../gcp/secretManager");
 const logger_1 = require("../logger");
-const SECRET_LABEL = "firebase-extensions-managed";
+exports.SECRET_LABEL = "firebase-extensions-managed";
 async function ensureSecretManagerApiEnabled(options) {
     const projectId = projectUtils_1.needProjectId(options);
     return await ensureApiEnabled_1.ensure(projectId, "secretmanager.googleapis.com", "extensions", options.markdown);
@@ -26,24 +26,25 @@ async function grantFirexServiceAgentSecretAdminRole(secret) {
 }
 exports.grantFirexServiceAgentSecretAdminRole = grantFirexServiceAgentSecretAdminRole;
 async function getManagedSecrets(instance) {
-    return (await Promise.all(getActiveSecrets(instance).map(async (secretResourceName) => {
+    return (await Promise.all(getActiveSecrets(instance.config.source.spec, instance.config.params).map(async (secretResourceName) => {
         const secret = secretManagerApi.parseSecretResourceName(secretResourceName);
-        const labels = await secretManagerApi.getSecretLabels(secret.projectId, secret.name);
-        if (labels && labels[SECRET_LABEL]) {
+        const labels = (await secretManagerApi.getSecret(secret.projectId, secret.name)).labels;
+        if (labels && labels[exports.SECRET_LABEL]) {
             return secretResourceName;
         }
         return Promise.resolve("");
     }))).filter((secretId) => !!secretId);
 }
 exports.getManagedSecrets = getManagedSecrets;
-function getActiveSecrets(instance) {
-    return instance.config.source.spec.params
-        .map((p) => p.type == extensionsApi.ParamType.SECRET && instance.config.params[p.param])
+function getActiveSecrets(spec, params) {
+    return spec.params
+        .map((p) => (p.type == extensionsApi.ParamType.SECRET ? params[p.param] : ""))
         .filter((pv) => !!pv);
 }
+exports.getActiveSecrets = getActiveSecrets;
 function getSecretLabels(instanceId) {
     const labels = {};
-    labels[SECRET_LABEL] = instanceId;
+    labels[exports.SECRET_LABEL] = instanceId;
     return labels;
 }
 exports.getSecretLabels = getSecretLabels;

package/lib/extensions/updateHelper.js

@@ -62,10 +62,20 @@ exports.displayChanges = displayChanges;
 async function update(updateOptions) {
     const { projectId, instanceId, source, extRef, params } = updateOptions;
     if (extRef) {
-        return await extensionsApi.updateInstanceFromRegistry(projectId, instanceId, extRef, params);
+        return await extensionsApi.updateInstanceFromRegistry({
+            projectId,
+            instanceId,
+            extRef,
+            params,
+        });
     }
     else if (source) {
-        return await extensionsApi.updateInstance(projectId, instanceId, source, params);
+        return await extensionsApi.updateInstance({
+            projectId,
+            instanceId,
+            extensionSource: source,
+            params,
+        });
     }
     throw new error_1.FirebaseError(`Neither a source nor a version of the extension was supplied for ${instanceId}. Please make sure this is a valid extension and try again.`);
 }

package/lib/extensions/versionHelper.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseVersionPredicate = void 0;
+const error_1 = require("../error");
+function parseVersionPredicate(versionPredicate) {
+    const versionPredicateRegex = "^(?<comparator>>=|<=|>|<)?(?<targetSemVer>.*)";
+    const matches = versionPredicate.match(versionPredicateRegex);
+    if (!matches || !matches.groups.targetSemVer) {
+        throw new error_1.FirebaseError("Invalid version predicate.");
+    }
+    const comparator = matches.groups.comparator || "=";
+    return { comparator, targetSemVer: matches.groups.targetSemVer };
+}
+exports.parseVersionPredicate = parseVersionPredicate;

package/lib/extensions/warnings.js

@@ -1,12 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.displayWarningPrompts = void 0;
+exports.displayWarningsForDeploy = exports.displayWarningPrompts = void 0;
 const marked = require("marked");
 const clc = require("cli-color");
 const extensionsApi_1 = require("./extensionsApi");
 const displayExtensionInfo_1 = require("./displayExtensionInfo");
 const extensionsHelper_1 = require("./extensionsHelper");
 const resolveSource_1 = require("./resolveSource");
+const deploymentSummary_1 = require("../deploy/extensions/deploymentSummary");
+const planner_1 = require("../deploy/extensions/planner");
+const functional_1 = require("../functional");
 const utils = require("../utils");
 function displayEAPWarning({ publisherId, sourceDownloadUri, githubLink, }) {
     const publisherNameLink = githubLink ? `[${publisherId}](${githubLink})` : publisherId;
@@ -35,3 +38,32 @@ async function displayWarningPrompts(publisherId, launchStage, extensionVersion)
     }
 }
 exports.displayWarningPrompts = displayWarningPrompts;
+const toListEntry = (i) => {
+    var _a, _b, _c, _d;
+    const idAndRef = deploymentSummary_1.humanReadable(i);
+    const sourceCodeLink = `\n\t[Source Code](${(_a = i.extensionVersion) === null || _a === void 0 ? void 0 : _a.sourceDownloadUri})`;
+    const githubLink = ((_c = (_b = i.extensionVersion) === null || _b === void 0 ? void 0 : _b.spec) === null || _c === void 0 ? void 0 : _c.sourceUrl) ? `\n\t[Publisher Contact](${(_d = i.extensionVersion) === null || _d === void 0 ? void 0 : _d.spec.sourceUrl})`
+        : "";
+    return `${idAndRef}${sourceCodeLink}${githubLink}`;
+};
+async function displayWarningsForDeploy(instancesToCreate) {
+    const trustedPublishers = await resolveSource_1.getTrustedPublishers();
+    for (const i of instancesToCreate) {
+        await planner_1.getExtension(i);
+        await planner_1.getExtensionVersion(i);
+    }
+    const [eapExtensions, nonEapExtensions] = functional_1.partition(instancesToCreate, (i) => { var _a, _b; return !trustedPublishers.includes((_b = (_a = i.ref) === null || _a === void 0 ? void 0 : _a.publisherId) !== null && _b !== void 0 ? _b : ""); });
+    const experimental = nonEapExtensions.filter((i) => i.extension.registryLaunchStage === extensionsApi_1.RegistryLaunchStage.EXPERIMENTAL);
+    if (experimental.length) {
+        const humanReadableList = experimental.map((i) => `\t${deploymentSummary_1.humanReadable(i)}`).join("\n");
+        utils.logLabeledBullet(extensionsHelper_1.logPrefix, marked(`The following are instances of ${clc.bold("experimental")} extensions.They may not be production-ready. Their functionality may change in backward-incompatible ways before their official release, or they may be discontinued.\n${humanReadableList}\n`));
+    }
+    if (eapExtensions.length) {
+        const humanReadableList = eapExtensions.map(toListEntry).join("\n");
+        utils.logLabeledBullet(extensionsHelper_1.logPrefix, marked(`These extensions are in preview and are built by a developer in the Extensions Publisher Early Access Program (http://bit.ly/firex-provider. Their functionality might change in backwards-incompatible ways. Since these extensions aren't built by Firebase, reach out to their publisher with questions about them.` +
+            ` They are provided “AS IS”, without any warranty, express or implied, from Google.` +
+            ` Google disclaims all liability for any damages, direct or indirect, resulting from the use of these extensions\n${humanReadableList}`));
+    }
+    return experimental.length > 0 || eapExtensions.length > 0;
+}
+exports.displayWarningsForDeploy = displayWarningsForDeploy;

package/lib/gcp/artifactregistry.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deletePackage = exports.API_VERSION = void 0;
+const apiv2_1 = require("../apiv2");
+const api_1 = require("../api");
+exports.API_VERSION = "v1beta2";
+const client = new apiv2_1.Client({
+    urlPrefix: api_1.artifactRegistryDomain,
+    auth: true,
+    apiVersion: exports.API_VERSION,
+});
+async function deletePackage(name) {
+    const res = await client.delete(name);
+    return res.body;
+}
+exports.deletePackage = deletePackage;

package/lib/gcp/cloudfunctions.js

@@ -4,6 +4,7 @@ exports.functionFromEndpoint = exports.endpointFromFunction = exports.listAllFun
 const clc = require("cli-color");
 const error_1 = require("../error");
 const logger_1 = require("../logger");
+const previews_1 = require("../previews");
 const api = require("../api");
 const backend = require("../deploy/functions/backend");
 const utils = require("../utils");
@@ -50,7 +51,11 @@ async function createFunction(cloudFunction) {
     const apiPath = cloudFunction.name.substring(0, cloudFunction.name.lastIndexOf("/"));
     const endpoint = `/${exports.API_VERSION}/${apiPath}`;
     try {
+        const headers = previews_1.previews.artifactregistry
+            ? { "X-Firebase-Artifact-Registry": "optin" }
+            : undefined;
         const res = await api.request("POST", endpoint, {
+            headers,
             auth: true,
             data: cloudFunction,
             origin: api.functionsOrigin,
@@ -145,7 +150,11 @@ async function updateFunction(cloudFunction) {
     const endpoint = `/${exports.API_VERSION}/${cloudFunction.name}`;
     const fieldMasks = proto.fieldMasks(cloudFunction, "labels", "environmentVariables");
     try {
+        const headers = previews_1.previews.artifactregistry
+            ? { "X-Firebase-Artifact-Registry": "optin" }
+            : undefined;
         const res = await api.request("PATCH", endpoint, {
+            headers,
             qs: {
                 updateMask: fieldMasks.join(","),
             },
@@ -215,19 +224,24 @@ async function listAllFunctions(projectId) {
 }
 exports.listAllFunctions = listAllFunctions;
 function endpointFromFunction(gcfFunction) {
-    var _a, _b;
+    var _a, _b, _c;
     const [, project, , region, , id] = gcfFunction.name.split("/");
     let trigger;
     let uri;
-    if (gcfFunction.httpsTrigger) {
-        trigger = { httpsTrigger: {} };
-        uri = gcfFunction.httpsTrigger.url;
-    }
-    else if ((_a = gcfFunction.labels) === null || _a === void 0 ? void 0 : _a["deployment-scheduled"]) {
+    if ((_a = gcfFunction.labels) === null || _a === void 0 ? void 0 : _a["deployment-scheduled"]) {
         trigger = {
             scheduleTrigger: {},
         };
     }
+    else if ((_b = gcfFunction.labels) === null || _b === void 0 ? void 0 : _b["deployment-taskqueue"]) {
+        trigger = {
+            taskQueueTrigger: {},
+        };
+    }
+    else if (gcfFunction.httpsTrigger) {
+        trigger = { httpsTrigger: {} };
+        uri = gcfFunction.httpsTrigger.url;
+    }
     else {
         trigger = {
             eventTrigger: {
@@ -235,7 +249,7 @@ function endpointFromFunction(gcfFunction) {
                 eventFilters: {
                     resource: gcfFunction.eventTrigger.resource,
                 },
-                retry: !!((_b = gcfFunction.eventTrigger.failurePolicy) === null || _b === void 0 ? void 0 : _b.retry),
+                retry: !!((_c = gcfFunction.eventTrigger.failurePolicy) === null || _c === void 0 ? void 0 : _c.retry),
             },
         };
     }
@@ -284,6 +298,10 @@ function functionFromEndpoint(endpoint, sourceUploadUrl) {
         };
         gcfFunction.labels = Object.assign(Object.assign({}, gcfFunction.labels), { "deployment-scheduled": "true" });
     }
+    else if (backend.isTaskQueueTriggered(endpoint)) {
+        gcfFunction.httpsTrigger = {};
+        gcfFunction.labels = Object.assign(Object.assign({}, gcfFunction.labels), { "deployment-taskqueue": "true" });
+    }
     else {
         gcfFunction.httpsTrigger = {};
     }