@tatchi-xyz/sdk 0.21.0 → 0.31.1

package/dist/esm/react/src/core/WebAuthnManager/userPreferences.js

@@ -0,0 +1,390 @@
+import { DEFAULT_CONFIRMATION_CONFIG, DEFAULT_SIGNING_MODE, coerceSignerMode, mergeSignerMode } from "../types/signer-worker.js";
+import { IndexedDBManager } from "../IndexedDBManager/index.js";
+
+//#region src/core/WebAuthnManager/userPreferences.ts
+var UserPreferencesManager = class {
+	themeChangeListeners = /* @__PURE__ */ new Set();
+	confirmationConfigChangeListeners = /* @__PURE__ */ new Set();
+	signerModeChangeListeners = /* @__PURE__ */ new Set();
+	currentUserAccountId;
+	confirmationConfig = DEFAULT_CONFIRMATION_CONFIG;
+	signerMode = DEFAULT_SIGNING_MODE;
+	walletThemeOverride = null;
+	signerModeOverride = null;
+	walletIframeSignerModeWriter = null;
+	envThemeSyncedForSession = false;
+	constructor() {
+		this.subscribeToIndexedDBChanges();
+	}
+	/**
+	* Apply an app-provided default theme (e.g., `configs.walletTheme`) without
+	* persisting it as a per-user preference in IndexedDB.
+	*
+	* This also disables the one-time environment theme sync so host appearance
+	* (e.g., VitePress `html.dark`) cannot override an explicit config.
+	*/
+	configureWalletTheme(theme) {
+		if (theme !== "dark" && theme !== "light") return;
+		this.walletThemeOverride = theme;
+		this.envThemeSyncedForSession = true;
+		if (this.confirmationConfig.theme !== theme) {
+			this.confirmationConfig = {
+				...this.confirmationConfig,
+				theme
+			};
+			this.notifyConfirmationConfigChange(this.confirmationConfig);
+			this.notifyThemeChange(theme);
+		}
+	}
+	/**
+	* Apply an app-provided default signer mode (e.g., `configs.signerMode`) without
+	* persisting it as a per-user preference in IndexedDB.
+	*/
+	configureDefaultSignerMode(signerMode) {
+		const next = coerceSignerMode(signerMode, DEFAULT_SIGNING_MODE);
+		this.signerModeOverride = next;
+		if (!this.currentUserAccountId) this.setSignerModeInternal(next, {
+			persist: false,
+			notify: true
+		});
+	}
+	/**
+	* In wallet-iframe mode on the app origin, user preferences must be persisted by the wallet host
+	* (not the app origin). This configures a best-effort writer used by `setSignerMode(...)` when
+	* IndexedDB is disabled.
+	*/
+	configureWalletIframeSignerModeWriter(writer) {
+		this.walletIframeSignerModeWriter = writer;
+	}
+	/**
+	* Register a callback for theme change events
+	*/
+	onThemeChange(callback) {
+		this.themeChangeListeners.add(callback);
+		return () => {
+			this.themeChangeListeners.delete(callback);
+		};
+	}
+	/**
+	* Register a callback for confirmation config changes.
+	* Used to keep app UI in sync with the wallet host in wallet-iframe mode.
+	*/
+	onConfirmationConfigChange(callback) {
+		this.confirmationConfigChangeListeners.add(callback);
+		return () => {
+			this.confirmationConfigChangeListeners.delete(callback);
+		};
+	}
+	/**
+	* Register a callback for signer mode changes.
+	*/
+	onSignerModeChange(callback) {
+		this.signerModeChangeListeners.add(callback);
+		return () => {
+			this.signerModeChangeListeners.delete(callback);
+		};
+	}
+	/**
+	* Notify all registered listeners of theme changes
+	*/
+	notifyThemeChange(theme) {
+		if (this.themeChangeListeners.size === 0) {
+			console.debug(`[UserPreferencesManager]: No listeners registered, theme change will not propagate.`);
+			return;
+		}
+		for (const listener of this.themeChangeListeners) listener(theme);
+	}
+	notifyConfirmationConfigChange(config) {
+		if (this.confirmationConfigChangeListeners.size === 0) return;
+		for (const listener of this.confirmationConfigChangeListeners) listener(config);
+	}
+	notifySignerModeChange(mode) {
+		if (this.signerModeChangeListeners.size === 0) return;
+		for (const listener of this.signerModeChangeListeners) listener(mode);
+	}
+	/**
+	* Best-effort async initialization from IndexedDB.
+	*
+	* Callers decide when to invoke this so environments that must avoid
+	* app-origin IndexedDB (wallet-iframe mode) can skip it entirely.
+	*/
+	async initFromIndexedDB() {
+		await this.loadUserSettings().catch((error) => {
+			console.warn("[WebAuthnManager]: Failed to initialize user settings:", error);
+		});
+	}
+	/**
+	* Subscribe to IndexedDB change events for automatic synchronization
+	*/
+	subscribeToIndexedDBChanges() {
+		this.unsubscribeFromIndexedDB = IndexedDBManager.clientDB.onChange((event) => {
+			this.handleIndexedDBEvent(event).catch((error) => {
+				console.warn("[WebAuthnManager]: Error handling IndexedDB event:", error);
+			});
+		});
+	}
+	/**
+	* Handle IndexedDB change events.
+	* @param event - The IndexedDBEvent: `user-updated`, `preferences-updated`, `user-deleted` to handle.
+	*/
+	async handleIndexedDBEvent(event) {
+		switch (event.type) {
+			case "preferences-updated":
+				if (event.accountId === this.currentUserAccountId) await this.reloadUserSettings();
+				break;
+			case "user-updated":
+				if (event.accountId === this.currentUserAccountId) await this.reloadUserSettings();
+				break;
+			case "user-deleted":
+				if (event.accountId === this.currentUserAccountId) {
+					this.currentUserAccountId = void 0;
+					this.confirmationConfig = DEFAULT_CONFIRMATION_CONFIG;
+				}
+				break;
+		}
+	}
+	/**
+	* Unsubscribe function for IndexedDB events
+	*/
+	unsubscribeFromIndexedDB;
+	/**
+	* Clean up resources and unsubscribe from events
+	*/
+	destroy() {
+		if (this.unsubscribeFromIndexedDB) {
+			this.unsubscribeFromIndexedDB();
+			this.unsubscribeFromIndexedDB = void 0;
+		}
+		this.walletIframeSignerModeWriter = null;
+		this.themeChangeListeners.clear();
+		this.confirmationConfigChangeListeners.clear();
+		this.signerModeChangeListeners.clear();
+	}
+	getCurrentUserAccountId() {
+		if (!this.currentUserAccountId) {
+			console.debug("[UserPreferencesManager]: getCurrentUserAccountId called with no current user; returning empty id");
+			return "";
+		}
+		return this.currentUserAccountId;
+	}
+	getConfirmationConfig() {
+		return this.confirmationConfig;
+	}
+	getSignerMode() {
+		return this.signerMode;
+	}
+	/**
+	* Apply an authoritative confirmation config snapshot from the wallet-iframe host.
+	* This updates in-memory state only; persistence remains owned by the wallet origin.
+	*/
+	applyWalletHostConfirmationConfig(args) {
+		const { nearAccountId, confirmationConfig } = args || {};
+		const prevTheme = this.confirmationConfig.theme;
+		const next = {
+			...DEFAULT_CONFIRMATION_CONFIG,
+			...confirmationConfig || {}
+		};
+		if (nearAccountId) this.currentUserAccountId = nearAccountId;
+		this.envThemeSyncedForSession = true;
+		this.confirmationConfig = next;
+		this.notifyConfirmationConfigChange(this.confirmationConfig);
+		if (this.confirmationConfig.theme !== prevTheme) this.notifyThemeChange(this.confirmationConfig.theme);
+	}
+	/**
+	* Apply an authoritative signer mode snapshot from the wallet-iframe host.
+	* This updates in-memory state only; persistence remains owned by the wallet origin.
+	*/
+	applyWalletHostSignerMode(args) {
+		const { nearAccountId, signerMode } = args || {};
+		if (nearAccountId) this.currentUserAccountId = nearAccountId;
+		const base = this.signerModeOverride ?? DEFAULT_SIGNING_MODE;
+		const next = coerceSignerMode(signerMode, base);
+		this.setSignerModeInternal(next, {
+			persist: false,
+			notify: true
+		});
+	}
+	setCurrentUser(nearAccountId) {
+		this.currentUserAccountId = nearAccountId;
+		if (!IndexedDBManager.clientDB.isDisabled()) this.loadSettingsForUser(nearAccountId).catch(() => void 0);
+		if (!IndexedDBManager.clientDB.isDisabled() && !this.envThemeSyncedForSession && !this.walletThemeOverride) {
+			let envTheme = null;
+			const isDark = globalThis?.document?.documentElement?.classList?.contains?.("dark");
+			if (typeof isDark === "boolean") envTheme = isDark ? "dark" : "light";
+			if (!envTheme) try {
+				const stored = globalThis?.localStorage?.getItem?.("vitepress-theme-appearance");
+				if (stored === "dark" || stored === "light") envTheme = stored;
+			} catch {}
+			if (envTheme && envTheme !== this.confirmationConfig.theme) this.setUserTheme(envTheme);
+			this.envThemeSyncedForSession = true;
+		}
+	}
+	/**
+	* Load settings for a specific user
+	*/
+	async loadSettingsForUser(nearAccountId) {
+		if (IndexedDBManager.clientDB.isDisabled()) return;
+		const user = await IndexedDBManager.clientDB.getLastUser().catch(() => null);
+		if (!user || user.nearAccountId !== nearAccountId) return;
+		if (user?.preferences?.confirmationConfig) {
+			const prevTheme = this.confirmationConfig.theme;
+			this.confirmationConfig = {
+				...this.confirmationConfig,
+				...user.preferences.confirmationConfig
+			};
+			this.notifyConfirmationConfigChange(this.confirmationConfig);
+			if (this.confirmationConfig.theme !== prevTheme) this.notifyThemeChange(this.confirmationConfig.theme);
+		}
+		const base = this.signerModeOverride ?? DEFAULT_SIGNING_MODE;
+		const stored = user?.preferences?.signerMode;
+		const nextSignerMode = stored != null ? coerceSignerMode(stored, base) : base;
+		this.setSignerModeInternal(nextSignerMode, {
+			persist: false,
+			notify: true
+		});
+	}
+	/**
+	* Reload current user settings from IndexedDB
+	*/
+	async reloadUserSettings() {
+		await this.loadSettingsForUser(this.getCurrentUserAccountId());
+	}
+	/**
+	* Set confirmation behavior
+	*/
+	setConfirmBehavior(behavior) {
+		this.confirmationConfig = {
+			...this.confirmationConfig,
+			behavior
+		};
+		this.notifyConfirmationConfigChange(this.confirmationConfig);
+		this.saveUserSettings();
+	}
+	/**
+	* Set confirmation configuration
+	*/
+	setConfirmationConfig(config) {
+		const prevTheme = this.confirmationConfig.theme;
+		this.confirmationConfig = {
+			...this.confirmationConfig,
+			...config
+		};
+		this.notifyConfirmationConfigChange(this.confirmationConfig);
+		if (this.confirmationConfig.theme !== prevTheme) this.notifyThemeChange(this.confirmationConfig.theme);
+		this.saveUserSettings();
+	}
+	/**
+	* Load user confirmation settings from IndexedDB
+	*/
+	async loadUserSettings() {
+		if (IndexedDBManager.clientDB.isDisabled()) return;
+		const user = await IndexedDBManager.clientDB.getLastUser().catch(() => null);
+		if (user) {
+			const prevTheme = this.confirmationConfig.theme;
+			this.currentUserAccountId = user.nearAccountId;
+			if (user.preferences?.confirmationConfig) {
+				this.confirmationConfig = {
+					...this.confirmationConfig,
+					...user.preferences.confirmationConfig
+				};
+				this.notifyConfirmationConfigChange(this.confirmationConfig);
+				if (this.confirmationConfig.theme !== prevTheme) this.notifyThemeChange(this.confirmationConfig.theme);
+			} else console.debug("[WebAuthnManager]: No user preferences found, using defaults");
+			const base = this.signerModeOverride ?? DEFAULT_SIGNING_MODE;
+			const stored = user?.preferences?.signerMode;
+			const nextSignerMode = stored != null ? coerceSignerMode(stored, base) : base;
+			this.setSignerModeInternal(nextSignerMode, {
+				persist: false,
+				notify: true
+			});
+		} else console.debug("[WebAuthnManager]: No last user found, using default settings");
+	}
+	/**
+	* Save current confirmation settings to IndexedDB
+	*/
+	async saveUserSettings() {
+		try {
+			let accountId = this.currentUserAccountId ?? void 0;
+			if (!accountId) {
+				const last = await IndexedDBManager.clientDB.getLastUser().catch(() => void 0);
+				accountId = last?.nearAccountId;
+			}
+			if (!accountId) {
+				console.warn("[UserPreferences]: No current user set; keeping confirmation config in memory only");
+				return;
+			}
+			await IndexedDBManager.clientDB.updatePreferences(accountId, { confirmationConfig: this.confirmationConfig });
+		} catch (error) {
+			console.warn("[WebAuthnManager]: Failed to save user settings:", error);
+		}
+	}
+	/**
+	* Get user theme preference from IndexedDB
+	*/
+	async getCurrentUserAccountIdTheme() {
+		const id = this.currentUserAccountId;
+		if (!id) return null;
+		try {
+			return await IndexedDBManager.clientDB.getTheme(id);
+		} catch (error) {
+			console.debug("[WebAuthnManager]: getCurrentUserAccountIdTheme:", error);
+			return null;
+		}
+	}
+	getUserTheme() {
+		return this.confirmationConfig.theme;
+	}
+	/**
+	* Set user theme preference in IndexedDB
+	*/
+	async setUserTheme(theme) {
+		const id = this.currentUserAccountId;
+		if (!id) return;
+		this.confirmationConfig = {
+			...this.confirmationConfig,
+			theme
+		};
+		this.notifyConfirmationConfigChange(this.confirmationConfig);
+		this.notifyThemeChange(theme);
+		try {
+			await IndexedDBManager.clientDB.setTheme(id, theme);
+		} catch (error) {
+			console.warn("[UserPreferencesManager]: Failed to save user theme:", error);
+		}
+	}
+	/**
+	* Set signer mode preference (in-memory immediately; IndexedDB persistence is best-effort).
+	*/
+	setSignerMode(signerMode) {
+		const next = mergeSignerMode(this.signerMode, signerMode);
+		if (this.walletIframeSignerModeWriter && IndexedDBManager.clientDB.isDisabled()) {
+			this.walletIframeSignerModeWriter(next).catch(() => void 0);
+			return;
+		}
+		this.setSignerModeInternal(next, {
+			persist: true,
+			notify: true
+		});
+	}
+	isSignerModeEqual(a, b) {
+		if (a.mode !== b.mode) return false;
+		if (a.mode !== "threshold-signer" || b.mode !== "threshold-signer") return true;
+		return (a.behavior ?? null) === (b.behavior ?? null);
+	}
+	setSignerModeInternal(next, opts) {
+		const prev = this.signerMode;
+		this.signerMode = next;
+		if (opts.notify && !this.isSignerModeEqual(prev, next)) this.notifySignerModeChange(next);
+		if (opts.persist) {
+			const id = this.currentUserAccountId;
+			if (!id || IndexedDBManager.clientDB.isDisabled()) return;
+			IndexedDBManager.clientDB.setSignerMode(id, next).catch(() => void 0);
+		}
+	}
+};
+const UserPreferencesInstance = new UserPreferencesManager();
+var userPreferences_default = UserPreferencesInstance;
+
+//#endregion
+export { userPreferences_default as default };
+//# sourceMappingURL=userPreferences.js.map

