neozipkit 0.8.0 → 1.0.5

package/dist/core/merkle/MerkleRoot.js

@@ -0,0 +1,275 @@
+"use strict";
+// ======================================
+//  MerkleRoot.ts — NeoZip APPNOTE §6
+//  v0 (legacy Bitcoin-style) and v1 (RFC 6962–style domain separation)
+// ======================================
+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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeMerklePath = normalizeMerklePath;
+exports.contentDigest = contentDigest;
+exports.leafHashV0 = leafHashV0;
+exports.leafHashV1 = leafHashV1;
+exports.parentHash = parentHash;
+exports.merkleRootFromLeaves = merkleRootFromLeaves;
+exports.computeArchiveMerkleRoot = computeArchiveMerkleRoot;
+exports.computeMerkleRootV0FromDigests = computeMerkleRootV0FromDigests;
+exports.computeMerkleRootV1FromContents = computeMerkleRootV1FromContents;
+exports.computeMerkleRootV1FromLeaves = computeMerkleRootV1FromLeaves;
+exports.matchMerkleRoot = matchMerkleRoot;
+const crypto = __importStar(require("crypto"));
+const MetaPaths_1 = require("../constants/MetaPaths");
+const LEAF_DOMAIN = Buffer.from([0x00]);
+const NODE_DOMAIN = Buffer.from([0x01]);
+function sha256(data) {
+    const h = crypto.createHash('sha256');
+    if (Array.isArray(data)) {
+        for (const part of data) {
+            h.update(part);
+        }
+    }
+    else {
+        h.update(data);
+    }
+    return h.digest();
+}
+function asBuffer(data, encoding) {
+    if (typeof data === 'string') {
+        return Buffer.from(data, encoding ?? 'hex');
+    }
+    return Buffer.isBuffer(data) ? data : Buffer.from(data);
+}
+/**
+ * Normalize a ZIP entry path for v1 leaf ordering (APPNOTE §6.3):
+ * POSIX separators, strip leading `./` and `/`, Unicode NFC, UTF-8 byte order when compared.
+ */
+function normalizeMerklePath(path) {
+    let p = path.replace(/\\/g, '/');
+    if (p.startsWith('./')) {
+        p = p.slice(2);
+    }
+    while (p.startsWith('/')) {
+        p = p.slice(1);
+    }
+    if (typeof p.normalize === 'function') {
+        p = p.normalize('NFC');
+    }
+    return p;
+}
+/** Sort key for path comparison (UTF-8 byte order). */
+function pathSortKey(path, algorithm) {
+    const normalized = algorithm === 'v1' ? normalizeMerklePath(path) : path;
+    return Buffer.from(normalized, 'utf8');
+}
+/** Bare content digest (= 0x014E value). */
+function contentDigest(content) {
+    return sha256(asBuffer(content));
+}
+/**
+ * v0 leaf: SHA-256(uncompressed bytes) — same as Extra Field 0x014E.
+ */
+function leafHashV0(contentOrDigest, isDigest = false) {
+    const buf = asBuffer(contentOrDigest);
+    return isDigest ? buf : sha256(buf);
+}
+/**
+ * v1 leaf: SHA-256(0x00 ‖ uncompressed_bytes).
+ * Must not be confused with the bare 0x014E digest (APPNOTE §6.3).
+ */
+function leafHashV1(content) {
+    return sha256([LEAF_DOMAIN, asBuffer(content)]);
+}
+/**
+ * Parent node hashes.
+ * v0: SHA-256(H_left ‖ H_right) — order preserved, no pair sorting.
+ * v1: SHA-256(0x01 ‖ H_left ‖ H_right).
+ */
+function parentHash(left, right, algorithm) {
+    if (algorithm === 'v1') {
+        return sha256([NODE_DOMAIN, left, right]);
+    }
+    return sha256([left, right]);
+}
+/**
+ * Fold an ordered list of leaf hashes into a single root (hex lowercase).
+ * Odd-count rule:
+ *  - v0: duplicate last leaf (Bitcoin-style)
+ *  - v1: promote last node unhashed (RFC 6962–style)
+ */
+function merkleRootFromLeaves(leaves, algorithm) {
+    if (leaves.length === 0) {
+        return null;
+    }
+    let level = leaves.map((l) => Buffer.from(l));
+    while (level.length > 1) {
+        const next = [];
+        for (let i = 0; i + 1 < level.length; i += 2) {
+            next.push(parentHash(level[i], level[i + 1], algorithm));
+        }
+        if (level.length % 2 === 1) {
+            const last = level[level.length - 1];
+            if (algorithm === 'v0') {
+                // Duplicate last leaf, then hash the pair
+                next.push(parentHash(last, last, algorithm));
+            }
+            else {
+                // Promote unhashed
+                next.push(last);
+            }
+        }
+        level = next;
+    }
+    return level[0].toString('hex');
+}
+function resolveLeaf(entry, algorithm) {
+    if (algorithm === 'v0') {
+        if (entry.contentSha256) {
+            const d = asBuffer(entry.contentSha256, typeof entry.contentSha256 === 'string' ? 'hex' : undefined);
+            if (d.length !== 32) {
+                return null;
+            }
+            return d;
+        }
+        if (entry.content) {
+            return contentDigest(entry.content);
+        }
+        return null;
+    }
+    // v1: prefer precomputed domain-separated leaf from the same hashing pass as 0x014E
+    if (entry.merkleLeafV1) {
+        const d = asBuffer(entry.merkleLeafV1, typeof entry.merkleLeafV1 === 'string' ? 'hex' : undefined);
+        if (d.length !== 32) {
+            return null;
+        }
+        return d;
+    }
+    // Domain-separated hash of uncompressed payload (re-hash only if leaf not available)
+    if (entry.content) {
+        return leafHashV1(entry.content);
+    }
+    return null;
+}
+/**
+ * Compute archive Merkle root per APPNOTE §6 from content entries
+ * (caller already excluded META-INF/** if desired).
+ *
+ * @returns lowercase hex root, or null if no usable leaves
+ */
+function computeArchiveMerkleRoot(entries, algorithm = 'v1') {
+    const prepared = [];
+    for (const entry of entries) {
+        if ((0, MetaPaths_1.isMetaInfPath)(entry.path || '')) {
+            continue;
+        }
+        const leaf = resolveLeaf(entry, algorithm);
+        if (!leaf) {
+            continue;
+        }
+        prepared.push({
+            key: pathSortKey(entry.path || '', algorithm),
+            leaf,
+        });
+    }
+    if (prepared.length === 0) {
+        return null;
+    }
+    prepared.sort((a, b) => Buffer.compare(a.key, b.key));
+    return merkleRootFromLeaves(prepared.map((p) => p.leaf), algorithm);
+}
+/**
+ * Build v0 root from path + bare content digests only (0x014E extras).
+ * Path order: central-directory bytes as stored (no NFC / strip).
+ */
+function computeMerkleRootV0FromDigests(entries) {
+    return computeArchiveMerkleRoot(entries.map((e) => ({ path: e.path, contentSha256: e.sha256 })), 'v0');
+}
+/**
+ * Build v1 root from path + uncompressed payloads (APPNOTE §6.3).
+ * Paths are normalized before sorting.
+ */
+function computeMerkleRootV1FromContents(entries) {
+    return computeArchiveMerkleRoot(entries.map((e) => ({ path: e.path, content: e.content })), 'v1');
+}
+/**
+ * Build v1 root from path + precomputed domain-separated leaves (APPNOTE §6.3).
+ * Prefer this after create/extract when HashCalculator produced merkleLeafV1 in one stream pass.
+ */
+function computeMerkleRootV1FromLeaves(entries) {
+    return computeArchiveMerkleRoot(entries.map((e) => ({ path: e.path, merkleLeafV1: e.merkleLeafV1 })), 'v1');
+}
+/**
+ * Verify a declared root (APPNOTE §6.4): try v1 first (when content or leaves available),
+ * then v0 digests. Returns which algorithm matched, or null on failure.
+ *
+ * When only bare 0x014E digests are available, only v0 can match APPNOTE correctly.
+ * Pass `merkleLeafV1` or content for full v1 verification without re-hashing from scratch
+ * when leaves were computed in the decompress stream.
+ */
+function matchMerkleRoot(entries, declaredRoot) {
+    const expected = declaredRoot.toLowerCase().replace(/^0x/, '');
+    if (!/^[0-9a-f]{64}$/.test(expected)) {
+        return null;
+    }
+    const hasV1Material = entries.some((e) => !(0, MetaPaths_1.isMetaInfPath)(e.path || '') &&
+        (!!e.merkleLeafV1 || !!e.content));
+    if (hasV1Material) {
+        const v1 = computeArchiveMerkleRoot(entries, 'v1');
+        if (v1 && v1 === expected) {
+            return { algorithm: 'v1', security: 'high' };
+        }
+    }
+    const v0 = computeArchiveMerkleRoot(entries, 'v0');
+    if (v0 && v0 === expected) {
+        return { algorithm: 'v0', security: 'legacy' };
+    }
+    // If v1 was not tried (no leaves/content), v0 was the only attempt.
+    if (hasV1Material) {
+        return null;
+    }
+    return null;
+}
+exports.default = {
+    normalizeMerklePath,
+    contentDigest,
+    leafHashV0,
+    leafHashV1,
+    parentHash,
+    merkleRootFromLeaves,
+    computeArchiveMerkleRoot,
+    computeMerkleRootV0FromDigests,
+    computeMerkleRootV1FromContents,
+    computeMerkleRootV1FromLeaves,
+    matchMerkleRoot,
+};
+//# sourceMappingURL=MerkleRoot.js.map

