@vue-solana/nuxt 3.0.0 → 4.0.0-rc.0

package/README.md

@@ -121,10 +121,14 @@ The module auto-imports these composables from direct `@vue-solana/vue/*` subpat
 - `useSolanaSignAndSendTransactions()`
 - `useSolanaTransactionConfirmation()`
 - `useSolanaSignatureStatus()`
+- `useSolanaTransaction()`
 - `useSolanaAction()`
 - `useSolanaRequest()`
 - `useSolanaSubscription()`
 - `useSolanaTrackedData()`
+- `useSolanaRequestSwr()`
+- `useSolanaSubscriptionSwr()`
+- `useSolanaTrackedDataSwr()`
 - `useSolanaSelectedWalletAccount()`
 - `useSolanaPayer()`
 - `useSolanaIdentity()`
@@ -154,10 +158,14 @@ The module auto-imports these composables from direct `@vue-solana/vue/*` subpat
 | `useSolanaSignAndSendTransactions()` | Batch sign-and-send returning one signature per transaction.                                                                                 |
 | `useSolanaTransactionConfirmation()` | Confirmation state for an already submitted signature.                                                                                       |
 | `useSolanaSignatureStatus()`         | Signature status reads with optional polling or websocket subscription.                                                                      |
+| `useSolanaTransaction()`             | Generic async transaction state helper with optional timeout settings.                                                                       |
 | `useSolanaAction()`                  | Generic async action state machine; each dispatch aborts the prior attempt.                                                                  |
 | `useSolanaRequest()`                 | One-shot Kit request with stale-while-revalidate as its source changes.                                                                      |
 | `useSolanaSubscription()`            | Live data over a Kit reactive stream store (e.g. RPC subscriptions).                                                                         |
 | `useSolanaTrackedData()`             | Slot-deduplicated fetch plus subscription over Kit's slot-tracking store.                                                                    |
+| `useSolanaRequestSwr()`              | Cache-keyed SWR adapter for one-shot Kit requests.                                                                                           |
+| `useSolanaSubscriptionSwr()`         | Cache-keyed SWR adapter for Kit reactive stream stores.                                                                                      |
+| `useSolanaTrackedDataSwr()`          | Cache-keyed SWR adapter for slot-tracked data.                                                                                               |
 | `useSolanaSelectedWalletAccount()`   | App-wide selected wallet account context provided by the runtime plugin.                                                                     |
 | `useSolanaPayer()`                   | Reactive Kit client `payer` signer ref. Nuxt config intentionally does not provide one; use a client-only plugin with `clientPlugin: false`. |
 | `useSolanaIdentity()`                | Reactive Kit client `identity` signer ref.                                                                                                   |
@@ -166,7 +174,7 @@ The module auto-imports these composables from direct `@vue-solana/vue/*` subpat
 | `useSolanaSendTransaction()`         | Plans, signs, submits, and confirms one transaction through the client.                                                                      |
 | `useSolanaSendTransactions()`        | Sends a batch of transactions (parallel or sequential) through the client.                                                                   |
 
-The default client built by the module composes the official `solanaRpc()`, `rpcTransactionPlanner()`, and `rpcTransactionPlanSendingExecutor()` plugins. The old custom fallback sender is not used. `useSolanaSendTransaction()` and `useSolanaSendTransactions()` therefore use the official client-sending capability, but the module does not configure a payer because `payer` and `payerSecretKey` are omitted from `ModuleOptions`. Their `sent` status is reached after the official executor completes its send-and-confirm operation at `confirmed` commitment.
+The default client built by the module composes `solanaRpc()` followed by `rpcAirdrop()` when no `commitment` is configured (a configured `commitment` builds the same stack explicitly so it reaches the RPC layer); `solanaRpc()` installs `rpcTransactionPlanner()`, `rpcTransactionPlanSigningExecutor()`, and `rpcTransactionPlanSendingExecutor()` itself. The old custom fallback sender is not used. `useSolanaSendTransaction()` and `useSolanaSendTransactions()` therefore use the official client-sending capability, but the module does not configure a payer because `payer` and `payerSecretKey` are omitted from `ModuleOptions`. Their `sent` status is reached after the official executor completes its send-and-confirm operation at `confirmed` commitment.
 
 The runtime plugin is client-only. Auto-imported composables can be called during SSR and return inert state until hydration provides the real client context. Trigger RPC and wallet work from client lifecycle hooks or user actions.
 
