feat(utils/core): Deprecate addRequestDataToEvent and extractRequestData (#14430)

Author: Luca Forstner

docs/migration/draft-v9-migration-guide.md

@@ -11,6 +11,8 @@
 - Deprecated `TransactionNamingScheme` type.
 - Deprecated `validSeverityLevels`. Will not be replaced.
 - Deprecated `urlEncode`. No replacements.
+- Deprecated `addRequestDataToEvent`. Use `addNormalizedRequestDataToEvent` instead.
+- Deprecated `extractRequestData`. Instead manually extract relevant data off request.
 - Deprecated `arrayify`. No replacements.
 
 ## `@sentry/core`

packages/astro/src/index.server.ts

@@ -12,6 +12,7 @@ export {
   addEventProcessor,
   addIntegration,
   addOpenTelemetryInstrumentation,
+  // eslint-disable-next-line deprecation/deprecation
   addRequestDataToEvent,
   amqplibIntegration,
   anrIntegration,
@@ -39,6 +40,7 @@ export {
   endSession,
   expressErrorHandler,
   expressIntegration,
+  // eslint-disable-next-line deprecation/deprecation
   extractRequestData,
   extraErrorDataIntegration,
   fastifyIntegration,

packages/aws-serverless/src/index.ts

@@ -42,8 +42,10 @@ export {
   flush,
   close,
   getSentryRelease,
+  // eslint-disable-next-line deprecation/deprecation
   addRequestDataToEvent,
   DEFAULT_USER_INCLUDES,
+  // eslint-disable-next-line deprecation/deprecation
   extractRequestData,
   createGetModuleFromFilename,
   anrIntegration,

packages/bun/src/index.ts

@@ -64,8 +64,10 @@ export {
   flush,
   close,
   getSentryRelease,
+  // eslint-disable-next-line deprecation/deprecation
   addRequestDataToEvent,
   DEFAULT_USER_INCLUDES,
+  // eslint-disable-next-line deprecation/deprecation
   extractRequestData,
   createGetModuleFromFilename,
   anrIntegration,

packages/core/src/integrations/requestdata.ts

@@ -98,6 +98,7 @@ const _requestDataIntegration = ((options: RequestDataIntegrationOptions = {}) =
         return event;
       }
 
+      // eslint-disable-next-line deprecation/deprecation
       return addRequestDataToEvent(event, request, addRequestDataOptions);
     },
   };

packages/core/src/utils-hoist/index.ts

@@ -69,9 +69,11 @@ export type { PromiseBuffer } from './promisebuffer';
 export {
   DEFAULT_USER_INCLUDES,
   addNormalizedRequestDataToEvent,
+  // eslint-disable-next-line deprecation/deprecation
   addRequestDataToEvent,
   // eslint-disable-next-line deprecation/deprecation
   extractPathForTransaction,
+  // eslint-disable-next-line deprecation/deprecation
   extractRequestData,
   winterCGHeadersToDict,
   winterCGRequestToRequestData,

packages/core/src/utils-hoist/requestdata.ts

@@ -134,6 +134,8 @@ function extractUserData(
  * DEFAULT_REQUEST_INCLUDES if not provided.
  * @param options.deps Injected, platform-specific dependencies
  * @returns An object containing normalized request data
+ *
+ * @deprecated Instead manually normalize the request data into a format that fits `addNormalizedRequestDataToEvent`.
  */
 export function extractRequestData(
   req: PolymorphicRequest,
@@ -318,6 +320,8 @@ export function addNormalizedRequestDataToEvent(
  * @param options.include Flags to control what data is included
  * @param options.deps Injected platform-specific dependencies
  * @returns The mutated `Event` object
+ *
+ * @deprecated Use `addNormalizedRequestDataToEvent` instead.
  */
 export function addRequestDataToEvent(
   event: Event,
@@ -335,6 +339,7 @@ export function addRequestDataToEvent(
       includeRequest.push('ip');
     }
 
+    // eslint-disable-next-line deprecation/deprecation
     const extractedRequestData = extractRequestData(req, { include: includeRequest });
 
     event.request = {

packages/core/test/utils-hoist/requestdata.test.ts

@@ -1,3 +1,4 @@
+/* eslint-disable deprecation/deprecation */
 import type * as net from 'net';
 import { addRequestDataToEvent, extractPathForTransaction, extractRequestData } from '@sentry/core';
 import type { Event, PolymorphicRequest, TransactionSource, User } from '@sentry/types';

packages/google-cloud-serverless/src/index.ts

@@ -42,8 +42,10 @@ export {
   flush,
   close,
   getSentryRelease,
+  // eslint-disable-next-line deprecation/deprecation
   addRequestDataToEvent,
   DEFAULT_USER_INCLUDES,
+  // eslint-disable-next-line deprecation/deprecation
   extractRequestData,
   createGetModuleFromFilename,
   anrIntegration,

packages/node/src/index.ts

@@ -57,6 +57,7 @@ export { cron } from './cron';
 
 export type { NodeOptions } from './types';
 
+// eslint-disable-next-line deprecation/deprecation
 export { addRequestDataToEvent, DEFAULT_USER_INCLUDES, extractRequestData } from '@sentry/core';
 
 export {