package/dist/core/merkle/MerkleRoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MerkleRoot.js","sourceRoot":"","sources":["../../../src/core/merkle/MerkleRoot.ts"],"names":[],"mappings":";AAAA,yCAAyC;AACzC,qCAAqC;AACrC,uEAAuE;AACvE,yCAAyC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuDzC,kDAYC;AASD,sCAEC;AAKD,gCAGC;AAMD,gCAEC;AAOD,gCAKC;AAQD,oDA0BC;AA4CD,4DA6BC;AAMD,wEAOC;AAMD,0EAOC;AAMD,sEAOC;AAUD,0CAgCC;AApSD,+CAAiC;AACjC,sDAAuD;AA0BvD,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACxC,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAExC,SAAS,MAAM,CAAC,IAAoC;IAClD,MAAM,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;YACxB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC;AACpB,CAAC;AAED,SAAS,QAAQ,CAAC,IAAkC,EAAE,QAAyB;IAC7E,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,IAAI,KAAK,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,IAAY;IAC9C,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QACtC,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,uDAAuD;AACvD,SAAS,WAAW,CAAC,IAAY,EAAE,SAA0B;IAC3D,MAAM,UAAU,GAAG,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzE,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC;AAED,4CAA4C;AAC5C,SAAgB,aAAa,CAAC,OAA4B;IACxD,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU,CAAC,eAAoC,EAAE,QAAQ,GAAG,KAAK;IAC/E,MAAM,GAAG,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC;IACtC,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,SAAgB,UAAU,CAAC,OAA4B;IACrD,OAAO,MAAM,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,SAAgB,UAAU,CAAC,IAAY,EAAE,KAAa,EAAE,SAA0B;IAChF,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,MAAgB,EAAE,SAA0B;IAC/E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,KAAK,GAAa,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAExD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACrC,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;gBACvB,0CAA0C;gBAC1C,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,mBAAmB;gBACnB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QACD,KAAK,GAAG,IAAI,CAAC;IACf,CAAC;IAED,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,WAAW,CAClB,KAAyB,EACzB,SAA0B;IAE1B,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,aAAa,EAAE,OAAO,KAAK,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACrG,IAAI,CAAC,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;gBACpB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oFAAoF;IACpF,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,QAAQ,CAChB,KAAK,CAAC,YAAY,EAClB,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAC3D,CAAC;QACF,IAAI,CAAC,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,qFAAqF;IACrF,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAgB,wBAAwB,CACtC,OAA6B,EAC7B,YAA6B,IAAI;IAEjC,MAAM,QAAQ,GAAoC,EAAE,CAAC;IAErD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,IAAA,yBAAa,EAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;YACpC,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,SAAS;QACX,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC;YACZ,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE,SAAS,CAAC;YAC7C,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,OAAO,oBAAoB,CACzB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAC3B,SAAS,CACV,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,8BAA8B,CAC5C,OAAyD;IAEzD,OAAO,wBAAwB,CAC7B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,EAC/D,IAAI,CACL,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,+BAA+B,CAC7C,OAA8D;IAE9D,OAAO,wBAAwB,CAC7B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,EAC1D,IAAI,CACL,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,6BAA6B,CAC3C,OAA+D;IAE/D,OAAO,wBAAwB,CAC7B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,EACpE,IAAI,CACL,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,eAAe,CAC7B,OAA6B,EAC7B,YAAoB;IAEpB,MAAM,QAAQ,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/D,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAChC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,IAAA,yBAAa,EAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CACpC,CAAC;IACF,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,EAAE,GAAG,wBAAwB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnD,IAAI,EAAE,IAAI,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC1B,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,MAAM,EAAE,GAAG,wBAAwB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACnD,IAAI,EAAE,IAAI,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACjD,CAAC;IAED,oEAAoE;IACpE,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kBAAe;IACb,mBAAmB;IACnB,aAAa;IACb,UAAU;IACV,UAAU;IACV,UAAU;IACV,oBAAoB;IACpB,wBAAwB;IACxB,8BAA8B;IAC9B,+BAA+B;IAC/B,6BAA6B;IAC7B,eAAe;CAChB,CAAC"}

