firebase-admin 13.9.0 → 14.0.0

package/README.md

@@ -59,8 +59,7 @@ requests, code review feedback, and also pull requests.
 
 ## Supported Environments
 
-We currently support Node.js 18 and higher, but support for Node.js 18 and Node.js 20 is deprecated. We strongly encourage
-you to use Node.js 22 or higher as we will drop support for Node.js 18 and Node.js 20 in the next major version.
+We currently support Node.js 22 and higher.
 
 Please also note that the Admin SDK should only
 be used in server-side/back-end environments controlled by the app developer.

package/lib/app/core.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 /*!
  * @license
  * Copyright 2021 Google LLC
@@ -17,6 +17,7 @@
  */
 import { Agent } from 'http';
 import { Credential } from './credential';
+import { FirebaseError } from '../utils/error';
 /**
  * Available options to pass to {@link firebase-admin.app#initializeApp}.
  */
@@ -113,43 +114,6 @@ export interface App {
      */
     options: AppOptions;
 }
-/**
- * `FirebaseError` is a subclass of the standard JavaScript `Error` object. In
- * addition to a message string and stack trace, it contains a string code.
- */
-export interface FirebaseError {
-    /**
-     * Error codes are strings using the following format: `"service/string-code"`.
-     * Some examples include `"auth/invalid-uid"` and
-     * `"messaging/invalid-recipient"`.
-     *
-     * While the message for a given error can change, the code will remain the same
-     * between backward-compatible versions of the Firebase SDK.
-     */
-    code: string;
-    /**
-     * An explanatory message for the error that just occurred.
-     *
-     * This message is designed to be helpful to you, the developer. Because
-     * it generally does not convey meaningful information to end users,
-     * this message should not be displayed in your application.
-     */
-    message: string;
-    /**
-     * A string value containing the execution backtrace when the error originally
-     * occurred.
-     *
-     * This information can be useful for troubleshooting the cause of the error with
-     * {@link https://firebase.google.com/support | Firebase Support}.
-     */
-    stack?: string;
-    /**
-     * Returns a JSON-serializable object representation of this error.
-     *
-     * @returns A JSON-serializable representation of this object.
-     */
-    toJSON(): object;
-}
 /**
  * Composite type which includes both a `FirebaseError` object and an index
  * which can be used to get the errored item.

package/lib/app/core.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * @license

package/lib/app/credential-factory.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 /*!
  * @license
  * Copyright 2021 Google LLC

package/lib/app/credential-factory.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * @license

package/lib/app/credential-internal.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 /*!
  * @license
  * Copyright 2020 Google LLC

package/lib/app/credential-internal.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * @license
@@ -21,8 +21,9 @@ exports.ImpersonatedServiceAccountCredential = exports.RefreshTokenCredential =
 exports.isApplicationDefault = isApplicationDefault;
 exports.getApplicationDefault = getApplicationDefault;
 const fs = require("fs");
+const node_crypto_1 = require("node:crypto");
 const google_auth_library_1 = require("google-auth-library");
-const error_1 = require("../utils/error");
+const error_1 = require("./error");
 const util = require("../utils/validator");
 const SCOPES = [
     'https://www.googleapis.com/auth/cloud-platform',
@@ -82,7 +83,10 @@ class ApplicationDefaultCredential {
             return this.authClient.fetchIdToken(audience);
         }
         else {
-            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_CREDENTIAL, 'Credentials type should be Compute Engine Credentials.');
+            throw new error_1.FirebaseAppError({
+                code: error_1.AppErrorCode.INVALID_CREDENTIAL,
+                message: 'Credentials type should be Compute Engine Credentials.'
+            });
         }
     }
     async getServiceAccountEmail() {
@@ -150,12 +154,19 @@ class ServiceAccount {
         }
         catch (error) {
             // Throw a nicely formed error message if the file contents cannot be parsed
-            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_CREDENTIAL, 'Failed to parse service account json file: ' + error);
+            throw new error_1.FirebaseAppError({
+                code: error_1.AppErrorCode.INVALID_CREDENTIAL,
+                message: `Failed to parse service account json file: ${error.message}`,
+                cause: error,
+            });
         }
     }
     constructor(json) {
         if (!util.isNonNullObject(json)) {
-            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_CREDENTIAL, 'Service account must be an object.');
+            throw new error_1.FirebaseAppError({
+                code: error_1.AppErrorCode.INVALID_CREDENTIAL,
+                message: 'Service account must be an object.'
+            });
         }
         copyAttr(this, json, 'projectId', 'project_id');
         copyAttr(this, json, 'privateKey', 'private_key');
@@ -171,15 +182,18 @@ class ServiceAccount {
             errorMessage = 'Service account object must contain a string "client_email" property.';
         }
         if (typeof errorMessage !== 'undefined') {
-            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_CREDENTIAL, errorMessage);
+            throw new error_1.FirebaseAppError({ code: error_1.AppErrorCode.INVALID_CREDENTIAL, message: errorMessage });
         }
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        const forge = require('node-forge');
+        // Validate private key format using native crypto module
         try {
-            forge.pki.privateKeyFromPem(this.privateKey);
+            (0, node_crypto_1.createPrivateKey)(this.privateKey);
         }
         catch (error) {
-            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_CREDENTIAL, 'Failed to parse private key: ' + error);
+            throw new error_1.FirebaseAppError({
+                code: error_1.AppErrorCode.INVALID_CREDENTIAL,
+                message: 'Failed to parse private key.',
+                cause: error,
+            });
         }
     }
 }
@@ -237,7 +251,11 @@ class RefreshToken {
         }
         catch (error) {
             // Throw a nicely formed error message if the file contents cannot be parsed
-            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_CREDENTIAL, 'Failed to parse refresh token file: ' + error);
+            throw new error_1.FirebaseAppError({
+                code: error_1.AppErrorCode.INVALID_CREDENTIAL,
+                message: 'Failed to parse refresh token file.',
+                cause: error,
+            });
         }
     }
     static validateFromJSON(json) {
@@ -260,7 +278,7 @@ class RefreshToken {
             errorMessage = 'Refresh token must contain a "type" property.';
         }
         if (typeof errorMessage !== 'undefined') {
-            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_CREDENTIAL, errorMessage);
+            throw new error_1.FirebaseAppError({ code: error_1.AppErrorCode.INVALID_CREDENTIAL, message: errorMessage });
         }
     }
 }
@@ -321,7 +339,11 @@ class ImpersonatedServiceAccount {
         }
         catch (error) {
             // Throw a nicely formed error message if the file contents cannot be parsed
-            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_CREDENTIAL, 'Failed to parse impersonated service account file: ' + error);
+            throw new error_1.FirebaseAppError({
+                code: error_1.AppErrorCode.INVALID_CREDENTIAL,
+                message: 'Failed to parse impersonated service account file.',
+                cause: error,
+            });
         }
     }
     static validateFromJSON(json) {
@@ -340,7 +362,7 @@ class ImpersonatedServiceAccount {
             errorMessage = 'Impersonated Service Account must contain a "source_credentials.type" property.';
         }
         if (typeof errorMessage !== 'undefined') {
-            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_CREDENTIAL, errorMessage);
+            throw new error_1.FirebaseAppError({ code: error_1.AppErrorCode.INVALID_CREDENTIAL, message: errorMessage });
         }
     }
 }
@@ -389,7 +411,10 @@ function populateGoogleAuth(keyFile, httpAgent) {
     });
     if (typeof keyFile === 'object') {
         if (!util.isNonNullObject(keyFile)) {
-            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_CREDENTIAL, 'Service account must be an object.');
+            throw new error_1.FirebaseAppError({
+                code: error_1.AppErrorCode.INVALID_CREDENTIAL,
+                message: 'Service account must be an object.'
+            });
         }
         copyAttr(keyFile, keyFile, 'project_id', 'projectId');
         copyAttr(keyFile, keyFile, 'private_key', 'privateKey');
@@ -405,9 +430,15 @@ function populateCredential(credentials) {
     const accessToken = credentials?.access_token;
     const expiryDate = credentials?.expiry_date;
     if (typeof accessToken !== 'string')
-        throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_CREDENTIAL, 'Failed to parse Google auth credential: access_token must be a non empty string.');
+        throw new error_1.FirebaseAppError({
+            code: error_1.AppErrorCode.INVALID_CREDENTIAL,
+            message: 'Failed to parse Google auth credential: access_token must be a non empty string.'
+        });
     if (typeof expiryDate !== 'number')
-        throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_CREDENTIAL, 'Failed to parse Google auth credential: Invalid expiry_date.');
+        throw new error_1.FirebaseAppError({
+            code: error_1.AppErrorCode.INVALID_CREDENTIAL,
+            message: 'Failed to parse Google auth credential: Invalid expiry_date.'
+        });
     return {
         ...credentials,
         access_token: accessToken,

package/lib/app/credential.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 /*!
  * @license
  * Copyright 2021 Google LLC

package/lib/app/credential.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * @license

package/lib/app/error.d.ts

@@ -0,0 +1,47 @@
+/*! firebase-admin v14.0.0 */
+/*!
+ * Copyright 2026 Google LLC
+ *
+ * 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 { ErrorInfo, FirebaseError } from '../utils/error';
+/**
+ * Firebase App error code structure. This extends `FirebaseError`.
+ */
+export declare class FirebaseAppError extends FirebaseError {
+    /**
+     * @param info - The error code info.
+     * @param message - The error message. This will override the default message if provided.
+     */
+    constructor(info: ErrorInfo, message?: string);
+}
+/**
+ * The constant mapping for valid App client error codes.
+ */
+export declare const AppErrorCode: {
+    readonly APP_DELETED: "app-deleted";
+    readonly DUPLICATE_APP: "duplicate-app";
+    readonly INVALID_ARGUMENT: "invalid-argument";
+    readonly INTERNAL_ERROR: "internal-error";
+    readonly INVALID_APP_NAME: "invalid-app-name";
+    readonly INVALID_APP_OPTIONS: "invalid-app-options";
+    readonly INVALID_CREDENTIAL: "invalid-credential";
+    readonly NETWORK_ERROR: "network-error";
+    readonly NETWORK_TIMEOUT: "network-timeout";
+    readonly NO_APP: "no-app";
+    readonly UNABLE_TO_PARSE_RESPONSE: "unable-to-parse-response";
+};
+/**
+ * The type definition for valid App client error codes.
+ */
+export type AppErrorCode = typeof AppErrorCode[keyof typeof AppErrorCode];

