7z-iterator 0.1.8 → 0.1.10

package/dist/cjs/sevenz/codecs/lzmaCompat.js

@@ -0,0 +1,76 @@
+/**
+ * LZMA compatibility layer - uses native lzma when available, falls back to lzma-purejs
+ *
+ * lzma-native provides native liblzma bindings with rawDecoder support.
+ * This gives significant performance improvements on Node.js 8+ while
+ * maintaining compatibility with Node.js 0.8+ via lzma-purejs fallback.
+ *
+ * The native decoder uses Node.js streams which integrate naturally with
+ * the callback-based async pattern used throughout the iterator libraries.
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get createNativeLzma1Decoder () {
+        return createNativeLzma1Decoder;
+    },
+    get createNativeLzma2Decoder () {
+        return createNativeLzma2Decoder;
+    },
+    get hasNativeLzma () {
+        return hasNativeLzma;
+    }
+});
+var _module = /*#__PURE__*/ _interop_require_default(require("module"));
+function _interop_require_default(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+var _require = typeof require === 'undefined' ? _module.default.createRequire(require("url").pathToFileURL(__filename).toString()) : require;
+// Try to load lzma-native (only on Node 10+ where ES6 class syntax is supported)
+// Note: We must check the version BEFORE requiring because syntax errors during
+// module parsing cannot be caught by try/catch
+var lzmaNative = null;
+var _hasNativeLzmaLib = false;
+var major = +process.versions.node.split('.')[0];
+if (major >= 10) {
+    try {
+        lzmaNative = _require('lzma-native');
+        // Verify rawDecoder support
+        _hasNativeLzmaLib = lzmaNative !== null && typeof lzmaNative.createStream === 'function';
+    } catch (_e) {
+    // lzma-native not available - will use lzma-purejs
+    }
+}
+var hasNativeLzma = _hasNativeLzmaLib;
+function createNativeLzma2Decoder(dictSize) {
+    if (!lzmaNative) {
+        return null;
+    }
+    var filterOpts = {
+        id: lzmaNative.FILTER_LZMA2
+    };
+    if (dictSize !== undefined) {
+        filterOpts.dict_size = dictSize;
+    }
+    return lzmaNative.createStream('rawDecoder', {
+        filters: [
+            filterOpts
+        ]
+    });
+}
+function createNativeLzma1Decoder(_lc, _lp, _pb, _dictSize) {
+    // Native LZMA1 disabled - lzma-native's rawDecoder has issues with 7z's LZMA1 format
+    // (LZMA_BUF_ERROR: No progress is possible)
+    // LZMA2 native works correctly and is more common in modern 7z files
+    return null;
+}
+/* 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/codecs/lzmaCompat.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/iterators/7z-iterator/src/sevenz/codecs/lzmaCompat.ts"],"sourcesContent":["/**\n * LZMA compatibility layer - uses native lzma when available, falls back to lzma-purejs\n *\n * lzma-native provides native liblzma bindings with rawDecoder support.\n * This gives significant performance improvements on Node.js 8+ while\n * maintaining compatibility with Node.js 0.8+ via lzma-purejs fallback.\n *\n * The native decoder uses Node.js streams which integrate naturally with\n * the callback-based async pattern used throughout the iterator libraries.\n */\n\nimport Module from 'module';\nimport type { Transform } from 'readable-stream';\n\nvar _require = typeof require === 'undefined' ? Module.createRequire(import.meta.url) : require;\n\n// Try to load lzma-native (only on Node 10+ where ES6 class syntax is supported)\n// Note: We must check the version BEFORE requiring because syntax errors during\n// module parsing cannot be caught by try/catch\nvar lzmaNative: typeof import('lzma-native') | null = null;\nvar _hasNativeLzmaLib = false;\nvar major = +process.versions.node.split('.')[0];\n\nif (major >= 10) {\n  try {\n    lzmaNative = _require('lzma-native');\n    // Verify rawDecoder support\n    _hasNativeLzmaLib = lzmaNative !== null && typeof lzmaNative.createStream === 'function';\n  } catch (_e) {\n    // lzma-native not available - will use lzma-purejs\n  }\n}\n\n// Export whether native lzma is available for streaming\nexport var hasNativeLzma = _hasNativeLzmaLib;\n\n/**\n * Create a native LZMA2 decoder stream\n * Returns a Transform stream that decodes LZMA2 data\n *\n * @param dictSize - Dictionary size\n * @returns Transform stream for decoding, or null if native not available\n */\nexport function createNativeLzma2Decoder(dictSize?: number): Transform | null {\n  if (!lzmaNative) {\n    return null;\n  }\n\n  var filterOpts: { id: string; dict_size?: number } = {\n    id: lzmaNative.FILTER_LZMA2,\n  };\n\n  if (dictSize !== undefined) {\n    filterOpts.dict_size = dictSize;\n  }\n\n  return lzmaNative.createStream('rawDecoder', {\n    filters: [filterOpts],\n  }) as unknown as Transform;\n}\n\n/**\n * Create a native LZMA1 decoder stream\n * Returns a Transform stream that decodes LZMA1 data\n *\n * Note: Native LZMA1 decoder disabled due to LZMA_BUF_ERROR issues with\n * lzma-native's rawDecoder for LZMA1. Falls back to lzma-purejs which\n * handles 7z's LZMA1 format correctly. LZMA2 native works fine.\n *\n * @param _lc - Literal context bits (0-8)\n * @param _lp - Literal position bits (0-4)\n * @param _pb - Position bits (0-4)\n * @param _dictSize - Dictionary size\n * @returns null - always falls back to pure JS decoder\n */\nexport function createNativeLzma1Decoder(_lc: number, _lp: number, _pb: number, _dictSize: number): Transform | null {\n  // Native LZMA1 disabled - lzma-native's rawDecoder has issues with 7z's LZMA1 format\n  // (LZMA_BUF_ERROR: No progress is possible)\n  // LZMA2 native works correctly and is more common in modern 7z files\n  return null;\n}\n"],"names":["createNativeLzma1Decoder","createNativeLzma2Decoder","hasNativeLzma","_require","require","Module","createRequire","lzmaNative","_hasNativeLzmaLib","major","process","versions","node","split","createStream","_e","dictSize","filterOpts","id","FILTER_LZMA2","undefined","dict_size","filters","_lc","_lp","_pb","_dictSize"],"mappings":"AAAA;;;;;;;;;CASC;;;;;;;;;;;QAkEeA;eAAAA;;QAhCAC;eAAAA;;QATLC;eAAAA;;;6DAvBQ;;;;;;AAGnB,IAAIC,WAAW,OAAOC,YAAY,cAAcC,eAAM,CAACC,aAAa,CAAC,uDAAmBF;AAExF,iFAAiF;AACjF,gFAAgF;AAChF,+CAA+C;AAC/C,IAAIG,aAAkD;AACtD,IAAIC,oBAAoB;AACxB,IAAIC,QAAQ,CAACC,QAAQC,QAAQ,CAACC,IAAI,CAACC,KAAK,CAAC,IAAI,CAAC,EAAE;AAEhD,IAAIJ,SAAS,IAAI;IACf,IAAI;QACFF,aAAaJ,SAAS;QACtB,4BAA4B;QAC5BK,oBAAoBD,eAAe,QAAQ,OAAOA,WAAWO,YAAY,KAAK;IAChF,EAAE,OAAOC,IAAI;IACX,mDAAmD;IACrD;AACF;AAGO,IAAIb,gBAAgBM;AASpB,SAASP,yBAAyBe,QAAiB;IACxD,IAAI,CAACT,YAAY;QACf,OAAO;IACT;IAEA,IAAIU,aAAiD;QACnDC,IAAIX,WAAWY,YAAY;IAC7B;IAEA,IAAIH,aAAaI,WAAW;QAC1BH,WAAWI,SAAS,GAAGL;IACzB;IAEA,OAAOT,WAAWO,YAAY,CAAC,cAAc;QAC3CQ,SAAS;YAACL;SAAW;IACvB;AACF;AAgBO,SAASjB,yBAAyBuB,GAAW,EAAEC,GAAW,EAAEC,GAAW,EAAEC,SAAiB;IAC/F,qFAAqF;IACrF,4CAA4C;IAC5C,qEAAqE;IACrE,OAAO;AACT"}

package/dist/esm/FileEntry.js

@@ -28,20 +28,20 @@ let SevenZipFileEntry = class SevenZipFileEntry extends FileEntry {
             callback(new Error('7z FileEntry missing entry. Check for calling create multiple times'));
             return;
         }
-        try {
-            var stream = this.parser.getEntryStream(this.entry);
+        // Use callback-based async decompression
+        this.parser.getEntryStreamAsync(this.entry, (err, stream)=>{
+            if (err) return callback(err);
+            if (!stream) return callback(new Error('No stream returned'));
             var res = stream.pipe(fs.createWriteStream(fullPath));
             oo(res, [
                 'error',
                 'end',
                 'close',
                 'finish'
-            ], (err)=>{
-                err ? callback(err) : waitForAccess(fullPath, callback);
+            ], (writeErr)=>{
+                writeErr ? callback(writeErr) : waitForAccess(fullPath, callback);
             });
-        } catch (err) {
-            callback(err);
-        }
+        });
     }
     destroy() {
         FileEntry.prototype.destroy.call(this);

package/dist/esm/FileEntry.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/iterators/7z-iterator/src/FileEntry.ts"],"sourcesContent":["import { type FileAttributes, FileEntry, type NoParamCallback, waitForAccess } from 'extract-base-iterator';\nimport fs from 'fs';\nimport oo from 'on-one';\nimport type { SevenZipEntry, SevenZipParser } from './sevenz/SevenZipParser.ts';\nimport type { ExtractOptions, LockT } from './types.ts';\n\nexport default class SevenZipFileEntry extends FileEntry {\n  private lock: LockT;\n  private entry: SevenZipEntry;\n  private parser: SevenZipParser;\n\n  constructor(attributes: FileAttributes, entry: SevenZipEntry, parser: SevenZipParser, lock: LockT) {\n    super(attributes);\n    this.entry = entry;\n    this.parser = parser;\n    this.lock = lock;\n    this.lock.retain();\n  }\n\n  create(dest: string, options: ExtractOptions | NoParamCallback, callback: NoParamCallback): undefined | Promise<boolean> {\n    if (typeof options === 'function') {\n      callback = options;\n      options = null;\n    }\n\n    if (typeof callback === 'function') {\n      options = options || {};\n      return FileEntry.prototype.create.call(this, dest, options, (err?: Error) => {\n        callback(err);\n        if (this.lock) {\n          this.lock.release();\n          this.lock = null;\n        }\n      });\n    }\n    return new Promise((resolve, reject) => {\n      this.create(dest, options, (err?: Error, done?: boolean) => {\n        err ? reject(err) : resolve(done);\n      });\n    });\n  }\n\n  _writeFile(fullPath: string, _options: ExtractOptions, callback: NoParamCallback): undefined {\n    if (!this.entry || !this.parser) {\n      callback(new Error('7z FileEntry missing entry. Check for calling create multiple times'));\n      return;\n    }\n\n    try {\n      var stream = this.parser.getEntryStream(this.entry);\n      var res = stream.pipe(fs.createWriteStream(fullPath));\n      oo(res, ['error', 'end', 'close', 'finish'], (err?: Error) => {\n        err ? callback(err) : waitForAccess(fullPath, callback);\n      });\n    } catch (err) {\n      callback(err);\n    }\n  }\n\n  destroy() {\n    FileEntry.prototype.destroy.call(this);\n    this.entry = null;\n    this.parser = null;\n    if (this.lock) {\n      this.lock.release();\n      this.lock = null;\n    }\n  }\n}\n"],"names":["FileEntry","waitForAccess","fs","oo","SevenZipFileEntry","create","dest","options","callback","prototype","call","err","lock","release","Promise","resolve","reject","done","_writeFile","fullPath","_options","entry","parser","Error","stream","getEntryStream","res","pipe","createWriteStream","destroy","attributes","retain"],"mappings":"AAAA,SAA8BA,SAAS,EAAwBC,aAAa,QAAQ,wBAAwB;AAC5G,OAAOC,QAAQ,KAAK;AACpB,OAAOC,QAAQ,SAAS;AAIT,IAAA,AAAMC,oBAAN,MAAMA,0BAA0BJ;IAa7CK,OAAOC,IAAY,EAAEC,OAAyC,EAAEC,QAAyB,EAAgC;QACvH,IAAI,OAAOD,YAAY,YAAY;YACjCC,WAAWD;YACXA,UAAU;QACZ;QAEA,IAAI,OAAOC,aAAa,YAAY;YAClCD,UAAUA,WAAW,CAAC;YACtB,OAAOP,UAAUS,SAAS,CAACJ,MAAM,CAACK,IAAI,CAAC,IAAI,EAAEJ,MAAMC,SAAS,CAACI;gBAC3DH,SAASG;gBACT,IAAI,IAAI,CAACC,IAAI,EAAE;oBACb,IAAI,CAACA,IAAI,CAACC,OAAO;oBACjB,IAAI,CAACD,IAAI,GAAG;gBACd;YACF;QACF;QACA,OAAO,IAAIE,QAAQ,CAACC,SAASC;YAC3B,IAAI,CAACX,MAAM,CAACC,MAAMC,SAAS,CAACI,KAAaM;gBACvCN,MAAMK,OAAOL,OAAOI,QAAQE;YAC9B;QACF;IACF;IAEAC,WAAWC,QAAgB,EAAEC,QAAwB,EAAEZ,QAAyB,EAAa;QAC3F,IAAI,CAAC,IAAI,CAACa,KAAK,IAAI,CAAC,IAAI,CAACC,MAAM,EAAE;YAC/Bd,SAAS,IAAIe,MAAM;YACnB;QACF;QAEA,IAAI;YACF,IAAIC,SAAS,IAAI,CAACF,MAAM,CAACG,cAAc,CAAC,IAAI,CAACJ,KAAK;YAClD,IAAIK,MAAMF,OAAOG,IAAI,CAACzB,GAAG0B,iBAAiB,CAACT;YAC3ChB,GAAGuB,KAAK;gBAAC;gBAAS;gBAAO;gBAAS;aAAS,EAAE,CAACf;gBAC5CA,MAAMH,SAASG,OAAOV,cAAckB,UAAUX;YAChD;QACF,EAAE,OAAOG,KAAK;YACZH,SAASG;QACX;IACF;IAEAkB,UAAU;QACR7B,UAAUS,SAAS,CAACoB,OAAO,CAACnB,IAAI,CAAC,IAAI;QACrC,IAAI,CAACW,KAAK,GAAG;QACb,IAAI,CAACC,MAAM,GAAG;QACd,IAAI,IAAI,CAACV,IAAI,EAAE;YACb,IAAI,CAACA,IAAI,CAACC,OAAO;YACjB,IAAI,CAACD,IAAI,GAAG;QACd;IACF;IAxDA,YAAYkB,UAA0B,EAAET,KAAoB,EAAEC,MAAsB,EAAEV,IAAW,CAAE;QACjG,KAAK,CAACkB;QACN,IAAI,CAACT,KAAK,GAAGA;QACb,IAAI,CAACC,MAAM,GAAGA;QACd,IAAI,CAACV,IAAI,GAAGA;QACZ,IAAI,CAACA,IAAI,CAACmB,MAAM;IAClB;AAmDF;AA9DA,SAAqB3B,+BA8DpB"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/iterators/7z-iterator/src/FileEntry.ts"],"sourcesContent":["import { type FileAttributes, FileEntry, type NoParamCallback, waitForAccess } from 'extract-base-iterator';\nimport fs from 'fs';\nimport oo from 'on-one';\nimport type { SevenZipEntry, SevenZipParser } from './sevenz/SevenZipParser.ts';\nimport type { ExtractOptions, LockT } from './types.ts';\n\nexport default class SevenZipFileEntry extends FileEntry {\n  private lock: LockT;\n  private entry: SevenZipEntry;\n  private parser: SevenZipParser;\n\n  constructor(attributes: FileAttributes, entry: SevenZipEntry, parser: SevenZipParser, lock: LockT) {\n    super(attributes);\n    this.entry = entry;\n    this.parser = parser;\n    this.lock = lock;\n    this.lock.retain();\n  }\n\n  create(dest: string, options: ExtractOptions | NoParamCallback, callback: NoParamCallback): undefined | Promise<boolean> {\n    if (typeof options === 'function') {\n      callback = options;\n      options = null;\n    }\n\n    if (typeof callback === 'function') {\n      options = options || {};\n      return FileEntry.prototype.create.call(this, dest, options, (err?: Error) => {\n        callback(err);\n        if (this.lock) {\n          this.lock.release();\n          this.lock = null;\n        }\n      });\n    }\n    return new Promise((resolve, reject) => {\n      this.create(dest, options, (err?: Error, done?: boolean) => {\n        err ? reject(err) : resolve(done);\n      });\n    });\n  }\n\n  _writeFile(fullPath: string, _options: ExtractOptions, callback: NoParamCallback): undefined {\n    if (!this.entry || !this.parser) {\n      callback(new Error('7z FileEntry missing entry. Check for calling create multiple times'));\n      return;\n    }\n\n    // Use callback-based async decompression\n    this.parser.getEntryStreamAsync(this.entry, (err, stream) => {\n      if (err) return callback(err);\n      if (!stream) return callback(new Error('No stream returned'));\n\n      var res = stream.pipe(fs.createWriteStream(fullPath));\n      oo(res, ['error', 'end', 'close', 'finish'], (writeErr?: Error) => {\n        writeErr ? callback(writeErr) : waitForAccess(fullPath, callback);\n      });\n    });\n  }\n\n  destroy() {\n    FileEntry.prototype.destroy.call(this);\n    this.entry = null;\n    this.parser = null;\n    if (this.lock) {\n      this.lock.release();\n      this.lock = null;\n    }\n  }\n}\n"],"names":["FileEntry","waitForAccess","fs","oo","SevenZipFileEntry","create","dest","options","callback","prototype","call","err","lock","release","Promise","resolve","reject","done","_writeFile","fullPath","_options","entry","parser","Error","getEntryStreamAsync","stream","res","pipe","createWriteStream","writeErr","destroy","attributes","retain"],"mappings":"AAAA,SAA8BA,SAAS,EAAwBC,aAAa,QAAQ,wBAAwB;AAC5G,OAAOC,QAAQ,KAAK;AACpB,OAAOC,QAAQ,SAAS;AAIT,IAAA,AAAMC,oBAAN,MAAMA,0BAA0BJ;IAa7CK,OAAOC,IAAY,EAAEC,OAAyC,EAAEC,QAAyB,EAAgC;QACvH,IAAI,OAAOD,YAAY,YAAY;YACjCC,WAAWD;YACXA,UAAU;QACZ;QAEA,IAAI,OAAOC,aAAa,YAAY;YAClCD,UAAUA,WAAW,CAAC;YACtB,OAAOP,UAAUS,SAAS,CAACJ,MAAM,CAACK,IAAI,CAAC,IAAI,EAAEJ,MAAMC,SAAS,CAACI;gBAC3DH,SAASG;gBACT,IAAI,IAAI,CAACC,IAAI,EAAE;oBACb,IAAI,CAACA,IAAI,CAACC,OAAO;oBACjB,IAAI,CAACD,IAAI,GAAG;gBACd;YACF;QACF;QACA,OAAO,IAAIE,QAAQ,CAACC,SAASC;YAC3B,IAAI,CAACX,MAAM,CAACC,MAAMC,SAAS,CAACI,KAAaM;gBACvCN,MAAMK,OAAOL,OAAOI,QAAQE;YAC9B;QACF;IACF;IAEAC,WAAWC,QAAgB,EAAEC,QAAwB,EAAEZ,QAAyB,EAAa;QAC3F,IAAI,CAAC,IAAI,CAACa,KAAK,IAAI,CAAC,IAAI,CAACC,MAAM,EAAE;YAC/Bd,SAAS,IAAIe,MAAM;YACnB;QACF;QAEA,yCAAyC;QACzC,IAAI,CAACD,MAAM,CAACE,mBAAmB,CAAC,IAAI,CAACH,KAAK,EAAE,CAACV,KAAKc;YAChD,IAAId,KAAK,OAAOH,SAASG;YACzB,IAAI,CAACc,QAAQ,OAAOjB,SAAS,IAAIe,MAAM;YAEvC,IAAIG,MAAMD,OAAOE,IAAI,CAACzB,GAAG0B,iBAAiB,CAACT;YAC3ChB,GAAGuB,KAAK;gBAAC;gBAAS;gBAAO;gBAAS;aAAS,EAAE,CAACG;gBAC5CA,WAAWrB,SAASqB,YAAY5B,cAAckB,UAAUX;YAC1D;QACF;IACF;IAEAsB,UAAU;QACR9B,UAAUS,SAAS,CAACqB,OAAO,CAACpB,IAAI,CAAC,IAAI;QACrC,IAAI,CAACW,KAAK,GAAG;QACb,IAAI,CAACC,MAAM,GAAG;QACd,IAAI,IAAI,CAACV,IAAI,EAAE;YACb,IAAI,CAACA,IAAI,CAACC,OAAO;YACjB,IAAI,CAACD,IAAI,GAAG;QACd;IACF;IAzDA,YAAYmB,UAA0B,EAAEV,KAAoB,EAAEC,MAAsB,EAAEV,IAAW,CAAE;QACjG,KAAK,CAACmB;QACN,IAAI,CAACV,KAAK,GAAGA;QACb,IAAI,CAACC,MAAM,GAAGA;QACd,IAAI,CAACV,IAAI,GAAGA;QACZ,IAAI,CAACA,IAAI,CAACoB,MAAM;IAClB;AAoDF;AA/DA,SAAqB5B,+BA+DpB"}

