firebase-admin 9.12.0 → 10.0.0

package/lib/{firebase-namespace.js → app/firebase-namespace.js}

@@ -1,4 +1,4 @@
-/*! firebase-admin v9.12.0 */
+/*! firebase-admin v10.0.0 */
 "use strict";
 /*!
  * @license
@@ -17,141 +17,65 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FirebaseNamespace = exports.FirebaseNamespaceInternals = exports.FIREBASE_CONFIG_VAR = void 0;
-var fs = require("fs");
-var error_1 = require("./utils/error");
-var firebase_app_1 = require("./firebase-app");
-var credential_1 = require("./credential/credential");
-var credential_internal_1 = require("./credential/credential-internal");
-var validator = require("./utils/validator");
-var index_1 = require("./utils/index");
-var DEFAULT_APP_NAME = '[DEFAULT]';
-/**
- * Constant holding the environment variable name with the default config.
- * If the environment variable contains a string that starts with '{' it will be parsed as JSON,
- * otherwise it will be assumed to be pointing to a file.
- */
-exports.FIREBASE_CONFIG_VAR = 'FIREBASE_CONFIG';
+exports.defaultNamespace = exports.FirebaseNamespace = exports.FirebaseNamespaceInternals = void 0;
+var lifecycle_1 = require("./lifecycle");
+var credential_factory_1 = require("./credential-factory");
+var index_1 = require("../utils/index");
 /**
  * Internals of a FirebaseNamespace instance.
  */
 var FirebaseNamespaceInternals = /** @class */ (function () {
-    function FirebaseNamespaceInternals(firebase_) {
-        this.firebase_ = firebase_;
-        this.apps_ = {};
+    function FirebaseNamespaceInternals(appStore) {
+        this.appStore = appStore;
     }
     /**
      * Initializes the App instance.
      *
-     * @param options Optional options for the App instance. If none present will try to initialize
+     * @param options - Optional options for the App instance. If none present will try to initialize
      *   from the FIREBASE_CONFIG environment variable. If the environment variable contains a string
      *   that starts with '{' it will be parsed as JSON, otherwise it will be assumed to be pointing
      *   to a file.
-     * @param appName Optional name of the FirebaseApp instance.
+     * @param appName - Optional name of the FirebaseApp instance.
      *
-     * @return A new App instance.
+     * @returns A new App instance.
      */
     FirebaseNamespaceInternals.prototype.initializeApp = function (options, appName) {
-        if (appName === void 0) { appName = DEFAULT_APP_NAME; }
-        if (typeof options === 'undefined') {
-            options = this.loadOptionsFromEnvVar();
-            options.credential = credential_internal_1.getApplicationDefault();
-        }
-        if (typeof appName !== 'string' || appName === '') {
-            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_APP_NAME, "Invalid Firebase app name \"" + appName + "\" provided. App name must be a non-empty string.");
-        }
-        else if (appName in this.apps_) {
-            if (appName === DEFAULT_APP_NAME) {
-                throw new error_1.FirebaseAppError(error_1.AppErrorCodes.DUPLICATE_APP, 'The default Firebase app already exists. This means you called initializeApp() ' +
-                    'more than once without providing an app name as the second argument. In most cases ' +
-                    'you only need to call initializeApp() once. But if you do want to initialize ' +
-                    'multiple apps, pass a second argument to initializeApp() to give each app a unique ' +
-                    'name.');
-            }
-            else {
-                throw new error_1.FirebaseAppError(error_1.AppErrorCodes.DUPLICATE_APP, "Firebase app named \"" + appName + "\" already exists. This means you called initializeApp() " +
-                    'more than once with the same app name as the second argument. Make sure you provide a ' +
-                    'unique name every time you call initializeApp().');
-            }
-        }
-        var app = new firebase_app_1.FirebaseApp(options, appName, this);
-        this.apps_[appName] = app;
-        return app;
+        var app = this.appStore.initializeApp(options, appName);
+        return extendApp(app);
     };
     /**
      * Returns the App instance with the provided name (or the default App instance
      * if no name is provided).
      *
-     * @param appName Optional name of the FirebaseApp instance to return.
-     * @return The App instance which has the provided name.
+     * @param appName - Optional name of the FirebaseApp instance to return.
+     * @returns The App instance which has the provided name.
      */
     FirebaseNamespaceInternals.prototype.app = function (appName) {
-        if (appName === void 0) { appName = DEFAULT_APP_NAME; }
-        if (typeof appName !== 'string' || appName === '') {
-            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_APP_NAME, "Invalid Firebase app name \"" + appName + "\" provided. App name must be a non-empty string.");
-        }
-        else if (!(appName in this.apps_)) {
-            var errorMessage = (appName === DEFAULT_APP_NAME)
-                ? 'The default Firebase app does not exist. ' : "Firebase app named \"" + appName + "\" does not exist. ";
-            errorMessage += 'Make sure you call initializeApp() before using any of the Firebase services.';
-            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.NO_APP, errorMessage);
-        }
-        return this.apps_[appName];
+        var app = this.appStore.getApp(appName);
+        return extendApp(app);
     };
     Object.defineProperty(FirebaseNamespaceInternals.prototype, "apps", {
         /*
          * Returns an array of all the non-deleted App instances.
          */
         get: function () {
-            var _this = this;
-            // Return a copy so the caller cannot mutate the array
-            return Object.keys(this.apps_).map(function (appName) { return _this.apps_[appName]; });
+            return this.appStore.getApps().map(function (app) { return extendApp(app); });
         },
         enumerable: false,
         configurable: true
     });
