@rushstack/zipsync 0.2.13 → 0.3.0

package/lib-esm/zipUtils.js

@@ -0,0 +1,292 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+/**
+ * Low-level ZIP structure helpers used by the zipsync pack/unpack pipeline.
+ *
+ * Spec reference: https://pkware.cachefly.net/webdocs/casestudies/APPNOTE.TXT
+ */
+/**
+ * Local file header signature PK\x03\x04
+ */
+const LOCAL_FILE_HEADER_SIGNATURE = 0x04034b50; // PK\x03\x04
+/**
+ * Central directory file header signature PK\x01\x02
+ */
+const CENTRAL_DIR_HEADER_SIGNATURE = 0x02014b50; // PK\x01\x02
+/**
+ * End of central directory signature PK\x05\x06
+ */
+const END_OF_CENTRAL_DIR_SIGNATURE = 0x06054b50; // PK\x05\x06
+/**
+ * Data descriptor signature PK\x07\x08
+ */
+const DATA_DESCRIPTOR_SIGNATURE = 0x08074b50; // PK\x07\x08
+export const STORE_COMPRESSION = 0;
+export const DEFLATE_COMPRESSION = 8;
+export const ZSTD_COMPRESSION = 93;
+function writeUInt32LE(buffer, value, offset) {
+    buffer.writeUInt32LE(value, offset);
+}
+function writeUInt16LE(buffer, value, offset) {
+    buffer.writeUInt16LE(value, offset);
+}
+function readUInt32LE(buffer, offset) {
+    return buffer.readUInt32LE(offset);
+}
+function readUInt16LE(buffer, offset) {
+    return buffer.readUInt16LE(offset);
+}
+/**
+ * Convert a JS Date into packed DOS time/date fields used by classic ZIP.
+ * Seconds are stored /2 (range 0-29 => 0-58s). Years are offset from 1980.
+ */
+export function dosDateTime(date) {
+    /* eslint-disable no-bitwise */
+    const time = ((date.getHours() & 0x1f) << 11) | ((date.getMinutes() & 0x3f) << 5) | ((date.getSeconds() / 2) & 0x1f);
+    const dateVal = (((date.getFullYear() - 1980) & 0x7f) << 9) |
+        (((date.getMonth() + 1) & 0xf) << 5) |
+        (date.getDate() & 0x1f);
+    /* eslint-enable no-bitwise */
+    return { time, date: dateVal };
+}
+/**
+ * Reusable scratch buffer for the fixed-length local file header (30 bytes).
+ * Using a single Buffer avoids per-file allocations; callers must copy/use synchronously.
+ */
+const localFileHeaderBuffer = Buffer.allocUnsafe(30);
+/**
+ * Write the fixed portion of a local file header for an entry (with data descriptor flag set) and
+ * return the header buffer plus the variable-length filename buffer.
+ *
+ * Layout (little-endian):
+ *   signature(4) versionNeeded(2) flags(2) method(2) modTime(2) modDate(2)
+ *   crc32(4) compSize(4) uncompSize(4) nameLen(2) extraLen(2)
+ *
+ * Because we set bit 3 of the general purpose flag, crc32/compSize/uncompSize are zero here and the
+ * actual values appear later in a trailing data descriptor record. This enables streaming without
+ * buffering entire file contents beforehand.
+ */
+export function writeLocalFileHeader(entry) {
+    const filenameBuffer = Buffer.from(entry.filename, 'utf8');
+    const { time, date } = entry.dosDateTime;
+    let offset = 0;
+    writeUInt32LE(localFileHeaderBuffer, LOCAL_FILE_HEADER_SIGNATURE, offset);
+    offset += 4;
+    writeUInt16LE(localFileHeaderBuffer, 20, offset); // version needed
+    offset += 2;
+    // General purpose bit flag: set bit 3 (0x0008) to indicate presence of data descriptor
+    // Per APPNOTE: when bit 3 is set, CRC-32 and sizes in local header are set to zero and
+    // the actual values are stored in the data descriptor that follows the file data.
+    writeUInt16LE(localFileHeaderBuffer, 0x0008, offset); // flags (data descriptor)
+    offset += 2;
+    writeUInt16LE(localFileHeaderBuffer, entry.compressionMethod, offset); // compression method (0=store,8=deflate)
+    offset += 2;
+    writeUInt16LE(localFileHeaderBuffer, time, offset); // last mod time
+    offset += 2;
+    writeUInt16LE(localFileHeaderBuffer, date, offset); // last mod date
+    offset += 2;
+    // With bit 3 set, these three fields MUST be zero in the local header
+    writeUInt32LE(localFileHeaderBuffer, 0, offset); // crc32 (placeholder, real value in data descriptor)
+    offset += 4;
+    writeUInt32LE(localFileHeaderBuffer, 0, offset); // compressed size (placeholder)
+    offset += 4;
+    writeUInt32LE(localFileHeaderBuffer, 0, offset); // uncompressed size (placeholder)
+    offset += 4;
+    writeUInt16LE(localFileHeaderBuffer, filenameBuffer.length, offset); // filename length
+    offset += 2;
+    writeUInt16LE(localFileHeaderBuffer, 0, offset); // extra field length
+    offset += 2;
+    return [localFileHeaderBuffer, filenameBuffer];
+}
+/**
+ * Reusable scratch buffer for central directory entries (fixed-length 46 bytes before filename)
+ */
+const centralDirHeaderBuffer = Buffer.allocUnsafe(46);
+/**
+ * Write a central directory header referencing an already written local file entry.
+ * Central directory consolidates the final CRC + sizes (always present here) and provides a table
+ * for fast enumeration without scanning the archive sequentially.
+ */
+export function writeCentralDirectoryHeader(entry) {
+    const filenameBuffer = Buffer.from(entry.filename, 'utf8');
+    const now = new Date();
+    const { time, date } = dosDateTime(now);
+    let offset = 0;
+    writeUInt32LE(centralDirHeaderBuffer, CENTRAL_DIR_HEADER_SIGNATURE, offset);
+    offset += 4;
+    writeUInt16LE(centralDirHeaderBuffer, 20, offset); // version made by
+    offset += 2;
+    writeUInt16LE(centralDirHeaderBuffer, 20, offset); // version needed
+    offset += 2;
+    // Mirror flags used in local header (bit 3 set to indicate data descriptor was used)
+    writeUInt16LE(centralDirHeaderBuffer, 0x0008, offset); // flags
+    offset += 2;
+    writeUInt16LE(centralDirHeaderBuffer, entry.compressionMethod, offset); // compression method
+    offset += 2;
+    writeUInt16LE(centralDirHeaderBuffer, time, offset); // last mod time
+    offset += 2;
+    writeUInt16LE(centralDirHeaderBuffer, date, offset); // last mod date
+    offset += 2;
+    writeUInt32LE(centralDirHeaderBuffer, entry.crc32, offset); // crc32
+    offset += 4;
+    writeUInt32LE(centralDirHeaderBuffer, entry.compressedSize, offset); // compressed size
+    offset += 4;
+    writeUInt32LE(centralDirHeaderBuffer, entry.size, offset); // uncompressed size
+    offset += 4;
+    writeUInt16LE(centralDirHeaderBuffer, filenameBuffer.length, offset); // filename length
+    offset += 2;
+    writeUInt16LE(centralDirHeaderBuffer, 0, offset); // extra field length
+    offset += 2;
+    writeUInt16LE(centralDirHeaderBuffer, 0, offset); // comment length
+    offset += 2;
+    writeUInt16LE(centralDirHeaderBuffer, 0, offset); // disk number start
+    offset += 2;
+    writeUInt16LE(centralDirHeaderBuffer, 0, offset); // internal file attributes
+    offset += 2;
+    writeUInt32LE(centralDirHeaderBuffer, 0, offset); // external file attributes
+    offset += 4;
+    writeUInt32LE(centralDirHeaderBuffer, entry.localHeaderOffset, offset); // local header offset
+    offset += 4;
+    return [centralDirHeaderBuffer, filenameBuffer];
+}
+/**
+ * Data descriptor: signature(4) crc32(4) compSize(4) uncompSize(4)
+ */
+const dataDescriptorBuffer = Buffer.allocUnsafe(16);
+/**
+ * Write the trailing data descriptor for an entry. Only used because we set flag bit 3 in the
+ * local file header allowing deferred CRC/size calculation.
+ */
+export function writeDataDescriptor(entry) {
+    let offset = 0;
+    writeUInt32LE(dataDescriptorBuffer, DATA_DESCRIPTOR_SIGNATURE, offset); // signature PK\x07\x08
+    offset += 4;
+    writeUInt32LE(dataDescriptorBuffer, entry.crc32, offset); // crc32
+    offset += 4;
+    writeUInt32LE(dataDescriptorBuffer, entry.compressedSize, offset); // compressed size
+    offset += 4;
+    writeUInt32LE(dataDescriptorBuffer, entry.size, offset); // uncompressed size
+    return dataDescriptorBuffer;
+}
+/**
+ * End of central directory (EOCD) record (22 bytes when comment length = 0)
+ */
+const endOfCentralDirBuffer = Buffer.allocUnsafe(22);
+/**
+ * Write the EOCD record referencing the accumulated central directory. We omit archive comments
+ * and do not support ZIP64 (sufficient for build cache archive sizes today).
+ */
+export function writeEndOfCentralDirectory(centralDirOffset, centralDirSize, entryCount) {
+    let offset = 0;
+    writeUInt32LE(endOfCentralDirBuffer, END_OF_CENTRAL_DIR_SIGNATURE, offset);
+    offset += 4;
+    writeUInt16LE(endOfCentralDirBuffer, 0, offset); // disk number
+    offset += 2;
+    writeUInt16LE(endOfCentralDirBuffer, 0, offset); // central dir start disk
+    offset += 2;
+    writeUInt16LE(endOfCentralDirBuffer, entryCount, offset); // central dir records on disk
+    offset += 2;
+    writeUInt16LE(endOfCentralDirBuffer, entryCount, offset); // total central dir records
+    offset += 2;
+    writeUInt32LE(endOfCentralDirBuffer, centralDirSize, offset); // central dir size
+    offset += 4;
+    writeUInt32LE(endOfCentralDirBuffer, centralDirOffset, offset); // central dir offset
+    offset += 4;
+    writeUInt16LE(endOfCentralDirBuffer, 0, offset); // comment length
+    return endOfCentralDirBuffer;
+}
+/**
+ * Parse a local file header at the provided offset. Minimal validation: signature check only.
+ * Returns header plus the offset pointing just past the variable-length name+extra field.
+ */
+export function parseLocalFileHeader(buffer, offset) {
+    const signature = readUInt32LE(buffer, offset);
+    if (signature !== LOCAL_FILE_HEADER_SIGNATURE) {
+        throw new Error(`Unexpected local file header signature at offset ${offset.toString(16)}: ${signature.toString(16)}`);
+    }
+    const header = {
+        signature,
+        versionNeeded: readUInt16LE(buffer, offset + 4),
+        flags: readUInt16LE(buffer, offset + 6),
+        compressionMethod: readUInt16LE(buffer, offset + 8),
+        lastModTime: readUInt16LE(buffer, offset + 10),
+        lastModDate: readUInt16LE(buffer, offset + 12),
+        crc32: readUInt32LE(buffer, offset + 14),
+        compressedSize: readUInt32LE(buffer, offset + 18),
+        uncompressedSize: readUInt32LE(buffer, offset + 22),
+        filenameLength: readUInt16LE(buffer, offset + 26),
+        extraFieldLength: readUInt16LE(buffer, offset + 28)
+    };
+    return {
+        header,
+        nextOffset: offset + 30 + header.filenameLength + header.extraFieldLength
+    };
+}
+/**
+ * Parse a central directory header at the given offset (within a sliced central directory buffer).
+ * Returns header, filename string, and nextOffset pointing to the next structure.
+ */
+export function parseCentralDirectoryHeader(buffer, offset) {
+    const signature = readUInt32LE(buffer, offset);
+    if (signature !== CENTRAL_DIR_HEADER_SIGNATURE) {
+        throw new Error(`Unexpected central directory signature at offset ${offset.toString(16)}: ${signature.toString(16)}`);
+    }
+    const header = {
+        signature,
+        versionMadeBy: readUInt16LE(buffer, offset + 4),
+        versionNeeded: readUInt16LE(buffer, offset + 6),
+        flags: readUInt16LE(buffer, offset + 8),
+        compressionMethod: readUInt16LE(buffer, offset + 10),
+        lastModTime: readUInt16LE(buffer, offset + 12),
+        lastModDate: readUInt16LE(buffer, offset + 14),
+        crc32: readUInt32LE(buffer, offset + 16),
+        compressedSize: readUInt32LE(buffer, offset + 20),
+        uncompressedSize: readUInt32LE(buffer, offset + 24),
+        filenameLength: readUInt16LE(buffer, offset + 28),
+        extraFieldLength: readUInt16LE(buffer, offset + 30),
+        commentLength: readUInt16LE(buffer, offset + 32),
+        diskNumberStart: readUInt16LE(buffer, offset + 34),
+        internalFileAttributes: readUInt16LE(buffer, offset + 36),
+        externalFileAttributes: readUInt32LE(buffer, offset + 38),
+        localHeaderOffset: readUInt32LE(buffer, offset + 42)
+    };
+    offset += 46;
+    const filename = buffer.toString('utf8', offset, offset + header.filenameLength);
+    return {
+        header,
+        filename,
+        nextOffset: offset + header.filenameLength + header.extraFieldLength + header.commentLength
+    };
+}
+/**
+ * Locate the EOCD record by reverse scanning. Since we never write a comment the EOCD will be the
+ * first matching signature encountered scanning backwards from the end.
+ */
+export function findEndOfCentralDirectory(buffer) {
+    for (let i = buffer.length - 22; i >= 0; i--) {
+        if (readUInt32LE(buffer, i) === END_OF_CENTRAL_DIR_SIGNATURE) {
+            return {
+                signature: readUInt32LE(buffer, i),
+                diskNumber: readUInt16LE(buffer, i + 4),
+                centralDirStartDisk: readUInt16LE(buffer, i + 6),
+                centralDirRecordsOnDisk: readUInt16LE(buffer, i + 8),
+                totalCentralDirRecords: readUInt16LE(buffer, i + 10),
+                centralDirSize: readUInt32LE(buffer, i + 12),
+                centralDirOffset: readUInt32LE(buffer, i + 16),
+                commentLength: readUInt16LE(buffer, i + 20)
+            };
+        }
+    }
+    throw new Error('End of central directory not found');
+}
+/**
+ * Slice out the (possibly compressed) file data bytes for a central directory entry.
+ * Caller will decompress if needed based on entry.header.compressionMethod.
+ */
+export function getFileFromZip(zipBuffer, entry) {
+    const { header: localFileHeader } = parseLocalFileHeader(zipBuffer, entry.header.localHeaderOffset);
+    const localDataOffset = entry.header.localHeaderOffset + 30 + localFileHeader.filenameLength + localFileHeader.extraFieldLength;
+    const fileZipBuffer = zipBuffer.subarray(localDataOffset, localDataOffset + entry.header.compressedSize);
+    return fileZipBuffer;
+}
+//# sourceMappingURL=zipUtils.js.map

