firebase-functions 3.24.1 → 4.0.0-rc.0

package/lib/v2/providers/tasks.js

@@ -29,9 +29,11 @@ exports.onTaskDispatched = void 0;
 const encoding_1 = require("../../common/encoding");
 const tasks_1 = require("../../common/providers/tasks");
 const options = require("../options");
+const trace_1 = require("../trace");
+const manifest_1 = require("../../runtime/manifest");
 function onTaskDispatched(optsOrHandler, handler) {
     let opts;
-    if (arguments.length == 1) {
+    if (arguments.length === 1) {
         opts = {};
         handler = optsOrHandler;
     }
@@ -41,49 +43,30 @@ function onTaskDispatched(optsOrHandler, handler) {
     // onDispatchHandler sniffs the function length to determine which API to present.
     // fix the length to prevent api versions from being mismatched.
     const fixedLen = (req) => handler(req);
-    const func = (0, tasks_1.onDispatchHandler)(fixedLen);
-    Object.defineProperty(func, '__trigger', {
-        get: () => {
-            const baseOpts = options.optionsToTriggerAnnotations(options.getGlobalOptions());
-            // global options calls region a scalar and https allows it to be an array,
-            // but optionsToTriggerAnnotations handles both cases.
-            const specificOpts = options.optionsToTriggerAnnotations(opts);
-            const taskQueueTrigger = {};
-            (0, encoding_1.copyIfPresent)(taskQueueTrigger, opts, 'retryConfig', 'rateLimits');
-            (0, encoding_1.convertIfPresent)(taskQueueTrigger, opts, 'invoker', 'invoker', encoding_1.convertInvoker);
-            return {
-                platform: 'gcfv2',
-                ...baseOpts,
-                ...specificOpts,
-                labels: {
-                    ...baseOpts === null || baseOpts === void 0 ? void 0 : baseOpts.labels,
-                    ...specificOpts === null || specificOpts === void 0 ? void 0 : specificOpts.labels,
-                },
-                taskQueueTrigger,
-            };
-        },
-    });
-    const baseOpts = options.optionsToEndpoint(options.getGlobalOptions());
+    const func = (0, trace_1.wrapTraceContext)((0, tasks_1.onDispatchHandler)(fixedLen));
+    const globalOpts = options.getGlobalOptions();
+    const baseOpts = options.optionsToEndpoint(globalOpts);
     // global options calls region a scalar and https allows it to be an array,
     // but optionsToManifestEndpoint handles both cases.
     const specificOpts = options.optionsToEndpoint(opts);
     func.__endpoint = {
-        platform: 'gcfv2',
+        platform: "gcfv2",
+        ...(0, manifest_1.initV2Endpoint)(options.getGlobalOptions(), opts),
         ...baseOpts,
         ...specificOpts,
         labels: {
             ...baseOpts === null || baseOpts === void 0 ? void 0 : baseOpts.labels,
             ...specificOpts === null || specificOpts === void 0 ? void 0 : specificOpts.labels,
         },
-        taskQueueTrigger: {},
+        taskQueueTrigger: (0, manifest_1.initTaskQueueTrigger)(options.getGlobalOptions(), opts),
     };
-    (0, encoding_1.copyIfPresent)(func.__endpoint.taskQueueTrigger, opts, 'retryConfig');
-    (0, encoding_1.copyIfPresent)(func.__endpoint.taskQueueTrigger, opts, 'rateLimits');
-    (0, encoding_1.convertIfPresent)(func.__endpoint.taskQueueTrigger, opts, 'invoker', 'invoker', encoding_1.convertInvoker);
+    (0, encoding_1.copyIfPresent)(func.__endpoint.taskQueueTrigger, opts, "retryConfig");
+    (0, encoding_1.copyIfPresent)(func.__endpoint.taskQueueTrigger, opts, "rateLimits");
+    (0, encoding_1.convertIfPresent)(func.__endpoint.taskQueueTrigger, opts, "invoker", "invoker", encoding_1.convertInvoker);
     func.__requiredAPIs = [
         {
-            api: 'cloudtasks.googleapis.com',
-            reason: 'Needed for task queue functions',
+            api: "cloudtasks.googleapis.com",
+            reason: "Needed for task queue functions",
         },
     ];
     func.run = handler;

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

@@ -0,0 +1,110 @@
+import { CloudEvent, CloudFunction } from "../core";
+import { EventHandlerOptions } from "../options";
+/** Possible test states for a test matrix. */
+export declare type TestState = 
+/** The default value. This value is used if the state is omitted. */
+"TEST_STATE_UNSPECIFIED"
+/** The test matrix is being validated. */
+ | "VALIDATING"
+/** The test matrix is waiting for resources to become available. */
+ | "PENDING"
+/** The test matrix has completed normally. */
+ | "FINISHED"
+/** The test matrix has completed because of an infrastructure failure. */
+ | "ERROR"
+/** The test matrix was not run because the provided inputs are not valid. */
+ | "INVALID";
+/** Outcome summary for a finished test matrix. */
+export declare type OutcomeSummary = 
+/** The default value. This value is used if the state is omitted. */
+"OUTCOME_SUMMARY_UNSPECIFIED"
+/**
+ * The test matrix run was successful, for instance:
+ * - All test cases passed.
+ * - No crash of the application under test was detected.
+ */
+ | "SUCCESS"
+/**
+ * A run failed, for instance:
+ * - One or more test case failed.
+ * - A test timed out.
+ * - The application under test crashed.
+ */
+ | "FAILURE"
+/**
+ * Something unexpected happened. The test run should still be considered
+ * unsuccessful but this is likely a transient problem and re-running the
+ * test might be successful.
+ */
+ | "INCONCLUSIVE"
+/** All tests were skipped. */
+ | "SKIPPED";
+/** Locations where test results are stored. */
+export interface ResultStorage {
+    /**
+     * Tool Results history resource containing test results. Format is
+     * `projects/{project_id}/histories/{history_id}`.
+     * See https://firebase.google.com/docs/test-lab/reference/toolresults/rest
+     * for more information.
+     */
+    toolResultsHistory: string;
+    /**
+     * Tool Results execution resource containing test results. Format is
+     * `projects/{project_id}/histories/{history_id}/executions/{execution_id}`.
+     * Optional, can be omitted in erroneous test states.
+     * See https://firebase.google.com/docs/test-lab/reference/toolresults/rest
+     * for more information.
+     */
+    toolResultsExecution: string;
+    /** URI to the test results in the Firebase Web Console. */
+    resultsUri: string;
+    /**
+     * Location in Google Cloud Storage where test results are written to.
+     * In the form "gs://bucket/path/to/somewhere".
+     */
+    gcsPath: string;
+}
+/** Information about the client which invoked the test. */
+export interface ClientInfo {
+    /** Client name, such as "gcloud". */
+    client: string;
+    /** Map of detailed information about the client. */
+    details: Record<string, string>;
+}
+/** The data within all Firebase test matrix completed events. */
+export interface TestMatrixCompletedData {
+    /** Time the test matrix was created. */
+    createTime: string;
+    /** State of the test matrix. */
+    state: TestState;
+    /**
+     * Code that describes why the test matrix is considered invalid. Only set for
+     * matrices in the INVALID state.
+     */
+    invalidMatrixDetails: string;
+    /** Outcome summary of the test matrix. */
+    outcomeSummary: OutcomeSummary;
+    /** Locations where test results are stored. */
+    resultStorage: ResultStorage;
+    /** Information provided by the client that created the test matrix. */
+    clientInfo: ClientInfo;
+    /** ID of the test matrix this event belongs to. */
+    testMatrixId: string;
+}
+/**
+ * Event handler which triggers when a Firebase test matrix completes.
+ *
+ * @param handler - Event handler which is run every time a Firebase test matrix completes.
+ * @returns A Cloud Function that you can export and deploy.
+ * @alpha
+ */
+export declare function onTestMatrixCompleted(handler: (event: CloudEvent<TestMatrixCompletedData>) => any | Promise<any>): CloudFunction<CloudEvent<TestMatrixCompletedData>>;
+/**
+ * Event handler which triggers when a Firebase test matrix completes.
+ *
+ * @param opts - Options that can be set on an individual event-handling function.
+ * @param handler - Event handler which is run every time a Firebase test matrix completes.
+ * @returns A Cloud Function that you can export and deploy.
+ * @alpha
+ */
+export declare function onTestMatrixCompleted(opts: EventHandlerOptions, handler: (event: CloudEvent<TestMatrixCompletedData>) => any | Promise<any>): CloudFunction<CloudEvent<TestMatrixCompletedData>>;

package/lib/v2/providers/testLab.js

@@ -0,0 +1,65 @@
+"use strict";
+// The MIT License (MIT)
+//
+// Copyright (c) 2022 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.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onTestMatrixCompleted = exports.eventType = void 0;
+const options_1 = require("../options");
+const trace_1 = require("../trace");
+/** @internal */
+exports.eventType = "google.firebase.testlab.testMatrix.v1.completed";
+/**
+ * Event handler which triggers when a Firebase test matrix completes.
+ *
+ * @param optsOrHandler - Options or an event handler.
+ * @param handler - Event handler which is run every time a Firebase test matrix completes.
+ * @returns A Cloud Function that you can export and deploy.
+ * @alpha
+ */
+function onTestMatrixCompleted(optsOrHandler, handler) {
+    if (typeof optsOrHandler === "function") {
+        handler = optsOrHandler;
+        optsOrHandler = {};
+    }
+    const baseOpts = (0, options_1.optionsToEndpoint)((0, options_1.getGlobalOptions)());
+    const specificOpts = (0, options_1.optionsToEndpoint)(optsOrHandler);
+    const func = (raw) => {
+        return (0, trace_1.wrapTraceContext)(handler(raw));
+    };
+    func.run = handler;
+    const ep = {
+        platform: "gcfv2",
+        ...baseOpts,
+        ...specificOpts,
+        labels: {
+            ...baseOpts === null || baseOpts === void 0 ? void 0 : baseOpts.labels,
+            ...specificOpts === null || specificOpts === void 0 ? void 0 : specificOpts.labels,
+        },
+        eventTrigger: {
+            eventType: exports.eventType,
+            eventFilters: {},
+            retry: !!optsOrHandler.retry,
+        },
+    };
+    func.__endpoint = ep;
+    return func;
+}
+exports.onTestMatrixCompleted = onTestMatrixCompleted;

package/lib/v2/trace.d.ts

@@ -0,0 +1,4 @@
+import { CloudEvent } from "./core";
+declare type CloudEventFunction<T> = (raw: CloudEvent<T>) => any | Promise<any>;
+export declare function wrapTraceContext<T>(handler: CloudEventFunction<T>): CloudEventFunction<T>;
+export {};

package/lib/v2/trace.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wrapTraceContext = void 0;
+const trace_1 = require("../common/trace");
+function wrapTraceContext(handler) {
+    return (...args) => {
+        let traceParent;
+        if (args.length === 1) {
+            traceParent = (0, trace_1.extractTraceContext)(args[0]);
+        }
+        else {
+            traceParent = (0, trace_1.extractTraceContext)(args[0].headers);
+        }
+        if (!traceParent) {
+            // eslint-disable-next-line prefer-spread
+            return handler.apply(null, args);
+        }
+        trace_1.traceContext.run(traceParent, handler, ...args);
+    };
+}
+exports.wrapTraceContext = wrapTraceContext;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firebase-functions",
-  "version": "3.24.1",
+  "version": "4.0.0-rc.0",
   "description": "Firebase SDK for Cloud Functions",
   "keywords": [
     "firebase",
@@ -21,42 +21,30 @@
   "files": [
     "lib"
   ],
-  "main": "lib/index.js",
+  "main": "lib/v1/index.js",
   "bin": {
     "firebase-functions": "./lib/bin/firebase-functions.js"
   },
-  "types": "lib/index.d.ts",
+  "types": "lib/v1/index.d.ts",
   "exports": {
-    ".": "./lib/index.js",
+    ".": "./lib/v1/index.js",
     "./logger/compat": "./lib/logger/compat.js",
-    "./lib/logger/compat": "./lib/logger/compat.js",
     "./logger": "./lib/logger/index.js",
-    "./lib/logger": "./lib/logger/index.js",
-    "./lib/providers/auth": "./lib/providers/auth.js",
-    "./lib/providers/analytics": "./lib/providers/analytics.js",
-    "./lib/providers/database": "./lib/providers/database.js",
-    "./lib/providers/firestore": "./lib/providers/firestore.js",
-    "./lib/providers/https": "./lib/providers/https.js",
-    "./lib/providers/pubsub": "./lib/providers/pubsub.js",
-    "./lib/providers/remoteConfig": "./lib/providers/remoteConfig.js",
-    "./lib/providers/storage": "./lib/providers/storage.js",
-    "./lib/providers/tasks": "./lib/providers/tasks.js",
-    "./lib/providers/testLab": "./lib/providers/testLab.js",
-    "./v1": "./lib/index.js",
-    "./v1/analytics": "./lib/providers/analytics.js",
-    "./v1/auth": "./lib/providers/auth.js",
-    "./v1/database": "./lib/providers/database.js",
-    "./v1/firestore": "./lib/providers/firestore.js",
-    "./v1/https": "./lib/providers/https.js",
-    "./v1/pubsub": "./lib/providers/pubsub.js",
-    "./v1/remoteConfig": "./lib/providers/remoteConfig.js",
-    "./v1/storage": "./lib/providers/storage.js",
-    "./v1/testLab": "./lib/providers/testLab.js",
+    "./params": "./lib/params/index.js",
+    "./v1": "./lib/v1/index.js",
+    "./v1/analytics": "./lib/v1/providers/analytics.js",
+    "./v1/auth": "./lib/v1/providers/auth.js",
+    "./v1/database": "./lib/v1/providers/database.js",
+    "./v1/firestore": "./lib/v1/providers/firestore.js",
+    "./v1/pubsub": "./lib/v1/providers/pubsub.js",
+    "./v1/remoteConfig": "./lib/v1/providers/remoteConfig.js",
+    "./v1/storage": "./lib/v1/providers/storage.js",
+    "./v1/tasks": "./lib/v1/providers/tasks.js",
+    "./v1/testLab": "./lib/v1/providers/testLab.js",
     "./v2": "./lib/v2/index.js",
     "./v2/core": "./lib/v2/core.js",
     "./v2/options": "./lib/v2/options.js",
     "./v2/https": "./lib/v2/providers/https.js",
-    "./v2/params": "./lib/v2/params/index.js",
     "./v2/pubsub": "./lib/v2/providers/pubsub.js",
     "./v2/storage": "./lib/v2/providers/storage.js",
     "./v2/tasks": "./lib/v2/providers/tasks.js",
@@ -68,7 +56,9 @@
     "./v2/eventarc": "./lib/v2/providers/eventarc.js",
     "./v2/identity": "./lib/v2/providers/identity.js",
     "./v2/database": "./lib/v2/providers/database.js",
-    "./v2/scheduler": "./lib/v2/providers/scheduler.js"
+    "./v2/scheduler": "./lib/v2/providers/scheduler.js",
+    "./v2/remoteConfig": "./lib/v2/providers/remoteConfig.js",
+    "./v2/testLab": "./lib/v2/providers/testLab.js"
   },
   "typesVersions": {
     "*": {
@@ -78,38 +68,38 @@
       "logger/compat": [
         "lib/logger/compat"
       ],
+      "params": [
+        "lib/params"
+      ],
       "v1": [
-        "lib"
+        "lib/v1"
       ],
       "v1/analytics": [
-        "lib/providers/analytics"
+        "./lib/v1/providers/analytics"
       ],
       "v1/auth": [
-        "lib/providers/auth"
+        "./lib/v1/providers/auth"
       ],
       "v1/database": [
-        "lib/providers/database"
+        "./lib/v1/privders/database"
       ],
       "v1/firestore": [
-        "lib/providers/firestore"
-      ],
-      "v1/https": [
-        "lib/providers/https"
+        "./lib/v1/providers/firestore"
       ],
       "v1/pubsub": [
-        "lib/providers/pubsub"
+        "./lib/v1/providers/pubsub"
       ],
-      "v1/remoteConfig": [
-        "lib/providers/remoteConfig"
+      "/v1/remoteConfig": [
+        "./lib/v1/providers/remoteConfig"
       ],
-      "v1/storage": [
-        "lib/providers/storage"
+      "/v1/storage": [
+        "./lib/v1/providers/storage"
       ],
-      "v1/tasks": [
-        "lib/providers/tasks"
+      "/v1/tasks": [
+        "./lib/v1/providers/tasks"
       ],
-      "v1/testLab": [
-        "lib/providers/testLab"
+      "/v1/testLab": [
+        "./lib/v1/providers/testLab"
       ],
       "v2": [
         "lib/v2"
@@ -147,9 +137,6 @@
       "v2/https": [
         "lib/v2/providers/https"
       ],
-      "v2/params": [
-        "lib/v2/params"
-      ],
       "v2/pubsub": [
         "lib/v2/providers/pubsub"
       ],
@@ -161,6 +148,12 @@
       ],
       "v2/scheduler": [
         "lib/v2/providers/scheduler"
+      ],
+      "v2/remoteConfig": [
+        "lib/v2/providers/remoteConfig"
+      ],
+      "v2/testLab": [
+        "lib/v2/providers/testLab"
       ]
     }
   },
@@ -168,23 +161,25 @@
     "registry": "https://wombat-dressing-room.appspot.com"
   },
   "scripts": {
-    "apidocs": "node docgen/generate-docs.js",
     "docgen:v1:extract": "api-extractor run -c docgen/api-extractor.v1.json --local",
-    "docgen:v1:toc": "ts-node docgen/toc.ts --input docgen/v1/markdown --output docgen/v1/markdown/toc --path /docs/reference/functions",
+    "docgen:v1:toc": "ts-node docgen/toc.ts --input docgen/v1 --output docgen/v1/markdown/toc --path /docs/reference/functions",
     "docgen:v1:gen": "api-documenter-fire markdown -i docgen/v1 -o docgen/v1/markdown --project functions && npm run docgen:v1:toc",
     "docgen:v1": "npm run build && npm run docgen:v1:extract && npm run docgen:v1:gen",
     "docgen:v2:extract": "api-extractor run -c docgen/api-extractor.v2.json --local",
-    "docgen:v2:toc": "ts-node docgen/toc.ts --input docgen/v2/markdown --output docgen/v2/markdown/toc --path /docs/functions/beta/reference",
+    "docgen:v2:toc": "ts-node docgen/toc.ts --input docgen/v2 --output docgen/v2/markdown/toc --path /docs/functions/beta/reference",
     "docgen:v2:gen": "api-documenter-fire markdown -i docgen/v2 -o docgen/v2/markdown --project functions && npm run docgen:v2:toc",
     "docgen:v2": "npm run build && npm run docgen:v2:extract && npm run docgen:v2:gen",
     "build:pack": "rm -rf lib && npm install && tsc -p tsconfig.release.json && npm pack",
     "build:release": "npm ci --production && npm install --no-save typescript firebase-admin && tsc -p tsconfig.release.json",
     "build": "tsc -p tsconfig.release.json",
     "build:watch": "npm run build -- -w",
-    "format": "prettier --check '**/*.{json,md,ts,yml,yaml}'",
-    "format:fix": "prettier --write '**/*.{json,md,ts,yml,yaml}'",
-    "lint": "tslint --config tslint.json --project tsconfig.json ",
-    "lint:fix": "tslint --config tslint.json --fix --project tsconfig.json",
+    "format": "npm run format:ts && npm run format:other",
+    "format:other": "npm run lint:other -- --write",
+    "format:ts": "npm run lint:ts -- --fix --quiet",
+    "lint": "npm run lint:ts && npm run lint:other",
+    "lint:other": "prettier --check '**/*.{md,yaml,yml}'",
+    "lint:quiet": "npm run lint:ts -- --quiet && npm run lint:other",
+    "lint:ts": "eslint --config .eslintrc.js --ext .ts,.js .",
     "test": "mocha --file ./mocha/setup.ts \"spec/**/*.spec.ts\"",
     "test:bin": "./scripts/bin-test/run.sh",
     "test:postmerge": "./integration_test/run_tests.sh"
@@ -194,7 +189,6 @@
     "@types/express": "4.17.3",
     "cors": "^2.8.5",
     "express": "^4.17.1",
-    "lodash": "^4.17.14",
     "node-fetch": "^2.6.7"
   },
   "devDependencies": {
@@ -204,17 +198,23 @@
     "@types/chai": "^4.1.7",
     "@types/chai-as-promised": "^7.1.0",
     "@types/jsonwebtoken": "^8.3.2",
-    "@types/lodash": "^4.14.135",
     "@types/mocha": "^5.2.7",
     "@types/mock-require": "^2.0.0",
     "@types/nock": "^10.0.3",
-    "@types/node": "^8.10.50",
+    "@types/node": "^14.18.24",
     "@types/node-fetch": "^3.0.3",
     "@types/sinon": "^7.0.13",
+    "@typescript-eslint/eslint-plugin": "^5.33.1",
+    "@typescript-eslint/parser": "^5.33.1",
     "api-extractor-model-me": "^0.1.1",
     "chai": "^4.2.0",
     "chai-as-promised": "^7.1.1",
     "child-process-promise": "^2.2.1",
+    "eslint": "^8.6.0",
+    "eslint-config-google": "^0.14.0",
+    "eslint-config-prettier": "^8.3.0",
+    "eslint-plugin-jsdoc": "^39.2.9",
+    "eslint-plugin-prettier": "^4.0.0",
     "firebase-admin": "^10.3.0",
     "js-yaml": "^3.13.1",
     "jsdom": "^16.2.1",
@@ -226,22 +226,17 @@
     "nock": "^10.0.6",
     "node-fetch": "^2.6.7",
     "portfinder": "^1.0.28",
-    "prettier": "^1.18.2",
+    "prettier": "^2.7.1",
     "semver": "^7.3.5",
     "sinon": "^7.3.2",
     "ts-node": "^10.4.0",
-    "tslint": "^5.18.0",
-    "tslint-config-prettier": "^1.18.0",
-    "tslint-no-unused-expression-chai": "^0.1.4",
-    "tslint-plugin-prettier": "^2.0.1",
-    "typedoc": "0.23.7",
     "typescript": "^4.3.5",
     "yargs": "^15.3.1"
   },
   "peerDependencies": {
-    "firebase-admin": "^8.0.0 || ^9.0.0 || ^10.0.0 || ^11.0.0"
+    "firebase-admin": "^10.0.0 || ^11.0.0"
   },
   "engines": {
-    "node": "^8.13.0 || >=10.10.0"
+    "node": ">=14.10.0"
   }
 }

package/lib/apps.d.ts

@@ -1,35 +0,0 @@
-import * as firebase from 'firebase-admin';
-export declare function apps(): apps.Apps;
-export declare namespace apps {
-    /** @hidden */
-    const garbageCollectionInterval: number;
-    /** @hidden */
-    function delay(delay: number): Promise<unknown>;
-    let singleton: apps.Apps;
-    let init: () => Apps;
-    interface AuthMode {
-        admin: boolean;
-        variable?: any;
-    }
-    /** @hidden */
-    interface RefCounter {
-        [appName: string]: number;
-    }
-    class Apps {
-        private _refCounter;
-        private _emulatedAdminApp?;
-        constructor();
-        _appAlive(appName: string): boolean;
-        _destroyApp(appName: string): void;
-        retain(): void;
-        release(): Promise<void>;
-        get admin(): firebase.app.App;
-        /**
-         * This function allows the Firebase Emulator Suite to override the FirebaseApp instance
-         * used by the Firebase Functions SDK. Developers should never call this function for
-         * other purposes.
-         */
-        setEmulatedAdminApp(app: firebase.app.App): void;
-        private get firebaseArgs();
-    }
-}