feat(core): Export instrumentStateGraph and deprecate instrumentLangGraph (#6520)

* feat(core): Export instrumentStateGraph and deprecate instrumentLangGraph

The JavaScript SDK renamed `instrumentLangGraph` to `instrumentStateGraph`
in v10.68.0 and marked the old name as deprecated. Re-export the new name
and keep the old one for backwards compatibility until the next major.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* chore: add PR link to changelog entry

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* chore: move changelog entry to Changes section

Matches the precedent set by the featureFlagsIntegration and logger
re-export entries, which are Changes rather than Features.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

---------

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

Author: antonis

CHANGELOG.md

@@ -8,6 +8,11 @@
 
 ## Unreleased
 
+### Changes
+
+- Expose `instrumentStateGraph` for manual LangGraph instrumentation ([#6520](https://github.com/getsentry/sentry-react-native/pull/6520))
+  - `instrumentLangGraph` was renamed to `instrumentStateGraph` in the JavaScript SDK and is now deprecated. It stays exported for backwards compatibility and will be removed in the next major version.
+
 ### Internal
 
 - Migrate from `@sentry/babel-plugin-component-annotate` to `@sentry/bundler-plugins/babel-plugin` ([#6501](https://github.com/getsentry/sentry-react-native/pull/6501))

packages/core/etc/sentry-react-native.api.md

@@ -59,6 +59,7 @@ import { InstrumentedMethod } from '@sentry/core';
 import { instrumentGoogleGenAIClient } from '@sentry/core';
 import { instrumentLangGraph } from '@sentry/core';
 import { instrumentOpenAiClient } from '@sentry/core';
+import { instrumentStateGraph } from '@sentry/core';
 import { instrumentStateGraphCompile } from '@sentry/core';
 import { Integration } from '@sentry/core';
 import { LangChainIntegration } from '@sentry/core';
@@ -465,6 +466,8 @@ export { instrumentLangGraph }
 
 export { instrumentOpenAiClient }
 
+export { instrumentStateGraph }
+
 export { instrumentStateGraphCompile }
 
 export { LangChainIntegration }

packages/core/src/js/index.ts

@@ -54,11 +54,14 @@ export {
   instrumentAnthropicAiClient,
   instrumentGoogleGenAIClient,
   createLangChainCallbackHandler,
-  instrumentLangGraph,
+  instrumentStateGraph,
   instrumentStateGraphCompile,
   addConsoleInstrumentationFilter,
 } from '@sentry/core';
 
+/** @deprecated Use `instrumentStateGraph` instead. `instrumentLangGraph` will be removed in a future major version. */
+export { instrumentLangGraph } from '@sentry/core';
+
 export type {
   OpenAiClient,
   OpenAiOptions,

packages/core/test/aiExports.test.ts

@@ -6,9 +6,14 @@ describe('AI SDK manual instrumentation re-exports', () => {
     'instrumentAnthropicAiClient',
     'instrumentGoogleGenAIClient',
     'createLangChainCallbackHandler',
+    'instrumentStateGraph',
     'instrumentLangGraph',
     'instrumentStateGraphCompile',
   ])('re-exports %s from @sentry/core', name => {
     expect(typeof (Sentry as Record<string, unknown>)[name]).toBe('function');
   });
+
+  test('deprecated instrumentLangGraph is an alias of instrumentStateGraph', () => {
+    expect(Sentry.instrumentLangGraph).toBe(Sentry.instrumentStateGraph);
+  });
 });