@js-ak/excel-toolbox 1.2.5 → 1.2.7

package/README.md

@@ -39,11 +39,11 @@ fs.writeFileSync("output.xlsx", resultBuffer);
 - 🧩 **Merge sheets** from multiple Excel files
 - 🧼 **Clean sheet removal** — by name or index
 - 📎 **Keeps styles and merged cells**
-- 🪶 **Lightweight ZIP and XML handling**
+- 🍃 **Lightweight ZIP and XML handling**
 
 ## API
 
-### `mergeSheetsToBaseFileSync(options)`
+### `mergeSheetsToBaseFileSync(options): Buffer`
 
 #### Parameters
 

package/build/cjs/lib/merge-sheets-to-base-file-process.js

@@ -58,7 +58,7 @@ function mergeSheetsToBaseFileProcess(data) {
     if (!baseFiles[basePath]) {
         throw new Error(`Base file does not contain ${basePath}`);
     }
-    const { lastRowNumber, mergeCells: baseMergeCells, rows: baseRows, } = Xml.extractRowsFromSheet(baseFiles[basePath]);
+    const { lastRowNumber, mergeCells: baseMergeCells, rows: baseRows, xml, } = Xml.extractRowsFromSheet(baseFiles[basePath]);
     const allRows = [...baseRows];
     const allMergeCells = [...baseMergeCells];
     let currentRowOffset = lastRowNumber + gap;
@@ -84,19 +84,19 @@ function mergeSheetsToBaseFileProcess(data) {
             currentRowOffset += Utils.getMaxRowNumber(rows) + gap;
         }
     }
-    const mergedXml = Xml.buildMergedSheet(baseFiles[basePath], allRows, allMergeCells);
+    const mergedXml = Xml.buildMergedSheet(xml, allRows, allMergeCells);
     baseFiles[basePath] = mergedXml;
     for (const sheetIndex of sheetsToRemove) {
         const sheetPath = `xl/worksheets/sheet${sheetIndex}.xml`;
         delete baseFiles[sheetPath];
         if (baseFiles["xl/workbook.xml"]) {
-            baseFiles["xl/workbook.xml"] = Utils.removeSheetFromWorkbook(baseFiles["xl/workbook.xml"], sheetIndex);
+            baseFiles["xl/workbook.xml"] = Buffer.from(Utils.removeSheetFromWorkbook(baseFiles["xl/workbook.xml"].toString(), sheetIndex));
         }
         if (baseFiles["xl/_rels/workbook.xml.rels"]) {
-            baseFiles["xl/_rels/workbook.xml.rels"] = Utils.removeSheetFromRels(baseFiles["xl/_rels/workbook.xml.rels"], sheetIndex);
+            baseFiles["xl/_rels/workbook.xml.rels"] = Buffer.from(Utils.removeSheetFromRels(baseFiles["xl/_rels/workbook.xml.rels"].toString(), sheetIndex));
         }
         if (baseFiles["[Content_Types].xml"]) {
-            baseFiles["[Content_Types].xml"] = Utils.removeSheetFromContentTypes(baseFiles["[Content_Types].xml"], sheetIndex);
+            baseFiles["[Content_Types].xml"] = Buffer.from(Utils.removeSheetFromContentTypes(baseFiles["[Content_Types].xml"].toString(), sheetIndex));
         }
     }
     for (const sheetName of sheetNamesToRemove) {

package/build/cjs/lib/utils/remove-sheet-by-name.js

@@ -8,8 +8,8 @@ exports.removeSheetByName = removeSheetByName;
  * @returns {void}
  */
 function removeSheetByName(files, sheetName) {
-    const workbookXml = files["xl/workbook.xml"];
-    const relsXml = files["xl/_rels/workbook.xml.rels"];
+    const workbookXml = files["xl/workbook.xml"]?.toString();
+    const relsXml = files["xl/_rels/workbook.xml.rels"]?.toString();
     if (!workbookXml || !relsXml) {
         return;
     }
@@ -34,11 +34,13 @@ function removeSheetByName(files, sheetName) {
         return;
     }
     const targetPath = `xl/${targetMatch[1]}`.replace(/\\/g, "/");
-    delete files[targetPath];
-    files["xl/workbook.xml"] = workbookXml.replace(sheetTag, "");
-    files["xl/_rels/workbook.xml.rels"] = relsXml.replace(relTag, "");
-    const contentTypes = files["[Content_Types].xml"];
+    if (targetPath) {
+        delete files[targetPath];
+    }
+    files["xl/workbook.xml"] = Buffer.from(workbookXml.replace(sheetTag, ""));
+    files["xl/_rels/workbook.xml.rels"] = Buffer.from(relsXml.replace(relTag, ""));
+    const contentTypes = files["[Content_Types].xml"]?.toString();
     if (contentTypes) {
-        files["[Content_Types].xml"] = contentTypes.replace(new RegExp(`<Override[^>]+PartName=["']/${targetPath}["'][^>]*/>`, "g"), "");
+        files["[Content_Types].xml"] = Buffer.from(contentTypes.replace(new RegExp(`<Override[^>]+PartName=["']/${targetPath}["'][^>]*/>`, "g"), ""));
     }
 }

package/build/cjs/lib/xml/build-merged-sheet.js

@@ -12,7 +12,7 @@ exports.buildMergedSheet = buildMergedSheet;
  * @param {string[]} mergedRows - Array of XML strings representing each row in the merged sheet.
  * @param {Object[]} [mergeCells] - Optional array of merge cell definitions.
  *        Each object should have a 'ref' property specifying the merge range (e.g., "A1:B2").
- * @returns {string} - The reconstructed XML string with merged content.
+ * @returns {Buffer} - The reconstructed XML string with merged content.
  */
 function buildMergedSheet(originalXml, mergedRows, mergeCells = []) {
     // Remove any existing <mergeCells> section from the XML
@@ -27,5 +27,5 @@ function buildMergedSheet(originalXml, mergedRows, mergeCells = []) {
         // Insert <mergeCells> after </sheetData> and before the next XML tag
         xmlData = xmlData.replace(/(<\/sheetData>)(\s*<)/, `$1\n${mergeCellsXml}\n$2`);
     }
-    return xmlData;
+    return Buffer.from(xmlData);
 }

package/build/cjs/lib/xml/extract-rows-from-sheet.js

@@ -60,5 +60,6 @@ function extractRowsFromSheet(sheet) {
         lastRowNumber,
         mergeCells,
         rows,
+        xml,
     };
 }

