@satianurag/hiero-mirror-client 0.1.0

package/dist/utils.d.cts

@@ -0,0 +1,105 @@
+//#region src/utils/encoding.d.ts
+/**
+ * Cross-platform encoding utilities.
+ *
+ * No dependency on Node.js `Buffer` — uses Web-standard APIs only.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Base64-to-hex conversion.
+ *
+ * ```ts
+ * base64ToHex('SGVsbG8=') // → '48656c6c6f'
+ * ```
+ */
+declare function base64ToHex(base64: string): string;
+/**
+ * Hex-to-base64 conversion.
+ *
+ * Accepts optional 0x prefix.
+ *
+ * ```ts
+ * hexToBase64('48656c6c6f')   // → 'SGVsbG8='
+ * hexToBase64('0x48656c6c6f') // → 'SGVsbG8='
+ * ```
+ */
+declare function hexToBase64(hex: string): string;
+/**
+ * Convert a Uint8Array to a hex string (lowercase, no prefix).
+ */
+declare function bytesToHex(bytes: Uint8Array): string;
+/**
+ * Convert a hex string (with optional 0x prefix) to Uint8Array.
+ */
+declare function hexToBytes(hex: string): Uint8Array;
+//#endregion
+//#region src/utils/timestamp.d.ts
+/**
+ * HieroTimestamp — factory methods for Hedera/Hiero timestamps.
+ *
+ * Hedera timestamps use the format `seconds.nanoseconds`, e.g., `1710000000.123456789`.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Represents a Hedera consensus timestamp as `seconds.nanoseconds`.
+ */
+interface HieroTimestamp {
+  /** Whole seconds since epoch. */
+  readonly seconds: bigint;
+  /** Nanosecond component (0–999,999,999). */
+  readonly nanos: number;
+  /** Full timestamp string: `<seconds>.<nanos padded to 9 digits>`. */
+  toString(): string;
+}
+/**
+ * Creates a HieroTimestamp from a `seconds.nanos` string.
+ *
+ * ```ts
+ * const ts = fromString('1710000000.123456789');
+ * ts.seconds // 1710000000n
+ * ts.nanos   // 123456789
+ * ts.toString() // '1710000000.123456789'
+ * ```
+ */
+declare function fromString(timestamp: string): HieroTimestamp;
+/**
+ * Creates a HieroTimestamp from a JavaScript `Date`.
+ *
+ * Note: JS Date only has millisecond precision. Nanoseconds below ms will be 0.
+ *
+ * ```ts
+ * const ts = fromDate(new Date('2024-03-10T00:00:00Z'));
+ * ```
+ */
+declare function fromDate(date: Date): HieroTimestamp;
+/**
+ * Creates a HieroTimestamp for the current moment.
+ *
+ * ```ts
+ * const ts = now();
+ * ```
+ */
+declare function now(): HieroTimestamp;
+/**
+ * Creates a HieroTimestamp from separate seconds and nanoseconds.
+ *
+ * ```ts
+ * const ts = fromParts(1710000000n, 123456789);
+ * ```
+ */
+declare function fromParts(seconds: bigint, nanos: number): HieroTimestamp;
+/**
+ * Converts a HieroTimestamp to a JavaScript Date.
+ *
+ * Note: sub-millisecond precision is lost.
+ */
+declare function toDate(timestamp: HieroTimestamp): Date;
+/**
+ * Compares two timestamps. Returns -1, 0, or 1.
+ */
+declare function compare(a: HieroTimestamp, b: HieroTimestamp): -1 | 0 | 1;
+//#endregion
+export { type HieroTimestamp, base64ToHex, bytesToHex, compare, fromDate, fromParts, fromString, hexToBase64, hexToBytes, now, toDate };
+//# sourceMappingURL=utils.d.cts.map

package/dist/utils.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.cts","names":[],"sources":["../src/utils/encoding.ts","../src/utils/timestamp.ts"],"mappings":";;AAeA;;;;;AAiBA;;;;;AAeA;;;iBAhCgB,WAAA,CAAY,MAAA;;AAyC5B;;;;;;;;AC7CA;iBDqBgB,WAAA,CAAY,GAAA;;;;iBAeZ,UAAA,CAAW,KAAA,EAAO,UAAA;;;;iBASlB,UAAA,CAAW,GAAA,WAAc,UAAA;;;;AAzCzC;;;;;AAiBA;;;;UCrBiB,cAAA;EDoCD;EAAA,SClCL,OAAA;;WAEA,KAAA;EDgCiC;EC9B1C,QAAA;AAAA;;;;;;;AANF;;;;iBAmBgB,UAAA,CAAW,SAAA,WAAoB,cAAA;;;;;AAA/C;;;;;iBA0BgB,QAAA,CAAS,IAAA,EAAM,IAAA,GAAO,cAAA;;;;;;;;iBActB,GAAA,CAAA,GAAO,cAAA;AAAvB;;;;;AAWA;;AAXA,iBAWgB,SAAA,CAAU,OAAA,UAAiB,KAAA,WAAgB,cAAA;;;;;;iBAY3C,MAAA,CAAO,SAAA,EAAW,cAAA,GAAiB,IAAA;AAAnD;;;AAAA,iBAQgB,OAAA,CAAQ,CAAA,EAAG,cAAA,EAAgB,CAAA,EAAG,cAAA"}

