@seams/wallet 0.31.0 → 0.33.0

package/README.md

@@ -1,19 +1,19 @@
 # Seams Wallet SDK
 
-`@seams/wallet` **0.31.0** provides browser wallet lifecycle, NEAR and EVM-family
+`@seams/wallet` **0.33.0** provides browser wallet lifecycle, NEAR and EVM-family
 threshold signing, React components, and hosted wallet runtime assets.
 
 ## Install
 
 ```sh
-pnpm add @seams/wallet@0.31.0
+pnpm add @seams/wallet@0.33.0
 ```
 
 React integrations require `react@19.1.1` and `react-dom@19.1.1`. Import the provider and UI from
 `@seams/wallet/react` and its stylesheet from `@seams/wallet/react/styles`.
 Keep the application package, wallet-origin assets, and
-`@seams/wallet-server@0.31.0` on the matching release. The wallet iframe protocol
-is `20.0.0`. The application and wallet host must use the same protocol version.
+`@seams/wallet-server@0.33.0` on the matching release. The wallet iframe protocol
+is `21.0.0`. The application and wallet host must use the same protocol version.
 
 ## Current API
 
@@ -48,7 +48,7 @@ the challenge and its expiry. The application receives the typed challenge handl
 
 ## Application sessions and fresh owner approval
 
-SDK 0.31.0 accepts a handoff from an explicitly trusted application backend.
+SDK 0.33.0 accepts a handoff from an explicitly trusted application backend.
 Google and app-passkey login can use the same stable application user ID.
 Use `registration.registerOwnerWallet` for NEAR-only passkey onboarding and `near.prepareOwnerTransaction` for fresh approval of each transaction.
 These operations create no reusable signing authority.
