@vue-solana/vue 1.2.0 → 2.1.0

package/dist/useSignatureStatus.d.mts

@@ -1,22 +1,26 @@
 import * as vue from 'vue';
 import { MaybeRefOrGetter } from 'vue';
-import { Commitment, TransactionSignature, SignatureStatus } from '@vue-solana/core/web3';
+import { Commitment } from '@vue-solana/core/kit';
 import { SolanaError } from '@vue-solana/core/errors';
 
 interface UseSignatureStatusOptions {
     commitment?: Commitment;
     pollIntervalMs?: number;
     searchTransactionHistory?: boolean;
-    subscribe?: boolean;
 }
-declare function useSignatureStatus(signature: MaybeRefOrGetter<TransactionSignature | null | undefined>, options?: UseSignatureStatusOptions): {
+interface SignatureStatus {
+    slot: number;
+    confirmations: number | null;
+    err: unknown | null;
+    confirmationStatus: Commitment | null;
+}
+declare function useSignatureStatus(signature: MaybeRefOrGetter<string | null | undefined>, options?: UseSignatureStatusOptions): {
     status: vue.ShallowRef<SignatureStatus | null, SignatureStatus | null>;
     loading: vue.ShallowRef<boolean, boolean>;
     error: vue.ShallowRef<SolanaError | null, SolanaError | null>;
     refresh: () => Promise<SignatureStatus | null>;
     stopPolling: () => void;
-    stopSubscription: () => Promise<void>;
 };
 
 export { useSignatureStatus };
-export type { UseSignatureStatusOptions };
+export type { SignatureStatus, UseSignatureStatusOptions };

package/dist/useSignatureStatus.d.ts

@@ -1,22 +1,26 @@
 import * as vue from 'vue';
 import { MaybeRefOrGetter } from 'vue';
-import { Commitment, TransactionSignature, SignatureStatus } from '@vue-solana/core/web3';
+import { Commitment } from '@vue-solana/core/kit';
 import { SolanaError } from '@vue-solana/core/errors';
 
 interface UseSignatureStatusOptions {
     commitment?: Commitment;
     pollIntervalMs?: number;
     searchTransactionHistory?: boolean;
-    subscribe?: boolean;
 }
-declare function useSignatureStatus(signature: MaybeRefOrGetter<TransactionSignature | null | undefined>, options?: UseSignatureStatusOptions): {
+interface SignatureStatus {
+    slot: number;
+    confirmations: number | null;
+    err: unknown | null;
+    confirmationStatus: Commitment | null;
+}
+declare function useSignatureStatus(signature: MaybeRefOrGetter<string | null | undefined>, options?: UseSignatureStatusOptions): {
     status: vue.ShallowRef<SignatureStatus | null, SignatureStatus | null>;
     loading: vue.ShallowRef<boolean, boolean>;
     error: vue.ShallowRef<SolanaError | null, SolanaError | null>;
     refresh: () => Promise<SignatureStatus | null>;
     stopPolling: () => void;
-    stopSubscription: () => Promise<void>;
 };
 
 export { useSignatureStatus };
-export type { UseSignatureStatusOptions };
+export type { SignatureStatus, UseSignatureStatusOptions };

package/dist/useSignatureStatus.mjs

@@ -1,7 +1,8 @@
-export { u as useSignatureStatus } from './shared/vue.B12Pt1PQ.mjs';
+export { u as useSignatureStatus } from './shared/vue.CXB4NEMA.mjs';
 import '@vue-solana/core/errors';
 import 'bs58';
 import 'vue';
-import './shared/vue.DiNn3XHm.mjs';
-import './shared/vue.BtUKvuQw.mjs';
-import './shared/vue.CYKT65tB.mjs';
+import './shared/vue.CpkwC8Th.mjs';
+import './shared/vue.Mxc8w6Qk.mjs';
+import './shared/vue.CQh3AUE8.mjs';
+import './shared/vue.D_P5SqqD.mjs';

package/dist/useSolana.cjs

@@ -1,7 +1,8 @@
 'use strict';
 
-const useSolana = require('./shared/vue.BE4KHksm.cjs');
+const useSolana = require('./shared/vue.DE3emjSF.cjs');
 require('vue');
+require('./shared/vue.DEHxNvUX.cjs');
 
 
 

package/dist/useSolana.mjs

@@ -1,2 +1,3 @@
-export { t as tryUseSolana, u as useSolana } from './shared/vue.CYKT65tB.mjs';
+export { t as tryUseSolana, u as useSolana } from './shared/vue.CQh3AUE8.mjs';
 import 'vue';
+import './shared/vue.D_P5SqqD.mjs';

package/dist/useSolanaClient.cjs

@@ -1,8 +1,9 @@
 'use strict';
 
-const useSolanaClient = require('./shared/vue.COPnX5fq.cjs');
-require('./shared/vue.BE4KHksm.cjs');
+const useSolanaClient = require('./shared/vue.BIxphCAq.cjs');
+require('./shared/vue.DE3emjSF.cjs');
 require('vue');
+require('./shared/vue.DEHxNvUX.cjs');
 
 
 

package/dist/useSolanaClient.mjs

@@ -1,3 +1,4 @@
-export { u as useSolanaClient } from './shared/vue.By1CUlOU.mjs';
-import './shared/vue.CYKT65tB.mjs';
+export { u as useSolanaClient } from './shared/vue.Mxc8w6Qk.mjs';
+import './shared/vue.CQh3AUE8.mjs';
 import 'vue';
+import './shared/vue.D_P5SqqD.mjs';

package/dist/useSubscription.cjs

@@ -0,0 +1,9 @@
+'use strict';
+
+const useSubscription = require('./shared/vue.BVj9lWBK.cjs');
+require('@vue-solana/core/errors');
+require('vue');
+
+
+
+exports.useSubscription = useSubscription.useSubscription;

package/dist/useSubscription.d.cts

@@ -0,0 +1,58 @@
+import { SolanaError } from '@vue-solana/core/errors';
+import { ReactiveStreamStore } from '@vue-solana/core/kit';
+import { ComputedRef, Ref } from 'vue';
+
+type UseSubscriptionStatus = "loading" | "loaded" | "error" | "disabled";
+/**
+ * A subscription source accepted by `useSubscription`:
+ *
+ * - a Kit reactive stream source such as `PendingRpcSubscriptionsRequest`
+ *   (for example `rpcSubscriptions.accountNotifications(address)`),
+ * - a `ref`/`computed` of a source or `null` to disable, or
+ * - `null` to disable outright.
+ */
+type UseSubscriptionSource<TResult> = {
+    reactiveStore: () => ReactiveStreamStore<TResult>;
+} | Ref<{
+    reactiveStore: () => ReactiveStreamStore<TResult>;
+} | null | undefined> | null | undefined;
+interface UseSubscriptionOptions {
+    /**
+     * Returns a caller-provided `AbortSignal` per connection (for example
+     * `AbortSignal.timeout(30_000)`), composed with the per-connection signal by
+     * the underlying store. Aborting it fails the connection with the abort
+     * reason without touching other state.
+     */
+    getAbortSignal?: (connection: number) => AbortSignal | null | undefined;
+    /**
+     * Called when the subscription transitions into `error`.
+     */
+    onError?: (error: unknown) => void;
+}
+interface UseSubscriptionReturn<TResult> {
+    data: ComputedRef<TResult | undefined>;
+    error: ComputedRef<SolanaError | null>;
+    reconnect: () => void;
+    status: ComputedRef<UseSubscriptionStatus>;
+}
+/**
+ * Live data from RPC subscriptions and other reactive stream sources.
+ *
+ * Accepts a Kit reactive stream source (duck-typed on `reactiveStore()`),
+ * bridges its `{ subscribe, getState }` contract into Vue reactive state, and
+ * tears the connection down when the component unmounts.
+ *
+ * Status set: `loading` | `loaded` | `error` | `disabled`.
+ *
+ * - A `null` source disables the subscription and clears state.
+ * - `reconnect()` re-opens the connection with stale-while-revalidate: the
+ *   last known `data` stays visible until fresh data arrives.
+ * - Errors preserve the last known `data`; only the first error per connection
+ *   window is captured (matching the underlying store's contract).
+ * - Changing a ref/computed source tears down the previous subscription and
+ *   connects to the new one.
+ */
+declare function useSubscription<TResult>(source: UseSubscriptionSource<TResult>, options?: UseSubscriptionOptions): UseSubscriptionReturn<TResult>;
+
+export { useSubscription };
+export type { UseSubscriptionOptions, UseSubscriptionReturn, UseSubscriptionSource, UseSubscriptionStatus };

package/dist/useSubscription.d.mts

@@ -0,0 +1,58 @@
+import { SolanaError } from '@vue-solana/core/errors';
+import { ReactiveStreamStore } from '@vue-solana/core/kit';
+import { ComputedRef, Ref } from 'vue';
+
+type UseSubscriptionStatus = "loading" | "loaded" | "error" | "disabled";
+/**
+ * A subscription source accepted by `useSubscription`:
+ *
+ * - a Kit reactive stream source such as `PendingRpcSubscriptionsRequest`
+ *   (for example `rpcSubscriptions.accountNotifications(address)`),
+ * - a `ref`/`computed` of a source or `null` to disable, or
+ * - `null` to disable outright.
+ */
+type UseSubscriptionSource<TResult> = {
+    reactiveStore: () => ReactiveStreamStore<TResult>;
+} | Ref<{
+    reactiveStore: () => ReactiveStreamStore<TResult>;
+} | null | undefined> | null | undefined;
+interface UseSubscriptionOptions {
+    /**
+     * Returns a caller-provided `AbortSignal` per connection (for example
+     * `AbortSignal.timeout(30_000)`), composed with the per-connection signal by
+     * the underlying store. Aborting it fails the connection with the abort
+     * reason without touching other state.
+     */
+    getAbortSignal?: (connection: number) => AbortSignal | null | undefined;
+    /**
+     * Called when the subscription transitions into `error`.
+     */
+    onError?: (error: unknown) => void;
+}
+interface UseSubscriptionReturn<TResult> {
+    data: ComputedRef<TResult | undefined>;
+    error: ComputedRef<SolanaError | null>;
+    reconnect: () => void;
+    status: ComputedRef<UseSubscriptionStatus>;
+}
+/**
+ * Live data from RPC subscriptions and other reactive stream sources.
+ *
+ * Accepts a Kit reactive stream source (duck-typed on `reactiveStore()`),
+ * bridges its `{ subscribe, getState }` contract into Vue reactive state, and
+ * tears the connection down when the component unmounts.
+ *
+ * Status set: `loading` | `loaded` | `error` | `disabled`.
+ *
+ * - A `null` source disables the subscription and clears state.
+ * - `reconnect()` re-opens the connection with stale-while-revalidate: the
+ *   last known `data` stays visible until fresh data arrives.
+ * - Errors preserve the last known `data`; only the first error per connection
+ *   window is captured (matching the underlying store's contract).
+ * - Changing a ref/computed source tears down the previous subscription and
+ *   connects to the new one.
+ */
+declare function useSubscription<TResult>(source: UseSubscriptionSource<TResult>, options?: UseSubscriptionOptions): UseSubscriptionReturn<TResult>;
+
+export { useSubscription };
+export type { UseSubscriptionOptions, UseSubscriptionReturn, UseSubscriptionSource, UseSubscriptionStatus };

package/dist/useSubscription.d.ts

@@ -0,0 +1,58 @@
+import { SolanaError } from '@vue-solana/core/errors';
+import { ReactiveStreamStore } from '@vue-solana/core/kit';
+import { ComputedRef, Ref } from 'vue';
+
+type UseSubscriptionStatus = "loading" | "loaded" | "error" | "disabled";
+/**
+ * A subscription source accepted by `useSubscription`:
+ *
+ * - a Kit reactive stream source such as `PendingRpcSubscriptionsRequest`
+ *   (for example `rpcSubscriptions.accountNotifications(address)`),
+ * - a `ref`/`computed` of a source or `null` to disable, or
+ * - `null` to disable outright.
+ */
+type UseSubscriptionSource<TResult> = {
+    reactiveStore: () => ReactiveStreamStore<TResult>;
+} | Ref<{
+    reactiveStore: () => ReactiveStreamStore<TResult>;
+} | null | undefined> | null | undefined;
+interface UseSubscriptionOptions {
+    /**
+     * Returns a caller-provided `AbortSignal` per connection (for example
+     * `AbortSignal.timeout(30_000)`), composed with the per-connection signal by
+     * the underlying store. Aborting it fails the connection with the abort
+     * reason without touching other state.
+     */
+    getAbortSignal?: (connection: number) => AbortSignal | null | undefined;
+    /**
+     * Called when the subscription transitions into `error`.
+     */
+    onError?: (error: unknown) => void;
+}
+interface UseSubscriptionReturn<TResult> {
+    data: ComputedRef<TResult | undefined>;
+    error: ComputedRef<SolanaError | null>;
+    reconnect: () => void;
+    status: ComputedRef<UseSubscriptionStatus>;
+}
+/**
+ * Live data from RPC subscriptions and other reactive stream sources.
+ *
+ * Accepts a Kit reactive stream source (duck-typed on `reactiveStore()`),
+ * bridges its `{ subscribe, getState }` contract into Vue reactive state, and
+ * tears the connection down when the component unmounts.
+ *
+ * Status set: `loading` | `loaded` | `error` | `disabled`.
+ *
+ * - A `null` source disables the subscription and clears state.
+ * - `reconnect()` re-opens the connection with stale-while-revalidate: the
+ *   last known `data` stays visible until fresh data arrives.
+ * - Errors preserve the last known `data`; only the first error per connection
+ *   window is captured (matching the underlying store's contract).
+ * - Changing a ref/computed source tears down the previous subscription and
+ *   connects to the new one.
+ */
+declare function useSubscription<TResult>(source: UseSubscriptionSource<TResult>, options?: UseSubscriptionOptions): UseSubscriptionReturn<TResult>;
+
+export { useSubscription };
+export type { UseSubscriptionOptions, UseSubscriptionReturn, UseSubscriptionSource, UseSubscriptionStatus };

package/dist/useSubscription.mjs

@@ -0,0 +1,3 @@
+export { u as useSubscription } from './shared/vue.B8ub540p.mjs';
+import '@vue-solana/core/errors';
+import 'vue';

package/dist/useTokenAccounts.cjs

@@ -1,13 +1,14 @@
 'use strict';
 
-const useTokenAccounts = require('./shared/vue.BbX3ePDY.cjs');
-require('@vue-solana/core/address');
-require('@vue-solana/core/errors');
+const useTokenAccounts = require('./shared/vue.Bwd1sGAM.cjs');
 require('@vue-solana/core/token-accounts');
+require('@vue-solana/core/errors');
+require('@vue-solana/core/address');
 require('vue');
-require('./shared/vue.DCgByzxg.cjs');
-require('./shared/vue.LNhX07HB.cjs');
-require('./shared/vue.BE4KHksm.cjs');
+require('./shared/vue.BVaMoz9y.cjs');
+require('./shared/vue.BIxphCAq.cjs');
+require('./shared/vue.DE3emjSF.cjs');
+require('./shared/vue.DEHxNvUX.cjs');
 
 
 

package/dist/useTokenAccounts.d.cts

@@ -1,18 +1,18 @@
 import * as vue from 'vue';
 import { MaybeRefOrGetter } from 'vue';
-import { Commitment, PublicKey } from '@vue-solana/core/web3';
-import { TokenAccount } from '@vue-solana/core/spl-token';
+import { Commitment, Address } from '@vue-solana/core/kit';
+import { TokenAccountInfo } from '@vue-solana/core/token-accounts';
 import { SolanaError } from '@vue-solana/core/errors';
 
 interface UseTokenAccountsOptions {
     commitment?: Commitment;
-    programId?: PublicKey;
+    programId?: Address;
 }
-declare function useTokenAccounts(owner: MaybeRefOrGetter<PublicKey | string | null | undefined>, options?: UseTokenAccountsOptions): {
-    tokenAccounts: vue.ShallowRef<TokenAccount[], TokenAccount[]>;
+declare function useTokenAccounts(owner: MaybeRefOrGetter<Address | string | null | undefined>, options?: UseTokenAccountsOptions): {
+    tokenAccounts: vue.ShallowRef<TokenAccountInfo[], TokenAccountInfo[]>;
     loading: vue.ShallowRef<boolean, boolean>;
     error: vue.ShallowRef<SolanaError | null, SolanaError | null>;
-    refresh: () => Promise<TokenAccount[] | null>;
+    refresh: () => Promise<TokenAccountInfo[] | null>;
 };
 
 export { useTokenAccounts };

package/dist/useTokenAccounts.d.mts

@@ -1,18 +1,18 @@
 import * as vue from 'vue';
 import { MaybeRefOrGetter } from 'vue';
-import { Commitment, PublicKey } from '@vue-solana/core/web3';
-import { TokenAccount } from '@vue-solana/core/spl-token';
+import { Commitment, Address } from '@vue-solana/core/kit';
+import { TokenAccountInfo } from '@vue-solana/core/token-accounts';
 import { SolanaError } from '@vue-solana/core/errors';
 
 interface UseTokenAccountsOptions {
     commitment?: Commitment;
-    programId?: PublicKey;
+    programId?: Address;
 }
-declare function useTokenAccounts(owner: MaybeRefOrGetter<PublicKey | string | null | undefined>, options?: UseTokenAccountsOptions): {
-    tokenAccounts: vue.ShallowRef<TokenAccount[], TokenAccount[]>;
+declare function useTokenAccounts(owner: MaybeRefOrGetter<Address | string | null | undefined>, options?: UseTokenAccountsOptions): {
+    tokenAccounts: vue.ShallowRef<TokenAccountInfo[], TokenAccountInfo[]>;
     loading: vue.ShallowRef<boolean, boolean>;
     error: vue.ShallowRef<SolanaError | null, SolanaError | null>;
-    refresh: () => Promise<TokenAccount[] | null>;
+    refresh: () => Promise<TokenAccountInfo[] | null>;
 };
 
 export { useTokenAccounts };

package/dist/useTokenAccounts.d.ts

@@ -1,18 +1,18 @@
 import * as vue from 'vue';
 import { MaybeRefOrGetter } from 'vue';
-import { Commitment, PublicKey } from '@vue-solana/core/web3';
-import { TokenAccount } from '@vue-solana/core/spl-token';
+import { Commitment, Address } from '@vue-solana/core/kit';
+import { TokenAccountInfo } from '@vue-solana/core/token-accounts';
 import { SolanaError } from '@vue-solana/core/errors';
 
 interface UseTokenAccountsOptions {
     commitment?: Commitment;
-    programId?: PublicKey;
+    programId?: Address;
 }
-declare function useTokenAccounts(owner: MaybeRefOrGetter<PublicKey | string | null | undefined>, options?: UseTokenAccountsOptions): {
-    tokenAccounts: vue.ShallowRef<TokenAccount[], TokenAccount[]>;
+declare function useTokenAccounts(owner: MaybeRefOrGetter<Address | string | null | undefined>, options?: UseTokenAccountsOptions): {
+    tokenAccounts: vue.ShallowRef<TokenAccountInfo[], TokenAccountInfo[]>;
     loading: vue.ShallowRef<boolean, boolean>;
     error: vue.ShallowRef<SolanaError | null, SolanaError | null>;
-    refresh: () => Promise<TokenAccount[] | null>;
+    refresh: () => Promise<TokenAccountInfo[] | null>;
 };
 
 export { useTokenAccounts };

package/dist/useTokenAccounts.mjs

@@ -1,8 +1,9 @@
-export { u as useTokenAccounts } from './shared/vue.CKTUFwSI.mjs';
-import '@vue-solana/core/address';
-import '@vue-solana/core/errors';
+export { u as useTokenAccounts } from './shared/vue.BOpgWr43.mjs';
 import '@vue-solana/core/token-accounts';
+import '@vue-solana/core/errors';
+import '@vue-solana/core/address';
 import 'vue';
-import './shared/vue.DiNn3XHm.mjs';
-import './shared/vue.BtUKvuQw.mjs';
-import './shared/vue.CYKT65tB.mjs';
+import './shared/vue.CpkwC8Th.mjs';
+import './shared/vue.Mxc8w6Qk.mjs';
+import './shared/vue.CQh3AUE8.mjs';
+import './shared/vue.D_P5SqqD.mjs';

package/dist/useTokenBalance.cjs

@@ -1,13 +1,14 @@
 'use strict';
 
-const useTokenBalance = require('./shared/vue.j1vB3h1n.cjs');
-require('@vue-solana/core/address');
-require('@vue-solana/core/errors');
+const useTokenBalance = require('./shared/vue.DAg5wC1G.cjs');
 require('@vue-solana/core/token-accounts');
+require('@vue-solana/core/errors');
+require('@vue-solana/core/address');
 require('vue');
-require('./shared/vue.DCgByzxg.cjs');
-require('./shared/vue.LNhX07HB.cjs');
-require('./shared/vue.BE4KHksm.cjs');
+require('./shared/vue.BVaMoz9y.cjs');
+require('./shared/vue.BIxphCAq.cjs');
+require('./shared/vue.DE3emjSF.cjs');
+require('./shared/vue.DEHxNvUX.cjs');
 
 
 

package/dist/useTokenBalance.d.cts

@@ -1,10 +1,10 @@
 import * as _vue_solana_core_token_accounts from '@vue-solana/core/token-accounts';
 import * as vue from 'vue';
 import { MaybeRefOrGetter } from 'vue';
-import { PublicKey } from '@vue-solana/core/web3';
+import { Commitment } from '@vue-solana/core/kit';
 import { SolanaError } from '@vue-solana/core/errors';
 
-declare function useTokenBalance(mint: MaybeRefOrGetter<PublicKey | string | null | undefined>, owner: MaybeRefOrGetter<PublicKey | string | null | undefined>): {
+declare function useTokenBalance(mint: MaybeRefOrGetter<string | null | undefined>, owner: MaybeRefOrGetter<string | null | undefined>, commitment?: Commitment): {
     balance: vue.ShallowRef<bigint | null, bigint | null>;
     decimals: vue.ShallowRef<number | null, number | null>;
     loading: vue.ShallowRef<boolean, boolean>;

package/dist/useTokenBalance.d.mts

@@ -1,10 +1,10 @@
 import * as _vue_solana_core_token_accounts from '@vue-solana/core/token-accounts';
 import * as vue from 'vue';
 import { MaybeRefOrGetter } from 'vue';
-import { PublicKey } from '@vue-solana/core/web3';
+import { Commitment } from '@vue-solana/core/kit';
 import { SolanaError } from '@vue-solana/core/errors';
 
-declare function useTokenBalance(mint: MaybeRefOrGetter<PublicKey | string | null | undefined>, owner: MaybeRefOrGetter<PublicKey | string | null | undefined>): {
+declare function useTokenBalance(mint: MaybeRefOrGetter<string | null | undefined>, owner: MaybeRefOrGetter<string | null | undefined>, commitment?: Commitment): {
     balance: vue.ShallowRef<bigint | null, bigint | null>;
     decimals: vue.ShallowRef<number | null, number | null>;
     loading: vue.ShallowRef<boolean, boolean>;

package/dist/useTokenBalance.d.ts

@@ -1,10 +1,10 @@
 import * as _vue_solana_core_token_accounts from '@vue-solana/core/token-accounts';
 import * as vue from 'vue';
 import { MaybeRefOrGetter } from 'vue';
-import { PublicKey } from '@vue-solana/core/web3';
+import { Commitment } from '@vue-solana/core/kit';
 import { SolanaError } from '@vue-solana/core/errors';
 
-declare function useTokenBalance(mint: MaybeRefOrGetter<PublicKey | string | null | undefined>, owner: MaybeRefOrGetter<PublicKey | string | null | undefined>): {
+declare function useTokenBalance(mint: MaybeRefOrGetter<string | null | undefined>, owner: MaybeRefOrGetter<string | null | undefined>, commitment?: Commitment): {
     balance: vue.ShallowRef<bigint | null, bigint | null>;
     decimals: vue.ShallowRef<number | null, number | null>;
     loading: vue.ShallowRef<boolean, boolean>;

package/dist/useTokenBalance.mjs

@@ -1,8 +1,9 @@
-export { u as useTokenBalance } from './shared/vue.D0ycWj82.mjs';
-import '@vue-solana/core/address';
-import '@vue-solana/core/errors';
+export { u as useTokenBalance } from './shared/vue.BD6Gm1nl.mjs';
 import '@vue-solana/core/token-accounts';
+import '@vue-solana/core/errors';
+import '@vue-solana/core/address';
 import 'vue';
-import './shared/vue.DiNn3XHm.mjs';
-import './shared/vue.BtUKvuQw.mjs';
-import './shared/vue.CYKT65tB.mjs';
+import './shared/vue.CpkwC8Th.mjs';
+import './shared/vue.Mxc8w6Qk.mjs';
+import './shared/vue.CQh3AUE8.mjs';
+import './shared/vue.D_P5SqqD.mjs';

package/dist/useTrackedData.cjs

@@ -0,0 +1,10 @@
+'use strict';
+
+const useTrackedData = require('./shared/vue.DtCbCcPd.cjs');
+require('@vue-solana/core/kit');
+require('@vue-solana/core/errors');
+require('vue');
+
+
+
+exports.useTrackedData = useTrackedData.useTrackedData;

package/dist/useTrackedData.d.cts

@@ -0,0 +1,86 @@
+import { ReactiveActionSource, SolanaRpcResponse, ReactiveStreamSource, ReactiveStreamStore } from '@vue-solana/core/kit';
+import { SolanaError } from '@vue-solana/core/errors';
+import { ComputedRef, Ref } from 'vue';
+
+type UseTrackedDataStatus = "loading" | "loaded" | "error" | "disabled";
+type SendFn<TValue> = (options?: {
+    abortSignal?: AbortSignal;
+}) => Promise<TValue>;
+/**
+ * One-shot initial-value source (satisfied by `PendingRpcRequest`).
+ */
+type UseTrackedDataInitialSource<TInitialValue> = ReactiveActionSource<SolanaRpcResponse<TInitialValue>> | {
+    send: SendFn<SolanaRpcResponse<TInitialValue>>;
+};
+/**
+ * Ongoing stream source (satisfied by `PendingRpcSubscriptionsRequest`).
+ */
+type UseTrackedDataStreamSource<TStreamValue> = ReactiveStreamSource<SolanaRpcResponse<TStreamValue>> | {
+    reactiveStore: () => ReactiveStreamStore<SolanaRpcResponse<TStreamValue>>;
+};
+/**
+ * A `useTrackedData` source bundle. Every field accepts a plain source or a
+ * `ref`/`computed` of it; a `null`/`undefined` `rpcRequest` or
+ * `rpcSubscriptionRequest` disables the composable.
+ */
+interface UseTrackedDataSource<TInitialValue, TStreamValue, TItem> {
+    /**
+     * One-shot RPC request for the initial value, for example
+     * `rpc.getBalance(address)`.
+     */
+    rpcRequest: UseTrackedDataInitialSource<TInitialValue> | Ref<UseTrackedDataInitialSource<TInitialValue> | null | undefined>;
+    /**
+     * RPC subscription request for live updates, for example
+     * `rpcSubscriptions.accountNotifications(address)`.
+     */
+    rpcSubscriptionRequest: UseTrackedDataStreamSource<TStreamValue> | Ref<UseTrackedDataStreamSource<TStreamValue> | null | undefined>;
+    /**
+     * Maps the initial fetch's response value to the stored item type.
+     */
+    rpcValueMapper: (value: TInitialValue) => TItem;
+    /**
+     * Maps a stream notification's value to the stored item type.
+     */
+    rpcSubscriptionValueMapper: (value: TStreamValue) => TItem;
+}
+interface UseTrackedDataOptions {
+    /**
+     * Returns a caller-provided `AbortSignal` per connection (for example
+     * `AbortSignal.timeout(60_000)`), composed with the per-connection signal
+     * by the underlying store. Aborting it fails the connection with the abort
+     * reason without touching other state.
+     */
+    getAbortSignal?: (connection: number) => AbortSignal | null | undefined;
+    /**
+     * Called when the tracked data transitions into `error`.
+     */
+    onError?: (error: unknown) => void;
+}
+interface UseTrackedDataReturn<TItem> {
+    /**
+     * The latest item, surface-mapped by `rpcValueMapper` /
+     * `rpcSubscriptionValueMapper`. The {@link SolanaRpcResponse} envelope is
+     * preserved so callers can read `data.value?.context.slot`.
+     */
+    data: ComputedRef<SolanaRpcResponse<TItem> | undefined>;
+    error: ComputedRef<SolanaError | null>;
+    refresh: () => void;
+    status: ComputedRef<UseTrackedDataStatus>;
+}
+/**
+ * Live RPC data seeded by a one-shot fetch, slot-deduplicated between the two
+ * sources so notifications and the initial response can arrive in any order
+ * without out-of-order regressions.
+ *
+ * - `refresh()` aborts the current connection and re-runs both the fetch and
+ *   the subscription with stale-while-revalidate (last known `data` stays
+ *   visible while loading).
+ * - A `null`/`undefined` source (or `ref` of one) disables the composable and
+ *   clears state.
+ * - `getAbortSignal` attaches per-connection cancellation (timeouts, kill
+ *   switches) on top of the internal per-connection signal.
+ */
+declare function useTrackedData<TInitialValue, TStreamValue, TItem>(source: UseTrackedDataSource<TInitialValue, TStreamValue, TItem>, options?: UseTrackedDataOptions): UseTrackedDataReturn<TItem>;
+
+export { useTrackedData };
+export type { UseTrackedDataInitialSource, UseTrackedDataOptions, UseTrackedDataReturn, UseTrackedDataSource, UseTrackedDataStatus, UseTrackedDataStreamSource };