firebase-tools 14.10.1 → 14.11.0

package/lib/api.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 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.dynamicLinksKey = exports.dynamicLinksOrigin = exports.consoleOrigin = exports.authManagementOrigin = exports.authOrigin = exports.apphostingGitHubAppInstallationURL = exports.apphostingP4SADomain = exports.apphostingOrigin = exports.appDistributionOrigin = exports.artifactRegistryDomain = exports.developerConnectP4SADomain = exports.developerConnectOrigin = exports.containerRegistryDomain = exports.cloudMonitoringOrigin = exports.cloudloggingOrigin = exports.cloudbillingOrigin = exports.clientSecret = exports.clientId = exports.authProxyOrigin = void 0;
-exports.setScopes = exports.getScopes = exports.cloudAiCompanionOrigin = exports.vertexAIOrigin = exports.cloudSQLAdminOrigin = exports.dataConnectLocalConnString = exports.dataconnectP4SADomain = exports.dataconnectOrigin = exports.githubClientSecret = exports.githubClientId = exports.computeOrigin = exports.secretManagerOrigin = exports.githubApiOrigin = exports.githubOrigin = exports.serviceUsageOrigin = exports.cloudRunApiOrigin = exports.hostingApiOrigin = exports.firebaseStorageOrigin = void 0;
+exports.setScopes = exports.getScopes = exports.appTestingOrigin = exports.cloudAiCompanionOrigin = exports.vertexAIOrigin = exports.cloudSQLAdminOrigin = exports.dataConnectLocalConnString = exports.dataconnectP4SADomain = exports.dataconnectOrigin = exports.githubClientSecret = exports.githubClientId = exports.computeOrigin = exports.secretManagerOrigin = exports.githubApiOrigin = exports.githubOrigin = exports.serviceUsageOrigin = exports.cloudRunApiOrigin = exports.hostingApiOrigin = exports.firebaseStorageOrigin = void 0;
 const constants_1 = require("./emulator/constants");
 const logger_1 = require("./logger");
 const scopes = require("./scopes");
