@zip.js/zip.js 2.7.62 → 2.7.64

package/index.d.ts

@@ -7,7 +7,7 @@
  *
  * @author Gildas Lormeau
  * @license BSD-3-Clause
- *  
+ *
  * @example
  * Hello world
  * ```js
@@ -19,39 +19,39 @@
  *   ZipReader,
  *   ZipWriter,
  * } from from "@zip-js/zip-js";
- * 
+ *
  * // ----
  * // Write the zip file
  * // ----
- * 
+ *
  * // Creates a BlobWriter object where the zip content will be written.
  * const zipFileWriter = new BlobWriter();
- * 
+ *
  * // Creates a TextReader object storing the text of the entry to add in the zip
  * // (i.e. "Hello world!").
  * const helloWorldReader = new TextReader("Hello world!");
- * 
+ *
  * // Creates a ZipWriter object writing data via `zipFileWriter`, adds the entry
  * // "hello.txt" containing the text "Hello world!" via `helloWorldReader`, and
  * // closes the writer.
  * const zipWriter = new ZipWriter(zipFileWriter);
  * await zipWriter.add("hello.txt", helloWorldReader);
  * await zipWriter.close();
- * 
+ *
  * // Retrieves the Blob object containing the zip content into `zipFileBlob`. It
  * // is also returned by zipWriter.close() for more convenience.
  * const zipFileBlob = await zipFileWriter.getData();
- * 
+ *
  * // ----
  * // Read the zip file
  * // ----
- * 
+ *
  * // Creates a BlobReader object used to read `zipFileBlob`.
  * const zipFileReader = new BlobReader(zipFileBlob);
  * // Creates a TextWriter object where the content of the first entry in the zip
  * // will be written.
  * const helloWorldWriter = new TextWriter();
- * 
+ *
  * // Creates a ZipReader object reading the zip content via `zipFileReader`,
  * // retrieves metadata (name, dates, etc.) of the first entry, retrieves its
  * // content via `helloWorldWriter`, and closes the reader.
@@ -59,11 +59,11 @@
  * const firstEntry = (await zipReader.getEntries()).shift();
  * const helloWorldText = await firstEntry.getData(helloWorldWriter);
  * await zipReader.close();
- * 
+ *
  * // Displays "Hello world!".
  * console.log(helloWorldText);
  * ```
- * 
+ *
  * @example
  * Hello world with Streams
  * ```js
@@ -72,11 +72,11 @@
  *   ZipReader,
  *   ZipWriter,
  * } from "@zip-js/zip-js";
- * 
+ *
  * // ----
  * // Write the zip file
  * // ----
- * 
+ *
  * // Creates a TransformStream object, the zip content will be written in the
  * // `writable` property.
  * const zipFileStream = new TransformStream();
@@ -86,21 +86,21 @@
  * // Creates a ReadableStream object storing the text of the entry to add in the
  * // zip (i.e. "Hello world!").
  * const helloWorldReadable = new Blob(["Hello world!"]).stream();
- * 
+ *
  * // Creates a ZipWriter object writing data into `zipFileStream.writable`, adds
  * // the entry "hello.txt" containing the text "Hello world!" retrieved from
  * // `helloWorldReadable`, and closes the writer.
  * const zipWriter = new ZipWriter(zipFileStream.writable);
  * await zipWriter.add("hello.txt", helloWorldReadable);
  * await zipWriter.close();
- * 
+ *
  * // Retrieves the Blob object containing the zip content into `zipFileBlob`.
  * const zipFileBlob = await zipFileBlobPromise;
- * 
+ *
  * // ----
  * // Read the zip file
  * // ----
- * 
+ *
  * // Creates a BlobReader object used to read `zipFileBlob`.
  * const zipFileReader = new BlobReader(zipFileBlob);
  * // Creates a TransformStream object, the content of the first entry in the zip
@@ -109,7 +109,7 @@
  * // Creates a Promise object resolved to the content of the first entry returned
  * // as text from `helloWorldStream.readable`.
  * const helloWorldTextPromise = new Response(helloWorldStream.readable).text();
- * 
+ *
  * // Creates a ZipReader object reading the zip content via `zipFileReader`,
  * // retrieves metadata (name, dates, etc.) of the first entry, retrieves its
  * // content into `helloWorldStream.writable`, and closes the reader.
@@ -117,12 +117,12 @@
  * const firstEntry = (await zipReader.getEntries()).shift();
  * await firstEntry.getData(helloWorldStream.writable);
  * await zipReader.close();
- * 
+ *
  * // Displays "Hello world!".
  * const helloWorldText = await helloWorldTextPromise;
  * console.log(helloWorldText);
  * ```
