firebase-tools 11.27.0 → 11.28.0

package/lib/commands/ext-install.js

@@ -12,9 +12,11 @@ const error_1 = require("../error");
 const projectUtils_1 = require("../projectUtils");
 const extensionsApi = require("../extensions/extensionsApi");
 const refs = require("../extensions/refs");
+const secretsUtils = require("../extensions/secretsUtils");
 const warnings_1 = require("../extensions/warnings");
 const paramHelper = require("../extensions/paramHelper");
 const extensionsHelper_1 = require("../extensions/extensionsHelper");
+const prompt_1 = require("../prompt");
 const utils_1 = require("../extensions/utils");
 const requirePermissions_1 = require("../requirePermissions");
 const utils = require("../utils");
@@ -74,7 +76,7 @@ exports.command = new command_1.Command("ext:install [extensionName]")
             extensionVersion,
         });
     }
-    if (!(await (0, extensionsHelper_1.confirm)({
+    if (!(await (0, prompt_1.confirm)({
         nonInteractive: options.nonInteractive,
         force: options.force,
         default: true,
@@ -126,6 +128,9 @@ async function installToManifest(options) {
     if (!spec) {
         throw new error_1.FirebaseError(`Could not find the extension.yaml for ${extensionName}. Please make sure this is a valid extension and try again.`);
     }
+    if (secretsUtils.usesSecrets(spec)) {
+        await secretsUtils.ensureSecretManagerApiEnabled(options);
+    }
     const config = manifest.loadConfig(options);
     let instanceId = spec.name;
     while (manifest.instanceExists(instanceId, config)) {

package/lib/commands/ext-update.js

@@ -11,8 +11,10 @@ const extensionsApi = require("../extensions/extensionsApi");
 const extensionsHelper_1 = require("../extensions/extensionsHelper");
 const paramHelper = require("../extensions/paramHelper");
 const updateHelper_1 = require("../extensions/updateHelper");
+const secretsUtils = require("../extensions/secretsUtils");
 const refs = require("../extensions/refs");
 const projectUtils_1 = require("../projectUtils");
+const prompt_1 = require("../prompt");
 const requirePermissions_1 = require("../requirePermissions");
 const utils = require("../utils");
 const experiments = require("../experiments");
@@ -60,7 +62,7 @@ exports.command = new command_1.Command("ext:update <extensionInstanceId> [updat
         return;
     }
     utils.logLabeledBullet(extensionsHelper_1.logPrefix, `Updating ${clc.bold(instanceId)} from version ${clc.bold(oldExtensionVersion.ref)} to version ${clc.bold(newExtensionVersion.ref)}.`);
-    if (!(await (0, extensionsHelper_1.confirm)({
+    if (!(await (0, prompt_1.confirm)({
         nonInteractive: options.nonInteractive,
         force: options.force,
         default: false,
@@ -68,6 +70,9 @@ exports.command = new command_1.Command("ext:update <extensionInstanceId> [updat
         utils.logLabeledBullet(extensionsHelper_1.logPrefix, "Update aborted.");
         return;
     }
+    if (secretsUtils.usesSecrets(newExtensionVersion.spec)) {
+        await secretsUtils.ensureSecretManagerApiEnabled(options);
+    }
     const oldParamValues = manifest.readInstanceParam({
         instanceId,
         projectDir: config.projectDir,

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

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
+const command_1 = require("../command");
+const clc = require("colorette");
+const fsi = require("../firestore/api");
+const types = require("../firestore/api-types");
+const logger_1 = require("../logger");
+const requirePermissions_1 = require("../requirePermissions");
+const types_1 = require("../emulator/types");
+const commandUtils_1 = require("../emulator/commandUtils");
+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'")
+    .before(requirePermissions_1.requirePermissions, ["datastore.databases.create"])
+    .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.FIRESTORE)
+    .action(async (database, options) => {
+    const api = new fsi.FirestoreApi();
+    if (!options.location) {
+        logger_1.logger.error("Missing required flag --location. See firebase firestore:databases:create --help for more info.");
+        return;
+    }
+    const type = types.DatabaseType.FIRESTORE_NATIVE;
+    if (options.deleteProtection &&
+        options.deleteProtection !== types.DatabaseDeleteProtectionStateOption.ENABLED &&
+        options.deleteProtection !== types.DatabaseDeleteProtectionStateOption.DISABLED) {
+        logger_1.logger.error("Invalid value for flag --delete-protection. See firebase firestore:databases:create --help for more info.");
+        return;
+    }
+    const deleteProtectionState = options.deleteProtection === types.DatabaseDeleteProtectionStateOption.ENABLED
+        ? types.DatabaseDeleteProtectionState.ENABLED
+        : types.DatabaseDeleteProtectionState.DISABLED;
+    const databaseResp = await api.createDatabase(options.project, database, options.location, type, deleteProtectionState);
+    if (options.json) {
+        logger_1.logger.info(JSON.stringify(databaseResp, undefined, 2));
+    }
+    else {
+        logger_1.logger.info(clc.bold(`Successfully created ${api.prettyDatabaseString(databaseResp)}`));
+        logger_1.logger.info("Please be sure to configure Firebase rules in your Firebase config file for\n" +
+            "the new database. By default, created databases will have closed rules that\n" +
+            "block any incoming third-party traffic.");
+    }
+    return databaseResp;
+});

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

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
+const command_1 = require("../command");
+const clc = require("colorette");
+const fsi = require("../firestore/api");
+const prompt_1 = require("../prompt");
+const logger_1 = require("../logger");
+const requirePermissions_1 = require("../requirePermissions");
+const types_1 = require("../emulator/types");
+const commandUtils_1 = require("../emulator/commandUtils");
+const error_1 = require("../error");
+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.")
+    .before(requirePermissions_1.requirePermissions, ["datastore.databases.delete"])
+    .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.FIRESTORE)
+    .action(async (database, options) => {
+    const api = new fsi.FirestoreApi();
+    if (!options.force) {
+        const confirmMessage = `You are about to delete projects/${options.project}/databases/${database}. Do you wish to continue?`;
+        const consent = await (0, prompt_1.promptOnce)({
+            type: "confirm",
+            message: confirmMessage,
+            default: false,
+        });
+        if (!consent) {
+            throw new error_1.FirebaseError("Delete database canceled.");
+        }
+    }
+    const databaseResp = await api.deleteDatabase(options.project, database);
+    if (options.json) {
+        logger_1.logger.info(JSON.stringify(databaseResp, undefined, 2));
+    }
+    else {
+        logger_1.logger.info(clc.bold(`Successfully deleted ${api.prettyDatabaseString(databaseResp)}`));
+    }
+    return databaseResp;
+});

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

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
+const command_1 = require("../command");
+const fsi = require("../firestore/api");
+const logger_1 = require("../logger");
+const requirePermissions_1 = require("../requirePermissions");
+const types_1 = require("../emulator/types");
+const commandUtils_1 = require("../emulator/commandUtils");
+exports.command = new command_1.Command("firestore:databases:get [database]")
+    .description("Get database in your Cloud Firestore project.")
+    .before(requirePermissions_1.requirePermissions, ["datastore.databases.get"])
+    .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.FIRESTORE)
+    .action(async (database, options) => {
+    const api = new fsi.FirestoreApi();
+    const databaseId = database || "(default)";
+    const databaseResp = await api.getDatabase(options.project, databaseId);
+    if (options.json) {
+        logger_1.logger.info(JSON.stringify(databaseResp, undefined, 2));
+    }
+    else {
+        api.prettyPrintDatabase(databaseResp);
+    }
+    return databaseResp;
+});

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

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
+const command_1 = require("../command");
+const fsi = require("../firestore/api");
+const logger_1 = require("../logger");
+const requirePermissions_1 = require("../requirePermissions");
+const types_1 = require("../emulator/types");
+const commandUtils_1 = require("../emulator/commandUtils");
+exports.command = new command_1.Command("firestore:databases:list")
+    .description("List databases in your Cloud Firestore project.")
+    .before(requirePermissions_1.requirePermissions, ["datastore.databases.list"])
+    .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.FIRESTORE)
+    .action(async (options) => {
+    const api = new fsi.FirestoreApi();
+    const databases = await api.listDatabases(options.project);
+    if (options.json) {
+        logger_1.logger.info(JSON.stringify(databases, undefined, 2));
+    }
+    else {
+        api.prettyPrintDatabases(databases);
+    }
+    return databases;
+});

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

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
+const command_1 = require("../command");
+const clc = require("colorette");
+const fsi = require("../firestore/api");
+const types = require("../firestore/api-types");
+const logger_1 = require("../logger");
+const requirePermissions_1 = require("../requirePermissions");
+const types_1 = require("../emulator/types");
+const commandUtils_1 = require("../emulator/commandUtils");
+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'")
+    .before(requirePermissions_1.requirePermissions, ["datastore.databases.update"])
+    .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.FIRESTORE)
+    .action(async (database, options) => {
+    const api = new fsi.FirestoreApi();
+    if (!options.type && !options.deleteProtection) {
+        logger_1.logger.error("Missing properties to update. See firebase firestore:databases:update --help for more info.");
+        return;
+    }
+    const type = types.DatabaseType.FIRESTORE_NATIVE;
+    if (options.deleteProtection &&
+        options.deleteProtection !== types.DatabaseDeleteProtectionStateOption.ENABLED &&
+        options.deleteProtection !== types.DatabaseDeleteProtectionStateOption.DISABLED) {
+        logger_1.logger.error("Invalid value for flag --delete-protection. See firebase firestore:databases:update --help for more info.");
+        return;
+    }
+    const deleteProtectionState = options.deleteProtection === types.DatabaseDeleteProtectionStateOption.ENABLED
+        ? types.DatabaseDeleteProtectionState.ENABLED
+        : types.DatabaseDeleteProtectionState.DISABLED;
+    const databaseResp = await api.updateDatabase(options.project, database, type, deleteProtectionState);
+    if (options.json) {
+        logger_1.logger.info(JSON.stringify(databaseResp, undefined, 2));
+    }
+    else {
+        logger_1.logger.info(clc.bold(`Successfully updated ${api.prettyDatabaseString(databaseResp)}`));
+    }
+    return databaseResp;
+});

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

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.command = void 0;
 const command_1 = require("../command");
 const clc = require("colorette");
-const fsi = require("../firestore/indexes");
+const fsi = require("../firestore/api");
 const logger_1 = require("../logger");
 const requirePermissions_1 = require("../requirePermissions");
 const types_1 = require("../emulator/types");
@@ -17,7 +17,7 @@ exports.command = new command_1.Command("firestore:indexes")
     .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.FIRESTORE)
     .action(async (options) => {
     var _a;
-    const indexApi = new fsi.FirestoreIndexes();
+    const indexApi = new fsi.FirestoreApi();
     const databaseId = (_a = options.database) !== null && _a !== void 0 ? _a : "(default)";
     const indexes = await indexApi.listIndexes(options.project, databaseId);
     const fieldOverrides = await indexApi.listFieldOverrides(options.project, databaseId);

package/lib/commands/firestore-locations.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
+const command_1 = require("../command");
+const fsi = require("../firestore/api");
+const logger_1 = require("../logger");
+const requirePermissions_1 = require("../requirePermissions");
+const types_1 = require("../emulator/types");
+const commandUtils_1 = require("../emulator/commandUtils");
+exports.command = new command_1.Command("firestore:locations")
+    .description("List possible locations for your Cloud Firestore project.")
+    .before(requirePermissions_1.requirePermissions, ["datastore.locations.list"])
+    .before(commandUtils_1.warnEmulatorNotSupported, types_1.Emulators.FIRESTORE)
+    .action(async (options) => {
+    const api = new fsi.FirestoreApi();
+    const locations = await api.locations(options.project);
+    if (options.json) {
+        logger_1.logger.info(JSON.stringify(locations, undefined, 2));
+    }
+    else {
+        api.prettyPrintLocations(locations);
+    }
+    return locations;
+});

package/lib/commands/index.js

@@ -102,6 +102,13 @@ function load(client) {
     client.firestore = {};
     client.firestore.delete = loadCommand("firestore-delete");
     client.firestore.indexes = loadCommand("firestore-indexes-list");
+    client.firestore.locations = loadCommand("firestore-locations");
+    client.firestore.databases = {};
+    client.firestore.databases.list = loadCommand("firestore-databases-list");
+    client.firestore.databases.get = loadCommand("firestore-databases-get");
+    client.firestore.databases.create = loadCommand("firestore-databases-create");
+    client.firestore.databases.update = loadCommand("firestore-databases-update");
+    client.firestore.databases.delete = loadCommand("firestore-databases-delete");
     client.functions = {};
     client.functions.config = {};
     client.functions.config.clone = loadCommand("functions-config-clone");

package/lib/commands/init.js

@@ -62,6 +62,11 @@ const choices = [
         name: "Remote Config: Configure a template file for Remote Config",
         checked: false,
     },
+    {
+        value: "extensions",
+        name: "Extensions: Set up an empty Extensions manifest",
+        checked: false,
+    },
 ];
 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.

package/lib/commands/open.js

@@ -24,6 +24,16 @@ const LINKS = [
     { name: "Firestore: Data", arg: "firestore", consolePath: "/firestore/data" },
     { name: "Firestore: Rules", arg: "firestore:rules", consolePath: "/firestore/rules" },
     { name: "Firestore: Indexes", arg: "firestore:indexes", consolePath: "/firestore/indexes" },
+    {
+        name: "Firestore: Databases List",
+        arg: "firestore:databases:list",
+        consolePath: "/firestore/databases/list",
+    },
+    {
+        name: "Firestore: Locations",
+        arg: "firestore:locations",
+        consolePath: "/firestore/locations",
+    },
     { name: "Firestore: Usage", arg: "firestore:usage", consolePath: "/firestore/usage" },
     { name: "Functions", arg: "functions", consolePath: "/functions/list" },
     { name: "Functions Log", arg: "functions:log" },

package/lib/deploy/firestore/deploy.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const clc = require("colorette");
-const indexes_1 = require("../../firestore/indexes");
+const api_1 = require("../../firestore/api");
 const logger_1 = require("../../logger");
 const utils = require("../../utils");
 const rulesDeploy_1 = require("../../rulesDeploy");
@@ -20,7 +20,7 @@ async function deployIndexes(context, options) {
     }
     const indexesContext = (_a = context === null || context === void 0 ? void 0 : context.firestore) === null || _a === void 0 ? void 0 : _a.indexes;
     utils.logBullet(clc.bold(clc.cyan("firestore: ")) + "deploying indexes...");
-    const firestoreIndexes = new indexes_1.FirestoreIndexes();
+    const firestoreIndexes = new api_1.FirestoreApi();
     await Promise.all(indexesContext.map(async (indexContext) => {
         const { databaseId, indexesFileName, indexesRawSpec } = indexContext;
         if (!indexesRawSpec) {

package/lib/deploy/functions/build.js

@@ -5,7 +5,6 @@ const backend = require("./backend");
 const proto = require("../../gcp/proto");
 const api = require("../../.../../api");
 const params = require("./params");
-const experiments = require("../../experiments");
 const error_1 = require("../../error");
 const functional_1 = require("../../functional");
 const env_1 = require("../../functions/env");
@@ -61,18 +60,16 @@ exports.AllIngressSettings = [
 ];
 async function resolveBackend(build, firebaseConfig, userEnvOpt, userEnvs, nonInteractive) {
     let paramValues = {};
-    if (experiments.isEnabled("functionsparams")) {
-        paramValues = await params.resolveParams(build.params, firebaseConfig, envWithTypes(build.params, userEnvs), nonInteractive);
-        const toWrite = {};
-        for (const paramName of Object.keys(paramValues)) {
-            const paramValue = paramValues[paramName];
-            if (Object.prototype.hasOwnProperty.call(userEnvs, paramName) || paramValue.internal) {
-                continue;
-            }
-            toWrite[paramName] = paramValue.toString();
+    paramValues = await params.resolveParams(build.params, firebaseConfig, envWithTypes(build.params, userEnvs), nonInteractive);
+    const toWrite = {};
+    for (const paramName of Object.keys(paramValues)) {
+        const paramValue = paramValues[paramName];
+        if (Object.prototype.hasOwnProperty.call(userEnvs, paramName) || paramValue.internal) {
+            continue;
         }
-        (0, env_1.writeUserEnvs)(toWrite, userEnvOpt);
+        toWrite[paramName] = paramValue.toString();
     }
+    (0, env_1.writeUserEnvs)(toWrite, userEnvOpt);
     return { backend: toBackend(build, paramValues), envs: paramValues };
 }
 exports.resolveBackend = resolveBackend;

package/lib/experiments.js

@@ -44,18 +44,13 @@ exports.ALL_EXPERIMENTS = experiments({
             "of how that image was created.",
         public: true,
     },
-    functionsparams: {
-        shortDescription: "Adds support for paramaterizing functions deployments",
-        default: true,
-    },
     emulatoruisnapshot: {
         shortDescription: "Load pre-release versions of the emulator UI",
     },
     webframeworks: {
         shortDescription: "Native support for popular web frameworks",
         fullDescription: "Adds support for popular web frameworks such as Next.js " +
-            "Angular, React, Svelte, and Vite-compatible frameworks. Firebase is " +
-            "committed to support these platforms long-term, but a manual migration " +
+            "Angular, React, Svelte, and Vite-compatible frameworks. A manual migration " +
             "may be required when the non-experimental support for these frameworks " +
             "is released",
         docsUri: "https://firebase.google.com/docs/hosting/frameworks-overview",

package/lib/extensions/extensionsHelper.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.canonicalizeRefInput = exports.diagnoseAndFixProject = exports.confirm = exports.getSourceOrigin = exports.isLocalOrURLPath = exports.isLocalPath = exports.isUrlPath = exports.instanceIdExists = exports.promptForRepeatInstance = exports.promptForOfficialExtension = exports.displayReleaseNotes = exports.getPublisherProjectFromName = exports.createSourceFromLocation = exports.publishExtensionVersionFromLocalSource = exports.publishExtensionVersionFromRemoteRepo = exports.incrementPrereleaseVersion = exports.ensureExtensionsApiEnabled = exports.promptForValidRepoURI = exports.promptForValidInstanceId = exports.validateSpec = exports.validateCommandLineParams = exports.populateDefaultParams = exports.substituteParams = exports.getFirebaseProjectParams = exports.getDBInstanceFromURL = exports.resourceTypeToNiceName = exports.AUTOPOULATED_PARAM_PLACEHOLDERS = exports.EXTENSIONS_BUCKET_NAME = exports.URL_REGEX = exports.logPrefix = exports.SourceOrigin = exports.SpecParamType = void 0;
+exports.canonicalizeRefInput = exports.diagnoseAndFixProject = exports.getSourceOrigin = exports.isLocalOrURLPath = exports.isLocalPath = exports.isUrlPath = exports.instanceIdExists = exports.promptForRepeatInstance = exports.promptForOfficialExtension = exports.displayReleaseNotes = exports.getPublisherProjectFromName = exports.createSourceFromLocation = exports.publishExtensionVersionFromLocalSource = exports.publishExtensionVersionFromRemoteRepo = exports.incrementPrereleaseVersion = exports.ensureExtensionsApiEnabled = exports.promptForValidRepoURI = exports.promptForValidInstanceId = exports.validateSpec = exports.validateCommandLineParams = exports.populateDefaultParams = exports.substituteParams = exports.getFirebaseProjectParams = exports.getDBInstanceFromURL = exports.resourceTypeToNiceName = exports.AUTOPOULATED_PARAM_PLACEHOLDERS = exports.EXTENSIONS_BUCKET_NAME = exports.URL_REGEX = exports.logPrefix = exports.SourceOrigin = exports.SpecParamType = void 0;
 const clc = require("colorette");
 const ora = require("ora");
 const semver = require("semver");
@@ -388,23 +388,8 @@ async function publishExtensionVersionFromRemoteRepo(args) {
             throw new error_1.FirebaseError("Repo URI is required but not currently set.");
         }
     }
-    if ((extension === null || extension === void 0 ? void 0 : extension.repoUri) && extension.repoUri !== repoUri) {
-        throw new error_1.FirebaseError(`Repo URI '${clc.bold(args.repoUri)}' does not match repo URI '${clc.bold(extension.repoUri)}' already associated with Extension ${clc.bold(extensionRef)}. Repo URI cannot be changed.`);
-    }
-    if (!(extension === null || extension === void 0 ? void 0 : extension.repoUri)) {
-        logger_1.logger.info(`\n${clc.red("Warning:")} You are about to associate repo URI ${clc.bold(repoUri)} with Extension ${clc.bold(extensionRef)}. This cannot be changed. All future verifiable versions must be published from this repo. ` +
-            `You can continue publishing unverifiable versions from local source.`);
-        const confirmed = await confirm({
-            nonInteractive: args.nonInteractive,
-            force: args.force,
-            default: false,
-        });
-        if (!confirmed) {
-            return;
-        }
-    }
-    else {
-        logger_1.logger.info(`Extension ${clc.bold(extensionRef)} is published from ${clc.bold(extension === null || extension === void 0 ? void 0 : extension.repoUri)}.`);
+    if (extension === null || extension === void 0 ? void 0 : extension.repoUri) {
+        logger_1.logger.info(`Extension ${clc.bold(extensionRef)} is published from ${clc.bold(extension === null || extension === void 0 ? void 0 : extension.repoUri)}. Use --repo to change this repo.`);
     }
     let extensionRoot = args.extensionRoot;
     let defaultRoot = "/";
@@ -487,7 +472,7 @@ async function publishExtensionVersionFromRemoteRepo(args) {
     });
     const sourceUri = path.join(repoUri, "tree", sourceRef, extensionRoot);
     displayReleaseNotes(extensionRef, extensionSpec.version, notes, sourceUri);
-    const confirmed = await confirm({
+    const confirmed = await (0, prompt_1.confirm)({
         nonInteractive: args.nonInteractive,
         force: args.force,
         default: false,
@@ -535,7 +520,7 @@ async function publishExtensionVersionFromLocalSource(args) {
     });
     const extensionRef = `${args.publisherId}/${args.extensionId}`;
     displayReleaseNotes(extensionRef, extensionSpec.version, notes);
-    const confirmed = await confirm({
+    const confirmed = await (0, prompt_1.confirm)({
         nonInteractive: args.nonInteractive,
         force: args.force,
         default: false,
@@ -725,23 +710,6 @@ function getSourceOrigin(sourceOrVersion) {
     throw new error_1.FirebaseError(`Could not find source '${clc.bold(sourceOrVersion)}'. Check to make sure the source is correct, and then please try again.`);
 }
 exports.getSourceOrigin = getSourceOrigin;
-async function confirm(args) {
-    if (!args.nonInteractive && !args.force) {
-        const message = `Do you wish to continue?`;
-        return await (0, prompt_1.promptOnce)({
-            type: "confirm",
-            message,
-            default: args.default,
-        });
-    }
-    else if (args.nonInteractive && !args.force) {
-        throw new error_1.FirebaseError("Pass the --force flag to use this command in non-interactive mode");
-    }
-    else {
-        return true;
-    }
-}
-exports.confirm = confirm;
 async function diagnoseAndFixProject(options) {
     const projectId = (0, projectUtils_1.getProjectId)(options);
     if (!projectId) {

package/lib/extensions/manifest.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.showPostDeprecationNotice = exports.readInstanceParam = exports.getInstanceRef = exports.getInstanceTarget = exports.instanceExists = exports.loadConfig = exports.removeFromManifest = exports.writeLocalSecrets = exports.writeToManifest = exports.ENV_DIRECTORY = void 0;
+exports.showPostDeprecationNotice = exports.readInstanceParam = exports.writeExtensionsToFirebaseJson = exports.getInstanceRef = exports.getInstanceTarget = exports.instanceExists = exports.loadConfig = exports.removeFromManifest = exports.writeLocalSecrets = exports.writeEmptyManifest = exports.writeToManifest = exports.ENV_DIRECTORY = void 0;
 const clc = require("colorette");
 const path = require("path");
+const fs = require("fs-extra");
 const refs = require("./refs");
 const config_1 = require("../config");
 const planner_1 = require("../deploy/extensions/planner");
@@ -41,6 +42,26 @@ async function writeToManifest(specs, config, options, allowOverwrite = false) {
     await writeLocalSecrets(specs, config, options.force);
 }
 exports.writeToManifest = writeToManifest;
+async function writeEmptyManifest(config, options) {
+    if (!fs.existsSync(config.path("extensions"))) {
+        fs.mkdirSync(config.path("extensions"));
+    }
+    if (config.has("extensions") && Object.keys(config.get("extensions")).length) {
+        const currentExtensions = Object.entries(config.get("extensions"))
+            .map((i) => `${i[0]}: ${i[1]}`)
+            .join("\n\t");
+        if (!(await (0, prompt_1.confirm)({
+            message: `firebase.json already contains extensions:\n${currentExtensions}\nWould you like to overwrite them?`,
+            nonInteractive: options.nonInteractive,
+            force: options.force,
+            default: false,
+        }))) {
+            return;
+        }
+    }
+    config.set("extensions", {});
+}
+exports.writeEmptyManifest = writeEmptyManifest;
 async function writeLocalSecrets(specs, config, force) {
     for (const spec of specs) {
         const extensionSpec = await (0, planner_1.getExtensionSpec)(spec);
@@ -133,6 +154,7 @@ function writeExtensionsToFirebaseJson(specs, config) {
     config.writeProjectFile("firebase.json", config.src);
     utils.logSuccess("Wrote extensions to " + clc.bold("firebase.json") + "...");
 }
+exports.writeExtensionsToFirebaseJson = writeExtensionsToFirebaseJson;
 async function writeEnvFiles(specs, config, force) {
     for (const spec of specs) {
         const content = Object.entries(spec.params)

package/lib/firestore/{indexes-sort.js → api-sort.js}

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.compareFieldOverride = exports.compareApiField = exports.compareApiIndex = exports.compareSpecIndex = void 0;
-const API = require("./indexes-api");
+exports.compareFieldOverride = exports.compareApiField = exports.compareLocation = exports.compareApiDatabase = exports.compareApiIndex = exports.compareSpecIndex = void 0;
+const API = require("./api-types");
 const util = require("./util");
 const QUERY_SCOPE_SEQUENCE = [
     API.QueryScope.COLLECTION_GROUP,
@@ -34,6 +34,14 @@ function compareApiIndex(a, b) {
     return compareArrays(a.fields, b.fields, compareIndexField);
 }
 exports.compareApiIndex = compareApiIndex;
+function compareApiDatabase(a, b) {
+    return a.name > b.name ? 1 : -1;
+}
+exports.compareApiDatabase = compareApiDatabase;
+function compareLocation(a, b) {
+    return a.locationId > b.locationId ? 1 : -1;
+}
+exports.compareLocation = compareLocation;
 function compareApiField(a, b) {
     const aName = util.parseFieldName(a.name);
     const bName = util.parseFieldName(b.name);

package/lib/firestore/{indexes-api.js → api-types.js}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.StateTtl = exports.State = exports.ArrayConfig = exports.Order = exports.QueryScope = exports.Mode = void 0;
+exports.DatabaseDeleteProtectionState = exports.DatabaseDeleteProtectionStateOption = exports.DatabaseType = exports.StateTtl = exports.State = exports.ArrayConfig = exports.Order = exports.QueryScope = exports.Mode = void 0;
 var Mode;
 (function (Mode) {
     Mode["ASCENDING"] = "ASCENDING";
@@ -33,3 +33,18 @@ var StateTtl;
     StateTtl["ACTIVE"] = "ACTIVE";
     StateTtl["NEEDS_REPAIR"] = "NEEDS_REPAIR";
 })(StateTtl = exports.StateTtl || (exports.StateTtl = {}));
+var DatabaseType;
+(function (DatabaseType) {
+    DatabaseType["DATASTORE_MODE"] = "DATASTORE_MODE";
+    DatabaseType["FIRESTORE_NATIVE"] = "FIRESTORE_NATIVE";
+})(DatabaseType = exports.DatabaseType || (exports.DatabaseType = {}));
+var DatabaseDeleteProtectionStateOption;
+(function (DatabaseDeleteProtectionStateOption) {
+    DatabaseDeleteProtectionStateOption["ENABLED"] = "ENABLED";
+    DatabaseDeleteProtectionStateOption["DISABLED"] = "DISABLED";
+})(DatabaseDeleteProtectionStateOption = exports.DatabaseDeleteProtectionStateOption || (exports.DatabaseDeleteProtectionStateOption = {}));
+var DatabaseDeleteProtectionState;
+(function (DatabaseDeleteProtectionState) {
+    DatabaseDeleteProtectionState["ENABLED"] = "DELETE_PROTECTION_ENABLED";
+    DatabaseDeleteProtectionState["DISABLED"] = "DELETE_PROTECTION_DISABLED";
+})(DatabaseDeleteProtectionState = exports.DatabaseDeleteProtectionState || (exports.DatabaseDeleteProtectionState = {}));

package/lib/firestore/{indexes.js → api.js}

@@ -1,17 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FirestoreIndexes = void 0;
+exports.FirestoreApi = void 0;
 const clc = require("colorette");
 const logger_1 = require("../logger");
 const utils = require("../utils");
 const validator = require("./validator");
-const API = require("./indexes-api");
-const sort = require("./indexes-sort");
+const types = require("./api-types");
+const sort = require("./api-sort");
 const util = require("./util");
 const prompt_1 = require("../prompt");
 const api_1 = require("../api");
+const error_1 = require("../error");
 const apiv2_1 = require("../apiv2");
-class FirestoreIndexes {
+class FirestoreApi {
     constructor() {
         this.apiClient = new apiv2_1.Client({ urlPrefix: api_1.firestoreOrigin, apiVersion: "v1" });
     }
@@ -193,6 +194,44 @@ class FirestoreIndexes {
             logger_1.logger.info(this.prettyIndexString(index));
         });
     }
+    prettyPrintDatabases(databases) {
+        if (databases.length === 0) {
+            logger_1.logger.info("No databases found.");
+            return;
+        }
+        const sortedDatabases = databases.sort(sort.compareApiDatabase);
+        const Table = require("cli-table");
+        const table = new Table({
+            head: ["Database Name"],
+            colWidths: [Math.max(...sortedDatabases.map((database) => database.name.length + 5), 20)],
+        });
+        table.push(...sortedDatabases.map((database) => [this.prettyDatabaseString(database)]));
+        logger_1.logger.info(table.toString());
+    }
+    prettyPrintDatabase(database) {
+        const Table = require("cli-table");
+        const table = new Table({
+            head: ["Field", "Value"],
+            colWidths: [25, Math.max(50, 5 + database.name.length)],
+        });
+        table.push(["Name", clc.yellow(database.name)], ["Create Time", clc.yellow(database.createTime)], ["Last Update Time", clc.yellow(database.updateTime)], ["Type", clc.yellow(database.type)], ["Location", clc.yellow(database.locationId)], ["Delete Protection State", clc.yellow(database.deleteProtectionState)]);
+        logger_1.logger.info(table.toString());
+    }
+    prettyPrintLocations(locations) {
+        if (locations.length === 0) {
+            logger_1.logger.info("No Locations Available");
+            return;
+        }
+        const Table = require("cli-table");
+        const table = new Table({
+            head: ["Display Name", "LocationId"],
+            colWidths: [20, 30],
+        });
+        table.push(...locations
+            .sort(sort.compareLocation)
+            .map((location) => [location.displayName, location.locationId]));
+        logger_1.logger.info(table.toString());
+    }
     printFieldOverrides(fields) {
         if (fields.length === 0) {
             logger_1.logger.info("None");
@@ -217,16 +256,16 @@ class FirestoreIndexes {
     validateIndex(index) {
         validator.assertHas(index, "collectionGroup");
         validator.assertHas(index, "queryScope");
-        validator.assertEnum(index, "queryScope", Object.keys(API.QueryScope));
+        validator.assertEnum(index, "queryScope", Object.keys(types.QueryScope));
         validator.assertHas(index, "fields");
         index.fields.forEach((field) => {
             validator.assertHas(field, "fieldPath");
             validator.assertHasOneOf(field, ["order", "arrayConfig"]);
             if (field.order) {
-                validator.assertEnum(field, "order", Object.keys(API.Order));
+                validator.assertEnum(field, "order", Object.keys(types.Order));
             }
             if (field.arrayConfig) {
-                validator.assertEnum(field, "arrayConfig", Object.keys(API.ArrayConfig));
+                validator.assertEnum(field, "arrayConfig", Object.keys(types.ArrayConfig));
             }
         });
     }
@@ -240,13 +279,13 @@ class FirestoreIndexes {
         field.indexes.forEach((index) => {
             validator.assertHasOneOf(index, ["arrayConfig", "order"]);
             if (index.arrayConfig) {
-                validator.assertEnum(index, "arrayConfig", Object.keys(API.ArrayConfig));
+                validator.assertEnum(index, "arrayConfig", Object.keys(types.ArrayConfig));
             }
             if (index.order) {
-                validator.assertEnum(index, "order", Object.keys(API.Order));
+                validator.assertEnum(index, "order", Object.keys(types.Order));
             }
             if (index.queryScope) {
-                validator.assertEnum(index, "queryScope", Object.keys(API.QueryScope));
+                validator.assertEnum(index, "queryScope", Object.keys(types.QueryScope));
             }
         });
     }
@@ -376,7 +415,7 @@ class FirestoreIndexes {
         result.indexes = spec.indexes.map((index) => {
             const i = {
                 collectionGroup: index.collectionGroup || index.collectionId,
-                queryScope: index.queryScope || API.QueryScope.COLLECTION,
+                queryScope: index.queryScope || types.QueryScope.COLLECTION,
                 fields: [],
             };
             if (index.fields) {
@@ -390,8 +429,8 @@ class FirestoreIndexes {
                     else if (field.arrayConfig) {
                         f.arrayConfig = field.arrayConfig;
                     }
-                    else if (field.mode === API.Mode.ARRAY_CONTAINS) {
-                        f.arrayConfig = API.ArrayConfig.CONTAINS;
+                    else if (field.mode === types.Mode.ARRAY_CONTAINS) {
+                        f.arrayConfig = types.ArrayConfig.CONTAINS;
                     }
                     else {
                         f.order = field.mode;
@@ -403,14 +442,78 @@ class FirestoreIndexes {
         });
         return result;
     }
+    async listDatabases(project) {
+        const url = `/projects/${project}/databases`;
+        const res = await this.apiClient.get(url);
+        const databases = res.body.databases;
+        if (!databases) {
+            return [];
+        }
+        return databases;
+    }
+    async locations(project) {
+        const url = `/projects/${project}/locations`;
+        const res = await this.apiClient.get(url);
+        const locations = res.body.locations;
+        if (!locations) {
+            return [];
+        }
+        return locations;
+    }
+    async getDatabase(project, databaseId) {
+        const url = `/projects/${project}/databases/${databaseId}`;
+        const res = await this.apiClient.get(url);
+        const database = res.body;
+        if (!database) {
+            throw new error_1.FirebaseError("Not found");
+        }
+        return database;
+    }
+    async createDatabase(project, databaseId, locationId, type, deleteProtectionState) {
+        const url = `/projects/${project}/databases`;
+        const payload = {
+            type,
+            locationId,
+            deleteProtectionState,
+        };
+        const options = { queryParams: { databaseId: databaseId } };
+        const res = await this.apiClient.post(url, payload, options);
+        const database = res.body.response;
+        if (!database) {
+            throw new error_1.FirebaseError("Not found");
+        }
+        return database;
+    }
+    async updateDatabase(project, databaseId, type, deleteProtectionState) {
+        const url = `/projects/${project}/databases/${databaseId}`;
+        const payload = {
+            type,
+            deleteProtectionState,
+        };
+        const res = await this.apiClient.patch(url, payload);
+        const database = res.body.response;
+        if (!database) {
+            throw new error_1.FirebaseError("Not found");
+        }
+        return database;
+    }
+    async deleteDatabase(project, databaseId) {
+        const url = `/projects/${project}/databases/${databaseId}`;
+        const res = await this.apiClient.delete(url);
+        const database = res.body.response;
+        if (!database) {
+            throw new error_1.FirebaseError("Not found");
+        }
+        return database;
+    }
     prettyIndexString(index, includeState = true) {
         let result = "";
         if (index.state && includeState) {
             const stateMsg = `[${index.state}] `;
-            if (index.state === API.State.READY) {
+            if (index.state === types.State.READY) {
                 result += clc.green(stateMsg);
             }
-            else if (index.state === API.State.CREATING) {
+            else if (index.state === types.State.CREATING) {
                 result += clc.yellow(stateMsg);
             }
             else {
@@ -429,6 +532,9 @@ class FirestoreIndexes {
         });
         return result;
     }
+    prettyDatabaseString(database) {
+        return clc.yellow(database.name);
+    }
     prettyFieldString(field) {
         let result = "";
         const parsedName = util.parseFieldName(field.name);
@@ -456,4 +562,4 @@ class FirestoreIndexes {
         return result;
     }
 }
-exports.FirestoreIndexes = FirestoreIndexes;
+exports.FirestoreApi = FirestoreApi;

package/lib/init/features/extensions/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.doSetup = void 0;
+const requirePermissions_1 = require("../../../requirePermissions");
+const ensureApiEnabled_1 = require("../../../ensureApiEnabled");
+const manifest = require("../../../extensions/manifest");
+async function doSetup(setup, config, options) {
+    var _a, _b;
+    const projectId = (_b = (_a = setup === null || setup === void 0 ? void 0 : setup.rcfile) === null || _a === void 0 ? void 0 : _a.projects) === null || _b === void 0 ? void 0 : _b.default;
+    if (projectId) {
+        await (0, requirePermissions_1.requirePermissions)(Object.assign(Object.assign({}, options), { project: projectId }));
+        await Promise.all([(0, ensureApiEnabled_1.ensure)(projectId, "firebaseextensions.googleapis.com", "unused", true)]);
+    }
+    return manifest.writeEmptyManifest(config, options);
+}
+exports.doSetup = doSetup;

package/lib/init/features/firestore/indexes.js

@@ -4,11 +4,11 @@ exports.initIndexes = void 0;
 const clc = require("colorette");
 const fs = require("fs");
 const error_1 = require("../../../error");
-const iv2 = require("../../../firestore/indexes");
+const api = require("../../../firestore/api");
 const fsutils = require("../../../fsutils");
 const prompt_1 = require("../../../prompt");
 const logger_1 = require("../../../logger");
-const indexes = new iv2.FirestoreIndexes();
+const indexes = new api.FirestoreApi();
 const INDEXES_TEMPLATE = fs.readFileSync(__dirname + "/../../../../templates/init/firestore/firestore.indexes.json", "utf8");
 function initIndexes(setup, config) {
     logger_1.logger.info();

package/lib/init/features/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.hostingGithub = exports.remoteconfig = exports.project = exports.emulators = exports.storage = exports.hosting = exports.functions = exports.firestore = exports.database = exports.account = void 0;
+exports.hostingGithub = exports.remoteconfig = exports.project = exports.extensions = exports.emulators = exports.storage = exports.hosting = exports.functions = exports.firestore = exports.database = exports.account = void 0;
 var account_1 = require("./account");
 Object.defineProperty(exports, "account", { enumerable: true, get: function () { return account_1.doSetup; } });
 var database_1 = require("./database");
@@ -15,6 +15,8 @@ var storage_1 = require("./storage");
 Object.defineProperty(exports, "storage", { enumerable: true, get: function () { return storage_1.doSetup; } });
 var emulators_1 = require("./emulators");
 Object.defineProperty(exports, "emulators", { enumerable: true, get: function () { return emulators_1.doSetup; } });
+var extensions_1 = require("./extensions");
+Object.defineProperty(exports, "extensions", { enumerable: true, get: function () { return extensions_1.doSetup; } });
 var project_1 = require("./project");
 Object.defineProperty(exports, "project", { enumerable: true, get: function () { return project_1.doSetup; } });
 var remoteconfig_1 = require("./remoteconfig");

package/lib/init/index.js

@@ -14,6 +14,7 @@ const featureFns = new Map([
     ["hosting", features.hosting],
     ["storage", features.storage],
     ["emulators", features.emulators],
+    ["extensions", features.extensions],
     ["project", features.project],
     ["remoteconfig", features.remoteconfig],
     ["hosting:github", features.hostingGithub],

package/lib/prompt.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.promptOnce = exports.prompt = void 0;
+exports.confirm = exports.promptOnce = exports.prompt = void 0;
 const inquirer = require("inquirer");
 const error_1 = require("./error");
 async function prompt(options, questions) {
@@ -30,3 +30,21 @@ async function promptOnce(question, options = {}) {
     return options[question.name];
 }
 exports.promptOnce = promptOnce;
+async function confirm(args) {
+    var _a;
+    if (!args.nonInteractive && !args.force) {
+        const message = (_a = args.message) !== null && _a !== void 0 ? _a : `Do you wish to continue?`;
+        return await promptOnce({
+            type: "confirm",
+            message,
+            default: args.default,
+        });
+    }
+    else if (args.nonInteractive && !args.force) {
+        throw new error_1.FirebaseError("Pass the --force flag to use this command in non-interactive mode");
+    }
+    else {
+        return true;
+    }
+}
+exports.confirm = confirm;

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "firebase-tools",
-  "version": "11.27.0",
+  "version": "11.28.0",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "firebase-tools",
-      "version": "11.27.0",
+      "version": "11.28.0",
       "license": "MIT",
       "dependencies": {
         "@google-cloud/pubsub": "^3.0.1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firebase-tools",
-  "version": "11.27.0",
+  "version": "11.28.0",
   "description": "Command-Line Interface for Firebase",
   "main": "./lib/index.js",
   "bin": {