@@ -57,7 +57,7 @@ See the [application-session guide](https://wallet.seams.sh/docs/guides/applicat
 
 ## Bring your own Google authentication
 
-SDK 0.31.0 can reuse an application's Google ID token to open associated wallet settings.
+SDK 0.33.0 can reuse an application's Google ID token to open associated wallet settings.
 Configure the environment's Google client ID and let the owner associate their wallet once.
 Then pass the token after the application's existing Google login:
 

package/dist/.build-inputs.sha256

@@ -1 +1 @@
-3936d9b6309a2cc5845549ca8b821c30b7501bd7905c1f843f21f042548b955e
+561810bf25a0d5d6712eade5eca689e24019e52460e1671199f624c75bb501d3

package/dist/esm/SeamsWeb/walletIframe/host/ui/auth-menu/AuthMenuFooter.js

@@ -2,7 +2,7 @@ import { WalletText } from "../../../../../core/signingEngine/uiConfirm/ui/preac
 import { SeamsWordmark } from "../../../../../core/signingEngine/uiConfirm/ui/preact/SeamsWordmark.js";
 import { alertIcon } from "./icons.js";
 import { Component } from "preact";
-import { jsx, jsxs } from "preact/jsx-runtime";
+import { Fragment as Fragment$1, jsx, jsxs } from "preact/jsx-runtime";
 //#region src/SeamsWeb/walletIframe/host/ui/auth-menu/AuthMenuFooter.tsx
 /** @jsxImportSource preact */
 /**
@@ -12,20 +12,17 @@ import { jsx, jsxs } from "preact/jsx-runtime";
 var AuthMenuFooter = class extends Component {
 	shownNotice = "";
 	render() {
-		const { notice, onRetry } = this.props;
+		const { onRetry, brand, connection } = this.props;
+		const notice = footerNotice(connection, this.props.notice);
 		if (notice) this.shownNotice = notice;
 		return /* @__PURE__ */ jsxs("div", {
 			class: "seams-auth-footer",
 			"data-state": notice ? "notice" : "brand",
 			children: [
-				/* @__PURE__ */ jsxs("div", {
+				/* @__PURE__ */ jsx("div", {
 					class: "seams-auth-footer-brand",
 					"aria-hidden": notice ? "true" : void 0,
-					children: [
-						/* @__PURE__ */ jsx("span", { children: /* @__PURE__ */ jsx(WalletText, { message: "Secured by" }) }),
-						" ",
-						/* @__PURE__ */ jsx(SeamsWordmark, {})
-					]
+					children: renderBrand(brand, connection)
 				}),
 				/* @__PURE__ */ jsxs("div", {
 					class: "seams-auth-footer-notice",
@@ -34,15 +31,16 @@ var AuthMenuFooter = class extends Component {
 						/* @__PURE__ */ jsx("span", {
 							class: "seams-auth-footer-text",
 							"aria-hidden": "true",
+							title: this.shownNotice,
 							children: /* @__PURE__ */ jsx(WalletText, { copy: this.shownNotice })
 						}),
-						/* @__PURE__ */ jsx("button", {
+						connection.kind === "idle" ? /* @__PURE__ */ jsx("button", {
 							class: "seams-auth-footer-action",
 							type: "button",
 							disabled: !notice,
 							onClick: onRetry,
 							children: /* @__PURE__ */ jsx(WalletText, { message: "Try again" })
-						})
+						}) : null
 					]
 				}),
 				notice ? /* @__PURE__ */ jsx("p", {
@@ -54,6 +52,36 @@ var AuthMenuFooter = class extends Component {
 		});
 	}
 };
+function footerNotice(connection, notice) {
+	switch (connection.kind) {
+		case "pending": return null;
+		case "failed": return connection.message;
+		case "idle": return notice;
+		default: return assertNever(connection);
+	}
+}
+function renderBrand(brand, connection) {
+	if (connection.kind === "pending") return /* @__PURE__ */ jsx("span", {
+		role: "status",
+		children: /* @__PURE__ */ jsx(WalletText, { copy: "Complete the request in your wallet." })
+	});
+	switch (brand.kind) {
+		case "custom": return /* @__PURE__ */ jsx("img", {
+			class: "seams-auth-footer-logo",
+			src: brand.logo,
+			alt: brand.name
+		});
+		case "seams": return /* @__PURE__ */ jsxs(Fragment$1, { children: [
+			/* @__PURE__ */ jsx("span", { children: /* @__PURE__ */ jsx(WalletText, { message: "Secured by" }) }),
+			" ",
+			/* @__PURE__ */ jsx(SeamsWordmark, {})
+		] });
+		default: return assertNever(brand);
+	}
+}
+function assertNever(value) {
+	throw new Error(`Unknown footer state: ${value}`);
+}
 //#endregion
 export { AuthMenuFooter };
 

package/dist/esm/SeamsWeb/walletIframe/host/ui/auth-menu/AuthMenuSurface.js

@@ -8,8 +8,9 @@ import { AUTH_MENU_WAITING_PROMPTS, isAuthMenuActionReady, isAuthMenuGoogleActio
 import { AUTH_MENU_ACCOUNT_LIST_ID, AUTH_MENU_TITLE_ID, accountGroups, accountSecondaryText, authViewKey, menuNotice, modeLabel, modeSwitchCopy, otpCodeDigits, passkeyButtonLabel, recoveryAnnouncement, recoveryBackLabel, recoveryCaretAtPoint, recoveryNavigationLocked, renderDemoEmailCode, renderOtpCodeDigit, savedAccountsTriggerLabel, selectedAccountPrimaryText, selectedLoginAccount } from "./presentation.js";
 import { PadlockIcon } from "../../../../../core/signingEngine/uiConfirm/ui/preact/PadlockIcon.js";
 import { blinkMenuItem } from "../../../../../utils/menuItemBlink.js";
-import { accountDropdownIcon, backIcon, chevronIcon, fingerprintIcon, googleIcon, linkDeviceIcon, linkFailedIcon, mailIcon, passkeyRingIcon, passkeySuccessIcon, recoveryIcon, rerollIcon } from "./icons.js";
+import { accountDropdownIcon, backIcon, fingerprintIcon, googleIcon, linkFailedIcon, mailIcon, passkeyRingIcon, passkeySuccessIcon, rerollIcon } from "./icons.js";
 import { AuthMenuFooter } from "./AuthMenuFooter.js";
+import { RecoveryOptions } from "./RecoveryOptions.js";
 import { linkDeviceDotRing, linkDeviceEmailOtpPresentation } from "./linkDeviceBadge.js";
 import { Component, Fragment } from "preact";
 import { Fragment as Fragment$1, jsx, jsxs } from "preact/jsx-runtime";
@@ -559,7 +560,9 @@ var AuthMenuSurface = class extends Component {
 				}),
 				/* @__PURE__ */ jsx(AuthMenuFooter, {
 					notice: menuNotice(viewModel),
-					onRetry: this.onNoticeRetry
+					onRetry: this.onNoticeRetry,
+					brand: this.props.footerBrand,
+					connection: this.props.walletConnection
 				})
 			]
 		}) });
