neozipkit 0.2.1 → 0.3.0

package/dist/core/ZipDecompress.js

@@ -0,0 +1,172 @@
+"use strict";
+// ======================================
+//	ZipDecompress.ts - Decompression 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.
+//
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const pako = require('pako');
+const zstd_js_1 = require("@oneidentity/zstd-js");
+const Logger_1 = require("./components/Logger");
+const Errors_1 = __importDefault(require("./constants/Errors"));
+const Headers_1 = require("./constants/Headers");
+const ZipCrypto_1 = require("./encryption/ZipCrypto");
+// Module-level singleton for ZSTD (shared across all instances)
+let zstdCodec = null;
+// Async initialization function for zstd
+async function initZstd() {
+    if (!zstdCodec) {
+        zstdCodec = await (0, zstd_js_1.ZstdInit)();
+    }
+    return zstdCodec;
+}
+/**
+ * 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.
+ */
+class ZipDecompress {
+    /**
+     * Internal logging method - only logs if class logging is enabled
+     */
+    log(...args) {
+        if (ZipDecompress.loggingEnabled) {
+            Logger_1.Logger.debug(`[ZipDecompress]`, ...args);
+        }
+    }
+    constructor(zipkit) {
+        this.zstdCodec = null;
+        this.zipkit = zipkit;
+        // Debug disabled by default
+        this.debug = false;
+        // If logging is enabled, ensure Logger level is set to debug
+        if (ZipDecompress.loggingEnabled) {
+            Logger_1.Logger.setLevel('debug');
+        }
+    }
+    /**
+     * 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
+     */
+    async extract(entry, skipHashCheck) {
+        if (!this.zipkit.hasInBuffer()) {
+            throw new Error('extract() requires Buffer-based ZIP. Use ZipkitNode.extractToFile() for file-based ZIP or call loadZip() first.');
+        }
+        this.log(`extract() called for entry: ${entry.filename}, method: ${entry.cmpMethod}, skipHashCheck: ${skipHashCheck}`);
+        // Lazy ZSTD initialization
+        if (entry.cmpMethod === Headers_1.CMP_METHOD.ZSTD && !this.zstdCodec) {
+            this.zstdCodec = await initZstd();
+        }
+        const buffer = this.zipkit.ensureBuffer();
+        // Decrypt if needed using password on zipkit instance
+        let fdata = this.zipkit.parseLocalHeader(entry, buffer);
+        if (entry.isEncrypted && this.zipkit?.password) {
+            this.log(`Starting in-memory decryption for entry: ${entry.filename}`);
+            // Use ZipCrypto's decryptBuffer method which handles all the header parsing and decryption
+            const zipCrypto = new ZipCrypto_1.ZipCrypto();
+            fdata = zipCrypto.decryptBuffer(entry, buffer, fdata, this.zipkit.password);
+            this.log(`Decryption successful, decrypted compressed data length: ${fdata.length}`);
+        }
+        if (fdata.length === 0) {
+            return null;
+        }
+        // Use the unCompress method
+        return this.unCompress(fdata, entry, skipHashCheck);
+    }
+    /**
+     * Inflate data using pako (internal use only)
+     */
+    inflate(data) {
+        this.log(`inflate() called with ${data.length} bytes`);
+        const result = pako.inflateRaw(data);
+        return Buffer.from(result.buffer, result.byteOffset, result.byteLength);
+    }
+    /**
+     * Synchronous zstd decompress method for in-memory mode
+     * ZSTD codec is guaranteed to be initialized via factory method
+     * Internal method only
+     */
+    zstdDecompressSync(data) {
+        this.log(`zstdDecompressSync() called with ${data.length} bytes`);
+        try {
+            // Ensure ZSTD is initialized
+            if (!this.zstdCodec) {
+                throw new Error('ZSTD codec not initialized.');
+            }
+            const decompressed = this.zstdCodec.ZstdSimple.decompress(data);
+            this.log(`ZSTD synchronous decompression successful: ${data.length} bytes -> ${decompressed.length} bytes`);
+            return Buffer.from(decompressed);
+        }
+        catch (error) {
+            this.log(`ZSTD synchronous decompression failed: ${error}`);
+            throw new Error(`ZSTD synchronous decompression failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Uncompress compressed data buffer (synchronous for in-memory mode)
+     * Handles decompression and hash verification
+     * Internal method only
+     */
+    unCompress(compressedData, entry, skipHashCheck) {
+        this.log(`unCompress() called for entry: ${entry.filename}, method: ${entry.cmpMethod}, data length: ${compressedData.length}`);
+        if (compressedData.length === 0) {
+            return Buffer.alloc(0);
+        }
+        let outBuf;
+        if (entry.cmpMethod === Headers_1.CMP_METHOD.STORED) {
+            outBuf = compressedData;
+        }
+        else if (entry.cmpMethod === Headers_1.CMP_METHOD.DEFLATED) {
+            // Use synchronous inflate for deflate
+            outBuf = this.inflate(compressedData);
+        }
+        else if (entry.cmpMethod === Headers_1.CMP_METHOD.ZSTD) {
+            // Use synchronous ZSTD decompression for in-memory mode
+            outBuf = this.zstdDecompressSync(compressedData);
+        }
+        else {
+            throw new Error(`Unsupported compression method: ${entry.cmpMethod}`);
+        }
+        // Verify hash
+        if (!skipHashCheck) {
+            if (entry.sha256) {
+                const isValid = this.zipkit.testSHA256(entry, outBuf);
+                if (!isValid) {
+                    throw new Error(Errors_1.default.INVALID_SHA256);
+                }
+            }
+            else {
+                const isValid = this.zipkit.testCRC32(entry, outBuf);
+                if (!isValid) {
+                    throw new Error(Errors_1.default.INVALID_CRC);
+                }
+            }
+        }
+        return outBuf;
+    }
+}
+// Class-level logging control - set to true to enable logging
+ZipDecompress.loggingEnabled = false;
+// Default export for internal use by Zipkit only
+exports.default = ZipDecompress;
+//# sourceMappingURL=ZipDecompress.js.map

package/dist/core/ZipDecompress.js.map

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

package/dist/{shared → core}/ZipEntry.d.ts

@@ -1,4 +1,4 @@
-import { ZipFileEntry, FileData } from './types';
+import { ZipFileEntry, FileData } from '../types';
 /**
  * Class representing a single entry (file or directory) within a ZIP archive
  */
@@ -34,6 +34,11 @@ export default class ZipEntry implements ZipFileEntry {
     uid: number | null;
     gid: number | null;
     sha256: string | null;
+    isSymlink: boolean;
+    linkTarget: string | null;
+    isHardLink: boolean;
+    originalEntry: string | null;
+    inode: number | null;
     fileData?: FileData;
     /**
      * Creates a new ZIP entry
@@ -129,3 +134,5 @@ export default class ZipEntry implements ZipFileEntry {
      */
     showVerboseInfo(): void;
 }
+export { ZipEntry };
+//# sourceMappingURL=ZipEntry.d.ts.map

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

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