client

type Auth interface {
	// List all authorizations for this API key in this team and environment.
	List(ctx context.Context) (AuthMetadata, error)
}

type AuthMetadata struct {
	// Authorizations granted to this API key.
	APIKeyAccess struct {
		Boards         bool `json:"boards"`
		Columns        bool `json:"columns"`
		CreateDatasets bool `json:"create_datasets"`
		Events         bool `json:"events"`
		Markers        bool `json:"markers"`
		Queries        bool `json:"queries"`
		Recipients     bool `json:"recipients"`
		SLOs           bool `json:"slos"`
		Triggers       bool `json:"triggers"`
	} `json:"api_key_access"`
	Environment struct {
		// Name is empty for Classic environments.
		Name string `json:"name"`
		// Slug is empty for Classic environments.
		Slug string `json:"slug"`
	} `json:"environment"`
	Team struct {
		Name string `json:"name"`
		Slug string `json:"slug"`
	} `json:"team"`
}

type Board struct {
	ID string `json:"id,omitempty"`

	// Name of the board, this is displayed in the Honeycomb UI. This field is
	// required.
	Name string `json:"name"`
	// Description of the board.
	Description string `json:"description,omitempty"`
	// The number of columns to be laid out when displaying the board.
	// Defaults to "multi".
	//
	// n.b. 'list' style boards cannot specify a column layout
	ColumnLayout BoardColumnStyle `json:"column_layout,omitempty"`
	// How the board should be displayed in the UI, defaults to "visual".
	// Deprecated: All Boards are visual now. This field is ignored.
	Style BoardStyle `json:"style,omitempty"`
	// Links returned by the board API for the Board
	Links BoardLinks `json:"links,omitempty"`
	// A list of queries displayed on the board, in order of appearance.
	Queries []BoardQuery `json:"queries"`
}

type BoardColumnStyle string

type BoardGraphSettings struct {
	OmitMissingValues    bool `json:"omit_missing_values"`
	UseStackedGraphs     bool `json:"stacked_graphs"`
	UseLogScale          bool `json:"log_scale"`
	UseUTCXAxis          bool `json:"utc_xaxis"`
	HideMarkers          bool `json:"hide_markers"`
	PreferOverlaidCharts bool `json:"overlaid_charts"`
}

type BoardLinks struct {
	// URL For accessing the board
	BoardURL string `json:"board_url,omitempty"`
}

type BoardQuery struct {
	Caption string `json:"caption,omitempty"`
	// Defaults to graph.
	QueryStyle BoardQueryStyle `json:"query_style,omitempty"`
	// Dataset is no longer required
	Dataset string `json:"dataset,omitempty"`
	// QueryID is required
	QueryID string `json:"query_id,omitempty"`
	// Optional
	QueryAnnotationID string `json:"query_annotation_id,omitempty"`
	// Optional
	GraphSettings BoardGraphSettings `json:"graph_settings"`
}

type BoardQueryStyle string

type BoardStyle string

type Boards interface {
	// List all boards.
	List(ctx context.Context) ([]Board, error)

	// Get a board by its ID.
	Get(ctx context.Context, id string) (*Board, error)

	// Create a new board. When creating a new board ID may not be set.
	Create(ctx context.Context, b *Board) (*Board, error)

	// Update an existing board.
	Update(ctx context.Context, b *Board) (*Board, error)

	// Delete a board.
	Delete(ctx context.Context, id string) error
}

type BurnAlert struct {
	ID                                    string                  `json:"id,omitempty"`
	AlertType                             BurnAlertAlertType      `json:"alert_type"`
	ExhaustionMinutes                     *int                    `json:"exhaustion_minutes,omitempty"`
	BudgetRateWindowMinutes               *int                    `json:"budget_rate_window_minutes,omitempty"`
	BudgetRateDecreaseThresholdPerMillion *int                    `json:"budget_rate_decrease_threshold_per_million,omitempty"`
	SLO                                   SLORef                  `json:"slo"`
	CreatedAt                             time.Time               `json:"created_at,omitempty"`
	UpdatedAt                             time.Time               `json:"updated_at,omitempty"`
	Recipients                            []NotificationRecipient `json:"recipients,omitempty"`
}

