@dynamic-labs-sdk/legacy-embedded-wallet-upgrade 1.21.2 → 1.22.0

package/dist/consumeUpgradeRedirect/consumeUpgradeRedirect.d.ts

@@ -0,0 +1,57 @@
+import { type WalletUpgradeOutcome } from '../upgradeAppContract';
+/**
+ * Options for {@link consumeUpgradeRedirect}.
+ *
+ * @example
+ * ```ts
+ * // Browser: read the outcome from the current page.
+ * await consumeUpgradeRedirect({ url: window.location.href });
+ * ```
+ * @see consumeUpgradeRedirect
+ * @see startUpgradeRedirect
+ */
+export type ConsumeUpgradeRedirectParams = {
+    /**
+     * The return URL to read the upgrade outcome from. Pass the URL yourself so
+     * the flow works everywhere: in the browser pass `window.location.href`; in
+     * React Native pass the deep-link URL you received. This mirrors how social
+     * sign-in and device registration consume their redirects, and keeps the
+     * function free of any implicit `window` dependency.
+     */
+    url: string;
+};
+/**
+ * Handles the return leg of the redirect upgrade path.
+ *
+ * The upgrade app sends the user back with the outcome in the
+ * `dynamicWaasMigrationStatus` query param. Call this once on app load with the
+ * return URL: it reads the param, and when it is present refreshes the session
+ * on success (so the upgraded wallet appears). Returns the outcome, or `null`
+ * when the URL carries no upgrade result — so callers can drive their own
+ * toast/UI.
+ *
+ * You always pass the URL (`window.location.href` in the browser, the deep-link
+ * URL in React Native), matching how social sign-in and device registration
+ * consume their redirects. The function never touches browser history, so you
+ * own clearing the param from your navigation state once you have the outcome.
+ *
+ * @example
+ * ```ts
+ * // Browser
+ * const outcome = await consumeUpgradeRedirect({ url: window.location.href });
+ * if (outcome?.status === 'error') showRetryToast();
+ * ```
+ * @example
+ * ```ts
+ * // React Native: pass the deep-link URL you received.
+ * const outcome = await consumeUpgradeRedirect({ url: deepLinkUrl });
+ * ```
+ * @param params - Options.
+ * @param params.url - Return URL to read the outcome from (e.g. `window.location.href`).
+ * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+ * @returns A promise resolving to the upgrade outcome, or `null` when there was no upgrade result to consume.
+ * @see startUpgradeRedirect
+ * @see subscribeToUpgradeCompletion
+ */
+export declare const consumeUpgradeRedirect: ({ url }: ConsumeUpgradeRedirectParams, client?: import("@dynamic-labs-sdk/client").DynamicClient) => Promise<WalletUpgradeOutcome | null>;
+//# sourceMappingURL=consumeUpgradeRedirect.d.ts.map

package/dist/consumeUpgradeRedirect/consumeUpgradeRedirect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumeUpgradeRedirect.d.ts","sourceRoot":"","sources":["../../src/consumeUpgradeRedirect/consumeUpgradeRedirect.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;;;GAUG;AACH,MAAM,MAAM,4BAA4B,GAAG;IACzC;;;;;;OAMG;IACH,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,sBAAsB,YACxB,4BAA4B,gEAEpC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAmBrC,CAAC"}

package/dist/consumeUpgradeRedirect/index.d.ts

@@ -0,0 +1,2 @@
+export { consumeUpgradeRedirect, type ConsumeUpgradeRedirectParams, } from './consumeUpgradeRedirect';
+//# sourceMappingURL=index.d.ts.map

package/dist/consumeUpgradeRedirect/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/consumeUpgradeRedirect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,KAAK,4BAA4B,GAClC,MAAM,0BAA0B,CAAC"}

package/dist/errors/UpgradeIframeClosedError.d.ts

@@ -0,0 +1,5 @@
+import { BaseError } from '@dynamic-labs-sdk/client';
+export declare class UpgradeIframeClosedError extends BaseError {
+    constructor();
+}
+//# sourceMappingURL=UpgradeIframeClosedError.d.ts.map

package/dist/errors/UpgradeIframeClosedError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpgradeIframeClosedError.d.ts","sourceRoot":"","sources":["../../src/errors/UpgradeIframeClosedError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,qBAAa,wBAAyB,SAAQ,SAAS;;CAUtD"}

package/dist/errors/UpgradeIframeUnavailableInReactNativeError.d.ts

@@ -0,0 +1,5 @@
+import { BaseError } from '@dynamic-labs-sdk/client';
+export declare class UpgradeIframeUnavailableInReactNativeError extends BaseError {
+    constructor();
+}
+//# sourceMappingURL=UpgradeIframeUnavailableInReactNativeError.d.ts.map

package/dist/errors/UpgradeIframeUnavailableInReactNativeError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpgradeIframeUnavailableInReactNativeError.d.ts","sourceRoot":"","sources":["../../src/errors/UpgradeIframeUnavailableInReactNativeError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,qBAAa,0CAA2C,SAAQ,SAAS;;CAWxE"}

package/dist/exports/index.d.ts

@@ -1,4 +1,10 @@
 export { buildUpgradeUrl } from '../buildUpgradeUrl';
 export { getWalletsRequiringUpgrade } from '../getWalletsRequiringUpgrade';
 export { hasWalletsRequiringUpgrade } from '../hasWalletsRequiringUpgrade';
+export { startUpgradeRedirect } from '../startUpgradeRedirect';
+export { consumeUpgradeRedirect, type ConsumeUpgradeRedirectParams, } from '../consumeUpgradeRedirect';
+export { subscribeToUpgradeCompletion } from '../subscribeToUpgradeCompletion';
+export { openUpgradeIframe } from '../openUpgradeIframe';
+export type { UpgradeIframeSession } from '../openUpgradeIframe';
+export type { WalletUpgradeOutcome, WalletUpgradeStatus, } from '../upgradeAppContract';
 //# sourceMappingURL=index.d.ts.map

package/dist/exports/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/exports/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/exports/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EACL,sBAAsB,EACtB,KAAK,4BAA4B,GAClC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,YAAY,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC"}

package/dist/exports/react.d.ts

@@ -0,0 +1,5 @@
+export { useWalletsRequiringUpgrade } from '../react/useWalletsRequiringUpgrade';
+export { useHasWalletsRequiringUpgrade } from '../react/useHasWalletsRequiringUpgrade';
+export { useUpgradeRedirectResult, type UseUpgradeRedirectResultParams, } from '../react/useUpgradeRedirectResult';
+export { useUpgradeIframe, type UseUpgradeIframeParams, type UseUpgradeIframeResult, } from '../react/useUpgradeIframe';
+//# sourceMappingURL=react.d.ts.map

