@dracoonghost/trndup-sdk 1.3.20 → 1.3.22

package/dist/index.d.mts

@@ -487,6 +487,62 @@ declare namespace Instagram {
             value: number;
         }>>;
     }
+    interface ProfileResponse {
+        id: string;
+        username: string;
+        name?: string;
+        biography?: string;
+        profilePictureUrl?: string;
+        followersCount: number;
+        followingCount: number;
+        mediaCount: number;
+        accountType?: 'BUSINESS' | 'CREATOR' | 'PERSONAL';
+        website?: string;
+        cached?: boolean;
+        cachedAt?: string;
+    }
+    interface GetAccountOverviewParams {
+        range?: '7d' | '14d' | '28d' | '30d';
+    }
+    interface AccountOverviewResponse {
+        profile: {
+            id: string;
+            username: string;
+            name?: string;
+            biography?: string;
+            profilePictureUrl?: string;
+            followersCount: number;
+            followingCount: number;
+            mediaCount: number;
+            accountType?: string;
+            website?: string;
+        };
+        stats: {
+            range: string;
+            reach: number;
+            impressions: number;
+            profileViews: number;
+            websiteClicks: number;
+            totalLikes: number;
+            totalComments: number;
+            totalShares: number;
+            totalSaves: number;
+            engagementRate: number;
+            accountsEngaged: number;
+        };
+        topPosts: Array<{
+            id: string;
+            mediaType: string;
+            mediaUrl?: string;
+            thumbnailUrl?: string;
+            caption?: string;
+            likeCount?: number;
+            commentsCount?: number;
+            timestamp?: string;
+            permalink?: string;
+        }>;
+        syncedMediaCount: number;
+    }
     interface Post {
         id: string;
         media_id: string;
@@ -539,6 +595,110 @@ declare namespace Instagram {
         stories: Story[];
         count: number;
     }
+    /** Sync status enum matching backend */
+    type SyncStatus = 'NEVER_SYNCED' | 'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED';
+    /** Individual sync type info */
+    interface SyncTypeInfo {
+        status: SyncStatus;
+        lastSyncAt: string | null;
+        lastError?: string | null;
+        failedAttempts?: number;
+        isStale: boolean;
+        nextSyncAt: string | null;
+        timeUntilNextSync: string;
+        interval: string;
+    }
+    /**
+     * Unified sync status response
+     * GET /v1/platforms/instagram/sync/status
+     */
+    interface UnifiedSyncStatusResponse {
+        isConnected: boolean;
+        igUserId: string | null;
+        username: string | null;
+        totalPosts: number;
+        syncs: {
+            accountInfo: SyncTypeInfo;
+            posts: SyncTypeInfo;
+            accountAnalytics: SyncTypeInfo;
+            postInsights: SyncTypeInfo;
+            stories: SyncTypeInfo;
+        };
+    }
+    /**
+     * Response from POST /v1/platforms/instagram/posts/sync
+     */
+    interface PostsSyncResponse {
+        posts: {
+            total: number;
+            synced: number;
+            oldestPostDate: string | null;
+        };
+        syncStatus: {
+            isFirstSync: boolean;
+            lastSyncAt: string;
+        };
+    }
+    /**
+     * Response from GET /v1/platforms/instagram/posts/sync/status
+     */
+    interface PostsSyncStatusResponse {
+        needsSync: boolean;
+        status: SyncStatus;
+        lastSyncAt: string | null;
+        postCount: number;
+        oldestPostDate: string | null;
+    }
+    /**
+     * Response from POST /v1/platforms/instagram/analytics/account/sync
+     */
+    interface AccountAnalyticsSyncResponse {
+        range: string;
+        metricsCount: number;
+        syncStatus: SyncStatus;
+        lastSyncAt: string;
+    }
+    /**
+     * Response from GET /v1/platforms/instagram/analytics/account/sync/status
+     */
+    interface AccountAnalyticsSyncStatusResponse {
+        needsSync: boolean;
+        status: SyncStatus;
+        insightRecords: number;
+        dateRange: {
+            start: string;
+            end: string;
+        } | null;
+        lastSyncAt: string | null;
+        message: string;
+    }
+    /**
+     * Response from POST /v1/platforms/instagram/analytics/posts/sync
+     */
+    interface PostInsightsSyncResponse {
+        totalPosts: number;
+        postsWithInsights: number;
+        errorCount: number;
+        syncStatus: SyncStatus;
+        lastSyncAt: string;
+    }
+    /**
+     * Response from GET /v1/platforms/instagram/analytics/posts/sync/status
+     */
+    interface PostInsightsSyncStatusResponse {
+        needsSync: boolean;
+        status: SyncStatus;
+        totalPosts: number;
+        postsWithInsights: number;
+        coverage: number;
+        lastSyncAt: string | null;
+        metadata?: {
+            postsWithInsights?: number;
+            totalPosts?: number;
+            lastCheckedAt?: string;
+        } | null;
+        message: string;
+    }
     interface SyncResponse {
         message: string;
         profile?: {
@@ -1594,23 +1754,75 @@ declare class YouTubeModule {
  * TrndUp SDK - Instagram Module
  *
  * Instagram analytics and data methods
+ * Route structure mirrors YouTube for UI consistency
  */
 
 declare class InstagramModule {
     private client;
     constructor(client: TrndUpClient);
     /**
-     * Get Instagram initialization status
-     * GET /v1/platforms/instagram/status/init
+     * Get unified sync status for all Instagram data types
+     * GET /v1/platforms/instagram/sync/status
+     *
+     * Shows when each type was last synced and when next sync is due.
      */
-    getInitStatus(): Promise<Instagram.InitStatusResponse>;
+    getSyncStatus(): Promise<Instagram.UnifiedSyncStatusResponse>;
     /**
      * Initialize Instagram data sync
-     * GET /v1/platforms/instagram/init
+     * POST /v1/platforms/instagram/init
      */
     initialize(): Promise<Instagram.InitResponse>;
     /**
-     * Get account-level insights
+     * Get Instagram initialization status
+     * GET /v1/platforms/instagram/init/status
+     */
+    getInitStatus(): Promise<Instagram.InitStatusResponse>;
+    /**
+     * Sync all posts from Instagram to database
+     * POST /v1/platforms/instagram/posts/sync
+     */
+    syncPosts(): Promise<Instagram.PostsSyncResponse>;
+    /**
+     * Check posts sync status without triggering a sync
+     * GET /v1/platforms/instagram/posts/sync/status
+     */
+    getPostsSyncStatus(): Promise<Instagram.PostsSyncStatusResponse>;
+    /**
+     * Sync account-level analytics (reach, impressions, engagement)
+     * POST /v1/platforms/instagram/analytics/account/sync
+     * @param range Time range: '7d', '14d', '30d' (default '30d')
+     */
+    syncAccountAnalytics(params?: {
+        range?: string;
+    }): Promise<Instagram.AccountAnalyticsSyncResponse>;
+    /**
+     * Get account analytics sync status
+     * GET /v1/platforms/instagram/analytics/account/sync/status
+     */
+    getAccountAnalyticsSyncStatus(): Promise<Instagram.AccountAnalyticsSyncStatusResponse>;
+    /**
+     * Sync post-level insights for all posts
+     * POST /v1/platforms/instagram/analytics/posts/sync
+     */
+    syncPostInsights(): Promise<Instagram.PostInsightsSyncResponse>;
+    /**
+     * Get post insights sync status
+     * GET /v1/platforms/instagram/analytics/posts/sync/status
+     */
+    getPostInsightsSyncStatus(): Promise<Instagram.PostInsightsSyncStatusResponse>;
+    /**
+     * Get user profile info
+     * GET /v1/platforms/instagram/profile
+     */
+    getProfile(): Promise<Instagram.ProfileResponse>;
+    /**
+     * Get account overview for dashboard
+     * GET /v1/platforms/instagram/account/overview
+     * @param range Time range: '7d', '14d', '28d', '30d'
+     */
+    getAccountOverview(params?: Instagram.GetAccountOverviewParams): Promise<Instagram.AccountOverviewResponse>;
+    /**
+     * Get account-level insights (historical data)
      * GET /v1/platforms/instagram/account/insights
      * @param range Time range: '7d', '14d', '28d', '30d'
      */
@@ -1631,18 +1843,11 @@ declare class InstagramModule {
      */
     getStories(): Promise<Instagram.StoriesResponse>;
     /**
-     * Trigger manual data sync
+     * Trigger manual data sync (legacy - use specific sync methods)
      * POST /v1/platforms/instagram/sync
+     * @deprecated Use syncPosts, syncAccountAnalytics, syncPostInsights instead
      */
     sync(): Promise<Instagram.SyncResponse>;
-    /**
-     * @deprecated Use getAccountInsights instead
-     */
-    getAccountMetrics(): Promise<Instagram.AccountInsightsResponse>;
-    /**
-     * @deprecated Use sync instead
-     */
-    refresh(): Promise<Instagram.SyncResponse>;
 }
 
 /**

package/dist/index.d.ts

@@ -487,6 +487,62 @@ declare namespace Instagram {
             value: number;
         }>>;
     }
+    interface ProfileResponse {
+        id: string;
+        username: string;
+        name?: string;
+        biography?: string;
+        profilePictureUrl?: string;
+        followersCount: number;
+        followingCount: number;
+        mediaCount: number;
+        accountType?: 'BUSINESS' | 'CREATOR' | 'PERSONAL';
+        website?: string;
+        cached?: boolean;
+        cachedAt?: string;
+    }
+    interface GetAccountOverviewParams {
+        range?: '7d' | '14d' | '28d' | '30d';
+    }
+    interface AccountOverviewResponse {
+        profile: {
+            id: string;
+            username: string;
+            name?: string;
+            biography?: string;
+            profilePictureUrl?: string;
+            followersCount: number;
+            followingCount: number;
+            mediaCount: number;
+            accountType?: string;
+            website?: string;
+        };
+        stats: {
+            range: string;
+            reach: number;
+            impressions: number;
+            profileViews: number;
+            websiteClicks: number;
+            totalLikes: number;
+            totalComments: number;
+            totalShares: number;
+            totalSaves: number;
+            engagementRate: number;
+            accountsEngaged: number;
+        };
+        topPosts: Array<{
+            id: string;
+            mediaType: string;
+            mediaUrl?: string;
+            thumbnailUrl?: string;
+            caption?: string;
+            likeCount?: number;
+            commentsCount?: number;
+            timestamp?: string;
+            permalink?: string;
+        }>;
+        syncedMediaCount: number;
+    }
     interface Post {
         id: string;
         media_id: string;
@@ -539,6 +595,110 @@ declare namespace Instagram {
         stories: Story[];
         count: number;
     }
+    /** Sync status enum matching backend */
+    type SyncStatus = 'NEVER_SYNCED' | 'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED';
+    /** Individual sync type info */
+    interface SyncTypeInfo {
+        status: SyncStatus;
+        lastSyncAt: string | null;
+        lastError?: string | null;
+        failedAttempts?: number;
+        isStale: boolean;
+        nextSyncAt: string | null;
+        timeUntilNextSync: string;
+        interval: string;
+    }
+    /**
+     * Unified sync status response
+     * GET /v1/platforms/instagram/sync/status
+     */
+    interface UnifiedSyncStatusResponse {
+        isConnected: boolean;
+        igUserId: string | null;
+        username: string | null;
+        totalPosts: number;
+        syncs: {
+            accountInfo: SyncTypeInfo;
+            posts: SyncTypeInfo;
+            accountAnalytics: SyncTypeInfo;
+            postInsights: SyncTypeInfo;
+            stories: SyncTypeInfo;
+        };
+    }
+    /**
+     * Response from POST /v1/platforms/instagram/posts/sync
+     */
+    interface PostsSyncResponse {
+        posts: {
+            total: number;
+            synced: number;
+            oldestPostDate: string | null;
+        };
+        syncStatus: {
+            isFirstSync: boolean;
+            lastSyncAt: string;
+        };
+    }
+    /**
+     * Response from GET /v1/platforms/instagram/posts/sync/status
+     */
+    interface PostsSyncStatusResponse {
+        needsSync: boolean;
+        status: SyncStatus;
+        lastSyncAt: string | null;
+        postCount: number;
+        oldestPostDate: string | null;
+    }
+    /**
+     * Response from POST /v1/platforms/instagram/analytics/account/sync
+     */
+    interface AccountAnalyticsSyncResponse {
+        range: string;
+        metricsCount: number;
+        syncStatus: SyncStatus;
+        lastSyncAt: string;
+    }
+    /**
+     * Response from GET /v1/platforms/instagram/analytics/account/sync/status
+     */
+    interface AccountAnalyticsSyncStatusResponse {
+        needsSync: boolean;
+        status: SyncStatus;
+        insightRecords: number;
+        dateRange: {
+            start: string;
+            end: string;
+        } | null;
+        lastSyncAt: string | null;
+        message: string;
+    }
+    /**
+     * Response from POST /v1/platforms/instagram/analytics/posts/sync
+     */
+    interface PostInsightsSyncResponse {
+        totalPosts: number;
+        postsWithInsights: number;
+        errorCount: number;
+        syncStatus: SyncStatus;
+        lastSyncAt: string;
+    }
+    /**
+     * Response from GET /v1/platforms/instagram/analytics/posts/sync/status
+     */
+    interface PostInsightsSyncStatusResponse {
+        needsSync: boolean;
+        status: SyncStatus;
+        totalPosts: number;
+        postsWithInsights: number;
+        coverage: number;
+        lastSyncAt: string | null;
+        metadata?: {
+            postsWithInsights?: number;
+            totalPosts?: number;
+            lastCheckedAt?: string;
+        } | null;
+        message: string;
+    }
     interface SyncResponse {
         message: string;
         profile?: {
@@ -1594,23 +1754,75 @@ declare class YouTubeModule {
  * TrndUp SDK - Instagram Module
  *
  * Instagram analytics and data methods
+ * Route structure mirrors YouTube for UI consistency
  */
 
 declare class InstagramModule {
     private client;
     constructor(client: TrndUpClient);
     /**
-     * Get Instagram initialization status
-     * GET /v1/platforms/instagram/status/init
+     * Get unified sync status for all Instagram data types
+     * GET /v1/platforms/instagram/sync/status
+     *
+     * Shows when each type was last synced and when next sync is due.
      */
-    getInitStatus(): Promise<Instagram.InitStatusResponse>;
+    getSyncStatus(): Promise<Instagram.UnifiedSyncStatusResponse>;
     /**
      * Initialize Instagram data sync
-     * GET /v1/platforms/instagram/init
+     * POST /v1/platforms/instagram/init
      */
     initialize(): Promise<Instagram.InitResponse>;
     /**
-     * Get account-level insights
+     * Get Instagram initialization status
+     * GET /v1/platforms/instagram/init/status
+     */
+    getInitStatus(): Promise<Instagram.InitStatusResponse>;
+    /**
+     * Sync all posts from Instagram to database
+     * POST /v1/platforms/instagram/posts/sync
+     */
+    syncPosts(): Promise<Instagram.PostsSyncResponse>;
+    /**
+     * Check posts sync status without triggering a sync
+     * GET /v1/platforms/instagram/posts/sync/status
+     */
+    getPostsSyncStatus(): Promise<Instagram.PostsSyncStatusResponse>;
+    /**
+     * Sync account-level analytics (reach, impressions, engagement)
+     * POST /v1/platforms/instagram/analytics/account/sync
+     * @param range Time range: '7d', '14d', '30d' (default '30d')
+     */
+    syncAccountAnalytics(params?: {
+        range?: string;
+    }): Promise<Instagram.AccountAnalyticsSyncResponse>;
+    /**
+     * Get account analytics sync status
+     * GET /v1/platforms/instagram/analytics/account/sync/status
+     */
+    getAccountAnalyticsSyncStatus(): Promise<Instagram.AccountAnalyticsSyncStatusResponse>;
+    /**
+     * Sync post-level insights for all posts
+     * POST /v1/platforms/instagram/analytics/posts/sync
+     */
+    syncPostInsights(): Promise<Instagram.PostInsightsSyncResponse>;
+    /**
+     * Get post insights sync status
+     * GET /v1/platforms/instagram/analytics/posts/sync/status
+     */
+    getPostInsightsSyncStatus(): Promise<Instagram.PostInsightsSyncStatusResponse>;
+    /**
+     * Get user profile info
+     * GET /v1/platforms/instagram/profile
+     */
+    getProfile(): Promise<Instagram.ProfileResponse>;
+    /**
+     * Get account overview for dashboard
+     * GET /v1/platforms/instagram/account/overview
+     * @param range Time range: '7d', '14d', '28d', '30d'
+     */
+    getAccountOverview(params?: Instagram.GetAccountOverviewParams): Promise<Instagram.AccountOverviewResponse>;
+    /**
+     * Get account-level insights (historical data)
      * GET /v1/platforms/instagram/account/insights
      * @param range Time range: '7d', '14d', '28d', '30d'
      */
@@ -1631,18 +1843,11 @@ declare class InstagramModule {
      */
     getStories(): Promise<Instagram.StoriesResponse>;
     /**
-     * Trigger manual data sync
+     * Trigger manual data sync (legacy - use specific sync methods)
      * POST /v1/platforms/instagram/sync
+     * @deprecated Use syncPosts, syncAccountAnalytics, syncPostInsights instead
      */
     sync(): Promise<Instagram.SyncResponse>;
-    /**
-     * @deprecated Use getAccountInsights instead
-     */
-    getAccountMetrics(): Promise<Instagram.AccountInsightsResponse>;
-    /**
-     * @deprecated Use sync instead
-     */
-    refresh(): Promise<Instagram.SyncResponse>;
 }
 
 /**