7z-iterator 1.1.2 → 1.3.0

package/dist/esm/lzma/stream/transforms.d.ts

@@ -0,0 +1,38 @@
+/**
+ * LZMA Transform Stream Wrappers
+ *
+ * Provides Transform streams for LZMA1 and LZMA2 decompression.
+ *
+ * LZMA2 streaming works by buffering until a complete chunk is available,
+ * then decoding synchronously. LZMA2 chunks are bounded in size (~2MB max
+ * uncompressed), so memory usage is predictable and bounded.
+ *
+ * True byte-by-byte async LZMA streaming would require rewriting the entire
+ * decoder with continuation-passing style, which is complex and not worth
+ * the effort given LZMA2's chunked format.
+ */
+import { Transform } from 'extract-base-iterator';
+/**
+ * Create an LZMA2 decoder Transform stream
+ *
+ * This is a streaming decoder that processes LZMA2 chunks incrementally.
+ * Memory usage is O(dictionary_size + max_chunk_size) instead of O(folder_size).
+ *
+ * @param properties - 1-byte LZMA2 properties (dictionary size)
+ * @returns Transform stream that decompresses LZMA2 data
+ */
+export declare function createLzma2Decoder(properties: Buffer | Uint8Array): InstanceType<typeof Transform>;
+/**
+ * Create an LZMA1 decoder Transform stream
+ *
+ * Note: LZMA1 has no chunk boundaries, so this requires knowing the
+ * uncompressed size upfront. The stream buffers all input, then
+ * decompresses when complete.
+ *
+ * For true streaming, use LZMA2 which has built-in chunking.
+ *
+ * @param properties - 5-byte LZMA properties
+ * @param unpackSize - Expected uncompressed size
+ * @returns Transform stream that decompresses LZMA1 data
+ */
+export declare function createLzmaDecoder(properties: Buffer | Uint8Array, unpackSize: number): InstanceType<typeof Transform>;

package/dist/esm/lzma/stream/transforms.js

