UNPKG

@util.js/emails

Version:

JavaScript utility methods for emails

93 lines (91 loc) 5.22 kB
"use strict"; /** * 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")); }