firebase-functions 7.0.2 → 7.0.4

package/lib/esm/v2/index.mjs

@@ -19,7 +19,7 @@ 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.mjs";
+import { dataconnect_exports } from "./providers/dataconnect/index.mjs";
 
 //#region src/v2/index.ts
 const app = { setEmulatedAdminApp: setApp };

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

@@ -0,0 +1,89 @@
+import { initV2Endpoint } from "../../../runtime/manifest.mjs";
+import { convertIfPresent, convertInvoker } from "../../../common/encoding.mjs";
+import { withInit } from "../../../common/onInit.mjs";
+import { withErrorHandler } from "../../../common/providers/https.mjs";
+import { wrapTraceContext } from "../../trace.mjs";
+import { getGlobalOptions, optionsToEndpoint } from "../../options.mjs";
+import express from "express";
+import fs from "fs";
+import { ApolloServer } from "@apollo/server";
+import { expressMiddleware } from "@as-integrations/express4";
+
+//#region src/v2/providers/dataconnect/graphql.ts
+const FIREBASE_AUTH_HEADER = "X-Firebase-Auth-Token";
+/** @hidden */
+async function initGraphqlServer(opts) {
+	if (!opts.schema && !opts.schemaFilePath || opts.schema && opts.schemaFilePath) {
+		throw new Error("Exactly one of 'schema' or 'schemaFilePath' must be provided.");
+	}
+	if (opts.schemaFilePath) {
+		opts.schema = fs.readFileSync(opts.schemaFilePath, "utf-8");
+	}
+	if (!opts.resolvers.query && !opts.resolvers.mutation) {
+		throw new Error("At least one query or mutation resolver must be provided.");
+	}
+	const apolloResolvers = {};
+	if (opts.resolvers.query) {
+		apolloResolvers.Query = opts.resolvers.query;
+	}
+	if (opts.resolvers.mutation) {
+		apolloResolvers.Mutation = opts.resolvers.mutation;
+	}
+	try {
+		const serverPromise = (async () => {
+			const app = express();
+			const server = new ApolloServer({
+				typeDefs: opts.schema,
+				resolvers: apolloResolvers
+			});
+			await server.start();
+			app.use(`/${opts.path ?? "graphql"}`, express.json(), expressMiddleware(server, { context: ({ req }) => Promise.resolve({ auth: { token: req.header(FIREBASE_AUTH_HEADER) } }) }));
+			return app;
+		})();
+		return serverPromise;
+	} catch (e) {
+		if (e instanceof Error) {
+			throw new Error("Error initializing GraphQL server: " + e.message);
+		} else {
+			throw e;
+		}
+	}
+}
+/**
+* @hidden
+* Handles HTTPS GraphQL requests.
+* @param {GraphqlServerOptions} opts - Options for configuring the GraphQL server.
+* @returns {HttpsFunction} A function you can export and deploy.
+*/
+function onGraphRequest(opts) {
+	let serverPromise = null;
+	const handler = wrapTraceContext(withInit(withErrorHandler(async (req, res) => {
+		serverPromise = serverPromise ?? initGraphqlServer(opts);
+		const app = await serverPromise;
+		app(req, res);
+	})));
+	const globalOpts = getGlobalOptions();
+	const baseOpts = optionsToEndpoint(globalOpts);
+	const specificOpts = optionsToEndpoint(opts);
+	const endpoint = {
+		...initV2Endpoint(globalOpts, opts),
+		platform: "gcfv2",
+		...baseOpts,
+		...specificOpts,
+		labels: {
+			...baseOpts?.labels,
+			...specificOpts?.labels
+		},
+		dataConnectGraphqlTrigger: {}
+	};
+	convertIfPresent(endpoint.dataConnectGraphqlTrigger, globalOpts, "invoker", "invoker", convertInvoker);
+	convertIfPresent(endpoint.dataConnectGraphqlTrigger, opts, "invoker", "invoker", convertInvoker);
+	if (opts.schemaFilePath) {
+		endpoint.dataConnectGraphqlTrigger.schemaFilePath = opts.schemaFilePath;
+	}
+	handler.__endpoint = endpoint;
+	return handler;
+}
+
+//#endregion
+export { initGraphqlServer, onGraphRequest };