package/dist/esm/react/src/core/WebAuthnManager/userPreferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userPreferences.js","names":["next: ConfirmationConfig","envTheme: 'dark' | 'light' | null","accountId: AccountId | undefined"],"sources":["../../../../../../src/core/WebAuthnManager/userPreferences.ts"],"sourcesContent":["import {\n  ConfirmationConfig,\n  DEFAULT_CONFIRMATION_CONFIG,\n  type SignerMode,\n  DEFAULT_SIGNING_MODE,\n  coerceSignerMode,\n  mergeSignerMode,\n} from '../types/signer-worker';\nimport type { AccountId } from '../types/accountIds';\nimport { IndexedDBManager, type IndexedDBEvent } from '../IndexedDBManager';\n\n\nexport class UserPreferencesManager {\n\n  private themeChangeListeners: Set<(theme: 'dark' | 'light') => void> = new Set();\n  private confirmationConfigChangeListeners: Set<(config: ConfirmationConfig) => void> = new Set();\n  private signerModeChangeListeners: Set<(mode: SignerMode) => void> = new Set();\n\n  private currentUserAccountId: AccountId | undefined;\n  private confirmationConfig: ConfirmationConfig = DEFAULT_CONFIRMATION_CONFIG;\n  private signerMode: SignerMode = DEFAULT_SIGNING_MODE;\n\n  // Optional app-provided default theme (e.g., configs.walletTheme). This is NOT a per-user preference.\n  private walletThemeOverride: 'dark' | 'light' | null = null;\n  // Optional app-provided default signer mode (e.g., configs.signerMode). This is NOT a per-user preference.\n  private signerModeOverride: SignerMode | null = null;\n  // Wallet-iframe app-origin: delegate signerMode persistence to the wallet host.\n  private walletIframeSignerModeWriter: ((signerMode: SignerMode) => Promise<void>) | null = null;\n  // Prevent multiple one-time environment syncs per session\n  private envThemeSyncedForSession = false;\n\n  constructor() {\n    // Subscribe to IndexedDB change events for automatic sync\n    this.subscribeToIndexedDBChanges();\n  }\n\n  /**\n   * Apply an app-provided default theme (e.g., `configs.walletTheme`) without\n   * persisting it as a per-user preference in IndexedDB.\n   *\n   * This also disables the one-time environment theme sync so host appearance\n   * (e.g., VitePress `html.dark`) cannot override an explicit config.\n   */\n  configureWalletTheme(theme?: 'dark' | 'light'): void {\n    if (theme !== 'dark' && theme !== 'light') return;\n    this.walletThemeOverride = theme;\n    // If integrator explicitly configured a theme, do not auto-sync from environment.\n    this.envThemeSyncedForSession = true;\n    if (this.confirmationConfig.theme !== theme) {\n      this.confirmationConfig = {\n        ...this.confirmationConfig,\n        theme,\n      };\n      this.notifyConfirmationConfigChange(this.confirmationConfig);\n      this.notifyThemeChange(theme);\n    }\n  }\n\n  /**\n   * Apply an app-provided default signer mode (e.g., `configs.signerMode`) without\n   * persisting it as a per-user preference in IndexedDB.\n   */\n  configureDefaultSignerMode(signerMode?: SignerMode | SignerMode['mode'] | null): void {\n    const next = coerceSignerMode(signerMode, DEFAULT_SIGNING_MODE);\n    this.signerModeOverride = next;\n    // When no user is active, keep in-memory default aligned to config.\n    if (!this.currentUserAccountId) {\n      this.setSignerModeInternal(next, { persist: false, notify: true });\n    }\n  }\n\n  /**\n   * In wallet-iframe mode on the app origin, user preferences must be persisted by the wallet host\n   * (not the app origin). This configures a best-effort writer used by `setSignerMode(...)` when\n   * IndexedDB is disabled.\n   */\n  configureWalletIframeSignerModeWriter(writer: ((signerMode: SignerMode) => Promise<void>) | null): void {\n    this.walletIframeSignerModeWriter = writer;\n  }\n\n  /**\n   * Register a callback for theme change events\n   */\n  onThemeChange(callback: (theme: 'dark' | 'light') => void): () => void {\n    this.themeChangeListeners.add(callback);\n    return () => {\n      this.themeChangeListeners.delete(callback);\n    };\n  }\n\n  /**\n   * Register a callback for confirmation config changes.\n   * Used to keep app UI in sync with the wallet host in wallet-iframe mode.\n   */\n  onConfirmationConfigChange(callback: (config: ConfirmationConfig) => void): () => void {\n    this.confirmationConfigChangeListeners.add(callback);\n    return () => {\n      this.confirmationConfigChangeListeners.delete(callback);\n    };\n  }\n\n  /**\n   * Register a callback for signer mode changes.\n   */\n  onSignerModeChange(callback: (mode: SignerMode) => void): () => void {\n    this.signerModeChangeListeners.add(callback);\n    return () => {\n      this.signerModeChangeListeners.delete(callback);\n    };\n  }\n\n  /**\n   * Notify all registered listeners of theme changes\n   */\n  private notifyThemeChange(theme: 'dark' | 'light'): void {\n    if (this.themeChangeListeners.size === 0) {\n      // In many environments (e.g., wallet iframe host), there may be no UI subscribers.\n      // Use debug to avoid noisy warnings while still being helpful during development.\n      console.debug(`[UserPreferencesManager]: No listeners registered, theme change will not propagate.`);\n      return;\n    }\n\n    for (const listener of this.themeChangeListeners) {\n      listener(theme);\n    }\n  }\n\n  private notifyConfirmationConfigChange(config: ConfirmationConfig): void {\n    if (this.confirmationConfigChangeListeners.size === 0) return;\n    for (const listener of this.confirmationConfigChangeListeners) {\n      listener(config);\n    }\n  }\n\n  private notifySignerModeChange(mode: SignerMode): void {\n    if (this.signerModeChangeListeners.size === 0) return;\n    for (const listener of this.signerModeChangeListeners) {\n      listener(mode);\n    }\n  }\n\n  /**\n   * Best-effort async initialization from IndexedDB.\n   *\n   * Callers decide when to invoke this so environments that must avoid\n   * app-origin IndexedDB (wallet-iframe mode) can skip it entirely.\n   */\n  async initFromIndexedDB(): Promise<void> {\n    await this.loadUserSettings().catch((error) => {\n      console.warn('[WebAuthnManager]: Failed to initialize user settings:', error);\n    });\n  }\n\n  /**\n   * Subscribe to IndexedDB change events for automatic synchronization\n   */\n  private subscribeToIndexedDBChanges(): void {\n    // Subscribe to IndexedDB change events\n    this.unsubscribeFromIndexedDB = IndexedDBManager.clientDB.onChange((event) => {\n      void this.handleIndexedDBEvent(event).catch((error) => {\n        console.warn('[WebAuthnManager]: Error handling IndexedDB event:', error);\n      });\n    });\n  }\n\n  /**\n   * Handle IndexedDB change events.\n   * @param event - The IndexedDBEvent: `user-updated`, `preferences-updated`, `user-deleted` to handle.\n   */\n  private async handleIndexedDBEvent(event: IndexedDBEvent): Promise<void> {\n    switch (event.type) {\n      case 'preferences-updated':\n        // Check if this affects the current user\n        if (event.accountId === this.currentUserAccountId) {\n          await this.reloadUserSettings();\n        }\n        break;\n\n      case 'user-updated':\n        // Check if this affects the current user\n        if (event.accountId === this.currentUserAccountId) {\n          await this.reloadUserSettings();\n        }\n        break;\n\n      case 'user-deleted':\n        // Check if the deleted user was the current user\n        if (event.accountId === this.currentUserAccountId) {\n          this.currentUserAccountId = undefined;\n          this.confirmationConfig = DEFAULT_CONFIRMATION_CONFIG;\n        }\n        break;\n    }\n  }\n\n  /**\n   * Unsubscribe function for IndexedDB events\n   */\n  private unsubscribeFromIndexedDB?: () => void;\n\n  /**\n   * Clean up resources and unsubscribe from events\n   */\n  destroy(): void {\n    if (this.unsubscribeFromIndexedDB) {\n      this.unsubscribeFromIndexedDB();\n      this.unsubscribeFromIndexedDB = undefined;\n    }\n    this.walletIframeSignerModeWriter = null;\n    // Clear all theme change listeners\n    this.themeChangeListeners.clear();\n    this.confirmationConfigChangeListeners.clear();\n    this.signerModeChangeListeners.clear();\n  }\n\n  getCurrentUserAccountId(): AccountId {\n    if (!this.currentUserAccountId) {\n      console.debug('[UserPreferencesManager]: getCurrentUserAccountId called with no current user; returning empty id');\n      // Return an empty string to keep callers defensive; most consumers\n      // already treat falsy accountIds as \"no-op\"/logged‑out.\n      return '' as AccountId;\n    }\n    return this.currentUserAccountId;\n  }\n\n  getConfirmationConfig(): ConfirmationConfig {\n    return this.confirmationConfig;\n  }\n\n  getSignerMode(): SignerMode {\n    return this.signerMode;\n  }\n\n  /**\n   * Apply an authoritative confirmation config snapshot from the wallet-iframe host.\n   * This updates in-memory state only; persistence remains owned by the wallet origin.\n   */\n  applyWalletHostConfirmationConfig(args: {\n    nearAccountId?: AccountId | null;\n    confirmationConfig: ConfirmationConfig;\n  }): void {\n    const { nearAccountId, confirmationConfig } = args || ({} as any);\n    const prevTheme = this.confirmationConfig.theme;\n    const next: ConfirmationConfig = {\n      ...DEFAULT_CONFIRMATION_CONFIG,\n      ...(confirmationConfig || {}),\n    } as ConfirmationConfig;\n\n    if (nearAccountId) {\n      this.currentUserAccountId = nearAccountId;\n    }\n\n    // Prevent environment heuristics on the app origin from overriding wallet-host state.\n    this.envThemeSyncedForSession = true;\n\n    this.confirmationConfig = next;\n    this.notifyConfirmationConfigChange(this.confirmationConfig);\n    if (this.confirmationConfig.theme !== prevTheme) {\n      this.notifyThemeChange(this.confirmationConfig.theme);\n    }\n  }\n\n  /**\n   * Apply an authoritative signer mode snapshot from the wallet-iframe host.\n   * This updates in-memory state only; persistence remains owned by the wallet origin.\n   */\n  applyWalletHostSignerMode(args: {\n    nearAccountId?: AccountId | null;\n    signerMode: SignerMode;\n  }): void {\n    const { nearAccountId, signerMode } = args || ({} as any);\n    if (nearAccountId) {\n      this.currentUserAccountId = nearAccountId;\n    }\n    const base = this.signerModeOverride ?? DEFAULT_SIGNING_MODE;\n    const next = coerceSignerMode(signerMode, base);\n    this.setSignerModeInternal(next, { persist: false, notify: true });\n  }\n\n  setCurrentUser(nearAccountId: AccountId): void {\n    this.currentUserAccountId = nearAccountId;\n    // Load settings for the new user (best-effort). In wallet-iframe mode on the app origin,\n    // IndexedDB is intentionally disabled to avoid creating any tables.\n    if (!IndexedDBManager.clientDB.isDisabled()) {\n      void this.loadSettingsForUser(nearAccountId).catch(() => undefined);\n    }\n\n    // One-time: align user theme to current host appearance (e.g., VitePress html.dark)\n    // In wallet-iframe mode (app origin), the wallet host owns preferences; do not override.\n    if (!IndexedDBManager.clientDB.isDisabled() && !this.envThemeSyncedForSession && !this.walletThemeOverride) {\n      let envTheme: 'dark' | 'light' | null = null;\n      const isDark = (globalThis as any)?.document?.documentElement?.classList?.contains?.('dark');\n      if (typeof isDark === 'boolean') envTheme = isDark ? 'dark' : 'light';\n      if (!envTheme) {\n        try {\n          const stored = (globalThis as any)?.localStorage?.getItem?.('vitepress-theme-appearance');\n          if (stored === 'dark' || stored === 'light') envTheme = stored;\n        } catch {\n          // Storage may be blocked by the environment (e.g., third-party iframes)\n        }\n      }\n      if (envTheme && envTheme !== this.confirmationConfig.theme) {\n        // Fire-and-forget; listeners will propagate the change\n        void this.setUserTheme(envTheme);\n      }\n      this.envThemeSyncedForSession = true;\n    }\n  }\n\n  /**\n   * Load settings for a specific user\n   */\n  private async loadSettingsForUser(nearAccountId: AccountId): Promise<void> {\n    if (IndexedDBManager.clientDB.isDisabled()) return;\n    const user = await IndexedDBManager.clientDB.getLastUser().catch(() => null);\n    if (!user || user.nearAccountId !== nearAccountId) return;\n    if (user?.preferences?.confirmationConfig) {\n      const prevTheme = this.confirmationConfig.theme;\n      this.confirmationConfig = {\n        ...this.confirmationConfig,\n        ...user.preferences.confirmationConfig\n      };\n      this.notifyConfirmationConfigChange(this.confirmationConfig);\n      if (this.confirmationConfig.theme !== prevTheme) {\n        this.notifyThemeChange(this.confirmationConfig.theme);\n      }\n    }\n\n    // Signer mode: stored per-user preference (optional).\n    const base = this.signerModeOverride ?? DEFAULT_SIGNING_MODE;\n    const stored = user?.preferences?.signerMode as SignerMode | SignerMode['mode'] | null | undefined;\n    const nextSignerMode = stored != null ? coerceSignerMode(stored, base) : base;\n    this.setSignerModeInternal(nextSignerMode, { persist: false, notify: true });\n  }\n\n  /**\n   * Reload current user settings from IndexedDB\n   */\n  async reloadUserSettings(): Promise<void> {\n    await this.loadSettingsForUser(this.getCurrentUserAccountId());\n  }\n\n  /**\n   * Set confirmation behavior\n   */\n  setConfirmBehavior(behavior: 'requireClick' | 'autoProceed'): void {\n    this.confirmationConfig = {\n      ...this.confirmationConfig,\n      behavior\n    };\n    this.notifyConfirmationConfigChange(this.confirmationConfig);\n    this.saveUserSettings();\n  }\n\n  /**\n   * Set confirmation configuration\n   */\n  setConfirmationConfig(config: ConfirmationConfig): void {\n    const prevTheme = this.confirmationConfig.theme;\n    this.confirmationConfig = {\n      ...this.confirmationConfig,\n      ...config\n    };\n    this.notifyConfirmationConfigChange(this.confirmationConfig);\n    if (this.confirmationConfig.theme !== prevTheme) {\n      this.notifyThemeChange(this.confirmationConfig.theme);\n    }\n    this.saveUserSettings();\n  }\n\n  /**\n   * Load user confirmation settings from IndexedDB\n   */\n  async loadUserSettings(): Promise<void> {\n    if (IndexedDBManager.clientDB.isDisabled()) return;\n    const user = await IndexedDBManager.clientDB.getLastUser().catch(() => null);\n    if (user) {\n      const prevTheme = this.confirmationConfig.theme;\n      this.currentUserAccountId = user.nearAccountId;\n      // Load user's confirmation config if it exists, otherwise keep existing settings/defaults\n      if (user.preferences?.confirmationConfig) {\n        this.confirmationConfig = {\n          ...this.confirmationConfig,\n          ...user.preferences.confirmationConfig\n        };\n        this.notifyConfirmationConfigChange(this.confirmationConfig);\n        if (this.confirmationConfig.theme !== prevTheme) {\n          this.notifyThemeChange(this.confirmationConfig.theme);\n        }\n      } else {\n        console.debug('[WebAuthnManager]: No user preferences found, using defaults');\n      }\n\n      // Load signer mode preference if available; otherwise use app default (configs.signerMode).\n      const base = this.signerModeOverride ?? DEFAULT_SIGNING_MODE;\n      const stored = user?.preferences?.signerMode as SignerMode | SignerMode['mode'] | null | undefined;\n      const nextSignerMode = stored != null ? coerceSignerMode(stored, base) : base;\n      this.setSignerModeInternal(nextSignerMode, { persist: false, notify: true });\n    } else {\n      console.debug('[WebAuthnManager]: No last user found, using default settings');\n    }\n  }\n\n  /**\n   * Save current confirmation settings to IndexedDB\n   */\n  async saveUserSettings(): Promise<void> {\n    try {\n      let accountId: AccountId | undefined = this.currentUserAccountId ?? undefined;\n      if (!accountId) {\n        const last = await IndexedDBManager.clientDB.getLastUser().catch(() => undefined as any);\n        accountId = (last as any)?.nearAccountId;\n      }\n\n      if (!accountId) {\n        console.warn('[UserPreferences]: No current user set; keeping confirmation config in memory only');\n        return;\n      }\n\n      // Save confirmation config (which includes theme)\n      await IndexedDBManager.clientDB.updatePreferences(accountId, {\n        confirmationConfig: this.confirmationConfig,\n      });\n    } catch (error) {\n      console.warn('[WebAuthnManager]: Failed to save user settings:', error);\n    }\n  }\n\n  /**\n   * Get user theme preference from IndexedDB\n   */\n  async getCurrentUserAccountIdTheme(): Promise<'dark' | 'light' | null> {\n    const id = this.currentUserAccountId;\n    if (!id) return null;\n    try {\n      return await IndexedDBManager.clientDB.getTheme(id);\n    } catch (error) {\n      console.debug('[WebAuthnManager]: getCurrentUserAccountIdTheme:', error);\n      return null;\n    }\n  }\n\n  getUserTheme(): 'dark' | 'light' {\n    return this.confirmationConfig.theme;\n  }\n\n  /**\n   * Set user theme preference in IndexedDB\n   */\n  async setUserTheme(theme: 'dark' | 'light'): Promise<void> {\n    const id = this.currentUserAccountId;\n    if (!id) return; // No-op when no user is set (logged-out state)\n    // Always update local UI state immediately; persistence is best-effort.\n    this.confirmationConfig = {\n      ...this.confirmationConfig,\n      theme\n    };\n    // Notify all listeners of theme change\n    this.notifyConfirmationConfigChange(this.confirmationConfig);\n    this.notifyThemeChange(theme);\n    try {\n      await IndexedDBManager.clientDB.setTheme(id, theme);\n    } catch (error) {\n      console.warn('[UserPreferencesManager]: Failed to save user theme:', error);\n    }\n  }\n\n  /**\n   * Set signer mode preference (in-memory immediately; IndexedDB persistence is best-effort).\n   */\n  setSignerMode(signerMode: SignerMode | SignerMode['mode']): void {\n    const next = mergeSignerMode(this.signerMode, signerMode);\n    // In wallet-iframe mode on the app origin, persistence is owned by the wallet host.\n    // Forward to the host and rely on PREFERENCES_CHANGED mirroring for local state updates.\n    if (this.walletIframeSignerModeWriter && IndexedDBManager.clientDB.isDisabled()) {\n      void this.walletIframeSignerModeWriter(next).catch(() => undefined);\n      return;\n    }\n    this.setSignerModeInternal(next, { persist: true, notify: true });\n  }\n\n  private isSignerModeEqual(a: SignerMode, b: SignerMode): boolean {\n    if (a.mode !== b.mode) return false;\n    if (a.mode !== 'threshold-signer' || b.mode !== 'threshold-signer') return true;\n    return (a.behavior ?? null) === (b.behavior ?? null);\n  }\n\n  private setSignerModeInternal(next: SignerMode, opts: { persist: boolean; notify: boolean }): void {\n    const prev = this.signerMode;\n    this.signerMode = next;\n    if (opts.notify && !this.isSignerModeEqual(prev, next)) {\n      this.notifySignerModeChange(next);\n    }\n    if (opts.persist) {\n      // Best-effort persistence: only write when we have a current user context.\n      const id = this.currentUserAccountId;\n      if (!id || IndexedDBManager.clientDB.isDisabled()) return;\n      void IndexedDBManager.clientDB.setSignerMode(id, next).catch(() => undefined);\n    }\n  }\n}\n\n// Create and export singleton instance\nconst UserPreferencesInstance = new UserPreferencesManager();\nexport default UserPreferencesInstance;\n"],"mappings":"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"}

package/dist/esm/react/src/core/defaultConfigs.js

@@ -0,0 +1,106 @@
+import { toTrimmedString } from "../utils/validation.js";
+import { coerceSignerMode } from "./types/signer-worker.js";
+
+//#region src/core/defaultConfigs.ts
+const PASSKEY_MANAGER_DEFAULT_CONFIGS = {
+	nearRpcUrl: "https://test.rpc.fastnear.com, https://rpc.testnet.near.org",
+	nearNetwork: "testnet",
+	contractId: "w3a-v1.testnet",
+	nearExplorerUrl: "https://testnet.nearblocks.io",
+	signerMode: { mode: "local-signer" },
+	signingSessionDefaults: {
+		ttlMs: 0,
+		remainingUses: 0
+	},
+	relayer: {
+		url: "",
+		delegateActionRoute: "/signed-delegate",
+		emailRecovery: {
+			minBalanceYocto: "10000000000000000000000",
+			pollingIntervalMs: 4e3,
+			maxPollingDurationMs: 1800 * 1e3,
+			pendingTtlMs: 1800 * 1e3,
+			mailtoAddress: "recover@web3authn.org"
+		}
+	},
+	vrfWorkerConfigs: { shamir3pass: {
+		p: "3N5w46AIGjGT2v5Vua_TMD5Ywfa9U2F7-WzW8SNDsIM",
+		relayServerUrl: "",
+		applyServerLockRoute: "/vrf/apply-server-lock",
+		removeServerLockRoute: "/vrf/remove-server-lock"
+	} },
+	emailRecoveryContracts: {
+		emailRecovererGlobalContract: "w3a-email-recoverer-v1.testnet",
+		zkEmailVerifierContract: "zk-email-verifier-v1.testnet",
+		emailDkimVerifierContract: "email-dkim-verifier-v1.testnet"
+	},
+	iframeWallet: {
+		walletOrigin: "https://wallet.example.localhost",
+		walletServicePath: "/wallet-service",
+		sdkBasePath: "/sdk",
+		rpIdOverride: "example.localhost"
+	}
+};
+const THRESHOLD_ED25519_CLIENT_PARTICIPANT_ID = 1;
+const THRESHOLD_ED25519_RELAYER_PARTICIPANT_ID = 2;
+const DEFAULT_EMAIL_RECOVERY_CONTRACTS = {
+	emailRecovererGlobalContract: PASSKEY_MANAGER_DEFAULT_CONFIGS.emailRecoveryContracts.emailRecovererGlobalContract,
+	zkEmailVerifierContract: PASSKEY_MANAGER_DEFAULT_CONFIGS.emailRecoveryContracts.zkEmailVerifierContract,
+	emailDkimVerifierContract: PASSKEY_MANAGER_DEFAULT_CONFIGS.emailRecoveryContracts.emailDkimVerifierContract
+};
+function buildConfigsFromEnv(overrides = {}) {
+	const defaults = PASSKEY_MANAGER_DEFAULT_CONFIGS;
+	const relayerUrl = overrides.relayer?.url ?? defaults.relayer?.url ?? "";
+	const relayServerUrlDefault = relayerUrl;
+	const overrideShamirRelayServerUrl = overrides.vrfWorkerConfigs?.shamir3pass?.relayServerUrl;
+	const resolvedShamirRelayServerUrl = overrideShamirRelayServerUrl !== void 0 ? toTrimmedString(overrideShamirRelayServerUrl) ?? "" : toTrimmedString(defaults.vrfWorkerConfigs?.shamir3pass?.relayServerUrl) || relayServerUrlDefault;
+	const signerMode = coerceSignerMode(overrides.signerMode, defaults.signerMode);
+	const merged = {
+		nearRpcUrl: overrides.nearRpcUrl ?? defaults.nearRpcUrl,
+		nearNetwork: overrides.nearNetwork ?? defaults.nearNetwork,
+		contractId: overrides.contractId ?? defaults.contractId,
+		nearExplorerUrl: overrides.nearExplorerUrl ?? defaults.nearExplorerUrl,
+		walletTheme: overrides.walletTheme ?? defaults.walletTheme,
+		signerMode,
+		signingSessionDefaults: {
+			ttlMs: overrides.signingSessionDefaults?.ttlMs ?? defaults.signingSessionDefaults?.ttlMs,
+			remainingUses: overrides.signingSessionDefaults?.remainingUses ?? defaults.signingSessionDefaults?.remainingUses
+		},
+		relayer: {
+			url: relayerUrl,
+			delegateActionRoute: overrides.relayer?.delegateActionRoute ?? defaults.relayer?.delegateActionRoute,
+			emailRecovery: {
+				minBalanceYocto: overrides.relayer?.emailRecovery?.minBalanceYocto ?? defaults.relayer?.emailRecovery?.minBalanceYocto,
+				pollingIntervalMs: overrides.relayer?.emailRecovery?.pollingIntervalMs ?? defaults.relayer?.emailRecovery?.pollingIntervalMs,
+				maxPollingDurationMs: overrides.relayer?.emailRecovery?.maxPollingDurationMs ?? defaults.relayer?.emailRecovery?.maxPollingDurationMs,
+				pendingTtlMs: overrides.relayer?.emailRecovery?.pendingTtlMs ?? defaults.relayer?.emailRecovery?.pendingTtlMs,
+				mailtoAddress: overrides.relayer?.emailRecovery?.mailtoAddress ?? defaults.relayer?.emailRecovery?.mailtoAddress
+			}
+		},
+		authenticatorOptions: overrides.authenticatorOptions ?? defaults.authenticatorOptions,
+		vrfWorkerConfigs: { shamir3pass: {
+			p: overrides.vrfWorkerConfigs?.shamir3pass?.p ?? defaults.vrfWorkerConfigs?.shamir3pass?.p,
+			relayServerUrl: resolvedShamirRelayServerUrl,
+			applyServerLockRoute: overrides.vrfWorkerConfigs?.shamir3pass?.applyServerLockRoute ?? defaults.vrfWorkerConfigs?.shamir3pass?.applyServerLockRoute,
+			removeServerLockRoute: overrides.vrfWorkerConfigs?.shamir3pass?.removeServerLockRoute ?? defaults.vrfWorkerConfigs?.shamir3pass?.removeServerLockRoute
+		} },
+		emailRecoveryContracts: {
+			emailRecovererGlobalContract: overrides.emailRecoveryContracts?.emailRecovererGlobalContract ?? defaults.emailRecoveryContracts?.emailRecovererGlobalContract,
+			zkEmailVerifierContract: overrides.emailRecoveryContracts?.zkEmailVerifierContract ?? defaults.emailRecoveryContracts?.zkEmailVerifierContract,
+			emailDkimVerifierContract: overrides.emailRecoveryContracts?.emailDkimVerifierContract ?? defaults.emailRecoveryContracts?.emailDkimVerifierContract
+		},
+		iframeWallet: {
+			walletOrigin: overrides.iframeWallet?.walletOrigin ?? defaults.iframeWallet?.walletOrigin,
+			rpIdOverride: overrides.iframeWallet?.rpIdOverride ?? defaults.iframeWallet?.rpIdOverride,
+			walletServicePath: toTrimmedString(overrides.iframeWallet?.walletServicePath) || toTrimmedString(defaults.iframeWallet?.walletServicePath) || "/wallet-service",
+			sdkBasePath: toTrimmedString(overrides.iframeWallet?.sdkBasePath) || toTrimmedString(defaults.iframeWallet?.sdkBasePath) || "/sdk"
+		}
+	};
+	if (!merged.contractId) throw new Error("[configPresets] Missing required config: contractId");
+	if (!merged.relayer.url) throw new Error("[configPresets] Missing required config: relayer.url");
+	return merged;
+}
+
+//#endregion
+export { DEFAULT_EMAIL_RECOVERY_CONTRACTS, PASSKEY_MANAGER_DEFAULT_CONFIGS, THRESHOLD_ED25519_CLIENT_PARTICIPANT_ID, THRESHOLD_ED25519_RELAYER_PARTICIPANT_ID, buildConfigsFromEnv };
+//# sourceMappingURL=defaultConfigs.js.map

package/dist/esm/react/src/core/defaultConfigs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultConfigs.js","names":["PASSKEY_MANAGER_DEFAULT_CONFIGS: TatchiConfigs","DEFAULT_EMAIL_RECOVERY_CONTRACTS: EmailRecoveryContracts","merged: TatchiConfigs"],"sources":["../../../../../src/core/defaultConfigs.ts"],"sourcesContent":["import type { EmailRecoveryContracts, TatchiConfigs, TatchiConfigsInput } from './types/tatchi';\nimport { coerceSignerMode } from './types/signer-worker';\nimport { toTrimmedString } from '@/utils';\n\n// Default SDK configs suitable for local dev.\n// Cross-origin wallet isolation is recommended; set iframeWallet in your app config when you have a dedicated origin.\n// Consumers can shallow-merge overrides by field.\n\nexport const PASSKEY_MANAGER_DEFAULT_CONFIGS: TatchiConfigs = {\n  // You can provide a single URL or a comma-separated list for failover.\n  // First URL is treated as primary, subsequent URLs are fallbacks.\n  nearRpcUrl: 'https://test.rpc.fastnear.com, https://rpc.testnet.near.org',\n  nearNetwork: 'testnet',\n  contractId: 'w3a-v1.testnet',\n  nearExplorerUrl: 'https://testnet.nearblocks.io',\n  signerMode: { mode: 'local-signer' },\n  // Warm signing session defaults used by login/unlock flows.\n  // Enforcement (TTL/uses) is owned by the VRF worker; signer workers remain one-shot.\n  signingSessionDefaults: {\n    ttlMs: 0, // 0 minutes\n    remainingUses: 0, // default to requiring a touchID prompt for each transaction\n  },\n  relayer: {\n    // accountId: 'w3a-v1.testnet',\n    // No default relayer URL. Force apps to configure via env/overrides.\n    // Using an empty string triggers early validation errors in code paths that require it.\n    url: '',\n    delegateActionRoute: '/signed-delegate',\n    emailRecovery: {\n      // Require at least 0.01 NEAR available to start email recovery.\n      minBalanceYocto: '10000000000000000000000', // 0.01 NEAR\n      // Poll every 4 seconds for verification status / access key.\n      pollingIntervalMs: 4000,\n      // Stop polling after 30 minutes.\n      maxPollingDurationMs: 30 * 60 * 1000,\n      // Expire pending recovery records after 30 minutes.\n      pendingTtlMs: 30 * 60 * 1000,\n      // Default recovery mailbox for examples / docs.\n      mailtoAddress: 'recover@web3authn.org',\n    },\n  },\n  vrfWorkerConfigs: {\n    shamir3pass: {\n      // default Shamir's P in vrf-wasm-worker, needs to match relay server's Shamir P\n      p: '3N5w46AIGjGT2v5Vua_TMD5Ywfa9U2F7-WzW8SNDsIM',\n      // No default relay server URL to avoid accidental localhost usage in non-dev envs\n      // Defaults to relayer.url when undefined\n      relayServerUrl: '',\n      applyServerLockRoute: '/vrf/apply-server-lock',\n      removeServerLockRoute: '/vrf/remove-server-lock',\n    }\n  },\n  emailRecoveryContracts: {\n    emailRecovererGlobalContract: 'w3a-email-recoverer-v1.testnet',\n    zkEmailVerifierContract: 'zk-email-verifier-v1.testnet',\n    emailDkimVerifierContract: 'email-dkim-verifier-v1.testnet',\n  },\n  // Configure iframeWallet in application code to point at your dedicated wallet origin when available.\n  iframeWallet: {\n    walletOrigin: 'https://wallet.example.localhost',\n    walletServicePath: '/wallet-service',\n    sdkBasePath: '/sdk',\n    rpIdOverride: 'example.localhost',\n  }\n};\n\n// Default threshold participant identifiers (2P FROST).\n// These are intentionally exported as standalone constants so apps can reuse them when wiring\n// threshold signing across client + server environments.\nexport const THRESHOLD_ED25519_CLIENT_PARTICIPANT_ID = 1 as const;\nexport const THRESHOLD_ED25519_RELAYER_PARTICIPANT_ID = 2 as const;\nexport const THRESHOLD_ED25519_2P_PARTICIPANT_IDS = [\n  THRESHOLD_ED25519_CLIENT_PARTICIPANT_ID,\n  THRESHOLD_ED25519_RELAYER_PARTICIPANT_ID,\n] as const;\n\n// Threshold node roles.\n// Coordinator is the default because it exposes the public `/threshold-ed25519/sign/*` endpoints.\nexport const THRESHOLD_NODE_ROLE_COORDINATOR = 'coordinator' as const;\nexport const THRESHOLD_NODE_ROLE_DEFAULT = THRESHOLD_NODE_ROLE_COORDINATOR;\n\nexport const DEFAULT_EMAIL_RECOVERY_CONTRACTS: EmailRecoveryContracts = {\n  emailRecovererGlobalContract: PASSKEY_MANAGER_DEFAULT_CONFIGS.emailRecoveryContracts.emailRecovererGlobalContract,\n  zkEmailVerifierContract: PASSKEY_MANAGER_DEFAULT_CONFIGS.emailRecoveryContracts.zkEmailVerifierContract,\n  emailDkimVerifierContract: PASSKEY_MANAGER_DEFAULT_CONFIGS.emailRecoveryContracts.emailDkimVerifierContract,\n};\n\n// Merge defaults with overrides\nexport function buildConfigsFromEnv(overrides: TatchiConfigsInput = {}): TatchiConfigs {\n\n  const defaults = PASSKEY_MANAGER_DEFAULT_CONFIGS;\n  const relayerUrl = overrides.relayer?.url ?? defaults.relayer?.url ?? '';\n  // Prefer explicit override for relayer URL; fall back to default preset.\n  // Used below to default VRF relayServerUrl when it is undefined.\n  const relayServerUrlDefault = relayerUrl;\n  const overrideShamirRelayServerUrl = overrides.vrfWorkerConfigs?.shamir3pass?.relayServerUrl;\n  const resolvedShamirRelayServerUrl = overrideShamirRelayServerUrl !== undefined\n    ? toTrimmedString(overrideShamirRelayServerUrl) ?? ''\n    : toTrimmedString(defaults.vrfWorkerConfigs?.shamir3pass?.relayServerUrl) || relayServerUrlDefault;\n  const signerMode = coerceSignerMode(overrides.signerMode, defaults.signerMode);\n\n  const merged: TatchiConfigs = {\n    nearRpcUrl: overrides.nearRpcUrl ?? defaults.nearRpcUrl,\n    nearNetwork: overrides.nearNetwork ?? defaults.nearNetwork,\n    contractId: overrides.contractId ?? defaults.contractId,\n    nearExplorerUrl: overrides.nearExplorerUrl ?? defaults.nearExplorerUrl,\n    walletTheme: overrides.walletTheme ?? defaults.walletTheme,\n    signerMode,\n    signingSessionDefaults: {\n      ttlMs: overrides.signingSessionDefaults?.ttlMs\n        ?? defaults.signingSessionDefaults?.ttlMs,\n      remainingUses: overrides.signingSessionDefaults?.remainingUses\n        ?? defaults.signingSessionDefaults?.remainingUses,\n    },\n    relayer: {\n      url: relayerUrl,\n      delegateActionRoute: overrides.relayer?.delegateActionRoute\n        ?? defaults.relayer?.delegateActionRoute,\n      emailRecovery: {\n        minBalanceYocto: overrides.relayer?.emailRecovery?.minBalanceYocto\n          ?? defaults.relayer?.emailRecovery?.minBalanceYocto,\n        pollingIntervalMs: overrides.relayer?.emailRecovery?.pollingIntervalMs\n          ?? defaults.relayer?.emailRecovery?.pollingIntervalMs,\n        maxPollingDurationMs: overrides.relayer?.emailRecovery?.maxPollingDurationMs\n          ?? defaults.relayer?.emailRecovery?.maxPollingDurationMs,\n        pendingTtlMs: overrides.relayer?.emailRecovery?.pendingTtlMs\n          ?? defaults.relayer?.emailRecovery?.pendingTtlMs,\n        mailtoAddress: overrides.relayer?.emailRecovery?.mailtoAddress\n          ?? defaults.relayer?.emailRecovery?.mailtoAddress,\n      },\n    },\n    authenticatorOptions: overrides.authenticatorOptions ?? defaults.authenticatorOptions,\n    vrfWorkerConfigs: {\n      shamir3pass: {\n        p: overrides.vrfWorkerConfigs?.shamir3pass?.p\n          ?? defaults.vrfWorkerConfigs?.shamir3pass?.p,\n        relayServerUrl: resolvedShamirRelayServerUrl,\n        applyServerLockRoute: overrides.vrfWorkerConfigs?.shamir3pass?.applyServerLockRoute\n          ?? defaults.vrfWorkerConfigs?.shamir3pass?.applyServerLockRoute,\n        removeServerLockRoute: overrides.vrfWorkerConfigs?.shamir3pass?.removeServerLockRoute\n          ?? defaults.vrfWorkerConfigs?.shamir3pass?.removeServerLockRoute,\n      },\n    },\n    emailRecoveryContracts: {\n      emailRecovererGlobalContract: overrides.emailRecoveryContracts?.emailRecovererGlobalContract\n        ?? defaults.emailRecoveryContracts?.emailRecovererGlobalContract,\n      zkEmailVerifierContract: overrides.emailRecoveryContracts?.zkEmailVerifierContract\n        ?? defaults.emailRecoveryContracts?.zkEmailVerifierContract,\n      emailDkimVerifierContract: overrides.emailRecoveryContracts?.emailDkimVerifierContract\n        ?? defaults.emailRecoveryContracts?.emailDkimVerifierContract,\n    },\n    iframeWallet: {\n      // Preserve explicit empty-string walletOrigin (\"\") because it is used as a sentinel\n      // to disable iframe-wallet mode in tests and some apps.\n      walletOrigin: overrides.iframeWallet?.walletOrigin\n        ?? defaults.iframeWallet?.walletOrigin,\n      rpIdOverride: overrides.iframeWallet?.rpIdOverride\n        ?? defaults.iframeWallet?.rpIdOverride,\n      // IMPORTANT: the following fields are often wired from CI env vars like `VITE_SDK_BASE_PATH`.\n      // When a GitHub Actions env var is missing, expressions like `${{ vars.VITE_SDK_BASE_PATH }}`\n      // frequently become the empty string at build-time. Treat empty strings as \"unset\" so we\n      // fall back to SDK defaults instead of accidentally generating root-relative URLs like:\n      //   https://wallet.example.com/w3a-components.css  (wrong; should be /sdk/w3a-components.css)\n      walletServicePath: toTrimmedString(overrides.iframeWallet?.walletServicePath)\n        || toTrimmedString(defaults.iframeWallet?.walletServicePath)\n        || '/wallet-service',\n      sdkBasePath: toTrimmedString(overrides.iframeWallet?.sdkBasePath)\n        || toTrimmedString(defaults.iframeWallet?.sdkBasePath)\n        || '/sdk',\n    }\n  };\n  if (!merged.contractId) {\n    throw new Error('[configPresets] Missing required config: contractId');\n  }\n  if (!merged.relayer.url) {\n    throw new Error('[configPresets] Missing required config: relayer.url');\n  }\n  return merged;\n}\n"],"mappings":"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"}