firebase-admin 13.10.0 → 14.0.0

package/lib/auth/user-import-builder.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.10.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * Copyright 2018 Google LLC
@@ -21,7 +21,7 @@ exports.convertMultiFactorInfoToServerFormat = convertMultiFactorInfoToServerFor
 const deep_copy_1 = require("../utils/deep-copy");
 const utils = require("../utils");
 const validator = require("../utils/validator");
-const error_1 = require("../utils/error");
+const error_1 = require("./error");
 /**
  * Converts a client format second factor object to server format.
  * @param multiFactorInfo - The client format second factor.
@@ -35,7 +35,7 @@ function convertMultiFactorInfoToServerFormat(multiFactorInfo) {
             enrolledAt = new Date(multiFactorInfo.enrollmentTime).toISOString();
         }
         else {
-            throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_ENROLLMENT_TIME, `The second factor "enrollmentTime" for "${multiFactorInfo.uid}" must be a valid ` +
+            throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_ENROLLMENT_TIME, `The second factor "enrollmentTime" for "${multiFactorInfo.uid}" must be a valid ` +
                 'UTC date string.');
         }
     }
@@ -58,7 +58,7 @@ function convertMultiFactorInfoToServerFormat(multiFactorInfo) {
     }
     else {
         // Unsupported second factor.
-        throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.UNSUPPORTED_SECOND_FACTOR, `Unsupported second factor "${JSON.stringify(multiFactorInfo)}" provided.`);
+        throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.UNSUPPORTED_SECOND_FACTOR, `Unsupported second factor "${JSON.stringify(multiFactorInfo)}" provided.`);
     }
 }
 function isPhoneFactor(multiFactorInfo) {
@@ -98,13 +98,13 @@ function populateUploadAccountUser(user, userValidator) {
     };
     if (typeof user.passwordHash !== 'undefined') {
         if (!validator.isBuffer(user.passwordHash)) {
-            throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_PASSWORD_HASH);
+            throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_PASSWORD_HASH);
         }
         result.passwordHash = utils.toWebSafeBase64(user.passwordHash);
     }
     if (typeof user.passwordSalt !== 'undefined') {
         if (!validator.isBuffer(user.passwordSalt)) {
-            throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_PASSWORD_SALT);
+            throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_PASSWORD_SALT);
         }
         result.salt = utils.toWebSafeBase64(user.passwordSalt);
     }
@@ -203,7 +203,7 @@ class UserImportBuilder {
             importResult.errors.push({
                 // Map backend request index to original developer provided array index.
                 index: this.indexMap[failedUpload.index],
-                error: new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_USER_IMPORT, failedUpload.message),
+                error: new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_USER_IMPORT, failedUpload.message),
             });
         });
         // Sort errors by index.
@@ -226,14 +226,14 @@ class UserImportBuilder {
             return {};
         }
         if (!validator.isNonNullObject(options)) {
-            throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_ARGUMENT, '"UserImportOptions" are required when importing users with passwords.');
+            throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_ARGUMENT, '"UserImportOptions" are required when importing users with passwords.');
         }
         if (!validator.isNonNullObject(options.hash)) {
-            throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.MISSING_HASH_ALGORITHM, '"hash.algorithm" is missing from the provided "UserImportOptions".');
+            throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.MISSING_HASH_ALGORITHM, '"hash.algorithm" is missing from the provided "UserImportOptions".');
         }
         if (typeof options.hash.algorithm === 'undefined' ||
             !validator.isNonEmptyString(options.hash.algorithm)) {
-            throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_HASH_ALGORITHM, '"hash.algorithm" must be a string matching the list of supported algorithms.');
+            throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_HASH_ALGORITHM, '"hash.algorithm" must be a string matching the list of supported algorithms.');
         }
         let rounds;
         switch (options.hash.algorithm) {
@@ -242,7 +242,7 @@ class UserImportBuilder {
             case 'HMAC_SHA1':
             case 'HMAC_MD5':
                 if (!validator.isBuffer(options.hash.key)) {
-                    throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_HASH_KEY, 'A non-empty "hash.key" byte buffer must be provided for ' +
+                    throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_HASH_KEY, 'A non-empty "hash.key" byte buffer must be provided for ' +
                         `hash algorithm ${options.hash.algorithm}.`);
                 }
                 populatedOptions = {
@@ -258,7 +258,7 @@ class UserImportBuilder {
                 rounds = getNumberField(options.hash, 'rounds');
                 const minRounds = options.hash.algorithm === 'MD5' ? 0 : 1;
                 if (isNaN(rounds) || rounds < minRounds || rounds > 8192) {
-                    throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_HASH_ROUNDS, `A valid "hash.rounds" number between ${minRounds} and 8192 must be provided for ` +
+                    throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_HASH_ROUNDS, `A valid "hash.rounds" number between ${minRounds} and 8192 must be provided for ` +
                         `hash algorithm ${options.hash.algorithm}.`);
                 }
                 populatedOptions = {
@@ -271,7 +271,7 @@ class UserImportBuilder {
             case 'PBKDF2_SHA256':
                 rounds = getNumberField(options.hash, 'rounds');
                 if (isNaN(rounds) || rounds < 0 || rounds > 120000) {
-                    throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_HASH_ROUNDS, 'A valid "hash.rounds" number between 0 and 120000 must be provided for ' +
+                    throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_HASH_ROUNDS, 'A valid "hash.rounds" number between 0 and 120000 must be provided for ' +
                         `hash algorithm ${options.hash.algorithm}.`);
                 }
                 populatedOptions = {
@@ -281,22 +281,22 @@ class UserImportBuilder {
                 break;
             case 'SCRYPT': {
                 if (!validator.isBuffer(options.hash.key)) {
-                    throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_HASH_KEY, 'A "hash.key" byte buffer must be provided for ' +
+                    throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_HASH_KEY, 'A "hash.key" byte buffer must be provided for ' +
                         `hash algorithm ${options.hash.algorithm}.`);
                 }
                 rounds = getNumberField(options.hash, 'rounds');
                 if (isNaN(rounds) || rounds <= 0 || rounds > 8) {
-                    throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_HASH_ROUNDS, 'A valid "hash.rounds" number between 1 and 8 must be provided for ' +
+                    throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_HASH_ROUNDS, 'A valid "hash.rounds" number between 1 and 8 must be provided for ' +
                         `hash algorithm ${options.hash.algorithm}.`);
                 }
                 const memoryCost = getNumberField(options.hash, 'memoryCost');
                 if (isNaN(memoryCost) || memoryCost <= 0 || memoryCost > 14) {
-                    throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_HASH_MEMORY_COST, 'A valid "hash.memoryCost" number between 1 and 14 must be provided for ' +
+                    throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_HASH_MEMORY_COST, 'A valid "hash.memoryCost" number between 1 and 14 must be provided for ' +
                         `hash algorithm ${options.hash.algorithm}.`);
                 }
                 if (typeof options.hash.saltSeparator !== 'undefined' &&
                     !validator.isBuffer(options.hash.saltSeparator)) {
-                    throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_HASH_SALT_SEPARATOR, '"hash.saltSeparator" must be a byte buffer.');
+                    throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_HASH_SALT_SEPARATOR, '"hash.saltSeparator" must be a byte buffer.');
                 }
                 populatedOptions = {
                     hashAlgorithm: options.hash.algorithm,
@@ -315,22 +315,22 @@ class UserImportBuilder {
             case 'STANDARD_SCRYPT': {
                 const cpuMemCost = getNumberField(options.hash, 'memoryCost');
                 if (isNaN(cpuMemCost)) {
-                    throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_HASH_MEMORY_COST, 'A valid "hash.memoryCost" number must be provided for ' +
+                    throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_HASH_MEMORY_COST, 'A valid "hash.memoryCost" number must be provided for ' +
                         `hash algorithm ${options.hash.algorithm}.`);
                 }
                 const parallelization = getNumberField(options.hash, 'parallelization');
                 if (isNaN(parallelization)) {
-                    throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_HASH_PARALLELIZATION, 'A valid "hash.parallelization" number must be provided for ' +
+                    throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_HASH_PARALLELIZATION, 'A valid "hash.parallelization" number must be provided for ' +
                         `hash algorithm ${options.hash.algorithm}.`);
                 }
                 const blockSize = getNumberField(options.hash, 'blockSize');
                 if (isNaN(blockSize)) {
-                    throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_HASH_BLOCK_SIZE, 'A valid "hash.blockSize" number must be provided for ' +
+                    throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_HASH_BLOCK_SIZE, 'A valid "hash.blockSize" number must be provided for ' +
                         `hash algorithm ${options.hash.algorithm}.`);
                 }
                 const dkLen = getNumberField(options.hash, 'derivedKeyLength');
                 if (isNaN(dkLen)) {
-                    throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_HASH_DERIVED_KEY_LENGTH, 'A valid "hash.derivedKeyLength" number must be provided for ' +
+                    throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_HASH_DERIVED_KEY_LENGTH, 'A valid "hash.derivedKeyLength" number must be provided for ' +
                         `hash algorithm ${options.hash.algorithm}.`);
                 }
                 populatedOptions = {
@@ -343,7 +343,7 @@ class UserImportBuilder {
                 break;
             }
             default:
-                throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INVALID_HASH_ALGORITHM, `Unsupported hash algorithm provider "${options.hash.algorithm}".`);
+                throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INVALID_HASH_ALGORITHM, `Unsupported hash algorithm provider "${options.hash.algorithm}".`);
         }
         return populatedOptions;
     }

package/lib/auth/user-record.d.ts

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

package/lib/auth/user-record.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.10.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * @license
@@ -21,7 +21,7 @@ exports.UserRecord = exports.UserInfo = exports.UserMetadata = exports.MultiFact
 const deep_copy_1 = require("../utils/deep-copy");
 const validator_1 = require("../utils/validator");
 const utils = require("../utils");
-const error_1 = require("../utils/error");
+const error_1 = require("./error");
 /**
  * 'REDACTED', encoded as a base64 string.
  */
