@sentry/node 10.21.0 → 10.22.0

package/build/types/integrations/tracing/langchain/index.d.ts

@@ -0,0 +1,93 @@
+import type { LangChainOptions } from '@sentry/core';
+export declare const instrumentLangChain: ((options?: LangChainOptions | undefined) => import("@opentelemetry/instrumentation").Instrumentation<import("@opentelemetry/instrumentation").InstrumentationConfig>) & {
+    id: string;
+};
+/**
+ * Adds Sentry tracing instrumentation for LangChain.
+ *
+ * This integration is enabled by default.
+ *
+ * When configured, this integration automatically instruments LangChain runnable instances
+ * to capture telemetry data by injecting Sentry callback handlers into all LangChain calls.
+ *
+ * @example
+ * ```javascript
+ * import * as Sentry from '@sentry/node';
+ * import { ChatOpenAI } from '@langchain/openai';
+ *
+ * Sentry.init({
+ *   integrations: [Sentry.langChainIntegration()],
+ *   sendDefaultPii: true, // Enable to record inputs/outputs
+ * });
+ *
+ * // LangChain calls are automatically instrumented
+ * const model = new ChatOpenAI();
+ * await model.invoke("What is the capital of France?");
+ * ```
+ *
+ * ## Manual Callback Handler
+ *
+ * You can also manually add the Sentry callback handler alongside other callbacks:
+ *
+ * @example
+ * ```javascript
+ * import * as Sentry from '@sentry/node';
+ * import { ChatOpenAI } from '@langchain/openai';
+ *
+ * const sentryHandler = Sentry.createLangChainCallbackHandler({
+ *   recordInputs: true,
+ *   recordOutputs: true
+ * });
+ *
+ * const model = new ChatOpenAI();
+ * await model.invoke(
+ *   "What is the capital of France?",
+ *   { callbacks: [sentryHandler, myOtherCallback] }
+ * );
+ * ```
+ *
+ * ## Options
+ *
+ * - `recordInputs`: Whether to record input messages/prompts (default: respects `sendDefaultPii` client option)
+ * - `recordOutputs`: Whether to record response text (default: respects `sendDefaultPii` client option)
+ *
+ * ### Default Behavior
+ *
+ * By default, the integration will:
+ * - Record inputs and outputs ONLY if `sendDefaultPii` is set to `true` in your Sentry client options
+ * - Otherwise, inputs and outputs are NOT recorded unless explicitly enabled
+ *
+ * @example
+ * ```javascript
+ * // Record inputs and outputs when sendDefaultPii is false
+ * Sentry.init({
+ *   integrations: [
+ *     Sentry.langChainIntegration({
+ *       recordInputs: true,
+ *       recordOutputs: true
+ *     })
+ *   ],
+ * });
+ *
+ * // Never record inputs/outputs regardless of sendDefaultPii
+ * Sentry.init({
+ *   sendDefaultPii: true,
+ *   integrations: [
+ *     Sentry.langChainIntegration({
+ *       recordInputs: false,
+ *       recordOutputs: false
+ *     })
+ *   ],
+ * });
+ * ```
+ *
+ * ## Supported Events
+ *
+ * The integration captures the following LangChain lifecycle events:
+ * - LLM/Chat Model: start, end, error
+ * - Chain: start, end, error
+ * - Tool: start, end, error
+ *
+ */
+export declare const langChainIntegration: (options?: LangChainOptions | undefined) => import("@sentry/core").Integration;
+//# sourceMappingURL=index.d.ts.map

package/build/types/integrations/tracing/langchain/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/integrations/tracing/langchain/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAKpE,eAAO,MAAM,mBAAmB;;CAG/B,CAAC;AAWF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsFG;AACH,eAAO,MAAM,oBAAoB,gFAA2C,CAAC"}

package/build/types/integrations/tracing/langchain/instrumentation.d.ts