package/dist/utils.d.mts

@@ -0,0 +1,105 @@
+//#region src/utils/encoding.d.ts
+/**
+ * Cross-platform encoding utilities.
+ *
+ * No dependency on Node.js `Buffer` — uses Web-standard APIs only.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Base64-to-hex conversion.
+ *
+ * ```ts
+ * base64ToHex('SGVsbG8=') // → '48656c6c6f'
+ * ```
+ */
+declare function base64ToHex(base64: string): string;
+/**
+ * Hex-to-base64 conversion.
+ *
+ * Accepts optional 0x prefix.
+ *
+ * ```ts
+ * hexToBase64('48656c6c6f')   // → 'SGVsbG8='
+ * hexToBase64('0x48656c6c6f') // → 'SGVsbG8='
+ * ```
+ */
+declare function hexToBase64(hex: string): string;
+/**
+ * Convert a Uint8Array to a hex string (lowercase, no prefix).
+ */
+declare function bytesToHex(bytes: Uint8Array): string;
+/**
+ * Convert a hex string (with optional 0x prefix) to Uint8Array.
+ */
+declare function hexToBytes(hex: string): Uint8Array;
+//#endregion
+//#region src/utils/timestamp.d.ts
+/**
+ * HieroTimestamp — factory methods for Hedera/Hiero timestamps.
+ *
+ * Hedera timestamps use the format `seconds.nanoseconds`, e.g., `1710000000.123456789`.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Represents a Hedera consensus timestamp as `seconds.nanoseconds`.
+ */
+interface HieroTimestamp {
+  /** Whole seconds since epoch. */
+  readonly seconds: bigint;
+  /** Nanosecond component (0–999,999,999). */
+  readonly nanos: number;
+  /** Full timestamp string: `<seconds>.<nanos padded to 9 digits>`. */
+  toString(): string;
+}
+/**
+ * Creates a HieroTimestamp from a `seconds.nanos` string.
+ *
+ * ```ts
+ * const ts = fromString('1710000000.123456789');
+ * ts.seconds // 1710000000n
+ * ts.nanos   // 123456789
+ * ts.toString() // '1710000000.123456789'
+ * ```
+ */
+declare function fromString(timestamp: string): HieroTimestamp;
+/**
+ * Creates a HieroTimestamp from a JavaScript `Date`.
+ *
+ * Note: JS Date only has millisecond precision. Nanoseconds below ms will be 0.
+ *
+ * ```ts
+ * const ts = fromDate(new Date('2024-03-10T00:00:00Z'));
+ * ```
+ */
+declare function fromDate(date: Date): HieroTimestamp;
+/**
+ * Creates a HieroTimestamp for the current moment.
+ *
+ * ```ts
+ * const ts = now();
+ * ```
+ */
+declare function now(): HieroTimestamp;
+/**
+ * Creates a HieroTimestamp from separate seconds and nanoseconds.
+ *
+ * ```ts
+ * const ts = fromParts(1710000000n, 123456789);
+ * ```
+ */
+declare function fromParts(seconds: bigint, nanos: number): HieroTimestamp;
+/**
+ * Converts a HieroTimestamp to a JavaScript Date.
+ *
+ * Note: sub-millisecond precision is lost.
+ */
+declare function toDate(timestamp: HieroTimestamp): Date;
+/**
+ * Compares two timestamps. Returns -1, 0, or 1.
+ */
+declare function compare(a: HieroTimestamp, b: HieroTimestamp): -1 | 0 | 1;
+//#endregion
+export { type HieroTimestamp, base64ToHex, bytesToHex, compare, fromDate, fromParts, fromString, hexToBase64, hexToBytes, now, toDate };
+//# sourceMappingURL=utils.d.mts.map

package/dist/utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.mts","names":[],"sources":["../src/utils/encoding.ts","../src/utils/timestamp.ts"],"mappings":";;AAeA;;;;;AAiBA;;;;;AAeA;;;iBAhCgB,WAAA,CAAY,MAAA;;AAyC5B;;;;;;;;AC7CA;iBDqBgB,WAAA,CAAY,GAAA;;;;iBAeZ,UAAA,CAAW,KAAA,EAAO,UAAA;;;;iBASlB,UAAA,CAAW,GAAA,WAAc,UAAA;;;;AAzCzC;;;;;AAiBA;;;;UCrBiB,cAAA;EDoCD;EAAA,SClCL,OAAA;;WAEA,KAAA;EDgCiC;EC9B1C,QAAA;AAAA;;;;;;;AANF;;;;iBAmBgB,UAAA,CAAW,SAAA,WAAoB,cAAA;;;;;AAA/C;;;;;iBA0BgB,QAAA,CAAS,IAAA,EAAM,IAAA,GAAO,cAAA;;;;;;;;iBActB,GAAA,CAAA,GAAO,cAAA;AAAvB;;;;;AAWA;;AAXA,iBAWgB,SAAA,CAAU,OAAA,UAAiB,KAAA,WAAgB,cAAA;;;;;;iBAY3C,MAAA,CAAO,SAAA,EAAW,cAAA,GAAiB,IAAA;AAAnD;;;AAAA,iBAQgB,OAAA,CAAQ,CAAA,EAAG,cAAA,EAAgB,CAAA,EAAG,cAAA"}

