@dynamic-labs/utils 2.1.0-alpha.3 → 2.1.0-alpha.31

package/CHANGELOG.md

@@ -1,4 +1,267 @@
 
+## [2.1.0-alpha.31](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.30...v2.1.0-alpha.31) (2024-05-31)
+
+
+### Bug Fixes
+
+* export solana private keys in the correct format ([#5809](https://github.com/dynamic-labs/DynamicAuth/issues/5809)) ([08ac1f8](https://github.com/dynamic-labs/DynamicAuth/commit/08ac1f87bb02ad07fd1fc1f544fdcc64ebe635b8))
+* magiceden evm network switching ([#5800](https://github.com/dynamic-labs/DynamicAuth/issues/5800)) ([9b86797](https://github.com/dynamic-labs/DynamicAuth/commit/9b8679735f3db4b33bb57409c3a69adf2beb82aa))
+* pass all signing inputs to createPsbtOptions ([#5798](https://github.com/dynamic-labs/DynamicAuth/issues/5798)) ([628ad4f](https://github.com/dynamic-labs/DynamicAuth/commit/628ad4f8c161496a0610ecbc3052735f8ceae98d))
+* trigger onboarding async ([#5805](https://github.com/dynamic-labs/DynamicAuth/issues/5805)) ([2c1f98c](https://github.com/dynamic-labs/DynamicAuth/commit/2c1f98c0d91422f75e2d6d32ea4a27c2bc8d8376))
+
+## [2.1.0-alpha.30](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.29...v2.1.0-alpha.30) (2024-05-31)
+
+
+### Bug Fixes
+
+* ensure initExpirationTime is called automatically after authenticating ([#5797](https://github.com/dynamic-labs/DynamicAuth/issues/5797)) ([87eb802](https://github.com/dynamic-labs/DynamicAuth/commit/87eb802e0c2d3af2ca116e07099bfef426d30a1f))
+* initExpirationTime should use expiresAt from storage ([#5799](https://github.com/dynamic-labs/DynamicAuth/issues/5799)) ([384ed17](https://github.com/dynamic-labs/DynamicAuth/commit/384ed1747d9b813ac0d34aaee36eb6480cb256d3))
+* only run useValidateSession once on rerender ([#5795](https://github.com/dynamic-labs/DynamicAuth/issues/5795)) ([ba4446d](https://github.com/dynamic-labs/DynamicAuth/commit/ba4446df95726248b877a84def959cabe81ad9b6))
+* store expiresAt timestamp from VerifyResponse in local storage for use in initExpirationTime ([#5796](https://github.com/dynamic-labs/DynamicAuth/issues/5796)) ([5f8aaeb](https://github.com/dynamic-labs/DynamicAuth/commit/5f8aaeb1cd45b10cb007f9eac25d18f50f142d8f))
+
+## [2.1.0-alpha.29](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.28...v2.1.0-alpha.29) (2024-05-30)
+
+
+### Features
+
+* add account and chain to coinbase walletClient ([#5776](https://github.com/dynamic-labs/DynamicAuth/issues/5776)) ([557091c](https://github.com/dynamic-labs/DynamicAuth/commit/557091c0efaec11273bd40b53c8bcd633c1bf48d))
+* add support for phantom btc ([#5717](https://github.com/dynamic-labs/DynamicAuth/issues/5717)) ([c61ca4f](https://github.com/dynamic-labs/DynamicAuth/commit/c61ca4f437796be2b420902de7e7de730725d122))
+
+
+### Bug Fixes
+
+* add phantom btc mobile redirect ([#5789](https://github.com/dynamic-labs/DynamicAuth/issues/5789)) ([aaa2654](https://github.com/dynamic-labs/DynamicAuth/commit/aaa26548668b0733e7930c1d7f5cc3937b3dfb50))
+* clear settings and configurations when logged out on page load ([#5787](https://github.com/dynamic-labs/DynamicAuth/issues/5787)) ([53c4d0b](https://github.com/dynamic-labs/DynamicAuth/commit/53c4d0b4686debdb43b1ab1b8b9e296ed4dd74b6))
+* lookup projectSettings from store to check if cookie enabled ([#5790](https://github.com/dynamic-labs/DynamicAuth/issues/5790)) ([6f2314b](https://github.com/dynamic-labs/DynamicAuth/commit/6f2314b0afef984e6caea79ead73d12c5c6d83f0))
+
+## [2.1.0-alpha.28](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.27...v2.1.0-alpha.28) (2024-05-29)
+
+
+### Features
+
+* adds solana standard wallet connector ([#5752](https://github.com/dynamic-labs/DynamicAuth/issues/5752)) ([0040940](https://github.com/dynamic-labs/DynamicAuth/commit/0040940fd1adb37ab3106bb0e4dfe79403bc41f2))
+
+
+### Bug Fixes
+
+* farcaster fetch url fix ([#5767](https://github.com/dynamic-labs/DynamicAuth/issues/5767)) ([1408ba9](https://github.com/dynamic-labs/DynamicAuth/commit/1408ba92680363b9db7820a63d5e3d15dc26ad22))
+
+## [2.1.0-alpha.27](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.26...v2.1.0-alpha.27) (2024-05-29)
+
+
+### Bug Fixes
+
+* coinbase connection ([#5764](https://github.com/dynamic-labs/DynamicAuth/issues/5764)) ([aeacd1c](https://github.com/dynamic-labs/DynamicAuth/commit/aeacd1c55dc471fbf8c14eb05ab356b0a90aa239))
+
+## [2.1.0-alpha.26](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.25...v2.1.0-alpha.26) (2024-05-29)
+
+
+### Features
+
+* add farcaster login to react native ([#5713](https://github.com/dynamic-labs/DynamicAuth/issues/5713)) ([08f4473](https://github.com/dynamic-labs/DynamicAuth/commit/08f4473eec9b32b82b6f703fa4d5136514a61b25))
+
+
+### Bug Fixes
+
+* better error handling of invalid mfa otp ([#5759](https://github.com/dynamic-labs/DynamicAuth/issues/5759)) ([72ab01f](https://github.com/dynamic-labs/DynamicAuth/commit/72ab01f8f919f147eeedfabf8b4838802abf308a))
+* show correct status for magic eden btc wallets after ([#5748](https://github.com/dynamic-labs/DynamicAuth/issues/5748)) ([b8f20bb](https://github.com/dynamic-labs/DynamicAuth/commit/b8f20bb796b9a2e88817ef3b0da6ac32e9012b18))
+
+## [2.1.0-alpha.25](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.24...v2.1.0-alpha.25) (2024-05-27)
+
+
+### Bug Fixes
+
+* btc balance calculation ([#5737](https://github.com/dynamic-labs/DynamicAuth/issues/5737)) ([9b5ceb3](https://github.com/dynamic-labs/DynamicAuth/commit/9b5ceb32d543037f60d7104f0b81b3abc86ebd10))
+
+## [2.1.0-alpha.24](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.23...v2.1.0-alpha.24) (2024-05-26)
+
+
+### Features
+
+* add onMfaCompleteOnce to useMfa ([#5702](https://github.com/dynamic-labs/DynamicAuth/issues/5702)) ([6451e33](https://github.com/dynamic-labs/DynamicAuth/commit/6451e3369ef1b4ba116378f0dd3fe4e82007e670))
+* prompt custom fields during onboarding ([#5302](https://github.com/dynamic-labs/DynamicAuth/issues/5302)) ([8664223](https://github.com/dynamic-labs/DynamicAuth/commit/86642232cf2b490a820169f48ba8dc093010e1a0))
+
+
+### Bug Fixes
+
+* correct text on pending signature screen to match the embedded widget modal text ([#5707](https://github.com/dynamic-labs/DynamicAuth/issues/5707)) ([44a6a06](https://github.com/dynamic-labs/DynamicAuth/commit/44a6a0664e08d4b9fc25dd86c0e30f8d585558e0))
+* pass captcha token for farcaster login ([#5706](https://github.com/dynamic-labs/DynamicAuth/issues/5706)) ([32bcb6e](https://github.com/dynamic-labs/DynamicAuth/commit/32bcb6e0e06c6e273c07f32893dfd550deeb6a19))
+* use coinbase provider to get connected accounts for consistency ([#5711](https://github.com/dynamic-labs/DynamicAuth/issues/5711)) ([b9e9170](https://github.com/dynamic-labs/DynamicAuth/commit/b9e9170dad1ac27a85a44a7177b82055ce0035cb))
+
+## [2.1.0-alpha.23](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.22...v2.1.0-alpha.23) (2024-05-23)
+
+
+### Features
+
+* add authFailure and authInit events ([#5659](https://github.com/dynamic-labs/DynamicAuth/issues/5659)) ([f4f592a](https://github.com/dynamic-labs/DynamicAuth/commit/f4f592aaacd96fae9333b803c235c5f1fea0e20e))
+* prompt mfa on signup and signin ([#5599](https://github.com/dynamic-labs/DynamicAuth/issues/5599)) ([8d4ecf4](https://github.com/dynamic-labs/DynamicAuth/commit/8d4ecf4c69c59c1fb14e79511fb2f9b33a7e3d89))
+
+
+### Bug Fixes
+
+* close auth modal if create embedded wallet throws ([#5683](https://github.com/dynamic-labs/DynamicAuth/issues/5683)) ([5331d73](https://github.com/dynamic-labs/DynamicAuth/commit/5331d731a171bb52a598eb5b25f7ba80cef7a64c))
+* prevent state update when the webview is unmounted ([#5688](https://github.com/dynamic-labs/DynamicAuth/issues/5688)) ([8e4ecbd](https://github.com/dynamic-labs/DynamicAuth/commit/8e4ecbdcdb5f48c57ecaad90d663c66529013192))
+* show phone number in use error message ([#5681](https://github.com/dynamic-labs/DynamicAuth/issues/5681)) ([e62f7b7](https://github.com/dynamic-labs/DynamicAuth/commit/e62f7b7b6a5e217944346faf2410028433cecad4))
+
+## [2.1.0-alpha.22](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.21...v2.1.0-alpha.22) (2024-05-21)
+
+## [2.1.0-alpha.21](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.20...v2.1.0-alpha.21) (2024-05-21)
+
+## [2.1.0-alpha.20](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.19...v2.1.0-alpha.20) (2024-05-21)
+
+
+### Features
+
+* adds client.networks module ([#5650](https://github.com/dynamic-labs/DynamicAuth/issues/5650)) ([70f7fe5](https://github.com/dynamic-labs/DynamicAuth/commit/70f7fe5f437756c51e787ac12183be0a23c51b89))
+* user fields supports custom fields ([#5639](https://github.com/dynamic-labs/DynamicAuth/issues/5639)) ([8eb5788](https://github.com/dynamic-labs/DynamicAuth/commit/8eb5788fc3e1286929f5949ecb57736b21b13fb5))
+
+
+### Bug Fixes
+
+* add webcredentials to expo ([#5640](https://github.com/dynamic-labs/DynamicAuth/issues/5640)) ([9026fbf](https://github.com/dynamic-labs/DynamicAuth/commit/9026fbf0108537e884588f3adcdb9f0db04a159b))
+* init ethers web3provider without a network if selected network is unsupported ([#5651](https://github.com/dynamic-labs/DynamicAuth/issues/5651)) ([e82040f](https://github.com/dynamic-labs/DynamicAuth/commit/e82040f424b17a70fac4400ab5b85a0dc6c0e35a))
+
+## [2.1.0-alpha.19](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.18...v2.1.0-alpha.19) (2024-05-17)
+
+
+### Features
+
+* add createUserProfileFromSDKUser ([#5596](https://github.com/dynamic-labs/DynamicAuth/issues/5596)) ([d37a1b4](https://github.com/dynamic-labs/DynamicAuth/commit/d37a1b4119f5ff4fff1e987d157f6d5abf105a8b))
+* add headless social sign-in ([#5439](https://github.com/dynamic-labs/DynamicAuth/issues/5439)) ([e32fdf8](https://github.com/dynamic-labs/DynamicAuth/commit/e32fdf863718d661b90b592c8df734e92386ddf3))
+* fetch custom fields in profile and update user ([#5627](https://github.com/dynamic-labs/DynamicAuth/issues/5627)) ([3940c25](https://github.com/dynamic-labs/DynamicAuth/commit/3940c2542bb330f3ed9a8eb98eed9d05c8fcb03a))
+
+
+### Bug Fixes
+
+* include applinks details to AASA ([#5635](https://github.com/dynamic-labs/DynamicAuth/issues/5635)) ([ce94fec](https://github.com/dynamic-labs/DynamicAuth/commit/ce94fec80adbb3eb4efcb79d1aa2cc6eb35eab6f))
+* include the appOrigin to every api call to create correct passkey ([#5636](https://github.com/dynamic-labs/DynamicAuth/issues/5636)) ([ee64df3](https://github.com/dynamic-labs/DynamicAuth/commit/ee64df3b90037bd29cca161e601973ef202c58f0))
+* use PromptModal when using the DynamicMultiWalletPromptsWidget for pending connection views ([#5594](https://github.com/dynamic-labs/DynamicAuth/issues/5594)) ([c095b6e](https://github.com/dynamic-labs/DynamicAuth/commit/c095b6e4c974f02cfe632963be92d16bb201dfa5))
+
+## [2.1.0-alpha.18](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.17...v2.1.0-alpha.18) (2024-05-15)
+
+## [2.1.0-alpha.17](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.16...v2.1.0-alpha.17) (2024-05-15)
+
+
+### Features
+
+* add coinbaseWalletPreference prop ([#5607](https://github.com/dynamic-labs/DynamicAuth/issues/5607)) ([1ac3b2c](https://github.com/dynamic-labs/DynamicAuth/commit/1ac3b2ce7abb136465f4aa88b045dfb70d99aad7))
+
+## [2.1.0-alpha.16](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.15...v2.1.0-alpha.16) (2024-05-14)
+
+
+### Features
+
+* add client.sdk.error with errors from the webview ([#5520](https://github.com/dynamic-labs/DynamicAuth/issues/5520)) ([a886927](https://github.com/dynamic-labs/DynamicAuth/commit/a8869273bf361c870d6e3cb82a28d9ccec65905b))
+* add setDefaultTabIndex to default the selected wallets tab ([#5593](https://github.com/dynamic-labs/DynamicAuth/issues/5593)) ([6e8ce05](https://github.com/dynamic-labs/DynamicAuth/commit/6e8ce053c4f6f009acc57dac55a8e9c74fbcc73b))
+* add visibility/auth-flow/user-profile to react-native ([#5564](https://github.com/dynamic-labs/DynamicAuth/issues/5564)) ([d93cea8](https://github.com/dynamic-labs/DynamicAuth/commit/d93cea82a123c6ec4d3d594a7dc064f4db2981c2))
+
+## [2.1.0-alpha.15](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.14...v2.1.0-alpha.15) (2024-05-13)
+
+
+### Bug Fixes
+
+* when a pregen is created, primaryWallet is not being setup ([#5584](https://github.com/dynamic-labs/DynamicAuth/issues/5584)) ([de08721](https://github.com/dynamic-labs/DynamicAuth/commit/de0872151e09f91dcbfaf1d043cf830f9df8d799))
+
+## [2.1.0-alpha.14](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.13...v2.1.0-alpha.14) (2024-05-09)
+
+
+### Features
+
+* add useSwitchWallet ([#5575](https://github.com/dynamic-labs/DynamicAuth/issues/5575)) ([d3053d9](https://github.com/dynamic-labs/DynamicAuth/commit/d3053d920110c26ef8052e77bf59e07dedc7c683))
+
+
+### Bug Fixes
+
+* linking phantom wallets in mobile ([#5524](https://github.com/dynamic-labs/DynamicAuth/issues/5524)) ([28d90f5](https://github.com/dynamic-labs/DynamicAuth/commit/28d90f5126b9c22535b63a3797cc060ef089fc63))
+* only show farcaster QR code if Social Login is enabled ([#5559](https://github.com/dynamic-labs/DynamicAuth/issues/5559)) ([fa71aaf](https://github.com/dynamic-labs/DynamicAuth/commit/fa71aaf0f80da31d397600b2fd0cbea99b3689a4))
+* remove goerli testnets and add sepolia ([#5565](https://github.com/dynamic-labs/DynamicAuth/issues/5565)) ([888eb03](https://github.com/dynamic-labs/DynamicAuth/commit/888eb031ef6f4dbbdc3015265cce8647d2c720b0))
+
+## [2.1.0-alpha.13](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.12...v2.1.0-alpha.13) (2024-05-03)
+
+
+### Bug Fixes
+
+* ensure Farcaster QR uses useSocialAuth hook ([#5550](https://github.com/dynamic-labs/DynamicAuth/issues/5550)) ([57fcd97](https://github.com/dynamic-labs/DynamicAuth/commit/57fcd97c44e3f52065dcf856acf7bca7b24fabc7))
+
+## [2.1.0-alpha.12](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.11...v2.1.0-alpha.12) (2024-05-02)
+
+
+### Features
+
+* display Farcaster QR code when it is the only login option ([#5514](https://github.com/dynamic-labs/DynamicAuth/issues/5514)) ([7b166d9](https://github.com/dynamic-labs/DynamicAuth/commit/7b166d9a30c581746f0e2edb71c44fc015dc128e))
+
+## [2.1.0-alpha.11](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.10...v2.1.0-alpha.11) (2024-05-02)
+
+
+### Features
+
+* **GVTY-1050:** add account token balances hook ([#5521](https://github.com/dynamic-labs/DynamicAuth/issues/5521)) ([5a6f937](https://github.com/dynamic-labs/DynamicAuth/commit/5a6f93733019f3b8d5c7a2c7a5537172a1e7eba4))
+* headless reveal embedded wallet key ([#5518](https://github.com/dynamic-labs/DynamicAuth/issues/5518)) ([77c1536](https://github.com/dynamic-labs/DynamicAuth/commit/77c15360b2b28c52cbdeafb3ce8ca7e80dbecf57))
+
+
+### Bug Fixes
+
+* fallback to walletconnect for zerion on mobile ([#5536](https://github.com/dynamic-labs/DynamicAuth/issues/5536)) ([f0e5bfe](https://github.com/dynamic-labs/DynamicAuth/commit/f0e5bfea0b2ab271fd4c1475c8ce708ecb1a5926))
+
+## [2.1.0-alpha.10](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.9...v2.1.0-alpha.10) (2024-04-30)
+
+
+### Features
+
+* bump @coinbase/wallet-sdk to latest beta ([#5388](https://github.com/dynamic-labs/DynamicAuth/issues/5388)) ([9225546](https://github.com/dynamic-labs/DynamicAuth/commit/922554630ccf2ef98bc297521309918f922bc671))
+
+## [2.1.0-alpha.9](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.8...v2.1.0-alpha.9) (2024-04-30)
+
+
+### Features
+
+* headless create embedded wallet with optional passkey data parameter ([#5487](https://github.com/dynamic-labs/DynamicAuth/issues/5487)) ([891c3d7](https://github.com/dynamic-labs/DynamicAuth/commit/891c3d77a02a019140bcb8dd03b62b1afd69710e))
+
+## [2.1.0-alpha.8](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.7...v2.1.0-alpha.8) (2024-04-26)
+
+
+### Bug Fixes
+
+* display wallet tabs when linking a wallet ([#5491](https://github.com/dynamic-labs/DynamicAuth/issues/5491)) ([10fd6b4](https://github.com/dynamic-labs/DynamicAuth/commit/10fd6b4d9aec7596338c50e17f79f6be534cf2c1))
+* ensure zerodev viem client handles eth_accounts call ([#5477](https://github.com/dynamic-labs/DynamicAuth/issues/5477)) ([1132e1e](https://github.com/dynamic-labs/DynamicAuth/commit/1132e1e8655b58e81cb56789453ba56a059f52ec))
+* network with keplr ([#5485](https://github.com/dynamic-labs/DynamicAuth/issues/5485)) ([b86f2fc](https://github.com/dynamic-labs/DynamicAuth/commit/b86f2fce491f9752e80a86643916da9ac7fb9276))
+* refetch nameservice data and display properly ([#5476](https://github.com/dynamic-labs/DynamicAuth/issues/5476)) ([2aee798](https://github.com/dynamic-labs/DynamicAuth/commit/2aee798846f69496201bec7aa52e7ec1f370b7c3))
+* use embeddedWallet create response authToken in embeddedWalletCreated ([#5478](https://github.com/dynamic-labs/DynamicAuth/issues/5478)) ([51772da](https://github.com/dynamic-labs/DynamicAuth/commit/51772daf557a72984c757efd8301e2b510dc37f1))
+
+## [2.1.0-alpha.7](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.6...v2.1.0-alpha.7) (2024-04-25)
+
+
+### Bug Fixes
+
+* restore embedded wallet session iframe element conflict ([#5474](https://github.com/dynamic-labs/DynamicAuth/issues/5474)) ([c157477](https://github.com/dynamic-labs/DynamicAuth/commit/c157477ea126b3130b13b711796bdd06215e7af1))
+
+## [2.1.0-alpha.6](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.5...v2.1.0-alpha.6) (2024-04-24)
+
+
+### Bug Fixes
+
+* embedded wallets headless session control fixes ([#5469](https://github.com/dynamic-labs/DynamicAuth/issues/5469)) ([92e6c35](https://github.com/dynamic-labs/DynamicAuth/commit/92e6c359d2710fd4f5f5a6fedc4acf6c4bab78ba))
+
+## [2.1.0-alpha.5](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.4...v2.1.0-alpha.5) (2024-04-23)
+
+
+### Bug Fixes
+
+* get embedded wallet checking the wrong chain enum ([#5458](https://github.com/dynamic-labs/DynamicAuth/issues/5458)) ([ed1c523](https://github.com/dynamic-labs/DynamicAuth/commit/ed1c523ca14cd4d21c00181ab40802f876c02b80))
+
+## [2.1.0-alpha.4](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.3...v2.1.0-alpha.4) (2024-04-23)
+
+
+### Features
+
+* add email and sms to client auth module ([#5436](https://github.com/dynamic-labs/DynamicAuth/issues/5436)) ([5420476](https://github.com/dynamic-labs/DynamicAuth/commit/5420476d1ba38fd4f987f28e9aefbfb3e61ea2bf))
+* headless create passkeys for embedded wallets ([#5395](https://github.com/dynamic-labs/DynamicAuth/issues/5395)) ([0b64099](https://github.com/dynamic-labs/DynamicAuth/commit/0b6409968457f65886248f0a0879e39ec3803fd0))
+
+
+### Bug Fixes
+
+* prevent wagmi from reconnect when DynamicContextProvider rerender ([#5446](https://github.com/dynamic-labs/DynamicAuth/issues/5446)) ([33337af](https://github.com/dynamic-labs/DynamicAuth/commit/33337af76786963cb3db7fa7c58c1292c529d0ac))
+
 ## [2.1.0-alpha.3](https://github.com/dynamic-labs/DynamicAuth/compare/v2.1.0-alpha.2...v2.1.0-alpha.3) (2024-04-23)
 
 

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@dynamic-labs/utils",
-  "version": "2.1.0-alpha.3",
+  "version": "2.1.0-alpha.31",
   "repository": {
     "type": "git",
-    "url": "https://github.com/dynamic-labs/DynamicAuth.git",
+    "url": "git+https://github.com/dynamic-labs/dynamic-auth.git",
     "directory": "packages/utils"
   },
   "description": "A React SDK for implementing wallet web3 authentication and authorization to your website.",
@@ -26,10 +26,10 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@dynamic-labs/sdk-api-core": "0.0.425",
+    "@dynamic-labs/sdk-api-core": "0.0.453",
     "tldts": "6.0.16",
-    "@dynamic-labs/logger": "2.1.0-alpha.3",
-    "@dynamic-labs/types": "2.1.0-alpha.3",
+    "@dynamic-labs/logger": "2.1.0-alpha.31",
+    "@dynamic-labs/types": "2.1.0-alpha.31",
     "buffer": "6.0.3"
   },
   "peerDependencies": {

package/src/errors/AccessBlockedError.cjs

@@ -0,0 +1,11 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var DynamicError = require('./DynamicError.cjs');
+
+class AccessBlockedError extends DynamicError.DynamicError {
+}
+
+exports.AccessBlockedError = AccessBlockedError;

package/src/errors/AccessBlockedError.d.ts

@@ -0,0 +1,3 @@
+import { DynamicError } from './DynamicError';
+export declare class AccessBlockedError extends DynamicError {
+}

package/src/errors/AccessBlockedError.js

@@ -0,0 +1,7 @@
+'use client'
+import { DynamicError } from './DynamicError.js';
+
+class AccessBlockedError extends DynamicError {
+}
+
+export { AccessBlockedError };

package/src/errors/CookieInvalidError.cjs

@@ -0,0 +1,14 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var DynamicError = require('./DynamicError.cjs');
+
+class CookieInvalidError extends DynamicError.DynamicError {
+    constructor() {
+        super('The cookie is invalid or expired');
+    }
+}
+
+exports.CookieInvalidError = CookieInvalidError;

package/src/errors/CookieInvalidError.d.ts

@@ -0,0 +1,4 @@
+import { DynamicError } from './DynamicError';
+export declare class CookieInvalidError extends DynamicError {
+    constructor();
+}

package/src/errors/CookieInvalidError.js

@@ -0,0 +1,10 @@
+'use client'
+import { DynamicError } from './DynamicError.js';
+
+class CookieInvalidError extends DynamicError {
+    constructor() {
+        super('The cookie is invalid or expired');
+    }
+}
+
+export { CookieInvalidError };

package/src/errors/CustomFieldNotUniqueError.cjs

@@ -0,0 +1,14 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var DynamicError = require('./DynamicError.cjs');
+
+class CustomFieldNotUniqueError extends DynamicError.DynamicError {
+    constructor() {
+        super('Custom Field for user must be unique within the environment', 'custom_field_data_not_unique');
+    }
+}
+
+exports.CustomFieldNotUniqueError = CustomFieldNotUniqueError;

package/src/errors/CustomFieldNotUniqueError.d.ts

@@ -0,0 +1,4 @@
+import { DynamicError } from './DynamicError';
+export declare class CustomFieldNotUniqueError extends DynamicError {
+    constructor();
+}

package/src/errors/CustomFieldNotUniqueError.js

@@ -0,0 +1,10 @@
+'use client'
+import { DynamicError } from './DynamicError.js';
+
+class CustomFieldNotUniqueError extends DynamicError {
+    constructor() {
+        super('Custom Field for user must be unique within the environment', 'custom_field_data_not_unique');
+    }
+}
+
+export { CustomFieldNotUniqueError };

package/src/errors/EmbeddedWalletException.cjs

@@ -0,0 +1,14 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var DynamicError = require('./DynamicError.cjs');
+
+class EmbeddedWalletException extends DynamicError.DynamicError {
+    constructor(message) {
+        super(message);
+    }
+}
+
+exports.EmbeddedWalletException = EmbeddedWalletException;

package/src/errors/EmbeddedWalletException.d.ts

@@ -0,0 +1,4 @@
+import { DynamicError } from './DynamicError';
+export declare class EmbeddedWalletException extends DynamicError {
+    constructor(message: string);
+}

package/src/errors/EmbeddedWalletException.js

@@ -0,0 +1,10 @@
+'use client'
+import { DynamicError } from './DynamicError.js';
+
+class EmbeddedWalletException extends DynamicError {
+    constructor(message) {
+        super(message);
+    }
+}
+
+export { EmbeddedWalletException };

package/src/errors/InvalidPhoneNumberError.cjs

@@ -6,8 +6,8 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var DynamicError = require('./DynamicError.cjs');
 
 class InvalidPhoneNumberError extends DynamicError.DynamicError {
-    constructor() {
-        super('Invalid phone number.');
+    constructor(error) {
+        super(error !== null && error !== void 0 ? error : 'Invalid phone number.');
     }
 }
 

package/src/errors/InvalidPhoneNumberError.d.ts

@@ -1,4 +1,4 @@
 import { DynamicError } from './DynamicError';
 export declare class InvalidPhoneNumberError extends DynamicError {
-    constructor();
+    constructor(error?: string);
 }

package/src/errors/InvalidPhoneNumberError.js

@@ -2,8 +2,8 @@
 import { DynamicError } from './DynamicError.js';
 
 class InvalidPhoneNumberError extends DynamicError {
-    constructor() {
-        super('Invalid phone number.');
+    constructor(error) {
+        super(error !== null && error !== void 0 ? error : 'Invalid phone number.');
     }
 }
 

package/src/errors/MfaInvalidOtpError.cjs

@@ -0,0 +1,14 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var DynamicError = require('./DynamicError.cjs');
+
+class MfaInvalidOtpError extends DynamicError.DynamicError {
+    constructor() {
+        super('Invalid MFA OTP');
+    }
+}
+
+exports.MfaInvalidOtpError = MfaInvalidOtpError;

package/src/errors/MfaInvalidOtpError.d.ts

@@ -0,0 +1,4 @@
+import { DynamicError } from './DynamicError';
+export declare class MfaInvalidOtpError extends DynamicError {
+    constructor();
+}

package/src/errors/MfaInvalidOtpError.js

@@ -0,0 +1,10 @@
+'use client'
+import { DynamicError } from './DynamicError.js';
+
+class MfaInvalidOtpError extends DynamicError {
+    constructor() {
+        super('Invalid MFA OTP');
+    }
+}
+
+export { MfaInvalidOtpError };

package/src/errors/index.d.ts

@@ -24,3 +24,8 @@ export * from './TooManyEmailVerificationsError';
 export * from './VerificationDataCollectionError';
 export * from './InvalidPhoneNumberError';
 export * from './MergeAccountsConfirmationError';
+export * from './CustomFieldNotUniqueError';
+export * from './CookieInvalidError';
+export * from './AccessBlockedError';
+export * from './EmbeddedWalletException';
+export * from './MfaInvalidOtpError';

package/src/getTLD/getTLD.cjs

@@ -3,17 +3,10 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var tldts = require('tldts');
+var PlatformService = require('../services/PlatformService/PlatformService.cjs');
+require('../../_virtual/_tslib.cjs');
+require('tldts');
 
-const getTLD = () => {
-    // Passing the allowPrivateDomains option prevents returning the actual TLD
-    // for domains that have delegated subdomains like herokuapp.com or s3.amazonaws.com
-    // full list is contained here https://publicsuffix.org/list/effective_tld_names.dat
-    // separated by ICANN DOMAINS and PRIVATE DOMAINS
-    // so for instance parse('someapp.herokuapp.com') will return 'someapp.herokuapp.com' as the domain
-    // whereas parse('app.dynamic.xyz') will return 'dynamic.xyz'
-    const data = tldts.parse(window.location.hostname, { allowPrivateDomains: true });
-    return data.domain || undefined;
-};
+const getTLD = () => PlatformService.PlatformService.getTLD();
 
 exports.getTLD = getTLD;

package/src/getTLD/getTLD.js

@@ -1,15 +1,8 @@
 'use client'
-import { parse } from 'tldts';
+import { PlatformService } from '../services/PlatformService/PlatformService.js';
+import '../../_virtual/_tslib.js';
+import 'tldts';
 
-const getTLD = () => {
-    // Passing the allowPrivateDomains option prevents returning the actual TLD
-    // for domains that have delegated subdomains like herokuapp.com or s3.amazonaws.com
-    // full list is contained here https://publicsuffix.org/list/effective_tld_names.dat
-    // separated by ICANN DOMAINS and PRIVATE DOMAINS
-    // so for instance parse('someapp.herokuapp.com') will return 'someapp.herokuapp.com' as the domain
-    // whereas parse('app.dynamic.xyz') will return 'dynamic.xyz'
-    const data = parse(window.location.hostname, { allowPrivateDomains: true });
-    return data.domain || undefined;
-};
+const getTLD = () => PlatformService.getTLD();
 
 export { getTLD };

package/src/index.cjs

@@ -30,6 +30,11 @@ var TooManyEmailVerificationsError = require('./errors/TooManyEmailVerifications
 var VerificationDataCollectionError = require('./errors/VerificationDataCollectionError.cjs');
 var InvalidPhoneNumberError = require('./errors/InvalidPhoneNumberError.cjs');
 var MergeAccountsConfirmationError = require('./errors/MergeAccountsConfirmationError.cjs');
+var CustomFieldNotUniqueError = require('./errors/CustomFieldNotUniqueError.cjs');
+var CookieInvalidError = require('./errors/CookieInvalidError.cjs');
+var AccessBlockedError = require('./errors/AccessBlockedError.cjs');
+var EmbeddedWalletException = require('./errors/EmbeddedWalletException.cjs');
+var MfaInvalidOtpError = require('./errors/MfaInvalidOtpError.cjs');
 var CancellablePromise = require('./CancellablePromise/CancellablePromise.cjs');
 var isFunction = require('./isFunction/isFunction.cjs');
 var isMobile = require('./isMobile.cjs');
@@ -51,6 +56,9 @@ var ceil = require('./ceil/ceil.cjs');
 var trimEnd = require('./trimEnd/trimEnd.cjs');
 var isLedgerAddressViaVerifiedCredentials = require('./isLedgerAddressViaVerifiedCredentials.cjs');
 var runSafe = require('./runSafe/runSafe.cjs');
+var PlatformService = require('./services/PlatformService/PlatformService.cjs');
+var createBrowserPlatformService = require('./services/PlatformService/createBrowserPlatformService/createBrowserPlatformService.cjs');
+var FetchService = require('./services/FetchService/FetchService.cjs');
 
 
 
@@ -81,6 +89,11 @@ exports.TooManyEmailVerificationsError = TooManyEmailVerificationsError.TooManyE
 exports.VerificationDataCollectionError = VerificationDataCollectionError.VerificationDataCollectionError;
 exports.InvalidPhoneNumberError = InvalidPhoneNumberError.InvalidPhoneNumberError;
 exports.MergeAccountsConfirmationError = MergeAccountsConfirmationError.MergeAccountsConfirmationError;
+exports.CustomFieldNotUniqueError = CustomFieldNotUniqueError.CustomFieldNotUniqueError;
+exports.CookieInvalidError = CookieInvalidError.CookieInvalidError;
+exports.AccessBlockedError = AccessBlockedError.AccessBlockedError;
+exports.EmbeddedWalletException = EmbeddedWalletException.EmbeddedWalletException;
+exports.MfaInvalidOtpError = MfaInvalidOtpError.MfaInvalidOtpError;
 exports.CancellablePromise = CancellablePromise.CancellablePromise;
 exports.isFunction = isFunction.isFunction;
 exports.getAndroidVersion = isMobile.getAndroidVersion;
@@ -116,3 +129,6 @@ exports.ceil = ceil.ceil;
 exports.trimEnd = trimEnd.trimEnd;
 exports.isLedgerAddressViaVerifiedCredentials = isLedgerAddressViaVerifiedCredentials.isLedgerAddressViaVerifiedCredentials;
 exports.runSafe = runSafe.runSafe;
+exports.PlatformService = PlatformService.PlatformService;
+exports.createBrowserPlatformService = createBrowserPlatformService.createBrowserPlatformService;
+exports.FetchService = FetchService.FetchService;

package/src/index.d.ts

@@ -22,3 +22,5 @@ export * from './ceil';
 export * from './trimEnd';
 export * from './isLedgerAddressViaVerifiedCredentials';
 export { runSafe } from './runSafe';
+export { PlatformService, createBrowserPlatformService, type IPlatformService, } from './services/PlatformService';
+export { FetchService } from './services/FetchService';

package/src/index.js

@@ -26,6 +26,11 @@ export { TooManyEmailVerificationsError } from './errors/TooManyEmailVerificatio
 export { VerificationDataCollectionError } from './errors/VerificationDataCollectionError.js';
 export { InvalidPhoneNumberError } from './errors/InvalidPhoneNumberError.js';
 export { MergeAccountsConfirmationError } from './errors/MergeAccountsConfirmationError.js';
+export { CustomFieldNotUniqueError } from './errors/CustomFieldNotUniqueError.js';
+export { CookieInvalidError } from './errors/CookieInvalidError.js';
+export { AccessBlockedError } from './errors/AccessBlockedError.js';
+export { EmbeddedWalletException } from './errors/EmbeddedWalletException.js';
+export { MfaInvalidOtpError } from './errors/MfaInvalidOtpError.js';
 export { CancellablePromise } from './CancellablePromise/CancellablePromise.js';
 export { isFunction } from './isFunction/isFunction.js';
 export { getAndroidVersion, isAndroid, isIOS, isIPad, isIPhone, isIPhone8OrEarlier, isLegacySafari, isMobile, isSamsungBrowser, isWindows } from './isMobile.js';
@@ -47,3 +52,6 @@ export { ceil } from './ceil/ceil.js';
 export { trimEnd } from './trimEnd/trimEnd.js';
 export { isLedgerAddressViaVerifiedCredentials } from './isLedgerAddressViaVerifiedCredentials.js';
 export { runSafe } from './runSafe/runSafe.js';
+export { PlatformService } from './services/PlatformService/PlatformService.js';
+export { createBrowserPlatformService } from './services/PlatformService/createBrowserPlatformService/createBrowserPlatformService.js';
+export { FetchService } from './services/FetchService/FetchService.js';

package/src/logger/logger.cjs

@@ -5,6 +5,6 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var logger$1 = require('@dynamic-labs/logger');
 
-const logger = new logger$1.Logger('magic');
+const logger = new logger$1.Logger('utils');
 
 exports.logger = logger;

package/src/logger/logger.js

@@ -1,6 +1,6 @@
 'use client'
 import { Logger } from '@dynamic-labs/logger';
 
-const logger = new Logger('magic');
+const logger = new Logger('utils');
 
 export { logger };

package/src/services/FetchService/FetchService.cjs

@@ -0,0 +1,24 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * Class implementing the fetch service with a configurable fetch implementation.
+ */
+class FetchService {
+    static get implementation() {
+        if (!FetchService._implementation) {
+            return { fetch: window.fetch.bind(window) };
+        }
+        return FetchService._implementation;
+    }
+    static setImplementation(implementation) {
+        FetchService._implementation = implementation;
+    }
+    static get fetch() {
+        return FetchService.implementation.fetch;
+    }
+}
+
+exports.FetchService = FetchService;

package/src/services/FetchService/FetchService.d.ts

@@ -0,0 +1,10 @@
+import { IFetchService } from './types';
+/**
+ * Class implementing the fetch service with a configurable fetch implementation.
+ */
+export declare class FetchService {
+    static _implementation: IFetchService;
+    static get implementation(): IFetchService;
+    static setImplementation(implementation: IFetchService): void;
+    static get fetch(): (input: RequestInfo, init?: RequestInit | undefined) => Promise<Response>;
+}

package/src/services/FetchService/FetchService.js

@@ -0,0 +1,20 @@
+'use client'
+/**
+ * Class implementing the fetch service with a configurable fetch implementation.
+ */
+class FetchService {
+    static get implementation() {
+        if (!FetchService._implementation) {
+            return { fetch: window.fetch.bind(window) };
+        }
+        return FetchService._implementation;
+    }
+    static setImplementation(implementation) {
+        FetchService._implementation = implementation;
+    }
+    static get fetch() {
+        return FetchService.implementation.fetch;
+    }
+}
+
+export { FetchService };

package/src/services/FetchService/index.d.ts

@@ -0,0 +1,2 @@
+export { FetchService } from './FetchService';
+export type { IFetchService } from './types';

package/src/services/FetchService/types.d.ts

@@ -0,0 +1,3 @@
+export type IFetchService = {
+    fetch: (input: RequestInfo, init?: RequestInit) => Promise<Response>;
+};

package/src/services/PlatformService/PlatformService.cjs

@@ -0,0 +1,39 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var createBrowserPlatformService = require('./createBrowserPlatformService/createBrowserPlatformService.cjs');
+
+class PlatformService {
+    static get implementation() {
+        if (!PlatformService._implementation) {
+            return createBrowserPlatformService.createBrowserPlatformService(window);
+        }
+        return PlatformService._implementation;
+    }
+    static setImplementation(implementation) {
+        PlatformService._implementation = implementation;
+    }
+    static get getOrigin() {
+        return PlatformService.implementation.getOrigin;
+    }
+    static get getHost() {
+        return PlatformService.implementation.getHost;
+    }
+    static get getHostname() {
+        return PlatformService.implementation.getHostname;
+    }
+    static get getTLD() {
+        return PlatformService.implementation.getTLD;
+    }
+    // Deeplink handling
+    static get openURL() {
+        return PlatformService.implementation.openURL;
+    }
+    static get openNewWindow() {
+        return PlatformService.implementation.openNewWindow;
+    }
+}
+
+exports.PlatformService = PlatformService;

package/src/services/PlatformService/PlatformService.d.ts

@@ -0,0 +1,12 @@
+import { IPlatformService } from './types';
+export declare class PlatformService {
+    static _implementation: IPlatformService;
+    static get implementation(): IPlatformService;
+    static setImplementation(implementation: IPlatformService): void;
+    static get getOrigin(): () => string;
+    static get getHost(): () => string;
+    static get getHostname(): () => string;
+    static get getTLD(): () => string | undefined;
+    static get openURL(): (url: string) => Promise<void>;
+    static get openNewWindow(): (url: string) => Promise<void>;
+}

package/src/services/PlatformService/PlatformService.js

@@ -0,0 +1,35 @@
+'use client'
+import { createBrowserPlatformService } from './createBrowserPlatformService/createBrowserPlatformService.js';
+
+class PlatformService {
+    static get implementation() {
+        if (!PlatformService._implementation) {
+            return createBrowserPlatformService(window);
+        }
+        return PlatformService._implementation;
+    }
+    static setImplementation(implementation) {
+        PlatformService._implementation = implementation;
+    }
+    static get getOrigin() {
+        return PlatformService.implementation.getOrigin;
+    }
+    static get getHost() {
+        return PlatformService.implementation.getHost;
+    }
+    static get getHostname() {
+        return PlatformService.implementation.getHostname;
+    }
+    static get getTLD() {
+        return PlatformService.implementation.getTLD;
+    }
+    // Deeplink handling
+    static get openURL() {
+        return PlatformService.implementation.openURL;
+    }
+    static get openNewWindow() {
+        return PlatformService.implementation.openNewWindow;
+    }
+}
+
+export { PlatformService };

package/src/services/PlatformService/createBrowserPlatformService/createBrowserPlatformService.cjs

@@ -0,0 +1,33 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../../../_virtual/_tslib.cjs');
+var tldts = require('tldts');
+
+const createBrowserPlatformService = (window) => ({
+    getHost: () => window.location.host,
+    getHostname: () => window.location.hostname,
+    getOrigin: () => window.location.origin,
+    getTLD: () => {
+        // Passing the allowPrivateDomains option prevents returning the actual TLD
+        // for domains that have delegated subdomains like herokuapp.com or s3.amazonaws.com
+        // full list is contained here https://publicsuffix.org/list/effective_tld_names.dat
+        // separated by ICANN DOMAINS and PRIVATE DOMAINS
+        // so for instance parse('someapp.herokuapp.com') will return 'someapp.herokuapp.com' as the domain
+        // whereas parse('app.dynamic.xyz') will return 'dynamic.xyz'
+        const data = tldts.parse(window.location.hostname, {
+            allowPrivateDomains: true,
+        });
+        return data.domain || undefined;
+    },
+    openNewWindow: (url) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        window.open(url);
+    }),
+    openURL: (url) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        window.location.assign(url);
+    }),
+});
+
+exports.createBrowserPlatformService = createBrowserPlatformService;

package/src/services/PlatformService/createBrowserPlatformService/createBrowserPlatformService.d.ts

@@ -0,0 +1,2 @@
+import { IPlatformService } from '../types';
+export declare const createBrowserPlatformService: (window: Window) => IPlatformService;

package/src/services/PlatformService/createBrowserPlatformService/createBrowserPlatformService.js

@@ -0,0 +1,29 @@
+'use client'
+import { __awaiter } from '../../../../_virtual/_tslib.js';
+import { parse } from 'tldts';
+
+const createBrowserPlatformService = (window) => ({
+    getHost: () => window.location.host,
+    getHostname: () => window.location.hostname,
+    getOrigin: () => window.location.origin,
+    getTLD: () => {
+        // Passing the allowPrivateDomains option prevents returning the actual TLD
+        // for domains that have delegated subdomains like herokuapp.com or s3.amazonaws.com
+        // full list is contained here https://publicsuffix.org/list/effective_tld_names.dat
+        // separated by ICANN DOMAINS and PRIVATE DOMAINS
+        // so for instance parse('someapp.herokuapp.com') will return 'someapp.herokuapp.com' as the domain
+        // whereas parse('app.dynamic.xyz') will return 'dynamic.xyz'
+        const data = parse(window.location.hostname, {
+            allowPrivateDomains: true,
+        });
+        return data.domain || undefined;
+    },
+    openNewWindow: (url) => __awaiter(void 0, void 0, void 0, function* () {
+        window.open(url);
+    }),
+    openURL: (url) => __awaiter(void 0, void 0, void 0, function* () {
+        window.location.assign(url);
+    }),
+});
+
+export { createBrowserPlatformService };

package/src/services/PlatformService/createBrowserPlatformService/index.d.ts

@@ -0,0 +1 @@
+export { createBrowserPlatformService } from './createBrowserPlatformService';

package/src/services/PlatformService/index.d.ts

@@ -0,0 +1,3 @@
+export * from './PlatformService';
+export * from './createBrowserPlatformService';
+export * from './types';

package/src/services/PlatformService/types.d.ts

@@ -0,0 +1,29 @@
+export interface IPlatformService {
+    /**
+     * Gets the hostname of the current location.
+     *
+     * @example window.location.hostname
+     */
+    getHostname(): string;
+    /**
+     * Gets the host of the current location.
+     *
+     * @example window.location.host
+     */
+    getHost(): string;
+    /**
+     * Gets the origin of the current location.
+     *
+     * @example window.location.origin
+     */
+    getOrigin(): string;
+    getTLD(): string | undefined;
+    /**
+     * Opens a URL. If possible, should avoid new windows.
+     */
+    openURL(url: string): Promise<void>;
+    /**
+     * Opens a given URL in a new window.
+     */
+    openNewWindow(url: string): Promise<void>;
+}