feat(node, bun, deno, cloudflare): Align portable exports across server SDKs (#25583)

The server SDKs export different sets of helpers from `@sentry/core` and
`@sentry/server-utils`, although the helpers work on each runtime. A
user who moves between runtimes, or follows docs written for another
one, finds a helper missing. Two of the gaps also hide default
integrations: Node and Bun add `awsIntegration` to their defaults, and
Deno adds `fastifyIntegration`, but they did not export them. A user who
sets `defaultIntegrations` could not add them back.

- Node and Bun now export `moduleMetadataIntegration`,
`instrumentPostgresJsSql`, `instrumentCreateReactAgent`,
`awsIntegration` and the `FlueOptions` type. `@sentry/aws-serverless`
and `@sentry/google-cloud-serverless` re-export the new Node values, as
the consistent exports check requires.
- Deno and Cloudflare now export `parameterize` and
`instrumentStateGraphCompile`, so all four runtimes export the same
LangGraph helpers.
- Bun and Cloudflare now export the `Log` and `LogSeverityLevel` types.
- Deno now exports `fastifyIntegration`.

Cloudflare's channel integrations (express, pg and so on) are separate
work, because they need a warning when the vite plugin is missing.

Fixes #25574
Fixes JS-3972

---------

Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

Author: isaacs

CHANGELOG.md

@@ -14,6 +14,15 @@ Work in this release was contributed by @faizansaiyed123, @itisrmk, @kunal649, @
 
   `ignoreStaticAssets` defaults to `true`, so workers no longer create spans for `GET` requests to common static assets such as `favicon.ico`, `robots.txt` or `*.js` files. To keep these spans, set `httpServerIntegration({ ignoreStaticAssets: false })`. Request spans also follow the client's tracing configuration by default, so the SDK does not start them when tracing is disabled. If `ignoreRequestBody` throws, the request no longer fails, and the SDK skips the body.
 
+- **feat(node, bun, deno, cloudflare): Align portable exports across server SDKs**
+
+  Node, Bun, Deno and Cloudflare now export the same helpers from `@sentry/core` and `@sentry/server-utils` where they work on that runtime:
+
+  - Node and Bun now export `moduleMetadataIntegration`, `instrumentPostgresJsSql`, `instrumentCreateReactAgent`, `awsIntegration` and the `FlueOptions` type. `awsIntegration` was already in their default integrations.
+  - Deno and Cloudflare now export `parameterize` and `instrumentStateGraphCompile`.
+  - Bun and Cloudflare now export the `Log` and `LogSeverityLevel` types.
+  - Deno now exports `fastifyIntegration`, which was already in its default integrations.
+
 ## 11.9.0
 
 ### Important Changes

dev-packages/cloudflare-integration-tests/suites/public-api/parameterize/index.ts

@@ -0,0 +1,15 @@
+import * as Sentry from '@sentry/cloudflare';
+
+interface Env {
+  SENTRY_DSN: string;
+}
+
+// A plain worker. The `@sentry/cloudflare/vite` plugin wraps it with `withSentry` at build time,
+// with the options from `instrument.server.ts`.
+export default {
+  async fetch(): Promise<Response> {
+    const userId = 42;
+    Sentry.captureMessage(Sentry.parameterize`User ${userId} logged in`);
+    return new Response('ok');
+  },
+} satisfies ExportedHandler<Env>;

dev-packages/cloudflare-integration-tests/suites/public-api/parameterize/instrument.server.ts

@@ -0,0 +1,5 @@
+import { defineCloudflareOptions } from '@sentry/cloudflare';
+
+export default defineCloudflareOptions((env: { SENTRY_DSN: string }) => ({
+  dsn: env.SENTRY_DSN,
+}));

dev-packages/cloudflare-integration-tests/suites/public-api/parameterize/test.ts

@@ -0,0 +1,15 @@
+import type { Event } from '@sentry/core';
+import { expect, it } from 'vitest';
+import { createRunner } from '../../../runner';
+
+it('parameterize from the public entry sends a message template and its values', async ({ signal }) => {
+  const runner = createRunner(__dirname)
+    .expect(envelope => {
+      const event = envelope[1]?.[0]?.[1] as Event;
+      expect(event.logentry).toEqual({ message: 'User %s logged in', params: [42] });
+    })
+    .start(signal);
+
+  await runner.makeRequest('get', '/');
+  await runner.completed();
+});

dev-packages/cloudflare-integration-tests/suites/public-api/parameterize/vite.config.mts

@@ -0,0 +1,7 @@
+import { cloudflare } from '@cloudflare/vite-plugin';
+import { sentryCloudflareVitePlugin } from '@sentry/cloudflare/vite';
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  plugins: [cloudflare(), sentryCloudflareVitePlugin()],
+});

