firebase-admin 13.9.0 → 14.0.0

package/lib/messaging/messaging-errors-internal.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * Copyright 2019 Google LLC
@@ -18,7 +18,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createFirebaseError = createFirebaseError;
 exports.getErrorCode = getErrorCode;
-const error_1 = require("../utils/error");
+const error_1 = require("./error");
+const error_2 = require("../utils/error");
 const validator = require("../utils/validator");
 /**
  * Creates a new `FirebaseMessagingError` by extracting the error code, message and other relevant
@@ -33,32 +34,34 @@ function createFirebaseError(err) {
         const json = err.response.data;
         const errorCode = getErrorCode(json);
         const errorMessage = getErrorMessage(json);
-        return error_1.FirebaseMessagingError.fromServerError(errorCode, errorMessage, json);
+        return error_1.FirebaseMessagingError.fromServerError(errorCode, errorMessage, err);
     }
     // Non-JSON response
     let error;
     switch (err.response.status) {
         case 400:
-            error = error_1.MessagingClientErrorCode.INVALID_ARGUMENT;
+            error = error_1.messagingClientErrorCode.INVALID_ARGUMENT;
             break;
         case 401:
         case 403:
-            error = error_1.MessagingClientErrorCode.AUTHENTICATION_ERROR;
+            error = error_1.messagingClientErrorCode.AUTHENTICATION_ERROR;
             break;
         case 500:
-            error = error_1.MessagingClientErrorCode.INTERNAL_ERROR;
+            error = error_1.messagingClientErrorCode.INTERNAL_ERROR;
             break;
         case 503:
-            error = error_1.MessagingClientErrorCode.SERVER_UNAVAILABLE;
+            error = error_1.messagingClientErrorCode.SERVER_UNAVAILABLE;
             break;
         default:
             // Treat non-JSON responses with unexpected status codes as unknown errors.
-            error = error_1.MessagingClientErrorCode.UNKNOWN_ERROR;
+            error = error_1.messagingClientErrorCode.UNKNOWN_ERROR;
     }
     return new error_1.FirebaseMessagingError({
         code: error.code,
         message: `${error.message} Raw server response: "${err.response.text}". Status code: ` +
             `${err.response.status}.`,
+        httpResponse: (0, error_2.toHttpResponse)(err.response),
+        cause: err,
     });
 }
 /**

package/lib/messaging/messaging-internal.d.ts

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

package/lib/messaging/messaging-internal.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * Copyright 2020 Google LLC
@@ -19,7 +19,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BLACKLISTED_OPTIONS_KEYS = exports.BLACKLISTED_DATA_PAYLOAD_KEYS = void 0;
 exports.validateMessage = validateMessage;
 const index_1 = require("../utils/index");
-const error_1 = require("../utils/error");
+const error_1 = require("./error");
 const validator = require("../utils/validator");
 // Keys which are not allowed in the messaging data payload object.
 exports.BLACKLISTED_DATA_PAYLOAD_KEYS = ['from'];
@@ -36,7 +36,7 @@ exports.BLACKLISTED_OPTIONS_KEYS = [
  */
 function validateMessage(message) {
     if (!validator.isNonNullObject(message)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'Message must be a non-null object');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'Message must be a non-null object');
     }
     const anyMessage = message;
     if (anyMessage.topic) {
@@ -46,12 +46,12 @@ function validateMessage(message) {
         }
         // Checks for illegal characters and empty string.
         if (!/^[a-zA-Z0-9-_.~%]+$/.test(anyMessage.topic)) {
-            throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'Malformed topic name');
+            throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'Malformed topic name');
         }
     }
     const targets = [anyMessage.token, anyMessage.topic, anyMessage.condition];
     if (targets.filter((v) => validator.isNonEmptyString(v)).length !== 1) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'Exactly one of topic, token or condition is required');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'Exactly one of topic, token or condition is required');
     }
     validateStringMap(message.data, 'data');
     validateAndroidConfig(message.android);
@@ -71,11 +71,11 @@ function validateStringMap(map, label) {
         return;
     }
     else if (!validator.isNonNullObject(map)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, `${label} must be a non-null object`);
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, `${label} must be a non-null object`);
     }
     Object.keys(map).forEach((key) => {
         if (!validator.isString(map[key])) {
-            throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, `${label} must only contain string values`);
+            throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, `${label} must only contain string values`);
         }
     });
 }
