firebase-admin 13.9.0 → 14.0.0

package/lib/app-check/token-verifier.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * Copyright 2021 Google LLC
@@ -19,7 +19,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AppCheckTokenVerifier = void 0;
 const validator = require("../utils/validator");
 const util = require("../utils/index");
-const app_check_api_client_internal_1 = require("./app-check-api-client-internal");
+const error_1 = require("./error");
 const jwt_1 = require("../utils/jwt");
 const APP_CHECK_ISSUER = 'https://firebaseappcheck.googleapis.com/';
 const JWKS_URL = 'https://firebaseappcheck.googleapis.com/v1/jwks';
@@ -41,7 +41,10 @@ class AppCheckTokenVerifier {
      */
     verifyToken(token) {
         if (!validator.isString(token)) {
-            throw new app_check_api_client_internal_1.FirebaseAppCheckError('invalid-argument', 'App check token must be a non-null string.');
+            throw new error_1.FirebaseAppCheckError({
+                code: 'invalid-argument',
+                message: 'App check token must be a non-null string.'
+            });
         }
         return this.ensureProjectId()
             .then((projectId) => {
@@ -57,8 +60,11 @@ class AppCheckTokenVerifier {
         return util.findProjectId(this.app)
             .then((projectId) => {
             if (!validator.isNonEmptyString(projectId)) {
-                throw new app_check_api_client_internal_1.FirebaseAppCheckError('invalid-credential', 'Must initialize app with a cert credential or set your Firebase project ID as the ' +
-                    'GOOGLE_CLOUD_PROJECT environment variable to verify an App Check token.');
+                throw new error_1.FirebaseAppCheckError({
+                    code: 'invalid-credential',
+                    message: 'Must initialize app with a cert credential or set your Firebase project ID as the ' +
+                        'GOOGLE_CLOUD_PROJECT environment variable to verify an App Check token.'
+                });
             }
             return projectId;
         });
@@ -76,7 +82,10 @@ class AppCheckTokenVerifier {
             .catch(() => {
             const errorMessage = 'Decoding App Check token failed. Make sure you passed ' +
                 'the entire string JWT which represents the Firebase App Check token.';
-            throw new app_check_api_client_internal_1.FirebaseAppCheckError('invalid-argument', errorMessage);
+            throw new error_1.FirebaseAppCheckError({
+                code: 'invalid-argument',
+                message: errorMessage
+            });
         });
     }
     /**
@@ -110,7 +119,10 @@ class AppCheckTokenVerifier {
             errorMessage = 'The provided App Check token has an empty string "sub" (subject) claim.';
         }
         if (errorMessage) {
-            throw new app_check_api_client_internal_1.FirebaseAppCheckError('invalid-argument', errorMessage);
+            throw new error_1.FirebaseAppCheckError({
+                code: 'invalid-argument',
+                message: errorMessage
+            });
         }
     }
     verifySignature(jwtToken) {
@@ -129,19 +141,35 @@ class AppCheckTokenVerifier {
         if (error.code === jwt_1.JwtErrorCode.TOKEN_EXPIRED) {
             const errorMessage = 'The provided App Check token has expired. Get a fresh App Check token' +
                 ' from your client app and try again.';
-            return new app_check_api_client_internal_1.FirebaseAppCheckError('app-check-token-expired', errorMessage);
+            return new error_1.FirebaseAppCheckError({
+                code: 'app-check-token-expired',
+                message: errorMessage,
+                cause: error
+            });
         }
         else if (error.code === jwt_1.JwtErrorCode.INVALID_SIGNATURE) {
             const errorMessage = 'The provided App Check token has invalid signature.';
-            return new app_check_api_client_internal_1.FirebaseAppCheckError('invalid-argument', errorMessage);
+            return new error_1.FirebaseAppCheckError({
+                code: 'invalid-argument',
+                message: errorMessage,
+                cause: error
+            });
         }
         else if (error.code === jwt_1.JwtErrorCode.NO_MATCHING_KID) {
             const errorMessage = 'The provided App Check token has "kid" claim which does not ' +
                 'correspond to a known public key. Most likely the provided App Check token ' +
                 'is expired, so get a fresh token from your client app and try again.';
-            return new app_check_api_client_internal_1.FirebaseAppCheckError('invalid-argument', errorMessage);
+            return new error_1.FirebaseAppCheckError({
+                code: 'invalid-argument',
+                message: errorMessage,
+                cause: error
+            });
         }
-        return new app_check_api_client_internal_1.FirebaseAppCheckError('invalid-argument', error.message);
+        return new error_1.FirebaseAppCheckError({
+            code: 'invalid-argument',
+            message: error.message,
+            cause: error
+        });
     }
 }
 exports.AppCheckTokenVerifier = AppCheckTokenVerifier;

package/lib/auth/action-code-settings-builder.d.ts

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

package/lib/auth/action-code-settings-builder.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * Copyright 2018 Google LLC
@@ -18,7 +18,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ActionCodeSettingsBuilder = void 0;
 const validator = require("../utils/validator");
-const error_1 = require("../utils/error");
+const error_1 = require("./error");
 /**
  * Defines the ActionCodeSettings builder class used to convert the
  * ActionCodeSettings object to its corresponding server request.
@@ -35,59 +35,59 @@ class ActionCodeSettingsBuilder {
      */
     constructor(actionCodeSettings) {
         if (!validator.isNonNullObject(actionCodeSettings)) {
-            throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_ARGUMENT, '"ActionCodeSettings" must be a non-null object.');
+            throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_ARGUMENT, '"ActionCodeSettings" must be a non-null object.');
         }
         if (typeof actionCodeSettings.url === 'undefined') {
-            throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.MISSING_CONTINUE_URI);
+            throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.MISSING_CONTINUE_URI);
         }
         else if (!validator.isURL(actionCodeSettings.url)) {
-            throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_CONTINUE_URI);
+            throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_CONTINUE_URI);
         }
         this.continueUrl = actionCodeSettings.url;
         if (typeof actionCodeSettings.handleCodeInApp !== 'undefined' &&
             !validator.isBoolean(actionCodeSettings.handleCodeInApp)) {
-            throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_ARGUMENT, '"ActionCodeSettings.handleCodeInApp" must be a boolean.');
+            throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_ARGUMENT, '"ActionCodeSettings.handleCodeInApp" must be a boolean.');
         }
         this.canHandleCodeInApp = actionCodeSettings.handleCodeInApp || false;
         if (typeof actionCodeSettings.dynamicLinkDomain !== 'undefined' &&
             !validator.isNonEmptyString(actionCodeSettings.dynamicLinkDomain)) {
-            throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_DYNAMIC_LINK_DOMAIN);
+            throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_DYNAMIC_LINK_DOMAIN);
         }
         this.dynamicLinkDomain = actionCodeSettings.dynamicLinkDomain;
         if (typeof actionCodeSettings.linkDomain !== 'undefined' &&
             !validator.isNonEmptyString(actionCodeSettings.linkDomain)) {
-            throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_HOSTING_LINK_DOMAIN);
+            throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_HOSTING_LINK_DOMAIN);
         }
         this.linkDomain = actionCodeSettings.linkDomain;
         if (typeof actionCodeSettings.iOS !== 'undefined') {
             if (!validator.isNonNullObject(actionCodeSettings.iOS)) {
-                throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_ARGUMENT, '"ActionCodeSettings.iOS" must be a valid non-null object.');
+                throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_ARGUMENT, '"ActionCodeSettings.iOS" must be a valid non-null object.');
             }
             else if (typeof actionCodeSettings.iOS.bundleId === 'undefined') {
-                throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.MISSING_IOS_BUNDLE_ID);
+                throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.MISSING_IOS_BUNDLE_ID);
             }
             else if (!validator.isNonEmptyString(actionCodeSettings.iOS.bundleId)) {
-                throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_ARGUMENT, '"ActionCodeSettings.iOS.bundleId" must be a valid non-empty string.');
+                throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_ARGUMENT, '"ActionCodeSettings.iOS.bundleId" must be a valid non-empty string.');
             }
             this.ibi = actionCodeSettings.iOS.bundleId;
         }
         if (typeof actionCodeSettings.android !== 'undefined') {
             if (!validator.isNonNullObject(actionCodeSettings.android)) {
-                throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_ARGUMENT, '"ActionCodeSettings.android" must be a valid non-null object.');
+                throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_ARGUMENT, '"ActionCodeSettings.android" must be a valid non-null object.');
             }
             else if (typeof actionCodeSettings.android.packageName === 'undefined') {
-                throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.MISSING_ANDROID_PACKAGE_NAME);
+                throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.MISSING_ANDROID_PACKAGE_NAME);
             }
             else if (!validator.isNonEmptyString(actionCodeSettings.android.packageName)) {
-                throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_ARGUMENT, '"ActionCodeSettings.android.packageName" must be a valid non-empty string.');
+                throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_ARGUMENT, '"ActionCodeSettings.android.packageName" must be a valid non-empty string.');
             }
             else if (typeof actionCodeSettings.android.minimumVersion !== 'undefined' &&
                 !validator.isNonEmptyString(actionCodeSettings.android.minimumVersion)) {
-                throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_ARGUMENT, '"ActionCodeSettings.android.minimumVersion" must be a valid non-empty string.');
+                throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_ARGUMENT, '"ActionCodeSettings.android.minimumVersion" must be a valid non-empty string.');
             }
             else if (typeof actionCodeSettings.android.installApp !== 'undefined' &&
                 !validator.isBoolean(actionCodeSettings.android.installApp)) {
-                throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_ARGUMENT, '"ActionCodeSettings.android.installApp" must be a valid boolean.');
+                throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_ARGUMENT, '"ActionCodeSettings.android.installApp" must be a valid boolean.');
             }
             this.apn = actionCodeSettings.android.packageName;
             this.amv = actionCodeSettings.android.minimumVersion;

package/lib/auth/auth-api-request.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 /*!
  * @license
  * Copyright 2017 Google LLC
@@ -32,11 +32,12 @@ declare class AuthResourceUrlBuilder {
     /**
      * The resource URL builder constructor.
      *
-     * @param projectId - The resource project ID.
+     * @param app - The app for this URL builder.
      * @param version - The endpoint API version.
+     * @param emulatorHost - Optional emulator host captured at init time.
      * @constructor
      */
-    constructor(app: App, version?: string);
+    constructor(app: App, version?: string, emHost?: string);
     /**
      * Returns the resource URL corresponding to the provided parameters.
      *
@@ -148,9 +149,10 @@ export declare class TenantAwareAuthRequestHandler extends AbstractAuthRequestHa
      *
      * @param app - The app used to fetch access tokens to sign API requests.
      * @param tenantId - The request handler's tenant ID.
+     * @param emHost - Optional emulator host override captured at init time.
      * @constructor
      */
-    constructor(app: App, tenantId: string);
+    constructor(app: App, tenantId: string, emHost?: string | null);
     /**
      * @returns A new Auth user management resource URL builder instance.
      */