@olastudio/social-media-sdk 0.1.3 → 0.3.0

package/dist/{insights.types-DF2_r0L1.d.ts → insights.types-BCalhgkj.d.ts}

@@ -1,4 +1,4 @@
-import { R as RequestOptions } from './auth.types-DTXCyA56.js';
+import { R as RequestOptions } from './auth.types-Do2L11TO.js';
 
 /**
  * API Types - Interfaces for API clients

package/dist/{insights.types-5z7HJnbt.d.mts → insights.types-hLzNJATM.d.mts}

@@ -1,4 +1,4 @@
-import { R as RequestOptions } from './auth.types-DTXCyA56.mjs';
+import { R as RequestOptions } from './auth.types-Do2L11TO.mjs';
 
 /**
  * API Types - Interfaces for API clients

package/dist/providers/facebook/index.d.mts

@@ -1,5 +1,5 @@
-import { U as UserProfile, R as RequestOptions, c as AuthProvider, A as AuthResult } from '../../auth.types-DTXCyA56.mjs';
-import { A as APIClient, d as PageOverview, c as InsightsResponse, g as VideoInsights, i as ReelsInsights, f as PostInsights, k as PhotoInsights } from '../../insights.types-5z7HJnbt.mjs';
+import { A as APIClient, d as PageOverview, c as InsightsResponse, g as VideoInsights, i as ReelsInsights, f as PostInsights, k as PhotoInsights } from '../../insights.types-hLzNJATM.mjs';
+import { U as UserProfile, R as RequestOptions, A as AuthProvider, b as AuthResult } from '../../auth.types-Do2L11TO.mjs';
 
 /**
  * Facebook Types - Facebook-specific types
@@ -32,11 +32,11 @@ declare enum FacebookScopesBusiness {
     COMMERCE_ACCOUNT_READ_REPORTS = "commerce_account_read_reports",
     COMMERCE_ACCOUNT_READ_SETTINGS = "commerce_account_read_settings",
     COMMERCE_MANAGE_ACCOUNTS = "commerce_manage_accounts",
-    INSTAGRAM_BASIC = "instagram_basic",
-    INSTAGRAM_CONTENT_PUBLISH = "instagram_content_publish",
-    INSTAGRAM_MANAGE_COMMENTS = "instagram_manage_comments",
-    INSTAGRAM_MANAGE_INSIGHTS = "instagram_manage_insights",
-    INSTAGRAM_MANAGE_MESSAGES = "instagram_manage_messages",
+    INSTAGRAM_BASIC = "instagram_business_basic",
+    INSTAGRAM_CONTENT_PUBLISH = "instagram_business_content_publish",
+    INSTAGRAM_MANAGE_COMMENTS = "instagram_business_manage_comments",
+    INSTAGRAM_MANAGE_INSIGHTS = "instagram_business_manage_insights",
+    INSTAGRAM_MANAGE_MESSAGES = "instagram_business_manage_messages",
     INSTAGRAM_SHOPPING_TAG_PRODUCTS = "instagram_shopping_tag_products",
     LEADS_RETRIEVAL = "leads_retrieval",
     MANAGE_APP_SOLUTIONS = "manage_app_solutions",
@@ -385,6 +385,113 @@ declare class FacebookAPI implements APIClient {
      * Get current API version (read-only)
      */
     getApiVersion(): string;
