@neoware_inc/neozipkit 0.5.0

package/dist/node/ZipCopyNode.d.ts

@@ -0,0 +1,165 @@
+import ZipEntry from '../core/ZipEntry';
+import ZipkitNode from './ZipkitNode';
+/**
+ * Options for copying ZIP files
+ */
+export interface CopyOptions {
+    /** Filter function to determine which entries to copy */
+    entryFilter?: (entry: ZipEntry) => boolean;
+    /** Sort function to reorder entries before copying */
+    entrySorter?: (a: ZipEntry, b: ZipEntry) => number;
+    /** Whether to preserve the ZIP file comment (default: true) */
+    preserveComments?: boolean;
+}
+/**
+ * Result of copying a ZIP file
+ */
+export interface CopyResult {
+    /** Information about copied entries */
+    entries: Array<{
+        filename: string;
+        localHeaderOffset: number;
+        compressedSize: number;
+    }>;
+    /** Offset to the start of the central directory */
+    centralDirOffset: number;
+    /** Total number of entries copied */
+    totalEntries: number;
+}
+/**
+ * Result of copying only ZIP entry data (no central directory or EOCD).
+ * Use with writeCentralDirectoryAndEOCD after optionally adding more entries
+ * to allow building a ZIP that includes both copied and new entries.
+ */
+export interface CopyEntriesOnlyResult {
+    /** Path to the destination file (entry data only; not yet a valid ZIP) */
+    destPath: string;
+    /** Offset at which entry data ends; central directory should start here after any new entries are appended */
+    dataEndOffset: number;
+    /** Copied entries with localHdrOffset set for the destination file */
+    copiedEntries: ZipEntry[];
+}
+/**
+ * Options for finalizing a ZIP file (writing central directory and EOCD)
+ */
+export interface FinalizeZipOptions {
+    /** ZIP file comment (default: empty) */
+    zipComment?: string;
+}
+/**
+ * Efficient ZIP file copying class
+ *
+ * Uses ZipEntry instances directly to copy entries without decompression/recompression.
+ * Supports filtering and reordering entries while maintaining ZIP file validity.
+ *
+ * Entry data and the central directory / EOCD are separated so you can add files
+ * to the copy before finalizing: use copyZipEntriesOnly, append new entries at
+ * dataEndOffset, then call writeCentralDirectoryAndEOCD with all entries.
+ *
+ * @example Full copy (one shot)
+ * ```typescript
+ * const zipCopy = new ZipCopyNode(new ZipkitNode());
+ * const result = await zipCopy.copyZipFile('source.zip', 'dest.zip', {
+ *   entryFilter: (entry) => !entry.filename.startsWith('.'),
+ *   entrySorter: (a, b) => a.filename.localeCompare(b.filename)
+ * });
+ * ```
+ *
+ * @example Copy then add files before finalizing
+ * ```typescript
+ * const zipCopy = new ZipCopyNode(new ZipkitNode());
+ * const { destPath, dataEndOffset, copiedEntries } = await zipCopy.copyZipEntriesOnly('source.zip', 'dest.zip');
+ * // ... append new entries to destPath at dataEndOffset, collect new ZipEntry[] with localHdrOffset set ...
+ * const allEntries = [...copiedEntries, ...newEntries];
+ * zipCopy.writeCentralDirectoryAndEOCD(destPath, allEntries, { zipComment: '' });
+ * ```
+ */
+export declare class ZipCopyNode {
+    private zipkitNode;
+    /**
+     * Creates a new ZipCopyNode instance
+     * @param zipkitNode - Optional ZipkitNode instance. If not provided, creates a new one.
+     */
+    constructor(zipkitNode?: ZipkitNode);
+    /**
+     * Calculate local header size by reading the actual local header
+     *
+     * Reads the first 30 bytes of the local header to get the exact
+     * filename and extra field lengths, ensuring accuracy even when
+     * local header differs from central directory.
+     *
+     * @param sourceFd - File descriptor for source ZIP file
+     * @param entry - ZipEntry with localHdrOffset
+     * @returns Size of the local header in bytes
+     */
+    private calculateLocalHeaderSize;
+    /**
+     * Copy entry bytes directly from source to destination
+     *
+     * Copies the local header and compressed data as a single operation.
+     *
+     * Handles various entry types:
+     * - Normal entries: [local header][filename][extra][compressed data]
+     * - Encrypted entries: compressedSize includes 12-byte encryption header
+     * - Data descriptor entries: [local header][filename][extra][data][data descriptor (16 bytes)]
+     *
+     * For data descriptor entries, the local header has compressed size = 0,
+     * but the actual size is in the central directory (entry.compressedSize).
+     *
+     * @param sourceFd - File descriptor for source ZIP file
+     * @param destFd - File descriptor for destination ZIP file
+     * @param entry - ZipEntry with source offset information
+     * @returns Number of bytes written
+     */
+    private copyEntryBytes;
+    /**
+     * Clone a ZipEntry with a new local header offset
+     *
+     * Creates a new ZipEntry instance with all properties copied from the source,
+     * but with an updated localHdrOffset for the destination file.
+     *
+     * @param entry - Source ZipEntry to clone
+     * @param newLocalHdrOffset - New local header offset for the destination
+     * @returns New ZipEntry instance with updated offset
+     */
+    private cloneEntryWithOffset;
+    /**
+     * Write central directory and End of Central Directory record to an open file descriptor.
+     * Used internally by copyZipFile and by writeCentralDirectoryAndEOCD.
+     */
+    private writeCentralDirectoryAndEOCDToFd;
+    /**
+     * Copy only ZIP entry data to the destination file (no central directory or EOCD).
+     * Use this when you want to add more entries before finalizing. Then call
+     * writeCentralDirectoryAndEOCD with all entries (copied + new) to produce a valid ZIP.
+     *
+     * @param sourceZipPath - Path to source ZIP file
+     * @param destZipPath - Path to destination file (will contain only entry data until finalized)
+     * @param options - Optional copy options (filtering, sorting)
+     * @returns Result with dataEndOffset and copiedEntries for use when adding files and finalizing
+     */
+    copyZipEntriesOnly(sourceZipPath: string, destZipPath: string, options?: CopyOptions): Promise<CopyEntriesOnlyResult>;
+    /**
+     * Append central directory and End of Central Directory to a file that already
+     * contains ZIP entry data (e.g. from copyZipEntriesOnly plus any newly added entries).
+     * Call this after adding files to produce a valid ZIP.
+     *
+     * @param destZipPath - Path to the partial ZIP file (entry data only)
+     * @param entries - All entries in order (copied + any new), each with localHdrOffset set
+     * @param options - Optional finalize options (e.g. zipComment)
+     */
+    writeCentralDirectoryAndEOCD(destZipPath: string, entries: ZipEntry[], options?: FinalizeZipOptions): void;
+    /**
+     * Copy ZIP file entries efficiently
+     *
+     * Main method that copies entries from source ZIP to destination ZIP.
+     * Uses ZipEntry instances directly to avoid unnecessary parsing.
+     *
+     * @param sourceZipPath - Path to source ZIP file
+     * @param destZipPath - Path to destination ZIP file
+     * @param options - Optional copy options (filtering, sorting, etc.)
+     * @returns Copy result with entry information
+     */
+    copyZipFile(sourceZipPath: string, destZipPath: string, options?: CopyOptions): Promise<CopyResult>;
+}
+//# sourceMappingURL=ZipCopyNode.d.ts.map

