@memberjunction/actions-bizapps-social 2.61.0

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

@@ -0,0 +1,185 @@
+import { BaseSocialMediaAction, MediaFile, SocialPost, SearchParams, SocialAnalytics } from '../../base/base-social.action';
+import { AxiosInstance, AxiosError } from 'axios';
+/**
+ * Base class for all Twitter/X actions.
+ * Handles Twitter-specific authentication, API interactions, and rate limiting.
+ * Uses Twitter API v2 with OAuth 2.0.
+ */
+export declare abstract class TwitterBaseAction extends BaseSocialMediaAction {
+    protected get platformName(): string;
+    protected get apiBaseUrl(): string;
+    /**
+     * Upload endpoint for media
+     */
+    protected get uploadApiUrl(): string;
+    /**
+     * Axios instance for making HTTP requests
+     */
+    private _axiosInstance;
+    /**
+     * Get or create axios instance with interceptors
+     */
+    protected get axiosInstance(): AxiosInstance;
+    /**
+     * Refresh the access token using the refresh token
+     */
+    protected refreshAccessToken(): Promise<void>;
+    /**
+     * Get the authenticated user's info
+     */
+    protected getCurrentUser(): Promise<TwitterUser>;
+    /**
+     * Upload media to Twitter
+     */
+    protected uploadSingleMedia(file: MediaFile): Promise<string>;
+    /**
+     * Wait for media processing to complete (for videos)
+     */
+    private waitForMediaProcessing;
+    /**
+     * Get media category based on MIME type
+     */
+    private getMediaCategory;
+    /**
+     * Validate media file meets Twitter requirements
+     */
+    protected validateMediaFile(file: MediaFile): void;
+    /**
+     * Create a tweet
+     */
+    protected createTweet(tweetData: CreateTweetData): Promise<Tweet>;
+    /**
+     * Delete a tweet
+     */
+    protected deleteTweet(tweetId: string): Promise<void>;
+    /**
+     * Get tweets with specified parameters
+     */
+    protected getTweets(endpoint: string, params?: Record<string, any>): Promise<Tweet[]>;
+    /**
+     * Get paginated tweets
+     */
+    protected getPaginatedTweets(endpoint: string, params?: Record<string, any>, maxResults?: number): Promise<Tweet[]>;
+    /**
+     * Convert Twitter tweet to common format
+     */
+    protected normalizePost(tweet: Tweet): SocialPost;
+    /**
+     * Normalize Twitter analytics to common format
+     */
+    protected normalizeAnalytics(twitterMetrics: TwitterMetrics): SocialAnalytics;
+    /**
+     * Search for tweets - implemented in search action
+     */
+    protected searchPosts(params: SearchParams): Promise<SocialPost[]>;
+    /**
+     * Handle Twitter-specific errors
+     */
+    protected handleTwitterError(error: AxiosError): never;
+    /**
+     * Parse Twitter-specific rate limit headers
+     */
+    protected parseRateLimitHeaders(headers: any): {
+        remaining: number;
+        reset: Date;
+        limit: number;
+    } | null;
+    /**
+     * Build search query with operators
+     */
+    protected buildSearchQuery(params: SearchParams): string;
+    /**
+     * Format date for Twitter API (RFC 3339)
+     */
+    protected formatTwitterDate(date: Date | string): string;
+}
+/**
+ * Twitter-specific interfaces
+ */
+export interface TwitterUser {
+    id: string;
+    name: string;
+    username: string;
+    profile_image_url?: string;
+    description?: string;
+    created_at: string;
+    verified?: boolean;
+}
+export interface CreateTweetData {
+    text: string;
+    media?: {
+        media_ids: string[];
+    };
+    poll?: {
+        options: string[];
+        duration_minutes: number;
+    };
+    reply?: {
+        in_reply_to_tweet_id: string;
+    };
+    quote_tweet_id?: string;
+}
+export interface Tweet {
+    id: string;
+    text: string;
+    created_at: string;
+    author_id?: string;
+    conversation_id?: string;
+    public_metrics?: {
+        retweet_count: number;
+        reply_count: number;
+        like_count: number;
+        quote_count: number;
+        bookmark_count: number;
+        impression_count: number;
+    };
+    attachments?: {
+        media_keys?: string[];
+        poll_ids?: string[];
+    };
+    entities?: {
+        hashtags?: Array<{
+            start: number;
+            end: number;
+            tag: string;
+        }>;
+        mentions?: Array<{
+            start: number;
+            end: number;
+            username: string;
+        }>;
+        urls?: Array<{
+            start: number;
+            end: number;
+            url: string;
+            expanded_url: string;
+        }>;
+    };
+    referenced_tweets?: Array<{
+        type: 'retweeted' | 'quoted' | 'replied_to';
+        id: string;
+    }>;
+}
+export interface TwitterMetrics {
+    impression_count: number;
+    engagement_count: number;
+    retweet_count: number;
+    reply_count: number;
+    like_count: number;
+    quote_count: number;
+    bookmark_count: number;
+    url_link_clicks: number;
+    user_profile_clicks: number;
+    video_view_count?: number;
+}
+export interface TwitterSearchParams {
+    query: string;
+    start_time?: string;
+    end_time?: string;
+    max_results?: number;
+    next_token?: string;
+    since_id?: string;
+    until_id?: string;
+    sort_order?: 'recency' | 'relevancy';
+}
+//# sourceMappingURL=twitter-base.action.d.ts.map

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

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