+    /**
+     * 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
+     */
+    getPageConversations(pageId: string, options?: {
+        limit?: number;
+        after?: string;
+        fields?: string[];
+    }): Promise<{
+        data: Array<{
+            id: string;
+            participants: {
+                data: Array<{
+                    id: string;
+                    name: string;
+                    email?: string;
+                }>;
+            };
+            updated_time: string;
+            unread_count?: number;
+            snippet?: string;
+            can_reply?: boolean;
+            messages?: {
+                data: Array<{
+                    id: string;
+                    message: string;
+                    from: {
+                        id: string;
+                        name: string;
+                    };
+                    created_time: string;
+                }>;
+            };
+        }>;
+        paging?: {
+            cursors?: {
+                before?: string;
+                after?: string;
+            };
+            next?: string;
+        };
+    }>;
+    /**
+     * Get messages from a specific conversation
+     *
+     * @param conversationId - Conversation ID
+     * @param options - Pagination options
+     * @returns Paginated list of messages
+     */
+    getConversationMessages(conversationId: string, options?: {
+        limit?: number;
+        after?: string;
+        fields?: string[];
+    }): Promise<{
+        data: Array<{
+            id: string;
+            message: string;
+            from: {
+                id: string;
+                name: string;
+                email?: string;
+            };
+            to: {
+                data: Array<{
+                    id: string;
+                    name: string;
+                }>;
+            };
+            created_time: string;
+            attachments?: {
+                data: Array<{
+                    id: string;
+                    mime_type: string;
+                    name?: string;
+                    file_url?: string;
+                    image_data?: {
+                        url: string;
+                    };
+                }>;
+            };
+        }>;
+        paging?: {
+            cursors?: {
+                before?: string;
+                after?: string;
+            };
+            next?: string;
+        };
+    }>;
+    /**
+     * 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
+     */
+    sendMessage(pageId: string, recipientId: string, message: string, pageAccessToken?: string): Promise<{
+        recipient_id: string;
+        message_id: string;
+    }>;
 }
 
 /**

package/dist/providers/facebook/index.d.ts

@@ -1,5 +1,5 @@
-import { U as UserProfile, R as RequestOptions, c as AuthProvider, A as AuthResult } from '../../auth.types-DTXCyA56.js';
-import { A as APIClient, d as PageOverview, c as InsightsResponse, g as VideoInsights, i as ReelsInsights, f as PostInsights, k as PhotoInsights } from '../../insights.types-DF2_r0L1.js';
+import { A as APIClient, d as PageOverview, c as InsightsResponse, g as VideoInsights, i as ReelsInsights, f as PostInsights, k as PhotoInsights } from '../../insights.types-BCalhgkj.js';
+import { U as UserProfile, R as RequestOptions, A as AuthProvider, b as AuthResult } from '../../auth.types-Do2L11TO.js';
 
 /**
  * Facebook Types - Facebook-specific types
@@ -32,11 +32,11 @@ declare enum FacebookScopesBusiness {
     COMMERCE_ACCOUNT_READ_REPORTS = "commerce_account_read_reports",
     COMMERCE_ACCOUNT_READ_SETTINGS = "commerce_account_read_settings",
     COMMERCE_MANAGE_ACCOUNTS = "commerce_manage_accounts",
-    INSTAGRAM_BASIC = "instagram_basic",
-    INSTAGRAM_CONTENT_PUBLISH = "instagram_content_publish",
-    INSTAGRAM_MANAGE_COMMENTS = "instagram_manage_comments",
-    INSTAGRAM_MANAGE_INSIGHTS = "instagram_manage_insights",
-    INSTAGRAM_MANAGE_MESSAGES = "instagram_manage_messages",
+    INSTAGRAM_BASIC = "instagram_business_basic",
+    INSTAGRAM_CONTENT_PUBLISH = "instagram_business_content_publish",
+    INSTAGRAM_MANAGE_COMMENTS = "instagram_business_manage_comments",
+    INSTAGRAM_MANAGE_INSIGHTS = "instagram_business_manage_insights",
+    INSTAGRAM_MANAGE_MESSAGES = "instagram_business_manage_messages",
     INSTAGRAM_SHOPPING_TAG_PRODUCTS = "instagram_shopping_tag_products",
     LEADS_RETRIEVAL = "leads_retrieval",
     MANAGE_APP_SOLUTIONS = "manage_app_solutions",
@@ -385,6 +385,113 @@ declare class FacebookAPI implements APIClient {
      * Get current API version (read-only)
      */
     getApiVersion(): string;
