hiero-sdk-utils 0.1.0

package/dist/esm/resources/accounts.js

@@ -0,0 +1,56 @@
+// SPDX-License-Identifier: Apache-2.0
+import { paginate } from '../pagination/paginator.js';
+import { ValidationError } from '../errors/index.js';
+import { ENTITY_ID_PATTERN } from '../types/common.js';
+/**
+ * Provides access to Mirror Node account endpoints.
+ *
+ * @example
+ * ```ts
+ * const account = await client.accounts.getById('0.0.1234');
+ * for await (const a of client.accounts.list({ limit: 10 })) {
+ *   console.log(a.account);
+ * }
+ * ```
+ */
+export class AccountsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Retrieves a single account by ID.
+     *
+     * @param accountId - Account in `0.0.X` format
+     * @returns The account info including balance, key, and staking data
+     * @throws {ValidationError} If accountId format is invalid
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    async getById(accountId) {
+        this.validateAccountId(accountId);
+        return this.client.get(`/api/v1/accounts/${accountId}`);
+    }
+    /**
+     * Lists accounts with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of account info objects
+     *
+     * @example
+     * ```ts
+     * for await (const account of client.accounts.list({ limit: 5, order: 'desc' })) {
+     *   console.log(account.account, account.balance.balance);
+     * }
+     * ```
+     */
+    list(params) {
+        return paginate(this.client, '/api/v1/accounts', 'accounts', params);
+    }
+    validateAccountId(id) {
+        if (!ENTITY_ID_PATTERN.test(id)) {
+            throw new ValidationError(`Invalid account ID format: "${id}". Expected "shard.realm.num" format (e.g., "0.0.1234").`, 'INVALID_ACCOUNT_ID');
+        }
+    }
+}
+//# sourceMappingURL=accounts.js.map

package/dist/esm/resources/accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../../src/resources/accounts.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAItC,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CAAC,SAAiB;QAC7B,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAc,oBAAoB,SAAS,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,MAA4B;QAC/B,OAAO,QAAQ,CACb,IAAI,CAAC,MAAM,EACX,kBAAkB,EAClB,UAAU,EACV,MAA+D,CAChE,CAAC;IACJ,CAAC;IAEO,iBAAiB,CAAC,EAAU;QAClC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,eAAe,CACvB,+BAA+B,EAAE,0DAA0D,EAC3F,oBAAoB,CACrB,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/esm/resources/balances.d.ts

@@ -0,0 +1,25 @@
+import type { HieroClient } from '../client/HieroClient.js';
+import type { BalanceEntry, BalancesQueryParams } from '../types/api.js';
+/**
+ * Provides access to Mirror Node balance endpoints.
+ *
+ * @example
+ * ```ts
+ * for await (const entry of client.balances.list({ limit: 10 })) {
+ *   console.log(entry.account, entry.balance);
+ * }
+ * ```
+ */
+export declare class BalancesResource {
+    private readonly client;
+    constructor(client: HieroClient);
+    /**
+     * Lists account balances with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of balance entry objects
+     */
+    list(params?: BalancesQueryParams): AsyncIterable<BalanceEntry>;
+}
+//# sourceMappingURL=balances.d.ts.map

package/dist/esm/resources/balances.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balances.d.ts","sourceRoot":"","sources":["../../../src/resources/balances.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGzE;;;;;;;;;GASG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,aAAa,CAAC,YAAY,CAAC;CAQhE"}

package/dist/esm/resources/balances.js

@@ -0,0 +1,29 @@
+// SPDX-License-Identifier: Apache-2.0
+import { paginate } from '../pagination/paginator.js';
+/**
+ * Provides access to Mirror Node balance endpoints.
+ *
+ * @example
+ * ```ts
+ * for await (const entry of client.balances.list({ limit: 10 })) {
+ *   console.log(entry.account, entry.balance);
+ * }
+ * ```
+ */
+export class BalancesResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Lists account balances with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of balance entry objects
+     */
+    list(params) {
+        return paginate(this.client, '/api/v1/balances', 'balances', params);
+    }
+}
+//# sourceMappingURL=balances.js.map

