@dracoonghost/trndup-sdk 1.4.0 → 1.5.1

package/dist/index.d.mts

@@ -139,6 +139,63 @@ declare namespace Auth {
         youtube: PlatformSyncInfo;
         instagram: PlatformSyncInfo;
     }
+    interface LinkPhoneSendOTPRequest {
+        phoneNumber: string;
+    }
+    interface LinkPhoneSendOTPResponse {
+        message: string;
+        expiresIn: number;
+    }
+    interface LinkPhoneVerifyRequest {
+        phoneNumber: string;
+        code: string;
+    }
+    interface LinkPhoneVerifyResponse {
+        message: string;
+        user: User;
+    }
+    interface UnlinkPhoneResponse {
+        message: string;
+    }
+    interface DeleteAccountRequest {
+        reason?: string;
+    }
+    interface DeleteAccountResponse {
+        message: string;
+        deletedAt: string;
+        scheduledDeletionAt: string;
+        daysUntilPermanentDeletion: number;
+        canReactivate: boolean;
+        reactivationInfo: string;
+    }
+    interface ReactivateAccountResponse {
+        message: string;
+        user: User;
+    }
+    interface DataExportResponse {
+        exportedAt: string;
+        user: User;
+        connectedAccounts: Array<{
+            provider: string;
+            accountName?: string;
+            username?: string;
+            connectedAt: string;
+        }>;
+        dataCategories: string[];
+    }
+    interface NotificationPreferences {
+        push: boolean;
+        email: boolean;
+        whatsapp: boolean;
+    }
+    interface UpdateNotificationPreferencesRequest {
+        push?: boolean;
+        email?: boolean;
+        whatsapp?: boolean;
+    }
+    interface NotificationPreferencesResponse {
+        notificationPreferences: NotificationPreferences;
+    }
 }
 declare namespace Social {
     /**
@@ -2094,6 +2151,61 @@ declare class AuthModule {
      * @param redirectUri - URL to redirect to after OAuth
      */
     buildInstagramOAuthUrl(redirectUri?: string): Promise<string>;
+    /**
+     * Send OTP to link phone number to existing account
+     * POST /auth/phone/link/send-otp
+     *
+     * @param phoneNumber - Phone number to link (E.164 format)
+     */
+    linkPhoneSendOTP(phoneNumber: string): Promise<Auth.LinkPhoneSendOTPResponse>;
+    /**
+     * Verify OTP and link phone to account
+     * POST /auth/phone/link/verify
+     *
+     * @param phoneNumber - Phone number to link
+     * @param code - 6-digit verification code
+     */
+    linkPhoneVerify(phoneNumber: string, code: string): Promise<Auth.LinkPhoneVerifyResponse>;
+    /**
+     * Remove phone number from account
+     * DELETE /auth/phone
+     */
+    unlinkPhone(): Promise<Auth.UnlinkPhoneResponse>;
+    /**
+     * Delete account (soft delete - 30 day grace period)
+     * DELETE /auth/account
+     *
+     * Account is scheduled for permanent deletion after 30 days.
+     * User can reactivate by logging in within the grace period.
+     * Required for App Store compliance.
+     *
+     * @param reason - Optional reason for deletion (sent as query param)
+     */
+    deleteAccount(reason?: string): Promise<Auth.DeleteAccountResponse>;
+    /**
+     * Reactivate deleted account (within 30 day grace period)
+     * POST /auth/account/reactivate
+     */
+    reactivateAccount(): Promise<Auth.ReactivateAccountResponse>;
+    /**
+     * Export user data (GDPR compliance)
+     * GET /auth/privacy-export
+     *
+     * Returns all user data for GDPR data portability requirements.
+     */
+    exportUserData(): Promise<Auth.DataExportResponse>;
+    /**
+     * Get notification preferences
+     * GET /auth/notifications
+     */
+    getNotificationPreferences(): Promise<Auth.NotificationPreferencesResponse>;
+    /**
+     * Update notification preferences
+     * PATCH /auth/notifications
+     *
+     * @param preferences - Notification channels to enable/disable
+     */
+    updateNotificationPreferences(preferences: Auth.UpdateNotificationPreferencesRequest): Promise<Auth.NotificationPreferencesResponse>;
 }
 
 /**
@@ -2694,6 +2806,156 @@ declare class InsightsModule {
      * GET /v1/insights/youtube/all
      */
     getYouTubeAllInsights(): Promise<Insights.AllInsightsResponse>;
