apiv1

type APIError struct {
	Status     int
	Code       string
	Message    string
	Details    map[string]any
	RetryAfter time.Duration
}

type Account struct {
	ID          string    `json:"id"`
	Platform    string    `json:"platform"`
	Username    string    `json:"username"`
	DisplayName string    `json:"display_name"`
	Status      string    `json:"status"`
	ProfileID   string    `json:"profile_id"`
	ProfileName string    `json:"profile_name"`
	ConnectedAt time.Time `json:"connected_at"`
	// DefaultBoardID is, for a Pinterest account, the id of the board its
	// Pins go to when a post names none, as chosen in the dashboard. Empty
	// when it has none, and a post to it then needs PinterestOptions.Board.
	DefaultBoardID string `json:"default_board_id,omitempty"`
}

type AccountList struct {
	Data []Account `json:"data"`
}

type AnalyticsAccount struct {
	ID        string `json:"id"`
	Platform  string `json:"platform"`
	Username  string `json:"username"`
	Followers int64  `json:"followers"`
	Supported bool   `json:"supported"`
	// Status is "ok", "unsupported", "reconnect_required", "unavailable" or "error".
	Status string `json:"status"`
	Reason string `json:"reason,omitempty"`
}

type AnalyticsPlatformRow struct {
	Platform string `json:"platform"`
	Posts    int    `json:"posts"`
	Likes    int64  `json:"likes"`
	Comments int64  `json:"comments"`
	Shares   int64  `json:"shares"`
	Views    int64  `json:"views"`
}

type AnalyticsPost struct {
	Platform      string `json:"platform"`
	Username      string `json:"username"`
	URL           string `json:"url"`
	Text          string `json:"text"`
	PublishedAt   string `json:"published_at"`
	Likes         *int64 `json:"likes"`
	Comments      *int64 `json:"comments"`
	Shares        *int64 `json:"shares"`
	Views         *int64 `json:"views"`
	Reach         *int64 `json:"reach"`
	Saves         *int64 `json:"saves"`
	Impressions   *int64 `json:"impressions"`
	Clicks        *int64 `json:"clicks"`
	Follows       *int64 `json:"follows"`
	Engagement    int64  `json:"engagement"`
	FromPostatron bool   `json:"posted_with_postatron"`
}

type AnalyticsQuery struct {
	// Range is 7d, 30d, 90d or 365d (default 30d).
	Range string
	// Platform limits the report to one platform, e.g. instagram.
	Platform string
	// AccountID limits the report to one connected account.
	AccountID string
	// Profile is a profile id or name.
	Profile string
	// Source is "all" (default) or "postatron" for posts made with Postatron only.
	Source string
}

type AnalyticsRange struct {
	Key   string `json:"key"`
	Start string `json:"start"`
	End   string `json:"end"`
}

type AnalyticsReport struct {
	Range       AnalyticsRange         `json:"range"`
	Summary     AnalyticsSummary       `json:"summary"`
	PerPlatform []AnalyticsPlatformRow `json:"per_platform"`
	TopPosts    []AnalyticsPost        `json:"top_posts"`
	Accounts    []AnalyticsAccount     `json:"accounts"`
	GeneratedAt string                 `json:"generated_at"`
	Notes       []string               `json:"notes,omitempty"`
	// LastSyncAt is when the oldest numbers in the report were read from a
	// platform, and NextSyncAt when they will next be read (RFC 3339).
	// Each account is read at most once an hour; asking sooner returns the
	// same numbers.
	LastSyncAt string `json:"last_sync_at,omitempty"`
	NextSyncAt string `json:"next_sync_at,omitempty"`
}

type AnalyticsSummary struct {
	EngagementRate      float64 `json:"engagement_rate_percent"`
	EngagementRateBasis string  `json:"engagement_rate_basis"`
	Engagements         int64   `json:"engagements"`
	Reach               int64   `json:"reach"`
	Followers           int64   `json:"followers"`
	PostsThisPeriod     int     `json:"posts_this_period"`
}

type Client struct {
	BaseURL    string
	APIKey     string
	HTTPClient *http.Client
	UserAgent  string
}

