fopost 0.2.0 → 0.3.0

data/lib/fopost/models.rb

@@ -4,12 +4,44 @@ require 'fopost/model'
 
 module Fopost
   class MediaItem < Model
+    attribute :id
     attribute :type
     attribute :name
     attribute :url
     attribute :size
     attribute :alt
     attribute :thumbnail
+    attribute :preview_url
+  end
+
+  # Where and how to PUT the bytes of a direct upload.
+  class PresignedUpload < Model
+    attribute :upload_id
+    attribute :upload_url
+    attribute :method
+    attribute :headers, :hash
+    attribute :expires_at, :time
+    attribute :max_file_bytes
+  end
+
+  # The next connected-accounts tier and the ceiling it unlocks.
+  class UploadLimitTier < Model
+    attribute :up_to_accounts
+    attribute :max_file_bytes
+  end
+
+  # What the workspace may upload: the ceiling by any route, the multipart
+  # ceiling per file, and how many files one request takes.
+  class UploadLimits < Model
+    attribute :max_file_bytes
+    attribute :source
+    attribute :connected_accounts
+    attribute :large_uploads_enabled
+    attribute :next_tier, UploadLimitTier
+    attribute :multipart_max_file_bytes
+    attribute :max_files_per_upload
+    attribute :direct_upload_available
+    attribute :allowed_types
   end
 
   # One block of a post. A thread is several blocks in order.
@@ -32,6 +64,487 @@ module Fopost
     attribute :is_primary
     attribute :health_status
     attribute :last_health_check, :time
