@rushstack/zipsync 0.1.0

package/lib/zipSyncUtils.d.ts

@@ -0,0 +1,20 @@
+import type { IReadonlyPathTrieNode } from '@rushstack/lookup-by-path/lib/LookupByPath';
+export declare const METADATA_FILENAME: string;
+export declare const METADATA_VERSION: string;
+export interface IDirQueueItem {
+    dir: string;
+    depth: number;
+    node?: IReadonlyPathTrieNode<boolean> | undefined;
+}
+export interface IMetadataFileRecord {
+    size: number;
+    sha1Hash: string;
+}
+export interface IMetadata {
+    version: string;
+    files: Record<string, IMetadataFileRecord>;
+}
+export type IZipSyncMode = 'pack' | 'unpack';
+export type ZipSyncOptionCompression = 'store' | 'deflate' | 'zstd' | 'auto';
+export declare const defaultBufferSize: number;
+//# sourceMappingURL=zipSyncUtils.d.ts.map

package/lib/zipSyncUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zipSyncUtils.d.ts","sourceRoot":"","sources":["../src/zipSyncUtils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAExF,eAAO,MAAM,iBAAiB,EAAE,MAAoC,CAAC;AACrE,eAAO,MAAM,gBAAgB,EAAE,MAAc,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,qBAAqB,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;CACnD;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAC5C;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE7C,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAE7E,eAAO,MAAM,iBAAiB,EAAE,MAAgB,CAAC"}

package/lib/zipSyncUtils.js

@@ -0,0 +1,9 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultBufferSize = exports.METADATA_VERSION = exports.METADATA_FILENAME = void 0;
+exports.METADATA_FILENAME = '__zipsync_metadata__.json';
+exports.METADATA_VERSION = '1.0';
+exports.defaultBufferSize = 1 << 25; // 32 MiB
+//# sourceMappingURL=zipSyncUtils.js.map

package/lib/zipSyncUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zipSyncUtils.js","sourceRoot":"","sources":["../src/zipSyncUtils.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAI9C,QAAA,iBAAiB,GAAW,2BAA2B,CAAC;AACxD,QAAA,gBAAgB,GAAW,KAAK,CAAC;AAsBjC,QAAA,iBAAiB,GAAW,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport type { IReadonlyPathTrieNode } from '@rushstack/lookup-by-path/lib/LookupByPath';\n\nexport const METADATA_FILENAME: string = '__zipsync_metadata__.json';\nexport const METADATA_VERSION: string = '1.0';\n\nexport interface IDirQueueItem {\n  dir: string;\n  depth: number;\n  node?: IReadonlyPathTrieNode<boolean> | undefined;\n}\n\nexport interface IMetadataFileRecord {\n  size: number;\n  sha1Hash: string;\n}\n\nexport interface IMetadata {\n  version: string;\n  files: Record<string, IMetadataFileRecord>;\n}\n\nexport type IZipSyncMode = 'pack' | 'unpack';\n\nexport type ZipSyncOptionCompression = 'store' | 'deflate' | 'zstd' | 'auto';\n\nexport const defaultBufferSize: number = 1 << 25; // 32 MiB\n"]}

package/lib/zipUtils.d.ts

@@ -0,0 +1,127 @@
+export declare const STORE_COMPRESSION: 0;
+export declare const DEFLATE_COMPRESSION: 8;
+export declare const ZSTD_COMPRESSION: 93;
+export type ZipMetaCompressionMethod = typeof STORE_COMPRESSION | typeof DEFLATE_COMPRESSION | typeof ZSTD_COMPRESSION;
+export interface IFileEntry {
+    filename: string;
+    size: number;
+    compressedSize: number;
+    crc32: number;
+    sha1Hash: string;
+    localHeaderOffset: number;
+    compressionMethod: ZipMetaCompressionMethod;
+    dosDateTime: {
+        time: number;
+        date: number;
+    };
+}
+export interface ILocalFileHeader {
+    signature: number;
+    versionNeeded: number;
+    flags: number;
+    compressionMethod: number;
+    lastModTime: number;
+    lastModDate: number;
+    crc32: number;
+    compressedSize: number;
+    uncompressedSize: number;
+    filenameLength: number;
+    extraFieldLength: number;
+}
+export interface ICentralDirectoryHeader {
+    signature: number;
+    versionMadeBy: number;
+    versionNeeded: number;
+    flags: number;
+    compressionMethod: number;
+    lastModTime: number;
+    lastModDate: number;
+    crc32: number;
+    compressedSize: number;
+    uncompressedSize: number;
+    filenameLength: number;
+    extraFieldLength: number;
+    commentLength: number;
+    diskNumberStart: number;
+    internalFileAttributes: number;
+    externalFileAttributes: number;
+    localHeaderOffset: number;
+}
+export interface IEndOfCentralDirectory {
+    signature: number;
+    diskNumber: number;
+    centralDirStartDisk: number;
+    centralDirRecordsOnDisk: number;
+    totalCentralDirRecords: number;
+    centralDirSize: number;
+    centralDirOffset: number;
+    commentLength: number;
+}
+/**
+ * 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 declare function dosDateTime(date: Date): {
+    time: number;
+    date: number;
+};
+/**
+ * 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 declare function writeLocalFileHeader(entry: IFileEntry): [fileHeaderWithoutVariableLengthData: Buffer, fileHeaderVariableLengthData: Buffer];
+/**
+ * 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 declare function writeCentralDirectoryHeader(entry: IFileEntry): Buffer[];
+/**
+ * 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 declare function writeDataDescriptor(entry: IFileEntry): Buffer;
+/**
+ * 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 declare function writeEndOfCentralDirectory(centralDirOffset: number, centralDirSize: number, entryCount: number): Buffer;
+interface ILocalFileHeaderParseResult {
+    header: ILocalFileHeader;
+    nextOffset: number;
+}
+/**
+ * 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 declare function parseLocalFileHeader(buffer: Buffer, offset: number): ILocalFileHeaderParseResult;
+export interface ICentralDirectoryHeaderParseResult {
+    header: ICentralDirectoryHeader;
+    filename: string;
+    nextOffset: number;
+}
+/**
+ * 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 declare function parseCentralDirectoryHeader(buffer: Buffer, offset: number): ICentralDirectoryHeaderParseResult;
+/**
+ * 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 declare function findEndOfCentralDirectory(buffer: Buffer): IEndOfCentralDirectory;
+/**
+ * Slice out the (possibly compressed) file data bytes for a central directory entry.
+ * Caller will decompress if needed based on entry.header.compressionMethod.
+ */
+export declare function getFileFromZip(zipBuffer: Buffer, entry: ICentralDirectoryHeaderParseResult): Buffer;
+export {};
+//# sourceMappingURL=zipUtils.d.ts.map