type ConnectAccountRequest struct {
	// Platform is the network to connect: x, instagram, facebook, linkedin,
	// tiktok, youtube, threads, bluesky or pinterest. A Pinterest account
	// must be a business account (a free one will do).
	Platform string `json:"platform"`
	// Profile is the profile (name or id) the new account goes into.
	Profile string `json:"profile,omitempty"`
	// AccountID signs a connected account in again instead, for one whose
	// access has gone (status reconnect_required, or a failed delivery with
	// error_code reconnect). It keeps its profile, and Platform may be left
	// out. Asking for a platform whose account in Profile needs reconnecting
	// does the same.
	AccountID string `json:"account_id,omitempty"`
}

type ConnectLink struct {
	Platform   string `json:"platform"`
	ConnectURL string `json:"connect_url"`
	Profile    string `json:"profile,omitempty"`
	Hint       string `json:"hint"`
}

type CreatePostRequest struct {
	Content     string     `json:"content"`
	AccountIDs  []string   `json:"account_ids,omitempty"`
	Platforms   []string   `json:"platforms,omitempty"`
	Profile     string     `json:"profile,omitempty"`
	MediaURLs   []string   `json:"media_urls,omitempty"`
	MediaIDs    []string   `json:"media_ids,omitempty"`
	ScheduledAt *time.Time `json:"scheduled_at,omitempty"`
	// Queue (a name or id from GET /v1/queues) schedules the post for that
	// queue's next free slot instead of ScheduledAt. Its accounts must all be
	// in the queue's profile, which is also what Platforms means when Profile
	// is left out.
	Queue string `json:"queue,omitempty"`
	// X, Instagram, TikTok, YouTube and Pinterest hold the options only that
	// platform has. Each needs an account on its platform among the post's
	// accounts. A Pinterest account with no default board needs Pinterest,
	// to name its board.
	X         *XOptions         `json:"x,omitempty"`
	Instagram *InstagramOptions `json:"instagram,omitempty"`
	TikTok    *TikTokOptions    `json:"tiktok,omitempty"`
	YouTube   *YouTubeOptions   `json:"youtube,omitempty"`
	Pinterest *PinterestOptions `json:"pinterest,omitempty"`
	// IdempotencyKey, when set, is sent as the Idempotency-Key header: up to
	// 255 printable characters, unique per post, such as a UUID. Sending
	// the same request with the same key within 24 hours answers with the
	// post the first one made, and makes no second post, so a request whose
	// answer was lost can be sent again safely. The same key with a
	// different body is refused (CodeIdempotencyKeyReused), and so is one
	// still being handled (CodeIdempotencyKeyInUse).
	IdempotencyKey string `json:"-"`
}

type CreateQueueRequest struct {
	Name string `json:"name"`
	// Profile is the profile (name or id) the queue posts for; Default when
	// left out. A post added to the queue must go to accounts in it.
	Profile string `json:"profile,omitempty"`
	// Timezone is an IANA name such as Europe/London; slot times are wall
	// clock times there, across daylight saving.
	Timezone string      `json:"timezone"`
	Slots    []QueueSlot `json:"slots,omitempty"`
	// Paused creates the queue paused, taking no posts until resumed.
	Paused bool `json:"paused,omitempty"`
}

type CreateUploadRequest struct {
	// Purpose is shown to the person on the upload page, e.g. "the launch video".
	Purpose string `json:"purpose,omitempty"`
}

type CreateWebhookRequest struct {
	URL    string   `json:"url"`
	Events []string `json:"events,omitempty"`
}

type DeletePostResponse struct {
	ID        string `json:"id"`
	Status    string `json:"status"`
	Deleted   bool   `json:"deleted"`
	Cancelled bool   `json:"cancelled"`
	Message   string `json:"message,omitempty"`
}

type DeletePostsError struct {
	ID    string `json:"id"`
	Error string `json:"error"`
}

type DeletePostsRequest struct {
	IDs []string `json:"ids"`
}

type DeletePostsResponse struct {
	Deleted []string           `json:"deleted"`
	Failed  []DeletePostsError `json:"failed"`
	Message string             `json:"message,omitempty"`
}

type DeleteQueueResponse struct {
	ID      string `json:"id"`
	Deleted bool   `json:"deleted"`
	Message string `json:"message,omitempty"`
}

