7zip-native 0.0.12 → 0.0.15

package/README.md

@@ -90,6 +90,7 @@ Each entry includes:
 | --- | --- | --- |
 | `id` | `number` | Stable ID within this opened archive |
 | `path` | `string` | Entry path, using `/` separators |
+| `extractedPath` | `string` | Relative output path after platform-specific filename normalization; Windows-invalid characters are replaced |
 | `size` | `bigint` | Uncompressed size |
 | `compressedSize` | `bigint` | Compressed size |
 | `isDirectory` | `boolean` | Whether the entry is a directory |
@@ -293,7 +294,7 @@ Windows x86 (ia32) is not supported by the published prebuilt binaries.
 
 ## Electron
 
-The addon uses Node-API, but the addon and 7-Zip engine still need to match the Electron application's operating system and architecture. Use a matching package prebuild when available, or rebuild for the Electron version and target architecture using your Electron build tooling.
+The addon uses Node-API, but the addon and 7-Zip engine still need to match the Electron application's operating system and architecture. Use a matching package prebuild when available, or rebuild for the Electron version and target architecture using your Electron build tooling. The engine is loaded at runtime rather than linked into the addon, so ensure the matching engine library is included alongside the addon.
 
 When packaging with ASAR, ensure both `7zip_native.node` and the matching engine library (`7z.dll`, `7z.so`, or `lib7z.dylib`) are physically unpacked and that the runtime paths resolve to those unpacked files. For `electron-builder`, an `asarUnpack` configuration can include:
 

package/binding.gyp

