@zip.js/zip.js
Advanced tools
Comparing version 2.7.0 to 2.7.1
2554
index.d.ts
@@ -5,9 +5,9 @@ /** | ||
declare global { | ||
/** | ||
* Represents the `FileSystemEntry` class. | ||
* | ||
* @see {@link https://wicg.github.io/entries-api/#api-entry|specification} | ||
*/ | ||
// deno-lint-ignore no-empty-interface | ||
interface FileSystemEntry { } | ||
/** | ||
* Represents the `FileSystemEntry` class. | ||
* | ||
* @see {@link https://wicg.github.io/entries-api/#api-entry|specification} | ||
*/ | ||
// deno-lint-ignore no-empty-interface | ||
interface FileSystemEntry {} | ||
} | ||
@@ -17,8 +17,8 @@ | ||
* Represents a generic `TransformStream` class. | ||
* | ||
* | ||
* @see {@link https://streams.spec.whatwg.org/#generictransformstream|specification} | ||
*/ | ||
declare class GenericTransformStream { | ||
readable: ReadableStream | ||
writable: WritableStream | ||
readable: ReadableStream; | ||
writable: WritableStream; | ||
} | ||
@@ -28,6 +28,6 @@ | ||
* Configures zip.js | ||
* | ||
* @param configuration The configuration. | ||
* | ||
* @param configuration The configuration. | ||
*/ | ||
export function configure(configuration: Configuration): void | ||
export function configure(configuration: Configuration): void; | ||
@@ -38,84 +38,84 @@ /** | ||
interface Configuration extends WorkerConfiguration { | ||
/** | ||
* The maximum number of web workers used to compress/decompress data simultaneously. | ||
* | ||
* @defaultValue `navigator.hardwareConcurrency` | ||
*/ | ||
maxWorkers?: number; | ||
/** | ||
* The delay in milliseconds before idle web workers are automatically terminated. You can call `terminateWorkers()` to terminate idle workers. | ||
* | ||
* @defaultValue 5000 | ||
*/ | ||
terminateWorkerTimeout?: number; | ||
/** | ||
* The URIs of the compression/decompression scripts run in web workers. | ||
* | ||
* It allows using alternative deflate implementations or specifying a URL to the worker script if the CSP of the page blocks scripts imported from a Blob URI. | ||
* The properties `deflate` and `inflate` must specify arrays of URLs to import the deflate/inflate web workers, respectively. | ||
* The first URL is relative to the base URI of the document. The other URLs are relative to the URL of the first script. Scripts in the array are executed in order. | ||
* If you only use deflation or inflation, the unused `deflate`/`inflate` property can be omitted. | ||
* | ||
* Here is an example: | ||
* ``` | ||
* configure({ | ||
* workerScripts: { | ||
* deflate: ["library_path/custom-worker.js", "./custom-deflate.js"], | ||
* inflate: ["library_path/custom-worker.js", "./custom-inflate.js"] | ||
* } | ||
* }); | ||
* ``` | ||
* | ||
* If the CSP of the page blocks scripts imported from a Blob URI you can use `z-worker.js` from https://github.com/gildas-lormeau/zip.js/tree/master/dist and specify the URL where it can be found. | ||
* | ||
* Here is an example: | ||
* ``` | ||
* configure({ | ||
* workerScripts: { | ||
* deflate: ["library_path/z-worker.js"], | ||
* inflate: ["library_path/z-worker.js"] | ||
* } | ||
* }); | ||
* ``` | ||
*/ | ||
workerScripts?: { | ||
/** | ||
* The maximum number of web workers used to compress/decompress data simultaneously. | ||
* | ||
* @defaultValue `navigator.hardwareConcurrency` | ||
* The URIs of the scripts implementing used for compression. | ||
*/ | ||
maxWorkers?: number | ||
deflate?: string[]; | ||
/** | ||
* The delay in milliseconds before idle web workers are automatically terminated. You can call `terminateWorkers()` to terminate idle workers. | ||
* | ||
* @defaultValue 5000 | ||
* The URIs of the scripts implementing used for decompression. | ||
*/ | ||
terminateWorkerTimeout?: number | ||
/** | ||
* The URIs of the compression/decompression scripts run in web workers. | ||
* | ||
* It allows using alternative deflate implementations or specifying a URL to the worker script if the CSP of the page blocks scripts imported from a Blob URI. | ||
* The properties `deflate` and `inflate` must specify arrays of URLs to import the deflate/inflate web workers, respectively. | ||
* The first URL is relative to the base URI of the document. The other URLs are relative to the URL of the first script. Scripts in the array are executed in order. | ||
* If you only use deflation or inflation, the unused `deflate`/`inflate` property can be omitted. | ||
* | ||
* Here is an example: | ||
* ``` | ||
* configure({ | ||
* workerScripts: { | ||
* deflate: ["library_path/custom-worker.js", "./custom-deflate.js"], | ||
* inflate: ["library_path/custom-worker.js", "./custom-inflate.js"] | ||
* } | ||
* }); | ||
* ``` | ||
* | ||
* If the CSP of the page blocks scripts imported from a Blob URI you can use `z-worker.js` from https://github.com/gildas-lormeau/zip.js/tree/master/dist and specify the URL where it can be found. | ||
* | ||
* Here is an example: | ||
* ``` | ||
* configure({ | ||
* workerScripts: { | ||
* deflate: ["library_path/z-worker.js"], | ||
* inflate: ["library_path/z-worker.js"] | ||
* } | ||
* }); | ||
* ``` | ||
*/ | ||
workerScripts?: { | ||
/** | ||
* The URIs of the scripts implementing used for compression. | ||
*/ | ||
deflate?: string[] | ||
/** | ||
* The URIs of the scripts implementing used for decompression. | ||
*/ | ||
inflate?: string[] | ||
} | ||
/** | ||
* The size of the chunks in bytes during data compression/decompression. | ||
* | ||
* @defaultValue 524288 | ||
*/ | ||
chunkSize?: number | ||
/** | ||
* The codec implementation used to compress data. | ||
* | ||
* @defaultValue {@link ZipDeflate} | ||
*/ | ||
Deflate?: typeof ZipDeflate | ||
/** | ||
* The codec implementation used to decompress data. | ||
* | ||
* @defaultValue {@link ZipInflate} | ||
*/ | ||
Inflate?: typeof ZipInflate | ||
/** | ||
* The stream implementation used to compress data when `useCompressionStream` is set to `false`. | ||
* | ||
* @defaultValue {@link CodecStream} | ||
*/ | ||
CompressionStream?: typeof GenericTransformStream | ||
/** | ||
* The stream implementation used to decompress data when `useCompressionStream` is set to `false`. | ||
* | ||
* @defaultValue {@link CodecStream} | ||
*/ | ||
DecompressionStream?: typeof GenericTransformStream | ||
inflate?: string[]; | ||
}; | ||
/** | ||
* The size of the chunks in bytes during data compression/decompression. | ||
* | ||
* @defaultValue 524288 | ||
*/ | ||
chunkSize?: number; | ||
/** | ||
* The codec implementation used to compress data. | ||
* | ||
* @defaultValue {@link ZipDeflate} | ||
*/ | ||
Deflate?: typeof ZipDeflate; | ||
/** | ||
* The codec implementation used to decompress data. | ||
* | ||
* @defaultValue {@link ZipInflate} | ||
*/ | ||
Inflate?: typeof ZipInflate; | ||
/** | ||
* The stream implementation used to compress data when `useCompressionStream` is set to `false`. | ||
* | ||
* @defaultValue {@link CodecStream} | ||
*/ | ||
CompressionStream?: typeof GenericTransformStream; | ||
/** | ||
* The stream implementation used to decompress data when `useCompressionStream` is set to `false`. | ||
* | ||
* @defaultValue {@link CodecStream} | ||
*/ | ||
DecompressionStream?: typeof GenericTransformStream; | ||
} | ||
@@ -127,14 +127,14 @@ | ||
interface WorkerConfiguration { | ||
/** | ||
* `true` to use web workers to compress/decompress data in non-blocking background processes. | ||
* | ||
* @defaultValue true | ||
*/ | ||
useWebWorkers?: boolean | ||
/** | ||
* `true` to use the native API `CompressionStream`/`DecompressionStream` to compress/decompress data. | ||
* | ||
* @defaultValue true | ||
*/ | ||
useCompressionStream?: boolean | ||
/** | ||
* `true` to use web workers to compress/decompress data in non-blocking background processes. | ||
* | ||
* @defaultValue true | ||
*/ | ||
useWebWorkers?: boolean; | ||
/** | ||
* `true` to use the native API `CompressionStream`/`DecompressionStream` to compress/decompress data. | ||
* | ||
* @defaultValue true | ||
*/ | ||
useCompressionStream?: boolean; | ||
} | ||
@@ -144,3 +144,3 @@ | ||
* Transforms event-based third-party codec implementations into implementations compatible with zip.js | ||
* | ||
* | ||
* @param library The third-party codec implementations. | ||
@@ -151,3 +151,7 @@ * @param constructorOptions The options passed to the third-party implementations when building instances. | ||
*/ | ||
export function initShimAsyncCodec(library: EventBasedZipLibrary, constructorOptions: unknown | null, registerDataHandler: registerDataHandler): ZipLibrary | ||
export function initShimAsyncCodec( | ||
library: EventBasedZipLibrary, | ||
constructorOptions: unknown | null, | ||
registerDataHandler: registerDataHandler, | ||
): ZipLibrary; | ||
@@ -158,7 +162,7 @@ /** | ||
interface registerDataHandler { | ||
/** | ||
* @param codec The third-party codec instance. | ||
* @param onData The `data` event handler. | ||
*/ | ||
(codec: EventBasedCodec, onData: dataHandler): void | ||
/** | ||
* @param codec The third-party codec instance. | ||
* @param onData The `data` event handler. | ||
*/ | ||
(codec: EventBasedCodec, onData: dataHandler): void; | ||
} | ||
@@ -170,6 +174,6 @@ | ||
interface dataHandler { | ||
/** | ||
* @param data The processed chunk of data. | ||
*/ | ||
(data: Uint8Array): void | ||
/** | ||
* @param data The processed chunk of data. | ||
*/ | ||
(data: Uint8Array): void; | ||
} | ||
@@ -180,3 +184,3 @@ | ||
*/ | ||
export function terminateWorkers(): void | ||
export function terminateWorkers(): void; | ||
@@ -187,10 +191,10 @@ /** | ||
interface EventBasedZipLibrary { | ||
/** | ||
* The class used to compress data. | ||
*/ | ||
Deflate: typeof EventBasedCodec | ||
/** | ||
* The class used to decompress data. | ||
*/ | ||
Inflate: typeof EventBasedCodec | ||
/** | ||
* The class used to compress data. | ||
*/ | ||
Deflate: typeof EventBasedCodec; | ||
/** | ||
* The class used to decompress data. | ||
*/ | ||
Inflate: typeof EventBasedCodec; | ||
} | ||
@@ -202,14 +206,14 @@ | ||
declare class EventBasedCodec { | ||
/** | ||
* Appends a chunk of data to compress/decompress | ||
* | ||
* @param data The chunk of data to append. | ||
*/ | ||
push(data: Uint8Array): void | ||
/** | ||
* The function called when a chunk of data has been compressed/decompressed. | ||
* | ||
* @param data The chunk of compressed/decompressed data. | ||
*/ | ||
ondata(data?: Uint8Array): void | ||
/** | ||
* Appends a chunk of data to compress/decompress | ||
* | ||
* @param data The chunk of data to append. | ||
*/ | ||
push(data: Uint8Array): void; | ||
/** | ||
* The function called when a chunk of data has been compressed/decompressed. | ||
* | ||
* @param data The chunk of compressed/decompressed data. | ||
*/ | ||
ondata(data?: Uint8Array): void; | ||
} | ||
@@ -221,24 +225,24 @@ | ||
interface ZipLibrary { | ||
/** | ||
* The class used to compress data. | ||
* | ||
* @defaultValue {@link ZipDeflate} | ||
*/ | ||
Deflate: typeof ZipDeflate | ||
/** | ||
* The class used to decompress data. | ||
* | ||
* @defaultValue {@link ZipInflate} | ||
*/ | ||
Inflate: typeof ZipInflate | ||
/** | ||
* The class used to compress data. | ||
* | ||
* @defaultValue {@link ZipDeflate} | ||
*/ | ||
Deflate: typeof ZipDeflate; | ||
/** | ||
* The class used to decompress data. | ||
* | ||
* @defaultValue {@link ZipInflate} | ||
*/ | ||
Inflate: typeof ZipInflate; | ||
} | ||
declare class SyncCodec { | ||
/** | ||
* Appends a chunk of decompressed data to compress | ||
* | ||
* @param data The chunk of decompressed data to append. | ||
* @returns A chunk of compressed data. | ||
*/ | ||
append(data: Uint8Array): Uint8Array | ||
/** | ||
* Appends a chunk of decompressed data to compress | ||
* | ||
* @param data The chunk of decompressed data to append. | ||
* @returns A chunk of compressed data. | ||
*/ | ||
append(data: Uint8Array): Uint8Array; | ||
} | ||
@@ -250,8 +254,8 @@ | ||
declare class ZipDeflate extends SyncCodec { | ||
/** | ||
* Flushes the data | ||
* | ||
* @returns A chunk of compressed data. | ||
*/ | ||
flush(): Uint8Array | ||
/** | ||
* Flushes the data | ||
* | ||
* @returns A chunk of compressed data. | ||
*/ | ||
flush(): Uint8Array; | ||
} | ||
@@ -263,6 +267,6 @@ | ||
declare class ZipInflate extends SyncCodec { | ||
/** | ||
* Flushes the data | ||
*/ | ||
flush(): void | ||
/** | ||
* Flushes the data | ||
*/ | ||
flush(): void; | ||
} | ||
@@ -273,23 +277,23 @@ | ||
*/ | ||
declare class CodecStream extends TransformStream { } | ||
declare class CodecStream extends TransformStream {} | ||
/** | ||
* Returns the MIME type corresponding to a filename extension. | ||
* | ||
* | ||
* @param fileExtension the extension of the filename. | ||
* @returns The corresponding MIME type. | ||
* @returns The corresponding MIME type. | ||
*/ | ||
export function getMimeType(fileExtension: string): string | ||
export function getMimeType(fileExtension: string): string; | ||
/** | ||
* Represents an instance used to read or write unknown type of data. | ||
* | ||
* zip.js can handle multiple types of data thanks to a generic API. This feature is based on 2 abstract constructors: {@link Reader} and {@link Writer}. | ||
* | ||
* zip.js can handle multiple types of data thanks to a generic API. This feature is based on 2 abstract constructors: {@link Reader} and {@link Writer}. | ||
* The classes inheriting from {@link Reader} help to read data from a source of data. The classes inheriting from {@link Writer} help to write data into a destination. | ||
*/ | ||
interface Initializable { | ||
/** | ||
* Initializes the instance asynchronously | ||
*/ | ||
init?(): Promise<void> | ||
/** | ||
* Initializes the instance asynchronously | ||
*/ | ||
init?(): Promise<void>; | ||
} | ||
@@ -301,6 +305,6 @@ | ||
interface ReadableReader { | ||
/** | ||
* The `ReadableStream` instance. | ||
*/ | ||
readable: ReadableStream | ||
/** | ||
* The `ReadableStream` instance. | ||
*/ | ||
readable: ReadableStream; | ||
} | ||
@@ -310,3 +314,3 @@ | ||
* Represents an instance used to read unknown type of data. | ||
* | ||
* | ||
* @example | ||
@@ -316,3 +320,3 @@ * Here is an example of custom {@link Reader} class used to read binary strings: | ||
* class BinaryStringReader extends Reader { | ||
* | ||
* | ||
* constructor(binaryString) { | ||
@@ -322,3 +326,3 @@ * super(); | ||
* } | ||
* | ||
* | ||
* init() { | ||
@@ -328,3 +332,3 @@ * super.init(); | ||
* } | ||
* | ||
* | ||
* readUint8Array(offset, length) { | ||
@@ -341,28 +345,28 @@ * const result = new Uint8Array(length); | ||
export class Reader<Type> implements Initializable, ReadableReader { | ||
/** | ||
* Creates the {@link Reader} instance | ||
* | ||
* @param value The data to read. | ||
*/ | ||
constructor(value: Type) | ||
/** | ||
* The `ReadableStream` instance. | ||
*/ | ||
readable: ReadableStream | ||
/** | ||
* The total size of the data in bytes. | ||
*/ | ||
size: number | ||
/** | ||
* Initializes the instance asynchronously | ||
*/ | ||
init?(): Promise<void> | ||
/** | ||
* Reads a chunk of data | ||
* | ||
* @param index The byte index of the data to read. | ||
* @param length The length of the data to read in bytes. | ||
* @returns A promise resolving to a chunk of data. | ||
*/ | ||
readUint8Array(index: number, length: number): Promise<Uint8Array> | ||
/** | ||
* Creates the {@link Reader} instance | ||
* | ||
* @param value The data to read. | ||
*/ | ||
constructor(value: Type); | ||
/** | ||
* The `ReadableStream` instance. | ||
*/ | ||
readable: ReadableStream; | ||
/** | ||
* The total size of the data in bytes. | ||
*/ | ||
size: number; | ||
/** | ||
* Initializes the instance asynchronously | ||
*/ | ||
init?(): Promise<void>; | ||
/** | ||
* Reads a chunk of data | ||
* | ||
* @param index The byte index of the data to read. | ||
* @param length The length of the data to read in bytes. | ||
* @returns A promise resolving to a chunk of data. | ||
*/ | ||
readUint8Array(index: number, length: number): Promise<Uint8Array>; | ||
} | ||
@@ -373,3 +377,3 @@ | ||
*/ | ||
export class TextReader extends Reader<string> { } | ||
export class TextReader extends Reader<string> {} | ||
@@ -379,3 +383,3 @@ /** | ||
*/ | ||
export class BlobReader extends Reader<Blob> { } | ||
export class BlobReader extends Reader<Blob> {} | ||
@@ -385,3 +389,3 @@ /** | ||
*/ | ||
export class Data64URIReader extends Reader<string> { } | ||
export class Data64URIReader extends Reader<string> {} | ||
@@ -391,10 +395,10 @@ /** | ||
*/ | ||
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 {} | ||
@@ -404,9 +408,10 @@ /** | ||
*/ | ||
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`. | ||
*/ | ||
// deno-lint-ignore no-empty-interface | ||
interface URLString extends String { } | ||
interface URLString extends String {} | ||
@@ -417,9 +422,9 @@ /** | ||
export class HttpReader extends Reader<URLString> { | ||
/** | ||
* Creates the {@link HttpReader} instance | ||
* | ||
* @param url The URL of the data. | ||
* @param options The options. | ||
*/ | ||
constructor(url: URLString, options?: HttpOptions) | ||
/** | ||
* Creates the {@link HttpReader} instance | ||
* | ||
* @param url The URL of the data. | ||
* @param options The options. | ||
*/ | ||
constructor(url: URLString, options?: HttpOptions); | ||
} | ||
@@ -431,9 +436,9 @@ | ||
export class HttpRangeReader extends HttpReader { | ||
/** | ||
* Creates the {@link HttpRangeReader} instance | ||
* | ||
* @param url The URL of the data. | ||
* @param options The options. | ||
*/ | ||
constructor(url: URLString, options?: HttpRangeOptions) | ||
/** | ||
* Creates the {@link HttpRangeReader} instance | ||
* | ||
* @param url The URL of the data. | ||
* @param options The options. | ||
*/ | ||
constructor(url: URLString, options?: HttpRangeOptions); | ||
} | ||
@@ -445,20 +450,20 @@ | ||
interface HttpOptions extends HttpRangeOptions { | ||
/** | ||
* `true` to use `Range` headers when fetching data from servers returning `Accept-Ranges` headers. | ||
* | ||
* @defaultValue false | ||
*/ | ||
useRangeHeader?: boolean | ||
/** | ||
* `true` to always use `Range` headers when fetching data. | ||
* | ||
* @defaultValue false | ||
*/ | ||
forceRangeRequests?: boolean | ||
/** | ||
* `true` to prevent using `HEAD` HTTP request in order the get the size of the content. | ||
* | ||
* @defaultValue false | ||
*/ | ||
preventHeadRequest?: boolean | ||
/** | ||
* `true` to use `Range` headers when fetching data from servers returning `Accept-Ranges` headers. | ||
* | ||
* @defaultValue false | ||
*/ | ||
useRangeHeader?: boolean; | ||
/** | ||
* `true` to always use `Range` headers when fetching data. | ||
* | ||
* @defaultValue false | ||
*/ | ||
forceRangeRequests?: boolean; | ||
/** | ||
* `true` to prevent using `HEAD` HTTP request in order the get the size of the content. | ||
* | ||
* @defaultValue false | ||
*/ | ||
preventHeadRequest?: boolean; | ||
} | ||
@@ -470,12 +475,12 @@ | ||
interface HttpRangeOptions { | ||
/** | ||
* `true` to rely `XMLHttpRequest` instead of `fetch` to fetch data. | ||
* | ||
* @defaultValue false | ||
*/ | ||
useXHR?: boolean | ||
/** | ||
* The HTTP headers. | ||
*/ | ||
headers?: Iterable<[string, string]> | Map<string, string> | ||
/** | ||
* `true` to rely `XMLHttpRequest` instead of `fetch` to fetch data. | ||
* | ||
* @defaultValue false | ||
*/ | ||
useXHR?: boolean; | ||
/** | ||
* The HTTP headers. | ||
*/ | ||
headers?: Iterable<[string, string]> | Map<string, string>; | ||
} | ||
@@ -487,10 +492,10 @@ | ||
interface WritableWriter { | ||
/** | ||
* The `WritableStream` instance. | ||
*/ | ||
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. | ||
*/ | ||
maxSize?: number | ||
/** | ||
* The `WritableStream` instance. | ||
*/ | ||
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. | ||
*/ | ||
maxSize?: number; | ||
} | ||
@@ -500,3 +505,3 @@ | ||
* Represents an instance used to write unknown type of data. | ||
* | ||
* | ||
* @example | ||
@@ -506,3 +511,3 @@ * Here is an example of custom {@link Writer} class used to write binary strings: | ||
* class BinaryStringWriter extends Writer { | ||
* | ||
* | ||
* constructor() { | ||
@@ -512,3 +517,3 @@ * super(); | ||
* } | ||
* | ||
* | ||
* writeUint8Array(array) { | ||
@@ -519,3 +524,3 @@ * for (let indexCharacter = 0; indexCharacter < array.length; indexCharacter++) { | ||
* } | ||
* | ||
* | ||
* getData() { | ||
@@ -528,26 +533,26 @@ * return this.binaryString; | ||
export class Writer<Type> implements Initializable, WritableWriter { | ||
/** | ||
* The `WritableStream` instance. | ||
*/ | ||
writable: WritableStream | ||
/** | ||
* Initializes the instance asynchronously | ||
* | ||
* @param size the total size of the written data in bytes. | ||
*/ | ||
init?(size?: number): Promise<void> | ||
/** | ||
* Appends a chunk of data | ||
* | ||
* @param array The chunk data to append. | ||
* | ||
* @virtual | ||
*/ | ||
writeUint8Array(array: Uint8Array): Promise<void> | ||
/** | ||
* Retrieves all the written data | ||
* | ||
* @returns A promise resolving to the written data. | ||
*/ | ||
getData(): Promise<Type> | ||
/** | ||
* The `WritableStream` instance. | ||
*/ | ||
writable: WritableStream; | ||
/** | ||
* Initializes the instance asynchronously | ||
* | ||
* @param size the total size of the written data in bytes. | ||
*/ | ||
init?(size?: number): Promise<void>; | ||
/** | ||
* Appends a chunk of data | ||
* | ||
* @param array The chunk data to append. | ||
* | ||
* @virtual | ||
*/ | ||
writeUint8Array(array: Uint8Array): Promise<void>; | ||
/** | ||
* Retrieves all the written data | ||
* | ||
* @returns A promise resolving to the written data. | ||
*/ | ||
getData(): Promise<Type>; | ||
} | ||
@@ -559,8 +564,8 @@ | ||
export class TextWriter extends Writer<string> { | ||
/** | ||
* Creates the {@link TextWriter} instance | ||
* | ||
* @param encoding The encoding of the text. | ||
*/ | ||
constructor(encoding?: string) | ||
/** | ||
* Creates the {@link TextWriter} instance | ||
* | ||
* @param encoding The encoding of the text. | ||
*/ | ||
constructor(encoding?: string); | ||
} | ||
@@ -572,22 +577,22 @@ | ||
export class BlobWriter implements Initializable, WritableWriter { | ||
/** | ||
* The `WritableStream` instance. | ||
*/ | ||
writable: WritableStream | ||
/** | ||
* Initializes the instance asynchronously | ||
*/ | ||
init(): Promise<void> | ||
/** | ||
* Creates the {@link BlobWriter} instance | ||
* | ||
* @param mimeString The MIME type of the content. | ||
*/ | ||
constructor(mimeString?: string) | ||
/** | ||
* Retrieves all the written data | ||
* | ||
* @returns A promise resolving to the written data. | ||
*/ | ||
getData(): Promise<Blob> | ||
/** | ||
* The `WritableStream` instance. | ||
*/ | ||
writable: WritableStream; | ||
/** | ||
* Initializes the instance asynchronously | ||
*/ | ||
init(): Promise<void>; | ||
/** | ||
* Creates the {@link BlobWriter} instance | ||
* | ||
* @param mimeString The MIME type of the content. | ||
*/ | ||
constructor(mimeString?: string); | ||
/** | ||
* Retrieves all the written data | ||
* | ||
* @returns A promise resolving to the written data. | ||
*/ | ||
getData(): Promise<Blob>; | ||
} | ||
@@ -599,8 +604,8 @@ | ||
export class Data64URIWriter extends Writer<string> { | ||
/** | ||
* Creates the {@link Data64URIWriter} instance | ||
* | ||
* @param mimeString The MIME type of the content. | ||
*/ | ||
constructor(mimeString?: string) | ||
/** | ||
* Creates the {@link Data64URIWriter} instance | ||
* | ||
* @param mimeString The MIME type of the content. | ||
*/ | ||
constructor(mimeString?: string); | ||
} | ||
@@ -610,6 +615,6 @@ | ||
* Represents a {@link Writer} instance used to retrieve the written data from a generator of {@link WritableWriter} instances (i.e. split zip files). | ||
* | ||
* | ||
* @deprecated Use {@link SplitDataWriter} instead. | ||
*/ | ||
export class SplitZipWriter extends SplitDataWriter { } | ||
export class SplitZipWriter extends SplitDataWriter {} | ||
@@ -620,17 +625,23 @@ /** | ||
export class SplitDataWriter implements Initializable, WritableWriter { | ||
/** | ||
* The `WritableStream` instance. | ||
*/ | ||
writable: WritableStream | ||
/** | ||
* Initializes the instance asynchronously | ||
*/ | ||
init(): Promise<void> | ||
/** | ||
* Creates the {@link SplitDataWriter} instance | ||
* | ||
* @param writerGenerator A generator of Writer isntances. | ||
* @param maxSize The maximum size of the data written into {@link Writer} instances (default: 4GB). | ||
*/ | ||
constructor(writerGenerator: AsyncGenerator<Writer<unknown> | WritableWriter | WritableStream, boolean>, maxSize?: number) | ||
/** | ||
* The `WritableStream` instance. | ||
*/ | ||
writable: WritableStream; | ||
/** | ||
* Initializes the instance asynchronously | ||
*/ | ||
init(): Promise<void>; | ||
/** | ||
* Creates the {@link SplitDataWriter} instance | ||
* | ||
* @param writerGenerator A generator of Writer isntances. | ||
* @param maxSize The maximum size of the data written into {@link Writer} instances (default: 4GB). | ||
*/ | ||
constructor( | ||
writerGenerator: AsyncGenerator< | ||
Writer<unknown> | WritableWriter | WritableStream, | ||
boolean | ||
>, | ||
maxSize?: number, | ||
); | ||
} | ||
@@ -641,7 +652,7 @@ | ||
*/ | ||
export class Uint8ArrayWriter extends Writer<Uint8Array> { } | ||
export class Uint8ArrayWriter extends Writer<Uint8Array> {} | ||
/** | ||
* Represents an instance used to read a zip file. | ||
* | ||
* | ||
* @example | ||
@@ -652,7 +663,7 @@ * Here is an example showing how to read the text data of the first entry from a zip file: | ||
* const reader = new zip.ZipReader(new zip.BlobReader(blob)); | ||
* | ||
* | ||
* // get all entries from the zip | ||
* const entries = await reader.getEntries(); | ||
* if (entries.length) { | ||
* | ||
* | ||
* // get first entry content as text by using a TextWriter | ||
@@ -663,3 +674,3 @@ * const text = await entries[0].getData( | ||
* // options | ||
* { | ||
* { | ||
* onprogress: (index, max) => { | ||
@@ -673,3 +684,3 @@ * // onprogress callback | ||
* } | ||
* | ||
* | ||
* // close the ZipReader | ||
@@ -680,39 +691,50 @@ * await reader.close(); | ||
export class ZipReader<Type> { | ||
/** | ||
* Creates the instance | ||
* | ||
* @param reader The {@link Reader} instance used to read data. | ||
* @param options The options. | ||
*/ | ||
constructor(reader: Reader<Type> | ReadableReader | ReadableStream | Reader<unknown>[] | ReadableReader[] | ReadableStream[], options?: ZipReaderConstructorOptions) | ||
/** | ||
* The global comment of the zip file. | ||
*/ | ||
comment: Uint8Array | ||
/** | ||
* The data prepended before the zip file. | ||
*/ | ||
prependedData?: Uint8Array | ||
/** | ||
* The data appended after the zip file. | ||
*/ | ||
appendedData?: Uint8Array | ||
/** | ||
* Returns all the entries in the zip file | ||
* | ||
* @param options The options. | ||
* @returns A promise resolving to an `array` of {@link Entry} instances. | ||
*/ | ||
getEntries(options?: ZipReaderGetEntriesOptions): Promise<Entry[]> | ||
/** | ||
* Returns a generator used to iterate on all the entries in the zip file | ||
* | ||
* @param options The options. | ||
* @returns An asynchrounous generator of {@link Entry} instances. | ||
*/ | ||
getEntriesGenerator(options?: ZipReaderGetEntriesOptions): AsyncGenerator<Entry, boolean> | ||
/** | ||
* Closes the zip file | ||
*/ | ||
close(): Promise<void> | ||
/** | ||
* Creates the instance | ||
* | ||
* @param reader The {@link Reader} instance used to read data. | ||
* @param options The options. | ||
*/ | ||
constructor( | ||
reader: | ||
| Reader<Type> | ||
| ReadableReader | ||
| ReadableStream | ||
| Reader<unknown>[] | ||
| ReadableReader[] | ||
| ReadableStream[], | ||
options?: ZipReaderConstructorOptions, | ||
); | ||
/** | ||
* The global comment of the zip file. | ||
*/ | ||
comment: Uint8Array; | ||
/** | ||
* The data prepended before the zip file. | ||
*/ | ||
prependedData?: Uint8Array; | ||
/** | ||
* The data appended after the zip file. | ||
*/ | ||
appendedData?: Uint8Array; | ||
/** | ||
* Returns all the entries in the zip file | ||
* | ||
* @param options The options. | ||
* @returns A promise resolving to an `array` of {@link Entry} instances. | ||
*/ | ||
getEntries(options?: ZipReaderGetEntriesOptions): Promise<Entry[]>; | ||
/** | ||
* Returns a generator used to iterate on all the entries in the zip file | ||
* | ||
* @param options The options. | ||
* @returns An asynchrounous generator of {@link Entry} instances. | ||
*/ | ||
getEntriesGenerator( | ||
options?: ZipReaderGetEntriesOptions, | ||
): AsyncGenerator<Entry, boolean>; | ||
/** | ||
* Closes the zip file | ||
*/ | ||
close(): Promise<void>; | ||
} | ||
@@ -723,15 +745,16 @@ | ||
*/ | ||
interface ZipReaderConstructorOptions extends ZipReaderOptions, GetEntriesOptions, WorkerConfiguration { | ||
/** | ||
* `true` to extract the prepended data into {@link ZipReader#prependedData}. | ||
* | ||
* @defaultValue false | ||
*/ | ||
extractPrependedData?: boolean | ||
/** | ||
* `true` to extract the appended data into {@link ZipReader#appendedData}. | ||
* | ||
* @defaultValue false | ||
*/ | ||
extractAppendedData?: boolean | ||
interface ZipReaderConstructorOptions | ||
extends ZipReaderOptions, GetEntriesOptions, WorkerConfiguration { | ||
/** | ||
* `true` to extract the prepended data into {@link ZipReader#prependedData}. | ||
* | ||
* @defaultValue false | ||
*/ | ||
extractPrependedData?: boolean; | ||
/** | ||
* `true` to extract the appended data into {@link ZipReader#appendedData}. | ||
* | ||
* @defaultValue false | ||
*/ | ||
extractAppendedData?: boolean; | ||
} | ||
@@ -742,3 +765,4 @@ | ||
*/ | ||
interface ZipReaderGetEntriesOptions extends GetEntriesOptions, EntryOnprogressOptions { } | ||
interface ZipReaderGetEntriesOptions | ||
extends GetEntriesOptions, EntryOnprogressOptions {} | ||
@@ -749,10 +773,10 @@ /** | ||
interface GetEntriesOptions { | ||
/** | ||
* The encoding of the filename of the entry. | ||
*/ | ||
filenameEncoding?: string | ||
/** | ||
* The encoding of the comment of the entry. | ||
*/ | ||
commentEncoding?: string | ||
/** | ||
* The encoding of the filename of the entry. | ||
*/ | ||
filenameEncoding?: string; | ||
/** | ||
* The encoding of the comment of the entry. | ||
*/ | ||
commentEncoding?: string; | ||
} | ||
@@ -763,35 +787,41 @@ | ||
*/ | ||
interface ZipReaderCheckPasswordOptions { | ||
/** | ||
* `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}. | ||
*/ | ||
interface ZipReaderOptions { | ||
/** | ||
* `true` to check only if the password is valid. | ||
* | ||
* @defaultValue false | ||
*/ | ||
checkPasswordOnly?: boolean | ||
/** | ||
* `true` to check the signature of the entry. | ||
* | ||
* @defaultValue false | ||
*/ | ||
checkSignature?: boolean | ||
/** | ||
* The password used to decrypt the content of the entry. | ||
*/ | ||
password?: string | ||
/** | ||
* The `AbortSignal` instance used to cancel the decompression. | ||
*/ | ||
signal?: AbortSignal | ||
/** | ||
* `true` to prevent closing of {@link Writer#writable} when calling {@link Entry#getData}. | ||
* | ||
* @defaultValue false | ||
*/ | ||
preventClose?: boolean | ||
/** | ||
* `true` to transfer streams to web workers when decompressing data. | ||
* | ||
* @defaultValue true | ||
*/ | ||
transferStreams?: boolean | ||
/** | ||
* `true` to check the signature of the entry. | ||
* | ||
* @defaultValue false | ||
*/ | ||
checkSignature?: boolean; | ||
/** | ||
* The password used to decrypt the content of the entry. | ||
*/ | ||
password?: string; | ||
/** | ||
* The `AbortSignal` instance used to cancel the decompression. | ||
*/ | ||
signal?: AbortSignal; | ||
/** | ||
* `true` to prevent closing of {@link Writer#writable} when calling {@link Entry#getData}. | ||
* | ||
* @defaultValue false | ||
*/ | ||
preventClose?: boolean; | ||
/** | ||
* `true` to transfer streams to web workers when decompressing data. | ||
* | ||
* @defaultValue true | ||
*/ | ||
transferStreams?: boolean; | ||
} | ||
@@ -803,118 +833,110 @@ | ||
export interface EntryMetaData { | ||
/** | ||
* The byte offset of the entry. | ||
*/ | ||
offset: number | ||
/** | ||
* The filename of the entry. | ||
*/ | ||
filename: string | ||
/** | ||
* The filename of the entry (raw). | ||
*/ | ||
rawFilename: Uint8Array | ||
/** | ||
* `true` if the filename is encoded in UTF-8. | ||
*/ | ||
filenameUTF8: boolean | ||
/** | ||
* `true` if the entry is a directory. | ||
*/ | ||
directory: boolean | ||
/** | ||
* `true` if the content of the entry is encrypted. | ||
*/ | ||
encrypted: boolean | ||
/** | ||
* The size of the compressed data in bytes. | ||
*/ | ||
compressedSize: number | ||
/** | ||
* The size of the decompressed data in bytes. | ||
*/ | ||
uncompressedSize: number | ||
/** | ||
* The last modification date. | ||
*/ | ||
lastModDate: Date | ||
/** | ||
* The last access date. | ||
*/ | ||
lastAccessDate?: Date | ||
/** | ||
* The creation date. | ||
*/ | ||
creationDate?: Date | ||
/** | ||
* The last modification date (raw). | ||
*/ | ||
rawLastModDate: number | bigint | ||
/** | ||
* The last access date (raw). | ||
*/ | ||
rawLastAccessDate?: number | bigint | ||
/** | ||
* The creation date (raw). | ||
*/ | ||
rawCreationDate?: number | bigint | ||
/** | ||
* The comment of the entry. | ||
*/ | ||
comment: string | ||
/** | ||
* The comment of the entry (raw). | ||
*/ | ||
rawComment: Uint8Array | ||
/** | ||
* `true` if the comment is encoded in UTF-8. | ||
*/ | ||
commentUTF8: boolean | ||
/** | ||
* The signature (CRC32 checksum) of the content. | ||
*/ | ||
signature: number | ||
/** | ||
* The extra field. | ||
*/ | ||
extraField?: Map<number, Uint8Array> | ||
/** | ||
* The extra field (raw). | ||
*/ | ||
rawExtraField: Uint8Array | ||
/** | ||
* `true` if the entry is using Zip64. | ||
*/ | ||
zip64: boolean | ||
/** | ||
* The "Version" field. | ||
*/ | ||
version: number | ||
/** | ||
* The "Version made by" field. | ||
*/ | ||
versionMadeBy: number | ||
/** | ||
* `true` if `internalFileAttribute` and `externalFileAttribute` are compatible with MS-DOS format. | ||
*/ | ||
msDosCompatible: boolean | ||
/** | ||
* The internal file attribute (raw). | ||
*/ | ||
internalFileAttribute: number | ||
/** | ||
* The external file attribute (raw). | ||
*/ | ||
externalFileAttribute: number | ||
/** | ||
* The number of the disk where the entry data starts. | ||
*/ | ||
diskNumberStart: number | ||
/** | ||
* Returns the content of the entry | ||
* | ||
* @param writer The {@link Writer} instance used to write the content of the entry. | ||
* @param options The options. | ||
* @returns A promise resolving to the type to data associated to `writer`. | ||
*/ | ||
getData?<Type>(writer: Writer<Type> | WritableWriter | WritableStream | AsyncGenerator<Writer<unknown> | WritableWriter | WritableStream | undefined | null, boolean>, options?: EntryGetDataOptions): Promise<Type | undefined> | ||
/** | ||
* The byte offset of the entry. | ||
*/ | ||
offset: number; | ||
/** | ||
* The filename of the entry. | ||
*/ | ||
filename: string; | ||
/** | ||
* The filename of the entry (raw). | ||
*/ | ||
rawFilename: Uint8Array; | ||
/** | ||
* `true` if the filename is encoded in UTF-8. | ||
*/ | ||
filenameUTF8: boolean; | ||
/** | ||
* `true` if the entry is a directory. | ||
*/ | ||
directory: boolean; | ||
/** | ||
* `true` if the content of the entry is encrypted. | ||
*/ | ||
encrypted: boolean; | ||
/** | ||
* The size of the compressed data in bytes. | ||
*/ | ||
compressedSize: number; | ||
/** | ||
* The size of the decompressed data in bytes. | ||
*/ | ||
uncompressedSize: number; | ||
/** | ||
* The last modification date. | ||
*/ | ||
lastModDate: Date; | ||
/** | ||
* The last access date. | ||
*/ | ||
lastAccessDate?: Date; | ||
/** | ||
* The creation date. | ||
*/ | ||
creationDate?: Date; | ||
/** | ||
* The last modification date (raw). | ||
*/ | ||
rawLastModDate: number | bigint; | ||
/** | ||
* The last access date (raw). | ||
*/ | ||
rawLastAccessDate?: number | bigint; | ||
/** | ||
* The creation date (raw). | ||
*/ | ||
rawCreationDate?: number | bigint; | ||
/** | ||
* The comment of the entry. | ||
*/ | ||
comment: string; | ||
/** | ||
* The comment of the entry (raw). | ||
*/ | ||
rawComment: Uint8Array; | ||
/** | ||
* `true` if the comment is encoded in UTF-8. | ||
*/ | ||
commentUTF8: boolean; | ||
/** | ||
* The signature (CRC32 checksum) of the content. | ||
*/ | ||
signature: number; | ||
/** | ||
* The extra field. | ||
*/ | ||
extraField?: Map<number, Uint8Array>; | ||
/** | ||
* The extra field (raw). | ||
*/ | ||
rawExtraField: Uint8Array; | ||
/** | ||
* `true` if the entry is using Zip64. | ||
*/ | ||
zip64: boolean; | ||
/** | ||
* The "Version" field. | ||
*/ | ||
version: number; | ||
/** | ||
* The "Version made by" field. | ||
*/ | ||
versionMadeBy: number; | ||
/** | ||
* `true` if `internalFileAttribute` and `externalFileAttribute` are compatible with MS-DOS format. | ||
*/ | ||
msDosCompatible: boolean; | ||
/** | ||
* The internal file attribute (raw). | ||
*/ | ||
internalFileAttribute: number; | ||
/** | ||
* The external file attribute (raw). | ||
*/ | ||
externalFileAttribute: number; | ||
/** | ||
* The number of the disk where the entry data starts. | ||
*/ | ||
diskNumberStart: number; | ||
} | ||
@@ -926,10 +948,31 @@ | ||
export interface Entry extends EntryMetaData { | ||
/** | ||
* Returns the content of the entry | ||
* | ||
* @param writer The {@link Writer} instance used to write the content of the entry or `undefined`/`null` if the option `checkPasswordOnly` is set to `true`. | ||
* @param options The options. | ||
* @returns A promise resolving to the type to data associated to `writer` or `undefined` if the option `checkPasswordOnly` is set to `true`. | ||
*/ | ||
getData<Type>(writer: Writer<Type> | WritableWriter | WritableStream | AsyncGenerator<Writer<unknown> | WritableWriter | WritableStream | undefined | null, boolean>, options?: EntryGetDataOptions): Promise<Type | undefined> | ||
/** | ||
* Returns the content of the entry | ||
* | ||
* @param writer The {@link Writer} instance used to write the content of the entry. | ||
* @param options The options. | ||
* @returns A promise resolving to the type to data associated to `writer`. | ||
*/ | ||
getData?<Type>( | ||
writer: | ||
| Writer<Type> | ||
| WritableWriter | ||
| WritableStream | ||
| AsyncGenerator< | ||
Writer<unknown> | WritableWriter | WritableStream, | ||
boolean | ||
>, | ||
options?: EntryGetDataOptions, | ||
): 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>; | ||
} | ||
@@ -940,7 +983,14 @@ | ||
*/ | ||
interface EntryGetDataOptions extends EntryDataOnprogressOptions, ZipReaderOptions, WorkerConfiguration { } | ||
interface EntryGetDataOptions | ||
extends EntryDataOnprogressOptions, ZipReaderOptions, WorkerConfiguration {} | ||
/** | ||
* Represents the options passed to {@link Entry#getData} and `{@link ZipFileEntry}.get*`. | ||
*/ | ||
interface EntryGetDataCheckPasswordOptions | ||
extends EntryGetDataOptions, ZipReaderCheckPasswordOptions {} | ||
/** | ||
* Represents an instance used to create a zip file. | ||
* | ||
* | ||
* @example | ||
@@ -952,9 +1002,9 @@ * Here is an example showing how to create a zip file containing a compressed text file: | ||
* const writer = new zip.ZipWriter(blobWriter); | ||
* | ||
* | ||
* // use a TextReader to read the String to add | ||
* await writer.add("filename.txt", new zip.TextReader("test!")); | ||
* | ||
* | ||
* // close the ZipReader | ||
* await writer.close(); | ||
* | ||
* | ||
* // get the zip file as a Blob | ||
@@ -965,30 +1015,50 @@ * const blob = await blobWriter.getData(); | ||
export class ZipWriter<Type> { | ||
/** | ||
* Creates the {@link ZipWriter} instance | ||
* | ||
* @param writer The {@link Writer} instance where the zip content will be written. | ||
* @param options The options. | ||
*/ | ||
constructor(writer: Writer<Type> | WritableWriter | WritableStream | AsyncGenerator<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 entry into the zip file | ||
* | ||
* @param filename The filename of the entry. | ||
* @param reader The {@link Reader} instance used to read the content of the entry. | ||
* @param options The options. | ||
* @returns A promise resolving to an {@link EntryMetaData} instance. | ||
*/ | ||
add<ReaderType>(filename: string, reader?: Reader<ReaderType> | ReadableReader | ReadableStream | Reader<unknown>[] | ReadableReader[] | ReadableStream[], options?: ZipWriterAddDataOptions): Promise<EntryMetaData> | ||
/** | ||
* Writes the entries directory, writes the global comment, and returns the content of the zip file | ||
* | ||
* @param comment The global comment of the zip file. | ||
* @param options The options. | ||
* @returns The content of the zip file. | ||
*/ | ||
close(comment?: Uint8Array, options?: ZipWriterCloseOptions): Promise<Type> | ||
/** | ||
* Creates the {@link ZipWriter} instance | ||
* | ||
* @param writer The {@link Writer} instance where the zip content will be written. | ||
* @param options The options. | ||
*/ | ||
constructor( | ||
writer: | ||
| Writer<Type> | ||
| WritableWriter | ||
| WritableStream | ||
| AsyncGenerator< | ||
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 entry into the zip file | ||
* | ||
* @param filename The filename of the entry. | ||
* @param reader The {@link Reader} instance used to read the content of the entry. | ||
* @param options The options. | ||
* @returns A promise resolving to an {@link EntryMetaData} instance. | ||
*/ | ||
add<ReaderType>( | ||
filename: string, | ||
reader?: | ||
| Reader<ReaderType> | ||
| ReadableReader | ||
| ReadableStream | ||
| Reader<unknown>[] | ||
| ReadableReader[] | ||
| ReadableStream[], | ||
options?: ZipWriterAddDataOptions, | ||
): Promise<EntryMetaData>; | ||
/** | ||
* Writes the entries directory, writes the global comment, and returns the content of the zip file | ||
* | ||
* @param comment The global comment of the zip file. | ||
* @param options The options. | ||
* @returns The content of the zip file. | ||
*/ | ||
close(comment?: Uint8Array, options?: ZipWriterCloseOptions): Promise<Type>; | ||
} | ||
@@ -999,17 +1069,21 @@ | ||
*/ | ||
interface ZipWriterAddDataOptions extends ZipWriterConstructorOptions, EntryDataOnprogressOptions, WorkerConfiguration { | ||
/** | ||
* `true` if the entry is a directory. | ||
* | ||
* @defaultValue false | ||
*/ | ||
directory?: boolean | ||
/** | ||
* The comment of the entry. | ||
*/ | ||
comment?: string | ||
/** | ||
* The extra field of the entry. | ||
*/ | ||
extraField?: Map<number, Uint8Array> | ||
interface ZipWriterAddDataOptions | ||
extends | ||
ZipWriterConstructorOptions, | ||
EntryDataOnprogressOptions, | ||
WorkerConfiguration { | ||
/** | ||
* `true` if the entry is a directory. | ||
* | ||
* @defaultValue false | ||
*/ | ||
directory?: boolean; | ||
/** | ||
* The comment of the entry. | ||
*/ | ||
comment?: string; | ||
/** | ||
* The extra field of the entry. | ||
*/ | ||
extraField?: Map<number, Uint8Array>; | ||
} | ||
@@ -1021,14 +1095,14 @@ | ||
interface ZipWriterCloseOptions extends EntryOnprogressOptions { | ||
/** | ||
* `true` to use Zip64 to write the entries directory. | ||
* | ||
* @defaultValue false | ||
*/ | ||
zip64?: boolean | ||
/** | ||
* `true` to prevent closing of {@link WritableWriter#writable}. | ||
* | ||
* @defaultValue false | ||
*/ | ||
preventClose?: boolean | ||
/** | ||
* `true` to use Zip64 to write the entries directory. | ||
* | ||
* @defaultValue false | ||
*/ | ||
zip64?: boolean; | ||
/** | ||
* `true` to prevent closing of {@link WritableWriter#writable}. | ||
* | ||
* @defaultValue false | ||
*/ | ||
preventClose?: boolean; | ||
} | ||
@@ -1040,141 +1114,141 @@ | ||
interface ZipWriterConstructorOptions { | ||
/** | ||
* `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). | ||
* | ||
* @defaultValue false | ||
*/ | ||
zip64?: boolean | ||
/** | ||
* `true` to prevent closing of {@link WritableWriter#writable}. | ||
* | ||
* @defaultValue false | ||
*/ | ||
preventClose?: boolean | ||
/** | ||
* The level of compression. | ||
* | ||
* The minimum value is 0 and means that no compression is applied. The maximum value is 9. | ||
* | ||
* @defaultValue 5 | ||
*/ | ||
level?: number | ||
/** | ||
* `true` to write entry data in a buffer before appending it to the zip file. | ||
* | ||
* `bufferedWrite` is automatically set to `true` when compressing more than one entry in parallel. | ||
* | ||
* @defaultValue false | ||
*/ | ||
bufferedWrite?: boolean | ||
/** | ||
* `true` to keep the order of the entry physically in the zip file. | ||
* | ||
* When set to `true`, the use of web workers will be improved. However, it also prevents files larger than 4GB from being created without setting the `zip54` option to `true` explicitly. | ||
* Another solution to improve the use of web workers is to add entries from smallest to largest in uncompressed size. | ||
* | ||
* @defaultValue true | ||
*/ | ||
keepOrder?: boolean | ||
/** | ||
* The password used to encrypt the content of the entry. | ||
*/ | ||
password?: string | ||
/** | ||
* The encryption strength (AES). | ||
* | ||
* @defaultValue 3 | ||
*/ | ||
encryptionStrength?: 1 | 2 | 3 | ||
/** | ||
* The `AbortSignal` instance used to cancel the compression. | ||
*/ | ||
signal?: AbortSignal | ||
/** | ||
* The last modification date. | ||
* | ||
* @defaultValue The current date. | ||
*/ | ||
lastModDate?: Date | ||
/** | ||
* The last access date. | ||
* | ||
* This option is ignored if the {@link ZipWriterConstructorOptions#extendedTimestamp} option is set to `false`. | ||
* | ||
* @defaultValue The current date. | ||
*/ | ||
lastAccessDate?: Date | ||
/** | ||
* The creation date. | ||
* | ||
* This option is ignored if the {@link ZipWriterConstructorOptions#extendedTimestamp} option is set to `false`. | ||
* | ||
* @defaultValue The current date. | ||
*/ | ||
creationDate?: Date | ||
/** | ||
* `true` to store extended timestamp extra fields. | ||
* | ||
* When set to `false`, the maximum last modification date cannot exceed November 31, 2107 and the maximum accuracy is 2 seconds. | ||
* | ||
* @defaultValue true | ||
*/ | ||
extendedTimestamp?: boolean | ||
/** | ||
* `true` to use the ZipCrypto algorithm to encrypt the content of the entry. | ||
* | ||
* It is not recommended to set `zipCrypto` to `true` because the ZipCrypto encryption can be easily broken. | ||
* | ||
* @defaultValue false | ||
*/ | ||
zipCrypto?: boolean | ||
/** | ||
* The "Version" field. | ||
*/ | ||
version?: number | ||
/** | ||
* The "Version made by" field. | ||
* | ||
* @defaultValue 20 | ||
*/ | ||
versionMadeBy?: number | ||
/** | ||
* `true` to to add a data descriptor. | ||
* | ||
* When set to `false`, the {@link ZipWriterConstructorOptions#bufferedWrite} option will automatically be set to `true`. | ||
* | ||
* @defaultValue true | ||
*/ | ||
dataDescriptor?: boolean | ||
/** | ||
* `true` to add the signature of the data descriptor. | ||
* | ||
* @defaultValue false | ||
*/ | ||
dataDescriptorSignature?: boolean | ||
/** | ||
* `true` to write {@link EntryMetaData#externalFileAttribute} in MS-DOS format for folder entries. | ||
* | ||
* @defaultValue true | ||
*/ | ||
msDosCompatible?: boolean | ||
/** | ||
* The external file attribute. | ||
* | ||
* @defaultValue 0 | ||
*/ | ||
externalFileAttribute?: number | ||
/** | ||
* The internal file attribute. | ||
* | ||
* @defaultValue 0 | ||
*/ | ||
internalFileAttribute?: number | ||
/** | ||
* `false` to never write disk numbers in zip64 data. | ||
* | ||
* @defaultValue true | ||
*/ | ||
supportZip64SplitFile?: boolean | ||
/** | ||
* `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). | ||
* | ||
* @defaultValue false | ||
*/ | ||
zip64?: boolean; | ||
/** | ||
* `true` to prevent closing of {@link WritableWriter#writable}. | ||
* | ||
* @defaultValue false | ||
*/ | ||
preventClose?: boolean; | ||
/** | ||
* The level of compression. | ||
* | ||
* The minimum value is 0 and means that no compression is applied. The maximum value is 9. | ||
* | ||
* @defaultValue 5 | ||
*/ | ||
level?: number; | ||
/** | ||
* `true` to write entry data in a buffer before appending it to the zip file. | ||
* | ||
* `bufferedWrite` is automatically set to `true` when compressing more than one entry in parallel. | ||
* | ||
* @defaultValue false | ||
*/ | ||
bufferedWrite?: boolean; | ||
/** | ||
* `true` to keep the order of the entry physically in the zip file. | ||
* | ||
* When set to `true`, the use of web workers will be improved. However, it also prevents files larger than 4GB from being created without setting the `zip54` option to `true` explicitly. | ||
* Another solution to improve the use of web workers is to add entries from smallest to largest in uncompressed size. | ||
* | ||
* @defaultValue true | ||
*/ | ||
keepOrder?: boolean; | ||
/** | ||
* The password used to encrypt the content of the entry. | ||
*/ | ||
password?: string; | ||
/** | ||
* The encryption strength (AES). | ||
* | ||
* @defaultValue 3 | ||
*/ | ||
encryptionStrength?: 1 | 2 | 3; | ||
/** | ||
* The `AbortSignal` instance used to cancel the compression. | ||
*/ | ||
signal?: AbortSignal; | ||
/** | ||
* The last modification date. | ||
* | ||
* @defaultValue The current date. | ||
*/ | ||
lastModDate?: Date; | ||
/** | ||
* The last access date. | ||
* | ||
* This option is ignored if the {@link ZipWriterConstructorOptions#extendedTimestamp} option is set to `false`. | ||
* | ||
* @defaultValue The current date. | ||
*/ | ||
lastAccessDate?: Date; | ||
/** | ||
* The creation date. | ||
* | ||
* This option is ignored if the {@link ZipWriterConstructorOptions#extendedTimestamp} option is set to `false`. | ||
* | ||
* @defaultValue The current date. | ||
*/ | ||
creationDate?: Date; | ||
/** | ||
* `true` to store extended timestamp extra fields. | ||
* | ||
* When set to `false`, the maximum last modification date cannot exceed November 31, 2107 and the maximum accuracy is 2 seconds. | ||
* | ||
* @defaultValue true | ||
*/ | ||
extendedTimestamp?: boolean; | ||
/** | ||
* `true` to use the ZipCrypto algorithm to encrypt the content of the entry. | ||
* | ||
* It is not recommended to set `zipCrypto` to `true` because the ZipCrypto encryption can be easily broken. | ||
* | ||
* @defaultValue false | ||
*/ | ||
zipCrypto?: boolean; | ||
/** | ||
* The "Version" field. | ||
*/ | ||
version?: number; | ||
/** | ||
* The "Version made by" field. | ||
* | ||
* @defaultValue 20 | ||
*/ | ||
versionMadeBy?: number; | ||
/** | ||
* `true` to to add a data descriptor. | ||
* | ||
* When set to `false`, the {@link ZipWriterConstructorOptions#bufferedWrite} option will automatically be set to `true`. | ||
* | ||
* @defaultValue true | ||
*/ | ||
dataDescriptor?: boolean; | ||
/** | ||
* `true` to add the signature of the data descriptor. | ||
* | ||
* @defaultValue false | ||
*/ | ||
dataDescriptorSignature?: boolean; | ||
/** | ||
* `true` to write {@link EntryMetaData#externalFileAttribute} in MS-DOS format for folder entries. | ||
* | ||
* @defaultValue true | ||
*/ | ||
msDosCompatible?: boolean; | ||
/** | ||
* The external file attribute. | ||
* | ||
* @defaultValue 0 | ||
*/ | ||
externalFileAttribute?: number; | ||
/** | ||
* The internal file attribute. | ||
* | ||
* @defaultValue 0 | ||
*/ | ||
internalFileAttribute?: number; | ||
/** | ||
* `false` to never write disk numbers in zip64 data. | ||
* | ||
* @defaultValue true | ||
*/ | ||
supportZip64SplitFile?: boolean; | ||
} | ||
@@ -1186,24 +1260,24 @@ | ||
interface EntryDataOnprogressOptions { | ||
/** | ||
* The function called when starting compression/decompression. | ||
* | ||
* @param total The total number of bytes. | ||
* @returns An empty promise or `undefined`. | ||
*/ | ||
onstart?(total: number): Promise<void> | undefined | ||
/** | ||
* The function called during compression/decompression. | ||
* | ||
* @param progress The current progress in bytes. | ||
* @param total The total number of bytes. | ||
* @returns An empty promise or `undefined`. | ||
*/ | ||
onprogress?(progress: number, total: number): Promise<void> | undefined | ||
/** | ||
* The function called when ending compression/decompression. | ||
* | ||
* @param computedSize The total number of bytes (computed). | ||
* @returns An empty promise or `undefined`. | ||
*/ | ||
onend?(computedSize: number): Promise<void> | undefined | ||
/** | ||
* The function called when starting compression/decompression. | ||
* | ||
* @param total The total number of bytes. | ||
* @returns An empty promise or `undefined`. | ||
*/ | ||
onstart?(total: number): Promise<void> | undefined; | ||
/** | ||
* The function called during compression/decompression. | ||
* | ||
* @param progress The current progress in bytes. | ||
* @param total The total number of bytes. | ||
* @returns An empty promise or `undefined`. | ||
*/ | ||
onprogress?(progress: number, total: number): Promise<void> | undefined; | ||
/** | ||
* The function called when ending compression/decompression. | ||
* | ||
* @param computedSize The total number of bytes (computed). | ||
* @returns An empty promise or `undefined`. | ||
*/ | ||
onend?(computedSize: number): Promise<void> | undefined; | ||
} | ||
@@ -1215,11 +1289,15 @@ | ||
interface EntryOnprogressOptions { | ||
/** | ||
* The function called each time an entry is read/written. | ||
* | ||
* @param progress The entry index. | ||
* @param total The total number of entries. | ||
* @param entry The entry being read/written. | ||
* @returns An empty promise or `undefined`. | ||
*/ | ||
onprogress?(progress: number, total: number, entry: EntryMetaData): Promise<void> | undefined | ||
/** | ||
* The function called each time an entry is read/written. | ||
* | ||
* @param progress The entry index. | ||
* @param total The total number of entries. | ||
* @param entry The entry being read/written. | ||
* @returns An empty promise or `undefined`. | ||
*/ | ||
onprogress?( | ||
progress: number, | ||
total: number, | ||
entry: EntryMetaData, | ||
): Promise<void> | undefined; | ||
} | ||
@@ -1231,60 +1309,63 @@ | ||
declare class ZipEntry { | ||
/** | ||
* The relative filename of the entry. | ||
*/ | ||
name: string | ||
/** | ||
* The underlying {@link EntryMetaData} instance. | ||
*/ | ||
data?: EntryMetaData | ||
/** | ||
* The ID of the instance. | ||
*/ | ||
id: number | ||
/** | ||
* The parent directory of the entry. | ||
*/ | ||
parent?: ZipEntry | ||
/** | ||
* The uncompressed size of the content. | ||
*/ | ||
uncompressedSize: number | ||
/** | ||
* The children of the entry. | ||
*/ | ||
children: ZipEntry[] | ||
/** | ||
* Clones the entry | ||
* | ||
* @param deepClone `true` to clone all the descendants. | ||
*/ | ||
clone(deepClone?: boolean): ZipEntry | ||
/** | ||
* Returns the full filename of the entry | ||
*/ | ||
getFullname(): string | ||
/** | ||
* Returns the filename of the entry relative to a parent directory | ||
*/ | ||
getRelativeName(ancestor: ZipDirectoryEntry): string | ||
/** | ||
* Tests if a {@link ZipDirectoryEntry} instance is an ancestor of the entry | ||
* | ||
* @param ancestor The {@link ZipDirectoryEntry} instance. | ||
*/ | ||
isDescendantOf(ancestor: ZipDirectoryEntry): boolean | ||
/** | ||
* Tests if the entry or any of its children is password protected | ||
*/ | ||
isPasswordProtected(): boolean | ||
/** | ||
* Tests the password on the entry and all children if any, returns `true` if the entry is not password protected | ||
*/ | ||
checkPassword(password: string, options?: EntryGetDataOptions): Promise<boolean> | ||
/** | ||
* Set the name of the entry | ||
* | ||
* @param name The new name of the netry. | ||
*/ | ||
rename(name: string): void | ||
/** | ||
* The relative filename of the entry. | ||
*/ | ||
name: string; | ||
/** | ||
* The underlying {@link EntryMetaData} instance. | ||
*/ | ||
data?: EntryMetaData; | ||
/** | ||
* The ID of the instance. | ||
*/ | ||
id: number; | ||
/** | ||
* The parent directory of the entry. | ||
*/ | ||
parent?: ZipEntry; | ||
/** | ||
* The uncompressed size of the content. | ||
*/ | ||
uncompressedSize: number; | ||
/** | ||
* The children of the entry. | ||
*/ | ||
children: ZipEntry[]; | ||
/** | ||
* Clones the entry | ||
* | ||
* @param deepClone `true` to clone all the descendants. | ||
*/ | ||
clone(deepClone?: boolean): ZipEntry; | ||
/** | ||
* Returns the full filename of the entry | ||
*/ | ||
getFullname(): string; | ||
/** | ||
* Returns the filename of the entry relative to a parent directory | ||
*/ | ||
getRelativeName(ancestor: ZipDirectoryEntry): string; | ||
/** | ||
* Tests if a {@link ZipDirectoryEntry} instance is an ancestor of the entry | ||
* | ||
* @param ancestor The {@link ZipDirectoryEntry} instance. | ||
*/ | ||
isDescendantOf(ancestor: ZipDirectoryEntry): boolean; | ||
/** | ||
* Tests if the entry or any of its children is password protected | ||
*/ | ||
isPasswordProtected(): boolean; | ||
/** | ||
* Tests the password on the entry and all children if any, returns `true` if the entry is not password protected | ||
*/ | ||
checkPassword( | ||
password: string, | ||
options?: EntryGetDataOptions, | ||
): Promise<boolean>; | ||
/** | ||
* Set the name of the entry | ||
* | ||
* @param name The new name of the netry. | ||
*/ | ||
rename(name: string): void; | ||
} | ||
@@ -1296,91 +1377,114 @@ | ||
export class ZipFileEntry<ReaderType, WriterType> extends ZipEntry { | ||
/** | ||
* `void` for {@link ZipFileEntry} instances. | ||
*/ | ||
directory: void | ||
/** | ||
* The {@link Reader} instance used to read the content of the entry. | ||
*/ | ||
reader: Reader<ReaderType> | ReadableReader | ReadableStream | Reader<unknown>[] | ReadableReader[] | ReadableStream[] | ||
/** | ||
* The {@link Writer} instance used to write the content of the entry. | ||
*/ | ||
writer: Writer<WriterType> | WritableWriter | WritableStream | AsyncGenerator<Writer<unknown> | WritableWriter | WritableStream> | ||
/** | ||
* Retrieves the text content of the entry as a `string` | ||
* | ||
* @param encoding The encoding of the text. | ||
* @param options The options. | ||
* @returns A promise resolving to a `string`. | ||
*/ | ||
getText(encoding?: string, options?: EntryGetDataOptions): Promise<string> | ||
/** | ||
* Retrieves the content of the entry as a `Blob` instance | ||
* | ||
* @param mimeType The MIME type of the content. | ||
* @param options The options. | ||
* @returns A promise resolving to a `Blob` instance. | ||
*/ | ||
getBlob(mimeType?: string, options?: EntryGetDataOptions): Promise<Blob> | ||
/** | ||
* Retrieves the content of the entry as as a Data URI `string` encoded in Base64 | ||
* | ||
* @param mimeType The MIME type of the content. | ||
* @param options The options. | ||
* @returns A promise resolving to a Data URI `string` encoded in Base64. | ||
*/ | ||
getData64URI(mimeType?: string, options?: EntryGetDataOptions): Promise<string> | ||
/** | ||
* Retrieves the content of the entry as a `Uint8Array` instance | ||
* | ||
* @param options The options. | ||
* @returns A promise resolving to a `Uint8Array` instance. | ||
*/ | ||
getUint8Array(options?: EntryGetDataOptions): Promise<Uint8Array> | ||
/** | ||
* Retrieves the content of the entry via a `WritableStream` instance | ||
* | ||
* @param writable The `WritableStream` instance. | ||
* @param options The options. | ||
* @returns A promise resolving to the `WritableStream` instance. | ||
*/ | ||
getWritable(writable?: WritableStream, options?: EntryGetDataOptions): Promise<WritableStream> | ||
/** | ||
* Retrieves the content of the entry via a {@link Writer} instance | ||
* | ||
* @param writer The {@link Writer} instance. | ||
* @param options The options. | ||
* @returns A promise resolving to data associated to the {@link Writer} instance. | ||
*/ | ||
getData(writer: Writer<unknown> | WritableWriter | WritableStream | AsyncGenerator<Writer<unknown> | WritableWriter | WritableStream>, options?: EntryGetDataOptions): Promise<unknown> | ||
/** | ||
* Replaces the content of the entry with a `Blob` instance | ||
* | ||
* @param blob The `Blob` instance. | ||
*/ | ||
replaceBlob(blob: Blob): void | ||
/** | ||
* Replaces the content of the entry with a `string` | ||
* | ||
* @param text The `string`. | ||
*/ | ||
replaceText(text: string): void | ||
/** | ||
* Replaces the content of the entry with a Data URI `string` encoded in Base64 | ||
* | ||
* @param dataURI The Data URI `string` encoded in Base64. | ||
*/ | ||
replaceData64URI(dataURI: string): void | ||
/** | ||
* Replaces the content of the entry with a `Uint8Array` instance | ||
* | ||
* @param array The `Uint8Array` instance. | ||
*/ | ||
replaceUint8Array(array: Uint8Array): void | ||
/** | ||
* Replaces the content of the entry with a `ReadableStream` instance | ||
* | ||
* @param readable The `ReadableStream` instance. | ||
*/ | ||
replaceReadable(readable: ReadableStream): void | ||
/** | ||
* `void` for {@link ZipFileEntry} instances. | ||
*/ | ||
directory: void; | ||
/** | ||
* The {@link Reader} instance used to read the content of the entry. | ||
*/ | ||
reader: | ||
| Reader<ReaderType> | ||
| ReadableReader | ||
| ReadableStream | ||
| Reader<unknown>[] | ||
| ReadableReader[] | ||
| ReadableStream[]; | ||
/** | ||
* The {@link Writer} instance used to write the content of the entry. | ||
*/ | ||
writer: | ||
| Writer<WriterType> | ||
| WritableWriter | ||
| WritableStream | ||
| AsyncGenerator<Writer<unknown> | WritableWriter | WritableStream>; | ||
/** | ||
* Retrieves the text content of the entry as a `string` | ||
* | ||
* @param encoding The encoding of the text. | ||
* @param options The options. | ||
* @returns A promise resolving to a `string`. | ||
*/ | ||
getText(encoding?: string, options?: EntryGetDataOptions): Promise<string>; | ||
/** | ||
* Retrieves the content of the entry as a `Blob` instance | ||
* | ||
* @param mimeType The MIME type of the content. | ||
* @param options The options. | ||
* @returns A promise resolving to a `Blob` instance. | ||
*/ | ||
getBlob(mimeType?: string, options?: EntryGetDataOptions): Promise<Blob>; | ||
/** | ||
* Retrieves the content of the entry as as a Data URI `string` encoded in Base64 | ||
* | ||
* @param mimeType The MIME type of the content. | ||
* @param options The options. | ||
* @returns A promise resolving to a Data URI `string` encoded in Base64. | ||
*/ | ||
getData64URI( | ||
mimeType?: string, | ||
options?: EntryGetDataOptions, | ||
): Promise<string>; | ||
/** | ||
* Retrieves the content of the entry as a `Uint8Array` instance | ||
* | ||
* @param options The options. | ||
* @returns A promise resolving to a `Uint8Array` instance. | ||
*/ | ||
getUint8Array(options?: EntryGetDataOptions): Promise<Uint8Array>; | ||
/** | ||
* Retrieves the content of the entry via a `WritableStream` instance | ||
* | ||
* @param writable The `WritableStream` instance. | ||
* @param options The options. | ||
* @returns A promise resolving to the `WritableStream` instance. | ||
*/ | ||
getWritable( | ||
writable?: WritableStream, | ||
options?: EntryGetDataOptions, | ||
): Promise<WritableStream>; | ||
/** | ||
* Retrieves the content of the entry via a {@link Writer} instance | ||
* | ||
* @param writer The {@link Writer} instance. | ||
* @param options The options. | ||
* @returns A promise resolving to data associated to the {@link Writer} instance. | ||
*/ | ||
getData( | ||
writer: | ||
| Writer<unknown> | ||
| WritableWriter | ||
| WritableStream | ||
| AsyncGenerator<Writer<unknown> | WritableWriter | WritableStream>, | ||
options?: EntryGetDataOptions, | ||
): Promise<unknown>; | ||
/** | ||
* Replaces the content of the entry with a `Blob` instance | ||
* | ||
* @param blob The `Blob` instance. | ||
*/ | ||
replaceBlob(blob: Blob): void; | ||
/** | ||
* Replaces the content of the entry with a `string` | ||
* | ||
* @param text The `string`. | ||
*/ | ||
replaceText(text: string): void; | ||
/** | ||
* Replaces the content of the entry with a Data URI `string` encoded in Base64 | ||
* | ||
* @param dataURI The Data URI `string` encoded in Base64. | ||
*/ | ||
replaceData64URI(dataURI: string): void; | ||
/** | ||
* Replaces the content of the entry with a `Uint8Array` instance | ||
* | ||
* @param array The `Uint8Array` instance. | ||
*/ | ||
replaceUint8Array(array: Uint8Array): void; | ||
/** | ||
* Replaces the content of the entry with a `ReadableStream` instance | ||
* | ||
* @param readable The `ReadableStream` instance. | ||
*/ | ||
replaceReadable(readable: ReadableStream): void; | ||
} | ||
@@ -1392,162 +1496,228 @@ | ||
export class ZipDirectoryEntry extends ZipEntry { | ||
/** | ||
* `true` for {@link ZipDirectoryEntry} instances. | ||
*/ | ||
directory: true | ||
/** | ||
* Gets a {@link ZipEntry} child instance from its relative filename | ||
* | ||
* @param name The relative filename. | ||
* @returns A {@link ZipFileEntry} or a {@link ZipDirectoryEntry} instance (use the {@link ZipFileEntry#directory} and {@link ZipDirectoryEntry#directory} properties to differentiate entries). | ||
*/ | ||
getChildByName(name: string): ZipEntry | undefined | ||
/** | ||
* Adds a directory | ||
* | ||
* @param name The relative filename of the directory. | ||
* @param options The options. | ||
* @returns A {@link ZipDirectoryEntry} instance. | ||
*/ | ||
addDirectory(name: string, options?: ZipWriterAddDataOptions): ZipDirectoryEntry | ||
/** | ||
* Adds an entry with content provided as text | ||
* | ||
* @param name The relative filename of the entry. | ||
* @param text The text. | ||
* @param options The options. | ||
* @returns A {@link ZipFileEntry} instance. | ||
*/ | ||
addText(name: string, text: string, options?: ZipWriterAddDataOptions): ZipFileEntry<string, string> | ||
/** | ||
* Adds aentry entry with content provided as a `Blob` instance | ||
* | ||
* @param name The relative filename of the entry. | ||
* @param blob The `Blob` instance. | ||
* @param options The options. | ||
* @returns A {@link ZipFileEntry} instance. | ||
*/ | ||
addBlob(name: string, blob: Blob, options?: ZipWriterAddDataOptions): ZipFileEntry<Blob, Blob> | ||
/** | ||
* Adds aentry entry with content provided as a Data URI `string` encoded in Base64 | ||
* | ||
* @param name The relative filename of the entry. | ||
* @param dataURI The Data URI `string` encoded in Base64. | ||
* @param options The options. | ||
* @returns A {@link ZipFileEntry} instance. | ||
*/ | ||
addData64URI(name: string, dataURI: string, options?: ZipWriterAddDataOptions): ZipFileEntry<string, string> | ||
/** | ||
* Adds an entry with content provided as a `Uint8Array` instance | ||
* | ||
* @param name The relative filename of the entry. | ||
* @param array The `Uint8Array` instance. | ||
* @param options The options. | ||
* @returns A {@link ZipFileEntry} instance. | ||
*/ | ||
addUint8Array(name: string, array: Uint8Array, options?: ZipWriterAddDataOptions): ZipFileEntry<Uint8Array, Uint8Array> | ||
/** | ||
* Adds an entry with content fetched from a URL | ||
* | ||
* @param name The relative filename of the entry. | ||
* @param url The URL. | ||
* @param options The options. | ||
* @returns A {@link ZipFileEntry} instance. | ||
*/ | ||
addHttpContent(name: string, url: string, options?: HttpOptions & ZipWriterAddDataOptions): ZipFileEntry<string, void> | ||
/** | ||
* Adds aentry entry with content provided via a `ReadableStream` instance | ||
* | ||
* @param name The relative filename of the entry. | ||
* @param readable The `ReadableStream` instance. | ||
* @param options The options. | ||
* @returns A {@link ZipFileEntry} instance. | ||
*/ | ||
addReadable(name: string, readable: ReadableStream, options?: ZipWriterAddDataOptions): ZipFileEntry<ReadableStream, void> | ||
/** | ||
* Adds an entry with content provided via a `FileSystemEntry` instance | ||
* | ||
* @param fileSystemEntry The `FileSystemEntry` instance. | ||
* @param options The options. | ||
* @returns A promise resolving to a {@link ZipFileEntry} or a {@link ZipDirectoryEntry} instance. | ||
*/ | ||
addFileSystemEntry(fileSystemEntry: FileSystemEntry, options?: ZipWriterAddDataOptions): Promise<ZipEntry> | ||
/** | ||
* Extracts a zip file provided as a `Blob` instance into the entry | ||
* | ||
* @param blob The `Blob` instance. | ||
* @param options The options. | ||
*/ | ||
importBlob(blob: Blob, options?: ZipReaderConstructorOptions): Promise<[ZipEntry]> | ||
/** | ||
* Extracts a zip file provided as a Data URI `string` encoded in Base64 into the entry | ||
* | ||
* @param dataURI The Data URI `string` encoded in Base64. | ||
* @param options The options. | ||
*/ | ||
importData64URI(dataURI: string, options?: ZipReaderConstructorOptions): Promise<[ZipEntry]> | ||
/** | ||
* Extracts a zip file provided as a `Uint8Array` instance into the entry | ||
* | ||
* @param array The `Uint8Array` instance. | ||
* @param options The options. | ||
*/ | ||
importUint8Array(array: Uint8Array, options?: ZipReaderConstructorOptions): Promise<[ZipEntry]> | ||
/** | ||
* Extracts a zip file fetched from a URL into the entry | ||
* | ||
* @param url The URL. | ||
* @param options The options. | ||
*/ | ||
importHttpContent(url: string, options?: ZipDirectoryEntryImportHttpOptions): Promise<[ZipEntry]> | ||
/** | ||
* Extracts a zip file provided via a `ReadableStream` instance into the entry | ||
* | ||
* @param readable The `ReadableStream` instance. | ||
* @param options The options. | ||
*/ | ||
importReadable(readable: ReadableStream, options?: ZipReaderConstructorOptions): Promise<[ZipEntry]> | ||
/** | ||
* Extracts a zip file provided via a custom {@link Reader} instance into the entry | ||
* | ||
* @param reader The {@link Reader} instance. | ||
* @param options The options. | ||
*/ | ||
importZip(reader: Reader<unknown> | ReadableReader | ReadableStream | Reader<unknown>[] | ReadableReader[] | ReadableStream[], options?: ZipReaderConstructorOptions): Promise<[ZipEntry]> | ||
/** | ||
* Returns a `Blob` instance containing a zip file of the entry and its descendants | ||
* | ||
* @param options The options. | ||
* @returns A promise resolving to the `Blob` instance. | ||
*/ | ||
exportBlob(options?: ZipDirectoryEntryExportOptions): Promise<Blob> | ||
/** | ||
* Returns a Data URI `string` encoded in Base64 containing a zip file of the entry and its descendants | ||
* | ||
* @param options The options. | ||
* @returns A promise resolving to the Data URI `string` encoded in Base64. | ||
*/ | ||
exportData64URI(options?: ZipDirectoryEntryExportOptions): Promise<string> | ||
/** | ||
* Returns a `Uint8Array` instance containing a zip file of the entry and its descendants | ||
* | ||
* @param options The options. | ||
* @returns A promise resolving to the `Uint8Array` instance. | ||
*/ | ||
exportUint8Array(options?: ZipDirectoryEntryExportOptions): Promise<Uint8Array> | ||
/** | ||
* Creates a zip file via a `WritableStream` instance containing the entry and its descendants | ||
* | ||
* @param writable The `WritableStream` instance. | ||
* @param options The options. | ||
* @returns A promise resolving to the `Uint8Array` instance. | ||
*/ | ||
exportWritable(writable?: WritableStream, options?: ZipDirectoryEntryExportOptions): Promise<WritableStream> | ||
/** | ||
* Creates a zip file via a custom {@link Writer} instance containing the entry and its descendants | ||
* | ||
* @param writer The {@link Writer} instance. | ||
* @param options The options. | ||
* @returns A promise resolving to the data. | ||
*/ | ||
exportZip(writer: Writer<unknown> | WritableWriter | WritableStream | AsyncGenerator<Writer<unknown> | WritableWriter | WritableStream>, options?: ZipDirectoryEntryExportOptions): Promise<unknown> | ||
/** | ||
* `true` for {@link ZipDirectoryEntry} instances. | ||
*/ | ||
directory: true; | ||
/** | ||
* Gets a {@link ZipEntry} child instance from its relative filename | ||
* | ||
* @param name The relative filename. | ||
* @returns A {@link ZipFileEntry} or a {@link ZipDirectoryEntry} instance (use the {@link ZipFileEntry#directory} and {@link ZipDirectoryEntry#directory} properties to differentiate entries). | ||
*/ | ||
getChildByName(name: string): ZipEntry | undefined; | ||
/** | ||
* Adds a directory | ||
* | ||
* @param name The relative filename of the directory. | ||
* @param options The options. | ||
* @returns A {@link ZipDirectoryEntry} instance. | ||
*/ | ||
addDirectory( | ||
name: string, | ||
options?: ZipWriterAddDataOptions, | ||
): ZipDirectoryEntry; | ||
/** | ||
* Adds an entry with content provided as text | ||
* | ||
* @param name The relative filename of the entry. | ||
* @param text The text. | ||
* @param options The options. | ||
* @returns A {@link ZipFileEntry} instance. | ||
*/ | ||
addText( | ||
name: string, | ||
text: string, | ||
options?: ZipWriterAddDataOptions, | ||
): ZipFileEntry<string, string>; | ||
/** | ||
* Adds aentry entry with content provided as a `Blob` instance | ||
* | ||
* @param name The relative filename of the entry. | ||
* @param blob The `Blob` instance. | ||
* @param options The options. | ||
* @returns A {@link ZipFileEntry} instance. | ||
*/ | ||
addBlob( | ||
name: string, | ||
blob: Blob, | ||
options?: ZipWriterAddDataOptions, | ||
): ZipFileEntry<Blob, Blob>; | ||
/** | ||
* Adds aentry entry with content provided as a Data URI `string` encoded in Base64 | ||
* | ||
* @param name The relative filename of the entry. | ||
* @param dataURI The Data URI `string` encoded in Base64. | ||
* @param options The options. | ||
* @returns A {@link ZipFileEntry} instance. | ||
*/ | ||
addData64URI( | ||
name: string, | ||
dataURI: string, | ||
options?: ZipWriterAddDataOptions, | ||
): ZipFileEntry<string, string>; | ||
/** | ||
* Adds an entry with content provided as a `Uint8Array` instance | ||
* | ||
* @param name The relative filename of the entry. | ||
* @param array The `Uint8Array` instance. | ||
* @param options The options. | ||
* @returns A {@link ZipFileEntry} instance. | ||
*/ | ||
addUint8Array( | ||
name: string, | ||
array: Uint8Array, | ||
options?: ZipWriterAddDataOptions, | ||
): ZipFileEntry<Uint8Array, Uint8Array>; | ||
/** | ||
* Adds an entry with content fetched from a URL | ||
* | ||
* @param name The relative filename of the entry. | ||
* @param url The URL. | ||
* @param options The options. | ||
* @returns A {@link ZipFileEntry} instance. | ||
*/ | ||
addHttpContent( | ||
name: string, | ||
url: string, | ||
options?: HttpOptions & ZipWriterAddDataOptions, | ||
): ZipFileEntry<string, void>; | ||
/** | ||
* Adds aentry entry with content provided via a `ReadableStream` instance | ||
* | ||
* @param name The relative filename of the entry. | ||
* @param readable The `ReadableStream` instance. | ||
* @param options The options. | ||
* @returns A {@link ZipFileEntry} instance. | ||
*/ | ||
addReadable( | ||
name: string, | ||
readable: ReadableStream, | ||
options?: ZipWriterAddDataOptions, | ||
): ZipFileEntry<ReadableStream, void>; | ||
/** | ||
* Adds an entry with content provided via a `FileSystemEntry` instance | ||
* | ||
* @param fileSystemEntry The `FileSystemEntry` instance. | ||
* @param options The options. | ||
* @returns A promise resolving to a {@link ZipFileEntry} or a {@link ZipDirectoryEntry} instance. | ||
*/ | ||
addFileSystemEntry( | ||
fileSystemEntry: FileSystemEntry, | ||
options?: ZipWriterAddDataOptions, | ||
): Promise<ZipEntry>; | ||
/** | ||
* Extracts a zip file provided as a `Blob` instance into the entry | ||
* | ||
* @param blob The `Blob` instance. | ||
* @param options The options. | ||
*/ | ||
importBlob( | ||
blob: Blob, | ||
options?: ZipReaderConstructorOptions, | ||
): Promise<[ZipEntry]>; | ||
/** | ||
* Extracts a zip file provided as a Data URI `string` encoded in Base64 into the entry | ||
* | ||
* @param dataURI The Data URI `string` encoded in Base64. | ||
* @param options The options. | ||
*/ | ||
importData64URI( | ||
dataURI: string, | ||
options?: ZipReaderConstructorOptions, | ||
): Promise<[ZipEntry]>; | ||
/** | ||
* Extracts a zip file provided as a `Uint8Array` instance into the entry | ||
* | ||
* @param array The `Uint8Array` instance. | ||
* @param options The options. | ||
*/ | ||
importUint8Array( | ||
array: Uint8Array, | ||
options?: ZipReaderConstructorOptions, | ||
): Promise<[ZipEntry]>; | ||
/** | ||
* Extracts a zip file fetched from a URL into the entry | ||
* | ||
* @param url The URL. | ||
* @param options The options. | ||
*/ | ||
importHttpContent( | ||
url: string, | ||
options?: ZipDirectoryEntryImportHttpOptions, | ||
): Promise<[ZipEntry]>; | ||
/** | ||
* Extracts a zip file provided via a `ReadableStream` instance into the entry | ||
* | ||
* @param readable The `ReadableStream` instance. | ||
* @param options The options. | ||
*/ | ||
importReadable( | ||
readable: ReadableStream, | ||
options?: ZipReaderConstructorOptions, | ||
): Promise<[ZipEntry]>; | ||
/** | ||
* Extracts a zip file provided via a custom {@link Reader} instance into the entry | ||
* | ||
* @param reader The {@link Reader} instance. | ||
* @param options The options. | ||
*/ | ||
importZip( | ||
reader: | ||
| Reader<unknown> | ||
| ReadableReader | ||
| ReadableStream | ||
| Reader<unknown>[] | ||
| ReadableReader[] | ||
| ReadableStream[], | ||
options?: ZipReaderConstructorOptions, | ||
): Promise<[ZipEntry]>; | ||
/** | ||
* Returns a `Blob` instance containing a zip file of the entry and its descendants | ||
* | ||
* @param options The options. | ||
* @returns A promise resolving to the `Blob` instance. | ||
*/ | ||
exportBlob(options?: ZipDirectoryEntryExportOptions): Promise<Blob>; | ||
/** | ||
* Returns a Data URI `string` encoded in Base64 containing a zip file of the entry and its descendants | ||
* | ||
* @param options The options. | ||
* @returns A promise resolving to the Data URI `string` encoded in Base64. | ||
*/ | ||
exportData64URI(options?: ZipDirectoryEntryExportOptions): Promise<string>; | ||
/** | ||
* Returns a `Uint8Array` instance containing a zip file of the entry and its descendants | ||
* | ||
* @param options The options. | ||
* @returns A promise resolving to the `Uint8Array` instance. | ||
*/ | ||
exportUint8Array( | ||
options?: ZipDirectoryEntryExportOptions, | ||
): Promise<Uint8Array>; | ||
/** | ||
* Creates a zip file via a `WritableStream` instance containing the entry and its descendants | ||
* | ||
* @param writable The `WritableStream` instance. | ||
* @param options The options. | ||
* @returns A promise resolving to the `Uint8Array` instance. | ||
*/ | ||
exportWritable( | ||
writable?: WritableStream, | ||
options?: ZipDirectoryEntryExportOptions, | ||
): Promise<WritableStream>; | ||
/** | ||
* Creates a zip file via a custom {@link Writer} instance containing the entry and its descendants | ||
* | ||
* @param writer The {@link Writer} instance. | ||
* @param options The options. | ||
* @returns A promise resolving to the data. | ||
*/ | ||
exportZip( | ||
writer: | ||
| Writer<unknown> | ||
| WritableWriter | ||
| WritableStream | ||
| AsyncGenerator<Writer<unknown> | WritableWriter | WritableStream>, | ||
options?: ZipDirectoryEntryExportOptions, | ||
): Promise<unknown>; | ||
} | ||
@@ -1558,3 +1728,4 @@ | ||
*/ | ||
interface ZipDirectoryEntryImportHttpOptions extends ZipReaderConstructorOptions, HttpOptions { } | ||
interface ZipDirectoryEntryImportHttpOptions | ||
extends ZipReaderConstructorOptions, HttpOptions {} | ||
@@ -1564,15 +1735,16 @@ /** | ||
*/ | ||
interface ZipDirectoryEntryExportOptions extends ZipWriterConstructorOptions, EntryDataOnprogressOptions { | ||
/** | ||
* `true` to use filenames relative to the entry instead of full filenames. | ||
*/ | ||
relativePath?: boolean | ||
/** | ||
* The MIME type of the exported data when relevant. | ||
*/ | ||
mimeType?: string | ||
/** | ||
* The options passed to the Reader instances | ||
*/ | ||
readerOptions?: ZipReaderConstructorOptions | ||
interface ZipDirectoryEntryExportOptions | ||
extends ZipWriterConstructorOptions, EntryDataOnprogressOptions { | ||
/** | ||
* `true` to use filenames relative to the entry instead of full filenames. | ||
*/ | ||
relativePath?: boolean; | ||
/** | ||
* The MIME type of the exported data when relevant. | ||
*/ | ||
mimeType?: string; | ||
/** | ||
* The options passed to the Reader instances | ||
*/ | ||
readerOptions?: ZipReaderConstructorOptions; | ||
} | ||
@@ -1582,3 +1754,3 @@ | ||
* Represents a Filesystem instance. | ||
* | ||
* | ||
* @example | ||
@@ -1600,33 +1772,33 @@ * Here is an example showing how to create and read a zip file containing a compressed text file: | ||
export class FS extends ZipDirectoryEntry { | ||
/** | ||
* The root directory. | ||
*/ | ||
root: ZipDirectoryEntry | ||
/** | ||
* Removes a {@link ZipEntry} instance and its children | ||
* | ||
* @param entry The {@link ZipEntry} instance to remove. | ||
*/ | ||
remove(entry: ZipEntry): void | ||
/** | ||
* Moves a {@link ZipEntry} instance and its children into a {@link ZipDirectoryEntry} instance | ||
* | ||
* @param entry The {@link ZipEntry} instance to move. | ||
* @param destination The {@link ZipDirectoryEntry} instance. | ||
*/ | ||
move(entry: ZipEntry, destination: ZipDirectoryEntry): void | ||
/** | ||
* Returns a {@link ZipEntry} instance from its full filename | ||
* | ||
* @param fullname The full filename. | ||
* @returns The {@link ZipEntry} instance. | ||
*/ | ||
find(fullname: string): ZipEntry | undefined | ||
/** | ||
* Returns a {@link ZipEntry} instance from the value of {@link ZipEntry#id} | ||
* | ||
* @param id The id of the {@link ZipEntry} instance. | ||
* @returns The {@link ZipEntry} instance. | ||
*/ | ||
getById(id: number): ZipEntry | undefined | ||
/** | ||
* The root directory. | ||
*/ | ||
root: ZipDirectoryEntry; | ||
/** | ||
* Removes a {@link ZipEntry} instance and its children | ||
* | ||
* @param entry The {@link ZipEntry} instance to remove. | ||
*/ | ||
remove(entry: ZipEntry): void; | ||
/** | ||
* Moves a {@link ZipEntry} instance and its children into a {@link ZipDirectoryEntry} instance | ||
* | ||
* @param entry The {@link ZipEntry} instance to move. | ||
* @param destination The {@link ZipDirectoryEntry} instance. | ||
*/ | ||
move(entry: ZipEntry, destination: ZipDirectoryEntry): void; | ||
/** | ||
* Returns a {@link ZipEntry} instance from its full filename | ||
* | ||
* @param fullname The full filename. | ||
* @returns The {@link ZipEntry} instance. | ||
*/ | ||
find(fullname: string): ZipEntry | undefined; | ||
/** | ||
* Returns a {@link ZipEntry} instance from the value of {@link ZipEntry#id} | ||
* | ||
* @param id The id of the {@link ZipEntry} instance. | ||
* @returns The {@link ZipEntry} instance. | ||
*/ | ||
getById(id: number): ZipEntry | undefined; | ||
} | ||
@@ -1638,46 +1810,46 @@ | ||
export const fs: { | ||
/** | ||
* The Filesystem constructor. | ||
* | ||
* @defaultValue {@link FS} | ||
*/ | ||
FS: typeof FS | ||
/** | ||
* The {@link ZipDirectoryEntry} constructor. | ||
* | ||
* @defaultValue {@link ZipDirectoryEntry} | ||
*/ | ||
ZipDirectoryEntry: typeof ZipDirectoryEntry | ||
/** | ||
* The {@link ZipFileEntry} constructor. | ||
* | ||
* @defaultValue {@link ZipFileEntry} | ||
*/ | ||
ZipFileEntry: typeof ZipFileEntry | ||
} | ||
/** | ||
* The Filesystem constructor. | ||
* | ||
* @defaultValue {@link FS} | ||
*/ | ||
FS: typeof FS; | ||
/** | ||
* The {@link ZipDirectoryEntry} constructor. | ||
* | ||
* @defaultValue {@link ZipDirectoryEntry} | ||
*/ | ||
ZipDirectoryEntry: typeof ZipDirectoryEntry; | ||
/** | ||
* The {@link ZipFileEntry} constructor. | ||
* | ||
* @defaultValue {@link ZipFileEntry} | ||
*/ | ||
ZipFileEntry: typeof ZipFileEntry; | ||
}; | ||
// The error messages. | ||
export const ERR_HTTP_RANGE: string | ||
export const ERR_BAD_FORMAT: string | ||
export const ERR_EOCDR_NOT_FOUND: string | ||
export const ERR_EOCDR_ZIP64_NOT_FOUND: string | ||
export const ERR_EOCDR_LOCATOR_ZIP64_NOT_FOUND: string | ||
export const ERR_CENTRAL_DIRECTORY_NOT_FOUND: string | ||
export const ERR_LOCAL_FILE_HEADER_NOT_FOUND: string | ||
export const ERR_EXTRAFIELD_ZIP64_NOT_FOUND: string | ||
export const ERR_ENCRYPTED: string | ||
export const ERR_UNSUPPORTED_ENCRYPTION: string | ||
export const ERR_UNSUPPORTED_COMPRESSION: string | ||
export const ERR_INVALID_SIGNATURE: string | ||
export const ERR_INVALID_PASSWORD: string | ||
export const ERR_DUPLICATED_NAME: string | ||
export const ERR_INVALID_COMMENT: string | ||
export const ERR_INVALID_ENTRY_NAME: string | ||
export const ERR_INVALID_ENTRY_COMMENT: string | ||
export const ERR_INVALID_VERSION: string | ||
export const ERR_INVALID_EXTRAFIELD_TYPE: string | ||
export const ERR_INVALID_EXTRAFIELD_DATA: string | ||
export const ERR_INVALID_ENCRYPTION_STRENGTH: string | ||
export const ERR_UNSUPPORTED_FORMAT: string | ||
export const ERR_SPLIT_ZIP_FILE: string | ||
export const ERR_ITERATOR_COMPLETED_TOO_SOON: string | ||
export const ERR_HTTP_RANGE: string; | ||
export const ERR_BAD_FORMAT: string; | ||
export const ERR_EOCDR_NOT_FOUND: string; | ||
export const ERR_EOCDR_ZIP64_NOT_FOUND: string; | ||
export const ERR_EOCDR_LOCATOR_ZIP64_NOT_FOUND: string; | ||
export const ERR_CENTRAL_DIRECTORY_NOT_FOUND: string; | ||
export const ERR_LOCAL_FILE_HEADER_NOT_FOUND: string; | ||
export const ERR_EXTRAFIELD_ZIP64_NOT_FOUND: string; | ||
export const ERR_ENCRYPTED: string; | ||
export const ERR_UNSUPPORTED_ENCRYPTION: string; | ||
export const ERR_UNSUPPORTED_COMPRESSION: string; | ||
export const ERR_INVALID_SIGNATURE: string; | ||
export const ERR_INVALID_PASSWORD: string; | ||
export const ERR_DUPLICATED_NAME: string; | ||
export const ERR_INVALID_COMMENT: string; | ||
export const ERR_INVALID_ENTRY_NAME: string; | ||
export const ERR_INVALID_ENTRY_COMMENT: string; | ||
export const ERR_INVALID_VERSION: string; | ||
export const ERR_INVALID_EXTRAFIELD_TYPE: string; | ||
export const ERR_INVALID_EXTRAFIELD_DATA: string; | ||
export const ERR_INVALID_ENCRYPTION_STRENGTH: string; | ||
export const ERR_UNSUPPORTED_FORMAT: string; | ||
export const ERR_SPLIT_ZIP_FILE: string; | ||
export const ERR_ITERATOR_COMPLETED_TOO_SOON: string; |
@@ -6,3 +6,3 @@ { | ||
"license": "BSD-3-Clause", | ||
"version": "2.7.0", | ||
"version": "2.7.1", | ||
"type": "module", | ||
@@ -9,0 +9,0 @@ "keywords": [ |
License Policy Violation
LicenseThis package is not allowed per your license policy. Review the package's license to ensure compliance.
Found 1 instance in 1 package
License Policy Violation
LicenseThis package is not allowed per your license policy. Review the package's license to ensure compliance.
Found 1 instance in 1 package
53894
2804406