firebase-tools 15.25.0 → 15.26.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 (52) hide show
  1. package/lib/ailogic/templates.js +124 -0
  2. package/lib/api.js +6 -2
  3. package/lib/appcheck/api.js +33 -0
  4. package/lib/appcheck/prompts.js +2 -2
  5. package/lib/appcheck/services.js +135 -0
  6. package/lib/auth.js +33 -15
  7. package/lib/checkValidTargetFilters.js +1 -0
  8. package/lib/command.js +4 -1
  9. package/lib/commands/ailogic-templates-delete.js +53 -0
  10. package/lib/commands/ailogic-templates-get.js +33 -0
  11. package/lib/commands/ailogic-templates-list.js +49 -0
  12. package/lib/commands/ailogic-templates-lock.js +30 -0
  13. package/lib/commands/ailogic-templates-unlock.js +30 -0
  14. package/lib/commands/appcheck-debugtokens-delete.js +1 -1
  15. package/lib/commands/appcheck-debugtokens-list.js +1 -1
  16. package/lib/commands/appcheck-services-get.js +40 -0
  17. package/lib/commands/appcheck-services-list.js +52 -0
  18. package/lib/commands/appcheck-services-set.js +90 -0
  19. package/lib/commands/crashlytics-onboard-web.js +56 -0
  20. package/lib/commands/deploy.js +3 -0
  21. package/lib/commands/firestore-locations.js +3 -1
  22. package/lib/commands/index.js +14 -0
  23. package/lib/commands/login.js +53 -6
  24. package/lib/config.js +1 -0
  25. package/lib/crashlytics/firebasetelemetry.js +36 -0
  26. package/lib/crashlytics/onboarding.js +41 -0
  27. package/lib/crashlytics/sourcemap.js +102 -12
  28. package/lib/deploy/ailogic/index.js +19 -0
  29. package/lib/deploy/ailogic/prepare.js +78 -0
  30. package/lib/deploy/ailogic/release.js +60 -0
  31. package/lib/deploy/functions/build.js +1 -1
  32. package/lib/deploy/functions/functionsDeployHelper.js +18 -12
  33. package/lib/deploy/functions/prepare.js +16 -3
  34. package/lib/deploy/functions/release/executor.js +51 -8
  35. package/lib/deploy/functions/release/fabricator.js +34 -5
  36. package/lib/deploy/index.js +9 -0
  37. package/lib/emulator/controller.js +34 -15
  38. package/lib/emulator/downloadableEmulatorInfo.json +24 -24
  39. package/lib/experiments.js +13 -0
  40. package/lib/extensions/checkProjectBilling.js +3 -73
  41. package/lib/functions/projectConfig.js +98 -12
  42. package/lib/gcp/ailogic.js +70 -1
  43. package/lib/gcp/cloudbilling.js +74 -0
  44. package/lib/gcp/cloudlogging.js +54 -0
  45. package/lib/management/apps.js +1 -2
  46. package/lib/prompt.js +10 -1
  47. package/lib/requirePermissions.js +1 -1
  48. package/lib/serve/functions.js +25 -7
  49. package/lib/tsconfig.compile.tsbuildinfo +1 -1
  50. package/lib/tsconfig.publish.tsbuildinfo +1 -1
  51. package/package.json +1 -1
  52. package/schema/firebase-config.json +132 -0
