node-liblzma 2.0.3 → 2.2.0

package/lib/pool.js.map

@@ -1 +1 @@
-{"version":3,"file":"pool.js","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"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"}

package/lib/types.d.ts

@@ -17,11 +17,78 @@ export interface LZMAOptions {
     /** Flush flag to use */
     flushFlag?: number;
 }
+/**
+ * Callback function for asynchronous compression/decompression operations.
+ * @param error - Error object if operation failed, null otherwise
+ * @param result - Compressed or decompressed data buffer
+ */
 export type CompressionCallback = (error: Error | null, result?: Buffer) => void;
+/**
+ * LZMA action type for stream operations.
+ * - `0` (RUN): Normal processing
+ * - `1` (SYNC_FLUSH): Flush pending output
+ * - `2` (FULL_FLUSH): Flush and reset encoder state
+ * - `3` (FINISH): Finish the stream
+ */
 export type LZMAActionType = 0 | 1 | 2 | 3;
+/**
+ * LZMA status codes returned by operations.
+ * - `0` (OK): Operation completed successfully
+ * - `1` (STREAM_END): End of stream reached
+ * - `2` (NO_CHECK): Input has no integrity check
+ * - `3` (UNSUPPORTED_CHECK): Cannot calculate integrity check
+ * - `4` (GET_CHECK): Integrity check available
+ * - `5` (MEM_ERROR): Memory allocation failed
+ * - `6` (MEMLIMIT_ERROR): Memory limit reached
+ * - `7` (FORMAT_ERROR): File format not recognized
+ * - `8` (OPTIONS_ERROR): Invalid options
+ * - `9` (DATA_ERROR): Data is corrupt
+ * - `10` (BUF_ERROR): No progress possible
+ * - `11` (PROG_ERROR): Programming error
+ */
 export type LZMAStatusType = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11;
+/**
+ * Integrity check type for XZ streams.
+ * - `0` (NONE): No integrity check
+ * - `1` (CRC32): 32-bit CRC
+ * - `4` (CRC64): 64-bit CRC (recommended)
+ * - `10` (SHA256): SHA-256 hash
+ */
 export type CheckType = 0 | 1 | 4 | 10;
-export type PresetType = 6 | 9;
+/**
+ * Compression preset level (0-9), optionally combined with EXTREME flag.
+ * Higher values = better compression but slower.
+ * @example
+ * ```ts
+ * const preset = 6; // Default compression
+ * const extreme = 6 | 0x80000000; // Default with extreme flag
+ * ```
+ */
+export type PresetType = number;
+/**
+ * Filter type for LZMA2 compression chain.
+ * - `0x21` (LZMA2): Main compression filter
+ * - `0x03` (X86): BCJ filter for x86 executables
+ * - `0x04` (POWERPC): BCJ filter for PowerPC
+ * - `0x06` (IA64): BCJ filter for IA-64
+ * - `0x07` (ARM): BCJ filter for ARM
+ * - `0x08` (ARMTHUMB): BCJ filter for ARM-Thumb
+ * - `0x09` (SPARC): BCJ filter for SPARC
+ */
 export type FilterType = 0x21 | 0x03 | 0x04 | 0x06 | 0x07 | 0x08 | 0x09;
+/**
+ * Compression mode.
+ * - `1` (FAST): Faster compression, less memory
+ * - `2` (NORMAL): Better compression ratio
+ */
 export type ModeType = 1 | 2;
+/**
+ * Progress event data emitted during compression/decompression
+ */
+export interface ProgressInfo {
+    /** Total bytes read from input so far */
+    bytesRead: number;
+    /** Total bytes written to output so far */
+    bytesWritten: number;
+}
 //# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAGjF,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC3C,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;AAC7E,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;AACvC,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,CAAC;AAC/B,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AACxE,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAEjF;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAE3C;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;AAE7E;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;AAEvC;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAEhC;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAExE;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/package.json

@@ -1,13 +1,17 @@
 {
   "name": "node-liblzma",
-  "version": "2.0.3",
+  "version": "2.2.0",
   "description": "NodeJS wrapper for liblzma",
   "type": "module",
   "main": "./lib/lzma.js",
+  "bin": {
+    "nxz": "./lib/cli/nxz.js"
+  },
   "exports": {
     ".": {
       "import": "./lib/lzma.js",
-      "types": "./index.d.ts"
+      "types": "./index.d.ts",
+      "default": "./lib/lzma.js"
     }
   },
   "scripts": {
@@ -21,6 +25,7 @@
     "test:watch": "vitest",
     "test:coverage": "vitest run --config vitest.config.monocart.ts --coverage",
     "test:coverage-v8": "vitest run --coverage",
+    "test:ui": "vitest --ui",
     "type-check": "tsc --noEmit",
     "clean": "rm -rf lib",
     "lint": "biome lint",
@@ -32,28 +37,43 @@
     "release": "release-it-preset default",
     "release:manual": "release-it-preset --config .release-it.manual.json",
     "release:hotfix": "release-it-preset hotfix",
-    "changelog:update": "release-it-preset changelog-only"
+    "changelog:update": "release-it-preset changelog-only",
+    "typedoc": "typedoc",
+    "typedoc:watch": "typedoc --watch"
   },
   "dependencies": {
     "node-addon-api": "^8.5.0",
     "node-gyp-build": "^4.8.4"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.2.3",
+    "@biomejs/biome": "^2.3.12",
     "@oorabona/release-it-preset": "^0.9.0",
     "@oorabona/vitest-monocart-coverage": "^2.0.1",
-    "@types/node": "^24.3.1",
-    "@vitest/coverage-istanbul": "^3.2.4",
-    "@vitest/coverage-v8": "^3.2.4",
-    "@vitest/ui": "3.2.4",
-    "nano-staged": "^0.8.0",
-    "release-it": "^19.0.5",
+    "@types/node": "^25.0.10",
+    "@vitest/coverage-istanbul": "^4.0.18",
+    "@vitest/coverage-v8": "^4.0.18",
+    "@vitest/ui": "4.0.18",
+    "nano-staged": "^0.9.0",
+    "release-it": "^19.2.4",
     "simple-git-hooks": "^2.13.1",
     "tsd": "^0.33.0",
-    "typescript": "^5.9.2",
-    "vitest": "^3.2.4"
+    "typedoc": "^0.28.16",
+    "typedoc-material-theme": "^1.4.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
   },
   "types": "index.d.ts",
+  "files": [
+    "lib/",
+    "src/bindings/",
+    "scripts/build_xz_with_cmake.py",
+    "scripts/download_xz_from_github.py",
+    "scripts/copy_dll.py",
+    "scripts/walk_sources.py",
+    "binding.gyp",
+    "index.d.ts",
+    "xz-version.json"
+  ],
   "engines": {
     "node": ">=16.0.0"
   },

package/scripts/build_xz_with_cmake.py

@@ -282,16 +282,20 @@ def main():
     parser = argparse.ArgumentParser(
         description='Build XZ Utils using CMake',
         epilog='''
-Required environment variables (strict validation):
-  RUNTIME_LINK: 'static' or 'shared' (REQUIRED)
-  ENABLE_THREAD_SUPPORT: 'yes' or 'no' (REQUIRED)
-  USE_GLOBAL: 'true' or 'false' (REQUIRED)
+Optional environment variables (with sensible defaults matching binding.gyp):
+  RUNTIME_LINK: 'static' or 'shared'
+    Default: 'static' on Windows, 'shared' on Linux/macOS
+  ENABLE_THREAD_SUPPORT: 'yes' or 'no'
+    Default: 'yes'
+  USE_GLOBAL: 'true' or 'false'
+    Default: 'false' on Windows, 'true' on Linux/macOS
 
 Examples:
-  RUNTIME_LINK=static ENABLE_THREAD_SUPPORT=yes USE_GLOBAL=false \\
-    python3 build_xz_with_cmake.py deps/xz build/liblzma
-  
-  RUNTIME_LINK=shared ENABLE_THREAD_SUPPORT=no USE_GLOBAL=true \\
+  # Use defaults (recommended)
+  python3 build_xz_with_cmake.py deps/xz build/liblzma
+
+  # Override specific values
+  RUNTIME_LINK=static USE_GLOBAL=false \\
     python3 build_xz_with_cmake.py deps/xz build/liblzma
         ''',
         formatter_class=argparse.RawDescriptionHelpFormatter
@@ -304,24 +308,17 @@ Examples:
     
     args = parser.parse_args()
     
-    # Get configuration from environment variables with strict validation
-    runtime_link = os.environ.get('RUNTIME_LINK')
-    enable_threads = os.environ.get('ENABLE_THREAD_SUPPORT')
-    use_global = os.environ.get('USE_GLOBAL')
-    
-    # Strict validation - fail if critical variables are not explicitly set
-    if runtime_link is None:
-        print("[ERROR] RUNTIME_LINK environment variable must be explicitly set ('static' or 'shared')")
-        return 1
-    
-    if enable_threads is None:
-        print("[ERROR] ENABLE_THREAD_SUPPORT environment variable must be explicitly set ('yes' or 'no')")
-        return 1
-        
-    if use_global is None:
-        print("[ERROR] USE_GLOBAL environment variable must be explicitly set ('true' or 'false')")
-        return 1
-    
+    # Get configuration from environment variables with sensible defaults
+    # Defaults match binding.gyp for consistency
+    is_windows = sys.platform == 'win32'
+
+    # Default: 'shared' on Linux/macOS, 'static' on Windows
+    runtime_link = os.environ.get('RUNTIME_LINK') or ('static' if is_windows else 'shared')
+    # Default: 'yes' (threading enabled)
+    enable_threads = os.environ.get('ENABLE_THREAD_SUPPORT') or 'yes'
+    # Default: 'false' on Windows, 'true' on Linux/macOS (use system library)
+    use_global = os.environ.get('USE_GLOBAL') or ('false' if is_windows else 'true')
+
     # Validate values
     if runtime_link not in ['static', 'shared']:
         print(f"[ERROR] Invalid RUNTIME_LINK: {runtime_link}. Must be 'static' or 'shared'")

package/src/bindings/module.cpp

@@ -17,6 +17,193 @@
 **/
 
 #include "node-liblzma.hpp"
+#include <cstring>
+
+// XZ magic bytes: 0xFD + "7zXZ" + 0x00
+static const uint8_t XZ_MAGIC[6] = {0xFD, 0x37, 0x7A, 0x58, 0x5A, 0x00};
+
+/**
+ * Check if a buffer starts with the XZ magic bytes.
+ * @param info[0] Buffer to check
+ * @returns true if the buffer is an XZ stream, false otherwise
+ */
+Napi::Value IsXZ(const Napi::CallbackInfo &info)
+{
+	Napi::Env env = info.Env();
+
+	if (info.Length() < 1 || !info[0].IsBuffer())
+	{
+		Napi::TypeError::New(env, "Expected a Buffer argument").ThrowAsJavaScriptException();
+		return env.Null();
+	}
+
+	Napi::Buffer<uint8_t> buf = info[0].As<Napi::Buffer<uint8_t>>();
+
+	// Need at least 6 bytes for XZ magic
+	if (buf.Length() < 6)
+	{
+		return Napi::Boolean::New(env, false);
+	}
+
+	bool isXz = std::memcmp(buf.Data(), XZ_MAGIC, 6) == 0;
+	return Napi::Boolean::New(env, isXz);
+}
+
+/**
+ * Get liblzma version string (runtime).
+ * @returns Version string like "5.4.1"
+ */
+Napi::Value VersionString(const Napi::CallbackInfo &info)
+{
+	Napi::Env env = info.Env();
+	return Napi::String::New(env, lzma_version_string());
+}
+
+/**
+ * Get liblzma version number (runtime).
+ * @returns Version as integer (e.g., 50040010 for 5.4.1)
+ */
+Napi::Value VersionNumber(const Napi::CallbackInfo &info)
+{
+	Napi::Env env = info.Env();
+	return Napi::Number::New(env, static_cast<double>(lzma_version_number()));
+}
+
+/**
+ * Get memory usage for easy encoder with given preset.
+ * @param info[0] Preset level (0-9, optionally OR'd with LZMA_PRESET_EXTREME)
+ * @returns Memory usage in bytes, or 0 if preset is invalid
+ */
+Napi::Value EasyEncoderMemusage(const Napi::CallbackInfo &info)
+{
+	Napi::Env env = info.Env();
+
+	if (info.Length() < 1 || !info[0].IsNumber())
+	{
+		Napi::TypeError::New(env, "Expected a preset number argument").ThrowAsJavaScriptException();
+		return env.Null();
+	}
+
+	uint32_t preset = info[0].As<Napi::Number>().Uint32Value();
+	uint64_t memusage = lzma_easy_encoder_memusage(preset);
+
+	return Napi::Number::New(env, static_cast<double>(memusage));
+}
+
+/**
+ * Get memory usage for easy decoder.
+ * @returns Memory usage in bytes
+ */
+Napi::Value EasyDecoderMemusage(const Napi::CallbackInfo &info)
+{
+	Napi::Env env = info.Env();
+
+	// lzma_easy_decoder_memusage takes a preset for memlimit estimation
+	// but the actual decoder doesn't need a preset. Use default preset.
+	uint64_t memusage = lzma_easy_decoder_memusage(LZMA_PRESET_DEFAULT);
+
+	return Napi::Number::New(env, static_cast<double>(memusage));
+}
+
+/**
+ * Parse the Stream Footer and Index from an XZ file to get metadata.
+ * @param info[0] Buffer containing the XZ file (must be complete)
+ * @returns Object with uncompressed_size, compressed_size, stream_count, block_count, check
+ */
+Napi::Value ParseFileIndex(const Napi::CallbackInfo &info)
+{
+	Napi::Env env = info.Env();
+
+	if (info.Length() < 1 || !info[0].IsBuffer())
+	{
+		Napi::TypeError::New(env, "Expected a Buffer argument").ThrowAsJavaScriptException();
+		return env.Null();
+	}
+
+	Napi::Buffer<uint8_t> buf = info[0].As<Napi::Buffer<uint8_t>>();
+	const uint8_t *data = buf.Data();
+	size_t size = buf.Length();
+
+	// Minimum XZ file: header (12) + block (varies) + index (varies) + footer (12)
+	// Stream header is 12 bytes, footer is 12 bytes
+	if (size < LZMA_STREAM_HEADER_SIZE * 2)
+	{
+		Napi::Error::New(env, "Buffer too small for XZ stream").ThrowAsJavaScriptException();
+		return env.Null();
+	}
+
+	// Verify XZ magic
+	if (std::memcmp(data, XZ_MAGIC, 6) != 0)
+	{
+		Napi::Error::New(env, "Not an XZ stream (invalid magic)").ThrowAsJavaScriptException();
+		return env.Null();
+	}
+
+	// Parse stream header
+	lzma_stream_flags header_flags;
+	lzma_ret ret = lzma_stream_header_decode(&header_flags, data);
+	if (ret != LZMA_OK)
+	{
+		Napi::Error::New(env, "Failed to decode stream header").ThrowAsJavaScriptException();
+		return env.Null();
+	}
+
+	// Parse stream footer (last 12 bytes)
+	lzma_stream_flags footer_flags;
+	ret = lzma_stream_footer_decode(&footer_flags, data + size - LZMA_STREAM_HEADER_SIZE);
+	if (ret != LZMA_OK)
+	{
+		Napi::Error::New(env, "Failed to decode stream footer").ThrowAsJavaScriptException();
+		return env.Null();
+	}
+
+	// Verify header and footer match
+	ret = lzma_stream_flags_compare(&header_flags, &footer_flags);
+	if (ret != LZMA_OK)
+	{
+		Napi::Error::New(env, "Stream header and footer do not match").ThrowAsJavaScriptException();
+		return env.Null();
+	}
+
+	// Calculate index position: footer starts at (size - 12), index is backward_size bytes before that
+	size_t footer_pos = size - LZMA_STREAM_HEADER_SIZE;
+	size_t index_size = footer_flags.backward_size;
+
+	if (index_size > footer_pos - LZMA_STREAM_HEADER_SIZE)
+	{
+		Napi::Error::New(env, "Invalid index size in footer").ThrowAsJavaScriptException();
+		return env.Null();
+	}
+
+	size_t index_pos = footer_pos - index_size;
+
+	// Decode the index
+	lzma_index *index = nullptr;
+	uint64_t memlimit = UINT64_MAX;
+	size_t in_pos = 0;
+
+	ret = lzma_index_buffer_decode(&index, &memlimit, nullptr,
+								   data + index_pos, &in_pos, index_size);
+	if (ret != LZMA_OK || index == nullptr)
+	{
+		Napi::Error::New(env, "Failed to decode index").ThrowAsJavaScriptException();
+		return env.Null();
+	}
+
+	// Extract metadata from index
+	Napi::Object result = Napi::Object::New(env);
+	result.Set("uncompressedSize", Napi::Number::New(env, static_cast<double>(lzma_index_uncompressed_size(index))));
+	result.Set("compressedSize", Napi::Number::New(env, static_cast<double>(lzma_index_total_size(index))));
+	result.Set("streamCount", Napi::Number::New(env, static_cast<double>(lzma_index_stream_count(index))));
+	result.Set("blockCount", Napi::Number::New(env, static_cast<double>(lzma_index_block_count(index))));
+	result.Set("check", Napi::Number::New(env, static_cast<double>(footer_flags.check)));
+	result.Set("memoryUsage", Napi::Number::New(env, static_cast<double>(lzma_index_memused(index))));
+
+	// Clean up
+	lzma_index_end(index, nullptr);
+
+	return result;
+}
 
 Napi::Object Init(Napi::Env env, Napi::Object exports)
 {
@@ -101,6 +288,15 @@ Napi::Object Init(Napi::Env env, Napi::Object exports)
 
 	// Tell companion script if we are thread-able or not
 	exports.Set(Napi::String::New(env, "HAS_THREADS_SUPPORT"), Napi::Boolean::New(env, HAS_THREADS_SUPPORT));
+
+	// Utility functions
+	exports.Set(Napi::String::New(env, "isXZ"), Napi::Function::New(env, IsXZ));
+	exports.Set(Napi::String::New(env, "versionString"), Napi::Function::New(env, VersionString));
+	exports.Set(Napi::String::New(env, "versionNumber"), Napi::Function::New(env, VersionNumber));
+	exports.Set(Napi::String::New(env, "easyEncoderMemusage"), Napi::Function::New(env, EasyEncoderMemusage));
+	exports.Set(Napi::String::New(env, "easyDecoderMemusage"), Napi::Function::New(env, EasyDecoderMemusage));
+	exports.Set(Napi::String::New(env, "parseFileIndex"), Napi::Function::New(env, ParseFileIndex));
+
 	return exports;
 }
 

package/src/bindings/node-liblzma.cpp

@@ -29,6 +29,12 @@ Napi::Value LZMA::Close(const Napi::CallbackInfo &info)
 
 Napi::Value LZMA::Close(const Napi::Env &env)
 {
+	// F-006: Idempotency guard - prevent double-subtract of external memory
+	if (_closed)
+	{
+		return env.Undefined();
+	}
+	_closed = true;
 	Napi::MemoryManagement::AdjustExternalMemory(env, -int64_t(sizeof(LZMA)));
 
 	if (_wip)
@@ -63,7 +69,7 @@ void LZMA::Init(Napi::Env env, Napi::Object exports)
 }
 
 LZMA::LZMA(const Napi::CallbackInfo &info) : Napi::ObjectWrap<LZMA>(info), _stream(LZMA_STREAM_INIT),
-											 _wip(false), _pending_close(false), _worker(nullptr)
+											 _wip(false), _pending_close(false), _closed(false), _worker(nullptr)
 {
 	Napi::Env env = info.Env();
 
@@ -103,7 +109,7 @@ LZMA::LZMA(const Napi::CallbackInfo &info) : Napi::ObjectWrap<LZMA>(info), _stre
 	switch (mode)
 	{
 	case STREAM_DECODE:
-		success = InitializeDecoder();
+		success = InitializeDecoder(env);
 		break;
 	case STREAM_ENCODE:
 		success = InitializeEncoder(opts, preset, check);
@@ -163,6 +169,13 @@ LZMA::~LZMA()
 template <bool async>
 Napi::Value LZMA::Code(const Napi::CallbackInfo &info)
 {
+	// F-001: Guard against concurrent calls - liblzma is not thread-safe per stream
+	if (this->_wip)
+	{
+		Napi::Error::New(info.Env(), "Stream is busy - concurrent operations not allowed").ThrowAsJavaScriptException();
+		return info.Env().Undefined();
+	}
+
 	// Setup with manual guard (safer than RAII for JS exceptions)
 	this->_wip = true;
 	this->Ref();
@@ -285,6 +298,14 @@ bool LZMA::ValidateAndPrepareBuffers(const Napi::CallbackInfo &info, BufferConte
 	}
 
 	ctx.out_off = info[5].ToNumber().Uint32Value();
+
+	// F-002: Validate output offset bounds to prevent underflow in out_len calculation
+	if (ctx.out_off > out_max)
+	{
+		Napi::RangeError::New(env, "Output offset exceeds buffer length").ThrowAsJavaScriptException();
+		return false;
+	}
+
 	ctx.out_len = out_max - ctx.out_off;
 	ctx.out = out_buf + ctx.out_off;
 
@@ -461,10 +482,18 @@ bool LZMA::InitializeEncoder(const Napi::Object &opts, uint32_t preset, lzma_che
 	return true;
 }
 
-bool LZMA::InitializeDecoder()
+bool LZMA::InitializeDecoder(const Napi::Env &env)
 {
 	lzma_ret ret = lzma_stream_decoder(&this->_stream, UINT64_MAX, LZMA_CONCATENATED);
-	return ret == LZMA_OK;
+
+	// F-005: Throw exception on decoder init failure (consistent with InitializeEncoder)
+	if (ret != LZMA_OK)
+	{
+		Napi::Error::New(env, "LZMA decoder failure, returned " + std::to_string(ret)).ThrowAsJavaScriptException();
+		return false;
+	}
+
+	return true;
 }
 
 void LZMA::AfterCommon(const Napi::Env &env)
@@ -515,8 +544,15 @@ void LZMA::After(const Napi::Env &env, const Napi::Function &cb)
 	Napi::Number avail_in = Napi::Number::New(env, this->_stream.avail_in);
 	Napi::Number avail_out = Napi::Number::New(env, this->_stream.avail_out);
 
+	// F-001: Clear _wip BEFORE callback so callback can call code() again for iterative processing
+	// Note: Buffer refs are released after callback in case callback needs to access them
+	this->_wip = false;
+
 	// Call the provided JS callback with the three numeric results
+	// The callback may call code() again for iterative processing (this is the normal pattern)
 	cb.Call({ret, avail_in, avail_out});
 
+	// F-004: Ensure cleanup runs even if callback threw an exception
+	// With NAPI_DISABLE_CPP_EXCEPTIONS, exceptions are pending rather than thrown
 	AfterCommon(env);
 }

package/src/bindings/node-liblzma.hpp

@@ -81,7 +81,7 @@ private:
 	bool ValidateConstructorArgs(const Napi::CallbackInfo &info, uint32_t &mode, Napi::Object &opts);
 	bool InitializeFilters(const Napi::Object &opts, uint32_t preset);
 	bool InitializeEncoder(const Napi::Object &opts, uint32_t preset, lzma_check check);
-	bool InitializeDecoder();
+	bool InitializeDecoder(const Napi::Env &env);
 
 	// Common cleanup operations for both sync and async completion
 	void AfterCommon(const Napi::Env &env);
@@ -95,6 +95,7 @@ private:
 	lzma_stream _stream;
 	bool _wip;
 	bool _pending_close;
+	bool _closed;  // F-006: Prevent double-subtract in AdjustExternalMemory
 
 	LZMAWorker *_worker;
 

package/xz-version.json

@@ -1,7 +1,7 @@
 {
-  "version": "v5.8.1",
-  "comment": "Latest version with full XZ_THREADS support and modern CMake. XZ 5.8+ includes the complete threading API with XZ_THREADS variable.",
-  "last_checked": "2025-09-02",
+  "version": "v5.8.2",
+  "comment": "Stable version tested and validated for production. Auto-updated by GitHub Actions.",
+  "last_checked": "2026-01-25",
   "allow_override": true,
   "repository": "tukaani-project/xz",
   "changelog": "https://github.com/tukaani-project/xz/releases/tag/v5.8.1"

package/.gitattributes

@@ -1,3 +0,0 @@
-* text=auto eol=lf
-*.{cmd,[cC][mM][dD]} text eol=crlf
-*.{bat,[bB][aA][tT]} text eol=crlf

package/.release-it.json

@@ -1,7 +0,0 @@
-{
-  "extends": "@oorabona/release-it-preset/config/default",
-  "git": {
-    "requireBranch": "master",
-    "requireCleanWorkingDir": true
-  }
-}

package/.release-it.manual.json

@@ -1,7 +0,0 @@
-{
-  "extends": "@oorabona/release-it-preset/config/manual-changelog",
-  "git": {
-    "requireBranch": "master",
-    "requireCleanWorkingDir": true
-  }
-}

package/.release-it.retry.json

@@ -1,3 +0,0 @@
-{
-  "extends": "@oorabona/release-it-preset/config/retry-publish"
-}