package/dist/exports/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/exports/react.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAE,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AACvF,OAAO,EACL,wBAAwB,EACxB,KAAK,8BAA8B,GACpC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,gBAAgB,EAChB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,GAC5B,MAAM,2BAA2B,CAAC"}

package/dist/index.cjs

@@ -1,192 +1,151 @@
+const require_subscribeToUpgradeCompletion = require('./subscribeToUpgradeCompletion-CfKOBwip.cjs');
 let _dynamic_labs_sdk_assert_package_version = require("@dynamic-labs-sdk/assert-package-version");
 let _dynamic_labs_sdk_client = require("@dynamic-labs-sdk/client");
 let _dynamic_labs_sdk_client_core = require("@dynamic-labs-sdk/client/core");
 
-//#region package.json
-var name = "@dynamic-labs-sdk/legacy-embedded-wallet-upgrade";
-var version = "1.21.2";
-
-//#endregion
-//#region src/errors/InvalidUpgradeBaseUrlError.ts
-var InvalidUpgradeBaseUrlError = class extends _dynamic_labs_sdk_client.BaseError {
-	constructor(baseUrl) {
-		super({
-			cause: null,
-			code: "invalid_upgrade_base_url_error",
-			docsUrl: null,
-			name: "InvalidUpgradeBaseUrlError",
-			shortMessage: `Upgrade baseUrl must be an absolute https URL, received: ${baseUrl}`
-		});
-	}
-};
-
-//#endregion
-//#region src/errors/InvalidUpgradeRedirectUrlError.ts
-var InvalidUpgradeRedirectUrlError = class extends _dynamic_labs_sdk_client.BaseError {
-	constructor(redirectUrl) {
-		super({
-			cause: null,
-			code: "invalid_upgrade_redirect_url_error",
-			docsUrl: null,
-			name: "InvalidUpgradeRedirectUrlError",
-			shortMessage: `Upgrade redirectUrl must be an absolute https URL, received: ${redirectUrl}`
-		});
-	}
-};
-
-//#endregion
-//#region src/upgradeAppContract.ts
-/**
-* Default base URL of the hosted WaaS upgrade app. Both upgrade paths point at
-* this origin and append `environmentId` + `redirectUrl` query params. Callers
-* can override it (e.g. to target a local or preview build during QA) via the
-* `baseUrl` option on the public functions.
-*/
-const UPGRADE_APP_BASE_URL = "https://waas-migration-dynamic-xyz.vercel.app";
-/**
-* Query param the upgrade app requires: which Dynamic environment to
-* authenticate the user against. Derived from the Dynamic client so callers
-* never pass it explicitly.
-*/
-const UPGRADE_ENVIRONMENT_ID_PARAM = "environmentId";
-/**
-* Query param the upgrade app requires: where to send the user (redirect flow)
-* or which origin it postMessages to (iframe flow) once the upgrade finishes.
-* The upgrade app rejects anything that is not an absolute https URL.
-*/
-const UPGRADE_REDIRECT_URL_PARAM = "redirectUrl";
-
-//#endregion
-//#region src/buildUpgradeUrl/buildUpgradeUrl.ts
-const HTTPS_PROTOCOL = "https:";
+//#region src/hasWalletsRequiringUpgrade/hasWalletsRequiringUpgrade.ts
 /**
-* Builds the URL that drives the hosted upgrade app for the client's Dynamic
-* environment and a return target.
+* Returns whether the current session has any legacy Dynamic embedded wallet
+* that requires an upgrade to Dynamic WaaS.
 *
-* This is the low-level primitive behind every upgrade path: the redirect flow
-* navigates the top-level window to it, the iframe flow loads it as the iframe
-* `src`, and a React Native WebView can load it directly. The environment id is
-* read from the client, and `redirectUrl` defaults to the current page, so the
-* common call is zero-arg. Prefer {@link startUpgradeRedirect} or
-* {@link openUpgradeIframe} unless you are mounting the upgrade app yourself.
+* A boolean convenience over {@link getWalletsRequiringUpgrade} for the common
+* case where you only need to decide whether to surface the upgrade flow (e.g.
+* show a banner or gate a wallet's actions) rather than act on the specific
+* accounts.
 *
 * @example
 * ```ts
-* const src = buildUpgradeUrl();
-* // or target a local upgrade app during QA:
-* const localSrc = buildUpgradeUrl({ baseUrl: 'https://localhost:3000' });
+* if (hasWalletsRequiringUpgrade()) {
+*   showUpgradeToWaasBanner();
+* }
 * ```
-* @param [params] - Options for the generated URL.
-* @param [params.redirectUrl] - Absolute https return URL; defaults to `window.location.href`.
-* @param [params.baseUrl] - Upgrade app base URL; defaults to the production app.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
-* @returns The fully-qualified upgrade app URL to load.
-* @throws {InvalidUpgradeRedirectUrlError} When `redirectUrl` is not an absolute https URL.
-* @throws {InvalidUpgradeBaseUrlError} When `baseUrl` is not an absolute https URL.
-* @throws {UnavailableInServerSideError} When called during SSR without an explicit `redirectUrl`.
+* @returns True when at least one wallet account requires an upgrade to Dynamic WaaS, false otherwise.
+* @see getWalletsRequiringUpgrade
 * @see startUpgradeRedirect
-* @see openUpgradeIframe
 */
-const buildUpgradeUrl = ({ redirectUrl, baseUrl = UPGRADE_APP_BASE_URL } = {}, client = (0, _dynamic_labs_sdk_client.getDefaultClient)()) => {
-	if (redirectUrl === void 0 && typeof window === "undefined") throw new _dynamic_labs_sdk_client.UnavailableInServerSideError("buildUpgradeUrl");
-	const resolvedRedirectUrl = redirectUrl ?? window.location.href;
-	if (new URL(resolvedRedirectUrl).protocol !== HTTPS_PROTOCOL) throw new InvalidUpgradeRedirectUrlError(resolvedRedirectUrl);
-	const url = new URL(baseUrl);
-	if (url.protocol !== HTTPS_PROTOCOL) throw new InvalidUpgradeBaseUrlError(baseUrl);
-	const { environmentId } = (0, _dynamic_labs_sdk_client_core.getCore)(client);
-	url.searchParams.set(UPGRADE_ENVIRONMENT_ID_PARAM, environmentId);
-	url.searchParams.set(UPGRADE_REDIRECT_URL_PARAM, resolvedRedirectUrl);
-	return url.toString();
-};
+const hasWalletsRequiringUpgrade = (client = (0, _dynamic_labs_sdk_client.getDefaultClient)()) => require_subscribeToUpgradeCompletion.getWalletsRequiringUpgrade(client).length > 0;
 
 //#endregion
