neozipkit 0.2.1 → 0.3.0

package/dist/browser.d.ts

@@ -1,18 +1,12 @@
-import ZipKit from './shared/ZipKit';
-export { ZipEntry, Errors, CMP_METHOD, TIMESTAMP_METADATA, TIMESTAMP_SUBMITTED } from './shared/ZipKit';
-export type { CompressOptions } from './shared/ZipKit';
-export * from './shared/ZipKit';
-export * from './shared/ZipEntry';
-export default ZipKit;
-export { default as ZipKitBrowser } from './browser/ZipKitBrowser';
-export { default as HashAccumulator } from './shared/components/HashAccumulator';
-export * from './shared/components/Util';
-export * from './shared/components/Support';
-export * from './shared/types';
-export * from './shared/constants/Headers';
-export * from './shared/constants/Errors';
-export * from './shared/version';
+export * from "./core";
+import Zipkit from "./core";
+export default Zipkit;
+export { default as ZipkitBrowser } from "./browser/ZipkitBrowser";
+export { TokenMetadata } from "./types";
+export * from "./blockchain/browser/index";
+export { createTokenVerifier } from "./blockchain/browser/index";
 export declare const PlatformUtils: {
     isBrowser: boolean;
     isNode: string | false;
 };
+//# sourceMappingURL=index.d.ts.map

package/dist/browser.js

@@ -1,6 +1,6 @@
 "use strict";
 // =============================================================================