+    attribute :platform_name
+    # True when the account was connected before a permission it now needs was asked for.
+    attribute :reconnect_required
+  end
+
+  # The result of renaming an account; `name` is the override when set, else the platform name.
+  class AccountRename < Model
+    attribute :id
+    attribute :name
+    attribute :platform_name
+  end
+
+  # The result of moving an account to another workspace.
+  class AccountMove < Model
+    attribute :id
+    attribute :workspace_id
+  end
+
+  # A one-time code that connects a Telegram chat; send `command` to the bot there.
+  class TelegramConnectCode < Model
+    attribute :code
+    attribute :command
+    attribute :bot_username
+    attribute :deep_link
+    attribute :group_link
+    attribute :expires_at, :time
+  end
+
+  # Where a connect code stands: `pending`, `connected`, `failed` or `expired`.
+  class TelegramConnectStatus < Model
+    attribute :status
+    attribute :account_id
+    attribute :reason
+  end
+
+  # One entry in the bot's command menu.
+  class TelegramBotCommand < Model
+    attribute :command
+    attribute :description
+  end
+
+  # The command menu the bot shows in a connected chat.
+  class TelegramBotCommands < Model
+    attribute :commands, [TelegramBotCommand]
+  end
+
+  # A tappable prompt Messenger or Instagram shows before the first message.
+  class MetaIceBreaker < Model
+    attribute :question
+    attribute :payload
+  end
+
+  # The ice breakers set on one account.
+  class MetaIceBreakers < Model
+    attribute :ice_breakers, [MetaIceBreaker]
+  end
+
+  # A menu item: a `postback` with a payload, or a `web_url` with a link.
+  class MetaMenuItem < Model
+    attribute :type
+    attribute :title
+    attribute :payload
+    attribute :url
+  end
+
+  # One locale's menu; `default` is the fallback every language uses.
+  class MetaPersistentMenuEntry < Model
+    attribute :locale
+    attribute :call_to_actions, [MetaMenuItem]
+    attribute :composer_input_disabled
+  end
+
+  # The persistent menu set on one account, one entry per locale.
+  class MetaPersistentMenu < Model
+    attribute :persistent_menu, [MetaPersistentMenuEntry]
+  end
+
+  # One locale's greeting, up to 160 characters.
+  class MetaGreetingText < Model
+    attribute :locale
+    attribute :text
+  end
+
+  # The greeting set on one account, one entry per locale.
+  class MetaGreeting < Model
+    attribute :greeting, [MetaGreetingText]
+  end
+
+  # What the network delivers to the FoPost webhook for one account.
+  class WebhookSubscription < Model
+    attribute :subscribed
+    attribute :fields
+    attribute :missing_fields
+  end
+
+  # The outcome of a Messenger thread hand-over; `app_id` is nil when control was taken back.
+  class InboxHandover < Model
+    attribute :app_id
+    attribute :control
+  end
+
+  # A Pinterest board; `id` travels as the `board_id` platform setting to pin to it.
+  class PinterestBoard < Model
+    attribute :id
+    attribute :name
+    attribute :privacy
+    attribute :description
+    attribute :image
+  end
+
+  # A playlist on the channel; `is_default` marks the one a new video joins by default.
+  class YouTubePlaylist < Model
+    attribute :id
+    attribute :title
+    attribute :description
+    attribute :privacy
+    attribute :item_count
+    attribute :thumbnail_url
+    attribute :is_default
+  end
+
+  # A caption track on one of the channel's videos.
+  class YouTubeCaptionTrack < Model
+    attribute :id
+    attribute :language
+    attribute :name
+    attribute :track_kind
+    attribute :is_draft
+    attribute :is_auto_synced
+    attribute :last_updated
+  end
+
+  # One caption track read back as text; `transcript` is SRT.
+  class YouTubeTranscript < Model
+    attribute :caption_id
+    attribute :transcript
+  end
+
+  # The default post languages for a connection; up to three BCP-47 tags.
+  class BlueskyLanguages < Model
+    attribute :languages
+  end
+
+  # The switches TikTok enforces at publish time, set on the account itself.
+  class TikTokCreatorInfo < Model
+    attribute :username
+    attribute :nickname
+    attribute :avatar_url
+    attribute :privacy_level_options
+    attribute :comment_disabled
+    attribute :duet_disabled
+    attribute :stitch_disabled
+    attribute :max_video_post_duration_sec
+  end
+
+  # A track from TikTok's Commercial Music Library; `id` travels as the
+  # `music_id` platform setting.
+  class TikTokMusic < Model
+    attribute :id
+    attribute :title
+    attribute :author
+    attribute :duration_sec
+    attribute :cover_url
+    attribute :preview_url
+  end
+
+  # A place a post can be tagged with; `id` travels as the `location_id`
+  # platform setting.
+  class TikTokPlace < Model
+    attribute :id
+    attribute :name
+    attribute :address
+    attribute :city
+    attribute :country
+  end
+
+  # One of the account's own videos, resolved from a share link. TikTok serves
+  # no raw media file, so `download_url` is the share address.
+  class TikTokVideoSource < Model
+    attribute :video_id
+    attribute :title
+    attribute :description
+    attribute :duration_sec
+    attribute :cover_image_url
+    attribute :share_url
+    attribute :embed_link
+    attribute :download_url
+  end
+
+  # A track a Reel can carry; `id` travels as the `audio_id` platform setting.
+  class InstagramAudio < Model
+    attribute :id
+    attribute :title
+    attribute :artist
+    attribute :duration_ms
+    attribute :audio_type
+    attribute :cover_artwork_url
+    attribute :preview_url
+    attribute :username
+    attribute :is_ads_eligible
+  end
+
+  # What this account has published in the rolling window, and what is left.
+  class InstagramPublishingLimit < Model
+    attribute :quota_usage
+    attribute :quota_total
+    attribute :quota_duration_sec
+    attribute :remaining
+  end
+
+  # A story still inside its 24 hours; `insights` is present only when asked for.
+  class InstagramStory < Model
+    attribute :id
+    attribute :media_type
+    attribute :media_product_type
+    attribute :permalink
+    attribute :media_url
+    attribute :thumbnail_url
+    attribute :caption
+    attribute :timestamp
+    attribute :insights
+  end
+
+  # Insights for one story.
+  class InstagramStoryInsights < Model
+    attribute :story_id
+    attribute :insights
+  end
+
+  # An entity a post can mention; `annotation` is what the post text carries.
+  class LinkedInMention < Model
+    attribute :urn
+    attribute :name
+    attribute :vanity_name
+    attribute :logo_url
+    attribute :type
+    attribute :annotation
+  end
+
+  # A channel the Slack app can post to; `is_current` marks the one this account posts to.
+  # A blog on a connected site. `id` is the platform's own id, never a FoPost
+  # one. Shopify reports every blog on the store; WordPress has one implicit
+  # blog and reports it under the id `default`, so both answer the same shape.
+  class RemoteBlog < Model
+    attribute :id
+    attribute :title
+    attribute :handle
+    attribute :url
+  end
+
+  # An article that already lives on a connected site.
+  class RemoteArticle < Model
+    attribute :id
+    attribute :blog_id
+    attribute :title
+    attribute :body_html
+    attribute :excerpt
+    # published, draft, pending or scheduled.
+    attribute :status
+    attribute :author_name
+    attribute :tags
+    attribute :image_url
+    attribute :url
+    attribute :published_at, :time
+    attribute :updated_at, :time
+  end
+
+  # A product on a connected store. `price` is the lowest variant price.
+  class RemoteProduct < Model
+    attribute :id
+    attribute :title
+    attribute :handle
+    # active, draft or archived.
+    attribute :status
+    attribute :description
+    attribute :vendor
+    attribute :product_type
+    attribute :tags
+    attribute :image_url
+    attribute :url
+    attribute :price
+    attribute :currency
+    attribute :updated_at, :time
+  end
+
+  class SlackChannel < Model
+    attribute :id
+    attribute :name
+    attribute :is_private
+    attribute :is_member
+    attribute :is_current
+  end
+
+  # A person in the connected Slack workspace; `id` is the handle for starting a DM.
+  class SlackMember < Model
+    attribute :id
+    attribute :name
+    attribute :real_name
+    attribute :display_name
+    attribute :avatar
+    attribute :is_bot
+  end
+
+  # The name and icon a Slack account posts under; nil means the app default.
+  class SlackIdentity < Model
+    attribute :username
+    attribute :icon_url
+    attribute :icon_emoji
+  end
+
+  # A Discord text channel the bot can post to; `is_current` marks this account's.
+  class DiscordChannel < Model
+    attribute :id
+    attribute :name
+    # Discord's channel type: 0 text, 5 announcement, 15 forum.
+    attribute :type
+    attribute :parent_id
+    attribute :nsfw
+    # False when a channel permission in Discord shuts the bot out.
+    attribute :can_post
+    attribute :is_current
+  end
+
+  # The nickname and avatar the bot wears in the server; nil means its own.
+  class DiscordIdentity < Model
+    attribute :username
+    attribute :avatar_url
+  end
+
+  # A message in the connected channel.
+  class DiscordMessage < Model
+    attribute :id
+    attribute :channel_id
+    attribute :content
+    attribute :author_id
+    attribute :author_name
+    attribute :pinned
+    attribute :created_at
+  end
+
+  # A message the bot put somewhere.
+  class DiscordMessageRef < Model
+    attribute :id
+    attribute :channel_id
+  end
+
+  # A thread started on a message.
+  class DiscordThread < Model
+    attribute :id
+    attribute :name
+    attribute :parent_id
+  end
+
+  # An event on the server's calendar; `channel_id` is a voice or stage channel,
+  # otherwise `location` says where it happens.
+  class DiscordScheduledEvent < Model
+    attribute :id
+    attribute :name
+    attribute :description
+    attribute :channel_id
+    attribute :location
+    attribute :start_time
+    attribute :end_time
+    # One of scheduled, active, completed, canceled.
+    attribute :status
+    attribute :user_count
+  end
+
+  # A person in the connected server; `id` is the member id for a DM or a role.
+  class DiscordMember < Model
+    attribute :id
+    attribute :username
+    attribute :display_name
+    attribute :nick
+    attribute :avatar
+    attribute :is_bot
+    attribute :roles
+    attribute :joined_at
+  end
+
+  # A role in the connected server; `permissions` is Discord's bitfield as a decimal string.
+  class DiscordRole < Model
+    attribute :id
+    attribute :name
+    attribute :color
+    attribute :hoist
+    attribute :mentionable
+    # A managed role belongs to an integration and cannot be edited.
+    attribute :managed
+    attribute :position
+    attribute :permissions
+  end
+
+  # One metric a network reports under its own name. `key` is the platform's own
+  # name and is stable; `label` is ours and may be reworded. `value` is a number
+  # for every kind but `series`, which is an array of points.
+  class PlatformMetricRow < Model
+    attribute :key
+    attribute :label
+    attribute :kind
+    attribute :value
+  end
+
+  # One side of a per-network metric set: the account itself, or its newest
+  # measured post. `external_post_id` is nil on the account side.
+  class PlatformMetricsBlock < Model
+    attribute :fetched_at
+    attribute :external_post_id
+    attribute :metrics, [PlatformMetricRow]
+  end
+
+  # What only this network reports, in its own vocabulary.
+  class AccountPlatformMetrics < Model
+    attribute :platform
+    attribute :account, PlatformMetricsBlock
+    attribute :post, PlatformMetricsBlock
+  end
+
+  # A subreddit the account is in, or its own profile page. `can_post` is false
+  # where it may read but not submit.
+  class RedditSubreddit < Model
+    attribute :name
+    attribute :title
+    attribute :subscribers
+    attribute :over18
+    attribute :can_post
+    attribute :flair_enabled
+    attribute :icon_url
+    attribute :is_default
+  end
+
+  # One rule a subreddit publishes; `applies_to` is 'link', 'comment' or 'all'.
+  class RedditSubredditRule < Model
+    attribute :name
+    attribute :description
+    attribute :applies_to
+  end
+
+  # The rules a subreddit publishes, in its own order.
+  class RedditSubredditRules < Model
+    attribute :subreddit
+    attribute :rules, [RedditSubredditRule]
+  end
+
+  # A post flair, valid only in the subreddit it came from.
+  class RedditFlair < Model
+    attribute :id
+    attribute :text
+    # Whether the label may be replaced with your own text.
+    attribute :editable
+  end
+
+  # Post flairs one subreddit offers.
+  class RedditFlairs < Model
+    attribute :subreddit
+    attribute :flairs, [RedditFlair]
+  end
+
+  # Where posts go when a post names none; nil means the account's own profile page.
+  class RedditDefaultSubreddit < Model
+    attribute :subreddit
+  end
+
+  # `ok` is true when the subreddit exists and takes a post from this account.
+  class SubredditCheck < Model
+    attribute :subreddit
+    attribute :exists
+    attribute :can_post
+    # The API field is over_18.
+    attribute :over_18 # rubocop:disable Naming/VariableNumber
+    attribute :flair_enabled
+    attribute :ok
+  end
+
+  # A named set of connected accounts in one workspace.
+  class AccountGroup < Model
+    attribute :id
+    attribute :name
+    attribute :account_ids
+    attribute :created_at, :time
+    attribute :updated_at, :time
   end
 
   # An account a post is targeted at, plus its per-account delivery state.