-//#region src/walletAccountRequiresUpgrade/walletAccountRequiresUpgrade.ts
+//#region src/startUpgradeRedirect/startUpgradeRedirect.ts
 /**
-* Provider-key substring shared by every Dynamic embedded wallet that predates
-* Dynamic WaaS and can therefore be upgraded to it. A wallet account's
-* `walletProviderKey` is a composite backend value (e.g. `<provider>evm` /
-* `<provider>hdsolana` suffixed with `:embeddedWallet`); both the standard and
-* HD variants contain this marker, so matching it as a substring identifies all
-* of them. This is an opaque backend value, matched verbatim — not a user-facing
-* concept.
-*/
-const LEGACY_EMBEDDED_WALLET_PROVIDER_KEY = "turnkey";
-/**
-* Returns whether a wallet account is a legacy Dynamic embedded wallet that
-* requires an upgrade to Dynamic WaaS.
+* Starts the redirect upgrade path by navigating the top-level window to the
+* hosted upgrade app.
 *
-* Shared predicate behind both the imperative {@link getWalletsRequiringUpgrade}
-* getter and the reactive `useWalletsRequiringUpgrade` hook, so the definition
-* of "requires upgrade" lives in exactly one place.
+* Call this from an "Upgrade" button. The upgrade app runs full-page and, once
+* finished, returns the user to `redirectUrl` with the outcome encoded in the
+* URL — call {@link consumeUpgradeRedirect} on load to pick it up. The
+* environment id and return URL are derived from the client and current page,
+* so the common call is zero-arg.
 *
 * @example
 * ```ts
-* const upgradeable = walletAccounts.filter(walletAccountRequiresUpgrade);
+* // on the "Upgrade via redirect" button
+* await startUpgradeRedirect();
 * ```
-* @param walletAccount - The wallet account to test.
-* @returns True when the account is a legacy embedded wallet requiring an upgrade.
-* @see getWalletsRequiringUpgrade
-* @see hasWalletsRequiringUpgrade
+* @param [params] - Options for the redirect.
+* @param [params.redirectUrl] - Absolute https return URL; defaults to `window.location.href`.
+* @param [params.baseUrl] - Upgrade app base URL; defaults to the production app.
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns A promise that resolves once navigation has been initiated.
+* @see consumeUpgradeRedirect
+* @see buildUpgradeUrl
 */
-const walletAccountRequiresUpgrade = (walletAccount) => walletAccount.walletProviderKey.includes(LEGACY_EMBEDDED_WALLET_PROVIDER_KEY);
+const startUpgradeRedirect = async (params = {}, client = (0, _dynamic_labs_sdk_client.getDefaultClient)()) => (0, _dynamic_labs_sdk_client_core.getCore)(client).navigate(require_subscribeToUpgradeCompletion.buildUpgradeUrl(params, client));
 
 //#endregion
-//#region src/getWalletsRequiringUpgrade/getWalletsRequiringUpgrade.ts
-/**
-* Returns the current session's wallet accounts that are legacy Dynamic
-* embedded wallets requiring an upgrade to Dynamic WaaS.
-*
-* These are earlier-generation Dynamic embedded wallets that predate Dynamic
-* WaaS (the current TSS-MPC embedded wallet) and can be upgraded to it. Use this
-* when you need the accounts themselves — for example to render only the
-* upgrade entry points on those wallets. Already-upgraded Dynamic WaaS accounts
-* are never returned. For a simple boolean check, use
-* {@link hasWalletsRequiringUpgrade}.
-*
-* @example
-* ```ts
-* const walletsRequiringUpgrade = getWalletsRequiringUpgrade();
-* if (walletsRequiringUpgrade.length > 0) {
-*   promptUpgrade(walletsRequiringUpgrade);
-* }
-* ```
-* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
-* @returns The wallet accounts requiring an upgrade to Dynamic WaaS (empty when none).
-* @see hasWalletsRequiringUpgrade
-* @see startUpgradeRedirect
-*/
-const getWalletsRequiringUpgrade = (client = (0, _dynamic_labs_sdk_client.getDefaultClient)()) => (0, _dynamic_labs_sdk_client.getWalletAccounts)(client).filter(walletAccountRequiresUpgrade);
+//#region src/errors/UpgradeIframeClosedError.ts
+var UpgradeIframeClosedError = class extends _dynamic_labs_sdk_client.BaseError {
+	constructor() {
+		super({
+			cause: null,
+			code: "upgrade_iframe_closed_error",
+			docsUrl: null,
+			name: "UpgradeIframeClosedError",
+			shortMessage: "Upgrade iframe was closed before the upgrade completed"
+		});
+	}
+};
 
 //#endregion
-//#region src/hasWalletsRequiringUpgrade/hasWalletsRequiringUpgrade.ts
+//#region src/openUpgradeIframe/openUpgradeIframe.ts
+const UPGRADE_IFRAME_ALLOW = "clipboard-write; publickey-credentials-get *; publickey-credentials-create *";
+const UPGRADE_IFRAME_TITLE = "Dynamic embedded wallet upgrade";
 /**
-* Returns whether the current session has any legacy Dynamic embedded wallet
-* that requires an upgrade to Dynamic WaaS.
+* Runs the embedded upgrade path by mounting the hosted upgrade app in an
+* iframe inside a container you provide.
 *
-* A boolean convenience over {@link getWalletsRequiringUpgrade} for the common
-* case where you only need to decide whether to surface the upgrade flow (e.g.
-* show a banner or gate a wallet's actions) rather than act on the specific
-* accounts.
+* The package renders no UI of its own: pass the element of your modal/sheet
+* and it appends the iframe, wires the origin-checked completion handshake, and
+* refreshes the session on success. `completed` resolves with the outcome once
+* the app reports back; call `close()` when the user dismisses the surface (or
+* after completion) to remove the iframe and detach the listener. Closing
+* before completion rejects `completed` with {@link UpgradeIframeClosedError}
+* so awaiters don't hang — wrap `await session.completed` in try/catch if you
+* allow early dismissal. For React Native or custom mounts, use
+* {@link subscribeToUpgradeCompletion} with {@link buildUpgradeUrl} instead.
 *
 * @example
 * ```ts
-* if (hasWalletsRequiringUpgrade()) {
-*   showUpgradeToWaasBanner();
-* }
+* const session = openUpgradeIframe({ container: sheetBodyEl });
+* const { status } = await session.completed;
+* session.close();
 * ```
+* @param params - Iframe options.
+* @param params.container - Element the upgrade iframe is appended into.
+* @param [params.redirectUrl] - Absolute https completion URL; defaults to `window.location.href`.
+* @param [params.baseUrl] - Upgrade app base URL; defaults to the production app.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
-* @returns True when at least one wallet account requires an upgrade to Dynamic WaaS, false otherwise.
-* @see getWalletsRequiringUpgrade
-* @see startUpgradeRedirect
+* @returns A session handle exposing the `iframe`, a `close` function, and the `completed` promise.
+* @see subscribeToUpgradeCompletion
+* @see buildUpgradeUrl
 */
