@getlatedev/node 0.1.55 → 0.1.57

package/src/generated/types.gen.ts

@@ -88,6 +88,10 @@ export type AnalyticsListResponse = {
     overview?: AnalyticsOverview;
     posts?: Array<{
         _id?: string;
+        /**
+         * Original Late post ID if scheduled via Late
+         */
+        latePostId?: (string) | null;
         content?: string;
         scheduledFor?: string;
         publishedAt?: string;
@@ -97,6 +101,7 @@ export type AnalyticsListResponse = {
         platform?: string;
         platformPostUrl?: string;
         isExternal?: boolean;
+        profileId?: (string) | null;
         thumbnailUrl?: string;
         mediaType?: 'image' | 'video' | 'gif' | 'document' | 'carousel' | 'text';
         /**
@@ -129,20 +134,45 @@ export type AnalyticsOverview = {
     totalPosts?: number;
     publishedPosts?: number;
     scheduledPosts?: number;
-    lastSync?: string;
+    lastSync?: (string) | null;
+    dataStaleness?: {
+        /**
+         * Number of accounts with stale analytics data
+         */
+        staleAccountCount?: number;
+        /**
+         * Whether a background sync was triggered for stale accounts
+         */
+        syncTriggered?: boolean;
+    };
 };
 
 export type AnalyticsSinglePostResponse = {
     postId?: string;
-    status?: string;
+    /**
+     * Original Late post ID if scheduled via Late
+     */
+    latePostId?: (string) | null;
+    /**
+     * Overall post status. "partial" when some platforms published and others failed.
+     */
+    status?: 'published' | 'failed' | 'partial';
     content?: string;
     scheduledFor?: string;
-    publishedAt?: string;
+    publishedAt?: (string) | null;
     analytics?: PostAnalytics;
     platformAnalytics?: Array<PlatformAnalytics>;
     platform?: string;
-    platformPostUrl?: string;
+    platformPostUrl?: (string) | null;
     isExternal?: boolean;
+    /**
+     * Overall sync state across all platforms
+     */
+    syncStatus?: 'synced' | 'pending' | 'partial' | 'unavailable';
+    /**
+     * Human-readable status message for pending, partial, or failed states
+     */
+    message?: (string) | null;
     thumbnailUrl?: (string) | null;
     mediaType?: ('image' | 'video' | 'carousel' | 'text') | null;
     /**
@@ -161,6 +191,16 @@ export type AnalyticsSinglePostResponse = {
     }>;
 };
 
+/**
+ * Overall post status. "partial" when some platforms published and others failed.
+ */
+export type status = 'published' | 'failed' | 'partial';
+
+/**
+ * Overall sync state across all platforms
+ */
+export type syncStatus = 'synced' | 'pending' | 'partial' | 'unavailable';
+
 export type mediaType = 'image' | 'video' | 'carousel' | 'text';
 
 export type ApiKey = {
@@ -491,7 +531,7 @@ export type HashtagInfo = {
     postCount?: number;
 };
 
-export type status = 'safe' | 'banned' | 'restricted' | 'unknown';
+export type status2 = 'safe' | 'banned' | 'restricted' | 'unknown';
 
 /**
  * Feed aspect ratio 0.8-1.91, carousels up to 10 items, stories require media (no captions). User tag coordinates 0.0-1.0 from top-left. Images over 8 MB and videos over platform limits are auto-compressed.
@@ -675,7 +715,7 @@ export type LinkedInPlatformData = {
 };
 
 /**
- * Media referenced in posts. URLs must be publicly reachable over HTTPS. Use POST /v1/media/presign for uploads up to 5GB. Late auto-compresses images and videos that exceed platform limits (videos over 200 MB may not be compressed).
+ * Media referenced in posts. URLs must be publicly reachable over HTTPS. Use POST /v1/media/presign for uploads up to 5GB. Zernio auto-compresses images and videos that exceed platform limits (videos over 200 MB may not be compressed).
  */
 export type MediaItem = {
     type?: 'image' | 'video' | 'gif' | 'document';
@@ -770,23 +810,28 @@ export type PinterestPlatformData = {
 
 export type PlatformAnalytics = {
     platform?: string;
-    status?: string;
+    status?: 'published' | 'failed';
     accountId?: string;
-    accountUsername?: string;
-    analytics?: PostAnalytics;
-    accountMetrics?: {
-        /**
-         * Followers/fans count (e.g., Instagram, Facebook Pages, Twitter)
-         */
-        followers?: (number) | null;
-        /**
-         * Subscribers count (e.g., YouTube)
-         */
-        subscribers?: (number) | null;
-        lastUpdated?: (string) | null;
-    } | null;
+    accountUsername?: (string) | null;
+    analytics?: (PostAnalytics) | null;
+    /**
+     * Sync state of analytics for this platform
+     */
+    syncStatus?: 'synced' | 'pending' | 'unavailable';
+    platformPostUrl?: (string) | null;
+    /**
+     * Error details when status is failed
+     */
+    errorMessage?: (string) | null;
 };
 
+export type status3 = 'published' | 'failed';
+
+/**
+ * Sync state of analytics for this platform
+ */
+export type syncStatus2 = 'synced' | 'pending' | 'unavailable';
+
 export type PlatformTarget = {
     /**
      * Supported values: twitter, threads, instagram, youtube, facebook, linkedin, pinterest, reddit, tiktok, bluesky, googlebusiness, telegram
@@ -827,22 +872,22 @@ export type PlatformTarget = {
      */
     errorMessage?: string;
     /**
-     * Error category for programmatic handling: auth_expired (token expired/revoked), user_content (wrong format/too long), user_abuse (rate limits/spam), account_issue (config problems), platform_rejected (policy violation), platform_error (5xx/maintenance), system_error (Late infra), unknown
+     * Error category for programmatic handling: auth_expired (token expired/revoked), user_content (wrong format/too long), user_abuse (rate limits/spam), account_issue (config problems), platform_rejected (policy violation), platform_error (5xx/maintenance), system_error (Zernio infra), unknown
      */
     errorCategory?: 'auth_expired' | 'user_content' | 'user_abuse' | 'account_issue' | 'platform_rejected' | 'platform_error' | 'system_error' | 'unknown';
     /**
-     * Who caused the error: user (fix content/reconnect), platform (outage/API change), system (Late issue, rare)
+     * Who caused the error: user (fix content/reconnect), platform (outage/API change), system (Zernio issue, rare)
      */
     errorSource?: 'user' | 'platform' | 'system';
 };
 
 /**
- * Error category for programmatic handling: auth_expired (token expired/revoked), user_content (wrong format/too long), user_abuse (rate limits/spam), account_issue (config problems), platform_rejected (policy violation), platform_error (5xx/maintenance), system_error (Late infra), unknown
+ * Error category for programmatic handling: auth_expired (token expired/revoked), user_content (wrong format/too long), user_abuse (rate limits/spam), account_issue (config problems), platform_rejected (policy violation), platform_error (5xx/maintenance), system_error (Zernio infra), unknown
  */
 export type errorCategory = 'auth_expired' | 'user_content' | 'user_abuse' | 'account_issue' | 'platform_rejected' | 'platform_error' | 'system_error' | 'unknown';
 
 /**
- * Who caused the error: user (fix content/reconnect), platform (outage/API change), system (Late issue, rare)
+ * Who caused the error: user (fix content/reconnect), platform (outage/API change), system (Zernio issue, rare)
  */
 export type errorSource = 'user' | 'platform' | 'system';
 
@@ -887,7 +932,7 @@ export type Post = {
     updatedAt?: string;
 };
 
-export type status2 = 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed' | 'partial';
+export type status4 = 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed' | 'partial';
 
 export type visibility = 'public' | 'private' | 'unlisted';
 
@@ -1003,7 +1048,7 @@ export type PostLog = {
  */
 export type action = 'publish' | 'retry' | 'media_upload' | 'rate_limit_pause' | 'token_refresh' | 'cancelled';
 
-export type status3 = 'success' | 'failed' | 'pending' | 'skipped';
+export type status5 = 'success' | 'failed' | 'pending' | 'skipped';
 
 export type PostRetryResponse = {
     message?: string;
@@ -1453,7 +1498,7 @@ export type UploadTokenResponse = {
     status?: 'pending' | 'completed' | 'expired';
 };
 
-export type status4 = 'pending' | 'completed' | 'expired';
+export type status6 = 'pending' | 'completed' | 'expired';
 
 export type UploadTokenStatusResponse = {
     token?: string;
@@ -1592,7 +1637,7 @@ export type WebhookLog = {
 
 export type event = 'post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.recycled' | 'account.connected' | 'account.disconnected' | 'message.received' | 'comment.received' | 'webhook.test';
 
-export type status5 = 'success' | 'failed';
+export type status7 = 'success' | 'failed';
 
 /**
  * Webhook payload for account connected events
@@ -1838,7 +1883,7 @@ export type platform3 = 'instagram' | 'facebook' | 'telegram' | 'bluesky' | 'red
 
 export type direction = 'incoming';
 
-export type status6 = 'active' | 'archived';
+export type status8 = 'active' | 'archived';
 
 /**
  * Webhook payload for post events
@@ -2310,7 +2355,7 @@ export type ValidateSubredditError = unknown;
 export type GetAnalyticsData = {
     query?: {
         /**
-         * Inclusive lower bound
+         * Inclusive lower bound (YYYY-MM-DD). Defaults to 90 days ago if omitted. Max range is 366 days.
          */
         fromDate?: string;
         /**
@@ -2330,7 +2375,7 @@ export type GetAnalyticsData = {
          */
         platform?: string;
         /**
-         * Returns analytics for a single post. Accepts both Late Post IDs and External Post IDs. Late IDs are auto-resolved to External Post analytics.
+         * Returns analytics for a single post. Accepts both Zernio Post IDs and External Post IDs. Zernio IDs are auto-resolved to External Post analytics.
          */
         postId?: string;
         /**
@@ -2338,33 +2383,41 @@ export type GetAnalyticsData = {
          */
         profileId?: string;
         /**
-         * Sort by date or engagement
+         * Sort by date, engagement, or a specific metric
          */
-        sortBy?: 'date' | 'engagement';
+        sortBy?: 'date' | 'engagement' | 'impressions' | 'reach' | 'likes' | 'comments' | 'shares' | 'saves' | 'clicks' | 'views';
         /**
-         * Filter by post source: late (posted via Late API), external (synced from platform), all (default)
+         * Filter by post source: late (posted via Zernio API), external (synced from platform), all (default)
          */
         source?: 'all' | 'late' | 'external';
         /**
-         * Inclusive upper bound
+         * Inclusive upper bound (YYYY-MM-DD). Defaults to today if omitted.
          */
         toDate?: string;
     };
 };
 
-export type GetAnalyticsResponse = ((AnalyticsSinglePostResponse | AnalyticsListResponse));
+export type GetAnalyticsResponse = ((AnalyticsSinglePostResponse | AnalyticsListResponse) | AnalyticsSinglePostResponse);
 
 export type GetAnalyticsError = ({
     error?: string;
+    /**
+     * Detailed validation errors
+     */
+    details?: {
+        [key: string]: unknown;
+    };
+} | {
+    error?: string;
 } | {
     error?: string;
     code?: string;
-} | ErrorResponse);
+} | AnalyticsSinglePostResponse | ErrorResponse);
 
 export type GetYouTubeDailyViewsData = {
     query: {
         /**
-         * The Late account ID for the YouTube account
+         * The Zernio account ID for the YouTube account
          */
         accountId: string;
         /**
@@ -2409,7 +2462,7 @@ export type GetDailyMetricsData = {
          */
         profileId?: string;
         /**
-         * Filter by post origin. "late" for posts published via Late, "external" for posts imported from platforms.
+         * Filter by post origin. "late" for posts published via Zernio, "external" for posts imported from platforms.
          */
         source?: 'all' | 'late' | 'external';
         /**
@@ -2469,7 +2522,7 @@ export type GetBestTimeToPostData = {
          */
         profileId?: string;
         /**
-         * Filter by post origin. "late" for posts published via Late, "external" for posts imported from platforms.
+         * Filter by post origin. "late" for posts published via Zernio, "external" for posts imported from platforms.
          */
         source?: 'all' | 'late' | 'external';
     };
@@ -2514,7 +2567,7 @@ export type GetContentDecayData = {
          */
         profileId?: string;
         /**
-         * Filter by post origin. "late" for posts published via Late, "external" for posts imported from platforms.
+         * Filter by post origin. "late" for posts published via Zernio, "external" for posts imported from platforms.
          */
         source?: 'all' | 'late' | 'external';
     };
@@ -2559,7 +2612,7 @@ export type GetPostingFrequencyData = {
          */
         profileId?: string;
         /**
-         * Filter by post origin. "late" for posts published via Late, "external" for posts imported from platforms.
+         * Filter by post origin. "late" for posts published via Zernio, "external" for posts imported from platforms.
          */
         source?: 'all' | 'late' | 'external';
     };
@@ -2601,7 +2654,7 @@ export type GetPostTimelineData = {
          */
         fromDate?: string;
         /**
-         * The post to fetch timeline for. Accepts an ExternalPost ID, a platformPostId, or a Late Post ID.
+         * The post to fetch timeline for. Accepts an ExternalPost ID, a platformPostId, or a Zernio Post ID.
          *
          */
         postId: string;
@@ -3512,11 +3565,11 @@ export type GetConnectUrlData = {
     };
     query: {
         /**
-         * When true, the user is redirected to your redirect_url with raw OAuth data (code, state) instead of Late's default account selection UI. Use this to build a custom connect experience.
+         * When true, the user is redirected to your redirect_url with raw OAuth data (code, state) instead of Zernio's default account selection UI. Use this to build a custom connect experience.
          */
         headless?: boolean;
         /**
-         * Your Late profile ID (get from /v1/profiles)
+         * Your Zernio profile ID (get from /v1/profiles)
          */
         profileId: string;
         /**
@@ -3770,7 +3823,7 @@ export type SelectGoogleBusinessLocationError = (unknown | {
 export type GetGoogleBusinessReviewsData = {
     path: {
         /**
-         * The Late account ID (from /v1/accounts)
+         * The Zernio account ID (from /v1/accounts)
          */
         accountId: string;
     };
@@ -3851,7 +3904,7 @@ export type GetGoogleBusinessReviewsError = (ErrorResponse | {
 export type GetGoogleBusinessFoodMenusData = {
     path: {
         /**
-         * The Late account ID (from /v1/accounts)
+         * The Zernio account ID (from /v1/accounts)
          */
         accountId: string;
     };
@@ -3891,7 +3944,7 @@ export type UpdateGoogleBusinessFoodMenusData = {
     };
     path: {
         /**
-         * The Late account ID (from /v1/accounts)
+         * The Zernio account ID (from /v1/accounts)
          */
         accountId: string;
     };
@@ -3918,7 +3971,7 @@ export type UpdateGoogleBusinessFoodMenusError = (ErrorResponse | {
 export type GetGoogleBusinessLocationDetailsData = {
     path: {
         /**
-         * The Late account ID (from /v1/accounts)
+         * The Zernio account ID (from /v1/accounts)
          */
         accountId: string;
     };
@@ -4140,7 +4193,7 @@ export type UpdateGoogleBusinessLocationDetailsData = {
     };
     path: {
         /**
-         * The Late account ID (from /v1/accounts)
+         * The Zernio account ID (from /v1/accounts)
          */
         accountId: string;
     };
@@ -4451,7 +4504,7 @@ export type GetPendingOAuthDataResponse = ({
      */
     platform?: string;
     /**
-     * The Late profile ID
+     * The Zernio profile ID
      */
     profileId?: string;
     /**
@@ -4587,7 +4640,7 @@ export type ListPinterestBoardsForSelectionData = {
     };
     query: {
         /**
-         * Your Late profile ID
+         * Your Zernio profile ID
          */
         profileId: string;
         /**
@@ -4625,7 +4678,7 @@ export type ListPinterestBoardsForSelectionError = (unknown | {
 export type SelectPinterestBoardData = {
     body: {
         /**
-         * Your Late profile ID
+         * Your Zernio profile ID
          */
         profileId: string;
         /**
@@ -4694,7 +4747,7 @@ export type ListSnapchatProfilesData = {
     };
     query: {
         /**
-         * Your Late profile ID
+         * Your Zernio profile ID
          */
         profileId: string;
         /**
@@ -4736,7 +4789,7 @@ export type ListSnapchatProfilesError = (unknown | {
 export type SelectSnapchatProfileData = {
     body: {
         /**
-         * Your Late profile ID
+         * Your Zernio profile ID
          */
         profileId: string;
         /**
@@ -6661,7 +6714,7 @@ export type ListInboxCommentsError = ({
 export type GetInboxPostCommentsData = {
     path: {
         /**
-         * Late post ID or platform-specific post ID. Late IDs are auto-resolved. LinkedIn third-party posts accept full activity URN or numeric ID.
+         * Zernio post ID or platform-specific post ID. Zernio IDs are auto-resolved. LinkedIn third-party posts accept full activity URN or numeric ID.
          */
         postId: string;
     };
@@ -6794,7 +6847,7 @@ export type ReplyToInboxPostData = {
     };
     path: {
         /**
-         * Late post ID or platform-specific post ID. LinkedIn third-party posts accept full activity URN or numeric ID.
+         * Zernio post ID or platform-specific post ID. LinkedIn third-party posts accept full activity URN or numeric ID.
          */
         postId: string;
     };
@@ -6819,7 +6872,7 @@ export type ReplyToInboxPostError = ({
 export type DeleteInboxCommentData = {
     path: {
         /**
-         * Late post ID or platform-specific post ID. LinkedIn third-party posts accept full activity URN or numeric ID.
+         * Zernio post ID or platform-specific post ID. LinkedIn third-party posts accept full activity URN or numeric ID.
          */
         postId: string;
     };