extract-base-iterator 2.2.6 → 2.3.1

package/dist/cjs/index.d.cts

@@ -7,5 +7,6 @@ export { default as DirectoryEntry } from './DirectoryEntry.js';
 export { default as FileEntry } from './FileEntry.js';
 export { default as LinkEntry } from './LinkEntry.js';
 export { default as SymbolicLinkEntry } from './SymbolicLinkEntry.js';
+export * from './shared/index.js';
 export * from './types.js';
 export { default as waitForAccess } from './waitForAccess.js';

package/dist/cjs/index.d.ts

@@ -7,5 +7,6 @@ export { default as DirectoryEntry } from './DirectoryEntry.js';
 export { default as FileEntry } from './FileEntry.js';
 export { default as LinkEntry } from './LinkEntry.js';
 export { default as SymbolicLinkEntry } from './SymbolicLinkEntry.js';
+export * from './shared/index.js';
 export * from './types.js';
 export { default as waitForAccess } from './waitForAccess.js';

package/dist/cjs/index.js

@@ -34,6 +34,7 @@ var _DirectoryEntryts = /*#__PURE__*/ _interop_require_default(require("./Direct
 var _FileEntryts = /*#__PURE__*/ _interop_require_default(require("./FileEntry.js"));
 var _LinkEntryts = /*#__PURE__*/ _interop_require_default(require("./LinkEntry.js"));
 var _SymbolicLinkEntryts = /*#__PURE__*/ _interop_require_default(require("./SymbolicLinkEntry.js"));
+_export_star(require("./shared/index.js"), exports);
 _export_star(require("./types.js"), exports);
 var _waitForAccessts = /*#__PURE__*/ _interop_require_default(require("./waitForAccess.js"));
 function _assert_this_initialized(self) {

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/iterators/extract-base-iterator/src/index.ts"],"sourcesContent":["import './polyfills.ts';\nimport StackBaseIterator from 'stack-base-iterator';\n\nimport type { Entry } from './types.ts';\n\nexport default class ExtractBaseIterator extends StackBaseIterator<Entry> {}\n\nexport { default as DirectoryEntry } from './DirectoryEntry.ts';\nexport { default as FileEntry } from './FileEntry.ts';\nexport { default as LinkEntry } from './LinkEntry.ts';\nexport { default as SymbolicLinkEntry } from './SymbolicLinkEntry.ts';\nexport * from './types.ts';\nexport { default as waitForAccess } from './waitForAccess.ts';\n"],"names":["DirectoryEntry","FileEntry","LinkEntry","SymbolicLinkEntry","ExtractBaseIterator","waitForAccess","StackBaseIterator"],"mappings":";;;;;;;;;;;QAOoBA;eAAAA,yBAAc;;QACdC;eAAAA,oBAAS;;QACTC;eAAAA,oBAAS;;QACTC;eAAAA,4BAAiB;;;eALhBC;;QAODC;eAAAA,wBAAa;;;QAZ1B;wEACuB;uEAMY;kEACL;kEACA;0EACQ;qBAC/B;sEAC2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAP1B,IAAA,AAAMD,oCAAN;;cAAMA;aAAAA;gCAAAA;QAAN,OAAA,kBAAMA;;WAAAA;EAA4BE,0BAAiB"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/iterators/extract-base-iterator/src/index.ts"],"sourcesContent":["import './polyfills.ts';\nimport StackBaseIterator from 'stack-base-iterator';\n\nimport type { Entry } from './types.ts';\n\nexport default class ExtractBaseIterator extends StackBaseIterator<Entry> {}\n\nexport { default as DirectoryEntry } from './DirectoryEntry.ts';\nexport { default as FileEntry } from './FileEntry.ts';\nexport { default as LinkEntry } from './LinkEntry.ts';\nexport { default as SymbolicLinkEntry } from './SymbolicLinkEntry.ts';\n// Shared utilities for iterator libraries\nexport * from './shared/index.ts';\nexport * from './types.ts';\nexport { default as waitForAccess } from './waitForAccess.ts';\n"],"names":["DirectoryEntry","FileEntry","LinkEntry","SymbolicLinkEntry","ExtractBaseIterator","waitForAccess","StackBaseIterator"],"mappings":";;;;;;;;;;;QAOoBA;eAAAA,yBAAc;;QACdC;eAAAA,oBAAS;;QACTC;eAAAA,oBAAS;;QACTC;eAAAA,4BAAiB;;;eALhBC;;QASDC;eAAAA,wBAAa;;;QAd1B;wEACuB;uEAMY;kEACL;kEACA;0EACQ;qBAE/B;qBACA;sEAC2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAT1B,IAAA,AAAMD,oCAAN;;cAAMA;aAAAA;gCAAAA;QAAN,OAAA,kBAAMA;;WAAAA;EAA4BE,0BAAiB"}

package/dist/cjs/shared/EntryStream.d.cts

@@ -0,0 +1,55 @@
+/**
+ * EntryStream - Simple readable-like stream for entry content
+ *
+ * Extends EventEmitter to emit 'data', 'end', 'error' events.
+ * Node 0.8 compatible.
+ *
+ * This base class is designed to be used by:
+ * - zip-iterator
+ * - 7z-iterator
+ * - tar-iterator
+ * - Any other archive iterator library
+ */
+import { EventEmitter } from 'events';
+/**
+ * Base stream class for archive entry content.
+ * Can be extended for special entry types like sparse files.
+ */
+export default class EntryStream extends EventEmitter {
+    protected _paused: boolean;
+    protected _ended: boolean;
+    protected _endEmitted: boolean;
+    protected _buffered: Buffer[];
+    /**
+     * Push data to the stream
+     */
+    push(data: Buffer): void;
+    /**
+     * End the stream
+     */
+    end(): void;
+    /**
+     * Resume reading (drain buffered data)
+     */
+    resume(): this;
+    /**
+     * Pause reading
+     */
+    pause(): this;
+    /**
+     * Check if stream has ended
+     */
+    get ended(): boolean;
+    /**
+     * Pipe to a writable stream
+     */
+    pipe<T extends NodeJS.WritableStream>(dest: T): T;
+    /**
+     * Flush buffered data
+     */
+    protected _flush(): void;
+    /**
+     * Emit end event (only once)
+     */
+    protected _emitEnd(): void;
+}

package/dist/cjs/shared/EntryStream.d.ts

@@ -0,0 +1,55 @@
+/**
+ * EntryStream - Simple readable-like stream for entry content
+ *
+ * Extends EventEmitter to emit 'data', 'end', 'error' events.
+ * Node 0.8 compatible.
+ *
+ * This base class is designed to be used by:
+ * - zip-iterator
+ * - 7z-iterator
+ * - tar-iterator
+ * - Any other archive iterator library
+ */
+import { EventEmitter } from 'events';
+/**
+ * Base stream class for archive entry content.
+ * Can be extended for special entry types like sparse files.
+ */
+export default class EntryStream extends EventEmitter {
+    protected _paused: boolean;
+    protected _ended: boolean;
+    protected _endEmitted: boolean;
+    protected _buffered: Buffer[];
+    /**
+     * Push data to the stream
+     */
+    push(data: Buffer): void;
+    /**
+     * End the stream
+     */
+    end(): void;
+    /**
+     * Resume reading (drain buffered data)
+     */
+    resume(): this;
+    /**
+     * Pause reading
+     */
+    pause(): this;
+    /**
+     * Check if stream has ended
+     */
+    get ended(): boolean;
+    /**
+     * Pipe to a writable stream
+     */
+    pipe<T extends NodeJS.WritableStream>(dest: T): T;
+    /**
+     * Flush buffered data
+     */
+    protected _flush(): void;
+    /**
+     * Emit end event (only once)
+     */
+    protected _emitEnd(): void;
+}

package/dist/cjs/shared/EntryStream.js

@@ -0,0 +1,197 @@
+/**
+ * EntryStream - Simple readable-like stream for entry content
+ *
+ * Extends EventEmitter to emit 'data', 'end', 'error' events.
+ * Node 0.8 compatible.
+ *
+ * This base class is designed to be used by:
+ * - zip-iterator
+ * - 7z-iterator
+ * - tar-iterator
+ * - Any other archive iterator library
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: function() {
+        return EntryStream;
+    }
+});
+var _events = require("events");
+function _assert_this_initialized(self) {
+    if (self === void 0) {
+        throw new ReferenceError("this hasn't been initialised - super() hasn't been called");
+    }
+    return self;
+}
+function _call_super(_this, derived, args) {
+    derived = _get_prototype_of(derived);
+    return _possible_constructor_return(_this, _is_native_reflect_construct() ? Reflect.construct(derived, args || [], _get_prototype_of(_this).constructor) : derived.apply(_this, args));
+}
+function _class_call_check(instance, Constructor) {
+    if (!(instance instanceof Constructor)) {
+        throw new TypeError("Cannot call a class as a function");
+    }
+}
+function _defineProperties(target, props) {
+    for(var i = 0; i < props.length; i++){
+        var descriptor = props[i];
+        descriptor.enumerable = descriptor.enumerable || false;
+        descriptor.configurable = true;
+        if ("value" in descriptor) descriptor.writable = true;
+        Object.defineProperty(target, descriptor.key, descriptor);
+    }
+}
+function _create_class(Constructor, protoProps, staticProps) {
+    if (protoProps) _defineProperties(Constructor.prototype, protoProps);
+    if (staticProps) _defineProperties(Constructor, staticProps);
+    return Constructor;
+}
+function _get_prototype_of(o) {
+    _get_prototype_of = Object.setPrototypeOf ? Object.getPrototypeOf : function getPrototypeOf(o) {
+        return o.__proto__ || Object.getPrototypeOf(o);
+    };
+    return _get_prototype_of(o);
+}
+function _inherits(subClass, superClass) {
+    if (typeof superClass !== "function" && superClass !== null) {
+        throw new TypeError("Super expression must either be null or a function");
+    }
+    subClass.prototype = Object.create(superClass && superClass.prototype, {
+        constructor: {
+            value: subClass,
+            writable: true,
+            configurable: true
+        }
+    });
+    if (superClass) _set_prototype_of(subClass, superClass);
+}
+function _possible_constructor_return(self, call) {
+    if (call && (_type_of(call) === "object" || typeof call === "function")) {
+        return call;
+    }
+    return _assert_this_initialized(self);
+}
+function _set_prototype_of(o, p) {
+    _set_prototype_of = Object.setPrototypeOf || function setPrototypeOf(o, p) {
+        o.__proto__ = p;
+        return o;
+    };
+    return _set_prototype_of(o, p);
+}
+function _type_of(obj) {
+    "@swc/helpers - typeof";
+    return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
+}
+function _is_native_reflect_construct() {
+    try {
+        var result = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function() {}));
+    } catch (_) {}
+    return (_is_native_reflect_construct = function() {
+        return !!result;
+    })();
+}
+var EntryStream = /*#__PURE__*/ function(EventEmitter) {
+    "use strict";
+    _inherits(EntryStream, EventEmitter);
+    function EntryStream() {
+        _class_call_check(this, EntryStream);
+        var _this;
+        _this = _call_super(this, EntryStream, arguments), _this._paused = true, _this._ended = false, _this._endEmitted = false, _this._buffered = [];
+        return _this;
+    }
+    var _proto = EntryStream.prototype;
+    /**
+   * Push data to the stream
+   */ _proto.push = function push(data) {
+        if (this._ended) return;
+        if (this._paused) {
+            this._buffered.push(data);
+        } else {
+            this.emit('data', data);
+        }
+    };
+    /**
+   * End the stream
+   */ _proto.end = function end() {
+        if (this._ended) return;
+        this._ended = true;
+        // If not paused, flush and emit end now
+        if (!this._paused) {
+            this._flush();
+            this._emitEnd();
+        }
+    // Otherwise, end will be emitted when resume() is called
+    };
+    /**
+   * Resume reading (drain buffered data)
+   */ _proto.resume = function resume() {
+        if (!this._paused) return this;
+        this._paused = false;
+        this._flush();
+        // If stream was ended while paused, emit end now
+        if (this._ended && !this._endEmitted) {
+            this._emitEnd();
+        }
+        return this;
+    };
+    /**
+   * Pause reading
+   */ _proto.pause = function pause() {
+        this._paused = true;
+        return this;
+    };
+    /**
+   * Pipe to a writable stream
+   */ _proto.pipe = function pipe(dest) {
+        var self = this;
+        // Cast to EventEmitter-compatible type for backpressure handling
+        var emitter = dest;
+        this.on('data', function onData(chunk) {
+            var canContinue = dest.write(chunk);
+            // Handle backpressure if dest returns false
+            if (canContinue === false && typeof emitter.once === 'function') {
+                self.pause();
+                emitter.once('drain', function onDrain() {
+                    self.resume();
+                });
+            }
+        });
+        this.on('end', function onEnd() {
+            if (typeof dest.end === 'function') {
+                dest.end();
+            }
+        });
+        this.resume();
+        return dest;
+    };
+    /**
+   * Flush buffered data
+   */ _proto._flush = function _flush() {
+        while(this._buffered.length > 0){
+            var chunk = this._buffered.shift();
+            this.emit('data', chunk);
+        }
+    };
+    /**
+   * Emit end event (only once)
+   */ _proto._emitEnd = function _emitEnd() {
+        if (this._endEmitted) return;
+        this._endEmitted = true;
+        this.emit('end');
+    };
+    _create_class(EntryStream, [
+        {
+            key: "ended",
+            get: /**
+   * Check if stream has ended
+   */ function get() {
+                return this._ended;
+            }
+        }
+    ]);
+    return EntryStream;
+}(_events.EventEmitter);
+/* 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/shared/EntryStream.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/iterators/extract-base-iterator/src/shared/EntryStream.ts"],"sourcesContent":["/**\n * EntryStream - Simple readable-like stream for entry content\n *\n * Extends EventEmitter to emit 'data', 'end', 'error' events.\n * Node 0.8 compatible.\n *\n * This base class is designed to be used by:\n * - zip-iterator\n * - 7z-iterator\n * - tar-iterator\n * - Any other archive iterator library\n */\n\nimport { EventEmitter } from 'events';\n\n/**\n * Base stream class for archive entry content.\n * Can be extended for special entry types like sparse files.\n */\nexport default class EntryStream extends EventEmitter {\n  protected _paused = true;\n  protected _ended = false;\n  protected _endEmitted = false;\n  protected _buffered: Buffer[] = [];\n\n  /**\n   * Push data to the stream\n   */\n  push(data: Buffer): void {\n    if (this._ended) return;\n\n    if (this._paused) {\n      this._buffered.push(data);\n    } else {\n      this.emit('data', data);\n    }\n  }\n\n  /**\n   * End the stream\n   */\n  end(): void {\n    if (this._ended) return;\n    this._ended = true;\n\n    // If not paused, flush and emit end now\n    if (!this._paused) {\n      this._flush();\n      this._emitEnd();\n    }\n    // Otherwise, end will be emitted when resume() is called\n  }\n\n  /**\n   * Resume reading (drain buffered data)\n   */\n  resume(): this {\n    if (!this._paused) return this;\n    this._paused = false;\n    this._flush();\n    // If stream was ended while paused, emit end now\n    if (this._ended && !this._endEmitted) {\n      this._emitEnd();\n    }\n    return this;\n  }\n\n  /**\n   * Pause reading\n   */\n  pause(): this {\n    this._paused = true;\n    return this;\n  }\n\n  /**\n   * Check if stream has ended\n   */\n  get ended(): boolean {\n    return this._ended;\n  }\n\n  /**\n   * Pipe to a writable stream\n   */\n  pipe<T extends NodeJS.WritableStream>(dest: T): T {\n    var self = this;\n    // Cast to EventEmitter-compatible type for backpressure handling\n    var emitter = dest as T & { once?: (event: string, fn: () => void) => void };\n    this.on('data', function onData(chunk: Buffer) {\n      var canContinue = dest.write(chunk);\n      // Handle backpressure if dest returns false\n      if (canContinue === false && typeof emitter.once === 'function') {\n        self.pause();\n        emitter.once('drain', function onDrain() {\n          self.resume();\n        });\n      }\n    });\n\n    this.on('end', function onEnd() {\n      if (typeof dest.end === 'function') {\n        dest.end();\n      }\n    });\n\n    this.resume();\n    return dest;\n  }\n\n  /**\n   * Flush buffered data\n   */\n  protected _flush(): void {\n    while (this._buffered.length > 0) {\n      var chunk = this._buffered.shift();\n      this.emit('data', chunk);\n    }\n  }\n\n  /**\n   * Emit end event (only once)\n   */\n  protected _emitEnd(): void {\n    if (this._endEmitted) return;\n    this._endEmitted = true;\n    this.emit('end');\n  }\n}\n"],"names":["EntryStream","_paused","_ended","_endEmitted","_buffered","push","data","emit","end","_flush","_emitEnd","resume","pause","pipe","dest","self","emitter","on","onData","chunk","canContinue","write","once","onDrain","onEnd","length","shift","ended","EventEmitter"],"mappings":"AAAA;;;;;;;;;;;CAWC;;;;;;;eAQoBA;;;sBANQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMd,IAAA,AAAMA,4BAAN;;cAAMA;aAAAA;gCAAAA;;gBAAN,kBAAMA,+BACTC,UAAU,YACVC,SAAS,aACTC,cAAc,aACdC,YAAsB,EAAE;;;iBAJfJ;IAMnB;;GAEC,GACDK,OAAAA,IAQC,GARDA,SAAAA,KAAKC,IAAY;QACf,IAAI,IAAI,CAACJ,MAAM,EAAE;QAEjB,IAAI,IAAI,CAACD,OAAO,EAAE;YAChB,IAAI,CAACG,SAAS,CAACC,IAAI,CAACC;QACtB,OAAO;YACL,IAAI,CAACC,IAAI,CAAC,QAAQD;QACpB;IACF;IAEA;;GAEC,GACDE,OAAAA,GAUC,GAVDA,SAAAA;QACE,IAAI,IAAI,CAACN,MAAM,EAAE;QACjB,IAAI,CAACA,MAAM,GAAG;QAEd,wCAAwC;QACxC,IAAI,CAAC,IAAI,CAACD,OAAO,EAAE;YACjB,IAAI,CAACQ,MAAM;YACX,IAAI,CAACC,QAAQ;QACf;IACA,yDAAyD;IAC3D;IAEA;;GAEC,GACDC,OAAAA,MASC,GATDA,SAAAA;QACE,IAAI,CAAC,IAAI,CAACV,OAAO,EAAE,OAAO,IAAI;QAC9B,IAAI,CAACA,OAAO,GAAG;QACf,IAAI,CAACQ,MAAM;QACX,iDAAiD;QACjD,IAAI,IAAI,CAACP,MAAM,IAAI,CAAC,IAAI,CAACC,WAAW,EAAE;YACpC,IAAI,CAACO,QAAQ;QACf;QACA,OAAO,IAAI;IACb;IAEA;;GAEC,GACDE,OAAAA,KAGC,GAHDA,SAAAA;QACE,IAAI,CAACX,OAAO,GAAG;QACf,OAAO,IAAI;IACb;IASA;;GAEC,GACDY,OAAAA,IAuBC,GAvBDA,SAAAA,KAAsCC,IAAO;QAC3C,IAAIC,OAAO,IAAI;QACf,iEAAiE;QACjE,IAAIC,UAAUF;QACd,IAAI,CAACG,EAAE,CAAC,QAAQ,SAASC,OAAOC,KAAa;YAC3C,IAAIC,cAAcN,KAAKO,KAAK,CAACF;YAC7B,4CAA4C;YAC5C,IAAIC,gBAAgB,SAAS,OAAOJ,QAAQM,IAAI,KAAK,YAAY;gBAC/DP,KAAKH,KAAK;gBACVI,QAAQM,IAAI,CAAC,SAAS,SAASC;oBAC7BR,KAAKJ,MAAM;gBACb;YACF;QACF;QAEA,IAAI,CAACM,EAAE,CAAC,OAAO,SAASO;YACtB,IAAI,OAAOV,KAAKN,GAAG,KAAK,YAAY;gBAClCM,KAAKN,GAAG;YACV;QACF;QAEA,IAAI,CAACG,MAAM;QACX,OAAOG;IACT;IAEA;;GAEC,GACD,OAAUL,MAKT,GALD,SAAUA;QACR,MAAO,IAAI,CAACL,SAAS,CAACqB,MAAM,GAAG,EAAG;YAChC,IAAIN,QAAQ,IAAI,CAACf,SAAS,CAACsB,KAAK;YAChC,IAAI,CAACnB,IAAI,CAAC,QAAQY;QACpB;IACF;IAEA;;GAEC,GACD,OAAUT,QAIT,GAJD,SAAUA;QACR,IAAI,IAAI,CAACP,WAAW,EAAE;QACtB,IAAI,CAACA,WAAW,GAAG;QACnB,IAAI,CAACI,IAAI,CAAC;IACZ;kBA5GmBP;;YA2Df2B,KAAAA;iBAAJ,AAHA;;GAEC,GACD;gBACE,OAAO,IAAI,CAACzB,MAAM;YACpB;;;WA7DmBF;EAAoB4B,oBAAY"}

package/dist/cjs/shared/compat.d.cts

@@ -0,0 +1,78 @@
+/**
+ * Buffer Compatibility Layer for Node.js 0.8+
+ *
+ * Provides buffer utilities that work across all Node.js versions
+ * WITHOUT modifying global Buffer object.
+ *
+ * Version history:
+ * - Node 0.8-4.4: Only has `new Buffer()`, no `Buffer.alloc/from`
+ * - Node 4.5+: Has `Buffer.alloc/from`, deprecates `new Buffer()`
+ * - Node 10+: Warns or errors on `new Buffer()`
+ *
+ * Solution: Feature detection with graceful fallback in both directions.
+ */
+/**
+ * Allocate a zero-filled buffer (safe)
+ * - Uses Buffer.alloc() on Node 4.5+
+ * - Falls back to new Buffer() + fill on Node 0.8-4.4
+ */
+export declare function allocBuffer(size: number): Buffer;
+/**
+ * Allocate a buffer without initialization (unsafe but faster)
+ * - Uses Buffer.allocUnsafe() on Node 4.5+
+ * - Falls back to new Buffer() on Node 0.8-4.4
+ *
+ * WARNING: Buffer contents are uninitialized and may contain sensitive data.
+ * Only use when you will immediately overwrite all bytes.
+ */
+export declare function allocBufferUnsafe(size: number): Buffer;
+/**
+ * Create a buffer from string, array, or existing buffer
+ * - Uses Buffer.from() on Node 4.5+
+ * - Falls back to new Buffer() on Node 0.8-4.4
+ * - Handles Uint8Array conversion for Node 0.8 (crypto output compatibility)
+ */
+export declare function bufferFrom(data: string | number[] | Buffer | Uint8Array, encoding?: BufferEncoding): Buffer;
+/**
+ * Compare two buffers or buffer regions
+ * - Uses Buffer.compare() on Node 5.10+ (with offset support)
+ * - Falls back to manual comparison on Node 0.8-5.9
+ */
+export declare function bufferCompare(source: Buffer, target: Buffer, targetStart?: number, targetEnd?: number, sourceStart?: number, sourceEnd?: number): number;
+/**
+ * Check if buffer region equals byte array
+ * Useful for magic number detection without Buffer.from()
+ */
+export declare function bufferEquals(buf: Buffer, offset: number, expected: number[]): boolean;
+/**
+ * Copy buffer region to new buffer
+ * Works on all Node versions
+ */
+export declare function bufferSliceCopy(buf: Buffer, start: number, end: number): Buffer;
+/**
+ * Read 64-bit unsigned integer (little-endian)
+ * Uses two 32-bit reads since BigInt not available until Node 10.4
+ *
+ * WARNING: Only accurate for values < Number.MAX_SAFE_INTEGER (2^53 - 1)
+ * This covers files up to ~9 PB which is practical for all real use cases.
+ */
+export declare function readUInt64LE(buf: Buffer, offset: number): number;
+/**
+ * Write 64-bit unsigned integer (little-endian)
+ * Same precision limitation as readUInt64LE
+ */
+export declare function writeUInt64LE(buf: Buffer, value: number, offset: number): void;
+/**
+ * Concatenate buffers - compatible with Node 0.8
+ * Handles crypto output which may not be proper Buffer instances in old Node.
+ *
+ * NOTE: This function is primarily needed for AES decryption compatibility
+ * in Node 0.8 where crypto output may not be proper Buffer instances.
+ * Libraries not using crypto can use native Buffer.concat() directly.
+ */
+export declare function bufferConcat(list: (Buffer | Uint8Array)[], totalLength?: number): Buffer;
+/**
+ * Node 0.8 compatible isNaN (Number.isNaN didn't exist until ES2015)
+ * Uses self-comparison: NaN is the only value not equal to itself
+ */
+export declare function isNaN(value: number): boolean;

package/dist/cjs/shared/compat.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Buffer Compatibility Layer for Node.js 0.8+
+ *
+ * Provides buffer utilities that work across all Node.js versions
+ * WITHOUT modifying global Buffer object.
+ *
+ * Version history:
+ * - Node 0.8-4.4: Only has `new Buffer()`, no `Buffer.alloc/from`
+ * - Node 4.5+: Has `Buffer.alloc/from`, deprecates `new Buffer()`
+ * - Node 10+: Warns or errors on `new Buffer()`
+ *
+ * Solution: Feature detection with graceful fallback in both directions.
+ */
+/**
+ * Allocate a zero-filled buffer (safe)
+ * - Uses Buffer.alloc() on Node 4.5+
+ * - Falls back to new Buffer() + fill on Node 0.8-4.4
+ */
+export declare function allocBuffer(size: number): Buffer;
+/**
+ * Allocate a buffer without initialization (unsafe but faster)
+ * - Uses Buffer.allocUnsafe() on Node 4.5+
+ * - Falls back to new Buffer() on Node 0.8-4.4
+ *
+ * WARNING: Buffer contents are uninitialized and may contain sensitive data.
+ * Only use when you will immediately overwrite all bytes.
+ */
+export declare function allocBufferUnsafe(size: number): Buffer;
+/**
+ * Create a buffer from string, array, or existing buffer
+ * - Uses Buffer.from() on Node 4.5+
+ * - Falls back to new Buffer() on Node 0.8-4.4
+ * - Handles Uint8Array conversion for Node 0.8 (crypto output compatibility)
+ */
+export declare function bufferFrom(data: string | number[] | Buffer | Uint8Array, encoding?: BufferEncoding): Buffer;
+/**
+ * Compare two buffers or buffer regions
+ * - Uses Buffer.compare() on Node 5.10+ (with offset support)
+ * - Falls back to manual comparison on Node 0.8-5.9
+ */
+export declare function bufferCompare(source: Buffer, target: Buffer, targetStart?: number, targetEnd?: number, sourceStart?: number, sourceEnd?: number): number;
+/**
+ * Check if buffer region equals byte array
+ * Useful for magic number detection without Buffer.from()
+ */
+export declare function bufferEquals(buf: Buffer, offset: number, expected: number[]): boolean;
+/**
+ * Copy buffer region to new buffer
+ * Works on all Node versions
+ */
+export declare function bufferSliceCopy(buf: Buffer, start: number, end: number): Buffer;
+/**
+ * Read 64-bit unsigned integer (little-endian)
+ * Uses two 32-bit reads since BigInt not available until Node 10.4
+ *
+ * WARNING: Only accurate for values < Number.MAX_SAFE_INTEGER (2^53 - 1)
+ * This covers files up to ~9 PB which is practical for all real use cases.
+ */
+export declare function readUInt64LE(buf: Buffer, offset: number): number;
+/**
+ * Write 64-bit unsigned integer (little-endian)
+ * Same precision limitation as readUInt64LE
+ */
+export declare function writeUInt64LE(buf: Buffer, value: number, offset: number): void;
+/**
+ * Concatenate buffers - compatible with Node 0.8
+ * Handles crypto output which may not be proper Buffer instances in old Node.
+ *
+ * NOTE: This function is primarily needed for AES decryption compatibility
+ * in Node 0.8 where crypto output may not be proper Buffer instances.
+ * Libraries not using crypto can use native Buffer.concat() directly.
+ */
+export declare function bufferConcat(list: (Buffer | Uint8Array)[], totalLength?: number): Buffer;
+/**
+ * Node 0.8 compatible isNaN (Number.isNaN didn't exist until ES2015)
+ * Uses self-comparison: NaN is the only value not equal to itself
+ */
+export declare function isNaN(value: number): boolean;