firebase-functions 3.20.1 → 3.21.0

package/lib/providers/auth.js

@@ -21,11 +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.UserBuilder = exports._userWithOptions = exports.user = exports.service = exports.provider = exports.userRecordConstructor = exports.UserRecordMetadata = void 0;
+exports.UserBuilder = exports._userWithOptions = exports.user = exports.service = exports.provider = exports.HttpsError = exports.userRecordConstructor = exports.UserRecordMetadata = void 0;
+const cloud_functions_1 = require("../cloud-functions");
 const identity_1 = require("../common/providers/identity");
-Object.defineProperty(exports, "UserRecordMetadata", { enumerable: true, get: function () { return identity_1.UserRecordMetadata; } });
+Object.defineProperty(exports, "HttpsError", { enumerable: true, get: function () { return identity_1.HttpsError; } });
 Object.defineProperty(exports, "userRecordConstructor", { enumerable: true, get: function () { return identity_1.userRecordConstructor; } });
-const cloud_functions_1 = require("../cloud-functions");
+Object.defineProperty(exports, "UserRecordMetadata", { enumerable: true, get: function () { return identity_1.UserRecordMetadata; } });
 /** @hidden */
 exports.provider = 'google.firebase.auth';
 /** @hidden */
@@ -33,29 +34,30 @@ exports.service = 'firebaseauth.googleapis.com';
 /**
  * Handle events related to Firebase authentication users.
  */
