firebase-tools 13.0.3 → 13.2.0

package/lib/appdistribution/client.js

@@ -1,37 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AppDistributionClient = exports.UploadReleaseResult = exports.IntegrationState = void 0;
+exports.AppDistributionClient = void 0;
 const utils = require("../utils");
 const operationPoller = require("../operation-poller");
 const error_1 = require("../error");
 const apiv2_1 = require("../apiv2");
 const api_1 = require("../api");
-var IntegrationState;
-(function (IntegrationState) {
-    IntegrationState["AAB_INTEGRATION_STATE_UNSPECIFIED"] = "AAB_INTEGRATION_STATE_UNSPECIFIED";
-    IntegrationState["INTEGRATED"] = "INTEGRATED";
-    IntegrationState["PLAY_ACCOUNT_NOT_LINKED"] = "PLAY_ACCOUNT_NOT_LINKED";
-    IntegrationState["NO_APP_WITH_GIVEN_BUNDLE_ID_IN_PLAY_ACCOUNT"] = "NO_APP_WITH_GIVEN_BUNDLE_ID_IN_PLAY_ACCOUNT";
-    IntegrationState["APP_NOT_PUBLISHED"] = "APP_NOT_PUBLISHED";
-    IntegrationState["AAB_STATE_UNAVAILABLE"] = "AAB_STATE_UNAVAILABLE";
-    IntegrationState["PLAY_IAS_TERMS_NOT_ACCEPTED"] = "PLAY_IAS_TERMS_NOT_ACCEPTED";
-})(IntegrationState = exports.IntegrationState || (exports.IntegrationState = {}));
-var UploadReleaseResult;
-(function (UploadReleaseResult) {
-    UploadReleaseResult["UPLOAD_RELEASE_RESULT_UNSPECIFIED"] = "UPLOAD_RELEASE_RESULT_UNSPECIFIED";
-    UploadReleaseResult["RELEASE_CREATED"] = "RELEASE_CREATED";
-    UploadReleaseResult["RELEASE_UPDATED"] = "RELEASE_UPDATED";
-    UploadReleaseResult["RELEASE_UNMODIFIED"] = "RELEASE_UNMODIFIED";
-})(UploadReleaseResult = exports.UploadReleaseResult || (exports.UploadReleaseResult = {}));
+const types_1 = require("./types");
 class AppDistributionClient {
     constructor() {
-        this.appDistroV2Client = new apiv2_1.Client({
+        this.appDistroV1Client = new apiv2_1.Client({
             urlPrefix: api_1.appDistributionOrigin,
             apiVersion: "v1",
         });
+        this.appDistroV1AlphaClient = new apiv2_1.Client({
+            urlPrefix: api_1.appDistributionOrigin,
+            apiVersion: "v1alpha",
+        });
     }
     async getAabInfo(appName) {
-        const apiResponse = await this.appDistroV2Client.get(`/${appName}/aabInfo`);
+        const apiResponse = await this.appDistroV1Client.get(`/${appName}/aabInfo`);
         return apiResponse.body;
     }
     async uploadRelease(appName, distribution) {
@@ -74,7 +62,7 @@ class AppDistributionClient {
         };
         const queryParams = { updateMask: "release_notes.text" };
         try {
-            await this.appDistroV2Client.patch(`/${releaseName}`, data, { queryParams });
+            await this.appDistroV1Client.patch(`/${releaseName}`, data, { queryParams });
         }
         catch (err) {
             throw new error_1.FirebaseError(`failed to update release notes with ${err === null || err === void 0 ? void 0 : err.message}`);
@@ -93,7 +81,7 @@ class AppDistributionClient {
             groupAliases,
         };
         try {
-            await this.appDistroV2Client.post(`/${releaseName}:distribute`, data);
+            await this.appDistroV1Client.post(`/${releaseName}:distribute`, data);
         }
         catch (err) {
             let errorMessage = err.message;
@@ -112,7 +100,7 @@ class AppDistributionClient {
     }
     async addTesters(projectName, emails) {
         try {
-            await this.appDistroV2Client.request({
+            await this.appDistroV1Client.request({
                 method: "POST",
                 path: `${projectName}/testers:batchAdd`,
                 body: { emails: emails },
@@ -126,7 +114,7 @@ class AppDistributionClient {
     async removeTesters(projectName, emails) {
         let apiResponse;
         try {
-            apiResponse = await this.appDistroV2Client.request({
+            apiResponse = await this.appDistroV1Client.request({
                 method: "POST",
                 path: `${projectName}/testers:batchRemove`,
                 body: { emails: emails },
@@ -140,7 +128,7 @@ class AppDistributionClient {
     async createGroup(projectName, displayName, alias) {
         let apiResponse;
         try {
-            apiResponse = await this.appDistroV2Client.request({
+            apiResponse = await this.appDistroV1Client.request({
                 method: "POST",
                 path: alias === undefined ? `${projectName}/groups` : `${projectName}/groups?groupId=${alias}`,
                 body: { displayName: displayName },
@@ -153,7 +141,7 @@ class AppDistributionClient {
     }
     async deleteGroup(groupName) {
         try {
-            await this.appDistroV2Client.request({
+            await this.appDistroV1Client.request({
                 method: "DELETE",
                 path: groupName,
             });
@@ -165,7 +153,7 @@ class AppDistributionClient {
     }
     async addTestersToGroup(groupName, emails) {
         try {
-            await this.appDistroV2Client.request({
+            await this.appDistroV1Client.request({
                 method: "POST",
                 path: `${groupName}:batchJoin`,
                 body: { emails: emails },
@@ -178,7 +166,7 @@ class AppDistributionClient {
     }
     async removeTestersFromGroup(groupName, emails) {
         try {
-            await this.appDistroV2Client.request({
+            await this.appDistroV1Client.request({
                 method: "POST",
                 path: `${groupName}:batchLeave`,
                 body: { emails: emails },
@@ -189,5 +177,25 @@ class AppDistributionClient {
         }
         utils.logSuccess(`Testers removed from group successfully`);
     }
+    async createReleaseTest(releaseName, devices, loginCredential) {
+        try {
+            const response = await this.appDistroV1AlphaClient.request({
+                method: "POST",
+                path: `${releaseName}/tests`,
+                body: {
+                    deviceExecutions: devices.map(types_1.mapDeviceToExecution),
+                    loginCredential,
+                },
+            });
+            return response.body;
+        }
+        catch (err) {
+            throw new error_1.FirebaseError(`Failed to create release test ${err}`);
+        }
+    }
+    async getReleaseTest(releaseTestName) {
+        const response = await this.appDistroV1AlphaClient.get(releaseTestName);
+        return response.body;
+    }
 }
 exports.AppDistributionClient = AppDistributionClient;

package/lib/appdistribution/options-parser-util.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAppName = exports.getProjectName = exports.ensureFileExists = exports.getEmails = exports.getTestersOrGroups = void 0;
+exports.getLoginCredential = exports.getTestDevices = exports.getAppName = exports.getProjectName = exports.ensureFileExists = exports.getEmails = exports.getTestersOrGroups = void 0;
 const fs = require("fs-extra");
 const error_1 = require("../error");
 const projectUtils_1 = require("../projectUtils");
@@ -49,3 +49,82 @@ function getAppName(options) {
     return `projects/${appId.split(":")[1]}/apps/${appId}`;
 }
 exports.getAppName = getAppName;
+function getTestDevices(value, file) {
+    if (!value && file) {
+        ensureFileExists(file);
+        value = fs.readFileSync(file, "utf8");
+    }
+    if (!value) {
+        return [];
+    }
+    return value
+        .split(/[;\n]/)
+        .map((entry) => entry.trim())
+        .filter((entry) => !!entry)
+        .map((str) => parseTestDevice(str));
+}
+exports.getTestDevices = getTestDevices;
+function parseTestDevice(testDeviceString) {
+    const entries = testDeviceString.split(",");
+    const allowedKeys = new Set(["model", "version", "orientation", "locale"]);
+    let model;
+    let version;
+    let orientation;
+    let locale;
+    for (const entry of entries) {
+        const keyAndValue = entry.split("=");
+        switch (keyAndValue[0]) {
+            case "model":
+                model = keyAndValue[1];
+                break;
+            case "version":
+                version = keyAndValue[1];
+                break;
+            case "orientation":
+                orientation = keyAndValue[1];
+                break;
+            case "locale":
+                locale = keyAndValue[1];
+                break;
+            default:
+                throw new error_1.FirebaseError(`Unrecognized key in test devices. Can only contain ${Array.from(allowedKeys).join(", ")}`);
+        }
+    }
+    if (!model || !version || !orientation || !locale) {
+        throw new error_1.FirebaseError("Test devices must be in the format 'model=<model-id>,version=<os-version-id>,locale=<locale>,orientation=<orientation>'");
+    }
+    return { model, version, locale, orientation };
+}
+function getLoginCredential(args) {
+    const { username, passwordFile, usernameResourceName, passwordResourceName } = args;
+    let password = args.password;
+    if (!password && passwordFile) {
+        ensureFileExists(passwordFile);
+        password = fs.readFileSync(passwordFile, "utf8").trim();
+    }
+    if (isPresenceMismatched(usernameResourceName, passwordResourceName)) {
+        throw new error_1.FirebaseError("Username and password resource names for automated tests need to be specified together.");
+    }
+    let fieldHints;
+    if (usernameResourceName && passwordResourceName) {
+        fieldHints = {
+            usernameResourceName: usernameResourceName,
+            passwordResourceName: passwordResourceName,
+        };
+    }
+    if (isPresenceMismatched(username, password)) {
+        throw new error_1.FirebaseError("Username and password for automated tests need to be specified together.");
+    }
+    let loginCredential;
+    if (username && password) {
+        loginCredential = { username, password, fieldHints };
+    }
+    else if (fieldHints) {
+        throw new error_1.FirebaseError("Must specify username and password for automated tests if resource names are set");
+    }
+    return loginCredential;
+}
+exports.getLoginCredential = getLoginCredential;
+function isPresenceMismatched(value1, value2) {
+    return (value1 && !value2) || (!value1 && value2);
+}

package/lib/appdistribution/types.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapDeviceToExecution = exports.UploadReleaseResult = exports.IntegrationState = void 0;
+var IntegrationState;
+(function (IntegrationState) {
+    IntegrationState["AAB_INTEGRATION_STATE_UNSPECIFIED"] = "AAB_INTEGRATION_STATE_UNSPECIFIED";
+    IntegrationState["INTEGRATED"] = "INTEGRATED";
+    IntegrationState["PLAY_ACCOUNT_NOT_LINKED"] = "PLAY_ACCOUNT_NOT_LINKED";
+    IntegrationState["NO_APP_WITH_GIVEN_BUNDLE_ID_IN_PLAY_ACCOUNT"] = "NO_APP_WITH_GIVEN_BUNDLE_ID_IN_PLAY_ACCOUNT";
+    IntegrationState["APP_NOT_PUBLISHED"] = "APP_NOT_PUBLISHED";
+    IntegrationState["AAB_STATE_UNAVAILABLE"] = "AAB_STATE_UNAVAILABLE";
+    IntegrationState["PLAY_IAS_TERMS_NOT_ACCEPTED"] = "PLAY_IAS_TERMS_NOT_ACCEPTED";
+})(IntegrationState = exports.IntegrationState || (exports.IntegrationState = {}));
+var UploadReleaseResult;
+(function (UploadReleaseResult) {
+    UploadReleaseResult["UPLOAD_RELEASE_RESULT_UNSPECIFIED"] = "UPLOAD_RELEASE_RESULT_UNSPECIFIED";
+    UploadReleaseResult["RELEASE_CREATED"] = "RELEASE_CREATED";
+    UploadReleaseResult["RELEASE_UPDATED"] = "RELEASE_UPDATED";
+    UploadReleaseResult["RELEASE_UNMODIFIED"] = "RELEASE_UNMODIFIED";
+})(UploadReleaseResult = exports.UploadReleaseResult || (exports.UploadReleaseResult = {}));
+function mapDeviceToExecution(device) {
+    return {
+        device: {
+            model: device.model,
+            version: device.version,
+            orientation: device.orientation,
+            locale: device.locale,
+        },
+    };
+}
+exports.mapDeviceToExecution = mapDeviceToExecution;

package/lib/commands/appdistribution-distribute.js

@@ -6,9 +6,12 @@ const command_1 = require("../command");
 const utils = require("../utils");
 const requireAuth_1 = require("../requireAuth");
 const client_1 = require("../appdistribution/client");
+const types_1 = require("../appdistribution/types");
 const error_1 = require("../error");
 const distribution_1 = require("../appdistribution/distribution");
 const options_parser_util_1 = require("../appdistribution/options-parser-util");
+const TEST_MAX_POLLING_RETRIES = 40;
+const TEST_POLLING_INTERVAL_MILLIS = 30000;
 function getReleaseNotes(releaseNotes, releaseNotesFile) {
     if (releaseNotes) {
         return releaseNotes.replace(/\\n/g, "\n");
@@ -28,6 +31,14 @@ exports.command = new command_1.Command("appdistribution:distribute <release-bin
     .option("--testers-file <file>", "path to file with a comma separated list of tester emails to distribute to")
     .option("--groups <string>", "a comma separated list of group aliases to distribute to")
     .option("--groups-file <file>", "path to file with a comma separated list of group aliases to distribute to")
+    .option("--test-devices <string>", "semicolon-separated list of devices to run automated tests on, in the format 'model=<model-id>,version=<os-version-id>,locale=<locale>,orientation=<orientation>'. Run 'gcloud firebase test android|ios models list' to see available devices. Note: This feature is in beta.")
+    .option("--test-devices-file <string>", "path to file containing a list of semicolon- or newline-separated devices to run automated tests on, in the format 'model=<model-id>,version=<os-version-id>,locale=<locale>,orientation=<orientation>'. Run 'gcloud firebase test android|ios models list' to see available devices. Note: This feature is in beta.")
+    .option("--test-username <string>", "username for automatic login")
+    .option("--test-password <string>", "password for automatic login. If using a real password, use --test-password-file instead to avoid putting sensitive info in history and logs.")
+    .option("--test-password-file <string>", "path to file containing password for automatic login")
+    .option("--test-username-resource <string>", "resource name for the username field for automatic login")
+    .option("--test-password-resource <string>", "resource name for the password field for automatic login")
+    .option("--test-non-blocking", "run automated tests without waiting for them to complete. Visit the Firebase console for the test results.")
     .before(requireAuth_1.requireAuth)
     .action(async (file, options) => {
     const appName = (0, options_parser_util_1.getAppName)(options);
@@ -35,6 +46,14 @@ exports.command = new command_1.Command("appdistribution:distribute <release-bin
     const releaseNotes = getReleaseNotes(options.releaseNotes, options.releaseNotesFile);
     const testers = (0, options_parser_util_1.getTestersOrGroups)(options.testers, options.testersFile);
     const groups = (0, options_parser_util_1.getTestersOrGroups)(options.groups, options.groupsFile);
+    const testDevices = (0, options_parser_util_1.getTestDevices)(options.testDevices, options.testDevicesFile);
+    const loginCredential = (0, options_parser_util_1.getLoginCredential)({
+        username: options.testUsername,
+        password: options.testPassword,
+        passwordFile: options.testPasswordFile,
+        usernameResourceName: options.testUsernameResource,
+        passwordResourceName: options.testPasswordResource,
+    });
     const requests = new client_1.AppDistributionClient();
     let aabInfo;
     if (distribution.distributionFileType() === distribution_1.DistributionFileType.AAB) {
@@ -50,19 +69,19 @@ exports.command = new command_1.Command("appdistribution:distribute <release-bin
             }
             throw new error_1.FirebaseError(`failed to determine AAB info. ${err.message}`, { exit: 1 });
         }
-        if (aabInfo.integrationState !== client_1.IntegrationState.INTEGRATED &&
-            aabInfo.integrationState !== client_1.IntegrationState.AAB_STATE_UNAVAILABLE) {
+        if (aabInfo.integrationState !== types_1.IntegrationState.INTEGRATED &&
+            aabInfo.integrationState !== types_1.IntegrationState.AAB_STATE_UNAVAILABLE) {
             switch (aabInfo.integrationState) {
-                case client_1.IntegrationState.PLAY_ACCOUNT_NOT_LINKED: {
+                case types_1.IntegrationState.PLAY_ACCOUNT_NOT_LINKED: {
                     throw new error_1.FirebaseError("This project is not linked to a Google Play account.");
                 }
-                case client_1.IntegrationState.APP_NOT_PUBLISHED: {
+                case types_1.IntegrationState.APP_NOT_PUBLISHED: {
                     throw new error_1.FirebaseError('"This app is not published in the Google Play console.');
                 }
-                case client_1.IntegrationState.NO_APP_WITH_GIVEN_BUNDLE_ID_IN_PLAY_ACCOUNT: {
+                case types_1.IntegrationState.NO_APP_WITH_GIVEN_BUNDLE_ID_IN_PLAY_ACCOUNT: {
                     throw new error_1.FirebaseError("App with matching package name does not exist in Google Play.");
                 }
-                case client_1.IntegrationState.PLAY_IAS_TERMS_NOT_ACCEPTED: {
+                case types_1.IntegrationState.PLAY_IAS_TERMS_NOT_ACCEPTED: {
                     throw new error_1.FirebaseError("You must accept the Play Internal App Sharing (IAS) terms to upload AABs.");
                 }
                 default: {
@@ -78,13 +97,13 @@ exports.command = new command_1.Command("appdistribution:distribute <release-bin
         const uploadResponse = await requests.pollUploadStatus(operationName);
         const release = uploadResponse.release;
         switch (uploadResponse.result) {
-            case client_1.UploadReleaseResult.RELEASE_CREATED:
+            case types_1.UploadReleaseResult.RELEASE_CREATED:
                 utils.logSuccess(`uploaded new release ${release.displayVersion} (${release.buildVersion}) successfully!`);
                 break;
-            case client_1.UploadReleaseResult.RELEASE_UPDATED:
+            case types_1.UploadReleaseResult.RELEASE_UPDATED:
                 utils.logSuccess(`uploaded update to existing release ${release.displayVersion} (${release.buildVersion}) successfully!`);
                 break;
-            case client_1.UploadReleaseResult.RELEASE_UNMODIFIED:
+            case types_1.UploadReleaseResult.RELEASE_UNMODIFIED:
                 utils.logSuccess(`re-uploaded already existing release ${release.displayVersion} (${release.buildVersion}) successfully!`);
                 break;
             default:
@@ -102,7 +121,7 @@ exports.command = new command_1.Command("appdistribution:distribute <release-bin
                 "button on the App Distribution page in the Firebase console: " +
                 "https://console.firebase.google.com/project/_/appdistribution", { exit: 1 });
         }
-        throw new error_1.FirebaseError(`failed to upload release. ${err.message}`, { exit: 1 });
+        throw new error_1.FirebaseError(`Failed to upload release. ${err.message}`, { exit: 1 });
     }
     if (aabInfo && !aabInfo.testCertificate) {
         aabInfo = await requests.getAabInfo(appName);
@@ -118,4 +137,45 @@ exports.command = new command_1.Command("appdistribution:distribute <release-bin
     }
     await requests.updateReleaseNotes(releaseName, releaseNotes);
     await requests.distribute(releaseName, testers, groups);
+    if (testDevices) {
+        utils.logBullet("starting automated tests (note: this feature is in beta)");
+        const releaseTest = await requests.createReleaseTest(releaseName, testDevices, loginCredential);
+        utils.logSuccess(`Release test created successfully`);
+        if (!options.testNonBlocking) {
+            await awaitTestResults(releaseTest.name, requests);
+        }
+    }
 });
+async function awaitTestResults(releaseTestName, requests) {
+    for (let i = 0; i < TEST_MAX_POLLING_RETRIES; i++) {
+        utils.logBullet("the automated tests results are pending");
+        await delay(TEST_POLLING_INTERVAL_MILLIS);
+        const releaseTest = await requests.getReleaseTest(releaseTestName);
+        if (releaseTest.deviceExecutions.every((e) => e.state === "PASSED")) {
+            utils.logSuccess("automated test(s) passed!");
+            return;
+        }
+        for (const execution of releaseTest.deviceExecutions) {
+            switch (execution.state) {
+                case "PASSED":
+                case "IN_PROGRESS":
+                    continue;
+                case "FAILED":
+                    throw new error_1.FirebaseError(`Automated test failed for ${deviceToString(execution.device)}: ${execution.failedReason}`, { exit: 1 });
+                case "INCONCLUSIVE":
+                    throw new error_1.FirebaseError(`Automated test inconclusive for ${deviceToString(execution.device)}: ${execution.inconclusiveReason}`, { exit: 1 });
+                default:
+                    throw new error_1.FirebaseError(`Unsupported automated test state for ${deviceToString(execution.device)}: ${execution.state}`, { exit: 1 });
+            }
+        }
+    }
+    throw new error_1.FirebaseError("It took longer than expected to process your test, please try again.", {
+        exit: 1,
+    });
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function deviceToString(device) {
+    return `${device.model} (${device.version}/${device.orientation}/${device.locale})`;
+}

package/lib/commands/apphosting-backends-list.js

@@ -1,58 +1,42 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.command = void 0;
+const Table = require("cli-table");
 const command_1 = require("../command");
-const projectUtils_1 = require("../projectUtils");
+const utils_1 = require("../utils");
 const error_1 = require("../error");
 const logger_1 = require("../logger");
+const projectUtils_1 = require("../projectUtils");
 const apphosting = require("../gcp/apphosting");
-const Table = require("cli-table");
-const COLUMN_LENGTH = 20;
-const TABLE_HEAD = ["Backend Id", "Repository", "Location", "URL", "Created Date", "Updated Date"];
+const TABLE_HEAD = ["Backend ID", "Repository", "Location", "URL", "Created Date", "Updated Date"];
 exports.command = new command_1.Command("apphosting:backends:list")
     .description("List backends of a Firebase project.")
     .option("-l, --location <location>", "App Backend location", "-")
     .before(apphosting.ensureApiEnabled)
     .action(async (options) => {
+    var _a, _b, _c;
     const projectId = (0, projectUtils_1.needProjectId)(options);
     const location = options.location;
-    const table = new Table({
-        head: TABLE_HEAD,
-        style: { head: ["green"] },
-    });
-    table.colWidths = COLUMN_LENGTH;
-    const backendsList = [];
+    const table = new Table({ head: TABLE_HEAD, style: { head: ["green"] } });
+    let backendRes;
     try {
-        const backendsPerRegion = await apphosting.listBackends(projectId, location);
-        backendsList.push(...(backendsPerRegion.backends || []));
-        populateTable(backendsList, table);
-        logger_1.logger.info(table.toString());
+        backendRes = await apphosting.listBackends(projectId, location);
     }
     catch (err) {
         throw new error_1.FirebaseError(`Unable to list backends present for project: ${projectId}. Please check the parameters you have provided.`, { original: err });
     }
-    return backendsList;
-});
-function populateTable(backends, table) {
-    var _a, _b;
+    const backends = backendRes === null || backendRes === void 0 ? void 0 : backendRes.backends;
     for (const backend of backends) {
-        const [location, , backendId] = backend.name.split("/").slice(3, 6);
-        const entry = [
+        const [backendLocation, , backendId] = backend.name.split("/").slice(3, 6);
+        table.push([
             backendId,
-            (_b = (_a = backend.codebase) === null || _a === void 0 ? void 0 : _a.repository) === null || _b === void 0 ? void 0 : _b.split("/").pop(),
-            location,
-            backend.uri,
-            backend.createTime,
-            backend.updateTime,
-        ];
-        const newRow = entry.map((name) => {
-            const maxCellWidth = COLUMN_LENGTH - 2;
-            const chunks = [];
-            for (let i = 0; name && i < name.length; i += maxCellWidth) {
-                chunks.push(name.substring(i, i + maxCellWidth));
-            }
-            return chunks.join("\n");
-        });
-        table.push(newRow);
+            (_c = (_b = (_a = backend.codebase) === null || _a === void 0 ? void 0 : _a.repository) === null || _b === void 0 ? void 0 : _b.split("/").pop()) !== null && _c !== void 0 ? _c : "",
+            backendLocation,
+            backend.uri.startsWith("https:") ? backend.uri : "https://" + backend.uri,
+            (0, utils_1.datetimeString)(new Date(backend.createTime)),
+            (0, utils_1.datetimeString)(new Date(backend.updateTime)),
+        ]);
     }
-}
+    logger_1.logger.info(table.toString());
+    return backends;
+});

package/lib/commands/apphosting-builds-create.js

@@ -4,7 +4,6 @@ exports.command = void 0;
 const apphosting = require("../gcp/apphosting");
 const logger_1 = require("../logger");
 const command_1 = require("../command");
-const utils_1 = require("../utils");
 const projectUtils_1 = require("../projectUtils");
 exports.command = new command_1.Command("apphosting:builds:create <backendId>")
     .description("Create a build for an App Hosting backend")
@@ -15,7 +14,8 @@ exports.command = new command_1.Command("apphosting:builds:create <backendId>")
     .action(async (backendId, options) => {
     const projectId = (0, projectUtils_1.needProjectId)(options);
     const location = options.location;
-    const buildId = options.buildId || (0, utils_1.generateId)();
+    const buildId = options.buildId ||
+        (await apphosting.getNextRolloutId(projectId, location, backendId));
     const branch = options.branch;
     const op = await apphosting.createBuild(projectId, location, backendId, buildId, {
         source: {

package/lib/commands/apphosting-rollouts-create.js

@@ -5,7 +5,6 @@ const apphosting = require("../gcp/apphosting");
 const logger_1 = require("../logger");
 const command_1 = require("../command");
 const projectUtils_1 = require("../projectUtils");
-const utils_1 = require("../utils");
 exports.command = new command_1.Command("apphosting:rollouts:create <backendId> <buildId>")
     .description("Create a build for an App Hosting backend")
     .option("-l, --location <location>", "Specify the region of the backend", "us-central1")
@@ -14,7 +13,8 @@ exports.command = new command_1.Command("apphosting:rollouts:create <backendId>
     .action(async (backendId, buildId, options) => {
     const projectId = (0, projectUtils_1.needProjectId)(options);
     const location = options.location;
-    const rolloutId = options.buildId || (0, utils_1.generateId)();
+    const rolloutId = options.buildId ||
+        (await apphosting.getNextRolloutId(projectId, location, backendId));
     const build = `projects/${projectId}/backends/${backendId}/builds/${buildId}`;
     const op = await apphosting.createRollout(projectId, location, backendId, rolloutId, {
         build,

package/lib/commands/apphosting-rollouts-list.js

@@ -13,6 +13,9 @@ exports.command = new command_1.Command("apphosting:rollouts:list <backendId>")
     const projectId = (0, projectUtils_1.needProjectId)(options);
     const location = options.location;
     const rollouts = await apphosting.listRollouts(projectId, location, backendId);
-    logger_1.logger.info(JSON.stringify(rollouts, null, 2));
+    if (rollouts.unreachable) {
+        logger_1.logger.error(`WARNING: the following locations were unreachable: ${rollouts.unreachable.join(", ")}`);
+    }
+    logger_1.logger.info(JSON.stringify(rollouts.rollouts, null, 2));
     return rollouts;
 });

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

@@ -110,8 +110,10 @@ exports.command = new command_1.Command("functions:config:export")
     const dotEnvs = pInfos.map((pInfo) => configExport.toDotenvFormat(pInfo.envs, header));
     const filenames = pInfos.map(configExport.generateDotenvFilename);
     const filesToWrite = fromEntries((0, functional_1.zip)(filenames, dotEnvs));
-    filesToWrite[".env.local"] = `${header}\n# .env.local file contains environment variables for the Functions Emulator.\n`;
-    filesToWrite[".env"] = `${header}# .env file contains environment variables that applies to all projects.\n`;
+    filesToWrite[".env.local"] =
+        `${header}\n# .env.local file contains environment variables for the Functions Emulator.\n`;
+    filesToWrite[".env"] =
+        `${header}# .env file contains environment variables that applies to all projects.\n`;
     for (const [filename, content] of Object.entries(filesToWrite)) {
         await options.config.askWriteProjectFile(path.join(functionsDir, filename), content);
     }

package/lib/commands/use.js

@@ -70,7 +70,10 @@ exports.command = new command_1.Command("use [alias_or_project_id]")
             }
             if (hasAlias) {
                 if (!project) {
-                    return utils.reject("Unable to use alias " + clc.bold(newActive) + ", " + verifyMessage(resolvedProject));
+                    return utils.reject("Unable to use alias " +
+                        clc.bold(newActive) +
+                        ", " +
+                        verifyMessage(resolvedProject));
                 }
                 utils.makeActiveProject(options.projectRoot, newActive);
                 logger_1.logger.info("Now using alias", clc.bold(newActive), "(" + resolvedProject + ")");

package/lib/deploy/hosting/convertConfig.js

@@ -125,6 +125,11 @@ async function convertConfig(context, functionsPayload, deploy) {
                     region: endpoint.region,
                 } });
             if (rewrite.function.pinTag) {
+                if (endpoint.minInstances) {
+                    throw new error_1.FirebaseError(`Function ${endpoint.id} has minInstances set and is in a rewrite ` +
+                        "pinTags=true. These features are not currently compatible with each " +
+                        "other.");
+                }
                 experiments.assertEnabled("pintags", "pin a function version");
                 apiRewrite.run.tag = runTags.TODO_TAG_NAME;
             }

package/lib/deploy/hosting/prepare.js

@@ -154,7 +154,8 @@ async function unsafePins(context, config) {
     const existingUntaggedRewrites = {};
     for (const rewrite of ((_d = (_c = (_b = channelConfig === null || channelConfig === void 0 ? void 0 : channelConfig.release) === null || _b === void 0 ? void 0 : _b.version) === null || _c === void 0 ? void 0 : _c.config) === null || _d === void 0 ? void 0 : _d.rewrites) || []) {
         if ("run" in rewrite && !rewrite.run.tag) {
-            existingUntaggedRewrites[rewriteTarget(rewrite)] = `${rewrite.run.region}/${rewrite.run.serviceId}`;
+            existingUntaggedRewrites[rewriteTarget(rewrite)] =
+                `${rewrite.run.region}/${rewrite.run.serviceId}`;
         }
     }
     return Object.keys(targetTaggedRewrites).filter((target) => targetTaggedRewrites[target] === existingUntaggedRewrites[target]);

package/lib/emulator/auth/handlers.js

@@ -159,7 +159,7 @@ function registerHandlers(app, getProjectStateByApiKey) {
         res.set("Content-Type", "text/html; charset=utf-8");
         const apiKey = req.query.apiKey;
         const providerId = req.query.providerId;
-        const tenantId = req.query.tenantId;
+        const tenantId = (req.query.tenantId || req.query.tid);
         if (!apiKey || !providerId) {
             return res.status(400).json({
                 authEmulator: {