firebase-functions 3.19.0 → 3.21.0

package/lib/v2/providers/https.js

@@ -21,12 +21,12 @@
 // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 // SOFTWARE.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.onTaskDispatched = exports.onCall = exports.onRequest = exports.HttpsError = void 0;
+exports.onCall = exports.onRequest = exports.HttpsError = void 0;
 const cors = require("cors");
 const encoding_1 = require("../../common/encoding");
-const options = require("../options");
 const https_1 = require("../../common/providers/https");
 Object.defineProperty(exports, "HttpsError", { enumerable: true, get: function () { return https_1.HttpsError; } });
+const options = require("../options");
 function onRequest(optsOrHandler, handler) {
     let opts;
     if (arguments.length === 1) {
@@ -54,9 +54,6 @@ function onRequest(optsOrHandler, handler) {
             // but optionsToTriggerAnnotations handles both cases.
             const specificOpts = options.optionsToTriggerAnnotations(opts);
             const trigger = {
-                // TODO(inlined): Remove "apiVersion" once the latest version of the CLI
-                // has migrated to "platform".
-                apiVersion: 2,
                 platform: 'gcfv2',
                 ...baseOpts,
                 ...specificOpts,
@@ -112,9 +109,6 @@ function onCall(optsOrHandler, handler) {
             // but optionsToTriggerAnnotations handles both cases.
             const specificOpts = options.optionsToTriggerAnnotations(opts);
             return {
-                // TODO(inlined): Remove "apiVersion" once the latest version of the CLI
-                // has migrated to "platform".
-                apiVersion: 2,
                 platform: 'gcfv2',
                 ...baseOpts,
                 ...specificOpts,
@@ -131,7 +125,7 @@ function onCall(optsOrHandler, handler) {
     });
     const baseOpts = options.optionsToEndpoint(options.getGlobalOptions());
     // global options calls region a scalar and https allows it to be an array,
-    // but optionsToManifestEndpoint handles both cases.
+    // but optionsToEndpoint handles both cases.
     const specificOpts = options.optionsToEndpoint(opts);
     func.__endpoint = {
         platform: 'gcfv2',
@@ -147,42 +141,3 @@ function onCall(optsOrHandler, handler) {
     return func;
 }
 exports.onCall = onCall;
-function onTaskDispatched(optsOrHandler, handler) {
-    let opts;
-    if (arguments.length == 1) {
-        opts = {};
-        handler = optsOrHandler;
-    }
-    else {
-        opts = optsOrHandler;
-    }
-    // onEnqueueHandler sniffs the function length to determine which API to present.
-    // fix the length to prevent api versions from being mismatched.
-    const fixedLen = (req) => handler(req);
-    const func = (0, https_1.onDispatchHandler)(fixedLen);
-    Object.defineProperty(func, '__trigger', {
-        get: () => {
-            const baseOpts = options.optionsToTriggerAnnotations(options.getGlobalOptions());
-            // global options calls region a scalar and https allows it to be an array,
-            // but optionsToTriggerAnnotations handles both cases.
-            const specificOpts = options.optionsToTriggerAnnotations(opts);
-            const taskQueueTrigger = {};
-            (0, encoding_1.copyIfPresent)(taskQueueTrigger, opts, 'retryConfig', 'rateLimits');
-            (0, encoding_1.convertIfPresent)(taskQueueTrigger, opts, 'invoker', 'invoker', encoding_1.convertInvoker);
-            return {
-                apiVersion: 2,
-                platform: 'gcfv2',
-                ...baseOpts,
-                ...specificOpts,
-                labels: {
-                    ...baseOpts === null || baseOpts === void 0 ? void 0 : baseOpts.labels,
-                    ...specificOpts === null || specificOpts === void 0 ? void 0 : specificOpts.labels,
-                },
-                taskQueueTrigger,
-            };
-        },
-    });
-    func.run = handler;
-    return func;
-}
-exports.onTaskDispatched = onTaskDispatched;

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

@@ -0,0 +1,22 @@
+import { BlockingFunction } from '../../cloud-functions';
+import { AuthBlockingEvent, BeforeCreateResponse, BeforeSignInResponse, HttpsError } from '../../common/providers/identity';
+import * as options from '../options';
+export { HttpsError };
+/**
+ * All function options plus idToken, accessToken, and refreshToken.
+ */
+export interface BlockingOptions extends options.GlobalOptions {
+    idToken?: boolean;
+    accessToken?: boolean;
+    refreshToken?: boolean;
+}
+/**
+ * Handle an event that is triggered before a user is created.
+ */
+export declare function beforeUserCreated(handler: (event: AuthBlockingEvent) => BeforeCreateResponse | Promise<BeforeCreateResponse> | void | Promise<void>): BlockingFunction;
+export declare function beforeUserCreated(opts: BlockingOptions, handler: (event: AuthBlockingEvent) => BeforeCreateResponse | Promise<BeforeCreateResponse> | void | Promise<void>): BlockingFunction;
+/**
+ * Handle an event that is triggered before a user is signed in.
+ */
+export declare function beforeUserSignedIn(handler: (event: AuthBlockingEvent) => BeforeSignInResponse | Promise<BeforeSignInResponse> | void | Promise<void>): BlockingFunction;
+export declare function beforeUserSignedIn(opts: BlockingOptions, handler: (event: AuthBlockingEvent) => BeforeSignInResponse | Promise<BeforeSignInResponse> | void | Promise<void>): BlockingFunction;

package/lib/v2/providers/identity.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOpts = exports.beforeOperation = exports.beforeUserSignedIn = exports.beforeUserCreated = exports.HttpsError = void 0;
+const identity_1 = require("../../common/providers/identity");
+Object.defineProperty(exports, "HttpsError", { enumerable: true, get: function () { return identity_1.HttpsError; } });
+const options = require("../options");
+function beforeUserCreated(optsOrHandler, handler) {
+    return beforeOperation('beforeCreate', optsOrHandler, handler);
+}
+exports.beforeUserCreated = beforeUserCreated;
+function beforeUserSignedIn(optsOrHandler, handler) {
+    return beforeOperation('beforeSignIn', optsOrHandler, handler);
+}
+exports.beforeUserSignedIn = beforeUserSignedIn;
+/** @internal */
+function beforeOperation(eventType, optsOrHandler, handler) {
+    if (!handler || typeof optsOrHandler === 'function') {
+        handler = optsOrHandler;
+        optsOrHandler = {};
+    }
+    const { opts, accessToken, idToken, refreshToken } = getOpts(optsOrHandler);
+    // Create our own function that just calls the provided function so we know for sure that
+    // handler takes one argument. This is something common/providers/identity depends on.
+    const wrappedHandler = (event) => handler(event);
+    const func = (0, identity_1.wrapHandler)(eventType, wrappedHandler);
+    const legacyEventType = `providers/cloud.auth/eventTypes/user.${eventType}`;
+    /** Endpoint */
+    const baseOptsEndpoint = options.optionsToEndpoint(options.getGlobalOptions());
+    const specificOptsEndpoint = options.optionsToEndpoint(opts);
+    func.__endpoint = {
+        platform: 'gcfv2',
+        ...baseOptsEndpoint,
+        ...specificOptsEndpoint,
+        labels: {
+            ...baseOptsEndpoint === null || baseOptsEndpoint === void 0 ? void 0 : baseOptsEndpoint.labels,
+            ...specificOptsEndpoint === null || specificOptsEndpoint === void 0 ? void 0 : specificOptsEndpoint.labels,
+        },
+        blockingTrigger: {
+            eventType: legacyEventType,
+            options: {
+                accessToken,
+                idToken,
+                refreshToken,
+            },
+        },
+    };
+    func.__requiredAPIs = [
+        {
+            api: 'identitytoolkit.googleapis.com',
+            reason: 'Needed for auth blocking functions',
+        },
+    ];
+    func.run = handler;
+    return func;
+}
+exports.beforeOperation = beforeOperation;
+/** @internal */
+function getOpts(blockingOptions) {
+    const accessToken = blockingOptions.accessToken || false;
+    const idToken = blockingOptions.idToken || false;
+    const refreshToken = blockingOptions.refreshToken || false;
+    const opts = { ...blockingOptions };
+    delete opts.accessToken;
+    delete opts.idToken;
+    delete opts.refreshToken;
+    return {
+        opts,
+        accessToken,
+        idToken,
+        refreshToken,
+    };
+}
+exports.getOpts = getOpts;

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

@@ -1,5 +1,5 @@
-import * as options from '../options';
 import { CloudEvent, CloudFunction } from '../core';
+import * as options from '../options';
 /**
  * Interface representing a Google Cloud Pub/Sub message.
  *
@@ -52,6 +52,6 @@ export interface PubSubOptions extends options.EventHandlerOptions {
     topic: string;
 }
 /** Handle a message being published to a Pub/Sub topic. */
-export declare function onMessagePublished<T = any>(topic: string, handler: (event: CloudEvent<MessagePublishedData<T>>) => any | Promise<any>): CloudFunction<MessagePublishedData<T>>;
+export declare function onMessagePublished<T = any>(topic: string, handler: (event: CloudEvent<MessagePublishedData<T>>) => any | Promise<any>): CloudFunction<CloudEvent<MessagePublishedData<T>>>;
 /** Handle a message being published to a Pub/Sub topic. */
-export declare function onMessagePublished<T = any>(options: PubSubOptions, handler: (event: CloudEvent<MessagePublishedData<T>>) => any | Promise<any>): CloudFunction<MessagePublishedData<T>>;
+export declare function onMessagePublished<T = any>(options: PubSubOptions, handler: (event: CloudEvent<MessagePublishedData<T>>) => any | Promise<any>): CloudFunction<CloudEvent<MessagePublishedData<T>>>;

package/lib/v2/providers/pubsub.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.onMessagePublished = exports.Message = void 0;
-const options = require("../options");
 const encoding_1 = require("../../common/encoding");
+const options = require("../options");
 /**
  * Interface representing a Google Cloud Pub/Sub message.
  *
@@ -75,9 +75,6 @@ function onMessagePublished(topicOrOptions, handler) {
             const baseOpts = options.optionsToTriggerAnnotations(options.getGlobalOptions());
             const specificOpts = options.optionsToTriggerAnnotations(opts);
             return {
-                // TODO(inlined): Remove "apiVersion" once the CLI has migrated to
-                // "platform"
-                apiVersion: 2,
                 platform: 'gcfv2',
                 ...baseOpts,
                 ...specificOpts,
@@ -104,7 +101,7 @@ function onMessagePublished(topicOrOptions, handler) {
         },
         eventTrigger: {
             eventType: 'google.cloud.pubsub.topic.v1.messagePublished',
-            eventFilters: [{ attribute: 'topic', value: topic }],
+            eventFilters: { topic },
             retry: false,
         },
     };

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

@@ -1,5 +1,5 @@
-import * as options from '../options';
 import { CloudEvent, CloudFunction } from '../core';
+import * as options from '../options';
 /**
  * An object within Google Cloud Storage.
  * Ref: https://github.com/googleapis/google-cloudevents-nodejs/blob/main/cloud/storage/v1/StorageObjectData.ts
@@ -148,23 +148,27 @@ export interface CustomerEncryption {
      */
     keySha256?: string;
 }
+export interface StorageEvent extends CloudEvent<StorageObjectData> {
+    /** The name of the bucket containing this object. */
+    bucket: string;
+}
 /** StorageOptions extend EventHandlerOptions with a bucket name  */
 export interface StorageOptions extends options.EventHandlerOptions {
     bucket?: string;
 }
 /** Handle a storage object archived */
-export declare function onObjectArchived(handler: (event: CloudEvent<StorageObjectData>) => any | Promise<any>): CloudFunction<StorageObjectData>;
-export declare function onObjectArchived(bucket: string, handler: (event: CloudEvent<StorageObjectData>) => any | Promise<any>): CloudFunction<StorageObjectData>;
-export declare function onObjectArchived(opts: StorageOptions, handler: (event: CloudEvent<StorageObjectData>) => any | Promise<any>): CloudFunction<StorageObjectData>;
+export declare function onObjectArchived(handler: (event: StorageEvent) => any | Promise<any>): CloudFunction<StorageEvent>;
+export declare function onObjectArchived(bucket: string, handler: (event: StorageEvent) => any | Promise<any>): CloudFunction<StorageEvent>;
+export declare function onObjectArchived(opts: StorageOptions, handler: (event: StorageEvent) => any | Promise<any>): CloudFunction<StorageEvent>;
 /** Handle a storage object finalized */
-export declare function onObjectFinalized(handler: (event: CloudEvent<StorageObjectData>) => any | Promise<any>): CloudFunction<StorageObjectData>;
-export declare function onObjectFinalized(bucket: string, handler: (event: CloudEvent<StorageObjectData>) => any | Promise<any>): CloudFunction<StorageObjectData>;
-export declare function onObjectFinalized(opts: StorageOptions, handler: (event: CloudEvent<StorageObjectData>) => any | Promise<any>): CloudFunction<StorageObjectData>;
+export declare function onObjectFinalized(handler: (event: StorageEvent) => any | Promise<any>): CloudFunction<StorageEvent>;
+export declare function onObjectFinalized(bucket: string, handler: (event: StorageEvent) => any | Promise<any>): CloudFunction<StorageEvent>;
+export declare function onObjectFinalized(opts: StorageOptions, handler: (event: StorageEvent) => any | Promise<any>): CloudFunction<StorageEvent>;
 /** Handle a storage object deleted */
-export declare function onObjectDeleted(handler: (event: CloudEvent<StorageObjectData>) => any | Promise<any>): CloudFunction<StorageObjectData>;
-export declare function onObjectDeleted(bucket: string, handler: (event: CloudEvent<StorageObjectData>) => any | Promise<any>): CloudFunction<StorageObjectData>;
-export declare function onObjectDeleted(opts: StorageOptions, handler: (event: CloudEvent<StorageObjectData>) => any | Promise<any>): CloudFunction<StorageObjectData>;
+export declare function onObjectDeleted(handler: (event: StorageEvent) => any | Promise<any>): CloudFunction<StorageEvent>;
+export declare function onObjectDeleted(bucket: string, handler: (event: StorageEvent) => any | Promise<any>): CloudFunction<StorageEvent>;
+export declare function onObjectDeleted(opts: StorageOptions, handler: (event: StorageEvent) => any | Promise<any>): CloudFunction<StorageEvent>;
 /** Handle a storage object metadata updated */
-export declare function onObjectMetadataUpdated(handler: (event: CloudEvent<StorageObjectData>) => any | Promise<any>): CloudFunction<StorageObjectData>;
-export declare function onObjectMetadataUpdated(bucket: string, handler: (event: CloudEvent<StorageObjectData>) => any | Promise<any>): CloudFunction<StorageObjectData>;
-export declare function onObjectMetadataUpdated(opts: StorageOptions, handler: (event: CloudEvent<StorageObjectData>) => any | Promise<any>): CloudFunction<StorageObjectData>;
+export declare function onObjectMetadataUpdated(handler: (event: StorageEvent) => any | Promise<any>): CloudFunction<StorageEvent>;
+export declare function onObjectMetadataUpdated(bucket: string, handler: (event: StorageEvent) => any | Promise<any>): CloudFunction<StorageEvent>;
+export declare function onObjectMetadataUpdated(opts: StorageOptions, handler: (event: StorageEvent) => any | Promise<any>): CloudFunction<StorageEvent>;

package/lib/v2/providers/storage.js

@@ -22,9 +22,9 @@
 // SOFTWARE.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getOptsAndBucket = exports.onOperation = exports.onObjectMetadataUpdated = exports.onObjectDeleted = exports.onObjectFinalized = exports.onObjectArchived = exports.metadataUpdatedEvent = exports.deletedEvent = exports.finalizedEvent = exports.archivedEvent = void 0;
-const options = require("../options");
-const config_1 = require("../../config");
 const encoding_1 = require("../../common/encoding");
+const config_1 = require("../../config");
+const options = require("../options");
 /** @internal */
 exports.archivedEvent = 'google.cloud.storage.object.v1.archived';
 /** @internal */
@@ -99,7 +99,7 @@ function onOperation(eventType, bucketOrOptsOrHandler, handler) {
                 },
                 eventTrigger: {
                     eventType,
-                    eventFilters: [{ attribute: 'bucket', value: bucket }],
+                    eventFilters: { bucket },
                     retry: false,
                 },
             };
@@ -112,6 +112,7 @@ function onOperation(eventType, bucketOrOptsOrHandler, handler) {
 exports.onOperation = onOperation;
 /** @internal */
 function getOptsAndBucket(bucketOrOpts) {
+    var _a;
     let bucket;
     let opts;
     if (typeof bucketOrOpts === 'string') {
@@ -119,7 +120,7 @@ function getOptsAndBucket(bucketOrOpts) {
         opts = {};
     }
     else {
-        bucket = bucketOrOpts.bucket || (0, config_1.firebaseConfig)().storageBucket;
+        bucket = bucketOrOpts.bucket || ((_a = (0, config_1.firebaseConfig)()) === null || _a === void 0 ? void 0 : _a.storageBucket);
         opts = { ...bucketOrOpts };
         delete opts.bucket;
     }

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

@@ -0,0 +1,22 @@
+import { AuthData, RateLimits, Request, RetryConfig } from '../../common/providers/tasks';
+import * as options from '../options';
+import { HttpsFunction } from './https';
+export { AuthData, RateLimits, Request, RetryConfig as RetryPolicy };
+export interface TaskQueueOptions extends options.GlobalOptions {
+    retryConfig?: RetryConfig;
+    rateLimits?: RateLimits;
+    /**
+     * Who can enqueue tasks for this function.
+     * If left unspecified, only service accounts which have
+     * roles/cloudtasks.enqueuer and roles/cloudfunctions.invoker
+     * will have permissions.
+     */
+    invoker?: 'private' | string | string[];
+}
+export interface TaskQueueFunction<T = any> extends HttpsFunction {
+    run(data: Request<T>): void | Promise<void>;
+}
+/** Handle a request sent to a Cloud Tasks queue. */
+export declare function onTaskDispatched<Args = any>(handler: (request: Request<Args>) => void | Promise<void>): TaskQueueFunction<Args>;
+/** Handle a request sent to a Cloud Tasks queue. */
+export declare function onTaskDispatched<Args = any>(options: TaskQueueOptions, handler: (request: Request<Args>) => void | Promise<void>): TaskQueueFunction<Args>;

package/lib/v2/providers/tasks.js

@@ -0,0 +1,88 @@
+"use strict";
+// The MIT License (MIT)
+//
+// Copyright (c) 2022 Firebase
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onTaskDispatched = void 0;
+const encoding_1 = require("../../common/encoding");
+const tasks_1 = require("../../common/providers/tasks");
+const options = require("../options");
+function onTaskDispatched(optsOrHandler, handler) {
+    let opts;
+    if (arguments.length == 1) {
+        opts = {};
+        handler = optsOrHandler;
+    }
+    else {
+        opts = optsOrHandler;
+    }
+    // onDispatchHandler sniffs the function length to determine which API to present.
+    // fix the length to prevent api versions from being mismatched.
+    const fixedLen = (req) => handler(req);
+    const func = (0, tasks_1.onDispatchHandler)(fixedLen);
+    Object.defineProperty(func, '__trigger', {
+        get: () => {
+            const baseOpts = options.optionsToTriggerAnnotations(options.getGlobalOptions());
+            // global options calls region a scalar and https allows it to be an array,
+            // but optionsToTriggerAnnotations handles both cases.
+            const specificOpts = options.optionsToTriggerAnnotations(opts);
+            const taskQueueTrigger = {};
+            (0, encoding_1.copyIfPresent)(taskQueueTrigger, opts, 'retryConfig', 'rateLimits');
+            (0, encoding_1.convertIfPresent)(taskQueueTrigger, opts, 'invoker', 'invoker', encoding_1.convertInvoker);
+            return {
+                platform: 'gcfv2',
+                ...baseOpts,
+                ...specificOpts,
+                labels: {
+                    ...baseOpts === null || baseOpts === void 0 ? void 0 : baseOpts.labels,
+                    ...specificOpts === null || specificOpts === void 0 ? void 0 : specificOpts.labels,
+                },
+                taskQueueTrigger,
+            };
+        },
+    });
+    const baseOpts = options.optionsToEndpoint(options.getGlobalOptions());
+    // global options calls region a scalar and https allows it to be an array,
+    // but optionsToManifestEndpoint handles both cases.
+    const specificOpts = options.optionsToEndpoint(opts);
+    func.__endpoint = {
+        platform: 'gcfv2',
+        ...baseOpts,
+        ...specificOpts,
+        labels: {
+            ...baseOpts === null || baseOpts === void 0 ? void 0 : baseOpts.labels,
+            ...specificOpts === null || specificOpts === void 0 ? void 0 : specificOpts.labels,
+        },
+        taskQueueTrigger: {},
+    };
+    (0, encoding_1.copyIfPresent)(func.__endpoint.taskQueueTrigger, opts, 'retryConfig');
+    (0, encoding_1.copyIfPresent)(func.__endpoint.taskQueueTrigger, opts, 'rateLimits');
+    (0, encoding_1.convertIfPresent)(func.__endpoint.taskQueueTrigger, opts, 'invoker', 'invoker', encoding_1.convertInvoker);
+    func.__requiredAPIs = [
+        {
+            api: 'cloudtasks.googleapis.com',
+            reason: 'Needed for task queue functions',
+        },
+    ];
+    func.run = handler;
+    return func;
+}
+exports.onTaskDispatched = onTaskDispatched;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firebase-functions",
-  "version": "3.19.0",
+  "version": "3.21.0",
   "description": "Firebase SDK for Cloud Functions",
   "keywords": [
     "firebase",
@@ -40,6 +40,7 @@
     "./lib/providers/pubsub": "./lib/providers/pubsub.js",
     "./lib/providers/remoteConfig": "./lib/providers/remoteConfig.js",
     "./lib/providers/storage": "./lib/providers/storage.js",
+    "./lib/providers/tasks": "./lib/providers/tasks.js",
     "./lib/providers/testLab": "./lib/providers/testLab.js",
     "./v1": "./lib/index.js",
     "./v1/analytics": "./lib/providers/analytics.js",
@@ -58,10 +59,13 @@
     "./v2/params": "./lib/v2/params/index.js",
     "./v2/pubsub": "./lib/v2/providers/pubsub.js",
     "./v2/storage": "./lib/v2/providers/storage.js",
+    "./v2/tasks": "./lib/v2/providers/tasks.js",
     "./v2/alerts": "./lib/v2/providers/alerts/index.js",
     "./v2/alerts/appDistribution": "./lib/v2/providers/alerts/appDistribution.js",
     "./v2/alerts/billing": "./lib/v2/providers/alerts/billing.js",
-    "./v2/alerts/crashlytics": "./lib/v2/providers/alerts/crashlytics.js"
+    "./v2/alerts/crashlytics": "./lib/v2/providers/alerts/crashlytics.js",
+    "./v2/eventarc": "./lib/v2/providers/eventarc.js",
+    "./v2/identity": "./lib/v2/providers/identity.js"
   },
   "typesVersions": {
     "*": {
@@ -98,15 +102,36 @@
       "v1/storage": [
         "lib/providers/storage"
       ],
+      "v1/tasks": [
+        "lib/providers/tasks"
+      ],
       "v1/testLab": [
         "lib/providers/testLab"
       ],
       "v2": [
         "lib/v2"
       ],
+      "v2/alerts": [
+        "lib/v2/providers/alerts"
+      ],
+      "v2/alerts/appDistribution": [
+        "lib/v2/providers/alerts/appDistribution"
+      ],
+      "v2/alerts/billing": [
+        "lib/v2/providers/alerts/billing"
+      ],
+      "v2/alerts/crashlytics": [
+        "lib/v2/providers/alerts/crashlytics"
+      ],
       "v2/base": [
         "lib/v2/base"
       ],
+      "v2/eventarc": [
+        "lib/v2/providers/eventarc"
+      ],
+      "v2/identity": [
+        "lib/v2/providers/identity"
+      ],
       "v2/options": [
         "lib/v2/options"
       ],
@@ -122,17 +147,8 @@
       "v2/storage": [
         "lib/v2/providers/storage"
       ],
-      "v2/alerts": [
-        "lib/v2/providers/alerts"
-      ],
-      "v2/alerts/appDistribution": [
-        "lib/v2/providers/alerts/appDistribution"
-      ],
-      "v2/alerts/billing": [
-        "lib/v2/providers/alerts/billing"
-      ],
-      "v2/alerts/crashlytics": [
-        "lib/v2/providers/alerts/crashlytics"
+      "v2/tasks": [
+        "lib/v2/providers/tasks"
       ]
     }
   },
@@ -141,6 +157,12 @@
   },
   "scripts": {
     "apidocs": "node docgen/generate-docs.js",
+    "docgen:v1:extract": "api-extractor run -c docgen/api-extractor.v1.json --local",
+    "docgen:v1:gen": "api-documenter-fire markdown -i docgen/v1 -o docgen/v1/markdown && api-documenter-fire toc -i docgen/v1 -o docgen/v1/markdown/toc -p /docs/reference/functions",
+    "docgen:v1": "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:gen": "api-documenter-fire markdown -i docgen/v2 -o docgen/v2/markdown && api-documenter-fire toc -i docgen/v2 -o docgen/v2/markdown/toc -p /docs/reference/functions/v2",
+    "docgen:v2": "npm run docgen:v2:extract && npm run docgen:v2:gen",
     "build:pack": "rm -rf lib && npm install && tsc -p tsconfig.release.json && npm pack",
     "build:release": "npm ci --production && npm install --no-save typescript firebase-admin && tsc -p tsconfig.release.json",
     "build": "tsc -p tsconfig.release.json",
@@ -157,9 +179,13 @@
     "@types/express": "4.17.3",
     "cors": "^2.8.5",
     "express": "^4.17.1",
-    "lodash": "^4.17.14"
+    "lodash": "^4.17.14",
+    "node-fetch": "^2.6.7"
   },
   "devDependencies": {
+    "@firebase/api-documenter": "^0.1.2",
+    "@microsoft/api-documenter": "^7.13.45",
+    "@microsoft/api-extractor": "^7.18.7",
     "@types/chai": "^4.1.7",
     "@types/chai-as-promised": "^7.1.0",
     "@types/jsonwebtoken": "^8.3.2",
@@ -168,11 +194,12 @@
     "@types/mock-require": "^2.0.0",
     "@types/nock": "^10.0.3",
     "@types/node": "^8.10.50",
+    "@types/node-fetch": "^3.0.3",
     "@types/sinon": "^7.0.13",
     "chai": "^4.2.0",
     "chai-as-promised": "^7.1.1",
     "child-process-promise": "^2.2.1",
-    "firebase-admin": "10.0.0",
+    "firebase-admin": "^10.1.0",
     "js-yaml": "^3.13.1",
     "jsdom": "^16.2.1",
     "jsonwebtoken": "^8.5.1",