package/dist/esm/resources/balances.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balances.js","sourceRoot":"","sources":["../../../src/resources/balances.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAItC,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD;;;;;;;;;GASG;AACH,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;;;OAMG;IACH,IAAI,CAAC,MAA4B;QAC/B,OAAO,QAAQ,CACb,IAAI,CAAC,MAAM,EACX,kBAAkB,EAClB,UAAU,EACV,MAA+D,CAChE,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/resources/blocks.d.ts

@@ -0,0 +1,36 @@
+import type { HieroClient } from '../client/HieroClient.js';
+import type { BlockInfo, BlocksQueryParams } from '../types/api.js';
+/**
+ * Provides access to Mirror Node block endpoints.
+ *
+ * @example
+ * ```ts
+ * const block = await client.blocks.getByHashOrNumber(12345);
+ * for await (const b of client.blocks.list()) {
+ *   console.log(b.number, b.hash);
+ * }
+ * ```
+ */
+export declare class BlocksResource {
+    private readonly client;
+    constructor(client: HieroClient);
+    /**
+     * Retrieves a single block by hash or number.
+     *
+     * @param hashOrNumber - Block hash (hex string) or block number
+     * @returns The block info including hash, timestamp, and gas used
+     * @throws {ValidationError} If the input is neither a valid hash nor a number
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    getByHashOrNumber(hashOrNumber: string | number): Promise<BlockInfo>;
+    /**
+     * Lists blocks with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of block info objects
+     */
+    list(params?: BlocksQueryParams): AsyncIterable<BlockInfo>;
+    private validateHashOrNumber;
+}
+//# sourceMappingURL=blocks.d.ts.map

package/dist/esm/resources/blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../../src/resources/blocks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAIpE;;;;;;;;;;GAUG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD;;;;;;;OAOG;IACG,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAK1E;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,aAAa,CAAC,SAAS,CAAC;IAS1D,OAAO,CAAC,oBAAoB;CAiB7B"}

package/dist/esm/resources/blocks.js

@@ -0,0 +1,54 @@
+// SPDX-License-Identifier: Apache-2.0
+import { paginate } from '../pagination/paginator.js';
+import { ValidationError } from '../errors/index.js';
+/**
+ * Provides access to Mirror Node block endpoints.
+ *
+ * @example
+ * ```ts
+ * const block = await client.blocks.getByHashOrNumber(12345);
+ * for await (const b of client.blocks.list()) {
+ *   console.log(b.number, b.hash);
+ * }
+ * ```
+ */
+export class BlocksResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Retrieves a single block by hash or number.
+     *
+     * @param hashOrNumber - Block hash (hex string) or block number
+     * @returns The block info including hash, timestamp, and gas used
+     * @throws {ValidationError} If the input is neither a valid hash nor a number
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    async getByHashOrNumber(hashOrNumber) {
+        this.validateHashOrNumber(hashOrNumber);
+        return this.client.get(`/api/v1/blocks/${hashOrNumber}`);
+    }
+    /**
+     * Lists blocks with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of block info objects
+     */
+    list(params) {
+        return paginate(this.client, '/api/v1/blocks', 'blocks', params);
+    }
+    validateHashOrNumber(value) {
+        if (typeof value === 'number') {
+            if (!Number.isInteger(value) || value < 0) {
+                throw new ValidationError(`Invalid block number: ${value}. Must be a non-negative integer.`, 'INVALID_BLOCK_NUMBER');
+            }
+            return;
+        }
+        if (typeof value === 'string' && value.length === 0) {
+            throw new ValidationError('Block hash or number must not be empty.', 'INVALID_BLOCK_IDENTIFIER');
+        }
+    }
+}
+//# sourceMappingURL=blocks.js.map

package/dist/esm/resources/blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.js","sourceRoot":"","sources":["../../../src/resources/blocks.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAItC,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;;;;OAOG;IACH,KAAK,CAAC,iBAAiB,CAAC,YAA6B;QACnD,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAY,kBAAkB,YAAY,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,MAA0B;QAC7B,OAAO,QAAQ,CACb,IAAI,CAAC,MAAM,EACX,gBAAgB,EAChB,QAAQ,EACR,MAA+D,CAChE,CAAC;IACJ,CAAC;IAEO,oBAAoB,CAAC,KAAsB;QACjD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBAC1C,MAAM,IAAI,eAAe,CACvB,yBAAyB,KAAK,mCAAmC,EACjE,sBAAsB,CACvB,CAAC;YACJ,CAAC;YACD,OAAO;QACT,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,eAAe,CACvB,yCAAyC,EACzC,0BAA0B,CAC3B,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/esm/resources/contracts.d.ts

