@zip.js/zip.js 2.7.47 → 2.7.49

package/index.cjs

@@ -9205,7 +9205,7 @@ const PROPERTY_NAMES = [
 	PROPERTY_NAME_MS_DOS_COMPATIBLE, PROPERTY_NAME_ZIP64,
 	"directory", "bitFlag", "encrypted", "signature", "filenameUTF8", "commentUTF8", "compressionMethod", "version", "versionMadeBy",
 	"extraField", "rawExtraField", "extraFieldZip64", "extraFieldUnicodePath", "extraFieldUnicodeComment", "extraFieldAES", "extraFieldNTFS",
-	"extraFieldExtendedTimestamp"];
+	"extraFieldExtendedTimestamp", "zipCrypto"];
 
 class Entry {
 
@@ -9440,6 +9440,7 @@ class ZipReader {
 			});
 			startOffset = Math.max(offsetFileEntry, startOffset);
 			await readCommonFooter(fileEntry, fileEntry, directoryView, offset + 6);
+			fileEntry.zipCrypto = fileEntry.encrypted && !fileEntry.extraFieldAES;
 			const entry = new Entry(fileEntry);
 			entry.getData = (writer, options) => fileEntry.getData(writer, entry, options);
 			offset = endOffset;
@@ -9557,8 +9558,12 @@ let ZipEntry$1 = class ZipEntry {
 			lastAccessDate: localDirectory.lastAccessDate,
 			creationDate: localDirectory.creationDate
 		});
-		const encrypted = zipEntry.encrypted && localDirectory.encrypted;
+		const passThrough = getOptionValue$1(zipEntry, options, "passThrough");
+		const encrypted = zipEntry.encrypted && localDirectory.encrypted && !passThrough;
 		const zipCrypto = encrypted && !extraFieldAES;