type DeleteWebhookResponse struct {
	ID      string `json:"id"`
	Deleted bool   `json:"deleted"`
}

type Delivery struct {
	AccountID string `json:"account_id"`
	Platform  string `json:"platform"`
	Username  string `json:"username"`
	Status    string `json:"status"`
	URL       string `json:"url,omitempty"`
	// Error says why a delivery failed. On a published one it says what
	// did not go through after the post itself, such as a first comment or
	// a YouTube thumbnail, and Warning is true.
	Error string `json:"error,omitempty"`
	// ErrorCode is why a failed delivery failed, one of the Error* codes,
	// so an agent can act on it without reading Error. Empty unless failed.
	ErrorCode string `json:"error_code,omitempty"`
	// Warning is true on a published delivery that carries an Error: the
	// post is live, and Error is about something after it.
	Warning bool `json:"warning,omitempty"`
}

type ErrorBody struct {
	Error ErrorDetail `json:"error"`
}

type ErrorDetail struct {
	Code    string         `json:"code"`
	Message string         `json:"message"`
	Details map[string]any `json:"details,omitempty"`
}

type Event struct {
	ID string    `json:"id"`
	At time.Time `json:"at"`
	// Kind is post.published, post.partial, post.failed, post.unpublished,
	// account.connected, account.disconnected, account.needs_attention or
	// api.request.
	Kind   string `json:"kind"`
	Status string `json:"status"`
	// Source is where a post or request came from: dashboard, api or mcp.
	// Empty for what Postatron did by itself.
	Source string `json:"source,omitempty"`
	// ActorID is the person behind it: the owner, or a team member.
	ActorID    string   `json:"actor_id,omitempty"`
	ProfileIDs []string `json:"profile_ids,omitempty"`
	PostID     string   `json:"post_id,omitempty"`
	// Excerpt is the start of the post's text.
	Excerpt  string         `json:"excerpt,omitempty"`
	Message  string         `json:"message,omitempty"`
	Accounts []EventAccount `json:"accounts,omitempty"`
	Request  *EventRequest  `json:"request,omitempty"`
	// Reason is why an account was disconnected: user, expired or revoked.
	Reason string `json:"reason,omitempty"`
	// AtRisk are the scheduled posts an account problem will stop going out,
	// soonest first and at most ten, and AtRiskCount how many there are.
	AtRisk      []EventPostRef `json:"at_risk,omitempty"`
	AtRiskCount int            `json:"at_risk_count,omitempty"`
}

type EventAccount struct {
	ID       string `json:"id"`
	Platform string `json:"platform"`
	Username string `json:"username,omitempty"`
	Name     string `json:"name,omitempty"`
	Status   string `json:"status,omitempty"`
	Message  string `json:"message,omitempty"`
	URL      string `json:"url,omitempty"`
	// ErrorCode is a failed delivery's code, as on Delivery.
	ErrorCode string `json:"error_code,omitempty"`
}

type EventList struct {
	Data       []Event `json:"data"`
	NextCursor string  `json:"next_cursor,omitempty"`
}

type EventPostRef struct {
	ID      string    `json:"id"`
	At      time.Time `json:"at"`
	Excerpt string    `json:"excerpt,omitempty"`
}

type EventRequest struct {
	Method     string `json:"method"`
	Path       string `json:"path"`
	StatusCode int    `json:"status_code"`
	// Code is the API's error code on a refusal.
	Code       string `json:"code,omitempty"`
	DurationMs int64  `json:"duration_ms"`
	// Tool is the MCP tool that made the call.
	Tool string `json:"tool,omitempty"`
	// KeyName names the API key or connected app that called.
	KeyName string `json:"key_name,omitempty"`
}

type InstagramOptions struct {
	// PostType is auto (the default: chosen from the media), feed, story,
	// reel or carousel.
	PostType string `json:"post_type,omitempty"`
	// Caption replaces the post's text on Instagram only.
	Caption string `json:"caption,omitempty"`
	// FirstComment is posted as the first comment, often for hashtags. Not
	// on stories.
	FirstComment string `json:"first_comment,omitempty"`
	// Collaborators are up to 3 usernames invited to co-author the post.
	Collaborators []string `json:"collaborators,omitempty"`
	// UserTags tag people on images.
	UserTags []InstagramUserTag `json:"user_tags,omitempty"`
	// AIGenerated asks Instagram to show its AI-content label.
	AIGenerated bool `json:"ai_generated,omitempty"`
	// TrialReel shares a reel with non-followers first: manual (graduate it
	// by hand) or performance (Instagram graduates it if it does well).
	TrialReel string `json:"trial_reel,omitempty"`
}

