@postrun/react 2.10.0 → 2.12.0

package/dist/index.d.ts

@@ -2,8 +2,8 @@ import * as react from 'react';
 import { ReactNode, CSSProperties } from 'react';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient, QueryKey } from '@tanstack/react-query';
-import { PostrunClient, ListProfilesQuery, DiscoverableAccountList, Connection, ConnectionKind, ConnectionStatus, ListMediaQuery, ListPostsQuery, ConnectablePlatform, MediaResource, MediaTarget, Metadata, ComposePostInput, PostValidation, MediaKind, XPostVariant, XPoll as XPoll$1, LinkedInPostVariant, InstagramPostVariant, TikTokPostVariant, TikTokCreatorInfo, TikTokOptionsValue } from '@postrun/js';
-export { PostValidation, PostVariant, PostVariantError, TIKTOK_CAPTION_MAX, TikTokCreatorInfo, ValidationIssue, captionMaxFor } from '@postrun/js';
+import { PostrunClient, ListProfilesQuery, DiscoverableAccountList, Connection, ConnectionKind, ConnectionStatus, ListMediaQuery, ListPostsQuery, ConnectablePlatform, MediaResource, MediaTarget, Metadata, ComposePostInput, PostValidation, MediaKind, InstagramPostVariant, PostVariant, LinkedInPostVariant, TikTokPostVariant, XPostVariant, XPoll as XPoll$1, TikTokCreatorInfo, TikTokOptionsValue } from '@postrun/js';
+export { PostValidation, PostVariant, PostVariantError, TIKTOK_CAPTION_MAX, TikTokCreatorInfo, UploadError, ValidationIssue, captionMaxFor } from '@postrun/js';
 import { TwitterComponents } from 'react-tweet';
 
 /**
@@ -939,12 +939,6 @@ declare function useDeleteMedia(): _tanstack_react_query.UseMutationResult<{
     deleted: true;
 }, Error, string, unknown>;
 
-/** A failed direct-to-storage upload, carrying the HTTP status (0 = network). */
-declare class UploadError extends Error {
-    readonly status: number;
-    constructor(status: number, message: string);
-}
-
 /**
  * The calendar/queue filter surface — a date window over `schedule_at` plus a
  * derived-status multi-select, scoped to an optional profile. Picked straight
@@ -977,16 +971,195 @@ declare function usePosts(query?: ListPostsQuery): _tanstack_react_query.UseQuer
             [key: string]: string | number | boolean;
         };
         variants: Array<{
+            platform: "x";
+            post_type: "text" | "single_image" | "multi_image" | "video";
+            settings: {
+                reply_settings?: "everyone" | "following" | "mentionedUsers" | "subscribers" | "verified";
+                quote_tweet_id?: string;
+                poll?: {
+                    options: Array<string>;
+                    duration_minutes: number;
+                    reply_settings?: "following" | "mentionedUsers" | "subscribers" | "verified";
+                };
+                reply?: {
+                    in_reply_to_tweet_id: string;
+                    exclude_reply_user_ids?: Array<string>;
+                    auto_populate_reply_metadata?: boolean;
+                };
+                community_id?: string;
+                for_super_followers_only?: boolean;
+                geo?: {
+                    place_id: string;
+                };
+                card_uri?: string;
+                media_tagged_user_ids?: Array<string>;
+            };
             id: string;
             object: "post_variant";
             connection_id: string | null;
-            platform: "x" | "linkedin" | "facebook_page" | "instagram" | "tiktok";
-            post_type: "text" | "single_image" | "multi_image" | "video" | "reel" | "carousel";
             body: string | null;
             status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                position: number;
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                alt_text_override: string | null;
+            }>;
+        } | {
+            platform: "linkedin";
+            post_type: "text" | "single_image" | "multi_image" | "video";
             settings: {
-                [key: string]: unknown;
+                visibility: "PUBLIC" | "CONNECTIONS";
+                content_kind: "text" | "single_image" | "video" | "multi_image" | "document" | "article" | "poll";
+                article?: {
+                    source: string;
+                    title?: string;
+                    description?: string;
+                    thumbnail_media_id?: string;
+                };
+                poll?: {
+                    question: string;
+                    options: Array<string>;
+                    duration: "ONE_DAY" | "THREE_DAYS" | "SEVEN_DAYS" | "FOURTEEN_DAYS";
+                };
+                document?: {
+                    title: string;
+                };
+                disable_reshare?: boolean;
+                mentions?: Array<{
+                    type: "person" | "organization";
+                    name: string;
+                    urn: string;
+                }>;
+            };
+            id: string;
+            object: "post_variant";
+            connection_id: string | null;
+            body: string | null;
+            status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                position: number;
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                alt_text_override: string | null;
+            }>;
+        } | {
+            platform: "facebook_page";
+            post_type: "text" | "single_image" | "multi_image" | "reel";
+            settings: {
+                link?: string;
+            };
+            id: string;
+            object: "post_variant";
+            connection_id: string | null;
+            body: string | null;
+            status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                position: number;
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                alt_text_override: string | null;
+            }>;
+        } | {
+            platform: "instagram";
+            post_type: "single_image" | "carousel" | "reel";
+            settings: {
+                media_type?: "IMAGE" | "CAROUSEL" | "REELS";
+                location_id?: string;
+                user_tags?: Array<{
+                    username: string;
+                    x: number;
+                    y: number;
+                }>;
+                collaborators?: Array<string>;
+                share_to_feed?: boolean;
+                thumb_offset?: number;
+                cover_url?: string;
+                audio_name?: string;
+            };
+            id: string;
+            object: "post_variant";
+            connection_id: string | null;
+            body: string | null;
+            status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                position: number;
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                alt_text_override: string | null;
+            }>;
+        } | {
+            platform: "tiktok";
+            post_type: "video" | "single_image" | "carousel";
+            settings: {
+                privacy_level?: "PUBLIC_TO_EVERYONE" | "MUTUAL_FOLLOW_FRIENDS" | "FOLLOWER_OF_CREATOR" | "SELF_ONLY";
+                disable_comment?: boolean;
+                disable_duet?: boolean;
+                disable_stitch?: boolean;
+                video_cover_timestamp_ms?: number;
+                photo_cover_index?: number;
+                auto_add_music?: boolean;
+                brand_content_toggle?: boolean;
+                brand_organic_toggle?: boolean;
+                is_aigc?: boolean;
             };
+            id: string;
+            object: "post_variant";
+            connection_id: string | null;
+            body: string | null;
+            status: "draft" | "scheduled" | "publishing" | "published" | "failed";
             schedule_at: string | null;
             result: {
                 platform_post_id: string;
@@ -1038,16 +1211,34 @@ declare function usePostsInfinite(filters?: Omit<ListPostsQuery, 'limit' | 'offs
         [key: string]: string | number | boolean;
     };
     variants: Array<{
+        platform: "x";
+        post_type: "text" | "single_image" | "multi_image" | "video";
+        settings: {
+            reply_settings?: "everyone" | "following" | "mentionedUsers" | "subscribers" | "verified";
+            quote_tweet_id?: string;
+            poll?: {
+                options: Array<string>;
+                duration_minutes: number;
+                reply_settings?: "following" | "mentionedUsers" | "subscribers" | "verified";
+            };
+            reply?: {
+                in_reply_to_tweet_id: string;
+                exclude_reply_user_ids?: Array<string>;
+                auto_populate_reply_metadata?: boolean;
+            };
+            community_id?: string;
+            for_super_followers_only?: boolean;
+            geo?: {
+                place_id: string;
+            };
+            card_uri?: string;
+            media_tagged_user_ids?: Array<string>;
+        };
         id: string;
         object: "post_variant";
         connection_id: string | null;
-        platform: "x" | "linkedin" | "facebook_page" | "instagram" | "tiktok";
-        post_type: "text" | "single_image" | "multi_image" | "video" | "reel" | "carousel";
         body: string | null;
         status: "draft" | "scheduled" | "publishing" | "published" | "failed";
-        settings: {
-            [key: string]: unknown;
-        };
         schedule_at: string | null;
         result: {
             platform_post_id: string;
@@ -1067,105 +1258,38 @@ declare function usePostsInfinite(filters?: Omit<ListPostsQuery, 'limit' | 'offs
             } | null;
             alt_text_override: string | null;
         }>;
-    }>;
-    created_at: string;
-    updated_at: string;
-}>;
-/**
- * Calendar/queue view — list posts in a `schedule_at` date window, optionally
- * narrowed to a profile and to one or more derived statuses (e.g. only
- * `scheduled` + `failed`). Forwards the date-range + multi-status filters (and
- * any `limit`/`offset`) to the generated `postsList` and returns the same typed
- * `PostList` envelope. It shares the `postKeys.list(filters)` cache identity with
- * `usePosts` but owns its own self-terminating poll: while ANY post in the
- * window is in-flight it refetches (5s — a list is heavier than one detail), and
- * stops once every item is terminal (or the window is empty). `live` is a
- * separate option, never mixed into the API filter object; default-on, opt out
- * with `{ live: false }`.
- */
-declare function useCalendar(filters?: CalendarFilters & Pick<ListPostsQuery, 'limit' | 'offset'>, options?: LiveOptions): _tanstack_react_query.UseQueryResult<NoInfer<{
-    object: "list";
-    data: Array<{
-        id: string;
-        object: "post";
-        profile_id: string;
-        external_id: string | null;
-        status: "draft" | "scheduled" | "publishing" | "partially_published" | "published" | "failed";
-        schedule_at: string | null;
-        tags: Array<string>;
-        notes: string | null;
-        metadata: {
-            [key: string]: string | number | boolean;
-        };
-        variants: Array<{
-            id: string;
-            object: "post_variant";
-            connection_id: string | null;
-            platform: "x" | "linkedin" | "facebook_page" | "instagram" | "tiktok";
-            post_type: "text" | "single_image" | "multi_image" | "video" | "reel" | "carousel";
-            body: string | null;
-            status: "draft" | "scheduled" | "publishing" | "published" | "failed";
-            settings: {
-                [key: string]: unknown;
+    } | {
+        platform: "linkedin";
+        post_type: "text" | "single_image" | "multi_image" | "video";
+        settings: {
+            visibility: "PUBLIC" | "CONNECTIONS";
+            content_kind: "text" | "single_image" | "video" | "multi_image" | "document" | "article" | "poll";
+            article?: {
+                source: string;
+                title?: string;
+                description?: string;
+                thumbnail_media_id?: string;
             };
-            schedule_at: string | null;
-            result: {
-                platform_post_id: string;
-                permalink: string | null;
-                published_at: string;
-            } | null;
-            error: {
-                code: string;
-                message: string;
-                display_error: string;
-            } | null;
-            media: Array<{
-                media_id: string;
-                position: number;
-                crop_box: {
-                    [key: string]: unknown;
-                } | null;
-                alt_text_override: string | null;
+            poll?: {
+                question: string;
+                options: Array<string>;
+                duration: "ONE_DAY" | "THREE_DAYS" | "SEVEN_DAYS" | "FOURTEEN_DAYS";
+            };
+            document?: {
+                title: string;
+            };
+            disable_reshare?: boolean;
+            mentions?: Array<{
+                type: "person" | "organization";
+                name: string;
+                urn: string;
             }>;
-        }>;
-        created_at: string;
-        updated_at: string;
-    }>;
-    total: number;
-    limit: number;
-    offset: number;
-    has_more: boolean;
-}>, Error>;
-/**
- * Retrieve a single post by id (its variants, schedule, and derived status).
- * Auto-polls (2s) while the post is in-flight (`scheduled` / `publishing`) and
- * stops once it reaches a terminal status — so a scheduled post visibly
- * transitions with no manual refetch. `live` is on by default; pass
- * `{ live: false }` to force a one-shot.
- */
-declare function usePost(id: string, options?: LiveOptions): _tanstack_react_query.UseQueryResult<NoInfer<{
-    id: string;
-    object: "post";
-    profile_id: string;
-    external_id: string | null;
-    status: "draft" | "scheduled" | "publishing" | "partially_published" | "published" | "failed";
-    schedule_at: string | null;
-    tags: Array<string>;
-    notes: string | null;
-    metadata: {
-        [key: string]: string | number | boolean;
-    };
-    variants: Array<{
+        };
         id: string;
         object: "post_variant";
         connection_id: string | null;
-        platform: "x" | "linkedin" | "facebook_page" | "instagram" | "tiktok";
-        post_type: "text" | "single_image" | "multi_image" | "video" | "reel" | "carousel";
         body: string | null;
         status: "draft" | "scheduled" | "publishing" | "published" | "failed";
-        settings: {
-            [key: string]: unknown;
-        };
         schedule_at: string | null;
         result: {
             platform_post_id: string;
@@ -1185,37 +1309,135 @@ declare function usePost(id: string, options?: LiveOptions): _tanstack_react_que
             } | null;
             alt_text_override: string | null;
         }>;
-    }>;
-    created_at: string;
-    updated_at: string;
-}>, Error>;
-/**
- * Compose and create a post. Resolves the profile's connections, builds the full
- * variant set from `{ content, channels }` (per the `buildCreatePost` rules), and
- * sends it — the customer never assembles variants or passes a `connection_id`.
- * `connectedChannels` is the set of posting platforms this profile can reach.
- *
- * ## Reading the publish outcome (do NOT stop at "it returned")
- * On `publish: 'now'` the API returns the created post with a rollup `status` and
- * a per-variant `status` + typed `error`. A 201 does NOT mean every platform
- * published — one can silently fail while another succeeds. Surface the outcome
- * via the derived fields, never assume success from a resolved `create`:
- *
- * - **`status`** — the rollup (`published | partially_published | failed |
- *   draft | scheduled`), `undefined` until the first `create` resolves.
- * - **`isPublished`** — `true` ONLY when `status === 'published'`. This is the
- *   one "fully published" state; `partially_published` and `failed` are NOT
- *   success. Branch on this, not on the promise resolving.
- * - **`failedVariants`** — the variants that failed, each with its typed
- *   `error` (`{ code, message }`); `[]` when none. Render "X failed: <message>".
- *
- * `create` still resolves with the FULL `Post` (read everything if you need to),
- * and it NEVER throws on a failed/partial publish — a throw would discard the
- * platforms that DID publish. A transport error (network / 4xx) still surfaces
- * via `error` (and rejects `create`), exactly as before.
+    } | {
+        platform: "facebook_page";
+        post_type: "text" | "single_image" | "multi_image" | "reel";
+        settings: {
+            link?: string;
+        };
+        id: string;
+        object: "post_variant";
+        connection_id: string | null;
+        body: string | null;
+        status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+        schedule_at: string | null;
+        result: {
+            platform_post_id: string;
+            permalink: string | null;
+            published_at: string;
+        } | null;
+        error: {
+            code: string;
+            message: string;
+            display_error: string;
+        } | null;
+        media: Array<{
+            media_id: string;
+            position: number;
+            crop_box: {
+                [key: string]: unknown;
+            } | null;
+            alt_text_override: string | null;
+        }>;
+    } | {
+        platform: "instagram";
+        post_type: "single_image" | "carousel" | "reel";
+        settings: {
+            media_type?: "IMAGE" | "CAROUSEL" | "REELS";
+            location_id?: string;
+            user_tags?: Array<{
+                username: string;
+                x: number;
+                y: number;
+            }>;
+            collaborators?: Array<string>;
+            share_to_feed?: boolean;
+            thumb_offset?: number;
+            cover_url?: string;
+            audio_name?: string;
+        };
+        id: string;
+        object: "post_variant";
+        connection_id: string | null;
+        body: string | null;
+        status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+        schedule_at: string | null;
+        result: {
+            platform_post_id: string;
+            permalink: string | null;
+            published_at: string;
+        } | null;
+        error: {
+            code: string;
+            message: string;
+            display_error: string;
+        } | null;
+        media: Array<{
+            media_id: string;
+            position: number;
+            crop_box: {
+                [key: string]: unknown;
+            } | null;
+            alt_text_override: string | null;
+        }>;
+    } | {
+        platform: "tiktok";
+        post_type: "video" | "single_image" | "carousel";
+        settings: {
+            privacy_level?: "PUBLIC_TO_EVERYONE" | "MUTUAL_FOLLOW_FRIENDS" | "FOLLOWER_OF_CREATOR" | "SELF_ONLY";
+            disable_comment?: boolean;
+            disable_duet?: boolean;
+            disable_stitch?: boolean;
+            video_cover_timestamp_ms?: number;
+            photo_cover_index?: number;
+            auto_add_music?: boolean;
+            brand_content_toggle?: boolean;
+            brand_organic_toggle?: boolean;
+            is_aigc?: boolean;
+        };
+        id: string;
+        object: "post_variant";
+        connection_id: string | null;
+        body: string | null;
+        status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+        schedule_at: string | null;
+        result: {
+            platform_post_id: string;
+            permalink: string | null;
+            published_at: string;
+        } | null;
+        error: {
+            code: string;
+            message: string;
+            display_error: string;
+        } | null;
+        media: Array<{
+            media_id: string;
+            position: number;
+            crop_box: {
+                [key: string]: unknown;
+            } | null;
+            alt_text_override: string | null;
+        }>;
+    }>;
+    created_at: string;
+    updated_at: string;
+}>;
+/**
+ * Calendar/queue view — list posts in a `schedule_at` date window, optionally
+ * narrowed to a profile and to one or more derived statuses (e.g. only
+ * `scheduled` + `failed`). Forwards the date-range + multi-status filters (and
+ * any `limit`/`offset`) to the generated `postsList` and returns the same typed
+ * `PostList` envelope. It shares the `postKeys.list(filters)` cache identity with
+ * `usePosts` but owns its own self-terminating poll: while ANY post in the
+ * window is in-flight it refetches (5s — a list is heavier than one detail), and
+ * stops once every item is terminal (or the window is empty). `live` is a
+ * separate option, never mixed into the API filter object; default-on, opt out
+ * with `{ live: false }`.
  */
-declare function useCreatePost(profileId: string): {
-    create: _tanstack_react_query.UseMutateAsyncFunction<{
+declare function useCalendar(filters?: CalendarFilters & Pick<ListPostsQuery, 'limit' | 'offset'>, options?: LiveOptions): _tanstack_react_query.UseQueryResult<NoInfer<{
+    object: "list";
+    data: Array<{
         id: string;
         object: "post";
         profile_id: string;
@@ -1228,16 +1450,85 @@ declare function useCreatePost(profileId: string): {
             [key: string]: string | number | boolean;
         };
         variants: Array<{
+            platform: "x";
+            post_type: "text" | "single_image" | "multi_image" | "video";
+            settings: {
+                reply_settings?: "everyone" | "following" | "mentionedUsers" | "subscribers" | "verified";
+                quote_tweet_id?: string;
+                poll?: {
+                    options: Array<string>;
+                    duration_minutes: number;
+                    reply_settings?: "following" | "mentionedUsers" | "subscribers" | "verified";
+                };
+                reply?: {
+                    in_reply_to_tweet_id: string;
+                    exclude_reply_user_ids?: Array<string>;
+                    auto_populate_reply_metadata?: boolean;
+                };
+                community_id?: string;
+                for_super_followers_only?: boolean;
+                geo?: {
+                    place_id: string;
+                };
+                card_uri?: string;
+                media_tagged_user_ids?: Array<string>;
+            };
             id: string;
             object: "post_variant";
             connection_id: string | null;
-            platform: "x" | "linkedin" | "facebook_page" | "instagram" | "tiktok";
-            post_type: "text" | "single_image" | "multi_image" | "video" | "reel" | "carousel";
             body: string | null;
             status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                position: number;
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                alt_text_override: string | null;
+            }>;
+        } | {
+            platform: "linkedin";
+            post_type: "text" | "single_image" | "multi_image" | "video";
             settings: {
-                [key: string]: unknown;
+                visibility: "PUBLIC" | "CONNECTIONS";
+                content_kind: "text" | "single_image" | "video" | "multi_image" | "document" | "article" | "poll";
+                article?: {
+                    source: string;
+                    title?: string;
+                    description?: string;
+                    thumbnail_media_id?: string;
+                };
+                poll?: {
+                    question: string;
+                    options: Array<string>;
+                    duration: "ONE_DAY" | "THREE_DAYS" | "SEVEN_DAYS" | "FOURTEEN_DAYS";
+                };
+                document?: {
+                    title: string;
+                };
+                disable_reshare?: boolean;
+                mentions?: Array<{
+                    type: "person" | "organization";
+                    name: string;
+                    urn: string;
+                }>;
             };
+            id: string;
+            object: "post_variant";
+            connection_id: string | null;
+            body: string | null;
+            status: "draft" | "scheduled" | "publishing" | "published" | "failed";
             schedule_at: string | null;
             result: {
                 platform_post_id: string;
@@ -1257,37 +1548,97 @@ declare function useCreatePost(profileId: string): {
                 } | null;
                 alt_text_override: string | null;
             }>;
-        }>;
-        created_at: string;
-        updated_at: string;
-        dry_run: boolean;
-        executed: boolean;
-    }, Error, Omit<ComposePostInput, "profileId">, unknown>;
-    isPending: boolean;
-    error: Error | null;
-    data: {
-        id: string;
-        object: "post";
-        profile_id: string;
-        external_id: string | null;
-        status: "draft" | "scheduled" | "publishing" | "partially_published" | "published" | "failed";
-        schedule_at: string | null;
-        tags: Array<string>;
-        notes: string | null;
-        metadata: {
-            [key: string]: string | number | boolean;
-        };
-        variants: Array<{
+        } | {
+            platform: "facebook_page";
+            post_type: "text" | "single_image" | "multi_image" | "reel";
+            settings: {
+                link?: string;
+            };
             id: string;
             object: "post_variant";
             connection_id: string | null;
-            platform: "x" | "linkedin" | "facebook_page" | "instagram" | "tiktok";
-            post_type: "text" | "single_image" | "multi_image" | "video" | "reel" | "carousel";
             body: string | null;
             status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                position: number;
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                alt_text_override: string | null;
+            }>;
+        } | {
+            platform: "instagram";
+            post_type: "single_image" | "carousel" | "reel";
             settings: {
-                [key: string]: unknown;
+                media_type?: "IMAGE" | "CAROUSEL" | "REELS";
+                location_id?: string;
+                user_tags?: Array<{
+                    username: string;
+                    x: number;
+                    y: number;
+                }>;
+                collaborators?: Array<string>;
+                share_to_feed?: boolean;
+                thumb_offset?: number;
+                cover_url?: string;
+                audio_name?: string;
+            };
+            id: string;
+            object: "post_variant";
+            connection_id: string | null;
+            body: string | null;
+            status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                position: number;
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                alt_text_override: string | null;
+            }>;
+        } | {
+            platform: "tiktok";
+            post_type: "video" | "single_image" | "carousel";
+            settings: {
+                privacy_level?: "PUBLIC_TO_EVERYONE" | "MUTUAL_FOLLOW_FRIENDS" | "FOLLOWER_OF_CREATOR" | "SELF_ONLY";
+                disable_comment?: boolean;
+                disable_duet?: boolean;
+                disable_stitch?: boolean;
+                video_cover_timestamp_ms?: number;
+                photo_cover_index?: number;
+                auto_add_music?: boolean;
+                brand_content_toggle?: boolean;
+                brand_organic_toggle?: boolean;
+                is_aigc?: boolean;
             };
+            id: string;
+            object: "post_variant";
+            connection_id: string | null;
+            body: string | null;
+            status: "draft" | "scheduled" | "publishing" | "published" | "failed";
             schedule_at: string | null;
             result: {
                 platform_post_id: string;
@@ -1308,25 +1659,921 @@ declare function useCreatePost(profileId: string): {
                 alt_text_override: string | null;
             }>;
         }>;
-        created_at: string;
-        updated_at: string;
-        dry_run: boolean;
-        executed: boolean;
-    } | undefined;
-    reset: () => void;
-    status: "draft" | "scheduled" | "publishing" | "partially_published" | "published" | "failed" | undefined;
-    isPublished: boolean;
-    failedVariants: {
+        created_at: string;
+        updated_at: string;
+    }>;
+    total: number;
+    limit: number;
+    offset: number;
+    has_more: boolean;
+}>, Error>;
+/**
+ * Retrieve a single post by id (its variants, schedule, and derived status).
+ * Auto-polls (2s) while the post is in-flight (`scheduled` / `publishing`) and
+ * stops once it reaches a terminal status — so a scheduled post visibly
+ * transitions with no manual refetch. `live` is on by default; pass
+ * `{ live: false }` to force a one-shot.
+ */
+declare function usePost(id: string, options?: LiveOptions): _tanstack_react_query.UseQueryResult<NoInfer<{
+    id: string;
+    object: "post";
+    profile_id: string;
+    external_id: string | null;
+    status: "draft" | "scheduled" | "publishing" | "partially_published" | "published" | "failed";
+    schedule_at: string | null;
+    tags: Array<string>;
+    notes: string | null;
+    metadata: {
+        [key: string]: string | number | boolean;
+    };
+    variants: Array<{
+        platform: "x";
+        post_type: "text" | "single_image" | "multi_image" | "video";
+        settings: {
+            reply_settings?: "everyone" | "following" | "mentionedUsers" | "subscribers" | "verified";
+            quote_tweet_id?: string;
+            poll?: {
+                options: Array<string>;
+                duration_minutes: number;
+                reply_settings?: "following" | "mentionedUsers" | "subscribers" | "verified";
+            };
+            reply?: {
+                in_reply_to_tweet_id: string;
+                exclude_reply_user_ids?: Array<string>;
+                auto_populate_reply_metadata?: boolean;
+            };
+            community_id?: string;
+            for_super_followers_only?: boolean;
+            geo?: {
+                place_id: string;
+            };
+            card_uri?: string;
+            media_tagged_user_ids?: Array<string>;
+        };
+        id: string;
+        object: "post_variant";
+        connection_id: string | null;
+        body: string | null;
+        status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+        schedule_at: string | null;
+        result: {
+            platform_post_id: string;
+            permalink: string | null;
+            published_at: string;
+        } | null;
+        error: {
+            code: string;
+            message: string;
+            display_error: string;
+        } | null;
+        media: Array<{
+            media_id: string;
+            position: number;
+            crop_box: {
+                [key: string]: unknown;
+            } | null;
+            alt_text_override: string | null;
+        }>;
+    } | {
+        platform: "linkedin";
+        post_type: "text" | "single_image" | "multi_image" | "video";
+        settings: {
+            visibility: "PUBLIC" | "CONNECTIONS";
+            content_kind: "text" | "single_image" | "video" | "multi_image" | "document" | "article" | "poll";
+            article?: {
+                source: string;
+                title?: string;
+                description?: string;
+                thumbnail_media_id?: string;
+            };
+            poll?: {
+                question: string;
+                options: Array<string>;
+                duration: "ONE_DAY" | "THREE_DAYS" | "SEVEN_DAYS" | "FOURTEEN_DAYS";
+            };
+            document?: {
+                title: string;
+            };
+            disable_reshare?: boolean;
+            mentions?: Array<{
+                type: "person" | "organization";
+                name: string;
+                urn: string;
+            }>;
+        };
+        id: string;
+        object: "post_variant";
+        connection_id: string | null;
+        body: string | null;
+        status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+        schedule_at: string | null;
+        result: {
+            platform_post_id: string;
+            permalink: string | null;
+            published_at: string;
+        } | null;
+        error: {
+            code: string;
+            message: string;
+            display_error: string;
+        } | null;
+        media: Array<{
+            media_id: string;
+            position: number;
+            crop_box: {
+                [key: string]: unknown;
+            } | null;
+            alt_text_override: string | null;
+        }>;
+    } | {
+        platform: "facebook_page";
+        post_type: "text" | "single_image" | "multi_image" | "reel";
+        settings: {
+            link?: string;
+        };
+        id: string;
+        object: "post_variant";
+        connection_id: string | null;
+        body: string | null;
+        status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+        schedule_at: string | null;
+        result: {
+            platform_post_id: string;
+            permalink: string | null;
+            published_at: string;
+        } | null;
+        error: {
+            code: string;
+            message: string;
+            display_error: string;
+        } | null;
+        media: Array<{
+            media_id: string;
+            position: number;
+            crop_box: {
+                [key: string]: unknown;
+            } | null;
+            alt_text_override: string | null;
+        }>;
+    } | {
+        platform: "instagram";
+        post_type: "single_image" | "carousel" | "reel";
+        settings: {
+            media_type?: "IMAGE" | "CAROUSEL" | "REELS";
+            location_id?: string;
+            user_tags?: Array<{
+                username: string;
+                x: number;
+                y: number;
+            }>;
+            collaborators?: Array<string>;
+            share_to_feed?: boolean;
+            thumb_offset?: number;
+            cover_url?: string;
+            audio_name?: string;
+        };
+        id: string;
+        object: "post_variant";
+        connection_id: string | null;
+        body: string | null;
+        status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+        schedule_at: string | null;
+        result: {
+            platform_post_id: string;
+            permalink: string | null;
+            published_at: string;
+        } | null;
+        error: {
+            code: string;
+            message: string;
+            display_error: string;
+        } | null;
+        media: Array<{
+            media_id: string;
+            position: number;
+            crop_box: {
+                [key: string]: unknown;
+            } | null;
+            alt_text_override: string | null;
+        }>;
+    } | {
+        platform: "tiktok";
+        post_type: "video" | "single_image" | "carousel";
+        settings: {
+            privacy_level?: "PUBLIC_TO_EVERYONE" | "MUTUAL_FOLLOW_FRIENDS" | "FOLLOWER_OF_CREATOR" | "SELF_ONLY";
+            disable_comment?: boolean;
+            disable_duet?: boolean;
+            disable_stitch?: boolean;
+            video_cover_timestamp_ms?: number;
+            photo_cover_index?: number;
+            auto_add_music?: boolean;
+            brand_content_toggle?: boolean;
+            brand_organic_toggle?: boolean;
+            is_aigc?: boolean;
+        };
+        id: string;
+        object: "post_variant";
+        connection_id: string | null;
+        body: string | null;
+        status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+        schedule_at: string | null;
+        result: {
+            platform_post_id: string;
+            permalink: string | null;
+            published_at: string;
+        } | null;
+        error: {
+            code: string;
+            message: string;
+            display_error: string;
+        } | null;
+        media: Array<{
+            media_id: string;
+            position: number;
+            crop_box: {
+                [key: string]: unknown;
+            } | null;
+            alt_text_override: string | null;
+        }>;
+    }>;
+    created_at: string;
+    updated_at: string;
+}>, Error>;
+/**
+ * Compose and create a post. Resolves the profile's connections, builds the full
+ * variant set from `{ content, channels }` (per the `buildCreatePost` rules), and
+ * sends it — the customer never assembles variants or passes a `connection_id`.
+ * `connectedChannels` is the set of posting platforms this profile can reach.
+ *
+ * ## Reading the publish outcome (do NOT stop at "it returned")
+ * On `publish: 'now'` the API returns the created post with a rollup `status` and
+ * a per-variant `status` + typed `error`. A 201 does NOT mean every platform
+ * published — one can silently fail while another succeeds. Surface the outcome
+ * via the derived fields, never assume success from a resolved `create`:
+ *
+ * - **`status`** — the rollup (`published | partially_published | failed |
+ *   draft | scheduled`), `undefined` until the first `create` resolves.
+ * - **`isPublished`** — `true` ONLY when `status === 'published'`. This is the
+ *   one "fully published" state; `partially_published` and `failed` are NOT
+ *   success. Branch on this, not on the promise resolving.
+ * - **`failedVariants`** — the variants that failed, each with its typed
+ *   `error` (`{ code, message }`); `[]` when none. Render "X failed: <message>".
+ *
+ * `create` still resolves with the FULL `Post` (read everything if you need to),
+ * and it NEVER throws on a failed/partial publish — a throw would discard the
+ * platforms that DID publish. A transport error (network / 4xx) still surfaces
+ * via `error` (and rejects `create`), exactly as before.
+ */
+declare function useCreatePost(profileId: string): {
+    create: _tanstack_react_query.UseMutateAsyncFunction<{
+        id: string;
+        object: "post";
+        profile_id: string;
+        external_id: string | null;
+        status: "draft" | "scheduled" | "publishing" | "partially_published" | "published" | "failed";
+        schedule_at: string | null;
+        tags: Array<string>;
+        notes: string | null;
+        metadata: {
+            [key: string]: string | number | boolean;
+        };
+        variants: Array<{
+            platform: "x";
+            post_type: "text" | "single_image" | "multi_image" | "video";
+            settings: {
+                reply_settings?: "everyone" | "following" | "mentionedUsers" | "subscribers" | "verified";
+                quote_tweet_id?: string;
+                poll?: {
+                    options: Array<string>;
+                    duration_minutes: number;
+                    reply_settings?: "following" | "mentionedUsers" | "subscribers" | "verified";
+                };
+                reply?: {
+                    in_reply_to_tweet_id: string;
+                    exclude_reply_user_ids?: Array<string>;
+                    auto_populate_reply_metadata?: boolean;
+                };
+                community_id?: string;
+                for_super_followers_only?: boolean;
+                geo?: {
+                    place_id: string;
+                };
+                card_uri?: string;
+                media_tagged_user_ids?: Array<string>;
+            };
+            id: string;
+            object: "post_variant";
+            connection_id: string | null;
+            body: string | null;
+            status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                position: number;
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                alt_text_override: string | null;
+            }>;
+        } | {
+            platform: "linkedin";
+            post_type: "text" | "single_image" | "multi_image" | "video";
+            settings: {
+                visibility: "PUBLIC" | "CONNECTIONS";
+                content_kind: "text" | "single_image" | "video" | "multi_image" | "document" | "article" | "poll";
+                article?: {
+                    source: string;
+                    title?: string;
+                    description?: string;
+                    thumbnail_media_id?: string;
+                };
+                poll?: {
+                    question: string;
+                    options: Array<string>;
+                    duration: "ONE_DAY" | "THREE_DAYS" | "SEVEN_DAYS" | "FOURTEEN_DAYS";
+                };
+                document?: {
+                    title: string;
+                };
+                disable_reshare?: boolean;
+                mentions?: Array<{
+                    type: "person" | "organization";
+                    name: string;
+                    urn: string;
+                }>;
+            };
+            id: string;
+            object: "post_variant";
+            connection_id: string | null;
+            body: string | null;
+            status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                position: number;
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                alt_text_override: string | null;
+            }>;
+        } | {
+            platform: "facebook_page";
+            post_type: "text" | "single_image" | "multi_image" | "reel";
+            settings: {
+                link?: string;
+            };
+            id: string;
+            object: "post_variant";
+            connection_id: string | null;
+            body: string | null;
+            status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                position: number;
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                alt_text_override: string | null;
+            }>;
+        } | {
+            platform: "instagram";
+            post_type: "single_image" | "carousel" | "reel";
+            settings: {
+                media_type?: "IMAGE" | "CAROUSEL" | "REELS";
+                location_id?: string;
+                user_tags?: Array<{
+                    username: string;
+                    x: number;
+                    y: number;
+                }>;
+                collaborators?: Array<string>;
+                share_to_feed?: boolean;
+                thumb_offset?: number;
+                cover_url?: string;
+                audio_name?: string;
+            };
+            id: string;
+            object: "post_variant";
+            connection_id: string | null;
+            body: string | null;
+            status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                position: number;
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                alt_text_override: string | null;
+            }>;
+        } | {
+            platform: "tiktok";
+            post_type: "video" | "single_image" | "carousel";
+            settings: {
+                privacy_level?: "PUBLIC_TO_EVERYONE" | "MUTUAL_FOLLOW_FRIENDS" | "FOLLOWER_OF_CREATOR" | "SELF_ONLY";
+                disable_comment?: boolean;
+                disable_duet?: boolean;
+                disable_stitch?: boolean;
+                video_cover_timestamp_ms?: number;
+                photo_cover_index?: number;
+                auto_add_music?: boolean;
+                brand_content_toggle?: boolean;
+                brand_organic_toggle?: boolean;
+                is_aigc?: boolean;
+            };
+            id: string;
+            object: "post_variant";
+            connection_id: string | null;
+            body: string | null;
+            status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                position: number;
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                alt_text_override: string | null;
+            }>;
+        }>;
+        created_at: string;
+        updated_at: string;
+        dry_run: boolean;
+        executed: boolean;
+    }, Error, Omit<ComposePostInput, "profileId">, unknown>;
+    isPending: boolean;
+    error: Error | null;
+    data: {
+        id: string;
+        object: "post";
+        profile_id: string;
+        external_id: string | null;
+        status: "draft" | "scheduled" | "publishing" | "partially_published" | "published" | "failed";
+        schedule_at: string | null;
+        tags: Array<string>;
+        notes: string | null;
+        metadata: {
+            [key: string]: string | number | boolean;
+        };
+        variants: Array<{
+            platform: "x";
+            post_type: "text" | "single_image" | "multi_image" | "video";
+            settings: {
+                reply_settings?: "everyone" | "following" | "mentionedUsers" | "subscribers" | "verified";
+                quote_tweet_id?: string;
+                poll?: {
+                    options: Array<string>;
+                    duration_minutes: number;
+                    reply_settings?: "following" | "mentionedUsers" | "subscribers" | "verified";
+                };
+                reply?: {
+                    in_reply_to_tweet_id: string;
+                    exclude_reply_user_ids?: Array<string>;
+                    auto_populate_reply_metadata?: boolean;
+                };
+                community_id?: string;
+                for_super_followers_only?: boolean;
+                geo?: {
+                    place_id: string;
+                };
+                card_uri?: string;
+                media_tagged_user_ids?: Array<string>;
+            };
+            id: string;
+            object: "post_variant";
+            connection_id: string | null;
+            body: string | null;
+            status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                position: number;
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                alt_text_override: string | null;
+            }>;
+        } | {
+            platform: "linkedin";
+            post_type: "text" | "single_image" | "multi_image" | "video";
+            settings: {
+                visibility: "PUBLIC" | "CONNECTIONS";
+                content_kind: "text" | "single_image" | "video" | "multi_image" | "document" | "article" | "poll";
+                article?: {
+                    source: string;
+                    title?: string;
+                    description?: string;
+                    thumbnail_media_id?: string;
+                };
+                poll?: {
+                    question: string;
+                    options: Array<string>;
+                    duration: "ONE_DAY" | "THREE_DAYS" | "SEVEN_DAYS" | "FOURTEEN_DAYS";
+                };
+                document?: {
+                    title: string;
+                };
+                disable_reshare?: boolean;
+                mentions?: Array<{
+                    type: "person" | "organization";
+                    name: string;
+                    urn: string;
+                }>;
+            };
+            id: string;
+            object: "post_variant";
+            connection_id: string | null;
+            body: string | null;
+            status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                position: number;
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                alt_text_override: string | null;
+            }>;
+        } | {
+            platform: "facebook_page";
+            post_type: "text" | "single_image" | "multi_image" | "reel";
+            settings: {
+                link?: string;
+            };
+            id: string;
+            object: "post_variant";
+            connection_id: string | null;
+            body: string | null;
+            status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                position: number;
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                alt_text_override: string | null;
+            }>;
+        } | {
+            platform: "instagram";
+            post_type: "single_image" | "carousel" | "reel";
+            settings: {
+                media_type?: "IMAGE" | "CAROUSEL" | "REELS";
+                location_id?: string;
+                user_tags?: Array<{
+                    username: string;
+                    x: number;
+                    y: number;
+                }>;
+                collaborators?: Array<string>;
+                share_to_feed?: boolean;
+                thumb_offset?: number;
+                cover_url?: string;
+                audio_name?: string;
+            };
+            id: string;
+            object: "post_variant";
+            connection_id: string | null;
+            body: string | null;
+            status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                position: number;
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                alt_text_override: string | null;
+            }>;
+        } | {
+            platform: "tiktok";
+            post_type: "video" | "single_image" | "carousel";
+            settings: {
+                privacy_level?: "PUBLIC_TO_EVERYONE" | "MUTUAL_FOLLOW_FRIENDS" | "FOLLOWER_OF_CREATOR" | "SELF_ONLY";
+                disable_comment?: boolean;
+                disable_duet?: boolean;
+                disable_stitch?: boolean;
+                video_cover_timestamp_ms?: number;
+                photo_cover_index?: number;
+                auto_add_music?: boolean;
+                brand_content_toggle?: boolean;
+                brand_organic_toggle?: boolean;
+                is_aigc?: boolean;
+            };
+            id: string;
+            object: "post_variant";
+            connection_id: string | null;
+            body: string | null;
+            status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                position: number;
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                alt_text_override: string | null;
+            }>;
+        }>;
+        created_at: string;
+        updated_at: string;
+        dry_run: boolean;
+        executed: boolean;
+    } | undefined;
+    reset: () => void;
+    status: "draft" | "scheduled" | "publishing" | "partially_published" | "published" | "failed" | undefined;
+    isPublished: boolean;
+    failedVariants: ({
+        platform: "x";
+        post_type: "text" | "single_image" | "multi_image" | "video";
+        settings: {
+            reply_settings?: "everyone" | "following" | "mentionedUsers" | "subscribers" | "verified";
+            quote_tweet_id?: string;
+            poll?: {
+                options: Array<string>;
+                duration_minutes: number;
+                reply_settings?: "following" | "mentionedUsers" | "subscribers" | "verified";
+            };
+            reply?: {
+                in_reply_to_tweet_id: string;
+                exclude_reply_user_ids?: Array<string>;
+                auto_populate_reply_metadata?: boolean;
+            };
+            community_id?: string;
+            for_super_followers_only?: boolean;
+            geo?: {
+                place_id: string;
+            };
+            card_uri?: string;
+            media_tagged_user_ids?: Array<string>;
+        };
+        id: string;
+        object: "post_variant";
+        connection_id: string | null;
+        body: string | null;
+        status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+        schedule_at: string | null;
+        result: {
+            platform_post_id: string;
+            permalink: string | null;
+            published_at: string;
+        } | null;
+        error: {
+            code: string;
+            message: string;
+            display_error: string;
+        } | null;
+        media: Array<{
+            media_id: string;
+            position: number;
+            crop_box: {
+                [key: string]: unknown;
+            } | null;
+            alt_text_override: string | null;
+        }>;
+    } | {
+        platform: "linkedin";
+        post_type: "text" | "single_image" | "multi_image" | "video";
+        settings: {
+            visibility: "PUBLIC" | "CONNECTIONS";
+            content_kind: "text" | "single_image" | "video" | "multi_image" | "document" | "article" | "poll";
+            article?: {
+                source: string;
+                title?: string;
+                description?: string;
+                thumbnail_media_id?: string;
+            };
+            poll?: {
+                question: string;
+                options: Array<string>;
+                duration: "ONE_DAY" | "THREE_DAYS" | "SEVEN_DAYS" | "FOURTEEN_DAYS";
+            };
+            document?: {
+                title: string;
+            };
+            disable_reshare?: boolean;
+            mentions?: Array<{
+                type: "person" | "organization";
+                name: string;
+                urn: string;
+            }>;
+        };
+        id: string;
+        object: "post_variant";
+        connection_id: string | null;
+        body: string | null;
+        status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+        schedule_at: string | null;
+        result: {
+            platform_post_id: string;
+            permalink: string | null;
+            published_at: string;
+        } | null;
+        error: {
+            code: string;
+            message: string;
+            display_error: string;
+        } | null;
+        media: Array<{
+            media_id: string;
+            position: number;
+            crop_box: {
+                [key: string]: unknown;
+            } | null;
+            alt_text_override: string | null;
+        }>;
+    } | {
+        platform: "facebook_page";
+        post_type: "text" | "single_image" | "multi_image" | "reel";
+        settings: {
+            link?: string;
+        };
+        id: string;
+        object: "post_variant";
+        connection_id: string | null;
+        body: string | null;
+        status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+        schedule_at: string | null;
+        result: {
+            platform_post_id: string;
+            permalink: string | null;
+            published_at: string;
+        } | null;
+        error: {
+            code: string;
+            message: string;
+            display_error: string;
+        } | null;
+        media: Array<{
+            media_id: string;
+            position: number;
+            crop_box: {
+                [key: string]: unknown;
+            } | null;
+            alt_text_override: string | null;
+        }>;
+    } | {
+        platform: "instagram";
+        post_type: "single_image" | "carousel" | "reel";
+        settings: {
+            media_type?: "IMAGE" | "CAROUSEL" | "REELS";
+            location_id?: string;
+            user_tags?: Array<{
+                username: string;
+                x: number;
+                y: number;
+            }>;
+            collaborators?: Array<string>;
+            share_to_feed?: boolean;
+            thumb_offset?: number;
+            cover_url?: string;
+            audio_name?: string;
+        };
+        id: string;
+        object: "post_variant";
+        connection_id: string | null;
+        body: string | null;
+        status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+        schedule_at: string | null;
+        result: {
+            platform_post_id: string;
+            permalink: string | null;
+            published_at: string;
+        } | null;
+        error: {
+            code: string;
+            message: string;
+            display_error: string;
+        } | null;
+        media: Array<{
+            media_id: string;
+            position: number;
+            crop_box: {
+                [key: string]: unknown;
+            } | null;
+            alt_text_override: string | null;
+        }>;
+    } | {
+        platform: "tiktok";
+        post_type: "video" | "single_image" | "carousel";
+        settings: {
+            privacy_level?: "PUBLIC_TO_EVERYONE" | "MUTUAL_FOLLOW_FRIENDS" | "FOLLOWER_OF_CREATOR" | "SELF_ONLY";
+            disable_comment?: boolean;
+            disable_duet?: boolean;
+            disable_stitch?: boolean;
+            video_cover_timestamp_ms?: number;
+            photo_cover_index?: number;
+            auto_add_music?: boolean;
+            brand_content_toggle?: boolean;
+            brand_organic_toggle?: boolean;
+            is_aigc?: boolean;
+        };
         id: string;
         object: "post_variant";
         connection_id: string | null;
-        platform: "x" | "linkedin" | "facebook_page" | "instagram" | "tiktok";
-        post_type: "text" | "single_image" | "multi_image" | "video" | "reel" | "carousel";
         body: string | null;
         status: "draft" | "scheduled" | "publishing" | "published" | "failed";
-        settings: {
-            [key: string]: unknown;
-        };
         schedule_at: string | null;
         result: {
             platform_post_id: string;
@@ -1346,7 +2593,7 @@ declare function useCreatePost(profileId: string): {
             } | null;
             alt_text_override: string | null;
         }>;
-    }[];
+    })[];
     isReady: boolean;
     connectedChannels: ("tiktok" | "x" | "linkedin" | "facebook_page" | "instagram")[];
 };