type BurnAlertAlertType string

type BurnAlerts interface {
	// List all BurnAlerts associated with a SLO.
	ListForSLO(ctx context.Context, dataset string, sloId string) ([]BurnAlert, error)

	// Get a BurnAlert by its ID.
	Get(ctx context.Context, dataset string, id string) (*BurnAlert, error)

	// Create a new BurnAlert on a SLO. When creating a BurnAlert ID may not
	// be set.
	Create(ctx context.Context, dataset string, s *BurnAlert) (*BurnAlert, error)

	// Update an existing BurnAlert.
	Update(ctx context.Context, dataset string, s *BurnAlert) (*BurnAlert, error)

	// Delete a BurnAlert from a dataset.
	Delete(ctx context.Context, dataset string, id string) error
}

type CalculationOp string

type CalculationSpec struct {
	Op CalculationOp `json:"op"`
	// Column to perform the operation on. Not needed with COUNT or CONCURRENCY
	Column *string `json:"column,omitempty"`
}

type Client struct {
	Auth               Auth
	Boards             Boards
	Columns            Columns
	Datasets           Datasets
	DatasetDefinitions DatasetDefinitions
	DerivedColumns     DerivedColumns
	Markers            Markers
	MarkerSettings     MarkerSettings
	Queries            Queries
	QueryAnnotations   QueryAnnotations
	QueryResults       QueryResults
	Triggers           Triggers
	SLOs               SLOs
	BurnAlerts         BurnAlerts
	Recipients         Recipients
	// contains filtered or unexported fields
}

type Column struct {
	ID string `json:"id,omitempty"`

	// Name of the column, this field is required.
	KeyName string `json:"key_name"`
	// Deprecated, optional.
	Alias string `json:"alias,omitempty"`
	// Optional, defaults to false.
	Hidden *bool `json:"hidden,omitempty"`
	// Optional.
	Description string `json:"description,omitempty"`
	// Optional, defaults to string.
	Type *ColumnType `json:"type,omitempty"`

	// Read only
	LastWrittenAt time.Time `json:"last_written,omitempty"`
	CreatedAt     time.Time `json:"created_at,omitempty"`
	UpdatedAt     time.Time `json:"updated_at,omitempty"`
}

type ColumnType string

type Columns interface {
	// List all columns in this dataset.
	List(ctx context.Context, dataset string) ([]Column, error)

	// Get a column by its ID.
	Get(ctx context.Context, dataset string, id string) (*Column, error)

	// GetByKeyName searches a column by its key name.
	GetByKeyName(ctx context.Context, dataset string, keyName string) (*Column, error)

	// Create a new column in this dataset. When creating a new column ID may
	// not be set. The KeyName must be unique for this dataset.
	Create(ctx context.Context, dataset string, c *Column) (*Column, error)

	// Update an existing column.
	Update(ctx context.Context, dataset string, c *Column) (*Column, error)

	// Delete a column.
	Delete(ctx context.Context, dataset string, id string) error
}

type Config struct {
	// Required - the API key to use when sending request to Honeycomb.
	APIKey string
	// URL of the Honeycomb API, defaults to "https://api.honeycomb.io".
	APIUrl string
	// With debug enabled the client will log all requests and responses.
	Debug bool
	// Optionally override the HTTP client with a custom client.
	HTTPClient *http.Client
	// Optionally set the user agent to send with all requests, defaults to "go-honeycombio".
	UserAgent string
}

type Dataset struct {
	Name            string `json:"name"`
	Description     string `json:"description,omitempty"`
	Slug            string `json:"slug,omitempty"`
	ExpandJSONDepth int    `json:"expand_json_depth,omitempty"`
	// Read only
	LastWrittenAt time.Time `json:"last_written_at,omitempty"`
	CreatedAt     time.Time `json:"created_at,omitempty"`
}

