hiero-sdk-utils 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"topics.d.ts","sourceRoot":"","sources":["../../../src/resources/topics.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAKzF;;;;;;;;;;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;;;;;;;;OAQG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,wBAAwB,GAAG,aAAa,CAAC,YAAY,CAAC;IAU7F,OAAO,CAAC,eAAe;CAQxB"}

package/dist/esm/resources/topics.js

@@ -0,0 +1,52 @@
+// 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 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 class TopicsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * 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
+     */
+    async getById(topicId) {
+        this.validateTopicId(topicId);
+        return this.client.get(`/api/v1/topics/${topicId}`);
+    }
+    /**
+     * 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, params) {
+        this.validateTopicId(topicId);
+        return paginate(this.client, `/api/v1/topics/${topicId}/messages`, 'messages', params);
+    }
+    validateTopicId(id) {
+        if (!ENTITY_ID_PATTERN.test(id)) {
+            throw new ValidationError(`Invalid topic ID format: "${id}". Expected "shard.realm.num" format (e.g., "0.0.1234").`, 'INVALID_TOPIC_ID');
+        }
+    }
+}
+//# sourceMappingURL=topics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"topics.js","sourceRoot":"","sources":["../../../src/resources/topics.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;;;;;;;;OAQG;IACH,YAAY,CAAC,OAAe,EAAE,MAAiC;QAC7D,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO,QAAQ,CACb,IAAI,CAAC,MAAM,EACX,kBAAkB,OAAO,WAAW,EACpC,UAAU,EACV,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/transactions.d.ts

@@ -0,0 +1,35 @@
+import type { HieroClient } from '../client/HieroClient.js';
+import type { TransactionInfo, TransactionsQueryParams } from '../types/api.js';
+/**
+ * Provides access to Mirror Node transaction endpoints.
+ *
+ * @example
+ * ```ts
+ * for await (const tx of client.transactions.list({ limit: 10 })) {
+ *   console.log(tx.transaction_id, tx.result);
+ * }
+ * ```
+ */
+export declare class TransactionsResource {
+    private readonly client;
+    constructor(client: HieroClient);
+    /**
+     * Retrieves a single transaction by its transaction ID.
+     *
+     * @param transactionId - Transaction ID in `shard.realm.num-ssssssssss-nnnnnnnnn` format
+     * @returns The transaction info including transfers and result
+     * @throws {ValidationError} If the transaction ID format is invalid
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    getById(transactionId: string): Promise<TransactionInfo>;
+    /**
+     * Lists transactions with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of transaction info objects
+     */
+    list(params?: TransactionsQueryParams): AsyncIterable<TransactionInfo>;
+    private validateTransactionId;
+}
+//# sourceMappingURL=transactions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.d.ts","sourceRoot":"","sources":["../../../src/resources/transactions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAIhF;;;;;;;;;GASG;AACH,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD;;;;;;;OAOG;IACG,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAe9D;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,aAAa,CAAC,eAAe,CAAC;IAStE,OAAO,CAAC,qBAAqB;CAS9B"}

package/dist/esm/resources/transactions.js

