import { getGlobalTelemetry } from '../telemetry/singleton.ts'

/**
 * Utility function to create descriptive errors with context
 */
export function createError(prefix: string, operation: string, details: string, originalError?: unknown): Error {
  let baseMessage = `${prefix} ${operation} failed: ${details}`

  // If there's an original error, append its message to provide full context
  if (originalError != null && originalError instanceof Error) {
    baseMessage = `${baseMessage} - ${originalError.message}`
  }
  let finalError: Error
  if (originalError != null) {
    finalError = new Error(baseMessage, { cause: originalError })
  } else {
    finalError = new Error(baseMessage)
  }

  // Capture to telemetry if enabled
  // Generic error handling of uncaught errors is [configured automatically by Sentry](https://docs.sentry.io/platforms/javascript/troubleshooting/#third-party-promise-libraries).
  getGlobalTelemetry()?.sentry?.captureException(finalError, {
    tags: { operation: `${prefix}.${operation}` },
    extra: {
      synapseErrorPrefix: prefix,
      synapseErrorOperation: operation,
      synapseErrorDetails: details,
      originalError,
    },
  })

  return finalError
}