@@ -1400,16 +2647,195 @@ declare function useUpdatePost(postId: string): _tanstack_react_query.UseMutatio
         [key: string]: string | number | boolean;
     };
     variants: Array<{
+        platform: "x";
+        post_type: "text" | "single_image" | "multi_image" | "video";
+        settings: {
+            reply_settings?: "everyone" | "following" | "mentionedUsers" | "subscribers" | "verified";
+            quote_tweet_id?: string;
+            poll?: {
+                options: Array<string>;
+                duration_minutes: number;
+                reply_settings?: "following" | "mentionedUsers" | "subscribers" | "verified";
+            };
+            reply?: {
+                in_reply_to_tweet_id: string;
+                exclude_reply_user_ids?: Array<string>;
+                auto_populate_reply_metadata?: boolean;
+            };
+            community_id?: string;
+            for_super_followers_only?: boolean;
+            geo?: {
+                place_id: string;
+            };
+            card_uri?: string;
+            media_tagged_user_ids?: Array<string>;
+        };
+        id: string;
+        object: "post_variant";
+        connection_id: string | null;
+        body: string | null;
+        status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+        schedule_at: string | null;
+        result: {
+            platform_post_id: string;
+            permalink: string | null;
+            published_at: string;
+        } | null;
+        error: {
+            code: string;
+            message: string;
+            display_error: string;
+        } | null;
+        media: Array<{
+            media_id: string;
+            position: number;
+            crop_box: {
+                [key: string]: unknown;
+            } | null;
+            alt_text_override: string | null;
+        }>;
+    } | {
+        platform: "linkedin";
+        post_type: "text" | "single_image" | "multi_image" | "video";
+        settings: {
+            visibility: "PUBLIC" | "CONNECTIONS";
+            content_kind: "text" | "single_image" | "video" | "multi_image" | "document" | "article" | "poll";
+            article?: {
+                source: string;
+                title?: string;
+                description?: string;
+                thumbnail_media_id?: string;
+            };
+            poll?: {
+                question: string;
+                options: Array<string>;
+                duration: "ONE_DAY" | "THREE_DAYS" | "SEVEN_DAYS" | "FOURTEEN_DAYS";
+            };
+            document?: {
+                title: string;
+            };
+            disable_reshare?: boolean;
+            mentions?: Array<{
+                type: "person" | "organization";
+                name: string;
+                urn: string;
+            }>;
+        };
+        id: string;
+        object: "post_variant";
+        connection_id: string | null;
+        body: string | null;
+        status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+        schedule_at: string | null;
+        result: {
+            platform_post_id: string;
+            permalink: string | null;
+            published_at: string;
+        } | null;
+        error: {
+            code: string;
+            message: string;
+            display_error: string;
+        } | null;
+        media: Array<{
+            media_id: string;
+            position: number;
+            crop_box: {
+                [key: string]: unknown;
+            } | null;
+            alt_text_override: string | null;
+        }>;
+    } | {
+        platform: "facebook_page";
+        post_type: "text" | "single_image" | "multi_image" | "reel";
+        settings: {
+            link?: string;
+        };
+        id: string;
+        object: "post_variant";
+        connection_id: string | null;
+        body: string | null;
+        status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+        schedule_at: string | null;
+        result: {
+            platform_post_id: string;
+            permalink: string | null;
+            published_at: string;
+        } | null;
+        error: {
+            code: string;
+            message: string;
+            display_error: string;
+        } | null;
+        media: Array<{
+            media_id: string;
+            position: number;
+            crop_box: {
+                [key: string]: unknown;
+            } | null;
+            alt_text_override: string | null;
+        }>;
+    } | {
+        platform: "instagram";
+        post_type: "single_image" | "carousel" | "reel";
+        settings: {
+            media_type?: "IMAGE" | "CAROUSEL" | "REELS";
+            location_id?: string;
+            user_tags?: Array<{
+                username: string;
+                x: number;
+                y: number;
+            }>;
+            collaborators?: Array<string>;
+            share_to_feed?: boolean;
+            thumb_offset?: number;
+            cover_url?: string;
+            audio_name?: string;
+        };
         id: string;
         object: "post_variant";
         connection_id: string | null;
-        platform: "x" | "linkedin" | "facebook_page" | "instagram" | "tiktok";
-        post_type: "text" | "single_image" | "multi_image" | "video" | "reel" | "carousel";
         body: string | null;
         status: "draft" | "scheduled" | "publishing" | "published" | "failed";
+        schedule_at: string | null;
+        result: {
+            platform_post_id: string;
+            permalink: string | null;
+            published_at: string;
+        } | null;
+        error: {
+            code: string;
+            message: string;
+            display_error: string;
+        } | null;
+        media: Array<{
+            media_id: string;
+            position: number;
+            crop_box: {
+                [key: string]: unknown;
+            } | null;
+            alt_text_override: string | null;
+        }>;
+    } | {
+        platform: "tiktok";
+        post_type: "video" | "single_image" | "carousel";
         settings: {
-            [key: string]: unknown;
+            privacy_level?: "PUBLIC_TO_EVERYONE" | "MUTUAL_FOLLOW_FRIENDS" | "FOLLOWER_OF_CREATOR" | "SELF_ONLY";
+            disable_comment?: boolean;
+            disable_duet?: boolean;
+            disable_stitch?: boolean;
+            video_cover_timestamp_ms?: number;
+            photo_cover_index?: number;
+            auto_add_music?: boolean;
+            brand_content_toggle?: boolean;
+            brand_organic_toggle?: boolean;
+            is_aigc?: boolean;
         };
+        id: string;
+        object: "post_variant";
+        connection_id: string | null;
+        body: string | null;
+        status: "draft" | "scheduled" | "publishing" | "published" | "failed";
         schedule_at: string | null;
         result: {
             platform_post_id: string;
@@ -1447,15 +2873,6 @@ declare function useUpdatePost(postId: string): _tanstack_react_query.UseMutatio
     variants?: Array<{
         platform: "x";
         post_type: "text" | "single_image" | "multi_image" | "video";
-        connection_id: string;
-        body?: string;
-        media?: Array<{
-            media_id: string;
-            crop_box?: {
-                [key: string]: unknown;
-            } | null;
-            alt_text_override?: string | null;
-        }>;
         settings?: {
             reply_settings?: "everyone" | "following" | "mentionedUsers" | "subscribers" | "verified";
             quote_tweet_id?: string;
@@ -1477,9 +2894,6 @@ declare function useUpdatePost(postId: string): _tanstack_react_query.UseMutatio
             card_uri?: string;
             media_tagged_user_ids?: Array<string>;
         };
-    } | {
-        platform: "linkedin";
-        post_type: "text" | "single_image" | "multi_image" | "video";
         connection_id: string;
         body?: string;
         media?: Array<{
@@ -1489,6 +2903,9 @@ declare function useUpdatePost(postId: string): _tanstack_react_query.UseMutatio
             } | null;
             alt_text_override?: string | null;
         }>;
+    } | {
+        platform: "linkedin";
+        post_type: "text" | "single_image" | "multi_image" | "video";
         settings: {
             visibility: "PUBLIC" | "CONNECTIONS";
             content_kind: "text" | "single_image" | "video" | "multi_image" | "document" | "article" | "poll";
@@ -1513,9 +2930,6 @@ declare function useUpdatePost(postId: string): _tanstack_react_query.UseMutatio
                 urn: string;
             }>;
         };
-    } | {
-        platform: "instagram";
-        post_type: "single_image" | "carousel" | "reel";
         connection_id: string;
         body?: string;
         media?: Array<{
@@ -1525,6 +2939,9 @@ declare function useUpdatePost(postId: string): _tanstack_react_query.UseMutatio
             } | null;
             alt_text_override?: string | null;
         }>;
