@postrun/react 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,1237 @@
+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, ConnectablePlatform, MediaTarget, MediaKind, CreateMediaInput, MediaResource, ListPostsQuery, ComposePostInput, XPostVariant, LinkedInPostVariant } from '@postrun/js';
+import { TwitterComponents } from 'react-tweet';
+
+/**
+ * The value every hook and component reads from context: the typed SDK client
+ * plus a private TanStack `QueryClient` that powers caching, dedup, and
+ * revalidation. Hooks pass this `queryClient` explicitly to `useQuery` /
+ * `useMutation`, so it stays fully isolated from any QueryClient the host app
+ * runs of its own — no `QueryClientProvider` setup required from the customer.
+ */
+interface PostrunContextValue {
+    client: PostrunClient;
+    queryClient: QueryClient;
+}
+interface PostrunProviderProps {
+    /**
+     * Returns a valid short-lived scoped token. The host app's backend mints it
+     * from a secret `pr_` key (`POST /v1/tokens`); the secret never reaches the
+     * browser. Called per request — cache and refresh before `exp` inside here.
+     */
+    getToken: () => string | Promise<string>;
+    /** Override the API base URL (defaults to the production gateway). */
+    baseUrl?: string;
+    /**
+     * Bring your own TanStack `QueryClient` (advanced: shared DevTools, custom
+     * defaults, tests). Omit it and a private, isolated one is created for you.
+     */
+    queryClient?: QueryClient;
+    children: ReactNode;
+}
+declare function PostrunProvider({ getToken, baseUrl, queryClient, children, }: PostrunProviderProps): react.FunctionComponentElement<react.ProviderProps<PostrunContextValue | null>>;
+/** Access the configured Postrun client. Throws if used outside a provider. */
+declare function usePostrun(): PostrunContextValue;
+
+/**
+ * The offset-pagination envelope every Postrun list endpoint returns. The helper
+ * only needs these fields; the concrete page type comes from the SDK response
+ * (e.g. `PostList`), which satisfies this structurally — nothing is redeclared.
+ */
+interface PageEnvelope<TItem> {
+    data: TItem[];
+    total: number;
+    offset: number;
+    has_more: boolean;
+}
+/** A flattened, append-style ("load more") view over a paginated list endpoint. */
+interface InfiniteList<TItem> {
+    /** Every item loaded so far, flattened across all fetched pages. */
+    items: TItem[];
+    /** Total items matching the filter (from the first page's envelope). */
+    total: number;
+    /** Fetch the next page and append it. No-op once `hasMore` is false. */
+    loadMore: () => void;
+    /** Whether another page exists beyond what's loaded. */
+    hasMore: boolean;
+    /** The first page is loading (no items yet). */
+    isLoading: boolean;
+    /** A `loadMore()` is in flight (items are already shown). */
+    isLoadingMore: boolean;
+    /** The last error, or null. Narrow with `instanceof PostrunError`. */
+    error: Error | null;
+    /** Refetch from the first page (re-runs every loaded page). */
+    refetch: () => void;
+}
+/**
+ * Turn an offset-paginated Postrun list endpoint into a clean append-style
+ * `{ items, loadMore, hasMore, … }` surface — the "Load more" / infinite-scroll
+ * shape a feed or calendar wants.
+ *
+ * Built on TanStack `useInfiniteQuery`, so page accumulation is its job and never
+ * hand-rolled. The next offset is read from the envelope itself
+ * (`offset + data.length`), so it stays correct regardless of page size.
+ * `fetchPage` supplies the resource-specific SDK call; the page type is inferred
+ * from its return, so item types are derived, never redeclared.
+ */
+declare function useInfiniteList<TItem>(args: {
+    queryKey: QueryKey;
+    fetchPage: (page: {
+        limit: number;
+        offset: number;
+    }) => Promise<PageEnvelope<TItem>>;
+    /** Items per page (default 20, the API's own default). */
+    limit?: number;
+    enabled?: boolean;
+}): InfiniteList<TItem>;
+
+/**
+ * List the account's profiles (client/brand workspaces), filtered and paginated.
+ * `data` is the typed `ProfileList` envelope — inferred straight from the SDK
+ * call, never hand-typed. Caching, dedup, and revalidation come from the
+ * provider's private QueryClient.
+ */
+declare function useProfiles(query?: ListProfilesQuery): _tanstack_react_query.UseQueryResult<NoInfer<{
+    object: "list";
+    data: Array<{
+        id: string;
+        name: string;
+        description: string | null;
+        external_id: string | null;
+        metadata: {
+            [key: string]: string | number | boolean;
+        };
+        created_at: string | null;
+        updated_at: string | null;
+    }>;
+    total: number;
+    limit: number;
+    offset: number;
+    has_more: boolean;
+}>, Error>;
+/**
+ * List profiles with append-style ("load more") pagination. Returns
+ * `{ items, loadMore, hasMore, isLoading, isLoadingMore, total }`: render
+ * `items`, call `loadMore()` while `hasMore`. `pageSize` defaults to 20. Filters
+ * match `useProfiles` minus paging, which the hook owns. Shares list-cache
+ * invalidation with the other profile hooks.
+ */
+declare function useProfilesInfinite(filters?: Omit<ListProfilesQuery, 'limit' | 'offset'>, options?: {
+    pageSize?: number;
+}): InfiniteList<{
+    id: string;
+    name: string;
+    description: string | null;
+    external_id: string | null;
+    metadata: {
+        [key: string]: string | number | boolean;
+    };
+    created_at: string | null;
+    updated_at: string | null;
+}>;
+/** Retrieve a single profile by id. Disabled until an id is provided. */
+declare function useProfile(id: string): _tanstack_react_query.UseQueryResult<NoInfer<{
+    id: string;
+    name: string;
+    description: string | null;
+    external_id: string | null;
+    metadata: {
+        [key: string]: string | number | boolean;
+    };
+    created_at: string | null;
+    updated_at: string | null;
+}>, Error>;
+/** Create a profile; on success the profile lists are refetched. */
+declare function useCreateProfile(): _tanstack_react_query.UseMutationResult<{
+    id: string;
+    name: string;
+    description: string | null;
+    external_id: string | null;
+    metadata: {
+        [key: string]: string | number | boolean;
+    };
+    created_at: string | null;
+    updated_at: string | null;
+}, Error, {
+    name: string;
+    description?: string;
+    external_id?: string;
+    metadata?: {
+        [key: string]: string | number | boolean;
+    };
+}, unknown>;
+/** Update a profile by id; on success the lists and that profile are refreshed. */
+declare function useUpdateProfile(): _tanstack_react_query.UseMutationResult<{
+    id: string;
+    name: string;
+    description: string | null;
+    external_id: string | null;
+    metadata: {
+        [key: string]: string | number | boolean;
+    };
+    created_at: string | null;
+    updated_at: string | null;
+}, Error, {
+    id: string;
+} & {
+    name?: string;
+    description?: string | null;
+    external_id?: string;
+    metadata?: {
+        [key: string]: string | number | boolean;
+    };
+}, unknown>;
+/** Delete a profile by id; on success the lists refresh and its detail is dropped. */
+declare function useDeleteProfile(): _tanstack_react_query.UseMutationResult<{
+    id: string;
+    object: "profile";
+    deleted: true;
+}, Error, string, unknown>;
+
+interface ConnectParams {
+    /** The profile to attach the new connection to. */
+    profileId: string;
+    /** The platform to connect (X, LinkedIn, Meta, …). */
+    platform: ConnectablePlatform;
+}
+/**
+ * Start a connect flow: mint a session and redirect the browser to the hosted
+ * connect URL on postrun.ai, where the full white-labeled OAuth journey runs and
+ * the user is returned to the host app. Bare-bones by design — the OAuth UI is
+ * ours and hosted, so the host app just calls `mutate({ profileId, platform })`.
+ * On return, the new connection appears via `useConnections`.
+ */
+declare function useConnect(): _tanstack_react_query.UseMutationResult<{
+    connect_session_token: string;
+    connect_url: string;
+    expires_at: string;
+}, Error, ConnectParams, unknown>;
+/** List a profile's connected accounts. */
+declare function useConnections(profileId: string): _tanstack_react_query.UseQueryResult<NoInfer<{
+    object: "list";
+    data: Array<{
+        id: string;
+        profile_id: string;
+        platform: "meta_ads" | "google_ads" | "tiktok_ads" | "x" | "linkedin" | "facebook_page" | "instagram" | "tiktok";
+        external_account_id: string | null;
+        external_account_name: string | null;
+        currency: string | null;
+        created_at: string | null;
+        updated_at: string | null;
+    }>;
+    total: number;
+    limit: number;
+    offset: number;
+    has_more: boolean;
+}>, Error>;
+/** Retrieve a single connection by id. */
+declare function useConnection(id: string): _tanstack_react_query.UseQueryResult<NoInfer<{
+    id: string;
+    profile_id: string;
+    platform: "meta_ads" | "google_ads" | "tiktok_ads" | "x" | "linkedin" | "facebook_page" | "instagram" | "tiktok";
+    external_account_id: string | null;
+    external_account_name: string | null;
+    currency: string | null;
+    created_at: string | null;
+    updated_at: string | null;
+}>, Error>;
+/** List the accounts discoverable on a pending connection (for selection). */
+declare function useDiscoverableAccounts(id: string): _tanstack_react_query.UseQueryResult<NoInfer<{
+    object: "list";
+    data: Array<{
+        external_account_id: string;
+        name: string | null;
+        currency: string | null;
+        instagram?: {
+            external_account_id: string;
+            name: string | null;
+        } | null;
+    }>;
+}>, Error>;
+/** Select an account on a pending connection, activating it. */
+declare function useSelectAccount(): _tanstack_react_query.UseMutationResult<{
+    id: string;
+    profile_id: string;
+    platform: "meta_ads" | "google_ads" | "tiktok_ads" | "x" | "linkedin" | "facebook_page" | "instagram" | "tiktok";
+    external_account_id: string | null;
+    external_account_name: string | null;
+    currency: string | null;
+    created_at: string | null;
+    updated_at: string | null;
+}, Error, {
+    id: string;
+} & {
+    external_account_id: string;
+}, unknown>;
+/** Disconnect (delete) a connection by id. */
+declare function useDisconnect(): _tanstack_react_query.UseMutationResult<{
+    id: string;
+    object: "connection";
+    deleted: true;
+}, Error, string, unknown>;
+
+type MediaUploadStatus = 'idle' | 'uploading' | 'processing' | 'ready' | 'failed';
+interface MediaUploadOptions {
+    /** Profile that owns the asset. */
+    profileId: string;
+    /** Platforms to validate + render for (omit to add later via useUpdateMedia). */
+    targets?: MediaTarget[];
+    /** Override the kind inferred from the file's MIME. */
+    kind?: MediaKind;
+    /** The file's MIME type. Defaults to `file.type`; required when that's empty. */
+    contentType?: string;
+    /** Store as-is with zero processing. */
+    raw?: boolean;
+    altText?: string;
+    externalId?: string;
+    metadata?: CreateMediaInput['metadata'];
+}
+/**
+ * Upload a file and get back a platform-validated asset. The hook owns the whole
+ * journey: infer kind/content_type from the `File`, create the asset, PUT the
+ * bytes with live `progress` + retry, poll until processing settles, and expose
+ * `media.per_platform` (per-target status, url, warnings, errors). `cancel()`
+ * aborts an in-flight upload.
+ */
+declare function useMediaUpload(): {
+    upload: (file: File, options: MediaUploadOptions) => Promise<MediaResource>;
+    cancel: () => void | undefined;
+    reset: () => void;
+    status: MediaUploadStatus;
+    progress: number;
+    media: {
+        id: string;
+        object: "media";
+        profile_id: string;
+        kind: "image" | "video" | "gif" | "document";
+        status: "uploading" | "processing" | "ready" | "failed";
+        raw: boolean;
+        error: {
+            code: "media_unprobeable" | "media_too_large" | "media_aspect_ratio_unsupported" | "media_resolution_too_low" | "media_gif_unsupported" | "media_format_recompressed" | "media_resolution_downscaled" | "video_container_unsupported" | "video_codec_unsupported" | "video_audio_codec_unsupported" | "video_too_large" | "video_too_small" | "video_dimensions_unsupported" | "video_dimensions_too_large" | "video_fps_unsupported" | "video_fps_too_low" | "video_aspect_unsupported" | "video_duration_too_short" | "video_duration_exceeds_max" | "document_format_unsupported" | "document_too_large" | "document_too_many_pages" | "media_unsupported";
+            message: string;
+            hint?: string;
+            allowed?: Array<string>;
+            got?: string;
+        } | null;
+        source: {
+            format: string;
+            bytes: number;
+            width: number | null;
+            height: number | null;
+            duration_ms: number | null;
+        } | null;
+        alt_text: string | null;
+        per_platform: {
+            [key: string]: {
+                status: "processing" | "ready" | "failed";
+                url: string | null;
+                width: number | null;
+                height: number | null;
+                bytes: number | null;
+                warnings: Array<{
+                    code: "media_unprobeable" | "media_too_large" | "media_aspect_ratio_unsupported" | "media_resolution_too_low" | "media_gif_unsupported" | "media_format_recompressed" | "media_resolution_downscaled" | "video_container_unsupported" | "video_codec_unsupported" | "video_audio_codec_unsupported" | "video_too_large" | "video_too_small" | "video_dimensions_unsupported" | "video_dimensions_too_large" | "video_fps_unsupported" | "video_fps_too_low" | "video_aspect_unsupported" | "video_duration_too_short" | "video_duration_exceeds_max" | "document_format_unsupported" | "document_too_large" | "document_too_many_pages" | "media_unsupported";
+                    message: string;
+                    hint?: string;
+                    allowed?: Array<string>;
+                    got?: string;
+                }>;
+                errors: Array<{
+                    code: "media_unprobeable" | "media_too_large" | "media_aspect_ratio_unsupported" | "media_resolution_too_low" | "media_gif_unsupported" | "media_format_recompressed" | "media_resolution_downscaled" | "video_container_unsupported" | "video_codec_unsupported" | "video_audio_codec_unsupported" | "video_too_large" | "video_too_small" | "video_dimensions_unsupported" | "video_dimensions_too_large" | "video_fps_unsupported" | "video_fps_too_low" | "video_aspect_unsupported" | "video_duration_too_short" | "video_duration_exceeds_max" | "document_format_unsupported" | "document_too_large" | "document_too_many_pages" | "media_unsupported";
+                    message: string;
+                    hint?: string;
+                    allowed?: Array<string>;
+                    got?: string;
+                }>;
+            };
+        };
+        external_id: string | null;
+        metadata: {
+            [key: string]: string | number | boolean;
+        };
+        created_at: string;
+        updated_at: string;
+    } | null;
+    error: unknown;
+};
+/** Retrieve a media asset; auto-polls while it is still uploading/processing. */
+declare function useMedia(id: string): _tanstack_react_query.UseQueryResult<NoInfer<{
+    id: string;
+    object: "media";
+    profile_id: string;
+    kind: "image" | "video" | "gif" | "document";
+    status: "uploading" | "processing" | "ready" | "failed";
+    raw: boolean;
+    error: {
+        code: "media_unprobeable" | "media_too_large" | "media_aspect_ratio_unsupported" | "media_resolution_too_low" | "media_gif_unsupported" | "media_format_recompressed" | "media_resolution_downscaled" | "video_container_unsupported" | "video_codec_unsupported" | "video_audio_codec_unsupported" | "video_too_large" | "video_too_small" | "video_dimensions_unsupported" | "video_dimensions_too_large" | "video_fps_unsupported" | "video_fps_too_low" | "video_aspect_unsupported" | "video_duration_too_short" | "video_duration_exceeds_max" | "document_format_unsupported" | "document_too_large" | "document_too_many_pages" | "media_unsupported";
+        message: string;
+        hint?: string;
+        allowed?: Array<string>;
+        got?: string;
+    } | null;
+    source: {
+        format: string;
+        bytes: number;
+        width: number | null;
+        height: number | null;
+        duration_ms: number | null;
+    } | null;
+    alt_text: string | null;
+    per_platform: {
+        [key: string]: {
+            status: "processing" | "ready" | "failed";
+            url: string | null;
+            width: number | null;
+            height: number | null;
+            bytes: number | null;
+            warnings: Array<{
+                code: "media_unprobeable" | "media_too_large" | "media_aspect_ratio_unsupported" | "media_resolution_too_low" | "media_gif_unsupported" | "media_format_recompressed" | "media_resolution_downscaled" | "video_container_unsupported" | "video_codec_unsupported" | "video_audio_codec_unsupported" | "video_too_large" | "video_too_small" | "video_dimensions_unsupported" | "video_dimensions_too_large" | "video_fps_unsupported" | "video_fps_too_low" | "video_aspect_unsupported" | "video_duration_too_short" | "video_duration_exceeds_max" | "document_format_unsupported" | "document_too_large" | "document_too_many_pages" | "media_unsupported";
+                message: string;
+                hint?: string;
+                allowed?: Array<string>;
+                got?: string;
+            }>;
+            errors: Array<{
+                code: "media_unprobeable" | "media_too_large" | "media_aspect_ratio_unsupported" | "media_resolution_too_low" | "media_gif_unsupported" | "media_format_recompressed" | "media_resolution_downscaled" | "video_container_unsupported" | "video_codec_unsupported" | "video_audio_codec_unsupported" | "video_too_large" | "video_too_small" | "video_dimensions_unsupported" | "video_dimensions_too_large" | "video_fps_unsupported" | "video_fps_too_low" | "video_aspect_unsupported" | "video_duration_too_short" | "video_duration_exceeds_max" | "document_format_unsupported" | "document_too_large" | "document_too_many_pages" | "media_unsupported";
+                message: string;
+                hint?: string;
+                allowed?: Array<string>;
+                got?: string;
+            }>;
+        };
+    };
+    external_id: string | null;
+    metadata: {
+        [key: string]: string | number | boolean;
+    };
+    created_at: string;
+    updated_at: string;
+}>, Error>;
+/** Update a media asset: alt text / metadata / external_id, or extend targets. */
+declare function useUpdateMedia(): _tanstack_react_query.UseMutationResult<{
+    id: string;
+    object: "media";
+    profile_id: string;
+    kind: "image" | "video" | "gif" | "document";
+    status: "uploading" | "processing" | "ready" | "failed";
+    raw: boolean;
+    error: {
+        code: "media_unprobeable" | "media_too_large" | "media_aspect_ratio_unsupported" | "media_resolution_too_low" | "media_gif_unsupported" | "media_format_recompressed" | "media_resolution_downscaled" | "video_container_unsupported" | "video_codec_unsupported" | "video_audio_codec_unsupported" | "video_too_large" | "video_too_small" | "video_dimensions_unsupported" | "video_dimensions_too_large" | "video_fps_unsupported" | "video_fps_too_low" | "video_aspect_unsupported" | "video_duration_too_short" | "video_duration_exceeds_max" | "document_format_unsupported" | "document_too_large" | "document_too_many_pages" | "media_unsupported";
+        message: string;
+        hint?: string;
+        allowed?: Array<string>;
+        got?: string;
+    } | null;
+    source: {
+        format: string;
+        bytes: number;
+        width: number | null;
+        height: number | null;
+        duration_ms: number | null;
+    } | null;
+    alt_text: string | null;
+    per_platform: {
+        [key: string]: {
+            status: "processing" | "ready" | "failed";
+            url: string | null;
+            width: number | null;
+            height: number | null;
+            bytes: number | null;
+            warnings: Array<{
+                code: "media_unprobeable" | "media_too_large" | "media_aspect_ratio_unsupported" | "media_resolution_too_low" | "media_gif_unsupported" | "media_format_recompressed" | "media_resolution_downscaled" | "video_container_unsupported" | "video_codec_unsupported" | "video_audio_codec_unsupported" | "video_too_large" | "video_too_small" | "video_dimensions_unsupported" | "video_dimensions_too_large" | "video_fps_unsupported" | "video_fps_too_low" | "video_aspect_unsupported" | "video_duration_too_short" | "video_duration_exceeds_max" | "document_format_unsupported" | "document_too_large" | "document_too_many_pages" | "media_unsupported";
+                message: string;
+                hint?: string;
+                allowed?: Array<string>;
+                got?: string;
+            }>;
+            errors: Array<{
+                code: "media_unprobeable" | "media_too_large" | "media_aspect_ratio_unsupported" | "media_resolution_too_low" | "media_gif_unsupported" | "media_format_recompressed" | "media_resolution_downscaled" | "video_container_unsupported" | "video_codec_unsupported" | "video_audio_codec_unsupported" | "video_too_large" | "video_too_small" | "video_dimensions_unsupported" | "video_dimensions_too_large" | "video_fps_unsupported" | "video_fps_too_low" | "video_aspect_unsupported" | "video_duration_too_short" | "video_duration_exceeds_max" | "document_format_unsupported" | "document_too_large" | "document_too_many_pages" | "media_unsupported";
+                message: string;
+                hint?: string;
+                allowed?: Array<string>;
+                got?: string;
+            }>;
+        };
+    };
+    external_id: string | null;
+    metadata: {
+        [key: string]: string | number | boolean;
+    };
+    created_at: string;
+    updated_at: string;
+}, Error, {
+    id: string;
+} & {
+    alt_text?: string | null;
+    external_id?: string | null;
+    metadata?: {
+        [key: string]: string | number | boolean;
+    };
+    targets?: Array<"x" | "linkedin" | "facebook_page" | "instagram" | "tiktok" | "google_ads">;
+}, unknown>;
+/** Delete a media asset and its stored renditions. */
+declare function useDeleteMedia(): _tanstack_react_query.UseMutationResult<{
+    id: string;
+    object: "media";
+    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
+ * from the generated `ListPostsQuery` contract (no hand-typed shapes), so it
+ * can never drift from the API. Pagination still rides through via `usePosts`.
+ */
+type CalendarFilters = Pick<ListPostsQuery, 'profile_id' | 'scheduled_after' | 'scheduled_before' | 'status'>;
+/** Per-hook live-poll control: live is on by default; `{ live: false }` opts out. */
+interface LiveOptions {
+    /** Auto-poll while a post is in-flight (default `true`). Set `false` for one-shot. */
+    live?: boolean;
+}
+/**
+ * List posts — the calendar/queue data, filtered (profile_id / external_id /
+ * metadata) and paginated. `data` is the typed `PostList` envelope, with each
+ * post's derived status (draft / scheduled / publishing / published / failed).
+ */
+declare function usePosts(query?: ListPostsQuery): _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;
+            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;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: 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;
+    }>;
+    total: number;
+    limit: number;
+    offset: number;
+    has_more: boolean;
+}>, Error>;
+/**
+ * List posts with append-style ("load more") pagination — the calendar/queue
+ * feed. Returns `{ items, loadMore, hasMore, isLoading, isLoadingMore, total }`:
+ * render `items`, call `loadMore()` (on a button or scroll end) while `hasMore`.
+ * `pageSize` defaults to 20. Filters are the same as `usePosts` minus paging,
+ * which the hook owns. Shares list-cache invalidation with the other post hooks,
+ * so a create/update/delete refreshes it automatically.
+ */
+declare function usePostsInfinite(filters?: Omit<ListPostsQuery, 'limit' | 'offset'>, options?: {
+    pageSize?: number;
+}): InfiniteList<{
+    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;
+        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;
+            permalink: string | null;
+            published_at: string;
+        } | null;
+        error: {
+            code: string;
+            message: 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 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;
+            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;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: 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;
+    }>;
+    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;
+        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;
+            permalink: string | null;
+            published_at: string;
+        } | null;
+        error: {
+            code: string;
+            message: 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.
+ */
+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<{
+            id: string;
+            object: "post_variant";
+            connection_id: string;
+            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;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: 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<{
+            id: string;
+            object: "post_variant";
+            connection_id: string;
+            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;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: 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;
+    isReady: boolean;
+    connectedChannels: ("x" | "linkedin" | "facebook_page" | "instagram")[];
+};
+/**
+ * Update a post by id. Pass a light edit directly (`{ schedule_at }`,
+ * `{ tags }`, …) or a rebuilt body from `buildUpdatePost(input, connections)`
+ * for content edits (the API's PATCH replaces the variant set).
+ */
+declare function useUpdatePost(postId: string): _tanstack_react_query.UseMutationResult<{
+    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;
+        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;
+            permalink: string | null;
+            published_at: string;
+        } | null;
+        error: {
+            code: string;
+            message: 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, {
+    publish?: "now" | "schedule" | "draft";
+    schedule_at?: string | null;
+    external_id?: string | null;
+    metadata?: {
+        [key: string]: string | number | boolean;
+    };
+    tags?: Array<string>;
+    notes?: string | null;
+    dry_run?: boolean;
+    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;
+            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>;
+        };
+    } | {
+        platform: "linkedin";
+        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: {
+            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;
+            }>;
+        };
+    } | {
+        platform: "instagram";
+        post_type: "single_image" | "carousel" | "reel";
+        connection_id: string;
+        body?: string;
+        media?: Array<{
+            media_id: string;
+            crop_box?: {
+                [key: string]: unknown;
+            } | null;
+            alt_text_override?: string | null;
+        }>;
+        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;
+        };
+    } | {
+        platform: "facebook_page";
+        post_type: "text" | "single_image" | "multi_image" | "reel";
+        connection_id: string;
+        body?: string;
+        media?: Array<{
+            media_id: string;
+            crop_box?: {
+                [key: string]: unknown;
+            } | null;
+            alt_text_override?: string | null;
+        }>;
+        settings?: {
+            link?: string;
+        };
+    }>;
+}, unknown>;
+/** Delete a post by id; on success the lists refresh and its detail is dropped. */
+declare function useDeletePost(): _tanstack_react_query.UseMutationResult<{
+    id: string;
+    object: "post";
+    deleted: true;
+}, Error, string, unknown>;
+
+/**
+ * Query-key factory for profiles. Hierarchical so a mutation can invalidate at
+ * the right granularity: `lists()` after a create, `detail(id)` after an update.
+ */
+declare const profileKeys: {
+    all: readonly ["postrun", "profiles"];
+    lists: () => readonly ["postrun", "profiles", "list"];
+    list: (query?: ListProfilesQuery) => readonly ["postrun", "profiles", "list", {
+        limit?: number;
+        offset?: number;
+        external_id?: string;
+        metadata?: {
+            [key: string]: string | number | boolean;
+        };
+    }];
+    infinite: (query?: ListProfilesQuery) => readonly ["postrun", "profiles", "list", "infinite", {
+        limit?: number;
+        offset?: number;
+        external_id?: string;
+        metadata?: {
+            [key: string]: string | number | boolean;
+        };
+    }];
+    details: () => readonly ["postrun", "profiles", "detail"];
+    detail: (id: string) => readonly ["postrun", "profiles", "detail", string];
+};
+/** Query-key factory for posts (list filtered by query; detail by id). */
+declare const postKeys: {
+    all: readonly ["postrun", "posts"];
+    lists: () => readonly ["postrun", "posts", "list"];
+    list: (query?: ListPostsQuery) => readonly ["postrun", "posts", "list", {
+        limit?: number;
+        offset?: number;
+        profile_id?: string;
+        external_id?: string;
+        metadata?: {
+            [key: string]: string | number | boolean;
+        };
+        scheduled_after?: string;
+        scheduled_before?: string;
+        updated_after?: string;
+        status?: Array<"draft" | "scheduled" | "publishing" | "partially_published" | "published" | "failed">;
+    }];
+    infinite: (query?: ListPostsQuery) => readonly ["postrun", "posts", "list", "infinite", {
+        limit?: number;
+        offset?: number;
+        profile_id?: string;
+        external_id?: string;
+        metadata?: {
+            [key: string]: string | number | boolean;
+        };
+        scheduled_after?: string;
+        scheduled_before?: string;
+        updated_after?: string;
+        status?: Array<"draft" | "scheduled" | "publishing" | "partially_published" | "published" | "failed">;
+    }];
+    details: () => readonly ["postrun", "posts", "detail"];
+    detail: (id: string) => readonly ["postrun", "posts", "detail", string];
+};
+/** Query-key factory for media assets (single-asset only; no list endpoint yet). */
+declare const mediaKeys: {
+    all: readonly ["postrun", "media"];
+    details: () => readonly ["postrun", "media", "detail"];
+    detail: (id: string) => readonly ["postrun", "media", "detail", string];
+};
+/** Query-key factory for connections (lists keyed by owning profile). */
+declare const connectionKeys: {
+    all: readonly ["postrun", "connections"];
+    lists: () => readonly ["postrun", "connections", "list"];
+    list: (profileId: string) => readonly ["postrun", "connections", "list", string];
+    details: () => readonly ["postrun", "connections", "detail"];
+    detail: (id: string) => readonly ["postrun", "connections", "detail", string];
+    accounts: (id: string) => readonly ["postrun", "connections", "accounts", string];
+};
+
+/**
+ * Public input types for the post-preview components. These describe data the
+ * CUSTOMER supplies for presentation — NOT shapes from our OpenAPI contract — so
+ * they are authored here rather than derived. The one value with a contract
+ * counterpart, a media asset's `kind`, IS derived from the SDK's `MediaKind`.
+ *
+ * Why author/media live outside the post schema: a connection stores only a
+ * cached account name (no avatar, no `@handle`, no verified flag), and a variant
+ * references media by id, not by pixels — at compose time the only pixels that
+ * exist are a local `File`.
+ */
+/** The author identity rendered in an X preview header. */
+interface XPreviewAuthor {
+    /** Display name, e.g. "Acme Studio". */
+    name: string;
+    /** Handle WITHOUT the leading `@`, e.g. "acmestudio". */
+    handle: string;
+    /** Avatar image URL. Omit for a neutral placeholder. */
+    avatarUrl?: string;
+    /** Show the verified badge. Default false. */
+    verified?: boolean;
+}
+/** The author identity rendered in a LinkedIn preview header. LinkedIn shows a
+ * name + a one-line headline (role/tagline), not an `@handle`. */
+interface LinkedInPreviewAuthor {
+    /** Display name, e.g. "Acme Studio". */
+    name: string;
+    /** One-line headline under the name, e.g. "Founder & CEO at Acme". */
+    headline?: string;
+    /** Avatar image URL. Omit for a neutral placeholder. */
+    avatarUrl?: string;
+    /** Show the verified badge. Default false. */
+    verified?: boolean;
+}
+/** The media kinds a social preview can render (documents are not previewable
+ * here) — derived from the SDK's `MediaKind`, never re-listed. */
+type PreviewMediaKind = Extract<MediaKind, 'image' | 'video' | 'gif'>;
+/**
+ * One media item to preview. Provide a `url` (e.g. the processed
+ * `MediaResource.per_platform.<platform>.url`) OR a `file` (a compose-time blob,
+ * before upload) — the component turns a `file` into an object URL and revokes it
+ * on unmount. An item with neither is skipped.
+ */
+interface PreviewMedia {
+    kind: PreviewMediaKind;
+    url?: string;
+    file?: File;
+    /** Natural pixel width — improves layout fidelity when known. */
+    width?: number;
+    /** Natural pixel height — improves layout fidelity when known. */
+    height?: number;
+    /** Alt text; falls back to the variant media's `alt_text_override`. */
+    alt?: string;
+    /** Poster frame for a video; falls back to `url`/`file`. */
+    posterUrl?: string;
+}
+/** @deprecated Use {@link PreviewMedia}. Kept as an alias for back-compat. */
+type XPreviewMedia = PreviewMedia;
+/**
+ * Content for the nested quoted card. Supplied separately because our schema
+ * carries only an opaque `quote_tweet_id` (no quoted text/author).
+ */
+interface XPreviewQuotedTweet {
+    author: XPreviewAuthor;
+    body?: string;
+    media?: PreviewMedia[];
+}
+
+interface XPostPreviewProps {
+    /** The X variant from our schema — the content source, untouched. */
+    variant: XPostVariant;
+    /** Author identity (not stored on our connection — supplied by you). */
+    author: XPreviewAuthor;
+    /** Resolved media pixels (URLs or compose-time File blobs). */
+    media?: PreviewMedia[];
+    /** Content for the quoted card when `settings.quote_tweet_id` is set. */
+    quotedTweet?: XPreviewQuotedTweet;
+    /** The replied-to account's handle (our schema only stores the parent id). */
+    replyToHandle?: string;
+    /** Color scheme. `auto` (default) inherits the host's theme. */
+    theme?: 'light' | 'dark' | 'auto';
+    /** Show the static action row (icons, no counts). Default true. */
+    showActions?: boolean;
+    /** Class applied to the wrapper — your hook for sizing, shadows, etc. */
+    className?: string;
+    /** Inline styles on the wrapper — e.g. react-tweet CSS variables
+     * (`{ ['--tweet-container-margin']: '0' }`). */
+    style?: CSSProperties;
+    /** Override react-tweet's internal pieces (e.g. `next/image` avatars). */
+    components?: TwitterComponents;
+}
+/**
+ * A faithful, pixel-accurate preview of how an X post will look once published,
+ * rendered straight from a Postrun X variant. Built on `react-tweet` (the same
+ * card X itself ships), so you write zero card UI — pass the schema, render the
+ * preview. Fully customizable: restyle via `className`/`style` (CSS variables)
+ * or swap internals via `components`; theme light/dark/auto.
+ */
+declare function XPostPreviewImpl({ variant, author, media, quotedTweet, replyToHandle, theme, showActions, className, style, components, }: XPostPreviewProps): react.JSX.Element;
+/** Memoized: re-renders only when its props change (the resolved-media hook
+ * already absorbs unstable media arrays). */
+declare const XPostPreview: react.MemoExoticComponent<typeof XPostPreviewImpl>;
+
+/**
+ * LinkedIn preview theming. Unlike the X preview (which inherits react-tweet's
+ * CSS), we own the LinkedIn card, so we expose a small set of CSS custom
+ * properties on the wrapper. The resolved palette sets their default values;
+ * a customer can override any of them via `style`/`className`. Components read
+ * `var(--pr-li-*)`, so restyling needs no fork.
+ */
+type LinkedInTheme = 'light' | 'dark' | 'auto';
+
+/**
+ * A faithful, schema-driven preview of how a LinkedIn post will look in-feed,
+ * rendered straight from a Postrun LinkedIn variant. Clean-room components (no
+ * dependency to "buy" exists for LinkedIn), mirroring the real feed card: header
+ * with headline + audience icon, an entity-highlighted body with the "…more"
+ * fold, the 1/2/3/4/+N image mosaic (or a video), and a static action bar.
+ *
+ * v1 renders text + images + video. The richer `content_kind`s (article, poll,
+ * document) degrade gracefully to the text/media card and arrive next.
+ *
+ * Customize via `theme` (light/dark/auto), `className`/`style`, or by overriding
+ * the `--pr-li-*` CSS variables the card reads.
+ */
+interface LinkedInPostPreviewProps {
+    /** The LinkedIn variant from our schema — the content source, untouched. */
+    variant: LinkedInPostVariant;
+    /** Author identity (LinkedIn stores no avatar/headline on our connection). */
+    author: LinkedInPreviewAuthor;
+    /** Resolved media pixels (URLs or compose-time File blobs). */
+    media?: PreviewMedia[];
+    /** Color scheme. `auto` (default) follows the OS preference. */
+    theme?: LinkedInTheme;
+    /** Relative time label shown in the header. Default "Now". */
+    time?: string;
+    /** Show the static action bar (Like/Comment/Repost/Send). Default true. */
+    showActions?: boolean;
+    /** Class applied to the card — your hook for sizing, shadows, etc. */
+    className?: string;
+    /** Inline styles on the card — including `--pr-li-*` variable overrides. */
+    style?: CSSProperties;
+}
+declare function LinkedInPostPreviewImpl({ variant, author, media, theme, time, showActions, className, style, }: LinkedInPostPreviewProps): react.JSX.Element;
+/** Memoized: re-renders only when its props change (the resolved-media hook
+ * absorbs unstable media arrays). */
+declare const LinkedInPostPreview: react.MemoExoticComponent<typeof LinkedInPostPreviewImpl>;
+
+export { type CalendarFilters, type ConnectParams, type InfiniteList, LinkedInPostPreview, type LinkedInPostPreviewProps, type LinkedInPreviewAuthor, type LiveOptions, type MediaUploadOptions, type MediaUploadStatus, type PostrunContextValue, PostrunProvider, type PostrunProviderProps, type PreviewMedia, type PreviewMediaKind, UploadError, XPostPreview, type XPostPreviewProps, type XPreviewAuthor, type XPreviewMedia, type XPreviewQuotedTweet, connectionKeys, mediaKeys, postKeys, profileKeys, useCalendar, useConnect, useConnection, useConnections, useCreatePost, useCreateProfile, useDeleteMedia, useDeletePost, useDeleteProfile, useDisconnect, useDiscoverableAccounts, useInfiniteList, useMedia, useMediaUpload, usePost, usePostrun, usePosts, usePostsInfinite, useProfile, useProfiles, useProfilesInfinite, useSelectAccount, useUpdateMedia, useUpdatePost, useUpdateProfile };