@sentry/nuxt 10.0.0 → 10.2.0

package/build/module/module.d.ts

@@ -1,4 +1,5 @@
 import * as _nuxt_schema from '@nuxt/schema';
+import { BuildTimeOptionsBase } from '@sentry/core';
 import { SentryRollupPluginOptions } from '@sentry/rollup-plugin';
 import { SentryVitePluginOptions } from '@sentry/vite-plugin';
 
@@ -7,6 +8,7 @@ type SourceMapsOptions = {
      * Suppresses all logs.
      *
      * @default false
+     * @deprecated Use option `silent` instead of `sourceMapsUploadOptions.silent`
      */
     silent?: boolean;
     /**
@@ -23,12 +25,16 @@ type SourceMapsOptions = {
      *   console.warn(err);
      * }
      * ```
+     *
+     * @deprecated Use option `errorHandler` instead of `sourceMapsUploadOptions.errorHandler`
      */
     errorHandler?: (err: Error) => void;
     /**
      * Options related to managing the Sentry releases for a build.
      *
      * More info: https://docs.sentry.io/product/releases/
+     *
+     * @deprecated Use option `release` instead of `sourceMapsUploadOptions.release`
      */
     release?: {
         /**
@@ -41,6 +47,8 @@ type SourceMapsOptions = {
          * (the latter requires access to git CLI and for the root directory to be a valid repository)
          *
          * If you didn't provide a value and the plugin can't automatically detect one, no release will be created.
+         *
+         * @deprecated Use `release.name` instead of `sourceMapsUploadOptions.release.name`
          */
         name?: string;
     };
@@ -49,6 +57,7 @@ type SourceMapsOptions = {
      * automatically generate and upload source maps to Sentry during a production build.
      *
      * @default true
+     * @deprecated Use option `sourcemaps.disable` instead of `sourceMapsUploadOptions.enabled`
      */
     enabled?: boolean;
     /**
@@ -58,22 +67,27 @@ type SourceMapsOptions = {
      *
      * To create an auth token, follow this guide:
      * @see https://docs.sentry.io/product/accounts/auth-tokens/#organization-auth-tokens
+     * @deprecated Use option `authToken` instead of `sourceMapsUploadOptions.authToken`
      */
     authToken?: string;
     /**
      * The organization slug of your Sentry organization.
      * Instead of specifying this option, you can also set the `SENTRY_ORG` environment variable.
+     * @deprecated Use option `org` instead of `sourceMapsUploadOptions.org`
      */
     org?: string;
     /**
      * The URL of your Sentry instance if you're using self-hosted Sentry.
      *
      * @default https://sentry.io by default the plugin will point towards the Sentry SaaS URL
+     * @deprecated Use `sentryUrl` instead of `sourceMapsUploadOptions.url`
      */
     url?: string;
     /**
      * The project slug of your Sentry project.
      * Instead of specifying this option, you can also set the `SENTRY_PROJECT` environment variable.
+     *
+     * @deprecated Use option `project` instead of `sourceMapsUploadOptions.project`
      */
     project?: string;
     /**
@@ -81,10 +95,13 @@ type SourceMapsOptions = {
      * It will not collect any sensitive or user-specific data.
      *
      * @default true
+     * @deprecated Use option `telemetry` instead of `sourceMapsUploadOptions.telemetry`
      */
     telemetry?: boolean;
     /**
      * Options related to sourcemaps
+     *
+     * @deprecated Use option `sourcemaps` instead of `sourceMapsUploadOptions.sourcemaps`
      */
     sourcemaps?: {
         /**
@@ -96,6 +113,8 @@ type SourceMapsOptions = {
          *
          * The globbing patterns must follow the implementation of the `glob` package.
          * @see https://www.npmjs.com/package/glob#glob-primer
+         *
+         * @deprecated Use option `sourcemaps.assets` instead of `sourceMapsUploadOptions.sourcemaps.assets`
          */
         assets?: string | Array<string>;
         /**
@@ -105,6 +124,8 @@ type SourceMapsOptions = {
          * or the default value for `assets` are uploaded.
          *
          * The globbing patterns follow the implementation of the glob package. (https://www.npmjs.com/package/glob)
+         *
+         * @deprecated Use option `sourcemaps.ignore` instead of `sourceMapsUploadOptions.sourcemaps.ignore`
          */
         ignore?: string | Array<string>;
         /**
@@ -114,6 +135,8 @@ type SourceMapsOptions = {
          * @default [] - By default no files are deleted.
          *
          * The globbing patterns follow the implementation of the glob package. (https://www.npmjs.com/package/glob)
+         *
+         * @deprecated Use option `sourcemaps.filesToDeleteAfterUpload` instead of `sourceMapsUploadOptions.sourcemaps.filesToDeleteAfterUpload`
          */
         filesToDeleteAfterUpload?: string | Array<string>;
     };
@@ -121,7 +144,7 @@ type SourceMapsOptions = {
 /**
  *  Build options for the Sentry module. These options are used during build-time by the Sentry SDK.
  */
-type SentryNuxtModuleOptions = {
+type SentryNuxtModuleOptions = BuildTimeOptionsBase & {
     /**
      * Enable the Sentry Nuxt Module.
      *
@@ -133,13 +156,11 @@ type SentryNuxtModuleOptions = {
      *
      * These options are always read from the `sentry` module options in the `nuxt.config.(js|ts).
      * Do not define them in the `sentry.client.config.(js|ts)` or `sentry.server.config.(js|ts)` files.
+     *
+     * @deprecated  This option was deprecated as it adds unnecessary nesting.
+     *              Put the options one level higher to the root-level of the `sentry` module options.
      */
     sourceMapsUploadOptions?: SourceMapsOptions;
-    /**
-     * Enable debug functionality of the SDK during build-time.
-     * Enabling this will give you, for example, logs about source maps.
-     */
-    debug?: boolean;
     /**
      *
      * Enables (partial) server tracing by automatically injecting Sentry for environments where modifying the node option `--import` is not possible.

package/build/module/module.json

@@ -4,7 +4,7 @@
   "compatibility": {
     "nuxt": ">=3.7.0"
   },
-  "version": "10.0.0",
+  "version": "10.2.0",
   "builder": {
     "@nuxt/module-builder": "0.8.4",
     "unbuild": "2.0.0"

package/build/module/module.mjs

@@ -256,7 +256,10 @@ ${reExportedFunctions}
 function setupSourceMaps(moduleOptions, nuxt) {
   const isDebug = moduleOptions.debug;
   const sourceMapsUploadOptions = moduleOptions.sourceMapsUploadOptions || {};
-  const sourceMapsEnabled = sourceMapsUploadOptions.enabled ?? true;
+  const sourceMapsEnabled = moduleOptions.sourcemaps?.disable === true ? false : moduleOptions.sourcemaps?.disable === false ? true : (
+    // eslint-disable-next-line deprecation/deprecation
+    sourceMapsUploadOptions.enabled ?? true
+  );
   let shouldDeleteFilesFallback = { client: true, server: true };
   nuxt.hook("modules:done", () => {
     if (sourceMapsEnabled && !nuxt.options.dev) {
@@ -265,14 +268,10 @@ function setupSourceMaps(moduleOptions, nuxt) {
         client: previousSourceMapSettings.client === "unset",
         server: previousSourceMapSettings.server === "unset"
       };
-      if (isDebug && !sourceMapsUploadOptions.sourcemaps?.filesToDeleteAfterUpload && (shouldDeleteFilesFallback.client || shouldDeleteFilesFallback.server)) {
-        consoleSandbox(
-          () => (
-            // eslint-disable-next-line no-console
-            console.log(
-              "[Sentry] As Sentry enabled `'hidden'` source maps, source maps will be automatically deleted after uploading them to Sentry."
-            )
-          )
+      if (isDebug && !moduleOptions.sourcemaps?.filesToDeleteAfterUpload && // eslint-disable-next-line deprecation/deprecation
+      !sourceMapsUploadOptions.sourcemaps?.filesToDeleteAfterUpload && (shouldDeleteFilesFallback.client || shouldDeleteFilesFallback.server)) {
+        console.log(
+          "[Sentry] As Sentry enabled `'hidden'` source maps, source maps will be automatically deleted after uploading them to Sentry."
         );
       }
     }
@@ -290,13 +289,11 @@ function setupSourceMaps(moduleOptions, nuxt) {
         otherSettingValue: viteSourceMap
       });
       if (isDebug) {
-        consoleSandbox(() => {
-          if (!runtime) {
-            console.log("[Sentry] Cannot detect runtime (client/server) inside hook 'vite:extendConfig'.");
-          } else {
-            console.log(`[Sentry] Adding Sentry Vite plugin to the ${runtime} runtime.`);
-          }
-        });
+        if (!runtime) {
+          console.log("[Sentry] Cannot detect runtime (client/server) inside hook 'vite:extendConfig'.");
+        } else {
+          console.log(`[Sentry] Adding Sentry Vite plugin to the ${runtime} runtime.`);
+        }
       }
       viteConfig.plugins = viteConfig.plugins || [];
       viteConfig.plugins.push(sentryVitePlugin(getPluginOptions(moduleOptions, shouldDeleteFilesFallback)));
@@ -314,9 +311,7 @@ function setupSourceMaps(moduleOptions, nuxt) {
       }
       validateNitroSourceMapSettings(nuxt, nitroConfig, moduleOptions);
       if (isDebug) {
-        consoleSandbox(() => {
-          console.log("[Sentry] Adding Sentry Rollup plugin to the server runtime.");
-        });
+        console.log("[Sentry] Adding Sentry Rollup plugin to the server runtime.");
       }
       nitroConfig.rollupConfig.plugins.push(
         sentryRollupPlugin(getPluginOptions(moduleOptions, shouldDeleteFilesFallback))
@@ -334,24 +329,39 @@ function getPluginOptions(moduleOptions, shouldDeleteFilesFallback) {
     ...shouldDeleteFilesFallback?.client ? [".*/**/public/**/*.map"] : [],
     ...shouldDeleteFilesFallback?.server ? [".*/**/server/**/*.map", ".*/**/output/**/*.map", ".*/**/function/**/*.map"] : []
   ];
-  if (typeof sourceMapsUploadOptions.sourcemaps?.filesToDeleteAfterUpload === "undefined" && shouldDeleteFilesAfterUpload) {
-    consoleSandbox(() => {
-      console.log(
-        `[Sentry] Setting \`sentry.sourceMapsUploadOptions.sourcemaps.filesToDeleteAfterUpload: [${fallbackFilesToDelete.map((path) => `"${path}"`).join(", ")}]\` to delete generated source maps after they were uploaded to Sentry.`
-      );
-    });
+  const sourcemapsOptions = moduleOptions.sourcemaps || {};
+  const deprecatedSourcemapsOptions = sourceMapsUploadOptions.sourcemaps || {};
+  const filesToDeleteAfterUpload = sourcemapsOptions.filesToDeleteAfterUpload ?? // eslint-disable-next-line deprecation/deprecation
+  deprecatedSourcemapsOptions.filesToDeleteAfterUpload;
+  if (typeof filesToDeleteAfterUpload === "undefined" && shouldDeleteFilesAfterUpload && moduleOptions.debug) {
+    console.log(
+      `[Sentry] Setting \`sentry.sourceMapsUploadOptions.sourcemaps.filesToDeleteAfterUpload: [${fallbackFilesToDelete.map((path) => `"${path}"`).join(", ")}]\` to delete generated source maps after they were uploaded to Sentry.`
+    );
   }
   return {
-    org: sourceMapsUploadOptions.org ?? process.env.SENTRY_ORG,
-    project: sourceMapsUploadOptions.project ?? process.env.SENTRY_PROJECT,
-    authToken: sourceMapsUploadOptions.authToken ?? process.env.SENTRY_AUTH_TOKEN,
-    telemetry: sourceMapsUploadOptions.telemetry ?? true,
-    url: sourceMapsUploadOptions.url ?? process.env.SENTRY_URL,
+    // eslint-disable-next-line deprecation/deprecation
+    org: moduleOptions.org ?? sourceMapsUploadOptions.org ?? process.env.SENTRY_ORG,
+    // eslint-disable-next-line deprecation/deprecation
+    project: moduleOptions.project ?? sourceMapsUploadOptions.project ?? process.env.SENTRY_PROJECT,
+    // eslint-disable-next-line deprecation/deprecation
+    authToken: moduleOptions.authToken ?? sourceMapsUploadOptions.authToken ?? process.env.SENTRY_AUTH_TOKEN,
+    // eslint-disable-next-line deprecation/deprecation
+    telemetry: moduleOptions.telemetry ?? sourceMapsUploadOptions.telemetry ?? true,
+    // eslint-disable-next-line deprecation/deprecation
+    url: moduleOptions.sentryUrl ?? sourceMapsUploadOptions.url ?? process.env.SENTRY_URL,
+    headers: moduleOptions.headers,
     debug: moduleOptions.debug ?? false,
-    silent: sourceMapsUploadOptions.silent ?? false,
-    errorHandler: sourceMapsUploadOptions.errorHandler,
+    // eslint-disable-next-line deprecation/deprecation
+    silent: moduleOptions.silent ?? sourceMapsUploadOptions.silent ?? false,
+    // eslint-disable-next-line deprecation/deprecation
+    errorHandler: moduleOptions.errorHandler ?? sourceMapsUploadOptions.errorHandler,
+    bundleSizeOptimizations: moduleOptions.bundleSizeOptimizations,
+    // todo: test if this can be overridden by the user
     release: {
-      name: sourceMapsUploadOptions.release?.name,
+      // eslint-disable-next-line deprecation/deprecation
+      name: moduleOptions.release?.name ?? sourceMapsUploadOptions.release?.name,
+      // Support all release options from BuildTimeOptionsBase
+      ...moduleOptions.release,
       ...moduleOptions?.unstable_sentryBundlerPluginOptions?.release
     },
     _metaOptions: {
@@ -361,12 +371,15 @@ function getPluginOptions(moduleOptions, shouldDeleteFilesFallback) {
     },
     ...moduleOptions?.unstable_sentryBundlerPluginOptions,
     sourcemaps: {
+      disable: moduleOptions.sourcemaps?.disable,
       // The server/client files are in different places depending on the nitro preset (e.g. '.output/server' or '.netlify/functions-internal/server')
       // We cannot determine automatically how the build folder looks like (depends on the preset), so we have to accept that source maps are uploaded multiple times (with the vitePlugin for Nuxt and the rollupPlugin for Nitro).
       // If we could know where the server/client assets are located, we could do something like this (based on the Nitro preset): isNitro ? ['./.output/server/**/*'] : ['./.output/public/**/*'],
-      assets: sourceMapsUploadOptions.sourcemaps?.assets ?? void 0,
-      ignore: sourceMapsUploadOptions.sourcemaps?.ignore ?? void 0,
-      filesToDeleteAfterUpload: sourceMapsUploadOptions.sourcemaps?.filesToDeleteAfterUpload ? sourceMapsUploadOptions.sourcemaps?.filesToDeleteAfterUpload : shouldDeleteFilesFallback?.server || shouldDeleteFilesFallback?.client ? fallbackFilesToDelete : void 0,
+      // eslint-disable-next-line deprecation/deprecation
+      assets: sourcemapsOptions.assets ?? deprecatedSourcemapsOptions.assets ?? void 0,
+      // eslint-disable-next-line deprecation/deprecation
+      ignore: sourcemapsOptions.ignore ?? deprecatedSourcemapsOptions.ignore ?? void 0,
+      filesToDeleteAfterUpload: filesToDeleteAfterUpload ? filesToDeleteAfterUpload : shouldDeleteFilesFallback?.server || shouldDeleteFilesFallback?.client ? fallbackFilesToDelete : void 0,
       rewriteSources: (source) => normalizePath(source),
       ...moduleOptions?.unstable_sentryBundlerPluginOptions?.sourcemaps
     }
@@ -386,10 +399,11 @@ function changeNuxtSourceMapSettings(nuxt, sentryModuleOptions) {
     server: void 0
   };
   const nuxtSourceMap = nuxt.options.sourcemap;
+  const isDebug = sentryModuleOptions.debug;
   if (typeof nuxtSourceMap === "string" || typeof nuxtSourceMap === "boolean" || typeof nuxtSourceMap === "undefined") {
     switch (nuxtSourceMap) {
       case false:
-        warnExplicitlyDisabledSourceMap("sourcemap");
+        warnExplicitlyDisabledSourceMap("sourcemap", isDebug);
         previousUserSourceMapSetting = { client: "disabled", server: "disabled" };
         break;
       case "hidden":
@@ -399,32 +413,32 @@ function changeNuxtSourceMapSettings(nuxt, sentryModuleOptions) {
         break;
       case void 0:
         nuxt.options.sourcemap = { server: "hidden", client: "hidden" };
-        logSentryEnablesSourceMap("sourcemap.client", "hidden");
-        logSentryEnablesSourceMap("sourcemap.server", "hidden");
+        isDebug && logSentryEnablesSourceMap("sourcemap.client", "hidden");
+        isDebug && logSentryEnablesSourceMap("sourcemap.server", "hidden");
         previousUserSourceMapSetting = { client: "unset", server: "unset" };
         break;
     }
   } else {
     if (nuxtSourceMap.client === false) {
-      warnExplicitlyDisabledSourceMap("sourcemap.client");
+      warnExplicitlyDisabledSourceMap("sourcemap.client", isDebug);
       previousUserSourceMapSetting.client = "disabled";
     } else if (["hidden", true].includes(nuxtSourceMap.client)) {
       logKeepEnabledSourceMapSetting(sentryModuleOptions, "sourcemap.client", nuxtSourceMap.client.toString());
       previousUserSourceMapSetting.client = "enabled";
     } else {
       nuxt.options.sourcemap.client = "hidden";
-      logSentryEnablesSourceMap("sourcemap.client", "hidden");
+      isDebug && logSentryEnablesSourceMap("sourcemap.client", "hidden");
       previousUserSourceMapSetting.client = "unset";
     }
     if (nuxtSourceMap.server === false) {
-      warnExplicitlyDisabledSourceMap("sourcemap.server");
+      warnExplicitlyDisabledSourceMap("sourcemap.server", isDebug);
       previousUserSourceMapSetting.server = "disabled";
     } else if (["hidden", true].includes(nuxtSourceMap.server)) {
       logKeepEnabledSourceMapSetting(sentryModuleOptions, "sourcemap.server", nuxtSourceMap.server.toString());
       previousUserSourceMapSetting.server = "enabled";
     } else {
       nuxt.options.sourcemap.server = "hidden";
-      logSentryEnablesSourceMap("sourcemap.server", "hidden");
+      isDebug && logSentryEnablesSourceMap("sourcemap.server", "hidden");
       previousUserSourceMapSetting.server = "unset";
     }
   }
@@ -453,11 +467,9 @@ function validateNitroSourceMapSettings(nuxt, nitroConfig, sentryModuleOptions)
   }
   nitroConfig.rollupConfig.output.sourcemapExcludeSources = false;
   if (isDebug) {
-    consoleSandbox(() => {
-      console.log(
-        "[Sentry] Set `sourcemapExcludeSources: false` in the Nuxt config (`nitro.rollupConfig.output`). Source maps will now include the actual code to be able to un-minify code snippets in Sentry."
-      );
-    });
+    console.log(
+      "[Sentry] Set `sourcemapExcludeSources: false` in the Nuxt config (`nitro.rollupConfig.output`). Source maps will now include the actual code to be able to un-minify code snippets in Sentry."
+    );
   }
 }
 function validateDifferentSourceMapSettings({
@@ -467,33 +479,29 @@ function validateDifferentSourceMapSettings({
   otherSettingValue
 }) {
   if (nuxtSettingValue !== otherSettingValue) {
-    consoleSandbox(() => {
-      console.warn(
-        `[Sentry] Source map generation settings are conflicting. Sentry uses \`${nuxtSettingKey}: ${nuxtSettingValue}\`. However, a conflicting setting was discovered (\`${otherSettingKey}: ${otherSettingValue}\`). This setting was probably explicitly set in your configuration. Sentry won't override this setting but it may affect source maps generation and upload. Without source maps, code snippets on the Sentry Issues page will remain minified.`
-      );
-    });
+    console.warn(
+      `[Sentry] Source map generation settings are conflicting. Sentry uses \`${nuxtSettingKey}: ${nuxtSettingValue}\`. However, a conflicting setting was discovered (\`${otherSettingKey}: ${otherSettingValue}\`). This setting was probably explicitly set in your configuration. Sentry won't override this setting but it may affect source maps generation and upload. Without source maps, code snippets on the Sentry Issues page will remain minified.`
+    );
   }
 }
 function logKeepEnabledSourceMapSetting(sentryNuxtModuleOptions, settingKey, settingValue) {
   if (sentryNuxtModuleOptions.debug) {
-    consoleSandbox(() => {
-      console.log(
-        `[Sentry] \`${settingKey}\` is enabled with \`${settingValue}\`. This will correctly un-minify the code snippet on the Sentry Issue Details page.`
-      );
-    });
+    console.log(
+      `[Sentry] \`${settingKey}\` is enabled with \`${settingValue}\`. This will correctly un-minify the code snippet on the Sentry Issue Details page.`
+    );
   }
 }
-function warnExplicitlyDisabledSourceMap(settingKey) {
-  consoleSandbox(() => {
+function warnExplicitlyDisabledSourceMap(settingKey, isDebug) {
+  if (isDebug) {
     console.warn(
-      `[Sentry] We discovered \`${settingKey}\` is set to \`false\`. This setting is either a default setting or was explicitly set in your configuration. Sentry won't override this setting. Without source maps, code snippets on the Sentry Issues page will remain minified. To show unminified code, enable source maps in \`${settingKey}\` (e.g. by setting them to \`'hidden'\`).`
+      `[Sentry] Source map generation is currently disabled in your Vite configuration (\`${settingKey}: false \`). This setting is either a default setting or was explicitly set in your configuration. Sentry won't override this setting. Without source maps, code snippets on the Sentry Issues page will remain minified. To show unminified code, enable source maps in \`${settingKey}\` (e.g. by setting them to \`hidden\`).`
     );
-  });
+  } else {
+    console.warn(`[Sentry] Source map generation (\`${settingKey}\`) is disabled in your Vite configuration.`);
+  }
 }
 function logSentryEnablesSourceMap(settingKey, settingValue) {
-  consoleSandbox(() => {
-    console.log(`[Sentry] Enabled source map generation in the build options with \`${settingKey}: ${settingValue}\`.`);
-  });
+  console.log(`[Sentry] Enabled source map generation in the build options with \`${settingKey}: ${settingValue}\`.`);
 }
 
 const module = defineNuxtModule({

package/build/module/runtime/plugins/sentry.server.js

@@ -13,8 +13,18 @@ export default defineNitroPlugin((nitroApp) => {
   nitroApp.h3App.handler = patchEventHandler(nitroApp.h3App.handler);
   nitroApp.hooks.hook("beforeResponse", updateRouteBeforeResponse);
   nitroApp.hooks.hook("error", sentryCaptureErrorHook);
-  nitroApp.hooks.hook("render:html", (html) => {
-    addSentryTracingMetaTags(html.head);
+  nitroApp.hooks.hook("render:html", (html, { event }) => {
+    const headers = event.node.res?.getHeaders() || {};
+    const isPreRenderedPage = Object.keys(headers).includes("x-nitro-prerender");
+    const isSWRCachedPage = event?.context?.cache?.options.swr;
+    if (!isPreRenderedPage && !isSWRCachedPage) {
+      addSentryTracingMetaTags(html.head);
+    } else {
+      const reason = isPreRenderedPage ? "the page was pre-rendered" : "SWR caching is enabled for the route";
+      debug.log(
+        `Not adding Sentry tracing meta tags to HTML for ${event.path} because ${reason}. This will disable distributed tracing and prevent connecting multiple client page loads to the same server request.`
+      );
+    }
   });
 });
 function patchEventHandler(handler) {

package/build/types/common/types.d.ts

@@ -1,3 +1,4 @@
+import type { BuildTimeOptionsBase } from '@sentry/core';
 import type { init as initNode } from '@sentry/node';
 import type { SentryRollupPluginOptions } from '@sentry/rollup-plugin';
 import type { SentryVitePluginOptions } from '@sentry/vite-plugin';
@@ -22,6 +23,7 @@ type SourceMapsOptions = {
      * Suppresses all logs.
      *
      * @default false
+     * @deprecated Use option `silent` instead of `sourceMapsUploadOptions.silent`
      */
     silent?: boolean;
     /**
@@ -38,12 +40,16 @@ type SourceMapsOptions = {
      *   console.warn(err);
      * }
      * ```
+     *
+     * @deprecated Use option `errorHandler` instead of `sourceMapsUploadOptions.errorHandler`
      */
     errorHandler?: (err: Error) => void;
     /**
      * Options related to managing the Sentry releases for a build.
      *
      * More info: https://docs.sentry.io/product/releases/
+     *
+     * @deprecated Use option `release` instead of `sourceMapsUploadOptions.release`
      */
     release?: {
         /**
@@ -56,6 +62,8 @@ type SourceMapsOptions = {
          * (the latter requires access to git CLI and for the root directory to be a valid repository)
          *
          * If you didn't provide a value and the plugin can't automatically detect one, no release will be created.
+         *
+         * @deprecated Use `release.name` instead of `sourceMapsUploadOptions.release.name`
          */
         name?: string;
     };
@@ -64,6 +72,7 @@ type SourceMapsOptions = {
      * automatically generate and upload source maps to Sentry during a production build.
      *
      * @default true
+     * @deprecated Use option `sourcemaps.disable` instead of `sourceMapsUploadOptions.enabled`
      */
     enabled?: boolean;
     /**
@@ -73,22 +82,27 @@ type SourceMapsOptions = {
      *
      * To create an auth token, follow this guide:
      * @see https://docs.sentry.io/product/accounts/auth-tokens/#organization-auth-tokens
+     * @deprecated Use option `authToken` instead of `sourceMapsUploadOptions.authToken`
      */
     authToken?: string;
     /**
      * The organization slug of your Sentry organization.
      * Instead of specifying this option, you can also set the `SENTRY_ORG` environment variable.
+     * @deprecated Use option `org` instead of `sourceMapsUploadOptions.org`
      */
     org?: string;
     /**
      * The URL of your Sentry instance if you're using self-hosted Sentry.
      *
      * @default https://sentry.io by default the plugin will point towards the Sentry SaaS URL
+     * @deprecated Use `sentryUrl` instead of `sourceMapsUploadOptions.url`
      */
     url?: string;
     /**
      * The project slug of your Sentry project.
      * Instead of specifying this option, you can also set the `SENTRY_PROJECT` environment variable.
+     *
+     * @deprecated Use option `project` instead of `sourceMapsUploadOptions.project`
      */
     project?: string;
     /**
@@ -96,10 +110,13 @@ type SourceMapsOptions = {
      * It will not collect any sensitive or user-specific data.
      *
      * @default true
+     * @deprecated Use option `telemetry` instead of `sourceMapsUploadOptions.telemetry`
      */
     telemetry?: boolean;
     /**
      * Options related to sourcemaps
+     *
+     * @deprecated Use option `sourcemaps` instead of `sourceMapsUploadOptions.sourcemaps`
      */
     sourcemaps?: {
         /**
@@ -111,6 +128,8 @@ type SourceMapsOptions = {
          *
          * The globbing patterns must follow the implementation of the `glob` package.
          * @see https://www.npmjs.com/package/glob#glob-primer
+         *
+         * @deprecated Use option `sourcemaps.assets` instead of `sourceMapsUploadOptions.sourcemaps.assets`
          */
         assets?: string | Array<string>;
         /**
@@ -120,6 +139,8 @@ type SourceMapsOptions = {
          * or the default value for `assets` are uploaded.
          *
          * The globbing patterns follow the implementation of the glob package. (https://www.npmjs.com/package/glob)
+         *
+         * @deprecated Use option `sourcemaps.ignore` instead of `sourceMapsUploadOptions.sourcemaps.ignore`
          */
         ignore?: string | Array<string>;
         /**
@@ -129,6 +150,8 @@ type SourceMapsOptions = {
          * @default [] - By default no files are deleted.
          *
          * The globbing patterns follow the implementation of the glob package. (https://www.npmjs.com/package/glob)
+         *
+         * @deprecated Use option `sourcemaps.filesToDeleteAfterUpload` instead of `sourceMapsUploadOptions.sourcemaps.filesToDeleteAfterUpload`
          */
         filesToDeleteAfterUpload?: string | Array<string>;
     };
@@ -136,7 +159,7 @@ type SourceMapsOptions = {
 /**
  *  Build options for the Sentry module. These options are used during build-time by the Sentry SDK.
  */
-export type SentryNuxtModuleOptions = {
+export type SentryNuxtModuleOptions = BuildTimeOptionsBase & {
     /**
      * Enable the Sentry Nuxt Module.
      *
@@ -148,13 +171,11 @@ export type SentryNuxtModuleOptions = {
      *
      * These options are always read from the `sentry` module options in the `nuxt.config.(js|ts).
      * Do not define them in the `sentry.client.config.(js|ts)` or `sentry.server.config.(js|ts)` files.
+     *
+     * @deprecated  This option was deprecated as it adds unnecessary nesting.
+     *              Put the options one level higher to the root-level of the `sentry` module options.
      */
     sourceMapsUploadOptions?: SourceMapsOptions;
-    /**
-     * Enable debug functionality of the SDK during build-time.
-     * Enabling this will give you, for example, logs about source maps.
-     */
-    debug?: boolean;
     /**
      *
      * Enables (partial) server tracing by automatically injecting Sentry for environments where modifying the node option `--import` is not possible.

package/build/types/common/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC;AAInD,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,CAAC;AAC1F,MAAM,MAAM,uBAAuB,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG;IACrE;;;;;;;;;;OAUG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;;;;;;;;;;;OAcG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAEpC;;;;OAIG;IACH,OAAO,CAAC,EAAE;QACR;;;;;;;;;;WAUG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IAEF;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,UAAU,CAAC,EAAE;QACX;;;;;;;;;WASG;QACH,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAEhC;;;;;;;WAOG;QACH,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAEhC;;;;;;;WAOG;QACH,wBAAwB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;KACnD,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;OAKG;IACH,uBAAuB,CAAC,EAAE,iBAAiB,CAAC;IAE5C;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,sBAAsB,CAAC,EAAE,kBAAkB,GAAG,6BAA6B,CAAC;IAE5E;;;;;;;;;;OAUG;IACH,uCAAuC,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnD;;;;;OAKG;IACH,mCAAmC,CAAC,EAAE,yBAAyB,GAAG,uBAAuB,CAAC;CAC3F,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC;AAInD,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,CAAC;AAC1F,MAAM,MAAM,uBAAuB,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG;IACrE;;;;;;;;;;OAUG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAEpC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE;QACR;;;;;;;;;;;;WAYG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IAEF;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,UAAU,CAAC,EAAE;QACX;;;;;;;;;;;WAWG;QACH,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAEhC;;;;;;;;;WASG;QACH,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAEhC;;;;;;;;;WASG;QACH,wBAAwB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;KACnD,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,oBAAoB,GAAG;IAC3D;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;;;;OAQG;IACH,uBAAuB,CAAC,EAAE,iBAAiB,CAAC;IAE5C;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,sBAAsB,CAAC,EAAE,kBAAkB,GAAG,6BAA6B,CAAC;IAE5E;;;;;;;;;;OAUG;IACH,uCAAuC,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnD;;;;;OAKG;IACH,mCAAmC,CAAC,EAAE,yBAAyB,GAAG,uBAAuB,CAAC;CAC3F,CAAC"}

package/build/types/runtime/plugins/sentry.server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sentry.server.d.ts","sourceRoot":"","sources":["../../../../src/runtime/plugins/sentry.server.ts"],"names":[],"mappings":";AAgBA,wBAWG"}
+{"version":3,"file":"sentry.server.d.ts","sourceRoot":"","sources":["../../../../src/runtime/plugins/sentry.server.ts"],"names":[],"mappings":";AAeA,wBAwBG"}

package/build/types/vite/sourceMaps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sourceMaps.d.ts","sourceRoot":"","sources":["../../../src/vite/sourceMaps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,KAAK,yBAAyB,EAAsB,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAAE,KAAK,uBAAuB,EAAoB,MAAM,qBAAqB,CAAC;AACrF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AAEhF,iCAAiC;AACjC,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE7D;;GAEG;AACH,wBAAgB,eAAe,CAAC,aAAa,EAAE,uBAAuB,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAwGxF;AASD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,uBAAuB,EACtC,yBAAyB,CAAC,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC/D,uBAAuB,GAAG,yBAAyB,CA6DrD;AAeD,8BAA8B;AAC9B,wBAAgB,2BAA2B,CACzC,IAAI,EAAE;IAAE,OAAO,EAAE;QAAE,SAAS,CAAC,EAAE,gBAAgB,GAAG;YAAE,MAAM,CAAC,EAAE,gBAAgB,CAAC;YAAC,MAAM,CAAC,EAAE,gBAAgB,CAAA;SAAE,CAAA;KAAE,CAAA;CAAE,EAC9G,OAAO,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GACvC,gBAAgB,GAAG,SAAS,CAQ9B;AAED,iCAAiC;AACjC,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,IAAI,EACV,mBAAmB,EAAE,uBAAuB,GAC3C;IAAE,MAAM,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,CAwDhE;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE;IAAE,OAAO,EAAE;QAAE,SAAS,CAAC,EAAE,gBAAgB,GAAG;YAAE,MAAM,CAAC,EAAE,gBAAgB,CAAA;SAAE,CAAA;KAAE,CAAA;CAAE,EACnF,WAAW,EAAE,WAAW,EACxB,mBAAmB,EAAE,uBAAuB,GAC3C,IAAI,CAwCN"}
+{"version":3,"file":"sourceMaps.d.ts","sourceRoot":"","sources":["../../../src/vite/sourceMaps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,KAAK,yBAAyB,EAAsB,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAAE,KAAK,uBAAuB,EAAoB,MAAM,qBAAqB,CAAC;AACrF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AAEhF,iCAAiC;AACjC,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE7D;;GAEG;AACH,wBAAgB,eAAe,CAAC,aAAa,EAAE,uBAAuB,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CA8GxF;AASD;;;;GAIG;AAGH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,uBAAuB,EACtC,yBAAyB,CAAC,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC/D,uBAAuB,GAAG,yBAAyB,CAkFrD;AAeD,8BAA8B;AAC9B,wBAAgB,2BAA2B,CACzC,IAAI,EAAE;IAAE,OAAO,EAAE;QAAE,SAAS,CAAC,EAAE,gBAAgB,GAAG;YAAE,MAAM,CAAC,EAAE,gBAAgB,CAAC;YAAC,MAAM,CAAC,EAAE,gBAAgB,CAAA;SAAE,CAAA;KAAE,CAAA;CAAE,EAC9G,OAAO,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GACvC,gBAAgB,GAAG,SAAS,CAQ9B;AAED,iCAAiC;AACjC,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,IAAI,EACV,mBAAmB,EAAE,uBAAuB,GAC3C;IAAE,MAAM,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,CAyDhE;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE;IAAE,OAAO,EAAE;QAAE,SAAS,CAAC,EAAE,gBAAgB,GAAG;YAAE,MAAM,CAAC,EAAE,gBAAgB,CAAA;SAAE,CAAA;KAAE,CAAA;CAAE,EACnF,WAAW,EAAE,WAAW,EACxB,mBAAmB,EAAE,uBAAuB,GAC3C,IAAI,CAsCN"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentry/nuxt",
-  "version": "10.0.0",
+  "version": "10.2.0",
   "description": "Official Sentry SDK for Nuxt (EXPERIMENTAL)",
   "repository": "git://github.com/getsentry/sentry-javascript.git",
   "homepage": "https://github.com/getsentry/sentry-javascript/tree/master/packages/nuxt",
@@ -47,13 +47,13 @@
   },
   "dependencies": {
     "@nuxt/kit": "^3.13.2",
-    "@sentry/browser": "10.0.0",
-    "@sentry/cloudflare": "10.0.0",
-    "@sentry/core": "10.0.0",
-    "@sentry/node": "10.0.0",
-    "@sentry/rollup-plugin": "^4.0.0",
+    "@sentry/browser": "10.2.0",
+    "@sentry/cloudflare": "10.2.0",
+    "@sentry/core": "10.2.0",
+    "@sentry/node": "10.2.0",
+    "@sentry/rollup-plugin": "^4.0.2",
     "@sentry/vite-plugin": "^4.0.0",
-    "@sentry/vue": "10.0.0"
+    "@sentry/vue": "10.2.0"
   },
   "devDependencies": {
     "@nuxt/module-builder": "^0.8.4",