@util.js/emails
Version:
JavaScript utility methods for emails
93 lines (91 loc) • 5.22 kB
JavaScript
;
/**
* JavaScript utility methods for emails
* @public
* @class
*/
var _sliceInstanceProperty = require("@babel/runtime-corejs3/core-js-stable/instance/slice");
var _Array$from = require("@babel/runtime-corejs3/core-js-stable/array/from");
var _Symbol = require("@babel/runtime-corejs3/core-js-stable/symbol");
var _getIteratorMethod = require("@babel/runtime-corejs3/core-js/get-iterator-method");
var _Array$isArray = require("@babel/runtime-corejs3/core-js-stable/array/is-array");
var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault");
var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/classCallCheck"));
var _createClass2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/createClass"));
function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof _Symbol !== "undefined" && _getIteratorMethod(o) || o["@@iterator"]; if (!it) { if (_Array$isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
function _unsupportedIterableToArray(o, minLen) { var _context; if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = _sliceInstanceProperty(_context = Object.prototype.toString.call(o)).call(_context, 8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return _Array$from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
var Emails = /*#__PURE__*/function () {
function Emails() {
(0, _classCallCheck2["default"])(this, Emails);
}
(0, _createClass2["default"])(Emails, [{
key: "isValidEmail",
value:
/**
* Returns whether the given string is a valid email.
*
* The regular expression used to validate strings comes from a [W3C article]{@link https://www.w3.org/TR/2012/WD-html-markup-20120320/input.email.html}.
*
* @param {string} string The string to test
* @return {boolean} true if the given string is a valid email or false otherwise
* @public
* @instance
* @function
*/
function isValidEmail(string) {
return /^[a-zA-Z0-9.!#$%&’*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*$/.test(string);
}
/**
* Wraps the given nameValueArrayOfHeaders inside an object that makes email-header lookup easy.
*
* When using the returned object, you no longer have to worry about the case (e.g., "In-Reply-To" or "In-reply-to") of email headers.
*
* [googleapis]{@link https://www.npmjs.com/package/googleapis}'s interface to Gmail returns email headers as an array of name-value objects. The following is a sample:
* <pre>
* [ { name: 'Delivered-To', value: 'c@creemama.com' },
* ...
* { name: 'Date', value: 'Tue, 10 Jul 2018 10:18:52 -0700' },
* ...
* { name: 'To', value: 'Chris Topher <c@creemama.com>' } ]
* </pre>
*
* @param {Array} nameValueArrayOfHeaders An array of name-value objects containing email headers
* @return {EmailHeaders} A new {@link EmailHeaders} instance
* @throws {TypeError} If nameValueArrayOfHeaders is not an array-like object containing name-value objects
* @public
* @instance
* @function
*/
}, {
key: "wrapHeaders",
value: function wrapHeaders(nameValueArrayOfHeaders) {
var headerMap = {};
var lowercaseHeaderMap = {};
var _iterator = _createForOfIteratorHelper(nameValueArrayOfHeaders),
_step;
try {
for (_iterator.s(); !(_step = _iterator.n()).done;) {
var header = _step.value;
headerMap[header.name] = header.value;
lowercaseHeaderMap[header.name.toLowerCase()] = header.value;
}
} catch (err) {
_iterator.e(err);
} finally {
_iterator.f();
}
var EmailHeaders = requireEmailHeaders();
return new EmailHeaders({
headerMap: headerMap,
lowercaseHeaderMap: lowercaseHeaderMap
});
}
}]);
return Emails;
}();
module.exports = Emails;
var dependencies = {};
function requireEmailHeaders() {
return dependencies.EmailHeaders || (dependencies.EmailHeaders = require("./EmailHeaders"));
}