@vue-solana/vue 2.0.0 → 2.1.0

package/dist/useTrackedData.d.ts

@@ -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 };

package/dist/useTrackedData.mjs

@@ -0,0 +1,4 @@
+export { u as useTrackedData } from './shared/vue.CogzzQXM.mjs';
+import '@vue-solana/core/kit';
+import '@vue-solana/core/errors';
+import 'vue';

package/dist/useTransaction.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
-const useTransaction = require('./shared/vue.CE5i8KZZ.cjs');
+const useTransaction = require('./shared/vue.Bk5xjlUx.cjs');
+require('@vue-solana/core/action');
 require('@vue-solana/core/errors');
 require('@vue-solana/core/timeout');
 require('vue');

package/dist/useTransaction.d.cts

@@ -5,8 +5,19 @@ interface UseTransactionOptions {
     timeoutMs?: number;
     timeoutMessage?: string;
 }
+/**
+ * Execute a transaction-building workflow and track `{ signature, loading,
+ * error }` through Vue state.
+ *
+ * Built on the same action state machine as `useAction`
+ * (`createSolanaActionStore` from `@vue-solana/core/action`): starting a new
+ * execution while one is in flight supersedes it — the older call's outcome
+ * is dropped and its promise rejects without touching state, so newer
+ * executions always own `signature`/`loading`/`error`. Each execution is
+ * raced against `timeoutMs` (`TRANSACTION_TIMEOUT` when exceeded).
+ */
 declare function useTransaction<TArgs extends unknown[]>(handler: (...args: TArgs) => Promise<string>, options?: UseTransactionOptions): {
-    signature: vue.Ref<string | null, string | null>;
+    signature: vue.ShallowRef<string | null, string | null>;
     loading: vue.Ref<boolean, boolean>;
     error: vue.Ref<SolanaError | null, SolanaError | null>;
     execute: (...args: TArgs) => Promise<string>;

package/dist/useTransaction.d.mts

@@ -5,8 +5,19 @@ interface UseTransactionOptions {
     timeoutMs?: number;
     timeoutMessage?: string;
 }
+/**
+ * Execute a transaction-building workflow and track `{ signature, loading,
+ * error }` through Vue state.
+ *
+ * Built on the same action state machine as `useAction`
+ * (`createSolanaActionStore` from `@vue-solana/core/action`): starting a new
+ * execution while one is in flight supersedes it — the older call's outcome
+ * is dropped and its promise rejects without touching state, so newer
+ * executions always own `signature`/`loading`/`error`. Each execution is
+ * raced against `timeoutMs` (`TRANSACTION_TIMEOUT` when exceeded).
+ */
 declare function useTransaction<TArgs extends unknown[]>(handler: (...args: TArgs) => Promise<string>, options?: UseTransactionOptions): {
-    signature: vue.Ref<string | null, string | null>;
+    signature: vue.ShallowRef<string | null, string | null>;
     loading: vue.Ref<boolean, boolean>;
     error: vue.Ref<SolanaError | null, SolanaError | null>;
     execute: (...args: TArgs) => Promise<string>;

package/dist/useTransaction.d.ts

@@ -5,8 +5,19 @@ interface UseTransactionOptions {
     timeoutMs?: number;
     timeoutMessage?: string;
 }
+/**
+ * Execute a transaction-building workflow and track `{ signature, loading,
+ * error }` through Vue state.
+ *
+ * Built on the same action state machine as `useAction`
+ * (`createSolanaActionStore` from `@vue-solana/core/action`): starting a new
+ * execution while one is in flight supersedes it — the older call's outcome
+ * is dropped and its promise rejects without touching state, so newer
+ * executions always own `signature`/`loading`/`error`. Each execution is
+ * raced against `timeoutMs` (`TRANSACTION_TIMEOUT` when exceeded).
+ */
 declare function useTransaction<TArgs extends unknown[]>(handler: (...args: TArgs) => Promise<string>, options?: UseTransactionOptions): {
-    signature: vue.Ref<string | null, string | null>;
+    signature: vue.ShallowRef<string | null, string | null>;
     loading: vue.Ref<boolean, boolean>;
     error: vue.Ref<SolanaError | null, SolanaError | null>;
     execute: (...args: TArgs) => Promise<string>;

package/dist/useTransaction.mjs

@@ -1,4 +1,5 @@
-export { u as useTransaction } from './shared/vue.C4d2JA8U.mjs';
+export { u as useTransaction } from './shared/vue.5euWd6-V.mjs';
+import '@vue-solana/core/action';
 import '@vue-solana/core/errors';
 import '@vue-solana/core/timeout';
 import 'vue';

package/dist/useTransactionConfirmation.cjs

@@ -1,12 +1,13 @@
 'use strict';
 
-const useTransactionConfirmation = require('./shared/vue.C32ozdA1.cjs');
+const useTransactionConfirmation = require('./shared/vue.Sbbm9JSu.cjs');
 require('@vue-solana/core/transaction');
 require('@vue-solana/core/errors');
 require('vue');
-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');
 
 
 

package/dist/useTransactionConfirmation.mjs

@@ -1,7 +1,8 @@
-export { g as getConfirmedTransactionStatus, u as useTransactionConfirmation } from './shared/vue.B2sFJ1xI.mjs';
+export { g as getConfirmedTransactionStatus, u as useTransactionConfirmation } from './shared/vue.D3Y0PWbF.mjs';
 import '@vue-solana/core/transaction';
 import '@vue-solana/core/errors';
 import 'vue';
-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';

package/dist/useWallet.cjs

@@ -1,10 +1,11 @@
 'use strict';
 
-const useWallet = require('./shared/vue.BAlo-tIh.cjs');
+const useWallet = require('./shared/vue.BGxz4dru.cjs');
 require('@vue-solana/core/errors');
 require('@vue-solana/core/wallet');
 require('vue');
-require('./shared/vue.BaR1VPhl.cjs');
+require('./shared/vue.DE3emjSF.cjs');
+require('./shared/vue.DEHxNvUX.cjs');
 
 
 

package/dist/useWallet.mjs

@@ -1,5 +1,6 @@
-export { u as useWallet } from './shared/vue.PJjEncbP.mjs';
+export { u as useWallet } from './shared/vue.D218Ow7t.mjs';
 import '@vue-solana/core/errors';
 import '@vue-solana/core/wallet';
 import 'vue';
-import './shared/vue.CnUlZSe8.mjs';
+import './shared/vue.CQh3AUE8.mjs';
+import './shared/vue.D_P5SqqD.mjs';

package/dist/useWallets.cjs

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

package/dist/useWallets.mjs

@@ -1,3 +1,4 @@
-export { u as useWallets } from './shared/vue.D7xFeC2m.mjs';
-import './shared/vue.CnUlZSe8.mjs';
+export { u as useWallets } from './shared/vue.C_4qJDiF.mjs';
+import './shared/vue.CQh3AUE8.mjs';
 import 'vue';
+import './shared/vue.D_P5SqqD.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vue-solana/vue",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Vue plugin and composables for Solana applications.",
   "license": "MIT",
   "keywords": [
@@ -35,6 +35,76 @@
       "import": "./dist/buffer-polyfill.mjs",
       "require": "./dist/buffer-polyfill.cjs"
     },
+    "./useAction": {
+      "types": "./dist/useAction.d.ts",
+      "import": "./dist/useAction.mjs",
+      "require": "./dist/useAction.cjs"
+    },
+    "./useRequest": {
+      "types": "./dist/useRequest.d.ts",
+      "import": "./dist/useRequest.mjs",
+      "require": "./dist/useRequest.cjs"
+    },
+    "./useSubscription": {
+      "types": "./dist/useSubscription.d.ts",
+      "import": "./dist/useSubscription.mjs",
+      "require": "./dist/useSubscription.cjs"
+    },
+    "./useTrackedData": {
+      "types": "./dist/useTrackedData.d.ts",
+      "import": "./dist/useTrackedData.mjs",
+      "require": "./dist/useTrackedData.cjs"
+    },
+    "./useSignIn": {
+      "types": "./dist/useSignIn.d.ts",
+      "import": "./dist/useSignIn.mjs",
+      "require": "./dist/useSignIn.cjs"
+    },
+    "./useSelectedWalletAccount": {
+      "types": "./dist/useSelectedWalletAccount.d.ts",
+      "import": "./dist/useSelectedWalletAccount.mjs",
+      "require": "./dist/useSelectedWalletAccount.cjs"
+    },
+    "./useSignTransactions": {
+      "types": "./dist/useSignTransactions.d.ts",
+      "import": "./dist/useSignTransactions.mjs",
+      "require": "./dist/useSignTransactions.cjs"
+    },
+    "./useSignAndSendTransactions": {
+      "types": "./dist/useSignAndSendTransactions.d.ts",
+      "import": "./dist/useSignAndSendTransactions.mjs",
+      "require": "./dist/useSignAndSendTransactions.cjs"
+    },
+    "./useClientCapability": {
+      "types": "./dist/useClientCapability.d.ts",
+      "import": "./dist/useClientCapability.mjs",
+      "require": "./dist/useClientCapability.cjs"
+    },
+    "./usePayer": {
+      "types": "./dist/usePayer.d.ts",
+      "import": "./dist/usePayer.mjs",
+      "require": "./dist/usePayer.cjs"
+    },
+    "./useIdentity": {
+      "types": "./dist/useIdentity.d.ts",
+      "import": "./dist/useIdentity.mjs",
+      "require": "./dist/useIdentity.cjs"
+    },
+    "./usePlanTransaction": {
+      "types": "./dist/usePlanTransaction.d.ts",
+      "import": "./dist/usePlanTransaction.mjs",
+      "require": "./dist/usePlanTransaction.cjs"
+    },
+    "./usePlanTransactions": {
+      "types": "./dist/usePlanTransactions.d.ts",
+      "import": "./dist/usePlanTransactions.mjs",
+      "require": "./dist/usePlanTransactions.cjs"
+    },
+    "./swr": {
+      "types": "./dist/swr.d.ts",
+      "import": "./dist/swr.mjs",
+      "require": "./dist/swr.cjs"
+    },
     "./useSolana": {
       "types": "./dist/useSolana.d.ts",
       "import": "./dist/useSolana.mjs",
@@ -129,7 +199,7 @@
   },
   "dependencies": {
     "bs58": "^6.0.0",
-    "@vue-solana/core": "2.0.0"
+    "@vue-solana/core": "2.1.0"
   },
   "peerDependencies": {
     "vue": "^3.5.0"
@@ -140,7 +210,7 @@
     "vue": "^3.5.16"
   },
   "scripts": {
-    "build": "unbuild",
+    "build": "NODE_OPTIONS=--max-old-space-size=8192 unbuild",
     "dev": "unbuild --stub",
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist"

package/dist/shared/vue.C4d2JA8U.mjs

@@ -1,44 +0,0 @@
-import { normalizeSolanaError } from '@vue-solana/core/errors';
-import { withSolanaTimeout } from '@vue-solana/core/timeout';
-import { ref } from 'vue';
-
-function useTransaction(handler, options = {}) {
-  const signature = ref(null);
-  const loading = ref(false);
-  const error = ref(null);
-  let executionId = 0;
-  async function execute(...args) {
-    const currentExecutionId = ++executionId;
-    loading.value = true;
-    error.value = null;
-    try {
-      const nextSignature = await withSolanaTimeout(
-        handler(...args),
-        options.timeoutMs,
-        options.timeoutMessage ?? "Transaction did not return a result before timing out."
-      );
-      if (currentExecutionId === executionId) {
-        signature.value = nextSignature;
-      }
-      return nextSignature;
-    } catch (cause) {
-      const normalizedError = normalizeSolanaError(cause, "RPC_FAILURE");
-      if (currentExecutionId === executionId) {
-        error.value = normalizedError;
-      }
-      throw normalizedError;
-    } finally {
-      if (currentExecutionId === executionId) {
-        loading.value = false;
-      }
-    }
-  }
-  return {
-    signature,
-    loading,
-    error,
-    execute
-  };
-}
-
-export { useTransaction as u };

package/dist/shared/vue.CE5i8KZZ.cjs

@@ -1,46 +0,0 @@
-'use strict';
-
-const errors = require('@vue-solana/core/errors');
-const timeout = require('@vue-solana/core/timeout');
-const vue = require('vue');
-
-function useTransaction(handler, options = {}) {
-  const signature = vue.ref(null);
-  const loading = vue.ref(false);
-  const error = vue.ref(null);
-  let executionId = 0;
-  async function execute(...args) {
-    const currentExecutionId = ++executionId;
-    loading.value = true;
-    error.value = null;
-    try {
-      const nextSignature = await timeout.withSolanaTimeout(
-        handler(...args),
-        options.timeoutMs,
-        options.timeoutMessage ?? "Transaction did not return a result before timing out."
-      );
-      if (currentExecutionId === executionId) {
-        signature.value = nextSignature;
-      }
-      return nextSignature;
-    } catch (cause) {
-      const normalizedError = errors.normalizeSolanaError(cause, "RPC_FAILURE");
-      if (currentExecutionId === executionId) {
-        error.value = normalizedError;
-      }
-      throw normalizedError;
-    } finally {
-      if (currentExecutionId === executionId) {
-        loading.value = false;
-      }
-    }
-  }
-  return {
-    signature,
-    loading,
-    error,
-    execute
-  };
-}
-
-exports.useTransaction = useTransaction;