firebase-functions 7.1.0 → 7.2.0-rc.0

package/lib/esm/v2/index.doc.mjs

@@ -0,0 +1,24 @@
+import { traceContext } from "../common/trace.mjs";
+import { logger } from "../logger/index.mjs";
+import { params_exports } from "../params/index.mjs";
+import { Change } from "../common/change.mjs";
+import { onInit } from "../common/onInit.mjs";
+import { config } from "../v1/config.mjs";
+import { setGlobalOptions } from "./options.mjs";
+import { pubsub_exports } from "./providers/pubsub.mjs";
+import { alerts_exports } from "./providers/alerts/index.mjs";
+import { database_exports } from "./providers/database.mjs";
+import { eventarc_exports } from "./providers/eventarc.mjs";
+import { https_exports } from "./providers/https.mjs";
+import { identity_exports } from "./providers/identity.mjs";
+import { scheduler_exports } from "./providers/scheduler.mjs";
+import { storage_exports } from "./providers/storage.mjs";
+import { tasks_exports } from "./providers/tasks.mjs";
+import { remoteConfig_exports } from "./providers/remoteConfig.mjs";
+import { testLab_exports } from "./providers/testLab.mjs";
+import { firestore_exports } from "./providers/firestore.mjs";
+import { dataconnect_exports } from "./providers/dataconnect/index.mjs";
+import { app } from "./index.mjs";
+import { graphql_exports } from "./providers/dataconnect/graphql.mjs";
+
+export { Change, alerts_exports as alerts, app, config, database_exports as database, dataconnect_exports as dataconnect, eventarc_exports as eventarc, firestore_exports as firestore, graphql_exports as graphql, https_exports as https, identity_exports as identity, logger, onInit, params_exports as params, pubsub_exports as pubsub, remoteConfig_exports as remoteConfig, scheduler_exports as scheduler, setGlobalOptions, storage_exports as storage, tasks_exports as tasks, testLab_exports as testLab, traceContext };

package/lib/esm/v2/options.mjs