@@ -0,0 +1,150 @@
+/**
+ * LZMA Transform Stream Wrappers
+ *
+ * Provides Transform streams for LZMA1 and LZMA2 decompression.
+ *
+ * LZMA2 streaming works by buffering until a complete chunk is available,
+ * then decoding synchronously. LZMA2 chunks are bounded in size (~2MB max
+ * uncompressed), so memory usage is predictable and bounded.
+ *
+ * True byte-by-byte async LZMA streaming would require rewriting the entire
+ * decoder with continuation-passing style, which is complex and not worth
+ * the effort given LZMA2's chunked format.
+ */ import { Transform } from 'extract-base-iterator';
+import { hasCompleteChunk } from '../Lzma2ChunkParser.js';
+import { LzmaDecoder } from '../sync/LzmaDecoder.js';
+import { parseLzma2DictionarySize } from '../types.js';
+/**
+ * Create an LZMA2 decoder Transform stream
+ *
+ * This is a streaming decoder that processes LZMA2 chunks incrementally.
+ * Memory usage is O(dictionary_size + max_chunk_size) instead of O(folder_size).
+ *
+ * @param properties - 1-byte LZMA2 properties (dictionary size)
+ * @returns Transform stream that decompresses LZMA2 data
+ */ export function createLzma2Decoder(properties) {
+    if (!properties || properties.length < 1) {
+        throw new Error('LZMA2 requires properties byte');
+    }
+    const dictSize = parseLzma2DictionarySize(properties[0]);
+    // LZMA decoder instance - reused across chunks for solid mode
+    const decoder = new LzmaDecoder();
+    decoder.setDictionarySize(dictSize);
+    // Track current LZMA properties
+    let propsSet = false;
+    // Buffer for incomplete chunk data
+    let pending = null;
+    let finished = false;
+    return new Transform({
+        transform: function(chunk, _encoding, callback) {
+            if (finished) {
+                callback(null);
+                return;
+            }
+            // Combine with pending data
+            let input;
+            if (pending && pending.length > 0) {
+                input = Buffer.concat([
+                    pending,
+                    chunk
+                ]);
+                pending = null;
+            } else {
+                input = chunk;
+            }
+            let offset = 0;
+            try {
+                while(offset < input.length && !finished){
+                    const result = hasCompleteChunk(input, offset);
+                    if (!result.success) {
+                        // Need more data
+                        pending = input.slice(offset);
+                        break;
+                    }
+                    const { chunk: chunkInfo, totalSize } = result;
+                    if (chunkInfo.type === 'end') {
+                        finished = true;
+                        break;
+                    }
+                    // Handle dictionary reset
+                    if (chunkInfo.dictReset) {
+                        decoder.resetDictionary();
+                    }
+                    const dataOffset = offset + chunkInfo.headerSize;
+                    if (chunkInfo.type === 'uncompressed') {
+                        const uncompData = input.slice(dataOffset, dataOffset + chunkInfo.uncompSize);
+                        this.push(uncompData);
+                        // Feed uncompressed data to dictionary for subsequent LZMA chunks
+                        decoder.feedUncompressed(uncompData);
+                    } else {
+                        // LZMA compressed chunk
+                        // Apply new properties if present
+                        if (chunkInfo.newProps) {
+                            const { lc, lp, pb } = chunkInfo.newProps;
+                            if (!decoder.setLcLpPb(lc, lp, pb)) {
+                                throw new Error(`Invalid LZMA properties: lc=${lc} lp=${lp} pb=${pb}`);
+                            }
+                            propsSet = true;
+                        }
+                        if (!propsSet) {
+                            throw new Error('LZMA chunk without properties');
+                        }
+                        // Reset probabilities if state reset
+                        if (chunkInfo.stateReset) {
+                            decoder.resetProbabilities();
+                        }
+                        // Determine solid mode - preserve dictionary if not resetting state or if only resetting state (not dict)
+                        const useSolid = !chunkInfo.stateReset || chunkInfo.stateReset && !chunkInfo.dictReset;
+                        const compData = input.slice(dataOffset, dataOffset + chunkInfo.compSize);
+                        const decoded = decoder.decode(compData, 0, chunkInfo.uncompSize, useSolid);
+                        this.push(decoded);
+                    }
+                    offset += totalSize;
+                }
+                callback(null);
+            } catch (err) {
+                callback(err);
+            }
+        },
+        flush: function(callback) {
+            if (pending && pending.length > 0 && !finished) {
+                callback(new Error('Truncated LZMA2 stream'));
+            } else {
+                callback(null);
+            }
+        }
+    });
+}
+/**
+ * Create an LZMA1 decoder Transform stream
+ *
+ * Note: LZMA1 has no chunk boundaries, so this requires knowing the
+ * uncompressed size upfront. The stream buffers all input, then
+ * decompresses when complete.
+ *
+ * For true streaming, use LZMA2 which has built-in chunking.
+ *
+ * @param properties - 5-byte LZMA properties
+ * @param unpackSize - Expected uncompressed size
+ * @returns Transform stream that decompresses LZMA1 data
+ */ export function createLzmaDecoder(properties, unpackSize) {
+    const decoder = new LzmaDecoder();
+    decoder.setDecoderProperties(properties);
+    const chunks = [];
+    return new Transform({
+        transform: function(chunk, _encoding, callback) {
+            chunks.push(chunk);
+            callback(null);
+        },
+        flush: function(callback) {
+            try {
+                const input = Buffer.concat(chunks);
+                const output = decoder.decode(input, 0, unpackSize, false);
+                this.push(output);
+                callback(null);
+            } catch (err) {
+                callback(err);
+            }
+        }
+    });
+}