+    /**
+     * Instagram insights sub-module
+     */
+    instagram: {
+        /**
+         * Get all Instagram insights in one call
+         *
+         * Efficient for dashboard display - fetches all insights in parallel.
+         *
+         * @example
+         * ```typescript
+         * const all = await client.insights.instagram.getAll({ range: '30d' });
+         *
+         * // Check which insights are available
+         * if (all.data.health.hasData) {
+         *   console.log(`Health Score: ${all.data.health.data.overall}/100`);
+         * }
+         *
+         * if (all.data.bestPost.hasData) {
+         *   console.log(`Best Post: ${all.data.bestPost.data.post.caption}`);
+         * }
+         * ```
+         *
+         * GET /v1/insights/instagram
+         */
+        getAll: (params?: Insights.GetInstagramInsightParams) => Promise<Insights.InstagramAllInsightsResponse>;
+        /**
+         * Get Instagram health score
+         *
+         * Overall account health based on consistency, engagement, growth, and reach.
+         * Score ranges from 0-100 with labels: excellent, good, fair, needs_attention, poor.
+         *
+         * @example
+         * ```typescript
+         * const health = await client.insights.instagram.getHealthScore({ range: '30d' });
+         *
+         * if (health.hasData) {
+         *   console.log(`Score: ${health.data.overall}/100 (${health.data.label})`);
+         *   console.log(`Consistency: ${health.data.components.consistency.score}`);
+         *   console.log(`Engagement: ${health.data.components.engagement.score}`);
+         *   console.log(`Growth: ${health.data.components.growth.score}`);
+         *   console.log(`Reach: ${health.data.components.reach.score}`);
+         * }
+         * ```
+         *
+         * GET /v1/insights/instagram/health
+         */
+        getHealthScore: (params?: Insights.GetInstagramInsightParams) => Promise<Insights.InstagramHealthScoreResponse>;
+        /**
+         * Get best performing post
+         *
+         * Identifies the top performing post in the period based on engagement rate.
+         * Includes analysis of why it worked and comparison to average.
+         *
+         * @example
+         * ```typescript
+         * const best = await client.insights.instagram.getBestPost({ range: '30d' });
+         *
+         * if (best.hasData) {
+         *   console.log(`Post: ${best.data.post.caption}`);
+         *   console.log(`Engagement: ${best.data.post.metrics.engagementRate}%`);
+         *   console.log(`Above average: ${best.data.comparison.vsAverage.engagement}%`);
+         * }
+         * ```
+         *
+         * GET /v1/insights/instagram/best-post
+         */
+        getBestPost: (params?: Insights.GetInstagramInsightParams) => Promise<Insights.BestPerformingPostResponse>;
+        /**
+         * Get posting consistency analysis
+         *
+         * Analyzes posting frequency patterns and consistency.
+         * Identifies best posting days and gaps in schedule.
+         *
+         * @example
+         * ```typescript
+         * const consistency = await client.insights.instagram.getConsistency({ range: '90d' });
+         *
+         * if (consistency.hasData) {
+         *   console.log(`Posts/week: ${consistency.data.frequency.current.postsPerWeek}`);
+         *   console.log(`Score: ${consistency.data.consistency.score}/100`);
+         *   console.log(`Best day: ${consistency.data.patterns.mostActiveDay}`);
+         * }
+         * ```
+         *
+         * GET /v1/insights/instagram/consistency
+         */
+        getConsistency: (params?: Insights.GetInstagramInsightParams) => Promise<Insights.PostingConsistencyResponse>;
+        /**
+         * Get follower quality analysis
+         *
+         * Measures the quality and engagement of followers.
+         * Shows growth metrics and engagement rates.
+         *
+         * @example
+         * ```typescript
+         * const quality = await client.insights.instagram.getFollowerQuality({ range: '30d' });
+         *
+         * if (quality.hasData) {
+         *   console.log(`Quality: ${quality.data.qualityScore}/100`);
+         *   console.log(`Engagement rate: ${quality.data.metrics.engagementRate}%`);
+         *   console.log(`Growth: +${quality.data.growth.netChange} followers`);
+         * }
+         * ```
+         *
+         * GET /v1/insights/instagram/follower-quality
+         */
+        getFollowerQuality: (params?: Insights.GetInstagramInsightParams) => Promise<Insights.FollowerQualityResponse>;
+        /**
+         * Get account momentum
+         *
+         * Shows current account trajectory: surging, growing, stable, declining, or stalling.
+         * Compares recent performance to previous periods.
+         *
+         * @example
+         * ```typescript
+         * const momentum = await client.insights.instagram.getMomentum();
+         *
+         * if (momentum.hasData) {
+         *   console.log(`Status: ${momentum.data.current.status}`);
+         *   console.log(`Score: ${momentum.data.current.score}`);
+         *   console.log(`vs Last Week: ${momentum.data.comparison.vsLastWeek}%`);
+         * }
+         * ```
+         *
+         * GET /v1/insights/instagram/momentum
+         */
+        getMomentum: () => Promise<Insights.InstagramMomentumResponse>;
+        /**
+         * Get engagement breakdown
+         *
+         * Breaks down engagement by type: likes, comments, shares, saves.
+         * Identifies engagement style and opportunities.
+         *
+         * @example
+         * ```typescript
+         * const engagement = await client.insights.instagram.getEngagement({ range: '30d' });
+         *
+         * if (engagement.hasData) {
+         *   console.log(`Total: ${engagement.data.totalEngagement}`);
+         *   console.log(`Style: ${engagement.data.engagementStyle}`);
+         *   console.log(`Likes: ${engagement.data.breakdown.likes.percent}%`);
+         *   console.log(`Comments: ${engagement.data.breakdown.comments.percent}%`);
+         * }
+         * ```
+         *
+         * GET /v1/insights/instagram/engagement
+         */
+        getEngagement: (params?: Insights.GetInstagramInsightParams) => Promise<Insights.EngagementBreakdownResponse>;
+    };
 }
 
 /**

package/dist/index.d.ts

@@ -139,6 +139,63 @@ declare namespace Auth {
         youtube: PlatformSyncInfo;
         instagram: PlatformSyncInfo;
     }
+    interface LinkPhoneSendOTPRequest {
+        phoneNumber: string;
+    }
+    interface LinkPhoneSendOTPResponse {
+        message: string;
+        expiresIn: number;
+    }
+    interface LinkPhoneVerifyRequest {
+        phoneNumber: string;
+        code: string;
+    }
+    interface LinkPhoneVerifyResponse {
+        message: string;
+        user: User;
+    }
+    interface UnlinkPhoneResponse {
+        message: string;
+    }
+    interface DeleteAccountRequest {
+        reason?: string;
+    }
+    interface DeleteAccountResponse {
+        message: string;
+        deletedAt: string;
+        scheduledDeletionAt: string;
+        daysUntilPermanentDeletion: number;
+        canReactivate: boolean;
+        reactivationInfo: string;
+    }
+    interface ReactivateAccountResponse {
+        message: string;
+        user: User;
+    }
+    interface DataExportResponse {
+        exportedAt: string;
+        user: User;
+        connectedAccounts: Array<{
+            provider: string;
+            accountName?: string;
+            username?: string;
+            connectedAt: string;
+        }>;
+        dataCategories: string[];
+    }
+    interface NotificationPreferences {
+        push: boolean;
+        email: boolean;
+        whatsapp: boolean;
+    }
+    interface UpdateNotificationPreferencesRequest {
+        push?: boolean;
+        email?: boolean;
+        whatsapp?: boolean;
+    }
+    interface NotificationPreferencesResponse {
+        notificationPreferences: NotificationPreferences;
+    }
 }
 declare namespace Social {
     /**
@@ -2094,6 +2151,61 @@ declare class AuthModule {
      * @param redirectUri - URL to redirect to after OAuth
      */
     buildInstagramOAuthUrl(redirectUri?: string): Promise<string>;