package/lib/esm/v2/providers/{dataconnect.mjs → dataconnect/index.mjs}

@@ -1,12 +1,12 @@
-import { __export } from "../../_virtual/rolldown_runtime.mjs";
-import { initV2Endpoint } from "../../runtime/manifest.mjs";
-import { withInit } from "../../common/onInit.mjs";
-import { normalizePath } from "../../common/utilities/path.mjs";
-import { wrapTraceContext } from "../trace.mjs";
-import { getGlobalOptions, optionsToEndpoint } from "../options.mjs";
-import { PathPattern } from "../../common/utilities/path-pattern.mjs";
+import { __export } from "../../../_virtual/rolldown_runtime.mjs";
+import { initV2Endpoint } from "../../../runtime/manifest.mjs";
+import { withInit } from "../../../common/onInit.mjs";
+import { normalizePath } from "../../../common/utilities/path.mjs";
+import { wrapTraceContext } from "../../trace.mjs";
+import { getGlobalOptions, optionsToEndpoint } from "../../options.mjs";
+import { PathPattern } from "../../../common/utilities/path-pattern.mjs";
 
-//#region src/v2/providers/dataconnect.ts
+//#region src/v2/providers/dataconnect/index.ts
 var dataconnect_exports = /* @__PURE__ */ __export({
 	mutationExecutedEventType: () => mutationExecutedEventType,
 	onMutationExecuted: () => onMutationExecuted

package/lib/runtime/manifest.d.ts

@@ -45,6 +45,10 @@ export interface ManifestEndpoint {
     callableTrigger?: {
         genkitAction?: string;
     };
+    dataConnectGraphqlTrigger?: {
+        invoker?: string[];
+        schemaFilePath?: string;
+    };
     eventTrigger?: {
         eventFilters: Record<string, string | Expression<string>>;
         eventFilterPathPatterns?: Record<string, string | Expression<string>>;

package/lib/v2/index.js

@@ -19,7 +19,7 @@ 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 = require('./providers/dataconnect.js');
+const require_v2_providers_dataconnect_index = require('./providers/dataconnect/index.js');
 
 //#region src/v2/index.ts
 const app = { setEmulatedAdminApp: require_common_app.setApp };
@@ -43,7 +43,7 @@ Object.defineProperty(exports, 'database', {
 Object.defineProperty(exports, 'dataconnect', {
   enumerable: true,
   get: function () {
-    return require_v2_providers_dataconnect.dataconnect_exports;
+    return require_v2_providers_dataconnect_index.dataconnect_exports;
   }
 });
 Object.defineProperty(exports, 'eventarc', {

package/lib/v2/providers/dataconnect/graphql.d.ts

@@ -0,0 +1,58 @@
+import express from "express";
+import type { GraphQLResolveInfo } from "graphql";
+import { HttpsFunction, HttpsOptions } from "../https";
+/** @hidden */
+export declare function initGraphqlServer(opts: GraphqlServerOptions): Promise<express.Express>;
+/**
+ * @hidden
+ * Handles HTTPS GraphQL requests.
+ * @param {GraphqlServerOptions} opts - Options for configuring the GraphQL server.
+ * @returns {HttpsFunction} A function you can export and deploy.
+ */
+export declare function onGraphRequest(opts: GraphqlServerOptions): HttpsFunction;
+/**
+ * @hidden
+ * Options for configuring the GraphQL server.
+ */
+export interface GraphqlServerOptions extends Omit<HttpsOptions, "cors"> {
+    /**
+     * A valid SDL string that represents the GraphQL server's schema.
+     * Either `schema` or `schemaFilePath` is required.
+     */
+    schema?: string;
+    /**
+     * A relative file path from the Firebase project directory to a valid GraphQL schema.
+     * Either `schema` or `schemaFilePath` is required.
+     */
+    schemaFilePath?: string;
+    /**
+     * The path where the GraphQL server will be served on the Cloud Run function.
+     * e.g. https://...run.app/{path}
+     * If no path is provided, "graphql" is used as the default.
+     */
+    path?: string;
+    /** A map of functions that populate data for individual GraphQL schema fields. */
+    resolvers: GraphqlResolvers;
+}
+/**
+ * @hidden
+ * Per-request context state shared by all resolvers in a particular query.
+ */
+export interface FirebaseContext {
+    auth: {
+        /** The token attached to the `X-Firebase-Auth-Token` in the request, if present. */
+        token?: string;
+    };
+}
+/**
+ * @hidden
+ * Resolver functions that populate data for individual GraphQL schema fields.
+ */
+export interface GraphqlResolvers {
+    query?: {
+        [resolver: string]: (parent: unknown, args: Record<string, unknown>, context: FirebaseContext, info: GraphQLResolveInfo) => unknown;
+    };
+    mutation?: {
+        [key: string]: (parent: unknown, args: Record<string, unknown>, context: FirebaseContext, info: GraphQLResolveInfo) => unknown;
+    };
+}

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

@@ -0,0 +1,95 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.js');
+const require_runtime_manifest = require('../../../runtime/manifest.js');
+const require_common_encoding = require('../../../common/encoding.js');
+const require_common_onInit = require('../../../common/onInit.js');
+const require_common_providers_https = require('../../../common/providers/https.js');
+const require_v2_trace = require('../../trace.js');
+const require_v2_options = require('../../options.js');
+let express = require("express");
+express = require_rolldown_runtime.__toESM(express);
+let fs = require("fs");
+fs = require_rolldown_runtime.__toESM(fs);
+let __apollo_server = require("@apollo/server");
+__apollo_server = require_rolldown_runtime.__toESM(__apollo_server);
+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
+const FIREBASE_AUTH_HEADER = "X-Firebase-Auth-Token";
+/** @hidden */
+async function initGraphqlServer(opts) {
+	if (!opts.schema && !opts.schemaFilePath || opts.schema && opts.schemaFilePath) {
+		throw new Error("Exactly one of 'schema' or 'schemaFilePath' must be provided.");
+	}
+	if (opts.schemaFilePath) {
+		opts.schema = fs.default.readFileSync(opts.schemaFilePath, "utf-8");
+	}
+	if (!opts.resolvers.query && !opts.resolvers.mutation) {
+		throw new Error("At least one query or mutation resolver must be provided.");
+	}
+	const apolloResolvers = {};
+	if (opts.resolvers.query) {
+		apolloResolvers.Query = opts.resolvers.query;
+	}
+	if (opts.resolvers.mutation) {
+		apolloResolvers.Mutation = opts.resolvers.mutation;
+	}
+	try {
+		const serverPromise = (async () => {
+			const app = (0, express.default)();
+			const server = new __apollo_server.ApolloServer({
+				typeDefs: opts.schema,
+				resolvers: apolloResolvers
+			});
+			await server.start();
+			app.use(`/${opts.path ?? "graphql"}`, express.default.json(), (0, __as_integrations_express4.expressMiddleware)(server, { context: ({ req }) => Promise.resolve({ auth: { token: req.header(FIREBASE_AUTH_HEADER) } }) }));
+			return app;
+		})();
+		return serverPromise;
+	} catch (e) {
+		if (e instanceof Error) {
+			throw new Error("Error initializing GraphQL server: " + e.message);
+		} else {
+			throw e;
+		}
+	}
+}
+/**
+* @hidden
+* Handles HTTPS GraphQL requests.
+* @param {GraphqlServerOptions} opts - Options for configuring the GraphQL server.
+* @returns {HttpsFunction} A function you can export and deploy.
+*/
+function onGraphRequest(opts) {
+	let serverPromise = null;
+	const handler = require_v2_trace.wrapTraceContext(require_common_onInit.withInit(require_common_providers_https.withErrorHandler(async (req, res) => {
+		serverPromise = serverPromise ?? initGraphqlServer(opts);
+		const app = await serverPromise;
+		app(req, res);
+	})));
+	const globalOpts = require_v2_options.getGlobalOptions();
+	const baseOpts = require_v2_options.optionsToEndpoint(globalOpts);
+	const specificOpts = require_v2_options.optionsToEndpoint(opts);
+	const endpoint = {
+		...require_runtime_manifest.initV2Endpoint(globalOpts, opts),
+		platform: "gcfv2",
+		...baseOpts,
+		...specificOpts,
+		labels: {
+			...baseOpts?.labels,
+			...specificOpts?.labels
+		},
+		dataConnectGraphqlTrigger: {}
+	};
+	require_common_encoding.convertIfPresent(endpoint.dataConnectGraphqlTrigger, globalOpts, "invoker", "invoker", require_common_encoding.convertInvoker);
+	require_common_encoding.convertIfPresent(endpoint.dataConnectGraphqlTrigger, opts, "invoker", "invoker", require_common_encoding.convertInvoker);
+	if (opts.schemaFilePath) {
+		endpoint.dataConnectGraphqlTrigger.schemaFilePath = opts.schemaFilePath;
+	}
+	handler.__endpoint = endpoint;
+	return handler;
+}
+
+//#endregion
+exports.initGraphqlServer = initGraphqlServer;
+exports.onGraphRequest = onGraphRequest;

package/lib/v2/providers/{dataconnect.d.ts → dataconnect/index.d.ts}

@@ -1,8 +1,8 @@
-import { CloudEvent, CloudFunction } from "../core";
-import { ParamsOf, VarName } from "../../common/params";
-import { EventHandlerOptions, SupportedRegion } from "../options";
-import { Expression } from "../../params";
-import { ResetValue } from "../../common/options";
+import { CloudEvent, CloudFunction } from "../../core";
+import { ParamsOf, VarName } from "../../../common/params";
+import { EventHandlerOptions, SupportedRegion } from "../../options";
+import { Expression } from "../../../params";
+import { ResetValue } from "../../../common/options";
 /** @hidden */
 export interface SourceLocation {
     line: number;

package/lib/v2/providers/{dataconnect.js → dataconnect/index.js}

@@ -1,12 +1,12 @@
-const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.js');
-const require_runtime_manifest = require('../../runtime/manifest.js');
-const require_common_onInit = require('../../common/onInit.js');
-const require_common_utilities_path = require('../../common/utilities/path.js');
-const require_v2_trace = require('../trace.js');
-const require_v2_options = require('../options.js');
-const require_common_utilities_path_pattern = require('../../common/utilities/path-pattern.js');
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.js');
+const require_runtime_manifest = require('../../../runtime/manifest.js');
+const require_common_onInit = require('../../../common/onInit.js');
+const require_common_utilities_path = require('../../../common/utilities/path.js');
+const require_v2_trace = require('../../trace.js');
+const require_v2_options = require('../../options.js');
+const require_common_utilities_path_pattern = require('../../../common/utilities/path-pattern.js');
 
-//#region src/v2/providers/dataconnect.ts
+//#region src/v2/providers/dataconnect/index.ts
 var dataconnect_exports = /* @__PURE__ */ require_rolldown_runtime.__export({
 	mutationExecutedEventType: () => mutationExecutedEventType,
 	onMutationExecuted: () => onMutationExecuted

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firebase-functions",
-  "version": "7.0.2",
+  "version": "7.0.4",
   "description": "Firebase SDK for Cloud Functions",
   "keywords": [
     "firebase",
@@ -199,9 +199,14 @@
       "require": "./lib/v2/providers/firestore.js"
     },
     "./dataconnect": {
-      "types": "./lib/v2/providers/dataconnect.d.ts",
-      "import": "./lib/esm/v2/providers/dataconnect.mjs",
-      "require": "./lib/v2/providers/dataconnect.js"
+      "types": "./lib/v2/providers/dataconnect/index.d.ts",
+      "import": "./lib/esm/v2/providers/dataconnect/index.mjs",
+      "require": "./lib/v2/providers/dataconnect/index.js"
+    },
+    "./dataconnect/graphql": {
+      "types": "./lib/v2/providers/dataconnect/graphql.d.ts",
+      "import": "./lib/esm/v2/providers/dataconnect/graphql.mjs",
+      "require": "./lib/v2/providers/dataconnect/graphql.js"
     },
     "./v2": {
       "types": "./lib/v2/index.d.ts",
@@ -299,9 +304,14 @@
       "require": "./lib/v2/providers/firestore.js"
     },
     "./v2/dataconnect": {
-      "types": "./lib/v2/providers/dataconnect.d.ts",
-      "import": "./lib/esm/v2/providers/dataconnect.mjs",
-      "require": "./lib/v2/providers/dataconnect.js"
+      "types": "./lib/v2/providers/dataconnect/index.d.ts",
+      "import": "./lib/esm/v2/providers/dataconnect/index.mjs",
+      "require": "./lib/v2/providers/dataconnect/index.js"
+    },
+    "./v2/dataconnect/graphql": {
+      "types": "./lib/v2/providers/dataconnect/graphql.d.ts",
+      "import": "./lib/esm/v2/providers/dataconnect/graphql.mjs",
+      "require": "./lib/v2/providers/dataconnect/graphql.js"
     }
   },
   "typesVersions": {
@@ -403,7 +413,10 @@
         "lib/v2/providers/firestore"
       ],
       "dataconnect": [
-        "lib/v2/providers/dataconnect"
+        "lib/v2/providers/dataconnect/index"
+      ],
+      "dataconnect/graphql": [
+        "lib/v2/providers/dataconnect/graphql"
       ],
       "v2": [
         "lib/v2/index"
@@ -466,7 +479,10 @@
         "lib/v2/providers/firestore"
       ],
       "v2/dataconnect": [
-        "lib/v2/providers/dataconnect"
+        "lib/v2/providers/dataconnect/index"
+      ],
+      "v2/dataconnect/graphql": [
+        "lib/v2/providers/dataconnect/graphql"
       ],
       "*": [
         "lib/v2/index.d.ts"
@@ -508,6 +524,8 @@
     "protobufjs": "^7.2.2"
   },
   "devDependencies": {
+    "@apollo/server": "^5.2.0",
+    "@as-integrations/express4": "^1.1.2",
     "@eslint/eslintrc": "^3.3.1",
     "@firebase/api-documenter": "^0.2.0",
     "@microsoft/api-documenter": "^7.13.45",
@@ -534,6 +552,7 @@
     "eslint-plugin-prettier": "^4.2.1",
     "firebase-admin": "^13.0.0",
     "genkit": "^1.0.0-rc.4",
+    "graphql": "^16.12.0",
     "jsdom": "^16.2.1",
     "jsonwebtoken": "^9.0.0",
     "jwk-to-pem": "^2.0.5",
@@ -554,8 +573,22 @@
     "yargs": "^15.3.1"
   },
   "peerDependencies": {
+    "@apollo/server": "^5.2.0",
+    "@as-integrations/express4": "^1.1.2",
+    "graphql": "^16.12.0",
     "firebase-admin": "^11.10.0 || ^12.0.0 || ^13.0.0"
   },
+  "peerDependenciesMeta": {
+    "@apollo/server": {
+      "optional": true
+    },
+    "@as-integrations/express4": {
+      "optional": true
+    },
+    "graphql": {
+      "optional": true
+    }
+  },
   "engines": {
     "node": ">=18.0.0"
   }