firebase-tools 15.23.0 → 15.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/lib/bin/cli.js CHANGED
@@ -11,6 +11,7 @@ const fs = require("node:fs");
11
11
  const configstore_1 = require("../configstore");
12
12
  const errorOut_1 = require("../errorOut");
13
13
  const logger_1 = require("../logger");
14
+ const progressiveHelp_1 = require("./progressiveHelp");
14
15
  const experiments_1 = require("../experiments");
15
16
  (0, experiments_1.enableExperimentsFromCliEnvVariable)();
16
17
  const client = require("..");
@@ -50,6 +51,10 @@ function cli(pkg) {
50
51
  }
51
52
  process.env.IS_FIREBASE_CLI = "true";
52
53
  const logFilename = (0, logger_1.useFileLogger)();
54
+ const hasJson = args.includes("--json") || args.includes("-j");
55
+ if (!hasJson) {
56
+ (0, logger_1.useConsoleLoggers)();
57
+ }
53
58
  logger_1.logger.debug("-".repeat(70));
54
59
  logger_1.logger.debug("Command: ", process.argv.join(" "));
55
60
  logger_1.logger.debug("CLI Version: ", pkg.version);
@@ -113,16 +118,18 @@ function cli(pkg) {
113
118
  (0, errorOut_1.errorOut)(err);
114
119
  });
115
120
  const commandName = args[0];
121
+ const hasHelpFlag = args.includes("--help") || args.includes("-h");
116
122
  const isHelp = !args.length ||
117
123
  commandName === "help" ||
118
124
  (args.length === 1 && commandName === "ext") ||
119
- commandName === "--help";
120
- const hasHelpFlag = args.includes("--help") || args.includes("-h");
125
+ commandName === "--help" ||
126
+ hasHelpFlag;
121
127
  if (hasHelpFlag) {
122
128
  client.getCommand(commandName);
123
129
  }
124
130
  if (isHelp) {
125
131
  loadAllCommands(client);
132
+ (0, progressiveHelp_1.setupProgressiveHelp)(client);
126
133
  }
