@memberjunction/actions-bizapps-social 2.61.0

package/dist/providers/facebook/facebook-base.action.d.ts

@@ -0,0 +1,230 @@
+import { BaseSocialMediaAction, MediaFile, SocialPost, SearchParams, SocialAnalytics } from '../../base/base-social.action';
+import { AxiosInstance, AxiosError } from 'axios';
+import { ActionResultSimple, RunActionParams } from '@memberjunction/actions-base';
+/**
+ * Base class for all Facebook actions.
+ * Handles Facebook-specific authentication, API interactions, and rate limiting.
+ * Uses Facebook Graph API v18.0 with OAuth 2.0.
+ */
+export declare abstract class FacebookBaseAction extends BaseSocialMediaAction {
+    /**
+     * Internal method that must be implemented by derived action classes
+     */
+    protected abstract InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    protected get platformName(): string;
+    protected get apiBaseUrl(): string;
+    /**
+     * API version for cleaner URL building
+     */
+    protected get apiVersion(): string;
+    /**
+     * Axios instance for making HTTP requests
+     */
+    private _axiosInstance;
+    /**
+     * Get or create axios instance with interceptors
+     */
+    protected get axiosInstance(): AxiosInstance;
+    /**
+     * Check if error is a Facebook rate limit error
+     */
+    private isFacebookRateLimitError;
+    /**
+     * Extract wait time from Facebook rate limit error
+     */
+    private extractRateLimitWaitTime;
+    /**
+     * Refresh the access token using the refresh token
+     * Note: Facebook uses long-lived tokens that last 60 days
+     */
+    protected refreshAccessToken(): Promise<void>;
+    /**
+     * Get the authenticated user's pages
+     */
+    protected getUserPages(): Promise<FacebookPage[]>;
+    /**
+     * Get page access token for a specific page
+     */
+    protected getPageAccessToken(pageId: string): Promise<string>;
+    /**
+     * Upload media to Facebook
+     */
+    protected uploadSingleMedia(file: MediaFile): Promise<string>;
+    /**
+     * Upload media to a specific page
+     */
+    protected uploadMediaToPage(pageId: string, file: MediaFile): Promise<string>;
+    /**
+     * Validate media file meets Facebook requirements
+     */
+    protected validateMediaFile(file: MediaFile): void;
+    /**
+     * Create a post on Facebook
+     */
+    protected createPost(pageId: string, postData: CreatePostData): Promise<FacebookPost>;
+    /**
+     * Get a specific post
+     */
+    protected getPost(postId: string): Promise<FacebookPost>;
+    /**
+     * Get posts from a page
+     */
+    protected getPagePosts(pageId: string, params?: GetPagePostsParams): Promise<FacebookPost[]>;
+    /**
+     * Get paginated results from Facebook
+     */
+    protected getPaginatedResults<T>(url: string, params?: Record<string, any>, maxResults?: number): Promise<T[]>;
+    /**
+     * Get default fields for post queries
+     */
+    protected getPostFields(): string;
+    /**
+     * Convert Facebook post to common format
+     */
+    protected normalizePost(fbPost: FacebookPost): SocialPost;
+    /**
+     * Extract analytics from Facebook post
+     */
+    private extractPostAnalytics;
+    /**
+     * Normalize Facebook analytics to common format
+     */
+    protected normalizeAnalytics(fbMetrics: any): SocialAnalytics;
+    /**
+     * Search for posts - implemented in search action
+     */
+    protected searchPosts(params: SearchParams): Promise<SocialPost[]>;
+    /**
+     * Handle Facebook-specific errors
+     */
+    protected handleFacebookError(error: AxiosError): never;
+    /**
+     * Parse Facebook-specific rate limit headers
+     */
+    protected parseRateLimitHeaders(headers: any): {
+        remaining: number;
+        reset: Date;
+        limit: number;
+    } | null;
+}
+/**
+ * Facebook-specific interfaces
+ */
+export interface FacebookPage {
+    id: string;
+    name: string;
+    access_token: string;
+    category: string;
+    picture?: {
+        data: {
+            url: string;
+        };
+    };
+}
+export interface CreatePostData {
+    message?: string;
+    link?: string;
+    place?: string;
+    tags?: string[];
+    privacy?: {
+        value: 'EVERYONE' | 'ALL_FRIENDS' | 'FRIENDS_OF_FRIENDS' | 'SELF';
+    };
+    attached_media?: Array<{
+        media_fbid: string;
+    }>;
+    scheduled_publish_time?: number;
+    published?: boolean;
+    backdated_time?: number;
+    backdated_time_granularity?: 'year' | 'month' | 'day' | 'hour' | 'minute';
+}
+export interface FacebookPost {
+    id: string;
+    message?: string;
+    story?: string;
+    created_time: string;
+    updated_time: string;
+    from?: {
+        id: string;
+        name: string;
+    };
+    permalink_url?: string;
+    attachments?: {
+        data: Array<{
+            type: string;
+            title?: string;
+            description?: string;
+            url?: string;
+            media?: {
+                image?: {
+                    src: string;
+                    width: number;
+                    height: number;
+                };
+                source?: string;
+            };
+        }>;
+    };
+    shares?: {
+        count: number;
+    };
+    reactions?: {
+        summary: {
+            total_count: number;
+        };
+    };
+    comments?: {
+        summary: {
+            total_count: number;
+        };
+    };
+    insights?: {
+        data: Array<{
+            name: string;
+            values: Array<{
+                value: number;
+            }>;
+        }>;
+    };
+}
+export interface GetPagePostsParams {
+    since?: Date;
+    until?: Date;
+    limit?: number;
+    published?: boolean;
+}
+export interface FacebookInsight {
+    name: string;
+    period: string;
+    values: Array<{
+        value: number | Record<string, number>;
+        end_time?: string;
+    }>;
+    title?: string;
+    description?: string;
+}
+export interface FacebookComment {
+    id: string;
+    message: string;
+    created_time: string;
+    from: {
+        id: string;
+        name: string;
+    };
+    like_count: number;
+    comment_count?: number;
+    parent?: {
+        id: string;
+    };
+}
+export interface FacebookAlbum {
+    id: string;
+    name: string;
+    description?: string;
+    link: string;
+    cover_photo?: {
+        id: string;
+    };
+    count: number;
+    created_time: string;
+}
+//# sourceMappingURL=facebook-base.action.d.ts.map

package/dist/providers/facebook/facebook-base.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facebook-base.action.d.ts","sourceRoot":"","sources":["../../../src/providers/facebook/facebook-base.action.ts"],"names":[],"mappings":"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"}