type InstagramUserTag struct {
	Username   string  `json:"username"`
	X          float64 `json:"x"`
	Y          float64 `json:"y"`
	MediaIndex int     `json:"media_index,omitempty"`
}

type ListEventsQuery struct {
	// Range is 24h, 7d (the default), 30d or 90d, ending now. Events are
	// kept for 90 days.
	Range string
	// Status is ok, warning or error.
	Status string
	// Type is posts, accounts or api.
	Type string
	// Platform keeps events about an account on that platform, e.g. instagram.
	Platform string
	Limit    int
	Cursor   string
}

type ListPostsQuery struct {
	Status   string
	Platform string
	// Profile is a profile id or name; only posts to its accounts are listed.
	Profile string
	From    *time.Time
	To      *time.Time
	Limit   int
	Cursor  string
}

type Operations interface {
	CreatePost(ctx context.Context, req CreatePostRequest) (*Post, error)
	ListPosts(ctx context.Context, query ListPostsQuery) (*PostList, error)
	GetPost(ctx context.Context, id string) (*Post, error)
	UpdatePost(ctx context.Context, id string, req UpdatePostRequest) (*Post, error)
	DeletePost(ctx context.Context, id string) (*DeletePostResponse, error)
	DeletePosts(ctx context.Context, req DeletePostsRequest) (*DeletePostsResponse, error)
	RetryPost(ctx context.Context, id string, req RetryPostRequest) (*Post, error)
	ListEvents(ctx context.Context, query ListEventsQuery) (*EventList, error)
	ListAccounts(ctx context.Context) (*AccountList, error)
	ConnectAccount(ctx context.Context, req ConnectAccountRequest) (*ConnectLink, error)
	ListProfiles(ctx context.Context) (*ProfileList, error)
	ListQueues(ctx context.Context) (*QueueList, error)
	CreateQueue(ctx context.Context, req CreateQueueRequest) (*Queue, error)
	UpdateQueue(ctx context.Context, id string, req UpdateQueueRequest) (*Queue, error)
	DeleteQueue(ctx context.Context, id string) (*DeleteQueueResponse, error)
	GetUsage(ctx context.Context) (*UsageReport, error)
	GetAnalytics(ctx context.Context, query AnalyticsQuery) (*AnalyticsReport, error)
	CreateUpload(ctx context.Context, req CreateUploadRequest) (*Upload, error)
	GetUpload(ctx context.Context, id string) (*Upload, error)
}

type PinterestOptions struct {
	// Board is the board, by id or name, for every Pinterest account in the
	// post. Left out, each account's default board is used.
	Board string `json:"board,omitempty"`
	// Boards maps a Pinterest account id (from ListAccounts) to its board,
	// by id or name, for a post to several Pinterest accounts. It wins over
	// Board for the accounts it names. When a post is read back, Boards holds
	// each account's board id, and Board too when there is only one.
	Boards map[string]string `json:"boards,omitempty"`
	// Title is the Pin's title, up to 100 characters. Left out, it is the
	// first line of the content, cut to 100 characters.
	Title string `json:"title,omitempty"`
	// Description replaces the content as the Pin's description, up to 800
	// characters. Left out, the content is the description, so it must fit
	// in 800.
	Description string `json:"description,omitempty"`
	// Link is where the Pin leads when someone taps it: a full http or https
	// address, up to 2048 characters.
	Link string `json:"link,omitempty"`
}

