@chilkat/react-native 11.6.1

package/src/specs/ZipEntry.nitro.ts

@@ -0,0 +1,782 @@
+// Generated by ReactNativeNs.RnGenerator -- do not edit.
+import type { HybridObject } from 'react-native-nitro-modules'
+import type { BinData } from './BinData.nitro'
+import type { CkDateTime } from './CkDateTime.nitro'
+import type { Stream } from './Stream.nitro'
+import type { StringBuilder } from './StringBuilder.nitro'
+
+/**
+ * Inspect, extract, update, and iterate individual entries inside a ZIP archive.
+ *
+ * `ZipEntry` represents a single item associated with a
+ * `Chilkat.Zip` archive. An entry may be a file already stored in an
+ * opened ZIP, a referenced filesystem file waiting to be compressed, an
+ * in-memory text or binary entry, or a directory entry. It provides access to
+ * entry-level metadata, compressed and uncompressed data, timestamps,
+ * attributes, CRC values, encryption information, and extraction or replacement
+ * operations for that specific ZIP item.
+ *
+ * **Entry metadata**
+ *
+ * Inspect filenames, stored ZIP paths, comments, timestamps, CRC values,
+ * attributes, sizes, compression method, and compression level.
+ *
+ * **Entry type and state**
+ *
+ * Use `EntryType` to understand whether the entry comes from an
+ * existing ZIP, a filesystem reference, memory data, or a directory.
+ *
+ * **Extract one entry**
+ *
+ * Extract a selected file entry to disk, inflate its contents into memory,
+ * or read the uncompressed data into Chilkat objects.
+ *
+ * **Read compressed data**
+ *
+ * Access the raw compressed entry data when an application needs ZIP-level
+ * control rather than only the inflated contents.
+ *
+ * **Replace or append data**
+ *
+ * Update an entry's contents from strings, byte data, files, or in-memory
+ * data sources before writing the ZIP archive.
+ *
+ * **Iterate archive entries**
+ *
+ * Walk through entries returned from `Chilkat.Zip` methods to
+ * inspect, filter, extract, or modify ZIP contents one item at a time.
+ *
+ * **Common pattern:**
+ * Open or create a `Chilkat.Zip` object, obtain a
+ * `ZipEntry` using methods such as `EntryAt`,
+ * `EntryOf`, `EntryMatching`, or
+ * `FirstEntry`, then inspect metadata, extract contents, update the
+ * entry, or continue iterating through the archive. Use
+ * `Chilkat.Zip` for whole-archive operations and
+ * `ZipEntry` for operations on one specific archive item.
+ *
+ * For an extended overview, see
+ * [ZipEntry Overview](https://www.chilkatsoft.com/zipEntry_overview.asp).
+ *
+ * Each `ZipEntry` instance owns a native Chilkat object. It is released when the JavaScript object
+ * is
+ * garbage collected, or immediately by `dispose()`; any use after `dispose()` throws.
+ * Create one with `new ZipEntry()`.
+ *
+ * Methods that can take a while (network, files, compression, key generation) also have an
+ * `...Async` form returning a `Promise`; it runs on a native worker thread so the UI keeps
+ * rendering. While such a call is pending, every other call on this object throws, except
+ * {@link ZipEntry.abort} and assigning {@link ZipEntry.onPercentDone} / {@link
+ * ZipEntry.onProgressInfo}.
+ */
+export interface ZipEntry extends HybridObject<{ ios: 'c++', android: 'c++' }> {
+  // ---- Properties ----
+
+  /**
+   * Provides HTML-formatted information about the last called method or property. If a method call
+   * fails or behaves unexpectedly, check this property for details. Note that information is
+   * available regardless of the method call's success.
+   *
+   * This property is read-only.
+   */
+  readonly lastErrorHtml: string
+
+  /**
+   * Provides plain text information about the last called method or property. If a method call
+   * fails or behaves unexpectedly, check this property for details. Note that information is
+   * available regardless of the method call's success.
+   *
+   * This property is read-only.
+   */
+  readonly lastErrorText: string
+
+  /**
+   * Provides XML-formatted information about the last called method or property. If a method call
+   * fails or behaves unexpectedly, check this property for details. Note that information is
+   * available regardless of the method call's success.
+   *
+   * This property is read-only.
+   */
+  readonly lastErrorXml: string
+
+  /**
+   * Version of the component/library, such as "10.1.0"
+   *
+   * This property is read-only.
+   */
+  readonly version: string
+
+  /**
+   * If set to a file path, this property logs the LastErrorText of each Chilkat method or property
+   * call to the specified file. This logging helps identify the context and history of Chilkat
+   * calls leading up to any crash or hang, aiding in debugging.
+   *
+   * Enabling the VerboseLogging property provides more detailed information.
+   *
+   * This property is mainly used for debugging rare instances where a Chilkat method call causes a
+   * hang or crash, which should generally not happen.
+   *
+   * Possible causes of hangs include:
+   *
+   * - A timeout property set to 0, indicating an infinite timeout.
+   *
+   * - A hang occurring within an event callback in the application code.
+   *
+   * - An internal bug in the Chilkat code causing the hang.
+   */
+  debugLogFilePath: string
+
+  /**
+   * If set to `true`, then the contents of LastErrorText (or LastErrorXml, or LastErrorHtml) may
+   * contain more verbose information. The default value is `false`. Verbose logging should only be
+   * used for debugging. The potentially large quantity of logged information may adversely affect
+   * peformance.
+   */
+  verboseLogging: boolean
+
+  /**
+   * Indicates the success or failure of the most recent method call: `true` means success, `false`
+   * means failure. This property remains unchanged by property setters or getters. This method is
+   * present to address challenges in checking for null or Nothing returns in certain programming
+   * languages. Note: This property does not apply to methods that return integer values or to
+   * boolean-returning methods where the boolean does not indicate success or failure.
+   */
+  lastMethodSuccess: boolean
+
+  /**
+   * Gets or sets the comment stored in the ZIP archive for this entry.
+   */
+  comment: string
+
+  /**
+   * The compressed size of this entry, in bytes.
+   *
+   * For mapped entries (entries already contained within an opened ZIP
+   * archive), this property contains the actual compressed size stored
+   * within the ZIP.
+   *
+   * For file entries or data entries that have not yet been written to a
+   * ZIP archive, compression has not yet occurred. In these cases, this
+   * property contains:
+   *
+   * -
+   * The current uncompressed data size for data entries.
+   *
+   * -
+   * The cached filesystem file size for referenced file entries.
+   *
+   * After the ZIP archive is written, the entries become mapped entries,
+   * and this property then reflects the actual compressed size stored in
+   * the ZIP archive.
+   *
+   * This property is read-only.
+   */
+  readonly compressedLength: number
+
+  /**
+   * The compressed size of this entry, in bytes, as a 64-bit integer.
+   *
+   * For mapped entries (entries already contained within an opened ZIP
+   * archive), this property contains the actual compressed size stored
+   * within the ZIP.
+   *
+   * For file entries or data entries that have not yet been written to a
+   * ZIP archive, compression has not yet occurred. In these cases, this
+   * property contains:
+   *
+   * -
+   * The current uncompressed data size for data entries.
+   *
+   * -
+   * The cached filesystem file size for referenced file entries.
+   *
+   * After the ZIP archive is written, the entries become mapped entries,
+   * and this property then reflects the actual compressed size stored in
+   * the ZIP archive.
+   *
+   * Use this property when sizes may exceed the range of a 32-bit integer.
+   *
+   * This property is read-only.
+   *
+   * A 64-bit integer in Chilkat; JavaScript numbers are exact up to 2^53.
+   */
+  readonly compressedLength64: number
+
+  /**
+   * The compressed size of this entry as a decimal string.
+   *
+   * For mapped entries (entries already contained within an opened ZIP
+   * archive), this property contains the actual compressed size stored
+   * within the ZIP.
+   *
+   * For file entries or data entries that have not yet been written to a
+   * ZIP archive, compression has not yet occurred. In these cases, this
+   * property contains:
+   *
+   * -
+   * The current uncompressed data size for data entries.
+   *
+   * -
+   * The cached filesystem file size for referenced file entries.
+   *
+   * After the ZIP archive is written, the entries become mapped entries,
+   * and this property then reflects the actual compressed size stored in
+   * the ZIP archive.
+   *
+   * This property is useful when sizes may exceed the range of a 32-bit
+   * integer.
+   *
+   * This property is read-only.
+   */
+  readonly compressedLengthStr: string
+
+  /**
+   * Gets or sets the compression level for this entry.
+   *
+   * A value of `0` means no compression, and a value of
+   * `9` means maximum compression.
+   *
+   * The default value is `6`.
+   */
+  compressionLevel: number
+
+  /**
+   * Gets or sets the compression method used for this entry.
+   *
+   * -
+   * `0` means no compression.
+   *
+   * -
+   * `8` means Deflate compression.
+   *
+   * Deflate is the standard compression algorithm used by common ZIP
+   * utilities such as WinZip.
+   */
+  compressionMethod: number
+
+  /**
+   * The CRC value for this ZIP entry.
+   *
+   * For AES-encrypted entries, the CRC value is `0`.
+   *
+   * This property is read-only.
+   */
+  readonly crc: number
+
+  /**
+   * A unique identifier assigned to this entry while the ZIP object is
+   * instantiated in memory.
+   *
+   * This ID can be used to retrieve the same entry later with
+   * `Zip.EntryById`.
+   *
+   * This property is read-only.
+   */
+  readonly entryID: number
+
+  /**
+   * Indicates the origin and current state of this ZIP entry.
+   *
+   * -
+   * `0` — Mapped Entry: an entry that already exists in an
+   * open ZIP file.
+   *
+   * -
+   * `1` — File Entry: a file in the local filesystem that
+   * has been referenced, but not yet read or compressed.
+   *
+   * -
+   * `2` — Data Entry: an entry containing uncompressed data
+   * already held in memory.
+   *
+   * -
+   * `3` — Null Entry: an entry that no longer exists in the
+   * ZIP archive.
+   *
+   * -
+   * `4` — New Directory Entry: a directory entry added to
+   * the ZIP object.
+   *
+   * When the ZIP archive is written by calling `WriteZip` or
+   * `WriteToMemory`, entries are transformed into mapped entries.
+   * In other words, after writing, they point to compressed data contained
+   * in the newly created or rewritten ZIP archive.
+   *
+   * This property is read-only.
+   */
+  readonly entryType: number
+
+  /**
+   * Gets or sets the local last-modified date/time for this ZIP entry
+   * in RFC 822 string format.
+   *
+   * Example RFC 822 date/time strings:
+   *
+   * `Tue, 15 Nov 1994 12:45:26 GMT         Fri, 05 Jan 2024 18:30:00 -0500`
+   *
+   * The timezone may be specified either as a named timezone such as
+   * `GMT`, or as a numeric UTC offset such as
+   * `-0500`.
+   */
+  fileDateTimeStr: string
+
+  /**
+   * Gets or sets the filename, including any relative path, stored for
+   * this entry inside the ZIP archive.
+   *
+   * Changing this property changes the path/name that will appear in the
+   * ZIP archive. It does not rename a source file in the local filesystem.
+   */
+  fileName: string
+
+  /**
+   * Returns the raw filename bytes found in the ZIP entry, encoded as a
+   * hexadecimal string.
+   *
+   * This can be useful for diagnosing filename encoding issues.
+   *
+   * This property is read-only.
+   */
+  readonly fileNameHex: string
+
+  /**
+   * The interval in milliseconds between each `AbortCheck` event callback, which enables an
+   * application to abort certain method calls before they complete. **By default, HeartbeatMs is
+   * set to **`0`**, meaning no AbortCheck event callbacks will trigger.**
+   */
+  heartbeatMs: number
+
+  /**
+   * Indicates whether this ZIP entry is a directory entry.
+   *
+   * The value is `_TRUE_` if the entry represents a directory,
+   * and `_FALSE_` if it represents a file.
+   *
+   * This property is read-only.
+   */
+  readonly isDirectory: boolean
+
+  /**
+   * Gets or sets the text flag in the internal file attributes for this
+   * ZIP entry.
+   *
+   * This flag indicates whether the entry contents should be considered
+   * text rather than binary data.
+   *
+   * The flag is informational and does not need to be accurate for normal
+   * ZIP processing. It is provided for compatibility with applications
+   * that may be sensitive to this attribute.
+   */
+  textFlag: boolean
+
+  /**
+   * The uncompressed size of this entry, in bytes.
+   *
+   * This property is read-only.
+   */
+  readonly uncompressedLength: number
+
+  /**
+   * The uncompressed size of this entry, in bytes, as a 64-bit integer.
+   *
+   * Use this property when the uncompressed size may exceed the range of
+   * a 32-bit integer.
+   *
+   * This property is read-only.
+   *
+   * A 64-bit integer in Chilkat; JavaScript numbers are exact up to 2^53.
+   */
+  readonly uncompressedLength64: number
+
+  /**
+   * The uncompressed size of this ZIP entry as a decimal string.
+   *
+   * This is useful when the uncompressed size may be larger than what can
+   * safely be represented by a 32-bit integer.
+   *
+   * This property is read-only.
+   */
+  readonly uncompressedLengthStr: string
+
+  /**
+   * Indicates whether this ZIP entry is AES encrypted.
+   *
+   * This property can be `_TRUE_` only for entries already
+   * contained in a ZIP archive, such as entries obtained after calling
+   * `OpenZip`, `OpenBd`, or
+   * `OpenFromMemory`.
+   *
+   * If the entry is not AES encrypted, the property is
+   * `_FALSE_`.
+   *
+   * This property is read-only.
+   */
+  readonly isAesEncrypted: boolean
+
+  /**
+   * The AES encryption key length for this entry.
+   *
+   * If this entry is AES encrypted, the value is `128`,
+   * `192`, or `256`.
+   *
+   * If this entry is not AES encrypted, the value is `0`.
+   *
+   * This property is read-only.
+   */
+  readonly encryptionKeyLen: number
+
+  // ---- Methods ----
+
+  /**
+   * Appends text data to this ZIP entry's file contents.
+   *
+   * The text is converted to bytes using the character encoding specified
+   * by `charset`, such as `utf-8`,
+   * `utf-16`, or `ansi`.
+   *
+   * If this entry is already a Data Entry
+   * (`EntryType = 2`), then the encoded bytes are appended
+   * directly to the existing uncompressed in-memory data.
+   *
+   * If this entry is not already a Data Entry, then the entry is first
+   * converted into a Data Entry before the new text data is appended.
+   *
+   * -
+   * If the entry is a mapped entry
+   * (`EntryType = 0`), the compressed ZIP entry data is
+   * first inflated into memory. The new text data is then appended,
+   * and the entry becomes a Data Entry containing the combined
+   * uncompressed data.
+   *
+   * -
+   * If the entry is a file entry
+   * (`EntryType = 1`), the referenced filesystem file is
+   * first loaded into memory. The new text data is then appended,
+   * and the entry becomes a Data Entry containing the combined data.
+   *
+   * After this method is called, the entry contents exist entirely as
+   * uncompressed in-memory data associated with the ZipEntry object.
+   *
+   * This call blocks the JavaScript thread until Chilkat returns; from UI code prefer
+   * {@link ZipEntry.appendStringAsync}.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link ZipEntry.lastErrorText}.
+   */
+  appendString(strContent: string, charset: string): void
+
+  /**
+   * Asynchronous form of {@link ZipEntry.appendString}: the same call on a native worker thread,
+   * settling on the JavaScript thread. While it is pending, other calls on this object throw,
+   * except {@link ZipEntry.abort} (which cancels it) and the {@link ZipEntry.onPercentDone} /
+   * {@link ZipEntry.onProgressInfo} callbacks, which report progress while it runs.
+   *
+   * The promise rejects with an Error if the call fails; the full log is in
+   * {@link ZipEntry.lastErrorText}.
+   */
+  appendStringAsync(strContent: string, charset: string): Promise<void>
+
+  /**
+   * Returns the compressed data for this ZIP entry as a Base64-encoded
+   * string.
+   *
+   * This method can only be used when the entry already contains
+   * compressed data, meaning the entry is a mapped entry.
+   *
+   * This is possible for entries from a ZIP archive that has already been
+   * opened, or after writing a ZIP archive while it remains open.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link ZipEntry.lastErrorText}.
+   */
+  copyToBase64(): string
+
+  /**
+   * Returns the compressed data for this ZIP entry as a hexadecimal
+   * encoded string.
+   *
+   * This method can only be used when the entry already contains
+   * compressed data, meaning the entry is a mapped entry.
+   *
+   * This is possible for entries from a ZIP archive that has already been
+   * opened, or after writing a ZIP archive while it remains open.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link ZipEntry.lastErrorText}.
+   */
+  copyToHex(): string
+
+  /**
+   * Extracts this ZIP entry beneath the specified base directory.
+   *
+   * The entry is extracted according to the relative path stored in the
+   * ZIP archive.
+   *
+   * For example, if the entry filename is
+   * `docs/readme.txt` and `dirPath` is
+   * `c:/temp/output`, the file is extracted to
+   * `c:/temp/output/docs/readme.txt`.
+   *
+   * Use `ExtractInto` instead if the file should be extracted
+   * directly into a specific directory regardless of the path stored in
+   * the ZIP archive.
+   *
+   * This call blocks the JavaScript thread until Chilkat returns; from UI code prefer
+   * {@link ZipEntry.extractAsync}.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link ZipEntry.lastErrorText}.
+   */
+  extract(dirPath: string): void
+
+  /**
+   * Asynchronous form of {@link ZipEntry.extract}: the same call on a native worker thread,
+   * settling on the JavaScript thread. While it is pending, other calls on this object throw,
+   * except {@link ZipEntry.abort} (which cancels it) and the {@link ZipEntry.onPercentDone} /
+   * {@link ZipEntry.onProgressInfo} callbacks, which report progress while it runs.
+   *
+   * The promise rejects with an Error if the call fails; the full log is in
+   * {@link ZipEntry.lastErrorText}.
+   */
+  extractAsync(dirPath: string): Promise<void>
+
+  /**
+   * Extracts this entry directly into the specified directory, ignoring
+   * any path information stored in the ZIP entry.
+   *
+   * For example, if the entry filename is
+   * `docs/readme.txt` and `dirPath` is
+   * `c:/temp/output`, the file is extracted to
+   * `c:/temp/output/readme.txt`.
+   *
+   * If this entry is a directory entry, nothing is extracted. To create
+   * the directory represented by a directory entry, use
+   * `Extract` instead.
+   *
+   * This call blocks the JavaScript thread until Chilkat returns; from UI code prefer
+   * {@link ZipEntry.extractIntoAsync}.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link ZipEntry.lastErrorText}.
+   */
+  extractInto(dirPath: string): void
+
+  /**
+   * Asynchronous form of {@link ZipEntry.extractInto}: the same call on a native worker thread,
+   * settling on the JavaScript thread. While it is pending, other calls on this object throw,
+   * except {@link ZipEntry.abort} (which cancels it) and the {@link ZipEntry.onPercentDone} /
+   * {@link ZipEntry.onProgressInfo} callbacks, which report progress while it runs.
+   *
+   * The promise rejects with an Error if the call fails; the full log is in
+   * {@link ZipEntry.lastErrorText}.
+   */
+  extractIntoAsync(dirPath: string): Promise<void>
+
+  /**
+   * Replaces this ZIP entry's existing contents with new text data.
+   *
+   * The text is converted to bytes using the character encoding specified
+   * by `charset`, such as `utf-8` or
+   * `ansi`.
+   *
+   * The resulting bytes become the complete contents of the entry.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link ZipEntry.lastErrorText}.
+   */
+  replaceString(strContent: string, charset: string): void
+
+  /**
+   * Sets the last-modified date/time for this ZIP entry.
+   *
+   * The `dt` argument is a `CkDateTime` object
+   * containing the date/time to store for the entry.
+   */
+  setDt(dt: CkDateTime): void
+
+  /**
+   * Inflates this entry and returns the uncompressed data as a string.
+   *
+   * The `srcCharset` argument specifies how the uncompressed
+   * bytes should be interpreted, such as `utf-8`,
+   * `utf-16`, or `windows-1252`.
+   *
+   * The `lineEndingBehavior` argument controls line-ending
+   * conversion:
+   *
+   * -
+   * `0` — leave line endings unchanged.
+   *
+   * -
+   * `1` — convert all line endings to bare LF.
+   *
+   * -
+   * `2` — convert all line endings to CRLF.
+   *
+   * This call blocks the JavaScript thread until Chilkat returns; from UI code prefer
+   * {@link ZipEntry.unzipToStringAsync}.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link ZipEntry.lastErrorText}.
+   */
+  unzipToString(lineEndingBehavior: number, srcCharset: string): string
+
+  /**
+   * Asynchronous form of {@link ZipEntry.unzipToString}: the same call on a native worker thread,
+   * settling on the JavaScript thread. While it is pending, other calls on this object throw,
+   * except {@link ZipEntry.abort} (which cancels it) and the {@link ZipEntry.onPercentDone} /
+   * {@link ZipEntry.onProgressInfo} callbacks, which report progress while it runs.
+   *
+   * The promise rejects with an Error if the call fails; the full log is in
+   * {@link ZipEntry.lastErrorText}.
+   */
+  unzipToStringAsync(lineEndingBehavior: number, srcCharset: string): Promise<string>
+
+  /**
+   * Unzips this entry to a stream.
+   *
+   * If called synchronously, the `toStream` must have a sink,
+   * such as a file or another stream object.
+   *
+   * If called asynchronously, the foreground thread can read from the
+   * stream while the unzip operation writes to it.
+   *
+   * This call blocks the JavaScript thread until Chilkat returns; from UI code prefer
+   * {@link ZipEntry.unzipToStreamAsync}.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link ZipEntry.lastErrorText}.
+   */
+  unzipToStream(toStream: Stream): void
+
+  /**
+   * Asynchronous form of {@link ZipEntry.unzipToStream}: the same call on a native worker thread,
+   * settling on the JavaScript thread. While it is pending, other calls on this object throw,
+   * except {@link ZipEntry.abort} (which cancels it) and the {@link ZipEntry.onPercentDone} /
+   * {@link ZipEntry.onProgressInfo} callbacks, which report progress while it runs.
+   *
+   * The promise rejects with an Error if the call fails; the full log is in
+   * {@link ZipEntry.lastErrorText}.
+   */
+  unzipToStreamAsync(toStream: Stream): Promise<void>
+
+  /**
+   * Unzips this entry directly into a `BinData` object.
+   *
+   * The uncompressed bytes are written to `binData`.
+   *
+   * This call blocks the JavaScript thread until Chilkat returns; from UI code prefer
+   * {@link ZipEntry.unzipToBdAsync}.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link ZipEntry.lastErrorText}.
+   */
+  unzipToBd(binData: BinData): void
+
+  /**
+   * Asynchronous form of {@link ZipEntry.unzipToBd}: the same call on a native worker thread,
+   * settling on the JavaScript thread. While it is pending, other calls on this object throw,
+   * except {@link ZipEntry.abort} (which cancels it) and the {@link ZipEntry.onPercentDone} /
+   * {@link ZipEntry.onProgressInfo} callbacks, which report progress while it runs.
+   *
+   * The promise rejects with an Error if the call fails; the full log is in
+   * {@link ZipEntry.lastErrorText}.
+   */
+  unzipToBdAsync(binData: BinData): Promise<void>
+
+  /**
+   * Unzips this entry as text and appends the result to a
+   * `StringBuilder`.
+   *
+   * The `srcCharset` argument specifies how the uncompressed
+   * bytes should be interpreted, such as `utf-8`,
+   * `utf-16`, or `windows-1252`.
+   *
+   * The `lineEndingBehavior` argument controls line-ending
+   * conversion:
+   *
+   * -
+   * `0` — leave line endings unchanged.
+   *
+   * -
+   * `1` — convert all line endings to bare LF.
+   *
+   * -
+   * `2` — convert all line endings to CRLF.
+   *
+   * This call blocks the JavaScript thread until Chilkat returns; from UI code prefer
+   * {@link ZipEntry.unzipToSbAsync}.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link ZipEntry.lastErrorText}.
+   */
+  unzipToSb(lineEndingBehavior: number, srcCharset: string, sb: StringBuilder): void
+
+  /**
+   * Asynchronous form of {@link ZipEntry.unzipToSb}: the same call on a native worker thread,
+   * settling on the JavaScript thread. While it is pending, other calls on this object throw,
+   * except {@link ZipEntry.abort} (which cancels it) and the {@link ZipEntry.onPercentDone} /
+   * {@link ZipEntry.onProgressInfo} callbacks, which report progress while it runs.
+   *
+   * The promise rejects with an Error if the call fails; the full log is in
+   * {@link ZipEntry.lastErrorText}.
+   */
+  unzipToSbAsync(lineEndingBehavior: number, srcCharset: string, sb: StringBuilder): Promise<void>
+
+  /**
+   * Updates this `ZipEntry` object so that it represents the
+   * next entry in the ZIP archive matching the specified wildcard pattern.
+   *
+   * The wildcard character `*` matches zero or more characters.
+   * Matching is performed against the full stored filename, including any
+   * relative path.
+   *
+   * The matching entry may be either a file entry or a directory entry.
+   *
+   * Returns `_TRUE_` if a matching entry is found. Returns
+   * `_FALSE_` if no further matching entry exists.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link ZipEntry.lastErrorText}.
+   */
+  getNextMatch(pattern: string): void
+
+  /**
+   * Updates this `ZipEntry` object so that it represents the
+   * next entry in the same ZIP archive.
+   *
+   * The next entry may be either a file entry or a directory entry.
+   *
+   * Returns `_TRUE_` if the object was advanced to the next
+   * entry. Returns `_FALSE_` if there are no more entries.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link ZipEntry.lastErrorText}.
+   */
+  getNext(): void
+
+  // ---- Events (ReactNativeGen_DESIGN.md §6) ----
+
+  /**
+   * Called with the percent completed (0..100) while a long-running method runs, when Chilkat
+   * can measure progress. Runs on the JavaScript thread, so it is only useful with the
+   * `...Async` methods (during a synchronous call the thread is busy and the events arrive
+   * after it returns). Assign `undefined` to remove.
+   */
+  onPercentDone?: (pctDone: number) => void
+
+  /**
+   * Called with a name/value pair of progress information while a long-running method runs
+   * (what is reported depends on the class and method). Runs on the JavaScript thread; see
+   * {@link ZipEntry.onPercentDone}. Assign `undefined` to remove.
+   */
+  onProgressInfo?: (name: string, value: string) => void
+
+  /**
+   * Requests that the pending `...Async` call on this object stop at its next progress check.
+   * The promise then rejects with Chilkat's abort error. Chilkat checks at least every
+   * `heartbeatMs` milliseconds on the classes that have that property, so set it (e.g. 250)
+   * for a responsive cancel. Harmless when nothing is pending.
+   */
+  abort(): void
+}