-// NeoZipKit - Browser-Only Package Exports  
+// NeoZipkit - Browser-Only Package Exports  
 // =============================================================================
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -20,34 +20,18 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PlatformUtils = exports.HashAccumulator = exports.ZipKitBrowser = exports.TIMESTAMP_SUBMITTED = exports.TIMESTAMP_METADATA = exports.CMP_METHOD = exports.Errors = exports.ZipEntry = void 0;
-// Core shared exports
-const ZipKit_1 = __importDefault(require("./shared/ZipKit"));
-var ZipKit_2 = require("./shared/ZipKit");
-Object.defineProperty(exports, "ZipEntry", { enumerable: true, get: function () { return ZipKit_2.ZipEntry; } });
-Object.defineProperty(exports, "Errors", { enumerable: true, get: function () { return ZipKit_2.Errors; } });
-Object.defineProperty(exports, "CMP_METHOD", { enumerable: true, get: function () { return ZipKit_2.CMP_METHOD; } });
-Object.defineProperty(exports, "TIMESTAMP_METADATA", { enumerable: true, get: function () { return ZipKit_2.TIMESTAMP_METADATA; } });
-Object.defineProperty(exports, "TIMESTAMP_SUBMITTED", { enumerable: true, get: function () { return ZipKit_2.TIMESTAMP_SUBMITTED; } });
-__exportStar(require("./shared/ZipKit"), exports);
-__exportStar(require("./shared/ZipEntry"), exports);
-exports.default = ZipKit_1.default;
+exports.PlatformUtils = exports.createTokenVerifier = 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; } });
-// export { CertificateGeneratorBrowser } from './browser/CertificateGeneratorBrowser';
-// export { TokenVerificationResult, checkForTokenization as checkForTokenizationBrowser, NZipTokenInfo } from './browser/TokenVerifierBrowser';
-// export type { TokenVerificationOptions } from './browser/TokenVerifierBrowser';
-// Shared component exports
-var HashAccumulator_1 = require("./shared/components/HashAccumulator");
-Object.defineProperty(exports, "HashAccumulator", { enumerable: true, get: function () { return __importDefault(HashAccumulator_1).default; } });
-__exportStar(require("./shared/components/Util"), exports);
-__exportStar(require("./shared/components/Support"), exports);
-// Type and constant exports
-__exportStar(require("./shared/types"), exports);
-__exportStar(require("./shared/constants/Headers"), exports);
-__exportStar(require("./shared/constants/Errors"), exports);
-__exportStar(require("./shared/version"), exports);
+var ZipkitBrowser_1 = require("./browser/ZipkitBrowser");
+Object.defineProperty(exports, "ZipkitBrowser", { enumerable: true, get: function () { return __importDefault(ZipkitBrowser_1).default; } });
+// Blockchain exports for browser
+__exportStar(require("./blockchain/browser/index"), exports);
+var browser_1 = require("./blockchain/browser/index");
+Object.defineProperty(exports, "createTokenVerifier", { enumerable: true, get: function () { return browser_1.createTokenVerifier; } });
 // Platform-specific conditional exports
 exports.PlatformUtils = {
     // Browser detection
@@ -55,3 +39,4 @@ exports.PlatformUtils = {
     // 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;AAiBlC;;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;IAgDlB;;;;;;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,309 @@
+"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 zstd_js_1 = require("@oneidentity/zstd-js");
+const Logger_1 = require("./components/Logger");
+const Headers_1 = require("./constants/Headers");
+const HashCalculator_1 = require("./components/HashCalculator");
+const ZipCrypto_1 = require("./encryption/ZipCrypto");
+// We'll initialize zstd when needed
+let zstdCodec = null;
+// Async initialization function for zstd
+async function initZstd() {
+    if (!zstdCodec) {
+        zstdCodec = await (0, zstd_js_1.ZstdInit)();
+    }
+    return zstdCodec;
+}
+/**
+ * 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');
+        }
+        // Lazy ZSTD initialization
+        const zstdCodec = await initZstd();
+        // Validate input
+        if (!input || input.length === 0) {
+            throw new Error('ZSTD compression: empty input buffer');
+        }
+        // Convert Buffer to Uint8Array for WASM module (same fix as decompression)
+        const inputArray = new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
+        // For small data, compress in one go
+        if (input.length <= effectiveBufferSize) {
+            const compressed = zstdCodec.ZstdSimple.compress(inputArray, level);
+            const compressedBuffer = Buffer.from(compressed);
+            if (onOutputBuffer) {
+                await onOutputBuffer(compressedBuffer);
+            }
+            return compressedBuffer;
+        }
+        // For large data, compress in chunks (ZSTD supports streaming)
+        // Note: ZSTD streaming compression is more complex, so for now we compress the whole buffer
+        // This could be optimized in the future for true streaming
+        const compressed = zstdCodec.ZstdSimple.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/ZipDecompress.d.ts

@@ -0,0 +1,58 @@
+import Zipkit from './Zipkit';
+import ZipEntry from './ZipEntry';
+export interface DecompressionResult {
+    success: boolean;
+    data?: Buffer;
+    error?: string;
+}
+export interface DecompressionOptions {
+    method: number;
+    debug?: boolean;
+}
+/**
+ * ZipDecompress - Unified Decompression Module (Internal to Zipkit)
+ * Consolidates decompression functionality from ZipCompress
+ * Supports deflate, zstd, and stored compression methods with chunked processing
+ *
+ * This class is internal to Zipkit and should not be used directly.
+ * Use Zipkit methods instead.
+ */
+declare class ZipDecompress {
+    private zipkit;
+    private debug;
+    private zstdCodec;
+    private static loggingEnabled;
+    /**
+     * Internal logging method - only logs if class logging is enabled
+     */
+    private log;
+    constructor(zipkit: Zipkit);
+    /**
+     * Extract file data (Buffer-based ZIP only)
+     * Public method that validates buffer mode and extracts entry
+     *
+     * @param entry ZIP entry to extract
+     * @param skipHashCheck Skip hash verification (CRC-32 or SHA-256)
+     * @returns Promise resolving to extracted data as Buffer, or null if failed
+     * @throws Error if not a Buffer-based ZIP
+     */
+    extract(entry: ZipEntry, skipHashCheck?: boolean): Promise<Buffer | null>;
+    /**
+     * Inflate data using pako (internal use only)
+     */
+    private inflate;
+    /**
+     * Synchronous zstd decompress method for in-memory mode
+     * ZSTD codec is guaranteed to be initialized via factory method
+     * Internal method only
+     */
+    private zstdDecompressSync;
+    /**
+     * Uncompress compressed data buffer (synchronous for in-memory mode)
+     * Handles decompression and hash verification
+     * Internal method only
+     */
+    private unCompress;
+}
+export default ZipDecompress;
+//# sourceMappingURL=ZipDecompress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ZipDecompress.d.ts","sourceRoot":"","sources":["../../src/core/ZipDecompress.ts"],"names":[],"mappings":"AAiBA,OAAO,MAAM,MAAM,UAAU,CAAC;AAE9B,OAAO,QAAQ,MAAM,YAAY,CAAC;AAKlC,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAaD;;;;;;;GAOG;AACH,cAAM,aAAa;IACjB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,SAAS,CAAkD;IAGnE,OAAO,CAAC,MAAM,CAAC,cAAc,CAAkB;IAE/C;;OAEG;IACH,OAAO,CAAC,GAAG;gBAMC,MAAM,EAAE,MAAM;IAU1B;;;;;;;;OAQG;IACG,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAsC/E;;OAEG;IACH,OAAO,CAAC,OAAO;IAOf;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;;;OAIG;IACH,OAAO,CAAC,UAAU;CA2CnB;AAGD,eAAe,aAAa,CAAC"}