package/dist/utils.d.ts

@@ -0,0 +1,105 @@
+//#region src/utils/encoding.d.ts
+/**
+ * Cross-platform encoding utilities.
+ *
+ * No dependency on Node.js `Buffer` — uses Web-standard APIs only.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Base64-to-hex conversion.
+ *
+ * ```ts
+ * base64ToHex('SGVsbG8=') // → '48656c6c6f'
+ * ```
+ */
+declare function base64ToHex(base64: string): string;
+/**
+ * Hex-to-base64 conversion.
+ *
+ * Accepts optional 0x prefix.
+ *
+ * ```ts
+ * hexToBase64('48656c6c6f')   // → 'SGVsbG8='
+ * hexToBase64('0x48656c6c6f') // → 'SGVsbG8='
+ * ```
+ */
+declare function hexToBase64(hex: string): string;
+/**
+ * Convert a Uint8Array to a hex string (lowercase, no prefix).
+ */
+declare function bytesToHex(bytes: Uint8Array): string;
+/**
+ * Convert a hex string (with optional 0x prefix) to Uint8Array.
+ */
+declare function hexToBytes(hex: string): Uint8Array;
+//#endregion
+//#region src/utils/timestamp.d.ts
+/**
+ * HieroTimestamp — factory methods for Hedera/Hiero timestamps.
+ *
+ * Hedera timestamps use the format `seconds.nanoseconds`, e.g., `1710000000.123456789`.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Represents a Hedera consensus timestamp as `seconds.nanoseconds`.
+ */
+interface HieroTimestamp {
+  /** Whole seconds since epoch. */
+  readonly seconds: bigint;
+  /** Nanosecond component (0–999,999,999). */
+  readonly nanos: number;
+  /** Full timestamp string: `<seconds>.<nanos padded to 9 digits>`. */
+  toString(): string;
+}
+/**
+ * Creates a HieroTimestamp from a `seconds.nanos` string.
+ *
+ * ```ts
+ * const ts = fromString('1710000000.123456789');
+ * ts.seconds // 1710000000n
+ * ts.nanos   // 123456789
+ * ts.toString() // '1710000000.123456789'
+ * ```
+ */
+declare function fromString(timestamp: string): HieroTimestamp;
+/**
+ * Creates a HieroTimestamp from a JavaScript `Date`.
+ *
+ * Note: JS Date only has millisecond precision. Nanoseconds below ms will be 0.
+ *
+ * ```ts
+ * const ts = fromDate(new Date('2024-03-10T00:00:00Z'));
+ * ```
+ */
+declare function fromDate(date: Date): HieroTimestamp;
+/**
+ * Creates a HieroTimestamp for the current moment.
+ *
+ * ```ts
+ * const ts = now();
+ * ```
+ */
+declare function now(): HieroTimestamp;
+/**
+ * Creates a HieroTimestamp from separate seconds and nanoseconds.
+ *
+ * ```ts
+ * const ts = fromParts(1710000000n, 123456789);
+ * ```
+ */
+declare function fromParts(seconds: bigint, nanos: number): HieroTimestamp;
+/**
+ * Converts a HieroTimestamp to a JavaScript Date.
+ *
+ * Note: sub-millisecond precision is lost.
+ */
+declare function toDate(timestamp: HieroTimestamp): Date;
+/**
+ * Compares two timestamps. Returns -1, 0, or 1.
+ */
+declare function compare(a: HieroTimestamp, b: HieroTimestamp): -1 | 0 | 1;
+//#endregion
+export { type HieroTimestamp, base64ToHex, bytesToHex, compare, fromDate, fromParts, fromString, hexToBase64, hexToBytes, now, toDate };
+//# sourceMappingURL=utils.d.mts.map

package/dist/utils.mjs

