Use package entry points for conditional exports between cjs/esm (#1249)

Author: matux

examples/README.md

@@ -102,23 +102,35 @@ To test these examples with your local Rollbar.js build:
 
 ## Package Entry Points
 
-Rollbar.js provides different entry points for different environments:
-
-- **Main package**: `require('rollbar')` or `import Rollbar from 'rollbar'`
-  - Node.js: `src/server/rollbar.js`
-  - Browser (with bundler): `dist/rollbar.umd.min.js`
-
-- **Direct imports - Source files** (ES modules):
-  - `rollbar/src/server/rollbar.js` - Server-side source
-  - `rollbar/src/browser/rollbar.js` - Browser-side source
-  - `rollbar/src/react-native/rollbar.js` - React Native source
-
-- **Direct imports - Distribution files** (pre-built bundles):
-  - `rollbar/dist/rollbar.umd.js` - Universal (CommonJS/AMD/global)
-  - `rollbar/dist/rollbar.umd.min.js` - Universal minified
-  - `rollbar/dist/rollbar.js` - Vanilla (script tag only)
-  - `rollbar/dist/rollbar.min.js` - Vanilla minified
-  - `rollbar/dist/rollbar.snippet.js` - Async snippet loader
-  - `rollbar/dist/rollbar.named-amd.js` - AMD/RequireJS
-
-- **CDN**: `https://cdn.rollbar.com/rollbarjs/refs/tags/vVERSION/rollbar.min.js`
+Rollbar.js uses conditional exports to provide the right module format for each environment:
+
+### Automatic Resolution (Recommended)
+
+When you use `require('rollbar')` or `import Rollbar from 'rollbar'`, you automatically get:
+
+- **Node.js**:
+  - `import` → ES module (`src/server/rollbar.js`)
+  - `require()` → CommonJS wrapper (`src/server/rollbar.cjs`)
+- **Browsers/Bundlers**:
+  - `import` → ES module (`src/browser/rollbar.js`)
+  - `require()` → UMD bundle (`dist/rollbar.umd.min.js`)
+- **TypeScript**: Type definitions from `index.d.ts`
+
+### Direct Imports - Source Files (ES modules)
+
+- `rollbar/src/server/rollbar.js` - Server-side source
+- `rollbar/src/browser/rollbar.js` - Browser-side source
+- `rollbar/src/react-native/rollbar.js` - React Native source
+
+### Direct Imports - Distribution Files (Pre-built bundles)
+
+- `rollbar/dist/rollbar.umd.js` - Universal (CommonJS/AMD/global)
+- `rollbar/dist/rollbar.umd.min.js` - Universal minified
+- `rollbar/dist/rollbar.js` - Vanilla (script tag only)
+- `rollbar/dist/rollbar.min.js` - Vanilla minified
+- `rollbar/dist/rollbar.snippet.js` - Async snippet loader
+- `rollbar/dist/rollbar.named-amd.js` - AMD/RequireJS
+
+### CDN
+
+- `https://cdn.rollbar.com/rollbarjs/refs/tags/vVERSION/rollbar.min.js`

package.json

@@ -15,10 +15,24 @@
     "javascript"
   ],
   "license": "MIT",
-  "main": "src/server/rollbar.js",
+  "main": "src/server/rollbar.cjs",
   "browser": "dist/rollbar.umd.min.js",
   "module": "src/browser/rollbar.js",
   "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "node": {
+        "import": "./src/server/rollbar.js",
+        "require": "./src/server/rollbar.cjs"
+      },
+      "browser": {
+        "import": "./src/browser/rollbar.js",
+        "require": "./dist/rollbar.umd.min.js"
+      },
+      "default": "./dist/rollbar.umd.min.js"
+    }
+  },
   "dependencies": {
     "@rrweb/record": "^2.0.0-alpha.18",
     "async": "~3.2.3",

src/server/rollbar.cjs

@@ -0,0 +1,5 @@
+// CommonJS wrapper for ES module
+// This file provides CommonJS compatibility for Node.js users
+// who require() the rollbar package
+
+module.exports = require('./rollbar.js').default;