feat: add firebase functions v2 preset

docs/content/2.deploy/providers/firebase.md

@@ -8,9 +8,15 @@ Nitro supports [Firebase Hosting](https://firebase.google.com/docs/hosting) with
 
 **Note**: You need to be on the **Blaze plan** to use Nitro with Cloud Functions.
 
-If you don't already have a `firebase.json` in your root directory, Nitro will create one the first time you run it. In this file, you will need to replace `<your_project_id>` with the ID of your Firebase project.
+**Note**: This preset will deploy to firebase functions v1. If you want to deploy to firebase functions v2, please use the [`firebase-v2`](#firebase-functions-v2) preset.
 
-This file should then be committed to version control. You can also create a `.firebaserc` file if you don't want to manually pass your project ID to your `firebase` commands (with `--project <your_project_id>`):
+### Setup Using Nitro
+
+If you don't already have a `firebase.json` in your root directory, Nitro will create one the first time you run it. In this file, you will need to replace `<your_project_id>` with the ID of your Firebase project. This file should then be committed to version control.
+
+#### Create a .firebaserc file
+
+It is also recommended to create a `.firebaserc` file so you don't need to manually pass your project ID to your `firebase` commands (with `--project <your_project_id>`):
 
 ```json [.firebaserc]
 {
@@ -20,19 +26,35 @@ This file should then be committed to version control. You can also create a `.f
 }
 ```
 
-Then, just add Firebase dependencies to your project:
+#### Install Firebase dependencies
+
+Then, add Firebase dependencies to your project:
+
+yarn:
 
 ```bash
-# yarn
-yarn add --dev firebase-admin firebase-functions firebase-functions-test
+yarn add --dev firebase-admin firebase-functions firebase-functions-test firebase-tools
+```
 
-# npm
-npm install -D firebase-admin firebase-functions firebase-functions-test
+npm:
+
+```bash
+npm install -D firebase-admin firebase-functions firebase-functions-test firebase-tools
+```
+
+#### Log into the firebase cli
+
+Make sure you are authenticated with the firebase cli. Run this command and follow the prompts:
+
+```bash
+npx firebase-tools login
 ```
 
-### Using Firebase CLI
 
-You may instead prefer to set up your project with the Firebase CLI, which will fetch your project ID for you, add required dependencies (see above) and even set up automated deployments via GitHub Actions.
+
+### Alternative Setup Using Firebase CLI
+
+You may instead prefer to set up your project with the Firebase CLI, which will fetch your project ID for you, add required dependencies (see above) and even set up automated deployments via GitHub Actions. [Learn about installing the firebase CLI](https://firebase.google.com/docs/cli#windows-npm).
 
 #### Install Firebase CLI globally
 
@@ -82,11 +104,94 @@ NITRO_PRESET=firebase yarn build
 firebase emulators:start
 ```
 
-## Deploy to Firebase Hosting via CLI
+## Build and Deploy
 
-Deploying to Firebase Hosting is a simple matter of just running the `firebase deploy` command.
+Deploy to Firebase Hosting by running a nitro build and then running the `firebase deploy` command.
 
 ```bash
 NITRO_PRESET=firebase yarn build
+```
+
+```bash
+npx firebase-tools deploy
+```
+
+If you chose the alternative setup using the Firebase CLI, you can also run:
+
+```bash
 firebase deploy
 ```
+
+## Firebase Functions v2
+
+**Preset:** `firebase-v2` ([switch to this preset](/deploy/#changing-the-deployment-preset))
+
+This preset will deploy to [firebase functions V2](https://firebase.google.com/docs/functions/version-comparison) - the 2nd generation of cloud functions.
+
+It works the same as the [`firebase`](#firebase) preset above, but uses the V2 functions runtime.
+
+### Setup
+
+Follow the instructions for the `firebase` preset above for setup and deploy.
+
+::alert{type="warning"}
+New HTTP and HTTP callable functions deployed with any Firebase CLI lower than version 7.7.0 are private by default and throw HTTP 403 errors when invoked. Either explicitly [make these functions public](https://cloud.google.com/functions/docs/securing/managing-access-iam#allowing_unauthenticated_http_function_invocation) or [update your Firebase CLI](https://firebase.google.com/docs/cli#setup_update_cli) before you deploy. If you deploy the function and it is not publicly accessible, then you will need to visit the [Functions Console](https://console.cloud.google.com/functions/list) on Google cloud platform, click your function name, select the 'Permissions' tab and follow the instructions on how to make the function public.
+::
+
+### Options
+
+The `firebase-v2` preset also supports passing options to the firebase function via the nitro config. These options are defined in the nitro config object under `firebase.v2.httpRequestOptions`.
+
+The `httpRequestOptions` object is passed to `functions.https.onRequest()` function as the first argument as per the [firebase docs](https://firebase.google.com/docs/functions/http-events?gen=2nd#trigger_a_function_with_an_http_request).
+
+For example, to set the region and max instances of the function, you can add the following to your `nitro.config.ts`:
+
+```ts
+import { defineNitroConfig } from 'nitropack/config'
+
+export default defineNitroConfig({
+  // Nitro options...
+  firebase: {
+    v2: {
+      httpRequestOptions: {
+        region: "europe-west1",
+        maxInstances: 3,
+        // etc.
+      }
+    }
+  }
+})
+```
+
+The documentation for the `httpRequestOptions` option can be found in the [firebase functions 2nd gen docs](https://firebase.google.com/docs/reference/functions/2nd-gen/node/firebase-functions.https.httpsoptions).
+
+### Runtime
+
+Firebase uses the engines.node version in your `package.json` to determine which node version to use for your functions. If you want to use a different version of node for your functions, you should set the `engines.node` version in your `package.json` to the version you want to use:
+
+```json [package.json]
+{
+  "engines": {
+    "node": "18"
+  }
+}
+```
+
+For some node versions you will also need to add a runtime key to your firebase.json file:
+
+```json [firebase.json]
+{
+  "functions": {
+    "source": ".output/server",
+    "runtime": "nodejs18"
+  }
+}
+```
+
+## If your firebase project has other cloud functions
+
+You may be warned that other cloud functions will be deleted when you deploy your nitro project. This is because nitro will deploy your entire project to firebase functions. If you want to deploy only your nitro project, you can use the `--only` flag:
+
+```bash
+firebase deploy --only functions:server,hosting
+```

docs/content/3.config.md

@@ -469,3 +469,9 @@ Rollup specific option.
 ### `commonJS`
 
 Rollup specific option. Specifies additional configuration for the rollup CommonJS plugin.
+
+## Preset options
+
+### `firebase`
+
+The options for the firebase functions v2 preset. See [Preset](/deploy/providers/firebase#firebase-functions-v2)

package.json

@@ -76,6 +76,7 @@
     "esbuild": "^0.18.11",
     "escape-string-regexp": "^5.0.0",
     "etag": "^1.8.1",
+    "firebase-functions": "^4.4.1",
     "fs-extra": "^11.1.1",
     "globby": "^13.2.2",
     "gzip-size": "^7.0.0",
@@ -152,4 +153,4 @@
       ]
     }
   }
-}
+}