@dynamic-labs-sdk/legacy-embedded-wallet-upgrade 1.22.1 → 1.23.1

package/dist/clearUpgradeRedirectParams/clearUpgradeRedirectParams.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Removes the upgrade outcome parameter (`dynamicWaasMigrationStatus`) that the
+ * upgrade app appends to the return URL from the browser's current URL, leaving
+ * every other query parameter, the path, and the hash untouched.
+ *
+ * Call this once you have handled the outcome from `consumeUpgradeRedirect` so a
+ * page refresh does not replay it. `consumeUpgradeRedirect` never touches
+ * browser history, so clearing the param is your responsibility — this helper
+ * does it in one call, mirroring `clearSocialRedirectParams` and
+ * `clearDeviceRegistrationRedirectParams`. Unlike clearing the whole query
+ * string, it preserves any of your own parameters on the callback URL.
+ *
+ * This reads and rewrites `window.location`, so it can only run in the browser.
+ * Calling it during server-side rendering (no `window`) throws
+ * `UnavailableInServerSideError`. On React Native there is no browser address
+ * bar to clean — you own your navigation state — so a `.native` build throws
+ * instead.
+ *
+ * @example
+ * ```ts
+ * const outcome = await consumeUpgradeRedirect({ url: window.location.href });
+ * if (outcome) {
+ *   handleOutcome(outcome);
+ *   clearUpgradeRedirectParams();
+ * }
+ * ```
+ * @returns Nothing. The current URL is rewritten in place via
+ * `window.history.replaceState`.
+ * @throws {UnavailableInServerSideError} When called during SSR (no `window`).
+ * @see consumeUpgradeRedirect
+ * @see startUpgradeRedirect
+ */
+export declare const clearUpgradeRedirectParams: () => void;
+//# sourceMappingURL=clearUpgradeRedirectParams.d.ts.map

package/dist/clearUpgradeRedirectParams/clearUpgradeRedirectParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clearUpgradeRedirectParams.d.ts","sourceRoot":"","sources":["../../src/clearUpgradeRedirectParams/clearUpgradeRedirectParams.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,0BAA0B,QAAO,IAU7C,CAAC"}

package/dist/clearUpgradeRedirectParams/index.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/clearUpgradeRedirectParams/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/errors/UpgradePopupBlockedError.d.ts

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

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

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

package/dist/errors/UpgradePopupClosedError.d.ts

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

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

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

package/dist/exports/index.d.ts

@@ -3,8 +3,11 @@ export { getWalletsRequiringUpgrade } from '../getWalletsRequiringUpgrade';
 export { hasWalletsRequiringUpgrade } from '../hasWalletsRequiringUpgrade';
 export { startUpgradeRedirect } from '../startUpgradeRedirect';
 export { consumeUpgradeRedirect, type ConsumeUpgradeRedirectParams, } from '../consumeUpgradeRedirect';
+export { clearUpgradeRedirectParams } from '../clearUpgradeRedirectParams';
 export { subscribeToUpgradeCompletion } from '../subscribeToUpgradeCompletion';
 export { openUpgradeIframe } from '../openUpgradeIframe';
 export type { UpgradeIframeSession } from '../openUpgradeIframe';
+export { openUpgradePopup } from '../openUpgradePopup';
+export type { UpgradePopupSession } from '../openUpgradePopup';
 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;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"}
+{"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,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,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,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,YAAY,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC"}

package/dist/exports/react.d.ts

@@ -2,4 +2,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';
+export { useUpgradePopup, type UseUpgradePopupParams, type UseUpgradePopupResult, } from '../react/useUpgradePopup';
 //# sourceMappingURL=react.d.ts.map

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

@@ -1 +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"}
+{"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;AACnC,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B,MAAM,0BAA0B,CAAC"}

package/dist/index.cjs

