@dracoonghost/trndup-sdk 1.3.22 → 1.3.24

package/dist/index.d.mts

@@ -674,13 +674,28 @@ declare namespace Instagram {
     }
     /**
      * Response from POST /v1/platforms/instagram/analytics/posts/sync
+     * Post insights are queued for background processing via BullMQ
      */
     interface PostInsightsSyncResponse {
+        message: string;
         totalPosts: number;
-        postsWithInsights: number;
-        errorCount: number;
-        syncStatus: SyncStatus;
-        lastSyncAt: string;
+        jobsQueued: number;
+        status: SyncStatus;
+        queuedAt: string;
+    }
+    /**
+     * Response when sync is already in progress
+     */
+    interface PostInsightsInProgressResponse {
+        message: string;
+        status: 'in_progress';
+        progress: {
+            waiting: number;
+            active: number;
+            completed: number;
+            failed: number;
+            delayed: number;
+        };
     }
     /**
      * Response from GET /v1/platforms/instagram/analytics/posts/sync/status
@@ -688,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 {
@@ -1801,13 +1840,20 @@ declare class InstagramModule {
      */
     getAccountAnalyticsSyncStatus(): Promise<Instagram.AccountAnalyticsSyncStatusResponse>;
     /**
-     * Sync post-level insights for all posts
+     * Queue post-level insights sync for all posts (BullMQ-based)
      * POST /v1/platforms/instagram/analytics/posts/sync
+     *
+     * Jobs are queued and processed in the background.
+     * Poll getPostInsightsSyncStatus() to check progress.
+     *
+     * @returns Response with jobsQueued count and status
      */
     syncPostInsights(): Promise<Instagram.PostInsightsSyncResponse>;
     /**
      * Get post insights sync status
      * GET /v1/platforms/instagram/analytics/posts/sync/status
+     *
+     * Use to poll progress while sync is in_progress
      */
     getPostInsightsSyncStatus(): Promise<Instagram.PostInsightsSyncStatusResponse>;
     /**

package/dist/index.d.ts

@@ -674,13 +674,28 @@ declare namespace Instagram {
     }
     /**
      * Response from POST /v1/platforms/instagram/analytics/posts/sync
+     * Post insights are queued for background processing via BullMQ
      */
     interface PostInsightsSyncResponse {
+        message: string;
         totalPosts: number;
-        postsWithInsights: number;
-        errorCount: number;
-        syncStatus: SyncStatus;
-        lastSyncAt: string;
+        jobsQueued: number;
+        status: SyncStatus;
+        queuedAt: string;
+    }
+    /**
+     * Response when sync is already in progress
+     */
+    interface PostInsightsInProgressResponse {
+        message: string;
+        status: 'in_progress';
+        progress: {
+            waiting: number;
+            active: number;
+            completed: number;
+            failed: number;
+            delayed: number;
+        };
     }
     /**
      * Response from GET /v1/platforms/instagram/analytics/posts/sync/status
@@ -688,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 {
@@ -1801,13 +1840,20 @@ declare class InstagramModule {
      */
     getAccountAnalyticsSyncStatus(): Promise<Instagram.AccountAnalyticsSyncStatusResponse>;
     /**
-     * Sync post-level insights for all posts
+     * Queue post-level insights sync for all posts (BullMQ-based)
      * POST /v1/platforms/instagram/analytics/posts/sync
+     *
+     * Jobs are queued and processed in the background.
+     * Poll getPostInsightsSyncStatus() to check progress.
+     *
+     * @returns Response with jobsQueued count and status
      */
     syncPostInsights(): Promise<Instagram.PostInsightsSyncResponse>;
     /**
      * Get post insights sync status
      * GET /v1/platforms/instagram/analytics/posts/sync/status
+     *
+     * Use to poll progress while sync is in_progress
      */
     getPostInsightsSyncStatus(): Promise<Instagram.PostInsightsSyncStatusResponse>;
     /**

package/dist/index.js

@@ -549,8 +549,13 @@ var InstagramModule = class {
   }
   // ===== POST INSIGHTS SYNC =====
   /**
-   * Sync post-level insights for all posts
+   * Queue post-level insights sync for all posts (BullMQ-based)
    * POST /v1/platforms/instagram/analytics/posts/sync
+   * 
+   * Jobs are queued and processed in the background.
+   * Poll getPostInsightsSyncStatus() to check progress.
+   * 
+   * @returns Response with jobsQueued count and status
    */
   async syncPostInsights() {
     return this.client.post(
@@ -560,6 +565,8 @@ var InstagramModule = class {
   /**
    * Get post insights sync status
    * GET /v1/platforms/instagram/analytics/posts/sync/status
+   * 
+   * Use to poll progress while sync is in_progress
    */
   async getPostInsightsSyncStatus() {
     return this.client.get(