package/lib-esm/zipUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zipUtils.js","sourceRoot":"","sources":["../src/zipUtils.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\n/**\n * Low-level ZIP structure helpers used by the zipsync pack/unpack pipeline.\n *\n * Spec reference: https://pkware.cachefly.net/webdocs/casestudies/APPNOTE.TXT\n */\n\n/**\n * Local file header signature PK\\x03\\x04\n */\nconst LOCAL_FILE_HEADER_SIGNATURE: number = 0x04034b50; // PK\\x03\\x04\n/**\n * Central directory file header signature PK\\x01\\x02\n */\nconst CENTRAL_DIR_HEADER_SIGNATURE: number = 0x02014b50; // PK\\x01\\x02\n/**\n * End of central directory signature PK\\x05\\x06\n */\nconst END_OF_CENTRAL_DIR_SIGNATURE: number = 0x06054b50; // PK\\x05\\x06\n/**\n * Data descriptor signature PK\\x07\\x08\n */\nconst DATA_DESCRIPTOR_SIGNATURE: number = 0x08074b50; // PK\\x07\\x08\n\nexport const STORE_COMPRESSION: 0 = 0;\nexport const DEFLATE_COMPRESSION: 8 = 8;\nexport const ZSTD_COMPRESSION: 93 = 93;\nexport type ZipMetaCompressionMethod =\n  | typeof STORE_COMPRESSION\n  | typeof DEFLATE_COMPRESSION\n  | typeof ZSTD_COMPRESSION;\n\nexport interface IFileEntry {\n  filename: string;\n  size: number;\n  compressedSize: number;\n  crc32: number;\n  sha1Hash: string;\n  localHeaderOffset: number;\n  compressionMethod: ZipMetaCompressionMethod;\n  dosDateTime: { time: number; date: number };\n}\n\nexport interface ILocalFileHeader {\n  signature: number;\n  versionNeeded: number;\n  flags: number;\n  compressionMethod: number;\n  lastModTime: number;\n  lastModDate: number;\n  crc32: number;\n  compressedSize: number;\n  uncompressedSize: number;\n  filenameLength: number;\n  extraFieldLength: number;\n}\n\nexport interface ICentralDirectoryHeader {\n  signature: number;\n  versionMadeBy: number;\n  versionNeeded: number;\n  flags: number;\n  compressionMethod: number;\n  lastModTime: number;\n  lastModDate: number;\n  crc32: number;\n  compressedSize: number;\n  uncompressedSize: number;\n  filenameLength: number;\n  extraFieldLength: number;\n  commentLength: number;\n  diskNumberStart: number;\n  internalFileAttributes: number;\n  externalFileAttributes: number;\n  localHeaderOffset: number;\n}\n\nexport interface IEndOfCentralDirectory {\n  signature: number;\n  diskNumber: number;\n  centralDirStartDisk: number;\n  centralDirRecordsOnDisk: number;\n  totalCentralDirRecords: number;\n  centralDirSize: number;\n  centralDirOffset: number;\n  commentLength: number;\n}\n\nfunction writeUInt32LE(buffer: Buffer, value: number, offset: number): void {\n  buffer.writeUInt32LE(value, offset);\n}\n\nfunction writeUInt16LE(buffer: Buffer, value: number, offset: number): void {\n  buffer.writeUInt16LE(value, offset);\n}\n\nfunction readUInt32LE(buffer: Buffer, offset: number): number {\n  return buffer.readUInt32LE(offset);\n}\n\nfunction readUInt16LE(buffer: Buffer, offset: number): number {\n  return buffer.readUInt16LE(offset);\n}\n\n/**\n * Convert a JS Date into packed DOS time/date fields used by classic ZIP.\n * Seconds are stored /2 (range 0-29 => 0-58s). Years are offset from 1980.\n */\nexport function dosDateTime(date: Date): { time: number; date: number } {\n  /* eslint-disable no-bitwise */\n  const time: number =\n    ((date.getHours() & 0x1f) << 11) | ((date.getMinutes() & 0x3f) << 5) | ((date.getSeconds() / 2) & 0x1f);\n\n  const dateVal: number =\n    (((date.getFullYear() - 1980) & 0x7f) << 9) |\n    (((date.getMonth() + 1) & 0xf) << 5) |\n    (date.getDate() & 0x1f);\n  /* eslint-enable no-bitwise */\n\n  return { time, date: dateVal };\n}\n\n/**\n * Reusable scratch buffer for the fixed-length local file header (30 bytes).\n * Using a single Buffer avoids per-file allocations; callers must copy/use synchronously.\n */\nconst localFileHeaderBuffer: Buffer = Buffer.allocUnsafe(30);\n/**\n * Write the fixed portion of a local file header for an entry (with data descriptor flag set) and\n * return the header buffer plus the variable-length filename buffer.\n *\n * Layout (little-endian):\n *   signature(4) versionNeeded(2) flags(2) method(2) modTime(2) modDate(2)\n *   crc32(4) compSize(4) uncompSize(4) nameLen(2) extraLen(2)\n *\n * Because we set bit 3 of the general purpose flag, crc32/compSize/uncompSize are zero here and the\n * actual values appear later in a trailing data descriptor record. This enables streaming without\n * buffering entire file contents beforehand.\n */\nexport function writeLocalFileHeader(\n  entry: IFileEntry\n): [fileHeaderWithoutVariableLengthData: Buffer, fileHeaderVariableLengthData: Buffer] {\n  const filenameBuffer: Buffer = Buffer.from(entry.filename, 'utf8');\n\n  const { time, date } = entry.dosDateTime;\n\n  let offset: number = 0;\n  writeUInt32LE(localFileHeaderBuffer, LOCAL_FILE_HEADER_SIGNATURE, offset);\n  offset += 4;\n  writeUInt16LE(localFileHeaderBuffer, 20, offset); // version needed\n  offset += 2;\n  // General purpose bit flag: set bit 3 (0x0008) to indicate presence of data descriptor\n  // Per APPNOTE: when bit 3 is set, CRC-32 and sizes in local header are set to zero and\n  // the actual values are stored in the data descriptor that follows the file data.\n  writeUInt16LE(localFileHeaderBuffer, 0x0008, offset); // flags (data descriptor)\n  offset += 2;\n  writeUInt16LE(localFileHeaderBuffer, entry.compressionMethod, offset); // compression method (0=store,8=deflate)\n  offset += 2;\n  writeUInt16LE(localFileHeaderBuffer, time, offset); // last mod time\n  offset += 2;\n  writeUInt16LE(localFileHeaderBuffer, date, offset); // last mod date\n  offset += 2;\n  // With bit 3 set, these three fields MUST be zero in the local header\n  writeUInt32LE(localFileHeaderBuffer, 0, offset); // crc32 (placeholder, real value in data descriptor)\n  offset += 4;\n  writeUInt32LE(localFileHeaderBuffer, 0, offset); // compressed size (placeholder)\n  offset += 4;\n  writeUInt32LE(localFileHeaderBuffer, 0, offset); // uncompressed size (placeholder)\n  offset += 4;\n  writeUInt16LE(localFileHeaderBuffer, filenameBuffer.length, offset); // filename length\n  offset += 2;\n  writeUInt16LE(localFileHeaderBuffer, 0, offset); // extra field length\n  offset += 2;\n\n  return [localFileHeaderBuffer, filenameBuffer];\n}\n\n/**\n * Reusable scratch buffer for central directory entries (fixed-length 46 bytes before filename)\n */\nconst centralDirHeaderBuffer: Buffer = Buffer.allocUnsafe(46);\n/**\n * Write a central directory header referencing an already written local file entry.\n * Central directory consolidates the final CRC + sizes (always present here) and provides a table\n * for fast enumeration without scanning the archive sequentially.\n */\nexport function writeCentralDirectoryHeader(entry: IFileEntry): Buffer[] {\n  const filenameBuffer: Buffer = Buffer.from(entry.filename, 'utf8');\n\n  const now: Date = new Date();\n  const { time, date } = dosDateTime(now);\n\n  let offset: number = 0;\n  writeUInt32LE(centralDirHeaderBuffer, CENTRAL_DIR_HEADER_SIGNATURE, offset);\n  offset += 4;\n  writeUInt16LE(centralDirHeaderBuffer, 20, offset); // version made by\n  offset += 2;\n  writeUInt16LE(centralDirHeaderBuffer, 20, offset); // version needed\n  offset += 2;\n  // Mirror flags used in local header (bit 3 set to indicate data descriptor was used)\n  writeUInt16LE(centralDirHeaderBuffer, 0x0008, offset); // flags\n  offset += 2;\n  writeUInt16LE(centralDirHeaderBuffer, entry.compressionMethod, offset); // compression method\n  offset += 2;\n  writeUInt16LE(centralDirHeaderBuffer, time, offset); // last mod time\n  offset += 2;\n  writeUInt16LE(centralDirHeaderBuffer, date, offset); // last mod date\n  offset += 2;\n  writeUInt32LE(centralDirHeaderBuffer, entry.crc32, offset); // crc32\n  offset += 4;\n  writeUInt32LE(centralDirHeaderBuffer, entry.compressedSize, offset); // compressed size\n  offset += 4;\n  writeUInt32LE(centralDirHeaderBuffer, entry.size, offset); // uncompressed size\n  offset += 4;\n  writeUInt16LE(centralDirHeaderBuffer, filenameBuffer.length, offset); // filename length\n  offset += 2;\n  writeUInt16LE(centralDirHeaderBuffer, 0, offset); // extra field length\n  offset += 2;\n  writeUInt16LE(centralDirHeaderBuffer, 0, offset); // comment length\n  offset += 2;\n  writeUInt16LE(centralDirHeaderBuffer, 0, offset); // disk number start\n  offset += 2;\n  writeUInt16LE(centralDirHeaderBuffer, 0, offset); // internal file attributes\n  offset += 2;\n  writeUInt32LE(centralDirHeaderBuffer, 0, offset); // external file attributes\n  offset += 4;\n  writeUInt32LE(centralDirHeaderBuffer, entry.localHeaderOffset, offset); // local header offset\n  offset += 4;\n\n  return [centralDirHeaderBuffer, filenameBuffer];\n}\n\n/**\n * Data descriptor: signature(4) crc32(4) compSize(4) uncompSize(4)\n */\nconst dataDescriptorBuffer: Buffer = Buffer.allocUnsafe(16);\n/**\n * Write the trailing data descriptor for an entry. Only used because we set flag bit 3 in the\n * local file header allowing deferred CRC/size calculation.\n */\nexport function writeDataDescriptor(entry: IFileEntry): Buffer {\n  let offset: number = 0;\n  writeUInt32LE(dataDescriptorBuffer, DATA_DESCRIPTOR_SIGNATURE, offset); // signature PK\\x07\\x08\n  offset += 4;\n  writeUInt32LE(dataDescriptorBuffer, entry.crc32, offset); // crc32\n  offset += 4;\n  writeUInt32LE(dataDescriptorBuffer, entry.compressedSize, offset); // compressed size\n  offset += 4;\n  writeUInt32LE(dataDescriptorBuffer, entry.size, offset); // uncompressed size\n  return dataDescriptorBuffer;\n}\n\n/**\n * End of central directory (EOCD) record (22 bytes when comment length = 0)\n */\nconst endOfCentralDirBuffer: Buffer = Buffer.allocUnsafe(22);\n/**\n * Write the EOCD record referencing the accumulated central directory. We omit archive comments\n * and do not support ZIP64 (sufficient for build cache archive sizes today).\n */\nexport function writeEndOfCentralDirectory(\n  centralDirOffset: number,\n  centralDirSize: number,\n  entryCount: number\n): Buffer {\n  let offset: number = 0;\n  writeUInt32LE(endOfCentralDirBuffer, END_OF_CENTRAL_DIR_SIGNATURE, offset);\n  offset += 4;\n  writeUInt16LE(endOfCentralDirBuffer, 0, offset); // disk number\n  offset += 2;\n  writeUInt16LE(endOfCentralDirBuffer, 0, offset); // central dir start disk\n  offset += 2;\n  writeUInt16LE(endOfCentralDirBuffer, entryCount, offset); // central dir records on disk\n  offset += 2;\n  writeUInt16LE(endOfCentralDirBuffer, entryCount, offset); // total central dir records\n  offset += 2;\n  writeUInt32LE(endOfCentralDirBuffer, centralDirSize, offset); // central dir size\n  offset += 4;\n  writeUInt32LE(endOfCentralDirBuffer, centralDirOffset, offset); // central dir offset\n  offset += 4;\n  writeUInt16LE(endOfCentralDirBuffer, 0, offset); // comment length\n\n  return endOfCentralDirBuffer;\n}\n\ninterface ILocalFileHeaderParseResult {\n  header: ILocalFileHeader;\n  nextOffset: number;\n}\n\n/**\n * Parse a local file header at the provided offset. Minimal validation: signature check only.\n * Returns header plus the offset pointing just past the variable-length name+extra field.\n */\nexport function parseLocalFileHeader(buffer: Buffer, offset: number): ILocalFileHeaderParseResult {\n  const signature: number = readUInt32LE(buffer, offset);\n  if (signature !== LOCAL_FILE_HEADER_SIGNATURE) {\n    throw new Error(\n      `Unexpected local file header signature at offset ${offset.toString(16)}: ${signature.toString(16)}`\n    );\n  }\n  const header: ILocalFileHeader = {\n    signature,\n    versionNeeded: readUInt16LE(buffer, offset + 4),\n    flags: readUInt16LE(buffer, offset + 6),\n    compressionMethod: readUInt16LE(buffer, offset + 8),\n    lastModTime: readUInt16LE(buffer, offset + 10),\n    lastModDate: readUInt16LE(buffer, offset + 12),\n    crc32: readUInt32LE(buffer, offset + 14),\n    compressedSize: readUInt32LE(buffer, offset + 18),\n    uncompressedSize: readUInt32LE(buffer, offset + 22),\n    filenameLength: readUInt16LE(buffer, offset + 26),\n    extraFieldLength: readUInt16LE(buffer, offset + 28)\n  };\n\n  return {\n    header,\n    nextOffset: offset + 30 + header.filenameLength + header.extraFieldLength\n  };\n}\n\nexport interface ICentralDirectoryHeaderParseResult {\n  header: ICentralDirectoryHeader;\n  filename: string;\n  nextOffset: number;\n}\n\n/**\n * Parse a central directory header at the given offset (within a sliced central directory buffer).\n * Returns header, filename string, and nextOffset pointing to the next structure.\n */\nexport function parseCentralDirectoryHeader(\n  buffer: Buffer,\n  offset: number\n): ICentralDirectoryHeaderParseResult {\n  const signature: number = readUInt32LE(buffer, offset);\n  if (signature !== CENTRAL_DIR_HEADER_SIGNATURE) {\n    throw new Error(\n      `Unexpected central directory signature at offset ${offset.toString(16)}: ${signature.toString(16)}`\n    );\n  }\n  const header: ICentralDirectoryHeader = {\n    signature,\n    versionMadeBy: readUInt16LE(buffer, offset + 4),\n    versionNeeded: readUInt16LE(buffer, offset + 6),\n    flags: readUInt16LE(buffer, offset + 8),\n    compressionMethod: readUInt16LE(buffer, offset + 10),\n    lastModTime: readUInt16LE(buffer, offset + 12),\n    lastModDate: readUInt16LE(buffer, offset + 14),\n    crc32: readUInt32LE(buffer, offset + 16),\n    compressedSize: readUInt32LE(buffer, offset + 20),\n    uncompressedSize: readUInt32LE(buffer, offset + 24),\n    filenameLength: readUInt16LE(buffer, offset + 28),\n    extraFieldLength: readUInt16LE(buffer, offset + 30),\n    commentLength: readUInt16LE(buffer, offset + 32),\n    diskNumberStart: readUInt16LE(buffer, offset + 34),\n    internalFileAttributes: readUInt16LE(buffer, offset + 36),\n    externalFileAttributes: readUInt32LE(buffer, offset + 38),\n    localHeaderOffset: readUInt32LE(buffer, offset + 42)\n  };\n\n  offset += 46;\n\n  const filename: string = buffer.toString('utf8', offset, offset + header.filenameLength);\n\n  return {\n    header,\n    filename,\n    nextOffset: offset + header.filenameLength + header.extraFieldLength + header.commentLength\n  };\n}\n\n/**\n * Locate the EOCD record by reverse scanning. Since we never write a comment the EOCD will be the\n * first matching signature encountered scanning backwards from the end.\n */\nexport function findEndOfCentralDirectory(buffer: Buffer): IEndOfCentralDirectory {\n  for (let i: number = buffer.length - 22; i >= 0; i--) {\n    if (readUInt32LE(buffer, i) === END_OF_CENTRAL_DIR_SIGNATURE) {\n      return {\n        signature: readUInt32LE(buffer, i),\n        diskNumber: readUInt16LE(buffer, i + 4),\n        centralDirStartDisk: readUInt16LE(buffer, i + 6),\n        centralDirRecordsOnDisk: readUInt16LE(buffer, i + 8),\n        totalCentralDirRecords: readUInt16LE(buffer, i + 10),\n        centralDirSize: readUInt32LE(buffer, i + 12),\n        centralDirOffset: readUInt32LE(buffer, i + 16),\n        commentLength: readUInt16LE(buffer, i + 20)\n      };\n    }\n  }\n\n  throw new Error('End of central directory not found');\n}\n\n/**\n * Slice out the (possibly compressed) file data bytes for a central directory entry.\n * Caller will decompress if needed based on entry.header.compressionMethod.\n */\nexport function getFileFromZip(zipBuffer: Buffer, entry: ICentralDirectoryHeaderParseResult): Buffer {\n  const { header: localFileHeader } = parseLocalFileHeader(zipBuffer, entry.header.localHeaderOffset);\n  const localDataOffset: number =\n    entry.header.localHeaderOffset + 30 + localFileHeader.filenameLength + localFileHeader.extraFieldLength;\n  const fileZipBuffer: Buffer = zipBuffer.subarray(\n    localDataOffset,\n    localDataOffset + entry.header.compressedSize\n  );\n  return fileZipBuffer;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/zipsync",
-  "version": "0.2.13",
+  "version": "0.3.0",
   "description": "CLI tool for creating and extracting ZIP archives with intelligent filesystem synchronization",
   "repository": {
     "type": "git",
@@ -13,15 +13,42 @@
   "license": "MIT",
   "dependencies": {
     "typescript": "~5.8.2",
-    "@rushstack/terminal": "0.21.0",
-    "@rushstack/lookup-by-path": "0.8.15",
-    "@rushstack/ts-command-line": "5.2.0"
+    "@rushstack/terminal": "0.22.0",
+    "@rushstack/ts-command-line": "5.3.0",
+    "@rushstack/lookup-by-path": "0.9.0"
   },
   "devDependencies": {
     "eslint": "~9.37.0",
-    "@rushstack/heft": "1.1.13",
-    "local-node-rig": "1.0.0"
+    "local-node-rig": "1.0.0",
+    "@rushstack/heft": "1.2.0"
   },
+  "main": "./lib-commonjs/index.js",
+  "module": "./lib-esm/index.js",
+  "types": "./lib-dts/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib-dts/index.d.ts",
+      "import": "./lib-esm/index.js",
+      "require": "./lib-commonjs/index.js"
+    },
+    "./lib/*": {
+      "types": "./lib-dts/*.d.ts",
+      "import": "./lib-esm/*.js",
+      "require": "./lib-commonjs/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "lib/*": [
+        "lib-dts/*"
+      ]
+    }
+  },
+  "sideEffects": [
+    "lib-commonjs/start.js",
+    "lib-esm/start.js"
+  ],
   "scripts": {
     "start": "node lib/start",
     "build": "heft build --clean",