type Post struct {
	ID           string     `json:"id"`
	Status       string     `json:"status"`
	Content      string     `json:"content"`
	MediaType    string     `json:"media_type"`
	ContainsLink bool       `json:"contains_link"`
	ScheduledAt  *time.Time `json:"scheduled_at,omitempty"`
	CreatedAt    time.Time  `json:"created_at"`
	UpdatedAt    *time.Time `json:"updated_at,omitempty"`
	Deliveries   []Delivery `json:"deliveries"`
	// Source is where the post was made: dashboard, api or mcp. Empty on
	// posts from before it was recorded.
	Source string `json:"source,omitempty"`
	// CreatedBy is the person who made the post, and UpdatedBy whoever last
	// changed it, when someone has. They differ in a team workspace.
	CreatedBy *PostAuthor `json:"created_by,omitempty"`
	UpdatedBy *PostAuthor `json:"updated_by,omitempty"`
	// Queue is the queue that chose the post's time, when one did.
	Queue *PostQueue `json:"queue,omitempty"`
	// Unpublished is set on a draft that came due without a plan and went
	// back to the drafts: why, and when it was due.
	Unpublished *PostUnpublished `json:"unpublished,omitempty"`
	// The platform options the post was saved with, when it has any.
	X         *XOptions         `json:"x,omitempty"`
	Instagram *InstagramOptions `json:"instagram,omitempty"`
	TikTok    *TikTokOptions    `json:"tiktok,omitempty"`
	YouTube   *YouTubeOptions   `json:"youtube,omitempty"`
	Pinterest *PinterestOptions `json:"pinterest,omitempty"`
}

type PostAuthor struct {
	ID   string `json:"id"`
	Name string `json:"name,omitempty"`
}

type PostList struct {
	Data       []Post `json:"data"`
	NextCursor string `json:"next_cursor,omitempty"`
}

type PostQueue struct {
	ID   string `json:"id"`
	Name string `json:"name,omitempty"`
}

type PostUnpublished struct {
	Reason string    `json:"reason"`
	DueAt  time.Time `json:"due_at"`
}

type Profile struct {
	ID        string    `json:"id"`
	Name      string    `json:"name"`
	IsDefault bool      `json:"is_default"`
	Accounts  []Account `json:"accounts"`
}

type ProfileList struct {
	Data []Profile `json:"data"`
}

type Queue struct {
	ID          string      `json:"id"`
	Name        string      `json:"name"`
	ProfileID   string      `json:"profile_id"`
	ProfileName string      `json:"profile_name"`
	Timezone    string      `json:"timezone"`
	Slots       []QueueSlot `json:"slots"`
	// Active is false while the queue is paused and takes no new posts.
	Active bool `json:"active"`
	// NextSlot is when a post added now would go out; nil when none would,
	// with NextSlotError saying why.
	NextSlot      *time.Time `json:"next_slot,omitempty"`
	NextSlotError string     `json:"next_slot_error,omitempty"`
	// Queued is how many of its posts are still to go out.
	Queued int `json:"queued"`
	// Rescheduled, on an update with MovePosts that changed the slots or
	// timezone, is what moving its posts did. RescheduleError says why they
	// did not move; the update itself was saved.
	Rescheduled     *QueueRescheduled `json:"rescheduled,omitempty"`
	RescheduleError string            `json:"reschedule_error,omitempty"`
}

type QueueList struct {
	Data []Queue `json:"data"`
}

type QueueRescheduled struct {
	// Moved is how many posts were given a new time.
	Moved int `json:"moved"`
	// Kept is how many of its posts kept theirs: ones given a time of their
	// own, due within five minutes, or changed while they were being moved.
	Kept int `json:"kept"`
}

type QueueSlot struct {
	Day  int    `json:"day"`
	Time string `json:"time"`
}

type RetryPostRequest struct {
	AccountIDs []string `json:"account_ids,omitempty"`
}

