firebase-tools 9.21.0 → 9.22.0

package/CHANGELOG.md

@@ -1,3 +1,3 @@
-- Fix Auth Emulator deleteTenant not working with Node Admin (#3817).
-- Fix Crashlytics Android Native Symbols not working on Windows due to ":" in the path (#3842)
-- Fixes Firestore emulator UI showing requests out of order
+- Adds `firebase ext:export` command, and adds `extensions` to `firebase deploy`. See https://firebase.google.com/docs/extensions/reuse-project-config for more infomation on how to manage your extensions with these commands.
+- Fixes issue where `init` would crash with multiple Hosting items selected (#3742).
+- Adds a command (`crashlytics:symbols:upload`) to upload native symbol files, used in Android NDK crash symbolication.

package/lib/api.js

@@ -72,6 +72,7 @@ var api = {
     cloudbillingOrigin: utils.envOverride("FIREBASE_CLOUDBILLING_URL", "https://cloudbilling.googleapis.com"),
     cloudloggingOrigin: utils.envOverride("FIREBASE_CLOUDLOGGING_URL", "https://logging.googleapis.com"),
     containerRegistryDomain: utils.envOverride("CONTAINER_REGISTRY_DOMAIN", "gcr.io"),
+    artifactRegistryDomain: utils.envOverride("ARTIFACT_REGISTRY_DOMAIN", "https://artifactregistry.googleapis.com"),
     appDistributionOrigin: utils.envOverride("FIREBASE_APP_DISTRIBUTION_URL", "https://firebaseappdistribution.googleapis.com"),
     appengineOrigin: utils.envOverride("FIREBASE_APPENGINE_URL", "https://appengine.googleapis.com"),
     authOrigin: utils.envOverride("FIREBASE_AUTH_URL", "https://accounts.google.com"),
@@ -95,6 +96,7 @@ var api = {
     functionsUploadRegion: utils.envOverride("FIREBASE_FUNCTIONS_UPLOAD_REGION", "us-central1"),
     functionsDefaultRegion: utils.envOverride("FIREBASE_FUNCTIONS_DEFAULT_REGION", "us-central1"),
     cloudschedulerOrigin: utils.envOverride("FIREBASE_CLOUDSCHEDULER_URL", "https://cloudscheduler.googleapis.com"),
+    cloudTasksOrigin: utils.envOverride("FIREBASE_CLOUD_TAKS_URL", "https://cloudtasks.googleapis.com"),
     pubsubOrigin: utils.envOverride("FIREBASE_PUBSUB_URL", "https://pubsub.googleapis.com"),
     googleOrigin: utils.envOverride("FIREBASE_TOKEN_URL", utils.envOverride("FIREBASE_GOOGLE_URL", "https://www.googleapis.com")),
     hostingOrigin: utils.envOverride("FIREBASE_HOSTING_URL", "https://web.app"),

package/lib/apiv2.js

@@ -219,11 +219,12 @@ class Client {
         }
         let body;
         if (options.responseType === "json") {
-            if (res.status === 204) {
+            const text = await res.text();
+            if (!text.length) {
                 body = undefined;
             }
             else {
-                body = (await res.json());
+                body = JSON.parse(text);
             }
         }
         else if (options.responseType === "stream") {

package/lib/commands/crashlytics-symbols-upload.js

@@ -20,7 +20,7 @@ const SYMBOL_CACHE_ROOT_DIR = process.env.FIREBASE_CRASHLYTICS_CACHE_PATH || os.
 const JAR_CACHE_DIR = process.env.FIREBASE_CRASHLYTICS_BUILDTOOLS_PATH ||
     path.join(os.homedir(), ".cache", "firebase", "crashlytics", "buildtools");
 const JAR_VERSION = "2.8.0";
-const JAR_URL = `https://storage.googleapis.com/firebase-preview-drop/android/crashlytics-eap/crashlytics-buildtools/firebase-crashlytics-buildtools-${JAR_VERSION}-alpha-all.jar`;
+const JAR_URL = `https://dl.google.com/android/maven2/com/google/firebase/firebase-crashlytics-buildtools/${JAR_VERSION}/firebase-crashlytics-buildtools-${JAR_VERSION}.jar`;
 exports.default = new command_1.Command("crashlytics:symbols:upload <symbolFiles...>")
     .description("Upload symbols for native code, to symbolicate stack traces.")
     .option("--app <appID>", "the app id of your Firebase app")

package/lib/commands/deploy.js

@@ -9,7 +9,15 @@ const deploy = require("../deploy");
 const requireConfig = require("../requireConfig");
 const { filterTargets } = require("../filterTargets");
 const { requireHostingSite } = require("../requireHostingSite");
-const VALID_TARGETS = ["database", "storage", "firestore", "functions", "hosting", "remoteconfig"];
+const VALID_TARGETS = [
+    "database",
+    "storage",
+    "firestore",
+    "functions",
+    "hosting",
+    "remoteconfig",
+    "extensions",
+];
 const TARGET_PERMISSIONS = {
     database: ["firebasedatabase.instances.update"],
     hosting: ["firebasehosting.sites.update"],

package/lib/commands/ext-configure.js

@@ -69,7 +69,7 @@ exports.default = new command_1.Command("ext:configure <extensionInstanceId>")
                 ", uninstall the extension, then install a new instance of this extension.");
         }
         spinner.start();
-        const res = await extensionsApi.configureInstance(projectId, instanceId, params);
+        const res = await extensionsApi.configureInstance({ projectId, instanceId, params });
         spinner.stop();
         utils.logLabeledSuccess(extensionsHelper_1.logPrefix, `successfully configured ${clc.bold(instanceId)}.`);
         utils.logLabeledBullet(extensionsHelper_1.logPrefix, marked(`You can view your reconfigured instance in the Firebase console: ${utils.consoleUrl(projectId, `/extensions/instances/${instanceId}?tab=config`)}`));

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

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const clc = require("cli-color");
+const semver = require("semver");
+const refs = require("../extensions/refs");
+const utils = require("../utils");
+const command_1 = require("../command");
+const prompt_1 = require("../prompt");
+const extensionsHelper_1 = require("../extensions/extensionsHelper");
+const extensionsApi_1 = require("../extensions/extensionsApi");
+const versionHelper_1 = require("../extensions/versionHelper");
+const requireAuth_1 = require("../requireAuth");
+const error_1 = require("../error");
+exports.default = new command_1.Command("ext:dev:deprecate <extensionRef> <versionPredicate>")
+    .description("deprecate extension versions that match the version predicate")
+    .option("-m, --message <deprecationMessage>", "deprecation message")
+    .option("-f, --force", "override deprecation message for existing deprecated extension versions that match")
+    .before(requireAuth_1.requireAuth)
+    .before(extensionsHelper_1.ensureExtensionsApiEnabled)
+    .action(async (extensionRef, versionPredicate, options) => {
+    const { publisherId, extensionId, version } = refs.parse(extensionRef);
+    if (version) {
+        throw new error_1.FirebaseError(`The input extension reference must be of the format ${clc.bold("<publisherId>/<extensionId>")}. Version should be supplied in the version predicate argument.`);
+    }
+    if (!publisherId || !extensionId) {
+        throw new error_1.FirebaseError(`Error parsing publisher ID and extension ID from extension reference '${clc.bold(extensionRef)}'. Please use the format '${clc.bold("<publisherId>/<extensionId>")}'.`);
+    }
+    const { comparator, targetSemVer } = versionHelper_1.parseVersionPredicate(versionPredicate);
+    const filter = `id${comparator}"${targetSemVer}"`;
+    const extensionVersions = await extensionsApi_1.listExtensionVersions(extensionRef, filter);
+    const filteredExtensionVersions = extensionVersions
+        .sort((ev1, ev2) => {
+        return -semver.compare(ev1.spec.version, ev2.spec.version);
+    })
+        .filter((extensionVersion) => {
+        if (extensionVersion.state === "DEPRECATED" && !options.force) {
+            return false;
+        }
+        const message = extensionVersion.state === "DEPRECATED" ? ", will overwrite deprecation message" : "";
+        utils.logLabeledBullet(extensionVersion.ref, extensionVersion.state + message);
+        return true;
+    });
+    if (filteredExtensionVersions.length > 0) {
+        if (!options.force) {
+            const confirmMessage = "You are about to deprecate these extension version(s). Do you wish to continue?";
+            const consent = await prompt_1.promptOnce({
+                type: "confirm",
+                message: confirmMessage,
+                default: false,
+            });
+            if (!consent) {
+                throw new error_1.FirebaseError("Deprecation canceled.");
+            }
+        }
+    }
+    else {
+        throw new error_1.FirebaseError("No extension versions matched the version predicate.");
+    }
+    await utils.allSettled(filteredExtensionVersions.map(async (extensionVersion) => {
+        await extensionsApi_1.deprecateExtensionVersion(extensionVersion.ref, options.deprecationMessage);
+    }));
+    utils.logLabeledSuccess(extensionsHelper_1.logPrefix, "successfully deprecated extension version(s).");
+});

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

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const clc = require("cli-color");
+const semver = require("semver");
+const refs = require("../extensions/refs");
+const utils = require("../utils");
+const command_1 = require("../command");
+const prompt_1 = require("../prompt");
+const extensionsHelper_1 = require("../extensions/extensionsHelper");
+const extensionsApi_1 = require("../extensions/extensionsApi");
+const versionHelper_1 = require("../extensions/versionHelper");
+const requireAuth_1 = require("../requireAuth");
+const error_1 = require("../error");
+exports.default = new command_1.Command("ext:dev:undeprecate <extensionRef> <versionPredicate>")
+    .description("undeprecate extension versions that match the version predicate")
+    .before(requireAuth_1.requireAuth)
+    .before(extensionsHelper_1.ensureExtensionsApiEnabled)
+    .action(async (extensionRef, versionPredicate, options) => {
+    const { publisherId, extensionId, version } = refs.parse(extensionRef);
+    if (version) {
+        throw new error_1.FirebaseError(`The input extension reference must be of the format ${clc.bold("<publisherId>/<extensionId>")}. Version should be supplied in the version predicate argument.`);
+    }
+    if (!publisherId || !extensionId) {
+        throw new error_1.FirebaseError(`Error parsing publisher ID and extension ID from extension reference '${clc.bold(extensionRef)}'. Please use the format '${clc.bold("<publisherId>/<extensionId>")}'.`);
+    }
+    const { comparator, targetSemVer } = versionHelper_1.parseVersionPredicate(versionPredicate);
+    const filter = `id${comparator}"${targetSemVer}"`;
+    const extensionVersions = await extensionsApi_1.listExtensionVersions(extensionRef, filter);
+    extensionVersions
+        .sort((ev1, ev2) => {
+        return -semver.compare(ev1.spec.version, ev2.spec.version);
+    })
+        .forEach((extensionVersion) => {
+        utils.logLabeledBullet(extensionVersion.ref, extensionVersion.state);
+    });
+    if (extensionVersions.length > 0) {
+        if (!options.force) {
+            const confirmMessage = "You are about to undeprecate these extension version(s). Do you wish to continue?";
+            const consent = await prompt_1.promptOnce({
+                type: "confirm",
+                message: confirmMessage,
+                default: false,
+            });
+            if (!consent) {
+                throw new error_1.FirebaseError("Undeprecation canceled.");
+            }
+        }
+    }
+    else {
+        throw new error_1.FirebaseError("No extension versions matched the version predicate.");
+    }
+    await utils.allSettled(extensionVersions.map(async (extensionVersion) => {
+        await extensionsApi_1.undeprecateExtensionVersion(extensionVersion.ref);
+    }));
+    utils.logLabeledSuccess(extensionsHelper_1.logPrefix, "successfully undeprecated extension version(s).");
+});

package/lib/commands/ext-export.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const checkMinRequiredVersion_1 = require("../checkMinRequiredVersion");
+const command_1 = require("../command");
+const planner = require("../deploy/extensions/planner");
+const export_1 = require("../extensions/export");
+const extensionsHelper_1 = require("../extensions/extensionsHelper");
+const functional_1 = require("../functional");
+const getProjectNumber_1 = require("../getProjectNumber");
+const logger_1 = require("../logger");
+const projectUtils_1 = require("../projectUtils");
+const prompt_1 = require("../prompt");
+const requirePermissions_1 = require("../requirePermissions");
+module.exports = new command_1.Command("ext:export")
+    .description("export all Extension instances installed on a project to a local Firebase directory")
+    .before(requirePermissions_1.requirePermissions, ["firebaseextensions.instances.list"])
+    .before(extensionsHelper_1.ensureExtensionsApiEnabled)
+    .before(checkMinRequiredVersion_1.checkMinRequiredVersion, "extMinVersion")
+    .withForce()
+    .action(async (options) => {
+    const projectId = projectUtils_1.needProjectId(options);
+    const projectNumber = await getProjectNumber_1.getProjectNumber(options);
+    const have = await Promise.all((await planner.have(projectId)).map(async (i) => {
+        const subbed = await export_1.setSecretParamsToLatest(i);
+        return export_1.parameterizeProject(projectId, projectNumber, subbed);
+    }));
+    if (have.length == 0) {
+        logger_1.logger.info(`No extension instances installed on ${projectId}, so there is nothing to export.`);
+        return;
+    }
+    const [withRef, withoutRef] = functional_1.partition(have, (s) => !!s.ref);
+    export_1.displayExportInfo(withRef, withoutRef);
+    if (!options.nonInteractive &&
+        !options.force &&
+        !(await prompt_1.promptOnce({
+            message: "Do you wish to add these Extension instances to firebase.json?",
+            type: "confirm",
+            default: true,
+        }))) {
+        logger_1.logger.info("Exiting. No changes made.");
+        return;
+    }
+    await export_1.writeFiles(withRef, options);
+});

package/lib/commands/ext-install.js

@@ -47,7 +47,7 @@ async function installExtension(options) {
             }
             else if (!enabled) {
                 await billingMigrationHelper_1.displayNode10CreateBillingNotice(spec, false);
-                await checkProjectBilling_1.enableBilling(projectId, spec.displayName || spec.name);
+                await checkProjectBilling_1.enableBilling(projectId);
             }
             else {
                 await billingMigrationHelper_1.displayNode10CreateBillingNotice(spec, !nonInteractive);

package/lib/commands/ext-update.js

@@ -138,7 +138,7 @@ exports.default = new command_1.Command("ext:update <extensionInstanceId> [updat
             }
             if (!enabled) {
                 if (!options.nonInteractive) {
-                    await checkProjectBilling_1.enableBilling(projectId, instanceId);
+                    await checkProjectBilling_1.enableBilling(projectId);
                 }
                 else {
                     throw new error_1.FirebaseError("The extension requires your project to be upgraded to the Blaze plan. " +

package/lib/commands/functions-delete.js

@@ -15,6 +15,7 @@ const planner = require("../deploy/functions/release/planner");
 const fabricator = require("../deploy/functions/release/fabricator");
 const executor = require("../deploy/functions/release/executor");
 const reporter = require("../deploy/functions/release/reporter");
+const containerCleaner = require("../deploy/functions/containerCleaner");
 exports.default = new command_1.Command("functions:delete [filters...]")
     .description("delete one or more Cloud Functions by name or group name.")
     .option("--region <region>", "Specify region of the function to be deleted. " +
@@ -83,4 +84,5 @@ exports.default = new command_1.Command("functions:delete [filters...]")
             exit: 1,
         });
     }
+    await containerCleaner.cleanupBuildImages([], allEpToDelete);
 });

package/lib/commands/index.js

@@ -26,11 +26,9 @@ module.exports = function (client) {
     client.auth = {};
     client.auth.export = loadCommand("auth-export");
     client.auth.upload = loadCommand("auth-import");
-    if (previews.crashlyticsSymbolsUpload) {
-        client.crashlytics = {};
-        client.crashlytics.symbols = {};
-        client.crashlytics.symbols.upload = loadCommand("crashlytics-symbols-upload");
-    }
+    client.crashlytics = {};
+    client.crashlytics.symbols = {};
+    client.crashlytics.symbols.upload = loadCommand("crashlytics-symbols-upload");
     client.database = {};
     client.database.get = loadCommand("database-get");
     client.database.instances = {};
@@ -63,6 +61,7 @@ module.exports = function (client) {
     client.ext = loadCommand("ext");
     client.ext.configure = loadCommand("ext-configure");
     client.ext.info = loadCommand("ext-info");
+    client.ext.export = loadCommand("ext-export");
     client.ext.install = loadCommand("ext-install");
     client.ext.list = loadCommand("ext-list");
     client.ext.uninstall = loadCommand("ext-uninstall");
@@ -79,6 +78,8 @@ module.exports = function (client) {
         client.ext.dev.emulators = {};
         client.ext.dev.emulators.start = loadCommand("ext-dev-emulators-start");
         client.ext.dev.emulators.exec = loadCommand("ext-dev-emulators-exec");
+        client.ext.dev.deprecate = loadCommand("ext-dev-deprecate");
+        client.ext.dev.undeprecate = loadCommand("ext-dev-undeprecate");
         client.ext.dev.unpublish = loadCommand("ext-dev-unpublish");
         client.ext.dev.publish = loadCommand("ext-dev-publish");
         client.ext.dev.delete = loadCommand("ext-dev-extension-delete");

package/lib/commands/init.js

@@ -155,6 +155,9 @@ module.exports = new Command("init [feature]")
         if (allAccounts.length > 1) {
             setup.features.unshift("account");
         }
+        if (setup.features.includes("hosting") && setup.features.includes("hosting:github")) {
+            setup.features = setup.features.filter((f) => f != "hosting:github");
+        }
         return init(setup, config, options);
     })
         .then(function () {

package/lib/config.js

@@ -144,10 +144,10 @@ class Config {
         fs.ensureFileSync(this.path(p));
         fs.writeFileSync(this.path(p), content, "utf8");
     }
-    askWriteProjectFile(p, content) {
+    askWriteProjectFile(p, content, force) {
         const writeTo = this.path(p);
         let next;
-        if (fsutils.fileExistsSync(writeTo)) {
+        if (fsutils.fileExistsSync(writeTo) && !force) {
             next = prompt_1.promptOnce({
                 type: "confirm",
                 message: "File " + clc.underline(p) + " already exists. Overwrite?",
@@ -203,6 +203,7 @@ Config.FILENAME = "firebase.json";
 Config.MATERIALIZE_TARGETS = [
     "database",
     "emulators",
+    "extensions",
     "firestore",
     "functions",
     "hosting",

package/lib/deploy/extensions/args.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/deploy/extensions/deploy.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deploy = void 0;
+const tasks = require("./tasks");
+const queue_1 = require("../../throttler/queue");
+const error_1 = require("../../error");
+const errors_1 = require("./errors");
+const projectUtils_1 = require("../../projectUtils");
+const provisioningHelper_1 = require("../../extensions/provisioningHelper");
+const secrets_1 = require("./secrets");
+const validate_1 = require("./validate");
+async function deploy(context, options, payload) {
+    var _a, _b, _c, _d, _e, _f;
+    const projectId = projectUtils_1.needProjectId(options);
+    await validate_1.checkBilling(projectId, options.nonInteractive);
+    await provisioningHelper_1.bulkCheckProductsProvisioned(projectId, [
+        ...((_a = payload.instancesToCreate) !== null && _a !== void 0 ? _a : []),
+        ...((_b = payload.instancesToUpdate) !== null && _b !== void 0 ? _b : []),
+        ...((_c = payload.instancesToConfigure) !== null && _c !== void 0 ? _c : []),
+    ]);
+    await secrets_1.handleSecretParams(payload, context.have, options.nonInteractive);
+    const errorHandler = new errors_1.ErrorHandler();
+    const validationQueue = new queue_1.default({
+        retries: 5,
+        concurrency: 5,
+        handler: tasks.extensionsDeploymentHandler(errorHandler),
+    });
+    for (const create of (_d = payload.instancesToCreate) !== null && _d !== void 0 ? _d : []) {
+        const task = tasks.createExtensionInstanceTask(projectId, create, true);
+        void validationQueue.run(task);
+    }
+    for (const update of (_e = payload.instancesToUpdate) !== null && _e !== void 0 ? _e : []) {
+        const task = tasks.updateExtensionInstanceTask(projectId, update, true);
+        void validationQueue.run(task);
+    }
+    for (const configure of (_f = payload.instancesToConfigure) !== null && _f !== void 0 ? _f : []) {
+        const task = tasks.configureExtensionInstanceTask(projectId, configure, true);
+        void validationQueue.run(task);
+    }
+    const validationPromise = validationQueue.wait();
+    validationQueue.process();
+    validationQueue.close();
+    await validationPromise;
+    if (errorHandler.hasErrors()) {
+        errorHandler.print();
+        throw new error_1.FirebaseError(`Extensions deployment failed validation. No changes have been made to the Extension instances on ${projectId}`);
+    }
+}
+exports.deploy = deploy;

package/lib/deploy/extensions/deploymentSummary.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deletesSummary = exports.configuresSummary = exports.updatesSummary = exports.createsSummary = exports.humanReadable = void 0;
+const clc = require("cli-color");
+const refs = require("../../extensions/refs");
+exports.humanReadable = (dep) => `${clc.bold(dep.instanceId)} (${dep.ref ? `${refs.toExtensionVersionRef(dep.ref)}` : `Installed from local source`})`;
+const humanReadableUpdate = (from, to) => {
+    var _a, _b, _c, _d, _e;
+    if (((_a = from.ref) === null || _a === void 0 ? void 0 : _a.publisherId) == ((_b = to.ref) === null || _b === void 0 ? void 0 : _b.publisherId) &&
+        ((_c = from.ref) === null || _c === void 0 ? void 0 : _c.extensionId) == ((_d = to.ref) === null || _d === void 0 ? void 0 : _d.extensionId)) {
+        return `\t${clc.bold(from.instanceId)} (${refs.toExtensionVersionRef(from.ref)} => ${(_e = to.ref) === null || _e === void 0 ? void 0 : _e.version})`;
+    }
+    else {
+        const fromRef = from.ref
+            ? `${refs.toExtensionVersionRef(from.ref)}`
+            : `Installed from local source`;
+        return `\t${clc.bold(from.instanceId)} (${fromRef} => ${refs.toExtensionVersionRef(to.ref)})`;
+    }
+};
+function createsSummary(toCreate) {
+    const instancesToCreate = toCreate.map((s) => `\t${exports.humanReadable(s)}`).join("\n");
+    return toCreate.length
+        ? `The following extension instances will be created:\n${instancesToCreate}\n`
+        : "";
+}
+exports.createsSummary = createsSummary;
+function updatesSummary(toUpdate, have) {
+    const instancesToUpdate = toUpdate
+        .map((to) => {
+        const from = have.find((exists) => exists.instanceId == to.instanceId);
+        return humanReadableUpdate(from, to);
+    })
+        .join("\n");
+    return toUpdate.length
+        ? `The following extension instances will be updated:\n${instancesToUpdate}\n`
+        : "";
+}
+exports.updatesSummary = updatesSummary;
+function configuresSummary(toConfigure) {
+    const instancesToConfigure = toConfigure.map((s) => `\t${exports.humanReadable(s)}`).join("\n");
+    return toConfigure.length
+        ? `The following extension instances will be configured:\n${instancesToConfigure}\n`
+        : "";
+}
+exports.configuresSummary = configuresSummary;
+function deletesSummary(toDelete) {
+    const instancesToDelete = toDelete.map((s) => `\t${exports.humanReadable(s)}`).join("\n");
+    return toDelete.length
+        ? `The following extension instances are not listed in 'firebase.json':\n${instancesToDelete}\n`
+        : "";
+}
+exports.deletesSummary = deletesSummary;

package/lib/deploy/extensions/errors.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorHandler = void 0;
+const clc = require("cli-color");
+const logger_1 = require("../../logger");
+class ErrorHandler {
+    constructor() {
+        this.errors = [];
+    }
+    record(instanceId, type, message) {
+        this.errors.push({
+            instanceId,
+            type,
+            message: message,
+        });
+    }
+    print() {
+        logger_1.logger.info("");
+        logger_1.logger.info("Extensions deploy had errors:");
+        logger_1.logger.info("");
+        for (const err of this.errors) {
+            logger_1.logger.info(`- ${err.type} ${clc.bold(err.instanceId)}`);
+            logger_1.logger.info(err.message);
+            logger_1.logger.info("");
+        }
+    }
+    hasErrors() {
+        return this.errors.length > 0;
+    }
+}
+exports.ErrorHandler = ErrorHandler;

package/lib/deploy/extensions/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var prepare_1 = require("./prepare");
+Object.defineProperty(exports, "prepare", { enumerable: true, get: function () { return prepare_1.prepare; } });
+var deploy_1 = require("./deploy");
+Object.defineProperty(exports, "deploy", { enumerable: true, get: function () { return deploy_1.deploy; } });
+var release_1 = require("./release");
+Object.defineProperty(exports, "release", { enumerable: true, get: function () { return release_1.release; } });

package/lib/deploy/extensions/planner.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveVersion = exports.want = exports.have = exports.getExtension = exports.getExtensionVersion = void 0;
+const path = require("path");
+const semver = require("semver");
+const error_1 = require("../../error");
+const extensionsApi = require("../../extensions/extensionsApi");
+const extensionsHelper_1 = require("../../extensions/extensionsHelper");
+const refs = require("../../extensions/refs");
+const paramHelper_1 = require("../../extensions/paramHelper");
+const logger_1 = require("../../logger");
+async function getExtensionVersion(i) {
+    if (!i.extensionVersion) {
+        if (!i.ref) {
+            throw new error_1.FirebaseError(`Can't get ExtensionVersion for ${i.instanceId} because it has no ref`);
+        }
+        i.extensionVersion = await extensionsApi.getExtensionVersion(refs.toExtensionVersionRef(i.ref));
+    }
+    return i.extensionVersion;
+}
+exports.getExtensionVersion = getExtensionVersion;
+async function getExtension(i) {
+    if (!i.ref) {
+        throw new error_1.FirebaseError(`Can't get Extensionfor ${i.instanceId} because it has no ref`);
+    }
+    if (!i.extension) {
+        i.extension = await extensionsApi.getExtension(refs.toExtensionRef(i.ref));
+    }
+    return i.extension;
+}
+exports.getExtension = getExtension;
+const ENV_DIRECTORY = "extensions";
+async function have(projectId) {
+    const instances = await extensionsApi.listInstances(projectId);
+    return instances.map((i) => {
+        const dep = {
+            instanceId: i.name.split("/").pop(),
+            params: i.config.params,
+        };
+        if (i.config.extensionRef) {
+            const ref = refs.parse(i.config.extensionRef);
+            dep.ref = ref;
+            dep.ref.version = i.config.extensionVersion;
+        }
+        return dep;
+    });
+}
+exports.have = have;
+async function want(projectId, projectDir, extensions) {
+    const instanceSpecs = [];
+    const errors = [];
+    for (const e of Object.entries(extensions)) {
+        try {
+            const instanceId = e[0];
+            const ref = refs.parse(e[1]);
+            ref.version = await resolveVersion(ref);
+            const params = readParams(projectDir, instanceId);
+            const autoPopulatedParams = await extensionsHelper_1.getFirebaseProjectParams(projectId);
+            const subbedParams = extensionsHelper_1.substituteParams(params, autoPopulatedParams);
+            instanceSpecs.push({
+                instanceId,
+                ref,
+                params: subbedParams,
+            });
+        }
+        catch (err) {
+            logger_1.logger.debug(`Got error reading extensions entry ${e}: ${err}`);
+            errors.push(err);
+        }
+    }
+    if (errors.length) {
+        const messages = errors.map((err) => `- ${err.message}`).join("\n");
+        throw new error_1.FirebaseError(`Errors while reading 'extensions' in 'firebase.json'\n${messages}`);
+    }
+    return instanceSpecs;
+}
+exports.want = want;
+async function resolveVersion(ref) {
+    if (!ref.version || ref.version == "latest") {
+        return "latest";
+    }
+    const extensionRef = refs.toExtensionRef(ref);
+    const versions = await extensionsApi.listExtensionVersions(extensionRef);
+    const maxSatisfying = semver.maxSatisfying(versions.map((ev) => ev.spec.version), ref.version);
+    if (!maxSatisfying) {
+        throw new error_1.FirebaseError(`No version of ${extensionRef} matches requested version ${ref.version}`);
+    }
+    return maxSatisfying;
+}
+exports.resolveVersion = resolveVersion;
+function readParams(projectDir, instanceId) {
+    const paramPath = path.join(projectDir, ENV_DIRECTORY, `${instanceId}.env`);
+    const params = paramHelper_1.readEnvFile(paramPath);
+    return params;
+}