add troubleshooting section for pnpm

Author: chargome

docs/platforms/javascript/common/troubleshooting/index.mdx

@@ -431,6 +431,30 @@ Learn more about fixing these caching issues in the <PlatformLink to="/sourcemap
 
 </Expandable>
 
+
 </PlatformSection>
 
+<Expandable permalink title="pnpm: Resolving 'import-in-the-middle' external package errors">
+
+When using pnpm, you might encounter errors related to packages that can't be external, particularly with packages like `import-in-the-middle` and `require-in-the-middle`. These errors typically occur due to pnpm's strict dependency management and hoisting behavior.
+
+While adding these packages as direct dependencies might remove the warning messages, it often doesn't resolve the underlying functionality issues:
+
+```bash
+pnpm add import-in-the-middle require-in-the-middle
+```
+
+The actual fix requires modifying your `.npmrc` file by adding these lines:
+
+```npmrc
+shamefully-hoist=true
+strict-peer-dependencies=false
+```
+<Alert level="warning">
+**Note**: While `shamefully-hoist=true` usually isn't the ideal solution from a dependency management perspective, it's sometimes necessary for compatibility with certain packages that expect Node.js module resolution behavior similar to npm or yarn.
+</Alert>
+
+
+</Expandable>
+
 If you need additional help, you can [ask on GitHub](https://github.com/getsentry/sentry-javascript/issues/new/choose). Customers on a paid plan may also contact support.