package/lib/app/error.js

@@ -0,0 +1,57 @@
+/*! firebase-admin v14.0.0 */
+"use strict";
+/*!
+ * Copyright 2026 Google LLC
+ *
+ * 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.AppErrorCode = exports.FirebaseAppError = void 0;
+const error_1 = require("../utils/error");
+/**
+ * Firebase App error code structure. This extends `FirebaseError`.
+ */
+class FirebaseAppError extends error_1.FirebaseError {
+    /**
+     * @param info - The error code info.
+     * @param message - The error message. This will override the default message if provided.
+     */
+    constructor(info, message) {
+        // Override default message if custom message provided.
+        super({
+            code: `app/${info.code}`,
+            message: message || info.message,
+            httpResponse: info.httpResponse,
+            cause: info.cause,
+        });
+        /** @internal */
+        this.codePrefix = 'app';
+    }
+}
+exports.FirebaseAppError = FirebaseAppError;
+/**
+ * The constant mapping for valid App client error codes.
+ */
+exports.AppErrorCode = {
+    APP_DELETED: 'app-deleted',
+    DUPLICATE_APP: 'duplicate-app',
+    INVALID_ARGUMENT: 'invalid-argument',
+    INTERNAL_ERROR: 'internal-error',
+    INVALID_APP_NAME: 'invalid-app-name',
+    INVALID_APP_OPTIONS: 'invalid-app-options',
+    INVALID_CREDENTIAL: 'invalid-credential',
+    NETWORK_ERROR: 'network-error',
+    NETWORK_TIMEOUT: 'network-timeout',
+    NO_APP: 'no-app',
+    UNABLE_TO_PARSE_RESPONSE: 'unable-to-parse-response',
+};