package/dist/providers/twitter/twitter-base.action.js

@@ -0,0 +1,484 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TwitterBaseAction = void 0;
+const global_1 = require("@memberjunction/global");
+const base_social_action_1 = require("../../base/base-social.action");
+const axios_1 = __importDefault(require("axios"));
+const core_1 = require("@memberjunction/core");
+const form_data_1 = __importDefault(require("form-data"));
+/**
+ * Base class for all Twitter/X actions.
+ * Handles Twitter-specific authentication, API interactions, and rate limiting.
+ * Uses Twitter API v2 with OAuth 2.0.
+ */
+let TwitterBaseAction = class TwitterBaseAction extends base_social_action_1.BaseSocialMediaAction {
+    get platformName() {
+        return 'Twitter';
+    }
+    get apiBaseUrl() {
+        return 'https://api.twitter.com/2';
+    }
+    /**
+     * Upload endpoint for media
+     */
+    get uploadApiUrl() {
+        return 'https://upload.twitter.com/1.1';
+    }
+    /**
+     * Axios instance for making HTTP requests
+     */
+    _axiosInstance = null;
+    /**
+     * Get or create axios instance with interceptors
+     */
+    get axiosInstance() {
+        if (!this._axiosInstance) {
+            this._axiosInstance = axios_1.default.create({
+                baseURL: this.apiBaseUrl,
+                timeout: 30000,
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Accept': 'application/json'
+                }
+            });
+            // Add request interceptor for auth
+            this._axiosInstance.interceptors.request.use((config) => {
+                const token = this.getAccessToken();
+                if (token) {
+                    config.headers.Authorization = `Bearer ${token}`;
+                }
+                return config;
+            }, (error) => Promise.reject(error));
+            // Add response interceptor for rate limit handling
+            this._axiosInstance.interceptors.response.use((response) => {
+                // Log rate limit info
+                const rateLimitInfo = this.parseRateLimitHeaders(response.headers);
+                if (rateLimitInfo) {
+                    (0, core_1.LogStatus)(`Twitter Rate Limit - Remaining: ${rateLimitInfo.remaining}/${rateLimitInfo.limit}, Reset: ${rateLimitInfo.reset}`);
+                }
+                return response;
+            }, async (error) => {
+                if (error.response?.status === 429) {
+                    // Rate limit exceeded
+                    const resetTime = error.response.headers['x-rate-limit-reset'];
+                    const waitTime = resetTime
+                        ? Math.max(0, parseInt(resetTime) - Math.floor(Date.now() / 1000))
+                        : 60;
+                    await this.handleRateLimit(waitTime);
+                    // Retry the request
+                    return this._axiosInstance.request(error.config);
+                }
+                return Promise.reject(error);
+            });
+        }
+        return this._axiosInstance;
+    }
+    /**
+     * Refresh the access token using the refresh token
+     */
+    async refreshAccessToken() {
+        const refreshToken = this.getRefreshToken();
+        if (!refreshToken) {
+            throw new Error('No refresh token available for Twitter');
+        }
+        try {
+            const clientId = this.getCustomAttribute(2) || ''; // Client ID stored in CustomAttribute2
+            const clientSecret = this.getCustomAttribute(3) || ''; // Client Secret stored in CustomAttribute3
+            const basicAuth = Buffer.from(`${clientId}:${clientSecret}`).toString('base64');
+            const response = await axios_1.default.post('https://api.twitter.com/2/oauth2/token', new URLSearchParams({
+                grant_type: 'refresh_token',
+                refresh_token: refreshToken,
+                client_id: clientId
+            }).toString(), {
+                headers: {
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                    'Authorization': `Basic ${basicAuth}`
+                }
+            });
+            const { access_token, refresh_token: newRefreshToken, expires_in } = response.data;
+            // Update stored tokens
+            await this.updateStoredTokens(access_token, newRefreshToken || refreshToken, expires_in);
+            (0, core_1.LogStatus)('Twitter access token refreshed successfully');
+        }
+        catch (error) {
+            (0, core_1.LogError)(`Failed to refresh Twitter access token: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw error;
+        }
+    }
+    /**
+     * Get the authenticated user's info
+     */
+    async getCurrentUser() {
+        try {
+            const response = await this.axiosInstance.get('/users/me', {
+                params: {
+                    'user.fields': 'id,name,username,profile_image_url,description,created_at,verified'
+                }
+            });
+            return response.data.data;
+        }
+        catch (error) {
+            (0, core_1.LogError)(`Failed to get current user: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw error;
+        }
+    }
+    /**
+     * Upload media to Twitter
+     */
+    async uploadSingleMedia(file) {
+        try {
+            const fileData = typeof file.data === 'string'
+                ? Buffer.from(file.data, 'base64')
+                : file.data;
+            // Step 1: Initialize upload
+            const initResponse = await axios_1.default.post(`${this.uploadApiUrl}/media/upload.json`, new URLSearchParams({
+                command: 'INIT',
+                total_bytes: fileData.length.toString(),
+                media_type: file.mimeType,
+                media_category: this.getMediaCategory(file.mimeType)
+            }).toString(), {
+                headers: {
+                    'Authorization': `Bearer ${this.getAccessToken()}`,
+                    'Content-Type': 'application/x-www-form-urlencoded'
+                }
+            });
+            const mediaId = initResponse.data.media_id_string;
+            // Step 2: Upload chunks (for large files, Twitter requires chunking)
+            const chunkSize = 5 * 1024 * 1024; // 5MB chunks
+            let segmentIndex = 0;
+            for (let offset = 0; offset < fileData.length; offset += chunkSize) {
+                const chunk = fileData.slice(offset, Math.min(offset + chunkSize, fileData.length));
+                const formData = new form_data_1.default();
+                formData.append('command', 'APPEND');
+                formData.append('media_id', mediaId);
+                formData.append('segment_index', segmentIndex.toString());
+                formData.append('media', chunk, {
+                    filename: file.filename,
+                    contentType: file.mimeType
+                });
+                await axios_1.default.post(`${this.uploadApiUrl}/media/upload.json`, formData, {
+                    headers: {
+                        'Authorization': `Bearer ${this.getAccessToken()}`,
+                        ...formData.getHeaders()
+                    }
+                });
+                segmentIndex++;
+            }
+            // Step 3: Finalize upload
+            await axios_1.default.post(`${this.uploadApiUrl}/media/upload.json`, new URLSearchParams({
+                command: 'FINALIZE',
+                media_id: mediaId
+            }).toString(), {
+                headers: {
+                    'Authorization': `Bearer ${this.getAccessToken()}`,
+                    'Content-Type': 'application/x-www-form-urlencoded'
+                }
+            });
+            // Step 4: Check processing status (for videos)
+            if (file.mimeType.startsWith('video/')) {
+                await this.waitForMediaProcessing(mediaId);
+            }
+            return mediaId;
+        }
+        catch (error) {
+            (0, core_1.LogError)(`Failed to upload media to Twitter: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw error;
+        }
+    }
+    /**
+     * Wait for media processing to complete (for videos)
+     */
+    async waitForMediaProcessing(mediaId, maxWaitTime = 60000) {
+        const startTime = Date.now();
+        while (Date.now() - startTime < maxWaitTime) {
+            const response = await axios_1.default.get(`${this.uploadApiUrl}/media/upload.json`, {
+                params: {
+                    command: 'STATUS',
+                    media_id: mediaId
+                },
+                headers: {
+                    'Authorization': `Bearer ${this.getAccessToken()}`
+                }
+            });
+            const { processing_info } = response.data;
+            if (!processing_info) {
+                // Processing complete
+                return;
+            }
+            if (processing_info.state === 'succeeded') {
+                return;
+            }
+            if (processing_info.state === 'failed') {
+                throw new Error(`Media processing failed: ${processing_info.error?.message || 'Unknown error'}`);
+            }
+            // Wait before checking again
+            const checkAfterSecs = processing_info.check_after_secs || 1;
+            await new Promise(resolve => setTimeout(resolve, checkAfterSecs * 1000));
+        }
+        throw new Error('Media processing timeout');
+    }
+    /**
+     * Get media category based on MIME type
+     */
+    getMediaCategory(mimeType) {
+        if (mimeType.startsWith('image/gif')) {
+            return 'tweet_gif';
+        }
+        else if (mimeType.startsWith('image/')) {
+            return 'tweet_image';
+        }
+        else if (mimeType.startsWith('video/')) {
+            return 'tweet_video';
+        }
+        return 'tweet_image';
+    }
+    /**
+     * Validate media file meets Twitter requirements
+     */
+    validateMediaFile(file) {
+        const supportedTypes = [
+            'image/jpeg',
+            'image/png',
+            'image/gif',
+            'image/webp',
+            'video/mp4'
+        ];
+        if (!supportedTypes.includes(file.mimeType)) {
+            throw new Error(`Unsupported media type: ${file.mimeType}. Supported types: ${supportedTypes.join(', ')}`);
+        }
+        // Twitter media size limits
+        let maxSize;
+        if (file.mimeType === 'image/gif') {
+            maxSize = 15 * 1024 * 1024; // 15MB for GIFs
+        }
+        else if (file.mimeType.startsWith('image/')) {
+            maxSize = 5 * 1024 * 1024; // 5MB for images
+        }
+        else if (file.mimeType.startsWith('video/')) {
+            maxSize = 512 * 1024 * 1024; // 512MB for videos
+        }
+        else {
+            maxSize = 5 * 1024 * 1024; // Default 5MB
+        }
+        if (file.size > maxSize) {
+            throw new Error(`File size exceeds limit. Max: ${maxSize / 1024 / 1024}MB, Got: ${file.size / 1024 / 1024}MB`);
+        }
+    }
+    /**
+     * Create a tweet
+     */
+    async createTweet(tweetData) {
+        try {
+            const response = await this.axiosInstance.post('/tweets', tweetData);
+            return response.data.data;
+        }
+        catch (error) {
+            this.handleTwitterError(error);
+        }
+    }
+    /**
+     * Delete a tweet
+     */
+    async deleteTweet(tweetId) {
+        try {
+            await this.axiosInstance.delete(`/tweets/${tweetId}`);
+        }
+        catch (error) {
+            this.handleTwitterError(error);
+        }
+    }
+    /**
+     * Get tweets with specified parameters
+     */
+    async getTweets(endpoint, params = {}) {
+        try {
+            const defaultParams = {
+                'tweet.fields': 'id,text,created_at,author_id,conversation_id,public_metrics,attachments,entities,referenced_tweets',
+                'user.fields': 'id,name,username,profile_image_url',
+                'media.fields': 'url,preview_image_url,type,width,height',
+                'expansions': 'author_id,attachments.media_keys,referenced_tweets.id',
+                'max_results': 100
+            };
+            const response = await this.axiosInstance.get(endpoint, {
+                params: { ...defaultParams, ...params }
+            });
+            return response.data.data || [];
+        }
+        catch (error) {
+            (0, core_1.LogError)(`Failed to get tweets: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw error;
+        }
+    }
+    /**
+     * Get paginated tweets
+     */
+    async getPaginatedTweets(endpoint, params = {}, maxResults) {
+        const tweets = [];
+        let paginationToken;
+        const limit = params.max_results || 100;
+        while (true) {
+            const response = await this.axiosInstance.get(endpoint, {
+                params: {
+                    ...params,
+                    max_results: limit,
+                    ...(paginationToken && { pagination_token: paginationToken })
+                }
+            });
+            if (response.data.data && Array.isArray(response.data.data)) {
+                tweets.push(...response.data.data);
+            }
+            // Check if we've reached max results
+            if (maxResults && tweets.length >= maxResults) {
+                return tweets.slice(0, maxResults);
+            }
+            // Check for more pages
+            paginationToken = response.data.meta?.next_token;
+            if (!paginationToken) {
+                break;
+            }
+        }
+        return tweets;
+    }
+    /**
+     * Convert Twitter tweet to common format
+     */
+    normalizePost(tweet) {
+        return {
+            id: tweet.id,
+            platform: 'Twitter',
+            profileId: tweet.author_id || '',
+            content: tweet.text,
+            mediaUrls: tweet.attachments?.media_keys || [],
+            publishedAt: new Date(tweet.created_at),
+            analytics: tweet.public_metrics ? {
+                impressions: tweet.public_metrics.impression_count || 0,
+                engagements: (tweet.public_metrics.retweet_count || 0) +
+                    (tweet.public_metrics.reply_count || 0) +
+                    (tweet.public_metrics.like_count || 0) +
+                    (tweet.public_metrics.quote_count || 0),
+                clicks: 0, // Not available in public metrics
+                shares: tweet.public_metrics.retweet_count || 0,
+                comments: tweet.public_metrics.reply_count || 0,
+                likes: tweet.public_metrics.like_count || 0,
+                reach: tweet.public_metrics.impression_count || 0,
+                platformMetrics: tweet.public_metrics
+            } : undefined,
+            platformSpecificData: {
+                conversationId: tweet.conversation_id,
+                referencedTweets: tweet.referenced_tweets,
+                entities: tweet.entities
+            }
+        };
+    }
+    /**
+     * Normalize Twitter analytics to common format
+     */
+    normalizeAnalytics(twitterMetrics) {
+        return {
+            impressions: twitterMetrics.impression_count || 0,
+            engagements: twitterMetrics.engagement_count || 0,
+            clicks: twitterMetrics.url_link_clicks || 0,
+            shares: twitterMetrics.retweet_count || 0,
+            comments: twitterMetrics.reply_count || 0,
+            likes: twitterMetrics.like_count || 0,
+            reach: twitterMetrics.impression_count || 0,
+            videoViews: twitterMetrics.video_view_count,
+            platformMetrics: twitterMetrics
+        };
+    }
+    /**
+     * Search for tweets - implemented in search action
+     */
+    async searchPosts(params) {
+        // This is implemented in the search-tweets.action.ts
+        throw new Error('Search posts is implemented in TwitterSearchTweetsAction');
+    }
+    /**
+     * Handle Twitter-specific errors
+     */
+    handleTwitterError(error) {
+        if (error.response) {
+            const { status, data } = error.response;
+            const errorData = data;
+            switch (status) {
+                case 400:
+                    throw new Error(`Bad Request: ${errorData.detail || errorData.message || 'Invalid request parameters'}`);
+                case 401:
+                    throw new Error('Unauthorized: Invalid or expired access token');
+                case 403:
+                    throw new Error('Forbidden: Insufficient permissions. Ensure the app has required Twitter scopes.');
+                case 404:
+                    throw new Error('Not Found: Resource does not exist');
+                case 429:
+                    throw new Error('Rate Limit Exceeded: Too many requests');
+                case 500:
+                    throw new Error('Internal Server Error: Twitter service error');
+                case 503:
+                    throw new Error('Service Unavailable: Twitter service temporarily unavailable');
+                default:
+                    throw new Error(`Twitter API Error (${status}): ${errorData.detail || errorData.message || 'Unknown error'}`);
+            }
+        }
+        else if (error.request) {
+            throw new Error('Network Error: No response from Twitter');
+        }
+        else {
+            throw new Error(`Request Error: ${error.message}`);
+        }
+    }
+    /**
+     * Parse Twitter-specific rate limit headers
+     */
+    parseRateLimitHeaders(headers) {
+        const remaining = headers['x-rate-limit-remaining'];
+        const reset = headers['x-rate-limit-reset'];
+        const limit = headers['x-rate-limit-limit'];
+        if (remaining !== undefined && reset && limit) {
+            return {
+                remaining: parseInt(remaining),
+                reset: new Date(parseInt(reset) * 1000), // Unix timestamp to Date
+                limit: parseInt(limit)
+            };
+        }
+        return null;
+    }
+    /**
+     * Build search query with operators
+     */
+    buildSearchQuery(params) {
+        const parts = [];
+        if (params.query) {
+            parts.push(params.query);
+        }
+        if (params.hashtags && params.hashtags.length > 0) {
+            const hashtagQuery = params.hashtags
+                .map(tag => tag.startsWith('#') ? tag : `#${tag}`)
+                .join(' OR ');
+            parts.push(`(${hashtagQuery})`);
+        }
+        return parts.join(' ');
+    }
+    /**
+     * Format date for Twitter API (RFC 3339)
+     */
+    formatTwitterDate(date) {
+        if (typeof date === 'string') {
+            date = new Date(date);
+        }
+        return date.toISOString();
+    }
+};
+exports.TwitterBaseAction = TwitterBaseAction;
+exports.TwitterBaseAction = TwitterBaseAction = __decorate([
+    (0, global_1.RegisterClass)(base_social_action_1.BaseSocialMediaAction, 'TwitterBaseAction')
+], TwitterBaseAction);
+//# sourceMappingURL=twitter-base.action.js.map