@@ -110,7 +110,7 @@ class MultiFactorInfo {
     initFromServerResponse(response) {
         const factorId = response && this.getFactorId(response);
         if (!factorId || !response || !response.mfaEnrollmentId) {
-            throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INTERNAL_ERROR, 'INTERNAL ASSERT FAILED: Invalid multi-factor info response');
+            throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INTERNAL_ERROR, 'INTERNAL ASSERT FAILED: Invalid multi-factor info response');
         }
         utils.addReadonlyGetter(this, 'uid', response.mfaEnrollmentId);
         utils.addReadonlyGetter(this, 'factorId', factorId);
@@ -222,7 +222,7 @@ class MultiFactorSettings {
     constructor(response) {
         const parsedEnrolledFactors = [];
         if (!(0, validator_1.isNonNullObject)(response)) {
-            throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INTERNAL_ERROR, 'INTERNAL ASSERT FAILED: Invalid multi-factor response');
+            throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INTERNAL_ERROR, 'INTERNAL ASSERT FAILED: Invalid multi-factor response');
         }
         else if (response.mfaInfo) {
             response.mfaInfo.forEach((factorResponse) => {
@@ -295,7 +295,7 @@ class UserInfo {
     constructor(response) {
         // Provider user id and provider id are required.
         if (!response.rawId || !response.providerId) {
-            throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INTERNAL_ERROR, 'INTERNAL ASSERT FAILED: Invalid user info response');
+            throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INTERNAL_ERROR, 'INTERNAL ASSERT FAILED: Invalid user info response');
         }
         utils.addReadonlyGetter(this, 'uid', response.rawId);
         utils.addReadonlyGetter(this, 'displayName', response.displayName);
@@ -334,7 +334,7 @@ class UserRecord {
     constructor(response) {
         // The Firebase user id is required.
         if (!response.localId) {
-            throw new error_1.FirebaseAuthError(error_1.AuthClientErrorCode.INTERNAL_ERROR, 'INTERNAL ASSERT FAILED: Invalid user response');
+            throw new error_1.FirebaseAuthError(error_1.authClientErrorCode.INTERNAL_ERROR, 'INTERNAL ASSERT FAILED: Invalid user response');
         }
         utils.addReadonlyGetter(this, 'uid', response.localId);
         utils.addReadonlyGetter(this, 'email', response.email);

package/lib/credential/index.d.ts

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

package/lib/credential/index.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.10.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * Copyright 2020 Google LLC

package/lib/data-connect/data-connect-api-client-internal.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.10.0 */
+/*! firebase-admin v14.0.0 */
 /*!
  * @license
  * Copyright 2024 Google LLC
@@ -15,23 +15,8 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { PrefixedFirebaseError } from '../utils/error';
 /**
  * When true the SDK should communicate with the Data Connect Emulator for all API
  * calls and also produce unsigned tokens.
  */
 export declare function useEmulator(): boolean;
-export declare const DATA_CONNECT_ERROR_CODE_MAPPING: {
-    [key: string]: DataConnectErrorCode;
-};
-export type DataConnectErrorCode = 'aborted' | 'invalid-argument' | 'invalid-credential' | 'internal-error' | 'permission-denied' | 'unauthenticated' | 'not-found' | 'unknown-error' | 'query-error';
-/**
- * Firebase Data Connect error code structure. This extends PrefixedFirebaseError.
- *
- * @param code - The error code.
- * @param message - The error message.
- * @constructor
- */
-export declare class FirebaseDataConnectError extends PrefixedFirebaseError {
-    constructor(code: DataConnectErrorCode, message: string);
-}

package/lib/data-connect/data-connect-api-client-internal.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.10.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * @license
@@ -17,10 +17,11 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FirebaseDataConnectError = exports.DATA_CONNECT_ERROR_CODE_MAPPING = exports.DataConnectApiClient = void 0;
+exports.DataConnectApiClient = void 0;
 exports.useEmulator = useEmulator;
 const api_request_1 = require("../utils/api-request");
 const error_1 = require("../utils/error");
+const error_2 = require("./error");
 const utils = require("../utils/index");
 const validator = require("../utils/validator");
 const API_VERSION = 'v1';
@@ -69,7 +70,10 @@ class DataConnectApiClient {
         this.app = app;
         this.isUsingGen = false;
         if (!validator.isNonNullObject(app) || !('options' in app)) {
-            throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT, 'First argument passed to getDataConnect() must be a valid Firebase app instance.');
+            throw new error_2.FirebaseDataConnectError({
+                code: error_2.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT,
+                message: 'First argument passed to getDataConnect() must be a valid Firebase app instance.'
+            });
         }
         this.httpClient = new DataConnectHttpClient(app);
     }
@@ -111,11 +115,17 @@ class DataConnectApiClient {
      */
     async executeGraphqlHelper(query, endpoint, options) {
         if (!validator.isNonEmptyString(query)) {
-            throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT, '`query` must be a non-empty string.');
+            throw new error_2.FirebaseDataConnectError({
+                code: error_2.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT,
+                message: '`query` must be a non-empty string.'
+            });
         }
         if (typeof options !== 'undefined') {
             if (!validator.isNonNullObject(options)) {
-                throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT, 'GraphqlOptions must be a non-null object');
+                throw new error_2.FirebaseDataConnectError({
+                    code: error_2.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT,
+                    message: 'GraphqlOptions must be a non-null object'
+                });
             }
         }
         const data = {
@@ -162,11 +172,17 @@ class DataConnectApiClient {
     async executeOperationHelper(endpoint, name, variables, options) {
         if (typeof name === 'undefined' ||
             !validator.isNonEmptyString(name)) {
-            throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT, '`name` must be a non-empty string.');
+            throw new error_2.FirebaseDataConnectError({
+                code: error_2.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT,
+                message: '`name` must be a non-empty string.'
+            });
         }
         if (this.connectorConfig.connector === undefined || this.connectorConfig.connector === '') {
-            throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT, `The 'connectorConfig.connector' field used to instantiate your Data Connect
-        instance must be a non-empty string (the connectorId) when calling executeQuery or executeMutation.`);
+            throw new error_2.FirebaseDataConnectError({
+                code: error_2.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT,
+                message: `The 'connectorConfig.connector' field used to instantiate your Data Connect
+        instance must be a non-empty string (the connectorId) when calling executeQuery or executeMutation.`
+            });
         }
         const data = {
             ...(variables && { variables: variables }),
@@ -242,9 +258,12 @@ class DataConnectApiClient {
         return utils.findProjectId(this.app)
             .then((projectId) => {
             if (!validator.isNonEmptyString(projectId)) {
-                throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.UNKNOWN, 'Failed to determine project ID. Initialize the '
-                    + 'SDK with service account credentials or set project ID as an app option. '
-                    + 'Alternatively, set the GOOGLE_CLOUD_PROJECT environment variable.');
+                throw new error_2.FirebaseDataConnectError({
+                    code: error_2.DATA_CONNECT_ERROR_CODE_MAPPING.UNKNOWN,
+                    message: 'Failed to determine project ID. Initialize the '
+                        + 'SDK with service account credentials or set project ID as an app option. '
+                        + 'Alternatively, set the GOOGLE_CLOUD_PROJECT environment variable.'
+                });
             }
             this.projectId = projectId;
             return projectId;
@@ -267,27 +286,41 @@ class DataConnectApiClient {
         const resp = await this.httpClient.send(request);
         if (resp.data.errors && validator.isNonEmptyArray(resp.data.errors)) {
             const allMessages = resp.data.errors.map((error) => error.message).join(' ');
-            throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.QUERY_ERROR, allMessages);
+            throw new error_2.FirebaseDataConnectError({
+                code: error_2.DATA_CONNECT_ERROR_CODE_MAPPING.QUERY_ERROR,
+                message: allMessages,
+                httpResponse: (0, error_1.toHttpResponse)(resp),
+            });
         }
         return Promise.resolve({
             data: resp.data.data,
         });
     }
     toFirebaseError(err) {
-        if (err instanceof error_1.PrefixedFirebaseError) {
+        if (err instanceof error_1.FirebaseError) {
             return err;
         }
         const response = err.response;
         if (!response.isJson()) {
-            return new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.UNKNOWN, `Unexpected response with status: ${response.status} and body: ${response.text}`);
+            return new error_2.FirebaseDataConnectError({
+                code: error_2.DATA_CONNECT_ERROR_CODE_MAPPING.UNKNOWN,
+                message: `Unexpected response with status: ${response.status} and body: ${response.text}`,
+                httpResponse: (0, error_1.toHttpResponse)(response),
+                cause: err
+            });
         }
         const error = response.data.error || {};
-        let code = exports.DATA_CONNECT_ERROR_CODE_MAPPING.UNKNOWN;
-        if (error.status && error.status in exports.DATA_CONNECT_ERROR_CODE_MAPPING) {
-            code = exports.DATA_CONNECT_ERROR_CODE_MAPPING[error.status];
-        }
-        const message = error.message || `Unknown server error: ${response.text}`;
-        return new FirebaseDataConnectError(code, message);
+        let code = error_2.DATA_CONNECT_ERROR_CODE_MAPPING.UNKNOWN;
+        if (error.status && error.status in error_2.DATA_CONNECT_ERROR_CODE_MAPPING) {
+            code = error_2.DATA_CONNECT_ERROR_CODE_MAPPING[error.status];
+        }
+        const message = error.message || 'Unknown server error';
+        return new error_2.FirebaseDataConnectError({
+            code,
+            message,
+            httpResponse: (0, error_1.toHttpResponse)(response),
+            cause: err,
+        });
     }
     /**
      * Converts JSON data into a GraphQL literal string.
@@ -337,8 +370,13 @@ class DataConnectApiClient {
         return tableName;
     }
     handleBulkImportErrors(err) {
-        if (err.code === `data-connect/${exports.DATA_CONNECT_ERROR_CODE_MAPPING.QUERY_ERROR}`) {
-            throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.QUERY_ERROR, `${err.message}. Make sure that your table name passed in matches the type name in your GraphQL schema file.`);
+        if (err.code === `data-connect/${error_2.DATA_CONNECT_ERROR_CODE_MAPPING.QUERY_ERROR}`) {
+            throw new error_2.FirebaseDataConnectError({
+                code: error_2.DATA_CONNECT_ERROR_CODE_MAPPING.QUERY_ERROR,
+                message: `${err.message}. Make sure that your table name passed in matches the type name in your `
+                    + 'GraphQL schema file.',
+                cause: err,
+            });
         }
         throw err;
     }
@@ -347,13 +385,23 @@ class DataConnectApiClient {
      */
     async insert(tableName, data) {
         if (!validator.isNonEmptyString(tableName)) {
-            throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT, '`tableName` must be a non-empty string.');
+            throw new error_2.FirebaseDataConnectError({
+                code: error_2.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT,
+                message: '`tableName` must be a non-empty string.'
+            });
         }
         if (validator.isArray(data)) {
-            throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT, '`data` must be an object, not an array, for single insert. For arrays, please use `insertMany` function.');
+            throw new error_2.FirebaseDataConnectError({
+                code: error_2.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT,
+                message: '`data` must be an object, not an array, for single insert. For arrays, please use '
+                    + '`insertMany` function.'
+            });
         }
         if (!validator.isNonNullObject(data)) {
-            throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT, '`data` must be a non-null object.');
+            throw new error_2.FirebaseDataConnectError({
+                code: error_2.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT,
+                message: '`data` must be a non-null object.'
+            });
         }
         try {
             tableName = this.formatTableName(tableName);
@@ -363,7 +411,11 @@ class DataConnectApiClient {
             return this.executeGraphql(mutation).catch(this.handleBulkImportErrors);
         }
         catch (e) {
-            throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.INTERNAL, `Failed to construct insert mutation: ${e.message}`);
+            throw new error_2.FirebaseDataConnectError({
+                code: error_2.DATA_CONNECT_ERROR_CODE_MAPPING.INTERNAL,
+                message: `Failed to construct insert mutation: ${e.message}`,
+                cause: e,
+            });
         }
     }
     /**
@@ -371,10 +423,16 @@ class DataConnectApiClient {
      */
     async insertMany(tableName, data) {
         if (!validator.isNonEmptyString(tableName)) {
-            throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT, '`tableName` must be a non-empty string.');
+            throw new error_2.FirebaseDataConnectError({
+                code: error_2.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT,
+                message: '`tableName` must be a non-empty string.'
+            });
         }
         if (!validator.isNonEmptyArray(data)) {
-            throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT, '`data` must be a non-empty array for insertMany.');
+            throw new error_2.FirebaseDataConnectError({
+                code: error_2.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT,
+                message: '`data` must be a non-empty array for insertMany.',
+            });
         }
         try {
             tableName = this.formatTableName(tableName);
@@ -384,7 +442,11 @@ class DataConnectApiClient {
             return this.executeGraphql(mutation).catch(this.handleBulkImportErrors);
         }
         catch (e) {
-            throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.INTERNAL, `Failed to construct insertMany mutation: ${e.message}`);
+            throw new error_2.FirebaseDataConnectError({
+                code: error_2.DATA_CONNECT_ERROR_CODE_MAPPING.INTERNAL,
+                message: `Failed to construct insertMany mutation: ${e.message}`,
+                cause: e,
+            });
         }
     }
     /**
@@ -392,13 +454,23 @@ class DataConnectApiClient {
      */
     async upsert(tableName, data) {
         if (!validator.isNonEmptyString(tableName)) {
-            throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT, '`tableName` must be a non-empty string.');
+            throw new error_2.FirebaseDataConnectError({
+                code: error_2.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT,
+                message: '`tableName` must be a non-empty string.'
+            });
         }
         if (validator.isArray(data)) {
-            throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT, '`data` must be an object, not an array, for single upsert. For arrays, please use `upsertMany` function.');
+            throw new error_2.FirebaseDataConnectError({
+                code: error_2.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT,
+                message: '`data` must be an object, not an array, for single upsert. For arrays, please use '
+                    + '`upsertMany` function.'
+            });
         }
         if (!validator.isNonNullObject(data)) {
-            throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT, '`data` must be a non-null object.');
+            throw new error_2.FirebaseDataConnectError({
+                code: error_2.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT,
+                message: '`data` must be a non-null object.'
+            });
         }
         try {
             tableName = this.formatTableName(tableName);
@@ -408,7 +480,11 @@ class DataConnectApiClient {
             return this.executeGraphql(mutation).catch(this.handleBulkImportErrors);
         }
         catch (e) {
-            throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.INTERNAL, `Failed to construct upsert mutation: ${e.message}`);
+            throw new error_2.FirebaseDataConnectError({
+                code: error_2.DATA_CONNECT_ERROR_CODE_MAPPING.INTERNAL,
+                message: `Failed to construct upsert mutation: ${e.message}`,
+                cause: e,
+            });
         }
     }
     /**
@@ -416,10 +492,16 @@ class DataConnectApiClient {
      */
     async upsertMany(tableName, data) {
         if (!validator.isNonEmptyString(tableName)) {
-            throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT, '`tableName` must be a non-empty string.');
+            throw new error_2.FirebaseDataConnectError({
+                code: error_2.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT,
+                message: '`tableName` must be a non-empty string.'
+            });
         }
         if (!validator.isNonEmptyArray(data)) {
-            throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT, '`data` must be a non-empty array for upsertMany.');
+            throw new error_2.FirebaseDataConnectError({
+                code: error_2.DATA_CONNECT_ERROR_CODE_MAPPING.INVALID_ARGUMENT,
+                message: '`data` must be a non-empty array for upsertMany.'
+            });
         }
         try {
             tableName = this.formatTableName(tableName);
@@ -429,7 +511,11 @@ class DataConnectApiClient {
             return this.executeGraphql(mutation).catch(this.handleBulkImportErrors);
         }
         catch (e) {
-            throw new FirebaseDataConnectError(exports.DATA_CONNECT_ERROR_CODE_MAPPING.INTERNAL, `Failed to construct upsertMany mutation: ${e.message}`);
+            throw new error_2.FirebaseDataConnectError({
+                code: error_2.DATA_CONNECT_ERROR_CODE_MAPPING.INTERNAL,
+                message: `Failed to construct upsertMany mutation: ${e.message}`,
+                cause: e,
+            });
         }
     }
 }