package/dist/core/version.js

@@ -25,7 +25,7 @@ exports.VERSION = void 0;
 const currentDate = new Date();
 const releaseDate = `${String(currentDate.getMonth() + 1).padStart(2, '0')}-${String(currentDate.getDate()).padStart(2, '0')}-${currentDate.getFullYear()}`;
 exports.VERSION = {
-    number: '0.7.0', // packageJson.version
+    number: '1.0.5', // packageJson.version
     date: releaseDate
 };
 //# sourceMappingURL=version.js.map

package/dist/node/LegacyZstd.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Detect legacy NeoZipKit WASM zstd (`@oneidentity/zstd-js`).
+ *
+ * That codec wrote valid-looking zstd frames but declared Frame_Content_Size as
+ * `uncompressed_size + 18`. Standard libzstd / Node zlib decode to the real
+ * payload plus 18 trailing zero bytes. CRC of the truncated payload matches
+ * the ZIP entry CRC.
+ *
+ * Header-only checks do not require decompressing. Verified checks decompress
+ * with native zlib and confirm trailing zeros + optional CRC.
+ */
+/** Fixed extra bytes declared/emitted by the broken WASM codec. */
+export declare const LEGACY_WASM_ZSTD_PADDING = 18;
+export type LegacyZstdConfidence = 'none' | 'header' | 'verified';
+export interface LegacyZstdDetectResult {
+    /** True when this looks like (or verifies as) legacy WASM zstd. */
+    isLegacyWasm: boolean;
+    /** How the decision was made. */
+    confidence: LegacyZstdConfidence;
+    /** Parsed Frame_Content_Size, if present in the frame header. */
+    frameContentSize: number | null;
+    /** Expected plaintext size from the ZIP entry (or caller). */
+    expectedUncompressedSize: number;
+    /** Declared/observed padding past expected size (typically 18). */
+    paddingBytes: number;
+    /** Human-readable reason. */
+    reason: string;
+}
+export interface DetectLegacyZstdOptions {
+    /**
+     * When true (default), decompress with native zlib and confirm
+     * trailing zeros (+ optional CRC) instead of trusting the header alone.
+     */
+    verify?: boolean;
+    /** ZIP CRC-32 of the original uncompressed data (strengthens verified check). */
+    crc?: number;
+}
+/**
+ * Read Frame_Content_Size from a zstd frame header, or null if absent / unparseable.
+ * @see https://github.com/facebook/zstd/blob/dev/doc/zstd_compression_format.md
+ */
+export declare function parseZstdFrameContentSize(compressed: Buffer): number | null;
+/**
+ * Fast header heuristic: FCS === expectedUncompressedSize + 18.
+ */
+export declare function looksLikeLegacyWasmZstd(compressed: Buffer, expectedUncompressedSize: number): boolean;
+/**
+ * Detect legacy WASM zstd frames for a single compressed payload.
+ */
+export declare function detectLegacyWasmZstd(compressed: Buffer, expectedUncompressedSize: number, options?: DetectLegacyZstdOptions): Promise<LegacyZstdDetectResult>;
+/**
+ * Truncate plaintext if it matches the legacy +18 zero padding pattern.
+ * Returns the original buffer when not legacy-shaped.
+ */
+export declare function repairLegacyWasmZstdPlaintext(decoded: Buffer, expectedUncompressedSize: number, crc?: number): {
+    repaired: Buffer;
+    wasLegacy: boolean;
+};
+export declare const LegacyZstd: {
+    LEGACY_WASM_ZSTD_PADDING: number;
+    parseZstdFrameContentSize: typeof parseZstdFrameContentSize;
+    looksLikeLegacyWasmZstd: typeof looksLikeLegacyWasmZstd;
+    detectLegacyWasmZstd: typeof detectLegacyWasmZstd;
+    repairLegacyWasmZstdPlaintext: typeof repairLegacyWasmZstdPlaintext;
+};
+export default LegacyZstd;
+//# sourceMappingURL=LegacyZstd.d.ts.map

