@neoware_inc/neozipkit 0.5.0

package/dist/core/ZipCopy.js

@@ -0,0 +1,310 @@
+"use strict";
+// ======================================
+//	ZipCopy.ts - Efficient ZIP Entry Copying (Buffer-based)
+//  Copyright (c) 2025 NeoWare, Inc. All rights reserved.
+// ======================================
+//
+// Efficient ZIP entry copying using ZipEntry instances directly.
+// Leverages existing offsets and sizes to copy raw bytes without
+// unnecessary parsing and reconstruction.
+// Buffer-based implementation for in-memory ZIP operations.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZipCopy = void 0;
+const ZipEntry_1 = __importDefault(require("./ZipEntry"));
+const Headers_1 = require("./constants/Headers");
+/**
+ * Efficient ZIP file copying class (Buffer-based)
+ *
+ * Uses ZipEntry instances directly to copy entries without decompression/recompression.
+ * Supports filtering and reordering entries while maintaining ZIP file validity.
+ * Works entirely with buffers for in-memory operations.
+ *
+ * Entry data and the central directory / EOCD are separated so you can append
+ * more entry data before finalizing: use copyZipEntriesOnly, append new entry
+ * data to the buffer, then call writeCentralDirectoryAndEOCD with all entries
+ * and concatenate to form the final ZIP buffer.
+ *
+ * @example Full copy (one shot)
+ * ```typescript
+ * const zipCopy = new ZipCopy(zipkit);
+ * const result = await zipCopy.copyZipBuffer(sourceZipBuffer, {
+ *   entryFilter: (entry) => !entry.filename.startsWith('.'),
+ *   entrySorter: (a, b) => a.filename.localeCompare(b.filename)
+ * });
+ * // result.zipBuffer contains the complete copied ZIP file
+ * ```
+ *
+ * @example Copy then append entries before finalizing
+ * ```typescript
+ * const { entryDataBuffer, dataEndOffset, copiedEntries } = await zipCopy.copyZipEntriesOnly(sourceZipBuffer);
+ * // ... append new entry data (local header + data), collect new ZipEntry[] with localHdrOffset set ...
+ * const allEntryData = Buffer.concat([entryDataBuffer, newEntryDataBuffer]);
+ * const allEntries = [...copiedEntries, ...newEntries];
+ * const centralAndEocd = zipCopy.writeCentralDirectoryAndEOCD(allEntries, {
+ *   zipComment: '',
+ *   centralDirOffset: allEntryData.length
+ * });
+ * const zipBuffer = Buffer.concat([allEntryData, centralAndEocd]);
+ * ```
+ */
+class ZipCopy {
+    /**
+     * Creates a new ZipCopy instance
+     * @param zipkit - Zipkit instance to use for ZIP operations
+     */
+    constructor(zipkit) {
+        this.zipkit = zipkit;
+    }
+    /**
+     * Calculate local header size by reading from buffer
+     *
+     * Reads the first 30 bytes of the local header to get the exact
+     * filename and extra field lengths, ensuring accuracy even when
+     * local header differs from central directory.
+     *
+     * @param sourceBuffer - Buffer containing the source ZIP file
+     * @param entry - ZipEntry with localHdrOffset
+     * @returns Size of the local header in bytes
+     */
+    calculateLocalHeaderSize(sourceBuffer, entry) {
+        // Verify offset is within buffer bounds
+        if (entry.localHdrOffset + Headers_1.LOCAL_HDR.SIZE > sourceBuffer.length) {
+            throw new Error(`Local header offset ${entry.localHdrOffset} is beyond buffer size ${sourceBuffer.length} for entry ${entry.filename}`);
+        }
+        // Read the fixed 30-byte local header
+        const headerBuffer = sourceBuffer.subarray(entry.localHdrOffset, entry.localHdrOffset + Headers_1.LOCAL_HDR.SIZE);
+        // Verify signature
+        if (headerBuffer.readUInt32LE(0) !== Headers_1.LOCAL_HDR.SIGNATURE) {
+            throw new Error(`Invalid local file header signature for entry ${entry.filename} at offset ${entry.localHdrOffset}`);
+        }
+        // Read filename and extra field lengths from the actual header
+        const filenameLength = headerBuffer.readUInt16LE(Headers_1.LOCAL_HDR.FNAME_LEN);
+        const extraFieldLength = headerBuffer.readUInt16LE(Headers_1.LOCAL_HDR.EXTRA_LEN);
+        // Calculate total local header size
+        return Headers_1.LOCAL_HDR.SIZE + filenameLength + extraFieldLength;
+    }
+    /**
+     * Copy entry bytes directly from source buffer
+     *
+     * Copies the local header and compressed data as a single operation.
+     *
+     * Handles various entry types:
+     * - Normal entries: [local header][filename][extra][compressed data]
+     * - Encrypted entries: compressedSize includes 12-byte encryption header
+     * - Data descriptor entries: [local header][filename][extra][data][data descriptor (16 bytes)]
+     *
+     * For data descriptor entries, the local header has compressed size = 0,
+     * but the actual size is in the central directory (entry.compressedSize).
+     *
+     * @param sourceBuffer - Buffer containing the source ZIP file
+     * @param entry - ZipEntry with source offset information
+     * @returns Buffer containing the copied entry (local header + compressed data + data descriptor if present)
+     */
+    copyEntryBytes(sourceBuffer, entry) {
+        // Calculate local header size by reading from buffer
+        const localHeaderSize = this.calculateLocalHeaderSize(sourceBuffer, entry);
+        // Determine total entry size
+        // For data descriptor entries, add 16 bytes for the data descriptor
+        const hasDataDescriptor = (entry.bitFlags & Headers_1.GP_FLAG.DATA_DESC) !== 0;
+        const totalEntrySize = localHeaderSize + entry.compressedSize + (hasDataDescriptor ? 16 : 0);
+        // Verify we have enough data in the buffer
+        if (entry.localHdrOffset + totalEntrySize > sourceBuffer.length) {
+            throw new Error(`Entry ${entry.filename} extends beyond buffer size: ` +
+                `offset ${entry.localHdrOffset} + size ${totalEntrySize} > buffer length ${sourceBuffer.length}`);
+        }
+        // Extract the entire entry (local header + compressed data + data descriptor if present) from source
+        const entryBuffer = sourceBuffer.subarray(entry.localHdrOffset, entry.localHdrOffset + totalEntrySize);
+        // Verify data descriptor signature if present
+        if (hasDataDescriptor) {
+            const dataDescOffset = localHeaderSize + entry.compressedSize;
+            const dataDescSig = entryBuffer.readUInt32LE(dataDescOffset);
+            if (dataDescSig !== 0x08074b50) { // DATA_DESCRIPTOR signature
+                throw new Error(`Invalid data descriptor signature for entry ${entry.filename} ` +
+                    `(expected 0x08074b50, got 0x${dataDescSig.toString(16)})`);
+            }
+        }
+        // Return a copy of the buffer slice (so modifications don't affect source)
+        return Buffer.from(entryBuffer);
+    }
+    /**
+     * Clone a ZipEntry with a new local header offset
+     *
+     * Creates a new ZipEntry instance with all properties copied from the source,
+     * but with an updated localHdrOffset for the destination buffer.
+     *
+     * @param entry - Source ZipEntry to clone
+     * @param newLocalHdrOffset - New local header offset for the destination
+     * @returns New ZipEntry instance with updated offset
+     */
+    cloneEntryWithOffset(entry, newLocalHdrOffset) {
+        // Create a new ZipEntry with the same filename and comment
+        const cloned = new ZipEntry_1.default(entry.filename, entry.comment || null, entry.debug);
+        // Copy all properties
+        cloned.verMadeBy = entry.verMadeBy;
+        cloned.verExtract = entry.verExtract;
+        cloned.bitFlags = entry.bitFlags;
+        cloned.cmpMethod = entry.cmpMethod;
+        cloned.timeDateDOS = entry.timeDateDOS;
+        cloned.crc = entry.crc;
+        cloned.compressedSize = entry.compressedSize;
+        cloned.uncompressedSize = entry.uncompressedSize;
+        cloned.volNumber = entry.volNumber;
+        cloned.intFileAttr = entry.intFileAttr;
+        cloned.extFileAttr = entry.extFileAttr;
+        cloned.localHdrOffset = newLocalHdrOffset; // Update offset
+        // Copy extra field if present
+        if (entry.extraField) {
+            cloned.extraField = Buffer.from(entry.extraField);
+        }
+        // Copy metadata
+        cloned.isEncrypted = entry.isEncrypted;
+        cloned.isStrongEncrypt = entry.isStrongEncrypt;
+        cloned.isDirectory = entry.isDirectory;
+        cloned.isMetaData = entry.isMetaData;
+        cloned.isUpdated = entry.isUpdated;
+        // Copy platform-specific data
+        cloned.platform = entry.platform;
+        cloned.universalTime = entry.universalTime;
+        cloned.uid = entry.uid;
+        cloned.gid = entry.gid;
+        cloned.sha256 = entry.sha256;
+        // Copy symlink data
+        cloned.isSymlink = entry.isSymlink;
+        cloned.linkTarget = entry.linkTarget;
+        // Copy hardlink data
+        cloned.isHardLink = entry.isHardLink;
+        cloned.originalEntry = entry.originalEntry;
+        cloned.inode = entry.inode;
+        return cloned;
+    }
+    /**
+     * Build central directory and End of Central Directory buffer.
+     * Used internally by copyZipBuffer and by writeCentralDirectoryAndEOCD.
+     */
+    buildCentralDirectoryAndEOCDBuffer(entries, zipComment, centralDirOffset) {
+        const centralDirChunks = [];
+        for (const entry of entries) {
+            centralDirChunks.push(entry.centralDirEntry());
+        }
+        const centralDirBuffer = Buffer.concat(centralDirChunks);
+        const centralDirSize = centralDirBuffer.length;
+        const commentBytes = Buffer.from(zipComment, 'utf8');
+        const commentLength = Math.min(commentBytes.length, 0xffff);
+        const eocdBuffer = Buffer.alloc(22 + commentLength);
+        let pos = 0;
+        eocdBuffer.writeUInt32LE(Headers_1.CENTRAL_END.SIGNATURE, pos);
+        pos += 4;
+        eocdBuffer.writeUInt16LE(0, pos);
+        pos += 2;
+        eocdBuffer.writeUInt16LE(0, pos);
+        pos += 2;
+        eocdBuffer.writeUInt16LE(entries.length, pos);
+        pos += 2;
+        eocdBuffer.writeUInt16LE(entries.length, pos);
+        pos += 2;
+        eocdBuffer.writeUInt32LE(centralDirSize, pos);
+        pos += 4;
+        eocdBuffer.writeUInt32LE(centralDirOffset, pos);
+        pos += 4;
+        eocdBuffer.writeUInt16LE(commentLength, pos);
+        pos += 2;
+        if (commentLength > 0) {
+            commentBytes.copy(eocdBuffer, pos, 0, commentLength);
+        }
+        return Buffer.concat([centralDirBuffer, eocdBuffer]);
+    }
+    /**
+     * Copy only ZIP entry data from the source buffer (no central directory or EOCD).
+     * Use when you want to append more entry data before finalizing. Then call
+     * writeCentralDirectoryAndEOCD with all entries (copied + new) and concatenate
+     * to form the final ZIP buffer.
+     *
+     * @param sourceZipBuffer - Buffer containing the source ZIP file
+     * @param options - Optional copy options (filtering, sorting)
+     * @returns Result with entryDataBuffer and copiedEntries for use when appending and finalizing
+     */
+    async copyZipEntriesOnly(sourceZipBuffer, options) {
+        const sourceEntries = this.zipkit.loadZip(sourceZipBuffer);
+        let entriesToCopy = options?.entryFilter
+            ? sourceEntries.filter(options.entryFilter)
+            : sourceEntries;
+        if (options?.entrySorter) {
+            entriesToCopy = [...entriesToCopy].sort(options.entrySorter);
+        }
+        if (entriesToCopy.length === 0) {
+            throw new Error('No entries to copy after filtering');
+        }
+        const outputChunks = [];
+        let destOffset = 0;
+        const copiedEntries = [];
+        for (const sourceEntry of entriesToCopy) {
+            const newLocalHdrOffset = destOffset;
+            const entryBuffer = this.copyEntryBytes(sourceZipBuffer, sourceEntry);
+            outputChunks.push(entryBuffer);
+            destOffset += entryBuffer.length;
+            const clonedEntry = this.cloneEntryWithOffset(sourceEntry, newLocalHdrOffset);
+            copiedEntries.push(clonedEntry);
+        }
+        const entryDataBuffer = Buffer.concat(outputChunks);
+        return {
+            entryDataBuffer,
+            dataEndOffset: entryDataBuffer.length,
+            copiedEntries,
+        };
+    }
+    /**
+     * Build central directory and End of Central Directory buffer for the given entries.
+     * Concatenate this with entry data (e.g. from copyZipEntriesOnly + any appended entries)
+     * to form a valid ZIP buffer. When concatenating, pass centralDirOffset equal to the
+     * length of the entry data buffer that will precede this (so EOCD has the correct offset).
+     *
+     * @param entries - All entries in order (copied + any new), each with localHdrOffset set
+     * @param options - Optional finalize options (zipComment; centralDirOffset for correct EOCD when concatenating)
+     * @returns Buffer containing central directory + EOCD
+     */
+    writeCentralDirectoryAndEOCD(entries, options) {
+        if (entries.length === 0) {
+            throw new Error('At least one entry is required to finalize');
+        }
+        const zipComment = options?.zipComment ?? '';
+        const centralDirOffset = options?.centralDirOffset ?? 0;
+        const result = this.buildCentralDirectoryAndEOCDBuffer(entries, zipComment, centralDirOffset);
+        return result;
+    }
+    /**
+     * Copy ZIP file entries efficiently from buffer to buffer
+     *
+     * Main method that copies entries from source ZIP buffer to destination ZIP buffer.
+     * Uses ZipEntry instances directly to avoid unnecessary parsing.
+     *
+     * @param sourceZipBuffer - Buffer containing the source ZIP file
+     * @param options - Optional copy options (filtering, sorting, etc.)
+     * @returns Copy result with entry information and the complete ZIP buffer
+     */
+    async copyZipBuffer(sourceZipBuffer, options) {
+        const { entryDataBuffer, dataEndOffset, copiedEntries } = await this.copyZipEntriesOnly(sourceZipBuffer, options);
+        const zipComment = options?.preserveComments !== false && this.zipkit.getZipComment()
+            ? this.zipkit.getZipComment()
+            : '';
+        const centralAndEocd = this.writeCentralDirectoryAndEOCD(copiedEntries, {
+            zipComment,
+            centralDirOffset: dataEndOffset,
+        });
+        const zipBuffer = Buffer.concat([entryDataBuffer, centralAndEocd]);
+        return {
+            entries: copiedEntries.map(entry => ({
+                filename: entry.filename,
+                localHeaderOffset: entry.localHdrOffset,
+                compressedSize: entry.compressedSize,
+            })),
+            centralDirOffset: dataEndOffset,
+            totalEntries: copiedEntries.length,
+            zipBuffer,
+        };
+    }
+}
+exports.ZipCopy = ZipCopy;
+//# sourceMappingURL=ZipCopy.js.map