@@ -0,0 +1,29 @@
+import { type InstrumentationConfig, type InstrumentationModuleDefinition, InstrumentationBase } from '@opentelemetry/instrumentation';
+import type { LangChainOptions } from '@sentry/core';
+type LangChainInstrumentationOptions = InstrumentationConfig & LangChainOptions;
+/**
+ * Sentry LangChain instrumentation using OpenTelemetry.
+ */
+export declare class SentryLangChainInstrumentation extends InstrumentationBase<LangChainInstrumentationOptions> {
+    constructor(config?: LangChainInstrumentationOptions);
+    /**
+     * Initializes the instrumentation by defining the modules to be patched.
+     * We patch the BaseChatModel class methods to inject callbacks
+     *
+     * We hook into provider packages (@langchain/anthropic, @langchain/openai, etc.)
+     * because @langchain/core is often bundled and not loaded as a separate module
+     */
+    init(): InstrumentationModuleDefinition | InstrumentationModuleDefinition[];
+    /**
+     * Core patch logic - patches chat model methods to inject Sentry callbacks
+     * This is called when a LangChain provider package is loaded
+     */
+    private _patch;
+    /**
+     * Patches chat model methods (invoke, stream, batch) to inject Sentry callbacks
+     * Finds a chat model class from the provider package exports and patches its prototype methods
+     */
+    private _patchRunnableMethods;
+}
+export {};
+//# sourceMappingURL=instrumentation.d.ts.map

package/build/types/integrations/tracing/langchain/instrumentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../../../../../src/integrations/tracing/langchain/instrumentation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,+BAA+B,EACpC,mBAAmB,EAGpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAKrD,KAAK,+BAA+B,GAAG,qBAAqB,GAAG,gBAAgB,CAAC;AA0EhF;;GAEG;AACH,qBAAa,8BAA+B,SAAQ,mBAAmB,CAAC,+BAA+B,CAAC;gBACnF,MAAM,GAAE,+BAAoC;IAI/D;;;;;;OAMG;IACI,IAAI,IAAI,+BAA+B,GAAG,+BAA+B,EAAE;IAuClF;;;OAGG;IACH,OAAO,CAAC,MAAM;IAwBd;;;OAGG;IACH,OAAO,CAAC,qBAAqB;CAyC9B"}

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

@@ -27,6 +27,7 @@ export { vercelAIIntegration } from './integrations/tracing/vercelai';
 export { openAIIntegration } from './integrations/tracing/openai';
 export { anthropicAIIntegration } from './integrations/tracing/anthropic-ai';
 export { googleGenAIIntegration } from './integrations/tracing/google-genai';
+export { langChainIntegration } from './integrations/tracing/langchain';
 export { launchDarklyIntegration, buildLaunchDarklyFlagUsedHandler, openFeatureIntegration, OpenFeatureIntegrationHook, statsigIntegration, unleashIntegration, growthbookIntegration, } from './integrations/featureFlagShims';
 export { firebaseIntegration } from './integrations/tracing/firebase';
 export { init, getDefaultIntegrations, getDefaultIntegrationsWithoutPerformance, initWithoutDefaultIntegrations, } from './sdk';
@@ -34,7 +35,7 @@ export { initOpenTelemetry, preloadOpenTelemetry } from './sdk/initOtel';
 export { getAutoPerformanceIntegrations } from './integrations/tracing';
 export { NodeOptions } from './types';
 export { setOpenTelemetryContextAsyncContextStrategy as setNodeAsyncContextStrategy, } from '@sentry/opentelemetry';
