amule-ec-client 0.6.1 → 0.7.1

package/dist/index.js

@@ -1,6 +1,5 @@
-import { n as Packet, r as Flags, t as Request } from "./Request-C0UUuQIX.js";
-import { a as EcPrefs, i as ECTagName, n as ECOpCode, o as ProtocolVersion, r as ECSearchType, t as ECDetailLevel } from "./Codes-CjiW7Pdl.js";
-import { a as StringTag, c as UInt128Tag, d as UShortTag, f as findNumericTag, i as Ipv4Tag, l as UIntTag, n as DoubleTag, o as Tag, r as Hash16Tag, s as UByteTag, t as CustomTag, u as ULongTag } from "./Tag-CZF6BRMY.js";
+import { n as Packet, r as Flags, t as Request } from "./Request-YQ0nIM6b.js";
+import { _ as ECSearchType, a as StringTag, b as ProtocolVersion, c as UInt128Tag, d as UShortTag, f as findNumericTag, g as ECSearchFileDownloadStatus, h as ECOpCode, i as Ipv4Tag, l as UIntTag, m as ECDetailLevel, n as DoubleTag, o as Tag, p as findTag, r as Hash16Tag, s as UByteTag, t as CustomTag, u as ULongTag, v as ECTagName, y as EcPrefs } from "./Tag-D_Ybe5RQ.js";
 import { n as PARTSIZE, t as ChunkStatus } from "./download-details-OM0FJUhZ.js";
 import * as net from "net";
 import * as zlib from "zlib";
