firebase-tools 13.35.0 → 14.0.0

package/lib/commands/firestore-backups-list.js

@@ -10,8 +10,8 @@ const firestore_1 = require("../gcp/firestore");
 const utils_1 = require("../utils");
 const pretty_print_1 = require("../firestore/pretty-print");
 exports.command = new command_1.Command("firestore:backups:list")
-    .description("List all Cloud Firestore backups in a given location")
-    .option("-l, --location <locationId>", "Location to search for backups, for example 'nam5'. Run 'firebase firestore:locations' to get a list of eligible locations. Defaults to all locations.")
+    .description("list all Cloud Firestore backups in a given location")
+    .option("-l, --location <locationId>", "location to search for backups, for example 'nam5'. Run 'firebase firestore:locations' to get a list of eligible locations. Defaults to all locations")
     .before(requirePermissions_1.requirePermissions, ["datastore.backups.list"])
     .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.FIRESTORE)
     .action(async (options) => {

package/lib/commands/firestore-backups-schedules-create.js

@@ -13,11 +13,11 @@ const commandUtils_1 = require("../emulator/commandUtils");
 const pretty_print_1 = require("../firestore/pretty-print");
 const error_1 = require("../error");
 exports.command = new command_1.Command("firestore:backups:schedules:create")
-    .description("Create a backup schedule under your Cloud Firestore database.")
-    .option("-d, --database <databaseId>", "Database under which you want to create a schedule. Defaults to the (default) database")
+    .description("create a backup schedule under your Cloud Firestore database")
+    .option("-d, --database <databaseId>", "database under which you want to create a schedule. Defaults to the (default) database")
     .option("--retention <duration>", "duration string (e.g. 12h or 30d) for backup retention")
-    .option("--recurrence <recurrence>", "Recurrence settings; either DAILY or WEEKLY")
-    .option("--day-of-week <dayOfWeek>", "On which day of the week to perform backups; one of MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, or SUNDAY")
+    .option("--recurrence <recurrence>", "recurrence settings; either DAILY or WEEKLY")
+    .option("--day-of-week <dayOfWeek>", "on which day of the week to perform backups; one of MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, or SUNDAY")
     .before(requirePermissions_1.requirePermissions, ["datastore.backupSchedules.create"])
     .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.FIRESTORE)
     .action(async (options) => {

package/lib/commands/firestore-backups-schedules-delete.js

@@ -11,8 +11,8 @@ const types_1 = require("../emulator/types");
 const commandUtils_1 = require("../emulator/commandUtils");
 const error_1 = require("../error");
 exports.command = new command_1.Command("firestore:backups:schedules:delete <backupSchedule>")
-    .description("Delete a backup schedule under your Cloud Firestore database.")
-    .option("--force", "Attempt to delete backup schedule without prompting for confirmation.")
+    .description("delete a backup schedule under your Cloud Firestore database")
+    .option("--force", "attempt to delete backup schedule without prompting for confirmation")
     .before(requirePermissions_1.requirePermissions, ["datastore.backupSchedules.delete"])
     .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.FIRESTORE)
     .action(async (backupScheduleName, options) => {

package/lib/commands/firestore-backups-schedules-list.js

@@ -9,8 +9,8 @@ const commandUtils_1 = require("../emulator/commandUtils");
 const firestore_1 = require("../gcp/firestore");
 const pretty_print_1 = require("../firestore/pretty-print");
 exports.command = new command_1.Command("firestore:backups:schedules:list")
-    .description("List backup schedules under your Cloud Firestore database.")
-    .option("-d, --database <databaseId>", "Database whose schedules you wish to list. Defaults to the (default) database.")
+    .description("list backup schedules under your Cloud Firestore database")
+    .option("-d, --database <databaseId>", "database whose schedules you wish to list. Defaults to the (default) database")
     .before(requirePermissions_1.requirePermissions, ["datastore.backupSchedules.list"])
     .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.FIRESTORE)
     .action(async (options) => {

package/lib/commands/firestore-backups-schedules-update.js

@@ -12,7 +12,7 @@ const commandUtils_1 = require("../emulator/commandUtils");
 const pretty_print_1 = require("../firestore/pretty-print");
 const error_1 = require("../error");
 exports.command = new command_1.Command("firestore:backups:schedules:update <backupSchedule>")
-    .description("Update a backup schedule under your Cloud Firestore database.")
+    .description("update a backup schedule under your Cloud Firestore database")
     .option("--retention <duration>", "duration string (e.g. 12h or 30d) for backup retention")
     .before(requirePermissions_1.requirePermissions, ["datastore.backupSchedules.update"])
     .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.FIRESTORE)

package/lib/commands/firestore-databases-create.js

@@ -12,13 +12,13 @@ const commandUtils_1 = require("../emulator/commandUtils");
 const pretty_print_1 = require("../firestore/pretty-print");
 const error_1 = require("../error");
 exports.command = new command_1.Command("firestore:databases:create <database>")
-    .description("Create a database in your Firebase project.")
-    .option("--location <locationId>", "Region to create database, for example 'nam5'. Run 'firebase firestore:locations' to get a list of eligible locations. (required)")
-    .option("--delete-protection <deleteProtectionState>", "Whether or not to prevent deletion of database, for example 'ENABLED' or 'DISABLED'. Default is 'DISABLED'")
-    .option("--point-in-time-recovery <enablement>", "Whether to enable the PITR feature on this database, for example 'ENABLED' or 'DISABLED'. Default is 'DISABLED'")
-    .option("-k, --kms-key-name <kmsKeyName>", "The resource ID of a Cloud KMS key. If set, the database created will be a " +
+    .description("create a database in your Firebase project")
+    .option("--location <locationId>", "region to create database, for example 'nam5'. Run 'firebase firestore:locations' to get a list of eligible locations (required)")
+    .option("--delete-protection <deleteProtectionState>", "whether or not to prevent deletion of database, for example 'ENABLED' or 'DISABLED'. Default is 'DISABLED'")
+    .option("--point-in-time-recovery <enablement>", "whether to enable the PITR feature on this database, for example 'ENABLED' or 'DISABLED'. Default is 'DISABLED'")
+    .option("-k, --kms-key-name <kmsKeyName>", "the resource ID of a Cloud KMS key. If set, the database created will be a " +
     "Customer-managed Encryption Key (CMEK) database encrypted with this key. " +
-    "This feature is allowlist only in initial launch.")
+    "This feature is allowlist only in initial launch")
     .before(requirePermissions_1.requirePermissions, ["datastore.databases.create"])
     .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.FIRESTORE)
     .action(async (database, options) => {

package/lib/commands/firestore-databases-delete.js

@@ -12,8 +12,8 @@ const commandUtils_1 = require("../emulator/commandUtils");
 const error_1 = require("../error");
 const pretty_print_1 = require("../firestore/pretty-print");
 exports.command = new command_1.Command("firestore:databases:delete <database>")
-    .description("Delete a database in your Cloud Firestore project. Database delete protection state must be disabled. To do so, use the update command: firebase firestore:databases:update <database> --delete-protection DISABLED")
-    .option("--force", "Attempt to delete database without prompting for confirmation.")
+    .description("delete a database in your Cloud Firestore project")
+    .option("--force", "attempt to delete database without prompting for confirmation")
     .before(requirePermissions_1.requirePermissions, ["datastore.databases.delete"])
     .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.FIRESTORE)
     .action(async (database, options) => {

package/lib/commands/firestore-databases-get.js

@@ -9,7 +9,7 @@ const types_1 = require("../emulator/types");
 const commandUtils_1 = require("../emulator/commandUtils");
 const pretty_print_1 = require("../firestore/pretty-print");
 exports.command = new command_1.Command("firestore:databases:get [database]")
-    .description("Get database in your Cloud Firestore project.")
+    .description("get information about a Cloud Firestore database")
     .before(requirePermissions_1.requirePermissions, ["datastore.databases.get"])
     .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.FIRESTORE)
     .action(async (database, options) => {

package/lib/commands/firestore-databases-list.js

@@ -9,7 +9,7 @@ const types_1 = require("../emulator/types");
 const commandUtils_1 = require("../emulator/commandUtils");
 const pretty_print_1 = require("../firestore/pretty-print");
 exports.command = new command_1.Command("firestore:databases:list")
-    .description("List databases in your Cloud Firestore project.")
+    .description("list the Cloud Firestore databases on your project")
     .before(requirePermissions_1.requirePermissions, ["datastore.databases.list"])
     .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.FIRESTORE)
     .action(async (options) => {

package/lib/commands/firestore-databases-restore.js

@@ -12,13 +12,13 @@ const options_1 = require("../firestore/options");
 const pretty_print_1 = require("../firestore/pretty-print");
 const error_1 = require("../error");
 exports.command = new command_1.Command("firestore:databases:restore")
-    .description("Restore a Firestore database in your Firebase project.")
+    .description("restore a Firestore database from a backup")
     .option("-d, --database <databaseID>", "ID of the database to restore into")
-    .option("-b, --backup <backup>", "Backup from which to restore")
-    .option("-e, --encryption-type <encryptionType>", `Encryption method of the restored database; one of ${options_1.EncryptionType.USE_SOURCE_ENCRYPTION} (default), ` +
+    .option("-b, --backup <backup>", "backup from which to restore")
+    .option("-e, --encryption-type <encryptionType>", `encryption method of the restored database; one of ${options_1.EncryptionType.USE_SOURCE_ENCRYPTION} (default), ` +
     `${options_1.EncryptionType.CUSTOMER_MANAGED_ENCRYPTION}, ${options_1.EncryptionType.GOOGLE_DEFAULT_ENCRYPTION}`)
-    .option("-k, --kms-key-name <kmsKeyName>", "Resource ID of the Cloud KMS key to encrypt the restored database. This " +
-    "feature is allowlist only in initial launch.")
+    .option("-k, --kms-key-name <kmsKeyName>", "resource ID of the Cloud KMS key to encrypt the restored database. This " +
+    "feature is allowlist only in initial launch")
     .before(requirePermissions_1.requirePermissions, ["datastore.backups.restoreDatabase"])
     .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.FIRESTORE)
     .action(async (options) => {

package/lib/commands/firestore-databases-update.js

@@ -12,10 +12,10 @@ const commandUtils_1 = require("../emulator/commandUtils");
 const pretty_print_1 = require("../firestore/pretty-print");
 const error_1 = require("../error");
 exports.command = new command_1.Command("firestore:databases:update <database>")
-    .description("Update a database in your Firebase project. Must specify at least one property to update.")
-    .option("--json", "Prints raw json response of the create API call if specified")
-    .option("--delete-protection <deleteProtectionState>", "Whether or not to prevent deletion of database, for example 'ENABLED' or 'DISABLED'. Default is 'DISABLED'")
-    .option("--point-in-time-recovery <enablement>", "Whether to enable the PITR feature on this database, for example 'ENABLED' or 'DISABLED'. Default is 'DISABLED'")
+    .description("update a database in your Firebase project. Must specify at least one property to update")
+    .option("--json", "prints raw json response of the create API call if specified")
+    .option("--delete-protection <deleteProtectionState>", "whether or not to prevent deletion of database, for example 'ENABLED' or 'DISABLED'. Default is 'DISABLED'")
+    .option("--point-in-time-recovery <enablement>", "whether to enable the PITR feature on this database, for example 'ENABLED' or 'DISABLED'. Default is 'DISABLED'")
     .before(requirePermissions_1.requirePermissions, ["datastore.databases.update"])
     .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.FIRESTORE)
     .action(async (database, options) => {

package/lib/commands/firestore-delete.js

@@ -47,15 +47,14 @@ function confirmationMessage(deleteOp, options) {
         ". Are you sure?");
 }
 exports.command = new command_1.Command("firestore:delete [path]")
-    .description("Delete data from Cloud Firestore.")
-    .option("-r, --recursive", "Recursive. Delete all documents and subcollections at and under the " +
-    "specified level. May not be passed along with --shallow.")
-    .option("--shallow", "Shallow. Delete only documents at the specified level and ignore documents in " +
+    .description("delete data from a Cloud Firestore database")
+    .option("-r, --recursive", "if set, recursively delete all documents and subcollections at and under the " +
+    "specified level. May not be passed along with --shallow")
+    .option("--shallow", "delete only documents at the specified level and ignore documents in " +
     "subcollections. This action can potentially orphan documents nested in " +
-    "subcollections. May not be passed along with -r.")
-    .option("--all-collections", "Delete all. Deletes the entire Firestore database, " +
-    "including all collections and documents. Any other flags or arguments will be ignored.")
-    .option("-f, --force", "No confirmation. Otherwise, a confirmation prompt will appear.")
+    "subcollections. May not be passed along with -r")
+    .option("--all-collections", "deletes all collections and documents in the Firestore database")
+    .withForce()
     .option("--database <databaseId>", 'Database ID for database to delete from. "(default)" if none is provided.')
     .before(commandUtils_1.printNoticeIfEmulated, types_1.Emulators.FIRESTORE)
     .before(requirePermissions_1.requirePermissions, ["datastore.entities.list", "datastore.entities.delete"])

package/lib/commands/firestore-indexes-list.js

@@ -11,10 +11,10 @@ const commandUtils_1 = require("../emulator/commandUtils");
 const pretty_print_1 = require("../firestore/pretty-print");
 const projectUtils_1 = require("../projectUtils");
 exports.command = new command_1.Command("firestore:indexes")
-    .description("List indexes in your project's Cloud Firestore database.")
-    .option("--pretty", "Pretty print. When not specified the indexes are printed in the " +
-    "JSON specification format.")
-    .option("--database <databaseId>", "Database ID of the firestore database from which to list indexes. (default) if none provided.")
+    .description("list indexes in a Cloud Firestore database")
+    .option("--pretty", "pretty print the indexes. When not specified the indexes are printed in the " +
+    "JSON specification format")
+    .option("--database <databaseId>", "database ID of the firestore database from which to list indexes. (default) if none provided")
     .before(requirePermissions_1.requirePermissions, ["datastore.indexes.list"])
     .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.FIRESTORE)
     .action(async (options) => {

package/lib/commands/firestore-locations.js

@@ -9,7 +9,7 @@ const types_1 = require("../emulator/types");
 const commandUtils_1 = require("../emulator/commandUtils");
 const pretty_print_1 = require("../firestore/pretty-print");
 exports.command = new command_1.Command("firestore:locations")
-    .description("List possible locations for your Cloud Firestore project.")
+    .description("list possible locations for your Cloud Firestore database")
     .before(requirePermissions_1.requirePermissions, ["datastore.locations.list"])
     .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.FIRESTORE)
     .action(async (options) => {

package/lib/commands/functions-artifacts-setpolicy.js

@@ -12,18 +12,13 @@ const utils_1 = require("../utils");
 const artifactregistry = require("../gcp/artifactregistry");
 const artifacts = require("../functions/artifacts");
 exports.command = new command_1.Command("functions:artifacts:setpolicy")
-    .description("Set up a cleanup policy for Cloud Run functions container images in Artifact Registry. " +
-    "This policy will automatically delete old container images created during functions deployment.")
-    .option("--location <location>", "Specify location to set up the cleanup policy. " +
-    "If omitted, uses the default functions location.", "us-central1")
-    .option("--days <days>", "Number of days to keep container images before deletion. Default is 3 days.", "3")
-    .option("--none", "Opt-out from cleanup policy. This will prevent suggestions to set up a cleanup policy during initialization and deployment.")
-    .before((options) => {
-    if (options.days && options.none) {
-        throw new error_1.FirebaseError("Cannot specify both --days and --none options.");
-    }
-})
-    .withForce("Automatically create or modify cleanup policy")
+    .description("set up a cleanup policy for Cloud Run functions container images in Artifact Registry " +
+    "to automatically delete old function images")
+    .option("--location <location>", "specify location to set up the cleanup policy. " +
+    "If omitted, uses the default functions location", "us-central1")
+    .option("--days <days>", `number of days to keep container images before deletion. Default is ${artifacts.DEFAULT_CLEANUP_DAYS} day`)
+    .option("--none", "opt-out from cleanup policy. This will prevent suggestions to set up a cleanup policy during initialization and deployment")
+    .withForce("automatically create or modify cleanup policy")
     .before(requireAuth_1.requireAuth)
     .before(async (options) => {
     const projectId = (0, projectUtils_1.needProjectId)(options);
@@ -35,9 +30,12 @@ exports.command = new command_1.Command("functions:artifacts:setpolicy")
 ])
     .action(async (options) => {
     var _a;
+    if (options.days && options.none) {
+        throw new error_1.FirebaseError("Cannot specify both --days and --none options.");
+    }
     const projectId = (0, projectUtils_1.needProjectId)(options);
     const location = options.location || "us-central1";
-    let daysToKeep = parseInt(options.days || "3", 10);
+    let daysToKeep = parseInt(options.days || artifacts.DEFAULT_CLEANUP_DAYS, 10);
     const repoPath = artifacts.makeRepoPath(projectId, location);
     let repository;
     try {

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

@@ -71,7 +71,7 @@ function fromEntries(itr) {
     return obj;
 }
 exports.command = new command_1.Command("functions:config:export")
-    .description("Export environment config as environment variables in dotenv format")
+    .description("export environment config as environment variables in dotenv format")
     .before(requirePermissions_1.requirePermissions, [
     "runtimeconfig.configs.list",
     "runtimeconfig.configs.get",

package/lib/commands/functions-deletegcfartifacts.js

@@ -16,7 +16,7 @@ function getConfirmationMessage(paths) {
     return message;
 }
 exports.command = new command_1.Command("functions:deletegcfartifacts")
-    .description("Deletes all artifacts created by Google Cloud Functions on Google Container Registry.")
+    .description("deletes all artifacts created by Google Cloud Functions on Google Container Registry")
     .option("--regions <regions>", "Specify regions of artifacts to be deleted. " +
     "If omitted, artifacts from all regions will be deleted. " +
     "<regions> is a Google defined region list, e.g. us-central1,us-east1,europe-west2.")

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

@@ -9,7 +9,7 @@ const requireAuth_1 = require("../requireAuth");
 const secretManager = require("../gcp/secretManager");
 const secrets_1 = require("../apphosting/secrets");
 exports.command = new command_1.Command("functions:secrets:access <KEY>[@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)
     .action(async (key, options) => {

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

@@ -7,7 +7,7 @@ const requirePermissions_1 = require("../requirePermissions");
 const secretManager = require("../gcp/secretManager");
 const secrets = require("../functions/secrets");
 exports.command = new command_1.Command("functions:secrets:describe <KEY>")
-    .description("Get metadata for secret and its versions. Alias for functions:secrets:get to align with gcloud")
+    .description("get metadata for secret and its versions. Alias for functions:secrets:get to align with gcloud")
     .before(requireAuth_1.requireAuth)
     .before(secretManager.ensureApi)
     .before(requirePermissions_1.requirePermissions, ["secretmanager.secrets.get"])

package/lib/commands/functions-secrets-destroy.js

@@ -10,8 +10,8 @@ const requireAuth_1 = require("../requireAuth");
 const secrets = require("../functions/secrets");
 const backend = require("../deploy/functions/backend");
 exports.command = new command_1.Command("functions:secrets:destroy <KEY>[@version]")
-    .description("Destroy a secret. Defaults to destroying the latest version.")
-    .withForce("Destroys a secret without confirmation.")
+    .description("destroy a secret. Defaults to destroying the latest version")
+    .withForce("destroy a secret without confirmation")
     .before(requireAuth_1.requireAuth)
     .before(secretManager_1.ensureApi)
     .action(async (key, options) => {

package/lib/commands/functions-secrets-get.js

@@ -7,7 +7,7 @@ const requirePermissions_1 = require("../requirePermissions");
 const secretManager = require("../gcp/secretManager");
 const secrets = require("../functions/secrets");
 exports.command = new command_1.Command("functions:secrets:get <KEY>")
-    .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/functions-secrets-prune.js

@@ -13,8 +13,8 @@ const prompt_1 = require("../prompt");
 const secretManager_1 = require("../gcp/secretManager");
 const requireAuth_1 = require("../requireAuth");
 exports.command = new command_1.Command("functions:secrets:prune")
-    .withForce("Destroys unused secrets without prompt")
-    .description("Destroys unused secrets")
+    .withForce("destroy unused secrets without prompt")
+    .description("destroy unused secrets")
     .before(requireAuth_1.requireAuth)
     .before(secretManager.ensureApi)
     .before(requirePermissions_1.requirePermissions, [

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

@@ -15,8 +15,8 @@ const requireAuth_1 = require("../requireAuth");
 const secrets = require("../functions/secrets");
 const backend = require("../deploy/functions/backend");
 exports.command = new command_1.Command("functions:secrets:set <KEY>")
-    .description("Create or update a secret for use in Cloud Functions for Firebase.")
-    .withForce("Automatically updates functions to use the new secret.")
+    .description("create or update a secret for use in Cloud Functions for Firebase")
+    .withForce("automatically updates functions to use the new secret")
     .before(requireAuth_1.requireAuth)
     .before(secretManager_1.ensureApi)
     .before(requirePermissions_1.requirePermissions, [
@@ -25,7 +25,7 @@ exports.command = new command_1.Command("functions:secrets:set <KEY>")
     "secretmanager.secrets.update",
     "secretmanager.versions.add",
 ])
-    .option("--data-file <dataFile>", 'File path from which to read secret data. Set to "-" to read the secret data from stdin.')
+    .option("--data-file <dataFile>", 'file path from which to read secret data. Set to "-" to read the secret data from stdin')
     .action(async (unvalidatedKey, options) => {
     const projectId = (0, projectUtils_1.needProjectId)(options);
     const projectNumber = await (0, projectUtils_1.needProjectNumber)(options);

package/lib/commands/index.js

@@ -71,9 +71,6 @@ function load(client) {
     client.emulators.exec = loadCommand("emulators-exec");
     client.emulators.export = loadCommand("emulators-export");
     client.emulators.start = loadCommand("emulators-start");
-    client.experimental = {};
-    client.experimental.functions = {};
-    client.experimental.functions.shell = loadCommand("experimental-functions-shell");
     client.experiments = {};
     client.experiments.list = loadCommand("experiments-list");
     client.experiments.describe = loadCommand("experiments-describe");
@@ -178,7 +175,6 @@ function load(client) {
         client.apphosting.rollouts = {};
         client.apphosting.rollouts.create = loadCommand("apphosting-rollouts-create");
         client.apphosting.config = {};
-        client.apphosting.config.export = loadCommand("apphosting-config-export");
         if (experiments.isEnabled("internaltesting")) {
             client.apphosting.builds = {};
             client.apphosting.builds.get = loadCommand("apphosting-builds-get");

package/lib/commands/init.js

@@ -98,7 +98,7 @@ if ((0, experiments_1.isEnabled)("genkit")) {
     ];
 }
 const featureNames = choices.map((choice) => choice.value);
-const DESCRIPTION = `Interactively configure the current directory as a Firebase project or initialize new features in an already configured Firebase project directory.
+const HELP = `Interactively configure the current directory as a Firebase project or initialize new features in an already configured Firebase project directory.
 
 This command will create or update 'firebase.json' and '.firebaserc' configuration files in the current directory.
 
@@ -108,7 +108,8 @@ ${[...featureNames]
     .map((n) => `\n  - ${n}`)
     .join("")}`;
 exports.command = new command_1.Command("init [feature]")
-    .description(DESCRIPTION)
+    .description("interactively configure the current directory as a Firebase project directory")
+    .help(HELP)
     .before(requireAuth_1.requireAuth)
     .action(initAction);
 function initAction(feature, options) {

package/lib/commands/internaltesting-frameworks-compose.js

@@ -9,7 +9,7 @@ const error_1 = require("../error");
 const filesystem_1 = require("../frameworks/compose/discover/filesystem");
 const frameworkSpec_1 = require("../frameworks/compose/discover/frameworkSpec");
 exports.command = new command_1.Command("internaltesting:frameworks:compose")
-    .option("-m, --mode <mode>", "Composer mode (local or docker)", "local")
+    .option("-m, --mode <mode>", "composer mode (local or docker)", "local")
     .description("compose framework in current directory")
     .action(async (options) => {
     const mode = options.mode;

package/lib/commands/remoteconfig-versions-list.js

@@ -20,7 +20,7 @@ function pushTableContents(table, version) {
 }
 exports.command = new command_1.Command("remoteconfig:versions:list")
     .description("get a list of Remote Config template versions that have been published for a Firebase project")
-    .option("--limit <maxResults>", "limit the number of versions being returned. Pass '0' to fetch all versions.")
+    .option("--limit <maxResults>", "limit the number of versions being returned. Pass '0' to fetch all versions")
     .before(requireAuth_1.requireAuth)
     .before(requirePermissions_1.requirePermissions, ["cloudconfig.configs.get"])
     .action(async (options) => {

package/lib/commands/setup-emulators-database.js

@@ -6,7 +6,7 @@ const download_1 = require("../emulator/download");
 const types_1 = require("../emulator/types");
 const NAME = types_1.Emulators.DATABASE;
 exports.command = new command_1.Command(`setup:emulators:${NAME}`)
-    .description(`downloads the ${NAME} emulator`)
+    .description(`download the ${NAME} emulator`)
     .action(() => {
     return (0, download_1.downloadEmulator)(NAME);
 });

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

@@ -7,7 +7,7 @@ const logger_1 = require("../logger");
 const downloadableEmulators_1 = require("../emulator/downloadableEmulators");
 const NAME = types_1.Emulators.DATACONNECT;
 exports.command = new command_1.Command(`setup:emulators:${NAME}`)
-    .description(`downloads the ${NAME} emulator`)
+    .description(`download the ${NAME} emulator`)
     .action(async (options) => {
     await (0, downloadableEmulators_1.downloadIfNecessary)(NAME);
     if (!options.config) {

package/lib/commands/setup-emulators-firestore.js

@@ -6,7 +6,7 @@ const download_1 = require("../emulator/download");
 const types_1 = require("../emulator/types");
 const NAME = types_1.Emulators.FIRESTORE;
 exports.command = new command_1.Command(`setup:emulators:${NAME}`)
-    .description(`downloads the ${NAME} emulator`)
+    .description(`download the ${NAME} emulator`)
     .action(() => {
     return (0, download_1.downloadEmulator)(NAME);
 });

package/lib/commands/setup-emulators-pubsub.js

@@ -6,7 +6,7 @@ const download_1 = require("../emulator/download");
 const types_1 = require("../emulator/types");
 const EMULATOR_NAME = types_1.Emulators.PUBSUB;
 exports.command = new command_1.Command(`setup:emulators:${EMULATOR_NAME}`)
-    .description(`downloads the ${EMULATOR_NAME} emulator`)
+    .description(`download the ${EMULATOR_NAME} emulator`)
     .action(() => {
     return (0, download_1.downloadEmulator)(EMULATOR_NAME);
 });

package/lib/commands/setup-emulators-storage.js

@@ -6,7 +6,7 @@ const download_1 = require("../emulator/download");
 const types_1 = require("../emulator/types");
 const EMULATOR_NAME = types_1.Emulators.STORAGE;
 exports.command = new command_1.Command(`setup:emulators:${EMULATOR_NAME}`)
-    .description(`downloads the ${EMULATOR_NAME} emulator`)
+    .description(`download the ${EMULATOR_NAME} emulator`)
     .action(() => {
     return (0, download_1.downloadEmulator)(EMULATOR_NAME);
 });

package/lib/commands/setup-emulators-ui.js

@@ -6,7 +6,7 @@ const download_1 = require("../emulator/download");
 const types_1 = require("../emulator/types");
 const NAME = types_1.Emulators.UI;
 exports.command = new command_1.Command(`setup:emulators:${NAME}`)
-    .description(`downloads the ${NAME} emulator`)
+    .description(`download the ${NAME} emulator`)
     .action(() => {
     return (0, download_1.downloadEmulator)(NAME);
 });

package/lib/config.js

@@ -127,6 +127,9 @@ class Config {
         return _.has(this.data, key);
     }
     path(pathName) {
+        if (path.isAbsolute(pathName)) {
+            return pathName;
+        }
         const outPath = path.normalize(path.join(this.projectDir, pathName));
         if (path.relative(this.projectDir, outPath).includes("..")) {
             throw new error_1.FirebaseError(clc.bold(pathName) + " is outside of project directory", { exit: 1 });
@@ -165,9 +168,9 @@ class Config {
     deleteProjectFile(p) {
         fs.removeSync(this.path(p));
     }
-    askWriteProjectFile(p, content, force, confirmByDefault) {
-        const writeTo = this.path(p);
-        let next;
+    async askWriteProjectFile(path, content, force, confirmByDefault) {
+        const writeTo = this.path(path);
+        let next = true;
         if (typeof content !== "string") {
             content = JSON.stringify(content, null, 2) + "\n";
         }
@@ -176,27 +179,22 @@ class Config {
             existingContent = fsutils.readFile(writeTo);
         }
         if (existingContent && existingContent !== content && !force) {
-            next = (0, prompt_1.promptOnce)({
+            next = await (0, prompt_1.promptOnce)({
                 type: "confirm",
-                message: "File " + clc.underline(p) + " already exists. Overwrite?",
+                message: "File " + clc.underline(path) + " already exists. Overwrite?",
                 default: !!confirmByDefault,
             });
         }
+        if (existingContent === content) {
+            utils.logBullet(clc.bold(path) + " is unchanged");
+        }
+        else if (next) {
+            this.writeProjectFile(path, content);
+            utils.logSuccess("Wrote " + clc.bold(path));
+        }
         else {
-            next = Promise.resolve(true);
+            utils.logBullet("Skipping write of " + clc.bold(path));
         }
-        return next.then((result) => {
-            if (existingContent === content) {
-                utils.logBullet(clc.bold(p) + " is unchanged");
-            }
-            else if (result) {
-                this.writeProjectFile(p, content);
-                utils.logSuccess("Wrote " + clc.bold(p));
-            }
-            else {
-                utils.logBullet("Skipping write of " + clc.bold(p));
-            }
-        });
     }
     static load(options, allowMissing) {
         const pd = (0, detectProjectRoot_1.detectProjectRoot)(options);

package/lib/dataconnect/dataplaneClient.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.executeGraphQL = exports.dataconnectDataplaneClient = exports.DATACONNECT_API_VERSION = void 0;
+exports.executeGraphQL = exports.dataconnectDataplaneClient = exports.DATACONNECT_API_VERSION = exports.dataconnectOrigin = void 0;
 const api_1 = require("../api");
+var api_2 = require("../api");
+Object.defineProperty(exports, "dataconnectOrigin", { enumerable: true, get: function () { return api_2.dataconnectOrigin; } });
 const apiv2_1 = require("../apiv2");
 exports.DATACONNECT_API_VERSION = "v1";
 function dataconnectDataplaneClient() {

package/lib/deploy/functions/build.js

@@ -205,6 +205,7 @@ function toBackend(build, paramValues) {
             }
             const bkEndpoint = Object.assign({ id: endpointId, project: bdEndpoint.project, region: region, entryPoint: bdEndpoint.entryPoint, platform: bdEndpoint.platform, runtime: bdEndpoint.runtime }, trigger);
             proto.copyIfPresent(bkEndpoint, bdEndpoint, "environmentVariables", "labels", "secretEnvironmentVariables");
+            r.resolveStrings(bkEndpoint, bdEndpoint, "serviceAccount");
             proto.convertIfPresent(bkEndpoint, bdEndpoint, "ingressSettings", (from) => {
                 if (from !== null && !backend.AllIngressSettings.includes(from)) {
                     throw new error_1.FirebaseError(`Cannot set ingress settings to invalid value ${from}`);

package/lib/deploy/functions/prompts.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.promptForMinInstances = exports.promptForUnsafeMigration = exports.promptForFunctionDeletion = exports.promptForFailurePolicies = void 0;
+exports.promptForCleanupPolicyDays = exports.promptForMinInstances = exports.promptForUnsafeMigration = exports.promptForFunctionDeletion = exports.promptForFailurePolicies = void 0;
 const clc = require("colorette");
 const functionsDeployHelper_1 = require("./functionsDeployHelper");
 const error_1 = require("../../error");
@@ -9,6 +9,7 @@ const logger_1 = require("../../logger");
 const backend = require("./backend");
 const pricing = require("./pricing");
 const utils = require("../../utils");
+const artifacts = require("../../functions/artifacts");
 async function promptForFailurePolicies(options, want, have) {
     const retryEndpoints = backend.allEndpoints(want).filter((e) => {
         return backend.isEventTriggered(e) && e.eventTrigger.retry;
@@ -187,3 +188,31 @@ async function promptForMinInstances(options, want, have) {
     }
 }
 exports.promptForMinInstances = promptForMinInstances;
+async function promptForCleanupPolicyDays(options, locations) {
+    utils.logLabeledWarning("functions", `No cleanup policy detected for repositories in ${locations.join(", ")}. ` +
+        "This may result in a small monthly bill as container images accumulate over time.");
+    if (options.force) {
+        return artifacts.DEFAULT_CLEANUP_DAYS;
+    }
+    if (options.nonInteractive) {
+        throw new error_1.FirebaseError(`Functions successfully deployed but could not set up cleanup policy in ` +
+            `${locations.length > 1 ? "locations" : "location"} ${locations.join(", ")}. ` +
+            `Pass the --force option to automatically set up a cleanup policy or ` +
+            "run 'firebase functions:artifacts:setpolicy' to manually set up a cleanup policy.");
+    }
+    const result = await (0, prompt_1.promptOnce)({
+        type: "input",
+        name: "days",
+        default: artifacts.DEFAULT_CLEANUP_DAYS.toString(),
+        message: "How many days do you want to keep container images before they're deleted?",
+        validate: (input) => {
+            const days = parseInt(input);
+            if (isNaN(days) || days < 0) {
+                return "Please enter a non-negative number";
+            }
+            return true;
+        },
+    });
+    return parseInt(result);
+}
+exports.promptForCleanupPolicyDays = promptForCleanupPolicyDays;