@@ -123,41 +636,195 @@ module Fopost
     attribute :external_url
   end
 
-  class PageMeta < Model
-    attribute :current_page
-    attribute :per_page
-    attribute :total
-    attribute :last_page
-    attribute :from
-    attribute :to
+  # ── Analytics ────────────────────────────────────────────────────
+
+  # One age band of GET /analytics/decay.
+  class DecayBand < Model
+    attribute :bucket
+    attribute :label
+    # Posts with at least one reading in this band.
+    attribute :posts
+    attribute :avg_engagements
+    attribute :avg_impressions
+    # Mean share of the post's final engagement reached by this age, 0-1.
+    attribute :share_of_final
   end
 
-  # One page of a list endpoint: its items plus the pagination meta.
-  class Page
-    include Enumerable
+  # How engagement accumulates as a post ages.
+  class ContentDecay < Model
+    attribute :days
+    attribute :posts_measured
+    # First band where the average post had passed half its final engagement.
+    attribute :half_life_bucket
+    attribute :bands, [DecayBand]
+  end
 
-    attr_reader :items, :meta
+  class FrequencyWeek < Model
+    # Monday of the week, UTC, as YYYY-MM-DD.
+    attribute :week_start
+    attribute :posts
+    attribute :engagements
+    attribute :avg_engagements_per_post
+  end
 
-    def initialize(items: [], meta: PageMeta.new)
-      @items = items
-      @meta = meta
-    end
+  class FrequencyBand < Model
+    attribute :band
+    attribute :label
+    attribute :weeks
+    attribute :posts
+    attribute :avg_posts_per_week
+    attribute :avg_engagements_per_post
+    # Engagements over reach, impressions as the stand-in; nil with neither.
+    attribute :engagement_rate
+  end
 
-    def each(&block)
-      return items.each unless block
+  # Weekly cadence set against what each cadence earned per post.
+  class PostingFrequency < Model
+    attribute :days
+    attribute :weeks, [FrequencyWeek]
+    attribute :bands, [FrequencyBand]
+    # The cadence that earned the most per post; nil without posts.
+    attribute :best, FrequencyBand
+  end
 
-      items.each(&block)
-      self
-    end
+  # What moved between one timeline point and the one before it.
+  class TimelineDelta < Model
+    attribute :impressions
+    attribute :reach
+    attribute :engagements
+    attribute :likes
+    attribute :comments
+    attribute :shares
+  end
 
-    def [](index)
-      items[index]
-    end
+  class TimelinePoint < Model
+    attribute :at, :time
+    # Minutes since publication; nil when the network never said when.
+    attribute :age_minutes
+    attribute :impressions
+    attribute :reach
+    attribute :engagements
+    attribute :likes
+    attribute :comments
+    attribute :shares
+    attribute :video_views
+    attribute :delta, TimelineDelta
+  end
 
-    def size
-      items.size
-    end
-    alias length size
+  # One delivery's readings: the same post on two networks decays differently.
+  class TimelineDelivery < Model
+    attribute :account_id
+    attribute :platform
+    attribute :username
+    attribute :external_post_id
+    attribute :posted_at, :time
+    attribute :points, [TimelinePoint]
+  end
+
+  # Every reading held for one post, one timeline per delivery.
+  class PostTimeline < Model
+    # nil when the post was made natively on the network.
+    attribute :post_id
+    attribute :deliveries, [TimelineDelivery]
+  end
+
+  class MetricChange < Model
+    attribute :account_id
+    attribute :platform
+    attribute :external_post_id
+    # nil for a post made natively on the network.
+    attribute :post_id
+    attribute :posted_at, :time
+    attribute :fetched_at, :time
+    attribute :impressions
+    attribute :reach
+    attribute :engagements
+    attribute :likes
+    attribute :comments
+    attribute :shares
+  end
+
+  # Readings since a cursor, with the cursor to pass next time.
+  class MetricChangePage < Model
+    attribute :since, :time
+    # Feed back as `since` to continue; nil when nothing changed.
+    attribute :cursor, :time
+    attribute :has_more
+    attribute :changes, [MetricChange]
+  end
+
+  class CollectPostDelivery < Model
+    attribute :account_id
+    attribute :platform
+    attribute :external_post_id
+    attribute :collected
+    attribute :fetched_at, :time
+    # Why the refresh did not happen.
+    attribute :message
+  end
+
+  class CollectPostResult < Model
+    attribute :collected
+    attribute :deliveries, [CollectPostDelivery]
+  end
+
+  class NativePostMetrics < Model
+    attribute :impressions
+    attribute :reach
+    attribute :engagements
+    attribute :likes
+    attribute :comments
+    attribute :shares
+    attribute :video_views
+  end
+
+  # A post on the account that never went out through FoPost.
+  class NativePost < Model
+    attribute :external_post_id
+    attribute :text
+    attribute :permalink
+    attribute :thumbnail_url
+    attribute :media_type
+    attribute :posted_at, :time
+    attribute :fetched_at, :time
+    attribute :metrics, NativePostMetrics
+  end
+
+  class PageMeta < Model
+    attribute :current_page
+    attribute :per_page
+    attribute :total
+    attribute :last_page
+    attribute :from
+    attribute :to
+  end
+
+  # One page of a list endpoint: its items plus the pagination meta.
+  class Page
+    include Enumerable
+
+    attr_reader :items, :meta
+
+    def initialize(items: [], meta: PageMeta.new)
+      @items = items
+      @meta = meta
+    end
+
+    def each(&block)
+      return items.each unless block
+
+      items.each(&block)
+      self
+    end
+
+    def [](index)
+      items[index]
+    end
+
+    def size
+      items.size
+    end
+    alias length size
     alias count size
 
     def empty?