package/dist/node/ZipCopyNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZipCopyNode.d.ts","sourceRoot":"","sources":["../../src/node/ZipCopyNode.ts"],"names":[],"mappings":"AAUA,OAAO,QAAQ,MAAM,kBAAkB,CAAC;AACxC,OAAO,UAAU,MAAM,cAAc,CAAC;AAGtC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC;IAC3C,sDAAsD;IACtD,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,KAAK,MAAM,CAAC;IACnD,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,OAAO,EAAE,KAAK,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;IACH,mDAAmD;IACnD,gBAAgB,EAAE,MAAM,CAAC;IACzB,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,8GAA8G;IAC9G,aAAa,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,aAAa,EAAE,QAAQ,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAa;IAE/B;;;OAGG;gBACS,UAAU,CAAC,EAAE,UAAU;IAInC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,wBAAwB;IAoBhC;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,cAAc;IAiDtB;;;;;;;;;OASG;IACH,OAAO,CAAC,oBAAoB;IAoD5B;;;OAGG;IACH,OAAO,CAAC,gCAAgC;IA8CxC;;;;;;;;;OASG;IACG,kBAAkB,CACtB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,qBAAqB,CAAC;IAyCjC;;;;;;;;OAQG;IACH,4BAA4B,CAC1B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,QAAQ,EAAE,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,IAAI;IAeP;;;;;;;;;;OAUG;IACG,WAAW,CACf,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC;CAyBvB"}

