firebase-admin 12.2.0 → 12.3.0

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

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2019 Google Inc.
  *
@@ -14,16 +14,16 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { HttpError } from '../utils/api-request';
+import { RequestResponseError } from '../utils/api-request';
 import { FirebaseMessagingError } from '../utils/error';
 /**
- * Creates a new FirebaseMessagingError by extracting the error code, message and other relevant
- * details from an HTTP error response.
+ * Creates a new `FirebaseMessagingError` by extracting the error code, message and other relevant
+ * details from a `RequestResponseError` response.
  *
- * @param err - The HttpError to convert into a Firebase error
+ * @param err - The `RequestResponseError` to convert into a Firebase error
  * @returns A Firebase error that can be returned to the user.
  */
-export declare function createFirebaseError(err: HttpError): FirebaseMessagingError;
+export declare function createFirebaseError(err: RequestResponseError): FirebaseMessagingError;
 /**
  * @param response - The response to check for errors.
  * @returns The error code if present; null otherwise.

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

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 /*!
  * Copyright 2019 Google Inc.
@@ -20,10 +20,10 @@ exports.getErrorCode = exports.createFirebaseError = void 0;
 const error_1 = require("../utils/error");
 const validator = require("../utils/validator");
 /**
- * Creates a new FirebaseMessagingError by extracting the error code, message and other relevant
- * details from an HTTP error response.
+ * Creates a new `FirebaseMessagingError` by extracting the error code, message and other relevant
+ * details from a `RequestResponseError` response.
  *
- * @param err - The HttpError to convert into a Firebase error
+ * @param err - The `RequestResponseError` to convert into a Firebase error
  * @returns A Firebase error that can be returned to the user.
  */
 function createFirebaseError(err) {

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

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2020 Google Inc.
  *

package/lib/messaging/messaging-internal.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 /*!
  * Copyright 2020 Google Inc.

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

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2021 Google Inc.
  *

package/lib/messaging/messaging-namespace.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 /*!
  * Copyright 2021 Google Inc.

package/lib/messaging/messaging.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * @license
  * Copyright 2017 Google Inc.
@@ -24,6 +24,7 @@ export declare class Messaging {
     private urlPath;
     private readonly appInternal;
     private readonly messagingRequestHandler;
+    private useLegacyTransport;
     /**
      * The {@link firebase-admin.app#App} associated with the current `Messaging` service
      * instance.
@@ -34,6 +35,20 @@ export declare class Messaging {
      * ```
      */
     get app(): App;
+    /**
+     * Enables the use of legacy HTTP/1.1 transport for `sendEach()` and `sendEachForMulticast()`.
+     *
+     * @example
+     * ```javascript
+     * const messaging = getMessaging(app);
+     * messaging.enableLegacyTransport();
+     * messaging.sendEach(messages);
+     * ```
+     *
+     * @deprecated This will be removed when the HTTP/2 transport implementation reaches the same
+     * stability as the legacy HTTP/1.1 implementation.
+     */
+    enableLegacyHttpTransport(): void;
     /**
      * Sends the given message via FCM.
      *

package/lib/messaging/messaging.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 /*!
  * @license
@@ -24,6 +24,7 @@ const utils = require("../utils");
 const validator = require("../utils/validator");
 const messaging_internal_1 = require("./messaging-internal");
 const messaging_api_request_internal_1 = require("./messaging-api-request-internal");
+const api_request_1 = require("../utils/api-request");
 // FCM endpoints
 const FCM_SEND_HOST = 'fcm.googleapis.com';
 const FCM_SEND_PATH = '/fcm/send';
@@ -76,11 +77,11 @@ const MESSAGING_CONDITION_RESPONSE_KEYS_MAP = {
     message_id: 'messageId',
 };
 /**
- * Maps a raw FCM server response to a MessagingDevicesResponse object.
+ * Maps a raw FCM server response to a `MessagingDevicesResponse` object.
  *
  * @param response - The raw FCM server response to map.
  *
- * @returns The mapped MessagingDevicesResponse object.
+ * @returns The mapped `MessagingDevicesResponse` object.
  */
 function mapRawResponseToDevicesResponse(response) {
     // Rename properties on the server response
@@ -98,11 +99,11 @@ function mapRawResponseToDevicesResponse(response) {
     return response;
 }
 /**
- * Maps a raw FCM server response to a MessagingDeviceGroupResponse object.
+ * Maps a raw FCM server response to a `MessagingDeviceGroupResponse` object.
  *
  * @param response - The raw FCM server response to map.
  *
- * @returns The mapped MessagingDeviceGroupResponse object.
+ * @returns The mapped `MessagingDeviceGroupResponse` object.
  */
 function mapRawResponseToDeviceGroupResponse(response) {
     // Rename properties on the server response
@@ -113,11 +114,11 @@ function mapRawResponseToDeviceGroupResponse(response) {
     return response;
 }
 /**
- * Maps a raw FCM server response to a MessagingTopicManagementResponse object.
+ * Maps a raw FCM server response to a `MessagingTopicManagementResponse` object.
  *
  * @param {object} response The raw FCM server response to map.
  *
- * @returns {MessagingTopicManagementResponse} The mapped MessagingTopicManagementResponse object.
+ * @returns {MessagingTopicManagementResponse} The mapped `MessagingTopicManagementResponse` object.
  */
 function mapRawResponseToTopicManagementResponse(response) {
     // Add the success and failure counts.
@@ -152,6 +153,7 @@ class Messaging {
      * @internal
      */
     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.');
         }
@@ -170,6 +172,22 @@ class Messaging {
     get app() {
         return this.appInternal;
     }
+    /**
+     * Enables the use of legacy HTTP/1.1 transport for `sendEach()` and `sendEachForMulticast()`.
+     *
+     * @example
+     * ```javascript
+     * const messaging = getMessaging(app);
+     * messaging.enableLegacyTransport();
+     * messaging.sendEach(messages);
+     * ```
+     *
+     * @deprecated This will be removed when the HTTP/2 transport implementation reaches the same
+     * stability as the legacy HTTP/1.1 implementation.
+     */
+    enableLegacyHttpTransport() {
+        this.useLegacyTransport = true;
+    }
     /**
      * Sends the given message via FCM.
      *
@@ -233,6 +251,7 @@ class Messaging {
         if (typeof dryRun !== 'undefined' && !validator.isBoolean(dryRun)) {
             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) => {
             const requests = copy.map(async (message) => {
@@ -241,10 +260,14 @@ class Messaging {
                 if (dryRun) {
                     request.validate_only = true;
                 }
-                return this.messagingRequestHandler.invokeRequestHandlerForSendResponse(FCM_SEND_HOST, urlPath, request);
+                if (http2SessionHandler) {
+                    return this.messagingRequestHandler.invokeHttp2RequestHandlerForSendResponse(FCM_SEND_HOST, urlPath, request, http2SessionHandler);
+                }
+                return this.messagingRequestHandler.invokeHttpRequestHandlerForSendResponse(FCM_SEND_HOST, urlPath, request);
             });
             return Promise.allSettled(requests);
-        }).then((results) => {
+        })
+            .then((results) => {
             const responses = [];
             results.forEach(result => {
                 if (result.status === 'fulfilled') {
@@ -260,6 +283,11 @@ class Messaging {
                 successCount,
                 failureCount: responses.length - successCount,
             };
+        })
+            .finally(() => {
+            if (http2SessionHandler) {
+                http2SessionHandler.close();
+            }
         });
     }
     /**

package/lib/project-management/android-app.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2018 Google Inc.
  *

package/lib/project-management/android-app.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 /*!
  * Copyright 2018 Google Inc.

package/lib/project-management/app-metadata.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2021 Google Inc.
  *

package/lib/project-management/app-metadata.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 /*!
  * Copyright 2021 Google Inc.

package/lib/project-management/index.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2020 Google Inc.
  *

package/lib/project-management/index.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 /*!
  * Copyright 2020 Google Inc.

package/lib/project-management/ios-app.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2018 Google Inc.
  *

package/lib/project-management/ios-app.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 /*!
  * Copyright 2018 Google Inc.

package/lib/project-management/project-management-api-request-internal.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2018 Google Inc.
  *

package/lib/project-management/project-management-api-request-internal.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 /*!
  * Copyright 2018 Google Inc.
@@ -253,12 +253,12 @@ class ProjectManagementRequestHandler {
             .then((response) => {
             // Send non-JSON responses to the catch() below, where they will be treated as errors.
             if (!response.isJson()) {
-                throw new api_request_1.HttpError(response);
+                throw new api_request_1.RequestResponseError(response);
             }
             return response.data;
         })
             .catch((err) => {
-            if (err instanceof api_request_1.HttpError) {
+            if (err instanceof api_request_1.RequestResponseError) {
                 ProjectManagementRequestHandler.wrapAndRethrowHttpError(err.response.status, err.response.text);
             }
             throw err;

package/lib/project-management/project-management-namespace.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2021 Google Inc.
  *

package/lib/project-management/project-management-namespace.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 /*!
  * Copyright 2021 Google Inc.

package/lib/project-management/project-management.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2018 Google Inc.
  *

package/lib/project-management/project-management.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 /*!
  * Copyright 2018 Google Inc.

package/lib/remote-config/condition-evaluator-internal.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2024 Google Inc.
  *

package/lib/remote-config/condition-evaluator-internal.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2024 Google Inc.
  *
@@ -19,7 +19,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConditionEvaluator = void 0;
 const remote_config_api_1 = require("./remote-config-api");
 const farmhash = require("farmhash-modern");
-const long = require("long");
 /**
  * Encapsulates condition evaluation logic to simplify organization and
  * facilitate testing.
@@ -102,22 +101,16 @@ class ConditionEvaluator {
         const normalizedMicroPercentLowerBound = microPercentRange?.microPercentLowerBound || 0;
         const seedPrefix = seed && seed.length > 0 ? `${seed}.` : '';
         const stringToHash = `${seedPrefix}${context.randomizationId}`;
-        // Using a 64-bit long for consistency with the Remote Config fetch endpoint.
-        let hash64 = long.fromString(farmhash.fingerprint64(stringToHash).toString());
-        // Negate the hash if its value is less than 0. We handle this manually because the
-        // Long library doesn't provided an absolute value method.
-        if (hash64.lt(0)) {
-            hash64 = hash64.negate();
-        }
-        const instanceMicroPercentile = hash64.mod(100 * 1000000);
+        const hash64 = ConditionEvaluator.hashSeededRandomizationId(stringToHash);
+        const instanceMicroPercentile = hash64 % BigInt(100 * 1000000);
         switch (percentOperator) {
             case remote_config_api_1.PercentConditionOperator.LESS_OR_EQUAL:
-                return instanceMicroPercentile.lte(normalizedMicroPercent);
+                return instanceMicroPercentile <= normalizedMicroPercent;
             case remote_config_api_1.PercentConditionOperator.GREATER_THAN:
-                return instanceMicroPercentile.gt(normalizedMicroPercent);
+                return instanceMicroPercentile > normalizedMicroPercent;
             case remote_config_api_1.PercentConditionOperator.BETWEEN:
-                return instanceMicroPercentile.gt(normalizedMicroPercentLowerBound)
-                    && instanceMicroPercentile.lte(normalizedMicroPercentUpperBound);
+                return instanceMicroPercentile > normalizedMicroPercentLowerBound
+                    && instanceMicroPercentile <= normalizedMicroPercentUpperBound;
             case remote_config_api_1.PercentConditionOperator.UNKNOWN:
             default:
                 break;
@@ -125,6 +118,19 @@ class ConditionEvaluator {
         // TODO: add logging once we have a wrapped logger.
         return false;
     }
+    // Visible for testing
+    static hashSeededRandomizationId(seededRandomizationId) {
+        // For consistency with the Remote Config fetch endpoint's percent condition behavior
+        // we use Farmhash's fingerprint64 algorithm and interpret the resulting unsigned value
+        // as a signed value.
+        let hash64 = BigInt.asIntN(64, farmhash.fingerprint64(seededRandomizationId));
+        // Manually negate the hash if its value is less than 0, since Math.abs doesn't
+        // support BigInt.
+        if (hash64 < 0) {
+            hash64 = -hash64;
+        }
+        return hash64;
+    }
 }
 exports.ConditionEvaluator = ConditionEvaluator;
 ConditionEvaluator.MAX_CONDITION_RECURSION_DEPTH = 10;

package/lib/remote-config/index.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2020 Google Inc.
  *

package/lib/remote-config/index.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 /*!
  * Copyright 2020 Google Inc.

package/lib/remote-config/internal/value-impl.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2024 Google Inc.
  *

package/lib/remote-config/internal/value-impl.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2024 Google Inc.
  *

package/lib/remote-config/remote-config-api-client-internal.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2020 Google Inc.
  *

package/lib/remote-config/remote-config-api-client-internal.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 /*!
  * Copyright 2020 Google Inc.

package/lib/remote-config/remote-config-api.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2021 Google Inc.
  *

package/lib/remote-config/remote-config-api.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 /*!
  * Copyright 2021 Google Inc.

package/lib/remote-config/remote-config-namespace.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2021 Google Inc.
  *

package/lib/remote-config/remote-config-namespace.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 /*!
  * Copyright 2021 Google Inc.

package/lib/remote-config/remote-config.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2020 Google Inc.
  *

package/lib/remote-config/remote-config.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 /*!
  * Copyright 2020 Google Inc.

package/lib/security-rules/index.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2020 Google Inc.
  *

package/lib/security-rules/index.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 /*!
  * Copyright 2020 Google Inc.

package/lib/security-rules/security-rules-api-client-internal.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2019 Google Inc.
  *

package/lib/security-rules/security-rules-api-client-internal.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 /*!
  * Copyright 2019 Google Inc.

package/lib/security-rules/security-rules-internal.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2019 Google Inc.
  *

package/lib/security-rules/security-rules-internal.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 /*!
  * Copyright 2019 Google Inc.

package/lib/security-rules/security-rules-namespace.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2021 Google Inc.
  *

package/lib/security-rules/security-rules-namespace.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 /*!
  * Copyright 2021 Google Inc.

package/lib/security-rules/security-rules.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2019 Google Inc.
  *

package/lib/security-rules/security-rules.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 /*!
  * Copyright 2019 Google Inc.

package/lib/storage/index.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2020 Google Inc.
  *

package/lib/storage/index.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 /*!
  * Copyright 2020 Google Inc.

package/lib/storage/storage-namespace.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * Copyright 2021 Google Inc.
  *

package/lib/storage/storage-namespace.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 /*!
  * Copyright 2021 Google Inc.

package/lib/storage/storage.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 /*!
  * @license
  * Copyright 2017 Google Inc.

package/lib/storage/storage.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 /*!
  * @license

package/lib/storage/utils.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 import { File } from '@google-cloud/storage';
 export interface FirebaseMetadata {
     name: string;

package/lib/storage/utils.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.2.0 */
+/*! firebase-admin v12.3.0 */
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getFirebaseMetadata = void 0;