package/lib/zipUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zipUtils.d.ts","sourceRoot":"","sources":["../src/zipUtils.ts"],"names":[],"mappings":"AA0BA,eAAO,MAAM,iBAAiB,EAAE,CAAK,CAAC;AACtC,eAAO,MAAM,mBAAmB,EAAE,CAAK,CAAC;AACxC,eAAO,MAAM,gBAAgB,EAAE,EAAO,CAAC;AACvC,MAAM,MAAM,wBAAwB,GAChC,OAAO,iBAAiB,GACxB,OAAO,mBAAmB,GAC1B,OAAO,gBAAgB,CAAC;AAE5B,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,wBAAwB,CAAC;IAC5C,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uBAAuB,EAAE,MAAM,CAAC;IAChC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACvB;AAkBD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAYtE;AAOD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,UAAU,GAChB,CAAC,mCAAmC,EAAE,MAAM,EAAE,4BAA4B,EAAE,MAAM,CAAC,CAkCrF;AAMD;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,CA4CvE;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAU7D;AAMD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,gBAAgB,EAAE,MAAM,EACxB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,GACjB,MAAM,CAmBR;AAED,UAAU,2BAA2B;IACnC,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,2BAA2B,CAyBhG;AAED,MAAM,WAAW,kCAAkC;IACjD,MAAM,EAAE,uBAAuB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,kCAAkC,CAoCpC;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,CAiBhF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,kCAAkC,GAAG,MAAM,CASnG"}

package/lib/zipUtils.js

@@ -0,0 +1,304 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZSTD_COMPRESSION = exports.DEFLATE_COMPRESSION = exports.STORE_COMPRESSION = void 0;
+exports.dosDateTime = dosDateTime;
+exports.writeLocalFileHeader = writeLocalFileHeader;
+exports.writeCentralDirectoryHeader = writeCentralDirectoryHeader;
+exports.writeDataDescriptor = writeDataDescriptor;
+exports.writeEndOfCentralDirectory = writeEndOfCentralDirectory;
+exports.parseLocalFileHeader = parseLocalFileHeader;
+exports.parseCentralDirectoryHeader = parseCentralDirectoryHeader;
+exports.findEndOfCentralDirectory = findEndOfCentralDirectory;
+exports.getFileFromZip = getFileFromZip;
+/**
+ * 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
+exports.STORE_COMPRESSION = 0;
+exports.DEFLATE_COMPRESSION = 8;
+exports.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.
+ */
+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.
+ */
+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.
+ */
+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.
+ */
+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).
+ */
+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.
+ */
+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.
+ */
+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.
+ */
+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.
+ */
+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/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

@@ -0,0 +1,31 @@
+{
+  "name": "@rushstack/zipsync",
+  "version": "0.1.0",
+  "description": "CLI tool for creating and extracting ZIP archives with intelligent filesystem synchronization",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/microsoft/rushstack.git",
+    "directory": "apps/zipsync"
+  },
+  "bin": {
+    "zipsync": "./bin/zipsync"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "typescript": "~5.8.2",
+    "@rushstack/terminal": "0.17.0",
+    "@rushstack/ts-command-line": "5.0.4",
+    "@rushstack/lookup-by-path": "0.8.0"
+  },
+  "devDependencies": {
+    "eslint": "~9.25.1",
+    "local-node-rig": "1.0.0",
+    "@rushstack/heft": "0.75.0"
+  },
+  "scripts": {
+    "start": "node lib/start",
+    "build": "heft build --clean",
+    "_phase:build": "heft run --only build -- --clean",
+    "_phase:test": "heft run --only test -- --clean"
+  }
+}