package/dist/node/ZipCopyNode.js

@@ -0,0 +1,347 @@
+"use strict";
+// ======================================
+//	ZipCopyNode.ts - Efficient ZIP Entry Copying
+//  Copyright (c) 2025 NeoWare, Inc. All rights reserved.
+// ======================================
+//
+// Efficient ZIP entry copying using ZipEntry instances directly.
+// Leverages existing offsets and sizes to copy raw bytes without
+// unnecessary parsing and reconstruction.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZipCopyNode = void 0;
+const fs = __importStar(require("fs"));
+const ZipEntry_1 = __importDefault(require("../core/ZipEntry"));
+const ZipkitNode_1 = __importDefault(require("./ZipkitNode"));
+const Headers_1 = require("../core/constants/Headers");
+/**
+ * Efficient ZIP file copying class
+ *
+ * Uses ZipEntry instances directly to copy entries without decompression/recompression.
+ * Supports filtering and reordering entries while maintaining ZIP file validity.
+ *
+ * Entry data and the central directory / EOCD are separated so you can add files
+ * to the copy before finalizing: use copyZipEntriesOnly, append new entries at
+ * dataEndOffset, then call writeCentralDirectoryAndEOCD with all entries.
+ *
+ * @example Full copy (one shot)
+ * ```typescript
+ * const zipCopy = new ZipCopyNode(new ZipkitNode());
+ * const result = await zipCopy.copyZipFile('source.zip', 'dest.zip', {
+ *   entryFilter: (entry) => !entry.filename.startsWith('.'),
+ *   entrySorter: (a, b) => a.filename.localeCompare(b.filename)
+ * });
+ * ```
+ *
+ * @example Copy then add files before finalizing
+ * ```typescript
+ * const zipCopy = new ZipCopyNode(new ZipkitNode());
+ * const { destPath, dataEndOffset, copiedEntries } = await zipCopy.copyZipEntriesOnly('source.zip', 'dest.zip');
+ * // ... append new entries to destPath at dataEndOffset, collect new ZipEntry[] with localHdrOffset set ...
+ * const allEntries = [...copiedEntries, ...newEntries];
+ * zipCopy.writeCentralDirectoryAndEOCD(destPath, allEntries, { zipComment: '' });
+ * ```
+ */
+class ZipCopyNode {
+    /**
+     * Creates a new ZipCopyNode instance
+     * @param zipkitNode - Optional ZipkitNode instance. If not provided, creates a new one.
+     */
+    constructor(zipkitNode) {
+        this.zipkitNode = zipkitNode || new ZipkitNode_1.default();
+    }
+    /**
+     * Calculate local header size by reading the actual local header
+     *
+     * Reads the first 30 bytes of the local header to get the exact
+     * filename and extra field lengths, ensuring accuracy even when
+     * local header differs from central directory.
+     *
+     * @param sourceFd - File descriptor for source ZIP file
+     * @param entry - ZipEntry with localHdrOffset
+     * @returns Size of the local header in bytes
+     */
+    calculateLocalHeaderSize(sourceFd, entry) {
+        // Read the fixed 30-byte local header
+        const headerBuffer = Buffer.alloc(Headers_1.LOCAL_HDR.SIZE);
+        fs.readSync(sourceFd, headerBuffer, 0, Headers_1.LOCAL_HDR.SIZE, entry.localHdrOffset);
+        // Verify signature
+        if (headerBuffer.readUInt32LE(0) !== Headers_1.LOCAL_HDR.SIGNATURE) {
+            throw new Error(`Invalid local file header signature for entry ${entry.filename} at offset ${entry.localHdrOffset}`);
+        }
+        // Read filename and extra field lengths from the actual header
+        const filenameLength = headerBuffer.readUInt16LE(Headers_1.LOCAL_HDR.FNAME_LEN);
+        const extraFieldLength = headerBuffer.readUInt16LE(Headers_1.LOCAL_HDR.EXTRA_LEN);
+        // Calculate total local header size
+        return Headers_1.LOCAL_HDR.SIZE + filenameLength + extraFieldLength;
+    }
+    /**
+     * Copy entry bytes directly from source to destination
+     *
+     * Copies the local header and compressed data as a single operation.
+     *
+     * Handles various entry types:
+     * - Normal entries: [local header][filename][extra][compressed data]
+     * - Encrypted entries: compressedSize includes 12-byte encryption header
+     * - Data descriptor entries: [local header][filename][extra][data][data descriptor (16 bytes)]
+     *
+     * For data descriptor entries, the local header has compressed size = 0,
+     * but the actual size is in the central directory (entry.compressedSize).
+     *
+     * @param sourceFd - File descriptor for source ZIP file
+     * @param destFd - File descriptor for destination ZIP file
+     * @param entry - ZipEntry with source offset information
+     * @returns Number of bytes written
+     */
+    copyEntryBytes(sourceFd, destFd, entry) {
+        // Calculate local header size by reading the actual header
+        const localHeaderSize = this.calculateLocalHeaderSize(sourceFd, entry);
+        // Determine total entry size
+        // For data descriptor entries, add 16 bytes for the data descriptor
+        const hasDataDescriptor = (entry.bitFlags & Headers_1.GP_FLAG.DATA_DESC) !== 0;
+        const totalEntrySize = localHeaderSize + entry.compressedSize + (hasDataDescriptor ? 16 : 0);
+        // Read the entire entry (local header + compressed data + data descriptor if present) from source
+        const entryBuffer = Buffer.alloc(totalEntrySize);
+        const bytesRead = fs.readSync(sourceFd, entryBuffer, 0, totalEntrySize, entry.localHdrOffset);
+        if (bytesRead !== totalEntrySize) {
+            throw new Error(`Failed to read complete entry for ${entry.filename}: ` +
+                `expected ${totalEntrySize} bytes, got ${bytesRead}`);
+        }
+        // Verify data descriptor signature if present
+        if (hasDataDescriptor) {
+            const dataDescOffset = localHeaderSize + entry.compressedSize;
+            const dataDescSig = entryBuffer.readUInt32LE(dataDescOffset);
+            if (dataDescSig !== 0x08074b50) { // DATA_DESCRIPTOR signature
+                throw new Error(`Invalid data descriptor signature for entry ${entry.filename} ` +
+                    `(expected 0x08074b50, got 0x${dataDescSig.toString(16)})`);
+            }
+        }
+        // Write to destination
+        const bytesWritten = fs.writeSync(destFd, entryBuffer, 0, totalEntrySize);
+        if (bytesWritten !== totalEntrySize) {
+            throw new Error(`Failed to write complete entry for ${entry.filename}: ` +
+                `expected ${totalEntrySize} bytes, wrote ${bytesWritten}`);
+        }
+        return bytesWritten;
+    }
+    /**
+     * Clone a ZipEntry with a new local header offset
+     *
+     * Creates a new ZipEntry instance with all properties copied from the source,
+     * but with an updated localHdrOffset for the destination file.
+     *
+     * @param entry - Source ZipEntry to clone
+     * @param newLocalHdrOffset - New local header offset for the destination
+     * @returns New ZipEntry instance with updated offset
+     */
+    cloneEntryWithOffset(entry, newLocalHdrOffset) {
+        // Create a new ZipEntry with the same filename and comment
+        const cloned = new ZipEntry_1.default(entry.filename, entry.comment || null, entry.debug);
+        // Copy all properties
+        cloned.verMadeBy = entry.verMadeBy;
+        cloned.verExtract = entry.verExtract;
+        cloned.bitFlags = entry.bitFlags;
+        cloned.cmpMethod = entry.cmpMethod;
+        cloned.timeDateDOS = entry.timeDateDOS;
+        cloned.crc = entry.crc;
+        cloned.compressedSize = entry.compressedSize;
+        cloned.uncompressedSize = entry.uncompressedSize;
+        cloned.volNumber = entry.volNumber;
+        cloned.intFileAttr = entry.intFileAttr;
+        cloned.extFileAttr = entry.extFileAttr;
+        cloned.localHdrOffset = newLocalHdrOffset; // Update offset
+        // Copy extra field if present
+        if (entry.extraField) {
+            cloned.extraField = Buffer.from(entry.extraField);
+        }
+        // Copy metadata
+        cloned.isEncrypted = entry.isEncrypted;
+        cloned.isStrongEncrypt = entry.isStrongEncrypt;
+        cloned.isDirectory = entry.isDirectory;
+        cloned.isMetaData = entry.isMetaData;
+        cloned.isUpdated = entry.isUpdated;
+        // Copy platform-specific data
+        cloned.platform = entry.platform;
+        cloned.universalTime = entry.universalTime;
+        cloned.uid = entry.uid;
+        cloned.gid = entry.gid;
+        cloned.sha256 = entry.sha256;
+        // Copy symlink data
+        cloned.isSymlink = entry.isSymlink;
+        cloned.linkTarget = entry.linkTarget;
+        // Copy hardlink data
+        cloned.isHardLink = entry.isHardLink;
+        cloned.originalEntry = entry.originalEntry;
+        cloned.inode = entry.inode;
+        return cloned;
+    }
+    /**
+     * Write central directory and End of Central Directory record to an open file descriptor.
+     * Used internally by copyZipFile and by writeCentralDirectoryAndEOCD.
+     */
+    writeCentralDirectoryAndEOCDToFd(destFd, entries, zipComment) {
+        const centralDirStartOffset = fs.fstatSync(destFd).size;
+        for (const entry of entries) {
+            const centralDirBuffer = entry.centralDirEntry();
+            fs.writeSync(destFd, centralDirBuffer, 0, centralDirBuffer.length);
+        }
+        const centralDirEndOffset = fs.fstatSync(destFd).size;
+        const centralDirSize = centralDirEndOffset - centralDirStartOffset;
+        const commentBytes = Buffer.from(zipComment, 'utf8');
+        const commentLength = Math.min(commentBytes.length, 0xFFFF);
+        const eocdBuffer = Buffer.alloc(22 + commentLength);
+        let pos = 0;
+        eocdBuffer.writeUInt32LE(Headers_1.CENTRAL_END.SIGNATURE, pos);
+        pos += 4;
+        eocdBuffer.writeUInt16LE(0, pos);
+        pos += 2;
+        eocdBuffer.writeUInt16LE(0, pos);
+        pos += 2;
+        eocdBuffer.writeUInt16LE(entries.length, pos);
+        pos += 2;
+        eocdBuffer.writeUInt16LE(entries.length, pos);
+        pos += 2;
+        eocdBuffer.writeUInt32LE(centralDirSize, pos);
+        pos += 4;
+        eocdBuffer.writeUInt32LE(centralDirStartOffset, pos);
+        pos += 4;
+        eocdBuffer.writeUInt16LE(commentLength, pos);
+        pos += 2;
+        if (commentLength > 0) {
+            commentBytes.copy(eocdBuffer, pos, 0, commentLength);
+        }
+        fs.writeSync(destFd, eocdBuffer, 0, eocdBuffer.length);
+        return { centralDirOffset: centralDirStartOffset, centralDirSize };
+    }
+    /**
+     * Copy only ZIP entry data to the destination file (no central directory or EOCD).
+     * Use this when you want to add more entries before finalizing. Then call
+     * writeCentralDirectoryAndEOCD with all entries (copied + new) to produce a valid ZIP.
+     *
+     * @param sourceZipPath - Path to source ZIP file
+     * @param destZipPath - Path to destination file (will contain only entry data until finalized)
+     * @param options - Optional copy options (filtering, sorting)
+     * @returns Result with dataEndOffset and copiedEntries for use when adding files and finalizing
+     */
+    async copyZipEntriesOnly(sourceZipPath, destZipPath, options) {
+        const sourceEntries = await this.zipkitNode.loadZipFile(sourceZipPath);
+        let entriesToCopy = options?.entryFilter
+            ? sourceEntries.filter(options.entryFilter)
+            : sourceEntries;
+        if (options?.entrySorter) {
+            entriesToCopy = [...entriesToCopy].sort(options.entrySorter);
+        }
+        if (entriesToCopy.length === 0) {
+            throw new Error('No entries to copy after filtering');
+        }
+        const sourceFd = fs.openSync(sourceZipPath, 'r');
+        const destFd = fs.openSync(destZipPath, 'w');
+        try {
+            let destOffset = 0;
+            const copiedEntries = [];
+            for (const sourceEntry of entriesToCopy) {
+                const newLocalHdrOffset = destOffset;
+                const bytesWritten = this.copyEntryBytes(sourceFd, destFd, sourceEntry);
+                destOffset += bytesWritten;
+                const clonedEntry = this.cloneEntryWithOffset(sourceEntry, newLocalHdrOffset);
+                copiedEntries.push(clonedEntry);
+            }
+            return {
+                destPath: destZipPath,
+                dataEndOffset: destOffset,
+                copiedEntries,
+            };
+        }
+        finally {
+            fs.closeSync(sourceFd);
+            fs.closeSync(destFd);
+        }
+    }
+    /**
+     * Append central directory and End of Central Directory to a file that already
+     * contains ZIP entry data (e.g. from copyZipEntriesOnly plus any newly added entries).
+     * Call this after adding files to produce a valid ZIP.
+     *
+     * @param destZipPath - Path to the partial ZIP file (entry data only)
+     * @param entries - All entries in order (copied + any new), each with localHdrOffset set
+     * @param options - Optional finalize options (e.g. zipComment)
+     */
+    writeCentralDirectoryAndEOCD(destZipPath, entries, options) {
+        if (entries.length === 0) {
+            throw new Error('At least one entry is required to finalize');
+        }
+        const zipComment = options?.zipComment ?? '';
+        const destFd = fs.openSync(destZipPath, 'a');
+        try {
+            this.writeCentralDirectoryAndEOCDToFd(destFd, entries, zipComment);
+        }
+        finally {
+            fs.closeSync(destFd);
+        }
+    }
+    /**
+     * Copy ZIP file entries efficiently
+     *
+     * Main method that copies entries from source ZIP to destination ZIP.
+     * Uses ZipEntry instances directly to avoid unnecessary parsing.
+     *
+     * @param sourceZipPath - Path to source ZIP file
+     * @param destZipPath - Path to destination ZIP file
+     * @param options - Optional copy options (filtering, sorting, etc.)
+     * @returns Copy result with entry information
+     */
+    async copyZipFile(sourceZipPath, destZipPath, options) {
+        // Copy only entry data, then write central directory and EOCD (no added entries)
+        const { dataEndOffset, copiedEntries } = await this.copyZipEntriesOnly(sourceZipPath, destZipPath, options);
+        const zipComment = options?.preserveComments !== false && this.zipkitNode.getZipComment()
+            ? this.zipkitNode.getZipComment()
+            : '';
+        this.writeCentralDirectoryAndEOCD(destZipPath, copiedEntries, { zipComment });
+        return {
+            entries: copiedEntries.map(entry => ({
+                filename: entry.filename,
+                localHeaderOffset: entry.localHdrOffset,
+                compressedSize: entry.compressedSize,
+            })),
+            centralDirOffset: dataEndOffset,
+            totalEntries: copiedEntries.length,
+        };
+    }
+}
+exports.ZipCopyNode = ZipCopyNode;
+//# sourceMappingURL=ZipCopyNode.js.map

