Support Capturing Event with EventHint

[MatsuoTakuro]

Problem Statement

Currently, the Hub does not expose a public method like:

hub.CaptureEventWithHint(event *Event, hint *EventHint)
// or
hub.CaptureEventWithOriginalError(event *Event, originalError error)

However, In SentryHandler.Handle, we wanna:

1. Capture slog attributes as part of the event.
2. Attach an original error in EventHint.OriginalException.

Without the above public method, we are now forced to call either:

• hub.CaptureException(err) – Loses slog attributes.
• hub.CaptureEvent(event) – Cannot attach EventHint.OriginalException for the BeforeSend callback func.
  • Our project usually edits an event in the callback func, depending on the underlying error type.

Solution Brainstorm

Introduce a new public method in Hub like this:

func (hub *Hub) CaptureEventWithHint(event *Event, hint *sentry.EventHint) *EventID {
    client, scope := hub.Client(), hub.Scope()
    if client == nil || scope == nil {
        return nil
    }

    // Capture the event with hint
    eventID := client.CaptureEvent(event, hint, scope)

    if eventID != nil {
        hub.mu.Lock()
        hub.lastEventID = *eventID
        hub.mu.Unlock()
    }
    return eventID
}

// or

func (hub *Hub) CaptureEventWithOriginalError(event *Event, err error) *EventID {
    client, scope := hub.Client(), hub.Scope()
    if client == nil || scope == nil {
        return nil
    }

    // Create hint with original error
    var hint *sentry.EventHint
    if err != nil {
        hint = &sentry.EventHint{OriginalException: err}
    }

    // Capture the event with hint
    eventID := client.CaptureEvent(event, hint, scope)

    if eventID != nil {
        hub.mu.Lock()
        hub.lastEventID = *eventID
        hub.mu.Unlock()
    }
    return eventID
}