@@ -0,0 +1,36 @@
+import type { HieroClient } from '../client/HieroClient.js';
+import type { ContractInfo, ContractsQueryParams } from '../types/api.js';
+/**
+ * Provides access to Mirror Node contract endpoints.
+ *
+ * @example
+ * ```ts
+ * const contract = await client.contracts.getById('0.0.1234');
+ * for await (const c of client.contracts.list()) {
+ *   console.log(c.contract_id);
+ * }
+ * ```
+ */
+export declare class ContractsResource {
+    private readonly client;
+    constructor(client: HieroClient);
+    /**
+     * Retrieves a single contract by ID.
+     *
+     * @param contractId - Contract in `0.0.X` format
+     * @returns The contract info including EVM address and timestamps
+     * @throws {ValidationError} If contractId format is invalid
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    getById(contractId: string): Promise<ContractInfo>;
+    /**
+     * Lists contracts with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of contract info objects
+     */
+    list(params?: ContractsQueryParams): AsyncIterable<ContractInfo>;
+    private validateContractId;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/esm/resources/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../src/resources/contracts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAK1E;;;;;;;;;;GAUG;AACH,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD;;;;;;;OAOG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAKxD;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,aAAa,CAAC,YAAY,CAAC;IAShE,OAAO,CAAC,kBAAkB;CAQ3B"}

package/dist/esm/resources/contracts.js

@@ -0,0 +1,49 @@
+// SPDX-License-Identifier: Apache-2.0
+import { paginate } from '../pagination/paginator.js';
+import { ValidationError } from '../errors/index.js';
+import { ENTITY_ID_PATTERN } from '../types/common.js';
+/**
+ * Provides access to Mirror Node contract endpoints.
+ *
+ * @example
+ * ```ts
+ * const contract = await client.contracts.getById('0.0.1234');
+ * for await (const c of client.contracts.list()) {
+ *   console.log(c.contract_id);
+ * }
+ * ```
+ */
+export class ContractsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Retrieves a single contract by ID.
+     *
+     * @param contractId - Contract in `0.0.X` format
+     * @returns The contract info including EVM address and timestamps
+     * @throws {ValidationError} If contractId format is invalid
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    async getById(contractId) {
+        this.validateContractId(contractId);
+        return this.client.get(`/api/v1/contracts/${contractId}`);
+    }
+    /**
+     * Lists contracts with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of contract info objects
+     */
+    list(params) {
+        return paginate(this.client, '/api/v1/contracts', 'contracts', params);
+    }
+    validateContractId(id) {
+        if (!ENTITY_ID_PATTERN.test(id)) {
+            throw new ValidationError(`Invalid contract ID format: "${id}". Expected "shard.realm.num" format (e.g., "0.0.1234").`, 'INVALID_CONTRACT_ID');
+        }
+    }
+}
+//# sourceMappingURL=contracts.js.map

package/dist/esm/resources/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/resources/contracts.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAItC,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CAAC,UAAkB;QAC9B,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAe,qBAAqB,UAAU,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,MAA6B;QAChC,OAAO,QAAQ,CACb,IAAI,CAAC,MAAM,EACX,mBAAmB,EACnB,WAAW,EACX,MAA+D,CAChE,CAAC;IACJ,CAAC;IAEO,kBAAkB,CAAC,EAAU;QACnC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,eAAe,CACvB,gCAAgC,EAAE,0DAA0D,EAC5F,qBAAqB,CACtB,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/esm/resources/nfts.d.ts

@@ -0,0 +1,39 @@
+import type { HieroClient } from '../client/HieroClient.js';
+import type { NftInfo, NftsQueryParams } from '../types/api.js';
+/**
+ * Provides access to Mirror Node NFT endpoints.
+ *
+ * @example
+ * ```ts
+ * for await (const nft of client.nfts.listByToken('0.0.1234')) {
+ *   console.log(nft.serial_number, nft.account_id);
+ * }
+ * ```
+ */
+export declare class NftsResource {
+    private readonly client;
+    constructor(client: HieroClient);
+    /**
+     * Retrieves a specific NFT by token ID and serial number.
+     *
+     * @param tokenId - Token in `0.0.X` format
+     * @param serialNumber - The NFT serial number
+     * @returns The NFT info including metadata and owner
+     * @throws {ValidationError} If tokenId format is invalid or serialNumber is not positive
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    getByTokenAndSerial(tokenId: string, serialNumber: number): Promise<NftInfo>;
+    /**
+     * Lists NFTs for a token. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param tokenId - Token in `0.0.X` format
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of NFT info objects
+     * @throws {ValidationError} If tokenId format is invalid
+     */
+    listByToken(tokenId: string, params?: NftsQueryParams): AsyncIterable<NftInfo>;
+    private validateTokenId;
+    private validateSerialNumber;
+}
+//# sourceMappingURL=nfts.d.ts.map