@@ -183,7 +182,11 @@ var TagParser = class {
 			case 5: return new ULongTag(name, value.length >= 8 ? value.readBigUInt64BE(0) : 0n);
 			case 10: return new UInt128Tag(name, value.length >= 16 ? this.parseUInt128(value) : 0n);
 			case 6: return new StringTag(name, value[value.length - 1] === 0 ? value.toString("utf-8", 0, value.length - 1) : value.toString("utf-8"));
-			case 7: return new DoubleTag(name, value.length >= 8 ? value.readDoubleBE(0) : 0);
+			case 7: {
+				const tag = new DoubleTag(name);
+				tag.parseValue(value);
+				return tag;
+			}
 			case 8: {
 				if (value.length !== 6) throw new InvalidECException(`Ipv4Tag value must be 6 bytes long, got ${value.length}`);
 				const address = `${value[0]}.${value[1]}.${value[2]}.${value[3]}`;
@@ -335,7 +338,7 @@ var TagEncoder = class {
 			case 4: return 4;
 			case 5: return 8;
 			case 10: return 16;
-			case 7: return 8;
+			case 7: return encoded.length;
 			case 8: return 6;
 			case 9: return 16;
 			default: return 0;
@@ -518,8 +521,8 @@ var PasswordHasher = class {
 	/**
 	* Hash a password with salt using MD5
 	*
-	* This matches aMule's password hashing algorithm (from jamule):
-	* 1. saltHash = MD5(salt.toHexString().uppercase())
+	* This matches aMule's password hashing algorithm (ExternalConn.cpp):
+	* 1. saltHash = MD5(salt formatted as "%lX")
 	* 2. passwordHash = MD5(password)
 	* 3. return MD5(passwordHash.toHex().lowercase() + saltHash.toHex().lowercase())
 	*
@@ -528,7 +531,7 @@ var PasswordHasher = class {
 	* @returns The hashed password as a Buffer
 	*/
 	static hash(password, salt) {
-		const saltHexUpper = salt.toString(16).toUpperCase().padStart(16, "0");
+		const saltHexUpper = salt.toString(16).toUpperCase();
 		const saltHash = crypto.createHash("md5").update(saltHexUpper, "utf-8").digest();
 		const passwordHashHex = crypto.createHash("md5").update(password, "utf-8").digest().toString("hex").toLowerCase();
 		const saltHashHex = saltHash.toString("hex").toLowerCase();
@@ -549,7 +552,7 @@ var PasswordHasher = class {
 /**
 * AmuleConnection - Manages the low-level connection to aMule EC
 */
-var AmuleConnection = class {
+var AmuleConnection = class AmuleConnection {
 	host;
 	port;
 	password;
@@ -560,6 +563,7 @@ var AmuleConnection = class {
 	pendingResponses = [];
 	connectionPromise;
 	requestTimeout = 0;
+	sessionGeneration = 0;
 	debug = false;
 	/**
 	* Enable or disable debug logging
@@ -595,6 +599,13 @@ var AmuleConnection = class {
 		return this.requestTimeout;
 	}
 	/**
+	* Monotonic counter incremented on every (re)connection attempt.
+	* Lets consumers detect that the daemon-side per-connection state was reset.
+	*/
+	getSessionGeneration() {
+		return this.sessionGeneration;
+	}
+	/**
 	* Reject and clear all pending responses.
 	*/
 	rejectAllPending(error) {
@@ -611,7 +622,9 @@ var AmuleConnection = class {
 		if (this.connectionPromise) return this.connectionPromise;
 		this.connectionPromise = (async () => {
 			this.connected = false;
+			this.sessionGeneration++;
 			if (this.socket) this.socket.destroy();
+			this.buffer = Buffer.allocUnsafe(0);
 			this.socket = new net.Socket();
 			if (this.timeout > 0) this.socket.setTimeout(this.timeout);
 			this.socket.on("data", (data) => this.handleData(Buffer.isBuffer(data) ? data : Buffer.from(data)));
@@ -621,6 +634,7 @@ var AmuleConnection = class {
 			try {
 				await this.connectSocket();
 				await this.authenticate();
+				this.socket?.setTimeout(0);
 				this.connected = true;
 			} finally {
 				this.connectionPromise = void 0;
@@ -633,11 +647,14 @@ var AmuleConnection = class {
 	*/
 	connectSocket() {
 		return new Promise((resolve, reject) => {
-			if (!this.socket) return reject(new CommunicationException("Socket not initialized"));
-			this.socket.connect(this.port, this.host, () => {
+			const socket = this.socket;
+			if (!socket) return reject(new CommunicationException("Socket not initialized"));
+			const onError = (error) => reject(error);
+			socket.once("error", onError);
+			socket.connect(this.port, this.host, () => {
+				socket.removeListener("error", onError);
 				resolve();
 			});
-			this.socket.once("error", reject);
 		});
 	}
 	/**
@@ -649,7 +666,7 @@ var AmuleConnection = class {
 		this.log("Sending client info...");
 		const saltPacket = await this.sendRequestNoAuth(clientInfoRequest);
 		this.log("Received salt response");
-		if (saltPacket.opCode === 3) throw new ServerException("Authentication failed: server rejected client");
+		if (saltPacket.opCode === 3) throw new ServerException(`Authentication failed: ${AmuleConnection.authFailReason(saltPacket) ?? "connection refused with no reason; the daemon usually does this when its EC password is empty (external connections disabled)"}`);
 		if (saltPacket.opCode !== 79) throw new ServerException(`Unexpected response to client info: ${saltPacket.opCode}`);
 		const saltResponse = AuthSaltResponse.fromPacket(saltPacket);
 		this.log("Salt:", saltResponse.salt);
@@ -659,11 +676,18 @@ var AmuleConnection = class {
 		this.log("Sending hashed password...");
 		const authPacket = await this.sendRequestNoAuth(authRequest);
 		this.log("Received auth response");
-		if (authPacket.opCode === 3) throw new ServerException("Authentication failed: invalid password");
+		if (authPacket.opCode === 3) throw new ServerException(`Authentication failed: ${AmuleConnection.authFailReason(authPacket) ?? "unknown reason"}`);
 		if (authPacket.opCode !== 4) throw new ServerException(`Unexpected auth response: ${authPacket.opCode}`);
 		this.log("Authentication successful!");
 	}
 	/**
+	* Extract the human-readable reason the daemon attaches to EC_OP_AUTH_FAIL packets.
+	*/
+	static authFailReason(packet) {
+		const reason = findTag(packet.tags, 0)?.getValue();
+		return typeof reason === "string" && reason.length > 0 ? reason : void 0;
+	}
+	/**
 	* Handle incoming data
 	*/
 	handleData(data) {
@@ -790,6 +814,7 @@ let SearchType = /* @__PURE__ */ function(SearchType) {
 */
 var AmuleClient = class {
 	connection;
+	updateState;
 	constructor(options) {
 		this.connection = new AmuleConnection(options.host, options.port, options.password, options.timeout || 0, options.requestTimeout || 0);
 	}
@@ -810,33 +835,63 @@ var AmuleClient = class {
 	* Reconnect to the server
 	*/
 	async reconnect() {
+		this.updateState = void 0;
 		await this.connection.reconnect();
 	}
 	/**
 	* Get server statistics
 	*/
 	async getStats() {
-		const { StatsRequest } = await import("./StatsRequest-CGGumOOx.js");
-		const { StatsResponseParser } = await import("./StatsResponse-DxQk686g.js");
+		const { StatsRequest } = await import("./StatsRequest-C9gBUvSq.js");
+		const { StatsResponseParser } = await import("./StatsResponse-KOk-xT6_.js");
 		const request = new StatsRequest();
 		const packet = await this.connection.sendRequest(request);
 		return StatsResponseParser.fromPacket(packet);
 	}
 	/**
-	* Get incremental updates for files, clients, servers, and friends
+	* 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.
+	*/
+	async getFileState() {
+		const { UpdateState } = await import("./UpdateState-LhdtiATk.js");
+		const generation = this.connection.getSessionGeneration();
+		if (!this.updateState || this.updateState.sessionGeneration !== generation) this.updateState = new UpdateState(generation);
+		return this.updateState;
+	}
+	/**
+	* 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.
 	*/
 	async getUpdate(detailLevel = 4) {
-		const { UpdateRequest } = await import("./UpdateRequest-g2ReOQ5m.js");
-		const { UpdateResponseParser } = await import("./UpdateResponse-CGwVjn0Y.js");
+		const { UpdateRequest } = await import("./UpdateRequest-csLQz7JO.js");
 		const request = new UpdateRequest(detailLevel);
 		const packet = await this.connection.sendRequest(request);
-		return UpdateResponseParser.fromPacket(packet);
+		return (await this.getFileState()).apply(packet);
+	}
+	/**
+	* 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.
+	*/
+	async getDownloadQueueWithSources() {
+		return (await this.getUpdate()).downloadQueue;
 	}
 	/**
 	* Start an asynchronous search
 	*/
 	async searchAsync(query, searchType, filters) {
-		const { SearchRequest } = await import("./SearchRequest-DQnKfA5Z.js");
+		const { SearchRequest } = await import("./SearchRequest-DaAKS4IO.js");
 		const request = new SearchRequest(query, searchType, filters);
 		await this.connection.sendRequest(request);
 		return query;
@@ -845,8 +900,8 @@ var AmuleClient = class {
 	* Get search status (0-1)
 	*/
 	async searchStatus() {
-		const { SearchStatusRequest } = await import("./SearchStatusRequest-B_xr4-72.js");
-		const { SearchProgressResponse } = await import("./SearchProgressResponse-C1CdzKnz.js");
+		const { SearchStatusRequest } = await import("./SearchStatusRequest-DuEa5ZYu.js");
+		const { SearchProgressResponse } = await import("./SearchProgressResponse-CkEgZGFE.js");
 		const request = new SearchStatusRequest();
 		const packet = await this.connection.sendRequest(request);
 		return SearchProgressResponse.fromPacket(packet).progress;
@@ -855,8 +910,8 @@ var AmuleClient = class {
 	* Get search results
 	*/
 	async searchResults() {
-		const { SearchResultsRequest } = await import("./SearchResultsRequest-2ejFGQmQ.js");
-		const { SearchResultsResponseParser } = await import("./SearchResultsResponse-DwmvbQop.js");
+		const { SearchResultsRequest } = await import("./SearchResultsRequest-B53jwjRH.js");
+		const { SearchResultsResponseParser } = await import("./SearchResultsResponse-C1l-bBja.js");
 		const request = new SearchResultsRequest();
 		const packet = await this.connection.sendRequest(request);
 		return SearchResultsResponseParser.fromPacket(packet);
@@ -877,7 +932,7 @@ var AmuleClient = class {
 	* Stop current search
 	*/
 	async searchStop() {
-		const { SearchStopRequest } = await import("./SearchStopRequest-8hwXobty.js");
+		const { SearchStopRequest } = await import("./SearchStopRequest-B5TZdMiB.js");
 		const request = new SearchStopRequest();
 		await this.connection.sendRequest(request);
 	}
@@ -885,7 +940,7 @@ var AmuleClient = class {
 	* Download a file from search results
 	*/
 	async downloadSearchResult(hash) {
-		const { DownloadFileRequest } = await import("./DownloadFileRequest-BjrroO3h.js");
+		const { DownloadFileRequest } = await import("./DownloadFileRequest-Db7oijyu.js");
 		const request = new DownloadFileRequest(hash);
 		await this.connection.sendRequest(request);
 	}
@@ -893,44 +948,50 @@ var AmuleClient = class {
 	* Download from an ed2k link
 	*/
 	async downloadEd2kLink(link) {
-		const { AddLinkRequest } = await import("./AddLinkRequest-D2IME4eb.js");
+		const { AddLinkRequest } = await import("./AddLinkRequest-CGv1H3PC.js");
 		const request = new AddLinkRequest(link);
 		await this.connection.sendRequest(request);
 	}
 	/**
-	* Get download queue
+	* 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.
 	*/
 	async getDownloadQueue() {
-		const { DownloadQueueRequest } = await import("./DownloadQueueRequest-Dil5hl3D.js");
-		const { DownloadQueueResponseParser } = await import("./DownloadQueueResponse-DUam_zNf.js");
+		const { DownloadQueueRequest } = await import("./DownloadQueueRequest-DdHRjl4L.js");
 		const request = new DownloadQueueRequest();
 		const packet = await this.connection.sendRequest(request);
-		return DownloadQueueResponseParser.fromPacket(packet).files;
+		return (await this.getFileState()).applyDownloadQueue(packet);
 	}
 	/**
 	* Get shared files
 	*/
 	async getSharedFiles() {
-		const { SharedFilesRequest } = await import("./SharedFilesRequest-B72XyRcA.js");
-		const { SharedFilesResponseParser } = await import("./SharedFilesResponse-CkqvYd3N.js");
+		const { SharedFilesRequest } = await import("./SharedFilesRequest-5mKKjzgt.js");
+		const { SharedFilesResponseParser } = await import("./SharedFilesResponse-CFl0NuO-.js").then((n) => n.n);
 		const request = new SharedFilesRequest();
 		const packet = await this.connection.sendRequest(request);
+		(await this.getFileState()).applySharedFiles(packet);
 		return SharedFilesResponseParser.fromPacket(packet).files;
 	}
 	/**
 	* Reload shared files list
 	*/
 	async reloadSharedFiles() {
-		const { ReloadSharedFilesRequest } = await import("./ReloadSharedFilesRequest-kt0Pxs8A.js");
+		const { ReloadSharedFilesRequest } = await import("./ReloadSharedFilesRequest-WD9iYLje.js");
 		const request = new ReloadSharedFilesRequest();
 		await this.connection.sendRequest(request);
 	}
 	/**
-	* Get client upload/download queue (clients we are uploading to/downloading from)
+	* 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().
 	*/
 	async getClientQueue() {
-		const { ClientQueueRequest } = await import("./ClientQueueRequest-DFfCiNcz.js");
-		const { ClientQueueResponseParser } = await import("./ClientQueueResponse-JTrBqrr1.js");
+		const { ClientQueueRequest } = await import("./ClientQueueRequest-mklt-KLi.js");
+		const { ClientQueueResponseParser } = await import("./ClientQueueResponse-RfXh2JGa.js").then((n) => n.n);
 		const request = new ClientQueueRequest();
 		const packet = await this.connection.sendRequest(request);
 		return ClientQueueResponseParser.fromPacket(packet).clients;
@@ -939,8 +1000,8 @@ var AmuleClient = class {
 	* Get the list of servers
 	*/
 	async getServerList() {
-		const { ServerListRequest } = await import("./ServerListRequest-BWXLGJib.js");
-		const { ServerListResponseParser } = await import("./ServerListResponse-BUJ7sz5p.js");
+		const { ServerListRequest } = await import("./ServerListRequest-B82686jD.js");
+		const { ServerListResponseParser } = await import("./ServerListResponse-M3C2OcfZ.js").then((n) => n.n);
 		const request = new ServerListRequest();
 		const packet = await this.connection.sendRequest(request);
 		return ServerListResponseParser.fromPacket(packet).servers;
@@ -949,7 +1010,7 @@ var AmuleClient = class {
 	* Connect to a specific server
 	*/
 	async connectToServer(ip, port) {
-		const { ServerConnectRequest } = await import("./ServerConnectRequest-BhNpGiEJ.js");
+		const { ServerConnectRequest } = await import("./ServerConnectRequest-BeB8RSBN.js");
 		const request = new ServerConnectRequest(ip, port);
 		await this.connection.sendRequest(request);
 	}
@@ -957,7 +1018,7 @@ var AmuleClient = class {
 	* Disconnect from the current server
 	*/
 	async disconnectFromServer() {
-		const { ServerDisconnectRequest } = await import("./ServerDisconnectRequest-BjCitLtU.js");
+		const { ServerDisconnectRequest } = await import("./ServerDisconnectRequest-CSkUHETP.js");
 		const request = new ServerDisconnectRequest();
 		await this.connection.sendRequest(request);
 	}
@@ -965,7 +1026,7 @@ var AmuleClient = class {
 	* Create a category
 	*/
 	async createCategory(category) {
-		const { CreateCategoryRequest } = await import("./CreateCategoryRequest-CRUMcPo5.js");
+		const { CreateCategoryRequest } = await import("./CreateCategoryRequest-Cyp9G7jU.js");
 		const request = new CreateCategoryRequest(category);
 		await this.connection.sendRequest(request);
 	}
@@ -973,7 +1034,7 @@ var AmuleClient = class {
 	* Update a category
 	*/
 	async updateCategory(id, category) {
-		const { UpdateCategoryRequest } = await import("./UpdateCategoryRequest-CzKJa_rC.js");
+		const { UpdateCategoryRequest } = await import("./UpdateCategoryRequest-BOYfb6Vn.js");
 		const request = new UpdateCategoryRequest(id, category);
 		await this.connection.sendRequest(request);
 	}
@@ -981,7 +1042,7 @@ var AmuleClient = class {
 	* Delete a category
 	*/
 	async deleteCategory(id) {
-		const { DeleteCategoryRequest } = await import("./DeleteCategoryRequest-C8v9oGZ-.js");
+		const { DeleteCategoryRequest } = await import("./DeleteCategoryRequest-DbLJ4mvi.js");
 		const request = new DeleteCategoryRequest(id);
 		await this.connection.sendRequest(request);
 	}
@@ -989,8 +1050,8 @@ var AmuleClient = class {
 	* Get all categories
 	*/
 	async getCategories() {
-		const { GetPreferencesRequest } = await import("./GetPreferencesRequest-DsxlghqT.js");
-		const { PreferencesResponseParser } = await import("./PreferencesResponse-8n1STWUZ.js");
+		const { GetPreferencesRequest } = await import("./GetPreferencesRequest-BlWGYNCP.js");
+		const { PreferencesResponseParser } = await import("./PreferencesResponse-migFtIG7.js");
 		const request = new GetPreferencesRequest(1);
 		const packet = await this.connection.sendRequest(request);
 		return PreferencesResponseParser.fromPacket(packet).categories;
@@ -999,7 +1060,7 @@ var AmuleClient = class {
 	* Set file category
 	*/
 	async setFileCategory(hash, categoryId) {
-		const { SetFileCategoryRequest } = await import("./SetFileCategoryRequest-VwroLBTV.js");
+		const { SetFileCategoryRequest } = await import("./SetFileCategoryRequest-C1jWsYO5.js");
 		const request = new SetFileCategoryRequest(hash, categoryId);
 		await this.connection.sendRequest(request);
 	}
@@ -1007,7 +1068,7 @@ var AmuleClient = class {
 	* Send a download command (PAUSE, RESUME, STOP, DELETE, etc.)
 	*/
 	async sendDownloadCommand(hash, command) {
-		const { DownloadCommandRequest } = await import("./DownloadCommandRequest-B3KV_bvm.js");
+		const { DownloadCommandRequest } = await import("./DownloadCommandRequest-DLU7RtYs.js");
 		const request = new DownloadCommandRequest(hash, command);
 		await this.connection.sendRequest(request);
 	}
@@ -1039,7 +1100,7 @@ var AmuleClient = class {
 	* Trigger a server list update from an URL.
 	*/
 	async updateServerListFromUrl(url) {
-		const { ServerUpdateFromUrlRequest } = await import("./ServerUpdateFromUrlRequest-K8C_d0UQ.js");
+		const { ServerUpdateFromUrlRequest } = await import("./ServerUpdateFromUrlRequest-BcvhRKgH.js");
 		const request = new ServerUpdateFromUrlRequest(url);
 		await this.connection.sendRequest(request);
 	}
@@ -1047,7 +1108,7 @@ var AmuleClient = class {
 	* Set upload priority for a shared file.
 	*/
 	async setSharedFilePriority(hash, priority) {
-		const { SharedFilePriorityRequest } = await import("./SharedFilePriorityRequest-7BriqAcr.js");
+		const { SharedFilePriorityRequest } = await import("./SharedFilePriorityRequest-CBqkaXaK.js");
 		const request = new SharedFilePriorityRequest(hash, priority);
 		await this.connection.sendRequest(request);
 	}
@@ -1055,8 +1116,8 @@ var AmuleClient = class {
 	* Get daemon preferences for general/connection/servers/security sections.
 	*/
 	async getPreferences() {
-		const { GetPreferencesRequest } = await import("./GetPreferencesRequest-DsxlghqT.js");
-		const { PreferencesDetailsResponseParser } = await import("./PreferencesDetailsResponse-DapscVQi.js");
+		const { GetPreferencesRequest } = await import("./GetPreferencesRequest-BlWGYNCP.js");
+		const { PreferencesDetailsResponseParser } = await import("./PreferencesDetailsResponse-BX6qUoga.js");
 		const request = new GetPreferencesRequest(2118);
 		const packet = await this.connection.sendRequest(request);
 		return PreferencesDetailsResponseParser.fromPacket(packet).preferences;
@@ -1066,10 +1127,10 @@ var AmuleClient = class {
 	*/
 	async setPreferences(preferences) {
 		if (!preferences.general && !preferences.connection && !preferences.servers && !preferences.security) return;
-		const { SetPreferencesRequest } = await import("./SetPreferencesRequest-KZ23VaBY.js");
+		const { SetPreferencesRequest } = await import("./SetPreferencesRequest-CNJVmeQl.js");
 		const request = new SetPreferencesRequest(preferences);
 		await this.connection.sendRequest(request);
 	}
 };
 //#endregion
-export { AmuleClient, AmuleException, ChunkStatus, CommunicationException, CustomTag, DoubleTag, DownloadCommand, ECDetailLevel, ECOpCode, ECSearchType, ECTagName, EcPrefs, FileStatus, Flags, Hash16Tag, InvalidECException, Ipv4Tag, PARTSIZE, Packet, PacketParser, PacketWriter, ProtocolVersion, SearchType, ServerException, StringTag, Tag, UByteTag, UInt128Tag, UIntTag, ULongTag, UShortTag };
+export { AmuleClient, AmuleException, ChunkStatus, CommunicationException, CustomTag, DoubleTag, DownloadCommand, ECDetailLevel, ECOpCode, ECSearchFileDownloadStatus, ECSearchType, ECTagName, EcPrefs, FileStatus, Flags, Hash16Tag, InvalidECException, Ipv4Tag, PARTSIZE, Packet, PacketParser, PacketWriter, ProtocolVersion, SearchType, ServerException, StringTag, Tag, UByteTag, UInt128Tag, UIntTag, ULongTag, UShortTag };

package/dist/rolldown-runtime-D7D4PA-g.js

@@ -0,0 +1,13 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+export { __exportAll as t };

package/dist/{utils-DBnUQnZ-.js → utils-CNoUroOI.js}

@@ -20,5 +20,15 @@ function toOptionalIp(value) {
 	if (value === void 0) return void 0;
 	return formatIp(value);
 }
+/**
+* Read the own numeric value of a tag (e.g. the ECID carried by EC_TAG_PARTFILE / EC_TAG_CLIENT container tags).
+* Returns undefined when the tag value is not numeric (string, buffer, ...).
+*/
+function tagOwnNumericValue(tag) {
+	if (!tag) return void 0;
+	const value = tag.getValue();
+	if (typeof value === "number") return value;
+	if (typeof value === "bigint") return Number(value);
+}
 //#endregion
-export { toOptionalNumber as i, toOptionalBool as n, toOptionalIp as r, formatIp as t };
+export { toOptionalNumber as a, toOptionalIp as i, tagOwnNumericValue as n, toOptionalBool as r, formatIp as t };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "amule-ec-client",
-	"version": "0.6.1",
+	"version": "0.7.1",
 	"description": "A TypeScript client for Amule EC API.",
 	"author": "José Carlos HR <joecarlhr@gmail.com>",
 	"license": "MIT",