package/dist/esm/nextEntry.js

@@ -54,23 +54,27 @@ export default 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();
-                var stream = parser.getEntryStream(entry);
-                var chunks = [];
-                stream.on('data', (chunk)=>{
-                    chunks.push(chunk);
-                });
-                stream.on('end', ()=>{
-                    var linkpath = Buffer.concat(chunks).toString('utf8');
-                    var linkAttributes = {
-                        path: attributes.path,
-                        mtime: attributes.mtime,
-                        mode: attributes.mode,
-                        linkpath: linkpath
-                    };
-                    nextCallback(null, new SymbolicLinkEntry(linkAttributes));
-                });
-                stream.on('error', (err)=>{
-                    nextCallback(err);
+                // Use callback-based async decompression
+                parser.getEntryStreamAsync(entry, (err, stream)=>{
+                    if (err) return nextCallback(err);
+                    if (!stream) return nextCallback(new Error('No stream returned'));
+                    var chunks = [];
+                    stream.on('data', (chunk)=>{
+                        chunks.push(chunk);
+                    });
+                    stream.on('end', ()=>{
+                        var linkpath = Buffer.concat(chunks).toString('utf8');
+                        var linkAttributes = {
+                            path: attributes.path,
+                            mtime: attributes.mtime,
+                            mode: attributes.mode,
+                            linkpath: linkpath
+                        };
+                        nextCallback(null, new SymbolicLinkEntry(linkAttributes));
+                    });
+                    stream.on('error', (streamErr)=>{
+                        nextCallback(streamErr);
+                    });
                 });
                 return;
             }

package/dist/esm/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) => undefined;\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): undefined {\n  if (!iterator.iterator) {\n    callback(new Error('iterator missing'));\n    return;\n  }\n\n  var entry: SevenZipEntry | null = null;\n  entry = iterator.iterator.next();\n\n  var 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  var type = entry.type;\n\n  // Default modes (decimal values for Node 0.8 compatibility)\n  // 0o755 = 493, 0o644 = 420\n  var defaultMode = type === 'directory' ? 493 : 420;\n\n  // Build attributes from 7z entry\n  // mtime must be timestamp (number) for FileAttributes compatibility\n  var mtimeDate = entry.mtime || new Date();\n  var 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      var parser = iterator.iterator.getParser();\n      var stream = parser.getEntryStream(entry);\n      var chunks: Buffer[] = [];\n\n      stream.on('data', (chunk: Buffer) => {\n        chunks.push(chunk);\n      });\n      stream.on('end', () => {\n        var linkpath = Buffer.concat(chunks).toString('utf8');\n\n        var 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', (err: Error) => {\n        nextCallback(err);\n      });\n      return;\n    }\n\n    case 'file': {\n      attributes.type = 'file';\n      attributes.size = entry.size;\n      var 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":["once","DirectoryEntry","SymbolicLinkEntry","compact","path","FileEntry","nextEntry","iterator","callback","Error","entry","next","nextCallback","err","push","done","value","lock","isDone","isAntiFile","type","defaultMode","mtimeDate","mtime","Date","attributes","split","sep","join","basename","name","getTime","mode","undefined","parser","getParser","stream","getEntryStream","chunks","on","chunk","linkpath","Buffer","concat","toString","linkAttributes","size","parser2"],"mappings":"AAAA,OAAOA,UAAU,eAAe;AAChC,SAAmCC,cAAc,EAA4CC,iBAAiB,QAAQ,wBAAwB;AAC9I,OAAOC,aAAa,iBAAiB;AACrC,OAAOC,UAAU,OAAO;AACxB,OAAOC,eAAe,iBAAiB;AAkBvC,eAAe,SAASC,UAAcC,QAA0B,EAAEC,QAAuB;IACvF,IAAI,CAACD,SAASA,QAAQ,EAAE;QACtBC,SAAS,IAAIC,MAAM;QACnB;IACF;IAEA,IAAIC,QAA8B;IAClCA,QAAQH,SAASA,QAAQ,CAACI,IAAI;IAE9B,IAAIC,eAAeZ,KAAK,CAACa,KAAaH;QACpC,kBAAkB;QAClB,IAAIA,OAAOH,SAASO,IAAI,CAACR;QACzBO,MAAML,SAASK,OAAOL,SAAS,MAAME,QAAQ;YAAEK,MAAM;YAAOC,OAAON;QAAM,IAAI;YAAEK,MAAM;YAAMC,OAAO;QAAK;IACzG;IAEA,gEAAgE;IAChE,IAAI,CAACT,SAASU,IAAI,IAAIV,SAASW,MAAM,MAAM,CAACR,OAAO,OAAOF,SAAS,MAAM;QAAEO,MAAM;QAAMC,OAAO;IAAK;IAEnG,iEAAiE;IACjE,IAAIN,MAAMS,UAAU,EAAE;QACpBZ,SAASO,IAAI,CAACR;QACd,OAAOE,SAAS,MAAM;IACxB;IAEA,4BAA4B;IAC5B,IAAIY,OAAOV,MAAMU,IAAI;IAErB,4DAA4D;IAC5D,2BAA2B;IAC3B,IAAIC,cAAcD,SAAS,cAAc,MAAM;IAE/C,iCAAiC;IACjC,oEAAoE;IACpE,IAAIE,YAAYZ,MAAMa,KAAK,IAAI,IAAIC;IACnC,IAAIC,aAAqC;QACvCrB,MAAMD,QAAQO,MAAMN,IAAI,CAACsB,KAAK,CAACtB,KAAKuB,GAAG,GAAGC,IAAI,CAACxB,KAAKuB,GAAG;QACvDE,UAAUnB,MAAMoB,IAAI;QACpBP,OAAOD,UAAUS,OAAO;QACxBC,MAAMtB,MAAMsB,IAAI,KAAKC,YAAYvB,MAAMsB,IAAI,GAAGX;IAChD;IAEA,OAAQD;QACN,KAAK;YACHK,WAAWL,IAAI,GAAG;YAClB,OAAOR,aAAa,MAAM,IAAIX,eAAewB;QAE/C,KAAK;YAAQ;gBACX,4DAA4D;gBAC5D,6DAA6D;gBAC7D,IAAIS,SAAS3B,SAASA,QAAQ,CAAC4B,SAAS;gBACxC,IAAIC,SAASF,OAAOG,cAAc,CAAC3B;gBACnC,IAAI4B,SAAmB,EAAE;gBAEzBF,OAAOG,EAAE,CAAC,QAAQ,CAACC;oBACjBF,OAAOxB,IAAI,CAAC0B;gBACd;gBACAJ,OAAOG,EAAE,CAAC,OAAO;oBACf,IAAIE,WAAWC,OAAOC,MAAM,CAACL,QAAQM,QAAQ,CAAC;oBAE9C,IAAIC,iBAAiC;wBACnCzC,MAAMqB,WAAWrB,IAAI;wBACrBmB,OAAOE,WAAWF,KAAK;wBACvBS,MAAMP,WAAWO,IAAI;wBACrBS,UAAUA;oBACZ;oBAEA7B,aAAa,MAAM,IAAIV,kBAAkB2C;gBAC3C;gBACAT,OAAOG,EAAE,CAAC,SAAS,CAAC1B;oBAClBD,aAAaC;gBACf;gBACA;YACF;QAEA,KAAK;YAAQ;gBACXY,WAAWL,IAAI,GAAG;gBAClBK,WAAWqB,IAAI,GAAGpC,MAAMoC,IAAI;gBAC5B,IAAIC,UAAUxC,SAASA,QAAQ,CAAC4B,SAAS;gBACzC,OAAOvB,aAAa,MAAM,IAAIP,UAAUoB,YAA8Bf,OAAOqC,SAASxC,SAASU,IAAI;YACrG;IACF;IAEA,OAAOT,SAAS,IAAIC,MAAM,CAAC,yBAAyB,EAAEW,MAAM;AAC9D"}
+{"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) => undefined;\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): undefined {\n  if (!iterator.iterator) {\n    callback(new Error('iterator missing'));\n    return;\n  }\n\n  var entry: SevenZipEntry | null = null;\n  entry = iterator.iterator.next();\n\n  var 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  var type = entry.type;\n\n  // Default modes (decimal values for Node 0.8 compatibility)\n  // 0o755 = 493, 0o644 = 420\n  var defaultMode = type === 'directory' ? 493 : 420;\n\n  // Build attributes from 7z entry\n  // mtime must be timestamp (number) for FileAttributes compatibility\n  var mtimeDate = entry.mtime || new Date();\n  var 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      var 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        var chunks: Buffer[] = [];\n\n        stream.on('data', (chunk: Buffer) => {\n          chunks.push(chunk);\n        });\n        stream.on('end', () => {\n          var linkpath = Buffer.concat(chunks).toString('utf8');\n\n          var 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      var 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":["once","DirectoryEntry","SymbolicLinkEntry","compact","path","FileEntry","nextEntry","iterator","callback","Error","entry","next","nextCallback","err","push","done","value","lock","isDone","isAntiFile","type","defaultMode","mtimeDate","mtime","Date","attributes","split","sep","join","basename","name","getTime","mode","undefined","parser","getParser","getEntryStreamAsync","stream","chunks","on","chunk","linkpath","Buffer","concat","toString","linkAttributes","streamErr","size","parser2"],"mappings":"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"}

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

@@ -87,6 +87,11 @@ export declare class SevenZipParser {
      * Get a readable stream for an entry's content
      */
     getEntryStream(entry: SevenZipEntry): Readable;
+    /**
+     * Get a readable stream for an entry's content (callback-based async version)
+     * Uses streaming decompression for non-blocking I/O
+     */
+    getEntryStreamAsync(entry: SevenZipEntry, callback: (err: Error | null, stream?: Readable) => void): void;
     /**
      * Check if a folder uses BCJ2 codec
      */
@@ -96,6 +101,11 @@ export declare class SevenZipParser {
      * Only caches when multiple files share a block, releases when last file extracted
      */
     private getDecompressedFolder;
+    /**
+     * Get decompressed data for a folder using streaming (callback-based async)
+     * Uses createDecoder() streams for non-blocking decompression
+     */
+    private getDecompressedFolderAsync;
     /**
      * Decompress a BCJ2 folder with multi-stream handling
      * BCJ2 uses 4 input streams: main, call, jump, range coder

package/dist/esm/sevenz/SevenZipParser.js

@@ -2,6 +2,7 @@
 // Handles reading archive structure and providing file streams
 import { allocBuffer, crc32 } from 'extract-base-iterator';
 import fs from 'fs';
+import oo from 'on-one';
 import { PassThrough } from 'readable-stream';
 import { decodeBcj2Multi, getCodec, getCodecName, isBcj2Codec, isCodecSupported } from './codecs/index.js';
 import { createCodedError, ErrorCode, FileAttribute, PropertyId, SIGNATURE_HEADER_SIZE } from './constants.js';
@@ -417,6 +418,65 @@ import { readNumber } from './NumberCodec.js';
         return outputStream;
     }
     /**
+   * Get a readable stream for an entry's content (callback-based async version)
+   * Uses streaming decompression for non-blocking I/O
+   */ getEntryStreamAsync(entry, callback) {
+        if (!entry._hasStream || entry.type === 'directory') {
+            // Return empty stream for directories and empty files
+            var emptyStream = new PassThrough();
+            emptyStream.end();
+            callback(null, emptyStream);
+            return;
+        }
+        if (!this.streamsInfo) {
+            callback(createCodedError('No streams info available', ErrorCode.CORRUPT_HEADER));
+            return;
+        }
+        // Get folder info
+        var folder = this.streamsInfo.folders[entry._folderIndex];
+        if (!folder) {
+            callback(createCodedError('Invalid folder index', ErrorCode.CORRUPT_HEADER));
+            return;
+        }
+        // Check codec support
+        for(var i = 0; i < folder.coders.length; i++){
+            var coder = folder.coders[i];
+            if (!isCodecSupported(coder.id)) {
+                var codecName = getCodecName(coder.id);
+                callback(createCodedError(`Unsupported codec: ${codecName}`, ErrorCode.UNSUPPORTED_CODEC));
+                return;
+            }
+        }
+        // Get decompressed data for this folder using async method
+        var folderIdx = entry._folderIndex;
+        var streamsInfo = this.streamsInfo;
+        this.getDecompressedFolderAsync(folderIdx, (err, data)=>{
+            if (err) return callback(err);
+            if (!data) return callback(new Error('No data returned from decompression'));
+            // Calculate file offset within the decompressed block
+            var fileStart = 0;
+            for(var m = 0; m < entry._streamIndexInFolder; m++){
+                var prevStreamGlobalIndex = entry._streamIndex - entry._streamIndexInFolder + m;
+                fileStart += streamsInfo.unpackSizes[prevStreamGlobalIndex];
+            }
+            var fileSize = entry.size;
+            // Bounds check
+            if (fileStart + fileSize > data.length) {
+                return callback(createCodedError(`File data out of bounds: offset ${fileStart} + size ${fileSize} > decompressed length ${data.length}`, ErrorCode.DECOMPRESSION_FAILED));
+            }
+            // Create a PassThrough stream with the file data
+            var outputStream = new PassThrough();
+            var fileData = data.slice(fileStart, fileStart + fileSize);
+            outputStream.end(fileData);
+            // Track extraction and release cache when all files from this folder are done
+            this.extractedPerFolder[folderIdx] = (this.extractedPerFolder[folderIdx] || 0) + 1;
+            if (this.extractedPerFolder[folderIdx] >= this.filesPerFolder[folderIdx]) {
+                delete this.decompressedCache[folderIdx];
+            }
+            callback(null, outputStream);
+        });
+    }
+    /**
    * Check if a folder uses BCJ2 codec
    */ folderHasBcj2(folder) {
         for(var i = 0; i < folder.coders.length; i++){
@@ -482,6 +542,104 @@ import { readNumber } from './NumberCodec.js';
         return data2;
     }
     /**
+   * Get decompressed data for a folder using streaming (callback-based async)
+   * Uses createDecoder() streams for non-blocking decompression
+   */ getDecompressedFolderAsync(folderIndex, callback) {
+        var self = this;
+        // Check cache first
+        if (this.decompressedCache[folderIndex]) {
+            callback(null, this.decompressedCache[folderIndex]);
+            return;
+        }
+        if (!this.streamsInfo) {
+            callback(createCodedError('No streams info available', ErrorCode.CORRUPT_HEADER));
+            return;
+        }
+        var folder = this.streamsInfo.folders[folderIndex];
+        // Check how many files remain in this folder
+        var filesInFolder = this.filesPerFolder[folderIndex] || 1;
+        var extractedFromFolder = this.extractedPerFolder[folderIndex] || 0;
+        var remainingFiles = filesInFolder - extractedFromFolder;
+        var shouldCache = remainingFiles > 1;
+        // BCJ2 requires special handling - use sync version for now
+        // TODO: Add async BCJ2 support
+        if (this.folderHasBcj2(folder)) {
+            try {
+                var data = this.decompressBcj2Folder(folderIndex);
+                if (shouldCache) {
+                    this.decompressedCache[folderIndex] = data;
+                }
+                callback(null, data);
+            } catch (err) {
+                callback(err);
+            }
+            return;
+        }
+        // Calculate packed data position
+        var packPos = SIGNATURE_HEADER_SIZE + this.streamsInfo.packPos;
+        // Find which pack stream this folder uses
+        var packStreamIndex = 0;
+        for(var j = 0; j < folderIndex; j++){
+            packStreamIndex += this.streamsInfo.folders[j].packedStreams.length;
+        }
+        // Calculate position of this pack stream
+        for(var k = 0; k < packStreamIndex; k++){
+            packPos += this.streamsInfo.packSizes[k];
+        }
+        var packSize = this.streamsInfo.packSizes[packStreamIndex];
+        // Read packed data
+        var packedData = this.source.read(packPos, packSize);
+        // Create decoder stream chain and decompress
+        var coders = folder.coders;
+        var unpackSizes = folder.unpackSizes;
+        // Helper to decompress through a single codec stream
+        function decompressWithStream(input, coderIdx, cb) {
+            var coderInfo = coders[coderIdx];
+            var codec = getCodec(coderInfo.id);
+            var decoder = codec.createDecoder(coderInfo.properties, unpackSizes[coderIdx]);
+            var chunks = [];
+            var errorOccurred = false;
+            decoder.on('data', (chunk)=>{
+                chunks.push(chunk);
+            });
+            oo(decoder, [
+                'error',
+                'end',
+                'close',
+                'finish'
+            ], (err)=>{
+                if (errorOccurred) return;
+                if (err) {
+                    errorOccurred = true;
+                    return cb(err);
+                }
+                cb(null, Buffer.concat(chunks));
+            });
+            // Write input data to decoder and signal end
+            decoder.end(input);
+        }
+        // Chain decompression through all codecs
+        function decompressChain(input, idx) {
+            if (idx >= coders.length) {
+                // All done - cache and return
+                if (shouldCache) {
+                    self.decompressedCache[folderIndex] = input;
+                }
+                callback(null, input);
+                return;
+            }
+            decompressWithStream(input, idx, (err, output)=>{
+                if (err) {
+                    callback(err);
+                    return;
+                }
+                decompressChain(output, idx + 1);
+            });
+        }
+        // Start the chain
+        decompressChain(packedData, 0);
+    }
+    /**
    * Decompress a BCJ2 folder with multi-stream handling
    * BCJ2 uses 4 input streams: main, call, jump, range coder
    */ decompressBcj2Folder(folderIndex) {