feat: add tracer.startActiveSpan()

Signed-off-by: naseemkullah <naseem@transit.app>

Author: naseemkullah

src/trace/tracer.ts

@@ -37,4 +37,34 @@ export interface Tracer {
    *     span.end();
    */
   startSpan(name: string, options?: SpanOptions, context?: Context): Span;
+
+  /**
+   * Starts a new {@link Span} and activates it in the current Context.
+   *
+   * @param name The name of the span
+   * @param [options] SpanOptions used for span creation
+   * @param [context] Context to use to extract parent
+   * @param callback called in the context of the span and receives the newly created span as an argument
+   * @returns what is returned by the callback
+   * @example
+   *   const span = tracer.startActiveSpan('op', {}, undefined, (err, span) => {
+   *     span.setAttribute('key', 'value');
+   *     span.end();
+   *   });
+   */
+  startActiveSpan<F extends (err: Error, span: Span) => ReturnType<F>>(
+    name: string,
+    callback: F
+  ): ReturnType<F>;
+  startActiveSpan<F extends (err: Error, span: Span) => ReturnType<F>>(
+    name: string,
+    options: SpanOptions,
+    callback: F
+  ): ReturnType<F>;
+  startActiveSpan<F extends (err: Error, span: Span) => ReturnType<F>>(
+    name: string,
+    options: SpanOptions,
+    context: Context,
+    callback: F
+  ): ReturnType<F>;
 }