package/dist/core/ZipCopy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZipCopy.js","sourceRoot":"","sources":["../../src/core/ZipCopy.ts"],"names":[],"mappings":"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"}

package/dist/core/ZipDecompress.d.ts

@@ -0,0 +1,57 @@
+import Zipkit from './Zipkit';
+import ZipEntry from './ZipEntry';
+export interface DecompressionResult {
+    success: boolean;
+    data?: Buffer;
+    error?: string;
+}
+export interface DecompressionOptions {
+    method: number;
+    debug?: boolean;
+}
+/**
+ * ZipDecompress - Unified Decompression Module (Internal to Zipkit)
+ * Consolidates decompression functionality from ZipCompress
+ * Supports deflate, zstd, and stored compression methods with chunked processing
+ *
+ * This class is internal to Zipkit and should not be used directly.
+ * Use Zipkit methods instead.
+ */
+declare class ZipDecompress {
+    private zipkit;
+    private debug;
+    private static loggingEnabled;
+    /**
+     * Internal logging method - only logs if class logging is enabled
+     */
+    private log;
+    constructor(zipkit: Zipkit);
+    /**
+     * Extract file data (Buffer-based ZIP only)
+     * Public method that validates buffer mode and extracts entry
+     *
+     * @param entry ZIP entry to extract
+     * @param skipHashCheck Skip hash verification (CRC-32 or SHA-256)
+     * @returns Promise resolving to extracted data as Buffer, or null if failed
+     * @throws Error if not a Buffer-based ZIP
+     */
+    extract(entry: ZipEntry, skipHashCheck?: boolean): Promise<Buffer | null>;
+    /**
+     * Inflate data using pako (internal use only)
+     */
+    private inflate;
+    /**
+     * Synchronous zstd decompress method for in-memory mode
+     * ZSTD codec is guaranteed to be initialized via factory method
+     * Internal method only
+     */
+    private zstdDecompressSync;
+    /**
+     * Uncompress compressed data buffer (synchronous for in-memory mode)
+     * Handles decompression and hash verification
+     * Internal method only
+     */
+    private unCompress;
+}
+export default ZipDecompress;
+//# sourceMappingURL=ZipDecompress.d.ts.map

