firebase-tools 11.29.1 → 11.30.0

package/lib/emulator/controller.js

@@ -282,15 +282,13 @@ async function startAll(options, showUI = true) {
     if (Array.isArray(hostingConfig) ? hostingConfig.some((it) => it.source) : hostingConfig === null || hostingConfig === void 0 ? void 0 : hostingConfig.source) {
         experiments.assertEnabled("webframeworks", "emulate a web framework");
         const emulators = [];
-        if (experiments.isEnabled("webframeworks")) {
-            for (const e of types_1.ALL_SERVICE_EMULATORS) {
-                if (listenForEmulator[e]) {
-                    emulators.push({
-                        name: e,
-                        host: utils.connectableHostname(listenForEmulator[e][0].address),
-                        port: listenForEmulator[e][0].port,
-                    });
-                }
+        for (const e of types_1.ALL_SERVICE_EMULATORS) {
+            if (listenForEmulator[e]) {
+                emulators.push({
+                    name: e,
+                    host: utils.connectableHostname(listenForEmulator[e][0].address),
+                    port: listenForEmulator[e][0].port,
+                });
             }
         }
         await (0, frameworks_1.prepareFrameworks)(targets, options, options, emulators);

package/lib/emulator/download.js

@@ -5,9 +5,9 @@ const crypto = require("crypto");
 const fs = require("fs-extra");
 const path = require("path");
 const tmp = require("tmp");
-const unzipper = require("unzipper");
 const emulatorLogger_1 = require("./emulatorLogger");
 const error_1 = require("../error");
+const unzip_1 = require("../unzip");
 const downloadableEmulators = require("./downloadableEmulators");
 const downloadUtils = require("../downloadUtils");
 tmp.setGracefulCleanup();
@@ -25,9 +25,8 @@ async function downloadEmulator(name) {
     }
     fs.copySync(tmpfile, emulator.downloadPath);
     if (emulator.unzipDir) {
-        await unzip(emulator.downloadPath, emulator.unzipDir);
+        await (0, unzip_1.unzip)(emulator.downloadPath, emulator.unzipDir);
     }
-    await new Promise((f) => setTimeout(f, 2000));
     const executablePath = emulator.binaryPath || emulator.downloadPath;
     fs.chmodSync(executablePath, 0o755);
     removeOldFiles(name, emulator);
@@ -44,20 +43,12 @@ async function downloadExtensionVersion(extensionVersionRef, sourceDownloadUri,
     }
     emulatorLogger.logLabeled("BULLET", "extensions", `downloading ${sourceDownloadUri}...`);
     const sourceCodeZip = await downloadUtils.downloadToTmp(sourceDownloadUri);
-    await unzip(sourceCodeZip, targetDir);
+    await (0, unzip_1.unzip)(sourceCodeZip, targetDir);
     fs.chmodSync(targetDir, 0o755);
     emulatorLogger.logLabeled("BULLET", "extensions", `Downloaded to ${targetDir}...`);
     await new Promise((resolve) => setTimeout(resolve, 1000));
 }
 exports.downloadExtensionVersion = downloadExtensionVersion;
-function unzip(zipPath, unzipDir) {
-    return new Promise((resolve, reject) => {
-        fs.createReadStream(zipPath)
-            .pipe(unzipper.Extract({ path: unzipDir }))
-            .on("error", reject)
-            .on("close", resolve);
-    });
-}
 function removeOldFiles(name, emulator, removeAllVersions = false) {
     const currentLocalPath = emulator.downloadPath;
     const currentUnzipPath = emulator.unzipDir;

package/lib/emulator/downloadableEmulators.js

@@ -23,9 +23,9 @@ const EMULATOR_UPDATE_DETAILS = {
         expectedChecksum: "311609538bd65666eb724ef47c2e6466",
     },
     firestore: {
-        version: "1.17.3",
-        expectedSize: 64970588,
-        expectedChecksum: "75beb285dc404176b974fec9e3032712",
+        version: "1.17.4",
+        expectedSize: 64969580,
+        expectedChecksum: "9d580b58e55e57b0cdc3ca8888098d43",
     },
     storage: {
         version: "1.1.3",
@@ -35,9 +35,9 @@ const EMULATOR_UPDATE_DETAILS = {
     ui: experiments.isEnabled("emulatoruisnapshot")
         ? { version: "SNAPSHOT", expectedSize: -1, expectedChecksum: "" }
         : {
-            version: "1.11.5",
+            version: "1.11.6",
             expectedSize: 3063444,
-            expectedChecksum: "4045fef65cf71fb9d83b01fb8b160141",
+            expectedChecksum: "14b971f4ed4909f348e647db7114d62b",
         },
     pubsub: {
         version: "0.7.1",

package/lib/emulator/functionsEmulator.js

@@ -367,7 +367,7 @@ class FunctionsEmulator {
                 const signature = (0, functionsEmulatorShared_1.getSignatureType)(definition);
                 switch (service) {
                     case constants_1.Constants.SERVICE_FIRESTORE:
-                        added = await this.addFirestoreTrigger(this.args.projectId, key, definition.eventTrigger);
+                        added = await this.addFirestoreTrigger(this.args.projectId, key, definition.eventTrigger, signature);
                         break;
                     case constants_1.Constants.SERVICE_REALTIME_DATABASE:
                         added = await this.addRealtimeDatabaseTrigger(this.args.projectId, definition.id, key, definition.eventTrigger, signature, definition.region);
@@ -531,17 +531,60 @@ class FunctionsEmulator {
         }
         return true;
     }
-    async addFirestoreTrigger(projectId, key, eventTrigger) {
-        if (!registry_1.EmulatorRegistry.isRunning(types_1.Emulators.FIRESTORE)) {
-            return Promise.resolve(false);
-        }
+    getV1FirestoreAttributes(projectId, key, eventTrigger) {
         const bundle = JSON.stringify({
             eventTrigger: Object.assign(Object.assign({}, eventTrigger), { service: "firestore.googleapis.com" }),
         });
+        const path = `/emulator/v1/projects/${projectId}/triggers/${key}`;
+        return { bundle, path };
+    }
+    getV2FirestoreAttributes(projectId, key, eventTrigger) {
+        var _a, _b, _c, _d, _e, _f;
+        logger_1.logger.debug("Found a v2 firestore trigger.");
+        const database = (_a = eventTrigger.eventFilters) === null || _a === void 0 ? void 0 : _a.database;
+        if (!database) {
+            throw new error_1.FirebaseError("A database must be supplied.");
+        }
+        const namespace = (_b = eventTrigger.eventFilters) === null || _b === void 0 ? void 0 : _b.namespace;
+        if (!namespace) {
+            throw new error_1.FirebaseError("A namespace must be supplied.");
+        }
+        let doc;
+        let match;
+        if ((_c = eventTrigger.eventFilters) === null || _c === void 0 ? void 0 : _c.document) {
+            doc = (_d = eventTrigger.eventFilters) === null || _d === void 0 ? void 0 : _d.document;
+            match = "EXACT";
+        }
+        if ((_e = eventTrigger.eventFilterPathPatterns) === null || _e === void 0 ? void 0 : _e.document) {
+            doc = (_f = eventTrigger.eventFilterPathPatterns) === null || _f === void 0 ? void 0 : _f.document;
+            match = "PATH_PATTERN";
+        }
+        if (!doc) {
+            throw new error_1.FirebaseError("A document must be supplied.");
+        }
+        const bundle = JSON.stringify({
+            eventType: eventTrigger.eventType,
+            database,
+            namespace,
+            document: {
+                value: doc,
+                matchType: match,
+            },
+        });
+        const path = `/emulator/v1/projects/${projectId}/eventarcTrigger?eventarcTriggerId=${key}`;
+        return { bundle, path };
+    }
+    async addFirestoreTrigger(projectId, key, eventTrigger, signature) {
+        if (!registry_1.EmulatorRegistry.isRunning(types_1.Emulators.FIRESTORE)) {
+            return Promise.resolve(false);
+        }
+        const { bundle, path } = signature === "cloudevent"
+            ? this.getV2FirestoreAttributes(projectId, key, eventTrigger)
+            : this.getV1FirestoreAttributes(projectId, key, eventTrigger);
         logger_1.logger.debug(`addFirestoreTrigger`, JSON.stringify(bundle));
         const client = registry_1.EmulatorRegistry.client(types_1.Emulators.FIRESTORE);
         try {
-            await client.put(`/emulator/v1/projects/${projectId}/triggers/${key}`, bundle);
+            signature === "cloudevent" ? await client.post(path, bundle) : await client.put(path, bundle);
         }
         catch (err) {
             this.logger.log("WARN", "Error adding firestore function: " + err);
@@ -915,6 +958,7 @@ class FunctionsEmulator {
         }
     }
     async handleHttpsTrigger(req, res) {
+        var _a;
         const method = req.method;
         let triggerId = req.params.trigger_name;
         if (req.params.region) {
@@ -933,7 +977,13 @@ class FunctionsEmulator {
         }
         const trigger = record.def;
         logger_1.logger.debug(`Accepted request ${method} ${req.url} --> ${triggerId}`);
-        const reqBody = req.rawBody;
+        let reqBody = req.rawBody;
+        if ((0, functionsEmulatorShared_1.getSignatureType)(trigger) === "cloudevent") {
+            if ((_a = req.headers["content-type"]) === null || _a === void 0 ? void 0 : _a.includes("application/protobuf")) {
+                reqBody = Uint8Array.from(atob(reqBody.toString()), (c) => c.charCodeAt(0));
+                req.headers["content-length"] = reqBody.length.toString();
+            }
+        }
         const isCallable = trigger.labels && trigger.labels["deployment-callable"] === "true";
         const authHeader = req.header("Authorization");
         if (authHeader && isCallable && trigger.platform !== "gcfv2") {

package/lib/emulator/functionsEmulatorRuntime.js

@@ -677,12 +677,15 @@ async function main() {
             switch (FUNCTION_SIGNATURE) {
                 case "event":
                 case "cloudevent":
+                    let reqBody;
                     const rawBody = req.rawBody;
-                    let reqBody = JSON.parse(rawBody.toString());
                     if (types_2.EventUtils.isBinaryCloudEvent(req)) {
                         reqBody = types_2.EventUtils.extractBinaryCloudEventContext(req);
                         reqBody.data = req.body;
                     }
+                    else {
+                        reqBody = JSON.parse(rawBody.toString());
+                    }
                     await processBackground(trigger, reqBody, FUNCTION_SIGNATURE);
                     res.send({ status: "acknowledged" });
                     break;

package/lib/emulator/functionsEmulatorShared.js

@@ -19,6 +19,7 @@ const V2_EVENTS = [
     events.v2.PUBSUB_PUBLISH_EVENT,
     ...events.v2.STORAGE_EVENTS,
     ...events.v2.DATABASE_EVENTS,
+    ...events.v2.FIRESTORE_EVENTS,
 ];
 exports.EVENTARC_SOURCE_ENV = "EVENTARC_CLOUD_EVENT_SOURCE";
 class HttpConstants {

package/lib/emulator/functionsRuntimeWorker.js

@@ -110,11 +110,19 @@ class RuntimeWorker {
             }
             const proxy = http.request(reqOpts, (_resp) => {
                 resp.writeHead(_resp.statusCode || 200, _resp.headers);
+                let finished = false;
+                const finishReq = (event) => {
+                    this.logger.log("DEBUG", `Finishing up request with event=${event}`);
+                    if (!finished) {
+                        finished = true;
+                        onFinish();
+                        resolve();
+                    }
+                };
+                _resp.on("pause", () => finishReq("pause"));
+                _resp.on("close", () => finishReq("close"));
                 const piped = _resp.pipe(resp);
-                piped.on("finish", () => {
-                    onFinish();
-                    resolve();
-                });
+                piped.on("finish", () => finishReq("finish"));
             });
             proxy.on("timeout", () => {
                 this.logger.log("ERROR", `Your function timed out after ~${this.timeoutSeconds}s. To configure this timeout, see

package/lib/experiments.js

@@ -3,8 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.flushToDisk = exports.assertEnabled = exports.enableExperimentsFromCliEnvVariable = exports.setEnabled = exports.isEnabled = exports.experimentNameAutocorrect = exports.isValidExperiment = exports.ALL_EXPERIMENTS = void 0;
 const colorette_1 = require("colorette");
 const leven = require("leven");
+const path_1 = require("path");
 const configstore_1 = require("./configstore");
 const error_1 = require("./error");
+const github_1 = require("./init/features/hosting/github");
 function experiments(exp) {
     return Object.freeze(exp);
 }
@@ -25,12 +27,6 @@ exports.ALL_EXPERIMENTS = experiments({
         shortDescription: `Enables the ${(0, colorette_1.bold)("ext:dev")} family of commands`,
         docsUri: "https://firebase.google.com/docs/extensions/alpha/overview-build-extensions",
     },
-    pythonfunctions: {
-        shortDescription: "Python support for Cloud Functions for Firebase",
-        fullDescription: "Adds the ability to initializea and deploy Cloud " +
-            "Functions for Firebase in Python. While this feature is experimental " +
-            "breaking API changes are allowed in MINOR API revisions",
-    },
     deletegcfartifacts: {
         shortDescription: `Add the ${(0, colorette_1.bold)("functions:deletegcfartifacts")} command to purge docker build images`,
         fullDescription: `Add the ${(0, colorette_1.bold)("functions:deletegcfartifacts")}` +
@@ -123,8 +119,25 @@ function enableExperimentsFromCliEnvVariable() {
 }
 exports.enableExperimentsFromCliEnvVariable = enableExperimentsFromCliEnvVariable;
 function assertEnabled(name, task) {
+    var _a;
     if (!isEnabled(name)) {
-        throw new error_1.FirebaseError(`Cannot ${task} because the experiment ${(0, colorette_1.bold)(name)} is not enabled. To enable ${(0, colorette_1.bold)(name)} run ${(0, colorette_1.bold)(`firebase experiments:enable ${name}`)}`);
+        const prefix = `Cannot ${task} because the experiment ${(0, colorette_1.bold)(name)} is not enabled.`;
+        if ((0, github_1.isRunningInGithubAction)()) {
+            const path = (_a = process.env.GITHUB_WORKFLOW_REF) === null || _a === void 0 ? void 0 : _a.split("@")[0];
+            const filename = path ? `.github/workflows/${(0, path_1.basename)(path)}` : "your action's yml";
+            const newValue = [process.env.FIREBASE_CLI_EXPERIMENTS, name].filter((it) => !!it).join(",");
+            throw new error_1.FirebaseError(`${prefix} To enable add a ${(0, colorette_1.bold)("FIREBASE_CLI_EXPERIMENTS")} environment variable to ${filename}, like so: ${(0, colorette_1.italic)(`
+
+- uses: FirebaseExtended/action-hosting-deploy@v0
+  with:
+    ...
+  env:
+    FIREBASE_CLI_EXPERIMENTS: ${newValue}
+`)}`);
+        }
+        else {
+            throw new error_1.FirebaseError(`${prefix} To enable ${(0, colorette_1.bold)(name)} run ${(0, colorette_1.bold)(`firebase experiments:enable ${name}`)}`);
+        }
     }
 }
 exports.assertEnabled = assertEnabled;

package/lib/extensions/extensionsHelper.js

@@ -6,10 +6,10 @@ const ora = require("ora");
 const semver = require("semver");
 const tmp = require("tmp");
 const fs = require("fs-extra");
-const unzipper = require("unzipper");
 const node_fetch_1 = require("node-fetch");
 const path = require("path");
 const marked_1 = require("marked");
+const unzip_1 = require("./../unzip");
 const TerminalRenderer = require("marked-terminal");
 marked_1.marked.setOptions({
     renderer: new TerminalRenderer(),
@@ -449,7 +449,7 @@ async function publishExtensionVersionFromRemoteRepo(args) {
     try {
         const response = await (0, node_fetch_1.default)(archiveUri);
         if (response.ok) {
-            await response.body.pipe(unzipper.Extract({ path: tempDirectory.name })).promise();
+            await response.body.pipe((0, unzip_1.createUnzipTransform)(tempDirectory.name)).promise();
         }
     }
     catch (err) {

package/lib/frameworks/angular/index.js

@@ -1,17 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ɵcodegenFunctionsDirectory = exports.ɵcodegenPublicDirectory = exports.getDevModeHandle = exports.build = exports.init = exports.discover = exports.type = exports.support = exports.name = void 0;
+exports.ɵcodegenFunctionsDirectory = exports.ɵcodegenPublicDirectory = exports.getDevModeHandle = exports.build = exports.init = exports.discover = exports.docsUrl = exports.type = exports.support = exports.name = void 0;
 const path_1 = require("path");
 const child_process_1 = require("child_process");
 const cross_spawn_1 = require("cross-spawn");
 const fs_extra_1 = require("fs-extra");
 const promises_1 = require("fs/promises");
-const __1 = require("..");
 const prompt_1 = require("../../prompt");
 const utils_1 = require("../utils");
 exports.name = "Angular";
-exports.support = "experimental";
+exports.support = "preview";
 exports.type = 3;
+exports.docsUrl = "https://firebase.google.com/docs/hosting/frameworks/angular";
 const DEFAULT_BUILD_SCRIPT = ["ng build"];
 async function discover(dir) {
     if (!(await (0, fs_extra_1.pathExists)((0, path_1.join)(dir, "package.json"))))
@@ -42,7 +42,7 @@ async function init(setup, config) {
 }
 exports.init = init;
 async function build(dir) {
-    const { targetStringFromTarget } = (0, __1.relativeRequire)(dir, "@angular-devkit/architect");
+    const { targetStringFromTarget } = (0, utils_1.relativeRequire)(dir, "@angular-devkit/architect");
     const { architect, browserTarget, prerenderTarget, serverTarget } = await getContext(dir);
     const scheduleTarget = async (target) => {
         const run = await architect.scheduleTarget(target, undefined);
@@ -54,7 +54,7 @@ async function build(dir) {
     if (!browserTarget)
         throw new Error("No build target...");
     if (prerenderTarget) {
-        const cli = (0, __1.getNodeModuleBin)("ng", dir);
+        const cli = (0, utils_1.getNodeModuleBin)("ng", dir);
         (0, child_process_1.execSync)(`${cli} run ${targetStringFromTarget(prerenderTarget)}`, {
             cwd: dir,
             stdio: "inherit",
@@ -70,12 +70,12 @@ async function build(dir) {
 }
 exports.build = build;
 async function getDevModeHandle(dir) {
-    const { targetStringFromTarget } = (0, __1.relativeRequire)(dir, "@angular-devkit/architect");
+    const { targetStringFromTarget } = (0, utils_1.relativeRequire)(dir, "@angular-devkit/architect");
     const { serveTarget } = await getContext(dir);
     if (!serveTarget)
         return;
     const host = new Promise((resolve) => {
-        const cli = (0, __1.getNodeModuleBin)("ng", dir);
+        const cli = (0, utils_1.getNodeModuleBin)("ng", dir);
         const serve = (0, cross_spawn_1.spawn)(cli, ["run", targetStringFromTarget(serveTarget), "--host", "localhost"], {
             cwd: dir,
         });
@@ -131,7 +131,7 @@ async function ɵcodegenFunctionsDirectory(sourceDir, destDir) {
         const externalDependencies = serverTargetOptions.externalDependencies || [];
         externalDependencies.forEach((externalDependency) => {
             var _a;
-            const packageVersion = (_a = (0, __1.findDependency)(externalDependency)) === null || _a === void 0 ? void 0 : _a.version;
+            const packageVersion = (_a = (0, utils_1.findDependency)(externalDependency)) === null || _a === void 0 ? void 0 : _a.version;
             if (packageVersion) {
                 dependencies[externalDependency] = packageVersion;
             }
@@ -142,11 +142,11 @@ async function ɵcodegenFunctionsDirectory(sourceDir, destDir) {
 }
 exports.ɵcodegenFunctionsDirectory = ɵcodegenFunctionsDirectory;
 async function getContext(dir) {
-    const { NodeJsAsyncHost } = (0, __1.relativeRequire)(dir, "@angular-devkit/core/node");
-    const { workspaces } = (0, __1.relativeRequire)(dir, "@angular-devkit/core");
-    const { WorkspaceNodeModulesArchitectHost } = (0, __1.relativeRequire)(dir, "@angular-devkit/architect/node");
-    const { Architect, targetFromTargetString, targetStringFromTarget } = (0, __1.relativeRequire)(dir, "@angular-devkit/architect");
-    const { parse } = (0, __1.relativeRequire)(dir, "jsonc-parser");
+    const { NodeJsAsyncHost } = (0, utils_1.relativeRequire)(dir, "@angular-devkit/core/node");
+    const { workspaces } = (0, utils_1.relativeRequire)(dir, "@angular-devkit/core");
+    const { WorkspaceNodeModulesArchitectHost } = (0, utils_1.relativeRequire)(dir, "@angular-devkit/architect/node");
+    const { Architect, targetFromTargetString, targetStringFromTarget } = (0, utils_1.relativeRequire)(dir, "@angular-devkit/architect");
+    const { parse } = (0, utils_1.relativeRequire)(dir, "jsonc-parser");
     const host = workspaces.createWorkspaceHost(new NodeJsAsyncHost());
     const { workspace } = await workspaces.readWorkspace(dir, host);
     const architectHost = new WorkspaceNodeModulesArchitectHost(workspace, dir);

package/lib/frameworks/astro/index.js

@@ -4,7 +4,6 @@ exports.getDevModeHandle = exports.ɵcodegenFunctionsDirectory = exports.ɵcodeg
 const cross_spawn_1 = require("cross-spawn");
 const fs_extra_1 = require("fs-extra");
 const path_1 = require("path");
-const __1 = require("..");
 const error_1 = require("../../error");
 const utils_1 = require("../utils");
 const utils_2 = require("./utils");
@@ -13,7 +12,7 @@ exports.support = "experimental";
 exports.type = 2;
 function getAstroVersion(cwd) {
     var _a;
-    return (_a = (0, __1.findDependency)("astro", { cwd, depth: 0, omitDev: false })) === null || _a === void 0 ? void 0 : _a.version;
+    return (_a = (0, utils_1.findDependency)("astro", { cwd, depth: 0, omitDev: false })) === null || _a === void 0 ? void 0 : _a.version;
 }
 async function discover(dir) {
     if (!(0, fs_extra_1.existsSync)((0, path_1.join)(dir, "package.json")))
@@ -29,7 +28,7 @@ async function discover(dir) {
 exports.discover = discover;
 const DEFAULT_BUILD_SCRIPT = ["astro build"];
 async function build(cwd) {
-    const cli = (0, __1.getNodeModuleBin)("astro", cwd);
+    const cli = (0, utils_1.getNodeModuleBin)("astro", cwd);
     await (0, utils_1.warnIfCustomBuildScript)(cwd, exports.name, DEFAULT_BUILD_SCRIPT);
     const { output, adapter } = await (0, utils_2.getConfig)(cwd);
     if (output === "server" && (adapter === null || adapter === void 0 ? void 0 : adapter.name) !== "@astrojs/node") {
@@ -59,7 +58,7 @@ async function ɵcodegenFunctionsDirectory(sourceDir, destDir) {
 exports.ɵcodegenFunctionsDirectory = ɵcodegenFunctionsDirectory;
 async function getDevModeHandle(cwd) {
     const host = new Promise((resolve) => {
-        const cli = (0, __1.getNodeModuleBin)("astro", cwd);
+        const cli = (0, utils_1.getNodeModuleBin)("astro", cwd);
         const serve = (0, cross_spawn_1.spawn)(cli, ["dev"], { cwd });
         serve.stdout.on("data", (data) => {
             process.stdout.write(data);

package/lib/frameworks/constants.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebFrameworks = exports.ALLOWED_SSR_REGIONS = exports.DEFAULT_REGION = exports.VALID_ENGINES = exports.NODE_VERSION = exports.FIREBASE_ADMIN_VERSION = exports.FIREBASE_FUNCTIONS_VERSION = exports.FIREBASE_FRAMEWORKS_VERSION = exports.MAILING_LIST_URL = exports.FEATURE_REQUEST_URL = exports.FILE_BUG_URL = exports.DEFAULT_DOCS_URL = exports.SupportLevelWarnings = exports.NPM_COMMAND_TIMEOUT_MILLIES = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const clc = require("colorette");
+exports.NPM_COMMAND_TIMEOUT_MILLIES = 10000;
+exports.SupportLevelWarnings = {
+    ["experimental"]: (framework) => `Thank you for trying our ${clc.italic("experimental")} support for ${framework} on Firebase Hosting.
+   ${clc.yellow(`While this integration is maintained by Googlers it is not a supported Firebase product.
+   Issues filed on GitHub will be addressed on a best-effort basis by maintainers and other community members.`)}`,
+    ["preview"]: (framework) => `Thank you for trying our ${clc.italic("early preview")} of ${framework} support on Firebase Hosting.
+   ${clc.yellow("During the preview, support is best-effort and breaking changes can be expected. Proceed with caution.")}`,
+};
+exports.DEFAULT_DOCS_URL = "https://firebase.google.com/docs/hosting/frameworks/frameworks-overview";
+exports.FILE_BUG_URL = "https://github.com/firebase/firebase-tools/issues/new?template=bug_report.md";
+exports.FEATURE_REQUEST_URL = "https://github.com/firebase/firebase-tools/issues/new?template=feature_request.md";
+exports.MAILING_LIST_URL = "https://goo.gle/41enW5X";
+exports.FIREBASE_FRAMEWORKS_VERSION = "^0.9.0";
+exports.FIREBASE_FUNCTIONS_VERSION = "^4.3.0";
+exports.FIREBASE_ADMIN_VERSION = "^11.0.1";
+exports.NODE_VERSION = parseInt(process.versions.node, 10);
+exports.VALID_ENGINES = { node: [16, 18] };
+exports.DEFAULT_REGION = "us-central1";
+exports.ALLOWED_SSR_REGIONS = [
+    { name: "us-central1 (Iowa)", value: "us-central1" },
+    { name: "us-west1 (Oregon)", value: "us-west1" },
+    { name: "us-east1 (South Carolina)", value: "us-east1" },
+    { name: "europe-west1 (Belgium)", value: "europe-west1" },
+    { name: "asia-east1 (Taiwan)", value: "asia-east1" },
+];
+exports.WebFrameworks = Object.fromEntries((0, fs_1.readdirSync)(__dirname)
+    .filter((path) => (0, fs_1.statSync)((0, path_1.join)(__dirname, path)).isDirectory())
+    .map((path) => {
+    try {
+        return [path, require((0, path_1.join)(__dirname, path))];
+    }
+    catch (e) {
+        return [];
+    }
+})
+    .filter(([, obj]) => obj && obj.name && obj.discover && obj.build && obj.type !== undefined && obj.support));

package/lib/frameworks/express/index.js

@@ -1,14 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ɵcodegenFunctionsDirectory = exports.ɵcodegenPublicDirectory = exports.build = exports.discover = exports.type = exports.support = exports.name = void 0;
+exports.ɵcodegenFunctionsDirectory = exports.ɵcodegenPublicDirectory = exports.build = exports.discover = exports.docsUrl = exports.type = exports.support = exports.name = void 0;
 const child_process_1 = require("child_process");
 const fs_extra_1 = require("fs-extra");
 const promises_1 = require("fs/promises");
 const path_1 = require("path");
 const { dynamicImport } = require(true && "../../dynamicImport");
 exports.name = "Express.js";
-exports.support = "experimental";
+exports.support = "preview";
 exports.type = 0;
+exports.docsUrl = "https://firebase.google.com/docs/hosting/frameworks/express";
 async function getConfig(root) {
     var _a, _b;
     const packageJsonBuffer = await (0, promises_1.readFile)((0, path_1.join)(root, "package.json"));

package/lib/frameworks/flutter/index.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ɵcodegenPublicDirectory = exports.build = exports.discover = exports.support = exports.type = exports.name = void 0;
+const cross_spawn_1 = require("cross-spawn");
+const fs_extra_1 = require("fs-extra");
+const path_1 = require("path");
+const js_yaml_1 = require("js-yaml");
+const promises_1 = require("fs/promises");
+const error_1 = require("../../error");
+const utils_1 = require("./utils");
+exports.name = "Flutter";
+exports.type = 3;
+exports.support = "experimental";
+async function discover(dir) {
+    var _a;
+    if (!(await (0, fs_extra_1.pathExists)((0, path_1.join)(dir, "pubspec.yaml"))))
+        return;
+    if (!(await (0, fs_extra_1.pathExists)((0, path_1.join)(dir, "web"))))
+        return;
+    const pubSpecBuffer = await (0, promises_1.readFile)((0, path_1.join)(dir, "pubspec.yaml"));
+    const pubSpec = (0, js_yaml_1.load)(pubSpecBuffer.toString());
+    const usingFlutter = (_a = pubSpec.dependencies) === null || _a === void 0 ? void 0 : _a.flutter;
+    if (!usingFlutter)
+        return;
+    return { mayWantBackend: false, publicDirectory: (0, path_1.join)(dir, "web") };
+}
+exports.discover = discover;
+function build(cwd) {
+    (0, utils_1.assertFlutterCliExists)();
+    const build = (0, cross_spawn_1.sync)("flutter", ["build", "web"], { cwd, stdio: "inherit" });
+    if (build.status)
+        throw new error_1.FirebaseError("Unable to build your Flutter app");
+    return Promise.resolve({ wantsBackend: false });
+}
+exports.build = build;
+async function ɵcodegenPublicDirectory(sourceDir, destDir) {
+    await (0, fs_extra_1.copy)((0, path_1.join)(sourceDir, "build", "web"), destDir);
+}
+exports.ɵcodegenPublicDirectory = ɵcodegenPublicDirectory;

package/lib/frameworks/flutter/utils.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertFlutterCliExists = void 0;
+const cross_spawn_1 = require("cross-spawn");
+const error_1 = require("../../error");
+function assertFlutterCliExists() {
+    const process = (0, cross_spawn_1.sync)("flutter", ["--version"], { stdio: "ignore" });
+    if (process.status)
+        throw new error_1.FirebaseError("Flutter CLI not found.");
+}
+exports.assertFlutterCliExists = assertFlutterCliExists;