firebase-functions 3.19.0 → 3.20.0

package/lib/providers/tasks.d.ts

@@ -0,0 +1,46 @@
+import * as express from 'express';
+import { Request } from '../common/providers/https';
+import { ManifestEndpoint, ManifestRequiredAPI } from '../runtime/manifest';
+import { TaskContext, RateLimits, RetryConfig } from '../common/providers/tasks';
+export { 
+/** @hidden */
+RetryConfig as RetryPolicy, 
+/** @hidden */
+RateLimits, 
+/** @hidden */
+TaskContext, };
+/**
+ * Configurations for Task Queue Functions.
+ * @hidden
+ */
+export interface TaskQueueOptions {
+    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[];
+}
+/** @hidden */
+export interface TaskQueueFunction {
+    (req: Request, res: express.Response): Promise<void>;
+    __trigger: unknown;
+    __endpoint: ManifestEndpoint;
+    __requiredAPIs?: ManifestRequiredAPI[];
+    run(data: any, context: TaskContext): void | Promise<void>;
+}
+/** @hidden */
+export declare class TaskQueueBuilder {
+    private readonly tqOpts?;
+    private readonly depOpts?;
+    onDispatch(handler: (data: any, context: TaskContext) => void | Promise<void>): TaskQueueFunction;
+}
+/**
+ * Declares a function that can handle tasks enqueued using the Firebase Admin SDK.
+ * @param options Configuration for the Task Queue that feeds into this function.
+ * @hidden
+ */
+export declare function taskQueue(options?: TaskQueueOptions): TaskQueueBuilder;

package/lib/providers/tasks.js

@@ -0,0 +1,75 @@
+"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.taskQueue = exports.TaskQueueBuilder = void 0;
+const cloud_functions_1 = require("../cloud-functions");
+const encoding_1 = require("../common/encoding");
+const tasks_1 = require("../common/providers/tasks");
+/** @hidden */
+class TaskQueueBuilder {
+    /** @internal */
+    constructor(tqOpts, depOpts) {
+        this.tqOpts = tqOpts;
+        this.depOpts = depOpts;
+    }
+    onDispatch(handler) {
+        // onEnqueueHandler sniffs the function length of the passed-in callback
+        // 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);
+        func.__trigger = {
+            ...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);
+        func.__endpoint = {
+            platform: 'gcfv1',
+            ...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);
+        func.__requiredAPIs = [
+            {
+                api: 'cloudtasks.googleapis.com',
+                reason: 'Needed for task queue functions',
+            },
+        ];
+        func.run = handler;
+        return func;
+    }
+}
+exports.TaskQueueBuilder = TaskQueueBuilder;
+/**
+ * Declares a function that can handle tasks enqueued using the Firebase Admin SDK.
+ * @param options Configuration for the Task Queue that feeds into this function.
+ * @hidden
+ */
+function taskQueue(options) {
+    return new TaskQueueBuilder(options);
+}
+exports.taskQueue = taskQueue;

package/lib/providers/testLab.js

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

package/lib/runtime/manifest.d.ts

@@ -1,11 +1,3 @@
-/**
- * One or more event filters restrict the set of events delivered to an EventTrigger.
- */
-interface EventFilter {
-    attribute: string;
-    value: string;
-    operator?: string;
-}
 /**
  * An definition of a function as appears in the Manifest.
  */
@@ -35,7 +27,9 @@ export interface ManifestEndpoint {
     };
     callableTrigger?: {};
     eventTrigger?: {
-        eventFilters: EventFilter[];
+        eventFilters: Record<string, string>;
+        eventFilterPathPatterns?: Record<string, string>;
+        channel?: string;
         eventType: string;
         retry: boolean;
         region?: string;
@@ -65,4 +59,3 @@ export interface ManifestStack {
     requiredAPIs: ManifestRequiredAPI[];
     endpoints: Record<string, ManifestEndpoint>;
 }
-export {};

package/lib/runtime/manifest.js

@@ -1,2 +1,23 @@
 "use strict";
+// The MIT License (MIT)
+//
+// Copyright (c) 2021 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 });

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 = (0, config_1.firebaseConfig)();
+        const cfg = 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) {
-            (0, logger_1.warn)('Warning, estimating Firebase Config based on GCLOUD_PROJECT. Initializing firebase-admin may fail');
+            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 {
-            (0, logger_1.warn)('Warning, FIREBASE_CONFIG and GCLOUD_PROJECT environment variables are missing. Initializing firebase-admin will fail');
+            logger_1.warn('Warning, FIREBASE_CONFIG and GCLOUD_PROJECT environment variables are missing. Initializing firebase-admin will fail');
         }
     }
 }

package/lib/v2/index.d.ts

