@sentry/cloudflare 10.71.0 → 10.73.0

package/build/types/vite/bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindings.d.ts","sourceRoot":"","sources":["../../../src/vite/bindings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,sFAAsF;AACtF,eAAO,MAAM,cAAc,eAA0B,CAAC;AAEtD,wGAAwG;AACxG,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,cAAc,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,UAAU,CAAC;CACvB"}

package/build/types/vite/index.d.ts

@@ -40,6 +40,10 @@ export interface SentryCloudflareVitePluginOptions {
          * Durable Object class with `instrumentDurableObjectWithSentry`. Both
          * `vite build` and `vite dev` are instrumented.
          *
+         * The plugin also adds the bindings that resolve to the wrapped classes (this worker's own
+         * Durable Objects and self service bindings) to `rpcTracePropagationBindings`. Bindings to
+         * other workers stay opt-in, their receivers may not run Sentry.
+         *
          * @default false
          * @experimental May change or be removed in any release.
          */

package/build/types/vite/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/vite/index.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD;;;;;;;;;OASG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;OAEG;IACH,aAAa,CAAC,EAAE;QACd;;;;;;;;;;;;;WAaG;QACH,8BAA8B,CAAC,EAAE,OAAO,CAAC;QACzC;;;;;;;;;;WAUG;QACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC/B,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,iCAAsC;;;;cA5DlF,CAAC;;;;;YAiCgE,CAAC;mBAChD,CAAC;gBAAS,CAAA;;;;;;kCAmCnC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/vite/index.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD;;;;;;;;;OASG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;OAEG;IACH,aAAa,CAAC,EAAE;QACd;;;;;;;;;;;;;WAaG;QACH,8BAA8B,CAAC,EAAE,OAAO,CAAC;QACzC;;;;;;;;;;;;;;WAcG;QACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC/B,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,iCAAsC;;;;cAhElF,CAAC;;;;;YA2BmC,CAAC;mBAEtC,CAAC;gBAAQ,CAAC;;;;;;kCA4ChB"}

package/build/types/vite/transform.d.ts

@@ -1,4 +1,5 @@
 import MagicString from 'magic-string';
+import { type SameWorkerBinding } from './bindings';
 export interface BaseNode {
     type: string;
     start: number;
@@ -34,6 +35,8 @@ export interface TransformContext {
     optionsFn: string;
     /** Import statement prepended when `optionsFn` references a separate module. */
     optionsImport?: string;
+    /** @see {@link import('./wranglerConfig').WranglerConfig.sameWorkerBindings} */
+    sameWorkerBindings?: readonly SameWorkerBinding[];
 }
 export interface TransformResult {
     code: string;

package/build/types/vite/transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/vite/transform.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,cAAc,CAAC;AAOvC,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,EAAE,CAAC;CAClB;AAuDD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG,OAAO,GAAG,UAAU,GAAG,kBAAkB,CAAC;AAc3F,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC7C;;;OAGG;IACH,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC;IAC5C;;;;OAIG;IACH,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,gBAAgB,GACpB,eAAe,GAAG,SAAS,CA8C7B"}
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/vite/transform.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,cAAc,CAAC;AACvC,OAAO,EAAmC,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AASrF,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,EAAE,CAAC;CAClB;AAuDD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG,OAAO,GAAG,UAAU,GAAG,kBAAkB,CAAC;AAc3F,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC7C;;;OAGG;IACH,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,kBAAkB,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACnD;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC;IAC5C;;;;OAIG;IACH,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,gBAAgB,GACpB,eAAe,GAAG,SAAS,CAsD7B"}

package/build/types/vite/wranglerConfig.d.ts

@@ -1,3 +1,5 @@
+import { DEFAULT_EXPORT, type ExportName, type SameWorkerBinding } from './bindings';
+export { DEFAULT_EXPORT, type ExportName, type SameWorkerBinding };
 /**
  * The slice of the wrangler configuration the auto-instrument plugin cares
  * about. `main` is an absolute path (wrangler resolves it against the config
@@ -20,6 +22,11 @@ export interface WranglerConfig {
      * an export on a *different* worker, which this build can't wrap.
      */
     workerEntrypoints: string[];
+    /**
+     * Bindings whose RPC receiver lives in this worker, so this build instruments it. Not deduped by
+     * class, two bindings may point at the same class and both names have to be listed.
+     */
+    sameWorkerBindings: SameWorkerBinding[];
 }
 /**
  * Locate and resolve the wrangler configuration via wrangler's own

package/build/types/vite/wranglerConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wranglerConfig.d.ts","sourceRoot":"","sources":["../../../src/vite/wranglerConfig.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD;;;;;OAKG;IACH,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,MAAM,GACpB;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CA2B3D"}
+{"version":3,"file":"wranglerConfig.d.ts","sourceRoot":"","sources":["../../../src/vite/wranglerConfig.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAErF,OAAO,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,CAAC;AAEnE;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD;;;;;OAKG;IACH,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B;;;OAGG;IACH,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;CACzC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,MAAM,GACpB;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CA4B3D"}

package/build/types-ts3.8/client.d.ts

@@ -1,4 +1,4 @@
-import { ClientOptions, Options } from '@sentry/core';
+import { ClientOptions, Options, TracePropagationTargets } from '@sentry/core';
 import { ServerRuntimeClient } from '@sentry/core';
 import { ExecutionContextCompat } from './executionContext';
 import { makeFlushLock } from './flush';
@@ -68,47 +68,57 @@ interface BaseCloudflareOptions {
      */
     skipOpenTelemetrySetup?: boolean;
     /**
-     * Enable trace propagation for RPC calls between Workers, Durable Objects, and Service Bindings.
+     * The bindings on `env` that outgoing RPC calls propagate trace context to.
      *
-     * When enabled, trace context (sentry-trace + baggage) is propagated across:
-     * - `stub.fetch()` calls to Durable Objects (via HTTP headers)
-     * - Service binding `fetch()` calls (via HTTP headers)
-     * - RPC method calls to Durable Objects and WorkerEntrypoints (via trailing argument)
+     * Strings match a binding name exactly, regular expressions match by pattern. An empty array
+     * (the default) propagates to nothing.
      *
-     * When enabled on the **receiver side** (DurableObject or WorkerEntrypoint), the SDK will also:
-     * - Extract and continue traces from incoming RPC calls
-     * - Create spans for each RPC method invocation
-     * - Capture errors thrown by RPC methods
+     * RPC has no headers to carry trace context, so the SDK appends it as a trailing argument to
+     * every RPC method call on a matching binding. Only a Sentry-instrumented receiver strips that
+     * argument again. Anywhere else it arrives as a real argument and changes what the method was
+     * called with, so list only the bindings whose receiver you know runs Sentry.
      *
-     * **Important:** This option should be enabled on **both sides** for full trace propagation.
+     * Propagation over `stub.fetch()` and service binding `fetch()` uses HTTP headers and is not
+     * affected by this option.
      *
-     * @default false
+     * When you build with the Sentry Cloudflare Vite plugin, bindings that resolve to *this* worker
+     * (its own Durable Objects, its self service bindings) are added for you, because the plugin
+     * instruments those receivers itself. Whatever you list here is added on top of them.
+     *
+     * Setting this takes precedence over `enableRpcTracePropagation`: an allow list is the more
+     * precise statement, so a worker that sets both propagates only to the listed bindings. An empty
+     * array propagates to nothing, which is how a receiver keeps `enableRpcTracePropagation: true`
+     * without propagating to anything itself.
+     *
+     * The receiver still needs `enableRpcTracePropagation: true` to continue the trace it is sent.
+     *
+     * @default []
      * @example
      * ```ts
-     * // Worker side (caller)
+     * // Propagate to `env.ORDERS` and every `env.SVC_*` binding
      * export default Sentry.withSentry(
-     *   (env) => ({
+     *   env => ({
      *     dsn: env.SENTRY_DSN,
-     *     enableRpcTracePropagation: true,
+     *     rpcTracePropagationBindings: ['ORDERS', /^SVC_/],
      *   }),
      *   handler,
      * );
+     * ```
+     */
+    rpcTracePropagationBindings?: TracePropagationTargets;
+    /**
+     * Whether trace context is propagated over RPC calls between Workers, Durable Objects, and
+     * Service Bindings.
      *
-     * // Durable Object side (receiver)
-     * export const MyDO = Sentry.instrumentDurableObjectWithSentry(
-     *   (env) => ({
-     *     dsn: env.SENTRY_DSN,
-     *     enableRpcTracePropagation: true,
-     *   }),
-     *   MyDOBase,
-     * );
+     * On the caller side, `true` appends the trace context as a trailing argument to every RPC method
+     * call on `env`, including bindings whose receiver does not run Sentry and therefore never strips
+     * that argument again. On the receiver side, `true` continues an incoming trace, creates a span
+     * per RPC method invocation, and captures errors thrown by RPC methods.
      *
-     * // WorkerEntrypoint side (receiver)
-     * export const MyEntrypoint = Sentry.withSentry(
-     *   env => ({ dsn: env.SENTRY_DSN, enableRpcTracePropagation: true }),
-     *   MyEntrypointBase,
-     * );
-     * ```
+     * @deprecated Use `rpcTracePropagationBindings` to name the bindings you call. This option will
+     * be removed in a future major version. Receivers keep using it until then.
+     *
+     * @default false
      */
     enableRpcTracePropagation?: boolean;
     /**

package/build/types-ts3.8/instrumentations/instrumentDurableObjectHandlers.d.ts

@@ -0,0 +1,28 @@
+import { DurableObject } from 'cloudflare:workers';
+import { CloudflareOptions } from '../client';
+/**
+ * The instrumented context of the Durable Object being wrapped.
+ *
+ * Kept as `any` for the same reason as in `durableobject.ts`: a concrete `DurableObjectState` here
+ * makes `tsc` relate its `SqlStorage` graph against the parameter union of `wrapMethodWithSentry`,
+ * which hangs the type build.
+ */
+type InstrumentedDurableObjectContext = any;
+/**
+ * Instruments the built-in Durable Object handler methods on a constructed instance.
+ *
+ * These are the methods that are available on a Durable Object
+ * ref: https://developers.cloudflare.com/durable-objects/api/base/
+ * - obj.alarm
+ * - obj.fetch
+ * - obj.webSocketError
+ * - obj.webSocketClose
+ * - obj.webSocketMessage
+ *
+ * Any other public methods on the Durable Object instance are RPC calls.
+ *
+ * @internal
+ */
+export declare function instrumentDurableObjectHandlers<E, T extends DurableObject<E>>(obj: T, options: CloudflareOptions, context: InstrumentedDurableObjectContext): void;
+export {};
+//# sourceMappingURL=instrumentDurableObjectHandlers.d.ts.map

package/build/types-ts3.8/instrumentations/instrumentDurableObjectNamespace.d.ts

@@ -8,6 +8,7 @@ export declare const STUB_NON_RPC_METHODS: Set<string>;
  * - `namespace.idFromName(name)` / `namespace.idFromString(id)` / `namespace.newUniqueId()` with breadcrumbs
  *
  * @param namespace - The DurableObjectNamespace to instrument
+ * @param propagateRpcTrace - Whether RPC method calls on the returned stubs carry trace context
  */
-export declare function instrumentDurableObjectNamespace(namespace: DurableObjectNamespace): DurableObjectNamespace;
+export declare function instrumentDurableObjectNamespace(namespace: DurableObjectNamespace, propagateRpcTrace?: boolean): DurableObjectNamespace;
 //# sourceMappingURL=instrumentDurableObjectNamespace.d.ts.map

package/build/types-ts3.8/utils/rpcPropagation.d.ts

@@ -0,0 +1,15 @@
+import { CloudflareOptions } from '../client';
+/**
+ * Builds the per-binding predicate that decides whether a binding takes part in RPC trace
+ * propagation.
+ *
+ * `rpcTracePropagationBindings` wins over `enableRpcTracePropagation` as soon as it is set, an
+ * allow list is the more precise statement. An empty list therefore propagates to nothing, even
+ * next to `enableRpcTracePropagation: true`, which is how a receiver opts out of being a caller.
+ * Only leaving it unset falls back to the boolean.
+ *
+ * Callers only. Receivers continue an incoming trace whenever `enableRpcTracePropagation` is on,
+ * so they have nothing to match against.
+ */
+export declare function createRpcPropagationResolver(options: CloudflareOptions | undefined): (bindingName: string) => boolean;
+//# sourceMappingURL=rpcPropagation.d.ts.map

package/build/types-ts3.8/vite/bindings.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Binding vocabulary shared by the wrangler config reader and the AST transform.
+ *
+ * It lives apart from `wranglerConfig.ts` so the transform never has to import that module, which
+ * pulls in `wrangler` and with it a Node 20+ runtime.
+ */
+/** Stands in for a class name where a binding targets the module's default export. */
+export declare const DEFAULT_EXPORT: unique symbol;
+/** The name a binding or an export is known by, either an exported class name or the default export. */
+export type ExportName = string | typeof DEFAULT_EXPORT;
+export interface SameWorkerBinding {
+    bindingName: string;
+    className: ExportName;
+}
+//# sourceMappingURL=bindings.d.ts.map

package/build/types-ts3.8/vite/index.d.ts

@@ -40,6 +40,10 @@ export interface SentryCloudflareVitePluginOptions {
          * Durable Object class with `instrumentDurableObjectWithSentry`. Both
          * `vite build` and `vite dev` are instrumented.
          *
+         * The plugin also adds the bindings that resolve to the wrapped classes (this worker's own
+         * Durable Objects and self service bindings) to `rpcTracePropagationBindings`. Bindings to
+         * other workers stay opt-in, their receivers may not run Sentry.
+         *
          * @default false
          * @experimental May change or be removed in any release.
          */

package/build/types-ts3.8/vite/transform.d.ts

@@ -1,4 +1,5 @@
 import MagicString from 'magic-string';
+import { SameWorkerBinding } from './bindings';
 export interface BaseNode {
     type: string;
     start: number;
@@ -34,6 +35,8 @@ export interface TransformContext {
     optionsFn: string;
     /** Import statement prepended when `optionsFn` references a separate module. */
     optionsImport?: string;
+    /** @see {@link import('./wranglerConfig').WranglerConfig.sameWorkerBindings} */
+    sameWorkerBindings?: readonly SameWorkerBinding[];
 }
 export interface TransformResult {
     code: string;

package/build/types-ts3.8/vite/wranglerConfig.d.ts

@@ -1,3 +1,5 @@
+import { DEFAULT_EXPORT, ExportName, SameWorkerBinding } from './bindings';
+export { DEFAULT_EXPORT, ExportName, SameWorkerBinding };
 /**
  * The slice of the wrangler configuration the auto-instrument plugin cares
  * about. `main` is an absolute path (wrangler resolves it against the config
@@ -20,6 +22,11 @@ export interface WranglerConfig {
      * an export on a *different* worker, which this build can't wrap.
      */
     workerEntrypoints: string[];
+    /**
+     * Bindings whose RPC receiver lives in this worker, so this build instruments it. Not deduped by
+     * class, two bindings may point at the same class and both names have to be listed.
+     */
+    sameWorkerBindings: SameWorkerBinding[];
 }
 /**
  * Locate and resolve the wrangler configuration via wrangler's own

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentry/cloudflare",
-  "version": "10.71.0",
+  "version": "10.73.0",
   "description": "Official Sentry SDK for Cloudflare Workers and Pages",
   "repository": "git://github.com/getsentry/sentry-javascript.git",
   "homepage": "https://github.com/getsentry/sentry-javascript/tree/master/packages/cloudflare",
@@ -70,8 +70,8 @@
   },
   "dependencies": {
     "@opentelemetry/api": "^1.9.1",
-    "@sentry/core": "10.71.0",
-    "@sentry/server-utils": "10.71.0",
+    "@sentry/core": "10.73.0",
+    "@sentry/server-utils": "10.73.0",
     "magic-string": "~0.30.21"
   },
   "peerDependencies": {