@@ -456,32 +542,3 @@ function emulatorHost() {
 function useEmulator() {
     return !!emulatorHost();
 }
-exports.DATA_CONNECT_ERROR_CODE_MAPPING = {
-    ABORTED: 'aborted',
-    INVALID_ARGUMENT: 'invalid-argument',
-    INVALID_CREDENTIAL: 'invalid-credential',
-    INTERNAL: 'internal-error',
-    PERMISSION_DENIED: 'permission-denied',
-    UNAUTHENTICATED: 'unauthenticated',
-    NOT_FOUND: 'not-found',
-    UNKNOWN: 'unknown-error',
-    QUERY_ERROR: 'query-error',
-};
-/**
- * Firebase Data Connect error code structure. This extends PrefixedFirebaseError.
- *
- * @param code - The error code.
- * @param message - The error message.
- * @constructor
- */
-class FirebaseDataConnectError extends error_1.PrefixedFirebaseError {
-    constructor(code, message) {
-        super('data-connect', code, message);
-        /* tslint:disable:max-line-length */
-        // Set the prototype explicitly. See the following link for more details:
-        // https://github.com/Microsoft/TypeScript/wiki/Breaking-Changes#extending-built-ins-like-error-array-and-map-may-no-longer-work
-        /* tslint:enable:max-line-length */
-        this.__proto__ = FirebaseDataConnectError.prototype;
-    }
-}
-exports.FirebaseDataConnectError = FirebaseDataConnectError;

package/lib/data-connect/data-connect-api.d.ts

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

package/lib/data-connect/data-connect-api.js

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

package/lib/data-connect/data-connect.d.ts

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

package/lib/data-connect/data-connect.js

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