@@ -1,4 +1,4 @@
-const require_subscribeToUpgradeCompletion = require('./subscribeToUpgradeCompletion-CjqiLYs5.cjs');
+const require_openUpgradePopup = require('./openUpgradePopup-DuGh1T8k.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");
@@ -24,7 +24,7 @@ let _dynamic_labs_sdk_client_core = require("@dynamic-labs-sdk/client/core");
 * @see getWalletsRequiringUpgrade
 * @see startUpgradeRedirect
 */
-const hasWalletsRequiringUpgrade = (client = (0, _dynamic_labs_sdk_client.getDefaultClient)()) => require_subscribeToUpgradeCompletion.getWalletsRequiringUpgrade(client).length > 0;
+const hasWalletsRequiringUpgrade = (client = (0, _dynamic_labs_sdk_client.getDefaultClient)()) => require_openUpgradePopup.getWalletsRequiringUpgrade(client).length > 0;
 
 //#endregion
 //#region src/startUpgradeRedirect/startUpgradeRedirect.ts
@@ -51,7 +51,7 @@ const hasWalletsRequiringUpgrade = (client = (0, _dynamic_labs_sdk_client.getDef
 * @see consumeUpgradeRedirect
 * @see buildUpgradeUrl
 */
-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));
+const startUpgradeRedirect = async (params = {}, client = (0, _dynamic_labs_sdk_client.getDefaultClient)()) => (0, _dynamic_labs_sdk_client_core.getCore)(client).navigate(require_openUpgradePopup.buildUpgradeUrl(params, client));
 
 //#endregion
 //#region src/errors/UpgradeIframeClosedError.ts
@@ -102,7 +102,7 @@ const UPGRADE_IFRAME_TITLE = "Dynamic embedded wallet upgrade";
 */
 const openUpgradeIframe = ({ container, redirectUrl, baseUrl }, client = (0, _dynamic_labs_sdk_client.getDefaultClient)()) => {
 	const iframe = document.createElement("iframe");
-	iframe.src = require_subscribeToUpgradeCompletion.buildUpgradeUrl({
+	iframe.src = require_openUpgradePopup.buildUpgradeUrl({
 		baseUrl,
 		redirectUrl
 	}, client);
@@ -117,7 +117,7 @@ const openUpgradeIframe = ({ container, redirectUrl, baseUrl }, client = (0, _dy
 	});
 	completed.catch(() => void 0);
 	let hasReceivedCompletion = false;
-	const unsubscribe = require_subscribeToUpgradeCompletion.subscribeToUpgradeCompletion({
+	const unsubscribe = require_openUpgradePopup.subscribeToUpgradeCompletion({
 		baseUrl,
 		onComplete: (outcome) => resolveCompleted?.(outcome),
 		onReceived: () => {
@@ -138,14 +138,16 @@ const openUpgradeIframe = ({ container, redirectUrl, baseUrl }, client = (0, _dy
 
 //#endregion
 //#region src/exports/index.ts
-(0, _dynamic_labs_sdk_assert_package_version.assertPackageVersion)(require_subscribeToUpgradeCompletion.name, require_subscribeToUpgradeCompletion.version);
+(0, _dynamic_labs_sdk_assert_package_version.assertPackageVersion)(require_openUpgradePopup.name, require_openUpgradePopup.version);
 
 //#endregion
-exports.buildUpgradeUrl = require_subscribeToUpgradeCompletion.buildUpgradeUrl;
-exports.consumeUpgradeRedirect = require_subscribeToUpgradeCompletion.consumeUpgradeRedirect;
-exports.getWalletsRequiringUpgrade = require_subscribeToUpgradeCompletion.getWalletsRequiringUpgrade;
+exports.buildUpgradeUrl = require_openUpgradePopup.buildUpgradeUrl;
+exports.clearUpgradeRedirectParams = require_openUpgradePopup.clearUpgradeRedirectParams;
+exports.consumeUpgradeRedirect = require_openUpgradePopup.consumeUpgradeRedirect;
+exports.getWalletsRequiringUpgrade = require_openUpgradePopup.getWalletsRequiringUpgrade;
 exports.hasWalletsRequiringUpgrade = hasWalletsRequiringUpgrade;
 exports.openUpgradeIframe = openUpgradeIframe;
+exports.openUpgradePopup = require_openUpgradePopup.openUpgradePopup;
 exports.startUpgradeRedirect = startUpgradeRedirect;
-exports.subscribeToUpgradeCompletion = require_subscribeToUpgradeCompletion.subscribeToUpgradeCompletion;
+exports.subscribeToUpgradeCompletion = require_openUpgradePopup.subscribeToUpgradeCompletion;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"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"}
+{"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 { clearUpgradeRedirectParams } from '../clearUpgradeRedirectParams';\nexport { subscribeToUpgradeCompletion } from '../subscribeToUpgradeCompletion';\nexport { openUpgradeIframe } from '../openUpgradeIframe';\nexport type { UpgradeIframeSession } from '../openUpgradeIframe';\nexport { openUpgradePopup } from '../openUpgradePopup';\nexport type { UpgradePopupSession } from '../openUpgradePopup';\nexport type {\n  WalletUpgradeOutcome,\n  WalletUpgradeStatus,\n} from '../upgradeAppContract';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAwBA,MAAa,8BACX,yDAA2B,KACfA,oDAA2B,OAAO,CAAC,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;ACgB1D,MAAa,uBAAuB,OAClC,SAAqC,EAAE,EACvC,yDAA2B,gDAEnB,OAAO,CAAC,SAASC,yCAAgB,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,yCAAgB;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,sDAClB;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,+BAAaC,iCAAe"}

package/dist/index.esm.js

@@ -1,4 +1,4 @@
-import { i as buildUpgradeUrl, n as consumeUpgradeRedirect, o as name, r as getWalletsRequiringUpgrade, s as version, t as subscribeToUpgradeCompletion } from "./subscribeToUpgradeCompletion-BuoizMF2.esm.js";
+import { a as getWalletsRequiringUpgrade, c as version, i as consumeUpgradeRedirect, n as subscribeToUpgradeCompletion, o as buildUpgradeUrl, r as clearUpgradeRedirectParams, s as name, t as openUpgradePopup } from "./openUpgradePopup-DNe06for.esm.js";
 import { assertPackageVersion } from "@dynamic-labs-sdk/assert-package-version";
 import { BaseError, getDefaultClient } from "@dynamic-labs-sdk/client";
 import { getCore } from "@dynamic-labs-sdk/client/core";
@@ -141,5 +141,5 @@ const openUpgradeIframe = ({ container, redirectUrl, baseUrl }, client = getDefa
 assertPackageVersion(name, version);
 
 //#endregion
-export { buildUpgradeUrl, consumeUpgradeRedirect, getWalletsRequiringUpgrade, hasWalletsRequiringUpgrade, openUpgradeIframe, startUpgradeRedirect, subscribeToUpgradeCompletion };
+export { buildUpgradeUrl, clearUpgradeRedirectParams, consumeUpgradeRedirect, getWalletsRequiringUpgrade, hasWalletsRequiringUpgrade, openUpgradeIframe, openUpgradePopup, startUpgradeRedirect, subscribeToUpgradeCompletion };
 //# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","names":["resolveCompleted: ((outcome: WalletUpgradeOutcome) => void) | undefined","rejectCompleted: ((reason: UpgradeIframeClosedError) => void) | undefined","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,SAAS,kBAAkB,KACf,2BAA2B,OAAO,CAAC,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;ACgB1D,MAAa,uBAAuB,OAClC,SAAqC,EAAE,EACvC,SAAS,kBAAkB,KAE3B,QAAQ,OAAO,CAAC,SAAS,gBAAgB,QAAQ,OAAO,CAAC;;;;AC5C3D,IAAa,2BAAb,cAA8C,UAAU;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,SAAS,kBAAkB,KACF;CACzB,MAAM,SAAS,SAAS,cAAc,SAAS;AAC/C,QAAO,MAAM,gBAAgB;EAAE;EAAS;EAAa,EAAE,OAAO;AAC9D,QAAO,QAAQ;AACf,QAAO,aAAa,SAAS,qBAAqB;AAElD,WAAU,YAAY,OAAO;CAI7B,IAAIA;CACJ,IAAIC;CACJ,MAAM,YAAY,IAAI,SAA+B,SAAS,WAAW;AACvE,qBAAmB;AACnB,oBAAkB;GAClB;AAMF,WAAU,YAAY,OAAU;CAMhC,IAAI,wBAAwB;CAE5B,MAAM,cAAc,6BAClB;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;;;;;ACnGrC,qBAAqBC,MAAaC,QAAe"}
+{"version":3,"file":"index.esm.js","names":["resolveCompleted: ((outcome: WalletUpgradeOutcome) => void) | undefined","rejectCompleted: ((reason: UpgradeIframeClosedError) => void) | undefined","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 { clearUpgradeRedirectParams } from '../clearUpgradeRedirectParams';\nexport { subscribeToUpgradeCompletion } from '../subscribeToUpgradeCompletion';\nexport { openUpgradeIframe } from '../openUpgradeIframe';\nexport type { UpgradeIframeSession } from '../openUpgradeIframe';\nexport { openUpgradePopup } from '../openUpgradePopup';\nexport type { UpgradePopupSession } from '../openUpgradePopup';\nexport type {\n  WalletUpgradeOutcome,\n  WalletUpgradeStatus,\n} from '../upgradeAppContract';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAwBA,MAAa,8BACX,SAAS,kBAAkB,KACf,2BAA2B,OAAO,CAAC,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;ACgB1D,MAAa,uBAAuB,OAClC,SAAqC,EAAE,EACvC,SAAS,kBAAkB,KAE3B,QAAQ,OAAO,CAAC,SAAS,gBAAgB,QAAQ,OAAO,CAAC;;;;AC5C3D,IAAa,2BAAb,cAA8C,UAAU;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,SAAS,kBAAkB,KACF;CACzB,MAAM,SAAS,SAAS,cAAc,SAAS;AAC/C,QAAO,MAAM,gBAAgB;EAAE;EAAS;EAAa,EAAE,OAAO;AAC9D,QAAO,QAAQ;AACf,QAAO,aAAa,SAAS,qBAAqB;AAElD,WAAU,YAAY,OAAO;CAI7B,IAAIA;CACJ,IAAIC;CACJ,MAAM,YAAY,IAAI,SAA+B,SAAS,WAAW;AACvE,qBAAmB;AACnB,oBAAkB;GAClB;AAMF,WAAU,YAAY,OAAU;CAMhC,IAAI,wBAAwB;CAE5B,MAAM,cAAc,6BAClB;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;;;;;ACnGrC,qBAAqBC,MAAaC,QAAe"}

package/dist/index.native.esm.js

@@ -1,10 +1,10 @@
 import { assertPackageVersion } from "@dynamic-labs-sdk/assert-package-version";
 import { BaseError, UnavailableInServerSideError, getDefaultClient, getWalletAccounts, refreshAuth } from "@dynamic-labs-sdk/client";
-import { getCore } from "@dynamic-labs-sdk/client/core";
+import { MethodNotImplementedError, createDeferredPromise, getCore, isServerSideRendering } from "@dynamic-labs-sdk/client/core";
 
 //#region package.json
 var name = "@dynamic-labs-sdk/legacy-embedded-wallet-upgrade";
-var version = "1.22.1";
+var version = "1.23.1";
 
 //#endregion
 //#region src/errors/InvalidUpgradeBaseUrlError.ts
@@ -266,6 +266,21 @@ const consumeUpgradeRedirect = async ({ url }, client = getDefaultClient()) => {
 	return { status: UPGRADE_STATUS_ERROR };
 };
 
+//#endregion
+//#region src/clearUpgradeRedirectParams/clearUpgradeRedirectParams.native.ts
+/**
+* Not supported on React Native — there is no browser address bar to clean.
+* Mirrors `clearSocialRedirectParams` / `clearDeviceRegistrationRedirectParams`
+* on native.
+*
+* @returns Never. Always throws on React Native.
+* @throws {MethodNotImplementedError} Always on React Native.
+* @see consumeUpgradeRedirect
+*/
+const clearUpgradeRedirectParams = () => {
+	throw new MethodNotImplementedError("clearUpgradeRedirectParams");
+};
+
 //#endregion
 //#region src/subscribeToUpgradeCompletion/subscribeToUpgradeCompletion.ts
 const isUpgradeCompleteMessage = (data) => typeof data === "object" && data !== null && "type" in data && data.type === UPGRADE_COMPLETE_MESSAGE_TYPE && "status" in data && (data.status === UPGRADE_STATUS_SUCCESS || data.status === UPGRADE_STATUS_ERROR);
@@ -356,10 +371,116 @@ const openUpgradeIframe = ({ container, redirectUrl, baseUrl }, client = getDefa
 	throw new UpgradeIframeUnavailableInReactNativeError();
 };
 
+//#endregion
+//#region src/errors/UpgradePopupBlockedError.ts
+var UpgradePopupBlockedError = class extends BaseError {
+	constructor() {
+		super({
+			cause: null,
+			code: "upgrade_popup_blocked_error",
+			docsUrl: null,
+			name: "UpgradePopupBlockedError",
+			shortMessage: "Upgrade popup was blocked by the browser. Call openUpgradePopup directly from a user gesture (e.g. a click handler) so the browser allows the window to open."
+		});
+	}
+};
+
+//#endregion
+//#region src/errors/UpgradePopupClosedError.ts
+var UpgradePopupClosedError = class extends BaseError {
+	constructor() {
+		super({
+			cause: null,
+			code: "upgrade_popup_closed_error",
+			docsUrl: null,
+			name: "UpgradePopupClosedError",
+			shortMessage: "Upgrade popup was closed before the upgrade completed"
+		});
+	}
+};
+
+//#endregion
+//#region src/openUpgradePopup/openUpgradePopup.ts
+const UPGRADE_POPUP_TARGET = "dynamic-embedded-wallet-upgrade";
+const DEFAULT_WINDOW_FEATURES = "popup=yes,width=420,height=640";
+const POPUP_CLOSED_POLL_INTERVAL_MS = 500;
+/**
+* Runs the upgrade path in a browser popup window.
+*
+* Opens the hosted upgrade app with `window.open`, wires the same
+* origin-checked completion handshake as {@link openUpgradeIframe}, and
+* refreshes the session on success. `completed` resolves with the outcome once
+* the app reports back; it rejects with {@link UpgradePopupClosedError} if the
+* user closes the popup first. Because popup blockers reject windows opened
+* outside a user gesture, **call this synchronously from a click handler** — do
+* no `await` before it. If the browser blocks the popup (window.open returns
+* `null`), it throws {@link UpgradePopupBlockedError} synchronously.
+*
+* Prefer {@link openUpgradeIframe} when you want the flow embedded in your own
+* modal/sheet; use the popup when a separate window is preferable.
+*
+* @example
+* ```ts
+* // in a click handler — no awaits before openUpgradePopup
+* const session = openUpgradePopup();
+* try {
+*   const { status } = await session.completed;
+* } catch (error) {
+*   // UpgradePopupClosedError when the user dismissed the popup
+* }
+* ```
+* @param [params] - Popup options.
+* @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 [params.webOptions.popupFeatures] - `window.open` feature string; defaults to a small window.
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns A session handle exposing a `close` function and the `completed` promise.
+* @throws {UpgradePopupBlockedError} When the browser blocks the popup (`window.open` returns null).
+* @throws {UnavailableInServerSideError} When called during SSR (no window to open from).
+* @see openUpgradeIframe
+* @see subscribeToUpgradeCompletion
+*/
+const openUpgradePopup = ({ baseUrl, redirectUrl, webOptions } = {}, client = getDefaultClient()) => {
+	if (isServerSideRendering()) throw new UnavailableInServerSideError("openUpgradePopup");
+	const url = buildUpgradeUrl({
+		baseUrl,
+		redirectUrl
+	}, client);
+	const popup = window.open(url, UPGRADE_POPUP_TARGET, webOptions?.popupFeatures ?? DEFAULT_WINDOW_FEATURES);
+	if (popup === null) throw new UpgradePopupBlockedError();
+	const completed = createDeferredPromise();
+	completed.promise.catch(() => void 0);
+	let hasReceivedCompletion = false;
+	const poll = {};
+	const unsubscribe = subscribeToUpgradeCompletion({
+		baseUrl,
+		onComplete: (outcome) => {
+			completed.resolve(outcome);
+			clearInterval(poll.id);
+		},
+		onReceived: () => {
+			hasReceivedCompletion = true;
+		}
+	}, client);
+	const close = () => {
+		unsubscribe();
+		clearInterval(poll.id);
+		if (!popup.closed) popup.close();
+		if (!hasReceivedCompletion) completed.reject(new UpgradePopupClosedError());
+	};
+	poll.id = setInterval(() => {
+		if (popup.closed) close();
+	}, POPUP_CLOSED_POLL_INTERVAL_MS);
+	return {
+		close,
+		completed: completed.promise
+	};
+};
+
 //#endregion
 //#region src/exports/index.ts
 assertPackageVersion(name, version);
 
 //#endregion
-export { buildUpgradeUrl, consumeUpgradeRedirect, getWalletsRequiringUpgrade, hasWalletsRequiringUpgrade, openUpgradeIframe, startUpgradeRedirect, subscribeToUpgradeCompletion };
+export { buildUpgradeUrl, clearUpgradeRedirectParams, consumeUpgradeRedirect, getWalletsRequiringUpgrade, hasWalletsRequiringUpgrade, openUpgradeIframe, openUpgradePopup, startUpgradeRedirect, subscribeToUpgradeCompletion };
 //# sourceMappingURL=index.native.esm.js.map