+		if (!passThrough) {
+			fileEntry.zipCrypto = zipCrypto;
+		}
 		if (encrypted) {
 			if (!zipCrypto && extraFieldAES.strength === UNDEFINED_VALUE) {
 				throw new Error(ERR_UNSUPPORTED_ENCRYPTION);
@@ -9590,11 +9595,11 @@ let ZipEntry$1 = class ZipEntry {
 				rawPassword,
 				zipCrypto,
 				encryptionStrength: extraFieldAES && extraFieldAES.strength,
-				signed: getOptionValue$1(zipEntry, options, "checkSignature"),
+				signed: getOptionValue$1(zipEntry, options, "checkSignature") && !passThrough,
 				passwordVerification: zipCrypto && (bitFlag.dataDescriptor ? ((rawLastModDate >>> 8) & 0xFF) : ((signature >>> 24) & 0xFF)),
 				signature,
-				compressed: compressionMethod != 0,
-				encrypted,
+				compressed: compressionMethod != 0 && !passThrough,
+				encrypted: zipEntry.encrypted && !passThrough,
 				useWebWorkers: getOptionValue$1(zipEntry, options, "useWebWorkers"),
 				useCompressionStream: getOptionValue$1(zipEntry, options, "useCompressionStream"),
 				transferStreams: getOptionValue$1(zipEntry, options, "transferStreams"),
@@ -9923,6 +9928,7 @@ const ERR_INVALID_ENCRYPTION_STRENGTH = "The strength must equal 1, 2, or 3";
 const ERR_INVALID_EXTRAFIELD_TYPE = "Extra field type exceeds 65535";
 const ERR_INVALID_EXTRAFIELD_DATA = "Extra field data exceeds 64KB";
 const ERR_UNSUPPORTED_FORMAT = "Zip64 is not supported (make sure 'keepOrder' is set to 'true')";
+const ERR_UNDEFINED_UNCOMPRESSED_SIZE = "Undefined uncompressed size";
 
 const EXTRAFIELD_DATA_AES = new Uint8Array([0x07, 0x00, 0x02, 0x00, 0x41, 0x45, 0x03, 0x00, 0x00]);
 
@@ -10065,8 +10071,12 @@ async function addFile(zipWriter, name, reader, options) {
 	const msDosCompatible = getOptionValue(zipWriter, options, PROPERTY_NAME_MS_DOS_COMPATIBLE, true);
 	const internalFileAttribute = getOptionValue(zipWriter, options, PROPERTY_NAME_INTERNAL_FILE_ATTRIBUTE, 0);
 	const externalFileAttribute = getOptionValue(zipWriter, options, PROPERTY_NAME_EXTERNAL_FILE_ATTRIBUTE, 0);
-	const password = getOptionValue(zipWriter, options, "password");
-	const rawPassword = getOptionValue(zipWriter, options, "rawPassword");
+	const passThrough = getOptionValue(zipWriter, options, "passThrough");
+	let password, rawPassword;
+	if (!passThrough) {
+		password = getOptionValue(zipWriter, options, "password");
+		rawPassword = getOptionValue(zipWriter, options, "rawPassword");
+	}
 	const encryptionStrength = getOptionValue(zipWriter, options, "encryptionStrength", 3);
 	const zipCrypto = getOptionValue(zipWriter, options, "zipCrypto");
 	const extendedTimestamp = getOptionValue(zipWriter, options, "extendedTimestamp", true);
@@ -10076,10 +10086,11 @@ async function addFile(zipWriter, name, reader, options) {
 	const bufferedWrite = getOptionValue(zipWriter, options, "bufferedWrite");
 	const dataDescriptorSignature = getOptionValue(zipWriter, options, "dataDescriptorSignature", false);
 	const signal = getOptionValue(zipWriter, options, "signal");
+	const useUnicodeFileNames = getOptionValue(zipWriter, options, "useUnicodeFileNames", true);
 	const useCompressionStream = getOptionValue(zipWriter, options, "useCompressionStream");
 	let dataDescriptor = getOptionValue(zipWriter, options, "dataDescriptor", true);
 	let zip64 = getOptionValue(zipWriter, options, PROPERTY_NAME_ZIP64);
-	if (password !== UNDEFINED_VALUE && encryptionStrength !== UNDEFINED_VALUE && (encryptionStrength < 1 || encryptionStrength > 3)) {
+	if ((password !== UNDEFINED_VALUE || rawPassword !== UNDEFINED_VALUE) && encryptionStrength !== UNDEFINED_VALUE && (encryptionStrength < 1 || encryptionStrength > 3)) {
 		throw new Error(ERR_INVALID_ENCRYPTION_STRENGTH);
 	}
 	let rawExtraField = new Uint8Array();
@@ -10105,18 +10116,28 @@ async function addFile(zipWriter, name, reader, options) {
 	let maximumCompressedSize = 0;
 	let maximumEntrySize = 0;
 	let uncompressedSize = 0;
+	if (passThrough) {
+		({ uncompressedSize } = options);
+		if (uncompressedSize === UNDEFINED_VALUE) {
+			throw new Error(ERR_UNDEFINED_UNCOMPRESSED_SIZE);
+		}
+	}
 	const zip64Enabled = zip64 === true;
 	if (reader) {
 		reader = initReader(reader);
 		await initStream(reader);
-		if (reader.size === UNDEFINED_VALUE) {
-			dataDescriptor = true;
-			if (zip64 || zip64 === UNDEFINED_VALUE) {
-				zip64 = true;
-				uncompressedSize = maximumCompressedSize = MAX_32_BITS + 1;
+		if (!passThrough) {
+			if (reader.size === UNDEFINED_VALUE) {
+				dataDescriptor = true;
+				if (zip64 || zip64 === UNDEFINED_VALUE) {
+					zip64 = true;
+					uncompressedSize = maximumCompressedSize = MAX_32_BITS + 1;
+				}
+			} else {
+				uncompressedSize = reader.size;
+				maximumCompressedSize = getMaximumCompressedSize(uncompressedSize);
 			}
 		} else {
-			uncompressedSize = reader.size;
 			maximumCompressedSize = getMaximumCompressedSize(uncompressedSize);
 		}
 	}
@@ -10134,6 +10155,8 @@ async function addFile(zipWriter, name, reader, options) {
 		}
 	}
 	zip64 = zip64 || false;
+	const encrypted = getOptionValue(zipWriter, options, "encrypted");
+	const { signature } = options;
 	options = Object.assign({}, options, {
 		rawFilename,
 		rawComment,
@@ -10157,13 +10180,17 @@ async function addFile(zipWriter, name, reader, options) {
 		zipCrypto,
 		bufferedWrite,
 		keepOrder,
+		useUnicodeFileNames,
 		dataDescriptor,
 		dataDescriptorSignature,
 		signal,
 		msDosCompatible,
 		internalFileAttribute,
 		externalFileAttribute,
-		useCompressionStream
+		useCompressionStream,
+		passThrough,
+		encrypted: Boolean((password && getLength(password)) || (rawPassword && getLength(rawPassword))) || (passThrough && encrypted),
+		signature
 	});
 	const headerInfo = getHeaderInfo(options);
 	const dataDescriptorInfo = getDataDescriptorInfo(options);
@@ -10374,7 +10401,8 @@ async function createFileEntry(reader, writer, { diskNumberStart, lock }, entryI
 		msDosCompatible,
 		internalFileAttribute,
 		externalFileAttribute,
-		useCompressionStream
+		useCompressionStream,
+		passThrough
 	} = options;
 	const fileEntry = {
 		lock,
@@ -10395,9 +10423,14 @@ async function createFileEntry(reader, writer, { diskNumberStart, lock }, entryI
 		externalFileAttribute,
 		diskNumberStart
 	};
+	let {
+		signature,
+		uncompressedSize
+	} = options;
 	let compressedSize = 0;
-	let uncompressedSize = 0;
-	let signature;
+	if (!passThrough) {
+		uncompressedSize = 0;
+	}
 	const { writable } = writer;
 	if (reader) {
 		reader.chunkSize = getChunkSize(config);
@@ -10413,9 +10446,9 @@ async function createFileEntry(reader, writer, { diskNumberStart, lock }, entryI
 				encryptionStrength,
 				zipCrypto: encrypted && zipCrypto,
 				passwordVerification: encrypted && zipCrypto && (rawLastModDate >> 8) & 0xFF,
-				signed: true,
-				compressed,
-				encrypted,
+				signed: !passThrough,
+				compressed: compressed && !passThrough,
+				encrypted: encrypted && !passThrough,
 				useWebWorkers,
 				useCompressionStream,
 				transferStreams: false
@@ -10424,9 +10457,11 @@ async function createFileEntry(reader, writer, { diskNumberStart, lock }, entryI
 			streamOptions: { signal, size, onstart, onprogress, onend }
 		};
 		const result = await runWorker({ readable, writable }, workerOptions);
-		uncompressedSize = result.inputSize;
 		compressedSize = result.outputSize;
-		signature = result.signature;
+		if (!passThrough) {
+			uncompressedSize = result.inputSize;
+			signature = result.signature;
+		}
 		writable.size += uncompressedSize;
 	} else {
 		await writeData(writable, localHeaderArray);
@@ -10469,6 +10504,7 @@ async function createFileEntry(reader, writer, { diskNumberStart, lock }, entryI
 		creationDate,
 		lastAccessDate,
 		encrypted,
+		zipCrypto,
 		size: metadataSize + compressedSize,
 		compressionMethod,
 		version,
@@ -10490,19 +10526,18 @@ function getHeaderInfo(options) {
 		lastModDate,
 		lastAccessDate,
 		creationDate,
-		rawPassword,
-		password,
 		level,
 		zip64,
 		zipCrypto,
+		useUnicodeFileNames,
 		dataDescriptor,
 		directory,
 		rawExtraField,
 		encryptionStrength,
-		extendedTimestamp
+		extendedTimestamp,
+		encrypted
 	} = options;
 	const compressed = level !== 0 && !directory;
-	const encrypted = Boolean((password && getLength(password)) || (rawPassword && getLength(rawPassword)));
 	let version = options.version;
 	let rawExtraFieldAES;
 	if (encrypted && !zipCrypto) {
@@ -10551,13 +10586,25 @@ function getHeaderInfo(options) {
 	} else {
 		rawExtraFieldNTFS = rawExtraFieldExtendedTimestamp = new Uint8Array();
 	}
-	let bitFlag = BITFLAG_LANG_ENCODING_FLAG;
+	let bitFlag = 0;
+	if (useUnicodeFileNames) {
+		bitFlag = bitFlag | BITFLAG_LANG_ENCODING_FLAG;
+	}
 	if (dataDescriptor) {
 		bitFlag = bitFlag | BITFLAG_DATA_DESCRIPTOR;
 	}
 	let compressionMethod = COMPRESSION_METHOD_STORE;
 	if (compressed) {
 		compressionMethod = COMPRESSION_METHOD_DEFLATE;
+		if (level >= 1 && level < 3) {
+			bitFlag = bitFlag | 0b110;
+		}
+		if (level >= 3 && level < 5) {
+			bitFlag = bitFlag | 0b01;
+		}
+		if (level === 9) {
+			bitFlag = bitFlag | 0b10;
+		}
 	}
 	if (zip64) {
 		version = version > VERSION_ZIP64 ? version : VERSION_ZIP64;
@@ -11043,7 +11090,8 @@ class ZipEntry {
 			id: fs.entries.length,
 			parent,
 			children: [],
-			uncompressedSize: params.uncompressedSize || 0
+			uncompressedSize: params.uncompressedSize || 0,
+			passThrough: params.passThrough
 		});
 		fs.entries.push(zipEntry);
 		if (parent) {
@@ -11386,7 +11434,8 @@ class ZipDirectoryEntry extends ZipEntry {
 					importedEntries.push(addChild(parent, name, {
 						data: entry,
 						Reader: getZipBlobReader(Object.assign({}, options)),
-						uncompressedSize: entry.uncompressedSize
+						uncompressedSize: entry.uncompressedSize,
+						passThrough: options.passThrough
 					}));
 				}
 			} catch (error) {
@@ -11702,8 +11751,17 @@ async function exportZip(zipWriter, entry, totalSize, options) {
 					comment,
 					lastModDate,
 					creationDate,
-					lastAccessDate
+					lastAccessDate,
+					uncompressedSize,
+					encrypted,
+					zipCrypto,
+					signature,
+					compressionMethod
 				} = child.data;
+				let level;
+				if (compressionMethod === 0) {
+					level = 0;
+				}
 				zipEntryOptions = {
 					externalFileAttribute,
 					versionMadeBy,
@@ -11712,6 +11770,16 @@ async function exportZip(zipWriter, entry, totalSize, options) {
 					creationDate,
 					lastAccessDate
 				};
+				if (child.passThrough) {
+					zipEntryOptions = Object.assign(zipEntryOptions, {
+						passThrough: true,
+						encrypted,
+						zipCrypto,
+						signature,
+						uncompressedSize,
+						level
+					});
+				}
 			}
 			await zipWriter.add(name, child.reader, Object.assign({
 				directory: child.directory
@@ -11901,6 +11969,7 @@ exports.ERR_INVALID_VERSION = ERR_INVALID_VERSION;
 exports.ERR_ITERATOR_COMPLETED_TOO_SOON = ERR_ITERATOR_COMPLETED_TOO_SOON;
 exports.ERR_LOCAL_FILE_HEADER_NOT_FOUND = ERR_LOCAL_FILE_HEADER_NOT_FOUND;
 exports.ERR_SPLIT_ZIP_FILE = ERR_SPLIT_ZIP_FILE;
+exports.ERR_UNDEFINED_UNCOMPRESSED_SIZE = ERR_UNDEFINED_UNCOMPRESSED_SIZE;
 exports.ERR_UNSUPPORTED_COMPRESSION = ERR_UNSUPPORTED_COMPRESSION;
 exports.ERR_UNSUPPORTED_ENCRYPTION = ERR_UNSUPPORTED_ENCRYPTION;
 exports.ERR_UNSUPPORTED_FORMAT = ERR_UNSUPPORTED_FORMAT;

package/index.d.ts

@@ -800,19 +800,13 @@ export interface GetEntriesOptions {
 /**
  * Represents options passed to the constructor of {@link ZipReader} and {@link Entry#getData}.
  */
-export interface ZipReaderCheckPasswordOptions {
+export interface ZipReaderOptions {
   /**
    * `true` to check only if the password is valid.
    *
    * @defaultValue false
    */
   checkPasswordOnly: boolean;
-}
-
-/**
- * Represents options passed to the constructor of {@link ZipReader} and {@link Entry#getData}.
- */
-export interface ZipReaderOptions {
   /**
    * `true` to check the signature of the entry.
    *
@@ -823,6 +817,10 @@ export interface ZipReaderOptions {
    * The password used to decrypt the content of the entry.
    */
   password?: string;
+  /**
+   * `true` to read the data as-is without decompressing it and without decrypting it.
+   */
+  passThrough?: boolean;
   /**
    * The password used to encrypt the content of the entry (raw).
    */
@@ -873,6 +871,10 @@ export interface EntryMetaData {
    * `true` if the content of the entry is encrypted.
    */
   encrypted: boolean;
+  /**
+   * `true` if the content of the entry is encrypted with the ZipCrypto algorithm.
+   */
+  zipCrypto: boolean;
   /**
    * The size of the compressed data in bytes.
    */
@@ -979,19 +981,8 @@ export interface Entry extends EntryMetaData {
         Writer<unknown> | WritableWriter | WritableStream,
         boolean
       >,
-    options?: EntryGetDataOptions,
+    options?: EntryGetDataCheckPasswordOptions
   ): Promise<Type>;
-
-  /**
-   * Tests if the password is valid.
-   *
-   * @param writer `undefined` or `null`.
-   * @param options The options with `checkPasswordOnly` set to `true`.
-   */
-  getData?(
-    writer: undefined | null,
-    options: EntryGetDataCheckPasswordOptions,
-  ): Promise<void>;
 }
 
 /**
@@ -1004,7 +995,7 @@ export interface EntryGetDataOptions
  * Represents the options passed to {@link Entry#getData} and `{@link ZipFileEntry}.get*`.
  */
 export interface EntryGetDataCheckPasswordOptions
-  extends EntryGetDataOptions, ZipReaderCheckPasswordOptions { }
+  extends EntryGetDataOptions { }
 
 /**
  * Represents an instance used to create a zipped stream.
@@ -1184,6 +1175,14 @@ export interface ZipWriterAddDataOptions
    * The extra field of the entry.
    */
   extraField?: Map<number, Uint8Array>;
+  /**
+   * The uncompressed size of the entry. This option is ignored if the {@link ZipWriterConstructorOptions#passThrough} option is not set to `true`.
+   */
+  uncompressedSize?: number;
+  /**
+   * The signature (CRC32 checksum) of the content. This option is ignored if the {@link ZipWriterConstructorOptions#passThrough} option is not set to `true`.
+   */
+  signature?: number;
 }
 
 /**
@@ -1314,7 +1313,15 @@ export interface ZipWriterConstructorOptions {
    */
   versionMadeBy?: number;
   /**
-   * `true` to to add a data descriptor.
+   * `true` to mark the file names as UTF-8 setting the general purpose bit 11 in the header (see Appendix D - Language Encoding (EFS)), `false` to mark the names as compliant with the original IBM Code Page 437.
+   * 
+   * Note that this does not ensure that the file names are in the correct encoding.
+   *
+   * @defaultValue true
+   */
+  useUnicodeFileNames?: boolean;
+  /**
+   * `true` to add a data descriptor.
    *
    * When set to `false`, the {@link ZipWriterConstructorOptions#bufferedWrite} option  will automatically be set to `true`.
    *
@@ -1357,6 +1364,18 @@ export interface ZipWriterConstructorOptions {
    * @defaultValue false
    */
   usdz?: boolean;
+  /**
+   * `true` to write the data as-is without compressing it and without crypting it.
+   */
+  passThrough?: boolean;
+  /**
+   * `true` to write encrypted data when `passThrough` is set to `true`.
+   */
+  encrypted?: boolean;
+  /**
+   * The offset of the first entry in the zip file.
+   */
+  offset?: number;
   /**
    * Encode the filename and the comment of the entry.
    * 
@@ -2046,3 +2065,7 @@ export const ERR_SPLIT_ZIP_FILE: string;
  * Iteration completed too soon error
  */
 export const ERR_ITERATOR_COMPLETED_TOO_SOON: string;
+/**
+ * Undefined uncompressed size error
+ */
+export const ERR_UNDEFINED_UNCOMPRESSED_SIZE: string

package/index.js

@@ -81,6 +81,7 @@ export {
 	ERR_INVALID_EXTRAFIELD_DATA,
 	ERR_INVALID_ENCRYPTION_STRENGTH,
 	ERR_UNSUPPORTED_FORMAT,
+	ERR_UNDEFINED_UNCOMPRESSED_SIZE,
 	ERR_SPLIT_ZIP_FILE,
 	ERR_ITERATOR_COMPLETED_TOO_SOON
 } from "./lib/zip-fs.js";