@@ -0,0 +1,178 @@
+//#region src/utils/encoding.ts
+/**
+* Cross-platform encoding utilities.
+*
+* No dependency on Node.js `Buffer` — uses Web-standard APIs only.
+*
+* @packageDocumentation
+*/
+/**
+* Base64-to-hex conversion.
+*
+* ```ts
+* base64ToHex('SGVsbG8=') // → '48656c6c6f'
+* ```
+*/
+function base64ToHex(base64) {
+	const bytes = base64ToBytes(base64);
+	return Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+/**
+* Hex-to-base64 conversion.
+*
+* Accepts optional 0x prefix.
+*
+* ```ts
+* hexToBase64('48656c6c6f')   // → 'SGVsbG8='
+* hexToBase64('0x48656c6c6f') // → 'SGVsbG8='
+* ```
+*/
+function hexToBase64(hex) {
+	const cleaned = hex.startsWith("0x") || hex.startsWith("0X") ? hex.slice(2) : hex;
+	if (cleaned.length % 2 !== 0) throw new Error(`Invalid hex string: odd length (${cleaned.length})`);
+	const bytes = new Uint8Array(cleaned.length / 2);
+	for (let i = 0; i < cleaned.length; i += 2) bytes[i / 2] = Number.parseInt(cleaned.slice(i, i + 2), 16);
+	return bytesToBase64(bytes);
+}
+/**
+* Convert a Uint8Array to a hex string (lowercase, no prefix).
+*/
+function bytesToHex(bytes) {
+	return Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+/**
+* Convert a hex string (with optional 0x prefix) to Uint8Array.
+*/
+function hexToBytes(hex) {
+	const cleaned = hex.startsWith("0x") || hex.startsWith("0X") ? hex.slice(2) : hex;
+	if (cleaned.length % 2 !== 0) throw new Error(`Invalid hex string: odd length (${cleaned.length})`);
+	const bytes = new Uint8Array(cleaned.length / 2);
+	for (let i = 0; i < cleaned.length; i += 2) bytes[i / 2] = Number.parseInt(cleaned.slice(i, i + 2), 16);
+	return bytes;
+}
+const BASE64_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+function base64ToBytes(base64) {
+	if (typeof atob === "function") {
+		const binary = atob(base64);
+		const bytes = new Uint8Array(binary.length);
+		for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
+		return bytes;
+	}
+	const cleaned = base64.replace(/=+$/, "");
+	const byteLength = cleaned.length * 3 >> 2;
+	const bytes = new Uint8Array(byteLength);
+	let byteIndex = 0;
+	for (let i = 0; i < cleaned.length; i += 4) {
+		const a = BASE64_CHARS.indexOf(cleaned.charAt(i));
+		const b = BASE64_CHARS.indexOf(cleaned.charAt(i + 1));
+		const c = BASE64_CHARS.indexOf(i + 2 < cleaned.length ? cleaned.charAt(i + 2) : "A");
+		const d = BASE64_CHARS.indexOf(i + 3 < cleaned.length ? cleaned.charAt(i + 3) : "A");
+		bytes[byteIndex++] = a << 2 | b >> 4;
+		if (i + 2 < cleaned.length) bytes[byteIndex++] = (b & 15) << 4 | c >> 2;
+		if (i + 3 < cleaned.length) bytes[byteIndex++] = (c & 3) << 6 | d;
+	}
+	return bytes;
+}
+function bytesToBase64(bytes) {
+	if (typeof btoa === "function") {
+		let binary = "";
+		for (const b of bytes) binary += String.fromCharCode(b);
+		return btoa(binary);
+	}
+	let result = "";
+	for (let i = 0; i < bytes.length; i += 3) {
+		const a = bytes[i];
+		const b = bytes[i + 1] ?? 0;
+		const c = bytes[i + 2] ?? 0;
+		result += BASE64_CHARS[a >> 2 & 63];
+		result += BASE64_CHARS[(a & 3) << 4 | b >> 4 & 15];
+		result += i + 1 < bytes.length ? BASE64_CHARS[(b & 15) << 2 | c >> 6 & 3] : "=";
+		result += i + 2 < bytes.length ? BASE64_CHARS[c & 63] : "=";
+	}
+	return result;
+}
+//#endregion
+//#region src/utils/timestamp.ts
+/**
+* Creates a HieroTimestamp from a `seconds.nanos` string.
+*
+* ```ts
+* const ts = fromString('1710000000.123456789');
+* ts.seconds // 1710000000n
+* ts.nanos   // 123456789
+* ts.toString() // '1710000000.123456789'
+* ```
+*/
+function fromString(timestamp) {
+	const dotIndex = timestamp.indexOf(".");
+	if (dotIndex === -1) return makeTimestamp(BigInt(timestamp), 0);
+	const seconds = BigInt(timestamp.slice(0, dotIndex));
+	const nanosStr = timestamp.slice(dotIndex + 1).padEnd(9, "0").slice(0, 9);
+	return makeTimestamp(seconds, Number.parseInt(nanosStr, 10));
+}
+/**
+* Creates a HieroTimestamp from a JavaScript `Date`.
+*
+* Note: JS Date only has millisecond precision. Nanoseconds below ms will be 0.
+*
+* ```ts
+* const ts = fromDate(new Date('2024-03-10T00:00:00Z'));
+* ```
+*/
+function fromDate(date) {
+	const epochMs = date.getTime();
+	return makeTimestamp(BigInt(Math.floor(epochMs / 1e3)), epochMs % 1e3 * 1e6);
+}
+/**
+* Creates a HieroTimestamp for the current moment.
+*
+* ```ts
+* const ts = now();
+* ```
+*/
+function now() {
+	return fromDate(/* @__PURE__ */ new Date());
+}
+/**
+* Creates a HieroTimestamp from separate seconds and nanoseconds.
+*
+* ```ts
+* const ts = fromParts(1710000000n, 123456789);
+* ```
+*/
+function fromParts(seconds, nanos) {
+	if (nanos < 0 || nanos > 999999999) throw new RangeError(`nanoseconds must be 0..999_999_999, got ${nanos}`);
+	return makeTimestamp(seconds, nanos);
+}
+/**
+* Converts a HieroTimestamp to a JavaScript Date.
+*
+* Note: sub-millisecond precision is lost.
+*/
+function toDate(timestamp) {
+	const ms = Number(timestamp.seconds) * 1e3 + Math.floor(timestamp.nanos / 1e6);
+	return new Date(ms);
+}
+/**
+* Compares two timestamps. Returns -1, 0, or 1.
+*/
+function compare(a, b) {
+	if (a.seconds < b.seconds) return -1;
+	if (a.seconds > b.seconds) return 1;
+	if (a.nanos < b.nanos) return -1;
+	if (a.nanos > b.nanos) return 1;
+	return 0;
+}
+function makeTimestamp(seconds, nanos) {
+	return {
+		seconds,
+		nanos,
+		toString() {
+			return `${seconds}.${String(nanos).padStart(9, "0")}`;
+		}
+	};
+}
+//#endregion
+export { base64ToHex, bytesToHex, compare, fromDate, fromParts, fromString, hexToBase64, hexToBytes, now, toDate };
+
+//# sourceMappingURL=utils.mjs.map

package/dist/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.mjs","names":[],"sources":["../src/utils/encoding.ts","../src/utils/timestamp.ts"],"sourcesContent":["/**\n * Cross-platform encoding utilities.\n *\n * No dependency on Node.js `Buffer` — uses Web-standard APIs only.\n *\n * @packageDocumentation\n */\n\n/**\n * Base64-to-hex conversion.\n *\n * ```ts\n * base64ToHex('SGVsbG8=') // → '48656c6c6f'\n * ```\n */\nexport function base64ToHex(base64: string): string {\n  const bytes = base64ToBytes(base64);\n  return Array.from(bytes)\n    .map((b) => b.toString(16).padStart(2, '0'))\n    .join('');\n}\n\n/**\n * Hex-to-base64 conversion.\n *\n * Accepts optional 0x prefix.\n *\n * ```ts\n * hexToBase64('48656c6c6f')   // → 'SGVsbG8='\n * hexToBase64('0x48656c6c6f') // → 'SGVsbG8='\n * ```\n */\nexport function hexToBase64(hex: string): string {\n  const cleaned = hex.startsWith('0x') || hex.startsWith('0X') ? hex.slice(2) : hex;\n  if (cleaned.length % 2 !== 0) {\n    throw new Error(`Invalid hex string: odd length (${cleaned.length})`);\n  }\n  const bytes = new Uint8Array(cleaned.length / 2);\n  for (let i = 0; i < cleaned.length; i += 2) {\n    bytes[i / 2] = Number.parseInt(cleaned.slice(i, i + 2), 16);\n  }\n  return bytesToBase64(bytes);\n}\n\n/**\n * Convert a Uint8Array to a hex string (lowercase, no prefix).\n */\nexport function bytesToHex(bytes: Uint8Array): string {\n  return Array.from(bytes)\n    .map((b) => b.toString(16).padStart(2, '0'))\n    .join('');\n}\n\n/**\n * Convert a hex string (with optional 0x prefix) to Uint8Array.\n */\nexport function hexToBytes(hex: string): Uint8Array {\n  const cleaned = hex.startsWith('0x') || hex.startsWith('0X') ? hex.slice(2) : hex;\n  if (cleaned.length % 2 !== 0) {\n    throw new Error(`Invalid hex string: odd length (${cleaned.length})`);\n  }\n  const bytes = new Uint8Array(cleaned.length / 2);\n  for (let i = 0; i < cleaned.length; i += 2) {\n    bytes[i / 2] = Number.parseInt(cleaned.slice(i, i + 2), 16);\n  }\n  return bytes;\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers (no Buffer, cross-platform)\n// ---------------------------------------------------------------------------\n\nconst BASE64_CHARS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';\n\nfunction base64ToBytes(base64: string): Uint8Array {\n  // Use atob if available (browser + Node 16+)\n  if (typeof atob === 'function') {\n    const binary = atob(base64);\n    const bytes = new Uint8Array(binary.length);\n    for (let i = 0; i < binary.length; i++) {\n      bytes[i] = binary.charCodeAt(i);\n    }\n    return bytes;\n  }\n\n  // Manual fallback (should rarely be needed)\n  const cleaned = base64.replace(/=+$/, '');\n  const byteLength = (cleaned.length * 3) >> 2;\n  const bytes = new Uint8Array(byteLength);\n  let byteIndex = 0;\n\n  for (let i = 0; i < cleaned.length; i += 4) {\n    const a = BASE64_CHARS.indexOf(cleaned.charAt(i));\n    const b = BASE64_CHARS.indexOf(cleaned.charAt(i + 1));\n    const c = BASE64_CHARS.indexOf(i + 2 < cleaned.length ? cleaned.charAt(i + 2) : 'A');\n    const d = BASE64_CHARS.indexOf(i + 3 < cleaned.length ? cleaned.charAt(i + 3) : 'A');\n\n    bytes[byteIndex++] = (a << 2) | (b >> 4);\n    if (i + 2 < cleaned.length) bytes[byteIndex++] = ((b & 15) << 4) | (c >> 2);\n    if (i + 3 < cleaned.length) bytes[byteIndex++] = ((c & 3) << 6) | d;\n  }\n\n  return bytes;\n}\n\nfunction bytesToBase64(bytes: Uint8Array): string {\n  // Use btoa if available (browser + Node 16+)\n  if (typeof btoa === 'function') {\n    let binary = '';\n    for (const b of bytes) {\n      binary += String.fromCharCode(b);\n    }\n    return btoa(binary);\n  }\n\n  // Manual fallback\n  let result = '';\n  for (let i = 0; i < bytes.length; i += 3) {\n    const a = bytes[i]!;\n    const b = bytes[i + 1] ?? 0;\n    const c = bytes[i + 2] ?? 0;\n\n    result += BASE64_CHARS[(a >> 2) & 63];\n    result += BASE64_CHARS[((a & 3) << 4) | ((b >> 4) & 15)];\n    result += i + 1 < bytes.length ? BASE64_CHARS[((b & 15) << 2) | ((c >> 6) & 3)] : '=';\n    result += i + 2 < bytes.length ? BASE64_CHARS[c & 63] : '=';\n  }\n\n  return result;\n}\n","/**\n * HieroTimestamp — factory methods for Hedera/Hiero timestamps.\n *\n * Hedera timestamps use the format `seconds.nanoseconds`, e.g., `1710000000.123456789`.\n *\n * @packageDocumentation\n */\n\n/**\n * Represents a Hedera consensus timestamp as `seconds.nanoseconds`.\n */\nexport interface HieroTimestamp {\n  /** Whole seconds since epoch. */\n  readonly seconds: bigint;\n  /** Nanosecond component (0–999,999,999). */\n  readonly nanos: number;\n  /** Full timestamp string: `<seconds>.<nanos padded to 9 digits>`. */\n  toString(): string;\n}\n\n/**\n * Creates a HieroTimestamp from a `seconds.nanos` string.\n *\n * ```ts\n * const ts = fromString('1710000000.123456789');\n * ts.seconds // 1710000000n\n * ts.nanos   // 123456789\n * ts.toString() // '1710000000.123456789'\n * ```\n */\nexport function fromString(timestamp: string): HieroTimestamp {\n  const dotIndex = timestamp.indexOf('.');\n  if (dotIndex === -1) {\n    const seconds = BigInt(timestamp);\n    return makeTimestamp(seconds, 0);\n  }\n\n  const seconds = BigInt(timestamp.slice(0, dotIndex));\n  const nanosStr = timestamp\n    .slice(dotIndex + 1)\n    .padEnd(9, '0')\n    .slice(0, 9);\n  const nanos = Number.parseInt(nanosStr, 10);\n\n  return makeTimestamp(seconds, nanos);\n}\n\n/**\n * Creates a HieroTimestamp from a JavaScript `Date`.\n *\n * Note: JS Date only has millisecond precision. Nanoseconds below ms will be 0.\n *\n * ```ts\n * const ts = fromDate(new Date('2024-03-10T00:00:00Z'));\n * ```\n */\nexport function fromDate(date: Date): HieroTimestamp {\n  const epochMs = date.getTime();\n  const seconds = BigInt(Math.floor(epochMs / 1000));\n  const nanos = (epochMs % 1000) * 1_000_000;\n  return makeTimestamp(seconds, nanos);\n}\n\n/**\n * Creates a HieroTimestamp for the current moment.\n *\n * ```ts\n * const ts = now();\n * ```\n */\nexport function now(): HieroTimestamp {\n  return fromDate(new Date());\n}\n\n/**\n * Creates a HieroTimestamp from separate seconds and nanoseconds.\n *\n * ```ts\n * const ts = fromParts(1710000000n, 123456789);\n * ```\n */\nexport function fromParts(seconds: bigint, nanos: number): HieroTimestamp {\n  if (nanos < 0 || nanos > 999_999_999) {\n    throw new RangeError(`nanoseconds must be 0..999_999_999, got ${nanos}`);\n  }\n  return makeTimestamp(seconds, nanos);\n}\n\n/**\n * Converts a HieroTimestamp to a JavaScript Date.\n *\n * Note: sub-millisecond precision is lost.\n */\nexport function toDate(timestamp: HieroTimestamp): Date {\n  const ms = Number(timestamp.seconds) * 1000 + Math.floor(timestamp.nanos / 1_000_000);\n  return new Date(ms);\n}\n\n/**\n * Compares two timestamps. Returns -1, 0, or 1.\n */\nexport function compare(a: HieroTimestamp, b: HieroTimestamp): -1 | 0 | 1 {\n  if (a.seconds < b.seconds) return -1;\n  if (a.seconds > b.seconds) return 1;\n  if (a.nanos < b.nanos) return -1;\n  if (a.nanos > b.nanos) return 1;\n  return 0;\n}\n\n// ---------------------------------------------------------------------------\n// Internal\n// ---------------------------------------------------------------------------\n\nfunction makeTimestamp(seconds: bigint, nanos: number): HieroTimestamp {\n  return {\n    seconds,\n    nanos,\n    toString() {\n      return `${seconds}.${String(nanos).padStart(9, '0')}`;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;AAeA,SAAgB,YAAY,QAAwB;CAClD,MAAM,QAAQ,cAAc,OAAO;AACnC,QAAO,MAAM,KAAK,MAAM,CACrB,KAAK,MAAM,EAAE,SAAS,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAC3C,KAAK,GAAG;;;;;;;;;;;;AAab,SAAgB,YAAY,KAAqB;CAC/C,MAAM,UAAU,IAAI,WAAW,KAAK,IAAI,IAAI,WAAW,KAAK,GAAG,IAAI,MAAM,EAAE,GAAG;AAC9E,KAAI,QAAQ,SAAS,MAAM,EACzB,OAAM,IAAI,MAAM,mCAAmC,QAAQ,OAAO,GAAG;CAEvE,MAAM,QAAQ,IAAI,WAAW,QAAQ,SAAS,EAAE;AAChD,MAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK,EACvC,OAAM,IAAI,KAAK,OAAO,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,EAAE,GAAG;AAE7D,QAAO,cAAc,MAAM;;;;;AAM7B,SAAgB,WAAW,OAA2B;AACpD,QAAO,MAAM,KAAK,MAAM,CACrB,KAAK,MAAM,EAAE,SAAS,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAC3C,KAAK,GAAG;;;;;AAMb,SAAgB,WAAW,KAAyB;CAClD,MAAM,UAAU,IAAI,WAAW,KAAK,IAAI,IAAI,WAAW,KAAK,GAAG,IAAI,MAAM,EAAE,GAAG;AAC9E,KAAI,QAAQ,SAAS,MAAM,EACzB,OAAM,IAAI,MAAM,mCAAmC,QAAQ,OAAO,GAAG;CAEvE,MAAM,QAAQ,IAAI,WAAW,QAAQ,SAAS,EAAE;AAChD,MAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK,EACvC,OAAM,IAAI,KAAK,OAAO,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,EAAE,GAAG;AAE7D,QAAO;;AAOT,MAAM,eAAe;AAErB,SAAS,cAAc,QAA4B;AAEjD,KAAI,OAAO,SAAS,YAAY;EAC9B,MAAM,SAAS,KAAK,OAAO;EAC3B,MAAM,QAAQ,IAAI,WAAW,OAAO,OAAO;AAC3C,OAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,IACjC,OAAM,KAAK,OAAO,WAAW,EAAE;AAEjC,SAAO;;CAIT,MAAM,UAAU,OAAO,QAAQ,OAAO,GAAG;CACzC,MAAM,aAAc,QAAQ,SAAS,KAAM;CAC3C,MAAM,QAAQ,IAAI,WAAW,WAAW;CACxC,IAAI,YAAY;AAEhB,MAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK,GAAG;EAC1C,MAAM,IAAI,aAAa,QAAQ,QAAQ,OAAO,EAAE,CAAC;EACjD,MAAM,IAAI,aAAa,QAAQ,QAAQ,OAAO,IAAI,EAAE,CAAC;EACrD,MAAM,IAAI,aAAa,QAAQ,IAAI,IAAI,QAAQ,SAAS,QAAQ,OAAO,IAAI,EAAE,GAAG,IAAI;EACpF,MAAM,IAAI,aAAa,QAAQ,IAAI,IAAI,QAAQ,SAAS,QAAQ,OAAO,IAAI,EAAE,GAAG,IAAI;AAEpF,QAAM,eAAgB,KAAK,IAAM,KAAK;AACtC,MAAI,IAAI,IAAI,QAAQ,OAAQ,OAAM,gBAAiB,IAAI,OAAO,IAAM,KAAK;AACzE,MAAI,IAAI,IAAI,QAAQ,OAAQ,OAAM,gBAAiB,IAAI,MAAM,IAAK;;AAGpE,QAAO;;AAGT,SAAS,cAAc,OAA2B;AAEhD,KAAI,OAAO,SAAS,YAAY;EAC9B,IAAI,SAAS;AACb,OAAK,MAAM,KAAK,MACd,WAAU,OAAO,aAAa,EAAE;AAElC,SAAO,KAAK,OAAO;;CAIrB,IAAI,SAAS;AACb,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,GAAG;EACxC,MAAM,IAAI,MAAM;EAChB,MAAM,IAAI,MAAM,IAAI,MAAM;EAC1B,MAAM,IAAI,MAAM,IAAI,MAAM;AAE1B,YAAU,aAAc,KAAK,IAAK;AAClC,YAAU,cAAe,IAAI,MAAM,IAAO,KAAK,IAAK;AACpD,YAAU,IAAI,IAAI,MAAM,SAAS,cAAe,IAAI,OAAO,IAAO,KAAK,IAAK,KAAM;AAClF,YAAU,IAAI,IAAI,MAAM,SAAS,aAAa,IAAI,MAAM;;AAG1D,QAAO;;;;;;;;;;;;;;AClGT,SAAgB,WAAW,WAAmC;CAC5D,MAAM,WAAW,UAAU,QAAQ,IAAI;AACvC,KAAI,aAAa,GAEf,QAAO,cADS,OAAO,UAAU,EACH,EAAE;CAGlC,MAAM,UAAU,OAAO,UAAU,MAAM,GAAG,SAAS,CAAC;CACpD,MAAM,WAAW,UACd,MAAM,WAAW,EAAE,CACnB,OAAO,GAAG,IAAI,CACd,MAAM,GAAG,EAAE;AAGd,QAAO,cAAc,SAFP,OAAO,SAAS,UAAU,GAAG,CAEP;;;;;;;;;;;AAYtC,SAAgB,SAAS,MAA4B;CACnD,MAAM,UAAU,KAAK,SAAS;AAG9B,QAAO,cAFS,OAAO,KAAK,MAAM,UAAU,IAAK,CAAC,EACnC,UAAU,MAAQ,IACG;;;;;;;;;AAUtC,SAAgB,MAAsB;AACpC,QAAO,yBAAS,IAAI,MAAM,CAAC;;;;;;;;;AAU7B,SAAgB,UAAU,SAAiB,OAA+B;AACxE,KAAI,QAAQ,KAAK,QAAQ,UACvB,OAAM,IAAI,WAAW,2CAA2C,QAAQ;AAE1E,QAAO,cAAc,SAAS,MAAM;;;;;;;AAQtC,SAAgB,OAAO,WAAiC;CACtD,MAAM,KAAK,OAAO,UAAU,QAAQ,GAAG,MAAO,KAAK,MAAM,UAAU,QAAQ,IAAU;AACrF,QAAO,IAAI,KAAK,GAAG;;;;;AAMrB,SAAgB,QAAQ,GAAmB,GAA+B;AACxE,KAAI,EAAE,UAAU,EAAE,QAAS,QAAO;AAClC,KAAI,EAAE,UAAU,EAAE,QAAS,QAAO;AAClC,KAAI,EAAE,QAAQ,EAAE,MAAO,QAAO;AAC9B,KAAI,EAAE,QAAQ,EAAE,MAAO,QAAO;AAC9B,QAAO;;AAOT,SAAS,cAAc,SAAiB,OAA+B;AACrE,QAAO;EACL;EACA;EACA,WAAW;AACT,UAAO,GAAG,QAAQ,GAAG,OAAO,MAAM,CAAC,SAAS,GAAG,IAAI;;EAEtD"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@satianurag/hiero-mirror-client",
+  "version": "0.1.0",
+  "description": "Standalone TypeScript client for the Hedera/Hiero Mirror Node REST API",
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./utils": {
+      "types": "./dist/utils.d.ts",
+      "import": "./dist/utils.mjs",
+      "require": "./dist/utils.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "postbuild": "cp dist/index.d.mts dist/index.d.ts && cp dist/utils.d.mts dist/utils.d.ts",
+    "check": "biome check .",
+    "check:fix": "biome check --write .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:integration": "vitest run tests/integration/",
+    "api-report": "api-extractor run --local --verbose",
+    "api-report:ci": "api-extractor run",
+    "generate:spec": "curl -o openapi.yml https://testnet.mirrornode.hedera.com/api/v1/docs/openapi.yml",
+    "generate:types": "npx openapi-typescript openapi.yml -o src/generated/types.ts",
+    "generate": "npm run generate:spec && npm run generate:types",
+    "check:drift": "npx openapi-typescript openapi.yml -o src/generated/types.ts --check"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Satianurag/hiero-mirror-client.git"
+  },
+  "keywords": [
+    "hedera",
+    "hiero",
+    "mirror-node",
+    "blockchain",
+    "sdk",
+    "typescript"
+  ],
+  "author": "satianurag",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Satianurag/hiero-mirror-client/issues"
+  },
+  "homepage": "https://github.com/Satianurag/hiero-mirror-client#readme",
+  "dependencies": {
+    "lossless-json": "^4.0.2"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@changesets/cli": "^2.28.1",
+    "@microsoft/api-extractor": "^7.52.8",
+    "openapi-typescript": "^7.6.1",
+    "tsdown": "^0.12.5",
+    "typescript": "^5.7.3",
+    "vitest": "^3.1.1"
+  }
+}