@vue-solana/core 4.1.10 → 4.1.12

package/README.md

@@ -244,6 +244,7 @@ Direct subpaths:
 | `isSolanaMobileWalletSupported()`                                                      | Android-support gate used to decide whether to lazy-load the MWA module.                                                                                                                                                |
 | `getSolanaIosWallets(options?)`                                                        | Builds iOS browser wallet entries (Phantom, Solflare, Backpack) as universal links.                                                                                                                                     |
 | `handleSolanaIosWalletCallback()`                                                      | Completes a pending iOS wallet deep-link callback after redirect.                                                                                                                                                       |
+| `waitForRedirect(options?)`                                                            | Waits for an iOS wallet redirect that reloads the page; intentionally never resolves in-page. Rejects with `REDIRECT_TIMEOUT` after `timeoutMs` (default 10 minutes) or with the signal's reason on abort.              |
 | `adaptSolanaStandardWallet(wallet)`                                                    | Adapts a Solana Wallet Standard wallet into `SolanaWallet`.                                                                                                                                                             |
 | `disconnectSolanaStandardWallet(walletInfo)`                                           | Disconnects a discovered Wallet Standard wallet through its own `standard:disconnect` feature, without adapting it. Resolves `false` if the wallet has no disconnect feature, and ignores failures after a 2 s timeout. |
 | `getRegisteredSolanaWallets()`                                                         | Returns the Wallet Standard wallets currently registered in the app.                                                                                                                                                    |

package/dist/address.mjs

@@ -1,8 +1,9 @@
 import { isAddress, address } from '@solana/kit';
 import { createSolanaError } from './errors.mjs';
 
+const MAX_ADDRESS_INPUT_DEPTH = 32;
 function parseAddress(value) {
-  const input = toAddressInput(value);
+  const input = toAddressInput(value, 0);
   if (!input) {
     return null;
   }
@@ -15,18 +16,24 @@ function parseAddress(value) {
     throw createSolanaError("INVALID_ADDRESS", "Invalid Solana address", { cause });
   }
 }
-function toAddressInput(value) {
+function toAddressInput(value, depth) {
   if (!value) {
     return null;
   }
+  if (depth > MAX_ADDRESS_INPUT_DEPTH) {
+    throw createSolanaError(
+      "INVALID_ADDRESS",
+      `Invalid Solana address: input nests more than ${MAX_ADDRESS_INPUT_DEPTH} levels (possible cycle)`
+    );
+  }
   if (typeof value === "function") {
-    return toAddressInput(value());
+    return toAddressInput(value(), depth + 1);
   }
   if (typeof value === "string") {
     return value;
   }
   if (typeof value === "object" && value !== null && "value" in value) {
-    return toAddressInput(value.value);
+    return toAddressInput(value.value, depth + 1);
   }
   throw createSolanaError(
     "INVALID_ADDRESS",

package/dist/ios-wallet.d.ts

@@ -52,10 +52,39 @@ declare function isSolanaIosBrowserWalletSupported(): boolean;
 declare function isIosBrowser(): boolean;
 declare function getDefaultIosWalletAppIdentity(): SolanaIosWalletAppIdentity;
 declare function getDefaultIosWalletRedirectUrl(): string;
+interface WaitForRedirectOptions {
+    /**
+     * Milliseconds to wait for the wallet to redirect back before rejecting
+     * with `REDIRECT_TIMEOUT`. Defaults to 10 minutes, matching the pending
+     * request TTL (`PENDING_REQUEST_TTL_MS` in `storage.ts`).
+     */
+    timeoutMs?: number;
+    /**
+     * Rejects without further waiting when the caller's own `AbortSignal`
+     * fires. An aborted wait rejects with the signal's reason (an
+     * `AbortError` by default) rather than a timeout error — including when the
+     * signal is already aborted at call time.
+     */
+    signal?: AbortSignal;
+}
+/**
+ * Settles when the iOS wallet redirects back to the app and the page reloads
+ * — which is the only way it settles on its own. The reload path runs
+ * `handleSolanaIosWalletCallback()` at bootstrap and reads the stored
+ * session/pending request, so this promise intentionally never resolves
+ * in-page: it only rejects on `timeoutMs` / `signal` so callers can reset
+ * `connecting` state instead of hanging forever.
+ *
+ * Invalid options (`timeoutMs`) throw synchronously with `INVALID_INPUT`. An
+ * aborted `signal` always *rejects* — a pre-aborted signal does not throw
+ * before the promise exists, so `.catch()` handles every abort path the same
+ * way.
+ */
+declare function waitForRedirect<T = never>(options?: WaitForRedirectOptions): Promise<T>;
 
 declare function handleSolanaIosWalletCallback(options?: {
     clearUrl?: boolean;
 }): IosWalletCallbackResult | null;
 
-export { adaptSolanaIosWallet, getDefaultIosWalletAppIdentity, getDefaultIosWalletRedirectUrl, getSolanaIosWallets, handleSolanaIosWalletCallback, isIosBrowser, isSolanaIosBrowserWalletSupported, isSolanaIosWalletInfo };
-export type { AdaptSolanaIosWalletOptions, GetSolanaIosWalletsOptions, IosWalletCallbackResult, IosWalletInfo, IosWalletMethod, SolanaIosWalletAppIdentity };
+export { adaptSolanaIosWallet, getDefaultIosWalletAppIdentity, getDefaultIosWalletRedirectUrl, getSolanaIosWallets, handleSolanaIosWalletCallback, isIosBrowser, isSolanaIosBrowserWalletSupported, isSolanaIosWalletInfo, waitForRedirect };
+export type { AdaptSolanaIosWalletOptions, GetSolanaIosWalletsOptions, IosWalletCallbackResult, IosWalletInfo, IosWalletMethod, SolanaIosWalletAppIdentity, WaitForRedirectOptions };

package/dist/ios-wallet.mjs

@@ -68,8 +68,11 @@ function waitForRedirect(options = {}) {
       `Invalid redirect timeout: expected a non-negative number of milliseconds, received ${String(timeoutMs)}`
     );
   }
-  signal?.throwIfAborted();
   return new Promise((_, reject) => {
+    if (signal?.aborted) {
+      reject(signal.reason);
+      return;
+    }
     const timeoutId = setTimeout(() => {
       signal?.removeEventListener("abort", onAbort);
       reject(
@@ -676,4 +679,4 @@ function getIosWalletDefinition(walletInfo) {
   return walletInfo.wallet;
 }
 
-export { adaptSolanaIosWallet, getDefaultIosWalletAppIdentity, getDefaultIosWalletRedirectUrl, getSolanaIosWallets, handleSolanaIosWalletCallback, isIosBrowser, isSolanaIosBrowserWalletSupported, isSolanaIosWalletInfo };
+export { adaptSolanaIosWallet, getDefaultIosWalletAppIdentity, getDefaultIosWalletRedirectUrl, getSolanaIosWallets, handleSolanaIosWalletCallback, isIosBrowser, isSolanaIosBrowserWalletSupported, isSolanaIosWalletInfo, waitForRedirect };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vue-solana/core",
-  "version": "4.1.10",
+  "version": "4.1.12",
   "description": "Framework-agnostic primitives for Vue Solana libraries.",
   "license": "MIT",
   "keywords": [