@@ -4,6 +4,7 @@ import * as alerts from './providers/alerts';
 import * as https from './providers/https';
 import * as pubsub from './providers/pubsub';
 import * as storage from './providers/storage';
-export { https, pubsub, storage, logger, params, alerts };
+import * as tasks from './providers/tasks';
+export { alerts, https, pubsub, storage, logger, params, tasks };
 export { setGlobalOptions, GlobalOptions } from './options';
 export { CloudFunction, CloudEvent } from './core';

package/lib/v2/index.js

@@ -21,7 +21,7 @@
 // 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.alerts = exports.params = exports.logger = exports.storage = exports.pubsub = exports.https = void 0;
+exports.setGlobalOptions = exports.tasks = exports.params = exports.logger = exports.storage = exports.pubsub = exports.https = exports.alerts = void 0;
 const logger = require("../logger");
 exports.logger = logger;
 const params = require("./params");
@@ -34,5 +34,7 @@ const pubsub = require("./providers/pubsub");
 exports.pubsub = pubsub;
 const storage = require("./providers/storage");
 exports.storage = storage;
+const tasks = require("./providers/tasks");
+exports.tasks = tasks;
 var options_1 = require("./options");
 Object.defineProperty(exports, "setGlobalOptions", { enumerable: true, get: function () { return options_1.setGlobalOptions; } });

package/lib/v2/options.js

