firebase-admin 4.1.2 → 4.2.1

package/lib/messaging/messaging-api-request.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v4.1.2
+/*! firebase-admin v4.2.1
     https://firebase.google.com/terms/ */
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -7,14 +7,12 @@ var api_request_1 = require("../utils/api-request");
 var error_2 = require("../utils/error");
 var validator = require("../utils/validator");
 // FCM backend constants
-var FIREBASE_MESSAGING_HOST = 'fcm.googleapis.com';
 var FIREBASE_MESSAGING_PORT = 443;
-var FIREBASE_MESSAGING_PATH = '/fcm/send';
 var FIREBASE_MESSAGING_TIMEOUT = 10000;
 var FIREBASE_MESSAGING_HTTP_METHOD = 'POST';
 var FIREBASE_MESSAGING_HEADERS = {
     'Content-Type': 'application/json',
-    'Sdk-Version': 'Node/Admin/4.1.2',
+    'Sdk-Version': 'Node/Admin/4.2.1',
     access_token_auth: 'true',
 };
 /**
@@ -46,11 +44,13 @@ var FirebaseMessagingRequestHandler = (function () {
     /**
      * Invokes the request handler with the provided request data.
      *
+     * @param {string} host The host to which to send the request.
+     * @param {string} path The path to which to send the request.
      * @param {Object} requestData The request data.
      * @return {Promise<Object>} A promise that resolves with the response.
      */
