type CloudErrorReporter struct {
	// contains filtered or unexported fields
}

type Config struct {
	// Sink is where to send reports. Required.
	Sink Sink

	// ServiceContext is information about the running service. Required.
	ServiceContext *ServiceContext

	// UserResolver returns a token identifying an effected user. Optional.
	UserResolver func(ctx context.Context) string

	// StacklessErrorsOnly instructs to only log errors that do not have a stack
	// trace explicitly attached to them.
	//
	// This is useful in GCP environments where errors with stack traces logged
	// to Cloud Logging are already automatically recognized by the Cloud Error
	// Reporting. If we report such an error explicitly, we will end up with
	// a duplicate report.
	//
	// Error-level log lines without a stack trace aren't recognized by the Cloud
	// Error Reporting log scraper. They will still be reported explicitly.
	StacklessErrorsOnly bool
}

type ErrorReport struct {
	// ServiceContext identifies the service, always set.
	ServiceContext *ServiceContext
	// RequestContext identifies the request, if any. Can be nil.
	RequestContext *RequestContext
	// User is a token used to count "affected users" in the aggregated reports.
	User string
	// Timestamp is when the error happened.
	Timestamp time.Time
	// Message is a human-readable error message.
	Message string
	// Stack is a stack trace to associated with the error message, always set.
	Stack string
}

type RequestContext struct {
	// HTTPMethod is e.g. "GET" or "POST".
	HTTPMethod string
	// URL is a request's URL string.
	URL string
	// UserAgent is taken from the request headers.
	UserAgent string
	// RemoteIP is the callers IP address.
	RemoteIP string
	// TraceID is a trace ID associated with this request.
	TraceID string
}

type ServiceContext struct {
	// Project is the cloud project name that hosts the service.
	Project string
	// Service is identifies of the service within the project.
	Service string
	// Version is the service's version string.
	Version string
}

type Sink interface {
	// ReportError asynchronously uploads the error report.
	ReportError(rep *ErrorReport)
}