-export { addBreadcrumb, isInitialized, isEnabled, getGlobalScope, lastEventId, close, createTransport, flush, SDK_VERSION, getSpanStatusFromHttpCode, setHttpStatus, captureCheckIn, withMonitor, requestDataIntegration, functionToStringIntegration, inboundFiltersIntegration, eventFiltersIntegration, linkedErrorsIntegration, addEventProcessor, setContext, setExtra, setExtras, setTag, setTags, setUser, SEMANTIC_ATTRIBUTE_SENTRY_OP, SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, SEMANTIC_ATTRIBUTE_SENTRY_SAMPLE_RATE, setCurrentClient, Scope, setMeasurement, getSpanDescendants, parameterize, getClient, getCurrentScope, getIsolationScope, getTraceData, getTraceMetaTags, httpHeadersToSpanAttributes, winterCGHeadersToDict, continueTrace, withScope, withIsolationScope, captureException, captureEvent, captureMessage, captureFeedback, captureConsoleIntegration, dedupeIntegration, extraErrorDataIntegration, rewriteFramesIntegration, startSession, captureSession, endSession, addIntegration, startSpan, startSpanManual, startInactiveSpan, startNewTrace, suppressTracing, getActiveSpan, withActiveSpan, getRootSpan, spanToJSON, spanToTraceHeader, spanToBaggageHeader, trpcMiddleware, updateSpanName, supabaseIntegration, instrumentSupabaseClient, zodErrorsIntegration, profiler, consoleLoggingIntegration, createConsolaReporter, consoleIntegration, wrapMcpServerWithSentry, featureFlagsIntegration, } from '@sentry/core';
+export { addBreadcrumb, isInitialized, isEnabled, getGlobalScope, lastEventId, close, createTransport, flush, SDK_VERSION, getSpanStatusFromHttpCode, setHttpStatus, captureCheckIn, withMonitor, requestDataIntegration, functionToStringIntegration, inboundFiltersIntegration, eventFiltersIntegration, linkedErrorsIntegration, addEventProcessor, setContext, setExtra, setExtras, setTag, setTags, setUser, SEMANTIC_ATTRIBUTE_SENTRY_OP, SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN, SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, SEMANTIC_ATTRIBUTE_SENTRY_SAMPLE_RATE, setCurrentClient, Scope, setMeasurement, getSpanDescendants, parameterize, getClient, getCurrentScope, getIsolationScope, getTraceData, getTraceMetaTags, httpHeadersToSpanAttributes, winterCGHeadersToDict, continueTrace, withScope, withIsolationScope, captureException, captureEvent, captureMessage, captureFeedback, captureConsoleIntegration, dedupeIntegration, extraErrorDataIntegration, rewriteFramesIntegration, startSession, captureSession, endSession, addIntegration, startSpan, startSpanManual, startInactiveSpan, startNewTrace, suppressTracing, getActiveSpan, withActiveSpan, getRootSpan, spanToJSON, spanToTraceHeader, spanToBaggageHeader, trpcMiddleware, updateSpanName, supabaseIntegration, instrumentSupabaseClient, zodErrorsIntegration, profiler, consoleLoggingIntegration, createConsolaReporter, consoleIntegration, wrapMcpServerWithSentry, featureFlagsIntegration, createLangChainCallbackHandler, } from '@sentry/core';
 export { Breadcrumb, BreadcrumbHint, PolymorphicRequest, RequestEventData, SdkInfo, Event, EventHint, ErrorEvent, Exception, Session, SeverityLevel, StackFrame, Stacktrace, Thread, User, Span, Metric, FeatureFlagsIntegration, } from '@sentry/core';
 export { logger, metrics, httpServerIntegration, httpServerSpansIntegration, nodeContextIntegration, contextLinesIntegration, localVariablesIntegration, modulesIntegration, onUncaughtExceptionIntegration, onUnhandledRejectionIntegration, anrIntegration, disableAnrDetectionForCallback, spotlightIntegration, childProcessIntegration, pinoIntegration, createSentryWinstonTransport, SentryContextManager, systemErrorIntegration, generateInstrumentOnce, getSentryRelease, defaultStackParser, createGetModuleFromFilename, makeNodeTransport, NodeClient, cron, NODE_VERSION, validateOpenTelemetrySetup, } from '@sentry/node-core';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,4 +1,5 @@
