@dynamic-labs/utils 3.0.0-alpha.46 → 3.0.0-alpha.48

package/CHANGELOG.md

@@ -1,4 +1,38 @@
 
+## [3.0.0-alpha.48](https://github.com/dynamic-labs/DynamicAuth/compare/v3.0.0-alpha.47...v3.0.0-alpha.48) (2024-08-21)
+
+
+### Bug Fixes
+
+* collect user data to work when no wallet is selected ([#6670](https://github.com/dynamic-labs/DynamicAuth/issues/6670)) ([b86aae8](https://github.com/dynamic-labs/DynamicAuth/commit/b86aae8e7ceb35793f792941a34cabd19b9e65d4))
+* disable cookie when running on native mobile ([#6668](https://github.com/dynamic-labs/DynamicAuth/issues/6668)) ([e52a3d9](https://github.com/dynamic-labs/DynamicAuth/commit/e52a3d94a9028e36525be2e80a9f0916efad4320))
+* prevent external auth blocking pending user requirements views ([#6669](https://github.com/dynamic-labs/DynamicAuth/issues/6669)) ([848356c](https://github.com/dynamic-labs/DynamicAuth/commit/848356c57e730a8516c642da84274a236e026f40))
+
+## [3.0.0-alpha.47](https://github.com/dynamic-labs/DynamicAuth/compare/v3.0.0-alpha.46...v3.0.0-alpha.47) (2024-08-21)
+
+
+### ⚠ BREAKING CHANGES
+
+* rename useSelectWalletOption to useWalletOptions (#6616)
+* stop exposing walletConnectorOptions from dynamic context (#6622)
+
+### Features
+
+* add support for base.eth ens resolution ([#6655](https://github.com/dynamic-labs/DynamicAuth/issues/6655)) ([e2fb1c0](https://github.com/dynamic-labs/DynamicAuth/commit/e2fb1c0ca8410e85b7464d032abc6686bd46149f))
+* expose wallet options from useWalletOptions hook ([#6624](https://github.com/dynamic-labs/DynamicAuth/issues/6624)) ([7287359](https://github.com/dynamic-labs/DynamicAuth/commit/7287359d1564564b87e82bf182edef8ef02c16f1))
+* global wallet chain switching ([#6648](https://github.com/dynamic-labs/DynamicAuth/issues/6648)) ([10179fc](https://github.com/dynamic-labs/DynamicAuth/commit/10179fcddc747977c7dd250abd78bad0ec375f8f))
+* implement Apple Sign-In for mobile ([#6632](https://github.com/dynamic-labs/DynamicAuth/issues/6632)) ([e68b088](https://github.com/dynamic-labs/DynamicAuth/commit/e68b088b1c13c1140b43a6d0c215383455a71a4a))
+* surface mfa rate limit error ([#6658](https://github.com/dynamic-labs/DynamicAuth/issues/6658)) ([5fbcbc2](https://github.com/dynamic-labs/DynamicAuth/commit/5fbcbc2382ebcf2721a308d8e87bc8b2b5cb38cf))
+
+
+### Bug Fixes
+
+* update bottom nav border radius ([#6651](https://github.com/dynamic-labs/DynamicAuth/issues/6651)) ([79212c2](https://github.com/dynamic-labs/DynamicAuth/commit/79212c26735eb06f31655e8b98a3d9c2c8371489))
+
+
+* rename useSelectWalletOption to useWalletOptions ([#6616](https://github.com/dynamic-labs/DynamicAuth/issues/6616)) ([3850dad](https://github.com/dynamic-labs/DynamicAuth/commit/3850dad47f847ace84aadc63a84c4e62f84f7df2))
+* stop exposing walletConnectorOptions from dynamic context ([#6622](https://github.com/dynamic-labs/DynamicAuth/issues/6622)) ([b9da7db](https://github.com/dynamic-labs/DynamicAuth/commit/b9da7dbfc4020913ba3d95ec496811e9d8ee17b8))
+
 ## [3.0.0-alpha.46](https://github.com/dynamic-labs/DynamicAuth/compare/v3.0.0-alpha.45...v3.0.0-alpha.46) (2024-08-19)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/utils",
-  "version": "3.0.0-alpha.46",
+  "version": "3.0.0-alpha.48",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/dynamic-labs/dynamic-auth.git",
@@ -26,10 +26,10 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@dynamic-labs/sdk-api-core": "0.0.516",
+    "@dynamic-labs/sdk-api-core": "0.0.519",
     "tldts": "6.0.16",
-    "@dynamic-labs/logger": "3.0.0-alpha.46",
-    "@dynamic-labs/types": "3.0.0-alpha.46",
+    "@dynamic-labs/logger": "3.0.0-alpha.48",
+    "@dynamic-labs/types": "3.0.0-alpha.48",
     "buffer": "6.0.3",
     "stream": "0.0.2"
   },

package/src/errors/MfaRateLimitedError.cjs

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

package/src/errors/MfaRateLimitedError.d.ts

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

package/src/errors/MfaRateLimitedError.js

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

package/src/errors/index.d.ts

@@ -30,5 +30,6 @@ export * from './CookieInvalidError';
 export * from './AccessBlockedError';
 export * from './EmbeddedWalletException';
 export * from './MfaInvalidOtpError';
+export * from './MfaRateLimitedError';
 export * from './ExternalAuthError';
 export * from './WalletAddressMismatchError';

package/src/index.cjs

@@ -36,6 +36,7 @@ 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 MfaRateLimitedError = require('./errors/MfaRateLimitedError.cjs');
 var ExternalAuthError = require('./errors/ExternalAuthError.cjs');
 var WalletAddressMismatchError = require('./errors/WalletAddressMismatchError.cjs');
 var CancellablePromise = require('./CancellablePromise/CancellablePromise.cjs');
@@ -105,6 +106,7 @@ exports.CookieInvalidError = CookieInvalidError.CookieInvalidError;
 exports.AccessBlockedError = AccessBlockedError.AccessBlockedError;
 exports.EmbeddedWalletException = EmbeddedWalletException.EmbeddedWalletException;
 exports.MfaInvalidOtpError = MfaInvalidOtpError.MfaInvalidOtpError;
+exports.MfaRateLimitedError = MfaRateLimitedError.MfaRateLimitedError;
 exports.ExternalAuthError = ExternalAuthError.ExternalAuthError;
 exports.WalletAddressMismatchError = WalletAddressMismatchError.WalletAddressMismatchError;
 exports.CancellablePromise = CancellablePromise.CancellablePromise;
@@ -117,6 +119,7 @@ exports.isIPhone = isMobile.isIPhone;
 exports.isIPhone8OrEarlier = isMobile.isIPhone8OrEarlier;
 exports.isLegacySafari = isMobile.isLegacySafari;
 exports.isMobile = isMobile.isMobile;
+exports.isSafariBrowser = isMobile.isSafariBrowser;
 exports.isSamsungBrowser = isMobile.isSamsungBrowser;
 exports.isWindows = isMobile.isWindows;
 exports.getItemAsync = localStorageAsync.getItemAsync;

package/src/index.js

@@ -32,11 +32,12 @@ 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 { MfaRateLimitedError } from './errors/MfaRateLimitedError.js';
 export { ExternalAuthError } from './errors/ExternalAuthError.js';
 export { WalletAddressMismatchError } from './errors/WalletAddressMismatchError.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';
+export { getAndroidVersion, isAndroid, isIOS, isIPad, isIPhone, isIPhone8OrEarlier, isLegacySafari, isMobile, isSafariBrowser, isSamsungBrowser, isWindows } from './isMobile.js';
 export { getItemAsync, removeItemAsync, setItemAsync } from './localStorageAsync.js';
 export { bufferToBase64 } from './bufferToBase64.js';
 export { last } from './last.js';

package/src/isMobile.cjs

@@ -65,6 +65,16 @@ const isSamsungBrowser = () => {
     }
     return navigator.userAgent.includes('SamsungBrowser');
 };
+const isSafariBrowser = () => {
+    if (typeof window === 'undefined' || typeof navigator === 'undefined') {
+        return false;
+    }
+    const { userAgent } = navigator;
+    const isSafari = userAgent.includes('Safari') &&
+        !userAgent.includes('Chrome') &&
+        !userAgent.includes('Chromium');
+    return isSafari;
+};
 const isWindows = () => {
     if (typeof window === 'undefined' || typeof navigator === 'undefined') {
         return false;
@@ -142,5 +152,6 @@ exports.isIPhone = isIPhone;
 exports.isIPhone8OrEarlier = isIPhone8OrEarlier;
 exports.isLegacySafari = isLegacySafari;
 exports.isMobile = isMobile;
+exports.isSafariBrowser = isSafariBrowser;
 exports.isSamsungBrowser = isSamsungBrowser;
 exports.isWindows = isWindows;

package/src/isMobile.d.ts

@@ -14,5 +14,6 @@ export declare const isIOS: (maxTouchPointsOverride?: number) => boolean;
 export declare const isAndroid: () => boolean;
 export declare const isLegacySafari: () => boolean;
 export declare const isSamsungBrowser: () => boolean;
+export declare const isSafariBrowser: () => boolean;
 export declare const isWindows: () => boolean;
 export declare const getAndroidVersion: () => number | undefined;

package/src/isMobile.js

@@ -61,6 +61,16 @@ const isSamsungBrowser = () => {
     }
     return navigator.userAgent.includes('SamsungBrowser');
 };
+const isSafariBrowser = () => {
+    if (typeof window === 'undefined' || typeof navigator === 'undefined') {
+        return false;
+    }
+    const { userAgent } = navigator;
+    const isSafari = userAgent.includes('Safari') &&
+        !userAgent.includes('Chrome') &&
+        !userAgent.includes('Chromium');
+    return isSafari;
+};
 const isWindows = () => {
     if (typeof window === 'undefined' || typeof navigator === 'undefined') {
         return false;
@@ -130,4 +140,4 @@ const getAndroidVersion = () => {
     return androidVersion;
 };
 
-export { getAndroidVersion, isAndroid, isIOS, isIPad, isIPhone, isIPhone8OrEarlier, isLegacySafari, isMobile, isSamsungBrowser, isWindows };
+export { getAndroidVersion, isAndroid, isIOS, isIPad, isIPhone, isIPhone8OrEarlier, isLegacySafari, isMobile, isSafariBrowser, isSamsungBrowser, isWindows };

package/src/services/Oauth2Service/Oauth2Service.d.ts

@@ -6,7 +6,9 @@ export type GetOauthCodeProps = {
     setIsProcessing: (value: boolean) => void;
     onSettled?: VoidFunction;
     getOAuthResultFromApi: () => Promise<OauthResultResponse | undefined>;
-    initWebAuth: () => Promise<void>;
+    initWebAuth: (options?: {
+        redirectUrl?: string;
+    }) => Promise<void>;
     state: string;
     oauthLoginUrl: URL;
     sessionTimeout: number;

package/src/services/Oauth2Service/createWindowOauth2Service/createWindowOauth2Service.cjs

@@ -6,15 +6,32 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var _tslib = require('../../../../_virtual/_tslib.cjs');
 var types = require('@dynamic-labs/types');
 var logger = require('../../../logger/logger.cjs');
+var connectWithAppleId = require('../utils/connectWithAppleId/connectWithAppleId.cjs');
+var isMobile = require('../../../isMobile.cjs');
 
 let authWindowInterval;
 const createWindowOauth2Service = () => ({
-    getOauthCode: ({ apiProvider, provider, setIsProcessing, state, oauthLoginUrl, isMobile, initWebAuth, }) => new Promise((resolve, _reject) => {
+    getOauthCode: ({ apiProvider, provider, redirectUrl, setIsProcessing, state, oauthLoginUrl, isMobile: isMobile$1, initWebAuth, }) => new Promise((resolve, _reject) => {
+        /**
+         * Use AppleID SDK for Apple provider on mobile
+         */
+        if ((isMobile$1 || isMobile.isSafariBrowser()) && provider === types.ProviderEnum.Apple) {
+            initWebAuth({
+                redirectUrl: redirectUrl || window.location.href,
+            }).then(() => connectWithAppleId.connectWithAppleId({
+                clientId: apiProvider === null || apiProvider === void 0 ? void 0 : apiProvider.clientId,
+                oauthLoginUrl,
+                state,
+            }).catch(_reject));
+            return;
+        }
         /**
          * Use redirect flow on mobile for all providers except Telegram
          */
-        if (isMobile && provider !== types.ProviderEnum.Telegram) {
-            initWebAuth().then(() => {
+        if (isMobile$1 && provider !== types.ProviderEnum.Telegram) {
+            initWebAuth({
+                redirectUrl: redirectUrl || window.location.href,
+            }).then(() => {
                 window.location.assign(oauthLoginUrl);
             });
             return;

package/src/services/Oauth2Service/createWindowOauth2Service/createWindowOauth2Service.js

@@ -2,15 +2,32 @@
 import { __awaiter } from '../../../../_virtual/_tslib.js';
 import { ProviderEnum, SocialOAuthErrorCode } from '@dynamic-labs/types';
 import { logger } from '../../../logger/logger.js';
+import { connectWithAppleId } from '../utils/connectWithAppleId/connectWithAppleId.js';
+import { isSafariBrowser } from '../../../isMobile.js';
 
 let authWindowInterval;
 const createWindowOauth2Service = () => ({
-    getOauthCode: ({ apiProvider, provider, setIsProcessing, state, oauthLoginUrl, isMobile, initWebAuth, }) => new Promise((resolve, _reject) => {
+    getOauthCode: ({ apiProvider, provider, redirectUrl, setIsProcessing, state, oauthLoginUrl, isMobile, initWebAuth, }) => new Promise((resolve, _reject) => {
+        /**
+         * Use AppleID SDK for Apple provider on mobile
+         */
+        if ((isMobile || isSafariBrowser()) && provider === ProviderEnum.Apple) {
+            initWebAuth({
+                redirectUrl: redirectUrl || window.location.href,
+            }).then(() => connectWithAppleId({
+                clientId: apiProvider === null || apiProvider === void 0 ? void 0 : apiProvider.clientId,
+                oauthLoginUrl,
+                state,
+            }).catch(_reject));
+            return;
+        }
         /**
          * Use redirect flow on mobile for all providers except Telegram
          */
         if (isMobile && provider !== ProviderEnum.Telegram) {
-            initWebAuth().then(() => {
+            initWebAuth({
+                redirectUrl: redirectUrl || window.location.href,
+            }).then(() => {
                 window.location.assign(oauthLoginUrl);
             });
             return;

package/src/services/Oauth2Service/utils/connectWithAppleId/connectWithAppleId.cjs

@@ -0,0 +1,26 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../../../../_virtual/_tslib.cjs');
+var loadAppleId = require('../loadAppleId/loadAppleId.cjs');
+
+const connectWithAppleId = (_a) => _tslib.__awaiter(void 0, [_a], void 0, function* ({ clientId, oauthLoginUrl, state, }) {
+    yield loadAppleId.loadAppleId();
+    // Because the AppleID is loaded from a script tag, there is not type for it
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    AppleID.auth.init({
+        clientId,
+        redirectURI: oauthLoginUrl.searchParams.get('redirect_uri'),
+        scope: 'name email',
+        state,
+        usePopup: false,
+    });
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    AppleID.auth.signIn();
+});
+
+exports.connectWithAppleId = connectWithAppleId;

package/src/services/Oauth2Service/utils/connectWithAppleId/connectWithAppleId.d.ts

@@ -0,0 +1,7 @@
+type ConnectWithAppleIdOptions = {
+    clientId: string | undefined;
+    oauthLoginUrl: URL;
+    state: string;
+};
+export declare const connectWithAppleId: ({ clientId, oauthLoginUrl, state, }: ConnectWithAppleIdOptions) => Promise<void>;
+export {};

package/src/services/Oauth2Service/utils/connectWithAppleId/connectWithAppleId.js

@@ -0,0 +1,22 @@
+'use client'
+import { __awaiter } from '../../../../../_virtual/_tslib.js';
+import { loadAppleId } from '../loadAppleId/loadAppleId.js';
+
+const connectWithAppleId = (_a) => __awaiter(void 0, [_a], void 0, function* ({ clientId, oauthLoginUrl, state, }) {
+    yield loadAppleId();
+    // Because the AppleID is loaded from a script tag, there is not type for it
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    AppleID.auth.init({
+        clientId,
+        redirectURI: oauthLoginUrl.searchParams.get('redirect_uri'),
+        scope: 'name email',
+        state,
+        usePopup: false,
+    });
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    AppleID.auth.signIn();
+});
+
+export { connectWithAppleId };

package/src/services/Oauth2Service/utils/connectWithAppleId/index.d.ts

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

package/src/services/Oauth2Service/utils/loadAppleId/index.d.ts

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

package/src/services/Oauth2Service/utils/loadAppleId/loadAppleId.cjs

@@ -0,0 +1,34 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+const appleIdScriptSrc = 'https://appleid.cdn-apple.com/appleauth/static/jsapi/appleid/1/en_US/appleid.auth.js';
+const loadAppleId = () => new Promise((resolve, reject) => {
+    const script = document.querySelector('script[data-apple-sdk]');
+    if (script) {
+        // Script already exists, attach event listeners
+        if (script.hasAttribute('data-loaded')) {
+            resolve();
+        }
+        else {
+            script.addEventListener('load', () => resolve());
+            script.addEventListener('error', () => reject(new Error('Failed to load Apple SDK')));
+        }
+    }
+    else {
+        // If the script does not exist, create and add it
+        const script = document.createElement('script');
+        script.type = 'text/javascript';
+        script.src = appleIdScriptSrc;
+        script.setAttribute('data-apple-sdk', 'true');
+        script.onload = () => {
+            script === null || script === void 0 ? void 0 : script.setAttribute('data-loaded', 'true');
+            resolve();
+        };
+        script.onerror = () => reject(new Error('Failed to load Apple SDK'));
+        window.document.head.appendChild(script);
+    }
+});
+
+exports.loadAppleId = loadAppleId;

package/src/services/Oauth2Service/utils/loadAppleId/loadAppleId.d.ts

@@ -0,0 +1 @@
+export declare const loadAppleId: () => Promise<void>;

package/src/services/Oauth2Service/utils/loadAppleId/loadAppleId.js

@@ -0,0 +1,30 @@
+'use client'
+const appleIdScriptSrc = 'https://appleid.cdn-apple.com/appleauth/static/jsapi/appleid/1/en_US/appleid.auth.js';
+const loadAppleId = () => new Promise((resolve, reject) => {
+    const script = document.querySelector('script[data-apple-sdk]');
+    if (script) {
+        // Script already exists, attach event listeners
+        if (script.hasAttribute('data-loaded')) {
+            resolve();
+        }
+        else {
+            script.addEventListener('load', () => resolve());
+            script.addEventListener('error', () => reject(new Error('Failed to load Apple SDK')));
+        }
+    }
+    else {
+        // If the script does not exist, create and add it
+        const script = document.createElement('script');
+        script.type = 'text/javascript';
+        script.src = appleIdScriptSrc;
+        script.setAttribute('data-apple-sdk', 'true');
+        script.onload = () => {
+            script === null || script === void 0 ? void 0 : script.setAttribute('data-loaded', 'true');
+            resolve();
+        };
+        script.onerror = () => reject(new Error('Failed to load Apple SDK'));
+        window.document.head.appendChild(script);
+    }
+});
+
+export { loadAppleId };

package/src/services/PlatformService/PlatformService.cjs

@@ -17,19 +17,43 @@ class PlatformService {
     static set implementation(implementation) {
         _tslib.__classPrivateFieldSet(_a, _a, implementation, "f", _PlatformService_implementation);
     }
+    /**
+     * Indicates if the current platform is a native mobile app
+     * like react-native or flutter.
+     */
+    static get isNativeMobile() {
+        return _a.implementation.isNativeMobile;
+    }
+    /**
+     * Gets the origin of the current location.
+     *
+     * @example window.location.origin
+     */
     static get getOrigin() {
         return _a.implementation.getOrigin;
     }
+    /**
+     * Gets the host of the current location.
+     *
+     * @example window.location.host
+     */
     static get getHost() {
         return _a.implementation.getHost;
     }
+    /**
+     * Gets the hostname of the current location.
+     *
+     * @example window.location.hostname
+     */
     static get getHostname() {
         return _a.implementation.getHostname;
     }
     static get getTLD() {
         return _a.implementation.getTLD;
     }
-    // Deeplink handling
+    /**
+     * Opens a URL. If possible, should avoid new windows.
+     */
     static get openURL() {
         return _a.implementation.openURL;
     }

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

@@ -3,9 +3,32 @@ export declare class PlatformService {
     #private;
     static get implementation(): IPlatformService;
     static set implementation(implementation: IPlatformService);
+    /**
+     * Indicates if the current platform is a native mobile app
+     * like react-native or flutter.
+     */
+    static get isNativeMobile(): boolean;
+    /**
+     * Gets the origin of the current location.
+     *
+     * @example window.location.origin
+     */
     static get getOrigin(): () => string;
+    /**
+     * Gets the host of the current location.
+     *
+     * @example window.location.host
+     */
     static get getHost(): () => string;
+    /**
+     * Gets the hostname of the current location.
+     *
+     * @example window.location.hostname
+     */
     static get getHostname(): () => string;
     static get getTLD(): () => string | undefined;
+    /**
+     * Opens a URL. If possible, should avoid new windows.
+     */
     static get openURL(): (url: string) => Promise<void>;
 }

package/src/services/PlatformService/PlatformService.js

@@ -13,19 +13,43 @@ class PlatformService {
     static set implementation(implementation) {
         __classPrivateFieldSet(_a, _a, implementation, "f", _PlatformService_implementation);
     }
+    /**
+     * Indicates if the current platform is a native mobile app
+     * like react-native or flutter.
+     */
+    static get isNativeMobile() {
+        return _a.implementation.isNativeMobile;
+    }
+    /**
+     * Gets the origin of the current location.
+     *
+     * @example window.location.origin
+     */
     static get getOrigin() {
         return _a.implementation.getOrigin;
     }
+    /**
+     * Gets the host of the current location.
+     *
+     * @example window.location.host
+     */
     static get getHost() {
         return _a.implementation.getHost;
     }
+    /**
+     * Gets the hostname of the current location.
+     *
+     * @example window.location.hostname
+     */
     static get getHostname() {
         return _a.implementation.getHostname;
     }
     static get getTLD() {
         return _a.implementation.getTLD;
     }
-    // Deeplink handling
+    /**
+     * Opens a URL. If possible, should avoid new windows.
+     */
     static get openURL() {
         return _a.implementation.openURL;
     }

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

@@ -22,6 +22,7 @@ const createBrowserPlatformService = (window) => ({
         });
         return data.domain || undefined;
     },
+    isNativeMobile: false,
     openURL: (url) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
         window.location.assign(url);
     }),

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

@@ -18,6 +18,7 @@ const createBrowserPlatformService = (window) => ({
         });
         return data.domain || undefined;
     },
+    isNativeMobile: false,
     openURL: (url) => __awaiter(void 0, void 0, void 0, function* () {
         window.location.assign(url);
     }),

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

@@ -1,4 +1,9 @@
 export interface IPlatformService {
+    /**
+     * Indicates if the current platform is a native mobile app
+     * like react-native or flutter.
+     */
+    isNativeMobile: boolean;
     /**
      * Gets the hostname of the current location.
      *