firebase-functions 3.24.1 → 4.0.0-rc.0

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

@@ -1,6 +1,8 @@
-import { CloudEvent, CloudFunction } from '../../core';
-import * as options from '../../options';
-import { Expression } from '../../params';
+import { ResetValue } from "../../../common/options";
+import { CloudEvent, CloudFunction } from "../../core";
+import { Expression } from "../../../params";
+import * as options from "../../options";
+import { SecretParam } from "../../../params/types";
 /**
  * The CloudEvent data emitted by Firebase Alerts.
  * @typeParam T - the payload type that is expected for this alert.
@@ -29,7 +31,7 @@ export interface AlertEvent<T> extends CloudEvent<FirebaseAlertData<T>> {
     data: FirebaseAlertData<T>;
 }
 /** The underlying alert type of the Firebase Alerts provider. */
-export declare type AlertType = 'crashlytics.newFatalIssue' | 'crashlytics.newNonfatalIssue' | 'crashlytics.regression' | 'crashlytics.stabilityDigest' | 'crashlytics.velocity' | 'crashlytics.newAnrIssue' | 'billing.planUpdate' | 'billing.automatedPlanUpdate' | 'appDistribution.newTesterIosDevice' | 'appDistribution.inAppFeedback' | 'performance.threshold' | string;
+export declare type AlertType = "crashlytics.newFatalIssue" | "crashlytics.newNonfatalIssue" | "crashlytics.regression" | "crashlytics.stabilityDigest" | "crashlytics.velocity" | "crashlytics.newAnrIssue" | "billing.planUpdate" | "billing.automatedPlanUpdate" | "appDistribution.newTesterIosDevice" | "appDistribution.inAppFeedback" | "performance.threshold" | string;
 /**
  * Configuration for Firebase Alert functions.
  */