@@ -292,7 +300,7 @@ async function signIn() {
 </template>
 ```
 
-Message signing is for wallet ownership or authentication challenges. It is separate from transaction signing and does not authorize on-chain activity. For auth flows, use a server-issued nonce and verify the returned signature server-side.
+Message signing is for wallet ownership or authentication challenges. It is separate from transaction signing and does not authorize on-chain activity. For auth flows, use a server-issued nonce and verify the returned signature server-side. The adapter also checks the signature against the account's public key before resolving, where Ed25519 (WebCrypto) is available — a best-effort client-side guard that rejects with `INVALID_SIGNATURE`, not a replacement for server-side verification.
 
 ## Client-Sent Transactions
 
@@ -325,6 +333,7 @@ Docs: [Vue Solana Agent Skill](https://vue-solana-docs.vercel.app/agent-skill)
 ## Caveats
 
 - The runtime plugin is client-only. Auto-imported composables are SSR-safe, but real RPC and wallet work should run after hydration or in user actions.
+- The SWR cache (`useSolanaRequestSwr()`, `useSolanaSubscriptionSwr()`, `useSolanaTrackedDataSwr()`) is module-level and shared across SSR requests. Namespace cache keys per request or call `clearSwrCache()` (auto-imported) at the start of each server request to avoid leaking cached data between requests.
 - Nuxt module options are stored in public runtime config, so they must be JSON-serializable.
 - Public Solana RPC endpoints are useful for development, but production apps should use dedicated RPC infrastructure.
 - Broad `useSolanaProgramAccounts()` scans can be expensive or blocked on public RPC nodes. Prefer narrow filters and `dataSlice`.

package/dist/module.d.ts

@@ -1,4 +1,4 @@
-import { defineNuxtModule } from '@nuxt/kit';
+import { NuxtModule } from '@nuxt/schema';
 import { VueSolanaPluginOptions } from '@vue-solana/vue';
 export * from '@vue-solana/vue';
 
@@ -10,9 +10,13 @@ type ModuleOptions = Omit<VueSolanaPluginOptions, "wallet" | "payer" | "payerSec
      */
     clientPlugin?: boolean;
 };
-type DefinedNuxtModule = ReturnType<ReturnType<typeof defineNuxtModule<ModuleOptions>>["with"]>;
+declare module "nuxt/schema" {
+    interface PublicRuntimeConfig {
+        solana?: ModuleOptions;
+    }
+}
 
-declare const module$1: DefinedNuxtModule;
+declare const module$1: NuxtModule<ModuleOptions>;
 
 export { module$1 as default };
 export type { ModuleOptions };

package/dist/module.mjs

@@ -1,6 +1,6 @@
 import { defineNuxtModule, createResolver, addPlugin, addImports } from '@nuxt/kit';
 import { existsSync } from 'node:fs';
-import { join, dirname } from 'node:path';
+import { posix, dirname, join } from 'node:path';
 import { createRequire } from 'node:module';
 
 const SOLANA_COMPOSABLE_IMPORTS = [
@@ -8,6 +8,7 @@ const SOLANA_COMPOSABLE_IMPORTS = [
   ["useAction", "useSolanaAction"],
   ["useAirdrop", "useSolanaAirdrop"],
   ["useBalance", "useSolanaBalance"],
+  ["useClientCapability", "useSolanaClientCapability"],
   ["useConnection", "useSolanaConnection"],
   ["useIdentity", "useSolanaIdentity"],
   ["usePlanTransaction", "useSolanaPlanTransaction"],
@@ -54,28 +55,32 @@ function solanaAutoImports(vueDist) {
       as,
       from: vueSource(vueDist, name)
     })),
-    ...SOLANA_SWR_IMPORTS.map(([name, as]) => ({ name, as, from: vueSource(vueDist, "swr") }))
+    ...SOLANA_SWR_IMPORTS.map(([name, as]) => ({ name, as, from: vueSource(vueDist, "swr") })),
+    { name: "tryUseSolana", as: "tryUseSolana", from: vueSource(vueDist, "useSolana") },
+    { name: "clearSwrCache", as: "clearSwrCache", from: vueSource(vueDist, "swr") },
+    { name: "deleteSwrKey", as: "deleteSwrKey", from: vueSource(vueDist, "swr") }
   ];
 }
 function solanaSetupAutoImports(vueDist) {
   return SOLANA_SETUP_IMPORTS.map(([name, as]) => ({ name, as, from: vueSource(vueDist) }));
 }
 function vueSource(vueDist, subpath = "index") {
-  return vueDist ? join(vueDist, `${subpath}.mjs`) : `@vue-solana/vue/${subpath}`;
+  if (!vueDist) {
+    return `@vue-solana/vue/${subpath}`;
+  }
+  return posix.join(vueDist.replace(/\\/g, "/"), `${subpath}.mjs`);
 }
 
 const VITE_OPTIMIZE_DEPS = [
-  "@vue-solana/nuxt > @vue-solana/vue > @vue-solana/core > @solana-mobile/wallet-standard-mobile",
   "@vue-solana/nuxt > @vue-solana/vue > @vue-solana/core > buffer",
   "@vue-solana/nuxt > @vue-solana/vue > @vue-solana/core > buffer/",
-  "@vue-solana/nuxt > @vue-solana/vue > @vue-solana/core > bs58",
-  "@vue-solana/nuxt > @vue-solana/vue > @vue-solana/core > tweetnacl",
-  "@vue-solana/nuxt > @vue-solana/vue > @vue-solana/core > tweetnacl/nacl-fast.js"
-];
-const VITE_NEEDS_INTEROP = [
-  "@vue-solana/nuxt > @vue-solana/vue > @vue-solana/core > tweetnacl",
-  "@vue-solana/nuxt > @vue-solana/vue > @vue-solana/core > tweetnacl/nacl-fast.js"
+  "@vue-solana/nuxt > @vue-solana/vue > @vue-solana/core > tweetnacl"
 ];
+const VITE_NEEDS_INTEROP = ["@vue-solana/nuxt > @vue-solana/vue > @vue-solana/core > tweetnacl"];
+const MODULE_DEFAULTS = {
+  cluster: "devnet",
+  autoConnect: false
+};
 const module$1 = defineNuxtModule({
   meta: {
     name: "@vue-solana/nuxt",
@@ -84,18 +89,17 @@ const module$1 = defineNuxtModule({
       nuxt: "^3.0.0 || ^4.0.0"
     }
   },
-  defaults: {
-    cluster: "devnet",
-    autoConnect: false
-  },
+  defaults: MODULE_DEFAULTS,
   setup(options, nuxt) {
     const resolver = createResolver(import.meta.url);
     const publicConfig = nuxt.options.runtimeConfig.public;
-    publicConfig.solana = toPublicSolanaConfig({
-      ...typeof publicConfig.solana === "object" && publicConfig.solana !== null ? publicConfig.solana : {},
-      ...options
-    });
-    mergeViteOptimizeDeps(nuxt.options.vite);
+    publicConfig.solana = toPublicSolanaConfig(
+      mergeSolanaSources({
+        publicSolana: isPlainObject(publicConfig.solana) ? publicConfig.solana : {},
+        options,
+        configuredSolana: isPlainObject(nuxt.options.solana) ? nuxt.options.solana ?? {} : {}
+      })
+    );
     const vueDist = resolveVueDist();
     nuxt.hook("vite:extendConfig", (config, { isClient }) => {
       if (!isClient) {
@@ -109,7 +113,8 @@ const module$1 = defineNuxtModule({
     if (options.clientPlugin !== false) {
       addPlugin({
         src: resolver.resolve("./runtime/plugin"),
-        mode: "client"
+        mode: "client",
+        order: -10
       });
       addImports(solanaAutoImports(vueDist));
       return;
@@ -117,6 +122,24 @@ const module$1 = defineNuxtModule({
     addImports([...solanaAutoImports(vueDist), ...solanaSetupAutoImports(vueDist)]);
   }
 });
+function mergeSolanaSources({
+  publicSolana,
+  options,
+  configuredSolana
+}) {
+  const merged = { ...publicSolana };
+  for (const [key, value] of Object.entries(options)) {
+    const untouchedDefault = key in MODULE_DEFAULTS && Object.is(value, MODULE_DEFAULTS[key]) && !Object.hasOwn(configuredSolana, key);
+    if (untouchedDefault && Object.hasOwn(publicSolana, key)) {
+      continue;
+    }
+    merged[key] = value;
+  }
+  return merged;
+}
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 function toPublicSolanaConfig(options) {
   const runtimeOptions = { ...options };
   delete runtimeOptions.wallet;

package/dist/runtime/plugin.d.ts

@@ -1,3 +1,9 @@
-declare const _default: unknown;
+import * as _app from '#app';
+
+declare const _default: (nuxtApp: _app.NuxtApp) => void | {
+    provide?: Record<string, unknown> | undefined;
+} | Promise<void | {
+    provide?: Record<string, unknown> | undefined;
+}>;
 
 export { _default as default };

package/dist/runtime/plugin.mjs

@@ -2,20 +2,17 @@ import { createSolanaPlugin, createSelectedWalletAccountContext, selectedWalletA
 import { defineNuxtPlugin, useRuntimeConfig } from '#app';
 
 const plugin = defineNuxtPlugin((nuxtApp) => {
-  const config = useRuntimeConfig().public.solana;
-  const solanaPlugin = createSolanaPlugin({
-    cluster: config.cluster,
-    endpoint: config.endpoint,
-    wsEndpoint: config.wsEndpoint,
-    commitment: config.commitment,
-    autoConnect: config.autoConnect,
-    mobileWallet: config.mobileWallet,
-    iosWallet: config.iosWallet
-  });
+  const rawConfig = useRuntimeConfig().public.solana ?? {};
+  const pluginOptions = { ...rawConfig };
+  delete pluginOptions.wallet;
+  delete pluginOptions.payer;
+  delete pluginOptions.payerSecretKey;
+  delete pluginOptions.clientPlugin;
+  const solanaPlugin = createSolanaPlugin(pluginOptions);
   nuxtApp.vueApp.use(solanaPlugin);
-  const vueApp = nuxtApp.vueApp;
+  nuxtApp.vueApp.onUnmount(() => solanaPlugin.dispose());
   const context = createSelectedWalletAccountContext({}, solanaPlugin.context);
-  vueApp.provide(selectedWalletAccountInjectionKey, context);
+  nuxtApp.vueApp.provide(selectedWalletAccountInjectionKey, context);
 });
 
 export { plugin as default };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vue-solana/nuxt",
-  "version": "3.0.0",
+  "version": "4.0.0-rc.0",
   "description": "Nuxt module for Solana applications.",
   "license": "MIT",
   "keywords": [
@@ -22,10 +22,10 @@
   "type": "module",
   "sideEffects": false,
   "module": "./dist/module.mjs",
-  "types": "./dist/module.d.mts",
+  "types": "./dist/module.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/module.d.mts",
+      "types": "./dist/module.d.ts",
       "import": "./dist/module.mjs"
     },
     "./buffer-polyfill": {
@@ -38,19 +38,21 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "!dist/**/*.d.mts"
   ],
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@vue-solana/vue": "3.0.0"
+    "@vue-solana/vue": "4.0.0-rc.0"
   },
   "peerDependencies": {
     "nuxt": "^3.0.0 || ^4.0.0"
   },
   "devDependencies": {
     "@nuxt/kit": "^4.4.6",
+    "@nuxt/schema": "^4.4.6",
     "nuxt": "^4.4.6",
     "typescript": "^5.8.3",
     "unbuild": "^3.5.0",
@@ -60,6 +62,7 @@
     "build": "unbuild",
     "dev": "unbuild --stub",
     "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist",
+    "check:esm-map": "node ../../scripts/check-exports-map.mjs"
   }
 }

package/dist/module.d.mts

@@ -1,18 +0,0 @@
-import { defineNuxtModule } from '@nuxt/kit';
-import { VueSolanaPluginOptions } from '@vue-solana/vue';
-export * from '@vue-solana/vue';
-
-type ModuleOptions = Omit<VueSolanaPluginOptions, "wallet" | "payer" | "payerSecretKey"> & {
-    /**
-     * Set to `false` to auto-import the composables without installing the Solana
-     * runtime plugin. Use it when the app installs `createSolanaPlugin` itself,
-     * e.g. to attach a client-only `payer` that module options cannot carry.
-     */
-    clientPlugin?: boolean;
-};
-type DefinedNuxtModule = ReturnType<ReturnType<typeof defineNuxtModule<ModuleOptions>>["with"]>;
-
-declare const module$1: DefinedNuxtModule;
-
-export { module$1 as default };
-export type { ModuleOptions };

package/dist/runtime/buffer-polyfill.d.mts

@@ -1,2 +0,0 @@
-export { Buffer, installSolanaBufferPolyfill } from '@vue-solana/vue/buffer-polyfill';
-import '@vue-solana/vue/kit';

package/dist/runtime/kit.d.mts

@@ -1 +0,0 @@
-export * from '@vue-solana/vue/kit';

package/dist/runtime/plugin.d.mts

@@ -1,3 +0,0 @@
-declare const _default: unknown;
-
-export { _default as default };