type TikTokOptions struct {
	// Title is a video's caption, up to 2200 characters, replacing the
	// post's text there; or a photo post's title, up to 90. TikTok counts
	// characters in UTF-16, so an emoji counts as two.
	Title string `json:"title,omitempty"`
	// Description is a photo post's long description, up to 4000
	// characters; it replaces the post's text there.
	Description string `json:"description,omitempty"`
	// Draft uploads to the creator's TikTok inbox instead of publishing.
	Draft bool `json:"draft,omitempty"`
	// Privacy is public_to_everyone, mutual_follow_friends,
	// follower_of_creator or self_only.
	Privacy           string `json:"privacy,omitempty"`
	DisableComment    *bool  `json:"disable_comment,omitempty"`
	DisableDuet       *bool  `json:"disable_duet,omitempty"`
	DisableStitch     *bool  `json:"disable_stitch,omitempty"`
	CommercialContent *bool  `json:"commercial_content,omitempty"`
	// YourBrand discloses promotion of the creator's own business.
	YourBrand *bool `json:"your_brand,omitempty"`
	// BrandedContent discloses a paid partnership; it cannot be private.
	BrandedContent *bool `json:"branded_content,omitempty"`
	// MusicUsageConfirmed is the person accepting TikTok's declaration,
	// which TikTok requires before it publishes: "By posting, you agree to
	// TikTok's Music Usage Confirmation", or with BrandedContent "...TikTok's
	// Branded Content Policy and Music Usage Confirmation". Show it to them;
	// never agree for them.
	MusicUsageConfirmed *bool `json:"music_usage_confirmed,omitempty"`
	// AutoAddMusic lets TikTok add recommended music to a photo post.
	AutoAddMusic bool `json:"auto_add_music,omitempty"`
	// AIGenerated asks TikTok to label the post as AI-generated.
	AIGenerated bool `json:"ai_generated,omitempty"`
}

type UpdatePostRequest struct {
	// Content replaces the post's text.
	Content *string `json:"content,omitempty"`
	// ScheduledAt moves the post, or schedules a draft, at least 5 minutes ahead.
	ScheduledAt *time.Time `json:"scheduled_at,omitempty"`
	// PublishNow publishes the post straight away, after any other change in
	// the same request. It cannot be combined with ScheduledAt.
	PublishNow bool `json:"publish_now,omitempty"`
	// AddPlatforms adds the account on each platform (in Profile), the way
	// CreatePostRequest.Platforms chooses them.
	AddPlatforms []string `json:"add_platforms,omitempty"`
	// AddAccountIDs adds specific connected accounts.
	AddAccountIDs []string `json:"add_account_ids,omitempty"`
	// RemoveAccountIDs takes accounts off the post; at least one must remain.
	RemoveAccountIDs []string `json:"remove_account_ids,omitempty"`
	// Profile chooses which brand AddPlatforms means.
	Profile string `json:"profile,omitempty"`
	// X, Instagram, TikTok, YouTube and Pinterest replace that platform's
	// options as a whole; an empty object ({}) clears them, and a Pinterest
	// account then uses its default board. A Pinterest account added without
	// Pinterest is saved to its default board, and needs one.
	X         *XOptions         `json:"x,omitempty"`
	Instagram *InstagramOptions `json:"instagram,omitempty"`
	TikTok    *TikTokOptions    `json:"tiktok,omitempty"`
	YouTube   *YouTubeOptions   `json:"youtube,omitempty"`
	Pinterest *PinterestOptions `json:"pinterest,omitempty"`
}

type UpdateQueueRequest struct {
	Name     *string      `json:"name,omitempty"`
	Profile  *string      `json:"profile,omitempty"`
	Timezone *string      `json:"timezone,omitempty"`
	Slots    *[]QueueSlot `json:"slots,omitempty"`
	// Active false pauses the queue; true resumes it.
	Active *bool `json:"active,omitempty"`
	// MovePosts, when the slots or timezone change, gives the queue's upcoming
	// posts the new slots, in the order they were going out. Posts given a
	// time of their own, and any due within five minutes, keep their times.
	MovePosts bool `json:"move_posts,omitempty"`
}

type UpdateWebhookRequest struct {
	URL     *string  `json:"url,omitempty"`
	Events  []string `json:"events,omitempty"`
	Enabled *bool    `json:"enabled,omitempty"`
}

type Upload struct {
	ID        string `json:"id"`
	Status    string `json:"status"`
	UploadURL string `json:"upload_url,omitempty"`
	Filename  string `json:"filename,omitempty"`
	ExpiresAt string `json:"expires_at"`
	Hint      string `json:"hint,omitempty"`
}

type UsageCounter struct {
	Used      int  `json:"used"`
	Limit     *int `json:"limit"`
	Remaining *int `json:"remaining"`
}

type UsageLinkCounter struct {
	Used int `json:"used"`
}

type UsagePeriod struct {
	Start time.Time `json:"start"`
	End   time.Time `json:"end"`
}