type DatasetDefinition struct {
	DurationMs     *DefinitionColumn `json:"duration_ms,omitempty"`
	Error          *DefinitionColumn `json:"error,omitempty"`
	Name           *DefinitionColumn `json:"name,omitempty"`
	ParentID       *DefinitionColumn `json:"parent_id,omitempty"`
	Route          *DefinitionColumn `json:"route,omitempty"`
	ServiceName    *DefinitionColumn `json:"service_name,omitempty"`
	SpanID         *DefinitionColumn `json:"span_id,omitempty"`
	SpanKind       *DefinitionColumn `json:"span_kind,omitempty"`
	AnnotationType *DefinitionColumn `json:"annotation_type,omitempty"`
	LinkTraceID    *DefinitionColumn `json:"link_trace_id,omitempty"`
	LinkSpanID     *DefinitionColumn `json:"link_span_id,omitempty"`
	Status         *DefinitionColumn `json:"status,omitempty"`
	TraceID        *DefinitionColumn `json:"trace_id,omitempty"`
	User           *DefinitionColumn `json:"user,omitempty"`
}

type DatasetDefinitions interface {
	// Get the Dataset Definitions for a Dataset
	Get(ctx context.Context, dataset string) (*DatasetDefinition, error)

	// Resets the Dataset Definitions for a Dataset to the default state
	ResetAll(ctx context.Context, dataset string) error

	// Update the Dataset Definitions in a Dataset
	Update(ctx context.Context, dataset string, d *DatasetDefinition) (*DatasetDefinition, error)
}

type Datasets interface {
	// List all datasets.
	List(ctx context.Context) ([]Dataset, error)

	// Get a dataset by its slug.
	Get(ctx context.Context, slug string) (*Dataset, error)

	// Create a new dataset. Only name should be set when creating a dataset,
	// all other fields are ignored.
	Create(ctx context.Context, dataset *Dataset) (*Dataset, error)

	// Update an existing dataset. Missing (optional) fields will set to their
	// respective defaults and not the currently existing values.
	Update(ctx context.Context, dataset *Dataset) (*Dataset, error)
}

type DefinitionColumn struct {
	Name       string `json:"name"`
	ColumnType string `json:"column_type,omitempty"`
}

type DerivedColumn struct {
	ID string `json:"id,omitempty"`
	// Alias of the derived column, this field is required and can not be
	// updated.
	Alias string `json:"alias"`
	// Expression of the derived column, this field is required.
	// This should be an expression following the Derived Column syntax, as
	// described on https://docs.honeycomb.io/working-with-your-data/customizing-your-query/derived-columns/#derived-column-syntax
	Expression string `json:"expression"`
	// Optional.
	Description string `json:"description,omitempty"`
}

type DerivedColumns interface {
	// List all derived columns in this dataset.
	List(ctx context.Context, dataset string) ([]DerivedColumn, error)

	// Get a derived column by its ID.
	Get(ctx context.Context, dataset string, id string) (*DerivedColumn, error)

	// GetByAlias searches a derived column by its alias.
	GetByAlias(ctx context.Context, dataset string, alias string) (*DerivedColumn, error)

	// Create a new derived column in this dataset. When creating a new derived
	// column ID may not be set. The Alias must be unique for this dataset.
	Create(ctx context.Context, dataset string, d *DerivedColumn) (*DerivedColumn, error)

	// Update an existing derived column.
	Update(ctx context.Context, dataset string, d *DerivedColumn) (*DerivedColumn, error)

	// Delete a derived column.
	Delete(ctx context.Context, dataset string, id string) error
}

