neozipkit 0.1.1

package/dist/shared/ZipEntry.js

@@ -0,0 +1,686 @@
+"use strict";
+// ======================================
+//	ZipEntry.ts
+//  Copyright (c) 2025 NeoWare, Inc. All rights reserved.
+// ======================================
+// Zip Directory Item class
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const Errors_1 = __importDefault(require("./constants/Errors"));
+const Headers_1 = require("./constants/Headers");
+const Util_1 = require("./components/Util");
+const VER_ENCODING = 30;
+const VER_EXTRACT = 10; // Version needed to extract (1.0)
+/**
+ * Class representing a single entry (file or directory) within a ZIP archive
+ */
+class ZipEntry {
+    /**
+     * Creates a new ZIP entry
+     * @param fname - Name of the file within the ZIP
+     * @param comment - Optional comment for this entry
+     * @param debug - Enable debug logging
+     */
+    constructor(fname, comment, debug) {
+        this.debug = true;
+        this.verMadeBy = 0; // Read Version Made By
+        this.verExtract = 0; // Read Version Needed to Extract
+        this.bitFlags = 0; // General purpose bit flag
+        this.cmpMethod = 0; // Compression method
+        this.timeDateDOS = 0; // DOS File Time(2 bytes) & Date(2 bytes) 
+        this.crc = 0; // CRC-32
+        this.compressedSize = 0; // Compressed size
+        this.uncompressedSize = 0; // Uncompressed size
+        this.volNumber = 0; // Disk number start
+        this.intFileAttr = 0; // Internal file attributes
+        this.extFileAttr = 0; // External file attributes
+        this.localHdrOffset = 0; // Relative offset to local header from File/Disk start
+        this.filename = ''; // File name
+        this.extraField = null; // Extra field
+        this.comment = null; // Entry comment
+        // File Data
+        this.fileBuffer = null; // File Data Buffer
+        // Zip Compressed Data
+        this.cmpData = null; // Compressed Data Buffer
+        this.isEncrypted = false; // Zip Entry is encrypted
+        this.isStrongEncrypt = false; // Zip Entry is strong encrypted
+        this.encryptHdr = null; // Encrypted Header (12 bytes)
+        this.lastModTimeDate = 0; // Data Descriptor File Time & Date
+        this.decrypt = null; // Decrypt Class Function
+        this.isUpdated = true; // Entry has been updated
+        this.isDirectory = false; // Entry is a directory
+        this.isMetaData = false; // Entry is Zip MetaData
+        // Platform specific data
+        this.platform = null; // Platform
+        this.universalTime = null; // Universal Time
+        this.uid = null; // User ID
+        this.gid = null; // Group ID
+        this.sha256 = null; // SHA-256 hash of the file
+        this.isMSDOS = this.platform === null;
+        this.isUnixLike = this.platform != null && this.platform !== 'win32';
+        this.isMacOS = this.platform != null && this.platform === 'darwin';
+        this.isLinux = this.platform != null && this.platform === 'linux';
+        this.VER_MADE_BY = (() => {
+            switch (this.platform) {
+                case 'darwin':
+                    return (Headers_1.FILE_SYSTEM.DARWIN << 8) | VER_ENCODING; // macOS/Darwin
+                case 'win32':
+                    return (Headers_1.FILE_SYSTEM.NTFS << 8) | VER_ENCODING; // Windows
+                default:
+                    return (Headers_1.FILE_SYSTEM.UNIX << 8) | VER_ENCODING; // Unix/Linux
+            }
+        })();
+        this.filename = fname || '';
+        this.comment = comment || null;
+        this.debug = debug || false;
+        // Set the UTF-8 Language Encoding Flag (EFS) to indicate UTF-8 encoding for filenames
+        this.bitFlags |= Headers_1.GP_FLAG.EFS;
+    }
+    /**
+     * Reads ZIP entry data from a central directory buffer
+     * @param data - Buffer containing central directory entry data
+     * @returns Buffer positioned at start of next entry
+     * @throws Error if central directory entry is invalid
+     */
+    readZipEntry(data) {
+        // Check if buffer is too small before trying to read from it
+        if (data.length < Headers_1.CENTRAL_DIR.SIZE) {
+            throw new Error('Zip entry data is too small or corrupt');
+        }
+        // Verify this is a Central Directory Header
+        // data should be 46 bytes and start with "PK 01 02"
+        if (data.readUInt32LE(0) !== Headers_1.CENTRAL_DIR.SIGNATURE) {
+            throw new Error(Errors_1.default.INVALID_CEN);
+        }
+        // Read Zip version made by
+        this.verMadeBy = data.readUInt16LE(Headers_1.CENTRAL_DIR.VER_MADE);
+        // Read Zip version needed to extract
+        this.verExtract = data.readUInt16LE(Headers_1.CENTRAL_DIR.VER_EXT);
+        // encrypt, decrypt flags
+        this.bitFlags = data.readUInt16LE(Headers_1.CENTRAL_DIR.FLAGS);
+        // Test if Zip Entry is encrypted
+        if ((this.bitFlags & Headers_1.GP_FLAG.ENCRYPTED) != 0) {
+            this.isEncrypted = true;
+            if ((this.bitFlags & Headers_1.GP_FLAG.STRONG_ENCRYPT) != 0)
+                this.isStrongEncrypt = true;
+        }
+        // compression method
+        this.cmpMethod = data.readUInt16LE(Headers_1.CENTRAL_DIR.CMP_METHOD);
+        // modification time (2 bytes time, 2 bytes date)
+        this.timeDateDOS = data.readUInt32LE(Headers_1.CENTRAL_DIR.TIMEDATE_DOS);
+        // uncompressed file crc-32 value
+        this.crc = data.readUInt32LE(Headers_1.CENTRAL_DIR.CRC);
+        // compressed size
+        this.compressedSize = data.readUInt32LE(Headers_1.CENTRAL_DIR.CMP_SIZE);
+        // uncompressed size
+        this.uncompressedSize = data.readUInt32LE(Headers_1.CENTRAL_DIR.UNCMP_SIZE);
+        // volume number start
+        this.volNumber = data.readUInt16LE(Headers_1.CENTRAL_DIR.DISK_NUM);
+        // internal file attributes
+        this.intFileAttr = data.readUInt16LE(Headers_1.CENTRAL_DIR.INT_FILE_ATTR);
+        // external file attributes
+        this.extFileAttr = data.readUInt32LE(Headers_1.CENTRAL_DIR.EXT_FILE_ATTR);
+        if (this.extFileAttr & Headers_1.DOS_FILE_ATTR.DIRECTORY)
+            this.isDirectory = true;
+        // LOC header offset
+        this.localHdrOffset = data.readUInt32LE(Headers_1.CENTRAL_DIR.LOCAL_HDR_OFFSET);
+        // Filename Length - 2 bytes
+        let fnameLen = data.readUInt16LE(Headers_1.CENTRAL_DIR.FNAME_LEN);
+        const filename = data.toString('utf8', Headers_1.CENTRAL_DIR.SIZE, Headers_1.CENTRAL_DIR.SIZE + fnameLen);
+        this.filename = filename;
+        if (this.filename.endsWith('/'))
+            this.isDirectory = true;
+        // Extra Field Length - 2 bytes
+        let extraLen = data.readUInt16LE(Headers_1.CENTRAL_DIR.EXTRA_LEN);
+        if (extraLen > 0) {
+            this.extraField = data.subarray(Headers_1.CENTRAL_DIR.SIZE + fnameLen, Headers_1.CENTRAL_DIR.SIZE + fnameLen + extraLen);
+            // First pass: Check for Unicode Path to ensure correct filename before processing other fields
+            for (let i = 0; i < extraLen;) {
+                let _id = this.extraField.readUInt16LE(i);
+                let _len = this.extraField.readUInt16LE(i + 2);
+                let _data = this.extraField.subarray(i + 4, i + 4 + _len);
+                if (_id === Headers_1.HDR_ID.UNICODE_PATH && _len >= 5) {
+                    // Unicode Path Extra Field
+                    const version = _data.readUInt8(0);
+                    const nameCrc32 = _data.readUInt32LE(1);
+                    // Calculate CRC32 of the current filename
+                    const fnameBuf = Buffer.from(this.filename);
+                    const calculatedCrc = (0, Util_1.crc32)(fnameBuf);
+                    // If CRCs match, use the UTF-8 filename from the extra field
+                    if (calculatedCrc === nameCrc32) {
+                        const unicodeName = _data.subarray(5).toString('utf8');
+                        this.filename = unicodeName;
+                        if (this.debug) {
+                            console.log(`Using Unicode Path: ${this.filename}`);
+                        }
+                    }
+                }
+                i += 4 + _len;
+            }
+            // Second pass: Process all other extra fields
+            for (let i = 0; i < extraLen;) {
+                let _id = this.extraField.readUInt16LE(i);
+                let _len = this.extraField.readUInt16LE(i + 2);
+                let _data = this.extraField.subarray(i + 4, i + 4 + _len);
+                if (_id === Headers_1.HDR_ID.SHA256) {
+                    if (_len === 64)
+                        // Early versions of NeoZip used a UTF-8 encoded string
+                        this.sha256 = _data.toString('utf8');
+                    else
+                        this.sha256 = _data.toString('hex');
+                }
+                else if (_id === Headers_1.HDR_ID.UNV_TIME) {
+                    // Universal Time field has a flag byte followed by a 4-byte timestamp
+                    if (_len >= 5) {
+                        const flags = _data.readUInt8(0);
+                        // Check if modification time is present (bit 0)
+                        if (flags & 0x01) {
+                            this.universalTime = _data.readUInt32LE(1);
+                        }
+                    }
+                }
+                else if (_id === Headers_1.HDR_ID.UID_GID) {
+                    // Extract UID/GID if present
+                    if (_len >= 5) { // Version + UID size + UID + GID size + GID
+                        const version = _data.readUInt8(0);
+                        const uidSize = _data.readUInt8(1);
+                        if (uidSize <= 4 && _len >= 2 + uidSize) {
+                            // Read UID based on its size (1-4 bytes)
+                            this.uid = _data.readUIntLE(2, uidSize);
+                            // Check if GID is also present
+                            if (_len >= 2 + uidSize + 1) {
+                                const gidSize = _data.readUInt8(2 + uidSize);
+                                if (gidSize <= 4 && _len >= 2 + uidSize + 1 + gidSize) {
+                                    this.gid = _data.readUIntLE(2 + uidSize + 1, gidSize);
+                                }
+                            }
+                        }
+                    }
+                }
+                // Skip Unicode Path here as we already processed it
+                i += 4 + _len;
+            }
+        }
+        // File Comment Length - 2 bytes
+        let comLen = data.readUInt16LE(Headers_1.CENTRAL_DIR.COMMENT_LEN);
+        if (comLen > 0)
+            this.comment = data.toString('utf8', Headers_1.CENTRAL_DIR.SIZE + fnameLen + extraLen, Headers_1.CENTRAL_DIR.SIZE + fnameLen + extraLen + comLen);
+        if (this.debug)
+            this.showVerboseInfo();
+        // Calculate the Buffer for the next entry
+        let rawSize = Headers_1.CENTRAL_DIR.SIZE + fnameLen + extraLen + comLen;
+        return data.subarray(rawSize);
+    }
+    /**
+     * Checks if the filename contains characters that require Unicode handling
+     * @returns true if the filename contains non-ASCII characters or special characters
+     */
+    needsUnicodeHandling() {
+        // Check if filename contains non-ASCII characters or special characters like apostrophes
+        return /[^\x00-\x7E]|['"]/.test(this.filename);
+    }
+    /**
+     * Adds UTF-8 Unicode Path field to a buffer
+     * @param buffer - The buffer to write to
+     * @param offset - The offset in the buffer to start writing
+     * @returns The new offset after writing
+     */
+    addUnicodePathField(buffer, offset) {
+        // Create a UTF-8 buffer of the filename
+        const unicodePathBuf = Buffer.from(this.filename, 'utf8');
+        // Calculate CRC32 of the ASCII version of the filename
+        // Create an ASCII version by replacing non-ASCII chars with '?'
+        const asciiName = this.filename.replace(/[^\x00-\x7E]/g, '?');
+        const asciiNameBuf = Buffer.from(asciiName, 'ascii');
+        const nameCrc32 = (0, Util_1.crc32)(asciiNameBuf);
+        // 1 byte version + 4 bytes CRC + filename
+        const unicodePathLen = 5 + unicodePathBuf.length;
+        // Write Unicode Path Extra Field (0x7075)
+        buffer.writeUInt16LE(Headers_1.HDR_ID.UNICODE_PATH, offset); // "up" header ID
+        buffer.writeUInt16LE(unicodePathLen, offset + 2); // data length 
+        buffer.writeUInt8(1, offset + 4); // version (1)
+        buffer.writeUInt32LE(nameCrc32, offset + 5); // CRC-32 of standard filename
+        unicodePathBuf.copy(buffer, offset + 9); // UTF-8 version of filename
+        return offset + 4 + unicodePathLen; // 4 bytes for header + data length
+    }
+    /**
+     * Creates a local header for this ZIP entry
+     * @returns Buffer containing the local header data
+     */
+    createLocalHdr() {
+        const commentLen = this.comment?.length ?? 0;
+        let extraFieldLen = 0;
+        // Only create Unicode Path field if needed
+        const needsUnicode = this.needsUnicodeHandling();
+        if (needsUnicode) {
+            // 1 byte version + 4 bytes CRC + filename + 4 bytes header
+            const unicodeNameLen = Buffer.from(this.filename, 'utf8').length;
+            extraFieldLen = 5 + unicodeNameLen + 4;
+        }
+        const data = Buffer.alloc(Headers_1.LOCAL_HDR.SIZE + this.filename.length + commentLen + extraFieldLen);
+        // "PK\003\004"
+        data.writeUInt32LE(Headers_1.LOCAL_HDR.SIGNATURE, 0);
+        // version needed to extract
+        data.writeUInt16LE(VER_EXTRACT, Headers_1.LOCAL_HDR.VER_EXTRACT);
+        // general purpose bit flag
+        data.writeUInt16LE(this.bitFlags >>> 0, Headers_1.LOCAL_HDR.FLAGS);
+        // compression method
+        data.writeUInt16LE(this.cmpMethod, Headers_1.LOCAL_HDR.COMPRESSION);
+        // modification time (2 bytes time, 2 bytes date)
+        data.writeUInt32LE(this.timeDateDOS >>> 0, Headers_1.LOCAL_HDR.TIMEDATE_DOS);
+        // uncompressed file crc-32 value
+        data.writeUInt32LE(this.crc, Headers_1.LOCAL_HDR.CRC);
+        // compressed size
+        data.writeUInt32LE(this.compressedSize, Headers_1.LOCAL_HDR.CMP_SIZE);
+        // uncompressed size
+        data.writeUInt32LE(this.uncompressedSize, Headers_1.LOCAL_HDR.UNCMP_SIZE);
+        // filename length
+        data.writeUInt16LE(this.filename.length, Headers_1.LOCAL_HDR.FNAME_LEN);
+        // extra field length
+        data.writeUInt16LE(extraFieldLen, Headers_1.LOCAL_HDR.EXTRA_LEN);
+        // Write filename - use ASCII filename (replacing non-ASCII with ?)
+        // This ensures compatibility with older ZIP readers
+        const asciiName = this.filename.replace(/[^\x00-\x7E]/g, '?');
+        const fnameBuf = Buffer.from(asciiName);
+        fnameBuf.copy(data, Headers_1.LOCAL_HDR.SIZE);
+        let extraOffset = Headers_1.LOCAL_HDR.SIZE + fnameBuf.length;
+        // Add Unicode Path Extra Field only if needed
+        if (needsUnicode) {
+            extraOffset = this.addUnicodePathField(data, extraOffset);
+        }
+        // Add comment if present (after extra field)
+        if (commentLen > 0 && this.comment) {
+            const commentBuf = Buffer.from(this.comment, 'utf8');
+            commentBuf.copy(data, extraOffset);
+        }
+        return data;
+    }
+    /**
+     * Creates a central directory entry for this ZIP entry
+     * @returns Buffer containing the central directory entry data
+     */
+    centralDirEntry() {
+        // Calculate the length of the extra fields
+        const commentLen = this.comment?.length ?? 0;
+        const utfLen = this.universalTime ? 9 : 0; // 4 bytes header + 5 bytes data
+        const uidgidLen = this.uid && this.gid ? 11 + 4 : 0; // 1 byte version + 1 byte size + 4 bytes data + 1 byte size + 4 bytes data
+        const sha256Buf = this.sha256 ? Buffer.from(this.sha256, 'hex') : null;
+        const sha256Len = sha256Buf ? (sha256Buf.length + 4) : 0;
+        // Only add Unicode Path field if needed
+        const needsUnicode = this.needsUnicodeHandling();
+        let unicodePathLen = 0;
+        if (needsUnicode) {
+            // 1 byte version + 4 bytes CRC + filename + 4 bytes header
+            const unicodeNameLen = Buffer.from(this.filename, 'utf8').length;
+            unicodePathLen = 5 + unicodeNameLen + 4;
+        }
+        const extraLen = utfLen + sha256Len + uidgidLen + (needsUnicode ? unicodePathLen : 0);
+        // Central directory header size (46 Bytes + filename + comment + extra fields)
+        const data = Buffer.alloc(Headers_1.CENTRAL_DIR.SIZE + this.filename.length + commentLen + extraLen);
+        // "PK\001\002"
+        data.writeUInt32LE(Headers_1.CENTRAL_DIR.SIGNATURE, 0);
+        // Version made by - Needs to be set for NeoZip 
+        data.writeUInt16LE(this.isUpdated ? this.VER_MADE_BY : this.verMadeBy, Headers_1.CENTRAL_DIR.VER_MADE);
+        // Version needed to extract
+        data.writeInt16LE(this.isUpdated ? VER_EXTRACT : this.verMadeBy, Headers_1.CENTRAL_DIR.VER_EXT);
+        // Encrypt, Decrypt Flags
+        data.writeInt16LE(this.bitFlags >>> 0, Headers_1.CENTRAL_DIR.FLAGS);
+        // Compression method
+        data.writeInt16LE(this.cmpMethod, Headers_1.CENTRAL_DIR.CMP_METHOD);
+        // Modification time (2 bytes time, 2 bytes date)
+        data.writeUInt32LE(this.timeDateDOS >>> 0, Headers_1.CENTRAL_DIR.TIMEDATE_DOS);
+        // Uncompressed file CRC-32 value
+        data.writeUInt32LE(this.crc, Headers_1.CENTRAL_DIR.CRC);
+        // Compressed Size
+        data.writeUInt32LE(this.compressedSize, Headers_1.CENTRAL_DIR.CMP_SIZE);
+        // Uncompressed Size
+        data.writeUInt32LE(this.uncompressedSize, Headers_1.CENTRAL_DIR.UNCMP_SIZE);
+        // Filename Length
+        data.writeUInt16LE(this.filename.length, Headers_1.CENTRAL_DIR.FNAME_LEN);
+        // Extra Field Length
+        data.writeUInt16LE(extraLen, Headers_1.CENTRAL_DIR.EXTRA_LEN);
+        // File Comment Length
+        data.writeUInt16LE(commentLen, Headers_1.CENTRAL_DIR.COMMENT_LEN);
+        // Volume Number Start
+        data.writeUInt16LE(0, Headers_1.CENTRAL_DIR.DISK_NUM);
+        // Internal File Attributes
+        data.writeUInt16LE(this.intFileAttr >>> 0, Headers_1.CENTRAL_DIR.INT_FILE_ATTR);
+        // External File Attributes
+        data.writeUInt32LE(this.extFileAttr >>> 0, Headers_1.CENTRAL_DIR.EXT_FILE_ATTR);
+        // Local Header Offset
+        data.writeUInt32LE(this.localHdrOffset, Headers_1.CENTRAL_DIR.LOCAL_HDR_OFFSET);
+        // Write filename - use ASCII filename (replacing non-ASCII with ?)
+        // This ensures compatibility with older ZIP readers
+        const asciiName = this.filename.replace(/[^\x00-\x7E]/g, '?');
+        const fnameBuf = Buffer.from(asciiName);
+        fnameBuf.copy(data, Headers_1.CENTRAL_DIR.SIZE);
+        if (commentLen > 0 && this.comment) {
+            const commentBuf = Buffer.from(this.comment, 'utf8');
+            commentBuf.copy(data, Headers_1.CENTRAL_DIR.SIZE + fnameBuf.length);
+        }
+        // Add Extra Field data
+        let extraOffset = Headers_1.CENTRAL_DIR.SIZE + fnameBuf.length + commentLen;
+        // Add Universal Time field
+        if (this.universalTime) {
+            data.writeUInt16LE(Headers_1.HDR_ID.UNV_TIME, extraOffset); // 0x5455
+            data.writeUInt16LE(5, extraOffset + 2); // Length of data (flags + time)
+            data.writeUInt8(0x03, extraOffset + 4); // Flags: 1=Mod time, 2=Access time
+            data.writeUInt32LE(this.universalTime, extraOffset + 5); // Unix timestamp
+            extraOffset += 9; // 4 bytes header + 1 byte flags + 4 bytes data
+        }
+        // Unix UID/GID Extra Field (0x7875)
+        if (this.uid && this.gid) {
+            const uidgidLen = 11; // 1 byte version + 1 byte size + 4 bytes data + 1 byte size + 4 bytes data
+            data.writeUInt16LE(Headers_1.HDR_ID.UID_GID, extraOffset); // 0x7875
+            data.writeUInt16LE(uidgidLen, extraOffset + 2); // Length
+            data.writeUInt8(1, extraOffset + 4); // Version
+            data.writeUInt8(4, extraOffset + 5); // Size of UID/GID
+            data.writeUInt32LE(this.uid, extraOffset + 6); // UID
+            data.writeUInt8(4, extraOffset + 10); // Size of UID/GID
+            data.writeUInt32LE(this.gid, extraOffset + 11); // GID
+            extraOffset += uidgidLen + 4;
+        }
+        // Add Unicode Path Extra Field only if needed
+        if (needsUnicode) {
+            extraOffset = this.addUnicodePathField(data, extraOffset);
+        }
+        // Add SHA256 field
+        if (sha256Buf) {
+            data.writeUInt16LE(Headers_1.HDR_ID.SHA256, extraOffset);
+            data.writeUInt16LE(sha256Buf.length, extraOffset + 2);
+            sha256Buf.copy(data, extraOffset + 4);
+            extraOffset += sha256Buf.length + 4;
+        }
+        return data;
+    }
+    // ======================================
+    //	Routines to handle the details of the Zip Entry
+    // ======================================
+    /**
+     * Sets the DOS date/time for this entry
+     * @param date - Date to convert to DOS format
+     * @returns number - DOS format date/time
+     */
+    setDateTime(date) {
+        if (!date)
+            return 0;
+        let time = (((date.getFullYear() - 1980) & 0x7f) << 25) | // b09-16 years from 1980
+            ((date.getMonth() + 1) << 21) | // b05-08 month
+            (date.getDate() << 16) | // b00-04 hour
+            // 2 bytes time
+            (date.getHours() << 11) | // b11-15 hour
+            (date.getMinutes() << 5) | // b05-10 minute
+            (date.getSeconds() >> 1); // b00-04 seconds divided by 2
+        return time;
+    }
+    /**
+     * Converts DOS date/time to JavaScript Date
+     * @param timeStamp - DOS format date/time
+     * @returns Date object or null if timestamp is 0
+     */
+    parseDateTime(timeStamp) {
+        if (timeStamp == 0)
+            return null;
+        return new Date(((timeStamp >> 25) & 0x3f) + 1980, // Year
+        ((timeStamp >> 21) & 0x0f) - 1, // Month
+        (timeStamp >> 16) & 0x1f, // Day
+        (timeStamp >> 11) & 0x1f, // Hour
+        (timeStamp >> 5) & 0x3f, // Min
+        (timeStamp & 0x1f) << 1); // Sec 
+    }
+    /**
+     * Formats the entry's date in local format
+     * @returns String in MM/DD/YYYY format or "--/--/----" if no date
+     */
+    toLocalDateString() {
+        let _timeDate = this.parseDateTime(this.timeDateDOS);
+        if (_timeDate === null)
+            return "--/--/----";
+        return _timeDate.toLocaleDateString('en-US', {
+            year: 'numeric',
+            month: '2-digit',
+            day: '2-digit'
+        }).slice(0, 10);
+    }
+    /**
+     * Formats the entry's time
+     * @returns String in HH:MM format or "--:--" if no time
+     */
+    toTimeString() {
+        let _timeDate = this.parseDateTime(this.timeDateDOS);
+        if (_timeDate === null)
+            return "--:--";
+        return _timeDate.toTimeString().slice(0, 5);
+    }
+    /**
+     * Formats the entry's date and time in local format
+     * @returns String like "Jan 01, 2024 13:45:30" or "--/--/-- --:--" if no date/time
+     */
+    toFormattedDateString() {
+        let _timeDate = this.parseDateTime(this.timeDateDOS);
+        if (_timeDate == null)
+            return "--/--/-- --:--";
+        const datePart = _timeDate.toLocaleDateString('en-US', {
+            year: 'numeric',
+            month: 'short',
+            day: '2-digit'
+        });
+        const timePart = _timeDate.toLocaleTimeString('en-US', {
+            hour: '2-digit',
+            minute: '2-digit',
+            second: '2-digit',
+            hour12: false
+        });
+        return `${datePart} ${timePart}`;
+    }
+    /**
+     * Formats the entry's date and time in UTC
+     * @returns String like "Jan 01, 2024 13:45:30 UTC" or "--/--/-- --:--" if no date/time
+     */
+    toFormattedUTCDateString() {
+        let _timeDate = this.parseDateTime(this.timeDateDOS);
+        if (_timeDate == null)
+            return "--/--/-- --:--";
+        const datePart = _timeDate.toLocaleDateString('en-US', {
+            year: 'numeric',
+            month: 'short',
+            day: '2-digit',
+            timeZone: 'UTC'
+        });
+        const timePart = _timeDate.toLocaleTimeString('en-US', {
+            hour: '2-digit',
+            minute: '2-digit',
+            second: '2-digit',
+            hour12: false,
+            timeZone: 'UTC'
+        });
+        return `${datePart} ${timePart} UTC`;
+    }
+    /**
+     * Converts compression method code to human-readable string
+     * @returns String describing the compression method
+     */
+    cmpMethodToString() {
+        switch (this.cmpMethod) {
+            case Headers_1.CMP_METHOD.STORED: return 'Stored';
+            case Headers_1.CMP_METHOD.SHRUNK: return 'Shrunk';
+            case Headers_1.CMP_METHOD.REDUCED1: return 'Reduced-1';
+            case Headers_1.CMP_METHOD.REDUCED2: return 'Reduced-2';
+            case Headers_1.CMP_METHOD.REDUCED3: return 'Reduced-3';
+            case Headers_1.CMP_METHOD.REDUCED4: return 'Reduced-4';
+            case Headers_1.CMP_METHOD.IMPLODED: return 'Imploded';
+            case Headers_1.CMP_METHOD.DEFLATED:
+                switch (this.bitFlags & 0x6) {
+                    case 0: return 'Deflate-N'; // Deflate Normal
+                    case 2: return 'Deflate-M'; // Deflate Maximum
+                    case 4: return 'Deflate-F'; // Deflate Fast
+                    case 6: return 'Deflate-S'; // Deflate Super Fast
+                }
+            case Headers_1.CMP_METHOD.ENHANCED_DEFLATE: return 'Deflate-Enh';
+            case Headers_1.CMP_METHOD.IBM_TERSE: return 'PKDCL-LZ77';
+            case Headers_1.CMP_METHOD.ZSTD: return 'Zstandard';
+            default: return 'Unknown';
+        }
+    }
+    /**
+     * Converts file system code to human-readable string
+     * @returns String describing the file system
+     */
+    fileSystemToString() {
+        switch (this.verMadeBy >> 8) {
+            case Headers_1.FILE_SYSTEM.MSDOS: return 'MS-DOS';
+            case Headers_1.FILE_SYSTEM.AMIGA: return 'Amiga';
+            case Headers_1.FILE_SYSTEM.OPENVMS: return 'OpenVMS';
+            case Headers_1.FILE_SYSTEM.UNIX: return 'Unix';
+            case Headers_1.FILE_SYSTEM.VM_CMS: return 'VM/CMS';
+            case Headers_1.FILE_SYSTEM.ATARI: return 'Atari ST';
+            case Headers_1.FILE_SYSTEM.OS2: return 'OS/2 HPFS';
+            case Headers_1.FILE_SYSTEM.MAC: return 'Macintosh';
+            case Headers_1.FILE_SYSTEM.CP_M: return 'CP/M';
+            case Headers_1.FILE_SYSTEM.NTFS: return 'Windows NTFS';
+            case Headers_1.FILE_SYSTEM.MVS: return 'MVS (OS/390 - Z/OS)';
+            case Headers_1.FILE_SYSTEM.VSE: return 'VSE';
+            case Headers_1.FILE_SYSTEM.ACORN: return 'Acorn Risc';
+            case Headers_1.FILE_SYSTEM.ALTMVS: return 'Alternate MVS';
+            case Headers_1.FILE_SYSTEM.BEOS: return 'BeOS';
+            case Headers_1.FILE_SYSTEM.TANDEM: return 'Tandem';
+            case Headers_1.FILE_SYSTEM.OS400: return 'OS/400';
+            case Headers_1.FILE_SYSTEM.DARWIN: return 'Apple OS/X (Darwin)';
+            default: return 'Unknown';
+        }
+    }
+    /**
+     * Converts MS-DOS file attributes to string representation
+     * @returns String like "----" where R=readonly, H=hidden, S=system, A=archive
+     */
+    dosAttributesToString() {
+        let dosAttr = this.extFileAttr & 0xFFFF;
+        if (dosAttr === 0)
+            return 'none';
+        let attrs = '';
+        attrs += (dosAttr & Headers_1.DOS_FILE_ATTR.READONLY) ? 'r' : '-';
+        attrs += (dosAttr & Headers_1.DOS_FILE_ATTR.HIDDEN) ? 'h' : '-';
+        attrs += (dosAttr & Headers_1.DOS_FILE_ATTR.SYSTEM) ? 's' : '-';
+        // attrs += (dosAttr & DOS_FILE_ATTR.VOLUME)   ? 'v' : '-';
+        attrs += (dosAttr & Headers_1.DOS_FILE_ATTR.DIRECTORY) ? 'd' : '-';
+        attrs += (dosAttr & Headers_1.DOS_FILE_ATTR.ARCHIVE) ? 'a' : '-';
+        return attrs;
+    }
+    /**
+     * Outputs detailed information about this entry for debugging
+     * Includes compression, encryption, timestamps, and extra fields
+     */
+    showVerboseInfo() {
+        console.log('=== Central Directory Entry (%s) ===', this.filename);
+        console.log('unzip from start of archive: ', this.localHdrOffset);
+        console.log('File system or operating system of origin:    ', this.fileSystemToString());
+        console.log('Version of encoding software:                 ', this.verMadeBy);
+        console.log('Compression Method:                           ', this.cmpMethodToString());
+        console.log('File Security Status:                         ', this.bitFlags & Headers_1.GP_FLAG.ENCRYPTED ?
+            this.bitFlags & Headers_1.GP_FLAG.STRONG_ENCRYPT ? 'Strong Encrypt' : 'Encrypted' :
+            'Not Encrypted');
+        console.log('File Modified (DOS date/time)                 ', this.toFormattedDateString());
+        console.log('File Modified (UTC)                           ', this.toFormattedUTCDateString());
+        console.log('Compressed Size:                              ', this.compressedSize);
+        console.log('UnCompressed Size:                            ', this.uncompressedSize);
+        console.log(`32-bit CRC value (hex):                        ${this.crc.toString(16).padStart(8, '0')}`);
+        console.log('Length of extra field:                        ', this.extraField?.length ?? 0);
+        console.log('Length of file comment:                       ', this.comment?.length ?? 0);
+        console.log('Unix File Attributes:                         ');
+        console.log('MS-DOS File Attributes:                       ', this.dosAttributesToString());
+        if (this.extraField) {
+            console.log('\nThe Central-Directory Extra Field contains:');
+            try {
+                for (let i = 0; i < this.extraField.length;) {
+                    // Ensure we have at least 4 bytes (header ID + length)
+                    if (i + 4 > this.extraField.length) {
+                        console.log(`   Warning: Truncated extra field at offset ${i}`);
+                        break;
+                    }
+                    let _id = this.extraField.readUInt16LE(i);
+                    let _idStr = _id.toString(16).padStart(4, '0');
+                    let _len = this.extraField.readUInt16LE(i + 2);
+                    // Validate the length to ensure it doesn't exceed buffer bounds
+                    if (_len < 0 || i + 4 + _len > this.extraField.length) {
+                        console.log(`   Warning: Invalid extra field length (${_len}) at offset ${i} for ID ${_idStr}`);
+                        break;
+                    }
+                    let _data = this.extraField.subarray(i + 4, i + 4 + _len);
+                    try {
+                        if (_id === Headers_1.HDR_ID.SHA256) {
+                            console.log(`   ID[0x${_idStr}] NeoZip-SHA256: ${_data.toString('hex')}`);
+                        }
+                        else if (_id === Headers_1.HDR_ID.UNV_TIME) {
+                            if (_len >= 5) {
+                                const flags = _data.readUInt8(0);
+                                const timestamp = _data.readUInt32LE(1);
+                                const date = new Date(timestamp * 1000);
+                                console.log(`   ID[0x${_idStr}] Universal Time: flags=${flags}, time=${date.toISOString()}`);
+                            }
+                            else {
+                                console.log(`   ID[0x${_idStr}] Universal Time: (invalid length ${_len})`);
+                            }
+                        }
+                        else if (_id === Headers_1.HDR_ID.UID_GID) {
+                            if (_len >= 5) {
+                                const version = _data.readUInt8(0);
+                                const uidSize = _data.readUInt8(1);
+                                if (2 + uidSize > _len) {
+                                    console.log(`   ID[0x${_idStr}] Unix UID/GID: (invalid UID size ${uidSize})`);
+                                }
+                                else {
+                                    const uid = _data.readUIntLE(2, Math.min(uidSize, 4));
+                                    let gid = 0;
+                                    if (2 + uidSize + 1 < _len) {
+                                        const gidSize = _data.readUInt8(2 + uidSize);
+                                        if (2 + uidSize + 1 + gidSize <= _len) {
+                                            gid = _data.readUIntLE(2 + uidSize + 1, Math.min(gidSize, 4));
+                                        }
+                                    }
+                                    console.log(`   ID[0x${_idStr}] Unix UID/GID: version=${version}, uid=${uid}, gid=${gid}`);
+                                }
+                            }
+                            else {
+                                console.log(`   ID[0x${_idStr}] Unix UID/GID: (invalid length ${_len})`);
+                            }
+                        }
+                        else if (_id === Headers_1.HDR_ID.UNICODE_PATH) {
+                            if (_len >= 5) {
+                                const version = _data.readUInt8(0);
+                                const nameCrc32 = _data.readUInt32LE(1);
+                                const unicodeName = _data.subarray(5).toString('utf8');
+                                // Calculate CRC32 of the original filename for verification
+                                const fnameBuf = Buffer.from(this.filename);
+                                const calculatedCrc = (0, Util_1.crc32)(fnameBuf);
+                                const crcMatch = nameCrc32 === calculatedCrc ? 'MATCH' : 'MISMATCH';
+                                console.log(`   ID[0x${_idStr}] Unicode Path: version=${version}, CRC32=${nameCrc32.toString(16)} (${crcMatch})`);
+                                console.log(`                      Path: "${unicodeName}"`);
+                            }
+                            else {
+                                console.log(`   ID[0x${_idStr}] Unicode Path: (invalid length ${_len})`);
+                            }
+                        }
+                        else {
+                            // For unknown fields, show a hex preview of the first few bytes
+                            const preview = _len > 0
+                                ? _data.slice(0, Math.min(16, _len)).toString('hex')
+                                : '';
+                            console.log(`   ID[0x${_idStr}] Unknown field: length=${_len} bytes${preview ? ', data=' + preview + '...' : ''}`);
+                        }
+                    }
+                    catch (error) {
+                        console.log(`   Error parsing extra field ID[0x${_idStr}]: ${error.message}`);
+                    }
+                    i += 4 + _len;
+                }
+            }
+            catch (error) {
+                console.log(`   Error parsing extra fields: ${error.message}`);
+            }
+        }
+        console.log('\n');
+    }
+}
+exports.default = ZipEntry;