- * 
+ *
  * @example
  * Adding concurrently multiple entries in a zip file
  * ```js
@@ -132,11 +132,11 @@
  *   TextReader,
  *   ZipWriter,
  * } from "@zip-js/zip-js";
- * 
+ *
  * const README_URL = "https://unpkg.com/@zip.js/zip.js/README.md";
  * getZipFileBlob()
  *   .then(downloadFile);
- * 
+ *
  * async function getZipFileBlob() {
  *   const zipWriter = new ZipWriter(new BlobWriter("application/zip"));
  *   await Promise.all([
@@ -145,7 +145,7 @@
  *   ]);
  *   return zipWriter.close();
  * }
- * 
+ *
  * function downloadFile(blob) {
  *   document.body.appendChild(Object.assign(document.createElement("a"), {
  *     download: "hello.zip",
@@ -154,9 +154,9 @@
  *   }));
  * }
  * ```
- * 
+ *
  * @module
-*/
+ */
 
 /**
  * Represents the `FileSystemEntry` class.
@@ -164,7 +164,7 @@
  * @see {@link https://wicg.github.io/entries-api/#api-entry|specification}
  */
 // deno-lint-ignore no-empty-interface
-interface FileSystemEntryLike { }
+interface FileSystemEntryLike {}
 
 /**
  * Represents the `FileSystemHandle` class.
@@ -172,7 +172,7 @@ interface FileSystemEntryLike { }
  * @see {@link https://fs.spec.whatwg.org/#api-filesystemhandle}
  */
 // deno-lint-ignore no-empty-interface
-interface FileSystemHandleLike { }
+interface FileSystemHandleLike {}
 
 /**
  * Represents a generic `TransformStream` class.
@@ -286,7 +286,7 @@ export interface Configuration extends WorkerConfiguration {
 }
 
 /**
- * Represents configuration passed to {@link configure}, the constructor of {@link ZipReader}, {@link Entry#getData}, the constructor of {@link ZipWriter}, and {@link ZipWriter#add}.
+ * Represents configuration passed to {@link configure}, the constructor of {@link ZipReader}, {@link FileEntry#getData}, the constructor of {@link ZipWriter}, and {@link ZipWriter#add}.
  */
 export interface WorkerConfiguration {
   /**
@@ -314,7 +314,7 @@ export interface WorkerConfiguration {
 export function initShimAsyncCodec(
   library: EventBasedZipLibrary,
   constructorOptions: unknown | null,
-  registerDataHandler: registerDataHandler,
+  registerDataHandler: registerDataHandler
 ): ZipLibrary;
 
 /**
@@ -428,7 +428,7 @@ declare class ZipInflate extends SyncCodec {
 /**
  * Represents a class implementing `CompressionStream` or `DecompressionStream` interfaces.
  */
-declare class CodecStream extends TransformStream { }
+declare class CodecStream extends TransformStream {}
 
 /**
  * Returns the MIME type corresponding to a filename extension.
@@ -521,40 +521,41 @@ export class Reader<Type> implements Initializable, ReadableReader {
 /**
  * Represents a {@link Reader} instance used to read data provided as a `string`.
  */
-export class TextReader extends Reader<string> { }
+export class TextReader extends Reader<string> {}
 
 /**
  * Represents a {@link Reader} instance used to read data provided as a `Blob` instance.
  */
-export class BlobReader extends Reader<Blob> { }
+export class BlobReader extends Reader<Blob> {}
 
 /**
  * Represents a {@link Reader} instance used to read data provided as a Data URI `string` encoded in Base64.
  */
-export class Data64URIReader extends Reader<string> { }
+export class Data64URIReader extends Reader<string> {}
 
 /**
  * Represents a {@link Reader} instance used to read data provided as a `Uint8Array` instance.
  */
-export class Uint8ArrayReader extends Reader<Uint8Array> { }
+export class Uint8ArrayReader extends Reader<Uint8Array> {}
 
 /**
  * Represents a {@link Reader} instance used to read data provided as an array of {@link ReadableReader} instances (e.g. split zip files).
  *
  * @deprecated Use {@link SplitDataReader} instead.
  */
-export class SplitZipReader extends SplitDataReader { }
+export class SplitZipReader extends SplitDataReader {}
 
 /**
  * Represents a {@link Reader} instance used to read data provided as an array of {@link ReadableReader} instances (e.g. split zip files).
  */
-export class SplitDataReader
-  extends Reader<Reader<unknown>[] | ReadableReader[] | ReadableStream[]> { }
+export class SplitDataReader extends Reader<
+  Reader<unknown>[] | ReadableReader[] | ReadableStream[]
+> {}
 
 /**
  * Represents a URL stored into a `string`.
  */
-interface URLString extends String { }
+interface URLString extends String {}
 
 /**
  * Represents a {@link Reader} instance used to fetch data from a URL.
@@ -638,7 +639,7 @@ export interface WritableWriter {
    */
   writable: WritableStream;
   /**
-   * The maximum size of split data when creating a {@link ZipWriter} instance or when calling {@link Entry#getData} with a generator of {@link WritableWriter} instances.
+   * The maximum size of split data when creating a {@link ZipWriter} instance or when calling {@link FileEntry#getData} with a generator of {@link WritableWriter} instances.
    */
   maxSize?: number;
 }
