Merge branch 'main' into feat/dart-cloud-run-eventarc

Author: Lyokone

CHANGELOG.md

@@ -1,4 +0,0 @@
-- Add `MCP-Protocol-Version`, `Mcp-Method`, and `Mcp-Name` HTTP headers to `OneMcpServer` requests per the MCP 0728 standard release candidate (https://blog.modelcontextprotocol.io/posts/2026-07-28-release-candidate/ and https://modelcontextprotocol.io/seps/2243-http-standardization).
-- Fixes Storage Emulator to support JSON uploads larger than 100KB without hanging or throwing 413 error (#8355)
-- Add `extdeprecationwarnings` experiment to display phased deprecation notices and guidance across `ext:*` CLI commands.
-- Fixes Data Connect emulator crash when in-flight GraphQL requests are cancelled (#10821)

npm-shrinkwrap.json

@@ -1,6 +1,6 @@
 {
   "name": "firebase-tools",
-  "version": "15.24.0",
+  "version": "15.25.0",
   "description": "Command-Line Interface for Firebase",
   "main": "./lib/index.js",
   "mcpName": "io.github.firebase/firebase-mcp",
@@ -173,7 +173,7 @@
     "undici": "^6.19.0",
     "winston": "^3.0.0",
     "winston-transport": "^4.4.0",
-    "ws": "^7.5.10",
+    "ws": "^8.21.1",
     "yaml": "^2.8.3",
     "zod": "^4.0.0"
   },
@@ -225,7 +225,7 @@
     "@types/triple-beam": "^1.3.0",
     "@types/universal-analytics": "^0.4.5",
     "@types/update-notifier": "^5.1.0",
-    "@types/ws": "^7.2.3",
+    "@types/ws": "^8.18.1",
     "@typescript-eslint/eslint-plugin": "^5.9.0",
     "@typescript-eslint/parser": "^5.9.0",
     "astro": "^2.2.3",

package.json

@@ -32,6 +32,8 @@ export const developerConnectP4SADomain = () =>
 
 export const artifactRegistryDomain = () =>
   utils.envOverride("ARTIFACT_REGISTRY_DOMAIN", "https://artifactregistry.googleapis.com");
+export const appCheckOrigin = () =>
+  utils.envOverride("FIREBASE_APPCHECK_URL", "https://firebaseappcheck.googleapis.com");
 export const appDistributionOrigin = () =>
   utils.envOverride(
     "FIREBASE_APP_DISTRIBUTION_URL",

src/api.ts

@@ -0,0 +1,101 @@
+import { expect } from "chai";
+import * as sinon from "sinon";
+
+import { createDebugToken, listDebugTokens, deleteDebugToken, client } from "./api";
+import { DebugToken } from "./types";
+import { FirebaseError } from "../error";
+
+describe("appcheck", () => {
+  const projectNumber = "123456789";
+  const appId = "1:123456789:web:abc123def456";
+  const parent = `projects/${projectNumber}/apps/${appId}`;
+  const debugTokenId = "debug-token-id-123";
+  const debugTokenName = `${parent}/debugTokens/${debugTokenId}`;
+  const dummyDebugToken: DebugToken = {
+    name: debugTokenName,
+    displayName: "My Debug Token",
+    token: "00000000-0000-0000-0000-000000000000",
+    updateTime: "2023-01-01T00:00:00Z",
+  };
+
+  let sandbox: sinon.SinonSandbox;
+
+  beforeEach(() => {
+    sandbox = sinon.createSandbox();
+  });
+
+  afterEach(() => {
+    sandbox.restore();
+  });
+
+  describe("createDebugToken", () => {
+    it("should resolve with created DebugToken on success", async () => {
+      const postStub = sandbox.stub(client, "post").resolves({ body: dummyDebugToken } as any);
+
+      const result = await createDebugToken(
+        projectNumber,
+        appId,
+        dummyDebugToken.displayName,
+        dummyDebugToken.token,
+      );
+
+      expect(result).to.deep.equal(dummyDebugToken);
+      expect(postStub.calledOnce).to.be.true;
+      expect(postStub.firstCall.args[0]).to.match(/.*debugTokens.*/);
+      expect(postStub.firstCall.args[1]).to.deep.equal({
+        displayName: dummyDebugToken.displayName,
+        token: dummyDebugToken.token,
+      });
+    });
+
+    it("should throw error on failure", async () => {
+      const postStub = sandbox.stub(client, "post").rejects(new FirebaseError("Invalid request"));
+
+      await expect(
+        createDebugToken(projectNumber, appId, dummyDebugToken.displayName, dummyDebugToken.token),
+      ).to.be.rejectedWith(FirebaseError, "Invalid request");
+      expect(postStub.calledOnce).to.be.true;
+    });
+  });
+
+  describe("listDebugTokens", () => {
+    it("should resolve with list of DebugTokens on success", async () => {
+      const getStub = sandbox
+        .stub(client, "get")
+        .resolves({ body: { debugTokens: [dummyDebugToken] } } as any);
+
+      const result = await listDebugTokens(projectNumber, appId);
+      expect(result).to.deep.equal([dummyDebugToken]);
+      expect(getStub.calledOnce).to.be.true;
+      expect(getStub.firstCall.args[0]).to.match(/.*debugTokens.*/);
+    });
+
+    it("should handle pagination", async () => {
+      const secondToken: DebugToken = {
+        ...dummyDebugToken,
+        name: `${parent}/debugTokens/token-2`,
+      };
+      const getStub = sandbox.stub(client, "get");
+      getStub
+        .onFirstCall()
+        .resolves({ body: { debugTokens: [dummyDebugToken], nextPageToken: "page-2" } } as any);
+      getStub.onSecondCall().resolves({ body: { debugTokens: [secondToken] } } as any);
+
+      const result = await listDebugTokens(projectNumber, appId);
+      expect(result).to.deep.equal([dummyDebugToken, secondToken]);
+      expect(getStub.calledTwice).to.be.true;
+      expect(getStub.secondCall.args[0]).to.match(/.*debugTokens.*/);
+      expect(getStub.secondCall.args[1]).to.deep.equal({ queryParams: { pageToken: "page-2" } });
+    });
+  });
+
+  describe("deleteDebugToken", () => {
+    it("should resolve on success", async () => {
+      const deleteStub = sandbox.stub(client, "delete").resolves({ body: {} } as any);
+
+      await expect(deleteDebugToken(debugTokenName)).to.be.eventually.fulfilled;
+      expect(deleteStub.calledOnce).to.be.true;
+      expect(deleteStub.firstCall.args[0]).to.match(/.*debugTokens.*/);
+    });
+  });
+});

src/appcheck/api.spec.ts

@@ -0,0 +1,56 @@
+import { appCheckOrigin } from "../api";
+import { Client } from "../apiv2";
+import { DebugToken, ListDebugTokensResponse } from "./types";
+
+const API_VERSION = "v1";
+
+export const client = new Client({
+  urlPrefix: appCheckOrigin(),
+  auth: true,
+  apiVersion: API_VERSION,
+});
+
+/**
+ * Creates a new DebugToken for the specified app.
+ */
+export async function createDebugToken(
+  projectNumber: string,
+  appId: string,
+  displayName: string,
+  token: string,
+): Promise<DebugToken> {
+  const parent = `projects/${projectNumber}/apps/${appId}`;
+  const res = await client.post<Partial<DebugToken>, DebugToken>(`${parent}/debugTokens`, {
+    displayName,
+    token,
+  });
+  return res.body;
+}
+
+/**
+ * Lists all DebugTokens for the specified app.
+ */
+export async function listDebugTokens(projectNumber: string, appId: string): Promise<DebugToken[]> {
+  const parent = `projects/${projectNumber}/apps/${appId}`;
+  const debugTokens: DebugToken[] = [];
+  let pageToken = "";
+  do {
+    const queryParams: Record<string, string> = {};
+    if (pageToken) {
+      queryParams.pageToken = pageToken;
+    }
+    const res = await client.get<ListDebugTokensResponse>(`${parent}/debugTokens`, { queryParams });
+    if (res.body?.debugTokens) {
+      debugTokens.push(...res.body.debugTokens);
+    }
+    pageToken = res.body?.nextPageToken || "";
+  } while (pageToken);
+  return debugTokens;
+}
+
+/**
+ * Deletes the specified DebugToken.
+ */
+export async function deleteDebugToken(name: string): Promise<void> {
+  await client.delete<void>(name);
+}

src/appcheck/api.ts

@@ -0,0 +1,52 @@
+import { AppPlatform, listFirebaseApps, selectAppInteractively } from "../management/apps";
+import { needProjectId } from "../projectUtils";
+import { detectApps } from "../appUtils";
+import { FirebaseError } from "../error";
+import { logger } from "../logger";
+import * as clc from "colorette";
+import { AppCheckDebugOptions } from "./types";
+
+/**
+ * Gets the appId from options or prompts the user to select an app if multiple exist.
+ * Uses needProjectId(options) to retrieve the active or specified project ID.
+ */
+export async function getOrPromptAppId(
+  options: AppCheckDebugOptions,
+): Promise<{ projectId: string; appId: string }> {
+  const projectId = needProjectId(options);
+
+  logger.info(`Active Project: ${clc.bold(projectId)}`);
+
+  if (options.app) {
+    return { projectId, appId: options.app };
+  }
+
+  const projectDir = options.cwd || process.cwd();
+  let apps = await listFirebaseApps(projectId, AppPlatform.ANY);
+  if (!apps.length) {
+    throw new FirebaseError(`There are no apps associated with project ${projectId}.`);
+  }
+
+  const localApps = await detectApps(projectDir);
+  const localAppIds = localApps.map((a) => a.appId).filter(Boolean) as string[];
+  if (localAppIds.length > 0) {
+    const filteredApps = apps.filter((app) => localAppIds.includes(app.appId));
+    if (filteredApps.length > 0) {
+      apps = filteredApps;
+    }
+  }
+
+  if (apps.length === 1) {
+    return { projectId, appId: apps[0].appId };
+  } else if (options.nonInteractive) {
+    throw new FirebaseError(`Project ${projectId} has multiple apps, must specify an app id.`);
+  }
+
+  const selectedApp = await selectAppInteractively(apps, AppPlatform.ANY, {
+    message: "Select the app to register a debug token for:",
+  });
+
+  return { projectId, appId: selectedApp.appId };
+}
+
+export const getOrPromptProjectAndAppId = getOrPromptAppId;

src/appcheck/prompts.ts

@@ -0,0 +1,18 @@
+import { Options } from "../options";
+
+export interface DebugToken {
+  name: string;
+  displayName: string;
+  token: string;
+  updateTime?: string;
+}
+
+export interface ListDebugTokensResponse {
+  debugTokens?: DebugToken[];
+  nextPageToken?: string;
+}
+
+export interface AppCheckDebugOptions extends Options {
+  app?: string;
+  displayName?: string;
+}