@vue-solana/vue 2.0.0 → 2.1.0

package/dist/useClientCapability.d.mts

@@ -0,0 +1,39 @@
+/**
+ * Thrown by {@link useClientCapability} when the installed Solana client does
+ * not expose a requested capability.
+ */
+declare class MissingClientCapabilityError extends Error {
+    /** Name of the hook that requested the capability, e.g. `usePayer`. */
+    readonly hookName: string;
+    /** Human guidance for installing the capability on the client. */
+    readonly providerHint: string;
+    /** The missing capability name(s). */
+    readonly capabilities: readonly string[];
+    constructor(hookName: string, capabilities: readonly string[], providerHint: string);
+}
+interface UseClientCapabilityOptions {
+    /**
+     * Name of the calling hook for error messages (defaults to
+     * `useClientCapability`).
+     */
+    hookName?: string;
+    /**
+     * Guidance appended to the error when a capability is missing, e.g. which
+     * `@solana/kit` plugin to `.use()`.
+     */
+    providerHint?: string;
+}
+/**
+ * Runtime assertion that a capability is installed on the (loosely-typed)
+ * Solana client. Throws a {@link MissingClientCapabilityError} — naming the
+ * calling hook and how to install the capability — if any requested
+ * capability is missing. Accepts one capability name or an array.
+ *
+ * The assertion runs synchronously during setup (the first step of mount),
+ * so a misconfigured client fails fast with a clear error instead of a
+ * cryptic `undefined is not a function` later on.
+ */
+declare function useClientCapability(capability: string | readonly string[], options?: UseClientCapabilityOptions): void;
+
+export { MissingClientCapabilityError, useClientCapability };
+export type { UseClientCapabilityOptions };

package/dist/useClientCapability.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Thrown by {@link useClientCapability} when the installed Solana client does
+ * not expose a requested capability.
+ */
+declare class MissingClientCapabilityError extends Error {
+    /** Name of the hook that requested the capability, e.g. `usePayer`. */
+    readonly hookName: string;
+    /** Human guidance for installing the capability on the client. */
+    readonly providerHint: string;
+    /** The missing capability name(s). */
+    readonly capabilities: readonly string[];
+    constructor(hookName: string, capabilities: readonly string[], providerHint: string);
+}
+interface UseClientCapabilityOptions {
+    /**
+     * Name of the calling hook for error messages (defaults to
+     * `useClientCapability`).
+     */
+    hookName?: string;
+    /**
+     * Guidance appended to the error when a capability is missing, e.g. which
+     * `@solana/kit` plugin to `.use()`.
+     */
+    providerHint?: string;
+}
+/**
+ * Runtime assertion that a capability is installed on the (loosely-typed)
+ * Solana client. Throws a {@link MissingClientCapabilityError} — naming the
+ * calling hook and how to install the capability — if any requested
+ * capability is missing. Accepts one capability name or an array.
+ *
+ * The assertion runs synchronously during setup (the first step of mount),
+ * so a misconfigured client fails fast with a clear error instead of a
+ * cryptic `undefined is not a function` later on.
+ */
+declare function useClientCapability(capability: string | readonly string[], options?: UseClientCapabilityOptions): void;
+
+export { MissingClientCapabilityError, useClientCapability };
+export type { UseClientCapabilityOptions };

package/dist/useClientCapability.mjs

@@ -0,0 +1,5 @@
+export { M as MissingClientCapabilityError, u as useClientCapability } from './shared/vue.B8LptjZP.mjs';
+import './shared/vue.Mxc8w6Qk.mjs';
+import './shared/vue.CQh3AUE8.mjs';
+import 'vue';
+import './shared/vue.D_P5SqqD.mjs';

package/dist/useConnection.cjs

@@ -1,9 +1,10 @@
 'use strict';
 
-const useConnection = require('./shared/vue.CZwftA0L.cjs');
-require('./shared/vue.k9Q6aN-0.cjs');
-require('./shared/vue.BaR1VPhl.cjs');
+const useConnection = require('./shared/vue.BVaMoz9y.cjs');
+require('./shared/vue.BIxphCAq.cjs');
+require('./shared/vue.DE3emjSF.cjs');
 require('vue');
+require('./shared/vue.DEHxNvUX.cjs');
 
 
 

package/dist/useConnection.mjs