@@ -144,6 +144,8 @@ const vertexAIOrigin = () => utils.envOverride("VERTEX_AI_URL", "https://aiplatf
 exports.vertexAIOrigin = vertexAIOrigin;
 const cloudAiCompanionOrigin = () => utils.envOverride("CLOUD_AI_COMPANION_URL", "https://cloudaicompanion.googleapis.com");
 exports.cloudAiCompanionOrigin = cloudAiCompanionOrigin;
+const appTestingOrigin = () => utils.envOverride("FIREBASE_APP_TESTING_URL", "https://firebaseapptesting.googleapis.com");
+exports.appTestingOrigin = appTestingOrigin;
 function getScopes() {
     return Array.from(commandScopes);
 }

package/lib/apptesting/invokeTests.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pollInvocationStatus = exports.invokeTests = void 0;
+const apiv2_1 = require("../apiv2");
+const api_1 = require("../api");
+const operationPoller = require("../operation-poller");
+const error_1 = require("../error");
+const apiClient = new apiv2_1.Client({ urlPrefix: (0, api_1.appTestingOrigin)(), apiVersion: "v1alpha" });
+async function invokeTests(appId, startUri, testDefs) {
+    const appResource = `projects/${appId.split(":")[1]}/apps/${appId}`;
+    try {
+        const invocationResponse = await apiClient.post(`${appResource}/testInvocations:invokeTestCases`, buildInvokeTestCasesRequest(testDefs));
+        return invocationResponse.body;
+    }
+    catch (err) {
+        throw new error_1.FirebaseError("Test invocation failed", { original: (0, error_1.getError)(err) });
+    }
+}
+exports.invokeTests = invokeTests;
+function buildInvokeTestCasesRequest(testCaseInvocations) {
+    return {
+        resource: {
+            testInvocation: {},
+            testCaseInvocations,
+        },
+    };
+}
+async function pollInvocationStatus(operationName, onPoll, backoff = 30 * 1000) {
+    return operationPoller.pollOperation({
+        pollerName: "App Testing Invocation Poller",
+        apiOrigin: (0, api_1.appTestingOrigin)(),
+        apiVersion: "v1alpha",
+        operationResourceName: operationName,
+        masterTimeout: 30 * 60 * 1000,
+        backoff,
+        maxBackoff: 15 * 1000,
+        onPoll,
+    });
+}
+exports.pollInvocationStatus = pollInvocationStatus;

package/lib/apptesting/parseTestFiles.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTestFiles = void 0;
+const fsutils_1 = require("../fsutils");
+const path_1 = require("path");
+const logger_1 = require("../logger");
+const types_1 = require("./types");
+const utils_1 = require("../utils");
+const error_1 = require("../error");
+function createFilter(pattern) {
+    const regex = pattern ? new RegExp(pattern) : undefined;
+    return (s) => !regex || regex.test(s);
+}
+async function parseTestFiles(dir, targetUri, filePattern, namePattern) {
+    try {
+        new URL(targetUri);
+    }
+    catch (ex) {
+        const errMsg = "Invalid URL" + (targetUri.startsWith("http") ? "" : " (must include protocol)");
+        throw new error_1.FirebaseError(errMsg, { original: (0, error_1.getError)(ex) });
+    }
+    const fileFilterFn = createFilter(filePattern);
+    const nameFilterFn = createFilter(namePattern);
+    async function parseTestFilesRecursive(testDir) {
+        const items = (0, fsutils_1.listFiles)(testDir);
+        const results = [];
+        for (const item of items) {
+            const path = (0, path_1.join)(testDir, item);
+            if ((0, fsutils_1.dirExistsSync)(path)) {
+                results.push(...(await parseTestFilesRecursive(path)));
+            }
+            else if (fileFilterFn(path) && (0, fsutils_1.fileExistsSync)(path)) {
+                try {
+                    const file = await (0, utils_1.readFileFromDirectory)(testDir, item);
+                    const parsedFile = (0, utils_1.wrappedSafeLoad)(file.source);
+                    const tests = parsedFile.tests;
+                    const defaultConfig = parsedFile.defaultConfig;
+                    if (!tests || !tests.length) {
+                        logger_1.logger.info(`No tests found in ${path}. Ignoring.`);
+                        continue;
+                    }
+                    for (const rawTestDef of parsedFile.tests) {
+                        if (!nameFilterFn(rawTestDef.testName))
+                            continue;
+                        const testDef = toTestDef(rawTestDef, targetUri, defaultConfig);
+                        results.push(testDef);
+                    }
+                }
+                catch (ex) {
+                    const errMsg = (0, error_1.getErrMsg)(ex);
+                    const errDetails = errMsg ? `Error details: \n${errMsg}` : "";
+                    logger_1.logger.info(`Unable to parse test file ${path}. Ignoring.${errDetails}`);
+                    continue;
+                }
+            }
+        }
+        return results;
+    }
+    return parseTestFilesRecursive(dir);
+}
+exports.parseTestFiles = parseTestFiles;
+function toTestDef(testDef, targetUri, defaultConfig) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    const steps = (_a = testDef.steps) !== null && _a !== void 0 ? _a : [];
+    const route = (_d = (_c = (_b = testDef.testConfig) === null || _b === void 0 ? void 0 : _b.route) !== null && _c !== void 0 ? _c : defaultConfig === null || defaultConfig === void 0 ? void 0 : defaultConfig.route) !== null && _d !== void 0 ? _d : "";
+    const browsers = (_g = (_f = (_e = testDef.testConfig) === null || _e === void 0 ? void 0 : _e.browsers) !== null && _f !== void 0 ? _f : defaultConfig === null || defaultConfig === void 0 ? void 0 : defaultConfig.browsers) !== null && _g !== void 0 ? _g : [types_1.Browser.CHROME];
+    return {
+        testCase: {
+            startUri: targetUri + route,
+            displayName: testDef.testName,
+            instructions: { steps },
+        },
+        testExecution: browsers.map((browser) => ({ config: { browser } })),
+    };
+}

