push

type Data struct {
	Realm string
	User  struct{ Locale string }
	Data  map[string]any
}

type Delivery struct {
	UserID   string
	DeviceID string
	Token    string
	Message  Message
}

type DeviceResult struct {
	DeviceID string
	Status   string
	Detail   string
}

type Message struct {
	// Kind is the template the text came from, or RawKind.
	Kind        string
	Title, Body string
	Link        string
	// Data is delivered to the app as it is: strings only, at most MaxDataBytes serialized.
	Data  map[string]string
	Badge *int
	Sound string
	// Group replaces an earlier push with the same key (collapse key, collapse id, topic).
	Group string
	// TTL is how long providers keep trying; nil is DefaultTTL, zero is now or never.
	TTL      *time.Duration
	Priority string
	// Silent is data only: no visible notification.
	Silent bool
	// Platform holds keys android, ios and web, merged into that platform's payload.
	Platform map[string]map[string]any
}

type Rendered struct{ Title, Body, Link string }

type Request struct {
	Realm    string
	SendID   string
	Attempt  int // 1 for the first try of the unit
	Platform string
	Provider string
	// Config is the platform's block of realm.yaml with the secrets it names read: credentials
	// (FCM's service-account JSON), key (APNs' .p8 key), private_key and subject (Web Push),
	// and key_id, team_id, topic, sandbox ("true"), public_key and allowed_hosts (comma
	// separated: where a web subscription may point).
	Config map[string]string
	// Parallelism is how many provider requests may be in flight at once.
	Parallelism int
	Deliveries  []Delivery
}

type Sender interface {
	Send(ctx context.Context, req Request) ([]DeviceResult, error)
}

type Target struct{ Platform, Provider string }

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

type TooLargeError struct {
	Platform string
	Size     int
	Limit    int
}

type ValidationError struct{ Field, Reason string }