firebase-tools 14.10.0 → 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/apphosting/backend.js

@@ -162,9 +162,12 @@ async function ensureAppHostingComputeServiceAccount(projectId, serviceAccount)
         if (!(err instanceof error_1.FirebaseError)) {
             throw err;
         }
-        else if (err.status === 403) {
+        if (err.status === 403) {
             throw new error_1.FirebaseError(`Failed to create backend due to missing delegation permissions for ${sa}. Make sure you have the iam.serviceAccounts.actAs permission.`, { original: err });
         }
+        else if (err.status !== 404) {
+            throw new error_1.FirebaseError("Unexpected error occurred while testing for IAM service account permissions", { original: err });
+        }
     }
     await provisionDefaultComputeServiceAccount(projectId);
 }
@@ -232,7 +235,7 @@ async function provisionDefaultComputeServiceAccount(projectId) {
     }
     catch (err) {
         if ((0, error_1.getErrStatus)(err) === 400) {
-            (0, utils_1.logWarning)("Your App Hosting compute service account is still being provisioned in the background; you may continue with the init flow.");
+            (0, utils_1.logWarning)("Your App Hosting compute service account is still being provisioned in the background. If you encounter an error, please try again after a few moments.");
         }
         else {
             throw err;

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/apphosting/prepare.js

@@ -13,15 +13,7 @@ async function default_1(context, options) {
     const projectId = (0, projectUtils_1.needProjectId)(options);
     await (0, apphosting_1.ensureApiEnabled)(options);
     await (0, backend_1.ensureRequiredApisEnabled)(projectId);
-    try {
-        await (0, backend_1.ensureAppHostingComputeServiceAccount)(projectId, "");
-    }
-    catch (err) {
-        if (err.status === 400) {
-            (0, utils_1.logLabeledWarning)("apphosting", "Your App Hosting compute service account is still being provisioned. Please try again in a few moments.");
-        }
-        throw err;
-    }
+    await (0, backend_1.ensureAppHostingComputeServiceAccount)(projectId, "");
     context.backendConfigs = new Map();
     context.backendLocations = new Map();
     context.backendStorageUris = new Map();

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/dataconnect/pgliteServer.js

@@ -44,7 +44,6 @@ BEGIN
 END
 $do$;`;
 const decoder = new node_string_decoder_1.StringDecoder();
-const pgliteDebugLog = fs.createWriteStream("pglite-debug.log");
 class PostgresServer {
     async createPGServer(host = "127.0.0.1", port) {
         const getDb = this.getDb.bind(this);
@@ -244,6 +243,7 @@ class PGliteExtendedQueryPatch {
         this.connection = connection;
         this.isExtendedQuery = false;
         this.eqpErrored = false;
+        this.pgliteDebugLog = fs.createWriteStream("pglite-debug.log");
     }
     filterResponse(message, response) {
         return __asyncGenerator(this, arguments, function* filterResponse_1() {
@@ -254,7 +254,7 @@ class PGliteExtendedQueryPatch {
                 pg_gateway_1.FrontendMessageCode.Close,
             ];
             const decoded = decoder.write(message);
-            pgliteDebugLog.write("Front: " + decoded);
+            this.pgliteDebugLog.write("Front: " + decoded);
             if (pipelineStartMessages.includes(message[0])) {
                 this.isExtendedQuery = true;
             }
@@ -275,10 +275,10 @@ class PGliteExtendedQueryPatch {
                             this.eqpErrored = true;
                         }
                         if (this.isExtendedQuery && bm[0] === pg_gateway_1.BackendMessageCode.ReadyForQuery) {
-                            pgliteDebugLog.write("Filtered: " + decoder.write(bm));
+                            this.pgliteDebugLog.write("Filtered: " + decoder.write(bm));
                             continue;
                         }
-                        pgliteDebugLog.write("Sent: " + decoder.write(bm));
+                        this.pgliteDebugLog.write("Sent: " + decoder.write(bm));
                         yield yield __await(bm);
                     }
                     finally {