-    /*
-     * Removes the specified App instance.
-     */
-    FirebaseNamespaceInternals.prototype.removeApp = function (appName) {
-        if (typeof appName === 'undefined') {
-            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_APP_NAME, 'No Firebase app name provided. App name must be a non-empty string.');
-        }
-        var appToRemove = this.app(appName);
-        delete this.apps_[appToRemove.name];
-    };
-    /**
-     * Parse the file pointed to by the FIREBASE_CONFIG_VAR, if it exists.
-     * Or if the FIREBASE_CONFIG_ENV contains a valid JSON object, parse it directly.
-     * If the environment variable contains a string that starts with '{' it will be parsed as JSON,
-     * otherwise it will be assumed to be pointing to a file.
-     */
-    FirebaseNamespaceInternals.prototype.loadOptionsFromEnvVar = function () {
-        var config = process.env[exports.FIREBASE_CONFIG_VAR];
-        if (!validator.isNonEmptyString(config)) {
-            return {};
-        }
-        try {
-            var contents = config.startsWith('{') ? config : fs.readFileSync(config, 'utf8');
-            return JSON.parse(contents);
-        }
-        catch (error) {
-            // Throw a nicely formed error message if the file contents cannot be parsed
-            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_APP_OPTIONS, 'Failed to parse app options file: ' + error);
-        }
-    };
     return FirebaseNamespaceInternals;
 }());
 exports.FirebaseNamespaceInternals = FirebaseNamespaceInternals;
 var firebaseCredential = {
-    cert: credential_1.cert, refreshToken: credential_1.refreshToken, applicationDefault: credential_1.applicationDefault
+    cert: credential_factory_1.cert, refreshToken: credential_factory_1.refreshToken, applicationDefault: credential_factory_1.applicationDefault
 };
 /**
  * Global Firebase context object.
  */
 var FirebaseNamespace = /** @class */ (function () {
     /* tslint:enable */
-    function FirebaseNamespace() {
+    function FirebaseNamespace(appStore) {
         // Hack to prevent Babel from modifying the object returned as the default admin namespace.
         /* tslint:disable:variable-name */
         this.__esModule = true;
@@ -162,7 +86,7 @@ var FirebaseNamespace = /** @class */ (function () {
         // TODO(jwenger): Database is the only consumer of firebase.Promise. We should update it to use
         // use the native Promise and then remove this.
         this.Promise = Promise;
-        this.INTERNAL = new FirebaseNamespaceInternals(this);
+        this.INTERNAL = new FirebaseNamespaceInternals(appStore !== null && appStore !== void 0 ? appStore : new lifecycle_1.AppStore());
     }
     Object.defineProperty(FirebaseNamespace.prototype, "auth", {
         /**
@@ -174,7 +98,7 @@ var FirebaseNamespace = /** @class */ (function () {
             var fn = function (app) {
                 return _this.ensureApp(app).auth();
             };
-            var auth = require('./auth/auth').Auth;
+            var auth = require('../auth/auth').Auth;
             return Object.assign(fn, { Auth: auth });
         },
         enumerable: false,
@@ -206,7 +130,7 @@ var FirebaseNamespace = /** @class */ (function () {
             var fn = function (app) {
                 return _this.ensureApp(app).messaging();
             };
-            var messaging = require('./messaging/messaging').Messaging;
+            var messaging = require('../messaging/messaging').Messaging;
             return Object.assign(fn, { Messaging: messaging });
         },
         enumerable: false,
@@ -222,7 +146,7 @@ var FirebaseNamespace = /** @class */ (function () {
             var fn = function (app) {
                 return _this.ensureApp(app).storage();
             };
-            var storage = require('./storage/storage').Storage;
+            var storage = require('../storage/storage').Storage;
             return Object.assign(fn, { Storage: storage });
         },
         enumerable: false,
@@ -269,7 +193,7 @@ var FirebaseNamespace = /** @class */ (function () {
             var fn = function (app) {
                 return _this.ensureApp(app).machineLearning();
             };
-            var machineLearning = require('./machine-learning/machine-learning').MachineLearning;
+            var machineLearning = require('../machine-learning/machine-learning').MachineLearning;
             return Object.assign(fn, { MachineLearning: machineLearning });
         },
         enumerable: false,
@@ -285,7 +209,7 @@ var FirebaseNamespace = /** @class */ (function () {
             var fn = function (app) {
                 return _this.ensureApp(app).installations();
             };
-            var installations = require('./installations/installations').Installations;
+            var installations = require('../installations/installations').Installations;
             return Object.assign(fn, { Installations: installations });
         },
         enumerable: false,
@@ -301,7 +225,7 @@ var FirebaseNamespace = /** @class */ (function () {
             var fn = function (app) {
                 return _this.ensureApp(app).instanceId();
             };
-            var instanceId = require('./instance-id/instance-id').InstanceId;
+            var instanceId = require('../instance-id/instance-id').InstanceId;
             return Object.assign(fn, { InstanceId: instanceId });
         },
         enumerable: false,
@@ -317,7 +241,7 @@ var FirebaseNamespace = /** @class */ (function () {
             var fn = function (app) {
                 return _this.ensureApp(app).projectManagement();
             };
-            var projectManagement = require('./project-management/project-management').ProjectManagement;
+            var projectManagement = require('../project-management/project-management').ProjectManagement;
             return Object.assign(fn, { ProjectManagement: projectManagement });
         },
         enumerable: false,
@@ -333,7 +257,7 @@ var FirebaseNamespace = /** @class */ (function () {
             var fn = function (app) {
                 return _this.ensureApp(app).securityRules();
             };
-            var securityRules = require('./security-rules/security-rules').SecurityRules;
+            var securityRules = require('../security-rules/security-rules').SecurityRules;
             return Object.assign(fn, { SecurityRules: securityRules });
         },
         enumerable: false,
@@ -349,7 +273,7 @@ var FirebaseNamespace = /** @class */ (function () {
             var fn = function (app) {
                 return _this.ensureApp(app).remoteConfig();
             };
-            var remoteConfig = require('./remote-config/remote-config').RemoteConfig;
+            var remoteConfig = require('../remote-config/remote-config').RemoteConfig;
             return Object.assign(fn, { RemoteConfig: remoteConfig });
         },
         enumerable: false,
@@ -365,7 +289,7 @@ var FirebaseNamespace = /** @class */ (function () {
             var fn = function (app) {
                 return _this.ensureApp(app).appCheck();
             };
-            var appCheck = require('./app-check/app-check').AppCheck;
+            var appCheck = require('../app-check/app-check').AppCheck;
             return Object.assign(fn, { AppCheck: appCheck });
         },
         enumerable: false,
@@ -375,13 +299,13 @@ var FirebaseNamespace = /** @class */ (function () {
     /**
      * Initializes the FirebaseApp instance.
      *
-     * @param options Optional options for the FirebaseApp instance.
+     * @param options - Optional options for the FirebaseApp instance.
      *   If none present will try to initialize from the FIREBASE_CONFIG environment variable.
      *   If the environment variable contains a string that starts with '{' it will be parsed as JSON,
      *   otherwise it will be assumed to be pointing to a file.
-     * @param appName Optional name of the FirebaseApp instance.
+     * @param appName - Optional name of the FirebaseApp instance.
      *
-     * @return A new FirebaseApp instance.
+     * @returns A new FirebaseApp instance.
      */
     FirebaseNamespace.prototype.initializeApp = function (options, appName) {
         return this.INTERNAL.initializeApp(options, appName);
@@ -390,8 +314,8 @@ var FirebaseNamespace = /** @class */ (function () {
      * Returns the FirebaseApp instance with the provided name (or the default FirebaseApp instance
      * if no name is provided).
      *
-     * @param appName Optional name of the FirebaseApp instance to return.
-     * @return The FirebaseApp instance which has the provided name.
+     * @param appName - Optional name of the FirebaseApp instance to return.
+     * @returns The FirebaseApp instance which has the provided name.
      */
     FirebaseNamespace.prototype.app = function (appName) {
         return this.INTERNAL.app(appName);
@@ -415,3 +339,67 @@ var FirebaseNamespace = /** @class */ (function () {
     return FirebaseNamespace;
 }());
 exports.FirebaseNamespace = FirebaseNamespace;
+/**
+ * In order to maintain backward compatibility, we instantiate a default namespace instance in
+ * this module, and delegate all app lifecycle operations to it. In a future implementation where
+ * the old admin namespace is no longer supported, we should remove this.
+ *
+ * @internal
+ */
+exports.defaultNamespace = new FirebaseNamespace(lifecycle_1.defaultAppStore);
+function extendApp(app) {
+    var result = app;
+    if (result.__extended) {
+        return result;
+    }
+    result.auth = function () {
+        var fn = require('../auth/index').getAuth;
+        return fn(app);
+    };
+    result.appCheck = function () {
+        var fn = require('../app-check/index').getAppCheck;
+        return fn(app);
+    };
+    result.database = function (url) {
+        var fn = require('../database/index').getDatabaseWithUrl;
+        return fn(url, app);
+    };
+    result.messaging = function () {
+        var fn = require('../messaging/index').getMessaging;
+        return fn(app);
+    };
+    result.storage = function () {
+        var fn = require('../storage/index').getStorage;
+        return fn(app);
+    };
+    result.firestore = function () {
+        var fn = require('../firestore/index').getFirestore;
+        return fn(app);
+    };
+    result.instanceId = function () {
+        var fn = require('../instance-id/index').getInstanceId;
+        return fn(app);
+    };
+    result.installations = function () {
+        var fn = require('../installations/index').getInstallations;
+        return fn(app);
+    };
+    result.machineLearning = function () {
+        var fn = require('../machine-learning/index').getMachineLearning;
+        return fn(app);
+    };
+    result.projectManagement = function () {
+        var fn = require('../project-management/index').getProjectManagement;
+        return fn(app);
+    };
+    result.securityRules = function () {
+        var fn = require('../security-rules/index').getSecurityRules;
+        return fn(app);
+    };
+    result.remoteConfig = function () {
+        var fn = require('../remote-config/index').getRemoteConfig;
+        return fn(app);
+    };
+    result.__extended = true;
+    return result;
+}

package/lib/app/index.d.ts

@@ -0,0 +1,27 @@
+/*! firebase-admin v10.0.0 */
+/*!
+ * @license
+ * Copyright 2021 Google Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Firebase App and SDK initialization.
+ *
+ * @packageDocumentation
+ */
+export { App, AppOptions, FirebaseArrayIndexError, FirebaseError } from './core';
+export { initializeApp, getApp, getApps, deleteApp } from './lifecycle';
+export { Credential, ServiceAccount, GoogleOAuthAccessToken } from './credential';
+export { applicationDefault, cert, refreshToken } from './credential-factory';
+export declare const SDK_VERSION: string;

package/lib/app/index.js

@@ -0,0 +1,31 @@
+/*! firebase-admin v10.0.0 */
+"use strict";
+/*!
+ * @license
+ * Copyright 2021 Google Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SDK_VERSION = void 0;
+var utils_1 = require("../utils");
+var lifecycle_1 = require("./lifecycle");
+Object.defineProperty(exports, "initializeApp", { enumerable: true, get: function () { return lifecycle_1.initializeApp; } });
+Object.defineProperty(exports, "getApp", { enumerable: true, get: function () { return lifecycle_1.getApp; } });
+Object.defineProperty(exports, "getApps", { enumerable: true, get: function () { return lifecycle_1.getApps; } });
+Object.defineProperty(exports, "deleteApp", { enumerable: true, get: function () { return lifecycle_1.deleteApp; } });
+var credential_factory_1 = require("./credential-factory");
+Object.defineProperty(exports, "applicationDefault", { enumerable: true, get: function () { return credential_factory_1.applicationDefault; } });
+Object.defineProperty(exports, "cert", { enumerable: true, get: function () { return credential_factory_1.cert; } });
+Object.defineProperty(exports, "refreshToken", { enumerable: true, get: function () { return credential_factory_1.refreshToken; } });
+exports.SDK_VERSION = utils_1.getSdkVersion();

package/lib/app/lifecycle.d.ts

@@ -0,0 +1,60 @@
+/*! firebase-admin v10.0.0 */
+/*!
+ * @license
+ * Copyright 2021 Google Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { App, AppOptions } from './core';
+export declare class AppStore {
+    private readonly appStore;
+    initializeApp(options?: AppOptions, appName?: string): App;
+    getApp(appName?: string): App;
+    getApps(): App[];
+    deleteApp(app: App): Promise<void>;
+    clearAllApps(): Promise<void>;
+    /**
+     * Removes the specified App instance from the store. This is currently called by the
+     * {@link FirebaseApp.delete} method. Can be removed once the app deletion is handled
+     * entirely by the {@link deleteApp} top-level function.
+     */
+    removeApp(appName: string): void;
+}
+export declare const defaultAppStore: AppStore;
+export declare function initializeApp(options?: AppOptions, appName?: string): App;
+export declare function getApp(appName?: string): App;
+export declare function getApps(): App[];
+/**
+ * Renders this given `App` unusable and frees the resources of
+ * all associated services (though it does *not* clean up any backend
+ * resources). When running the SDK locally, this method
+ * must be called to ensure graceful termination of the process.
+ *
+ * @example
+ * ```javascript
+ * deleteApp(app)
+ *   .then(function() {
+ *     console.log("App deleted successfully");
+ *   })
+ *   .catch(function(error) {
+ *     console.log("Error deleting app:", error);
+ *   });
+ * ```
+ */
+export declare function deleteApp(app: App): Promise<void>;
+/**
+ * Constant holding the environment variable name with the default config.
+ * If the environment variable contains a string that starts with '{' it will be parsed as JSON,
+ * otherwise it will be assumed to be pointing to a file.
+ */
+export declare const FIREBASE_CONFIG_VAR = "FIREBASE_CONFIG";

package/lib/app/lifecycle.js

@@ -0,0 +1,165 @@
+/*! firebase-admin v10.0.0 */
+"use strict";
+/*!
+ * @license
+ * Copyright 2021 Google Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FIREBASE_CONFIG_VAR = exports.deleteApp = exports.getApps = exports.getApp = exports.initializeApp = exports.defaultAppStore = exports.AppStore = void 0;
+var fs = require("fs");
+var validator = require("../utils/validator");
+var error_1 = require("../utils/error");
+var credential_internal_1 = require("./credential-internal");
+var firebase_app_1 = require("./firebase-app");
+var DEFAULT_APP_NAME = '[DEFAULT]';
+var AppStore = /** @class */ (function () {
+    function AppStore() {
+        this.appStore = new Map();
+    }
+    AppStore.prototype.initializeApp = function (options, appName) {
+        if (appName === void 0) { appName = DEFAULT_APP_NAME; }
+        if (typeof options === 'undefined') {
+            options = loadOptionsFromEnvVar();
+            options.credential = credential_internal_1.getApplicationDefault();
+        }
+        if (typeof appName !== 'string' || appName === '') {
+            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_APP_NAME, "Invalid Firebase app name \"" + appName + "\" provided. App name must be a non-empty string.");
+        }
+        else if (this.appStore.has(appName)) {
+            if (appName === DEFAULT_APP_NAME) {
+                throw new error_1.FirebaseAppError(error_1.AppErrorCodes.DUPLICATE_APP, 'The default Firebase app already exists. This means you called initializeApp() ' +
+                    'more than once without providing an app name as the second argument. In most cases ' +
+                    'you only need to call initializeApp() once. But if you do want to initialize ' +
+                    'multiple apps, pass a second argument to initializeApp() to give each app a unique ' +
+                    'name.');
+            }
+            else {
+                throw new error_1.FirebaseAppError(error_1.AppErrorCodes.DUPLICATE_APP, "Firebase app named \"" + appName + "\" already exists. This means you called initializeApp() " +
+                    'more than once with the same app name as the second argument. Make sure you provide a ' +
+                    'unique name every time you call initializeApp().');
+            }
+        }
+        var app = new firebase_app_1.FirebaseApp(options, appName, this);
+        this.appStore.set(app.name, app);
+        return app;
+    };
+    AppStore.prototype.getApp = function (appName) {
+        if (appName === void 0) { appName = DEFAULT_APP_NAME; }
+        if (typeof appName !== 'string' || appName === '') {
+            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_APP_NAME, "Invalid Firebase app name \"" + appName + "\" provided. App name must be a non-empty string.");
+        }
+        else if (!this.appStore.has(appName)) {
+            var errorMessage = (appName === DEFAULT_APP_NAME)
+                ? 'The default Firebase app does not exist. ' : "Firebase app named \"" + appName + "\" does not exist. ";
+            errorMessage += 'Make sure you call initializeApp() before using any of the Firebase services.';
+            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.NO_APP, errorMessage);
+        }
+        return this.appStore.get(appName);
+    };
+    AppStore.prototype.getApps = function () {
+        // Return a copy so the caller cannot mutate the array
+        return Array.from(this.appStore.values());
+    };
+    AppStore.prototype.deleteApp = function (app) {
+        if (typeof app !== 'object' || app === null || !('options' in app)) {
+            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_ARGUMENT, 'Invalid app argument.');
+        }
+        // Make sure the given app already exists.
+        var existingApp = getApp(app.name);
+        // Delegate delete operation to the App instance itself. That will also remove the App
+        // instance from the AppStore.
+        return existingApp.delete();
+    };
+    AppStore.prototype.clearAllApps = function () {
+        var _this = this;
+        var promises = [];
+        this.getApps().forEach(function (app) {
+            promises.push(_this.deleteApp(app));
+        });
+        return Promise.all(promises).then();
+    };
+    /**
+     * Removes the specified App instance from the store. This is currently called by the
+     * {@link FirebaseApp.delete} method. Can be removed once the app deletion is handled
+     * entirely by the {@link deleteApp} top-level function.
+     */
+    AppStore.prototype.removeApp = function (appName) {
+        this.appStore.delete(appName);
+    };
+    return AppStore;
+}());
+exports.AppStore = AppStore;
+exports.defaultAppStore = new AppStore();
+function initializeApp(options, appName) {
+    if (appName === void 0) { appName = DEFAULT_APP_NAME; }
+    return exports.defaultAppStore.initializeApp(options, appName);
+}
+exports.initializeApp = initializeApp;
+function getApp(appName) {
+    if (appName === void 0) { appName = DEFAULT_APP_NAME; }
+    return exports.defaultAppStore.getApp(appName);
+}
+exports.getApp = getApp;
+function getApps() {
+    return exports.defaultAppStore.getApps();
+}
+exports.getApps = getApps;
+/**
+ * Renders this given `App` unusable and frees the resources of
+ * all associated services (though it does *not* clean up any backend
+ * resources). When running the SDK locally, this method
+ * must be called to ensure graceful termination of the process.
+ *
+ * @example
+ * ```javascript
+ * deleteApp(app)
+ *   .then(function() {
+ *     console.log("App deleted successfully");
+ *   })
+ *   .catch(function(error) {
+ *     console.log("Error deleting app:", error);
+ *   });
+ * ```
+ */
+function deleteApp(app) {
+    return exports.defaultAppStore.deleteApp(app);
+}
+exports.deleteApp = deleteApp;
+/**
+ * Constant holding the environment variable name with the default config.
+ * If the environment variable contains a string that starts with '{' it will be parsed as JSON,
+ * otherwise it will be assumed to be pointing to a file.
+ */
+exports.FIREBASE_CONFIG_VAR = 'FIREBASE_CONFIG';
+/**
+ * Parse the file pointed to by the FIREBASE_CONFIG_VAR, if it exists.
+ * Or if the FIREBASE_CONFIG_ENV contains a valid JSON object, parse it directly.
+ * If the environment variable contains a string that starts with '{' it will be parsed as JSON,
+ * otherwise it will be assumed to be pointing to a file.
+ */
+function loadOptionsFromEnvVar() {
+    var config = process.env[exports.FIREBASE_CONFIG_VAR];
+    if (!validator.isNonEmptyString(config)) {
+        return {};
+    }
+    try {
+        var contents = config.startsWith('{') ? config : fs.readFileSync(config, 'utf8');
+        return JSON.parse(contents);
+    }
+    catch (error) {
+        // Throw a nicely formed error message if the file contents cannot be parsed
+        throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_APP_OPTIONS, 'Failed to parse app options file: ' + error);
+    }
+}