-    FirebaseMessagingRequestHandler.prototype.invokeRequestHandler = function (requestData) {
-        return this.signedApiRequestHandler.sendRequest(FIREBASE_MESSAGING_HOST, FIREBASE_MESSAGING_PORT, FIREBASE_MESSAGING_PATH, FIREBASE_MESSAGING_HTTP_METHOD, requestData, FIREBASE_MESSAGING_HEADERS, FIREBASE_MESSAGING_TIMEOUT).then(function (response) {
+    FirebaseMessagingRequestHandler.prototype.invokeRequestHandler = function (host, path, requestData) {
+        return this.signedApiRequestHandler.sendRequest(host, FIREBASE_MESSAGING_PORT, path, FIREBASE_MESSAGING_HTTP_METHOD, requestData, FIREBASE_MESSAGING_HEADERS, FIREBASE_MESSAGING_TIMEOUT).then(function (response) {
             // Send non-JSON responses to the catch() below where they will be treated as errors.
             if (typeof response === 'string') {
                 return Promise.reject({
@@ -71,7 +71,10 @@ var FirebaseMessagingRequestHandler = (function () {
         })
             .catch(function (response) {
             // Re-throw the error if it already has the proper format.
-            if (response.error instanceof error_1.FirebaseError) {
+            if (response instanceof error_1.FirebaseError) {
+                throw response;
+            }
+            else if (response.error instanceof error_1.FirebaseError) {
                 throw response.error;
             }
             // Add special handling for non-JSON responses.

package/lib/messaging/messaging.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v4.1.2
+/*! firebase-admin v4.2.1
     https://firebase.google.com/terms/ */
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -7,6 +7,12 @@ var messaging_api_request_1 = require("./messaging-api-request");
 var error_1 = require("../utils/error");
 var utils = require("../utils");
 var validator = require("../utils/validator");
+// FCM endpoints
+var FCM_SEND_HOST = 'fcm.googleapis.com';
+var FCM_SEND_PATH = '/fcm/send';
+var FCM_TOPIC_MANAGEMENT_HOST = 'iid.googleapis.com';
+var FCM_TOPIC_MANAGEMENT_ADD_PATH = '/iid/v1:batchAdd';
+var FCM_TOPIC_MANAGEMENT_REMOVE_PATH = '/iid/v1:batchRemove';
 // Key renames for the messaging notification payload object.
 var CAMELCASED_NOTIFICATION_PAYLOAD_KEYS_MAP = {
     bodyLocArgs: 'body_loc_args',
@@ -93,6 +99,38 @@ function mapRawResponseToDeviceGroupResponse(response) {
     response.failedRegistrationTokens = response.failedRegistrationTokens || [];
     return response;
 }
+/**
+ * Maps a raw FCM server response to a MessagingTopicManagementResponse object.
+ *
+ * @param {Object} response The raw FCM server response to map.
+ *
+ * @return {MessagingTopicManagementResponse} The mapped MessagingTopicManagementResponse object.
+ */
+function mapRawResponseToTopicManagementResponse(response) {
+    // Add the success and failure counts.
+    response.successCount = 0;
+    response.failureCount = 0;
+    var errors = [];
+    if ('results' in response) {
+        response.results.forEach(function (tokenManagementResult, index) {
+            // Map the FCM server's error strings to actual error objects.
+            if ('error' in tokenManagementResult) {
+                response.failureCount += 1;
+                var newError = error_1.FirebaseMessagingError.fromServerError(tokenManagementResult.error, /* message */ undefined, tokenManagementResult.error);
+                errors.push({
+                    index: index,
+                    error: newError,
+                });
+            }
+            else {
+                response.successCount += 1;
+            }
+        });
+    }
+    delete response.results;
+    response.errors = errors;
+    return response;
+}
 /**
  * Internals of a Messaging instance.
  */
@@ -154,34 +192,15 @@ var Messaging = (function () {
     Messaging.prototype.sendToDevice = function (registrationTokenOrTokens, payload, options) {
         var _this = this;
         if (options === void 0) { options = {}; }
-        if (registrationTokenOrTokens instanceof Array && registrationTokenOrTokens.length !== 0) {
-            // Validate the array contains no more than 1,000 registration tokens.
-            if (registrationTokenOrTokens.length > 1000) {
-                return Promise.reject(new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_RECIPIENT, 'Too many registration tokens provided in a single request. Batch your requests to ' +
-                    'contain no more than 1,000 registration tokens per request.'));
-            }
-            // Validate the array contains registration tokens which are non-empty strings.
-            try {
-                registrationTokenOrTokens.forEach(function (registrationToken, index) {
-                    if (!validator.isNonEmptyString(registrationToken)) {
-                        throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_RECIPIENT, "Registration token provided to sendToDevice() at index " + index + " must be a non-empty string.");
-                    }
-                });
-            }
-            catch (error) {
-                return Promise.reject(error);
-            }
-        }
-        else if (!validator.isNonEmptyString(registrationTokenOrTokens)) {
-            throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_RECIPIENT, 'Registration token provided to sendToDevice() must be a non-empty string or a non-empty array.');
-        }
-        // Validate the types of the payload and options arguments. Since these are common developer
-        // errors, throw an error instead of returning a rejected promise.
+        // Validate the input argument types. Since these are common developer errors when getting
+        // started, throw an error instead of returning a rejected promise.
+        this.validateRegistrationTokensType(registrationTokenOrTokens, 'sendToDevice', error_1.MessagingClientErrorCode.INVALID_RECIPIENT);
         this.validateMessagingPayloadAndOptionsTypes(payload, options);
         return Promise.resolve()
             .then(function () {
-            // Validate the contents of the payload and options objects. Because we are now in a
-            // promise, any thrown error will cause this method to return a rejected promise.
+            // Validate the contents of the input arguments. Because we are now in a promise, any thrown
+            // error will cause this method to return a rejected promise.
+            _this.validateRegistrationTokens(registrationTokenOrTokens, 'sendToDevice', error_1.MessagingClientErrorCode.INVALID_RECIPIENT);
             var payloadCopy = _this.validateMessagingPayload(payload);
             var optionsCopy = _this.validateMessagingOptions(options);
             var request = deep_copy_1.deepCopy(payloadCopy);
@@ -192,7 +211,7 @@ var Messaging = (function () {
             else {
                 request.registration_ids = registrationTokenOrTokens;
             }
-            return _this.messagingRequestHandler.invokeRequestHandler(request);
+            return _this.messagingRequestHandler.invokeRequestHandler(FCM_SEND_HOST, FCM_SEND_PATH, request);
         })
             .then(function (response) {
             // The sendToDevice() and sendToDeviceGroup() methods both set the `to` query parameter in
@@ -246,7 +265,7 @@ var Messaging = (function () {
             var request = deep_copy_1.deepCopy(payloadCopy);
             deep_copy_1.deepExtend(request, optionsCopy);
             request.to = notificationKey;
-            return _this.messagingRequestHandler.invokeRequestHandler(request);
+            return _this.messagingRequestHandler.invokeRequestHandler(FCM_SEND_HOST, FCM_SEND_PATH, request);
         })
             .then(function (response) {
             // The sendToDevice() and sendToDeviceGroup() methods both set the `to` query parameter in
@@ -281,29 +300,23 @@ var Messaging = (function () {
     Messaging.prototype.sendToTopic = function (topic, payload, options) {
         var _this = this;
         if (options === void 0) { options = {}; }
-        if (!validator.isNonEmptyString(topic)) {
-            throw new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_RECIPIENT, 'Topic provided to sendToTopic() must be a string which matches the format "/topics/[a-zA-Z0-9-_.~%]+".');
-        }
-        else if (!validator.isTopic(topic)) {
-            return Promise.reject(new error_1.FirebaseMessagingError(error_1.MessagingClientErrorCode.INVALID_RECIPIENT, 'Topic provided to sendToTopic() must be a string which matches the format "/topics/[a-zA-Z0-9-_.~%]+".'));
-        }
-        // Prepend the topic with /topics/ if necessary
-        if (!/^\/topics\//.test(topic)) {
-            topic = "/topics/" + topic;
-        }
-        // Validate the types of the payload and options arguments. Since these are common developer
-        // errors, throw an error instead of returning a rejected promise.
+        // Validate the input argument types. Since these are common developer errors when getting
+        // started, throw an error instead of returning a rejected promise.
+        this.validateTopicType(topic, 'sendToTopic', error_1.MessagingClientErrorCode.INVALID_RECIPIENT);
         this.validateMessagingPayloadAndOptionsTypes(payload, options);
+        // Prepend the topic with /topics/ if necessary.
+        topic = this.normalizeTopic(topic);
         return Promise.resolve()
             .then(function () {
             // Validate the contents of the payload and options objects. Because we are now in a
             // promise, any thrown error will cause this method to return a rejected promise.
             var payloadCopy = _this.validateMessagingPayload(payload);
             var optionsCopy = _this.validateMessagingOptions(options);
+            _this.validateTopic(topic, 'sendToTopic', error_1.MessagingClientErrorCode.INVALID_RECIPIENT);
             var request = deep_copy_1.deepCopy(payloadCopy);
             deep_copy_1.deepExtend(request, optionsCopy);
             request.to = topic;
-            return _this.messagingRequestHandler.invokeRequestHandler(request);
+            return _this.messagingRequestHandler.invokeRequestHandler(FCM_SEND_HOST, FCM_SEND_PATH, request);
         })
             .then(function (response) {
             // Rename properties on the server response
@@ -344,7 +357,7 @@ var Messaging = (function () {
             var request = deep_copy_1.deepCopy(payloadCopy);
             deep_copy_1.deepExtend(request, optionsCopy);
             request.condition = condition;
-            return _this.messagingRequestHandler.invokeRequestHandler(request);
+            return _this.messagingRequestHandler.invokeRequestHandler(FCM_SEND_HOST, FCM_SEND_PATH, request);
         })
             .then(function (response) {
             // Rename properties on the server response
@@ -352,6 +365,71 @@ var Messaging = (function () {
             return response;
         });
     };
+    /**
+     * Subscribes a single device or an array of devices to a topic.
+     *
+     * @param {string|string[]} registrationTokenOrTokens The registration token or an array of
+     *     registration tokens to subscribe to the topic.
+     * @param {string} topic The topic to which to subscribe.
+     *
+     * @return {Promise<MessagingTopicManagementResponse>} A Promise fulfilled with the parsed FCM
+     *   server response.
+     */
+    Messaging.prototype.subscribeToTopic = function (registrationTokenOrTokens, topic) {
+        return this.sendTopicManagementRequest(registrationTokenOrTokens, topic, 'subscribeToTopic', FCM_TOPIC_MANAGEMENT_ADD_PATH);
+    };
+    /**
+     * Unsubscribes a single device or an array of devices from a topic.
+     *
+     * @param {string|string[]} registrationTokenOrTokens The registration token or an array of
+     *     registration tokens to unsubscribe from the topic.
+     * @param {string} topic The topic to which to subscribe.
+     *
+     * @return {Promise<MessagingTopicManagementResponse>} A Promise fulfilled with the parsed FCM
+     *   server response.
+     */
+    Messaging.prototype.unsubscribeFromTopic = function (registrationTokenOrTokens, topic) {
+        return this.sendTopicManagementRequest(registrationTokenOrTokens, topic, 'unsubscribeFromTopic', FCM_TOPIC_MANAGEMENT_REMOVE_PATH);
+    };
+    /**
+     * Helper method which sends and handles topic subscription management requests.
+     *
+     * @param {string|string[]} registrationTokenOrTokens The registration token or an array of
+     *     registration tokens to unsubscribe from the topic.
+     * @param {string} topic The topic to which to subscribe.
+     * @param {string} methodName The name of the original method called.
+     * @param {string} path The endpoint path to use for the request.
+     *
+     * @return {Promise<MessagingTopicManagementResponse>} A Promise fulfilled with the parsed server
+     *   response.
+     */
+    Messaging.prototype.sendTopicManagementRequest = function (registrationTokenOrTokens, topic, methodName, path) {
+        var _this = this;
+        this.validateRegistrationTokensType(registrationTokenOrTokens, methodName);
+        this.validateTopicType(topic, methodName);
+        // Prepend the topic with /topics/ if necessary.
+        topic = this.normalizeTopic(topic);
+        return Promise.resolve()
+            .then(function () {
+            // Validate the contents of the input arguments. Because we are now in a promise, any thrown
+            // error will cause this method to return a rejected promise.
+            _this.validateRegistrationTokens(registrationTokenOrTokens, methodName);
+            _this.validateTopic(topic, methodName);
+            // Ensure the registration token(s) input argument is an array.
+            var registrationTokensArray = registrationTokenOrTokens;
+            if (validator.isString(registrationTokenOrTokens)) {
+                registrationTokensArray = [registrationTokenOrTokens];
+            }
+            var request = {
+                to: topic,
+                registration_tokens: registrationTokensArray,
+            };
+            return _this.messagingRequestHandler.invokeRequestHandler(FCM_TOPIC_MANAGEMENT_HOST, path, request);
+        })
+            .then(function (response) {
+            return mapRawResponseToTopicManagementResponse(response);
+        });
+    };
     /**
      * Validates the types of the messaging payload and options. If invalid, an error will be thrown.
      *
@@ -484,6 +562,87 @@ var Messaging = (function () {
         }
         return optionsCopy;
     };
+    /**
+     * Validates the type of the provided registration token(s). If invalid, an error will be thrown.
+     *
+     * @param {string|string[]} registrationTokenOrTokens The registration token(s) to validate.
+     * @param {string} method The method name to use in error messages.
+     * @param {ErrorInfo?} [errorInfo] The error info to use if the registration tokens are invalid.
+     */
+    Messaging.prototype.validateRegistrationTokensType = function (registrationTokenOrTokens, methodName, errorInfo) {
+        if (errorInfo === void 0) { 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 " +
+                'non-empty array.');
+        }
+    };
+    /**
+     * Validates the provided registration tokens. If invalid, an error will be thrown.
+     *
+     * @param {string|string[]} registrationTokenOrTokens The registration token or an array of
+     *     registration tokens to validate.
+     * @param {string} method The method name to use in error messages.
+     * @param {errorInfo?} [ErrorInfo] The error info to use if the registration tokens are invalid.
+     */
+    Messaging.prototype.validateRegistrationTokens = function (registrationTokenOrTokens, methodName, errorInfo) {
+        if (errorInfo === void 0) { 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) {
+                throw new error_1.FirebaseMessagingError(errorInfo, "Too many registration tokens provided in a single request to " + methodName + "(). Batch " +
+                    'your requests to contain no more than 1,000 registration tokens per request.');
+            }
+            // Validate the array contains registration tokens which are non-empty strings.
+            registrationTokenOrTokens.forEach(function (registrationToken, index) {
+                if (!validator.isNonEmptyString(registrationToken)) {
+                    throw new error_1.FirebaseMessagingError(errorInfo, "Registration token provided to " + methodName + "() at index " + index + " must be a " +
+                        'non-empty string.');
+                }
+            });
+        }
+    };
+    /**
+     * Validates the type of the provided topic. If invalid, an error will be thrown.
+     *
+     * @param {string} topic The topic to validate.
+     * @param {string} method The method name to use in error messages.
+     * @param {ErrorInfo?} [errorInfo] The error info to use if the topic is invalid.
+     */
+    Messaging.prototype.validateTopicType = function (topic, methodName, errorInfo) {
+        if (errorInfo === void 0) { 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-_.~%]+".');
+        }
+    };
+    /**
+     * Validates the provided topic. If invalid, an error will be thrown.
+     *
+     * @param {string} topic The topic to validate.
+     * @param {string} method The method name to use in error messages.
+     * @param {ErrorInfo?} [errorInfo] The error info to use if the topic is invalid.
+     */
+    Messaging.prototype.validateTopic = function (topic, methodName, errorInfo) {
+        if (errorInfo === void 0) { 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-_.~%]+".');
+        }
+    };
+    /**
+     * Normalizes the provided topic name by prepending it with '/topics/', if necessary.
+     *
+     * @param {string} topic The topic name to normalize.
+     *
+     * @return {string} The normalized topic name.
+     */
+    Messaging.prototype.normalizeTopic = function (topic) {
+        if (!/^\/topics\//.test(topic)) {
+            topic = "/topics/" + topic;
+        }
+        return topic;
+    };
     return Messaging;
 }());
 exports.Messaging = Messaging;

package/lib/messaging/register-messaging.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v4.1.2
+/*! firebase-admin v4.2.1
     https://firebase.google.com/terms/ */
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });

package/lib/utils/api-request.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v4.1.2
+/*! firebase-admin v4.2.1
     https://firebase.google.com/terms/ */
 "use strict";
 var __extends = (this && this.__extends) || (function () {
@@ -87,11 +87,8 @@ var HttpRequestHandler = (function () {
                             }
                         }
                         catch (error) {
-                            var parsingError = new error_1.FirebaseError({
-                                code: 'unable-to-parse-response',
-                                message: "Failed to parse response data: \"" + error.toString() + "\". Raw server " +
-                                    ("response: \"" + response + ".\""),
-                            });
+                            var parsingError = new error_1.FirebaseAppError(error_1.AppErrorCodes.UNABLE_TO_PARSE_RESPONSE, "Failed to parse response data: \"" + error.toString() + "\". Raw server" +
+                                ("response: \"" + response + ".\""));
                             reject({
                                 statusCode: statusCode,
                                 error: parsingError,
@@ -106,10 +103,7 @@ var HttpRequestHandler = (function () {
                     socket.setTimeout(timeout);
                     socket.on('timeout', function () {
                         req.abort();
-                        var networkTimeoutError = new error_1.FirebaseError({
-                            code: 'network-timeout',
-                            message: host + " network timeout. Please try again.",
-                        });
+                        var networkTimeoutError = new error_1.FirebaseAppError(error_1.AppErrorCodes.NETWORK_TIMEOUT, host + " network timeout. Please try again.");
                         reject({
                             statusCode: 408,
                             error: networkTimeoutError,
@@ -118,10 +112,7 @@ var HttpRequestHandler = (function () {
                 });
             }
             req.on('error', function (error) {
-                var networkRequestError = new error_1.FirebaseError({
-                    code: 'network-error',
-                    message: "A network request error has occurred: " + (error && error.message),
-                });
+                var networkRequestError = new error_1.FirebaseAppError(error_1.AppErrorCodes.NETWORK_ERROR, "A network request error has occurred: " + (error && error.message));
                 reject({
                     statusCode: 502,
                     error: networkRequestError,
@@ -166,11 +157,6 @@ var SignedApiRequestHandler = (function (_super) {
     SignedApiRequestHandler.prototype.sendRequest = function (host, port, path, httpMethod, data, headers, timeout) {
         var ancestorSendRequest = _super.prototype.sendRequest;
         return this.app_.INTERNAL.getToken().then(function (accessTokenObj) {
-            if (accessTokenObj == null) {
-                return Promise.reject('Unable to fetch Google OAuth2 access token. ' +
-                    'Make sure you initialized the SDK with a credential that can f' +
-                    'etch access tokens.');
-            }
             var headersCopy = deep_copy_1.deepCopy(headers);
             var authorizationHeaderKey = 'Authorization';
             headersCopy[authorizationHeaderKey] = 'Bearer ' + accessTokenObj.accessToken;
@@ -192,9 +178,6 @@ var ApiSettings = (function () {
         if (httpMethod === void 0) { httpMethod = 'POST'; }
         this.endpoint = endpoint;
         this.httpMethod = httpMethod;
-        if (!endpoint) {
-            throw new Error("INTERNAL ASSERT FAILED: Unspecified API settings endpoint: " + endpoint);
-        }
         this.setRequestValidator(null)
             .setResponseValidator(null);
     }

package/lib/utils/deep-copy.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v4.1.2
+/*! firebase-admin v4.2.1
     https://firebase.google.com/terms/ */
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });

package/lib/utils/error.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v4.1.2
+/*! firebase-admin v4.2.1
     https://firebase.google.com/terms/ */
 "use strict";
 var __extends = (this && this.__extends) || (function () {
@@ -57,6 +57,24 @@ var FirebaseError = (function (_super) {
     return FirebaseError;
 }(Error));
 exports.FirebaseError = FirebaseError;
+/**
+ * Firebase App error code structure. This extends FirebaseError.
+ *
+ * @param {string} code The error code.
+ * @param {string} message The error message.
+ * @constructor
+ */
+var FirebaseAppError = (function (_super) {
+    __extends(FirebaseAppError, _super);
+    function FirebaseAppError(code, message) {
+        return _super.call(this, {
+            code: 'app/' + code,
+            message: message,
+        }) || this;
+    }
+    return FirebaseAppError;
+}(FirebaseError));
+exports.FirebaseAppError = FirebaseAppError;
 /**
  * Firebase Auth error code structure. This extends FirebaseError.
  *
@@ -138,6 +156,26 @@ var FirebaseMessagingError = (function (_super) {
     return FirebaseMessagingError;
 }(FirebaseError));
 exports.FirebaseMessagingError = FirebaseMessagingError;
+/**
+ * App client error codes and their default messages.
+ */
+var AppErrorCodes = (function () {
+    function AppErrorCodes() {
+    }
+    return AppErrorCodes;
+}());
+AppErrorCodes.APP_DELETED = 'app-deleted';
+AppErrorCodes.DUPLICATE_APP = 'duplicate-app';
+AppErrorCodes.INTERNAL_ERROR = 'internal-error';
+AppErrorCodes.INVALID_APP_NAME = 'invalid-app-name';
+AppErrorCodes.INVALID_APP_OPTIONS = 'invalid-app-options';
+AppErrorCodes.INVALID_CREDENTIAL = 'invalid-credential';
+AppErrorCodes.NETWORK_ERROR = 'network-error';
+AppErrorCodes.NETWORK_TIMEOUT = 'network-timeout';
+AppErrorCodes.NO_APP = 'no-app';
+AppErrorCodes.UNABLE_TO_PARSE_RESPONSE = 'unable-to-parse-response';
+exports.AppErrorCodes = AppErrorCodes;
+;
 /**
  * Auth client error codes and their default messages.
  */
@@ -293,6 +331,11 @@ MessagingClientErrorCode.INVALID_APNS_CREDENTIALS = {
         'SSL certificate was not uploaded or has expired. Check the validity of your development ' +
         'and production certificates.',
 };
+MessagingClientErrorCode.TOO_MANY_TOPICS = {
+    code: 'too-many-topics',
+    message: 'The maximum number of topics the provided registration token can be subscribed to ' +
+        'has been exceeded.',
+};
 MessagingClientErrorCode.AUTHENTICATION_ERROR = {
     code: 'authentication-error',
     message: 'An error occurred when trying to authenticate to the FCM servers. Make sure the ' +
@@ -306,7 +349,7 @@ MessagingClientErrorCode.SERVER_UNAVAILABLE = {
 };
 MessagingClientErrorCode.INTERNAL_ERROR = {
     code: 'internal-error',
-    message: 'An internal error has occurred.',
+    message: 'An internal error has occurred. Please retry the request.',
 };
 MessagingClientErrorCode.UNKNOWN_ERROR = {
     code: 'unknown-error',
@@ -345,14 +388,20 @@ var AUTH_SERVER_TO_CLIENT_CODE = {
 };
 /** @const {ServerToClientCode} Messaging server to client enum error codes. */
 var MESSAGING_SERVER_TO_CLIENT_CODE = {
+    /* GENERIC ERRORS */
     // Generic invalid message parameter provided.
     InvalidParameters: 'INVALID_ARGUMENT',
+    // Mismatched sender ID.
+    MismatchSenderId: 'MISMATCHED_CREDENTIAL',
+    // FCM server unavailable.
+    Unavailable: 'SERVER_UNAVAILABLE',
+    // FCM server internal error.
+    InternalServerError: 'INTERNAL_ERROR',
+    /* SEND ERRORS */
     // Invalid registration token format.
     InvalidRegistration: 'INVALID_REGISTRATION_TOKEN',
     // Registration token is not registered.
     NotRegistered: 'REGISTRATION_TOKEN_NOT_REGISTERED',
-    // Mismatched sender ID.
-    MismatchSenderId: 'MISMATCHED_CREDENTIAL',
     // Registration token does not match restricted package name.
     InvalidPackageName: 'INVALID_PACKAGE_NAME',
     // Message payload size limit exceeded.
@@ -367,8 +416,13 @@ var MESSAGING_SERVER_TO_CLIENT_CODE = {
     TopicsMessageRateExceeded: 'TOPICS_MESSAGE_RATE_EXCEEDED',
     // Invalid APNs credentials.
     InvalidApnsCredential: 'INVALID_APNS_CREDENTIALS',
-    // FCM server unavailable.
-    Unavailable: 'SERVER_UNAVAILABLE',
-    // FCM server internal error.
-    InternalServerError: 'INTERNAL_ERROR',
+    /* TOPIC SUBSCRIPTION MANAGEMENT ERRORS */
+    NOT_FOUND: 'REGISTRATION_TOKEN_NOT_REGISTERED',
+    INVALID_ARGUMENT: 'INVALID_REGISTRATION_TOKEN',
+    TOO_MANY_TOPICS: 'TOO_MANY_TOPICS',
+    RESOURCE_EXHAUSTED: 'TOO_MANY_TOPICS',
+    PERMISSION_DENIED: 'AUTHENTICATION_ERROR',
+    DEADLINE_EXCEEDED: 'SERVER_UNAVAILABLE',
+    INTERNAL: 'INTERNAL_ERROR',
+    UNKNOWN: 'UNKNOWN_ERROR',
 };

package/lib/utils/index.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v4.1.2
+/*! firebase-admin v4.2.1
     https://firebase.google.com/terms/ */
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -7,8 +7,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
  *
  * For example, this can be used to map underscore_cased properties to camelCase.
  *
- * @param {obj} Object The object whose properties to rename.
- * @param {keyMap} Object The mapping from old to new property names.
+ * @param {Object} obj The object whose properties to rename.
+ * @param {Object} keyMap The mapping from old to new property names.
  */
 function renameProperties(obj, keyMap) {
     Object.keys(keyMap).forEach(function (oldKey) {
@@ -21,3 +21,22 @@ function renameProperties(obj, keyMap) {
     });
 }
 exports.renameProperties = renameProperties;
+/**
+ * Defines a new read-only property directly on an object and returns the object.
+ *
+ * @param {Object} obj The object on which to define the property.
+ * @param {string} prop The name of the property to be defined or modified.
+ * @param {any} value The value associated with the property.
+ *
+ * @return {Object} The object that was passed to the function.
+ */
+function addReadonlyGetter(obj, prop, value) {
+    Object.defineProperty(obj, prop, {
+        value: value,
+        // Make this property read-only.
+        writable: false,
+        // Include this property during enumeration of obj's properties.
+        enumerable: true,
+    });
+}
+exports.addReadonlyGetter = addReadonlyGetter;

package/lib/utils/validator.js

@@ -1,8 +1,28 @@
-/*! firebase-admin v4.1.2
+/*! firebase-admin v4.2.1
     https://firebase.google.com/terms/ */
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 var url = require("url");
+/**
+ * Validates that a value is an array.
+ *
+ * @param {any} value The value to validate.
+ * @return {boolean} Whether the value is an array or not.
+ */
+function isArray(value) {
+    return value instanceof Array;
+}
+exports.isArray = isArray;
+/**
+ * Validates that a value is a non-empty array.
+ *
+ * @param {any} value The value to validate.
+ * @return {boolean} Whether the value is a non-empty array or not.
+ */
+function isNonEmptyArray(value) {
+    return isArray(value) && value.length !== 0;
+}
+exports.isNonEmptyArray = isNonEmptyArray;
 /**
  * Validates that a value is a boolean.
  *
@@ -40,7 +60,7 @@ exports.isString = isString;
  * @return {boolean} Whether the value is a non-empty string or not.
  */
 function isNonEmptyString(value) {
-    return typeof value === 'string' && value !== '';
+    return isString(value) && value !== '';
 }
 exports.isNonEmptyString = isNonEmptyString;
 /**