type UsagePlan struct {
	Code                 string `json:"code"`
	Name                 string `json:"name"`
	Interval             string `json:"interval"`
	Status               string `json:"status"`
	ConnectedAccounts    int    `json:"connected_accounts"`
	MaxConnectedAccounts int    `json:"max_connected_accounts"`
}

type UsageRateLimits struct {
	WritesPerMinute  int `json:"writes_per_minute"`
	ReadsPerMinute   int `json:"reads_per_minute"`
	UploadsPerMinute int `json:"uploads_per_minute"`
	// WritesPerHour is WritesPerMinute * 60, kept for clients written before
	// the write window became per minute.
	//
	// Deprecated: use WritesPerMinute.
	WritesPerHour int `json:"writes_per_hour"`
}

type UsageReport struct {
	Period UsagePeriod `json:"period"`
	Plan   UsagePlan   `json:"plan"`
	// DestinationPosts counts every post delivered to one account. Posts are
	// not capped on any plan, so its Limit and Remaining are null.
	DestinationPosts UsageCounter `json:"destination_posts"`
	// XPosts counts posts to X, each tweet of a thread as one: the one
	// platform with a monthly cap, because X bills every post.
	XPosts    UsageCounter     `json:"x_posts"`
	LinkPosts UsageLinkCounter `json:"link_posts"`
	// XLinkPosts counts the X posts with a link, which X bills far more for
	// and which have a smaller cap of their own inside XPosts.
	XLinkPosts UsageCounter    `json:"x_link_posts"`
	ByPlatform map[string]int  `json:"by_platform"`
	RateLimits UsageRateLimits `json:"rate_limits"`
}

type Webhook struct {
	ID  string `json:"id"`
	URL string `json:"url"`
	// Events are the event types it receives, or ["*"] for every one.
	Events  []string `json:"events"`
	Enabled bool     `json:"enabled"`
	// DisabledReason says why Postatron switched it off: it does so after
	// 20 deliveries in a row fail. Enable it again with UpdateWebhook.
	DisabledReason string    `json:"disabled_reason,omitempty"`
	CreatedAt      time.Time `json:"created_at"`
	// LastAttempt is the latest attempt to deliver to it, test or real.
	LastAttempt *WebhookAttempt `json:"last_attempt,omitempty"`
	// ConsecutiveFailures counts deliveries in a row that failed every
	// retry; one that succeeds resets it.
	ConsecutiveFailures int `json:"consecutive_failures"`
	// Secret signs every request. Set only in the response to CreateWebhook
	// and RotateWebhookSecret, and never shown again.
	Secret string `json:"secret,omitempty"`
}

type WebhookAccountData struct {
	Account Account `json:"account"`
	// Reason is why an account was disconnected: user, expired or revoked.
	Reason string `json:"reason,omitempty"`
	// Message says what happened, when Postatron lost access or the account
	// needs attention.
	Message string `json:"message,omitempty"`
	// AtRisk are scheduled posts that will fail until the account is
	// connected again, soonest first and at most ten; AtRiskCount counts
	// them all.
	AtRisk      []EventPostRef `json:"at_risk,omitempty"`
	AtRiskCount int            `json:"at_risk_count,omitempty"`
}

type WebhookAttempt struct {
	At time.Time `json:"at"`
	// Event is the type of the event it carried.
	Event string `json:"event,omitempty"`
	// Succeeded is true when the endpoint answered with a 2xx status.
	Succeeded bool `json:"succeeded"`
	// StatusCode is the endpoint's answer; 0 when it never answered.
	StatusCode int `json:"status_code,omitempty"`
	// Error says why it failed.
	Error      string `json:"error,omitempty"`
	DurationMs int64  `json:"duration_ms"`
}

type WebhookEvent struct {
	// ID is the delivery's id, the same as the Postatron-Delivery header.
	ID        string          `json:"id"`
	Type      string          `json:"type"`
	CreatedAt time.Time       `json:"created_at"`
	Data      json.RawMessage `json:"data"`
}

type WebhookList struct {
	Data []Webhook `json:"data"`
}

