7z-iterator 1.1.2 → 1.2.0

package/dist/cjs/nextEntry.js

@@ -19,12 +19,13 @@ function _interop_require_default(obj) {
     };
 }
 function nextEntry(iterator, callback) {
-    if (!iterator.iterator) {
+    var internalIter = iterator._iterator;
+    if (!internalIter) {
         callback(new Error('iterator missing'));
         return;
     }
     var entry = null;
-    entry = iterator.iterator.next();
+    entry = internalIter.next();
     var nextCallback = (0, _calloncefn.default)(function(err, entry) {
         // keep processing
         if (entry) iterator.push(nextEntry);
@@ -68,28 +69,24 @@ function nextEntry(iterator, callback) {
             {
                 // For symlinks, the file content IS the symlink target path
                 // Read the content to get the linkpath for SymbolicLinkEntry
-                var parser = iterator.iterator.getParser();
-                // Use callback-based async decompression
-                parser.getEntryStreamAsync(entry, function(err, stream) {
-                    if (err) return nextCallback(err);
-                    if (!stream) return nextCallback(new Error('No stream returned'));
-                    var chunks = [];
-                    stream.on('data', function(chunk) {
-                        chunks.push(chunk);
-                    });
-                    stream.on('end', function() {
-                        var linkpath = Buffer.concat(chunks).toString('utf8');
-                        var linkAttributes = {
-                            path: attributes.path,
-                            mtime: attributes.mtime,
-                            mode: attributes.mode,
-                            linkpath: linkpath
-                        };
-                        nextCallback(null, new _extractbaseiterator.SymbolicLinkEntry(linkAttributes));
-                    });
-                    stream.on('error', function(streamErr) {
-                        nextCallback(streamErr);
-                    });
+                var parser = internalIter.getParser();
+                var stream = parser.getEntryStream(entry);
+                var chunks = [];
+                stream.on('data', function(chunk) {
+                    chunks.push(chunk);
+                });
+                stream.on('end', function() {
+                    var linkpath = Buffer.concat(chunks).toString('utf8');
+                    var linkAttributes = {
+                        path: attributes.path,
+                        mtime: attributes.mtime,
+                        mode: attributes.mode,
+                        linkpath: linkpath
+                    };
+                    nextCallback(null, new _extractbaseiterator.SymbolicLinkEntry(linkAttributes));
+                });
+                stream.on('error', function(streamErr) {
+                    nextCallback(streamErr);
                 });
                 return;
             }
@@ -97,8 +94,9 @@ function nextEntry(iterator, callback) {
             {
                 attributes.type = 'file';
                 attributes.size = entry.size;
-                var parser2 = iterator.iterator.getParser();
-                return nextCallback(null, new _FileEntryts.default(attributes, entry, parser2, iterator.lock));
+                var parser1 = internalIter.getParser();
+                var stream1 = parser1.getEntryStream(entry);
+                return nextCallback(null, new _FileEntryts.default(attributes, stream1, iterator.lock, entry._canStream));
             }
     }
     return callback(new Error("Unrecognized entry type: ".concat(type)));

package/dist/cjs/nextEntry.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/iterators/7z-iterator/src/nextEntry.ts"],"sourcesContent":["import once from 'call-once-fn';\nimport { type DirectoryAttributes, DirectoryEntry, type FileAttributes, type LinkAttributes, SymbolicLinkEntry } from 'extract-base-iterator';\nimport compact from 'lodash.compact';\nimport path from 'path';\nimport FileEntry from './FileEntry.ts';\nimport type SevenZipIterator from './SevenZipIterator.ts';\nimport type { SevenZipEntry } from './sevenz/SevenZipParser.ts';\nimport type { Entry, EntryCallback } from './types.ts';\n\nexport type NextCallback = (error?: Error, entry?: Entry) => void;\n\n// Entry attributes object that gets mutated in switch - union of possible shapes\n// mtime is number for FileAttributes compatibility (timestamp in ms)\ntype EntryAttributesBuilder = {\n  path: string;\n  basename: string;\n  mtime: number;\n  mode: number;\n  type?: 'file' | 'directory';\n  size?: number;\n};\n\nexport default function nextEntry<_T>(iterator: SevenZipIterator, callback: EntryCallback): void {\n  if (!iterator.iterator) {\n    callback(new Error('iterator missing'));\n    return;\n  }\n\n  let entry: SevenZipEntry | null = null;\n  entry = iterator.iterator.next();\n\n  const nextCallback = once((err?: Error, entry?: Entry) => {\n    // keep processing\n    if (entry) iterator.push(nextEntry);\n    err ? callback(err) : callback(null, entry ? { done: false, value: entry } : { done: true, value: null });\n  }) as NextCallback;\n\n  // done: signal iteration is complete (guard against stale lock)\n  if (!iterator.lock || iterator.isDone() || !entry) return callback(null, { done: true, value: null });\n\n  // Skip anti-files (these mark files to delete in delta archives)\n  if (entry.isAntiFile) {\n    iterator.push(nextEntry);\n    return callback(null, null);\n  }\n\n  // Determine type from entry\n  const type = entry.type;\n\n  // Default modes (decimal values for Node 0.8 compatibility)\n  // 0o755 = 493, 0o644 = 420\n  const defaultMode = type === 'directory' ? 493 : 420;\n\n  // Build attributes from 7z entry\n  // mtime must be timestamp (number) for FileAttributes compatibility\n  const mtimeDate = entry.mtime || new Date();\n  const attributes: EntryAttributesBuilder = {\n    path: compact(entry.path.split(path.sep)).join(path.sep),\n    basename: entry.name,\n    mtime: mtimeDate.getTime(),\n    mode: entry.mode !== undefined ? entry.mode : defaultMode,\n  };\n\n  switch (type) {\n    case 'directory':\n      attributes.type = 'directory';\n      return nextCallback(null, new DirectoryEntry(attributes as DirectoryAttributes));\n\n    case 'link': {\n      // For symlinks, the file content IS the symlink target path\n      // Read the content to get the linkpath for SymbolicLinkEntry\n      const parser = iterator.iterator.getParser();\n\n      // Use callback-based async decompression\n      parser.getEntryStreamAsync(entry, (err, stream) => {\n        if (err) return nextCallback(err);\n        if (!stream) return nextCallback(new Error('No stream returned'));\n\n        const chunks: Buffer[] = [];\n\n        stream.on('data', (chunk: Buffer) => {\n          chunks.push(chunk);\n        });\n        stream.on('end', () => {\n          const linkpath = Buffer.concat(chunks).toString('utf8');\n\n          const linkAttributes: LinkAttributes = {\n            path: attributes.path,\n            mtime: attributes.mtime,\n            mode: attributes.mode,\n            linkpath: linkpath,\n          };\n\n          nextCallback(null, new SymbolicLinkEntry(linkAttributes));\n        });\n        stream.on('error', (streamErr: Error) => {\n          nextCallback(streamErr);\n        });\n      });\n      return;\n    }\n\n    case 'file': {\n      attributes.type = 'file';\n      attributes.size = entry.size;\n      const parser2 = iterator.iterator.getParser();\n      return nextCallback(null, new FileEntry(attributes as FileAttributes, entry, parser2, iterator.lock));\n    }\n  }\n\n  return callback(new Error(`Unrecognized entry type: ${type}`));\n}\n"],"names":["nextEntry","iterator","callback","Error","entry","next","nextCallback","once","err","push","done","value","lock","isDone","isAntiFile","type","defaultMode","mtimeDate","mtime","Date","attributes","path","compact","split","sep","join","basename","name","getTime","mode","undefined","DirectoryEntry","parser","getParser","getEntryStreamAsync","stream","chunks","on","chunk","linkpath","Buffer","concat","toString","linkAttributes","SymbolicLinkEntry","streamErr","size","parser2","FileEntry"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/iterators/7z-iterator/src/nextEntry.ts"],"sourcesContent":["import once from 'call-once-fn';\nimport { type DirectoryAttributes, DirectoryEntry, type FileAttributes, type LinkAttributes, SymbolicLinkEntry } from 'extract-base-iterator';\nimport compact from 'lodash.compact';\nimport path from 'path';\nimport FileEntry from './FileEntry.ts';\nimport type SevenZipIterator from './SevenZipIterator.ts';\nimport type { SevenZipEntry, SevenZipParser } from './sevenz/SevenZipParser.ts';\nimport type { Entry, EntryCallback } from './types.ts';\n\nexport type NextCallback = (error?: Error, entry?: Entry) => void;\n\n/** @internal */\ninterface InternalIterator {\n  next(): SevenZipEntry | null;\n  getParser(): SevenZipParser;\n}\n\n// Entry attributes object that gets mutated in switch - union of possible shapes\n// mtime is number for FileAttributes compatibility (timestamp in ms)\ntype EntryAttributesBuilder = {\n  path: string;\n  basename: string;\n  mtime: number;\n  mode: number;\n  type?: 'file' | 'directory';\n  size?: number;\n};\n\nexport default function nextEntry<_T>(iterator: SevenZipIterator, callback: EntryCallback): void {\n  const internalIter = iterator._iterator as InternalIterator | null;\n  if (!internalIter) {\n    callback(new Error('iterator missing'));\n    return;\n  }\n\n  let entry: SevenZipEntry | null = null;\n  entry = internalIter.next();\n\n  const nextCallback = once((err?: Error, entry?: Entry) => {\n    // keep processing\n    if (entry) iterator.push(nextEntry);\n    err ? callback(err) : callback(null, entry ? { done: false, value: entry } : { done: true, value: null });\n  }) as NextCallback;\n\n  // done: signal iteration is complete (guard against stale lock)\n  if (!iterator.lock || iterator.isDone() || !entry) return callback(null, { done: true, value: null });\n\n  // Skip anti-files (these mark files to delete in delta archives)\n  if (entry.isAntiFile) {\n    iterator.push(nextEntry);\n    return callback(null, null);\n  }\n\n  // Determine type from entry\n  const type = entry.type;\n\n  // Default modes (decimal values for Node 0.8 compatibility)\n  // 0o755 = 493, 0o644 = 420\n  const defaultMode = type === 'directory' ? 493 : 420;\n\n  // Build attributes from 7z entry\n  // mtime must be timestamp (number) for FileAttributes compatibility\n  const mtimeDate = entry.mtime || new Date();\n  const attributes: EntryAttributesBuilder = {\n    path: compact(entry.path.split(path.sep)).join(path.sep),\n    basename: entry.name,\n    mtime: mtimeDate.getTime(),\n    mode: entry.mode !== undefined ? entry.mode : defaultMode,\n  };\n\n  switch (type) {\n    case 'directory':\n      attributes.type = 'directory';\n      return nextCallback(null, new DirectoryEntry(attributes as DirectoryAttributes));\n\n    case 'link': {\n      // For symlinks, the file content IS the symlink target path\n      // Read the content to get the linkpath for SymbolicLinkEntry\n      const parser = internalIter.getParser();\n      const stream = parser.getEntryStream(entry);\n\n      const chunks: Buffer[] = [];\n\n      stream.on('data', (chunk: Buffer) => {\n        chunks.push(chunk);\n      });\n      stream.on('end', () => {\n        const linkpath = Buffer.concat(chunks).toString('utf8');\n\n        const linkAttributes: LinkAttributes = {\n          path: attributes.path,\n          mtime: attributes.mtime,\n          mode: attributes.mode,\n          linkpath: linkpath,\n        };\n\n        nextCallback(null, new SymbolicLinkEntry(linkAttributes));\n      });\n      stream.on('error', (streamErr: Error) => {\n        nextCallback(streamErr);\n      });\n      return;\n    }\n\n    case 'file': {\n      attributes.type = 'file';\n      attributes.size = entry.size;\n      const parser = internalIter.getParser();\n\n      const stream = parser.getEntryStream(entry);\n      return nextCallback(null, new FileEntry(attributes as FileAttributes, stream, iterator.lock, entry._canStream));\n    }\n  }\n\n  return callback(new Error(`Unrecognized entry type: ${type}`));\n}\n"],"names":["nextEntry","iterator","callback","internalIter","_iterator","Error","entry","next","nextCallback","once","err","push","done","value","lock","isDone","isAntiFile","type","defaultMode","mtimeDate","mtime","Date","attributes","path","compact","split","sep","join","basename","name","getTime","mode","undefined","DirectoryEntry","parser","getParser","stream","getEntryStream","chunks","on","chunk","linkpath","Buffer","concat","toString","linkAttributes","SymbolicLinkEntry","streamErr","size","FileEntry","_canStream"],"mappings":";;;;+BA4BA;;;eAAwBA;;;iEA5BP;mCACqG;oEAClG;2DACH;kEACK;;;;;;AAwBP,SAASA,UAAcC,QAA0B,EAAEC,QAAuB;IACvF,IAAMC,eAAeF,SAASG,SAAS;IACvC,IAAI,CAACD,cAAc;QACjBD,SAAS,IAAIG,MAAM;QACnB;IACF;IAEA,IAAIC,QAA8B;IAClCA,QAAQH,aAAaI,IAAI;IAEzB,IAAMC,eAAeC,IAAAA,mBAAI,EAAC,SAACC,KAAaJ;QACtC,kBAAkB;QAClB,IAAIA,OAAOL,SAASU,IAAI,CAACX;QACzBU,MAAMR,SAASQ,OAAOR,SAAS,MAAMI,QAAQ;YAAEM,MAAM;YAAOC,OAAOP;QAAM,IAAI;YAAEM,MAAM;YAAMC,OAAO;QAAK;IACzG;IAEA,gEAAgE;IAChE,IAAI,CAACZ,SAASa,IAAI,IAAIb,SAASc,MAAM,MAAM,CAACT,OAAO,OAAOJ,SAAS,MAAM;QAAEU,MAAM;QAAMC,OAAO;IAAK;IAEnG,iEAAiE;IACjE,IAAIP,MAAMU,UAAU,EAAE;QACpBf,SAASU,IAAI,CAACX;QACd,OAAOE,SAAS,MAAM;IACxB;IAEA,4BAA4B;IAC5B,IAAMe,OAAOX,MAAMW,IAAI;IAEvB,4DAA4D;IAC5D,2BAA2B;IAC3B,IAAMC,cAAcD,SAAS,cAAc,MAAM;IAEjD,iCAAiC;IACjC,oEAAoE;IACpE,IAAME,YAAYb,MAAMc,KAAK,IAAI,IAAIC;IACrC,IAAMC,aAAqC;QACzCC,MAAMC,IAAAA,sBAAO,EAAClB,MAAMiB,IAAI,CAACE,KAAK,CAACF,aAAI,CAACG,GAAG,GAAGC,IAAI,CAACJ,aAAI,CAACG,GAAG;QACvDE,UAAUtB,MAAMuB,IAAI;QACpBT,OAAOD,UAAUW,OAAO;QACxBC,MAAMzB,MAAMyB,IAAI,KAAKC,YAAY1B,MAAMyB,IAAI,GAAGb;IAChD;IAEA,OAAQD;QACN,KAAK;YACHK,WAAWL,IAAI,GAAG;YAClB,OAAOT,aAAa,MAAM,IAAIyB,mCAAc,CAACX;QAE/C,KAAK;YAAQ;gBACX,4DAA4D;gBAC5D,6DAA6D;gBAC7D,IAAMY,SAAS/B,aAAagC,SAAS;gBACrC,IAAMC,SAASF,OAAOG,cAAc,CAAC/B;gBAErC,IAAMgC,SAAmB,EAAE;gBAE3BF,OAAOG,EAAE,CAAC,QAAQ,SAACC;oBACjBF,OAAO3B,IAAI,CAAC6B;gBACd;gBACAJ,OAAOG,EAAE,CAAC,OAAO;oBACf,IAAME,WAAWC,OAAOC,MAAM,CAACL,QAAQM,QAAQ,CAAC;oBAEhD,IAAMC,iBAAiC;wBACrCtB,MAAMD,WAAWC,IAAI;wBACrBH,OAAOE,WAAWF,KAAK;wBACvBW,MAAMT,WAAWS,IAAI;wBACrBU,UAAUA;oBACZ;oBAEAjC,aAAa,MAAM,IAAIsC,sCAAiB,CAACD;gBAC3C;gBACAT,OAAOG,EAAE,CAAC,SAAS,SAACQ;oBAClBvC,aAAauC;gBACf;gBACA;YACF;QAEA,KAAK;YAAQ;gBACXzB,WAAWL,IAAI,GAAG;gBAClBK,WAAW0B,IAAI,GAAG1C,MAAM0C,IAAI;gBAC5B,IAAMd,UAAS/B,aAAagC,SAAS;gBAErC,IAAMC,UAASF,QAAOG,cAAc,CAAC/B;gBACrC,OAAOE,aAAa,MAAM,IAAIyC,oBAAS,CAAC3B,YAA8Bc,SAAQnC,SAASa,IAAI,EAAER,MAAM4C,UAAU;YAC/G;IACF;IAEA,OAAOhD,SAAS,IAAIG,MAAM,AAAC,4BAAgC,OAALY;AACxD"}

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

@@ -4,6 +4,7 @@
  * Provides a common interface for reading archive data from either
  * a file descriptor or an in-memory buffer.
  */
+import type Stream from 'stream';
 /**
  * Archive source abstraction - allows reading from file descriptor or buffer
  */
@@ -11,6 +12,11 @@ export interface ArchiveSource {
     read(position: number, length: number): Buffer;
     getSize(): number;
     close(): void;
+    /**
+     * Create a readable stream for a portion of the archive.
+     * Used for streaming decompression.
+     */
+    createReadStream(offset: number, length: number): Stream.Readable;
 }
 /**
  * Buffer-based archive source
@@ -23,6 +29,11 @@ export declare class BufferSource implements ArchiveSource {
     read(position: number, length: number): Buffer;
     getSize(): number;
     close(): void;
+    /**
+     * Create a readable stream for a portion of the buffer.
+     * Streams the data in chunks to avoid blocking.
+     */
+    createReadStream(offset: number, length: number): Stream.Readable;
 }
 /**
  * File descriptor based archive source
@@ -37,4 +48,9 @@ export declare class FileSource implements ArchiveSource {
     read(position: number, length: number): Buffer;
     getSize(): number;
     close(): void;
+    /**
+     * Create a readable stream for a portion of the file.
+     * Uses async fs.read() to avoid blocking the event loop.
+     */
+    createReadStream(offset: number, length: number): Stream.Readable;
 }

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

@@ -4,6 +4,7 @@
  * Provides a common interface for reading archive data from either
  * a file descriptor or an in-memory buffer.
  */
+import type Stream from 'stream';
 /**
  * Archive source abstraction - allows reading from file descriptor or buffer
  */
@@ -11,6 +12,11 @@ export interface ArchiveSource {
     read(position: number, length: number): Buffer;
     getSize(): number;
     close(): void;
+    /**
+     * Create a readable stream for a portion of the archive.
+     * Used for streaming decompression.
+     */
+    createReadStream(offset: number, length: number): Stream.Readable;
 }
 /**
  * Buffer-based archive source
@@ -23,6 +29,11 @@ export declare class BufferSource implements ArchiveSource {
     read(position: number, length: number): Buffer;
     getSize(): number;
     close(): void;
+    /**
+     * Create a readable stream for a portion of the buffer.
+     * Streams the data in chunks to avoid blocking.
+     */
+    createReadStream(offset: number, length: number): Stream.Readable;
 }
 /**
  * File descriptor based archive source
@@ -37,4 +48,9 @@ export declare class FileSource implements ArchiveSource {
     read(position: number, length: number): Buffer;
     getSize(): number;
     close(): void;
+    /**
+     * Create a readable stream for a portion of the file.
+     * Uses async fs.read() to avoid blocking the event loop.
+     */
+    createReadStream(offset: number, length: number): Stream.Readable;
 }

package/dist/cjs/sevenz/ArchiveSource.js

@@ -33,6 +33,14 @@ function _interop_require_default(obj) {
         default: obj
     };
 }
+// Helper to create a Readable stream compatible with Node 0.8
+function createReadableStream(readFn) {
+    var stream = new _extractbaseiterator.Readable();
+    stream._read = function() {
+        readFn(this);
+    };
+    return stream;
+}
 var BufferSource = /*#__PURE__*/ function() {
     "use strict";
     function BufferSource(buffer) {
@@ -49,6 +57,25 @@ var BufferSource = /*#__PURE__*/ function() {
     _proto.close = function close() {
     // Nothing to close for buffer
     };
+    /**
+   * Create a readable stream for a portion of the buffer.
+   * Streams the data in chunks to avoid blocking.
+   */ _proto.createReadStream = function createReadStream(offset, length) {
+        var buffer = this.buffer;
+        var end = Math.min(offset + length, buffer.length);
+        var currentPos = offset;
+        var chunkSize = 65536; // 64KB chunks
+        return createReadableStream(function(stream) {
+            if (currentPos >= end) {
+                stream.push(null);
+                return;
+            }
+            var toRead = Math.min(chunkSize, end - currentPos);
+            var chunk = buffer.slice(currentPos, currentPos + toRead);
+            currentPos += toRead;
+            stream.push(chunk);
+        });
+    };
     return BufferSource;
 }();
 var FileSource = /*#__PURE__*/ function() {
@@ -77,6 +104,48 @@ var FileSource = /*#__PURE__*/ function() {
         // Ignore close errors
         }
     };
+    /**
+   * Create a readable stream for a portion of the file.
+   * Uses async fs.read() to avoid blocking the event loop.
+   */ _proto.createReadStream = function createReadStream(offset, length) {
+        var fd = this.fd;
+        var bytesRead = 0;
+        var reading = false;
+        var finished = false;
+        var chunkSize = 65536; // 64KB chunks
+        var _streamRef = null;
+        var stream = createReadableStream(function(s) {
+            _streamRef = s;
+            if (reading || finished) return; // Prevent re-entrant reads
+            var toRead = Math.min(chunkSize, length - bytesRead);
+            if (toRead <= 0) {
+                finished = true;
+                s.push(null);
+                return;
+            }
+            reading = true;
+            var buffer = (0, _extractbaseiterator.allocBuffer)(toRead);
+            var currentOffset = offset + bytesRead;
+            _fs.default.read(fd, buffer, 0, toRead, currentOffset, function(err, n) {
+                reading = false;
+                if (err) {
+                    // Emit error for Node 0.8 compatibility (no destroy method)
+                    s.emit('error', err);
+                    finished = true;
+                    s.push(null);
+                    return;
+                }
+                if (n === 0) {
+                    finished = true;
+                    s.push(null);
+                } else {
+                    bytesRead += n;
+                    s.push(buffer.slice(0, n));
+                }
+            });
+        });
+        return stream;
+    };
     return FileSource;
 }();
 /* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }

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 } from 'extract-base-iterator';\nimport fs from 'fs';\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\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/**\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    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"],"names":["BufferSource","FileSource","buffer","read","position","length","slice","getSize","close","fd","size","buf","allocBuffer","bytesRead","fs","readSync","closeSync","_e"],"mappings":"AAAA;;;;;CAKC;;;;;;;;;;;QAmBYA;eAAAA;;QA0BAC;eAAAA;;;mCA3Ce;yDACb;;;;;;;;;;;AAgBR,IAAA,AAAMD,6BAAN;;aAAMA,aAGCE,MAAc;gCAHfF;QAIT,IAAI,CAACE,MAAM,GAAGA;;iBAJLF;IAOXG,OAAAA,IAEC,GAFDA,SAAAA,KAAKC,QAAgB,EAAEC,MAAc;QACnC,OAAO,IAAI,CAACH,MAAM,CAACI,KAAK,CAACF,UAAUA,WAAWC;IAChD;IAEAE,OAAAA,OAEC,GAFDA,SAAAA;QACE,OAAO,IAAI,CAACL,MAAM,CAACG,MAAM;IAC3B;IAEAG,OAAAA,KAEC,GAFDA,SAAAA;IACE,8BAA8B;IAChC;WAjBWR;;AA0BN,IAAA,AAAMC,2BAAN;;aAAMA,WAICQ,EAAU,EAAEC,IAAY;gCAJzBT;QAKT,IAAI,CAACQ,EAAE,GAAGA;QACV,IAAI,CAACC,IAAI,GAAGA;;iBANHT;IASXE,OAAAA,IAOC,GAPDA,SAAAA,KAAKC,QAAgB,EAAEC,MAAc;QACnC,IAAMM,MAAMC,IAAAA,gCAAW,EAACP;QACxB,IAAMQ,YAAYC,WAAE,CAACC,QAAQ,CAAC,IAAI,CAACN,EAAE,EAAEE,KAAK,GAAGN,QAAQD;QACvD,IAAIS,YAAYR,QAAQ;YACtB,OAAOM,IAAIL,KAAK,CAAC,GAAGO;QACtB;QACA,OAAOF;IACT;IAEAJ,OAAAA,OAEC,GAFDA,SAAAA;QACE,OAAO,IAAI,CAACG,IAAI;IAClB;IAEAF,OAAAA,KAMC,GANDA,SAAAA;QACE,IAAI;YACFM,WAAE,CAACE,SAAS,CAAC,IAAI,CAACP,EAAE;QACtB,EAAE,OAAOQ,IAAI;QACX,sBAAsB;QACxB;IACF;WA5BWhB"}
+{"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    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","buf","allocBuffer","bytesRead","fs","readSync","closeSync","_e","reading","finished","_streamRef","s","currentOffset","err","n","emit"],"mappings":"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"}

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

@@ -0,0 +1,101 @@
+/**
+ * FolderStreamSplitter - Splits a decompressed folder stream into individual file streams
+ *
+ * For multi-file solid archives, the folder is decompressed as a single stream.
+ * This class splits that stream into individual file streams based on known file boundaries.
+ *
+ * Features:
+ * - Lazy stream creation (streams created on first access)
+ * - Backpressure propagation (returns false when downstream is full)
+ * - Running CRC verification per file
+ * - Automatic cleanup of completed streams
+ */
+import type Stream from 'stream';
+export interface FolderStreamSplitterOptions {
+    /** Sizes of each file in the folder (in order) */
+    fileSizes: number[];
+    /** Whether to verify CRC for each file */
+    verifyCrc?: boolean;
+    /** Expected CRCs for each file (parallel to fileSizes) */
+    expectedCrcs?: (number | undefined)[];
+}
+/**
+ * Splits a decompressed folder stream into individual file streams.
+ *
+ * Usage:
+ * ```
+ * const splitter = new FolderStreamSplitter({ fileSizes: [1000, 2000, 500] });
+ *
+ * decompressStream.on('data', (chunk) => {
+ *   if (!splitter.write(chunk)) {
+ *     decompressStream.pause();
+ *     splitter.onDrain(() => decompressStream.resume());
+ *   }
+ * });
+ * decompressStream.on('end', () => splitter.end());
+ *
+ * // Get stream for file at index 1 (created lazily)
+ * const fileStream = splitter.getFileStream(1);
+ * ```
+ */
+export declare class FolderStreamSplitter {
+    private fileBoundaries;
+    private fileStreams;
+    private fileCrcs;
+    private currentFileIndex;
+    private bytesWritten;
+    private currentFileEnd;
+    private verifyCrc;
+    private expectedCrcs;
+    private finished;
+    private error;
+    private drainCallbacks;
+    private _needsDrain;
+    constructor(options: FolderStreamSplitterOptions);
+    /**
+     * Write decompressed data chunk. Data is routed to appropriate file stream(s).
+     * Returns false if backpressure should be applied (downstream is full).
+     */
+    write(chunk: Buffer): boolean;
+    /**
+     * Ensure stream exists for file index (lazy creation)
+     */
+    private ensureFileStream;
+    /**
+     * Complete current file and move to next
+     */
+    private finishCurrentFile;
+    /**
+     * Signal end of decompressed data
+     */
+    end(): void;
+    /**
+     * Emit error to all pending file streams
+     */
+    private emitError;
+    /**
+     * Get the stream for a specific file by index.
+     * Stream is created lazily on first access.
+     */
+    getFileStream(fileIndex: number): Stream.PassThrough;
+    /**
+     * Register callback for when backpressure clears
+     */
+    onDrain(callback: () => void): void;
+    /**
+     * Notify all drain callbacks
+     */
+    private notifyDrain;
+    /**
+     * Check if a specific file's stream has been fully written
+     */
+    isFileComplete(fileIndex: number): boolean;
+    /**
+     * Get total number of files in this folder
+     */
+    get fileCount(): number;
+    /**
+     * Check if splitter has encountered an error
+     */
+    getError(): Error | null;
+}

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

@@ -0,0 +1,101 @@
+/**
+ * FolderStreamSplitter - Splits a decompressed folder stream into individual file streams
+ *
+ * For multi-file solid archives, the folder is decompressed as a single stream.
+ * This class splits that stream into individual file streams based on known file boundaries.
+ *
+ * Features:
+ * - Lazy stream creation (streams created on first access)
+ * - Backpressure propagation (returns false when downstream is full)
+ * - Running CRC verification per file
+ * - Automatic cleanup of completed streams
+ */
+import type Stream from 'stream';
+export interface FolderStreamSplitterOptions {
+    /** Sizes of each file in the folder (in order) */
+    fileSizes: number[];
+    /** Whether to verify CRC for each file */
+    verifyCrc?: boolean;
+    /** Expected CRCs for each file (parallel to fileSizes) */
+    expectedCrcs?: (number | undefined)[];
+}
+/**
+ * Splits a decompressed folder stream into individual file streams.
+ *
+ * Usage:
+ * ```
+ * const splitter = new FolderStreamSplitter({ fileSizes: [1000, 2000, 500] });
+ *
+ * decompressStream.on('data', (chunk) => {
+ *   if (!splitter.write(chunk)) {
+ *     decompressStream.pause();
+ *     splitter.onDrain(() => decompressStream.resume());
+ *   }
+ * });
+ * decompressStream.on('end', () => splitter.end());
+ *
+ * // Get stream for file at index 1 (created lazily)
+ * const fileStream = splitter.getFileStream(1);
+ * ```
+ */
+export declare class FolderStreamSplitter {
+    private fileBoundaries;
+    private fileStreams;
+    private fileCrcs;
+    private currentFileIndex;
+    private bytesWritten;
+    private currentFileEnd;
+    private verifyCrc;
+    private expectedCrcs;
+    private finished;
+    private error;
+    private drainCallbacks;
+    private _needsDrain;
+    constructor(options: FolderStreamSplitterOptions);
+    /**
+     * Write decompressed data chunk. Data is routed to appropriate file stream(s).
+     * Returns false if backpressure should be applied (downstream is full).
+     */
+    write(chunk: Buffer): boolean;
+    /**
+     * Ensure stream exists for file index (lazy creation)
+     */
+    private ensureFileStream;
+    /**
+     * Complete current file and move to next
+     */
+    private finishCurrentFile;
+    /**
+     * Signal end of decompressed data
+     */
+    end(): void;
+    /**
+     * Emit error to all pending file streams
+     */
+    private emitError;
+    /**
+     * Get the stream for a specific file by index.
+     * Stream is created lazily on first access.
+     */
+    getFileStream(fileIndex: number): Stream.PassThrough;
+    /**
+     * Register callback for when backpressure clears
+     */
+    onDrain(callback: () => void): void;
+    /**
+     * Notify all drain callbacks
+     */
+    private notifyDrain;
+    /**
+     * Check if a specific file's stream has been fully written
+     */
+    isFileComplete(fileIndex: number): boolean;
+    /**
+     * Get total number of files in this folder
+     */
+    get fileCount(): number;
+    /**
+     * Check if splitter has encountered an error
+     */
+    getError(): Error | null;
+}