@olastudio/social-media-sdk 0.3.0 → 0.3.2

package/dist/core/index.d.mts

@@ -1,5 +1,5 @@
-import { A as APIClient, H as HttpClientConfig } from '../insights.types-hLzNJATM.mjs';
-export { p as AggregatedInsights, E as INSIGHTS_PERIODS, y as INSTAGRAM_ACCOUNT_METRICS, z as INSTAGRAM_DEMOGRAPHICS_METRICS, B as INSTAGRAM_MEDIA_METRICS_COMMON, C as INSTAGRAM_REELS_METRICS, D as INSTAGRAM_STORIES_METRICS, b as InsightBreakdown, a as InsightDataItem, I as InsightValue, q as InsightsError, F as InsightsPeriod, c as InsightsResponse, l as InstagramAccountInsightsParams, n as InstagramAccountSummary, o as InstagramMediaInsights, m as InstagramMediaInsightsParams, M as METRIC_PRESETS, r as PAGE_METRICS_LIFETIME, s as PAGE_METRICS_PERIODIC, x as PHOTO_METRICS, t as POST_METRICS, P as PageInsightsParams, d as PageOverview, k as PhotoInsights, j as PhotoInsightsParams, f as PostInsights, e as PostInsightsParams, v as REELS_METRICS, w as REELS_METRICS_EXTENDED, i as ReelsInsights, R as ReelsInsightsParams, u as VIDEO_METRICS, g as VideoInsights, V as VideoInsightsParams, h as VideoWithInsights } from '../insights.types-hLzNJATM.mjs';
+import { A as APIClient, H as HttpClientConfig } from '../insights.types-BIXofwk0.mjs';
+export { a as AccountInfoResponse, s as AggregatedInsights, D as DebugTokenData, b as DebugTokenResponse, K as INSIGHTS_PERIODS, C as INSTAGRAM_ACCOUNT_METRICS, E as INSTAGRAM_DEMOGRAPHICS_METRICS, F as INSTAGRAM_MEDIA_METRICS_COMMON, G as INSTAGRAM_REELS_METRICS, J as INSTAGRAM_STORIES_METRICS, d as InsightBreakdown, c as InsightDataItem, I as InsightValue, t as InsightsError, L as InsightsPeriod, e as InsightsResponse, o as InstagramAccountInsightsParams, q as InstagramAccountSummary, r as InstagramMediaInsights, p as InstagramMediaInsightsParams, M as METRIC_PRESETS, u as PAGE_METRICS_LIFETIME, v as PAGE_METRICS_PERIODIC, B as PHOTO_METRICS, w as POST_METRICS, f as PageInsightsParams, g as PageOverview, P as PagePictureResponse, n as PhotoInsights, m as PhotoInsightsParams, i as PostInsights, h as PostInsightsParams, y as REELS_METRICS, z as REELS_METRICS_EXTENDED, l as ReelsInsights, R as ReelsInsightsParams, x as VIDEO_METRICS, j as VideoInsights, V as VideoInsightsParams, k as VideoWithInsights } from '../insights.types-BIXofwk0.mjs';
 import { R as RequestOptions } from '../auth.types-Do2L11TO.mjs';
 export { d as APIErrorData, A as AuthProvider, b as AuthResult, L as LoginConfig, O as OAuthConfig, a as OAuthResult, c as PaginatedResponse, P as ProviderName, U as UserProfile } from '../auth.types-Do2L11TO.mjs';
 

package/dist/core/index.d.ts

