@cj-tech-master/excelts 1.6.2 → 1.6.3-canary.20251224124621.73c5d94

package/dist/esm/stream/xlsx/workbook-writer.js

@@ -92,14 +92,14 @@ class WorkbookWriter {
         let buffer;
         if (base64) {
             // Use Buffer.from for efficient base64 decoding
-            const base64Data = typeof data === "string" ? data : data.toString();
+            const base64Data = typeof data === "string" ? data : new TextDecoder().decode(data);
             buffer = Buffer.from(base64Data, "base64");
         }
         else if (typeof data === "string") {
             buffer = Buffer.from(data, "utf8");
         }
         else {
-            buffer = new Uint8Array(data);
+            buffer = data;
         }
         zipFile.push(buffer, true); // true = final chunk
     }
@@ -119,15 +119,15 @@ class WorkbookWriter {
         // if there are any uncommitted worksheets, commit them now and wait
         const promises = this._worksheets.map(commitWorksheet);
         if (promises.length) {
-            return Promise.all(promises);
+            return Promise.all(promises).then(() => { });
         }
         return Promise.resolve();
     }
     async commit() {
-        // commit all worksheets, then add suplimentary files
+        // commit all worksheets, then add supplementary files
         await this.promise;
-        await this.addMedia();
         await this._commitWorksheets();
+        await this.addMedia();
         await Promise.all([
             this.addContentTypes(),
             this.addApp(),
@@ -149,28 +149,39 @@ class WorkbookWriter {
         }
         return this._worksheets.length || 1;
     }
+    /**
+     * Add Image to Workbook and return the id
+     */
     addImage(image) {
         const id = this.media.length;
-        const medium = Object.assign({}, image, {
+        const medium = {
+            ...image,
             type: "image",
             name: `image${id}.${image.extension}`
-        });
+        };
         this.media.push(medium);
         return id;
     }
+    /**
+     * Get image by id
+     */
     getImage(id) {
         return this.media[id];
     }
-    addWorksheet(name, options = {}) {
+    /**
+     * Add a new worksheet and return a reference to it
+     */
+    addWorksheet(name, options) {
         // it's possible to add a worksheet with different than default
         // shared string handling
         // in fact, it's even possible to switch it mid-sheet
-        const useSharedStrings = options.useSharedStrings !== undefined ? options.useSharedStrings : this.useSharedStrings;
-        if (options.tabColor) {
+        const opts = options || {};
+        const useSharedStrings = opts.useSharedStrings !== undefined ? opts.useSharedStrings : this.useSharedStrings;
+        if (opts.tabColor) {
             console.trace("tabColor option has moved to { properties: tabColor: {...} }");
-            options.properties = Object.assign({
-                tabColor: options.tabColor
-            }, options.properties);
+            opts.properties = Object.assign({
+                tabColor: opts.tabColor
+            }, opts.properties);
         }
         const id = this.nextId;
         name = name || `sheet${id}`;
@@ -179,16 +190,19 @@ class WorkbookWriter {
             name,
             workbook: this,
             useSharedStrings,
-            properties: options.properties,
-            state: options.state,
-            pageSetup: options.pageSetup,
-            views: options.views,
-            autoFilter: options.autoFilter,
-            headerFooter: options.headerFooter
+            properties: opts.properties,
+            state: opts.state,
+            pageSetup: opts.pageSetup,
+            views: opts.views,
+            autoFilter: opts.autoFilter,
+            headerFooter: opts.headerFooter
         });
         this._worksheets[id] = worksheet;
         return worksheet;
     }
+    /**
+     * Fetch sheet by name or id
+     */
     getWorksheet(id) {
         if (id === undefined) {
             return this._worksheets.find(() => true);
@@ -197,7 +211,7 @@ class WorkbookWriter {
             return this._worksheets[id];
         }
         if (typeof id === "string") {
-            return this._worksheets.find((worksheet) => worksheet && worksheet.name === id);
+            return this._worksheets.find(worksheet => worksheet && worksheet.name === id);
         }
         return undefined;
     }
@@ -250,7 +264,7 @@ class WorkbookWriter {
                                 reject(err);
                             }
                             else {
-                                resolve(data);
+                                resolve(new Uint8Array(data));
                             }
                         });
                     });