@@ -46,7 +48,7 @@ export interface FirebaseAlertOptions extends options.EventHandlerOptions {
      * Amount of memory to allocate to a function.
      * A value of null restores the defaults of 256MB.
      */
-    memory?: options.MemoryOption | Expression<number> | null;
+    memory?: options.MemoryOption | Expression<number> | ResetValue;
     /**
      * Timeout for the function in sections, possible values are 0 to 540.
      * HTTPS functions can specify a higher timeout.
@@ -57,19 +59,19 @@ export interface FirebaseAlertOptions extends options.EventHandlerOptions {
      * maximum timeout of 36,00s (1 hour). Task queue functions have a maximum
      * timeout of 1,800s (30 minutes)
      */
-    timeoutSeconds?: number | Expression<number> | null;
+    timeoutSeconds?: number | Expression<number> | ResetValue;
     /**
      * Min number of actual instances to be running at a given time.
      * Instances will be billed for memory allocation and 10% of CPU allocation
      * while idle.
      * A value of null restores the default min instances.
      */
-    minInstances?: number | Expression<number> | null;
+    minInstances?: number | Expression<number> | ResetValue;
     /**
      * Max number of instances to be running in parallel.
      * A value of null restores the default max instances.
      */
-    maxInstances?: number | Expression<number> | null;
+    maxInstances?: number | Expression<number> | ResetValue;
     /**
      * Number of requests a function can serve at once.
      * Can only be applied to functions running on Cloud Functions v2.
@@ -77,7 +79,7 @@ export interface FirebaseAlertOptions extends options.EventHandlerOptions {
      * Concurrency cannot be set to any value other than 1 if `cpu` is less than 1.
      * The maximum value for concurrency is 1,000.
      */
-    concurrency?: number | Expression<number> | null;
+    concurrency?: number | Expression<number> | ResetValue;
     /**
      * Fractional number of CPUs to allocate to a function.
      * Defaults to 1 for functions with <= 2GB RAM and increases for larger memory sizes.
@@ -86,34 +88,34 @@ export interface FirebaseAlertOptions extends options.EventHandlerOptions {
      * 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';
+    cpu?: number | "gcf_gen1";
     /**
      * Connect cloud function to specified VPC connector.
      * A value of null removes the VPC connector
      */
-    vpcConnector?: string | null;
+    vpcConnector?: string | ResetValue;
     /**
      * Egress settings for VPC connector.
      * A value of null turns off VPC connector egress settings
      */
-    vpcConnectorEgressSettings?: options.VpcEgressSetting | null;
+    vpcConnectorEgressSettings?: options.VpcEgressSetting | ResetValue;
     /**
      * Specific service account for the function to run as.
      * A value of null restores the default service account.
      */
-    serviceAccount?: string | null;
+    serviceAccount?: string | ResetValue;
     /**
      * Ingress settings which control where this function can be called from.
      * A value of null turns off ingress settings.
      */
-    ingressSettings?: options.IngressSetting | null;
+    ingressSettings?: options.IngressSetting | ResetValue;
     /**
      * User labels to set on the function.
      */
     labels?: Record<string, string>;
-    secrets?: string[];
+    secrets?: (string | SecretParam)[];
     /** Whether failed executions should be delivered again. */
-    retry?: boolean;
+    retry?: boolean | Expression<boolean> | ResetValue;
 }
 /**
  * Declares a function that can handle Firebase Alerts from CloudEvents.
@@ -123,7 +125,7 @@ export interface FirebaseAlertOptions extends options.EventHandlerOptions {
  * @returns A function that you can export and deploy.
  */
 export declare function onAlertPublished<T extends {
-    ['@type']: string;
+    ["@type"]: string;
 } = any>(alertType: AlertType, handler: (event: AlertEvent<T>) => any | Promise<any>): CloudFunction<AlertEvent<T>>;
 /**
  * Declares a function that can handle Firebase Alerts from CloudEvents.
@@ -132,5 +134,5 @@ export declare function onAlertPublished<T extends {
  * @param handler a function that can handle the Firebase Alert inside a CloudEvent.
  */
 export declare function onAlertPublished<T extends {
-    ['@type']: string;
+    ["@type"]: string;
 } = any>(options: FirebaseAlertOptions, handler: (event: AlertEvent<T>) => any | Promise<any>): CloudFunction<AlertEvent<T>>;

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

@@ -22,13 +22,15 @@
 // SOFTWARE.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.convertAlertAndApp = exports.getOptsAndAlertTypeAndApp = exports.getEndpointAnnotation = exports.onAlertPublished = exports.eventType = void 0;
+const manifest_1 = require("../../../runtime/manifest");
+const trace_1 = require("../../trace");
 const options = require("../../options");
 /** @internal */