dev-packages/cloudflare-integration-tests/suites/public-api/parameterize/wrangler.jsonc

@@ -0,0 +1,9 @@
+{
+  "$schema": "../../../node_modules/wrangler/config-schema.json",
+  "name": "cloudflare-public-api-parameterize",
+  // `main` points at the source entry. The Sentry Vite plugin builds from it, and the runner serves
+  // the built output.
+  "main": "index.ts",
+  "compatibility_date": "2025-06-17",
+  "compatibility_flags": ["nodejs_compat"],
+}

dev-packages/deno-integration-tests/suites/parameterize/test.ts

@@ -0,0 +1,25 @@
+// <reference lib="deno.ns" />
+
+import * as Sentry from '@sentry/deno';
+import { assertEquals } from 'https://deno.land/std@0.212.0/assert/assert_equals.ts';
+import { errorSink, resetGlobals, withTimeout } from '../../src/index.ts';
+
+Deno.test('parameterize from the public entry sends a message template and its values', async () => {
+  resetGlobals();
+  const sink = errorSink();
+
+  Sentry.init({
+    dsn: 'https://username@domain/123',
+    beforeSend: sink.beforeSend,
+  });
+
+  const userId = 42;
+  Sentry.captureMessage(Sentry.parameterize`User ${userId} logged in`);
+
+  const event = await withTimeout(
+    sink.waitFor(e => e.logentry?.message === 'User %s logged in'),
+    5_000,
+    'parameterized message event',
+  );
+  assertEquals(event.logentry, { message: 'User %s logged in', params: [42] });
+});

packages/astro/src/index.server.ts

@@ -13,6 +13,7 @@ export {
   addIntegration,
   amqplibIntegration,
   anthropicAIIntegration,
+  awsIntegration,
   // eslint-disable-next-line typescript/no-deprecated
   anrIntegration,
   googleGenAIIntegration,
@@ -102,6 +103,7 @@ export {
   langChainIntegration,
   langGraphIntegration,
   createFlueInstrumentation,
+  instrumentPostgresJsSql,
   mastraIntegration,
   piDurableIntegration,
   mcpServerIntegration,
@@ -177,6 +179,8 @@ export {
   instrumentLangChainEmbeddings,
   instrumentStateGraph,
   instrumentStateGraphCompile,
+  instrumentCreateReactAgent,
+  moduleMetadataIntegration,
   zodErrorsIntegration,
   profiler,
   logger,

packages/aws-serverless/src/index.ts

@@ -2,6 +2,7 @@ export {
   addEventProcessor,
   addBreadcrumb,
   addIntegration,
+  moduleMetadataIntegration,
   captureException,
   captureEvent,
   captureMessage,
@@ -71,6 +72,7 @@ export {
   mcpServerIntegration,
   SentryMastraExporter,
   createFlueInstrumentation,
+  instrumentPostgresJsSql,
   modulesIntegration,
   nodeRuntimeMetricsIntegration,
   type NodeRuntimeMetricsOptions,
@@ -159,6 +161,7 @@ export {
   instrumentGoogleGenAIClient,
   instrumentStateGraph,
   instrumentStateGraphCompile,
+  instrumentCreateReactAgent,
   zodErrorsIntegration,
   profiler,
   amqplibIntegration,

packages/bun/src/index.ts

@@ -10,6 +10,8 @@ export type {
   Exception,
   Session,
   SeverityLevel,
+  Log,
+  LogSeverityLevel,
   Span,
   StackFrame,
   Stacktrace,
@@ -25,6 +27,7 @@ export {
   addEventProcessor,
   addBreadcrumb,
   addIntegration,
+  moduleMetadataIntegration,
   captureException,
   captureEvent,
   captureMessage,
@@ -93,6 +96,7 @@ export {
   mcpServerIntegration,
   SentryMastraExporter,
   createFlueInstrumentation,
+  instrumentPostgresJsSql,
   modulesIntegration,
   contextLinesIntegration,
   nodeContextIntegration,
@@ -176,6 +180,8 @@ export {
   instrumentGoogleGenAIClient,
   instrumentStateGraph,
   instrumentStateGraphCompile,
+  instrumentCreateReactAgent,
+  awsIntegration,
   zodErrorsIntegration,
   profiler,
   amqplibIntegration,