+    /**
+     * Send OTP to link phone number to existing account
+     * POST /auth/phone/link/send-otp
+     *
+     * @param phoneNumber - Phone number to link (E.164 format)
+     */
+    linkPhoneSendOTP(phoneNumber: string): Promise<Auth.LinkPhoneSendOTPResponse>;
+    /**
+     * Verify OTP and link phone to account
+     * POST /auth/phone/link/verify
+     *
+     * @param phoneNumber - Phone number to link
+     * @param code - 6-digit verification code
+     */
+    linkPhoneVerify(phoneNumber: string, code: string): Promise<Auth.LinkPhoneVerifyResponse>;
+    /**
+     * Remove phone number from account
+     * DELETE /auth/phone
+     */
+    unlinkPhone(): Promise<Auth.UnlinkPhoneResponse>;
+    /**
+     * Delete account (soft delete - 30 day grace period)
+     * DELETE /auth/account
+     *
+     * Account is scheduled for permanent deletion after 30 days.
+     * User can reactivate by logging in within the grace period.
+     * Required for App Store compliance.
+     *
+     * @param reason - Optional reason for deletion (sent as query param)
+     */
+    deleteAccount(reason?: string): Promise<Auth.DeleteAccountResponse>;
+    /**
+     * Reactivate deleted account (within 30 day grace period)
+     * POST /auth/account/reactivate
+     */
+    reactivateAccount(): Promise<Auth.ReactivateAccountResponse>;
+    /**
+     * Export user data (GDPR compliance)
+     * GET /auth/privacy-export
+     *
+     * Returns all user data for GDPR data portability requirements.
+     */
+    exportUserData(): Promise<Auth.DataExportResponse>;
+    /**
+     * Get notification preferences
+     * GET /auth/notifications
+     */
+    getNotificationPreferences(): Promise<Auth.NotificationPreferencesResponse>;
+    /**
+     * Update notification preferences
+     * PATCH /auth/notifications
+     *
+     * @param preferences - Notification channels to enable/disable
+     */
+    updateNotificationPreferences(preferences: Auth.UpdateNotificationPreferencesRequest): Promise<Auth.NotificationPreferencesResponse>;
 }
 
 /**
@@ -2694,6 +2806,156 @@ declare class InsightsModule {
      * GET /v1/insights/youtube/all
      */
     getYouTubeAllInsights(): Promise<Insights.AllInsightsResponse>;
