@mavogel/awscdk-rootmail 0.0.332 → 0.0.334

package/node_modules/libmime/lib/libmime.js

@@ -37,6 +37,7 @@ class Libmime {
      * no need to encode the values in any way. If the value is plaintext but has
      * longer lines then allowed, then use format=flowed
      *
+     * @param {String} str String to be tested
      * @param {Number} lineLength Max line length to check for
      * @returns {Boolean} Returns true if there is at least one line longer than lineLength chars
      */
@@ -195,9 +196,12 @@ class Libmime {
     }
 
     /**
-     * Decode a complete mime word encoded string
+     * Decodes the inner payload of a single mime encoded-word into a unicode string.
+     * Expects the three components of `=?charset?encoding?text?=` already separated.
      *
-     * @param {String} str Mime word encoded string
+     * @param {String} charset Charset name from the encoded-word (may include an RFC 2231 language tag, which is ignored)
+     * @param {String} encoding Encoding indicator, either 'Q' or 'B' (case insensitive)
+     * @param {String} str Encoded payload between the second `?` and the trailing `?=`
      * @return {String} Decoded unicode string
      */
     decodeWord(charset, encoding, str) {
@@ -257,7 +261,7 @@ class Libmime {
      * @param {String|Buffer} data String to be encoded
      * @param {String} mimeWordEncoding='Q' Encoding for the mime word, either Q or B
      * @param {Number} [maxLength=0] If set, split mime words into several chunks if needed
-     * @param {String} [fromCharset='UTF-8'] Source sharacter set
+     * @param {String} [fromCharset='UTF-8'] Source character set
      * @return {String} String with possible mime words
      */
     encodeWords(data, mimeWordEncoding, maxLength, fromCharset) {
@@ -300,7 +304,7 @@ class Libmime {
     /**
      * Decode a string that might include one or several mime words
      *
-     * @param {String} str String including some mime words that will be encoded
+     * @param {String} str String including some mime words that will be decoded
      * @return {String} Decoded unicode string
      */
     decodeWords(str) {
@@ -347,7 +351,7 @@ class Libmime {
      * on the rules for the specific header key
      *
      * @param {String} headerLine Single header line, might include linebreaks as well if folded
-     * @return {Object} And object of {key, value}
+     * @return {Object} An object of {key, value}
      */
     decodeHeader(headerLine) {
         let line = (headerLine || '')
@@ -597,9 +601,10 @@ class Libmime {
      *     title*0*=utf-8''unicode
      *     title*1*=%20string
      *
+     * @param {String} key Parameter name (eg. 'filename')
      * @param {String|Buffer} data String to be encoded
      * @param {Number} [maxLength=50] Max length for generated chunks
-     * @param {String} [fromCharset='UTF-8'] Source sharacter set
+     * @param {String} [fromCharset='UTF-8'] Source character set
      * @return {Array} A list of encoded keys and headers
      */
     buildHeaderParam(key, data, maxLength, fromCharset) {
@@ -763,8 +768,8 @@ class Libmime {
      * Returns content type for a file extension. If no suitable content types
      * are found, 'application/octet-stream' is used as the default content type
      *
-     * @param {String} extension Extension to be checked for
-     * @return {String} File extension
+     * @param {String} extension Extension (or filename) to be checked for
+     * @return {String} Content type
      */
     detectMimeType(extension) {
         extension = (extension || '').toString().toLowerCase().replace(/\s/g, '').replace(/^\./g, '').split('.').pop();
@@ -797,7 +802,7 @@ class Libmime {
      *
      * @param {String} str String to be folded
      * @param {Number} [lineLength=76] Maximum length of a line
-     * @param {Boolean} afterSpace If true, leave a space in th end of a line
+     * @param {Boolean} afterSpace If true, leave a space in the end of a line
      * @return {String} String with folded lines
      */
     foldLines(str, lineLength, afterSpace) {

package/node_modules/libmime/node_modules/iconv-lite/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2011 Alexander Shtuchkin
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+

package/node_modules/libmime/node_modules/iconv-lite/README.md

@@ -0,0 +1,138 @@
+## iconv-lite: Pure JS character encoding conversion
+
+[![NPM Version][npm-version-image]][npm-url]
+[![NPM Downloads][npm-downloads-image]][npm-downloads-url]
+[![License][license-image]][license-url]
+[![NPM Install Size][npm-install-size-image]][npm-install-size-url]
+
+* No need for native code compilation. Quick to install, works on Windows, Web, and in sandboxed environments.
+* Used in popular projects like [Express.js (body_parser)](https://github.com/expressjs/body-parser), 
+  [Grunt](http://gruntjs.com/), [Nodemailer](http://www.nodemailer.com/), [Yeoman](http://yeoman.io/) and others.
+* Faster than [node-iconv](https://github.com/bnoordhuis/node-iconv) (see below for performance comparison).
+* Intuitive encode/decode API, including Streaming support.
+* In-browser usage via [browserify](https://github.com/substack/node-browserify) or [webpack](https://webpack.js.org/) (~180kb gzip compressed with Buffer shim included).
+* Typescript [type definition file](https://github.com/ashtuchkin/iconv-lite/blob/master/lib/index.d.ts) included.
+* React Native is supported (need to install `stream` module to enable Streaming API).
+
+## Usage
+
+### Basic API
+
+```javascript
+var iconv = require('iconv-lite');
+
+// Convert from an encoded buffer to a js string.
+str = iconv.decode(Buffer.from([0x68, 0x65, 0x6c, 0x6c, 0x6f]), 'win1251');
+
+// Convert from a js string to an encoded buffer.
+buf = iconv.encode("Sample input string", 'win1251');
+
+// Check if encoding is supported
+iconv.encodingExists("us-ascii")
+```
+
+### Streaming API
+
+```javascript
+// Decode stream (from binary data stream to js strings)
+http.createServer(function(req, res) {
+    var converterStream = iconv.decodeStream('win1251');
+    req.pipe(converterStream);
+
+    converterStream.on('data', function(str) {
+        console.log(str); // Do something with decoded strings, chunk-by-chunk.
+    });
+});
+
+// Convert encoding streaming example
+fs.createReadStream('file-in-win1251.txt')
+    .pipe(iconv.decodeStream('win1251'))
+    .pipe(iconv.encodeStream('ucs2'))
+    .pipe(fs.createWriteStream('file-in-ucs2.txt'));
+
+// Sugar: all encode/decode streams have .collect(cb) method to accumulate data.
+http.createServer(function(req, res) {
+    req.pipe(iconv.decodeStream('win1251')).collect(function(err, body) {
+        assert(typeof body == 'string');
+        console.log(body); // full request body string
+    });
+});
+```
+
+## Supported encodings
+
+ *  All node.js native encodings: utf8, ucs2 / utf16-le, ascii, binary, base64, hex.
+ *  Additional unicode encodings: utf16, utf16-be, utf-7, utf-7-imap, utf32, utf32-le, and utf32-be.
+ *  All widespread singlebyte encodings: Windows 125x family, ISO-8859 family, 
+    IBM/DOS codepages, Macintosh family, KOI8 family, all others supported by iconv library. 
+    Aliases like 'latin1', 'us-ascii' also supported.
+ *  All widespread multibyte encodings: CP932, CP936, CP949, CP950, GB2312, GBK, GB18030, Big5, Shift_JIS, EUC-JP.
+
+See [all supported encodings on wiki](https://github.com/ashtuchkin/iconv-lite/wiki/Supported-Encodings).
+
+Most singlebyte encodings are generated automatically from [node-iconv](https://github.com/bnoordhuis/node-iconv). Thank you Ben Noordhuis and libiconv authors!
+
+Multibyte encodings are generated from [Unicode.org mappings](http://www.unicode.org/Public/MAPPINGS/) and [WHATWG Encoding Standard mappings](http://encoding.spec.whatwg.org/). Thank you, respective authors!
+
+## Encoding/decoding speed
+
+Comparison with node-iconv module (1000x256kb, on MacBook Pro, Core i5/2.6 GHz, Node v0.12.0). 
+Note: your results may vary, so please always check on your hardware.
+
+    operation             iconv@2.1.4   iconv-lite@0.4.7
+    ----------------------------------------------------------
+    encode('win1251')     ~96 Mb/s      ~320 Mb/s
+    decode('win1251')     ~95 Mb/s      ~246 Mb/s
+
+## BOM handling
+
+ * Decoding: BOM is stripped by default, unless overridden by passing `stripBOM: false` in options
+   (f.ex. `iconv.decode(buf, enc, {stripBOM: false})`).
+   A callback might also be given as a `stripBOM` parameter - it'll be called if BOM character was actually found.
+ * If you want to detect UTF-8 BOM when decoding other encodings, use [node-autodetect-decoder-stream](https://github.com/danielgindi/node-autodetect-decoder-stream) module.
+ * Encoding: No BOM added, unless overridden by `addBOM: true` option.
+
+## UTF-16 Encodings
+
+This library supports UTF-16LE, UTF-16BE and UTF-16 encodings. First two are straightforward, but UTF-16 is trying to be
+smart about endianness in the following ways:
+ * Decoding: uses BOM and 'spaces heuristic' to determine input endianness. Default is UTF-16LE, but can be 
+   overridden with `defaultEncoding: 'utf-16be'` option. Strips BOM unless `stripBOM: false`.
+ * Encoding: uses UTF-16LE and writes BOM by default. Use `addBOM: false` to override.
+
+## UTF-32 Encodings
+
+This library supports UTF-32LE, UTF-32BE and UTF-32 encodings. Like the UTF-16 encoding above, UTF-32 defaults to UTF-32LE, but uses BOM and 'spaces heuristics' to determine input endianness. 
+ * The default of UTF-32LE can be overridden with the `defaultEncoding: 'utf-32be'` option. Strips BOM unless `stripBOM: false`.
+ * Encoding: uses UTF-32LE and writes BOM by default. Use `addBOM: false` to override. (`defaultEncoding: 'utf-32be'` can also be used here to change encoding.)
+
+## Other notes
+
+When decoding, be sure to supply a Buffer to decode() method, otherwise [bad things usually happen](https://github.com/ashtuchkin/iconv-lite/wiki/Use-Buffers-when-decoding).  
+Untranslatable characters are set to � or ?. No transliteration is currently supported.  
+Node versions 0.10.31 and 0.11.13 are buggy, don't use them (see [#65](https://github.com/ashtuchkin/iconv-lite/issues/65), [#77](https://github.com/ashtuchkin/iconv-lite/issues/77)).  
+
+## Testing
+
+```sh
+git clone git@github.com:ashtuchkin/iconv-lite.git
+cd iconv-lite
+npm install
+npm test
+    
+# To view performance:
+npm run test:performance
+
+# To view test coverage: 
+npm run test:cov
+open coverage/index.html
+```
+
+[npm-downloads-image]: https://badgen.net/npm/dm/iconv-lite
+[npm-downloads-url]: https://npmcharts.com/compare/iconv-lite?minimal=true
+[npm-url]: https://npmjs.org/package/iconv-lite
+[npm-version-image]: https://badgen.net/npm/v/iconv-lite
+[npm-install-size-image]: https://badgen.net/packagephobia/install/iconv-lite
+[npm-install-size-url]: https://packagephobia.com/result?p=iconv-lite
+[license-image]: https://img.shields.io/npm/l/iconv-lite.svg
+[license-url]: https://github.com/ashtuchkin/iconv-lite/blob/HEAD/LICENSE