fix(bundler-plugins): add README.md, LICENSE, lint, fix package links

Author: isaacs

.oxfmtrc.json

@@ -9,7 +9,9 @@
   "ignorePatterns": [
     "packages/browser/test/loader.js",
     "packages/replay-worker/examples/worker.min.js",
-    "dev-packages/browser-integration-tests/fixtures",
+    "dev-packages/browser-integration-tests/fixtures/**",
+    "dev-packages/bundler-plugin-integration-tests/fixtures/**",
+    "packages/bundler-plugins/test/core/fixtures/**",
     "**/test.ts-snapshots/**",
     "/.nx/cache",
     "/.nx/workspace-data"

.oxlintrc.json

@@ -38,6 +38,7 @@
     "test/manual/**",
     "types/**",
     "scripts/*.js",
-    "node_modules/**"
+    "node_modules/**",
+    "packages/bundler-plugins/test/core/fixtures/**"
   ]
 }

dev-packages/.oxlintrc.json

@@ -9,5 +9,6 @@
     "typescript/no-misused-spread": "off",
     "typescript/no-base-to-string": "off",
     "typescript/await-thenable": "off"
-  }
+  },
+  "ignorePatterns": ["bundler-plugin-integration-tests/fixtures/**"]
 }

dev-packages/bundler-plugin-integration-tests/setup.mjs

@@ -1,23 +1,21 @@
 /* eslint-disable no-console */
-import { promises as fs } from "fs";
-import { join } from "path";
-import { fileURLToPath } from "url";
-import { execSync } from "child_process";
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
 
-console.log("Installing all dependencies for fixtures...");
+console.log('Installing all dependencies for fixtures...');
 
-const __dirname = fileURLToPath(new URL(".", import.meta.url));
-const fixturesDir = join(__dirname, "fixtures");
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+const fixturesDir = join(__dirname, 'fixtures');
 const entries = await fs.readdir(fixturesDir, { withFileTypes: true });
 
 // Get all directories