@@ -1,4 +1,5 @@
-export { u as useConnection } from './shared/vue.ChujsB0B.mjs';
-import './shared/vue.BaFrF2PF.mjs';
-import './shared/vue.CnUlZSe8.mjs';
+export { u as useConnection } from './shared/vue.CpkwC8Th.mjs';
+import './shared/vue.Mxc8w6Qk.mjs';
+import './shared/vue.CQh3AUE8.mjs';
 import 'vue';
+import './shared/vue.D_P5SqqD.mjs';

package/dist/useIdentity.cjs

@@ -0,0 +1,12 @@
+'use strict';
+
+const usePayer = require('./shared/vue.g8fnm_ca.cjs');
+require('vue');
+require('./shared/vue.BY0qpgYr.cjs');
+require('./shared/vue.BIxphCAq.cjs');
+require('./shared/vue.DE3emjSF.cjs');
+require('./shared/vue.DEHxNvUX.cjs');
+
+
+
+exports.useIdentity = usePayer.useIdentity;

package/dist/useIdentity.d.cts

@@ -0,0 +1,3 @@
+export { useIdentity } from './usePayer.cjs';
+import '@vue-solana/core/kit';
+import 'vue';

package/dist/useIdentity.d.mts

@@ -0,0 +1,3 @@
+export { useIdentity } from './usePayer.mjs';
+import '@vue-solana/core/kit';
+import 'vue';

package/dist/useIdentity.d.ts

@@ -0,0 +1,3 @@
+export { useIdentity } from './usePayer.js';
+import '@vue-solana/core/kit';
+import 'vue';

package/dist/useIdentity.mjs

@@ -0,0 +1,6 @@
+export { u as useIdentity } from './shared/vue.CATOh_9G.mjs';
+import 'vue';
+import './shared/vue.B8LptjZP.mjs';
+import './shared/vue.Mxc8w6Qk.mjs';
+import './shared/vue.CQh3AUE8.mjs';
+import './shared/vue.D_P5SqqD.mjs';

package/dist/usePayer.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+const usePayer = require('./shared/vue.g8fnm_ca.cjs');
+require('vue');
+require('./shared/vue.BY0qpgYr.cjs');
+require('./shared/vue.BIxphCAq.cjs');
+require('./shared/vue.DE3emjSF.cjs');
+require('./shared/vue.DEHxNvUX.cjs');
+
+
+
+exports.useIdentity = usePayer.useIdentity;
+exports.usePayer = usePayer.usePayer;

package/dist/usePayer.d.cts

@@ -0,0 +1,18 @@
+import { TransactionSigner } from '@vue-solana/core/kit';
+import { Ref } from 'vue';
+
+/**
+ * The acting identity signer — the wallet whose assets the application is
+ * acting upon. Requires the client to expose `identity` (e.g. via a Kit
+ * signer plugin). Re-reads on change when the client advertises
+ * `subscribeToIdentity`.
+ */
+declare function useIdentity(): Ref<TransactionSigner>;
+/**
+ * The signer that pays transaction fees and storage costs. Requires the
+ * client to expose `payer` (e.g. via a Kit signer plugin). Re-reads on change
+ * when the client advertises `subscribeToPayer`.
+ */
+declare function usePayer(): Ref<TransactionSigner>;
+
+export { useIdentity, usePayer };

package/dist/usePayer.d.mts

@@ -0,0 +1,18 @@
+import { TransactionSigner } from '@vue-solana/core/kit';
+import { Ref } from 'vue';
+
+/**
+ * The acting identity signer — the wallet whose assets the application is
+ * acting upon. Requires the client to expose `identity` (e.g. via a Kit
+ * signer plugin). Re-reads on change when the client advertises
+ * `subscribeToIdentity`.
+ */
+declare function useIdentity(): Ref<TransactionSigner>;
+/**
+ * The signer that pays transaction fees and storage costs. Requires the
+ * client to expose `payer` (e.g. via a Kit signer plugin). Re-reads on change
+ * when the client advertises `subscribeToPayer`.
+ */
+declare function usePayer(): Ref<TransactionSigner>;
+
+export { useIdentity, usePayer };

package/dist/usePayer.d.ts