package/dist/esm/lzma/stream/transforms.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/iterators/7z-iterator/src/lzma/stream/transforms.ts"],"sourcesContent":["/**\n * LZMA Transform Stream Wrappers\n *\n * Provides Transform streams for LZMA1 and LZMA2 decompression.\n *\n * LZMA2 streaming works by buffering until a complete chunk is available,\n * then decoding synchronously. LZMA2 chunks are bounded in size (~2MB max\n * uncompressed), so memory usage is predictable and bounded.\n *\n * True byte-by-byte async LZMA streaming would require rewriting the entire\n * decoder with continuation-passing style, which is complex and not worth\n * the effort given LZMA2's chunked format.\n */\n\nimport { Transform } from 'extract-base-iterator';\nimport { hasCompleteChunk } from '../Lzma2ChunkParser.ts';\nimport { LzmaDecoder } from '../sync/LzmaDecoder.ts';\nimport { parseLzma2DictionarySize } from '../types.ts';\n\n/**\n * Create an LZMA2 decoder Transform stream\n *\n * This is a streaming decoder that processes LZMA2 chunks incrementally.\n * Memory usage is O(dictionary_size + max_chunk_size) instead of O(folder_size).\n *\n * @param properties - 1-byte LZMA2 properties (dictionary size)\n * @returns Transform stream that decompresses LZMA2 data\n */\nexport function createLzma2Decoder(properties: Buffer | Uint8Array): InstanceType<typeof Transform> {\n  if (!properties || properties.length < 1) {\n    throw new Error('LZMA2 requires properties byte');\n  }\n\n  const dictSize = parseLzma2DictionarySize(properties[0]);\n\n  // LZMA decoder instance - reused across chunks for solid mode\n  const decoder = new LzmaDecoder();\n  decoder.setDictionarySize(dictSize);\n\n  // Track current LZMA properties\n  let propsSet = false;\n\n  // Buffer for incomplete chunk data\n  let pending: Buffer | null = null;\n  let finished = false;\n\n  return new Transform({\n    transform: function (this: InstanceType<typeof Transform>, chunk: Buffer, _encoding: string, callback: (err?: Error | null) => void) {\n      if (finished) {\n        callback(null);\n        return;\n      }\n\n      // Combine with pending data\n      let input: Buffer;\n      if (pending && pending.length > 0) {\n        input = Buffer.concat([pending, chunk]);\n        pending = null;\n      } else {\n        input = chunk;\n      }\n\n      let offset = 0;\n\n      try {\n        while (offset < input.length && !finished) {\n          const result = hasCompleteChunk(input, offset);\n\n          if (!result.success) {\n            // Need more data\n            pending = input.slice(offset);\n            break;\n          }\n\n          const { chunk: chunkInfo, totalSize } = result;\n\n          if (chunkInfo.type === 'end') {\n            finished = true;\n            break;\n          }\n\n          // Handle dictionary reset\n          if (chunkInfo.dictReset) {\n            decoder.resetDictionary();\n          }\n\n          const dataOffset = offset + chunkInfo.headerSize;\n\n          if (chunkInfo.type === 'uncompressed') {\n            const uncompData = input.slice(dataOffset, dataOffset + chunkInfo.uncompSize);\n            this.push(uncompData);\n\n            // Feed uncompressed data to dictionary for subsequent LZMA chunks\n            decoder.feedUncompressed(uncompData);\n          } else {\n            // LZMA compressed chunk\n\n            // Apply new properties if present\n            if (chunkInfo.newProps) {\n              const { lc, lp, pb } = chunkInfo.newProps;\n              if (!decoder.setLcLpPb(lc, lp, pb)) {\n                throw new Error(`Invalid LZMA properties: lc=${lc} lp=${lp} pb=${pb}`);\n              }\n              propsSet = true;\n            }\n\n            if (!propsSet) {\n              throw new Error('LZMA chunk without properties');\n            }\n\n            // Reset probabilities if state reset\n            if (chunkInfo.stateReset) {\n              decoder.resetProbabilities();\n            }\n\n            // Determine solid mode - preserve dictionary if not resetting state or if only resetting state (not dict)\n            const useSolid = !chunkInfo.stateReset || (chunkInfo.stateReset && !chunkInfo.dictReset);\n\n            const compData = input.slice(dataOffset, dataOffset + chunkInfo.compSize);\n            const decoded = decoder.decode(compData, 0, chunkInfo.uncompSize, useSolid);\n            this.push(decoded);\n          }\n\n          offset += totalSize;\n        }\n\n        callback(null);\n      } catch (err) {\n        callback(err as Error);\n      }\n    },\n\n    flush: function (this: InstanceType<typeof Transform>, callback: (err?: Error | null) => void) {\n      if (pending && pending.length > 0 && !finished) {\n        callback(new Error('Truncated LZMA2 stream'));\n      } else {\n        callback(null);\n      }\n    },\n  });\n}\n\n/**\n * Create an LZMA1 decoder Transform stream\n *\n * Note: LZMA1 has no chunk boundaries, so this requires knowing the\n * uncompressed size upfront. The stream buffers all input, then\n * decompresses when complete.\n *\n * For true streaming, use LZMA2 which has built-in chunking.\n *\n * @param properties - 5-byte LZMA properties\n * @param unpackSize - Expected uncompressed size\n * @returns Transform stream that decompresses LZMA1 data\n */\nexport function createLzmaDecoder(properties: Buffer | Uint8Array, unpackSize: number): InstanceType<typeof Transform> {\n  const decoder = new LzmaDecoder();\n  decoder.setDecoderProperties(properties);\n\n  const chunks: Buffer[] = [];\n\n  return new Transform({\n    transform: function (this: InstanceType<typeof Transform>, chunk: Buffer, _encoding: string, callback: (err?: Error | null) => void) {\n      chunks.push(chunk);\n      callback(null);\n    },\n\n    flush: function (this: InstanceType<typeof Transform>, callback: (err?: Error | null) => void) {\n      try {\n        const input = Buffer.concat(chunks);\n        const output = decoder.decode(input, 0, unpackSize, false);\n        this.push(output);\n        callback(null);\n      } catch (err) {\n        callback(err as Error);\n      }\n    },\n  });\n}\n"],"names":["Transform","hasCompleteChunk","LzmaDecoder","parseLzma2DictionarySize","createLzma2Decoder","properties","length","Error","dictSize","decoder","setDictionarySize","propsSet","pending","finished","transform","chunk","_encoding","callback","input","Buffer","concat","offset","result","success","slice","chunkInfo","totalSize","type","dictReset","resetDictionary","dataOffset","headerSize","uncompData","uncompSize","push","feedUncompressed","newProps","lc","lp","pb","setLcLpPb","stateReset","resetProbabilities","useSolid","compData","compSize","decoded","decode","err","flush","createLzmaDecoder","unpackSize","setDecoderProperties","chunks","output"],"mappings":"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"}

package/dist/esm/lzma/sync/Lzma2Decoder.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Synchronous LZMA2 Decoder
+ *
+ * LZMA2 is a container format that wraps LZMA chunks with framing.
+ * Decodes LZMA2 data from a buffer.
+ */
+/**
+ * Synchronous LZMA2 decoder
+ */
+export declare class Lzma2Decoder {
+    private lzmaDecoder;
+    private dictionarySize;
+    private propsSet;
+    constructor(properties: Buffer | Uint8Array);
+    /**
+     * Decode LZMA2 data
+     * @param input - LZMA2 compressed data
+     * @param unpackSize - Expected output size (optional, for pre-allocation)
+     * @returns Decompressed data
+     */
+    decode(input: Buffer, unpackSize?: number): Buffer;
+}
+/**
+ * Decode LZMA2 data synchronously
+ * @param input - LZMA2 compressed data
+ * @param properties - 1-byte properties (dictionary size)
+ * @param unpackSize - Expected output size (optional)
+ * @returns Decompressed data
+ */
+export declare function decodeLzma2(input: Buffer, properties: Buffer | Uint8Array, unpackSize?: number): Buffer;

package/dist/esm/lzma/sync/Lzma2Decoder.js

@@ -0,0 +1,115 @@
+/**
+ * Synchronous LZMA2 Decoder
+ *
+ * LZMA2 is a container format that wraps LZMA chunks with framing.
+ * Decodes LZMA2 data from a buffer.
+ */ import { allocBufferUnsafe } from 'extract-base-iterator';
+import { parseLzma2ChunkHeader } from '../Lzma2ChunkParser.js';
+import { parseLzma2DictionarySize } from '../types.js';
+import { LzmaDecoder } from './LzmaDecoder.js';
+/**
+ * Synchronous LZMA2 decoder
+ */ export class Lzma2Decoder {
+    /**
+   * Decode LZMA2 data
+   * @param input - LZMA2 compressed data
+   * @param unpackSize - Expected output size (optional, for pre-allocation)
+   * @returns Decompressed data
+   */ decode(input, unpackSize) {
+        // Pre-allocate output buffer if size is known
+        let outputBuffer = null;
+        let outputPos = 0;
+        const outputChunks = [];
+        if (unpackSize && unpackSize > 0) {
+            outputBuffer = allocBufferUnsafe(unpackSize);
+        }
+        let offset = 0;
+        while(offset < input.length){
+            const result = parseLzma2ChunkHeader(input, offset);
+            if (!result.success) {
+                throw new Error('Truncated LZMA2 chunk header');
+            }
+            const chunk = result.chunk;
+            if (chunk.type === 'end') {
+                break;
+            }
+            // Validate we have enough data for the chunk
+            const dataSize = chunk.type === 'uncompressed' ? chunk.uncompSize : chunk.compSize;
+            if (offset + chunk.headerSize + dataSize > input.length) {
+                throw new Error(`Truncated LZMA2 ${chunk.type} data`);
+            }
+            // Handle dictionary reset
+            if (chunk.dictReset) {
+                this.lzmaDecoder.resetDictionary();
+            }
+            const dataOffset = offset + chunk.headerSize;
+            if (chunk.type === 'uncompressed') {
+                const uncompData = input.slice(dataOffset, dataOffset + chunk.uncompSize);
+                // Copy to output
+                if (outputBuffer) {
+                    uncompData.copy(outputBuffer, outputPos);
+                    outputPos += uncompData.length;
+                } else {
+                    outputChunks.push(uncompData);
+                }
+                // Feed uncompressed data to dictionary so subsequent LZMA chunks can reference it
+                this.lzmaDecoder.feedUncompressed(uncompData);
+                offset = dataOffset + chunk.uncompSize;
+            } else {
+                // LZMA compressed chunk
+                // Apply new properties if present
+                if (chunk.newProps) {
+                    const { lc, lp, pb } = chunk.newProps;
+                    if (!this.lzmaDecoder.setLcLpPb(lc, lp, pb)) {
+                        throw new Error(`Invalid LZMA properties: lc=${lc} lp=${lp} pb=${pb}`);
+                    }
+                    this.propsSet = true;
+                }
+                if (!this.propsSet) {
+                    throw new Error('LZMA chunk without properties');
+                }
+                // Reset probabilities if state reset
+                if (chunk.stateReset) {
+                    this.lzmaDecoder.resetProbabilities();
+                }
+                // Determine solid mode - preserve dictionary if not resetting state or if only resetting state (not dict)
+                const useSolid = !chunk.stateReset || chunk.stateReset && !chunk.dictReset;
+                // Decode LZMA chunk
+                const chunkData = input.slice(dataOffset, dataOffset + chunk.compSize);
+                const decoded = this.lzmaDecoder.decode(chunkData, 0, chunk.uncompSize, useSolid);
+                // Copy to output
+                if (outputBuffer) {
+                    decoded.copy(outputBuffer, outputPos);
+                    outputPos += decoded.length;
+                } else {
+                    outputChunks.push(decoded);
+                }
+                offset = dataOffset + chunk.compSize;
+            }
+        }
+        // Return pre-allocated buffer or concatenated chunks
+        if (outputBuffer) {
+            return outputPos < outputBuffer.length ? outputBuffer.slice(0, outputPos) : outputBuffer;
+        }
+        return Buffer.concat(outputChunks);
+    }
+    constructor(properties){
+        if (!properties || properties.length < 1) {
+            throw new Error('LZMA2 requires properties byte');
+        }
+        this.dictionarySize = parseLzma2DictionarySize(properties[0]);
+        this.lzmaDecoder = new LzmaDecoder();
+        this.lzmaDecoder.setDictionarySize(this.dictionarySize);
+        this.propsSet = false;
+    }
+}
+/**
+ * Decode LZMA2 data synchronously
+ * @param input - LZMA2 compressed data
+ * @param properties - 1-byte properties (dictionary size)
+ * @param unpackSize - Expected output size (optional)
+ * @returns Decompressed data
+ */ export function decodeLzma2(input, properties, unpackSize) {
+    const decoder = new Lzma2Decoder(properties);
+    return decoder.decode(input, unpackSize);
+}

package/dist/esm/lzma/sync/Lzma2Decoder.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/iterators/7z-iterator/src/lzma/sync/Lzma2Decoder.ts"],"sourcesContent":["/**\n * Synchronous LZMA2 Decoder\n *\n * LZMA2 is a container format that wraps LZMA chunks with framing.\n * Decodes LZMA2 data from a buffer.\n */\n\nimport { allocBufferUnsafe } from 'extract-base-iterator';\nimport { parseLzma2ChunkHeader } from '../Lzma2ChunkParser.ts';\nimport { parseLzma2DictionarySize } from '../types.ts';\nimport { LzmaDecoder } from './LzmaDecoder.ts';\n\n/**\n * Synchronous LZMA2 decoder\n */\nexport class Lzma2Decoder {\n  private lzmaDecoder: LzmaDecoder;\n  private dictionarySize: number;\n  private propsSet: boolean;\n\n  constructor(properties: Buffer | Uint8Array) {\n    if (!properties || properties.length < 1) {\n      throw new Error('LZMA2 requires properties byte');\n    }\n\n    this.dictionarySize = parseLzma2DictionarySize(properties[0]);\n    this.lzmaDecoder = new LzmaDecoder();\n    this.lzmaDecoder.setDictionarySize(this.dictionarySize);\n    this.propsSet = false;\n  }\n\n  /**\n   * Decode LZMA2 data\n   * @param input - LZMA2 compressed data\n   * @param unpackSize - Expected output size (optional, for pre-allocation)\n   * @returns Decompressed data\n   */\n  decode(input: Buffer, unpackSize?: number): Buffer {\n    // Pre-allocate output buffer if size is known\n    let outputBuffer: Buffer | null = null;\n    let outputPos = 0;\n    const outputChunks: Buffer[] = [];\n\n    if (unpackSize && unpackSize > 0) {\n      outputBuffer = allocBufferUnsafe(unpackSize);\n    }\n\n    let offset = 0;\n\n    while (offset < input.length) {\n      const result = parseLzma2ChunkHeader(input, offset);\n\n      if (!result.success) {\n        throw new Error('Truncated LZMA2 chunk header');\n      }\n\n      const chunk = result.chunk;\n\n      if (chunk.type === 'end') {\n        break;\n      }\n\n      // Validate we have enough data for the chunk\n      const dataSize = chunk.type === 'uncompressed' ? chunk.uncompSize : chunk.compSize;\n      if (offset + chunk.headerSize + dataSize > input.length) {\n        throw new Error(`Truncated LZMA2 ${chunk.type} data`);\n      }\n\n      // Handle dictionary reset\n      if (chunk.dictReset) {\n        this.lzmaDecoder.resetDictionary();\n      }\n\n      const dataOffset = offset + chunk.headerSize;\n\n      if (chunk.type === 'uncompressed') {\n        const uncompData = input.slice(dataOffset, dataOffset + chunk.uncompSize);\n\n        // Copy to output\n        if (outputBuffer) {\n          uncompData.copy(outputBuffer, outputPos);\n          outputPos += uncompData.length;\n        } else {\n          outputChunks.push(uncompData);\n        }\n\n        // Feed uncompressed data to dictionary so subsequent LZMA chunks can reference it\n        this.lzmaDecoder.feedUncompressed(uncompData);\n\n        offset = dataOffset + chunk.uncompSize;\n      } else {\n        // LZMA compressed chunk\n\n        // Apply new properties if present\n        if (chunk.newProps) {\n          const { lc, lp, pb } = chunk.newProps;\n          if (!this.lzmaDecoder.setLcLpPb(lc, lp, pb)) {\n            throw new Error(`Invalid LZMA properties: lc=${lc} lp=${lp} pb=${pb}`);\n          }\n          this.propsSet = true;\n        }\n\n        if (!this.propsSet) {\n          throw new Error('LZMA chunk without properties');\n        }\n\n        // Reset probabilities if state reset\n        if (chunk.stateReset) {\n          this.lzmaDecoder.resetProbabilities();\n        }\n\n        // Determine solid mode - preserve dictionary if not resetting state or if only resetting state (not dict)\n        const useSolid = !chunk.stateReset || (chunk.stateReset && !chunk.dictReset);\n\n        // Decode LZMA chunk\n        const chunkData = input.slice(dataOffset, dataOffset + chunk.compSize);\n        const decoded = this.lzmaDecoder.decode(chunkData, 0, chunk.uncompSize, useSolid);\n\n        // Copy to output\n        if (outputBuffer) {\n          decoded.copy(outputBuffer, outputPos);\n          outputPos += decoded.length;\n        } else {\n          outputChunks.push(decoded);\n        }\n\n        offset = dataOffset + chunk.compSize;\n      }\n    }\n\n    // Return pre-allocated buffer or concatenated chunks\n    if (outputBuffer) {\n      return outputPos < outputBuffer.length ? outputBuffer.slice(0, outputPos) : outputBuffer;\n    }\n    return Buffer.concat(outputChunks);\n  }\n}\n\n/**\n * Decode LZMA2 data synchronously\n * @param input - LZMA2 compressed data\n * @param properties - 1-byte properties (dictionary size)\n * @param unpackSize - Expected output size (optional)\n * @returns Decompressed data\n */\nexport function decodeLzma2(input: Buffer, properties: Buffer | Uint8Array, unpackSize?: number): Buffer {\n  const decoder = new Lzma2Decoder(properties);\n  return decoder.decode(input, unpackSize);\n}\n"],"names":["allocBufferUnsafe","parseLzma2ChunkHeader","parseLzma2DictionarySize","LzmaDecoder","Lzma2Decoder","decode","input","unpackSize","outputBuffer","outputPos","outputChunks","offset","length","result","success","Error","chunk","type","dataSize","uncompSize","compSize","headerSize","dictReset","lzmaDecoder","resetDictionary","dataOffset","uncompData","slice","copy","push","feedUncompressed","newProps","lc","lp","pb","setLcLpPb","propsSet","stateReset","resetProbabilities","useSolid","chunkData","decoded","Buffer","concat","properties","dictionarySize","setDictionarySize","decodeLzma2","decoder"],"mappings":"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"}

package/dist/esm/lzma/sync/LzmaDecoder.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Synchronous LZMA1 Decoder
+ *
+ * Decodes LZMA1 compressed data from a buffer.
+ * All operations are synchronous.
+ */
+/**
+ * Synchronous LZMA1 decoder
+ */
+export declare class LzmaDecoder {
+    private outWindow;
+    private rangeDecoder;
+    private isMatchDecoders;
+    private isRepDecoders;
+    private isRepG0Decoders;
+    private isRepG1Decoders;
+    private isRepG2Decoders;
+    private isRep0LongDecoders;
+    private posSlotDecoder;
+    private posDecoders;
+    private posAlignDecoder;
+    private lenDecoder;
+    private repLenDecoder;
+    private literalDecoder;
+    private dictionarySize;
+    private dictionarySizeCheck;
+    private posStateMask;
+    private state;
+    private rep0;
+    private rep1;
+    private rep2;
+    private rep3;
+    private prevByte;
+    private totalPos;
+    constructor();
+    /**
+     * Set dictionary size
+     */
+    setDictionarySize(dictionarySize: number): boolean;
+    /**
+     * Set lc, lp, pb properties
+     */
+    setLcLpPb(lc: number, lp: number, pb: number): boolean;
+    /**
+     * Set decoder properties from 5-byte buffer
+     */
+    setDecoderProperties(properties: Buffer | Uint8Array): boolean;
+    /**
+     * Initialize probability tables
+     */
+    private initProbabilities;
+    /**
+     * Reset probabilities only (for LZMA2 state reset)
+     */
+    resetProbabilities(): void;
+    /**
+     * Reset dictionary position (for LZMA2 dictionary reset)
+     */
+    resetDictionary(): void;
+    /**
+     * Feed uncompressed data into the dictionary (for LZMA2 uncompressed chunks)
+     * This updates the sliding window so subsequent LZMA chunks can reference this data.
+     */
+    feedUncompressed(data: Buffer): void;
+    /**
+     * Decode LZMA data
+     * @param input - Compressed input buffer
+     * @param inputOffset - Offset into input buffer
+     * @param outSize - Expected output size
+     * @param solid - If true, preserve state from previous decode
+     * @returns Decompressed data
+     */
+    decode(input: Buffer, inputOffset: number, outSize: number, solid?: boolean): Buffer;
+}
+/**
+ * Decode LZMA1 data synchronously
+ * @param input - Compressed data (without 5-byte properties header)
+ * @param properties - 5-byte LZMA properties
+ * @param outSize - Expected output size
+ * @returns Decompressed data
+ */
+export declare function decodeLzma(input: Buffer, properties: Buffer | Uint8Array, outSize: number): Buffer;