package/lib/app/firebase-app.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 /*!
  * @license
  * Copyright 2017 Google LLC

package/lib/app/firebase-app.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * @license
@@ -21,7 +21,7 @@ exports.FirebaseApp = exports.FirebaseAppInternals = void 0;
 const credential_internal_1 = require("./credential-internal");
 const validator = require("../utils/validator");
 const deep_copy_1 = require("../utils/deep-copy");
-const error_1 = require("../utils/error");
+const error_1 = require("./error");
 const TOKEN_EXPIRY_THRESHOLD_MILLIS = 5 * 60 * 1000;
 /**
  * Internals of a FirebaseApp instance.
@@ -51,9 +51,12 @@ class FirebaseAppInternals {
             if (!validator.isNonNullObject(result) ||
                 typeof result.expires_in !== 'number' ||
                 typeof result.access_token !== 'string') {
-                throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_CREDENTIAL, `Invalid access token generated: "${JSON.stringify(result)}". Valid access ` +
-                    'tokens must be an object with the "expires_in" (number) and "access_token" ' +
-                    '(string) properties.');
+                throw new error_1.FirebaseAppError({
+                    code: error_1.AppErrorCode.INVALID_CREDENTIAL,
+                    message: `Invalid access token generated: "${JSON.stringify(result)}". Valid access ` +
+                        'tokens must be an object with the "expires_in" (number) and "access_token" ' +
+                        '(string) properties.',
+                });
             }
             const token = {
                 accessToken: result.access_token,
@@ -84,7 +87,11 @@ class FirebaseAppInternals {
                     'not, generate a new key file at ' +
                     'https://console.firebase.google.com/project/_/settings/serviceaccounts/adminsdk.';
             }
-            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_CREDENTIAL, errorMessage);
+            throw new error_1.FirebaseAppError({
+                code: error_1.AppErrorCode.INVALID_CREDENTIAL,
+                message: errorMessage,
+                cause: error
+            });
         })
             .finally(() => {
             this.isRefreshing = false;
@@ -131,8 +138,11 @@ class FirebaseApp {
         this.options_ = (0, deep_copy_1.deepCopy)(options);
         this.autoInit_ = autoInit;
         if (!validator.isNonNullObject(this.options_)) {
-            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_APP_OPTIONS, 'Invalid Firebase app options passed as the first argument to initializeApp() for the ' +
-                `app named "${this.name_}". Options must be a non-null object.`);
+            throw new error_1.FirebaseAppError({
+                code: error_1.AppErrorCode.INVALID_APP_OPTIONS,
+                message: 'Invalid Firebase app options passed as the first argument to initializeApp() for the ' +
+                    `app named "${this.name_}". Options must be a non-null object.`
+            });
         }
         const hasCredential = ('credential' in this.options_);
         if (!hasCredential) {
@@ -141,9 +151,12 @@ class FirebaseApp {
         }
         const credential = this.options_.credential;
         if (typeof credential !== 'object' || credential === null || typeof credential.getAccessToken !== 'function') {
-            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_APP_OPTIONS, 'Invalid Firebase app options passed as the first argument to initializeApp() for the ' +
-                `app named "${this.name_}". The "credential" property must be an object which implements ` +
-                'the Credential interface.');
+            throw new error_1.FirebaseAppError({
+                code: error_1.AppErrorCode.INVALID_APP_OPTIONS,
+                message: 'Invalid Firebase app options passed as the first argument to initializeApp() for the ' +
+                    `app named "${this.name_}". The "credential" property must be an object which implements ` +
+                    'the Credential interface.'
+            });
         }
         this.INTERNAL = new FirebaseAppInternals(credential);
     }
@@ -224,7 +237,10 @@ class FirebaseApp {
     // eslint-disable-next-line @typescript-eslint/naming-convention
     checkDestroyed_() {
         if (this.isDeleted_) {
-            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.APP_DELETED, `Firebase app named "${this.name_}" has already been deleted.`);
+            throw new error_1.FirebaseAppError({
+                code: error_1.AppErrorCode.APP_DELETED,
+                message: `Firebase app named "${this.name_}" has already been deleted.`
+            });
         }
     }
 }

package/lib/app/index.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 /*!
  * @license
  * Copyright 2021 Google LLC
@@ -20,9 +20,10 @@
  *
  * @packageDocumentation
  */
