7z-iterator 2.2.1 → 2.2.3

package/README.md

@@ -140,3 +140,31 @@ iterator.forEach(
   }
 );
 ```
+
+## Limitations
+
+### Node.js Version Compatibility
+
+This library supports Node.js 0.8+ but has memory limits on older versions:
+
+| Node.js Version | Maximum Single Buffer | Notes |
+|-----------------|----------------------|-------|
+| 0.8 - 4.x | ~1073 MB (0x3fffffff) | Hard limit due to kMaxLength |
+| 6.x - 7.x | ~1073 MB | Uint8Array limit |
+| 8.x - 9.x | ~2 GB | Buffer limit |
+| 10+ | ~2.1 GB (2^31-1) | Buffer.allocUnsafe limit |
+
+### LZMA1 vs LZMA2
+
+- **LZMA2**: Streams incrementally, memory efficient, works on all Node versions
+- **LZMA1**: Requires loading entire folder into memory before decompression. Fails on archives with folders larger than the buffer limit above.
+
+### Archive Size Limits by Node Version
+
+| Archive Type | Node 0.8-4.x | Node 6+ | Node 8+ | Node 10+ |
+|--------------|--------------|---------|---------|----------|
+| Small archives (< 1GB) | Works | Works | Works | Works |
+| LZMA2 archives (> 1GB) | Fails | Fails | Works | Works |
+| LZMA1 archives (> 1GB) | Fails | Fails | Fails | Fails |
+
+For large LZMA1 archives, use Node 8+ or re-archive using LZMA2 format.

package/dist/cjs/sevenz/ArchiveSource.d.cts

@@ -4,12 +4,13 @@
  * Provides a common interface for reading archive data from either
  * a file descriptor or an in-memory buffer.
  */
+import { type BufferLike } from 'extract-base-iterator';
 import type Stream from 'stream';
 /**
  * Archive source abstraction - allows reading from file descriptor or buffer
  */
 export interface ArchiveSource {
-    read(position: number, length: number): Buffer;
+    read(position: number, length: number): BufferLike;
     getSize(): number;
     close(): void;
     /**
@@ -26,7 +27,7 @@ export interface ArchiveSource {
 export declare class BufferSource implements ArchiveSource {
     private buffer;
     constructor(buffer: Buffer);
-    read(position: number, length: number): Buffer;
+    read(position: number, length: number): BufferLike;
     getSize(): number;
     close(): void;
     /**
@@ -45,7 +46,7 @@ export declare class FileSource implements ArchiveSource {
     private fd;
     private size;
     constructor(fd: number, size: number);
-    read(position: number, length: number): Buffer;
+    read(position: number, length: number): BufferLike;
     private readChunk;
     getSize(): number;
     close(): void;

package/dist/cjs/sevenz/ArchiveSource.d.ts

@@ -4,12 +4,13 @@
  * Provides a common interface for reading archive data from either
  * a file descriptor or an in-memory buffer.
  */
+import { type BufferLike } from 'extract-base-iterator';
 import type Stream from 'stream';
 /**
  * Archive source abstraction - allows reading from file descriptor or buffer
  */
 export interface ArchiveSource {
-    read(position: number, length: number): Buffer;
+    read(position: number, length: number): BufferLike;
     getSize(): number;
     close(): void;
     /**
@@ -26,7 +27,7 @@ export interface ArchiveSource {
 export declare class BufferSource implements ArchiveSource {
     private buffer;
     constructor(buffer: Buffer);
-    read(position: number, length: number): Buffer;
+    read(position: number, length: number): BufferLike;
     getSize(): number;
     close(): void;
     /**
@@ -45,7 +46,7 @@ export declare class FileSource implements ArchiveSource {
     private fd;
     private size;
     constructor(fd: number, size: number);
-    read(position: number, length: number): Buffer;
+    read(position: number, length: number): BufferLike;
     private readChunk;
     getSize(): number;
     close(): void;

package/dist/cjs/sevenz/ArchiveSource.js

@@ -87,27 +87,29 @@ var FileSource = /*#__PURE__*/ function() {
     }
     var _proto = FileSource.prototype;
     _proto.read = function read(position, length) {
-        // Handle large reads by chunking to fit 32-bit signed int limit
-        var MAX_INT32 = 0x7fffffff; // 2,147,483,647 bytes (~2GB)
-        if (length <= MAX_INT32) {
+        // For small reads that fit in a single buffer, return directly
+        // This is efficient on all Node versions
+        if ((0, _extractbaseiterator.canAllocateBufferSize)(length)) {
             return this.readChunk(position, length);
         }
-        // For large reads, split into multiple chunks
-        var chunks = [];
+        // For large reads, return a BufferList to avoid large contiguous allocation
+        // This enables LZMA1 decompression on old Node versions
+        var result = new _extractbaseiterator.BufferList();
         var totalBytesRead = 0;
         var currentPos = position;
         while(totalBytesRead < length){
             var remaining = length - totalBytesRead;
-            var chunkSize = Math.min(remaining, MAX_INT32);
+            // Use safe chunk size that works on all Node versions
+            var chunkSize = Math.min(remaining, (0, _extractbaseiterator.canAllocateBufferSize)(remaining) ? remaining : 256 * 1024 * 1024);
             var chunk = this.readChunk(currentPos, chunkSize);
-            chunks.push(chunk);
+            result.append(chunk);
             totalBytesRead += chunk.length;
             currentPos += chunk.length;
             if (chunk.length < chunkSize) {
                 break;
             }
         }
-        return Buffer.concat(chunks);
+        return result;
     };
     _proto.readChunk = function readChunk(position, length) {
         var buf = (0, _extractbaseiterator.allocBuffer)(length);

package/dist/cjs/sevenz/ArchiveSource.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/iterators/7z-iterator/src/sevenz/ArchiveSource.ts"],"sourcesContent":["/**\n * ArchiveSource - Abstraction for reading 7z archive data\n *\n * Provides a common interface for reading archive data from either\n * a file descriptor or an in-memory buffer.\n */\n\nimport { allocBuffer, Readable } from 'extract-base-iterator';\nimport fs from 'fs';\nimport type Stream from 'stream';\n\n// Helper to create a Readable stream compatible with Node 0.8\nfunction createReadableStream(readFn: (stream: Stream.Readable) => void): Stream.Readable {\n  const stream = new Readable();\n  stream._read = function () {\n    readFn(this);\n  };\n  return stream;\n}\n\n/**\n * Archive source abstraction - allows reading from file descriptor or buffer\n */\nexport interface ArchiveSource {\n  read(position: number, length: number): Buffer;\n  getSize(): number;\n  close(): void;\n  /**\n   * Create a readable stream for a portion of the archive.\n   * Used for streaming decompression.\n   */\n  createReadStream(offset: number, length: number): Stream.Readable;\n}\n\n/**\n * Buffer-based archive source\n *\n * Used when the entire archive is already in memory.\n */\nexport class BufferSource implements ArchiveSource {\n  private buffer: Buffer;\n\n  constructor(buffer: Buffer) {\n    this.buffer = buffer;\n  }\n\n  read(position: number, length: number): Buffer {\n    return this.buffer.slice(position, position + length);\n  }\n\n  getSize(): number {\n    return this.buffer.length;\n  }\n\n  close(): void {\n    // Nothing to close for buffer\n  }\n\n  /**\n   * Create a readable stream for a portion of the buffer.\n   * Streams the data in chunks to avoid blocking.\n   */\n  createReadStream(offset: number, length: number): Stream.Readable {\n    const buffer = this.buffer;\n    const end = Math.min(offset + length, buffer.length);\n    let currentPos = offset;\n    const chunkSize = 65536; // 64KB chunks\n\n    return createReadableStream((stream) => {\n      if (currentPos >= end) {\n        stream.push(null);\n        return;\n      }\n\n      const toRead = Math.min(chunkSize, end - currentPos);\n      const chunk = buffer.slice(currentPos, currentPos + toRead);\n      currentPos += toRead;\n      stream.push(chunk);\n    });\n  }\n}\n\n/**\n * File descriptor based archive source\n *\n * Used for reading directly from a file on disk.\n * More memory efficient for large archives.\n */\nexport class FileSource implements ArchiveSource {\n  private fd: number;\n  private size: number;\n\n  constructor(fd: number, size: number) {\n    this.fd = fd;\n    this.size = size;\n  }\n\n  read(position: number, length: number): Buffer {\n    // Handle large reads by chunking to fit 32-bit signed int limit\n    const MAX_INT32 = 0x7fffffff; // 2,147,483,647 bytes (~2GB)\n\n    if (length <= MAX_INT32) {\n      return this.readChunk(position, length);\n    }\n\n    // For large reads, split into multiple chunks\n    const chunks: Buffer[] = [];\n    let totalBytesRead = 0;\n    let currentPos = position;\n\n    while (totalBytesRead < length) {\n      const remaining = length - totalBytesRead;\n      const chunkSize = Math.min(remaining, MAX_INT32);\n      const chunk = this.readChunk(currentPos, chunkSize);\n\n      chunks.push(chunk);\n      totalBytesRead += chunk.length;\n      currentPos += chunk.length;\n\n      if (chunk.length < chunkSize) {\n        // EOF reached\n        break;\n      }\n    }\n\n    return Buffer.concat(chunks);\n  }\n\n  private readChunk(position: number, length: number): Buffer {\n    const buf = allocBuffer(length);\n    const bytesRead = fs.readSync(this.fd, buf, 0, length, position);\n    if (bytesRead < length) {\n      return buf.slice(0, bytesRead);\n    }\n    return buf;\n  }\n\n  getSize(): number {\n    return this.size;\n  }\n\n  close(): void {\n    try {\n      fs.closeSync(this.fd);\n    } catch (_e) {\n      // Ignore close errors\n    }\n  }\n\n  /**\n   * Create a readable stream for a portion of the file.\n   * Uses async fs.read() to avoid blocking the event loop.\n   */\n  createReadStream(offset: number, length: number): Stream.Readable {\n    const fd = this.fd;\n    let bytesRead = 0;\n    let reading = false;\n    let finished = false;\n    const chunkSize = 65536; // 64KB chunks\n    let _streamRef: Stream.Readable | null = null;\n\n    const stream = createReadableStream((s) => {\n      _streamRef = s;\n      if (reading || finished) return; // Prevent re-entrant reads\n\n      const toRead = Math.min(chunkSize, length - bytesRead);\n      if (toRead <= 0) {\n        finished = true;\n        s.push(null);\n        return;\n      }\n\n      reading = true;\n      const buffer = allocBuffer(toRead);\n      const currentOffset = offset + bytesRead;\n\n      fs.read(fd, buffer, 0, toRead, currentOffset, (err, n) => {\n        reading = false;\n\n        if (err) {\n          // Emit error for Node 0.8 compatibility (no destroy method)\n          s.emit('error', err);\n          finished = true;\n          s.push(null);\n          return;\n        }\n\n        if (n === 0) {\n          finished = true;\n          s.push(null);\n        } else {\n          bytesRead += n;\n          s.push(buffer.slice(0, n));\n        }\n      });\n    });\n\n    return stream;\n  }\n}\n"],"names":["BufferSource","FileSource","createReadableStream","readFn","stream","Readable","_read","buffer","read","position","length","slice","getSize","close","createReadStream","offset","end","Math","min","currentPos","chunkSize","push","toRead","chunk","fd","size","MAX_INT32","readChunk","chunks","totalBytesRead","remaining","Buffer","concat","buf","allocBuffer","bytesRead","fs","readSync","closeSync","_e","reading","finished","_streamRef","s","currentOffset","err","n","emit"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/iterators/7z-iterator/src/sevenz/ArchiveSource.ts"],"sourcesContent":["/**\n * ArchiveSource - Abstraction for reading 7z archive data\n *\n * Provides a common interface for reading archive data from either\n * a file descriptor or an in-memory buffer.\n */\n\nimport { allocBuffer, type BufferLike, BufferList, canAllocateBufferSize, Readable } from 'extract-base-iterator';\nimport fs from 'fs';\nimport type Stream from 'stream';\n\n// Helper to create a Readable stream compatible with Node 0.8\nfunction createReadableStream(readFn: (stream: Stream.Readable) => void): Stream.Readable {\n  const stream = new Readable();\n  stream._read = function () {\n    readFn(this);\n  };\n  return stream;\n}\n\n/**\n * Archive source abstraction - allows reading from file descriptor or buffer\n */\nexport interface ArchiveSource {\n  read(position: number, length: number): BufferLike;\n  getSize(): number;\n  close(): void;\n  /**\n   * Create a readable stream for a portion of the archive.\n   * Used for streaming decompression.\n   */\n  createReadStream(offset: number, length: number): Stream.Readable;\n}\n\n/**\n * Buffer-based archive source\n *\n * Used when the entire archive is already in memory.\n */\nexport class BufferSource implements ArchiveSource {\n  private buffer: Buffer;\n\n  constructor(buffer: Buffer) {\n    this.buffer = buffer;\n  }\n\n  read(position: number, length: number): BufferLike {\n    return this.buffer.slice(position, position + length);\n  }\n\n  getSize(): number {\n    return this.buffer.length;\n  }\n\n  close(): void {\n    // Nothing to close for buffer\n  }\n\n  /**\n   * Create a readable stream for a portion of the buffer.\n   * Streams the data in chunks to avoid blocking.\n   */\n  createReadStream(offset: number, length: number): Stream.Readable {\n    const buffer = this.buffer;\n    const end = Math.min(offset + length, buffer.length);\n    let currentPos = offset;\n    const chunkSize = 65536; // 64KB chunks\n\n    return createReadableStream((stream) => {\n      if (currentPos >= end) {\n        stream.push(null);\n        return;\n      }\n\n      const toRead = Math.min(chunkSize, end - currentPos);\n      const chunk = buffer.slice(currentPos, currentPos + toRead);\n      currentPos += toRead;\n      stream.push(chunk);\n    });\n  }\n}\n\n/**\n * File descriptor based archive source\n *\n * Used for reading directly from a file on disk.\n * More memory efficient for large archives.\n */\nexport class FileSource implements ArchiveSource {\n  private fd: number;\n  private size: number;\n\n  constructor(fd: number, size: number) {\n    this.fd = fd;\n    this.size = size;\n  }\n\n  read(position: number, length: number): BufferLike {\n    // For small reads that fit in a single buffer, return directly\n    // This is efficient on all Node versions\n    if (canAllocateBufferSize(length)) {\n      return this.readChunk(position, length);\n    }\n\n    // For large reads, return a BufferList to avoid large contiguous allocation\n    // This enables LZMA1 decompression on old Node versions\n    const result = new BufferList();\n    let totalBytesRead = 0;\n    let currentPos = position;\n\n    while (totalBytesRead < length) {\n      const remaining = length - totalBytesRead;\n      // Use safe chunk size that works on all Node versions\n      const chunkSize = Math.min(remaining, canAllocateBufferSize(remaining) ? remaining : 256 * 1024 * 1024);\n      const chunk = this.readChunk(currentPos, chunkSize);\n\n      result.append(chunk);\n      totalBytesRead += chunk.length;\n      currentPos += chunk.length;\n\n      if (chunk.length < chunkSize) {\n        // EOF reached\n        break;\n      }\n    }\n\n    return result;\n  }\n\n  private readChunk(position: number, length: number): Buffer {\n    const buf = allocBuffer(length);\n    const bytesRead = fs.readSync(this.fd, buf, 0, length, position);\n    if (bytesRead < length) {\n      return buf.slice(0, bytesRead);\n    }\n    return buf;\n  }\n\n  getSize(): number {\n    return this.size;\n  }\n\n  close(): void {\n    try {\n      fs.closeSync(this.fd);\n    } catch (_e) {\n      // Ignore close errors\n    }\n  }\n\n  /**\n   * Create a readable stream for a portion of the file.\n   * Uses async fs.read() to avoid blocking the event loop.\n   */\n  createReadStream(offset: number, length: number): Stream.Readable {\n    const fd = this.fd;\n    let bytesRead = 0;\n    let reading = false;\n    let finished = false;\n    const chunkSize = 65536; // 64KB chunks\n    let _streamRef: Stream.Readable | null = null;\n\n    const stream = createReadableStream((s) => {\n      _streamRef = s;\n      if (reading || finished) return; // Prevent re-entrant reads\n\n      const toRead = Math.min(chunkSize, length - bytesRead);\n      if (toRead <= 0) {\n        finished = true;\n        s.push(null);\n        return;\n      }\n\n      reading = true;\n      const buffer = allocBuffer(toRead);\n      const currentOffset = offset + bytesRead;\n\n      fs.read(fd, buffer, 0, toRead, currentOffset, (err, n) => {\n        reading = false;\n\n        if (err) {\n          // Emit error for Node 0.8 compatibility (no destroy method)\n          s.emit('error', err);\n          finished = true;\n          s.push(null);\n          return;\n        }\n\n        if (n === 0) {\n          finished = true;\n          s.push(null);\n        } else {\n          bytesRead += n;\n          s.push(buffer.slice(0, n));\n        }\n      });\n    });\n\n    return stream;\n  }\n}\n"],"names":["BufferSource","FileSource","createReadableStream","readFn","stream","Readable","_read","buffer","read","position","length","slice","getSize","close","createReadStream","offset","end","Math","min","currentPos","chunkSize","push","toRead","chunk","fd","size","canAllocateBufferSize","readChunk","result","BufferList","totalBytesRead","remaining","append","buf","allocBuffer","bytesRead","fs","readSync","closeSync","_e","reading","finished","_streamRef","s","currentOffset","err","n","emit"],"mappings":"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"}

package/dist/cjs/sevenz/SevenZipParser.d.cts

@@ -56,6 +56,13 @@ export declare class SevenZipParser {
     private folderSplitters;
     private pendingFolders;
     constructor(source: ArchiveSource);
+    /**
+     * Convert BufferLike to Buffer (for small data like headers)
+     */
+    private toBuffer;
+    /**
+     * Decode using codec - accepts BufferLike for LZMA1 support
+     */
     private decodeWithCodec;
     /**
      * Parse the archive structure

package/dist/cjs/sevenz/SevenZipParser.d.ts

@@ -56,6 +56,13 @@ export declare class SevenZipParser {
     private folderSplitters;
     private pendingFolders;
     constructor(source: ArchiveSource);
+    /**
+     * Convert BufferLike to Buffer (for small data like headers)
+     */
+    private toBuffer;
+    /**
+     * Decode using codec - accepts BufferLike for LZMA1 support
+     */
     private decodeWithCodec;
     /**
      * Parse the archive structure

package/dist/cjs/sevenz/SevenZipParser.js

@@ -212,7 +212,14 @@ var SevenZipParser = /*#__PURE__*/ function() {
         this.source = source;
     }
     var _proto = SevenZipParser.prototype;
-    _proto.decodeWithCodec = function decodeWithCodec(codec, input, properties, unpackSize, callback) {
+    /**
+   * Convert BufferLike to Buffer (for small data like headers)
+   */ _proto.toBuffer = function toBuffer(buf) {
+        return Buffer.isBuffer(buf) ? buf : buf.toBuffer();
+    };
+    /**
+   * Decode using codec - accepts BufferLike for LZMA1 support
+   */ _proto.decodeWithCodec = function decodeWithCodec(codec, input, properties, unpackSize, callback) {
         var done = (0, _calloncefn.default)(callback);
         try {
             codec.decode(input, properties, unpackSize, function(err, result) {
@@ -273,7 +280,7 @@ var SevenZipParser = /*#__PURE__*/ function() {
                 callback((0, _constantsts.createCodedError)('Archive too small', _constantsts.ErrorCode.TRUNCATED_ARCHIVE));
                 return;
             }
-            signature = (0, _headersts.parseSignatureHeader)(sigBuf);
+            signature = (0, _headersts.parseSignatureHeader)(this.toBuffer(sigBuf));
             this.signature = signature;
             var headerOffset = _constantsts.SIGNATURE_HEADER_SIZE + signature.nextHeaderOffset;
             headerBuf = this.source.read(headerOffset, signature.nextHeaderSize);
@@ -297,7 +304,7 @@ var SevenZipParser = /*#__PURE__*/ function() {
         try {
             var _ref;
             var _this_signature;
-            var headerResult = (0, _headersts.parseEncodedHeader)(headerBuf, (_ref = (_this_signature = this.signature) === null || _this_signature === void 0 ? void 0 : _this_signature.nextHeaderCRC) !== null && _ref !== void 0 ? _ref : 0);
+            var headerResult = (0, _headersts.parseEncodedHeader)(this.toBuffer(headerBuf), (_ref = (_this_signature = this.signature) === null || _this_signature === void 0 ? void 0 : _this_signature.nextHeaderCRC) !== null && _ref !== void 0 ? _ref : 0);
             this.streamsInfo = headerResult.streamsInfo || null;
             this.filesInfo = headerResult.filesInfo;
             finalize();
@@ -321,15 +328,17 @@ var SevenZipParser = /*#__PURE__*/ function() {
    */ _proto.handleCompressedHeader = function handleCompressedHeader(headerBuf, callback) {
         var _this = this;
         // Parse the encoded header info to get decompression parameters
+        // Convert to Buffer for header parsing (small data)
+        var headerBuffer = this.toBuffer(headerBuf);
         var offset = 1; // Skip kEncodedHeader byte
-        var propertyId = headerBuf[offset++];
+        var propertyId = headerBuffer[offset++];
         if (propertyId !== _constantsts.PropertyId.kMainStreamsInfo && propertyId !== _constantsts.PropertyId.kPackInfo) {
             callback((0, _constantsts.createCodedError)('Expected StreamsInfo in encoded header', _constantsts.ErrorCode.CORRUPT_HEADER));
             return;
         }
         var packInfoResult;
         try {
-            packInfoResult = this.parseEncodedHeaderStreams(headerBuf, 1);
+            packInfoResult = this.parseEncodedHeaderStreams(headerBuffer, 1);
         } catch (err) {
             callback(err);
             return;
@@ -344,7 +353,9 @@ var SevenZipParser = /*#__PURE__*/ function() {
             var searchEnd = Math.max(_constantsts.SIGNATURE_HEADER_SIZE, compressedStart - 100000);
             var scanChunkSize = 4096;
             for(var chunkStart = searchStart; chunkStart >= searchEnd; chunkStart -= scanChunkSize){
-                var chunk = this.source.read(chunkStart, scanChunkSize + packInfoResult.packSize);
+                var chunkRaw = this.source.read(chunkStart, scanChunkSize + packInfoResult.packSize);
+                // Convert to Buffer for scanning (small data)
+                var chunk = this.toBuffer(chunkRaw);
                 var limit = Math.min(chunk.length, scanChunkSize);
                 for(var i = 0; i < limit; i++){
                     if (chunk[i] === 0x00) {
@@ -886,7 +897,8 @@ var SevenZipParser = /*#__PURE__*/ function() {
     _proto.decodeFolderCoders = function decodeFolderCoders(folder, input, index, callback) {
         var _this = this;
         if (index >= folder.coders.length) {
-            callback(null, input);
+            // Convert BufferList to Buffer for final output
+            callback(null, this.toBuffer(input));
             return;
         }
         var coderInfo = folder.coders[index];
@@ -1005,7 +1017,8 @@ var SevenZipParser = /*#__PURE__*/ function() {
                 bcj2Inputs.push(coderOutputs[boundOutput]);
             } else {
                 var psIdx = inputToPackStream[globalIdx];
-                bcj2Inputs.push(packStreams[psIdx]);
+                // Convert BufferList to Buffer for BCJ2 (small data, safe to concatenate)
+                bcj2Inputs.push(this.toBuffer(packStreams[psIdx]));
             }
         }
         var bcj2OutputStart = 0;
@@ -1107,7 +1120,7 @@ var SevenZipParser = /*#__PURE__*/ function() {
         if (key === '3-3-1-5') return true;
         // LZMA2 - now uses streaming Transform (Phase 5)
         if (key === '21') return true;
-        // LZMA - still buffer-based (TODO: Phase 5 continuation)
+        // LZMA - still buffer-based (cannot stream - no chunk boundaries in LZMA1 format)
         // Other BCJ variants (ARM64, ARMT, IA64, PPC, SPARC) - still buffer-based
         // BCJ2 - multi-stream architecture, never streamable
         return false;