@@ -0,0 +1,18 @@
+import { TransactionSigner } from '@vue-solana/core/kit';
+import { Ref } from 'vue';
+
+/**
+ * The acting identity signer — the wallet whose assets the application is
+ * acting upon. Requires the client to expose `identity` (e.g. via a Kit
+ * signer plugin). Re-reads on change when the client advertises
+ * `subscribeToIdentity`.
+ */
+declare function useIdentity(): Ref<TransactionSigner>;
+/**
+ * The signer that pays transaction fees and storage costs. Requires the
+ * client to expose `payer` (e.g. via a Kit signer plugin). Re-reads on change
+ * when the client advertises `subscribeToPayer`.
+ */
+declare function usePayer(): Ref<TransactionSigner>;
+
+export { useIdentity, usePayer };

package/dist/usePayer.mjs

@@ -0,0 +1,6 @@
+export { u as useIdentity, a as usePayer } from './shared/vue.CATOh_9G.mjs';
+import 'vue';
+import './shared/vue.B8LptjZP.mjs';
+import './shared/vue.Mxc8w6Qk.mjs';
+import './shared/vue.CQh3AUE8.mjs';
+import './shared/vue.D_P5SqqD.mjs';

package/dist/usePlanTransaction.cjs

@@ -0,0 +1,14 @@
+'use strict';
+
+const usePlanTransaction = require('./shared/vue.B4-LEdSE.cjs');
+require('@vue-solana/core/errors');
+require('vue');
+require('./shared/vue.BY0qpgYr.cjs');
+require('./shared/vue.BIxphCAq.cjs');
+require('./shared/vue.DE3emjSF.cjs');
+require('./shared/vue.DEHxNvUX.cjs');
+
+
+
+exports.usePlanTransaction = usePlanTransaction.usePlanTransaction;
+exports.usePlanTransactions = usePlanTransaction.usePlanTransactions;

package/dist/usePlanTransaction.d.cts

@@ -0,0 +1,37 @@
+import * as vue from 'vue';
+import { TransactionMessage, InstructionPlanInput, TransactionPlan } from '@vue-solana/core/kit';
+import { SolanaError } from '@vue-solana/core/errors';
+
+type PlanTransactionStatus = "idle" | "planning" | "planned" | "error";
+interface PlanTransactionConfig {
+    abortSignal?: AbortSignal;
+}
+/**
+ * Plan a single transaction message from instruction inputs — without
+ * signing or sending — using the client's transaction planning capability
+ * (e.g. `rpcTransactionPlanner` from `@solana/kit-plugin-rpc`).
+ *
+ * Rejects with a clear capability error when the client does not plan.
+ */
+declare function usePlanTransaction(): {
+    transactionMessage: vue.ShallowRef<TransactionMessage | null, TransactionMessage | null>;
+    status: vue.Ref<PlanTransactionStatus, PlanTransactionStatus>;
+    loading: vue.Ref<boolean, boolean>;
+    error: vue.Ref<SolanaError | null, SolanaError | null>;
+    execute: (input: InstructionPlanInput, config?: PlanTransactionConfig) => Promise<TransactionMessage>;
+};
+/**
+ * Plan a full transaction plan — possibly multiple transaction messages —
+ * from instruction inputs, using the client's transaction planning
+ * capability.
+ */
+declare function usePlanTransactions(): {
+    transactionPlan: vue.ShallowRef<TransactionPlan | null, TransactionPlan | null>;
+    status: vue.Ref<PlanTransactionStatus, PlanTransactionStatus>;
+    loading: vue.Ref<boolean, boolean>;
+    error: vue.Ref<SolanaError | null, SolanaError | null>;
+    execute: (input: InstructionPlanInput, config?: PlanTransactionConfig) => Promise<TransactionPlan>;
+};
+
+export { usePlanTransaction, usePlanTransactions };
+export type { PlanTransactionConfig, PlanTransactionStatus };

package/dist/usePlanTransaction.d.mts