-export { App, AppOptions, FirebaseArrayIndexError, FirebaseError } from './core';
+export { App, AppOptions, FirebaseArrayIndexError } from './core';
 export { initializeApp, getApp, getApps, deleteApp } from './lifecycle';
 export { Credential, ServiceAccount, GoogleOAuthAccessToken } from './credential';
 export { applicationDefault, cert, refreshToken } from './credential-factory';
-export { FirebaseAppError, AppErrorCodes } from '../utils/error';
+export { FirebaseError, ErrorInfo, HttpResponse } from '../utils/error';
+export { FirebaseAppError, AppErrorCode } from './error';
 export declare const SDK_VERSION: string;

package/lib/app/index.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * @license
@@ -17,7 +17,7 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SDK_VERSION = exports.AppErrorCodes = exports.FirebaseAppError = exports.refreshToken = exports.cert = exports.applicationDefault = exports.deleteApp = exports.getApps = exports.getApp = exports.initializeApp = void 0;
+exports.SDK_VERSION = exports.AppErrorCode = exports.FirebaseAppError = exports.FirebaseError = exports.refreshToken = exports.cert = exports.applicationDefault = exports.deleteApp = exports.getApps = exports.getApp = exports.initializeApp = void 0;
 const utils_1 = require("../utils");
 var lifecycle_1 = require("./lifecycle");
 Object.defineProperty(exports, "initializeApp", { enumerable: true, get: function () { return lifecycle_1.initializeApp; } });
