events

type CheckoutSession struct {
	SessionID      string
	OrganizationID string
	CustomerEmail  string
	Currency       string
	TotalAmount    float64
	ItemCount      int
	ProviderHint   string
}

type Config struct {
	// Datastore configuration (primary - writes to ClickHouse)
	DatastoreEnabled bool

	// Insights (PostHog) HTTP forwarding (optional)
	InsightsEndpoint string
	InsightsAPIKey   string
	InsightsEnabled  bool

	// Analytics (Umami) HTTP forwarding (optional)
	AnalyticsEndpoint  string
	AnalyticsWebsiteID string
	AnalyticsEnabled   bool
}

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

type DatastoreWriterConfig struct {
	// BatchSize is the number of events to batch before writing
	BatchSize int

	// FlushInterval is how often to flush partial batches
	FlushInterval time.Duration

	// AsyncInsert uses ClickHouse async insert (faster, less guaranteed)
	AsyncInsert bool

	// BufferSize is the event channel buffer size
	BufferSize int
}

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

type Order struct {
	ID       string
	UserID   string
	Email    string
	Total    float64
	Currency string
	Items    []OrderItem
	Status   string
	OrgID    string
}

type OrderItem struct {
	ProductID   string
	ProductName string
	SKU         string
	Quantity    int
	Price       float64
}

type PageView struct {
	URL       string
	Title     string
	Referrer  string
	UserID    string
	SessionID string
	OrgID     string
	IP        string
	UserAgent string
	Language  string
	Screen    string
}

type Product struct {
	ID       string
	Name     string
	SKU      string
	Price    float64
	Category string
	OrgID    string
}

type RawEvent struct {
	// Core identifiers
	DistinctID string `json:"distinct_id"`
	Event      string `json:"event"`

	// Organization
	OrganizationID string `json:"organization_id"`
	ProjectID      string `json:"project_id,omitempty"`

	// Session
	SessionID string `json:"session_id,omitempty"`
	VisitID   string `json:"visit_id,omitempty"`

	// Properties
	Properties       map[string]interface{} `json:"properties,omitempty"`
	PersonProperties map[string]interface{} `json:"person_properties,omitempty"`

	// Group
	GroupType       string                 `json:"group_type,omitempty"`
	GroupKey        string                 `json:"group_key,omitempty"`
	GroupProperties map[string]interface{} `json:"group_properties,omitempty"`

	// Web analytics
	URL            string `json:"url,omitempty"`
	URLPath        string `json:"url_path,omitempty"`
	Referrer       string `json:"referrer,omitempty"`
	ReferrerDomain string `json:"referrer_domain,omitempty"`
	Hostname       string `json:"hostname,omitempty"`

	// Device
	Browser        string `json:"browser,omitempty"`
	BrowserVersion string `json:"browser_version,omitempty"`
	OS             string `json:"os,omitempty"`
	OSVersion      string `json:"os_version,omitempty"`
	Device         string `json:"device,omitempty"`
	DeviceType     string `json:"device_type,omitempty"`
	Screen         string `json:"screen,omitempty"`
	Language       string `json:"language,omitempty"`

	// Geo
	Country string `json:"country,omitempty"`
	Region  string `json:"region,omitempty"`
	City    string `json:"city,omitempty"`

	// UTM
	UTMSource   string `json:"utm_source,omitempty"`
	UTMMedium   string `json:"utm_medium,omitempty"`
	UTMCampaign string `json:"utm_campaign,omitempty"`
	UTMContent  string `json:"utm_content,omitempty"`
	UTMTerm     string `json:"utm_term,omitempty"`

	// Click IDs
	GCLID  string `json:"gclid,omitempty"`
	FBCLID string `json:"fbclid,omitempty"`
	MSCLID string `json:"msclid,omitempty"`

	// Request
	IP        string `json:"ip,omitempty"`
	UserAgent string `json:"user_agent,omitempty"`

	// Commerce
	OrderID   string  `json:"order_id,omitempty"`
	ProductID string  `json:"product_id,omitempty"`
	CartID    string  `json:"cart_id,omitempty"`
	Revenue   float64 `json:"revenue,omitempty"`
	Quantity  int     `json:"quantity,omitempty"`

	// AST/Structured Data (astley.js support)
	// JSON-LD context for semantic data
	ASTContext string `json:"@context,omitempty"`
	ASTType    string `json:"@type,omitempty"`

	// Page structure elements
	PageTitle       string `json:"page_title,omitempty"`
	PageDescription string `json:"page_description,omitempty"`
	PageType        string `json:"page_type,omitempty"` // hero, block, cta, etc.

	// Element interaction tracking
	ElementID       string `json:"element_id,omitempty"`
	ElementType     string `json:"element_type,omitempty"`     // button, link, form, section
	ElementSelector string `json:"element_selector,omitempty"` // CSS selector
	ElementText     string `json:"element_text,omitempty"`     // visible text
	ElementHref     string `json:"element_href,omitempty"`     // link destination

	// Section tracking (astley.js WebsiteSection)
	SectionName string `json:"section_name,omitempty"`
	SectionType string `json:"section_type,omitempty"` // hero, block, cta
	SectionID   string `json:"section_id,omitempty"`

	// Component hierarchy
	ComponentPath string `json:"component_path,omitempty"` // e.g., "header/nav/menu/item"
	ComponentData string `json:"component_data,omitempty"` // JSON blob of component props

	// AI/Cloud events
	ModelProvider string  `json:"model_provider,omitempty"` // openai, anthropic, etc.
	ModelName     string  `json:"model_name,omitempty"`     // gpt-4, claude-3, etc.
	TokenCount    int     `json:"token_count,omitempty"`
	TokenPrice    float64 `json:"token_price,omitempty"`
	PromptTokens  int     `json:"prompt_tokens,omitempty"`
	OutputTokens  int     `json:"output_tokens,omitempty"`

	// Timestamps
	Timestamp time.Time `json:"timestamp"`
	SentAt    time.Time `json:"sent_at,omitempty"`

	// Library
	Lib        string `json:"lib,omitempty"`
	LibVersion string `json:"lib_version,omitempty"`
}

type User struct {
	ID        string
	Email     string
	Name      string
	OrgID     string
	CreatedAt string
}