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"`
}

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 or 90d (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"`
}

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 or bluesky.
	Platform string `json:"platform"`
	// Profile is the profile (name or id) the new account goes into.
	Profile string `json:"profile,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 and YouTube hold the options only that platform
	// has. Each needs an account on its platform among the post's accounts.
	X         *XOptions         `json:"x,omitempty"`
	Instagram *InstagramOptions `json:"instagram,omitempty"`
	TikTok    *TikTokOptions    `json:"tiktok,omitempty"`
	YouTube   *YouTubeOptions   `json:"youtube,omitempty"`
}

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 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 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.
	Error string `json:"error,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 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 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)
	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 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"`
	// 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"`
}

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 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"`
}

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

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

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 agreeing to TikTok's Music Usage
	// Confirmation, which TikTok requires before it publishes.
	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 and YouTube replace that platform's options as a
	// whole; an empty object ({}) clears them.
	X         *XOptions         `json:"x,omitempty"`
	Instagram *InstagramOptions `json:"instagram,omitempty"`
	TikTok    *TikTokOptions    `json:"tiktok,omitempty"`
	YouTube   *YouTubeOptions   `json:"youtube,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"`
}

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 UsageCounter     `json:"destination_posts"`
	LinkPosts        UsageLinkCounter `json:"link_posts"`
	XLinkPosts       UsageCounter     `json:"x_link_posts"`
	ByPlatform       map[string]int   `json:"by_platform"`
	RateLimits       UsageRateLimits  `json:"rate_limits"`
}

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"`
}