@@ -29,6 +29,8 @@ Object.defineProperty(exports, "applicationDefault", { enumerable: true, get: fu
 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; } });
 var error_1 = require("../utils/error");
-Object.defineProperty(exports, "FirebaseAppError", { enumerable: true, get: function () { return error_1.FirebaseAppError; } });
-Object.defineProperty(exports, "AppErrorCodes", { enumerable: true, get: function () { return error_1.AppErrorCodes; } });
+Object.defineProperty(exports, "FirebaseError", { enumerable: true, get: function () { return error_1.FirebaseError; } });
+var error_2 = require("./error");
+Object.defineProperty(exports, "FirebaseAppError", { enumerable: true, get: function () { return error_2.FirebaseAppError; } });
+Object.defineProperty(exports, "AppErrorCode", { enumerable: true, get: function () { return error_2.AppErrorCode; } });
 exports.SDK_VERSION = (0, utils_1.getSdkVersion)();

package/lib/app/lifecycle.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 /*!
  * @license
  * Copyright 2021 Google LLC
@@ -74,7 +74,7 @@ export declare const defaultAppStore: AppStore;
 export declare function initializeApp(options?: AppOptions, appName?: string): App;
 /**
  * Returns an existing {@link App} instance for the provided name. If no name
- * is provided the the default app name is used.
+ * is provided the default app name is used.
  *
  * @param appName - Optional name of the `App` instance.
  *

package/lib/app/lifecycle.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * @license
@@ -24,7 +24,7 @@ exports.getApps = getApps;
 exports.deleteApp = deleteApp;
 const fs = require("fs");
 const validator = require("../utils/validator");
-const error_1 = require("../utils/error");
+const error_1 = require("./error");
 const credential_internal_1 = require("./credential-internal");
 const firebase_app_1 = require("./firebase-app");
 const fastDeepEqual = require('fast-deep-equal');
@@ -51,7 +51,10 @@ class AppStore {
         const currentApp = this.appStore.get(appName);
         // Ensure the `autoInit` state matches the existing app's. If not, throw.
         if (currentApp.autoInit() !== autoInit) {
-            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_APP_OPTIONS, `A Firebase app named "${appName}" already exists with a different configuration.`);
+            throw new error_1.FirebaseAppError({
+                code: error_1.AppErrorCode.INVALID_APP_OPTIONS,
+                message: `A Firebase app named "${appName}" already exists with a different configuration.`
+            });
         }
         if (autoInit) {
             // Auto-initialization is triggered when no options were passed to
@@ -66,7 +69,10 @@ class AppStore {
         const currentAppOptions = { ...currentApp.options };
         delete currentAppOptions.credential;
         if (!fastDeepEqual(options, currentAppOptions)) {
-            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.DUPLICATE_APP, `A Firebase app named "${appName}" already exists with a different configuration.`);
+            throw new error_1.FirebaseAppError({
+                code: error_1.AppErrorCode.DUPLICATE_APP,
+                message: `A Firebase app named "${appName}" already exists with a different configuration.`
+            });
         }
         return currentApp;
     }
@@ -76,7 +82,7 @@ class AppStore {
             let 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);
+            throw new error_1.FirebaseAppError({ code: error_1.AppErrorCode.NO_APP, message: errorMessage });
         }
         return this.appStore.get(appName);
     }
@@ -86,7 +92,7 @@ class AppStore {
     }
     deleteApp(app) {
         if (typeof app !== 'object' || app === null || !('options' in app)) {
-            throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_ARGUMENT, 'Invalid app argument.');
+            throw new error_1.FirebaseAppError({ code: error_1.AppErrorCode.INVALID_ARGUMENT, message: 'Invalid app argument.' });
         }
         // Make sure the given app already exists.
         const existingApp = getApp(app.name);
@@ -127,25 +133,37 @@ exports.AppStore = AppStore;
 function validateAppOptionsSupportDeepEquals(requestedOptions, existingApp) {
     // http.Agent checks.
     if (typeof requestedOptions.httpAgent !== 'undefined') {
-        throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_APP_OPTIONS, `Firebase app named "${existingApp.name}" already exists and initializeApp was` +
-            ' invoked with an optional http.Agent. The SDK cannot confirm the equality' +
-            ' of http.Agent objects with the existing app. Please use getApp or getApps to reuse' +
-            ' the existing app instead.');
+        throw new error_1.FirebaseAppError({
+            code: error_1.AppErrorCode.INVALID_APP_OPTIONS,
+            message: `Firebase app named "${existingApp.name}" already exists and initializeApp was` +
+                ' invoked with an optional http.Agent. The SDK cannot confirm the equality' +
+                ' of http.Agent objects with the existing app. Please use getApp or getApps to reuse' +
+                ' the existing app instead.'
+        });
     }
     else if (typeof existingApp.options.httpAgent !== 'undefined') {
-        throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_APP_OPTIONS, `An existing app named "${existingApp.name}" already exists with a different` +
-            ' options configuration: httpAgent.');
+        throw new error_1.FirebaseAppError({
+            code: error_1.AppErrorCode.INVALID_APP_OPTIONS,
+            message: `An existing app named "${existingApp.name}" already exists with a different` +
+                ' options configuration: httpAgent.'
+        });
     }
     // Credential checks.
     if (typeof requestedOptions.credential !== 'undefined') {
-        throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_APP_OPTIONS, `Firebase app named "${existingApp.name}" already exists and initializeApp was` +
-            ' invoked with an optional Credential. The SDK cannot confirm the equality' +
-            ' of Credential objects with the existing app. Please use getApp or getApps' +
-            ' to reuse the existing app instead.');
+        throw new error_1.FirebaseAppError({
+            code: error_1.AppErrorCode.INVALID_APP_OPTIONS,
+            message: `Firebase app named "${existingApp.name}" already exists and initializeApp was` +
+                ' invoked with an optional Credential. The SDK cannot confirm the equality' +
+                ' of Credential objects with the existing app. Please use getApp or getApps' +
+                ' to reuse the existing app instead.'
+        });
     }
     if (existingApp.customCredential()) {
-        throw new error_1.FirebaseAppError(error_1.AppErrorCodes.INVALID_APP_OPTIONS, `An existing app named "${existingApp.name}" already exists with a different` +
-            ' options configuration: Credential.');
+        throw new error_1.FirebaseAppError({
+            code: error_1.AppErrorCode.INVALID_APP_OPTIONS,
+            message: `An existing app named "${existingApp.name}" already exists with a different` +
+                ' options configuration: Credential.'
+        });
     }
 }
 /**
@@ -160,7 +178,10 @@ function validateAppOptionsSupportDeepEquals(requestedOptions, existingApp) {
  */
 function validateAppNameFormat(appName) {
     if (!validator.isNonEmptyString(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.`);
+        throw new error_1.FirebaseAppError({
+            code: error_1.AppErrorCode.INVALID_APP_NAME,
+            message: `Invalid Firebase app name "${appName}" provided. App name must be a non-empty string.`
+        });
     }
 }
 exports.defaultAppStore = new AppStore();
@@ -209,7 +230,7 @@ function initializeApp(options, appName = DEFAULT_APP_NAME) {
 }
 /**
  * Returns an existing {@link App} instance for the provided name. If no name
- * is provided the the default app name is used.
+ * is provided the default app name is used.
  *
  * @param appName - Optional name of the `App` instance.
  *
@@ -272,6 +293,10 @@ function loadOptionsFromEnvVar() {
     }
     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);
+        throw new error_1.FirebaseAppError({
+            code: error_1.AppErrorCode.INVALID_APP_OPTIONS,
+            message: `Failed to parse app options file: ${error.message}`,
+            cause: error
+        });
     }
 }