@@ -1,5 +1,5 @@
-import { A as APIClient, H as HttpClientConfig } from '../insights.types-BCalhgkj.js';
-export { p as AggregatedInsights, E as INSIGHTS_PERIODS, y as INSTAGRAM_ACCOUNT_METRICS, z as INSTAGRAM_DEMOGRAPHICS_METRICS, B as INSTAGRAM_MEDIA_METRICS_COMMON, C as INSTAGRAM_REELS_METRICS, D as INSTAGRAM_STORIES_METRICS, b as InsightBreakdown, a as InsightDataItem, I as InsightValue, q as InsightsError, F as InsightsPeriod, c as InsightsResponse, l as InstagramAccountInsightsParams, n as InstagramAccountSummary, o as InstagramMediaInsights, m as InstagramMediaInsightsParams, M as METRIC_PRESETS, r as PAGE_METRICS_LIFETIME, s as PAGE_METRICS_PERIODIC, x as PHOTO_METRICS, t as POST_METRICS, P as PageInsightsParams, d as PageOverview, k as PhotoInsights, j as PhotoInsightsParams, f as PostInsights, e as PostInsightsParams, v as REELS_METRICS, w as REELS_METRICS_EXTENDED, i as ReelsInsights, R as ReelsInsightsParams, u as VIDEO_METRICS, g as VideoInsights, V as VideoInsightsParams, h as VideoWithInsights } from '../insights.types-BCalhgkj.js';
+import { A as APIClient, H as HttpClientConfig } from '../insights.types-DBDsXg7x.js';
+export { a as AccountInfoResponse, s as AggregatedInsights, D as DebugTokenData, b as DebugTokenResponse, K as INSIGHTS_PERIODS, C as INSTAGRAM_ACCOUNT_METRICS, E as INSTAGRAM_DEMOGRAPHICS_METRICS, F as INSTAGRAM_MEDIA_METRICS_COMMON, G as INSTAGRAM_REELS_METRICS, J as INSTAGRAM_STORIES_METRICS, d as InsightBreakdown, c as InsightDataItem, I as InsightValue, t as InsightsError, L as InsightsPeriod, e as InsightsResponse, o as InstagramAccountInsightsParams, q as InstagramAccountSummary, r as InstagramMediaInsights, p as InstagramMediaInsightsParams, M as METRIC_PRESETS, u as PAGE_METRICS_LIFETIME, v as PAGE_METRICS_PERIODIC, B as PHOTO_METRICS, w as POST_METRICS, f as PageInsightsParams, g as PageOverview, P as PagePictureResponse, n as PhotoInsights, m as PhotoInsightsParams, i as PostInsights, h as PostInsightsParams, y as REELS_METRICS, z as REELS_METRICS_EXTENDED, l as ReelsInsights, R as ReelsInsightsParams, x as VIDEO_METRICS, j as VideoInsights, V as VideoInsightsParams, k as VideoWithInsights } from '../insights.types-DBDsXg7x.js';
 import { R as RequestOptions } from '../auth.types-Do2L11TO.js';
 export { d as APIErrorData, A as AuthProvider, b as AuthResult, L as LoginConfig, O as OAuthConfig, a as OAuthResult, c as PaginatedResponse, P as ProviderName, U as UserProfile } from '../auth.types-Do2L11TO.js';
 

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-export { A as APIClient, p as AggregatedInsights, H as HttpClientConfig, E as INSIGHTS_PERIODS, y as INSTAGRAM_ACCOUNT_METRICS, z as INSTAGRAM_DEMOGRAPHICS_METRICS, B as INSTAGRAM_MEDIA_METRICS_COMMON, C as INSTAGRAM_REELS_METRICS, D as INSTAGRAM_STORIES_METRICS, b as InsightBreakdown, a as InsightDataItem, I as InsightValue, q as InsightsError, F as InsightsPeriod, c as InsightsResponse, l as InstagramAccountInsightsParams, n as InstagramAccountSummary, o as InstagramMediaInsights, m as InstagramMediaInsightsParams, M as METRIC_PRESETS, r as PAGE_METRICS_LIFETIME, s as PAGE_METRICS_PERIODIC, x as PHOTO_METRICS, t as POST_METRICS, P as PageInsightsParams, d as PageOverview, k as PhotoInsights, j as PhotoInsightsParams, f as PostInsights, e as PostInsightsParams, v as REELS_METRICS, w as REELS_METRICS_EXTENDED, i as ReelsInsights, R as ReelsInsightsParams, u as VIDEO_METRICS, g as VideoInsights, V as VideoInsightsParams, h as VideoWithInsights } from './insights.types-hLzNJATM.mjs';
+export { A as APIClient, a as AccountInfoResponse, s as AggregatedInsights, D as DebugTokenData, b as DebugTokenResponse, H as HttpClientConfig, K as INSIGHTS_PERIODS, C as INSTAGRAM_ACCOUNT_METRICS, E as INSTAGRAM_DEMOGRAPHICS_METRICS, F as INSTAGRAM_MEDIA_METRICS_COMMON, G as INSTAGRAM_REELS_METRICS, J as INSTAGRAM_STORIES_METRICS, d as InsightBreakdown, c as InsightDataItem, I as InsightValue, t as InsightsError, L as InsightsPeriod, e as InsightsResponse, o as InstagramAccountInsightsParams, q as InstagramAccountSummary, r as InstagramMediaInsights, p as InstagramMediaInsightsParams, M as METRIC_PRESETS, u as PAGE_METRICS_LIFETIME, v as PAGE_METRICS_PERIODIC, B as PHOTO_METRICS, w as POST_METRICS, f as PageInsightsParams, g as PageOverview, P as PagePictureResponse, n as PhotoInsights, m as PhotoInsightsParams, i as PostInsights, h as PostInsightsParams, y as REELS_METRICS, z as REELS_METRICS_EXTENDED, l as ReelsInsights, R as ReelsInsightsParams, x as VIDEO_METRICS, j as VideoInsights, V as VideoInsightsParams, k as VideoWithInsights } from './insights.types-BIXofwk0.mjs';
 export { d as APIErrorData, A as AuthProvider, b as AuthResult, L as LoginConfig, O as OAuthConfig, a as OAuthResult, c as PaginatedResponse, P as ProviderName, R as RequestOptions, U as UserProfile } from './auth.types-Do2L11TO.mjs';
 export { APIError, AuthError, BaseError, Conversation, ConversationsResponse, FACEBOOK_GRAPH_API_BASE_URL, FACEBOOK_GRAPH_API_VERSION, FACEBOOK_OAUTH_AUTHORIZATION_URL, GetConversationsOptions, GetMessagesOptions, HttpClient, Message, MessageAttachment, MessagesResponse, MessagingParticipant, PagingCursors, SendMessageResponse } from './core/index.mjs';
 export { OAuthAdapter } from './adapters/index.mjs';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { A as APIClient, p as AggregatedInsights, H as HttpClientConfig, E as INSIGHTS_PERIODS, y as INSTAGRAM_ACCOUNT_METRICS, z as INSTAGRAM_DEMOGRAPHICS_METRICS, B as INSTAGRAM_MEDIA_METRICS_COMMON, C as INSTAGRAM_REELS_METRICS, D as INSTAGRAM_STORIES_METRICS, b as InsightBreakdown, a as InsightDataItem, I as InsightValue, q as InsightsError, F as InsightsPeriod, c as InsightsResponse, l as InstagramAccountInsightsParams, n as InstagramAccountSummary, o as InstagramMediaInsights, m as InstagramMediaInsightsParams, M as METRIC_PRESETS, r as PAGE_METRICS_LIFETIME, s as PAGE_METRICS_PERIODIC, x as PHOTO_METRICS, t as POST_METRICS, P as PageInsightsParams, d as PageOverview, k as PhotoInsights, j as PhotoInsightsParams, f as PostInsights, e as PostInsightsParams, v as REELS_METRICS, w as REELS_METRICS_EXTENDED, i as ReelsInsights, R as ReelsInsightsParams, u as VIDEO_METRICS, g as VideoInsights, V as VideoInsightsParams, h as VideoWithInsights } from './insights.types-BCalhgkj.js';
