feat(cloudflare): Add @sentry/cloudflare/vite orchestrion plugin

Exposes a Sentry Vite plugin for Cloudflare Workers that wraps the
orchestrion plugin from @sentry/server-utils. It injects diagnostics
channels into bundled npm packages (e.g. `mysql`) at build time, so the
SDK can trace them without monkey-patching - which wouldn't work in
workerd anyway, since there is no require hook to intercept module
loading.

It also injects a generated registration module into the bundle
(`registerIntegrations: true`), which registers the matching
channel-subscriber integrations on the global orchestrion marker for
`Sentry.init` to pick up.

The subpath is published ESM-only because
`@sentry/server-utils/orchestrion/vite` exposes no `require`
condition; Vite configs are ESM anyway.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: JPeer264

packages/cloudflare/package.json

@@ -46,6 +46,10 @@
         "types": "./build/types/nodejs_compat/index.d.ts",
         "default": "./build/cjs/nodejs_compat/index.js"
       }
+    },
+    "./vite": {
+      "types": "./build/types/vite/index.d.ts",
+      "import": "./build/esm/vite/index.js"
     }
   },
   "typesVersions": {

packages/cloudflare/rollup.npm.config.mjs

@@ -2,6 +2,6 @@ import { makeBaseNPMConfig, makeNPMConfigVariants } from '@sentry-internal/rollu
 
 export default makeNPMConfigVariants(
   makeBaseNPMConfig({
-    entrypoints: ['src/index.ts', 'src/nodejs_compat/index.ts'],
+    entrypoints: ['src/index.ts', 'src/nodejs_compat/index.ts', 'src/vite/index.ts'],
   }),
 );

packages/cloudflare/src/vite/index.ts

@@ -0,0 +1,52 @@
+// Published ESM-only via the `@sentry/cloudflare/vite` subpath export:
+// `@sentry/server-utils/orchestrion/vite` exposes no `require` condition, so a
+// CJS entry here would fail at resolution time (ERR_PACKAGE_PATH_NOT_EXPORTED).
+// The CJS rollup variant still emits this file, but `package.json` doesn't
+// expose it — same setup as `@sentry/server-utils/orchestrion/vite` itself.
+import { sentryOrchestrionPlugin } from '@sentry/server-utils/orchestrion/vite';
+
+/**
+ * Sentry Vite plugin for Cloudflare Workers.
+ *
+ * Injects `diagnostics_channel.tracingChannel` calls into bundled npm packages
+ * (e.g. `mysql`) at build time via orchestrion, so the SDK can trace them
+ * without monkey-patching, which wouldn't work in workerd anyway.
+ *
+ * It also injects a generated registration module into the bundle, which
+ * registers the matching channel-subscriber integrations for `Sentry.init` to
+ * pick up. The SDK itself doesn't import them, so workers built without this
+ * plugin don't ship that code; the worker only needs the usual
+ * `Sentry.withSentry` wrapping.
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { cloudflare } from '@cloudflare/vite-plugin';
+ * import { sentryCloudflareVitePlugin } from '@sentry/cloudflare/vite';
+ *
+ * export default {
+ *   plugins: [
+ *     sentryCloudflareVitePlugin(),
+ *     cloudflare(),
+ *   ],
+ * };
+ *
+ * // src/index.ts (worker entry)
+ * import * as Sentry from '@sentry/cloudflare';
+ *
+ * export default Sentry.withSentry(
+ *   env => ({
+ *     dsn: env.SENTRY_DSN,
+ *     tracesSampleRate: 1.0,
+ *   }),
+ *   {
+ *     async fetch(request, env, ctx) {
+ *       // ...
+ *     },
+ *   } satisfies ExportedHandler,
+ * );
+ * ```
+ */
+export function sentryCloudflareVitePlugin() {
+  return sentryOrchestrionPlugin({ registerIntegrations: true });
+}

packages/server-utils/test/orchestrion/vite-plugin.test.ts

@@ -0,0 +1,31 @@
+import { describe, expect, it } from 'vitest';
+import { sentryOrchestrionPlugin } from '../../src/orchestrion/bundler/vite';
+import { INSTRUMENTED_MODULE_NAMES } from '../../src/orchestrion/config';
+
+function getMarkerPlugin() {
+  const plugins = sentryOrchestrionPlugin();
+  const marker = plugins.find(p => p.name === 'sentry-orchestrion-marker');
+  expect(marker).toBeDefined();
+  return marker;
+}
+
+describe('sentryOrchestrionPlugin', () => {
+  it('returns the marker plugin and the code transformer', () => {
+    const plugins = sentryOrchestrionPlugin();
+    expect(plugins.map(p => p.name)).toContain('sentry-orchestrion-marker');
+    expect(plugins.map(p => p.name)).toContain('code-transformer');
+  });
+
+  it('force-bundles instrumented packages via ssr.noExternal', () => {
+    const marker = getMarkerPlugin();
+    expect(marker.config()).toEqual({ ssr: { noExternal: INSTRUMENTED_MODULE_NAMES } });
+  });
+
+  it('prepends the bundler marker banner to entry chunks', () => {
+    const marker = getMarkerPlugin();
+    const result = marker.renderChunk('console.log("app");', { isEntry: true });
+    expect(result.code).toContain('globalThis.__SENTRY_ORCHESTRION__.bundler = true;');
+    expect(result.map).toBeDefined();
+    expect(marker.renderChunk('console.log("chunk");', { isEntry: false })).toBeNull();
+  });
+});