@@ -569,31 +572,24 @@ var AuthMenuSurface = class extends Component {
 		if (viewModel.kind === "link_device") return this.renderLinkDevice(viewModel);
 		if (viewModel.kind === "google_otp_login") return this.renderGoogleOtp(viewModel);
 		if (viewModel.kind === "google_registration") return this.renderGoogleRegistration(viewModel);
-		return /* @__PURE__ */ jsxs(Fragment$1, { children: [
-			this.renderMenuHeader(viewModel),
-			/* @__PURE__ */ jsxs("fieldset", {
-				class: "seams-connection-controls",
-				disabled: this.props.walletConnection.kind === "pending",
-				children: [
-					this.renderPasskeyInput(viewModel),
-					this.renderAuthMethods(viewModel),
-					/* @__PURE__ */ jsx(WalletAlternativesSection, {
-						alternatives: this.props.walletAlternatives,
-						onIntent: this.props.onIntent
-					}),
-					this.renderOtherOptions(),
-					this.renderIntentSwitch(viewModel)
-				]
-			}),
-			this.props.walletConnection.kind === "pending" && /* @__PURE__ */ jsx("p", {
-				role: "status",
-				children: /* @__PURE__ */ jsx(WalletText, { copy: "Complete the request in your wallet." })
-			}),
-			this.props.walletConnection.kind === "failed" && /* @__PURE__ */ jsx("p", {
-				role: "alert",
-				children: this.props.walletConnection.message
-			})
-		] });
+		return /* @__PURE__ */ jsxs(Fragment$1, { children: [this.renderMenuHeader(viewModel), /* @__PURE__ */ jsxs("fieldset", {
+			class: "seams-connection-controls",
+			disabled: this.props.walletConnection.kind === "pending",
+			children: [
+				this.renderPasskeyInput(viewModel),
+				this.renderAuthMethods(viewModel),
+				/* @__PURE__ */ jsx(WalletAlternativesSection, {
+					alternatives: this.props.walletAlternatives,
+					onIntent: this.props.onIntent
+				}),
+				/* @__PURE__ */ jsx(RecoveryOptions, {
+					display: this.props.recoveryOptions,
+					onLinkDevice: this.onLinkDeviceOpen,
+					onRecovery: this.onRecoveryOpen
+				}),
+				this.renderIntentSwitch(viewModel)
+			]
+		})] });
 	}
 	renderMenuHeader(viewModel) {
 		const eyebrow = modeLabel(viewModel.mode);
@@ -803,46 +799,6 @@ var AuthMenuSurface = class extends Component {
 			]
 		}) });
 	}