package/dist/esm/resources/nfts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nfts.d.ts","sourceRoot":"","sources":["../../../src/resources/nfts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAKhE;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD;;;;;;;;OAQG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQlF;;;;;;;;OAQG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,aAAa,CAAC,OAAO,CAAC;IAU9E,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,oBAAoB;CAQ7B"}

package/dist/esm/resources/nfts.js

@@ -0,0 +1,58 @@
+// SPDX-License-Identifier: Apache-2.0
+import { paginate } from '../pagination/paginator.js';
+import { ValidationError } from '../errors/index.js';
+import { ENTITY_ID_PATTERN } from '../types/common.js';
+/**
+ * Provides access to Mirror Node NFT endpoints.
+ *
+ * @example
+ * ```ts
+ * for await (const nft of client.nfts.listByToken('0.0.1234')) {
+ *   console.log(nft.serial_number, nft.account_id);
+ * }
+ * ```
+ */
+export class NftsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Retrieves a specific NFT by token ID and serial number.
+     *
+     * @param tokenId - Token in `0.0.X` format
+     * @param serialNumber - The NFT serial number
+     * @returns The NFT info including metadata and owner
+     * @throws {ValidationError} If tokenId format is invalid or serialNumber is not positive
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    async getByTokenAndSerial(tokenId, serialNumber) {
+        this.validateTokenId(tokenId);
+        this.validateSerialNumber(serialNumber);
+        return this.client.get(`/api/v1/tokens/${tokenId}/nfts/${serialNumber}`);
+    }
+    /**
+     * Lists NFTs for a token. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param tokenId - Token in `0.0.X` format
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of NFT info objects
+     * @throws {ValidationError} If tokenId format is invalid
+     */
+    listByToken(tokenId, params) {
+        this.validateTokenId(tokenId);
+        return paginate(this.client, `/api/v1/tokens/${tokenId}/nfts`, 'nfts', params);
+    }
+    validateTokenId(id) {
+        if (!ENTITY_ID_PATTERN.test(id)) {
+            throw new ValidationError(`Invalid token ID format: "${id}". Expected "shard.realm.num" format (e.g., "0.0.1234").`, 'INVALID_TOKEN_ID');
+        }
+    }
+    validateSerialNumber(serial) {
+        if (!Number.isInteger(serial) || serial <= 0) {
+            throw new ValidationError(`Invalid serial number: ${serial}. Must be a positive integer.`, 'INVALID_SERIAL_NUMBER');
+        }
+    }
+}
+//# sourceMappingURL=nfts.js.map

package/dist/esm/resources/nfts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nfts.js","sourceRoot":"","sources":["../../../src/resources/nfts.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAItC,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;GASG;AACH,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;;;;;OAQG;IACH,KAAK,CAAC,mBAAmB,CAAC,OAAe,EAAE,YAAoB;QAC7D,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CACpB,kBAAkB,OAAO,SAAS,YAAY,EAAE,CACjD,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,WAAW,CAAC,OAAe,EAAE,MAAwB;QACnD,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO,QAAQ,CACb,IAAI,CAAC,MAAM,EACX,kBAAkB,OAAO,OAAO,EAChC,MAAM,EACN,MAA+D,CAChE,CAAC;IACJ,CAAC;IAEO,eAAe,CAAC,EAAU;QAChC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,eAAe,CACvB,6BAA6B,EAAE,0DAA0D,EACzF,kBAAkB,CACnB,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,oBAAoB,CAAC,MAAc;QACzC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,eAAe,CACvB,0BAA0B,MAAM,+BAA+B,EAC/D,uBAAuB,CACxB,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/esm/resources/schedules.d.ts