-const hasWalletsRequiringUpgrade = (client = (0, _dynamic_labs_sdk_client.getDefaultClient)()) => getWalletsRequiringUpgrade(client).length > 0;
+const openUpgradeIframe = ({ container, redirectUrl, baseUrl }, client = (0, _dynamic_labs_sdk_client.getDefaultClient)()) => {
+	const iframe = document.createElement("iframe");
+	iframe.src = require_subscribeToUpgradeCompletion.buildUpgradeUrl({
+		baseUrl,
+		redirectUrl
+	}, client);
+	iframe.title = UPGRADE_IFRAME_TITLE;
+	iframe.setAttribute("allow", UPGRADE_IFRAME_ALLOW);
+	container.appendChild(iframe);
+	let resolveCompleted;
+	let rejectCompleted;
+	const completed = new Promise((resolve, reject) => {
+		resolveCompleted = resolve;
+		rejectCompleted = reject;
+	});
+	completed.catch(() => void 0);
+	let hasReceivedCompletion = false;
+	const unsubscribe = require_subscribeToUpgradeCompletion.subscribeToUpgradeCompletion({
+		baseUrl,
+		onComplete: (outcome) => resolveCompleted?.(outcome),
+		onReceived: () => {
+			hasReceivedCompletion = true;
+		}
+	}, client);
+	const close = () => {
+		unsubscribe();
+		iframe.remove();
+		if (!hasReceivedCompletion) rejectCompleted?.(new UpgradeIframeClosedError());
+	};
+	return {
+		close,
+		completed,
+		iframe
+	};
+};
 
 //#endregion
 //#region src/exports/index.ts
-(0, _dynamic_labs_sdk_assert_package_version.assertPackageVersion)(name, version);
+(0, _dynamic_labs_sdk_assert_package_version.assertPackageVersion)(require_subscribeToUpgradeCompletion.name, require_subscribeToUpgradeCompletion.version);
 
 //#endregion
-exports.buildUpgradeUrl = buildUpgradeUrl;
-exports.getWalletsRequiringUpgrade = getWalletsRequiringUpgrade;
+exports.buildUpgradeUrl = require_subscribeToUpgradeCompletion.buildUpgradeUrl;
+exports.consumeUpgradeRedirect = require_subscribeToUpgradeCompletion.consumeUpgradeRedirect;
+exports.getWalletsRequiringUpgrade = require_subscribeToUpgradeCompletion.getWalletsRequiringUpgrade;
 exports.hasWalletsRequiringUpgrade = hasWalletsRequiringUpgrade;