package/lib/apptesting/types.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompletionReason = exports.Browser = void 0;
+var Browser;
+(function (Browser) {
+    Browser["BROWSER_UNSPECIFIED"] = "BROWSER_UNSPECIFIED";
+    Browser["CHROME"] = "CHROME";
+})(Browser = exports.Browser || (exports.Browser = {}));
+var CompletionReason;
+(function (CompletionReason) {
+    CompletionReason[CompletionReason["COMPLETION_REASON_UNSPECIFIED"] = 0] = "COMPLETION_REASON_UNSPECIFIED";
+    CompletionReason[CompletionReason["MAX_STEPS_REACHED"] = 1] = "MAX_STEPS_REACHED";
+    CompletionReason[CompletionReason["GOAL_FAILED"] = 2] = "GOAL_FAILED";
+    CompletionReason[CompletionReason["NO_ACTIONS_REQUIRED"] = 3] = "NO_ACTIONS_REQUIRED";
+    CompletionReason[CompletionReason["GOAL_INCONCLUSIVE"] = 4] = "GOAL_INCONCLUSIVE";
+    CompletionReason[CompletionReason["TEST_CANCELLED"] = 5] = "TEST_CANCELLED";
+    CompletionReason[CompletionReason["GOAL_SUCCEEDED"] = 6] = "GOAL_SUCCEEDED";
+})(CompletionReason = exports.CompletionReason || (exports.CompletionReason = {}));

