@satianurag/hiero-mirror-client 0.1.1 → 0.2.0

package/dist/index.cjs

@@ -229,7 +229,11 @@ function createErrorFromResponse(statusCode, body, rawBody, headers) {
 			const retryAfterHeader = headers?.get("retry-after");
 			if (retryAfterHeader) {
 				const parsed = Number.parseInt(retryAfterHeader, 10);
-				if (!Number.isNaN(parsed)) retryAfter = parsed;
+				if (!Number.isNaN(parsed) && String(parsed) === retryAfterHeader.trim()) retryAfter = parsed;
+				else {
+					const dateMs = Date.parse(retryAfterHeader);
+					if (!Number.isNaN(dateMs)) retryAfter = Math.max(0, Math.ceil((dateMs - Date.now()) / 1e3));
+				}
 			}
 			return new HieroRateLimitError(message, {
 				retryAfter,
@@ -261,35 +265,49 @@ function createParseError(rawBody, statusCode, cause) {
 //#endregion
 //#region src/http/etag-cache.ts
 /**
-* Simple in-memory ETag cache.
+* LRU ETag cache with configurable max size and TTL.
 *
-* Keys are normalized URLs (no trailing slashes).
+* Uses `Map` insertion order for LRU tracking:
+* accessing an entry deletes and re-inserts it so it moves to the end.
+* Eviction removes the oldest (first) entry.
 */
 var ETagCache = class {
 	store = /* @__PURE__ */ new Map();
+	maxSize;
+	ttlMs;
+	constructor(options) {
+		this.maxSize = options?.maxSize ?? 500;
+		this.ttlMs = options?.ttlMs ?? 3e5;
+	}
 	/**
 	* Look up a cached ETag for the given URL.
-	*
-	* @returns The cached ETag string, or `undefined` if not cached.
+	* Returns `undefined` if not cached or expired.
 	*/
 	getETag(url) {
-		return this.store.get(this.normalizeKey(url))?.etag;
+		return this.getEntry(url)?.etag;
 	}
 	/**
 	* Look up the cached response body for the given URL.
-	*
-	* @returns The cached body, or `undefined` if not cached.
+	* Returns `undefined` if not cached or expired.
 	*/
 	getCachedBody(url) {
-		return this.store.get(this.normalizeKey(url))?.body;
+		return this.getEntry(url)?.body;
 	}
 	/**
 	* Store or update a cache entry.
+	* If the cache is full, evicts the least-recently-used entry.
 	*/
 	set(url, etag, body) {
-		this.store.set(this.normalizeKey(url), {
+		const key = this.normalizeKey(url);
+		this.store.delete(key);
+		while (this.store.size >= this.maxSize) {
+			const oldest = this.store.keys().next().value;
+			if (oldest !== void 0) this.store.delete(oldest);
+		}
+		this.store.set(key, {
 			etag,
-			body
+			body,
+			createdAt: Date.now()
 		});
 	}
 	/**
@@ -311,6 +329,21 @@ var ETagCache = class {
 		return this.store.size;
 	}
 	/**
+	* Internal: get entry if not expired, refreshing LRU position.
+	*/
+	getEntry(url) {
+		const key = this.normalizeKey(url);
+		const entry = this.store.get(key);
+		if (!entry) return void 0;
+		if (Date.now() - entry.createdAt > this.ttlMs) {
+			this.store.delete(key);
+			return;
+		}
+		this.store.delete(key);
+		this.store.set(key, entry);
+		return entry;
+	}
+	/**
 	* Normalize a URL for use as a cache key.
 	*
 	* EC43: Removes trailing slashes.
@@ -448,20 +481,20 @@ var RateLimiter = class {
 		}
 		const deficit = 1 - this.tokens;
 		const waitMs = Math.ceil(deficit / this.refillRate);
+		if (signal?.aborted) throw signal.reason;
 		await new Promise((resolve, reject) => {
-			if (signal?.aborted) {
-				reject(signal.reason);
-				return;
-			}
+			const onAbort = () => {
+				clearTimeout(timer);
+				reject(signal?.reason);
+			};
 			const timer = setTimeout(() => {
+				if (signal) signal.removeEventListener("abort", onAbort);
 				this.refill();
 				this.tokens -= 1;
 				resolve();
 			}, waitMs);
-			signal?.addEventListener("abort", () => {
-				clearTimeout(timer);
-				reject(signal.reason);
-			}, { once: true });
+			if (!signal) return;
+			signal.addEventListener("abort", onAbort, { once: true });
 		});
 	}
 	/**
@@ -502,7 +535,7 @@ function isRetryableStatus(statusCode) {
 */
 function isRetryableError(error) {
 	if (error instanceof TypeError) return true;
-	if (error instanceof DOMException && error.name === "AbortError") return false;
+	if (error instanceof DOMException && (error.name === "AbortError" || error.name === "TimeoutError")) return false;
 	return false;
 }
 /**
@@ -536,11 +569,15 @@ function sleep(ms, signal) {
 			reject(signal.reason);
 			return;
 		}
-		const timer = setTimeout(resolve, ms);
-		signal?.addEventListener("abort", () => {
+		const timer = setTimeout(() => {
+			if (signal) signal.removeEventListener("abort", onAbort);
+			resolve();
+		}, ms);
+		const onAbort = () => {
 			clearTimeout(timer);
-			reject(signal.reason);
-		}, { once: true });
+			reject(signal?.reason);
+		};
+		signal?.addEventListener("abort", onAbort, { once: true });
 	});
 }
 //#endregion
@@ -610,13 +647,14 @@ function buildUrl(baseUrl, path, params) {
 * Core HTTP client for the Hiero Mirror Node SDK.
 *
 * Wraps `fetch` with:
-* - Timeout via `AbortController`
+* - Timeout via `AbortSignal.timeout()` + `AbortSignal.any()`
 * - Safe JSON parsing (int64 precision)
 * - Error factory integration
 * - Rate limiting
 * - Request deduplication
 * - Retry with exponential backoff
-* - ETag/conditional request support (stubbed for Step 11)
+* - ETag/conditional request support with LRU eviction
+* - Request interceptors (beforeRequest / afterResponse)
 *
 * @internal
 */
@@ -629,6 +667,8 @@ var HttpClient = class {
 	etagCache;
 	logger;
 	fetchFn;
+	beforeRequestHooks;
+	afterResponseHooks;
 	constructor(options) {
 		this.baseUrl = options.baseUrl;
 		this.timeout = options.timeout ?? 3e4;
@@ -640,6 +680,16 @@ var HttpClient = class {
 		this.etagCache = new ETagCache();
 		this.logger = options.logger ?? {};
 		this.fetchFn = options.fetch ?? globalThis.fetch.bind(globalThis);
+		this.beforeRequestHooks = options.beforeRequest ?? [];
+		this.afterResponseHooks = options.afterResponse ?? [];
+	}
+	/**
+	* Clears internal caches and resets state.
+	* Call this when you are done with the client to free resources.
+	*/
+	destroy() {
+		this.etagCache.clear();
+		this.inflight.clear();
 	}
 	/**
 	* Performs a GET request with in-flight deduplication.
@@ -691,28 +741,40 @@ var HttpClient = class {
 		for (let attempt = 0; attempt <= this.retryOptions.maxRetries; attempt++) try {
 			await this.rateLimiter.acquire(options?.signal);
 			const timeoutMs = options?.timeout ?? this.timeout;
-			const controller = new AbortController();
-			const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
-			if (options?.signal) options.signal.addEventListener("abort", () => controller.abort(options.signal?.reason), { once: true });
+			const signals = [AbortSignal.timeout(timeoutMs)];
+			if (options?.signal) signals.push(options.signal);
+			const composedSignal = AbortSignal.any(signals);
 			try {
 				const headers = {
 					Accept: "application/json",
 					"Accept-Encoding": "gzip",
+					"User-Agent": `hiero-mirror-client/${VERSION}`,
 					...options?.headers
 				};
-				if (body !== void 0) headers["Content-Type"] = "application/json";
+				if (body !== void 0 && !(body instanceof Uint8Array)) headers["Content-Type"] = "application/json";
+				for (const hook of this.beforeRequestHooks) await hook({
+					method,
+					url,
+					headers
+				});
 				this.logger.debug?.(`[HTTP] ${method} ${url}`, { attempt });
+				const serializedBody = body instanceof Uint8Array ? body : body !== void 0 ? JSON.stringify(body) : void 0;
 				const response = await this.fetchFn(url, {
 					method,
 					headers,
-					body: body !== void 0 ? JSON.stringify(body) : void 0,
-					signal: controller.signal
+					body: serializedBody,
+					signal: composedSignal
+				});
+				for (const hook of this.afterResponseHooks) await hook({
+					method,
+					url,
+					status: response.status,
+					headers: response.headers
 				});
-				clearTimeout(timeoutId);
 				return await this.handleResponse(response, url, attempt);
 			} catch (error) {
-				clearTimeout(timeoutId);
-				if (error instanceof DOMException && error.name === "AbortError" && !options?.signal?.aborted) throw new HieroTimeoutError(timeoutMs);
+				if (error instanceof DOMException && error.name === "TimeoutError") throw new HieroTimeoutError(timeoutMs);
+				if (error instanceof DOMException && error.name === "AbortError") throw error;
 				throw error;
 			}
 		} catch (error) {
@@ -1721,8 +1783,8 @@ var NetworkResource = class {
 	constructor(client) {
 		this.client = client;
 	}
-	async getExchangeRate() {
-		return mapExchangeRateSet((await this.client.get("/api/v1/network/exchangerate")).data);
+	async getExchangeRate(params) {
+		return mapExchangeRateSet((await this.client.get("/api/v1/network/exchangerate", params)).data);
 	}
 	async getFees(params) {
 		return mapFeeSchedule((await this.client.get("/api/v1/network/fees", params)).data);
@@ -2024,12 +2086,18 @@ var TopicStream = class TopicStream {
 		}
 	}
 	sleep(ms) {
+		const signal = this.options.signal;
 		return new Promise((resolve) => {
-			const timer = setTimeout(resolve, ms);
-			this.options.signal?.addEventListener("abort", () => {
+			const onDone = () => {
+				if (signal) signal.removeEventListener("abort", onAbort);
+				resolve();
+			};
+			const onAbort = () => {
 				clearTimeout(timer);
 				resolve();
-			}, { once: true });
+			};
+			const timer = setTimeout(onDone, ms);
+			signal?.addEventListener("abort", onAbort, { once: true });
 		});
 	}
 };
@@ -2161,7 +2229,9 @@ var MirrorNodeClient = class {
 			retry: { maxRetries: options.maxRetries ?? 2 },
 			rateLimitRps: options.rateLimitRps ?? 50,
 			logger: options.logger,
-			fetch: options.fetch
+			fetch: options.fetch,
+			beforeRequest: options.beforeRequest,
+			afterResponse: options.afterResponse
 		});
 		this.accounts = new AccountsResource(this.httpClient);
 		this.balances = new BalancesResource(this.httpClient);
@@ -2173,6 +2243,15 @@ var MirrorNodeClient = class {
 		this.topics = new TopicsResource(this.httpClient);
 		this.transactions = new TransactionsResource(this.httpClient);
 	}
+	/**
+	* Releases all internal resources (caches, in-flight maps).
+	*
+	* Call this when the client is no longer needed to prevent memory leaks
+	* in long-running applications (servers, workers).
+	*/
+	destroy() {
+		this.httpClient.destroy();
+	}
 };
 //#endregion
 //#region src/errors/HieroCapabilityError.ts
@@ -2212,7 +2291,11 @@ var HieroCapabilityError = class extends HieroError {
 *
 * @packageDocumentation
 */
-const VERSION = "0.0.0";
+/**
+* SDK version, injected at build time from package.json.
+* Falls back to 'development' for unbundled/test usage.
+*/
+const VERSION = "0.2.0";
 //#endregion
 exports.HieroCapabilityError = HieroCapabilityError;
 exports.HieroError = HieroError;