type SlackHandlerOptions struct {
	// EnableAsync will execute the Handle() function in a separate goroutine.
	//
	// When async is enabled, you should be sure to call the Shutdown() function or use the slogx.Shutdown()
	// function to ensure all goroutines are finished and any pending records have been written.
	EnableAsync bool

	// HTTPClient allows for the use of a custom HTTP client for posting the webhook message.
	//
	// If nil, http.DefaultClient is used.
	HTTPClient *http.Client

	// Level is the minimum log level to write to the handler.
	//
	// By default, the level will be set to slog.LevelInfo if not supplied.
	Level slog.Leveler

	// RecordFormatter specifies the formatter to use to format the record before sending it to Slack.
	//
	// If no formatter is supplied, DefaultSlackMessageFormatter is used to format the output.
	RecordFormatter SlackMessageFormatter

	// WebhookURL is the Slack webhook URL to use in order to send the message.
	//
	// This is a required option.
	WebhookURL string
}

type SlackMessageFormatter interface {
	// FormatRecord should take the data from the record and format it as needed, storing it in the returned
	// webhook message.
	FormatRecord(context.Context, time.Time, slogx.Level, uintptr, string, []slog.Attr) (*slack.WebhookMessage, error)
}

type SlackMessageFormatterOptions struct {
	// ApplicationIconURL is a URL to an icon to display next to the application name in the output message.
	//
	// If this is empty, no icon is shown next to the application name.
	ApplicationIconURL string

	// ApplicationName is the name of the application to display above the message.
	//
	// If this is empty, no application name is shown.
	ApplicationName string

	// AttrFormatter is the middleware formatting function to call to format any attribute.
	//
	// Attribute values should be resolved by the handler before formatting. Any value returned by the formatter should
	// be resolved prior to return.
	//
	// If nil, attributes are simply printed unchanged.
	AttrFormatter formatter.FormatAttrFn

	// IgnoreAttrs is a list of regular expressions to use for matching attributes which should not be printed.
	//
	// Note that this only applies to attributes and not defined parts like the level, message, source or time.
	//
	// If any regular expression does not compile, it is simply ignored.
	IgnoreAttrs []string

	// IncludeAttrs indicates whether or not to include attributes in the Slack message.
	IncludeAttrs bool

	// IncludeSource indicates whether or not to include source file location information in the Slack mesage.
	IncludeSource bool

	// LevelFormatter is the middleware formatting function to call to format the level.
	//
	// If nil, the level is printed using FormatLevelValueDefault().
	LevelFormatter formatter.FormatLevelValueFn

	// MessageFormatter is the middlware formatting function to call to format the message.
	//
	// If nil, the message is printed as-is.
	MessageFormatter formatter.FormatMessageValueFn

	// SortAttrs indicates whether or not to sort the attributes alphabetically before adding them to the message.
	SortAttrs bool

	// SourcePrefix is the text to prefix the source information with in the output message.
	//
	// If this is empty, the default value of "Source:\t\t\t" is used.
	SourcePrefix string

	// SourceFormatter is the middleware formatting function to call to format the source code location where the record
	// was created.
	//
	// If nil, the source code location is printed using FormatSourceValueDefault().
	SourceFormatter formatter.FormatSourceValueFn

	// SpecificAttrFormatter is the middleware formatting function to call to format a specific attribute.
	//
	// The key for the map corresponds to the name of the specific attribute to format. If an attribute is nested within
	// a group, use a single period (.) to designate the group and attribute (eg: GROUP.ATTRIBUTE). Nested groups use
	// the same format (eg: GROUP1.GROUP2.ATTRIBUTE).
	//
	// Attribute values should be resolved by the handler before formatting. Any value returned by the formatter should
	// be resolved prior to return.
	//
	// If nil or if the attribute does not exist in the map, the default is to fall back to the AttrFormatter function.
	SpecificAttrFormatter map[string]formatter.FormatAttrFn

	// TimePrefix is the text to prefix the record timestamp with in the output message.
	//
	// If this is empty, the default value of "Occurred at:\t" is used.
	TimePrefix string

	// TimeFormatter is the middleware formatting function to call to the time of the record.
	//
	// If nil, the time is printed using FormatTimeValueDefault().
	TimeFormatter formatter.FormatTimeValueFn
}