package/lib/commands/apptesting-execute.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
+const requireAuth_1 = require("../requireAuth");
+const command_1 = require("../command");
+const requireConfig_1 = require("../requireConfig");
+const logger_1 = require("../logger");
+const clc = require("colorette");
+const parseTestFiles_1 = require("../apptesting/parseTestFiles");
+const ora = require("ora");
+const invokeTests_1 = require("../apptesting/invokeTests");
+const error_1 = require("../error");
+const marked_1 = require("marked");
+const projectUtils_1 = require("../projectUtils");
+const utils_1 = require("../utils");
+const apps_1 = require("../management/apps");
+exports.command = new command_1.Command("apptesting:execute <target>")
+    .description("Run 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("--tests-non-blocking", "Request test execution without waiting for them to complete.")
+    .before(requireAuth_1.requireAuth)
+    .before(requireConfig_1.requireConfig)
+    .action(async (target, options) => {
+    var _a, _b;
+    const projectId = (0, projectUtils_1.needProjectId)(options);
+    const appList = await (0, apps_1.listFirebaseApps)(projectId, apps_1.AppPlatform.WEB);
+    let app = appList.find((a) => a.appId === options.app);
+    if (!app && appList.length === 1) {
+        app = appList[0];
+        logger_1.logger.info(`No app specified, defaulting to ${app.appId}`);
+    }
+    else if (!app) {
+        throw new error_1.FirebaseError("Invalid app id");
+    }
+    const testDir = ((_a = options.config.src.apptesting) === null || _a === void 0 ? void 0 : _a.testDir) || "tests";
+    const tests = await (0, parseTestFiles_1.parseTestFiles)(testDir, target, options.testFilePattern, options.testNamePattern);
+    if (!tests.length) {
+        throw new error_1.FirebaseError("No tests found");
+    }
+    const invokeSpinner = ora("Requesting test execution");
+    invokeSpinner.start();
+    let invocationOperation;
+    try {
+        invocationOperation = await (0, invokeTests_1.invokeTests)(app.appId, target, tests);
+        invokeSpinner.text = "Test execution requested";
+        invokeSpinner.succeed();
+    }
+    catch (ex) {
+        invokeSpinner.fail("Failed to request test execution");
+        throw ex;
+    }
+    logger_1.logger.info(clc.bold(`\n${clc.white("===")} Running ${pluralizeTests(tests.length)}`));
+    const invocationId = (_b = invocationOperation.name) === null || _b === void 0 ? void 0 : _b.split("/").pop();
+    const appWebId = app.webId;
+    const url = (0, utils_1.consoleUrl)(projectId, `/apptesting/app/web:${appWebId}/invocations/${invocationId}`);
+    logger_1.logger.info(await (0, marked_1.marked)(`**Invocation ID:** ${invocationId}`));
+    logger_1.logger.info(await (0, marked_1.marked)(`View progress and results in the [Firebase Console](${url})`));
+    if (options.testsNonBlocking) {
+        logger_1.logger.info("Not waiting for results");
+        return;
+    }
+    if (!invocationOperation.metadata) {
+        throw new error_1.FirebaseError("Invocation details unavailable");
+    }
+    const executionSpinner = ora(getOutput(invocationOperation.metadata));
+    executionSpinner.start();
+    const invocationOp = await (0, invokeTests_1.pollInvocationStatus)(invocationOperation.name, (operation) => {
+        if (!operation.done) {
+            executionSpinner.text = getOutput(operation.metadata);
+        }
+    });
+    const response = invocationOp.resource.testInvocation;
+    executionSpinner.text = `Testing complete\n${getOutput(response)}`;
+    if (response.failedExecutions || response.cancelledExecutions) {
+        executionSpinner.fail();
+        throw new error_1.FirebaseError("Testing complete with errors");
+    }
+    else {
+        executionSpinner.succeed();
+    }
+});
+function pluralizeTests(numTests) {
+    return `${numTests} test${numTests === 1 ? "" : "s"}`;
+}
+function getOutput(invocation) {
+    const output = [];
+    if (invocation.runningExecutions) {
+        output.push(`${pluralizeTests(invocation.runningExecutions)} running (this may take a while)...`);
+    }
+    if (invocation.succeededExecutions) {
+        output.push(`✔ ${pluralizeTests(invocation.succeededExecutions)} passed`);
+    }
+    if (invocation.failedExecutions) {
+        output.push(`✖ ${pluralizeTests(invocation.failedExecutions)} failed`);
+    }
+    if (invocation.cancelledExecutions) {
+        output.push(`⊝ ${pluralizeTests(invocation.cancelledExecutions)} cancelled`);
+    }
+    return output.length ? output.join("\n") : "Tests are starting";
+}

package/lib/commands/index.js

@@ -228,6 +228,10 @@ function load(client) {
     client.target.clear = loadCommand("target-clear");
     client.target.remove = loadCommand("target-remove");
     client.use = loadCommand("use");
+    if (experiments.isEnabled("apptesting")) {
+        client.apptesting = {};
+        client.apptesting.execute = loadCommand("apptesting-execute");
+    }
     const t1 = process.hrtime.bigint();
     const diffMS = (t1 - t0) / BigInt(1e6);
     if (diffMS > 100) {

package/lib/commands/init.js

@@ -99,6 +99,13 @@ if ((0, experiments_1.isEnabled)("genkit")) {
         ...choices.slice(2),
     ];
 }
+if ((0, experiments_1.isEnabled)("apptesting")) {
+    choices.push({
+        value: "apptesting",
+        name: "App Testing: create a smoke test",
+        checked: false,
+    });
+}
 const featureNames = choices.map((choice) => choice.value);
 const HELP = `Interactively configure the current directory as a Firebase project or initialize new features in an already configured Firebase project directory.
 

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

@@ -1,16 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.detectFromPort = exports.detectFromYaml = exports.yamlToBuild = exports.getFunctionDiscoveryTimeout = exports.readFileAsync = void 0;
+exports.detectFromOutputPath = exports.detectFromPort = exports.detectFromYaml = exports.yamlToBuild = exports.getFunctionDiscoveryTimeout = void 0;
 const node_fetch_1 = require("node-fetch");
 const fs = require("fs");
 const path = require("path");
 const yaml = require("yaml");
-const util_1 = require("util");
 const logger_1 = require("../../../../logger");
 const api = require("../../.../../../../api");
 const v1alpha1 = require("./v1alpha1");
 const error_1 = require("../../../../error");
-exports.readFileAsync = (0, util_1.promisify)(fs.readFile);
 const TIMEOUT_OVERRIDE_ENV_VAR = "FUNCTIONS_DISCOVERY_TIMEOUT";
 function getFunctionDiscoveryTimeout() {
     return +(process.env[TIMEOUT_OVERRIDE_ENV_VAR] || 0) * 1000;
@@ -34,7 +32,7 @@ exports.yamlToBuild = yamlToBuild;
 async function detectFromYaml(directory, project, runtime) {
     let text;
     try {
-        text = await exports.readFileAsync(path.join(directory, "functions.yaml"), "utf8");
+        text = await fs.promises.readFile(path.join(directory, "functions.yaml"), "utf8");
     }
     catch (err) {
         if (err.code === "ENOENT") {
@@ -96,3 +94,54 @@ async function detectFromPort(port, project, runtime, initialDelay = 0, timeout
     return yamlToBuild(parsed, project, api.functionsDefaultRegion(), runtime);
 }
 exports.detectFromPort = detectFromPort;
+async function detectFromOutputPath(childProcess, manifestPath, project, runtime, timeout = 10000) {
+    return new Promise((resolve, reject) => {
+        var _a;
+        let stderrBuffer = "";
+        let resolved = false;
+        const discoveryTimeout = getFunctionDiscoveryTimeout() || timeout;
+        const timer = setTimeout(() => {
+            if (!resolved) {
+                resolved = true;
+                reject(new error_1.FirebaseError(`User code failed to load. Cannot determine backend specification. Timeout after ${discoveryTimeout}ms`));
+            }
+        }, discoveryTimeout);
+        (_a = childProcess.stderr) === null || _a === void 0 ? void 0 : _a.on("data", (chunk) => {
+            stderrBuffer += chunk.toString();
+        });
+        childProcess.on("exit", async (code) => {
+            var _a;
+            if (!resolved) {
+                clearTimeout(timer);
+                resolved = true;
+                if (code !== 0 && code !== null) {
+                    const errorMessage = (_a = stderrBuffer.trim()) !== null && _a !== void 0 ? _a : `Discovery process exited with code ${code}`;
+                    reject(new error_1.FirebaseError(`User code failed to load. Cannot determine backend specification.\n${errorMessage}`));
+                }
+                else {
+                    try {
+                        const manifestContent = await fs.promises.readFile(manifestPath, "utf8");
+                        const parsed = yaml.parse(manifestContent);
+                        resolve(yamlToBuild(parsed, project, api.functionsDefaultRegion(), runtime));
+                    }
+                    catch (err) {
+                        if (err.code === "ENOENT") {
+                            reject(new error_1.FirebaseError(`Discovery process completed but no function manifest was found at ${manifestPath}`));
+                        }
+                        else {
+                            reject(new error_1.FirebaseError(`Failed to read or parse manifest file: ${err.message}`));
+                        }
+                    }
+                }
+            }
+        });
+        childProcess.on("error", (err) => {
+            if (!resolved) {
+                clearTimeout(timer);
+                resolved = true;
+                reject(new error_1.FirebaseError(`Discovery process failed: ${err.message}`));
+            }
+        });
+    });
+}
+exports.detectFromOutputPath = detectFromOutputPath;

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

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Delegate = exports.tryCreateDelegate = void 0;
-const util_1 = require("util");
+const os = require("os");
 const fs = require("fs");
 const path = require("path");
 const portfinder = require("portfinder");
@@ -22,7 +22,10 @@ const MIN_FUNCTIONS_SDK_VERSION = "3.20.0";
 const MIN_FUNCTIONS_SDK_VERSION_FOR_EXTENSIONS_FEATURES = "5.1.0";
 async function tryCreateDelegate(context) {
     const packageJsonPath = path.join(context.sourceDir, "package.json");
-    if (!(await (0, util_1.promisify)(fs.exists)(packageJsonPath))) {
+    try {
+        await fs.promises.access(packageJsonPath);
+    }
+    catch (_a) {
         logger_1.logger.debug("Customer code is not Node");
         return undefined;
     }
@@ -93,12 +96,7 @@ class Delegate {
     watch() {
         return Promise.resolve(() => Promise.resolve());
     }
-    serveAdmin(port, config, envs) {
-        var _a, _b;
-        const env = Object.assign(Object.assign({}, envs), { PORT: port, FUNCTIONS_CONTROL_API: "true", HOME: process.env.HOME, PATH: process.env.PATH, NODE_ENV: process.env.NODE_ENV, __FIREBASE_FRAMEWORKS_ENTRY__: process.env.__FIREBASE_FRAMEWORKS_ENTRY__ });
-        if (Object.keys(config || {}).length) {
-            env.CLOUD_RUNTIME_CONFIG = JSON.stringify(config);
-        }
+    findFunctionsBinary() {
         const sourceNodeModulesPath = path.join(this.sourceDir, "node_modules");
         const projectNodeModulesPath = path.join(this.projectDir, "node_modules");
         const sdkPath = require.resolve("firebase-functions", { paths: [this.sourceDir] });
@@ -113,40 +111,56 @@ class Delegate {
             const binPath = path.join(nodeModulesPath, ".bin", "firebase-functions");
             if ((0, fsutils_1.fileExistsSync)(binPath)) {
                 logger_1.logger.debug(`Found firebase-functions binary at '${binPath}'`);
-                const childProcess = spawn(binPath, [this.sourceDir], {
-                    env,
-                    cwd: this.sourceDir,
-                    stdio: ["ignore", "pipe", "pipe"],
-                });
-                (_a = childProcess.stdout) === null || _a === void 0 ? void 0 : _a.on("data", (chunk) => {
-                    logger_1.logger.info(chunk.toString("utf8"));
-                });
-                (_b = childProcess.stderr) === null || _b === void 0 ? void 0 : _b.on("data", (chunk) => {
-                    logger_1.logger.error(chunk.toString("utf8"));
-                });
-                return Promise.resolve(async () => {
-                    const p = new Promise((resolve, reject) => {
-                        childProcess.once("exit", resolve);
-                        childProcess.once("error", reject);
-                    });
-                    try {
-                        await (0, node_fetch_1.default)(`http://localhost:${port}/__/quitquitquit`);
-                    }
-                    catch (e) {
-                        logger_1.logger.debug("Failed to call quitquitquit. This often means the server failed to start", e);
-                    }
-                    setTimeout(() => {
-                        if (!childProcess.killed) {
-                            childProcess.kill("SIGKILL");
-                        }
-                    }, 10000);
-                    return p;
-                });
+                return binPath;
             }
         }
         throw new error_1.FirebaseError("Failed to find location of Firebase Functions SDK. " +
             "Please file a bug on Github (https://github.com/firebase/firebase-tools/).");
     }