@@ -0,0 +1,37 @@
+import * as vue from 'vue';
+import { TransactionMessage, InstructionPlanInput, TransactionPlan } from '@vue-solana/core/kit';
+import { SolanaError } from '@vue-solana/core/errors';
+
+type PlanTransactionStatus = "idle" | "planning" | "planned" | "error";
+interface PlanTransactionConfig {
+    abortSignal?: AbortSignal;
+}
+/**
+ * Plan a single transaction message from instruction inputs — without
+ * signing or sending — using the client's transaction planning capability
+ * (e.g. `rpcTransactionPlanner` from `@solana/kit-plugin-rpc`).
+ *
+ * Rejects with a clear capability error when the client does not plan.
+ */
+declare function usePlanTransaction(): {
+    transactionMessage: vue.ShallowRef<TransactionMessage | null, TransactionMessage | null>;
+    status: vue.Ref<PlanTransactionStatus, PlanTransactionStatus>;
+    loading: vue.Ref<boolean, boolean>;
+    error: vue.Ref<SolanaError | null, SolanaError | null>;
+    execute: (input: InstructionPlanInput, config?: PlanTransactionConfig) => Promise<TransactionMessage>;
+};
+/**
+ * Plan a full transaction plan — possibly multiple transaction messages —
+ * from instruction inputs, using the client's transaction planning
+ * capability.
+ */
+declare function usePlanTransactions(): {
+    transactionPlan: vue.ShallowRef<TransactionPlan | null, TransactionPlan | null>;
+    status: vue.Ref<PlanTransactionStatus, PlanTransactionStatus>;
+    loading: vue.Ref<boolean, boolean>;
+    error: vue.Ref<SolanaError | null, SolanaError | null>;
+    execute: (input: InstructionPlanInput, config?: PlanTransactionConfig) => Promise<TransactionPlan>;
+};
+
+export { usePlanTransaction, usePlanTransactions };
+export type { PlanTransactionConfig, PlanTransactionStatus };

package/dist/usePlanTransaction.d.ts

@@ -0,0 +1,37 @@
+import * as vue from 'vue';
+import { TransactionMessage, InstructionPlanInput, TransactionPlan } from '@vue-solana/core/kit';
+import { SolanaError } from '@vue-solana/core/errors';
+
+type PlanTransactionStatus = "idle" | "planning" | "planned" | "error";
+interface PlanTransactionConfig {
+    abortSignal?: AbortSignal;
+}
+/**
+ * Plan a single transaction message from instruction inputs — without
+ * signing or sending — using the client's transaction planning capability
+ * (e.g. `rpcTransactionPlanner` from `@solana/kit-plugin-rpc`).
+ *
+ * Rejects with a clear capability error when the client does not plan.
+ */
+declare function usePlanTransaction(): {
+    transactionMessage: vue.ShallowRef<TransactionMessage | null, TransactionMessage | null>;
+    status: vue.Ref<PlanTransactionStatus, PlanTransactionStatus>;
+    loading: vue.Ref<boolean, boolean>;
+    error: vue.Ref<SolanaError | null, SolanaError | null>;
+    execute: (input: InstructionPlanInput, config?: PlanTransactionConfig) => Promise<TransactionMessage>;
+};
+/**
+ * Plan a full transaction plan — possibly multiple transaction messages —
+ * from instruction inputs, using the client's transaction planning
+ * capability.
+ */
+declare function usePlanTransactions(): {
+    transactionPlan: vue.ShallowRef<TransactionPlan | null, TransactionPlan | null>;
+    status: vue.Ref<PlanTransactionStatus, PlanTransactionStatus>;
+    loading: vue.Ref<boolean, boolean>;
+    error: vue.Ref<SolanaError | null, SolanaError | null>;
+    execute: (input: InstructionPlanInput, config?: PlanTransactionConfig) => Promise<TransactionPlan>;
+};
+
+export { usePlanTransaction, usePlanTransactions };
+export type { PlanTransactionConfig, PlanTransactionStatus };

package/dist/usePlanTransaction.mjs

@@ -0,0 +1,7 @@
+export { u as usePlanTransaction, a as usePlanTransactions } from './shared/vue.C5FVoEZT.mjs';
+import '@vue-solana/core/errors';
+import 'vue';
+import './shared/vue.B8LptjZP.mjs';
+import './shared/vue.Mxc8w6Qk.mjs';
+import './shared/vue.CQh3AUE8.mjs';
+import './shared/vue.D_P5SqqD.mjs';

package/dist/usePlanTransactions.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+const usePlanTransaction = require('./shared/vue.B4-LEdSE.cjs');
+require('@vue-solana/core/errors');
+require('vue');
+require('./shared/vue.BY0qpgYr.cjs');
+require('./shared/vue.BIxphCAq.cjs');
+require('./shared/vue.DE3emjSF.cjs');
+require('./shared/vue.DEHxNvUX.cjs');
+
+
+
+exports.usePlanTransactions = usePlanTransaction.usePlanTransactions;