@@ -0,0 +1,124 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.DEFAULT_PROMPTS_DIR = exports.PROMPT_FILE_EXT = void 0;
4
+ exports.validatePromptFile = validatePromptFile;
5
+ exports.readPromptDirectory = readPromptDirectory;
6
+ exports.planTemplateDeploy = planTemplateDeploy;
7
+ const fs = require("fs");
8
+ const path = require("path");
9
+ const yaml = require("js-yaml");
10
+ const error_1 = require("../error");
11
+ const fsutils = require("../fsutils");
12
+ const ailogic_1 = require("../gcp/ailogic");
13
+ exports.PROMPT_FILE_EXT = ".prompt";
14
+ exports.DEFAULT_PROMPTS_DIR = "prompts";
15
+ const FRONTMATTER_OPEN = /^---[^\S\r\n]*(\r?\n|$)/;
16
+ const FRONTMATTER_CLOSE = /(^|\r?\n)---[^\S\r\n]*(\r?\n|$)/;
17
+ function validatePromptFile(content) {
18
+ if (!content.trim()) {
19
+ return "File is empty.";
20
+ }
21
+ if (!FRONTMATTER_OPEN.test(content)) {
22
+ return null;
23
+ }
24
+ const rest = content.replace(FRONTMATTER_OPEN, "");
25
+ const close = FRONTMATTER_CLOSE.exec(rest);
26
+ if (!close) {
27
+ return "Frontmatter block is not closed (missing terminating '---').";
28
+ }
29
+ const frontmatter = rest.slice(0, close.index);
30
+ try {
31
+ const parsed = yaml.load(frontmatter);
32
+ if (parsed !== undefined &&
33
+ parsed !== null &&
34
+ (typeof parsed !== "object" || Array.isArray(parsed))) {
35
+ return "Frontmatter must be a YAML mapping.";
36
+ }
37
+ }
38
+ catch (err) {
39
+ return `Invalid YAML in frontmatter: ${(0, error_1.getError)(err).message}`;
40
+ }
41
+ return null;
42
+ }
43
+ function readPromptDirectory(dir) {
44
+ const templates = new Map();
45
+ const sourceOfId = new Map();
46
+ const errors = [];
47
+ const walk = (rel) => {
48
+ for (const entry of fs.readdirSync(path.join(dir, rel), { withFileTypes: true })) {
49
+ const file = rel ? `${rel}/${entry.name}` : entry.name;
50
+ const hasPromptExt = entry.name.toLowerCase().endsWith(exports.PROMPT_FILE_EXT);
51
+ if (entry.isDirectory()) {
52
+ if (hasPromptExt) {
53
+ errors.push({ file, error: "Not a file." });
54
+ }
55
+ else {
56
+ walk(file);
57
+ }
58
+ continue;
59
+ }
60
+ if (!hasPromptExt) {
61
+ continue;
62
+ }
63
+ const templateId = file.slice(0, -exports.PROMPT_FILE_EXT.length).replace(/\//g, ".");
64
+ if (!ailogic_1.TEMPLATE_ID_REGEX.test(templateId)) {
65
+ errors.push({
66
+ file,
67
+ error: "File path does not form a valid template id (letters, digits, '.', '_', and '-' only).",
68
+ });
69
+ continue;
70
+ }
71
+ if (templates.has(templateId)) {
72
+ errors.push({
73
+ file,
74
+ error: `Duplicate template id '${templateId}' (also from ${sourceOfId.get(templateId)}).`,
75
+ });
76
+ continue;
77
+ }
78
+ const content = fsutils.readFile(path.join(dir, file));
79
+ const validationError = validatePromptFile(content);
80
+ if (validationError) {
81
+ errors.push({ file, error: validationError });
82
+ }
83
+ else {
84
+ templates.set(templateId, content);
85
+ sourceOfId.set(templateId, file);
86
+ }
87
+ }
88
+ };
89
+ walk("");
90
+ return { templates, errors };
91
+ }
92
+ function planTemplateDeploy(local, remote, prune) {
93
+ const remoteById = new Map(remote.map((t) => [(0, ailogic_1.templateIdFromName)(t.name), t]));
94
+ const plan = {
95
+ creates: [],
96
+ updates: [],
97
+ unchanged: [],
98
+ deletes: [],
99
+ lockedViolations: [],
100
+ };
101
+ for (const [id, content] of local) {
102
+ const existing = remoteById.get(id);
103
+ if (!existing) {
104
+ plan.creates.push(id);
105
+ }
106
+ else if (existing.templateString === content) {
107
+ plan.unchanged.push(id);
108
+ }
109
+ else if (existing.locked) {
110
+ plan.lockedViolations.push(id);
111
+ }
112
+ else {
113
+ plan.updates.push(id);
114
+ }
115
+ }
116
+ if (prune) {
117
+ for (const [id, remoteTemplate] of remoteById) {
118
+ if (!local.has(id)) {
119
+ (remoteTemplate.locked ? plan.lockedViolations : plan.deletes).push(id);
120
+ }
121
+ }
122
+ }
123
+ return plan;
124
+ }
package/lib/api.js CHANGED
@@ -1,7 +1,7 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.firebaseStorageOrigin = exports.storageOrigin = exports.runtimeconfigOrigin = exports.rulesOrigin = exports.resourceManagerOrigin = exports.crashlyticsApiOrigin = exports.messagingApiOrigin = exports.remoteConfigApiOrigin = exports.rtdbMetadataOrigin = exports.rtdbManagementOrigin = exports.realtimeOrigin = exports.extensionsTOSOrigin = exports.extensionsPublisherOrigin = exports.extensionsOrigin = exports.iamOrigin = exports.identityOrigin = exports.hostingOrigin = exports.googleOrigin = exports.pubsubOrigin = exports.cloudTasksOrigin = exports.cloudschedulerOrigin = exports.cloudbuildOrigin = exports.functionsDefaultRegion = exports.runOrigin = exports.functionsV2Origin = exports.functionsOrigin = exports.firestoreOrigin = exports.firestoreOriginOrEmulator = exports.firedataOrigin = exports.firebaseExtensionsRegistryOrigin = exports.firebaseApiOrigin = exports.eventarcOrigin = exports.consoleOrigin = exports.authManagementOrigin = exports.authOrigin = exports.apphostingGitHubAppInstallationURL = exports.apphostingP4SADomain = exports.apphostingOrigin = exports.appDistributionOrigin = exports.appCheckOrigin = exports.artifactRegistryDomain = exports.developerConnectP4SADomain = exports.developerConnectOrigin = exports.containerRegistryDomain = exports.cloudMonitoringOrigin = exports.cloudloggingOrigin = exports.cloudbillingOrigin = exports.clientSecret = exports.clientId = exports.authProxyOrigin = void 0;
4
- exports.developerKnowledgeOrigin = exports.cloudTestingOrigin = exports.appTestingOrigin = exports.aiLogicProxyOrigin = exports.vertexAIOrigin = exports.cloudSQLAdminOrigin = exports.dataConnectLocalConnString = exports.dataconnectP4SADomain = exports.dataconnectOrigin = exports.githubClientSecret = exports.githubClientId = exports.computeOrigin = exports.secretManagerOrigin = exports.githubApiOrigin = exports.githubOrigin = exports.studioApiOrigin = exports.serviceUsageOrigin = exports.cloudRunApiOrigin = exports.hostingApiOrigin = void 0;
3
+ exports.runtimeconfigOrigin = exports.rulesOrigin = exports.resourceManagerOrigin = exports.firebaseTelemetryAdminOrigin = exports.firebaseTelemetryOrigin = exports.crashlyticsApiOrigin = exports.messagingApiOrigin = exports.remoteConfigApiOrigin = exports.rtdbMetadataOrigin = exports.rtdbManagementOrigin = exports.realtimeOrigin = exports.extensionsTOSOrigin = exports.extensionsPublisherOrigin = exports.extensionsOrigin = exports.iamOrigin = exports.identityOrigin = exports.hostingOrigin = exports.googleOrigin = exports.pubsubOrigin = exports.cloudTasksOrigin = exports.cloudschedulerOrigin = exports.cloudbuildOrigin = exports.functionsDefaultRegion = exports.runOrigin = exports.functionsV2Origin = exports.functionsOrigin = exports.firestoreOrigin = exports.firestoreOriginOrEmulator = exports.firedataOrigin = exports.firebaseExtensionsRegistryOrigin = exports.firebaseApiOrigin = exports.eventarcOrigin = exports.consoleOrigin = exports.authManagementOrigin = exports.authOrigin = exports.apphostingGitHubAppInstallationURL = exports.apphostingP4SADomain = exports.apphostingOrigin = exports.appDistributionOrigin = exports.appCheckOrigin = exports.artifactRegistryDomain = exports.developerConnectP4SADomain = exports.developerConnectOrigin = exports.containerRegistryDomain = exports.cloudMonitoringOrigin = exports.cloudloggingOrigin = exports.cloudbillingOrigin = exports.clientSecret = exports.clientId = exports.authProxyOrigin = void 0;
4
+ exports.developerKnowledgeOrigin = exports.cloudTestingOrigin = exports.appTestingOrigin = exports.aiLogicProxyOrigin = exports.vertexAIOrigin = exports.cloudSQLAdminOrigin = exports.dataConnectLocalConnString = exports.dataconnectP4SADomain = exports.dataconnectOrigin = exports.githubClientSecret = exports.githubClientId = exports.computeOrigin = exports.secretManagerOrigin = exports.githubApiOrigin = exports.githubOrigin = exports.studioApiOrigin = exports.serviceUsageOrigin = exports.cloudRunApiOrigin = exports.hostingApiOrigin = exports.firebaseStorageOrigin = exports.storageOrigin = void 0;
5
5
  exports.getScopes = getScopes;
6
6
  exports.setScopes = setScopes;
7
7
  const constants_1 = require("./emulator/constants");
@@ -104,6 +104,10 @@ const messagingApiOrigin = () => utils.envOverride("FIREBASE_MESSAGING_CONFIG_UR
104
104
  exports.messagingApiOrigin = messagingApiOrigin;
105
105
  const crashlyticsApiOrigin = () => utils.envOverride("FIREBASE_CRASHLYTICS_URL", "https://firebasecrashlytics.googleapis.com");
106
106
  exports.crashlyticsApiOrigin = crashlyticsApiOrigin;
107
+ const firebaseTelemetryOrigin = () => utils.envOverride("FIREBASE_TELEMETRY_URL", "https://firebasetelemetry.googleapis.com");
108
+ exports.firebaseTelemetryOrigin = firebaseTelemetryOrigin;
109
+ const firebaseTelemetryAdminOrigin = () => utils.envOverride("FIREBASE_TELEMETRY_ADMIN_URL", "https://firebasetelemetryadmin.googleapis.com");
110
+ exports.firebaseTelemetryAdminOrigin = firebaseTelemetryAdminOrigin;
107
111
  const resourceManagerOrigin = () => utils.envOverride("FIREBASE_RESOURCEMANAGER_URL", "https://cloudresourcemanager.googleapis.com");
108
112
  exports.resourceManagerOrigin = resourceManagerOrigin;
109
113
  const rulesOrigin = () => utils.envOverride("FIREBASE_RULES_URL", "https://firebaserules.googleapis.com");
@@ -4,6 +4,9 @@ exports.client = void 0;
4
4
  exports.createDebugToken = createDebugToken;
5
5
  exports.listDebugTokens = listDebugTokens;
6
6
  exports.deleteDebugToken = deleteDebugToken;
7
+ exports.listServices = listServices;
8
+ exports.getService = getService;
9
+ exports.updateService = updateService;
7
10
  const api_1 = require("../api");
8
11
  const apiv2_1 = require("../apiv2");
9
12
  const API_VERSION = "v1";
@@ -40,3 +43,33 @@ async function listDebugTokens(projectNumber, appId) {
40
43
  async function deleteDebugToken(name) {
41
44
  await exports.client.delete(name);
42
45
  }
46
+ async function listServices(projectNumber) {
47
+ const services = [];
48
+ let pageToken = "";
49
+ do {
50
+ const queryParams = {};
51
+ if (pageToken) {
52
+ queryParams.pageToken = pageToken;
53
+ }
54
+ const res = await exports.client.get(`projects/${projectNumber}/services`, {
55
+ queryParams,
56
+ });
57
+ if (res.body?.services) {
58
+ services.push(...res.body.services);
59
+ }
60
+ pageToken = res.body?.nextPageToken || "";
61
+ } while (pageToken);
62
+ return services;
63
+ }
64
+ async function getService(projectNumber, serviceId) {
65
+ const res = await exports.client.get(`projects/${projectNumber}/services/${serviceId}`);
66
+ return res.body;
67
+ }
68
+ async function updateService(projectNumber, serviceId, update) {
69
+ const updateMask = ["enforcementMode"];
70
+ if (update.replayProtection) {
71
+ updateMask.push("replayProtection");
72
+ }
73
+ const res = await exports.client.patch(`projects/${projectNumber}/services/${serviceId}`, update, { queryParams: { updateMask: updateMask.join(",") } });
74
+ return res.body;
75
+ }
@@ -8,7 +8,7 @@ const appUtils_1 = require("../appUtils");
8
8
  const error_1 = require("../error");
9
9
  const logger_1 = require("../logger");
10
10
  const clc = require("colorette");
11
- async function getOrPromptAppId(options) {
11
+ async function getOrPromptAppId(options, message = "Select the app to register a debug token for:") {
12
12
  const projectId = (0, projectUtils_1.needProjectId)(options);
13
13
  logger_1.logger.info(`Active Project: ${clc.bold(projectId)}`);
14
14
  if (options.app) {
@@ -34,7 +34,7 @@ async function getOrPromptAppId(options) {
34
34
  throw new error_1.FirebaseError(`Project ${projectId} has multiple apps, must specify an app id.`);
35
35
  }
36
36
  const selectedApp = await (0, apps_1.selectAppInteractively)(apps, apps_1.AppPlatform.ANY, {
37
- message: "Select the app to register a debug token for:",
37
+ message,
38
38
  });
39
39
  return { projectId, appId: selectedApp.appId };
40
40
  }
@@ -0,0 +1,135 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.AI_LOGIC_APP_CHECK_DOCS = exports.AI_LOGIC_ENFORCEMENT_DATE = exports.SERVICE_ALIAS_TO_ID = void 0;
4
+ exports.displayNameForServiceId = displayNameForServiceId;
5
+ exports.isMandatoryFrom = isMandatoryFrom;
6
+ exports.serviceAliasHelp = serviceAliasHelp;
7
+ exports.resolveServiceId = resolveServiceId;
8
+ exports.aliasForServiceId = aliasForServiceId;
9
+ exports.isAutoEnforcedService = isAutoEnforcedService;
10
+ exports.parseEnforcementMode = parseEnforcementMode;
11
+ exports.assertReplayProtectionAllowed = assertReplayProtectionAllowed;
12
+ exports.formatEnforcementMode = formatEnforcementMode;
13
+ exports.formatUpdateTime = formatUpdateTime;
14
+ exports.buildServiceRows = buildServiceRows;
15
+ exports.confirmationForModeChange = confirmationForModeChange;
16
+ const error_1 = require("../error");
17
+ exports.SERVICE_ALIAS_TO_ID = {
18
+ auth: "identitytoolkit.googleapis.com",
19
+ firestore: "firestore.googleapis.com",
20
+ database: "firebasedatabase.googleapis.com",
21
+ storage: "firebasestorage.googleapis.com",
22
+ ailogic: "firebaseml.googleapis.com",
23
+ dataconnect: "firebasedataconnect.googleapis.com",
24
+ };
25
+ const SERVICE_ID_TO_ALIAS = Object.fromEntries(Object.entries(exports.SERVICE_ALIAS_TO_ID).map(([alias, id]) => [id, alias]));
26
+ const SERVICE_DISPLAY_NAMES = {
27
+ "identitytoolkit.googleapis.com": "Firebase Authentication",
28
+ "firestore.googleapis.com": "Cloud Firestore",
29
+ "firebasedatabase.googleapis.com": "Firebase Realtime Database",
30
+ "firebasestorage.googleapis.com": "Cloud Storage for Firebase",
31
+ "firebaseml.googleapis.com": "Firebase AI Logic",
32
+ "firebasedataconnect.googleapis.com": "Firebase SQL Connect",
33
+ "maps-backend.googleapis.com": "Maps JavaScript API",
34
+ "places.googleapis.com": "Places API (New)",
35
+ "oauth2.googleapis.com": "Google Identity for iOS",
36
+ };
37
+ function displayNameForServiceId(serviceId) {
38
+ return SERVICE_DISPLAY_NAMES[serviceId] ?? serviceId;
39
+ }
40
+ const OTHER_SUPPORTED_SERVICE_IDS = new Set([
41
+ "maps-backend.googleapis.com",
42
+ "places.googleapis.com",
43
+ "oauth2.googleapis.com",
44
+ ]);
45
+ const AUTO_ENFORCED_SERVICE_IDS = new Set(["firebaseml.googleapis.com"]);
46
+ exports.AI_LOGIC_ENFORCEMENT_DATE = "November 2, 2026";
47
+ exports.AI_LOGIC_APP_CHECK_DOCS = "https://firebase.google.com/docs/ai-logic/app-check";
48
+ function isMandatoryFrom(serviceId) {
49
+ return serviceId === "firebaseml.googleapis.com";
50
+ }
51
+ const ENFORCEMENT_MODES = ["OFF", "UNENFORCED", "ENFORCED"];
52
+ const MODE_RANK = { OFF: 0, UNENFORCED: 1, ENFORCED: 2 };
53
+ function serviceAliasHelp() {
54
+ return Object.entries(exports.SERVICE_ALIAS_TO_ID)
55
+ .map(([alias, id]) => ` ${alias.padEnd(13)} ${displayNameForServiceId(id)}`)
56
+ .join("\n");
57
+ }
58
+ function resolveServiceId(service) {
59
+ const id = exports.SERVICE_ALIAS_TO_ID[service];
60
+ if (id) {
61
+ return id;
62
+ }
63
+ if (SERVICE_ID_TO_ALIAS[service] || OTHER_SUPPORTED_SERVICE_IDS.has(service)) {
64
+ return service;
65
+ }
66
+ throw new error_1.FirebaseError(`Unknown service: ${service}\n\nValid services:\n\n${serviceAliasHelp()}`);
67
+ }
68
+ function aliasForServiceId(serviceId) {
69
+ return SERVICE_ID_TO_ALIAS[serviceId] ?? serviceId;
70
+ }
71
+ function isAutoEnforcedService(serviceId) {
72
+ return AUTO_ENFORCED_SERVICE_IDS.has(serviceId);
73
+ }
74
+ function parseEnforcementMode(mode) {
75
+ const upper = mode.toUpperCase();
76
+ const found = ENFORCEMENT_MODES.find((m) => m === upper);
77
+ if (!found) {
78
+ throw new error_1.FirebaseError(`Unknown mode: ${mode}. Must be one of: ${ENFORCEMENT_MODES.map((m) => m.toLowerCase()).join(", ")}.`);
79
+ }
80
+ return found;
81
+ }
82
+ function assertReplayProtectionAllowed(enforcement, replayProtection) {
83
+ if (MODE_RANK[replayProtection] > MODE_RANK[enforcement]) {
84
+ throw new error_1.FirebaseError(`Replay protection cannot be stronger than enforcement. Set enforcement to ${replayProtection.toLowerCase()} first, or lower the replay protection level.`);
85
+ }
86
+ }
87
+ function formatEnforcementMode(mode) {
88
+ if (!mode) {
89
+ return "Off";
90
+ }
91
+ return mode.charAt(0) + mode.slice(1).toLowerCase();
92
+ }
93
+ function formatUpdateTime(updateTime) {
94
+ if (!updateTime || updateTime.startsWith("1970-01-01")) {
95
+ return "never";
96
+ }
97
+ return updateTime;
98
+ }
99
+ function buildServiceRows(services) {
100
+ const configured = new Map(services.map((s) => [s.name.split("/").pop() ?? "", s]));
101
+ const ids = new Set([...Object.values(exports.SERVICE_ALIAS_TO_ID), ...configured.keys()]);
102
+ return [...ids]
103
+ .map((serviceId) => {
104
+ const service = configured.get(serviceId);
105
+ return {
106
+ alias: aliasForServiceId(serviceId),
107
+ serviceId,
108
+ enforcementMode: service?.enforcementMode ?? null,
109
+ replayProtection: service?.replayProtection ?? null,
110
+ updateTime: service?.updateTime ?? null,
111
+ };
112
+ })
113
+ .sort((a, b) => a.alias.localeCompare(b.alias));
114
+ }
115
+ function confirmationForModeChange(serviceId, alias, current, next) {
116
+ if (next === current) {
117
+ return null;
118
+ }
119
+ if (isAutoEnforcedService(serviceId)) {
120
+ if (next === "ENFORCED") {
121
+ return null;
122
+ }
123
+ return (`${alias} is enforced by default to help protect your project resources and mitigate ` +
124
+ `Gemini API abuse. Turning enforcement ${next.toLowerCase()} leaves it open to abuse.\n\n` +
125
+ `Starting ${exports.AI_LOGIC_ENFORCEMENT_DATE}, Firebase will automatically enforce App Check for ` +
126
+ `all Gemini API requests via Firebase AI Logic, and App Check cannot be un-enforced for AI ` +
127
+ `Logic. Requests to AI Logic without a valid App Check token will be rejected, and users ` +
128
+ `running versions of your app that do not have App Check implemented will experience ` +
129
+ `service disruption.\n\n` +
130
+ `Continue?`);
131
+ }
132
+ return next === "ENFORCED"
133
+ ? `Enforcing App Check for ${alias} will reject requests from clients that do not send a valid App Check token. Clients on old app versions may stop working. Continue?`
134
+ : null;
135
+ }
package/lib/auth.js CHANGED
@@ -13,6 +13,8 @@ exports.setProjectAccount = setProjectAccount;
13
13
  exports.setGlobalDefaultAccount = setGlobalDefaultAccount;
14
14
  exports.loginPrototyper = loginPrototyper;
15
15
  exports.recordCredentials = recordCredentials;
16
+ exports.loginRemotelyStart = loginRemotelyStart;
17
+ exports.loginRemotelyComplete = loginRemotelyComplete;
16
18
  exports.loginGoogle = loginGoogle;
17
19
  exports.loginGithub = loginGithub;
18
20
  exports.findAccountByEmail = findAccountByEmail;
@@ -313,7 +315,7 @@ async function loginPrototyper() {
313
315
  const attestToken = (await authProxyClient.post("/attest", {
314
316
  session_id: sessionId,
315
317
  })).body?.token;
316
- const loginUrl = `${(0, api_1.authProxyOrigin)()}/login?code_challenge=${codeChallenge}&session=${sessionId}&attest=${attestToken}&studio_prototyper=true}`;
318
+ const loginUrl = `${(0, api_1.authProxyOrigin)()}/login?code_challenge=${codeChallenge}&session=${sessionId}&attest=${attestToken}&studio_prototyper=true`;
317
319
  return {
318
320
  uri: loginUrl,
319
321
  sessionId: sessionId.substring(0, 5).toUpperCase(),
@@ -335,7 +337,7 @@ function recordCredentials(creds) {
335
337
  configstore_1.configstore.set("loginScopes", creds.scopes);
336
338
  configstore_1.configstore.delete("session");
337
339
  }
338
- async function loginRemotely() {
340
+ async function loginRemotelyStart() {
339
341
  const authProxyClient = new apiv2.Client({
340
342
  urlPrefix: (0, api_1.authProxyOrigin)(),
341
343
  auth: false,
@@ -347,12 +349,39 @@ async function loginRemotely() {
347
349
  session_id: sessionId,
348
350
  })).body.token;
349
351
  const loginUrl = `${(0, api_1.authProxyOrigin)()}/login?code_challenge=${codeChallenge}&session=${sessionId}&attest=${attestToken}`;
352
+ return {
353
+ sessionId,
354
+ sessionIdPrefix: sessionId.substring(0, 5).toUpperCase(),
355
+ loginUrl,
356
+ codeVerifier,
357
+ };
358
+ }
359
+ async function loginRemotelyComplete(code, codeVerifier) {
360
+ try {
361
+ const tokens = await getTokensFromAuthorizationCode(code, `${(0, api_1.authProxyOrigin)()}/complete`, codeVerifier);
362
+ void (0, track_1.trackGA4)("login", { method: "google_remote" });
363
+ const decoded = jwt.decode(tokens.id_token, { json: true });
364
+ if (!decoded || typeof decoded === "string") {
365
+ throw new error_1.FirebaseError("Invalid ID token received.");
366
+ }
367
+ return {
368
+ user: decoded,
369
+ tokens: tokens,
370
+ scopes: SCOPES,
371
+ };
372
+ }
373
+ catch (e) {
374
+ throw new error_1.FirebaseError("Unable to authenticate using the provided code. Please try again.");
375
+ }
376
+ }
377
+ async function loginRemotely() {
378
+ const { sessionIdPrefix, loginUrl, codeVerifier } = await loginRemotelyStart();
350
379
  logger_1.logger.info();
351
380
  logger_1.logger.info("To sign in to the Firebase CLI:");
352
381
  logger_1.logger.info();
353
382
  logger_1.logger.info("1. Take note of your session ID:");
354
383
  logger_1.logger.info();
355
- logger_1.logger.info(` ${clc.bold(sessionId.substring(0, 5).toUpperCase())}`);
384
+ logger_1.logger.info(` ${clc.bold(sessionIdPrefix)}`);
356
385
  logger_1.logger.info();
357
386
  logger_1.logger.info("2. Visit the URL below on any device and follow the instructions to get your code:");
358
387
  logger_1.logger.info();
@@ -361,18 +390,7 @@ async function loginRemotely() {
361
390
  logger_1.logger.info("3. Paste or enter the authorization code below once you have it:");
362
391
  logger_1.logger.info();
363
392
  const code = await (0, prompt_1.input)({ message: "Enter authorization code:" });
364
- try {
365
- const tokens = await getTokensFromAuthorizationCode(code, `${(0, api_1.authProxyOrigin)()}/complete`, codeVerifier);
366
- void (0, track_1.trackGA4)("login", { method: "google_remote" });
367
- return {
368
- user: jwt.decode(tokens.id_token, { json: true }),
369
- tokens: tokens,
370
- scopes: SCOPES,
371
- };
372
- }
373
- catch (e) {
374
- throw new error_1.FirebaseError("Unable to authenticate using the provided code. Please try again.");
375
- }
393
+ return loginRemotelyComplete(code, codeVerifier);
376
394
  }
377
395
  async function loginWithLocalhostGoogle(port, userHint) {
378
396
  const callbackUrl = getCallbackUrl(port);
@@ -27,6 +27,7 @@ const FILTERABLE_TARGETS = new Set([
27
27
  "database",
28
28
  "dataconnect",
29
29
  "apphosting",
30
+ "ailogic",
30
31
  ]);
31
32
  async function checkValidTargetFilters(options) {
32
33
  const only = !options.only ? [] : options.only.split(",");
package/lib/command.js CHANGED
@@ -20,6 +20,7 @@ const requireAuth_1 = require("./requireAuth");
20
20
  const env_1 = require("./env");
21
21
  const experiments = require("./experiments");
22
22
  const warnings_1 = require("./extensions/warnings");
23
+ const prompt_1 = require("./prompt");
23
24
  function isCommandModule(value) {
24
25
  return typeof value === "function" && typeof value.load === "function";
25
26
  }
@@ -160,12 +161,14 @@ class Command {
160
161
  options.project = (0, utils_1.getInheritedOption)(options, "project");
161
162
  if (!process.stdin.isTTY ||
162
163
  (0, utils_1.getInheritedOption)(options, "nonInteractive") ||
163
- (0, utils_1.getInheritedOption)(options, "json")) {
164
+ (0, utils_1.getInheritedOption)(options, "json") ||
165
+ (0, env_1.detectAIAgent)() !== "unknown") {
164
166
  options.nonInteractive = true;
165
167
  }
166
168
  if ((0, utils_1.getInheritedOption)(options, "interactive")) {
167
169
  options.nonInteractive = false;
168
170
  }
171
+ (0, prompt_1.setNonInteractive)(!!options.nonInteractive);
169
172
  if ((0, utils_1.getInheritedOption)(options, "debug")) {
170
173
  options.debug = true;
171
174
  }
@@ -0,0 +1,53 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.command = void 0;
4
+ const command_1 = require("../command");
5
+ const requirePermissions_1 = require("../requirePermissions");
6
+ const projectUtils_1 = require("../projectUtils");
7
+ const ailogic = require("../gcp/ailogic");
8
+ const clc = require("colorette");
9
+ const utils = require("../utils");
10
+ const prompt_1 = require("../prompt");
11
+ const error_1 = require("../error");
12
+ exports.command = new command_1.Command("ailogic:templates:delete <templateId>")
13
+ .description("delete a template")
14
+ .help(`deletes one deployed server prompt template after confirmation (skippable with --force).
15
+
16
+ <templateId> is the template's id, as shown in \`ailogic:templates:list\`. A locked template cannot be deleted; unlock it first with \`ailogic:templates:unlock\` (--force does not override a lock).
17
+
18
+ For example:
19
+
20
+ \`firebase ailogic:templates:delete my-template --force\``)
21
+ .option("-f, --force", "bypass confirmation prompt")
22
+ .before(requirePermissions_1.requirePermissions, [
23
+ "firebasevertexai.templates.delete",
24
+ "serviceusage.services.get",
25
+ ])
26
+ .action(async (templateId, options) => {
27
+ const projectId = (0, projectUtils_1.needProjectId)(options);
28
+ ailogic.assertValidTemplateId(templateId);
29
+ await ailogic.ensureAILogicApiEnabled(projectId, options);
30
+ const template = await ailogic.withTemplate404(templateId, () => ailogic.getTemplate(projectId, templateId));
31
+ if (template.locked) {
32
+ throw new error_1.FirebaseError(`The following templates are locked and cannot be deleted:\n\n ${templateId}\n\nUnlock them by running:\n\n firebase ailogic:templates:unlock <templateId>`);
33
+ }
34
+ const confirmed = await (0, prompt_1.confirm)({
35
+ message: `Are you sure you want to delete template ${clc.bold(templateId)}?`,
36
+ force: options.force,
37
+ nonInteractive: options.nonInteractive,
38
+ });
39
+ if (!confirmed) {
40
+ throw new error_1.FirebaseError("Command aborted.", { exit: 1 });
41
+ }
42
+ try {
43
+ await ailogic.withTemplate404(templateId, () => ailogic.deleteTemplate(projectId, templateId, template.etag));
44
+ }
45
+ catch (err) {
46
+ if ((0, error_1.getErrStatus)(err) === 409) {
47
+ throw new error_1.FirebaseError(`Template ${clc.bold(templateId)} was modified while awaiting confirmation. Re-run the command to delete its latest version.`);
48
+ }
49
+ throw err;
50
+ }
51
+ utils.logSuccess(`Deleted template: ${clc.bold(templateId)}`);
52
+ return template;
53
+ });
@@ -0,0 +1,33 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.command = void 0;
4
+ const command_1 = require("../command");
5
+ const requirePermissions_1 = require("../requirePermissions");
6
+ const projectUtils_1 = require("../projectUtils");
7
+ const ailogic = require("../gcp/ailogic");
8
+ const templates_1 = require("../ailogic/templates");
9
+ const logger_1 = require("../logger");
10
+ exports.command = new command_1.Command("ailogic:templates:get <templateId>")
11
+ .description("print one template")
12
+ .help(`prints the full content of one deployed server prompt template.
13
+
14
+ <templateId> is the template's id, as shown in the first column of \`ailogic:templates:list\` (for templates deployed from files, the file path without the ${templates_1.PROMPT_FILE_EXT} extension, with '/' as '.').
15
+
16
+ For example:
17
+
18
+ \`firebase ailogic:templates:get my-template\``)
19
+ .before(requirePermissions_1.requirePermissions, [
20
+ "firebasevertexai.templates.get",
21
+ "serviceusage.services.get",
22
+ ])
23
+ .action(async (templateId, options) => {
24
+ const projectId = (0, projectUtils_1.needProjectId)(options);
25
+ ailogic.assertValidTemplateId(templateId);
26
+ if (!(await ailogic.isAILogicApiEnabled(projectId))) {
27
+ logger_1.logger.info("Firebase AI Logic is not enabled on this project.");
28
+ return;
29
+ }
30
+ const template = await ailogic.withTemplate404(templateId, () => ailogic.getTemplate(projectId, templateId));
31
+ logger_1.logger.info(template.templateString);
32
+ return template;
33
+ });
@@ -0,0 +1,49 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.command = void 0;
4
+ const command_1 = require("../command");
5
+ const requirePermissions_1 = require("../requirePermissions");
6
+ const projectUtils_1 = require("../projectUtils");
7
+ const ailogic = require("../gcp/ailogic");
8
+ const clc = require("colorette");
9
+ const logger_1 = require("../logger");
10
+ const Table = require("cli-table3");
11
+ const PREVIEW_LENGTH = 60;
12
+ const ELLIPSIS = "...";
13
+ exports.command = new command_1.Command("ailogic:templates:list")
14
+ .description("list deployed templates")
15
+ .help(`lists every deployed server prompt template with its id, display name, lock state, and a preview of its content. Use \`ailogic:templates:get <templateId>\` to print a template in full.`)
16
+ .before(requirePermissions_1.requirePermissions, [
17
+ "firebasevertexai.templates.get",
18
+ "serviceusage.services.get",
19
+ ])
20
+ .action(async (options) => {
21
+ const projectId = (0, projectUtils_1.needProjectId)(options);
22
+ if (!(await ailogic.isAILogicApiEnabled(projectId))) {
23
+ logger_1.logger.info("Firebase AI Logic is not enabled on this project.");
24
+ return [];
25
+ }
26
+ const templates = await ailogic.listTemplates(projectId);
27
+ if (templates.length === 0) {
28
+ logger_1.logger.info(clc.bold("No deployed templates found."));
29
+ return templates;
30
+ }
31
+ const table = new Table({
32
+ head: ["Template ID", "Display Name", "Locked", "Template Preview"],
33
+ style: { head: ["green"] },
34
+ });
35
+ for (const t of templates) {
36
+ const templateString = t.templateString ?? "";
37
+ const preview = templateString.length > PREVIEW_LENGTH
38
+ ? templateString.substring(0, PREVIEW_LENGTH - ELLIPSIS.length) + ELLIPSIS
39
+ : templateString;
40
+ table.push([
41
+ clc.bold(ailogic.templateIdFromName(t.name)),
42
+ t.displayName || "",
43
+ t.locked ? "Yes" : "No",
44
+ preview.replace(/\r?\n/g, " "),
45
+ ]);
46
+ }
47
+ logger_1.logger.info(table.toString());
48
+ return templates;
49
+ });
@@ -0,0 +1,30 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.command = void 0;
4
+ const command_1 = require("../command");
5
+ const requirePermissions_1 = require("../requirePermissions");
6
+ const projectUtils_1 = require("../projectUtils");
7
+ const ailogic = require("../gcp/ailogic");
8
+ const clc = require("colorette");
9
+ const utils = require("../utils");
10
+ exports.command = new command_1.Command("ailogic:templates:lock <templateId>")
11
+ .description("lock a template")
12
+ .help(`locks one deployed server prompt template. A locked template cannot be updated or deleted (including by \`firebase deploy\`) until it is unlocked with \`ailogic:templates:unlock\`.
13
+
14
+ <templateId> is the template's id, as shown in \`ailogic:templates:list\`.
15
+
16
+ For example:
17
+
18
+ \`firebase ailogic:templates:lock my-template\``)
19
+ .before(requirePermissions_1.requirePermissions, [
20
+ "firebasevertexai.templates.update",
21
+ "serviceusage.services.get",
22
+ ])
23
+ .action(async (templateId, options) => {
24
+ const projectId = (0, projectUtils_1.needProjectId)(options);
25
+ ailogic.assertValidTemplateId(templateId);
26
+ await ailogic.ensureAILogicApiEnabled(projectId, options);
27
+ await ailogic.withTemplate404(templateId, () => ailogic.setTemplateLocked(projectId, templateId, true));
28
+ utils.logSuccess(`Locked template: ${clc.bold(templateId)}`);
29
+ return { templateId, locked: true };
30
+ });