package/dist/node/LegacyZstd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LegacyZstd.d.ts","sourceRoot":"","sources":["../../src/node/LegacyZstd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,mEAAmE;AACnE,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAI3C,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAElE,MAAM,WAAW,sBAAsB;IACrC,mEAAmE;IACnE,YAAY,EAAE,OAAO,CAAC;IACtB,iCAAiC;IACjC,UAAU,EAAE,oBAAoB,CAAC;IACjC,iEAAiE;IACjE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,8DAA8D;IAC9D,wBAAwB,EAAE,MAAM,CAAC;IACjC,mEAAmE;IACnE,YAAY,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iFAAiF;IACjF,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwD3E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,wBAAwB,EAAE,MAAM,GAC/B,OAAO,CAST;AAQD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,wBAAwB,EAAE,MAAM,EAChC,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,sBAAsB,CAAC,CAwFjC;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,EACf,wBAAwB,EAAE,MAAM,EAChC,GAAG,CAAC,EAAE,MAAM,GACX;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAsB1C;AAED,eAAO,MAAM,UAAU;;;;;;CAMtB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/node/LegacyZstd.js

@@ -0,0 +1,209 @@
+"use strict";
+/**
+ * Detect legacy NeoZipKit WASM zstd (`@oneidentity/zstd-js`).
+ *
+ * That codec wrote valid-looking zstd frames but declared Frame_Content_Size as
+ * `uncompressed_size + 18`. Standard libzstd / Node zlib decode to the real
+ * payload plus 18 trailing zero bytes. CRC of the truncated payload matches
+ * the ZIP entry CRC.
+ *
+ * Header-only checks do not require decompressing. Verified checks decompress
+ * with native zlib and confirm trailing zeros + optional CRC.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LegacyZstd = exports.LEGACY_WASM_ZSTD_PADDING = void 0;
+exports.parseZstdFrameContentSize = parseZstdFrameContentSize;
+exports.looksLikeLegacyWasmZstd = looksLikeLegacyWasmZstd;
+exports.detectLegacyWasmZstd = detectLegacyWasmZstd;
+exports.repairLegacyWasmZstdPlaintext = repairLegacyWasmZstdPlaintext;
+const ZstdNode_1 = require("./ZstdNode");
+const HashCalculator_1 = require("../core/components/HashCalculator");
+/** Fixed extra bytes declared/emitted by the broken WASM codec. */
+exports.LEGACY_WASM_ZSTD_PADDING = 18;
+const ZSTD_MAGIC = Buffer.from([0x28, 0xb5, 0x2f, 0xfd]);
+/**
+ * Read Frame_Content_Size from a zstd frame header, or null if absent / unparseable.
+ * @see https://github.com/facebook/zstd/blob/dev/doc/zstd_compression_format.md
+ */
+function parseZstdFrameContentSize(compressed) {
+    if (!compressed || compressed.length < 6) {
+        return null;
+    }
+    if (compressed[0] !== ZSTD_MAGIC[0] ||
+        compressed[1] !== ZSTD_MAGIC[1] ||
+        compressed[2] !== ZSTD_MAGIC[2] ||
+        compressed[3] !== ZSTD_MAGIC[3]) {
+        return null;
+    }
+    const descriptor = compressed[4];
+    const fcsFlag = (descriptor >> 6) & 0x3;
+    const singleSegment = ((descriptor >> 5) & 0x1) === 1;
+    const dictIdFlag = descriptor & 0x3;
+    const dictIdSizes = [0, 1, 2, 4];
+    let pos = 5 + dictIdSizes[dictIdFlag];
+    if (fcsFlag === 0) {
+        if (!singleSegment) {
+            return null;
+        }
+        if (pos >= compressed.length) {
+            return null;
+        }
+        return compressed[pos];
+    }
+    const fcsSizes = [0, 2, 4, 8];
+    const n = fcsSizes[fcsFlag];
+    if (pos + n > compressed.length) {
+        return null;
+    }
+    let fcs;
+    if (n === 2) {
+        fcs = compressed.readUInt16LE(pos);
+    }
+    else if (n === 4) {
+        fcs = compressed.readUInt32LE(pos);
+    }
+    else {
+        const lo = compressed.readUInt32LE(pos);
+        const hi = compressed.readUInt32LE(pos + 4);
+        // Content sizes that do not fit in JS safe integers are not our legacy case.
+        if (hi !== 0) {
+            return null;
+        }
+        fcs = lo;
+    }
+    // Spec: when FCS_Flag == 1, stored value is (size - 256).
+    if (fcsFlag === 1) {
+        fcs += 256;
+    }
+    return fcs;
+}
+/**
+ * Fast header heuristic: FCS === expectedUncompressedSize + 18.
+ */
+function looksLikeLegacyWasmZstd(compressed, expectedUncompressedSize) {
+    if (expectedUncompressedSize < 0 || !Number.isFinite(expectedUncompressedSize)) {
+        return false;
+    }
+    const fcs = parseZstdFrameContentSize(compressed);
+    if (fcs === null) {
+        return false;
+    }
+    return fcs === expectedUncompressedSize + exports.LEGACY_WASM_ZSTD_PADDING;
+}
+function crc32Of(data) {
+    const h = new HashCalculator_1.HashCalculator();
+    h.update(data);
+    return h.finalizeCRC32();
+}
+/**
+ * Detect legacy WASM zstd frames for a single compressed payload.
+ */
+async function detectLegacyWasmZstd(compressed, expectedUncompressedSize, options) {
+    const expected = expectedUncompressedSize >>> 0;
+    const fcs = parseZstdFrameContentSize(compressed);
+    const headerMatch = fcs !== null && fcs === expected + exports.LEGACY_WASM_ZSTD_PADDING;
+    const base = {
+        frameContentSize: fcs,
+        expectedUncompressedSize: expected,
+        paddingBytes: exports.LEGACY_WASM_ZSTD_PADDING,
+    };
+    if (!headerMatch && options?.verify === false) {
+        return {
+            ...base,
+            isLegacyWasm: false,
+            confidence: 'none',
+            reason: fcs === null
+                ? 'No Frame_Content_Size in zstd header (or not a zstd frame)'
+                : `Frame_Content_Size ${fcs} does not equal expected ${expected} + ${exports.LEGACY_WASM_ZSTD_PADDING}`,
+        };
+    }
+    if (options?.verify === false) {
+        return {
+            ...base,
+            isLegacyWasm: true,
+            confidence: 'header',
+            reason: `Frame_Content_Size is expected+${exports.LEGACY_WASM_ZSTD_PADDING} (legacy WASM heuristic)`,
+        };
+    }
+    // Verified path (default): decompress and check padding / CRC.
+    let decoded;
+    try {
+        decoded = await ZstdNode_1.ZstdNode.decompress(compressed);
+    }
+    catch (e) {
+        return {
+            ...base,
+            isLegacyWasm: false,
+            confidence: 'none',
+            reason: `Native decompress failed: ${e instanceof Error ? e.message : String(e)}`,
+        };
+    }
+    const pad = decoded.length - expected;
+    const trailingZeros = pad === exports.LEGACY_WASM_ZSTD_PADDING &&
+        decoded.subarray(expected).equals(Buffer.alloc(exports.LEGACY_WASM_ZSTD_PADDING));
+    const truncated = decoded.subarray(0, Math.min(expected, decoded.length));
+    const crcOk = options?.crc === undefined ||
+        options.crc === 0 ||
+        crc32Of(truncated) === (options.crc >>> 0);
+    if (trailingZeros && crcOk && decoded.length === expected + exports.LEGACY_WASM_ZSTD_PADDING) {
+        return {
+            ...base,
+            isLegacyWasm: true,
+            confidence: 'verified',
+            reason: options?.crc && options.crc !== 0
+                ? `Decoded length is +${exports.LEGACY_WASM_ZSTD_PADDING} with trailing zeros; truncated CRC matches`
+                : `Decoded length is +${exports.LEGACY_WASM_ZSTD_PADDING} with trailing zeros`,
+        };
+    }
+    if (headerMatch && !trailingZeros) {
+        return {
+            ...base,
+            isLegacyWasm: false,
+            confidence: 'none',
+            reason: 'Header suggested legacy WASM but decoded payload did not have 18 trailing zeros',
+        };
+    }
+    return {
+        ...base,
+        isLegacyWasm: false,
+        confidence: 'none',
+        paddingBytes: Math.max(0, pad),
+        reason: decoded.length === expected
+            ? 'Standard zstd frame (decoded size matches expected)'
+            : `Decoded size ${decoded.length} does not match legacy pattern (expected ${expected} or ${expected + exports.LEGACY_WASM_ZSTD_PADDING})`,
+    };
+}
+/**
+ * Truncate plaintext if it matches the legacy +18 zero padding pattern.
+ * Returns the original buffer when not legacy-shaped.
+ */
+function repairLegacyWasmZstdPlaintext(decoded, expectedUncompressedSize, crc) {
+    const expected = expectedUncompressedSize >>> 0;
+    if (decoded.length === expected + exports.LEGACY_WASM_ZSTD_PADDING &&
+        decoded.subarray(expected).equals(Buffer.alloc(exports.LEGACY_WASM_ZSTD_PADDING))) {
+        const repaired = decoded.subarray(0, expected);
+        if (crc !== undefined && crc !== 0) {
+            if (crc32Of(repaired) !== (crc >>> 0)) {
+                return { repaired: decoded, wasLegacy: false };
+            }
+        }
+        return { repaired, wasLegacy: true };
+    }
+    if (decoded.length > expected && expected > 0) {
+        // Match Rust extract behavior: bound to declared uncompressed size for zstd.
+        const repaired = decoded.subarray(0, expected);
+        if (crc !== undefined && crc !== 0 && crc32Of(repaired) === (crc >>> 0)) {
+            return { repaired, wasLegacy: true };
+        }
+    }
+    return { repaired: decoded, wasLegacy: false };
+}
+exports.LegacyZstd = {
+    LEGACY_WASM_ZSTD_PADDING: exports.LEGACY_WASM_ZSTD_PADDING,
+    parseZstdFrameContentSize,
+    looksLikeLegacyWasmZstd,
+    detectLegacyWasmZstd,
+    repairLegacyWasmZstdPlaintext,
+};
+exports.default = exports.LegacyZstd;
+//# sourceMappingURL=LegacyZstd.js.map