-	renderOtherOptions() {
-		return /* @__PURE__ */ jsxs("details", {
-			class: "seams-menu-expander",
-			children: [/* @__PURE__ */ jsxs("summary", { children: [/* @__PURE__ */ jsx(WalletText, { copy: "Recover or link wallet" }), chevronIcon()] }), /* @__PURE__ */ jsxs("div", {
-				class: "seams-menu-options",
-				children: [/* @__PURE__ */ jsxs("button", {
-					class: "seams-menu-option",
-					type: "button",
-					onClick: this.onLinkDeviceOpen,
-					children: [
-						/* @__PURE__ */ jsx("span", {
-							class: "seams-menu-option-icon",
-							children: linkDeviceIcon()
-						}),
-						/* @__PURE__ */ jsxs("span", {
-							class: "seams-menu-option-text",
-							children: [/* @__PURE__ */ jsx(WalletText, { message: "Link this device" }), /* @__PURE__ */ jsx("small", { children: /* @__PURE__ */ jsx(WalletText, { message: "Scan a code with your other device" }) })]
-						}),
-						chevronIcon()
-					]
-				}), /* @__PURE__ */ jsxs("button", {
-					class: "seams-menu-option",
-					type: "button",
-					"data-recovery-action": true,
-					onClick: this.onRecoveryOpen,
-					children: [
-						/* @__PURE__ */ jsx("span", {
-							class: "seams-menu-option-icon",
-							children: recoveryIcon()
-						}),
-						/* @__PURE__ */ jsxs("span", {
-							class: "seams-menu-option-text",
-							children: [/* @__PURE__ */ jsx(WalletText, { message: "Recover wallet" }), /* @__PURE__ */ jsx("small", { children: /* @__PURE__ */ jsx(WalletText, { message: "Use your recovery code" }) })]
-						}),
-						chevronIcon()
-					]
-				})]
-			})]
-		});
-	}
 	renderRecovery(viewModel) {
 		if (viewModel.stage === "enter_code") {
 			const code = recoveryInputCharacters(viewModel.recoveryCode).slice(0, 32);

package/dist/esm/SeamsWeb/walletIframe/host/ui/auth-menu/RecoveryOptions.js

@@ -0,0 +1,60 @@
+import { WalletText } from "../../../../../core/signingEngine/uiConfirm/ui/preact/WalletLocale.js";
+import { chevronIcon, linkDeviceIcon, recoveryIcon } from "./icons.js";
+import { jsx, jsxs } from "preact/jsx-runtime";
+//#region src/SeamsWeb/walletIframe/host/ui/auth-menu/RecoveryOptions.tsx
+function RecoveryOptions({ display, onLinkDevice, onRecovery }) {
+	if (display === "hidden") return null;
+	const options = /* @__PURE__ */ jsxs("div", {
+		class: "seams-menu-options",
+		children: [/* @__PURE__ */ jsxs("button", {
+			class: "seams-menu-option",
+			type: "button",
+			onClick: onLinkDevice,
+			children: [
+				/* @__PURE__ */ jsx("span", {
+					class: "seams-menu-option-icon",
+					children: linkDeviceIcon()
+				}),
+				/* @__PURE__ */ jsxs("span", {
+					class: "seams-menu-option-text",
+					children: [/* @__PURE__ */ jsx(WalletText, { message: "Link this device" }), /* @__PURE__ */ jsx("small", { children: /* @__PURE__ */ jsx(WalletText, { message: "Scan a code with your other device" }) })]
+				}),
+				chevronIcon()
+			]
+		}), /* @__PURE__ */ jsxs("button", {
+			class: "seams-menu-option",
+			type: "button",
+			"data-recovery-action": true,
+			onClick: onRecovery,
+			children: [
+				/* @__PURE__ */ jsx("span", {
+					class: "seams-menu-option-icon",
+					children: recoveryIcon()
+				}),
+				/* @__PURE__ */ jsxs("span", {
+					class: "seams-menu-option-text",
+					children: [/* @__PURE__ */ jsx(WalletText, { message: "Recover wallet" }), /* @__PURE__ */ jsx("small", { children: /* @__PURE__ */ jsx(WalletText, { message: "Use your recovery code" }) })]
+				}),
+				chevronIcon()
+			]
+		})]
+	});
+	switch (display) {
+		case "expanded": return /* @__PURE__ */ jsxs("section", { children: [/* @__PURE__ */ jsx("div", {
+			class: "seams-menu-options-label",
+			children: /* @__PURE__ */ jsx(WalletText, { copy: "Recover or link wallet" })
+		}), options] });
+		case "collapsible": return /* @__PURE__ */ jsxs("details", {
+			class: "seams-menu-expander",
+			children: [/* @__PURE__ */ jsxs("summary", { children: [/* @__PURE__ */ jsx(WalletText, { copy: "Recover or link wallet" }), chevronIcon()] }), options]
+		});
+		default: return assertNever(display);
+	}
+}
+function assertNever(value) {
+	throw new Error(`Unknown recovery display: ${value}`);
+}
+//#endregion
+export { RecoveryOptions };
+
+//# sourceMappingURL=RecoveryOptions.js.map

package/dist/esm/SeamsWeb/walletIframe/host/ui/auth-menu/mountAuthMenuSurface.js

@@ -25,6 +25,8 @@ function authMenuStyles(document) {
 var MountedAuthMenuSurface = class {
 	element;
 	walletAlternatives;
+	recoveryOptions;
+	footerBrand;
 	walletConnection = { kind: "idle" };
 	viewModel;
 	styles;
@@ -32,6 +34,8 @@ var MountedAuthMenuSurface = class {
 	state;
 	constructor(input) {
 		this.walletAlternatives = input.walletAlternatives ?? emptyWalletAlternatives();
+		this.recoveryOptions = input.recoveryOptions ?? "collapsible";
+		this.footerBrand = input.footerBrand ?? { kind: "seams" };
 		this.viewModel = input.viewModel;
 		const document = input.parent.ownerDocument;
 		this.styles = authMenuStyles(document);
@@ -90,6 +94,8 @@ var MountedAuthMenuSurface = class {
 			element: this.element,
 			viewModel,
 			walletAlternatives: this.walletAlternatives,
+			recoveryOptions: this.recoveryOptions,
+			footerBrand: this.footerBrand,
 			walletConnection: this.walletConnection,
 			onIntent: this.state.onIntent,
 			styles: this.styles

package/dist/esm/SeamsWeb/walletIframe/shared/authMenuPresentation.js

@@ -0,0 +1,28 @@
+import { isPlainObject } from "../../../shared-ts/src/utils/validation.js";
+import { parseWalletImageUrl } from "../../../core/ui/walletIcon.js";
+//#region src/SeamsWeb/walletIframe/shared/authMenuPresentation.ts
+function parseAuthMenuRecoveryOptions(value) {
+	if (value === void 0) return "collapsible";
+	switch (value) {
+		case "collapsible": return "collapsible";
+		case "expanded": return "expanded";
+		case "hidden": return "hidden";
+		default: return null;
+	}
+}
+function parseAuthMenuFooterBrand(value) {
+	if (value === void 0) return { kind: "seams" };
+	if (!isPlainObject(value)) return null;
+	if (value.kind === "seams" && Object.keys(value).length === 1) return { kind: "seams" };
+	if (value.kind !== "custom" || Object.keys(value).length !== 3 || typeof value.name !== "string" || !value.name.trim() || value.name.length > 512) return null;
+	const logo = parseWalletImageUrl(value.logo);
+	return logo ? {
+		kind: "custom",
+		logo,
+		name: value.name.trim()
+	} : null;
+}
+//#endregion
+export { parseAuthMenuFooterBrand, parseAuthMenuRecoveryOptions };
+
+//# sourceMappingURL=authMenuPresentation.js.map

package/dist/esm/SeamsWeb/walletIframe/shared/messages.js

@@ -1,6 +1,7 @@
 import { isPlainObject } from "../../../shared-ts/src/utils/validation.js";
 import { parseWalletAuthMethodId, parseWalletId } from "../../../shared-ts/src/utils/domainIds.js";
 import { parseWalletSessionHome } from "../../../shared-ts/src/device-linking/activeWalletSession.js";
+import { parseAuthMenuFooterBrand, parseAuthMenuRecoveryOptions } from "./authMenuPresentation.js";
 import { walletIframeRequestIdFromBoundary } from "../../../core/types/walletIframeIdentity.js";
 import { emptyWalletAlternatives, parseWalletAlternatives } from "./walletAlternatives.js";
 //#region src/SeamsWeb/walletIframe/shared/messages.ts
@@ -211,7 +212,9 @@ function parseHostedAuthMenuOpenRequest(value) {
 		"showProgress",
 		"copy",
 		"enabledExternalProviders",
-		"walletAlternatives"
+		"walletAlternatives",
+		"recoveryOptions",
+		"footerBrand"
 	]) || !hasOnlyHostedAuthMenuCopyKeys(record.copy)) return null;
 	const authMenuSessionId = hostedAuthMenuSessionIdFromBoundary(record.authMenuSessionId);
 	const initialMode = parseAuthMenuMode(record.initialMode);
@@ -228,8 +231,10 @@ function parseHostedAuthMenuOpenRequest(value) {
 	} : null;
 	const registrationAccountInput = parseRegistrationAccountInput(record.registrationAccountInput);
 	const providers = parseExternalProviders(record.enabledExternalProviders);
+	const recoveryOptions = parseAuthMenuRecoveryOptions(record.recoveryOptions);
+	const footerBrand = parseAuthMenuFooterBrand(record.footerBrand);
 	const walletAlternatives = record.walletAlternatives === void 0 ? emptyWalletAlternatives() : parseWalletAlternatives(record.walletAlternatives);
-	if (!authMenuSessionId || !initialMode || !loginTarget || !registrationAccountInput || typeof record.showRegistrationInput !== "boolean" || typeof record.showProgress !== "boolean" || !providers || !walletAlternatives || !isWireSerializable(record.copy, /* @__PURE__ */ new Set(), true)) return null;
+	if (!authMenuSessionId || !initialMode || !loginTarget || !registrationAccountInput || typeof record.showRegistrationInput !== "boolean" || typeof record.showProgress !== "boolean" || !providers || !walletAlternatives || !recoveryOptions || !footerBrand || !isWireSerializable(record.copy, /* @__PURE__ */ new Set(), true)) return null;
 	return {
 		kind: "hosted_auth_menu_open_v1",
 		authMenuSessionId,
@@ -241,7 +246,9 @@ function parseHostedAuthMenuOpenRequest(value) {
 		showProgress: record.showProgress,
 		copy: normalizeHostedAuthMenuCopy(record.copy),
 		enabledExternalProviders: providers,
-		walletAlternatives
+		walletAlternatives,
+		recoveryOptions,
+		footerBrand
 	};
 }
 function buildHostedAuthMenuOpenRequest(args) {
@@ -257,11 +264,13 @@ function buildHostedAuthMenuOpenRequest(args) {
 		"showProgress",
 		"copy",
 		"enabledExternalProviders",
-		"walletAlternatives"
+		"walletAlternatives",
+		"recoveryOptions",
+		"footerBrand"
 	]) || args.copy !== void 0 && !hasOnlyHostedAuthMenuCopyKeys(args.copy)) throw new Error("Hosted auth-menu open configuration contains unsupported fields");
 	const parsedSessionId = hostedAuthMenuSessionIdFromBoundary(args.authMenuSessionId);
 	if (!parsedSessionId) throw new Error("authMenuSessionId must be a non-empty string");
-	const request = {
+	const parsed = parseHostedAuthMenuOpenRequest({
 		kind: "hosted_auth_menu_open_v1",
 		authMenuSessionId: parsedSessionId,
 		initialMode: args.initialMode ?? "login",
@@ -272,10 +281,12 @@ function buildHostedAuthMenuOpenRequest(args) {
 		showProgress: args.showProgress ?? false,
 		copy: normalizeHostedAuthMenuCopy(args.copy),
 		enabledExternalProviders: [...args.enabledExternalProviders ?? []],
-		walletAlternatives: args.walletAlternatives ?? emptyWalletAlternatives()
-	};
-	if (!parseHostedAuthMenuOpenRequest(request)) throw new Error("Hosted auth-menu open request is invalid");
-	return Object.freeze(request);
+		walletAlternatives: args.walletAlternatives ?? emptyWalletAlternatives(),
+		recoveryOptions: args.recoveryOptions ?? "collapsible",
+		footerBrand: args.footerBrand ?? { kind: "seams" }
+	});
+	if (!parsed) throw new Error("Hosted auth-menu open request is invalid");
+	return Object.freeze(parsed);
 }
 function parseHostedAuthMenuExternalAuthRequest(value) {
 	const record = recordFromBoundary(value);
@@ -484,7 +495,7 @@ function parseHostedAuthMenuOutcome(value) {
 		default: return null;
 	}
 }
-const WALLET_PROTOCOL_VERSION = "20.0.0";
+const WALLET_PROTOCOL_VERSION = "21.0.0";
 const WALLET_IFRAME_PROTOCOL_VERSION_MISMATCH = "WALLET_IFRAME_PROTOCOL_VERSION_MISMATCH";
 const HOSTED_WALLET_REDEMPTION_PAYLOAD_FIELDS = [
 	"home",

package/dist/esm/SeamsWeb/walletIframe/shared/walletAlternatives.js

@@ -1,5 +1,5 @@
 import { isPlainObject } from "../../../shared-ts/src/utils/validation.js";
-import { parseWalletDataIcon } from "../../../core/ui/walletIcon.js";
+import { parseWalletImageUrl } from "../../../core/ui/walletIcon.js";
 import { walletIframeRequestIdFromBoundary } from "../../../core/types/walletIframeIdentity.js";
 import { hostedAuthMenuSessionIdFromBoundary } from "./messages.js";
 //#region src/SeamsWeb/walletIframe/shared/walletAlternatives.ts
@@ -17,21 +17,11 @@ function parseWalletIcon(value) {
 		ok: true,
 		value: null
 	};
-	const dataIcon = parseWalletDataIcon(value);
-	if (dataIcon !== null) return {
+	const icon = parseWalletImageUrl(value);
+	return icon === null ? { ok: false } : {
 		ok: true,
-		value: dataIcon
+		value: icon
 	};
-	if (typeof value !== "string" || value.length > 131072) return { ok: false };
-	try {
-		if (new URL(value).protocol === "https:") return {
-			ok: true,
-			value
-		};
-	} catch {
-		return { ok: false };
-	}
-	return { ok: false };
 }
 function parseWalletRows(value, ids) {
 	if (!Array.isArray(value) || value.length > 32) return null;

package/dist/esm/core/ui/walletIcon.js

@@ -1,10 +1,18 @@
-//#region src/core/ui/walletIcon.ts
-const MAX_WALLET_ICON_LENGTH = 131072;
+function parseWalletImageUrl(value) {
+	const dataIcon = parseWalletDataIcon(value);
+	if (dataIcon !== null) return dataIcon;
+	if (typeof value !== "string" || value.length > 131072) return null;
+	try {
+		return new URL(value).protocol === "https:" ? value : null;
+	} catch {
+		return null;
+	}
+}
 function parseWalletDataIcon(value) {
 	if (typeof value !== "string" || value.length > 131072 || !/^data:image\/(?:png|webp|jpeg|svg\+xml)[;,]/i.test(value)) return null;
 	return value;
 }
 //#endregion
-export { MAX_WALLET_ICON_LENGTH, parseWalletDataIcon };
+export { parseWalletDataIcon, parseWalletImageUrl };
 
 //# sourceMappingURL=walletIcon.js.map

package/dist/esm/externalNear/controller.js

@@ -1,5 +1,6 @@
 import { createNearWalletProvider, nearWalletName } from "./wallets.js";
 import { connectedNear } from "./types.js";
+import { MeteorTransportUnavailableError } from "./meteorRequest.js";
 import { executionStatus, parseAccounts, parseSubmission, validateTransaction } from "./boundary.js";
 import { parseSignedMessage, validateMessage } from "./message.js";
 //#region src/externalNear/controller.ts
@@ -86,10 +87,10 @@ var ExternalNearController = class {
 				ok: true,
 				value: connection
 			};
-		} catch {
+		} catch (error) {
 			if (generation !== this.generation) return failure("connection_changed", "Wallet selection changed.");
 			this.disconnect();
-			return failure("unavailable", `${nearWalletName(wallet)} did not connect. Check the wallet and network, then try again.`);
+			return failure("unavailable", error instanceof MeteorTransportUnavailableError ? error.message : `${nearWalletName(wallet)} did not connect. Check the wallet and network, then try again.`);
 		} finally {
 			if (generation === this.generation) {
 				this.pending = false;

package/dist/esm/externalNear/meteor.js

@@ -3,8 +3,8 @@ import { base64Encode } from "../shared-ts/src/utils/base64.js";
 import { base58Decode } from "../shared-ts/src/utils/base58.js";
 import { isValidAccountId } from "../shared-ts/src/utils/near.js";
 import { ActionType, toActionArgsWasm } from "../shared-ts/src/near/actions.js";
-import { serialize } from "../node_modules/borsh/lib/esm/index.js";
 import { MeteorRequest, meteorTransportFromWindow } from "./meteorRequest.js";
+import { serialize } from "../node_modules/borsh/lib/esm/index.js";
 //#region src/externalNear/meteor.ts
 const transactionSchema = { struct: {
 	signerId: "string",

package/dist/esm/externalNear/meteorRequest.js

@@ -1,8 +1,14 @@
 import { isFunction, isPlainObject } from "../shared-ts/src/utils/validation.js";
 //#region src/externalNear/meteorRequest.ts
+var MeteorTransportUnavailableError = class extends Error {
+	constructor() {
+		super("Open the Meteor extension and allow access to this site, then try again.");
+		this.name = "MeteorTransportUnavailableError";
+	}
+};
 function meteorTransportFromWindow() {
 	const raw = Reflect.get(window, "meteorComV2");
-	if (!isPlainObject(raw) || !isFunction(raw.sendMessageDataAndRespond)) throw new Error("Meteor extension is not ready.");
+	if (!isPlainObject(raw) || !isFunction(raw.sendMessageDataAndRespond)) throw new MeteorTransportUnavailableError();
 	const method = raw.sendMessageDataAndRespond;
 	return { sendMessageDataAndRespond: callMeteor.bind(null, raw, method) };
 }
@@ -112,6 +118,6 @@ var MeteorRequest = class {
 function ignoreResult(_value) {}
 function ignoreError(_error) {}
 //#endregion
-export { MeteorRequest, meteorTransportFromWindow };
+export { MeteorRequest, MeteorTransportUnavailableError, meteorTransportFromWindow };
 
 //# sourceMappingURL=meteorRequest.js.map

package/dist/esm/react/components/HostedSeamsAuthMenu/shell.js

@@ -84,6 +84,8 @@ function hostedAuthMenuEffectConfigKey(config) {
 			showRegistrationInput: config.showRegistrationInput,
 			showProgress: config.showProgress,
 			copy: config.copy,
+			recoveryOptions: config.recoveryOptions,
+			footerBrand: config.footerBrand,
 			enabledExternalProviders: config.enabledExternalProviders,
 			walletAlternatives: describeWalletAlternatives(config.walletAlternatives)
 		});
@@ -94,6 +96,8 @@ function hostedAuthMenuEffectConfigKey(config) {
 			showRegistrationInput: normalized.showRegistrationInput,
 			showProgress: normalized.showProgress,
 			copy: normalized.copy,
+			recoveryOptions: normalized.recoveryOptions,
+			footerBrand: normalized.footerBrand,
 			enabledExternalProviders: normalized.enabledExternalProviders,
 			walletAlternatives: normalized.walletAlternatives,
 			walletControllers: walletAlternativesControllerKey(config.walletAlternatives)
@@ -112,6 +116,8 @@ var HostedAuthMenuSessionController = class {
 	showRegistrationInput;
 	showProgress;
 	copy;
+	recoveryOptions;
+	footerBrand;
 	externalAuthBroker;
 	walletAlternatives;
 	walletBroker;
@@ -133,6 +139,8 @@ var HostedAuthMenuSessionController = class {
 		this.showRegistrationInput = args.showRegistrationInput;
 		this.showProgress = args.showProgress;
 		this.copy = args.copy;
+		this.recoveryOptions = args.recoveryOptions;
+		this.footerBrand = args.footerBrand;
 		this.externalAuthBroker = args.externalAuthBroker;
 		this.walletAlternatives = args.walletAlternatives;
 		this.walletBroker = new WalletAlternativesBroker(args.seams.authMenu, args.authMenuSessionId, args.walletAlternatives);
@@ -171,6 +179,8 @@ var HostedAuthMenuSessionController = class {
 				showRegistrationInput: this.showRegistrationInput,
 				showProgress: this.showProgress,
 				copy: this.copy,
+				recoveryOptions: this.recoveryOptions,
+				footerBrand: this.footerBrand,
 				enabledExternalProviders: this.externalAuthBroker.current ? ["google"] : [],
 				walletAlternatives: describeWalletAlternatives(this.walletAlternatives.current)
 			});
@@ -289,7 +299,7 @@ function forwardHostedAuthMenuOutcome(terminalGateRef, onOutcomeRef, outcome) {
 	if (isTerminalHostedAuthMenuSuccess(outcome) && terminalGateRef.current) terminalGateRef.current.completed = true;
 	onOutcomeRef.current(outcome);
 }
-const HostedSeamsAuthMenu = ({ initialMode = "login", initialHeightCssPx, placeholder, registrationAccountInput = "implicit_wallet", showRegistrationInput = false, showProgress = false, copy, externalAuthBroker = null, walletAlternatives, onOutcome }) => {
+const HostedSeamsAuthMenu = ({ initialMode = "login", initialHeightCssPx, placeholder, registrationAccountInput = "implicit_wallet", showRegistrationInput = false, showProgress = false, copy, recoveryOptions, footerBrand, externalAuthBroker = null, walletAlternatives, onOutcome }) => {
 	const { seams, isLoggedIn } = useOptionalSeams();
 	const terminalGate = terminalGateFor(seams);
 	syncTerminalGate(terminalGate, isLoggedIn);
@@ -300,6 +310,8 @@ const HostedSeamsAuthMenu = ({ initialMode = "login", initialHeightCssPx, placeh
 		showRegistrationInput,
 		showProgress,
 		copy,
+		recoveryOptions,
+		footerBrand,
 		enabledExternalProviders: externalProvidersForBroker(externalAuthBroker),
 		walletAlternatives
 	});
@@ -317,6 +329,8 @@ const HostedSeamsAuthMenu = ({ initialMode = "login", initialHeightCssPx, placeh
 		showRegistrationInput,
 		showProgress,
 		copy,
+		recoveryOptions,
+		footerBrand,
 		enabledExternalProviders: externalProvidersForBroker(externalAuthBroker),
 		walletAlternatives
 	};
@@ -341,6 +355,8 @@ const HostedSeamsAuthMenu = ({ initialMode = "login", initialHeightCssPx, placeh
 			showRegistrationInput: config.showRegistrationInput,
 			showProgress: config.showProgress,
 			copy: config.copy,
+			recoveryOptions: config.recoveryOptions,
+			footerBrand: config.footerBrand,
 			externalAuthBroker: externalAuthBrokerRef,
 			walletAlternatives: walletAlternativesRef,
 			onOutcome: forwardedOutcomeRef