type DetailedError struct {
	// The HTTP status code of the error.
	Status int `json:"status,omitempty"`
	// The error message
	Message string `json:"error,omitempty"`
	// Type is a URI used to uniquely identify the type of error.
	Type string `json:"type,omitempty"`
	// Title is a human-readable summary that explains the type of the problem.
	Title string `json:"title,omitempty"`
	// Details is an array of structured objects that give details about the error.
	Details []ErrorTypeDetail `json:"type_detail,omitempty"`
}

type ErrorTypeDetail struct {
	Code        string `json:"code"`
	Description string `json:"description"`
	Field       string `json:"field"`
}

type FilterCombination string

type FilterOp string

type FilterSpec struct {
	Column string   `json:"column"`
	Op     FilterOp `json:"op"`
	// Value to use with the filter operation. The type of the filter value
	// depends on the operator:
	//  - 'exists' and 'does-not-exist': value should be nil
	//  - 'in' and 'not-in': value should be a []string
	//  - all other ops: value could be a string, int, bool or float
	Value interface{} `json:"value,omitempty"`
}

type HavingOp string

type HavingSpec struct {
	CalculateOp *CalculationOp `json:"calculate_op,omitempty"`
	Column      *string        `json:"column,omitempty"`
	Op          *HavingOp      `json:"op,omitempty"`
	Value       interface{}    `json:"value,omitempty"`
}

type Marker struct {
	ID string `json:"id,omitempty"`

	// The time the marker should be placed at, in Unix Time (= seconds since
	// epoch). If not set this will be set to when the request was received by
	// the API.
	StartTime int64 `json:"start_time,omitempty"`
	// The end time of the marker, in Unix Time (= seconds since epoch). This
	// can be used to indicate a time range. This field is optional.
	EndTime int64 `json:"end_time,omitempty"`
	// Message appears above the marker and can be used to desribe the marker.
	// This field is optional.
	Message string `json:"message,omitempty"`
	// Type is an optional marker identifier, eg 'deploy' or 'chef-run'. This
	// field is optional.
	Type string `json:"type,omitempty"`
	// URL is an optional url associated with the marker. This field is optional.
	URL string `json:"url,omitempty"`

	// Time the marker was created. This field is set by the API.
	CreatedAt *time.Time `json:"created_at,omitempty"`
	// Time the marker was last modified. This field is set by the API.
	UpdatedAt *time.Time `json:"updated_at,omitempty"`
	// Color of the marker. Colors are configured per dataset and can be set
	// per type of marker. This field is set by the API.
	Color string `json:"color,omitempty"`
}

type MarkerSetting struct {
	// Unique identifier of a marker setting. This field is set by the API.
	ID string `json:"id,omitempty"`

	// Type is a required marker setting identifier, eg 'deploy'.
	Type string `json:"type,omitempty"`

	// Color of the marker setting. Colors are configured per dataset and can be set per type of marker.
	Color string `json:"color,omitempty"`

	// Time the marker setting was created. This field is set by the API.
	CreatedAt *time.Time `json:"created_at,omitempty"`
	// Time the marker setting was last modified. This field is set by the API.
	UpdatedAt *time.Time `json:"updated_at,omitempty"`
}

type MarkerSettings interface {
	// List all marker settings present in this dataset.
	List(ctx context.Context, dataset string) ([]MarkerSetting, error)

	// Get a marker setting by its ID.
	//
	// This method calls List internally since there is no API available to
	// directly get a single marker setting.
	Get(ctx context.Context, dataset string, id string) (*MarkerSetting, error)

	// Create a new marker setting in this dataset.
	Create(ctx context.Context, dataset string, m *MarkerSetting) (*MarkerSetting, error)

	// Update an existing marker setting.
	Update(ctx context.Context, dataset string, m *MarkerSetting) (*MarkerSetting, error)

	// Delete a marker setting from the dataset.
	Delete(ctx context.Context, dataset string, id string) error
}

