Update bundler plugin documentation for V2 release (#6976)

Author: Luca Forstner

src/platform-includes/sourcemaps/overview/javascript.vue.mdx

@@ -15,12 +15,11 @@ yarn add @sentry/vite-plugin --dev
 
 ### Configuration
 
-Learn more about configuring the plugin in our [Sentry Vite Plugin documentation](https://github.com/getsentry/sentry-javascript-bundler-plugins/tree/main/packages/vite-plugin).
+Learn more about configuring the plugin in our [Sentry Vite Plugin documentation](https://www.npmjs.com/package/@sentry/vite-plugin).
 
 Example:
 
 ```javascript {filename:vite.config.js}
-import { fileURLToPath, URL } from "node:url";
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
 import { sentryVitePlugin } from "@sentry/vite-plugin";
@@ -40,25 +39,30 @@ export default defineConfig({
 
       // Auth tokens can be obtained from https://sentry.io/settings/account/api/auth-tokens/
       // and need `project:releases` and `org:read` scopes
-      authToken: process.env.SENTRY_AUTH_TOKEN,
+      authToken: env.SENTRY_AUTH_TOKEN,
 
       sourcemaps: {
         // Specify the directory containing build artifacts
-        assets: "./dist/**",
+        assets: "./**",
+        // Don't upload the source maps of dependencies
+        ignore: ["./node_modules/**"],
       },
 
+      // Helps troubleshooting - set to false to make plugin less noisy
+      debug: true,
+
       // Use the following option if you're on an SDK version lower than 7.47.0:
-      // include: "./dist",
+      // release: {
+      //   uploadLegacySourcemaps: {
+      //     include: ".",
+      //     ignore: ["node_modules"],
+      //   },
+      // },
 
       // Optionally uncomment the line below to override automatic release name detection
       // release: process.env.RELEASE,
     }),
   ],
-  resolve: {
-    alias: {
-      "@": fileURLToPath(new URL("./src", import.meta.url)),
-    },
-  },
 });
 ```
 

src/platform-includes/sourcemaps/primer/javascript.sveltekit.mdx

@@ -1,3 +1,3 @@
 `@sentry/sveltekit` will generate and upload source maps automatically, so that errors in Sentry will contain readable stack traces.
 
-The SvelteKit SDK uses the [Sentry Vite Plugin](https://github.com/getsentry/sentry-javascript-bundler-plugins/blob/main/packages/vite-plugin) to upload source maps. See the [Manual Configuration](../manual-setup/#configure-source-maps-upload) page and the Sentry [Webpack Vite documentation](https://github.com/getsentry/sentry-javascript-bundler-plugins/tree/main/packages/vite-plugin#configuration) for more details.
+The SvelteKit SDK uses the [Sentry Vite Plugin](https://www.npmjs.com/package/@sentry/vite-plugin) to upload source maps. See the [Manual Configuration](../manual-setup/#configure-source-maps-upload) page and the Sentry [Webpack Vite documentation](https://www.npmjs.com/package/@sentry/vite-plugin#options) for more details.

src/platform-includes/sourcemaps/upload/esbuild/javascript.mdx

@@ -12,17 +12,14 @@ yarn add @sentry/esbuild-plugin --dev
 
 ## Configure
 
-Learn more about configuring the plugin in our [Sentry esbuild Plugin documentation](https://github.com/getsentry/sentry-javascript-bundler-plugins/tree/main/packages/esbuild-plugin).
+Learn more about configuring the plugin in our [Sentry esbuild Plugin documentation](https://www.npmjs.com/package/@sentry/esbuild-plugin).
 
 Example:
 
 ```javascript {filename:esbuild.config.js}
 const { sentryEsbuildPlugin } = require("@sentry/esbuild-plugin");
 
 require("esbuild").build({
-  entryPoints: ["./src/index.js"],
-  outdir: "./dist",
-  bundle: true,
   sourcemap: true, // Source map generation must be turned on
   plugins: [
     // Put the Sentry esbuild plugin after all other plugins
@@ -32,15 +29,25 @@ require("esbuild").build({
 
       // Auth tokens can be obtained from https://sentry.io/settings/account/api/auth-tokens/
       // and need `project:releases` and `org:read` scopes
-      authToken: process.env.SENTRY_AUTH_TOKEN,
+      authToken: env.SENTRY_AUTH_TOKEN,
 
       sourcemaps: {
         // Specify the directory containing build artifacts
-        assets: "./dist/**",
+        assets: "./**",
+        // Don't upload the source maps of dependencies
+        ignore: ["./node_modules/**"],
       },
 
+      // Helps troubleshooting - set to false to make plugin less noisy
+      debug: true,
+
       // Use the following option if you're on an SDK version lower than 7.47.0:
-      // include: "./dist",
+      // release: {
+      //   uploadLegacySourcemaps: {
+      //     include: ".",
+      //     ignore: ["node_modules"],
+      //   },
+      // },
 
       // Optionally uncomment the line below to override automatic release name detection
       // release: process.env.RELEASE,

src/platform-includes/sourcemaps/upload/rollup/javascript.mdx

@@ -12,15 +12,14 @@ yarn add @sentry/rollup-plugin --dev
 
 ## Configuration
 
-Learn more about configuring the plugin in our [Sentry Rollup Plugin documentation](https://github.com/getsentry/sentry-javascript-bundler-plugins/tree/main/packages/rollup-plugin).
+Learn more about configuring the plugin in our [Sentry Rollup Plugin documentation](https://www.npmjs.com/package/@sentry/rollup-plugin).
 
 Example:
 
 ```javascript {filename:rollup.config.js}
 import { sentryRollupPlugin } from "@sentry/rollup-plugin";
 
 export default {
-  input: "./src/index.js",
   plugins: [
     // Put the Sentry rollup plugin after all other plugins
     sentryRollupPlugin({
@@ -29,23 +28,32 @@ export default {
 
       // Auth tokens can be obtained from https://sentry.io/settings/account/api/auth-tokens/
       // and need `project:releases` and `org:read` scopes
-      authToken: process.env.SENTRY_AUTH_TOKEN,
+      authToken: env.SENTRY_AUTH_TOKEN,
 
       sourcemaps: {
         // Specify the directory containing build artifacts
-        assets: "./out/**",
+        assets: "./**",
+        // Don't upload the source maps of dependencies
+        ignore: ["./node_modules/**"],
       },
 
+      // Helps troubleshooting - set to false to make plugin less noisy
+      debug: true,
+
       // Use the following option if you're on an SDK version lower than 7.47.0:
-      // include: "./out",
+      // release: {
+      //   uploadLegacySourcemaps: {
+      //     include: ".",
+      //     ignore: ["node_modules"],
+      //   },
+      // },
 
       // Optionally uncomment the line below to override automatic release name detection
       // release: process.env.RELEASE,
     }),
   ],
   output: {
     sourcemap: true, // Source map generation must be turned on
-    dir: "./out",
   },
 };
 ```

src/platform-includes/sourcemaps/upload/vite/javascript.mdx

@@ -12,7 +12,7 @@ yarn add @sentry/vite-plugin --dev
 
 ## Configuration
 
-Learn more about configuring the plugin in our [Sentry Vite Plugin documentation](https://github.com/getsentry/sentry-javascript-bundler-plugins/tree/main/packages/vite-plugin).
+Learn more about configuring the plugin in our [Sentry Vite Plugin documentation](https://www.npmjs.com/package/@sentry/vite-plugin).
 
 Example:
 
@@ -40,11 +40,21 @@ export default defineConfig(({ command, mode }) => {
 
         sourcemaps: {
           // Specify the directory containing build artifacts
-          assets: "./dist/**",
+          assets: "./**",
+          // Don't upload the source maps of dependencies
+          ignore: ["./node_modules/**"],
         },
 
+        // Helps troubleshooting - set to false to make plugin less noisy
+        debug: true,
+
         // Use the following option if you're on an SDK version lower than 7.47.0:
-        // include: "./dist",
+        // release: {
+        //   uploadLegacySourcemaps: {
+        //     include: ".",
+        //     ignore: ["node_modules"],
+        //   },
+        // },
 
         // Optionally uncomment the line below to override automatic release name detection
         // release: env.RELEASE,

src/platform-includes/sourcemaps/upload/webpack/javascript.mdx

@@ -1,43 +1,65 @@
-Sentry uses [releases](/product/releases/) to match the correct source maps to your events.
 You can use the Sentry Webpack plugin to automatically create releases and upload source maps to Sentry when bundling your app.
 
+<Note>
+
+This guide for the Sentry Webpack plugin is for version `2.x` of the plugin.
+If you are using version `1.x` of `@sentry/webpack-plugin` please see the migration guide on how to update:
+https://github.com/getsentry/sentry-javascript-bundler-plugins/blob/main/MIGRATION.md
+
+</Note>
+
 ## Installation
 
-```shell {tabTitle:npm}
-npm install --save-dev @sentry/webpack-plugin
+```bash {tabTitle:npm}
+npm install @sentry/webpack-plugin --save-dev
 ```
 
-```shell {tabTitle:Yarn}
-yarn add --dev @sentry/webpack-plugin
+```bash {tabTitle:Yarn}
+yarn add @sentry/webpack-plugin --dev
 ```
 
 ## Configuration
 
-Learn more about configuring the plugin in our [Sentry Webpack Plugin documentation](https://github.com/getsentry/sentry-webpack-plugin).
+Learn more about configuring the plugin in our [Sentry Webpack Plugin documentation](https://www.npmjs.com/package/@sentry/webpack-plugin).
 
 Example:
 
 <PlatformSection notSupported={["javascript.gatsby"]}>
 
 ```javascript {filename:webpack.config.js}
-const SentryWebpackPlugin = require("@sentry/webpack-plugin");
+const { sentryWebpackPlugin } = require("@sentry/webpack-plugin");
 
 module.exports = {
   // ... other config above ...
 
   devtool: "source-map", // Source map generation must be turned on
   plugins: [
-    new SentryWebpackPlugin({
+    sentryWebpackPlugin({
       org: "___ORG_SLUG___",
       project: "___PROJECT_SLUG___",
 
-      // Specify the directory containing build artifacts
-      include: "./dist",
-
       // Auth tokens can be obtained from https://sentry.io/settings/account/api/auth-tokens/
-      // and needs the `project:releases` and `org:read` scopes
+      // and need `project:releases` and `org:read` scopes
       authToken: process.env.SENTRY_AUTH_TOKEN,
 
+      sourcemaps: {
+        // Specify the directory containing build artifacts
+        assets: "./**",
+        // Don't upload the source maps of dependencies
+        ignore: ["./node_modules/**"],
+      },
+
+      // Helps troubleshooting - set to false to make plugin less noisy
+      debug: true,
+
+      // Use the following option if you're on an SDK version lower than 7.47.0:
+      // release: {
+      //   uploadLegacySourcemaps: {
+      //     include: ".",
+      //     ignore: ["node_modules"],
+      //   },
+      // },
+
       // Optionally uncomment the line below to override automatic release name detection
       // release: process.env.RELEASE,
     }),
@@ -50,24 +72,32 @@ module.exports = {
 <PlatformSection supported={["javascript.gatsby"]}>
 
 ```javascript {filename:gatsby-node.js}
-const SentryWebpackPlugin = require("@sentry/webpack-plugin");
+const { sentryWebpackPlugin } = require("@sentry/webpack-plugin");
 
 exports.onCreateWebpackConfig = ({ actions }) => {
   actions.setWebpackConfig({
     plugins: [
-      new SentryWebpackPlugin({
+      sentryWebpackPlugin({
         org: "___ORG_SLUG___",
         project: "___PROJECT_SLUG___",
 
-        ignore: ["app-*", "polyfill-*", "framework-*", "webpack-runtime-*"],
-
-        // Specify the directory containing build artifacts
-        include: "public",
-
         // Auth tokens can be obtained from https://sentry.io/settings/account/api/auth-tokens/
-        // and needs the `project:releases` and `org:read` scopes
+        // and need `project:releases` and `org:read` scopes
         authToken: process.env.SENTRY_AUTH_TOKEN,
 
+        sourcemaps: {
+          // Specify the directory containing build artifacts
+          assets: "./**",
+          // Don't upload the source maps of dependencies
+          ignore: ["./node_modules/**"],
+        },
+
+        // Helps troubleshooting - set to false to make plugin less noisy
+        debug: true,
+
+        // Use the following option if you're on an SDK version lower than 7.47.0:
+        // include: "./dist",
+
         // Optionally uncomment the line below to override automatic release name detection
         // release: process.env.RELEASE,
       }),
@@ -83,16 +113,3 @@ exports.onCreateWebpackConfig = ({ actions }) => {
 If you use [SourceMapDevToolPlugin](https://webpack.js.org/plugins/source-map-dev-tool-plugin) for more fine-grained control of source map generation, turn off `noSources` so Sentry can display proper source code context in event stack traces.
 
 </Note>
-
-The Sentry Webpack plugin will automatically inject a release value into the SDK so you must either omit the `release` option from `Sentry.init` or make sure `Sentry.init`'s `release` option matches the plugin's `release` option exactly:
-
-```javascript
-Sentry.init({
-  dsn: "___PUBLIC_DSN___",
-
-  // When using the plugin, either remove the `release`` property here entirely or
-  // make sure that the plugin's release option and the Sentry.init()'s release
-  // option match exactly.
-  // release: "my-example-release-1"
-});
-```

src/platforms/javascript/guides/sveltekit/manual-setup.mdx

@@ -185,7 +185,7 @@ The `sentrySvelteKit()` function adds Vite plugins to your Vite config to:
 
 ## Configure Source Maps Upload
 
-By default, `sentrySvelteKit()` will add an instance of the [Sentry Vite Plugin](https://github.com/getsentry/sentry-javascript-bundler-plugins/tree/main/packages/vite-plugin#sentry-vite-plugin), to upload source maps for both server and client builds. This means that when you run a production build (`npm run build`), source maps will be generated and uploaded to Sentry, so that you get readable stack traces in your Sentry issues.
+By default, `sentrySvelteKit()` will add an instance of the [Sentry Vite Plugin](https://www.npmjs.com/package/@sentry/vite-plugin), to upload source maps for both server and client builds. This means that when you run a production build (`npm run build`), source maps will be generated and uploaded to Sentry, so that you get readable stack traces in your Sentry issues.
 
 However, you still need to specify your Sentry auth token as well as your org and project slugs. There are two ways to set them.
 
@@ -196,7 +196,7 @@ You can set them as environment variables, for example in a `.env` file:
 - `SENTRY_AUTH_TOKEN` your Sentry auth token
 - `SENTRY_URL` your Sentry instance URL. This is only required if you use your own Sentry instance (as opposed to `https://sentry.io`).
 
-Or, you can set them by passing a `sourceMapsUploadOptions` object to `sentrySvelteKit`, as seen in the example below. All available options are documented at [the Sentry Vite plugin repo](https://github.com/getsentry/sentry-javascript-bundler-plugins/tree/main/packages/vite-plugin#configuration).
+Or, you can set them by passing a `sourceMapsUploadOptions` object to `sentrySvelteKit`, as seen in the example below. All available options are documented at [the Sentry Vite plugin repo](https://www.npmjs.com/package/@sentry/vite-plugin#options).
 
 ```javascript {filename:vite.config.js}
 import { sveltekit } from '@sveltejs/kit/vite';