firebase-tools 15.26.0 → 15.27.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.
Files changed (48) hide show
  1. package/lib/appcheck/api.js +19 -0
  2. package/lib/appcheck/providers.js +240 -0
  3. package/lib/commands/appcheck-apps-list.js +78 -0
  4. package/lib/commands/appcheck-debugtokens-create.js +2 -2
  5. package/lib/commands/appcheck-debugtokens-delete.js +2 -2
  6. package/lib/commands/appcheck-debugtokens-list.js +2 -2
  7. package/lib/commands/appcheck-prompts.js +55 -0
  8. package/lib/commands/appcheck-providers-get.js +73 -0
  9. package/lib/commands/appcheck-providers-list.js +67 -0
  10. package/lib/commands/appcheck-providers-set.js +96 -0
  11. package/lib/commands/ext-export.js +75 -3
  12. package/lib/commands/functions-kits-install.js +294 -0
  13. package/lib/commands/index.js +10 -0
  14. package/lib/crashlytics/filters.js +12 -4
  15. package/lib/crashlytics/reports.js +2 -0
  16. package/lib/crashlytics/types.js +8 -1
  17. package/lib/deploy/functions/backend.js +11 -1
  18. package/lib/deploy/functions/build.js +1 -1
  19. package/lib/deploy/functions/params.js +5 -1
  20. package/lib/deploy/functions/prepare.js +26 -13
  21. package/lib/deploy/functions/prompts.js +1 -1
  22. package/lib/deploy/functions/release/lifecycle.js +11 -0
  23. package/lib/deploy/functions/release/planner.js +5 -2
  24. package/lib/emulator/controller.js +1 -0
  25. package/lib/emulator/functionsEmulator.js +3 -1
  26. package/lib/experiments.js +11 -5
  27. package/lib/extensions/export.js +47 -0
  28. package/lib/functions/env.js +20 -7
  29. package/lib/functions/projectConfig.js +19 -11
  30. package/lib/functions/python.js +1 -1
  31. package/lib/gcp/runv2.js +1 -0
  32. package/lib/mcp/onemcp/index.js +2 -1
  33. package/lib/mcp/onemcp/onemcp_server.js +38 -11
  34. package/lib/mcp/prompts/crashlytics/connect.js +1 -1
  35. package/lib/mcp/resources/guides/crashlytics_issues.js +3 -3
  36. package/lib/mcp/resources/guides/crashlytics_reports.js +32 -11
  37. package/lib/mcp/tool.js +5 -0
  38. package/lib/mcp/tools/crashlytics/notes.js +3 -3
  39. package/lib/mcp/tools/crashlytics/reports.js +2 -0
  40. package/lib/mcp/util/crashlytics/availability.js +54 -1
  41. package/lib/serve/functions.js +1 -1
  42. package/lib/tsconfig.compile.tsbuildinfo +1 -1
  43. package/lib/tsconfig.publish.tsbuildinfo +1 -1
  44. package/package.json +1 -1
  45. package/schema/firebase-config.json +3 -3
  46. package/templates/init/functions/typescript/index-kit-migration.ts +49 -0
  47. package/templates/init/functions/typescript/index-kit.ts +35 -0
  48. package/lib/appcheck/prompts.js +0 -41
@@ -7,8 +7,12 @@ exports.deleteDebugToken = deleteDebugToken;
7
7
  exports.listServices = listServices;
8
8
  exports.getService = getService;
9
9
  exports.updateService = updateService;
10
+ exports.getProviderConfig = getProviderConfig;
11
+ exports.updateProviderConfig = updateProviderConfig;
12
+ exports.batchGetProviderConfigs = batchGetProviderConfigs;
10
13
  const api_1 = require("../api");
11
14
  const apiv2_1 = require("../apiv2");
15
+ const providers_1 = require("./providers");
12
16
  const API_VERSION = "v1";