+exports.openUpgradeIframe = openUpgradeIframe;
+exports.startUpgradeRedirect = startUpgradeRedirect;
+exports.subscribeToUpgradeCompletion = require_subscribeToUpgradeCompletion.subscribeToUpgradeCompletion;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["BaseError","BaseError","UnavailableInServerSideError","packageName","packageVersion"],"sources":["../package.json","../src/errors/InvalidUpgradeBaseUrlError.ts","../src/errors/InvalidUpgradeRedirectUrlError.ts","../src/upgradeAppContract.ts","../src/buildUpgradeUrl/buildUpgradeUrl.ts","../src/walletAccountRequiresUpgrade/walletAccountRequiresUpgrade.ts","../src/getWalletsRequiringUpgrade/getWalletsRequiringUpgrade.ts","../src/hasWalletsRequiringUpgrade/hasWalletsRequiringUpgrade.ts","../src/exports/index.ts"],"sourcesContent":["","import { BaseError } from '@dynamic-labs-sdk/client';\n\nexport class InvalidUpgradeBaseUrlError extends BaseError {\n  // eslint-disable-next-line custom-rules/require-single-object-param\n  constructor(baseUrl: string) {\n    super({\n      cause: null,\n      code: 'invalid_upgrade_base_url_error',\n      docsUrl: null,\n      name: 'InvalidUpgradeBaseUrlError',\n      shortMessage: `Upgrade baseUrl must be an absolute https URL, received: ${baseUrl}`,\n    });\n  }\n}\n","import { BaseError } from '@dynamic-labs-sdk/client';\n\nexport class InvalidUpgradeRedirectUrlError extends BaseError {\n  // eslint-disable-next-line custom-rules/require-single-object-param\n  constructor(redirectUrl: string) {\n    super({\n      cause: null,\n      code: 'invalid_upgrade_redirect_url_error',\n      docsUrl: null,\n      name: 'InvalidUpgradeRedirectUrlError',\n      shortMessage: `Upgrade redirectUrl must be an absolute https URL, received: ${redirectUrl}`,\n    });\n  }\n}\n","// Contract shared with the standalone WaaS upgrade app\n// (dynamic-labs-oss/waas-migration). Every identifier below MUST stay\n// byte-for-byte identical to the ones the upgrade app reads/emits in its\n// `migrationConfig.ts`, otherwise the redirect round-trip and the iframe\n// postMessage handshake break silently.\n\n/**\n * Default base URL of the hosted WaaS upgrade app. Both upgrade paths point at\n * this origin and append `environmentId` + `redirectUrl` query params. Callers\n * can override it (e.g. to target a local or preview build during QA) via the\n * `baseUrl` option on the public functions.\n */\nexport const UPGRADE_APP_BASE_URL =\n  'https://waas-migration-dynamic-xyz.vercel.app';\n\n/**\n * Query param the upgrade app requires: which Dynamic environment to\n * authenticate the user against. Derived from the Dynamic client so callers\n * never pass it explicitly.\n */\nexport const UPGRADE_ENVIRONMENT_ID_PARAM = 'environmentId';\n\n/**\n * Query param the upgrade app requires: where to send the user (redirect flow)\n * or which origin it postMessages to (iframe flow) once the upgrade finishes.\n * The upgrade app rejects anything that is not an absolute https URL.\n */\nexport const UPGRADE_REDIRECT_URL_PARAM = 'redirectUrl';\n\n/**\n * postMessage `type` the upgrade app emits to its iframe parent on completion.\n */\nexport const UPGRADE_COMPLETE_MESSAGE_TYPE = 'dynamic-waas-migration:complete';\n\n/**\n * Query param the upgrade app appends to `redirectUrl` when it runs top-level\n * (redirect flow), carrying the outcome back to the app after navigation.\n */\nexport const UPGRADE_STATUS_PARAM = 'dynamicWaasMigrationStatus';\n\n/** Outcome value the upgrade app reports when the upgrade succeeded. */\nexport const UPGRADE_STATUS_SUCCESS = 'success';\n\n/** Outcome value the upgrade app reports when the upgrade failed. */\nexport const UPGRADE_STATUS_ERROR = 'error';\n\n/**\n * The outcome of a legacy embedded wallet upgrade attempt: `success` when the\n * wallet was upgraded to Dynamic WaaS, `error` when it failed. These are the\n * only two values the upgrade app ever reports, on both the redirect and the\n * iframe paths.\n *\n * @example\n * ```ts\n * const isSuccess = (status: WalletUpgradeStatus) => status === 'success';\n * ```\n * @see WalletUpgradeOutcome\n * @see consumeUpgradeRedirect\n */\nexport type WalletUpgradeStatus =\n  | typeof UPGRADE_STATUS_SUCCESS\n  | typeof UPGRADE_STATUS_ERROR;\n\n/**\n * The resolved result of an upgrade flow, carrying the reported\n * {@link WalletUpgradeStatus}. Returned by the redirect-result consumer and\n * handed to the iframe completion callback so callers can react (toast,\n * refetch, close a sheet, etc.).\n *\n * @example\n * ```ts\n * const onComplete = (outcome: WalletUpgradeOutcome) => {\n *   if (outcome.status === 'success') showSuccessToast();\n * };\n * ```\n * @see WalletUpgradeStatus\n * @see subscribeToUpgradeCompletion\n */\nexport type WalletUpgradeOutcome = {\n  status: WalletUpgradeStatus;\n};\n\n/**\n * Shape of the completion message the upgrade app posts to its parent window\n * in the iframe flow. Internal to the message handshake — consumers receive the\n * parsed {@link WalletUpgradeOutcome} instead.\n */\nexport type UpgradeCompleteMessage = {\n  status: WalletUpgradeStatus;\n  type: typeof UPGRADE_COMPLETE_MESSAGE_TYPE;\n};\n","/* eslint-disable no-restricted-globals */\n\nimport {\n  UnavailableInServerSideError,\n  getDefaultClient,\n} from '@dynamic-labs-sdk/client';\nimport { getCore } from '@dynamic-labs-sdk/client/core';\n\nimport { InvalidUpgradeBaseUrlError } from '../errors/InvalidUpgradeBaseUrlError';\nimport { InvalidUpgradeRedirectUrlError } from '../errors/InvalidUpgradeRedirectUrlError';\nimport {\n  UPGRADE_APP_BASE_URL,\n  UPGRADE_ENVIRONMENT_ID_PARAM,\n  UPGRADE_REDIRECT_URL_PARAM,\n} from '../upgradeAppContract';\n\nconst HTTPS_PROTOCOL = 'https:';\n\ntype BuildUpgradeUrlParams = {\n  /**\n   * Base URL of the hosted upgrade app. Defaults to the production upgrade app;\n   * override it to target a local or preview build (e.g. during QA).\n   */\n  baseUrl?: string;\n  /**\n   * Absolute https URL the upgrade app returns to (redirect flow) or\n   * postMessages (iframe flow) on completion. Defaults to the current page\n   * (`window.location.href`). The upgrade app rejects any non-https URL.\n   */\n  redirectUrl?: string;\n};\n\n/**\n * Builds the URL that drives the hosted upgrade app for the client's Dynamic\n * environment and a return target.\n *\n * This is the low-level primitive behind every upgrade path: the redirect flow\n * navigates the top-level window to it, the iframe flow loads it as the iframe\n * `src`, and a React Native WebView can load it directly. The environment id is\n * read from the client, and `redirectUrl` defaults to the current page, so the\n * common call is zero-arg. Prefer {@link startUpgradeRedirect} or\n * {@link openUpgradeIframe} unless you are mounting the upgrade app yourself.\n *\n * @example\n * ```ts\n * const src = buildUpgradeUrl();\n * // or target a local upgrade app during QA:\n * const localSrc = buildUpgradeUrl({ baseUrl: 'https://localhost:3000' });\n * ```\n * @param [params] - Options for the generated URL.\n * @param [params.redirectUrl] - Absolute https return URL; defaults to `window.location.href`.\n * @param [params.baseUrl] - Upgrade app base URL; defaults to the production app.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns The fully-qualified upgrade app URL to load.\n * @throws {InvalidUpgradeRedirectUrlError} When `redirectUrl` is not an absolute https URL.\n * @throws {InvalidUpgradeBaseUrlError} When `baseUrl` is not an absolute https URL.\n * @throws {UnavailableInServerSideError} When called during SSR without an explicit `redirectUrl`.\n * @see startUpgradeRedirect\n * @see openUpgradeIframe\n */\nexport const buildUpgradeUrl = (\n  { redirectUrl, baseUrl = UPGRADE_APP_BASE_URL }: BuildUpgradeUrlParams = {},\n  client = getDefaultClient()\n): string => {\n  // The default return target is the current page, which only exists in the\n  // browser; fail loudly during SSR rather than dereferencing an absent window.\n  if (redirectUrl === undefined && typeof window === 'undefined') {\n    throw new UnavailableInServerSideError('buildUpgradeUrl');\n  }\n\n  const resolvedRedirectUrl = redirectUrl ?? window.location.href;\n\n  // Validate the return target up front: the upgrade app only accepts an\n  // absolute https URL, so reject anything else (relative, http, other schemes)\n  // here rather than letting it be silently refused after navigation. `new URL`\n  // throws on non-absolute input, so the explicit check only guards the scheme.\n  const parsedRedirectUrl = new URL(resolvedRedirectUrl);\n\n  if (parsedRedirectUrl.protocol !== HTTPS_PROTOCOL) {\n    throw new InvalidUpgradeRedirectUrlError(resolvedRedirectUrl);\n  }\n\n  // Validate the upgrade app origin before we ever load it in an iframe or\n  // navigate to it. The default is a trusted https app, but `baseUrl` is an\n  // override (custom deployments, forks, local QA), so enforce the https scheme\n  // to reject non-secure or dangerous schemes (`http:`, `javascript:`, `data:`)\n  // rather than mounting an untrusted origin. Any https host is allowed on\n  // purpose — customers self-host the upgrade app on their own domains.\n  const url = new URL(baseUrl);\n\n  if (url.protocol !== HTTPS_PROTOCOL) {\n    throw new InvalidUpgradeBaseUrlError(baseUrl);\n  }\n\n  const { environmentId } = getCore(client);\n\n  url.searchParams.set(UPGRADE_ENVIRONMENT_ID_PARAM, environmentId);\n  url.searchParams.set(UPGRADE_REDIRECT_URL_PARAM, resolvedRedirectUrl);\n\n  return url.toString();\n};\n","import type { WalletAccount } from '@dynamic-labs-sdk/client';\n\n/**\n * Provider-key substring shared by every Dynamic embedded wallet that predates\n * Dynamic WaaS and can therefore be upgraded to it. A wallet account's\n * `walletProviderKey` is a composite backend value (e.g. `<provider>evm` /\n * `<provider>hdsolana` suffixed with `:embeddedWallet`); both the standard and\n * HD variants contain this marker, so matching it as a substring identifies all\n * of them. This is an opaque backend value, matched verbatim — not a user-facing\n * concept.\n */\nconst LEGACY_EMBEDDED_WALLET_PROVIDER_KEY = 'turnkey';\n\n/**\n * Returns whether a wallet account is a legacy Dynamic embedded wallet that\n * requires an upgrade to Dynamic WaaS.\n *\n * Shared predicate behind both the imperative {@link getWalletsRequiringUpgrade}\n * getter and the reactive `useWalletsRequiringUpgrade` hook, so the definition\n * of \"requires upgrade\" lives in exactly one place.\n *\n * @example\n * ```ts\n * const upgradeable = walletAccounts.filter(walletAccountRequiresUpgrade);\n * ```\n * @param walletAccount - The wallet account to test.\n * @returns True when the account is a legacy embedded wallet requiring an upgrade.\n * @see getWalletsRequiringUpgrade\n * @see hasWalletsRequiringUpgrade\n */\nexport const walletAccountRequiresUpgrade = (\n  walletAccount: WalletAccount\n): boolean =>\n  walletAccount.walletProviderKey.includes(\n    LEGACY_EMBEDDED_WALLET_PROVIDER_KEY\n  );\n","import {\n  type WalletAccount,\n  getDefaultClient,\n  getWalletAccounts,\n} from '@dynamic-labs-sdk/client';\n\nimport { walletAccountRequiresUpgrade } from '../walletAccountRequiresUpgrade';\n\n/**\n * Returns the current session's wallet accounts that are legacy Dynamic\n * embedded wallets requiring an upgrade to Dynamic WaaS.\n *\n * These are earlier-generation Dynamic embedded wallets that predate Dynamic\n * WaaS (the current TSS-MPC embedded wallet) and can be upgraded to it. Use this\n * when you need the accounts themselves — for example to render only the\n * upgrade entry points on those wallets. Already-upgraded Dynamic WaaS accounts\n * are never returned. For a simple boolean check, use\n * {@link hasWalletsRequiringUpgrade}.\n *\n * @example\n * ```ts\n * const walletsRequiringUpgrade = getWalletsRequiringUpgrade();\n * if (walletsRequiringUpgrade.length > 0) {\n *   promptUpgrade(walletsRequiringUpgrade);\n * }\n * ```\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns The wallet accounts requiring an upgrade to Dynamic WaaS (empty when none).\n * @see hasWalletsRequiringUpgrade\n * @see startUpgradeRedirect\n */\nexport const getWalletsRequiringUpgrade = (\n  client = getDefaultClient()\n): WalletAccount[] =>\n  getWalletAccounts(client).filter(walletAccountRequiresUpgrade);\n","import { getDefaultClient } from '@dynamic-labs-sdk/client';\n\nimport { getWalletsRequiringUpgrade } from '../getWalletsRequiringUpgrade';\n\n/**\n * Returns whether the current session has any legacy Dynamic embedded wallet\n * that requires an upgrade to Dynamic WaaS.\n *\n * A boolean convenience over {@link getWalletsRequiringUpgrade} for the common\n * case where you only need to decide whether to surface the upgrade flow (e.g.\n * show a banner or gate a wallet's actions) rather than act on the specific\n * accounts.\n *\n * @example\n * ```ts\n * if (hasWalletsRequiringUpgrade()) {\n *   showUpgradeToWaasBanner();\n * }\n * ```\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns True when at least one wallet account requires an upgrade to Dynamic WaaS, false otherwise.\n * @see getWalletsRequiringUpgrade\n * @see startUpgradeRedirect\n */\nexport const hasWalletsRequiringUpgrade = (\n  client = getDefaultClient()\n): boolean => getWalletsRequiringUpgrade(client).length > 0;\n","import { assertPackageVersion } from '@dynamic-labs-sdk/assert-package-version';\n\nimport {\n  name as packageName,\n  version as packageVersion,\n} from '../../package.json';\n\nassertPackageVersion(packageName, packageVersion);\n\nexport { buildUpgradeUrl } from '../buildUpgradeUrl';\nexport { getWalletsRequiringUpgrade } from '../getWalletsRequiringUpgrade';\nexport { hasWalletsRequiringUpgrade } from '../hasWalletsRequiringUpgrade';\n"],"mappings":";;;;;;;;;;ACEA,IAAa,6BAAb,cAAgDA,mCAAU;CAExD,YAAY,SAAiB;AAC3B,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cAAc,4DAA4D;GAC3E,CAAC;;;;;;ACTN,IAAa,iCAAb,cAAoDC,mCAAU;CAE5D,YAAY,aAAqB;AAC/B,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cAAc,gEAAgE;GAC/E,CAAC;;;;;;;;;;;;ACCN,MAAa,uBACX;;;;;;AAOF,MAAa,+BAA+B;;;;;;AAO5C,MAAa,6BAA6B;;;;ACX1C,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CvB,MAAa,mBACX,EAAE,aAAa,UAAU,yBAAgD,EAAE,EAC3E,yDAA2B,KAChB;AAGX,KAAI,gBAAgB,UAAa,OAAO,WAAW,YACjD,OAAM,IAAIC,sDAA6B,kBAAkB;CAG3D,MAAM,sBAAsB,eAAe,OAAO,SAAS;AAQ3D,KAF0B,IAAI,IAAI,oBAAoB,CAEhC,aAAa,eACjC,OAAM,IAAI,+BAA+B,oBAAoB;CAS/D,MAAM,MAAM,IAAI,IAAI,QAAQ;AAE5B,KAAI,IAAI,aAAa,eACnB,OAAM,IAAI,2BAA2B,QAAQ;CAG/C,MAAM,EAAE,6DAA0B,OAAO;AAEzC,KAAI,aAAa,IAAI,8BAA8B,cAAc;AACjE,KAAI,aAAa,IAAI,4BAA4B,oBAAoB;AAErE,QAAO,IAAI,UAAU;;;;;;;;;;;;;;ACxFvB,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;AAmB5C,MAAa,gCACX,kBAEA,cAAc,kBAAkB,SAC9B,oCACD;;;;;;;;;;;;;;;;;;;;;;;;;;;ACJH,MAAa,8BACX,yDAA2B,qDAET,OAAO,CAAC,OAAO,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;ACVhE,MAAa,8BACX,yDAA2B,KACf,2BAA2B,OAAO,CAAC,SAAS;;;;mECnBrCC,MAAaC,QAAe"}
+{"version":3,"file":"index.cjs","names":["getWalletsRequiringUpgrade","buildUpgradeUrl","BaseError","buildUpgradeUrl","resolveCompleted: ((outcome: WalletUpgradeOutcome) => void) | undefined","rejectCompleted: ((reason: UpgradeIframeClosedError) => void) | undefined","subscribeToUpgradeCompletion","packageName","packageVersion"],"sources":["../src/hasWalletsRequiringUpgrade/hasWalletsRequiringUpgrade.ts","../src/startUpgradeRedirect/startUpgradeRedirect.ts","../src/errors/UpgradeIframeClosedError.ts","../src/openUpgradeIframe/openUpgradeIframe.ts","../src/exports/index.ts"],"sourcesContent":["import { getDefaultClient } from '@dynamic-labs-sdk/client';\n\nimport { getWalletsRequiringUpgrade } from '../getWalletsRequiringUpgrade';\n\n/**\n * Returns whether the current session has any legacy Dynamic embedded wallet\n * that requires an upgrade to Dynamic WaaS.\n *\n * A boolean convenience over {@link getWalletsRequiringUpgrade} for the common\n * case where you only need to decide whether to surface the upgrade flow (e.g.\n * show a banner or gate a wallet's actions) rather than act on the specific\n * accounts.\n *\n * @example\n * ```ts\n * if (hasWalletsRequiringUpgrade()) {\n *   showUpgradeToWaasBanner();\n * }\n * ```\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns True when at least one wallet account requires an upgrade to Dynamic WaaS, false otherwise.\n * @see getWalletsRequiringUpgrade\n * @see startUpgradeRedirect\n */\nexport const hasWalletsRequiringUpgrade = (\n  client = getDefaultClient()\n): boolean => getWalletsRequiringUpgrade(client).length > 0;\n","import { getDefaultClient } from '@dynamic-labs-sdk/client';\nimport { getCore } from '@dynamic-labs-sdk/client/core';\n\nimport { buildUpgradeUrl } from '../buildUpgradeUrl';\n\ntype StartUpgradeRedirectParams = {\n  /**\n   * Base URL of the hosted upgrade app. Defaults to the production upgrade app;\n   * override it to target a local or preview build (e.g. during QA).\n   */\n  baseUrl?: string;\n  /**\n   * Absolute https URL the upgrade app returns to on completion. Defaults to\n   * the current page (`window.location.href`), so the outcome can be picked up\n   * by {@link consumeUpgradeRedirect} when the user lands back.\n   */\n  redirectUrl?: string;\n};\n\n/**\n * Starts the redirect upgrade path by navigating the top-level window to the\n * hosted upgrade app.\n *\n * Call this from an \"Upgrade\" button. The upgrade app runs full-page and, once\n * finished, returns the user to `redirectUrl` with the outcome encoded in the\n * URL — call {@link consumeUpgradeRedirect} on load to pick it up. The\n * environment id and return URL are derived from the client and current page,\n * so the common call is zero-arg.\n *\n * @example\n * ```ts\n * // on the \"Upgrade via redirect\" button\n * await startUpgradeRedirect();\n * ```\n * @param [params] - Options for the redirect.\n * @param [params.redirectUrl] - Absolute https return URL; defaults to `window.location.href`.\n * @param [params.baseUrl] - Upgrade app base URL; defaults to the production app.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns A promise that resolves once navigation has been initiated.\n * @see consumeUpgradeRedirect\n * @see buildUpgradeUrl\n */\nexport const startUpgradeRedirect = async (\n  params: StartUpgradeRedirectParams = {},\n  client = getDefaultClient()\n): Promise<void> =>\n  getCore(client).navigate(buildUpgradeUrl(params, client));\n","import { BaseError } from '@dynamic-labs-sdk/client';\n\nexport class UpgradeIframeClosedError extends BaseError {\n  constructor() {\n    super({\n      cause: null,\n      code: 'upgrade_iframe_closed_error',\n      docsUrl: null,\n      name: 'UpgradeIframeClosedError',\n      shortMessage: 'Upgrade iframe was closed before the upgrade completed',\n    });\n  }\n}\n","/* eslint-disable no-restricted-globals */\n\nimport { getDefaultClient } from '@dynamic-labs-sdk/client';\n\nimport { buildUpgradeUrl } from '../buildUpgradeUrl';\nimport { UpgradeIframeClosedError } from '../errors/UpgradeIframeClosedError';\nimport { subscribeToUpgradeCompletion } from '../subscribeToUpgradeCompletion';\nimport type { WalletUpgradeOutcome } from '../upgradeAppContract';\nimport type {\n  OpenUpgradeIframeParams,\n  UpgradeIframeSession,\n} from './openUpgradeIframe.types';\n\nexport type { UpgradeIframeSession } from './openUpgradeIframe.types';\n\n// Permissions the upgrade app needs inside the iframe: clipboard writes plus\n// passkey (WebAuthn) get/create, which the embedded wallet upgrade relies on.\nconst UPGRADE_IFRAME_ALLOW =\n  'clipboard-write; publickey-credentials-get *; publickey-credentials-create *';\n\nconst UPGRADE_IFRAME_TITLE = 'Dynamic embedded wallet upgrade';\n\n/**\n * Runs the embedded upgrade path by mounting the hosted upgrade app in an\n * iframe inside a container you provide.\n *\n * The package renders no UI of its own: pass the element of your modal/sheet\n * and it appends the iframe, wires the origin-checked completion handshake, and\n * refreshes the session on success. `completed` resolves with the outcome once\n * the app reports back; call `close()` when the user dismisses the surface (or\n * after completion) to remove the iframe and detach the listener. Closing\n * before completion rejects `completed` with {@link UpgradeIframeClosedError}\n * so awaiters don't hang — wrap `await session.completed` in try/catch if you\n * allow early dismissal. For React Native or custom mounts, use\n * {@link subscribeToUpgradeCompletion} with {@link buildUpgradeUrl} instead.\n *\n * @example\n * ```ts\n * const session = openUpgradeIframe({ container: sheetBodyEl });\n * const { status } = await session.completed;\n * session.close();\n * ```\n * @param params - Iframe options.\n * @param params.container - Element the upgrade iframe is appended into.\n * @param [params.redirectUrl] - Absolute https completion URL; defaults to `window.location.href`.\n * @param [params.baseUrl] - Upgrade app base URL; defaults to the production app.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns A session handle exposing the `iframe`, a `close` function, and the `completed` promise.\n * @see subscribeToUpgradeCompletion\n * @see buildUpgradeUrl\n */\nexport const openUpgradeIframe = (\n  { container, redirectUrl, baseUrl }: OpenUpgradeIframeParams,\n  client = getDefaultClient()\n): UpgradeIframeSession => {\n  const iframe = document.createElement('iframe');\n  iframe.src = buildUpgradeUrl({ baseUrl, redirectUrl }, client);\n  iframe.title = UPGRADE_IFRAME_TITLE;\n  iframe.setAttribute('allow', UPGRADE_IFRAME_ALLOW);\n\n  container.appendChild(iframe);\n\n  // Executor runs synchronously, so both settlers are assigned before the\n  // subscription below (or `close`) can ever fire.\n  let resolveCompleted: ((outcome: WalletUpgradeOutcome) => void) | undefined;\n  let rejectCompleted: ((reason: UpgradeIframeClosedError) => void) | undefined;\n  const completed = new Promise<WalletUpgradeOutcome>((resolve, reject) => {\n    resolveCompleted = resolve;\n    rejectCompleted = reject;\n  });\n\n  // Callers may use `close()` purely for teardown and never await `completed`.\n  // Attach a no-op catch so an early-close rejection is treated as handled\n  // globally (no unhandled-rejection noise); a caller that does await\n  // `completed` still receives the rejection in its own context.\n  completed.catch(() => undefined);\n\n  // Set the instant a valid completion message arrives — before the async\n  // session refresh resolves `completed` via `onComplete`. `close()` checks\n  // this so dismissing the surface during that refresh window does not reject a\n  // promise for an upgrade that already succeeded.\n  let hasReceivedCompletion = false;\n\n  const unsubscribe = subscribeToUpgradeCompletion(\n    {\n      baseUrl,\n      onComplete: (outcome) => resolveCompleted?.(outcome),\n      onReceived: () => {\n        hasReceivedCompletion = true;\n      },\n    },\n    client\n  );\n\n  const close = () => {\n    unsubscribe();\n    iframe.remove();\n    // Reject `completed` only as a genuine cancellation — i.e. no completion\n    // has been received yet — so anything awaiting it doesn't hang forever. If\n    // a completion already arrived, `onComplete` (after the refresh) resolves\n    // `completed` with the real outcome, so we must not reject here.\n    if (!hasReceivedCompletion) {\n      rejectCompleted?.(new UpgradeIframeClosedError());\n    }\n  };\n\n  return { close, completed, iframe };\n};\n","import { assertPackageVersion } from '@dynamic-labs-sdk/assert-package-version';\n\nimport {\n  name as packageName,\n  version as packageVersion,\n} from '../../package.json';\n\nassertPackageVersion(packageName, packageVersion);\n\nexport { buildUpgradeUrl } from '../buildUpgradeUrl';\nexport { getWalletsRequiringUpgrade } from '../getWalletsRequiringUpgrade';\nexport { hasWalletsRequiringUpgrade } from '../hasWalletsRequiringUpgrade';\nexport { startUpgradeRedirect } from '../startUpgradeRedirect';\nexport {\n  consumeUpgradeRedirect,\n  type ConsumeUpgradeRedirectParams,\n} from '../consumeUpgradeRedirect';\nexport { subscribeToUpgradeCompletion } from '../subscribeToUpgradeCompletion';\nexport { openUpgradeIframe } from '../openUpgradeIframe';\nexport type { UpgradeIframeSession } from '../openUpgradeIframe';\nexport type {\n  WalletUpgradeOutcome,\n  WalletUpgradeStatus,\n} from '../upgradeAppContract';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAwBA,MAAa,8BACX,yDAA2B,KACfA,gEAA2B,OAAO,CAAC,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;ACgB1D,MAAa,uBAAuB,OAClC,SAAqC,EAAE,EACvC,yDAA2B,gDAEnB,OAAO,CAAC,SAASC,qDAAgB,QAAQ,OAAO,CAAC;;;;AC5C3D,IAAa,2BAAb,cAA8CC,mCAAU;CACtD,cAAc;AACZ,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cAAc;GACf,CAAC;;;;;;ACON,MAAM,uBACJ;AAEF,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+B7B,MAAa,qBACX,EAAE,WAAW,aAAa,WAC1B,yDAA2B,KACF;CACzB,MAAM,SAAS,SAAS,cAAc,SAAS;AAC/C,QAAO,MAAMC,qDAAgB;EAAE;EAAS;EAAa,EAAE,OAAO;AAC9D,QAAO,QAAQ;AACf,QAAO,aAAa,SAAS,qBAAqB;AAElD,WAAU,YAAY,OAAO;CAI7B,IAAIC;CACJ,IAAIC;CACJ,MAAM,YAAY,IAAI,SAA+B,SAAS,WAAW;AACvE,qBAAmB;AACnB,oBAAkB;GAClB;AAMF,WAAU,YAAY,OAAU;CAMhC,IAAI,wBAAwB;CAE5B,MAAM,cAAcC,kEAClB;EACE;EACA,aAAa,YAAY,mBAAmB,QAAQ;EACpD,kBAAkB;AAChB,2BAAwB;;EAE3B,EACD,OACD;CAED,MAAM,cAAc;AAClB,eAAa;AACb,SAAO,QAAQ;AAKf,MAAI,CAAC,sBACH,mBAAkB,IAAI,0BAA0B,CAAC;;AAIrD,QAAO;EAAE;EAAO;EAAW;EAAQ;;;;;mECnGhBC,2CAAaC,6CAAe"}