@mwcp/otel/src/lib/decorator.trace-log/trace-log.helper.async.ts

midway component for open telemetry

import assert from 'node:assert'

import { context } from '@opentelemetry/api'

import { processDecoratorBeforeAfterAsync } from '../decorator.helper.async.js'
import { endTraceSpan } from '../trace.helper.js'
import type { DecoratorExecutorParam, DecoratorTraceDataResp } from '../trace.service/index.trace.service.js'
import { ConfigKey } from '../types.js'


export async function beforeAsync(options: DecoratorExecutorParam): Promise<void> {
  const { traceService } = options

  const type = 'before'
  if (! options.traceContext || ! options.span) {
    const info = traceService.getActiveTraceInfo()
    options.span = info.span
    options.traceContext = info.traceContext
  }

  await context.with(options.traceContext, async () => {
    const res: DecoratorTraceDataResp = await processDecoratorBeforeAfterAsync(type, options)
    if (res?.endSpanAfterTraceLog) {
      assert(options.span, 'span is required')
      if (Array.isArray(res.endSpanAfterTraceLog)) {
        endTraceSpan(traceService, res.endSpanAfterTraceLog, res.spanStatusOptions)
      }
      else {
        endTraceSpan(traceService, [options.span], res.spanStatusOptions)
      }
    }
  })
}

export async function afterReturnAsync(options: DecoratorExecutorParam): Promise<unknown> {
  const { span, traceService } = options
  /* c8 ignore next 3 */
  if (! span) {
    return options.methodResult
  }

  assert(! options.error, `[@mwcp/${ConfigKey.namespace}] options.error is not undefined in afterReturnAsync().
  Error: ${options.error?.message}`)

  if (! options.traceContext || ! options.span) {
    const info = traceService.getActiveTraceInfo()
    options.span = info.span
    options.traceContext = info.traceContext
  }
  await context.with(options.traceContext, async () => {
    const res: DecoratorTraceDataResp = await processDecoratorBeforeAfterAsync('after', options)
    if (res?.endSpanAfterTraceLog) {
      if (Array.isArray(res.endSpanAfterTraceLog)) {
        endTraceSpan(traceService, res.endSpanAfterTraceLog, res.spanStatusOptions)
      }
      else {
        endTraceSpan(traceService, [span], res.spanStatusOptions)
      }
    }
  })

  return options.methodResult
}

export async function afterThrowAsync(options: DecoratorExecutorParam): Promise<void> {
  const { span } = options
  if (! span) { return }

  assert(options.error, `[@mwcp/${ConfigKey.namespace}] options.error is undefined in afterThrowAsync().`)
  const traceContext = options.traceContext ?? options.traceService.getActiveContext()
  await context.with(traceContext, async () => {
    await processDecoratorBeforeAfterAsync('afterThrow', options)
  })
}