@@ -206,6 +873,49 @@ module Fopost
     attribute :credits, AiCredits
   end
 
+  # Advisory note from a validate call; never blocks publishing.
+  class ValidateSignal < Model
+    attribute :level
+    attribute :code
+    attribute :message
+  end
+
+  class ValidatePostPlatform < Model
+    attribute :platform
+    attribute :ready
+    attribute :issues
+    attribute :score
+    attribute :signals, [ValidateSignal]
+  end
+
+  class ValidatePostResult < Model
+    attribute :ready
+    attribute :platforms, [ValidatePostPlatform]
+  end
+
+  class ValidateLengthPlatform < Model
+    attribute :platform
+    attribute :length
+    attribute :limit
+    attribute :unit
+    attribute :ok
+    attribute :signals, [ValidateSignal]
+  end
+
+  class ValidateLengthResult < Model
+    attribute :ok
+    attribute :platforms, [ValidateLengthPlatform]
+  end
+
+  class ValidateMediaResult < Model
+    attribute :ok
+    attribute :issues
+    attribute :name
+    attribute :size
+    attribute :mime_type
+    attribute :type
+  end
+
   # `page`, `per_page`, `total` on the inbox list endpoints.
   class InboxPageMeta < Model
     attribute :page
@@ -245,7 +955,7 @@ module Fopost
     attribute :published, :hash
   end
 
-  # A comment, mention or direct message on a connected account.
+  # A comment, mention, review or direct message on a connected account.
   class InboxItem < Model
     attribute :id
     attribute :workspace_id
@@ -258,6 +968,8 @@ module Fopost
     attribute :author_handle
     attribute :author_avatar_url
     attribute :text
+    # Stars on a review, 1-5. Nil on every other type.
+    attribute :rating
     attribute :attachments, [InboxAttachment]
     attribute :permalink
     attribute :post_external_id
@@ -268,8 +980,24 @@ module Fopost
     attribute :created_at, :time
     attribute :can_reply
     attribute :hidden
+    attribute :liked
+    # How the account voted where the network ranks by votes: 'up', 'down' or nil.
+    attribute :vote
+    attribute :pinned
+    attribute :reaction
+    attribute :edited_at, :time
     attribute :can_hide
     attribute :can_delete
+    attribute :can_like
+    attribute :can_vote
+    attribute :can_pin
+    attribute :can_edit
+    attribute :can_react
+    attribute :can_send_media
+    attribute :can_quick_reply
+    attribute :can_private_reply
+    # The platform's own state: published, held, spam or rejected.
+    attribute :moderation_status
     attribute :post, :hash
     attribute :post_context, InboxPostContext
     attribute :account, InboxAccountRef
@@ -285,6 +1013,8 @@ module Fopost
     attribute :last_comment_at, :time
     attribute :last_comment_text
     attribute :last_comment_author
+    # Stars, on a review thread. Nil on comments and mentions.
+    attribute :rating
     attribute :post, InboxPostContext
     attribute :account, InboxAccountRef
   end
@@ -314,6 +1044,46 @@ module Fopost
     attribute :pending_reason
     attribute :dm_supported
     attribute :dm_pending_reason
+    attribute :can_start_conversation
+    # The grant predates a permission the inbox needs; reconnect the account once.
+    attribute :reconnect_required
+  end
+
+  # One thing the workspace has told FoPost about itself: an FAQ, a note, a page
+  # on its own site, or a plain-text/CSV file from the media library.
+  class KnowledgeSource < Model
+    attribute :id
+    # `faq`, `text`, `url` or `file`.
+    attribute :kind
+    attribute :title
+    # Only a `ready` source is searched.
+    attribute :status
+    # Why the last sync failed, in plain words.
+    attribute :status_message
+    # Set for `url` sources.
+    attribute :url
+    # Set for `file` sources: the media library item read.
+    attribute :media_id
+    # nil means the source serves the whole workspace.
+    attribute :brand_voice_id
+    # Searchable passages the last sync produced.
+    attribute :chunk_count
+    # The typed text, for `faq` and `text` sources only.
+    attribute :content
+    attribute :last_synced_at, :time
+    attribute :created_at, :time
+    attribute :updated_at, :time
+  end
+
+  # One retrieved passage, with the source it came from so a reply can cite it.
+  class KnowledgeMatch < Model
+    attribute :source_id
+    attribute :source_title
+    attribute :source_kind
+    attribute :source_url
+    attribute :text
+    # Similarity to the question, 0-1.
+    attribute :score
   end
 
   class InboxPlatform < Model
@@ -337,6 +1107,12 @@ module Fopost
     attribute :reply, :hash
   end
 
+  # A DM opened by handle or as a private reply to a comment.
+  class InboxStartedConversation < Model
+    attribute :conversation_id
+    attribute :item, InboxItem
+  end
+
   class InboxRefreshResult < Model
     attribute :accounts_polled
     attribute :new_items
@@ -408,8 +1184,21 @@ module Fopost
   end
 
   # A connection with the ad accounts and Pages its grant reaches.
+  # An ad network from the API's registry. `configured` false cannot be connected yet.
+  class AdProvider < Model
+    attribute :id
+    attribute :name
+    attribute :logo
+    attribute :configured
+    attribute :connect_methods
+    attribute :capabilities
+    attribute :targeting_facets
+    attribute :tracking_macros
+  end
+
   class AdSource < Model
     attribute :connection_id
+    attribute :provider
     attribute :name
     attribute :workspace_id
     attribute :ad_accounts
@@ -448,6 +1237,51 @@ module Fopost
     attribute :detail
   end
 
+  # A Business Center, or the network's equivalent grouping of ad accounts.
+  class AdBusinessCenter < Model
+    attribute :id
+    attribute :name
+    attribute :role
+  end
+
+  # The account an ad runs as. Meta calls it a Page, TikTok an identity.
+  class AdIdentity < Model
+    attribute :id
+    attribute :type
+    attribute :name
+    attribute :avatar_url
+  end
+
+  # A post already live on the network, offered as the source of a Spark ad.
+  class SparkPost < Model
+    attribute :id
+    attribute :identity_id
+    attribute :caption
+    attribute :thumbnail_url
+    attribute :created_at
+    attribute :views
+  end
+
+  # A comment on an ad, read live from the network and never stored.
+  class AdComment < Model
+    attribute :id
+    attribute :ad_id
+    attribute :text
+    attribute :author_name
+    attribute :author_avatar_url
+    attribute :created_at
+    attribute :likes
+    attribute :reply_count
+    attribute :hidden
+    attribute :parent_id
+  end
+
+  # One page of an ad's comments; pass `next_cursor` back as `after`.
+  class AdCommentsPage < Model
+    attribute :comments, [AdComment]
+    attribute :next_cursor
+  end
+
   class LeadForm < Model
     attribute :id
     attribute :name
