amule-ec-client 0.6.1 → 0.7.1

package/dist/index.d.ts

@@ -12,33 +12,33 @@ interface ChunkInfo {
   partCount: number;
   sizeFull: number;
 }
-interface ParsedSource {
-  clientName: string;
-  userHash: string;
-  software: string;
-  softwareVersion: string;
-  score: number;
-  uploadSpeed: number;
-  downloadSpeed: number;
-  uploadState: number;
-  downloadState: number;
-  ip: string;
-  port: number;
-  remoteQueueRank: number;
-  waitingPosition: number;
-  identState: number;
-  obfuscationStatus: number;
-  remoteFilename: string;
-  availableParts: number;
-  sourceFrom: number;
-}
 interface SourceNameCount {
   name: string;
   count: number;
 }
+/**
+ * Raw diff entry of a partfile's source-names map, as sent by the daemon.
+ * `name` is only present when the entry is new for this connection; count 0 removes the entry.
+ */
+interface SourceNameEntry {
+  id: number;
+  name?: string;
+  count: number;
+}
+/**
+ * Raw part/gap/req status buffers of a partfile.
+ * Depending on the context they hold RLE-encoded wire data or RLE-decoded state.
+ */
+interface PartFileStatusBuffers {
+  partStatus?: Buffer;
+  gapStatus?: Buffer;
+  reqStatus?: Buffer;
+}
 //#endregion
 //#region src/model/index.d.ts
 interface AmuleFile {
+  /** ECID assigned by the daemon (EC protocol >= 0x0204). Stable while the daemon runs, used to link clients to files. */
+  ecid?: number;
   fileHashHexString?: string;
   fileName?: string;
   filePath?: string;
@@ -76,13 +76,15 @@ interface AmuleTransferringFile extends AmuleFile {
   downloadActiveTime?: number;
   availablePartCount?: number;
   a4AFAuto?: boolean;
-  hashingProgress?: boolean;
+  /** Number of already-hashed parts while the file is being (re)hashed */
+  hashedPartCount?: number;
   getLostDueToCorruption?: number;
   getGainDueToCompression?: number;
   totalPacketsSavedDueToICH?: number;
   a4afSources?: number[];
   chunkInfo?: ChunkInfo;
-  sources?: ParsedSource[];
+  /** Per-peer info of the sources of this download. Only filled by update-based methods (see AmuleClient.getDownloadQueueWithSources). */
+  sources?: AmuleUpDownClient[];
   sourceNames?: SourceNameCount[];
 }
 interface AmuleCategory {
@@ -109,6 +111,8 @@ interface AmuleServer {
   failedCount?: number;
 }
 interface AmuleUpDownClient {
+  /** ECID assigned by the daemon. Used to link this client to files via requestFileId/uploadFileId. */
+  ecid?: number;
   clientName?: string;
   userHashHexString?: string;
   userID?: number;
@@ -121,7 +125,9 @@ interface AmuleUpDownClient {
   serverIP?: string;
   serverPort?: number;
   serverName?: string;
+  /** Upload speed towards this client, in bytes/s */
   upSpeed?: number;
+  /** Download speed from this client, in bytes/s (the daemon sends kB/s; normalized on parse) */
   downSpeed?: number;
   uploadSession?: number;
   transferredDown?: number;
@@ -189,93 +195,6 @@ declare enum SearchType {
   WEB = 3
 }
 //#endregion
-//#region src/types/preferences.d.ts
-interface AmulePrefsGeneral {
-  userNick: string;
-  checkNewVersion: boolean;
-}
-interface AmulePrefsConnection {
-  uploadCapacity: number;
-  downloadCapacity: number;
-  maxUploadSpeed: number;
-  maxDownloadSpeed: number;
-  slotAllocation: number;
-  tcpPort: number;
-  udpPort: number;
-  maxFileSources: number;
-  maxConnections: number;
-  autoconnect: boolean;
-  reconnect: boolean;
-  networkED2K: boolean;
-  networkKademlia: boolean;
-}
-interface AmulePrefsServers {
-  removeDead: boolean;
-  deadRetries: number;
-  useScoreSystem: boolean;
-  smartIdCheck: boolean;
-  updateUrl: string;
-}
-interface AmulePrefsSecurity {
-  canSeeShares: number;
-  ipFilterClients: boolean;
-  ipFilterServers: boolean;
-  ipFilterAutoUpdate: boolean;
-  ipFilterUpdateUrl: string;
-  ipFilterLevel: number;
-  filterLan: boolean;
-  useSecIdent: boolean;
-  obfuscationSupported: boolean;
-  obfuscationRequested: boolean;
-  obfuscationRequired: boolean;
-}
-interface AmulePreferences {
-  general: AmulePrefsGeneral;
-  connection: AmulePrefsConnection;
-  servers: AmulePrefsServers;
-  security: AmulePrefsSecurity;
-}
-//#endregion
-//#region src/types/index.d.ts
-interface SearchFilters {
-  minSize?: number;
-  maxSize?: number;
-  fileType?: string;
-  extension?: string;
-  availability?: number;
-}
-interface ConnectionState {
-  ed2kConnected: boolean;
-  ed2kConnecting: boolean;
-  kadConnected: boolean;
-  kadFirewalled: boolean;
-  kadRunning: boolean;
-  serverIpv4?: {
-    address: string;
-    port: number;
-  };
-  serverPing?: number;
-  serverPrio?: number;
-  serverFailed?: number;
-  serverStatic?: boolean;
-  serverVersion?: string;
-  serverName?: string;
-  serverDescription?: string;
-  serverUsers?: number;
-  serverUsersMax?: number;
-  serverFiles?: number;
-  ed2kId?: number;
-  kadId?: number;
-  clientId?: number;
-}
-declare enum SearchFileDownloadStatus {
-  NEW = 0,
-  DOWNLOADED = 1,
-  QUEUED = 2,
-  CANCELED = 3,
-  QUEUEDCANCELED = 4
-}
-//#endregion
 //#region src/ec/Codes.d.ts
 declare enum ProtocolVersion {
   EC_CURRENT_PROTOCOL_VERSION = 516
@@ -662,6 +581,13 @@ declare enum ECSearchType {
   EC_SEARCH_KAD = 2,
   EC_SEARCH_WEB = 3
 }
+declare enum ECSearchFileDownloadStatus {
+  NEW = 0,
+  DOWNLOADED = 1,
+  QUEUED = 2,
+  CANCELED = 3,
+  QUEUEDCANCELED = 4
+}
 declare enum EcPrefs {
   EC_PREFS_CATEGORIES = 1,
   EC_PREFS_GENERAL = 2,
@@ -691,235 +617,107 @@ declare enum ECTagType {
   EC_TAGTYPE_UINT128 = 10
 }
 //#endregion
-//#region src/client/AmuleClient.d.ts
-interface AmuleClientOptions {
-  host: string;
-  port: number;
-  password: string;
-  timeout?: number;
-  requestTimeout?: number;
+//#region src/types/preferences.d.ts
+interface AmulePrefsGeneral {
+  userNick: string;
+  checkNewVersion: boolean;
 }
-interface StatsResponse {
-  id: number;
-  ed2kId: number;
-  kadId?: string;
-  connectedServer?: {
-    name?: string;
-    description?: string;
-    ip: string;
-    port: number;
-  };
-  connectionState?: any;
-  uploadOverhead: number;
-  downloadOverhead: number;
-  bannedCount: number;
-  loggerMessage: string[];
-  totalSentBytes: number;
-  totalReceivedBytes: number;
-  sharedFileCount: number;
-  uploadSpeed: number;
-  downloadSpeed: number;
-  uploadSpeedLimit: number;
-  downloadSpeedLimit: number;
-  uploadQueueLength: number;
-  totalSourceCount: number;
-  ed2kUsers: number;
-  kadUsers: number;
-  ed2kFiles: number;
-  kadFiles: number;
-  kadNodes: number;
+interface AmulePrefsConnection {
+  uploadCapacity: number;
+  downloadCapacity: number;
+  maxUploadSpeed: number;
+  maxDownloadSpeed: number;
+  slotAllocation: number;
+  tcpPort: number;
+  udpPort: number;
+  maxFileSources: number;
+  maxConnections: number;
+  autoconnect: boolean;
+  reconnect: boolean;
+  networkED2K: boolean;
+  networkKademlia: boolean;
 }
-interface SearchResultsResponse {
-  files: {
-    fileName: string;
-    hash: Buffer;
-    sizeFull: number;
-    downloadStatus: number;
-    completeSourceCount: number;
-    sourceCount: number;
-  }[];
+interface AmulePrefsServers {
+  removeDead: boolean;
+  deadRetries: number;
+  useScoreSystem: boolean;
+  smartIdCheck: boolean;
+  updateUrl: string;
 }
-interface UpdateResponse {
-  sharedFiles: AmuleFile[];
-  downloadQueue: AmuleTransferringFile[];
-  clients: AmuleUpDownClient[];
-  servers: AmuleServer[];
-  friends: AmuleFriend[];
+interface AmulePrefsSecurity {
+  canSeeShares: number;
+  ipFilterClients: boolean;
+  ipFilterServers: boolean;
+  ipFilterAutoUpdate: boolean;
+  ipFilterUpdateUrl: string;
+  ipFilterLevel: number;
+  filterLan: boolean;
+  useSecIdent: boolean;
+  obfuscationSupported: boolean;
+  obfuscationRequested: boolean;
+  obfuscationRequired: boolean;
 }
-declare class AmuleClient {
-  private connection;
-  constructor(options: AmuleClientOptions);
+interface AmulePreferences {
+  general: AmulePrefsGeneral;
+  connection: AmulePrefsConnection;
+  servers: AmulePrefsServers;
+  security: AmulePrefsSecurity;
+}
+//#endregion
+//#region src/types/index.d.ts
+interface SearchFilters {
+  minSize?: number;
+  maxSize?: number;
+  fileType?: string;
+  extension?: string;
+  availability?: number;
+}
+interface ConnectionState {
+  ed2kConnected: boolean;
+  ed2kConnecting: boolean;
+  kadConnected: boolean;
+  kadFirewalled: boolean;
+  kadRunning: boolean;
+  serverIpv4?: {
+    address: string;
+    port: number;
+  };
+  serverPing?: number;
+  serverPrio?: number;
+  serverFailed?: number;
+  serverStatic?: boolean;
+  serverVersion?: string;
+  serverName?: string;
+  serverDescription?: string;
+  serverUsers?: number;
+  serverUsersMax?: number;
+  serverFiles?: number;
+  ed2kId?: number;
+  kadId?: number;
+  clientId?: number;
+}
+//#endregion
+//#region src/ec/packet/Flags.d.ts
+/**
+ * Packet flags for EC protocol
+ */
+declare class Flags {
+  private static readonly FLAG_ACCEPTS;
+  private static readonly FLAG_ZLIB;
+  private static readonly FLAG_UTF8_NUMBERS;
+  private static readonly FLAG_ALWAYS_SET;
+  private readonly flags;
+  constructor(flags?: number);
   /**
-   * Set default timeout for individual request/response cycles.
-   * Use 0 to disable request timeout.
+   * Create flags from buffer
    */
-  setRequestTimeout(timeoutMs: number): void;
+  static fromBuffer(buffer: Buffer, offset?: number): Flags;
   /**
-   * Get current default timeout for requests.
+   * Write flags to buffer
    */
-  getRequestTimeout(): number;
+  writeToBuffer(buffer: Buffer, offset?: number): void;
   /**
-   * Reconnect to the server
-   */
-  reconnect(): Promise<void>;
-  /**
-   * Get server statistics
-   */
-  getStats(): Promise<StatsResponse>;
-  /**
-   * Get incremental updates for files, clients, servers, and friends
-   */
-  getUpdate(detailLevel?: ECDetailLevel): Promise<UpdateResponse>;
-  /**
-   * Start an asynchronous search
-   */
-  searchAsync(query: string, searchType?: SearchType, filters?: SearchFilters): Promise<string>;
-  /**
-   * Get search status (0-1)
-   */
-  searchStatus(): Promise<number>;
-  /**
-   * Get search results
-   */
-  searchResults(): Promise<SearchResultsResponse>;
-  /**
-   * Perform a synchronous search (waits for results)
-   */
-  searchSync(query: string, searchType?: SearchType, filters?: SearchFilters, timeout?: number): Promise<SearchResultsResponse>;
-  /**
-   * Stop current search
-   */
-  searchStop(): Promise<void>;
-  /**
-   * Download a file from search results
-   */
-  downloadSearchResult(hash: Buffer): Promise<void>;
-  /**
-   * Download from an ed2k link
-   */
-  downloadEd2kLink(link: string): Promise<void>;
-  /**
-   * Get download queue
-   */
-  getDownloadQueue(): Promise<AmuleTransferringFile[]>;
-  /**
-   * Get shared files
-   */
-  getSharedFiles(): Promise<AmuleFile[]>;
-  /**
-   * Reload shared files list
-   */
-  reloadSharedFiles(): Promise<void>;
-  /**
-   * Get client upload/download queue (clients we are uploading to/downloading from)
-   */
-  getClientQueue(): Promise<AmuleUpDownClient[]>;
-  /**
-   * Get the list of servers
-   */
-  getServerList(): Promise<AmuleServer[]>;
-  /**
-   * Connect to a specific server
-   */
-  connectToServer(ip?: string, port?: number): Promise<void>;
-  /**
-   * Disconnect from the current server
-   */
-  disconnectFromServer(): Promise<void>;
-  /**
-   * Create a category
-   */
-  createCategory(category: AmuleCategory): Promise<void>;
-  /**
-   * Update a category
-   */
-  updateCategory(id: number, category: AmuleCategory): Promise<void>;
-  /**
-   * Delete a category
-   */
-  deleteCategory(id: number): Promise<void>;
-  /**
-   * Get all categories
-   */
-  getCategories(): Promise<AmuleCategory[]>;
-  /**
-   * Set file category
-   */
-  setFileCategory(hash: Buffer, categoryId: number): Promise<void>;
-  /**
-   * Send a download command (PAUSE, RESUME, STOP, DELETE, etc.)
-   */
-  sendDownloadCommand(hash: Buffer, command: DownloadCommand): Promise<void>;
-  /**
-   * Pause a download
-   */
-  pauseDownload(hash: Buffer): Promise<void>;
-  /**
-   * Resume a download
-   */
-  resumeDownload(hash: Buffer): Promise<void>;
-  /**
-   * Stop a download
-   */
-  stopDownload(hash: Buffer): Promise<void>;
-  /**
-   * Delete a download
-   */
-  deleteDownload(hash: Buffer): Promise<void>;
-  /**
-   * Trigger a server list update from an URL.
-   */
-  updateServerListFromUrl(url: string): Promise<void>;
-  /**
-   * Set upload priority for a shared file.
-   */
-  setSharedFilePriority(hash: Buffer, priority: number): Promise<void>;
-  /**
-   * Get daemon preferences for general/connection/servers/security sections.
-   */
-  getPreferences(): Promise<AmulePreferences>;
-  /**
-   * Set daemon preferences. Only sections present in the input object are sent.
-   */
-  setPreferences(preferences: Partial<AmulePreferences>): Promise<void>;
-}
-//#endregion
-//#region src/exceptions/index.d.ts
-declare class AmuleException extends Error {
-  cause?: Error | undefined;
-  constructor(message: string, cause?: Error | undefined);
-}
-declare class InvalidECException extends AmuleException {
-  constructor(message: string, cause?: Error);
-}
-declare class CommunicationException extends AmuleException {
-  constructor(message: string, cause?: Error);
-}
-declare class ServerException extends AmuleException {
-  constructor(message: string, cause?: Error);
-}
-//#endregion
-//#region src/ec/packet/Flags.d.ts
-/**
- * Packet flags for EC protocol
- */
-declare class Flags {
-  private static readonly FLAG_ACCEPTS;
-  private static readonly FLAG_ZLIB;
-  private static readonly FLAG_UTF8_NUMBERS;
-  private static readonly FLAG_ALWAYS_SET;
-  private readonly flags;
-  constructor(flags?: number);
-  /**
-   * Create flags from buffer
-   */
-  static fromBuffer(buffer: Buffer, offset?: number): Flags;
-  /**
-   * Write flags to buffer
-   */
-  writeToBuffer(buffer: Buffer, offset?: number): void;
-  /**
-   * Check if UTF-8 number encoding is supported/accepted
+   * Check if UTF-8 number encoding is supported/accepted
    */
   isUtf8NumbersAccepted(): boolean;
   /**
@@ -1028,11 +826,18 @@ declare class StringTag extends Tag<string> {
   parseValue(value: Buffer): void;
   encodeValue(): Buffer;
 }
-declare class DoubleTag extends Tag<number> {
+/**
+ * EC_TAGTYPE_DOUBLE tags are transmitted as a null-terminated ASCII decimal string,
+ * not as a binary double (see CECTag(ec_tagname_t, double) in aMule's ECTag.cpp).
+ */
+declare class DoubleTag extends Tag<number> implements NumericTag {
   constructor(name: ECTagName, value?: number, subtags?: Tag<any>[], nameValue?: number);
   static withValue(name: ECTagName, value: number, subtags?: Tag<any>[]): DoubleTag;
   parseValue(value: Buffer): void;
   encodeValue(): Buffer;
+  getShort(): number;
+  getInt(): number;
+  getLong(): bigint;
 }
 interface Ipv4Value {
   address: string;
@@ -1056,7 +861,6 @@ declare class Packet {
   readonly opCode: ECOpCode;
   readonly flags: Flags;
   readonly tags: Tag<any>[];
-  private static readonly EC_CURRENT_PROTOCOL_VERSION;
   constructor(opCode: ECOpCode, flags?: Flags, tags?: Tag<any>[]);
   /**
    * Add a tag to the packet
@@ -1066,14 +870,10 @@ declare class Packet {
    * Add multiple tags to the packet
    */
   addTags(tags: Tag<any>[]): this;
-  /**
-   * Get protocol version
-   */
-  static getProtocolVersion(): number;
   /**
    * Find a tag by name
    */
-  findTag(tagName: number): Tag<any> | undefined;
+  findTag(tagName: ECTagName): Tag<any> | undefined;
   /**
    * Get all tags with a specific name
    */
@@ -1084,6 +884,250 @@ declare class Packet {
   hasTag(tagName: number): boolean;
 }
 //#endregion
+//#region src/response/StatsResponse.d.ts
+interface StatsResponse {
+  id: number;
+  ed2kId: number;
+  kadId?: string;
+  connectedServer?: {
+    name?: string;
+    description?: string;
+    ip: string;
+    port: number;
+  };
+  connectionState?: ConnectionState;
+  uploadOverhead: number;
+  downloadOverhead: number;
+  bannedCount: number;
+  loggerMessage: string[];
+  totalSentBytes: number;
+  totalReceivedBytes: number;
+  sharedFileCount: number;
+  uploadSpeed: number;
+  downloadSpeed: number;
+  uploadSpeedLimit: number;
+  downloadSpeedLimit: number;
+  uploadQueueLength: number;
+  totalSourceCount: number;
+  ed2kUsers: number;
+  kadUsers: number;
+  ed2kFiles: number;
+  kadFiles: number;
+  kadNodes: number;
+}
+//#endregion
+//#region src/response/SearchResultsResponse.d.ts
+interface SearchResultsResponse {
+  files: {
+    fileName: string;
+    hash: Buffer;
+    sizeFull: number;
+    downloadStatus: ECSearchFileDownloadStatus;
+    completeSourceCount: number;
+    sourceCount: number;
+  }[];
+}
+//#endregion
+//#region src/response/UpdateResponse.d.ts
+interface UpdateResponse {
+  sharedFiles: AmuleFile[];
+  downloadQueue: AmuleTransferringFile[];
+  clients: AmuleUpDownClient[];
+  servers: AmuleServer[];
+  friends: AmuleFriend[];
+}
+//#endregion
+//#region src/client/AmuleClient.d.ts
+interface AmuleClientOptions {
+  host: string;
+  port: number;
+  password: string;
+  timeout?: number;
+  requestTimeout?: number;
+}
+declare class AmuleClient {
+  private connection;
+  private updateState?;
+  constructor(options: AmuleClientOptions);
+  /**
+   * Set default timeout for individual request/response cycles.
+   * Use 0 to disable request timeout.
+   */
+  setRequestTimeout(timeoutMs: number): void;
+  /**
+   * Get current default timeout for requests.
+   */
+  getRequestTimeout(): number;
+  /**
+   * Reconnect to the server
+   */
+  reconnect(): Promise<void>;
+  /**
+   * Get server statistics
+   */
+  getStats(): Promise<StatsResponse>;
+  /**
+   * Per-connection file-detail state (diff baselines, source names, merged snapshots).
+   * The daemon diffs per connection and shares the diff state between the update,
+   * download-queue and shared-files requests, so this state must be fed by all of
+   * them (see UpdateState). Call only after sendRequest: connecting may have started
+   * a new session, which invalidates the previous state.
+   */
+  private getFileState;
+  /**
+   * Get updates for files, clients, servers, and friends.
+   *
+   * The underlying EC_OP_GET_UPDATE request is incremental per connection: the daemon
+   * only sends the fields that changed since the previous call. This method keeps a
+   * client-side cache and merges those diffs, so it always returns full snapshots.
+   * Downloads carry their connected peers in `sources` (linked via client requestFileId
+   * and file ecid). The cache is reset whenever the connection is re-established.
+   */
+  getUpdate(detailLevel?: ECDetailLevel): Promise<UpdateResponse>;
+  /**
+   * Get the download queue including per-peer source details.
+   *
+   * Unlike getDownloadQueue() (EC_OP_GET_DLOAD_QUEUE, which never includes peers),
+   * this uses the incremental update mechanism (see getUpdate), the only way the
+   * daemon exposes the clients each download is fed from. Each returned file has
+   * `sources` filled with the currently connected peers for that download.
+   */
+  getDownloadQueueWithSources(): Promise<AmuleTransferringFile[]>;
+  /**
+   * Start an asynchronous search
+   */
+  searchAsync(query: string, searchType?: SearchType, filters?: SearchFilters): Promise<string>;
+  /**
+   * Get search status (0-1)
+   */
+  searchStatus(): Promise<number>;
+  /**
+   * Get search results
+   */
+  searchResults(): Promise<SearchResultsResponse>;
+  /**
+   * Perform a synchronous search (waits for results)
+   */
+  searchSync(query: string, searchType?: SearchType, filters?: SearchFilters, timeout?: number): Promise<SearchResultsResponse>;
+  /**
+   * Stop current search
+   */
+  searchStop(): Promise<void>;
+  /**
+   * Download a file from search results
+   */
+  downloadSearchResult(hash: Buffer): Promise<void>;
+  /**
+   * Download from an ed2k link
+   */
+  downloadEd2kLink(link: string): Promise<void>;
+  /**
+   * Get download queue (EC_OP_GET_DLOAD_QUEUE, full detail).
+   *
+   * The response rebases the per-connection diff state the daemon shares with
+   * getUpdate()/getDownloadQueueWithSources(), so it is fed into the same
+   * client-side state: both methods stay consistent however they are interleaved,
+   * and chunkInfo/sourceNames are correct across repeated calls.
+   */
+  getDownloadQueue(): Promise<AmuleTransferringFile[]>;
+  /**
+   * Get shared files
+   */
+  getSharedFiles(): Promise<AmuleFile[]>;
+  /**
+   * Reload shared files list
+   */
+  reloadSharedFiles(): Promise<void>;
+  /**
+   * Get the upload queue: clients we are uploading to or that wait in our queue
+   * (EC_OP_GET_ULOAD_QUEUE). For download sources use getDownloadQueueWithSources().
+   */
+  getClientQueue(): Promise<AmuleUpDownClient[]>;
+  /**
+   * Get the list of servers
+   */
+  getServerList(): Promise<AmuleServer[]>;
+  /**
+   * Connect to a specific server
+   */
+  connectToServer(ip?: string, port?: number): Promise<void>;
+  /**
+   * Disconnect from the current server
+   */
+  disconnectFromServer(): Promise<void>;
+  /**
+   * Create a category
+   */
+  createCategory(category: AmuleCategory): Promise<void>;
+  /**
+   * Update a category
+   */
+  updateCategory(id: number, category: AmuleCategory): Promise<void>;
+  /**
+   * Delete a category
+   */
+  deleteCategory(id: number): Promise<void>;
+  /**
+   * Get all categories
+   */
+  getCategories(): Promise<AmuleCategory[]>;
+  /**
+   * Set file category
+   */
+  setFileCategory(hash: Buffer, categoryId: number): Promise<void>;
+  /**
+   * Send a download command (PAUSE, RESUME, STOP, DELETE, etc.)
+   */
+  sendDownloadCommand(hash: Buffer, command: DownloadCommand): Promise<void>;
+  /**
+   * Pause a download
+   */
+  pauseDownload(hash: Buffer): Promise<void>;
+  /**
+   * Resume a download
+   */
+  resumeDownload(hash: Buffer): Promise<void>;
+  /**
+   * Stop a download
+   */
+  stopDownload(hash: Buffer): Promise<void>;
+  /**
+   * Delete a download
+   */
+  deleteDownload(hash: Buffer): Promise<void>;
+  /**
+   * Trigger a server list update from an URL.
+   */
+  updateServerListFromUrl(url: string): Promise<void>;
+  /**
+   * Set upload priority for a shared file.
+   */
+  setSharedFilePriority(hash: Buffer, priority: number): Promise<void>;
+  /**
+   * Get daemon preferences for general/connection/servers/security sections.
+   */
+  getPreferences(): Promise<AmulePreferences>;
+  /**
+   * Set daemon preferences. Only sections present in the input object are sent.
+   */
+  setPreferences(preferences: Partial<AmulePreferences>): Promise<void>;
+}
+//#endregion
+//#region src/exceptions/index.d.ts
+declare class AmuleException extends Error {
+  cause?: Error | undefined;
+  constructor(message: string, cause?: Error | undefined);
+}
+declare class InvalidECException extends AmuleException {
+  constructor(message: string, cause?: Error);
+}
+declare class CommunicationException extends AmuleException {
+  constructor(message: string, cause?: Error);
+}
+declare class ServerException extends AmuleException {
+  constructor(message: string, cause?: Error);
+}
+//#endregion
 //#region src/ec/packet/PacketWriter.d.ts
 declare class PacketWriter {
   private static readonly HEADER_SIZE;
@@ -1126,4 +1170,4 @@ declare class PacketParser {
   static hasCompletePacket(buffer: Buffer): boolean;
 }
 //#endregion
-export { AmuleCategory, AmuleClient, type AmuleClientOptions, AmuleException, AmuleFile, AmuleFriend, type AmulePreferences, type AmulePrefsConnection, type AmulePrefsGeneral, type AmulePrefsSecurity, type AmulePrefsServers, AmuleServer, AmuleTransferringFile, AmuleUpDownClient, type ChunkInfo, ChunkStatus, CommunicationException, type ConnectionState, CustomTag, DoubleTag, DownloadCommand, ECDetailLevel, ECOpCode, ECSearchType, ECTagName, EcPrefs, FileStatus, Flags, Hash16Tag, InvalidECException, Ipv4Tag, PARTSIZE, Packet, PacketParser, PacketWriter, type ParsedSource, ProtocolVersion, type SearchFileDownloadStatus, type SearchFilters, type SearchResultsResponse, SearchType, ServerException, type SourceNameCount, type StatsResponse, StringTag, Tag, UByteTag, UInt128Tag, UIntTag, ULongTag, UShortTag, type UpdateResponse };
+export { AmuleCategory, AmuleClient, type AmuleClientOptions, AmuleException, AmuleFile, AmuleFriend, type AmulePreferences, type AmulePrefsConnection, type AmulePrefsGeneral, type AmulePrefsSecurity, type AmulePrefsServers, AmuleServer, AmuleTransferringFile, AmuleUpDownClient, type ChunkInfo, ChunkStatus, CommunicationException, type ConnectionState, CustomTag, DoubleTag, DownloadCommand, ECDetailLevel, ECOpCode, ECSearchFileDownloadStatus, type ECSearchFileDownloadStatus as SearchFileDownloadStatus, ECSearchType, ECTagName, EcPrefs, FileStatus, Flags, Hash16Tag, InvalidECException, Ipv4Tag, PARTSIZE, Packet, PacketParser, PacketWriter, type PartFileStatusBuffers, ProtocolVersion, type SearchFilters, type SearchResultsResponse, SearchType, ServerException, type SourceNameCount, type SourceNameEntry, type StatsResponse, StringTag, Tag, UByteTag, UInt128Tag, UIntTag, ULongTag, UShortTag, type UpdateResponse };