feat(nextjs): Add sourcemaps.filesToDeleteAfterUpload as a top-level option (#19280)

- Adds `sourcemaps.filesToDeleteAfterUpload` to the Next.js SDK's
SentryBuildOptions type, allowing users to specify custom glob patterns
for
source map deletion after upload.
- When set, this option overrides the default deletion patterns computed
by `deleteSourcemapsAfterUpload`, giving users fine-grained control —
including the ability to target server-side source maps if desired.
  
 closes #19235

Author: chargome

packages/nextjs/src/config/getBuildPluginOptions.ts

@@ -284,12 +284,27 @@ export function getBuildPluginOptions({
 
   const finalIgnorePatterns = mergeIgnorePatterns(sourcemapUploadIgnore, sentryBuildOptions.sourcemaps?.ignore);
 
-  const filesToDeleteAfterUpload = createFilesToDeleteAfterUploadPattern(
-    normalizedDistDirAbsPath,
-    buildTool,
-    deleteSourcemapsAfterUpload,
-    useRunAfterProductionCompileHook,
-  );
+  const userFilesToDeleteAfterUpload = sentryBuildOptions.sourcemaps?.filesToDeleteAfterUpload;
+
+  if (sentryBuildOptions.debug && userFilesToDeleteAfterUpload !== undefined) {
+    // eslint-disable-next-line no-console
+    console.debug(
+      '[@sentry/nextjs] Skipping auto-deletion of source maps as user has provided filesToDeleteAfterUpload:',
+      userFilesToDeleteAfterUpload,
+    );
+  }
+
+  const filesToDeleteAfterUpload =
+    userFilesToDeleteAfterUpload !== undefined
+      ? Array.isArray(userFilesToDeleteAfterUpload)
+        ? userFilesToDeleteAfterUpload
+        : [userFilesToDeleteAfterUpload]
+      : createFilesToDeleteAfterUploadPattern(
+          normalizedDistDirAbsPath,
+          buildTool,
+          deleteSourcemapsAfterUpload,
+          useRunAfterProductionCompileHook,
+        );
 
   const skipSourcemapsUpload = shouldSkipSourcemapUpload(buildTool, useRunAfterProductionCompileHook);
 

packages/nextjs/src/config/types.ts

@@ -276,6 +276,24 @@ export type SentryBuildOptions = {
      * Defaults to `true`.
      */
     deleteSourcemapsAfterUpload?: boolean;
+
+    /**
+     * A glob or an array of globs that specifies which source map files should be deleted after being uploaded to Sentry.
+     *
+     * When set, this overrides the default deletion behavior of `deleteSourcemapsAfterUpload`.
+     *
+     * Use this option when you need fine-grained control over which source maps are deleted.
+     *
+     * @example
+     * ```javascript
+     * withSentryConfig(nextConfig, {
+     *   sourcemaps: {
+     *     filesToDeleteAfterUpload: ['.next/static/**\/*.map'],
+     *   },
+     * });
+     * ```
+     */
+    filesToDeleteAfterUpload?: string | string[];
   };
 
   /**

packages/nextjs/test/config/getBuildPluginOptions.test.ts

@@ -473,6 +473,83 @@ describe('getBuildPluginOptions', () => {
       expect(result.sourcemaps?.filesToDeleteAfterUpload).toBeUndefined();
     });
 
+    it('uses custom filesToDeleteAfterUpload string when provided', () => {
+      const sentryBuildOptions: SentryBuildOptions = {
+        org: 'test-org',
+        project: 'test-project',
+        sourcemaps: {
+          filesToDeleteAfterUpload: '.next/static/**/*.map',
+        },
+      };
+
+      const result = getBuildPluginOptions({
+        sentryBuildOptions,
+        releaseName: mockReleaseName,
+        distDirAbsPath: mockDistDirAbsPath,
+        buildTool: 'webpack-client',
+      });
+
+      expect(result.sourcemaps?.filesToDeleteAfterUpload).toEqual(['.next/static/**/*.map']);
+    });
+
+    it('uses custom filesToDeleteAfterUpload array when provided', () => {
+      const sentryBuildOptions: SentryBuildOptions = {
+        org: 'test-org',
+        project: 'test-project',
+        sourcemaps: {
+          filesToDeleteAfterUpload: ['.next/static/**/*.map', '.next/server/**/*.map'],
+        },
+      };
+
+      const result = getBuildPluginOptions({
+        sentryBuildOptions,
+        releaseName: mockReleaseName,
+        distDirAbsPath: mockDistDirAbsPath,
+        buildTool: 'webpack-client',
+      });
+
+      expect(result.sourcemaps?.filesToDeleteAfterUpload).toEqual(['.next/static/**/*.map', '.next/server/**/*.map']);
+    });
+
+    it('filesToDeleteAfterUpload overrides deleteSourcemapsAfterUpload default pattern', () => {
+      const sentryBuildOptions: SentryBuildOptions = {
+        org: 'test-org',
+        project: 'test-project',
+        sourcemaps: {
+          deleteSourcemapsAfterUpload: true,
+          filesToDeleteAfterUpload: ['custom/**/*.map'],
+        },
+      };
+
+      const result = getBuildPluginOptions({
+        sentryBuildOptions,
+        releaseName: mockReleaseName,
+        distDirAbsPath: mockDistDirAbsPath,
+        buildTool: 'webpack-client',
+      });
+
+      expect(result.sourcemaps?.filesToDeleteAfterUpload).toEqual(['custom/**/*.map']);
+    });
+
+    it('filesToDeleteAfterUpload bypasses server build guard', () => {
+      const sentryBuildOptions: SentryBuildOptions = {
+        org: 'test-org',
+        project: 'test-project',
+        sourcemaps: {
+          filesToDeleteAfterUpload: ['.next/server/**/*.map'],
+        },
+      };
+
+      const result = getBuildPluginOptions({
+        sentryBuildOptions,
+        releaseName: mockReleaseName,
+        distDirAbsPath: mockDistDirAbsPath,
+        buildTool: 'webpack-nodejs',
+      });
+
+      expect(result.sourcemaps?.filesToDeleteAfterUpload).toEqual(['.next/server/**/*.map']);
+    });
+
     it('uses custom sourcemap assets when provided', () => {
       const customAssets = ['custom/path/**', 'another/path/**'];
       const sentryBuildOptions: SentryBuildOptions = {