@reown/appkit-utils 1.8.15-viem-upgrade.0 → 1.8.15-wc-linking-reset-headless.0

package/dist/esm/tests/CaipNetworkUtil.test.js

@@ -0,0 +1,333 @@
+import { http } from 'viem';
+import { immutableZkEvmTestnet } from 'viem/chains';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { ConstantsUtil } from '@reown/appkit-common';
+import { ChainController, StorageUtil } from '@reown/appkit-controllers';
+import { CaipNetworksUtil } from '../src/CaipNetworkUtil';
+const mainnet = {
+    id: 1,
+    name: 'Ethereum',
+    nativeCurrency: {
+        name: 'Ether',
+        symbol: 'ETH',
+        decimals: 18
+    },
+    rpcUrls: {
+        default: {
+            http: ['https://ethereum.example.com']
+        }
+    }
+};
+const polygon = {
+    id: 137,
+    name: 'Polygon',
+    nativeCurrency: {
+        name: 'Polygon',
+        symbol: 'MATIC',
+        decimals: 18
+    },
+    rpcUrls: {
+        default: {
+            http: ['https://polygon.example.com']
+        }
+    }
+};
+const solana = {
+    id: 'solana',
+    name: 'Solana',
+    chainNamespace: 'solana',
+    caipNetworkId: 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',
+    nativeCurrency: {
+        name: 'Solana',
+        symbol: 'SOL',
+        decimals: 9
+    },
+    rpcUrls: {
+        default: {
+            http: ['https://solana.example.com']
+        }
+    }
+};
+const mainnetCaipNetwork = {
+    ...mainnet,
+    chainNamespace: 'eip155',
+    caipNetworkId: 'eip155:1'
+};
+const polygonCaipNetwork = {
+    ...polygon,
+    chainNamespace: 'eip155',
+    caipNetworkId: 'eip155:137'
+};
+vi.mock('viem', () => ({
+    http: vi.fn(),
+    fallback: vi.fn()
+}));
+describe('CaipNetworksUtil', () => {
+    // Test data
+    const mockProjectId = 'test-project-id';
+    beforeEach(() => {
+        vi.resetModules();
+        vi.clearAllMocks();
+    });
+    describe('extendRpcUrlWithProjectId', () => {
+        it('should extend Reown RPC URL with project ID', () => {
+            const rpcUrl = 'https://rpc.walletconnect.org/v1/';
+            const result = CaipNetworksUtil.extendRpcUrlWithProjectId(rpcUrl, mockProjectId);
+            expect(result).toContain('projectId=test-project-id');
+        });
+        it('should not modify non-Reown RPC URLs', () => {
+            const rpcUrl = 'https://example.com/rpc';
+            const result = CaipNetworksUtil.extendRpcUrlWithProjectId(rpcUrl, mockProjectId);
+            expect(result).toBe(rpcUrl);
+        });
+        it('should handle invalid URLs gracefully', () => {
+            const invalidUrl = 'not-a-url';
+            const result = CaipNetworksUtil.extendRpcUrlWithProjectId(invalidUrl, mockProjectId);
+            expect(result).toBe(invalidUrl);
+        });
+    });
+    describe('isCaipNetwork', () => {
+        it('should identify CaipNetwork correctly', () => {
+            expect(CaipNetworksUtil.isCaipNetwork(solana)).toBe(true);
+            expect(CaipNetworksUtil.isCaipNetwork(mainnet)).toBe(false);
+        });
+    });
+    describe('getChainNamespace', () => {
+        it('should return correct namespace for CaipNetwork', () => {
+            expect(CaipNetworksUtil.getChainNamespace(solana)).toBe('solana');
+        });
+        it('should return EVM namespace for non-CaipNetwork', () => {
+            expect(CaipNetworksUtil.getChainNamespace(mainnet)).toBe('eip155');
+        });
+    });
+    describe('getCaipNetworkId', () => {
+        it('should return existing caipNetworkId for CaipNetwork', () => {
+            expect(CaipNetworksUtil.getCaipNetworkId(solana)).toBe('solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp');
+        });
+        it('should construct caipNetworkId for non-CaipNetwork', () => {
+            expect(CaipNetworksUtil.getCaipNetworkId(mainnet)).toBe('eip155:1');
+            expect(CaipNetworksUtil.getCaipNetworkId(polygon)).toBe('eip155:137');
+        });
+    });
+    describe('getDefaultRpcUrl', () => {
+        it('should return blockchain API URL for supported chains', () => {
+            const result = CaipNetworksUtil.getDefaultRpcUrl(solana, 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp', mockProjectId);
+            expect(result).toContain('rpc.walletconnect.org');
+            expect(result).toContain('projectId=test-project-id');
+        });
+        it('should return default RPC URL for unsupported chains', () => {
+            const customNetwork = {
+                id: 999,
+                name: 'Custom Chain',
+                nativeCurrency: {
+                    name: 'Custom',
+                    symbol: 'CUSTOM',
+                    decimals: 18
+                },
+                rpcUrls: {
+                    default: {
+                        http: ['https://custom.example.com']
+                    }
+                }
+            };
+            const result = CaipNetworksUtil.getDefaultRpcUrl(customNetwork, 'eip155:999', mockProjectId);
+            expect(result).toBe('https://custom.example.com');
+        });
+        it('should return empty string when no RPC URL is available', () => {
+            const networkWithoutRpc = {
+                id: 999,
+                name: 'No RPC Chain',
+                nativeCurrency: {
+                    name: 'Custom',
+                    symbol: 'CUSTOM',
+                    decimals: 18
+                },
+                rpcUrls: {
+                    default: {
+                        http: []
+                    }
+                }
+            };
+            const result = CaipNetworksUtil.getDefaultRpcUrl(networkWithoutRpc, 'eip155:999', mockProjectId);
+            expect(result).toBe('');
+        });
+    });
+    describe('extendCaipNetwork', () => {
+        const customNetworkImageUrls = {
+            1: 'https://example.com/eth.png'
+        };
+        const customRpcUrls = {
+            'eip155:1': [{ url: 'https://custom.eth.example.com' }]
+        };
+        it('should extend network with all required properties', () => {
+            const result = CaipNetworksUtil.extendCaipNetwork(mainnet, {
+                customNetworkImageUrls,
+                projectId: mockProjectId,
+                customRpcUrls
+            });
+            expect(result).toMatchObject({
+                chainNamespace: 'eip155',
+                caipNetworkId: 'eip155:1',
+                assets: {
+                    imageUrl: 'https://example.com/eth.png'
+                }
+            });
+            expect(result.rpcUrls.default.http).toContain('https://custom.eth.example.com');
+        });
+        it('should handle networks without custom configurations', () => {
+            const result = CaipNetworksUtil.extendCaipNetwork(mainnet, {
+                customNetworkImageUrls: undefined,
+                projectId: mockProjectId,
+                customRpcUrls: undefined
+            });
+            expect(result).toHaveProperty('chainNamespace');
+            expect(result).toHaveProperty('caipNetworkId');
+            expect(result.assets?.imageUrl).toBeUndefined();
+        });
+    });
+    describe('handle network without rpcUrls', () => {
+        it('should handle network without rpcUrls field gracefully', () => {
+            const networkWithoutRpcUrls = {
+                id: 123,
+                name: 'No RPC Network',
+                nativeCurrency: {
+                    name: 'NoRPC',
+                    symbol: 'NRPC',
+                    decimals: 18
+                }
+                // Note: rpcUrls field is intentionally omitted
+            };
+            const result = CaipNetworksUtil.extendCaipNetwork(networkWithoutRpcUrls, {
+                customNetworkImageUrls: undefined,
+                projectId: mockProjectId,
+                customRpcUrls: undefined
+            });
+            expect(result.rpcUrls.default.http).toEqual([]);
+        });
+    });
+    describe('extendCaipNetworks', () => {
+        it('should extend multiple networks correctly', () => {
+            const networks = [mainnet, { ...mainnet, id: 2 }];
+            const result = CaipNetworksUtil.extendCaipNetworks(networks, {
+                customNetworkImageUrls: {},
+                projectId: mockProjectId,
+                customRpcUrls: {}
+            });
+            expect(result).toHaveLength(2);
+            expect(result[0]).toHaveProperty('chainNamespace');
+            expect(result[1]).toHaveProperty('chainNamespace');
+        });
+    });
+    describe('getViemTransport', () => {
+        it('should create transport with custom RPC URLs', () => {
+            const customRpcUrls = [{ url: 'https://custom.example.com' }];
+            CaipNetworksUtil.getViemTransport(solana, mockProjectId, customRpcUrls);
+            expect(http).toHaveBeenCalledWith('https://custom.example.com', undefined);
+            expect(http).toHaveBeenCalledWith('https://rpc.walletconnect.org/v1/?chainId=solana%3A5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp&projectId=test-project-id', {
+                fetchOptions: {
+                    headers: {
+                        'Content-Type': 'text/plain'
+                    }
+                }
+            });
+        });
+        it('should include Reown transport for supported chains', () => {
+            CaipNetworksUtil.getViemTransport({ ...mainnet, chainNamespace: 'eip155', caipNetworkId: 'eip155:1' }, mockProjectId);
+            expect(http).toHaveBeenCalledWith('https://rpc.walletconnect.org/v1/?chainId=eip155%3A1&projectId=test-project-id', {
+                fetchOptions: {
+                    headers: {
+                        'Content-Type': 'text/plain'
+                    }
+                }
+            });
+        });
+        it('should create transport with deafult RPC URL if blockchain API is not supported', () => {
+            CaipNetworksUtil.getViemTransport({ ...immutableZkEvmTestnet, chainNamespace: 'eip155', caipNetworkId: 'eip155:1' }, mockProjectId);
+            expect(http).toHaveBeenCalledWith(immutableZkEvmTestnet.rpcUrls.default.http?.[0]);
+        });
+    });
+    describe('getUnsupportedNetwork', () => {
+        it('should create unsupported network object with correct format', () => {
+            const caipNetworkId = 'eip155:1234';
+            const result = CaipNetworksUtil.getUnsupportedNetwork(caipNetworkId);
+            expect(result).toEqual({
+                id: '1234',
+                caipNetworkId: 'eip155:1234',
+                name: ConstantsUtil.UNSUPPORTED_NETWORK_NAME,
+                chainNamespace: 'eip155',
+                nativeCurrency: {
+                    name: '',
+                    decimals: 0,
+                    symbol: ''
+                },
+                rpcUrls: {
+                    default: {
+                        http: []
+                    }
+                }
+            });
+        });
+    });
+    describe('getCaipNetworkFromStorage', () => {
+        beforeEach(() => {
+            vi.spyOn(StorageUtil, 'getActiveCaipNetworkId');
+            vi.spyOn(ChainController, 'getAllRequestedCaipNetworks');
+            vi.spyOn(ChainController.state, 'chains', 'get');
+        });
+        afterEach(() => {
+            vi.resetAllMocks();
+        });
+        it('should return unsupported network when network ID exists but not supported', () => {
+            const unsupportedNetworkId = 'eip155:999';
+            vi.spyOn(StorageUtil, 'getActiveCaipNetworkId').mockReturnValue(unsupportedNetworkId);
+            vi.spyOn(ChainController, 'getAllRequestedCaipNetworks').mockReturnValue([mainnetCaipNetwork]);
+            vi.spyOn(ChainController.state, 'chains', 'get').mockReturnValue(new Map([['eip155', {}]]));
+            const result = CaipNetworksUtil.getCaipNetworkFromStorage(mainnetCaipNetwork);
+            expect(result).toEqual({
+                id: '999',
+                caipNetworkId: unsupportedNetworkId,
+                name: ConstantsUtil.UNSUPPORTED_NETWORK_NAME,
+                chainNamespace: 'eip155',
+                nativeCurrency: {
+                    name: '',
+                    decimals: 0,
+                    symbol: ''
+                },
+                rpcUrls: {
+                    default: {
+                        http: []
+                    }
+                }
+            });
+        });
+        it('should return matching network when found in available networks', () => {
+            vi.spyOn(StorageUtil, 'getActiveCaipNetworkId').mockReturnValue('eip155:137');
+            vi.spyOn(ChainController, 'getAllRequestedCaipNetworks').mockReturnValue([
+                mainnetCaipNetwork,
+                polygonCaipNetwork
+            ]);
+            vi.spyOn(ChainController.state, 'chains', 'get').mockReturnValue(new Map([['eip155', {}]]));
+            const result = CaipNetworksUtil.getCaipNetworkFromStorage();
+            expect(result).toEqual(polygonCaipNetwork);
+        });
+        it('should return default network when no stored network found', () => {
+            vi.spyOn(StorageUtil, 'getActiveCaipNetworkId').mockReturnValue(undefined);
+            vi.spyOn(ChainController, 'getAllRequestedCaipNetworks').mockReturnValue([
+                mainnetCaipNetwork,
+                polygonCaipNetwork
+            ]);
+            const result = CaipNetworksUtil.getCaipNetworkFromStorage(polygonCaipNetwork);
+            expect(result).toEqual(polygonCaipNetwork);
+        });
+        it('should return first available network when no stored or default network', () => {
+            vi.spyOn(StorageUtil, 'getActiveCaipNetworkId').mockReturnValue(undefined);
+            vi.spyOn(ChainController, 'getAllRequestedCaipNetworks').mockReturnValue([
+                mainnetCaipNetwork,
+                polygonCaipNetwork
+            ]);
+            const result = CaipNetworksUtil.getCaipNetworkFromStorage(undefined);
+            expect(result).toEqual(mainnetCaipNetwork);
+        });
+    });
+});
+//# sourceMappingURL=CaipNetworkUtil.test.js.map

package/dist/esm/tests/CaipNetworkUtil.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CaipNetworkUtil.test.js","sourceRoot":"","sources":["../../../tests/CaipNetworkUtil.test.ts"],"names":[],"mappings":"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"}

package/dist/esm/tests/EthersHelpersUtil.test.js

@@ -0,0 +1,61 @@
+import { describe, expect, it, vi } from 'vitest';
+import { EthersHelpersUtil } from '../src/ethers/EthersHelpersUtil.js';
+describe('EthersHelpersUtil', () => {
+    describe('hexStringToNumber', () => {
+        it('should convert hex string to number', () => {
+            expect(EthersHelpersUtil.hexStringToNumber('0xa')).toBe(10);
+            expect(EthersHelpersUtil.hexStringToNumber('ff')).toBe(255);
+        });
+        it('should handle hex strings with or without 0x prefix', () => {
+            expect(EthersHelpersUtil.hexStringToNumber('0x10')).toBe(16);
+            expect(EthersHelpersUtil.hexStringToNumber('10')).toBe(16);
+        });
+    });
+    describe('numberToHexString', () => {
+        it('should convert number to hex string', () => {
+            expect(EthersHelpersUtil.numberToHexString(10)).toBe('0xa');
+            expect(EthersHelpersUtil.numberToHexString(255)).toBe('0xff');
+        });
+        it('should handle string input', () => {
+            expect(EthersHelpersUtil.numberToHexString('10')).toBe('0x10');
+            expect(EthersHelpersUtil.numberToHexString('255')).toBe('0x255');
+        });
+    });
+    describe('getUserInfo', () => {
+        it('should return chainId and addresses', async () => {
+            const mockProvider = {
+                request: vi.fn().mockResolvedValueOnce(['0x123', '0x456']).mockResolvedValueOnce('0x1')
+            };
+            const result = await EthersHelpersUtil.getUserInfo(mockProvider);
+            expect(result).toEqual({ chainId: 1, addresses: ['0x123', '0x456'] });
+        });
+    });
+    describe('getChainId', () => {
+        it('should return the chain ID as a number', async () => {
+            const mockProvider = {
+                request: vi.fn().mockResolvedValue('0xa')
+            };
+            const result = await EthersHelpersUtil.getChainId(mockProvider);
+            expect(result).toBe(10);
+        });
+    });
+    describe('getAddress', () => {
+        it('should return the first address', async () => {
+            const mockProvider = {
+                request: vi.fn().mockResolvedValue(['0x123', '0x456'])
+            };
+            const result = await EthersHelpersUtil.getAddress(mockProvider);
+            expect(result).toBe('0x123');
+        });
+    });
+    describe('getAddresses', () => {
+        it('should return all addresses', async () => {
+            const mockProvider = {
+                request: vi.fn().mockResolvedValue(['0x123', '0x456'])
+            };
+            const result = await EthersHelpersUtil.getAddresses(mockProvider);
+            expect(result).toEqual(['0x123', '0x456']);
+        });
+    });
+});
+//# sourceMappingURL=EthersHelpersUtil.test.js.map

package/dist/esm/tests/EthersHelpersUtil.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EthersHelpersUtil.test.js","sourceRoot":"","sources":["../../../tests/EthersHelpersUtil.test.ts"],"names":[],"mappings":"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"}

package/dist/esm/tests/HelperUtil.test.js

@@ -0,0 +1,84 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { HelpersUtil } from '../src/HelpersUtil.js';
+describe('HelpersUtil', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    describe('withRetry', () => {
+        it('should retry condition function until success or max retries reached', async () => {
+            let attempts = 0;
+            const conditionFn = vi.fn(() => {
+                attempts++;
+                return attempts >= 3;
+            });
+            const promise = HelpersUtil.withRetry({
+                conditionFn,
+                intervalMs: 100,
+                maxRetries: 5
+            });
+            await vi.advanceTimersByTimeAsync(100);
+            await vi.advanceTimersByTimeAsync(100);
+            const result = await promise;
+            expect(result).toBe(true);
+            expect(conditionFn).toHaveBeenCalledTimes(3);
+        });
+        it('should return false when max retries exceeded', async () => {
+            const conditionFn = vi.fn(() => false);
+            const promise = HelpersUtil.withRetry({
+                conditionFn,
+                intervalMs: 50,
+                maxRetries: 3
+            });
+            await vi.advanceTimersByTimeAsync(50);
+            await vi.advanceTimersByTimeAsync(50);
+            await vi.advanceTimersByTimeAsync(50);
+            const result = await promise;
+            expect(result).toBe(false);
+            expect(conditionFn).toHaveBeenCalledTimes(3);
+        });
+        it('should handle async condition functions', async () => {
+            let attempts = 0;
+            const conditionFn = vi.fn(async () => {
+                attempts++;
+                return attempts >= 2;
+            });
+            const promise = HelpersUtil.withRetry({
+                conditionFn,
+                intervalMs: 100,
+                maxRetries: 3
+            });
+            await vi.advanceTimersByTimeAsync(100);
+            const result = await promise;
+            expect(result).toBe(true);
+            expect(conditionFn).toHaveBeenCalledTimes(2);
+        });
+        it('should succeed immediately when condition is true on first try', async () => {
+            const conditionFn = vi.fn(() => true);
+            const promise = HelpersUtil.withRetry({
+                conditionFn,
+                intervalMs: 100,
+                maxRetries: 5
+            });
+            const result = await promise;
+            expect(result).toBe(true);
+            expect(conditionFn).toHaveBeenCalledTimes(1);
+        });
+    });
+    describe('getOtherAuthNamespaces', () => {
+        it('should return empty array if no active namespace', () => {
+            const otherAuthNamespaces = HelpersUtil.getOtherAuthNamespaces(undefined);
+            expect(otherAuthNamespaces).toEqual([]);
+        });
+        it('should return all auth namespaces except the active one (eip155)', () => {
+            const activeNamespace = 'eip155';
+            const otherAuthNamespaces = HelpersUtil.getOtherAuthNamespaces(activeNamespace);
+            expect(otherAuthNamespaces).toEqual(['solana']);
+        });
+        it('should return all auth namespaces except the active one (solana)', () => {
+            const activeNamespace = 'solana';
+            const otherAuthNamespaces = HelpersUtil.getOtherAuthNamespaces(activeNamespace);
+            expect(otherAuthNamespaces).toEqual(['eip155']);
+        });
+    });
+});
+//# sourceMappingURL=HelperUtil.test.js.map