package/dist/usePlanTransactions.d.cts

@@ -0,0 +1,4 @@
+export { usePlanTransactions } from './usePlanTransaction.cjs';
+import 'vue';
+import '@vue-solana/core/kit';
+import '@vue-solana/core/errors';

package/dist/usePlanTransactions.d.mts

@@ -0,0 +1,4 @@
+export { usePlanTransactions } from './usePlanTransaction.mjs';
+import 'vue';
+import '@vue-solana/core/kit';
+import '@vue-solana/core/errors';

package/dist/usePlanTransactions.d.ts

@@ -0,0 +1,4 @@
+export { usePlanTransactions } from './usePlanTransaction.js';
+import 'vue';
+import '@vue-solana/core/kit';
+import '@vue-solana/core/errors';

package/dist/usePlanTransactions.mjs

@@ -0,0 +1,7 @@
+export { a as usePlanTransactions } from './shared/vue.C5FVoEZT.mjs';
+import '@vue-solana/core/errors';
+import 'vue';
+import './shared/vue.B8LptjZP.mjs';
+import './shared/vue.Mxc8w6Qk.mjs';
+import './shared/vue.CQh3AUE8.mjs';
+import './shared/vue.D_P5SqqD.mjs';

package/dist/useProgramAccounts.cjs

@@ -1,12 +1,13 @@
 'use strict';
 
-const useProgramAccounts = require('./shared/vue.C7yR7Cs0.cjs');
+const useProgramAccounts = require('./shared/vue.Di7yjJ-R.cjs');
 require('@vue-solana/core/errors');
 require('vue');
 require('@vue-solana/core/address');
-require('./shared/vue.CZwftA0L.cjs');
-require('./shared/vue.k9Q6aN-0.cjs');
-require('./shared/vue.BaR1VPhl.cjs');
+require('./shared/vue.BVaMoz9y.cjs');
+require('./shared/vue.BIxphCAq.cjs');
+require('./shared/vue.DE3emjSF.cjs');
+require('./shared/vue.DEHxNvUX.cjs');
 require('./shared/vue.DNxOpDXz.cjs');
 
 

package/dist/useProgramAccounts.mjs

@@ -1,8 +1,9 @@
-export { u as useProgramAccounts } from './shared/vue.BbMPRDeO.mjs';
+export { u as useProgramAccounts } from './shared/vue.C13umiQi.mjs';
 import '@vue-solana/core/errors';
 import 'vue';
 import '@vue-solana/core/address';
-import './shared/vue.ChujsB0B.mjs';
-import './shared/vue.BaFrF2PF.mjs';
-import './shared/vue.CnUlZSe8.mjs';
+import './shared/vue.CpkwC8Th.mjs';
+import './shared/vue.Mxc8w6Qk.mjs';
+import './shared/vue.CQh3AUE8.mjs';
+import './shared/vue.D_P5SqqD.mjs';
 import './shared/vue.Bfu1dCKe.mjs';

package/dist/useRequest.cjs

@@ -0,0 +1,11 @@
+'use strict';
+
+const useRequest = require('./shared/vue.B8pLQ8P4.cjs');
+require('@vue-solana/core/action');
+require('@vue-solana/core/kit');
+require('@vue-solana/core/errors');
+require('vue');
+
+
+
+exports.useRequest = useRequest.useRequest;

package/dist/useRequest.d.cts