-function user() {
-    return _userWithOptions({});
+function user(userOptions) {
+    return _userWithOptions({}, userOptions || {});
 }
 exports.user = user;
 /** @hidden */
-function _userWithOptions(options) {
+function _userWithOptions(options, userOptions) {
     return new UserBuilder(() => {
         if (!process.env.GCLOUD_PROJECT) {
             throw new Error('process.env.GCLOUD_PROJECT is not set.');
         }
         return 'projects/' + process.env.GCLOUD_PROJECT;
-    }, options);
+    }, options, userOptions);
 }
 exports._userWithOptions = _userWithOptions;
 /** Builder used to create Cloud Functions for Firebase Auth user lifecycle events. */
 class UserBuilder {
     /** @hidden */
-    constructor(triggerResource, options) {
+    constructor(triggerResource, options, userOptions) {
         this.triggerResource = triggerResource;
         this.options = options;
+        this.userOptions = userOptions;
     }
     static dataConstructor(raw) {
-        return identity_1.userRecordConstructor(raw.data);
+        return (0, identity_1.userRecordConstructor)(raw.data);
     }
     /** Respond to the creation of a Firebase Auth user. */
     onCreate(handler) {
@@ -65,8 +67,14 @@ class UserBuilder {
     onDelete(handler) {
         return this.onOperation(handler, 'user.delete');
     }
+    beforeCreate(handler) {
+        return this.beforeOperation(handler, 'beforeCreate');
+    }
+    beforeSignIn(handler) {
+        return this.beforeOperation(handler, 'beforeSignIn');
+    }
     onOperation(handler, eventType) {
-        return cloud_functions_1.makeCloudFunction({
+        return (0, cloud_functions_1.makeCloudFunction)({
             handler,
             provider: exports.provider,
             eventType,
@@ -77,5 +85,49 @@ class UserBuilder {
             options: this.options,
         });
     }
+    beforeOperation(handler, eventType) {
+        var _a, _b, _c, _d, _e, _f;
+        const accessToken = ((_b = (_a = this.userOptions) === null || _a === void 0 ? void 0 : _a.blockingOptions) === null || _b === void 0 ? void 0 : _b.accessToken) || false;
+        const idToken = ((_d = (_c = this.userOptions) === null || _c === void 0 ? void 0 : _c.blockingOptions) === null || _d === void 0 ? void 0 : _d.idToken) || false;
+        const refreshToken = ((_f = (_e = this.userOptions) === null || _e === void 0 ? void 0 : _e.blockingOptions) === null || _f === void 0 ? void 0 : _f.refreshToken) || false;
+        // Create our own function that just calls the provided function so we know for sure that
+        // handler takes two arguments. This is something common/providers/identity depends on.
+        const wrappedHandler = (user, context) => handler(user, context);
+        const func = (0, identity_1.wrapHandler)(eventType, wrappedHandler);
+        const legacyEventType = `providers/cloud.auth/eventTypes/user.${eventType}`;
+        func.__trigger = {
+            labels: {},
+            ...(0, cloud_functions_1.optionsToTrigger)(this.options),
+            blockingTrigger: {
+                eventType: legacyEventType,
+                options: {
+                    accessToken,
+                    idToken,
+                    refreshToken,
+                },
+            },
+        };
+        func.__endpoint = {
+            platform: 'gcfv1',
+            labels: {},
+            ...(0, cloud_functions_1.optionsToEndpoint)(this.options),
+            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.UserBuilder = UserBuilder;

package/lib/providers/database.js

@@ -104,20 +104,20 @@ class InstanceBuilder {
      * @return Firebase Realtime Database reference builder interface.
      */
     ref(path) {
-        const normalized = path_1.normalizePath(path);
-        return new RefBuilder(apps_1.apps(), () => `projects/_/instances/${this.instance}/refs/${normalized}`, this.options);
+        const normalized = (0, path_1.normalizePath)(path);
+        return new RefBuilder((0, apps_1.apps)(), () => `projects/_/instances/${this.instance}/refs/${normalized}`, this.options);
     }
 }
 exports.InstanceBuilder = InstanceBuilder;
 /** @hidden */
 function _refWithOptions(path, options) {
     const resourceGetter = () => {
-        const normalized = path_1.normalizePath(path);
-        const databaseURL = config_1.firebaseConfig().databaseURL;
+        const normalized = (0, path_1.normalizePath)(path);
+        const databaseURL = (0, config_1.firebaseConfig)().databaseURL;
         if (!databaseURL) {
             throw new Error('Missing expected firebase config value databaseURL, ' +
                 'config is actually' +
-                JSON.stringify(config_1.firebaseConfig()) +
+                JSON.stringify((0, config_1.firebaseConfig)()) +
                 '\n If you are unit testing, please set process.env.FIREBASE_CONFIG');
         }
         let instance;
@@ -136,7 +136,7 @@ function _refWithOptions(path, options) {
         }
         return `projects/_/instances/${instance}/refs/${normalized}`;
     };
-    return new RefBuilder(apps_1.apps(), resourceGetter, options);
+    return new RefBuilder((0, apps_1.apps)(), resourceGetter, options);
 }
 exports._refWithOptions = _refWithOptions;
 /**
@@ -153,7 +153,7 @@ class RefBuilder {
         this.changeConstructor = (raw) => {
             const [dbInstance, path] = extractInstanceAndPath(raw.context.resource.name, raw.context.domain);
             const before = new DataSnapshot(raw.data.data, path, this.apps.admin, dbInstance);
-            const after = new DataSnapshot(utils_1.applyChange(raw.data.data, raw.data.delta), path, this.apps.admin, dbInstance);
+            const after = new DataSnapshot((0, utils_1.applyChange)(raw.data.data, raw.data.delta), path, this.apps.admin, dbInstance);
             return {
                 before,
                 after,
@@ -214,7 +214,7 @@ class RefBuilder {
         return this.onOperation(handler, 'ref.delete', dataConstructor);
     }
     onOperation(handler, eventType, dataConstructor) {
-        return cloud_functions_1.makeCloudFunction({
+        return (0, cloud_functions_1.makeCloudFunction)({
             handler,
             provider: exports.provider,
             service: exports.service,
@@ -311,7 +311,7 @@ class DataSnapshot {
      * However, accessing the key on the root URL of a Database will return `null`.
      */
     get key() {
-        const last = _.last(path_1.pathParts(this._fullPath()));
+        const last = _.last((0, path_1.pathParts)(this._fullPath()));
         return !last || last === '' ? null : last;
     }
     /**
@@ -326,7 +326,7 @@ class DataSnapshot {
      *   Array, string, number, boolean, or `null`).
      */
     val() {
-        const parts = path_1.pathParts(this._childPath);
+        const parts = (0, path_1.pathParts)(this._childPath);
         const source = this._data;
         const node = _.cloneDeep(parts.length ? _.get(source, parts, null) : source);
         return this._checkAndConvertToArray(node);
@@ -494,7 +494,7 @@ class DataSnapshot {
         const dup = new DataSnapshot(this._data, undefined, this.app, this.instance);
         [dup._path, dup._childPath] = [this._path, this._childPath];
         if (childPath) {
-            dup._childPath = path_1.joinPath(dup._childPath, childPath);
+            dup._childPath = (0, path_1.joinPath)(dup._childPath, childPath);
         }
         return dup;
     }

package/lib/providers/firestore.js

@@ -113,8 +113,8 @@ function _getValueProto(data, resource, valueFieldName) {
     }
     const proto = {
         fields: _.get(data, [valueFieldName, 'fields'], {}),
-        createTime: encoder_1.dateToTimestampProto(_.get(data, [valueFieldName, 'createTime'])),
-        updateTime: encoder_1.dateToTimestampProto(_.get(data, [valueFieldName, 'updateTime'])),
+        createTime: (0, encoder_1.dateToTimestampProto)(_.get(data, [valueFieldName, 'createTime'])),
+        updateTime: (0, encoder_1.dateToTimestampProto)(_.get(data, [valueFieldName, 'updateTime'])),
         name: _.get(data, [valueFieldName, 'name'], resource),
     };
     return proto;
@@ -123,7 +123,7 @@ function _getValueProto(data, resource, valueFieldName) {
 function snapshotConstructor(event) {
     var _a;
     if (!firestoreInstance) {
-        firestoreInstance = firebase.firestore(apps_1.apps().admin);
+        firestoreInstance = firebase.firestore((0, apps_1.apps)().admin);
     }
     const valueProto = _getValueProto(event.data, event.context.resource.name, 'value');
     let timeString = (_a = _.get(event, 'data.value.readTime')) !== null && _a !== void 0 ? _a : _.get(event, 'data.value.updateTime');
@@ -131,7 +131,7 @@ function snapshotConstructor(event) {
         logger.warn('Snapshot has no readTime. Using now()');
         timeString = new Date().toISOString();
     }
-    const readTime = encoder_1.dateToTimestampProto(timeString);
+    const readTime = (0, encoder_1.dateToTimestampProto)(timeString);
     return firestoreInstance.snapshot_(valueProto, readTime, 'json');
 }
 exports.snapshotConstructor = snapshotConstructor;
@@ -139,10 +139,10 @@ exports.snapshotConstructor = snapshotConstructor;
 // TODO remove this function when wire format changes to new format
 function beforeSnapshotConstructor(event) {
     if (!firestoreInstance) {
-        firestoreInstance = firebase.firestore(apps_1.apps().admin);
+        firestoreInstance = firebase.firestore((0, apps_1.apps)().admin);
     }
     const oldValueProto = _getValueProto(event.data, event.context.resource.name, 'oldValue');
-    const oldReadTime = encoder_1.dateToTimestampProto(_.get(event, 'data.oldValue.readTime'));
+    const oldReadTime = (0, encoder_1.dateToTimestampProto)(_.get(event, 'data.oldValue.readTime'));
     return firestoreInstance.snapshot_(oldValueProto, oldReadTime, 'json');
 }
 exports.beforeSnapshotConstructor = beforeSnapshotConstructor;
@@ -173,7 +173,7 @@ class DocumentBuilder {
         return this.onOperation(handler, 'document.delete', beforeSnapshotConstructor);
     }
     onOperation(handler, eventType, dataConstructor) {
-        return cloud_functions_1.makeCloudFunction({
+        return (0, cloud_functions_1.makeCloudFunction)({
             handler,
             provider: exports.provider,
             eventType,

package/lib/providers/https.js

@@ -50,17 +50,17 @@ function _onRequestWithOptions(handler, options) {
         return handler(req, res);
     };
     cloudFunction.__trigger = {
-        ...cloud_functions_1.optionsToTrigger(options),
+        ...(0, cloud_functions_1.optionsToTrigger)(options),
         httpsTrigger: {},
     };
-    encoding_1.convertIfPresent(cloudFunction.__trigger.httpsTrigger, options, 'invoker', 'invoker', encoding_1.convertInvoker);
+    (0, encoding_1.convertIfPresent)(cloudFunction.__trigger.httpsTrigger, options, 'invoker', 'invoker', encoding_1.convertInvoker);
     // TODO parse the options
     cloudFunction.__endpoint = {
         platform: 'gcfv1',
-        ...cloud_functions_1.optionsToEndpoint(options),
+        ...(0, cloud_functions_1.optionsToEndpoint)(options),
         httpsTrigger: {},
     };
-    encoding_1.convertIfPresent(cloudFunction.__endpoint.httpsTrigger, options, 'invoker', 'invoker', encoding_1.convertInvoker);
+    (0, encoding_1.convertIfPresent)(cloudFunction.__endpoint.httpsTrigger, options, 'invoker', 'invoker', encoding_1.convertInvoker);
     return cloudFunction;
 }
 exports._onRequestWithOptions = _onRequestWithOptions;
@@ -70,20 +70,20 @@ function _onCallWithOptions(handler, options) {
     // and the user could have only tried to listen to data. Wrap their handler
     // in another handler to avoid accidentally triggering the v2 API
     const fixedLen = (data, context) => handler(data, context);
-    const func = https_1.onCallHandler({
+    const func = (0, https_1.onCallHandler)({
         allowInvalidAppCheckToken: options.allowInvalidAppCheckToken,
         cors: { origin: true, methods: 'POST' },
     }, fixedLen);
     func.__trigger = {
         labels: {},
-        ...cloud_functions_1.optionsToTrigger(options),
+        ...(0, cloud_functions_1.optionsToTrigger)(options),
         httpsTrigger: {},
     };
     func.__trigger.labels['deployment-callable'] = 'true';
     func.__endpoint = {
         platform: 'gcfv1',
         labels: {},
-        ...cloud_functions_1.optionsToEndpoint(options),
+        ...(0, cloud_functions_1.optionsToEndpoint)(options),
         callableTrigger: {},
     };
     func.run = handler;

package/lib/providers/pubsub.js

@@ -71,7 +71,7 @@ class TopicBuilder {
      * @return A Cloud Function that you can export and deploy.
      */
     onPublish(handler) {
-        return cloud_functions_1.makeCloudFunction({
+        return (0, cloud_functions_1.makeCloudFunction)({
             handler,
             provider: exports.provider,
             service: exports.service,
@@ -140,7 +140,7 @@ class ScheduleBuilder {
      * @return A Cloud Function that you can export and deploy.
      */
     onRun(handler) {
-        const cloudFunction = cloud_functions_1.makeCloudFunction({
+        const cloudFunction = (0, cloud_functions_1.makeCloudFunction)({
             contextOnlyHandler: handler,
             provider: exports.provider,
             service: exports.service,

package/lib/providers/remoteConfig.js

@@ -65,7 +65,7 @@ class UpdateBuilder {
      * version metadata as an argument.
      */
     onUpdate(handler) {
-        return cloud_functions_1.makeCloudFunction({
+        return (0, cloud_functions_1.makeCloudFunction)({
             handler,
             provider: exports.provider,
             service: exports.service,

package/lib/providers/storage.js

@@ -53,7 +53,7 @@ exports.object = object;
 /** @hidden */
 function _bucketWithOptions(options, bucket) {
     const resourceGetter = () => {
-        bucket = bucket || config_1.firebaseConfig().storageBucket;
+        bucket = bucket || (0, config_1.firebaseConfig)().storageBucket;
         if (!bucket) {
             throw new Error('Missing bucket name. If you are unit testing, please provide a bucket name' +
                 ' through `functions.storage.bucket(bucketName)`, or set process.env.FIREBASE_CONFIG.');
@@ -170,7 +170,7 @@ class ObjectBuilder {
     }
     /** @hidden */
     onOperation(handler, eventType) {
-        return cloud_functions_1.makeCloudFunction({
+        return (0, cloud_functions_1.makeCloudFunction)({
             handler,
             provider: exports.provider,
             service: exports.service,

package/lib/providers/tasks.d.ts

@@ -1,7 +1,7 @@
 import * as express from 'express';
 import { Request } from '../common/providers/https';
+import { RateLimits, RetryConfig, TaskContext } from '../common/providers/tasks';
 import { ManifestEndpoint, ManifestRequiredAPI } from '../runtime/manifest';
-import { TaskContext, RateLimits, RetryConfig } from '../common/providers/tasks';
 export { 
 /** @hidden */
 RetryConfig as RetryPolicy, 

package/lib/providers/tasks.js

@@ -37,22 +37,22 @@ class TaskQueueBuilder {
         // and the user could have only tried to listen to data. Wrap their handler
         // in another handler to avoid accidentally triggering the v2 API
         const fixedLen = (data, context) => handler(data, context);
-        const func = tasks_1.onDispatchHandler(fixedLen);
+        const func = (0, tasks_1.onDispatchHandler)(fixedLen);
         func.__trigger = {
-            ...cloud_functions_1.optionsToTrigger(this.depOpts || {}),
+            ...(0, cloud_functions_1.optionsToTrigger)(this.depOpts || {}),
             taskQueueTrigger: {},
         };
-        encoding_1.copyIfPresent(func.__trigger.taskQueueTrigger, this.tqOpts, 'retryConfig');
-        encoding_1.copyIfPresent(func.__trigger.taskQueueTrigger, this.tqOpts, 'rateLimits');
-        encoding_1.convertIfPresent(func.__trigger.taskQueueTrigger, this.tqOpts, 'invoker', 'invoker', encoding_1.convertInvoker);
+        (0, encoding_1.copyIfPresent)(func.__trigger.taskQueueTrigger, this.tqOpts, 'retryConfig');
+        (0, encoding_1.copyIfPresent)(func.__trigger.taskQueueTrigger, this.tqOpts, 'rateLimits');
+        (0, encoding_1.convertIfPresent)(func.__trigger.taskQueueTrigger, this.tqOpts, 'invoker', 'invoker', encoding_1.convertInvoker);
         func.__endpoint = {
             platform: 'gcfv1',
-            ...cloud_functions_1.optionsToEndpoint(this.depOpts),
+            ...(0, cloud_functions_1.optionsToEndpoint)(this.depOpts),
             taskQueueTrigger: {},
         };
-        encoding_1.copyIfPresent(func.__endpoint.taskQueueTrigger, this.tqOpts, 'retryConfig');
-        encoding_1.copyIfPresent(func.__endpoint.taskQueueTrigger, this.tqOpts, 'rateLimits');
-        encoding_1.convertIfPresent(func.__endpoint.taskQueueTrigger, this.tqOpts, 'invoker', 'invoker', encoding_1.convertInvoker);
+        (0, encoding_1.copyIfPresent)(func.__endpoint.taskQueueTrigger, this.tqOpts, 'retryConfig');
+        (0, encoding_1.copyIfPresent)(func.__endpoint.taskQueueTrigger, this.tqOpts, 'rateLimits');
+        (0, encoding_1.convertIfPresent)(func.__endpoint.taskQueueTrigger, this.tqOpts, 'invoker', 'invoker', encoding_1.convertInvoker);
         func.__requiredAPIs = [
             {
                 api: 'cloudtasks.googleapis.com',

package/lib/providers/testLab.js

@@ -57,7 +57,7 @@ class TestMatrixBuilder {
         const dataConstructor = (raw) => {
             return new TestMatrix(raw.data);
         };
-        return cloud_functions_1.makeCloudFunction({
+        return (0, cloud_functions_1.makeCloudFunction)({
             provider: exports.PROVIDER,
             eventType: exports.TEST_MATRIX_COMPLETE_EVENT_TYPE,
             triggerResource: this.triggerResource,

package/lib/runtime/loader.js

@@ -22,8 +22,8 @@ exports.loadStack = exports.mergeRequiredAPIs = exports.extractStack = void 0;
 // 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.
-const url = require("url");
 const path = require("path");
+const url = require("url");
 /**
  * Dynamically load import function to prevent TypeScript from
  * transpiling into a require.
@@ -51,17 +51,19 @@ async function loadModule(functionsDir) {
 }
 /* @internal */
 function extractStack(module, endpoints, requiredAPIs, prefix = '') {
-    for (const [name, val] of Object.entries(module)) {
+    for (const [name, valAsUnknown] of Object.entries(module)) {
+        // We're introspecting untrusted code here. Any is appropraite
+        const val = valAsUnknown;
         if (typeof val === 'function' &&
-            val['__endpoint'] &&
-            typeof val['__endpoint'] === 'object') {
+            val.__endpoint &&
+            typeof val.__endpoint === 'object') {
             const funcName = prefix + name;
             endpoints[funcName] = {
-                ...val['__endpoint'],
+                ...val.__endpoint,
                 entryPoint: funcName.replace(/-/g, '.'),
             };
-            if (val['__requiredAPIs'] && Array.isArray(val['__requiredAPIs'])) {
-                requiredAPIs.push(...val['__requiredAPIs']);
+            if (val.__requiredAPIs && Array.isArray(val.__requiredAPIs)) {
+                requiredAPIs.push(...val.__requiredAPIs);
             }
         }
         else if (typeof val === 'object' && val !== null) {

package/lib/runtime/manifest.d.ts

@@ -11,6 +11,7 @@ export interface ManifestEndpoint {
     concurrency?: number;
     serviceAccountEmail?: string;
     timeoutSeconds?: number;
+    cpu?: number | 'gcf_gen1';
     vpc?: {
         connector: string;
         egressSettings?: string;
@@ -46,6 +47,10 @@ export interface ManifestEndpoint {
             maxDoublings?: number;
         };
     };
+    blockingTrigger?: {
+        eventType: string;
+        options?: Record<string, unknown>;
+    };
 }
 export interface ManifestRequiredAPI {
     api: string;

package/lib/setup.js

@@ -31,7 +31,7 @@ function setup() {
     // Until the Cloud Functions builder can publish FIREBASE_CONFIG, automatically provide it on import based on what
     // we can deduce.
     if (!process.env.FIREBASE_CONFIG) {
-        const cfg = config_1.firebaseConfig();
+        const cfg = (0, config_1.firebaseConfig)();
         if (cfg) {
             process.env.FIREBASE_CONFIG = JSON.stringify(cfg);
         }
@@ -43,7 +43,7 @@ function setup() {
     // If FIREBASE_CONFIG is still not found, try using GCLOUD_PROJECT to estimate
     if (!process.env.FIREBASE_CONFIG) {
         if (process.env.GCLOUD_PROJECT) {
-            logger_1.warn('Warning, estimating Firebase Config based on GCLOUD_PROJECT. Initializing firebase-admin may fail');
+            (0, logger_1.warn)('Warning, estimating Firebase Config based on GCLOUD_PROJECT. Initializing firebase-admin may fail');
             process.env.FIREBASE_CONFIG = JSON.stringify({
                 databaseURL: process.env.DATABASE_URL ||
                     `https://${process.env.GCLOUD_PROJECT}.firebaseio.com`,
@@ -53,7 +53,7 @@ function setup() {
             });
         }
         else {
-            logger_1.warn('Warning, FIREBASE_CONFIG and GCLOUD_PROJECT environment variables are missing. Initializing firebase-admin will fail');
+            (0, logger_1.warn)('Warning, FIREBASE_CONFIG and GCLOUD_PROJECT environment variables are missing. Initializing firebase-admin will fail');
         }
     }
 }

package/lib/v2/core.d.ts

@@ -3,7 +3,7 @@ import { ManifestEndpoint } from '../runtime/manifest';
  * A CloudEventBase is the base of a cross-platform format for encoding a serverless event.
  * More information can be found in https://github.com/cloudevents/spec
  */
-interface CloudEventBase<T> {
+export interface CloudEvent<T> {
     /** Version of the CloudEvents spec for this event. */
     readonly specversion: '1.0';
     /** A globally unique ID for this event. */
@@ -18,29 +18,11 @@ interface CloudEventBase<T> {
     time: string;
     /** Information about this specific event. */
     data: T;
-    /**
-     * A map of template parameter name to value for subject strings.
-     *
-     * This map is only available on some event types that allow templates
-     * in the subject string, such as Firestore. When listening to a document
-     * template "/users/{uid}", an event with subject "/documents/users/1234"
-     * would have a params of {"uid": "1234"}.
-     *
-     * Params are generated inside the firebase-functions SDK and are not
-     * part of the CloudEvents spec nor the payload that a Cloud Function
-     * actually receives.
-     */
-    params?: Record<string, string>;
 }
-/**
- * A CloudEvent with custom extension attributes
- */
-export declare type CloudEvent<T = any, Ext = {}> = CloudEventBase<T> & Ext;
 /** A handler for CloudEvents. */
-export interface CloudFunction<T> {
+export interface CloudFunction<EventType extends CloudEvent<unknown>> {
     (raw: CloudEvent<unknown>): any | Promise<any>;
     __trigger?: unknown;
     __endpoint: ManifestEndpoint;
-    run(event: CloudEvent<T>): any | Promise<any>;
+    run(event: EventType): any | Promise<any>;
 }
-export {};

package/lib/v2/index.d.ts

@@ -1,11 +1,12 @@
 import * as logger from '../logger';
 import * as params from './params';
 import * as alerts from './providers/alerts';
+import * as eventarc from './providers/eventarc';
 import * as https from './providers/https';
+import * as identity from './providers/identity';
 import * as pubsub from './providers/pubsub';
 import * as storage from './providers/storage';
 import * as tasks from './providers/tasks';
-import * as eventarc from './providers/eventarc';
-export { alerts, https, pubsub, storage, logger, params, tasks, eventarc };
+export { alerts, https, identity, pubsub, storage, logger, params, tasks, eventarc, };
 export { setGlobalOptions, GlobalOptions } from './options';
 export { CloudFunction, CloudEvent } from './core';

package/lib/v2/index.js

@@ -21,22 +21,24 @@
 // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 // SOFTWARE.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setGlobalOptions = exports.eventarc = exports.tasks = exports.params = exports.logger = exports.storage = exports.pubsub = exports.https = exports.alerts = void 0;
+exports.setGlobalOptions = exports.eventarc = exports.tasks = exports.params = exports.logger = exports.storage = exports.pubsub = exports.identity = exports.https = exports.alerts = void 0;
 const logger = require("../logger");
 exports.logger = logger;
 const params = require("./params");
 exports.params = params;
 const alerts = require("./providers/alerts");
 exports.alerts = alerts;
+const eventarc = require("./providers/eventarc");
+exports.eventarc = eventarc;
 const https = require("./providers/https");
 exports.https = https;
+const identity = require("./providers/identity");
+exports.identity = identity;
 const pubsub = require("./providers/pubsub");
 exports.pubsub = pubsub;
 const storage = require("./providers/storage");
 exports.storage = storage;
 const tasks = require("./providers/tasks");
 exports.tasks = tasks;
-const eventarc = require("./providers/eventarc");
-exports.eventarc = eventarc;
 var options_1 = require("./options");
 Object.defineProperty(exports, "setGlobalOptions", { enumerable: true, get: function () { return options_1.setGlobalOptions; } });

package/lib/v2/options.d.ts

@@ -26,7 +26,7 @@ export declare const MAX_CONCURRENCY = 1000;
 /**
  * List of available memory options supported by Cloud Functions.
  */
-export declare const SUPPORTED_MEMORY_OPTIONS: readonly ["128MB", "256MB", "512MB", "1GB", "2GB", "4GB", "8GB", "16GB", "32GB"];
+export declare const SUPPORTED_MEMORY_OPTIONS: readonly ["128MiB", "256MiB", "512MiB", "1GiB", "2GiB", "4GiB", "8GiB", "16GiB", "32GiB"];
 /**
  * A supported memory option.
  */
@@ -80,9 +80,19 @@ export interface GlobalOptions {
     /**
      * Number of requests a function can serve at once.
      * Can only be applied to functions running on Cloud Functions v2.
-     * A value of null restores the default concurrency.
+     * A value of null restores the default concurrency (80 when CPU >= 1, 1 otherwise).
+     * Concurrency cannot be set to any value other than 1 if `cpu` is less than 1.
      */
     concurrency?: number | null;
+    /**
+     * Fractional number of CPUs to allocate to a function.
+     * Defaults to 1 for functions with <= 2GB RAM and increases for larger memory sizes.
+     * This is different from the defaults when using the gcloud utility and is different from
+     * the fixed amount assigned in Google Cloud Functions generation 1.
+     * To revert to the CPU amounts used in gcloud or in Cloud Functions generation 1, set this
+     * to the value "gcf_gen1"
+     */
+    cpu?: number | 'gcf_gen1';
     /**
      * Connect cloud function to specified VPC connector.
      * A value of null removes the VPC connector
@@ -111,6 +121,7 @@ export interface GlobalOptions {
      * Invoker to set access control on https functions.
      */
     invoker?: 'public' | 'private' | string | string[];
+    secrets?: string[];
 }
 /**
  * Sets default options for all functions written using the v2 SDK.