firebase-functions 7.2.2 → 7.2.4

package/lib/v2/providers/ai/types/vertex/v1beta1/index.js

@@ -0,0 +1,8 @@
+
+//#region src/v2/providers/ai/types/vertex/v1beta1/index.ts
+const requestTypeName = "type.googleapis.com/google.cloud.aiplatform.v1beta1.GenerateContentRequest";
+const responseTypeName = "type.googleapis.com/google.cloud.aiplatform.v1beta1.GenerateContentResponse";
+
+//#endregion
+exports.requestTypeName = requestTypeName;
+exports.responseTypeName = responseTypeName;

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

@@ -6,6 +6,7 @@ import { CloudEvent, CloudFunction } from "../core";
 import { Expression } from "../../params";
 import * as options from "../options";
 import { SupportedSecretParam } from "../../params/types";
+import { V1Compat } from "../compat";
 export { DataSnapshot };
 /** @hidden */
 export interface RawRTDBCloudEventData {
@@ -156,7 +157,21 @@ export interface ReferenceOptions<Ref extends string = string> extends options.E
  * @param reference - The database reference path to trigger on.
  * @param handler - Event handler which is run every time a Realtime Database create, update, or delete occurs.
  */
-export declare function onValueWritten<Ref extends string>(ref: Ref, handler: (event: DatabaseEvent<Change<DataSnapshot>, ParamsOf<Ref>>) => any | Promise<any>): CloudFunction<DatabaseEvent<Change<DataSnapshot>, ParamsOf<Ref>>>;
+export declare function onValueWritten<Ref extends string>(reference: Ref, handler: (event: DatabaseEvent<Change<DataSnapshot>, ParamsOf<Ref>> & V1Compat<"change", Change<DataSnapshot>>) => any | Promise<any>): CloudFunction<DatabaseEvent<Change<DataSnapshot>, ParamsOf<Ref>>>;
+/**
+ * Event handler which triggers when data is created, updated, or deleted in Realtime Database.
+ *
+ * @param reference - The database reference path to trigger on.
+ * @param handler - Event handler which is run every time a Realtime Database create, update, or delete occurs.
+ */
+export declare function onValueWritten<Ref extends string>(reference: Ref, handler: (event: DatabaseEvent<Change<DataSnapshot>, ParamsOf<Ref>>) => any | Promise<any>): CloudFunction<DatabaseEvent<Change<DataSnapshot>, ParamsOf<Ref>>>;
+/**
+ * Event handler which triggers when data is created, updated, or deleted in Realtime Database.
+ *
+ * @param opts - Options that can be set on an individual event-handling function.
+ * @param handler - Event handler which is run every time a Realtime Database create, update, or delete occurs.
+ */
+export declare function onValueWritten<Ref extends string>(opts: ReferenceOptions<Ref>, handler: (event: DatabaseEvent<Change<DataSnapshot>, ParamsOf<Ref>> & V1Compat<"change", Change<DataSnapshot>>) => any | Promise<any>): CloudFunction<DatabaseEvent<Change<DataSnapshot>, ParamsOf<Ref>>>;
 /**
  * Event handler which triggers when data is created, updated, or deleted in Realtime Database.
  *
@@ -170,7 +185,21 @@ export declare function onValueWritten<Ref extends string>(opts: ReferenceOption
  * @param reference - The database reference path to trigger on.
  * @param handler - Event handler which is run every time a Realtime Database create occurs.
  */
-export declare function onValueCreated<Ref extends string>(ref: Ref, handler: (event: DatabaseEvent<DataSnapshot, ParamsOf<Ref>>) => any | Promise<any>): CloudFunction<DatabaseEvent<DataSnapshot, ParamsOf<Ref>>>;
+export declare function onValueCreated<Ref extends string>(reference: Ref, handler: (event: DatabaseEvent<DataSnapshot, ParamsOf<Ref>> & V1Compat<"snapshot", DataSnapshot>) => any | Promise<any>): CloudFunction<DatabaseEvent<DataSnapshot, ParamsOf<Ref>>>;
+/**
+ * Event handler which triggers when data is created in Realtime Database.
+ *
+ * @param reference - The database reference path to trigger on.
+ * @param handler - Event handler which is run every time a Realtime Database create occurs.
+ */
+export declare function onValueCreated<Ref extends string>(reference: Ref, handler: (event: DatabaseEvent<DataSnapshot, ParamsOf<Ref>>) => any | Promise<any>): CloudFunction<DatabaseEvent<DataSnapshot, ParamsOf<Ref>>>;
+/**
+ * Event handler which triggers when data is created in Realtime Database.
+ *
+ * @param opts - Options that can be set on an individual event-handling function.
+ * @param handler - Event handler which is run every time a Realtime Database create occurs.
+ */
+export declare function onValueCreated<Ref extends string>(opts: ReferenceOptions<Ref>, handler: (event: DatabaseEvent<DataSnapshot, ParamsOf<Ref>> & V1Compat<"snapshot", DataSnapshot>) => any | Promise<any>): CloudFunction<DatabaseEvent<DataSnapshot, ParamsOf<Ref>>>;
 /**
  * Event handler which triggers when data is created in Realtime Database.
  *
@@ -184,7 +213,21 @@ export declare function onValueCreated<Ref extends string>(opts: ReferenceOption
  * @param reference - The database reference path to trigger on.
  * @param handler - Event handler which is run every time a Realtime Database update occurs.
  */
-export declare function onValueUpdated<Ref extends string>(ref: Ref, handler: (event: DatabaseEvent<Change<DataSnapshot>, ParamsOf<Ref>>) => any | Promise<any>): CloudFunction<DatabaseEvent<Change<DataSnapshot>, ParamsOf<Ref>>>;
+export declare function onValueUpdated<Ref extends string>(reference: Ref, handler: (event: DatabaseEvent<Change<DataSnapshot>, ParamsOf<Ref>> & V1Compat<"change", Change<DataSnapshot>>) => any | Promise<any>): CloudFunction<DatabaseEvent<Change<DataSnapshot>, ParamsOf<Ref>>>;
+/**
+ * Event handler which triggers when data is updated in Realtime Database.
+ *
+ * @param reference - The database reference path to trigger on.
+ * @param handler - Event handler which is run every time a Realtime Database update occurs.
+ */
+export declare function onValueUpdated<Ref extends string>(reference: Ref, handler: (event: DatabaseEvent<Change<DataSnapshot>, ParamsOf<Ref>>) => any | Promise<any>): CloudFunction<DatabaseEvent<Change<DataSnapshot>, ParamsOf<Ref>>>;
+/**
+ * Event handler which triggers when data is updated in Realtime Database.
+ *
+ * @param opts - Options that can be set on an individual event-handling function.
+ * @param handler - Event handler which is run every time a Realtime Database update occurs.
+ */
+export declare function onValueUpdated<Ref extends string>(opts: ReferenceOptions<Ref>, handler: (event: DatabaseEvent<Change<DataSnapshot>, ParamsOf<Ref>> & V1Compat<"change", Change<DataSnapshot>>) => any | Promise<any>): CloudFunction<DatabaseEvent<Change<DataSnapshot>, ParamsOf<Ref>>>;
 /**
  * Event handler which triggers when data is updated in Realtime Database.
  *
@@ -198,7 +241,21 @@ export declare function onValueUpdated<Ref extends string>(opts: ReferenceOption
  * @param reference - The database reference path to trigger on.
  * @param handler - Event handler which is run every time a Realtime Database deletion occurs.
  */
-export declare function onValueDeleted<Ref extends string>(ref: Ref, handler: (event: DatabaseEvent<DataSnapshot, ParamsOf<Ref>>) => any | Promise<any>): CloudFunction<DatabaseEvent<DataSnapshot, ParamsOf<Ref>>>;
+export declare function onValueDeleted<Ref extends string>(reference: Ref, handler: (event: DatabaseEvent<DataSnapshot, ParamsOf<Ref>> & V1Compat<"snapshot", DataSnapshot>) => any | Promise<any>): CloudFunction<DatabaseEvent<DataSnapshot, ParamsOf<Ref>>>;
+/**
+ * Event handler which triggers when data is deleted in Realtime Database.
+ *
+ * @param reference - The database reference path to trigger on.
+ * @param handler - Event handler which is run every time a Realtime Database deletion occurs.
+ */
+export declare function onValueDeleted<Ref extends string>(reference: Ref, handler: (event: DatabaseEvent<DataSnapshot, ParamsOf<Ref>>) => any | Promise<any>): CloudFunction<DatabaseEvent<DataSnapshot, ParamsOf<Ref>>>;
+/**
+ * Event handler which triggers when data is deleted in Realtime Database.
+ *
+ * @param opts - Options that can be set on an individual event-handling function.
+ * @param handler - Event handler which is run every time a Realtime Database deletion occurs.
+ */
+export declare function onValueDeleted<Ref extends string>(opts: ReferenceOptions<Ref>, handler: (event: DatabaseEvent<DataSnapshot, ParamsOf<Ref>> & V1Compat<"snapshot", DataSnapshot>) => any | Promise<any>): CloudFunction<DatabaseEvent<DataSnapshot, ParamsOf<Ref>>>;
 /**
  * Event handler which triggers when data is deleted in Realtime Database.
  *

package/lib/v2/providers/database.js

@@ -6,6 +6,7 @@ const require_common_utilities_path = require('../../common/utilities/path.js');
 const require_common_providers_database = require('../../common/providers/database.js');
 const require_common_utilities_utils = require('../../common/utilities/utils.js');
 const require_v2_trace = require('../trace.js');
+const require_v2_compat = require('../compat.js');
 const require_v2_options = require('../options.js');
 const require_common_utilities_path_pattern = require('../../common/utilities/path-pattern.js');
 
@@ -135,6 +136,30 @@ function makeChangedDatabaseEvent(event, instance, params) {
 	delete databaseEvent.authid;
 	return databaseEvent;
 }
+function makeV1Context(eventType, databaseEvent) {
+	return {
+		eventId: databaseEvent.id,
+		timestamp: databaseEvent.time,
+		eventType: {
+			[writtenEventType]: "providers/google.firebase.database/eventTypes/ref.write",
+			[createdEventType]: "providers/google.firebase.database/eventTypes/ref.create",
+			[updatedEventType]: "providers/google.firebase.database/eventTypes/ref.update",
+			[deletedEventType]: "providers/google.firebase.database/eventTypes/ref.delete"
+		}[eventType] || eventType,
+		resource: {
+			service: "firebaseio.com",
+			name: `projects/_/instances/${databaseEvent.instance}/refs/${databaseEvent.ref}`
+		},
+		params: databaseEvent.params,
+		...databaseEvent.authType === "admin" ? { authType: "ADMIN" } : databaseEvent.authType === "unauthenticated" ? { authType: "UNAUTHENTICATED" } : databaseEvent.authType === "app_user" ? {
+			authType: "USER",
+			auth: {
+				uid: databaseEvent.authId || "",
+				token: {}
+			}
+		} : {}
+	};
+}
 /** @internal */
 function makeEndpoint(eventType, opts, path, instance) {
 	const baseOpts = require_v2_options.optionsToEndpoint(require_v2_options.getGlobalOptions());
@@ -173,7 +198,11 @@ function onChangedOperation(eventType, referenceOrOpts, handler) {
 		const instanceUrl = getInstance(event);
 		const params = makeParams(event, pathPattern, instancePattern);
 		const databaseEvent = makeChangedDatabaseEvent(event, instanceUrl, params);
-		return require_v2_trace.wrapTraceContext(require_common_onInit.withInit(handler))(databaseEvent);
+		const compatEvent = require_v2_compat.addV1Compat(databaseEvent, {
+			context: () => makeV1Context(eventType, databaseEvent),
+			change: () => databaseEvent.data
+		});
+		return require_v2_trace.wrapTraceContext(require_common_onInit.withInit(handler))(compatEvent);
 	};
 	func.run = handler;
 	func.__endpoint = makeEndpoint(eventType, opts, pathPattern, instancePattern);
@@ -190,7 +219,11 @@ function onOperation(eventType, referenceOrOpts, handler) {
 		const params = makeParams(event, pathPattern, instancePattern);
 		const data = eventType === deletedEventType ? event.data.data : event.data.delta;
 		const databaseEvent = makeDatabaseEvent(event, data, instanceUrl, params);
-		return require_v2_trace.wrapTraceContext(require_common_onInit.withInit(handler))(databaseEvent);
+		const compatEvent = require_v2_compat.addV1Compat(databaseEvent, {
+			context: () => makeV1Context(eventType, databaseEvent),
+			snapshot: () => databaseEvent.data
+		});
+		return require_v2_trace.wrapTraceContext(require_common_onInit.withInit(handler))(compatEvent);
 	};
 	func.run = handler;
 	func.__endpoint = makeEndpoint(eventType, opts, pathPattern, instancePattern);

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

@@ -2,6 +2,7 @@ import * as firestore from "firebase-admin/firestore";
 import { ParamsOf } from "../../common/params";
 import { Change, CloudEvent, CloudFunction } from "../core";
 import { EventHandlerOptions } from "../options";
+import { V1Compat } from "../compat";
 import { Expression } from "../../params";
 export { Change };
 /** A Firestore DocumentSnapshot */
@@ -50,6 +51,13 @@ export interface DocumentOptions<Document extends string = string> extends Event
     /** The Firestore namespace */
     namespace?: string | Expression<string>;
 }
+/**
+ * Event handler that triggers when a document is created, updated, or deleted in Firestore.
+ *
+ * @param document - The Firestore document path to trigger on.
+ * @param handler - Event handler which is run every time a Firestore create, update, or delete occurs.
+ */
+export declare function onDocumentWritten<Document extends string>(document: Document, handler: (event: FirestoreEvent<Change<DocumentSnapshot> | undefined, ParamsOf<Document>> & V1Compat<"change", Change<DocumentSnapshot>>) => any | Promise<any>): CloudFunction<FirestoreEvent<Change<DocumentSnapshot> | undefined, ParamsOf<Document>>>;
 /**
  * Event handler that triggers when a document is created, updated, or deleted in Firestore.
  *
@@ -57,6 +65,13 @@ export interface DocumentOptions<Document extends string = string> extends Event
  * @param handler - Event handler which is run every time a Firestore create, update, or delete occurs.
  */
 export declare function onDocumentWritten<Document extends string>(document: Document, handler: (event: FirestoreEvent<Change<DocumentSnapshot> | undefined, ParamsOf<Document>>) => any | Promise<any>): CloudFunction<FirestoreEvent<Change<DocumentSnapshot> | undefined, ParamsOf<Document>>>;
+/**
+ * Event handler that triggers when a document is created, updated, or deleted in Firestore.
+ *
+ * @param opts - Options that can be set on an individual event-handling function.
+ * @param handler - Event handler which is run every time a Firestore create, update, or delete occurs.
+ */
+export declare function onDocumentWritten<Document extends string>(opts: DocumentOptions<Document>, handler: (event: FirestoreEvent<Change<DocumentSnapshot> | undefined, ParamsOf<Document>> & V1Compat<"change", Change<DocumentSnapshot>>) => any | Promise<any>): CloudFunction<FirestoreEvent<Change<DocumentSnapshot> | undefined, ParamsOf<Document>>>;
 /**
  * Event handler that triggers when a document is created, updated, or deleted in Firestore.
  *
@@ -64,6 +79,14 @@ export declare function onDocumentWritten<Document extends string>(document: Doc
  * @param handler - Event handler which is run every time a Firestore create, update, or delete occurs.
  */
 export declare function onDocumentWritten<Document extends string>(opts: DocumentOptions<Document>, handler: (event: FirestoreEvent<Change<DocumentSnapshot> | undefined, ParamsOf<Document>>) => any | Promise<any>): CloudFunction<FirestoreEvent<Change<DocumentSnapshot> | undefined, ParamsOf<Document>>>;
+/**
+ * Event handler that triggers when a document is created, updated, or deleted in Firestore.
+ * This trigger also provides the authentication context of the principal who triggered the event.
+ *
+ * @param document - The Firestore document path to trigger on.
+ * @param handler - Event handler which is run every time a Firestore create, update, or delete occurs.
+ */
+export declare function onDocumentWrittenWithAuthContext<Document extends string>(document: Document, handler: (event: FirestoreAuthEvent<Change<DocumentSnapshot> | undefined, ParamsOf<Document>> & V1Compat<"change", Change<DocumentSnapshot>>) => any | Promise<any>): CloudFunction<FirestoreAuthEvent<Change<DocumentSnapshot> | undefined, ParamsOf<Document>>>;
 /**
  * Event handler that triggers when a document is created, updated, or deleted in Firestore.
  * This trigger also provides the authentication context of the principal who triggered the event.
@@ -72,6 +95,14 @@ export declare function onDocumentWritten<Document extends string>(opts: Documen
  * @param handler - Event handler which is run every time a Firestore create, update, or delete occurs.
  */
 export declare function onDocumentWrittenWithAuthContext<Document extends string>(document: Document, handler: (event: FirestoreAuthEvent<Change<DocumentSnapshot> | undefined, ParamsOf<Document>>) => any | Promise<any>): CloudFunction<FirestoreAuthEvent<Change<DocumentSnapshot> | undefined, ParamsOf<Document>>>;
+/**
+ * Event handler that triggers when a document is created, updated, or deleted in Firestore.
+ * This trigger also provides the authentication context of the principal who triggered the event.
+ *
+ * @param opts - Options that can be set on an individual event-handling function.
+ * @param handler - Event handler which is run every time a Firestore create, update, or delete occurs.
+ */
+export declare function onDocumentWrittenWithAuthContext<Document extends string>(opts: DocumentOptions<Document>, handler: (event: FirestoreAuthEvent<Change<DocumentSnapshot> | undefined, ParamsOf<Document>> & V1Compat<"change", Change<DocumentSnapshot>>) => any | Promise<any>): CloudFunction<FirestoreAuthEvent<Change<DocumentSnapshot> | undefined, ParamsOf<Document>>>;
 /**
  * Event handler that triggers when a document is created, updated, or deleted in Firestore.
  * This trigger also provides the authentication context of the principal who triggered the event.
@@ -80,6 +111,13 @@ export declare function onDocumentWrittenWithAuthContext<Document extends string
  * @param handler - Event handler which is run every time a Firestore create, update, or delete occurs.
  */
 export declare function onDocumentWrittenWithAuthContext<Document extends string>(opts: DocumentOptions<Document>, handler: (event: FirestoreAuthEvent<Change<DocumentSnapshot> | undefined, ParamsOf<Document>>) => any | Promise<any>): CloudFunction<FirestoreAuthEvent<Change<DocumentSnapshot> | undefined, ParamsOf<Document>>>;
+/**
+ * Event handler that triggers when a document is created in Firestore.
+ *
+ * @param document - The Firestore document path to trigger on.
+ * @param handler - Event handler which is run every time a Firestore create occurs.
+ */
+export declare function onDocumentCreated<Document extends string>(document: Document, handler: (event: FirestoreEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>> & V1Compat<"snapshot", QueryDocumentSnapshot>) => any | Promise<any>): CloudFunction<FirestoreEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>>;
 /**
  * Event handler that triggers when a document is created in Firestore.
  *
@@ -87,6 +125,13 @@ export declare function onDocumentWrittenWithAuthContext<Document extends string
  * @param handler - Event handler which is run every time a Firestore create occurs.
  */
 export declare function onDocumentCreated<Document extends string>(document: Document, handler: (event: FirestoreEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>) => any | Promise<any>): CloudFunction<FirestoreEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>>;
+/**
+ * Event handler that triggers when a document is created in Firestore.
+ *
+ * @param opts - Options that can be set on an individual event-handling function.
+ * @param handler - Event handler which is run every time a Firestore create occurs.
+ */
+export declare function onDocumentCreated<Document extends string>(opts: DocumentOptions<Document>, handler: (event: FirestoreEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>> & V1Compat<"snapshot", QueryDocumentSnapshot>) => any | Promise<any>): CloudFunction<FirestoreEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>>;
 /**
  * Event handler that triggers when a document is created in Firestore.
  *
@@ -94,6 +139,14 @@ export declare function onDocumentCreated<Document extends string>(document: Doc
  * @param handler - Event handler which is run every time a Firestore create occurs.
  */
 export declare function onDocumentCreated<Document extends string>(opts: DocumentOptions<Document>, handler: (event: FirestoreEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>) => any | Promise<any>): CloudFunction<FirestoreEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>>;
+/**
+ * Event handler that triggers when a document is created in Firestore.
+ * This trigger also provides the authentication context of the principal who triggered the event.
+ *
+ * @param document - The Firestore document path to trigger on.
+ * @param handler - Event handler which is run every time a Firestore create occurs.
+ */
+export declare function onDocumentCreatedWithAuthContext<Document extends string>(document: Document, handler: (event: FirestoreAuthEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>> & V1Compat<"snapshot", QueryDocumentSnapshot>) => any | Promise<any>): CloudFunction<FirestoreAuthEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>>;
 /**
  * Event handler that triggers when a document is created in Firestore.
  * This trigger also provides the authentication context of the principal who triggered the event.
@@ -102,6 +155,14 @@ export declare function onDocumentCreated<Document extends string>(opts: Documen
  * @param handler - Event handler which is run every time a Firestore create occurs.
  */
 export declare function onDocumentCreatedWithAuthContext<Document extends string>(document: Document, handler: (event: FirestoreAuthEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>) => any | Promise<any>): CloudFunction<FirestoreAuthEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>>;
+/**
+ * Event handler that triggers when a document is created in Firestore.
+ * This trigger also provides the authentication context of the principal who triggered the event.
+ *
+ * @param opts - Options that can be set on an individual event-handling function.
+ * @param handler - Event handler which is run every time a Firestore create occurs.
+ */
+export declare function onDocumentCreatedWithAuthContext<Document extends string>(opts: DocumentOptions<Document>, handler: (event: FirestoreAuthEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>> & V1Compat<"snapshot", QueryDocumentSnapshot>) => any | Promise<any>): CloudFunction<FirestoreAuthEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>>;
 /**
  * Event handler that triggers when a document is created in Firestore.
  * This trigger also provides the authentication context of the principal who triggered the event.
@@ -110,6 +171,13 @@ export declare function onDocumentCreatedWithAuthContext<Document extends string
  * @param handler - Event handler which is run every time a Firestore create occurs.
  */
 export declare function onDocumentCreatedWithAuthContext<Document extends string>(opts: DocumentOptions<Document>, handler: (event: FirestoreAuthEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>) => any | Promise<any>): CloudFunction<FirestoreAuthEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>>;
+/**
+ * Event handler that triggers when a document is updated in Firestore.
+ *
+ * @param document - The Firestore document path to trigger on.
+ * @param handler - Event handler which is run every time a Firestore update occurs.
+ */
+export declare function onDocumentUpdated<Document extends string>(document: Document, handler: (event: FirestoreEvent<Change<QueryDocumentSnapshot> | undefined, ParamsOf<Document>> & V1Compat<"change", Change<QueryDocumentSnapshot>>) => any | Promise<any>): CloudFunction<FirestoreEvent<Change<QueryDocumentSnapshot> | undefined, ParamsOf<Document>>>;
 /**
  * Event handler that triggers when a document is updated in Firestore.
  *
@@ -117,6 +185,13 @@ export declare function onDocumentCreatedWithAuthContext<Document extends string
  * @param handler - Event handler which is run every time a Firestore update occurs.
  */
 export declare function onDocumentUpdated<Document extends string>(document: Document, handler: (event: FirestoreEvent<Change<QueryDocumentSnapshot> | undefined, ParamsOf<Document>>) => any | Promise<any>): CloudFunction<FirestoreEvent<Change<QueryDocumentSnapshot> | undefined, ParamsOf<Document>>>;
+/**
+ * Event handler that triggers when a document is updated in Firestore.
+ *
+ * @param opts - Options that can be set on an individual event-handling function.
+ * @param handler - Event handler which is run every time a Firestore update occurs.
+ */
+export declare function onDocumentUpdated<Document extends string>(opts: DocumentOptions<Document>, handler: (event: FirestoreEvent<Change<QueryDocumentSnapshot> | undefined, ParamsOf<Document>> & V1Compat<"change", Change<QueryDocumentSnapshot>>) => any | Promise<any>): CloudFunction<FirestoreEvent<Change<QueryDocumentSnapshot> | undefined, ParamsOf<Document>>>;
 /**
  * Event handler that triggers when a document is updated in Firestore.
  *
@@ -124,6 +199,14 @@ export declare function onDocumentUpdated<Document extends string>(document: Doc
  * @param handler - Event handler which is run every time a Firestore update occurs.
  */
 export declare function onDocumentUpdated<Document extends string>(opts: DocumentOptions<Document>, handler: (event: FirestoreEvent<Change<QueryDocumentSnapshot> | undefined, ParamsOf<Document>>) => any | Promise<any>): CloudFunction<FirestoreEvent<Change<QueryDocumentSnapshot> | undefined, ParamsOf<Document>>>;
+/**
+ * Event handler that triggers when a document is updated in Firestore.
+ * This trigger also provides the authentication context of the principal who triggered the event.
+ *
+ * @param document - The Firestore document path to trigger on.
+ * @param handler - Event handler which is run every time a Firestore update occurs.
+ */
+export declare function onDocumentUpdatedWithAuthContext<Document extends string>(document: Document, handler: (event: FirestoreAuthEvent<Change<QueryDocumentSnapshot> | undefined, ParamsOf<Document>> & V1Compat<"change", Change<QueryDocumentSnapshot>>) => any | Promise<any>): CloudFunction<FirestoreAuthEvent<Change<QueryDocumentSnapshot> | undefined, ParamsOf<Document>>>;
 /**
  * Event handler that triggers when a document is updated in Firestore.
  * This trigger also provides the authentication context of the principal who triggered the event.
@@ -132,6 +215,14 @@ export declare function onDocumentUpdated<Document extends string>(opts: Documen
  * @param handler - Event handler which is run every time a Firestore update occurs.
  */
 export declare function onDocumentUpdatedWithAuthContext<Document extends string>(document: Document, handler: (event: FirestoreAuthEvent<Change<QueryDocumentSnapshot> | undefined, ParamsOf<Document>>) => any | Promise<any>): CloudFunction<FirestoreAuthEvent<Change<QueryDocumentSnapshot> | undefined, ParamsOf<Document>>>;
+/**
+ * Event handler that triggers when a document is updated in Firestore.
+ * This trigger also provides the authentication context of the principal who triggered the event.
+ *
+ * @param opts - Options that can be set on an individual event-handling function.
+ * @param handler - Event handler which is run every time a Firestore update occurs.
+ */
+export declare function onDocumentUpdatedWithAuthContext<Document extends string>(opts: DocumentOptions<Document>, handler: (event: FirestoreAuthEvent<Change<QueryDocumentSnapshot> | undefined, ParamsOf<Document>> & V1Compat<"change", Change<QueryDocumentSnapshot>>) => any | Promise<any>): CloudFunction<FirestoreAuthEvent<Change<QueryDocumentSnapshot> | undefined, ParamsOf<Document>>>;
 /**
  * Event handler that triggers when a document is updated in Firestore.
  * This trigger also provides the authentication context of the principal who triggered the event.
@@ -140,6 +231,13 @@ export declare function onDocumentUpdatedWithAuthContext<Document extends string
  * @param handler - Event handler which is run every time a Firestore update occurs.
  */
 export declare function onDocumentUpdatedWithAuthContext<Document extends string>(opts: DocumentOptions<Document>, handler: (event: FirestoreAuthEvent<Change<QueryDocumentSnapshot> | undefined, ParamsOf<Document>>) => any | Promise<any>): CloudFunction<FirestoreAuthEvent<Change<QueryDocumentSnapshot> | undefined, ParamsOf<Document>>>;
+/**
+ * Event handler that triggers when a document is deleted in Firestore.
+ *
+ * @param document - The Firestore document path to trigger on.
+ * @param handler - Event handler which is run every time a Firestore delete occurs.
+ */
+export declare function onDocumentDeleted<Document extends string>(document: Document, handler: (event: FirestoreEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>> & V1Compat<"snapshot", QueryDocumentSnapshot>) => any | Promise<any>): CloudFunction<FirestoreEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>>;
 /**
  * Event handler that triggers when a document is deleted in Firestore.
  *
@@ -147,6 +245,13 @@ export declare function onDocumentUpdatedWithAuthContext<Document extends string
  * @param handler - Event handler which is run every time a Firestore delete occurs.
  */
 export declare function onDocumentDeleted<Document extends string>(document: Document, handler: (event: FirestoreEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>) => any | Promise<any>): CloudFunction<FirestoreEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>>;
+/**
+ * Event handler that triggers when a document is deleted in Firestore.
+ *
+ * @param opts - Options that can be set on an individual event-handling function.
+ * @param handler - Event handler which is run every time a Firestore delete occurs.
+ */
+export declare function onDocumentDeleted<Document extends string>(opts: DocumentOptions<Document>, handler: (event: FirestoreEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>> & V1Compat<"snapshot", QueryDocumentSnapshot>) => any | Promise<any>): CloudFunction<FirestoreEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>>;
 /**
  * Event handler that triggers when a document is deleted in Firestore.
  *
@@ -154,6 +259,14 @@ export declare function onDocumentDeleted<Document extends string>(document: Doc
  * @param handler - Event handler which is run every time a Firestore delete occurs.
  */
 export declare function onDocumentDeleted<Document extends string>(opts: DocumentOptions<Document>, handler: (event: FirestoreEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>) => any | Promise<any>): CloudFunction<FirestoreEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>>;
+/**
+ * Event handler that triggers when a document is deleted in Firestore.
+ * This trigger also provides the authentication context of the principal who triggered the event.
+ *
+ * @param document - The Firestore document path to trigger on.
+ * @param handler - Event handler which is run every time a Firestore delete occurs.
+ */
+export declare function onDocumentDeletedWithAuthContext<Document extends string>(document: Document, handler: (event: FirestoreAuthEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>> & V1Compat<"snapshot", QueryDocumentSnapshot>) => any | Promise<any>): CloudFunction<FirestoreAuthEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>>;
 /**
  * Event handler that triggers when a document is deleted in Firestore.
  * This trigger also provides the authentication context of the principal who triggered the event.
@@ -162,6 +275,14 @@ export declare function onDocumentDeleted<Document extends string>(opts: Documen
  * @param handler - Event handler which is run every time a Firestore delete occurs.
  */
 export declare function onDocumentDeletedWithAuthContext<Document extends string>(document: Document, handler: (event: FirestoreAuthEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>) => any | Promise<any>): CloudFunction<FirestoreAuthEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>>;
+/**
+ * Event handler that triggers when a document is deleted in Firestore.
+ * This trigger also provides the authentication context of the principal who triggered the event.
+ *
+ * @param opts - Options that can be set on an individual event-handling function.
+ * @param handler - Event handler which is run every time a Firestore delete occurs.
+ */
+export declare function onDocumentDeletedWithAuthContext<Document extends string>(opts: DocumentOptions<Document>, handler: (event: FirestoreAuthEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>> & V1Compat<"snapshot", QueryDocumentSnapshot>) => any | Promise<any>): CloudFunction<FirestoreAuthEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>>;
 /**
  * Event handler that triggers when a document is deleted in Firestore.
  * This trigger also provides the authentication context of the principal who triggered the event.
@@ -170,3 +291,9 @@ export declare function onDocumentDeletedWithAuthContext<Document extends string
  * @param handler - Event handler which is run every time a Firestore delete occurs.
  */
 export declare function onDocumentDeletedWithAuthContext<Document extends string>(opts: DocumentOptions<Document>, handler: (event: FirestoreAuthEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>) => any | Promise<any>): CloudFunction<FirestoreAuthEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>>;
+export declare function onOperation<Document extends string>(eventType: string, documentOrOpts: Document | DocumentOptions<Document>, handler: (event: FirestoreEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>) => any | Promise<any>): CloudFunction<FirestoreEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>>;
+export declare function onOperation<Document extends string>(eventType: string, documentOrOpts: Document | DocumentOptions<Document>, handler: (event: FirestoreAuthEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>> & V1Compat<"snapshot", QueryDocumentSnapshot>) => any | Promise<any>): CloudFunction<FirestoreAuthEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>>;
+export declare function onOperation<Document extends string>(eventType: string, documentOrOpts: Document | DocumentOptions<Document>, handler: (event: FirestoreAuthEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>) => any | Promise<any>): CloudFunction<FirestoreAuthEvent<QueryDocumentSnapshot | undefined, ParamsOf<Document>>>;
+export declare function onChangedOperation<Document extends string>(eventType: string, documentOrOpts: Document | DocumentOptions<Document>, handler: (event: FirestoreEvent<Change<QueryDocumentSnapshot> | undefined, ParamsOf<Document>>) => any | Promise<any>): CloudFunction<FirestoreEvent<Change<QueryDocumentSnapshot> | undefined, ParamsOf<Document>>>;
+export declare function onChangedOperation<Document extends string>(eventType: string, documentOrOpts: Document | DocumentOptions<Document>, handler: (event: FirestoreAuthEvent<Change<QueryDocumentSnapshot> | undefined, ParamsOf<Document>> & V1Compat<"change", Change<QueryDocumentSnapshot>>) => any | Promise<any>): CloudFunction<FirestoreAuthEvent<Change<QueryDocumentSnapshot> | undefined, ParamsOf<Document>>>;
+export declare function onChangedOperation<Document extends string>(eventType: string, documentOrOpts: Document | DocumentOptions<Document>, handler: (event: FirestoreAuthEvent<Change<QueryDocumentSnapshot> | undefined, ParamsOf<Document>>) => any | Promise<any>): CloudFunction<FirestoreAuthEvent<Change<QueryDocumentSnapshot> | undefined, ParamsOf<Document>>>;

package/lib/v2/providers/firestore.js

@@ -6,8 +6,9 @@ const require_common_onInit = require('../../common/onInit.js');
 const require_common_utilities_path = require('../../common/utilities/path.js');
 const require_common_providers_firestore = require('../../common/providers/firestore.js');
 const require_v2_trace = require('../trace.js');
-const require_v2_options = require('../options.js');
+const require_v2_compat = require('../compat.js');
 require('../core.js');
+const require_v2_options = require('../options.js');
 const require_common_utilities_path_pattern = require('../../common/utilities/path-pattern.js');
 
 //#region src/v2/providers/firestore.ts
@@ -20,6 +21,7 @@ var firestore_exports = /* @__PURE__ */ require_rolldown_runtime.__export({
 	deletedEventType: () => deletedEventType,
 	deletedEventWithAuthContextType: () => deletedEventWithAuthContextType,
 	getOpts: () => getOpts,
+	getV1Context: () => getV1Context,
 	makeChangedFirestoreEvent: () => makeChangedFirestoreEvent,
 	makeEndpoint: () => makeEndpoint,
 	makeFirestoreEvent: () => makeFirestoreEvent,
@@ -68,7 +70,7 @@ function onDocumentWritten(documentOrOpts, handler) {
 * Event handler that triggers when a document is created, updated, or deleted in Firestore.
 * This trigger also provides the authentication context of the principal who triggered the event.
 *
-* @param opts - Options or a string document path.
+* @param documentOrOpts - Options or a string document path.
 * @param handler - Event handler which is run every time a Firestore create, update, or delete occurs.
 */
 function onDocumentWrittenWithAuthContext(documentOrOpts, handler) {
@@ -262,6 +264,29 @@ function makeEndpoint(eventType, opts, document, database, namespace) {
 	};
 }
 /** @internal */
+function getV1Context(event) {
+	return {
+		eventId: event.id,
+		timestamp: event.time,
+		eventType: {
+			"google.cloud.firestore.document.v1.written": "providers/cloud.firestore/eventTypes/document.write",
+			"google.cloud.firestore.document.v1.created": "providers/cloud.firestore/eventTypes/document.create",
+			"google.cloud.firestore.document.v1.updated": "providers/cloud.firestore/eventTypes/document.update",
+			"google.cloud.firestore.document.v1.deleted": "providers/cloud.firestore/eventTypes/document.delete",
+			"google.cloud.firestore.document.v1.written.withAuthContext": "providers/cloud.firestore/eventTypes/document.write",
+			"google.cloud.firestore.document.v1.created.withAuthContext": "providers/cloud.firestore/eventTypes/document.create",
+			"google.cloud.firestore.document.v1.updated.withAuthContext": "providers/cloud.firestore/eventTypes/document.update",
+			"google.cloud.firestore.document.v1.deleted.withAuthContext": "providers/cloud.firestore/eventTypes/document.delete"
+		}[event.type] || event.type,
+		resource: {
+			service: "firestore.googleapis.com",
+			name: `projects/${event.project}/databases/${event.database}/documents/${event.document}`
+		},
+		params: event.params,
+		authType: event.authType,
+		authId: event.authId
+	};
+}
 function onOperation(eventType, documentOrOpts, handler) {
 	const { document, database, namespace, opts } = getOpts(documentOrOpts);
 	const func = (raw) => {
@@ -269,13 +294,16 @@ function onOperation(eventType, documentOrOpts, handler) {
 		const documentPattern = new require_common_utilities_path_pattern.PathPattern(typeof document === "string" ? document : document.value());
 		const params = makeParams(event.document, documentPattern);
 		const firestoreEvent = makeFirestoreEvent(eventType, event, params);
-		return require_v2_trace.wrapTraceContext(require_common_onInit.withInit(handler))(firestoreEvent);
+		const patchedEvent = require_v2_compat.addV1Compat(firestoreEvent, {
+			context: () => getV1Context(firestoreEvent),
+			snapshot: () => firestoreEvent.data
+		});
+		return require_v2_trace.wrapTraceContext(require_common_onInit.withInit(handler))(patchedEvent);
 	};
 	func.run = handler;
 	func.__endpoint = makeEndpoint(eventType, opts, document, database, namespace);
 	return func;
 }
-/** @internal */
 function onChangedOperation(eventType, documentOrOpts, handler) {
 	const { document, database, namespace, opts } = getOpts(documentOrOpts);
 	const func = (raw) => {
@@ -283,7 +311,11 @@ function onChangedOperation(eventType, documentOrOpts, handler) {
 		const documentPattern = new require_common_utilities_path_pattern.PathPattern(typeof document === "string" ? document : document.value());
 		const params = makeParams(event.document, documentPattern);
 		const firestoreEvent = makeChangedFirestoreEvent(event, params);
-		return require_v2_trace.wrapTraceContext(require_common_onInit.withInit(handler))(firestoreEvent);
+		const patchedEvent = require_v2_compat.addV1Compat(firestoreEvent, {
+			context: () => getV1Context(firestoreEvent),
+			change: () => firestoreEvent.data
+		});
+		return require_v2_trace.wrapTraceContext(require_common_onInit.withInit(handler))(patchedEvent);
 	};
 	func.run = handler;
 	func.__endpoint = makeEndpoint(eventType, opts, document, database, namespace);
@@ -305,6 +337,7 @@ Object.defineProperty(exports, 'firestore_exports', {
   }
 });
 exports.getOpts = getOpts;
+exports.getV1Context = getV1Context;
 exports.makeChangedFirestoreEvent = makeChangedFirestoreEvent;
 exports.makeEndpoint = makeEndpoint;
 exports.makeFirestoreEvent = makeFirestoreEvent;

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

@@ -109,7 +109,7 @@ export interface CallableOptions<T = any> extends HttpsOptions {
      * (Unauthorized) error.
      * When false, requests with invalid tokens set event.app to undefiend.
      */
-    enforceAppCheck?: boolean;
+    enforceAppCheck?: boolean | Expression<boolean>;
     /**
      * Determines whether Firebase App Check token is consumed on request. Defaults to false.
      *
@@ -132,7 +132,7 @@ export interface CallableOptions<T = any> extends HttpsOptions {
      * the request.app.alreadyConsumed property will be set to true and pass the execution to the handler code for making
      * further decisions, such as requiring additional security checks or rejecting the request.
      */
-    consumeAppCheckToken?: boolean;
+    consumeAppCheckToken?: boolean | Expression<boolean>;
     /**
      * Time in seconds between sending heartbeat messages to keep the connection
      * alive. Set to `null` to disable heartbeats.

package/lib/v2/providers/https.js

@@ -129,13 +129,21 @@ function onCall(optsOrHandler, handler) {
 		origin = origin[0];
 	}
 	const fixedLen = (req, resp) => handler(req, resp);
+	let enforceAppCheck = opts.enforceAppCheck ?? require_v2_options.getGlobalOptions().enforceAppCheck;
+	if (enforceAppCheck instanceof require_params_types.Expression) {
+		enforceAppCheck = enforceAppCheck.value();
+	}
+	let consumeAppCheckToken = opts.consumeAppCheckToken;
+	if (consumeAppCheckToken instanceof require_params_types.Expression) {
+		consumeAppCheckToken = consumeAppCheckToken.value();
+	}
 	let func = require_common_providers_https.onCallHandler({
 		cors: {
 			origin,
 			methods: "POST"
 		},
-		enforceAppCheck: opts.enforceAppCheck ?? require_v2_options.getGlobalOptions().enforceAppCheck,
-		consumeAppCheckToken: opts.consumeAppCheckToken,
+		enforceAppCheck,
+		consumeAppCheckToken,
 		heartbeatSeconds: opts.heartbeatSeconds,
 		authPolicy: opts.authPolicy
 	}, fixedLen, "gcfv2");

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

@@ -1,9 +1,9 @@
 import { ResetValue } from "../../common/options";
-import { CloudFunction } from "../core";
+import { CloudEvent, CloudFunction } from "../core";
 import { Expression } from "../../params";
 import * as options from "../options";
 import { SupportedSecretParam } from "../../params/types";
-import { PubSubCloudEvent } from "../compat";
+import { V1Compat } from "../compat";
 /**
  * Google Cloud Pub/Sub is a globally distributed message bus that automatically scales as you need it.
  * You can create a function ({@link onMessagePublished}) that handles pub/sub events by using functions.pubsub.
@@ -182,11 +182,25 @@ export interface PubSubOptions extends options.EventHandlerOptions {
  * @param handler - runs every time a Cloud Pub/Sub message is published
  * @typeParam T - Type representing `Message.data`'s JSON format
  */
-export declare function onMessagePublished<T = any>(topic: string, handler: (event: PubSubCloudEvent<T>) => any | Promise<any>): CloudFunction<PubSubCloudEvent<T>>;
+export declare function onMessagePublished<T = any>(topic: string, handler: (event: CloudEvent<MessagePublishedData<T>> & V1Compat<"message", V1PubSubMessage<T>>) => any | Promise<any>): CloudFunction<CloudEvent<MessagePublishedData<T>>>;
+/**
+ * Handle a message being published to a Pub/Sub topic.
+ * @param topic - The Pub/Sub topic to watch for message events.
+ * @param handler - runs every time a Cloud Pub/Sub message is published
+ * @typeParam T - Type representing `Message.data`'s JSON format
+ */
+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.
+ * @param options - Option containing information (topic) for event
+ * @param handler - runs every time a Cloud Pub/Sub message is published
+ * @typeParam T - Type representing `Message.data`'s JSON format
+ */
+export declare function onMessagePublished<T = any>(options: PubSubOptions, handler: (event: CloudEvent<MessagePublishedData<T>> & V1Compat<"message", V1PubSubMessage<T>>) => any | Promise<any>): CloudFunction<CloudEvent<MessagePublishedData<T>>>;
 /**
  * Handle a message being published to a Pub/Sub topic.
  * @param options - Option containing information (topic) for event
  * @param handler - runs every time a Cloud Pub/Sub message is published
  * @typeParam T - Type representing `Message.data`'s JSON format
  */
-export declare function onMessagePublished<T = any>(options: PubSubOptions, handler: (event: PubSubCloudEvent<T>) => any | Promise<any>): CloudFunction<PubSubCloudEvent<T>>;
+export declare function onMessagePublished<T = any>(options: PubSubOptions, handler: (event: CloudEvent<MessagePublishedData<T>>) => any | Promise<any>): CloudFunction<CloudEvent<MessagePublishedData<T>>>;