+export { A as APIClient, a as AccountInfoResponse, s as AggregatedInsights, D as DebugTokenData, b as DebugTokenResponse, H as HttpClientConfig, K as INSIGHTS_PERIODS, C as INSTAGRAM_ACCOUNT_METRICS, E as INSTAGRAM_DEMOGRAPHICS_METRICS, F as INSTAGRAM_MEDIA_METRICS_COMMON, G as INSTAGRAM_REELS_METRICS, J as INSTAGRAM_STORIES_METRICS, d as InsightBreakdown, c as InsightDataItem, I as InsightValue, t as InsightsError, L as InsightsPeriod, e as InsightsResponse, o as InstagramAccountInsightsParams, q as InstagramAccountSummary, r as InstagramMediaInsights, p as InstagramMediaInsightsParams, M as METRIC_PRESETS, u as PAGE_METRICS_LIFETIME, v as PAGE_METRICS_PERIODIC, B as PHOTO_METRICS, w as POST_METRICS, f as PageInsightsParams, g as PageOverview, P as PagePictureResponse, n as PhotoInsights, m as PhotoInsightsParams, i as PostInsights, h as PostInsightsParams, y as REELS_METRICS, z as REELS_METRICS_EXTENDED, l as ReelsInsights, R as ReelsInsightsParams, x as VIDEO_METRICS, j as VideoInsights, V as VideoInsightsParams, k as VideoWithInsights } from './insights.types-DBDsXg7x.js';
 export { d as APIErrorData, A as AuthProvider, b as AuthResult, L as LoginConfig, O as OAuthConfig, a as OAuthResult, c as PaginatedResponse, P as ProviderName, R as RequestOptions, U as UserProfile } from './auth.types-Do2L11TO.js';
 export { APIError, AuthError, BaseError, Conversation, ConversationsResponse, FACEBOOK_GRAPH_API_BASE_URL, FACEBOOK_GRAPH_API_VERSION, FACEBOOK_OAUTH_AUTHORIZATION_URL, GetConversationsOptions, GetMessagesOptions, HttpClient, Message, MessageAttachment, MessagesResponse, MessagingParticipant, PagingCursors, SendMessageResponse } from './core/index.js';
 export { OAuthAdapter } from './adapters/index.js';

package/dist/index.js