+    } | {
+        platform: "instagram";
+        post_type: "single_image" | "carousel" | "reel";
         settings: {
             media_type?: "IMAGE" | "CAROUSEL" | "REELS";
             location_id?: string;
@@ -1539,9 +2956,6 @@ declare function useUpdatePost(postId: string): _tanstack_react_query.UseMutatio
             cover_url?: string;
             audio_name?: string;
         };
-    } | {
-        platform: "facebook_page";
-        post_type: "text" | "single_image" | "multi_image" | "reel";
         connection_id: string;
         body?: string;
         media?: Array<{
@@ -1551,12 +2965,12 @@ declare function useUpdatePost(postId: string): _tanstack_react_query.UseMutatio
             } | null;
             alt_text_override?: string | null;
         }>;
+    } | {
+        platform: "facebook_page";
+        post_type: "text" | "single_image" | "multi_image" | "reel";
         settings?: {
             link?: string;
         };
-    } | {
-        platform: "tiktok";
-        post_type: "video" | "single_image" | "carousel";
         connection_id: string;
         body?: string;
         media?: Array<{
@@ -1566,6 +2980,9 @@ declare function useUpdatePost(postId: string): _tanstack_react_query.UseMutatio
             } | null;
             alt_text_override?: string | null;
         }>;