-const directories = entries
-  .filter((entry) => entry.isDirectory())
-  .map((entry) => join(fixturesDir, entry.name));
+const directories = entries.filter(entry => entry.isDirectory()).map(entry => join(fixturesDir, entry.name));
 
 for (const dir of directories) {
   try {
-    const pkgString = await fs.readFile(join(dir, "package.json"), { encoding: "utf-8" });
+    const pkgString = await fs.readFile(join(dir, 'package.json'), { encoding: 'utf-8' });
     const packageJson = JSON.parse(pkgString);
     // If there are no dependencies, skip installation
     if (!packageJson.dependencies) {
@@ -27,10 +25,10 @@ for (const dir of directories) {
     continue;
   }
 
-  execSync("pnpm install --force", {
+  execSync('pnpm install --force', {
     cwd: dir,
-    stdio: "inherit",
+    stdio: 'inherit',
   });
 }
 
-console.log("All fixture dependencies installed successfully!");
+console.log('All fixture dependencies installed successfully!');

packages/bundler-plugins/LICENSE

@@ -0,0 +1,29 @@
+# MIT License
+
+Copyright (c) 2022-2026, Sentry
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+- Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+- Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+- Neither the name of the copyright holder nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

packages/bundler-plugins/README.md

@@ -0,0 +1,31 @@
+<p align="center">
+  <a href="https://sentry.io/?utm_source=github&utm_medium=logo" target="_blank">
+    <img src="https://sentry-brand.storage.googleapis.com/sentry-wordmark-dark-280x84.png" alt="Sentry" width="280" height="84">
+  </a>
+</p>
+
+# Sentry Bundler Plugins
+
+Core package containing the bundler-agnostic functionality used by the [bundler plugins](https://github.com/getsentry/sentry-javascript-bundler-plugins).
+
+Check out the individual packages for more information and examples:
+
+- [Rollup](https://www.npmjs.com/package/@sentry/rollup-plugin)
+- [Vite](https://www.npmjs.com/package/@sentry/vite-plugin)
+- [esbuild](https://www.npmjs.com/package/@sentry/esbuild-plugin)
+- [Webpack](https://www.npmjs.com/package/@sentry/webpack-plugin)
+
+### Features
+
+The Sentry bundler plugin package contains the following functionality:
+
+- Sourcemap upload
+- Release creation in Sentry
+- Automatic release name discovery (based on CI environment - Vercel, AWS, Heroku, CircleCI, or current Git SHA)
+- Automatically associate errors with releases (Release injection)
+
+### More information
+
+- [Sentry Documentation](https://docs.sentry.io/quickstart/)
+- [Sentry Discord](https://discord.gg/Ww9hbqr)
+- [Sentry Stackoverflow](http://stackoverflow.com/questions/tagged/sentry)

packages/bundler-plugins/package.json

@@ -2,8 +2,8 @@
   "name": "@sentry/bundler-plugins",
   "version": "5.3.0",
   "description": "Sentry Bundler Plugins",
-  "repository": "git://github.com/getsentry/sentry-javascript-bundler-plugins.git",
-  "homepage": "https://github.com/getsentry/sentry-javascript-bundler-plugins/tree/main/packages/bundler-plugins",
+  "repository": "git://github.com/getsentry/sentry-javascript.git",
+  "homepage": "https://github.com/getsentry/sentry-javascript/tree/main/packages/bundler-plugins",
   "author": "Sentry",
   "license": "MIT",
   "publishConfig": {

packages/bundler-plugins/rollup.config.mjs

@@ -1,60 +1,60 @@
-import packageJson from "./package.json" with { type: "json" };
-import modulePackage from "module";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
+import packageJson from './package.json' with { type: 'json' };
+import modulePackage from 'module';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const srcDir = path.resolve(__dirname, "src");
+const srcDir = path.resolve(__dirname, 'src');
 
 const external = [
   ...Object.keys(packageJson.dependencies || {}),
   ...modulePackage.builtinModules,
-  "webpack",
-  "rollup",
-  "vite",
+  'webpack',
+  'rollup',
+  'vite',
 ];
 
 export default {
-  platform: "node",
+  platform: 'node',
   input: [
-    "src/babel-plugin/index.ts",
-    "src/core/index.ts",
-    "src/rollup/index.ts",
-    "src/vite/index.ts",
-    "src/esbuild/index.ts",
-    "src/webpack/index.ts",
-    "src/webpack/webpack5.ts",
-    "src/webpack/component-annotation-transform.ts",
+    'src/babel-plugin/index.ts',
+    'src/core/index.ts',
+    'src/rollup/index.ts',
+    'src/vite/index.ts',
+    'src/esbuild/index.ts',
+    'src/webpack/index.ts',
+    'src/webpack/webpack5.ts',
+    'src/webpack/component-annotation-transform.ts',
   ],
   external,
   output: [
     {
-      dir: "./dist/esm",
-      format: "esm",
-      exports: "named",
+      dir: './dist/esm',
+      format: 'esm',
+      exports: 'named',
       sourcemap: true,
-      entryFileNames: (chunkInfo) => {
+      entryFileNames: chunkInfo => {
         if (chunkInfo.facadeModuleId) {
           const rel = path.relative(srcDir, chunkInfo.facadeModuleId);
-          return rel.replace(/\.ts$/, ".mjs");
+          return rel.replace(/\.ts$/, '.mjs');
         }
-        return "[name].mjs";
+        return '[name].mjs';
       },
-      chunkFileNames: "_chunks/[name]-[hash].mjs",
+      chunkFileNames: '_chunks/[name]-[hash].mjs',
     },
     {
-      dir: "./dist/cjs",
-      format: "cjs",
-      exports: "named",
+      dir: './dist/cjs',
+      format: 'cjs',
+      exports: 'named',
       sourcemap: true,
-      entryFileNames: (chunkInfo) => {
+      entryFileNames: chunkInfo => {
         if (chunkInfo.facadeModuleId) {
           const rel = path.relative(srcDir, chunkInfo.facadeModuleId);
-          return rel.replace(/\.ts$/, ".js");
+          return rel.replace(/\.ts$/, '.js');
         }
-        return "[name].js";
+        return '[name].js';
       },
-      chunkFileNames: "_chunks/[name]-[hash].js",
+      chunkFileNames: '_chunks/[name]-[hash].js',
     },
   ],
 };

packages/bundler-plugins/sentry-esbuild-debugid-injection-file.js

@@ -1,20 +1,20 @@
 try {
   let globalObject =
-    "undefined" != typeof window
+    'undefined' != typeof window
       ? window
-      : "undefined" != typeof global
+      : 'undefined' != typeof global
         ? global
-        : "undefined" != typeof globalThis
+        : 'undefined' != typeof globalThis
           ? global
-          : "undefined" != typeof self
+          : 'undefined' != typeof self
             ? self
             : {};
 
   let stack = new globalObject.Error().stack;
 
   if (stack) {
     globalObject._sentryDebugIds = globalObject._sentryDebugIds || {};
-    globalObject._sentryDebugIds[stack] = "__SENTRY_DEBUG_ID__";
-    globalObject._sentryDebugIdIdentifier = "sentry-dbid-__SENTRY_DEBUG_ID__";
+    globalObject._sentryDebugIds[stack] = '__SENTRY_DEBUG_ID__';
+    globalObject._sentryDebugIdIdentifier = 'sentry-dbid-__SENTRY_DEBUG_ID__';
   }
 } catch {}