@dracoonghost/trndup-sdk 1.3.23 → 1.3.25

package/dist/index.d.mts

@@ -703,15 +703,39 @@ declare namespace Instagram {
     interface PostInsightsSyncStatusResponse {
         needsSync: boolean;
         status: SyncStatus;
+        /** Progress tracking - primary fields for UI */
+        progress: {
+            /** Number of posts that have been processed (attempted insights sync) */
+            completed: number;
+            /** Total number of posts */
+            total: number;
+            /** Posts remaining to be processed */
+            remaining: number;
+            /** Percentage complete (0-100) */
+            percent: number;
+        };
+        /** Total number of posts */
         totalPosts: number;
+        /** Posts that have been processed (may or may not have insights) */
+        postsProcessed: number;
+        /** Posts that actually have insights data */
         postsWithInsights: number;
+        /** Percentage of posts with insights (0-100) */
         coverage: number;
         lastSyncAt: string | null;
         metadata?: {
+            postsProcessed?: number;
             postsWithInsights?: number;
             totalPosts?: number;
             lastCheckedAt?: string;
         } | null;
+        /** Queue processing info */
+        queue: {
+            isProcessing: boolean;
+            jobsActive: number;
+            jobsWaiting: number;
+            jobsFailed: number;
+        };
         message: string;
     }
     interface SyncResponse {
@@ -1377,6 +1401,259 @@ declare namespace Insights {
         /** Days per comparison period (14-90, default: 30) */
         period?: number;
     }
+    interface TopPostData {
+        mediaId: string;
+        caption: string | null;
+        mediaType: 'IMAGE' | 'VIDEO' | 'CAROUSEL_ALBUM' | 'REELS';
+        thumbnailUrl: string | null;
+        permalink: string;
+        postedAt: string;
+        ageInDays: number;
+    }
+    interface TopPostMetrics {
+        reach: number;
+        views: number;
+        likes: number;
+        comments: number;
+        shares: number;
+        saves: number;
+        engagementRate: number;
+    }
+    interface TopPostComparison {
+        vsAccountAverage: {
+            reach: number;
+            engagement: number;
+            description: string;
+        };
+        standoutReasons: string[];
+    }
+    interface BestPerformingPostData {
+        period: {
+            start: string;
+            end: string;
+            days: number;
+        };
+        topPost: TopPostData;
+        metrics: TopPostMetrics;
+        comparison: TopPostComparison;
+        insight: string;
+        runnersUp: Array<{
+            mediaId: string;
+            caption: string | null;
+            reach: number;
+            thumbnailUrl: string | null;
+        }>;
+    }
+    type BestPerformingPostResponse = InsufficientDataResponse | {
+        hasData: true;
+        data: BestPerformingPostData;
+        _meta: InsightMeta;
+    };
+    type PostingConsistencyStatus = 'excellent' | 'good' | 'needs_improvement' | 'poor' | 'inactive';
+    interface MonthlyPostData {
+        month: string;
+        posts: number;
+        avgGap: number | null;
+    }
+    interface PostingConsistencyData {
+        period: {
+            start: string;
+            end: string;
+            days: number;
+        };
+        consistencyScore: number;
+        status: PostingConsistencyStatus;
+        metrics: {
+            totalPosts: number;
+            avgDaysBetweenPosts: number;
+            postVariance: number;
+            daysSinceLastPost: number;
+            lastPostDate: string | null;
+        };
+        pattern: {
+            isRegular: boolean;
+            typicalGap: string;
+            longestStreak: number;
+            currentStreak: number;
+            trend: 'increasing' | 'stable' | 'decreasing';
+            trendDescription: string;
+        };
+        monthlyBreakdown: MonthlyPostData[];
+        recommendation: {
+            suggested: string;
+            current: string;
+            reason: string;
+        };
+        insight: string;
+        recommendations: string[];
+    }
+    type PostingConsistencyResponse = InsufficientDataResponse | {
+        hasData: true;
+        data: PostingConsistencyData;
+        _meta: InsightMeta;
+    };
+    type FollowerQualityLabel = 'excellent' | 'good' | 'fair' | 'needs_attention' | 'concerning';
+    interface FollowerQualityData {
+        period: {
+            start: string;
+            end: string;
+            days: number;
+        };
+        qualityScore: number;
+        scoreLabel: FollowerQualityLabel;
+        metrics: {
+            followsGained: number;
+            unfollows: number;
+            netFollowers: number;
+            retentionRate: number;
+            engagementPerFollower: number;
+            reachPerFollower: number;
+            accountsEngaged: number;
+        };
+        trend: {
+            scoreChange: number;
+            direction: 'improving' | 'stable' | 'declining';
+            description: string;
+        };
+        insight: string;
+        recommendations: string[];
+    }
+    type FollowerQualityResponse = InsufficientDataResponse | {
+        hasData: true;
+        data: FollowerQualityData;
+        _meta: InsightMeta;
+    };
+    type InstagramMomentumStatus = 'surging' | 'rising' | 'steady' | 'cooling' | 'dropping';
+    type InstagramMomentumTrend = 'accelerating' | 'stable' | 'decelerating';
+    interface InstagramMetricChange {
+        current: number;
+        previous: number;
+        change: number;
+    }
+    interface InstagramMomentumData {
+        score: number;
+        rawChange: number;
+        status: InstagramMomentumStatus;
+        trend: InstagramMomentumTrend;
+        previousScore: number | null;
+        period: {
+            current: {
+                start: string;
+                end: string;
+            };
+            previous: {
+                start: string;
+                end: string;
+            };
+        };
+        breakdown: {
+            reach: InstagramMetricChange;
+            engagement: InstagramMetricChange;
+            followers: InstagramMetricChange;
+            profileViews: InstagramMetricChange;
+        };
+        insight: string;
+        topDrivers: string[];
+    }
+    type InstagramMomentumResponse = InsufficientDataResponse | {
+        hasData: true;
+        data: InstagramMomentumData;
+        _meta: InsightMeta;
+    };
+    type EngagementStyle = 'passive' | 'active' | 'viral' | 'valuable';
+    interface EngagementMetricBreakdown {
+        count: number;
+        percent: number;
+        trend: number;
+    }
+    interface EngagementBreakdownData {
+        period: {
+            start: string;
+            end: string;
+            days: number;
+        };
+        totalEngagement: number;
+        breakdown: {
+            likes: EngagementMetricBreakdown;
+            comments: EngagementMetricBreakdown;
+            shares: EngagementMetricBreakdown;
+            saves: EngagementMetricBreakdown;
+        };
+        engagementStyle: EngagementStyle;
+        analysis: {
+            strongestType: string;
+            weakestType: string;
+            opportunity: string;
+        };
+        insight: string;
+        recommendations: string[];
+    }
+    type EngagementBreakdownResponse = InsufficientDataResponse | {
+        hasData: true;
+        data: EngagementBreakdownData;
+        _meta: InsightMeta;
+    };
+    type InstagramHealthLabel = 'excellent' | 'good' | 'fair' | 'needs_attention' | 'poor';
+    interface HealthScoreComponent {
+        score: number;
+        label: string;
+        trend: number;
+    }
+    interface InstagramHealthScoreData {
+        period: {
+            start: string;
+            end: string;
+            days: number;
+        };
+        overall: number;
+        label: InstagramHealthLabel;
+        components: {
+            consistency: HealthScoreComponent;
+            engagement: HealthScoreComponent;
+            growth: HealthScoreComponent;
+            reach: HealthScoreComponent;
+        };
+        metrics: {
+            postsPerWeek: number;
+            avgEngagementRate: number;
+            followerGrowthRate: number;
+            avgReachPerPost: number;
+        };
+        percentageChanges: {
+            overall: number;
+            components: {
+                consistency: number;
+                engagement: number;
+                growth: number;
+                reach: number;
+            };
+        };
+        insight: string;
+        recommendations: string[];
+    }
+    type InstagramHealthScoreResponse = InsufficientDataResponse | {
+        hasData: true;
+        data: InstagramHealthScoreData;
+        _meta: InsightMeta;
+    };
+    interface InstagramAllInsightsData {
+        bestPost: BestPerformingPostResponse;
+        consistency: PostingConsistencyResponse;
+        followerQuality: FollowerQualityResponse;
+        momentum: InstagramMomentumResponse;
+        engagement: EngagementBreakdownResponse;
+        health: InstagramHealthScoreResponse;
+    }
+    interface InstagramAllInsightsResponse {
+        data: InstagramAllInsightsData;
+        meta: {
+            available: string[];
+        };
+    }
+    interface GetInstagramInsightParams {
+        /** Time range (e.g., "30d") */
+        range?: string;
+    }
 }
 declare namespace Activity {
     /**

package/dist/index.d.ts

@@ -703,15 +703,39 @@ declare namespace Instagram {
     interface PostInsightsSyncStatusResponse {
         needsSync: boolean;
         status: SyncStatus;
+        /** Progress tracking - primary fields for UI */
+        progress: {
+            /** Number of posts that have been processed (attempted insights sync) */
+            completed: number;
+            /** Total number of posts */
+            total: number;
+            /** Posts remaining to be processed */
+            remaining: number;
+            /** Percentage complete (0-100) */
+            percent: number;
+        };
+        /** Total number of posts */
         totalPosts: number;
+        /** Posts that have been processed (may or may not have insights) */
+        postsProcessed: number;
+        /** Posts that actually have insights data */
         postsWithInsights: number;
+        /** Percentage of posts with insights (0-100) */
         coverage: number;
         lastSyncAt: string | null;
         metadata?: {
+            postsProcessed?: number;
             postsWithInsights?: number;
             totalPosts?: number;
             lastCheckedAt?: string;
         } | null;
+        /** Queue processing info */
+        queue: {
+            isProcessing: boolean;
+            jobsActive: number;
+            jobsWaiting: number;
+            jobsFailed: number;
+        };
         message: string;
     }
     interface SyncResponse {
@@ -1377,6 +1401,259 @@ declare namespace Insights {
         /** Days per comparison period (14-90, default: 30) */
         period?: number;
     }
+    interface TopPostData {
+        mediaId: string;
+        caption: string | null;
+        mediaType: 'IMAGE' | 'VIDEO' | 'CAROUSEL_ALBUM' | 'REELS';
+        thumbnailUrl: string | null;
+        permalink: string;
+        postedAt: string;
+        ageInDays: number;
+    }
+    interface TopPostMetrics {
+        reach: number;
+        views: number;
+        likes: number;
+        comments: number;
+        shares: number;
+        saves: number;
+        engagementRate: number;
+    }
+    interface TopPostComparison {
+        vsAccountAverage: {
+            reach: number;
+            engagement: number;
+            description: string;
+        };
+        standoutReasons: string[];
+    }
+    interface BestPerformingPostData {
+        period: {
+            start: string;
+            end: string;
+            days: number;
+        };
+        topPost: TopPostData;
+        metrics: TopPostMetrics;
+        comparison: TopPostComparison;
+        insight: string;
+        runnersUp: Array<{
+            mediaId: string;
+            caption: string | null;
+            reach: number;
+            thumbnailUrl: string | null;
+        }>;
+    }
+    type BestPerformingPostResponse = InsufficientDataResponse | {
+        hasData: true;
+        data: BestPerformingPostData;
+        _meta: InsightMeta;
+    };
+    type PostingConsistencyStatus = 'excellent' | 'good' | 'needs_improvement' | 'poor' | 'inactive';
+    interface MonthlyPostData {
+        month: string;
+        posts: number;
+        avgGap: number | null;
+    }
+    interface PostingConsistencyData {
+        period: {
+            start: string;
+            end: string;
+            days: number;
+        };
+        consistencyScore: number;
+        status: PostingConsistencyStatus;
+        metrics: {
+            totalPosts: number;
+            avgDaysBetweenPosts: number;
+            postVariance: number;
+            daysSinceLastPost: number;
+            lastPostDate: string | null;
+        };
+        pattern: {
+            isRegular: boolean;
+            typicalGap: string;
+            longestStreak: number;
+            currentStreak: number;
+            trend: 'increasing' | 'stable' | 'decreasing';
+            trendDescription: string;
+        };
+        monthlyBreakdown: MonthlyPostData[];
+        recommendation: {
+            suggested: string;
+            current: string;
+            reason: string;
+        };
+        insight: string;
+        recommendations: string[];
+    }
+    type PostingConsistencyResponse = InsufficientDataResponse | {
+        hasData: true;
+        data: PostingConsistencyData;
+        _meta: InsightMeta;
+    };
+    type FollowerQualityLabel = 'excellent' | 'good' | 'fair' | 'needs_attention' | 'concerning';
+    interface FollowerQualityData {
+        period: {
+            start: string;
+            end: string;
+            days: number;
+        };
+        qualityScore: number;
+        scoreLabel: FollowerQualityLabel;
+        metrics: {
+            followsGained: number;
+            unfollows: number;
+            netFollowers: number;
+            retentionRate: number;
+            engagementPerFollower: number;
+            reachPerFollower: number;
+            accountsEngaged: number;
+        };
+        trend: {
+            scoreChange: number;
+            direction: 'improving' | 'stable' | 'declining';
+            description: string;
+        };
+        insight: string;
+        recommendations: string[];
+    }
+    type FollowerQualityResponse = InsufficientDataResponse | {
+        hasData: true;
+        data: FollowerQualityData;
+        _meta: InsightMeta;
+    };
+    type InstagramMomentumStatus = 'surging' | 'rising' | 'steady' | 'cooling' | 'dropping';
+    type InstagramMomentumTrend = 'accelerating' | 'stable' | 'decelerating';
+    interface InstagramMetricChange {
+        current: number;
+        previous: number;
+        change: number;
+    }
+    interface InstagramMomentumData {
+        score: number;
+        rawChange: number;
+        status: InstagramMomentumStatus;
+        trend: InstagramMomentumTrend;
+        previousScore: number | null;
+        period: {
+            current: {
+                start: string;
+                end: string;
+            };
+            previous: {
+                start: string;
+                end: string;
+            };
+        };
+        breakdown: {
+            reach: InstagramMetricChange;
+            engagement: InstagramMetricChange;
+            followers: InstagramMetricChange;
+            profileViews: InstagramMetricChange;
+        };
+        insight: string;
+        topDrivers: string[];
+    }
+    type InstagramMomentumResponse = InsufficientDataResponse | {
+        hasData: true;
+        data: InstagramMomentumData;
+        _meta: InsightMeta;
+    };
+    type EngagementStyle = 'passive' | 'active' | 'viral' | 'valuable';
+    interface EngagementMetricBreakdown {
+        count: number;
+        percent: number;
+        trend: number;
+    }
+    interface EngagementBreakdownData {
+        period: {
+            start: string;
+            end: string;
+            days: number;
+        };
+        totalEngagement: number;
+        breakdown: {
+            likes: EngagementMetricBreakdown;
+            comments: EngagementMetricBreakdown;
+            shares: EngagementMetricBreakdown;
+            saves: EngagementMetricBreakdown;
+        };
+        engagementStyle: EngagementStyle;
+        analysis: {
+            strongestType: string;
+            weakestType: string;
+            opportunity: string;
+        };
+        insight: string;
+        recommendations: string[];
+    }
+    type EngagementBreakdownResponse = InsufficientDataResponse | {
+        hasData: true;
+        data: EngagementBreakdownData;
+        _meta: InsightMeta;
+    };
+    type InstagramHealthLabel = 'excellent' | 'good' | 'fair' | 'needs_attention' | 'poor';
+    interface HealthScoreComponent {
+        score: number;
+        label: string;
+        trend: number;
+    }
+    interface InstagramHealthScoreData {
+        period: {
+            start: string;
+            end: string;
+            days: number;
+        };
+        overall: number;
+        label: InstagramHealthLabel;
+        components: {
+            consistency: HealthScoreComponent;
+            engagement: HealthScoreComponent;
+            growth: HealthScoreComponent;
+            reach: HealthScoreComponent;
+        };
+        metrics: {
+            postsPerWeek: number;
+            avgEngagementRate: number;
+            followerGrowthRate: number;
+            avgReachPerPost: number;
+        };
+        percentageChanges: {
+            overall: number;
+            components: {
+                consistency: number;
+                engagement: number;
+                growth: number;
+                reach: number;
+            };
+        };
+        insight: string;
+        recommendations: string[];
+    }
+    type InstagramHealthScoreResponse = InsufficientDataResponse | {
+        hasData: true;
+        data: InstagramHealthScoreData;
+        _meta: InsightMeta;
+    };
+    interface InstagramAllInsightsData {
+        bestPost: BestPerformingPostResponse;
+        consistency: PostingConsistencyResponse;
+        followerQuality: FollowerQualityResponse;
+        momentum: InstagramMomentumResponse;
+        engagement: EngagementBreakdownResponse;
+        health: InstagramHealthScoreResponse;
+    }
+    interface InstagramAllInsightsResponse {
+        data: InstagramAllInsightsData;
+        meta: {
+            available: string[];
+        };
+    }
+    interface GetInstagramInsightParams {
+        /** Time range (e.g., "30d") */
+        range?: string;
+    }
 }
 declare namespace Activity {
     /**