@@ -15,20 +15,20 @@
 			"cflags_cc!": ["-fno-exceptions"],
 			"conditions": [
 				["OS=='linux'", {
+					"sources": [
+						"vendor/7zip/CPP/Common/MyWindows.cpp",
+						"vendor/7zip/CPP/Windows/PropVariant.cpp"
+					],
 					"cflags_cc": ["-pthread"],
 					"libraries": [
 						"-pthread",
-						"-ldl",
-						"-L<(module_root_dir)/vendor/7zip/CPP/7zip/Bundles/Format7zF/_o",
-						"-l:7z.so",
-						"-Wl,-rpath,'$$ORIGIN'"
+						"-ldl"
 					]
 				}],
 				["OS=='mac'", {
-					"libraries": [
-						"-L<(module_root_dir)/vendor/7zip/CPP/7zip/Bundles/Format7zF/_o",
-						"-l7z",
-						"-Wl,-rpath,@loader_path"
+					"sources": [
+						"vendor/7zip/CPP/Common/MyWindows.cpp",
+						"vendor/7zip/CPP/Windows/PropVariant.cpp"
 					],
 					"xcode_settings": {
 						"CLANG_CXX_LANGUAGE_STANDARD": "c++17",

package/dist/index.cjs

@@ -99,6 +99,11 @@ function sanitizeOutputPath(entryPath) {
     }
     return entryPath.replace(/\\/g, '/').split('/').map(sanitizeWindowsSegment).join('/');
 }
+function getExtractedPath(entryPath) {
+    const normalized = sanitizeOutputPath(entryPath).replace(/\\/g, '/');
+    const segments = normalized.split('/').filter(segment => segment !== '' && segment !== '.');
+    return segments.join(node_path.sep);
+}
 function assertSafeRelativeArchivePath(entryPath) {
     const normalized = entryPath.replace(/\\/g, '/');
     const segments = normalized.split('/').filter(segment => segment !== '' && segment !== '.');
@@ -481,7 +486,12 @@ class Archive {
     }
     async entries() {
         this.assertOpen();
-        this.entriesPromise ??= native.entries(this.handle).catch((cause) => {
+        this.entriesPromise ??= native.entries(this.handle)
+            .then(entries => entries.map(entry => ({
+            ...entry,
+            extractedPath: getExtractedPath(entry.path),
+        })))
+            .catch((cause) => {
             throw new ArchiveError('ERR_ARCHIVE_OPEN', errorMessage(cause), { cause });
         });
         return this.entriesPromise;

package/dist/index.d.cts

@@ -5,6 +5,7 @@ type EntrySelector = EntryId | string;
 interface ArchiveEntry {
     readonly id: EntryId;
     readonly path: string;
+    readonly extractedPath: string;
     readonly size: bigint;
     readonly compressedSize: bigint;
     readonly isDirectory: boolean;

package/dist/index.d.mts

@@ -5,6 +5,7 @@ type EntrySelector = EntryId | string;
 interface ArchiveEntry {
     readonly id: EntryId;
     readonly path: string;
+    readonly extractedPath: string;
     readonly size: bigint;
     readonly compressedSize: bigint;
     readonly isDirectory: boolean;

package/dist/index.d.ts

@@ -5,6 +5,7 @@ type EntrySelector = EntryId | string;
 interface ArchiveEntry {
     readonly id: EntryId;
     readonly path: string;
+    readonly extractedPath: string;
     readonly size: bigint;
     readonly compressedSize: bigint;
     readonly isDirectory: boolean;

package/dist/index.mjs

@@ -3,7 +3,7 @@ import { rename, link, rm, lstat, mkdir } from 'node:fs/promises';
 import { randomUUID } from 'node:crypto';
 import { createRequire } from 'node:module';
 import { availableParallelism } from 'node:os';
-import { dirname, resolve, join, extname, relative, sep } from 'node:path';
+import { dirname, resolve, join, extname, sep, relative } from 'node:path';
 import { Readable } from 'node:stream';
 import { pipeline } from 'node:stream/promises';
 
@@ -96,6 +96,11 @@ function sanitizeOutputPath(entryPath) {
     }
     return entryPath.replace(/\\/g, '/').split('/').map(sanitizeWindowsSegment).join('/');
 }
+function getExtractedPath(entryPath) {
+    const normalized = sanitizeOutputPath(entryPath).replace(/\\/g, '/');
+    const segments = normalized.split('/').filter(segment => segment !== '' && segment !== '.');
+    return segments.join(sep);
+}
 function assertSafeRelativeArchivePath(entryPath) {
     const normalized = entryPath.replace(/\\/g, '/');
     const segments = normalized.split('/').filter(segment => segment !== '' && segment !== '.');
@@ -478,7 +483,12 @@ class Archive {
     }
     async entries() {
         this.assertOpen();
-        this.entriesPromise ??= native.entries(this.handle).catch((cause) => {
+        this.entriesPromise ??= native.entries(this.handle)
+            .then(entries => entries.map(entry => ({
+            ...entry,
+            extractedPath: getExtractedPath(entry.path),
+        })))
+            .catch((cause) => {
             throw new ArchiveError('ERR_ARCHIVE_OPEN', errorMessage(cause), { cause });
         });
         return this.entriesPromise;

package/native/addon.cpp

@@ -2160,12 +2160,12 @@ public:
 			GUID classId;
 			std::string name;
 			bool extensionMatch;
-			bool hasSignatureFunction;
-			bool signatureMatch;
+			bool contentMatch;
+			unsigned probePriority;
 		};
 		std::vector<Format> formats;
 		formats.reserve(formatCount);
-		std::vector<Byte> header(64 * 1024);
+		std::vector<Byte> header(1 << 20);
 		auto *probeFile = new FileInStream();
 		CMyComPtr<IInStream> probe = probeFile;
 		if (!probeFile->Open(path)) {
@@ -2178,6 +2178,8 @@ public:
 		if (headerSize == 0) {
 			throw std::runtime_error("Archive file is empty");
 		}
+		const bool endOfFile = headerSize < header.size()
+			|| GetFileStamp(path).size <= headerSize;
 		for (UInt32 i = 0; i < formatCount; ++i) {
 			NWindows::NCOM::CPropVariant classIdValue;
 			if (g_getHandlerProperty(i, NArchive::NHandlerPropID::kClassID, &classIdValue) != S_OK
@@ -2207,38 +2209,95 @@ public:
 			}
 			Func_IsArc isArchive = nullptr;
 			const bool hasSignatureFunction = g_getIsArc(i, &isArchive) == S_OK && isArchive != nullptr;
-			const bool signatureMatch = hasSignatureFunction
-				&& isArchive(header.data(), header.size()) != 0;
-			formats.push_back({i, classId, std::move(name), match, hasSignatureFunction, signatureMatch});
-		}
-		const bool hasSignatureMatch = std::any_of(
-			formats.begin(), formats.end(), [](const Format& format) { return format.signatureMatch; });
-		const bool hasExtensionMatch = std::any_of(
-			formats.begin(), formats.end(), [](const Format& format) { return format.extensionMatch; });
-		if (hasSignatureMatch) {
-			formats.erase(
-				std::remove_if(formats.begin(), formats.end(), [](const Format& format) {
-					return !format.signatureMatch
-						&& !(format.extensionMatch && !format.hasSignatureFunction);
-				}),
-				formats.end());
-		} else if (hasExtensionMatch && std::any_of(
-			formats.begin(), formats.end(), [](const Format& format) {
-				return format.extensionMatch && !format.hasSignatureFunction;
-			})) {
-			formats.erase(
-				std::remove_if(formats.begin(), formats.end(), [](const Format& format) {
-					return !format.extensionMatch || format.hasSignatureFunction;
-				}),
-				formats.end());
-		} else if (hasExtensionMatch) {
-			formats.clear();
+			constexpr UInt32 kStartOpenFlags =
+				NArcInfoFlags::kStartOpen
+				| NArcInfoFlags::kPureStartOpen
+				| NArcInfoFlags::kBackwardOpen;
+			NWindows::NCOM::CPropVariant flagsValue;
+			const bool hasFlags = g_getHandlerProperty(
+				i, NArchive::NHandlerPropID::kFlags, &flagsValue) == S_OK
+				&& flagsValue.vt == VT_UI4;
+			const UInt32 flags = hasFlags ? flagsValue.ulVal : 0;
+			if (!match && (flags & NArcInfoFlags::kByExtOnlyOpen) != 0) {
+				continue;
+			}
+
+			bool contentMatch = false;
+			unsigned probePriority = match ? 0 : 2;
+			if (hasSignatureFunction) {
+				const auto result = isArchive(header.data(), headerSize);
+				contentMatch = result == k_IsArc_Res_YES
+					|| (result == k_IsArc_Res_NEED_MORE && !endOfFile);
+				if (!match && contentMatch) {
+					probePriority = 1;
+				} else if (!match && !contentMatch) {
+					continue;
+				}
+			} else {
+				NWindows::NCOM::CPropVariant signatureOffsetValue;
+				UInt32 signatureOffset = 0;
+				if (g_getHandlerProperty(
+					i, NArchive::NHandlerPropID::kSignatureOffset, &signatureOffsetValue) == S_OK
+					&& signatureOffsetValue.vt == VT_UI4) {
+					signatureOffset = signatureOffsetValue.ulVal;
+				}
+				std::vector<std::vector<Byte>> signatures;
+				NWindows::NCOM::CPropVariant signatureValue;
+				if (g_getHandlerProperty(i, NArchive::NHandlerPropID::kSignature, &signatureValue) == S_OK
+					&& signatureValue.vt == VT_BSTR
+					&& ::SysStringByteLen(signatureValue.bstrVal) != 0) {
+					const auto *data = reinterpret_cast<const Byte *>(signatureValue.bstrVal);
+					const auto size = ::SysStringByteLen(signatureValue.bstrVal);
+					signatures.emplace_back(data, data + size);
+				} else {
+					NWindows::NCOM::CPropVariant multiSignatureValue;
+					if (g_getHandlerProperty(
+						i, NArchive::NHandlerPropID::kMultiSignature, &multiSignatureValue) == S_OK
+						&& multiSignatureValue.vt == VT_BSTR) {
+						const auto *data = reinterpret_cast<const Byte *>(multiSignatureValue.bstrVal);
+						const auto size = ::SysStringByteLen(multiSignatureValue.bstrVal);
+						for (UINT offset = 0; offset < size;) {
+							const auto signatureSize = data[offset++];
+							if (signatureSize > size - offset) {
+								signatures.clear();
+								break;
+							}
+							signatures.emplace_back(data + offset, data + offset + signatureSize);
+							offset += signatureSize;
+						}
+					}
+				}
+
+				bool signatureMatch = false;
+				bool needCheck = !hasFlags || signatures.empty()
+					|| (flags & kStartOpenFlags) != 0 || signatureOffset != 0;
+				const auto signatureOffsetSize = static_cast<std::size_t>(signatureOffset);
+				for (const auto& signature : signatures) {
+					if (signatureOffsetSize > headerSize
+						|| signature.size() > headerSize - signatureOffsetSize) {
+						if (!endOfFile) {
+							needCheck = true;
+						}
+					} else if (std::memcmp(
+						header.data() + signatureOffsetSize, signature.data(), signature.size()) == 0) {
+						signatureMatch = true;
+						break;
+					}
+				}
+				contentMatch = signatureMatch;
+				if (!match && signatureMatch) {
+					probePriority = 1;
+				} else if (!match && !needCheck) {
+					continue;
+				}
+			}
+			formats.push_back({i, classId, std::move(name), match, contentMatch, probePriority});
 		}
 		if (formats.empty()) {
 			throw std::runtime_error("No registered 7-Zip handler recognizes this archive");
 		}
 		std::stable_sort(formats.begin(), formats.end(), [](const Format& left, const Format& right) {
-			return left.extensionMatch && !right.extensionMatch;
+			return left.probePriority < right.probePriority;
 		});
 
 		bool passwordRequested = false;
@@ -2269,6 +2328,11 @@ public:
 				candidate->Close();
 				continue;
 			}
+			if (!HasValidEntryPaths(candidate) && !format.contentMatch
+				&& LowerAscii(format.name) != "gzip") {
+				candidate->Close();
+				continue;
+			}
 			auto context = std::make_unique<ArchiveContext>();
 			context->archive = candidate;
 			context->stream = input;
@@ -2636,6 +2700,20 @@ public:
 	}
 
 private:
+	bool HasValidEntryPaths(IInArchive *archive) const
+	{
+		UInt32 count = 0;
+		if (archive->GetNumberOfItems(&count) != S_OK || count > kMaxEntries) {
+			return false;
+		}
+		for (UInt32 i = 0; i < count; ++i) {
+			if (GetPropString(archive, i, kpidPath).empty()) {
+				return false;
+			}
+		}
+		return true;
+	}
+
 	ContextLease AcquireContext()
 	{
 		std::unique_lock<std::mutex> lock(contextMutex_);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "7zip-native",
-	"version": "0.0.12",
+	"version": "0.0.15",
 	"description": "Native 7zip bindings for Node.js",
 	"main": "./dist/index.cjs",
 	"type": "module",
@@ -65,9 +65,20 @@
 	},
 	"keywords": [
 		"7zip",
+		"7-zip",
+		"archive",
 		"nodejs",
 		"bindings",
-		"native"
+		"native",
+		"node-api",
+		"napi",
+		"zip",
+		"rar",
+		"tar",
+		"wim",
+		"compression",
+		"decompression",
+		"extraction"
 	],
 	"devDependencies": {
 		"@eslint/js": "^10.0.1",