ref(server-utils): Clarify API promise helper naming and references

Co-Authored-By: GPT-6 <codex@openai.com>

Author: nicohrubec

packages/server-utils/src/ai/core/apiPromise.ts

@@ -13,8 +13,9 @@ function isApiPromise(value: unknown): value is ApiPromise {
 // OpenAI and Anthropic return an APIPromise that extends the native promise objects and redefines .then() in a way that internally triggers body parsing.
 // This can lead to double parsing if our instrumentation triggers .then on this promise.
 // Instead, we need to avoid triggering .then on the APIPromise and instead observe the internal parsing process to get the response body.
-// APIPromise implementation: https://github.com/openai/openai-node/blob/main/src/core/api-promise.ts
-export function onApiPromiseResponse(
+// OpenAI APIPromise: https://github.com/openai/openai-node/blob/71d24120c4cc4e5897a767f16d25f2804fa4ad7c/src/core/api-promise.ts
+// Anthropic APIPromise: https://github.com/anthropics/anthropic-sdk-typescript/blob/d49bdab458000bcdffe77bd84b03293f31824fb3/src/core/api-promise.ts
+export function wrapApiPromiseResponse(
   result: unknown,
   onResponse: (response: unknown) => void,
   onError: (error: unknown) => void,

packages/server-utils/src/integrations/anthropic.ts

@@ -10,7 +10,7 @@ import {
   startInactiveSpan,
 } from '@sentry/core';
 import { getGenAiSpanOp, resolveAIRecordingOptions } from '../ai/core/utils';
-import { onApiPromiseResponse } from '../ai/core/apiPromise';
+import { wrapApiPromiseResponse } from '../ai/core/apiPromise';
 import { addPrivateRequestAttributes, addResponseAttributes, extractRequestAttributes } from '../ai/anthropic-ai';
 import { instrumentAsyncIterableStream, instrumentMessageStream } from '../ai/anthropic-ai/streaming';
 import type { AnthropicAiOptions, AnthropicAiResponse } from '../ai/anthropic-ai/types';
@@ -65,7 +65,7 @@ function instrumentAnthropic(options: AnthropicAiOptions): void {
           );
         },
         deferSpanEnd: ({ span, data, end }) =>
-          onApiPromiseResponse(
+          wrapApiPromiseResponse(
             data.result,
             response => {
               data.result = response;

packages/server-utils/src/integrations/openai-compatible.ts

@@ -9,7 +9,7 @@ import {
 } from '@sentry/core';
 import { GEN_AI_PROVIDER_NAME } from '@sentry/conventions/attributes';
 import { getGenAiSpanOp, resolveAIRecordingOptions } from '../ai/core/utils';
-import { onApiPromiseResponse } from '../ai/core/apiPromise';
+import { wrapApiPromiseResponse } from '../ai/core/apiPromise';
 import { addRequestAttributes, extractRequestAttributes } from '../ai/openai';
 import { instrumentStream } from '../ai/openai/streaming';
 import type { OpenAiOptions } from '../ai/openai/types';
@@ -68,7 +68,7 @@ export function createOpenAiCompatibleIntegration<T extends OpenAiCompatibleProv
             addResponseAttributes(span, data.result, resolveAIRecordingOptions(options).recordOutputs);
           },
           deferSpanEnd: ({ span, data, end }) =>
-            onApiPromiseResponse(
+            wrapApiPromiseResponse(
               data.result,
               response => {
                 data.result = response;

packages/server-utils/src/integrations/openai.ts

@@ -10,7 +10,7 @@ import {
 } from '@sentry/core';
 import { getGenAiSpanOp, resolveAIRecordingOptions } from '../ai/core/utils';
 import { addRequestAttributes, extractRequestAttributes } from '../ai/openai';
-import { onApiPromiseResponse } from '../ai/core/apiPromise';
+import { wrapApiPromiseResponse } from '../ai/core/apiPromise';
 import { instrumentStream } from '../ai/openai/streaming';
 import type { OpenAiOptions } from '../ai/openai/types';
 import { addResponseAttributes } from '../ai/openai/utils';
@@ -60,7 +60,7 @@ function instrumentOpenai(options: OpenAiOptions): void {
           addResponseAttributes(span, data.result, resolveAIRecordingOptions(options).recordOutputs);
         },
         deferSpanEnd: ({ span, data, end }) =>
-          onApiPromiseResponse(
+          wrapApiPromiseResponse(
             data.result,
             response => {
               data.result = response;