type Markers interface {
	// List all markers present in this dataset.
	List(ctx context.Context, dataset string) ([]Marker, error)

	// Get a marker by its ID.
	//
	// This method calls List internally since there is no API available to
	// directly get a single marker.
	Get(ctx context.Context, dataset string, id string) (*Marker, error)

	// Create a new marker in this dataset. When creating a marker ID may not
	// be set.
	Create(ctx context.Context, dataset string, m *Marker) (*Marker, error)

	// Update an existing marker.
	Update(ctx context.Context, dataset string, m *Marker) (*Marker, error)

	// Delete a marker from the dataset.
	Delete(ctx context.Context, dataset string, id string) error
}

type NotificationRecipient struct {
	ID      string                        `json:"id,omitempty"`
	Type    RecipientType                 `json:"type"`
	Details *NotificationRecipientDetails `json:"details,omitempty"`
	Target  string                        `json:"target,omitempty"`
}

type NotificationRecipientDetails struct {
	PDSeverity PagerDutySeverity `json:"pagerduty_severity,omitempty"`
}

type OrderSpec struct {
	Op     *CalculationOp `json:"op,omitempty"`
	Column *string        `json:"column,omitempty"`
	Order  *SortOrder     `json:"order,omitempty"`
}

type PagerDutySeverity string

type Queries interface {
	// Get a query by its ID.
	Get(ctx context.Context, dataset string, id string) (*QuerySpec, error)

	// Create a new query in this dataset. When creating a new query ID may
	// not be set.
	Create(ctx context.Context, dataset string, c *QuerySpec) (*QuerySpec, error)
}

type QueryAnnotation struct {
	ID string `json:"id,omitempty"`

	Name        string `json:"name"`
	Description string `json:"description"`
	QueryID     string `json:"query_id"`

	CreatedAt *time.Time `json:"created-at,omitempty"`
	UpdatedAt *time.Time `json:"updated-at,omitempty"`
}

type QueryAnnotations interface {
	// List all query annotations.
	List(ctx context.Context, dataset string) ([]QueryAnnotation, error)

	// Get a query annotation by its ID.
	Get(ctx context.Context, dataset string, id string) (*QueryAnnotation, error)

	// Create a new query annotation. When creating a new query annotation ID
	// may not be set.
	Create(ctx context.Context, dataset string, b *QueryAnnotation) (*QueryAnnotation, error)

	// Update an existing query annotation.
	Update(ctx context.Context, dataset string, b *QueryAnnotation) (*QueryAnnotation, error)

	// Delete a query annotation.
	Delete(ctx context.Context, dataset string, id string) error
}

type QueryResult struct {
	// ID of a query result is only set when the query is returned from the
	// Query Result API. This value should not be set when creating queries results.
	ID string `json:"id"`

	// True once the query has completed and the results are populated.
	Complete bool `json:"complete"`

	// The resulting data of the query
	Data QueryResultData `json:"data,omitempty"`

	// Permalinks to the query results
	Links QueryResultLinks `json:"links,omitempty"`
}

type QueryResultData struct {
	Series []struct {
		Time time.Time              `json:"time"`
		Data map[string]interface{} `json:"data"`
	} `json:"series"`
	Results []struct {
		Data map[string]interface{} `json:"data"`
	} `json:"results"`
}

type QueryResultLinks struct {
	Url      string `json:"query_url"`
	GraphUrl string `json:"graph_image_url"`
}

type QueryResultRequest struct {
	ID string `json:"query_id"`
}

type QueryResults interface {
	// Get the query results by ID.
	Get(ctx context.Context, dataset string, q *QueryResult) error

	// Create a new query result with a given query specification.
	Create(ctx context.Context, dataset string, data *QueryResultRequest) (*QueryResult, error)
}