package/dist/node/LegacyZstd.js.map

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

package/dist/node/ZipCompressNode.d.ts

@@ -58,17 +58,19 @@ export declare class ZipCompressNode {
      */
     deflate(inbuf: Buffer, options?: CompressOptions): Buffer;
     /**
-     * Compresses data using Zstandard (zstd) algorithm
-     * @param input - Buffer to compress OR chunked reader object with totalSize and readChunk callback
+     * Compresses data using Zstandard via Node native zlib chunked streaming.
+     *
+     * @param input - Buffer OR chunked reader (`onReadChunk` preferred; `readChunk` accepted)
      * @param options - Compression options
-     * @param bufferSize - Size of buffer to read if using chunked reader (default: 512KB)
-     * @param entry - Optional ZIP entry for hash calculation
-     * @param onOutputBuffer - Optional callback for streaming output
-     * @returns Compressed data buffer
+     * @param bufferSize - Chunk size for streaming reads (default: 512KB)
+     * @param entry - Optional ZIP entry for hash / compressedSize
+     * @param onOutputBuffer - Optional callback for streaming compressed output
+     * @returns Compressed buffer, or empty buffer when streamed via onOutputBuffer
      */
     zstdCompress(input: Buffer | {
         totalSize: number;
-        readChunk: (position: number, size: number) => Buffer;
+        onReadChunk?: (position: number, size: number) => Buffer;
+        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

package/dist/node/ZipCompressNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ZipCompressNode.d.ts","sourceRoot":"","sources":["../../src/node/ZipCompressNode.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,QAAQ,MAAM,kBAAkB,CAAC;AACxC,OAAO,UAAU,MAAM,cAAc,CAAC;AAetC,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAa;IAG/B,OAAO,CAAC,MAAM,CAAC,cAAc,CAAkB;IAE/C;;OAEG;IACH,OAAO,CAAC,GAAG;IAMX;;;OAGG;gBACS,UAAU,EAAE,UAAU;IAYlC;;;;;;;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;IA2E/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;IA8IlB;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,MAAM;IAgBzD;;;;;;;;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;IAsElB;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IAiB7B;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAWhC,OAAO,CAAC,wBAAwB;IAkBhC;;;;;;;;;;OAUG;IACG,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,QAAQ,EACf,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,MAAM,CAAC;IAsBlB;;;;;;;;;;;;OAYG;IACG,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,QAAQ,EACf,OAAO,CAAC,EAAE,eAAe,EACzB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAC/C,OAAO,CAAC,MAAM,CAAC;IAgElB;;;;;;;;;;;;OAYG;IACG,aAAa,CACjB,SAAS,EAAE,MAAM,EAAE,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC;CAoCjB"}
+{"version":3,"file":"ZipCompressNode.d.ts","sourceRoot":"","sources":["../../src/node/ZipCompressNode.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,QAAQ,MAAM,kBAAkB,CAAC;AACxC,OAAO,UAAU,MAAM,cAAc,CAAC;AAetC,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAa;IAG/B,OAAO,CAAC,MAAM,CAAC,cAAc,CAAkB;IAE/C;;OAEG;IACH,OAAO,CAAC,GAAG;IAMX;;;OAGG;gBACS,UAAU,EAAE,UAAU;IAYlC;;;;;;;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;IA0E/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;IA0IlB;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,MAAM;IAgBzD;;;;;;;;;OASG;IACG,YAAY,CAChB,KAAK,EACD,MAAM,GACN;QACE,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;QACzD,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;KACxD,EACL,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;IAgHlB;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IAiB7B;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAWhC,OAAO,CAAC,wBAAwB;IAkBhC;;;;;;;;;;OAUG;IACG,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,QAAQ,EACf,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,MAAM,CAAC;IAsBlB;;;;;;;;;;;;OAYG;IACG,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,QAAQ,EACf,OAAO,CAAC,EAAE,eAAe,EACzB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAC/C,OAAO,CAAC,MAAM,CAAC;IA+DlB;;;;;;;;;;;;OAYG;IACG,aAAa,CACjB,SAAS,EAAE,MAAM,EAAE,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC;CAoCjB"}