@zip.js/zip.js 2.11.1 → 2.11.3

package/index.cjs

@@ -3608,11 +3608,10 @@ class Reader extends Stream {
 				const data = await readUint8Array(reader, offset + chunkOffset, dataSize);
 				if (data.length) {
 					controller.enqueue(data);
+					chunkOffset += data.length;
 				}
-				if ((chunkOffset + chunkSize >= size) || (!data.length && dataSize)) {
+				if ((size !== UNDEFINED_VALUE && chunkOffset >= size) || (!data.length && dataSize)) {
 					controller.close();
-				} else {
-					chunkOffset += chunkSize;
 				}
 			}
 		});
@@ -6267,6 +6266,7 @@ const ERR_INVALID_ENTRY_NAME = "File entry name exceeds 64KB";
 const ERR_INVALID_VERSION = "Version exceeds 65535";
 const ERR_INVALID_ENCRYPTION_STRENGTH = "The strength must equal 1, 2, or 3";
 const ERR_UNSUPPORTED_ENCRYPTION_USDZ = "Encryption is not supported in USDZ files";
+const ERR_UNSUPPORTED_SPLIT_USDZ = "Split zip files are not supported in USDZ files";
 const ERR_UNSUPPORTED_ENCRYPTION_PASS_THROUGH = "Encryption is not supported when the 'passThrough' option is set";
 const ERR_INVALID_EXTRAFIELD = "Invalid extra field (must be a Map)";
 const ERR_INVALID_EXTRAFIELD_TYPE = "Invalid extra field type (must be integer 0..65535)";
@@ -6281,6 +6281,7 @@ const ERR_UNDEFINED_UNCOMPRESSED_SIZE = "Undefined uncompressed size";
 const ERR_UNDEFINED_COMPRESSION_METHOD = "Undefined compression method";
 const ERR_UNDETERMINED_SIZE = "Undetermined size";
 const ERR_UNDEFINED_READER = "Undefined reader";
+const ERR_INVALID_READER = "Invalid reader (must be a Reader instance, a ReadableStream instance, or an object with a 'readable' property)";
 const ERR_ZIP_NOT_EMPTY = "Zip file not empty";
 const ERR_INVALID_UID = "Invalid uid (must be integer 0..2^32-1)";
 const ERR_INVALID_GID = "Invalid gid (must be integer 0..2^32-1)";
