lite-email-parser 2.0.4 → 2.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Philipe Dutra Cunha and Henrique Teixeira Silva
+
+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/dist/index.cjs

@@ -39,10 +39,35 @@ exports.removeSignature = removeSignature;
 exports.removeReplies = removeReplies;
 exports.removeDividers = removeDividers;
 exports.replaceSrc = replaceSrc;
-const path = __importStar(require("path"));
-// Load native addon - CJS uses __dirname
-const packageRoot = path.resolve(__dirname, '..');
-const addon = require(path.join(packageRoot, 'build', 'Release', 'parser.node'));
+const os = __importStar(require("os"));
+// Map of platform-arch to the corresponding scoped package name
+const PLATFORM_PACKAGES = {
+    'linux-x64': '@lite-email-parser-native/linux-x64',
+    'linux-arm64': '@lite-email-parser-native/linux-arm64',
+    'darwin-x64': '@lite-email-parser-native/darwin-x64',
+    'darwin-arm64': '@lite-email-parser-native/darwin-arm64',
+    'win32-x64': '@lite-email-parser-native/win32-x64',
+};
+function loadAddon() {
+    const platform = os.platform();
+    const arch = os.arch();
+    const key = `${platform}-${arch}`;
+    const packageName = PLATFORM_PACKAGES[key];
+    if (!packageName) {
+        throw new Error(`lite-email-parser: unsupported platform ${platform}-${arch}. ` +
+            `Supported: ${Object.keys(PLATFORM_PACKAGES).join(', ')}`);
+    }
+    try {
+        return require(packageName);
+    }
+    catch (e) {
+        throw new Error(`lite-email-parser: failed to load native binary for ${platform}-${arch}. ` +
+            `Make sure "${packageName}" is installed. ` +
+            `If you're using npm, ensure optionalDependencies are not disabled.\n` +
+            `Original error: ${e.message}`);
+    }
+}
+const addon = loadAddon();
 async function parseEmail(buffer) {
     return addon.parseEmail(buffer);
 }

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.cts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAMrD,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAE1E;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,CAE/D;AAGD,YAAY,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.cts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAsCrD,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAE1E;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,CAE/D;AAGD,YAAY,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA+CrD,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAE1E;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,CAE/D;AAGD,YAAY,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAwCrD,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAE1E;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,CAE/D;AAGD,YAAY,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,42 +1,34 @@
 import { createRequire } from 'module';
