feat(core): Deprecate span toContext() and updateWithContext()

These APIs are not really used, and are not compatible with OpenTelemetry. So let's deprecate them for removal in v8.

Author: mydea

packages/core/src/tracing/transaction.ts

@@ -149,6 +149,7 @@ export class Transaction extends SpanClass implements TransactionInterface {
    * @inheritDoc
    */
   public toContext(): TransactionContext {
+    // eslint-disable-next-line deprecation/deprecation
     const spanContext = super.toContext();
 
     return dropUndefinedKeys({
@@ -162,6 +163,7 @@ export class Transaction extends SpanClass implements TransactionInterface {
    * @inheritDoc
    */
   public updateWithContext(transactionContext: TransactionContext): this {
+     // eslint-disable-next-line deprecation/deprecation
     super.updateWithContext(transactionContext);
 
     this.name = transactionContext.name || '';

packages/tracing/test/span.test.ts

@@ -471,6 +471,7 @@ describe('Span', () => {
     });
   });
 
+  /* eslint-disable deprecation/deprecation */
   describe('toContext and updateWithContext', () => {
     test('toContext should return correct context', () => {
       const originalContext = { traceId: 'a', spanId: 'b', sampled: false, description: 'test', op: 'op' };
@@ -551,6 +552,7 @@ describe('Span', () => {
       expect(span.data).toStrictEqual({ data0: 'foo', data1: 'bar' });
     });
   });
+  /* eslint-enable deprecation/deprecation */
 
   describe('getDynamicSamplingContext', () => {
     beforeEach(() => {

packages/types/src/span.ts

@@ -221,10 +221,16 @@ export interface Span extends SpanContext {
   /** Return a traceparent compatible header string */
   toTraceparent(): string;
 
-  /** Returns the current span properties as a `SpanContext` */
+  /**
+   * Returns the current span properties as a `SpanContext`.
+   * @deprecated Use `toJSON()` or access the fields directly instead.
+   */
   toContext(): SpanContext;
 
-  /** Updates the current span with a new `SpanContext` */
+  /**
+   * Updates the current span with a new `SpanContext`.
+   * @deprecated Update the fields directly instead.
+   */
   updateWithContext(spanContext: SpanContext): this;
 
   /** Convert the object to JSON for w. spans array info only */

packages/types/src/transaction.ts

@@ -102,10 +102,16 @@ export interface Transaction extends TransactionContext, Omit<Span, 'setName' |
    */
   setMeasurement(name: string, value: number, unit: MeasurementUnit): void;
 
-  /** Returns the current transaction properties as a `TransactionContext` */
+  /**
+   * Returns the current transaction properties as a `TransactionContext`.
+   * @deprecated Use `toJSON()` or access the fields directly instead.
+   */
   toContext(): TransactionContext;
 
-  /** Updates the current transaction with a new `TransactionContext` */
+  /**
+   * Updates the current transaction with a new `TransactionContext`.
+   * @deprecated Update the fields directly instead.
+   */
   updateWithContext(transactionContext: TransactionContext): this;
 
   /**