@dracoonghost/trndup-sdk 1.3.18 → 1.3.20

package/dist/index.d.mts

@@ -86,6 +86,22 @@ declare namespace Auth {
     interface UpdateProfileResponse {
         user: User;
     }
+    /**
+     * Response from OAuth URL request
+     */
+    interface OAuthUrlResponse {
+        /** URL to redirect user to for OAuth consent */
+        authUrl: string;
+    }
+    /**
+     * OAuth callback result (returned in redirect URL params)
+     */
+    interface OAuthCallbackResult {
+        success: boolean;
+        provider: 'facebook' | 'instagram';
+        message?: string;
+        error?: string;
+    }
     /**
      * Status for a single sync step
      */
@@ -432,38 +448,113 @@ declare namespace YouTube {
 }
 declare namespace Instagram {
     interface InitStatusResponse {
+        connected: boolean;
+        needsInit: boolean;
+        isInitialSyncDone?: boolean;
+        lastSyncedAt?: string | null;
+        authMethod?: 'facebook' | 'instagram';
+        account?: {
+            username?: string;
+            name?: string;
+            profilePictureUrl?: string;
+            followersCount?: number;
+            mediaCount?: number;
+        } | null;
+        syncedMediaCount?: number;
+        message?: string;
+    }
+    interface InitResponse {
         needsInit: boolean;
         message: string;
-        postCount?: number;
-        accountId?: string;
-        username?: string;
+        profile?: {
+            username?: string;
+            name?: string;
+            profilePictureUrl?: string;
+            followersCount?: number;
+            mediaCount?: number;
+        };
+        syncedMedia?: number;
+        lastSyncedAt?: string;
+    }
+    interface GetAccountInsightsParams {
+        range?: '7d' | '14d' | '28d' | '30d';
+    }
+    interface AccountInsightsResponse {
+        range: string;
+        aggregated: Record<string, number>;
+        timeSeries: Record<string, Array<{
+            date: string;
+            value: number;
+        }>>;
     }
     interface Post {
         id: string;
+        media_id: string;
         caption?: string;
-        mediaType: 'IMAGE' | 'VIDEO' | 'CAROUSEL_ALBUM';
-        mediaUrl: string;
-        permalink: string;
+        media_type: 'IMAGE' | 'VIDEO' | 'CAROUSEL_ALBUM' | 'REELS';
+        media_url?: string;
+        thumbnail_url?: string;
+        permalink?: string;
         timestamp: string;
-        likeCount?: number;
-        commentsCount?: number;
-        engagementRate?: number;
+        like_count?: number;
+        comments_count?: number;
     }
     interface GetPostsParams {
         limit?: number;
         offset?: number;
+        mediaType?: string;
+        sortBy?: 'timestamp' | 'like_count' | 'comments_count';
+        sortOrder?: 'asc' | 'desc';
     }
     interface GetPostsResponse {
         posts: Post[];
-        total: number;
-        hasMore: boolean;
+        pagination: {
+            limit: number;
+            offset: number;
+            total: number;
+            hasMore: boolean;
+        };
+    }
+    interface PostInsightsResponse {
+        postId: string;
+        mediaType: string;
+        insights: {
+            data: Array<{
+                name: string;
+                title: string;
+                values: Array<{
+                    value: number;
+                }>;
+            }>;
+        };
+    }
+    interface Story {
+        id: string;
+        media_type: 'IMAGE' | 'VIDEO';
+        media_url?: string;
+        timestamp: string;
+        permalink?: string;
+    }
+    interface StoriesResponse {
+        stories: Story[];
+        count: number;
+    }
+    interface SyncResponse {
+        message: string;
+        profile?: {
+            username?: string;
+            followersCount?: number;
+            mediaCount?: number;
+        };
+        syncedMedia?: number;
     }
+    /** @deprecated Use InitStatusResponse */
     interface AccountMetrics {
         followersCount: number;
         followsCount: number;
         mediaCount: number;
-        averageLikes: number;
-        engagementRate: number;
+        averageLikes?: number;
+        engagementRate?: number;
     }
 }
 declare namespace Insights {
@@ -1023,6 +1114,61 @@ declare namespace Insights {
         data: OptimalVideoLengthData;
         _meta: InsightMeta;
     };
+    /** Consistency status levels */
+    type ConsistencyStatus = 'excellent' | 'good' | 'needs_improvement' | 'poor' | 'inactive';
+    /** Monthly upload breakdown */
+    interface MonthlyUploadData {
+        month: string;
+        uploads: number;
+        avgGap: number | null;
+    }
+    /** Upload consistency insight data */
+    interface UploadConsistencyData {
+        /** Period analyzed */
+        period: {
+            start: string;
+            end: string;
+            days: number;
+        };
+        /** Overall consistency score (0-100) */
+        consistencyScore: number;
+        /** Status label */
+        status: ConsistencyStatus;
+        /** Key metrics */
+        metrics: {
+            totalUploads: number;
+            avgDaysBetweenUploads: number;
+            uploadVariance: number;
+            daysSinceLastUpload: number;
+            lastUploadDate: string | null;
+        };
+        /** Upload pattern analysis */
+        pattern: {
+            isRegular: boolean;
+            typicalGap: string;
+            longestStreak: number;
+            currentStreak: number;
+            trend: 'increasing' | 'stable' | 'decreasing';
+            trendDescription: string;
+        };
+        /** Monthly breakdown */
+        monthlyBreakdown: MonthlyUploadData[];
+        /** Frequency recommendation */
+        recommendation: {
+            suggested: string;
+            current: string;
+            reason: string;
+        };
+        /** Human-readable summary */
+        insight: string;
+        /** Actionable recommendations */
+        recommendations: string[];
+    }
+    type UploadConsistencyResponse = (InsufficientDataResponse) | {
+        hasData: true;
+        data: UploadConsistencyData;
+        _meta: InsightMeta;
+    };
     interface AllInsightsData {
         bestPerformingVideo: BestPerformingVideoResponse;
         contentDecay: ContentDecayResponse;
@@ -1031,6 +1177,7 @@ declare namespace Insights {
         fadingHits: FadingHitsResponse;
         audienceFatigue: AudienceFatigueResponse;
         optimalLength: OptimalVideoLengthResponse;
+        uploadConsistency: UploadConsistencyResponse;
     }
     interface AllInsightsResponse {
         data: AllInsightsData;
@@ -1287,6 +1434,44 @@ declare class AuthModule {
      * GET /user/platforms/status
      */
     getPlatformStatus(): Promise<Auth.PlatformStatus>;
+    /**
+     * Get Facebook OAuth URL for connecting Instagram Business accounts
+     * GET /auth/facebook
+     *
+     * After receiving the authUrl, redirect/open this URL in a browser.
+     * User will authenticate with Facebook and grant Instagram permissions.
+     * After completion, user is redirected to the specified redirect_uri.
+     *
+     * @param redirectUri - URL to redirect to after OAuth (your app's deep link)
+     * @returns OAuth authorization URL to redirect user to
+     */
+    getFacebookOAuthUrl(redirectUri?: string): Promise<Auth.OAuthUrlResponse>;
+    /**
+     * Get Instagram OAuth URL for connecting Instagram Professional accounts
+     * GET /auth/instagram
+     *
+     * After receiving the authUrl, redirect/open this URL in a browser.
+     * User will authenticate with Instagram and grant permissions.
+     * After completion, user is redirected to the specified redirect_uri.
+     *
+     * @param redirectUri - URL to redirect to after OAuth (your app's deep link)
+     * @returns OAuth authorization URL to redirect user to
+     */
+    getInstagramOAuthUrl(redirectUri?: string): Promise<Auth.OAuthUrlResponse>;
+    /**
+     * Build OAuth URL for Facebook (Instagram Business)
+     * Convenience method that returns just the URL string
+     *
+     * @param redirectUri - URL to redirect to after OAuth
+     */
+    buildFacebookOAuthUrl(redirectUri?: string): Promise<string>;
+    /**
+     * Build OAuth URL for Instagram
+     * Convenience method that returns just the URL string
+     *
+     * @param redirectUri - URL to redirect to after OAuth
+     */
+    buildInstagramOAuthUrl(redirectUri?: string): Promise<string>;
 }
 
 /**
@@ -1416,38 +1601,48 @@ declare class InstagramModule {
     constructor(client: TrndUpClient);
     /**
      * Get Instagram initialization status
-     * GET /v1/platforms/instagram/init/status
+     * GET /v1/platforms/instagram/status/init
      */
     getInitStatus(): Promise<Instagram.InitStatusResponse>;
     /**
      * Initialize Instagram data sync
-     * POST /v1/platforms/instagram/init
+     * GET /v1/platforms/instagram/init
      */
-    initialize(): Promise<{
-        message: string;
-    }>;
+    initialize(): Promise<Instagram.InitResponse>;
+    /**
+     * Get account-level insights
+     * GET /v1/platforms/instagram/account/insights
+     * @param range Time range: '7d', '14d', '28d', '30d'
+     */
+    getAccountInsights(params?: Instagram.GetAccountInsightsParams): Promise<Instagram.AccountInsightsResponse>;
     /**
      * Get Instagram posts
      * GET /v1/platforms/instagram/posts
      */
     getPosts(params?: Instagram.GetPostsParams): Promise<Instagram.GetPostsResponse>;
     /**
-     * Get specific post by ID
-     * GET /v1/platforms/instagram/posts/:postId
+     * Get insights for a specific post
+     * GET /v1/platforms/instagram/posts/:postId/insights
      */
-    getPost(postId: string): Promise<Instagram.Post>;
+    getPostInsights(postId: string): Promise<Instagram.PostInsightsResponse>;
     /**
-     * Get account metrics
-     * GET /v1/platforms/instagram/account/metrics
+     * Get active stories
+     * GET /v1/platforms/instagram/stories
      */
-    getAccountMetrics(): Promise<Instagram.AccountMetrics>;
+    getStories(): Promise<Instagram.StoriesResponse>;
     /**
-     * Refresh Instagram data
-     * POST /v1/platforms/instagram/refresh
+     * Trigger manual data sync
+     * POST /v1/platforms/instagram/sync
      */
-    refresh(): Promise<{
-        message: string;
-    }>;
+    sync(): Promise<Instagram.SyncResponse>;
+    /**
+     * @deprecated Use getAccountInsights instead
+     */
+    getAccountMetrics(): Promise<Instagram.AccountInsightsResponse>;
+    /**
+     * @deprecated Use sync instead
+     */
+    refresh(): Promise<Instagram.SyncResponse>;
 }
 
 /**
@@ -1761,6 +1956,40 @@ declare class InsightsModule {
      * GET /v1/insights/youtube/optimal-length
      */
     getYouTubeOptimalLength(): Promise<Insights.OptimalVideoLengthResponse>;
+    /**
+     * Analyze your upload schedule consistency
+     *
+     * Measures how regularly you upload and provides recommendations
+     * for maintaining a consistent schedule that helps algorithm performance.
+     *
+     * @example
+     * ```typescript
+     * const result = await client.insights.getYouTubeUploadConsistency();
+     *
+     * if (result.hasData) {
+     *   console.log(`Consistency Score: ${result.data.consistencyScore}/100`);
+     *   console.log(`Status: ${result.data.status}`);
+     *   console.log(`Avg gap: ${result.data.metrics.avgDaysBetweenUploads} days`);
+     *   console.log(`Days since last upload: ${result.data.metrics.daysSinceLastUpload}`);
+     *
+     *   // Pattern analysis
+     *   console.log(`Pattern: ${result.data.pattern.typicalGap}`);
+     *   console.log(`Trend: ${result.data.pattern.trendDescription}`);
+     *
+     *   // Recommendation
+     *   console.log(`Current: ${result.data.recommendation.current}`);
+     *   console.log(`Suggested: ${result.data.recommendation.suggested}`);
+     *
+     *   // Monthly breakdown
+     *   for (const month of result.data.monthlyBreakdown) {
+     *     console.log(`${month.month}: ${month.uploads} uploads`);
+     *   }
+     * }
+     * ```
+     *
+     * GET /v1/insights/youtube/upload-consistency
+     */
+    getYouTubeUploadConsistency(): Promise<Insights.UploadConsistencyResponse>;
     /**
      * Get all YouTube insights in one call
      *
@@ -1783,8 +2012,8 @@ declare class InsightsModule {
      *   console.log(`Fatigue: ${all.data.audienceFatigue.data.fatigueLevel}`);
      * }
      *
-     * if (all.data.optimalLength.hasData) {
-     *   console.log(`Optimal Length: ${all.data.optimalLength.data.optimalLength.bucket}`);
+     * if (all.data.uploadConsistency.hasData) {
+     *   console.log(`Consistency: ${all.data.uploadConsistency.data.consistencyScore}/100`);
      * }
      * ```
      *