+    /**
+     * 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
+     */
+    getPageConversations(pageId: string, options?: {
+        limit?: number;
+        after?: string;
+        fields?: string[];
+    }): Promise<{
+        data: Array<{
+            id: string;
+            participants: {
+                data: Array<{
+                    id: string;
+                    name: string;
+                    email?: string;
+                }>;
+            };
+            updated_time: string;
+            unread_count?: number;
+            snippet?: string;
+            can_reply?: boolean;
+            messages?: {
+                data: Array<{
+                    id: string;
+                    message: string;
+                    from: {
+                        id: string;
+                        name: string;
+                    };
+                    created_time: string;
+                }>;
+            };
+        }>;
+        paging?: {
+            cursors?: {
+                before?: string;
+                after?: string;
+            };
+            next?: string;
+        };
+    }>;
+    /**
+     * Get messages from a specific conversation
+     *
+     * @param conversationId - Conversation ID
+     * @param options - Pagination options
+     * @returns Paginated list of messages
+     */
+    getConversationMessages(conversationId: string, options?: {
+        limit?: number;
+        after?: string;
+        fields?: string[];
+    }): Promise<{
+        data: Array<{
+            id: string;
+            message: string;
+            from: {
+                id: string;
+                name: string;
+                email?: string;
+            };
+            to: {
+                data: Array<{
+                    id: string;
+                    name: string;
+                }>;
+            };
+            created_time: string;
+            attachments?: {
+                data: Array<{
+                    id: string;
+                    mime_type: string;
+                    name?: string;
+                    file_url?: string;
+                    image_data?: {
+                        url: string;
+                    };
+                }>;
+            };
+        }>;
+        paging?: {
+            cursors?: {
+                before?: string;
+                after?: string;
+            };
+            next?: string;
+        };
+    }>;
+    /**
+     * 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
+     */
+    sendMessage(pageId: string, recipientId: string, message: string, pageAccessToken?: string): Promise<{
+        recipient_id: string;
+        message_id: string;
+    }>;
 }
 
 /**

package/dist/providers/facebook/index.js

@@ -875,6 +875,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
@@ -1034,11 +1139,11 @@ var FacebookScopesBusiness = /* @__PURE__ */ ((FacebookScopesBusiness2) => {
   FacebookScopesBusiness2["COMMERCE_ACCOUNT_READ_REPORTS"] = "commerce_account_read_reports";
   FacebookScopesBusiness2["COMMERCE_ACCOUNT_READ_SETTINGS"] = "commerce_account_read_settings";
   FacebookScopesBusiness2["COMMERCE_MANAGE_ACCOUNTS"] = "commerce_manage_accounts";
-  FacebookScopesBusiness2["INSTAGRAM_BASIC"] = "instagram_basic";
-  FacebookScopesBusiness2["INSTAGRAM_CONTENT_PUBLISH"] = "instagram_content_publish";
-  FacebookScopesBusiness2["INSTAGRAM_MANAGE_COMMENTS"] = "instagram_manage_comments";
-  FacebookScopesBusiness2["INSTAGRAM_MANAGE_INSIGHTS"] = "instagram_manage_insights";
-  FacebookScopesBusiness2["INSTAGRAM_MANAGE_MESSAGES"] = "instagram_manage_messages";
+  FacebookScopesBusiness2["INSTAGRAM_BASIC"] = "instagram_business_basic";
+  FacebookScopesBusiness2["INSTAGRAM_CONTENT_PUBLISH"] = "instagram_business_content_publish";
+  FacebookScopesBusiness2["INSTAGRAM_MANAGE_COMMENTS"] = "instagram_business_manage_comments";
+  FacebookScopesBusiness2["INSTAGRAM_MANAGE_INSIGHTS"] = "instagram_business_manage_insights";
+  FacebookScopesBusiness2["INSTAGRAM_MANAGE_MESSAGES"] = "instagram_business_manage_messages";
   FacebookScopesBusiness2["INSTAGRAM_SHOPPING_TAG_PRODUCTS"] = "instagram_shopping_tag_products";
   FacebookScopesBusiness2["LEADS_RETRIEVAL"] = "leads_retrieval";
   FacebookScopesBusiness2["MANAGE_APP_SOLUTIONS"] = "manage_app_solutions";