+    /**
+     * Instagram insights sub-module
+     */
+    instagram: {
+        /**
+         * Get all Instagram insights in one call
+         *
+         * Efficient for dashboard display - fetches all insights in parallel.
+         *
+         * @example
+         * ```typescript
+         * const all = await client.insights.instagram.getAll({ range: '30d' });
+         *
+         * // Check which insights are available
+         * if (all.data.health.hasData) {
+         *   console.log(`Health Score: ${all.data.health.data.overall}/100`);
+         * }
+         *
+         * if (all.data.bestPost.hasData) {
+         *   console.log(`Best Post: ${all.data.bestPost.data.post.caption}`);
+         * }
+         * ```
+         *
+         * GET /v1/insights/instagram
+         */
+        getAll: (params?: Insights.GetInstagramInsightParams) => Promise<Insights.InstagramAllInsightsResponse>;
+        /**
+         * Get Instagram health score
+         *
+         * Overall account health based on consistency, engagement, growth, and reach.
+         * Score ranges from 0-100 with labels: excellent, good, fair, needs_attention, poor.
+         *
+         * @example
+         * ```typescript
+         * const health = await client.insights.instagram.getHealthScore({ range: '30d' });
+         *
+         * if (health.hasData) {
+         *   console.log(`Score: ${health.data.overall}/100 (${health.data.label})`);
+         *   console.log(`Consistency: ${health.data.components.consistency.score}`);
+         *   console.log(`Engagement: ${health.data.components.engagement.score}`);
+         *   console.log(`Growth: ${health.data.components.growth.score}`);
+         *   console.log(`Reach: ${health.data.components.reach.score}`);
+         * }
+         * ```
+         *
+         * GET /v1/insights/instagram/health
+         */
+        getHealthScore: (params?: Insights.GetInstagramInsightParams) => Promise<Insights.InstagramHealthScoreResponse>;
+        /**
+         * Get best performing post
+         *
+         * Identifies the top performing post in the period based on engagement rate.
+         * Includes analysis of why it worked and comparison to average.
+         *
+         * @example
+         * ```typescript
+         * const best = await client.insights.instagram.getBestPost({ range: '30d' });
+         *
+         * if (best.hasData) {
+         *   console.log(`Post: ${best.data.post.caption}`);
+         *   console.log(`Engagement: ${best.data.post.metrics.engagementRate}%`);
+         *   console.log(`Above average: ${best.data.comparison.vsAverage.engagement}%`);
+         * }
+         * ```
+         *
+         * GET /v1/insights/instagram/best-post
+         */
+        getBestPost: (params?: Insights.GetInstagramInsightParams) => Promise<Insights.BestPerformingPostResponse>;
+        /**
+         * Get posting consistency analysis
+         *
+         * Analyzes posting frequency patterns and consistency.
+         * Identifies best posting days and gaps in schedule.
+         *
+         * @example
+         * ```typescript
+         * const consistency = await client.insights.instagram.getConsistency({ range: '90d' });
+         *
+         * if (consistency.hasData) {
+         *   console.log(`Posts/week: ${consistency.data.frequency.current.postsPerWeek}`);
+         *   console.log(`Score: ${consistency.data.consistency.score}/100`);
+         *   console.log(`Best day: ${consistency.data.patterns.mostActiveDay}`);
+         * }
+         * ```
+         *
+         * GET /v1/insights/instagram/consistency
+         */
+        getConsistency: (params?: Insights.GetInstagramInsightParams) => Promise<Insights.PostingConsistencyResponse>;
+        /**
+         * Get follower quality analysis
+         *
+         * Measures the quality and engagement of followers.
+         * Shows growth metrics and engagement rates.
+         *
+         * @example
+         * ```typescript
+         * const quality = await client.insights.instagram.getFollowerQuality({ range: '30d' });
+         *
+         * if (quality.hasData) {
+         *   console.log(`Quality: ${quality.data.qualityScore}/100`);
+         *   console.log(`Engagement rate: ${quality.data.metrics.engagementRate}%`);
+         *   console.log(`Growth: +${quality.data.growth.netChange} followers`);
+         * }
+         * ```
+         *
+         * GET /v1/insights/instagram/follower-quality
+         */
+        getFollowerQuality: (params?: Insights.GetInstagramInsightParams) => Promise<Insights.FollowerQualityResponse>;
+        /**
+         * Get account momentum
+         *
+         * Shows current account trajectory: surging, growing, stable, declining, or stalling.
+         * Compares recent performance to previous periods.
+         *
+         * @example
+         * ```typescript
+         * const momentum = await client.insights.instagram.getMomentum();
+         *
+         * if (momentum.hasData) {
+         *   console.log(`Status: ${momentum.data.current.status}`);
+         *   console.log(`Score: ${momentum.data.current.score}`);
+         *   console.log(`vs Last Week: ${momentum.data.comparison.vsLastWeek}%`);
+         * }
+         * ```
+         *
+         * GET /v1/insights/instagram/momentum
+         */
+        getMomentum: () => Promise<Insights.InstagramMomentumResponse>;
+        /**
+         * Get engagement breakdown
+         *
+         * Breaks down engagement by type: likes, comments, shares, saves.
+         * Identifies engagement style and opportunities.
+         *
+         * @example
+         * ```typescript
+         * const engagement = await client.insights.instagram.getEngagement({ range: '30d' });
+         *
+         * if (engagement.hasData) {
+         *   console.log(`Total: ${engagement.data.totalEngagement}`);
+         *   console.log(`Style: ${engagement.data.engagementStyle}`);
+         *   console.log(`Likes: ${engagement.data.breakdown.likes.percent}%`);
+         *   console.log(`Comments: ${engagement.data.breakdown.comments.percent}%`);
+         * }
+         * ```
+         *
+         * GET /v1/insights/instagram/engagement
+         */
+        getEngagement: (params?: Insights.GetInstagramInsightParams) => Promise<Insights.EngagementBreakdownResponse>;
+    };
 }
 
 /**