Skip to content

feat(core): split exports by browser/server for bundle size#20435

Open
isaacs wants to merge 4 commits intodevelopfrom
isaacschlueter/split-server-browser-core-exports
Open

feat(core): split exports by browser/server for bundle size#20435
isaacs wants to merge 4 commits intodevelopfrom
isaacschlueter/split-server-browser-core-exports

Conversation

@isaacs
Copy link
Copy Markdown
Member

@isaacs isaacs commented Apr 21, 2026

Note: stacked atop #20393, only the top commit needs review. Land that before this one.

Split the exports from @sentry/core into three options:

  • @sentry/core, the default (unchanged)
  • @sentry/core/browser, containing only shared and browser-specific
    functionality, nothing server-specific.
  • @sentry/core/server, containing only shared and server-specific
    functionality, nothing browser-specific.

This allows us to make the bundle sizes quite a bit smaller in our
browser SDKs where this is important, while adding more functionality to
our server-specific SDKs, in @sentry/core where they can be easily
shared across runtimes.

fix: #20434
fix: JS-2243

@linear-code
Copy link
Copy Markdown

linear-code Bot commented Apr 21, 2026

@isaacs isaacs force-pushed the isaacschlueter/split-server-browser-core-exports branch 6 times, most recently from 143a2a5 to 1494709 Compare April 22, 2026 01:45
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 22, 2026

size-limit report 📦

Path Size % Change Change
@sentry/browser 26.16 kB - -
@sentry/browser - with treeshaking flags 24.63 kB - -
@sentry/browser (incl. Tracing) 44.13 kB - -
@sentry/browser (incl. Tracing + Span Streaming) 46.34 kB - -
@sentry/browser (incl. Tracing, Profiling) 49.08 kB - -
@sentry/browser (incl. Tracing, Replay) 83.48 kB - -
@sentry/browser (incl. Tracing, Replay) - with treeshaking flags 72.96 kB - -
@sentry/browser (incl. Tracing, Replay with Canvas) 88.15 kB - -
@sentry/browser (incl. Tracing, Replay, Feedback) 100.8 kB - -
@sentry/browser (incl. Feedback) 43.4 kB - -
@sentry/browser (incl. sendFeedback) 30.96 kB - -
@sentry/browser (incl. FeedbackAsync) 36.14 kB - -
@sentry/browser (incl. Metrics) 27.44 kB - -
@sentry/browser (incl. Logs) 27.59 kB - -
@sentry/browser (incl. Metrics & Logs) 28.28 kB - -
@sentry/react 27.9 kB - -
@sentry/react (incl. Tracing) 46.36 kB - -
@sentry/vue 31.03 kB - -
@sentry/vue (incl. Tracing) 45.96 kB - -
@sentry/svelte 26.18 kB - -
CDN Bundle 28.85 kB +0.03% +7 B 🔺
CDN Bundle (incl. Tracing) 46.91 kB -0.01% -1 B 🔽
CDN Bundle (incl. Logs, Metrics) 30.27 kB -0.02% -6 B 🔽
CDN Bundle (incl. Tracing, Logs, Metrics) 48.03 kB +0.01% +4 B 🔺
CDN Bundle (incl. Replay, Logs, Metrics) 69.35 kB -0.01% -3 B 🔽
CDN Bundle (incl. Tracing, Replay) 84.07 kB +0.01% +1 B 🔺
CDN Bundle (incl. Tracing, Replay, Logs, Metrics) 85.14 kB -0.01% -1 B 🔽
CDN Bundle (incl. Tracing, Replay, Feedback) 89.86 kB +0.01% +1 B 🔺
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics) 90.96 kB -0.01% -2 B 🔽
CDN Bundle - uncompressed 84.55 kB - -
CDN Bundle (incl. Tracing) - uncompressed 140.16 kB - -
CDN Bundle (incl. Logs, Metrics) - uncompressed 88.75 kB - -
CDN Bundle (incl. Tracing, Logs, Metrics) - uncompressed 143.62 kB - -
CDN Bundle (incl. Replay, Logs, Metrics) - uncompressed 212.71 kB - -
CDN Bundle (incl. Tracing, Replay) - uncompressed 257.96 kB - -
CDN Bundle (incl. Tracing, Replay, Logs, Metrics) - uncompressed 261.41 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback) - uncompressed 271.66 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics) - uncompressed 275.1 kB - -
@sentry/nextjs (client) 48.85 kB - -
@sentry/sveltekit (client) 44.58 kB - -
@sentry/node-core 59.66 kB +1.04% +611 B 🔺
@sentry/node 162.89 kB -4.38% -7.45 kB 🔽
@sentry/node - without tracing 71.83 kB -25.89% -25.09 kB 🔽
@sentry/aws-serverless 106.5 kB -6.38% -7.25 kB 🔽
@sentry/cloudflare (withSentry) - minified 164.97 kB +0.01% +4 B 🔺
@sentry/cloudflare (withSentry) 417.12 kB +0.01% +21 B 🔺

