npm - @postrun/react - Versions diffs - 0.1.0 → 0.2.0 - Mend

@postrun/react 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/index.d.ts CHANGED Viewed

@@ -2,7 +2,7 @@ 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 { PostrunClient, ListProfilesQuery, ConnectionKind, ConnectionStatus, ListMediaQuery, ListPostsQuery, ConnectablePlatform, MediaTarget, MediaKind, Metadata, MediaResource, ComposePostInput, XPostVariant, LinkedInPostVariant } from '@postrun/js';
 import { TwitterComponents } from 'react-tweet';
 /**
@@ -191,6 +191,109 @@ declare function useDeleteProfile(): _tanstack_react_query.UseMutationResult<{
     deleted: true;
 }, Error, string, unknown>;
+/** The connection-list filter that keys the cache (social/ads + lifecycle). */
+interface ConnectionsFilter {
+    kind?: ConnectionKind;
+    status?: ConnectionStatus;
+}
+/**
+ * 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?: Omit<ListProfilesQuery, "limit" | "offset">) => readonly ["postrun", "profiles", "list", "infinite", Omit<{
+        limit?: number;
+        offset?: number;
+        external_id?: string;
+        metadata?: {
+            [key: string]: string | number | boolean;
+        };
+    }, "limit" | "offset">];
+    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?: Omit<ListPostsQuery, "limit" | "offset">) => readonly ["postrun", "posts", "list", "infinite", Omit<{
+        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">;
+    }, "limit" | "offset">];
+    details: () => readonly ["postrun", "posts", "detail"];
+    detail: (id: string) => readonly ["postrun", "posts", "detail", string];
+};
+/** Query-key factory for media assets (list filtered by query; detail by id). */
+declare const mediaKeys: {
+    all: readonly ["postrun", "media"];
+    lists: () => readonly ["postrun", "media", "list"];
+    list: (query?: ListMediaQuery) => readonly ["postrun", "media", "list", {
+        limit?: number;
+        offset?: number;
+        profile_id?: string;
+        status?: "uploading" | "processing" | "ready" | "failed";
+        kind?: "image" | "video" | "gif" | "document";
+        external_id?: string;
+        metadata?: {
+            [key: string]: string | number | boolean;
+        };
+    }];
+    infinite: (query?: Omit<ListMediaQuery, "limit" | "offset">) => readonly ["postrun", "media", "list", "infinite", Omit<{
+        limit?: number;
+        offset?: number;
+        profile_id?: string;
+        status?: "uploading" | "processing" | "ready" | "failed";
+        kind?: "image" | "video" | "gif" | "document";
+        external_id?: string;
+        metadata?: {
+            [key: string]: string | number | boolean;
+        };
+    }, "limit" | "offset">];
+    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, filter?: ConnectionsFilter) => readonly ["postrun", "connections", "list", string, ConnectionsFilter];
+    details: () => readonly ["postrun", "connections", "detail"];
+    detail: (id: string) => readonly ["postrun", "connections", "detail", string];
+    accounts: (id: string) => readonly ["postrun", "connections", "accounts", string];
+};
 interface ConnectParams {
     /** The profile to attach the new connection to. */
     profileId: string;
@@ -205,19 +308,29 @@ interface ConnectParams {
  * On return, the new connection appears via `useConnections`.
  */
 declare function useConnect(): _tanstack_react_query.UseMutationResult<{
-    connect_session_token: string;
-    connect_url: string;
+    hosted_connect_url: string;
+    connect_token: string;
     expires_at: string;
 }, Error, ConnectParams, unknown>;
-/** List a profile's connected accounts. */
-declare function useConnections(profileId: string): _tanstack_react_query.UseQueryResult<NoInfer<{
+/**
+ * List a profile's connected accounts. Pass a `filter` to narrow by `kind`
+ * (`posting` = social, `ads`) or `status` — e.g. a composer fetches
+ * `{ kind: 'posting' }` to show only the social accounts it can publish to.
+ */
+declare function useConnections(profileId: string, filter?: ConnectionsFilter): _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";
+        kind: "posting" | "ads";
+        status: "pending" | "active" | "needs_reauth";
         external_account_id: string | null;
         external_account_name: string | null;
+        username: string | null;
+        avatar_url: string | null;
+        profile_url: string | null;
+        reauth_at: string | null;
         currency: string | null;
         created_at: string | null;
         updated_at: string | null;
@@ -232,8 +345,14 @@ declare function useConnection(id: string): _tanstack_react_query.UseQueryResult
     id: string;
     profile_id: string;
     platform: "meta_ads" | "google_ads" | "tiktok_ads" | "x" | "linkedin" | "facebook_page" | "instagram" | "tiktok";
+    kind: "posting" | "ads";
+    status: "pending" | "active" | "needs_reauth";
     external_account_id: string | null;
     external_account_name: string | null;
+    username: string | null;
+    avatar_url: string | null;
+    profile_url: string | null;
+    reauth_at: string | null;
     currency: string | null;
     created_at: string | null;
     updated_at: string | null;
@@ -245,9 +364,15 @@ declare function useDiscoverableAccounts(id: string): _tanstack_react_query.UseQ
         external_account_id: string;
         name: string | null;
         currency: string | null;
+        username?: string | null;
+        avatar_url?: string | null;
+        profile_url?: string | null;
         instagram?: {
             external_account_id: string;
             name: string | null;
+            username?: string | null;
+            avatar_url?: string | null;
+            profile_url?: string | null;
         } | null;
     }>;
 }>, Error>;
@@ -256,8 +381,14 @@ 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";
+    kind: "posting" | "ads";
+    status: "pending" | "active" | "needs_reauth";
     external_account_id: string | null;
     external_account_name: string | null;
+    username: string | null;
+    avatar_url: string | null;
+    profile_url: string | null;
+    reauth_at: string | null;
     currency: string | null;
     created_at: string | null;
     updated_at: string | null;
@@ -287,7 +418,7 @@ interface MediaUploadOptions {
     raw?: boolean;
     altText?: string;
     externalId?: string;
-    metadata?: CreateMediaInput['metadata'];
+    metadata?: Metadata;
 }
 /**
  * Upload a file and get back a platform-validated asset. The hook owns the whole
@@ -306,11 +437,12 @@ declare function useMediaUpload(): {
         id: string;
         object: "media";
         profile_id: string;
-        kind: "image" | "video" | "gif" | "document";
+        kind: "image" | "video" | "gif" | "document" | null;
+        content_type: string | null;
         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";
+            code: "media_unprobeable" | "media_format_indeterminate" | "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" | "video_transform_failed" | "media_fetch_failed" | "document_format_unsupported" | "document_too_large" | "document_too_many_pages" | "media_unsupported";
             message: string;
             hint?: string;
             allowed?: Array<string>;
@@ -332,14 +464,14 @@ declare function useMediaUpload(): {
                 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";
+                    code: "media_unprobeable" | "media_format_indeterminate" | "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" | "video_transform_failed" | "media_fetch_failed" | "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";
+                    code: "media_unprobeable" | "media_format_indeterminate" | "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" | "video_transform_failed" | "media_fetch_failed" | "document_format_unsupported" | "document_too_large" | "document_too_many_pages" | "media_unsupported";
                     message: string;
                     hint?: string;
                     allowed?: Array<string>;
@@ -361,11 +493,12 @@ declare function useMedia(id: string): _tanstack_react_query.UseQueryResult<NoIn
     id: string;
     object: "media";
     profile_id: string;
-    kind: "image" | "video" | "gif" | "document";
+    kind: "image" | "video" | "gif" | "document" | null;
+    content_type: string | null;
     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";
+        code: "media_unprobeable" | "media_format_indeterminate" | "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" | "video_transform_failed" | "media_fetch_failed" | "document_format_unsupported" | "document_too_large" | "document_too_many_pages" | "media_unsupported";
         message: string;
         hint?: string;
         allowed?: Array<string>;
@@ -387,14 +520,14 @@ declare function useMedia(id: string): _tanstack_react_query.UseQueryResult<NoIn
             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";
+                code: "media_unprobeable" | "media_format_indeterminate" | "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" | "video_transform_failed" | "media_fetch_failed" | "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";
+                code: "media_unprobeable" | "media_format_indeterminate" | "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" | "video_transform_failed" | "media_fetch_failed" | "document_format_unsupported" | "document_too_large" | "document_too_many_pages" | "media_unsupported";
                 message: string;
                 hint?: string;
                 allowed?: Array<string>;
@@ -409,16 +542,143 @@ declare function useMedia(id: string): _tanstack_react_query.UseQueryResult<NoIn
     created_at: string;
     updated_at: string;
 }>, Error>;
+/**
+ * List media assets under the account, newest first. Filter by `profile_id`,
+ * `status`, `kind`, your own `external_id`, or `metadata` (exact-match
+ * containment), with offset `limit`/`offset` pagination. Returns one page; use
+ * `useMediaInfinite` for a load-more feed.
+ */
+declare function useMediaList(query?: ListMediaQuery): _tanstack_react_query.UseQueryResult<NoInfer<{
+    object: "list";
+    data: Array<{
+        id: string;
+        object: "media";
+        profile_id: string;
+        kind: "image" | "video" | "gif" | "document" | null;
+        content_type: string | null;
+        status: "uploading" | "processing" | "ready" | "failed";
+        raw: boolean;
+        error: {
+            code: "media_unprobeable" | "media_format_indeterminate" | "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" | "video_transform_failed" | "media_fetch_failed" | "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_format_indeterminate" | "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" | "video_transform_failed" | "media_fetch_failed" | "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_format_indeterminate" | "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" | "video_transform_failed" | "media_fetch_failed" | "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;
+    }>;
+    total: number;
+    limit: number;
+    offset: number;
+    has_more: boolean;
+}>, Error>;
+/**
+ * Load-more / infinite-scroll view over the media list — same filters as
+ * `useMediaList` minus pagination, which the helper drives. Returns
+ * `{ items, total, loadMore, hasMore, … }`.
+ */
+declare function useMediaInfinite(filters?: Omit<ListMediaQuery, 'limit' | 'offset'>, options?: {
+    pageSize?: number;
+}): InfiniteList<{
+    id: string;
+    object: "media";
+    profile_id: string;
+    kind: "image" | "video" | "gif" | "document" | null;
+    content_type: string | null;
+    status: "uploading" | "processing" | "ready" | "failed";
+    raw: boolean;
+    error: {
+        code: "media_unprobeable" | "media_format_indeterminate" | "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" | "video_transform_failed" | "media_fetch_failed" | "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_format_indeterminate" | "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" | "video_transform_failed" | "media_fetch_failed" | "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_format_indeterminate" | "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" | "video_transform_failed" | "media_fetch_failed" | "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;
+}>;
 /** 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";
+    kind: "image" | "video" | "gif" | "document" | null;
+    content_type: string | null;
     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";
+        code: "media_unprobeable" | "media_format_indeterminate" | "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" | "video_transform_failed" | "media_fetch_failed" | "document_format_unsupported" | "document_too_large" | "document_too_many_pages" | "media_unsupported";
         message: string;
         hint?: string;
         allowed?: Array<string>;
@@ -440,14 +700,14 @@ declare function useUpdateMedia(): _tanstack_react_query.UseMutationResult<{
             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";
+                code: "media_unprobeable" | "media_format_indeterminate" | "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" | "video_transform_failed" | "media_fetch_failed" | "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";
+                code: "media_unprobeable" | "media_format_indeterminate" | "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" | "video_transform_failed" | "media_fetch_failed" | "document_format_unsupported" | "document_too_large" | "document_too_many_pages" | "media_unsupported";
                 message: string;
                 hint?: string;
                 allowed?: Array<string>;
@@ -829,7 +1089,7 @@ declare function useCreatePost(profileId: string): {
     } | undefined;
     reset: () => void;
     isReady: boolean;
-    connectedChannels: ("x" | "linkedin" | "facebook_page" | "instagram")[];
+    connectedChannels: ("x" | "linkedin" | "facebook_page" | "tiktok" | "instagram")[];
 };
 /**
  * Update a post by id. Pass a light edit directly (`{ schedule_at }`,
@@ -1002,6 +1262,30 @@ declare function useUpdatePost(postId: string): _tanstack_react_query.UseMutatio
         settings?: {
             link?: string;
         };
+    } | {
+        platform: "tiktok";
+        post_type: "video" | "single_image" | "carousel";
+        connection_id: string;
+        body?: string;
+        media?: Array<{
+            media_id: string;
+            crop_box?: {
+                [key: string]: unknown;
+            } | null;
+            alt_text_override?: string | null;
+        }>;
+        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;
+        };
     }>;
 }, unknown>;
 /** Delete a post by id; on success the lists refresh and its detail is dropped. */
@@ -1011,81 +1295,6 @@ declare function useDeletePost(): _tanstack_react_query.UseMutationResult<{
     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
@@ -1234,4 +1443,4 @@ declare function LinkedInPostPreviewImpl({ variant, author, media, theme, time,
  * 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 };
+export { type CalendarFilters, type ConnectParams, type ConnectionsFilter, 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, useMediaInfinite, useMediaList, useMediaUpload, usePost, usePostrun, usePosts, usePostsInfinite, useProfile, useProfiles, useProfilesInfinite, useSelectAccount, useUpdateMedia, useUpdatePost, useUpdateProfile };