package/build/cjs/lib/zip/create-sync.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createSync = createSync;
 const node_buffer_1 = require("node:buffer");
 const node_zlib_1 = require("node:zlib");
-const utils_js_1 = require("./utils.js");
+const index_js_1 = require("./utils/index.js");
 const constants_js_1 = require("./constants.js");
 /**
  * Creates a ZIP archive from a collection of files.
@@ -21,23 +21,23 @@ function createSync(files) {
         }
         const content = node_buffer_1.Buffer.isBuffer(rawContent) ? rawContent : node_buffer_1.Buffer.from(rawContent);
         const fileNameBuf = node_buffer_1.Buffer.from(filename, "utf8");
-        const modTime = (0, utils_js_1.dosTime)(new Date());
-        const crc = (0, utils_js_1.crc32)(content);
+        const modTime = (0, index_js_1.dosTime)(new Date());
+        const crc = (0, index_js_1.crc32)(content);
         const compressed = (0, node_zlib_1.deflateRawSync)(content);
         const compSize = compressed.length;
         const uncompSize = content.length;
         // Local file header
         const localHeader = node_buffer_1.Buffer.concat([
             constants_js_1.LOCAL_FILE_HEADER_SIG,
-            (0, utils_js_1.toBytes)(20, 2),
-            (0, utils_js_1.toBytes)(0, 2),
-            (0, utils_js_1.toBytes)(8, 2),
+            (0, index_js_1.toBytes)(20, 2),
+            (0, index_js_1.toBytes)(0, 2),
+            (0, index_js_1.toBytes)(8, 2),
             modTime,
-            (0, utils_js_1.toBytes)(crc, 4),
-            (0, utils_js_1.toBytes)(compSize, 4),
-            (0, utils_js_1.toBytes)(uncompSize, 4),
-            (0, utils_js_1.toBytes)(fileNameBuf.length, 2),
-            (0, utils_js_1.toBytes)(0, 2),
+            (0, index_js_1.toBytes)(crc, 4),
+            (0, index_js_1.toBytes)(compSize, 4),
+            (0, index_js_1.toBytes)(uncompSize, 4),
+            (0, index_js_1.toBytes)(fileNameBuf.length, 2),
+            (0, index_js_1.toBytes)(0, 2),
         ]);
         const localEntry = node_buffer_1.Buffer.concat([
             localHeader,
@@ -47,21 +47,21 @@ function createSync(files) {
         fileEntries.push(localEntry);
         const centralEntry = node_buffer_1.Buffer.concat([
             node_buffer_1.Buffer.from(constants_js_1.CENTRAL_DIR_HEADER_SIG),
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(20, 2)), // Version made by
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(20, 2)), // Version needed
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(0, 2)), // Flags
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(8, 2)), // Compression
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(20, 2)), // Version made by
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(20, 2)), // Version needed
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(0, 2)), // Flags
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(8, 2)), // Compression
             node_buffer_1.Buffer.from(modTime),
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(crc, 4)),
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(compSize, 4)),
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(uncompSize, 4)),
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(fileNameBuf.length, 2)),
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(0, 2)), // Extra field length
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(0, 2)), // Comment length
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(0, 2)), // Disk start
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(0, 2)), // Internal attrs
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(0, 4)), // External attrs
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(offset, 4)),
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(crc, 4)),
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(compSize, 4)),
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(uncompSize, 4)),
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(fileNameBuf.length, 2)),
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(0, 2)), // Extra field length
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(0, 2)), // Comment length
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(0, 2)), // Disk start
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(0, 2)), // Internal attrs
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(0, 4)), // External attrs
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(offset, 4)),
             fileNameBuf,
         ]);
         centralDirectory.push(centralEntry);
@@ -71,13 +71,13 @@ function createSync(files) {
     const centralDirOffset = offset;
     const endRecord = node_buffer_1.Buffer.concat([
         node_buffer_1.Buffer.from(constants_js_1.END_OF_CENTRAL_DIR_SIG),
-        node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(0, 2)), // Disk #
-        node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(0, 2)), // Start disk #
-        node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(centralDirectory.length, 2)),
-        node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(centralDirectory.length, 2)),
-        node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(centralDirSize, 4)),
-        node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(centralDirOffset, 4)),
-        node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(0, 2)), // Comment length
+        node_buffer_1.Buffer.from((0, index_js_1.toBytes)(0, 2)), // Disk #
+        node_buffer_1.Buffer.from((0, index_js_1.toBytes)(0, 2)), // Start disk #
+        node_buffer_1.Buffer.from((0, index_js_1.toBytes)(centralDirectory.length, 2)),
+        node_buffer_1.Buffer.from((0, index_js_1.toBytes)(centralDirectory.length, 2)),
+        node_buffer_1.Buffer.from((0, index_js_1.toBytes)(centralDirSize, 4)),
+        node_buffer_1.Buffer.from((0, index_js_1.toBytes)(centralDirOffset, 4)),
+        node_buffer_1.Buffer.from((0, index_js_1.toBytes)(0, 2)), // Comment length
     ]);
     return node_buffer_1.Buffer.concat(fileEntries.concat(centralDirectory).concat([endRecord]));
 }

package/build/cjs/lib/zip/create.js

@@ -8,7 +8,7 @@ const node_buffer_1 = require("node:buffer");
 const node_util_1 = __importDefault(require("node:util"));
 const node_zlib_1 = __importDefault(require("node:zlib"));
 const deflateRaw = node_util_1.default.promisify(node_zlib_1.default.deflateRaw);
-const utils_js_1 = require("./utils.js");
+const index_js_1 = require("./utils/index.js");
 const constants_js_1 = require("./constants.js");
 /**
  * Creates a ZIP archive from a collection of files.
@@ -26,23 +26,23 @@ async function create(files) {
         }
         const content = node_buffer_1.Buffer.isBuffer(rawContent) ? rawContent : node_buffer_1.Buffer.from(rawContent);
         const fileNameBuf = node_buffer_1.Buffer.from(filename, "utf8");
-        const modTime = (0, utils_js_1.dosTime)(new Date());
-        const crc = (0, utils_js_1.crc32)(content);
+        const modTime = (0, index_js_1.dosTime)(new Date());
+        const crc = (0, index_js_1.crc32)(content);
         const compressed = await deflateRaw(content);
         const compSize = compressed.length;
         const uncompSize = content.length;
         // Local file header
         const localHeader = node_buffer_1.Buffer.concat([
             constants_js_1.LOCAL_FILE_HEADER_SIG,
-            (0, utils_js_1.toBytes)(20, 2),
-            (0, utils_js_1.toBytes)(0, 2),
-            (0, utils_js_1.toBytes)(8, 2),
+            (0, index_js_1.toBytes)(20, 2),
+            (0, index_js_1.toBytes)(0, 2),
+            (0, index_js_1.toBytes)(8, 2),
             modTime,
-            (0, utils_js_1.toBytes)(crc, 4),
-            (0, utils_js_1.toBytes)(compSize, 4),
-            (0, utils_js_1.toBytes)(uncompSize, 4),
-            (0, utils_js_1.toBytes)(fileNameBuf.length, 2),
-            (0, utils_js_1.toBytes)(0, 2),
+            (0, index_js_1.toBytes)(crc, 4),
+            (0, index_js_1.toBytes)(compSize, 4),
+            (0, index_js_1.toBytes)(uncompSize, 4),
+            (0, index_js_1.toBytes)(fileNameBuf.length, 2),
+            (0, index_js_1.toBytes)(0, 2),
         ]);
         const localEntry = node_buffer_1.Buffer.concat([
             localHeader,
@@ -52,21 +52,21 @@ async function create(files) {
         fileEntries.push(localEntry);
         const centralEntry = node_buffer_1.Buffer.concat([
             node_buffer_1.Buffer.from(constants_js_1.CENTRAL_DIR_HEADER_SIG),
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(20, 2)), // Version made by
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(20, 2)), // Version needed
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(0, 2)), // Flags
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(8, 2)), // Compression
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(20, 2)), // Version made by
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(20, 2)), // Version needed
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(0, 2)), // Flags
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(8, 2)), // Compression
             node_buffer_1.Buffer.from(modTime),
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(crc, 4)),
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(compSize, 4)),
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(uncompSize, 4)),
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(fileNameBuf.length, 2)),
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(0, 2)), // Extra field length
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(0, 2)), // Comment length
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(0, 2)), // Disk start
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(0, 2)), // Internal attrs
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(0, 4)), // External attrs
-            node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(offset, 4)),
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(crc, 4)),
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(compSize, 4)),
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(uncompSize, 4)),
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(fileNameBuf.length, 2)),
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(0, 2)), // Extra field length
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(0, 2)), // Comment length
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(0, 2)), // Disk start
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(0, 2)), // Internal attrs
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(0, 4)), // External attrs
+            node_buffer_1.Buffer.from((0, index_js_1.toBytes)(offset, 4)),
             fileNameBuf,
         ]);
         centralDirectory.push(centralEntry);
@@ -76,13 +76,13 @@ async function create(files) {
     const centralDirOffset = offset;
     const endRecord = node_buffer_1.Buffer.concat([
         node_buffer_1.Buffer.from(constants_js_1.END_OF_CENTRAL_DIR_SIG),
-        node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(0, 2)), // Disk #
-        node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(0, 2)), // Start disk #
-        node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(centralDirectory.length, 2)),
-        node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(centralDirectory.length, 2)),
-        node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(centralDirSize, 4)),
-        node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(centralDirOffset, 4)),
-        node_buffer_1.Buffer.from((0, utils_js_1.toBytes)(0, 2)), // Comment length
+        node_buffer_1.Buffer.from((0, index_js_1.toBytes)(0, 2)), // Disk #
+        node_buffer_1.Buffer.from((0, index_js_1.toBytes)(0, 2)), // Start disk #
+        node_buffer_1.Buffer.from((0, index_js_1.toBytes)(centralDirectory.length, 2)),
+        node_buffer_1.Buffer.from((0, index_js_1.toBytes)(centralDirectory.length, 2)),
+        node_buffer_1.Buffer.from((0, index_js_1.toBytes)(centralDirSize, 4)),
+        node_buffer_1.Buffer.from((0, index_js_1.toBytes)(centralDirOffset, 4)),
+        node_buffer_1.Buffer.from((0, index_js_1.toBytes)(0, 2)), // Comment length
     ]);
     return node_buffer_1.Buffer.concat(fileEntries.concat(centralDirectory).concat([endRecord]));
 }

package/build/cjs/lib/zip/read-sync.js

@@ -1,48 +1,97 @@
 "use strict";
+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.readSync = readSync;
-const node_zlib_1 = require("node:zlib");
+const node_zlib_1 = __importDefault(require("node:zlib"));
+const Utils = __importStar(require("./utils/index.js"));
 /**
  * Parses a ZIP archive from a buffer and extracts the files within.
  *
  * @param {Buffer} buffer - The buffer containing the ZIP archive data.
- * @returns {Object.<string, string>} - An object where keys are file names and values are file contents.
+ * @returns {Object.<string, Buffer>} - An object where keys are file names and values are file contents as Buffers.
  * @throws {Error} - Throws an error if an unsupported compression method is encountered or if decompression fails.
  */
 function readSync(buffer) {
     const files = {};
     let offset = 0;
-    while (offset + 4 <= buffer.length) {
+    while (offset + 30 <= buffer.length) {
         const signature = buffer.readUInt32LE(offset);
         if (signature !== 0x04034b50)
-            break;
+            break; // not a local file header
+        const generalPurposeBitFlag = buffer.readUInt16LE(offset + 6);
         const compressionMethod = buffer.readUInt16LE(offset + 8);
         const fileNameLength = buffer.readUInt16LE(offset + 26);
-        const extraLength = buffer.readUInt16LE(offset + 28);
+        const extraFieldLength = buffer.readUInt16LE(offset + 28);
         const fileNameStart = offset + 30;
         const fileNameEnd = fileNameStart + fileNameLength;
         const fileName = buffer.subarray(fileNameStart, fileNameEnd).toString();
-        const dataStart = fileNameEnd + extraLength;
-        let nextOffset = dataStart;
-        while (nextOffset + 4 <= buffer.length) {
-            if (buffer.readUInt32LE(nextOffset) === 0x04034b50)
-                break;
-            nextOffset++;
-        }
-        if (nextOffset + 4 > buffer.length) {
-            nextOffset = buffer.length;
-        }
-        const compressedData = buffer.subarray(dataStart, nextOffset);
-        let content = "";
+        const dataStart = fileNameEnd + extraFieldLength;
+        const useDataDescriptor = (generalPurposeBitFlag & 0x08) !== 0;
+        let compressedData;
+        let content;
         try {
-            if (compressionMethod === 0) {
-                content = compressedData.toString();
-            }
-            else if (compressionMethod === 8) {
-                content = (0, node_zlib_1.inflateRawSync)(new Uint8Array(compressedData)).toString();
+            if (useDataDescriptor) {
+                const { compressedSize, offset: ddOffset } = Utils.findDataDescriptor(buffer, dataStart);
+                compressedData = buffer.subarray(dataStart, dataStart + compressedSize);
+                if (compressionMethod === 0) {
+                    content = compressedData;
+                }
+                else if (compressionMethod === 8) {
+                    content = node_zlib_1.default.inflateRawSync(compressedData);
+                }
+                else {
+                    throw new Error(`Unsupported compression method ${compressionMethod}`);
+                }
+                offset = ddOffset + 16; // Skip over data descriptor
             }
             else {
-                throw new Error(`Unsupported compression method ${compressionMethod}`);
+                const compressedSize = buffer.readUInt32LE(offset + 18);
+                compressedData = buffer.subarray(dataStart, dataStart + compressedSize);
+                if (compressionMethod === 0) {
+                    content = compressedData;
+                }
+                else if (compressionMethod === 8) {
+                    content = node_zlib_1.default.inflateRawSync(compressedData);
+                }
+                else {
+                    throw new Error(`Unsupported compression method ${compressionMethod}`);
+                }
+                offset = dataStart + compressedSize;
             }
         }
         catch (error) {
@@ -50,7 +99,6 @@ function readSync(buffer) {
             throw new Error(`Error unpacking file ${fileName}: ${message}`);
         }
         files[fileName] = content;
-        offset = nextOffset;
     }
     return files;
 }

package/build/cjs/lib/zip/read.js

@@ -1,4 +1,37 @@
 "use strict";
+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 };
 };
@@ -6,48 +39,61 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.read = read;
 const node_util_1 = __importDefault(require("node:util"));
 const node_zlib_1 = __importDefault(require("node:zlib"));
+const Utils = __importStar(require("./utils/index.js"));
 const inflateRaw = node_util_1.default.promisify(node_zlib_1.default.inflateRaw);
 /**
  * Parses a ZIP archive from a buffer and extracts the files within.
  *
  * @param {Buffer} buffer - The buffer containing the ZIP archive data.
- * @returns {Object.<string, string>} - An object where keys are file names and values are file contents.
+ * @returns {Object.<string, Buffer>} - An object where keys are file names and values are file contents as Buffers.
  * @throws {Error} - Throws an error if an unsupported compression method is encountered or if decompression fails.
  */
 async function read(buffer) {
     const files = {};
     let offset = 0;
-    while (offset + 4 <= buffer.length) {
+    while (offset + 30 <= buffer.length) {
         const signature = buffer.readUInt32LE(offset);
         if (signature !== 0x04034b50)
-            break;
+            break; // not a local file header
+        const generalPurposeBitFlag = buffer.readUInt16LE(offset + 6);
         const compressionMethod = buffer.readUInt16LE(offset + 8);
         const fileNameLength = buffer.readUInt16LE(offset + 26);
-        const extraLength = buffer.readUInt16LE(offset + 28);
+        const extraFieldLength = buffer.readUInt16LE(offset + 28);
         const fileNameStart = offset + 30;
         const fileNameEnd = fileNameStart + fileNameLength;
         const fileName = buffer.subarray(fileNameStart, fileNameEnd).toString();
-        const dataStart = fileNameEnd + extraLength;
-        let nextOffset = dataStart;
-        while (nextOffset + 4 <= buffer.length) {
-            if (buffer.readUInt32LE(nextOffset) === 0x04034b50)
-                break;
-            nextOffset++;
-        }
-        if (nextOffset + 4 > buffer.length) {
-            nextOffset = buffer.length;
-        }
-        const compressedData = buffer.subarray(dataStart, nextOffset);
-        let content = "";
+        const dataStart = fileNameEnd + extraFieldLength;
+        const useDataDescriptor = (generalPurposeBitFlag & 0x08) !== 0;
+        let compressedData;
+        let content;
         try {
-            if (compressionMethod === 0) {
-                content = compressedData.toString();
-            }
-            else if (compressionMethod === 8) {
-                content = (await inflateRaw(new Uint8Array(compressedData))).toString();
+            if (useDataDescriptor) {
+                const { compressedSize, offset: ddOffset } = Utils.findDataDescriptor(buffer, dataStart);
+                compressedData = buffer.subarray(dataStart, dataStart + compressedSize);
+                if (compressionMethod === 0) {
+                    content = compressedData;
+                }
+                else if (compressionMethod === 8) {
+                    content = await inflateRaw(compressedData);
+                }
+                else {
+                    throw new Error(`Unsupported compression method ${compressionMethod}`);
+                }
+                offset = ddOffset + 16; // Skip over data descriptor
             }
             else {
-                throw new Error(`Unsupported compression method ${compressionMethod}`);
+                const compressedSize = buffer.readUInt32LE(offset + 18);
+                compressedData = buffer.subarray(dataStart, dataStart + compressedSize);
+                if (compressionMethod === 0) {
+                    content = compressedData;
+                }
+                else if (compressionMethod === 8) {
+                    content = await inflateRaw(compressedData);
+                }
+                else {
+                    throw new Error(`Unsupported compression method ${compressionMethod}`);
+                }
+                offset = dataStart + compressedSize;
             }
         }
         catch (error) {
@@ -55,7 +101,6 @@ async function read(buffer) {
             throw new Error(`Error unpacking file ${fileName}: ${message}`);
         }
         files[fileName] = content;
-        offset = nextOffset;
     }
     return files;
 }

package/build/cjs/lib/zip/utils/crc-32.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.crc32 = crc32;
+/**
+ * Precomputed CRC-32 lookup table for optimized checksum calculation.
+ * The table is generated using the standard IEEE 802.3 (Ethernet) polynomial:
+ * 0xEDB88320 (reversed representation of 0x04C11DB7).
+ *
+ * The table is immediately invoked and cached as a constant for performance,
+ * following the common implementation pattern for CRC algorithms.
+ */
+const crcTable = (() => {
+    // Create a typed array for better performance with 256 32-bit unsigned integers
+    const table = new Uint32Array(256);
+    // Generate table entries for all possible byte values (0-255)
+    for (let i = 0; i < 256; i++) {
+        let crc = i; // Initialize with current byte value
+        // Process each bit (8 times)
+        for (let j = 0; j < 8; j++) {
+            /*
+             * CRC division algorithm:
+             * 1. If LSB is set (crc & 1), XOR with polynomial
+             * 2. Right-shift by 1 (unsigned)
+             *
+             * The polynomial 0xEDB88320 is:
+             * - Bit-reversed version of 0x04C11DB7
+             * - Uses reflected input/output algorithm
+             */
+            crc = crc & 1
+                ? 0xedb88320 ^ (crc >>> 1) // XOR with polynomial if LSB is set
+                : crc >>> 1; // Just shift right if LSB is not set
+        }
+        // Store final 32-bit value (>>> 0 ensures unsigned 32-bit representation)
+        table[i] = crc >>> 0;
+    }
+    return table;
+})();
+/**
+ * Computes a CRC-32 checksum for the given Buffer using the standard IEEE 802.3 polynomial.
+ * This implementation uses a precomputed lookup table for optimal performance.
+ *
+ * The algorithm follows these characteristics:
+ * - Polynomial: 0xEDB88320 (reversed representation of 0x04C11DB7)
+ * - Initial value: 0xFFFFFFFF (inverted by ~0)
+ * - Final XOR value: 0xFFFFFFFF (achieved by inverting the result)
+ * - Input and output reflection: Yes
+ *
+ * @param {Buffer} buf - The input buffer to calculate checksum for
+ * @returns {number} - The 32-bit unsigned CRC-32 checksum (0x00000000 to 0xFFFFFFFF)
+ */
+function crc32(buf) {
+    // Initialize CRC with all 1's (0xFFFFFFFF) using bitwise NOT
+    let crc = ~0;
+    // Process each byte in the buffer
+    for (let i = 0; i < buf.length; i++) {
+        /*
+         * CRC update algorithm steps:
+         * 1. XOR current CRC with next byte (lowest 8 bits)
+         * 2. Use result as index in precomputed table (0-255)
+         * 3. XOR the table value with right-shifted CRC (8 bits)
+         *
+         * The operation breakdown:
+         * - (crc ^ buf[i]) - XOR with next byte
+         * - & 0xff - Isolate lowest 8 bits
+         * - crc >>> 8 - Shift CRC right by 8 bits (unsigned)
+         * - ^ crcTable[...] - XOR with precomputed table value
+         */
+        crc = (crc >>> 8) ^ crcTable[(crc ^ buf[i]) & 0xff];
+    }
+    /*
+     * Final processing:
+     * 1. Invert all bits (~crc) to match standard CRC-32 output
+     * 2. Convert to unsigned 32-bit integer (>>> 0)
+     */
+    return ~crc >>> 0;
+}