type WebhookOperations interface {
	ListWebhooks(ctx context.Context) (*WebhookList, error)
	CreateWebhook(ctx context.Context, req CreateWebhookRequest) (*Webhook, error)
	UpdateWebhook(ctx context.Context, id string, req UpdateWebhookRequest) (*Webhook, error)
	DeleteWebhook(ctx context.Context, id string) (*DeleteWebhookResponse, error)
	TestWebhook(ctx context.Context, id string) (*WebhookTestResult, error)
	RotateWebhookSecret(ctx context.Context, id string) (*Webhook, error)
}

type WebhookPostData struct {
	Post Post `json:"post"`
}

type WebhookTestData struct {
	WebhookID string `json:"webhook_id"`
	Message   string `json:"message"`
}

type WebhookTestResult struct {
	DeliveryID string `json:"delivery_id"`
	Delivered  bool   `json:"delivered"`
	StatusCode int    `json:"status_code,omitempty"`
	Error      string `json:"error,omitempty"`
	DurationMs int64  `json:"duration_ms"`
}

type XOptions struct {
	// Content replaces the post's text on X only.
	Content string `json:"content,omitempty"`
	// Thread adds replies under the first tweet, in order: Thread[0] is the
	// second tweet. A thread cannot go into a Community.
	Thread []XThreadTweet `json:"thread,omitempty"`
	// Community is the id of the X Community to post into, or its link
	// (https://x.com/i/communities/<id>).
	Community string `json:"community,omitempty"`
	// ShareWithFollowers also shows a Community post on followers' timelines.
	ShareWithFollowers bool `json:"share_with_followers,omitempty"`
	// ReplySettings limits who can reply: following, mentioned_users,
	// subscribers or verified. Empty lets everyone reply.
	ReplySettings string `json:"reply_settings,omitempty"`
	// LongPost allows tweets over 280 characters, which X accepts from
	// Premium accounts only.
	LongPost bool `json:"long_post,omitempty"`
	// Poll makes the first tweet a poll. A poll cannot carry media.
	Poll *XPoll `json:"poll,omitempty"`
}

type XPoll struct {
	Options         []string `json:"options"`
	DurationMinutes int      `json:"duration_minutes,omitempty"`
}

type XThreadTweet struct {
	Content   string   `json:"content"`
	MediaURLs []string `json:"media_urls,omitempty"`
	MediaIDs  []string `json:"media_ids,omitempty"`
}

type YouTubeOptions struct {
	// Title is up to 100 characters, without < or >. Left out, it is the
	// first line of the content.
	Title string `json:"title,omitempty"`
	// Description replaces the content as the video's description: up to
	// 5000 bytes, without < or >.
	Description string `json:"description,omitempty"`
	// Privacy is public (the default), unlisted or private.
	Privacy string `json:"privacy,omitempty"`
	// MadeForKids is the uploader's declaration that the video is made for
	// children, which YouTube asks of every upload. Ask the person rather
	// than choosing; left out, nothing is declared and the channel's default
	// audience setting, if it has one, applies.
	MadeForKids *bool `json:"made_for_kids,omitempty"`
	// Tags are up to 500 characters in all, counting a comma between tags
	// and quotes around a tag with a space in it.
	Tags []string `json:"tags,omitempty"`
	// CategoryID is a YouTube category id: 1 Film & Animation, 2 Autos &
	// Vehicles, 10 Music, 15 Pets & Animals, 17 Sports, 19 Travel & Events,
	// 20 Gaming, 22 People & Blogs (the default), 23 Comedy, 24
	// Entertainment, 25 News & Politics, 26 Howto & Style, 27 Education, 28
	// Science & Technology or 29 Nonprofits & Activism.
	CategoryID string `json:"category_id,omitempty"`
	// FirstComment is posted on the video once it is up, up to 10000
	// characters. The channel must have allowed first comments in the
	// dashboard composer, and a video made for kids takes no comments.
	FirstComment string `json:"first_comment,omitempty"`
	// ThumbnailURL (a public https link to a JPEG or PNG) or ThumbnailID
	// (an upload id from CreateUpload) sets a custom thumbnail, which
	// YouTube allows only on verified channels. When a post is read back,
	// ThumbnailURL holds the thumbnail it carries.
	ThumbnailURL string `json:"thumbnail_url,omitempty"`
	ThumbnailID  string `json:"thumbnail_id,omitempty"`
}