View base workflow run

@isaacs isaacs force-pushed the isaacschlueter/split-server-browser-core-exports branch 5 times, most recently from d5dddbf to 8eba1e9 Compare April 22, 2026 18:26
@isaacs isaacs marked this pull request as ready for review April 22, 2026 18:26
Comment thread dev-packages/rollup-utils/utils.mjs Outdated
@isaacs isaacs force-pushed the isaacschlueter/split-server-browser-core-exports branch from 8eba1e9 to 8ea4f5c Compare April 22, 2026 18:50
Comment thread dev-packages/rollup-utils/npmHelpers.mjs
@isaacs isaacs force-pushed the isaacschlueter/split-server-browser-core-exports branch from 8ea4f5c to 787f44b Compare April 22, 2026 19:19
@isaacs isaacs enabled auto-merge (rebase) April 22, 2026 19:19
@isaacs isaacs disabled auto-merge April 22, 2026 19:19
isaacs added a commit that referenced this pull request Apr 22, 2026
Split the exports from `@sentry/core` into three options:

- `@sentry/core`, the default (unchanged)
- `@sentry/core/browser`, containing _only_ shared and browser-specific
  functionality, nothing server-specific.
- `@sentry/core/server`, containing _only_ shared and server-specific
  functionality, nothing browser-specific.

This should allow us to make the bundle sizes quite a bit smaller in our
browser SDKs where this is important, while adding more functionality to
our server-specific SDKs, in `@sentry/core` where they can be easily
shared across runtimes.

Integration may require updating our `tsconfig` settings so that tsc
knows it is allowed to look on `package.json` exports.

fix: #20434
fix: JS-2243
@isaacs isaacs force-pushed the isaacschlueter/split-server-browser-core-exports branch from 787f44b to 7076f7c Compare April 22, 2026 19:20
Comment thread packages/core/src/shared-exports.ts
Comment thread packages/core/src/integrations/http/client-subscriptions.ts
@isaacs isaacs requested review from mydea and timfish April 23, 2026 14:24
isaacs added a commit that referenced this pull request Apr 23, 2026
Split the exports from `@sentry/core` into three options:

- `@sentry/core`, the default (unchanged)
- `@sentry/core/browser`, containing _only_ shared and browser-specific
  functionality, nothing server-specific.
- `@sentry/core/server`, containing _only_ shared and server-specific
  functionality, nothing browser-specific.

This should allow us to make the bundle sizes quite a bit smaller in our
browser SDKs where this is important, while adding more functionality to
our server-specific SDKs, in `@sentry/core` where they can be easily
shared across runtimes.

Integration may require updating our `tsconfig` settings so that tsc
knows it is allowed to look on `package.json` exports.

fix: #20434
fix: JS-2243
@isaacs isaacs force-pushed the isaacschlueter/split-server-browser-core-exports branch from 7076f7c to e2cf052 Compare April 23, 2026 14:34
isaacs added a commit that referenced this pull request Apr 23, 2026
Split the exports from `@sentry/core` into three options:

- `@sentry/core`, the default (unchanged)
- `@sentry/core/browser`, containing _only_ shared and browser-specific
  functionality, nothing server-specific.
- `@sentry/core/server`, containing _only_ shared and server-specific
  functionality, nothing browser-specific.

This should allow us to make the bundle sizes quite a bit smaller in our
browser SDKs where this is important, while adding more functionality to
our server-specific SDKs, in `@sentry/core` where they can be easily
shared across runtimes.

Integration may require updating our `tsconfig` settings so that tsc
knows it is allowed to look on `package.json` exports.

fix: #20434
fix: JS-2243
@isaacs isaacs force-pushed the isaacschlueter/split-server-browser-core-exports branch from e2cf052 to 67bf5c4 Compare April 23, 2026 14:41
Comment thread packages/core/src/integrations/http/client-subscriptions.ts
Comment thread packages/core/src/integrations/http/client-subscriptions.ts
Copy link
Copy Markdown
Collaborator

@timfish timfish left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I looked through most of the changed files.

I guess this doesn't deprecate the old root exports yet?

