firebase-functions 3.16.0 → 3.18.0

package/lib/handler-builder.d.ts

@@ -22,7 +22,7 @@ export declare class HandlerBuilder {
     constructor();
     /**
      * Create a handler for HTTPS events.
-    
+  
      * `onRequest` handles an HTTPS request and has the same signature as an Express app.
      *
      * @example
@@ -40,6 +40,10 @@ export declare class HandlerBuilder {
     get https(): {
         onRequest: (handler: (req: express.Request, resp: express.Response) => void) => HttpsFunction;
         onCall: (handler: (data: any, context: https.CallableContext) => any | Promise<any>) => HttpsFunction;
+        /** @hidden */
+        readonly taskQueue: {
+            onEnqueue(handler: (data: any, context: https.TaskContext) => void | Promise<void>): https.TaskQueueFunction;
+        };
     };
     /**
      * Create a handler for Firebase Realtime Database events.
@@ -57,7 +61,7 @@ export declare class HandlerBuilder {
      * ```javascript
      * exports.myFunction = functions.handler.database.ref.onUpdate((change, context) => { ... })
      * ```
-    
+  
      * `ref.onDelete` handles the deletion of existing data.
      *
      * @example
@@ -88,14 +92,14 @@ export declare class HandlerBuilder {
      * ```javascript
      * exports.myFunction = functions.handler.firestore.document.onCreate((snap, context) => { ... })
      * ```
-     
+  
      * `document.onUpdate` handles updates to existing documents.
      *
      * @example
      * ```javascript
      * exports.myFunction = functions.handler.firestore.document.onUpdate((change, context) => { ... })
      * ```
-     
+  
      * `document.onDelete` handles the deletion of existing documents.
      *
      * @example
@@ -103,7 +107,7 @@ export declare class HandlerBuilder {
      * exports.myFunction = functions.handler.firestore.document.onDelete((snap, context) =>
      * { ... })
      * ```
-     
+  
      * `document.onWrite` handles the creation, update, or deletion of documents.
      *
      * @example
@@ -123,7 +127,7 @@ export declare class HandlerBuilder {
      * Create a handler for Firebase Remote Config events.
   
      * `remoteConfig.onUpdate` handles events that update a Remote Config template.
-   
+  
      * @example
      * ```javascript
      * exports.myFunction = functions.handler.remoteConfig.onUpdate() => { ... })
@@ -134,9 +138,9 @@ export declare class HandlerBuilder {
     };
     /**
      * Create a handler for Google Analytics events.
-     
+  
      * `event.onLog` handles the logging of Analytics conversion events.
-   
+  
      * @example
      * ```javascript
      * exports.myFunction = functions.handler.analytics.event.onLog((event) => { ... })
@@ -154,14 +158,14 @@ export declare class HandlerBuilder {
      * ```javascript
      * exports.myFunction = functions.handler.storage.object.onArchive((object) => { ... })
      * ```
-     
+  
      * `object.onDelete` handles the deletion of Storage objects.
      *
      * @example
      * ```javascript
      * exports.myFunction = functions.handler.storage.object.onDelete((object) => { ... })
      * ```
-     
+  
      * `object.onFinalize` handles the creation of Storage objects.
      *
      * @example
@@ -169,7 +173,7 @@ export declare class HandlerBuilder {
      * exports.myFunction = functions.handler.storage.object.onFinalize((object) =>
      * { ... })
      * ```
-     
+  
      * `object.onMetadataUpdate` handles changes to the metadata of existing Storage objects.
      *
      * @example
@@ -191,7 +195,7 @@ export declare class HandlerBuilder {
      * ```javascript
      * exports.myFunction = functions.handler.pubsub.topic.onPublish((message) => { ... })
      * ```
-     
+  
      * `schedule.onPublish` handles messages published to a Pub/Sub topic on a schedule.
      *
      * @example
@@ -212,14 +216,14 @@ export declare class HandlerBuilder {
      * ```javascript
      * exports.myFunction = functions.handler.auth.user.onCreate((user) => { ... })
      * ```
-     
+  
      * `user.onDelete` handles the deletion of users.
      *
      * @example
      * ```javascript
      * exports.myFunction = functions.handler.auth.user.onDelete((user => { ... })
      * ```
-     
+  
      */
     get auth(): {
         readonly user: auth.UserBuilder;
@@ -228,7 +232,7 @@ export declare class HandlerBuilder {
      * Create a handler for Firebase Test Lab events.
   
      * `testMatrix.onComplete` handles the completion of a test matrix.
-   
+  
      * @example
      * ```javascript
      * exports.myFunction = functions.handler.testLab.testMatrix.onComplete((testMatrix) => { ... })

package/lib/handler-builder.js

@@ -45,7 +45,7 @@ class HandlerBuilder {
     constructor() { }
     /**
      * Create a handler for HTTPS events.
-    
+  
      * `onRequest` handles an HTTPS request and has the same signature as an Express app.
      *
      * @example
@@ -65,13 +65,30 @@ class HandlerBuilder {
             onRequest: (handler) => {
                 const func = https._onRequestWithOptions(handler, {});
                 func.__trigger = {};
+                func.__endpoint = undefined;
+                func.__requiredAPIs = undefined;
                 return func;
             },
             onCall: (handler) => {
                 const func = https._onCallWithOptions(handler, {});
                 func.__trigger = {};
+                func.__endpoint = undefined;
+                func.__requiredAPIs = undefined;
                 return func;
             },
+            /** @hidden */
+            get taskQueue() {
+                return {
+                    onEnqueue(handler) {
+                        const builder = new https.TaskQueueBuilder();
+                        const func = builder.onDispatch(handler);
+                        func.__trigger = {};
+                        func.__endpoint = undefined;
+                        func.__requiredAPIs = undefined;
+                        return func;
+                    },
+                };
+            },
         };
     }
     /**
@@ -90,7 +107,7 @@ class HandlerBuilder {
      * ```javascript
      * exports.myFunction = functions.handler.database.ref.onUpdate((change, context) => { ... })
      * ```
-    
+  
      * `ref.onDelete` handles the deletion of existing data.
      *
      * @example
@@ -129,14 +146,14 @@ class HandlerBuilder {
      * ```javascript
      * exports.myFunction = functions.handler.firestore.document.onCreate((snap, context) => { ... })
      * ```
-     
+  
      * `document.onUpdate` handles updates to existing documents.
      *
      * @example
      * ```javascript
      * exports.myFunction = functions.handler.firestore.document.onUpdate((change, context) => { ... })
      * ```
-     
+  
      * `document.onDelete` handles the deletion of existing documents.
      *
      * @example
@@ -144,7 +161,7 @@ class HandlerBuilder {
      * exports.myFunction = functions.handler.firestore.document.onDelete((snap, context) =>
      * { ... })
      * ```
-     
+  
      * `document.onWrite` handles the creation, update, or deletion of documents.
      *
      * @example
@@ -172,7 +189,7 @@ class HandlerBuilder {
      * Create a handler for Firebase Remote Config events.
   
      * `remoteConfig.onUpdate` handles events that update a Remote Config template.
-   
+  
      * @example
      * ```javascript
      * exports.myFunction = functions.handler.remoteConfig.onUpdate() => { ... })
@@ -187,9 +204,9 @@ class HandlerBuilder {
     }
     /**
      * Create a handler for Google Analytics events.
-     
+  
      * `event.onLog` handles the logging of Analytics conversion events.
-   
+  
      * @example
      * ```javascript
      * exports.myFunction = functions.handler.analytics.event.onLog((event) => { ... })
@@ -211,14 +228,14 @@ class HandlerBuilder {
      * ```javascript
      * exports.myFunction = functions.handler.storage.object.onArchive((object) => { ... })
      * ```
-     
+  
      * `object.onDelete` handles the deletion of Storage objects.
      *
      * @example
      * ```javascript
      * exports.myFunction = functions.handler.storage.object.onDelete((object) => { ... })
      * ```
-     
+  
      * `object.onFinalize` handles the creation of Storage objects.
      *
      * @example
@@ -226,7 +243,7 @@ class HandlerBuilder {
      * exports.myFunction = functions.handler.storage.object.onFinalize((object) =>
      * { ... })
      * ```
-     
+  
      * `object.onMetadataUpdate` handles changes to the metadata of existing Storage objects.
      *
      * @example
@@ -254,7 +271,7 @@ class HandlerBuilder {
      * ```javascript
      * exports.myFunction = functions.handler.pubsub.topic.onPublish((message) => { ... })
      * ```
-     
+  
      * `schedule.onPublish` handles messages published to a Pub/Sub topic on a schedule.
      *
      * @example
@@ -281,14 +298,14 @@ class HandlerBuilder {
      * ```javascript
      * exports.myFunction = functions.handler.auth.user.onCreate((user) => { ... })
      * ```
-     
+  
      * `user.onDelete` handles the deletion of users.
      *
      * @example
      * ```javascript
      * exports.myFunction = functions.handler.auth.user.onDelete((user => { ... })
      * ```
-     
+  
      */
     get auth() {
         return {
@@ -301,7 +318,7 @@ class HandlerBuilder {
      * Create a handler for Firebase Test Lab events.
   
      * `testMatrix.onComplete` handles the completion of a test matrix.
-   
+  
      * @example
      * ```javascript
      * exports.myFunction = functions.handler.testLab.testMatrix.onComplete((testMatrix) => { ... })

package/lib/providers/auth.d.ts

@@ -1,6 +1,7 @@
-import * as firebase from 'firebase-admin';
+import { UserRecord, UserInfo, UserRecordMetadata, userRecordConstructor } from '../common/providers/identity';
 import { CloudFunction, EventContext } from '../cloud-functions';
 import { DeploymentOptions } from '../function-configuration';
+export { UserRecord, UserInfo, UserRecordMetadata, userRecordConstructor };
 /** @hidden */
 export declare const provider = "google.firebase.auth";
 /** @hidden */
@@ -11,16 +12,6 @@ export declare const service = "firebaseauth.googleapis.com";
 export declare function user(): UserBuilder;
 /** @hidden */
 export declare function _userWithOptions(options: DeploymentOptions): UserBuilder;
-export declare class UserRecordMetadata implements firebase.auth.UserMetadata {
-    creationTime: string;
-    lastSignInTime: string;
-    constructor(creationTime: string, lastSignInTime: string);
-    /** Returns a plain JavaScript object with the properties of UserRecordMetadata. */
-    toJSON(): {
-        creationTime: string;
-        lastSignInTime: string;
-    };
-}
 /** Builder used to create Cloud Functions for Firebase Auth user lifecycle events. */
 export declare class UserBuilder {
     private triggerResource;
@@ -34,13 +25,3 @@ export declare class UserBuilder {
     onDelete(handler: (user: UserRecord, context: EventContext) => PromiseLike<any> | any): CloudFunction<UserRecord>;
     private onOperation;
 }
-/**
- * The UserRecord passed to Cloud Functions is the same UserRecord that is returned by the Firebase Admin
- * SDK.
- */
-export declare type UserRecord = firebase.auth.UserRecord;
-/**
- * UserInfo that is part of the UserRecord
- */
-export declare type UserInfo = firebase.auth.UserInfo;
-export declare function userRecordConstructor(wireData: Object): firebase.auth.UserRecord;

package/lib/providers/auth.js

@@ -21,8 +21,10 @@
 // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 // SOFTWARE.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.userRecordConstructor = exports.UserBuilder = exports.UserRecordMetadata = exports._userWithOptions = exports.user = exports.service = exports.provider = void 0;
-const _ = require("lodash");
+exports.UserBuilder = exports._userWithOptions = exports.user = exports.service = exports.provider = exports.userRecordConstructor = exports.UserRecordMetadata = void 0;
+const identity_1 = require("../common/providers/identity");
+Object.defineProperty(exports, "UserRecordMetadata", { enumerable: true, get: function () { return identity_1.UserRecordMetadata; } });
+Object.defineProperty(exports, "userRecordConstructor", { enumerable: true, get: function () { return identity_1.userRecordConstructor; } });
 const cloud_functions_1 = require("../cloud-functions");
 /** @hidden */
 exports.provider = 'google.firebase.auth';
@@ -45,20 +47,6 @@ function _userWithOptions(options) {
     }, options);
 }
 exports._userWithOptions = _userWithOptions;
-class UserRecordMetadata {
-    constructor(creationTime, lastSignInTime) {
-        this.creationTime = creationTime;
-        this.lastSignInTime = lastSignInTime;
-    }
-    /** Returns a plain JavaScript object with the properties of UserRecordMetadata. */
-    toJSON() {
-        return {
-            creationTime: this.creationTime,
-            lastSignInTime: this.lastSignInTime,
-        };
-    }
-}
-exports.UserRecordMetadata = UserRecordMetadata;
 /** Builder used to create Cloud Functions for Firebase Auth user lifecycle events. */
 class UserBuilder {
     /** @hidden */
@@ -67,7 +55,7 @@ class UserBuilder {
         this.options = options;
     }
     static dataConstructor(raw) {
-        return userRecordConstructor(raw.data);
+        return (0, identity_1.userRecordConstructor)(raw.data);
     }
     /** Respond to the creation of a Firebase Auth user. */
     onCreate(handler) {
@@ -91,52 +79,3 @@ class UserBuilder {
     }
 }
 exports.UserBuilder = UserBuilder;
-function userRecordConstructor(wireData) {
-    // Falsey values from the wire format proto get lost when converted to JSON, this adds them back.
-    const falseyValues = {
-        email: null,
-        emailVerified: false,
-        displayName: null,
-        photoURL: null,
-        phoneNumber: null,
-        disabled: false,
-        providerData: [],
-        customClaims: {},
-        passwordSalt: null,
-        passwordHash: null,
-        tokensValidAfterTime: null,
-    };
-    const record = _.assign({}, falseyValues, wireData);
-    const meta = _.get(record, 'metadata');
-    if (meta) {
-        _.set(record, 'metadata', new UserRecordMetadata(meta.createdAt || meta.creationTime, meta.lastSignedInAt || meta.lastSignInTime));
-    }
-    else {
-        _.set(record, 'metadata', new UserRecordMetadata(null, null));
-    }
-    _.forEach(record.providerData, (entry) => {
-        _.set(entry, 'toJSON', () => {
-            return entry;
-        });
-    });
-    _.set(record, 'toJSON', () => {
-        const json = _.pick(record, [
-            'uid',
-            'email',
-            'emailVerified',
-            'displayName',
-            'photoURL',
-            'phoneNumber',
-            'disabled',
-            'passwordHash',
-            'passwordSalt',
-            'tokensValidAfterTime',
-        ]);
-        json.metadata = _.get(record, 'metadata').toJSON();
-        json.customClaims = _.cloneDeep(record.customClaims);
-        json.providerData = _.map(record.providerData, (entry) => entry.toJSON());
-        return json;
-    });
-    return record;
-}
-exports.userRecordConstructor = userRecordConstructor;

package/lib/providers/database.js

@@ -266,8 +266,9 @@ exports.extractInstanceAndPath = extractInstanceAndPath;
 class DataSnapshot {
     constructor(data, path, // path will be undefined for the database root
     app, instance) {
+        var _a, _b;
         this.app = app;
-        if (app && app.options.databaseURL.startsWith('http:')) {
+        if ((_b = (_a = app === null || app === void 0 ? void 0 : app.options) === null || _a === void 0 ? void 0 : _a.databaseURL) === null || _b === void 0 ? void 0 : _b.startsWith('http:')) {
             // In this case we're dealing with an emulator
             this.instance = app.options.databaseURL;
         }

package/lib/providers/https.d.ts

@@ -1,8 +1,15 @@
 import * as express from 'express';
 import { HttpsFunction, Runnable } from '../cloud-functions';
-import { CallableContext, FunctionsErrorCode, HttpsError, Request } from '../common/providers/https';
+import { ManifestEndpoint, ManifestRequiredAPI } from '../runtime/manifest';
+import { CallableContext, FunctionsErrorCode, HttpsError, Request, TaskContext, TaskRateLimits, TaskRetryConfig } from '../common/providers/https';
 import { DeploymentOptions } from '../function-configuration';
-export { Request, CallableContext, FunctionsErrorCode, HttpsError };
+export { Request, CallableContext, FunctionsErrorCode, HttpsError, 
+/** @hidden */
+TaskRetryConfig as TaskRetryPolicy, 
+/** @hidden */
+TaskRateLimits, 
+/** @hidden */
+TaskContext, };
 /**
  * Handle HTTP requests.
  * @param handler A function that takes a request and response object,
@@ -14,6 +21,41 @@ export declare function onRequest(handler: (req: Request, resp: express.Response
  * @param handler A method that takes a data and context and returns a value.
  */
 export declare function onCall(handler: (data: any, context: CallableContext) => any | Promise<any>): HttpsFunction & Runnable<any>;
+/**
+ * Configurations for Task Queue Functions.
+ * @hidden
+ */
+export interface TaskQueueOptions {
+    retryConfig?: TaskRetryConfig;
+    rateLimits?: TaskRateLimits;
+    /**
+     * Who can enqueue tasks for this function.
+     * If left unspecified, only service accounts which have
+     * roles/cloudtasks.enqueuer and roles/cloudfunctions.invoker
+     * will have permissions.
+     */
+    invoker?: 'private' | string | string[];
+}
+/** @hidden */
+export interface TaskQueueFunction {
+    (req: Request, res: express.Response): Promise<void>;
+    __trigger: unknown;
+    __endpoint: ManifestEndpoint;
+    __requiredAPIs?: ManifestRequiredAPI[];
+    run(data: any, context: TaskContext): void | Promise<void>;
+}
+/** @hidden */
+export declare class TaskQueueBuilder {
+    private readonly tqOpts?;
+    private readonly depOpts?;
+    onDispatch(handler: (data: any, context: TaskContext) => void | Promise<void>): TaskQueueFunction;
+}
+/**
+ * Declares a function that can handle tasks enqueued using the Firebase Admin SDK.
+ * @param options Configuration for the Task Queue that feeds into this function.
+ * @hidden
+ */
+export declare function taskQueue(options?: TaskQueueOptions): TaskQueueBuilder;
 /** @hidden */
 export declare function _onRequestWithOptions(handler: (req: Request, resp: express.Response) => void | Promise<void>, options: DeploymentOptions): HttpsFunction;
 /** @hidden */

package/lib/providers/https.js

@@ -21,7 +21,7 @@
 // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 // SOFTWARE.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._onCallWithOptions = exports._onRequestWithOptions = exports.onCall = exports.onRequest = exports.HttpsError = void 0;
+exports._onCallWithOptions = exports._onRequestWithOptions = exports.taskQueue = exports.TaskQueueBuilder = exports.onCall = exports.onRequest = exports.HttpsError = void 0;
 const cloud_functions_1 = require("../cloud-functions");
 const encoding_1 = require("../common/encoding");
 const https_1 = require("../common/providers/https");
@@ -44,6 +44,54 @@ function onCall(handler) {
 }
 exports.onCall = onCall;
 /** @hidden */
+class TaskQueueBuilder {
+    /** @internal */
+    constructor(tqOpts, depOpts) {
+        this.tqOpts = tqOpts;
+        this.depOpts = depOpts;
+    }
+    onDispatch(handler) {
+        // onEnqueueHandler sniffs the function length of the passed-in callback
+        // and the user could have only tried to listen to data. Wrap their handler
+        // in another handler to avoid accidentally triggering the v2 API
+        const fixedLen = (data, context) => handler(data, context);
+        const func = (0, https_1.onDispatchHandler)(fixedLen);
+        func.__trigger = {
+            ...(0, cloud_functions_1.optionsToTrigger)(this.depOpts || {}),
+            taskQueueTrigger: {},
+        };
+        (0, encoding_1.copyIfPresent)(func.__trigger.taskQueueTrigger, this.tqOpts, 'retryConfig');
+        (0, encoding_1.copyIfPresent)(func.__trigger.taskQueueTrigger, this.tqOpts, 'rateLimits');
+        (0, encoding_1.convertIfPresent)(func.__trigger.taskQueueTrigger, this.tqOpts, 'invoker', 'invoker', encoding_1.convertInvoker);
+        func.__endpoint = {
+            platform: 'gcfv1',
+            ...(0, cloud_functions_1.optionsToEndpoint)(this.depOpts),
+            taskQueueTrigger: {},
+        };
+        (0, encoding_1.copyIfPresent)(func.__endpoint.taskQueueTrigger, this.tqOpts, 'retryConfig');
+        (0, encoding_1.copyIfPresent)(func.__endpoint.taskQueueTrigger, this.tqOpts, 'rateLimits');
+        (0, encoding_1.convertIfPresent)(func.__endpoint.taskQueueTrigger, this.tqOpts, 'invoker', 'invoker', encoding_1.convertInvoker);
+        func.__requiredAPIs = [
+            {
+                api: 'cloudtasks.googleapis.com',
+                reason: 'Needed for task queue functions',
+            },
+        ];
+        func.run = handler;
+        return func;
+    }
+}
+exports.TaskQueueBuilder = TaskQueueBuilder;
+/**
+ * Declares a function that can handle tasks enqueued using the Firebase Admin SDK.
+ * @param options Configuration for the Task Queue that feeds into this function.
+ * @hidden
+ */
+function taskQueue(options) {
+    return new TaskQueueBuilder(options);
+}
+exports.taskQueue = taskQueue;
+/** @hidden */
 function _onRequestWithOptions(handler, options) {
     // lets us add __trigger without altering handler:
     const cloudFunction = (req, res) => {
@@ -55,6 +103,12 @@ function _onRequestWithOptions(handler, options) {
     };
     (0, encoding_1.convertIfPresent)(cloudFunction.__trigger.httpsTrigger, options, 'invoker', 'invoker', encoding_1.convertInvoker);
     // TODO parse the options
+    cloudFunction.__endpoint = {
+        platform: 'gcfv1',
+        ...(0, cloud_functions_1.optionsToEndpoint)(options),
+        httpsTrigger: {},
+    };
+    (0, encoding_1.convertIfPresent)(cloudFunction.__endpoint.httpsTrigger, options, 'invoker', 'invoker', encoding_1.convertInvoker);
     return cloudFunction;
 }
 exports._onRequestWithOptions = _onRequestWithOptions;
@@ -74,6 +128,12 @@ function _onCallWithOptions(handler, options) {
         httpsTrigger: {},
     };
     func.__trigger.labels['deployment-callable'] = 'true';
+    func.__endpoint = {
+        platform: 'gcfv1',
+        labels: {},
+        ...(0, cloud_functions_1.optionsToEndpoint)(options),
+        callableTrigger: {},
+    };
     func.run = handler;
     return func;
 }

package/lib/runtime/loader.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/runtime/loader.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadStack = exports.mergeRequiredAPIs = exports.extractStack = void 0;
+// The MIT License (MIT)
+//
+// Copyright (c) 2021 Firebase
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in
+// all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+const url = require("url");
+const path = require("path");
+/**
+ * Dynamically load import function to prevent TypeScript from
+ * transpiling into a require.
+ *
+ * See https://github.com/microsoft/TypeScript/issues/43329.
+ */
+const dynamicImport = new Function('modulePath', 'return import(modulePath)');
+async function loadModule(functionsDir) {
+    const absolutePath = path.resolve(functionsDir);
+    try {
+        return require(path.resolve(absolutePath));
+    }
+    catch (e) {
+        if (e.code === 'ERR_REQUIRE_ESM') {
+            // This is an ESM package!
+            const modulePath = require.resolve(absolutePath);
+            // Resolve module path to file:// URL. Required for windows support.
+            // @ts-ignore pathToFileURL exists for Node.js v10 and up. Since ESM support exists for Node.js v13 and up, we
+            // can be sure that this function exists here.
+            const moduleURL = url.pathToFileURL(modulePath).href;
+            return await dynamicImport(moduleURL);
+        }
+        throw e;
+    }
+}
+/* @internal */
+function extractStack(module, endpoints, requiredAPIs, prefix = '') {
+    for (const [name, val] of Object.entries(module)) {
+        if (typeof val === 'function' &&
+            val['__endpoint'] &&
+            typeof val['__endpoint'] === 'object') {
+            const funcName = prefix + name;
+            endpoints[funcName] = {
+                ...val['__endpoint'],
+                entryPoint: funcName.replace(/-/g, '.'),
+            };
+            if (val['__requiredAPIs'] && Array.isArray(val['__requiredAPIs'])) {
+                requiredAPIs.push(...val['__requiredAPIs']);
+            }
+        }
+        else if (typeof val === 'object' && val !== null) {
+            extractStack(val, endpoints, requiredAPIs, prefix + name + '-');
+        }
+    }
+}
+exports.extractStack = extractStack;
+/* @internal */
+function mergeRequiredAPIs(requiredAPIs) {
+    const apiToReasons = {};
+    for (const { api, reason } of requiredAPIs) {
+        const reasons = apiToReasons[api] || new Set();
+        reasons.add(reason);
+        apiToReasons[api] = reasons;
+    }
+    const merged = [];
+    for (const [api, reasons] of Object.entries(apiToReasons)) {
+        merged.push({ api, reason: Array.from(reasons).join(' ') });
+    }
+    return merged;
+}
+exports.mergeRequiredAPIs = mergeRequiredAPIs;
+/* @internal */
+async function loadStack(functionsDir) {
+    const endpoints = {};
+    const requiredAPIs = [];
+    const mod = await loadModule(functionsDir);
+    extractStack(mod, endpoints, requiredAPIs);
+    const stack = {
+        endpoints,
+        specVersion: 'v1alpha1',
+        requiredAPIs: mergeRequiredAPIs(requiredAPIs),
+    };
+    return stack;
+}
+exports.loadStack = loadStack;