@@ -0,0 +1,57 @@
+import { SolanaError } from '@vue-solana/core/errors';
+import { ComputedRef, Ref } from 'vue';
+
+type UseRequestStatus = "fetching" | "success" | "error" | "disabled";
+type SendFn<TResult> = (options?: {
+    abortSignal?: AbortSignal;
+}) => Promise<TResult>;
+type ResolvedSource<TResult> = ((signal: AbortSignal) => Promise<TResult> | {
+    send: SendFn<TResult>;
+}) | {
+    send: SendFn<TResult>;
+} | null | undefined;
+/**
+ * A request source accepted by `useRequest`:
+ *
+ * - a request function `(signal) => Promise<T>`, called with a fresh composed
+ *   `AbortSignal` per attempt (it may return a Kit request object, which is
+ *   sent with the signal automatically),
+ * - a Kit reactive store source such as `PendingRpcRequest` (for example
+ *   `rpc.getBalance(address)`),
+ * - a `ref`/`computed` of any of the above, or of `null` to disable, or
+ * - `null` to disable outright.
+ */
+type UseRequestSource<TResult> = ResolvedSource<TResult> | Ref<ResolvedSource<TResult>>;
+interface UseRequestOptions {
+    /**
+     * Returns a caller-provided `AbortSignal` per attempt (for example
+     * `AbortSignal.timeout(5_000)`), composed with the internal per-attempt
+     * signal. Aborting it fails the attempt without touching other state.
+     */
+    getAbortSignal?: (attempt: number) => AbortSignal | null | undefined;
+}
+interface UseRequestReturn<TResult> {
+    data: ComputedRef<TResult | undefined>;
+    error: ComputedRef<SolanaError | null>;
+    refresh: () => Promise<TResult | undefined>;
+    status: ComputedRef<UseRequestStatus>;
+}
+/**
+ * One-shot async request that re-fires when its source changes identity, with
+ * stale-while-revalidate: while a new attempt runs, the previous `data` and
+ * `error` stay populated so the UI keeps rendering.
+ *
+ * Status set: `fetching` | `success` | `error` | `disabled`.
+ *
+ * - The first attempt fires on mount inside a component (or immediately when
+ *   called outside one).
+ * - Passing a ref/computed source re-fires whenever the source identity
+ *   changes; a `null` source clears state and reports `disabled`.
+ * - `refresh()` re-fires manually and resolves with the attempt result.
+ * - `getAbortSignal` attaches per-attempt cancellation (timeouts, kill
+ *   switches) on top of the internal per-attempt signal.
+ */
+declare function useRequest<TResult>(source: UseRequestSource<TResult>, options?: UseRequestOptions): UseRequestReturn<TResult>;
+
+export { useRequest };
+export type { UseRequestOptions, UseRequestReturn, UseRequestSource, UseRequestStatus };

package/dist/useRequest.d.mts

@@ -0,0 +1,57 @@
+import { SolanaError } from '@vue-solana/core/errors';
+import { ComputedRef, Ref } from 'vue';
+
+type UseRequestStatus = "fetching" | "success" | "error" | "disabled";
+type SendFn<TResult> = (options?: {
+    abortSignal?: AbortSignal;
+}) => Promise<TResult>;
+type ResolvedSource<TResult> = ((signal: AbortSignal) => Promise<TResult> | {
+    send: SendFn<TResult>;
+}) | {
+    send: SendFn<TResult>;
+} | null | undefined;
+/**
+ * A request source accepted by `useRequest`:
+ *
+ * - a request function `(signal) => Promise<T>`, called with a fresh composed
+ *   `AbortSignal` per attempt (it may return a Kit request object, which is
+ *   sent with the signal automatically),
+ * - a Kit reactive store source such as `PendingRpcRequest` (for example
+ *   `rpc.getBalance(address)`),
+ * - a `ref`/`computed` of any of the above, or of `null` to disable, or
+ * - `null` to disable outright.
+ */
+type UseRequestSource<TResult> = ResolvedSource<TResult> | Ref<ResolvedSource<TResult>>;
+interface UseRequestOptions {
+    /**
+     * Returns a caller-provided `AbortSignal` per attempt (for example
+     * `AbortSignal.timeout(5_000)`), composed with the internal per-attempt
+     * signal. Aborting it fails the attempt without touching other state.
+     */
+    getAbortSignal?: (attempt: number) => AbortSignal | null | undefined;
+}
+interface UseRequestReturn<TResult> {
+    data: ComputedRef<TResult | undefined>;
+    error: ComputedRef<SolanaError | null>;
+    refresh: () => Promise<TResult | undefined>;
+    status: ComputedRef<UseRequestStatus>;
+}
+/**
+ * One-shot async request that re-fires when its source changes identity, with
+ * stale-while-revalidate: while a new attempt runs, the previous `data` and
+ * `error` stay populated so the UI keeps rendering.
+ *
+ * Status set: `fetching` | `success` | `error` | `disabled`.
+ *
+ * - The first attempt fires on mount inside a component (or immediately when
+ *   called outside one).
+ * - Passing a ref/computed source re-fires whenever the source identity
+ *   changes; a `null` source clears state and reports `disabled`.
+ * - `refresh()` re-fires manually and resolves with the attempt result.
+ * - `getAbortSignal` attaches per-attempt cancellation (timeouts, kill
+ *   switches) on top of the internal per-attempt signal.
+ */
+declare function useRequest<TResult>(source: UseRequestSource<TResult>, options?: UseRequestOptions): UseRequestReturn<TResult>;
+
+export { useRequest };
+export type { UseRequestOptions, UseRequestReturn, UseRequestSource, UseRequestStatus };