type QuerySpec struct {
	// ID of a query is only set when QuerySpec is returned from the Queries
	// API. This value should not be set when creating or updating queries.
	ID *string `json:"id,omitempty"`

	// The calculations to return as a time series and summary table. If no
	// calculations are provided, COUNT is applied.
	Calculations []CalculationSpec `json:"calculations,omitempty"`
	// The filters with which to restrict the considered events.
	Filters []FilterSpec `json:"filters,omitempty"`
	// If multiple filters are specified, filter_combination determines how
	// they are applied. Defaults to AND.
	//
	// From experience it seems the API will never answer with AND, instead
	// always omitting the filter combination field entirely.
	FilterCombination FilterCombination `json:"filter_combination,omitempty"`
	// A list of strings describing the columns by which to break events down
	// into groups.
	Breakdowns []string `json:"breakdowns,omitempty"`
	// A list of objects describing the terms on which to order the query
	// results. Each term must appear in either the breakdowns field or the
	// calculations field.
	Orders []OrderSpec `json:"orders,omitempty"`
	// A list of objects describing filters with which to restrict returned
	// groups. Each column/calculate_op pair must appear in the calculations
	// field. There can be multiple havings for the same column/calculate_op
	// pair.
	Havings []HavingSpec `json:"havings,omitempty"`
	// The maximum number of query results, must be between 1 and 1000.
	Limit *int `json:"limit,omitempty"`
	// The time range of query in seconds. Defaults to two hours. If combined
	// with start time or end time, this time range is added after start time
	// or before end time. Cannot be combined with both start time and end time.
	//
	// For more details, check https://docs.honeycomb.io/api/query-specification/#a-caveat-on-time
	TimeRange *int `json:"time_range,omitempty"`
	// The absolute start time of the query, in Unix Time (= seconds since epoch).
	StartTime *int64 `json:"start_time,omitempty"`
	// The absolute end time of the query, in Unix Time (= seconds since epoch).
	EndTime *int64 `json:"end_time,omitempty"`
	// The time resolution of the query’s graph, in seconds. Valid values are
	// the query’s time range /10 at maximum, and /1000 at minimum.
	Granularity *int `json:"granularity,omitempty"`
}

type Recipient struct {
	ID        string           `json:"id,omitempty"`
	Type      RecipientType    `json:"type"`
	Details   RecipientDetails `json:"details"`
	CreatedAt time.Time        `json:"created_at,omitempty"`
	UpdatedAt time.Time        `json:"updated_at,omitempty"`
}

type RecipientDetails struct {
	// email
	EmailAddress string `json:"email_address,omitempty"`
	// marker
	MarkerID string `json:"marker_id,omitempty"`
	// pagerduty
	PDIntegrationKey  string `json:"pagerduty_integration_key,omitempty"`
	PDIntegrationName string `json:"pagerduty_integration_name,omitempty"`
	// slack
	SlackChannel string `json:"slack_channel,omitempty"`
	// webhook or msteams
	WebhookName string `json:"webhook_name,omitempty"`
	WebhookURL  string `json:"webhook_url,omitempty"`
	// webhook only
	WebhookSecret string `json:"webhook_secret,omitempty"`
}

type RecipientType string

type Recipients interface {
	// List all Recipients
	List(ctx context.Context) ([]Recipient, error)

	// Get a Recipient by its ID.
	Get(ctx context.Context, id string) (*Recipient, error)

	// Create a new Recipient. When creating a new Recipient ID must not be set.
	Create(ctx context.Context, r *Recipient) (*Recipient, error)

	// Update an existing Recipient.
	Update(ctx context.Context, r *Recipient) (*Recipient, error)

	// Delete a Recipient
	Delete(ctx context.Context, id string) error
}

type SLIRef struct {
	Alias string `json:"alias"`
}

type SLO struct {
	ID               string    `json:"id,omitempty"`
	Name             string    `json:"name"`
	Description      string    `json:"description,omitempty"`
	TimePeriodDays   int       `json:"time_period_days"`
	TargetPerMillion int       `json:"target_per_million"`
	SLI              SLIRef    `json:"sli"`
	CreatedAt        time.Time `json:"created_at,omitempty"`
	UpdatedAt        time.Time `json:"updated_at,omitempty"`
}

type SLORef struct {
	ID string `json:"id"`
}