package/dist/node/ZipCopyNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZipCopyNode.js","sourceRoot":"","sources":["../../src/node/ZipCopyNode.ts"],"names":[],"mappings":";AAAA,yCAAyC;AACzC,+CAA+C;AAC/C,yDAAyD;AACzD,yCAAyC;AACzC,EAAE;AACF,iEAAiE;AACjE,iEAAiE;AACjE,0CAA0C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE1C,uCAAyB;AACzB,gEAAwC;AACxC,8DAAsC;AACtC,uDAA4E;AAoD5E;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAa,WAAW;IAGtB;;;OAGG;IACH,YAAY,UAAuB;QACjC,IAAI,CAAC,UAAU,GAAG,UAAU,IAAI,IAAI,oBAAU,EAAE,CAAC;IACnD,CAAC;IAED;;;;;;;;;;OAUG;IACK,wBAAwB,CAAC,QAAgB,EAAE,KAAe;QAChE,sCAAsC;QACtC,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,mBAAS,CAAC,IAAI,CAAC,CAAC;QAClD,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,EAAE,mBAAS,CAAC,IAAI,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;QAE7E,mBAAmB;QACnB,IAAI,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,mBAAS,CAAC,SAAS,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CACb,iDAAiD,KAAK,CAAC,QAAQ,cAAc,KAAK,CAAC,cAAc,EAAE,CACpG,CAAC;QACJ,CAAC;QAED,+DAA+D;QAC/D,MAAM,cAAc,GAAG,YAAY,CAAC,YAAY,CAAC,mBAAS,CAAC,SAAS,CAAC,CAAC;QACtE,MAAM,gBAAgB,GAAG,YAAY,CAAC,YAAY,CAAC,mBAAS,CAAC,SAAS,CAAC,CAAC;QAExE,oCAAoC;QACpC,OAAO,mBAAS,CAAC,IAAI,GAAG,cAAc,GAAG,gBAAgB,CAAC;IAC5D,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACK,cAAc,CACpB,QAAgB,EAChB,MAAc,EACd,KAAe;QAEf,2DAA2D;QAC3D,MAAM,eAAe,GAAG,IAAI,CAAC,wBAAwB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAEvE,6BAA6B;QAC7B,oEAAoE;QACpE,MAAM,iBAAiB,GAAG,CAAC,KAAK,CAAC,QAAQ,GAAG,iBAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACrE,MAAM,cAAc,GAAG,eAAe,GAAG,KAAK,CAAC,cAAc,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAE7F,kGAAkG;QAClG,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;QAE9F,IAAI,SAAS,KAAK,cAAc,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CACb,qCAAqC,KAAK,CAAC,QAAQ,IAAI;gBACvD,YAAY,cAAc,eAAe,SAAS,EAAE,CACrD,CAAC;QACJ,CAAC;QAED,8CAA8C;QAC9C,IAAI,iBAAiB,EAAE,CAAC;YACtB,MAAM,cAAc,GAAG,eAAe,GAAG,KAAK,CAAC,cAAc,CAAC;YAC9D,MAAM,WAAW,GAAG,WAAW,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;YAC7D,IAAI,WAAW,KAAK,UAAU,EAAE,CAAC,CAAC,4BAA4B;gBAC5D,MAAM,IAAI,KAAK,CACb,+CAA+C,KAAK,CAAC,QAAQ,GAAG;oBAChE,+BAA+B,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAC3D,CAAC;YACJ,CAAC;QACH,CAAC;QAED,uBAAuB;QACvB,MAAM,YAAY,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,cAAc,CAAC,CAAC;QAE1E,IAAI,YAAY,KAAK,cAAc,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,sCAAsC,KAAK,CAAC,QAAQ,IAAI;gBACxD,YAAY,cAAc,iBAAiB,YAAY,EAAE,CAC1D,CAAC;QACJ,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAED;;;;;;;;;OASG;IACK,oBAAoB,CAC1B,KAAe,EACf,iBAAyB;QAEzB,2DAA2D;QAC3D,MAAM,MAAM,GAAG,IAAI,kBAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAEhF,sBAAsB;QACtB,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACnC,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACrC,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QACjC,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACnC,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QACvC,MAAM,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QACvB,MAAM,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC;QAC7C,MAAM,CAAC,gBAAgB,GAAG,KAAK,CAAC,gBAAgB,CAAC;QACjD,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACnC,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QACvC,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QACvC,MAAM,CAAC,cAAc,GAAG,iBAAiB,CAAC,CAAC,gBAAgB;QAE3D,8BAA8B;QAC9B,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACpD,CAAC;QAED,gBAAgB;QAChB,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QACvC,MAAM,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;QAC/C,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QACvC,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACrC,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QAEnC,8BAA8B;QAC9B,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QACjC,MAAM,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;QAC3C,MAAM,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QACvB,MAAM,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QACvB,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAE7B,oBAAoB;QACpB,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACnC,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QAErC,qBAAqB;QACrB,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACrC,MAAM,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;QAC3C,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAE3B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;OAGG;IACK,gCAAgC,CACtC,MAAc,EACd,OAAmB,EACnB,UAAkB;QAElB,MAAM,qBAAqB,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;QAExD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,gBAAgB,GAAG,KAAK,CAAC,eAAe,EAAE,CAAC;YACjD,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,mBAAmB,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;QACtD,MAAM,cAAc,GAAG,mBAAmB,GAAG,qBAAqB,CAAC;QAEnE,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACrD,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAE5D,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,aAAa,CAAC,CAAC;QACpD,IAAI,GAAG,GAAG,CAAC,CAAC;QAEZ,UAAU,CAAC,aAAa,CAAC,qBAAW,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACrD,GAAG,IAAI,CAAC,CAAC;QACT,UAAU,CAAC,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACjC,GAAG,IAAI,CAAC,CAAC;QACT,UAAU,CAAC,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACjC,GAAG,IAAI,CAAC,CAAC;QACT,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC9C,GAAG,IAAI,CAAC,CAAC;QACT,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC9C,GAAG,IAAI,CAAC,CAAC;QACT,UAAU,CAAC,aAAa,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;QAC9C,GAAG,IAAI,CAAC,CAAC;QACT,UAAU,CAAC,aAAa,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC;QACrD,GAAG,IAAI,CAAC,CAAC;QACT,UAAU,CAAC,aAAa,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;QAC7C,GAAG,IAAI,CAAC,CAAC;QACT,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;YACtB,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE,aAAa,CAAC,CAAC;QACvD,CAAC;QAED,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QAEvD,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,cAAc,EAAE,CAAC;IACrE,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,kBAAkB,CACtB,aAAqB,EACrB,WAAmB,EACnB,OAAqB;QAErB,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;QAEvE,IAAI,aAAa,GAAG,OAAO,EAAE,WAAW;YACtC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;YAC3C,CAAC,CAAC,aAAa,CAAC;QAElB,IAAI,OAAO,EAAE,WAAW,EAAE,CAAC;YACzB,aAAa,GAAG,CAAC,GAAG,aAAa,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC/D,CAAC;QAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QAE7C,IAAI,CAAC;YACH,IAAI,UAAU,GAAG,CAAC,CAAC;YACnB,MAAM,aAAa,GAAe,EAAE,CAAC;YAErC,KAAK,MAAM,WAAW,IAAI,aAAa,EAAE,CAAC;gBACxC,MAAM,iBAAiB,GAAG,UAAU,CAAC;gBACrC,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;gBACxE,UAAU,IAAI,YAAY,CAAC;gBAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,oBAAoB,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;gBAC9E,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAClC,CAAC;YAED,OAAO;gBACL,QAAQ,EAAE,WAAW;gBACrB,aAAa,EAAE,UAAU;gBACzB,aAAa;aACd,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACvB,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,4BAA4B,CAC1B,WAAmB,EACnB,OAAmB,EACnB,OAA4B;QAE5B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QAE7C,IAAI,CAAC;YACH,IAAI,CAAC,gCAAgC,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QACrE,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,WAAW,CACf,aAAqB,EACrB,WAAmB,EACnB,OAAqB;QAErB,iFAAiF;QACjF,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,GAAG,MAAM,IAAI,CAAC,kBAAkB,CACpE,aAAa,EACb,WAAW,EACX,OAAO,CACR,CAAC;QAEF,MAAM,UAAU,GACd,OAAO,EAAE,gBAAgB,KAAK,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE;YACpE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,EAAG;YAClC,CAAC,CAAC,EAAE,CAAC;QAET,IAAI,CAAC,4BAA4B,CAAC,WAAW,EAAE,aAAa,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QAE9E,OAAO;YACL,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACnC,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,iBAAiB,EAAE,KAAK,CAAC,cAAc;gBACvC,cAAc,EAAE,KAAK,CAAC,cAAc;aACrC,CAAC,CAAC;YACH,gBAAgB,EAAE,aAAa;YAC/B,YAAY,EAAE,aAAa,CAAC,MAAM;SACnC,CAAC;IACJ,CAAC;CACF;AAxVD,kCAwVC"}