firebase-functions 4.2.0 → 4.3.0

package/lib/v2/providers/pubsub.d.ts

@@ -91,7 +91,7 @@ export interface PubSubOptions extends options.EventHandlerOptions {
     /**
      * Region where functions should be deployed.
      */
-    region?: options.SupportedRegion | string;
+    region?: options.SupportedRegion | string | Expression<string> | ResetValue;
     /**
      * Amount of memory to allocate to a function.
      */
@@ -152,7 +152,7 @@ export interface PubSubOptions extends options.EventHandlerOptions {
     /**
      * Specific service account for the function to run as.
      */
-    serviceAccount?: string | ResetValue;
+    serviceAccount?: string | Expression<string> | ResetValue;
     /**
      * Ingress settings which control where this function can be called from.
      */

package/lib/v2/providers/remoteConfig.d.ts

@@ -10,7 +10,7 @@ export interface ConfigUser {
     imageUrl: string;
 }
 /** What type of update was associated with the Remote Config template version. */
-export declare type ConfigUpdateOrigin = 
+export type ConfigUpdateOrigin = 
 /** Catch-all for unrecognized values. */
 "REMOTE_CONFIG_UPDATE_ORIGIN_UNSPECIFIED"
 /** The update came from the Firebase UI. */
@@ -20,7 +20,7 @@ export declare type ConfigUpdateOrigin =
 /** The update came from the Firebase Admin Node SDK. */
  | "ADMIN_SDK_NODE";
 /** Where the Remote Config update action originated. */
-export declare type ConfigUpdateType = 
+export type ConfigUpdateType = 
 /** Catch-all for unrecognized enum values */
 "REMOTE_CONFIG_UPDATE_TYPE_UNSPECIFIED"
 /** A regular incremental update */

package/lib/v2/providers/storage.d.ts

@@ -167,7 +167,7 @@ export interface StorageOptions extends options.EventHandlerOptions {
     /**
      * Region where functions should be deployed.
      */
-    region?: options.SupportedRegion | string;
+    region?: options.SupportedRegion | string | Expression<string> | ResetValue;
     /**
      * Amount of memory to allocate to a function.
      */
@@ -228,7 +228,7 @@ export interface StorageOptions extends options.EventHandlerOptions {
     /**
      * Specific service account for the function to run as.
      */
-    serviceAccount?: string | ResetValue;
+    serviceAccount?: string | Expression<string> | ResetValue;
     /**
      * Ingress settings which control where this function can be called from.
      */

package/lib/v2/providers/tasks.d.ts

@@ -4,7 +4,7 @@ import * as options from "../options";
 import { HttpsFunction } from "./https";
 import { Expression } from "../../params";
 import { SecretParam } from "../../params/types";
-export { AuthData, Request };
+export { AuthData, Request, RateLimits, RetryConfig };
 export interface TaskQueueOptions extends options.EventHandlerOptions {
     /** How a task should be retried in the event of a non-2xx return. */
     retryConfig?: RetryConfig;
@@ -26,7 +26,7 @@ export interface TaskQueueOptions extends options.EventHandlerOptions {
     /**
      * Region where functions should be deployed.
      */
-    region?: options.SupportedRegion | string;
+    region?: options.SupportedRegion | string | Expression<string> | ResetValue;
     /**
      * Amount of memory to allocate to a function.
      */
@@ -87,7 +87,7 @@ export interface TaskQueueOptions extends options.EventHandlerOptions {
     /**
      * Specific service account for the function to run as.
      */
-    serviceAccount?: string | ResetValue;
+    serviceAccount?: string | Expression<string> | ResetValue;
     /**
      * Ingress settings which control where this function can be called from.
      */

package/lib/v2/providers/testLab.d.ts

@@ -1,7 +1,7 @@
 import { CloudEvent, CloudFunction } from "../core";
 import { EventHandlerOptions } from "../options";
 /** Possible test states for a test matrix. */
-export declare type TestState = 
+export type TestState = 
 /** The default value. This value is used if the state is omitted. */
 "TEST_STATE_UNSPECIFIED"
 /** The test matrix is being validated. */
@@ -15,7 +15,7 @@ export declare type TestState =
 /** The test matrix was not run because the provided inputs are not valid. */
  | "INVALID";
 /** Outcome summary for a finished test matrix. */
-export declare type OutcomeSummary = 
+export type OutcomeSummary = 
 /** The default value. This value is used if the state is omitted. */
 "OUTCOME_SUMMARY_UNSPECIFIED"
 /**

package/lib/v2/trace.d.ts

@@ -1,4 +1,4 @@
 import { CloudEvent } from "./core";
-declare type CloudEventFunction<T> = (raw: CloudEvent<T>) => any | Promise<any>;
+type CloudEventFunction<T> = (raw: CloudEvent<T>) => any | Promise<any>;
 export declare function wrapTraceContext<T>(handler: CloudEventFunction<T>): CloudEventFunction<T>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firebase-functions",
-  "version": "4.2.0",
+  "version": "4.3.0",
   "description": "Firebase SDK for Cloud Functions",
   "keywords": [
     "firebase",
@@ -19,7 +19,8 @@
   "license": "MIT",
   "author": "Firebase Team",
   "files": [
-    "lib"
+    "lib",
+    "protos"
   ],
   "main": "lib/v1/index.js",
   "bin": {
@@ -59,7 +60,8 @@
     "./v2/database": "./lib/v2/providers/database.js",
     "./v2/scheduler": "./lib/v2/providers/scheduler.js",
     "./v2/remoteConfig": "./lib/v2/providers/remoteConfig.js",
-    "./v2/testLab": "./lib/v2/providers/testLab.js"
+    "./v2/testLab": "./lib/v2/providers/testLab.js",
+    "./v2/firestore": "./lib/v2/providers/firestore.js"
   },
   "typesVersions": {
     "*": {
@@ -158,6 +160,9 @@
       ],
       "v2/testLab": [
         "lib/v2/providers/testLab"
+      ],
+      "v2/firestore": [
+        "lib/v2/providers/firestore"
       ]
     }
   },
@@ -170,7 +175,7 @@
     "docgen:v1:gen": "api-documenter-fire markdown -i docgen/v1 -o docgen/v1/markdown --project functions && npm run docgen:v1:toc",
     "docgen:v1": "npm run build && npm run docgen:v1:extract && npm run docgen:v1:gen",
     "docgen:v2:extract": "api-extractor run -c docgen/api-extractor.v2.json --local",
-    "docgen:v2:toc": "ts-node docgen/toc.ts --input docgen/v2 --output docgen/v2/markdown/toc --path /docs/functions/beta/reference",
+    "docgen:v2:toc": "ts-node docgen/toc.ts --input docgen/v2 --output docgen/v2/markdown/toc --path /docs/reference/functions/2nd-gen/node",
     "docgen:v2:gen": "api-documenter-fire markdown -i docgen/v2 -o docgen/v2/markdown --project functions && npm run docgen:v2:toc",
     "docgen:v2": "npm run build && npm run docgen:v2:extract && npm run docgen:v2:gen",
     "build:pack": "rm -rf lib && npm install && tsc -p tsconfig.release.json && npm pack",
@@ -193,7 +198,8 @@
     "@types/express": "4.17.3",
     "cors": "^2.8.5",
     "express": "^4.17.1",
-    "node-fetch": "^2.6.7"
+    "node-fetch": "^2.6.7",
+    "protobufjs": "^7.2.2"
   },
   "devDependencies": {
     "@firebase/api-documenter": "^0.2.0",
@@ -224,13 +230,14 @@
     "jsdom": "^16.2.1",
     "jsonwebtoken": "^9.0.0",
     "jwk-to-pem": "^2.0.5",
-    "mocha": "^6.1.4",
+    "mocha": "^10.2.0",
     "mock-require": "^3.0.3",
     "mz": "^2.7.0",
     "nock": "^13.2.9",
     "node-fetch": "^2.6.7",
     "portfinder": "^1.0.28",
     "prettier": "^2.7.1",
+    "protobufjs-cli": "^1.1.1",
     "semver": "^7.3.5",
     "sinon": "^7.3.2",
     "ts-node": "^10.4.0",

package/protos/README.md

@@ -0,0 +1,15 @@
+# Generate compiled ProtoBuf
+
+Running the script will generate statically-compiled protobufs for decoding `application/protobuf` events. Generate them by running:
+
+```
+./update.sh
+```
+
+In order to build, the following repos are cloned
+
+- https://github.com/googleapis/google-cloudevents
+- https://github.com/googleapis/googleapis
+- https://github.com/google/protobuf
+
+The script relies on the [protobufjs-cli](https://github.com/protobufjs/protobuf.js/tree/master/cli#pbts-for-typescript) package to create the compiled js/ts files.