libmime 5.3.7 → 5.3.8

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 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)
 
 

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
      */
@@ -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/package.json

@@ -1,7 +1,7 @@
 {
     "name": "libmime",
     "description": "Encode and decode quoted printable and base64 strings",
-    "version": "5.3.7",
+    "version": "5.3.8",
     "main": "lib/libmime.js",
     "files": [
         "lib",
@@ -25,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": "10.1.5",
+        "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": "11.7.1"
+        "mocha": "11.7.5"
     }
 }