@chilkat/react-native 11.6.1

package/src/specs/SCard.nitro.ts

@@ -0,0 +1,739 @@
+// Generated by ReactNativeNs.RnGenerator -- do not edit.
+import type { HybridObject } from 'react-native-nitro-modules'
+import type { BinData } from './BinData.nitro'
+import type { JsonObject } from './JsonObject.nitro'
+import type { StringTable } from './StringTable.nitro'
+
+/**
+ * Communicate directly with smart card readers and cards through PC/SC.
+ *
+ * `SCard` is the low-level PC/SC smart card interface for
+ * applications that need direct reader and card communication. It supports
+ * reader discovery, reader connection, card status checking, APDU transmission,
+ * reader-control commands, status-change monitoring, transactions, and
+ * diagnostic access to underlying PC/SC errors. Use this class when the
+ * application needs APDU-level control rather than a higher-level certificate,
+ * minidriver, or PKCS#11 abstraction.
+ *
+ * **Reader discovery**
+ *
+ * Enumerate available PC/SC smart card readers and identify the reader the
+ * application should use.
+ *
+ * **Connect to cards**
+ *
+ * Connect to a reader/card, check card presence and status, and manage the
+ * active PC/SC connection.
+ *
+ * **Transmit APDUs**
+ *
+ * Send APDU commands directly to the card and receive the raw response
+ * bytes and status words.
+ *
+ * **Reader-control commands**
+ *
+ * Issue lower-level reader control commands when supported by the reader
+ * driver and PC/SC environment.
+ *
+ * **Status monitoring**
+ *
+ * Monitor reader or card status changes so applications can detect card
+ * insertion, removal, or state changes.
+ *
+ * **Transactions and diagnostics**
+ *
+ * Use PC/SC transactions for coordinated card access and inspect detailed
+ * error information when reader or card operations fail.
+ *
+ * **Common pattern:**
+ * Establish the PC/SC context, list readers, connect to the selected reader,
+ * check card status, transmit APDU commands, process the response bytes, and
+ * disconnect when finished. Use `SCard` for direct PC/SC
+ * reader and APDU-level work; use `Chilkat.ScMinidriver` for
+ * card-minidriver certificate and key-container operations, and
+ * `Chilkat.Pkcs11` for PKCS#11 token or HSM sessions.
+ *
+ * For an extended overview, see
+ * [SCard Class Overview](https://www.chilkatsoft.com/scard_class_overview.asp).
+ *
+ * Each `SCard` 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 SCard()`.
+ *
+ * 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 SCard.abort} and assigning {@link SCard.onPercentDone} / {@link SCard.onProgressInfo}.
+ */
+export interface SCard 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
+
+  /**
+   * Contains the string `user` or `system` if this object has established a context (by calling
+   * EstablishContext). Contains the empty string if no context is established.
+   *
+   * This property is read-only.
+   */
+  readonly context: string
+
+  /**
+   * The name of the currently connected smart card reader, or an empty string if not connected.
+   *
+   * This property is read-only.
+   */
+  readonly connectedReader: string
+
+  /**
+   * The name of the active protocol if connected smart card reader, or an empty string if not
+   * connected. Possible values are `T0`, `T1`, `raw`, `undefined`, or if not connected to a reader.
+   *
+   * This property is read-only.
+   */
+  readonly activeProtocol: string
+
+  /**
+   * The current status of the connected reader.  Possible values are:
+   *
+   * - `absent` - There is no card in the reader.
+   *
+   * - `present` - There is a card in the reader, but it has not been moved into position for use.
+   *
+   * - `swallowed` - There is a card in the reader in position for use. The card is not powered.
+   *
+   * - `powered` - Power is being provided to the card, but the reader driver is unaware of the mode
+   *   of the card.
+   *
+   * - `negotiable` - The card has been reset and is awaiting PTS negotiation.
+   *
+   * - `specific` - The card has been reset and specific communication protocols have been
+   *   established.
+   *
+   * This property is read-only.
+   */
+  readonly readerStatus: string
+
+  /**
+   * This is the Current ATR of a card in the connected reader.
+   *
+   * This property is read-only.
+   */
+  readonly cardAtr: string
+
+  /**
+   * The last error returned by an underlying PC/SC function.  Can be one of the following:
+   *
+   * - `SCARD_W_REMOVED_CARD` - The smart card has been removed, so that further communication is
+   *   not possible.
+   *
+   * - `SCARD_W_RESET_CARD` - The smart card has been reset, so any shared state information is
+   *   invalid.
+   *
+   * ...
+   *
+   * This property is read-only.
+   */
+  readonly scardError: string
+
+  /**
+   * For Linux systems only. Specifies the full path of the libpcsclite.so shared lib. This property
+   * should only be used if the libpcsclite.so is in a non-standard location or if Chilkat cannot
+   * automatically located it.
+   */
+  pcscLibPath: string
+
+  // ---- Methods ----
+
+  /**
+   * Creates an Application Context to the PC/SC Resource Manager. This must be the first WinSCard
+   * function called in a PC/SC application. The `scope` can be `user` or `system`. After calling,
+   * this object will have context and all other methods will use the established context. The
+   * `Context` property will hold the value `user` or `system` if context was established, or will
+   * be empty if no context was established.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link SCard.lastErrorText}.
+   */
+  establishContext(scope: string): void
+
+  /**
+   * Destroys a communication context to the PC/SC Resource Manager. This must be the last function
+   * called in a PC/SC application.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link SCard.lastErrorText}.
+   */
+  releaseContext(): void
+
+  /**
+   * Returns a list of currently available readers on the system.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link SCard.lastErrorText}.
+   */
+  listReaders(st: StringTable): void
+
+  /**
+   * Establish a connection to a reader. The `reader` is the name of a reader returned from
+   * ListReaders. The `shareMode` can be `shared`, `exclusive`, or `direct`. The `preferredProtocol`
+   * can be `0` (valid only if the shareMode = `direct`), `T0`, `T1`, `raw`, or `no_preference`. (No
+   * preference is effectively T0 or T1.)
+   *
+   * If successful, the state of this object instance is that it's connected to the reader.
+   */
+  connect(reader: string, shareMode: string, preferredProtocol: string): boolean
+
+  /**
+   * Terminates a connection with a reader.   The `disposition` can be one of the following values:
+   *
+   * - `leave`: Do nothing.
+   *
+   * - `reset`: Reset the card (warm reset).
+   *
+   * - `unpower`: Power down the card (cold reset).
+   *
+   * - `eject`: Eject the card.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link SCard.lastErrorText}.
+   */
+  disconnect(disposition: string): void
+
+  /**
+   * Check the current status of the currently connected reader. Calling this method updates the
+   * ReaderStatus, ActiveProtocol, and CardAtr properties. If this method returns `false`, none of
+   * the properties are updated.
+   */
+  checkStatus(): boolean
+
+  /**
+   * Reestablishes a connection to a reader that was previously connected to using Connect().
+   *
+   * In a multi application environment it is possible for an application to reset the card in
+   * shared mode. When this occurs any other application trying to access certain commands will be
+   * returned the value SCARD_W_RESET_CARD. When this occurs Reconnect() must be called in order to
+   * acknowledge that the card was reset and allow it to change its state accordingly.
+   *
+   * The `shareMode` can be `shared`, `exclusive`, or `direct`. The `preferredProtocol` can be `0`
+   * (valid only if the shareMode = `direct`), `T0`, `T1`, `raw`, or `no_preference`. (No preference
+   * is effectively T0 or T1.) The `action` is the desired action taken on the card/reader. It can
+   * be `leave`, `reset`, `unpower`, or `eject`.
+   *
+   * If successful, the state of this object instance is that it's connected to the reader.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link SCard.lastErrorText}.
+   */
+  reconnect(shareMode: string, preferredProtocol: string, action: string): void
+
+  /**
+   * Blocks execution until the current availability of the cards in a specific set of readers
+   * changes.
+   *
+   * This function receives a list of reader names in `stReaderNames`. It then blocks waiting for a
+   * change in state to occur for a maximum blocking time of `maxWaitMs` (in milliseconds) or
+   * forever if 0 is used.
+   *
+   * Information about the current reader states and which reader(s) changed is returned in `json`.
+   * See the example below for more information.
+   *
+   * To wait for a reader event (reader added or removed) you may use the special reader name
+   * `\\?PnP?\Notification`.
+   *
+   * To cancel the ongoing call, call Cancel().
+   *
+   * The `stReaderNames` contains the reader names to check. The `json` is empty on input, and if
+   * the call returns success contains information about the state (after the event change) of each
+   * reader.
+   *
+   * This call blocks the JavaScript thread until Chilkat returns; from UI code prefer
+   * {@link SCard.getStatusChangeAsync}.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link SCard.lastErrorText}.
+   */
+  getStatusChange(maxWaitMs: number, stReaderNames: StringTable, json: JsonObject): void
+
+  /**
+   * Asynchronous form of {@link SCard.getStatusChange}: 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 SCard.abort} (which cancels it) and the {@link SCard.onPercentDone} /
+   * {@link SCard.onProgressInfo} callbacks, which report progress while it runs.
+   *
+   * The promise rejects with an Error if the call fails; the full log is in
+   * {@link SCard.lastErrorText}.
+   */
+  getStatusChangeAsync(maxWaitMs: number, stReaderNames: StringTable, json: JsonObject): Promise<void>
+
+  /**
+   * Cancels an ongoing GetStatusChange method call. This would be called from a separate thread in
+   * your application if GetStatusChange was called synchronously.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link SCard.lastErrorText}.
+   */
+  getStatusChangeCancel(): void
+
+  /**
+   * Sends an APDU to the smart card contained in the currently connected reader. The `protocolName`
+   * can be `T0`, `T1`, or `raw`. The APDU to be sent is contained in `bdSend`. The response from
+   * the card is contained in `bdRecv`. The `maxRecvLen` is the maximum response size (in bytes)
+   * willing to be accepted.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link SCard.lastErrorText}.
+   */
+  transmit(protocolName: string, bdSend: BinData, bdRecv: BinData, maxRecvLen: number): void
+
+  /**
+   * Establishes a temporary exclusive access mode for doing a series of commands in a transaction.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link SCard.lastErrorText}.
+   */
+  beginTransaction(): void
+
+  /**
+   * Ends a previously begun transaction. The `disposition` is the action to be taken on the reader,
+   * and can be `leave` which is to do nothing, `reset`, `unpower`, or `eject`.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link SCard.lastErrorText}.
+   */
+  endTransaction(disposition: string): void
+
+  /**
+   * Sends an APDU to the smart card contained in the currently connected reader. The `protocolName`
+   * can be `T0`, `T1`, or `raw`. The APDU (in hexadecimal) to be sent is passed in `apduHex`. The
+   * response from the card is contained in `bdRecv`. The `maxRecvLen` is the maximum response size
+   * (in bytes) willing to be accepted.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link SCard.lastErrorText}.
+   */
+  transmitHex(protocolName: string, apduHex: string, bdRecv: BinData, maxRecvLen: number): void
+
+  /**
+   * Sends a command directly to the IFD Handler (reader driver) to be processed by the reader.
+   *
+   * This is useful for creating client side reader drivers for functions like PIN pads, biometrics,
+   * or other extensions to the normal smart card reader that are not normally handled by PC/SC.
+   *
+   * The command data is sent in `bdSend`.  The response is written to `bdRecv`.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link SCard.lastErrorText}.
+   */
+  sendControl(controlCode: number, bdSend: BinData, bdRecv: BinData): void
+
+  /**
+   * Sends a command directly to the IFD Handler (reader driver) to be processed by the reader.
+   *
+   * This is useful for creating client side reader drivers for functions like PIN pads, biometrics,
+   * or other extensions to the normal smart card reader that are not normally handled by PC/SC.
+   *
+   * The command data is provided as a hex string in `sendData`. The response is written to
+   * `bdRecv`.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link SCard.lastErrorText}.
+   */
+  sendControlHex(controlCode: number, sendData: string, bdRecv: BinData): void
+
+  /**
+   * Get an attribute from the IFD Handler (reader driver).
+   *
+   * The `attr` can be one of the following:
+   *
+   * - `ASYNC_PROTOCOL_TYPES`
+   *
+   * - `ATR_STRING`
+   *
+   * - `CHANNEL_ID`
+   *
+   * - `CHARACTERISTICS`
+   *
+   * - `CURRENT_BWT`
+   *
+   * - `CURRENT_CLK`
+   *
+   * - `CURRENT_CWT`
+   *
+   * - `CURRENT_D`
+   *
+   * - `CURRENT_EBC_ENCODING`
+   *
+   * - `CURRENT_F`
+   *
+   * - `CURRENT_IFSC`
+   *
+   * - `CURRENT_IFSD`
+   *
+   * - `CURRENT_IO_STATE`
+   *
+   * - `CURRENT_N`
+   *
+   * - `CURRENT_PROTOCOL_TYPE`
+   *
+   * - `CURRENT_W`
+   *
+   * - `DEFAULT_CLK`
+   *
+   * - `DEFAULT_DATA_RATE`
+   *
+   * - `DEVICE_FRIENDLY_NAME`
+   *
+   * - `DEVICE_IN_USE`
+   *
+   * - `DEVICE_SYSTEM_NAME`
+   *
+   * - `DEVICE_UNIT`
+   *
+   * - `ESC_AUTHREQUEST`
+   *
+   * - `ESC_CANCEL`
+   *
+   * - `ESC_RESET`
+   *
+   * - `EXTENDED_BWT`
+   *
+   * - `ICC_INTERFACE_STATUS`
+   *
+   * - `ICC_PRESENCE`
+   *
+   * - `ICC_TYPE_PER_ATR`
+   *
+   * - `MAX_CLK`
+   *
+   * - `MAX_DATA_RATE`
+   *
+   * - `MAX_IFSD`
+   *
+   * - `MAXINPUT`
+   *
+   * - `POWER_MGMT_SUPPORT`
+   *
+   * - `SUPRESS_T1_IFS_REQUEST`
+   *
+   * - `SYNC_PROTOCOL_TYPES`
+   *
+   * - `USER_AUTH_INPUT_DEVICE`
+   *
+   * - `USER_TO_CARD_AUTH_DEVICE`
+   *
+   * - `VENDOR_IFD_SERIAL_NO`
+   *
+   * - `VENDOR_IFD_TYPE`
+   *
+   * - `VENDOR_IFD_VERSION`
+   *
+   * - `VENDOR_NAME`
+   *
+   * The attribute data is returned in `bd`.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link SCard.lastErrorText}.
+   */
+  getAttrib(attr: string, bd: BinData): void
+
+  /**
+   * Get a string typed attribute from the IFD Handler (reader driver).
+   *
+   * The `attr` can be one of the following, but should be limited to the particular attributes that
+   * return string values.
+   *
+   * - `ASYNC_PROTOCOL_TYPES`
+   *
+   * - `ATR_STRING`
+   *
+   * - `CHANNEL_ID`
+   *
+   * - `CHARACTERISTICS`
+   *
+   * - `CURRENT_BWT`
+   *
+   * - `CURRENT_CLK`
+   *
+   * - `CURRENT_CWT`
+   *
+   * - `CURRENT_D`
+   *
+   * - `CURRENT_EBC_ENCODING`
+   *
+   * - `CURRENT_F`
+   *
+   * - `CURRENT_IFSC`
+   *
+   * - `CURRENT_IFSD`
+   *
+   * - `CURRENT_IO_STATE`
+   *
+   * - `CURRENT_N`
+   *
+   * - `CURRENT_PROTOCOL_TYPE`
+   *
+   * - `CURRENT_W`
+   *
+   * - `DEFAULT_CLK`
+   *
+   * - `DEFAULT_DATA_RATE`
+   *
+   * - `DEVICE_FRIENDLY_NAME`
+   *
+   * - `DEVICE_IN_USE`
+   *
+   * - `DEVICE_SYSTEM_NAME`
+   *
+   * - `DEVICE_UNIT`
+   *
+   * - `ESC_AUTHREQUEST`
+   *
+   * - `ESC_CANCEL`
+   *
+   * - `ESC_RESET`
+   *
+   * - `EXTENDED_BWT`
+   *
+   * - `ICC_INTERFACE_STATUS`
+   *
+   * - `ICC_PRESENCE`
+   *
+   * - `ICC_TYPE_PER_ATR`
+   *
+   * - `MAX_CLK`
+   *
+   * - `MAX_DATA_RATE`
+   *
+   * - `MAX_IFSD`
+   *
+   * - `MAXINPUT`
+   *
+   * - `POWER_MGMT_SUPPORT`
+   *
+   * - `SUPRESS_T1_IFS_REQUEST`
+   *
+   * - `SYNC_PROTOCOL_TYPES`
+   *
+   * - `USER_AUTH_INPUT_DEVICE`
+   *
+   * - `USER_TO_CARD_AUTH_DEVICE`
+   *
+   * - `VENDOR_IFD_SERIAL_NO`
+   *
+   * - `VENDOR_IFD_TYPE`
+   *
+   * - `VENDOR_IFD_VERSION`
+   *
+   * - `VENDOR_NAME`
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link SCard.lastErrorText}.
+   */
+  getAttribStr(attr: string): string
+
+  /**
+   * Get an unsigned integer typed attribute from the IFD Handler (reader driver).
+   *
+   * The `attr` can be one of the following, but should be limited to the particular attributes that
+   * return unsigned integer values.
+   *
+   * - `ASYNC_PROTOCOL_TYPES`
+   *
+   * - `ATR_STRING`
+   *
+   * - `CHANNEL_ID`
+   *
+   * - `CHARACTERISTICS`
+   *
+   * - `CURRENT_BWT`
+   *
+   * - `CURRENT_CLK`
+   *
+   * - `CURRENT_CWT`
+   *
+   * - `CURRENT_D`
+   *
+   * - `CURRENT_EBC_ENCODING`
+   *
+   * - `CURRENT_F`
+   *
+   * - `CURRENT_IFSC`
+   *
+   * - `CURRENT_IFSD`
+   *
+   * - `CURRENT_IO_STATE`
+   *
+   * - `CURRENT_N`
+   *
+   * - `CURRENT_PROTOCOL_TYPE`
+   *
+   * - `CURRENT_W`
+   *
+   * - `DEFAULT_CLK`
+   *
+   * - `DEFAULT_DATA_RATE`
+   *
+   * - `DEVICE_FRIENDLY_NAME`
+   *
+   * - `DEVICE_IN_USE`
+   *
+   * - `DEVICE_SYSTEM_NAME`
+   *
+   * - `DEVICE_UNIT`
+   *
+   * - `ESC_AUTHREQUEST`
+   *
+   * - `ESC_CANCEL`
+   *
+   * - `ESC_RESET`
+   *
+   * - `EXTENDED_BWT`
+   *
+   * - `ICC_INTERFACE_STATUS`
+   *
+   * - `ICC_PRESENCE`
+   *
+   * - `ICC_TYPE_PER_ATR`
+   *
+   * - `MAX_CLK`
+   *
+   * - `MAX_DATA_RATE`
+   *
+   * - `MAX_IFSD`
+   *
+   * - `MAXINPUT`
+   *
+   * - `POWER_MGMT_SUPPORT`
+   *
+   * - `SUPRESS_T1_IFS_REQUEST`
+   *
+   * - `SYNC_PROTOCOL_TYPES`
+   *
+   * - `USER_AUTH_INPUT_DEVICE`
+   *
+   * - `USER_TO_CARD_AUTH_DEVICE`
+   *
+   * - `VENDOR_IFD_SERIAL_NO`
+   *
+   * - `VENDOR_IFD_TYPE`
+   *
+   * - `VENDOR_IFD_VERSION`
+   *
+   * - `VENDOR_NAME`
+   *
+   * Returns 0xFFFFFFFF on failure.
+   */
+  getAttribUint(attr: string): number
+
+  /**
+   * Returns a list of currently available reader groups on the system. The reader groups are
+   * returned in `readerGroups`.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link SCard.lastErrorText}.
+   */
+  listReaderGroups(readerGroups: StringTable): void
+
+  /**
+   * Returns JSON containing information about the smartcards currently inserted into readers.
+   *
+   * @throws Error if the call fails (the message names the reason); the full log is in
+   * {@link SCard.lastErrorText}.
+   */
+  findSmartcards(json: JsonObject): 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 SCard.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
+}