@@ -89,7 +89,7 @@ function validateWebpushConfig(config) {
         return;
     }
     else if (!validator.isNonNullObject(config)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'webpush must be a non-null object');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'webpush must be a non-null object');
     }
     validateStringMap(config.headers, 'webpush.headers');
     validateStringMap(config.data, 'webpush.data');
@@ -105,7 +105,7 @@ function validateApnsConfig(config) {
         return;
     }
     else if (!validator.isNonNullObject(config)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'apns must be a non-null object');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'apns must be a non-null object');
     }
     validateApnsLiveActivityToken(config.liveActivityToken);
     validateStringMap(config.headers, 'apns.headers');
@@ -121,10 +121,10 @@ function validateApnsLiveActivityToken(liveActivityToken) {
         return;
     }
     else if (!validator.isString(liveActivityToken)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'apns.liveActivityToken must be a string value');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'apns.liveActivityToken must be a string value');
     }
     else if (!validator.isNonEmptyString(liveActivityToken)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'apns.liveActivityToken must be a non-empty string');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'apns.liveActivityToken must be a non-empty string');
     }
 }
 /**
@@ -137,21 +137,21 @@ function validateApnsFcmOptions(fcmOptions) {
         return;
     }
     else if (!validator.isNonNullObject(fcmOptions)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'fcmOptions must be a non-null object');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'fcmOptions must be a non-null object');
     }
     if (typeof fcmOptions.imageUrl !== 'undefined' &&
         !validator.isURL(fcmOptions.imageUrl)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'imageUrl must be a valid URL string');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'imageUrl must be a valid URL string');
     }
     if (typeof fcmOptions.analyticsLabel !== 'undefined' && !validator.isString(fcmOptions.analyticsLabel)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'analyticsLabel must be a string value');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'analyticsLabel must be a string value');
     }
     const propertyMappings = {
         imageUrl: 'image',
     };
     Object.keys(propertyMappings).forEach((key) => {
         if (key in fcmOptions && propertyMappings[key] in fcmOptions) {
-            throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, `Multiple specifications for ${key} in ApnsFcmOptions`);
+            throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, `Multiple specifications for ${key} in ApnsFcmOptions`);
         }
     });
     (0, index_1.renameProperties)(fcmOptions, propertyMappings);
@@ -166,10 +166,10 @@ function validateFcmOptions(fcmOptions) {
         return;
     }
     else if (!validator.isNonNullObject(fcmOptions)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'fcmOptions must be a non-null object');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'fcmOptions must be a non-null object');
     }
     if (typeof fcmOptions.analyticsLabel !== 'undefined' && !validator.isString(fcmOptions.analyticsLabel)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'analyticsLabel must be a string value');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'analyticsLabel must be a string value');
     }
 }
 /**
@@ -182,17 +182,17 @@ function validateNotification(notification) {
         return;
     }
     else if (!validator.isNonNullObject(notification)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'notification must be a non-null object');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'notification must be a non-null object');
     }
     if (typeof notification.imageUrl !== 'undefined' && !validator.isURL(notification.imageUrl)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'notification.imageUrl must be a valid URL string');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'notification.imageUrl must be a valid URL string');
     }
     const propertyMappings = {
         imageUrl: 'image',
     };
     Object.keys(propertyMappings).forEach((key) => {
         if (key in notification && propertyMappings[key] in notification) {
-            throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, `Multiple specifications for ${key} in Notification`);
+            throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, `Multiple specifications for ${key} in Notification`);
         }
     });
     (0, index_1.renameProperties)(notification, propertyMappings);
@@ -207,7 +207,7 @@ function validateApnsPayload(payload) {
         return;
     }
     else if (!validator.isNonNullObject(payload)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'apns.payload must be a non-null object');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'apns.payload must be a non-null object');
     }
     validateAps(payload.aps);
 }
@@ -222,7 +222,7 @@ function validateAps(aps) {
         return;
     }
     else if (!validator.isNonNullObject(aps)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'apns.payload.aps must be a non-null object');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'apns.payload.aps must be a non-null object');
     }
     validateApsAlert(aps.alert);
     validateApsSound(aps.sound);
@@ -233,7 +233,7 @@ function validateAps(aps) {
     };
     Object.keys(propertyMappings).forEach((key) => {
         if (key in aps && propertyMappings[key] in aps) {
-            throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, `Multiple specifications for ${key} in Aps`);
+            throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, `Multiple specifications for ${key} in Aps`);
         }
     });
     (0, index_1.renameProperties)(aps, propertyMappings);
@@ -261,18 +261,18 @@ function validateApsSound(sound) {
         return;
     }
     else if (!validator.isNonNullObject(sound)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'apns.payload.aps.sound must be a non-empty string or a non-null object');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'apns.payload.aps.sound must be a non-empty string or a non-null object');
     }
     if (!validator.isNonEmptyString(sound.name)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'apns.payload.aps.sound.name must be a non-empty string');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'apns.payload.aps.sound.name must be a non-empty string');
     }
     const volume = sound.volume;
     if (typeof volume !== 'undefined') {
         if (!validator.isNumber(volume)) {
-            throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'apns.payload.aps.sound.volume must be a number');
+            throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'apns.payload.aps.sound.volume must be a number');
         }
         if (volume < 0 || volume > 1) {
-            throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'apns.payload.aps.sound.volume must be in the interval [0, 1]');
+            throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'apns.payload.aps.sound.volume must be in the interval [0, 1]');
         }
     }
     const soundObject = sound;
@@ -299,20 +299,20 @@ function validateApsAlert(alert) {
         return;
     }
     else if (!validator.isNonNullObject(alert)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'apns.payload.aps.alert must be a string or a non-null object');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'apns.payload.aps.alert must be a string or a non-null object');
     }
     const apsAlert = alert;
     if (validator.isNonEmptyArray(apsAlert.locArgs) &&
         !validator.isNonEmptyString(apsAlert.locKey)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'apns.payload.aps.alert.locKey is required when specifying locArgs');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'apns.payload.aps.alert.locKey is required when specifying locArgs');
     }
     if (validator.isNonEmptyArray(apsAlert.titleLocArgs) &&
         !validator.isNonEmptyString(apsAlert.titleLocKey)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'apns.payload.aps.alert.titleLocKey is required when specifying titleLocArgs');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'apns.payload.aps.alert.titleLocKey is required when specifying titleLocArgs');
     }
     if (validator.isNonEmptyArray(apsAlert.subtitleLocArgs) &&
         !validator.isNonEmptyString(apsAlert.subtitleLocKey)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'apns.payload.aps.alert.subtitleLocKey is required when specifying subtitleLocArgs');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'apns.payload.aps.alert.subtitleLocKey is required when specifying subtitleLocArgs');
     }
     const propertyMappings = {
         locKey: 'loc-key',
@@ -338,11 +338,11 @@ function validateAndroidConfig(config) {
         return;
     }
     else if (!validator.isNonNullObject(config)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'android must be a non-null object');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'android must be a non-null object');
     }
     if (typeof config.ttl !== 'undefined') {
         if (!validator.isNumber(config.ttl) || config.ttl < 0) {
-            throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'TTL must be a non-negative duration in milliseconds');
+            throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'TTL must be a non-negative duration in milliseconds');
         }
         const duration = (0, index_1.transformMillisecondsToSecondsString)(config.ttl);
         config.ttl = duration;
@@ -371,26 +371,26 @@ function validateAndroidNotification(notification) {
         return;
     }
     else if (!validator.isNonNullObject(notification)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'android.notification must be a non-null object');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'android.notification must be a non-null object');
     }
     if (typeof notification.color !== 'undefined' && !/^#[0-9a-fA-F]{6}$/.test(notification.color)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'android.notification.color must be in the form #RRGGBB');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'android.notification.color must be in the form #RRGGBB');
     }
     if (validator.isNonEmptyArray(notification.bodyLocArgs) &&
         !validator.isNonEmptyString(notification.bodyLocKey)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'android.notification.bodyLocKey is required when specifying bodyLocArgs');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'android.notification.bodyLocKey is required when specifying bodyLocArgs');
     }
     if (validator.isNonEmptyArray(notification.titleLocArgs) &&
         !validator.isNonEmptyString(notification.titleLocKey)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'android.notification.titleLocKey is required when specifying titleLocArgs');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'android.notification.titleLocKey is required when specifying titleLocArgs');
     }
     if (typeof notification.imageUrl !== 'undefined' &&
         !validator.isURL(notification.imageUrl)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'android.notification.imageUrl must be a valid URL string');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'android.notification.imageUrl must be a valid URL string');
     }
     if (typeof notification.eventTimestamp !== 'undefined') {
         if (!(notification.eventTimestamp instanceof Date)) {
-            throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'android.notification.eventTimestamp must be a valid `Date` object');
+            throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'android.notification.eventTimestamp must be a valid `Date` object');
         }
         // Convert timestamp to RFC3339 UTC "Zulu" format, example "2014-10-02T15:01:23.045123456Z"
         const zuluTimestamp = notification.eventTimestamp.toISOString();
@@ -398,12 +398,12 @@ function validateAndroidNotification(notification) {
     }
     if (typeof notification.vibrateTimingsMillis !== 'undefined') {
         if (!validator.isNonEmptyArray(notification.vibrateTimingsMillis)) {
-            throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'android.notification.vibrateTimingsMillis must be a non-empty array of numbers');
+            throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'android.notification.vibrateTimingsMillis must be a non-empty array of numbers');
         }
         const vibrateTimings = [];
         notification.vibrateTimingsMillis.forEach((value) => {
             if (!validator.isNumber(value) || value < 0) {
-                throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'android.notification.vibrateTimingsMillis must be non-negative durations in milliseconds');
+                throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'android.notification.vibrateTimingsMillis must be non-negative durations in milliseconds');
             }
             const duration = (0, index_1.transformMillisecondsToSecondsString)(value);
             vibrateTimings.push(duration);
@@ -455,26 +455,26 @@ function validateLightSettings(lightSettings) {
         return;
     }
     else if (!validator.isNonNullObject(lightSettings)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'android.notification.lightSettings must be a non-null object');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'android.notification.lightSettings must be a non-null object');
     }
     if (!validator.isNumber(lightSettings.lightOnDurationMillis) || lightSettings.lightOnDurationMillis < 0) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'android.notification.lightSettings.lightOnDurationMillis must be a non-negative duration in milliseconds');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'android.notification.lightSettings.lightOnDurationMillis must be a non-negative duration in milliseconds');
     }
     const durationOn = (0, index_1.transformMillisecondsToSecondsString)(lightSettings.lightOnDurationMillis);
     lightSettings.lightOnDurationMillis = durationOn;
     if (!validator.isNumber(lightSettings.lightOffDurationMillis) || lightSettings.lightOffDurationMillis < 0) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'android.notification.lightSettings.lightOffDurationMillis must be a non-negative duration in milliseconds');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'android.notification.lightSettings.lightOffDurationMillis must be a non-negative duration in milliseconds');
     }
     const durationOff = (0, index_1.transformMillisecondsToSecondsString)(lightSettings.lightOffDurationMillis);
     lightSettings.lightOffDurationMillis = durationOff;
     if (!validator.isString(lightSettings.color) ||
         (!/^#[0-9a-fA-F]{6}$/.test(lightSettings.color) && !/^#[0-9a-fA-F]{8}$/.test(lightSettings.color))) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'android.notification.lightSettings.color must be in the form #RRGGBB or #RRGGBBAA format');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'android.notification.lightSettings.color must be in the form #RRGGBB or #RRGGBBAA format');
     }
     const colorString = lightSettings.color.length === 7 ? lightSettings.color + 'FF' : lightSettings.color;
     const rgb = /^#?([0-9a-fA-F]{2})([0-9a-fA-F]{2})([0-9a-fA-F]{2})([0-9a-fA-F]{2})$/i.exec(colorString);
     if (!rgb || rgb.length < 4) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INTERNAL_ERROR, 'regex to extract rgba values from ' + colorString + ' failed.');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INTERNAL_ERROR, 'regex to extract rgba values from ' + colorString + ' failed.');
     }
     const color = {
         red: parseInt(rgb[1], 16) / 255.0,
@@ -499,9 +499,9 @@ function validateAndroidFcmOptions(fcmOptions) {
         return;
     }
     else if (!validator.isNonNullObject(fcmOptions)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'fcmOptions must be a non-null object');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'fcmOptions must be a non-null object');
     }
     if (typeof fcmOptions.analyticsLabel !== 'undefined' && !validator.isString(fcmOptions.analyticsLabel)) {
-        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_PAYLOAD, 'analyticsLabel must be a string value');
+        throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_PAYLOAD, 'analyticsLabel must be a string value');
     }
 }

package/lib/messaging/messaging.d.ts

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

package/lib/messaging/messaging.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v13.9.0 */
+/*! firebase-admin v14.0.0 */
 "use strict";
 /*!
  * @license
@@ -19,7 +19,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Messaging = void 0;
 const deep_copy_1 = require("../utils/deep-copy");
-const error_1 = require("../utils/error");
+const error_1 = require("./error");
 const utils = require("../utils");
 const validator = require("../utils/validator");
 const messaging_internal_1 = require("./messaging-internal");
@@ -74,7 +74,7 @@ class Messaging {
     constructor(app) {
         this.useLegacyTransport = false;
         if (!validator.isNonNullObject(app) || !('options' in app)) {
-            throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_ARGUMENT, 'First argument passed to admin.messaging() must be a valid Firebase app instance.');
+            throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_ARGUMENT, 'First argument passed to admin.messaging() must be a valid Firebase app instance.');
         }
         this.appInternal = app;
         this.messagingRequestHandler = new messaging_api_request_internal_1.FirebaseMessagingRequestHandler(app);
@@ -121,7 +121,7 @@ class Messaging {
         const copy = (0, deep_copy_1.deepCopy)(message);
         (0, messaging_internal_1.validateMessage)(copy);
         if (typeof dryRun !== 'undefined' && !validator.isBoolean(dryRun)) {
-            throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_ARGUMENT, 'dryRun must be a boolean');
+            throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_ARGUMENT, 'dryRun must be a boolean');
         }
         return this.getUrlPath()
             .then((urlPath) => {
@@ -162,64 +162,61 @@ class Messaging {
         }
         const copy = (0, deep_copy_1.deepCopy)(messages);
         if (!validator.isNonEmptyArray(copy)) {
-            throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_ARGUMENT, 'messages must be a non-empty array');
+            throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_ARGUMENT, 'messages must be a non-empty array');
         }
         if (copy.length > FCM_MAX_BATCH_SIZE) {
-            throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_ARGUMENT, `messages list must not contain more than ${FCM_MAX_BATCH_SIZE} items`);
+            throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_ARGUMENT, `messages list must not contain more than ${FCM_MAX_BATCH_SIZE} items`);
         }
         if (typeof dryRun !== 'undefined' && !validator.isBoolean(dryRun)) {
-            throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_ARGUMENT, 'dryRun must be a boolean');
+            throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_ARGUMENT, 'dryRun must be a boolean');
         }
         const http2SessionHandler = this.useLegacyTransport ? undefined : new api_request_1.Http2SessionHandler(`https://${FCM_SEND_HOST}`);
         return this.getUrlPath()
             .then((urlPath) => {
-            if (http2SessionHandler) {
-                let sendResponsePromise;
-                return new Promise((resolve, reject) => {
-                    // Start session listeners
-                    http2SessionHandler.invoke().catch((error) => {
-                        const pendingBatchResponse = sendResponsePromise ? sendResponsePromise.then(this.parseSendResponses) : undefined;
-                        reject(new error_1.FirebaseMessagingSessionError(error, undefined, pendingBatchResponse));
-                    });
-                    // Start making requests
-                    const requests = copy.map(async (message) => {
-                        (0, messaging_internal_1.validateMessage)(message);
-                        const request = { message };
-                        if (dryRun) {
-                            request.validate_only = true;
-                        }
-                        return this.messagingRequestHandler.invokeHttp2RequestHandlerForSendResponse(FCM_SEND_HOST, urlPath, request, http2SessionHandler);
-                    });
-                    // Resolve once all requests have completed
-                    sendResponsePromise = Promise.allSettled(requests);
-                    sendResponsePromise.then(resolve);
-                });
-            }
-            else {
-                const requests = copy.map(async (message) => {
-                    (0, messaging_internal_1.validateMessage)(message);
-                    const request = { message };
-                    if (dryRun) {
-                        request.validate_only = true;
-                    }
+            const requests = copy.map(async (message) => {
+                (0, messaging_internal_1.validateMessage)(message);
+                const request = { message };
+                if (dryRun) {
+                    request.validate_only = true;
+                }
+                if (http2SessionHandler) {
+                    return this.messagingRequestHandler.invokeHttp2RequestHandlerForSendResponse(FCM_SEND_HOST, urlPath, request, http2SessionHandler);
+                }
+                else {
                     return this.messagingRequestHandler.invokeHttpRequestHandlerForSendResponse(FCM_SEND_HOST, urlPath, request);
-                });
-                return Promise.allSettled(requests);
-            }
+                }
+            });
+            return Promise.allSettled(requests);
+        })
+            .then((results) => {
+            const sessionErrors = http2SessionHandler ? http2SessionHandler.getErrors() : [];
+            return this.parseSendResponses(results, sessionErrors);
         })
-            .then(this.parseSendResponses)
             .finally(() => {
             http2SessionHandler?.close();
         });
     }
-    parseSendResponses(results) {
+    parseSendResponses(results, sessionErrors = []) {
         const responses = [];
         results.forEach(result => {
             if (result.status === 'fulfilled') {
                 responses.push(result.value);
             }
             else { // rejected
-                responses.push({ success: false, error: result.reason });
+                let error = result.reason;
+                if (sessionErrors.length > 0) {
+                    // Combine the original stream error and all session errors
+                    const allErrors = [result.reason, ...sessionErrors];
+                    const cause = new AggregateError(allErrors, 'Stream failure and session failures occurred');
+                    const streamMessage = result.reason?.message || 'Unknown stream error';
+                    const sessionMessage = `. Session failures: ${sessionErrors.map(e => e.message).join(', ')}`;
+                    error = new error_1.FirebaseMessagingError({
+                        code: error_1.messagingClientErrorCode.UNKNOWN_ERROR.code,
+                        message: `${streamMessage}${sessionMessage}`,
+                        cause: cause
+                    });
+                }
+                responses.push({ success: false, error });
             }
         });
         const successCount = responses.filter((resp) => resp.success).length;
@@ -250,13 +247,13 @@ class Messaging {
     sendEachForMulticast(message, dryRun) {
         const copy = (0, deep_copy_1.deepCopy)(message);
         if (!validator.isNonNullObject(copy)) {
-            throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_ARGUMENT, 'MulticastMessage must be a non-null object');
+            throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_ARGUMENT, 'MulticastMessage must be a non-null object');
         }
         if (!validator.isNonEmptyArray(copy.tokens)) {
-            throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_ARGUMENT, 'tokens must be a non-empty array');
+            throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_ARGUMENT, 'tokens must be a non-empty array');
         }
         if (copy.tokens.length > FCM_MAX_BATCH_SIZE) {
-            throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_ARGUMENT, `tokens list must not contain more than ${FCM_MAX_BATCH_SIZE} items`);
+            throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_ARGUMENT, `tokens list must not contain more than ${FCM_MAX_BATCH_SIZE} items`);
         }
         const messages = copy.tokens.map((token) => {
             return {
@@ -315,7 +312,7 @@ class Messaging {
             .then((projectId) => {
             if (!validator.isNonEmptyString(projectId)) {
                 // Assert for an explicit project ID (either via AppOptions or the cert itself).
-                throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_ARGUMENT, 'Failed to determine project ID for Messaging. Initialize the '
+                throw new error_1.FirebaseMessagingError(error_1.messagingClientErrorCode.INVALID_ARGUMENT, 'Failed to determine project ID for Messaging. Initialize the '
                     + 'SDK with service account credentials or set project ID as an app option. '
                     + 'Alternatively set the GOOGLE_CLOUD_PROJECT environment variable.');
             }
@@ -368,7 +365,7 @@ class Messaging {
      * @param method - The method name to use in error messages.
      * @param errorInfo - The error info to use if the registration tokens are invalid.
      */
