ref(nextjs)!: Move withSentryConfig to @sentry/nextjs/config (#23628)

Moves `withSentryConfig` and `SentryBuildOptions` to a new
`@sentry/nextjs/config` entry point, separating build-time code from the
SDK runtime. This matches the other framework SDKs, which expose their
build plugins on `./vite`, `./module` and `./middleware` rather than the
main entry.

`./config` resolves to CommonJS under both conditions, since
`next.config.mjs` is loaded by a plain Node ESM loader and the
build-time code resolves webpack loader and template paths with
`__dirname`, which is not defined in an ES module. Safe because the
module holds no SDK state.

```js
// next.config.mjs
- import { withSentryConfig } from '@sentry/nextjs';
+ import { withSentryConfig } from '@sentry/nextjs/config';
```

Breaks every existing `next.config`, but at the first build. Runtime
APIs untouched. Docs and the wizard need the same change.

This is a prerequisite for splitting the `node` export condition
(#22791), left for a follow-up. Serving the ESM server build to Next
breaks two things CommonJS currently hides: 87 browser-only names are
missing from the server build, and `cacheComponents` prerendering
rejects the `crypto.randomUUID()` inside `captureException`.

Refs #22791

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>

Author: chargome

MIGRATION.md

@@ -1279,6 +1279,21 @@ The legacy per-transaction profiling sampling options were removed. Configure se
 
 ### `@sentry/nextjs`
 
+`withSentryConfig` and the `SentryBuildOptions` type moved to the `@sentry/nextjs/config` entry point and are no
+longer exported from `@sentry/nextjs`:
+
+```js
+// next.config.mjs
+
+// before
+import { withSentryConfig } from '@sentry/nextjs';
+
+// after
+import { withSentryConfig } from '@sentry/nextjs/config';
+```
+
+The no-op `withSentryConfig` passthroughs that the client and edge builds exported were removed along with it.
+
 The following long-deprecated top-level options in `withSentryConfig` / the `sentry` config were removed. Most of them
 moved under the `webpack` option in v10; use the replacement listed below instead:
 

dev-packages/e2e-tests/test-applications/nextjs-14/next.config.js

@@ -1,4 +1,4 @@
-const { withSentryConfig } = require('@sentry/nextjs');
+const { withSentryConfig } = require('@sentry/nextjs/config');
 
 /** @type {import('next').NextConfig} */
 const nextConfig = {};

dev-packages/e2e-tests/test-applications/nextjs-15-basepath/next.config.js

@@ -1,4 +1,4 @@
-const { withSentryConfig } = require('@sentry/nextjs');
+const { withSentryConfig } = require('@sentry/nextjs/config');
 
 /** @type {import('next').NextConfig} */
 const nextConfig = {

dev-packages/e2e-tests/test-applications/nextjs-15-intl/next.config.js

@@ -1,4 +1,4 @@
-const { withSentryConfig } = require('@sentry/nextjs');
+const { withSentryConfig } = require('@sentry/nextjs/config');
 const createNextIntlPlugin = require('next-intl/plugin');
 
 const withNextIntl = createNextIntlPlugin('./i18n/request.ts');

dev-packages/e2e-tests/test-applications/nextjs-15-t3/next.config.js

@@ -3,7 +3,7 @@ await import('./src/env.js');
 /** @type {import("next").NextConfig} */
 const config = {};
 
-import { withSentryConfig } from '@sentry/nextjs';
+import { withSentryConfig } from '@sentry/nextjs/config';
 
 export default withSentryConfig(config, {
   webpack: {

dev-packages/e2e-tests/test-applications/nextjs-15/next.config.js

@@ -1,4 +1,4 @@
-const { withSentryConfig } = require('@sentry/nextjs');
+const { withSentryConfig } = require('@sentry/nextjs/config');
 
 // Simulate Vercel environment for cron monitoring tests
 process.env.VERCEL = '1';

dev-packages/e2e-tests/test-applications/nextjs-16-bun/next.config.ts

@@ -1,4 +1,4 @@
-import { withSentryConfig } from '@sentry/nextjs';
+import { withSentryConfig } from '@sentry/nextjs/config';
 import type { NextConfig } from 'next';
 
 const nextConfig: NextConfig = {};

dev-packages/e2e-tests/test-applications/nextjs-16-cacheComponents/next.config.ts

@@ -1,4 +1,4 @@
-import { withSentryConfig } from '@sentry/nextjs';
+import { withSentryConfig } from '@sentry/nextjs/config';
 import type { NextConfig } from 'next';
 
 const nextConfig: NextConfig = {

dev-packages/e2e-tests/test-applications/nextjs-16-cf-workers/next.config.ts

@@ -1,4 +1,4 @@
-import { withSentryConfig } from '@sentry/nextjs';
+import { withSentryConfig } from '@sentry/nextjs/config';
 import type { NextConfig } from 'next';
 
 const nextConfig: NextConfig = {};

dev-packages/e2e-tests/test-applications/nextjs-16-streaming-cacheComponents/next.config.ts

@@ -1,4 +1,4 @@
-import { withSentryConfig } from '@sentry/nextjs';
+import { withSentryConfig } from '@sentry/nextjs/config';
 import type { NextConfig } from 'next';
 
 const nextConfig: NextConfig = {