@@ -259,13 +273,13 @@ class WorkbookWriter {
                 }
                 if (medium.buffer) {
                     this._addFile(medium.buffer, filename);
-                    return Promise.resolve();
+                    return;
                 }
                 if (medium.base64) {
                     const dataimg64 = medium.base64;
                     const content = dataimg64.substring(dataimg64.indexOf(",") + 1);
                     this._addFile(content, filename, true);
-                    return Promise.resolve();
+                    return;
                 }
             }
             throw new Error("Unsupported media");

package/dist/esm/stream/xlsx/worksheet-reader.js

@@ -25,7 +25,7 @@ class WorksheetReader extends EventEmitter {
     destroy() {
         throw new Error("Invalid Operation: destroy");
     }
-    // return the current dimensions of the writer
+    // return the current dimensions of the reader
     get dimensions() {
         return this._dimensions;
     }
@@ -44,7 +44,7 @@ class WorksheetReader extends EventEmitter {
             if (col) {
                 return col;
             }
-            // otherise, assume letter
+            // otherwise, assume letter
             c = colCache.l2n(c);
         }
         if (!this._columns) {
@@ -85,9 +85,9 @@ class WorksheetReader extends EventEmitter {
     }
     async *[Symbol.asyncIterator]() {
         for await (const events of this.parse()) {
-            for (const { eventType, value } of events) {
-                if (eventType === "row") {
-                    yield value;
+            for (const event of events) {
+                if (event.eventType === "row") {
+                    yield event.value;
                 }
             }
         }
@@ -283,6 +283,7 @@ class WorksheetReader extends EventEmitter {
                                                     cell.value = sharedStrings[index];
                                                 }
                                                 else {
+                                                    // Streaming format - unresolved shared string reference
                                                     cell.value = {
                                                         sharedString: index
                                                     };
@@ -299,19 +300,22 @@ class WorksheetReader extends EventEmitter {
                                             case "b":
                                                 cell.value = parseInt(c.v.text, 10) !== 0;
                                                 break;
-                                            default:
-                                                if (isDateFmt(cell.numFmt)) {
-                                                    cell.value = excelToDate(parseFloat(c.v.text), properties.model && properties.model.date1904);
+                                            default: {
+                                                const numFmtStr = typeof cell.numFmt === "string" ? cell.numFmt : cell.numFmt?.formatCode;
+                                                if (numFmtStr && isDateFmt(numFmtStr)) {
+                                                    cell.value = excelToDate(parseFloat(c.v.text), properties?.model?.date1904);
                                                 }
                                                 else {
                                                     cell.value = parseFloat(c.v.text);
                                                 }
                                                 break;
+                                            }
                                         }
                                     }
                                     if (hyperlinks) {
                                         const hyperlink = hyperlinks[c.ref];
                                         if (hyperlink) {
+                                            // Streaming-specific: assign text and hyperlink for further processing
                                             cell.text = cell.value;
                                             cell.value = undefined;
                                             cell.hyperlink = hyperlink;

package/dist/esm/stream/xlsx/worksheet-writer.js

@@ -275,20 +275,26 @@ class WorksheetWriter {
     }
     // iterate over every uncommitted row in the worksheet, including maybe empty rows
     eachRow(options, iteratee) {
-        if (!iteratee) {
-            iteratee = options;
-            options = undefined;
+        let callback;
+        let opts;
+        if (typeof options === "function") {
+            callback = options;
+            opts = undefined;
         }
-        if (options && options.includeEmpty) {
+        else {
+            callback = iteratee;
+            opts = options;
+        }
+        if (opts && opts.includeEmpty) {
             const n = this._nextRow;
             for (let i = this._rowZero; i < n; i++) {
-                iteratee(this.getRow(i), i);
+                callback(this.getRow(i), i);
             }
         }
         else {
             this._rows.forEach(row => {
                 if (row.hasValues) {
-                    iteratee(row, row.number);
+                    callback(row, row.number);
                 }
             });
         }

package/dist/esm/utils/browser-buffer.js

@@ -0,0 +1,67 @@
+/**
+ * Browser-compatible Buffer utilities
+ * Provides base64 encoding/decoding and a Buffer-like wrapper for Uint8Array
+ */
+/**
+ * Convert Uint8Array to base64 string
+ */
+export function uint8ArrayToBase64(bytes) {
+    let binary = "";
+    for (let i = 0; i < bytes.length; i++) {
+        binary += String.fromCharCode(bytes[i]);
+    }
+    return btoa(binary);
+}
+/**
+ * Convert base64 string to Uint8Array
+ */
+export function base64ToUint8Array(base64) {
+    const binaryString = atob(base64);
+    const bytes = new Uint8Array(binaryString.length);
+    for (let i = 0; i < binaryString.length; i++) {
+        bytes[i] = binaryString.charCodeAt(i);
+    }
+    return bytes;
+}
+/**
+ * Buffer-like wrapper for Uint8Array with toString("base64") support
+ * This provides Node.js Buffer-like API for browser environments
+ */
+export class BrowserBuffer extends Uint8Array {
+    toString(encoding) {
+        if (encoding === "base64") {
+            return uint8ArrayToBase64(this);
+        }
+        return new TextDecoder().decode(this);
+    }
+    static from(data) {
+        const buffer = new BrowserBuffer(data.length);
+        buffer.set(data);
+        return buffer;
+    }
+}
+/**
+ * Convert string to UTF-16LE Uint8Array (used for Excel password hashing)
+ */
+export function stringToUtf16Le(str) {
+    const bytes = new Uint8Array(str.length * 2);
+    for (let i = 0; i < str.length; i++) {
+        const code = str.charCodeAt(i);
+        bytes[i * 2] = code & 0xff;
+        bytes[i * 2 + 1] = (code >> 8) & 0xff;
+    }
+    return bytes;
+}
+/**
+ * Concatenate multiple Uint8Arrays into one
+ */
+export function concatUint8Arrays(...arrays) {
+    const totalLength = arrays.reduce((acc, arr) => acc + arr.length, 0);
+    const result = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const arr of arrays) {
+        result.set(arr, offset);
+        offset += arr.length;
+    }
+    return result;
+}

package/dist/esm/utils/encryptor.browser.js

@@ -0,0 +1,237 @@
+/**
+ * Browser-compatible Encryptor with pure JS SHA implementations
+ * This provides synchronous hash functions for browser compatibility
+ */
+import { BrowserBuffer, base64ToUint8Array, uint8ArrayToBase64, stringToUtf16Le, concatUint8Arrays } from "./browser-buffer.js";
+// Helper to convert number to little-endian Uint8Array
+function uint32ToLe(num) {
+    const bytes = new Uint8Array(4);
+    bytes[0] = num & 0xff;
+    bytes[1] = (num >> 8) & 0xff;
+    bytes[2] = (num >> 16) & 0xff;
+    bytes[3] = (num >> 24) & 0xff;
+    return bytes;
+}
+// ============================================================================
+// Pure JavaScript SHA-512 implementation
+// ============================================================================
+// SHA-512 constants (first 80 primes 2..409)
+const K = new BigUint64Array([
+    0x428a2f98d728ae22n,
+    0x7137449123ef65cdn,
+    0xb5c0fbcfec4d3b2fn,
+    0xe9b5dba58189dbb4n,
+    0x3956c25bf348b538n,
+    0x59f111f1b605d019n,
+    0x923f82a4af194f9bn,
+    0xab1c5ed5da6d8118n,
+    0xd807aa98a3030242n,
+    0x12835b0145706fben,
+    0x243185be4ee4b28cn,
+    0x550c7dc3d5ffb4e2n,
+    0x72be5d74f27b896fn,
+    0x80deb1fe3b1696b1n,
+    0x9bdc06a725c71235n,
+    0xc19bf174cf692694n,
+    0xe49b69c19ef14ad2n,
+    0xefbe4786384f25e3n,
+    0x0fc19dc68b8cd5b5n,
+    0x240ca1cc77ac9c65n,
+    0x2de92c6f592b0275n,
+    0x4a7484aa6ea6e483n,
+    0x5cb0a9dcbd41fbd4n,
+    0x76f988da831153b5n,
+    0x983e5152ee66dfabn,
+    0xa831c66d2db43210n,
+    0xb00327c898fb213fn,
+    0xbf597fc7beef0ee4n,
+    0xc6e00bf33da88fc2n,
+    0xd5a79147930aa725n,
+    0x06ca6351e003826fn,
+    0x142929670a0e6e70n,
+    0x27b70a8546d22ffcn,
+    0x2e1b21385c26c926n,
+    0x4d2c6dfc5ac42aedn,
+    0x53380d139d95b3dfn,
+    0x650a73548baf63den,
+    0x766a0abb3c77b2a8n,
+    0x81c2c92e47edaee6n,
+    0x92722c851482353bn,
+    0xa2bfe8a14cf10364n,
+    0xa81a664bbc423001n,
+    0xc24b8b70d0f89791n,
+    0xc76c51a30654be30n,
+    0xd192e819d6ef5218n,
+    0xd69906245565a910n,
+    0xf40e35855771202an,
+    0x106aa07032bbd1b8n,
+    0x19a4c116b8d2d0c8n,
+    0x1e376c085141ab53n,
+    0x2748774cdf8eeb99n,
+    0x34b0bcb5e19b48a8n,
+    0x391c0cb3c5c95a63n,
+    0x4ed8aa4ae3418acbn,
+    0x5b9cca4f7763e373n,
+    0x682e6ff3d6b2b8a3n,
+    0x748f82ee5defb2fcn,
+    0x78a5636f43172f60n,
+    0x84c87814a1f0ab72n,
+    0x8cc702081a6439ecn,
+    0x90befffa23631e28n,
+    0xa4506cebde82bde9n,
+    0xbef9a3f7b2c67915n,
+    0xc67178f2e372532bn,
+    0xca273eceea26619cn,
+    0xd186b8c721c0c207n,
+    0xeada7dd6cde0eb1en,
+    0xf57d4f7fee6ed178n,
+    0x06f067aa72176fban,
+    0x0a637dc5a2c898a6n,
+    0x113f9804bef90daen,
+    0x1b710b35131c471bn,
+    0x28db77f523047d84n,
+    0x32caab7b40c72493n,
+    0x3c9ebe0a15c9bebcn,
+    0x431d67c49c100d4cn,
+    0x4cc5d4becb3e42b6n,
+    0x597f299cfc657e2an,
+    0x5fcb6fab3ad6faecn,
+    0x6c44198c4a475817n
+]);
+// Initial hash values for SHA-512
+const H0 = new BigUint64Array([
+    0x6a09e667f3bcc908n,
+    0xbb67ae8584caa73bn,
+    0x3c6ef372fe94f82bn,
+    0xa54ff53a5f1d36f1n,
+    0x510e527fade682d1n,
+    0x9b05688c2b3e6c1fn,
+    0x1f83d9abfb41bd6bn,
+    0x5be0cd19137e2179n
+]);
+function rotr64(x, n) {
+    return ((x >> BigInt(n)) | (x << BigInt(64 - n))) & 0xffffffffffffffffn;
+}
+function sha512(message) {
+    // Pre-processing: adding padding bits
+    const msgLen = message.length;
+    const msgBitLen = BigInt(msgLen * 8);
+    // Calculate padding length (message + 1 + padding + 16 bytes for length) should be multiple of 128
+    const padLen = (128 - ((msgLen + 17) % 128)) % 128;
+    const paddedLen = msgLen + 1 + padLen + 16;
+    const padded = new Uint8Array(paddedLen);
+    padded.set(message);
+    padded[msgLen] = 0x80;
+    // Append original length in bits as 128-bit big-endian (we only use lower 64 bits)
+    const view = new DataView(padded.buffer);
+    // Upper 64 bits (always 0 for messages < 2^64 bits)
+    view.setBigUint64(paddedLen - 16, 0n, false);
+    // Lower 64 bits
+    view.setBigUint64(paddedLen - 8, msgBitLen, false);
+    // Initialize hash values
+    const H = new BigUint64Array(H0);
+    // Process message in 1024-bit (128-byte) chunks
+    const W = new BigUint64Array(80);
+    for (let chunkStart = 0; chunkStart < paddedLen; chunkStart += 128) {
+        const chunkView = new DataView(padded.buffer, chunkStart, 128);
+        // Copy chunk into first 16 words W[0..15]
+        for (let i = 0; i < 16; i++) {
+            W[i] = chunkView.getBigUint64(i * 8, false);
+        }
+        // Extend the first 16 words into the remaining 64 words W[16..79]
+        for (let i = 16; i < 80; i++) {
+            const s0 = rotr64(W[i - 15], 1) ^ rotr64(W[i - 15], 8) ^ (W[i - 15] >> 7n);
+            const s1 = rotr64(W[i - 2], 19) ^ rotr64(W[i - 2], 61) ^ (W[i - 2] >> 6n);
+            W[i] = (W[i - 16] + s0 + W[i - 7] + s1) & 0xffffffffffffffffn;
+        }
+        // Initialize working variables
+        let a = H[0], b = H[1], c = H[2], d = H[3];
+        let e = H[4], f = H[5], g = H[6], h = H[7];
+        // Main loop
+        for (let i = 0; i < 80; i++) {
+            const S1 = rotr64(e, 14) ^ rotr64(e, 18) ^ rotr64(e, 41);
+            const ch = (e & f) ^ (~e & g);
+            const temp1 = (h + S1 + ch + K[i] + W[i]) & 0xffffffffffffffffn;
+            const S0 = rotr64(a, 28) ^ rotr64(a, 34) ^ rotr64(a, 39);
+            const maj = (a & b) ^ (a & c) ^ (b & c);
+            const temp2 = (S0 + maj) & 0xffffffffffffffffn;
+            h = g;
+            g = f;
+            f = e;
+            e = (d + temp1) & 0xffffffffffffffffn;
+            d = c;
+            c = b;
+            b = a;
+            a = (temp1 + temp2) & 0xffffffffffffffffn;
+        }
+        // Add compressed chunk to current hash value
+        H[0] = (H[0] + a) & 0xffffffffffffffffn;
+        H[1] = (H[1] + b) & 0xffffffffffffffffn;
+        H[2] = (H[2] + c) & 0xffffffffffffffffn;
+        H[3] = (H[3] + d) & 0xffffffffffffffffn;
+        H[4] = (H[4] + e) & 0xffffffffffffffffn;
+        H[5] = (H[5] + f) & 0xffffffffffffffffn;
+        H[6] = (H[6] + g) & 0xffffffffffffffffn;
+        H[7] = (H[7] + h) & 0xffffffffffffffffn;
+    }
+    // Produce the final hash value (big-endian)
+    const result = new Uint8Array(64);
+    const resultView = new DataView(result.buffer);
+    for (let i = 0; i < 8; i++) {
+        resultView.setBigUint64(i * 8, H[i], false);
+    }
+    return result;
+}
+// ============================================================================
+// Encryptor implementation
+// ============================================================================
+const Encryptor = {
+    /**
+     * Calculate a hash of the concatenated buffers with the given algorithm.
+     * @param algorithm - The hash algorithm.
+     * @returns The hash as Uint8Array
+     */
+    hash(algorithm, ...buffers) {
+        const data = concatUint8Arrays(...buffers);
+        const algo = algorithm.toLowerCase().replace("-", "");
+        if (algo === "sha512") {
+            return sha512(data);
+        }
+        throw new Error(`Hash algorithm '${algorithm}' not supported in browser sync mode!`);
+    },
+    /**
+     * Convert a password into an encryption key
+     * @param password - The password
+     * @param hashAlgorithm - The hash algorithm
+     * @param saltValue - The salt value (base64 encoded)
+     * @param spinCount - The spin count
+     * @returns The encryption key (base64 encoded)
+     */
+    convertPasswordToHash(password, hashAlgorithm, saltValue, spinCount) {
+        const algo = hashAlgorithm.toLowerCase().replace("-", "");
+        if (algo !== "sha512") {
+            throw new Error(`Hash algorithm '${hashAlgorithm}' not supported in browser!`);
+        }
+        // Password must be in unicode buffer (UTF-16LE)
+        const passwordBuffer = stringToUtf16Le(password);
+        // Generate the initial hash
+        const saltBuffer = base64ToUint8Array(saltValue);
+        let key = this.hash(hashAlgorithm, saltBuffer, passwordBuffer);
+        // Now regenerate until spin count
+        for (let i = 0; i < spinCount; i++) {
+            const iterator = uint32ToLe(i);
+            key = this.hash(hashAlgorithm, key, iterator);
+        }
+        return uint8ArrayToBase64(key);
+    },
+    /**
+     * Generates cryptographically strong pseudo-random data.
+     * @param size The size argument is a number indicating the number of bytes to generate.
+     */
+    randomBytes(size) {
+        const bytes = new BrowserBuffer(size);
+        crypto.getRandomValues(bytes);
+        return bytes;
+    }
+};
+export { Encryptor };