@@ -0,0 +1,36 @@
+import type { HieroClient } from '../client/HieroClient.js';
+import type { ScheduleInfo, SchedulesQueryParams } from '../types/api.js';
+/**
+ * Provides access to Mirror Node schedule endpoints.
+ *
+ * @example
+ * ```ts
+ * const schedule = await client.schedules.getById('0.0.1234');
+ * for await (const s of client.schedules.list()) {
+ *   console.log(s.schedule_id);
+ * }
+ * ```
+ */
+export declare class SchedulesResource {
+    private readonly client;
+    constructor(client: HieroClient);
+    /**
+     * Retrieves a single schedule by ID.
+     *
+     * @param scheduleId - Schedule in `0.0.X` format
+     * @returns The schedule info including signatures and execution status
+     * @throws {ValidationError} If scheduleId format is invalid
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    getById(scheduleId: string): Promise<ScheduleInfo>;
+    /**
+     * Lists schedules with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of schedule info objects
+     */
+    list(params?: SchedulesQueryParams): AsyncIterable<ScheduleInfo>;
+    private validateScheduleId;
+}
+//# sourceMappingURL=schedules.d.ts.map

package/dist/esm/resources/schedules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedules.d.ts","sourceRoot":"","sources":["../../../src/resources/schedules.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAK1E;;;;;;;;;;GAUG;AACH,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD;;;;;;;OAOG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAKxD;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,aAAa,CAAC,YAAY,CAAC;IAShE,OAAO,CAAC,kBAAkB;CAQ3B"}

package/dist/esm/resources/schedules.js

@@ -0,0 +1,49 @@
+// SPDX-License-Identifier: Apache-2.0
+import { paginate } from '../pagination/paginator.js';
+import { ValidationError } from '../errors/index.js';
+import { ENTITY_ID_PATTERN } from '../types/common.js';
+/**
+ * Provides access to Mirror Node schedule endpoints.
+ *
+ * @example
+ * ```ts
+ * const schedule = await client.schedules.getById('0.0.1234');
+ * for await (const s of client.schedules.list()) {
+ *   console.log(s.schedule_id);
+ * }
+ * ```
+ */
+export class SchedulesResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Retrieves a single schedule by ID.
+     *
+     * @param scheduleId - Schedule in `0.0.X` format
+     * @returns The schedule info including signatures and execution status
+     * @throws {ValidationError} If scheduleId format is invalid
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    async getById(scheduleId) {
+        this.validateScheduleId(scheduleId);
+        return this.client.get(`/api/v1/schedules/${scheduleId}`);
+    }
+    /**
+     * Lists schedules with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of schedule info objects
+     */
+    list(params) {
+        return paginate(this.client, '/api/v1/schedules', 'schedules', params);
+    }
+    validateScheduleId(id) {
+        if (!ENTITY_ID_PATTERN.test(id)) {
+            throw new ValidationError(`Invalid schedule ID format: "${id}". Expected "shard.realm.num" format (e.g., "0.0.1234").`, 'INVALID_SCHEDULE_ID');
+        }
+    }
+}
+//# sourceMappingURL=schedules.js.map

package/dist/esm/resources/schedules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedules.js","sourceRoot":"","sources":["../../../src/resources/schedules.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAItC,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CAAC,UAAkB;QAC9B,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAe,qBAAqB,UAAU,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,MAA6B;QAChC,OAAO,QAAQ,CACb,IAAI,CAAC,MAAM,EACX,mBAAmB,EACnB,WAAW,EACX,MAA+D,CAChE,CAAC;IACJ,CAAC;IAEO,kBAAkB,CAAC,EAAU;QACnC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,eAAe,CACvB,gCAAgC,EAAE,0DAA0D,EAC5F,qBAAqB,CACtB,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/esm/resources/tokens.d.ts