@@ -40,7 +40,15 @@ function getGlobalOptions() {
 */
 function optionsToTriggerAnnotations(opts) {
 	const annotation = {};
-	copyIfPresent(annotation, opts, "concurrency", "minInstances", "maxInstances", "ingressSettings", "labels", "vpcConnector", "vpcConnectorEgressSettings", "secrets");
+	copyIfPresent(annotation, opts, "concurrency", "minInstances", "maxInstances", "ingressSettings", "labels", "vpcConnector", "secrets");
+	const vpcEgress = opts.vpcEgress ?? opts.vpcConnectorEgressSettings;
+	if (vpcEgress !== undefined) {
+		if (vpcEgress === null || vpcEgress instanceof ResetValue) {
+			annotation.vpcConnectorEgressSettings = null;
+		} else {
+			annotation.vpcConnectorEgressSettings = vpcEgress;
+		}
+	}
 	convertIfPresent(annotation, opts, "availableMemoryMb", "memory", (mem) => {
 		return MemoryOptionToMB[mem];
 	});
@@ -65,12 +73,33 @@ function optionsToEndpoint(opts) {
 	const endpoint = {};
 	copyIfPresent(endpoint, opts, "omit", "concurrency", "minInstances", "maxInstances", "ingressSettings", "labels", "timeoutSeconds", "cpu");
 	convertIfPresent(endpoint, opts, "serviceAccountEmail", "serviceAccount");
-	if (opts.vpcConnector !== undefined) {
-		if (opts.vpcConnector === null || opts.vpcConnector instanceof ResetValue) {
+	if (opts.vpcEgress && opts.vpcConnectorEgressSettings) {
+		warn("vpcEgress and vpcConnectorEgressSettings are both set. Using vpcEgress");
+	}
+	const vpcEgress = opts.vpcEgress ?? opts.vpcConnectorEgressSettings;
+	const connector = opts.vpcConnector;
+	const networkInterface = opts.networkInterface;
+	if (connector !== undefined || vpcEgress !== undefined || networkInterface !== undefined) {
+		const resetConnector = connector === null || connector instanceof ResetValue;
+		const hasConnector = !!connector;
+		const resetNetwork = networkInterface === null || networkInterface instanceof ResetValue;
+		const hasNetwork = !!networkInterface && !resetNetwork;
+		if (hasNetwork) {
+			if (!networkInterface.network && !networkInterface.subnetwork) {
+				throw new Error("At least one of network or subnetwork must be specified in networkInterface.");
+			}
+		}
+		if (hasNetwork && hasConnector) {
+			throw new Error("Cannot set both vpcConnector and networkInterface");
+		} else if (resetConnector && !hasNetwork || resetNetwork && !hasConnector) {
 			endpoint.vpc = RESET_VALUE;
 		} else {
-			const vpc = { connector: opts.vpcConnector };
-			convertIfPresent(vpc, opts, "egressSettings", "vpcConnectorEgressSettings");
+			const vpc = {};
+			convertIfPresent(vpc, opts, "connector", "vpcConnector");
+			if (vpcEgress !== undefined) {
+				vpc.egressSettings = vpcEgress;
+			}
+			convertIfPresent(vpc, opts, "networkInterfaces", "networkInterface", (a) => [a]);
 			endpoint.vpc = vpc;
 		}
 	}

package/lib/esm/v2/providers/database.mjs

@@ -106,9 +106,13 @@ function makeDatabaseEvent(event, data, instance, params) {
 		...event,
 		firebaseDatabaseHost: event.firebasedatabasehost,
 		data: snapshot,
-		params
+		params,
+		authType: event.authtype || "unknown",
+		authId: event.authid
 	};
 	delete databaseEvent.firebasedatabasehost;
+	delete databaseEvent.authtype;
+	delete databaseEvent.authid;
 	return databaseEvent;
 }
 /** @hidden */
@@ -122,9 +126,13 @@ function makeChangedDatabaseEvent(event, instance, params) {
 			before,
 			after
 		},
-		params
+		params,
+		authType: event.authtype || "unknown",
+		authId: event.authid
 	};
 	delete databaseEvent.firebasedatabasehost;
+	delete databaseEvent.authtype;
+	delete databaseEvent.authid;
 	return databaseEvent;
 }
 /** @internal */

package/lib/esm/v2/providers/dataconnect/graphql.mjs

@@ -1,3 +1,4 @@
+import { __export } from "../../../_virtual/rolldown_runtime.mjs";
 import { initV2Endpoint } from "../../../runtime/manifest.mjs";
 import { convertIfPresent, convertInvoker } from "../../../common/encoding.mjs";
 import { withInit } from "../../../common/onInit.mjs";
@@ -10,6 +11,10 @@ import { ApolloServer } from "@apollo/server";
 import { expressMiddleware } from "@as-integrations/express4";
 
 //#region src/v2/providers/dataconnect/graphql.ts
+var graphql_exports = /* @__PURE__ */ __export({
+	initGraphqlServer: () => initGraphqlServer,
+	onGraphRequest: () => onGraphRequest
+});
 const FIREBASE_AUTH_HEADER = "X-Firebase-Auth-Token";
 const PRELUDE_GQL = [
 	"scalar UUID",
@@ -95,4 +100,4 @@ function onGraphRequest(opts) {
 }
 
 //#endregion
-export { initGraphqlServer, onGraphRequest };
+export { graphql_exports, initGraphqlServer, onGraphRequest };

package/lib/runtime/manifest.d.ts

@@ -27,8 +27,13 @@ export interface ManifestEndpoint {
     concurrency?: number | Expression<number> | ResetValue;
     timeoutSeconds?: number | Expression<number> | ResetValue;
     vpc?: {
-        connector: string | Expression<string>;
+        connector?: string | Expression<string>;
         egressSettings?: string | Expression<string> | ResetValue;
+        networkInterfaces?: Array<{
+            network?: string | Expression<string> | ResetValue;
+            subnetwork?: string | Expression<string> | ResetValue;
+            tags?: string | string[] | Expression<string> | Expression<string[]> | ResetValue;
+        }> | ResetValue;
     } | ResetValue;
     serviceAccountEmail?: string | Expression<string> | ResetValue;
     cpu?: number | "gcf_gen1";

package/lib/v2/index.doc.d.ts

@@ -0,0 +1 @@
+export * as graphql from "./providers/dataconnect/graphql";

package/lib/v2/index.doc.js

@@ -0,0 +1,120 @@
+const require_common_trace = require('../common/trace.js');
+const require_logger_index = require('../logger/index.js');
+const require_params_index = require('../params/index.js');
+const require_common_change = require('../common/change.js');
+const require_common_onInit = require('../common/onInit.js');
+const require_v1_config = require('../v1/config.js');
+const require_v2_options = require('./options.js');
+const require_v2_providers_pubsub = require('./providers/pubsub.js');
+const require_v2_providers_alerts_index = require('./providers/alerts/index.js');
+const require_v2_providers_database = require('./providers/database.js');
+const require_v2_providers_eventarc = require('./providers/eventarc.js');
+const require_v2_providers_https = require('./providers/https.js');
+const require_v2_providers_identity = require('./providers/identity.js');
+const require_v2_providers_scheduler = require('./providers/scheduler.js');
+const require_v2_providers_storage = require('./providers/storage.js');
+const require_v2_providers_tasks = require('./providers/tasks.js');
+const require_v2_providers_remoteConfig = require('./providers/remoteConfig.js');
+const require_v2_providers_testLab = require('./providers/testLab.js');
+const require_v2_providers_firestore = require('./providers/firestore.js');
+const require_v2_providers_dataconnect_index = require('./providers/dataconnect/index.js');
+const require_v2_index = require('./index.js');
+const require_v2_providers_dataconnect_graphql = require('./providers/dataconnect/graphql.js');
+
+exports.Change = require_common_change.Change;
+Object.defineProperty(exports, 'alerts', {
+  enumerable: true,
+  get: function () {
+    return require_v2_providers_alerts_index.alerts_exports;
+  }
+});
+exports.app = require_v2_index.app;
+exports.config = require_v1_config.config;
+Object.defineProperty(exports, 'database', {
+  enumerable: true,
+  get: function () {
+    return require_v2_providers_database.database_exports;
+  }
+});
+Object.defineProperty(exports, 'dataconnect', {
+  enumerable: true,
+  get: function () {
+    return require_v2_providers_dataconnect_index.dataconnect_exports;
+  }
+});
+Object.defineProperty(exports, 'eventarc', {
+  enumerable: true,
+  get: function () {
+    return require_v2_providers_eventarc.eventarc_exports;
+  }
+});
+Object.defineProperty(exports, 'firestore', {
+  enumerable: true,
+  get: function () {
+    return require_v2_providers_firestore.firestore_exports;
+  }
+});
+Object.defineProperty(exports, 'graphql', {
+  enumerable: true,
+  get: function () {
+    return require_v2_providers_dataconnect_graphql.graphql_exports;
+  }
+});
+Object.defineProperty(exports, 'https', {
+  enumerable: true,
+  get: function () {
+    return require_v2_providers_https.https_exports;
+  }
+});
+Object.defineProperty(exports, 'identity', {
+  enumerable: true,
+  get: function () {
+    return require_v2_providers_identity.identity_exports;
+  }
+});
+exports.logger = require_logger_index.logger;
+exports.onInit = require_common_onInit.onInit;
+Object.defineProperty(exports, 'params', {
+  enumerable: true,
+  get: function () {
+    return require_params_index.params_exports;
+  }
+});
+Object.defineProperty(exports, 'pubsub', {
+  enumerable: true,
+  get: function () {
+    return require_v2_providers_pubsub.pubsub_exports;
+  }
+});
+Object.defineProperty(exports, 'remoteConfig', {
+  enumerable: true,
+  get: function () {
+    return require_v2_providers_remoteConfig.remoteConfig_exports;
+  }
+});
+Object.defineProperty(exports, 'scheduler', {
+  enumerable: true,
+  get: function () {
+    return require_v2_providers_scheduler.scheduler_exports;
+  }
+});
+exports.setGlobalOptions = require_v2_options.setGlobalOptions;
+Object.defineProperty(exports, 'storage', {
+  enumerable: true,
+  get: function () {
+    return require_v2_providers_storage.storage_exports;
+  }
+});
+Object.defineProperty(exports, 'tasks', {
+  enumerable: true,
+  get: function () {
+    return require_v2_providers_tasks.tasks_exports;
+  }
+});
+Object.defineProperty(exports, 'testLab', {
+  enumerable: true,
+  get: function () {
+    return require_v2_providers_testLab.testLab_exports;
+  }
+});
+exports.traceContext = require_common_trace.traceContext;

package/lib/v2/options.d.ts

@@ -18,6 +18,32 @@ export type VpcEgressSetting = "PRIVATE_RANGES_ONLY" | "ALL_TRAFFIC";
  * List of available options for `IngressSettings`.
  */
 export type IngressSetting = "ALLOW_ALL" | "ALLOW_INTERNAL_ONLY" | "ALLOW_INTERNAL_AND_GCLB";
+/**
+ * Interface for a direct VPC network connection.
+ * At least one of network or subnetwork must be specified.
+ */
+export interface NetworkInterface {
+    /**
+     * Network to use for VPC direct connect.
+     * network or subnetwork must be specified to use VPC direct connect, though
+     * both can be specified as well. "default" is an acceptable value.
+     * Mutually exclusive with vpcConnector.
+     */
+    network?: string | Expression<string> | ResetValue;
+    /**
+     * Subnetwork to use for VPC direct connect.
+     * network or subnetwork must be specified to use VPC direct connect, though
+     * both can be specified as well. "default" is an acceptable value.
+     * Mutually exclusive with vpcConnector.
+     */
+    subnetwork?: string | Expression<string> | ResetValue;
+    /**
+     * Tags for VPC traffic.
+     * An optional field for VPC direct connect
+     * mutually exclusive with vpcConnector.
+     */
+    tags?: string | string[] | Expression<string> | Expression<string[]> | ResetValue;
+}
 /**
  * `GlobalOptions` are options that can be set across an entire project.
  * These options are common to HTTPS and event handling functions.
@@ -82,12 +108,21 @@ export interface GlobalOptions {
     cpu?: number | "gcf_gen1";
     /**
      * Connect a function to a specified VPC connector.
+     * Mutually exclusive with networkInterface
      */
     vpcConnector?: string | Expression<string> | ResetValue;
     /**
      * Egress settings for VPC connector.
      */
     vpcConnectorEgressSettings?: VpcEgressSetting | ResetValue;
+    /**
+     * An alias for vpcConnectorEgressSettings.
+     */
+    vpcEgress?: VpcEgressSetting | ResetValue;
+    /**
+     * Network Interface to use with VPC Direct Connect
+     */
+    networkInterface?: NetworkInterface | ResetValue;
     /**
      * Specific service account for the function to run as.
      */

package/lib/v2/options.js

@@ -40,7 +40,15 @@ function getGlobalOptions() {
 */
 function optionsToTriggerAnnotations(opts) {
 	const annotation = {};
-	require_common_encoding.copyIfPresent(annotation, opts, "concurrency", "minInstances", "maxInstances", "ingressSettings", "labels", "vpcConnector", "vpcConnectorEgressSettings", "secrets");
+	require_common_encoding.copyIfPresent(annotation, opts, "concurrency", "minInstances", "maxInstances", "ingressSettings", "labels", "vpcConnector", "secrets");
+	const vpcEgress = opts.vpcEgress ?? opts.vpcConnectorEgressSettings;
+	if (vpcEgress !== undefined) {
+		if (vpcEgress === null || vpcEgress instanceof require_common_options.ResetValue) {
+			annotation.vpcConnectorEgressSettings = null;
+		} else {
+			annotation.vpcConnectorEgressSettings = vpcEgress;
+		}
+	}
 	require_common_encoding.convertIfPresent(annotation, opts, "availableMemoryMb", "memory", (mem) => {
 		return MemoryOptionToMB[mem];
 	});
@@ -65,12 +73,33 @@ function optionsToEndpoint(opts) {
 	const endpoint = {};
 	require_common_encoding.copyIfPresent(endpoint, opts, "omit", "concurrency", "minInstances", "maxInstances", "ingressSettings", "labels", "timeoutSeconds", "cpu");
 	require_common_encoding.convertIfPresent(endpoint, opts, "serviceAccountEmail", "serviceAccount");
-	if (opts.vpcConnector !== undefined) {
-		if (opts.vpcConnector === null || opts.vpcConnector instanceof require_common_options.ResetValue) {
+	if (opts.vpcEgress && opts.vpcConnectorEgressSettings) {
+		require_logger_index.warn("vpcEgress and vpcConnectorEgressSettings are both set. Using vpcEgress");
+	}
+	const vpcEgress = opts.vpcEgress ?? opts.vpcConnectorEgressSettings;
+	const connector = opts.vpcConnector;
+	const networkInterface = opts.networkInterface;
+	if (connector !== undefined || vpcEgress !== undefined || networkInterface !== undefined) {
+		const resetConnector = connector === null || connector instanceof require_common_options.ResetValue;
+		const hasConnector = !!connector;
+		const resetNetwork = networkInterface === null || networkInterface instanceof require_common_options.ResetValue;
+		const hasNetwork = !!networkInterface && !resetNetwork;
+		if (hasNetwork) {
+			if (!networkInterface.network && !networkInterface.subnetwork) {
+				throw new Error("At least one of network or subnetwork must be specified in networkInterface.");
+			}
+		}
+		if (hasNetwork && hasConnector) {
+			throw new Error("Cannot set both vpcConnector and networkInterface");
+		} else if (resetConnector && !hasNetwork || resetNetwork && !hasConnector) {
 			endpoint.vpc = require_common_options.RESET_VALUE;
 		} else {
-			const vpc = { connector: opts.vpcConnector };
-			require_common_encoding.convertIfPresent(vpc, opts, "egressSettings", "vpcConnectorEgressSettings");
+			const vpc = {};
+			require_common_encoding.convertIfPresent(vpc, opts, "connector", "vpcConnector");
+			if (vpcEgress !== undefined) {
+				vpc.egressSettings = vpcEgress;
+			}
+			require_common_encoding.convertIfPresent(vpc, opts, "networkInterfaces", "networkInterface", (a) => [a]);
 			endpoint.vpc = vpc;
 		}
 	}

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

@@ -19,7 +19,17 @@ export interface RawRTDBCloudEvent extends CloudEvent<RawRTDBCloudEventData> {
     instance: string;
     ref: string;
     location: string;
+    authtype: AuthType;
+    authid?: string;
 }
+/**
+ * AuthType defines the possible values for the authType field in a Realtime Database event.
+ * - app_user: an end user of an application..
+ * - admin: an admin user of an application. In the context of impersonate endpoints used by the admin SDK, the impersonator.
+ * - unauthenticated: no credentials were used to authenticate the change that triggered the occurrence.
+ * - unknown: a general type to capture all other principals not captured in the other auth types.
+ */
+export type AuthType = "app_user" | "admin" | "unauthenticated" | "unknown";
 /** A CloudEvent that contains a DataSnapshot or a Change<DataSnapshot> */
 export interface DatabaseEvent<T, Params = Record<string, string>> extends CloudEvent<T> {
     /** The domain of the database instance */
@@ -35,6 +45,14 @@ export interface DatabaseEvent<T, Params = Record<string, string>> extends Cloud
      * Only named capture groups will be populated - {key}, {key=*}, {key=**}
      */
     params: Params;
+    /**
+     * The type of principal that triggered the event.
+     */
+    authType: AuthType;
+    /**
+     * The unique identifier of the principal.
+     */
+    authId?: string;
 }
 /** ReferenceOptions extend EventHandlerOptions with provided ref and optional instance  */
 export interface ReferenceOptions<Ref extends string = string> extends options.EventHandlerOptions {

package/lib/v2/providers/database.js

@@ -106,9 +106,13 @@ function makeDatabaseEvent(event, data, instance, params) {
 		...event,
 		firebaseDatabaseHost: event.firebasedatabasehost,
 		data: snapshot,
-		params
+		params,
+		authType: event.authtype || "unknown",
+		authId: event.authid
 	};
 	delete databaseEvent.firebasedatabasehost;
+	delete databaseEvent.authtype;
+	delete databaseEvent.authid;
 	return databaseEvent;
 }
 /** @hidden */
@@ -122,9 +126,13 @@ function makeChangedDatabaseEvent(event, instance, params) {
 			before,
 			after
 		},
-		params
+		params,
+		authType: event.authtype || "unknown",
+		authId: event.authid
 	};
 	delete databaseEvent.firebasedatabasehost;
+	delete databaseEvent.authtype;
+	delete databaseEvent.authid;
 	return databaseEvent;
 }
 /** @internal */

package/lib/v2/providers/dataconnect/graphql.js

@@ -15,6 +15,10 @@ let __as_integrations_express4 = require("@as-integrations/express4");
 __as_integrations_express4 = require_rolldown_runtime.__toESM(__as_integrations_express4);
 
 //#region src/v2/providers/dataconnect/graphql.ts
+var graphql_exports = /* @__PURE__ */ require_rolldown_runtime.__export({
+	initGraphqlServer: () => initGraphqlServer,
+	onGraphRequest: () => onGraphRequest
+});
 const FIREBASE_AUTH_HEADER = "X-Firebase-Auth-Token";
 const PRELUDE_GQL = [
 	"scalar UUID",
@@ -100,5 +104,11 @@ function onGraphRequest(opts) {
 }
 
 //#endregion
+Object.defineProperty(exports, 'graphql_exports', {
+  enumerable: true,
+  get: function () {
+    return graphql_exports;
+  }
+});
 exports.initGraphqlServer = initGraphqlServer;
 exports.onGraphRequest = onGraphRequest;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firebase-functions",
-  "version": "7.1.0",
+  "version": "7.2.0-rc.0",
   "description": "Firebase SDK for Cloud Functions",
   "keywords": [
     "firebase",