@@ -482,4 +1316,997 @@ module Fopost
     attribute :leads, [Lead]
     attribute :next_cursor
   end
+
+  # A Meta ad inside an ad set. Read live from Meta, never stored.
+  class NetworkAd < Model
+    attribute :id
+    attribute :name
+    attribute :campaign_id
+    attribute :ad_set_id
+    attribute :creative_id
+    attribute :status
+    attribute :effective_status
+    attribute :created_at, :time
+  end
+
+  class AdSet < Model
+    attribute :id
+    attribute :name
+    attribute :campaign_id
+    attribute :status
+    attribute :effective_status
+    attribute :budget_minor
+    attribute :budget_type
+    attribute :end_at, :time
+    attribute :optimization_goal
+    attribute :created_at, :time
+    attribute :ads, [NetworkAd]
+  end
+
+  class AdCampaign < Model
+    attribute :id
+    attribute :name
+    attribute :status
+    attribute :effective_status
+    attribute :objective
+    attribute :budget_minor
+    attribute :budget_type
+    attribute :created_at, :time
+    attribute :ad_sets, [AdSet]
+  end
+
+  # Campaigns with their ad sets and ads, read live from Meta.
+  class AdAccountTree < Model
+    attribute :ad_account_id
+    attribute :currency
+    attribute :workspace_id
+    attribute :campaigns, [AdCampaign]
+  end
+
+  class BulkAdStatusResult < Model
+    attribute :id
+    attribute :level
+    attribute :ok
+    attribute :error
+  end
+
+  class AdCreative < Model
+    attribute :id
+    attribute :name
+    attribute :format
+    attribute :status
+    attribute :title
+    attribute :body
+    attribute :link
+    attribute :thumbnail_url
+    attribute :call_to_action
+    attribute :url_tags
+  end
+
+  # ─── Product catalogs ──────────────────────────────────────────
+
+  # A product catalog on the connection's business portfolio, read live.
+  class ProductCatalog < Model
+    attribute :id
+    attribute :name
+    attribute :vertical
+    attribute :product_count
+  end
+
+  class ProductCatalogsResult < Model
+    attribute :catalogs, [ProductCatalog]
+    attribute :workspace_id
+  end
+
+  # One product in a catalog. `price_minor` is minor units of `currency`.
+  class CatalogProduct < Model
+    attribute :id
+    # Your own key for the product.
+    attribute :retailer_id
+    attribute :name
+    attribute :description
+    attribute :availability
+    attribute :condition
+    attribute :price_minor
+    attribute :currency
+    attribute :image_url
+    attribute :url
+  end
+
+  class CatalogProductsPage < Model
+    attribute :products, [CatalogProduct]
+    attribute :next_cursor
+  end
+
+  class CatalogBatchResult < Model
+    attribute :handles
+    # Products sent in this batch.
+    attribute :accepted
+  end
+
+  # Keeps a catalog in step with a product file you host.
+  class ProductFeed < Model
+    attribute :id
+    attribute :name
+    attribute :url
+    attribute :schedule
+    attribute :created_at, :time
+  end
+
+  class ProductFeedUpload < Model
+    attribute :id
+    attribute :started_at, :time
+    attribute :ended_at, :time
+    attribute :status
+    attribute :error_count
+    attribute :warning_count
+  end
+
+  # The slice of a catalog one catalog ad runs from.
+  class ProductSet < Model
+    attribute :id
+    attribute :name
+    attribute :product_count
+    # The network's own product-set filter.
+    attribute :filter
+  end
+
+  # ─── Reach and frequency ───────────────────────────────────────
+
+  # A priced flight. Nothing is bought until it is reserved.
+  class ReachFrequencyPrediction < Model
+    attribute :id
+    attribute :name
+    attribute :status
+    attribute :reach
+    attribute :impressions
+    attribute :frequency_cap
+    # Account currency, minor units.
+    attribute :budget_minor
+    attribute :start_at, :time
+    attribute :end_at, :time
+    # True once the prediction holds inventory.
+    attribute :reserved
+  end
+
+  class ReachFrequencyResult < Model
+    attribute :predictions, [ReachFrequencyPrediction]
+    attribute :workspace_id
+  end
+
+  # ─── Ad Library ────────────────────────────────────────────────
+
+  # One public archive entry. Read live on every search and stored nowhere.
+  class AdLibraryEntry < Model
+    attribute :id
+    attribute :page_id
+    attribute :page_name
+    attribute :bodies
+    attribute :titles
+    attribute :link_urls
+    attribute :snapshot_url
+    attribute :publisher_platforms
+    attribute :started_at, :time
+    attribute :ended_at, :time
+    # Only on the archive's disclosure entries.
+    attribute :currency
+    attribute :spend_lower
+    attribute :spend_upper
+    attribute :impressions_lower
+    attribute :impressions_upper
+  end
+
+  class AdLibraryPage < Model
+    attribute :entries, [AdLibraryEntry]
+    attribute :next_cursor
+  end
+
+  # ─── Partnership ads ───────────────────────────────────────────
+
+  # A creator who allowlisted this advertiser for partnership ads.
+  class PartnershipCreator < Model
+    attribute :id
+    attribute :username
+    attribute :name
+    attribute :status
+    attribute :permissions
+  end
+
+  # ─── Ad account settings ───────────────────────────────────────
+
+  class AdActivity < Model
+    attribute :id
+    attribute :event_type
+    attribute :actor_name
+    attribute :object_name
+    attribute :object_type
+    attribute :extra_data
+    attribute :created_at, :time
+  end
+
+  class AdActivityResult < Model
+    attribute :activity, [AdActivity]
+    attribute :workspace_id
+  end
+
+  # Groups campaigns, ad sets and ads for reporting.
+  class AdLabel < Model
+    attribute :id
+    attribute :name
+    attribute :created_at, :time
+  end
+
+  # An A/B study splitting traffic across its cells.
+  class AdStudy < Model
+    attribute :id
+    attribute :name
+    attribute :description
+    attribute :type
+    attribute :status
+    attribute :start_at, :time
+    attribute :end_at, :time
+  end
+
+  # How many iOS 14 campaigns an ad account may run at once, per app.
+  class IosCampaignLimits < Model
+    attribute :limit
+    attribute :used
+    attribute :app_id
+  end
+
+  # A window the network should expect heavier spend over.
+  class HighDemandPeriod < Model
+    attribute :id
+    attribute :start_at, :time
+    attribute :end_at, :time
+    attribute :budget_value
+    attribute :budget_value_type
+  end
+
+  # Weights conversions so some audiences count for more than others.
+  class ValueRuleSet < Model
+    attribute :id
+    attribute :name
+    attribute :status
+    attribute :rules
+  end
+
+  class ReachEstimate < Model
+    attribute :lower
+    attribute :upper
+    attribute :ready
+  end
+
+  # What the auction costs, in minor units of the ad account currency.
+  class BidPricing < Model
+    attribute :currency
+    attribute :suggested_bid_minor
+    attribute :min_bid_minor
+    attribute :max_bid_minor
+    attribute :daily_budget_floor_minor
+  end
+
+  # What an audience would deliver at a budget, over the network's own window.
+  class SupplyForecast < Model
+    attribute :currency
+    attribute :impressions
+    attribute :clicks
+    attribute :spend_minor
+    attribute :window_days
+    attribute :ready
+  end
+
+  # How the network attributes a sale or a sign-up back to an ad set.
+  class ConversionRule < Model
+    attribute :id
+    attribute :name
+    attribute :type
+    attribute :attribution
+    attribute :post_click_window_days
+    attribute :view_through_window_days
+    attribute :value_minor
+    attribute :currency
+    attribute :enabled
+    attribute :created_at
+    attribute :campaign_ids
+  end
+
+  class ConversionMetrics < Model
+    attribute :conversions
+    attribute :post_click_conversions
+    attribute :view_through_conversions
+    attribute :value_minor
+    attribute :cost_per_conversion_minor
+  end
+
+  # `spend_minor` is in the ad account currency, minor units; `ctr` is a percentage.
+  class InsightsMetrics < Model
+    attribute :impressions
+    attribute :reach
+    attribute :clicks
+    attribute :spend_minor
+    attribute :ctr
+    attribute :leads
+  end
+
+  class InsightsBreakdownRow < Model
+    attribute :key
+    attribute :metrics, InsightsMetrics
+  end
+
+  class InsightsTimelineRow < Model
+    attribute :date
+    attribute :metrics, InsightsMetrics
+  end
+
+  class AdInsightsReport < Model
+    attribute :currency
+    attribute :since
+    attribute :until
+    attribute :breakdown_by
+    attribute :totals, InsightsMetrics
+    attribute :breakdown, [InsightsBreakdownRow]
+    attribute :timeline, [InsightsTimelineRow]
+
+    # The Meta id the report covers; `object_id` is taken by Ruby itself.
+    def meta_object_id
+      self['objectId']
+    end
+  end
+
+  class LeadFormDetail < Model
+    attribute :id
+    attribute :name
+    attribute :status
+    attribute :leads_count
+    attribute :created_at, :time
+    attribute :questions
+    attribute :page_id
+    attribute :privacy_policy_url
+    attribute :locale
+  end
+
+  # A lead stored from a subscribed Page.
+  class FeedLead < Model
+    attribute :id
+    attribute :lead_id
+    attribute :connection_id
+    attribute :page_id
+    attribute :form_id
+    attribute :ad_id
+    attribute :ad_name
+    attribute :campaign_name
+    attribute :platform
+    attribute :is_organic
+    attribute :fields
+    attribute :submitted_at, :time
+    attribute :workspace_id
+  end
+
+  # One page of the leads feed; pass `next_cursor` back as `cursor:` for the next.
+  class LeadsFeedPage < Model
+    attribute :leads, [FeedLead]
+    attribute :next_cursor
+  end
+
+  # Who did something: `user`, `api_key`, `agent` or `system`.
+  class ActivityActor < Model
+    attribute :type
+    attribute :name
+  end
+
+  # One thing that happened in a workspace. A `security` kind is an audit row.
+  class ActivityEvent < Model
+    attribute :id
+    attribute :workspace_id
+    attribute :kind
+    attribute :ref_type
+    attribute :ref_id
+    attribute :summary
+    attribute :actor, ActivityActor
+    attribute :time, :time
+  end
+
+  # One page of activity; pass `next_cursor` back as `cursor:` for the next.
+  class ActivityPage < Model
+    attribute :events, [ActivityEvent]
+    attribute :next_cursor
+  end
+
+  class LeadPage < Model
+    attribute :connection_id
+    attribute :page_id
+    attribute :page_name
+    attribute :created_at, :time
+    attribute :workspace_id
+  end
+  # ─── Contacts ────────────────────────────────────────────────────
+
+  # One handle on one network. The handle is lower-cased with no leading @.
+  class ContactChannel < Model
+    attribute :platform
+    attribute :handle
+    # The platform's own id for this person, when the network gave us one.
+    attribute :external_id
+  end
+
+  class ContactLabel < Model
+    attribute :id
+    attribute :name
+    attribute :color
+  end
+
+  # One person, however many handles they write from.
+  class Contact < Model
+    attribute :id
+    attribute :display_name
+    attribute :channels, [ContactChannel]
+    # inbox, radar or import — what first created the row.
+    attribute :source
+    attribute :note
+    attribute :first_seen_at, :time
+    attribute :last_seen_at, :time
+    # Custom field values, keyed by field key.
+    attribute :fields, :hash
+    attribute :labels, [ContactLabel]
+    # Only on a listing that spans workspaces.
+    attribute :workspace_id
+  end
+
+  # One thread a contact appears in.
+  class ContactConversation < Model
+    # How the inbox groups it: DM thread id, else root post id, else handle.
+    attribute :key
+    attribute :account_id
+    attribute :account_username
+    attribute :platform
+    attribute :messages
+    attribute :received
+    attribute :sent
+    attribute :last_message_at, :time
+    attribute :last_item_id
+  end
+
+  class ContactImportSkip < Model
+    attribute :row
+    attribute :reason
+  end
+
+  # What a CSV import did.
+  class ContactImportResult < Model
+    attribute :created
+    # Rows that folded into a contact already on file.
+    attribute :merged
+    attribute :skipped, [ContactImportSkip]
+    # Columns that named neither a reserved field nor a custom field.
+    attribute :unknown_columns
+  end
+
+  # A column the workspace invented to keep about its contacts.
+  class ContactField < Model
+    attribute :id
+    # Lower-case key, also the CSV column header. Fixed once created.
+    attribute :key
+    attribute :name
+    # text, number, date, select or boolean.
+    attribute :type
+    # Allowed values when the type is select.
+    attribute :options
+    attribute :position
+  end
+
+  class ConversationAnalyticsRow < Model
+    attribute :key
+    attribute :account_id
+    attribute :platform
+    attribute :received
+    attribute :sent
+    attribute :answered
+    attribute :open
+    # Median minutes to the first reply in this thread.
+    attribute :median_response_minutes
+    attribute :first_message_at, :time
+    attribute :last_message_at, :time
+  end
+
+  # Inbox analytics broken out per thread.
+  class ConversationAnalytics < Model
+    attribute :conversations, [ConversationAnalyticsRow]
+    attribute :total
+    attribute :page
+    attribute :per_page
+  end
+
+  # The pagination block a contacts listing returns.
+  class ContactPageMeta < Model
+    attribute :page
+    attribute :per_page
+    attribute :total
+  end
+
+  # ─── Broadcasts and sequences ────────────────────────────────────
+
+  # What became of a broadcast's recipients, by status.
+  class BroadcastCounts < Model
+    attribute :total
+    attribute :sent
+    # Usually the messaging window doing its job.
+    attribute :skipped
+    attribute :failed
+    attribute :pending
+  end
+
+  # One message, sent into conversations the workspace already has.
+  class Broadcast < Model
+    attribute :id
+    # Internal only; never sent to anyone.
+    attribute :name
+    attribute :text
+    attribute :account_id
+    attribute :audience, :hash
+    # draft, scheduled, sending, sent or cancelled.
+    attribute :status
+    attribute :scheduled_at, :time
+    attribute :sent_at, :time
+    attribute :created_at, :time
+    attribute :counts, BroadcastCounts
+    # Only on a listing that spans workspaces.
+    attribute :workspace_id
+  end
+
+  # One contact on one broadcast, and what became of their message.
+  class BroadcastRecipient < Model
+    attribute :contact_id
+    attribute :display_name
+    # pending, sent, skipped or failed.
+    attribute :status
+    # Why nothing was sent: window_closed, no_conversation or
+    # unsupported_platform. window_closed means the network's messaging
+    # window had shut, so nothing was attempted.
+    attribute :skip_reason
+    attribute :sent_at, :time
+    attribute :error
+  end
+
+  # One message and how long after the previous step it goes out.
+  class SequenceStep < Model
+    attribute :delay_hours
+    attribute :text
+    attribute :media_id
+  end
+
+  # Where a sequence's enrollments stand, by status.
+  class SequenceEnrollmentCounts < Model
+    attribute :total
+    attribute :active
+    attribute :completed
+    attribute :stopped
+    attribute :failed
+  end
+
+  # A series of messages, each a delay after the one before.
+  class Sequence < Model
+    attribute :id
+    attribute :name
+    attribute :account_id
+    attribute :steps, [SequenceStep]
+    # active or paused. A paused sequence fires nothing.
+    attribute :status
+    attribute :created_at, :time
+    attribute :enrollments, SequenceEnrollmentCounts
+    # Only on a listing that spans workspaces.
+    attribute :workspace_id
+  end
+
+  # One contact walking one sequence.
+  class Enrollment < Model
+    attribute :id
+    attribute :contact_id
+    attribute :display_name
+    # Steps already sent, so also the index of the next one.
+    attribute :step
+    attribute :next_at, :time
+    # active, completed, stopped or failed.
+    attribute :status
+    attribute :last_sent_at, :time
+    # On a skipped step, the reason it was skipped.
+    attribute :error
+  end
+
+  # ─── Google Ads ───────────────────────────────────────────────────
+
+  # A keyword on an ad group. `id` is `<customer_id>~keyword~<ad_group_id>~<criterion_id>`.
+  class GoogleKeyword < Model
+    attribute :id
+    attribute :ad_group_id
+    attribute :text
+    attribute :match_type
+    attribute :status
+    # Account currency, minor units.
+    attribute :cpc_bid_minor
+    attribute :negative
+  end
+
+  class GoogleKeywordIdea < Model
+    attribute :text
+    attribute :avg_monthly_searches
+    attribute :competition
+    attribute :low_top_of_page_bid_minor
+    attribute :high_top_of_page_bid_minor
+  end
+
+  class GoogleSearchTerm < Model
+    attribute :term
+    attribute :ad_group_id
+    attribute :status
+    attribute :metrics
+  end
+
+  class GoogleBidStrategy < Model
+    attribute :id
+    attribute :name
+    attribute :type
+    attribute :status
+    attribute :campaign_count
+  end
+
+  class GoogleAdScheduleSlot < Model
+    attribute :id
+    attribute :day_of_week
+    attribute :start_hour
+    attribute :end_hour
+    attribute :bid_modifier
+  end
+
+  # A negative keyword list.
+  class GoogleSharedSet < Model
+    attribute :id
+    attribute :name
+    attribute :type
+    attribute :member_count
+  end
+
+  # A sitelink, callout or structured snippet.
+  class GoogleAsset < Model
+    attribute :id
+    attribute :name
+    attribute :type
+    attribute :text
+    attribute :final_url
+  end
+
+  # Where an asset is attached; an asset with no links serves nowhere.
+  class GoogleAssetLink < Model
+    attribute :id
+    attribute :asset_id
+    attribute :level
+    attribute :owner_id
+    attribute :field_type
+    attribute :status
+  end
+
+  # A Performance Max asset group.
+  class GoogleAssetGroup < Model
+    attribute :id
+    attribute :campaign_id
+    attribute :name
+    attribute :status
+    attribute :final_urls
+  end
+
+  # A lead from Local Services Ads, read live and never stored.
+  class GoogleLocalServicesLead < Model
+    attribute :id
+    attribute :category
+    attribute :service
+    attribute :contact_name
+    attribute :phone
+    attribute :email
+    attribute :status
+    attribute :type
+    attribute :created_at
+  end
+
+  class GoogleConversionAction < Model
+    attribute :id
+    attribute :name
+    attribute :category
+    attribute :status
+    attribute :type
+    attribute :counting_type
+    attribute :value_minor
+  end
+
+  # What Google projects applying a recommendation would change.
+  class GoogleRecommendationImpact < Model
+    attribute :base_clicks
+    attribute :potential_clicks
+    attribute :base_cost_minor
+    attribute :potential_cost_minor
+    attribute :base_conversions
+    attribute :potential_conversions
+  end
+
+  # One of Google's own recommendations. The id is the Google resource name
+  # rather than the `~` form other objects use, because a recommendation is not
+  # an object you address again: it is what apply and dismiss take.
+  class GoogleRecommendation < Model
+    attribute :id
+    attribute :type
+    attribute :campaign_id
+    attribute :ad_group_id
+    attribute :dismissed
+    attribute :impact, GoogleRecommendationImpact
+  end
+
+  class GoogleOptimizationScoreCampaign < Model
+    attribute :id
+    attribute :name
+    attribute :score
+  end
+
+  # Google's estimate of how well the account is set up, from 0 to 1.
+  class GoogleOptimizationScore < Model
+    attribute :score
+    attribute :weight
+    attribute :campaigns, [GoogleOptimizationScoreCampaign]
+  end
+
+  # ─── Blog ─────────────────────────────────────────────────────────
+
+  # The last keyword research run.
+  class BlogPlanRun < Model
+    # queued, running, done or failed.
+    attribute :status
+    attribute :error
+    # New keywords the run found.
+    attribute :added
+    attribute :finished_at, :time
+  end
+
+  # Where articles publish, what the blog is for and how often it is planned.
+  # `website_secret` is never on this model; it is shown once, on the update
+  # that first sets `website_url`, or on a rotation.
+  class BlogSettings < Model
+    attribute :site_url
+    attribute :topic
+    attribute :audience
+    # traffic, leads, sales, signups or authority.
+    attribute :goal
+    attribute :focus_topics
+    attribute :avoid_topics
+    attribute :language
+    attribute :location_code
+    # Articles planned per week; 0 turns planning off.
+    attribute :cadence_per_week
+    # Days before its planned date that a picked keyword starts being written.
+    attribute :review_hold_days
+    # draft, standard or best.
+    attribute :image_tier
+    attribute :in_body_images
+    attribute :min_words
+    attribute :max_words
+    attribute :brand_voice_id
+    # product_blog, account or website.
+    attribute :target_kind
+    attribute :target_account_id
+    attribute :target_platform
+    attribute :website_url
+    attribute :has_website_secret
+    # Nil before the first run.
+    attribute :plan_run, BlogPlanRun
+    attribute :keyword_data_available
+    attribute :updated_at, :time
+  end
+
+  # What a settings update answers: the settings, plus the website secret on
+  # the one update that first set `website_url`.
+  class BlogSettingsUpdate < Model
+    attribute :settings, BlogSettings
+    attribute :website_secret
+  end
+
+  # The outcome of a test delivery to `website_url`.
+  class BlogWebsiteTest < Model
+    # What the website answered.
+    attribute :http_status
+  end
+
+  class BlogKeyword < Model
+    attribute :id
+    attribute :keyword
+    attribute :search_volume
+    # 0 to 100.
+    attribute :difficulty
+    attribute :cpc
+    attribute :intent
+    # provider, user or agent.
+    attribute :source
+    # suggested, planned, written or dismissed.
+    attribute :status
+    # A date, YYYY-MM-DD.
+    attribute :planned_for
+    # Why the keyword serves the blog goal.
+    attribute :fit_reason
+    attribute :created_at, :time
+  end
+
+  class BlogArticleImage < Model
+    attribute :media_id
+    attribute :url
+    attribute :alt
+    # Index of the outline heading the image sits under; absent on the featured image.
+    attribute :position
+  end
+
+  # One article as a listing shows it, without the body.
+  class BlogArticle < Model
+    attribute :id
+    attribute :title
+    attribute :slug
+    attribute :keyword
+    attribute :excerpt
+    attribute :meta_title
+    attribute :meta_description
+    attribute :featured_image, BlogArticleImage
+    attribute :tags
+    attribute :word_count
+    # queued, writing, draft, in_review, scheduled, publishing, published, failed or rejected.
+    attribute :status
+    # plan, user or agent.
+    attribute :origin
+    attribute :review_until, :time
+    attribute :publish_at, :time
+    attribute :published_at, :time
+    attribute :published_url
+    attribute :error
+    attribute :created_at, :time
+    attribute :updated_at, :time
+  end
+
+  # An article with its body, outline and images.
+  class BlogArticleFull < BlogArticle
+    attribute :instructions
+    attribute :outline
+    # The research the writer worked from.
+    attribute :brief, :hash
+    attribute :body_markdown
+    attribute :body_html
+    attribute :images, [BlogArticleImage]
+  end
+
+  # The `data` of an `article.published` webhook. Image URLs stay fetchable
+  # for six hours; a receiver stores its own copy.
+  class BlogArticlePublished < Model
+    attribute :id
+    attribute :title
+    attribute :slug
+    attribute :excerpt
+    attribute :meta_title
+    attribute :meta_description
+    attribute :body_markdown
+    attribute :body_html
+    attribute :featured_image, BlogArticleImage
+    attribute :images, [BlogArticleImage]
+    attribute :tags
+    attribute :keyword
+    attribute :word_count
+    attribute :published_at, :time
+    attribute :published_url
+  end
+
+  # The envelope every FoPost webhook delivers, after its signature checked out.
+  class WebhookEvent < Model
+    attribute :event
+    attribute :data, :hash
+    attribute :timestamp, :time
+
+    # The typed payload of an `article.published` (or `article.test`) delivery.
+    def article
+      BlogArticlePublished.new(data)
+    end
+  end
+
+  # ─── WhatsApp Business ─────────────────────────────────────────
+  #
+  # The platform owns these resources, so nothing here is a cached copy: a
+  # template's status is whatever the platform assigned it.
+
+  # A message template on a WhatsApp Business Account.
+  class WhatsappTemplate < Model
+    attribute :id
+    attribute :name
+    attribute :language
+    attribute :category
+    # The review status the platform assigned: APPROVED, PENDING, REJECTED, …
+    attribute :status
+    attribute :rejected_reason
+    attribute :components
+    attribute :quality_score
+  end
+
+  # The business profile on a WhatsApp number, plus its quality and limit tier.
+  class WhatsappProfile < Model
+    attribute :about
+    attribute :address
+    attribute :description
+    attribute :email
+    attribute :vertical
+    attribute :websites
+    attribute :profile_picture_url
+    attribute :display_name
+    # The platform's review state for the display name.
+    attribute :display_name_status
+    attribute :username
+    attribute :quality_rating
+    attribute :messaging_limit_tier
+  end
+
+  # A group on a WhatsApp number. Participation is invite-only.
+  class WhatsappGroup < Model
+    attribute :id
+    attribute :subject
+    attribute :description
+    attribute :participant_count
+    attribute :invite_link
+    attribute :created_at, :time
+  end
+
+  # What the platform took and what it refused.
+  class WhatsappBlockResult < Model
+    attribute :blocked
+    attribute :unblocked
+    attribute :failed
+  end
+
+  # Whether the cart and catalog show on the number, and which catalog is linked.
+  class WhatsappCommerceSettings < Model
+    attribute :cart_enabled
+    attribute :catalog_visible
+    attribute :catalog_id
+  end
+
+  # An in-chat form. The platform validates it and owns its status.
+  class WhatsappFlow < Model
+    attribute :id
+    attribute :name
+    attribute :status
+    attribute :categories
+    attribute :validation_errors
+    attribute :endpoint_uri
+    attribute :json_version
+    attribute :preview_url
+    attribute :preview_expires_at, :time
+  end
+
+  # The platform answers a flow upload with its validation errors, not a refusal.
+  class WhatsappFlowJsonResult < Model
+    attribute :success
+    attribute :validation_errors
+  end
+
+  # What one person submitted through a flow.
+  class WhatsappFlowResponse < Model
+    attribute :message_id
+    attribute :wa_id
+    attribute :flow_token
+    attribute :answers
+    attribute :responded_at, :time
+  end
+
+  # Whether a key is registered. The key itself never comes back.
+  class WhatsappEncryptionKeyStatus < Model
+    attribute :has_key
+    attribute :signature_status
+  end
+
+  # A sandbox invitation. The tester's number is never stored in full.
+  class WhatsappSandboxSession < Model
+    attribute :id
+    attribute :status
+    attribute :phone_number_last4
+    attribute :invited_at, :time
+    attribute :activated_at, :time
+    attribute :expires_at, :time
+  end
 end