firebase-tools 13.35.1 → 14.0.1

package/lib/commands/appdistribution-groups-list.js

@@ -11,7 +11,7 @@ const requireAuth_1 = require("../requireAuth");
 const utils = require("../utils");
 const Table = require("cli-table3");
 exports.command = new command_1.Command("appdistribution:groups:list")
-    .description("list groups in project")
+    .description("list App Distribution groups")
     .alias("appdistribution:group:list")
     .before(requireAuth_1.requireAuth)
     .action(async (options) => {

package/lib/commands/appdistribution-testers-add.js

@@ -7,7 +7,7 @@ const requireAuth_1 = require("../requireAuth");
 const client_1 = require("../appdistribution/client");
 const options_parser_util_1 = require("../appdistribution/options-parser-util");
 exports.command = new command_1.Command("appdistribution:testers:add [emails...]")
-    .description("add testers to project (and possibly group)")
+    .description("add testers to project (and App Distribution group, if specified via flag)")
     .option("--file <file>", "a path to a file containing a list of tester emails to be added")
     .option("--group-alias <group-alias>", "if specified, the testers are also added to the group identified by this alias")
     .before(requireAuth_1.requireAuth)

package/lib/commands/appdistribution-testers-remove.js

@@ -9,7 +9,7 @@ const client_1 = require("../appdistribution/client");
 const options_parser_util_1 = require("../appdistribution/options-parser-util");
 const logger_1 = require("../logger");
 exports.command = new command_1.Command("appdistribution:testers:remove [emails...]")
-    .description("remove testers from a project (or group)")
+    .description("remove testers from a project (or App Distribution group, if specified via flag)")
     .option("--file <file>", "a path to a file containing a list of tester emails to be removed")
     .option("--group-alias <group-alias>", "if specified, the testers are only removed from the group identified by this alias, but not the project")
     .before(requireAuth_1.requireAuth)

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

@@ -8,23 +8,16 @@ const backend_1 = require("../apphosting/backend");
 const apphosting_1 = require("../gcp/apphosting");
 const firedata_1 = require("../gcp/firedata");
 const requireTosAcceptance_1 = require("../requireTosAcceptance");
-const utils_1 = require("../utils");
 exports.command = new command_1.Command("apphosting:backends:create")
     .description("create a Firebase App Hosting backend")
     .option("-a, --app <webAppId>", "specify an existing Firebase web app's ID to associate your App Hosting backend with")
-    .option("-l, --location <location>", "specify the location of the backend")
     .option("-s, --service-account <serviceAccount>", "specify the service account used to run the server", "")
     .before(apphosting_1.ensureApiEnabled)
     .before(requireInteractive_1.default)
     .before((0, requireTosAcceptance_1.requireTosAcceptance)(firedata_1.APPHOSTING_TOS_ID))
     .action(async (options) => {
-    if (options.location !== undefined) {
-        (0, utils_1.logWarning)("--location is being removed in the next major release. " +
-            "The CLI will prompt for a Primary Region where appropriate.");
-    }
     const projectId = (0, projectUtils_1.needProjectId)(options);
     const webAppId = options.app;
-    const location = options.location;
     const serviceAccount = options.serviceAccount;
-    await (0, backend_1.doSetup)(projectId, webAppId, location, serviceAccount);
+    await (0, backend_1.doSetup)(projectId, webAppId, serviceAccount);
 });

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

@@ -12,26 +12,13 @@ const backend_1 = require("../apphosting/backend");
 const ora = require("ora");
 exports.command = new command_1.Command("apphosting:backends:delete <backend>")
     .description("delete a Firebase App Hosting backend")
-    .option("-l, --location <location>", "specify the location of the backend")
     .withForce()
     .before(apphosting.ensureApiEnabled)
     .action(async (backendId, options) => {
-    var _a;
     const projectId = (0, projectUtils_1.needProjectId)(options);
-    if (options.location !== undefined) {
-        utils.logWarning("--location is being removed in the next major release.");
-    }
-    let location = (_a = options.location) !== null && _a !== void 0 ? _a : "-";
-    let backend;
-    if (location === "-" || location === "") {
-        backend = await (0, backend_1.getBackendForAmbiguousLocation)(projectId, backendId, "Please select the location of the backend you'd like to delete:");
-        location = apphosting.parseBackendName(backend.name).location;
-    }
-    else {
-        backend = await (0, backend_1.getBackendForLocation)(projectId, location, backendId);
-    }
-    utils.logWarning("You are about to permanently delete this backend:");
-    (0, apphosting_backends_list_1.printBackendsTable)([backend]);
+    const backends = await (0, backend_1.chooseBackends)(projectId, backendId, "Please select the backends you'd like to delete:", options.force);
+    utils.logWarning("You are about to permanently delete these backend(s):");
+    (0, apphosting_backends_list_1.printBackendsTable)(backends);
     const confirmDeletion = await (0, prompt_1.promptOnce)({
         type: "confirm",
         name: "force",
@@ -41,15 +28,18 @@ exports.command = new command_1.Command("apphosting:backends:delete <backend>")
     if (!confirmDeletion) {
         return;
     }
-    const spinner = ora("Deleting backend...").start();
-    try {
-        await (0, backend_1.deleteBackendAndPoll)(projectId, location, backendId);
-        spinner.succeed(`Successfully deleted the backend: ${backendId}`);
-    }
-    catch (err) {
-        spinner.stop();
-        throw new error_1.FirebaseError(`Failed to delete backend: ${backendId}.`, {
-            original: (0, error_1.getError)(err),
-        });
+    for (const b of backends) {
+        const { location, id } = apphosting.parseBackendName(b.name);
+        const spinner = ora(`Deleting backend ${id}(${location})...`).start();
+        try {
+            await (0, backend_1.deleteBackendAndPoll)(projectId, location, id);
+            spinner.succeed(`Successfully deleted the backend: ${id}(${location})`);
+        }
+        catch (err) {
+            spinner.stop();
+            throw new error_1.FirebaseError(`Failed to delete backend: ${id}(${location}). Please retry.`, {
+                original: (0, error_1.getError)(err),
+            });
+        }
     }
 });

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

@@ -9,26 +9,14 @@ const apphosting = require("../gcp/apphosting");
 const apphosting_backends_list_1 = require("./apphosting-backends-list");
 exports.command = new command_1.Command("apphosting:backends:get <backend>")
     .description("print info about a Firebase App Hosting backend")
-    .option("-l, --location <location>", "backend location")
     .before(apphosting.ensureApiEnabled)
     .action(async (backend, options) => {
-    var _a;
     const projectId = (0, projectUtils_1.needProjectId)(options);
-    if (options.location !== undefined) {
-        (0, utils_1.logWarning)("--location is being removed in the next major release.");
-    }
-    const location = (_a = options.location) !== null && _a !== void 0 ? _a : "-";
     let backendsList = [];
     try {
-        if (location !== "-") {
-            const backendInRegion = await apphosting.getBackend(projectId, location, backend);
-            backendsList.push(backendInRegion);
-        }
-        else {
-            const resp = await apphosting.listBackends(projectId, "-");
-            const allBackends = resp.backends || [];
-            backendsList = allBackends.filter((bkd) => bkd.name.split("/").pop() === backend);
-        }
+        const resp = await apphosting.listBackends(projectId, "-");
+        const allBackends = resp.backends || [];
+        backendsList = allBackends.filter((bkd) => bkd.name.split("/").pop() === backend);
     }
     catch (err) {
         throw new error_1.FirebaseError(`Failed to get backend: ${backend}. Please check the parameters you have provided.`, { original: (0, error_1.getError)(err) });
@@ -37,6 +25,12 @@ exports.command = new command_1.Command("apphosting:backends:get <backend>")
         (0, utils_1.logWarning)(`Backend "${backend}" not found`);
         return;
     }
-    (0, apphosting_backends_list_1.printBackendsTable)(backendsList);
+    if (backendsList.length > 1) {
+        const regions = backendsList.map((b) => apphosting.parseBackendName(b.name).location);
+        (0, utils_1.logWarning)(`Detected multiple backends with the same ${backend} ID in regions: ${regions.join(", ")}}. This is not allowed until we can support more locations.\n` +
+            `Please delete and recreate any backends that share an ID with another backend. ` +
+            `Use apphosting:backends:list to see all backends.\n Returning the following backend:`);
+    }
+    (0, apphosting_backends_list_1.printBackendsTable)(backendsList.slice(0, 1));
     return backendsList[0];
 });

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

@@ -8,27 +8,21 @@ const logger_1 = require("../logger");
 const projectUtils_1 = require("../projectUtils");
 const apphosting = require("../gcp/apphosting");
 const Table = require("cli-table3");
-const utils_2 = require("../utils");
-const TABLE_HEAD = ["Backend", "Repository", "URL", "Location", "Updated Date"];
+const TABLE_HEAD = ["Backend", "Repository", "URL", "Primary Region", "Updated Date"];
 exports.command = new command_1.Command("apphosting:backends:list")
     .description("list Firebase App Hosting backends")
-    .option("-l, --location <location>", "list backends in the specified location")
     .before(apphosting.ensureApiEnabled)
     .action(async (options) => {
-    var _a, _b;
-    if (options.location !== undefined) {
-        (0, utils_2.logWarning)("--location is being removed in the next major release.");
-    }
+    var _a;
     const projectId = (0, projectUtils_1.needProjectId)(options);
-    const location = (_a = options.location) !== null && _a !== void 0 ? _a : "-";
     let backendRes;
     try {
-        backendRes = await apphosting.listBackends(projectId, location);
+        backendRes = await apphosting.listBackends(projectId, "-");
     }
     catch (err) {
         throw new error_1.FirebaseError(`Unable to list backends present for project: ${projectId}. Please check the parameters you have provided.`, { original: err });
     }
-    const backends = (_b = backendRes.backends) !== null && _b !== void 0 ? _b : [];
+    const backends = (_a = backendRes.backends) !== null && _a !== void 0 ? _a : [];
     printBackendsTable(backends);
     return backends;
 });

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

@@ -6,25 +6,18 @@ const command_1 = require("../command");
 const projectUtils_1 = require("../projectUtils");
 const error_1 = require("../error");
 const rollout_1 = require("../apphosting/rollout");
-const utils_1 = require("../utils");
 exports.command = new command_1.Command("apphosting:rollouts:create <backendId>")
     .description("create a rollout using a build for an App Hosting backend")
-    .option("-l, --location <location>", "specify the region of the backend")
     .option("-b, --git-branch <gitBranch>", "repository branch to deploy (mutually exclusive with -g)")
     .option("-g, --git-commit <gitCommit>", "git commit to deploy (mutually exclusive with -b)")
     .withForce("Skip confirmation before creating rollout")
     .before(apphosting.ensureApiEnabled)
     .action(async (backendId, options) => {
-    var _a;
     const projectId = (0, projectUtils_1.needProjectId)(options);
-    if (options.location !== undefined) {
-        (0, utils_1.logWarning)("--location is being removed in the next major release.");
-    }
-    const location = (_a = options.location) !== null && _a !== void 0 ? _a : "-";
     const branch = options.gitBranch;
     const commit = options.gitCommit;
     if (branch && commit) {
         throw new error_1.FirebaseError("Cannot specify both a branch and commit to deploy. Please specify either --git-branch or --git-commit.");
     }
-    await (0, rollout_1.createRollout)(backendId, projectId, location, branch, commit, options.force);
+    await (0, rollout_1.createRollout)(backendId, projectId, branch, commit, options.force);
 });

package/lib/commands/apphosting-secrets-access.js

@@ -9,7 +9,7 @@ const requireAuth_1 = require("../requireAuth");
 const secretManager = require("../gcp/secretManager");
 const requirePermissions_1 = require("../requirePermissions");
 exports.command = new command_1.Command("apphosting:secrets:access <secretName[@version]>")
-    .description("Access secret value given secret and its version. Defaults to accessing the latest version.")
+    .description("access secret value given secret and its version. Defaults to accessing the latest version")
     .before(requireAuth_1.requireAuth)
     .before(secretManager.ensureApi)
     .before(requirePermissions_1.requirePermissions, ["secretmanager.versions.access"])

package/lib/commands/apphosting-secrets-describe.js

@@ -10,7 +10,7 @@ const secretManager = require("../gcp/secretManager");
 const requirePermissions_1 = require("../requirePermissions");
 const Table = require("cli-table3");
 exports.command = new command_1.Command("apphosting:secrets:describe <secretName>")
-    .description("Get metadata for secret and its versions.")
+    .description("get metadata for secret and its versions")
     .before(requireAuth_1.requireAuth)
     .before(secretManager.ensureApi)
     .before(requirePermissions_1.requirePermissions, ["secretmanager.secrets.get"])

package/lib/commands/apphosting-secrets-grantaccess.js

@@ -10,10 +10,11 @@ const requirePermissions_1 = require("../requirePermissions");
 const apphosting = require("../gcp/apphosting");
 const secrets = require("../apphosting/secrets");
 const backend_1 = require("../apphosting/backend");
-exports.command = new command_1.Command("apphosting:secrets:grantaccess <secretName>")
-    .description("grant service accounts permissions to the provided secret")
+exports.command = new command_1.Command("apphosting:secrets:grantaccess <secretNames>")
+    .description("Grant service accounts, users, or groups permissions to the provided secret(s). Can pass one or more secrets, separated by a comma")
     .option("-l, --location <location>", "backend location", "-")
     .option("-b, --backend <backend>", "backend name")
+    .option("-e, --emails <emails>", "comma delimited list of user or group emails")
     .before(requireAuth_1.requireAuth)
     .before(secretManager.ensureApi)
     .before(apphosting.ensureApiEnabled)
@@ -25,15 +26,24 @@ exports.command = new command_1.Command("apphosting:secrets:grantaccess <secretN
     "secretmanager.secrets.getIamPolicy",
     "secretmanager.secrets.setIamPolicy",
 ])
-    .action(async (secretName, options) => {
+    .action(async (secretNames, options) => {
     const projectId = (0, projectUtils_1.needProjectId)(options);
     const projectNumber = await (0, projectUtils_1.needProjectNumber)(options);
-    if (!options.backend) {
-        throw new error_1.FirebaseError("Missing required flag --backend. See firebase apphosting:secrets:grantaccess --help for more info");
+    if (!options.backend && !options.emails) {
+        throw new error_1.FirebaseError("Missing required flag --backend or --emails. See firebase apphosting:secrets:grantaccess --help for more info");
     }
-    const exists = await secretManager.secretExists(projectId, secretName);
-    if (!exists) {
-        throw new error_1.FirebaseError(`Cannot find secret ${secretName}`);
+    if (options.backend && options.emails) {
+        throw new error_1.FirebaseError("Cannot specify both --backend and --emails. See firebase apphosting:secrets:grantaccess --help for more info");
+    }
+    const secretList = secretNames.split(",");
+    for (const secretName of secretList) {
+        const exists = await secretManager.secretExists(projectId, secretName);
+        if (!exists) {
+            throw new error_1.FirebaseError(`Cannot find secret ${secretName}`);
+        }
+    }
+    if (options.emails) {
+        return await secrets.grantEmailsSecretAccess(projectId, secretList, String(options.emails).split(","));
     }
     const backendId = options.backend;
     const location = options.location;
@@ -45,5 +55,5 @@ exports.command = new command_1.Command("apphosting:secrets:grantaccess <secretN
         backend = await apphosting.getBackend(projectId, location, backendId);
     }
     const accounts = secrets.toMulti(secrets.serviceAccountsForBackend(projectNumber, backend));
-    await secrets.grantSecretAccess(projectId, projectNumber, secretName, accounts);
+    await Promise.allSettled(secretList.map((secretName) => secrets.grantSecretAccess(projectId, projectNumber, secretName, accounts)));
 });

package/lib/commands/apphosting-secrets-set.js

@@ -12,6 +12,7 @@ const secrets = require("../apphosting/secrets");
 const dialogs = require("../apphosting/secrets/dialogs");
 const config = require("../apphosting/config");
 const utils = require("../utils");
+const prompt = require("../prompt");
 exports.command = new command_1.Command("apphosting:secrets:set <secretName>")
     .description("create or update a secret for use in Firebase App Hosting")
     .option("-l, --location <location>", "optional location to retrict secret replication")
@@ -45,6 +46,31 @@ exports.command = new command_1.Command("apphosting:secrets:set <secretName>")
     if (!created) {
         return;
     }
+    const type = await prompt.promptOnce({
+        type: "list",
+        name: "type",
+        message: "Is this secret for production or only local testing?",
+        choices: [
+            { name: "Production", value: "production" },
+            { name: "Local testing only", value: "local" },
+        ],
+    });
+    if (type === "local") {
+        const emailList = await prompt.promptOnce({
+            type: "input",
+            name: "emails",
+            message: "Please enter a comma separated list of user or groups who should have access to this secret:",
+        });
+        if (emailList.length) {
+            await secrets.grantEmailsSecretAccess(projectId, [secretName], emailList.split(","));
+        }
+        else {
+            utils.logBullet("To grant access in the future run " +
+                clc.bold(`firebase apphosting:secrets:grantaccess ${secretName} --emails [email list]`));
+        }
+        await config.maybeAddSecretToYaml(secretName, config.APPHOSTING_EMULATORS_YAML_FILE);
+        return;
+    }
     const accounts = await dialogs.selectBackendServiceAccounts(projectNumber, projectId, options);
     if (!accounts.buildServiceAccounts.length && !accounts.runServiceAccounts.length) {
         utils.logWarning(`To use this secret in your backend, you must grant access. You can do so in the future with ${clc.bold("firebase apphosting:secrets:grantaccess")}`);
@@ -52,5 +78,9 @@ exports.command = new command_1.Command("apphosting:secrets:set <secretName>")
     else {
         await secrets.grantSecretAccess(projectId, projectNumber, secretName, accounts);
     }
-    await config.maybeAddSecretToYaml(secretName);
+    await config.maybeAddSecretToYaml(secretName, config.APPHOSTING_BASE_YAML_FILE);
+    utils.logBullet("To grant additional users access to this secret run " +
+        clc.bold(`firebase apphosting:secrets:grantaccess ${secretName} --email [email list]`) +
+        ".\nTo grant additional backends access to this secret run " +
+        clc.bold(`firebase apphosting:secrets:grantaccess ${secretName} --backend [backend ID]`));
 });

package/lib/commands/apps-android-sha-create.js

@@ -17,7 +17,7 @@ function getCertHashType(shaHash) {
     return apps_1.ShaCertificateType.SHA_CERTIFICATE_TYPE_UNSPECIFIED.toString();
 }
 exports.command = new command_1.Command("apps:android:sha:create <appId> <shaHash>")
-    .description("add a SHA certificate hash for a given app id.")
+    .description("add a SHA certificate hash for a given app id")
     .before(requireAuth_1.requireAuth)
     .action(async (appId = "", shaHash = "", options) => {
     const projectId = (0, projectUtils_1.needProjectId)(options);

package/lib/commands/apps-android-sha-delete.js

@@ -8,7 +8,7 @@ const apps_1 = require("../management/apps");
 const requireAuth_1 = require("../requireAuth");
 const utils_1 = require("../utils");
 exports.command = new command_1.Command("apps:android:sha:delete <appId> <shaId>")
-    .description("delete a SHA certificate hash for a given app id.")
+    .description("delete a SHA certificate hash for a given app id")
     .before(requireAuth_1.requireAuth)
     .action(async (appId = "", shaId = "", options) => {
     const projectId = (0, projectUtils_1.needProjectId)(options);

package/lib/commands/apps-android-sha-list.js

@@ -31,7 +31,7 @@ function logCertificatesCount(count = 0) {
     logger_1.logger.info(`${count} SHA hash(es) total.`);
 }
 exports.command = new command_1.Command("apps:android:sha:list <appId>")
-    .description("list the SHA certificate hashes for a given app id. ")
+    .description("list the SHA certificate hashes for a given app id")
     .before(requireAuth_1.requireAuth)
     .action(async (appId = "", options) => {
     const projectId = (0, projectUtils_1.needProjectId)(options);

package/lib/commands/apps-create.js

@@ -33,7 +33,7 @@ function logPostAppCreationInformation(appMetadata, appPlatform) {
     logger_1.logger.info(`  firebase apps:sdkconfig ${appPlatform} ${appMetadata.appId}`);
 }
 exports.command = new command_1.Command("apps:create [platform] [displayName]")
-    .description("create a new Firebase app. [platform] can be IOS, ANDROID or WEB (case insensitive).")
+    .description("create a new Firebase app. [platform] can be IOS, ANDROID or WEB (case insensitive)")
     .option("-a, --package-name <packageName>", "required package name for the Android app")
     .option("-b, --bundle-id <bundleId>", "required bundle id for the iOS app")
     .option("-s, --app-store-id <appStoreId>", "(optional) app store id for the iOS app")

package/lib/commands/apps-init.js

@@ -52,7 +52,7 @@ function toAppPlatform(str) {
     throw new Error(`Platform ${str} is not compatible with apps:configure`);
 }
 exports.command = new command_1.Command("apps:init [platform] [appId]")
-    .description("Automatically download and create config of a Firebase app. ")
+    .description("automatically download and create config of a Firebase app")
     .before(requireAuth_1.requireAuth)
     .option("-o, --out [file]", "(optional) write config output to a file")
     .action(async (platform = "", appId = "", options) => {

package/lib/commands/auth-export.js

@@ -11,7 +11,7 @@ const requirePermissions_1 = require("../requirePermissions");
 const accountExporter_1 = require("../accountExporter");
 const MAX_BATCH_SIZE = 1000;
 exports.command = new command_1.Command("auth:export [dataFile]")
-    .description("Export accounts from your Firebase project into a data file")
+    .description("export accounts from your Firebase project into a data file")
     .option("--format <format>", "Format of exported data (csv, json). Ignored if <dataFile> has format extension.")
     .before(requirePermissions_1.requirePermissions, ["firebaseauth.users.get"])
     .action((dataFile, options) => {

package/lib/commands/auth-import.js

@@ -15,7 +15,7 @@ const requirePermissions_1 = require("../requirePermissions");
 const accountImporter_1 = require("../accountImporter");
 const MAX_BATCH_SIZE = 1000;
 exports.command = new command_1.Command("auth:import [dataFile]")
-    .description("import users into your Firebase project from a data file(.csv or .json)")
+    .description("import users into your Firebase project from a data file (.csv or .json)")
     .option("--hash-algo <hashAlgo>", "specify the hash algorithm used in password for these accounts")
     .option("--hash-key <hashKey>", "specify the key used in hash algorithm")
     .option("--salt-separator <saltSeparator>", "specify the salt separator which will be appended to salt when verifying password. only used by SCRYPT now.")

package/lib/commands/database-instances-create.js

@@ -12,7 +12,7 @@ const getDefaultDatabaseInstance_1 = require("../getDefaultDatabaseInstance");
 const error_1 = require("../error");
 const requireDatabaseInstance_1 = require("../requireDatabaseInstance");
 exports.command = new command_1.Command("database:instances:create <instanceName>")
-    .description("create a realtime database instance")
+    .description("create a Realtime Database instance")
     .option("-l, --location <location>", "(optional) location for the database instance, defaults to us-central1")
     .before(requirePermissions_1.requirePermissions, ["firebasedatabase.instances.create"])
     .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.DATABASE)

package/lib/commands/database-profile.js

@@ -9,9 +9,8 @@ const utils = require("../utils");
 const profiler_1 = require("../profiler");
 const types_1 = require("../emulator/types");
 const commandUtils_1 = require("../emulator/commandUtils");
-const description = "profile the Realtime Database and generate a usage report";
 exports.command = new command_1.Command("database:profile")
-    .description(description)
+    .description("profile the Realtime Database and generate a usage report")
     .option("-o, --output <filename>", "save the output to the specified file")
     .option("-d, --duration <seconds>", "collect database usage information for the specified number of seconds")
     .option("--raw", "output the raw stats collected as newline delimited json")

package/lib/commands/database-settings-set.js

@@ -14,7 +14,7 @@ const commandUtils_1 = require("../emulator/commandUtils");
 const requireDatabaseInstance_1 = require("../requireDatabaseInstance");
 const utils = require("../utils");
 exports.command = new command_1.Command("database:settings:set <path> <value>")
-    .description("set the realtime database setting at path.")
+    .description("set the Realtime Database setting at path")
     .option("--instance <instance>", "use the database <instance>.firebaseio.com (if omitted, use default database instance)")
     .help(settings_1.HELP_TEXT)
     .before(requirePermissions_1.requirePermissions, ["firebasedatabase.instances.update"])

package/lib/commands/database-update.js

@@ -17,7 +17,7 @@ const logger_1 = require("../logger");
 const requireDatabaseInstance_1 = require("../requireDatabaseInstance");
 const utils = require("../utils");
 exports.command = new command_1.Command("database:update <path> [infile]")
-    .description("update some of the keys for the defined path in your Firebase")
+    .description("update some of the keys for the defined path in your Realtime Database")
     .option("-d, --data <data>", "specify escaped JSON directly")
     .option("-f, --force", "pass this option to bypass confirmation prompt")
     .option("--instance <instance>", "use the database <instance>.firebaseio.com (if omitted, use default database instance)")

package/lib/commands/dataconnect-sdk-generate.js

@@ -10,7 +10,7 @@ const fileUtils_1 = require("../dataconnect/fileUtils");
 const logger_1 = require("../logger");
 const auth_1 = require("../auth");
 exports.command = new command_1.Command("dataconnect:sdk:generate")
-    .description("generates typed SDKs for your Data Connect connectors")
+    .description("generate typed SDKs for your Data Connect connectors")
     .option("--watch", "watch for changes to your connector GQL files and regenerate your SDKs when updates occur")
     .action(async (options) => {
     const projectId = (0, projectUtils_1.needProjectId)(options);

package/lib/commands/dataconnect-services-list.js

@@ -10,7 +10,7 @@ const requirePermissions_1 = require("../requirePermissions");
 const ensureApis_1 = require("../dataconnect/ensureApis");
 const Table = require("cli-table3");
 exports.command = new command_1.Command("dataconnect:services:list")
-    .description("list all deployed services in your Firebase project")
+    .description("list all deployed Data Connect services")
     .before(requirePermissions_1.requirePermissions, [
     "dataconnect.services.list",
     "dataconnect.schemas.list",

package/lib/commands/dataconnect-sql-diff.js

@@ -9,7 +9,7 @@ const fileUtils_1 = require("../dataconnect/fileUtils");
 const schemaMigration_1 = require("../dataconnect/schemaMigration");
 const requireAuth_1 = require("../requireAuth");
 exports.command = new command_1.Command("dataconnect:sql:diff [serviceId]")
-    .description("displays the differences between  a local DataConnect schema and your CloudSQL database's current schema")
+    .description("display the differences between a local Data Connect schema and your CloudSQL database's current schema")
     .before(requirePermissions_1.requirePermissions, [
     "firebasedataconnect.services.list",
     "firebasedataconnect.schemas.list",

package/lib/commands/dataconnect-sql-grant.js

@@ -12,7 +12,7 @@ const error_1 = require("../error");
 const permissions_setup_1 = require("../gcp/cloudsql/permissions_setup");
 const allowedRoles = Object.keys(permissions_setup_1.fdcSqlRoleMap);
 exports.command = new command_1.Command("dataconnect:sql:grant [serviceId]")
-    .description("Grants the SQL role <role> to the provided user or service account <email>.")
+    .description("grants the SQL role <role> to the provided user or service account <email>")
     .option("-R, --role <role>", "The SQL role to grant. One of: owner, writer, or reader.")
     .option("-E, --email <email>", "The email of the user or service account we would like to grant the role to.")
     .before(requirePermissions_1.requirePermissions, ["firebasedataconnect.services.list"])

package/lib/commands/dataconnect-sql-migrate.js

@@ -11,7 +11,7 @@ const requirePermissions_1 = require("../requirePermissions");
 const ensureApis_1 = require("../dataconnect/ensureApis");
 const utils_1 = require("../utils");
 exports.command = new command_1.Command("dataconnect:sql:migrate [serviceId]")
-    .description("migrates your CloudSQL database's schema to match your local DataConnect schema")
+    .description("migrate your CloudSQL database's schema to match your local Data Connect schema")
     .before(requirePermissions_1.requirePermissions, [
     "firebasedataconnect.services.list",
     "firebasedataconnect.schemas.list",
@@ -19,7 +19,7 @@ exports.command = new command_1.Command("dataconnect:sql:migrate [serviceId]")
     "cloudsql.instances.connect",
 ])
     .before(requireAuth_1.requireAuth)
-    .withForce("Execute any required database changes without prompting")
+    .withForce("execute any required database changes without prompting")
     .action(async (serviceId, options) => {
     var _a, _b;
     const projectId = (0, projectUtils_1.needProjectId)(options);

package/lib/commands/dataconnect-sql-setup.js

@@ -14,7 +14,7 @@ const schemaMigration_1 = require("../dataconnect/schemaMigration");
 const connect_1 = require("../gcp/cloudsql/connect");
 const cloudSqlAdminClient = require("../gcp/cloudsql/cloudsqladmin");
 exports.command = new command_1.Command("dataconnect:sql:setup [serviceId]")
-    .description("Setup your CloudSQL database")
+    .description("set up your CloudSQL database")
     .before(requirePermissions_1.requirePermissions, [
     "firebasedataconnect.services.list",
     "firebasedataconnect.schemas.list",

package/lib/commands/dataconnect-sql-shell.js

@@ -75,7 +75,7 @@ async function mainShellLoop(conn) {
     }
 }
 exports.command = new command_1.Command("dataconnect:sql:shell [serviceId]")
-    .description("Starts a shell connected directly to your dataconnect cloudsql instance.")
+    .description("start a shell connected directly to your Data Connect service's linked CloudSQL instance")
     .before(requirePermissions_1.requirePermissions, ["firebasedataconnect.services.list", "cloudsql.instances.connect"])
     .before(requireAuth_1.requireAuth)
     .action(async (serviceId, options) => {

package/lib/commands/deploy.js

@@ -84,10 +84,10 @@ exports.command = new command_1.Command("deploy")
     "When filtering based on codebases, use colons to specify codebase names " +
     '(e.g. "--only functions:codebase1:func1,functions:codebase2:group1.subgroup1"). ' +
     "For data connect, can specify filters with colons to deploy only a service, connector, or schema" +
-    '(e.g. "--only dataconnect:serviceId,dataconnect:serviceId:connectorId,dataconnect:serviceId:schema"). ')
+    '(e.g. "--only dataconnect:serviceId,dataconnect:serviceId:connectorId,dataconnect:serviceId:schema")')
     .option("--except <targets>", 'deploy to all targets except specified (e.g. "database")')
-    .option("--dry-run", "Perform a dry run of your deployment. Validates your changes and builds your code without deploying any changes to your project. " +
-    "In order to provide better validation, this may still enable APIs on the target project.")
+    .option("--dry-run", "perform a dry run of your deployment. Validates your changes and builds your code without deploying any changes to your project. " +
+    "In order to provide better validation, this may still enable APIs on the target project")
     .before(requireConfig_1.requireConfig)
     .before((options) => {
     options.filteredTargets = (0, filterTargets_1.filterTargets)(options, exports.VALID_DEPLOY_TARGETS);

package/lib/commands/emulators-exec.js

@@ -7,7 +7,7 @@ const commandUtils_1 = require("../emulator/commandUtils");
 exports.command = new command_1.Command("emulators:exec <script>")
     .before(commandUtils.setExportOnExitOptions)
     .before(commandUtils.beforeEmulatorCommand)
-    .description("start the local Firebase emulators, " + "run a test script, then shut down the emulators")
+    .description("start the local Firebase emulators, run a test script, then shut down the emulators")
     .option(commandUtils.FLAG_ONLY, commandUtils.DESC_ONLY)
     .option(commandUtils.FLAG_INSPECT_FUNCTIONS, commandUtils.DESC_INSPECT_FUNCTIONS)
     .option(commandUtils.FLAG_IMPORT, commandUtils.DESC_IMPORT)

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

@@ -13,7 +13,7 @@ const requirePermissions_1 = require("../requirePermissions");
 const error_1 = require("../error");
 const utils = require("../utils");
 exports.command = new command_1.Command("ext:dev:register")
-    .description("register a publisher ID; run this before publishing your first extension.")
+    .description("register a publisher ID; run this before publishing your first extension")
     .before(requirePermissions_1.requirePermissions, ["firebaseextensions.sources.create"])
     .before(extensionsHelper_1.ensureExtensionsPublisherApiEnabled)
     .before(extensionsHelper_1.ensureExtensionsApiEnabled)

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

@@ -16,10 +16,10 @@ const logger_1 = require("../logger");
 const prompt_1 = require("../prompt");
 const shortenUrl_1 = require("../shortenUrl");
 exports.command = new command_1.Command("ext:dev:usage <publisherId>")
-    .description("get usage for an extension")
+    .description("get usage statistics for an extension")
     .help("use this command to get the usage of extensions you published. " +
     "Specify the publisher ID you used to publish your extensions, " +
-    "or the extension ref of your published extension.")
+    "or the extension ref of your published extension")
     .before(requireAuth_1.requireAuth)
     .before(checkMinRequiredVersion_1.checkMinRequiredVersion, "extDevMinVersion")
     .action(async (input) => {

package/lib/commands/ext-install.js

@@ -23,9 +23,8 @@ const track_1 = require("../track");
 const prompt_1 = require("../prompt");
 const manifest = require("../extensions/manifest");
 const tos_1 = require("../extensions/tos");
-exports.command = new command_1.Command("ext:install [extensionRef]")
-    .description("add an uploaded extension to firebase.json if [publisherId/extensionId] is provided;" +
-    "or, add a local extension if [localPath] is provided")
+exports.command = new command_1.Command("ext:install [extensionRefOrLocalPath]")
+    .description("add an extension to firebase.json")
     .option("--local", "deprecated")
     .withForce()
     .before(requirePermissions_1.requirePermissions, ["firebaseextensions.instances.create"])