@dynamic-labs/utils 4.8.0 → 4.8.2-preview.0

package/CHANGELOG.md

@@ -1,4 +1,27 @@
 
+### [4.8.2-preview.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.8.1...v4.8.2-preview.0) (2025-02-28)
+
+
+### Features
+
+* add disconnect to wallet action in connect only ([#8152](https://github.com/dynamic-labs/dynamic-auth/issues/8152)) ([4f8fa26](https://github.com/dynamic-labs/dynamic-auth/commit/4f8fa26c293aa249e697cc6494463b3bb545251a))
+* support for onramp options via function, and default support for coinbase ([#8139](https://github.com/dynamic-labs/dynamic-auth/issues/8139)) ([f4dee01](https://github.com/dynamic-labs/dynamic-auth/commit/f4dee0175512de7a15928c577a20cc620863c282))
+
+
+### Bug Fixes
+
+* embedded widget race condition that would show both embedded and non-embedded widgets at the same time ([4cb1686](https://github.com/dynamic-labs/dynamic-auth/commit/4cb16860cc61f6fcc074eb20ce38f848cdda31f1))
+* filter out networks without a key value when parsing coinbase onramp url ([#8158](https://github.com/dynamic-labs/dynamic-auth/issues/8158)) ([8033299](https://github.com/dynamic-labs/dynamic-auth/commit/80332991551987a29b6ea7c8f66fd373956d875b))
+* **QNTM-2927:** send users back to login on MM cancel ([#8149](https://github.com/dynamic-labs/dynamic-auth/issues/8149)) ([8e92702](https://github.com/dynamic-labs/dynamic-auth/commit/8e9270270220fc781da9c9235f86b29b9c4d2f28))
+* update WC re-connect view on mobile ([45c5241](https://github.com/dynamic-labs/dynamic-auth/commit/45c5241fa8d973b8ad3f8b0e85b5034e429c3c11))
+
+### [4.8.1](https://github.com/dynamic-labs/dynamic-auth/compare/v4.8.0...v4.8.1) (2025-02-25)
+
+
+### Bug Fixes
+
+* wc redirect for safari inside iframe ([#8131](https://github.com/dynamic-labs/dynamic-auth/issues/8131)) ([8c74bea](https://github.com/dynamic-labs/dynamic-auth/commit/8c74beae505014eb85be4fd211909709d0a339dd))
+
 ## [4.8.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.7.2...v4.8.0) (2025-02-25)
 
 

package/package.cjs

@@ -3,6 +3,6 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = "4.8.0";
+var version = "4.8.2-preview.0";
 
 exports.version = version;

package/package.js

@@ -1,4 +1,4 @@
 'use client'
-var version = "4.8.0";
+var version = "4.8.2-preview.0";
 
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/utils",
-  "version": "4.8.0",
+  "version": "4.8.2-preview.0",
   "description": "A React SDK for implementing wallet web3 authentication and authorization to your website.",
   "author": "Dynamic Labs, Inc.",
   "license": "MIT",
@@ -18,11 +18,11 @@
   },
   "homepage": "https://www.dynamic.xyz/",
   "dependencies": {
-    "@dynamic-labs/sdk-api-core": "0.0.628",
+    "@dynamic-labs/sdk-api-core": "0.0.633",
     "tldts": "6.0.16",
-    "@dynamic-labs/assert-package-version": "4.8.0",
-    "@dynamic-labs/logger": "4.8.0",
-    "@dynamic-labs/types": "4.8.0",
+    "@dynamic-labs/assert-package-version": "4.8.2-preview.0",
+    "@dynamic-labs/logger": "4.8.2-preview.0",
+    "@dynamic-labs/types": "4.8.2-preview.0",
     "buffer": "6.0.3",
     "eventemitter3": "5.0.1"
   },

package/src/errors/CustomError.d.ts

@@ -1,11 +1,12 @@
+import { ErrorCode } from './ErrorCode';
 /**
  * Extend this class to allow usage of instanceof
  */
 export declare class CustomError extends Error {
-    code: string | undefined;
-    constructor(message?: string | undefined, code?: string);
+    code: ErrorCode | string | undefined;
+    constructor(message?: string, code?: ErrorCode | string);
     toJSON(): {
-        code: string | undefined;
+        code: string | ErrorCode | undefined;
         error: string;
     };
 }

package/src/errors/ErrorCode.cjs

@@ -0,0 +1,24 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * All supported error codes.
+ *
+ * Any changes here should be reflected in the [useErrorText] hook to maintain
+ * accurate translations.
+ */
+exports.ErrorCode = void 0;
+(function (ErrorCode) {
+    ErrorCode[ErrorCode["UNKNOWN"] = 0] = "UNKNOWN";
+    ErrorCode[ErrorCode["DEFAULT"] = 1] = "DEFAULT";
+    ErrorCode[ErrorCode["USER_REJECTED"] = 2] = "USER_REJECTED";
+    ErrorCode[ErrorCode["MESSAGE_SIGNATURE_DENIED"] = 3] = "MESSAGE_SIGNATURE_DENIED";
+    ErrorCode[ErrorCode["WALLET_LOCKED"] = 4] = "WALLET_LOCKED";
+    ErrorCode[ErrorCode["INVALID_PARAMETERS"] = 5] = "INVALID_PARAMETERS";
+    ErrorCode[ErrorCode["INTERNAL_ERROR"] = 6] = "INTERNAL_ERROR";
+    ErrorCode[ErrorCode["ACCOUNT_ALREADY_LINKED_TO_DIFFERENT_PROFILE"] = 7] = "ACCOUNT_ALREADY_LINKED_TO_DIFFERENT_PROFILE";
+    ErrorCode[ErrorCode["CONNECTION_REJECTED"] = 8] = "CONNECTION_REJECTED";
+    ErrorCode[ErrorCode["MISSING_PUBLIC_ADDRESS"] = 9] = "MISSING_PUBLIC_ADDRESS";
+})(exports.ErrorCode || (exports.ErrorCode = {}));

package/src/errors/ErrorCode.d.ts

@@ -0,0 +1,18 @@
+/**
+ * All supported error codes.
+ *
+ * Any changes here should be reflected in the [useErrorText] hook to maintain
+ * accurate translations.
+ */
+export declare enum ErrorCode {
+    UNKNOWN = 0,
+    DEFAULT = 1,
+    USER_REJECTED = 2,
+    MESSAGE_SIGNATURE_DENIED = 3,
+    WALLET_LOCKED = 4,
+    INVALID_PARAMETERS = 5,
+    INTERNAL_ERROR = 6,
+    ACCOUNT_ALREADY_LINKED_TO_DIFFERENT_PROFILE = 7,
+    CONNECTION_REJECTED = 8,
+    MISSING_PUBLIC_ADDRESS = 9
+}

package/src/errors/ErrorCode.js

@@ -0,0 +1,22 @@
+'use client'
+/**
+ * All supported error codes.
+ *
+ * Any changes here should be reflected in the [useErrorText] hook to maintain
+ * accurate translations.
+ */
+var ErrorCode;
+(function (ErrorCode) {
+    ErrorCode[ErrorCode["UNKNOWN"] = 0] = "UNKNOWN";
+    ErrorCode[ErrorCode["DEFAULT"] = 1] = "DEFAULT";
+    ErrorCode[ErrorCode["USER_REJECTED"] = 2] = "USER_REJECTED";
+    ErrorCode[ErrorCode["MESSAGE_SIGNATURE_DENIED"] = 3] = "MESSAGE_SIGNATURE_DENIED";
+    ErrorCode[ErrorCode["WALLET_LOCKED"] = 4] = "WALLET_LOCKED";
+    ErrorCode[ErrorCode["INVALID_PARAMETERS"] = 5] = "INVALID_PARAMETERS";
+    ErrorCode[ErrorCode["INTERNAL_ERROR"] = 6] = "INTERNAL_ERROR";
+    ErrorCode[ErrorCode["ACCOUNT_ALREADY_LINKED_TO_DIFFERENT_PROFILE"] = 7] = "ACCOUNT_ALREADY_LINKED_TO_DIFFERENT_PROFILE";
+    ErrorCode[ErrorCode["CONNECTION_REJECTED"] = 8] = "CONNECTION_REJECTED";
+    ErrorCode[ErrorCode["MISSING_PUBLIC_ADDRESS"] = 9] = "MISSING_PUBLIC_ADDRESS";
+})(ErrorCode || (ErrorCode = {}));
+
+export { ErrorCode };

package/src/errors/MetaMaskError.cjs

@@ -0,0 +1,35 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var CustomError = require('./CustomError.cjs');
+var ErrorCode = require('./ErrorCode.cjs');
+
+/** Mapping of metamask error codes to dynamic [ErrorCode]s */
+const metaMaskErrorMap = {
+    4001: ErrorCode.ErrorCode.USER_REJECTED,
+};
+class MetaMaskError extends CustomError.CustomError {
+    constructor(message, code) {
+        super(message, code);
+    }
+    /**
+     * Creates a [MetaMaskError] from an unknown error (thrown by MetaMask)
+     *
+     * @param error - The error to create the [MetaMaskError] from
+     * @returns A new [MetaMaskError]
+     */
+    static fromError(error) {
+        var _a, _b;
+        if (error instanceof Object) {
+            const errorObject = error;
+            const dynamicErrorCode = (_b = metaMaskErrorMap[(_a = errorObject.code) !== null && _a !== void 0 ? _a : '']) !== null && _b !== void 0 ? _b : ErrorCode.ErrorCode.DEFAULT;
+            return new MetaMaskError(errorObject.message, dynamicErrorCode);
+        }
+        return new MetaMaskError(String(error), ErrorCode.ErrorCode.DEFAULT);
+    }
+}
+
+exports.MetaMaskError = MetaMaskError;
+exports.metaMaskErrorMap = metaMaskErrorMap;

package/src/errors/MetaMaskError.d.ts

@@ -0,0 +1,14 @@
+import { CustomError } from './CustomError';
+import { ErrorCode } from './ErrorCode';
+/** Mapping of metamask error codes to dynamic [ErrorCode]s */
+export declare const metaMaskErrorMap: Record<string, ErrorCode>;
+export declare class MetaMaskError extends CustomError {
+    constructor(message?: string, code?: ErrorCode);
+    /**
+     * Creates a [MetaMaskError] from an unknown error (thrown by MetaMask)
+     *
+     * @param error - The error to create the [MetaMaskError] from
+     * @returns A new [MetaMaskError]
+     */
+    static fromError(error: unknown): MetaMaskError;
+}

package/src/errors/MetaMaskError.js

@@ -0,0 +1,30 @@
+'use client'
+import { CustomError } from './CustomError.js';
+import { ErrorCode } from './ErrorCode.js';
+
+/** Mapping of metamask error codes to dynamic [ErrorCode]s */
+const metaMaskErrorMap = {
+    4001: ErrorCode.USER_REJECTED,
+};
+class MetaMaskError extends CustomError {
+    constructor(message, code) {
+        super(message, code);
+    }
+    /**
+     * Creates a [MetaMaskError] from an unknown error (thrown by MetaMask)
+     *
+     * @param error - The error to create the [MetaMaskError] from
+     * @returns A new [MetaMaskError]
+     */
+    static fromError(error) {
+        var _a, _b;
+        if (error instanceof Object) {
+            const errorObject = error;
+            const dynamicErrorCode = (_b = metaMaskErrorMap[(_a = errorObject.code) !== null && _a !== void 0 ? _a : '']) !== null && _b !== void 0 ? _b : ErrorCode.DEFAULT;
+            return new MetaMaskError(errorObject.message, dynamicErrorCode);
+        }
+        return new MetaMaskError(String(error), ErrorCode.DEFAULT);
+    }
+}
+
+export { MetaMaskError, metaMaskErrorMap };

package/src/errors/index.d.ts

@@ -6,8 +6,10 @@ export * from './DynamicError';
 export * from './EmailAlreadyExistsError';
 export * from './EmailProviderError';
 export * from './EmailVerificationError';
+export * from './ErrorCode';
 export * from './GateBlockedError';
 export * from './InsufficientFundsError';
+export * from './MetaMaskError';
 export * from './MissingEnvironmentIdError';
 export * from './MissingPublicAddressError';
 export * from './NoAccessError';

package/src/handleMobileWalletRedirect/handleMobileWalletRedirect.cjs

@@ -4,16 +4,19 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var isMobile = require('../isMobile/isMobile.cjs');
+var PlatformService = require('../services/PlatformService/PlatformService.cjs');
+require('../../_virtual/_tslib.cjs');
+require('tldts');
 
 const handleMobileWalletRedirect = ({ nativeLink, universalLink, }) => {
     const url = encodeURIComponent(window.location.toString());
     const ref = encodeURIComponent(window.location.origin);
     // samsung browser only supports native links, not universal links
     if (isMobile.isSamsungBrowser()) {
-        window.location.assign(`${nativeLink}/${url}?ref=${ref}`);
+        PlatformService.PlatformService.openURL(`${nativeLink}/${url}?ref=${ref}`);
     }
     else {
-        window.location.assign(`${universalLink}/${url}?ref=${ref}`);
+        PlatformService.PlatformService.openURL(`${universalLink}/${url}?ref=${ref}`);
     }
 };
 

package/src/handleMobileWalletRedirect/handleMobileWalletRedirect.js

@@ -1,15 +1,18 @@
 'use client'
 import { isSamsungBrowser } from '../isMobile/isMobile.js';
+import { PlatformService } from '../services/PlatformService/PlatformService.js';
+import '../../_virtual/_tslib.js';
+import 'tldts';
 
 const handleMobileWalletRedirect = ({ nativeLink, universalLink, }) => {
     const url = encodeURIComponent(window.location.toString());
     const ref = encodeURIComponent(window.location.origin);
     // samsung browser only supports native links, not universal links
     if (isSamsungBrowser()) {
-        window.location.assign(`${nativeLink}/${url}?ref=${ref}`);
+        PlatformService.openURL(`${nativeLink}/${url}?ref=${ref}`);
     }
     else {
-        window.location.assign(`${universalLink}/${url}?ref=${ref}`);
+        PlatformService.openURL(`${universalLink}/${url}?ref=${ref}`);
     }
 };
 

package/src/index.cjs

@@ -18,8 +18,10 @@ var DynamicError = require('./errors/DynamicError.cjs');
 var EmailAlreadyExistsError = require('./errors/EmailAlreadyExistsError.cjs');
 var EmailProviderError = require('./errors/EmailProviderError.cjs');
 var EmailVerificationError = require('./errors/EmailVerificationError.cjs');
+var ErrorCode = require('./errors/ErrorCode.cjs');
 var GateBlockedError = require('./errors/GateBlockedError.cjs');
 var InsufficientFundsError = require('./errors/InsufficientFundsError.cjs');
+var MetaMaskError = require('./errors/MetaMaskError.cjs');
 var MissingEnvironmentIdError = require('./errors/MissingEnvironmentIdError.cjs');
 var MissingPublicAddressError = require('./errors/MissingPublicAddressError.cjs');
 var NoAccessError = require('./errors/NoAccessError.cjs');
@@ -117,8 +119,14 @@ exports.DynamicError = DynamicError.DynamicError;
 exports.EmailAlreadyExistsError = EmailAlreadyExistsError.EmailAlreadyExistsError;
 exports.EmailProviderError = EmailProviderError.EmailProviderError;
 exports.EmailVerificationError = EmailVerificationError.EmailVerificationError;
+Object.defineProperty(exports, 'ErrorCode', {
+  enumerable: true,
+  get: function () { return ErrorCode.ErrorCode; }
+});
 exports.GateBlockedError = GateBlockedError.GateBlockedError;
 exports.InsufficientFundsError = InsufficientFundsError.InsufficientFundsError;
+exports.MetaMaskError = MetaMaskError.MetaMaskError;
+exports.metaMaskErrorMap = MetaMaskError.metaMaskErrorMap;
 exports.MissingEnvironmentIdError = MissingEnvironmentIdError.MissingEnvironmentIdError;
 exports.MissingPublicAddressError = MissingPublicAddressError.MissingPublicAddressError;
 exports.NoAccessError = NoAccessError.NoAccessError;

package/src/index.js

@@ -14,8 +14,10 @@ export { DynamicError } from './errors/DynamicError.js';
 export { EmailAlreadyExistsError } from './errors/EmailAlreadyExistsError.js';
 export { EmailProviderError } from './errors/EmailProviderError.js';
 export { EmailVerificationError } from './errors/EmailVerificationError.js';
+export { ErrorCode } from './errors/ErrorCode.js';
 export { GateBlockedError } from './errors/GateBlockedError.js';
 export { InsufficientFundsError } from './errors/InsufficientFundsError.js';
+export { MetaMaskError, metaMaskErrorMap } from './errors/MetaMaskError.js';
 export { MissingEnvironmentIdError } from './errors/MissingEnvironmentIdError.js';
 export { MissingPublicAddressError } from './errors/MissingPublicAddressError.js';
 export { NoAccessError } from './errors/NoAccessError.js';

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

@@ -8,6 +8,8 @@ var types = require('@dynamic-labs/types');
 var logger = require('../../../logger/logger.cjs');
 var connectWithAppleId = require('../utils/connectWithAppleId/connectWithAppleId.cjs');
 var isMobile = require('../../../isMobile/isMobile.cjs');
+var PlatformService = require('../../PlatformService/PlatformService.cjs');
+require('tldts');
 
 let authWindowInterval;
 const createWindowOauth2Service = () => ({
@@ -35,7 +37,7 @@ const createWindowOauth2Service = () => ({
             initWebAuth({
                 redirectUrl: redirectUrl || window.location.href,
             }).then(() => {
-                window.location.assign(oauthLoginUrl);
+                PlatformService.PlatformService.openURL(oauthLoginUrl.toString());
             });
             return;
         }

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

@@ -4,6 +4,8 @@ import { ProviderEnum, SocialOAuthErrorCode } from '@dynamic-labs/types';
 import { logger } from '../../../logger/logger.js';
 import { connectWithAppleId } from '../utils/connectWithAppleId/connectWithAppleId.js';
 import { isSafariBrowser, isIOS } from '../../../isMobile/isMobile.js';
+import { PlatformService } from '../../PlatformService/PlatformService.js';
+import 'tldts';
 
 let authWindowInterval;
 const createWindowOauth2Service = () => ({
@@ -31,7 +33,7 @@ const createWindowOauth2Service = () => ({
             initWebAuth({
                 redirectUrl: redirectUrl || window.location.href,
             }).then(() => {
-                window.location.assign(oauthLoginUrl);
+                PlatformService.openURL(oauthLoginUrl.toString());
             });
             return;
         }

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

@@ -36,5 +36,5 @@ export declare class PlatformService {
     /**
      * Opens a URL. If possible, should avoid new windows.
      */
-    static get openURL(): (url: string) => Promise<void>;
+    static get openURL(): (url: string, target?: "self" | "blank" | undefined, features?: string | undefined) => Promise<void>;
 }

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

@@ -24,8 +24,13 @@ const createBrowserPlatformService = (window) => ({
         return data.domain || undefined;
     },
     isNativeMobile: false,
-    openURL: (url) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
-        window.location.assign(url);
+    openURL: (url_1, ...args_1) => _tslib.__awaiter(void 0, [url_1, ...args_1], void 0, function* (url, target = 'self', features = '') {
+        if (target === 'blank') {
+            window.open(url, '_blank', features);
+        }
+        else {
+            window.location.assign(url);
+        }
     }),
 });
 

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

@@ -20,8 +20,13 @@ const createBrowserPlatformService = (window) => ({
         return data.domain || undefined;
     },
     isNativeMobile: false,
-    openURL: (url) => __awaiter(void 0, void 0, void 0, function* () {
-        window.location.assign(url);
+    openURL: (url_1, ...args_1) => __awaiter(void 0, [url_1, ...args_1], void 0, function* (url, target = 'self', features = '') {
+        if (target === 'blank') {
+            window.open(url, '_blank', features);
+        }
+        else {
+            window.location.assign(url);
+        }
     }),
 });
 

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

@@ -30,7 +30,15 @@ export interface IPlatformService {
     getDisplayOrigin(): string | undefined;
     getTLD(): string | undefined;
     /**
-     * Opens a URL. If possible, should avoid new windows.
+     * Opens a URL.
+     *
+     * Target options:
+     * - 'self': Opens the URL in the current window (default).
+     * - 'blank': Opens the URL in a new window.
+     *
+     * The `features` parameter is passed to the `window.open` function when the target is 'blank'.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/Window/open
      */
-    openURL(url: string): Promise<void>;
+    openURL(url: string, target?: 'self' | 'blank', features?: string): Promise<void>;
 }