@dracoonghost/trndup-sdk 1.3.19 → 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 {
@@ -1343,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>;
 }
 
 /**
@@ -1472,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>;
 }
 
 /**

package/dist/index.d.ts

@@ -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 {
@@ -1343,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>;
 }
 
 /**
@@ -1472,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>;
 }
 
 /**

package/dist/index.js

@@ -264,6 +264,59 @@ var AuthModule = class {
   async getPlatformStatus() {
     return this.client.get("/user/platforms/status");
   }
+  // =========================================================================
+  // OAUTH FLOWS
+  // =========================================================================
+  /**
+   * 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
+   */
+  async getFacebookOAuthUrl(redirectUri) {
+    const params = redirectUri ? { redirect_uri: redirectUri } : void 0;
+    return this.client.get("/auth/facebook", params);
+  }
+  /**
+   * 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
+   */
+  async getInstagramOAuthUrl(redirectUri) {
+    const params = redirectUri ? { redirect_uri: redirectUri } : void 0;
+    return this.client.get("/auth/instagram", params);
+  }
+  /**
+   * Build OAuth URL for Facebook (Instagram Business)
+   * Convenience method that returns just the URL string
+   * 
+   * @param redirectUri - URL to redirect to after OAuth
+   */
+  async buildFacebookOAuthUrl(redirectUri) {
+    const response = await this.getFacebookOAuthUrl(redirectUri);
+    return response.authUrl;
+  }
+  /**
+   * Build OAuth URL for Instagram
+   * Convenience method that returns just the URL string
+   * 
+   * @param redirectUri - URL to redirect to after OAuth
+   */
+  async buildInstagramOAuthUrl(redirectUri) {
+    const response = await this.getInstagramOAuthUrl(redirectUri);
+    return response.authUrl;
+  }
 };
 
 // modules/youtube.ts
@@ -433,20 +486,34 @@ var InstagramModule = class {
   constructor(client) {
     this.client = client;
   }
+  // ===== INITIALIZATION =====
   /**
    * Get Instagram initialization status
-   * GET /v1/platforms/instagram/init/status
+   * GET /v1/platforms/instagram/status/init
    */
   async getInitStatus() {
-    return this.client.get("/v1/platforms/instagram/init/status");
+    return this.client.get("/v1/platforms/instagram/status/init");
   }
   /**
    * Initialize Instagram data sync
-   * POST /v1/platforms/instagram/init
+   * GET /v1/platforms/instagram/init
    */
   async initialize() {
-    return this.client.post("/v1/platforms/instagram/init");
+    return this.client.get("/v1/platforms/instagram/init");
+  }
+  // ===== ACCOUNT INSIGHTS =====
+  /**
+   * Get account-level insights
+   * GET /v1/platforms/instagram/account/insights
+   * @param range Time range: '7d', '14d', '28d', '30d'
+   */
+  async getAccountInsights(params) {
+    return this.client.get(
+      "/v1/platforms/instagram/account/insights",
+      params
+    );
   }
+  // ===== MEDIA / POSTS =====
   /**
    * Get Instagram posts
    * GET /v1/platforms/instagram/posts
@@ -458,25 +525,42 @@ var InstagramModule = class {
     );
   }
   /**
-   * Get specific post by ID
-   * GET /v1/platforms/instagram/posts/:postId
+   * Get insights for a specific post
+   * GET /v1/platforms/instagram/posts/:postId/insights
+   */
+  async getPostInsights(postId) {
+    return this.client.get(
+      `/v1/platforms/instagram/posts/${postId}/insights`
+    );
+  }
+  // ===== STORIES =====
+  /**
+   * Get active stories
+   * GET /v1/platforms/instagram/stories
+   */
+  async getStories() {
+    return this.client.get("/v1/platforms/instagram/stories");
+  }
+  // ===== SYNC =====
+  /**
+   * Trigger manual data sync
+   * POST /v1/platforms/instagram/sync
    */
-  async getPost(postId) {
-    return this.client.get(`/v1/platforms/instagram/posts/${postId}`);
+  async sync() {
+    return this.client.post("/v1/platforms/instagram/sync");
   }
+  // ===== LEGACY (backward compat) =====
   /**
-   * Get account metrics
-   * GET /v1/platforms/instagram/account/metrics
+   * @deprecated Use getAccountInsights instead
    */
   async getAccountMetrics() {
-    return this.client.get("/v1/platforms/instagram/account/metrics");
+    return this.getAccountInsights();
   }
   /**
-   * Refresh Instagram data
-   * POST /v1/platforms/instagram/refresh
+   * @deprecated Use sync instead
    */
   async refresh() {
-    return this.client.post("/v1/platforms/instagram/refresh");
+    return this.sync();
   }
 };