@@ -0,0 +1,53 @@
+// SPDX-License-Identifier: Apache-2.0
+import { paginate } from '../pagination/paginator.js';
+import { ValidationError } from '../errors/index.js';
+/**
+ * Provides access to Mirror Node transaction endpoints.
+ *
+ * @example
+ * ```ts
+ * for await (const tx of client.transactions.list({ limit: 10 })) {
+ *   console.log(tx.transaction_id, tx.result);
+ * }
+ * ```
+ */
+export class TransactionsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Retrieves a single transaction by its transaction ID.
+     *
+     * @param transactionId - Transaction ID in `shard.realm.num-ssssssssss-nnnnnnnnn` format
+     * @returns The transaction info including transfers and result
+     * @throws {ValidationError} If the transaction ID format is invalid
+     * @throws {MirrorNodeError} If the API request fails
+     */
+    async getById(transactionId) {
+        this.validateTransactionId(transactionId);
+        const response = await this.client.get(`/api/v1/transactions/${transactionId}`);
+        const first = response.transactions[0];
+        if (!first) {
+            throw new ValidationError(`No transaction found for ID: "${transactionId}"`, 'TRANSACTION_NOT_FOUND');
+        }
+        return first;
+    }
+    /**
+     * Lists transactions with optional filters. Returns an async iterable
+     * that automatically handles pagination.
+     *
+     * @param params - Optional query parameters for filtering
+     * @returns Async iterable of transaction info objects
+     */
+    list(params) {
+        return paginate(this.client, '/api/v1/transactions', 'transactions', params);
+    }
+    validateTransactionId(id) {
+        // Format: 0.0.XXXX-SSSSSSSSSS-NNNNNNNNN
+        if (!/^\d+\.\d+\.\d+-\d+-\d+$/.test(id)) {
+            throw new ValidationError(`Invalid transaction ID format: "${id}". Expected "shard.realm.num-seconds-nanos" format.`, 'INVALID_TRANSACTION_ID');
+        }
+    }
+}
+//# sourceMappingURL=transactions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.js","sourceRoot":"","sources":["../../../src/resources/transactions.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAItC,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;;;;GASG;AACH,MAAM,OAAO,oBAAoB;IACF;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CAAC,aAAqB;QACjC,IAAI,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CACpC,wBAAwB,aAAa,EAAE,CACxC,CAAC;QACF,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,eAAe,CACvB,iCAAiC,aAAa,GAAG,EACjD,uBAAuB,CACxB,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,MAAgC;QACnC,OAAO,QAAQ,CACb,IAAI,CAAC,MAAM,EACX,sBAAsB,EACtB,cAAc,EACd,MAA+D,CAChE,CAAC;IACJ,CAAC;IAEO,qBAAqB,CAAC,EAAU;QACtC,wCAAwC;QACxC,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,eAAe,CACvB,mCAAmC,EAAE,qDAAqD,EAC1F,wBAAwB,CACzB,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/esm/types/api.d.ts

