@vue-solana/vue 1.2.0 → 2.1.0

package/dist/swr.mjs

@@ -0,0 +1,131 @@
+import { watch, computed } from 'vue';
+import { u as useRequest } from './shared/vue.DImwKTwJ.mjs';
+import { u as useSubscription } from './shared/vue.B8ub540p.mjs';
+import { u as useTrackedData } from './shared/vue.CogzzQXM.mjs';
+import '@vue-solana/core/action';
+import '@vue-solana/core/kit';
+import '@vue-solana/core/errors';
+
+const PREFIX_REQUEST = "request:";
+const PREFIX_SUBSCRIPTION = "subscription:";
+const PREFIX_TRACKED = "tracked:";
+const swrCache = /* @__PURE__ */ new Map();
+function clearSwrCache() {
+  swrCache.clear();
+}
+function readSwrCache(key) {
+  return swrCache.get(key);
+}
+function writeSwrCache(key, entry) {
+  swrCache.set(key, entry);
+}
+function deleteSwrCache(key) {
+  swrCache.delete(key);
+}
+function isPendingStatus(status) {
+  return status === "fetching" || status === "loading";
+}
+function writeSwrResult(key, data, error, status) {
+  if (status === "disabled") {
+    deleteSwrCache(key);
+    return;
+  }
+  const previous = readSwrCache(key);
+  writeSwrCache(key, {
+    data: data !== void 0 ? data : previous?.data,
+    error,
+    status
+  });
+}
+function swrError(error, status, seed) {
+  if (status === "disabled") {
+    return null;
+  }
+  return error ?? (isPendingStatus(status) ? seed?.error ?? null : null);
+}
+function useRequestSwr(key, source, options = {}) {
+  const cacheKey = `${PREFIX_REQUEST}${key}`;
+  const seed = readSwrCache(cacheKey);
+  const result = useRequest(source, options);
+  if (result.status.value === "disabled") {
+    deleteSwrCache(cacheKey);
+  }
+  watch(
+    [result.data, result.error, result.status],
+    ([data2, error2, status]) => writeSwrResult(cacheKey, data2, error2, status),
+    { flush: "sync" }
+  );
+  const data = computed(() => {
+    if (result.status.value === "disabled") {
+      return void 0;
+    }
+    return result.data.value !== void 0 ? result.data.value : seed?.data;
+  });
+  const error = computed(
+    () => swrError(result.error.value, result.status.value, seed)
+  );
+  return {
+    data,
+    error,
+    refresh: result.refresh,
+    status: result.status
+  };
+}
+function useSubscriptionSwr(key, source, options = {}) {
+  const cacheKey = `${PREFIX_SUBSCRIPTION}${key}`;
+  const seed = readSwrCache(cacheKey);
+  const result = useSubscription(source, options);
+  if (result.status.value === "disabled") {
+    deleteSwrCache(cacheKey);
+  }
+  watch(
+    [result.data, result.error, result.status],
+    ([data2, error2, status]) => writeSwrResult(cacheKey, data2, error2, status),
+    { flush: "sync" }
+  );
+  const data = computed(() => {
+    if (result.status.value === "disabled") {
+      return void 0;
+    }
+    return result.data.value !== void 0 ? result.data.value : seed?.data;
+  });
+  const error = computed(
+    () => swrError(result.error.value, result.status.value, seed)
+  );
+  return {
+    data,
+    error,
+    reconnect: result.reconnect,
+    status: result.status
+  };
+}
+function useTrackedDataSwr(key, source, options = {}) {
+  const cacheKey = `${PREFIX_TRACKED}${key}`;
+  const seed = readSwrCache(cacheKey);
+  const result = useTrackedData(source, options);
+  if (result.status.value === "disabled") {
+    deleteSwrCache(cacheKey);
+  }
+  watch(
+    [result.data, result.error, result.status],
+    ([data2, error2, status]) => writeSwrResult(cacheKey, data2, error2, status),
+    { flush: "sync" }
+  );
+  const data = computed(() => {
+    if (result.status.value === "disabled") {
+      return void 0;
+    }
+    return result.data.value ?? seed?.data;
+  });
+  const error = computed(
+    () => swrError(result.error.value, result.status.value, seed)
+  );
+  return {
+    data,
+    error,
+    refresh: result.refresh,
+    status: result.status
+  };
+}
+
+export { clearSwrCache, useRequestSwr, useSubscriptionSwr, useTrackedDataSwr };