13
17
  exports.client = new apiv2_1.Client({
14
18
  urlPrefix: (0, api_1.appCheckOrigin)(),
@@ -73,3 +77,18 @@ async function updateService(projectNumber, serviceId, update) {
73
77
  const res = await exports.client.patch(`projects/${projectNumber}/services/${serviceId}`, update, { queryParams: { updateMask: updateMask.join(",") } });
74
78
  return res.body;
75
79
  }
80
+ async function getProviderConfig(projectNumber, appId, provider) {
81
+ const { configResource } = providers_1.PROVIDER_META[provider];
82
+ const res = await exports.client.get(`projects/${projectNumber}/apps/${appId}/${configResource}`);
83
+ return res.body;
84
+ }
85
+ async function updateProviderConfig(projectNumber, appId, provider, update, updateMask) {
86
+ const { configResource } = providers_1.PROVIDER_META[provider];
87
+ const res = await exports.client.patch(`projects/${projectNumber}/apps/${appId}/${configResource}`, update, { queryParams: { updateMask: updateMask.join(",") } });
88
+ return res.body;
89
+ }
90
+ async function batchGetProviderConfigs(projectNumber, provider) {
91
+ const { configResource } = providers_1.PROVIDER_META[provider];
92
+ const res = await exports.client.get(`projects/${projectNumber}/apps/-/${configResource}:batchGet`);
93
+ return res.body?.configs ?? [];
94
+ }
@@ -0,0 +1,240 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.ATTESTATION_PROVIDERS = exports.PROVIDER_META = exports.DEVICE_INTEGRITY_LEVELS = void 0;
4
+ exports.providerHelp = providerHelp;
5
+ exports.parseProviderType = parseProviderType;
6
+ exports.providersForPlatform = providersForPlatform;
7
+ exports.assertProviderSupportsPlatform = assertProviderSupportsPlatform;
8
+ exports.isConfigured = isConfigured;
9
+ exports.formatTokenTtl = formatTokenTtl;
10
+ exports.summarizeConfig = summarizeConfig;
11
+ exports.buildProviderUpdate = buildProviderUpdate;
12
+ const fs = require("fs");
13
+ const error_1 = require("../error");
14
+ const TTL_MIN_SECONDS = 30 * 60;
15
+ const TTL_MAX_SECONDS = 7 * 24 * 60 * 60;
16
+ exports.DEVICE_INTEGRITY_LEVELS = {
17
+ none: "NO_INTEGRITY",
18
+ basic: "MEETS_BASIC_INTEGRITY",
19
+ device: "MEETS_DEVICE_INTEGRITY",
20
+ strong: "MEETS_STRONG_INTEGRITY",
21
+ };
22
+ exports.PROVIDER_META = {
23
+ "app-attest": { configResource: "appAttestConfig", platforms: ["IOS"], label: "App Attest" },
24
+ "device-check": { configResource: "deviceCheckConfig", platforms: ["IOS"], label: "DeviceCheck" },
25
+ "play-integrity": {
26
+ configResource: "playIntegrityConfig",
27
+ platforms: ["ANDROID"],
28
+ label: "Play Integrity",
29
+ },
30
+ "recaptcha-enterprise": {
31
+ configResource: "recaptchaEnterpriseConfig",
32
+ platforms: ["IOS", "ANDROID", "WEB"],
33
+ label: "reCAPTCHA Enterprise",
34
+ },
35
+ "recaptcha-v3": {
36
+ configResource: "recaptchaV3Config",
37
+ platforms: ["WEB"],
38
+ label: "reCAPTCHA v3",
39
+ },
40
+ };
41
+ exports.ATTESTATION_PROVIDERS = [
42
+ "app-attest",
43
+ "device-check",
44
+ "play-integrity",
45
+ "recaptcha-enterprise",
46
+ "recaptcha-v3",
47
+ ];
48
+ function providerHelp() {
49
+ return exports.ATTESTATION_PROVIDERS.map((p) => ` ${p.padEnd(22)} ${exports.PROVIDER_META[p].label} (${exports.PROVIDER_META[p].platforms.join(", ")})`).join("\n");
50
+ }
51
+ function parseProviderType(provider) {
52
+ if (provider in exports.PROVIDER_META) {
53
+ return provider;
54
+ }
55
+ throw new error_1.FirebaseError(`Unknown provider: ${provider}\n\nValid providers:\n\n${providerHelp()}`);
56
+ }
57
+ function providerSupportsPlatform(provider, platform) {
58
+ return exports.PROVIDER_META[provider].platforms.some((p) => p === platform);
59
+ }
60
+ function providersForPlatform(platform) {
61
+ return exports.ATTESTATION_PROVIDERS.filter((p) => providerSupportsPlatform(p, platform));
62
+ }
63
+ function assertProviderSupportsPlatform(provider, platform, appId) {
64
+ if (providerSupportsPlatform(provider, platform)) {
65
+ return;
66
+ }
67
+ const supported = providersForPlatform(platform);
68
+ const platformName = platform.charAt(0) + platform.slice(1).toLowerCase();
69
+ throw new error_1.FirebaseError(`${provider} is a ${exports.PROVIDER_META[provider].platforms.join("/")} provider. App ${appId} is a ${platformName} app.\n\n` +
70
+ (supported.length
71
+ ? `Providers for ${platformName} apps: ${supported.join(", ")}.`
72
+ : `No App Check providers are available for ${platformName} apps.`));
73
+ }
74
+ function isConfigured(provider, config) {
75
+ switch (provider) {
76
+ case "device-check":
77
+ return Boolean(config.privateKeySet ?? config.keyId);
78
+ case "recaptcha-v3":
79
+ return Boolean(config.siteSecretSet);
80
+ case "recaptcha-enterprise":
81
+ return Boolean(config.siteKey);
82
+ default:
83
+ return null;
84
+ }
85
+ }
86
+ function parseTokenTtl(ttl) {
87
+ const match = /^(\d+)([smhd])$/.exec(ttl.trim());
88
+ if (!match) {
89
+ throw new error_1.FirebaseError(`Invalid --token-ttl: ${ttl}. Use a number followed by s, m, h or d, for example 30m, 2h or 1d.`);
90
+ }
91
+ const value = Number(match[1]);
92
+ const unitSeconds = { s: 1, m: 60, h: 3600, d: 86400 };
93
+ const seconds = value * unitSeconds[match[2]];
94
+ if (seconds < TTL_MIN_SECONDS || seconds > TTL_MAX_SECONDS) {
95
+ throw new error_1.FirebaseError(`Invalid --token-ttl: ${ttl}. Must be between 30 minutes (30m) and 7 days (7d).`);
96
+ }
97
+ return `${seconds}s`;
98
+ }
99
+ function formatTokenTtl(ttl) {
100
+ if (!ttl) {
101
+ return "default";
102
+ }
103
+ const seconds = Number(ttl.replace(/s$/, ""));
104
+ if (!Number.isFinite(seconds)) {
105
+ return ttl;
106
+ }
107
+ if (seconds % 86400 === 0) {
108
+ return `${seconds / 86400}d`;
109
+ }
110
+ if (seconds % 3600 === 0) {
111
+ return `${seconds / 3600}h`;
112
+ }
113
+ if (seconds % 60 === 0) {
114
+ return `${seconds / 60}m`;
115
+ }
116
+ return `${seconds}s`;
117
+ }
118
+ function resolveSecretFlag(value) {
119
+ if (!value.startsWith("@")) {
120
+ return value;
121
+ }
122
+ const path = value.slice(1);
123
+ try {
124
+ return fs.readFileSync(path, "utf8").trim();
125
+ }
126
+ catch (err) {
127
+ throw new error_1.FirebaseError(`Could not read ${path}: ${(0, error_1.getErrMsg)(err)}`, {
128
+ original: (0, error_1.getError)(err),
129
+ });
130
+ }
131
+ }
132
+ function parseMinScore(value) {
133
+ const score = Number(value);
134
+ if (!Number.isFinite(score) || score < 0 || score > 1) {
135
+ throw new error_1.FirebaseError(`--min-score must be a number between 0.0 and 1.0.`);
136
+ }
137
+ return score;
138
+ }
139
+ function parseDeviceIntegrityLevel(level) {
140
+ const parsed = exports.DEVICE_INTEGRITY_LEVELS[level.toLowerCase()];
141
+ if (!parsed) {
142
+ throw new error_1.FirebaseError(`Invalid --min-device-integrity: ${level}. Must be one of: ${Object.keys(exports.DEVICE_INTEGRITY_LEVELS).join(", ")}.`);
143
+ }
144
+ return parsed;
145
+ }
146
+ function summarizeConfig(provider, config) {
147
+ switch (provider) {
148
+ case "device-check":
149
+ return config.keyId ? `key id: ${config.keyId}` : "";
150
+ case "recaptcha-enterprise":
151
+ return [
152
+ config.siteKey ? `site key: ${config.siteKey}` : "",
153
+ config.riskAnalysis?.minValidScore !== undefined
154
+ ? `min score: ${config.riskAnalysis.minValidScore}`
155
+ : "",
156
+ ]
157
+ .filter(Boolean)
158
+ .join(", ");
159
+ case "recaptcha-v3":
160
+ return config.minValidScore !== undefined ? `min score: ${config.minValidScore}` : "";
161
+ case "play-integrity":
162
+ return [
163
+ config.deviceIntegrity?.minDeviceRecognitionLevel
164
+ ? `min device: ${config.deviceIntegrity.minDeviceRecognitionLevel}`
165
+ : "",
166
+ config.accountDetails?.requireLicensed ? "licensed required" : "",
167
+ config.appIntegrity?.allowUnrecognizedVersion ? "unrecognized versions allowed" : "",
168
+ ]
169
+ .filter(Boolean)
170
+ .join(", ");
171
+ default:
172
+ return "";
173
+ }
174
+ }
175
+ function buildProviderUpdate(provider, options) {
176
+ const update = {};
177
+ const updateMask = [];
178
+ if (options.tokenTtl) {
179
+ update.tokenTtl = parseTokenTtl(options.tokenTtl);
180
+ updateMask.push("tokenTtl");
181
+ }
182
+ switch (provider) {
183
+ case "device-check": {
184
+ if (Boolean(options.keyId) !== Boolean(options.privateKey)) {
185
+ throw new error_1.FirebaseError(`device-check needs both --key-id and --private-key.`);
186
+ }
187
+ if (options.keyId && options.privateKey) {
188
+ update.keyId = options.keyId;
189
+ update.privateKey = resolveSecretFlag(options.privateKey);
190
+ updateMask.push("keyId", "privateKey");
191
+ }
192
+ break;
193
+ }
194
+ case "recaptcha-enterprise": {
195
+ if (options.siteKey) {
196
+ update.siteKey = options.siteKey;
197
+ updateMask.push("siteKey");
198
+ }
199
+ if (options.minScore) {
200
+ update.riskAnalysis = { minValidScore: parseMinScore(options.minScore) };
201
+ updateMask.push("riskAnalysis.minValidScore");
202
+ }
203
+ break;
204
+ }
205
+ case "recaptcha-v3": {
206
+ if (options.siteSecret) {
207
+ update.siteSecret = resolveSecretFlag(options.siteSecret);
208
+ updateMask.push("siteSecret");
209
+ }
210
+ if (options.minScore) {
211
+ update.minValidScore = parseMinScore(options.minScore);
212
+ updateMask.push("minValidScore");
213
+ }
214
+ break;
215
+ }
216
+ case "play-integrity": {
217
+ if (options.minDeviceIntegrity) {
218
+ update.deviceIntegrity = {
219
+ minDeviceRecognitionLevel: parseDeviceIntegrityLevel(options.minDeviceIntegrity),
220
+ };
221
+ updateMask.push("deviceIntegrity.minDeviceRecognitionLevel");
222
+ }
223
+ if (options.requireLicensed !== undefined) {
224
+ update.accountDetails = { requireLicensed: options.requireLicensed };
225
+ updateMask.push("accountDetails.requireLicensed");
226
+ }
227
+ if (options.allowUnrecognizedVersion !== undefined) {
228
+ update.appIntegrity = { allowUnrecognizedVersion: options.allowUnrecognizedVersion };
229
+ updateMask.push("appIntegrity.allowUnrecognizedVersion");
230
+ }
231
+ break;
232
+ }
233
+ case "app-attest":
234
+ break;
235
+ }
236
+ if (updateMask.length === 0) {
237
+ throw new error_1.FirebaseError(`Nothing to set for ${provider}. Pass at least one setting, for example --token-ttl 1h.`);
238
+ }
239
+ return { update, updateMask };
240
+ }
@@ -0,0 +1,78 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.command = void 0;
4
+ const clc = require("colorette");
5
+ const Table = require("cli-table3");
6
+ const command_1 = require("../command");
7
+ const projectUtils_1 = require("../projectUtils");
8
+ const requireAuth_1 = require("../requireAuth");
9
+ const requirePermissions_1 = require("../requirePermissions");
10
+ const logger_1 = require("../logger");
11
+ const utils_1 = require("../utils");
12
+ const apps_1 = require("../management/apps");
13
+ const api_1 = require("../appcheck/api");
14
+ const providers_1 = require("../appcheck/providers");
15
+ function appIdFromConfigName(name) {
16
+ return name?.split("/apps/")[1]?.split("/")[0] ?? "";
17
+ }
18
+ exports.command = new command_1.Command("appcheck:apps:list")
19
+ .description("list apps with their App Check attestation providers")
20
+ .help(`shows every app in the project with the App Check providers that are set up for it.
21
+
22
+ Use this to see which apps are ready before turning enforcement on with \`appcheck:services:set\`.
23
+
24
+ App Attest and Play Integrity are left out of the Providers column: they have no key or secret to register, so the API cannot say whether an app really uses them. Use \`appcheck:providers:list --app <appId>\` to see their settings.`)
25
+ .before(requireAuth_1.requireAuth)
26
+ .before(requirePermissions_1.requirePermissions, [
27
+ "firebaseappcheck.appAttestConfig.get",
28
+ "firebaseappcheck.deviceCheckConfig.get",
29
+ "firebaseappcheck.playIntegrityConfig.get",
30
+ "firebaseappcheck.recaptchaEnterpriseConfig.get",
31
+ "firebaseappcheck.recaptchaV3Config.get",
32
+ ])
33
+ .action(async (options) => {
34
+ const projectId = (0, projectUtils_1.needProjectId)(options);
35
+ const projectNumber = await (0, projectUtils_1.needProjectNumber)(options);
36
+ const { apps, configsByProvider } = await (0, utils_1.promiseWithSpinner)(async () => {
37
+ const [appList, ...configLists] = await Promise.all([
38
+ (0, apps_1.listFirebaseApps)(projectId, apps_1.AppPlatform.ANY),
39
+ ...providers_1.ATTESTATION_PROVIDERS.map((p) => (0, api_1.batchGetProviderConfigs)(projectNumber, p)),
40
+ ]);
41
+ return {
42
+ apps: appList,
43
+ configsByProvider: new Map(providers_1.ATTESTATION_PROVIDERS.map((p, i) => [p, configLists[i]])),
44
+ };
45
+ }, "Reading apps and App Check providers");
46
+ const rows = apps.map((app) => {
47
+ const providers = (0, providers_1.providersForPlatform)(app.platform).filter((provider) => {
48
+ const config = configsByProvider
49
+ .get(provider)
50
+ ?.find((c) => appIdFromConfigName(c.name) === app.appId);
51
+ return Boolean(config && (0, providers_1.isConfigured)(provider, config));
52
+ });
53
+ return {
54
+ appId: app.appId,
55
+ platform: app.platform,
56
+ displayName: app.displayName ?? "",
57
+ providers,
58
+ };
59
+ });
60
+ if (rows.length === 0) {
61
+ logger_1.logger.info(clc.bold(`No apps found in project ${projectId}.`));
62
+ return rows;
63
+ }
64
+ const table = new Table({
65
+ head: ["App ID", "Platform", "Display Name", "Providers"],
66
+ style: { head: ["green"] },
67
+ });
68
+ for (const row of rows) {
69
+ table.push([
70
+ clc.bold(row.appId),
71
+ row.platform,
72
+ row.displayName,
73
+ row.providers.length ? row.providers.join(", ") : "not configured",
74
+ ]);
75
+ }
76
+ logger_1.logger.info(table.toString());
77
+ return rows;
78
+ });
@@ -7,7 +7,7 @@ const os = require("os");
7
7
  const command_1 = require("../command");
8
8
  const projectUtils_1 = require("../projectUtils");
9
9
  const api_1 = require("../appcheck/api");
10
- const prompts_1 = require("../appcheck/prompts");
10
+ const appcheck_prompts_1 = require("./appcheck-prompts");
11
11
  const requireAuth_1 = require("../requireAuth");
12
12
  const utils_1 = require("../utils");
13
13
  const error_1 = require("../error");
@@ -20,7 +20,7 @@ exports.command = new command_1.Command("appcheck:debugtokens:create [debugToken
20
20
  .option("--force", "overwrite existing debug token if it has the same display name without prompting")
21
21
  .before(requireAuth_1.requireAuth)
22
22
  .action(async (debugToken, options) => {
23
- const { appId } = await (0, prompts_1.getOrPromptProjectAndAppId)(options);
23
+ const { appId } = await (0, appcheck_prompts_1.getOrPromptProjectAndAppId)(options);
24
24
  const projectNumber = await (0, projectUtils_1.needProjectNumber)(options);
25
25
  let token = debugToken;
26
26
  if (!token) {
@@ -5,7 +5,7 @@ const clc = require("colorette");
5
5
  const command_1 = require("../command");
6
6
  const projectUtils_1 = require("../projectUtils");
7
7
  const api_1 = require("../appcheck/api");
8
- const prompts_1 = require("../appcheck/prompts");
8
+ const appcheck_prompts_1 = require("./appcheck-prompts");
9
9
  const requireAuth_1 = require("../requireAuth");
10
10
  const utils_1 = require("../utils");
11
11
  const prompt_1 = require("../prompt");
@@ -16,7 +16,7 @@ exports.command = new command_1.Command("appcheck:debugtokens:delete <debugToken
16
16
  .option("--force", "attempt to delete debug token without prompting for confirmation")
17
17
  .before(requireAuth_1.requireAuth)
18
18
  .action(async (debugTokenId, options) => {
19
- const { appId } = await (0, prompts_1.getOrPromptProjectAndAppId)(options, "Select the app to delete a debug token from:");
19
+ const { appId } = await (0, appcheck_prompts_1.getOrPromptProjectAndAppId)(options, "Select the app to delete a debug token from:");
20
20
  const projectNumber = await (0, projectUtils_1.needProjectNumber)(options);
21
21
  let debugTokenName = debugTokenId;
22
22
  if (!debugTokenName.startsWith("projects/")) {
@@ -6,7 +6,7 @@ const Table = require("cli-table3");
6
6
  const command_1 = require("../command");
7
7
  const projectUtils_1 = require("../projectUtils");
8
8
  const api_1 = require("../appcheck/api");
9
- const prompts_1 = require("../appcheck/prompts");
9
+ const appcheck_prompts_1 = require("./appcheck-prompts");
10
10
  const requireAuth_1 = require("../requireAuth");
11
11
  const logger_1 = require("../logger");
12
12
  const utils_1 = require("../utils");
@@ -27,7 +27,7 @@ exports.command = new command_1.Command("appcheck:debugtokens:list")
27
27
  .option("--app <appId>", "the app id of your Firebase app")
28
28
  .before(requireAuth_1.requireAuth)
29
29
  .action(async (options) => {
30
- const { appId } = await (0, prompts_1.getOrPromptProjectAndAppId)(options, "Select the app to list debug tokens for:");
30
+ const { appId } = await (0, appcheck_prompts_1.getOrPromptProjectAndAppId)(options, "Select the app to list debug tokens for:");
31
31
  const projectNumber = await (0, projectUtils_1.needProjectNumber)(options);
32
32
  const debugTokens = await (0, utils_1.promiseWithSpinner)(async () => await (0, api_1.listDebugTokens)(projectNumber, appId), `Listing App Check debug tokens for app ${clc.bold(appId)}`);
33
33
  logDebugTokensList(debugTokens);
@@ -0,0 +1,55 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.getOrPromptProjectAndAppId = void 0;
4
+ exports.getOrPromptAppId = getOrPromptAppId;
5
+ exports.getOrPromptApp = getOrPromptApp;
6
+ const apps_1 = require("../management/apps");
7
+ const projectUtils_1 = require("../projectUtils");
8
+ const appUtils_1 = require("../appUtils");
9
+ const error_1 = require("../error");
10
+ const logger_1 = require("../logger");
11
+ const clc = require("colorette");
12
+ async function chooseApp(projectId, apps, options, message) {
13
+ const localApps = await (0, appUtils_1.detectApps)(options.cwd || process.cwd());
14
+ const localAppIds = localApps.map((a) => a.appId).filter(Boolean);
15
+ const local = localAppIds.length ? apps.filter((app) => localAppIds.includes(app.appId)) : [];
16
+ const choices = local.length ? local : apps;
17
+ if (choices.length === 1) {
18
+ return choices[0];
19
+ }
20
+ if (options.nonInteractive) {
21
+ throw new error_1.FirebaseError(`Project ${projectId} has multiple apps, must specify an app id.`);
22
+ }
23
+ return (0, apps_1.selectAppInteractively)(choices, apps_1.AppPlatform.ANY, { message });
24
+ }
25
+ async function listAppsOrThrow(projectId) {
26
+ const apps = await (0, apps_1.listFirebaseApps)(projectId, apps_1.AppPlatform.ANY);
27
+ if (!apps.length) {
28
+ throw new error_1.FirebaseError(`There are no apps associated with project ${projectId}.`);
29
+ }
30
+ return apps;
31
+ }
32
+ async function getOrPromptAppId(options, message = "Select the app to register a debug token for:") {
33
+ const projectId = (0, projectUtils_1.needProjectId)(options);
34
+ logger_1.logger.info(`Active Project: ${clc.bold(projectId)}`);
35
+ if (options.app) {
36
+ return { projectId, appId: options.app };
37
+ }
38
+ const app = await chooseApp(projectId, await listAppsOrThrow(projectId), options, message);
39
+ return { projectId, appId: app.appId };
40
+ }
41
+ exports.getOrPromptProjectAndAppId = getOrPromptAppId;
42
+ async function getOrPromptApp(options, message) {
43
+ const projectId = (0, projectUtils_1.needProjectId)(options);
44
+ logger_1.logger.info(`Active Project: ${clc.bold(projectId)}`);
45
+ const apps = await listAppsOrThrow(projectId);
46
+ if (options.app) {
47
+ const app = apps.find((a) => a.appId === options.app);
48
+ if (!app) {
49
+ throw new error_1.FirebaseError(`App ${options.app} was not found in project ${projectId}.`);
50
+ }
51
+ return { projectId, appId: app.appId, platform: app.platform };
52
+ }
53
+ const app = await chooseApp(projectId, apps, options, message);
54
+ return { projectId, appId: app.appId, platform: app.platform };
55
+ }
@@ -0,0 +1,73 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.command = void 0;
4
+ const clc = require("colorette");
5
+ const command_1 = require("../command");
6
+ const projectUtils_1 = require("../projectUtils");
7
+ const requireAuth_1 = require("../requireAuth");
8
+ const requirePermissions_1 = require("../requirePermissions");
9
+ const logger_1 = require("../logger");
10
+ const api_1 = require("../appcheck/api");
11
+ const providers_1 = require("../appcheck/providers");
12
+ const appcheck_prompts_1 = require("./appcheck-prompts");
13
+ function detailLines(provider, config) {
14
+ switch (provider) {
15
+ case "device-check":
16
+ return [
17
+ `Key id: ${config.keyId ?? "not set"}`,
18
+ `Private key: ${config.privateKeySet ? "set" : "not set"}`,
19
+ ];
20
+ case "recaptcha-enterprise":
21
+ return [
22
+ `Site key: ${config.siteKey ?? "not set"}`,
23
+ `Min score: ${config.riskAnalysis?.minValidScore ?? "default"}`,
24
+ ];
25
+ case "recaptcha-v3":
26
+ return [
27
+ `Site secret: ${config.siteSecretSet ? "set" : "not set"}`,
28
+ `Min score: ${config.minValidScore ?? "default"}`,
29
+ ];
30
+ case "play-integrity":
31
+ return [
32
+ `Min device: ${config.deviceIntegrity?.minDeviceRecognitionLevel ?? "default"}`,
33
+ `Licensed: ${config.accountDetails?.requireLicensed ? "required" : "not required"}`,
34
+ `Unrecognized: ${config.appIntegrity?.allowUnrecognizedVersion ? "allowed" : "not allowed"}`,
35
+ ];
36
+ default:
37
+ return [];
38
+ }
39
+ }
40
+ exports.command = new command_1.Command("appcheck:providers:get <provider>")
41
+ .description("show one App Check attestation provider for an app")
42
+ .help(`shows the App Check settings for one attestation provider on one app.
43
+
44
+ <provider> is one of:
45
+
46
+ ${(0, providers_1.providerHelp)()}
47
+
48
+ For example:
49
+
50
+ \`firebase appcheck:providers:get recaptcha-enterprise --app 1:1234567890:web:abc123\``)
51
+ .option("--app <appId>", "the app id of your Firebase app")
52
+ .before(requireAuth_1.requireAuth)
53
+ .before(requirePermissions_1.requirePermissions, [
54
+ "firebaseappcheck.appAttestConfig.get",
55
+ "firebaseappcheck.deviceCheckConfig.get",
56
+ "firebaseappcheck.playIntegrityConfig.get",
57
+ "firebaseappcheck.recaptchaEnterpriseConfig.get",
58
+ "firebaseappcheck.recaptchaV3Config.get",
59
+ ])
60
+ .action(async (provider, options) => {
61
+ const providerType = (0, providers_1.parseProviderType)(provider);
62
+ const { appId, platform } = await (0, appcheck_prompts_1.getOrPromptApp)(options, `Select the app to read ${providerType} settings for:`);
63
+ const projectNumber = await (0, projectUtils_1.needProjectNumber)(options);
64
+ (0, providers_1.assertProviderSupportsPlatform)(providerType, platform, appId);
65
+ const config = await (0, api_1.getProviderConfig)(projectNumber, appId, providerType);
66
+ logger_1.logger.info(`Provider: ${clc.bold(providerType)}`);
67
+ logger_1.logger.info(`App: ${appId} (${platform})`);
68
+ for (const line of detailLines(providerType, config)) {
69
+ logger_1.logger.info(line);
70
+ }
71
+ logger_1.logger.info(`Token TTL: ${(0, providers_1.formatTokenTtl)(config.tokenTtl)}`);
72
+ return { ...config, provider: providerType, configured: (0, providers_1.isConfigured)(providerType, config) };
73
+ });
@@ -0,0 +1,67 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.command = void 0;
4
+ const clc = require("colorette");
5
+ const Table = require("cli-table3");
6
+ const command_1 = require("../command");
7
+ const projectUtils_1 = require("../projectUtils");
8
+ const requireAuth_1 = require("../requireAuth");
9
+ const requirePermissions_1 = require("../requirePermissions");
10
+ const logger_1 = require("../logger");
11
+ const utils_1 = require("../utils");
12
+ const api_1 = require("../appcheck/api");
13
+ const providers_1 = require("../appcheck/providers");
14
+ const appcheck_prompts_1 = require("./appcheck-prompts");
15
+ function formatConfigured(configured) {
16
+ if (configured === null) {
17
+ return "n/a";
18
+ }
19
+ return configured ? "Yes" : "No";
20
+ }
21
+ exports.command = new command_1.Command("appcheck:providers:list")
22
+ .description("list App Check attestation providers for an app")
23
+ .help(`shows how one app can prove it is real, and which providers are set up.
24
+
25
+ Only the providers that work on the app's platform are shown:
26
+
27
+ ${(0, providers_1.providerHelp)()}
28
+
29
+ App Attest and Play Integrity have no key or secret to register, so the API cannot say whether an app really uses them. Those show as "n/a" in the Configured column.
30
+
31
+ reCAPTCHA now works on iOS and Android as well as web, through the reCAPTCHA attestation provider added to the mobile SDKs in June 2026. It uses the same reCAPTCHA Enterprise settings as the web provider, so configure it with \`recaptcha-enterprise\`. That provider is in public preview on mobile.`)
32
+ .option("--app <appId>", "the app id of your Firebase app")
33
+ .before(requireAuth_1.requireAuth)
34
+ .before(requirePermissions_1.requirePermissions, [
35
+ "firebaseappcheck.appAttestConfig.get",
36
+ "firebaseappcheck.deviceCheckConfig.get",
37
+ "firebaseappcheck.playIntegrityConfig.get",
38
+ "firebaseappcheck.recaptchaEnterpriseConfig.get",
39
+ "firebaseappcheck.recaptchaV3Config.get",
40
+ ])
41
+ .action(async (options) => {
42
+ const { appId, platform } = await (0, appcheck_prompts_1.getOrPromptApp)(options, "Select the app to list App Check providers for:");
43
+ const projectNumber = await (0, projectUtils_1.needProjectNumber)(options);
44
+ const providers = (0, providers_1.providersForPlatform)(platform);
45
+ const configs = await (0, utils_1.promiseWithSpinner)(() => Promise.all(providers.map((p) => (0, api_1.getProviderConfig)(projectNumber, appId, p))), `Reading App Check providers for app ${clc.bold(appId)}`);
46
+ const rows = providers.map((provider, i) => ({
47
+ provider,
48
+ configured: (0, providers_1.isConfigured)(provider, configs[i]),
49
+ tokenTtl: (0, providers_1.formatTokenTtl)(configs[i].tokenTtl),
50
+ settings: (0, providers_1.summarizeConfig)(provider, configs[i]),
51
+ }));
52
+ logger_1.logger.info(`App: ${clc.bold(appId)} (${platform})`);
53
+ const table = new Table({
54
+ head: ["Provider", "Configured", "Token TTL", "Settings"],
55
+ style: { head: ["green"] },
56
+ });
57
+ for (const row of rows) {
58
+ table.push([
59
+ clc.bold(row.provider),
60
+ formatConfigured(row.configured),
61
+ row.tokenTtl,
62
+ row.settings,
63
+ ]);
64
+ }
65
+ logger_1.logger.info(table.toString());
66
+ return rows;
67
+ });