@zip.js/zip.js 2.9.0 → 2.10.0

package/index.cjs

@@ -3475,21 +3475,14 @@ async function terminateWorkers() {
  EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
-/* global TextDecoder */
-
 const CP437 = "\0\u263A\u263B\u2665\u2666\u2663\u2660\u2022\u25D8\u25CB\u25D9\u2642\u2640\u266A\u266B\u263C\u25BA\u25C4\u2195\u203C\u00B6\u00A7\u25AC\u21A8\u2191\u2193\u2192\u2190\u221F\u2194\u25B2\u25BC !\"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`abcdefghijklmnopqrstuvwxyz{|}~\u2302\u00C7\u00FC\u00E9\u00E2\u00E4\u00E0\u00E5\u00E7\u00EA\u00EB\u00E8\u00EF\u00EE\u00EC\u00C4\u00C5\u00C9\u00E6\u00C6\u00F4\u00F6\u00F2\u00FB\u00F9\u00FF\u00D6\u00DC\u00A2\u00A3\u00A5\u20A7\u0192\u00E1\u00ED\u00F3\u00FA\u00F1\u00D1\u00AA\u00BA\u00BF\u2310\u00AC\u00BD\u00BC\u00A1\u00AB\u00BB\u2591\u2592\u2593\u2502\u2524\u2561\u2562\u2556\u2555\u2563\u2551\u2557\u255D\u255C\u255B\u2510\u2514\u2534\u252C\u251C\u2500\u253C\u255E\u255F\u255A\u2554\u2569\u2566\u2560\u2550\u256C\u2567\u2568\u2564\u2565\u2559\u2558\u2552\u2553\u256B\u256A\u2518\u250C\u2588\u2584\u258C\u2590\u2580\u03B1\u00DF\u0393\u03C0\u03A3\u03C3\u00B5\u03C4\u03A6\u0398\u03A9\u03B4\u221E\u03C6\u03B5\u2229\u2261\u00B1\u2265\u2264\u2320\u2321\u00F7\u2248\u00B0\u2219\u00B7\u221A\u207F\u00B2\u25A0\u00A0".split("");
-const VALID_CP437 = CP437.length == 256;
 
 function decodeCP437(stringValue) {
-	if (VALID_CP437) {
-		let result = "";
-		for (let indexCharacter = 0; indexCharacter < stringValue.length; indexCharacter++) {
-			result += CP437[stringValue[indexCharacter]];
-		}
-		return result;
-	} else {
-		return new TextDecoder().decode(stringValue);
+	let result = "";
+	for (let indexCharacter = 0; indexCharacter < stringValue.length; indexCharacter++) {
+		result += CP437[stringValue[indexCharacter]];
 	}
+	return result;
 }
 
 /*
@@ -8624,7 +8617,7 @@ function formatSupported(StreamClass, format) {
  EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
-const VERSION = "2.9.0";
+const VERSION = "2.10.0";
 
 /*
  Copyright (c) 2025 Gildas Lormeau. All rights reserved.
@@ -9516,7 +9509,14 @@ l(setDefaultConfiguration);
 
 
 const ERR_ENTRY_EXISTS = "Entry filename already exists";
+const ERR_DUPLICATE_IMPORTED_ENTRY = "Duplicate entry filename in the imported zip file";
+const ERR_INVALID_DUPLICATES = "Invalid duplicates option (must be \"throw\", \"keep-first\" or \"keep-last\")";
+const ERR_ANCESTOR_ENTRY = "Entry is a ancestor of target entry";
 const ERR_READABLE_CONSUMED = "Readable stream already consumed";
+const DUPLICATES_THROW = "throw";
+const DUPLICATES_KEEP_FIRST = "keep-first";
+const DUPLICATES_KEEP_LAST = "keep-last";
+const DUPLICATES_VALUES = new Set([DUPLICATES_THROW, DUPLICATES_KEEP_FIRST, DUPLICATES_KEEP_LAST]);
 const ERR_INVALID_PASS_THROUGH = "Invalid passThrough option (use readerOptions.passThrough or set uncompressedSize for each entry)";
 const ERR_INVALID_READER_OPTIONS = "Invalid readerOptions (must be an object)";
 const ERR_ZIP_CRYPTO_LAST_MOD_DATE = "The last modification date of an entry encrypted with ZipCrypto cannot be changed when passThrough is set";
@@ -9593,12 +9593,26 @@ class ZipEntry {
 	}
 
 	rename(name) {
-		const parent = this.parent;
-		if (parent && parent.getChildByName(name)) {
-			throw new Error(ERR_ENTRY_EXISTS);
-		} else {
-			this.name = name;
+		const zipEntry = this;
+		let parent = zipEntry.parent;
+		if (parent) {
+			const path = splitPath(name);
+			if (path) {
+				name = path.pop();
+				parent = getPathParent(parent, path, zipEntry);
+			}
+			const existingChild = parent.getChildByName(name);
+			if (existingChild && existingChild != zipEntry) {
+				throw new Error(ERR_ENTRY_EXISTS);
+			}
+			if (parent != zipEntry.parent) {
+				detach(zipEntry);
+				zipEntry.parent = parent;
+				parent.children.push(zipEntry);
+				registerEntries(zipEntry.fs, zipEntry);
+			}
 		}
+		zipEntry.name = name;
 	}
 
 	setOptions(options) {
@@ -9691,47 +9705,47 @@ class ZipFileEntry extends ZipEntry {
 	}
 
 	replaceBlob(blob) {
-		Object.assign(this, {
+		replaceContent(this, {
 			data: blob,
 			Reader: BlobReader,
 			Writer: BlobWriter,
-			reader: null
+			uncompressedSize: blob.size
 		});
 	}
 
 	replaceText(text) {
-		Object.assign(this, {
+		replaceContent(this, {
 			data: text,
 			Reader: TextReader,
 			Writer: TextWriter,
-			reader: null
+			uncompressedSize: getTextSize(text)
 		});
 	}
 
 	replaceData64URI(dataURI) {
-		Object.assign(this, {
+		replaceContent(this, {
 			data: dataURI,
 			Reader: Data64URIReader,
 			Writer: Data64URIWriter,
-			reader: null
+			uncompressedSize: getData64URISize(dataURI)
 		});
 	}
 
 	replaceUint8Array(array) {
-		Object.assign(this, {
+		replaceContent(this, {
 			data: array,
 			Reader: Uint8ArrayReader,
 			Writer: Uint8ArrayWriter,
-			reader: null
+			uncompressedSize: array.length
 		});
 	}
 
 	replaceReadable(readable) {
-		Object.assign(this, {
+		replaceContent(this, {
 			data: null,
 			Reader: getReadableReader(readable),
 			Writer: null,
-			reader: null
+			uncompressedSize: UNDEFINED_VALUE
 		});
 	}
 }
@@ -9781,17 +9795,12 @@ class ZipDirectoryEntry extends ZipEntry {
 	}
 
 	addData64URI(name, dataURI, options = {}) {
-		let dataEnd = dataURI.length;
-		while (dataURI.charAt(dataEnd - 1) == "=") {
-			dataEnd--;
-		}
-		const dataStart = dataURI.indexOf(",") + 1;
 		return addChild(this, name, {
 			data: dataURI,
 			Reader: Data64URIReader,
 			Writer: Data64URIWriter,
 			options,
-			uncompressedSize: Math.floor((dataEnd - dataStart) * 0.75)
+			uncompressedSize: getData64URISize(dataURI)
 		});
 	}
 
@@ -9899,6 +9908,7 @@ class ZipDirectoryEntry extends ZipEntry {
 			await initStream(reader);
 			zipReader = new ZipReader(reader, options);
 		}
+		const duplicates = checkDuplicatesOption(options.duplicates);
 		const importedEntries = [];
 		const entries = await zipReader.getEntries(options);
 		for (const entry of entries) {
@@ -9906,19 +9916,42 @@ class ZipDirectoryEntry extends ZipEntry {
 			try {
 				const path = entry.filename.split("/").filter(pathPart => pathPart != "" && pathPart != ".");
 				const name = path.pop();
-				path.forEach(pathPart => {
+				let skippedEntry = false;
+				for (const pathPart of path) {
 					const previousParent = parent;
 					parent = parent.getChildByName(pathPart);
 					if (parent) {
 						if (!parent.directory) {
-							throw new Error(ERR_ENTRY_EXISTS);
+							if (duplicates == DUPLICATES_KEEP_FIRST) {
+								skippedEntry = true;
+								break;
+							} else if (duplicates == DUPLICATES_KEEP_LAST) {
+								this.fs.remove(parent);
+								parent = new ZipDirectoryEntry(this.fs, pathPart, { data: null }, previousParent);
+								importedEntries.push(parent);
+							} else {
+								throw new Error(ERR_DUPLICATE_IMPORTED_ENTRY);
+							}
 						}
 					} else {
 						parent = new ZipDirectoryEntry(this.fs, pathPart, { data: null }, previousParent);
 						importedEntries.push(parent);
 					}
-				});
+				}
+				if (skippedEntry) {
+					continue;
+				}
 				if (!entry.directory) {
+					const existingChild = parent.getChildByName(name);
+					if (existingChild) {
+						if (duplicates == DUPLICATES_KEEP_FIRST) {
+							continue;
+						} else if (duplicates == DUPLICATES_KEEP_LAST) {
+							this.fs.remove(existingChild);
+						} else {
+							throw new Error(ERR_DUPLICATE_IMPORTED_ENTRY);
+						}
+					}
 					importedEntries.push(addChild(parent, name, {
 						data: entry,
 						Reader: getZipBlobReader(Object.assign({}, options)),
@@ -9929,11 +9962,17 @@ class ZipDirectoryEntry extends ZipEntry {
 					let directoryEntry = parent;
 					if (name) {
 						directoryEntry = parent.getChildByName(name);
-						if (directoryEntry) {
-							if (!directoryEntry.directory) {
-								throw new Error(ERR_ENTRY_EXISTS);
+						if (directoryEntry && !directoryEntry.directory) {
+							if (duplicates == DUPLICATES_KEEP_FIRST) {
+								continue;
+							} else if (duplicates == DUPLICATES_KEEP_LAST) {
+								this.fs.remove(directoryEntry);
+								directoryEntry = UNDEFINED_VALUE;
+							} else {
+								throw new Error(ERR_DUPLICATE_IMPORTED_ENTRY);
 							}
-						} else {
+						}
+						if (!directoryEntry) {
 							directoryEntry = new ZipDirectoryEntry(this.fs, name, { data: null }, parent);
 							importedEntries.push(directoryEntry);
 						}
@@ -9943,6 +9982,7 @@ class ZipDirectoryEntry extends ZipEntry {
 					}
 				}
 			} catch (error) {
+				importedEntries.reverse().forEach(importedEntry => this.fs.remove(importedEntry));
 				try {
 					error.cause = {
 						entry
@@ -10061,7 +10101,7 @@ class ZipFS {
 						}
 					}
 				} else {
-					throw new Error("Entry is a ancestor of target entry");
+					throw new Error(ERR_ANCESTOR_ENTRY);
 				}
 			} else {
 				throw new Error("Target entry is not a directory");
@@ -10073,7 +10113,7 @@ class ZipFS {
 		const path = fullname.split("/");
 		let node = this.root;
 		for (let index = 0; node && index < path.length; index++) {
-			node = node.getChildByName(path[index]);
+			node = node.directory ? node.getChildByName(path[index]) : UNDEFINED_VALUE;
 		}
 		if (!node) {
 			node = this.entries.find(entry => entry && (entry == this.root || entry.isDescendantOf(this.root)) &&
@@ -10135,33 +10175,27 @@ class ZipFS {
 	}
 
 	importBlob(blob, options) {
-		resetFS(this);
-		return this.root.importBlob(blob, options);
+		return resetAndImport(this, root => root.importBlob(blob, options));
 	}
 
 	importData64URI(dataURI, options) {
-		resetFS(this);
-		return this.root.importData64URI(dataURI, options);
+		return resetAndImport(this, root => root.importData64URI(dataURI, options));
 	}
 
 	importUint8Array(array, options) {
-		resetFS(this);
-		return this.root.importUint8Array(array, options);
+		return resetAndImport(this, root => root.importUint8Array(array, options));
 	}
 
 	importHttpContent(url, options) {
-		resetFS(this);
-		return this.root.importHttpContent(url, options);
+		return resetAndImport(this, root => root.importHttpContent(url, options));
 	}
 
 	importReadable(readable, options) {
-		resetFS(this);
-		return this.root.importReadable(readable, options);
+		return resetAndImport(this, root => root.importReadable(readable, options));
 	}
 
 	importZip(reader, options) {
-		resetFS(this);
-		return this.root.importZip(reader, options);
+		return resetAndImport(this, root => root.importZip(reader, options));
 	}
 
 	exportBlob(options) {
@@ -10481,6 +10515,25 @@ function checkReaderOptions(readerOptions) {
 	return readerOptions;
 }
 
+function replaceContent(zipEntry, params) {
+	const { uncompressedSize } = params;
+	Object.assign(zipEntry, params, {
+		reader: null,
+		passThrough: UNDEFINED_VALUE,
+		uncompressedSize: uncompressedSize === UNDEFINED_VALUE ? 0 : uncompressedSize,
+		undeterminedSize: uncompressedSize === UNDEFINED_VALUE
+	});
+}
+
+function getData64URISize(dataURI) {
+	let dataEnd = dataURI.length;
+	while (dataURI.charAt(dataEnd - 1) == "=") {
+		dataEnd--;
+	}
+	const dataStart = dataURI.indexOf(",") + 1;
+	return Math.floor((dataEnd - dataStart) * 0.75);
+}
+
 function isPassThrough(child, options) {
 	const { readerOptions } = options;
 	return Boolean(!child.directory && (child.passThrough || (readerOptions && readerOptions.passThrough)));
@@ -10770,6 +10823,15 @@ function resetFS(fs) {
 	fs.root = new ZipDirectoryEntry(fs);
 }
 
+function resetAndImport(fs, importFunction) {
+	const { entries, entryIdCounter, root } = fs;
+	resetFS(fs);
+	return importFunction(fs.root).catch(error => {
+		Object.assign(fs, { entries, entryIdCounter, root });
+		throw error;
+	});
+}
+
 function collectChildren(directory, recursive) {
 	const children = [];
 	const pendingDirectories = [directory];
@@ -10798,12 +10860,54 @@ function registerEntries(fs, entry) {
 
 function addChild(parent, name, params, directory) {
 	if (parent.directory) {
+		const path = splitPath(name);
+		if (path) {
+			name = path.pop();
+			parent = getPathParent(parent, path);
+		}
 		return directory ? new ZipDirectoryEntry(parent.fs, name, params, parent) : new ZipFileEntry(parent.fs, name, params, parent);
 	} else {
 		throw new Error("Parent entry is not a directory");
 	}
 }
 
+function checkDuplicatesOption(duplicates) {
+	if (duplicates === UNDEFINED_VALUE) {
+		return DUPLICATES_THROW;
+	} else if (DUPLICATES_VALUES.has(duplicates)) {
+		return duplicates;
+	} else {
+		throw new Error(ERR_INVALID_DUPLICATES);
+	}
+}
+
+function splitPath(name) {
+	if (name.includes("/")) {
+		const path = name.split("/").filter(pathPart => pathPart != "" && pathPart != ".");
+		if (path.length) {
+			return path;
+		}
+	}
+}
+
+function getPathParent(parent, path, movedEntry) {
+	path.forEach(pathPart => {
+		const previousParent = parent;
+		parent = parent.getChildByName(pathPart);
+		if (parent) {
+			if (!parent.directory) {
+				throw new Error(ERR_ENTRY_EXISTS);
+			}
+			if (movedEntry && (parent == movedEntry || parent.isDescendantOf(movedEntry))) {
+				throw new Error(ERR_ANCESTOR_ENTRY);
+			}
+		} else {
+			parent = new ZipDirectoryEntry(previousParent.fs, pathPart, { data: null }, previousParent);
+		}
+	});
+	return parent;
+}
+
 const encodedMimeTypes = "application:0andrew-inset ez,2nodex anx,1pplixware aw,1tom!,4cat!,4serv! atomsrv,5vc!,0bbolin lin,0ccxml!,1dmi-capability cdmia,6ontainer cdmic,5domain cdmid,5object cdmio,5queue cdmiq,1u-seeme cu,0davmount!,1ocbook! dbk,1sptype tsp,2sc+der,4! xdssc,0ecmascript es ecma,1mma!,1nvoy evy,1pub+zip,1xi,0font-tdpfr pfr,1ractals fif,1uturesplash spl,0gml!,1px!,1xf,1zip gz tgz,0hta,1yperstudio stk,0inkml! ink inkml,2ternet-property-stream acx,1pfix,0java-archive jar,5serialized-object ser,5vm class,1sonml+json,0lost! lostxml,0m3g,1ac-binhex40 hqx,2ds!,2rc mrc,4xml! mrcx,2thematica nb ma mb,4ml! mathml mml,1box,1ediaservercontrol! mscml,2talink!,84! meta4,3s!,1ods!,1p21 m21 mp21,24 mp4s,1saccess mdb,2word doc dot wiz,1xf,0oda,1ebps-package! opf,1gg ogx,1lescript axs,1mdoc!,1nenote onetoc onetoc2 onetmp onepkg,1xps,0patch-ops-error! xer,1df,1gp-encrypted pgp,4keys key,4signature asc sig,1ics-rules prf,1kcs10 p10,47-mime p7m p7c,6signature p7s,48 p8,2ix-attr-cert ac,5crl crl,5pkipath pkipath,4cmp pki,1ls!,1ostscript ps ai eps epsi epsf eps2 eps3,1rs.cww cww,1skc! pskcxml,0rar,1df!,1eginfo! rif,2lax-ng-compact-syntax rnc,2source-lists! rl,e-diff! rld,1ls-services! rs,1pki-ghostbusters gbr,5manifest mft,5roa roa,1sd!,2s!,1tf,0sbml!,1cvp-cv-request scq,asponse scs,5vp-request spq,asponse spp,1dp,1et-payment-initiation setpay,4registration-initiation setreg,1hf!,1mil! smi smil,1parql-query rq,7results! srx,1rgs gram,4! grxml,2u!,1sdl!,2ml!,0tei! tei teicorpus,1hraud! tfi,1imestamped-data tsd,0vnd.3gpp.pic-bw-large plb,gsmall psb,gvar pvb,82.tcap tcap,5m.post-it-notes pwn,4accpac.simply.aso aso,iimp imp,6ucobol acu,9rp atc acutc,5dobe.air-application-installer-package+zip air,aformscentral.fcdt fcdt,bxp fxp fxpl,axdp! xdp,bfdf xfdf,5head.space ahead,5irzip.filesecure.azf azf,os azs,5mazon.ebook azw,6ericandynamics.acc acc,6iga.ami ami,5ndroid.package-archive apk,6ser-web-certificate-issue-initiation cii,efunds-transfer-initiation fti,6tix.game-component atx,5pple.installer! mpkg,ampegurl m3u8,5ristanetworks.swi swi,5straea-software.iota iota,5udiograph aep,4blueice.multipass mpm,5mi bmi,5usinessobjects rep,4chemdraw! cdxml,6ipnuts.karaoke-mmd mmd,5inderella cdy,5laymore cla,6oanto.rp9 rp9,7nk.c4group c4g c4d c4f c4p c4u,6uetrust.cartomobile-config c11amc,w-pkg c11amz,5ommonspace csp,6ntact.cmsg cdbcmsg,6smocaller cmc,5rick.clicker clkx,h.keyboard clkk,ipalette clkp,itemplate clkt,iwordbank clkw,7ticaltools.wbs! wbs,5tc-posml pml,5ups-ppd ppd,6rl.car car,9pcurl pcurl,4dart dart,6ta-vision.rdz rdz,5ebian.binary-package deb udeb,6ce.data uvf uvvf uvd uvvd,9ttml! uvt uvvt,9unspecified uvx uvvx,9zip uvz uvvz,6novo.fcselayout-link fe_launch,5na dna,5olby.mlp mlp,5pgraph dpg,5reamfactory dfac,5s-keypoint kpxx,5vb.ait ait,8service svc,5ynageo geo,4ecowin.chart mag,5nliven nml,5pson.esf esf,amsf msf,aquickanime qam,asalt slt,bsf ssf,5szigno3! es3 et3,5zpix-album ez2,apackage ez3,4fdf fdf,6sn.mseed mseed,9seed seed dataless,5lographit gph,6uxtime.clip ftc,5ramemaker fm frame maker book,6ogans.fnc fnc,cltf ltf,5sc.weblaunch fsc,5ujitsu.oasys oas,h2 oa2,h3 oa3,hgp fg5,hprs bh2,8xerox.ddd ddd,focuworks xdw,n.binder xbd,6zzysheet fzs,4genomatix.tuxedo txd,6ogebra.file ggb,dtool ggt,7metry-explorer gex gre,7next gxt,7plan g2w,7space g3w,5mx gmx,5oogle-earth.kml! kml,jz kmz,5rafeq gqf gqs,6oove-account gac,bhelp ghf,bidentity-message gim,cnjector grv,btool-message gtm,gtemplate tpl,bvcard vcg,4hal! hal,6ndheld-entertainment! zmm,5bci hbci,5he.lesson-player les,5p-hpgl hpgl,9id hpid,9s hps,7jlyt jlt,7pcl pcl,axl pclxl,5ydrostatix.sof-data sfd-hdstx,5zn-3d-crossword x3d,4ibm.minipay mpy,9odcap afp listafp list3820,8rights-management irm,8secure-container sc,5ccprofile icc icm,5gloader igl,5mmervision-ivp ivp,iu ivu,5nsors.igm igm,6tercon.formnet xpw xpx,9geo i2g,7u.qbo qbo,afx qfx,5punplugged.rcprofile rcprofile,5repository.package! irp,5s-xpr xpr,6ac.fcs fcs,4jam jam,5cp.javame.midlet-rms rms,5isp jisp,5oost.joda-archive joda,4kahootz ktz ktr,5de.karbon karbon,9chart chrt,9formula kfo,9ivio flw,9ontour kon,9presenter kpr kpt,9spread ksp,9word kwd kwt,5enameaapp htke,5idspiration kia,6nar kne knp,5oan skp skd skt skm,6dak-descriptor sse,4las.las! lasxml,5lamagraphics.life-balance.desktop lbd,vexchange! lbe,5otus-1-2-3 123,aapproach apr,afreelance pre,anotes nsf,aorganizer org,ascreencam scm,awordpro lwp,4macports.portpkg portpkg,5cd mcd,5edcalcdata mc1,7iastation.cdkey cdkey,5fer mwf,6mp mfm,5icrografx.flo flo,figx igx,6f mif,5obius.daf daf,cis dis,bmbk mbk,cqy mqy,csl msl,bplc plc,btxf txf,6phun.application mpn,bcertificate mpc,6zilla.xul! xul,5s-artgalry cil,7cab-compressed cab,7excel xls xlb xlt xlm xla xlc xlw,c.addin.macroenabled.12 xlam,dsheet.binary.macroenabled.12 xlsb,jmacroenabled.12 xlsm,dtemplate.macroenabled.12 xltm,7fontobject eot,7htmlhelp chm,7ims ims,7lrm lrm,7officetheme thmx,8utlook msg,7pki.seccat cat,ctl stl,acertstore sst,8owerpoint ppt pps pot ppa pwz,h.addin.macroenabled.12 ppam,ipresentation.macroenabled.12 pptm,islide.macroenabled.12 sldm,nshow.macroenabled.12 ppsm,itemplate.macroenabled.12 potm,8roject mpp mpt,7word.document.macroenabled.12 docm,ctemplate.macroenabled.12 dotm,aks wps wks wcm wdb,8pl wpl,7xpsdocument xps,6eq mseq,5usician mus,6vee.style msty,5ynfc taglet,4neurolanguage.nlu nlu,5itf ntf nitf,5oblenet-directory nnd,dsealer nns,dweb nnw,6kia.n-gage.data ngdat,hsymbian.install n-gage,aradio-preset rpst,ms rpss,6vadigm.edm edm,fx edx,ext ext,4oasis.opendocument.chart odc,s-template otc,ndatabase odb,nformula odf,u-template odft,ngraphics odg,v-template otg,nimage odi,s-template oti,npresentation odp,z-template otp,nspreadsheet ods,y-template ots,ntext odt,r-master odm otm,stemplate ott,sweb oth,5lpc-sugar xo,5ma.dd2! dd2,5penofficeorg.extension oxt,8xmlformats-officedocument.presentationml.presentation pptx,zresentationml.slide sldx,zresentationml.slideshow ppsx,zresentationml.template potx,yspreadsheetml.sheet xlsx,zpreadsheetml.template xltx,ywordprocessingml.document docx,zordprocessingml.template dotx,5sgeo.mapguide.package mgp,7i.dp dp,9subsystem esa,4palm pdb pqa oprc,6waafile paw,5g.format str,7osasli ei6,5icsel efif,5mi.widget wg,5ocketlearn plf,6werbuilder6 pbd,5reviewsystems.box box,6oteus.magazine mgz,5ublishare-delta-tree qps,5vi.ptid1 ptid,4quark.quarkxpress qxd qxt qwd qwt qxl qxb,4realvnc.bed bed,6cordare.musicxml mxl,m! musicxml,5ig.cryptonote cryptonote,5n-realmedia rm,g-vbr rmvb,5oute66.link66! link66,4sailingtracker.track st,5eemail see,6ma sema,7d semd,7f semf,5hana.informed.formdata ifm,ntemplate itp,jinterchange iif,jpackage ipk,5imtech-mindmapper twd twds,5maf mmf,7rt.teacher teacher,5olent.sdkm! sdkm sdkd,5potfire.dxp dxp,dsfs sfs,5qlite3 db sqlite sqlite3 db-wal sqlite-wal db-shm sqlite-shm,5tardivision.calc sdc,ihart sds,hdraw sda,himpress sdd,hmath sdf smf,hwriter sdw vor,n-global sgl,6epmania.package smzip,estepchart sm,5un.xml.calc sxc,g.template stc,cdraw sxd,g.template std,cimpress sxi,j.template sti,cmath sxm,cwriter sxw,i.global sxg,jtemplate stw,6s-calendar sus susp,5vd svd,5ymbian.install sis sisx,6ncml! xsm,a.dm+wbxml bdm,d! xdm,4tao.intent-module-archive tao,5cpdump.pcap pcap cap dmp,5mobile-livetv tmo,5rid.tpt tpt,7scape.mxs mxs,6ueapp tra,4ufdl ufd ufdl,5iq.theme utz,5majin umj,5nity unityweb,5oml! uoml,4vcx vcx,5isio vsd vst vss vsw vsdx vssx vstx vssm vstm,9nary vis,5sf vsf,4wap.sic sic,9lc slc,8wbxml wbxml,9mlc wmlc,bscriptc wmlsc,5ebturbo wtb,5olfram.player nbp,6rdperfect wpd,f5.1 wp5,5qd wqd,5t.stf stf,4xara xar,5fdl xfdl,4yamaha.hv-dic hvd,escript hvs,evoice hvp,bopenscoreformat osf,q.osfpvg! osfpvg,bsmaf-audio saf,gphrase spf,5ellowriver-custom-menu cmp,4zul zir zirz,5zazz.deck! zaz,1oicexml! vxml,0widget wgt,2nhlp hlp,1sdl!,2policy!,0x-123 wk,27z-compressed 7z,2abiword abw,3ce-compressed ace,3pple-diskimage dmg,3uthorware-bin aab x32 u32 vox,dmap aam,dseg aas,2bcpio bcpio,3ittorrent torrent,3lorb blb blorb,3zip bz,62 bz2 boz,2cbr cbr cba cbt cb7,4z cbz,3df cdf cda,4link vcd,3fs-compressed cfs,3hat chat,4ess-pgn pgn,3ompress z,4nference nsc,3pio cpio,3sh csh,2dgc-compressed dgc,3irector dir dxr cst cct cxt w3d fgd swa,3ms dms,3oom wad,3tbncx! ncx,5ook! dtb,5resource! res,3vi dvi,2eva eva,2font-bdf bdf,7ghostscript gsf,7linux-psf psf,7pcf pcf,7snf snf,7ttf ttf ttc,8ype1 pfa pfb pfm afm,3reearc arc,6mind mm,2gca-compressed gca,3lulx ulx,3numeric gnumeric,3o-sgf sgf,3ramps-xml gramps,5phing-calculator gcf,3tar gtar taz,2hdf hdf,3ttpd-eruby rhtml,8php phtml pht php,b-source phps,b3 php3,c-preprocessed php3p,b4 php4,b5 php5,2ica ica,3nfo info,4stall-instructions install,4ternet-signup ins isp,3phone iii,3so9660-image iso,2java-jnlp-file jnlp,3mol jmz,2killustrator kil,3rita kra krz,2latex latex,3yx lyx,3zh-compressed lzh lha,4x lzx,2maker frm fb fbdoc,3ie mie,3obipocket-ebook prc mobi,3s-application application,5installer msi,5shortcut lnk,5wmd wmd,5xbap xbap,4binder obd,4cardfile crd,5lip clp,4dos-program com exe bat dll,4mediaview mvb m13 m14,6tafile wmf wmz emf emz,5oney mny,4publisher pub,4schedule scd,4terminal trm,4write wri,2netcdf nc,3s-proxy-autoconfig pac dat,3wc nwc,3zb nzb,2object o,3z-application oza,2perfmon pma pmc pmr pmw,5l pm pl,3kcs12 p12 pfx,67-certificates p7b spc,creqresp p7r,3ython-code pyc pyo,2qgis qgs shp shx,3uicktimeplayer qtl,2redhat-package-manager rpm rpa,4search-info-systems ris,3uby rb,2sh sh,4ar shar,4ockwave-flash swf swfl,3ilverlight scr,d-app xap,3ql sql,3tuffit sit,9x sitx,3ubrip srt,3v4cpio sv4cpio,6rc sv4crc,2t3vm-image t3,3ar tar,3ex-gf gf,6pk pk,6tfm tfm,5info texinfo texi,3gif obj,3rash ~ % bak old sik,2ustar ustar,2wais-source src,3ingz wz,2x509-ca-cert crt der cer,3cf xcf,3fig fig,3liff! xlf,3pinstall xpi,3z xz,2zmachine z1 z2 z3 z4 z5 z6 z7 z8,1aml!,1cap-diff! xdf,1enc!,1html! xhtml xht,1ml xml xsl xsd xpdl,3-dtd dtd,1op!,1proc! xpl,1slt!,2pf!,1v! mxml xhvml xvml xvm,0yaml yaml yml,2ng,1in!,1nd.ms-pkipko pko,0zip;audio:0aac,1dpcm adp,1iff aiff aif aff,1mr,3-wb awb,1nnodex axa,0basic au snd,0flac,0midi mid midi kar rmi,1p4 mp4a,2eg mpga mpega mp3 m4a mp2a m2a m3a,4url m3u,0ogg oga ogg spx,1pus,0prs.sid sid,0s3m,1ilk sil,0vnd.dece.audio uva uvva,5igital-winds eol,5ra dra,5ts dts,7.hd dtshd,4lucent.voice lvp,4ms-playready.media.pya pya,4nuera.ecelp4800 ecelp4800,f7470 ecelp7470,f9600 ecelp9600,4rip rip,0wav,1ebm weba,0x-aiff aifc,2caf caf,2gsm gsm,2matroska mka,3s-wax wax,6ma wma,2pn-realaudio ram,e-plugin rmp,2realaudio ra,2sd2 sd2,1m;chemical:0x-alchemy alc,2cache cac cache,7-csf csf,5tvs-binary cbin cascii ctab,3dx cdx,3hem3d c3d,3if cif,3mdf cmdf,4l cml,3ompass cpa,3rossfire bsd,3sml csml csm,3tx ctx,3xf cxf cef,2embl-dl-nucleotide emb embl,2gamess-input inp gam gamin,4ussian-checkpoint fch fchk,cube cub,binput gau gjc gjf,blog gal,3cg8-sequence gcg,3enbank gen,2hin hin,2isostar istr ist,2jcamp-dx jdx dx,2kinemage kin,2macmolecule mcm,5romodel-input mmod,3dl-molfile mol,6rdfile rd,7xnfile rxn,6sdfile sd,6tgf tgf,3mcif mcif,3ol2 mol2,5conn-Z b,4pac-graph gpt,8input mop mopcrt zmt,8out moo,2ncbi-asn1 asn,b-ascii prt ent,cbinary val,2rosdal ros,2swissprot sw,2vamas-iso14976 vms,3md vmd,2xtel xtel,3yz xyz;font:0otf,0woff,42;image:0avif avif avifs,0bmp,0cgm,1is-cod cod,0g3fax g3,1if,0heic heif heic,0ief,0jpeg jpeg jpg jpe jfif jfif-tbnl jif,0ktx,0pcx,1jpeg pjpg,1ng,1rs.btif btif,0sgi,1vg! svg svgz,0tiff tiff tif,0vnd.adobe.photoshop psd,4dece.graphic uvi uvvi uvg uvvg,5jvu djvu djv,5wg dwg,5xf dxf,4fastbidsheet fbs,5px fpx,5st fst,5ujixerox.edmics-mmr mmr,lrlc rlc,4ms-modi mdi,7photo wdp,4net-fpx npx,4wap.wbmp wbmp,4xiff xif,0webp,0x-3ds 3ds,2adobe-dng dng,2canon-cr2 cr2,aw crw,3mu-raster ras,4x cmx,3oreldraw cdr,bpattern pat,btemplate cdt,7photopaint cpt,2epson-erf erf,2freehand fh fhc fh4 fh5 fh7,3uji-raf raf,2icns icns,4on ico,2jg art,3ng jng,2kodak-dcr dcr,8k25 k25,9dc kdc,2minolta-mrw mrw,2nikon-nef nef,2olympus-orf orf,2panasonic-raw raw rw2 rwl,3entax-pef pef ptx,3ict pic pct,3ortable-anymap pnm,bbitmap pbm,bgraymap pgm,bpixmap ppm,2rgb rgb,2sigma-x3f x3f,3ony-arw arw,7sr2 sr2,9f srf,2tga tga,2xbitmap xbm,3pixmap xpm,3windowdump xwd;message:0rfc822 eml mime mht mhtml nws;model:0iges igs iges,0mesh msh mesh silo,0vnd.collada! dae,4dwf dwf,4gdl gdl,5tw gtw,4mts mts,4usdz+zip usdz,4vtu vtu,1rml wrl vrml,0x3d+binary x3db x3dbz,4vrml x3dv x3dvz,3! x3dz;text:0cache-manifest manifest appcache,2lendar ics icz ifb,1ss,2v,0h323 323,1tml html htm shtml stm,0iuls uls,0javascript js,1son,0markdown md markdown mdown markdn,0n3,0plain txt text brf conf def list log in bas diff ksh,1rs.lines.tag dsc,0richtext rtx,0scriptlet sct wsc,1gml sgml sgm,0tab-separated-values tsv,1exmacs tm,1roff t tr roff man me ms,1urtle ttl,0uri-list uri uris urls,0vcard,1nd.curl curl,8.dcurl dcurl,9mcurl mcurl,9scurl scurl,4dvb.subtitle sub,4fly fly,5mi.flexstor flx,4graphviz gv,4in3d.3dml 3dml,9spot spot,4sun.j2me.app-descriptor jad,4wap.si si,9l sl,8wml wml,bscript wmls,0webviewhtml htt,0x-asm s asm,2bibtex bib,3oo boo,2c c h dic,3++hdr h++ hpp hxx hh,5src c++ cpp cxx cc,3omponent htc,2diff patch,3src d,2fortran f for f77 f90,2haskell hs,2java java,2literate-haskell lhs,2moc moc,2nfo nfo,2opml opml,2pascal p pas pp inc,3cs-gcd gcd,3ython py,2scala scala,3etext etx,3fv sfv,2tcl tcl tk,3ex tex ltx sty cls,2uuencode uu,2vcalendar vcs,5rd vcf;video:03gpp 3gp,42 3g2,0annodex axv,0dl,1v dif dv,0fli,0gl,0h261,33,34,0jpeg jpgv,2m jpm jpgm,0mj2 mj2 mjp2,1p2t ts,24 mp4 mp4v mpg4,2eg mpeg mpg mpe m1v m2v mp2 mpa mpv2,0ogg ogv,0quicktime qt mov,0vnd.dece.hd uvh uvvh,9mobile uvm uvvm,9pd uvp uvvp,9sd uvs uvvs,9video uvv uvvv,5vb.file dvb,4fvt fvt,4mpegurl mxu m4u,5s-playready.media.pyv pyv,4uvvu.mp4 uvu uvvu,4vivo viv,0webm,0x-f4v f4v,3lv flv,2la-asf lsf lsx,2m4v m4v,3atroska mpv mkv mk3d mks,3ng mng,3s-asf asf asx asr,5vob vob,5wm wm,7v wmv,7x wmx,6vx wvx,4video avi,2sgi-movie movie,3mv smv;x-conference:0x-cooltalk ice;x-world:0x-vrml vrm flr wrz xaf xof";
 
 /*
@@ -10908,6 +11012,7 @@ exports.ERR_AMBIGUOUS_ARCHIVE = ERR_AMBIGUOUS_ARCHIVE;
 exports.ERR_BAD_FORMAT = ERR_BAD_FORMAT;
 exports.ERR_CENTRAL_DIRECTORY_NOT_FOUND = ERR_CENTRAL_DIRECTORY_NOT_FOUND;
 exports.ERR_DUPLICATED_NAME = ERR_DUPLICATED_NAME;
+exports.ERR_DUPLICATE_IMPORTED_ENTRY = ERR_DUPLICATE_IMPORTED_ENTRY;
 exports.ERR_ENCRYPTED = ERR_ENCRYPTED;
 exports.ERR_ENCRYPTED_CENTRAL_DIRECTORY = ERR_ENCRYPTED_CENTRAL_DIRECTORY;
 exports.ERR_ENTRY_DATA_OUT_OF_BOUNDS = ERR_ENTRY_DATA_OUT_OF_BOUNDS;
@@ -10925,6 +11030,7 @@ exports.ERR_INVALID_COMMENT_TYPE = ERR_INVALID_COMMENT_TYPE;
 exports.ERR_INVALID_COMPRESSED_DATA = ERR_INVALID_COMPRESSED_DATA;
 exports.ERR_INVALID_CRC32 = ERR_INVALID_CRC32;
 exports.ERR_INVALID_DATE = ERR_INVALID_DATE;
+exports.ERR_INVALID_DUPLICATES = ERR_INVALID_DUPLICATES;
 exports.ERR_INVALID_ENCRYPTION_STRENGTH = ERR_INVALID_ENCRYPTION_STRENGTH;
 exports.ERR_INVALID_ENTRY_COMMENT = ERR_INVALID_ENTRY_COMMENT;
 exports.ERR_INVALID_ENTRY_COMMENT_TYPE = ERR_INVALID_ENTRY_COMMENT_TYPE;

package/index.d.cts

@@ -1594,10 +1594,17 @@ export interface ZipReaderGetEntriesOptions
 export interface GetEntriesOptions {
   /**
    * The encoding of the filename of the entry.
+   *
+   * The option is ignored when the general purpose bit 11 is set in the header of the entry: such a
+   * filename is always decoded as UTF-8. It is only read when the bit is not set, and the filename is
+   * then decoded as IBM Code Page 437 when the option is not set either.
    */
   filenameEncoding?: string;
   /**
    * The encoding of the comment of the entry.
+   *
+   * The option is ignored when the general purpose bit 11 is set in the header of the entry, see
+   * {@link GetEntriesOptions#filenameEncoding}.
    */
   commentEncoding?: string;
   /**
@@ -3244,6 +3251,10 @@ export interface ZipWriterConstructorOptions extends WorkerConfiguration {
    * Note that this option only sets the flag, it does not ensure that the file names are in the correct
    * encoding: when it is set to `false`, the names are still encoded in UTF-8 unless the
    * {@link ZipWriterConstructorOptions#encodeText} option is also set to encode them in the intended code page.
+   * Setting it to `false` alone therefore produces an archive whose file names are mislabeled, holding UTF-8
+   * bytes announced as Code Page 437: the names holding characters outside of ASCII are decoded incorrectly
+   * by the readers honoring the flag, including {@link ZipReader} unless
+   * {@link GetEntriesOptions#filenameEncoding} is set to `"utf-8"`.
    *
    * @defaultValue true
    */
@@ -3458,6 +3469,10 @@ export interface ZipWriterConstructorOptions extends WorkerConfiguration {
   /**
    * The function called for encoding the filename and the comment of the entry.
    *
+   * zip.js encodes them in UTF-8 when the option is not set, so it must be set to write them in another
+   * code page, together with {@link ZipWriterConstructorOptions#useUnicodeFileNames} set to `false` to
+   * announce them as Code Page 437 instead of UTF-8.
+   *
    * @param text The text to encode.
    * @param type The type of the encoded text, `"filename"` or `"comment"`.
    * @returns The encoded text or `undefined` if the text should be encoded by zip.js.
@@ -3545,6 +3560,9 @@ export class ZipEntry {
    * @remarks It is the size of the raw compressed content when the entry has been imported with the
    * `passThrough` option set to `true`, since the entry holds the compressed data in that case. The
    * uncompressed size of the original entry remains available in {@link ZipEntry#data}.
+   *
+   * It is updated by the `{@link ZipFileEntry}#replace*()` methods, and it is `0` for an entry holding
+   * a `ReadableStream` instance, whose size is only known once the entry has been read.
    */
   uncompressedSize: number;
   /**
@@ -3594,6 +3612,12 @@ export class ZipEntry {
   /**
    * Set the name of the entry
    *
+   * @remarks A name holding `"/"` is split into path components, like the name passed to a
+   * `{@link ZipDirectoryEntry}#add*()` method, so it moves the entry into the directories it names,
+   * creating them when they do not exist. Renaming an entry to the name it already has does nothing.
+   * Renaming it onto an existing sibling throws an {@link ERR_ENTRY_EXISTS} error, and renaming it
+   * into itself or into one of its descendants throws.
+   *
    * @param name The new name of the entry.
    */
   rename(name: string): void;
@@ -3619,6 +3643,11 @@ export class ZipEntry {
 
 /**
  * Represents a file entry in the zip (Filesystem API).
+ *
+ * @remarks A `{@link ZipFileEntry}#replace*()` method describes the entry with the content it is
+ * given: it updates {@link ZipEntry#uncompressedSize} and clears the pass-through state of an entry
+ * imported with the {@link ZipReaderOptions#passThrough} option, since the bytes copied verbatim are
+ * gone. Replacing the content of an entry therefore keeps {@link ZipFS#getExportedSize} exact.
  */
 export class ZipFileEntry<ReaderType, WriterType> extends ZipEntry {
   /**
@@ -3737,6 +3766,10 @@ export class ZipFileEntry<ReaderType, WriterType> extends ZipEntry {
   /**
    * Replaces the content of the entry with a `ReadableStream` instance
    *
+   * @remarks The size of a `ReadableStream` instance is unknown, so the entry reports an undetermined
+   * size, like an entry added with {@link ZipDirectoryEntry#addReadable}. {@link ZipFS#getExportedSize}
+   * then throws an {@link ERR_UNDETERMINED_SIZE} error instead of returning a size it cannot predict.
+   *
    * @param readable The `ReadableStream` instance.
    */
   replaceReadable(readable: ReadableStream): void;
@@ -3744,6 +3777,13 @@ export class ZipFileEntry<ReaderType, WriterType> extends ZipEntry {
 
 /**
  * Represents a directory entry in the zip (Filesystem API).
+ *
+ * @remarks The `name` passed to an `{@link ZipDirectoryEntry}#add*()` method is split into path
+ * components, exactly like the filename of an imported entry, so `addText("a/b.txt", text)` adds
+ * `"b.txt"` to the `"a"` directory and creates that directory when it does not exist. Empty
+ * components and `"."` components are ignored. The directories created that way are navigable like
+ * any other entry but are not written when the tree is exported, so the zip file holds the same
+ * entries whichever way the path was built.
  */
 export class ZipDirectoryEntry extends ZipEntry {
   /**
@@ -3916,7 +3956,7 @@ export class ZipDirectoryEntry extends ZipEntry {
    */
   importBlob(
     blob: Blob,
-    options?: ZipReaderConstructorOptions
+    options?: ZipDirectoryEntryImportOptions
   ): Promise<[ZipEntry]>;
   /**
    * Extracts a zip file provided as a Data URI `string` encoded in Base64 into the entry
@@ -3929,7 +3969,7 @@ export class ZipDirectoryEntry extends ZipEntry {
    */
   importData64URI(
     dataURI: string,
-    options?: ZipReaderConstructorOptions
+    options?: ZipDirectoryEntryImportOptions
   ): Promise<[ZipEntry]>;
   /**
    * Extracts a zip file provided as a `Uint8Array` instance into the entry
@@ -3942,7 +3982,7 @@ export class ZipDirectoryEntry extends ZipEntry {
    */
   importUint8Array(
     array: Uint8Array,
-    options?: ZipReaderConstructorOptions
+    options?: ZipDirectoryEntryImportOptions
   ): Promise<[ZipEntry]>;
   /**
    * Extracts a zip file fetched from a URL into the entry
@@ -3972,7 +4012,7 @@ export class ZipDirectoryEntry extends ZipEntry {
    */
   importReadable(
     readable: ReadableStream,
-    options?: ZipReaderConstructorOptions
+    options?: ZipDirectoryEntryImportOptions
   ): Promise<[ZipEntry]>;
   /**
    * Extracts a zip file provided via a custom {@link Reader} instance or a {@link ZipReader} instance into
@@ -4008,7 +4048,7 @@ export class ZipDirectoryEntry extends ZipEntry {
       | ReadableReader[]
       | ReadableStream[]
       | ZipReader<unknown>,
-    options?: ZipReaderConstructorOptions
+    options?: ZipDirectoryEntryImportOptions
   ): Promise<[ZipEntry]>;
   /**
    * Returns a `Blob` instance containing a zip file of the entry and its descendants
@@ -4112,7 +4152,9 @@ export class ZipDirectoryEntry extends ZipEntry {
    * This happens when `usdz` is set, since the alignment padding depends on the offset of each
    * entry, and when the archive exceeds 4GB, since the offsets recorded in the central directory
    * are then extended to 64 bits. Passing `bufferedWrite: false` makes both determinable again,
-   * as does exporting a directory whose children are all files. It is thrown as well when
+   * as does exporting a directory whose children are all files. A name holding `"/"` creates the
+   * directories it names, so `addText("a/b.txt", text)` builds a tree whose children are not all
+   * files, even though the directories created that way are not written. It is thrown as well when
    * `signCentralDirectory` is set, the length of the signature being unknown until it is computed.
    *
    * @param options The options.
@@ -4122,11 +4164,39 @@ export class ZipDirectoryEntry extends ZipEntry {
   getExportedSize(options?: ZipDirectoryEntryExportOptions): Promise<number>;
 }
 
+/**
+ * Represents the options passed to `{@link ZipDirectoryEntry}#import*()`.
+ */
+export interface ZipDirectoryEntryImportOptions
+  extends ZipReaderConstructorOptions {
+  /**
+   * The policy applied when two entries of the imported zip file claim the same node of the tree
+   *
+   * @remarks
+   * The tree indexes the entries by path, whereas a zip file stores a flat list of filenames, so two
+   * entries can claim one node: they can hold the same filename, hold filenames differing only by the
+   * path components ignored when building the tree (e.g. `"a/b.txt"` and `"./a/b.txt"`), or one can be
+   * a file and the other a directory holding it (e.g. `"a"` and `"a/b.txt"`).
+   *
+   * `"throw"` refuses the zip file with an {@link ERR_DUPLICATE_IMPORTED_ENTRY} error, whose `cause`
+   * property holds the {@link EntryMetaData} instance of the entry that could not be imported. The
+   * filesystem is left unchanged, i.e. the entries imported before the error are removed and the
+   * content held before the import is restored.
+   *
+   * `"keep-first"` ignores the entry claiming a node already taken, and `"keep-last"` replaces the
+   * entry holding the node, which is the behavior of most zip tools. The entries that do not collide
+   * are imported in both cases.
+   *
+   * @defaultValue "throw"
+   */
+  duplicates?: "throw" | "keep-first" | "keep-last";
+}
+
 /**
  * Represents the options passed to {@link ZipDirectoryEntry#importHttpContent}.
  */
 export interface ZipDirectoryEntryImportHttpOptions
-  extends ZipReaderConstructorOptions,
+  extends ZipDirectoryEntryImportOptions,
     HttpOptions {}
 
 /**
@@ -4779,6 +4849,16 @@ export const ERR_ZIP_CRYPTO_LAST_MOD_DATE: string;
  * Entry already exists error (thrown by the filesystem API when adding an entry whose filename already exists)
  */
 export const ERR_ENTRY_EXISTS: string;
+/**
+ * Duplicate imported entry error (thrown by `{@link ZipDirectoryEntry}#import*()` when two entries of the
+ * zip file claim the same node of the tree and the {@link ZipDirectoryEntryImportOptions#duplicates} option
+ * is set to `"throw"`)
+ */
+export const ERR_DUPLICATE_IMPORTED_ENTRY: string;
+/**
+ * Invalid duplicates option error
+ */
+export const ERR_INVALID_DUPLICATES: string;
 /**
  * Readable stream already consumed error (thrown by the filesystem API when a readable stream is read more than once)
  */