-    validateRegistrationTokensType(registrationTokenOrTokens, methodName, errorInfo = error_1.MessagingClientErrorCode.INVALID_ARGUMENT) {
+    validateRegistrationTokensType(registrationTokenOrTokens, methodName, errorInfo = error_1.messagingClientErrorCode.INVALID_ARGUMENT) {
         if (!validator.isNonEmptyArray(registrationTokenOrTokens) &&
             !validator.isNonEmptyString(registrationTokenOrTokens)) {
             throw new error_1.FirebaseMessagingError(errorInfo, `Registration token(s) provided to ${methodName}() must be a non-empty string or a ` +
@@ -383,7 +380,7 @@ class Messaging {
      * @param method - The method name to use in error messages.
      * @param errorInfo - The error info to use if the registration tokens are invalid.
      */
-    validateRegistrationTokens(registrationTokenOrTokens, methodName, errorInfo = error_1.MessagingClientErrorCode.INVALID_ARGUMENT) {
+    validateRegistrationTokens(registrationTokenOrTokens, methodName, errorInfo = error_1.messagingClientErrorCode.INVALID_ARGUMENT) {
         if (validator.isArray(registrationTokenOrTokens)) {
             // Validate the array contains no more than 1,000 registration tokens.
             if (registrationTokenOrTokens.length > 1000) {
@@ -406,7 +403,7 @@ class Messaging {
      * @param method - The method name to use in error messages.
      * @param errorInfo - The error info to use if the topic is invalid.
      */
-    validateTopicType(topic, methodName, errorInfo = error_1.MessagingClientErrorCode.INVALID_ARGUMENT) {
+    validateTopicType(topic, methodName, errorInfo = error_1.messagingClientErrorCode.INVALID_ARGUMENT) {
         if (!validator.isNonEmptyString(topic)) {
             throw new error_1.FirebaseMessagingError(errorInfo, `Topic provided to ${methodName}() must be a string which matches the format ` +
                 '"/topics/[a-zA-Z0-9-_.~%]+".');
@@ -419,7 +416,7 @@ class Messaging {
      * @param method - The method name to use in error messages.
      * @param errorInfo - The error info to use if the topic is invalid.
      */
-    validateTopic(topic, methodName, errorInfo = error_1.MessagingClientErrorCode.INVALID_ARGUMENT) {
+    validateTopic(topic, methodName, errorInfo = error_1.messagingClientErrorCode.INVALID_ARGUMENT) {
         if (!validator.isTopic(topic)) {
             throw new error_1.FirebaseMessagingError(errorInfo, `Topic provided to ${methodName}() must be a string which matches the format ` +
                 '"/topics/[a-zA-Z0-9-_.~%]+".');

package/lib/phone-number-verification/error.d.ts

@@ -0,0 +1,43 @@
+/*! 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 { FirebaseError, ErrorInfo } from '../utils/error';
+/**
+ * The constant mapping for valid Phone Number Verification client error codes.
+ */
+export declare const PhoneNumberVerificationErrorCode: {
+    readonly INVALID_ARGUMENT: "invalid-argument";
+    readonly INVALID_TOKEN: "invalid-token";
+    readonly EXPIRED_TOKEN: "expired-token";
+};
+/**
+ * The type definition for valid Phone Number Verification client error codes.
+ */
+export type PhoneNumberVerificationErrorCode = typeof PhoneNumberVerificationErrorCode[keyof typeof PhoneNumberVerificationErrorCode];
+export declare const FPNV_ERROR_CODE_MAPPING: {
+    readonly INVALID_ARGUMENT: "invalid-argument";
+    readonly INVALID_TOKEN: "invalid-token";
+    readonly EXPIRED_TOKEN: "expired-token";
+};
+/**
+ * Firebase Phone Number Verification error code structure. This extends `FirebaseError`.
+ *
+ * @param info - The error code info.
+ * @param message - The error message. If provided, this will override the default message.
+ */
+export declare class FirebasePhoneNumberVerificationError extends FirebaseError {
+    constructor(info: ErrorInfo, message?: string);
+}