@@ -469,15 +469,17 @@ var FacebookAPI = class {
    * Uses Facebook's debug_token endpoint
    *
    * @param inputToken - The token to validate
-   * @param appAccessToken - App token (app_id|app_secret)
-   * @returns Token debug information
+   * @param appAccessToken - App token or access token for authentication (uses inputToken if not provided)
+   * @returns Token debug information including scopes and validity
    */
   async debugToken(inputToken, appAccessToken) {
     try {
-      return await this.get("/debug_token", {
+      const token = appAccessToken || inputToken;
+      const response = await this.get("/debug_token", {
         input_token: inputToken,
-        access_token: appAccessToken
+        access_token: token
       });
+      return response.data;
     } catch (error) {
       throw new APIError(
         `Failed to debug token: ${error instanceof Error ? error.message : "Unknown error"}`,
@@ -1056,6 +1058,67 @@ var FacebookAPI = class {
       );
     }
   }
+  // ============= Account & Token Methods =============
+  /**
+   * Get account info from the /me endpoint
+   * Returns different data depending on token type (user vs page)
+   * 
+   * @param accessToken - Optional access token (uses instance token if not provided)
+   * @returns Account info with id and name
+   */
+  async getAccountInfo(accessToken) {
+    try {
+      const token = accessToken || this.accessToken;
+      if (!token) {
+        throw new APIError("Access token is required", 401, "NO_TOKEN");
+      }
+      const response = await this.get("/me", {
+        access_token: token
+      });
+      return response;
+    } catch (error) {
+      throw new APIError(
+        `Failed to get account info: ${error instanceof Error ? error.message : "Unknown error"}`,
+        void 0,
+        "ACCOUNT_INFO_ERROR",
+        error
+      );
+    }
+  }
+  /**
+   * Get the profile picture URL for a Facebook Page
+   * 
+   * @param pageId - The Facebook Page ID
+   * @param type - Picture size: 'small', 'normal', 'large', 'square' (default: 'large')
+   * @returns The picture URL
+   */
+  async getPagePictureUrl(pageId, type = "large") {
+    try {
+      const response = await this.get(`/${pageId}/picture`, {
+        type,
+        redirect: "false"
+      });
+      return response.data.url;
+    } catch (error) {
+      throw new APIError(
+        `Failed to get page picture: ${error instanceof Error ? error.message : "Unknown error"}`,
+        void 0,
+        "PAGE_PICTURE_ERROR",
+        error
+      );
+    }
+  }
+  /**
+   * Build a static URL for page picture (no API call needed)
+   * Useful when you just need the URL without fetching metadata
+   * 
+   * @param pageId - The Facebook Page ID
+   * @param type - Picture size: 'small', 'normal', 'large', 'square' (default: 'large')
+   * @returns Static picture URL that redirects to the actual image
+   */
+  static buildPagePictureUrl(pageId, type = "large") {
+    return `${FACEBOOK_GRAPH_API_BASE_URL}/${pageId}/picture?type=${type}`;
+  }
 };
 
 // providers/facebook/auth/FacebookAuth.ts
@@ -1153,14 +1216,19 @@ var FacebookAuth = class {
    * Get authorization URL
    */
   getAuthorizationUrl(scopes, redirectUri, state) {
+    if (!this.config.appId) {
+      throw new AuthError("appId is required for authorization", "MISSING_APP_ID");
+    }
     const params = new URLSearchParams({
       client_id: this.config.appId,
       redirect_uri: redirectUri,
       scope: scopes.join(","),
       response_type: "token",
-      display: "popup",
-      ...state && { state }
+      display: "popup"
     });
+    if (state) {
+      params.set("state", state);
+    }
     return `${FACEBOOK_OAUTH_AUTHORIZATION_URL}?${params.toString()}`;
   }
   /**
@@ -1215,11 +1283,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_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_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_SHOPPING_TAG_PRODUCTS"] = "instagram_shopping_tag_products";
   FacebookScopesBusiness2["LEADS_RETRIEVAL"] = "leads_retrieval";
   FacebookScopesBusiness2["MANAGE_APP_SOLUTIONS"] = "manage_app_solutions";
@@ -1985,6 +2053,33 @@ var InstagramAPI = class {
       );
     }
   }
+  // ============= Account Methods =============
+  /**
+   * Get account info from the /me endpoint
+   * Returns the account associated with the current access token
+   * 
+   * @param accessToken - Optional access token (uses instance token if not provided)
+   * @returns Account info with id and name
+   */
+  async getAccountInfo(accessToken) {
+    try {
+      const token = accessToken || this.accessToken;
+      if (!token) {
+        throw new APIError("Access token is required", 401, "NO_TOKEN");
+      }
+      const response = await this.get("/me", {
+        access_token: token
+      });
+      return response;
+    } catch (error) {
+      throw new APIError(
+        `Failed to get account info: ${error instanceof Error ? error.message : "Unknown error"}`,
+        void 0,
+        "ACCOUNT_INFO_ERROR",
+        error
+      );
+    }
+  }
 };
 
 // providers/instagram/InstagramProvider.ts