@neoware_inc/neozipkit 0.5.0

package/dist/browser.d.ts

@@ -0,0 +1,9 @@
+export * from "./core";
+import Zipkit from "./core";
+export default Zipkit;
+export { default as ZipkitBrowser } from "./browser/ZipkitBrowser";
+export declare const PlatformUtils: {
+    isBrowser: boolean;
+    isNode: string | false;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/browser.js

@@ -0,0 +1,38 @@
+"use strict";
+// =============================================================================
+// NeoZipkit - Browser-Only Package Exports
+// =============================================================================
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlatformUtils = exports.ZipkitBrowser = void 0;
+// Core shared exports (re-exported from core module)
+__exportStar(require("./core"), exports);
+const core_1 = __importDefault(require("./core"));
+exports.default = core_1.default;
+// Browser-only exports
+var ZipkitBrowser_1 = require("./browser/ZipkitBrowser");
+Object.defineProperty(exports, "ZipkitBrowser", { enumerable: true, get: function () { return __importDefault(ZipkitBrowser_1).default; } });
+// Platform-specific conditional exports
+exports.PlatformUtils = {
+    // Browser detection
+    isBrowser: typeof window !== 'undefined' && typeof document !== 'undefined',
+    // Node.js detection
+    isNode: typeof process !== 'undefined' && process.versions && process.versions.node,
+};
+//# sourceMappingURL=index.js.map

package/dist/core/ZipCompress.d.ts

@@ -0,0 +1,99 @@
+import Zipkit from './Zipkit';
+import ZipEntry from './ZipEntry';
+/**
+ * Options for compressing files in a ZIP archive
+ */
+export interface CompressOptions {
+    level?: number;
+    password?: string | null;
+    useSHA256?: boolean;
+    useZstd?: boolean;
+    bufferSize?: number;
+}
+/**
+ * Callbacks for ZIP file creation process
+ * Buffer-based only - no file I/O operations
+ */
+export interface CreateZipOptions {
+    onError?: (error: Error) => void;
+    onEntryDone?: (entry: ZipEntry, status: string) => void;
+    onOutputBuffer?: (data: Buffer) => Promise<void>;
+}
+/**
+ * Compression handler for ZIP files
+ * Supports Deflate, Zstandard, and Store methods
+ */
+export declare class ZipCompress {
+    private zipkit;
+    private debug;
+    private static loggingEnabled;
+    /**
+     * Internal logging method - only logs if class logging is enabled
+     */
+    private log;
+    /**
+     * Creates a new ZipCompress instance
+     * @param zipkit - Zipkit instance to use for ZIP operations
+     */
+    constructor(zipkit: Zipkit);
+    /**
+     * Compresses data for a ZIP entry (Buffer-based only)
+     * @param entry - ZIP entry to compress
+     * @param data - Buffer containing data to compress
+     * @param options - Compression options
+     * @param onOutputBuffer - Optional callback for streaming output
+     * @returns Buffer containing compressed data
+     */
+    compressData(entry: ZipEntry, data: Buffer, options?: CompressOptions, onOutputBuffer?: (data: Buffer) => Promise<void>): Promise<Buffer>;
+    /**
+     * Compress data using deflate algorithm with chunked processing
+     * @param data - Data to compress (Buffer or chunked reader)
+     * @param options - Compression options
+     * @param bufferSize - Buffer size for chunked processing
+     * @param entry - ZIP entry being compressed
+     * @param onOutputBuffer - Optional callback for streaming output
+     * @returns Buffer containing compressed data
+     */
+    deflateCompress(data: Buffer | {
+        totalSize: number;
+        onReadChunk: (position: number, size: number) => Buffer;
+        onOutChunk: (chunk: Buffer) => void;
+    }, options?: CompressOptions, bufferSize?: number, entry?: ZipEntry, onOutputBuffer?: (data: Buffer) => Promise<void>): Promise<Buffer>;
+    /**
+     * Compress data using deflate algorithm (synchronous, small buffers only)
+     * @param inbuf - Buffer containing data to compress
+     * @param options - Compression options
+     * @returns Buffer containing compressed data
+     */
+    deflate(inbuf: Buffer, options?: CompressOptions): Buffer;
+    /**
+     * Compress data using Zstandard (zstd) algorithm
+     * @param input - Input data to compress (Buffer or chunked reader)
+     * @param options - Compression options
+     * @param bufferSize - Buffer size for chunked processing
+     * @param entry - ZIP entry being compressed
+     * @param onOutputBuffer - Optional callback for streaming output
+     * @returns Buffer containing compressed data
+     */
+    zstdCompress(input: Buffer | {
+        totalSize: number;
+        readChunk: (position: number, size: number) => Buffer;
+    }, options?: CompressOptions, bufferSize?: number, entry?: ZipEntry, onOutputBuffer?: (data: Buffer) => Promise<void>): Promise<Buffer>;
+    /**
+     * Encrypt compressed data using PKZIP encryption
+     * @param entry - ZIP entry to encrypt
+     * @param compressedData - Compressed data to encrypt
+     * @param password - Password for encryption
+     * @returns Buffer containing encrypted data (includes 12-byte header)
+     */
+    encryptCompressedData(entry: ZipEntry, compressedData: Buffer, password: string): Buffer;
+    /**
+     * Compress file data in memory and return ZIP entry information as Buffer
+     * @param entry - ZIP entry to compress
+     * @param fileData - File data buffer to compress
+     * @param cmpOptions - Compression options
+     * @returns Buffer containing local header + compressed data
+     */
+    compressFileBuffer(entry: ZipEntry, fileData: Buffer, cmpOptions?: CompressOptions): Promise<Buffer>;
+}
+//# sourceMappingURL=ZipCompress.d.ts.map

package/dist/core/ZipCompress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZipCompress.d.ts","sourceRoot":"","sources":["../../src/core/ZipCompress.ts"],"names":[],"mappings":"AAiBA,OAAO,MAAM,MAAM,UAAU,CAAC;AAE9B,OAAO,QAAQ,MAAM,YAAY,CAAC;AAMlC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACxD,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAU;IAGvB,OAAO,CAAC,MAAM,CAAC,cAAc,CAAkB;IAE/C;;OAEG;IACH,OAAO,CAAC,GAAG;IAMX;;;OAGG;gBACS,MAAM,EAAE,MAAM;IAW1B;;;;;;;OAOG;IACG,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,EAAE,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAsF/I;;;;;;;;OAQG;IACG,eAAe,CACnB,IAAI,EAAE,MAAM,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;QAAC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,EAClI,OAAO,CAAC,EAAE,eAAe,EACzB,UAAU,CAAC,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,QAAQ,EAChB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAC/C,OAAO,CAAC,MAAM,CAAC;IAyDlB;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,MAAM;IASzD;;;;;;;;OAQG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;KAAE,EAC5F,OAAO,CAAC,EAAE,eAAe,EACzB,UAAU,CAAC,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,QAAQ,EAChB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAC/C,OAAO,CAAC,MAAM,CAAC;IA+BlB;;;;;;OAMG;IACH,qBAAqB,CAAC,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAWxF;;;;;;OAMG;IACG,kBAAkB,CACtB,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,eAAe,GAC3B,OAAO,CAAC,MAAM,CAAC;CAgCnB"}

package/dist/core/ZipCompress.js

@@ -0,0 +1,287 @@
+"use strict";
+// ======================================
+//	ZipkitCompress.ts - Compression Module
+//  Copyright (c) 2025 NeoWare, Inc. All rights reserved.
+// ======================================
+//
+// LOGGING INSTRUCTIONS:
+// ---------------------
+// To enable/disable logging, set loggingEnabled to true/false in the class:
+//   private static loggingEnabled: boolean = true;  // Enable logging
+//   private static loggingEnabled: boolean = false; // Disable logging
+//
+// Logging respects the global Logger level (debug, info, warn, error, silent).
+// Logger level is automatically set to 'debug' when loggingEnabled is true.
+//
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZipCompress = void 0;
+const pako = require('pako');
+const ZstdManager_1 = require("./ZstdManager");
+const Logger_1 = require("./components/Logger");
+const Headers_1 = require("./constants/Headers");
+const HashCalculator_1 = require("./components/HashCalculator");
+const ZipCrypto_1 = require("./encryption/ZipCrypto");
+/**
+ * Compression handler for ZIP files
+ * Supports Deflate, Zstandard, and Store methods
+ */
+class ZipCompress {
+    /**
+     * Internal logging method - only logs if class logging is enabled
+     */
+    log(...args) {
+        if (ZipCompress.loggingEnabled) {
+            Logger_1.Logger.debug(`[ZipCompress]`, ...args);
+        }
+    }
+    /**
+     * Creates a new ZipCompress instance
+     * @param zipkit - Zipkit instance to use for ZIP operations
+     */
+    constructor(zipkit) {
+        this.zipkit = zipkit;
+        // Debug disabled by default (controlled by class-level logging)
+        this.debug = false;
+        // If logging is enabled, ensure Logger level is set to debug
+        if (ZipCompress.loggingEnabled) {
+            Logger_1.Logger.setLevel('debug');
+        }
+        this.log(`ZipCompress initialized`);
+    }
+    /**
+     * Compresses data for a ZIP entry (Buffer-based only)
+     * @param entry - ZIP entry to compress
+     * @param data - Buffer containing data to compress
+     * @param options - Compression options
+     * @param onOutputBuffer - Optional callback for streaming output
+     * @returns Buffer containing compressed data
+     */
+    async compressData(entry, data, options, onOutputBuffer) {
+        this.log(`compressData() called for entry: ${entry.filename}`);
+        // Set uncompressed size if not already set
+        if (!entry.uncompressedSize || entry.uncompressedSize === 0) {
+            entry.uncompressedSize = data.length;
+        }
+        const totalSize = data.length;
+        const bufferSize = options?.bufferSize || this.zipkit.getBufferSize(); // Use Zipkit's bufferSize
+        this.log(`Compressing ${totalSize} bytes for entry: ${entry.filename}`);
+        this.log(`Compression options:`, { level: options?.level, useZstd: options?.useZstd, bufferSize });
+        // Determine compression method
+        let compressionMethod;
+        if (options?.level === 0) {
+            compressionMethod = Headers_1.CMP_METHOD.STORED;
+            this.log(`Using STORED method (no compression)`);
+        }
+        else if (options?.useZstd) {
+            // ZSTD fallback to STORED if file too small
+            if (totalSize < 100) {
+                compressionMethod = Headers_1.CMP_METHOD.STORED;
+                this.log(`ZSTD fallback to STORED (file too small: ${totalSize} bytes)`);
+            }
+            else {
+                compressionMethod = Headers_1.CMP_METHOD.ZSTD;
+                this.log(`Using ZSTD method (zstd compression)`);
+            }
+        }
+        else {
+            compressionMethod = Headers_1.CMP_METHOD.DEFLATED;
+            this.log(`Using DEFLATED method (default compression)`);
+        }
+        entry.cmpMethod = compressionMethod;
+        // Initialize hash calculator
+        const needsHashCalculation = (!entry.crc || entry.crc === 0) || (options?.useSHA256 && !entry.sha256);
+        const hashCalculator = needsHashCalculation ? new HashCalculator_1.HashCalculator({ useSHA256: options?.useSHA256 && !entry.sha256 || false }) : null;
+        // Calculate hashes if needed
+        if (hashCalculator) {
+            hashCalculator.update(data);
+            if (!entry.crc || entry.crc === 0) {
+                entry.crc = hashCalculator.finalizeCRC32();
+            }
+            if (options?.useSHA256 && !entry.sha256) {
+                entry.sha256 = hashCalculator.finalizeSHA256();
+            }
+            this.log(`Final hashes: CRC32=0x${entry.crc.toString(16).padStart(8, '0')}, SHA256=${entry.sha256 || 'N/A'}`);
+        }
+        // Encrypt if password provided
+        if (options?.password) {
+            this.log(`Encrypting compressed data for entry: ${entry.filename}`);
+            entry.gpFlag = (entry.gpFlag || 0) | Headers_1.GP_FLAG.ENCRYPTED;
+            entry.isEncrypted = true;
+        }
+        // Compress data based on method
+        let compressedData;
+        const methodName = compressionMethod === Headers_1.CMP_METHOD.ZSTD ? 'ZSTD' : compressionMethod === Headers_1.CMP_METHOD.DEFLATED ? 'DEFLATED' : 'STORED';
+        if (compressionMethod === Headers_1.CMP_METHOD.STORED) {
+            compressedData = data;
+        }
+        else {
+            this.log(`Processing sequence for ${methodName}: [HASH] -> [COMPRESS] -> [OUTPUT]`);
+            this.log(`Compressing: method=${methodName}, input=${totalSize} bytes, buffer size=${bufferSize} bytes`);
+            this.log(`Calculating hashes: CRC32=${!entry.crc || entry.crc === 0}, SHA256=${options?.useSHA256}`);
+            if (compressionMethod === Headers_1.CMP_METHOD.ZSTD) {
+                compressedData = await this.zstdCompress(data, options, bufferSize, entry, onOutputBuffer);
+            }
+            else {
+                compressedData = await this.deflateCompress(data, options, bufferSize, entry, onOutputBuffer);
+            }
+        }
+        // Encrypt compressed data if password provided
+        if (options?.password) {
+            compressedData = this.encryptCompressedData(entry, compressedData, options.password);
+        }
+        entry.compressedSize = compressedData.length;
+        return compressedData;
+    }
+    /**
+     * Compress data using deflate algorithm with chunked processing
+     * @param data - Data to compress (Buffer or chunked reader)
+     * @param options - Compression options
+     * @param bufferSize - Buffer size for chunked processing
+     * @param entry - ZIP entry being compressed
+     * @param onOutputBuffer - Optional callback for streaming output
+     * @returns Buffer containing compressed data
+     */
+    async deflateCompress(data, options, bufferSize, entry, onOutputBuffer) {
+        this.log(`deflateCompress() called - entry: ${entry?.filename ?? 'unknown'}, bufferSize: ${bufferSize}, level: ${options?.level ?? 6}`);
+        const effectiveBufferSize = bufferSize || this.zipkit.getBufferSize();
+        const level = options?.level ?? 6;
+        // Handle chunked reader
+        if (typeof data === 'object' && 'totalSize' in data && 'onReadChunk' in data) {
+            // Chunked reader mode - not implemented in simplified version
+            throw new Error('Chunked reader mode not supported in ZipCompress');
+        }
+        // For small data, use synchronous deflate
+        if (data.length <= effectiveBufferSize) {
+            return this.deflate(data, options);
+        }
+        // For large data, use chunked deflate
+        const deflator = new pako.Deflate({ level, raw: true });
+        const compressedChunks = [];
+        let totalProcessed = 0;
+        let totalCompressedSize = 0;
+        try {
+            // Process data in chunks
+            for (let offset = 0; offset < data.length; offset += effectiveBufferSize) {
+                const chunk = data.slice(offset, offset + effectiveBufferSize);
+                const isLast = offset + effectiveBufferSize >= data.length;
+                deflator.push(chunk, isLast);
+                // Collect compressed chunks
+                if (deflator.result && deflator.result.length > 0) {
+                    const compressedChunk = Buffer.from(deflator.result);
+                    compressedChunks.push(compressedChunk);
+                    totalCompressedSize += compressedChunk.length;
+                    // Stream output if callback provided
+                    if (onOutputBuffer) {
+                        await onOutputBuffer(compressedChunk);
+                    }
+                }
+                totalProcessed += chunk.length;
+            }
+            // Calculate compression ratio
+            const ratio = totalProcessed > 0 ? Math.round((totalCompressedSize / totalProcessed) * 100) : 0;
+            this.log(`Final hashes: CRC32=0x${entry?.crc?.toString(16).padStart(8, '0')}, SHA256=${entry?.sha256 || 'N/A'}`);
+            this.log(`Deflate compression complete: ${totalCompressedSize} bytes from ${totalProcessed} bytes (ratio=${ratio}%)`);
+            return Buffer.concat(compressedChunks);
+        }
+        catch (e) {
+            throw new Error(`Deflate compression failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    /**
+     * Compress data using deflate algorithm (synchronous, small buffers only)
+     * @param inbuf - Buffer containing data to compress
+     * @param options - Compression options
+     * @returns Buffer containing compressed data
+     */
+    deflate(inbuf, options) {
+        this.log(`deflate() called with buffer size: ${inbuf.length}, level: ${options?.level ?? 6}`);
+        const level = options?.level ?? 6;
+        const result = pako.deflateRaw(inbuf, { level });
+        const ratio = inbuf.length > 0 ? Math.round((result.length / inbuf.length) * 100) : 0;
+        this.log(`Deflate compression complete: ${result.length} bytes from ${inbuf.length} bytes (ratio=${ratio}%)`);
+        return Buffer.from(result.buffer, result.byteOffset, result.byteLength);
+    }
+    /**
+     * Compress data using Zstandard (zstd) algorithm
+     * @param input - Input data to compress (Buffer or chunked reader)
+     * @param options - Compression options
+     * @param bufferSize - Buffer size for chunked processing
+     * @param entry - ZIP entry being compressed
+     * @param onOutputBuffer - Optional callback for streaming output
+     * @returns Buffer containing compressed data
+     */
+    async zstdCompress(input, options, bufferSize, entry, onOutputBuffer) {
+        this.log(`zstdCompress() called - entry: ${entry?.filename ?? 'unknown'}, bufferSize: ${bufferSize}, level: ${options?.level ?? 6}`);
+        const effectiveBufferSize = bufferSize || this.zipkit.getBufferSize();
+        const level = options?.level ?? 6;
+        // Handle chunked reader
+        if (typeof input === 'object' && 'totalSize' in input && 'readChunk' in input) {
+            // Chunked reader mode - not implemented in simplified version
+            throw new Error('Chunked reader mode not supported in ZipCompress');
+        }
+        // Validate input
+        if (!input || input.length === 0) {
+            throw new Error('ZSTD compression: empty input buffer');
+        }
+        // Convert Buffer to Uint8Array for WASM module
+        const inputArray = new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
+        // Use global ZstdManager for compression (handles queuing and initialization)
+        const compressed = await ZstdManager_1.ZstdManager.compress(inputArray, level);
+        const compressedBuffer = Buffer.from(compressed);
+        if (onOutputBuffer) {
+            await onOutputBuffer(compressedBuffer);
+        }
+        return compressedBuffer;
+    }
+    /**
+     * Encrypt compressed data using PKZIP encryption
+     * @param entry - ZIP entry to encrypt
+     * @param compressedData - Compressed data to encrypt
+     * @param password - Password for encryption
+     * @returns Buffer containing encrypted data (includes 12-byte header)
+     */
+    encryptCompressedData(entry, compressedData, password) {
+        this.log(`encryptCompressedData() called for entry: ${entry.filename}, compressed size: ${compressedData.length}`);
+        const zipCrypto = new ZipCrypto_1.ZipCrypto();
+        const encryptedData = zipCrypto.encryptBuffer(entry, compressedData, password);
+        this.log(`Encryption complete: ${compressedData.length} bytes compressed -> ${encryptedData.length} bytes encrypted (includes ${Headers_1.ENCRYPT_HDR_SIZE}-byte header)`);
+        return encryptedData;
+    }
+    /**
+     * Compress file data in memory and return ZIP entry information as Buffer
+     * @param entry - ZIP entry to compress
+     * @param fileData - File data buffer to compress
+     * @param cmpOptions - Compression options
+     * @returns Buffer containing local header + compressed data
+     */
+    async compressFileBuffer(entry, fileData, cmpOptions) {
+        this.log(`compressFileBuffer() called for entry: ${entry.filename}, size: ${fileData.length}`);
+        // Set uncompressed size
+        entry.uncompressedSize = fileData.length;
+        // Initialize hash calculator
+        const hashCalculator = new HashCalculator_1.HashCalculator({ useSHA256: cmpOptions?.useSHA256 || false });
+        hashCalculator.update(fileData);
+        // Set hashes
+        entry.crc = hashCalculator.finalizeCRC32();
+        if (cmpOptions?.useSHA256) {
+            entry.sha256 = hashCalculator.finalizeSHA256();
+            this.log(`SHA-256 calculated: ${entry.sha256}`);
+        }
+        // Compress data
+        const compressedData = await this.compressData(entry, fileData, cmpOptions);
+        // Encrypt if password provided
+        if (cmpOptions?.password) {
+            this.log(`Encrypting compressed data for entry: ${entry.filename}`);
+            entry.gpFlag = (entry.gpFlag || 0) | Headers_1.GP_FLAG.ENCRYPTED;
+            entry.isEncrypted = true;
+            const zipCrypto = new ZipCrypto_1.ZipCrypto();
+            const encryptedData = zipCrypto.encryptBuffer(entry, compressedData, cmpOptions.password);
+            return encryptedData;
+        }
+        return compressedData;
+    }
+}
+exports.ZipCompress = ZipCompress;
+// Class-level logging control - set to true to enable logging
+ZipCompress.loggingEnabled = false;
+//# sourceMappingURL=ZipCompress.js.map

package/dist/core/ZipCompress.js.map

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

package/dist/core/ZipCopy.d.ts

@@ -0,0 +1,175 @@
+import ZipEntry from './ZipEntry';
+import Zipkit from './Zipkit';
+/**
+ * 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;
+    /** Buffer containing the complete copied ZIP file */
+    zipBuffer: Buffer;
+}
+/**
+ * Result of copying only ZIP entry data (no central directory or EOCD).
+ * Use with writeCentralDirectoryAndEOCD after optionally appending more entry data
+ * to build a ZIP that includes both copied and new entries.
+ */
+export interface CopyEntriesOnlyResult {
+    /** Buffer containing only entry data (local headers + compressed data); not yet a valid ZIP */
+    entryDataBuffer: Buffer;
+    /** Offset at which entry data ends; central directory should start here after any new entries are appended (equals entryDataBuffer.length) */
+    dataEndOffset: number;
+    /** Copied entries with localHdrOffset set for the destination buffer */
+    copiedEntries: ZipEntry[];
+}
+/**
+ * Options for finalizing a ZIP (writing central directory and EOCD)
+ */
+export interface FinalizeZipOptions {
+    /** ZIP file comment (default: empty) */
+    zipComment?: string;
+    /** Offset at which the central directory will start in the final buffer (required for buffer-based finalization; e.g. entryDataBuffer.length) */
+    centralDirOffset?: number;
+}
+/**
+ * Efficient ZIP file copying class (Buffer-based)
+ *
+ * Uses ZipEntry instances directly to copy entries without decompression/recompression.
+ * Supports filtering and reordering entries while maintaining ZIP file validity.
+ * Works entirely with buffers for in-memory operations.
+ *
+ * Entry data and the central directory / EOCD are separated so you can append
+ * more entry data before finalizing: use copyZipEntriesOnly, append new entry
+ * data to the buffer, then call writeCentralDirectoryAndEOCD with all entries
+ * and concatenate to form the final ZIP buffer.
+ *
+ * @example Full copy (one shot)
+ * ```typescript
+ * const zipCopy = new ZipCopy(zipkit);
+ * const result = await zipCopy.copyZipBuffer(sourceZipBuffer, {
+ *   entryFilter: (entry) => !entry.filename.startsWith('.'),
+ *   entrySorter: (a, b) => a.filename.localeCompare(b.filename)
+ * });
+ * // result.zipBuffer contains the complete copied ZIP file
+ * ```
+ *
+ * @example Copy then append entries before finalizing
+ * ```typescript
+ * const { entryDataBuffer, dataEndOffset, copiedEntries } = await zipCopy.copyZipEntriesOnly(sourceZipBuffer);
+ * // ... append new entry data (local header + data), collect new ZipEntry[] with localHdrOffset set ...
+ * const allEntryData = Buffer.concat([entryDataBuffer, newEntryDataBuffer]);
+ * const allEntries = [...copiedEntries, ...newEntries];
+ * const centralAndEocd = zipCopy.writeCentralDirectoryAndEOCD(allEntries, {
+ *   zipComment: '',
+ *   centralDirOffset: allEntryData.length
+ * });
+ * const zipBuffer = Buffer.concat([allEntryData, centralAndEocd]);
+ * ```
+ */
+export declare class ZipCopy {
+    private zipkit;
+    /**
+     * Creates a new ZipCopy instance
+     * @param zipkit - Zipkit instance to use for ZIP operations
+     */
+    constructor(zipkit: Zipkit);
+    /**
+     * Calculate local header size by reading from buffer
+     *
+     * 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 sourceBuffer - Buffer containing the source ZIP file
+     * @param entry - ZipEntry with localHdrOffset
+     * @returns Size of the local header in bytes
+     */
+    private calculateLocalHeaderSize;
+    /**
+     * Copy entry bytes directly from source buffer
+     *
+     * 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 sourceBuffer - Buffer containing the source ZIP file
+     * @param entry - ZipEntry with source offset information
+     * @returns Buffer containing the copied entry (local header + compressed data + data descriptor if present)
+     */
+    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 buffer.
+     *
+     * @param entry - Source ZipEntry to clone
+     * @param newLocalHdrOffset - New local header offset for the destination
+     * @returns New ZipEntry instance with updated offset
+     */
+    private cloneEntryWithOffset;
+    /**
+     * Build central directory and End of Central Directory buffer.
+     * Used internally by copyZipBuffer and by writeCentralDirectoryAndEOCD.
+     */
+    private buildCentralDirectoryAndEOCDBuffer;
+    /**
+     * Copy only ZIP entry data from the source buffer (no central directory or EOCD).
+     * Use when you want to append more entry data before finalizing. Then call
+     * writeCentralDirectoryAndEOCD with all entries (copied + new) and concatenate
+     * to form the final ZIP buffer.
+     *
+     * @param sourceZipBuffer - Buffer containing the source ZIP file
+     * @param options - Optional copy options (filtering, sorting)
+     * @returns Result with entryDataBuffer and copiedEntries for use when appending and finalizing
+     */
+    copyZipEntriesOnly(sourceZipBuffer: Buffer, options?: CopyOptions): Promise<CopyEntriesOnlyResult>;
+    /**
+     * Build central directory and End of Central Directory buffer for the given entries.
+     * Concatenate this with entry data (e.g. from copyZipEntriesOnly + any appended entries)
+     * to form a valid ZIP buffer. When concatenating, pass centralDirOffset equal to the
+     * length of the entry data buffer that will precede this (so EOCD has the correct offset).
+     *
+     * @param entries - All entries in order (copied + any new), each with localHdrOffset set
+     * @param options - Optional finalize options (zipComment; centralDirOffset for correct EOCD when concatenating)
+     * @returns Buffer containing central directory + EOCD
+     */
+    writeCentralDirectoryAndEOCD(entries: ZipEntry[], options?: FinalizeZipOptions): Buffer;
+    /**
+     * Copy ZIP file entries efficiently from buffer to buffer
+     *
+     * Main method that copies entries from source ZIP buffer to destination ZIP buffer.
+     * Uses ZipEntry instances directly to avoid unnecessary parsing.
+     *
+     * @param sourceZipBuffer - Buffer containing the source ZIP file
+     * @param options - Optional copy options (filtering, sorting, etc.)
+     * @returns Copy result with entry information and the complete ZIP buffer
+     */
+    copyZipBuffer(sourceZipBuffer: Buffer, options?: CopyOptions): Promise<CopyResult>;
+}
+//# sourceMappingURL=ZipCopy.d.ts.map

package/dist/core/ZipCopy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZipCopy.d.ts","sourceRoot":"","sources":["../../src/core/ZipCopy.ts"],"names":[],"mappings":"AAUA,OAAO,QAAQ,MAAM,YAAY,CAAC;AAClC,OAAO,MAAM,MAAM,UAAU,CAAC;AAG9B;;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;IACrB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,+FAA+F;IAC/F,eAAe,EAAE,MAAM,CAAC;IACxB,8IAA8I;IAC9I,aAAa,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,aAAa,EAAE,QAAQ,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iJAAiJ;IACjJ,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAS;IAEvB;;;OAGG;gBACS,MAAM,EAAE,MAAM;IAI1B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,wBAAwB;IA0BhC;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,cAAc;IAuCtB;;;;;;;;;OASG;IACH,OAAO,CAAC,oBAAoB;IAoD5B;;;OAGG;IACH,OAAO,CAAC,kCAAkC;IAwC1C;;;;;;;;;OASG;IACG,kBAAkB,CACtB,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,qBAAqB,CAAC;IAqCjC;;;;;;;;;OASG;IACH,4BAA4B,CAC1B,OAAO,EAAE,QAAQ,EAAE,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,MAAM;IAeT;;;;;;;;;OASG;IACG,aAAa,CACjB,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC;CA6BvB"}