package/dist/useRequest.d.ts

@@ -0,0 +1,57 @@
+import { SolanaError } from '@vue-solana/core/errors';
+import { ComputedRef, Ref } from 'vue';
+
+type UseRequestStatus = "fetching" | "success" | "error" | "disabled";
+type SendFn<TResult> = (options?: {
+    abortSignal?: AbortSignal;
+}) => Promise<TResult>;
+type ResolvedSource<TResult> = ((signal: AbortSignal) => Promise<TResult> | {
+    send: SendFn<TResult>;
+}) | {
+    send: SendFn<TResult>;
+} | null | undefined;
+/**
+ * A request source accepted by `useRequest`:
+ *
+ * - a request function `(signal) => Promise<T>`, called with a fresh composed
+ *   `AbortSignal` per attempt (it may return a Kit request object, which is
+ *   sent with the signal automatically),
+ * - a Kit reactive store source such as `PendingRpcRequest` (for example
+ *   `rpc.getBalance(address)`),
+ * - a `ref`/`computed` of any of the above, or of `null` to disable, or
+ * - `null` to disable outright.
+ */
+type UseRequestSource<TResult> = ResolvedSource<TResult> | Ref<ResolvedSource<TResult>>;
+interface UseRequestOptions {
+    /**
+     * Returns a caller-provided `AbortSignal` per attempt (for example
+     * `AbortSignal.timeout(5_000)`), composed with the internal per-attempt
+     * signal. Aborting it fails the attempt without touching other state.
+     */
+    getAbortSignal?: (attempt: number) => AbortSignal | null | undefined;
+}
+interface UseRequestReturn<TResult> {
+    data: ComputedRef<TResult | undefined>;
+    error: ComputedRef<SolanaError | null>;
+    refresh: () => Promise<TResult | undefined>;
+    status: ComputedRef<UseRequestStatus>;
+}
+/**
+ * One-shot async request that re-fires when its source changes identity, with
+ * stale-while-revalidate: while a new attempt runs, the previous `data` and
+ * `error` stay populated so the UI keeps rendering.
+ *
+ * Status set: `fetching` | `success` | `error` | `disabled`.
+ *
+ * - The first attempt fires on mount inside a component (or immediately when
+ *   called outside one).
+ * - Passing a ref/computed source re-fires whenever the source identity
+ *   changes; a `null` source clears state and reports `disabled`.
+ * - `refresh()` re-fires manually and resolves with the attempt result.
+ * - `getAbortSignal` attaches per-attempt cancellation (timeouts, kill
+ *   switches) on top of the internal per-attempt signal.
+ */
+declare function useRequest<TResult>(source: UseRequestSource<TResult>, options?: UseRequestOptions): UseRequestReturn<TResult>;
+
+export { useRequest };
+export type { UseRequestOptions, UseRequestReturn, UseRequestSource, UseRequestStatus };

package/dist/useRequest.mjs

@@ -0,0 +1,5 @@
+export { u as useRequest } from './shared/vue.DImwKTwJ.mjs';
+import '@vue-solana/core/action';
+import '@vue-solana/core/kit';
+import '@vue-solana/core/errors';
+import 'vue';

package/dist/useRpc.cjs

@@ -1,8 +1,9 @@
 'use strict';
 
-const useRpc = require('./shared/vue.__r7YYZE.cjs');
+const useRpc = require('./shared/vue.FiMmnMHr.cjs');
 require('vue');
-require('./shared/vue.BaR1VPhl.cjs');
+require('./shared/vue.DE3emjSF.cjs');
+require('./shared/vue.DEHxNvUX.cjs');