-interface NodeFetchOptions {
+import { UndiciInstrumentationConfig } from '@opentelemetry/instrumentation-undici';
+interface NodeFetchOptions extends Pick<UndiciInstrumentationConfig, 'requestHook' | 'responseHook'> {
     /**
      * Whether breadcrumbs should be recorded for requests.
      * Defaults to true

package/build/types-ts3.8/integrations/tracing/firebase/otel/patches/functions.d.ts

@@ -0,0 +1,23 @@
+import { Tracer } from '@opentelemetry/api';
+import { InstrumentationBase } from '@opentelemetry/instrumentation';
+import { InstrumentationNodeModuleDefinition } from '@opentelemetry/instrumentation';
+import { FirebaseFunctions, FirebaseInstrumentationConfig, OverloadedParameters } from '../types';
+/**
+ * Patches Firebase Functions v2 to add OpenTelemetry instrumentation
+ * @param tracer - Opentelemetry Tracer
+ * @param functionsSupportedVersions - supported versions of firebase-functions
+ * @param wrap - reference to native instrumentation wrap function
+ * @param unwrap - reference to native instrumentation unwrap function
+ * @param config - Firebase instrumentation config
+ */
+export declare function patchFunctions(tracer: Tracer, functionsSupportedVersions: string[], wrap: InstrumentationBase['_wrap'], unwrap: InstrumentationBase['_unwrap'], config: FirebaseInstrumentationConfig): InstrumentationNodeModuleDefinition;
+/**
+ * Patches Cloud Functions for Firebase (v2) to add OpenTelemetry instrumentation
+ *
+ * @param tracer - Opentelemetry Tracer
+ * @param functionsConfig - Firebase instrumentation config
+ * @param triggerType - Type of trigger
+ * @returns A function that patches the function
+ */
+export declare function patchV2Functions<T extends FirebaseFunctions = FirebaseFunctions>(tracer: Tracer, functionsConfig: FirebaseInstrumentationConfig['functions'], triggerType: string): (original: T) => (...args: OverloadedParameters<T>) => ReturnType<T>;
+//# sourceMappingURL=functions.d.ts.map

package/build/types-ts3.8/integrations/tracing/firebase/otel/types.d.ts

@@ -75,7 +75,16 @@ export interface FirestoreSettings {
  */
 export interface FirebaseInstrumentationConfig extends InstrumentationConfig {
     firestoreSpanCreationHook?: FirestoreSpanCreationHook;
+    functions?: FunctionsConfig;
 }
+export interface FunctionsConfig {
+    requestHook?: RequestHook;
+    responseHook?: ResponseHook;
+    errorHook?: ErrorHook;
+}
+export type RequestHook = (span: Span) => void;
+export type ResponseHook = (span: Span, error?: unknown) => void;
+export type ErrorHook = (span: Span, error?: unknown) => Promise<void> | void;
 export interface FirestoreSpanCreationHook {
     (span: Span): void;
 }
@@ -83,4 +92,29 @@ export type GetDocsType<AppModelType = DocumentData, DbModelType extends Documen
 export type SetDocType<AppModelType = DocumentData, DbModelType extends DocumentData = DocumentData> = ((reference: DocumentReference<AppModelType, DbModelType>, data: WithFieldValue<AppModelType>) => Promise<void>) & ((reference: DocumentReference<AppModelType, DbModelType>, data: PartialWithFieldValue<AppModelType>, options: SetOptions) => Promise<void>);
 export type AddDocType<AppModelType, DbModelType extends DocumentData> = (reference: CollectionReference<AppModelType, DbModelType>, data: WithFieldValue<AppModelType>) => Promise<DocumentReference<AppModelType, DbModelType>>;
 export type DeleteDocType<AppModelType, DbModelType extends DocumentData> = (reference: DocumentReference<AppModelType, DbModelType>) => Promise<void>;
+export type OverloadedParameters<T> = T extends {
+    (...args: infer A1): unknown;
+    (...args: infer A2): unknown;
+} ? A1 | A2 : T extends (...args: infer A) => unknown ? A : unknown;
+/**
+ * A bare minimum of how Cloud Functions for Firebase (v2) are defined.
+ */
+export type FirebaseFunctions = ((handler: () => Promise<unknown> | unknown) => (...args: unknown[]) => Promise<unknown> | unknown) | ((documentOrOptions: string | string[] | Record<string, unknown>, handler: () => Promise<unknown> | unknown) => (...args: unknown[]) => Promise<unknown> | unknown);
+export type AvailableFirebaseFunctions = {
+    onRequest: FirebaseFunctions;
+    onCall: FirebaseFunctions;
+    onDocumentCreated: FirebaseFunctions;
+    onDocumentUpdated: FirebaseFunctions;
+    onDocumentDeleted: FirebaseFunctions;
+    onDocumentWritten: FirebaseFunctions;
+    onDocumentCreatedWithAuthContext: FirebaseFunctions;
+    onDocumentUpdatedWithAuthContext: FirebaseFunctions;
+    onDocumentDeletedWithAuthContext: FirebaseFunctions;
+    onDocumentWrittenWithAuthContext: FirebaseFunctions;
+    onSchedule: FirebaseFunctions;
+    onObjectFinalized: FirebaseFunctions;
+    onObjectArchived: FirebaseFunctions;
+    onObjectDeleted: FirebaseFunctions;
+    onObjectMetadataUpdated: FirebaseFunctions;
+};
 //# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1,93 @@
+import { LangChainOptions } from '@sentry/core';
+export declare const instrumentLangChain: ((options?: LangChainOptions | undefined) => import("@opentelemetry/instrumentation").Instrumentation<import("@opentelemetry/instrumentation").InstrumentationConfig>) & {
+    id: string;
+};
+/**
+ * Adds Sentry tracing instrumentation for LangChain.
+ *
+ * This integration is enabled by default.
+ *
+ * When configured, this integration automatically instruments LangChain runnable instances
+ * to capture telemetry data by injecting Sentry callback handlers into all LangChain calls.
+ *
+ * @example
+ * ```javascript
+ * import * as Sentry from '@sentry/node';
+ * import { ChatOpenAI } from '@langchain/openai';
+ *
+ * Sentry.init({
+ *   integrations: [Sentry.langChainIntegration()],
+ *   sendDefaultPii: true, // Enable to record inputs/outputs
+ * });
+ *
+ * // LangChain calls are automatically instrumented
+ * const model = new ChatOpenAI();
+ * await model.invoke("What is the capital of France?");
+ * ```
+ *
+ * ## Manual Callback Handler
+ *
+ * You can also manually add the Sentry callback handler alongside other callbacks:
+ *
+ * @example
+ * ```javascript
+ * import * as Sentry from '@sentry/node';
+ * import { ChatOpenAI } from '@langchain/openai';
+ *
+ * const sentryHandler = Sentry.createLangChainCallbackHandler({
+ *   recordInputs: true,
+ *   recordOutputs: true
+ * });
+ *
+ * const model = new ChatOpenAI();
+ * await model.invoke(
+ *   "What is the capital of France?",
+ *   { callbacks: [sentryHandler, myOtherCallback] }
+ * );
+ * ```
+ *
+ * ## Options
+ *
+ * - `recordInputs`: Whether to record input messages/prompts (default: respects `sendDefaultPii` client option)
+ * - `recordOutputs`: Whether to record response text (default: respects `sendDefaultPii` client option)
+ *
+ * ### Default Behavior
+ *
+ * By default, the integration will:
+ * - Record inputs and outputs ONLY if `sendDefaultPii` is set to `true` in your Sentry client options
+ * - Otherwise, inputs and outputs are NOT recorded unless explicitly enabled
+ *
+ * @example
+ * ```javascript
+ * // Record inputs and outputs when sendDefaultPii is false
+ * Sentry.init({
+ *   integrations: [
+ *     Sentry.langChainIntegration({
+ *       recordInputs: true,
+ *       recordOutputs: true
+ *     })
+ *   ],
+ * });
+ *
+ * // Never record inputs/outputs regardless of sendDefaultPii
+ * Sentry.init({
+ *   sendDefaultPii: true,
+ *   integrations: [
+ *     Sentry.langChainIntegration({
+ *       recordInputs: false,
+ *       recordOutputs: false
+ *     })
+ *   ],
+ * });
+ * ```
+ *
+ * ## Supported Events
+ *
+ * The integration captures the following LangChain lifecycle events:
+ * - LLM/Chat Model: start, end, error
+ * - Chain: start, end, error
+ * - Tool: start, end, error
+ *
+ */
+export declare const langChainIntegration: (options?: LangChainOptions | undefined) => import("@sentry/core").Integration;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,29 @@
+import { InstrumentationConfig, InstrumentationModuleDefinition, InstrumentationBase } from '@opentelemetry/instrumentation';
+import { LangChainOptions } from '@sentry/core';
+type LangChainInstrumentationOptions = InstrumentationConfig & LangChainOptions;
+/**
+ * Sentry LangChain instrumentation using OpenTelemetry.
+ */
+export declare class SentryLangChainInstrumentation extends InstrumentationBase<LangChainInstrumentationOptions> {
+    constructor(config?: LangChainInstrumentationOptions);
+    /**
+     * Initializes the instrumentation by defining the modules to be patched.
+     * We patch the BaseChatModel class methods to inject callbacks
+     *
+     * We hook into provider packages (@langchain/anthropic, @langchain/openai, etc.)
+     * because @langchain/core is often bundled and not loaded as a separate module
+     */
+    init(): InstrumentationModuleDefinition | InstrumentationModuleDefinition[];
+    /**
+     * Core patch logic - patches chat model methods to inject Sentry callbacks
+     * This is called when a LangChain provider package is loaded
+     */
+    private _patch;
+    /**
+     * Patches chat model methods (invoke, stream, batch) to inject Sentry callbacks
+     * Finds a chat model class from the provider package exports and patches its prototype methods
+     */
+    private _patchRunnableMethods;
+}
+export {};
+//# sourceMappingURL=instrumentation.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentry/node",
-  "version": "10.21.0",
+  "version": "10.22.0",
   "description": "Sentry Node SDK using OpenTelemetry for performance instrumentation",
   "repository": "git://github.com/getsentry/sentry-javascript.git",
   "homepage": "https://github.com/getsentry/sentry-javascript/tree/master/packages/node",
@@ -95,9 +95,9 @@
     "@opentelemetry/sdk-trace-base": "^2.1.0",
     "@opentelemetry/semantic-conventions": "^1.37.0",
     "@prisma/instrumentation": "6.15.0",
-    "@sentry/core": "10.21.0",
-    "@sentry/node-core": "10.21.0",
-    "@sentry/opentelemetry": "10.21.0",
+    "@sentry/core": "10.22.0",
+    "@sentry/node-core": "10.22.0",
+    "@sentry/opentelemetry": "10.22.0",
     "import-in-the-middle": "^1.14.2",
     "minimatch": "^9.0.0"
   },