+    spawnFunctionsProcess(config, envs) {
+        var _a, _b;
+        const env = Object.assign(Object.assign({}, envs), { FUNCTIONS_CONTROL_API: "true", HOME: process.env.HOME, PATH: process.env.PATH, NODE_ENV: process.env.NODE_ENV, __FIREBASE_FRAMEWORKS_ENTRY__: process.env.__FIREBASE_FRAMEWORKS_ENTRY__ });
+        if (Object.keys(config || {}).length) {
+            env.CLOUD_RUNTIME_CONFIG = JSON.stringify(config);
+        }
+        const binPath = this.findFunctionsBinary();
+        const childProcess = spawn(binPath, [this.sourceDir], {
+            env,
+            cwd: this.sourceDir,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        (_a = childProcess.stdout) === null || _a === void 0 ? void 0 : _a.on("data", (chunk) => {
+            logger_1.logger.info(chunk.toString("utf8"));
+        });
+        (_b = childProcess.stderr) === null || _b === void 0 ? void 0 : _b.on("data", (chunk) => {
+            logger_1.logger.error(chunk.toString("utf8"));
+        });
+        return childProcess;
+    }
+    execAdmin(config, envs, manifestPath) {
+        return this.spawnFunctionsProcess(config, Object.assign(Object.assign({}, envs), { FUNCTIONS_MANIFEST_OUTPUT_PATH: manifestPath }));
+    }
+    serveAdmin(config, envs, port) {
+        const childProcess = this.spawnFunctionsProcess(config, Object.assign(Object.assign({}, envs), { PORT: port }));
+        return Promise.resolve(async () => {
+            const p = new Promise((resolve, reject) => {
+                childProcess.once("exit", resolve);
+                childProcess.once("error", reject);
+            });
+            try {
+                await (0, node_fetch_1.default)(`http://localhost:${port}/__/quitquitquit`);
+            }
+            catch (e) {
+                logger_1.logger.debug("Failed to call quitquitquit. This often means the server failed to start", e);
+            }
+            setTimeout(() => {
+                if (!childProcess.killed) {
+                    childProcess.kill("SIGKILL");
+                }
+            }, 10000);
+            return p;
+        });
+    }
     async discoverBuild(config, env) {
         if (!semver.valid(this.sdkVersion)) {
             logger_1.logger.debug(`Could not parse firebase-functions version '${this.sdkVersion}' into semver. Falling back to parseTriggers.`);
@@ -163,14 +177,30 @@ class Delegate {
         }
         let discovered = await discovery.detectFromYaml(this.sourceDir, this.projectId, this.runtime);
         if (!discovered) {
-            const basePort = 8000 + (0, utils_1.randomInt)(0, 1000);
-            const port = await portfinder.getPortPromise({ port: basePort });
-            const kill = await this.serveAdmin(port.toString(), config, env);
-            try {
-                discovered = await discovery.detectFromPort(port, this.projectId, this.runtime);
+            const discoveryPath = process.env.FIREBASE_FUNCTIONS_DISCOVERY_OUTPUT_PATH;
+            if (!discoveryPath) {
+                const basePort = 8000 + (0, utils_1.randomInt)(0, 1000);
+                const port = await portfinder.getPortPromise({ port: basePort });
+                const kill = await this.serveAdmin(config, env, port.toString());
+                try {
+                    discovered = await discovery.detectFromPort(port, this.projectId, this.runtime);
+                }
+                finally {
+                    await kill();
+                }
+            }
+            else if (discoveryPath === "true") {
+                const tempDir = await fs.promises.mkdtemp(path.join(os.tmpdir(), "firebase-discovery-"));
+                const manifestPath = path.join(tempDir, "functions.yaml");
+                logger_1.logger.debug(`Writing functions discovery manifest to temporary file ${manifestPath}`);
+                const childProcess = this.execAdmin(config, env, manifestPath);
+                discovered = await discovery.detectFromOutputPath(childProcess, manifestPath, this.projectId, this.runtime);
             }
-            finally {
-                await kill();
+            else {
+                const manifestPath = path.join(discoveryPath, "functions.yaml");
+                logger_1.logger.debug(`Writing functions discovery manifest to ${manifestPath}`);
+                const childProcess = this.execAdmin(config, env, manifestPath);
+                discovered = await discovery.detectFromOutputPath(childProcess, manifestPath, this.projectId, this.runtime);
             }
         }
         return discovered;

package/lib/emulator/downloadableEmulatorInfo.json

@@ -54,28 +54,28 @@
     },
     "dataconnect": {
         "darwin": {
-            "version": "2.9.1",
-            "expectedSize": 29307744,
-            "expectedChecksum": "b6c7485c7a25b703610172a5718e372c",
-            "expectedChecksumSHA256": "2442af6068478fad6e202412ed41a9bb4ca663c27286e654042a346e8c7f1557",
-            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-macos-v2.9.1",
-            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.9.1"
+            "version": "2.10.0",
+            "expectedSize": 29332320,
+            "expectedChecksum": "8e1f4303580e91017d449a091f987caa",
+            "expectedChecksumSHA256": "000356e1a93a8eb55ff6ba5e268b5dd4c0638636708e95874a74b859aa977cb3",
+            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-macos-v2.10.0",
+            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.10.0"
         },
         "win32": {
-            "version": "2.9.1",
-            "expectedSize": 29797888,
-            "expectedChecksum": "643ed6d0ef81488dc23f2ef5247d3f6f",
-            "expectedChecksumSHA256": "ffc2723ce25ffedb958b848c71fcda5bf488208e9d2ef4310ac4f41d6533934d",
-            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-windows-v2.9.1",
-            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.9.1.exe"
+            "version": "2.10.0",
+            "expectedSize": 29824000,
+            "expectedChecksum": "ea880276edee4908c4a6def6b1c7e2c1",
+            "expectedChecksumSHA256": "99ab61eba3de0cf14ef4ed5597f54e81ea8383b6782beba4b9b3f884acae4629",
+            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-windows-v2.10.0",
+            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.10.0.exe"
         },
         "linux": {
-            "version": "2.9.1",
-            "expectedSize": 29233336,
-            "expectedChecksum": "4ae414db7c87ebe8da9fe12139203d67",
-            "expectedChecksumSHA256": "777e5ee6661cce1874f8c363d06ca446838b0e98840ec51b9aa8a79af6565db7",
-            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-linux-v2.9.1",
-            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.9.1"
+            "version": "2.10.0",
+            "expectedSize": 29257912,
+            "expectedChecksum": "fa64e70507e70b8d8063ca0993a3b07a",
+            "expectedChecksumSHA256": "76880201ff7204c32cbbaa2c0cbf6a30528486eb1f2948064dcd218bceaab65e",
+            "remoteUrl": "https://storage.googleapis.com/firemat-preview-drop/emulator/dataconnect-emulator-linux-v2.10.0",
+            "downloadPathRelativeToCacheDir": "dataconnect-emulator-2.10.0"
         }
     }
 }

package/lib/emulator/env.js

@@ -69,7 +69,8 @@ function maybeUsePortForwarding(i) {
         }
         const url = `${info.port}-${portForwardingHost}`;
         info.host = url;
-        info.listen = (_a = info.listen) === null || _a === void 0 ? void 0 : _a.map((l) => {
+        info.listen = (_a = info.listen) === null || _a === void 0 ? void 0 : _a.map((listen) => {
+            const l = Object.assign({}, listen);
             l.address = url;
             l.port = 443;
             return l;

package/lib/emulator/hub.js

@@ -11,7 +11,6 @@ const hubExport_1 = require("./hubExport");
 const registry_1 = require("./registry");
 const ExpressBasedEmulator_1 = require("./ExpressBasedEmulator");
 const vsCodeUtils_1 = require("../vsCodeUtils");
-const env_1 = require("./env");
 const pkg = require("../../package.json");
 class EmulatorHub extends ExpressBasedEmulator_1.ExpressBasedEmulator {
     static readLocatorFile(projectId) {
@@ -45,7 +44,7 @@ class EmulatorHub extends ExpressBasedEmulator_1.ExpressBasedEmulator {
     getRunningEmulatorsMapping() {
         const emulators = {};
         for (const info of registry_1.EmulatorRegistry.listRunningWithInfo()) {
-            emulators[info.name] = (0, env_1.maybeUsePortForwarding)(Object.assign({ listen: this.args.listenForEmulator[info.name] }, info));
+            emulators[info.name] = Object.assign({ listen: this.args.listenForEmulator[info.name] }, info);
         }
         return emulators;
     }

package/lib/emulator/tasksEmulator.js

@@ -166,7 +166,7 @@ class TasksEmulator {
             }
             req.body.task.name =
                 (_a = req.body.task.name) !== null && _a !== void 0 ? _a : `/projects/${projectId}/locations/${locationId}/queues/${queueName}/tasks/${Math.floor(Math.random() * Number.MAX_SAFE_INTEGER)}`;
-            req.body.task.httpRequest.body = JSON.parse(atob(req.body.task.httpRequest.body));
+            req.body.task.httpRequest.body = JSON.parse(Buffer.from(req.body.task.httpRequest.body, "base64").toString("utf-8"));
             const task = req.body.task;
             try {
                 this.controller.enqueue(queueKey, task);

package/lib/emulator/ui.js

@@ -12,6 +12,8 @@ const constants_1 = require("./constants");
 const track_1 = require("../track");
 const ExpressBasedEmulator_1 = require("./ExpressBasedEmulator");
 const experiments_1 = require("../experiments");
+const functional_1 = require("../functional");
+const env_1 = require("./env");
 class EmulatorUI extends ExpressBasedEmulator_1.ExpressBasedEmulator {
     constructor(args) {
         super({
@@ -35,7 +37,7 @@ class EmulatorUI extends ExpressBasedEmulator_1.ExpressBasedEmulator {
         const downloadDetails = downloadableEmulators.getDownloadDetails(types_1.Emulators.UI);
         const webDir = path.join(downloadDetails.unzipDir, "client");
         app.get("/api/config", this.jsonHandler(() => {
-            const emulatorInfos = hub.getRunningEmulatorsMapping();
+            const emulatorInfos = (0, functional_1.mapObject)(hub.getRunningEmulatorsMapping(), env_1.maybeUsePortForwarding);
             const json = Object.assign({ projectId, experiments: enabledExperiments !== null && enabledExperiments !== void 0 ? enabledExperiments : [], analytics: emulatorGaSession }, emulatorInfos);
             return Promise.resolve(json);
         }));

package/lib/experiments.js

@@ -105,6 +105,10 @@ exports.ALL_EXPERIMENTS = experiments({
         default: true,
         public: false,
     },
+    apptesting: {
+        shortDescription: "Adds experimental App Testing feature",
+        public: true,
+    },
 });
 function isValidExperiment(name) {
     return Object.keys(exports.ALL_EXPERIMENTS).includes(name);