@dracoonghost/trndup-sdk 1.3.18 → 1.3.20

package/dist/index.mjs

@@ -262,6 +262,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
@@ -431,20 +484,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
@@ -456,25 +523,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();
   }
 };
 
@@ -857,6 +941,47 @@ var InsightsModule = class {
     );
   }
   // =========================================================================
+  // YOUTUBE UPLOAD CONSISTENCY
+  // =========================================================================
+  /**
+   * 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
+   */
+  async getYouTubeUploadConsistency() {
+    return this.client.get(
+      "/v1/insights/youtube/upload-consistency"
+    );
+  }
+  // =========================================================================
   // YOUTUBE ALL INSIGHTS
   // =========================================================================
   /**
@@ -881,8 +1006,8 @@ var InsightsModule = class {
    *   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`);
    * }
    * ```
    *