@dracoonghost/trndup-sdk 1.5.2 → 1.5.4

package/dist/index.d.mts

@@ -135,9 +135,10 @@ declare namespace Auth {
      */
     interface PlatformStatus {
         hasConnectedPlatforms: boolean;
-        connectedPlatforms: Array<'youtube' | 'instagram'>;
+        connectedPlatforms: Array<'youtube' | 'instagram' | 'facebook'>;
         youtube: PlatformSyncInfo;
         instagram: PlatformSyncInfo;
+        facebook: PlatformSyncInfo;
     }
     interface LinkPhoneSendOTPRequest {
         phoneNumber: string;
@@ -2431,6 +2432,169 @@ declare class InstagramModule {
     sync(): Promise<Instagram.SyncResponse>;
 }
 
+/**
+ * TrndUp SDK - Facebook Module
+ *
+ * Facebook Page analytics and data methods
+ */
+
+interface FacebookPageProfile {
+    id: string;
+    name: string;
+    about?: string;
+    category?: string;
+    profilePictureUrl?: string;
+    coverPhotoUrl?: string;
+    followersCount?: number;
+    fanCount?: number;
+    website?: string;
+    isVerified?: boolean;
+}
+interface FacebookPost {
+    id: string;
+    message?: string;
+    story?: string;
+    fullPicture?: string;
+    permalinkUrl: string;
+    reactionsCount: number;
+    commentsCount: number;
+    sharesCount: number;
+    createdTime: string;
+    postType?: string;
+    statusType?: string;
+    attachments?: Array<{
+        type: string;
+        title?: string;
+        description?: string;
+        imageUrl?: string;
+        url?: string;
+    }>;
+}
+interface FacebookStats {
+    range: string;
+    pageViews: number;
+    pageImpressions: number;
+    pageImpressionsUnique: number;
+    pageEngagedUsers: number;
+    pagePostEngagements: number;
+    pageFanAdds: number;
+    pageFanRemoves: number;
+    netFanChange: number;
+}
+interface FacebookInitResponse {
+    success: boolean;
+    data?: {
+        needsInit: boolean;
+        message: string;
+        page?: FacebookPageProfile;
+        syncedPosts?: number;
+        lastSyncedAt?: string;
+    };
+    error?: string;
+    code?: string;
+}
+interface FacebookInitStatusResponse {
+    success: boolean;
+    data?: {
+        connected: boolean;
+        needsInit: boolean;
+        isInitialSyncDone?: boolean;
+        lastSyncedAt?: string;
+        page?: {
+            pageId: string;
+            pageName?: string;
+            profilePictureUrl?: string;
+            followersCount?: number;
+            fanCount?: number;
+        };
+        syncedPostsCount?: number;
+    };
+    error?: string;
+}
+interface FacebookPageResponse {
+    success: boolean;
+    data?: FacebookPageProfile & {
+        cached?: boolean;
+        cachedAt?: string;
+    };
+    error?: string;
+}
+interface FacebookAccountOverviewResponse {
+    success: boolean;
+    data?: {
+        page: FacebookPageProfile;
+        stats: FacebookStats;
+        topPosts: FacebookPost[];
+        syncedPostsCount: number;
+    };
+    error?: string;
+    code?: string;
+}
+interface FacebookPostsResponse {
+    success: boolean;
+    data?: {
+        posts: FacebookPost[];
+        pagination: {
+            limit: number;
+            offset: number;
+            total: number;
+            hasMore: boolean;
+        };
+    };
+    error?: string;
+}
+declare class FacebookModule {
+    private client;
+    constructor(client: TrndUpClient);
+    /**
+     * Initialize Facebook Page data sync
+     * GET /v1/platforms/facebook/init
+     *
+     * Fetches page profile and recent posts, stores in database.
+     * Call this when user first accesses Facebook dashboard.
+     */
+    init(): Promise<FacebookInitResponse>;
+    /**
+     * Get Facebook initialization status
+     * GET /v1/platforms/facebook/status/init
+     *
+     * Check if Facebook is connected and if initial sync is done.
+     */
+    getInitStatus(): Promise<FacebookInitStatusResponse>;
+    /**
+     * Get Facebook Page profile
+     * GET /v1/platforms/facebook/page
+     *
+     * Returns cached data if less than 1 hour old, else fetches fresh.
+     */
+    getPage(): Promise<FacebookPageResponse>;
+    /**
+     * Get account overview for dashboard
+     * GET /v1/platforms/facebook/account/overview
+     *
+     * Returns page profile, aggregated stats, and top posts.
+     * @param range Time range: '7d', '14d', '30d' (default '7d')
+     */
+    getAccountOverview(params?: {
+        range?: string;
+    }): Promise<FacebookAccountOverviewResponse>;
+    /**
+     * Get Facebook Page posts
+     * GET /v1/platforms/facebook/posts
+     *
+     * @param options.limit Number of posts to return (default 20)
+     * @param options.offset Offset for pagination (default 0)
+     * @param options.sortBy Sort by field: 'createdTime', 'reactionsCount', 'commentsCount'
+     * @param options.sortOrder Sort order: 'asc', 'desc'
+     */
+    getPosts(options?: {
+        limit?: number;
+        offset?: number;
+        sortBy?: 'createdTime' | 'reactionsCount' | 'commentsCount';
+        sortOrder?: 'asc' | 'desc';
+    }): Promise<FacebookPostsResponse>;
+}
+
 /**
  * TrndUp SDK - Social Module
  *
@@ -3165,6 +3329,7 @@ declare class TrndUpSDK extends TrndUpClient {
     auth: AuthModule;
     youtube: YouTubeModule;
     instagram: InstagramModule;
+    facebook: FacebookModule;
     social: SocialModule;
     insights: InsightsModule;
     activity: ActivityModule;

package/dist/index.d.ts

@@ -135,9 +135,10 @@ declare namespace Auth {
      */
     interface PlatformStatus {
         hasConnectedPlatforms: boolean;
-        connectedPlatforms: Array<'youtube' | 'instagram'>;
+        connectedPlatforms: Array<'youtube' | 'instagram' | 'facebook'>;
         youtube: PlatformSyncInfo;
         instagram: PlatformSyncInfo;
+        facebook: PlatformSyncInfo;
     }
     interface LinkPhoneSendOTPRequest {
         phoneNumber: string;
@@ -2431,6 +2432,169 @@ declare class InstagramModule {
     sync(): Promise<Instagram.SyncResponse>;
 }
 
+/**
+ * TrndUp SDK - Facebook Module
+ *
+ * Facebook Page analytics and data methods
+ */
+
+interface FacebookPageProfile {
+    id: string;
+    name: string;
+    about?: string;
+    category?: string;
+    profilePictureUrl?: string;
+    coverPhotoUrl?: string;
+    followersCount?: number;
+    fanCount?: number;
+    website?: string;
+    isVerified?: boolean;
+}
+interface FacebookPost {
+    id: string;
+    message?: string;
+    story?: string;
+    fullPicture?: string;
+    permalinkUrl: string;
+    reactionsCount: number;
+    commentsCount: number;
+    sharesCount: number;
+    createdTime: string;
+    postType?: string;
+    statusType?: string;
+    attachments?: Array<{
+        type: string;
+        title?: string;
+        description?: string;
+        imageUrl?: string;
+        url?: string;
+    }>;
+}
+interface FacebookStats {
+    range: string;
+    pageViews: number;
+    pageImpressions: number;
+    pageImpressionsUnique: number;
+    pageEngagedUsers: number;
+    pagePostEngagements: number;
+    pageFanAdds: number;
+    pageFanRemoves: number;
+    netFanChange: number;
+}
+interface FacebookInitResponse {
+    success: boolean;
+    data?: {
+        needsInit: boolean;
+        message: string;
+        page?: FacebookPageProfile;
+        syncedPosts?: number;
+        lastSyncedAt?: string;
+    };
+    error?: string;
+    code?: string;
+}
+interface FacebookInitStatusResponse {
+    success: boolean;
+    data?: {
+        connected: boolean;
+        needsInit: boolean;
+        isInitialSyncDone?: boolean;
+        lastSyncedAt?: string;
+        page?: {
+            pageId: string;
+            pageName?: string;
+            profilePictureUrl?: string;
+            followersCount?: number;
+            fanCount?: number;
+        };
+        syncedPostsCount?: number;
+    };
+    error?: string;
+}
+interface FacebookPageResponse {
+    success: boolean;
+    data?: FacebookPageProfile & {
+        cached?: boolean;
+        cachedAt?: string;
+    };
+    error?: string;
+}
+interface FacebookAccountOverviewResponse {
+    success: boolean;
+    data?: {
+        page: FacebookPageProfile;
+        stats: FacebookStats;
+        topPosts: FacebookPost[];
+        syncedPostsCount: number;
+    };
+    error?: string;
+    code?: string;
+}
+interface FacebookPostsResponse {
+    success: boolean;
+    data?: {
+        posts: FacebookPost[];
+        pagination: {
+            limit: number;
+            offset: number;
+            total: number;
+            hasMore: boolean;
+        };
+    };
+    error?: string;
+}
+declare class FacebookModule {
+    private client;
+    constructor(client: TrndUpClient);
+    /**
+     * Initialize Facebook Page data sync
+     * GET /v1/platforms/facebook/init
+     *
+     * Fetches page profile and recent posts, stores in database.
+     * Call this when user first accesses Facebook dashboard.
+     */
+    init(): Promise<FacebookInitResponse>;
+    /**
+     * Get Facebook initialization status
+     * GET /v1/platforms/facebook/status/init
+     *
+     * Check if Facebook is connected and if initial sync is done.
+     */
+    getInitStatus(): Promise<FacebookInitStatusResponse>;
+    /**
+     * Get Facebook Page profile
+     * GET /v1/platforms/facebook/page
+     *
+     * Returns cached data if less than 1 hour old, else fetches fresh.
+     */
+    getPage(): Promise<FacebookPageResponse>;
+    /**
+     * Get account overview for dashboard
+     * GET /v1/platforms/facebook/account/overview
+     *
+     * Returns page profile, aggregated stats, and top posts.
+     * @param range Time range: '7d', '14d', '30d' (default '7d')
+     */
+    getAccountOverview(params?: {
+        range?: string;
+    }): Promise<FacebookAccountOverviewResponse>;
+    /**
+     * Get Facebook Page posts
+     * GET /v1/platforms/facebook/posts
+     *
+     * @param options.limit Number of posts to return (default 20)
+     * @param options.offset Offset for pagination (default 0)
+     * @param options.sortBy Sort by field: 'createdTime', 'reactionsCount', 'commentsCount'
+     * @param options.sortOrder Sort order: 'asc', 'desc'
+     */
+    getPosts(options?: {
+        limit?: number;
+        offset?: number;
+        sortBy?: 'createdTime' | 'reactionsCount' | 'commentsCount';
+        sortOrder?: 'asc' | 'desc';
+    }): Promise<FacebookPostsResponse>;
+}
+
 /**
  * TrndUp SDK - Social Module
  *
@@ -3165,6 +3329,7 @@ declare class TrndUpSDK extends TrndUpClient {
     auth: AuthModule;
     youtube: YouTubeModule;
     instagram: InstagramModule;
+    facebook: FacebookModule;
     social: SocialModule;
     insights: InsightsModule;
     activity: ActivityModule;

package/dist/index.js

@@ -777,6 +777,78 @@ var InstagramModule = class {
   }
 };
 
+// modules/facebook.ts
+var FacebookModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  // ===== INITIALIZATION =====
+  /**
+   * Initialize Facebook Page data sync
+   * GET /v1/platforms/facebook/init
+   * 
+   * Fetches page profile and recent posts, stores in database.
+   * Call this when user first accesses Facebook dashboard.
+   */
+  async init() {
+    return this.client.get("/v1/platforms/facebook/init");
+  }
+  /**
+   * Get Facebook initialization status
+   * GET /v1/platforms/facebook/status/init
+   * 
+   * Check if Facebook is connected and if initial sync is done.
+   */
+  async getInitStatus() {
+    return this.client.get("/v1/platforms/facebook/status/init");
+  }
+  // ===== PAGE PROFILE =====
+  /**
+   * Get Facebook Page profile
+   * GET /v1/platforms/facebook/page
+   * 
+   * Returns cached data if less than 1 hour old, else fetches fresh.
+   */
+  async getPage() {
+    return this.client.get("/v1/platforms/facebook/page");
+  }
+  // ===== ACCOUNT OVERVIEW =====
+  /**
+   * Get account overview for dashboard
+   * GET /v1/platforms/facebook/account/overview
+   * 
+   * Returns page profile, aggregated stats, and top posts.
+   * @param range Time range: '7d', '14d', '30d' (default '7d')
+   */
+  async getAccountOverview(params) {
+    const queryParams = params?.range ? `?range=${params.range}` : "";
+    return this.client.get(
+      `/v1/platforms/facebook/account/overview${queryParams}`
+    );
+  }
+  // ===== POSTS =====
+  /**
+   * Get Facebook Page posts
+   * GET /v1/platforms/facebook/posts
+   * 
+   * @param options.limit Number of posts to return (default 20)
+   * @param options.offset Offset for pagination (default 0)
+   * @param options.sortBy Sort by field: 'createdTime', 'reactionsCount', 'commentsCount'
+   * @param options.sortOrder Sort order: 'asc', 'desc'
+   */
+  async getPosts(options) {
+    const params = new URLSearchParams();
+    if (options?.limit) params.append("limit", String(options.limit));
+    if (options?.offset) params.append("offset", String(options.offset));
+    if (options?.sortBy) params.append("sortBy", options.sortBy);
+    if (options?.sortOrder) params.append("sortOrder", options.sortOrder);
+    const queryString = params.toString();
+    return this.client.get(
+      `/v1/platforms/facebook/posts${queryString ? `?${queryString}` : ""}`
+    );
+  }
+};
+
 // modules/social.ts
 var SocialModule = class {
   constructor(client) {
@@ -1653,6 +1725,7 @@ var TrndUpSDK = class extends TrndUpClient {
     this.auth = new AuthModule(this);
     this.youtube = new YouTubeModule(this);
     this.instagram = new InstagramModule(this);
+    this.facebook = new FacebookModule(this);
     this.social = new SocialModule(this);
     this.insights = new InsightsModule(this);
     this.activity = new ActivityModule(this);