From 5fc9e7b8f4b94e19066842dd76972c901eebf7f9 Mon Sep 17 00:00:00 2001 From: Vincente Void <67200581+vincentevoid@users.noreply.github.com> Date: Mon, 26 Jan 2026 14:34:51 -0600 Subject: [PATCH 1/2] Clarify fully specified import errors in ESM builds --- sdks/react/troubleshooting.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/sdks/react/troubleshooting.mdx b/sdks/react/troubleshooting.mdx index 7e0f8d7b..b61f465d 100644 --- a/sdks/react/troubleshooting.mdx +++ b/sdks/react/troubleshooting.mdx @@ -414,6 +414,8 @@ function RadixDialog() { #### Problem This error occurs when using Create React App (CRA) and trying to import `@turnkey/react-wallet-kit`. CRA requires that all imports include the file extension to be fully specified. +> **Note:** This can also occur in strict ESM build environments (e.g., Next.js builds in CI) where fully specified imports are required. In those cases you may see errors like: `Cannot find module '@turnkey/core/dist/__types__/enums'` and a suggestion to import `@turnkey/core/dist/__types__/enums.js`. The fix is to ensure the import is resolved with the `.js` extension (e.g., `@turnkey/core/dist/__types__/enums.js`). If you can't edit the package source directly, apply a small build-time patch that rewrites the import. + #### Solution Follow these steps to resolve the issue: From 8117648fe78d11bfc77b62bfae510cfeae6da605 Mon Sep 17 00:00:00 2001 From: Vincente Void <67200581+vincentevoid@users.noreply.github.com> Date: Mon, 26 Jan 2026 14:37:00 -0600 Subject: [PATCH 2/2] Edited formatting for consistency --- sdks/react/troubleshooting.mdx | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/sdks/react/troubleshooting.mdx b/sdks/react/troubleshooting.mdx index b61f465d..7b837a7c 100644 --- a/sdks/react/troubleshooting.mdx +++ b/sdks/react/troubleshooting.mdx @@ -412,9 +412,7 @@ function RadixDialog() { /> #### Problem -This error occurs when using Create React App (CRA) and trying to import `@turnkey/react-wallet-kit`. CRA requires that all imports include the file extension to be fully specified. - -> **Note:** This can also occur in strict ESM build environments (e.g., Next.js builds in CI) where fully specified imports are required. In those cases you may see errors like: `Cannot find module '@turnkey/core/dist/__types__/enums'` and a suggestion to import `@turnkey/core/dist/__types__/enums.js`. The fix is to ensure the import is resolved with the `.js` extension (e.g., `@turnkey/core/dist/__types__/enums.js`). If you can't edit the package source directly, apply a small build-time patch that rewrites the import. +This error occurs when using Create React App (CRA) and trying to import `@turnkey/react-wallet-kit`. CRA requires that all imports include the file extension to be fully specified. Note that this can also occur in strict ESM build environments (e.g., Next.js builds in CI) where fully specified imports are required. In those cases you may see errors like: `Cannot find module '@turnkey/core/dist/__types__/enums'` and a suggestion to import `@turnkey/core/dist/__types__/enums.js`. The fix is to ensure the import is resolved with the `.js` extension (e.g., `@turnkey/core/dist/__types__/enums.js`). If you can't edit the package source directly, apply a small build-time patch that rewrites the import. #### Solution