libmime 5.3.6 → 5.3.8

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [5.3.8](https://github.com/nodemailer/libmime/compare/v5.3.7...v5.3.8) (2026-04-08)
+
+
+### Bug Fixes
+
+* bump iconv-lite to 0.7.2 and refresh dev tooling ([176bde0](https://github.com/nodemailer/libmime/commit/176bde025f4d1ec1dc61266330ed1d2e11457c2c))
+* charset.decode returns string for Japanese encodings ([c2cff8b](https://github.com/nodemailer/libmime/commit/c2cff8b6833d7c0d50d19bb1a63e8db1685cc866))
+
+## [5.3.7](https://github.com/nodemailer/libmime/compare/v5.3.6...v5.3.7) (2025-06-26)
+
+
+### Bug Fixes
+
+* performance issue on large inputs to decodeFlowed() ([#25](https://github.com/nodemailer/libmime/issues/25)) ([c893811](https://github.com/nodemailer/libmime/commit/c8938111e212996f0809253eb195ef56778fc4dd))
+* replace .npmignore with files=[] in package.json ([#22](https://github.com/nodemailer/libmime/issues/22)) ([0ae2a1f](https://github.com/nodemailer/libmime/commit/0ae2a1fd830a73a1cdcee295bca94ebfe4a3c051))
+
 ## [5.3.6](https://github.com/nodemailer/libmime/compare/v5.3.5...v5.3.6) (2024-11-29)
 
 

package/README.md

@@ -200,7 +200,7 @@ Returns content type for a file extension. If no suitable content types are foun
 
 **Example**
 
-    libmime.detectExtension('logo.jpg') // returns 'image/jpeg'
+    libmime.detectMimeType('logo.jpg') // returns 'image/jpeg'
 
 ## License
 

package/lib/charset.js

@@ -27,7 +27,7 @@ const charset = (module.exports = {
      *
      * @param {Buffer} buf Binary data to be decoded
      * @param {String} [fromCharset='UTF-8'] Binary data is decoded into string using this charset
-     * @return {String} Decded string
+     * @return {String} Decoded string
      */
     decode(buf, fromCharset) {
         fromCharset = charset.normalizeCharset(fromCharset || 'UTF-8');
@@ -48,9 +48,9 @@ const charset = (module.exports = {
                         type: 'string'
                     });
                     if (typeof output === 'string') {
-                        output = Buffer.from(output);
+                        return output;
                     }
-                    return output;
+                    // fall through to iconv-lite if convert returned something unexpected
                 } catch (err) {
                     // ignore, defaults to iconv-lite on error
                 }
@@ -66,7 +66,7 @@ const charset = (module.exports = {
     /**
      * Convert a string from specific encoding to UTF-8 Buffer
      *
-     * @param {String|Buffer} str String to be encoded
+     * @param {String|Buffer} data String or Buffer to be encoded
      * @param {String} [fromCharset='UTF-8'] Source encoding for the string
      * @return {Buffer} UTF-8 encoded typed array
      */
@@ -91,7 +91,7 @@ const charset = (module.exports = {
      * eg. win-1257 will be converted to WINDOWS-1257
      *
      * @param {String} charset Charset name to convert
-     * @return {String} Canoninicalized charset name
+     * @return {String} Canonicalized charset name
      */
     normalizeCharset(charset) {
         charset = charset.toLowerCase().trim();

package/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
      */
@@ -54,28 +55,42 @@ class Libmime {
     decodeFlowed(str, delSp) {
         str = (str || '').toString();
 
-        return (
-            str
-                .split(/\r?\n/)
-                // remove soft linebreaks
-                // soft linebreaks are added after space symbols
-                .reduce((previousValue, currentValue) => {
-                    if (/ $/.test(previousValue) && !/(^|\n)-- $/.test(previousValue)) {
-                        if (delSp) {
-                            // delsp adds space to text to be able to fold it
-                            // these spaces can be removed once the text is unfolded
-                            return previousValue.slice(0, -1) + currentValue;
-                        } else {
-                            return previousValue + currentValue;
-                        }
-                    } else {
-                        return previousValue + '\n' + currentValue;
-                    }
-                })
-                // remove whitespace stuffing
-                // http://tools.ietf.org/html/rfc3676#section-4.4
-                .replace(/^ /gm, '')
-        );
+        let lines = str.split(/\r?\n/);
+
+        let result = [],
+            buffer = null;
+
+        // remove soft linebreaks
+        // soft linebreaks are added after space symbols
+        for (let i = 0; i < lines.length; i++) {
+            let line = lines[i];
+
+            let isSoftBreak = buffer !== null && / $/.test(buffer) && !/(^|\n)-- $/.test(buffer);
+
+            if (isSoftBreak) {
+                if (delSp) {
+                    // delsp adds space to text to be able to fold it
+                    // these spaces can be removed once the text is unfolded
+                    buffer = buffer.slice(0, -1) + line;
+                } else {
+                    buffer += line;
+                }
+            } else {
+                if (buffer !== null) {
+                    result.push(buffer);
+                }
+
+                buffer = line;
+            }
+        }
+
+        if (buffer) {
+            result.push(buffer);
+        }
+
+        // remove whitespace stuffing
+        // http://tools.ietf.org/html/rfc3676#section-4.4
+        return result.join('\n').replace(/^ /gm, '');
     }
 
     /**
@@ -181,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) {
@@ -243,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) {
@@ -286,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) {
@@ -333,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 || '')
@@ -583,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) {
@@ -749,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();
@@ -783,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/package.json

@@ -1,8 +1,12 @@
 {
     "name": "libmime",
     "description": "Encode and decode quoted printable and base64 strings",
-    "version": "5.3.6",
+    "version": "5.3.8",
     "main": "lib/libmime.js",
+    "files": [
+        "lib",
+        "CHANGELOG.md"
+    ],
     "homepage": "https://github.com/nodemailer/libmime",
     "repository": {
         "type": "git",
@@ -21,18 +25,18 @@
     },
     "dependencies": {
         "encoding-japanese": "2.2.0",
-        "iconv-lite": "0.6.3",
+        "iconv-lite": "0.7.2",
         "libbase64": "1.3.0",
         "libqp": "2.1.1"
     },
     "devDependencies": {
         "chai": "4.4.1",
         "eslint-config-nodemailer": "1.2.0",
-        "eslint-config-prettier": "9.1.0",
+        "eslint-config-prettier": "10.1.8",
         "grunt": "1.6.1",
         "grunt-cli": "1.5.0",
         "grunt-eslint": "24.3.0",
         "grunt-mocha-test": "0.13.3",
-        "mocha": "10.8.2"
+        "mocha": "11.7.5"
     }
 }

package/.eslintrc

@@ -1,7 +0,0 @@
-{
-    "rules": {
-        "indent": 0,
-        "no-prototype-builtins": 0
-    },
-    "extends": "nodemailer"
-}

package/.gitattributes

@@ -1 +0,0 @@
-*.js text eol=lf

package/.github/FUNDING.yml

@@ -1,4 +0,0 @@
-# These are supported funding model platforms
-
-github: [andris9] # enable once enrolled
-custom: ['https://www.paypal.me/nodemailer']

package/.github/workflows/release.yaml

@@ -1,37 +0,0 @@
-on:
-    push:
-        branches:
-            - master
-
-permissions:
-    contents: write
-    pull-requests: write
-    id-token: write
-
-name: release
-jobs:
-    release-please:
-        runs-on: ubuntu-latest
-        steps:
-            - uses: google-github-actions/release-please-action@v3
-              id: release
-              with:
-                  release-type: node
-                  package-name: ${{vars.NPM_MODULE_NAME}}
-                  pull-request-title-pattern: 'chore${scope}: release ${version} [skip-ci]'
-            # The logic below handles the npm publication:
-            - uses: actions/checkout@v4
-              # these if statements ensure that a publication only occurs when
-              # a new release is created:
-              if: ${{ steps.release.outputs.release_created }}
-            - uses: actions/setup-node@v4
-              with:
-                  node-version: 20
-                  registry-url: 'https://registry.npmjs.org'
-              if: ${{ steps.release.outputs.release_created }}
-            - run: npm ci
-              if: ${{ steps.release.outputs.release_created }}
-            - run: npm publish --provenance --access public
-              env:
-                  NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}
-              if: ${{ steps.release.outputs.release_created }}

package/.github/workflows/test.yml

@@ -1,21 +0,0 @@
-name: Run tests
-
-on:
-    push:
-    pull_request:
-
-jobs:
-    test:
-        strategy:
-            matrix:
-                node: [16.x, 18.x, 20.x, 21.x]
-                os: [ubuntu-latest]
-        runs-on: ${{ matrix.os }}
-        steps:
-            - uses: actions/checkout@v2
-            - name: Use Node.js ${{ matrix.node }}
-              uses: actions/setup-node@v4
-              with:
-                  node-version: ${{ matrix.node }}
-            - run: npm install
-            - run: npm test

package/.ncurc.js

@@ -1,9 +0,0 @@
-module.exports = {
-    upgrade: true,
-    reject: [
-        // 5x is esm only
-        'chai',
-        // api changes in newer eslint
-        'grunt-eslint'
-    ]
-};

package/.prettierrc.js

@@ -1,8 +0,0 @@
-module.exports = {
-    printWidth: 160,
-    tabWidth: 4,
-    singleQuote: true,
-    endOfLine: 'lf',
-    trailingComma: 'none',
-    arrowParens: 'avoid'
-};