7z-iterator 0.2.13 → 1.0.0

package/dist/cjs/FileEntry.d.cts

@@ -1,11 +1,11 @@
-import { type FileAttributes, FileEntry, type NoParamCallback } from 'extract-base-iterator';
+import { type FileAttributes, FileEntry, type Lock, type NoParamCallback } from 'extract-base-iterator';
 import type { SevenZipEntry, SevenZipParser } from './sevenz/SevenZipParser.js';
-import type { ExtractOptions, LockT } from './types.js';
+import type { ExtractOptions } from './types.js';
 export default class SevenZipFileEntry extends FileEntry {
     private lock;
     private entry;
     private parser;
-    constructor(attributes: FileAttributes, entry: SevenZipEntry, parser: SevenZipParser, lock: LockT);
+    constructor(attributes: FileAttributes, entry: SevenZipEntry, parser: SevenZipParser, lock: Lock);
     create(dest: string, options: ExtractOptions | NoParamCallback, callback: NoParamCallback): undefined | Promise<boolean>;
     _writeFile(fullPath: string, _options: ExtractOptions, callback: NoParamCallback): undefined;
     destroy(): void;

package/dist/cjs/FileEntry.d.ts

@@ -1,11 +1,11 @@
-import { type FileAttributes, FileEntry, type NoParamCallback } from 'extract-base-iterator';
+import { type FileAttributes, FileEntry, type Lock, type NoParamCallback } from 'extract-base-iterator';
 import type { SevenZipEntry, SevenZipParser } from './sevenz/SevenZipParser.js';
-import type { ExtractOptions, LockT } from './types.js';
+import type { ExtractOptions } from './types.js';
 export default class SevenZipFileEntry extends FileEntry {
     private lock;
     private entry;
     private parser;
-    constructor(attributes: FileAttributes, entry: SevenZipEntry, parser: SevenZipParser, lock: LockT);
+    constructor(attributes: FileAttributes, entry: SevenZipEntry, parser: SevenZipParser, lock: Lock);
     create(dest: string, options: ExtractOptions | NoParamCallback, callback: NoParamCallback): undefined | Promise<boolean>;
     _writeFile(fullPath: string, _options: ExtractOptions, callback: NoParamCallback): undefined;
     destroy(): void;

package/dist/cjs/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    // 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      const 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":["SevenZipFileEntry","attributes","entry","parser","lock","retain","create","dest","options","callback","FileEntry","prototype","call","err","release","Promise","resolve","reject","done","_writeFile","fullPath","_options","Error","getEntryStreamAsync","stream","res","pipe","fs","createWriteStream","oo","writeErr","waitForAccess","destroy"],"mappings":";;;;;;;eAMqBA;;;mCAN+D;yDACrE;4DACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,IAAA,AAAMA,kCAAN;;cAAMA;aAAAA,kBAKPC,UAA0B,EAAEC,KAAoB,EAAEC,MAAsB,EAAEC,IAAW;gCAL9EJ;;gBAMjB,kBANiBA;YAMXC;;QACN,MAAKC,KAAK,GAAGA;QACb,MAAKC,MAAM,GAAGA;QACd,MAAKC,IAAI,GAAGA;QACZ,MAAKA,IAAI,CAACC,MAAM;;;iBAVCL;IAanBM,OAAAA,MAqBC,GArBDA,SAAAA,OAAOC,IAAY,EAAEC,OAAyC,EAAEC,QAAyB;;QACvF,IAAI,OAAOD,YAAY,YAAY;YACjCC,WAAWD;YACXA,UAAU;QACZ;QAEA,IAAI,OAAOC,aAAa,YAAY;YAClCD,UAAUA,WAAW,CAAC;YACtB,OAAOE,8BAAS,CAACC,SAAS,CAACL,MAAM,CAACM,IAAI,CAAC,IAAI,EAAEL,MAAMC,SAAS,SAACK;gBAC3DJ,SAASI;gBACT,IAAI,MAAKT,IAAI,EAAE;oBACb,MAAKA,IAAI,CAACU,OAAO;oBACjB,MAAKV,IAAI,GAAG;gBACd;YACF;QACF;QACA,OAAO,IAAIW,QAAQ,SAACC,SAASC;YAC3B,MAAKX,MAAM,CAACC,MAAMC,SAAS,SAACK,KAAaK;gBACvCL,MAAMI,OAAOJ,OAAOG,QAAQE;YAC9B;QACF;IACF;IAEAC,OAAAA,UAgBC,GAhBDA,SAAAA,WAAWC,QAAgB,EAAEC,QAAwB,EAAEZ,QAAyB;QAC9E,IAAI,CAAC,IAAI,CAACP,KAAK,IAAI,CAAC,IAAI,CAACC,MAAM,EAAE;YAC/BM,SAAS,IAAIa,MAAM;YACnB;QACF;QAEA,yCAAyC;QACzC,IAAI,CAACnB,MAAM,CAACoB,mBAAmB,CAAC,IAAI,CAACrB,KAAK,EAAE,SAACW,KAAKW;YAChD,IAAIX,KAAK,OAAOJ,SAASI;YACzB,IAAI,CAACW,QAAQ,OAAOf,SAAS,IAAIa,MAAM;YAEvC,IAAMG,MAAMD,OAAOE,IAAI,CAACC,WAAE,CAACC,iBAAiB,CAACR;YAC7CS,IAAAA,cAAE,EAACJ,KAAK;gBAAC;gBAAS;gBAAO;gBAAS;aAAS,EAAE,SAACK;gBAC5CA,WAAWrB,SAASqB,YAAYC,IAAAA,kCAAa,EAACX,UAAUX;YAC1D;QACF;IACF;IAEAuB,OAAAA,OAQC,GARDA,SAAAA;QACEtB,8BAAS,CAACC,SAAS,CAACqB,OAAO,CAACpB,IAAI,CAAC,IAAI;QACrC,IAAI,CAACV,KAAK,GAAG;QACb,IAAI,CAACC,MAAM,GAAG;QACd,IAAI,IAAI,CAACC,IAAI,EAAE;YACb,IAAI,CAACA,IAAI,CAACU,OAAO;YACjB,IAAI,CAACV,IAAI,GAAG;QACd;IACF;WA9DmBJ;EAA0BU,8BAAS"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/iterators/7z-iterator/src/FileEntry.ts"],"sourcesContent":["import { type FileAttributes, FileEntry, type Lock, 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 } from './types.ts';\n\nexport default class SevenZipFileEntry extends FileEntry {\n  private lock: Lock;\n  private entry: SevenZipEntry;\n  private parser: SevenZipParser;\n\n  constructor(attributes: FileAttributes, entry: SevenZipEntry, parser: SevenZipParser, lock: Lock) {\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      const 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":["SevenZipFileEntry","attributes","entry","parser","lock","retain","create","dest","options","callback","FileEntry","prototype","call","err","release","Promise","resolve","reject","done","_writeFile","fullPath","_options","Error","getEntryStreamAsync","stream","res","pipe","fs","createWriteStream","oo","writeErr","waitForAccess","destroy"],"mappings":";;;;;;;eAMqBA;;;mCAN0E;yDAChF;4DACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,IAAA,AAAMA,kCAAN;;cAAMA;aAAAA,kBAKPC,UAA0B,EAAEC,KAAoB,EAAEC,MAAsB,EAAEC,IAAU;gCAL7EJ;;gBAMjB,kBANiBA;YAMXC;;QACN,MAAKC,KAAK,GAAGA;QACb,MAAKC,MAAM,GAAGA;QACd,MAAKC,IAAI,GAAGA;QACZ,MAAKA,IAAI,CAACC,MAAM;;;iBAVCL;IAanBM,OAAAA,MAqBC,GArBDA,SAAAA,OAAOC,IAAY,EAAEC,OAAyC,EAAEC,QAAyB;;QACvF,IAAI,OAAOD,YAAY,YAAY;YACjCC,WAAWD;YACXA,UAAU;QACZ;QAEA,IAAI,OAAOC,aAAa,YAAY;YAClCD,UAAUA,WAAW,CAAC;YACtB,OAAOE,8BAAS,CAACC,SAAS,CAACL,MAAM,CAACM,IAAI,CAAC,IAAI,EAAEL,MAAMC,SAAS,SAACK;gBAC3DJ,SAASI;gBACT,IAAI,MAAKT,IAAI,EAAE;oBACb,MAAKA,IAAI,CAACU,OAAO;oBACjB,MAAKV,IAAI,GAAG;gBACd;YACF;QACF;QACA,OAAO,IAAIW,QAAQ,SAACC,SAASC;YAC3B,MAAKX,MAAM,CAACC,MAAMC,SAAS,SAACK,KAAaK;gBACvCL,MAAMI,OAAOJ,OAAOG,QAAQE;YAC9B;QACF;IACF;IAEAC,OAAAA,UAgBC,GAhBDA,SAAAA,WAAWC,QAAgB,EAAEC,QAAwB,EAAEZ,QAAyB;QAC9E,IAAI,CAAC,IAAI,CAACP,KAAK,IAAI,CAAC,IAAI,CAACC,MAAM,EAAE;YAC/BM,SAAS,IAAIa,MAAM;YACnB;QACF;QAEA,yCAAyC;QACzC,IAAI,CAACnB,MAAM,CAACoB,mBAAmB,CAAC,IAAI,CAACrB,KAAK,EAAE,SAACW,KAAKW;YAChD,IAAIX,KAAK,OAAOJ,SAASI;YACzB,IAAI,CAACW,QAAQ,OAAOf,SAAS,IAAIa,MAAM;YAEvC,IAAMG,MAAMD,OAAOE,IAAI,CAACC,WAAE,CAACC,iBAAiB,CAACR;YAC7CS,IAAAA,cAAE,EAACJ,KAAK;gBAAC;gBAAS;gBAAO;gBAAS;aAAS,EAAE,SAACK;gBAC5CA,WAAWrB,SAASqB,YAAYC,IAAAA,kCAAa,EAACX,UAAUX;YAC1D;QACF;IACF;IAEAuB,OAAAA,OAQC,GARDA,SAAAA;QACEtB,8BAAS,CAACC,SAAS,CAACqB,OAAO,CAACpB,IAAI,CAAC,IAAI;QACrC,IAAI,CAACV,KAAK,GAAG;QACb,IAAI,CAACC,MAAM,GAAG;QACd,IAAI,IAAI,CAACC,IAAI,EAAE;YACb,IAAI,CAACA,IAAI,CAACU,OAAO;YACjB,IAAI,CAACV,IAAI,GAAG;QACd;IACF;WA9DmBJ;EAA0BU,8BAAS"}

package/dist/cjs/SevenZipIterator.d.cts

@@ -1,7 +1,7 @@
-import BaseIterator from 'extract-base-iterator';
-import type { ExtractOptions, LockT, SevenZipFileIterator } from './types.js';
-export default class SevenZipIterator extends BaseIterator {
-    lock: LockT;
+import BaseIterator, { Lock } from 'extract-base-iterator';
+import type { Entry, ExtractOptions, SevenZipFileIterator } from './types.js';
+export default class SevenZipIterator extends BaseIterator<Entry> {
+    lock: Lock | null;
     iterator: SevenZipFileIterator;
     constructor(source: string | NodeJS.ReadableStream, options?: ExtractOptions);
     end(err?: Error): void;

package/dist/cjs/SevenZipIterator.d.ts

@@ -1,7 +1,7 @@
-import BaseIterator from 'extract-base-iterator';
-import type { ExtractOptions, LockT, SevenZipFileIterator } from './types.js';
-export default class SevenZipIterator extends BaseIterator {
-    lock: LockT;
+import BaseIterator, { Lock } from 'extract-base-iterator';
+import type { Entry, ExtractOptions, SevenZipFileIterator } from './types.js';
+export default class SevenZipIterator extends BaseIterator<Entry> {
+    lock: Lock | null;
     iterator: SevenZipFileIterator;
     constructor(source: string | NodeJS.ReadableStream, options?: ExtractOptions);
     end(err?: Error): void;

package/dist/cjs/SevenZipIterator.js

@@ -8,14 +8,14 @@ Object.defineProperty(exports, "default", {
         return SevenZipIterator;
     }
 });
-var _extractbaseiterator = /*#__PURE__*/ _interop_require_default(require("extract-base-iterator"));
+var _extractbaseiterator = /*#__PURE__*/ _interop_require_wildcard(require("extract-base-iterator"));
 var _fs = /*#__PURE__*/ _interop_require_default(require("fs"));
+var _fsremovecompat = require("fs-remove-compat");
 var _path = /*#__PURE__*/ _interop_require_default(require("path"));
 var _queuecb = /*#__PURE__*/ _interop_require_default(require("queue-cb"));
 var _shorthash = /*#__PURE__*/ _interop_require_default(require("short-hash"));
 var _tempsuffix = /*#__PURE__*/ _interop_require_default(require("temp-suffix"));
 var _compatts = require("./compat.js");
-var _Lockts = /*#__PURE__*/ _interop_require_default(require("./lib/Lock.js"));
 var _streamToSourcets = /*#__PURE__*/ _interop_require_default(require("./lib/streamToSource.js"));
 var _nextEntryts = /*#__PURE__*/ _interop_require_default(require("./nextEntry.js"));
 var _indexts = require("./sevenz/codecs/index.js");
@@ -59,6 +59,47 @@ function _interop_require_default(obj) {
         default: obj
     };
 }
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interop_require_wildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
+        return {
+            default: obj
+        };
+    }
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
+    }
+    var newObj = {
+        __proto__: null
+    };
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
+            }
+        }
+    }
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
+}
 function _possible_constructor_return(self, call) {
     if (call && (_type_of(call) === "object" || typeof call === "function")) {
         return call;
@@ -116,8 +157,10 @@ var SevenZipIterator = /*#__PURE__*/ function(BaseIterator) {
         _this = _call_super(this, SevenZipIterator, [
             options
         ]);
-        _this.lock = new _Lockts.default();
-        _this.lock.iterator = _this;
+        _this.lock = new _extractbaseiterator.Lock();
+        _this.lock.onDestroy = function(err) {
+            return _extractbaseiterator.default.prototype.end.call(_this, err);
+        };
         var queue = new _queuecb.default(1);
         var cancelled = false;
         var archiveSource = null;
@@ -138,15 +181,22 @@ var SevenZipIterator = /*#__PURE__*/ function(BaseIterator) {
                         if (_this.done || cancelled) return;
                         if (err) return cb(err);
                         archiveSource = new _SevenZipParserts.FileSource(fd, stats.size);
-                        _this.lock.fd = fd;
+                        // Register cleanup for file descriptor
+                        _this.lock.registerCleanup(function() {
+                            _fs.default.closeSync(fd);
+                        });
                         cb();
                     });
                 });
             });
         } else {
             // Stream input - use hybrid memory/temp-file approach
-            // Store source stream in lock for cleanup if destroyed during download
-            _this.lock.sourceStream = source;
+            // Register cleanup for source stream
+            var stream = source;
+            _this.lock.registerCleanup(function() {
+                var s = stream;
+                if (typeof s.destroy === 'function') s.destroy();
+            });
             var tempPath = _path.default.join((0, _compatts.tmpdir)(), '7z-iterator', (0, _shorthash.default)(process.cwd()), (0, _tempsuffix.default)('tmp.7z'));
             queue.defer(function(cb) {
                 (0, _streamToSourcets.default)(source, {
@@ -158,10 +208,21 @@ var SevenZipIterator = /*#__PURE__*/ function(BaseIterator) {
                     if (!result) return cb(new Error('No result from streamToSource'));
                     archiveSource = result.source;
                     if (result.fd !== undefined) {
-                        _this.lock.fd = result.fd;
+                        var fd = result.fd;
+                        // Register cleanup for file descriptor
+                        _this.lock.registerCleanup(function() {
+                            _fs.default.closeSync(fd);
+                        });
                     }
                     if (result.tempPath) {
-                        _this.lock.tempPath = result.tempPath;
+                        var tp = result.tempPath;
+                        // Register cleanup for temp file
+                        _this.lock.registerCleanup(function() {
+                            try {
+                                (0, _fsremovecompat.rmSync)(tp);
+                            } catch (_e) {
+                            /* ignore */ }
+                        });
                     }
                     cb();
                 });

package/dist/cjs/SevenZipIterator.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/iterators/7z-iterator/src/SevenZipIterator.ts"],"sourcesContent":["import BaseIterator from 'extract-base-iterator';\nimport fs from 'fs';\nimport path from 'path';\nimport Queue from 'queue-cb';\nimport shortHash from 'short-hash';\nimport tempSuffix from 'temp-suffix';\nimport { tmpdir } from './compat.ts';\nimport Lock from './lib/Lock.ts';\nimport streamToSource, { type SourceResult } from './lib/streamToSource.ts';\nimport nextEntry from './nextEntry.ts';\nimport { setPassword } from './sevenz/codecs/index.ts';\nimport { type ArchiveSource, FileSource, type SevenZipEntry, SevenZipParser } from './sevenz/SevenZipParser.ts';\n\nimport type { ExtractOptions, LockT, SevenZipFileIterator } from './types.ts';\n\n/**\n * Iterator wrapper around SevenZipParser entries\n */\nclass EntryIterator implements SevenZipFileIterator {\n  private parser: SevenZipParser;\n  private entries: SevenZipEntry[];\n  private index = 0;\n\n  constructor(parser: SevenZipParser) {\n    this.parser = parser;\n    this.entries = parser.getEntries();\n  }\n\n  next(): SevenZipEntry | null {\n    if (this.index >= this.entries.length) {\n      return null;\n    }\n    return this.entries[this.index++];\n  }\n\n  getParser(): SevenZipParser {\n    return this.parser;\n  }\n}\n\nexport default class SevenZipIterator extends BaseIterator {\n  lock: LockT;\n  iterator: SevenZipFileIterator;\n\n  constructor(source: string | NodeJS.ReadableStream, options: ExtractOptions = {}) {\n    super(options);\n    this.lock = new Lock();\n    this.lock.iterator = this;\n    const queue = new Queue(1);\n    let cancelled = false;\n    let archiveSource: ArchiveSource | null = null;\n    const setup = (): undefined => {\n      cancelled = true;\n      return undefined;\n    };\n    this.processing.push(setup);\n\n    // Set password (or clear if not provided)\n    setPassword(options.password || null);\n\n    if (typeof source === 'string') {\n      // File path input - use FileSource directly\n      queue.defer((cb: (err?: Error) => void) => {\n        fs.stat(source, (statErr, stats) => {\n          if (this.done || cancelled) return;\n          if (statErr) return cb(statErr);\n\n          fs.open(source, 'r', (err, fd) => {\n            if (this.done || cancelled) return;\n            if (err) return cb(err);\n\n            archiveSource = new FileSource(fd, stats.size);\n            this.lock.fd = fd;\n            cb();\n          });\n        });\n      });\n    } else {\n      // Stream input - use hybrid memory/temp-file approach\n      // Store source stream in lock for cleanup if destroyed during download\n      this.lock.sourceStream = source as NodeJS.ReadableStream;\n      const tempPath = path.join(tmpdir(), '7z-iterator', shortHash(process.cwd()), tempSuffix('tmp.7z'));\n      queue.defer((cb: (err?: Error) => void) => {\n        streamToSource(\n          source,\n          {\n            memoryThreshold: options.memoryThreshold,\n            tempPath: tempPath,\n          },\n          (err?: Error, result?: SourceResult) => {\n            if (this.done || cancelled) return;\n            if (err) return cb(err);\n            if (!result) return cb(new Error('No result from streamToSource'));\n\n            archiveSource = result.source;\n            if (result.fd !== undefined) {\n              this.lock.fd = result.fd;\n            }\n            if (result.tempPath) {\n              this.lock.tempPath = result.tempPath;\n            }\n            cb();\n          }\n        );\n      });\n    }\n\n    // Parse and build iterator\n    queue.defer((cb: (err?: Error) => void) => {\n      if (this.done || cancelled) return;\n      if (!archiveSource) return cb(new Error('No archive source'));\n\n      try {\n        const parser = new SevenZipParser(archiveSource);\n        parser.parse();\n        this.iterator = new EntryIterator(parser);\n        cb();\n      } catch (parseErr) {\n        cb(parseErr as Error);\n      }\n    });\n\n    // start processing\n    queue.await((err?: Error) => {\n      this.processing.remove(setup);\n      if (this.done || cancelled) return;\n      err ? this.end(err) : this.push(nextEntry);\n    });\n  }\n\n  end(err?: Error) {\n    if (this.lock) {\n      const lock = this.lock;\n      this.lock = null; // Clear before release to prevent re-entrancy\n      lock.err = err;\n      lock.release();\n    }\n    // Don't call base end here - Lock.__destroy() handles it\n    this.iterator = null;\n  }\n}\n"],"names":["SevenZipIterator","EntryIterator","parser","index","entries","getEntries","next","length","getParser","source","options","lock","Lock","iterator","queue","Queue","cancelled","archiveSource","setup","undefined","processing","push","setPassword","password","defer","cb","fs","stat","statErr","stats","done","open","err","fd","FileSource","size","sourceStream","tempPath","path","join","tmpdir","shortHash","process","cwd","tempSuffix","streamToSource","memoryThreshold","result","Error","SevenZipParser","parse","parseErr","await","remove","end","nextEntry","release","BaseIterator"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/iterators/7z-iterator/src/SevenZipIterator.ts"],"sourcesContent":["import BaseIterator, { Lock } from 'extract-base-iterator';\nimport fs from 'fs';\nimport { rmSync } from 'fs-remove-compat';\nimport path from 'path';\nimport Queue from 'queue-cb';\nimport shortHash from 'short-hash';\nimport tempSuffix from 'temp-suffix';\nimport { tmpdir } from './compat.ts';\nimport streamToSource, { type SourceResult } from './lib/streamToSource.ts';\nimport nextEntry from './nextEntry.ts';\nimport { setPassword } from './sevenz/codecs/index.ts';\nimport { type ArchiveSource, FileSource, type SevenZipEntry, SevenZipParser } from './sevenz/SevenZipParser.ts';\n\nimport type { Entry, ExtractOptions, SevenZipFileIterator } from './types.ts';\n\n/**\n * Iterator wrapper around SevenZipParser entries\n */\nclass EntryIterator implements SevenZipFileIterator {\n  private parser: SevenZipParser;\n  private entries: SevenZipEntry[];\n  private index = 0;\n\n  constructor(parser: SevenZipParser) {\n    this.parser = parser;\n    this.entries = parser.getEntries();\n  }\n\n  next(): SevenZipEntry | null {\n    if (this.index >= this.entries.length) {\n      return null;\n    }\n    return this.entries[this.index++];\n  }\n\n  getParser(): SevenZipParser {\n    return this.parser;\n  }\n}\n\nexport default class SevenZipIterator extends BaseIterator<Entry> {\n  lock: Lock | null;\n  iterator: SevenZipFileIterator;\n\n  constructor(source: string | NodeJS.ReadableStream, options: ExtractOptions = {}) {\n    super(options);\n    this.lock = new Lock();\n    this.lock.onDestroy = (err) => BaseIterator.prototype.end.call(this, err);\n    const queue = new Queue(1);\n    let cancelled = false;\n    let archiveSource: ArchiveSource | null = null;\n    const setup = (): undefined => {\n      cancelled = true;\n      return undefined;\n    };\n    this.processing.push(setup);\n\n    // Set password (or clear if not provided)\n    setPassword(options.password || null);\n\n    if (typeof source === 'string') {\n      // File path input - use FileSource directly\n      queue.defer((cb: (err?: Error) => void) => {\n        fs.stat(source, (statErr, stats) => {\n          if (this.done || cancelled) return;\n          if (statErr) return cb(statErr);\n\n          fs.open(source, 'r', (err, fd) => {\n            if (this.done || cancelled) return;\n            if (err) return cb(err);\n\n            archiveSource = new FileSource(fd, stats.size);\n            // Register cleanup for file descriptor\n            this.lock.registerCleanup(() => {\n              fs.closeSync(fd);\n            });\n            cb();\n          });\n        });\n      });\n    } else {\n      // Stream input - use hybrid memory/temp-file approach\n      // Register cleanup for source stream\n      const stream = source as NodeJS.ReadableStream;\n      this.lock.registerCleanup(() => {\n        const s = stream as NodeJS.ReadableStream & { destroy?: () => void };\n        if (typeof s.destroy === 'function') s.destroy();\n      });\n\n      const tempPath = path.join(tmpdir(), '7z-iterator', shortHash(process.cwd()), tempSuffix('tmp.7z'));\n      queue.defer((cb: (err?: Error) => void) => {\n        streamToSource(\n          source,\n          {\n            memoryThreshold: options.memoryThreshold,\n            tempPath: tempPath,\n          },\n          (err?: Error, result?: SourceResult) => {\n            if (this.done || cancelled) return;\n            if (err) return cb(err);\n            if (!result) return cb(new Error('No result from streamToSource'));\n\n            archiveSource = result.source;\n            if (result.fd !== undefined) {\n              const fd = result.fd;\n              // Register cleanup for file descriptor\n              this.lock.registerCleanup(() => {\n                fs.closeSync(fd);\n              });\n            }\n            if (result.tempPath) {\n              const tp = result.tempPath;\n              // Register cleanup for temp file\n              this.lock.registerCleanup(() => {\n                try {\n                  rmSync(tp);\n                } catch (_e) {\n                  /* ignore */\n                }\n              });\n            }\n            cb();\n          }\n        );\n      });\n    }\n\n    // Parse and build iterator\n    queue.defer((cb: (err?: Error) => void) => {\n      if (this.done || cancelled) return;\n      if (!archiveSource) return cb(new Error('No archive source'));\n\n      try {\n        const parser = new SevenZipParser(archiveSource);\n        parser.parse();\n        this.iterator = new EntryIterator(parser);\n        cb();\n      } catch (parseErr) {\n        cb(parseErr as Error);\n      }\n    });\n\n    // start processing\n    queue.await((err?: Error) => {\n      this.processing.remove(setup);\n      if (this.done || cancelled) return;\n      err ? this.end(err) : this.push(nextEntry);\n    });\n  }\n\n  end(err?: Error) {\n    if (this.lock) {\n      const lock = this.lock;\n      this.lock = null; // Clear before release to prevent re-entrancy\n      lock.err = err;\n      lock.release();\n    }\n    // Don't call base end here - Lock.__destroy() handles it\n    this.iterator = null;\n  }\n}\n"],"names":["SevenZipIterator","EntryIterator","parser","index","entries","getEntries","next","length","getParser","source","options","lock","Lock","onDestroy","err","BaseIterator","prototype","end","call","queue","Queue","cancelled","archiveSource","setup","undefined","processing","push","setPassword","password","defer","cb","fs","stat","statErr","stats","done","open","fd","FileSource","size","registerCleanup","closeSync","stream","s","destroy","tempPath","path","join","tmpdir","shortHash","process","cwd","tempSuffix","streamToSource","memoryThreshold","result","Error","tp","rmSync","_e","SevenZipParser","parse","iterator","parseErr","await","remove","nextEntry","release"],"mappings":"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"}

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

@@ -0,0 +1,40 @@
+/**
+ * ArchiveSource - Abstraction for reading 7z archive data
+ *
+ * Provides a common interface for reading archive data from either
+ * a file descriptor or an in-memory buffer.
+ */
+/**
+ * Archive source abstraction - allows reading from file descriptor or buffer
+ */
+export interface ArchiveSource {
+    read(position: number, length: number): Buffer;
+    getSize(): number;
+    close(): void;
+}
+/**
+ * Buffer-based archive source
+ *
+ * Used when the entire archive is already in memory.
+ */
+export declare class BufferSource implements ArchiveSource {
+    private buffer;
+    constructor(buffer: Buffer);
+    read(position: number, length: number): Buffer;
+    getSize(): number;
+    close(): void;
+}
+/**
+ * File descriptor based archive source
+ *
+ * Used for reading directly from a file on disk.
+ * More memory efficient for large archives.
+ */
+export declare class FileSource implements ArchiveSource {
+    private fd;
+    private size;
+    constructor(fd: number, size: number);
+    read(position: number, length: number): Buffer;
+    getSize(): number;
+    close(): void;
+}

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

@@ -0,0 +1,40 @@
+/**
+ * ArchiveSource - Abstraction for reading 7z archive data
+ *
+ * Provides a common interface for reading archive data from either
+ * a file descriptor or an in-memory buffer.
+ */
+/**
+ * Archive source abstraction - allows reading from file descriptor or buffer
+ */
+export interface ArchiveSource {
+    read(position: number, length: number): Buffer;
+    getSize(): number;
+    close(): void;
+}
+/**
+ * Buffer-based archive source
+ *
+ * Used when the entire archive is already in memory.
+ */
+export declare class BufferSource implements ArchiveSource {
+    private buffer;
+    constructor(buffer: Buffer);
+    read(position: number, length: number): Buffer;
+    getSize(): number;
+    close(): void;
+}
+/**
+ * File descriptor based archive source
+ *
+ * Used for reading directly from a file on disk.
+ * More memory efficient for large archives.
+ */
+export declare class FileSource implements ArchiveSource {
+    private fd;
+    private size;
+    constructor(fd: number, size: number);
+    read(position: number, length: number): Buffer;
+    getSize(): number;
+    close(): void;
+}

package/dist/cjs/sevenz/ArchiveSource.js

@@ -0,0 +1,82 @@
+/**
+ * ArchiveSource - Abstraction for reading 7z archive data
+ *
+ * Provides a common interface for reading archive data from either
+ * a file descriptor or an in-memory buffer.
+ */ "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 BufferSource () {
+        return BufferSource;
+    },
+    get FileSource () {
+        return FileSource;
+    }
+});
+var _extractbaseiterator = require("extract-base-iterator");
+var _fs = /*#__PURE__*/ _interop_require_default(require("fs"));
+function _class_call_check(instance, Constructor) {
+    if (!(instance instanceof Constructor)) {
+        throw new TypeError("Cannot call a class as a function");
+    }
+}
+function _interop_require_default(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+var BufferSource = /*#__PURE__*/ function() {
+    "use strict";
+    function BufferSource(buffer) {
+        _class_call_check(this, BufferSource);
+        this.buffer = buffer;
+    }
+    var _proto = BufferSource.prototype;
+    _proto.read = function read(position, length) {
+        return this.buffer.slice(position, position + length);
+    };
+    _proto.getSize = function getSize() {
+        return this.buffer.length;
+    };
+    _proto.close = function close() {
+    // Nothing to close for buffer
+    };
+    return BufferSource;
+}();
+var FileSource = /*#__PURE__*/ function() {
+    "use strict";
+    function FileSource(fd, size) {
+        _class_call_check(this, FileSource);
+        this.fd = fd;
+        this.size = size;
+    }
+    var _proto = FileSource.prototype;
+    _proto.read = function read(position, length) {
+        var buf = (0, _extractbaseiterator.allocBuffer)(length);
+        var bytesRead = _fs.default.readSync(this.fd, buf, 0, length, position);
+        if (bytesRead < length) {
+            return buf.slice(0, bytesRead);
+        }
+        return buf;
+    };
+    _proto.getSize = function getSize() {
+        return this.size;
+    };
+    _proto.close = function close() {
+        try {
+            _fs.default.closeSync(this.fd);
+        } catch (_e) {
+        // Ignore close errors
+        }
+    };
+    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

@@ -0,0 +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"}

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/iterators/7z-iterator/src/sevenz/NumberCodec.ts"],"sourcesContent":["// Variable-length integer encoding for 7z format\n// Reference: https://py7zr.readthedocs.io/en/latest/archive_format.html\n//\n// 7z uses a space-efficient encoding where the first byte determines length:\n// 0xxxxxxx                    -> 1 byte  (0-127)\n// 10xxxxxx xxxxxxxx           -> 2 bytes (0-16383)\n// 110xxxxx + 2 bytes          -> 3 bytes\n// 1110xxxx + 3 bytes          -> 4 bytes\n// 11110xxx + 4 bytes          -> 5 bytes\n// 111110xx + 5 bytes          -> 6 bytes\n// 1111110x + 6 bytes          -> 7 bytes\n// 11111110 + 7 bytes          -> 8 bytes\n// 11111111 + 8 bytes          -> 9 bytes (full 64-bit)\n//\n// NOTE: Returns JavaScript number which is accurate up to 2^53 - 1 (~9 PB).\n// This covers all practical file sizes.\n\nimport { readUInt64LE } from 'extract-base-iterator';\n\nexport interface NumberReadResult {\n  value: number;\n  bytesRead: number;\n}\n\n/**\n * Read a variable-length encoded number from a buffer\n * Uses 7z's variable-length uint64 encoding where the first byte indicates\n * how many additional bytes follow based on its value:\n * - 0x00-0x7F: 0 extra bytes (7 bits of data)\n * - 0x80-0xBF: 1 extra byte (14 bits of data)\n * - 0xC0-0xDF: 2 extra bytes (21 bits of data)\n * - 0xE0-0xEF: 3 extra bytes (28 bits of data)\n * - etc.\n * - 0xFF: 8 extra bytes (full 64-bit value)\n *\n * @param buf - Buffer containing encoded number\n * @param offset - Offset to start reading from\n * @returns Object with value and number of bytes consumed\n */\nexport function readNumber(buf: Buffer, offset: number): NumberReadResult {\n  const firstByte = buf[offset];\n\n  // Special case: 0xFF means 8 extra bytes (full 64-bit value)\n  if (firstByte === 0xff) {\n    return {\n      value: readUInt64LE(buf, offset + 1),\n      bytesRead: 9,\n    };\n  }\n\n  // Determine number of extra bytes based on first byte value thresholds\n  // This matches the 7z format specification\n  let extraBytes = 0;\n  let mask = 0x80;\n\n  if (firstByte <= 0x7f) {\n    extraBytes = 0;\n    mask = 0x80;\n  } else if (firstByte <= 0xbf) {\n    extraBytes = 1;\n    mask = 0x40;\n  } else if (firstByte <= 0xdf) {\n    extraBytes = 2;\n    mask = 0x20;\n  } else if (firstByte <= 0xef) {\n    extraBytes = 3;\n    mask = 0x10;\n  } else if (firstByte <= 0xf7) {\n    extraBytes = 4;\n    mask = 0x08;\n  } else if (firstByte <= 0xfb) {\n    extraBytes = 5;\n    mask = 0x04;\n  } else if (firstByte <= 0xfd) {\n    extraBytes = 6;\n    mask = 0x02;\n  } else {\n    // 0xFE\n    extraBytes = 7;\n    mask = 0x01;\n  }\n\n  // Get high part from first byte (bits below the length indicator)\n  const highPart = firstByte & (mask - 1);\n\n  // Read extra bytes as LITTLE-ENDIAN\n  let value = 0;\n  for (let i = 0; i < extraBytes; i++) {\n    value += buf[offset + 1 + i] * 256 ** i;\n  }\n\n  // Combine: value + (highPart << (extraBytes * 8))\n  value += highPart * 256 ** extraBytes;\n\n  return {\n    value: value,\n    bytesRead: 1 + extraBytes,\n  };\n}\n\n/**\n * Read a raw 64-bit little-endian number (used in some fixed-size fields)\n * @param buf - Buffer containing the number\n * @param offset - Offset to start reading from\n * @returns The number value\n */\nexport function readRawNumber(buf: Buffer, offset: number): number {\n  return readUInt64LE(buf, offset);\n}\n\n/**\n * Calculate the encoded size of a number\n * @param value - The number to encode\n * @returns Number of bytes needed to encode the value\n */\nexport function encodedSize(value: number): number {\n  if (value < 0x80) return 1; // 7 bits\n  if (value < 0x4000) return 2; // 14 bits\n  if (value < 0x200000) return 3; // 21 bits\n  if (value < 0x10000000) return 4; // 28 bits\n  if (value < 0x800000000) return 5; // 35 bits\n  if (value < 0x40000000000) return 6; // 42 bits\n  if (value < 0x2000000000000) return 7; // 49 bits\n  // 2^56 = 72057594037927936 (use calculated value to avoid precision loss)\n  if (value < 72057594037927936) return 8; // 56 bits\n  return 9; // 64 bits\n}\n\n/**\n * Read a boolean encoded as a single byte\n * @param buf - Buffer to read from\n * @param offset - Offset to read from\n * @returns true if byte is non-zero\n */\nexport function readBoolean(buf: Buffer, offset: number): boolean {\n  return buf[offset] !== 0;\n}\n\n/**\n * Read a \"defined\" bitmask for an array of items.\n * Used when some items in a list have optional values.\n *\n * Format: If \"allDefined\" byte is 0, a bitmask follows indicating which items have values.\n * If \"allDefined\" byte is non-zero, all items are defined.\n *\n * @param buf - Buffer to read from\n * @param offset - Offset to start reading\n * @param count - Number of items\n * @returns Object with defined array and bytes consumed\n */\nexport function readDefinedVector(buf: Buffer, offset: number, count: number): { defined: boolean[]; bytesRead: number } {\n  const allDefined = buf[offset] !== 0;\n  let bytesRead = 1;\n  const defined: boolean[] = [];\n\n  if (allDefined) {\n    // All items are defined\n    for (let i = 0; i < count; i++) {\n      defined.push(true);\n    }\n  } else {\n    // Read bitmask\n    const bitsNeeded = count;\n    const bytesNeeded = Math.ceil(bitsNeeded / 8);\n\n    for (let byteIdx = 0; byteIdx < bytesNeeded; byteIdx++) {\n      const byte = buf[offset + 1 + byteIdx];\n      for (let bit = 7; bit >= 0 && defined.length < count; bit--) {\n        defined.push((byte & (1 << bit)) !== 0);\n      }\n    }\n    bytesRead += bytesNeeded;\n  }\n\n  return { defined: defined, bytesRead: bytesRead };\n}\n\n/**\n * Read an array of variable-length numbers\n * @param buf - Buffer to read from\n * @param offset - Offset to start reading\n * @param count - Number of items to read\n * @returns Object with values array and bytes consumed\n */\nexport function readNumberArray(buf: Buffer, offset: number, count: number): { values: number[]; bytesRead: number } {\n  const values: number[] = [];\n  let totalBytesRead = 0;\n\n  for (let i = 0; i < count; i++) {\n    const result = readNumber(buf, offset + totalBytesRead);\n    values.push(result.value);\n    totalBytesRead += result.bytesRead;\n  }\n\n  return { values: values, bytesRead: totalBytesRead };\n}\n"],"names":["encodedSize","readBoolean","readDefinedVector","readNumber","readNumberArray","readRawNumber","buf","offset","firstByte","value","readUInt64LE","bytesRead","extraBytes","mask","highPart","i","count","allDefined","defined","push","bitsNeeded","bytesNeeded","Math","ceil","byteIdx","byte","bit","length","values","totalBytesRead","result"],"mappings":"AAAA,iDAAiD;AACjD,wEAAwE;AACxE,EAAE;AACF,6EAA6E;AAC7E,iDAAiD;AACjD,mDAAmD;AACnD,yCAAyC;AACzC,yCAAyC;AACzC,yCAAyC;AACzC,yCAAyC;AACzC,yCAAyC;AACzC,yCAAyC;AACzC,uDAAuD;AACvD,EAAE;AACF,4EAA4E;AAC5E,wCAAwC;;;;;;;;;;;;QAoGxBA;eAAAA;;QAmBAC;eAAAA;;QAgBAC;eAAAA;;QA/GAC;eAAAA;;QAiJAC;eAAAA;;QA9EAC;eAAAA;;;mCAzFa;AAsBtB,SAASF,WAAWG,GAAW,EAAEC,MAAc;IACpD,IAAMC,YAAYF,GAAG,CAACC,OAAO;IAE7B,6DAA6D;IAC7D,IAAIC,cAAc,MAAM;QACtB,OAAO;YACLC,OAAOC,IAAAA,iCAAY,EAACJ,KAAKC,SAAS;YAClCI,WAAW;QACb;IACF;IAEA,uEAAuE;IACvE,2CAA2C;IAC3C,IAAIC,aAAa;IACjB,IAAIC,OAAO;IAEX,IAAIL,aAAa,MAAM;QACrBI,aAAa;QACbC,OAAO;IACT,OAAO,IAAIL,aAAa,MAAM;QAC5BI,aAAa;QACbC,OAAO;IACT,OAAO,IAAIL,aAAa,MAAM;QAC5BI,aAAa;QACbC,OAAO;IACT,OAAO,IAAIL,aAAa,MAAM;QAC5BI,aAAa;QACbC,OAAO;IACT,OAAO,IAAIL,aAAa,MAAM;QAC5BI,aAAa;QACbC,OAAO;IACT,OAAO,IAAIL,aAAa,MAAM;QAC5BI,aAAa;QACbC,OAAO;IACT,OAAO,IAAIL,aAAa,MAAM;QAC5BI,aAAa;QACbC,OAAO;IACT,OAAO;QACL,OAAO;QACPD,aAAa;QACbC,OAAO;IACT;IAEA,kEAAkE;IAClE,IAAMC,WAAWN,YAAaK,OAAO;IAErC,oCAAoC;IACpC,IAAIJ,QAAQ;IACZ,IAAK,IAAIM,IAAI,GAAGA,IAAIH,YAAYG,IAAK;QACnCN,SAASH,GAAG,CAACC,SAAS,IAAIQ,EAAE,GAAG,KAAA,IAAA,KAAOA;IACxC;IAEA,kDAAkD;IAClDN,SAASK,WAAW,KAAA,IAAA,KAAOF;IAE3B,OAAO;QACLH,OAAOA;QACPE,WAAW,IAAIC;IACjB;AACF;AAQO,SAASP,cAAcC,GAAW,EAAEC,MAAc;IACvD,OAAOG,IAAAA,iCAAY,EAACJ,KAAKC;AAC3B;AAOO,SAASP,YAAYS,KAAa;IACvC,IAAIA,QAAQ,MAAM,OAAO,GAAG,SAAS;IACrC,IAAIA,QAAQ,QAAQ,OAAO,GAAG,UAAU;IACxC,IAAIA,QAAQ,UAAU,OAAO,GAAG,UAAU;IAC1C,IAAIA,QAAQ,YAAY,OAAO,GAAG,UAAU;IAC5C,IAAIA,QAAQ,aAAa,OAAO,GAAG,UAAU;IAC7C,IAAIA,QAAQ,eAAe,OAAO,GAAG,UAAU;IAC/C,IAAIA,QAAQ,iBAAiB,OAAO,GAAG,UAAU;IACjD,0EAA0E;IAC1E,IAAIA,QAAQ,mBAAmB,OAAO,GAAG,UAAU;IACnD,OAAO,GAAG,UAAU;AACtB;AAQO,SAASR,YAAYK,GAAW,EAAEC,MAAc;IACrD,OAAOD,GAAG,CAACC,OAAO,KAAK;AACzB;AAcO,SAASL,kBAAkBI,GAAW,EAAEC,MAAc,EAAES,KAAa;IAC1E,IAAMC,aAAaX,GAAG,CAACC,OAAO,KAAK;IACnC,IAAII,YAAY;IAChB,IAAMO,UAAqB,EAAE;IAE7B,IAAID,YAAY;QACd,wBAAwB;QACxB,IAAK,IAAIF,IAAI,GAAGA,IAAIC,OAAOD,IAAK;YAC9BG,QAAQC,IAAI,CAAC;QACf;IACF,OAAO;QACL,eAAe;QACf,IAAMC,aAAaJ;QACnB,IAAMK,cAAcC,KAAKC,IAAI,CAACH,aAAa;QAE3C,IAAK,IAAII,UAAU,GAAGA,UAAUH,aAAaG,UAAW;YACtD,IAAMC,OAAOnB,GAAG,CAACC,SAAS,IAAIiB,QAAQ;YACtC,IAAK,IAAIE,MAAM,GAAGA,OAAO,KAAKR,QAAQS,MAAM,GAAGX,OAAOU,MAAO;gBAC3DR,QAAQC,IAAI,CAAC,AAACM,CAAAA,OAAQ,KAAKC,GAAG,MAAO;YACvC;QACF;QACAf,aAAaU;IACf;IAEA,OAAO;QAAEH,SAASA;QAASP,WAAWA;IAAU;AAClD;AASO,SAASP,gBAAgBE,GAAW,EAAEC,MAAc,EAAES,KAAa;IACxE,IAAMY,SAAmB,EAAE;IAC3B,IAAIC,iBAAiB;IAErB,IAAK,IAAId,IAAI,GAAGA,IAAIC,OAAOD,IAAK;QAC9B,IAAMe,SAAS3B,WAAWG,KAAKC,SAASsB;QACxCD,OAAOT,IAAI,CAACW,OAAOrB,KAAK;QACxBoB,kBAAkBC,OAAOnB,SAAS;IACpC;IAEA,OAAO;QAAEiB,QAAQA;QAAQjB,WAAWkB;IAAe;AACrD"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/iterators/7z-iterator/src/sevenz/NumberCodec.ts"],"sourcesContent":["// Variable-length integer encoding for 7z format\n// Reference: https://py7zr.readthedocs.io/en/latest/archive_format.html\n//\n// 7z uses a space-efficient encoding where the first byte determines length:\n// 0xxxxxxx                    -> 1 byte  (0-127)\n// 10xxxxxx xxxxxxxx           -> 2 bytes (0-16383)\n// 110xxxxx + 2 bytes          -> 3 bytes\n// 1110xxxx + 3 bytes          -> 4 bytes\n// 11110xxx + 4 bytes          -> 5 bytes\n// 111110xx + 5 bytes          -> 6 bytes\n// 1111110x + 6 bytes          -> 7 bytes\n// 11111110 + 7 bytes          -> 8 bytes\n// 11111111 + 8 bytes          -> 9 bytes (full 64-bit)\n//\n// NOTE: Returns JavaScript number which is accurate up to 2^53 - 1 (~9 PB).\n// This covers all practical file sizes.\n\nimport { readUInt64LE } from 'extract-base-iterator';\n\nexport interface NumberReadResult {\n  value: number;\n  bytesRead: number;\n}\n\n/**\n * Read a variable-length encoded number from a buffer\n * Uses 7z's variable-length uint64 encoding where the first byte indicates\n * how many additional bytes follow based on its value:\n * - 0x00-0x7F: 0 extra bytes (7 bits of data)\n * - 0x80-0xBF: 1 extra byte (14 bits of data)\n * - 0xC0-0xDF: 2 extra bytes (21 bits of data)\n * - 0xE0-0xEF: 3 extra bytes (28 bits of data)\n * - etc.\n * - 0xFF: 8 extra bytes (full 64-bit value)\n *\n * @param buf - Buffer containing encoded number\n * @param offset - Offset to start reading from\n * @returns Object with value and number of bytes consumed\n */\nexport function readNumber(buf: Buffer, offset: number): NumberReadResult {\n  const firstByte = buf[offset];\n\n  // Special case: 0xFF means 8 extra bytes (full 64-bit value)\n  if (firstByte === 0xff) {\n    return {\n      value: readUInt64LE(buf, offset + 1),\n      bytesRead: 9,\n    };\n  }\n\n  // Determine number of extra bytes based on first byte value thresholds\n  // This matches the 7z format specification\n  let extraBytes = 0;\n  let mask = 0x80;\n\n  if (firstByte <= 0x7f) {\n    extraBytes = 0;\n    mask = 0x80;\n  } else if (firstByte <= 0xbf) {\n    extraBytes = 1;\n    mask = 0x40;\n  } else if (firstByte <= 0xdf) {\n    extraBytes = 2;\n    mask = 0x20;\n  } else if (firstByte <= 0xef) {\n    extraBytes = 3;\n    mask = 0x10;\n  } else if (firstByte <= 0xf7) {\n    extraBytes = 4;\n    mask = 0x08;\n  } else if (firstByte <= 0xfb) {\n    extraBytes = 5;\n    mask = 0x04;\n  } else if (firstByte <= 0xfd) {\n    extraBytes = 6;\n    mask = 0x02;\n  } else {\n    // 0xFE\n    extraBytes = 7;\n    mask = 0x01;\n  }\n\n  // Get high part from first byte (bits below the length indicator)\n  const highPart = firstByte & (mask - 1);\n\n  // Read extra bytes as LITTLE-ENDIAN\n  let value = 0;\n  for (let i = 0; i < extraBytes; i++) {\n    value += buf[offset + 1 + i] * 256 ** i;\n  }\n\n  // Combine: value + (highPart << (extraBytes * 8))\n  value += highPart * 256 ** extraBytes;\n\n  return {\n    value: value,\n    bytesRead: 1 + extraBytes,\n  };\n}\n\n/**\n * Read a raw 64-bit little-endian number (used in some fixed-size fields)\n * @param buf - Buffer containing the number\n * @param offset - Offset to start reading from\n * @returns The number value\n */\nexport function readRawNumber(buf: Buffer, offset: number): number {\n  return readUInt64LE(buf, offset);\n}\n\n/**\n * Calculate the encoded size of a number\n * @param value - The number to encode\n * @returns Number of bytes needed to encode the value\n */\nexport function encodedSize(value: number): number {\n  if (value < 0x80) return 1; // 7 bits\n  if (value < 0x4000) return 2; // 14 bits\n  if (value < 0x200000) return 3; // 21 bits\n  if (value < 0x10000000) return 4; // 28 bits\n  if (value < 0x800000000) return 5; // 35 bits\n  if (value < 0x40000000000) return 6; // 42 bits\n  if (value < 0x2000000000000) return 7; // 49 bits\n  // 2^56 = 72057594037927936 (use calculated value to avoid precision loss)\n  if (value < 72057594037927936) return 8; // 56 bits\n  return 9; // 64 bits\n}\n\n/**\n * Read a boolean encoded as a single byte\n * @param buf - Buffer to read from\n * @param offset - Offset to read from\n * @returns true if byte is non-zero\n */\nexport function readBoolean(buf: Buffer, offset: number): boolean {\n  return buf[offset] !== 0;\n}\n\n/**\n * Read a \"defined\" bitmask for an array of items.\n * Used when some items in a list have optional values.\n *\n * Format: If \"allDefined\" byte is 0, a bitmask follows indicating which items have values.\n * If \"allDefined\" byte is non-zero, all items are defined.\n *\n * @param buf - Buffer to read from\n * @param offset - Offset to start reading\n * @param count - Number of items\n * @returns Object with defined array and bytes consumed\n */\nexport function readDefinedVector(buf: Buffer, offset: number, count: number): { defined: boolean[]; bytesRead: number } {\n  const allDefined = buf[offset] !== 0;\n  let bytesRead = 1;\n  const defined: boolean[] = [];\n\n  if (allDefined) {\n    // All items are defined\n    for (let i = 0; i < count; i++) {\n      defined.push(true);\n    }\n  } else {\n    // Read bitmask\n    const bitsNeeded = count;\n    const bytesNeeded = Math.ceil(bitsNeeded / 8);\n\n    for (let byteIdx = 0; byteIdx < bytesNeeded; byteIdx++) {\n      const byte = buf[offset + 1 + byteIdx];\n      for (let bit = 7; bit >= 0 && defined.length < count; bit--) {\n        defined.push((byte & (1 << bit)) !== 0);\n      }\n    }\n    bytesRead += bytesNeeded;\n  }\n\n  return { defined: defined, bytesRead: bytesRead };\n}\n\n/**\n * Read an array of variable-length numbers\n * @param buf - Buffer to read from\n * @param offset - Offset to start reading\n * @param count - Number of items to read\n * @returns Object with values array and bytes consumed\n */\nexport function readNumberArray(buf: Buffer, offset: number, count: number): { values: number[]; bytesRead: number } {\n  const values: number[] = [];\n  let totalBytesRead = 0;\n\n  for (let i = 0; i < count; i++) {\n    const result = readNumber(buf, offset + totalBytesRead);\n    values.push(result.value);\n    totalBytesRead += result.bytesRead;\n  }\n\n  return { values: values, bytesRead: totalBytesRead };\n}\n"],"names":["encodedSize","readBoolean","readDefinedVector","readNumber","readNumberArray","readRawNumber","buf","offset","firstByte","value","readUInt64LE","bytesRead","extraBytes","mask","highPart","i","count","allDefined","defined","push","bitsNeeded","bytesNeeded","Math","ceil","byteIdx","byte","bit","length","values","totalBytesRead","result"],"mappings":"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"}

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

@@ -1,5 +1,26 @@
+/**
+ * SevenZipParser - Main 7z archive parser
+ *
+ * Handles reading archive structure and providing file streams.
+ *
+ * Parser Flow:
+ * 1. Read signature header (32 bytes) to get header location
+ * 2. Read encoded header from nextHeaderOffset
+ * 3. If header is compressed, decompress it first
+ * 4. Parse streams info (folder structure, pack positions)
+ * 5. Parse files info (names, sizes, attributes)
+ * 6. Build entry list for iteration
+ *
+ * Decompression:
+ * - 7z uses "folders" as decompression units
+ * - Solid archives: multiple files share one folder (decompress once)
+ * - Non-solid: one file per folder
+ * - Supports LZMA, LZMA2, COPY, BCJ2, and other codecs
+ */
 import Stream from 'stream';
+import type { ArchiveSource } from './ArchiveSource.js';
 type Readable = Stream.Readable;
+export { type ArchiveSource, BufferSource, FileSource } from './ArchiveSource.js';
 export interface SevenZipEntry {
     name: string;
     path: string;
@@ -16,35 +37,6 @@ export interface SevenZipEntry {
     _hasStream: boolean;
     _crc?: number;
 }
-/**
- * Archive source abstraction - allows reading from file descriptor or buffer
- */
-export interface ArchiveSource {
-    read(position: number, length: number): Buffer;
-    getSize(): number;
-    close(): void;
-}
-/**
- * Buffer-based archive source
- */
-export declare class BufferSource implements ArchiveSource {
-    private buffer;
-    constructor(buffer: Buffer);
-    read(position: number, length: number): Buffer;
-    getSize(): number;
-    close(): void;
-}
-/**
- * File descriptor based archive source
- */
-export declare class FileSource implements ArchiveSource {
-    private fd;
-    private size;
-    constructor(fd: number, size: number);
-    read(position: number, length: number): Buffer;
-    getSize(): number;
-    close(): void;
-}
 /**
  * SevenZipParser - parses 7z archives and provides entry iteration
  */
@@ -122,4 +114,3 @@ export declare class SevenZipParser {
      */
     close(): void;
 }
-export {};

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

@@ -1,5 +1,26 @@
+/**
+ * SevenZipParser - Main 7z archive parser
+ *
+ * Handles reading archive structure and providing file streams.
+ *
+ * Parser Flow:
+ * 1. Read signature header (32 bytes) to get header location
+ * 2. Read encoded header from nextHeaderOffset
+ * 3. If header is compressed, decompress it first
+ * 4. Parse streams info (folder structure, pack positions)
+ * 5. Parse files info (names, sizes, attributes)
+ * 6. Build entry list for iteration
+ *
+ * Decompression:
+ * - 7z uses "folders" as decompression units
+ * - Solid archives: multiple files share one folder (decompress once)
+ * - Non-solid: one file per folder
+ * - Supports LZMA, LZMA2, COPY, BCJ2, and other codecs
+ */
 import Stream from 'stream';
+import type { ArchiveSource } from './ArchiveSource.js';
 type Readable = Stream.Readable;
+export { type ArchiveSource, BufferSource, FileSource } from './ArchiveSource.js';
 export interface SevenZipEntry {
     name: string;
     path: string;
@@ -16,35 +37,6 @@ export interface SevenZipEntry {
     _hasStream: boolean;
     _crc?: number;
 }
-/**
- * Archive source abstraction - allows reading from file descriptor or buffer
- */
-export interface ArchiveSource {
-    read(position: number, length: number): Buffer;
-    getSize(): number;
-    close(): void;
-}
-/**
- * Buffer-based archive source
- */
-export declare class BufferSource implements ArchiveSource {
-    private buffer;
-    constructor(buffer: Buffer);
-    read(position: number, length: number): Buffer;
-    getSize(): number;
-    close(): void;
-}
-/**
- * File descriptor based archive source
- */
-export declare class FileSource implements ArchiveSource {
-    private fd;
-    private size;
-    constructor(fd: number, size: number);
-    read(position: number, length: number): Buffer;
-    getSize(): number;
-    close(): void;
-}
 /**
  * SevenZipParser - parses 7z archives and provides entry iteration
  */
@@ -122,4 +114,3 @@ export declare class SevenZipParser {
      */
     close(): void;
 }
-export {};