@@ -0,0 +1,302 @@
+import type { BaseQueryParams, TimestampFilter } from './common.js';
+/** Key object as returned by the Mirror Node */
+export interface Key {
+    _type: string;
+    key: string;
+}
+/** Balance information nested within an account response */
+export interface AccountBalance {
+    balance: number;
+    timestamp: string;
+    tokens: ReadonlyArray<TokenBalance>;
+}
+/** Token balance associated with an account */
+export interface TokenBalance {
+    token_id: string;
+    balance: number;
+}
+/** Full account info as returned by GET /api/v1/accounts/{id} */
+export interface AccountInfo {
+    account: string;
+    alias: string | null;
+    auto_renew_period: number | null;
+    balance: AccountBalance;
+    created_timestamp: string | null;
+    decline_reward: boolean;
+    deleted: boolean;
+    ethereum_nonce: number;
+    evm_address: string | null;
+    expiry_timestamp: string | null;
+    key: Key | null;
+    max_automatic_token_associations: number;
+    memo: string;
+    pending_reward: number;
+    receiver_sig_required: boolean;
+    staked_account_id: string | null;
+    staked_node_id: number | null;
+    stake_period_start: string | null;
+}
+/** Query parameters for listing accounts */
+export interface AccountsQueryParams extends BaseQueryParams, TimestampFilter {
+    'account.id'?: string;
+    'account.balance'?: string;
+    'account.publickey'?: string;
+}
+/** Transfer within a transaction */
+export interface Transfer {
+    account: string;
+    amount: number;
+    is_approval: boolean;
+}
+/** Token transfer within a transaction */
+export interface TokenTransfer {
+    token_id: string;
+    account: string;
+    amount: number;
+    is_approval: boolean;
+}
+/** NFT transfer within a transaction */
+export interface NftTransfer {
+    is_approval: boolean;
+    receiver_account_id: string;
+    sender_account_id: string;
+    serial_number: number;
+    token_id: string;
+}
+/** Full transaction info as returned by the Mirror Node */
+export interface TransactionInfo {
+    bytes: string | null;
+    charged_tx_fee: number;
+    consensus_timestamp: string;
+    entity_id: string | null;
+    max_fee: string;
+    memo_base64: string;
+    name: string;
+    nft_transfers: ReadonlyArray<NftTransfer>;
+    node: string | null;
+    nonce: number;
+    parent_consensus_timestamp: string | null;
+    result: string;
+    scheduled: boolean;
+    staking_reward_transfers: ReadonlyArray<Transfer>;
+    token_transfers: ReadonlyArray<TokenTransfer>;
+    transaction_hash: string;
+    transaction_id: string;
+    transfers: ReadonlyArray<Transfer>;
+    valid_duration_seconds: string;
+    valid_start_timestamp: string;
+}
+/** Query parameters for listing transactions */
+export interface TransactionsQueryParams extends BaseQueryParams, TimestampFilter {
+    'account.id'?: string;
+    result?: 'success' | 'fail';
+    type?: string;
+    transactiontype?: string;
+}
+/** Fixed fee charged for a token transfer */
+export interface FixedFee {
+    amount: number;
+    collector_account_id: string;
+    denominating_token_id: string | null;
+}
+/** Fractional amount used in fractional and royalty fees */
+export interface FractionalAmount {
+    numerator: number;
+    denominator: number;
+}
+/** Fractional fee charged as a fraction of the transfer amount */
+export interface FractionalFee {
+    amount: FractionalAmount;
+    collector_account_id: string;
+    denominating_token_id: string | null;
+    maximum: number | null;
+    minimum: number;
+    net_of_transfers: boolean;
+}
+/** Royalty fee charged on NFT transfers */
+export interface RoyaltyFee {
+    amount: FractionalAmount;
+    collector_account_id: string;
+    fallback_fee: FixedFee | null;
+}
+/** Custom fee schedule for a token */
+export interface CustomFee {
+    created_timestamp: string;
+    fixed_fees: ReadonlyArray<FixedFee>;
+    fractional_fees: ReadonlyArray<FractionalFee>;
+    royalty_fees: ReadonlyArray<RoyaltyFee>;
+}
+/** Full token info as returned by GET /api/v1/tokens/{id} */
+export interface TokenInfo {
+    admin_key: Key | null;
+    auto_renew_account: string | null;
+    auto_renew_period: number | null;
+    created_timestamp: string;
+    custom_fees: CustomFee;
+    decimals: string;
+    deleted: boolean;
+    expiry_timestamp: string | null;
+    fee_schedule_key: Key | null;
+    freeze_default: boolean;
+    freeze_key: Key | null;
+    initial_supply: string;
+    kyc_key: Key | null;
+    max_supply: string;
+    memo: string;
+    modified_timestamp: string;
+    name: string;
+    pause_key: Key | null;
+    pause_status: string;
+    supply_key: Key | null;
+    supply_type: string;
+    symbol: string;
+    token_id: string;
+    total_supply: string;
+    treasury_account_id: string;
+    type: string;
+    wipe_key: Key | null;
+}
+/** Query parameters for listing tokens */
+export interface TokensQueryParams extends BaseQueryParams {
+    publickey?: string;
+    'token.id'?: string;
+    type?: 'ALL' | 'FUNGIBLE_COMMON' | 'NON_FUNGIBLE_UNIQUE';
+    name?: string;
+}
+/** Topic info as returned by GET /api/v1/topics/{id} */
+export interface TopicInfo {
+    admin_key: Key | null;
+    auto_renew_account: string | null;
+    auto_renew_period: number | null;
+    created_timestamp: string;
+    deleted: boolean;
+    memo: string;
+    submit_key: Key | null;
+    timestamp: {
+        from: string;
+        to: string | null;
+    };
+    topic_id: string;
+}
+/** Topic message as returned by GET /api/v1/topics/{id}/messages */
+export interface TopicMessage {
+    chunk_info: {
+        initial_transaction_id: string;
+        number: number;
+        total: number;
+    } | null;
+    consensus_timestamp: string;
+    message: string;
+    payer_account_id: string;
+    running_hash: string;
+    running_hash_version: number;
+    sequence_number: number;
+    topic_id: string;
+}
+/** Query parameters for listing topic messages */
+export interface TopicMessagesQueryParams extends BaseQueryParams, TimestampFilter {
+    sequencenumber?: number;
+}
+/** Contract info as returned by GET /api/v1/contracts/{id} */
+export interface ContractInfo {
+    admin_key: Key | null;
+    auto_renew_account: string | null;
+    auto_renew_period: number | null;
+    contract_id: string;
+    created_timestamp: string;
+    deleted: boolean;
+    evm_address: string;
+    expiry_timestamp: string | null;
+    file_id: string | null;
+    max_automatic_token_associations: number;
+    memo: string;
+    obtainer_id: string | null;
+    permanent_removal: boolean | null;
+    proxy_account_id: string | null;
+    timestamp: {
+        from: string;
+        to: string | null;
+    };
+}
+/** Query parameters for listing contracts */
+export interface ContractsQueryParams extends BaseQueryParams {
+    'contract.id'?: string;
+}
+/** NFT info as returned by the Mirror Node */
+export interface NftInfo {
+    account_id: string;
+    created_timestamp: string;
+    delegating_spender: string | null;
+    deleted: boolean;
+    metadata: string;
+    modified_timestamp: string;
+    serial_number: number;
+    spender: string | null;
+    token_id: string;
+}
+/** Query parameters for listing NFTs */
+export interface NftsQueryParams extends BaseQueryParams {
+    'account.id'?: string;
+    serialnumber?: number;
+}
+/** Balance entry as returned by GET /api/v1/balances */
+export interface BalanceEntry {
+    account: string;
+    balance: number;
+    tokens: ReadonlyArray<TokenBalance>;
+}
+/** Query parameters for listing balances */
+export interface BalancesQueryParams extends BaseQueryParams, TimestampFilter {
+    'account.id'?: string;
+    'account.balance'?: string;
+    'account.publickey'?: string;
+}
+/** Block info as returned by GET /api/v1/blocks/{hashOrNumber} */
+export interface BlockInfo {
+    count: number;
+    gas_used: number;
+    hapi_version: string;
+    hash: string;
+    logs_bloom: string;
+    name: string;
+    number: number;
+    previous_hash: string;
+    size: number | null;
+    timestamp: {
+        from: string;
+        to: string;
+    };
+}
+/** Query parameters for listing blocks */
+export interface BlocksQueryParams extends BaseQueryParams {
+    'block.number'?: string;
+}
+/** Signature on a scheduled transaction */
+export interface ScheduleSignature {
+    consensus_timestamp: string;
+    public_key_prefix: string;
+    signature: string;
+    type: string;
+}
+/** Schedule info as returned by GET /api/v1/schedules/{id} */
+export interface ScheduleInfo {
+    admin_key: Key | null;
+    consensus_timestamp: string | null;
+    creator_account_id: string;
+    deleted: boolean;
+    executed_timestamp: string | null;
+    expiration_time: string | null;
+    memo: string;
+    payer_account_id: string;
+    schedule_id: string;
+    signatures: ReadonlyArray<ScheduleSignature>;
+    transaction_body: string;
+    wait_for_expiry: boolean;
+}
+/** Query parameters for listing schedules */
+export interface SchedulesQueryParams extends BaseQueryParams {
+    'account.id'?: string;
+    'schedule.id'?: string;
+    executed?: boolean;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/esm/types/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/types/api.ts"],"names":[],"mappings":"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"}

package/dist/esm/types/api.js

@@ -0,0 +1,3 @@
+// SPDX-License-Identifier: Apache-2.0
+export {};
+//# sourceMappingURL=api.js.map

package/dist/esm/types/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/types/api.ts"],"names":[],"mappings":"AAAA,sCAAsC"}

package/dist/esm/types/common.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Regular expression pattern for validating Hedera entity IDs.
+ * Format: `shard.realm.num` where each segment is a non-negative integer.
+ *
+ * @example
+ * ```ts
+ * ENTITY_ID_PATTERN.test('0.0.1234'); // true
+ * ENTITY_ID_PATTERN.test('invalid');   // false
+ * ```
+ */
+export declare const ENTITY_ID_PATTERN: RegExp;
+/**
+ * Pagination links returned by the Mirror Node API.
+ */
+export interface PaginationLinks {
+    /** URL for the next page of results, or null if no more pages */
+    next: string | null;
+}
+/**
+ * Generic paginated response shape from the Mirror Node API.
+ * The data array is keyed by the resource name (e.g., 'accounts', 'transactions').
+ */
+export interface PaginatedResponse<T> {
+    /** Pagination navigation links */
+    links: PaginationLinks;
+    /** Dynamic key containing the array of items */
+    [key: string]: ReadonlyArray<T> | PaginationLinks | undefined;
+}
+/**
+ * Common query parameters supported by most Mirror Node list endpoints.
+ */
+export interface BaseQueryParams {
+    /** Maximum number of items per page (Mirror Node default is 25, max is 100) */
+    limit?: number;
+    /** Sort order: 'asc' or 'desc' */
+    order?: 'asc' | 'desc';
+}
+/**
+ * Timestamp filter used across many Mirror Node endpoints.
+ * Values are in `seconds.nanoseconds` format.
+ */
+export interface TimestampFilter {
+    /** Return results after this timestamp */
+    'timestamp.gt'?: string;
+    /** Return results at or after this timestamp */
+    'timestamp.gte'?: string;
+    /** Return results before this timestamp */
+    'timestamp.lt'?: string;
+    /** Return results at or before this timestamp */
+    'timestamp.lte'?: string;
+}
+//# sourceMappingURL=common.d.ts.map

package/dist/esm/types/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/types/common.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,QAAoB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,kCAAkC;IAClC,KAAK,EAAE,eAAe,CAAC;IACvB,gDAAgD;IAChD,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,eAAe,GAAG,SAAS,CAAC;CAC/D;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/esm/types/common.js

@@ -0,0 +1,13 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Regular expression pattern for validating Hedera entity IDs.
+ * Format: `shard.realm.num` where each segment is a non-negative integer.
+ *
+ * @example
+ * ```ts
+ * ENTITY_ID_PATTERN.test('0.0.1234'); // true
+ * ENTITY_ID_PATTERN.test('invalid');   // false
+ * ```
+ */
+export const ENTITY_ID_PATTERN = /^\d+\.\d+\.\d+$/;
+//# sourceMappingURL=common.js.map

package/dist/esm/types/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/types/common.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,iBAAiB,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "hiero-sdk-utils",
+  "version": "0.1.0",
+  "description": "TypeScript utilities for Hedera/Hiero Mirror Node — typed queries, auto-pagination, and developer helpers",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    }
+  },
+  "files": ["dist/"],
+  "engines": { "node": ">=18.0.0" },
+  "scripts": {
+    "build":          "tsc -p tsconfig.json && tsc -p tsconfig.cjs.json",
+    "build:esm":      "tsc -p tsconfig.json",
+    "build:cjs":      "tsc -p tsconfig.cjs.json",
+    "test":           "vitest run",
+    "test:unit":      "vitest run tests/unit/",
+    "test:integration": "vitest run tests/integration/",
+    "lint":           "eslint src/ tests/ --max-warnings 0",
+    "typecheck":      "tsc --noEmit",
+    "prepublishOnly": "npm run typecheck && npm run lint && npm run test && npm run build"
+  },
+  "keywords": ["hedera", "hiero", "mirror-node", "sdk", "blockchain", "hashgraph", "typescript", "rest-api"],
+  "author": "Dmitrij Titarenko <dtytarenko666@gmail.com>",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/dmitrijtitarenko/hiero-sdk-utils#readme",
+  "bugs": { "url": "https://github.com/dmitrijtitarenko/hiero-sdk-utils/issues" },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dmitrijtitarenko/hiero-sdk-utils.git",
+    "directory": "packages/core"
+  },
+  "publishConfig": { "access": "public" },
+  "devDependencies": {
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "@vitest/coverage-v8": "^1.6.1",
+    "eslint": "^8.57.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  }
+}