+    } | {
+        platform: "tiktok";
+        post_type: "video" | "single_image" | "carousel";
         settings?: {
             privacy_level?: "PUBLIC_TO_EVERYONE" | "MUTUAL_FOLLOW_FRIENDS" | "FOLLOWER_OF_CREATOR" | "SELF_ONLY";
             disable_comment?: boolean;
@@ -1578,6 +2995,15 @@ declare function useUpdatePost(postId: string): _tanstack_react_query.UseMutatio
             brand_organic_toggle?: boolean;
             is_aigc?: boolean;
         };
+        connection_id: string;
+        body?: string;
+        media?: Array<{
+            media_id: string;
+            crop_box?: {
+                [key: string]: unknown;
+            } | null;
+            alt_text_override?: string | null;
+        }>;
     }>;
 }, unknown>;
 /** Delete a post by id; on success the lists refresh and its detail is dropped. */
@@ -1617,6 +3043,27 @@ declare function useTikTokCreatorInfo(connectionId: string | null): _tanstack_re
     max_video_duration_sec: number;
 }>, Error>;
 
+/**
+ * A platform's FETCHED (read) variant — one member of a stored `Post`'s
+ * `variants`, as returned by `usePost`/`usePosts`/the calendar. Since the API's
+ * read variant is now a typed discriminated union, it carries the SAME typed
+ * `settings`/`body`/`post_type`/`media` the write variant does, plus the
+ * read-only `id`/`status`/`result`/`error`.
+ */
+type ReadPostVariant<P extends PostVariant['platform']> = Extract<PostVariant, {
+    platform: P;
+}>;
+/**
+ * What a preview's `variant` prop accepts: EITHER the compose-time **write**
+ * variant (`XPostVariant`, …) OR the fetched **read** variant. Both expose the
+ * typed `settings`, `body`, `post_type`, and `media[].alt_text_override` the cards
+ * read — so you can hand a preview a post you just built OR one you fetched from
+ * the API, with no transform.
+ */
+type XPreviewVariant = XPostVariant | ReadPostVariant<'x'>;
+type LinkedInPreviewVariant = LinkedInPostVariant | ReadPostVariant<'linkedin'>;
+type TikTokPreviewVariant = TikTokPostVariant | ReadPostVariant<'tiktok'>;
+type InstagramPreviewVariant = InstagramPostVariant | ReadPostVariant<'instagram'>;
 /**
  * Public input types for the post-preview components.
  *
@@ -1716,8 +3163,9 @@ interface XPreviewQuotedTweet {
 declare function toPreviewMedia(items: readonly MediaUploadItem[]): PreviewMedia[];
 
 interface XPostPreviewProps {
-    /** The X variant from our schema — the content source, untouched. */
-    variant: XPostVariant;
+    /** The X variant — either a compose-time write variant or a fetched read
+     * variant (both carry the typed settings/body the card renders). */
+    variant: XPreviewVariant;
     /** Author identity (not stored on our connection — supplied by you). */
     author: XPreviewAuthor;
     /** Resolved media pixels (URLs or compose-time File blobs). */
