destinations

type Config map[string]string

type Conversion struct {
	Standard   StandardEvent
	Name       string // raw canonical event name (order_completed, …)
	EventID    string // dedup id (pixel <-> CAPI)
	Time       time.Time
	Value      float64
	Currency   string
	User       UserData
	URL        string
	Referrer   string // referring URL (a first-party analytics dimension)
	Items      []Item // ecommerce line items (nil for non-commerce events)
	Properties map[string]any
}

type Destination interface {
	ID() string       // stable slug: ga4|meta|tiktok|linkedin|x|reddit
	Name() string     // display name
	Category() string // Analytics | Advertising
	Spec() Spec
	// Send delivers batch for one org. secret is the resolved primary credential
	// (its own KMS secret, else the Spec.Fallback integrations token).
	Send(ctx context.Context, cfg Config, secret string, batch []Conversion) (Result, error)
}

type DestinationField struct {
	Key      string `json:"key"`               // the camelCase key on both the connect body and the stored config
	Label    string `json:"label"`             // human label for the console card's input
	Required bool   `json:"required"`          // when true, a connect that leaves it empty is refused 400
	Example  string `json:"example,omitempty"` // a sample value of the right shape ("G-XXXXXXX"), when one helps
}

type DestinationStatus struct {
	Platform string `json:"platform"` // the platform slug, and the path segment every route addresses it by
	Name     string `json:"name"`     // the platform's display name ("Google Analytics 4")
	Category string `json:"category"` // groups the card: Analytics | Advertising
	// Connected is true when this org has a stored row for the platform — it has
	// been configured here at least once. It says nothing about whether a
	// credential still resolves; that is Live.
	Connected bool `json:"connected"`
	// Enabled is whether the fan-out forwards to this destination. False on a
	// destination that is connected but paused, and on one never connected.
	Enabled bool `json:"enabled"`
	// Live is whether a credential resolves RIGHT NOW: a KMS-sealed secret for this
	// org, else the integrations connection named by the platform's Fallback, else
	// no credential needed at all (a public-ingest sink like Umami). False on a
	// connected destination whose secret has gone missing — Connected && !Live is
	// exactly the "reconnect me" state.
	Live bool `json:"live"`
	// Account is the operator's own label for the connected account, as supplied on
	// connect. Absent when unset.
	Account string `json:"account,omitempty"`
	// Config is the org's stored NON-SECRET configuration — the measurement/pixel
	// ids keyed by DestinationField.Key. A secret is never in here; secrets live in
	// KMS and only their names are published, in Secrets.
	Config Config `json:"config,omitempty"`
	// Fields are the non-secret inputs this platform needs, which the console card
	// renders and the connect body fills.
	Fields []DestinationField `json:"fields"`
	// Secrets are the KMS secret NAMES this platform custodies for the org — names
	// only, never values. The connect body accepts each under its camelCase form.
	Secrets []string `json:"secrets"`
}

type Item struct {
	ID       string  // SKU / product id → GA4 item_id, Meta content id
	Name     string  // → GA4 item_name
	Category string  // → GA4 item_category
	Brand    string  // → GA4 item_brand
	Variant  string  // → GA4 item_variant
	Price    float64 // unit price → GA4 price, Meta item_price
	Quantity float64 // → GA4 quantity, Meta quantity
}

type Result struct {
	Sent    int    `json:"sent"`
	Message string `json:"message,omitempty"`
}

type Row struct {
	Org          string `json:"-"`
	Platform     string `json:"platform"`
	Enabled      bool   `json:"enabled"`
	Config       Config `json:"config"`
	AccountLabel string `json:"account,omitempty"`
	ConnectedAt  int64  `json:"connectedAt"`
	UpdatedAt    int64  `json:"updatedAt"`
}

type Spec struct {
	Fields   []DestinationField `json:"fields"`
	Secrets  []string           `json:"secrets"`
	Fallback string             `json:"fallback,omitempty"`
}

type StandardEvent string

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

type UserData struct {
	Email      string
	Phone      string
	ExternalID string
	IP         string
	UserAgent  string
	FBP        string            // Meta browser-id cookie (_fbp), if present
	Clicks     map[string]string // fbclid|gclid|ttclid|twclid|rdt_cid|li_fat_id|msclkid → value
}