@@ -6312,6 +6313,9 @@ class ZipWriter {
 		const addSplitZipSignature =
 			availableSize > 0 && availableSize !== INFINITY_VALUE &&
 			maxSize > 0 && maxSize !== INFINITY_VALUE;
+		if (addSplitZipSignature && options[OPTION_USDZ]) {
+			throw new Error(ERR_UNSUPPORTED_SPLIT_USDZ);
+		}
 		Object.assign(this, {
 			writer,
 			addSplitZipSignature,
@@ -6323,6 +6327,7 @@ class ZipWriter {
 			pendingAddFileCalls: new Set(),
 			pendingErrors: [],
 			bufferedWrites: 0,
+			directWrites: 0,
 			lastFileEntry: UNDEFINED_VALUE
 		});
 	}
@@ -6426,6 +6431,7 @@ class ZipWriter {
 				}
 				const { offset, diskNumberStart } = entryPositions.get(entry);
 				Object.assign(entry, {
+					zip64Enabled: true,
 					zip64UncompressedSize,
 					zip64CompressedSize,
 					offset,
@@ -7001,6 +7007,9 @@ async function resolveSizes(zipWriter, reader, { resolvedOptions: metadata }, op
 	if (reader) {
 		reader = new GenericReader(reader);
 		await initStream(reader);
+		if (!reader.readable && !reader.readUint8Array) {
+			throw new Error(ERR_INVALID_READER);
+		}
 		({ size: contentSize } = reader);
 	}
 	return Object.assign({ reader }, resolveEntrySizes(zipWriter, Boolean(reader), contentSize, metadata, options));
@@ -7011,6 +7020,7 @@ function resolveEntrySizes(zipWriter, hasContent, contentSize, metadata, options
 	let { dataDescriptor, zip64, level, compressionMethod } = metadata;
 	let maximumCompressedSize = 0;
 	let uncompressedSize = 0;
+	let unknownSize = false;
 	if (passThrough && hasContent) {
 		uncompressedSize = options[PROPERTY_NAME_UNCOMPRESSED_SIZE];
 		if (uncompressedSize === UNDEFINED_VALUE) {
@@ -7036,8 +7046,8 @@ function resolveEntrySizes(zipWriter, hasContent, contentSize, metadata, options
 			if (contentSize === UNDEFINED_VALUE) {
 				dataDescriptor = true;
 				if (zip64 || zip64 === UNDEFINED_VALUE) {
-					zip64 = true;
-					uncompressedSize = maximumCompressedSize = MAX_32_BITS + 1;
+					zip64 = unknownSize = true;
+					maximumCompressedSize = MAX_32_BITS + 1;
 				}
 			} else {
 				options.uncompressedSize = uncompressedSize = contentSize;
@@ -7052,7 +7062,7 @@ function resolveEntrySizes(zipWriter, hasContent, contentSize, metadata, options
 	if (emptyEntry && !zipCrypto && getOptionValue(zipWriter, options, OPTION_DATA_DESCRIPTOR) === UNDEFINED_VALUE) {
 		dataDescriptor = false;
 	}
-	const zip64UncompressedSize = zip64Enabled || uncompressedSize >= MAX_32_BITS;
+	const zip64UncompressedSize = zip64Enabled || unknownSize || uncompressedSize >= MAX_32_BITS;
 	const zip64CompressedSize = zip64Enabled || maximumCompressedSize >= MAX_32_BITS;
 	if (zip64UncompressedSize || zip64CompressedSize) {
 		if (zip64 === false) {
@@ -7068,6 +7078,8 @@ function resolveEntrySizes(zipWriter, hasContent, contentSize, metadata, options
 			dataDescriptor,
 			emptyEntry,
 			zip64,
+			zip64Enabled,
+			unknownSize,
 			zip64UncompressedSize,
 			zip64CompressedSize,
 			uncompressedSize,
@@ -7141,7 +7153,7 @@ async function getEntriesSize(writerOptions, entries, writeOrderGuaranteed, comm
 	if (layoutDependsOnWriteOrder && !writeOrderGuaranteed) {
 		throw new Error(ERR_UNDETERMINED_SIZE);
 	}
-	const directoryDataLength = createDirectoryRecords(files);
+	const { directoryDataLength, zip64Entries } = createDirectoryRecords(files);
 	let zip64 = getOptionValue(zipWriter, writerOptions, PROPERTY_NAME_ZIP64);
 	if (offset >= MAX_32_BITS || directoryDataLength >= MAX_32_BITS || files.size >= MAX_16_BITS) {
 		if (zip64 === false) {
@@ -7149,6 +7161,8 @@ async function getEntriesSize(writerOptions, entries, writeOrderGuaranteed, comm
 		} else {
 			zip64 = true;
 		}
+	} else if (zip64 === UNDEFINED_VALUE && zip64Entries) {
+		zip64 = true;
 	}
 	return offset - initialOffset + directoryDataLength + commentLength + (zip64 ? ZIP64_END_OF_CENTRAL_DIR_TOTAL_LENGTH : END_OF_CENTRAL_DIR_LENGTH);
 }
@@ -7173,6 +7187,7 @@ async function getFileEntry(zipWriter, name, reader, entryInfo, options) {
 	const usdz = zipWriter.options[OPTION_USDZ];
 	let fileEntry = pendingFileEntry;
 	let bufferedWrite;
+	let directWrite;
 	let releaseLockWriter;
 	let writingBufferedEntryData;
 	let writingEntryData;
@@ -7182,7 +7197,7 @@ async function getFileEntry(zipWriter, name, reader, entryInfo, options) {
 	const lockPreviousFileEntry = keepOrder && previousFileEntry ? previousFileEntry.lockFileEntry : UNDEFINED_VALUE;
 	fileEntries.set(name, fileEntry);
 	try {
-		if (options.bufferedWrite || !keepOrder || zipWriter.writerLocked || zipWriter.bufferedWrites || (!dataDescriptor && !emptyEntry)) {
+		if (options.bufferedWrite || !keepOrder || zipWriter.writerLocked || zipWriter.bufferedWrites || zipWriter.directWrites || (!dataDescriptor && !emptyEntry)) {
 			bufferedWrite = true;
 			zipWriter.bufferedWrites++;
 			if (options.createTempStream) {
@@ -7193,6 +7208,8 @@ async function getFileEntry(zipWriter, name, reader, entryInfo, options) {
 			fileWriter.size = 0;
 			await initStream(writer);
 		} else {
+			directWrite = true;
+			zipWriter.directWrites++;
 			fileWriter = writer;
 			await lockPreviousFileEntry;
 			await requestLockWriter();
@@ -7271,6 +7288,9 @@ async function getFileEntry(zipWriter, name, reader, entryInfo, options) {
 		if (bufferedWrite) {
 			zipWriter.bufferedWrites--;
 		}
+		if (directWrite) {
+			zipWriter.directWrites--;
+		}
 		if (releaseLockFileEntry) {
 			releaseLockFileEntry(lockPreviousFileEntry);
 		}
@@ -7335,6 +7355,7 @@ async function createFileEntry(reader, writer, { diskNumberStart, lockFileEntry
 		rawPassword,
 		level,
 		zip64,
+		zip64Enabled,
 		zip64UncompressedSize,
 		zip64CompressedSize,
 		zipCrypto,
@@ -7375,6 +7396,7 @@ async function createFileEntry(reader, writer, { diskNumberStart, lockFileEntry
 		lockFileEntry,
 		versionMadeBy,
 		zip64,
+		zip64Enabled,
 		directory: Boolean(directory),
 		executable: Boolean(executable),
 		filenameUTF8: true,
@@ -7415,8 +7437,8 @@ async function createFileEntry(reader, writer, { diskNumberStart, lockFileEntry
 	}
 	const { writable } = writer;
 	if (reader) {
-		const readable = toCompatibleReadable(createReadable(reader));
 		const size = reader.size;
+		const readable = toCompatibleReadable(createReadable(reader, { size }));
 		const workerOptions = {
 			options: {
 				codecType: CODEC_DEFLATE,
@@ -7518,13 +7540,14 @@ function getHeaderInfo(options) {
 		zip64UncompressedSize,
 		zip64CompressedSize,
 		uncompressedSize,
+		unknownSize,
 		crc32
 	} = options;
 	let { version, compressionMethod } = options;
 	const compressed = !directory && isCompressed(compressionMethod, level);
 	let rawLocalExtraFieldZip64;
 	const uncompressedFile = passThrough || !compressed;
-	const zip64ExtraFieldComplete = zip64 && (options.bufferedWrite || !dataDescriptor || ((!zip64UncompressedSize && !zip64CompressedSize) || uncompressedFile));
+	const zip64ExtraFieldComplete = zip64 && (options.bufferedWrite || !dataDescriptor || ((!zip64UncompressedSize && !zip64CompressedSize) || (uncompressedFile && !unknownSize)));
 	const writeLocalExtraFieldZip64 = zip64ExtraFieldComplete || (zip64 && dataDescriptor && (zip64UncompressedSize || zip64CompressedSize));
 	if (zip64 && (zip64UncompressedSize || zip64CompressedSize)) {
 		const length = 4 + 16;
@@ -7658,6 +7681,10 @@ function getHeaderInfo(options) {
 		throw new Error(ERR_INVALID_EXTRAFIELD_DATA);
 	}
 	const dosLastModDate = new Date(Math.ceil(Math.floor(lastModDate.getTime() / 1000) / 2) * 2000);
+	const clampedLastModDate = dosLastModDate < MIN_DATE ? MIN_DATE : dosLastModDate > MAX_DATE ? MAX_DATE : dosLastModDate;
+	const storedLastModDate = getLength(rawExtraFieldExtendedTimestamp) ?
+		new Date(getTimeUnix(lastModDate) * 1000) :
+		getLength(rawExtraFieldNTFS) ? lastModDate : clampedLastModDate;
 	const {
 		headerArray,
 		headerView,
@@ -7667,7 +7694,7 @@ function getHeaderInfo(options) {
 		bitFlag: getBitFlag(level, useUnicodeFileNames, dataDescriptor, encrypted, compressionMethod),
 		compressionMethod,
 		uncompressedSize,
-		lastModDate: dosLastModDate < MIN_DATE ? MIN_DATE : dosLastModDate > MAX_DATE ? MAX_DATE : dosLastModDate,
+		lastModDate: clampedLastModDate,
 		rawLastModDate: rawLastModDateOption,
 		rawFilename,
 		zip64CompressedSize,
@@ -7702,7 +7729,7 @@ function getHeaderInfo(options) {
 		localHeaderView,
 		headerArray,
 		headerView,
-		lastModDate,
+		lastModDate: storedLastModDate,
 		rawLastModDate,
 		encrypted,
 		compressed,
@@ -7874,14 +7901,15 @@ function updateLocalHeader({
 
 
 async function closeFile(zipWriter, comment, options) {
-	const directoryDataLength = createDirectoryRecords(zipWriter.fileEntries);
+	const { directoryDataLength, zip64Entries } = createDirectoryRecords(zipWriter.fileEntries);
 	const { directoryStart, directoryEnd, directoryArray } = await writeDirectoryRecords(zipWriter, directoryDataLength, options);
 	const signatureLength = await writeDigitalSignatureRecord(zipWriter, directoryArray, options);
-	await writeEndOfDirectoryRecord(zipWriter, comment, options, { directoryStart, directoryEnd, directoryDataLength, signatureLength });
+	await writeEndOfDirectoryRecord(zipWriter, comment, options, { directoryStart, directoryEnd, directoryDataLength, signatureLength, zip64Entries });
 }
 
 function createDirectoryRecords(files) {
 	let directoryDataLength = 0;
+	let zip64Entries = false;
 	for (const [, fileEntry] of files) {
 		const {
 			rawFilename,
@@ -7894,11 +7922,20 @@ function createDirectoryRecords(files) {
 			extendedTimestamp,
 			extraFieldExtendedTimestampFlag,
 			lastModDate,
-			zip64UncompressedSize,
-			zip64CompressedSize,
+			zip64Enabled,
 			uncompressedSize,
 			compressedSize
 		} = fileEntry;
+		let { zip64UncompressedSize, zip64CompressedSize } = fileEntry;
+		if (!zip64Enabled) {
+			if (zip64UncompressedSize && uncompressedSize < MAX_32_BITS) {
+				zip64UncompressedSize = fileEntry.zip64UncompressedSize = false;
+			}
+			if (zip64CompressedSize && compressedSize < MAX_32_BITS) {
+				zip64CompressedSize = fileEntry.zip64CompressedSize = false;
+			}
+		}
+		zip64Entries = zip64Entries || zip64UncompressedSize || zip64CompressedSize;
 		const zip64Offset = fileEntry.offset >= MAX_32_BITS;
 		const zip64DiskNumberStart = fileEntry.diskNumberStart >= MAX_16_BITS;
 		let rawExtraFieldZip64;
@@ -7952,7 +7989,7 @@ function createDirectoryRecords(files) {
 		}
 		directoryDataLength += CENTRAL_FILE_HEADER_LENGTH + getLength(rawFilename, rawComment) + extraFieldLength;
 	}
-	return directoryDataLength;
+	return { directoryDataLength, zip64Entries };
 }
 
 async function writeDirectoryRecords(zipWriter, directoryDataLength, options) {
@@ -8072,7 +8109,7 @@ async function writeDigitalSignatureRecord(zipWriter, directoryArray, options) {
 
 async function writeEndOfDirectoryRecord(zipWriter, comment, options, cdInfo) {
 	const { writer } = zipWriter;
-	const { directoryStart, directoryEnd, signatureLength } = cdInfo;
+	const { directoryStart, directoryEnd, signatureLength, zip64Entries } = cdInfo;
 	let { directoryDataLength } = cdInfo;
 	let fileEntriesLength = zipWriter.fileEntries.size;
 	let diskNumber = directoryStart.diskNumber;
@@ -8092,6 +8129,8 @@ async function writeEndOfDirectoryRecord(zipWriter, comment, options, cdInfo) {
 		} else {
 			zip64 = true;
 		}
+	} else if (zip64 === UNDEFINED_VALUE && zip64Entries) {
+		zip64 = true;
 	}
 	const endOfdirectoryRecord = createRecordWriter(zip64 ? ZIP64_END_OF_CENTRAL_DIR_TOTAL_LENGTH : END_OF_CENTRAL_DIR_LENGTH);
 	if (exceedsAvailableSize(writer, getLength(endOfdirectoryRecord.array) + commentLength)) {
@@ -8595,7 +8634,7 @@ function formatSupported(StreamClass, format) {
  EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
-const VERSION = "2.11.1";
+const VERSION = "2.11.3";
 
 /*
  Copyright (c) 2025 Gildas Lormeau. All rights reserved.
@@ -9991,12 +10030,14 @@ class ZipDirectoryEntry extends ZipEntry {
 		if (options.bufferedWrite === UNDEFINED_VALUE) {
 			options.bufferedWrite = true;
 		}
-		const entries = zipEntry.getChildren({ recursive: true }).filter(child => !isImplicitDirectory(child)).map(child => {
+		const children = zipEntry.getChildren({ recursive: true });
+		const entries = children.filter(child => !isImplicitDirectory(child)).map(child => {
 			const { name, entryOptions } = getChildEntryOptions(child, zipEntry, options);
 			return { name, size: child.directory ? 0 : getDeterminedSize(child, isPassThrough(child, options)), options: entryOptions };
 		});
 		const writeOrderGuaranteed = !options.bufferedWrite ||
-			(entries.every(entry => entry.options.keepOrder !== false) && zipEntry.children.every(child => !child.children.length));
+			(entries.every(entry => entry.options.keepOrder !== false) &&
+				children.every(child => isImplicitDirectory(child) || !child.children.length));
 		return getEntriesSize(options, entries, writeOrderGuaranteed, options.globalComment);
 	}
 
@@ -11025,6 +11066,7 @@ exports.ERR_INVALID_MSDOS_DATA = ERR_INVALID_MSDOS_DATA;
 exports.ERR_INVALID_PASSWORD = ERR_INVALID_PASSWORD;
 exports.ERR_INVALID_PASSWORD_TYPE = ERR_INVALID_PASSWORD_TYPE;
 exports.ERR_INVALID_PASS_THROUGH = ERR_INVALID_PASS_THROUGH;
+exports.ERR_INVALID_READER = ERR_INVALID_READER;
 exports.ERR_INVALID_READER_OPTIONS = ERR_INVALID_READER_OPTIONS;
 exports.ERR_INVALID_SIGNAL = ERR_INVALID_SIGNAL;
 exports.ERR_INVALID_SIGNATURE_DATA = ERR_INVALID_SIGNATURE_DATA;
@@ -11053,6 +11095,7 @@ exports.ERR_UNSUPPORTED_ENCRYPTION = ERR_UNSUPPORTED_ENCRYPTION;
 exports.ERR_UNSUPPORTED_ENCRYPTION_PASS_THROUGH = ERR_UNSUPPORTED_ENCRYPTION_PASS_THROUGH;
 exports.ERR_UNSUPPORTED_ENCRYPTION_USDZ = ERR_UNSUPPORTED_ENCRYPTION_USDZ;
 exports.ERR_UNSUPPORTED_FORMAT = ERR_UNSUPPORTED_FORMAT;
+exports.ERR_UNSUPPORTED_SPLIT_USDZ = ERR_UNSUPPORTED_SPLIT_USDZ;
 exports.ERR_UNSUPPORTED_UINT64 = ERR_UNSUPPORTED_UINT64;
 exports.ERR_WORKER_STARTUP_TIMEOUT = ERR_WORKER_STARTUP_TIMEOUT;
 exports.ERR_WRITER_NOT_INITIALIZED = ERR_WRITER_NOT_INITIALIZED;

package/index.d.cts

@@ -161,7 +161,7 @@
 /**
  * Represents the `FileSystemEntry` class.
  *
- * @see {@link https://wicg.github.io/entries-api/#api-entry|specification}
+ * @see {@link https://wicg.github.io/entries-api/#api-entry}
  */
 // deno-lint-ignore no-empty-interface
 interface FileSystemEntryLike {}
@@ -177,7 +177,7 @@ interface FileSystemHandleLike {}
 /**
  * Represents a generic `TransformStream` class.
  *
- * @see {@link https://streams.spec.whatwg.org/#generictransformstream|specification}
+ * @see {@link https://streams.spec.whatwg.org/#generictransformstream}
  */
 declare class TransformStreamLike {
   /**
@@ -3027,6 +3027,8 @@ export interface ZipWriterCloseOptions extends EntryOnprogressOptions {
   /**
    * `true` to use Zip64 to write the entries directory.
    *
+   * Zip64 is also used when the directory does not fit in the standard record, or when an entry is stored with Zip64.
+   *
    * @defaultValue false
    */
   zip64?: boolean;
@@ -3059,6 +3061,8 @@ export interface ZipWriterConstructorOptions extends WorkerConfiguration {
    * `true` to use Zip64 to store the entry.
    *
    * `zip64` is automatically set to `true` when necessary (e.g. compressed data larger than 4GB or with unknown size).
+   * An entry of unknown size is stored with Zip64 in its local header, because the size of the data descriptor must be
+   * chosen before writing the data. Its central directory record drops Zip64 when the actual sizes fit in 32 bits.
    *
    * @defaultValue false
    */
@@ -3080,6 +3084,12 @@ export interface ZipWriterConstructorOptions extends WorkerConfiguration {
    * between platforms. Set `useCompressionStream` to `false` to get deterministic output across
    * platforms.
    *
+   * When no deflate implementation is available at all, i.e. the environment provides no usable
+   * `CompressionStream` and the embedded implementation cannot be loaded, the entry is stored
+   * instead of being compressed rather than failing. The {@link EntryMetaData#compressionMethod} of
+   * the entry returned by {@link ZipWriter#add} is `0` in that case, which is how the fallback is
+   * detected.
+   *
    * @defaultValue 6
    */
   level?: number;
@@ -3112,10 +3122,9 @@ export interface ZipWriterConstructorOptions extends WorkerConfiguration {
    * `true` to keep the order of the entry physically in the zip file.
    *
    * @remarks
-   * The entries are then written one after another, so concurrent calls to {@link ZipWriter#add} compress one
-   * entry at a time and use a single web worker. Set {@link ZipWriterConstructorOptions#bufferedWrite} to `true`
-   * to compress them concurrently while still keeping the order, at the cost of buffering each entry until the
-   * previous ones are written.
+   * The entries are then written one after another, but concurrent calls to {@link ZipWriter#add} still compress
+   * concurrently: one entry is written directly into the zip file while the others are buffered until it is their
+   * turn, i.e. {@link ZipWriterConstructorOptions#bufferedWrite} is set automatically for them.
    *
    * @defaultValue true
    */
@@ -3390,6 +3399,8 @@ export interface ZipWriterConstructorOptions extends WorkerConfiguration {
    * boundaries and stored uncompressed unless the {@link ZipWriterConstructorOptions#level} or
    * {@link ZipWriterAddDataOptions#compressionMethod} options are set explicitly. Setting the
    * {@link ZipWriterConstructorOptions#password} option throws an {@link ERR_UNSUPPORTED_ENCRYPTION_USDZ} error.
+   * Writing into a split zip file throws an {@link ERR_UNSUPPORTED_SPLIT_USDZ} error, since the 64-byte alignment
+   * of an entry is invalidated when the disk it is written into rolls over.
    *
    * These constraints apply to the entries written with {@link ZipWriter#add} only. The entries copied with
    * {@link ZipWriter#appendZip} keep the layout of the source zip file and are not checked, so appending a
@@ -4635,6 +4646,10 @@ export const ERR_INVALID_ENCRYPTION_STRENGTH: string;
  * Unsupported encryption in USDZ files error
  */
 export const ERR_UNSUPPORTED_ENCRYPTION_USDZ: string;
+/**
+ * Unsupported split zip file in USDZ files error
+ */
+export const ERR_UNSUPPORTED_SPLIT_USDZ: string;
 /**
  * Unsupported encryption in pass-through entries error
  */
@@ -4729,6 +4744,15 @@ export const ERR_UNDETERMINED_SIZE: string;
  * is not there. Directory entries are exempt, they have no content to write as-is.
  */
 export const ERR_UNDEFINED_READER: string;
+/**
+ * Invalid reader error
+ *
+ * @remarks Thrown when the second argument of {@link ZipWriter#add} is neither a {@link Reader} instance, a
+ * `ReadableStream` instance, nor an object exposing a `readable` property. A `Blob`, a string or a
+ * `Uint8Array` must be wrapped in the matching Reader class, e.g. {@link BlobReader}, {@link TextReader}
+ * or {@link Uint8ArrayReader}.
+ */
+export const ERR_INVALID_READER: string;
 /**
  * Writer not initialized error
  */

package/index.d.ts

@@ -161,7 +161,7 @@
 /**
  * Represents the `FileSystemEntry` class.
  *
- * @see {@link https://wicg.github.io/entries-api/#api-entry|specification}
+ * @see {@link https://wicg.github.io/entries-api/#api-entry}
  */
 // deno-lint-ignore no-empty-interface
 interface FileSystemEntryLike {}
@@ -177,7 +177,7 @@ interface FileSystemHandleLike {}
 /**
  * Represents a generic `TransformStream` class.
  *
- * @see {@link https://streams.spec.whatwg.org/#generictransformstream|specification}
+ * @see {@link https://streams.spec.whatwg.org/#generictransformstream}
  */
 declare class TransformStreamLike {
   /**
@@ -3027,6 +3027,8 @@ export interface ZipWriterCloseOptions extends EntryOnprogressOptions {
   /**
    * `true` to use Zip64 to write the entries directory.
    *
+   * Zip64 is also used when the directory does not fit in the standard record, or when an entry is stored with Zip64.
+   *
    * @defaultValue false
    */
   zip64?: boolean;
@@ -3059,6 +3061,8 @@ export interface ZipWriterConstructorOptions extends WorkerConfiguration {
    * `true` to use Zip64 to store the entry.
    *
    * `zip64` is automatically set to `true` when necessary (e.g. compressed data larger than 4GB or with unknown size).
+   * An entry of unknown size is stored with Zip64 in its local header, because the size of the data descriptor must be
+   * chosen before writing the data. Its central directory record drops Zip64 when the actual sizes fit in 32 bits.
    *
    * @defaultValue false
    */
@@ -3080,6 +3084,12 @@ export interface ZipWriterConstructorOptions extends WorkerConfiguration {
    * between platforms. Set `useCompressionStream` to `false` to get deterministic output across
    * platforms.
    *
+   * When no deflate implementation is available at all, i.e. the environment provides no usable
+   * `CompressionStream` and the embedded implementation cannot be loaded, the entry is stored
+   * instead of being compressed rather than failing. The {@link EntryMetaData#compressionMethod} of
+   * the entry returned by {@link ZipWriter#add} is `0` in that case, which is how the fallback is
+   * detected.
+   *
    * @defaultValue 6
    */
   level?: number;
@@ -3112,10 +3122,9 @@ export interface ZipWriterConstructorOptions extends WorkerConfiguration {
    * `true` to keep the order of the entry physically in the zip file.
    *
    * @remarks
-   * The entries are then written one after another, so concurrent calls to {@link ZipWriter#add} compress one
-   * entry at a time and use a single web worker. Set {@link ZipWriterConstructorOptions#bufferedWrite} to `true`
-   * to compress them concurrently while still keeping the order, at the cost of buffering each entry until the
-   * previous ones are written.
+   * The entries are then written one after another, but concurrent calls to {@link ZipWriter#add} still compress
+   * concurrently: one entry is written directly into the zip file while the others are buffered until it is their
+   * turn, i.e. {@link ZipWriterConstructorOptions#bufferedWrite} is set automatically for them.
    *
    * @defaultValue true
    */
@@ -3390,6 +3399,8 @@ export interface ZipWriterConstructorOptions extends WorkerConfiguration {
    * boundaries and stored uncompressed unless the {@link ZipWriterConstructorOptions#level} or
    * {@link ZipWriterAddDataOptions#compressionMethod} options are set explicitly. Setting the
    * {@link ZipWriterConstructorOptions#password} option throws an {@link ERR_UNSUPPORTED_ENCRYPTION_USDZ} error.
+   * Writing into a split zip file throws an {@link ERR_UNSUPPORTED_SPLIT_USDZ} error, since the 64-byte alignment
+   * of an entry is invalidated when the disk it is written into rolls over.
    *
    * These constraints apply to the entries written with {@link ZipWriter#add} only. The entries copied with
    * {@link ZipWriter#appendZip} keep the layout of the source zip file and are not checked, so appending a
@@ -4635,6 +4646,10 @@ export const ERR_INVALID_ENCRYPTION_STRENGTH: string;
  * Unsupported encryption in USDZ files error
  */
 export const ERR_UNSUPPORTED_ENCRYPTION_USDZ: string;
+/**
+ * Unsupported split zip file in USDZ files error
+ */
+export const ERR_UNSUPPORTED_SPLIT_USDZ: string;
 /**
  * Unsupported encryption in pass-through entries error
  */
@@ -4729,6 +4744,15 @@ export const ERR_UNDETERMINED_SIZE: string;
  * is not there. Directory entries are exempt, they have no content to write as-is.
  */
 export const ERR_UNDEFINED_READER: string;
+/**
+ * Invalid reader error
+ *
+ * @remarks Thrown when the second argument of {@link ZipWriter#add} is neither a {@link Reader} instance, a
+ * `ReadableStream` instance, nor an object exposing a `readable` property. A `Blob`, a string or a
+ * `Uint8Array` must be wrapped in the matching Reader class, e.g. {@link BlobReader}, {@link TextReader}
+ * or {@link Uint8ArrayReader}.
+ */
+export const ERR_INVALID_READER: string;
 /**
  * Writer not initialized error
  */