127
134
  if (!args.length) {
128
135
  client.cli.help();
@@ -0,0 +1,126 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.setupProgressiveHelp = setupProgressiveHelp;
4
+ const clc = require("colorette");
5
+ const logger_1 = require("../logger");
6
+ const NAMESPACE_DESCRIPTIONS = {
7
+ appdistribution: "manage App Distribution resources",
8
+ apphosting: "manage App Hosting resources",
9
+ apps: "manage Firebase apps",
10
+ auth: "manage Firebase Auth",
11
+ crashlytics: "manage Crashlytics symbols and mappings",
12
+ database: "manage Realtime Database",
13
+ dataconnect: "manage Data Connect resources",
14
+ emulators: "start and manage local Firebase emulators",
15
+ experiments: "enable and disable CLI experiments",
16
+ ext: "manage Firebase Extensions",
17
+ firestore: "manage Cloud Firestore resources",
18
+ functions: "manage Cloud Functions",
19
+ hosting: "manage Firebase Hosting sites and channels",
20
+ projects: "manage Firebase projects",
21
+ remoteconfig: "manage Remote Config",
22
+ target: "manage deploy targets",
23
+ };
24
+ function patchHelpInformation(cmd, prefix, program) {
25
+ const originalHelpInformation = cmd.helpInformation;
26
+ cmd.helpInformation = function () {
27
+ const filteredCommands = program.commands.filter((subCmd) => {
28
+ const name = subCmd.name();
29
+ if (prefix === "") {
30
+ return !name.includes(":");
31
+ }
32
+ else {
33
+ if (!name.startsWith(prefix + ":")) {
34
+ return false;
35
+ }
36
+ const remainder = name.slice(prefix.length + 1);
37
+ return !remainder.includes(":");
38
+ }
39
+ });
40
+ const originalCommands = this.commands;
41
+ this.commands = filteredCommands;
42
+ const result = originalHelpInformation.call(this);
43
+ this.commands = originalCommands;
44
+ return result;
45
+ };
46
+ }
47
+ function setupProgressiveHelp(client) {
48
+ const program = client.cli;
49
+ const existingNames = new Set(program.commands.map((cmd) => cmd.name()));
50
+ const allNamespaces = new Set();
51
+ for (const cmd of program.commands) {
52
+ const parts = cmd.name().split(":");
53
+ for (let i = 1; i < parts.length; i++) {
54
+ const ns = parts.slice(0, i).join(":");
55
+ allNamespaces.add(ns);
56
+ }
57
+ }
58
+ for (const ns of allNamespaces) {
59
+ if (!existingNames.has(ns)) {
60
+ const description = NAMESPACE_DESCRIPTIONS[ns] || `manage ${ns} resources`;
61
+ const nsCmd = program.command(ns);
62
+ nsCmd.description(description);
63
+ nsCmd.action(() => {
64
+ nsCmd.outputHelp();
65
+ });
66
+ nsCmd.on("--help", () => {
67
+ logger_1.logger.info();
68
+ logger_1.logger.info("To see more about a specific command, run:");
69
+ logger_1.logger.info(` ${clc.bold("firebase " + ns + ":<command> --help")}`);
70
+ });
71
+ }
72
+ }
73
+ try {
74
+ const { TARGETS, VALID_DEPLOY_TARGETS } = require("../deploy");
75
+ for (const targetName of VALID_DEPLOY_TARGETS) {
76
+ const ns = `deploy:${targetName}`;
77
+ if (!existingNames.has(ns)) {
78
+ const target = TARGETS[targetName];
79
+ const description = target.help || `deploy ${targetName} resources`;
80
+ const nsCmd = program.command(ns);
81
+ nsCmd.description(description);
82
+ nsCmd.action(() => {
83
+ nsCmd.outputHelp();
84
+ logger_1.logger.info();
85
+ logger_1.logger.info(`To deploy ${targetName}, run: ${clc.bold("firebase deploy --only " + targetName)}`);
86
+ logger_1.logger.info();
87
+ });
88
+ nsCmd.on("--help", () => {
89
+ logger_1.logger.info();
90
+ logger_1.logger.info(clc.bold(`Detailed setup and configuration for ${targetName}:`));
91
+ logger_1.logger.info();
92
+ if (target && target.detailedHelp) {
93
+ logger_1.logger.info(target.detailedHelp);
94
+ }
95
+ else {
96
+ logger_1.logger.info(`Configuration for ${clc.bold(targetName)} is defined in your project's ${clc.bold("firebase.json")}.`);
97
+ logger_1.logger.info(`For more details, see the Firebase documentation:`);
98
+ logger_1.logger.info(` https://firebase.google.com/docs/cli#the_firebasejson_file`);
99
+ }
100
+ logger_1.logger.info();
101
+ logger_1.logger.info(clc.bold("General help for firebase deploy:"));
102
+ logger_1.logger.info();
103
+ const deployCmd = program.commands.find((c) => c.name() === "deploy");
104
+ if (deployCmd) {
105
+ deployCmd.outputHelp();
106
+ }
107
+ });
108
+ }
109
+ }
110
+ }
111
+ catch (e) {
112
+ }
113
+ const progTyped = program;
114
+ patchHelpInformation(progTyped, "", progTyped);
115
+ for (const cmd of program.commands) {
116
+ const name = cmd.name();
117
+ if (allNamespaces.has(name)) {
118
+ patchHelpInformation(cmd, name, progTyped);
119
+ }
120
+ }
121
+ program.on("--help", () => {
122
+ logger_1.logger.info();
123
+ logger_1.logger.info("To see more about a specific namespace or command, run:");
124
+ logger_1.logger.info(` ${clc.bold("firebase <namespace|command> --help")}`);
125
+ });
126
+ }
@@ -1,7 +1,7 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.checkValidTargetFilters = checkValidTargetFilters;
4
- const deploy_1 = require("./commands/deploy");
4
+ const deploy_1 = require("./deploy");
5
5
  const error_1 = require("./error");
6
6
  function targetsForTypes(only, ...types) {
7
7
  return only.filter((t) => {
package/lib/command.js CHANGED
@@ -17,7 +17,6 @@ const auth_1 = require("./auth");
17
17
  const projects_1 = require("./management/projects");
18
18
  const studio_1 = require("./management/studio");
19
19
  const requireAuth_1 = require("./requireAuth");
20
- const logger_1 = require("./logger");
21
20
  const env_1 = require("./env");
22
21
  function isCommandModule(value) {
23
22
  return typeof value === "function" && typeof value.load === "function";
@@ -90,9 +89,6 @@ class Command {
90
89
  const start = process.uptime();
91
90
  const options = (0, lodash_1.last)(args);
92
91
  if (args.length - 1 > cmd._args.length) {
93
- if (!(0, utils_1.getInheritedOption)(options, "json") && !options.isMCP) {
94
- (0, logger_1.useConsoleLoggers)();
95
- }
96
92
  client.errorOut(new error_1.FirebaseError(`Too many arguments. Run ${clc.bold("firebase help " + this.name)} for usage instructions`, { exit: 1 }));
97
93
  return;
98
94
  }
@@ -172,9 +168,6 @@ class Command {
172
168
  if ((0, utils_1.getInheritedOption)(options, "debug")) {
173
169
  options.debug = true;
174
170
  }
175
- if (!(0, utils_1.getInheritedOption)(options, "json") && !options.isMCP) {
176
- (0, logger_1.useConsoleLoggers)();
177
- }
178
171
  if ((0, utils_1.getInheritedOption)(options, "config")) {
179
172
  options.configPath = (0, utils_1.getInheritedOption)(options, "config");
180
173
  }
@@ -23,7 +23,7 @@ const logger_1 = require("../logger");
23
23
  const responseToError_1 = require("../responseToError");
24
24
  let stdinUsedFor = undefined;
25
25
  exports.command = new command_1.Command("dataconnect:execute [file] [operationName]")
26
- .description("execute a SQL Connect query or mutation. If FIREBASE_DATACONNECT_EMULATOR_HOST is set (such as during 'firebase emulator:exec', executes against the emulator instead.")
26
+ .description(`execute a SQL Connect query or mutation. If ${constants_1.Constants.FIREBASE_DATACONNECT_EMULATOR_HOST} is set (such as during 'firebase emulator:exec'), executes against the emulator instead.`)
27
27
  .option("--service <serviceId>", "The service ID to execute against (optional if there's only one service)")
28
28
  .option("--location <locationId>", "The location ID to execute against (optional if there's only one service). Ignored by the emulator.")
29
29
  .option("--vars, --variables <vars>", "Supply variables to the operation execution, which must be a JSON object whose keys are variable names. If vars begin with the character @, the rest is interpreted as a file name to read from, or - to read from stdin.")
@@ -1,6 +1,6 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.command = exports.TARGET_PERMISSIONS = exports.VALID_DEPLOY_TARGETS = void 0;
3
+ exports.command = void 0;
4
4
  const requireDatabaseInstance_1 = require("../requireDatabaseInstance");
5
5
  const requirePermissions_1 = require("../requirePermissions");
6
6
  const checkIam_1 = require("../deploy/functions/checkIam");
@@ -17,69 +17,32 @@ const interactive_1 = require("../hosting/interactive");
17
17
  const utils_1 = require("../utils");
18
18
  const api_1 = require("../hosting/api");
19
19
  const experiments = require("../experiments");
20
- exports.VALID_DEPLOY_TARGETS = [
21
- "database",
22
- "storage",
23
- "firestore",
24
- "functions",
25
- "hosting",
26
- "remoteconfig",
27
- "extensions",
28
- "dataconnect",
29
- "apphosting",
30
- "auth",
31
- ];
32
- exports.TARGET_PERMISSIONS = {
33
- database: ["firebasedatabase.instances.update"],
34
- hosting: ["firebasehosting.sites.update"],
35
- functions: [
36
- "cloudfunctions.functions.list",
37
- "cloudfunctions.functions.create",
38
- "cloudfunctions.functions.get",
39
- "cloudfunctions.functions.update",
40
- "cloudfunctions.functions.delete",
41
- "cloudfunctions.operations.get",
42
- ],
43
- firestore: [
44
- "datastore.indexes.list",
45
- "datastore.indexes.create",
46
- "datastore.indexes.update",
47
- "datastore.indexes.delete",
48
- ],
49
- storage: [
50
- "firebaserules.releases.create",
51
- "firebaserules.rulesets.create",
52
- "firebaserules.releases.update",
53
- ],
54
- remoteconfig: ["cloudconfig.configs.get", "cloudconfig.configs.update"],
55
- dataconnect: [
56
- "cloudsql.databases.create",
57
- "cloudsql.databases.update",
58
- "cloudsql.instances.connect",
59
- "cloudsql.instances.create",
60
- "cloudsql.instances.get",
61
- "cloudsql.instances.list",
62
- "cloudsql.instances.update",
63
- "cloudsql.users.create",
64
- "firebasedataconnect.connectors.create",
65
- "firebasedataconnect.connectors.delete",
66
- "firebasedataconnect.connectors.list",
67
- "firebasedataconnect.connectors.update",
68
- "firebasedataconnect.operations.get",
69
- "firebasedataconnect.services.create",
70
- "firebasedataconnect.services.delete",
71
- "firebasedataconnect.services.update",
72
- "firebasedataconnect.services.list",
73
- "firebasedataconnect.schemas.create",
74
- "firebasedataconnect.schemas.delete",
75
- "firebasedataconnect.schemas.list",
76
- "firebasedataconnect.schemas.update",
77
- ],
78
- apphosting: [],
79
- auth: ["firebase.projects.update", "firebaseauth.configs.update"],
80
- };
20
+ const clc = require("colorette");
21
+ function getDeployHelp() {
22
+ const boldFn = (str) => clc.bold(str);
23
+ let targetHelp = "Deploy targets include:\n\n";
24
+ for (const [targetName, target] of Object.entries(deploy_1.TARGETS)) {
25
+ const desc = target.help || `Deploy ${targetName} resources`;
26
+ const formattedDesc = desc
27
+ .split("\n")
28
+ .map((line, i) => {
29
+ if (i === 0)
30
+ return line;
31
+ return " " + line;
32
+ })
33
+ .join("\n");
34
+ targetHelp += ` ${boldFn(targetName.padEnd(14))} ${formattedDesc}\n`;
35
+ }
36
+ targetHelp +=
37
+ "\nTo deploy specific targets, use `--only` followed by a comma-separated list of targets.\n";
38
+ targetHelp += `For example, ${boldFn("firebase deploy --only hosting,firestore")}.\n`;
39
+ targetHelp += `\nTo see detailed setup and configuration information for a specific target, run:\n`;
40
+ targetHelp += ` ${boldFn("firebase deploy:<target> --help")}`;
41
+ return targetHelp;
42
+ }
81
43
  exports.command = new command_1.Command("deploy")
82
44
  .description("deploy code and assets to your Firebase project")
45
+ .help(getDeployHelp())
83
46
  .withForce("delete Cloud Functions missing from the current working directory and bypass interactive prompts")
84
47
  .option("-p, --public <path>", "override the Hosting public directory specified in firebase.json")
85
48
  .option("-m, --message <message>", "an optional message describing this deploy")
@@ -100,9 +63,9 @@ if (experiments.isEnabled("apphostinglocalbuilds")) {
100
63
  exports.command
101
64
  .before(requireConfig_1.requireConfig)
102
65
  .before((options) => {
103
- options.filteredTargets = (0, filterTargets_1.filterTargets)(options, exports.VALID_DEPLOY_TARGETS);
66
+ options.filteredTargets = (0, filterTargets_1.filterTargets)(options, [...deploy_1.VALID_DEPLOY_TARGETS]);
104
67
  const permissions = options.filteredTargets.reduce((perms, target) => {
105
- return perms.concat(exports.TARGET_PERMISSIONS[target]);
68
+ return perms.concat(deploy_1.TARGET_PERMISSIONS[target]);
106
69
  }, []);
107
70
  return (0, requirePermissions_1.requirePermissions)(options, permissions);
108
71
  })
@@ -1,9 +1,34 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.release = exports.deploy = exports.prepare = void 0;
3
+ exports.detailedHelp = exports.help = exports.release = exports.deploy = exports.prepare = void 0;
4
4
  const prepare_1 = require("./prepare");
5
5
  exports.prepare = prepare_1.default;
6
6
  const deploy_1 = require("./deploy");
7
7
  exports.deploy = deploy_1.default;
8
8
  const release_1 = require("./release");
9
9
  exports.release = release_1.default;
10
+ exports.help = "Deploys framework-centered web apps. See https://firebase.google.com/docs/app-hosting/frameworks-tooling#web-frameworks-and-app-hosting for a full list of supported frameworks.";
11
+ exports.detailedHelp = "App Hosting deploys Frameworks-based web application backends.\n\n" +
12
+ "Single backend configuration in firebase.json:\n" +
13
+ "{\n" +
14
+ ' "apphosting": {\n' +
15
+ ' "backendId": "my-backend-id",\n' +
16
+ ' "rootDir": ".",\n' +
17
+ ' "ignore": ["node_modules", ".git"]\n' +
18
+ " }\n" +
19
+ "}\n\n" +
20
+ "Multiple backends configuration:\n" +
21
+ "{\n" +
22
+ ' "apphosting": [\n' +
23
+ " {\n" +
24
+ ' "backendId": "my-backend-1",\n' +
25
+ ' "rootDir": "apps/backend-1",\n' +
26
+ ' "ignore": ["node_modules"]\n' +
27
+ " },\n" +
28
+ " {\n" +
29
+ ' "backendId": "my-backend-2",\n' +
30
+ ' "rootDir": "apps/backend-2",\n' +
31
+ ' "ignore": ["node_modules"]\n' +
32
+ " }\n" +
33
+ " ]\n" +
34
+ "}";
@@ -1,9 +1,26 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.release = exports.deploy = exports.prepare = void 0;
3
+ exports.detailedHelp = exports.help = exports.release = exports.deploy = exports.prepare = void 0;
4
4
  var prepare_1 = require("./prepare");
5
5
  Object.defineProperty(exports, "prepare", { enumerable: true, get: function () { return prepare_1.prepare; } });
6
6
  var deploy_1 = require("./deploy");
7
7
  Object.defineProperty(exports, "deploy", { enumerable: true, get: function () { return deploy_1.deploy; } });
8
8
  var release_1 = require("./release");
9
9
  Object.defineProperty(exports, "release", { enumerable: true, get: function () { return release_1.release; } });
10
+ exports.help = "Deploys configuration settings for Firebase Authentication providers.";
11
+ exports.detailedHelp = "Firebase Authentication configures identity providers and sign-in methods.\n\n" +
12
+ "Configuration format in firebase.json:\n" +
13
+ "{\n" +
14
+ ' "auth": {\n' +
15
+ ' "providers": {\n' +
16
+ ' "anonymous": true,\n' +
17
+ ' "emailPassword": true,\n' +
18
+ ' "googleSignIn": {\n' +
19
+ ' "authorizedRedirectUris": [\n' +
20
+ ' "https://my-app.firebaseapp.com/__/auth/handler"\n' +
21
+ " ],\n" +
22
+ ' "supportEmail": "support@example.com"\n' +
23
+ " }\n" +
24
+ " }\n" +
25
+ " }\n" +
26
+ "}";
@@ -1,9 +1,24 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.release = exports.deploy = exports.prepare = void 0;
3
+ exports.detailedHelp = exports.help = exports.release = exports.deploy = exports.prepare = void 0;
4
4
  var prepare_1 = require("./prepare");
5
5
  Object.defineProperty(exports, "prepare", { enumerable: true, get: function () { return prepare_1.prepare; } });
6
6
  var deploy_1 = require("./deploy");
7
7
  Object.defineProperty(exports, "deploy", { enumerable: true, get: function () { return deploy_1.deploy; } });
8
8
  var release_1 = require("./release");
9
9
  Object.defineProperty(exports, "release", { enumerable: true, get: function () { return release_1.release; } });
10
+ exports.help = "Deploys security rules referenced by your project's firebase.json.";
11
+ exports.detailedHelp = "Realtime Database deploys rules to database instances.\n\n" +
12
+ "Single database configuration in firebase.json:\n" +
13
+ "{\n" +
14
+ ' "database": {\n' +
15
+ ' "rules": "database.rules"\n' +
16
+ " }\n" +
17
+ "}\n\n" +
18
+ "Multiple database instances configuration (by target or database ID):\n" +
19
+ "{\n" +
20
+ ' "database": [\n' +
21
+ ' { "target": "my-db-target", "rules": "rules.rules" },\n' +
22
+ ' { "database": "my-database-id", "rules": "rules2.rules" }\n' +
23
+ " ]\n" +
24
+ "}";
@@ -1,9 +1,27 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.release = exports.deploy = exports.prepare = void 0;
3
+ exports.detailedHelp = exports.help = exports.release = exports.deploy = exports.prepare = void 0;
4
4
  const prepare_1 = require("./prepare");
5
5
  exports.prepare = prepare_1.default;
6
6
  const deploy_1 = require("./deploy");
7
7
  exports.deploy = deploy_1.default;
8
8
  const release_1 = require("./release");
9
9
  exports.release = release_1.default;
10
+ exports.help = "Deploys Data Connect services, schemas, and connectors. Supports filtering:\n" +
11
+ " --only dataconnect:serviceId\n" +
12
+ " --only dataconnect:serviceId:connectorId\n" +
13
+ " --only dataconnect:serviceId:schema";
14
+ exports.detailedHelp = "Firebase Data Connect deploys services, GraphQL schemas, and connectors.\n\n" +
15
+ "Single service configuration in firebase.json:\n" +
16
+ "{\n" +
17
+ ' "dataconnect": {\n' +
18
+ ' "source": "dataconnect"\n' +
19
+ " }\n" +
20
+ "}\n\n" +
21
+ "Multiple services configuration:\n" +
22
+ "{\n" +
23
+ ' "dataconnect": [\n' +
24
+ ' { "source": "dataconnect-service-1" },\n' +
25
+ ' { "source": "dataconnect-service-2" }\n' +
26
+ " ]\n" +
27
+ "}";
@@ -1,9 +1,17 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.release = exports.deploy = exports.prepare = void 0;
3
+ exports.detailedHelp = exports.help = exports.release = exports.deploy = exports.prepare = void 0;
4
4
  var prepare_1 = require("./prepare");
5
5
  Object.defineProperty(exports, "prepare", { enumerable: true, get: function () { return prepare_1.prepare; } });
6
6
  var deploy_1 = require("./deploy");
7
7
  Object.defineProperty(exports, "deploy", { enumerable: true, get: function () { return deploy_1.deploy; } });
8
8
  var release_1 = require("./release");
9
9
  Object.defineProperty(exports, "release", { enumerable: true, get: function () { return release_1.release; } });
10
+ exports.help = "Deploys configuration changes to your installed Extension instances.";
11
+ exports.detailedHelp = "Firebase Extensions deploys settings and configuration environments for installed extension instances.\n\n" +
12
+ "Configuration format in firebase.json:\n" +
13
+ "{\n" +
14
+ ' "extensions": {\n' +
15
+ ' "my-extension-instance-id": "firebase/storage-resize-images@^0.1.0"\n' +
16
+ " }\n" +
17
+ "}";
@@ -1,9 +1,28 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.release = exports.deploy = exports.prepare = void 0;
3
+ exports.detailedHelp = exports.help = exports.release = exports.deploy = exports.prepare = void 0;
4
4
  const prepare_1 = require("./prepare");
5
5
  exports.prepare = prepare_1.default;
6
6
  const deploy_1 = require("./deploy");
7
7
  exports.deploy = deploy_1.default;
8
8
  const release_1 = require("./release");
9
9
  exports.release = release_1.default;
10
+ exports.help = "Deploys security rules and indexes referenced by your project's firebase.json.";
11
+ exports.detailedHelp = "Cloud Firestore deploys security rules and indexes to Firestore databases.\n\n" +
12
+ "Single database configuration in firebase.json:\n" +
13
+ "{\n" +
14
+ ' "firestore": {\n' +
15
+ ' "rules": "firestore.rules",\n' +
16
+ ' "indexes": "firestore.indexes.json",\n' +
17
+ ' "location": "us-east1",\n' +
18
+ ' "edition": "standard",\n' +
19
+ ' "dataAccessMode": "FIRESTORE_NATIVE"\n' +
20
+ " }\n" +
21
+ "}\n\n" +
22
+ "Multiple databases configuration (by target or database ID):\n" +
23
+ "{\n" +
24
+ ' "firestore": [\n' +
25
+ ' { "target": "my-firestore-target", "rules": "firestore.rules", "indexes": "indexes.json" },\n' +
26
+ ' { "database": "another-db", "rules": "another.rules", "indexes": "another.indexes.json", "location": "europe-west1", "edition": "enterprise", "dataAccessMode": "MONGODB_COMPATIBLE" }\n' +
27
+ " ]\n" +
28
+ "}";
@@ -1,9 +1,41 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.release = exports.deploy = exports.prepare = void 0;
3
+ exports.detailedHelp = exports.help = exports.release = exports.deploy = exports.prepare = void 0;
4
4
  var prepare_1 = require("./prepare");
5
5
  Object.defineProperty(exports, "prepare", { enumerable: true, get: function () { return prepare_1.prepare; } });
6
6
  var deploy_1 = require("./deploy");
7
7
  Object.defineProperty(exports, "deploy", { enumerable: true, get: function () { return deploy_1.deploy; } });
8
8
  var release_1 = require("./release");
9
9
  Object.defineProperty(exports, "release", { enumerable: true, get: function () { return release_1.release; } });
10
+ exports.help = "Deploys functions from the functions directory. Supports filtering function deploys:\n" +
11
+ " --only functions:func1,functions:func2 (scoped function deploy)\n" +
12
+ " --only functions:group.subgroup (scoped by export group)\n" +
13
+ " --only functions:codebase:func (scoped by codebase and function)";
14
+ exports.detailedHelp = "Cloud Functions deploys functions source code from your local codebases.\n\n" +
15
+ "Single codebase configuration in firebase.json:\n" +
16
+ "{\n" +
17
+ ' "functions": {\n' +
18
+ ' "source": "functions",\n' +
19
+ ' "codebase": "default",\n' +
20
+ ' "runtime": "nodejs20",\n' +
21
+ ' "predeploy": [\n' +
22
+ ' "npm --prefix \\"$RESOURCE_DIR\\" run lint",\n' +
23
+ ' "npm --prefix \\"$RESOURCE_DIR\\" run build"\n' +
24
+ " ]\n" +
25
+ " }\n" +
26
+ "}\n\n" +
27
+ "Multiple codebases configuration:\n" +
28
+ "{\n" +
29
+ ' "functions": [\n' +
30
+ " {\n" +
31
+ ' "source": "functions-backend",\n' +
32
+ ' "codebase": "backend",\n' +
33
+ ' "runtime": "nodejs20"\n' +
34
+ " },\n" +
35
+ " {\n" +
36
+ ' "source": "functions-frontend",\n' +
37
+ ' "codebase": "frontend",\n' +
38
+ ' "runtime": "nodejs22"\n' +
39
+ " }\n" +
40
+ " ]\n" +
41
+ "}";