Add user-friendly warning for runtime errors from the GCF API (#8713)

* add warning for any runtime errors from GCF api

* add changelog

* making helper for regex capture

---------

Co-authored-by: Daniel Lee <[email protected]>

Author: colerogers

CHANGELOG.md

@@ -1,3 +1,4 @@
 - Added validation to check if project ID exists during project creation. (#5233)
 - Add `generate_dataconnect_schema`, `dataconnect_generate_operation`, `firebase_consult_assistant` MCP tools. (#8647)
 - `firebase init dataconnect` is now integrated with Gemini in Firebase API to generate Schema based on description. (#8596)
+- Add user-friendly warning for runtime errors from the GCF API. (#8713)

src/gcp/cloudfunctions.ts

@@ -145,13 +145,41 @@ export interface CloudFunction {
 
 export type OutputOnlyFields = "status" | "buildId" | "updateTime" | "versionId";
 
+/**
+ * Returns the captured user-friendly message from a runtime validation error.
+ * @param errMessage Message from the runtime validation error.
+ */
+export function captureRuntimeValidationError(errMessage: string): string {
+  // Regex to capture the content of the 'message' field.
+  // The error messages will take this form:
+  //    `Failed to create 1st Gen function projects/p/locations/l/functions/f:
+  //     runtime: Runtime validation errors: [error_code: INVALID_RUNTIME\n
+  //     message: \"Runtime \\\"nodejs22\\\" is not supported on GCF Gen1\"\n]`
+  const regex = /message: "((?:\\.|[^"\\])*)"/;
+  const match = errMessage.match(regex);
+  if (match && match[1]) {
+    // The captured string may still contain escaped quotes (e.g., \\").
+    // This replaces them with a standard double quote.
+    const capturedMessage = match[1].replace(/\\"/g, '"');
+    return capturedMessage;
+  }
+  return "invalid runtime detected, please see https://cloud.google.com/functions/docs/runtime-support for the latest supported runtimes";
+}
+
 /**
  * Logs an error from a failed function deployment.
  * @param funcName Name of the function that was unsuccessfully deployed.
  * @param type Type of deployment - create, update, or delete.
  * @param err The error returned from the operation.
  */
 function functionsOpLogReject(funcName: string, type: string, err: any): void {
+  // Sniff for runtime validation errors and log a more user-friendly warning.
+  if ((err?.message as string).includes("Runtime validation errors")) {
+    const capturedMessage = captureRuntimeValidationError(err.message);
+    utils.logWarning(
+      clc.bold(clc.yellow("functions:")) + " " + capturedMessage + " for function " + funcName,
+    );
+  }
   if (err?.context?.response?.statusCode === 429) {
     utils.logWarning(
       `${clc.bold(

src/gcp/cloudfunctionsv2.ts

@@ -17,6 +17,7 @@ import {
   HASH_LABEL,
 } from "../functions/constants";
 import { RequireKeys } from "../metaprogramming";
+import { captureRuntimeValidationError } from "./cloudfunctions";
 
 export const API_VERSION = "v2";
 
@@ -250,6 +251,11 @@ export function mebibytes(memory: string): number {
  * @param err The error returned from the operation.
  */
 function functionsOpLogReject(func: InputCloudFunction, type: string, err: any): void {
+  // Sniff for runtime validation errors and log a more user-friendly warning.
+  if (err?.message?.includes("Runtime validation errors")) {
+    const capturedMessage = captureRuntimeValidationError(err.message);
+    utils.logLabeledWarning("functions", capturedMessage + " for function " + func.name);
+  }
   if (err?.message?.includes("maxScale may not exceed")) {
     const maxInstances = func.serviceConfig.maxInstanceCount || DEFAULT_MAX_INSTANCE_COUNT;
     utils.logLabeledWarning(