@sentry/core 10.48.0 → 10.49.0

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

@@ -1,10 +1,10 @@
 import { HandlerDataFetch } from './types-hoist/instrument';
 import { ResponseHookInfo } from './types-hoist/request';
 import { Span, SpanOrigin } from './types-hoist/span';
-type PolymorphicRequestHeaders = Record<string, string | undefined> | Array<[
+type PolymorphicRequestHeaders = Record<string, unknown> | Array<[
     string,
-    string
-]> | {
+    unknown
+]> | Iterable<Iterable<unknown>> | {
     append: (key: string, value: string) => void;
     get: (key: string) => string | null | undefined;
 };
@@ -32,15 +32,19 @@ export declare function instrumentFetchRequest(handlerData: HandlerDataFetch, sh
  */
 export declare function _callOnRequestSpanEnd(span: Span, handlerData: HandlerDataFetch, spanOriginOrOptions?: SpanOrigin | InstrumentFetchRequestOptions): void;
 /**
- * Adds sentry-trace and baggage headers to the various forms of fetch headers.
- * exported only for testing purposes
+ * Builds merged fetch headers that include `sentry-trace` and `baggage` (and optionally `traceparent`)
+ * for the given request and init, without mutating the original request or options.
+ * Returns `undefined` when there is no `sentry-trace` value to attach.
  *
- * When we determine if we should add a baggage header, there are 3 cases:
- * 1. No previous baggage header -> add baggage
- * 2. Previous baggage header has no sentry baggage values -> add our baggage
- * 3. Previous baggage header has sentry baggage values -> do nothing (might have been added manually by users)
+ * @internal Exported for cross-package instrumentation (for example Cloudflare Workers fetcher bindings)
+ * and unit tests
+ *
+ * Baggage handling:
+ * 1. No previous baggage header → include Sentry baggage
+ * 2. Previous baggage has no Sentry entries → merge Sentry baggage in
+ * 3. Previous baggage already has Sentry entries → leave as-is (may be user-defined)
  */
-export declare function _addTracingHeadersToFetchRequest(request: string | Request, fetchOptionsObj: {
+export declare function _INTERNAL_getTracingHeadersForFetchRequest(request: string | URL | Request, fetchOptionsObj: {
     headers?: {
         [key: string]: string[] | string | undefined;
     } | PolymorphicRequestHeaders;

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

@@ -48,6 +48,8 @@ export { getTraceData } from './utils/traceData';
 export { shouldPropagateTraceForUrl } from './utils/tracePropagationTargets';
 export { getTraceMetaTags } from './utils/meta';
 export { debounce } from './utils/debounce';
+export { makeWeakRef, derefWeakRef } from './utils/weakRef';
+export { MaybeWeakRef } from './utils/weakRef';
 export { shouldIgnoreSpan } from './utils/should-ignore-span';
 export { winterCGHeadersToDict, winterCGRequestToRequestData, httpRequestToRequestData, extractQueryParamsFromUrl, headersToDict, httpHeadersToSpanAttributes, } from './utils/request';
 export { DEFAULT_ENVIRONMENT, DEV_ENVIRONMENT } from './constants';
@@ -73,7 +75,7 @@ export { featureFlagsIntegration, FeatureFlagsIntegration } from './integrations
 export { growthbookIntegration } from './integrations/featureFlags';
 export { conversationIdIntegration } from './integrations/conversationId';
 export { profiler } from './profiling';
-export { instrumentFetchRequest } from './fetch';
+export { instrumentFetchRequest, _INTERNAL_getTracingHeadersForFetchRequest } from './fetch';
 export { trpcMiddleware } from './trpc';
 export { wrapMcpServerWithSentry } from './integrations/mcp-server';
 export { captureFeedback } from './feedback';
@@ -192,6 +194,7 @@ export { SeverityLevel } from './types-hoist/severity';
 export { Span, SentrySpanArguments, SpanOrigin, SpanAttributeValue, SpanAttributes, SpanTimeInput, SpanJSON, SpanContextData, TraceFlag, SerializedStreamedSpan, SerializedStreamedSpanContainer, StreamedSpanJSON, } from './types-hoist/span';
 export { SpanStatus } from './types-hoist/spanStatus';
 export { Log, LogSeverityLevel } from './types-hoist/log';
+export { SpanLink } from './types-hoist/link';
 export { Metric, MetricType, SerializedMetric, SerializedMetricContainer, SerializedMetricAttributeValue, } from './types-hoist/metric';
 export { TimedEvent } from './types-hoist/timedEvent';
 export { StackFrame } from './types-hoist/stackframe';

package/build/types-ts3.8/integrations/express/index.d.ts

@@ -26,7 +26,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { ExpressErrorMiddleware, ExpressExport, ExpressHandlerOptions, ExpressIntegrationOptions } from './types';
+import { ExpressErrorMiddleware, ExpressHandlerOptions, ExpressIntegrationOptions, ExpressModuleExport } from './types';
 /**
  * This is a portable instrumentatiton function that works in any environment
  * where Express can be loaded, without depending on OpenTelemetry.
@@ -36,9 +36,16 @@ import { ExpressErrorMiddleware, ExpressExport, ExpressHandlerOptions, ExpressIn
  * import express from 'express';
  * import * as Sentry from '@sentry/deno'; // or any SDK that extends core
  *
- * Sentry.patchExpressModule({ express })
+ * Sentry.patchExpressModule(express, () => ({}));
+ * ```
+ */
+export declare function patchExpressModule(moduleExports: ExpressModuleExport, getOptions: () => ExpressIntegrationOptions): ExpressModuleExport;
+/**
+ * @deprecated Pass the Express module export as the first argument and options getter as the second argument.
  */
-export declare const patchExpressModule: (options: ExpressIntegrationOptions) => ExpressExport;
+export declare function patchExpressModule(options: ExpressIntegrationOptions & {
+    express: ExpressModuleExport;
+}): ExpressModuleExport;
 /**
  * An Express-compatible error handler, used by setupExpressErrorHandler
  */

package/build/types-ts3.8/integrations/express/patch-layer.d.ts

@@ -28,5 +28,5 @@
 */
 import { ExpressIntegrationOptions, ExpressLayer } from './types';
 export type ExpressPatchLayerOptions = Pick<ExpressIntegrationOptions, 'onRouteResolved' | 'ignoreLayers' | 'ignoreLayersType'>;
-export declare function patchLayer(options: ExpressPatchLayerOptions, maybeLayer?: ExpressLayer, layerPath?: string): void;
+export declare function patchLayer(getOptions: () => ExpressPatchLayerOptions, maybeLayer?: ExpressLayer, layerPath?: string): void;
 //# sourceMappingURL=patch-layer.d.ts.map

package/build/types-ts3.8/integrations/express/types.d.ts

@@ -114,7 +114,11 @@ export type ExpressRouter = {
 };
 export type IgnoreMatcher = string | RegExp | ((name: string) => boolean);
 export type ExpressIntegrationOptions = {
-    express: ExpressModuleExport;
+    /**
+     * @deprecated Pass the express module as the first argument, and an
+     * options getter as the second argument to patchExpressModule.
+     */
+    express?: ExpressModuleExport;
     /** Ignore specific based on their name */
     ignoreLayers?: IgnoreMatcher[];
     /** Ignore specific layers based on their type */

package/build/types-ts3.8/tracing/ai/gen-ai-attributes.d.ts

@@ -177,14 +177,6 @@ export declare const GEN_AI_EMBEDDINGS_INPUT_ATTRIBUTE = "gen_ai.embeddings.inpu
  * The span operation for embeddings
  */
 export declare const GEN_AI_EMBEDDINGS_OPERATION_ATTRIBUTE = "gen_ai.embeddings";
-/**
- * The span operation name for embedding
- */
-export declare const GEN_AI_EMBED_DO_EMBED_OPERATION_ATTRIBUTE = "gen_ai.embeddings";
-/**
- * The span operation name for embedding many
- */
-export declare const GEN_AI_EMBED_MANY_DO_EMBED_OPERATION_ATTRIBUTE = "gen_ai.embeddings";
 /**
  * The span operation name for reranking
  */

package/build/types-ts3.8/tracing/ai/utils.d.ts

@@ -26,6 +26,12 @@ export type InstrumentedMethodRegistry = Record<string, InstrumentedMethodEntry>
  * Precedence: explicit option > sendDefaultPii > false
  */
 export declare function resolveAIRecordingOptions<T extends AIRecordingOptions>(options?: T): T & Required<AIRecordingOptions>;
+/**
+ * Resolves whether truncation should be enabled.
+ * If the user explicitly set `enableTruncation`, that value is used.
+ * Otherwise, truncation is disabled when span streaming is active.
+ */
+export declare function shouldEnableTruncation(enableTruncation: boolean | undefined): boolean;
 /**
  * Build method path from current traversal
  */
@@ -56,6 +62,11 @@ export interface StreamResponseState {
  * Shared across OpenAI, Anthropic, and Google GenAI streaming implementations.
  */
 export declare function endStreamSpan(span: Span, state: StreamResponseState, recordOutputs: boolean): void;
+/**
+ * Serialize a value to a JSON string without truncation.
+ * Strings are returned as-is, arrays and objects are JSON-stringified.
+ */
+export declare function getJsonString<T>(value: T | T[]): string;
 /**
  * Get the truncated JSON string for a string or array of strings.
  *

package/build/types-ts3.8/tracing/anthropic-ai/types.d.ts

@@ -8,6 +8,11 @@ export interface AnthropicAiOptions {
      * Enable or disable output recording.
      */
     recordOutputs?: boolean;
+    /**
+     * Enable or disable truncation of recorded input messages.
+     * Defaults to `true`.
+     */
+    enableTruncation?: boolean;
 }
 export type Message = {
     role: 'user' | 'assistant';

package/build/types-ts3.8/tracing/anthropic-ai/utils.d.ts

@@ -5,7 +5,7 @@ import { AnthropicAiResponse } from './types';
  * Set the messages and messages original length attributes.
  * Extracts system instructions before truncation.
  */
-export declare function setMessagesAttribute(span: Span, messages: unknown): void;
+export declare function setMessagesAttribute(span: Span, messages: unknown, enableTruncation: boolean): void;
 /**
  * Map an Anthropic API error type to a SpanStatusType value.
  * @see https://docs.anthropic.com/en/api/errors#error-shapes

package/build/types-ts3.8/tracing/google-genai/types.d.ts

@@ -8,6 +8,11 @@ export interface GoogleGenAIOptions {
      * Enable or disable output recording.
      */
     recordOutputs?: boolean;
+    /**
+     * Enable or disable truncation of recorded input messages.
+     * Defaults to `true`.
+     */
+    enableTruncation?: boolean;
 }
 /**
  * Google GenAI Content Part

package/build/types-ts3.8/tracing/langchain/types.d.ts

@@ -12,6 +12,11 @@ export interface LangChainOptions {
      * @default false (respects sendDefaultPii option)
      */
     recordOutputs?: boolean;
+    /**
+     * Enable or disable truncation of recorded input messages.
+     * Defaults to `true`.
+     */
+    enableTruncation?: boolean;
 }
 /**
  * LangChain Serialized type (compatible with @langchain/core)

package/build/types-ts3.8/tracing/langchain/utils.d.ts

@@ -36,7 +36,7 @@ export declare function normalizeLangChainMessages(messages: LangChainMessage[])
  * - When `recordInputs` is true, string prompts are wrapped into `{role:"user"}`
  *   messages to align with the chat schema used elsewhere.
  */
-export declare function extractLLMRequestAttributes(llm: LangChainSerialized, prompts: string[], recordInputs: boolean, invocationParams?: Record<string, unknown>, langSmithMetadata?: Record<string, unknown>): Record<string, SpanAttributeValue>;
+export declare function extractLLMRequestAttributes(llm: LangChainSerialized, prompts: string[], recordInputs: boolean, enableTruncation: boolean, invocationParams?: Record<string, unknown>, langSmithMetadata?: Record<string, unknown>): Record<string, SpanAttributeValue>;
 /**
  * Extracts attributes for ChatModel invocations (array-of-arrays of messages).
  *
@@ -46,7 +46,7 @@ export declare function extractLLMRequestAttributes(llm: LangChainSerialized, pr
  *   consistent `{ role, content }` array when `recordInputs` is true.
  * - Provider system value falls back to `serialized.id?.[2]`.
  */
-export declare function extractChatModelRequestAttributes(llm: LangChainSerialized, langChainMessages: LangChainMessage[][], recordInputs: boolean, invocationParams?: Record<string, unknown>, langSmithMetadata?: Record<string, unknown>): Record<string, SpanAttributeValue>;
+export declare function extractChatModelRequestAttributes(llm: LangChainSerialized, langChainMessages: LangChainMessage[][], recordInputs: boolean, enableTruncation: boolean, invocationParams?: Record<string, unknown>, langSmithMetadata?: Record<string, unknown>): Record<string, SpanAttributeValue>;
 /**
  * Extracts response-related attributes based on a `LangChainLLMResult`.
  *

package/build/types-ts3.8/tracing/langgraph/types.d.ts

@@ -7,6 +7,11 @@ export interface LangGraphOptions {
      * Enable or disable output recording.
      */
     recordOutputs?: boolean;
+    /**
+     * Enable or disable truncation of recorded input messages.
+     * Defaults to `true`.
+     */
+    enableTruncation?: boolean;
 }
 /**
  * LangGraph Tool definition from lc_kwargs

package/build/types-ts3.8/tracing/openai/types.d.ts

@@ -14,6 +14,11 @@ export interface OpenAiOptions {
      * Enable or disable output recording.
      */
     recordOutputs?: boolean;
+    /**
+     * Enable or disable truncation of recorded input messages.
+     * Defaults to `true`.
+     */
+    enableTruncation?: boolean;
 }
 export interface OpenAiClient {
     responses?: {

package/build/types-ts3.8/tracing/vercel-ai/constants.d.ts

@@ -1,8 +1,5 @@
 import { ToolCallSpanContext } from './types';
 export declare const toolCallSpanContextMap: Map<string, ToolCallSpanContext>;
-export declare const INVOKE_AGENT_OPS: Set<string>;
-export declare const GENERATE_CONTENT_OPS: Set<string>;
-export declare const EMBEDDINGS_OPS: Set<string>;
-export declare const RERANK_OPS: Set<string>;
-export declare const DO_SPAN_NAME_PREFIX: Record<string, string>;
+/** Maps Vercel AI span names to standardized OpenTelemetry operation names. */
+export declare const SPAN_TO_OPERATION_NAME: Map<string, string>;
 //# sourceMappingURL=constants.d.ts.map

package/build/types-ts3.8/tracing/vercel-ai/utils.d.ts

@@ -44,9 +44,5 @@ export declare function convertUserInputToMessagesFormat(userInput: string): {
  * Generate a request.messages JSON array from the prompt field in the
  * invoke_agent op
  */
-export declare function requestMessagesFromPrompt(span: Span, attributes: SpanAttributes): void;
-/**
- * Maps a Vercel AI span name to the corresponding Sentry op.
- */
-export declare function getSpanOpFromName(name: string): string | undefined;
+export declare function requestMessagesFromPrompt(span: Span, attributes: SpanAttributes, enableTruncation: boolean): void;
 //# sourceMappingURL=utils.d.ts.map