-import * as path from 'path';
-const _require = typeof require !== 'undefined'
-    ? require
-    : createRequire(process.cwd());
-const getDirname = () => {
-    if (typeof __dirname !== 'undefined') {
-        return __dirname;
+import * as os from 'os';
+const _require = createRequire(import.meta.url);
+// Map of platform-arch to the corresponding scoped package name
+const PLATFORM_PACKAGES = {
+    'linux-x64': '@lite-email-parser-native/linux-x64',
+    'linux-arm64': '@lite-email-parser-native/linux-arm64',
+    'darwin-x64': '@lite-email-parser-native/darwin-x64',
+    'darwin-arm64': '@lite-email-parser-native/darwin-arm64',
+    'win32-x64': '@lite-email-parser-native/win32-x64',
+};
+function loadAddon() {
+    const platform = os.platform();
+    const arch = os.arch();
+    const key = `${platform}-${arch}`;
+    const packageName = PLATFORM_PACKAGES[key];
+    if (!packageName) {
+        throw new Error(`lite-email-parser: unsupported platform ${platform}-${arch}. ` +
+            `Supported: ${Object.keys(PLATFORM_PACKAGES).join(', ')}`);
     }
-    const err = new Error();
-    const stackLines = err.stack?.split('\n') || [];
-    for (const line of stackLines) {
-        const match = line.match(/(?:at\s+|\()((?:file:\/\/)?\/[^:]+)/);
-        if (match) {
-            const p = match[1];
-            if (p.includes('index.js') || p.includes('index.ts')) {
-                let cleanPath = p;
-                if (cleanPath.startsWith('file://')) {
-                    const fileURLToPath = _require('url').fileURLToPath;
-                    cleanPath = fileURLToPath(cleanPath);
-                }
-                return path.dirname(cleanPath);
-            }
-        }
+    try {
+        return _require(packageName);
+    }
+    catch (e) {
+        throw new Error(`lite-email-parser: failed to load native binary for ${platform}-${arch}. ` +
+            `Make sure "${packageName}" is installed. ` +
+            `If you're using npm, ensure optionalDependencies are not disabled.\n` +
+            `Original error: ${e.message}`);
     }
-    return process.cwd();
-};
-const dirname = getDirname();
-let addonPath = path.resolve(dirname, '../build/Release/parser.node');
-if (!_require('fs').existsSync(addonPath)) {
-    addonPath = path.resolve(dirname, '../../build/Release/parser.node');
-}
-if (!_require('fs').existsSync(addonPath)) {
-    addonPath = path.resolve(dirname, '../parser.node');
-}
-if (!_require('fs').existsSync(addonPath)) {
-    addonPath = path.resolve(dirname, '../../parser.node');
 }
-const addon = _require(addonPath);
+const addon = loadAddon();
 export async function parseEmail(buffer) {
     return addon.parseEmail(buffer);
 }

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "lite-email-parser",
-  "version": "2.0.4",
+  "version": "2.2.0",
   "description": "Parse email to get signature, replies, attachments and inline images",
-  "main": "./dist/cjs/index.js",
+  "license": "MIT",
+  "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -12,38 +13,18 @@
         "default": "./dist/index.js"
       },
       "require": {
-        "types": "./dist/cjs/index.d.ts",
-        "default": "./dist/cjs/index.js"
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
       }
     }
   },
   "files": [
-    "dist/",
-    "binding.gyp",
-    "src/addon.cpp",
-    "core/include/",
-    "core/src/*.cpp",
-    "deps/gumbo-parser/src/*.c",
-    "deps/gumbo-parser/src/*.h"
+    "dist/"
   ],
-  "binary": {
-    "module_name": "parser",
-    "module_path": "./build/Release/",
-    "host": "https://github.com/philipedc/lite-email-parser/releases/download/",
-    "remote_path": "{version}",
-    "package_name": "{module_name}-v{version}-napi-v9-{platform}-{arch}.tar.gz",
-    "napi_versions": [
-      9
-    ]
-  },
   "scripts": {
-    "install": "prebuild-install || node-gyp rebuild",
     "build:native": "node-gyp rebuild",
-    "build:ts": "npx tsc && npx tsc --module commonjs --outDir dist/cjs --declaration && echo '{\"type\":\"commonjs\"}' > dist/cjs/package.json",
+    "build:ts": "npx tsc",
     "build": "npm run build:native && npm run build:ts",
-    "prebuild": "node-gyp rebuild && tar -czf parser-v2.0.0-napi-v9-linux-x64.tar.gz -C build/Release parser.node",
-    "prepublishOnly": "npm run build:ts && cp -r ../core ./core && mkdir -p ./deps && cp -r ../deps/gumbo-parser ./deps/gumbo-parser",
-    "postpublish": "rm -rf ./core ./deps",
     "test": "npx -y tsx samples/sample.ts"
   },
   "contributors": [
@@ -81,12 +62,17 @@
     "email-to-html",
     "signature-remover"
   ],
-  "dependencies": {
-    "node-addon-api": "^8.0.0",
-    "prebuild-install": "^7.1.2"
+  "dependencies": {},
+  "optionalDependencies": {
+    "@lite-email-parser-native/linux-x64": "2.2.0",
+    "@lite-email-parser-native/linux-arm64": "2.2.0",
+    "@lite-email-parser-native/darwin-x64": "2.2.0",
+    "@lite-email-parser-native/darwin-arm64": "2.2.0",
+    "@lite-email-parser-native/win32-x64": "2.2.0"
   },
   "devDependencies": {
     "@types/node": "^20.11.0",
+    "node-addon-api": "^8.0.0",
     "node-gyp": "^13.0.0",
     "typescript": "^7.0.2"
   }

package/binding.gyp

@@ -1,47 +0,0 @@
-{
-  "variables": {
-    "src_root%": "<!(node -e \"var fs=require('fs');console.log(fs.existsSync('core')?'./':'../')\")"
-  },
-  "targets": [
-    {
-      "target_name": "parser",
-      "sources": [
-        "src/addon.cpp",
-        "<(src_root)core/src/html_parser.cpp",
-        "<(src_root)core/src/html_extractor.cpp",
-        "<(src_root)deps/gumbo-parser/src/attribute.c",
-        "<(src_root)deps/gumbo-parser/src/char_ref.c",
-        "<(src_root)deps/gumbo-parser/src/char_ref_gperf.c",
-        "<(src_root)deps/gumbo-parser/src/error.c",
-        "<(src_root)deps/gumbo-parser/src/parser.c",
-        "<(src_root)deps/gumbo-parser/src/string_buffer.c",
-        "<(src_root)deps/gumbo-parser/src/string_piece.c",
-        "<(src_root)deps/gumbo-parser/src/tag.c",
-        "<(src_root)deps/gumbo-parser/src/tokenizer.c",
-        "<(src_root)deps/gumbo-parser/src/utf8.c",
-        "<(src_root)deps/gumbo-parser/src/util.c",
-        "<(src_root)deps/gumbo-parser/src/vector.c"
-      ],
-      "include_dirs": [
-        "<!@(node -p \"require('node-addon-api').include\")",
-        "<(src_root)core/include",
-        "<(src_root)deps/gumbo-parser/src"
-      ],
-      "dependencies": [
-        "<!(node -p \"require('node-addon-api').targets\"):node_addon_api"
-      ],
-      "libraries": [],
-      "defines": [ "NAPI_DISABLE_CPP_EXCEPTIONS" ],
-      "cflags!": [ "-fno-exceptions" ],
-      "cflags_cc!": [ "-fno-exceptions" ],
-      "xcode_settings": {
-        "GCC_ENABLE_CPP_EXCEPTIONS": "YES",
-        "CLANG_CXX_LIBRARY": "libc++",
-        "MACOSX_DEPLOYMENT_TARGET": "10.7"
-      },
-      "msvs_settings": {
-        "VCCLCompilerTool": { "ExceptionHandling": 1 }
-      }
-    }
-  ]
-}

package/core/include/html_extractor.h

@@ -1,100 +0,0 @@
-#ifndef HTML_EXTRACTOR_H
-#define HTML_EXTRACTOR_H
-
-#include <string>
-#include <vector>
-
-namespace liteEmailParser {
-
-// Represents a file attachment (mirrors IFile from types.ts)
-struct Attachment {
-    std::string name;          // filename (defaults to current date if absent)
-    std::string type;          // MIME content type (e.g. "image/png")
-    std::size_t size = 0;      // size in bytes
-    std::string buffer;        // raw binary content
-    std::string src;           // uploaded URL (populated by replaceSrc after upload)
-    std::string originalSrc;   // base64 data URI for inline attachments (e.g. "data:image/png;base64,...")
-};
-
-// Full result of parsing an email
-struct ParseEmailResult {
-    std::string subject;
-    std::string from;
-    std::string to;
-    std::string text;                          // cleaned HTML (or plain text fallback)
-    std::vector<Attachment> attachments;        // regular attachments
-    std::vector<Attachment> inlineAttachments;  // inline (cid-referenced) attachments
-};
-
-// Result of HTML extraction from a raw email buffer
-struct ExtractionResult {
-    std::string body;   // HTML content (or plain text fallback)
-    bool isHtml;        // true if body came from a text/html part
-};
-
-// Main entry point: parses a raw .eml buffer into a full result.
-ParseEmailResult parseEmail(const std::string& rawEmail);
-
-// Main entry point: extracts the HTML (or text) body from a raw .eml buffer.
-// Parses MIME boundaries, finds the text/html part (falls back to text/plain),
-// and decodes Content-Transfer-Encoding (quoted-printable or base64).
-ExtractionResult extractHtmlBody(const std::string& rawEmail);
-
-// Reads an .eml file from disk into a string buffer
-std::string readEmailFile(const std::string& filePath);
-
-// Replaces img src attributes in HTML: for each file with originalSrc and src set,
-// finds matching img elements and swaps the src to the new URL.
-std::string replaceSrc(const std::string& html, const std::vector<Attachment>& files);
-
-namespace detail {
-
-// Represents a single MIME part extracted from the email
-struct MimePart {
-    std::string contentType;       // e.g. "text/html; charset=\"UTF-8\""
-    std::string transferEncoding;  // e.g. "quoted-printable", "base64"
-    std::string contentId;         // e.g. "ii_mrnoxu771" (without angle brackets)
-    std::string contentDisposition; // e.g. "attachment", "inline"
-    std::string filename;          // from Content-Disposition or Content-Type name=
-    std::string body;              // raw body content of this part
-};
-
-// Parse the top-level Content-Type header to extract the boundary string
-std::string extractBoundary(const std::string& contentTypeHeader);
-
-// Split a raw email (or a multipart section) into its MIME parts by boundary.
-// Recurses into nested multipart parts.
-std::vector<MimePart> parseMimeParts(const std::string& rawContent,
-                                     const std::string& boundary);
-
-// Extract a header value from raw headers block (case-insensitive key match)
-std::string getHeaderValue(const std::string& headers, const std::string& key);
-
-// Decode quoted-printable encoded content
-std::string decodeQuotedPrintable(const std::string& input);
-
-// Decode base64 encoded content
-std::string decodeBase64(const std::string& input);
-
-// Encode binary data to base64
-std::string encodeBase64(const std::string& input);
-
-// Extract the MIME type (e.g. "image/png") from a Content-Type header value
-std::string extractMimeType(const std::string& contentTypeHeader);
-
-// Extract Content-ID value, stripping angle brackets
-std::string extractContentId(const std::string& contentIdHeader);
-
-// Extract filename from Content-Disposition or Content-Type name= parameter
-std::string extractFilename(const std::string& contentDisposition,
-                            const std::string& contentType);
-
-// Replace cid: references in HTML with base64 data URIs using the provided parts
-std::string replaceCidWithBase64(const std::string& html,
-                                 const std::vector<MimePart>& parts);
-
-}  // namespace detail
-
-}  // namespace liteEmailParser
-
-#endif  // HTML_EXTRACTOR_H

package/core/include/html_parser.h

@@ -1,13 +0,0 @@
-#ifndef HTML_PARSER_H
-#define HTML_PARSER_H
-
-#include <string>
-
-namespace liteEmailParser {
-    std::string removeSignature(std::string html);
-    std::string removeReplies(std::string html);
-    std::string removeDividers(std::string html);
-    std::string cleanHtml(std::string html);
-}
-
-#endif // HTML_PARSER_H