event

type Context struct {

	// Meta is free key-value dictionary related to the event.
	Meta map[string]any `json:"meta,omitempty"`

	// Flags represent feature flags leveraged by the client executing the event.
	Flags map[string]bool `json:"flags,omitempty"`

	// Params are additional parameters than can be passed to and apply by a
	// specification or an integration.
	Params url.Values `json:"params,omitempty"`

	// Library holds the details of the SDK used by the client executing the event.
	//
	// Note: This should be automatically populated using WithLibrary:
	//
	//   NewContext(client, WithLibrary())
	//
	Library *ContextLibrary `json:"library,omitempty"`

	// Git holds the details of the Git commit of the project from which the client
	// is executing the event.
	//
	// Note: This should be automatically populated using WithGit:
	//
	//   NewContext(client, WithGit())
	//
	Git *ContextGit `json:"git,omitempty"`

	// App holds the details about the application executing the event.
	App *ContextApp `json:"app,omitempty"`

	// Cloud holds the details about the cloud provider from which the event is
	// executed.
	Cloud *ContextCloud `json:"cloud,omitempty"`

	// Subscription holds the details about the account/customer for which the
	// event has been trigger.
	Subscription ContextSubscription `json:"subscription,omitempty"`

	// Campaign holds the details about the marketing campaign from which the event
	// is triggered from.
	Campaign ContextCampaign `json:"campaign,omitempty"`

	// Referrer holds the details about the marketing referrer from which the event
	// is triggered from.
	Referrer ContextReferrer `json:"referrer,omitempty"`

	// Device holds the details about the user's device.
	Device ContextDevice `json:"device,omitempty"`

	// OS holds the details about the user's OS.
	OS ContextOS `json:"os,omitempty"`

	// Location holds the details about the user's location.
	Location ContextLocation `json:"location,omitempty"`

	// Network holds the details about the user's network.
	Network ContextNetwork `json:"network,omitempty"`

	// Page holds the details about the webpage from which the event is triggered
	// from.
	Page ContextPage `json:"page,omitempty"`

	// Screen holds the details about the app's screen from which the event is
	// triggered from.
	Screen ContextScreen `json:"screen,omitempty"`

	// IP is the current user’s IP address.
	IP net.IP `json:"ip,omitempty"`

	// Locale is the locale string for the current user.
	//
	// Example: "en-US"
	Locale string `json:"locale,omitempty"`

	// Timezone is the user timezone information.
	//
	// Example: "America/New_York"
	Timezone string `json:"timezone,omitempty"`

	// UserAgent is the user agent of the device executing the event.
	UserAgent string `json:"user_agent,omitempty"`
}

type ContextApp struct {
	Name    string `json:"name,omitempty"`
	Version string `json:"version,omitempty"`
	BuildID string `json:"build_id,omitempty"`
}

type ContextCampaign struct {
	Name    string `json:"name,omitempty"`
	Source  string `json:"source,omitempty"`
	Medium  string `json:"medium,omitempty"`
	Term    string `json:"term,omitempty"`
	Content string `json:"content,omitempty"`
}

type ContextCloud struct {
	Provider  string `json:"provider,omitempty"`
	Service   string `json:"service,omitempty"`
	Region    string `json:"region,omitempty"`
	ProjectID string `json:"project_id,omitempty"`
	AccountID string `json:"account_id,omitempty"`
}

type ContextDevice struct {
	ID            string `json:"id,omitempty"`
	Manufacturer  string `json:"manufacturer,omitempty"`
	Model         string `json:"model,omitempty"`
	Name          string `json:"name,omitempty"`
	Type          string `json:"type,omitempty"`
	Version       string `json:"version,omitempty"`
	AdvertisingID string `json:"advertising_id,omitempty"`
}

type ContextGit struct {
	Branch    string    `json:"branch,omitempty"`
	Hash      string    `json:"hash,omitempty"`
	Message   string    `json:"message,omitempty"`
	Timestamp time.Time `json:"timestamp,omitempty"`
}

type ContextLibrary struct {
	Name    string `json:"name,omitempty"`
	Version string `json:"version,omitempty"`
}

type ContextLocation struct {
	City      string  `json:"city,omitempty"`
	Country   string  `json:"country,omitempty"`
	Region    string  `json:"region,omitempty"`
	Latitude  float64 `json:"latitude,omitempty"`
	Longitude float64 `json:"longitude,omitempty"`
	Speed     float64 `json:"speed,omitempty"`
}

type ContextNetwork struct {
	Bluetooth bool   `json:"bluetooth,omitempty"`
	Cellular  bool   `json:"cellular,omitempty"`
	WIFI      bool   `json:"wifi,omitempty"`
	Carrier   string `json:"carrier,omitempty"`
}

type ContextOS struct {
	Name    string `json:"name,omitempty"`
	Arch    string `json:"arch,omitempty"`
	Version string `json:"version,omitempty"`
}

type ContextPage struct {
	Path     string `json:"path,omitempty"`
	Referrer string `json:"referrer,omitempty"`
	Search   string `json:"search,omitempty"`
	Title    string `json:"title,omitempty"`
	URL      string `json:"url,omitempty"`
}

type ContextReferrer struct {
	Type string `json:"type,omitempty"`
	Name string `json:"name,omitempty"`
	URL  string `json:"url,omitempty"`
	Link string `json:"link,omitempty"`
}

type ContextScreen struct {
	Density int `json:"density,omitempty"`
	Width   int `json:"width,omitempty"`
	Height  int `json:"height,omitempty"`
}

type ContextSubscription struct {
	AccountID      string  `json:"account_id,omitempty"`
	SubscriptionID string  `json:"subscription_id,omitempty"`
	ProductID      string  `json:"product_id,omitempty"`
	Event          string  `json:"event,omitempty"`
	Value          string  `json:"value,omitempty"`
	IncrementBy    float32 `json:"increment_by,omitempty"`
}

type With func(Context) error