package/dist/useAccountInfo.cjs

@@ -1,12 +1,14 @@
 'use strict';
 
-const useAccountInfo = require('./shared/vue._CAClzAz.cjs');
-require('@vue-solana/core/address');
+const useAccountInfo = require('./shared/vue.D-qi8PSL.cjs');
 require('@vue-solana/core/errors');
 require('vue');
-require('./shared/vue.DCgByzxg.cjs');
-require('./shared/vue.LNhX07HB.cjs');
-require('./shared/vue.BE4KHksm.cjs');
+require('@vue-solana/core/address');
+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/useAccountInfo.d.cts

@@ -1,20 +1,24 @@
 import * as vue from 'vue';
 import { MaybeRefOrGetter } from 'vue';
-import { PublicKeyInput } from '@vue-solana/core/address';
+import { Commitment } from '@vue-solana/core/kit';
 import { SolanaError } from '@vue-solana/core/errors';
-import { Commitment, AccountInfo } from '@vue-solana/core/web3';
 
 interface UseAccountInfoOptions {
     commitment?: Commitment;
-    watch?: boolean;
 }
-declare function useAccountInfo(address: MaybeRefOrGetter<PublicKeyInput>, options?: UseAccountInfoOptions): {
-    accountInfo: vue.ShallowRef<AccountInfo<Uint8Array<ArrayBufferLike>> | null, AccountInfo<Uint8Array<ArrayBufferLike>> | null>;
+interface AccountInfo {
+    executable: boolean;
+    lamports: number;
+    owner: string;
+    space: number;
+    data: Uint8Array;
+}
+declare function useAccountInfo(address: MaybeRefOrGetter<string | null | undefined>, options?: UseAccountInfoOptions): {
+    accountInfo: vue.ShallowRef<AccountInfo | null, AccountInfo | null>;
     loading: vue.ShallowRef<boolean, boolean>;
     error: vue.ShallowRef<SolanaError | null, SolanaError | null>;
-    refresh: () => Promise<AccountInfo<Uint8Array<ArrayBufferLike>> | null>;
-    stopWatching: () => Promise<void>;
+    refresh: () => Promise<AccountInfo | null>;
 };
 
 export { useAccountInfo };
-export type { UseAccountInfoOptions };
+export type { AccountInfo, UseAccountInfoOptions };

package/dist/useAccountInfo.d.mts

@@ -1,20 +1,24 @@
 import * as vue from 'vue';
 import { MaybeRefOrGetter } from 'vue';
-import { PublicKeyInput } from '@vue-solana/core/address';
+import { Commitment } from '@vue-solana/core/kit';
 import { SolanaError } from '@vue-solana/core/errors';
-import { Commitment, AccountInfo } from '@vue-solana/core/web3';
 
 interface UseAccountInfoOptions {
     commitment?: Commitment;
-    watch?: boolean;
 }
-declare function useAccountInfo(address: MaybeRefOrGetter<PublicKeyInput>, options?: UseAccountInfoOptions): {
-    accountInfo: vue.ShallowRef<AccountInfo<Uint8Array<ArrayBufferLike>> | null, AccountInfo<Uint8Array<ArrayBufferLike>> | null>;
+interface AccountInfo {
+    executable: boolean;
+    lamports: number;
+    owner: string;
+    space: number;
+    data: Uint8Array;
+}
+declare function useAccountInfo(address: MaybeRefOrGetter<string | null | undefined>, options?: UseAccountInfoOptions): {
+    accountInfo: vue.ShallowRef<AccountInfo | null, AccountInfo | null>;
     loading: vue.ShallowRef<boolean, boolean>;
     error: vue.ShallowRef<SolanaError | null, SolanaError | null>;
-    refresh: () => Promise<AccountInfo<Uint8Array<ArrayBufferLike>> | null>;
-    stopWatching: () => Promise<void>;
+    refresh: () => Promise<AccountInfo | null>;
 };
 
 export { useAccountInfo };
-export type { UseAccountInfoOptions };
+export type { AccountInfo, UseAccountInfoOptions };

package/dist/useAccountInfo.d.ts

@@ -1,20 +1,24 @@
 import * as vue from 'vue';
 import { MaybeRefOrGetter } from 'vue';
-import { PublicKeyInput } from '@vue-solana/core/address';
+import { Commitment } from '@vue-solana/core/kit';
 import { SolanaError } from '@vue-solana/core/errors';
-import { Commitment, AccountInfo } from '@vue-solana/core/web3';
 
 interface UseAccountInfoOptions {
     commitment?: Commitment;
-    watch?: boolean;
 }
-declare function useAccountInfo(address: MaybeRefOrGetter<PublicKeyInput>, options?: UseAccountInfoOptions): {
-    accountInfo: vue.ShallowRef<AccountInfo<Uint8Array<ArrayBufferLike>> | null, AccountInfo<Uint8Array<ArrayBufferLike>> | null>;
+interface AccountInfo {
+    executable: boolean;
+    lamports: number;
+    owner: string;
+    space: number;
+    data: Uint8Array;
+}
+declare function useAccountInfo(address: MaybeRefOrGetter<string | null | undefined>, options?: UseAccountInfoOptions): {
+    accountInfo: vue.ShallowRef<AccountInfo | null, AccountInfo | null>;
     loading: vue.ShallowRef<boolean, boolean>;
     error: vue.ShallowRef<SolanaError | null, SolanaError | null>;
-    refresh: () => Promise<AccountInfo<Uint8Array<ArrayBufferLike>> | null>;
-    stopWatching: () => Promise<void>;
+    refresh: () => Promise<AccountInfo | null>;
 };
 
 export { useAccountInfo };
-export type { UseAccountInfoOptions };
+export type { AccountInfo, UseAccountInfoOptions };

package/dist/useAccountInfo.mjs

@@ -1,7 +1,9 @@
-export { u as useAccountInfo } from './shared/vue.CfrVAzEf.mjs';
-import '@vue-solana/core/address';
+export { u as useAccountInfo } from './shared/vue.BQRpjwKl.mjs';
 import '@vue-solana/core/errors';
 import 'vue';
-import './shared/vue.DiNn3XHm.mjs';
-import './shared/vue.BtUKvuQw.mjs';
-import './shared/vue.CYKT65tB.mjs';
+import '@vue-solana/core/address';
+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/useAction.cjs

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

package/dist/useAction.d.cts

@@ -0,0 +1,45 @@
+import { ComputedRef, Ref } from 'vue';
+
+type UseActionStatus = "idle" | "running" | "success" | "error";
+interface UseActionOptions {
+    /**
+     * Called after a dispatch settles successfully.
+     */
+    onSuccess?: (data: unknown) => void;
+    /**
+     * Called after a dispatch fails for a reason other than supersession.
+     */
+    onError?: (error: unknown) => void;
+}
+interface UseActionReturn<TArgs extends readonly unknown[], TResult> {
+    data: ComputedRef<TResult | undefined>;
+    dispatch: (...args: TArgs) => Promise<TResult>;
+    error: ComputedRef<unknown>;
+    isRunning: ComputedRef<boolean>;
+    reset: () => void;
+    status: ComputedRef<UseActionStatus>;
+}
+/**
+ * Generic async action state machine.
+ *
+ * Accepts any async function that receives a fresh `AbortSignal` per call and
+ * tracks `{ data, dispatch, error, isRunning, reset, status }` through Vue
+ * reactive state.
+ *
+ * - There is no dependencies array: pass the handler directly or as a ref;
+ *   `dispatch` always invokes the latest closure, so handlers reading
+ *   reactive state never see stale values. `dispatch` keeps a stable identity
+ *   across the component lifetime.
+ * - Calling `dispatch` again while a call is in flight aborts the previous
+ *   call. Superseded calls reject with an abort reason so callers can detect
+ *   them; they never corrupt state.
+ * - Failures surface on `error` while the previous `data` is preserved for
+ *   stale-while-revalidate rendering.
+ *
+ * The underlying state machine is `createSolanaActionStore` from
+ * `@vue-solana/core/action`, shared with non-Vue consumers.
+ */
+declare function useAction<TArgs extends readonly unknown[], TResult>(action: ((signal: AbortSignal, ...args: TArgs) => Promise<TResult>) | Ref<(signal: AbortSignal, ...args: TArgs) => Promise<TResult>>, options?: UseActionOptions): UseActionReturn<TArgs, TResult>;
+
+export { useAction };
+export type { UseActionOptions, UseActionReturn, UseActionStatus };

package/dist/useAction.d.mts

@@ -0,0 +1,45 @@
+import { ComputedRef, Ref } from 'vue';
+
+type UseActionStatus = "idle" | "running" | "success" | "error";
+interface UseActionOptions {
+    /**
+     * Called after a dispatch settles successfully.
+     */
+    onSuccess?: (data: unknown) => void;
+    /**
+     * Called after a dispatch fails for a reason other than supersession.
+     */
+    onError?: (error: unknown) => void;
+}
+interface UseActionReturn<TArgs extends readonly unknown[], TResult> {
+    data: ComputedRef<TResult | undefined>;
+    dispatch: (...args: TArgs) => Promise<TResult>;
+    error: ComputedRef<unknown>;
+    isRunning: ComputedRef<boolean>;
+    reset: () => void;
+    status: ComputedRef<UseActionStatus>;
+}
+/**
+ * Generic async action state machine.
+ *
+ * Accepts any async function that receives a fresh `AbortSignal` per call and
+ * tracks `{ data, dispatch, error, isRunning, reset, status }` through Vue
+ * reactive state.
+ *
+ * - There is no dependencies array: pass the handler directly or as a ref;
+ *   `dispatch` always invokes the latest closure, so handlers reading
+ *   reactive state never see stale values. `dispatch` keeps a stable identity
+ *   across the component lifetime.
+ * - Calling `dispatch` again while a call is in flight aborts the previous
+ *   call. Superseded calls reject with an abort reason so callers can detect
+ *   them; they never corrupt state.
+ * - Failures surface on `error` while the previous `data` is preserved for
+ *   stale-while-revalidate rendering.
+ *
+ * The underlying state machine is `createSolanaActionStore` from
+ * `@vue-solana/core/action`, shared with non-Vue consumers.
+ */
+declare function useAction<TArgs extends readonly unknown[], TResult>(action: ((signal: AbortSignal, ...args: TArgs) => Promise<TResult>) | Ref<(signal: AbortSignal, ...args: TArgs) => Promise<TResult>>, options?: UseActionOptions): UseActionReturn<TArgs, TResult>;
+
+export { useAction };
+export type { UseActionOptions, UseActionReturn, UseActionStatus };

package/dist/useAction.d.ts

@@ -0,0 +1,45 @@
+import { ComputedRef, Ref } from 'vue';
+
+type UseActionStatus = "idle" | "running" | "success" | "error";
+interface UseActionOptions {
+    /**
+     * Called after a dispatch settles successfully.
+     */
+    onSuccess?: (data: unknown) => void;
+    /**
+     * Called after a dispatch fails for a reason other than supersession.
+     */
+    onError?: (error: unknown) => void;
+}
+interface UseActionReturn<TArgs extends readonly unknown[], TResult> {
+    data: ComputedRef<TResult | undefined>;
+    dispatch: (...args: TArgs) => Promise<TResult>;
+    error: ComputedRef<unknown>;
+    isRunning: ComputedRef<boolean>;
+    reset: () => void;
+    status: ComputedRef<UseActionStatus>;
+}
+/**
+ * Generic async action state machine.
+ *
+ * Accepts any async function that receives a fresh `AbortSignal` per call and
+ * tracks `{ data, dispatch, error, isRunning, reset, status }` through Vue
+ * reactive state.
+ *
+ * - There is no dependencies array: pass the handler directly or as a ref;
+ *   `dispatch` always invokes the latest closure, so handlers reading
+ *   reactive state never see stale values. `dispatch` keeps a stable identity
+ *   across the component lifetime.
+ * - Calling `dispatch` again while a call is in flight aborts the previous
+ *   call. Superseded calls reject with an abort reason so callers can detect
+ *   them; they never corrupt state.
+ * - Failures surface on `error` while the previous `data` is preserved for
+ *   stale-while-revalidate rendering.
+ *
+ * The underlying state machine is `createSolanaActionStore` from
+ * `@vue-solana/core/action`, shared with non-Vue consumers.
+ */
+declare function useAction<TArgs extends readonly unknown[], TResult>(action: ((signal: AbortSignal, ...args: TArgs) => Promise<TResult>) | Ref<(signal: AbortSignal, ...args: TArgs) => Promise<TResult>>, options?: UseActionOptions): UseActionReturn<TArgs, TResult>;
+
+export { useAction };
+export type { UseActionOptions, UseActionReturn, UseActionStatus };

package/dist/useAction.mjs

@@ -0,0 +1,3 @@
+export { u as useAction } from './shared/vue.DYk0Xfr3.mjs';
+import '@vue-solana/core/action';
+import 'vue';

package/dist/useBalance.cjs

@@ -1,12 +1,13 @@
 'use strict';
 
-const useBalance = require('./shared/vue.BsD6AAmO.cjs');
+const useBalance = require('./shared/vue.E_npPFoV.cjs');
 require('@vue-solana/core/address');
 require('@vue-solana/core/errors');
 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/useBalance.d.cts

@@ -1,9 +1,10 @@
 import * as vue from 'vue';
 import { MaybeRefOrGetter } from 'vue';
-import { PublicKey, Commitment } from '@vue-solana/core/web3';
+import { Commitment } from '@vue-solana/core/kit';
 import { SolanaError } from '@vue-solana/core/errors';
 
-declare function useBalance(address: MaybeRefOrGetter<PublicKey | string | null | undefined>, commitment?: Commitment): {
+type BalanceInput = string | null | undefined;
+declare function useBalance(address: MaybeRefOrGetter<BalanceInput>, commitment?: Commitment): {
     balance: vue.ShallowRef<number | null, number | null>;
     loading: vue.ShallowRef<boolean, boolean>;
     error: vue.ShallowRef<SolanaError | null, SolanaError | null>;
@@ -11,3 +12,4 @@ declare function useBalance(address: MaybeRefOrGetter<PublicKey | string | null
 };
 
 export { useBalance };
+export type { BalanceInput };

package/dist/useBalance.d.mts

@@ -1,9 +1,10 @@
 import * as vue from 'vue';
 import { MaybeRefOrGetter } from 'vue';
-import { PublicKey, Commitment } from '@vue-solana/core/web3';
+import { Commitment } from '@vue-solana/core/kit';
 import { SolanaError } from '@vue-solana/core/errors';
 
-declare function useBalance(address: MaybeRefOrGetter<PublicKey | string | null | undefined>, commitment?: Commitment): {
+type BalanceInput = string | null | undefined;
+declare function useBalance(address: MaybeRefOrGetter<BalanceInput>, commitment?: Commitment): {
     balance: vue.ShallowRef<number | null, number | null>;
     loading: vue.ShallowRef<boolean, boolean>;
     error: vue.ShallowRef<SolanaError | null, SolanaError | null>;
@@ -11,3 +12,4 @@ declare function useBalance(address: MaybeRefOrGetter<PublicKey | string | null
 };
 
 export { useBalance };
+export type { BalanceInput };

package/dist/useBalance.d.ts

@@ -1,9 +1,10 @@
 import * as vue from 'vue';
 import { MaybeRefOrGetter } from 'vue';
-import { PublicKey, Commitment } from '@vue-solana/core/web3';
+import { Commitment } from '@vue-solana/core/kit';
 import { SolanaError } from '@vue-solana/core/errors';
 
-declare function useBalance(address: MaybeRefOrGetter<PublicKey | string | null | undefined>, commitment?: Commitment): {
+type BalanceInput = string | null | undefined;
+declare function useBalance(address: MaybeRefOrGetter<BalanceInput>, commitment?: Commitment): {
     balance: vue.ShallowRef<number | null, number | null>;
     loading: vue.ShallowRef<boolean, boolean>;
     error: vue.ShallowRef<SolanaError | null, SolanaError | null>;
@@ -11,3 +12,4 @@ declare function useBalance(address: MaybeRefOrGetter<PublicKey | string | null
 };
 
 export { useBalance };
+export type { BalanceInput };

package/dist/useBalance.mjs

@@ -1,7 +1,8 @@
-export { u as useBalance } from './shared/vue.DDxhSi72.mjs';
+export { u as useBalance } from './shared/vue.BINkrA8h.mjs';
 import '@vue-solana/core/address';
 import '@vue-solana/core/errors';
 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/useClientCapability.cjs

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

package/dist/useClientCapability.d.cts

@@ -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.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';