@@ -120,19 +120,19 @@ exports.getGlobalOptions = getGlobalOptions;
  */
 function optionsToTriggerAnnotations(opts) {
     const annotation = {};
-    (0, encoding_1.copyIfPresent)(annotation, opts, 'concurrency', 'minInstances', 'maxInstances', 'ingressSettings', 'labels', 'vpcConnector', 'vpcConnectorEgressSettings');
-    (0, encoding_1.convertIfPresent)(annotation, opts, 'availableMemoryMb', 'memory', (mem) => {
+    encoding_1.copyIfPresent(annotation, opts, 'concurrency', 'minInstances', 'maxInstances', 'ingressSettings', 'labels', 'vpcConnector', 'vpcConnectorEgressSettings');
+    encoding_1.convertIfPresent(annotation, opts, 'availableMemoryMb', 'memory', (mem) => {
         return MemoryOptionToMB[mem];
     });
-    (0, encoding_1.convertIfPresent)(annotation, opts, 'regions', 'region', (region) => {
+    encoding_1.convertIfPresent(annotation, opts, 'regions', 'region', (region) => {
         if (typeof region === 'string') {
             return [region];
         }
         return region;
     });
-    (0, encoding_1.convertIfPresent)(annotation, opts, 'serviceAccountEmail', 'serviceAccount', encoding_1.serviceAccountFromShorthand);
-    (0, encoding_1.convertIfPresent)(annotation, opts, 'timeout', 'timeoutSeconds', encoding_1.durationFromSeconds);
-    (0, encoding_1.convertIfPresent)(annotation, opts, 'failurePolicy', 'retry', (retry) => {
+    encoding_1.convertIfPresent(annotation, opts, 'serviceAccountEmail', 'serviceAccount', encoding_1.serviceAccountFromShorthand);
+    encoding_1.convertIfPresent(annotation, opts, 'timeout', 'timeoutSeconds', encoding_1.durationFromSeconds);
+    encoding_1.convertIfPresent(annotation, opts, 'failurePolicy', 'retry', (retry) => {
         return retry ? { retry: true } : null;
     });
     return annotation;
@@ -144,14 +144,14 @@ exports.optionsToTriggerAnnotations = optionsToTriggerAnnotations;
  */
 function optionsToEndpoint(opts) {
     const endpoint = {};
-    (0, encoding_1.copyIfPresent)(endpoint, opts, 'concurrency', 'minInstances', 'maxInstances', 'ingressSettings', 'labels', 'timeoutSeconds');
-    (0, encoding_1.convertIfPresent)(endpoint, opts, 'serviceAccountEmail', 'serviceAccount');
+    encoding_1.copyIfPresent(endpoint, opts, 'concurrency', 'minInstances', 'maxInstances', 'ingressSettings', 'labels', 'timeoutSeconds');
+    encoding_1.convertIfPresent(endpoint, opts, 'serviceAccountEmail', 'serviceAccount');
     if (opts.vpcConnector) {
         const vpc = { connector: opts.vpcConnector };
-        (0, encoding_1.convertIfPresent)(vpc, opts, 'egressSettings', 'vpcConnectorEgressSettings');
+        encoding_1.convertIfPresent(vpc, opts, 'egressSettings', 'vpcConnectorEgressSettings');
         endpoint.vpc = vpc;
     }
-    (0, encoding_1.convertIfPresent)(endpoint, opts, 'availableMemoryMb', 'memory', (mem) => {
+    encoding_1.convertIfPresent(endpoint, opts, 'availableMemoryMb', 'memory', (mem) => {
         const memoryLookup = {
             '128MB': 128,
             '256MB': 256,
@@ -163,7 +163,7 @@ function optionsToEndpoint(opts) {
         };
         return memoryLookup[mem];
     });
-    (0, encoding_1.convertIfPresent)(endpoint, opts, 'region', 'region', (region) => {
+    encoding_1.convertIfPresent(endpoint, opts, 'region', 'region', (region) => {
         if (typeof region === 'string') {
             return [region];
         }

package/lib/v2/providers/alerts/alerts.js

@@ -36,20 +36,14 @@ function getEndpointAnnotation(opts, alertType, appId) {
         },
         eventTrigger: {
             eventType: exports.eventType,
-            eventFilters: [
-                {
-                    attribute: 'alerttype',
-                    value: alertType,
-                },
-            ],
+            eventFilters: {
+                alerttype: alertType,
+            },
             retry: !!opts.retry,
         },
     };
     if (appId) {
-        endpoint.eventTrigger.eventFilters.push({
-            attribute: 'appid',
-            value: appId,
-        });
+        endpoint.eventTrigger.eventFilters.appid = appId;
     }
     return endpoint;
 }

package/lib/v2/providers/alerts/appDistribution.js

@@ -14,7 +14,7 @@ function onNewTesterIosDevicePublished(appIdOrOptsOrHandler, handler) {
         return handler(raw);
     };
     func.run = handler;
-    func.__endpoint = (0, alerts_1.getEndpointAnnotation)(opts, exports.newTesterIosDeviceAlert, appId);
+    func.__endpoint = alerts_1.getEndpointAnnotation(opts, exports.newTesterIosDeviceAlert, appId);
     return func;
 }
 exports.onNewTesterIosDevicePublished = onNewTesterIosDevicePublished;

package/lib/v2/providers/alerts/billing.js

@@ -24,7 +24,7 @@ function onOperation(alertType, optsOrHandler, handler) {
         return handler(raw);
     };
     func.run = handler;
-    func.__endpoint = (0, _1.getEndpointAnnotation)(optsOrHandler, alertType);
+    func.__endpoint = _1.getEndpointAnnotation(optsOrHandler, alertType);
     return func;
 }
 exports.onOperation = onOperation;

package/lib/v2/providers/alerts/crashlytics.js

@@ -49,7 +49,7 @@ function onOperation(alertType, appIdOrOptsOrHandler, handler) {
         return handler(raw);
     };
     func.run = handler;
-    func.__endpoint = (0, _1.getEndpointAnnotation)(opts, alertType, appId);
+    func.__endpoint = _1.getEndpointAnnotation(opts, alertType, appId);
     return func;
 }
 exports.onOperation = onOperation;

package/lib/v2/providers/alerts/index.js

@@ -1,11 +1,7 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

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

@@ -1,23 +1,12 @@
 import * as express from 'express';
 import * as options from '../options';
-import { CallableRequest, FunctionsErrorCode, HttpsError, Request, TaskRateLimits, TaskRequest, TaskRetryConfig } from '../../common/providers/https';
+import { CallableRequest, FunctionsErrorCode, HttpsError, Request } from '../../common/providers/https';
 import { ManifestEndpoint } from '../../runtime/manifest';
-export { Request, CallableRequest, FunctionsErrorCode, HttpsError, TaskRateLimits, TaskRequest, TaskRetryConfig as TaskRetryPolicy, };
+export { Request, CallableRequest, FunctionsErrorCode, HttpsError };
 export interface HttpsOptions extends Omit<options.GlobalOptions, 'region'> {
     region?: options.SupportedRegion | string | Array<options.SupportedRegion | string>;
     cors?: string | boolean | RegExp | Array<string | RegExp>;
 }
-export interface TaskQueueOptions extends options.GlobalOptions {
-    retryConfig?: TaskRetryConfig;
-    rateLimits?: TaskRateLimits;
-    /**
-     * 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 declare type HttpsFunction = ((req: Request, res: express.Response) => void | Promise<void>) & {
     __trigger?: unknown;
     __endpoint: ManifestEndpoint;
@@ -25,14 +14,7 @@ export declare type HttpsFunction = ((req: Request, res: express.Response) => vo
 export interface CallableFunction<T, Return> extends HttpsFunction {
     run(data: CallableRequest<T>): Return;
 }
-export interface TaskQueueFunction<T = any> extends HttpsFunction {
-    run(data: TaskRequest<T>): void | Promise<void>;
-}
 export declare function onRequest(opts: HttpsOptions, handler: (request: Request, response: express.Response) => void | Promise<void>): HttpsFunction;
 export declare function onRequest(handler: (request: Request, response: express.Response) => void | Promise<void>): HttpsFunction;
 export declare function onCall<T = any, Return = any | Promise<any>>(opts: HttpsOptions, handler: (request: CallableRequest<T>) => Return): CallableFunction<T, Return>;
 export declare function onCall<T = any, Return = any | Promise<any>>(handler: (request: CallableRequest<T>) => Return): CallableFunction<T, Return>;
-/** Handle a request sent to a Cloud Tasks queue. */
-export declare function onTaskDispatched<Args = any>(handler: (request: TaskRequest<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: TaskRequest<Args>) => void | Promise<void>): TaskQueueFunction<Args>;

package/lib/v2/providers/https.js

@@ -21,7 +21,7 @@
 // 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");
@@ -68,7 +68,7 @@ function onRequest(optsOrHandler, handler) {
                     allowInsecure: false,
                 },
             };
-            (0, encoding_1.convertIfPresent)(trigger.httpsTrigger, opts, 'invoker', 'invoker', encoding_1.convertInvoker);
+            encoding_1.convertIfPresent(trigger.httpsTrigger, opts, 'invoker', 'invoker', encoding_1.convertInvoker);
             return trigger;
         },
     });
@@ -86,7 +86,7 @@ function onRequest(optsOrHandler, handler) {
         },
         httpsTrigger: {},
     };
-    (0, encoding_1.convertIfPresent)(endpoint.httpsTrigger, opts, 'invoker', 'invoker', encoding_1.convertInvoker);
+    encoding_1.convertIfPresent(endpoint.httpsTrigger, opts, 'invoker', 'invoker', encoding_1.convertInvoker);
     handler.__endpoint = endpoint;
     return handler;
 }
@@ -104,7 +104,7 @@ function onCall(optsOrHandler, handler) {
     // onCallHandler 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.onCallHandler)({ cors: { origin, methods: 'POST' } }, fixedLen);
+    const func = https_1.onCallHandler({ cors: { origin, methods: 'POST' } }, fixedLen);
     Object.defineProperty(func, '__trigger', {
         get: () => {
             const baseOpts = options.optionsToTriggerAnnotations(options.getGlobalOptions());
@@ -147,42 +147,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/pubsub.js

@@ -104,11 +104,11 @@ function onMessagePublished(topicOrOptions, handler) {
         },
         eventTrigger: {
             eventType: 'google.cloud.pubsub.topic.v1.messagePublished',
-            eventFilters: [{ attribute: 'topic', value: topic }],
+            eventFilters: { topic },
             retry: false,
         },
     };
-    (0, encoding_1.copyIfPresent)(endpoint.eventTrigger, opts, 'retry', 'retry');
+    encoding_1.copyIfPresent(endpoint.eventTrigger, opts, 'retry', 'retry');
     func.__endpoint = endpoint;
     return func;
 }

package/lib/v2/providers/storage.js

@@ -99,11 +99,11 @@ function onOperation(eventType, bucketOrOptsOrHandler, handler) {
                 },
                 eventTrigger: {
                     eventType,
-                    eventFilters: [{ attribute: 'bucket', value: bucket }],
+                    eventFilters: { bucket },
                     retry: false,
                 },
             };
-            (0, encoding_1.copyIfPresent)(endpoint.eventTrigger, opts, 'retry', 'retry');
+            encoding_1.copyIfPresent(endpoint.eventTrigger, opts, 'retry', 'retry');
             return endpoint;
         },
     });
@@ -119,7 +119,7 @@ function getOptsAndBucket(bucketOrOpts) {
         opts = {};
     }
     else {
-        bucket = bucketOrOpts.bucket || (0, config_1.firebaseConfig)().storageBucket;
+        bucket = bucketOrOpts.bucket || config_1.firebaseConfig().storageBucket;
         opts = { ...bucketOrOpts };
         delete opts.bucket;
     }

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

@@ -0,0 +1,22 @@
+import * as options from '../options';
+import { HttpsFunction } from './https';
+import { AuthData, RateLimits, Request, RetryConfig } from '../../common/providers/tasks';
+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,89 @@
+"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 options = require("../options");
+const encoding_1 = require("../../common/encoding");
+const tasks_1 = require("../../common/providers/tasks");
+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 = 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 = {};
+            encoding_1.copyIfPresent(taskQueueTrigger, opts, 'retryConfig', 'rateLimits');
+            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,
+            };
+        },
+    });
+    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: {},
+    };
+    encoding_1.copyIfPresent(func.__endpoint.taskQueueTrigger, opts, 'retryConfig');
+    encoding_1.copyIfPresent(func.__endpoint.taskQueueTrigger, opts, 'rateLimits');
+    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;