@@ -0,0 +1,36 @@
+import type { HieroClient } from '../client/HieroClient.js';
+import type { TokenInfo, TokensQueryParams } from '../types/api.js';
+/**
+ * Provides access to Mirror Node token endpoints.
+ *
+ * @example
+ * ```ts
+ * const token = await client.tokens.getById('0.0.1234');
+ * for await (const t of client.tokens.list({ type: 'FUNGIBLE_COMMON' })) {
+ *   console.log(t.name, t.symbol);
+ * }
+ * ```
+ */
+export declare class TokensResource {
+    private readonly client;
+    constructor(client: HieroClient);
+    /**
+     * Retrieves a single token by ID.
+     *
+     * @param tokenId - Token in `0.0.X` format
+     * @returns The token info including supply, keys, and custom fees
+     * @throws {ValidationError} If tokenId format is invalid
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    getById(tokenId: string): Promise<TokenInfo>;
+    /**
+     * Lists tokens with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of token info objects
+     */
+    list(params?: TokensQueryParams): AsyncIterable<TokenInfo>;
+    private validateTokenId;
+}
+//# sourceMappingURL=tokens.d.ts.map

package/dist/esm/resources/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../src/resources/tokens.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAKpE;;;;;;;;;;GAUG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD;;;;;;;OAOG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAKlD;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,aAAa,CAAC,SAAS,CAAC;IAS1D,OAAO,CAAC,eAAe;CAQxB"}

package/dist/esm/resources/tokens.js

@@ -0,0 +1,49 @@
+// SPDX-License-Identifier: Apache-2.0
+import { paginate } from '../pagination/paginator.js';
+import { ValidationError } from '../errors/index.js';
+import { ENTITY_ID_PATTERN } from '../types/common.js';
+/**
+ * Provides access to Mirror Node token endpoints.
+ *
+ * @example
+ * ```ts
+ * const token = await client.tokens.getById('0.0.1234');
+ * for await (const t of client.tokens.list({ type: 'FUNGIBLE_COMMON' })) {
+ *   console.log(t.name, t.symbol);
+ * }
+ * ```
+ */
+export class TokensResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Retrieves a single token by ID.
+     *
+     * @param tokenId - Token in `0.0.X` format
+     * @returns The token info including supply, keys, and custom fees
+     * @throws {ValidationError} If tokenId format is invalid
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    async getById(tokenId) {
+        this.validateTokenId(tokenId);
+        return this.client.get(`/api/v1/tokens/${tokenId}`);
+    }
+    /**
+     * Lists tokens with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of token info objects
+     */
+    list(params) {
+        return paginate(this.client, '/api/v1/tokens', 'tokens', params);
+    }
+    validateTokenId(id) {
+        if (!ENTITY_ID_PATTERN.test(id)) {
+            throw new ValidationError(`Invalid token ID format: "${id}". Expected "shard.realm.num" format (e.g., "0.0.1234").`, 'INVALID_TOKEN_ID');
+        }
+    }
+}
+//# sourceMappingURL=tokens.js.map

package/dist/esm/resources/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../../src/resources/tokens.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAItC,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CAAC,OAAe;QAC3B,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAY,kBAAkB,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,MAA0B;QAC7B,OAAO,QAAQ,CACb,IAAI,CAAC,MAAM,EACX,gBAAgB,EAChB,QAAQ,EACR,MAA+D,CAChE,CAAC;IACJ,CAAC;IAEO,eAAe,CAAC,EAAU;QAChC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,eAAe,CACvB,6BAA6B,EAAE,0DAA0D,EACzF,kBAAkB,CACnB,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/esm/resources/topics.d.ts

@@ -0,0 +1,38 @@
+import type { HieroClient } from '../client/HieroClient.js';
+import type { TopicInfo, TopicMessage, TopicMessagesQueryParams } from '../types/api.js';
+/**
+ * Provides access to Mirror Node topic endpoints.
+ *
+ * @example
+ * ```ts
+ * const topic = await client.topics.getById('0.0.1234');
+ * for await (const msg of client.topics.listMessages('0.0.1234')) {
+ *   console.log(msg.message);
+ * }
+ * ```
+ */
+export declare class TopicsResource {
+    private readonly client;
+    constructor(client: HieroClient);
+    /**
+     * Retrieves topic info by ID.
+     *
+     * @param topicId - Topic in `0.0.X` format
+     * @returns The topic info including keys and memo
+     * @throws {ValidationError} If topicId format is invalid
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    getById(topicId: string): Promise<TopicInfo>;
+    /**
+     * Lists messages for a topic. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param topicId - Topic in `0.0.X` format
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of topic message objects
+     * @throws {ValidationError} If topicId format is invalid
+     */
+    listMessages(topicId: string, params?: TopicMessagesQueryParams): AsyncIterable<TopicMessage>;
+    private validateTopicId;
+}
+//# sourceMappingURL=topics.d.ts.map