firebase-tools 15.10.0 → 15.11.0

package/lib/appdistribution/client.js

@@ -298,5 +298,22 @@ class AppDistributionClient {
             throw new error_1.FirebaseError(`Failed to upsert test cases ${(0, error_1.getErrMsg)(err)}`);
         }
     }
+    async getLatestRelease(appName) {
+        try {
+            const response = await this.appDistroV1Client.get(`/${appName}/releases`, {
+                queryParams: {
+                    pageSize: "1",
+                    orderBy: "createTime desc",
+                },
+            });
+            if (!response.body.releases?.length) {
+                return undefined;
+            }
+            return response.body.releases[0];
+        }
+        catch (err) {
+            throw new error_1.FirebaseError(`Failed to get latest release for app ${appName}: ${(0, error_1.getErrMsg)(err)}`);
+        }
+    }
 }
 exports.AppDistributionClient = AppDistributionClient;

package/lib/apphosting/utils.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getEnvironmentName = getEnvironmentName;
 exports.promptForAppHostingYaml = promptForAppHostingYaml;
+exports.getAutoinitEnvVars = getAutoinitEnvVars;
 const error_1 = require("../error");
 const config_1 = require("./config");
 const prompt = require("../prompt");
@@ -36,3 +37,16 @@ async function promptForAppHostingYaml(apphostingFileNameToPathMap, promptMessag
     });
     return fileToExportPath;
 }
+function getAutoinitEnvVars(webappConfig) {
+    if (!webappConfig) {
+        return {};
+    }
+    return {
+        FIREBASE_WEBAPP_CONFIG: JSON.stringify(webappConfig),
+        FIREBASE_CONFIG: JSON.stringify({
+            databaseURL: webappConfig.databaseURL,
+            storageBucket: webappConfig.storageBucket,
+            projectId: webappConfig.projectId,
+        }),
+    };
+}

package/lib/apptesting/parseTestFiles.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseTestFiles = parseTestFiles;
+exports.pluralizeTests = pluralizeTests;
 const fsutils_1 = require("../fsutils");
 const path_1 = require("path");
 const logger_1 = require("../logger");
@@ -27,8 +28,8 @@ async function parseTestFiles(dir, targetUri, filePattern, namePattern) {
         }
         return accumulator;
     }, {});
-    const fileFilterFn = createFilter(filePattern);
-    const nameFilterFn = createFilter(namePattern);
+    const fileFilterFn = createFilter(filePattern, "file pattern");
+    const nameFilterFn = createFilter(namePattern, "test name pattern");
     const filteredInvocations = files
         .filter((file) => fileFilterFn(file.path))
         .flatMap((file) => file.invocations)
@@ -61,33 +62,41 @@ async function parseTestFiles(dir, targetUri, filePattern, namePattern) {
         };
     });
 }
