@thru/replay 0.2.21 → 0.2.23

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { Transport, Interceptor, CallOptions } from '@connectrpc/connect';
-import { ListBlocksRequest, ListBlocksResponse, StreamBlocksRequest, StreamBlocksResponse, ListTransactionsRequest, ListTransactionsResponse, StreamTransactionsRequest, StreamTransactionsResponse, ListEventsRequest, ListEventsResponse, StreamEventsRequest, StreamEventsResponse, GetAccountRequest, Account, ListAccountsRequest, ListAccountsResponse, StreamAccountUpdatesRequest, StreamAccountUpdatesResponse, GetHeightResponse, Filter, BlockView, ConsensusStatus, Block, Transaction, Event, AccountView, AccountMeta, AccountUpdate } from '@thru/proto';
-export { Account, AccountFlags, AccountMeta, AccountPage, AccountUpdate, AccountView, BlockFinished, Event, Filter, FilterParamValue, FilterParamValueSchema, FilterSchema, GetAccountRequest, ListAccountsRequest, ListAccountsResponse, Pubkey as ProtoPubkey, Signature as ProtoSignature, StreamAccountUpdatesRequest, StreamAccountUpdatesResponse } from '@thru/proto';
+import { GetAccountRequest, Account, ListAccountsRequest, ListAccountsResponse, StreamAccountUpdatesRequest, StreamAccountUpdatesResponse, ListBlocksRequest, ListBlocksResponse, StreamBlocksRequest, StreamBlocksResponse, ListTransactionsRequest, ListTransactionsResponse, StreamTransactionsRequest, StreamTransactionsResponse, ListEventsRequest, ListEventsResponse, StreamEventsRequest, StreamEventsResponse, GetHeightResponse, GetChainInfoRequest, GetChainInfoResponse, Filter, BlockView, ConsensusStatus, Block, Transaction, Event, AccountMeta, AccountView, AccountUpdate } from '@thru/sdk/proto';
+export { Account, AccountFlags, AccountMeta, AccountPage, AccountUpdate, AccountView, BlockFinished, Event, Filter, FilterParamValue, FilterParamValueSchema, FilterSchema, GetAccountRequest, ListAccountsRequest, ListAccountsResponse, Pubkey as ProtoPubkey, Signature as ProtoSignature, StreamAccountUpdatesRequest, StreamAccountUpdatesResponse } from '@thru/sdk/proto';
 
 interface ChainClientOptions {
     baseUrl?: string;
@@ -39,7 +39,24 @@ declare class ChainClient implements ReplayDataSource {
     private readonly query;
     private readonly streaming;
     private readonly callOptions?;
+    /**
+     * The HTTP/2 session manager owned by this client. Only set when the client
+     * created its own gRPC transport (i.e., `options.transport` was not provided).
+     * `close()` uses this to tear down the underlying persistent connection.
+     */
+    private readonly sessionManager;
+    private closed;
     constructor(options: ChainClientOptions);
+    /**
+     * Close the underlying HTTP/2 session, if this client owns one. Idempotent.
+     *
+     * Callers are responsible for ensuring that no in-flight RPCs or streams
+     * are still being awaited on this client — pending requests will fail.
+     *
+     * If the client was constructed with an externally-supplied `transport`,
+     * `close()` is a no-op; the caller owns the transport's lifecycle.
+     */
+    close(): void;
     getAccount(request: Partial<GetAccountRequest>): Promise<Account>;
     listAccounts(request: Partial<ListAccountsRequest>): Promise<ListAccountsResponse>;
     listBlocks(request: Partial<ListBlocksRequest>): Promise<ListBlocksResponse>;
@@ -48,10 +65,11 @@ declare class ChainClient implements ReplayDataSource {
     streamTransactions(request: Partial<StreamTransactionsRequest>): AsyncIterable<StreamTransactionsResponse>;
     listEvents(request: Partial<ListEventsRequest>): Promise<ListEventsResponse>;
     streamEvents(request: Partial<StreamEventsRequest>): AsyncIterable<StreamEventsResponse>;
-    private createTransport;
+    private createOwnedTransport;
     private createHeaderInterceptor;
     streamAccountUpdates(request: Partial<StreamAccountUpdatesRequest>): AsyncIterable<StreamAccountUpdatesResponse>;
     getHeight(): Promise<GetHeightResponse>;
+    getChainInfo(request?: Partial<GetChainInfoRequest>): Promise<GetChainInfoResponse>;
 }
 
 type Slot = bigint;
@@ -101,6 +119,7 @@ interface ReplayMetrics {
 interface ReconnectSources<T, Cursor = unknown> {
     subscribeLive: LiveSubscriber<T>;
     fetchBackfill?: BackfillFetcher<T, Cursor>;
+    dispose?: () => void;
 }
 interface ReplayConfig<T, Cursor = unknown> {
     startSlot: Slot;
@@ -111,6 +130,8 @@ interface ReplayConfig<T, Cursor = unknown> {
     extractKey?: (item: T) => string;
     logger?: ReplayLogger;
     resubscribeOnEnd?: boolean;
+    signal?: AbortSignal;
+    dispose?: () => void;
     /**
      * Called on reconnection to get fresh data sources.
      * When provided, creates new client/transport for each reconnection attempt.
@@ -143,11 +164,15 @@ interface BlockReplayOptions {
     minConsensus?: ConsensusStatus;
     logger?: ReplayLogger;
     resubscribeOnEnd?: boolean;
+    signal?: AbortSignal;
 }
 declare function createBlockReplay(options: BlockReplayOptions): ReplayStream<Block, string>;
 
 interface TransactionReplayOptions {
-    client: TransactionSource;
+    /** Client instance for initial connection. Optional if clientFactory provided. */
+    client?: TransactionSource;
+    /** Factory to create fresh clients on reconnection. Enables robust reconnection. */
+    clientFactory?: () => TransactionSource;
     startSlot: Slot;
     safetyMargin?: bigint;
     pageSize?: number;
@@ -156,6 +181,7 @@ interface TransactionReplayOptions {
     returnEvents?: boolean;
     logger?: ReplayLogger;
     resubscribeOnEnd?: boolean;
+    signal?: AbortSignal;
 }
 declare function createTransactionReplay(options: TransactionReplayOptions): ReplayStream<Transaction, string>;
 
@@ -175,6 +201,7 @@ interface EventReplayOptions {
     filter?: Filter;
     logger?: ReplayLogger;
     resubscribeOnEnd?: boolean;
+    signal?: AbortSignal;
 }
 declare function createEventReplay(options: EventReplayOptions): ReplayStream<Event, string>;
 
@@ -287,6 +314,8 @@ interface AccountsByOwnerReplayOptions {
     onBackfillComplete?: (highestSlot: bigint) => void;
     /** Logger for debug/info/warn/error messages (default: NOOP_LOGGER) */
     logger?: ReplayLogger;
+    /** Optional signal to stop backfill/streaming without reconnecting. */
+    signal?: AbortSignal;
 }
 /**
  * Create an async iterable that replays all accounts owned by a program.

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Transport, Interceptor, CallOptions } from '@connectrpc/connect';
-import { ListBlocksRequest, ListBlocksResponse, StreamBlocksRequest, StreamBlocksResponse, ListTransactionsRequest, ListTransactionsResponse, StreamTransactionsRequest, StreamTransactionsResponse, ListEventsRequest, ListEventsResponse, StreamEventsRequest, StreamEventsResponse, GetAccountRequest, Account, ListAccountsRequest, ListAccountsResponse, StreamAccountUpdatesRequest, StreamAccountUpdatesResponse, GetHeightResponse, Filter, BlockView, ConsensusStatus, Block, Transaction, Event, AccountView, AccountMeta, AccountUpdate } from '@thru/proto';
-export { Account, AccountFlags, AccountMeta, AccountPage, AccountUpdate, AccountView, BlockFinished, Event, Filter, FilterParamValue, FilterParamValueSchema, FilterSchema, GetAccountRequest, ListAccountsRequest, ListAccountsResponse, Pubkey as ProtoPubkey, Signature as ProtoSignature, StreamAccountUpdatesRequest, StreamAccountUpdatesResponse } from '@thru/proto';
+import { GetAccountRequest, Account, ListAccountsRequest, ListAccountsResponse, StreamAccountUpdatesRequest, StreamAccountUpdatesResponse, ListBlocksRequest, ListBlocksResponse, StreamBlocksRequest, StreamBlocksResponse, ListTransactionsRequest, ListTransactionsResponse, StreamTransactionsRequest, StreamTransactionsResponse, ListEventsRequest, ListEventsResponse, StreamEventsRequest, StreamEventsResponse, GetHeightResponse, GetChainInfoRequest, GetChainInfoResponse, Filter, BlockView, ConsensusStatus, Block, Transaction, Event, AccountMeta, AccountView, AccountUpdate } from '@thru/sdk/proto';
+export { Account, AccountFlags, AccountMeta, AccountPage, AccountUpdate, AccountView, BlockFinished, Event, Filter, FilterParamValue, FilterParamValueSchema, FilterSchema, GetAccountRequest, ListAccountsRequest, ListAccountsResponse, Pubkey as ProtoPubkey, Signature as ProtoSignature, StreamAccountUpdatesRequest, StreamAccountUpdatesResponse } from '@thru/sdk/proto';
 
 interface ChainClientOptions {
     baseUrl?: string;
@@ -39,7 +39,24 @@ declare class ChainClient implements ReplayDataSource {
     private readonly query;
     private readonly streaming;
     private readonly callOptions?;
+    /**
+     * The HTTP/2 session manager owned by this client. Only set when the client
+     * created its own gRPC transport (i.e., `options.transport` was not provided).
+     * `close()` uses this to tear down the underlying persistent connection.
+     */
+    private readonly sessionManager;
+    private closed;
     constructor(options: ChainClientOptions);
+    /**
+     * Close the underlying HTTP/2 session, if this client owns one. Idempotent.
+     *
+     * Callers are responsible for ensuring that no in-flight RPCs or streams
+     * are still being awaited on this client — pending requests will fail.
+     *
+     * If the client was constructed with an externally-supplied `transport`,
+     * `close()` is a no-op; the caller owns the transport's lifecycle.
+     */
+    close(): void;
     getAccount(request: Partial<GetAccountRequest>): Promise<Account>;
     listAccounts(request: Partial<ListAccountsRequest>): Promise<ListAccountsResponse>;
     listBlocks(request: Partial<ListBlocksRequest>): Promise<ListBlocksResponse>;
@@ -48,10 +65,11 @@ declare class ChainClient implements ReplayDataSource {
     streamTransactions(request: Partial<StreamTransactionsRequest>): AsyncIterable<StreamTransactionsResponse>;
     listEvents(request: Partial<ListEventsRequest>): Promise<ListEventsResponse>;
     streamEvents(request: Partial<StreamEventsRequest>): AsyncIterable<StreamEventsResponse>;
-    private createTransport;
+    private createOwnedTransport;
     private createHeaderInterceptor;
     streamAccountUpdates(request: Partial<StreamAccountUpdatesRequest>): AsyncIterable<StreamAccountUpdatesResponse>;
     getHeight(): Promise<GetHeightResponse>;
+    getChainInfo(request?: Partial<GetChainInfoRequest>): Promise<GetChainInfoResponse>;
 }
 
 type Slot = bigint;
@@ -101,6 +119,7 @@ interface ReplayMetrics {
 interface ReconnectSources<T, Cursor = unknown> {
     subscribeLive: LiveSubscriber<T>;
     fetchBackfill?: BackfillFetcher<T, Cursor>;
+    dispose?: () => void;
 }
 interface ReplayConfig<T, Cursor = unknown> {
     startSlot: Slot;
@@ -111,6 +130,8 @@ interface ReplayConfig<T, Cursor = unknown> {
     extractKey?: (item: T) => string;
     logger?: ReplayLogger;
     resubscribeOnEnd?: boolean;
+    signal?: AbortSignal;
+    dispose?: () => void;
     /**
      * Called on reconnection to get fresh data sources.
      * When provided, creates new client/transport for each reconnection attempt.
@@ -143,11 +164,15 @@ interface BlockReplayOptions {
     minConsensus?: ConsensusStatus;
     logger?: ReplayLogger;
     resubscribeOnEnd?: boolean;
+    signal?: AbortSignal;
 }
 declare function createBlockReplay(options: BlockReplayOptions): ReplayStream<Block, string>;
 
 interface TransactionReplayOptions {
-    client: TransactionSource;
+    /** Client instance for initial connection. Optional if clientFactory provided. */
+    client?: TransactionSource;
+    /** Factory to create fresh clients on reconnection. Enables robust reconnection. */
+    clientFactory?: () => TransactionSource;
     startSlot: Slot;
     safetyMargin?: bigint;
     pageSize?: number;
@@ -156,6 +181,7 @@ interface TransactionReplayOptions {
     returnEvents?: boolean;
     logger?: ReplayLogger;
     resubscribeOnEnd?: boolean;
+    signal?: AbortSignal;
 }
 declare function createTransactionReplay(options: TransactionReplayOptions): ReplayStream<Transaction, string>;
 
@@ -175,6 +201,7 @@ interface EventReplayOptions {
     filter?: Filter;
     logger?: ReplayLogger;
     resubscribeOnEnd?: boolean;
+    signal?: AbortSignal;
 }
 declare function createEventReplay(options: EventReplayOptions): ReplayStream<Event, string>;
 
@@ -287,6 +314,8 @@ interface AccountsByOwnerReplayOptions {
     onBackfillComplete?: (highestSlot: bigint) => void;
     /** Logger for debug/info/warn/error messages (default: NOOP_LOGGER) */
     logger?: ReplayLogger;
+    /** Optional signal to stop backfill/streaming without reconnecting. */
+    signal?: AbortSignal;
 }
 /**
  * Create an async iterable that replays all accounts owned by a program.