@olastudio/social-media-sdk 0.1.2 → 0.2.0

package/dist/index.mjs

@@ -949,6 +949,111 @@ var FacebookAPI = class {
   getApiVersion() {
     return FACEBOOK_GRAPH_API_VERSION;
   }
+  // ============= Messaging Methods =============
+  /**
+   * Get conversations (inbox) for a Facebook Page
+   * Requires `pages_messaging` permission
+   * 
+   * @param pageId - Facebook Page ID
+   * @param options - Pagination and field options
+   * @returns Paginated list of conversations
+   */
+  async getPageConversations(pageId, options = {}) {
+    try {
+      const defaultFields = [
+        "id",
+        "participants",
+        "updated_time",
+        "unread_count",
+        "snippet",
+        "can_reply",
+        "messages.limit(1){id,message,from,created_time}"
+      ];
+      const params = {
+        fields: (options.fields || defaultFields).join(","),
+        limit: options.limit || 25
+      };
+      if (options.after) {
+        params.after = options.after;
+      }
+      const response = await this.get(`/${pageId}/conversations`, params);
+      return response;
+    } catch (error) {
+      throw new APIError(
+        `Failed to fetch page conversations: ${error instanceof Error ? error.message : "Unknown error"}`,
+        void 0,
+        "CONVERSATIONS_FETCH_ERROR",
+        error
+      );
+    }
+  }
+  /**
+   * Get messages from a specific conversation
+   * 
+   * @param conversationId - Conversation ID
+   * @param options - Pagination options
+   * @returns Paginated list of messages
+   */
+  async getConversationMessages(conversationId, options = {}) {
+    try {
+      const defaultFields = [
+        "id",
+        "message",
+        "from",
+        "to",
+        "created_time",
+        "attachments"
+      ];
+      const params = {
+        fields: (options.fields || defaultFields).join(","),
+        limit: options.limit || 25
+      };
+      if (options.after) {
+        params.after = options.after;
+      }
+      const response = await this.get(`/${conversationId}/messages`, params);
+      return response;
+    } catch (error) {
+      throw new APIError(
+        `Failed to fetch conversation messages: ${error instanceof Error ? error.message : "Unknown error"}`,
+        void 0,
+        "MESSAGES_FETCH_ERROR",
+        error
+      );
+    }
+  }
+  /**
+   * Send a message in a conversation
+   * Uses the Send API for Page messaging
+   * 
+   * @param pageId - Facebook Page ID
+   * @param recipientId - PSID (Page-Scoped User ID) of the recipient
+   * @param message - Message text to send
+   * @param pageAccessToken - Page access token with messaging permission
+   * @returns Message send response
+   */
+  async sendMessage(pageId, recipientId, message, pageAccessToken) {
+    try {
+      const body = {
+        recipient: { id: recipientId },
+        message: { text: message },
+        messaging_type: "RESPONSE",
+        access_token: pageAccessToken || this.accessToken
+      };
+      const response = await this.post(
+        `/${pageId}/messages`,
+        body
+      );
+      return response;
+    } catch (error) {
+      throw new APIError(
+        `Failed to send message: ${error instanceof Error ? error.message : "Unknown error"}`,
+        void 0,
+        "MESSAGE_SEND_ERROR",
+        error
+      );
+    }
+  }
 };
 
 // providers/facebook/auth/FacebookAuth.ts
@@ -1511,6 +1616,31 @@ var InstagramAPI = class {
       );
     }
   }
+  /**
+   * Get comments for a media item
+   * @param mediaId - Media ID
+   * @param limit - Max number of comments to fetch (default: 25)
+   * @returns Array of comments
+   */
+  async getMediaComments(mediaId, limit = 25) {
+    try {
+      const response = await this.get(
+        `/${mediaId}/comments`,
+        {
+          fields: "id,text,timestamp,username,like_count,from{id,username},replies{id,text,timestamp,username,like_count}",
+          limit
+        }
+      );
+      return response.data || [];
+    } catch (error) {
+      throw new APIError(
+        `Failed to fetch comments: ${error instanceof Error ? error.message : "Unknown error"}`,
+        void 0,
+        "COMMENTS_FETCH_ERROR",
+        error
+      );
+    }
+  }
   /**
    * Get Instagram account insights
    */
@@ -1754,6 +1884,105 @@ var InstagramAPI = class {
   getApiVersion() {
     return FACEBOOK_GRAPH_API_VERSION;
   }
+  // ============= Messaging Methods =============
+  /**
+   * Get conversations (inbox) for an Instagram Professional account
+   * Requires `instagram_manage_messages` permission
+   * 
+   * @param instagramAccountId - Instagram Business/Creator Account ID
+   * @param options - Pagination and field options
+   * @returns Paginated list of conversations
+   */
+  async getConversations(instagramAccountId, options = {}) {
+    try {
+      const defaultFields = [
+        "id",
+        "participants",
+        "updated_time",
+        "messages.limit(1){id,message,from,created_time}"
+      ];
+      const params = {
+        fields: (options.fields || defaultFields).join(","),
+        limit: options.limit || 25
+      };
+      if (options.after) {
+        params.after = options.after;
+      }
+      const response = await this.get(`/${instagramAccountId}/conversations`, params);
+      return response;
+    } catch (error) {
+      throw new APIError(
+        `Failed to fetch Instagram conversations: ${error instanceof Error ? error.message : "Unknown error"}`,
+        void 0,
+        "CONVERSATIONS_FETCH_ERROR",
+        error
+      );
+    }
+  }
+  /**
+   * Get messages from a specific Instagram conversation
+   * 
+   * @param conversationId - Conversation ID
+   * @param options - Pagination options
+   * @returns Paginated list of messages
+   */
+  async getConversationMessages(conversationId, options = {}) {
+    try {
+      const defaultFields = [
+        "id",
+        "message",
+        "from",
+        "to",
+        "created_time",
+        "attachments"
+      ];
+      const params = {
+        fields: (options.fields || defaultFields).join(","),
+        limit: options.limit || 25
+      };
+      if (options.after) {
+        params.after = options.after;
+      }
+      const response = await this.get(`/${conversationId}/messages`, params);
+      return response;
+    } catch (error) {
+      throw new APIError(
+        `Failed to fetch Instagram messages: ${error instanceof Error ? error.message : "Unknown error"}`,
+        void 0,
+        "MESSAGES_FETCH_ERROR",
+        error
+      );
+    }
+  }
+  /**
+   * Send a message to an Instagram user
+   * Uses the Instagram Send API
+   * 
+   * @param instagramAccountId - Instagram Business/Creator Account ID
+   * @param recipientId - Instagram-scoped ID of the recipient
+   * @param message - Message text to send
+   * @returns Message send response
+   */
+  async sendMessage(instagramAccountId, recipientId, message) {
+    try {
+      const body = {
+        recipient: { id: recipientId },
+        message: { text: message }
+      };
+      const response = await this.post(
+        `/${instagramAccountId}/messages`,
+        body
+      );
+      return response;
+    } catch (error) {
+      throw new APIError(
+        `Failed to send Instagram message: ${error instanceof Error ? error.message : "Unknown error"}`,
+        void 0,
+        "MESSAGE_SEND_ERROR",
+        error
+      );
+    }
+  }
 };
 
 // providers/instagram/InstagramProvider.ts