@@ -750,7 +751,7 @@ export class Data64URIWriter extends Writer<string> {
  *
  * @deprecated Use {@link SplitDataWriter} instead.
  */
-export class SplitZipWriter extends SplitDataWriter { }
+export class SplitZipWriter extends SplitDataWriter {}
 
 /**
  * Represents a {@link Writer}  instance used to retrieve the written data from a generator of {@link WritableWriter}  instances  (i.e. split zip files).
@@ -775,14 +776,14 @@ export class SplitDataWriter implements Initializable, WritableWriter {
       Writer<unknown> | WritableWriter | WritableStream,
       boolean
     >,
-    maxSize?: number,
+    maxSize?: number
   );
 }
 
 /**
  * Represents a {@link Writer}  instance used to retrieve the written data as a `Uint8Array` instance.
  */
-export class Uint8ArrayWriter extends Writer<Uint8Array> { }
+export class Uint8ArrayWriter extends Writer<Uint8Array> {}
 
 /**
  * Represents an instance used to create an unzipped stream.
@@ -873,7 +874,7 @@ export class ZipReader<Type> {
       | Reader<unknown>[]
       | ReadableReader[]
       | ReadableStream[],
-    options?: ZipReaderConstructorOptions,
+    options?: ZipReaderConstructorOptions
   );
   /**
    * The global comment of the zip file.
@@ -901,7 +902,7 @@ export class ZipReader<Type> {
    * @returns An asynchronous generator of {@link Entry} instances.
    */
   getEntriesGenerator(
-    options?: ZipReaderGetEntriesOptions,
+    options?: ZipReaderGetEntriesOptions
   ): AsyncGenerator<Entry, boolean>;
   /**
    * Closes the zip file
@@ -913,7 +914,9 @@ export class ZipReader<Type> {
  * Represents the options passed to the constructor of {@link ZipReader}, and `{@link ZipDirectory}#import*`.
  */
 export interface ZipReaderConstructorOptions
-  extends ZipReaderOptions, GetEntriesOptions, WorkerConfiguration {
+  extends ZipReaderOptions,
+    GetEntriesOptions,
+    WorkerConfiguration {
   /**
    * `true` to extract the prepended data into {@link ZipReader#prependedData}.
    *
@@ -932,7 +935,8 @@ export interface ZipReaderConstructorOptions
  * Represents the options passed to {@link ZipReader#getEntries} and {@link ZipReader#getEntriesGenerator}.
  */
 export interface ZipReaderGetEntriesOptions
-  extends GetEntriesOptions, EntryOnprogressOptions { }
+  extends GetEntriesOptions,
+    EntryOnprogressOptions {}
 
 /**
  * Represents options passed to the constructor of {@link ZipReader}, {@link ZipReader#getEntries} and {@link ZipReader#getEntriesGenerator}.
@@ -948,7 +952,7 @@ export interface GetEntriesOptions {
   commentEncoding?: string;
   /**
    * The function called for decoding the filename and the comment of the entry.
-   * 
+   *
    * @param value The raw text value.
    * @param encoding The encoding of the text.
    * @returns The decoded text value or `undefined` if the raw text value should be decoded by zip.js.
@@ -957,7 +961,7 @@ export interface GetEntriesOptions {
 }
 
 /**
- * Represents options passed to the constructor of {@link ZipReader} and {@link Entry#getData}.
+ * Represents options passed to the constructor of {@link ZipReader} and {@link FileEntry#getData}.
  */
 export interface ZipReaderOptions {
   /**
@@ -989,7 +993,7 @@ export interface ZipReaderOptions {
    */
   signal?: AbortSignal;
   /**
-   * `true` to prevent closing of {@link Writer#writable} when calling {@link Entry#getData}.
+   * `true` to prevent closing of {@link Writer#writable} when calling {@link FileEntry#getData}.
    *
    * @defaultValue false
    */
@@ -1089,7 +1093,7 @@ export interface EntryMetaData {
   /**
    * The extra field.
    */
-  extraField?: Map<number, { type: number, data: Uint8Array }>;
+  extraField?: Map<number, { type: number; data: Uint8Array }>;
   /**
    * The extra field (raw).
    */
@@ -1140,11 +1144,13 @@ export interface EntryMetaData {
    */
   compressionMethod: number;
 }
+export interface DirectoryEntry extends Omit<EntryMetaData, "directory"> {
+  directory: true;
+  getData?: undefined;
+}
 
-/**
- * Represents an entry with its data and metadata in a zip file (Core API).
- */
-export interface Entry extends EntryMetaData {
+export interface FileEntry extends Omit<EntryMetaData, "directory"> {
+  directory: false;
   /**
    * Returns the content of the entry
    *
@@ -1152,30 +1158,52 @@ export interface Entry extends EntryMetaData {
    * @param options The options.
    * @returns A promise resolving to the type to data associated to `writer`.
    */
-  getData?<Type>(
+  getData<Type>(
     writer:
       | Writer<Type>
       | WritableWriter
       | WritableStream
       | AsyncGenerator<
-        Writer<unknown> | WritableWriter | WritableStream,
-        boolean
-      >,
+          Writer<unknown> | WritableWriter | WritableStream,
+          boolean
+        >,
     options?: EntryGetDataCheckPasswordOptions
   ): Promise<Type>;
 }
 
 /**
- * Represents the options passed to {@link Entry#getData} and `{@link ZipFileEntry}.get*`.
+ * Represents an entry with its data and metadata in a zip file (Core API).
+ * This is a union type of {@link DirectoryEntry} and {@link FileEntry}.
+ *
+ * Before using getData, you should check if the entry is a file.
+ *
+ * @example
+ *
+ * ```ts
+ * for await (const entry of reader.getEntriesGenerator()) {
+ *   if (entry.directory) continue;
+ *
+ *   // entry is a FileEntry
+ *   const plainTextData = await entry.getData(new TextWriter());
+ *
+ *   // Do something with the plainTextData
+ * }
+ * ```
+ */
+export type Entry = DirectoryEntry | FileEntry;
+
+/**
+ * Represents the options passed to {@link FileEntry#getData} and `{@link ZipFileEntry}.get*`.
  */
 export interface EntryGetDataOptions
-  extends EntryDataOnprogressOptions, ZipReaderOptions, WorkerConfiguration { }
+  extends EntryDataOnprogressOptions,
+    ZipReaderOptions,
+    WorkerConfiguration {}
 
 /**
- * Represents the options passed to {@link Entry#getData} and `{@link ZipFileEntry}.get*`.
+ * Represents the options passed to {@link FileEntry#getData} and `{@link ZipFileEntry}.get*`.
  */
-export interface EntryGetDataCheckPasswordOptions
-  extends EntryGetDataOptions { }
+export interface EntryGetDataCheckPasswordOptions extends EntryGetDataOptions {}
 
 /**
  * Represents an instance used to create a zipped stream.
@@ -1237,9 +1265,10 @@ export class ZipWriterStream {
    * @param path The name of the stream when unzipped.
    * @returns An object containing readable and writable properties
    */
-  transform<T>(
-    path: string,
-  ): { readable: ReadableStream<T>; writable: WritableStream<T> };
+  transform<T>(path: string): {
+    readable: ReadableStream<T>;
+    writable: WritableStream<T>;
+  };
 
   /**
    * Returns a WritableStream for the .pipeTo method
@@ -1258,7 +1287,7 @@ export class ZipWriterStream {
    */
   close(
     comment?: Uint8Array,
-    options?: ZipWriterCloseOptions,
+    options?: ZipWriterCloseOptions
   ): Promise<unknown>;
 }
 
@@ -1295,15 +1324,33 @@ export class ZipWriter<Type> {
       | WritableWriter
       | WritableStream
       | AsyncGenerator<
-        Writer<unknown> | WritableWriter | WritableStream,
-        boolean
-      >,
-    options?: ZipWriterConstructorOptions,
+          Writer<unknown> | WritableWriter | WritableStream,
+          boolean
+        >,
+    options?: ZipWriterConstructorOptions
   );
   /**
    * `true` if the zip contains at least one entry that has been partially written.
    */
   readonly hasCorruptedEntries?: boolean;
+
+  /**
+   * Adds an existing zip file at the beginning of the current zip. This method
+   * cannot be called after the first call to {@link ZipWriter#add}.
+   *
+   * @param reader The {@link Reader} instance used to read the content of the zip file.
+   * @returns A promise resolving when the zip file has been added.
+   */
+  prependZip<ReaderType>(
+    reader:
+      | Reader<ReaderType>
+      | ReadableReader
+      | ReadableStream
+      | Reader<unknown>[]
+      | ReadableReader[]
+      | ReadableStream[]
+  ): Promise<void>;
+
   /**
    * Adds an entry into the zip file
    *
@@ -1321,8 +1368,18 @@ export class ZipWriter<Type> {
       | Reader<unknown>[]
       | ReadableReader[]
       | ReadableStream[],
-    options?: ZipWriterAddDataOptions,
+    options?: ZipWriterAddDataOptions
   ): Promise<EntryMetaData>;
+
+  /**
+   * Removes an entry from the zip file. Note that the entry is not removed from the zip file, but it
+   * is not written to the entries directory.
+   *
+   * @param entry The entry to remove. This can be an {@link Entry} instance or the filename of the entry.
+   * @returns `true` if the entry has been removed, `false` otherwise.
+   */
+  remove(entry: Entry | string): boolean;
+
   /**
    * Writes the entries directory, writes the global comment, and returns the content of the zip file
    *
@@ -1337,10 +1394,9 @@ export class ZipWriter<Type> {
  * Represents the options passed to {@link ZipWriter#add}.
  */
 export interface ZipWriterAddDataOptions
-  extends
-  ZipWriterConstructorOptions,
-  EntryDataOnprogressOptions,
-  WorkerConfiguration {
+  extends ZipWriterConstructorOptions,
+    EntryDataOnprogressOptions,
+    WorkerConfiguration {
   /**
    * `true` if the entry is a directory.
    *
@@ -1484,7 +1540,8 @@ export interface ZipWriterConstructorOptions {
    */
   extendedTimestamp?: boolean;
   /**
-   * `true` to use the ZipCrypto algorithm to encrypt the content of the entry.
+   * `true` to use the ZipCrypto algorithm to encrypt the content of the entry. Setting it to `true` will also
+   * set the {@link ZipWriterConstructorOptions#dataDescriptor} to `true`.
    *
    * It is not recommended to set `zipCrypto` to `true` because the ZipCrypto encryption can be easily broken.
    *
@@ -1502,8 +1559,9 @@ export interface ZipWriterConstructorOptions {
    */
   versionMadeBy?: number;
   /**
-   * `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.
-   * 
+   * `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
@@ -1512,9 +1570,10 @@ export interface ZipWriterConstructorOptions {
   /**
    * `true` to add a data descriptor.
    *
-   * When set to `false`, the {@link ZipWriterConstructorOptions#bufferedWrite} option  will automatically be set to `true`.
-   *
-   * @defaultValue true
+   * When set to `false`, the {@link ZipWriterConstructorOptions#bufferedWrite} option  will automatically be 
+   * set to `true`. It will be automatically set to `false` when it is `undefined` and the
+   * {@link ZipWriterConstructorOptions#bufferedWrite} option is set to `true`, or ` when the
+   * {@link ZipWriterConstructorOptions#zipCrypto} option is set to `true`. Otherwise, the default value is `true`.
    */
   dataDescriptor?: boolean;
   /**
@@ -1568,10 +1627,10 @@ export interface ZipWriterConstructorOptions {
   /**
    * The compression method (e.g. 8 for DEFLATE, 0 for STORE).
    */
-  compressionMethod?: number
+  compressionMethod?: number;
   /**
    * The function called for encoding the filename and the comment of the entry.
-   * 
+   *
    * @param text The text to encode.
    * @returns The encoded text or `undefined` if the text should be encoded by zip.js.
    */
@@ -1579,7 +1638,7 @@ export interface ZipWriterConstructorOptions {
 }
 
 /**
- * Represents options passed to {@link Entry#getData}, {@link ZipWriter.add} and `{@link ZipDirectory}.export*`.
+ * Represents options passed to {@link FileEntry#getData}, {@link ZipWriter.add} and `{@link ZipDirectory}.export*`.
  */
 export interface EntryDataOnprogressOptions {
   /**
@@ -1621,7 +1680,7 @@ export interface EntryOnprogressOptions {
   onprogress?(
     progress: number,
     total: number,
-    entry: EntryMetaData,
+    entry: EntryMetaData
   ): Promise<void> | undefined;
 }
 
@@ -1682,7 +1741,7 @@ declare class ZipEntry {
    */
   checkPassword(
     password: string,
-    options?: EntryGetDataOptions,
+    options?: EntryGetDataOptions
   ): Promise<boolean>;
   /**
    * Set the name of the entry
@@ -1743,7 +1802,7 @@ export class ZipFileEntry<ReaderType, WriterType> extends ZipEntry {
    */
   getData64URI(
     mimeType?: string,
-    options?: EntryGetDataOptions,
+    options?: EntryGetDataOptions
   ): Promise<string>;
   /**
    * Retrieves the content of the entry as a `Uint8Array` instance
@@ -1761,7 +1820,7 @@ export class ZipFileEntry<ReaderType, WriterType> extends ZipEntry {
    */
   getWritable(
     writable?: WritableStream,
-    options?: EntryGetDataOptions,
+    options?: EntryGetDataOptions
   ): Promise<WritableStream>;
   /**
    * Retrieves the content of the entry via a {@link Writer} instance
@@ -1776,7 +1835,7 @@ export class ZipFileEntry<ReaderType, WriterType> extends ZipEntry {
       | WritableWriter
       | WritableStream
       | AsyncGenerator<Writer<unknown> | WritableWriter | WritableStream>,
-    options?: EntryGetDataOptions,
+    options?: EntryGetDataOptions
   ): Promise<unknown>;
   /**
    * Replaces the content of the entry with a `Blob` instance
@@ -1834,7 +1893,7 @@ export class ZipDirectoryEntry extends ZipEntry {
    */
   addDirectory(
     name: string,
-    options?: ZipWriterAddDataOptions,
+    options?: ZipWriterAddDataOptions
   ): ZipDirectoryEntry;
   /**
    * Adds an entry with content provided as text
@@ -1847,7 +1906,7 @@ export class ZipDirectoryEntry extends ZipEntry {
   addText(
     name: string,
     text: string,
-    options?: ZipWriterAddDataOptions,
+    options?: ZipWriterAddDataOptions
   ): ZipFileEntry<string, string>;
   /**
    * Adds a entry entry with content provided as a `Blob` instance
@@ -1860,7 +1919,7 @@ export class ZipDirectoryEntry extends ZipEntry {
   addBlob(
     name: string,
     blob: Blob,
-    options?: ZipWriterAddDataOptions,
+    options?: ZipWriterAddDataOptions
   ): ZipFileEntry<Blob, Blob>;
   /**
    * Adds a entry entry with content provided as a Data URI `string` encoded in Base64
@@ -1873,7 +1932,7 @@ export class ZipDirectoryEntry extends ZipEntry {
   addData64URI(
     name: string,
     dataURI: string,
-    options?: ZipWriterAddDataOptions,
+    options?: ZipWriterAddDataOptions
   ): ZipFileEntry<string, string>;
   /**
    * Adds an entry with content provided as a `Uint8Array` instance
@@ -1886,7 +1945,7 @@ export class ZipDirectoryEntry extends ZipEntry {
   addUint8Array(
     name: string,
     array: Uint8Array,
-    options?: ZipWriterAddDataOptions,
+    options?: ZipWriterAddDataOptions
   ): ZipFileEntry<Uint8Array, Uint8Array>;
   /**
    * Adds an entry with content fetched from a URL
@@ -1899,7 +1958,7 @@ export class ZipDirectoryEntry extends ZipEntry {
   addHttpContent(
     name: string,
     url: string,
-    options?: HttpOptions & ZipWriterAddDataOptions,
+    options?: HttpOptions & ZipWriterAddDataOptions
   ): ZipFileEntry<string, void>;
   /**
    * Adds a entry entry with content provided via a `ReadableStream` instance
@@ -1912,7 +1971,7 @@ export class ZipDirectoryEntry extends ZipEntry {
   addReadable(
     name: string,
     readable: ReadableStream,
-    options?: ZipWriterAddDataOptions,
+    options?: ZipWriterAddDataOptions
   ): ZipFileEntry<ReadableStream, void>;
   /**
    * Adds an entry with content provided via a `File` instance
@@ -1921,10 +1980,7 @@ export class ZipDirectoryEntry extends ZipEntry {
    * @param options The options.
    * @returns A promise resolving to a {@link ZipFileEntry} or a {@link ZipDirectoryEntry} instance.
    */
-  addFile(
-    file: File,
-    options?: ZipWriterAddDataOptions,
-  ): Promise<ZipEntry>;
+  addFile(file: File, options?: ZipWriterAddDataOptions): Promise<ZipEntry>;
   /**
    * Adds an entry with content provided via a `FileSystemEntry` instance
    *
@@ -1934,7 +1990,7 @@ export class ZipDirectoryEntry extends ZipEntry {
    */
   addFileSystemEntry(
     fileSystemEntry: FileSystemEntryLike,
-    options?: ZipWriterAddDataOptions,
+    options?: ZipWriterAddDataOptions
   ): Promise<ZipEntry[]>;
   /**
    * Adds an entry with content provided via a `FileSystemHandle` instance
@@ -1945,7 +2001,7 @@ export class ZipDirectoryEntry extends ZipEntry {
    */
   addFileSystemHandle(
     fileSystemHandle: FileSystemHandleLike,
-    options?: ZipWriterAddDataOptions,
+    options?: ZipWriterAddDataOptions
   ): Promise<ZipEntry[]>;
   /**
    * Extracts a zip file provided as a `Blob` instance into the entry
@@ -1955,7 +2011,7 @@ export class ZipDirectoryEntry extends ZipEntry {
    */
   importBlob(
     blob: Blob,
-    options?: ZipReaderConstructorOptions,
+    options?: ZipReaderConstructorOptions
   ): Promise<[ZipEntry]>;
   /**
    * Extracts a zip file provided as a Data URI `string` encoded in Base64 into the entry
@@ -1965,7 +2021,7 @@ export class ZipDirectoryEntry extends ZipEntry {
    */
   importData64URI(
     dataURI: string,
-    options?: ZipReaderConstructorOptions,
+    options?: ZipReaderConstructorOptions
   ): Promise<[ZipEntry]>;
   /**
    * Extracts a zip file provided as a `Uint8Array` instance into the entry
@@ -1975,7 +2031,7 @@ export class ZipDirectoryEntry extends ZipEntry {
    */
   importUint8Array(
     array: Uint8Array,
-    options?: ZipReaderConstructorOptions,
+    options?: ZipReaderConstructorOptions
   ): Promise<[ZipEntry]>;
   /**
    * Extracts a zip file fetched from a URL into the entry
@@ -1985,7 +2041,7 @@ export class ZipDirectoryEntry extends ZipEntry {
    */
   importHttpContent(
     url: string,
-    options?: ZipDirectoryEntryImportHttpOptions,
+    options?: ZipDirectoryEntryImportHttpOptions
   ): Promise<[ZipEntry]>;
   /**
    * Extracts a zip file provided via a `ReadableStream` instance into the entry
@@ -1995,7 +2051,7 @@ export class ZipDirectoryEntry extends ZipEntry {
    */
   importReadable(
     readable: ReadableStream,
-    options?: ZipReaderConstructorOptions,
+    options?: ZipReaderConstructorOptions
   ): Promise<[ZipEntry]>;
   /**
    * Extracts a zip file provided via a custom {@link Reader} instance into the entry
@@ -2011,7 +2067,7 @@ export class ZipDirectoryEntry extends ZipEntry {
       | Reader<unknown>[]
       | ReadableReader[]
       | ReadableStream[],
-    options?: ZipReaderConstructorOptions,
+    options?: ZipReaderConstructorOptions
   ): Promise<[ZipEntry]>;
   /**
    * Returns a `Blob` instance containing a zip file of the entry and its descendants
@@ -2034,7 +2090,7 @@ export class ZipDirectoryEntry extends ZipEntry {
    * @returns A promise resolving to the `Uint8Array` instance.
    */
   exportUint8Array(
-    options?: ZipDirectoryEntryExportOptions,
+    options?: ZipDirectoryEntryExportOptions
   ): Promise<Uint8Array>;
   /**
    * Creates a zip file via a `WritableStream` instance containing the entry and its descendants
@@ -2045,7 +2101,7 @@ export class ZipDirectoryEntry extends ZipEntry {
    */
   exportWritable(
     writable?: WritableStream,
-    options?: ZipDirectoryEntryExportOptions,
+    options?: ZipDirectoryEntryExportOptions
   ): Promise<WritableStream>;
   /**
    * Creates a zip file via a custom {@link Writer} instance containing the entry and its descendants
@@ -2060,7 +2116,7 @@ export class ZipDirectoryEntry extends ZipEntry {
       | WritableWriter
       | WritableStream
       | AsyncGenerator<Writer<unknown> | WritableWriter | WritableStream>,
-    options?: ZipDirectoryEntryExportOptions,
+    options?: ZipDirectoryEntryExportOptions
   ): Promise<unknown>;
 }
 
@@ -2068,13 +2124,15 @@ export class ZipDirectoryEntry extends ZipEntry {
  * Represents the options passed to {@link ZipDirectoryEntry#importHttpContent}.
  */
 export interface ZipDirectoryEntryImportHttpOptions
-  extends ZipReaderConstructorOptions, HttpOptions { }
+  extends ZipReaderConstructorOptions,
+    HttpOptions {}
 
 /**
  * Represents the options passed to `{@link ZipDirectoryEntry}#export*()`.
  */
 export interface ZipDirectoryEntryExportOptions
-  extends ZipWriterConstructorOptions, EntryDataOnprogressOptions {
+  extends ZipWriterConstructorOptions,
+    EntryDataOnprogressOptions {
   /**
    * `true` to use filenames relative to the entry instead of full filenames.
    */
@@ -2266,3 +2324,7 @@ export const ERR_UNDEFINED_UNCOMPRESSED_SIZE: string;
  * Writer not initialized error
  */
 export const ERR_WRITER_NOT_INITIALIZED: string;
+/**
+ * Zip file not empty error
+ */
+export const ERR_ZIP_NOT_EMPTY: string;