@neoware_inc/neozipkit 0.5.0

package/dist/core/Zipkit.js

@@ -0,0 +1,647 @@
+"use strict";
+// ======================================
+//	Zipkit.ts - Enhanced Zipkit with Dual Mode Support
+//  Copyright (c) 2025 NeoWare, Inc. All rights reserved.
+// ======================================
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HDR_ID = exports.CENTRAL_DIRECTORY_END = exports.CENTRAL_FILE_HEADER = exports.LOCAL_FILE_HEADER = exports.GP_FLAG = exports.ZIP64_CENTRAL_DIR = exports.ZIP64_CENTRAL_END = exports.CENTRAL_DIR = exports.CENTRAL_END = exports.ENCRYPT_HDR_SIZE = exports.LOCAL_HDR = exports.TOKENIZED_METADATA = exports.TIMESTAMP_SUBMITTED = exports.TIMESTAMP_METADATA = exports.CMP_METHOD = exports.Errors = exports.ZipEntry = void 0;
+const ZipEntry_1 = __importDefault(require("./ZipEntry"));
+exports.ZipEntry = ZipEntry_1.default;
+const Errors_1 = __importDefault(require("./constants/Errors"));
+exports.Errors = Errors_1.default;
+const Logger_1 = require("./components/Logger");
+const types_1 = require("../types");
+const ZipCompress_1 = require("./ZipCompress");
+const ZipDecompress_1 = __importDefault(require("./ZipDecompress"));
+const ZipCrypto_1 = require("./encryption/ZipCrypto");
+const HashCalculator_1 = __importDefault(require("./components/HashCalculator"));
+const Headers_1 = require("./constants/Headers");
+Object.defineProperty(exports, "LOCAL_HDR", { enumerable: true, get: function () { return Headers_1.LOCAL_HDR; } });
+Object.defineProperty(exports, "ENCRYPT_HDR_SIZE", { enumerable: true, get: function () { return Headers_1.ENCRYPT_HDR_SIZE; } });
+Object.defineProperty(exports, "CMP_METHOD", { enumerable: true, get: function () { return Headers_1.CMP_METHOD; } });
+Object.defineProperty(exports, "CENTRAL_END", { enumerable: true, get: function () { return Headers_1.CENTRAL_END; } });
+Object.defineProperty(exports, "CENTRAL_DIR", { enumerable: true, get: function () { return Headers_1.CENTRAL_DIR; } });
+Object.defineProperty(exports, "ZIP64_CENTRAL_END", { enumerable: true, get: function () { return Headers_1.ZIP64_CENTRAL_END; } });
+Object.defineProperty(exports, "ZIP64_CENTRAL_DIR", { enumerable: true, get: function () { return Headers_1.ZIP64_CENTRAL_DIR; } });
+Object.defineProperty(exports, "GP_FLAG", { enumerable: true, get: function () { return Headers_1.GP_FLAG; } });
+Object.defineProperty(exports, "TIMESTAMP_SUBMITTED", { enumerable: true, get: function () { return Headers_1.TIMESTAMP_SUBMITTED; } });
+Object.defineProperty(exports, "TIMESTAMP_METADATA", { enumerable: true, get: function () { return Headers_1.TIMESTAMP_METADATA; } });
+Object.defineProperty(exports, "TOKENIZED_METADATA", { enumerable: true, get: function () { return Headers_1.TOKENIZED_METADATA; } });
+Object.defineProperty(exports, "LOCAL_FILE_HEADER", { enumerable: true, get: function () { return Headers_1.LOCAL_FILE_HEADER; } });
+Object.defineProperty(exports, "CENTRAL_FILE_HEADER", { enumerable: true, get: function () { return Headers_1.CENTRAL_FILE_HEADER; } });
+Object.defineProperty(exports, "CENTRAL_DIRECTORY_END", { enumerable: true, get: function () { return Headers_1.CENTRAL_DIRECTORY_END; } });
+Object.defineProperty(exports, "HDR_ID", { enumerable: true, get: function () { return Headers_1.HDR_ID; } });
+/**
+ * Zipkit - Enhanced ZIP File Processing Library with Dual Mode Support
+ *
+ * Core ZIP file processing library supporting both buffer-based (in-memory) and
+ * file-based (streaming) modes. See README.md for detailed documentation.
+ *
+ * @class Zipkit
+ * @static {string} version - Library version string
+ * @static {string} releaseDate - Library release date
+ */
+class Zipkit {
+    /**
+     * Creates a new Zipkit instance with optional configuration
+     *
+     * @param config - Optional configuration object (ZipkitConfig)
+     *   - bufferSize: Buffer size for streaming operations (default: 512KB)
+     *   - debug: Enable debug logging (default: false)
+     *
+     * @example
+     * const zip = new Zipkit({ bufferSize: 512 * 1024, debug: true });
+     */
+    constructor(config = {}) {
+        // In-memory mode data
+        this.inBuffer = null;
+        this.zipEntries = []; // Protected: single source of truth for ZIP entry order (accessible by subclasses)
+        this.centralDirSize = 0;
+        this.centralDirOffset = 0;
+        // Common data
+        this.zipComment = null;
+        // Private components (lazy-loaded)
+        this._zipkitCmp = null;
+        this._zipkitDeCmp = null;
+        this.config = {
+            bufferSize: config.bufferSize || 512 * 1024, // 512KB default (optimal for modern systems)
+            debug: config.debug || false // Default false
+        };
+        // Configure Logger based on debug setting
+        if (this.config.debug) {
+            Logger_1.Logger.setLevel('debug');
+        }
+        // Note: ZipCompress and ZipDecompress are lazy-loaded when first accessed
+        // ZSTD codec is also lazily initialized on first use (module-level singleton)
+    }
+    /**
+     * Lazy-load ZipCompress instance
+     * @returns ZipCompress instance (created on first access)
+     */
+    getZipCompress() {
+        if (!this._zipkitCmp) {
+            this._zipkitCmp = new ZipCompress_1.ZipCompress(this);
+        }
+        return this._zipkitCmp;
+    }
+    /**
+     * Lazy-load ZipDecompress instance
+     * @returns ZipDecompress instance (created on first access)
+     */
+    getZipDecompress() {
+        if (!this._zipkitDeCmp) {
+            this._zipkitDeCmp = new ZipDecompress_1.default(this);
+        }
+        return this._zipkitDeCmp;
+    }
+    /**
+     * Get the configured buffer size for streaming operations
+     * @returns Buffer size in bytes (default: 512KB)
+     */
+    getBufferSize() {
+        return this.config.bufferSize || 512 * 1024; // 512KB default (optimal for modern systems)
+    }
+    /**
+     * Check if ZIP is loaded in buffer mode
+     * @returns true if buffer-based ZIP is loaded
+     */
+    hasInBuffer() {
+        return this.inBuffer !== null && this.inBuffer.length > 0;
+    }
+    // ============================================================================
+    // ZipCompress Wrapper Methods
+    // ============================================================================
+    /**
+     * Compress data for a ZIP entry (Buffer-based only)
+     * Wrapper for ZipCompress.compressData()
+     *
+     * @param entry - ZIP entry to compress
+     * @param data - Buffer containing data to compress
+     * @param options - Compression options
+     * @param onOutputBuffer - Optional callback for streaming output
+     * @returns Promise resolving to Buffer containing compressed data
+     */
+    async compressData(entry, data, options, onOutputBuffer) {
+        return this.getZipCompress().compressData(entry, data, options, onOutputBuffer);
+    }
+    /**
+     * Compress data using deflate algorithm with chunked processing
+     * Wrapper for ZipCompress.deflateCompress()
+     *
+     * @param data - Data to compress (Buffer or chunked reader)
+     * @param options - Compression options
+     * @param bufferSize - Size of buffer to read (default: 512KB)
+     * @param entry - Optional ZIP entry for hash calculation
+     * @param onOutputBuffer - Optional callback for streaming output
+     * @returns Promise resolving to Buffer containing compressed data
+     */
+    async deflateCompress(data, options, bufferSize, entry, onOutputBuffer) {
+        return this.getZipCompress().deflateCompress(data, options, bufferSize, entry, onOutputBuffer);
+    }
+    /**
+     * Compress data using deflate algorithm (synchronous, small buffers only)
+     * Wrapper for ZipCompress.deflate()
+     *
+     * @param inbuf - Buffer containing data to compress
+     * @param options - Compression options
+     * @returns Buffer containing compressed data
+     */
+    deflate(inbuf, options) {
+        return this.getZipCompress().deflate(inbuf, options);
+    }
+    /**
+     * Compress data using Zstandard (zstd) algorithm
+     * Wrapper for ZipCompress.zstdCompress()
+     *
+     * Note: ZSTD codec is lazily initialized on first use (module-level singleton).
+     * Initialization happens automatically when needed.
+     *
+     * @param input - Buffer to compress OR chunked reader object
+     * @param options - Compression options
+     * @param bufferSize - Size of buffer to read if using chunked reader (default: 512KB)
+     * @param entry - Optional ZIP entry for hash calculation
+     * @param onOutputBuffer - Optional callback for streaming output
+     * @returns Promise resolving to Buffer containing compressed data
+     */
+    async zstdCompress(input, options, bufferSize, entry, onOutputBuffer) {
+        return this.getZipCompress().zstdCompress(input, options, bufferSize, entry, onOutputBuffer);
+    }
+    /**
+     * Compress file data in memory and return ZIP entry information as Buffer
+     * Wrapper for ZipCompress.compressFileBuffer()
+     *
+     * @param entry - ZIP entry to compress
+     * @param fileData - File data buffer to compress
+     * @param cmpOptions - Compression options
+     * @returns Promise resolving to Buffer containing local header + compressed data
+     */
+    async compressFileBuffer(entry, fileData, cmpOptions) {
+        return this.getZipCompress().compressFileBuffer(entry, fileData, cmpOptions);
+    }
+    // ============================================================================
+    // ZipDecompress Wrapper Methods
+    // ============================================================================
+    /**
+     * Extract file data (Buffer-based ZIP only)
+     * Wrapper for ZipDecompress.extract()
+     *
+     * @param entry - ZIP entry to extract
+     * @param skipHashCheck - Skip hash verification (CRC-32 or SHA-256)
+     * @returns Promise resolving to Buffer containing extracted data, or null if failed
+     * @throws Error if not a Buffer-based ZIP
+     */
+    async extract(entry, skipHashCheck) {
+        return this.getZipDecompress().extract(entry, skipHashCheck);
+    }
+    // ============================================================================
+    // Static Logging Wrapper Methods
+    // ============================================================================
+    /**
+     * Note: Logging for ZipCompress and ZipDecompress is controlled by their
+     * static loggingEnabled property. Set it directly:
+     *   ZipCompress.loggingEnabled = true/false;
+     *   ZipDecompress.loggingEnabled = true/false;
+     */
+    /**
+     * Load ZIP file from buffer (in-memory mode)
+     *
+     * **Required**: You must call this method (or the appropriate load method for your platform)
+     * before calling `getDirectory()` or any other ZIP operations. This method:
+     * 1. Resets all ZIP data
+     * 2. Stores the buffer in this.inBuffer
+     * 3. Loads EOCD and parses central directory
+     * 4. Populates this.zipEntries[] array
+     *
+     * For browser applications, use `ZipkitBrowser.loadZipBlob()` instead.
+     * For server applications with file paths, use `ZipkitServer.loadZipFile()` instead.
+     *
+     * @param inBuf - Buffer containing the complete ZIP file data
+     * @returns ZipEntry[] Array of all entries in the ZIP file
+     */
+    loadZip(inBuf) {
+        this.resetZipData();
+        // Store buffer for backward compatibility with detection logic
+        this.inBuffer = inBuf;
+        // Load EOCD and parse central directory
+        this.loadEOCDFromBuffer(inBuf);
+        const entries = this.getDirectoryFromBuffer();
+        this.zipEntries = entries;
+        return entries;
+    }
+    /**
+     * Reset all ZIP-related data to initial state
+     *
+     * Clears all internal state including zipEntries[], inBuffer, and zipComment.
+     *
+     * Note: ZipCompress and ZipDecompress instances are not recreated.
+     * ZSTD codec is a module-level singleton and is lazily initialized on first use,
+     * so no cleanup is needed. No memory buffers are allocated until compression/decompression
+     * operations are performed.
+     */
+    resetZipData() {
+        this.inBuffer = null;
+        this.zipEntries = [];
+        this.reset();
+        this.zipComment = null;
+        // Reset lazy-loaded components so they can be recreated on next access
+        this._zipkitCmp = null;
+        this._zipkitDeCmp = null;
+        // Note: ZSTD codec is module-level singleton, so no cleanup needed
+    }
+    /**
+     * Get central directory entries (synchronous, buffer-based only)
+     *
+     * Returns entries from zipEntries[] array which serves as unified storage.
+     *
+     * **Important**: This method does NOT load the ZIP file. You must call `loadZip()` first
+     * to populate zipEntries[]. If the ZIP is not loaded, this method returns an empty array.
+     *
+     * @param debug - Optional debug flag for logging
+     * @returns Array of ZipEntry objects, or empty array if ZIP not loaded
+     */
+    getDirectory(debug) {
+        return this.zipEntries;
+    }
+    /**
+     * Get specific ZIP entry by filename from zipEntries[] array
+     *
+     * @param filename - The name/path of the file/directory to find
+     * @returns ZipEntry object if found, null if not found
+     */
+    getZipEntry(filename) {
+        try {
+            const centralDir = this.getDirectory();
+            return centralDir.find((entry) => entry.filename === filename) || null;
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    /**
+     * Ensure buffer is available (in-memory mode)
+     */
+    ensureBuffer() {
+        if (!this.inBuffer) {
+            this.inBuffer = Buffer.alloc(0);
+        }
+        return this.inBuffer;
+    }
+    /**
+     * Parse local header (in-memory mode)
+     */
+    parseLocalHeader(entry, buffer) {
+        const localData = buffer.subarray(entry.localHdrOffset);
+        if (localData.readUInt32LE(0) !== Headers_1.LOCAL_HDR.SIGNATURE) {
+            throw new Error(Errors_1.default.INVALID_CEN);
+        }
+        let _encryptLen = 0;
+        const _bitFlags = localData.readUInt16LE(Headers_1.LOCAL_HDR.FLAGS);
+        if (_bitFlags & Headers_1.GP_FLAG.ENCRYPTED) {
+            _encryptLen = Headers_1.ENCRYPT_HDR_SIZE;
+        }
+        let _fnameLen = localData.readUInt16LE(Headers_1.LOCAL_HDR.FNAME_LEN);
+        let _extraLen = localData.readUInt16LE(Headers_1.LOCAL_HDR.EXTRA_LEN);
+        let _localSize = Headers_1.LOCAL_HDR.SIZE + _fnameLen + _extraLen;
+        // For encrypted files: entry.compressedSize from central directory includes the 12-byte encryption header
+        // parseLocalHeader should return encrypted data WITHOUT the header (decryptBuffer will extract and prepend it)
+        // Structure: [local header][filename][extra][12-byte encryption header][encrypted compressed data]
+        // We need to read: encrypted compressed data (without the 12-byte header)
+        // Start: _localSize + _encryptLen (after the header)
+        // End: _localSize + entry.compressedSize (total includes header, so this gives us data without header)
+        const dataStart = _localSize + _encryptLen;
+        const dataEnd = _localSize + entry.compressedSize;
+        // Return encrypted data WITHOUT the encryption header
+        // decryptBuffer will extract the header from localSize to localSize+12 and prepend it
+        return localData.subarray(dataStart, dataEnd);
+    }
+    /**
+     * Test CRC32 checksum
+     * Always checks CRC against entry.crc from central directory
+     * For DATA_DESC files, CRC is stored in central directory, not local header
+     */
+    testCRC32(entry, data) {
+        // Always check CRC against entry.crc from central directory
+        // For DATA_DESC files, CRC is stored in central directory, not local header
+        const _crc = (0, ZipCrypto_1.crc32)(data);
+        const isValid = _crc === entry.crc;
+        Logger_1.Logger.debug(`[DEBUG] testCRC32() comparison: calculated=${_crc}, stored=${entry.crc}, isValid=${isValid ? '✓' : '✗'}, DATA_DESC=${(entry.bitFlags & 0x8) !== 0 ? 'YES' : 'NO'}`);
+        return isValid;
+    }
+    /**
+     * Test SHA256 hash
+     */
+    testSHA256(entry, data) {
+        if (!entry.sha256) {
+            throw new Error(Errors_1.default.UNKNOWN_SHA256);
+        }
+        const _sha256 = (0, ZipCrypto_1.sha256)(data);
+        const isValid = _sha256 === entry.sha256;
+        Logger_1.Logger.debug(`[DEBUG] testSHA256() comparison: calculated=${_sha256}, stored=${entry.sha256}, isValid=${isValid ? '✓' : '✗'}`);
+        return isValid;
+    }
+    /**
+     * Get memory usage statistics
+     *
+     * @returns Object containing backend type, total memory usage in bytes, and entry count
+     */
+    getMemoryUsage() {
+        const baseMemory = this.inBuffer?.length || 0;
+        const entriesMemory = this.zipEntries.length * 1024; // Approximate memory per entry
+        let backend;
+        if (this.inBuffer) {
+            backend = 'buffer';
+        }
+        else {
+            // Zipkit is buffer-based only, so if no buffer, backend is 'none'
+            // For file-based operations, use ZipkitServer
+            backend = 'none';
+        }
+        return {
+            backend,
+            memoryUsage: baseMemory + entriesMemory,
+            entries: this.zipEntries.length
+        };
+    }
+    /**
+     * Create a new ZIP entry and automatically add it to zipEntries[]
+     *
+     * @param filename - Entry filename
+     * @param data - Optional entry data (for CRC calculation)
+     * @param options - Optional entry options
+     * @returns Created ZipEntry instance
+     */
+    createZipEntry(filename, data, options) {
+        const entry = new ZipEntry_1.default(filename, null, false);
+        // Set basic properties
+        if (data) {
+            entry.crc = (0, ZipCrypto_1.crc32)(data);
+            entry.uncompressedSize = data.length;
+            entry.compressedSize = data.length;
+        }
+        else {
+            entry.crc = 0;
+            entry.uncompressedSize = 0;
+            entry.compressedSize = 0;
+        }
+        entry.cmpMethod = Headers_1.CMP_METHOD.STORED;
+        entry.bitFlags = 0;
+        // Note: lastModTime and lastModDate properties may not exist in ZipEntry
+        // entry.lastModTime = Math.floor(Date.now() / 1000);
+        // entry.lastModDate = Math.floor(Date.now() / 1000);
+        // Automatically add entry to zipEntries[] (maintains order as single source of truth)
+        this.zipEntries.push(entry);
+        return entry;
+    }
+    /**
+     * Copy entry from another ZIP (buffer-based only)
+     * For file-based ZIP operations, use ZipkitServer.copyEntry()
+     */
+    async copyEntry(sourceEntry) {
+        // For Buffer-based ZIP, we need to reconstruct the entry data
+        // This is a simplified version - in practice, you'd need to read from the original ZIP
+        if (sourceEntry.cmpData) {
+            const localHdr = sourceEntry.createLocalHdr();
+            return Buffer.concat([localHdr, sourceEntry.cmpData]);
+        }
+        throw new Error('Cannot copy entry: no compressed data available');
+    }
+    /**
+     * Central end header getter (for compatibility)
+     *
+     * Returns a function that creates the central end header using totalEntries from zipEntries[].
+     *
+     * @returns Function that creates central end header buffer
+     */
+    get centralEndHdr() {
+        // Return a function that calls centralEndHdr with totalEntries from zipEntries[]
+        return (centralDirSize, centralDirOffset) => {
+            const totalEntries = this.zipEntries.length;
+            return this.centralEndHdrMethod(centralDirSize, centralDirOffset, totalEntries);
+        };
+    }
+    /**
+     * Get ZIP comment
+     *
+     * @returns ZIP file comment string or null
+     */
+    getZipComment() {
+        return this.zipComment;
+    }
+    // ============================================================================
+    // Buffer-based ZIP Loading Methods (merged from ZipLoadEntries)
+    // ============================================================================
+    /**
+     * Load EOCD from in-memory buffer (buffer mode)
+     */
+    loadEOCDFromBuffer(buffer) {
+        const fileSize = buffer.length;
+        const searchSize = Math.min(0xFFFF + 22, fileSize);
+        const searchStart = fileSize - searchSize;
+        const scan = buffer.subarray(searchStart, searchStart + searchSize);
+        // Find EOCD signature
+        let eocdOffset = -1;
+        for (let i = scan.length - 22; i >= 0; i--) {
+            if (scan[i] === 0x50) {
+                if (scan.readUInt32LE(i) === Headers_1.CENTRAL_END.SIGNATURE) {
+                    eocdOffset = searchStart + i;
+                    break;
+                }
+            }
+        }
+        if (eocdOffset === -1) {
+            throw new Error(Errors_1.default.INVALID_FORMAT);
+        }
+        const eocdBuffer = buffer.subarray(eocdOffset, eocdOffset + 22);
+        if (eocdBuffer.readUInt32LE(0) === Headers_1.CENTRAL_END.SIGNATURE) {
+            this.centralDirSize = eocdBuffer.readUInt32LE(Headers_1.CENTRAL_END.CENTRAL_DIR_SIZE);
+            this.centralDirOffset = eocdBuffer.readUInt32LE(Headers_1.CENTRAL_END.CENTRAL_DIR_OFFSET);
+            if (this.centralDirOffset === 0xFFFFFFFF) {
+                // ZIP64: locate locator (20 bytes before EOCD) and then ZIP64 EOCD (56 bytes)
+                const locatorOffset = eocdOffset - 20;
+                const locatorBuffer = buffer.subarray(locatorOffset, locatorOffset + 20);
+                if (locatorBuffer.readUInt32LE(0) === Headers_1.ZIP64_CENTRAL_END.SIGNATURE) {
+                    const zip64Offset = Number(locatorBuffer.readBigUInt64LE(8));
+                    const zip64Buffer = buffer.subarray(zip64Offset, zip64Offset + 56);
+                    this.centralDirSize = Number(zip64Buffer.readBigUInt64LE(Headers_1.ZIP64_CENTRAL_DIR.CENTRAL_DIR_SIZE));
+                    this.centralDirOffset = Number(zip64Buffer.readBigUInt64LE(Headers_1.ZIP64_CENTRAL_DIR.CENTRAL_DIR_OFFSET));
+                }
+            }
+        }
+        else {
+            throw new Error(Errors_1.default.INVALID_FORMAT);
+        }
+        // ZIP comment
+        const commentLength = eocdBuffer.readUInt16LE(Headers_1.CENTRAL_END.ZIP_COMMENT_LEN);
+        if (commentLength > 0) {
+            const commentStart = eocdOffset + 22;
+            this.zipComment = buffer.subarray(commentStart, commentStart + commentLength).toString();
+        }
+    }
+    /**
+     * Get directory from buffer (buffer mode only)
+     * Note: zipEntries[] in Zipkit is the single source of truth for caching.
+     * This method always parses fresh from the buffer.
+     */
+    getDirectoryFromBuffer() {
+        if (!this.inBuffer) {
+            return [];
+        }
+        const buffer = this.inBuffer;
+        const entries = [];
+        let offset = this.centralDirOffset;
+        let remaining = this.centralDirSize;
+        const bufferSize = this.config.bufferSize || 512 * 1024;
+        while (remaining > 0) {
+            const currentBufferSize = Math.min(bufferSize, remaining);
+            const chunk = buffer.subarray(offset, offset + currentBufferSize);
+            // Parse entries from chunk
+            let chunkOffset = 0;
+            while (chunkOffset < chunk.length) {
+                if (chunk.readUInt32LE(chunkOffset) !== Headers_1.CENTRAL_DIR.SIGNATURE) {
+                    break; // End of central directory
+                }
+                // Parse central directory entry
+                const entry = new ZipEntry_1.default(null, null, false);
+                const entryData = chunk.subarray(chunkOffset);
+                const remainingData = entry.readZipEntry(entryData);
+                entries.push(entry);
+                // Move to next entry
+                chunkOffset += (entryData.length - remainingData.length);
+            }
+            offset += currentBufferSize;
+            remaining -= currentBufferSize;
+        }
+        // Return entries in original order (do NOT sort by default)
+        // Central directory order should match data section order
+        // Note: zipEntries[] in Zipkit is the single source of truth for caching
+        return entries;
+    }
+    /**
+     * Reset internal state (private method for Zipkit to call)
+     * Clears all ZIP-related data while keeping the instance alive
+     */
+    reset() {
+        this.centralDirSize = 0;
+        this.centralDirOffset = 0;
+    }
+    /**
+     * Create central end header
+     * Note: totalEntries must be passed as parameter since zipEntries[] in Zipkit is the cache
+     */
+    centralEndHdrMethod(centralDirSize, centralDirOffset, totalEntries) {
+        const ceBuf = Buffer.alloc(Headers_1.CENTRAL_END.SIZE);
+        ceBuf.writeUInt32LE(Headers_1.CENTRAL_END.SIGNATURE, 0);
+        ceBuf.writeUInt16LE(0, 4); // Number of this disk
+        ceBuf.writeUInt16LE(0, 6); // Number of the disk with the start of the central directory
+        ceBuf.writeUInt16LE(totalEntries, 8); // Total number of entries
+        ceBuf.writeUInt16LE(totalEntries, 10); // Total number of entries on this disk
+        ceBuf.writeUInt32LE(centralDirSize, 12); // Size of central directory
+        ceBuf.writeUInt32LE(centralDirOffset, 16); // Offset of start of central directory
+        ceBuf.writeUInt16LE(0, 20); // ZIP file comment length
+        return ceBuf;
+    }
+    /**
+     * Calculate Merkle Root of the ZIP file
+     *
+     * Excludes metadata files (META-INF) to ensure consistent calculation.
+     * Simply calls getDirectory() and returns null if empty.
+     *
+     * @returns Merkle root string or null if calculation fails
+     */
+    getMerkleRoot() {
+        // Simply get directory - no loading logic
+        let zipEntries;
+        try {
+            zipEntries = this.getDirectory();
+        }
+        catch (error) {
+            // Catch any errors from getDirectory() - this should never happen
+            // but if it does, log it and return null
+            Logger_1.Logger.error(`getMerkleRoot(): Error calling getDirectory(): ${error instanceof Error ? error.message : String(error)}`);
+            Logger_1.Logger.error(`getMerkleRoot(): Stack trace: ${error instanceof Error ? error.stack : 'No stack trace'}`);
+            return null;
+        }
+        if (!zipEntries || zipEntries.length === 0) {
+            return null;
+        }
+        const hashAccumulator = new HashCalculator_1.default({ enableAccumulation: true });
+        // Filter out metadata files (META-INF) to ensure consistent Merkle Root calculation
+        // Inline check to avoid conflict with ZipkitBrowser's isMetadataFile() method
+        const contentEntries = zipEntries.filter(entry => {
+            const filename = entry.filename || '';
+            return filename !== Headers_1.TIMESTAMP_SUBMITTED &&
+                filename !== Headers_1.TIMESTAMP_METADATA &&
+                filename !== Headers_1.TOKENIZED_METADATA;
+        });
+        for (const entry of contentEntries) {
+            if (entry.sha256) {
+                // Convert hex string to Buffer
+                const hashBuffer = Buffer.from(entry.sha256, 'hex');
+                hashAccumulator.addHash(hashBuffer);
+            }
+        }
+        const merkleRoot = hashAccumulator.merkleRoot();
+        if (!merkleRoot) {
+            return null;
+        }
+        return merkleRoot;
+    }
+    /**
+     * Calculate Merkle Root of the ZIP file asynchronously
+     *
+     * Excludes metadata files (META-INF) to ensure consistent calculation.
+     * Works with both buffer-based and file-based ZIPs.
+     *
+     * @returns Promise resolving to Merkle root string or null if calculation fails
+     */
+    async getMerkleRootAsync() {
+        let zipEntries = [];
+        try {
+            // Get entries based on ZIP type
+            if (this.inBuffer) {
+                zipEntries = this.getDirectory();
+            }
+            else {
+                // File-based: cannot get entries synchronously - return null
+                // Caller should use ZipkitServer.getMerkleRootAsync() for file-based ZIPs
+                Logger_1.Logger.error('getMerkleRootAsync() called on file-based ZIP. Use ZipkitServer.getMerkleRootAsync() instead.');
+                return null;
+            }
+        }
+        catch (error) {
+            Logger_1.Logger.error(`Failed to get directory for merkle root calculation: ${error instanceof Error ? error.message : String(error)}`);
+            return null;
+        }
+        if (!zipEntries || zipEntries.length === 0) {
+            return null;
+        }
+        const hashAccumulator = new HashCalculator_1.default({ enableAccumulation: true });
+        // Filter out metadata files (META-INF) to ensure consistent Merkle Root calculation
+        // Inline check to avoid conflict with ZipkitBrowser's isMetadataFile() method
+        const contentEntries = zipEntries.filter(entry => {
+            const filename = entry.filename || '';
+            return filename !== Headers_1.TIMESTAMP_SUBMITTED &&
+                filename !== Headers_1.TIMESTAMP_METADATA &&
+                filename !== Headers_1.TOKENIZED_METADATA;
+        });
+        for (const entry of contentEntries) {
+            if (entry.sha256) {
+                // Convert hex string to Buffer
+                const hashBuffer = Buffer.from(entry.sha256, 'hex');
+                hashAccumulator.addHash(hashBuffer);
+            }
+        }
+        const merkleRoot = hashAccumulator.merkleRoot();
+        if (!merkleRoot) {
+            return null;
+        }
+        return merkleRoot;
+    }
+}
+Zipkit.version = types_1.NEOZIPKIT_INFO.version;
+Zipkit.releaseDate = types_1.NEOZIPKIT_INFO.releaseDate;
+exports.default = Zipkit;
+//# sourceMappingURL=Zipkit.js.map

package/dist/core/Zipkit.js.map

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