typesexcel 1.0.1

package/dist/zipUtils.js

@@ -0,0 +1,140 @@
+/*******************************************************************************
+ * Copyright (c) 2026 Maxprograms.
+ *
+ * This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License 1.0
+ * which accompanies this distribution, and is available at
+ * https://www.eclipse.org/org/documents/epl-v10.html
+ *
+ * Contributors:
+ *     Maxprograms - initial API and implementation
+ *******************************************************************************/
+import { deflateRawSync, inflateRawSync } from 'node:zlib';
+import { Crc32 } from './crc32.js';
+const LOCAL_FILE_HEADER_SIGNATURE = 0x04034b50;
+const CENTRAL_DIRECTORY_SIGNATURE = 0x02014b50;
+const END_OF_CENTRAL_DIRECTORY_SIGNATURE = 0x06054b50;
+const METHOD_STORED = 0;
+const METHOD_DEFLATE = 8;
+export class ZipUtils {
+    crc32;
+    constructor() {
+        this.crc32 = new Crc32();
+    }
+    readZip(buffer) {
+        let eocdOffset = this.findEndOfCentralDirectory(buffer);
+        let totalEntries = buffer.readUInt16LE(eocdOffset + 10);
+        let centralDirectoryOffset = buffer.readUInt32LE(eocdOffset + 16);
+        let entries = [];
+        let pointer = centralDirectoryOffset;
+        for (let i = 0; i < totalEntries; i++) {
+            if (buffer.readUInt32LE(pointer) !== CENTRAL_DIRECTORY_SIGNATURE) {
+                throw new Error('Corrupt zip entry: central directory signature mismatch');
+            }
+            let method = buffer.readUInt16LE(pointer + 10);
+            let compressedSize = buffer.readUInt32LE(pointer + 20);
+            let uncompressedSize = buffer.readUInt32LE(pointer + 24);
+            let nameLength = buffer.readUInt16LE(pointer + 28);
+            let extraLength = buffer.readUInt16LE(pointer + 30);
+            let commentLength = buffer.readUInt16LE(pointer + 32);
+            let localHeaderOffset = buffer.readUInt32LE(pointer + 42);
+            let name = buffer.toString('utf8', pointer + 46, pointer + 46 + nameLength);
+            entries.push({ name, method, compressedSize, uncompressedSize, localHeaderOffset });
+            pointer += 46 + nameLength + extraLength + commentLength;
+        }
+        let result = new Map();
+        for (let entry of entries) {
+            result.set(entry.name, this.extractEntry(buffer, entry));
+        }
+        return result;
+    }
+    writeZip(entries) {
+        let localParts = [];
+        let centralParts = [];
+        let offset = 0;
+        let { time, date } = this.dosDateTime(new Date());
+        for (let [name, data] of entries) {
+            let nameBuffer = Buffer.from(name, 'utf8');
+            let compressed = deflateRawSync(data);
+            let checksum = this.crc32.compute(data);
+            let localHeader = Buffer.alloc(30);
+            localHeader.writeUInt32LE(LOCAL_FILE_HEADER_SIGNATURE, 0);
+            localHeader.writeUInt16LE(20, 4);
+            localHeader.writeUInt16LE(0, 6);
+            localHeader.writeUInt16LE(METHOD_DEFLATE, 8);
+            localHeader.writeUInt16LE(time, 10);
+            localHeader.writeUInt16LE(date, 12);
+            localHeader.writeUInt32LE(checksum, 14);
+            localHeader.writeUInt32LE(compressed.length, 18);
+            localHeader.writeUInt32LE(data.length, 22);
+            localHeader.writeUInt16LE(nameBuffer.length, 26);
+            localHeader.writeUInt16LE(0, 28);
+            localParts.push(localHeader, nameBuffer, compressed);
+            let centralHeader = Buffer.alloc(46);
+            centralHeader.writeUInt32LE(CENTRAL_DIRECTORY_SIGNATURE, 0);
+            centralHeader.writeUInt16LE(20, 4);
+            centralHeader.writeUInt16LE(20, 6);
+            centralHeader.writeUInt16LE(0, 8);
+            centralHeader.writeUInt16LE(METHOD_DEFLATE, 10);
+            centralHeader.writeUInt16LE(time, 12);
+            centralHeader.writeUInt16LE(date, 14);
+            centralHeader.writeUInt32LE(checksum, 16);
+            centralHeader.writeUInt32LE(compressed.length, 20);
+            centralHeader.writeUInt32LE(data.length, 24);
+            centralHeader.writeUInt16LE(nameBuffer.length, 28);
+            centralHeader.writeUInt16LE(0, 30);
+            centralHeader.writeUInt16LE(0, 32);
+            centralHeader.writeUInt16LE(0, 34);
+            centralHeader.writeUInt16LE(0, 36);
+            centralHeader.writeUInt32LE(0, 38);
+            centralHeader.writeUInt32LE(offset, 42);
+            centralParts.push(centralHeader, nameBuffer);
+            offset += localHeader.length + nameBuffer.length + compressed.length;
+        }
+        let centralDirectory = Buffer.concat(centralParts);
+        let centralDirectoryOffset = offset;
+        let eocd = Buffer.alloc(22);
+        eocd.writeUInt32LE(END_OF_CENTRAL_DIRECTORY_SIGNATURE, 0);
+        eocd.writeUInt16LE(0, 4);
+        eocd.writeUInt16LE(0, 6);
+        eocd.writeUInt16LE(entries.size, 8);
+        eocd.writeUInt16LE(entries.size, 10);
+        eocd.writeUInt32LE(centralDirectory.length, 12);
+        eocd.writeUInt32LE(centralDirectoryOffset, 16);
+        eocd.writeUInt16LE(0, 20);
+        return Buffer.concat([...localParts, centralDirectory, eocd]);
+    }
+    extractEntry(buffer, entry) {
+        let offset = entry.localHeaderOffset;
+        if (buffer.readUInt32LE(offset) !== LOCAL_FILE_HEADER_SIGNATURE) {
+            throw new Error('Corrupt zip entry: local file header signature mismatch for ' + entry.name);
+        }
+        let nameLength = buffer.readUInt16LE(offset + 26);
+        let extraLength = buffer.readUInt16LE(offset + 28);
+        let dataStart = offset + 30 + nameLength + extraLength;
+        let compressed = buffer.subarray(dataStart, dataStart + entry.compressedSize);
+        if (entry.method === METHOD_STORED) {
+            return Buffer.from(compressed);
+        }
+        if (entry.method === METHOD_DEFLATE) {
+            return inflateRawSync(compressed);
+        }
+        throw new Error('Unsupported compression method (' + entry.method + ') for ' + entry.name);
+    }
+    findEndOfCentralDirectory(buffer) {
+        let minOffset = Math.max(0, buffer.length - 22 - 0xFFFF);
+        for (let offset = buffer.length - 22; offset >= minOffset; offset--) {
+            if (buffer.readUInt32LE(offset) === END_OF_CENTRAL_DIRECTORY_SIGNATURE) {
+                return offset;
+            }
+        }
+        throw new Error('Not a valid zip file: end of central directory record not found');
+    }
+    dosDateTime(value) {
+        let year = Math.max(1980, value.getFullYear());
+        let date = ((year - 1980) << 9) | ((value.getMonth() + 1) << 5) | value.getDate();
+        let time = (value.getHours() << 11) | (value.getMinutes() << 5) | Math.floor(value.getSeconds() / 2);
+        return { time, date };
+    }
+}
+//# sourceMappingURL=zipUtils.js.map

package/dist/zipUtils.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "typesexcel",
+  "productName": "TypesExcel",
+  "version": "1.0.1",
+  "description": "TypeScript library for reading and writing Excel (.xlsx) files",
+  "keywords": [
+    "Excel",
+    "XLSX",
+    "OOXML",
+    "spreadsheet",
+    "TypeScript",
+    "zip"
+  ],
+  "type": "module",
+  "scripts": {
+    "build": "tsc && node dist/copy-assets.js"
+  },
+  "author": {
+    "name": "Rodolfo M. Raya",
+    "url": "https://maxprograms.com",
+    "email": "rmraya@maxprograms.com"
+  },
+  "license": "EPL-1.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/maxprograms-com/TypesExcel.git"
+  },
+  "dependencies": {
+    "typesxml": "^2.2.1"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.2",
+    "typescript": "^6.0.3"
+  }
+}