expect.objectContaining({
data: expect.objectContaining({
'sentry.op': 'http.client',
'sentry.origin': 'auto.http.otel.http',
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

these seem like unrelated changes, a different PR leaking into this? 😅

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, this is based on #20393, but I think I'm going to reverse things and put this first, unless we can land that PR soon-ish.

"include": ["src/**/*"],

"compilerOptions": {
"module": "esnext",
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is this related to this change/required here?

"include": ["src/**/*", "test/loader.js"],

"compilerOptions": {
"module": "esnext",
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is this required for this change here?


const getExpressExport = (express: ExpressModuleExport): ExpressExport =>
hasDefaultProp(express) ? express.default : (express as ExpressExport);
import { getDefaultExport } from '../../utils/get-default-export';
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

also likely leaked in from another PR?

isaacs added a commit that referenced this pull request Apr 29, 2026
Split the exports from `@sentry/core` into three options:

- `@sentry/core`, the default (unchanged)
- `@sentry/core/browser`, containing _only_ shared and browser-specific
  functionality, nothing server-specific.
- `@sentry/core/server`, containing _only_ shared and server-specific
  functionality, nothing browser-specific.

This should allow us to make the bundle sizes quite a bit smaller in our
browser SDKs where this is important, while adding more functionality to
our server-specific SDKs in `@sentry/core`, where they can more easily
be shared across runtimes.

Some integration requires updating `tsconfig` settings so that tsc knows
it is allowed to look up `package.json` exports.

fix: #20434
fix: JS-2243
@isaacs isaacs force-pushed the isaacschlueter/split-server-browser-core-exports branch from 67bf5c4 to 2cf15db Compare April 29, 2026 16:41
@isaacs isaacs requested review from a team as code owners April 29, 2026 16:41
isaacs added 3 commits April 29, 2026 09:42
This was implemented for the portable Express integration, but others
will need the same functionality, so make it a reusable util.
Refactor the `node:http` outgoing request instrumentation so that it can
be applied to non-Node.js environments by patching the http module.

Also, refactor so that the diagnostics_channel and monkeypatching paths
can share code, and so that light and normal node-core instrumentations
can share more of the functionality as well.

To facilitate this, some portable minimal types are vendored in from the
`node:http` module.
isaacs added a commit that referenced this pull request Apr 29, 2026
Split the exports from `@sentry/core` into three options:

- `@sentry/core`, the default (unchanged)
- `@sentry/core/browser`, containing _only_ shared and browser-specific
  functionality, nothing server-specific.
- `@sentry/core/server`, containing _only_ shared and server-specific
  functionality, nothing browser-specific.

This should allow us to make the bundle sizes quite a bit smaller in our
browser SDKs where this is important, while adding more functionality to
our server-specific SDKs in `@sentry/core`, where they can more easily
be shared across runtimes.

Some integration requires updating `tsconfig` settings so that tsc knows
it is allowed to look up `package.json` exports.

fix: #20434
fix: JS-2243
@isaacs isaacs force-pushed the isaacschlueter/split-server-browser-core-exports branch from 2cf15db to c1c9cf0 Compare April 29, 2026 16:46
Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 2 potential issues.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit c1c9cf0. Configure here.

export const patchHttpsModuleClient = (
httpModuleExport: HttpModuleExport,
options: HttpInstrumentationOptions = {},
): HttpModuleExport => patchModule(httpModuleExport, options);
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Misleading docs and redundant identical exported functions

Low Severity

patchHttpsModuleClient is documented as setting "default protocol/port for HTTPS when option objects are passed," but its implementation is byte-for-byte identical to patchHttpModuleClient — both just call patchModule(httpModuleExport, options). The JSDoc promises behavior that doesn't exist. Having two identical exported functions with different names and misleading documentation adds unnecessary confusion. This was flagged because it was mentioned in this rules file (redundant code check).

Additional Locations (1)
Fix in Cursor Fix in Web

Triggered by project rule: PR Review Guidelines for Cursor Bot

Reviewed by Cursor Bugbot for commit c1c9cf0. Configure here.

const baseFn = toFilterFunction(base);
const specificFn = toFilterFunction(specific);
return id => baseFn(id) || specificFn(id);
}
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

mergeExternals drops Rollup's extra function arguments

Low Severity

mergeExternals returns id => baseFn(id) || specificFn(id), which only forwards the first argument (id) to the underlying functions. Rollup calls external with (id, parentId, isResolved). If any package-specific config provides an external function that uses parentId or isResolved, those arguments are silently dropped. The merged function could instead forward all arguments with a rest parameter.

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit c1c9cf0. Configure here.

Split the exports from `@sentry/core` into three options:

- `@sentry/core`, the default (unchanged)
- `@sentry/core/browser`, containing _only_ shared and browser-specific
  functionality, nothing server-specific.
- `@sentry/core/server`, containing _only_ shared and server-specific
  functionality, nothing browser-specific.

This should allow us to make the bundle sizes quite a bit smaller in our
browser SDKs where this is important, while adding more functionality to
our server-specific SDKs in `@sentry/core`, where they can more easily
be shared across runtimes.

Some integration requires updating `tsconfig` settings so that tsc knows
it is allowed to look up `package.json` exports.

fix: #20434
fix: JS-2243
@isaacs isaacs force-pushed the isaacschlueter/split-server-browser-core-exports branch from c1c9cf0 to 5beb2e3 Compare April 29, 2026 17:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Split @sentry/core exports up, adding ./server and ./browser exports

3 participants