type SLOs interface {
	// List all SLOs present in this dataset.
	List(ctx context.Context, dataset string) ([]SLO, error)

	// Get a SLO by its ID.
	Get(ctx context.Context, dataset string, id string) (*SLO, error)

	// Create a new SLO in this dataset. When creating a SLO ID may not
	// be set.
	Create(ctx context.Context, dataset string, s *SLO) (*SLO, error)

	// Update an existing SLO.
	Update(ctx context.Context, dataset string, s *SLO) (*SLO, error)

	// Delete a SLO from the dataset.
	Delete(ctx context.Context, dataset string, id string) error
}

type SortOrder string

type Trigger struct {
	ID string `json:"id,omitempty"`

	// Name of the trigger. This field is required.
	Name string `json:"name"`
	// Description is displayed on the triggers page.
	Description string `json:"description,omitempty"`
	// State of the trigger, if disabled is true the trigger will not run.
	Disabled bool `json:"disabled"`
	// Query of the trigger. This field is required. The query must respect the
	// properties described with and validated by MatchesTriggerSubset.
	// Additionally, time_range of the query can be at most 1 day and may not
	// be greater than 4 times the frequency.
	Query   *QuerySpec `json:"query,omitempty"`
	QueryID string     `json:"query_id,omitempty"`
	// Alert Type. Describes scheduling behavior for triggers.
	// Defaults to "on_change"
	AlertType TriggerAlertType `json:"alert_type,omitempty"`
	// Threshold. This fild is required.
	Threshold *TriggerThreshold `json:"threshold"`
	// Evaluation Schedule used by the trigger.
	// Defaults to "frequency", where the trigger runs at the specified frequency.
	// The "window" type means that the trigger will run at the specified frequency,
	// but only in the time window specified by the evaluation schedule.
	EvaluationScheduleType TriggerEvaluationScheduleType `json:"evaluation_schedule_type,omitempty"`
	EvaluationSchedule     *TriggerEvaluationSchedule    `json:"evaluation_schedule,omitempty"`
	// Frequency describes how often the trigger should run. Frequency is an
	// interval in seconds, defaulting to 900 (15 minutes). Its value must be
	// divisible by 60 and between 60 and 86400 (between 1 minute and 1 day).
	Frequency int `json:"frequency,omitempty"`
	// Recipients are notified when the trigger fires.
	Recipients []NotificationRecipient `json:"recipients,omitempty"`
}

type TriggerAlertType string

type TriggerEvaluationSchedule struct {
	Window TriggerEvaluationWindow `json:"window"`
}

type TriggerEvaluationScheduleType string

type TriggerEvaluationWindow struct {
	// A slice of the days of the week to evaluate the trigger on. (e.g. ["monday", "tuesday", "wednesday"])
	DaysOfWeek []string `json:"days_of_week"`
	// UTC time in HH:mm format (e.g. 13:00)
	StartTime string `json:"start_time"`
	// UTC time in HH:mm format (e.g. 13:00)
	EndTime string `json:"end_time"`
}

type TriggerThreshold struct {
	Op            TriggerThresholdOp `json:"op"`
	Value         float64            `json:"value"`
	ExceededLimit int                `json:"exceeded_limit,omitempty"`
}

type TriggerThresholdOp string

type Triggers interface {
	// List all triggers present in this dataset.
	List(ctx context.Context, dataset string) ([]Trigger, error)

	// Get a trigger by its ID.
	Get(ctx context.Context, dataset string, id string) (*Trigger, error)

	// Create a new trigger in this dataset. When creating a new trigger ID
	// may not be set.
	Create(ctx context.Context, dataset string, t *Trigger) (*Trigger, error)

	// Update an existing trigger. Missing (optional) fields will set to their
	// respective defaults and not the currently existing values. Except for
	// the disabled flag, which will retain its existing value when omitted.
	Update(ctx context.Context, dataset string, t *Trigger) (*Trigger, error)

	// Delete a trigger from the dataset.
	Delete(ctx context.Context, dataset string, id string) error
}