-exports.eventType = 'google.firebase.firebasealerts.alerts.v1.published';
+exports.eventType = "google.firebase.firebasealerts.alerts.v1.published";
 function onAlertPublished(alertTypeOrOpts, handler) {
     const [opts, alertType, appId] = getOptsAndAlertTypeAndApp(alertTypeOrOpts);
     const func = (raw) => {
-        return handler(convertAlertAndApp(raw));
+        return (0, trace_1.wrapTraceContext)(handler(convertAlertAndApp(raw)));
     };
     func.run = handler;
     func.__endpoint = getEndpointAnnotation(opts, alertType, appId);
@@ -43,7 +45,8 @@ function getEndpointAnnotation(opts, alertType, appId) {
     const baseOpts = options.optionsToEndpoint(options.getGlobalOptions());
     const specificOpts = options.optionsToEndpoint(opts);
     const endpoint = {
-        platform: 'gcfv2',
+        ...(0, manifest_1.initV2Endpoint)(options.getGlobalOptions(), opts),
+        platform: "gcfv2",
         ...baseOpts,
         ...specificOpts,
         labels: {
@@ -72,7 +75,7 @@ function getOptsAndAlertTypeAndApp(alertTypeOrOpts) {
     let opts;
     let alertType;
     let appId;
-    if (typeof alertTypeOrOpts === 'string') {
+    if (typeof alertTypeOrOpts === "string") {
         alertType = alertTypeOrOpts;
         opts = {};
     }
@@ -92,10 +95,10 @@ exports.getOptsAndAlertTypeAndApp = getOptsAndAlertTypeAndApp;
  */
 function convertAlertAndApp(raw) {
     const event = { ...raw };
-    if ('alerttype' in event) {
+    if ("alerttype" in event) {
         event.alertType = event.alerttype;
     }
-    if ('appid' in event) {
+    if ("appid" in event) {
         event.appId = event.appid;
     }
     return event;

package/lib/v2/providers/alerts/appDistribution.d.ts

@@ -2,16 +2,18 @@
  * Cloud functions to handle Firebase App Distribution events from Firebase Alerts.
  * @packageDocumentation
  */
-import { CloudEvent, CloudFunction } from '../../core';
-import * as options from '../../options';
-import { Expression } from '../../params';
-import { FirebaseAlertData } from './alerts';
+import { ResetValue } from "../../../common/options";
+import { Expression } from "../../../params";
+import { CloudEvent, CloudFunction } from "../../core";
+import { FirebaseAlertData } from "./alerts";
+import * as options from "../../options";
+import { SecretParam } from "../../../params/types";
 /**
  * The internal payload object for adding a new tester device to app distribution.
  * Payload is wrapped inside a `FirebaseAlertData` object.
  */
 export interface NewTesterDevicePayload {
-    ['@type']: 'type.googleapis.com/google.events.firebase.firebasealerts.v1.AppDistroNewTesterIosDevicePayload';
+    ["@type"]: "type.googleapis.com/google.events.firebase.firebasealerts.v1.AppDistroNewTesterIosDevicePayload";
     /** Name of the tester */
     testerName: string;
     /** Email of the tester */
@@ -28,7 +30,7 @@ export interface NewTesterDevicePayload {
  * @alpha
  */
 export interface InAppFeedbackPayload {
-    ['@type']: 'type.googleapis.com/google.events.firebase.firebasealerts.v1.AppDistroInAppFeedbackPayload';
+    ["@type"]: "type.googleapis.com/google.events.firebase.firebasealerts.v1.AppDistroInAppFeedbackPayload";
     /** Resource name. Format: `projects/{project_number}/apps/{app_id}/releases/{release_id}/feedbackReports/{feedback_id}` */
     feedbackReport: string;
     /** Deep link back to the Firebase console. */
@@ -69,76 +71,76 @@ export interface AppDistributionOptions extends options.EventHandlerOptions {
     region?: options.SupportedRegion | string;
     /**
      * Amount of memory to allocate to a function.
-     * A value of null restores the defaults of 256MB.
      */
-    memory?: options.MemoryOption | Expression<number> | null;
+    memory?: options.MemoryOption | Expression<number> | ResetValue;
     /**
      * Timeout for the function in sections, possible values are 0 to 540.
      * HTTPS functions can specify a higher timeout.
-     * A value of null restores the default of 60s
+     *
+     * @remarks
      * The minimum timeout for a gen 2 function is 1s. The maximum timeout for a
      * function depends on the type of function: Event handling functions have a
      * maximum timeout of 540s (9 minutes). HTTPS and callable functions have a
      * maximum timeout of 36,00s (1 hour). Task queue functions have a maximum
      * timeout of 1,800s (30 minutes)
      */
-    timeoutSeconds?: number | Expression<number> | null;
+    timeoutSeconds?: number | Expression<number> | ResetValue;
     /**
      * Min number of actual instances to be running at a given time.
+     *
+     * @remarks
      * Instances will be billed for memory allocation and 10% of CPU allocation
      * while idle.
-     * A value of null restores the default min instances.
      */
-    minInstances?: number | Expression<number> | null;
+    minInstances?: number | Expression<number> | ResetValue;
     /**
      * Max number of instances to be running in parallel.
-     * A value of null restores the default max instances.
      */
-    maxInstances?: number | Expression<number> | null;
+    maxInstances?: number | Expression<number> | ResetValue;
     /**
      * Number of requests a function can serve at once.
+     *
+     * @remarks
      * Can only be applied to functions running on Cloud Functions v2.
      * 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.
      * The maximum value for concurrency is 1,000.
      */
-    concurrency?: number | Expression<number> | null;
+    concurrency?: number | Expression<number> | ResetValue;
     /**
      * Fractional number of CPUs to allocate to a function.
+     *
+     * @remarks
      * 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';
+    cpu?: number | "gcf_gen1";
     /**
      * Connect cloud function to specified VPC connector.
-     * A value of null removes the VPC connector
      */
-    vpcConnector?: string | null;
+    vpcConnector?: string | ResetValue;
     /**
      * Egress settings for VPC connector.
-     * A value of null turns off VPC connector egress settings
      */
-    vpcConnectorEgressSettings?: options.VpcEgressSetting | null;
+    vpcConnectorEgressSettings?: options.VpcEgressSetting | ResetValue;
     /**
      * Specific service account for the function to run as.
-     * A value of null restores the default service account.
      */
-    serviceAccount?: string | null;
+    serviceAccount?: string | ResetValue;
     /**
      * Ingress settings which control where this function can be called from.
-     * A value of null turns off ingress settings.
      */
-    ingressSettings?: options.IngressSetting | null;
+    ingressSettings?: options.IngressSetting | ResetValue;
     /**
      * User labels to set on the function.
      */
     labels?: Record<string, string>;
-    secrets?: string[];
+    secrets?: (string | SecretParam)[];
     /** Whether failed executions should be delivered again. */
-    retry?: boolean;
+    retry?: boolean | Expression<boolean> | ResetValue;
 }
 /**
  * Declares a function that can handle adding a new tester iOS device.

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

@@ -22,11 +22,12 @@
 // SOFTWARE.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getOptsAndApp = exports.onInAppFeedbackPublished = exports.onNewTesterIosDevicePublished = exports.inAppFeedbackAlert = exports.newTesterIosDeviceAlert = void 0;
+const trace_1 = require("../../trace");
 const alerts_1 = require("./alerts");
 /** @internal */
-exports.newTesterIosDeviceAlert = 'appDistribution.newTesterIosDevice';
+exports.newTesterIosDeviceAlert = "appDistribution.newTesterIosDevice";
 /** @internal */
-exports.inAppFeedbackAlert = 'appDistribution.inAppFeedback';
+exports.inAppFeedbackAlert = "appDistribution.inAppFeedback";
 /**
  * Declares a function that can handle adding a new tester iOS device.
  * @param appIdOrOptsOrHandler - A specific application, options, or an event-handling function.
@@ -34,13 +35,13 @@ exports.inAppFeedbackAlert = 'appDistribution.inAppFeedback';
  * @returns A function that you can export and deploy.
  */
 function onNewTesterIosDevicePublished(appIdOrOptsOrHandler, handler) {
-    if (typeof appIdOrOptsOrHandler === 'function') {
+    if (typeof appIdOrOptsOrHandler === "function") {
         handler = appIdOrOptsOrHandler;
         appIdOrOptsOrHandler = {};
     }
     const [opts, appId] = getOptsAndApp(appIdOrOptsOrHandler);
     const func = (raw) => {
-        return handler((0, alerts_1.convertAlertAndApp)(raw));
+        return (0, trace_1.wrapTraceContext)(handler((0, alerts_1.convertAlertAndApp)(raw)));
     };
     func.run = handler;
     func.__endpoint = (0, alerts_1.getEndpointAnnotation)(opts, exports.newTesterIosDeviceAlert, appId);
@@ -56,13 +57,13 @@ exports.onNewTesterIosDevicePublished = onNewTesterIosDevicePublished;
  * @alpha
  */
 function onInAppFeedbackPublished(appIdOrOptsOrHandler, handler) {
-    if (typeof appIdOrOptsOrHandler === 'function') {
+    if (typeof appIdOrOptsOrHandler === "function") {
         handler = appIdOrOptsOrHandler;
         appIdOrOptsOrHandler = {};
     }
     const [opts, appId] = getOptsAndApp(appIdOrOptsOrHandler);
     const func = (raw) => {
-        return handler((0, alerts_1.convertAlertAndApp)(raw));
+        return (0, trace_1.wrapTraceContext)(handler((0, alerts_1.convertAlertAndApp)(raw)));
     };
     func.run = handler;
     func.__endpoint = (0, alerts_1.getEndpointAnnotation)(opts, exports.inAppFeedbackAlert, appId);
@@ -76,7 +77,7 @@ exports.onInAppFeedbackPublished = onInAppFeedbackPublished;
 function getOptsAndApp(appIdOrOpts) {
     let opts;
     let appId;
-    if (typeof appIdOrOpts === 'string') {
+    if (typeof appIdOrOpts === "string") {
         opts = {};
         appId = appIdOrOpts;
     }

package/lib/v2/providers/alerts/billing.d.ts

@@ -2,15 +2,15 @@
  * Cloud functions to handle billing events from Firebase Alerts.
  * @packageDocumentation
  */
-import { CloudEvent, CloudFunction } from '../../core';
-import * as options from '../../options';
-import { FirebaseAlertData } from './alerts';
+import { CloudEvent, CloudFunction } from "../../core";
+import { FirebaseAlertData } from "./alerts";
+import * as options from "../../options";
 /**
  * The internal payload object for billing plan updates.
  * Payload is wrapped inside a `FirebaseAlertData` object.
  */
 export interface PlanUpdatePayload {
-    ['@type']: 'type.googleapis.com/google.events.firebase.firebasealerts.v1.BillingPlanUpdatePayload';
+    ["@type"]: "type.googleapis.com/google.events.firebase.firebasealerts.v1.BillingPlanUpdatePayload";
     /** A Firebase billing plan. */
     billingPlan: string;
     /** The email address of the person that triggered billing plan change */
@@ -23,7 +23,7 @@ export interface PlanUpdatePayload {
  * Payload is wrapped inside a `FirebaseAlertData` object.
  */
 export interface PlanAutomatedUpdatePayload {
-    ['@type']: 'type.googleapis.com/google.events.firebase.firebasealerts.v1.BillingPlanAutomatedUpdatePayload';
+    ["@type"]: "type.googleapis.com/google.events.firebase.firebasealerts.v1.BillingPlanAutomatedUpdatePayload";
     /** A Firebase billing plan. */
     billingPlan: string;
     /** The type of the notification, e.g. upgrade, downgrade */

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

@@ -22,11 +22,12 @@
 // SOFTWARE.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.onOperation = exports.onPlanAutomatedUpdatePublished = exports.onPlanUpdatePublished = exports.planAutomatedUpdateAlert = exports.planUpdateAlert = void 0;
+const trace_1 = require("../../trace");
 const alerts_1 = require("./alerts");
 /** @internal */
-exports.planUpdateAlert = 'billing.planUpdate';
+exports.planUpdateAlert = "billing.planUpdate";
 /** @internal */
-exports.planAutomatedUpdateAlert = 'billing.planAutomatedUpdate';
+exports.planAutomatedUpdateAlert = "billing.planAutomatedUpdate";
 /**
  * Declares a function that can handle a billing plan update event.
  * @param optsOrHandler - Options or an event-handling function.
@@ -49,12 +50,12 @@ function onPlanAutomatedUpdatePublished(optsOrHandler, handler) {
 exports.onPlanAutomatedUpdatePublished = onPlanAutomatedUpdatePublished;
 /** @internal */
 function onOperation(alertType, optsOrHandler, handler) {
-    if (typeof optsOrHandler === 'function') {
+    if (typeof optsOrHandler === "function") {
         handler = optsOrHandler;
         optsOrHandler = {};
     }
     const func = (raw) => {
-        return handler((0, alerts_1.convertAlertAndApp)(raw));
+        return (0, trace_1.wrapTraceContext)(handler((0, alerts_1.convertAlertAndApp)(raw)));
     };
     func.run = handler;
     func.__endpoint = (0, alerts_1.getEndpointAnnotation)(optsOrHandler, alertType);

package/lib/v2/providers/alerts/crashlytics.d.ts

@@ -2,10 +2,12 @@
  * Cloud functions to handle Crashlytics events from Firebase Alerts.
  * @packageDocumentation
  */
-import { CloudEvent, CloudFunction } from '../../core';
-import * as options from '../../options';
-import { Expression } from '../../params';
-import { FirebaseAlertData } from './alerts';
+import { ResetValue } from "../../../common/options";
+import { Expression } from "../../../params";
+import { CloudEvent, CloudFunction } from "../../core";
+import { FirebaseAlertData } from "./alerts";
+import * as options from "../../options";
+import { SecretParam } from "../../../params/types";
 /** Generic Crashlytics issue interface */
 export interface Issue {
     /** The ID of the Crashlytics issue */
@@ -22,7 +24,7 @@ export interface Issue {
  * Payload is wrapped inside a `FirebaseAlertData` object.
  */
 export interface NewFatalIssuePayload {
-    ['@type']: 'type.googleapis.com/google.events.firebase.firebasealerts.v1.CrashlyticsNewFatalIssuePayload';
+    ["@type"]: "type.googleapis.com/google.events.firebase.firebasealerts.v1.CrashlyticsNewFatalIssuePayload";
     /** Basic information of the Crashlytics issue */
     issue: Issue;
 }
@@ -31,7 +33,7 @@ export interface NewFatalIssuePayload {
  * Payload is wrapped inside a `FirebaseAlertData` object.
  */
 export interface NewNonfatalIssuePayload {
-    ['@type']: 'type.googleapis.com/google.events.firebase.firebasealerts.v1.CrashlyticsNewNonfatalIssuePayload';
+    ["@type"]: "type.googleapis.com/google.events.firebase.firebasealerts.v1.CrashlyticsNewNonfatalIssuePayload";
     /** Basic information of the Crashlytics issue */
     issue: Issue;
 }
@@ -40,7 +42,7 @@ export interface NewNonfatalIssuePayload {
  * Payload is wrapped inside a `FirebaseAlertData` object.
  */
 export interface RegressionAlertPayload {
-    ['@type']: 'type.googleapis.com/google.events.firebase.firebasealerts.v1.CrashlyticsRegressionAlertPayload';
+    ["@type"]: "type.googleapis.com/google.events.firebase.firebasealerts.v1.CrashlyticsRegressionAlertPayload";
     /** The type of the Crashlytics issue, e.g. new fatal, new nonfatal, ANR */
     type: string;
     /** Basic information of the Crashlytics issue */
@@ -67,7 +69,7 @@ export interface TrendingIssueDetails {
  * Payload is wrapped inside a `FirebaseAlertData` object.
  */
 export interface StabilityDigestPayload {
-    ['@type']: 'type.googleapis.com/google.events.firebase.firebasealerts.v1.CrashlyticsStabilityDigestPayload';
+    ["@type"]: "type.googleapis.com/google.events.firebase.firebasealerts.v1.CrashlyticsStabilityDigestPayload";
     /**
      * The date that the digest gets created. Issues in the digest should have the
      * same date as the digest date
@@ -81,7 +83,7 @@ export interface StabilityDigestPayload {
  * Payload is wrapped inside a `FirebaseAlertData` object.
  */
 export interface VelocityAlertPayload {
-    ['@type']: 'type.googleapis.com/google.events.firebase.firebasealerts.v1.CrashlyticsVelocityAlertPayload';
+    ["@type"]: "type.googleapis.com/google.events.firebase.firebasealerts.v1.CrashlyticsVelocityAlertPayload";
     /** Basic information of the Crashlytics issue */
     issue: Issue;
     /** The time that the Crashlytics issue gets created */
@@ -107,7 +109,7 @@ export interface VelocityAlertPayload {
  * Payload is wrapped inside a `FirebaseAlertData` object.
  */
 export interface NewAnrIssuePayload {
-    ['@type']: 'type.googleapis.com/google.events.firebase.firebasealerts.v1.CrashlyticsNewAnrIssuePayload';
+    ["@type"]: "type.googleapis.com/google.events.firebase.firebasealerts.v1.CrashlyticsNewAnrIssuePayload";
     /** Basic information of the Crashlytics issue */
     issue: Issue;
 }
@@ -133,76 +135,76 @@ export interface CrashlyticsOptions extends options.EventHandlerOptions {
     region?: options.SupportedRegion | string;
     /**
      * Amount of memory to allocate to a function.
-     * A value of null restores the defaults of 256MB.
      */
-    memory?: options.MemoryOption | Expression<number> | null;
+    memory?: options.MemoryOption | Expression<number> | ResetValue;
     /**
      * Timeout for the function in sections, possible values are 0 to 540.
      * HTTPS functions can specify a higher timeout.
-     * A value of null restores the default of 60s
+     *
+     * @remarks
      * The minimum timeout for a gen 2 function is 1s. The maximum timeout for a
      * function depends on the type of function: Event handling functions have a
      * maximum timeout of 540s (9 minutes). HTTPS and callable functions have a
      * maximum timeout of 36,00s (1 hour). Task queue functions have a maximum
      * timeout of 1,800s (30 minutes)
      */
-    timeoutSeconds?: number | Expression<number> | null;
+    timeoutSeconds?: number | Expression<number> | ResetValue;
     /**
      * Min number of actual instances to be running at a given time.
+     *
+     * @remarks
      * Instances will be billed for memory allocation and 10% of CPU allocation
      * while idle.
-     * A value of null restores the default min instances.
      */
-    minInstances?: number | Expression<number> | null;
+    minInstances?: number | Expression<number> | ResetValue;
     /**
      * Max number of instances to be running in parallel.
-     * A value of null restores the default max instances.
      */
-    maxInstances?: number | Expression<number> | null;
+    maxInstances?: number | Expression<number> | ResetValue;
     /**
      * Number of requests a function can serve at once.
+     *
+     * @remarks
      * Can only be applied to functions running on Cloud Functions v2.
      * 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.
      * The maximum value for concurrency is 1,000.
      */
-    concurrency?: number | Expression<number> | null;
+    concurrency?: number | Expression<number> | ResetValue;
     /**
      * Fractional number of CPUs to allocate to a function.
+     *
+     * @remarks
      * 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';
+    cpu?: number | "gcf_gen1";
     /**
      * Connect cloud function to specified VPC connector.
-     * A value of null removes the VPC connector
      */
-    vpcConnector?: string | null;
+    vpcConnector?: string | ResetValue;
     /**
      * Egress settings for VPC connector.
-     * A value of null turns off VPC connector egress settings
      */
-    vpcConnectorEgressSettings?: options.VpcEgressSetting | null;
+    vpcConnectorEgressSettings?: options.VpcEgressSetting | ResetValue;
     /**
      * Specific service account for the function to run as.
-     * A value of null restores the default service account.
      */
-    serviceAccount?: string | null;
+    serviceAccount?: string | ResetValue;
     /**
      * Ingress settings which control where this function can be called from.
-     * A value of null turns off ingress settings.
      */
-    ingressSettings?: options.IngressSetting | null;
+    ingressSettings?: options.IngressSetting | ResetValue;
     /**
      * User labels to set on the function.
      */
     labels?: Record<string, string>;
-    secrets?: string[];
+    secrets?: (string | SecretParam)[];
     /** Whether failed executions should be delivered again. */
-    retry?: boolean;
+    retry?: boolean | Expression<boolean> | ResetValue;
 }
 /**
  * Declares a function that can handle a new fatal issue published to Crashlytics.

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

@@ -22,19 +22,20 @@
 // SOFTWARE.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getOptsAndApp = exports.onOperation = exports.onNewAnrIssuePublished = exports.onVelocityAlertPublished = exports.onStabilityDigestPublished = exports.onRegressionAlertPublished = exports.onNewNonfatalIssuePublished = exports.onNewFatalIssuePublished = exports.newAnrIssueAlert = exports.velocityAlert = exports.stabilityDigestAlert = exports.regressionAlert = exports.newNonfatalIssueAlert = exports.newFatalIssueAlert = void 0;
+const trace_1 = require("../../trace");
 const alerts_1 = require("./alerts");
 /** @internal */
-exports.newFatalIssueAlert = 'crashlytics.newFatalIssue';
+exports.newFatalIssueAlert = "crashlytics.newFatalIssue";
 /** @internal */
-exports.newNonfatalIssueAlert = 'crashlytics.newNonfatalIssue';
+exports.newNonfatalIssueAlert = "crashlytics.newNonfatalIssue";
 /** @internal */
-exports.regressionAlert = 'crashlytics.regression';
+exports.regressionAlert = "crashlytics.regression";
 /** @internal */
-exports.stabilityDigestAlert = 'crashlytics.stabilityDigest';
+exports.stabilityDigestAlert = "crashlytics.stabilityDigest";
 /** @internal */
-exports.velocityAlert = 'crashlytics.velocity';
+exports.velocityAlert = "crashlytics.velocity";
 /** @internal */
-exports.newAnrIssueAlert = 'crashlytics.newAnrIssue';
+exports.newAnrIssueAlert = "crashlytics.newAnrIssue";
 /**
  * Declares a function that can handle a new fatal issue published to Crashlytics.
  * @param appIdOrOptsOrHandler - A specific application, options, or an event-handling function.
@@ -97,13 +98,13 @@ function onNewAnrIssuePublished(appIdOrOptsOrHandler, handler) {
 exports.onNewAnrIssuePublished = onNewAnrIssuePublished;
 /** @internal */
 function onOperation(alertType, appIdOrOptsOrHandler, handler) {
-    if (typeof appIdOrOptsOrHandler === 'function') {
+    if (typeof appIdOrOptsOrHandler === "function") {
         handler = appIdOrOptsOrHandler;
         appIdOrOptsOrHandler = {};
     }
     const [opts, appId] = getOptsAndApp(appIdOrOptsOrHandler);
     const func = (raw) => {
-        return handler((0, alerts_1.convertAlertAndApp)(raw));
+        return (0, trace_1.wrapTraceContext)(handler((0, alerts_1.convertAlertAndApp)(raw)));
     };
     func.run = handler;
     func.__endpoint = (0, alerts_1.getEndpointAnnotation)(opts, alertType, appId);
@@ -117,7 +118,7 @@ exports.onOperation = onOperation;
 function getOptsAndApp(appIdOrOpts) {
     let opts;
     let appId;
-    if (typeof appIdOrOpts === 'string') {
+    if (typeof appIdOrOpts === "string") {
         opts = {};
         appId = appIdOrOpts;
     }

package/lib/v2/providers/alerts/index.d.ts

@@ -4,9 +4,9 @@
  * notify users via Firebase Alerts.
  * @packageDocumentation
  */
-import * as appDistribution from './appDistribution';
-import * as billing from './billing';
-import * as crashlytics from './crashlytics';
-import * as performance from './performance';
+import * as appDistribution from "./appDistribution";
+import * as billing from "./billing";
+import * as crashlytics from "./crashlytics";
+import * as performance from "./performance";
 export { appDistribution, billing, crashlytics, performance };
-export * from './alerts';
+export * from "./alerts";