-function createFilter(pattern) {
-    const regex = pattern ? new RegExp(pattern) : undefined;
-    return (s) => !regex || regex.test(s);
+function createFilter(pattern, context) {
+    try {
+        const regex = pattern ? new RegExp(pattern) : undefined;
+        return (s) => !regex || regex.test(s);
+    }
+    catch (ex) {
+        if (ex instanceof SyntaxError) {
+            const errMsg = context ? `Invalid ${context} regex: ${pattern}` : `Invalid regex: ${pattern}`;
+            throw new error_1.FirebaseError(errMsg, { original: (0, error_1.getError)(ex) });
+        }
+        throw ex;
+    }
 }
 async function parseTestFilesRecursive(params) {
     const testDir = params.testDir;
     const targetUri = params.targetUri;
-    const items = (0, fsutils_1.listFiles)(testDir);
+    const filenames = (0, fsutils_1.listFiles)(testDir);
     const results = [];
-    for (const item of items) {
-        const path = (0, path_1.join)(testDir, item);
+    for (const filename of filenames) {
+        const path = (0, path_1.join)(testDir, filename);
         if ((0, fsutils_1.dirExistsSync)(path)) {
             results.push(...(await parseTestFilesRecursive({ testDir: path, targetUri })));
         }
-        else if ((0, fsutils_1.fileExistsSync)(path)) {
+        else if ((0, fsutils_1.fileExistsSync)(path) && (path.endsWith(".yaml") || path.endsWith(".yml"))) {
             try {
-                const file = await (0, utils_1.readFileFromDirectory)(testDir, item);
-                logger_1.logger.debug(`Read the file ${file.source}.`);
+                logger_1.logger.debug(`Reading ${path}.`);
+                const file = await (0, utils_1.readFileFromDirectory)(testDir, filename);
                 const parsedFile = (0, utils_1.wrappedSafeLoad)(file.source);
-                logger_1.logger.debug(`Parsed the file.`);
                 const tests = parsedFile.tests;
-                logger_1.logger.debug(`There are ${tests.length} tests.`);
                 const defaultConfig = parsedFile.defaultConfig;
                 if (!tests || !tests.length) {
                     logger_1.logger.debug(`No tests found in ${path}. Ignoring.`);
                     continue;
                 }
+                logger_1.logger.debug(`File contains ${pluralizeTests(tests.length)}.`);
                 const invocations = [];
                 for (const rawTestDef of tests) {
                     const invocation = toTestCaseInvocation(rawTestDef, targetUri, defaultConfig);
@@ -105,6 +114,9 @@ async function parseTestFilesRecursive(params) {
     }
     return results;
 }
+function pluralizeTests(numTests) {
+    return `${numTests} test${numTests === 1 ? "" : "s"}`;
+}
 function toTestCaseInvocation(testDef, targetUri, defaultConfig) {
     const steps = testDef.steps ?? [];
     const route = testDef.testConfig?.route ?? defaultConfig?.route ?? "";

package/lib/commands/apptesting.js

@@ -3,14 +3,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.command = void 0;
 const requireAuth_1 = require("../requireAuth");
 const command_1 = require("../command");
-const logger_1 = require("../logger");
-const clc = require("colorette");
 const parseTestFiles_1 = require("../apptesting/parseTestFiles");
 const ora = require("ora");
 const error_1 = require("../error");
 const client_1 = require("../appdistribution/client");
 const distribution_1 = require("../appdistribution/distribution");
 const options_parser_util_1 = require("../appdistribution/options-parser-util");
+const utils = require("../utils");
+const fsutils_1 = require("../fsutils");
+const path = require("path");
 const defaultDevices = [
     {
         model: "MediumPhone.arm",
@@ -19,44 +20,62 @@ const defaultDevices = [
         orientation: "portrait",
     },
 ];
-exports.command = new command_1.Command("apptesting:execute <release-binary-file>")
+exports.command = new command_1.Command("apptesting:execute [release-binary-file]")
     .description("Run mobile automated tests written in natural language driven by AI")
     .option("--app <app_id>", "The app id of your Firebase web app. Optional if the project contains exactly one web app.")
     .option("--test-file-pattern <pattern>", "Test file pattern. Only tests contained in files that match this pattern will be executed.")
     .option("--test-name-pattern <pattern>", "Test name pattern. Only tests with names that match this pattern will be executed.")
-    .option("--test-dir <test_dir>", "Directory where tests can be found.")
-    .option("--test-devices <string>", "semicolon-separated list of devices to run automated tests on, in the format 'model=<model-id>,version=<os-version-id>,locale=<locale>,orientation=<orientation>'. Run 'gcloud firebase test android|ios models list' to see available devices. Note: This feature is in beta.")
-    .option("--test-devices-file <string>", "path to file containing a list of semicolon- or newline-separated devices to run automated tests on, in the format 'model=<model-id>,version=<os-version-id>,locale=<locale>,orientation=<orientation>'. Run 'gcloud firebase test android|ios models list' to see available devices. Note: This feature is in beta.")
+    .option("--test-dir <test_dir>", "Directory where tests can be found. Defaults to './tests'.")
+    .option("--test-devices <string>", "Semicolon-separated list of devices to run automated tests on, in the format 'model=<model-id>,version=<os-version-id>,locale=<locale>,orientation=<orientation>'. Run 'gcloud firebase test android|ios models list' to see available devices. Note: This feature is in beta.")
+    .option("--test-devices-file <string>", "Path to file containing a list of semicolon- or newline-separated devices to run automated tests on, in the format 'model=<model-id>,version=<os-version-id>,locale=<locale>,orientation=<orientation>'. Run 'gcloud firebase test android|ios models list' to see available devices. Note: This feature is in beta.")
+    .option("--test-non-blocking", "Run automated tests without waiting for them to complete. Visit the Firebase console for the test results.")
     .before(requireAuth_1.requireAuth)
     .action(async (target, options) => {
     const appName = (0, options_parser_util_1.getAppName)(options);
-    const testDir = options.testDir || "tests";
+    const testDir = path.resolve(options.testDir || "tests");
+    if (!(0, fsutils_1.dirExistsSync)(testDir)) {
+        throw new error_1.FirebaseError(`Tests directory not found: ${testDir}. Use the --test-dir flag to choose a different directory.`);
+    }
     const tests = await (0, parseTestFiles_1.parseTestFiles)(testDir, undefined, options.testFilePattern, options.testNamePattern);
     const testDevices = (0, options_parser_util_1.parseTestDevices)(options.testDevices, options.testDevicesFile);
     if (!tests.length) {
-        throw new error_1.FirebaseError("No tests found");
+        throw new error_1.FirebaseError(`No tests found under test directory ${testDir}`);
     }
+    utils.logBullet(`Found ${(0, parseTestFiles_1.pluralizeTests)(tests.length)} to run under test directory ${testDir}`);
     const invokeSpinner = ora("Requesting test execution");
+    const client = new client_1.AppDistributionClient();
     let releaseTests;
     let release;
     try {
-        const client = new client_1.AppDistributionClient();
-        release = await (0, distribution_1.upload)(client, appName, new distribution_1.Distribution(target));
+        if (target) {
+            release = await (0, distribution_1.upload)(client, appName, new distribution_1.Distribution(target));
+        }
+        else {
+            utils.logBullet("release-binary-file not provided, using the latest App Distribution release.");
+            const latestRelease = await client.getLatestRelease(appName);
+            if (!latestRelease) {
+                throw new error_1.FirebaseError(`No app binary found for ${appName}. Call apptesting:execute with a local app binary file, or upload a release to App Distribution.`);
+            }
+            release = latestRelease;
+            utils.logBullet(`Using release ${release.displayVersion} created at ${release.createTime}`);
+        }
         invokeSpinner.start();
         releaseTests = await invokeTests(client, release.name, tests, !testDevices.length ? defaultDevices : testDevices);
-        invokeSpinner.text = "Test execution requested";
+        invokeSpinner.text = `${(0, parseTestFiles_1.pluralizeTests)(releaseTests.length)} started successfully!`;
         invokeSpinner.succeed();
     }
     catch (ex) {
         invokeSpinner.fail("Failed to request test execution");
         throw ex;
     }
-    logger_1.logger.info(clc.bold(`\n${clc.white("===")} Running ${pluralizeTests(releaseTests.length)}`));
-    logger_1.logger.info(`View progress and results in the Firebase Console:\n${release.firebaseConsoleUri}`);
+    if (options.testNonBlocking) {
+        utils.logBullet(`View progress and results in the Firebase Console:\n${release.firebaseConsoleUri}`);
+    }
+    else {
+        await (0, distribution_1.awaitTestResults)(releaseTests, client);
+        utils.logBullet(`View detailed results in the Firebase Console:\n${release.firebaseConsoleUri}`);
+    }
 });
-function pluralizeTests(numTests) {
-    return `${numTests} test${numTests === 1 ? "" : "s"}`;
-}
 async function invokeTests(client, releaseName, testDefs, devices) {
     try {
         const releaseTests = [];

package/lib/commands/index.js

@@ -33,6 +33,11 @@ function load(client) {
     client.appdistribution.testCases = {};
     client.appdistribution.testCases.export = loadCommand("appdistribution-testcases-export");
     client.appdistribution.testCases.import = loadCommand("appdistribution-testcases-import");
+    client.apptesting = {};
+    client.apptesting.execute = loadCommand("apptesting");
+    if (experiments.isEnabled("apptesting")) {
+        client.apptesting.wata = loadCommand("apptesting-wata");
+    }
     client.apps = {};
     client.apps.create = loadCommand("apps-create");
     client.apps.list = loadCommand("apps-list");
@@ -254,11 +259,6 @@ function load(client) {
     client.target.clear = loadCommand("target-clear");
     client.target.remove = loadCommand("target-remove");
     client.use = loadCommand("use");
-    client.apptesting = {};
-    client.apptesting.execute = loadCommand("apptesting");
-    if (experiments.isEnabled("apptesting")) {
-        client.apptesting.wata = loadCommand("apptesting-wata");
-    }
     const t1 = process.hrtime.bigint();
     const diffMS = (t1 - t0) / BigInt(1e6);
     if (diffMS > 100) {

package/lib/commands/studio-export.js

@@ -8,12 +8,12 @@ const path = require("path");
 const error_1 = require("../error");
 const unzip_1 = require("../unzip");
 const fs = require("fs");
-exports.command = new command_1.Command("studio:export <path>")
+exports.command = new command_1.Command("studio:export [path]")
     .description("Bootstrap Firebase Studio apps for migration to Antigravity. Run on the unzipped folder from the Firebase Studio download, or directly on the downloaded zip file.")
     .option("--no-start-antigravity", "skip starting the Antigravity IDE after migration")
     .action(async (exportPath, options) => {
     if (!exportPath) {
-        throw new error_1.FirebaseError("Must specify a path for migration.", { exit: 1 });
+        throw new error_1.FirebaseError("Must specify the path to the Firebase Studio downloaded zip file or the unzipped folder path.", { exit: 1 });
     }
     let rootPath = path.resolve(exportPath);
     if (fs.existsSync(rootPath) && fs.statSync(rootPath).isFile() && rootPath.endsWith(".zip")) {

package/lib/deploy/apphosting/util.js

@@ -35,7 +35,7 @@ async function createArchive(config, rootDir, targetSubDir) {
         await pipeAsync(archive, fileStream);
     }
     catch (err) {
-        throw new error_1.FirebaseError("Could not read source directory. Remove links and shortcuts and try again.", { original: err, exit: 1 });
+        throw new error_1.FirebaseError(`Could not read source directory. Remove links and shortcuts and try again. Original: ${err}`, { original: err, exit: 1 });
     }
     return tmpFile;
 }

package/lib/deploy/firestore/prepare.js

@@ -52,6 +52,21 @@ async function createDatabase(context, options) {
         }
         edition = upperEdition;
     }
+    let firestoreDataAccessMode;
+    let mongodbCompatibleDataAccessMode;
+    if (firestoreCfg.dataAccessMode) {
+        if (edition !== types.DatabaseEdition.ENTERPRISE) {
+            throw new error_1.FirebaseError("dataAccessMode can only be specified for enterprise edition databases.");
+        }
+        if (firestoreCfg.dataAccessMode === "FIRESTORE_NATIVE") {
+            firestoreDataAccessMode = types.DataAccessMode.ENABLED;
+            mongodbCompatibleDataAccessMode = types.DataAccessMode.DISABLED;
+        }
+        else if (firestoreCfg.dataAccessMode === "MONGODB_COMPATIBLE") {
+            firestoreDataAccessMode = types.DataAccessMode.DISABLED;
+            mongodbCompatibleDataAccessMode = types.DataAccessMode.ENABLED;
+        }
+    }
     const api = new api_2.FirestoreApi();
     try {
         await api.getDatabase(options.projectId, firestoreCfg.database);
@@ -67,6 +82,8 @@ async function createDatabase(context, options) {
                 databaseEdition: edition,
                 deleteProtectionState: types.DatabaseDeleteProtectionState.DISABLED,
                 pointInTimeRecoveryEnablement: types.PointInTimeRecoveryEnablement.DISABLED,
+                firestoreDataAccessMode,
+                mongodbCompatibleDataAccessMode,
             };
             await api.createDatabase(createDatabaseReq);
         }

package/lib/deploy/functions/prepareFunctionsUpload.js

@@ -98,7 +98,7 @@ async function packageSource(projectDir, sourceDir, config, additionalSources, r
         if (err instanceof error_1.FirebaseError) {
             throw err;
         }
-        throw new error_1.FirebaseError("Could not read source directory. Remove links and shortcuts and try again.", {
+        throw new error_1.FirebaseError(`Could not read source directory. Remove links and shortcuts and try again. Original: ${err}`, {
             original: err,
             exit: 1,
         });

package/lib/deploy/functions/runtimes/dart/index.js

@@ -0,0 +1,282 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Delegate = exports.DART_ENTRY_POINT = void 0;
+exports.tryCreateDelegate = tryCreateDelegate;
+const fs = require("fs");
+const path = require("path");
+const util_1 = require("util");
+const spawn = require("cross-spawn");
+const discovery = require("../discovery");
+const supported = require("../supported");
+const logger_1 = require("../../../../logger");
+const error_1 = require("../../../../error");
+const utils_1 = require("../../../../utils");
+const registry_1 = require("../../../../emulator/registry");
+const types_1 = require("../../../../emulator/types");
+async function tryCreateDelegate(context) {
+    const pubspecYamlPath = path.join(context.sourceDir, "pubspec.yaml");
+    if (!(await (0, util_1.promisify)(fs.exists)(pubspecYamlPath))) {
+        logger_1.logger.debug("Customer code is not Dart code.");
+        return;
+    }
+    const runtime = context.runtime ?? supported.latest("dart");
+    if (!supported.isRuntime(runtime)) {
+        throw new error_1.FirebaseError(`Runtime ${runtime} is not a valid Dart runtime`);
+    }
+    if (!supported.runtimeIsLanguage(runtime, "dart")) {
+        throw new error_1.FirebaseError(`Internal error. Trying to construct a dart runtime delegate for runtime ${runtime}`, { exit: 1 });
+    }
+    return Promise.resolve(new Delegate(context.projectId, context.sourceDir, runtime));
+}
+const MIN_DART_SDK_VERSION = "3.8.0";
+exports.DART_ENTRY_POINT = "bin/server.dart";
+class Delegate {
+    constructor(projectId, sourceDir, runtime) {
+        this.projectId = projectId;
+        this.sourceDir = sourceDir;
+        this.runtime = runtime;
+        this.language = "dart";
+        this.bin = "dart";
+        this.entryPoint = exports.DART_ENTRY_POINT;
+        this.buildRunnerProcess = null;
+    }
+    async validate() {
+        const result = spawn.sync(this.bin, ["--version"], {
+            encoding: "utf8",
+            timeout: 10000,
+        });
+        if (result.error) {
+            throw new error_1.FirebaseError(`Could not find a Dart SDK. Make sure the '${this.bin}' command is available on your PATH.`);
+        }
+        const versionOutput = (result.stdout || result.stderr || "").toString();
+        const match = /Dart SDK version:\s*(\d+\.\d+\.\d+)/.exec(versionOutput);
+        if (match) {
+            const installedVersion = match[1];
+            if (installedVersion.localeCompare(MIN_DART_SDK_VERSION, undefined, { numeric: true }) < 0) {
+                throw new error_1.FirebaseError(`Dart SDK version ${installedVersion} is not supported. ` +
+                    `Firebase Functions for Dart requires Dart ${MIN_DART_SDK_VERSION} or later. ` +
+                    `Please upgrade your Dart SDK.`);
+            }
+        }
+        else {
+            logger_1.logger.debug(`Could not parse Dart SDK version from: ${versionOutput}`);
+        }
+        const pubspecYamlPath = path.join(this.sourceDir, "pubspec.yaml");
+        try {
+            await fs.promises.access(pubspecYamlPath, fs.constants.R_OK);
+        }
+        catch (err) {
+            throw new error_1.FirebaseError(`Failed to read pubspec.yaml at ${pubspecYamlPath}: ${err.message}`);
+        }
+        const entryPointPath = path.join(this.sourceDir, this.entryPoint);
+        try {
+            await fs.promises.access(entryPointPath, fs.constants.R_OK);
+        }
+        catch (err) {
+            throw new error_1.FirebaseError(`Could not find entry point at ${entryPointPath}. ` +
+                `Firebase Functions for Dart expects your main function in ${this.entryPoint}.`);
+        }
+        const packageConfigPath = path.join(this.sourceDir, ".dart_tool", "package_config.json");
+        try {
+            await fs.promises.access(packageConfigPath, fs.constants.R_OK);
+        }
+        catch {
+            (0, utils_1.logLabeledBullet)("functions", "running dart pub get...");
+            const pubGetProcess = spawn(this.bin, ["pub", "get"], {
+                cwd: this.sourceDir,
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+            pubGetProcess.stdout?.on("data", (chunk) => {
+                logger_1.logger.debug(`[dart pub get] ${chunk.toString("utf8").trim()}`);
+            });
+            pubGetProcess.stderr?.on("data", (chunk) => {
+                logger_1.logger.debug(`[dart pub get] ${chunk.toString("utf8").trim()}`);
+            });
+            await new Promise((resolve, reject) => {
+                pubGetProcess.on("exit", (code) => {
+                    if (code === 0 || code === null) {
+                        resolve();
+                    }
+                    else {
+                        reject(new error_1.FirebaseError(`dart pub get failed with exit code ${code}. ` +
+                            `Make sure your pubspec.yaml is valid and dependencies are available.`));
+                    }
+                });
+                pubGetProcess.on("error", reject);
+            });
+        }
+    }
+    async build() {
+        if (Delegate.watchModeActive) {
+            return;
+        }
+        (0, utils_1.logLabeledBullet)("functions", "running build_runner...");
+        const buildRunnerProcess = spawn(this.bin, ["run", "build_runner", "build", "--delete-conflicting-outputs"], {
+            cwd: this.sourceDir,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        buildRunnerProcess.stdout?.on("data", (chunk) => {
+            logger_1.logger.debug(`[build_runner] ${chunk.toString("utf8").trim()}`);
+        });
+        buildRunnerProcess.stderr?.on("data", (chunk) => {
+            logger_1.logger.debug(`[build_runner] ${chunk.toString("utf8").trim()}`);
+        });
+        await new Promise((resolve, reject) => {
+            buildRunnerProcess.on("exit", (code) => {
+                if (code === 0 || code === null) {
+                    resolve();
+                }
+                else {
+                    reject(new error_1.FirebaseError(`build_runner failed with exit code ${code}. ` +
+                        `Make sure your Dart project is properly configured.`));
+                }
+            });
+            buildRunnerProcess.on("error", reject);
+        });
+        if (registry_1.EmulatorRegistry.isRunning(types_1.Emulators.FUNCTIONS)) {
+            logger_1.logger.debug("Skipping Dart compilation in emulator mode.");
+            return;
+        }
+        const binDir = path.join(this.sourceDir, "bin");
+        await fs.promises.mkdir(binDir, { recursive: true });
+        (0, utils_1.logLabeledBullet)("functions", "compiling Dart to linux-x64 executable...");
+        const compileProcess = spawn(this.bin, [
+            "compile",
+            "exe",
+            this.entryPoint,
+            "-o",
+            "bin/server",
+            "--target-os=linux",
+            "--target-arch=x64",
+        ], {
+            cwd: this.sourceDir,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        compileProcess.stdout?.on("data", (chunk) => {
+            logger_1.logger.debug(`[dart compile] ${chunk.toString("utf8").trim()}`);
+        });
+        compileProcess.stderr?.on("data", (chunk) => {
+            logger_1.logger.debug(`[dart compile] ${chunk.toString("utf8").trim()}`);
+        });
+        await new Promise((resolve, reject) => {
+            compileProcess.on("exit", (code) => {
+                if (code === 0 || code === null) {
+                    resolve();
+                }
+                else {
+                    reject(new error_1.FirebaseError(`Dart compilation failed with exit code ${code}. ` +
+                        `Make sure your Dart project compiles successfully with: ` +
+                        `dart compile exe ${this.entryPoint} --target-os=linux --target-arch=x64`));
+                }
+            });
+            compileProcess.on("error", reject);
+        });
+        (0, utils_1.logLabeledBullet)("functions", "Dart compilation complete.");
+    }
+    async watch(onRebuild) {
+        Delegate.watchModeActive = true;
+        logger_1.logger.debug("Starting build_runner watch for Dart functions...");
+        const buildRunnerProcess = spawn(this.bin, ["run", "build_runner", "watch", "--delete-conflicting-outputs"], {
+            cwd: this.sourceDir,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        this.buildRunnerProcess = buildRunnerProcess;
+        let initialBuildComplete = false;
+        let resolveInitialBuild;
+        let rejectInitialBuild;
+        const initialBuildPromise = new Promise((resolve, reject) => {
+            resolveInitialBuild = resolve;
+            rejectInitialBuild = reject;
+        });
+        const buildCompletePattern = /Succeeded after|Built with build_runner/;
+        buildRunnerProcess.stdout?.on("data", (chunk) => {
+            const output = chunk.toString("utf8").trim();
+            if (output) {
+                logger_1.logger.debug(`[build_runner] ${output}`);
+                if (buildCompletePattern.test(output)) {
+                    if (!initialBuildComplete) {
+                        initialBuildComplete = true;
+                        logger_1.logger.debug("build_runner initial build completed");
+                        resolveInitialBuild();
+                    }
+                    else if (onRebuild) {
+                        onRebuild();
+                    }
+                }
+            }
+        });
+        buildRunnerProcess.stderr?.on("data", (chunk) => {
+            const output = chunk.toString("utf8").trim();
+            if (output) {
+                logger_1.logger.debug(`[build_runner] ${output}`);
+            }
+        });
+        buildRunnerProcess.on("exit", (code) => {
+            if (code !== 0 && code !== null) {
+                logger_1.logger.debug(`build_runner exited with code ${code}. Initial build failed.`);
+                if (!initialBuildComplete) {
+                    rejectInitialBuild(new error_1.FirebaseError(`build_runner exited with code ${code}. Your Dart functions may not be deployed or emulated correctly.`));
+                }
+            }
+            this.buildRunnerProcess = null;
+        });
+        buildRunnerProcess.on("error", (err) => {
+            logger_1.logger.debug(`Failed to start build_runner: ${err.message}. Your Dart functions may not be deployed or emulated correctly.`);
+            if (!initialBuildComplete) {
+                rejectInitialBuild(err);
+            }
+        });
+        await initialBuildPromise;
+        return async () => {
+            if (this.buildRunnerProcess && !this.buildRunnerProcess.killed) {
+                this.buildRunnerProcess.kill("SIGTERM");
+                this.buildRunnerProcess = null;
+            }
+        };
+    }
+    async discoverBuild(_configValues, envs) {
+        const yamlDir = this.sourceDir;
+        const yamlPath = path.join(yamlDir, "functions.yaml");
+        let discovered = await discovery.detectFromYaml(yamlDir, this.projectId, this.runtime);
+        if (!discovered) {
+            logger_1.logger.debug("functions.yaml not found, running build_runner to generate it...");
+            const buildRunnerProcess = spawn(this.bin, ["run", "build_runner", "build"], {
+                cwd: this.sourceDir,
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+            buildRunnerProcess.stdout?.on("data", (chunk) => {
+                logger_1.logger.debug(`[build_runner] ${chunk.toString("utf8")}`);
+            });
+            buildRunnerProcess.stderr?.on("data", (chunk) => {
+                logger_1.logger.debug(`[build_runner] ${chunk.toString("utf8")}`);
+            });
+            await new Promise((resolve, reject) => {
+                buildRunnerProcess.on("exit", (code) => {
+                    if (code === 0 || code === null) {
+                        resolve();
+                    }
+                    else {
+                        reject(new error_1.FirebaseError(`build_runner failed with exit code ${code}. Make sure your Dart project is properly configured.`));
+                    }
+                });
+                buildRunnerProcess.on("error", reject);
+            });
+            discovered = await discovery.detectFromYaml(yamlDir, this.projectId, this.runtime);
+            if (!discovered) {
+                throw new error_1.FirebaseError(`Could not find functions.yaml at ${yamlPath} after running build_runner. ` +
+                    `Make sure your Dart project is properly configured with firebase_functions.`);
+            }
+        }
+        const isEmulator = envs.FUNCTIONS_EMULATOR === "true";
+        if (!isEmulator) {
+            for (const ep of Object.values(discovered.endpoints)) {
+                if (ep.platform === "gcfv2") {
+                    ep.platform = "run";
+                }
+            }
+        }
+        return discovered;
+    }
+}
+exports.Delegate = Delegate;
+Delegate.watchModeActive = false;

package/lib/deploy/functions/runtimes/index.js

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getRuntimeDelegate = getRuntimeDelegate;
+const dart = require("./dart");
 const node = require("./node");
 const python = require("./python");
 const validate = require("../validate");
 const error_1 = require("../../../error");
 const supported = require("./supported");
-const dart = require("./dart");
 const experiments = require("../../../experiments");
 const factories = [
     node.tryCreateDelegate,

package/lib/deploy/functions/runtimes/supported/index.js

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isRuntime = isRuntime;
 exports.runtimeIsLanguage = runtimeIsLanguage;
+exports.isLanguageRuntime = isLanguageRuntime;
 exports.latest = latest;
 exports.isDecommissioned = isDecommissioned;
 exports.guardVersionSupport = guardVersionSupport;
@@ -29,6 +30,9 @@ function isRuntime(maybe) {
 function runtimeIsLanguage(runtime, language) {
     return runtime.startsWith(language);
 }
+function isLanguageRuntime(runtime, language) {
+    return !!runtime && runtime.startsWith(language);
+}
 function latest(language, runtimes = Object.keys(types_1.RUNTIMES)) {
     const sorted = runtimes
         .filter((s) => runtimeIsLanguage(s, language))