This module contains common functionality used throughout the Notify App.

getCookieValue is used to return the value of a cookie in a given cookie string. If the cookie specified does not exists in the provided cookie string it will return a rejected promise.

Lets assume we have the following cookie string: name=luca; surname=tabone; age=23. We can use this function to retrieve the value of the surname cookie as follows:

const cookieString = 'name=luca; surname=tabone; age=23'
getCookieValue(cookieString, 'surname')
  .then(cookieValue => console.log(cookieValue)) // cookieValue === 'tabone'

As documented, if we try to retrieve the value of a non-existent cookie, it will return a rejected promise.

const cookieString = 'name=luca; surname=tabone; age=23'
getCookieValue(cookieString, 'non-existent-cookie')
  .catch((err) => console.log(err)) // err.message === 'cookie not found'

getTokenFromRequest retrieves the token value from an HTTP Request. Access Tokens in Notify, can be stored either as a cookie (for logged in users) or as an HTTP Header (mainly for bots). This function is used to retrieve the token from one of these places. If no token is found, it will return a rejected promise.

getUserByToken returns the user associated with a token. This function can be invoked either with the token object itself or the token value (in which case it will first retrieve the token object from the db). If the provided token is not considered to valid, this function will return a rejected promise.

validateToken checks whether the token object is valid. A token is considered to be valid if it meets the following criteria:

• Token is not expired (if max-age is provided).
• Token's origin is the same as the origin provided (if origin is provided).