@@ -1789,8 +3237,9 @@ type LinkedInTheme = 'light' | 'dark' | 'auto';
  * the `--pr-li-*` CSS variables the card reads.
  */
 interface LinkedInPostPreviewProps {
-    /** The LinkedIn variant from our schema — the content source, untouched. */
-    variant: LinkedInPostVariant;
+    /** The LinkedIn variant — either a compose-time write variant or a fetched read
+     * variant (both carry the typed settings/body the card renders). */
+    variant: LinkedInPreviewVariant;
     /** Author identity (LinkedIn stores no avatar/headline on our connection). */
     author: LinkedInPreviewAuthor;
     /** Resolved media pixels (URLs or compose-time File blobs). */
@@ -1880,8 +3329,9 @@ type InstagramTheme = 'light' | 'dark' | 'auto';
  * already-published posts), referencing the real IG feed + Postiz.
  */
 interface InstagramPostPreviewProps {
-    /** The Instagram variant from our schema — the content source, untouched. */
-    variant: InstagramPostVariant;
+    /** The Instagram variant — either a compose-time write variant or a fetched
+     * read variant (both carry the typed settings/body the card renders). */
+    variant: InstagramPreviewVariant;
     /** Author identity (SDK-driven; `verified` is a presentation extra). */
     author: InstagramPreviewAuthor;
     /** Resolved media pixels (processed URLs or compose-time File blobs). */
@@ -1925,8 +3375,9 @@ declare function ReelPreview({ author, body, media, pending, audioName, classNam
  * chunks add the editable caption + the consent-gated Post button.
  */
 interface TikTokPostPreviewProps {
-    /** The TikTok variant from our schema — the content source, untouched. */
-    variant: TikTokPostVariant;
+    /** The TikTok variant — either a compose-time write variant or a fetched read
+     * variant (both carry the typed settings/body the card renders). */
+    variant: TikTokPreviewVariant;
     /** Live creator info (nickname/avatar, audience options, interaction flags). */
     creatorInfo: TikTokCreatorInfo;
     /** Resolved media pixels (processed URLs or compose-time File blobs). */
@@ -2048,4 +3499,4 @@ declare function Declaration({ brandedContent }: {
     brandedContent: boolean;
 }): react.JSX.Element;
 
-export { ArticleCard, type ArticleCardProps, AudienceSelect, type CalendarFilters, CommercialDisclosure, Connect, type ConnectErrorReason, type ConnectOutcome, type ConnectProps, type ConnectRenderApi, type ConnectState, type ConnectionIdentity, type ConnectionsFilter, Declaration, type DiscoverableAccount, DocumentCard, type DocumentCardProps, type InfiniteList, InstagramPostPreview, type InstagramPostPreviewProps, type InstagramPreviewAuthor, type InstagramTheme, InteractionToggles, LinkedInPostPreview, type LinkedInPostPreviewProps, type LinkedInPreviewAuthor, type LiveOptions, type MediaUploadItem, type MediaUploadOptions, type MediaUploadStatus, Poll, type PollProps, type PostrunContextValue, PostrunProvider, type PostrunProviderProps, type PreviewMedia, type PreviewMediaKind, ReelPreview, type ReelPreviewProps, type ResolvedMedia, TikTokCaptionField, type TikTokCaptionFieldProps, TikTokPostPreview, type TikTokPostPreviewProps, TikTokPublishPanel, type TikTokPublishPanelProps, type TikTokTheme, UploadError, type UseConnectParams, type UseConnectResult, type UseMediaUploadOptions, type UseMediaUploadResult, XPoll, type XPollProps, XPostPreview, type XPostPreviewProps, type XPreviewAuthor, type XPreviewMedia, type XPreviewQuotedTweet, connectionKeys, mediaKeys, postKeys, profileKeys, tiktokKeys, toPreviewMedia, useCalendar, useConnect, useConnection, useConnections, useCreatePost, useCreateProfile, useDeleteMedia, useDeletePost, useDeleteProfile, useDisconnect, useDiscoverableAccounts, useInfiniteList, useMedia, useMediaInfinite, useMediaList, useMediaUpload, usePost, usePostrun, usePosts, usePostsInfinite, useProfile, useProfiles, useProfilesInfinite, useSelectAccount, useTikTokCreatorInfo, useUpdateMedia, useUpdatePost, useUpdateProfile, useValidatePost };
+export { ArticleCard, type ArticleCardProps, AudienceSelect, type CalendarFilters, CommercialDisclosure, Connect, type ConnectErrorReason, type ConnectOutcome, type ConnectProps, type ConnectRenderApi, type ConnectState, type ConnectionIdentity, type ConnectionsFilter, Declaration, type DiscoverableAccount, DocumentCard, type DocumentCardProps, type InfiniteList, InstagramPostPreview, type InstagramPostPreviewProps, type InstagramPreviewAuthor, type InstagramPreviewVariant, type InstagramTheme, InteractionToggles, LinkedInPostPreview, type LinkedInPostPreviewProps, type LinkedInPreviewAuthor, type LinkedInPreviewVariant, type LiveOptions, type MediaUploadItem, type MediaUploadOptions, type MediaUploadStatus, Poll, type PollProps, type PostrunContextValue, PostrunProvider, type PostrunProviderProps, type PreviewMedia, type PreviewMediaKind, type ReadPostVariant, ReelPreview, type ReelPreviewProps, type ResolvedMedia, TikTokCaptionField, type TikTokCaptionFieldProps, TikTokPostPreview, type TikTokPostPreviewProps, type TikTokPreviewVariant, TikTokPublishPanel, type TikTokPublishPanelProps, type TikTokTheme, type UseConnectParams, type UseConnectResult, type UseMediaUploadOptions, type UseMediaUploadResult, XPoll, type XPollProps, XPostPreview, type XPostPreviewProps, type XPreviewAuthor, type XPreviewMedia, type XPreviewQuotedTweet, type XPreviewVariant, connectionKeys, mediaKeys, postKeys, profileKeys, tiktokKeys, toPreviewMedia, useCalendar, useConnect, useConnection, useConnections, useCreatePost, useCreateProfile, useDeleteMedia, useDeletePost, useDeleteProfile, useDisconnect, useDiscoverableAccounts, useInfiniteList, useMedia, useMediaInfinite, useMediaList, useMediaUpload, usePost, usePostrun, usePosts, usePostsInfinite, useProfile, useProfiles, useProfilesInfinite, useSelectAccount, useTikTokCreatorInfo, useUpdateMedia, useUpdatePost, useUpdateProfile, useValidatePost };