package/dist/esm/tests/HelperUtil.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HelperUtil.test.js","sourceRoot":"","sources":["../../../tests/HelperUtil.test.ts"],"names":[],"mappings":"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"}

package/dist/esm/tests/HelpersUtil.test.js

@@ -0,0 +1,76 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { ConstantsUtil as CommonConstantsUtil } from '@reown/appkit-common';
+import { ChainController, ConnectorController } from '@reown/appkit-controllers';
+import { ConstantsUtil } from '../src/ConstantsUtil.js';
+import { HelpersUtil } from '../src/HelpersUtil.js';
+describe('HelpersUtil', () => {
+    describe('getCaipTokens', () => {
+        it('should return undefined for undefined input', () => {
+            const result = HelpersUtil.getCaipTokens(undefined);
+            expect(result).toBeUndefined();
+        });
+        it('should convert tokens to CAIP format', () => {
+            const mockTokens = {
+                '1': { name: 'Ethereum', symbol: 'ETH' },
+                '137': { name: 'Polygon', symbol: 'MATIC' }
+            };
+            const expected = {
+                [`${ConstantsUtil.EIP155}:1`]: { name: 'Ethereum', symbol: 'ETH' },
+                [`${ConstantsUtil.EIP155}:137`]: { name: 'Polygon', symbol: 'MATIC' }
+            };
+            const result = HelpersUtil.getCaipTokens(mockTokens);
+            expect(result).toEqual(expected);
+        });
+        it('should handle empty tokens object', () => {
+            const result = HelpersUtil.getCaipTokens({});
+            expect(result).toEqual({});
+        });
+    });
+    describe('isLowerCaseMatch', () => {
+        it('should return true for matching strings regardless of case', () => {
+            expect(HelpersUtil.isLowerCaseMatch('Hello', 'hello')).toBe(true);
+            expect(HelpersUtil.isLowerCaseMatch('WORLD', 'world')).toBe(true);
+            expect(HelpersUtil.isLowerCaseMatch('Test123', 'test123')).toBe(true);
+        });
+        it('should return false for non-matching strings', () => {
+            expect(HelpersUtil.isLowerCaseMatch('Hello', 'World')).toBe(false);
+            expect(HelpersUtil.isLowerCaseMatch('Test', 'Test123')).toBe(false);
+        });
+        it('should handle undefined inputs', () => {
+            expect(HelpersUtil.isLowerCaseMatch(undefined, 'test')).toBe(false);
+            expect(HelpersUtil.isLowerCaseMatch('test', undefined)).toBe(false);
+            expect(HelpersUtil.isLowerCaseMatch(undefined, undefined)).toBe(true);
+        });
+    });
+    describe('getActiveNamespaceConnectedToAuth', () => {
+        beforeEach(() => {
+            vi.restoreAllMocks();
+        });
+        it('should return the active chain when it matches auth connector', () => {
+            vi.spyOn(ChainController, 'state', 'get').mockReturnValue({
+                activeChain: 'solana'
+            });
+            vi.spyOn(ConnectorController, 'getConnectorId').mockImplementation(chain => {
+                if (chain === 'eip155' || chain === 'solana') {
+                    return CommonConstantsUtil.CONNECTOR_ID.AUTH;
+                }
+                return undefined;
+            });
+            const result = HelpersUtil.getActiveNamespaceConnectedToAuth();
+            expect(result).toBe('solana');
+        });
+        it('should return undefined when active chain does not match auth connector', () => {
+            vi.spyOn(ConnectorController, 'getConnectorId').mockReturnValue('other-connector');
+            const result = HelpersUtil.getActiveNamespaceConnectedToAuth();
+            expect(result).toBeUndefined();
+        });
+        it('should return undefined when active chain is not in supported chains', () => {
+            vi.spyOn(ChainController, 'state', 'get').mockReturnValue({
+                activeChain: 'unsupported-chain'
+            });
+            const result = HelpersUtil.getActiveNamespaceConnectedToAuth();
+            expect(result).toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=HelpersUtil.test.js.map

package/dist/esm/tests/HelpersUtil.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HelpersUtil.test.js","sourceRoot":"","sources":["../../../tests/HelpersUtil.test.ts"],"names":[],"mappings":"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"}