package/dist/core/ZipDecompress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZipDecompress.d.ts","sourceRoot":"","sources":["../../src/core/ZipDecompress.ts"],"names":[],"mappings":"AAiBA,OAAO,MAAM,MAAM,UAAU,CAAC;AAE9B,OAAO,QAAQ,MAAM,YAAY,CAAC;AAKlC,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,cAAM,aAAa;IACjB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAU;IAGvB,OAAO,CAAC,MAAM,CAAC,cAAc,CAAkB;IAE/C;;OAEG;IACH,OAAO,CAAC,GAAG;gBAMC,MAAM,EAAE,MAAM;IAU1B;;;;;;;;OAQG;IACG,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAiC/E;;OAEG;IACH,OAAO,CAAC,OAAO;IAOf;;;;OAIG;YACW,kBAAkB;IAchC;;;;OAIG;YACW,UAAU;CA0CzB;AAGD,eAAe,aAAa,CAAC"}

package/dist/core/ZipDecompress.js

@@ -0,0 +1,155 @@
+"use strict";
+// ======================================
+//	ZipDecompress.ts - Decompression Module
+//  Copyright (c) 2025 NeoWare, Inc. All rights reserved.
+// ======================================
+//
+// LOGGING INSTRUCTIONS:
+// ---------------------
+// To enable/disable logging, set loggingEnabled to true/false in the class:
+//   private static loggingEnabled: boolean = true;  // Enable logging
+//   private static loggingEnabled: boolean = false; // Disable logging
+//
+// Logging respects the global Logger level (debug, info, warn, error, silent).
+// Logger level is automatically set to 'debug' when loggingEnabled is true.
+//
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const pako = require('pako');
+const ZstdManager_1 = require("./ZstdManager");
+const Logger_1 = require("./components/Logger");
+const Errors_1 = __importDefault(require("./constants/Errors"));
+const Headers_1 = require("./constants/Headers");
+const ZipCrypto_1 = require("./encryption/ZipCrypto");
+/**
+ * ZipDecompress - Unified Decompression Module (Internal to Zipkit)
+ * Consolidates decompression functionality from ZipCompress
+ * Supports deflate, zstd, and stored compression methods with chunked processing
+ *
+ * This class is internal to Zipkit and should not be used directly.
+ * Use Zipkit methods instead.
+ */
+class ZipDecompress {
+    /**
+     * Internal logging method - only logs if class logging is enabled
+     */
+    log(...args) {
+        if (ZipDecompress.loggingEnabled) {
+            Logger_1.Logger.debug(`[ZipDecompress]`, ...args);
+        }
+    }
+    constructor(zipkit) {
+        this.zipkit = zipkit;
+        // Debug disabled by default
+        this.debug = false;
+        // If logging is enabled, ensure Logger level is set to debug
+        if (ZipDecompress.loggingEnabled) {
+            Logger_1.Logger.setLevel('debug');
+        }
+    }
+    /**
+     * Extract file data (Buffer-based ZIP only)
+     * Public method that validates buffer mode and extracts entry
+     *
+     * @param entry ZIP entry to extract
+     * @param skipHashCheck Skip hash verification (CRC-32 or SHA-256)
+     * @returns Promise resolving to extracted data as Buffer, or null if failed
+     * @throws Error if not a Buffer-based ZIP
+     */
+    async extract(entry, skipHashCheck) {
+        if (!this.zipkit.hasInBuffer()) {
+            throw new Error('extract() requires Buffer-based ZIP. Use ZipkitNode.extractToFile() for file-based ZIP or call loadZip() first.');
+        }
+        this.log(`extract() called for entry: ${entry.filename}, method: ${entry.cmpMethod}, skipHashCheck: ${skipHashCheck}`);
+        const buffer = this.zipkit.ensureBuffer();
+        // Decrypt if needed using password on zipkit instance
+        let fdata = this.zipkit.parseLocalHeader(entry, buffer);
+        if (entry.isEncrypted && this.zipkit?.password) {
+            this.log(`Starting in-memory decryption for entry: ${entry.filename}`);
+            // Use ZipCrypto's decryptBuffer method which handles all the header parsing and decryption
+            const zipCrypto = new ZipCrypto_1.ZipCrypto();
+            fdata = zipCrypto.decryptBuffer(entry, buffer, fdata, this.zipkit.password);
+            this.log(`Decryption successful, decrypted compressed data length: ${fdata.length}`);
+        }
+        if (fdata.length === 0) {
+            return null;
+        }
+        // Use the unCompress method
+        return this.unCompress(fdata, entry, skipHashCheck);
+    }
+    /**
+     * Inflate data using pako (internal use only)
+     */
+    inflate(data) {
+        this.log(`inflate() called with ${data.length} bytes`);
+        const result = pako.inflateRaw(data);
+        return Buffer.from(result.buffer, result.byteOffset, result.byteLength);
+    }
+    /**
+     * Synchronous zstd decompress method for in-memory mode
+     * ZSTD codec is guaranteed to be initialized via factory method
+     * Internal method only
+     */
+    async zstdDecompressSync(data) {
+        this.log(`zstdDecompressSync() called with ${data.length} bytes`);
+        try {
+            // Use global ZstdManager for decompression (handles queuing and initialization)
+            const decompressed = await ZstdManager_1.ZstdManager.decompress(data);
+            this.log(`ZSTD decompression successful: ${data.length} bytes -> ${decompressed.length} bytes`);
+            return Buffer.from(decompressed);
+        }
+        catch (error) {
+            this.log(`ZSTD decompression failed: ${error}`);
+            throw new Error(`ZSTD decompression failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Uncompress compressed data buffer (synchronous for in-memory mode)
+     * Handles decompression and hash verification
+     * Internal method only
+     */
+    async unCompress(compressedData, entry, skipHashCheck) {
+        this.log(`unCompress() called for entry: ${entry.filename}, method: ${entry.cmpMethod}, data length: ${compressedData.length}`);
+        if (compressedData.length === 0) {
+            return Buffer.alloc(0);
+        }
+        let outBuf;
+        if (entry.cmpMethod === Headers_1.CMP_METHOD.STORED) {
+            outBuf = compressedData;
+        }
+        else if (entry.cmpMethod === Headers_1.CMP_METHOD.DEFLATED) {
+            // Use synchronous inflate for deflate
+            outBuf = this.inflate(compressedData);
+        }
+        else if (entry.cmpMethod === Headers_1.CMP_METHOD.ZSTD) {
+            // Use ZSTD decompression (now async with ZstdManager)
+            outBuf = await this.zstdDecompressSync(compressedData);
+        }
+        else {
+            throw new Error(`Unsupported compression method: ${entry.cmpMethod}`);
+        }
+        // Verify hash
+        if (!skipHashCheck) {
+            if (entry.sha256) {
+                const isValid = this.zipkit.testSHA256(entry, outBuf);
+                if (!isValid) {
+                    throw new Error(Errors_1.default.INVALID_SHA256);
+                }
+            }
+            else {
+                const isValid = this.zipkit.testCRC32(entry, outBuf);
+                if (!isValid) {
+                    throw new Error(Errors_1.default.INVALID_CRC);
+                }
+            }
+        }
+        return outBuf;
+    }
+}
+// Class-level logging control - set to true to enable logging
+ZipDecompress.loggingEnabled = false;
+// Default export for internal use by Zipkit only
+exports.default = ZipDecompress;
+//# sourceMappingURL=ZipDecompress.js.map

package/dist/core/ZipDecompress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZipDecompress.js","sourceRoot":"","sources":["../../src/core/ZipDecompress.ts"],"names":[],"mappings":"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"}